Observed provenance and lifecycle of one native subagent invocation. Attribution alone creates an unknown record; lifecycle fields are present only when the producer supplies them.
API
interface SubagentRun {readonly description?: string;readonly error?: {
readonly message: string;
readonly code?: string;
};readonly interruptIds?: readonly string[];readonly name?: string;readonly parentMessageId?: string;readonly parentSubagentRunId?: string;readonly parentToolCallId?: string;readonly result?: Readonly<JsonValue>;readonly runId?: string;readonly status: 'unknown' | 'running' | 'awaiting' | 'complete' | 'failed' | 'cancelled';readonly subagentRunId: string;readonly timing?: {
readonly startedAt?: number;
readonly settledAt?: number;
};}stringProducer-supplied description.
{
readonly message: string;
readonly code?: string;
}Invocation-local failure; it does not imply an enclosing run failure.
readonly string[]Interrupts explicitly associated with a suspended invocation.
stringProducer-supplied display name.
stringMessage that initiated this invocation, when supplied.
stringParent invocation, when the producer declares nesting.
stringTool call that initiated this invocation, when supplied.
Readonly<JsonValue>Owned, deeply frozen JSON result supplied by the producer.
stringEnclosing run observed at invocation start.
'unknown' | 'running' | 'awaiting' | 'complete' | 'failed' | 'cancelled'Lifecycle observed from native events; unknown never implies completion.
stringOpaque native invocation identifier, including an empty string.
{
readonly startedAt?: number;
readonly settledAt?: number;
}Finite producer timestamps only; either endpoint can be unknown.