Struct SubagentProfile 

pub struct SubagentProfile {
    pub description: String,
    pub model: Option<String>,
    pub system_prompt: String,
    pub tool_allow: Vec<String>,
    pub sampling: Option<SamplingParams>,
    pub inherit_project_prompt: bool,
    pub request_limit: Option<TurnRequestLimit>,
    pub hooks: Option<Arc<dyn HookEngine>>,
}

A subagent profile that can be invoked by spawn_agent (agent-side representation).

ProfileSpec in defect-config is the source of truth on the config side; the CLI projects it into this struct during assembly before handing it to the tool. The two are kept separate because defect-config depends on defect-agent — the agent cannot depend on config in the opposite direction, or a cycle would result.

Fields

description: String

Selection-time description that goes into the tool schema’s catalog, allowing the LLM to choose a profile based on it.

model: Option<String>

Optional model override; None falls back to the parent session’s currently selected model (ctx.current_model).

system_prompt: String

The full system prompt for this profile.

tool_allow: Vec<String>

Tool allowlist — the child agent can only see these tools (spawn_agent is always excluded).

sampling: Option<SamplingParams>

Optional sampling overrides.

inherit_project_prompt: bool

When true, prefix the child’s system prompt with the project AGENTS.md layer (project world-knowledge), without inheriting the parent’s identity. Default false.

request_limit: Option<TurnRequestLimit>

Optional per-turn LLM-call cap for this subagent. None ⇒ a fixed anti-runaway default (Fixed(32)); a profile may raise it or make it adaptive/unbounded.

hooks: Option<Arc<dyn HookEngine>>

The hook engine for this profile — hooks that run when a sub-agent executes a turn.

Consistent with the “inherit world, not identity” principle: hooks belong to the profile’s identity and are declared by the profile’s own configuration (the CLI assembles ProfileSpec.hooks into an engine at build time). They are not inherited from the parent session. None means the sub-agent has no hooks (falls back to NoopHookEngine), preserving exactly the same behavior as before — existing profiles without hooks are unaffected.

Trait Implementations

impl Clone for SubagentProfile

fn clone(&self) -> SubagentProfile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SubagentProfile

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

Formats the value using the given formatter.