Struct Runtime 

pub struct Runtime { /* private fields */ }

The central runtime orchestrator.

Connects the sans-IO state machine to real I/O: model providers, tool execution, memory management, and approval workflows.

Implementations

impl Runtime

pub fn new( tools: Arc<ToolRegistry>, memory: Arc<dyn ConversationMemory>, ) -> Self

Creates a new runtime with default configuration.

The runtime is parameterized by:

• tools: registry of callable tools
• memory: conversation memory backend

pub fn with_config(self, config: RuntimeConfig) -> Self

Sets the runtime configuration.

pub fn with_approval_gate(self, gate: Arc<ApprovalGate>) -> Self

Sets the approval gate.

pub fn add_hook(&mut self, hook: Box<dyn Hook>)

Adds a hook to the runtime.

pub fn subscribe(&self) -> Receiver<AgentEvent>

Subscribes to runtime events.

pub async fn run( &self, provider: &(dyn ChatProvider + Sync), session_id: &str, user_id: &str, user_message: &str, system_prompt: Option<&str>, ) -> RuntimeResult<RunOutput>

Runs an agent execution loop.

Takes a user message text, builds context, and drives the sans-IO state machine until completion or error.

Errors

Returns RuntimeError if the provider fails unrecoverably or the run is aborted.