Struct MultiAgentRuntime 

pub struct MultiAgentRuntime { /* private fields */ }

Coordinates sub-agent lifecycle, event bridging, and cancellation.

Created once during builder setup and shared via Arc to all 6 multi-agent tools. Each tool calls methods on the runtime to spawn, communicate with, or close sub-agents.

Implementations

impl MultiAgentRuntime

pub fn new( config: MultiAgentConfig, client: Arc<dyn LlmClient>, business_tools: Vec<Arc<dyn Tool>>, root_cancel: CancellationToken, error_recovery: Option<Arc<dyn ToolErrorRecovery>>, language: Language, ) -> Self

Create a new multi-agent runtime.

This is called internally by the builder. Tools receive an Arc<Self>.

pub fn set_event_sender(&self, tx: UnboundedSender<RuntimeEvent>)

Set the event sender for bridging child events to parent.

Called by the builder after creating the bridge channel.

pub async fn spawn_child( &self, name: &str, system_prompt: String, depth: i32, tool_count: usize, ) -> Result<String, String>

Spawn a child agent at the given path with a specific system prompt.

This is called by the spawn_agent tool. It:

1. Checks spawn limits
2. Registers the agent in the registry
3. Creates a mailbox
4. Builds a child AgentRuntime
5. Spawns a tokio task for the child’s event loop
6. Returns the AgentPath

Errors

Returns a string error message if spawning fails (limits exceeded, etc.).

pub fn send_message( &self, agent_path: &str, message: String, ) -> Result<bool, String>

Send a message to a child agent (no execution trigger).

Called by send_message tool.

pub fn send_task( &self, agent_path: &str, task: String, interrupt: bool, ) -> Result<bool, String>

Send a task to a child agent (triggers execution).

Called by followup_task tool. Updates status to Running.

pub async fn wait_for_result( &self, agent_path: Option<&str>, timeout_ms: u64, ) -> WaitResult

Wait for a result from any or a specific child agent.

Called by wait_agent tool. Blocks until a result arrives or timeout.

pub fn close_agent(&self, agent_path: &str) -> Result<CloseResult, String>

Close a child agent.

Called by close_agent tool. Cancels the child’s task, removes from registry, and posts a Closed result.

pub fn list_agents(&self) -> Vec<AgentInfo>

List all active sub-agents.

Called by list_agents tool.

pub fn mailbox(&self) -> &Arc<MailboxHub>

Get the mailbox hub (for tools that need it directly).

pub fn registry(&self) -> &Mutex<AgentRegistry>

Get reference to the registry.

pub fn cancel_all(&self)

Cancel all child agents.

Trait Implementations

impl Drop for MultiAgentRuntime

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.