Module text 

Text-agent runtime and combinators (carved out of the kernel prelude).

LlmTextAgent, the sequential/parallel/loop/fallback/route/race/timeout/map combinators, and the TextAgent trait.

Structs

Chat

A conversation with an agent: every send carries the turns before it, and the conversation keeps its own State.

DispatchTextAgent

Fire-and-forget background task launcher with global task budget.

FallbackTextAgent

Tries each child agent in sequence. Returns the first successful result. If all fail, returns the last error.

FnTextAgent

Zero-cost state transform agent — executes a closure, no LLM call.

JoinTextAgent

Waits for dispatched background tasks and collects their results.

LlmTextAgent

Core text agent — calls BaseLlm::generate(), dispatches tools, loops until the model produces a final text response.

LoopTextAgent

Runs a text agent repeatedly until max iterations or a state predicate.

MapOverTextAgent

Iterates a single agent over each item in a state list. Reads state[list_key], runs agent per item (setting state[item_key]), collects results into state[output_key].

ParallelTextAgent

Runs text agents concurrently. All branches share state. Results are collected and joined with newlines.

RaceTextAgent

Runs agents concurrently, returns the first to complete. Cancels the rest.

RouteRule

A routing rule: predicate over state → target agent.

RouteTextAgent

State-driven deterministic branching — evaluates predicates in order, dispatches to the first matching agent. Falls back to default if none match.

RunRequest

What to run: the new user turn, the conversation before it, and optionally the JSON shape the reply must take.

RunResult

The outcome of a run: the final text, and what it took to get there.

SequentialTextAgent

Runs text agents sequentially. Each agent sees state mutations from previous agents. The final agent’s output is the pipeline’s output.

TapTextAgent

Read-only observation agent. Calls a function with the state but cannot mutate it. Returns empty string. No LLM call.

TaskRegistry

Shared registry for dispatched background tasks.

TimeoutTextAgent

Wraps an agent with a time limit. Returns AgentError::Timeout if exceeded.

ToolCallRecord

A tool call the model made during a run, and what it returned.

Enums

RunEvent

Something that happened during a streamed run; see TextAgent::run_stream.

Traits

TextAgent

A text-based agent that runs via BaseLlm::generate() (request/response).