Struct AgentRuntime 

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

Thin wrapper around session and env actors.

AgentRuntime owns no mutable data — all persistent state lives in background actors:

• EnvActor — owns FuneraEnv (model, client, tool/skill registries, sandbox policy), the FuneraEnvWatcher (watch-based hot-reload), ToolBus + ToolExecutor, audit bus, and env state broadcast channel.
• SessionActor — owns Vec<FuneraMessage>.

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>.

Mutation

All env mutations (e.g., set_model, add_tool) send an EnvCmd to the actor, which atomically updates the internal state, pushes to the watch channel (picked up by the ReAct loop on the next iteration), and broadcasts an EnvStateEvent.

Hot-Reload

The ReAct loop calls get_react_config once per fire/send call to obtain a ReActConfig bundle containing the [FuneraEnvWatcher]. Every iteration, the watcher snapshots the latest model, client, tools, and skills from the watch channels — enabling zero-coordination runtime changes.

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 async fn subscribe_env_state(&self) -> Receiver<EnvStateEvent>

Subscribe to runtime-level environment state events.

pub async fn model(&self) -> String

Query the current LLM model name from the env actor.

pub async fn tool_names(&self) -> Vec<String>

List registered tool names from the env actor.

pub fn set_model(&self, model: impl Into<String>)

Change the LLM model name at runtime.

Pushes to the internal watch channel (picked up by the ReAct loop on the next iteration) and broadcasts EnvStateEvent::LlmChanged.

pub fn set_client(&self, client: Client<OpenAIConfig>)

Change the LLM client at runtime (endpoint, key, etc.).

pub fn add_tool(&self, tool: Arc<dyn Tool>)

Register a new tool at runtime.

pub fn remove_tool(&self, name: impl Into<String>)

Remove a tool by name at runtime.

pub fn set_tool_availability(&self, name: impl Into<String>, available: bool)

Set tool availability (enabled/disabled) at runtime.