Struct SubagentExecutor 

pub struct SubagentExecutor { /* private fields */ }

Subagent executor for managing and executing subagents

Example

use claude_agent_sdk::subagents::{SubagentExecutor, Subagent, DelegationStrategy};

#[tokio::main]
async fn example() -> Result<(), Box<dyn std::error::Error>> {
    let mut executor = SubagentExecutor::new(DelegationStrategy::Auto);

    // Register a subagent
    let subagent = Subagent {
        name: "code-reviewer".to_string(),
        description: "Expert code reviewer".to_string(),
        instructions: "Review code for bugs and best practices".to_string(),
        allowed_tools: vec!["Read".to_string(), "Grep".to_string()],
        max_turns: Some(5),
        model: Some("claude-sonnet-4".to_string()),
    };

    executor.register(subagent)?;

    // Execute the subagent
    let output = executor.execute("code-reviewer", "Review this file").await?;
    println!("Output: {:?}", output);

    Ok(())
}

Implementations

impl SubagentExecutor

pub fn new(strategy: DelegationStrategy) -> Self

Create a new subagent executor

Arguments

• strategy - The delegation strategy to use

Example

let executor = SubagentExecutor::new(DelegationStrategy::Auto);

pub fn register(&mut self, subagent: Subagent) -> Result<(), SubagentError>

Register a subagent

Arguments

• subagent - The subagent to register

Errors

Returns an error if a subagent with the same name already exists

Example

let subagent = Subagent {
    name: "my-agent".to_string(),
    description: "Description".to_string(),
    instructions: "Instructions".to_string(),
    allowed_tools: vec![],
    max_turns: Some(5),
    model: None,
};
executor.register(subagent)?;

pub async fn execute( &self, name: &str, input: &str, ) -> Result<SubagentOutput, SubagentError>

Execute a subagent by name

Arguments

• name - The name of the subagent to execute
• input - The input to provide to the subagent

Errors

Returns an error if the subagent is not found or execution fails

Example

let output = executor.execute("my-agent", "Hello").await?;

pub fn list_subagents(&self) -> Vec<String>

Get all registered subagent names

Returns

A vector of subagent names

Example

let names = executor.list_subagents();
println!("Available subagents: {:?}", names);

pub fn has_subagent(&self, name: &str) -> bool

Check if a subagent exists

Arguments

• name - The name of the subagent to check

Returns

true if the subagent exists, false otherwise

Example

if executor.has_subagent("my-agent") {
    println!("Agent exists");
}

pub fn strategy(&self) -> &DelegationStrategy

Get the delegation strategy

Returns

The current delegation strategy