Skip to main content

Crate odori_engine

Crate odori_engine 

Source
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§

ClusterStartupReport
Canonical cluster fields safe for host diagnostics.
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.
ManagedEmbeddedDsqlConfig
Managed embedded DSQL configuration.
OdoriRuntime
A running Odori worker plus the client surface against it.
OdoriRuntimeBuilder
Builder for OdoriRuntime.
OwnershipStartupReport
Exclusive ownership acquisition evidence.
SchemaStartupReport
Redacted release/schema compatibility evidence.
SnapshotPolicyConfig
Persistence policy for the process-local embedded engine.
TokeiraConfig

Enums§

ConnectTarget
Where the worker and client connect.
DsqlMigrationPolicy
Schema migration policy selected at a DSQL startup boundary.
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.
ManagedClusterIntent
Explicit managed-cluster startup authority.
SchemaStartupOutcome
Schema migration work completed during startup.