@adonis-agora/durable 0.10.0 → 0.12.0

package/dist/src/step-name-symbol.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-name-symbol.js","sourceRoot":"","sources":["../../src/step-name-symbol.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAEvF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAyB3F,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAgBD;;uEAEuE;AACvE,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAI,GAAyC,CAAC,iBAAiB,CAAC,CAAC;IAC9E,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED;;0EAE0E;AAC1E,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAI,GAA2C,CAAC,mBAAmB,CAAC,CAAC;IAClF,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}
+{"version":3,"file":"step-name-symbol.js","sourceRoot":"","sources":["../../src/step-name-symbol.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAEvF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AA4B3F,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAgBD;;uEAEuE;AACvE,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAI,GAAyC,CAAC,iBAAiB,CAAC,CAAC;IAC9E,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED;;0EAE0E;AAC1E,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAI,GAA2C,CAAC,mBAAmB,CAAC,CAAC;IAClF,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}

package/dist/src/step-ref.d.ts

@@ -37,6 +37,10 @@ export interface StepDecoratorOptions {
     jitter?: boolean;
     /** Liveness window for the dispatched step (ms): presume the worker dead and re-dispatch on timeout. */
     timeoutMs?: number;
+    /** Capabilities a live worker must advertise to run this step (design §7.5). The control-plane
+     *  routes only to workers whose handshake descriptor advertises every name here; if none is live +
+     *  protocol-compatible the run parks `blocked` with a precise reason. Absent/empty = runs anywhere. */
+    requires?: string[];
 }
 /**
  * Marks a class method as a durable **step handler**. A dispatched task is routed to it BY NAME —

package/dist/src/step-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-ref.d.ts","sourceRoot":"","sources":["../../src/step-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAA+C,CAAC;AAEvF,wGAAwG;AACxG,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC;IAC9B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IAClB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACnB,6GAA6G;IAC7G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wGAAwG;IACxG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,eAAe,CAiBnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACjD,MAAM,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GAC1C,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ1B;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAGpE"}
+{"version":3,"file":"step-ref.d.ts","sourceRoot":"","sources":["../../src/step-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAA+C,CAAC;AAEvF,wGAAwG;AACxG,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC;IAC9B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IAClB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACnB,6GAA6G;IAC7G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wGAAwG;IACxG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;2GAEuG;IACvG,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA0BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,eAAe,CAiBnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACjD,MAAM,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GAC1C,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ1B;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAGpE"}

package/dist/src/step-ref.js

@@ -23,6 +23,8 @@ function stepConfigFrom(options) {
         config.jitter = options.jitter;
     if (options.timeoutMs !== undefined)
         config.timeoutMs = options.timeoutMs;
+    if (options.requires !== undefined)
+        config.requires = options.requires;
     return Object.keys(config).length > 0 ? config : undefined;
 }
 /** Stamp the shared cross-package name/config/meta keys onto a step handler function. */

package/dist/src/step-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-ref.js","sourceRoot":"","sources":["../../src/step-ref.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAGlB,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAkCvF;;uCAEuC;AACvC,SAAS,cAAc,CAAC,OAA6B;IACnD,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACpE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACpE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAC1E,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACnF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,yFAAyF;AACzF,SAAS,KAAK,CAAC,EAAU,EAAE,IAAqB,EAAE,MAA8B;IAC7E,EAAuC,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;IACvE,EAAgD,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAC5E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACxB,EAA6C,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,IAAI,CAAC,aAA6C;IAChE,OAAO,CAAC,CAAC,MAAc,EAAE,WAA4B,EAAE,UAA8B,EAAE,EAAE;QACvF,MAAM,OAAO,GACX,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;QACtF,MAAM,QAAQ,GAAI,MAA8C,EAAE,WAAW,EAAE,IAAI,IAAI,MAAM,CAAC;QAC9F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,GAAG,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC/B,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,IAAI,GAAoB;YAC5B,IAAI;YACJ,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC;QACF,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAoB,CAAC;AACxB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,EAAiD,EACjD,MAA2C;IAE3C,MAAM,IAAI,GAAoB;QAC5B,IAAI;QACJ,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;IACF,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrD,OAAO,EAA8B,CAAC;AACxC,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,IAAI,OAAO,GAAG,KAAK,UAAU,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC3E,OAAQ,GAAwD,EAAE,CAAC,iBAAiB,CAAC,CAAC;AACxF,CAAC"}
+{"version":3,"file":"step-ref.js","sourceRoot":"","sources":["../../src/step-ref.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,130 @@
+import type { WorkerDescriptor } from '../../handshake/descriptor.js';
+import type { GroupHealth, Heartbeat, RemoteTask, RunReply, RunRequest, StartRunMessage, StepResult, TenantEvent, Transport, WorkflowDecision, WorkflowStepEvent, WorkflowTask } from '../../interfaces.js';
+import { type StepHandler } from '../../protocol.js';
+import { type WorkflowTurnHandler } from '../../workflow-turn.js';
+import type { BullMQDeps, RedisLike } from './deps.js';
+export interface BullMQTransportOptions {
+    /** The broker factory (real bullmq/ioredis via `createBullMQDeps`, or a fake in tests). */
+    deps: BullMQDeps;
+    /**
+     * Logical isolation partition suffixing every per-handler tasks queue this instance subscribes to
+     * (via `tenantGroup`) — so several isolated worker pools can share one Redis without a `handle()`d
+     * name colliding across pools. Unset routes each handler to the bare (sanitized) handler name.
+     */
+    partition?: string | undefined;
+    /** Key prefix namespacing the durable queues. Default `durable`. */
+    prefix?: string | undefined;
+    /**
+     * Logical deployment namespace, segmenting every queue/channel/key so one Redis can host multiple
+     * isolated deployments. Unset or `"default"` keeps names BYTE-IDENTICAL to the un-namespaced scheme.
+     * An explicit value here wins over a later {@link BullMQTransport.useNamespace}.
+     */
+    namespace?: string | undefined;
+    /** Stable id for this worker process in the liveness keys. Default `ts-<host>-<pid>`. */
+    instanceId?: string | undefined;
+    /** Where a background failure (a failed heartbeat refresh, a result-publish error) is reported. */
+    onError?: ((err: unknown) => void) | undefined;
+}
+/**
+ * A queue-backed {@link Transport} over BullMQ/Redis, BYTE-COMPATIBLE with the aviary
+ * (`nestjs-durable`) BullMQ transport and its Python raw-redis worker — so an Adonis engine can
+ * dispatch to a Python worker (and vice versa) on the SAME Redis keys. Steps/workflow tasks go to a
+ * per-routing-token queue (`${P}-tasks-${token}`); step results, workflow decisions and streamed step
+ * events ride their own queues; run / long-step heartbeats ride a `${P}-heartbeat` pub/sub; and a
+ * TTL'd `${P}-worker-heartbeat:${token}:${instance}` key registry advertises live workers.
+ *
+ * It implements the CURRENT {@link Transport} interface (dispatch/result/heartbeat + the optional
+ * workflow-task / decision / step-event / group-health hooks). It deliberately does NOT implement the
+ * control plane: the shipped `RedisControlPlane` already owns the byte-compatible `${P}-control`
+ * channel, so pass it as the engine's `controlPlane` alongside this transport.
+ *
+ * The concrete broker is injected as {@link BullMQDeps} so this class stays pure — construct it via
+ * `transports.bullmq({...})`, which builds the real bullmq/ioredis deps lazily.
+ */
+export declare class BullMQTransport implements Transport {
+    #private;
+    constructor(options: BullMQTransportOptions);
+    /** Stable id stamped on this instance's worker-liveness keys. */
+    get instanceId(): string;
+    /**
+     * Adopt `namespace` (the engine's), segmenting every name by it — but ONLY if one wasn't passed
+     * explicitly to the constructor (an explicit one always wins). Idempotent. No-op for `"default"`.
+     */
+    useNamespace(namespace: string): void;
+    /**
+     * Capability hook consumed by the `tenant`-role provider: mint a DEDICATED Redis client the
+     * store-less {@link WorkerRuntime}'s registry uses to publish/refresh its `-worker-descriptor:`
+     * and `-worker-heartbeat:` keys (SET…EX). Dedicated so the registry disconnecting on worker
+     * drain never tears down the transport's own broker clients. The returned `RedisLike` structurally
+     * satisfies the registry's `DescriptorRedis` port (`set`/`del`/`disconnect`), and is what the
+     * control-plane's `listWorkerDescriptors` SCAN later reads back — closing the descriptor loop.
+     */
+    createDescriptorRedis(): RedisLike;
+    /** `task.group` already carries the FINAL routing token (computed by the engine) — target that
+     *  handler's dedicated queue. Job name `task`; DTO is the raw job data. */
+    dispatch(task: RemoteTask): Promise<void>;
+    /** engine → workflow worker: a `WorkflowTask` on the workflow's dedicated task queue (same queue a
+     *  Python workflow worker consumes). Job name `workflow`; the decision returns on `${P}-decisions`. */
+    dispatchWorkflowTask(task: WorkflowTask): Promise<void>;
+    /**
+     * Register a step handler (worker side). Starts a DEDICATED task worker for `name`'s routing token on
+     * first registration (see {@link #ensureTaskWorker}) and begins stamping this instance's liveness key
+     * for that token. Re-registering swaps the handler fn; its worker is untouched.
+     */
+    handle(name: string, fn: StepHandler): void;
+    /**
+     * Register a WORKFLOW turn consumer (worker side, design §4 / spec §6.3). Starts a DEDICATED task
+     * worker for the workflow `name`'s routing token — the SAME `${P}-tasks-<token>` queue a Python
+     * workflow worker consumes — which discriminates step-vs-workflow BY SHAPE ({@link #runJob}): a
+     * `workflow`-shaped job runs `turn(task)` (the replay → decision) and its {@link WorkflowDecision} is
+     * published on `${P}-decisions`. Re-registering swaps the turn fn; the worker is untouched.
+     */
+    handleWorkflow(name: string, turn: WorkflowTurnHandler): void;
+    /** Worker side: publish a liveness heartbeat for an in-flight long step on the `${P}-heartbeat`
+     *  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;
+    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. */
+    dispatchStepEvent(event: WorkflowStepEvent): Promise<void>;
+    onStepEvent(handler: (event: WorkflowStepEvent) => Promise<void>): void;
+    onHeartbeat(handler: (beat: Heartbeat) => Promise<void>): void;
+    /** Distinct routing tokens with a live worker heartbeat, discovered by SCANning the heartbeat
+     *  keyspace (never KEYS — it blocks Redis). A key is `${P}-worker-heartbeat:<token>:<instance>`, and
+     *  neither segment carries a `:`, so the token is the segment between the fixed prefix and the next `:`. */
+    listWorkerGroups(): Promise<string[]>;
+    /** The LIVE worker descriptors advertised on `token` — SCAN the `${P}-worker-descriptor:<token>:*`
+     *  keys a worker runtime publishes (design §7.2), GET + parse each. Degrades gracefully to `[]`: a
+     *  missing/unreadable/malformed key is skipped (never throws), so a broker without descriptor
+     *  advertisement (or a scan that races a key's expiry) reads as "no descriptors" and the control-plane
+     *  falls back to legacy assume-compatible dispatch. Never uses KEYS (it blocks Redis). */
+    listWorkerDescriptors(token: string): Promise<WorkerDescriptor[]>;
+    /** Per-group worker-health: queue depth (waiting+active+delayed+prioritized) + live workers (their
+     *  non-expired heartbeat keys). `group` is a routing token — the same value a dispatch targets. */
+    groupHealth(group: string): Promise<GroupHealth>;
+    /** tenant → control plane: enqueue a {@link StartRunMessage} on `${P}-start-run` (job `startRun`). */
+    dispatchStartRun(msg: StartRunMessage): Promise<void>;
+    /** control plane ← tenant: consume {@link StartRunMessage}s. Idempotent — a second call is a no-op. */
+    onStartRun(handler: (msg: StartRunMessage) => Promise<void>): void;
+    /** tenant → control plane: enqueue a {@link RunRequest} on `${P}-run-request` (job `runRequest`). */
+    dispatchRunRequest(msg: RunRequest): Promise<void>;
+    /** control plane ← tenant: consume {@link RunRequest}s. Idempotent — a second call is a no-op. */
+    onRunRequest(handler: (msg: RunRequest) => Promise<void>): void;
+    /** control plane → tenant: publish a correlated {@link RunReply} on `${P}-run-reply` (pub/sub). */
+    publishRunReply(reply: RunReply): Promise<void>;
+    /** tenant ← control plane: consume {@link RunReply}s (the proxy filters by `requestId`). Idempotent. */
+    onRunReply(handler: (reply: RunReply) => void): void;
+    /** control plane → tenant: re-publish a lifecycle {@link TenantEvent} on `${P}-tenant-events-<tenant>`. */
+    publishTenantEvent(evt: TenantEvent): Promise<void>;
+    /**
+     * tenant ← control plane: subscribe to THIS tenant's event channel. Returns an unsubscribe fn that
+     * detaches only this handler (the shared subscriber connection and channel subscription stay for any
+     * other listeners; both are torn down in {@link close}). Several tenants — or several callers for one
+     * tenant — may subscribe independently, each routed by channel through the ONE shared subscriber.
+     */
+    onTenantEvent(tenant: string, handler: (evt: TenantEvent) => void): () => void;
+    /** Close all workers/queues and disconnect pub/sub + heartbeat connections so the process can exit. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=bullmq-transport.d.ts.map

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

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