Struct SubAgentHandle 

pub struct SubAgentHandle {
    pub id: String,
    pub def: SubAgentDef,
    pub task_id: String,
    pub state: SubAgentState,
    pub join_handle: Option<JoinHandle<Result<String, SubAgentError>>>,
    pub cancel: CancellationToken,
    pub status_rx: Receiver<SubAgentStatus>,
    pub grants: PermissionGrants,
    pub pending_secret_rx: Receiver<SecretRequest>,
    pub secret_tx: Sender<Option<String>>,
    pub started_at_str: String,
    pub transcript_dir: Option<PathBuf>,
}

Handle to a spawned sub-agent task.

Fields are public to allow test harnesses in downstream crates to construct handles. audit trail by mutating grants or cancellation state directly.

Fields

id: String

def: SubAgentDef

task_id: String

Task ID (UUID). Currently the same as id; separated for future use.

state: SubAgentState

join_handle: Option<JoinHandle<Result<String, SubAgentError>>>

cancel: CancellationToken

status_rx: Receiver<SubAgentStatus>

grants: PermissionGrants

pending_secret_rx: Receiver<SecretRequest>

Receives secret requests from the sub-agent loop.

secret_tx: Sender<Option<String>>

Delivers approval outcome to the sub-agent loop: None = denied, Some(_) = approved.

started_at_str: String

ISO 8601 UTC timestamp recorded when the agent was spawned or resumed.

transcript_dir: Option<PathBuf>

Resolved transcript directory at spawn time; None if transcripts were disabled.

Trait Implementations

impl Debug for SubAgentHandle

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

Formats the value using the given formatter.

impl Drop for SubAgentHandle

fn drop(&mut self)

Executes the destructor for this type.