Crate awaken_runtime 

Agent runtime engine for the awaken framework.

Implements the execution loop, phase pipeline, plugin system, state store, and agent registry. Extension crates hook into this crate via the phase, plugins, and extensions traits. Most users interact with this crate indirectly through the awaken facade and awaken::prelude.

Re-exports

pub use profile::ProfileAccess;

pub use backend::BackendAbortRequest;

pub use backend::BackendCancellationCapability;

pub use backend::BackendCapabilities;

pub use backend::BackendContinuationCapability;

pub use backend::BackendControl;

pub use backend::BackendDelegateContinuation;

pub use backend::BackendDelegatePersistence;

pub use backend::BackendDelegatePolicy;

pub use backend::BackendDelegateRunRequest;

pub use backend::BackendLocalRootContext;

pub use backend::BackendOutputArtifact;

pub use backend::BackendOutputCapability;

pub use backend::BackendParentContext;

pub use backend::BackendRootRunRequest;

pub use backend::BackendRunOutput;

pub use backend::BackendRunResult;

pub use backend::BackendRunStatus;

pub use backend::BackendTranscriptCapability;

pub use backend::BackendWaitCapability;

pub use backend::ExecutionBackend;

pub use backend::ExecutionBackendError;

pub use backend::ExecutionBackendFactory;

pub use backend::ExecutionBackendFactoryError;

pub use backend::LocalBackend;

pub use builder::AgentRuntimeBuilder;

pub use builder::BuildError;

pub use phase::DEFAULT_MAX_PHASE_ROUNDS;

pub use phase::ExecutionEnv;

pub use phase::PhaseContext;

pub use phase::PhaseHook;

pub use phase::PhaseRuntime;

pub use phase::ToolGateHook;

pub use phase::ToolPolicyHook;

pub use phase::TypedEffectHandler;

pub use phase::TypedScheduledActionHandler;

pub use plugins::Plugin;

pub use plugins::PluginDescriptor;

pub use plugins::PluginRegistrar;

pub use registry::AgentResolver;

pub use registry::ExecutionResolver;

pub use registry::ResolvedAgent;

pub use registry::ResolvedExecution;

pub use runtime::AgentRuntime;

pub use runtime::RunRequest;

pub use state::CommitEvent;

pub use state::CommitHook;

pub use state::StateStore;

Modules

agent

backend

Runtime execution backends and canonical request/result types.

builder

Fluent builder API for constructing AgentRuntime.

context

Context management: compaction, summarization, truncation, and plugin state.

engine

Engine layer: genai-backed LLM executor and type conversion.

execution

Tool execution concerns: executors.

extensions

Bundled extensions for the awaken runtime.

inbox

Lightweight channel for delivering events to an agent’s owner thread.

loop_runner

Minimal sequential agent loop driven by state machines.

phase

plugins

policies

Stop condition policy system and built-in policies.

profile

Typed profile access layer over raw ProfileStore.

registry

Registry traits, in-memory implementations, and agent resolution.

runtime

state

Structs

CancellationHandle

Write-only handle that can signal cancellation.

CancellationToken

A cooperative cancellation token.

MutationBatch

A batch of state mutation operations.

StateCommand

A command that carries state mutations, scheduled actions, and effects.

Enums

RuntimeError

Runtime-specific errors that wrap StateError and add variants for agent resolution and run management.