@adonis-agora/durable 0.25.0 → 0.26.0

package/dist/src/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.25.0';
+export const VERSION = '0.26.0';
 // --- engine + core primitives -----------------------------------------------
 export * from './admission.js';
 export * from './control-flow-signal.js';
@@ -27,6 +27,8 @@ export * from './scheduler.js';
 export * from './search-attributes.js';
 export * from './tokens.js';
 export * from './workflow-ref.js';
+export * from './workflow-events.js';
+export * from './event-trigger-bridge.js';
 export * from './workflow-discovery.js';
 export { BaseWorkflow, setWorkflowEngineResolver, } from './base-workflow.js';
 export { getCurrentWorkflowCtx, workflowAls } from './workflow-als.js';

package/dist/src/index.js.map

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

package/dist/src/workflow-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-discovery.d.ts","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,YAAY,EAAmC,MAAM,mBAAmB,CAAC;AAEvF;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU;IAC9C,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D,CAAC;AAEF;2CAC2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,uBAAuB,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,uBAAuB,KAC1B,uBAAuB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC;AAQ1F;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,oBAA6C,GACrD,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAY9E;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyBlF;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB"}
+{"version":3,"file":"workflow-discovery.d.ts","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,KAAK,YAAY,EAAmC,MAAM,mBAAmB,CAAC;AAEvF;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU;IAC9C,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D,CAAC;AAEF;2CAC2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,uBAAuB,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,uBAAuB,KAC1B,uBAAuB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC;AAQ1F;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,oBAA6C,GACrD,OAAO,CAAC,OAAO,CAAC,CAgClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAY9E;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyBlF;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB"}

package/dist/src/workflow-discovery.js

@@ -1,6 +1,7 @@
 import { readdir } from 'node:fs/promises';
 import { extname, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
+import { eventTriggerCanonicalName, workflowEvents } from './workflow-events.js';
 import { workflowMeta, workflowSchedules } from './workflow-ref.js';
 function defaultWorkflowFactory(ctor) {
     return new ctor();
@@ -22,10 +23,21 @@ export async function registerWorkflowClass(engine, cls, factory = defaultWorkfl
         return false;
     const Ctor = cls;
     const instance = await factory(Ctor);
+    // Colocated `static on` event triggers: exact-string ones register under the engine's
+    // `onEvent` (the bridge publishes the canonical name); regex/any ones are started
+    // directly by the bridge. Both are recorded so the provider can attach the bridge.
+    const events = workflowEvents(cls);
+    if (events.length > 0)
+        engine.registerEventTriggers(events);
+    const exactNames = events
+        .map(eventTriggerCanonicalName)
+        .filter((name) => name !== null);
     engine.register(meta.name, meta.version, (ctx, input) => Promise.resolve(instance.run(ctx, input)), {
         ...(meta.tags ? { tags: meta.tags } : {}),
         ...(meta.executionTimeout !== undefined ? { executionTimeout: meta.executionTimeout } : {}),
-        ...(meta.onEvent ? { onEvent: meta.onEvent } : {}),
+        ...(meta.onEvent || exactNames.length > 0
+            ? { onEvent: [...(meta.onEvent ?? []), ...exactNames] }
+            : {}),
         ...(meta.singleton ? { singleton: meta.singleton } : {}),
     });
     // Collect any colocated `static schedule` on the class so the worker loop can fire it alongside the

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

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

package/dist/src/workflow-events.d.ts

@@ -0,0 +1,85 @@
+import { type WorkflowClass } from './workflow-ref.js';
+/**
+ * Event-triggered workflows: a workflow class declares which **external** events start a
+ * run — the Adonis emitter (`@OnEvent`) and/or the `@adonis-agora/diagnostics` bus
+ * (`@OnDiagnostic`). The durable provider bridges those buses into the engine (a fresh
+ * run per matching event, payload as input), mirroring how `static schedule`/`@Scheduled`
+ * bridge time into the engine.
+ *
+ * Two authoring forms, exactly like schedules:
+ * - `@OnEvent(...)` / `@OnDiagnostic(...)` decorators (named params), and
+ * - a colocated `static on = [...]` literal — the decorators only stamp `static on`.
+ *
+ * ```ts
+ * @OnDiagnostic({ lib: 'payments', event: 'payment.succeeded' })
+ * @OnEvent({ event: 'agora:payments:payment.succeeded' })
+ * export class ProcessPaymentWorkflow extends BaseWorkflow {
+ *   static workflow = { name: 'process-payment' }
+ *   async run(ctx, input) { /* input = the event payload *\/ }
+ * }
+ * ```
+ */
+/** A trigger fed by the AdonisJS emitter. Exact event names only (the emitter has no wildcard). */
+export interface EmitterTriggerConfig {
+    /** The emitter event name, e.g. `'agora:payments:payment.succeeded'`. */
+    event: string;
+}
+/** A trigger fed by the `@adonis-agora/diagnostics` bus (`agora:<lib>:<event>` channels). */
+export interface DiagnosticsTriggerConfig {
+    /** The diagnostics lib to listen to, e.g. `'payments'`. */
+    lib: string;
+    /**
+     * Exact event within the lib (e.g. `'payment.succeeded'`), a regex over events, or omit
+     * to match every event of the lib.
+     */
+    event?: string | RegExp;
+}
+/** One colocated event trigger (the `static on` entry), discriminated by source. */
+export type WorkflowEventTrigger = ({
+    source: 'emitter';
+} & EmitterTriggerConfig) | ({
+    source: 'diagnostics';
+} & DiagnosticsTriggerConfig);
+/** A normalized trigger: the workflow name filled in, ready for the bridge/engine. */
+export type NormalizedEventTrigger = ({
+    source: 'emitter';
+} & EmitterTriggerConfig & {
+    workflow: string;
+}) | ({
+    source: 'diagnostics';
+} & DiagnosticsTriggerConfig & {
+    workflow: string;
+});
+/**
+ * The canonical engine event name an EXACT trigger maps to — the name the workflow
+ * registers under `onEvent` and the bridge publishes with:
+ * - emitter: the literal event name,
+ * - diagnostics: the channel name `agora:<lib>:<event>`.
+ * Returns `null` for regex/any triggers (the bridge starts those directly).
+ */
+export declare function eventTriggerCanonicalName(trigger: NormalizedEventTrigger): string | null;
+/** Read a class's colocated event triggers (`static on`) and fill the workflow name. */
+export declare function workflowEvents(target: unknown): NormalizedEventTrigger[];
+/**
+ * Listen to an exact event on the **AdonisJS emitter** and start this workflow with the
+ * event payload. Named params:
+ *
+ * ```ts
+ * @OnEvent({ event: 'agora:payments:payment.succeeded' })
+ * ```
+ */
+export declare function OnEvent(config: EmitterTriggerConfig): ClassDecorator;
+/**
+ * Listen to an event on the **`@adonis-agora/diagnostics` bus** (`agora:<lib>:<event>`
+ * channel) and start this workflow with the event payload. Named params:
+ *
+ * ```ts
+ * @OnDiagnostic({ lib: 'payments', event: 'payment.succeeded' }) // exact
+ * @OnDiagnostic({ lib: 'payments', event: /^payment\./ })        // regex over events
+ * @OnDiagnostic({ lib: 'payments' })                             // every event of the lib
+ * ```
+ */
+export declare function OnDiagnostic(config: DiagnosticsTriggerConfig): ClassDecorator;
+/** Workflow-class shape used by the bridge to start a run on a matching event. */
+export type EventTriggeredWorkflow = WorkflowClass;
+//# sourceMappingURL=workflow-events.d.ts.map

package/dist/src/workflow-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-events.d.ts","sourceRoot":"","sources":["../../src/workflow-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AAErE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6FAA6F;AAC7F,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,oFAAoF;AACpF,MAAM,MAAM,oBAAoB,GAC5B,CAAC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG,oBAAoB,CAAC,GAC9C,CAAC;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG,wBAAwB,CAAC,CAAC;AAE3D,sFAAsF;AACtF,MAAM,MAAM,sBAAsB,GAC9B,CAAC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG,oBAAoB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GACrE,CAAC;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG,wBAAwB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAIxF;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,EAAE,CAOxE;AAUD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,wBAAwB,GAAG,cAAc,CAE7E;AAED,kFAAkF;AAClF,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC"}

package/dist/src/workflow-events.js

@@ -0,0 +1,58 @@
+import { workflowMeta } from './workflow-ref.js';
+/**
+ * The canonical engine event name an EXACT trigger maps to — the name the workflow
+ * registers under `onEvent` and the bridge publishes with:
+ * - emitter: the literal event name,
+ * - diagnostics: the channel name `agora:<lib>:<event>`.
+ * Returns `null` for regex/any triggers (the bridge starts those directly).
+ */
+export function eventTriggerCanonicalName(trigger) {
+    if (trigger.source === 'emitter')
+        return trigger.event;
+    if (trigger.event === undefined)
+        return null;
+    return typeof trigger.event === 'string' ? `agora:${trigger.lib}:${trigger.event}` : null;
+}
+/** Read a class's colocated event triggers (`static on`) and fill the workflow name. */
+export function workflowEvents(target) {
+    const meta = workflowMeta(target);
+    if (!meta)
+        return [];
+    const raw = target.on;
+    if (!raw)
+        return [];
+    const arr = Array.isArray(raw) ? raw : [raw];
+    return arr.map((t) => ({ ...t, workflow: meta.name }));
+}
+/** Stamp `static on` (prepend, mirroring {@link Scheduled}). */
+function stampOn(target, config) {
+    const cls = target;
+    const existing = cls.on === undefined ? [] : Array.isArray(cls.on) ? cls.on : [cls.on];
+    const added = Array.isArray(config) ? config : [config];
+    cls.on = [...added, ...existing];
+}
+/**
+ * Listen to an exact event on the **AdonisJS emitter** and start this workflow with the
+ * event payload. Named params:
+ *
+ * ```ts
+ * @OnEvent({ event: 'agora:payments:payment.succeeded' })
+ * ```
+ */
+export function OnEvent(config) {
+    return (target) => stampOn(target, { source: 'emitter', ...config });
+}
+/**
+ * Listen to an event on the **`@adonis-agora/diagnostics` bus** (`agora:<lib>:<event>`
+ * channel) and start this workflow with the event payload. Named params:
+ *
+ * ```ts
+ * @OnDiagnostic({ lib: 'payments', event: 'payment.succeeded' }) // exact
+ * @OnDiagnostic({ lib: 'payments', event: /^payment\./ })        // regex over events
+ * @OnDiagnostic({ lib: 'payments' })                             // every event of the lib
+ * ```
+ */
+export function OnDiagnostic(config) {
+    return (target) => stampOn(target, { source: 'diagnostics', ...config });
+}
+//# sourceMappingURL=workflow-events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-events.js","sourceRoot":"","sources":["../../src/workflow-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkDrE;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA+B;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IACvD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5F,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,GAAG,GAAI,MAAiE,CAAC,EAAE,CAAC;IAClF,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,gEAAgE;AAChE,SAAS,OAAO,CAAC,MAAe,EAAE,MAAqD;IACrF,MAAM,GAAG,GAAG,MAAgE,CAAC;IAC7E,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxD,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,MAA4B;IAClD,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,MAAgC;IAC3D,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/durable",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Durable cross-app workflows for AdonisJS — deterministic replay engine, AdonisJS binding, ace commands, dashboard, OpenTelemetry, Telescope, testing harness and Redis admission, all in one package. Part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -101,6 +101,7 @@
   },
   "files": [
     "dist/",
+    "skills",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -164,10 +165,11 @@
     "bullmq": "5.81.3",
     "cron-parser": "4.9.0",
     "ioredis": "5.11.1",
+    "@tanstack/intent": "^0.3.2",
     "typescript": "5.9.3",
     "vitest": "3.2.7",
     "zod": "3.25.76",
-    "@adonis-agora/durable-dashboard": "0.2.1"
+    "@adonis-agora/durable-dashboard": "0.2.2"
   },
   "engines": {
     "node": ">=20.6.0"
@@ -183,6 +185,7 @@
     "opentelemetry",
     "telescope",
     "testing",
+    "tanstack-intent",
     "agora"
   ],
   "scripts": {

package/skills/durable-cluster/SKILL.md

@@ -0,0 +1,308 @@
+---
+name: durable-cluster
+description: >-
+  Scale @adonis-agora/durable across processes and runtimes: the
+  role-discriminated config (standalone, control-plane, store-less tenant with
+  compile-time store exclusion), durable:work vs durable:worker entrypoints,
+  WorkerRuntime + RedisWorkerRegistry descriptors, handshake negotiation
+  (compatible/degraded/incompatible) and capability routing (requires → blocked
+  runs), layered tenant auth (signTenantToken/hmacTenantVerifier/verifyTenant),
+  runGateway as the role-portable read/control surface, namespace vs partition,
+  and Python (durable-worker) / NestJS interop over the bullmq wire. Use when
+  splitting web from workers, isolating tenants, or adding polyglot workers.
+license: MIT
+metadata:
+  type: core
+  library: "@adonis-agora/durable"
+  library_version: "0.25.0"
+  framework: adonisjs
+sources:
+  - 'DavideCarvalho/adonis-durable:docs/cluster/index.mdx'
+  - 'DavideCarvalho/adonis-durable:docs/cluster/roles-and-config.mdx'
+  - 'DavideCarvalho/adonis-durable:docs/cluster/thin-workers.mdx'
+  - 'DavideCarvalho/adonis-durable:docs/cluster/handshake.mdx'
+  - 'DavideCarvalho/adonis-durable:docs/cluster/interop.mdx'
+  - 'DavideCarvalho/adonis-durable:docs/python.mdx'
+  - 'DavideCarvalho/adonis-durable:docs/concepts/tenancy.mdx'
+---
+
+# Cluster topologies & interop
+
+`config/durable.ts` is a **role-discriminated union**: one `role` field picks
+the topology and TypeScript narrows the rest. Workflows (`app/workflows`) and
+steps (`app/steps`) are byte-identical across every role — only where bodies
+execute changes.
+
+| Role | Owns the store | Executes bodies | Serves HTTP |
+|------|:---:|:---:|:---:|
+| `standalone` (default — omit `role`) | ✅ | ✅ embedded | optional |
+| `control-plane` | ✅ required | ❌ | optional |
+| `tenant` | ❌ typed `never` | worker pods ✅ | api/dashboard pod |
+
+## Setup
+
+Split fleet: a pure coordinator plus store-less tenant workers.
+
+```ts title="config/durable.ts (control plane)"
+import { defineConfig, stores, transports } from '@adonis-agora/durable'
+
+export default defineConfig({
+  role: 'control-plane',
+  transport: 'bullmq', // cross-ecosystem wire; queue/db work for Adonis-only splits
+  transports: { bullmq: transports.bullmq({ connection: { host: '127.0.0.1', port: 6379 } }) },
+  store: 'lucid',
+  stores: { lucid: stores.lucid({ connection: 'pg' }) },
+  verifyTenant: hmacTenantVerifier(process.env.DURABLE_TENANT_SECRET!),
+})
+```
+
+```ts title="config/durable.ts (tenant worker pod)"
+import { defineConfig, transports } from '@adonis-agora/durable'
+
+export default defineConfig({
+  role: 'tenant',
+  transport: 'bullmq',
+  transports: { bullmq: transports.bullmq({ connection: process.env.REDIS_URL }) },
+  partition: 'acme-corp', // which pool this pod serves (required)
+  tenant: { token: process.env.DURABLE_TENANT_TOKEN }, // its signed claim
+  requestTimeoutMs: 10_000,
+  // store: 'lucid'  // ❌ COMPILE ERROR — a tenant config cannot name a store
+})
+```
+
+```bash title="entrypoints"
+node ace durable:work    # store-backed loop: pending, recovery, timers, sweeps, schedules
+node ace durable:worker  # store-less tenant loop: serves app/steps, heartbeats, drains
+```
+
+Isolation is three-layered: type (`store` is `never` on tenant), container (no
+store binding registered), object (`WorkerRuntime`/`ProxyRunGateway` have no
+store field).
+
+## Core patterns
+
+### Pattern 1 — role-portable code via `runGateway`
+
+Every role exposes the same read/control surface; identical controller code runs
+on a store pod (direct reads) or a store-less pod (wire requests answered by the
+control plane's `RunRequestResponder`):
+
+```ts title="app/controllers/runs_controller.ts"
+import { runGateway } from '@adonis-agora/durable/services/main'
+
+export default class RunsController {
+  async show({ params, response }: HttpContext) {
+    const run = await runGateway.getRun(params.id)
+    if (!run) return response.notFound()
+    return response.ok({ run, timeline: await runGateway.getCheckpoints(params.id) })
+  }
+
+  async approve({ params, response }: HttpContext) {
+    await runGateway.signal(params.id, `approve:${params.id}`, { by: 'ops' })
+    return response.accepted({})
+  }
+}
+```
+
+Verbs: `getRun`, `listRuns`, `getCheckpoints`, `getRunChildren`,
+`getSearchAttributes`, `start`, `signal`, `cancel`, `redispatchPending`,
+`workerHealth`, `subscribe`, `topology()`. Never branch on `role`.
+Source: `docs/cluster/roles-and-config.mdx`.
+
+### Pattern 2 — capability-aware routing and blocked runs
+
+A step can require capabilities; dispatch goes only to workers advertising them.
+No capable live worker → the run parks **blocked** (first-class status, visible
+in the dashboard, auto-resumes when a capable worker registers):
+
+```ts
+export const settlePayment = defineStep(
+  'settle-payment',
+  async (input: { orderId: number }) => ({ /* … */ }),
+  { requires: ['saga', 'search-attributes'] },
+)
+```
+
+Workers advertise a `WorkerDescriptor` (runtime, SDK version, protocol range,
+capabilities, steps/workflows served, partition); the control plane negotiates
+protocol-major overlap + capability intersection into compatible / degraded /
+incompatible. An incompatible worker is never handed a task — structured
+`protocol.incompatible` / `capability.unavailable` diagnostics carry both
+descriptors and the delta. Source: `docs/cluster/handshake.mdx`.
+
+### Pattern 3 — building a thin worker by hand
+
+Outside an Adonis app (standalone Node service), use the `/worker` subpath — it
+imports zero store code:
+
+```ts title="worker.ts"
+import { RedisWorkerRegistry, WorkerRuntime } from '@adonis-agora/durable/worker'
+import { transports } from '@adonis-agora/durable'
+import { Redis } from 'ioredis'
+
+const transport = await transports.bullmq({ connection: process.env.REDIS_URL })({ app })
+const runtime = new WorkerRuntime({
+  transport,
+  partition: 'acme-corp',
+  registry: new RedisWorkerRegistry(new Redis(process.env.REDIS_URL!), { ownsConnection: true }),
+})
+
+runtime.registerStep('billing.charge', async (input, log) => {
+  log.info('charging', input)
+  return { chargeId: await stripe.charge(input as ChargeInput) }
+})
+
+await runtime.start()
+for (const signal of ['SIGINT', 'SIGTERM'] as const) {
+  process.once(signal, () => void runtime.stop())
+}
+```
+
+A worker that must execute workflow turns registers their BODIES explicitly —
+synchronous replay functions returning commands. Source:
+`docs/cluster/thin-workers.mdx`.
+
+### Pattern 4 — Python workers on the same control plane
+
+The BullMQ transport speaks the aviary wire byte-for-byte, so a Python worker
+can serve steps (or whole workflows) for an AdoniJS control plane over the same
+Redis:
+
+```bash
+pip install "durable-worker[redis]"
+```
+
+```python title="worker.py"
+import asyncio
+from durable_worker import Worker
+from durable_worker.redis_runner import run_redis_worker
+
+worker = Worker()
+
+@worker.step("payments.charge-card")
+async def charge(data):
+    res = await stripe.charge(data["orderId"], data["amountCents"])
+    return {"chargeId": res.id}
+
+async def main():
+    await run_redis_worker(worker, connection="redis://localhost:6379")
+    await asyncio.Event().wait()
+
+asyncio.run(main())
+```
+
+Connection and prefix must match on both sides; sharing a broker across
+deployments means setting the same `partition` on both sides (queues become
+`<name>@<partition>`). Start Python workflows from Adonis by name:
+`engine.start('pipeline', input, id)` — if no worker serves the name, the start
+fails fast rather than hanging. Source: `docs/python.mdx`,
+`docs/cluster/interop.mdx`.
+
+## Common mistakes
+
+### HIGH launching `durable:worker` on a store-backed role
+
+Wrong:
+
+```bash
+node ace durable:worker   # on a standalone/control-plane pod
+```
+
+Correct:
+
+```bash
+node ace durable:work     # the store-backed dispatch/recovery/timers/schedules loop
+```
+
+Mechanism: `durable:worker` boots the store-less `WorkerRuntime`; on a role that
+owns a store it logs a warning and refuses — the two commands are different
+topologies, not aliases. Source: `docs/cli.mdx`.
+
+### HIGH assuming `durable:worker` pods carry workflow bodies
+
+Wrong:
+
+```bash
+# expecting a tenant pod to execute workflow turns because app/workflows exists
+node ace durable:worker
+```
+
+Correct:
+
+```ts
+runtime.registerWorkflow('checkout', (ctx, input) => {
+  const paid = ctx.step('billing.charge', input)
+  return { paid }
+})
+```
+
+Mechanism: the command registers workflow NAMES from `app/workflows` (routing +
+descriptor) but not their bodies; turn execution needs explicit registration,
+and turns are synchronous replay functions by design. Source:
+`docs/cluster/thin-workers.mdx` (warning callout).
+
+### MEDIUM leaving a hand-built WorkerRuntime on the default NoopWorkerRegistry
+
+Wrong:
+
+```ts
+const runtime = new WorkerRuntime({ transport, partition: 'acme' }) // registry defaults to noop
+```
+
+Correct:
+
+```ts
+const runtime = new WorkerRuntime({
+  transport,
+  partition: 'acme',
+  registry: new RedisWorkerRegistry(redis, { ownsConnection: true }),
+})
+```
+
+Mechanism: without a registry the descriptor/heartbeat go nowhere — the worker
+executes fine but is invisible to capability-aware routing, so any step with
+`requires` will never be dispatched to it. Source:
+`docs/cluster/thin-workers.mdx` options table.
+
+### MEDIUM letting a partition-less local process join a shared broker
+
+Wrong:
+
+```ts
+// laptop dev against the production Redis:
+transports.bullmq({ connection: REDIS_URL })
+```
+
+Correct:
+
+```ts
+transports.bullmq({ connection: REDIS_URL, partition: 'david-dev' })
+```
+
+Mechanism: a worker on no partition serves the bare `<name>` tokens — exactly
+the queues the deployed fleet consumes — so the local process steals production
+tasks; docs call this out under Tenancy pitfalls ("competes for, and steals, the
+deployed fleet's tasks"). Source: `docs/concepts/tenancy.mdx`.
+
+### MEDIUM stamping runs into a namespace nothing polls
+
+Wrong:
+
+```ts
+await engine.start('checkout', order, id, { namespace: 'eu-west' }) // no engine/operator polls eu-west
+```
+
+Correct:
+
+```ts
+// Run at least one engine on 'eu-west' (or an operator above it) first:
+await engine.start('checkout', order, id, { namespace: 'eu-west' })
+```
+
+Mechanism: between namespaced engines there is no fallback owner; a namespace
+with neither an engine of its own nor an operator above it is a dead end where
+runs sit `pending` forever. Source: `docs/concepts/tenancy.mdx` (pitfalls).
+
+See also: `durable-setup` — the standalone execution model this scales out of.
+See also: `durable-transports-stores` — bullmq/queue/db driver details,
+namespace mechanics.