Graphorin API reference v0.7.0

---

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

Interface: SerializedRunState

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

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:61
currentAgentId	readonly	string	-	packages/agent/src/run-state/index.ts:62
error?	readonly	{ code: string; details?: unknown; message: string; }	-	packages/agent/src/run-state/index.ts:86
error.code	readonly	string	-	packages/agent/src/run-state/index.ts:86
error.details?	readonly	unknown	-	packages/agent/src/run-state/index.ts:86
error.message	readonly	string	-	packages/agent/src/run-state/index.ts:86
finishedAt?	readonly	string	-	packages/agent/src/run-state/index.ts:85
handoffs	readonly	readonly HandoffRecord[]	-	packages/agent/src/run-state/index.ts:69
id	readonly	string	-	packages/agent/src/run-state/index.ts:60
messages	readonly	readonly WireMessage[]	-	packages/agent/src/run-state/index.ts:67
pendingApprovals	readonly	readonly ToolApproval[]	-	packages/agent/src/run-state/index.ts:68
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:83
promotedTools?	readonly	readonly string[]	AG-19: deferred tools promoted by tool_search this run.	packages/agent/src/run-state/index.ts:75
sessionId	readonly	string	-	packages/agent/src/run-state/index.ts:63
startedAt	readonly	string	-	packages/agent/src/run-state/index.ts:84
status	readonly	RunStatus	-	packages/agent/src/run-state/index.ts:65
steps	readonly	readonly WireRunStep[]	-	packages/agent/src/run-state/index.ts:66
taintSummary?	readonly	RunTaintSummary	AG-19: coarse data-flow taint summary (no untrusted text).	packages/agent/src/run-state/index.ts:73
todos?	readonly	readonly TodoItem[]	D6: journaled structured plan/todo list.	packages/agent/src/run-state/index.ts:77
usage	readonly	Usage	-	packages/agent/src/run-state/index.ts:70
usageByModel?	readonly	RunStateUsageByModel	-	packages/agent/src/run-state/index.ts:71
userId?	readonly	string	-	packages/agent/src/run-state/index.ts:64
version	readonly	"graphorin-run-state/1.2"	-	packages/agent/src/run-state/index.ts:59