Struct SubagentBuilder 

pub struct SubagentBuilder { /* private fields */ }

Available on crate feature subagent only.

Builder for creating SubagentDefinition instances with a fluent API.

Example

use echo_agent::agent::subagent::SubagentBuilder;

let def = SubagentBuilder::new("researcher")
    .description("Researches topics thoroughly")
    .fork_mode()
    .model("qwen3")
    .system_prompt("You are a research specialist...")
    .tools(vec!["search", "read_file"])
    .inherit_history(10)
    .timeout(120)
    .tag("research")
    .can_delegate()
    .build();

assert_eq!(def.name, "researcher");

Implementations

impl SubagentBuilder

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

Start building a subagent with the given name.

pub fn description(self, desc: impl Into<String>) -> Self

Set a human-readable description (shown to the LLM in tool descriptions).

pub fn kind(self, kind: SubagentKind) -> Self

Set the agent source kind.

pub fn custom(self, path: impl Into<PathBuf>) -> Self

Load from a custom .md definition file.

pub fn plugin(self, source: impl Into<String>) -> Self

Load from a plugin source.

pub fn sync_mode(self) -> Self

Set execution mode to Sync (default).

pub fn fork_mode(self) -> Self

Set execution mode to Fork (inherits context, runs independently).

pub fn teammate_mode(self) -> Self

Set execution mode to Teammate (parallel, mailbox-based).

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

Override the model for this subagent.

pub fn system_prompt(self, prompt: impl Into<String>) -> Self

Override the system prompt.

pub fn tools(self, tools: Vec<impl Into<String>>) -> Self

Restrict available tools by name.

pub fn max_iterations(self, max: usize) -> Self

Set max iterations.

pub fn token_limit(self, limit: usize) -> Self

Set token limit.

pub fn inherit_history(self, count: usize) -> Self

Set number of recent messages to inherit from parent (Fork mode).

pub fn inherit_memory(self) -> Self

Enable memory inheritance.

pub fn timeout(self, secs: u64) -> Self

Set timeout in seconds (0 = no timeout).

pub fn can_delegate(self) -> Self

Allow this subagent to delegate to further subagents.

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

Add a tag for discovery/filtering.

pub fn tags(self, tags: Vec<impl Into<String>>) -> Self

Add multiple tags.

pub fn build(self) -> SubagentDefinition

Build the definition.