Enum SubAgentOp 

pub enum SubAgentOp {
    Spawn {
        args: Box<SpawnArgs>,
        parent_run_id: String,
        max_depth: usize,
        reply: Sender<Result<String, String>>,
    },
    Check {
        run_id: String,
        reply: Sender<Option<AgentStatus>>,
    },
    Send {
        run_id: String,
        caller_run_id: String,
        content: String,
        reply: Sender<bool>,
    },
    Kill {
        run_id: String,
        caller_run_id: String,
        reply: Sender<bool>,
    },
}

A world-access request from an agent’s tool lane. The sub-agent tools (spawn_agent/check_agent/send_to_agent/kill_agent) need the world and the Spawner, which only the host holds - the tool lane runs async, off the world. Each carries a oneshot reply, so the (sequential) tool lane blocks on the host applying it, mirroring the interaction hub.

Variants

Spawn

Spawn a child agent from args, linked as a child of parent_run_id. Rejected if the child would exceed max_depth. Reply is the child run id.

Fields

args: Box<SpawnArgs>

The child’s spawn parameters (blueprint path, task, etc.). Boxed because it is much larger than the other variants’ payloads.

parent_run_id: String

The run id of the agent doing the spawning.

max_depth: usize

Maximum allowed sub-agent tree depth (root = 0).

reply: Sender<Result<String, String>>

Reply: the child’s run id, or an error message.

Check

Report a run’s current status (None if the host has no such live run).

Fields

run_id: String

The run to query.

reply: Sender<Option<AgentStatus>>

Reply: the run’s status.

Send

Deliver a message into a running agent’s inbox. Reply is whether a live agent accepted it.

Fields

run_id: String

The target run.

caller_run_id: String

The run doing the sending. The target must be it or one of its descendants - see WorldHost::is_within_tree.

content: String

The message body.

reply: Sender<bool>

Reply: whether the message was accepted.

Kill

Cancel a run and its whole sub-tree. Reply is whether any agent was found.

Fields

run_id: String

The run to cancel (with its descendants).

caller_run_id: String

The run doing the cancelling. The target must be it or one of its descendants - see WorldHost::is_within_tree.

reply: Sender<bool>

Reply: whether anything was cancelled.