Struct SubagentDisplayState 

pub struct SubagentDisplayState {

    pub subagent_id: String,
    pub name: String,
    pub task: String,
    pub started_at: Instant,
    pub finished: bool,
    pub success: bool,
    pub result_summary: String,
    pub tool_call_count: usize,
    pub active_tools: HashMap<String, NestedToolCallState>,
    pub completed_tools: Vec<CompletedToolCall>,
    pub token_count: u64,
    pub tick: usize,
    pub shallow_warning: Option<String>,
    pub finished_at: Option<Instant>,
    pub parent_tool_id: Option<String>,
    pub description: Option<String>,
    pub backgrounded: bool,
}

State tracking for a single subagent execution.

Fields

subagent_id: String

Unique identifier for this subagent instance.

name: String

Subagent name.

task: String

Task description.

started_at: Instant

When the subagent started.

finished: bool

Whether the subagent has finished.

success: bool

Whether the subagent succeeded (only valid when finished).

result_summary: String

Final result summary (only valid when finished).

tool_call_count: usize

Total tool calls made.

active_tools: HashMap<String, NestedToolCallState>

Active tool calls (tool_id -> NestedToolCallState).

completed_tools: Vec<CompletedToolCall>

Completed tool calls (for display).

token_count: u64

Accumulated token count (input + output).

tick: usize

Animation tick counter for spinner.

shallow_warning: Option<String>

Optional shallow subagent warning.

finished_at: Option<Instant>

When the subagent finished (for cleanup timing).

parent_tool_id: Option<String>

The parent spawn_subagent tool_id (set when SubagentStarted is linked to ToolStarted).

description: Option<String>

Short display label (from description param), used instead of full task in spinner.

backgrounded: bool

Whether this subagent’s parent was sent to background (Ctrl+B).

Implementations

impl SubagentDisplayState

pub fn new(subagent_id: String, name: String, task: String) -> Self

Create a new subagent display state.

pub fn display_label(&self) -> &str

Returns the short display label if set, otherwise the full task.

pub fn add_tool_call( &mut self, tool_name: String, tool_id: String, args: HashMap<String, Value>, )

Record a new tool call starting.

pub fn add_tokens(&mut self, input_tokens: u64, output_tokens: u64)

Accumulate token usage from an LLM call.

pub fn complete_tool_call(&mut self, tool_id: &str, success: bool)

Record a tool call completing.

pub fn finish( &mut self, success: bool, result_summary: String, tool_call_count: usize, shallow_warning: Option<String>, )

Mark the subagent as finished.

pub fn advance_tick(&mut self)

Advance the animation tick.

pub fn elapsed_secs(&self) -> u64

Elapsed time since start.

pub fn completion_summary(&self) -> String

Generate a persistent completion summary for display after the subagent finishes. Format: “Done (N tool uses, Xs, N.Nk tokens)”

pub fn activity_summary(&self) -> String

Generate a summary of current activity.

Trait Implementations

impl Clone for SubagentDisplayState

fn clone(&self) -> SubagentDisplayState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubagentDisplayState

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

Formats the value using the given formatter.