Interface: PlanMutationParams<THandle>

Defined in: runtime/plan/plan-mutation-params.ts:33

Parameters for executing .mutatePlan() capability tools (spawnTasks, addDependencies, updatePartitionContract).

Consolidates the MutatePlanCapabilityNode, lane/run coordinates, stores, scope, and continuation state.

Type Parameters

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

Properties

Property	Modifier	Type	Description	Defined in
agentFrame?	readonly	AgentContinuationFrame	Active AgentContinuationFrame when invoked from an agent tool call.	runtime/plan/plan-mutation-params.ts:53
checkpointScope?	readonly	CheckpointableScope<THandle, Record<string, unknown>>	Optional CheckpointableScope used to snapshot headScopeCheckpoint on suspension.	runtime/plan/plan-mutation-params.ts:67
continuationQueue?	readonly	StepContinuationQueue	Optional StepContinuationQueue serializing continuation updates.	runtime/plan/plan-mutation-params.ts:61
contractUpdate?	readonly	object	Partition contract update payload when invoking updatePartitionContract.	runtime/plan/plan-mutation-params.ts:51
contractUpdate.newContractText	readonly	string	-	runtime/plan/plan-mutation-params.ts:51
contractUpdate.partitionId	readonly	string	-	runtime/plan/plan-mutation-params.ts:51
ctx	readonly	StepExecutionContext<THandle>	Step execution context.	runtime/plan/plan-mutation-params.ts:69
dependencyKeysToAdd?	readonly	readonly string[]	Existing prerequisite item keys when invoking addDependencies.	runtime/plan/plan-mutation-params.ts:49
laneId	readonly	string	Identifier of the enclosing LaneNode.	runtime/plan/plan-mutation-params.ts:37
ledgerStore	readonly	LedgerStore	Durable LedgerStore instance.	runtime/plan/plan-mutation-params.ts:59
mutatePlanNode	readonly	MutatePlanCapabilityNode<unknown>	Passive .mutatePlan() capability AST node.	runtime/plan/plan-mutation-params.ts:35
outerFrames?	readonly	readonly ContinuationFrame[]	Outer continuation frames prefixing agentFrame.	runtime/plan/plan-mutation-params.ts:55
parentItemKey	readonly	string	Work item deduplication key of the parent run.	runtime/plan/plan-mutation-params.ts:39
parentPriority?	readonly	"low" | "high" | "normal" | "critical"	Priority level of the parent run ('low' | 'normal' | 'high' | 'critical').	runtime/plan/plan-mutation-params.ts:41
pendingToolBatch?	readonly	PendingToolBatch	Pending tool batch saved inside PrerequisiteWaitPauseState when suspending.	runtime/plan/plan-mutation-params.ts:57
previouslySpawnedCount?	readonly	number	Number of tasks already spawned by this run so far.	runtime/plan/plan-mutation-params.ts:43
previousSpawnedTipKey?	readonly	string	Item key of the most recently spawned prerequisite tip ($T_{\text{prevTip}}$) for linear chaining.	runtime/plan/plan-mutation-params.ts:45
serviceRegistry?	readonly	ServiceSessionRegistry	Optional ServiceSessionRegistry quiesced when suspending.	runtime/plan/plan-mutation-params.ts:65
tasksToSpawn?	readonly	readonly SpawnTaskInputEntry[]	Spawned task entries when invoking spawnTasks.	runtime/plan/plan-mutation-params.ts:47
topologyStore?	readonly	TopologyStore	Optional TopologyStore instance for updatePartitionContract.	runtime/plan/plan-mutation-params.ts:63