@dudousxd/nestjs-durable-core 0.59.0 → 0.61.0

package/dist/index.d.cts

@@ -2060,6 +2060,66 @@ declare function runInWorkflowCtx<T>(ctx: WorkflowCtx, fn: () => T): T;
  */
 declare function currentWorkflowCtx(): WorkflowCtx | undefined;
 
+/**
+ * Run `fn` with `logger` as the ambient step logger. Engine-internal: wraps every execution of a
+ * step body, binding the SAME logger instance the body receives as its second argument — never a
+ * second one, so an event emitted ambiently and one emitted through the argument land in the same
+ * `StepEvent[]` and are checkpointed together.
+ *
+ * Because it is an `AsyncLocalStorage`, concurrent step invocations (the worker runs steps under
+ * adaptive concurrency) each see their own logger — they never leak into one another.
+ */
+declare function runInStepLogger<T>(logger: StepLogger, fn: () => T): T;
+/**
+ * The {@link StepLogger} of the step body currently executing on this async path — or `undefined`
+ * outside one. Reading it is the escape hatch for code that cannot take a logger parameter:
+ *
+ * ```ts
+ * currentStep()?.subEvent({ id, name: 'insert', phase: `${rows} rows` });
+ * ```
+ */
+declare function currentStep(): StepLogger | undefined;
+/**
+ * Record a log line on the current step, taking the level as a value. No-op outside a step. The
+ * literal twin of the Python SDK's module-level `log(level, message, data)` — keep reaching for it
+ * when the level is computed (mapping a foreign log level, re-emitting a captured record); for a
+ * level known at the call site the per-level shortcuts below read better.
+ *
+ * The no-op contract is what lets a generic utility be instrumented without an `if` at the call
+ * site, and keeps it usable in a unit test with no durable run around it.
+ */
+declare function log(level: 'debug' | 'info' | 'warn' | 'error', message: string, data?: unknown): void;
+/** Record a `debug` line on the current step. No-op outside a step. */
+declare function debug(message: string, data?: unknown): void;
+/** Record an `info` line on the current step. No-op outside a step. */
+declare function info(message: string, data?: unknown): void;
+/** Record a `warn` line on the current step. No-op outside a step. */
+declare function warn(message: string, data?: unknown): void;
+/** Record an `error` line on the current step. No-op outside a step — note this only RECORDS a line;
+ *  it never fails the step (that is what throwing from the body does). */
+declare function error(message: string, data?: unknown): void;
+/** Record a sub-step / sub-process outcome on the current step. No-op outside a step. */
+declare function sub(name: string, status: 'ok' | 'failed' | 'skipped', message?: string, data?: unknown): void;
+/** Record a sub-process event (phase or terminal outcome) on the current step. No-op outside a step. */
+declare function subEvent(e: {
+    id: string;
+    name: string;
+    group?: string | undefined;
+    phase?: string | undefined;
+    status?: 'ok' | 'failed' | 'skipped' | undefined;
+    message?: string | undefined;
+    data?: unknown;
+}): void;
+/**
+ * Run `body` as a timed sub-process of the current step (see {@link StepLogger.subProcess}).
+ * Outside a step the body still RUNS — and still gets a handle — but nothing is emitted; only the
+ * observability disappears, never the work. Mirrors the Python SDK's `sub_process`.
+ */
+declare function subProcess<T>(name: string, body: (sp: SubProcessHandle) => Promise<T> | T, opts?: {
+    group?: string;
+    id?: string;
+}): Promise<T>;
+
 /**
  * Cross-package, cross-runtime marker for engine CONTROL-FLOW signals — {@link WorkflowSuspended}
  * and {@link ContinueAsNew} (this package), plus the thin worker's {@link
@@ -2708,6 +2768,13 @@ declare class WorkflowEngine {
      * replay from their checkpoints, so only the work that had not finished runs again.
      */
     recoverIncomplete(nowMs?: number): Promise<RunResult[]>;
+    /**
+     * The remote step this run dispatched and is still awaiting a result for, if any — the signature
+     * that tells {@link recoverIncomplete} "this run's work is ON THE TRANSPORT, not in a crashed
+     * process". A `pending` remote checkpoint is written BEFORE the dispatch and settled by the
+     * worker's result, so its presence is the durable marker of an in-flight dispatched step.
+     */
+    private inFlightRemoteStep;
     /**
      * Per-recovery bookkeeping (called once the lease is held): count the attempt, or — past
      * `maxRecoveryAttempts` — move a poison pill to the `dead` dead-letter state. Returns a terminal
@@ -2776,9 +2843,11 @@ declare class WorkflowEngine {
      * Explicitly re-dispatch every remote step of `runId` stuck `pending` — the OPERATOR escape hatch for
      * a run whose dispatched step job was LOST (worker crashed with no result, or a transport that dropped
      * the job). No automatic recovery re-drives these: a reconcile re-drive re-suspends a still-pending
-     * step by design (unless `remoteRedispatchMs` is set), `recoverIncomplete` only reclaims LEASED runs,
-     * and `requeue` just replays back to the pending guard. This re-enqueues the same `stepId` so the
-     * (idempotent) step re-runs and its result resumes the run. Safe to call on a healthy run — it re-runs
+     * step by design (unless `remoteRedispatchMs` is set), `recoverIncomplete` explicitly SKIPS a run with
+     * an in-flight `pending` remote step (it re-asserts the durably-suspended invariant instead of counting
+     * a recovery attempt — see there), and `requeue` just replays back to the pending guard. This
+     * re-enqueues the same `stepId` so the (idempotent) step re-runs and its result resumes the run.
+     * Safe to call on a healthy run — it re-runs
      * only in-flight `pending` remote steps, which are idempotent by the durable contract. Returns the
      * run's current status (with the count re-dispatched), or null if the run is unknown.
      */
@@ -3645,15 +3714,21 @@ type WireDates<T> = {
  * a `ProxyRunGateway` that round-trips over the transport. Deliberately smaller than the full dashboard
  * (no metrics/bulk/update/signal) — those stay control-plane-only. `workerHealth` IS on the port: the
  * operator answers it scoped to the requester's own groups, so a tenant's Workers panel works too.
+ *
+ * Declared as an **abstract class** rather than an interface so it doubles as its own NestJS DI token
+ * (the idiomatic inject-by-type pattern): providers bind `{ provide: RunGateway, useClass/useFactory }`
+ * and consumers inject `constructor(private readonly gateway: RunGateway)` with no string/symbol token.
+ * `StoreRunGateway`/`ProxyRunGateway` `implements RunGateway`; abstract methods carry no body, so the
+ * emitted runtime class is an empty, non-instantiable shell used only as the token.
  */
-interface RunGateway {
+declare abstract class RunGateway {
     /** This deployment's durable role (control plane vs tenant) — synchronous local metadata. */
-    topology(): DurableTopology;
-    getRunDetail(runId: string): Promise<RunDetail | null>;
+    abstract topology(): DurableTopology;
+    abstract getRunDetail(runId: string): Promise<RunDetail | null>;
     /** List runs, each optionally carrying a {@link RunWaiting} descriptor (what a suspended run is
      *  parked on). The store-backed gateway resolves `waiting`; a proxy relays whatever the control
      *  plane sent. */
-    listRuns(query: RunQuery): Promise<RunListItem[]>;
+    abstract listRuns(query: RunQuery): Promise<RunListItem[]>;
     /**
      * Bulk-resolve {@link RunWaiting} for an arbitrary set of run ids — for a consumer with its OWN
      * filtered/paginated run listing (so it isn't just `listRuns` under another name) that needs to know
@@ -3664,26 +3739,26 @@ interface RunGateway {
      * parked on something non-event (a bare `ctx.sleep`, an in-flight step) are simply absent, same as a
      * `listRuns` row with no `waiting`.
      */
-    waitingFor(runIds: string[]): Promise<Record<string, RunWaiting>>;
+    abstract waitingFor(runIds: string[]): Promise<Record<string, RunWaiting>>;
     /** Per-group worker health (queue backlog + live worker heartbeats). On the control plane this is
      *  every group; over a tenant proxy the operator scopes it to the tenant's own groups. */
-    workerHealth(): Promise<GroupHealth[]>;
-    cancel(runId: string, opts?: {
+    abstract workerHealth(): Promise<GroupHealth[]>;
+    abstract cancel(runId: string, opts?: {
         compensate?: boolean;
     }): Promise<RunResult | null>;
-    retry(runId: string): Promise<RunResult | null>;
-    continue(runId: string): Promise<RunResult | null>;
+    abstract retry(runId: string): Promise<RunResult | null>;
+    abstract continue(runId: string): Promise<RunResult | null>;
     /** Re-dispatch every remote step of a run stuck `pending` — the operator recovery for a LOST step
      *  dispatch (crashed worker / dropped job) that no automatic path re-drives. Returns the run's status
      *  plus how many steps were re-dispatched, or null if the run is unknown. */
-    redispatchPending(runId: string): Promise<(RunResult & {
+    abstract redispatchPending(runId: string): Promise<(RunResult & {
         redispatched: number;
     }) | null>;
-    retryWithInput(runId: string, input: unknown): Promise<{
+    abstract retryWithInput(runId: string, input: unknown): Promise<{
         runId: string;
     } | null>;
     /** Live lifecycle events for one run; returns an unsubscribe fn. Framework-agnostic (no rxjs). */
-    subscribe(runId: string, onEvent: (event: EngineEvent) => void): () => void;
+    abstract subscribe(runId: string, onEvent: (event: EngineEvent) => void): () => void;
 }
 
 /**
@@ -4217,4 +4292,4 @@ declare class InMemoryTransport implements Transport, ControlPlane {
     onControl(handler: (msg: ControlMessage) => void): void;
 }
 
-export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AttributeFilter, type AttributeOp, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, CodecStateStore, ContinueAsNew, type ControlMessage, type ControlPlane, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type DispatchDiagnostics, type DispatchPlan, type DurableTopology, type DurableWebhook, DurableWorkflow, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, FatalError, GatherError, type GroupHealth, type Heartbeat, 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, NonDeterminismError, type PayloadCodec, type QueueConfig, QueueController, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, type RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunStatus, type RunWaiting, STATE_STORE, STATE_STORE_CANONICAL, 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 StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, applyAttributeQuery, attributeColumnFor, attributeOperand, bindWorkflowClass, breakpointToken, canRoute, capableWorkers, classifyWaiterToken, collectMetrics, controlPlaneDescriptor, createStepLogger, currentWorkflowCtx, descriptorHash, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, heartbeatStatus, indexWaitersByRun, isEventToken, isLegacyDescriptor, isWorkflowControlFlowSignal, matchesAttributes, missingCapabilities, negotiate, normalizeAttributeRows, normalizeDescriptor, parseDuration, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveRouting, resolveRunWaiting, runInWorkflowCtx, runSchedules, runStepHandler, sanitizeQueueToken, scheduledRunId, sqlComparator, stepConfigOf, stepId, stepNameOf, tenantGroup, workflowName };
+export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AttributeFilter, type AttributeOp, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, CodecStateStore, ContinueAsNew, type ControlMessage, type ControlPlane, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type DispatchDiagnostics, type DispatchPlan, type DurableTopology, type DurableWebhook, DurableWorkflow, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, FatalError, GatherError, type GroupHealth, type Heartbeat, 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, NonDeterminismError, type PayloadCodec, type QueueConfig, QueueController, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunStatus, type RunWaiting, STATE_STORE, STATE_STORE_CANONICAL, 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 StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, applyAttributeQuery, attributeColumnFor, attributeOperand, bindWorkflowClass, breakpointToken, canRoute, capableWorkers, classifyWaiterToken, collectMetrics, controlPlaneDescriptor, createStepLogger, currentStep, currentWorkflowCtx, debug, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, heartbeatStatus, indexWaitersByRun, info, isEventToken, isLegacyDescriptor, isWorkflowControlFlowSignal, log, matchesAttributes, missingCapabilities, negotiate, normalizeAttributeRows, normalizeDescriptor, parseDuration, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveRouting, resolveRunWaiting, runInStepLogger, runInWorkflowCtx, runSchedules, runStepHandler, sanitizeQueueToken, scheduledRunId, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, warn, workflowName };

package/dist/index.d.ts

@@ -2060,6 +2060,66 @@ declare function runInWorkflowCtx<T>(ctx: WorkflowCtx, fn: () => T): T;
  */
 declare function currentWorkflowCtx(): WorkflowCtx | undefined;
 
+/**
+ * Run `fn` with `logger` as the ambient step logger. Engine-internal: wraps every execution of a
+ * step body, binding the SAME logger instance the body receives as its second argument — never a
+ * second one, so an event emitted ambiently and one emitted through the argument land in the same
+ * `StepEvent[]` and are checkpointed together.
+ *
+ * Because it is an `AsyncLocalStorage`, concurrent step invocations (the worker runs steps under
+ * adaptive concurrency) each see their own logger — they never leak into one another.
+ */
+declare function runInStepLogger<T>(logger: StepLogger, fn: () => T): T;
+/**
+ * The {@link StepLogger} of the step body currently executing on this async path — or `undefined`
+ * outside one. Reading it is the escape hatch for code that cannot take a logger parameter:
+ *
+ * ```ts
+ * currentStep()?.subEvent({ id, name: 'insert', phase: `${rows} rows` });
+ * ```
+ */
+declare function currentStep(): StepLogger | undefined;
+/**
+ * Record a log line on the current step, taking the level as a value. No-op outside a step. The
+ * literal twin of the Python SDK's module-level `log(level, message, data)` — keep reaching for it
+ * when the level is computed (mapping a foreign log level, re-emitting a captured record); for a
+ * level known at the call site the per-level shortcuts below read better.
+ *
+ * The no-op contract is what lets a generic utility be instrumented without an `if` at the call
+ * site, and keeps it usable in a unit test with no durable run around it.
+ */
+declare function log(level: 'debug' | 'info' | 'warn' | 'error', message: string, data?: unknown): void;
+/** Record a `debug` line on the current step. No-op outside a step. */
+declare function debug(message: string, data?: unknown): void;
+/** Record an `info` line on the current step. No-op outside a step. */
+declare function info(message: string, data?: unknown): void;
+/** Record a `warn` line on the current step. No-op outside a step. */
+declare function warn(message: string, data?: unknown): void;
+/** Record an `error` line on the current step. No-op outside a step — note this only RECORDS a line;
+ *  it never fails the step (that is what throwing from the body does). */
+declare function error(message: string, data?: unknown): void;
+/** Record a sub-step / sub-process outcome on the current step. No-op outside a step. */
+declare function sub(name: string, status: 'ok' | 'failed' | 'skipped', message?: string, data?: unknown): void;
+/** Record a sub-process event (phase or terminal outcome) on the current step. No-op outside a step. */
+declare function subEvent(e: {
+    id: string;
+    name: string;
+    group?: string | undefined;
+    phase?: string | undefined;
+    status?: 'ok' | 'failed' | 'skipped' | undefined;
+    message?: string | undefined;
+    data?: unknown;
+}): void;
+/**
+ * Run `body` as a timed sub-process of the current step (see {@link StepLogger.subProcess}).
+ * Outside a step the body still RUNS — and still gets a handle — but nothing is emitted; only the
+ * observability disappears, never the work. Mirrors the Python SDK's `sub_process`.
+ */
+declare function subProcess<T>(name: string, body: (sp: SubProcessHandle) => Promise<T> | T, opts?: {
+    group?: string;
+    id?: string;
+}): Promise<T>;
+
 /**
  * Cross-package, cross-runtime marker for engine CONTROL-FLOW signals — {@link WorkflowSuspended}
  * and {@link ContinueAsNew} (this package), plus the thin worker's {@link
@@ -2708,6 +2768,13 @@ declare class WorkflowEngine {
      * replay from their checkpoints, so only the work that had not finished runs again.
      */
     recoverIncomplete(nowMs?: number): Promise<RunResult[]>;
+    /**
+     * The remote step this run dispatched and is still awaiting a result for, if any — the signature
+     * that tells {@link recoverIncomplete} "this run's work is ON THE TRANSPORT, not in a crashed
+     * process". A `pending` remote checkpoint is written BEFORE the dispatch and settled by the
+     * worker's result, so its presence is the durable marker of an in-flight dispatched step.
+     */
+    private inFlightRemoteStep;
     /**
      * Per-recovery bookkeeping (called once the lease is held): count the attempt, or — past
      * `maxRecoveryAttempts` — move a poison pill to the `dead` dead-letter state. Returns a terminal
@@ -2776,9 +2843,11 @@ declare class WorkflowEngine {
      * Explicitly re-dispatch every remote step of `runId` stuck `pending` — the OPERATOR escape hatch for
      * a run whose dispatched step job was LOST (worker crashed with no result, or a transport that dropped
      * the job). No automatic recovery re-drives these: a reconcile re-drive re-suspends a still-pending
-     * step by design (unless `remoteRedispatchMs` is set), `recoverIncomplete` only reclaims LEASED runs,
-     * and `requeue` just replays back to the pending guard. This re-enqueues the same `stepId` so the
-     * (idempotent) step re-runs and its result resumes the run. Safe to call on a healthy run — it re-runs
+     * step by design (unless `remoteRedispatchMs` is set), `recoverIncomplete` explicitly SKIPS a run with
+     * an in-flight `pending` remote step (it re-asserts the durably-suspended invariant instead of counting
+     * a recovery attempt — see there), and `requeue` just replays back to the pending guard. This
+     * re-enqueues the same `stepId` so the (idempotent) step re-runs and its result resumes the run.
+     * Safe to call on a healthy run — it re-runs
      * only in-flight `pending` remote steps, which are idempotent by the durable contract. Returns the
      * run's current status (with the count re-dispatched), or null if the run is unknown.
      */
@@ -3645,15 +3714,21 @@ type WireDates<T> = {
  * a `ProxyRunGateway` that round-trips over the transport. Deliberately smaller than the full dashboard
  * (no metrics/bulk/update/signal) — those stay control-plane-only. `workerHealth` IS on the port: the
  * operator answers it scoped to the requester's own groups, so a tenant's Workers panel works too.
+ *
+ * Declared as an **abstract class** rather than an interface so it doubles as its own NestJS DI token
+ * (the idiomatic inject-by-type pattern): providers bind `{ provide: RunGateway, useClass/useFactory }`
+ * and consumers inject `constructor(private readonly gateway: RunGateway)` with no string/symbol token.
+ * `StoreRunGateway`/`ProxyRunGateway` `implements RunGateway`; abstract methods carry no body, so the
+ * emitted runtime class is an empty, non-instantiable shell used only as the token.
  */
-interface RunGateway {
+declare abstract class RunGateway {
     /** This deployment's durable role (control plane vs tenant) — synchronous local metadata. */
-    topology(): DurableTopology;
-    getRunDetail(runId: string): Promise<RunDetail | null>;
+    abstract topology(): DurableTopology;
+    abstract getRunDetail(runId: string): Promise<RunDetail | null>;
     /** List runs, each optionally carrying a {@link RunWaiting} descriptor (what a suspended run is
      *  parked on). The store-backed gateway resolves `waiting`; a proxy relays whatever the control
      *  plane sent. */
-    listRuns(query: RunQuery): Promise<RunListItem[]>;
+    abstract listRuns(query: RunQuery): Promise<RunListItem[]>;
     /**
      * Bulk-resolve {@link RunWaiting} for an arbitrary set of run ids — for a consumer with its OWN
      * filtered/paginated run listing (so it isn't just `listRuns` under another name) that needs to know
@@ -3664,26 +3739,26 @@ interface RunGateway {
      * parked on something non-event (a bare `ctx.sleep`, an in-flight step) are simply absent, same as a
      * `listRuns` row with no `waiting`.
      */
-    waitingFor(runIds: string[]): Promise<Record<string, RunWaiting>>;
+    abstract waitingFor(runIds: string[]): Promise<Record<string, RunWaiting>>;
     /** Per-group worker health (queue backlog + live worker heartbeats). On the control plane this is
      *  every group; over a tenant proxy the operator scopes it to the tenant's own groups. */
-    workerHealth(): Promise<GroupHealth[]>;
-    cancel(runId: string, opts?: {
+    abstract workerHealth(): Promise<GroupHealth[]>;
+    abstract cancel(runId: string, opts?: {
         compensate?: boolean;
     }): Promise<RunResult | null>;
-    retry(runId: string): Promise<RunResult | null>;
-    continue(runId: string): Promise<RunResult | null>;
+    abstract retry(runId: string): Promise<RunResult | null>;
+    abstract continue(runId: string): Promise<RunResult | null>;
     /** Re-dispatch every remote step of a run stuck `pending` — the operator recovery for a LOST step
      *  dispatch (crashed worker / dropped job) that no automatic path re-drives. Returns the run's status
      *  plus how many steps were re-dispatched, or null if the run is unknown. */
-    redispatchPending(runId: string): Promise<(RunResult & {
+    abstract redispatchPending(runId: string): Promise<(RunResult & {
         redispatched: number;
     }) | null>;
-    retryWithInput(runId: string, input: unknown): Promise<{
+    abstract retryWithInput(runId: string, input: unknown): Promise<{
         runId: string;
     } | null>;
     /** Live lifecycle events for one run; returns an unsubscribe fn. Framework-agnostic (no rxjs). */
-    subscribe(runId: string, onEvent: (event: EngineEvent) => void): () => void;
+    abstract subscribe(runId: string, onEvent: (event: EngineEvent) => void): () => void;
 }
 
 /**
@@ -4217,4 +4292,4 @@ declare class InMemoryTransport implements Transport, ControlPlane {
     onControl(handler: (msg: ControlMessage) => void): void;
 }
 
-export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AttributeFilter, type AttributeOp, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, CodecStateStore, ContinueAsNew, type ControlMessage, type ControlPlane, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type DispatchDiagnostics, type DispatchPlan, type DurableTopology, type DurableWebhook, DurableWorkflow, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, FatalError, GatherError, type GroupHealth, type Heartbeat, 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, NonDeterminismError, type PayloadCodec, type QueueConfig, QueueController, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, type RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunStatus, type RunWaiting, STATE_STORE, STATE_STORE_CANONICAL, 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 StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, applyAttributeQuery, attributeColumnFor, attributeOperand, bindWorkflowClass, breakpointToken, canRoute, capableWorkers, classifyWaiterToken, collectMetrics, controlPlaneDescriptor, createStepLogger, currentWorkflowCtx, descriptorHash, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, heartbeatStatus, indexWaitersByRun, isEventToken, isLegacyDescriptor, isWorkflowControlFlowSignal, matchesAttributes, missingCapabilities, negotiate, normalizeAttributeRows, normalizeDescriptor, parseDuration, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveRouting, resolveRunWaiting, runInWorkflowCtx, runSchedules, runStepHandler, sanitizeQueueToken, scheduledRunId, sqlComparator, stepConfigOf, stepId, stepNameOf, tenantGroup, workflowName };
+export { type AccumulatorHost, type Admission, type AdmissionBackend, type AdmissionItem, type AttributeFilter, type AttributeOp, type BackoffStrategy, type BlockedDispatch, type BlockedResolution, CONTROL_FLOW_SIGNAL, CURRENT_PROTOCOL_VERSION, type CapabilityRequirement, type ChildCallOptions, CodecStateStore, ContinueAsNew, type ControlMessage, type ControlPlane, DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL, DURABLE_STEP_CONFIG, DURABLE_STEP_NAME, type DispatchDiagnostics, type DispatchPlan, type DurableTopology, type DurableWebhook, DurableWorkflow, EVENT_BUFFER_SCAN_LIMIT, EVENT_TOKEN_PREFIX, type EngineEvent, type EngineEventType, type EngineListener, Entities, type EntityConfig, type EntityHandler, type EntityHost, EventAccumulators, type EventBatchConfig, FatalError, GatherError, type GroupHealth, type Heartbeat, 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, NonDeterminismError, type PayloadCodec, type QueueConfig, QueueController, type RawWorkerDescriptor, RemoteStepError, RemoteStepTimeout, type RemoteTask, RemoteWorkflowExecutor, RemoteWorkflowTimeout, type RetentionPolicy, type RoutableDispatch, type RoutableResolution, type RoutingResolution, type RunAttributeRow, type RunDetail, type RunDispatcher, RunGateway, type RunListItem, type RunQuery, type RunReply, type RunReplyResult, type RunRequest, type RunRequestKind, type RunResult, type RunSchedulesOptions, type RunStatus, type RunWaiting, STATE_STORE, STATE_STORE_CANONICAL, 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 StepUndo, type StoreTransaction, type SubProcessHandle, TERMINAL_RUN_STATUSES, TRANSPORT, TRANSPORT_CANONICAL, type TenantEvent, type Transport, type UndoOf, type UpdateResult, type UpdateValidator, WORKFLOW_NAME_KEY, type WireDates, type WorkerAdjust, type WorkerConcurrencyStatus, type WorkerDescriptor, type WorkerHeartbeat, type WorkerLifecycle, type WorkerStatus, WorkflowBlocked, type WorkflowClass, type WorkflowCommand, type WorkflowCtx, type WorkflowDecision, WorkflowEngine, type WorkflowEngineDeps, type WorkflowExecutor, type WorkflowHandler, type WorkflowInputOf, type WorkflowOutputOf, type WorkflowRef, type WorkflowRun, type WorkflowStartClient, type WorkflowStepEvent, WorkflowSuspended, type WorkflowTask, applyAttributeQuery, attributeColumnFor, attributeOperand, bindWorkflowClass, breakpointToken, canRoute, capableWorkers, classifyWaiterToken, collectMetrics, controlPlaneDescriptor, createStepLogger, currentStep, currentWorkflowCtx, debug, descriptorHash, error, eventMatchOf, eventMatches, eventNameOf, eventPrefix, eventToken, heartbeatStatus, indexWaitersByRun, info, isEventToken, isLegacyDescriptor, isWorkflowControlFlowSignal, log, matchesAttributes, missingCapabilities, negotiate, normalizeAttributeRows, normalizeDescriptor, parseDuration, planDispatch, prevCronFireMs, readSearchAttributes, requiredCapabilities, resolveRouting, resolveRunWaiting, runInStepLogger, runInWorkflowCtx, runSchedules, runStepHandler, sanitizeQueueToken, scheduledRunId, sqlComparator, stepConfigOf, stepId, stepNameOf, sub, subEvent, subProcess, tenantGroup, warn, workflowName };