Interface: RunContext<TDeps>

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

Stable

Per-run dependency / context bag handed to every tool, hook and provider middleware in scope. Generic over the user-defined deps shape.

tracer, signal, usage and state are always present; everything else is optional.

Type Parameters

Type Parameter	Default type
`TDeps`	`unknown`

Property	Modifier	Type	Description	Defined in
`agentId`	`readonly`	`string`	-	packages/core/src/types/run.ts:341
`deps`	`readonly`	`TDeps`	-	packages/core/src/types/run.ts:342
`messages`	`readonly`	readonly `Message`[]	-	packages/core/src/types/run.ts:347
`runId`	`readonly`	`string`	-	packages/core/src/types/run.ts:338
`sessionId`	`readonly`	`string`	-	packages/core/src/types/run.ts:339
`signal`	`readonly`	`AbortSignal`	-	packages/core/src/types/run.ts:344
`span?`	`readonly`	`AISpan`<`SpanType`>	The current `agent.step` span (when the runtime traces). Spans created inside tool execution parent under it so a run's traces form one tree.	packages/core/src/types/run.ts:360
`state`	`readonly`	`ReadonlyRunState`	Read-only snapshot of the run's state. Tools observe the run; they do not mutate its bookkeeping - writes to `status`, `pendingApprovals` etc. are compile errors. The runtime keeps the only mutable reference.	packages/core/src/types/run.ts:354
`stepNumber`	`readonly`	`number`	-	packages/core/src/types/run.ts:346
`tracer`	`readonly`	`Tracer`	-	packages/core/src/types/run.ts:343
`usage`	`readonly`	`UsageAccumulator`	-	packages/core/src/types/run.ts:345
`userId?`	`readonly`	`string`	-	packages/core/src/types/run.ts:340