Expand description
Odori — a minimal Rust agent framework with durable execution built in.
This is the facade crate: the one name a quickstart depends on. It owns no
machinery of its own — it re-exports the workspace’s public surface so that
cargo add odori plus ~20 lines is a complete, durable multi-agent
program.
The primitive set is deliberately small and borrowed from the OpenAI
Agents SDK: Agent, Runner, Tool, Handoff, Guardrail, and typed
outputs (see agents). What Odori adds is the execution substrate:
every run executes durably on an embedded tokeira engine (engine),
providers drive vendor harnesses as supervised subprocesses
(providers), and framework-owned tools invoked mid-turn execute as
durable activities through the MCP bridge (mcp_bridge).
The facade re-exports the public primitive, provider, and runtime crates;
advanced APIs remain available through the agents, providers,
engine, and mcp_bridge modules.
Re-exports§
pub use odori_agents as agents;pub use odori_engine as engine;pub use odori_mcp_bridge as mcp_bridge;pub use odori_providers as providers;
Structs§
- Agent
- A named agent configuration.
- Agent
Registry - Worker-side lookup from agent name to configuration.
- Cluster
Startup Report - Canonical cluster fields safe for host diagnostics.
- Conversation
- A live interactive run.
- Embedded
Dsql Limits - Bounded connection resources available to one embedded DSQL process.
- Embedded
Engine Config - Complete startup configuration for an in-process engine.
- Embedded
Engine Shutdown Error - Aggregated explicit-shutdown failure.
- Embedded
Validation Error - One field-level embedded configuration validation failure.
- Engine
- Odori’s owner for an embedded Tokeira engine.
- Engine
Startup Report - Complete redacted report returned by a successful embedded startup.
- Existing
Embedded Dsql Config - Configuration for an operator-supplied embedded DSQL cluster.
- Json
- Wrapper marking an output as JSON-typed: the final text is parsed with
serde_jsonintoT. - Managed
Embedded Dsql Config - Managed embedded DSQL configuration.
- Odori
Runtime - A running Odori worker plus the client surface against it.
- Ownership
Startup Report - Exclusive ownership acquisition evidence.
- Provider
Limit Status - A provider-reported account limit, quota, or credit observation.
- Providers
- Provider lookup shared with the worker: implementations keyed by
Provider::name, plus the default used by unbound agents. - RunBudget
- Caps enforced by the run loop between turns.
- RunConfig
- Run-level configuration, all fields defaulted.
- RunOutput
- The result of a run.
- Runner
- Starts and follows agent runs against a connected client.
- Schema
Startup Report - Redacted release/schema compatibility evidence.
- Snapshot
Policy Config - Persistence policy for the process-local embedded engine.
- Tokeira
Config - Tool
- A framework-owned tool: name, model-facing description, JSON Schema for arguments, execution policy, and the handler the mcp-bridge will run as a durable activity.
- Tool
Failure - A tool handler’s failure: what the model reads when an execution fails
terminally (surfaced as an MCP
isErrortool result by the bridge). - Tool
Policy - Per-tool durable-execution policy, mapped by the bridge onto the
execute_toolactivity’s options (mcp-bridge Requirement 2.2). - Turn
Record - One completed turn, as recorded in the run’s transcript.
Enums§
- Connect
Target - Where the worker and client connect.
- Dsql
Migration Policy - Schema migration policy selected at a DSQL startup boundary.
- Effort
- Provider-neutral reasoning effort: how much deliberation a turn buys.
- Embedded
Config Error - Failure returned while validating an embedded engine configuration.
- Embedded
Engine Start Error - Redacted failure from explicit embedded startup.
- Embedded
Shutdown Failure - Independent cleanup stage that failed during explicit shutdown.
- Embedded
Startup Phase - Ordered startup phase used by typed, redacted failures.
- Embedded
Storage Config - Closed set of storage modes supported by one embedded engine process.
- Embedded
Storage Mode - Storage mode selected by the explicit embedded startup boundary.
- Guardrail
Verdict - A guardrail’s decision.
- Managed
Cluster Intent - Explicit managed-cluster startup authority.
- RunEnd
- Why the run ended.
- Runner
Error - Failures surfaced by the runner.
- Schema
Startup Outcome - Schema migration work completed during startup.
Traits§
- Agent
Output - A type a run can produce.
- Guardrail
- A deterministic check applied to run input (before the first turn) or turn output (after every turn).
- Provider
- Executes one harness turn for one agent.