@adonis-agora/durable 0.9.1 → 0.11.0

package/dist/src/workflow-turn.js

@@ -0,0 +1,372 @@
+/**
+ * The shared, PURE "run one workflow turn" body — the TypeScript twin of the Python
+ * `durable_worker/workflow.py` (`WorkflowContext` + `process_workflow_task`). Given a {@link WorkflowTask}
+ * (a workflow name + input + the run's resolved `history`) it REPLAYS the registered body
+ * deterministically and produces a {@link WorkflowDecision} (dispatch steps / sleep / wait-signal /
+ * start-child / complete / fail / suspend). It owns NO store and does NO I/O beyond the body itself, so
+ * BOTH a store-less worker (the {@link import('./worker-runtime/worker-runtime.js').WorkerRuntime}
+ * consuming `workflow` jobs off `${P}-tasks-<token>`) AND the engine (via
+ * {@link import('./remote-workflow-executor.js').LocalWorkflowTurnExecutor}) drive a TS workflow turn
+ * through the exact same code — the same way the engine's `RemoteWorkflowExecutor` drives a Python
+ * worker's turn. It is Lucid-free (imports only interface TYPES), so it rides the lean `/worker` subpath.
+ *
+ * The wire it emits is byte-compatible with aviary: every `ctx.*` op is keyed by a deterministic `seq`;
+ * an op already resolved in `history` returns its recorded value (never re-run), and the FIRST
+ * unresolved blocking op (step/sleep/waitSignal/startChild) suspends the turn, emitting its command.
+ * `ctx.now()`/`ctx.sideEffect()` run inline and record their result once (a `recordStep` local step) so
+ * a non-deterministic capture happens exactly once and replays the same value.
+ */
+/** A step/call/child the workflow awaited resolved to a FAILURE. Thrown by the replaying op so a
+ *  workflow body can `try/catch` it (compensate, or let it propagate to fail the run) — the TS twin of
+ *  the Python `StepFailed`. Carries the structured {@link StepError} the engine recorded. */
+export class WorkflowStepFailedError extends Error {
+    error;
+    constructor(error) {
+        super(error?.message ?? 'step failed');
+        this.name = 'WorkflowStepFailedError';
+        this.error = error ?? { message: 'step failed' };
+    }
+}
+/** One or more members of a parallel fan-out ({@link WorkflowTurnCtx.gatherCalls} /
+ *  {@link WorkflowTurnCtx.gatherChildren}) resolved to a failure. Subclasses {@link WorkflowStepFailedError}
+ *  so it is catchable in a workflow body exactly like any awaited failure AND settles the turn as a
+ *  `failed` decision via {@link runWorkflowTurn}'s existing catch — the TS twin of the Python `GatherFailed`.
+ *  Its wire {@link StepError} carries the aggregate `message` (count + failing names), a `gather_failed`
+ *  `code`, and the per-item `errors` list (byte-parity with what Python emits). */
+export class WorkflowGatherFailedError extends WorkflowStepFailedError {
+    failures;
+    constructor(failures) {
+        const names = failures.map((f) => f.name).join(', ');
+        super({
+            message: `gather: ${failures.length} item(s) failed: ${names}`,
+            code: 'gather_failed',
+            // `errors` is additive runtime data (parity with the Python `GatherFailed` dict); it rides the
+            // wire but is not part of the strict {@link StepError} type, hence the cast.
+            errors: failures,
+        });
+        this.name = 'WorkflowGatherFailedError';
+        this.failures = failures;
+    }
+}
+/** The history at `seq` did not match what the replay produced there — the workflow code changed under
+ *  an in-flight run. The run fails loudly rather than silently diverging (Python `NondeterminismError`). */
+export class WorkflowNondeterminismError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkflowNondeterminismError';
+    }
+}
+/** A cooperative cancellation raised at an op boundary when the run was cancelled mid-turn — the turn
+ *  bails with a `cancelled` decision (Python `Cancelled`). */
+export class WorkflowTurnCancelled extends Error {
+    runId;
+    constructor(runId) {
+        super(`workflow run ${runId} cancelled`);
+        this.runId = runId;
+        this.name = 'WorkflowTurnCancelled';
+    }
+}
+/** Internal: stop the replay at the first unresolved blocking op (Python `_Suspend`). Never escapes. */
+class TurnSuspend extends Error {
+}
+/** Convert an arbitrary thrown value into the wire {@link StepError} (message + optional code + stack). */
+function toStepError(err) {
+    const e = err;
+    const out = { message: err instanceof Error ? err.message : String(err) };
+    if (typeof e?.code === 'string')
+        out.code = e.code;
+    if (err instanceof Error && typeof e.stack === 'string')
+        out.stack = e.stack;
+    return out;
+}
+function resolveBody(resolver, name) {
+    return typeof resolver === 'function' ? resolver(name) : resolver.get(name);
+}
+class TurnContext {
+    runId;
+    commands = [];
+    #history;
+    #signalsBySeq;
+    #partition;
+    #onStep;
+    #isCancelled;
+    #now;
+    #seq = 0;
+    constructor(runId, history, pendingSignals, opts) {
+        this.runId = runId;
+        this.#history = new Map(history.map((e) => [e.seq, e]));
+        this.#signalsBySeq = new Map((pendingSignals ?? []).map((s) => [s.seq, s]));
+        this.#partition = opts.partition;
+        this.#onStep = opts.onStep;
+        this.#isCancelled = opts.isCancelled;
+        this.#now = opts.now ?? Date.now;
+    }
+    /** Every durable op takes its seq from here — the single choke point where between-op cancellation
+     *  is enforced for the whole workflow API. */
+    #next() {
+        if (this.#isCancelled && this.runId !== undefined && this.#isCancelled(this.runId)) {
+            throw new WorkflowTurnCancelled(this.runId);
+        }
+        return this.#seq++;
+    }
+    /** The raw history entry at `seq` (or undefined), enforcing the kind/name nondeterminism guard. */
+    #replayEntry(seq, kind, name) {
+        const ev = this.#history.get(seq);
+        if (ev === undefined)
+            return undefined;
+        const nameMismatch = name !== undefined && ev.name !== undefined && ev.name !== name;
+        if (ev.kind !== kind || nameMismatch) {
+            throw new WorkflowNondeterminismError(`history at seq ${seq} is ${ev.kind}/${String(ev.name)}, but replay reached ${kind}/${String(name)}`);
+        }
+        return ev;
+    }
+    /** `[found, output]` for a resolved op in history; throws on a recorded failure (a catchable
+     *  {@link WorkflowStepFailedError}) so awaited failures surface exactly like a rejected await. */
+    #replay(seq, kind, name) {
+        const ev = this.#replayEntry(seq, kind, name);
+        if (ev === undefined)
+            return [false, undefined];
+        if (ev.error != null)
+            throw new WorkflowStepFailedError(ev.error);
+        return [true, ev.output];
+    }
+    #emitStep(event) {
+        if (!this.#onStep)
+            return;
+        try {
+            this.#onStep(event);
+        }
+        catch {
+            /* live-tail is best-effort observability — a broken sink must never fail the workflow */
+        }
+    }
+    step(name, input = undefined, opts = {}) {
+        const seq = this.#next();
+        const [found, output] = this.#replay(seq, 'call', name);
+        if (found)
+            return output;
+        const group = opts.group ?? this.#partition ?? '';
+        this.commands.push({ kind: 'call', seq, name, group, input });
+        throw new TurnSuspend();
+    }
+    sleep(ms) {
+        const seq = this.#next();
+        const [found] = this.#replay(seq, 'timer');
+        if (found)
+            return;
+        this.commands.push({ kind: 'sleep', seq, ms });
+        throw new TurnSuspend();
+    }
+    waitSignal(name) {
+        const seq = this.#next();
+        const [found, output] = this.#replay(seq, 'signal', name);
+        if (found)
+            return output;
+        const sig = this.#signalsBySeq.get(seq);
+        if (sig !== undefined)
+            return sig.payload;
+        this.commands.push({ kind: 'waitSignal', seq, signal: name });
+        throw new TurnSuspend();
+    }
+    startChild(workflow, input = undefined) {
+        const seq = this.#next();
+        const [found, output] = this.#replay(seq, 'child', workflow);
+        if (found)
+            return output;
+        this.commands.push({ kind: 'startChild', seq, workflow, input });
+        throw new TurnSuspend();
+    }
+    /** Collect outputs from a list of history entries in list order, throwing an aggregate
+     *  {@link WorkflowGatherFailedError} if any member resolved to a failure — the shared tail of both
+     *  gather ops (the TS twin of the Python `_aggregate`). `label` names the failing member in the
+     *  aggregate error (the step/child `name`). */
+    #aggregate(entries, label) {
+        const outputs = [];
+        const failures = [];
+        for (const ev of entries) {
+            if (ev !== undefined && ev.error != null) {
+                failures.push({ name: label(ev), error: ev.error });
+                outputs.push(undefined);
+            }
+            else {
+                outputs.push(ev?.output);
+            }
+        }
+        if (failures.length > 0)
+            throw new WorkflowGatherFailedError(failures);
+        return outputs;
+    }
+    gatherCalls(calls, opts = {}) {
+        // Empty fan: reserve no seqs and produce no side effects (degenerate identity) — matches Python.
+        if (calls.length === 0)
+            return [];
+        const mode = opts.mode ?? 'waitAll';
+        // Reserve the whole block in list order BEFORE any dispatch — replay re-derives identical seqs.
+        const seqs = calls.map(() => this.#next());
+        const firstSeq = seqs[0];
+        const parallelGroup = `gather:${firstSeq}`;
+        const entries = calls.map((c, i) => this.#replayEntry(seqs[i], 'call', c.name));
+        // failFast: bail the moment any ALREADY-resolved member is a failure (siblings are left in flight).
+        if (mode === 'failFast') {
+            for (let i = 0; i < entries.length; i += 1) {
+                const ev = entries[i];
+                if (ev !== undefined && ev.error != null) {
+                    throw new WorkflowGatherFailedError([
+                        { name: ev.name ?? calls[i].name, error: ev.error },
+                    ]);
+                }
+            }
+        }
+        // Dispatch every member not yet in history — all stamped with the shared fan group — then suspend
+        // ONCE. A member already resolved is skipped (no re-dispatch); a re-emit of a still-pending call is
+        // idempotent on the engine, so the turn re-suspends until EVERY member has resolved.
+        let pending = false;
+        for (let i = 0; i < calls.length; i += 1) {
+            if (entries[i] !== undefined)
+                continue;
+            const c = calls[i];
+            const group = c.group ?? this.#partition ?? '';
+            this.commands.push({
+                kind: 'call',
+                seq: seqs[i],
+                name: c.name,
+                group,
+                input: c.input,
+                parallelGroup,
+            });
+            pending = true;
+        }
+        if (pending)
+            throw new TurnSuspend();
+        // All resolved: outputs in INPUT order, aggregating any failures (waitAll).
+        return this.#aggregate(entries, (ev) => ev.name ?? '');
+    }
+    gatherChildren(workflow, inputs, opts = {}) {
+        if (inputs.length === 0)
+            return [];
+        const mode = opts.mode ?? 'waitAll';
+        const seqs = inputs.map(() => this.#next());
+        const firstSeq = seqs[0];
+        const parallelGroup = `gather:${firstSeq}`;
+        const entries = seqs.map((seq) => this.#replayEntry(seq, 'child', workflow));
+        if (mode === 'failFast') {
+            for (const ev of entries) {
+                if (ev !== undefined && ev.error != null) {
+                    throw new WorkflowGatherFailedError([{ name: workflow, error: ev.error }]);
+                }
+            }
+        }
+        let pending = false;
+        for (let i = 0; i < inputs.length; i += 1) {
+            if (entries[i] !== undefined)
+                continue;
+            this.commands.push({
+                kind: 'startChild',
+                seq: seqs[i],
+                workflow,
+                input: inputs[i],
+                parallelGroup,
+            });
+            pending = true;
+        }
+        if (pending)
+            throw new TurnSuspend();
+        return this.#aggregate(entries, () => workflow);
+    }
+    now() {
+        // The seq _localStep's own #next() is about to allocate — mirror the Python `now#<seq>` name.
+        return this.#localStep(`now#${this.#seq}`, () => this.#now());
+    }
+    sideEffect(fn) {
+        return this.#localStep('sideEffect', fn);
+    }
+    /** Run a LOCAL step once and record its result (a `recordStep` command), so a captured value happens
+     *  exactly once and replay returns it. Backs {@link now} and {@link sideEffect}. */
+    #localStep(name, body) {
+        const seq = this.#next();
+        const [found, output] = this.#replay(seq, 'step', name);
+        if (found)
+            return output;
+        const startedAt = this.#now();
+        this.#emitStep({ runId: this.runId ?? '', seq, name, phase: 'running', startedAt });
+        let result;
+        try {
+            result = body();
+        }
+        catch (err) {
+            const error = toStepError(err);
+            const finishedAt = this.#now();
+            this.commands.push({ kind: 'recordStep', seq, name, error, startedAt, finishedAt });
+            this.#emitStep({ runId: this.runId ?? '', seq, name, phase: 'failed', startedAt, finishedAt, error });
+            throw new WorkflowStepFailedError(error);
+        }
+        const finishedAt = this.#now();
+        this.commands.push({ kind: 'recordStep', seq, name, output: result, startedAt, finishedAt });
+        this.#emitStep({
+            runId: this.runId ?? '',
+            seq,
+            name,
+            phase: 'completed',
+            startedAt,
+            finishedAt,
+            output: result,
+        });
+        return result;
+    }
+}
+/**
+ * Replay one turn of `task`'s workflow against the registered `bodies` and return the wire
+ * {@link WorkflowDecision}. The shared core behind the store-less worker's workflow path AND the
+ * engine's in-process {@link import('./remote-workflow-executor.js').LocalWorkflowTurnExecutor} —
+ * transport-free and store-free, so it is testable with a plain task object.
+ *
+ * Outcomes (byte-compatible with aviary / the Python `process_workflow_task`):
+ * - body returns → `completed` (with `output` + any `recordStep` commands run this turn);
+ * - {@link TurnSuspend} (first unresolved blocking op) → `continue` (with the blocking `commands`);
+ * - {@link WorkflowTurnCancelled} → `cancelled` (partial `commands` that DID run this turn);
+ * - {@link WorkflowStepFailedError} → `failed` with that step's error;
+ * - any other throw → `failed` with the converted error;
+ * - no registered body → `failed` `{ code: 'no_workflow' }`.
+ */
+export async function runWorkflowTurn(bodies, task, opts = {}) {
+    const base = { taskId: task.taskId, runId: task.runId };
+    const body = resolveBody(bodies, task.workflow);
+    if (body === undefined) {
+        return {
+            ...base,
+            status: 'failed',
+            commands: [],
+            error: { message: `no workflow registered for '${task.workflow}'`, code: 'no_workflow' },
+        };
+    }
+    const ctx = new TurnContext(task.runId, task.history, task.pendingSignals, opts);
+    try {
+        const output = await body(ctx, task.input);
+        return { ...base, status: 'completed', commands: ctx.commands, output };
+    }
+    catch (err) {
+        if (err instanceof TurnSuspend) {
+            return { ...base, status: 'continue', commands: ctx.commands };
+        }
+        if (err instanceof WorkflowTurnCancelled) {
+            return { ...base, status: 'cancelled', commands: ctx.commands };
+        }
+        if (err instanceof WorkflowStepFailedError) {
+            return { ...base, status: 'failed', commands: ctx.commands, error: err.error };
+        }
+        return { ...base, status: 'failed', commands: ctx.commands, error: toStepError(err) };
+    }
+}
+/**
+ * True when `task` is a WORKFLOW turn (vs a step task) — discriminated BY SHAPE (spec §6.3), byte-for-
+ * byte with the Python `is_workflow_task` (`runner-core.ts`): a workflow task carries a string
+ * `workflow` name AND a `history` array. Both ride the SAME `${P}-tasks-<token>` queue, so a unified
+ * consumer routes turns through the replay body and steps through `runStepHandler` on this predicate.
+ */
+export function isWorkflowTask(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const t = data;
+    return typeof t.workflow === 'string' && Array.isArray(t.history);
+}
+//# sourceMappingURL=workflow-turn.js.map

package/dist/src/workflow-turn.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/durable",
-  "version": "0.9.1",
+  "version": "0.11.0",
   "description": "Durable cross-app workflows for AdonisJS — deterministic replay engine, AdonisJS binding, ace commands, dashboard, OpenTelemetry, Telescope, testing harness and Redis admission, all in one package. Part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -23,6 +23,11 @@
       "import": "./dist/src/services/main.js",
       "default": "./dist/src/services/main.js"
     },
+    "./worker": {
+      "types": "./dist/src/worker-runtime/index.d.ts",
+      "import": "./dist/src/worker-runtime/index.js",
+      "default": "./dist/src/worker-runtime/index.js"
+    },
     "./durable_provider": {
       "types": "./dist/providers/durable_provider.d.ts",
       "import": "./dist/providers/durable_provider.js",
@@ -101,6 +106,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
+    "bullmq": "^5.0.0",
     "zod": "^3.23.0"
   },
   "peerDependencies": {