@adonis-agora/durable 0.9.1 → 0.11.0

package/dist/src/dashboard/compat.d.ts

@@ -0,0 +1,76 @@
+import type { WorkerDescriptor } from '../handshake/descriptor.js';
+import type { WorkflowRun } from '../interfaces.js';
+import type { RecordedBlock } from './diagnostics-recorder.js';
+import { type ApiResponse } from './handlers.js';
+/**
+ * The data source the {@link compat} health/compat handler reads (design §10). Deliberately a thin,
+ * framework-light port so the handler is unit-testable with fakes:
+ *
+ * - `controlPlaneDescriptor()` — the control plane's own handshake descriptor, negotiated against each
+ *   worker; `undefined` when nothing has advertised yet (the handler falls back to a current-protocol CP);
+ * - `fleet()` — worker descriptors grouped by routing token: the LIVE green fleet enumerated off the
+ *   transport ({@link enumerateLiveFleet}, so every advertising pod shows — compatible or not, blocked or
+ *   not), merged with the descriptors {@link BlockedDiagnosticsRecorder} reconstructed from past blocks;
+ * - `blockedRuns()` — the runs parked `blocked` (their human reason on `run.error.message`);
+ * - `diagnosticsFor(runId)` — the captured loud delta for a blocked run, when one was recorded.
+ *
+ * The SAME handler serves a store-less `tenant` pod: there `fleet()` is empty and `diagnosticsFor` returns
+ * nothing, so the panel still lists blocked runs (reason-only) round-tripped over the wire.
+ */
+export interface CompatSource {
+    controlPlaneDescriptor(): WorkerDescriptor | undefined;
+    fleet(): Array<{
+        token: string;
+        workers: WorkerDescriptor[];
+    }>;
+    blockedRuns(): Promise<WorkflowRun[]>;
+    diagnosticsFor(runId: string): RecordedBlock | undefined;
+}
+/** One routing token's live workers — the unit the compat panel negotiates per group. */
+export type FleetGroup = {
+    token: string;
+    workers: WorkerDescriptor[];
+};
+/**
+ * The OPTIONAL transport capability the dashboard uses to enumerate the LIVE green fleet (design §7.2/§10) —
+ * every worker currently advertising a descriptor, whether or not it has ever triggered a blocked dispatch.
+ * Both methods are optional on the full `Transport` (only broker transports — e.g. bullmq — carry them), so
+ * a transport that offers neither degrades the panel to the diagnostics-only view. Mirrors the engine's own
+ * `listWorkerGroups`/`listWorkerDescriptors` narrowing.
+ */
+export interface FleetTransport {
+    listWorkerGroups?(): Promise<string[]>;
+    listWorkerDescriptors?(token: string): Promise<WorkerDescriptor[]>;
+}
+/**
+ * Enumerate the LIVE fleet across ALL routing tokens: SCAN the heartbeat keyspace for distinct tokens
+ * (`listWorkerGroups`), then read each token's advertised descriptors (`listWorkerDescriptors`). This is
+ * what surfaces an incompatible worker that has NEVER blocked a dispatch — the diagnostics recorder only
+ * knows workers a past block captured, but a green-fleet enumeration sees every live pod (compatible +
+ * incompatible), so the panel can negotiate and red-flag it proactively.
+ *
+ * Degrades to `[]` (never throws): a transport without the capability, an empty keyspace, or a scan error
+ * all read as "no live fleet", leaving the panel on its diagnostics-only view. A token whose workers are
+ * all legacy (no descriptor published) contributes nothing — legacy is assume-compatible (design §7.7).
+ */
+export declare function enumerateLiveFleet(transport: FleetTransport | null | undefined): Promise<FleetGroup[]>;
+/**
+ * Union several fleet snapshots into one, keyed `token` → `instanceId`. Later sources WIN per instance, so
+ * pass the freshest last (the provider passes the captured diagnostics fleet first, the live enumeration
+ * last — a live descriptor supersedes a stale captured one, and a live-only worker with no prior block is
+ * added). The result is what {@link CompatSource.fleet} returns for negotiation.
+ */
+export declare function mergeFleets(...sources: FleetGroup[][]): FleetGroup[];
+/**
+ * `GET /compat` — the fleet health / protocol-compatibility panel (design §7.6, §10).
+ *
+ * Two sections, both LOUD and structured (never a bare boolean):
+ * 1. **Per queue/group/pod compatibility** — every live worker descriptor negotiated against the control
+ *    plane: its protocol version + the negotiated level, plus a red flag + the exact reason when
+ *    incompatible ("no common protocol major: local speaks [1, 1], remote speaks [2, 2]").
+ * 2. **Blocked runs** — runs parked because no worker can run them, each with its human reason and, when
+ *    captured, the `capability.unavailable` / `protocol.incompatible` diagnostics delta (missing
+ *    capabilities, the protocol ranges that failed to overlap).
+ */
+export declare function compat(src: CompatSource): Promise<ApiResponse>;
+//# sourceMappingURL=compat.d.ts.map

package/dist/src/dashboard/compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../../src/dashboard/compat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,KAAK,WAAW,EAAM,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB,IAAI,gBAAgB,GAAG,SAAS,CAAC;IACvD,KAAK,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/D,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC1D;AAED,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,qBAAqB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACpE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAC3C,OAAO,CAAC,UAAU,EAAE,CAAC,CAmBvB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,UAAU,EAAE,CAapE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAsEpE"}

package/dist/src/dashboard/compat.js

@@ -0,0 +1,130 @@
+import { controlPlaneDescriptor } from '../dispatch-routing.js';
+import { negotiate } from '../handshake/negotiate.js';
+import { ok } from './handlers.js';
+/**
+ * Enumerate the LIVE fleet across ALL routing tokens: SCAN the heartbeat keyspace for distinct tokens
+ * (`listWorkerGroups`), then read each token's advertised descriptors (`listWorkerDescriptors`). This is
+ * what surfaces an incompatible worker that has NEVER blocked a dispatch — the diagnostics recorder only
+ * knows workers a past block captured, but a green-fleet enumeration sees every live pod (compatible +
+ * incompatible), so the panel can negotiate and red-flag it proactively.
+ *
+ * Degrades to `[]` (never throws): a transport without the capability, an empty keyspace, or a scan error
+ * all read as "no live fleet", leaving the panel on its diagnostics-only view. A token whose workers are
+ * all legacy (no descriptor published) contributes nothing — legacy is assume-compatible (design §7.7).
+ */
+export async function enumerateLiveFleet(transport) {
+    if (!transport ||
+        typeof transport.listWorkerGroups !== 'function' ||
+        typeof transport.listWorkerDescriptors !== 'function') {
+        return [];
+    }
+    const groups = [];
+    try {
+        for (const token of await transport.listWorkerGroups()) {
+            const workers = await transport.listWorkerDescriptors(token);
+            if (workers.length > 0)
+                groups.push({ token, workers });
+        }
+    }
+    catch {
+        // A backend that can't SCAN/GET the descriptor keyspace degrades to whatever was read so far — the
+        // panel still renders (diagnostics + any partial live view) rather than 500-ing.
+    }
+    return groups;
+}
+/**
+ * Union several fleet snapshots into one, keyed `token` → `instanceId`. Later sources WIN per instance, so
+ * pass the freshest last (the provider passes the captured diagnostics fleet first, the live enumeration
+ * last — a live descriptor supersedes a stale captured one, and a live-only worker with no prior block is
+ * added). The result is what {@link CompatSource.fleet} returns for negotiation.
+ */
+export function mergeFleets(...sources) {
+    const byToken = new Map();
+    for (const source of sources) {
+        for (const { token, workers } of source) {
+            const perInstance = byToken.get(token) ?? new Map();
+            for (const worker of workers)
+                perInstance.set(worker.instanceId, worker);
+            byToken.set(token, perInstance);
+        }
+    }
+    return [...byToken].map(([token, perInstance]) => ({
+        token,
+        workers: [...perInstance.values()],
+    }));
+}
+/**
+ * `GET /compat` — the fleet health / protocol-compatibility panel (design §7.6, §10).
+ *
+ * Two sections, both LOUD and structured (never a bare boolean):
+ * 1. **Per queue/group/pod compatibility** — every live worker descriptor negotiated against the control
+ *    plane: its protocol version + the negotiated level, plus a red flag + the exact reason when
+ *    incompatible ("no common protocol major: local speaks [1, 1], remote speaks [2, 2]").
+ * 2. **Blocked runs** — runs parked because no worker can run them, each with its human reason and, when
+ *    captured, the `capability.unavailable` / `protocol.incompatible` diagnostics delta (missing
+ *    capabilities, the protocol ranges that failed to overlap).
+ */
+export async function compat(src) {
+    // Fall back to a current-protocol CP descriptor so pods can still be negotiated before the CP has
+    // advertised (or on a topology that never publishes one).
+    const cp = src.controlPlaneDescriptor() ?? controlPlaneDescriptor({ instanceId: 'control-plane' });
+    const groups = src.fleet().map(({ token, workers }) => {
+        const pods = workers.map((worker) => {
+            const result = negotiate(cp, worker);
+            return {
+                instanceId: worker.instanceId,
+                runtime: worker.runtime,
+                sdk: worker.sdk,
+                protocol: worker.protocol.version,
+                protocolRange: worker.protocol.range,
+                capabilities: worker.capabilities,
+                outcome: result.outcome,
+                negotiatedProtocol: result.negotiatedProtocol,
+                incompatible: result.outcome === 'incompatible',
+                // The red-flag reason: precise, structured copy for the panel (design §7.6). Absent when compatible.
+                reason: result.reason?.message,
+                missingOnRemote: result.capabilities.missingOnRemote,
+                missingOnLocal: result.capabilities.missingOnLocal,
+            };
+        });
+        return {
+            token,
+            pods,
+            incompatible: pods.some((pod) => pod.incompatible),
+            degraded: pods.some((pod) => pod.outcome === 'degraded'),
+        };
+    });
+    const blocked = (await src.blockedRuns()).map((run) => {
+        const recorded = src.diagnosticsFor(run.id);
+        return {
+            id: run.id,
+            workflow: run.workflow,
+            namespace: run.namespace,
+            status: run.status,
+            // Human reason: the persisted run error (always set when parked), or the captured delta's copy.
+            reason: run.error?.message ?? recorded?.reason ?? 'blocked',
+            code: recorded?.code,
+            requires: recorded?.diagnostics.requires ?? [],
+            // The structured delta (design §7.6), when a diagnostics event was captured for this run.
+            token: recorded?.diagnostics.token,
+            missingCapabilities: recorded?.diagnostics.missingCapabilities,
+            controlPlaneRange: recorded?.diagnostics.controlPlaneRange,
+            workerRanges: recorded?.diagnostics.workerRanges,
+            updatedAt: run.updatedAt.toISOString(),
+        };
+    });
+    const incompatibleCount = groups.reduce((n, group) => n + group.pods.filter((pod) => pod.incompatible).length, 0);
+    return ok({
+        controlPlane: {
+            instanceId: cp.instanceId,
+            protocol: cp.protocol.version,
+            protocolRange: cp.protocol.range,
+            capabilities: cp.capabilities,
+        },
+        groups,
+        blocked,
+        incompatibleCount,
+        blockedCount: blocked.length,
+    });
+}
+//# sourceMappingURL=compat.js.map

package/dist/src/dashboard/compat.js.map

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

package/dist/src/dashboard/diagnostics-recorder.d.ts

@@ -0,0 +1,59 @@
+import type { DispatchDiagnostics } from '../dispatch-routing.js';
+import type { WorkerDescriptor } from '../handshake/descriptor.js';
+import type { EngineEvent } from '../interfaces.js';
+/** The minimal engine surface the recorder subscribes to — a broad lifecycle-event stream. Both the
+ *  concrete `WorkflowEngine` and any `DurableEventSource` satisfy it. */
+export interface EngineEventSource {
+    subscribe(listener: (event: EngineEvent) => void): () => void;
+}
+/**
+ * A single captured LOUD diagnostics event (design §7.6) — the human reason plus the full structured
+ * delta + descriptors the engine attached when it parked a run `blocked`. Enough for the dashboard
+ * health panel to render exactly WHY nobody could run the work, never a bare boolean.
+ */
+export interface RecordedBlock {
+    /** Which failure fired — a missing capability vs. an unbridgeable protocol gap. */
+    code: 'capability.unavailable' | 'protocol.incompatible';
+    /** Human one-liner (the run's `error.message`, e.g. `blocked: no compatible worker (requires saga)`). */
+    reason: string;
+    /** The precise routing delta + both descriptors (`DispatchDiagnostics`). */
+    diagnostics: DispatchDiagnostics;
+    /** When the block fired (ISO). */
+    at: string;
+}
+/**
+ * Captures the engine's `capability.unavailable` / `protocol.incompatible` diagnostics events (design
+ * §7.6) into a bounded in-memory index the dashboard health panel reads (design §10, "fed by
+ * descriptors + diagnostics events"). Since the loud events carry BOTH descriptors + the precise delta,
+ * one subscription feeds the whole panel:
+ *
+ * - `diagnosticsFor(runId)` joins a `blocked` run to its captured delta (code, missing caps, ranges);
+ * - `fleet()` reconstructs the live-fleet compat view — the worker descriptors last seen per routing
+ *   token — so each pod can be re-negotiated against the control plane;
+ * - `controlPlaneDescriptor()` is the CP side the events were negotiated against.
+ *
+ * Bounded by an LRU-ish cap on the per-run map (oldest evicted) so a long-lived control plane never
+ * grows this without bound. Store-role only: a `tenant` pod owns no engine to subscribe to, so its
+ * panel shows `blocked` runs (reason from `run.error.message`) without the enriched delta.
+ */
+export declare class BlockedDiagnosticsRecorder {
+    #private;
+    constructor(opts?: {
+        max?: number;
+    });
+    /** Record one engine event; a no-op for anything but the two diagnostics types (or one missing its
+     *  `diagnostics` payload). Idempotent per `runId` — a re-block overwrites with the freshest delta. */
+    record(event: EngineEvent): void;
+    /** Subscribe to `source`'s lifecycle events; returns the unsubscribe fn (call it on shutdown). */
+    attach(source: EngineEventSource): () => void;
+    /** The captured delta for a `blocked` run, or `undefined` when none was recorded. */
+    diagnosticsFor(runId: string): RecordedBlock | undefined;
+    /** The control-plane descriptor the recorded events negotiated against, if any has been seen. */
+    controlPlaneDescriptor(): WorkerDescriptor | undefined;
+    /** The live-fleet compat view: worker descriptors last seen per routing token. */
+    fleet(): Array<{
+        token: string;
+        workers: WorkerDescriptor[];
+    }>;
+}
+//# sourceMappingURL=diagnostics-recorder.d.ts.map

package/dist/src/dashboard/diagnostics-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-recorder.d.ts","sourceRoot":"","sources":["../../../src/dashboard/diagnostics-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;yEACyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,IAAI,EAAE,wBAAwB,GAAG,uBAAuB,CAAC;IACzD,yGAAyG;IACzG,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,WAAW,EAAE,mBAAmB,CAAC;IACjC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,0BAA0B;;gBAOzB,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO;IAIvC;0GACsG;IACtG,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IA4BhC,kGAAkG;IAClG,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAI7C,qFAAqF;IACrF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIxD,iGAAiG;IACjG,sBAAsB,IAAI,gBAAgB,GAAG,SAAS;IAItD,kFAAkF;IAClF,KAAK,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;CAM/D"}

package/dist/src/dashboard/diagnostics-recorder.js

@@ -0,0 +1,75 @@
+/**
+ * Captures the engine's `capability.unavailable` / `protocol.incompatible` diagnostics events (design
+ * §7.6) into a bounded in-memory index the dashboard health panel reads (design §10, "fed by
+ * descriptors + diagnostics events"). Since the loud events carry BOTH descriptors + the precise delta,
+ * one subscription feeds the whole panel:
+ *
+ * - `diagnosticsFor(runId)` joins a `blocked` run to its captured delta (code, missing caps, ranges);
+ * - `fleet()` reconstructs the live-fleet compat view — the worker descriptors last seen per routing
+ *   token — so each pod can be re-negotiated against the control plane;
+ * - `controlPlaneDescriptor()` is the CP side the events were negotiated against.
+ *
+ * Bounded by an LRU-ish cap on the per-run map (oldest evicted) so a long-lived control plane never
+ * grows this without bound. Store-role only: a `tenant` pod owns no engine to subscribe to, so its
+ * panel shows `blocked` runs (reason from `run.error.message`) without the enriched delta.
+ */
+export class BlockedDiagnosticsRecorder {
+    #byRun = new Map();
+    /** token → (instanceId → latest descriptor). Latest-seen wins per instance. */
+    #fleet = new Map();
+    #controlPlane;
+    #max;
+    constructor(opts = {}) {
+        this.#max = opts.max ?? 500;
+    }
+    /** Record one engine event; a no-op for anything but the two diagnostics types (or one missing its
+     *  `diagnostics` payload). Idempotent per `runId` — a re-block overwrites with the freshest delta. */
+    record(event) {
+        if (event.type !== 'capability.unavailable' && event.type !== 'protocol.incompatible')
+            return;
+        const diagnostics = event.diagnostics;
+        if (!diagnostics)
+            return;
+        // Bound the per-run index: evict the oldest insertion when a NEW run would exceed the cap.
+        if (!this.#byRun.has(event.runId) && this.#byRun.size >= this.#max) {
+            const oldest = this.#byRun.keys().next().value;
+            if (oldest !== undefined)
+                this.#byRun.delete(oldest);
+        }
+        // Re-insert at the end (freshest) so eviction stays roughly insertion-ordered.
+        this.#byRun.delete(event.runId);
+        this.#byRun.set(event.runId, {
+            code: event.type,
+            // The engine stamps the human reason on `error.message` when it parks the run (design §7.6).
+            reason: event.error?.message ?? event.type,
+            diagnostics,
+            at: (event.at instanceof Date ? event.at : new Date(event.at)).toISOString(),
+        });
+        // Refresh the live-fleet snapshot for this token from the descriptors the event carried.
+        const perToken = this.#fleet.get(diagnostics.token) ?? new Map();
+        for (const worker of diagnostics.workers)
+            perToken.set(worker.instanceId, worker);
+        this.#fleet.set(diagnostics.token, perToken);
+        this.#controlPlane = diagnostics.controlPlane;
+    }
+    /** Subscribe to `source`'s lifecycle events; returns the unsubscribe fn (call it on shutdown). */
+    attach(source) {
+        return source.subscribe((event) => this.record(event));
+    }
+    /** The captured delta for a `blocked` run, or `undefined` when none was recorded. */
+    diagnosticsFor(runId) {
+        return this.#byRun.get(runId);
+    }
+    /** The control-plane descriptor the recorded events negotiated against, if any has been seen. */
+    controlPlaneDescriptor() {
+        return this.#controlPlane;
+    }
+    /** The live-fleet compat view: worker descriptors last seen per routing token. */
+    fleet() {
+        return [...this.#fleet].map(([token, byInstance]) => ({
+            token,
+            workers: [...byInstance.values()],
+        }));
+    }
+}
+//# sourceMappingURL=diagnostics-recorder.js.map

package/dist/src/dashboard/diagnostics-recorder.js.map

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

package/dist/src/dashboard/gateway-adapter.d.ts

@@ -0,0 +1,37 @@
+import type { RunGateway } from '../run-gateway/interface.js';
+import type { DashboardEngine } from './handlers.js';
+/**
+ * Adapt a {@link RunGateway} to the {@link DashboardEngine} port the JSON handlers drive, so a
+ * **store-less `tenant` pod** serves the SAME dashboard over the wire (design §8) — every read/control
+ * verb round-trips through the pod's `ProxyRunGateway` to the control plane, with NO local store or
+ * engine. Store presence stays invisible above the handler line.
+ *
+ * The gateway is a near-superset of the port; two verbs need bridging:
+ * - `listCheckpoints` → the gateway's `getCheckpoints` (same shape, §8 naming);
+ * - `requeue` → the gateway's `redispatchPending` (the operator recovery verb; the extra
+ *   `redispatched` count on the result is a harmless superset of `RunResult`).
+ *
+ * `getRunChildren` (parent→child fan-out) now rides the P4 read surface too (a `getRunChildren`
+ * `RunRequestKind` verb), so a store-less tenant pod's run detail view lists children round-tripped over
+ * the wire — the responder enforces the tenant-ownership check before answering (anti-IDOR).
+ */
+export declare function gatewayDashboardEngine(gateway: RunGateway): DashboardEngine;
+/** The minimal container surface {@link dashboardEngineForRole} resolves bindings through. */
+export interface DashboardContainer {
+    make(key: unknown): Promise<unknown>;
+}
+/**
+ * Resolve the dashboard's read/control port for the active durable `role` (design §5) — the single seam
+ * that makes the dashboard store-agnostic:
+ *
+ * - **`tenant`** (store-less): resolve the {@link DURABLE_RUN_GATEWAY} token (a `ProxyRunGateway`) and
+ *   adapt it — the engine binding is deliberately ABSENT on a tenant pod (structural isolation), so we
+ *   MUST NOT reach for `WorkflowEngine` here;
+ * - **store roles** (`standalone`/`control-plane`): resolve the concrete `WorkflowEngine` (structurally a
+ *   {@link DashboardEngine}) exactly as before — behavior byte-for-byte unchanged.
+ *
+ * `engineToken` is injected (rather than imported) so the module doesn't hard-depend on the engine class
+ * for the tenant path — the tenant branch never touches it.
+ */
+export declare function dashboardEngineForRole(role: 'standalone' | 'control-plane' | 'tenant', container: DashboardContainer, engineToken: unknown): Promise<DashboardEngine>;
+//# sourceMappingURL=gateway-adapter.d.ts.map

package/dist/src/dashboard/gateway-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-adapter.d.ts","sourceRoot":"","sources":["../../../src/dashboard/gateway-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CAW3E;AAED,8FAA8F;AAC9F,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,QAAQ,EAC/C,SAAS,EAAE,kBAAkB,EAC7B,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,eAAe,CAAC,CAM1B"}

package/dist/src/dashboard/gateway-adapter.js

@@ -0,0 +1,49 @@
+import { DURABLE_RUN_GATEWAY } from '../role_bindings.js';
+/**
+ * Adapt a {@link RunGateway} to the {@link DashboardEngine} port the JSON handlers drive, so a
+ * **store-less `tenant` pod** serves the SAME dashboard over the wire (design §8) — every read/control
+ * verb round-trips through the pod's `ProxyRunGateway` to the control plane, with NO local store or
+ * engine. Store presence stays invisible above the handler line.
+ *
+ * The gateway is a near-superset of the port; two verbs need bridging:
+ * - `listCheckpoints` → the gateway's `getCheckpoints` (same shape, §8 naming);
+ * - `requeue` → the gateway's `redispatchPending` (the operator recovery verb; the extra
+ *   `redispatched` count on the result is a harmless superset of `RunResult`).
+ *
+ * `getRunChildren` (parent→child fan-out) now rides the P4 read surface too (a `getRunChildren`
+ * `RunRequestKind` verb), so a store-less tenant pod's run detail view lists children round-tripped over
+ * the wire — the responder enforces the tenant-ownership check before answering (anti-IDOR).
+ */
+export function gatewayDashboardEngine(gateway) {
+    return {
+        getRun: (runId) => gateway.getRun(runId),
+        listRuns: (query) => gateway.listRuns(query),
+        listCheckpoints: (runId) => gateway.getCheckpoints(runId),
+        getRunChildren: (runId) => gateway.getRunChildren(runId),
+        requeue: (runId) => gateway.redispatchPending(runId),
+        redispatchPending: (runId) => gateway.redispatchPending(runId),
+        cancel: (runId, opts) => gateway.cancel(runId, opts),
+        workerHealth: () => gateway.workerHealth(),
+    };
+}
+/**
+ * Resolve the dashboard's read/control port for the active durable `role` (design §5) — the single seam
+ * that makes the dashboard store-agnostic:
+ *
+ * - **`tenant`** (store-less): resolve the {@link DURABLE_RUN_GATEWAY} token (a `ProxyRunGateway`) and
+ *   adapt it — the engine binding is deliberately ABSENT on a tenant pod (structural isolation), so we
+ *   MUST NOT reach for `WorkflowEngine` here;
+ * - **store roles** (`standalone`/`control-plane`): resolve the concrete `WorkflowEngine` (structurally a
+ *   {@link DashboardEngine}) exactly as before — behavior byte-for-byte unchanged.
+ *
+ * `engineToken` is injected (rather than imported) so the module doesn't hard-depend on the engine class
+ * for the tenant path — the tenant branch never touches it.
+ */
+export async function dashboardEngineForRole(role, container, engineToken) {
+    if (role === 'tenant') {
+        const gateway = (await container.make(DURABLE_RUN_GATEWAY));
+        return gatewayDashboardEngine(gateway);
+    }
+    return (await container.make(engineToken));
+}
+//# sourceMappingURL=gateway-adapter.js.map

package/dist/src/dashboard/gateway-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-adapter.js","sourceRoot":"","sources":["../../../src/dashboard/gateway-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAmB;IACxD,OAAO;QACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC5C,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC;QACzD,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC;QACxD,OAAO,EAAE,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC;QAC/E,iBAAiB,EAAE,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC;QACzF,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;QACpD,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE;KAC3C,CAAC;AACJ,CAAC;AAOD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAA+C,EAC/C,SAA6B,EAC7B,WAAoB;IAEpB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAe,CAAC;QAC1E,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAoB,CAAC;AAChE,CAAC"}

package/dist/src/dashboard/handlers.d.ts

@@ -1,20 +1,41 @@
-import type { WorkflowEngine } from '../index.js';
+import type { GroupHealth, RunQuery, RunResult, StepCheckpoint, WorkflowRun } from '../index.js';
 /**
- * Framework-light JSON handlers over a {@link WorkflowEngine}.
+ * Framework-light JSON handlers over a {@link DashboardEngine}.
  *
- * Each handler takes a {@link Deps} bundle (just the engine — runs and
- * checkpoints are read through the engine's own read API, {@link
- * WorkflowEngine.listRuns} / {@link WorkflowEngine.listCheckpoints}, so the
- * dashboard never reaches for the engine's private store) plus a plain {@link
+ * Each handler takes a {@link Deps} bundle (just the read/control port — runs
+ * and checkpoints are read through its own read API, {@link
+ * DashboardEngine.listRuns} / {@link DashboardEngine.listCheckpoints}, so the
+ * dashboard never reaches for a private store) plus a plain {@link
  * ApiRequest} (a thin view of the parts of an HTTP request it needs), and
  * returns a plain {@link ApiResponse} (status + JSON body). No AdonisJS types
  * leak in, so the handlers are unit-testable against a real in-memory engine
  * with no HTTP server. The provider adapts an AdonisJS `HttpContext` to these
  * shapes.
  */
-/** The engine the handlers operate over. */
+/**
+ * The bounded read/control surface the JSON handlers drive — declared STRUCTURALLY (a port), not by
+ * importing the concrete `WorkflowEngine` class, so the same handlers serve BOTH durable topologies
+ * (design §8): a store role passes the real {@link import('../engine.js').WorkflowEngine} (structurally
+ * assignable — it has every method here); a store-less `tenant` pod passes an adapter over its
+ * {@link import('../run-gateway/interface.js').RunGateway} (see `gatewayDashboardEngine`). Store presence
+ * is therefore invisible to the handlers. Mirrors the `RunGatewayEngine` port pattern already used by
+ * `StoreRunGateway`.
+ */
+export interface DashboardEngine {
+    getRun(runId: string): Promise<WorkflowRun | null>;
+    listRuns(query: RunQuery): Promise<WorkflowRun[]>;
+    listCheckpoints(runId: string): Promise<StepCheckpoint[]>;
+    getRunChildren(runId: string): Promise<string[]>;
+    requeue(runId: string): Promise<RunResult | null>;
+    redispatchPending(runId: string): Promise<RunResult | null>;
+    cancel(runId: string, opts?: {
+        compensate?: boolean;
+    }): Promise<RunResult | null>;
+    workerHealth(extra?: string[]): Promise<GroupHealth[]>;
+}
+/** The read/control port the handlers operate over (a store engine or a tenant gateway adapter). */
 export interface Deps {
-    engine: WorkflowEngine;
+    engine: DashboardEngine;
 }
 /** The subset of an HTTP request the handlers read. */
 export interface ApiRequest {
@@ -30,6 +51,8 @@ export interface ApiResponse {
     status: number;
     body: unknown;
 }
+/** A `200 OK` JSON response. Exported so sibling handlers (e.g. `compat`) share one convention. */
+export declare const ok: (body: unknown) => ApiResponse;
 /** `GET /runs` — list runs filtered by status/workflow/tag, paginated. */
 export declare function listRuns(deps: Deps, req: ApiRequest): Promise<ApiResponse>;
 /** `GET /runs/:id` — a run's detail: the run, its step timeline, and child run ids. */
@@ -40,6 +63,13 @@ export declare function getRun(deps: Deps, req: ApiRequest): Promise<ApiResponse
  * state immediately; never blocks on execution.
  */
 export declare function retryRun(deps: Deps, req: ApiRequest): Promise<ApiResponse>;
+/**
+ * `POST /runs/:id/redispatch` — re-enqueue every remote step of a run stuck `pending`, for a run
+ * whose dispatched step job was LOST (worker crashed with no result, or the transport dropped the
+ * job). The idempotent step re-runs and its result resumes the run. Returns the run's current status
+ * and the count re-dispatched; never blocks on execution.
+ */
+export declare function redispatchPendingRun(deps: Deps, req: ApiRequest): Promise<ApiResponse>;
 /** `POST /runs/:id/cancel` — cancel a run. Pass `{ compensate: true }` to undo the saga first. */
 export declare function cancelRun(deps: Deps, req: ApiRequest): Promise<ApiResponse>;
 /** `GET /health` — per-group worker health (queue backlog + live worker heartbeats). */

package/dist/src/dashboard/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/dashboard/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,cAAc,EAEf,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;GAYG;AAEH,4CAA4C;AAC5C,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACrD,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAuCD,0EAA0E;AAC1E,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBhF;AAED,uFAAuF;AACvF,wBAAsB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAe9E;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAMhF;AAED,kGAAkG;AAClG,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAUjF;AAED,wFAAwF;AACxF,wBAAsB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAW7D"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/dashboard/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EAET,cAAc,EACd,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;GAYG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1D,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAClD,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAClF,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACxD;AAED,oGAAoG;AACpG,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACrD,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,mGAAmG;AACnG,eAAO,MAAM,EAAE,GAAI,MAAM,OAAO,KAAG,WAAsC,CAAC;AAqC1E,0EAA0E;AAC1E,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBhF;AAED,uFAAuF;AACvF,wBAAsB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAe9E;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAMhF;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAM5F;AAED,kGAAkG;AAClG,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAUjF;AAED,wFAAwF;AACxF,wBAAsB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAW7D"}

package/dist/src/dashboard/handlers.js

@@ -1,4 +1,5 @@
-const ok = (body) => ({ status: 200, body });
+/** A `200 OK` JSON response. Exported so sibling handlers (e.g. `compat`) share one convention. */
+export const ok = (body) => ({ status: 200, body });
 const notFound = (message) => ({
     status: 404,
     body: { error: message },
@@ -89,6 +90,21 @@ export async function retryRun(deps, req) {
         return notFound(`run ${id} not found`);
     return ok({ result });
 }
+/**
+ * `POST /runs/:id/redispatch` — re-enqueue every remote step of a run stuck `pending`, for a run
+ * whose dispatched step job was LOST (worker crashed with no result, or the transport dropped the
+ * job). The idempotent step re-runs and its result resumes the run. Returns the run's current status
+ * and the count re-dispatched; never blocks on execution.
+ */
+export async function redispatchPendingRun(deps, req) {
+    const id = req.params.id;
+    if (!id)
+        return notFound('run id is required');
+    const result = await deps.engine.redispatchPending(id);
+    if (!result)
+        return notFound(`run ${id} not found`);
+    return ok({ result });
+}
 /** `POST /runs/:id/cancel` — cancel a run. Pass `{ compensate: true }` to undo the saga first. */
 export async function cancelRun(deps, req) {
     const id = req.params.id;

package/dist/src/dashboard/handlers.js.map

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

package/dist/src/dashboard/index.d.ts

@@ -1,10 +1,17 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.7.0";
+export declare const VERSION = "0.11.0";
 export { defineConfig, defaultAuthorize, resolveConfig } from './define_config.js';
 export type { AuthorizeHook, DurableDashboardConfig, ResolvedDurableDashboardConfig, } from './define_config.js';
-export { listRuns, getRun, retryRun, cancelRun, health, } from './handlers.js';
-export type { ApiRequest, ApiResponse, Deps } from './handlers.js';
+export { listRuns, getRun, retryRun, redispatchPendingRun, cancelRun, health, ok, } from './handlers.js';
+export type { ApiRequest, ApiResponse, Deps, DashboardEngine } from './handlers.js';
 export { renderDashboard } from './html.js';
+export { compat, enumerateLiveFleet, mergeFleets } from './compat.js';
+export type { CompatSource, FleetGroup, FleetTransport } from './compat.js';
+export { BlockedDiagnosticsRecorder } from './diagnostics-recorder.js';
+export type { RecordedBlock, EngineEventSource } from './diagnostics-recorder.js';
+export { outcomeClass, outcomeLabel, formatProtocolRange } from './compat-view.js';
+export { gatewayDashboardEngine, dashboardEngineForRole } from './gateway-adapter.js';
+export type { DashboardContainer } from './gateway-adapter.js';
 export { resolveDashboardAuth, performLogin, readSession, sanitizeReturnTo, SESSION_COOKIE_NAME, } from './auth.js';
 export type { DashboardAuthOptions, ResolvedDashboardAuth, LoginHook, LoginOutcome, } from './auth.js';
 export { signSessionCookie, verifySessionCookie, } from './session_cookie.js';