Interface: StepExecutionContext<THandle>

Defined in: ports/step-execution-context.ts:12

Extended step execution context combining ExecutionContext<THandle> with RuntimeExecutorRegistry.

Supplied to step executors, tool drivers, checks, policy guards, tripwires, and hooks so they can dispatch nested AST nodes via ctx.registry.

Extends

• ExecutionContext<THandle>

Type Parameters

Type Parameter	Default type	Description
THandle	unknown	Runtime handle type of the active isolation scope.

Methods

getRunner()

getRunner(node): RunnerDriver;

Defined in: ports/execution-context.ts:71

Returns the runtime's memoized RunnerDriver instance keyed by node.id.

Instantiates the runner driver on first access via RuntimeExecutorRegistry.runners[node.type] and caches it per node.id.

Parameters

Parameter	Type	Description
node	NodeRunnerNode	Passive runner pool AST node.

Returns

RunnerDriver

Memoized runner driver instance.

Inherited from

ExecutionContext.getRunner

---

recordEffects()

recordEffects(effects): void;

Defined in: ports/execution-context.ts:80

Appends newly observed tool effects to the active step's effect log and telemetry collector.

Triggers incremental quota tripwire checks and records effect attributes for step telemetry folding.

Parameters

Parameter	Type	Description
effects	readonly ToolEffect[]	Tool effects emitted by a tool execution or post-flight diff.

Returns

void

Inherited from

ExecutionContext.recordEffects

---

resolveEnv()

resolveEnv(value): string | undefined;

Defined in: ports/execution-context.ts:60

Resolves a literal string or symbolic P.env(key) reference against the runtime environment map.

Returns literal strings unchanged and looks up EnvRef.key in the explicit runtime env record.

Parameters

Parameter	Type	Description
value	string | EnvRef	Literal string or symbolic environment variable reference.

Returns

string | undefined

Resolved environment variable value, or undefined if unset.

Inherited from

ExecutionContext.resolveEnv

Properties

Property	Modifier	Type	Description	Inherited from	Defined in
activeLeases	readonly	readonly LeaseDelta[]	Capability lease deltas currently granted to the active actor or loop.	ExecutionContext.activeLeases	ports/execution-context.ts:41
activePartitions	readonly	readonly string[]	Partition identifiers unlocked for the active step.	ExecutionContext.activePartitions	ports/execution-context.ts:39
activeServiceSessions?	readonly	ReadonlyMap<string, ServiceSession<THandle>>	Optional map of active background daemon service sessions keyed by service ID.	ExecutionContext.activeServiceSessions	ports/execution-context.ts:37
candidateHandles?	readonly	ReadonlyMap<number, THandle>	Optional map of surviving speculative candidate branch indices to their live scope handles.	ExecutionContext.candidateHandles	ports/execution-context.ts:35
observedEffects	readonly	readonly ToolEffect[]	Tool effects observed so far within the active step execution.	ExecutionContext.observedEffects	ports/execution-context.ts:43
registry	readonly	RuntimeExecutorRegistry	Composite registry of stateless AST node executors and driver factories.	-	ports/step-execution-context.ts:14
resumeContinuationStack?	readonly	readonly ContinuationFrame[]	Optional continuation frame stack used when resuming a suspended or interrupted step.	ExecutionContext.resumeContinuationStack	ports/execution-context.ts:49
runId	readonly	string	Unique identifier of the enclosing harness run.	ExecutionContext.runId	ports/execution-context.ts:22
scope?	readonly	| IsolationScope<THandle, Record<string, unknown>> | CheckpointableScope<THandle, Record<string, unknown>> | BranchableScope<THandle, Record<string, unknown>, Record<string, unknown>>	Optional active isolation scope runtime driver instance.	ExecutionContext.scope	ports/execution-context.ts:30
scopeHandle	readonly	THandle	Active isolation scope handle for the current step or branch.	ExecutionContext.scopeHandle	ports/execution-context.ts:26
scopeNode?	readonly	IsolationScopeASTNode<THandle, Record<string, unknown>, Record<string, unknown>>	Optional passive AST node of the active isolation scope.	ExecutionContext.scopeNode	ports/execution-context.ts:28
seededHistory?	readonly	readonly WireFrameRecord[]	Optional pre-seeded wire transcript frames inherited from a parent or aborted fast-path attempt.	ExecutionContext.seededHistory	ports/execution-context.ts:47
signal?	readonly	AbortSignal	Optional cancellation signal for aborting in-flight operations.	ExecutionContext.signal	ports/execution-context.ts:45
stepExecId	readonly	string	Unique execution identifier of the active step invocation.	ExecutionContext.stepExecId	ports/execution-context.ts:24