Graphorin API reference v0.15.1
Graphorin API reference / @graphorin/agent / run-state / SerializedRunState
Interface: SerializedRunState
Defined in: packages/agent/src/run-state/index.ts:60
Stable
On-disk payload returned by serializeRunState and accepted by deserializeRunState. The shape is JSON-stable: binary message/tool-outcome payloads appear in their WireMessage / WireRunStep (base64 / href envelope) form.
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
agentId | readonly | string | - | packages/agent/src/run-state/index.ts:63 |
currentAgentId | readonly | string | - | packages/agent/src/run-state/index.ts:64 |
error? | readonly | { code: string; details?: unknown; message: string; } | - | packages/agent/src/run-state/index.ts:90 |
error.code | readonly | string | - | packages/agent/src/run-state/index.ts:90 |
error.details? | readonly | unknown | - | packages/agent/src/run-state/index.ts:90 |
error.message | readonly | string | - | packages/agent/src/run-state/index.ts:90 |
finishedAt? | readonly | string | - | packages/agent/src/run-state/index.ts:89 |
handoffs | readonly | readonly HandoffRecord[] | - | packages/agent/src/run-state/index.ts:71 |
id | readonly | string | - | packages/agent/src/run-state/index.ts:62 |
messages | readonly | readonly WireMessage[] | - | packages/agent/src/run-state/index.ts:69 |
pendingApprovals | readonly | readonly ToolApproval[] | - | packages/agent/src/run-state/index.ts:70 |
pendingSubRuns? | readonly | readonly SerializedPendingSubRun[] | Parked sub-agent runs. Each child snapshot is itself a full SerializedRunState - version-stamped and secret-redacted recursively, to any nesting depth. | packages/agent/src/run-state/index.ts:87 |
promotedTools? | readonly | readonly string[] | Deferred tools promoted by tool_search this run. | packages/agent/src/run-state/index.ts:77 |
sessionId | readonly | string | - | packages/agent/src/run-state/index.ts:65 |
startedAt | readonly | string | - | packages/agent/src/run-state/index.ts:88 |
status | readonly | RunStatus | - | packages/agent/src/run-state/index.ts:67 |
steps | readonly | readonly WireRunStep[] | - | packages/agent/src/run-state/index.ts:68 |
taintSummary? | readonly | RunTaintSummary | Coarse data-flow taint summary (no untrusted text). | packages/agent/src/run-state/index.ts:75 |
todos? | readonly | readonly TodoItem[] | Journaled structured plan/todo list. | packages/agent/src/run-state/index.ts:81 |
usage | readonly | Usage | - | packages/agent/src/run-state/index.ts:72 |
usageByModel? | readonly | RunStateUsageByModel | - | packages/agent/src/run-state/index.ts:73 |
userId? | readonly | string | - | packages/agent/src/run-state/index.ts:66 |
verdicts? | readonly | RunVerdicts | Per-turn security verdicts keyed by '<step>:<offset>'. | packages/agent/src/run-state/index.ts:79 |
version | readonly | "graphorin-run-state/1.2" | - | packages/agent/src/run-state/index.ts:61 |