queue-inspector-mcp 0.1.0

package/dist/backends/bullmq.js

@@ -0,0 +1,279 @@
+import { BackendError, } from "../types.js";
+import { decodePayload, isoFromMillis, truncate } from "../format.js";
+import { scanKeys } from "../redis.js";
+import { attachScripts } from "./scripting.js";
+// State names as BullMQ itself uses them. "waiting" is the `wait` list;
+// "prioritized" and "waiting-children" only hold jobs when priorities or flows
+// are used, but are reported for completeness.
+const STATES = [
+    "waiting",
+    "active",
+    "delayed",
+    "prioritized",
+    "waiting-children",
+    "paused",
+    "completed",
+    "failed",
+];
+// Which Redis structure backs each state, and how the state maps to a key suffix.
+const LIST_STATES = {
+    waiting: "wait",
+    active: "active",
+    paused: "paused",
+};
+const ZSET_STATES = {
+    delayed: "delayed",
+    prioritized: "prioritized",
+    "waiting-children": "waiting-children",
+    completed: "completed",
+    failed: "failed",
+};
+// Terminal sets are shown most-recent-first; scheduling sets soonest-first.
+const REVERSED_ZSETS = new Set(["completed", "failed"]);
+// The classic wait-list marker id; never a real job.
+const MARKER = "0";
+const JOB_FIELDS = [
+    "name",
+    "data",
+    "opts",
+    "timestamp",
+    "delay",
+    "processedOn",
+    "finishedOn",
+    "atm",
+    "failedReason",
+];
+/**
+ * Adapter for queues managed by BullMQ (github.com/taskforcesh/bullmq).
+ *
+ * Key layout, verified against a running BullMQ worker:
+ *   bull:<q>:meta                         HASH  queue metadata (version, paused)
+ *   bull:<q>:wait / :active / :paused     LIST  of job ids
+ *   bull:<q>:delayed / :prioritized /     ZSET  of job ids
+ *     :completed / :failed
+ *   bull:<q>:<id>                         HASH  { name, data, opts, timestamp,
+ *                                                 atm, failedReason, ... }
+ * Mutations run BullMQ's own vendored scripts; see ./lua and ./scripting.ts.
+ */
+export class BullmqBackend {
+    redis;
+    prefix;
+    name = "bullmq";
+    states = STATES;
+    scripts;
+    constructor(redis, prefix = "bull") {
+        this.redis = redis;
+        this.prefix = prefix;
+        this.scripts = attachScripts(redis);
+    }
+    key(queue, suffix) {
+        return `${this.prefix}:${queue}:${suffix}`;
+    }
+    jobKey(queue, id) {
+        return `${this.prefix}:${queue}:${id}`;
+    }
+    async detectQueues() {
+        const metaKeys = await scanKeys(this.redis, `${this.prefix}:*:meta`);
+        const head = `${this.prefix}:`;
+        const names = metaKeys
+            .map((k) => k.slice(head.length, k.length - ":meta".length))
+            .filter(Boolean);
+        return [...new Set(names)].sort();
+    }
+    async assertQueue(queue) {
+        const exists = await this.redis.exists(this.key(queue, "meta"));
+        if (!exists) {
+            throw new BackendError(`bullmq queue "${queue}" was not found`, "queue_not_found");
+        }
+    }
+    async stats(queue) {
+        await this.assertQueue(queue);
+        const counts = {};
+        for (const state of STATES) {
+            if (state in LIST_STATES) {
+                counts[state] = await this.redis.llen(this.key(queue, LIST_STATES[state]));
+            }
+            else {
+                counts[state] = await this.redis.zcard(this.key(queue, ZSET_STATES[state]));
+            }
+        }
+        return counts;
+    }
+    assertState(state) {
+        if (!STATES.includes(state)) {
+            throw new BackendError(`unknown bullmq state "${state}"; expected one of ${STATES.join(", ")}`, "invalid_state");
+        }
+        return state;
+    }
+    async idsForState(queue, state, page) {
+        const stop = page.offset + page.limit - 1;
+        if (state in LIST_STATES) {
+            const ids = await this.redis.lrange(this.key(queue, LIST_STATES[state]), page.offset, stop);
+            return ids.filter((id) => id !== MARKER);
+        }
+        const key = this.key(queue, ZSET_STATES[state]);
+        return REVERSED_ZSETS.has(state)
+            ? this.redis.zrevrange(key, page.offset, stop)
+            : this.redis.zrange(key, page.offset, stop);
+    }
+    async listJobs(queue, rawState, page) {
+        await this.assertQueue(queue);
+        const state = this.assertState(rawState);
+        const ids = await this.idsForState(queue, state, page);
+        const summaries = [];
+        for (const id of ids) {
+            const hash = await this.readHash(queue, id);
+            if (hash)
+                summaries.push(this.toSummary(id, state, hash));
+        }
+        return summaries;
+    }
+    async getJob(queue, id) {
+        await this.assertQueue(queue);
+        const hash = await this.readHash(queue, id);
+        if (!hash)
+            return null;
+        const state = await this.resolveState(queue, id);
+        const decoded = decodePayload(Buffer.from(hash.data ?? "", "utf8"));
+        const timestamps = {
+            enqueuedAt: isoFromMillis(num(hash.timestamp)),
+            processedAt: isoFromMillis(num(hash.processedOn)),
+            finishedAt: isoFromMillis(num(hash.finishedOn)),
+        };
+        if (state === "delayed") {
+            const base = num(hash.timestamp) ?? 0;
+            const delay = num(hash.delay) ?? 0;
+            timestamps.processAt = isoFromMillis(base + delay);
+        }
+        const summary = this.toSummary(id, state, hash);
+        return {
+            ...summary,
+            queue,
+            backend: this.name,
+            fullError: hash.failedReason || null,
+            timestamps,
+            ...decoded,
+        };
+    }
+    async readHash(queue, id) {
+        const values = await this.redis.hmget(this.jobKey(queue, id), ...JOB_FIELDS);
+        if (values.every((v) => v === null))
+            return null;
+        const record = {};
+        JOB_FIELDS.forEach((field, i) => {
+            record[field] = values[i] ?? null;
+        });
+        return {
+            name: record.name ?? "",
+            data: record.data ?? "",
+            opts: record.opts ?? "",
+            timestamp: record.timestamp,
+            delay: record.delay,
+            processedOn: record.processedOn,
+            finishedOn: record.finishedOn,
+            atm: record.atm,
+            failedReason: record.failedReason,
+        };
+    }
+    toSummary(id, state, hash) {
+        return {
+            id,
+            type: hash.name,
+            state,
+            enqueuedAt: isoFromMillis(num(hash.timestamp)),
+            attempts: num(hash.atm) ?? 0,
+            maxRetries: this.maxRetries(hash.opts),
+            lastError: hash.failedReason ? truncate(hash.failedReason) : null,
+        };
+    }
+    maxRetries(optsJson) {
+        try {
+            const opts = JSON.parse(optsJson);
+            return typeof opts.attempts === "number" ? opts.attempts : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    isLifo(optsJson) {
+        try {
+            return Boolean(JSON.parse(optsJson).lifo);
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Determines a job's current state by membership, mirroring BullMQ's own
+     *  getState: check the terminal and scheduling sets, then the lists. */
+    async resolveState(queue, id) {
+        for (const state of ["completed", "failed", "delayed", "prioritized", "waiting-children"]) {
+            if ((await this.redis.zscore(this.key(queue, ZSET_STATES[state]), id)) !== null)
+                return state;
+        }
+        for (const state of ["active", "paused", "waiting"]) {
+            if ((await this.redis.lpos(this.key(queue, LIST_STATES[state]), id)) !== null)
+                return state;
+        }
+        // Present as a hash but not in any structure: being processed with a lock,
+        // or momentarily between states. BullMQ reports this as "active".
+        return "active";
+    }
+    async retryJob(queue, id) {
+        await this.assertQueue(queue);
+        const hash = await this.readHash(queue, id);
+        if (!hash)
+            throw new BackendError(`bullmq job "${id}" was not found in queue "${queue}"`, "job_not_found");
+        const state = await this.resolveState(queue, id);
+        if (state !== "failed" && state !== "completed") {
+            throw new BackendError(`bullmq job "${id}" is in state "${state}"; only failed or completed jobs can be retried`, "invalid_state");
+        }
+        const pushCmd = `${this.isLifo(hash.opts) ? "R" : "L"}PUSH`;
+        const propVal = state === "failed" ? "failedReason" : "returnvalue";
+        // Keys and args exactly as BullMQ's Scripts.reprocessJob builds them.
+        const result = await this.scripts.reprocessJob([
+            this.jobKey(queue, id),
+            this.key(queue, "events"),
+            this.key(queue, state),
+            this.key(queue, "wait"),
+            this.key(queue, "meta"),
+            this.key(queue, "paused"),
+            this.key(queue, "active"),
+            this.key(queue, "marker"),
+        ], [id, pushCmd, propVal, state, "0", "0"]);
+        switch (result) {
+            case 1:
+                return { ok: true, message: `bullmq job ${id} moved back to wait in queue "${queue}"` };
+            case -1:
+                throw new BackendError(`bullmq job "${id}" was not found in queue "${queue}"`, "job_not_found");
+            case -3:
+                throw new BackendError(`bullmq job "${id}" was not in the ${state} set; its state changed concurrently`, "invalid_state");
+            default:
+                throw new BackendError(`bullmq retry returned unexpected code ${result}`, "invalid_state");
+        }
+    }
+    async deleteJob(queue, id) {
+        await this.assertQueue(queue);
+        const hash = await this.readHash(queue, id);
+        if (!hash)
+            throw new BackendError(`bullmq job "${id}" was not found in queue "${queue}"`, "job_not_found");
+        // removeChildren = 0: never cascade-delete a flow's children from here.
+        const result = await this.scripts.removeJob([this.jobKey(queue, id), this.key(queue, "repeat")], [id, 0, `${this.prefix}:${queue}:`]);
+        switch (result) {
+            case 1:
+                return { ok: true, message: `bullmq job ${id} deleted from queue "${queue}"` };
+            case 0:
+                throw new BackendError(`bullmq job "${id}" is locked (active) and cannot be deleted; let it finish or move it first`, "invalid_state");
+            case -8:
+                throw new BackendError(`bullmq job "${id}" is a job-scheduler entry and cannot be deleted this way`, "not_allowed");
+            default:
+                throw new BackendError(`bullmq delete returned unexpected code ${result}`, "invalid_state");
+        }
+    }
+}
+function num(value) {
+    if (value === null || value === "")
+        return null;
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+//# sourceMappingURL=bullmq.js.map

package/dist/backends/bullmq.js.map

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

package/dist/backends/index.d.ts

@@ -0,0 +1,19 @@
+import type { Redis } from "ioredis";
+import type { Config } from "../config.js";
+import { type BackendName, type QueueBackend, type QueueRef } from "../types.js";
+export { AsynqBackend } from "./asynq.js";
+export { BullmqBackend } from "./bullmq.js";
+/** Holds the enabled backends and maps a queue name to the backend that owns it. */
+export declare class BackendRegistry {
+    private readonly backends;
+    constructor(redis: Redis, config: Config);
+    list(): QueueBackend[];
+    allQueues(): Promise<QueueRef[]>;
+    /**
+     * Resolves which backend a queue belongs to. When `hint` is given it wins;
+     * otherwise the queue is looked up across enabled backends. An ambiguous name
+     * (present in more than one backend) is an error the caller must resolve by
+     * passing `backend` explicitly.
+     */
+    resolve(queue: string, hint?: BackendName): Promise<QueueBackend>;
+}

package/dist/backends/index.js

@@ -0,0 +1,57 @@
+import { BackendError } from "../types.js";
+import { AsynqBackend } from "./asynq.js";
+import { BullmqBackend } from "./bullmq.js";
+export { AsynqBackend } from "./asynq.js";
+export { BullmqBackend } from "./bullmq.js";
+/** Holds the enabled backends and maps a queue name to the backend that owns it. */
+export class BackendRegistry {
+    backends = new Map();
+    constructor(redis, config) {
+        for (const name of config.backends) {
+            if (name === "asynq")
+                this.backends.set(name, new AsynqBackend(redis, config.asynqPrefix));
+            if (name === "bullmq")
+                this.backends.set(name, new BullmqBackend(redis, config.bullPrefix));
+        }
+    }
+    list() {
+        return [...this.backends.values()];
+    }
+    async allQueues() {
+        const refs = [];
+        for (const backend of this.list()) {
+            for (const name of await backend.detectQueues()) {
+                refs.push({ name, backend: backend.name });
+            }
+        }
+        return refs;
+    }
+    /**
+     * Resolves which backend a queue belongs to. When `hint` is given it wins;
+     * otherwise the queue is looked up across enabled backends. An ambiguous name
+     * (present in more than one backend) is an error the caller must resolve by
+     * passing `backend` explicitly.
+     */
+    async resolve(queue, hint) {
+        if (hint) {
+            const backend = this.backends.get(hint);
+            if (!backend) {
+                throw new BackendError(`backend "${hint}" is not enabled`, "not_allowed");
+            }
+            return backend;
+        }
+        const matches = [];
+        for (const backend of this.list()) {
+            const queues = await backend.detectQueues();
+            if (queues.includes(queue))
+                matches.push(backend);
+        }
+        if (matches.length === 1)
+            return matches[0];
+        if (matches.length === 0) {
+            throw new BackendError(`queue "${queue}" was not found in any enabled backend`, "queue_not_found");
+        }
+        throw new BackendError(`queue "${queue}" exists in multiple backends (${matches.map((m) => m.name).join(", ")}); pass "backend" to choose one`, "invalid_state");
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAsD,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,oFAAoF;AACpF,MAAM,OAAO,eAAe;IACT,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEjE,YAAY,KAAY,EAAE,MAAc;QACtC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,IAAI,KAAK,OAAO;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;YAC3F,IAAI,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,GAAe,EAAE,CAAC;QAC5B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;gBAChD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,IAAkB;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,YAAY,CAAC,YAAY,IAAI,kBAAkB,EAAE,aAAa,CAAC,CAAC;YAC5E,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;YAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,YAAY,CAAC,UAAU,KAAK,wCAAwC,EAAE,iBAAiB,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,IAAI,YAAY,CACpB,UAAU,KAAK,kCAAkC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iCAAiC,EACvH,eAAe,CAChB,CAAC;IACJ,CAAC;CACF"}

package/dist/backends/lua/deleteTask.lua

@@ -0,0 +1,41 @@
+-- Transcribed verbatim from Asynq (github.com/hibiken/asynq, MIT license),
+-- internal/rdb/inspect.go `deleteTaskCmd`, version v0.25.1. This is the exact
+-- atomic script Inspector.DeleteTask() runs. It removes the task from whichever
+-- state structure holds it, cleans up the uniqueness lock, and deletes the task
+-- hash. Kept as-is so delete behaviour matches the library.
+--
+-- KEYS[1] -> task key         (asynq:{<qname>}:t:<task_id>)
+-- KEYS[2] -> all groups set   (asynq:{<qname>}:groups)
+-- ARGV[1] -> task id
+-- ARGV[2] -> queue key prefix (asynq:{<qname>}:)
+-- ARGV[3] -> group key prefix (asynq:{<qname>}:g:)
+--
+-- Returns 1 on success, 0 if not found, -1 if the task is active.
+if redis.call("EXISTS", KEYS[1]) == 0 then
+	return 0
+end
+local state, group = unpack(redis.call("HMGET", KEYS[1], "state", "group"))
+if state == "active" then
+	return -1
+end
+if state == "pending" then
+	if redis.call("LREM", ARGV[2] .. state, 0, ARGV[1]) == 0 then
+		return redis.error_reply("task is not found in list: " .. tostring(ARGV[2] .. state))
+	end
+elseif state == "aggregating" then
+	if redis.call("ZREM", ARGV[3] .. group, ARGV[1]) == 0 then
+		return redis.error_reply("task is not found in zset: " .. tostring(ARGV[3] .. group))
+	end
+	if redis.call("ZCARD", ARGV[3] .. group) == 0 then
+		redis.call("SREM", KEYS[2], group)
+	end
+else
+	if redis.call("ZREM", ARGV[2] .. state, ARGV[1]) == 0 then
+		return redis.error_reply("task is not found in zset: " .. tostring(ARGV[2] .. state))
+	end
+end
+local unique_key = redis.call("HGET", KEYS[1], "unique_key")
+if unique_key and unique_key ~= "" and redis.call("GET", unique_key) == ARGV[1] then
+	redis.call("DEL", unique_key)
+end
+return redis.call("DEL", KEYS[1])