Expand description
The durable-execution substrate: worker bootstrap over an embedded tokeira engine (or any Temporal-contract endpoint).
This crate owns everything between “the user calls run” and “a workflow
task executes”: connecting the Temporal Rust SDK 0.7 client, building
the worker with odori-agents’ run-loop workflow and turn activities
registered, and running it to shutdown.
§The embedded transport
The embedded tokeira engine (tokeira-engine in the engine repo)
exposes an in-process RPC endpoint consumed through
ConnectionOptions::service_override — an in-memory duplex with no TCP
listener and no port. service_override accepts the SDK’s own
callback-service type, so this crate depends only on SDK types: the
Engine owns that engine and hands its service override to
ConnectTarget::ServiceOverride. The same bootstrap drives an
external tokeirad or Temporal server via ConnectTarget::Url, which
is also how the integration harness proves both paths.
let engine = Engine::start_with_embedded_config(EmbeddedEngineConfig::default()).await?;
let odori = OdoriRuntime::builder("my-app")
.connect(ConnectTarget::service_override(engine.service_override()))
.agents(registry)
.providers(providers)
.start()
.await?;
let result: String = odori.runner().run("assistant", "hello", "run-1").await?;Structs§
- Cluster
Startup Report - Canonical cluster fields safe for host diagnostics.
- 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.
- Managed
Embedded Dsql Config - Managed embedded DSQL configuration.
- Odori
Runtime - A running Odori worker plus the client surface against it.
- Odori
Runtime Builder - Builder for
OdoriRuntime. - Ownership
Startup Report - Exclusive ownership acquisition evidence.
- Schema
Startup Report - Redacted release/schema compatibility evidence.
- Snapshot
Policy Config - Persistence policy for the process-local embedded engine.
- Tokeira
Config
Enums§
- Connect
Target - Where the worker and client connect.
- Dsql
Migration Policy - Schema migration policy selected at a DSQL startup boundary.
- 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.
- Managed
Cluster Intent - Explicit managed-cluster startup authority.
- Schema
Startup Outcome - Schema migration work completed during startup.