Skip to main content

Crate odori

Crate odori 

Source
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.
AgentRegistry
Worker-side lookup from agent name to configuration.
ClusterStartupReport
Canonical cluster fields safe for host diagnostics.
Conversation
A live interactive run.
EmbeddedDsqlLimits
Bounded connection resources available to one embedded DSQL process.
EmbeddedEngineConfig
Complete startup configuration for an in-process engine.
EmbeddedEngineShutdownError
Aggregated explicit-shutdown failure.
EmbeddedValidationError
One field-level embedded configuration validation failure.
Engine
Odori’s owner for an embedded Tokeira engine.
EngineStartupReport
Complete redacted report returned by a successful embedded startup.
ExistingEmbeddedDsqlConfig
Configuration for an operator-supplied embedded DSQL cluster.
Json
Wrapper marking an output as JSON-typed: the final text is parsed with serde_json into T.
ManagedEmbeddedDsqlConfig
Managed embedded DSQL configuration.
OdoriRuntime
A running Odori worker plus the client surface against it.
OwnershipStartupReport
Exclusive ownership acquisition evidence.
ProviderLimitStatus
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.
SchemaStartupReport
Redacted release/schema compatibility evidence.
SnapshotPolicyConfig
Persistence policy for the process-local embedded engine.
TokeiraConfig
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.
ToolFailure
A tool handler’s failure: what the model reads when an execution fails terminally (surfaced as an MCP isError tool result by the bridge).
ToolPolicy
Per-tool durable-execution policy, mapped by the bridge onto the execute_tool activity’s options (mcp-bridge Requirement 2.2).
TurnRecord
One completed turn, as recorded in the run’s transcript.

Enums§

ConnectTarget
Where the worker and client connect.
DsqlMigrationPolicy
Schema migration policy selected at a DSQL startup boundary.
Effort
Provider-neutral reasoning effort: how much deliberation a turn buys.
EmbeddedConfigError
Failure returned while validating an embedded engine configuration.
EmbeddedEngineStartError
Redacted failure from explicit embedded startup.
EmbeddedShutdownFailure
Independent cleanup stage that failed during explicit shutdown.
EmbeddedStartupPhase
Ordered startup phase used by typed, redacted failures.
EmbeddedStorageConfig
Closed set of storage modes supported by one embedded engine process.
EmbeddedStorageMode
Storage mode selected by the explicit embedded startup boundary.
GuardrailVerdict
A guardrail’s decision.
ManagedClusterIntent
Explicit managed-cluster startup authority.
RunEnd
Why the run ended.
RunnerError
Failures surfaced by the runner.
SchemaStartupOutcome
Schema migration work completed during startup.

Traits§

AgentOutput
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.