Struct SubagentIndex 

pub struct SubagentIndex {
    pub name: String,
    pub description: String,
    pub allowed_tools: Vec<String>,
    pub source: ContentSource,
    pub source_type: SourceType,
    pub model: Option<String>,
    pub model_type: Option<ModelType>,
    pub skills: Vec<String>,
}

Subagent index entry - minimal metadata always available in context.

This enables the progressive disclosure pattern where:

• Metadata (~30 tokens per subagent) is always in the Task tool description
• Full prompt (~200 tokens per subagent) is loaded only when spawned

Token Efficiency

With 10 subagents:

• Index only: 10 × 30 = ~300 tokens
• Full load: 10 × 200 = ~2,000 tokens
• Savings: ~85%

Fields

name: String

Subagent name (unique identifier)

description: String

Subagent description - used by Claude for semantic matching

allowed_tools: Vec<String>

Allowed tools for this subagent (if restricted)

source: ContentSource

Source location for loading full prompt

source_type: SourceType

Source type (builtin, user, project, managed)

model: Option<String>

Optional model alias or ID

model_type: Option<ModelType>

Model type for resolution

skills: Vec<String>

Skills available to this subagent

Implementations

impl SubagentIndex

pub fn new(name: impl Into<String>, description: impl Into<String>) -> Self

Create a new subagent index entry.

pub fn with_allowed_tools( self, tools: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Set allowed tools.

pub fn with_tools( self, tools: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Alias for with_allowed_tools() for convenience.

pub fn with_source(self, source: ContentSource) -> Self

Set the content source (prompt).

pub fn with_source_type(self, source_type: SourceType) -> Self

Set the source type.

pub fn with_model(self, model: impl Into<String>) -> Self

Set the model alias or ID.

pub fn with_model_type(self, model_type: ModelType) -> Self

Set the model type.

pub fn with_skills( self, skills: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Set available skills.

pub fn resolve_model<'a>(&'a self, config: &'a ModelConfig) -> &'a str

Resolve the model to use for this subagent.

Supports both direct model IDs and aliases:

• "opus" → resolves to reasoning model (e.g., claude-opus-4-5)
• "sonnet" → resolves to primary model (e.g., claude-sonnet-4-5)
• "haiku" → resolves to small model (e.g., claude-haiku-4-5)
• Direct model ID → passed through unchanged

Falls back to model_type if model is not set.

pub async fn load_prompt(&self) -> Result<String>

Load the full prompt content.

Trait Implementations

impl Clone for SubagentIndex

fn clone(&self) -> SubagentIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubagentIndex

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SubagentIndex

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Index for SubagentIndex

fn source(&self) -> &ContentSource

Get the content source for lazy loading.

fn source_type(&self) -> SourceType

Get the source type (builtin, user, project, managed).

fn to_summary_line(&self) -> String

Generate a summary line for context injection.

fn description(&self) -> &str

Get a short description for this index entry.

fn priority(&self) -> i32

Get the priority for override ordering.

fn load_content<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Load the full content from the source.

impl Named for SubagentIndex

fn name(&self) -> &str

impl Serialize for SubagentIndex

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToolRestricted for SubagentIndex

fn allowed_tools(&self) -> &[String]

fn has_tool_restrictions(&self) -> bool

fn is_tool_allowed(&self, tool_name: &str) -> bool