Struct ExtractBuilder 

pub struct ExtractBuilder { /* private fields */ }

Builder for an Extract record.

Implementations

impl ExtractBuilder

pub fn field(self, name: impl Into<String>, recognizer: Recognizer) -> Self

Add a field filled by recognizer, promoted to a state key of the same name.

pub fn field_to( self, name: impl Into<String>, state_key: impl Into<String>, recognizer: Recognizer, ) -> Self

Add a field promoted to a custom state key.

pub fn field_resolve<I, S, F, Fut>( self, name: impl Into<String>, args: I, ttl: Option<Duration>, fetch: F, ) -> Self

where I: IntoIterator<Item = S>, S: Into<String>, F: Fn(Value) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Value, String>> + Send + 'static,

Add a field filled by an async resolver — a tool call, HTTP fetch, or MCP request. args names the State keys bound into the JSON object passed to fetch; the returned value becomes the field. With a ttl, results are memoized by (field, canonical args) for that duration.

pub fn validate<F>(self, predicate: F) -> Self

where F: Fn(&Value) -> bool + Send + Sync + 'static,

Attach a validator to the most recently added field: a recognized value is promoted only when predicate returns true (else it is rejected, as if no value was recognized this turn).

pub fn window(self, n: usize) -> Self

Number of recent turns the recognizers read (default 3).

pub fn trigger(self, trigger: ExtractionTrigger) -> Self

When the record runs (default EveryTurn).

pub fn on_complete(self, agent: Arc<dyn TextAgent>, mode: AgentMode) -> Self

Run agent (in mode) when this record lands fields in state — the on_complete(dispatch(agent)) effect. Its result lands in {name}:result.

pub fn build(self) -> Extract

Finalize the record.