Graphorin API reference v0.7.0

---

Graphorin API reference / @graphorin/core / / ReadonlyRunState

Interface: ReadonlyRunState

Defined in: packages/core/src/types/run.ts:178

Read-only projection of RunState handed to tools and hooks via RunContext.state (W-047). Structurally identical to RunState - RunState is assignable to it - but every property is readonly and every array a ReadonlyArray, so typed tool code cannot corrupt run bookkeeping (splice pendingApprovals, flip status, ...). This is a compile-time contract only: there is no runtime freeze. A hand-written mirror (not a generic DeepReadonly): the nested types are already readonly-typed, and keyof-parity with RunState is pinned by type tests.

Stable

Properties

Property	Modifier	Type	Description	Defined in
agentId	readonly	string	-	packages/core/src/types/run.ts:180
currentAgentId	readonly	string	-	packages/core/src/types/run.ts:181
error?	readonly	RunError	-	packages/core/src/types/run.ts:202
finishedAt?	readonly	string	-	packages/core/src/types/run.ts:201
handoffs	readonly	readonly HandoffRecord[]	-	packages/core/src/types/run.ts:188
id	readonly	string	-	packages/core/src/types/run.ts:179
messages	readonly	readonly Message[]	-	packages/core/src/types/run.ts:186
pendingApprovals	readonly	readonly ToolApproval[]	-	packages/core/src/types/run.ts:187
pendingSubRuns?	readonly	readonly PendingSubRun[]	See RunState.pendingSubRuns.	packages/core/src/types/run.ts:199
promotedTools?	readonly	readonly string[]	See RunState.promotedTools.	packages/core/src/types/run.ts:195
sessionId	readonly	string	-	packages/core/src/types/run.ts:182
startedAt	readonly	string	-	packages/core/src/types/run.ts:200
status	readonly	RunStatus	-	packages/core/src/types/run.ts:184
steps	readonly	readonly RunStep[]	-	packages/core/src/types/run.ts:185
taintSummary?	readonly	RunTaintSummary	See RunState.taintSummary.	packages/core/src/types/run.ts:193
todos?	readonly	readonly TodoItem[]	See RunState.todos.	packages/core/src/types/run.ts:197
usage	readonly	Usage	-	packages/core/src/types/run.ts:189
usageByModel?	readonly	RunStateUsageByModel	See RunState.usageByModel.	packages/core/src/types/run.ts:191
userId?	readonly	string	-	packages/core/src/types/run.ts:183