Skip to main content

Interface: GraphState<TInput, TScratch, TArtifacts>

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

The mutable execution state threaded through every node of a graph run.

Generic parameters allow authors to provide precise types for their specific graph. All fields except scratch and artifacts are managed exclusively by the runtime.

Type Parameters​

TInput​

TInput = unknown

Shape of the initial user-provided input.

TScratch​

TScratch = unknown

Shape of intermediate computation results passed between nodes.

TArtifacts​

TArtifacts = unknown

Shape of outputs produced for external consumption.

Properties​

artifacts​

artifacts: TArtifacts

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

Accumulated outputs intended for the caller; merged via StateReducers after each node.

checkpointId?​

optional checkpointId: string

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

Id of the most recently persisted checkpoint snapshot, if any.

currentNodeId​

currentNodeId: string

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

Id of the node currently executing (or most recently completed).

diagnostics​

diagnostics: DiagnosticsView

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

Append-only telemetry record updated after each node completes.

input​

input: Readonly<TInput>

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

The original user-provided input; frozen after graph start.

iteration​

iteration: number

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

Number of times the graph has looped back to a previously visited node.

memory​

memory: MemoryView

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

Read-only memory snapshot populated before each node executes.

scratch​

scratch: TScratch

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

Node-to-node communication bag; merged via StateReducers after each node.

visitedNodes​

visitedNodes: string[]

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

Ordered list of node ids that have completed execution in this run.