Struct AgentRegistry 

pub struct AgentRegistry { /* private fields */ }

Tracks active sub-agents and enforces spawn limits.

Lifecycle

register() → status=Idle
  → set_status(Running) on followup_task
    → set_status(Done) on completion
      → close() removes from registry

Done agents still count toward the quota until explicitly close()d. There is no automatic garbage collection in v1.

Implementations

impl AgentRegistry

pub fn new(config: MultiAgentConfig) -> Self

Create a new registry with the given configuration.

pub fn can_spawn(&self, depth: i32) -> Result<(), SpawnError>

Check whether a new agent can be spawned at the given depth.

Returns Ok(()) if spawning is allowed, or a SpawnError describing which limit was exceeded.

pub fn register( &mut self, path: &AgentPath, depth: i32, tool_count: usize, ) -> Result<(), SpawnError>

Register a new agent.

Returns Ok(()) on success, or a SpawnError if limits are exceeded or the path already exists.

pub fn close(&mut self, path: &AgentPath) -> Option<AgentEntry>

Close (remove) an agent from the registry.

Returns the removed entry, or None if the agent was not registered. This releases the agent’s quota slot.

pub fn set_status(&mut self, path: &AgentPath, status: AgentStatus) -> bool

Update the lifecycle status of an agent.

Returns true if the agent was found and updated.

pub fn get(&self, path: &AgentPath) -> Option<&AgentEntry>

Get an agent entry by path.

pub fn list(&self) -> Vec<&AgentEntry>

List all registered agents (all statuses).

pub fn count(&self) -> usize

Return the total number of registered agents.

pub fn count_by_status(&self, status: &AgentStatus) -> usize

Return the number of agents with a specific status.

pub fn is_empty(&self) -> bool

Return whether the registry is empty.

pub fn contains(&self, path: &AgentPath) -> bool

Check if an agent path is registered.

pub fn config(&self) -> &MultiAgentConfig

Get a reference to the configuration.