Graphorin API reference v0.12.1

---

Graphorin API reference / @graphorin/agent / run-state / SerializedRunState

Interface: SerializedRunState

Defined in: packages/agent/src/run-state/index.ts:60

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.

Stable

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[]	W-001: 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[]	AG-19: 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	AG-19: coarse data-flow taint summary (no untrusted text).	packages/agent/src/run-state/index.ts:75
todos?	readonly	readonly TodoItem[]	D6: 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	B3: 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