Skip to content

Interface: LaneQueuedItemState<TIn> ​

Defined in: runtime/lane/lane-queued-item-state.ts:12

In-memory scheduling record for a work item tracked by LaneScheduler (SPEC.md §3.10).

Tracks the item's lifecycle status, prerequisite dependsOn keys, cumulative USD cost, approved budget ceiling, and active FlowExecutionContext when running.

Type Parameters ​

Type ParameterDefault typeDescription
TInunknownValidated lane work item input type.

Properties ​

PropertyModifierTypeDescriptionDefined in
activeFlowCtx?publicFlowExecutionContext<TIn, unknown>Active FlowExecutionContext while the run is executing.runtime/lane/lane-queued-item-state.ts:38
approvedMaxCostUsd?publicnumberEffective USD budget ceiling (initially lane.maxCostUsd?.limitUsd, updated on human approval).runtime/lane/lane-queued-item-state.ts:34
bootRecord?publicInterruptedStepBootRecordOptional interrupted step boot record pending recovery on next schedule pass.runtime/lane/lane-queued-item-state.ts:40
costUsdpublicnumberCumulative USD cost accrued by the run.runtime/lane/lane-queued-item-state.ts:32
dependsOnpublicreadonly string[]Prerequisite item keys (itemKeys) that must exit 'done' before this item starts or resumes.runtime/lane/lane-queued-item-state.ts:30
enqueuedAtMsreadonlynumberEpoch milliseconds when the item was enqueued.runtime/lane/lane-queued-item-state.ts:26
inputpublicTInLatest validated work item input payload.runtime/lane/lane-queued-item-state.ts:20
itemKeyreadonlystringDeduplication key (itemKey) returned by lane.keyMapper(input).runtime/lane/lane-queued-item-state.ts:16
laneIdreadonlystringEnclosing LaneNode.id.runtime/lane/lane-queued-item-state.ts:18
priorityBoostpublicnumberAdditional priority weight boost ('inherit-parent-with-boost').runtime/lane/lane-queued-item-state.ts:28
runIdreadonlystringUnique run identifier (runId).runtime/lane/lane-queued-item-state.ts:14
scopeReceipt?publicRecord<string, unknown>Final scope receipt (TReceipt) captured when the run completed or sealed.runtime/lane/lane-queued-item-state.ts:36
statuspublic| "RUNNING" | "COMPLETED" | "SUSPENDED" | "FAILED" | "QUEUED" | "WAITING" | "CANCELLED" | "ABANDONED"Current lifecycle status of the item inside the lane.runtime/lane/lane-queued-item-state.ts:22
terminalExitState?publicstringTerminal exit state label (flow.exitState, waitFor.onAbandonedState, retry.orFailState, or 'cancelled').runtime/lane/lane-queued-item-state.ts:24

Released under the MIT License.