Struct AgentRuntime 

pub struct AgentRuntime { /* private fields */ }

Unified runtime that coordinates memory, graph, orchestration, and agent loop.

Implementations

impl AgentRuntime

pub fn builder() -> AgentRuntimeBuilder<NeedsConfig>

Return a new builder in the NeedsConfig state.

pub fn quick(max_iterations: usize, model: impl Into<String>) -> Self

Construct a minimal AgentRuntime in one call with sensible defaults.

pub fn metrics(&self) -> Arc<RuntimeMetrics>

Return a shared reference to the runtime metrics.

pub async fn run_agent<F, Fut>( &self, agent_id: AgentId, prompt: &str, infer: F, ) -> Result<AgentSession, AgentRuntimeError>

where F: FnMut(String) -> Fut, Fut: Future<Output = String>,

Run the agent loop for the given prompt.

Optionally recalls episodic memories and injects them into the context. Optionally enforces backpressure before starting.

Arguments

• agent_id — identifies the agent for memory retrieval
• prompt — the user’s input prompt
• infer — async inference function: (context: String) -> impl Future<Output = String>

Returns

An AgentSession with step count, hits, duration, and a stable session ID.

pub fn memory(&self) -> Option<&EpisodicStore>

Return a reference to the episodic memory store, if configured.

pub fn graph(&self) -> Option<&GraphStore>

Return a reference to the graph store, if configured.

pub fn working_memory(&self) -> Option<&WorkingMemory>

Return a reference to the working memory, if configured.

pub fn has_memory(&self) -> bool

Return true if episodic memory was configured for this runtime.

pub fn has_graph(&self) -> bool

Return true if a graph store was configured for this runtime.

pub fn has_working_memory(&self) -> bool

Return true if working memory was configured for this runtime.

pub async fn shutdown(&self)

Gracefully shut down the runtime.

Logs a structured shutdown event with the final metrics snapshot. If the persistence feature is enabled and a checkpoint backend is configured, writes a sentinel key so operators can confirm clean shutdown.

After calling shutdown, the runtime should not be used again.

Trait Implementations

impl Debug for AgentRuntime

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.