@thynker-labs/queue-bullmq 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+import { Queue, Worker } from 'bullmq';
+import { JobQueue, Envelope, Kernel, Stores } from '@thynker-labs/core';
+
+declare const DEFAULT_QUEUE_NAME = "thynker-jobs";
+interface BullMQConfig {
+    /** Env var holding Redis URL (default REDIS_URL). */
+    redisUrlEnv?: string;
+    queueName?: string;
+}
+interface QueuedJobPayload {
+    envelope: Envelope;
+    meta?: Record<string, unknown>;
+}
+declare class BullMQJobQueue implements JobQueue {
+    private queue;
+    constructor(config: BullMQConfig);
+    enqueue(job: {
+        envelope: Envelope;
+        meta?: object;
+    }): Promise<{
+        id: string;
+    }>;
+    getQueue(): Queue<QueuedJobPayload>;
+    close(): Promise<void>;
+}
+interface BullMQWorkerOptions {
+    config: BullMQConfig;
+    kernel: Kernel;
+    stores?: Stores;
+    /** Called after a job completes (e.g. persist async chat result). */
+    onJobComplete?: (args: {
+        jobId: string;
+        envelope: Envelope;
+        meta?: Record<string, unknown>;
+        responseText?: string;
+    }) => Promise<void>;
+}
+declare function createBullMQWorker(options: BullMQWorkerOptions): Worker<QueuedJobPayload>;
+declare function createBullMQJobQueue(config: BullMQConfig): BullMQJobQueue;
+
+export { type BullMQConfig, BullMQJobQueue, type BullMQWorkerOptions, DEFAULT_QUEUE_NAME, type QueuedJobPayload, createBullMQJobQueue, createBullMQWorker };

package/dist/index.js

@@ -0,0 +1,72 @@
+// src/index.ts
+import { Queue, Worker } from "bullmq";
+var DEFAULT_QUEUE_NAME = "thynker-jobs";
+function resolveRedisUrl(config) {
+  const envName = config.redisUrlEnv ?? "REDIS_URL";
+  const url = process.env[envName];
+  if (!url) {
+    throw new Error(`Missing ${envName} \u2014 required for BullMQ queue`);
+  }
+  return url;
+}
+function connectionFromUrl(url) {
+  return { url, maxRetriesPerRequest: null };
+}
+var BullMQJobQueue = class {
+  queue;
+  constructor(config) {
+    const url = resolveRedisUrl(config);
+    this.queue = new Queue(config.queueName ?? DEFAULT_QUEUE_NAME, {
+      connection: connectionFromUrl(url)
+    });
+  }
+  async enqueue(job) {
+    const jobId = typeof job.meta === "object" && job.meta && "jobId" in job.meta && typeof job.meta.jobId === "string" ? job.meta.jobId : void 0;
+    const record = await this.queue.add("envelope", job, {
+      jobId,
+      removeOnComplete: 100,
+      removeOnFail: 500
+    });
+    return { id: record.id ?? `bull-${Date.now()}` };
+  }
+  getQueue() {
+    return this.queue;
+  }
+  async close() {
+    await this.queue.close();
+  }
+};
+function createBullMQWorker(options) {
+  const url = resolveRedisUrl(options.config);
+  const queueName = options.config.queueName ?? DEFAULT_QUEUE_NAME;
+  const worker = new Worker(
+    queueName,
+    async (job) => {
+      const { envelope, meta } = job.data;
+      const { responseText } = await options.kernel.handle(envelope);
+      if (options.onJobComplete) {
+        await options.onJobComplete({
+          jobId: job.id ?? "unknown",
+          envelope,
+          meta,
+          responseText
+        });
+      }
+      return { responseText };
+    },
+    { connection: connectionFromUrl(url) }
+  );
+  worker.on("failed", (job, err) => {
+    console.error(`[bullmq] job ${job?.id} failed:`, err.message);
+  });
+  return worker;
+}
+function createBullMQJobQueue(config) {
+  return new BullMQJobQueue(config);
+}
+export {
+  BullMQJobQueue,
+  DEFAULT_QUEUE_NAME,
+  createBullMQJobQueue,
+  createBullMQWorker
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@thynker-labs/queue-bullmq",
+  "version": "0.0.1",
+  "description": "BullMQ JobQueue adapter and worker for deferred agent tasks",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "bullmq": "5.56.0",
+    "ioredis": "5.6.1",
+    "@thynker-labs/core": "0.0.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}