@adonis-agora/durable 0.58.3 → 0.60.0

package/dist/src/transport-pool.d.ts

@@ -8,7 +8,17 @@ import type { GroupHealth, Heartbeat, NamedTransport, RemoteTask, StepResult, Tr
 export declare class TransportPool {
     private readonly transports;
     private warnedBulkRefusal;
+    /** Ids of the transports that route replies to this engine instance (see {@link routeReplies}). */
+    private readonly replying;
     constructor(transports: NamedTransport[]);
+    /**
+     * Have every transport that can ({@link Transport.consumeRepliesFor}) send this engine instance
+     * the results of the tasks it dispatches with `replyTo`. Returns whether any transport does.
+     */
+    routeReplies(instanceId: string): boolean;
+    /** `task` as sent on transport `id`: a reply goes back only on a transport that routes it, so
+     *  elsewhere `replyTo` is dropped (its result rides the shared results). */
+    private withReply;
     get size(): number;
     /** Register the engine's result/heartbeat/step-event handlers on EVERY transport — a result can come
      *  back on whichever one delivered the task, so failover stays symmetric. `onStepEvent` is wired only

package/dist/src/transport-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport-pool.d.ts","sourceRoot":"","sources":["../../src/transport-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAKzB;;;;GAIG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,UAAU;IAFvC,OAAO,CAAC,iBAAiB,CAAS;IAElC,YAA6B,UAAU,EAAE,cAAc,EAAE,EAAI;IAE7D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;qGAEiG;IACjG,IAAI,CACF,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,WAAW,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GACxD,IAAI,CAQN;IAED;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpF;IAED;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB3F;IAED;;oFAEgF;IAC1E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAajE;IAED,sGAAsG;IAChG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAO1C;IAED,0FAA0F;IAC1F,IAAI,gBAAgB,IAAI,OAAO,CAI9B;IAED,+EAA+E;IACzE,wBAAwB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO5D;IAED,8EAA8E;IACxE,uBAAuB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAO1D;IAED;;;;;OAKG;IACG,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAM1E;IAED;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIpC;IAED;uFACmF;IACnF,cAAc,IAAI,IAAI,CAIrB;IAED,+DAA+D;IAC/D,OAAO,CAAC,OAAO;CAkBhB"}
+{"version":3,"file":"transport-pool.d.ts","sourceRoot":"","sources":["../../src/transport-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAKzB;;;;GAIG;AACH,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC,OAAO,CAAC,iBAAiB,CAAS;IAClC,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,YAA6B,UAAU,EAAE,cAAc,EAAE,EAAI;IAE7D;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAKxC;IAED;gFAC4E;IAC5E,OAAO,CAAC,SAAS;IAMjB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;qGAEiG;IACjG,IAAI,CACF,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,WAAW,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GACxD,IAAI,CAQN;IAED;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpF;IAED;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB3F;IAED;;oFAEgF;IAC1E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAajE;IAED,sGAAsG;IAChG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAO1C;IAED,0FAA0F;IAC1F,IAAI,gBAAgB,IAAI,OAAO,CAI9B;IAED,+EAA+E;IACzE,wBAAwB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO5D;IAED,8EAA8E;IACxE,uBAAuB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAO1D;IAED;;;;;OAKG;IACG,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAM1E;IAED;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIpC;IAED;uFACmF;IACnF,cAAc,IAAI,IAAI,CAIrB;IAED,+DAA+D;IAC/D,OAAO,CAAC,OAAO;CAkBhB"}

package/dist/src/transport-pool.js

@@ -8,9 +8,30 @@ const DISPATCH_CHUNK = 200;
 export class TransportPool {
     transports;
     warnedBulkRefusal = false;
+    /** Ids of the transports that route replies to this engine instance (see {@link routeReplies}). */
+    replying = new Set();
     constructor(transports) {
         this.transports = transports;
     }
+    /**
+     * Have every transport that can ({@link Transport.consumeRepliesFor}) send this engine instance
+     * the results of the tasks it dispatches with `replyTo`. Returns whether any transport does.
+     */
+    routeReplies(instanceId) {
+        for (const { id, transport } of this.transports) {
+            if (transport.consumeRepliesFor?.(instanceId))
+                this.replying.add(id);
+        }
+        return this.replying.size > 0;
+    }
+    /** `task` as sent on transport `id`: a reply goes back only on a transport that routes it, so
+     *  elsewhere `replyTo` is dropped (its result rides the shared results). */
+    withReply(task, id) {
+        if (task.replyTo === undefined || this.replying.has(id))
+            return task;
+        const { replyTo: _replyTo, ...rest } = task;
+        return rest;
+    }
     get size() {
         return this.transports.length;
     }
@@ -35,7 +56,7 @@ export class TransportPool {
         let lastErr;
         for (const { id, transport } of this.ordered(preferId)) {
             try {
-                await transport.dispatch({ ...task, transport: id });
+                await transport.dispatch({ ...this.withReply(task, id), transport: id });
                 return;
             }
             catch (err) {
@@ -55,7 +76,7 @@ export class TransportPool {
         const first = this.ordered(preferId)[0];
         if (first?.transport.dispatchMany) {
             try {
-                await first.transport.dispatchMany(tasks.map((task) => ({ ...task, transport: first.id })));
+                await first.transport.dispatchMany(tasks.map((task) => ({ ...this.withReply(task, first.id), transport: first.id })));
                 return;
             }
             catch (err) {

package/dist/src/transport-pool.js.map

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

package/dist/src/transports/bullmq/bullmq-transport.d.ts

@@ -73,6 +73,23 @@ export interface BullMQTransportOptions {
      * your slowest legitimate step. Unset (the default) = no ceiling.
      */
     stepTimeoutMs?: number | undefined;
+    /**
+     * Route a dispatched `ctx.step`'s result back to the engine instance that dispatched it (the task's
+     * `replyTo`), on a queue of its own, while that instance is alive: it holds the workflow body parked
+     * on the step, so with several engines the result continues the body instead of replaying it on
+     * whichever engine takes it off the shared results. An instance announces it is alive with a Redis
+     * key it refreshes; once the key lapses (a crash, a scale-down, a shutdown), workers send its
+     * results to the shared queue again and every transport moves what is left on its queue there, so
+     * no result is lost. Default `true`. `false` neither consumes nor sends routed replies. The keys
+     * and queue are the NestJS transport's and the Python worker's, so a mixed fleet routes too.
+     */
+    replyRouting?: boolean | undefined;
+    /** How long an engine's alive key outlives its last refresh (refreshed every third of it). Default 15 s. */
+    replyAliveTtlMs?: number | undefined;
+    /** How often a transport looks for dead engines' reply queues to move to the shared results. Default 5 s. */
+    replySweepMs?: number | undefined;
+    /** How long a dead engine's emptied reply queue is still watched before it is forgotten. Default 90 s. */
+    replyDrainIdleMs?: number | undefined;
 }
 /**
  * A queue-backed {@link Transport} over BullMQ/Redis, BYTE-COMPATIBLE with the aviary
@@ -159,6 +176,22 @@ export declare class BullMQTransport implements Transport {
      *  pub/sub channel (resets the engine's `timeoutMs` window on whichever pod is awaiting it). */
     heartbeat(beat: Heartbeat): Promise<void>;
     onResult(handler: (result: StepResult) => Promise<void>): void;
+    /**
+     * Engine side: consume the results routed to engine instance `replyTo`, keep its alive key fresh,
+     * and sweep dead instances' reply queues. Once per transport. Resolves whether replies are routed
+     * here (`false` with `replyRouting: false`, or a Redis client without the keys it needs). A process
+     * whose consumers are deferred announces nothing until they start: until then its tasks' results
+     * ride the shared queue.
+     */
+    consumeRepliesFor(replyTo: string): boolean;
+    /**
+     * Move the reply queue of every engine instance whose alive key lapsed onto the shared results: a
+     * drain worker forwards each job (waiting, delayed, or stalled under the dead consumer) there. Once
+     * a dead instance's queue has stayed empty for `replyDrainIdleMs` (past BullMQ's stalled check, and
+     * past any sender's cached view of the instance), it is forgotten. Runs on its own every
+     * `replySweepMs` on a transport that routes replies; exposed for tests.
+     */
+    sweepReplyQueues(): Promise<void>;
     onDecision(handler: (decision: WorkflowDecision) => Promise<void>): void;
     /** workflow worker → engine: stream a local step's lifecycle on `${P}-step-events` (job `stepEvent`),
      *  point-to-point so one engine instance checkpoints each once. */
@@ -170,7 +203,14 @@ export declare class BullMQTransport implements Transport {
      *  neither segment carries a `:`, so the token is the segment between the fixed prefix and the next `:`.
      *  Reads the shared {@link #liveHeartbeats} snapshot, so it costs no extra walk next to `groupHealth`. */
     listWorkerGroups(): Promise<string[]>;
-    listWorkerDescriptors(token: string): Promise<WorkerDescriptor[]>;
+    /**
+     * `fresh` skips the reuse: the engine re-reads before it parks a run `blocked`, so a capable
+     * worker that joined inside the cache window is never missed. A read already in flight is joined
+     * either way (it started no earlier).
+     */
+    listWorkerDescriptors(token: string, opts?: {
+        fresh?: boolean | undefined;
+    }): Promise<WorkerDescriptor[]>;
     /** Every live descriptor on every token: SCAN `${P}-worker-descriptor:*`, MGET per page. Degrades
      *  to `[]` (reported through `onError`) when the keyspace cannot be read. */
     readAllWorkerDescriptors(): Promise<WorkerDescriptor[]>;

package/dist/src/transports/bullmq/bullmq-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bullmq-transport.d.ts","sourceRoot":"","sources":["../../../../src/transports/bullmq/bullmq-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,SAAS,EACT,eAAe,EAEf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAkB,KAAK,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AAExF,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAOlF,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EACL,KAAK,UAAU,EAGf,KAAK,SAAS,EAGf,MAAM,WAAW,CAAC;AA+BnB,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2FAA2F;IAC3F,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,mGAAmG;IACnG,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/C;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC5C;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AA2BD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,YAAW,SAAS;;IAiF/C,YAAY,OAAO,EAAE,sBAAsB,EAyB1C;IAiGD;;;;;;;;;;;;;;OAcG;IACH,cAAc,IAAI,IAAI,CAErB;IAED;;mEAE+D;IAC/D,cAAc,IAAI,IAAI,CAIrB;IAgDD,iEAAiE;IACjE,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGpC;IAkGD;;;;;;;OAOG;IACH,qBAAqB,IAAI,SAAS,CAEjC;IAMD;+EAC2E;IACrE,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9C;IAED;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCrD;IAED;2GACuG;IACjG,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5D;IAMD;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAG1C;IAED;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAG5D;IAyOD;oGACgG;IAC1F,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9C;IAqBD,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAmC7D;IAED,UAAU,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAkBvE;IAED;uEACmE;IAC7D,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/D;IAED,WAAW,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAKtE;IAED,WAAW,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAkB7D;IAiDD;;;8GAG0G;IACpG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAU1C;IA6EK,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAmCtE;IAED;iFAC6E;IACvE,wBAAwB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAqB5D;IAED;4FACwF;IAClF,uBAAuB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAuB1D;IAuBD;;mGAE+F;IACzF,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAYrD;IAoCD;;;;;;OAMG;IACG,YAAY,CAChB,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CAgBf;IAOD;;;;OAIG;IACH,eAAe,CACb,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,EAC5C,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAC5D,MAAM,OAAO,CAAC,IAAI,CAAC,CAiBrB;IAED,sGAAsG;IAChG,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;IAED,uGAAuG;IACvG,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAKjE;IAED,qGAAqG;IAC/F,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvD;IAED,kGAAkG;IAClG,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAK9D;IAED,mGAAmG;IAC7F,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpD;IAED,wGAAwG;IACxG,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAoBnD;IAED,2GAA2G;IACrG,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxD;IAED;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAqB7E;IAyBD,uGAAuG;IACjG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA8C3B;CACF"}
+{"version":3,"file":"bullmq-transport.d.ts","sourceRoot":"","sources":["../../../../src/transports/bullmq/bullmq-transport.ts"],"names":[],"mappings":"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"}

package/dist/src/transports/bullmq/bullmq-transport.js

@@ -5,7 +5,7 @@ import { isWorkflowTask } from '../../workflow-turn.js';
 import { failedTaskIdentity, fanOutDecision, infrastructureFailure, } from '../task-failure.js';
 import { AdaptiveController } from './adaptive-concurrency.js';
 import { workerConcurrency, } from './deps.js';
-import { decisionsName, effectivePrefix, heartbeatChannel, resultBatchesName, resultsName, routingToken, runReplyChannel, runRequestName, runStartJobId, runsName, startRunName, stepEventsName, tasksName, tenantEventsChannel, workerDescriptorTokenPrefix, workerHeartbeatKey, workerHeartbeatKeyPrefix, } from './naming.js';
+import { decisionsName, effectivePrefix, heartbeatChannel, replyAliveKey, replyInstancesKey, replyQueueName, resultBatchesName, resultsName, routingToken, runReplyChannel, runRequestName, runStartJobId, runsName, startRunName, stepEventsName, tasksName, tenantEventsChannel, workerDescriptorTokenPrefix, workerHeartbeatKey, workerHeartbeatKeyPrefix, } from './naming.js';
 import { buildInstanceId, heartbeatKeyValue, jobOptions, parseHeartbeatValue, resultJobOptions, taskJobOptions, WORKER_HEARTBEAT_INTERVAL_MS, WORKER_HEARTBEAT_TTL_SECONDS, } from './serialization.js';
 /** Default {@link BullMQTransportOptions.pingIntervalMs}. */
 const DEFAULT_PING_INTERVAL_MS = 30_000;
@@ -83,6 +83,8 @@ export class BullMQTransport {
     #taskWorkers = new Map();
     #resultsWorker;
     #resultBatchesWorker;
+    /** The engine's result handlers (one per engine), also fed by the routed-reply queue. */
+    #resultHandlers = new Set();
     // Step results waiting for the results-batch publish in flight to finish (see `#publishResult`).
     #resultsToBatch = [];
     #publishingResultBatch = false;
@@ -117,6 +119,23 @@ export class BullMQTransport {
     #pingIntervalMs;
     #stepTimeoutMs;
     #pingWatchdogTimer;
+    // --- Reply routing (see `replyRouting`) ---
+    #replyRouting;
+    #replyAliveTtlMs;
+    #replySweepMs;
+    #replyDrainIdleMs;
+    /** The engine instance this transport consumes routed replies for. */
+    #replyId;
+    #replyWorker;
+    #replyRedisClient;
+    #replyBeatTimer;
+    #replySweepTimer;
+    #replySweeping = false;
+    #replyAliveCache = new Map();
+    /** Routed results waiting for the batch in flight to their instance's queue, by queue. */
+    #replyOutboxes = new Map();
+    /** Dead engines' reply queues this transport is moving to the shared results. */
+    #replyDrains = new Map();
     constructor(options) {
         this.#deps = options.deps;
         this.#partition = options.partition;
@@ -132,6 +151,10 @@ export class BullMQTransport {
         // results per write. `resultConcurrency` only raises it.
         this.#resultConcurrency = Math.max(RESULT_CONSUMER_MIN, workerConcurrency(options.resultConcurrency));
         this.#concurrency = options.concurrency;
+        this.#replyRouting = options.replyRouting !== false;
+        this.#replyAliveTtlMs = positiveMs(options.replyAliveTtlMs, 15_000);
+        this.#replySweepMs = positiveMs(options.replySweepMs, 5_000);
+        this.#replyDrainIdleMs = positiveMs(options.replyDrainIdleMs, 90_000);
         this.#pingIntervalMs = normalizePingInterval(options.pingIntervalMs);
         this.#stepTimeoutMs =
             options.stepTimeoutMs !== undefined &&
@@ -332,7 +355,9 @@ export class BullMQTransport {
      * result as soon as it finishes. A batch that fails to publish goes out one result per job.
      * Otherwise each result is its own job on the results queue.
      */
-    async #publishResult(result) {
+    async #publishResult(result, replyTo) {
+        if (replyTo !== undefined && (await this.#publishReply(result, replyTo)))
+            return;
         if (!(await this.#resultBatchesConsumed())) {
             await this.#queue(resultsName(this.#effectivePrefix())).add('result', result, resultJobOptions());
             return;
@@ -666,7 +691,7 @@ export class BullMQTransport {
         if (this.#handedBack.has(task))
             return false;
         try {
-            await this.#publishResult(result);
+            await this.#publishResult(result, task.replyTo);
             return result.status === 'completed';
         }
         catch (err) {
@@ -727,6 +752,7 @@ export class BullMQTransport {
     onResult(handler) {
         if (this.#resultsWorker)
             return;
+        this.#resultHandlers.add(handler);
         this.#resultBatchesWorker = this.#makeWorker(resultBatchesName(this.#effectivePrefix()), async (job) => {
             const { results } = job.data;
             await Promise.all(results.map((result) => handler(result)));
@@ -753,6 +779,222 @@ export class BullMQTransport {
                 console.error(`[adonis-durable] ${giveUp.message}`);
         });
     }
+    // --- Reply routing ------------------------------------------------------------------------------
+    // A task carrying `replyTo` asks for its result back on `<P>-results-to-<replyTo>`, a queue only
+    // that engine instance consumes, while its alive key (`<P>:reply-alive:<id>`, refreshed every third
+    // of `replyAliveTtlMs`) exists. Every instance that consumed or was sent a routed reply is
+    // remembered in `<P>:reply-instances`; any transport that routes replies sweeps that set and moves
+    // the queue of an instance whose key lapsed onto the shared results, stalled jobs included (BullMQ's
+    // stalled check hands a dead consumer's job to the next worker on that queue).
+    /** The connection reply routing uses, or `undefined` when routing is off or the client lacks it. */
+    #replyRedis() {
+        if (!this.#replyRouting)
+            return undefined;
+        this.#replyRedisClient ??= this.#deps.makeRedis();
+        const r = this.#replyRedisClient;
+        if (!r.exists || !r.del || !r.sadd || !r.srem || !r.smembers)
+            return undefined;
+        return r;
+    }
+    /** Run `start` now, or once consumers start (see {@link deferConsumers}). */
+    #whenConsuming(start) {
+        if (this.#consumersDeferred)
+            this.#deferredWorkers.push(start);
+        else
+            start();
+    }
+    /** A results-queue job's results: one `result`, or a `results` batch. */
+    #resultsOf(job) {
+        // A batch is recognized by its shape too: a fake job may carry no name.
+        const data = job.data;
+        return job.name === 'results' || (job.name === undefined && 'results' in data)
+            ? (data.results ?? [])
+            : [data];
+    }
+    /**
+     * Engine side: consume the results routed to engine instance `replyTo`, keep its alive key fresh,
+     * and sweep dead instances' reply queues. Once per transport. Resolves whether replies are routed
+     * here (`false` with `replyRouting: false`, or a Redis client without the keys it needs). A process
+     * whose consumers are deferred announces nothing until they start: until then its tasks' results
+     * ride the shared queue.
+     */
+    consumeRepliesFor(replyTo) {
+        if (this.#replyId !== undefined)
+            return this.#replyId === replyTo;
+        const redis = this.#replyRedis();
+        if (!redis || this.#resultHandlers.size === 0)
+            return false;
+        this.#replyId = replyTo;
+        const prefix = this.#effectivePrefix();
+        this.#replyWorker = this.#makeWorker(replyQueueName(prefix, replyTo), (job) => this.#handleResultJob(job), { concurrency: this.#resultConcurrency });
+        this.#replyWorker.on('failed', (job, err) => {
+            if (!job || (job.attemptsMade ?? 0) < (job.opts?.attempts ?? 1))
+                return;
+            const giveUp = new Error(`gave up on a routed step result after ${job.attemptsMade} attempts: ${err.message}`, { cause: err });
+            if (this.#hasOnError)
+                this.#onError(giveUp);
+            else
+                console.error(`[adonis-durable] ${giveUp.message}`);
+        });
+        this.#whenConsuming(() => {
+            if (this.#closing)
+                return;
+            const beat = async () => {
+                try {
+                    await redis.set(replyAliveKey(prefix, replyTo), '1', 'PX', this.#replyAliveTtlMs);
+                    await redis.sadd(replyInstancesKey(prefix), replyTo);
+                }
+                catch {
+                    // The next beat retries; a lapsed key only sends this instance's results to the shared queue.
+                }
+            };
+            void beat();
+            this.#replyBeatTimer = setInterval(() => void beat(), Math.max(50, Math.floor(this.#replyAliveTtlMs / 3)));
+            this.#replyBeatTimer.unref?.();
+            this.#startReplySweeper();
+        });
+        return true;
+    }
+    /** Hand a results job to every result handler. */
+    async #handleResultJob(job) {
+        const results = this.#resultsOf(job);
+        await Promise.all(results.flatMap((result) => [...this.#resultHandlers].map((handler) => handler(result))));
+    }
+    /** Whether engine instance `id` is alive to take its routed replies (read at most every second). */
+    async #replyAlive(id) {
+        if (id === this.#replyId && this.#replyBeatTimer)
+            return true;
+        const known = this.#replyAliveCache.get(id);
+        if (known && Date.now() - known.at < 1_000)
+            return known.alive;
+        const redis = this.#replyRedis();
+        if (!redis)
+            return false;
+        const alive = (await redis.exists(replyAliveKey(this.#effectivePrefix(), id))) === 1;
+        this.#replyAliveCache.set(id, { alive, at: Date.now() });
+        return alive;
+    }
+    /**
+     * Worker side: send `result` to engine instance `replyTo` while it is alive. Resolves `false` to
+     * send it to the shared results instead (routing off, the instance gone, or Redis refusing).
+     */
+    async #publishReply(result, replyTo) {
+        if (!this.#replyRouting)
+            return false;
+        try {
+            if (!(await this.#replyAlive(replyTo)))
+                return false;
+        }
+        catch {
+            return false;
+        }
+        // Batched like the shared results: the results that finish while one batch to this instance is
+        // being published go out together in the next. A batch that cannot be published goes to the
+        // shared results, one result per job.
+        const queue = replyQueueName(this.#effectivePrefix(), replyTo);
+        let outbox = this.#replyOutboxes.get(queue);
+        if (!outbox) {
+            outbox = { entries: [], publishing: false };
+            this.#replyOutboxes.set(queue, outbox);
+        }
+        const box = outbox;
+        const sent = await new Promise((resolve) => {
+            box.entries.push({ result, resolve });
+            if (!box.publishing)
+                void this.#publishReplyBatches(queue, box);
+        });
+        if (!sent)
+            return false;
+        // A sender also watches for dead engines, so routed results never wait on an engine coming back.
+        this.#startReplySweeper();
+        return true;
+    }
+    async #publishReplyBatches(queue, outbox) {
+        outbox.publishing = true;
+        try {
+            while (outbox.entries.length > 0) {
+                const batch = outbox.entries.splice(0, RESULT_BATCH_MAX);
+                try {
+                    await (batch.length === 1
+                        ? this.#queue(queue).add('result', batch[0]?.result, resultJobOptions())
+                        : this.#queue(queue).add('results', { results: batch.map((entry) => entry.result) }, resultJobOptions()));
+                    for (const entry of batch)
+                        entry.resolve(true);
+                }
+                catch {
+                    for (const entry of batch)
+                        entry.resolve(false);
+                }
+            }
+        }
+        finally {
+            outbox.publishing = false;
+        }
+    }
+    #startReplySweeper() {
+        if (this.#replySweepTimer || this.#closing || this.#consumersDeferred || !this.#replyRedis()) {
+            return;
+        }
+        this.#replySweepTimer = setInterval(() => {
+            if (this.#replySweeping)
+                return;
+            this.#replySweeping = true;
+            void this.sweepReplyQueues()
+                .catch(() => undefined)
+                .finally(() => {
+                this.#replySweeping = false;
+            });
+        }, this.#replySweepMs);
+        this.#replySweepTimer.unref?.();
+    }
+    /**
+     * Move the reply queue of every engine instance whose alive key lapsed onto the shared results: a
+     * drain worker forwards each job (waiting, delayed, or stalled under the dead consumer) there. Once
+     * a dead instance's queue has stayed empty for `replyDrainIdleMs` (past BullMQ's stalled check, and
+     * past any sender's cached view of the instance), it is forgotten. Runs on its own every
+     * `replySweepMs` on a transport that routes replies; exposed for tests.
+     */
+    async sweepReplyQueues() {
+        const redis = this.#replyRedis();
+        if (!redis || this.#closing)
+            return;
+        const prefix = this.#effectivePrefix();
+        for (const id of await redis.smembers(replyInstancesKey(prefix))) {
+            if (id === this.#replyId || this.#closing)
+                continue;
+            const alive = (await redis.exists(replyAliveKey(prefix, id))) === 1;
+            const drain = this.#replyDrains.get(id);
+            if (alive) {
+                if (drain) {
+                    this.#replyDrains.delete(id);
+                    await drain.worker.close().catch(() => undefined);
+                }
+                continue;
+            }
+            if (!drain) {
+                const worker = this.#deps.makeWorker(replyQueueName(prefix, id), async (job) => {
+                    await Promise.all(this.#resultsOf(job).map((result) => this.#queue(resultsName(prefix)).add('result', result, resultJobOptions())));
+                });
+                this.#replyDrains.set(id, { worker });
+                continue;
+            }
+            const counts = await this.#queue(replyQueueName(prefix, id)).getJobCounts('waiting', 'wait', 'active', 'delayed', 'prioritized');
+            const left = Object.values(counts).reduce((sum, n) => sum + n, 0);
+            if (left > 0) {
+                drain.idleSince = undefined;
+                continue;
+            }
+            drain.idleSince ??= Date.now();
+            if (Date.now() - drain.idleSince < this.#replyDrainIdleMs)
+                continue;
+            this.#replyDrains.delete(id);
+            await drain.worker.close().catch(() => undefined);
+            // Forgotten only while still dead: an instance that came back re-adds itself on its next beat.
+            if ((await redis.exists(replyAliveKey(prefix, id))) === 0) {
+                await redis.srem(replyInstancesKey(prefix), id);
+            }
+        }
+    }
     onDecision(handler) {
         // EVERY handler gets every decision. An engine subscribes one stable handler (it applies a decision
         // by run id, dropping any its run no longer awaits); a set keeps a second registration of it, or a
@@ -917,12 +1159,30 @@ export class BullMQTransport {
      *  cadence (tens of seconds), but `ensureRoutable` asks before EVERY dispatch — without this memo
      *  a 500-step/s engine ran 500 SCAN cycles/s against Redis for an answer that was identical. */
     #descriptorCache = new Map();
-    async listWorkerDescriptors(token) {
+    /** The descriptor read in flight per token: concurrent callers share it instead of each scanning. */
+    #descriptorReads = new Map();
+    /**
+     * `fresh` skips the reuse: the engine re-reads before it parks a run `blocked`, so a capable
+     * worker that joined inside the cache window is never missed. A read already in flight is joined
+     * either way (it started no earlier).
+     */
+    async listWorkerDescriptors(token, opts) {
         const cached = this.#descriptorCache.get(token);
         // A short TTL (5s): a fraction of the descriptor heartbeat TTL, so a scaled-down fleet is
         // noticed within one cache window while the per-dispatch SCAN storm disappears.
-        if (cached && Date.now() - cached.at < 5_000)
+        if (!opts?.fresh && cached && Date.now() - cached.at < 5_000)
             return cached.descriptors;
+        const inFlight = this.#descriptorReads.get(token);
+        if (inFlight)
+            return inFlight;
+        const read = this.#readWorkerDescriptors(token).finally(() => {
+            if (this.#descriptorReads.get(token) === read)
+                this.#descriptorReads.delete(token);
+        });
+        this.#descriptorReads.set(token, read);
+        return read;
+    }
+    async #readWorkerDescriptors(token) {
         const client = this.#workerRedisClient();
         const prefix = workerDescriptorTokenPrefix(this.#effectivePrefix(), token);
         const descriptors = [];
@@ -1234,6 +1494,17 @@ export class BullMQTransport {
         if (this.#pingWatchdogTimer)
             clearInterval(this.#pingWatchdogTimer);
         this.#pingWatchdogTimer = undefined;
+        if (this.#replyBeatTimer)
+            clearInterval(this.#replyBeatTimer);
+        if (this.#replySweepTimer)
+            clearInterval(this.#replySweepTimer);
+        // Stop taking routed replies first: with the alive key gone, workers send to the shared results
+        // and other instances move what is left on this instance's queue there.
+        if (this.#replyId !== undefined && this.#replyBeatTimer && this.#replyRedisClient?.del) {
+            await withTimeout(this.#replyRedisClient
+                .del(replyAliveKey(this.#effectivePrefix(), this.#replyId))
+                .catch(() => undefined), this.#closeTimeoutMs);
+        }
         // Workers first (concurrently with each other), THEN queues: a worker's close() waits for its
         // in-flight job, which publishes its result/decision through a queue, so that queue must still be
         // open until every worker has settled. One shared deadline bounds both phases: a graceful
@@ -1244,6 +1515,8 @@ export class BullMQTransport {
             ...[...this.#taskWorkers.values()].map((w) => w.close()),
             this.#resultsWorker?.close(),
             this.#resultBatchesWorker?.close(),
+            this.#replyWorker?.close(),
+            ...[...this.#replyDrains.values()].map((d) => d.worker.close()),
             this.#decisionsWorker?.close(),
             this.#stepEventsWorker?.close(),
             this.#startRunWorker?.close(),
@@ -1268,8 +1541,13 @@ export class BullMQTransport {
         this.#runReplySub?.disconnect();
         this.#tenantEventPub?.disconnect();
         this.#tenantEventSub?.disconnect();
+        this.#replyRedisClient?.disconnect();
     }
 }
+/** A positive finite duration, else `fallback`. */
+function positiveMs(value, fallback) {
+    return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;
+}
 /** Resolve when `work` settles or `ms` elapses (the loser is abandoned). `ms <= 0` skips the wait. */
 async function withTimeout(work, ms) {
     if (ms <= 0)