Struct SubtaskHandle 

pub struct SubtaskHandle<T: Send + 'static> {
    pub thread_id: ThreadId,
    /* private fields */
}

Handle to a running subtask. Allows joining, cancelling, and updating status.

The type parameter T is the return type of the async function. For subagents that return string results, use SubtaskHandle<String>.

Fields

thread_id: ThreadId

The thread ID in the ThreadManager.

Implementations

impl<T: Send + 'static> SubtaskHandle<T>

pub async fn join(self) -> Result<T, String>

Wait for the subtask to complete and return its result.

This consumes the handle. After joining, the thread status is updated to Completed or Failed.

pub fn cancel(&self)

Cancel the subtask.

This signals the cancellation token. The subtask’s async function should check token.is_cancelled() or use token.cancelled().await.

pub fn is_cancelled(&self) -> bool

Check if the subtask has been cancelled.

pub async fn set_description(&self, description: impl Into<String>)

Update the description shown in the sidebar for this subtask.

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

Update the status of the subtask’s thread.

pub fn cancel_token(&self) -> CancellationToken

Get the cancellation token (for passing to subtask internals).

Trait Implementations

impl<T: Send + 'static> Drop for SubtaskHandle<T>

fn drop(&mut self)

Executes the destructor for this type.