@dudousxd/nestjs-durable-core 0.76.0 → 0.77.0

package/dist/index.d.cts

@@ -983,8 +983,12 @@ interface StateStore {
     listIncompleteRuns(namespace?: string): Promise<WorkflowRun[]>;
     /** The oldest `pending` runs awaiting dispatch (FIFO, by `createdAt`), capped at `limit`. */
     listPendingRuns(limit: number, namespace?: string): Promise<WorkflowRun[]>;
-    /** Suspended runs whose durable timer is due (`wakeAt <= nowMs`), ready to resume. */
-    listDueTimers(nowMs: number, namespace?: string): Promise<WorkflowRun[]>;
+    /**
+     * Suspended runs whose durable timer is due (`wakeAt <= nowMs`), ready to resume — the most
+     * overdue first, at most `limit` of them when it is given. Every driving instance polls this each
+     * tick, so a recovery wave of thousands of due runs must come back in batches, not all at once.
+     */
+    listDueTimers(nowMs: number, namespace?: string, limit?: number): Promise<WorkflowRun[]>;
     /**
      * Atomically acquire the recovery lease on a run for `owner` until `leaseUntilMs`, but only if
      * it is currently unlocked or its lease has expired (`<= nowMs`). Returns whether it was
@@ -1175,6 +1179,15 @@ interface StateStore {
      * plus an in-JS prefix scan that produces the identical result.
      */
     listCheckpointsByNamePrefix?(runId: string, prefixes: string[]): Promise<StepCheckpoint[]>;
+    /**
+     * How many of the run's checkpoints with `fromSeq <= seq <= toSeq` have one of `statuses`. The join
+     * barrier of a step fan (`ctx.all` over a `@Step`) asks this on every result — "is any step of the
+     * fan still `pending`?" — so it must be a count, not a load of the fan.
+     *
+     * Optional: a store that omits it still works — the engine falls back to {@link listCheckpoints}
+     * and counts in JS, which loads the whole run on every result of a fan.
+     */
+    countCheckpoints?(runId: string, fromSeq: number, toSeq: number, statuses: StepCheckpoint['status'][]): Promise<number>;
 }
 /**
  * A persisted schedule as the STORE sees it: a handful of queryable columns plus two JSON documents
@@ -1485,6 +1498,21 @@ interface AllOptions {
      */
     concurrency?: number;
 }
+/**
+ * Options for `ctx.all` over a `@Step` — one durable step per input instead of one child workflow
+ * per input. The per-call step policy (`retries`, `backoff`, …) applies to every step of the fan.
+ * Flow-control `queue`s and a liveness `timeoutMs` are not supported on a fan.
+ */
+interface AllStepsOptions extends Omit<StepDispatchOpts, 'queue' | 'timeoutMs'> {
+    /** `waitAll` (default) or `failFast` — see {@link WorkflowCtx.all}. */
+    mode?: 'waitAll' | 'failFast';
+    /**
+     * The most steps in flight at once. Unset sends the whole fan immediately. When set, steps go out
+     * in waves of `concurrency`, the next once the previous has settled; each wave costs the parent one
+     * turn. Part of the fan's identity, like `inputs`.
+     */
+    concurrency?: number;
+}
 /** One child of a fan as {@link StateStore.registerChildWaits} writes it. */
 interface ChildWait {
     waiter: SignalWaiter;
@@ -2360,6 +2388,14 @@ interface WorkflowCtx<A extends SearchAttributes = SearchAttributes> {
      * `concurrency` caps how many children run at once (see {@link AllOptions.concurrency}).
      */
     all<C extends WorkflowClass>(workflow: C, inputs: WorkflowInputOf<C>[], opts?: AllOptions): Promise<WorkflowOutputOf<C>[]>;
+    /**
+     * Run one durable **step** per entry in `inputs` in parallel and wait for all of them — the same
+     * fan as above with a `@Step` instead of a child workflow, so each item costs a step instead of a
+     * whole run. The steps share a `parallelGroup` (the dashboard renders them as one fan), the parent
+     * replays once per settled wave rather than once per result, and outputs come back in input order;
+     * failures surface as a {@link GatherError}, like the child fan.
+     */
+    all<TInput, TOutput>(step: StepRef<TInput, TOutput>, inputs: TInput[], opts?: AllStepsOptions): Promise<TOutput[]>;
     all<TOutput = unknown>(workflow: string, inputs: unknown[], opts?: AllOptions): Promise<TOutput[]>;
     /**
      * Pause the run at this point until a human resumes it from the dashboard (or
@@ -3628,6 +3664,13 @@ interface WorkflowEngineDeps {
      * for a genuinely-orphaned run. Default 5min; set `0` to disable (the prior wake-forever behavior).
      */
     reconcileMs?: number | undefined;
+    /**
+     * The most due timers one {@link WorkflowEngine.resumeDueTimers} pass loads and drives, most
+     * overdue first. Every driving instance runs that pass each tick, so a wave of thousands of due
+     * runs (a recovery after an outage, a fan's children waking together) is worked through in
+     * batches instead of every instance loading and walking all of it. Default 500.
+     */
+    timerBatchSize?: number | undefined;
     /**
      * Retention for a BUFFERED event that no `waitForEvent` ever claims (see
      * {@link WorkflowEngine.publishEvent}'s buffering — a publish matching no live waiter keeps ONE
@@ -3746,6 +3789,7 @@ declare class WorkflowEngine {
     private readonly maxRecoveryAttempts?;
     private readonly remoteAdvanceSilenceMs?;
     private readonly reconcileMs;
+    private readonly timerBatchSize;
     private readonly eventBufferTtlMs;
     private readonly remoteRedispatchMs;
     private readonly remoteRedispatchMax;
@@ -3806,6 +3850,21 @@ declare class WorkflowEngine {
      * {@link redriveSettledSteps}).
      */
     private readonly awaitedRemoteSteps;
+    /**
+     * When THIS instance settled a remote step from its result, by `runId:seq`. That result's resume
+     * runs here, and `execute` lets it into a lease this instance holds, so its wake is never the
+     * dropped one {@link redriveSettledSteps} recovers. Pruned by age (see {@link noteSettledHere}).
+     */
+    private readonly settledHere;
+    /**
+     * The step fans (`ctx.all` over a `@Step`) a turn suspended on, by run, while that turn executes on
+     * THIS instance — re-checked once its lease is released (see {@link redriveSettledStepFans}).
+     */
+    private readonly awaitedStepFans;
+    /** Step fans whose join barrier this instance opened, by `runId:firstSeq` — see {@link settledHere}. */
+    private readonly stepFansFiredHere;
+    /** The tail of each run's queue of results being handled on this instance — see {@link serializedPerRun}. */
+    private readonly resultChains;
     /** Flow-control admission backend for remote steps (see {@link registerQueue}). */
     private readonly admission;
     /** Runs on THIS instance blocked on admission, by queue — woken early on a freed-slot signal. */
@@ -4326,6 +4385,13 @@ declare class WorkflowEngine {
      * checkpoint that is already settled, which the next turn replays past — so it cannot loop.
      */
     private redriveSettledSteps;
+    /**
+     * {@link redriveSettledSteps} for a step fan: once the turn that suspended on it released its lease,
+     * re-drive the run if no step of the fan is still `pending` — the last result landed on another
+     * instance while this one held the lease, and its wake was dropped there. A fan whose barrier this
+     * instance opened is skipped, for the reason {@link settledHere} gives.
+     */
+    private redriveSettledStepFans;
     private redriveSettledChildren;
     /**
      * Deliver an external signal to the run waiting on `token`, resume it with `payload`, and return
@@ -4843,6 +4909,24 @@ declare class WorkflowEngine {
      *  capable+compatible worker has appeared, else re-parks with a fresh `wakeAt` (design §7.5). */
     private dueBlockedRuns;
     private callRemote;
+    /**
+     * `ctx.all` over a `@Step`: one durable step per input, dispatched together, joined once. The ctx
+     * reserves the whole position block up front, so replay re-derives the same seqs.
+     *
+     * Each turn reads the fan's checkpoints fresh, hands every step that already has one to
+     * {@link callRemote} (which owns the completed / pending-lease / failed-retry rules), and sends
+     * the steps nobody has sent yet: all of them, or with `concurrency`, the next wave once the last
+     * one has drained. New steps are written `pending` BEFORE any is dispatched, so a turn that runs
+     * concurrently with this one finds them already sent instead of sending them again. The join
+     * barrier ({@link stepFanStillRunning}) then wakes the parent once per wave, not once per result.
+     */
+    private callRemoteAll;
+    /** Write the `pending` checkpoints of a step fan's new steps, then dispatch them. */
+    private sendStepFan;
+    /** Remember a step settled here, forgetting entries older than a lease so the map stays small. */
+    private noteSettledHere;
+    /** Record `key` in a "happened here recently" map, pruning entries older than a lease. */
+    private noteRecent;
     /** {@link StateStore.saveCheckpointIfPending}, or a plain save on a store without it. */
     private savePendingCheckpoint;
     /** Enqueue a remote step task to its worker group via the transport pool. Shared by the initial
@@ -4850,11 +4934,26 @@ declare class WorkflowEngine {
      *  {@link redispatchPending}. Carries the current trace/context so a re-dispatch is traceable. */
     private dispatchRemoteTask;
     /**
-     * Complete a durable remote step from its worker result and resume the run — runs on whichever
-     * instance receives the result (the dispatching one may be gone), so the run is crash/scale-safe.
-     * A no-op if the checkpoint isn't `pending` (a duplicate or late delivery).
+     * Run `work` after every earlier `work` for the same run on this instance has settled. A result
+     * resumes its run inline, and `execute` lets this instance into a lease it already holds — so two
+     * results of one run handled at once here would run two turns of it concurrently. Results of
+     * different runs still go in parallel, which is what a results consumer with concurrency > 1 is for.
+     */
+    private serializedPerRun;
+    /**
+     * Complete a durable remote step from its worker result — runs on whichever instance receives the
+     * result (the dispatching one may be gone), so the run is crash/scale-safe. Resolves whether the
+     * run should now be resumed: not for a duplicate or late delivery (the checkpoint isn't `pending`),
+     * a run already finished, or a step fan whose barrier is still closed.
      */
     private completeRemoteResult;
+    /**
+     * The join barrier of a step fan: a result for one of its steps resumes the parent only once no
+     * step of the fan is still `pending` (a settled wave), or on a failure (failFast surfaces it, and a
+     * retry needs the parent to schedule it). Without it every result would replay the whole parent,
+     * which makes a fan of N steps cost O(N²) checkpoint reads.
+     */
+    private stepFanStillRunning;
     /**
      * Apply a remote workflow-turn {@link WorkflowDecision} durably — runs on WHATEVER instance receives
      * it over the broker (the dispatching one may be gone, or a point-to-point broker handed it to a
@@ -5523,6 +5622,8 @@ declare class CodecStateStore implements StateStore {
     /** Encodes like {@link saveCheckpoint}. Bound only when the inner store has it, so the engine's
      *  plain-save fallback still kicks in through the wrapper. */
     readonly saveCheckpointIfPending?: (checkpoint: StepCheckpoint) => Promise<boolean>;
+    /** Forwarded verbatim — a count reads no payload. Bound only when the inner store has it. */
+    readonly countCheckpoints?: (runId: string, fromSeq: number, toSeq: number, statuses: StepCheckpoint['status'][]) => Promise<number>;
     /** Forwarded verbatim — retention selects by status/updatedAt/scope, never by payload. Bound only
      *  when the inner store prunes, so the retention poller still sees (and warns about) its absence. */
     readonly pruneTerminalRuns?: (policy: RetentionPolicy, nowMs: number, limit: number) => Promise<number>;
@@ -5567,7 +5668,7 @@ declare class CodecStateStore implements StateStore {
     }) => Promise<T>): Promise<T>;
     listIncompleteRuns(namespace?: string): Promise<WorkflowRun[]>;
     listPendingRuns(limit: number, namespace?: string): Promise<WorkflowRun[]>;
-    listDueTimers(nowMs: number, namespace?: string): Promise<WorkflowRun[]>;
+    listDueTimers(nowMs: number, namespace?: string, limit?: number): Promise<WorkflowRun[]>;
     tryLockRun(runId: string, owner: string, leaseUntilMs: number, nowMs: number): Promise<boolean>;
     releaseRunLock(runId: string): Promise<void>;
     renewRunLock(runId: string, owner: string, leaseUntilMs: number): Promise<boolean>;
@@ -5995,7 +6096,7 @@ declare class InMemoryStateStore implements StateStore {
     saveCheckpointIfPending(checkpoint: StepCheckpoint): Promise<boolean>;
     listIncompleteRuns(namespace?: string): Promise<WorkflowRun[]>;
     listPendingRuns(limit: number, namespace?: string): Promise<WorkflowRun[]>;
-    listDueTimers(nowMs: number, namespace?: string): Promise<WorkflowRun[]>;
+    listDueTimers(nowMs: number, namespace?: string, limit?: number): Promise<WorkflowRun[]>;
     tryLockRun(runId: string, owner: string, leaseUntilMs: number, nowMs: number): Promise<boolean>;
     releaseRunLock(runId: string): Promise<void>;
     renewRunLock(runId: string, owner: string, leaseUntilMs: number): Promise<boolean>;
@@ -6055,6 +6156,7 @@ declare class InMemoryStateStore implements StateStore {
     listSchedules(query: ScheduleQuery): Promise<ScheduleRecord[]>;
     listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
     getLatestCheckpointByName(runId: string, name: string): Promise<StepCheckpoint | undefined>;
+    countCheckpoints(runId: string, fromSeq: number, toSeq: number, statuses: StepCheckpoint['status'][]): Promise<number>;
     listCheckpointsByNamePrefix(runId: string, prefixes: string[]): Promise<StepCheckpoint[]>;
 }
 
@@ -6098,4 +6200,4 @@ declare function singletonAdmissionDenialPatch(runs: WorkflowRun[], runId: strin
     updatedAt: Date;
 } | undefined;
 
-export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AllOptions, type AnnouncedWorkflow, type AnnouncementEvidence, type AttributeFilter, type AttributeOp, type AttributePredicateOperand, type AttributeValue, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, type ChildWait, CodecStateStore, type ConcurrencyConfig, ConcurrencyLimitError, type ConcurrencyQuota, ContinueAsNew, type ControlMessage, type ControlPlane, DEFAULT_CONCURRENCY_STATUSES, DEFAULT_PARTITION, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type Disagreement, type DispatchDiagnostics, type DispatchPlan, type DurableExecution, type DurableExecutionWrapper, type DurableTopology, type DurableWebhook, DurableWorkflow, type DynamicWorkflowCtx, ENGINE_MINTED_TAG_PREFIXES, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, type FanJoin, type FanWait, FatalError, GatherError, type GroupHealth, type Heartbeat, type HeartbeatSighting, type HeartbeatStatus, type HistoryEvent, InMemoryAdmissionBackend, InMemoryStateStore, InMemoryTransport, type InferSearchAttributes, LEGACY_V1_CAPABILITIES, LEGACY_V1_PROTOCOL, type MetricsCollector, type MetricsSnapshot, type NamedTransport, type NegotiateOptions, type NegotiationOutcome, type NegotiationReason, type NegotiationResult, NestedWorkflowCallError, NonDeterminismError, type PartitionSighting, type PayloadCodec, type QueueConfig, QueueController, RUN_VALUE_FACET_LIMIT, RUN_VALUE_FACET_SCAN, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, type RunFacetQuery, type RunFacetRow, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunScope, type RunStatus, type RunValueAxis, type RunValueFacetOptions, type RunValueFacetOrder, type RunValueFacetRow, type RunWaiting, SINGLETON_ACTIVE_STATUSES, SINGLETON_ADMITTED_TAG, STATE_STORE, STATE_STORE_CANONICAL, type ScalarAttributeFilter, ScheduleAlreadyExistsError, ScheduleClient, type ScheduleClientOptions, type ScheduleDescription, type ScheduleHost, type ScheduleListQuery, ScheduleNotFoundError, type ScheduleOptions, type ScheduleQuery, type ScheduleRecord, type ScheduledWorkflow, type SearchAttributes, type SearchAttributesSchema, SignalTimeoutError, type SignalWaiter, type SingletonConfig, SingletonQueueFullError, StandardSchemaV1, type StartOptions, type StartRunMessage, type StateStore, type StepCheckpoint, type StepConfig, type StepDef, type StepDispatchOpts, type StepError, type StepEvent, type StepHandler, type StepInterceptor, type StepInvocation, type StepKind, type StepLogger, type StepOptions, type StepRef, type StepResult, type StepScope, type StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, VERSION_UNDECLARED_TAG, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, type WorkflowAnnouncement, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, type WorkflowDirectory, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRegistration, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, aggregateAnnouncements, announcementsOf, applyAttributeQuery, assertConcurrency, attributeColumnFor, attributeOperand, attributePredicateOperands, axisIsRunColumn, bindWorkflowClass, breakpointToken, buildWorkflowDirectory, canRoute, capableWorkers, classifyWaiterToken, clearDurableExecutionWrappers, clearTerminalSingletonAdmission, collectMetrics, concurrencyTag, controlPlaneDescriptor, countRuns, coveredTokens, createStepLogger, currentStep, currentStepScope, currentWorkflowCtx, debug, describeWorker, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, facetOrigin, hasDurableExecutionWrappers, heartbeatStatus, indexWaitersByRun, info, isEngineMintedTag, isEventToken, isLegacyDescriptor, isNonEmptyRunScope, isWorkflowControlFlowSignal, listSignalWaitersOfRuns, log, matchesAttributes, mergeRunFacetRows, mergeRunValueFacetRows, missingCapabilities, negotiate, nextCronFireMs, normalizeAttributeRows, normalizeDescriptor, observedAnnouncements, parentRunIdOf, parseDuration, partitionOfToken, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveConcurrency, resolveRouting, resolveRunWaiting, runDurableExecution, runInStepLogger, runInStepScope, runInWorkflowCtx, runOutsideWorkflowCtx, runSchedules, runStepHandler, runValueFacetsFromRuns, sanitizeQueueToken, scheduledRunId, singletonAdmissionDenialPatch, singletonAdmissionTags, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, useDurableExecution, warn, workflowName };
+export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AllOptions, type AllStepsOptions, type AnnouncedWorkflow, type AnnouncementEvidence, type AttributeFilter, type AttributeOp, type AttributePredicateOperand, type AttributeValue, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, type ChildWait, CodecStateStore, type ConcurrencyConfig, ConcurrencyLimitError, type ConcurrencyQuota, ContinueAsNew, type ControlMessage, type ControlPlane, DEFAULT_CONCURRENCY_STATUSES, DEFAULT_PARTITION, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type Disagreement, type DispatchDiagnostics, type DispatchPlan, type DurableExecution, type DurableExecutionWrapper, type DurableTopology, type DurableWebhook, DurableWorkflow, type DynamicWorkflowCtx, ENGINE_MINTED_TAG_PREFIXES, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, type FanJoin, type FanWait, FatalError, GatherError, type GroupHealth, type Heartbeat, type HeartbeatSighting, type HeartbeatStatus, type HistoryEvent, InMemoryAdmissionBackend, InMemoryStateStore, InMemoryTransport, type InferSearchAttributes, LEGACY_V1_CAPABILITIES, LEGACY_V1_PROTOCOL, type MetricsCollector, type MetricsSnapshot, type NamedTransport, type NegotiateOptions, type NegotiationOutcome, type NegotiationReason, type NegotiationResult, NestedWorkflowCallError, NonDeterminismError, type PartitionSighting, type PayloadCodec, type QueueConfig, QueueController, RUN_VALUE_FACET_LIMIT, RUN_VALUE_FACET_SCAN, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, type RunFacetQuery, type RunFacetRow, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunScope, type RunStatus, type RunValueAxis, type RunValueFacetOptions, type RunValueFacetOrder, type RunValueFacetRow, type RunWaiting, SINGLETON_ACTIVE_STATUSES, SINGLETON_ADMITTED_TAG, STATE_STORE, STATE_STORE_CANONICAL, type ScalarAttributeFilter, ScheduleAlreadyExistsError, ScheduleClient, type ScheduleClientOptions, type ScheduleDescription, type ScheduleHost, type ScheduleListQuery, ScheduleNotFoundError, type ScheduleOptions, type ScheduleQuery, type ScheduleRecord, type ScheduledWorkflow, type SearchAttributes, type SearchAttributesSchema, SignalTimeoutError, type SignalWaiter, type SingletonConfig, SingletonQueueFullError, StandardSchemaV1, type StartOptions, type StartRunMessage, type StateStore, type StepCheckpoint, type StepConfig, type StepDef, type StepDispatchOpts, type StepError, type StepEvent, type StepHandler, type StepInterceptor, type StepInvocation, type StepKind, type StepLogger, type StepOptions, type StepRef, type StepResult, type StepScope, type StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, VERSION_UNDECLARED_TAG, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, type WorkflowAnnouncement, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, type WorkflowDirectory, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRegistration, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, aggregateAnnouncements, announcementsOf, applyAttributeQuery, assertConcurrency, attributeColumnFor, attributeOperand, attributePredicateOperands, axisIsRunColumn, bindWorkflowClass, breakpointToken, buildWorkflowDirectory, canRoute, capableWorkers, classifyWaiterToken, clearDurableExecutionWrappers, clearTerminalSingletonAdmission, collectMetrics, concurrencyTag, controlPlaneDescriptor, countRuns, coveredTokens, createStepLogger, currentStep, currentStepScope, currentWorkflowCtx, debug, describeWorker, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, facetOrigin, hasDurableExecutionWrappers, heartbeatStatus, indexWaitersByRun, info, isEngineMintedTag, isEventToken, isLegacyDescriptor, isNonEmptyRunScope, isWorkflowControlFlowSignal, listSignalWaitersOfRuns, log, matchesAttributes, mergeRunFacetRows, mergeRunValueFacetRows, missingCapabilities, negotiate, nextCronFireMs, normalizeAttributeRows, normalizeDescriptor, observedAnnouncements, parentRunIdOf, parseDuration, partitionOfToken, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveConcurrency, resolveRouting, resolveRunWaiting, runDurableExecution, runInStepLogger, runInStepScope, runInWorkflowCtx, runOutsideWorkflowCtx, runSchedules, runStepHandler, runValueFacetsFromRuns, sanitizeQueueToken, scheduledRunId, singletonAdmissionDenialPatch, singletonAdmissionTags, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, useDurableExecution, warn, workflowName };

package/dist/index.d.ts

@@ -983,8 +983,12 @@ interface StateStore {
     listIncompleteRuns(namespace?: string): Promise<WorkflowRun[]>;
     /** The oldest `pending` runs awaiting dispatch (FIFO, by `createdAt`), capped at `limit`. */
     listPendingRuns(limit: number, namespace?: string): Promise<WorkflowRun[]>;
-    /** Suspended runs whose durable timer is due (`wakeAt <= nowMs`), ready to resume. */
-    listDueTimers(nowMs: number, namespace?: string): Promise<WorkflowRun[]>;
+    /**
+     * Suspended runs whose durable timer is due (`wakeAt <= nowMs`), ready to resume — the most
+     * overdue first, at most `limit` of them when it is given. Every driving instance polls this each
+     * tick, so a recovery wave of thousands of due runs must come back in batches, not all at once.
+     */
+    listDueTimers(nowMs: number, namespace?: string, limit?: number): Promise<WorkflowRun[]>;
     /**
      * Atomically acquire the recovery lease on a run for `owner` until `leaseUntilMs`, but only if
      * it is currently unlocked or its lease has expired (`<= nowMs`). Returns whether it was
@@ -1175,6 +1179,15 @@ interface StateStore {
      * plus an in-JS prefix scan that produces the identical result.
      */
     listCheckpointsByNamePrefix?(runId: string, prefixes: string[]): Promise<StepCheckpoint[]>;
+    /**
+     * How many of the run's checkpoints with `fromSeq <= seq <= toSeq` have one of `statuses`. The join
+     * barrier of a step fan (`ctx.all` over a `@Step`) asks this on every result — "is any step of the
+     * fan still `pending`?" — so it must be a count, not a load of the fan.
+     *
+     * Optional: a store that omits it still works — the engine falls back to {@link listCheckpoints}
+     * and counts in JS, which loads the whole run on every result of a fan.
+     */
+    countCheckpoints?(runId: string, fromSeq: number, toSeq: number, statuses: StepCheckpoint['status'][]): Promise<number>;
 }
 /**
  * A persisted schedule as the STORE sees it: a handful of queryable columns plus two JSON documents
@@ -1485,6 +1498,21 @@ interface AllOptions {
      */
     concurrency?: number;
 }
+/**
+ * Options for `ctx.all` over a `@Step` — one durable step per input instead of one child workflow
+ * per input. The per-call step policy (`retries`, `backoff`, …) applies to every step of the fan.
+ * Flow-control `queue`s and a liveness `timeoutMs` are not supported on a fan.
+ */
+interface AllStepsOptions extends Omit<StepDispatchOpts, 'queue' | 'timeoutMs'> {
+    /** `waitAll` (default) or `failFast` — see {@link WorkflowCtx.all}. */
+    mode?: 'waitAll' | 'failFast';
+    /**
+     * The most steps in flight at once. Unset sends the whole fan immediately. When set, steps go out
+     * in waves of `concurrency`, the next once the previous has settled; each wave costs the parent one
+     * turn. Part of the fan's identity, like `inputs`.
+     */
+    concurrency?: number;
+}
 /** One child of a fan as {@link StateStore.registerChildWaits} writes it. */
 interface ChildWait {
     waiter: SignalWaiter;
@@ -2360,6 +2388,14 @@ interface WorkflowCtx<A extends SearchAttributes = SearchAttributes> {
      * `concurrency` caps how many children run at once (see {@link AllOptions.concurrency}).
      */
     all<C extends WorkflowClass>(workflow: C, inputs: WorkflowInputOf<C>[], opts?: AllOptions): Promise<WorkflowOutputOf<C>[]>;
+    /**
+     * Run one durable **step** per entry in `inputs` in parallel and wait for all of them — the same
+     * fan as above with a `@Step` instead of a child workflow, so each item costs a step instead of a
+     * whole run. The steps share a `parallelGroup` (the dashboard renders them as one fan), the parent
+     * replays once per settled wave rather than once per result, and outputs come back in input order;
+     * failures surface as a {@link GatherError}, like the child fan.
+     */
+    all<TInput, TOutput>(step: StepRef<TInput, TOutput>, inputs: TInput[], opts?: AllStepsOptions): Promise<TOutput[]>;
     all<TOutput = unknown>(workflow: string, inputs: unknown[], opts?: AllOptions): Promise<TOutput[]>;
     /**
      * Pause the run at this point until a human resumes it from the dashboard (or
@@ -3628,6 +3664,13 @@ interface WorkflowEngineDeps {
      * for a genuinely-orphaned run. Default 5min; set `0` to disable (the prior wake-forever behavior).
      */
     reconcileMs?: number | undefined;
+    /**
+     * The most due timers one {@link WorkflowEngine.resumeDueTimers} pass loads and drives, most
+     * overdue first. Every driving instance runs that pass each tick, so a wave of thousands of due
+     * runs (a recovery after an outage, a fan's children waking together) is worked through in
+     * batches instead of every instance loading and walking all of it. Default 500.
+     */
+    timerBatchSize?: number | undefined;
     /**
      * Retention for a BUFFERED event that no `waitForEvent` ever claims (see
      * {@link WorkflowEngine.publishEvent}'s buffering — a publish matching no live waiter keeps ONE
@@ -3746,6 +3789,7 @@ declare class WorkflowEngine {
     private readonly maxRecoveryAttempts?;
     private readonly remoteAdvanceSilenceMs?;
     private readonly reconcileMs;
+    private readonly timerBatchSize;
     private readonly eventBufferTtlMs;
     private readonly remoteRedispatchMs;
     private readonly remoteRedispatchMax;
@@ -3806,6 +3850,21 @@ declare class WorkflowEngine {
      * {@link redriveSettledSteps}).
      */
     private readonly awaitedRemoteSteps;
+    /**
+     * When THIS instance settled a remote step from its result, by `runId:seq`. That result's resume
+     * runs here, and `execute` lets it into a lease this instance holds, so its wake is never the
+     * dropped one {@link redriveSettledSteps} recovers. Pruned by age (see {@link noteSettledHere}).
+     */
+    private readonly settledHere;
+    /**
+     * The step fans (`ctx.all` over a `@Step`) a turn suspended on, by run, while that turn executes on
+     * THIS instance — re-checked once its lease is released (see {@link redriveSettledStepFans}).
+     */
+    private readonly awaitedStepFans;
+    /** Step fans whose join barrier this instance opened, by `runId:firstSeq` — see {@link settledHere}. */
+    private readonly stepFansFiredHere;
+    /** The tail of each run's queue of results being handled on this instance — see {@link serializedPerRun}. */
+    private readonly resultChains;
     /** Flow-control admission backend for remote steps (see {@link registerQueue}). */
     private readonly admission;
     /** Runs on THIS instance blocked on admission, by queue — woken early on a freed-slot signal. */
@@ -4326,6 +4385,13 @@ declare class WorkflowEngine {
      * checkpoint that is already settled, which the next turn replays past — so it cannot loop.
      */
     private redriveSettledSteps;
+    /**
+     * {@link redriveSettledSteps} for a step fan: once the turn that suspended on it released its lease,
+     * re-drive the run if no step of the fan is still `pending` — the last result landed on another
+     * instance while this one held the lease, and its wake was dropped there. A fan whose barrier this
+     * instance opened is skipped, for the reason {@link settledHere} gives.
+     */
+    private redriveSettledStepFans;
     private redriveSettledChildren;
     /**
      * Deliver an external signal to the run waiting on `token`, resume it with `payload`, and return
@@ -4843,6 +4909,24 @@ declare class WorkflowEngine {
      *  capable+compatible worker has appeared, else re-parks with a fresh `wakeAt` (design §7.5). */
     private dueBlockedRuns;
     private callRemote;
+    /**
+     * `ctx.all` over a `@Step`: one durable step per input, dispatched together, joined once. The ctx
+     * reserves the whole position block up front, so replay re-derives the same seqs.
+     *
+     * Each turn reads the fan's checkpoints fresh, hands every step that already has one to
+     * {@link callRemote} (which owns the completed / pending-lease / failed-retry rules), and sends
+     * the steps nobody has sent yet: all of them, or with `concurrency`, the next wave once the last
+     * one has drained. New steps are written `pending` BEFORE any is dispatched, so a turn that runs
+     * concurrently with this one finds them already sent instead of sending them again. The join
+     * barrier ({@link stepFanStillRunning}) then wakes the parent once per wave, not once per result.
+     */
+    private callRemoteAll;
+    /** Write the `pending` checkpoints of a step fan's new steps, then dispatch them. */
+    private sendStepFan;
+    /** Remember a step settled here, forgetting entries older than a lease so the map stays small. */
+    private noteSettledHere;
+    /** Record `key` in a "happened here recently" map, pruning entries older than a lease. */
+    private noteRecent;
     /** {@link StateStore.saveCheckpointIfPending}, or a plain save on a store without it. */
     private savePendingCheckpoint;
     /** Enqueue a remote step task to its worker group via the transport pool. Shared by the initial
@@ -4850,11 +4934,26 @@ declare class WorkflowEngine {
      *  {@link redispatchPending}. Carries the current trace/context so a re-dispatch is traceable. */
     private dispatchRemoteTask;
     /**
-     * Complete a durable remote step from its worker result and resume the run — runs on whichever
-     * instance receives the result (the dispatching one may be gone), so the run is crash/scale-safe.
-     * A no-op if the checkpoint isn't `pending` (a duplicate or late delivery).
+     * Run `work` after every earlier `work` for the same run on this instance has settled. A result
+     * resumes its run inline, and `execute` lets this instance into a lease it already holds — so two
+     * results of one run handled at once here would run two turns of it concurrently. Results of
+     * different runs still go in parallel, which is what a results consumer with concurrency > 1 is for.
+     */
+    private serializedPerRun;
+    /**
+     * Complete a durable remote step from its worker result — runs on whichever instance receives the
+     * result (the dispatching one may be gone), so the run is crash/scale-safe. Resolves whether the
+     * run should now be resumed: not for a duplicate or late delivery (the checkpoint isn't `pending`),
+     * a run already finished, or a step fan whose barrier is still closed.
      */
     private completeRemoteResult;
+    /**
+     * The join barrier of a step fan: a result for one of its steps resumes the parent only once no
+     * step of the fan is still `pending` (a settled wave), or on a failure (failFast surfaces it, and a
+     * retry needs the parent to schedule it). Without it every result would replay the whole parent,
+     * which makes a fan of N steps cost O(N²) checkpoint reads.
+     */
+    private stepFanStillRunning;
     /**
      * Apply a remote workflow-turn {@link WorkflowDecision} durably — runs on WHATEVER instance receives
      * it over the broker (the dispatching one may be gone, or a point-to-point broker handed it to a
@@ -5523,6 +5622,8 @@ declare class CodecStateStore implements StateStore {
     /** Encodes like {@link saveCheckpoint}. Bound only when the inner store has it, so the engine's
      *  plain-save fallback still kicks in through the wrapper. */
     readonly saveCheckpointIfPending?: (checkpoint: StepCheckpoint) => Promise<boolean>;
+    /** Forwarded verbatim — a count reads no payload. Bound only when the inner store has it. */
+    readonly countCheckpoints?: (runId: string, fromSeq: number, toSeq: number, statuses: StepCheckpoint['status'][]) => Promise<number>;
     /** Forwarded verbatim — retention selects by status/updatedAt/scope, never by payload. Bound only
      *  when the inner store prunes, so the retention poller still sees (and warns about) its absence. */
     readonly pruneTerminalRuns?: (policy: RetentionPolicy, nowMs: number, limit: number) => Promise<number>;
@@ -5567,7 +5668,7 @@ declare class CodecStateStore implements StateStore {
     }) => Promise<T>): Promise<T>;
     listIncompleteRuns(namespace?: string): Promise<WorkflowRun[]>;
     listPendingRuns(limit: number, namespace?: string): Promise<WorkflowRun[]>;
-    listDueTimers(nowMs: number, namespace?: string): Promise<WorkflowRun[]>;
+    listDueTimers(nowMs: number, namespace?: string, limit?: number): Promise<WorkflowRun[]>;
     tryLockRun(runId: string, owner: string, leaseUntilMs: number, nowMs: number): Promise<boolean>;
     releaseRunLock(runId: string): Promise<void>;
     renewRunLock(runId: string, owner: string, leaseUntilMs: number): Promise<boolean>;
@@ -5995,7 +6096,7 @@ declare class InMemoryStateStore implements StateStore {
     saveCheckpointIfPending(checkpoint: StepCheckpoint): Promise<boolean>;
     listIncompleteRuns(namespace?: string): Promise<WorkflowRun[]>;
     listPendingRuns(limit: number, namespace?: string): Promise<WorkflowRun[]>;
-    listDueTimers(nowMs: number, namespace?: string): Promise<WorkflowRun[]>;
+    listDueTimers(nowMs: number, namespace?: string, limit?: number): Promise<WorkflowRun[]>;
     tryLockRun(runId: string, owner: string, leaseUntilMs: number, nowMs: number): Promise<boolean>;
     releaseRunLock(runId: string): Promise<void>;
     renewRunLock(runId: string, owner: string, leaseUntilMs: number): Promise<boolean>;
@@ -6055,6 +6156,7 @@ declare class InMemoryStateStore implements StateStore {
     listSchedules(query: ScheduleQuery): Promise<ScheduleRecord[]>;
     listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
     getLatestCheckpointByName(runId: string, name: string): Promise<StepCheckpoint | undefined>;
+    countCheckpoints(runId: string, fromSeq: number, toSeq: number, statuses: StepCheckpoint['status'][]): Promise<number>;
     listCheckpointsByNamePrefix(runId: string, prefixes: string[]): Promise<StepCheckpoint[]>;
 }
 
@@ -6098,4 +6200,4 @@ declare function singletonAdmissionDenialPatch(runs: WorkflowRun[], runId: strin
     updatedAt: Date;
 } | undefined;
 
-export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AllOptions, type AnnouncedWorkflow, type AnnouncementEvidence, type AttributeFilter, type AttributeOp, type AttributePredicateOperand, type AttributeValue, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, type ChildWait, CodecStateStore, type ConcurrencyConfig, ConcurrencyLimitError, type ConcurrencyQuota, ContinueAsNew, type ControlMessage, type ControlPlane, DEFAULT_CONCURRENCY_STATUSES, DEFAULT_PARTITION, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type Disagreement, type DispatchDiagnostics, type DispatchPlan, type DurableExecution, type DurableExecutionWrapper, type DurableTopology, type DurableWebhook, DurableWorkflow, type DynamicWorkflowCtx, ENGINE_MINTED_TAG_PREFIXES, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, type FanJoin, type FanWait, FatalError, GatherError, type GroupHealth, type Heartbeat, type HeartbeatSighting, type HeartbeatStatus, type HistoryEvent, InMemoryAdmissionBackend, InMemoryStateStore, InMemoryTransport, type InferSearchAttributes, LEGACY_V1_CAPABILITIES, LEGACY_V1_PROTOCOL, type MetricsCollector, type MetricsSnapshot, type NamedTransport, type NegotiateOptions, type NegotiationOutcome, type NegotiationReason, type NegotiationResult, NestedWorkflowCallError, NonDeterminismError, type PartitionSighting, type PayloadCodec, type QueueConfig, QueueController, RUN_VALUE_FACET_LIMIT, RUN_VALUE_FACET_SCAN, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, type RunFacetQuery, type RunFacetRow, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunScope, type RunStatus, type RunValueAxis, type RunValueFacetOptions, type RunValueFacetOrder, type RunValueFacetRow, type RunWaiting, SINGLETON_ACTIVE_STATUSES, SINGLETON_ADMITTED_TAG, STATE_STORE, STATE_STORE_CANONICAL, type ScalarAttributeFilter, ScheduleAlreadyExistsError, ScheduleClient, type ScheduleClientOptions, type ScheduleDescription, type ScheduleHost, type ScheduleListQuery, ScheduleNotFoundError, type ScheduleOptions, type ScheduleQuery, type ScheduleRecord, type ScheduledWorkflow, type SearchAttributes, type SearchAttributesSchema, SignalTimeoutError, type SignalWaiter, type SingletonConfig, SingletonQueueFullError, StandardSchemaV1, type StartOptions, type StartRunMessage, type StateStore, type StepCheckpoint, type StepConfig, type StepDef, type StepDispatchOpts, type StepError, type StepEvent, type StepHandler, type StepInterceptor, type StepInvocation, type StepKind, type StepLogger, type StepOptions, type StepRef, type StepResult, type StepScope, type StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, VERSION_UNDECLARED_TAG, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, type WorkflowAnnouncement, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, type WorkflowDirectory, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRegistration, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, aggregateAnnouncements, announcementsOf, applyAttributeQuery, assertConcurrency, attributeColumnFor, attributeOperand, attributePredicateOperands, axisIsRunColumn, bindWorkflowClass, breakpointToken, buildWorkflowDirectory, canRoute, capableWorkers, classifyWaiterToken, clearDurableExecutionWrappers, clearTerminalSingletonAdmission, collectMetrics, concurrencyTag, controlPlaneDescriptor, countRuns, coveredTokens, createStepLogger, currentStep, currentStepScope, currentWorkflowCtx, debug, describeWorker, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, facetOrigin, hasDurableExecutionWrappers, heartbeatStatus, indexWaitersByRun, info, isEngineMintedTag, isEventToken, isLegacyDescriptor, isNonEmptyRunScope, isWorkflowControlFlowSignal, listSignalWaitersOfRuns, log, matchesAttributes, mergeRunFacetRows, mergeRunValueFacetRows, missingCapabilities, negotiate, nextCronFireMs, normalizeAttributeRows, normalizeDescriptor, observedAnnouncements, parentRunIdOf, parseDuration, partitionOfToken, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveConcurrency, resolveRouting, resolveRunWaiting, runDurableExecution, runInStepLogger, runInStepScope, runInWorkflowCtx, runOutsideWorkflowCtx, runSchedules, runStepHandler, runValueFacetsFromRuns, sanitizeQueueToken, scheduledRunId, singletonAdmissionDenialPatch, singletonAdmissionTags, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, useDurableExecution, warn, workflowName };
+export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AllOptions, type AllStepsOptions, type AnnouncedWorkflow, type AnnouncementEvidence, type AttributeFilter, type AttributeOp, type AttributePredicateOperand, type AttributeValue, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, type ChildWait, CodecStateStore, type ConcurrencyConfig, ConcurrencyLimitError, type ConcurrencyQuota, ContinueAsNew, type ControlMessage, type ControlPlane, DEFAULT_CONCURRENCY_STATUSES, DEFAULT_PARTITION, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type Disagreement, type DispatchDiagnostics, type DispatchPlan, type DurableExecution, type DurableExecutionWrapper, type DurableTopology, type DurableWebhook, DurableWorkflow, type DynamicWorkflowCtx, ENGINE_MINTED_TAG_PREFIXES, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, type FanJoin, type FanWait, FatalError, GatherError, type GroupHealth, type Heartbeat, type HeartbeatSighting, type HeartbeatStatus, type HistoryEvent, InMemoryAdmissionBackend, InMemoryStateStore, InMemoryTransport, type InferSearchAttributes, LEGACY_V1_CAPABILITIES, LEGACY_V1_PROTOCOL, type MetricsCollector, type MetricsSnapshot, type NamedTransport, type NegotiateOptions, type NegotiationOutcome, type NegotiationReason, type NegotiationResult, NestedWorkflowCallError, NonDeterminismError, type PartitionSighting, type PayloadCodec, type QueueConfig, QueueController, RUN_VALUE_FACET_LIMIT, RUN_VALUE_FACET_SCAN, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, type RunFacetQuery, type RunFacetRow, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunScope, type RunStatus, type RunValueAxis, type RunValueFacetOptions, type RunValueFacetOrder, type RunValueFacetRow, type RunWaiting, SINGLETON_ACTIVE_STATUSES, SINGLETON_ADMITTED_TAG, STATE_STORE, STATE_STORE_CANONICAL, type ScalarAttributeFilter, ScheduleAlreadyExistsError, ScheduleClient, type ScheduleClientOptions, type ScheduleDescription, type ScheduleHost, type ScheduleListQuery, ScheduleNotFoundError, type ScheduleOptions, type ScheduleQuery, type ScheduleRecord, type ScheduledWorkflow, type SearchAttributes, type SearchAttributesSchema, SignalTimeoutError, type SignalWaiter, type SingletonConfig, SingletonQueueFullError, StandardSchemaV1, type StartOptions, type StartRunMessage, type StateStore, type StepCheckpoint, type StepConfig, type StepDef, type StepDispatchOpts, type StepError, type StepEvent, type StepHandler, type StepInterceptor, type StepInvocation, type StepKind, type StepLogger, type StepOptions, type StepRef, type StepResult, type StepScope, type StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, VERSION_UNDECLARED_TAG, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, type WorkflowAnnouncement, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, type WorkflowDirectory, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRegistration, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, aggregateAnnouncements, announcementsOf, applyAttributeQuery, assertConcurrency, attributeColumnFor, attributeOperand, attributePredicateOperands, axisIsRunColumn, bindWorkflowClass, breakpointToken, buildWorkflowDirectory, canRoute, capableWorkers, classifyWaiterToken, clearDurableExecutionWrappers, clearTerminalSingletonAdmission, collectMetrics, concurrencyTag, controlPlaneDescriptor, countRuns, coveredTokens, createStepLogger, currentStep, currentStepScope, currentWorkflowCtx, debug, describeWorker, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, facetOrigin, hasDurableExecutionWrappers, heartbeatStatus, indexWaitersByRun, info, isEngineMintedTag, isEventToken, isLegacyDescriptor, isNonEmptyRunScope, isWorkflowControlFlowSignal, listSignalWaitersOfRuns, log, matchesAttributes, mergeRunFacetRows, mergeRunValueFacetRows, missingCapabilities, negotiate, nextCronFireMs, normalizeAttributeRows, normalizeDescriptor, observedAnnouncements, parentRunIdOf, parseDuration, partitionOfToken, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveConcurrency, resolveRouting, resolveRunWaiting, runDurableExecution, runInStepLogger, runInStepScope, runInWorkflowCtx, runOutsideWorkflowCtx, runSchedules, runStepHandler, runValueFacetsFromRuns, sanitizeQueueToken, scheduledRunId, singletonAdmissionDenialPatch, singletonAdmissionTags, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, useDurableExecution, warn, workflowName };