Struct AgentRuntime 

pub struct AgentRuntime<P: ChatProvider, S = Idle> { /* private fields */ }

AgentRuntime owns the shared infrastructure (LLM client, tool registry, tool executor) and a persistent session (backed by a session actor).

The generic parameter S is a type-state marker — Idle means no send/send_stream is in progress, Acquired means one is active. Send operations consume AgentRuntime<P, Idle> and return a handle that eventually yields back AgentRuntime<P, Idle>.

Implementations

impl<P: ChatProvider, S> AgentRuntime<P, S>

pub fn builder() -> AgentRuntimeBuilder

Create a new builder.

pub fn reset(&self)

Reset the conversation session (clear message history).

pub fn session_tx(&self) -> UnboundedSender<SessionCmd>

Access the session control channel.

pub fn model(&self) -> &str

The LLM model name configured for this runtime.

pub fn max_iterations(&self) -> usize

Maximum ReAct iterations per call.

pub fn channel_buffer(&self) -> usize

Channel buffer size.

pub fn subscribe_env_state(&self) -> Receiver<EnvStateEvent>

Subscribe to runtime-level environment state events.

The returned receiver yields EnvStateEvent notifications about tool/skill registration changes, LLM model changes, etc. that occur during the runtime’s lifetime.

Unlike Agent::subscribe_raw_events which only delivers events during a fire/send call, this subscription is persistent and independent of any agent call.

pub fn tool_registry(&self) -> Arc<RwLock<ToolRegistry>>

The tool registry (for dynamic tool management).