Struct SubagentHandle 

pub struct SubagentHandle {
    pub id: String,
    pub subagent_id: u64,
    pub agent_name: String,
    pub task_preview: String,
    pub model: String,
    pub system_prompt: String,
    pub started_at: Instant,
    pub timeout_secs: u64,
    pub authorization: Option<AuthorizationDiagnostic>,
    /* private fields */
}

Fields

id: String

subagent_id: u64

Numeric ID — same value that was passed to SubagentStart/SubagentDone events so the TUI can correlate by id without parsing “sa_N” strings.

agent_name: String

task_preview: String

model: String

system_prompt: String

started_at: Instant

timeout_secs: u64

authorization: Option<AuthorizationDiagnostic>

Implementations

impl SubagentHandle

pub fn new( id: String, subagent_id: u64, agent_name: String, task_preview: String, model: String, system_prompt: String, timeout_secs: u64, state: Arc<RwLock<SubagentState>>, steer_tx: Option<UnboundedSender<String>>, shutdown_tx: Option<Sender<()>>, result_rx: Option<Receiver<SubagentResult>>, ) -> Self

Construct a new handle. The state Arc is shared with the spawned subagent thread.

pub fn with_authorization(self, decision: &AuthorizedWorkerModel) -> Self

pub fn set_terminal_diagnostic(&self, diagnostic: TerminalDiagnostic)

pub fn status(&self) -> SubagentStatus

Current status snapshot.

pub fn partial_output(&self) -> String

Partial output accumulated so far.

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

Snapshot of the tool log.

pub fn terminal_diagnostic(&self) -> Option<TerminalDiagnostic>

pub fn conversation_state(&self) -> Vec<Value>

Snapshot of conversation state (for resume).

pub fn elapsed_secs(&self) -> f64

Seconds since this handle was created.

pub fn steer(&self, message: &str) -> Result<(), String>

Send a steering message into the running subagent.

pub fn set_thread_handle(&mut self, handle: JoinHandle<()>)

Signal the subagent to shut down. Store the OS thread handle for graceful shutdown.

pub fn cancel(&mut self)

pub fn is_finished(&self) -> bool

True if the subagent is no longer running.

pub fn mark_collected(&mut self)

Mark this handle as collected by subagent_collect.

pub fn is_collected(&self) -> bool

Whether subagent_collect has already read the result.

pub fn is_tombstone(&self) -> bool

Whether execution transports and resumable context have been discarded.

pub fn finished_elapsed(&self) -> Option<Duration>

Time elapsed since the subagent reached a terminal state. Returns None if still running or if finished_at has not been stamped yet.

pub async fn collect(self) -> Result<SubagentResult, String>

Consume the handle and wait for the final result.

Trait Implementations

impl Debug for SubagentHandle

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

Formats the value using the given formatter.