Expand description
Tokio-native headless agent state machine for tea-rs.
The kernel coordinates provider-neutral model streams, validated tools, pure policy, durable sessions, cooperative cancellation, and awaited canonical observations. It contains no product prompt, live provider, UI, filesystem, process, or network implementation.
Structs§
- Agent
Kernel - Headless coordinator for model, tool, policy, session, and observation ports.
- Discard
Event Sink - Event sink that intentionally discards observations after awaiting the call.
- Kernel
Error - Bounded safe failure returned by the agent kernel.
- Kernel
Input Queue - Thread-safe bounded steering and follow-up queue applied between turns.
- Kernel
RunConfig - Immutable product-independent context frozen for one run.
- Kernel
RunOutcome - Terminal result of one kernel invocation.
- Lane
- One scheduler lane containing invocations that share an execution rule.
- Model
Retry Policy - Deterministic provider-neutral model retry policy.
- Never
Compact Policy - Default policy that never compacts automatically.
- RunLimits
- Hard deterministic limits applied to one kernel run.
- Schedule
Plan - Immutable plan of lane assignments for one model turn.
- Scheduler
- Effect-aware tool scheduler producing lane assignments only.
- State
Transition Error - Invalid runtime-state transition.
- Tokio
Kernel Clock - Production clock backed by system UTC and Tokio deadlines.
- Turn
Request Snapshot - Immutable model request plus the durable tail used to construct it.
- Uuid
V7Kernel IdSource - Production
UUIDv7identity source.
Enums§
- Kernel
Error Code - Stable machine-readable kernel failure classification.
- RunState
- Explicit lifecycle state of one kernel run.
- Turn
State - Explicit lifecycle state of one model/tool turn.
Traits§
- Compaction
Policy - Policy deciding whether a context overflow should trigger automatic compaction before the next model request.
- Compaction
Summarizer - Product-supplied source of compaction summaries.
- Kernel
Clock - Replaceable source of canonical time and deterministic deadlines.
- Kernel
Event Sink - Awaited observation destination with explicit backpressure.
- Kernel
IdSource - Replaceable source of typed
UUIDv7runtime identities.
Type Aliases§
- Compaction
Summary Future - Boxed future returned by a compaction summarizer.
- Kernel
Deadline Future - Boxed deadline future returned by a kernel clock.
- Kernel
Event Future - Boxed future returned by an awaited event sink.