Struct SubAgentHandle 

pub struct SubAgentHandle {
    pub id: SubAgentId,
    pub parent_id: Option<SubAgentId>,
    pub task: String,
    pub depth: usize,
    pub started_at: DateTime<Utc>,
    /* private fields */
}

Handle to a running subagent.

Fields

id: SubAgentId

Subagent ID.

parent_id: Option<SubAgentId>

Parent agent ID (if nested).

task: String

Task description.

depth: usize

Current depth (0 for first-level subagents).

started_at: DateTime<Utc>

When the subagent started.

Implementations

impl SubAgentHandle

pub fn new( task: impl Into<String>, parent_id: Option<SubAgentId>, depth: usize, permit: Option<OwnedSemaphorePermit>, ) -> Self

Create a new subagent handle.

pub async fn status(&self) -> SubAgentStatus

Get current status.

pub fn final_status(&self) -> Option<SubAgentStatus>

Get final status synchronously (only set when terminal).

Panics

Panics if the internal mutex is poisoned.

pub async fn set_status(&self, status: SubAgentStatus)

Set status.

Panics

Panics if the internal mutex is poisoned.

pub async fn mark_running(&self)

Mark as running.

pub async fn complete(&self, result: impl Into<String>)

Mark as completed with result.

pub async fn fail(&self, error: impl Into<String>)

Mark as failed with error.

pub async fn cancel(&self)

Mark as cancelled.

pub async fn timeout(&self)

Mark as timed out.

pub async fn result(&self) -> Option<String>

Get result (if completed).

pub async fn error(&self) -> Option<String>

Get error (if failed).

pub async fn completed_at(&self) -> Option<DateTime<Utc>>

Get completion time (if done).

pub async fn duration(&self) -> Option<Duration>

Get duration (if completed).

pub async fn is_done(&self) -> bool

Check if done (completed, failed, cancelled, or timed out).

Trait Implementations

impl Debug for SubAgentHandle

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

Formats the value using the given formatter.