@adonis-agora/durable 0.49.1 → 0.50.0

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

@@ -1,4 +1,6 @@
 import { DURABLE_RUN_GATEWAY } from '../role_bindings.js';
+import { UNSUPPORTED_RUN_REQUEST } from '../run-gateway/run-request-responder.js';
+import { scanRunValueFacets } from '../run-value-facets.js';
 /**
  * Adapt a store-backed {@link import('../engine.js').WorkflowEngine} to the {@link DashboardEngine}
  * port — an explicit wrapper (not a raw `as DashboardEngine` cast) because two verbs need shape
@@ -17,6 +19,16 @@ export function storeDashboardEngine(engine) {
         listRuns: (query) => engine.listRuns(query),
         listCheckpoints: (runId) => engine.listCheckpoints(runId),
         getRunChildren: (runId) => engine.getRunChildren(runId),
+        ...(engine.getRunDetail
+            ? {
+                getRunDetail: (runId, options) => engine.getRunDetail(runId, options),
+            }
+            : {}),
+        ...(engine.getFanMembers
+            ? {
+                getFanMembers: (runId, group, query) => engine.getFanMembers(runId, group, query),
+            }
+            : {}),
         requeue: (runId) => engine.requeue(runId),
         redispatchPending: (runId) => engine.redispatchPending?.(runId) ?? Promise.resolve(null),
         cancel: (runId, opts) => engine.cancel(runId, opts),
@@ -34,6 +46,16 @@ export function storeDashboardEngine(engine) {
             if (event.runId === runId)
                 onEvent(event);
         }),
+        ...(engine.countRuns
+            ? {
+                countRuns: (query) => engine.countRuns(query),
+            }
+            : {}),
+        ...(engine.getEvent
+            ? {
+                getEvent: (runId, key) => engine.getEvent(runId, key),
+            }
+            : {}),
         ...(engine.listSignalWaiters
             ? {
                 listSignalWaiters: (prefix) => engine.listSignalWaiters?.(prefix),
@@ -68,10 +90,13 @@ export function storeDashboardEngine(engine) {
  * `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).
  *
- * `retryWithInput`/`continue` have NO gateway verb yet (design §8 didn't need fix-and-replay or
- * breakpoint-continue over the wire) — they degrade to `null`, same convention as
- * `RunGatewayEngine.redispatchPending`'s optional degrade. A tenant pod's dashboard therefore shows
- * these actions as unavailable (the handlers 404) until the wire protocol grows the verbs.
+ * `retry`, `continue`, `retryWithInput`, `runValueFacets` and `waitingFor` ride the wire too (aviary's
+ * verbs), so a tenant pod's console retries in place, continues a breakpoint, fixes and replays,
+ * fills its value pickers and names what a suspended run waits on. Against a control plane that
+ * predates them (it answers `unsupported-request` or an unknown-verb error) each degrades the way it
+ * did before those verbs existed: `requeue` re-dispatches the run's pending steps, `continue` and
+ * `retryWithInput` answer `null` (the handlers 404), the pickers count a bounded `listRuns` scan,
+ * and the list rows carry no `waiting` stamp.
  */
 export function gatewayDashboardEngine(gateway) {
     return {
@@ -89,15 +114,54 @@ export function gatewayDashboardEngine(gateway) {
                 getFanMembers: (runId, group, query) => gateway.getFanMembers(runId, group, query),
             }
             : {}),
-        requeue: (runId) => gateway.redispatchPending(runId),
+        requeue: (runId) => gateway.retry
+            ? orOlder(gateway.retry(runId), () => gateway.redispatchPending(runId))
+            : gateway.redispatchPending(runId),
         redispatchPending: (runId) => gateway.redispatchPending(runId),
         cancel: (runId, opts) => gateway.cancel(runId, opts),
         workerHealth: () => gateway.workerHealth(),
-        retryWithInput: () => Promise.resolve(null),
-        continue: () => Promise.resolve(null),
+        retryWithInput: (runId, input) => gateway.retryWithInput
+            ? orOlder(gateway.retryWithInput(runId, input), () => Promise.resolve(null))
+            : Promise.resolve(null),
+        continue: (runId) => gateway.continue
+            ? orOlder(gateway.continue(runId), () => Promise.resolve(null))
+            : Promise.resolve(null),
+        ...(gateway.runValueFacets
+            ? {
+                runValueFacets: (axis, query, opts) => orOlder(gateway.runValueFacets(axis, query, opts), () => scanRunValueFacets({ listRuns: (q) => gateway.listRuns(q) }, axis, query, opts)),
+            }
+            : {}),
+        ...(gateway.runFacets
+            ? {
+                // The metrics backlog gauges, scoped to the tenant by the control plane.
+                countRuns: async ({ status, statuses, ...rest }) => {
+                    const wanted = new Set(statuses ?? (status ? [status] : []));
+                    const cells = await gateway.runFacets(rest);
+                    return cells
+                        .filter((c) => wanted.size === 0 || wanted.has(c.status))
+                        .reduce((n, c) => n + c.count, 0);
+                },
+            }
+            : {}),
+        ...(gateway.waitingFor
+            ? {
+                waitingFor: (runIds) => orOlder(gateway.waitingFor(runIds), () => Promise.resolve({})),
+            }
+            : {}),
         subscribe: (runId, onEvent) => gateway.subscribe(runId, onEvent),
     };
 }
+/** `work`, or `older()` when the control plane answered that it does not know the verb. */
+async function orOlder(work, older) {
+    try {
+        return await work;
+    }
+    catch (err) {
+        if (err?.code === UNSUPPORTED_RUN_REQUEST)
+            return older();
+        throw err;
+    }
+}
 /**
  * Resolve the dashboard's read/control port for the active durable `role` (design §5) — the single seam
  * that makes the dashboard store-agnostic:

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

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

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

@@ -1,5 +1,5 @@
 import type { ScheduleInfo } from '../engine.js';
-import type { EngineEvent, GroupHealth, RunFacetQuery, RunQuery, RunResult, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, SignalWaiter, StepCheckpoint, UpdateResult, WorkflowRun } from '../index.js';
+import type { EngineEvent, GroupHealth, RunFacetQuery, RunQuery, RunResult, RunValueAxis, RunValueFacetOptions, RunValueFacetRow, RunWaiting, SignalWaiter, StepCheckpoint, UpdateResult, WorkflowRun } from '../index.js';
 import { type FanPage, type FanPageQuery, type RunDetail, type RunDetailOptions } from '../run-detail-summary.js';
 /**
  * Framework-light JSON handlers over a {@link DashboardEngine}.
@@ -96,6 +96,18 @@ export interface DashboardEngine {
      * full `listSignalWaiters('')` scan above.
      */
     listSignalWaitersByRunIds?(runIds: string[]): Promise<SignalWaiter[]>;
+    /**
+     * Already-resolved {@link RunWaiting} for the given runs — what a store-less `tenant` pod's
+     * gateway answers instead of raw waiter rows. Used by `listRuns` only when neither waiter scan
+     * above is available.
+     */
+    waitingFor?(runIds: string[]): Promise<Record<string, RunWaiting>>;
+    /** How many runs match `query` — the backlog gauges of `GET /metrics`. Optional: without it the
+     *  gauges are left out of the scrape. */
+    countRuns?(query: Omit<RunQuery, 'page' | 'size'>): Promise<number>;
+    /** The latest value a run published for `key` via `ctx.setEvent` (a side-effect-free live query).
+     *  Optional: absent on a store-less `tenant` pod, where `GET /runs/:id/events/:key` answers 404. */
+    getEvent?(runId: string, key: string): Promise<unknown>;
     /**
      * The distinct values of ONE filter axis over the runs matching `query`, with counts — what a
      * console's pickers list. Optional: absent on a port that can't do the scan yet (a store-less
@@ -107,6 +119,10 @@ export interface DashboardEngine {
 /** The read/control port the handlers operate over (a store engine or a tenant gateway adapter). */
 export interface Deps {
     engine: DashboardEngine;
+    /** This process's event counters (`collectMetrics`), prepended to `GET /metrics`. */
+    metrics?: {
+        prometheus(): string;
+    } | undefined;
     /** Host redaction hooks over the SERIALIZED run/checkpoint shapes (see the config's `redact`). */
     redact?: {
         run?: (run: Record<string, unknown>) => Record<string, unknown>;
@@ -122,11 +138,15 @@ export interface ApiRequest {
     query: Record<string, unknown>;
     /** Parsed JSON body (for POST actions). */
     body?: unknown;
+    /** Request headers, lower-cased names. Read by the run-detail routes for `If-None-Match`. */
+    headers?: Record<string, string | undefined>;
 }
 /** A plain JSON response: an HTTP status and a serializable body. */
 export interface ApiResponse {
     status: number;
     body: unknown;
+    /** Extra response headers (the run-detail routes' `ETag` / `Cache-Control`). */
+    headers?: Record<string, string>;
 }
 /** A `200 OK` JSON response. Exported so sibling handlers (e.g. `compat`) share one convention. */
 export declare const ok: (body: unknown) => ApiResponse;
@@ -239,4 +259,36 @@ export declare function workers(deps: Deps): Promise<ApiResponse>;
 /** `GET /topology` — this deployment's durable role, for the header badge. Pure/local (no engine
  *  round-trip): the role is already known by `dashboard_provider.ts` from `config/durable.ts`. */
 export declare function topology(role: 'standalone' | 'control-plane' | 'tenant', tenant?: string): ApiResponse;
+/**
+ * `GET /metrics` — Prometheus text exposition: this process's event counters (runs and steps by
+ * outcome, per-workflow counts, step durations; see `collectMetrics`) plus gauges read at scrape
+ * time: `durable_pending_runs` (the dispatch backlog), `durable_running_runs`, `durable_dead_runs`
+ * (the dead-letter queue) and, per worker group, `durable_group_queue_depth` and
+ * `durable_group_live_workers` (`depth > 0` with zero live workers is the alert). The counters only
+ * count the events this process produced, so summing a scrape of every pod counts each event once.
+ * Returns the text body; the route sets the `text/plain; version=0.0.4` content type.
+ */
+export declare function metricsText(deps: Deps): Promise<string>;
+/**
+ * `GET /runs/:id/events/:key` — the latest value run `id` published for `key` via `ctx.setEvent`:
+ * a side-effect-free query of a live (or finished) run. `{ value }`, with `value` absent when the
+ * run never published that key. 404 for an unknown run, and on a topology without the read (a
+ * store-less `tenant` pod). The value passes through the `checkpoint` redaction hook as the
+ * `event:<key>` checkpoint's `output`, since that is where it is stored.
+ */
+export declare function getRunEvent(deps: Deps, req: ApiRequest): Promise<ApiResponse>;
+/**
+ * `POST /webhooks/:token` — deliver a `ctx.webhook()` callback: the body resumes the run parked on
+ * that webhook. Only webhook tokens (`wh:<runId>:<seq>`) are accepted, so this is not a generic
+ * signal endpoint. A callback for a run waiting on that token resumes it (200). One that lands
+ * before the run reaches `wait()` is buffered (202) when the run exists, is not terminal and has not
+ * consumed this webhook yet, and the later `wait()` consumes it; anything else — an unknown run, a
+ * terminal one, a duplicate — answers 404 and buffers nothing.
+ *
+ * The route sits behind the console's own guard (`authorize`, CSRF, roles), like every other
+ * route: a webhook token embeds the run id, which a caller may know, so it is not a secret to rest
+ * on. Let your callers through in `authorize` (a shared header, an IP range, a signature check), or
+ * mount your own public route that verifies the sender and calls `engine.signal(token, body)`.
+ */
+export declare function deliverWebhook(deps: Deps, req: ApiRequest): Promise<ApiResponse>;
 //# sourceMappingURL=handlers.d.ts.map

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

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

package/dist/src/dashboard/handlers.js

@@ -9,6 +9,19 @@ import { runValueAdapter } from './run-values.js';
 function redacted(hook, row) {
     return hook ? hook(row) : row;
 }
+/**
+ * Revalidation headers for a versioned run detail or fan page: `no-cache` makes the browser ask on
+ * every poll and send the `ETag` back as `If-None-Match`, so an unchanged run costs a 304.
+ */
+function etagHeaders(etag) {
+    return { etag, 'cache-control': 'private, no-cache' };
+}
+/** A bare `304 Not Modified` carrying its validator. */
+const notModified = (etag) => ({
+    status: 304,
+    body: null,
+    headers: etagHeaders(etag),
+});
 /** 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) => ({
@@ -187,12 +200,9 @@ export async function listRuns(deps, req) {
     // (...)`, indexed) over the legacy full-table waiter scan; absent on a topology that can't do
     // either yet (see `DashboardEngine.listSignalWaiters`'s doc), where the `waiting` stamp is
     // simply skipped, same as `@dudousxd/nestjs-durable-dashboard`.
-    const waiters = engine.listSignalWaitersByRunIds
-        ? await engine.listSignalWaitersByRunIds(runs.map((r) => r.id))
-        : await (engine.listSignalWaiters?.('') ?? Promise.resolve(undefined));
-    const waiterByRun = waiters ? indexWaitersByRun(waiters) : undefined;
+    const waitingOf = await waitingResolver(engine, runs);
     return ok({
-        runs: runs.map((run) => redacted(deps.redact?.run, summarizeRun(run, waiterByRun))),
+        runs: runs.map((run) => redacted(deps.redact?.run, summarizeRun(run, waitingOf))),
         meta: { page, size, count: runs.length },
         statuses: RUN_STATUSES,
     });
@@ -212,20 +222,28 @@ export async function getRun(deps, req) {
     const full = readFlag(req, 'full');
     if (full === INVALID_FLAG)
         return badRequest('full must be a boolean');
-    const options = full ? undefined : { summarizeFansOver: SUMMARIZE_FANS_OVER };
+    const ifNoneMatch = req.headers?.['if-none-match'];
+    const options = full
+        ? undefined
+        : { summarizeFansOver: SUMMARIZE_FANS_OVER, ...(ifNoneMatch ? { ifNoneMatch } : {}) };
     const detail = engine.getRunDetail
         ? await engine.getRunDetail(id, options)
         : await loadRunDetail(engine, id, options);
     if (!detail)
         return notFound(`run ${id} not found`);
+    if (detail.etag && detail.notModified)
+        return notModified(detail.etag);
     const checkpoint = (cp) => redacted(deps.redact?.checkpoint, summarizeCheckpoint(cp));
-    return ok({
-        run: redacted(deps.redact?.run, detailRun(detail.run)),
-        timeline: detail.timeline.map(checkpoint),
-        children: detail.children,
-        ...(detail.fans ? { fans: detail.fans.map((fan) => serializeFan(fan, checkpoint)) } : {}),
-        ...(detail.childCount !== undefined ? { childCount: detail.childCount } : {}),
-    });
+    return {
+        ...ok({
+            run: redacted(deps.redact?.run, detailRun(detail.run)),
+            timeline: detail.timeline.map(checkpoint),
+            children: detail.children,
+            ...(detail.fans ? { fans: detail.fans.map((fan) => serializeFan(fan, checkpoint)) } : {}),
+            ...(detail.childCount !== undefined ? { childCount: detail.childCount } : {}),
+        }),
+        ...(detail.etag ? { headers: etagHeaders(detail.etag) } : {}),
+    };
 }
 /**
  * `GET /runs/:id/fans/:group` — one page of a summarized fan's members, in seq order, with the
@@ -244,20 +262,27 @@ export async function getFanMembers(deps, req) {
         const raw = firstQuery(req.query[key]);
         return raw === undefined ? undefined : Number(raw);
     };
+    const ifNoneMatch = req.headers?.['if-none-match'];
     const query = {
         offset: number('offset'),
         limit: number('limit'),
         failedOnly: failed,
+        ...(ifNoneMatch ? { ifNoneMatch } : {}),
     };
     const page = engine.getFanMembers
         ? await engine.getFanMembers(id, group, query)
         : await loadFanMembers(engine, id, group, query);
     if (!page)
         return notFound(`run ${id} not found`);
-    return ok({
-        items: page.items.map((cp) => redacted(deps.redact?.checkpoint, summarizeCheckpoint(cp))),
-        total: page.total,
-    });
+    if (page.etag && page.notModified)
+        return notModified(page.etag);
+    return {
+        ...ok({
+            items: page.items.map((cp) => redacted(deps.redact?.checkpoint, summarizeCheckpoint(cp))),
+            total: page.total,
+        }),
+        ...(page.etag ? { headers: etagHeaders(page.etag) } : {}),
+    };
 }
 /** A {@link FanSummary} on the wire: ISO dates, and its failure sample shaped like timeline steps. */
 function serializeFan(fan, checkpoint) {
@@ -554,10 +579,31 @@ export async function workers(deps) {
 export function topology(role, tenant) {
     return ok(tenant !== undefined ? { role, tenant } : { role });
 }
-/** Compact run shape for the list view. `waiterByRun`, when given, stamps `waiting` on a `suspended`
+/**
+ * How `listRuns` names what each run on a page is parked on: from the store's waiter rows (the
+ * targeted per-page lookup, else the full scan), or from a gateway's resolved `waitingFor`. Undefined
+ * when the port can do neither, and the `waiting` stamp is skipped.
+ */
+async function waitingResolver(engine, runs) {
+    const ids = runs.map((r) => r.id);
+    const waiters = engine.listSignalWaitersByRunIds
+        ? await engine.listSignalWaitersByRunIds(ids)
+        : await (engine.listSignalWaiters?.('') ?? Promise.resolve(undefined));
+    if (waiters) {
+        const waiterByRun = indexWaitersByRun(waiters);
+        return (run) => resolveRunWaiting(run, waiterByRun);
+    }
+    if (engine.waitingFor) {
+        const suspended = runs.filter((r) => r.status === 'suspended').map((r) => r.id);
+        const byRun = suspended.length > 0 ? await engine.waitingFor(suspended) : {};
+        return (run) => byRun[run.id];
+    }
+    return undefined;
+}
+/** Compact run shape for the list view. `waitingOf`, when given, stamps `waiting` on a `suspended`
  *  run parked on a signal/webhook/child/breakpoint (see `listRuns`' bulk waiter scan). */
-function summarizeRun(run, waiterByRun) {
-    const waiting = waiterByRun ? resolveRunWaiting(run, waiterByRun) : undefined;
+function summarizeRun(run, waitingOf) {
+    const waiting = waitingOf ? waitingOf(run) : undefined;
     return {
         id: run.id,
         workflow: run.workflow,
@@ -616,4 +662,138 @@ function summarizeCheckpoint(cp) {
         queueMs: queueMs >= 0 ? queueMs : 0,
     };
 }
+/** Escape a Prometheus label value (backslash, double quote, newline). */
+function promLabel(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+}
+/**
+ * `GET /metrics` — Prometheus text exposition: this process's event counters (runs and steps by
+ * outcome, per-workflow counts, step durations; see `collectMetrics`) plus gauges read at scrape
+ * time: `durable_pending_runs` (the dispatch backlog), `durable_running_runs`, `durable_dead_runs`
+ * (the dead-letter queue) and, per worker group, `durable_group_queue_depth` and
+ * `durable_group_live_workers` (`depth > 0` with zero live workers is the alert). The counters only
+ * count the events this process produced, so summing a scrape of every pod counts each event once.
+ * Returns the text body; the route sets the `text/plain; version=0.0.4` content type.
+ */
+export async function metricsText(deps) {
+    const { engine } = deps;
+    const gauges = [];
+    const count = engine.countRuns?.bind(engine);
+    // A count that fails (a control plane too old to answer it, from a tenant pod) leaves the backlog
+    // gauges out rather than reporting a backlog of 0.
+    const counts = count
+        ? await Promise.all([
+            count({ status: 'pending' }),
+            count({ status: 'running' }),
+            count({ status: 'dead' }),
+        ]).catch(() => undefined)
+        : undefined;
+    if (counts) {
+        const [pending, running, dead] = counts;
+        gauges.push('# TYPE durable_pending_runs gauge', `durable_pending_runs ${pending}`, '# TYPE durable_running_runs gauge', `durable_running_runs ${running}`, '# TYPE durable_dead_runs gauge', `durable_dead_runs ${dead}`);
+    }
+    const health = await engine.workerHealth();
+    if (health.length > 0) {
+        gauges.push('# TYPE durable_group_queue_depth gauge');
+        for (const h of health) {
+            gauges.push(`durable_group_queue_depth{group="${promLabel(h.group)}"} ${h.depth}`);
+        }
+        gauges.push('# TYPE durable_group_live_workers gauge');
+        for (const h of health) {
+            gauges.push(`durable_group_live_workers{group="${promLabel(h.group)}"} ${h.liveWorkers.length}`);
+        }
+    }
+    const counters = deps.metrics?.prometheus() ?? '';
+    return `${counters}${gauges.length > 0 ? `${gauges.join('\n')}\n` : ''}`;
+}
+/**
+ * `GET /runs/:id/events/:key` — the latest value run `id` published for `key` via `ctx.setEvent`:
+ * a side-effect-free query of a live (or finished) run. `{ value }`, with `value` absent when the
+ * run never published that key. 404 for an unknown run, and on a topology without the read (a
+ * store-less `tenant` pod). The value passes through the `checkpoint` redaction hook as the
+ * `event:<key>` checkpoint's `output`, since that is where it is stored.
+ */
+export async function getRunEvent(deps, req) {
+    const { engine } = deps;
+    const id = req.params.id;
+    const key = req.params.key;
+    if (!id)
+        return notFound('run id is required');
+    if (!key)
+        return notFound('event key is required');
+    if (!engine.getEvent)
+        return notFound('run events are not available on this topology');
+    if (!(await engine.getRun(id)))
+        return notFound(`run ${id} not found`);
+    const value = await engine.getEvent(id, key);
+    if (value === undefined)
+        return ok({});
+    const hook = deps.redact?.checkpoint;
+    if (!hook)
+        return ok({ value });
+    return ok({ value: hook({ name: `event:${key}`, output: value }).output });
+}
+/** The run a `ctx.webhook()` token belongs to: `wh:<runId>:<seq>`. */
+function webhookRunId(token) {
+    if (!token.startsWith('wh:'))
+        return undefined;
+    const rest = token.slice(3);
+    const sep = rest.lastIndexOf(':');
+    if (sep <= 0 || !/^\d+$/.test(rest.slice(sep + 1)))
+        return undefined;
+    return rest.slice(0, sep);
+}
+/**
+ * `POST /webhooks/:token` — deliver a `ctx.webhook()` callback: the body resumes the run parked on
+ * that webhook. Only webhook tokens (`wh:<runId>:<seq>`) are accepted, so this is not a generic
+ * signal endpoint. A callback for a run waiting on that token resumes it (200). One that lands
+ * before the run reaches `wait()` is buffered (202) when the run exists, is not terminal and has not
+ * consumed this webhook yet, and the later `wait()` consumes it; anything else — an unknown run, a
+ * terminal one, a duplicate — answers 404 and buffers nothing.
+ *
+ * The route sits behind the console's own guard (`authorize`, CSRF, roles), like every other
+ * route: a webhook token embeds the run id, which a caller may know, so it is not a secret to rest
+ * on. Let your callers through in `authorize` (a shared header, an IP range, a signature check), or
+ * mount your own public route that verifies the sender and calls `engine.signal(token, body)`.
+ */
+export async function deliverWebhook(deps, req) {
+    const { engine } = deps;
+    const token = req.params.token;
+    if (!token)
+        return notFound('webhook token is required');
+    const runId = webhookRunId(token);
+    if (runId === undefined)
+        return notFound(`${token} is not a webhook token`);
+    if (!engine.signal)
+        return notFound('webhooks are not available on this topology');
+    const tooLarge = payloadTooLarge(req.body);
+    if (tooLarge)
+        return tooLarge;
+    const waiters = engine.listSignalWaitersByRunIds
+        ? await engine.listSignalWaitersByRunIds([runId])
+        : await engine.listSignalWaiters?.(token);
+    if (!waiters?.some((w) => w.token === token)) {
+        // Nothing waits on it YET: a callback may legitimately land before the run reaches `wait()`
+        // (the url was handed out, then the run kept going). Buffer it like `engine.signal` does — but
+        // only for a run that exists, is not terminal, and has not already consumed this webhook, so a
+        // guessed, stale or duplicate token buffers nothing.
+        const run = await engine.getRun(runId);
+        if (!run || TERMINAL_STATUSES.has(run.status)) {
+            return notFound(`no live run is waiting on webhook ${token}`);
+        }
+        const seq = Number(token.slice(token.lastIndexOf(':') + 1));
+        const delivered = (await engine.listCheckpoints(runId)).some((cp) => cp.seq === seq && cp.status === 'completed');
+        if (delivered)
+            return notFound(`webhook ${token} was already delivered`);
+        const result = await engine.signal(token, req.body);
+        if (result)
+            return ok({ result });
+        return { status: 202, body: { buffered: true } };
+    }
+    const result = await engine.signal(token, req.body);
+    if (!result)
+        return notFound(`no run is waiting on webhook ${token}`);
+    return ok({ result });
+}
+const TERMINAL_STATUSES = new Set(['completed', 'failed', 'cancelled', 'dead']);
 //# sourceMappingURL=handlers.js.map