Skip to main content

Interface: RunInspection

Defined in: packages/agentos/src/orchestration/ir/types.ts:644

Complete inspection record for an in-progress or finished graph run. Returned by the runtime's run-management API.

Properties​

checkpoints​

checkpoints: CheckpointMetadata[]

Defined in: packages/agentos/src/orchestration/ir/types.ts:658

All checkpoint snapshots persisted during the run.


currentNodeId?​

optional currentNodeId: string

Defined in: packages/agentos/src/orchestration/ir/types.ts:652

Id of the node currently executing; absent when status is terminal.


diagnostics​

diagnostics: DiagnosticsView

Defined in: packages/agentos/src/orchestration/ir/types.ts:660

Accumulated diagnostic telemetry.


error?​

optional error: object

Defined in: packages/agentos/src/orchestration/ir/types.ts:664

Structured error detail; only present when status is 'errored'.

code​

code: string

message​

message: string

nodeId?​

optional nodeId: string


events​

events: unknown[]

Defined in: packages/agentos/src/orchestration/ir/types.ts:656

Ordered stream of runtime events emitted during the run (type: GraphEvent[]).


finalOutput?​

optional finalOutput: unknown

Defined in: packages/agentos/src/orchestration/ir/types.ts:662

Final output value; only present when status is 'completed'.


graphId​

graphId: string

Defined in: packages/agentos/src/orchestration/ir/types.ts:648

Id of the CompiledExecutionGraph being executed.


runId​

runId: string

Defined in: packages/agentos/src/orchestration/ir/types.ts:646

Unique run id (UUIDv4 assigned when the run was started).


status​

status: "completed" | "running" | "interrupted" | "errored"

Defined in: packages/agentos/src/orchestration/ir/types.ts:650

Current lifecycle phase of the run.


visitedNodes​

visitedNodes: string[]

Defined in: packages/agentos/src/orchestration/ir/types.ts:654

Ordered list of node ids that have completed execution.