@adonis-agora/durable 0.47.0 → 0.49.0

package/dist/src/metrics.js

@@ -6,7 +6,8 @@
  */
 export function collectMetrics(engine) {
     const m = {
-        runs: { started: 0, completed: 0, failed: 0, suspended: 0 },
+        runs: { started: 0, completed: 0, failed: 0, suspended: 0, routed: 0, unrouted: 0 },
+        routedByCode: {},
         steps: { started: 0, completed: 0, failed: 0 },
         byWorkflow: {},
         stepDuration: { sumMs: 0, count: 0 },
@@ -37,6 +38,15 @@ export function collectMetrics(engine) {
             case 'run.suspended':
                 m.runs.suspended += 1;
                 break;
+            case 'run.routed': {
+                m.runs.routed += 1;
+                const code = e.error?.code ?? '*';
+                m.routedByCode[code] = (m.routedByCode[code] ?? 0) + 1;
+                break;
+            }
+            case 'run.unrouted':
+                m.runs.unrouted += 1;
+                break;
             case 'step.started':
                 m.steps.started += 1;
                 break;
@@ -67,6 +77,9 @@ export function collectMetrics(engine) {
             for (const [name, v] of Object.entries(m.byWorkflow))
                 for (const [event, n] of Object.entries(v))
                     lines.push(`durable_runs_by_workflow_total{workflow="${name}",event="${event}"} ${n}`);
+            lines.push('# TYPE durable_runs_routed_total counter');
+            for (const [code, n] of Object.entries(m.routedByCode))
+                lines.push(`durable_runs_routed_total{code="${code}"} ${n}`);
             lines.push('# TYPE durable_step_duration_ms_sum counter');
             lines.push(`durable_step_duration_ms_sum ${m.stepDuration.sumMs}`);
             lines.push('# TYPE durable_step_duration_count counter');

package/dist/src/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,CAAC,GAAoB;QACzB,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;QAC3D,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAC9C,UAAU,EAAE,EAAE;QACd,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;KACrC,CAAC;IACF,MAAM,EAAE,GAAG,CAAC,IAAa,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,IAAI,IAAI,SAAS,CAAC;QAC5B,IAAI,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAChD,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;QAClC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,aAAa;gBAChB,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;gBACpB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,eAAe;gBAClB,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;gBACtB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,YAAY;gBACf,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;gBACnB,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;gBAC3B,MAAM;YACR,KAAK,eAAe;gBAClB,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;gBACtB,MAAM;YACR,KAAK,cAAc;gBACjB,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;gBACrB,MAAM;YACR,KAAK,gBAAgB;gBACnB,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;gBACvB,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;oBACzB,CAAC,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,CAAC;oBACrC,CAAC,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC;gBAC5B,CAAC;gBACD,MAAM;YACR,KAAK,aAAa;gBAChB,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;gBACpB,MAAM;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;QAClC,IAAI;QACJ,UAAU,EAAE,GAAG,EAAE;YACf,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YAChD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YACjD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAC5D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;gBAClD,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC,4CAA4C,IAAI,YAAY,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3F,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;YAClE,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"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"}

package/dist/src/on-error.d.ts

@@ -0,0 +1,59 @@
+import type { StepError } from './interfaces.js';
+/**
+ * Routes a failed run to a handler workflow instead of failing it: when a run of the workflow ends
+ * `failed` with an error whose `code` matches (or with any error, for the route without a `code`), the
+ * engine starts `workflow` with an {@link OnErrorInput} and the failed run waits for it. The run then
+ * settles with the handler's outcome: its output on success, its error on failure.
+ */
+export interface OnErrorRoute {
+    /** The error `code` to route. Omitted: routes any failure no other route's `code` matches. */
+    code?: string | undefined;
+    /** The registered handler workflow's name. */
+    workflow: string;
+}
+/** The input an {@link OnErrorRoute} handler workflow is started with. */
+export interface OnErrorInput<TInput = unknown> {
+    /** The run that failed; it completes with this handler's output. */
+    runId: string;
+    /** The failed run's workflow. */
+    workflow: string;
+    /** The failed run's input. */
+    input: TInput;
+    /** The failure, as the run recorded it. */
+    error: StepError;
+}
+/**
+ * Handoff checkpoints live at seqs from here up, one per handoff, so a body that runs again after a
+ * retry can never reach one. Fits a 32-bit `seq` column.
+ */
+export declare const HANDOFF_SEQ_BASE = 1000000000;
+/** The id of the handler run of a run's `attempt`-th handoff. */
+export declare const onErrorRunId: (runId: string, attempt: number) => string;
+/** The waiter checkpoint a run waits on its handler under; renamed {@link retiredHandoffName} on retry. */
+export declare const handoffName: (handlerId: string) => string;
+/** What a retry renames a handoff checkpoint to: kept in the timeline, never followed again. */
+export declare const retiredHandoffName: (handlerId: string) => string;
+/** The handler run id a live handoff checkpoint of `runId` names, or undefined for any other one. */
+export declare function handoffHandlerId(runId: string, cp: {
+    seq: number;
+    name: string;
+}): string | undefined;
+/** The run's live handoff (its latest, unretired one), if it handed a failure off. */
+export declare function liveHandoff<C extends {
+    seq: number;
+    name: string;
+}>(runId: string, checkpoints: readonly C[]): C | undefined;
+/** The route a failure takes: the one for its exact code, else the catch-all, else none. */
+export declare function routeFor(routes: OnErrorRoute[] | undefined, error: StepError): OnErrorRoute | undefined;
+/** Reject two routes for one code, or two catch-alls — ambiguous config, caught at registration. */
+export declare function assertRoutes(workflow: string, routes: OnErrorRoute[]): void;
+/** The `code` carried by a thrown value: its own, a dispatched step's, or a thin-worker step's. */
+export declare function codeOf(err: unknown): string | undefined;
+/** The `details` carried by a thrown value, from the same places as {@link codeOf}. */
+export declare function detailsOf(err: unknown): unknown;
+/** `code` and `details` as optional keys, so an absent one is not written as `undefined`. */
+export declare function codeAndDetails(err: unknown): {
+    code?: string;
+    details?: unknown;
+};
+//# sourceMappingURL=on-error.d.ts.map

package/dist/src/on-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-error.d.ts","sourceRoot":"","sources":["../../src/on-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,SAAS,CAAC;CAClB;AAQD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAAgB,CAAC;AAE9C,iEAAiE;AACjE,eAAO,MAAM,YAAY,UAAW,MAAM,WAAW,MAAM,KAAG,MAC/B,CAAC;AAEhC,2GAA2G;AAC3G,eAAO,MAAM,WAAW,cAAe,MAAM,KAAG,MAAqC,CAAC;AAEtF,gGAAgG;AAChG,eAAO,MAAM,kBAAkB,cAAe,MAAM,KAAG,MAAwC,CAAC;AAEhG,qGAAqG;AACrG,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC,MAAM,GAAG,SAAS,CAKpB;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACjE,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,SAAS,CAAC,EAAE,GACxB,CAAC,GAAG,SAAS,CAMf;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CACtB,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,EAClC,KAAK,EAAE,SAAS,GACf,YAAY,GAAG,SAAS,CAM1B;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAY3E;AASD,mGAAmG;AACnG,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKvD;AAED,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAG/C;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAOjF"}

package/dist/src/on-error.js

@@ -0,0 +1,71 @@
+/**
+ * Codes of failures that mean the code or the deployment is broken, not that the work failed: routing
+ * them would turn a non-deterministic deploy or a misuse of the ctx into a completed run.
+ */
+const UNROUTABLE_CODES = new Set(['non_determinism', 'nested_workflow_call']);
+/**
+ * Handoff checkpoints live at seqs from here up, one per handoff, so a body that runs again after a
+ * retry can never reach one. Fits a 32-bit `seq` column.
+ */
+export const HANDOFF_SEQ_BASE = 1_000_000_000;
+/** The id of the handler run of a run's `attempt`-th handoff. */
+export const onErrorRunId = (runId, attempt) => `${runId}.onError.${attempt}`;
+/** The waiter checkpoint a run waits on its handler under; renamed {@link retiredHandoffName} on retry. */
+export const handoffName = (handlerId) => `signal:child:${handlerId}`;
+/** What a retry renames a handoff checkpoint to: kept in the timeline, never followed again. */
+export const retiredHandoffName = (handlerId) => `onError:retried:${handlerId}`;
+/** The handler run id a live handoff checkpoint of `runId` names, or undefined for any other one. */
+export function handoffHandlerId(runId, cp) {
+    const prefix = `signal:child:${runId}.onError.`;
+    return cp.seq >= HANDOFF_SEQ_BASE && cp.name.startsWith(prefix)
+        ? cp.name.slice('signal:child:'.length)
+        : undefined;
+}
+/** The run's live handoff (its latest, unretired one), if it handed a failure off. */
+export function liveHandoff(runId, checkpoints) {
+    let live;
+    for (const cp of checkpoints) {
+        if (handoffHandlerId(runId, cp) !== undefined && (!live || cp.seq > live.seq))
+            live = cp;
+    }
+    return live;
+}
+/** The route a failure takes: the one for its exact code, else the catch-all, else none. */
+export function routeFor(routes, error) {
+    if (!routes?.length || (error.code && UNROUTABLE_CODES.has(error.code)))
+        return undefined;
+    return ((error.code ? routes.find((r) => r.code === error.code) : undefined) ??
+        routes.find((r) => r.code === undefined));
+}
+/** Reject two routes for one code, or two catch-alls — ambiguous config, caught at registration. */
+export function assertRoutes(workflow, routes) {
+    const seen = new Set();
+    for (const r of routes) {
+        if (seen.has(r.code)) {
+            throw new Error(r.code === undefined
+                ? `workflow ${workflow}: more than one onError route without a code`
+                : `workflow ${workflow}: more than one onError route for code "${r.code}"`);
+        }
+        seen.add(r.code);
+    }
+}
+/** The `code` carried by a thrown value: its own, a dispatched step's, or a thin-worker step's. */
+export function codeOf(err) {
+    const e = err;
+    return [e?.code, e?.stepError?.code, e?.error?.code].find((c) => typeof c === 'string');
+}
+/** The `details` carried by a thrown value, from the same places as {@link codeOf}. */
+export function detailsOf(err) {
+    const e = err;
+    return e?.details ?? e?.stepError?.details ?? e?.error?.details;
+}
+/** `code` and `details` as optional keys, so an absent one is not written as `undefined`. */
+export function codeAndDetails(err) {
+    const code = codeOf(err);
+    const details = detailsOf(err);
+    return {
+        ...(code !== undefined ? { code } : {}),
+        ...(details !== undefined ? { details } : {}),
+    };
+}
+//# sourceMappingURL=on-error.js.map

package/dist/src/on-error.js.map

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

package/dist/src/otel/durable-metrics.d.ts

@@ -12,7 +12,13 @@ export interface DurableMetricsSnapshot {
         completed: number;
         failed: number;
         suspended: number;
+        /** Failures handed to an onError handler instead of failing the run. */
+        routed: number;
+        /** Failures that had onError routes the engine could not apply (workers disagree). */
+        unrouted: number;
     };
+    /** Routed failures by error code (`*` for a failure without one). */
+    routedByCode: Record<string, number>;
     steps: {
         completed: number;
         failed: number;

package/dist/src/otel/durable-metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable-metrics.d.ts","sourceRoot":"","sources":["../../../src/otel/durable-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,kEAAkE;IAClE,cAAc,EAAE,aAAa,CAAC;IAC9B,6DAA6D;IAC7D,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,QAAQ,IAAI,sBAAsB,CAAC;IACnC,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAC;IACd,uBAAuB;IACvB,WAAW,IAAI,IAAI,CAAC;CACrB;AAUD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA2D3E"}
+{"version":3,"file":"durable-metrics.d.ts","sourceRoot":"","sources":["../../../src/otel/durable-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,wEAAwE;QACxE,MAAM,EAAE,MAAM,CAAC;QACf,sFAAsF;QACtF,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,kEAAkE;IAClE,cAAc,EAAE,aAAa,CAAC;IAC9B,6DAA6D;IAC7D,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,QAAQ,IAAI,sBAAsB,CAAC;IACnC,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAC;IACd,uBAAuB;IACvB,WAAW,IAAI,IAAI,CAAC;CACrB;AAUD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA+E3E"}

package/dist/src/otel/durable-metrics.js

@@ -14,7 +14,16 @@ function stats(xs) {
  * its own.
  */
 export function attachDurableMetrics(engine) {
-    let runs = { started: 0, completed: 0, failed: 0, suspended: 0 };
+    const zeroRuns = () => ({
+        started: 0,
+        completed: 0,
+        failed: 0,
+        suspended: 0,
+        routed: 0,
+        unrouted: 0,
+    });
+    let runs = zeroRuns();
+    let routedByCode = {};
     let steps = { completed: 0, failed: 0 };
     let stepDur = [];
     let runDur = [];
@@ -43,6 +52,15 @@ export function attachDurableMetrics(engine) {
             case 'run.suspended':
                 runs.suspended += 1;
                 break;
+            case 'run.routed': {
+                runs.routed += 1;
+                const code = e.error?.code ?? '*';
+                routedByCode[code] = (routedByCode[code] ?? 0) + 1;
+                break;
+            }
+            case 'run.unrouted':
+                runs.unrouted += 1;
+                break;
             case 'step.completed':
                 steps.completed += 1;
                 if (e.durationMs != null)
@@ -58,12 +76,14 @@ export function attachDurableMetrics(engine) {
     return {
         snapshot: () => ({
             runs: { ...runs },
+            routedByCode: { ...routedByCode },
             steps: { ...steps },
             stepDurationMs: stats(stepDur),
             runDurationMs: stats(runDur),
         }),
         reset: () => {
-            runs = { started: 0, completed: 0, failed: 0, suspended: 0 };
+            runs = zeroRuns();
+            routedByCode = {};
             steps = { completed: 0, failed: 0 };
             stepDur = [];
             runDur = [];

package/dist/src/otel/durable-metrics.js.map

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

package/dist/src/otel/durable-otel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable-otel.d.ts","sourceRoot":"","sources":["../../../src/otel/durable-otel.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,IAAI,CAwFZ"}
+{"version":3,"file":"durable-otel.d.ts","sourceRoot":"","sources":["../../../src/otel/durable-otel.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,IAAI,CA+GZ"}

package/dist/src/otel/durable-otel.js

@@ -57,6 +57,21 @@ export function attachDurableOtel(engine, options = {}) {
                 span.end(event.at);
                 break;
             }
+            // Both are emitted while the run's span is still open: the handoff before the run suspends on its
+            // handler, the unrouted failure before the run fails.
+            case 'run.routed':
+                roots.get(event.runId)?.addEvent('durable.run.routed', {
+                    'durable.on_error.handler': event.name,
+                    'durable.error.code': event.error?.code,
+                    'durable.error.message': event.error?.message,
+                }, event.at);
+                break;
+            case 'run.unrouted':
+                roots.get(event.runId)?.addEvent('durable.run.unrouted', {
+                    'durable.on_error.reason': event.reason,
+                    'durable.error.code': event.error?.code,
+                }, event.at);
+                break;
             case 'run.completed':
                 endRoot(event);
                 break;

package/dist/src/otel/durable-otel.js.map

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

package/dist/src/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAa,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiChG;oGACoG;AACpG,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;6FAC6F;AAC7F,eAAO,MAAM,eAAe,UAAW,MAAM,OAAO,MAAM,KAAG,MAA8B,CAAC;AAE5F;kGACkG;AAClG,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE1F;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnD,OAAO,CAAC,UAAU,CAAC,CA+DrB"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAa,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiChG;oGACoG;AACpG,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;6FAC6F;AAC7F,eAAO,MAAM,eAAe,UAAW,MAAM,OAAO,MAAM,KAAG,MAA8B,CAAC;AAE5F;kGACkG;AAClG,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE1F;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnD,OAAO,CAAC,UAAU,CAAC,CAgErB"}

package/dist/src/protocol.js

@@ -93,6 +93,7 @@ export async function runStepHandler(task, handler, emitBeat) {
                 error: {
                     message: err instanceof Error ? err.message : String(err),
                     ...(typeof e?.code === 'string' ? { code: e.code } : {}),
+                    ...(e?.details !== undefined ? { details: e.details } : {}),
                     ...(typeof e?.retryable === 'boolean' ? { retryable: e.retryable } : {}),
                 },
             });

package/dist/src/protocol.js.map

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

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

@@ -0,0 +1,98 @@
+import type { StepCheckpoint, 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
+ * carries every member — megabytes of JSON, and one rendered row (or fetched child) per member.
+ */
+export interface FanSummary {
+    /** The fan's `parallelGroup`. */
+    group: string;
+    /** The members' common step name, or `child runs` for a fan of child workflows. */
+    label: string;
+    firstSeq: number;
+    lastSeq: number;
+    /** Members started so far: steps, or child runs (a folded checkpoint counts as the children it stands for). */
+    size: number;
+    /**
+     * The fan's declared size, when its group carries it. More than `size` while waves are still to
+     * be sent (`concurrency`), and for good when a failFast fan stopped early.
+     */
+    total?: number | undefined;
+    /** `total - size`: members never started yet — or never to start, once the run has finished. */
+    notStarted?: number | undefined;
+    /** The fan stops at its first failure. */
+    failFast: boolean;
+    /** Members by status. A child that failed counts as `failed`, though its checkpoint is `completed`. */
+    counts: Partial<Record<StepCheckpoint['status'], number>>;
+    startedAt?: Date | undefined;
+    finishedAt?: Date | undefined;
+    /** The first {@link FAN_SUMMARY_FAILURES} failed members, so a failure shows without paging. */
+    failures: StepCheckpoint[];
+}
+/** A page of one fan's members, in seq order. */
+export interface FanPage {
+    items: StepCheckpoint[];
+    /** Members matching the query, across all pages. */
+    total: number;
+}
+export interface FanPageQuery {
+    offset?: number | undefined;
+    limit?: number | undefined;
+    /** Only failed members (a failed step, or a child that failed). */
+    failedOnly?: boolean | 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;
+/** 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). */
+export declare function summarizeFan(group: string, members: StepCheckpoint[]): FanSummary;
+/**
+ * Split a run's timeline into the checkpoints a detail view lists one by one and the fans it draws as
+ * one node each: every `parallelGroup` with more than `over` members, or declared wider than that,
+ * becomes a {@link FanSummary}, and its members leave the timeline. Smaller groups and ungrouped
+ * steps stay as they are.
+ */
+export declare function summarizeTimeline(timeline: StepCheckpoint[], over: number): {
+    timeline: StepCheckpoint[];
+    fans: FanSummary[];
+};
+/** 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 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`
+ * and drawn from {@link fans} instead, and `children` lists only the first {@link SUMMARY_CHILD_LIMIT}.
+ */
+export interface RunDetail {
+    run: WorkflowRun;
+    /** Steps in execution order, less the members of a summarized fan. */
+    timeline: StepCheckpoint[];
+    /** Ids of runs this run spawned. Capped when summarized — see {@link childCount}. */
+    children: string[];
+    /** The fans drawn as one node each, when the detail was asked to summarize them. */
+    fans?: FanSummary[] | undefined;
+    /** How many children the run has, when `children` lists only the first of them. */
+    childCount?: number | undefined;
+}
+/** How to shape a {@link RunDetail}. */
+export interface RunDetailOptions {
+    /**
+     * Summarize every fan with more than this many members into a {@link FanSummary} instead of
+     * listing them, and cap `children`. Unset returns the full timeline. A view of a run with a wide
+     * fan should set it: the full detail of a 40k-member fan is megabytes.
+     */
+    summarizeFansOver?: number | undefined;
+}
+/** The reads a {@link RunDetail} is built from — an engine, a dashboard port, or a gateway. */
+export interface RunDetailSource {
+    getRun(runId: string): Promise<WorkflowRun | null>;
+    listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
+    getRunChildren(runId: string): Promise<string[]>;
+}
+/** 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>;
+//# sourceMappingURL=run-detail-summary.d.ts.map

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

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

package/dist/src/run-detail-summary.js

@@ -0,0 +1,150 @@
+import { childIdsOf, FOLDED_PREFIX, parseFanGroup } from './fan-join.js';
+export const FAN_SUMMARY_FAILURES = 20;
+/** The most children a summarized detail lists by id; `childCount` carries the rest. */
+export const SUMMARY_CHILD_LIMIT = 200;
+const FAN_PAGE_MAX = 500;
+function foldedCount(cp) {
+    if (!cp.name.startsWith(FOLDED_PREFIX))
+        return undefined;
+    const values = cp.output?.values;
+    return Array.isArray(values) ? values.length : 0;
+}
+/** A failed member: a failed step, or a child whose completion reports `ok: false`. */
+export function isFailedMember(cp) {
+    if (cp.status === 'failed')
+        return true;
+    if (!cp.name.startsWith('signal:child:') || cp.status !== 'completed')
+        return false;
+    return cp.output?.ok === false;
+}
+function fanLabel(members) {
+    if (members.some((cp) => cp.name.startsWith('signal:child:') || foldedCount(cp) !== undefined)) {
+        return 'child runs';
+    }
+    const first = members[0]?.name ?? '';
+    return members.every((cp) => cp.name === first) ? first : 'steps';
+}
+/** Summarize one fan's members (in seq order). */
+export function summarizeFan(group, members) {
+    const counts = {};
+    const failures = [];
+    let size = 0;
+    let startedAt;
+    let finishedAt;
+    let firstSeq = Number.POSITIVE_INFINITY;
+    let lastSeq = Number.NEGATIVE_INFINITY;
+    for (const cp of members) {
+        firstSeq = Math.min(firstSeq, cp.seq);
+        lastSeq = Math.max(lastSeq, cp.seq);
+        const folded = foldedCount(cp);
+        const n = folded ?? 1;
+        size += n;
+        const status = isFailedMember(cp) ? 'failed' : cp.status;
+        counts[status] = (counts[status] ?? 0) + n;
+        if (status === 'failed' && failures.length < FAN_SUMMARY_FAILURES)
+            failures.push(cp);
+        if (cp.status !== 'pending' && cp.status !== 'running') {
+            if (!startedAt || cp.startedAt < startedAt)
+                startedAt = cp.startedAt;
+            if (!finishedAt || cp.finishedAt > finishedAt)
+                finishedAt = cp.finishedAt;
+        }
+        else if (!startedAt || cp.enqueuedAt < startedAt) {
+            startedAt = cp.enqueuedAt;
+        }
+    }
+    const parsed = parseFanGroup(group);
+    const total = parsed?.size;
+    return {
+        group,
+        label: fanLabel(members),
+        firstSeq,
+        lastSeq,
+        size,
+        total,
+        notStarted: total === undefined ? undefined : Math.max(0, total - size),
+        failFast: parsed?.failFast ?? false,
+        counts,
+        startedAt,
+        finishedAt,
+        failures,
+    };
+}
+/**
+ * Split a run's timeline into the checkpoints a detail view lists one by one and the fans it draws as
+ * one node each: every `parallelGroup` with more than `over` members, or declared wider than that,
+ * becomes a {@link FanSummary}, and its members leave the timeline. Smaller groups and ungrouped
+ * steps stay as they are.
+ */
+export function summarizeTimeline(timeline, over) {
+    const byGroup = new Map();
+    for (const cp of timeline) {
+        if (cp.parallelGroup === undefined)
+            continue;
+        const members = byGroup.get(cp.parallelGroup);
+        if (members)
+            members.push(cp);
+        else
+            byGroup.set(cp.parallelGroup, [cp]);
+    }
+    const summarized = new Set();
+    const fans = [];
+    for (const [group, members] of byGroup) {
+        // A fan sent in small waves has few rows yet; its declared size is what makes it wide.
+        if (members.length <= over && (parseFanGroup(group)?.size ?? 0) <= over)
+            continue;
+        summarized.add(group);
+        fans.push(summarizeFan(group, members));
+    }
+    if (fans.length === 0)
+        return { timeline, fans };
+    return {
+        timeline: timeline.filter((cp) => cp.parallelGroup === undefined || !summarized.has(cp.parallelGroup)),
+        fans: fans.sort((a, b) => a.firstSeq - b.firstSeq),
+    };
+}
+/** One page of a fan's members out of a run's timeline. */
+export function pageFan(timeline, group, query) {
+    const matching = timeline.filter((cp) => cp.parallelGroup === group && (!query.failedOnly || isFailedMember(cp)));
+    const offset = query.offset !== undefined && Number.isFinite(query.offset)
+        ? Math.max(0, Math.floor(query.offset))
+        : 0;
+    const limit = query.limit !== undefined && Number.isFinite(query.limit)
+        ? Math.min(FAN_PAGE_MAX, Math.max(1, Math.floor(query.limit)))
+        : 100;
+    return { items: matching.slice(offset, offset + limit), total: matching.length };
+}
+/** Read `runId`'s {@link RunDetail}, summarized per `options`, or null for an unknown run. */
+export async function loadRunDetail(source, runId, options) {
+    const run = await source.getRun(runId);
+    if (!run)
+        return null;
+    const over = options?.summarizeFansOver;
+    if (over === undefined) {
+        const [timeline, children] = await Promise.all([
+            source.listCheckpoints(runId),
+            source.getRunChildren(runId),
+        ]);
+        return { run, timeline, children };
+    }
+    // Summarized: the children come from the timeline already loaded, rather than a second read of
+    // every child-edge checkpoint (one per child of a wide fan). A child whose waiter is written but
+    // whose placeholder checkpoint is not yet is missing for that one read; the next one lists it.
+    const full = await source.listCheckpoints(runId);
+    const { timeline, fans } = summarizeTimeline(full, over);
+    const ids = [...new Set(childIdsOf(full))];
+    return {
+        run,
+        timeline,
+        children: ids.slice(0, SUMMARY_CHILD_LIMIT),
+        fans,
+        childCount: ids.length,
+    };
+}
+/** One page of `runId`'s fan `group`, or null for an unknown run. */
+export async function loadFanMembers(source, runId, group, query) {
+    if (!(await source.getRun(runId)))
+        return null;
+    return pageFan(await source.listCheckpoints(runId), group, query);
+}
+//# sourceMappingURL=run-detail-summary.js.map