@adonis-agora/durable 0.49.0 → 0.50.0

package/dist/src/remote-workflow-executor.d.ts

@@ -2,25 +2,47 @@ import type { HistoryEvent, Transport, WorkflowDecision, WorkflowExecutor, Workf
 import { type WorkflowBodyResolver } from './workflow-turn.js';
 /**
  * A {@link WorkflowExecutor} backed by a {@link Transport}: it advances a remote workflow by
- * dispatching a {@link WorkflowTask} over the broker and awaiting the matching {@link WorkflowDecision}
- * (correlated by `taskId`). Pass one to `engine.registerRemote(name, version, { group, executor })` so
- * a workflow authored in another SDK (e.g. the Python `durable-worker`) is driven over Redis/BullMQ.
+ * DISPATCHING a {@link WorkflowTask} over the broker under the ENGINE-SUPPLIED `taskId`, WITHOUT
+ * awaiting the decision. Pass one to `engine.registerRemote(name, version, { group, executor })` so a
+ * workflow authored in another SDK (e.g. the Python `durable-worker`) is driven over Redis/BullMQ.
  *
- * Recovery-safe: if the engine crashes awaiting a decision, the re-drive dispatches a fresh task with
- * the same history — the worker's replay is deterministic, so it returns the same decision; a late
- * decision for the old `taskId` simply finds no waiter and is dropped.
+ * Multi-instance safe by construction: the executor holds NO in-memory state correlating a turn to its
+ * decision. The engine records the `taskId` on the run as the awaited marker and releases the run lease
+ * BEFORE calling {@link dispatch}; the worker's {@link WorkflowDecision} comes back over the transport's
+ * `onDecision` and is applied durably (by run id) by whichever engine replica consumes it — even one
+ * that did not dispatch the turn. A point-to-point decisions queue can therefore hand the decision to
+ * any replica without it being dropped.
+ *
+ * Recovery-safe: when a decision is genuinely lost (the worker died mid-turn), the awaited turn's
+ * liveness window (`remoteAdvanceSilenceMs` on the engine, or `timeoutMs` here; run-scoped heartbeats
+ * rearm it) lapses and the timer poller re-dispatches a fresh turn with the same history — the
+ * worker's replay is deterministic, so it returns the same decision, and a late decision for the old
+ * `taskId` no longer matches the run's marker and is dropped.
  */
 export declare class RemoteWorkflowExecutor implements WorkflowExecutor {
+    #private;
     private readonly transport;
     private readonly group;
-    private readonly opts;
-    private readonly pending;
-    private subscribed;
-    constructor(transport: Transport, group: string, opts?: {
+    /**
+     * The executor's own liveness window for a dispatched turn, from `opts.timeoutMs`. It no longer fails
+     * the run: a lapsed window re-drives the turn (see the class doc).
+     */
+    readonly decisionTimeoutMs: number | undefined;
+    /**
+     * @param group The worker group the turns are dispatched to — or a function of the run, for a
+     *   group that depends on it (the engine's convention routing sends each run to the group of its own
+     *   namespace, `<workflow>@<tenant>`).
+     */
+    constructor(transport: Transport, group: string | ((run: WorkflowRun) => string), opts?: {
         timeoutMs?: number;
     });
-    private ensureSubscribed;
-    advance(run: WorkflowRun, history: HistoryEvent[]): Promise<WorkflowDecision>;
+    /** Subscribe the engine's (stable) decision handler to this executor's transport, once. */
+    subscribeDecisions(handler: (decision: WorkflowDecision) => Promise<void>): void;
+    /**
+     * Enqueue one workflow turn under the engine-supplied `taskId`. Does NOT await the decision — the
+     * engine has already suspended the run on `taskId` and applies the decision durably via `onDecision`.
+     */
+    dispatch(run: WorkflowRun, history: HistoryEvent[], taskId: string, pendingSignals?: WorkflowTask['pendingSignals']): Promise<void>;
 }
 /**
  * A {@link WorkflowExecutor} that advances a workflow turn IN-PROCESS through the shared, pure

package/dist/src/remote-workflow-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-workflow-executor.d.ts","sourceRoot":"","sources":["../../src/remote-workflow-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAIhF;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAK3D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;IACnF,OAAO,CAAC,UAAU,CAAS;IAE3B,YACmB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,EAChD;IAEJ,OAAO,CAAC,gBAAgB;IAelB,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BlF;CACF;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;;IAI9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFvB,YACmB,MAAM,EAAE,oBAAoB,EAC5B,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,EAChE;IAEE,OAAO,CACX,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,YAAY,EAAE,EACvB,cAAc,CAAC,EAAE,YAAY,CAAC,gBAAgB,CAAC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CAiB3B;CACF"}
+{"version":3,"file":"remote-workflow-executor.d.ts","sourceRoot":"","sources":["../../src/remote-workflow-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;;IAc3D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAbxB;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/C;;;;OAIG;IACH,YACmB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC,EAC/D,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,EAGlC;IAED,2FAA2F;IAC3F,kBAAkB,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAI/E;IAED;;;OAGG;IACG,QAAQ,CACZ,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,YAAY,CAAC,gBAAgB,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAoBf;CACF;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;;IAI9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFvB,YACmB,MAAM,EAAE,oBAAoB,EAC5B,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,EAChE;IAEE,OAAO,CACX,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,YAAY,EAAE,EACvB,cAAc,CAAC,EAAE,YAAY,CAAC,gBAAgB,CAAC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,CAiB3B;CACF"}

package/dist/src/remote-workflow-executor.js

@@ -1,48 +1,60 @@
 import { runWorkflowTurn } from './workflow-turn.js';
-let taskCounter = 0;
 /**
  * A {@link WorkflowExecutor} backed by a {@link Transport}: it advances a remote workflow by
- * dispatching a {@link WorkflowTask} over the broker and awaiting the matching {@link WorkflowDecision}
- * (correlated by `taskId`). Pass one to `engine.registerRemote(name, version, { group, executor })` so
- * a workflow authored in another SDK (e.g. the Python `durable-worker`) is driven over Redis/BullMQ.
+ * DISPATCHING a {@link WorkflowTask} over the broker under the ENGINE-SUPPLIED `taskId`, WITHOUT
+ * awaiting the decision. Pass one to `engine.registerRemote(name, version, { group, executor })` so a
+ * workflow authored in another SDK (e.g. the Python `durable-worker`) is driven over Redis/BullMQ.
  *
- * Recovery-safe: if the engine crashes awaiting a decision, the re-drive dispatches a fresh task with
- * the same history — the worker's replay is deterministic, so it returns the same decision; a late
- * decision for the old `taskId` simply finds no waiter and is dropped.
+ * Multi-instance safe by construction: the executor holds NO in-memory state correlating a turn to its
+ * decision. The engine records the `taskId` on the run as the awaited marker and releases the run lease
+ * BEFORE calling {@link dispatch}; the worker's {@link WorkflowDecision} comes back over the transport's
+ * `onDecision` and is applied durably (by run id) by whichever engine replica consumes it — even one
+ * that did not dispatch the turn. A point-to-point decisions queue can therefore hand the decision to
+ * any replica without it being dropped.
+ *
+ * Recovery-safe: when a decision is genuinely lost (the worker died mid-turn), the awaited turn's
+ * liveness window (`remoteAdvanceSilenceMs` on the engine, or `timeoutMs` here; run-scoped heartbeats
+ * rearm it) lapses and the timer poller re-dispatches a fresh turn with the same history — the
+ * worker's replay is deterministic, so it returns the same decision, and a late decision for the old
+ * `taskId` no longer matches the run's marker and is dropped.
  */
 export class RemoteWorkflowExecutor {
     transport;
     group;
-    opts;
-    pending = new Map();
-    subscribed = false;
+    #subscribed = false;
+    /**
+     * The executor's own liveness window for a dispatched turn, from `opts.timeoutMs`. It no longer fails
+     * the run: a lapsed window re-drives the turn (see the class doc).
+     */
+    decisionTimeoutMs;
+    /**
+     * @param group The worker group the turns are dispatched to — or a function of the run, for a
+     *   group that depends on it (the engine's convention routing sends each run to the group of its own
+     *   namespace, `<workflow>@<tenant>`).
+     */
     constructor(transport, group, opts = {}) {
         this.transport = transport;
         this.group = group;
-        this.opts = opts;
+        this.decisionTimeoutMs = opts.timeoutMs || undefined;
     }
-    ensureSubscribed() {
-        if (this.subscribed)
+    /** Subscribe the engine's (stable) decision handler to this executor's transport, once. */
+    subscribeDecisions(handler) {
+        if (this.#subscribed || !this.transport.onDecision)
             return;
-        if (!this.transport.onDecision) {
-            throw new Error('transport does not support workflow decisions (onDecision)');
-        }
-        this.subscribed = true;
-        this.transport.onDecision(async (decision) => {
-            const resolve = this.pending.get(decision.taskId);
-            if (resolve) {
-                this.pending.delete(decision.taskId);
-                resolve(decision);
-            }
-        });
+        this.#subscribed = true;
+        this.transport.onDecision(handler);
     }
-    async advance(run, history) {
+    /**
+     * Enqueue one workflow turn under the engine-supplied `taskId`. Does NOT await the decision — the
+     * engine has already suspended the run on `taskId` and applies the decision durably via `onDecision`.
+     */
+    async dispatch(run, history, taskId, pendingSignals) {
         if (!this.transport.dispatchWorkflowTask) {
             throw new Error('transport does not support workflow tasks (dispatchWorkflowTask)');
         }
-        this.ensureSubscribed();
-        taskCounter += 1;
-        const taskId = `${run.id}:wf:${taskCounter}`;
+        if (!this.transport.onDecision) {
+            throw new Error('transport does not support workflow decisions (onDecision)');
+        }
         const task = {
             taskId,
             runId: run.id,
@@ -50,22 +62,12 @@ export class RemoteWorkflowExecutor {
             workflowVersion: run.workflowVersion,
             input: run.input,
             history,
-            group: this.group,
+            ...(pendingSignals ? { pendingSignals } : {}),
+            group: typeof this.group === 'function' ? this.group(run) : this.group,
             priority: run.priority,
             attempt: 1,
         };
-        const decision = new Promise((resolve, reject) => {
-            this.pending.set(taskId, resolve);
-            if (this.opts.timeoutMs) {
-                const timer = setTimeout(() => {
-                    this.pending.delete(taskId);
-                    reject(new Error(`workflow task ${taskId} timed out after ${this.opts.timeoutMs}ms`));
-                }, this.opts.timeoutMs);
-                timer.unref?.();
-            }
-        });
         await this.transport.dispatchWorkflowTask(task);
-        return decision;
     }
 }
 /**

package/dist/src/remote-workflow-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote-workflow-executor.js","sourceRoot":"","sources":["../../src/remote-workflow-executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"remote-workflow-executor.js","sourceRoot":"","sources":["../../src/remote-workflow-executor.ts"],"names":[],"mappings":"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"}

package/dist/src/run-detail-summary.d.ts

@@ -1,4 +1,4 @@
-import type { StepCheckpoint, WorkflowRun } from './interfaces.js';
+import { type CheckpointQuery, type CheckpointStat, type StateStore, type StepCheckpoint, type WorkflowRun } from './interfaces.js';
 /**
  * A parallel fan (a `ctx.all`, a step fan, a polyglot `gather`) reduced to what a detail view needs
  * to draw it: one node, its progress and its failures. A run detail with a 40,000-item fan otherwise
@@ -34,16 +34,28 @@ export interface FanPage {
     items: StepCheckpoint[];
     /** Members matching the query, across all pages. */
     total: number;
+    /** A validator for this page, when the source can compute one without reading the members. */
+    etag?: string | undefined;
+    /**
+     * Set when the query's `ifNoneMatch` matched {@link etag}: the page has not changed, so nothing
+     * was read. `items` is empty and `total` is 0 as placeholders, not the fan's; keep the page the
+     * caller already holds.
+     */
+    notModified?: true | undefined;
 }
 export interface FanPageQuery {
     offset?: number | undefined;
     limit?: number | undefined;
     /** Only failed members (a failed step, or a child that failed). */
     failedOnly?: boolean | undefined;
+    /** An HTTP `If-None-Match` value: a page whose `etag` it names comes back `notModified`. */
+    ifNoneMatch?: string | undefined;
 }
 export declare const FAN_SUMMARY_FAILURES = 20;
 /** The most children a summarized detail lists by id; `childCount` carries the rest. */
 export declare const SUMMARY_CHILD_LIMIT = 200;
+/** How many children a folded `fan:` checkpoint stands for; undefined for any other checkpoint. */
+export declare function foldedCount(cp: StepCheckpoint): number | undefined;
 /** A failed member: a failed step, or a child whose completion reports `ok: false`. */
 export declare function isFailedMember(cp: StepCheckpoint): boolean;
 /** Summarize one fan's members (in seq order). */
@@ -60,6 +72,11 @@ export declare function summarizeTimeline(timeline: StepCheckpoint[], over: numb
 };
 /** One page of a fan's members out of a run's timeline. */
 export declare function pageFan(timeline: StepCheckpoint[], group: string, query: FanPageQuery): FanPage;
+/** A {@link FanPageQuery}'s offset and limit, clamped to sane bounds. */
+export declare function fanPageBounds(query: FanPageQuery): {
+    offset: number;
+    limit: number;
+};
 /**
  * A run's detail: the run, its step timeline, and the runs it spawned. With
  * {@link RunDetailOptions.summarizeFansOver}, the members of a wide fan are left out of `timeline`
@@ -75,6 +92,16 @@ export interface RunDetail {
     fans?: FanSummary[] | undefined;
     /** How many children the run has, when `children` lists only the first of them. */
     childCount?: number | undefined;
+    /**
+     * A validator for this detail, when the source can compute one without reading the timeline (a
+     * store with `checkpointStats`): it changes whenever the run or any of its checkpoints does.
+     */
+    etag?: string | undefined;
+    /**
+     * Set when {@link RunDetailOptions.ifNoneMatch} matched {@link etag}: nothing changed, so only
+     * `run` was read — `timeline` and `children` are empty, not the run's.
+     */
+    notModified?: true | undefined;
 }
 /** How to shape a {@link RunDetail}. */
 export interface RunDetailOptions {
@@ -84,15 +111,75 @@ export interface RunDetailOptions {
      * fan should set it: the full detail of a 40k-member fan is megabytes.
      */
     summarizeFansOver?: number | undefined;
+    /**
+     * An HTTP `If-None-Match` value. When it names the detail's current {@link RunDetail.etag}, the
+     * detail comes back `notModified` without the timeline being read. Ignored when no etag can be
+     * computed (no `summarizeFansOver`, or a store without the checkpoint aggregates).
+     */
+    ifNoneMatch?: string | undefined;
 }
-/** The reads a {@link RunDetail} is built from — an engine, a dashboard port, or a gateway. */
+/**
+ * The reads a {@link RunDetail} is built from — an engine, a dashboard port, or a gateway. With both
+ * of the optional aggregate reads (a store's `checkpointStats` + `queryCheckpoints`), a summarized
+ * detail and a fan page are built from the aggregates instead of the whole checkpoint list, and come
+ * back with an `etag`.
+ */
 export interface RunDetailSource {
     getRun(runId: string): Promise<WorkflowRun | null>;
     listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
     getRunChildren(runId: string): Promise<string[]>;
+    checkpointStats?: StateStore['checkpointStats'] | undefined;
+    queryCheckpoints?: StateStore['queryCheckpoints'] | undefined;
 }
 /** Read `runId`'s {@link RunDetail}, summarized per `options`, or null for an unknown run. */
 export declare function loadRunDetail(source: RunDetailSource, runId: string, options?: RunDetailOptions): Promise<RunDetail | null>;
 /** One page of `runId`'s fan `group`, or null for an unknown run. */
-export declare function loadFanMembers(source: Pick<RunDetailSource, 'getRun' | 'listCheckpoints'>, runId: string, group: string, query: FanPageQuery): Promise<FanPage | null>;
+export declare function loadFanMembers(source: Pick<RunDetailSource, 'getRun' | 'listCheckpoints' | 'checkpointStats' | 'queryCheckpoints'>, runId: string, group: string, query: FanPageQuery): Promise<FanPage | null>;
+/** A source that aggregates checkpoints itself: both halves of the pair are present. */
+export type CheckpointAggregatingStore = Required<Pick<StateStore, 'checkpointStats' | 'queryCheckpoints'>>;
+/** Whether `source` has both aggregate reads ({@link StateStore.checkpointStats} + `queryCheckpoints`). */
+export declare function aggregatesCheckpoints<T extends {
+    checkpointStats?: StateStore['checkpointStats'] | undefined;
+    queryCheckpoints?: StateStore['queryCheckpoints'] | undefined;
+}>(source: T): source is T & CheckpointAggregatingStore;
+/**
+ * {@link StateStore.checkpointStats} over checkpoints already in memory — the reference a store's
+ * `GROUP BY` must agree with, and the in-memory store's implementation.
+ */
+export declare function checkpointStatsOf(checkpoints: StepCheckpoint[], opts?: {
+    group?: string | undefined;
+}): CheckpointStat[];
+/** {@link StateStore.queryCheckpoints} over checkpoints already in memory, sorted by `seq` here. */
+export declare function queryCheckpointsOf(checkpoints: StepCheckpoint[], query: CheckpointQuery): StepCheckpoint[];
+/**
+ * What `summarizeTimeline` plus `childIdsOf` make of a run's whole checkpoint list, read through the
+ * store's aggregates instead: the checkpoints outside wide fans, one {@link FanSummary} per wide fan,
+ * and the run's children capped at {@link SUMMARY_CHILD_LIMIT} with their count.
+ *
+ * What it reads besides the aggregates: the rows outside wide fans, every folded `fan:` checkpoint
+ * (one per settled wave), up to {@link FAN_SUMMARY_FAILURES} failed rows per wide fan, the first
+ * child-edge rows, and — while a wide child fan is in flight — that fan's completed `signal:child:`
+ * rows, whose `ok: false` payload is what marks a failed child.
+ *
+ * `childCount` is exact (distinct ids, as `loadRunDetail` counts them) while the run has few enough
+ * child edges to read them all. Past that it adds up the edge rows and the folded ids without
+ * de-duplicating, so a child both spawned and awaited counts twice.
+ */
+export declare function summarizeRunFromStore(store: CheckpointAggregatingStore, runId: string, over: number, stats?: CheckpointStat[]): Promise<{
+    timeline: StepCheckpoint[];
+    fans: FanSummary[];
+    children: string[];
+    childCount: number;
+}>;
+/** What `pageFan` makes of a run's whole checkpoint list, read one page at a time from the store. */
+export declare function pageFanFromStore(store: CheckpointAggregatingStore, runId: string, group: string, query: FanPageQuery, stats?: CheckpointStat[]): Promise<FanPage>;
+/**
+ * The ETag of a summarized run detail: the run row as read (so any run field that changes shows)
+ * plus its checkpoint buckets, and the threshold it was summarized with.
+ */
+export declare function runDetailEtag(run: WorkflowRun, stats: CheckpointStat[], over: number): string;
+/** The ETag of one page of a fan: its group's buckets and the page asked for. */
+export declare function fanPageEtag(group: string, stats: CheckpointStat[], query: FanPageQuery): string;
+/** Whether an `If-None-Match` header value names `etag` (weak comparison, as RFC 9110 asks for). */
+export declare function etagMatches(ifNoneMatch: string | undefined, etag: string): boolean;
 //# sourceMappingURL=run-detail-summary.d.ts.map

package/dist/src/run-detail-summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-detail-summary.d.ts","sourceRoot":"","sources":["../../src/run-detail-summary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-detail-summary.d.ts","sourceRoot":"","sources":["../../src/run-detail-summary.ts"],"names":[],"mappings":"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"}