@vauban-org/agent-sdk 0.16.0

package/dist/durable/bullmq-runner.d.ts

@@ -0,0 +1,138 @@
+/**
+ * BullMQRunner — BullMQ v5 orchestration wrapper.
+ *
+ * Centralises queue/worker/flow creation with per-archetype defaults,
+ * Dead-Letter Queue (DLQ) handling, and OTel alerting.
+ *
+ * Design constraints:
+ * - R2-1: BullMQ parent-failed event unreliable in multi-queue flows.
+ *         Every job MUST have `attempts`, `backoff`, `removeOnFail`,
+ *         AND a DLQ receiving timeouts > N minutes + OTel alert on DLQ write.
+ * - R2-2: BullMQ v5 + Redis + Postgres job log (no Temporal, no Inngest).
+ *
+ * Archetypes:
+ * - cron          — scheduled background jobs (10min timeout, 3 attempts, exp 30s)
+ * - event         — reactive to Citadel events / webhooks (2min, 5 attempts, exp 5s)
+ * - interactive   — human-in-the-loop tasks (60min, 1 attempt, no backoff)
+ * - orchestration — parent/child DAG coordinators (30min, 2 attempts, exp 60s)
+ */
+import { FlowProducer, type Job, type JobsOptions, Queue, Worker, type WorkerOptions } from "bullmq";
+import IORedis from "ioredis";
+export type QueueArchetype = "cron" | "event" | "interactive" | "orchestration";
+interface ArchetypePolicy {
+    /** Hard job timeout (ms). Jobs exceeding this → DLQ + alert. */
+    timeoutMs: number;
+    /** Max BullMQ attempts. */
+    attempts: number;
+    /** Backoff policy. `null` disables backoff entirely. */
+    backoff: {
+        type: "exponential" | "fixed";
+        delay: number;
+    } | null;
+}
+export interface BullMQRunnerConfig {
+    /**
+     * Redis connection URL. Example:
+     *   redis://brain-prod-redis.brain-prod.svc.cluster.local:6379
+     */
+    redisUrl: string;
+    /** Logical Redis DB index for isolation from Brain. Default 3. */
+    redisDb?: number;
+    /** DLQ queue name. Default "cc-dlq". */
+    dlqName?: string;
+    /** Default attempts if archetype policy is overridden. */
+    defaultAttempts?: number;
+    /** Default backoff if archetype policy is overridden. */
+    defaultBackoff?: {
+        type: "exponential" | "fixed";
+        delay: number;
+    };
+    /** Global job timeout override (ms). Default uses archetype policy. */
+    jobTimeoutMs?: number;
+    /** Factory override for the Redis connection — lets tests inject a mock. */
+    redisFactory?: (url: string, db: number) => IORedisLike;
+}
+/**
+ * Minimal Redis surface exposed to BullMQ. Kept as a shared type so tests may
+ * supply in-memory fakes without pulling `ioredis-mock` as a dep.
+ */
+export type IORedisLike = IORedis;
+export interface DlqJobPayload {
+    originalQueue: string;
+    jobId: string | undefined;
+    failureReason: string;
+    attemptsMade: number;
+    /** Best-effort capture of the job data at time of failure (may be undefined). */
+    data?: unknown;
+    /** ISO timestamp when the entry was moved to DLQ. */
+    movedAt: string;
+}
+export declare class BullMQRunner {
+    private readonly cfg;
+    private readonly connection;
+    private readonly sharedConnectionOpts;
+    private readonly queues;
+    private readonly queueArchetypes;
+    private readonly queueEvents;
+    private readonly workers;
+    private _flow;
+    private _dlq;
+    private closed;
+    constructor(config: BullMQRunnerConfig);
+    /**
+     * Create (or return cached) a named queue bound to an archetype.
+     * Repeated calls with the same name return the cached queue; the archetype
+     * is validated on re-use.
+     */
+    createQueue(name: string, archetype: QueueArchetype): Queue;
+    /**
+     * Create a worker bound to a queue. The processor receives BullMQ job;
+     * workers inherit the queue's archetype for lock/stall durations.
+     */
+    createWorker<T = unknown, R = unknown>(queueName: string, processor: (job: Job<T, R>) => Promise<R>, opts?: Partial<WorkerOptions>): Worker<T, R>;
+    /** Lazy accessor for the FlowProducer singleton. */
+    flowProducer(): FlowProducer;
+    /** Lazy accessor for the DLQ. */
+    dlqQueue(): Queue<DlqJobPayload>;
+    /**
+     * Parent-failed reliability helper.
+     *
+     * Wraps FlowProducer.add() and polls the parent job's
+     * `getDependencies({ failed: true })` to explicitly mark the parent failed
+     * when any child fails — guaranteeing parent.on("failed") fires even when
+     * BullMQ's native propagation is flaky.
+     */
+    runFlowReliable<Parent = unknown>(parent: {
+        name: string;
+        queueName: string;
+        data?: Parent;
+        opts?: JobsOptions;
+    }, children: Array<{
+        name: string;
+        queueName: string;
+        data?: unknown;
+        opts?: JobsOptions;
+    }>, waitOpts?: {
+        pollIntervalMs?: number;
+        maxWaitMs?: number;
+    }): Promise<{
+        parentStatus: "completed" | "failed";
+        failedChildren: string[];
+        parentJobId: string | undefined;
+    }>;
+    /**
+     * Build a simple queue-backed retry helper that ProviderRouter can hand
+     * to its retry chain.
+     */
+    queueRetryFn<T>(queueName: string): (payload: T) => Promise<string>;
+    /** Close all resources. Idempotent. */
+    close(): Promise<void>;
+    private attachDlqListener;
+    private moveToDlq;
+}
+/** Archetype policy accessor (read-only) — exposed for tests and docs. */
+export declare function archetypePolicy(archetype: QueueArchetype): Readonly<ArchetypePolicy>;
+/** Factory — preferred over direct instantiation for testability. */
+export declare function createBullMQRunner(config: BullMQRunnerConfig): BullMQRunner;
+export {};
+//# sourceMappingURL=bullmq-runner.d.ts.map

package/dist/durable/bullmq-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq-runner.d.ts","sourceRoot":"","sources":["../../src/durable/bullmq-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,YAAY,EACZ,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,EAIL,MAAM,EACN,KAAK,aAAa,EACnB,MAAM,QAAQ,CAAC;AAChB,OAAO,OAA8B,MAAM,SAAS,CAAC;AASrD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,eAAe,CAAC;AAEhF,UAAU,eAAe;IACvB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAClE;AA2BD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,WAAW,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAIlC,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB;AA+BD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAGC;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,kBAAkB;IA2BtC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,KAAK;IAyC3D;;;OAGG;IACH,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACnC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACzC,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAiCf,oDAAoD;IACpD,YAAY,IAAI,YAAY;IAO5B,iCAAiC;IACjC,QAAQ,IAAI,KAAK,CAAC,aAAa,CAAC;IAUhC;;;;;;;OAOG;IACG,eAAe,CAAC,MAAM,GAAG,OAAO,EACpC,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,WAAW,CAAC;KACpB,EACD,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,WAAW,CAAC;KACpB,CAAC,EACF,QAAQ,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7D,OAAO,CAAC;QACT,YAAY,EAAE,WAAW,GAAG,QAAQ,CAAC;QACrC,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;KACjC,CAAC;IA4GF;;;OAGG;IACH,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC;IAQnE,uCAAuC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,OAAO,CAAC,iBAAiB;YAgDX,SAAS;CAgCxB;AAQD,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,SAAS,EAAE,cAAc,GACxB,QAAQ,CAAC,eAAe,CAAC,CAE3B;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E"}

package/dist/durable/bullmq-runner.js

@@ -0,0 +1,378 @@
+/**
+ * BullMQRunner — BullMQ v5 orchestration wrapper.
+ *
+ * Centralises queue/worker/flow creation with per-archetype defaults,
+ * Dead-Letter Queue (DLQ) handling, and OTel alerting.
+ *
+ * Design constraints:
+ * - R2-1: BullMQ parent-failed event unreliable in multi-queue flows.
+ *         Every job MUST have `attempts`, `backoff`, `removeOnFail`,
+ *         AND a DLQ receiving timeouts > N minutes + OTel alert on DLQ write.
+ * - R2-2: BullMQ v5 + Redis + Postgres job log (no Temporal, no Inngest).
+ *
+ * Archetypes:
+ * - cron          — scheduled background jobs (10min timeout, 3 attempts, exp 30s)
+ * - event         — reactive to Citadel events / webhooks (2min, 5 attempts, exp 5s)
+ * - interactive   — human-in-the-loop tasks (60min, 1 attempt, no backoff)
+ * - orchestration — parent/child DAG coordinators (30min, 2 attempts, exp 60s)
+ */
+import { FlowProducer, Queue, QueueEvents, Worker, } from "bullmq";
+import IORedis from "ioredis";
+import { SpanStatusCode, trace } from "@opentelemetry/api";
+import pino from "pino";
+// Module-level logger — pino is a direct dep of this package, no CC config import.
+const logger = pino({ level: process.env.LOG_LEVEL ?? "info" });
+const ARCHETYPE_POLICIES = {
+    cron: {
+        timeoutMs: 10 * 60_000,
+        attempts: 3,
+        backoff: { type: "exponential", delay: 30_000 },
+    },
+    event: {
+        timeoutMs: 2 * 60_000,
+        attempts: 5,
+        backoff: { type: "exponential", delay: 5_000 },
+    },
+    interactive: {
+        timeoutMs: 60 * 60_000,
+        attempts: 1,
+        backoff: null,
+    },
+    orchestration: {
+        timeoutMs: 30 * 60_000,
+        attempts: 2,
+        backoff: { type: "exponential", delay: 60_000 },
+    },
+};
+// ─── Tracer ──────────────────────────────────────────────────────────────────
+const tracer = trace.getTracer("vauban-agent-sdk.bullmq", "0.1.0");
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/** Map an archetype policy to default BullMQ JobsOptions. */
+function jobOptsFromArchetype(archetype, cfg) {
+    const policy = ARCHETYPE_POLICIES[archetype];
+    const attempts = cfg.defaultAttempts ?? policy.attempts;
+    const backoff = cfg.defaultBackoff ?? policy.backoff ?? undefined;
+    const timeoutMs = cfg.jobTimeoutMs ?? policy.timeoutMs;
+    return {
+        attempts,
+        backoff: backoff ?? undefined,
+        removeOnFail: { count: 200 },
+        removeOnComplete: { count: 1000, age: 24 * 60 * 60 },
+        jobId: undefined,
+        // @ts-expect-error — meta is custom metadata, BullMQ ignores unknown fields.
+        meta: { timeoutMs, archetype },
+    };
+}
+// ─── Runner ──────────────────────────────────────────────────────────────────
+export class BullMQRunner {
+    cfg;
+    connection;
+    sharedConnectionOpts;
+    queues = new Map();
+    queueArchetypes = new Map();
+    queueEvents = new Map();
+    workers = new Set();
+    _flow;
+    _dlq;
+    closed = false;
+    constructor(config) {
+        this.cfg = {
+            redisDb: 3,
+            dlqName: "cc-dlq",
+            ...config,
+        };
+        this.sharedConnectionOpts = {
+            maxRetriesPerRequest: null,
+            enableReadyCheck: false,
+            db: this.cfg.redisDb,
+            lazyConnect: true,
+        };
+        if (this.cfg.redisFactory) {
+            this.connection = this.cfg.redisFactory(this.cfg.redisUrl, this.cfg.redisDb);
+        }
+        else {
+            this.connection = new IORedis(this.cfg.redisUrl, this.sharedConnectionOpts);
+        }
+    }
+    /**
+     * Create (or return cached) a named queue bound to an archetype.
+     * Repeated calls with the same name return the cached queue; the archetype
+     * is validated on re-use.
+     */
+    createQueue(name, archetype) {
+        if (!name || typeof name !== "string") {
+            throw new Error("BullMQRunner.createQueue: name must be a non-empty string");
+        }
+        const existing = this.queues.get(name);
+        if (existing) {
+            const priorArchetype = this.queueArchetypes.get(name);
+            if (priorArchetype && priorArchetype !== archetype) {
+                throw new Error(`BullMQRunner.createQueue: queue "${name}" already created with archetype "${priorArchetype}", refusing "${archetype}"`);
+            }
+            return existing;
+        }
+        const defaultJobOptions = jobOptsFromArchetype(archetype, this.cfg);
+        const queueOpts = {
+            connection: this.connection,
+            defaultJobOptions,
+        };
+        const queue = new Queue(name, queueOpts);
+        this.queues.set(name, queue);
+        this.queueArchetypes.set(name, archetype);
+        if (name !== this.cfg.dlqName) {
+            this.attachDlqListener(name, archetype);
+        }
+        logger.info({
+            queue: name,
+            archetype,
+            timeoutMs: ARCHETYPE_POLICIES[archetype].timeoutMs,
+        }, "[bullmq] queue created");
+        return queue;
+    }
+    /**
+     * Create a worker bound to a queue. The processor receives BullMQ job;
+     * workers inherit the queue's archetype for lock/stall durations.
+     */
+    createWorker(queueName, processor, opts) {
+        const archetype = this.queueArchetypes.get(queueName);
+        if (!archetype) {
+            throw new Error(`BullMQRunner.createWorker: queue "${queueName}" not registered — call createQueue first`);
+        }
+        const policy = ARCHETYPE_POLICIES[archetype];
+        const lockDuration = Math.max(30_000, Math.min(policy.timeoutMs, 30 * 60_000));
+        const workerOpts = {
+            connection: this.connection,
+            lockDuration,
+            ...opts,
+        };
+        const worker = new Worker(queueName, processor, workerOpts);
+        this.workers.add(worker);
+        worker.on("error", (err) => {
+            logger.error({ err, queue: queueName }, "[bullmq] worker error");
+        });
+        logger.info({ queue: queueName, archetype, lockDuration }, "[bullmq] worker started");
+        return worker;
+    }
+    /** Lazy accessor for the FlowProducer singleton. */
+    flowProducer() {
+        if (!this._flow) {
+            this._flow = new FlowProducer({ connection: this.connection });
+        }
+        return this._flow;
+    }
+    /** Lazy accessor for the DLQ. */
+    dlqQueue() {
+        if (!this._dlq) {
+            this._dlq = this.createQueue(this.cfg.dlqName, "orchestration");
+        }
+        return this._dlq;
+    }
+    /**
+     * Parent-failed reliability helper.
+     *
+     * Wraps FlowProducer.add() and polls the parent job's
+     * `getDependencies({ failed: true })` to explicitly mark the parent failed
+     * when any child fails — guaranteeing parent.on("failed") fires even when
+     * BullMQ's native propagation is flaky.
+     */
+    async runFlowReliable(parent, children, waitOpts = {}) {
+        if (children.length === 0) {
+            throw new Error("runFlowReliable: children must be a non-empty array");
+        }
+        const flow = this.flowProducer();
+        const flowJob = {
+            name: parent.name,
+            queueName: parent.queueName,
+            data: parent.data,
+            opts: parent.opts,
+            children: children.map((c) => ({
+                name: c.name,
+                queueName: c.queueName,
+                data: c.data,
+                opts: c.opts,
+            })),
+        };
+        const tree = await flow.add(flowJob);
+        const parentJobId = tree.job.id;
+        const parentQueueName = parent.queueName;
+        const pollMs = waitOpts.pollIntervalMs ?? 500;
+        const maxWaitMs = waitOpts.maxWaitMs ?? ARCHETYPE_POLICIES.orchestration.timeoutMs;
+        const deadline = Date.now() + maxWaitMs;
+        const parentQueue = this.queues.get(parentQueueName);
+        if (!parentQueue) {
+            throw new Error(`runFlowReliable: parent queue "${parentQueueName}" not registered — call createQueue first`);
+        }
+        while (Date.now() < deadline) {
+            const parentJob = parentJobId
+                ? await parentQueue.getJob(parentJobId)
+                : null;
+            if (!parentJob) {
+                await sleep(pollMs);
+                continue;
+            }
+            const state = await parentJob.getState();
+            if (state === "completed") {
+                return { parentStatus: "completed", failedChildren: [], parentJobId };
+            }
+            if (state === "failed") {
+                const deps = await parentJob.getDependencies({
+                    failed: { count: 100 },
+                });
+                return {
+                    parentStatus: "failed",
+                    failedChildren: deps.failed ?? [],
+                    parentJobId,
+                };
+            }
+            const deps = await parentJob.getDependencies({ failed: { count: 100 } });
+            const failedKeys = deps.failed ?? [];
+            if (failedKeys.length > 0) {
+                const cause = `child_failed:${failedKeys[0]}`;
+                try {
+                    await parentJob.moveToFailed(new Error(cause), parentJob.token ?? "0", false);
+                }
+                catch (moveErr) {
+                    logger.debug({ err: moveErr, parentJobId }, "[bullmq] parent moveToFailed swallowed");
+                }
+                return {
+                    parentStatus: "failed",
+                    failedChildren: failedKeys,
+                    parentJobId,
+                };
+            }
+            await sleep(pollMs);
+        }
+        // Hit the outer deadline — mark parent failed with timeout cause.
+        const parentJob = parentJobId
+            ? await parentQueue.getJob(parentJobId)
+            : null;
+        if (parentJob) {
+            try {
+                await parentJob.moveToFailed(new Error("parent_flow_timeout"), parentJob.token ?? "0", false);
+            }
+            catch {
+                // already terminal
+            }
+        }
+        return {
+            parentStatus: "failed",
+            failedChildren: ["timeout"],
+            parentJobId,
+        };
+    }
+    /**
+     * Build a simple queue-backed retry helper that ProviderRouter can hand
+     * to its retry chain.
+     */
+    queueRetryFn(queueName) {
+        const queue = this.createQueue(queueName, "event");
+        return async (payload) => {
+            const job = await queue.add("retry", payload);
+            return job.id ?? "";
+        };
+    }
+    /** Close all resources. Idempotent. */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const closures = [];
+        for (const w of this.workers)
+            closures.push(w.close());
+        for (const q of this.queues.values())
+            closures.push(q.close());
+        for (const qe of this.queueEvents.values())
+            closures.push(qe.close());
+        if (this._flow)
+            closures.push(this._flow.close());
+        await Promise.allSettled(closures);
+        try {
+            await this.connection.quit();
+        }
+        catch {
+            // ignore quit errors on forced-close paths
+        }
+        logger.info("[bullmq] runner closed");
+    }
+    // ─── Internal ──────────────────────────────────────────────────────────────
+    attachDlqListener(queueName, archetype) {
+        const events = new QueueEvents(queueName, { connection: this.connection });
+        this.queueEvents.set(queueName, events);
+        const onFailed = async (args) => {
+            try {
+                const queue = this.queues.get(queueName);
+                if (!queue)
+                    return;
+                const job = await queue.getJob(args.jobId);
+                if (!job)
+                    return;
+                const policy = ARCHETYPE_POLICIES[archetype];
+                const attemptsMade = job.attemptsMade ?? 0;
+                const maxAttempts = job.opts.attempts ?? policy.attempts;
+                const failureReason = args.failedReason ?? "unknown_failure";
+                const isTimeout = /timeout|timed out|stalled|expired/i.test(failureReason) ||
+                    Boolean(job.processedOn && Date.now() - job.processedOn > policy.timeoutMs);
+                const exhausted = attemptsMade >= maxAttempts;
+                if (!(exhausted || isTimeout)) {
+                    return;
+                }
+                await this.moveToDlq({
+                    originalQueue: queueName,
+                    jobId: job.id,
+                    failureReason,
+                    attemptsMade,
+                    data: job.data,
+                    movedAt: new Date().toISOString(),
+                });
+            }
+            catch (err) {
+                logger.error({ err, queue: queueName }, "[bullmq] DLQ routing error");
+            }
+        };
+        events.on("failed", onFailed);
+        events.on("error", (err) => {
+            logger.error({ err, queue: queueName }, "[bullmq] QueueEvents error");
+        });
+    }
+    async moveToDlq(payload) {
+        const dlq = this.dlqQueue();
+        await dlq.add("dlq-entry", payload, {
+            attempts: 1,
+            removeOnComplete: false,
+            removeOnFail: false,
+        });
+        const span = tracer.startSpan("agent-sdk.bullmq.dlq_write");
+        try {
+            span.setAttribute("cc.bullmq.queue", payload.originalQueue);
+            span.setAttribute("cc.bullmq.job_id", payload.jobId ?? "unknown");
+            span.setAttribute("cc.bullmq.failure_reason", payload.failureReason);
+            span.setAttribute("cc.bullmq.attempts_made", payload.attemptsMade);
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: payload.failureReason,
+            });
+        }
+        finally {
+            span.end();
+        }
+        logger.error({
+            queue: payload.originalQueue,
+            jobId: payload.jobId,
+            failureReason: payload.failureReason,
+            attemptsMade: payload.attemptsMade,
+        }, "[bullmq] DLQ write");
+    }
+}
+// ─── Local helpers ───────────────────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/** Archetype policy accessor (read-only) — exposed for tests and docs. */
+export function archetypePolicy(archetype) {
+    return { ...ARCHETYPE_POLICIES[archetype] };
+}
+/** Factory — preferred over direct instantiation for testability. */
+export function createBullMQRunner(config) {
+    return new BullMQRunner(config);
+}
+//# sourceMappingURL=bullmq-runner.js.map

package/dist/durable/bullmq-runner.js.map

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

package/dist/durable/index.d.ts

@@ -0,0 +1,3 @@
+export { BullMQRunner, createBullMQRunner, archetypePolicy, } from "./bullmq-runner.js";
+export type { BullMQRunnerConfig, QueueArchetype, DlqJobPayload, IORedisLike, } from "./bullmq-runner.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/durable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/durable/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/durable/index.js

@@ -0,0 +1,2 @@
+export { BullMQRunner, createBullMQRunner, archetypePolicy, } from "./bullmq-runner.js";
+//# sourceMappingURL=index.js.map

package/dist/durable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/durable/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC"}

package/dist/economy/circuit-breaker.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Fleet-level cost circuit breaker.
+ * Pauses all new cycles when rolling spend exceeds threshold.
+ * @public
+ */
+export type CircuitState = "closed" | "open" | "half-open";
+export interface CircuitBreakerConfig {
+    /** Max USD spend in the window before tripping. Default: 10.0 */
+    thresholdUsd: number;
+    /** Rolling window duration in ms. Default: 3_600_000 (1h) */
+    windowMs: number;
+    /** How long to stay open before trying half-open. Default: 300_000 (5min) */
+    cooldownMs: number;
+}
+export declare class FleetCircuitBreaker {
+    private readonly cfg;
+    private _state;
+    private _openedAt;
+    private _halfOpenConsumed;
+    private _window;
+    private readonly _now;
+    constructor(config?: Partial<CircuitBreakerConfig>, _now?: () => number);
+    /** Returns true if a new cycle should be ALLOWED. False = circuit open. */
+    canProceed(): boolean;
+    /** Record a cycle's cost. May trip the breaker. */
+    recordCost(costUsd: number): void;
+    /** Current state. */
+    get state(): CircuitState;
+    /** Manually reset (e.g. after operator review). */
+    reset(): void;
+    /** Total spend in current window. */
+    get windowSpend(): number;
+    private _evict;
+    private _windowSpend;
+    private _trip;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/economy/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/economy/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAAE,IAAI,GAAE,MAAM,MAAiB;IAKjF,2EAA2E;IAC3E,UAAU,IAAI,OAAO;IAyBrB,mDAAmD;IACnD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAwBjC,qBAAqB;IACrB,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,mDAAmD;IACnD,KAAK,IAAI,IAAI;IAOb,qCAAqC;IACrC,IAAI,WAAW,IAAI,MAAM,CAGxB;IAID,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,KAAK;CAKd"}