@adonis-agora/durable 0.10.0 → 0.11.0

package/dist/src/transports/bullmq/deps.js

@@ -0,0 +1,41 @@
+/**
+ * The tiny broker surface the {@link import('./bullmq-transport.js').BullMQTransport} depends on, and
+ * the real-`bullmq` implementation of it. Splitting the concrete broker behind these structural
+ * interfaces is what keeps the transport itself PURE and unit-testable with fakes — and lets the
+ * package build/test without `bullmq` installed, since the only place that touches the real dependency
+ * is {@link createBullMQDeps}, which `import()`s it LAZILY (so a non-bullmq fleet never loads it).
+ */
+/**
+ * Build the real bullmq/ioredis-backed {@link BullMQDeps} for `connection` (ioredis `ConnectionOptions`
+ * or a `Redis` instance) at a `concurrency`. `bullmq` and `ioredis` are imported LAZILY here — via a
+ * non-literal specifier so the package type-checks and unit-tests without them installed — and only
+ * this call (i.e. only when the transport is actually selected + run) pulls them in.
+ *
+ * Workers require `maxRetriesPerRequest: null`; a plain-options connection is cloned with it set (a
+ * passed-in `Redis` instance is preserved as-is). A standalone client for pub/sub / heartbeat keys is
+ * a `duplicate()` of a passed-in instance, or a fresh client with a keepalive floor from the options.
+ */
+export async function createBullMQDeps(connection, concurrency = 1) {
+    // Non-literal specifiers: keep `tsc` from resolving 'bullmq'/'ioredis' at build time (they are a
+    // runtime-only dependency of the selected transport), so the wider package builds without them.
+    const bullmqSpecifier = 'bullmq';
+    const ioredisSpecifier = 'ioredis';
+    const { Queue, Worker } = (await import(bullmqSpecifier));
+    const { Redis } = (await import(ioredisSpecifier));
+    const isRedisInstance = (value) => value instanceof Redis;
+    // Workers require `maxRetriesPerRequest: null`; preserve a passed-in Redis instance as-is.
+    const workerConnection = () => connection && typeof connection === 'object' && !('options' in connection)
+        ? { ...connection, maxRetriesPerRequest: null }
+        : connection;
+    const makeRedis = () => {
+        if (isRedisInstance(connection))
+            return connection.duplicate();
+        return new Redis({ keepAlive: 10_000, ...connection });
+    };
+    return {
+        makeQueue: (name) => new Queue(name, { connection }),
+        makeWorker: (name, process) => new Worker(name, (job) => process(job), { connection: workerConnection(), concurrency }),
+        makeRedis,
+    };
+}
+//# sourceMappingURL=deps.js.map

package/dist/src/transports/bullmq/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../../../src/transports/bullmq/deps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgDH;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAmB,EAAE,WAAW,GAAG,CAAC;IACzE,iGAAiG;IACjG,gGAAgG;IAChG,MAAM,eAAe,GAAG,QAAQ,CAAC;IACjC,MAAM,gBAAgB,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAGvD,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAEhD,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,KAAc,EAAmD,EAAE,CAC1F,KAAK,YAAa,KAA8D,CAAC;IAEnF,2FAA2F;IAC3F,MAAM,gBAAgB,GAAG,GAAY,EAAE,CACrC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,UAAU,CAAC;QACxE,CAAC,CAAC,EAAE,GAAI,UAAqB,EAAE,oBAAoB,EAAE,IAAI,EAAE;QAC3D,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,SAAS,GAAG,GAAc,EAAE;QAChC,IAAI,eAAe,CAAC,UAAU,CAAC;YAAE,OAAO,UAAU,CAAC,SAAS,EAAE,CAAC;QAC/D,OAAO,IAAI,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAI,UAAqB,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC;QACpD,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAC5B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,EAAE,WAAW,EAAE,CAAC;QAC1F,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/src/transports/bullmq/index.d.ts

@@ -0,0 +1,5 @@
+export { BullMQTransport, type BullMQTransportOptions } from './bullmq-transport.js';
+export { type BullMQDeps, type JobLike, type ProcessFn, type QueueLike, type RedisLike, type WorkerLike, createBullMQDeps, } from './deps.js';
+export * from './naming.js';
+export * from './serialization.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/transports/bullmq/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/transports/bullmq/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EACL,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/src/transports/bullmq/index.js

@@ -0,0 +1,5 @@
+export { BullMQTransport } from './bullmq-transport.js';
+export { createBullMQDeps, } from './deps.js';
+export * from './naming.js';
+export * from './serialization.js';
+//# sourceMappingURL=index.js.map

package/dist/src/transports/bullmq/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/transports/bullmq/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA+B,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAOL,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/src/transports/bullmq/naming.d.ts

@@ -0,0 +1,71 @@
+import { sanitizeQueueToken, tenantGroup } from '../../tenant-group.js';
+/**
+ * Broker naming for the aviary-compatible BullMQ transport — the byte-for-byte queue / channel / key
+ * names a Python aviary worker (or a NestJS `BullMQTransport`) also computes, so a mixed-language
+ * fleet lands on the SAME Redis keys. Every name is derived here and NOWHERE else, so a single place
+ * owns the cross-SDK contract (see docs/superpowers/specs/2026-07-17-store-less-cluster-design.md §6.1).
+ *
+ * These are pure string builders (no Redis, no bullmq) so they unit-test in isolation and the wire
+ * naming can be proven byte-identical to the golden fixtures without a broker.
+ */
+/** Re-exported so a caller computing a routing token uses the exact same sanitize/suffix rules. */
+export { sanitizeQueueToken, tenantGroup };
+/**
+ * The prefix every name is built from, folding in the deployment namespace per the cross-SDK rule: a
+ * set, non-`"default"` namespace appends `-<namespace>`; an unset or `"default"` namespace yields the
+ * bare prefix (so the un-namespaced and `"default"` schemes are BYTE-IDENTICAL — production names
+ * never change). Keep ALL name builders routed through this; a single direct `prefix` concat would
+ * land a worker on a different queue than the engine and silently split the fleet.
+ */
+export declare function effectivePrefix(prefix: string, namespace: string | undefined): string;
+/**
+ * The final routing token a step/workflow `name` dispatches to / a worker subscribes on:
+ * `tenantGroup(sanitizeQueueToken(name), partition)`. `:`→`-` (BullMQ forbids `:` in a queue name),
+ * `.` kept, and a non-empty/non-`default` partition suffixes `@<partition>`. Apply IDENTICALLY at
+ * dispatch and subscribe or a step routes to one token and is served from another (silently never run).
+ */
+export declare function routingToken(name: string, partition: string | undefined): string;
+/** `${P}-tasks-${token}` — the per-routing-token task queue (jobs `task` / `workflow`). */
+export declare function tasksName(effPrefix: string, token: string): string;
+/** `${P}-results` — the shared step-result queue (job `result`). */
+export declare function resultsName(effPrefix: string): string;
+/** `${P}-decisions` — the workflow-decision queue (job `decision`). */
+export declare function decisionsName(effPrefix: string): string;
+/** `${P}-step-events` — the streamed local-step-lifecycle queue (job `stepEvent`). */
+export declare function stepEventsName(effPrefix: string): string;
+/** `${P}-heartbeat` — the run / long-step liveness pub/sub channel. */
+export declare function heartbeatChannel(effPrefix: string): string;
+/**
+ * `${P}-control` — the control-plane broadcast channel. Provided ONLY so tests can assert the name;
+ * the transport does NOT publish/subscribe it (the shipped `RedisControlPlane` owns the control
+ * plane). Kept here so the one place that knows the naming contract stays authoritative.
+ */
+export declare function controlChannel(effPrefix: string): string;
+/** `${P}-start-run` — the queue a store-less tenant enqueues start-run requests on (job `startRun`). */
+export declare function startRunName(effPrefix: string): string;
+/** `${P}-run-request` — the queue a store-less tenant enqueues read/control requests on (job `runRequest`). */
+export declare function runRequestName(effPrefix: string): string;
+/** `${P}-run-reply` — the shared pub/sub channel the control plane publishes {@link RunReply}s on;
+ *  every tenant subscribes and filters by `requestId` client-side. */
+export declare function runReplyChannel(effPrefix: string): string;
+/** `${P}-tenant-events-${tenant}` — the per-tenant pub/sub channel the control plane re-publishes a
+ *  tenant's lifecycle events on, so a store-less tenant live-tails only ITS OWN runs. */
+export declare function tenantEventsChannel(effPrefix: string, tenant: string): string;
+/** Common prefix of every worker-liveness key (used to SCAN for live routing tokens). */
+export declare function workerHeartbeatKeyPrefix(effPrefix: string): string;
+/**
+ * `${P}-worker-heartbeat:${token}:${instanceId}` — one TTL'd liveness key per (routing token,
+ * instance). Its ABSENCE (expiry) is the "worker gone/stalled" signal a monitor watches. Neither the
+ * token nor the instanceId carries a `:` here, so the token is the segment between the fixed prefix
+ * and the next `:` — the parse `listWorkerGroups` relies on.
+ */
+export declare function workerHeartbeatKey(effPrefix: string, token: string, instanceId: string): string;
+/**
+ * Prefix of every full-descriptor key on a routing `token`: `${P}-worker-descriptor:${token}:` —
+ * used to SCAN the live {@link import('../../handshake/descriptor.js').WorkerDescriptor}s a worker
+ * runtime publishes per token (design §7.2). BYTE-IDENTICAL to the worker-runtime's `workerDescriptorKey`
+ * layout (`${P}-worker-descriptor:<token>:<instance>`), computed here too so the transport reads the
+ * descriptor keyspace without reaching into the worker subpath.
+ */
+export declare function workerDescriptorTokenPrefix(effPrefix: string, token: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/src/transports/bullmq/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../../src/transports/bullmq/naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;GAQG;AAEH,mGAAmG;AACnG,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEhF;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;sEACsE;AACtE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;yFACyF;AACzF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpF"}

package/dist/src/transports/bullmq/naming.js

@@ -0,0 +1,101 @@
+import { sanitizeQueueToken, tenantGroup } from '../../tenant-group.js';
+/**
+ * Broker naming for the aviary-compatible BullMQ transport — the byte-for-byte queue / channel / key
+ * names a Python aviary worker (or a NestJS `BullMQTransport`) also computes, so a mixed-language
+ * fleet lands on the SAME Redis keys. Every name is derived here and NOWHERE else, so a single place
+ * owns the cross-SDK contract (see docs/superpowers/specs/2026-07-17-store-less-cluster-design.md §6.1).
+ *
+ * These are pure string builders (no Redis, no bullmq) so they unit-test in isolation and the wire
+ * naming can be proven byte-identical to the golden fixtures without a broker.
+ */
+/** Re-exported so a caller computing a routing token uses the exact same sanitize/suffix rules. */
+export { sanitizeQueueToken, tenantGroup };
+/**
+ * The prefix every name is built from, folding in the deployment namespace per the cross-SDK rule: a
+ * set, non-`"default"` namespace appends `-<namespace>`; an unset or `"default"` namespace yields the
+ * bare prefix (so the un-namespaced and `"default"` schemes are BYTE-IDENTICAL — production names
+ * never change). Keep ALL name builders routed through this; a single direct `prefix` concat would
+ * land a worker on a different queue than the engine and silently split the fleet.
+ */
+export function effectivePrefix(prefix, namespace) {
+    return namespace && namespace !== 'default' ? `${prefix}-${namespace}` : prefix;
+}
+/**
+ * The final routing token a step/workflow `name` dispatches to / a worker subscribes on:
+ * `tenantGroup(sanitizeQueueToken(name), partition)`. `:`→`-` (BullMQ forbids `:` in a queue name),
+ * `.` kept, and a non-empty/non-`default` partition suffixes `@<partition>`. Apply IDENTICALLY at
+ * dispatch and subscribe or a step routes to one token and is served from another (silently never run).
+ */
+export function routingToken(name, partition) {
+    return tenantGroup(sanitizeQueueToken(name), partition);
+}
+/** `${P}-tasks-${token}` — the per-routing-token task queue (jobs `task` / `workflow`). */
+export function tasksName(effPrefix, token) {
+    return `${effPrefix}-tasks-${token}`;
+}
+/** `${P}-results` — the shared step-result queue (job `result`). */
+export function resultsName(effPrefix) {
+    return `${effPrefix}-results`;
+}
+/** `${P}-decisions` — the workflow-decision queue (job `decision`). */
+export function decisionsName(effPrefix) {
+    return `${effPrefix}-decisions`;
+}
+/** `${P}-step-events` — the streamed local-step-lifecycle queue (job `stepEvent`). */
+export function stepEventsName(effPrefix) {
+    return `${effPrefix}-step-events`;
+}
+/** `${P}-heartbeat` — the run / long-step liveness pub/sub channel. */
+export function heartbeatChannel(effPrefix) {
+    return `${effPrefix}-heartbeat`;
+}
+/**
+ * `${P}-control` — the control-plane broadcast channel. Provided ONLY so tests can assert the name;
+ * the transport does NOT publish/subscribe it (the shipped `RedisControlPlane` owns the control
+ * plane). Kept here so the one place that knows the naming contract stays authoritative.
+ */
+export function controlChannel(effPrefix) {
+    return `${effPrefix}-control`;
+}
+/** `${P}-start-run` — the queue a store-less tenant enqueues start-run requests on (job `startRun`). */
+export function startRunName(effPrefix) {
+    return `${effPrefix}-start-run`;
+}
+/** `${P}-run-request` — the queue a store-less tenant enqueues read/control requests on (job `runRequest`). */
+export function runRequestName(effPrefix) {
+    return `${effPrefix}-run-request`;
+}
+/** `${P}-run-reply` — the shared pub/sub channel the control plane publishes {@link RunReply}s on;
+ *  every tenant subscribes and filters by `requestId` client-side. */
+export function runReplyChannel(effPrefix) {
+    return `${effPrefix}-run-reply`;
+}
+/** `${P}-tenant-events-${tenant}` — the per-tenant pub/sub channel the control plane re-publishes a
+ *  tenant's lifecycle events on, so a store-less tenant live-tails only ITS OWN runs. */
+export function tenantEventsChannel(effPrefix, tenant) {
+    return `${effPrefix}-tenant-events-${tenant}`;
+}
+/** Common prefix of every worker-liveness key (used to SCAN for live routing tokens). */
+export function workerHeartbeatKeyPrefix(effPrefix) {
+    return `${effPrefix}-worker-heartbeat:`;
+}
+/**
+ * `${P}-worker-heartbeat:${token}:${instanceId}` — one TTL'd liveness key per (routing token,
+ * instance). Its ABSENCE (expiry) is the "worker gone/stalled" signal a monitor watches. Neither the
+ * token nor the instanceId carries a `:` here, so the token is the segment between the fixed prefix
+ * and the next `:` — the parse `listWorkerGroups` relies on.
+ */
+export function workerHeartbeatKey(effPrefix, token, instanceId) {
+    return `${workerHeartbeatKeyPrefix(effPrefix)}${token}:${instanceId}`;
+}
+/**
+ * Prefix of every full-descriptor key on a routing `token`: `${P}-worker-descriptor:${token}:` —
+ * used to SCAN the live {@link import('../../handshake/descriptor.js').WorkerDescriptor}s a worker
+ * runtime publishes per token (design §7.2). BYTE-IDENTICAL to the worker-runtime's `workerDescriptorKey`
+ * layout (`${P}-worker-descriptor:<token>:<instance>`), computed here too so the transport reads the
+ * descriptor keyspace without reaching into the worker subpath.
+ */
+export function workerDescriptorTokenPrefix(effPrefix, token) {
+    return `${effPrefix}-worker-descriptor:${token}:`;
+}
+//# sourceMappingURL=naming.js.map

package/dist/src/transports/bullmq/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../../../src/transports/bullmq/naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;GAQG;AAEH,mGAAmG;AACnG,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,SAA6B;IAC3E,OAAO,SAAS,IAAI,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAClF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAA6B;IACtE,OAAO,WAAW,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,KAAa;IACxD,OAAO,GAAG,SAAS,UAAU,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,GAAG,SAAS,UAAU,CAAC;AAChC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,GAAG,SAAS,YAAY,CAAC;AAClC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,GAAG,SAAS,cAAc,CAAC;AACpC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,GAAG,SAAS,YAAY,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,GAAG,SAAS,UAAU,CAAC;AAChC,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,GAAG,SAAS,YAAY,CAAC;AAClC,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,GAAG,SAAS,cAAc,CAAC;AACpC,CAAC;AAED;sEACsE;AACtE,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,GAAG,SAAS,YAAY,CAAC;AAClC,CAAC;AAED;yFACyF;AACzF,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,MAAc;IACnE,OAAO,GAAG,SAAS,kBAAkB,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,OAAO,GAAG,SAAS,oBAAoB,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,KAAa,EAAE,UAAkB;IACrF,OAAO,GAAG,wBAAwB,CAAC,SAAS,CAAC,GAAG,KAAK,IAAI,UAAU,EAAE,CAAC;AACxE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAiB,EAAE,KAAa;IAC1E,OAAO,GAAG,SAAS,sBAAsB,KAAK,GAAG,CAAC;AACpD,CAAC"}

package/dist/src/transports/bullmq/serialization.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Map the engine's per-call `priority` (higher = more urgent, default/absent = unprioritised) onto a
+ * BullMQ job `priority` (lower = more urgent). Returns `undefined` for an absent priority so the
+ * default FIFO path is untouched. `clamp(round(1_048_576 - priority), 1, 2_097_151)` — byte-identical
+ * to the aviary transport (spec §6.3).
+ */
+export declare function toBrokerPriority(priority?: number): number | undefined;
+/** Worker-liveness heartbeat cadence: refresh every 10s, key TTL 35s (comfortably > interval so one
+ *  slow refresh doesn't flap). Matches the aviary/Python `_HEARTBEAT_*` constants. */
+export declare const WORKER_HEARTBEAT_INTERVAL_MS = 10000;
+export declare const WORKER_HEARTBEAT_TTL_SECONDS = 35;
+/** How long a FAILED task job's payload is retained before BullMQ GCs it — long enough for a peer's
+ *  stalled-check + the terminal-failure bridge to read its `RemoteTask`, bounded so failures don't
+ *  accumulate. 24h, matching aviary's `TASK_FAILED_RETENTION_SECONDS`. */
+export declare const TASK_FAILED_RETENTION_SECONDS: number;
+/**
+ * Stable per-process id stamped on the worker-heartbeat keys: `ts-<host>-<pid>` (the Python SDK uses
+ * `py-<host>-<pid>`), so N replicas of a group each show as a distinct worker and a reader can tell
+ * which runtime a worker is. Args are injectable for a deterministic test.
+ */
+export declare function buildInstanceId(host?: string, pid?: number): string;
+/** BullMQ `add` options for a NON-task job (result/decision/stepEvent): `removeOnComplete`/
+ *  `removeOnFail` both `true` (spec §6.3), plus a translated `priority` only when set. */
+export interface JobOptions {
+    removeOnComplete: true;
+    removeOnFail: true;
+    priority?: number;
+}
+export declare function jobOptions(priority?: number): JobOptions;
+/** BullMQ `add` options for a TASK job (step/workflow dispatch): like {@link jobOptions} but
+ *  `removeOnFail` is age-bounded retention (`{ age: 86400 }`) so a crashed worker's failed job keeps
+ *  its `RemoteTask` payload long enough for the terminal-failure bridge to rebuild a StepResult. */
+export interface TaskJobOptions {
+    removeOnComplete: true;
+    removeOnFail: {
+        age: number;
+    };
+    priority?: number;
+}
+export declare function taskJobOptions(priority?: number): TaskJobOptions;
+/**
+ * The value written to a worker-liveness key: JSON `{"ts": <epochMs>}`. Epoch MILLISECONDS (readers
+ * normalise seconds→ms only as a legacy fallback). Byte-compatible with the Python worker's minimal
+ * form and accepted by the aviary reader (which tolerates a missing `status`).
+ */
+export declare function heartbeatKeyValue(nowMs?: number): string;
+/**
+ * Parse a worker-heartbeat key value into `{ lastBeatAt }`, accepting BOTH the `{"ts":…}` JSON (this
+ * SDK / newer SDKs) and an older bare timestamp string (the Python SDK's seconds / a legacy ms value).
+ * A bare number or a `ts` below {@link EPOCH_MS_THRESHOLD} is treated as seconds and scaled to ms.
+ * Robust to a missing/garbled value (→ `lastBeatAt: 0`).
+ */
+export declare function parseHeartbeatValue(raw: string | null): {
+    lastBeatAt: number;
+};
+//# sourceMappingURL=serialization.d.ts.map

package/dist/src/transports/bullmq/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../../src/transports/bullmq/serialization.ts"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAItE;AAED;sFACsF;AACtF,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;0EAE0E;AAC1E,eAAO,MAAM,6BAA6B,QAAe,CAAC;AAM1D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAmB,EAAE,GAAG,GAAE,MAAoB,GAAG,MAAM,CAE5F;AAED;0FAC0F;AAC1F,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,IAAI,CAAC;IACvB,YAAY,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAOxD;AAED;;oGAEoG;AACpG,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,IAAI,CAAC;IACvB,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAOhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,MAAmB,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAkB9E"}

package/dist/src/transports/bullmq/serialization.js

@@ -0,0 +1,101 @@
+import { hostname } from 'node:os';
+/**
+ * Serialization for the aviary-compatible BullMQ transport — the byte-for-byte job options, priority
+ * mapping, instance id and worker-heartbeat value a Python aviary worker (or a NestJS
+ * `BullMQTransport`) also produce/consume. Pure (no bullmq, no Redis) so the wire contract is proven
+ * against the golden fixtures without a broker.
+ *
+ * The wire DTOs themselves (`RemoteTask`/`StepResult`/`Heartbeat`/`WorkflowTask`/…) cross the queue
+ * as PLAIN JSON with NO envelope — the DTO **is** the BullMQ job's `data` (BullMQ `JSON.stringify`s it
+ * into the job hash). Their dates are already epoch-ms numbers and their optionals are omitted when
+ * absent, so a straight `queue.add(jobName, dto, opts)` is byte-identical across SDKs; there is no
+ * transform to apply here beyond the job OPTIONS below.
+ */
+// BullMQ priority is the INVERSE of the durable engine's: BullMQ runs the LOWEST number first
+// (1..2_097_151), while the engine's admission `priority` is "higher wins". Translate so one
+// convention ("higher = more urgent") holds end-to-end. `BASELINE - p` keeps relative order (a higher
+// `p` yields a lower — more urgent — BullMQ number), clamped into BullMQ's valid range, centred on the
+// range midpoint so callers have headroom both above and below the default.
+const BROKER_PRIORITY_MAX = 2_097_151;
+const BROKER_PRIORITY_BASELINE = 1_048_576;
+/**
+ * Map the engine's per-call `priority` (higher = more urgent, default/absent = unprioritised) onto a
+ * BullMQ job `priority` (lower = more urgent). Returns `undefined` for an absent priority so the
+ * default FIFO path is untouched. `clamp(round(1_048_576 - priority), 1, 2_097_151)` — byte-identical
+ * to the aviary transport (spec §6.3).
+ */
+export function toBrokerPriority(priority) {
+    if (priority == null)
+        return undefined;
+    const mapped = Math.round(BROKER_PRIORITY_BASELINE - priority);
+    return Math.min(BROKER_PRIORITY_MAX, Math.max(1, mapped));
+}
+/** Worker-liveness heartbeat cadence: refresh every 10s, key TTL 35s (comfortably > interval so one
+ *  slow refresh doesn't flap). Matches the aviary/Python `_HEARTBEAT_*` constants. */
+export const WORKER_HEARTBEAT_INTERVAL_MS = 10_000;
+export const WORKER_HEARTBEAT_TTL_SECONDS = 35;
+/** How long a FAILED task job's payload is retained before BullMQ GCs it — long enough for a peer's
+ *  stalled-check + the terminal-failure bridge to read its `RemoteTask`, bounded so failures don't
+ *  accumulate. 24h, matching aviary's `TASK_FAILED_RETENTION_SECONDS`. */
+export const TASK_FAILED_RETENTION_SECONDS = 24 * 60 * 60;
+// Epoch values below this are seconds (Python's `time.time()`), at/above are milliseconds (the TS
+// SDKs). Normalise to ms. ~1e12 ms ≈ year 2001; ~1e12 s is year 33658 — unambiguous.
+const EPOCH_MS_THRESHOLD = 1e12;
+/**
+ * Stable per-process id stamped on the worker-heartbeat keys: `ts-<host>-<pid>` (the Python SDK uses
+ * `py-<host>-<pid>`), so N replicas of a group each show as a distinct worker and a reader can tell
+ * which runtime a worker is. Args are injectable for a deterministic test.
+ */
+export function buildInstanceId(host = hostname(), pid = process.pid) {
+    return `ts-${host}-${pid}`;
+}
+export function jobOptions(priority) {
+    const brokerPriority = toBrokerPriority(priority);
+    return {
+        removeOnComplete: true,
+        removeOnFail: true,
+        ...(brokerPriority != null ? { priority: brokerPriority } : {}),
+    };
+}
+export function taskJobOptions(priority) {
+    const brokerPriority = toBrokerPriority(priority);
+    return {
+        removeOnComplete: true,
+        removeOnFail: { age: TASK_FAILED_RETENTION_SECONDS },
+        ...(brokerPriority != null ? { priority: brokerPriority } : {}),
+    };
+}
+/**
+ * The value written to a worker-liveness key: JSON `{"ts": <epochMs>}`. Epoch MILLISECONDS (readers
+ * normalise seconds→ms only as a legacy fallback). Byte-compatible with the Python worker's minimal
+ * form and accepted by the aviary reader (which tolerates a missing `status`).
+ */
+export function heartbeatKeyValue(nowMs = Date.now()) {
+    return JSON.stringify({ ts: nowMs });
+}
+/**
+ * Parse a worker-heartbeat key value into `{ lastBeatAt }`, accepting BOTH the `{"ts":…}` JSON (this
+ * SDK / newer SDKs) and an older bare timestamp string (the Python SDK's seconds / a legacy ms value).
+ * A bare number or a `ts` below {@link EPOCH_MS_THRESHOLD} is treated as seconds and scaled to ms.
+ * Robust to a missing/garbled value (→ `lastBeatAt: 0`).
+ */
+export function parseHeartbeatValue(raw) {
+    if (raw == null)
+        return { lastBeatAt: 0 };
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return { lastBeatAt: 0 };
+    const toMs = (n) => Number.isFinite(n) ? (n < EPOCH_MS_THRESHOLD ? n * 1000 : n) : 0;
+    // Old bare-number form (no JSON braces): a plain ms/seconds timestamp.
+    if (!trimmed.startsWith('{'))
+        return { lastBeatAt: toMs(Number(trimmed)) };
+    try {
+        const parsed = JSON.parse(trimmed);
+        return { lastBeatAt: typeof parsed.ts === 'number' ? toMs(parsed.ts) : 0 };
+    }
+    catch {
+        // Malformed JSON — fall back to a numeric read so a partially-written value still yields a beat.
+        return { lastBeatAt: toMs(Number(trimmed)) };
+    }
+}
+//# sourceMappingURL=serialization.js.map

package/dist/src/transports/bullmq/serialization.js.map

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

package/dist/src/transports/factory.d.ts

@@ -61,6 +61,29 @@ export interface QueueTransportConfig {
     /** Stable id for this process (stamped on heartbeats / control `from`). Default a random id. */
     instanceId?: string;
 }
+/** Options for the aviary-compatible BullMQ transport (the cross-ecosystem interop path). */
+export interface BullMQTransportConfig {
+    /**
+     * ioredis connection — `ConnectionOptions` (host/port/…) or a `Redis` instance — handed straight to
+     * BullMQ and ioredis. Required: this transport talks to a real Redis (that is the whole point of the
+     * cross-language path). Typed loosely (`unknown`) so the `bullmq`/`ioredis` types are not pulled into
+     * the config surface of a fleet that never selects this transport.
+     */
+    connection: unknown;
+    /**
+     * Logical isolation partition suffixing every per-handler tasks queue this instance subscribes to.
+     * Unset routes each handler to the bare (sanitized) handler name.
+     */
+    partition?: string;
+    /** Key prefix namespacing the durable queues. Default `durable`. */
+    prefix?: string;
+    /** Logical deployment namespace, segmenting every queue/channel/key. `"default"`/absent = unchanged. */
+    namespace?: string;
+    /** How many tasks a worker runs concurrently from each of its queues (BullMQ `Worker` concurrency). Default 1. */
+    concurrency?: number;
+    /** Stable id for this process (stamped on the worker-liveness keys). Default `ts-<host>-<pid>`. */
+    instanceId?: string;
+}
 /** Options for the DB-table-backed (`@adonisjs/lucid`) transport. */
 export interface DbTransportConfig {
     /** Worker group this instance serves (required on a worker process to register handlers). */
@@ -94,6 +117,14 @@ export declare const transports: {
     eventEmitter(config?: EventEmitterTransportConfig): TransportFactory;
     /** Run remote steps cross-process over `@adonisjs/queue`, using a connection from `config/queue.ts`. */
     queue(config?: QueueTransportConfig): TransportFactory;
+    /**
+     * Run remote steps + workflow tasks cross-process AND cross-ecosystem over the real `bullmq` npm
+     * package, byte-compatible with the aviary (`nestjs-durable`) BullMQ transport and its Python
+     * raw-redis worker — so an Adonis engine and a Python/NestJS worker interoperate on one Redis. Pair
+     * it with `controlPlanes.redis(...)` for the `${prefix}-control` broadcast (this transport does not
+     * reimplement the control plane). `bullmq`/`ioredis` are imported lazily, only when selected.
+     */
+    bullmq(config: BullMQTransportConfig): TransportFactory;
     /** Run remote steps cross-process over the app's database, using `@adonisjs/lucid` — no broker. */
     db(config?: DbTransportConfig): TransportFactory;
 };

package/dist/src/transports/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/transports/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIhE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,GAAG,EAAE;QACH,SAAS,EAAE;YAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;SAAE,CAAC;QACxD,MAAM,EAAE;YAAE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;SAAE,CAAC;KACtD,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;CAErC;AAED,yFAAyF;AACzF,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+GAA+G;IAC/G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4GAA4G;IAC5G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyDD,eAAO,MAAM,UAAU;IACrB;;;;OAIG;qBACa,qBAAqB,GAAQ,gBAAgB;IAI7D;;;;;OAKG;0BACkB,2BAA2B,GAAQ,gBAAgB;IAUxE,wGAAwG;mBAC1F,oBAAoB,GAAQ,gBAAgB;IAc1D,mGAAmG;gBACxF,iBAAiB,GAAQ,gBAAgB;CAgBrD,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/transports/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIhE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,GAAG,EAAE;QACH,SAAS,EAAE;YAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;SAAE,CAAC;QACxD,MAAM,EAAE;YAAE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;SAAE,CAAC;KACtD,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;CAErC;AAED,yFAAyF;AACzF,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+GAA+G;IAC/G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6FAA6F;AAC7F,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wGAAwG;IACxG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kHAAkH;IAClH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4GAA4G;IAC5G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyDD,eAAO,MAAM,UAAU;IACrB;;;;OAIG;qBACa,qBAAqB,GAAQ,gBAAgB;IAI7D;;;;;OAKG;0BACkB,2BAA2B,GAAQ,gBAAgB;IAUxE,wGAAwG;mBAC1F,oBAAoB,GAAQ,gBAAgB;IAc1D;;;;;;OAMG;mBACY,qBAAqB,GAAG,gBAAgB;IAevD,mGAAmG;gBACxF,iBAAiB,GAAQ,gBAAgB;CAgBrD,CAAC"}

package/dist/src/transports/factory.js

@@ -56,6 +56,27 @@ export const transports = {
             });
         };
     },
+    /**
+     * Run remote steps + workflow tasks cross-process AND cross-ecosystem over the real `bullmq` npm
+     * package, byte-compatible with the aviary (`nestjs-durable`) BullMQ transport and its Python
+     * raw-redis worker — so an Adonis engine and a Python/NestJS worker interoperate on one Redis. Pair
+     * it with `controlPlanes.redis(...)` for the `${prefix}-control` broadcast (this transport does not
+     * reimplement the control plane). `bullmq`/`ioredis` are imported lazily, only when selected.
+     */
+    bullmq(config) {
+        return async () => {
+            const { BullMQTransport } = await import('./bullmq/bullmq-transport.js');
+            const { createBullMQDeps } = await import('./bullmq/deps.js');
+            const deps = await createBullMQDeps(config.connection, config.concurrency ?? 1);
+            return new BullMQTransport({
+                deps,
+                ...(config.partition !== undefined ? { partition: config.partition } : {}),
+                ...(config.prefix !== undefined ? { prefix: config.prefix } : {}),
+                ...(config.namespace !== undefined ? { namespace: config.namespace } : {}),
+                ...(config.instanceId !== undefined ? { instanceId: config.instanceId } : {}),
+            });
+        };
+    },
     /** Run remote steps cross-process over the app's database, using `@adonisjs/lucid` — no broker. */
     db(config = {}) {
         return async (ctx) => {

package/dist/src/transports/factory.js.map

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

package/dist/src/worker-runtime/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `@adonis-agora/durable/worker` — the LEAN, store-less worker entry (design §4 packaging).
+ *
+ * This module and its whole transitive graph import NO Lucid (and no store at all), so a thin worker
+ * pod's dependency graph stays lean without a separate package. That store-less-ness is a STRUCTURAL
+ * fact enforced by the `no-lucid` test (test/worker-runtime/no-lucid.spec.ts), not a convention: it
+ * walks this module's transitive `import` graph and fails if `@adonisjs/lucid` (or any store module)
+ * ever appears. Keep it that way — only add imports that are themselves Lucid-free.
+ *
+ * A thin worker: build a transport (e.g. the wave-1 `BullMQTransport`), construct a {@link WorkerRuntime}
+ * over it, register `app/steps` (and advertise `app/workflows` names) via the re-exported
+ * `step-discovery` helpers, then `runtime.start()`. The `node ace durable:worker` command wires exactly
+ * this from `config/durable.ts`.
+ */
+export { WorkerRuntime, WORKER_SDK, type WorkerRuntimeOptions, type WorkerTransport, type WorkerRuntimeLogger, } from './worker-runtime.js';
+export { NoopWorkerRegistry, RedisWorkerRegistry, type WorkerRegistry, type DescriptorRedis, } from './registry.js';
+export { workerDescriptorKey, workerDescriptorKeyPrefix, workerHeartbeatKey, effectivePrefix, routingToken, } from './naming.js';
+export { CURRENT_PROTOCOL_VERSION, descriptorHash, heartbeatStatus, normalizeDescriptor, type WorkerDescriptor, type HeartbeatStatus, type WorkerLifecycle, } from '../handshake/descriptor.js';
+export { registerStep, registerSteps, registerStepsFromDir, registerStepsFromBarrel, collectSteps, type StepServer, type DiscoveredStep, type StepsBarrel, } from '../step-discovery.js';
+export { runStepHandler, type StepHandler } from '../protocol.js';
+export { runWorkflowTurn, isWorkflowTask, WorkflowStepFailedError, WorkflowGatherFailedError, WorkflowNondeterminismError, WorkflowTurnCancelled, type WorkflowTurnCtx, type WorkflowBody, type WorkflowBodyResolver, type WorkflowTurnHandler, type RunWorkflowTurnOptions, type GatherMode, type GatherCall, type GatherItemError, } from '../workflow-turn.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/worker-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/worker-runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,aAAa,EACb,UAAU,EACV,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlE,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/src/worker-runtime/index.js

@@ -0,0 +1,27 @@
+/**
+ * `@adonis-agora/durable/worker` — the LEAN, store-less worker entry (design §4 packaging).
+ *
+ * This module and its whole transitive graph import NO Lucid (and no store at all), so a thin worker
+ * pod's dependency graph stays lean without a separate package. That store-less-ness is a STRUCTURAL
+ * fact enforced by the `no-lucid` test (test/worker-runtime/no-lucid.spec.ts), not a convention: it
+ * walks this module's transitive `import` graph and fails if `@adonisjs/lucid` (or any store module)
+ * ever appears. Keep it that way — only add imports that are themselves Lucid-free.
+ *
+ * A thin worker: build a transport (e.g. the wave-1 `BullMQTransport`), construct a {@link WorkerRuntime}
+ * over it, register `app/steps` (and advertise `app/workflows` names) via the re-exported
+ * `step-discovery` helpers, then `runtime.start()`. The `node ace durable:worker` command wires exactly
+ * this from `config/durable.ts`.
+ */
+export { WorkerRuntime, WORKER_SDK, } from './worker-runtime.js';
+export { NoopWorkerRegistry, RedisWorkerRegistry, } from './registry.js';
+export { workerDescriptorKey, workerDescriptorKeyPrefix, workerHeartbeatKey, effectivePrefix, routingToken, } from './naming.js';
+// The handshake descriptor surface (design §7) — re-exported for worker authors; itself Lucid-free.
+export { CURRENT_PROTOCOL_VERSION, descriptorHash, heartbeatStatus, normalizeDescriptor, } from '../handshake/descriptor.js';
+// Step registration/discovery helpers (the `app/steps` convention) — Lucid-free (fs + pure metadata).
+export { registerStep, registerSteps, registerStepsFromDir, registerStepsFromBarrel, collectSteps, } from '../step-discovery.js';
+// The shared pure worker body + step-handler type (the transport funnels tasks through it).
+export { runStepHandler } from '../protocol.js';
+// The shared pure WORKFLOW-TURN body (replay history → decision) + its authoring surface — what lets a
+// store-less worker execute workflow turns (design §4). Itself Lucid-free (imports only interface types).
+export { runWorkflowTurn, isWorkflowTask, WorkflowStepFailedError, WorkflowGatherFailedError, WorkflowNondeterminismError, WorkflowTurnCancelled, } from '../workflow-turn.js';
+//# sourceMappingURL=index.js.map

package/dist/src/worker-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/worker-runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,aAAa,EACb,UAAU,GAIX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,oGAAoG;AACpG,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,mBAAmB,GAIpB,MAAM,4BAA4B,CAAC;AAEpC,sGAAsG;AACtG,OAAO,EACL,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,GAIb,MAAM,sBAAsB,CAAC;AAE9B,4FAA4F;AAC5F,OAAO,EAAE,cAAc,EAAoB,MAAM,gBAAgB,CAAC;AAElE,uGAAuG;AACvG,0GAA0G;AAC1G,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,GAStB,MAAM,qBAAqB,CAAC"}

package/dist/src/worker-runtime/naming.d.ts

@@ -0,0 +1,24 @@
+import { effectivePrefix, routingToken, workerHeartbeatKey } from '../transports/bullmq/naming.js';
+/**
+ * Broker key naming for the store-less {@link import('./worker-runtime.js').WorkerRuntime}'s two-tier
+ * advertisement (design §6.2 / §7.2). Built ON TOP of the wave-1 aviary-compatible
+ * `transports/bullmq/naming` so the worker-liveness + descriptor keys stay byte-identical across the
+ * fleet (a Python worker / NestJS control-plane computes the same names). Pure string builders — no
+ * Redis, no bullmq, no Lucid — so the worker subpath stays lean and the names unit-test in isolation.
+ *
+ * Re-exported here (rather than re-derived) so a caller in the worker subpath never has to reach into
+ * the bullmq transport package for the shared sanitize/prefix/token rules.
+ */
+export { effectivePrefix, routingToken, workerHeartbeatKey };
+/**
+ * `${P}-worker-descriptor:${token}:${instanceId}` — the full {@link WorkerDescriptor} key (design
+ * §6.2). One key per (routing token, instance): the worker publishes its whole descriptor under EACH
+ * routing token it serves, mirroring the per-token `${P}-worker-heartbeat:` liveness key so a
+ * control-plane scanning a token's keyspace finds both the compact heartbeat (with the ETag) and, when
+ * the ETag changed, the rich descriptor to re-read. Neither `token` nor `instanceId` carries a `:`, so
+ * the segments parse unambiguously — identical to {@link workerHeartbeatKey}'s layout.
+ */
+export declare function workerDescriptorKey(effPrefix: string, token: string, instanceId: string): string;
+/** Common prefix of every worker-descriptor key (for a control-plane SCAN over live descriptors). */
+export declare function workerDescriptorKeyPrefix(effPrefix: string): string;
+//# sourceMappingURL=naming.d.ts.map