@hashbrownai/react.SubagentRun: Hashbrown API

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;
    };

description

string

Producer-supplied description.

error

{
        readonly message: string;
        readonly code?: string;
    }

Invocation-local failure; it does not imply an enclosing run failure.

interruptIds

readonly string[]

Interrupts explicitly associated with a suspended invocation.

name

string

Producer-supplied display name.

parentMessageId

string

Message that initiated this invocation, when supplied.

parentSubagentRunId

string

Parent invocation, when the producer declares nesting.

parentToolCallId

string

Tool call that initiated this invocation, when supplied.

result

Readonly<JsonValue>

Owned, deeply frozen JSON result supplied by the producer.

runId

string

Enclosing run observed at invocation start.

status

'unknown' | 'running' | 'awaiting' | 'complete' | 'failed' | 'cancelled'

Lifecycle observed from native events; unknown never implies completion.

subagentRunId

string

Opaque native invocation identifier, including an empty string.

timing

{
        readonly startedAt?: number;
        readonly settledAt?: number;
    }

Finite producer timestamps only; either endpoint can be unknown.