Struct SubAgentSpawn 

pub struct SubAgentSpawn {
    pub parent_alias: String,
    pub parent_policy: Arc<SecurityPolicy>,
    pub parent_allowed_agent_aliases: HashSet<String>,
}

Builder for a SubAgent spawn. The caller resolves a parent agent from the loaded config; Self::build applies any narrowing overrides and validates the result.

Fields

parent_alias: String

parent_policy: Arc<SecurityPolicy>

parent_allowed_agent_aliases: HashSet<String>

Implementations

impl SubAgentSpawn

pub fn for_agent(config: &Config, agent_alias: &str) -> Result<Self>

Resolve a parent’s identity from the loaded config and an agent alias. Returns Err when the alias does not name a configured agent — the spawn site surfaces a structured failure instead of invoking the agent loop on a nonexistent identity.

pub fn build(self, overrides: SubAgentOverrides) -> Result<SubAgentContext>

Apply overrides to the parent’s permissions and return a validated SubAgentContext. On any escalation, returns Err with the originating violation in the error chain.

When the caller supplies a policy override, the child inherits the parent’s PerSenderTracker so action and cost budgets are shared between parent and SubAgent runs. Otherwise a SubAgent could be spawned to bypass the parent’s max_actions_per_hour or max_cost_per_day_cents ceiling by consuming from a fresh-zeroed bucket; the inheritance closes that escape. The no-override path already shares the bucket via Arc<SecurityPolicy> cloning.

Trait Implementations

impl Debug for SubAgentSpawn

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.