bunqueue 2.8.0 → 2.8.2

package/dist/mcp/adapter.js

@@ -512,19 +512,31 @@ export class TcpBackend {
         return res.count ?? 0;
     }
     async getJobs(queue, opts) {
-        const res = await this.send({ cmd: 'GetJobs', queue, ...opts });
+        // The TCP protocol uses offset/limit; the MCP tool exposes start/end.
+        // Translate so pagination actually takes effect (issue #87).
+        const start = opts?.start ?? 0;
+        const hasEnd = opts?.end !== undefined && opts.end >= 0;
+        const res = await this.send({
+            cmd: 'GetJobs',
+            queue,
+            state: opts?.state,
+            offset: start,
+            limit: hasEnd ? Math.max(0, opts.end - start) : undefined,
+        });
         return (res.jobs ?? []).map((j) => this.parseJob(j));
     }
     async getJobCounts(queue) {
         const res = await this.send({ cmd: 'GetJobCounts', queue });
+        // Server nests the counts under `counts` (resp.counts envelope).
+        const c = res.counts ?? {};
         return {
-            waiting: res.waiting ?? 0,
-            prioritized: res.prioritized ?? 0,
-            delayed: res.delayed ?? 0,
-            active: res.active ?? 0,
-            completed: res.completed ?? 0,
-            failed: res.failed ?? 0,
-            paused: res.paused ?? 0,
+            waiting: c.waiting ?? 0,
+            prioritized: c.prioritized ?? 0,
+            delayed: c.delayed ?? 0,
+            active: c.active ?? 0,
+            completed: c.completed ?? 0,
+            failed: c.failed ?? 0,
+            paused: c.paused ?? 0,
         };
     }
     async pauseQueue(queue) {
@@ -550,7 +562,7 @@ export class TcpBackend {
     }
     async cleanQueue(queue, graceMs, state, limit) {
         const res = await this.send({ cmd: 'Clean', queue, grace: graceMs, state, limit });
-        return res.removed ?? 0;
+        return res.ids ?? [];
     }
     async isPaused(queue) {
         const res = await this.send({ cmd: 'IsPaused', queue });
@@ -653,14 +665,17 @@ export class TcpBackend {
     }
     async listWorkers() {
         const res = await this.send({ cmd: 'ListWorkers' });
-        return (res.workers ?? []).map((w) => ({
+        // Server nests workers under `data` (resp.data envelope).
+        const data = res.data;
+        const workers = data?.workers ?? res.workers ?? [];
+        return workers.map((w) => ({
             id: String(w.id),
             name: w.name,
             queues: w.queues ?? [],
             active: w.activeJobs ?? 0,
-            processed: w.processed ?? 0,
-            failed: w.failed ?? 0,
-            lastHeartbeat: w.lastHeartbeat ?? 0,
+            processed: w.processedJobs ?? w.processed ?? 0,
+            failed: w.failedJobs ?? w.failed ?? 0,
+            lastHeartbeat: w.lastSeen ?? w.lastHeartbeat ?? 0,
         }));
     }
     async getJobLogs(id) {
@@ -696,8 +711,26 @@ export class TcpBackend {
         return res.ok ?? true;
     }
     async getPerQueueStats() {
-        const res = await this.send({ cmd: 'Metrics' });
-        return res.queues ?? res;
+        // `Metrics` returns global aggregates, not a per-queue breakdown.
+        // Use `DashboardQueues`, which carries real per-queue stats (issue #87).
+        const res = await this.send({ cmd: 'DashboardQueues' });
+        const data = res.data;
+        const queues = data?.queues ?? [];
+        const result = {};
+        for (const q of queues) {
+            const name = q.name;
+            if (typeof name !== 'string')
+                continue;
+            // Match EmbeddedBackend shape: { waiting, prioritized, delayed, active, dlq }
+            result[name] = {
+                waiting: q.waiting ?? 0,
+                prioritized: q.prioritized ?? 0,
+                delayed: q.delayed ?? 0,
+                active: q.active ?? 0,
+                dlq: q.dlq ?? 0,
+            };
+        }
+        return result;
     }
     async getMemoryStats() {
         const res = await this.send({ cmd: 'Stats' });
@@ -754,4 +787,3 @@ export async function createBackend() {
     }
     return new EmbeddedBackend();
 }
-//# sourceMappingURL=adapter.js.map

package/dist/mcp/httpHandler.d.ts

@@ -21,4 +21,3 @@ export declare class HttpHandlerRegistry {
     }>;
     shutdown(): void;
 }
-//# sourceMappingURL=httpHandler.d.ts.map

package/dist/mcp/httpHandler.js

@@ -71,4 +71,3 @@ export class HttpHandlerRegistry {
         this.handlers.clear();
     }
 }
-//# sourceMappingURL=httpHandler.js.map

package/dist/mcp/index.d.ts

@@ -15,7 +15,7 @@
  *   "mcpServers": {
  *     "bunqueue": {
  *       "command": "bunx",
- *       "args": ["bunqueue-mcp"],
+ *       "args": ["--package=bunqueue", "bunqueue-mcp"],
  *       "env": { "DATA_PATH": "./data/bunq.db" }
  *     }
  *   }
@@ -28,7 +28,7 @@
  *   "mcpServers": {
  *     "bunqueue": {
  *       "command": "bunx",
- *       "args": ["bunqueue-mcp"],
+ *       "args": ["--package=bunqueue", "bunqueue-mcp"],
  *       "env": {
  *         "BUNQUEUE_MODE": "tcp",
  *         "BUNQUEUE_HOST": "localhost",
@@ -40,5 +40,4 @@
  * }
  * ```
  */
-export {};
-//# sourceMappingURL=index.d.ts.map
+declare function launch(): Promise<void>;

package/dist/mcp/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env bun
+"use strict";
 /**
  * bunqueue MCP Server
  *
@@ -15,7 +16,7 @@
  *   "mcpServers": {
  *     "bunqueue": {
  *       "command": "bunx",
- *       "args": ["bunqueue-mcp"],
+ *       "args": ["--package=bunqueue", "bunqueue-mcp"],
  *       "env": { "DATA_PATH": "./data/bunq.db" }
  *     }
  *   }
@@ -28,7 +29,7 @@
  *   "mcpServers": {
  *     "bunqueue": {
  *       "command": "bunx",
- *       "args": ["bunqueue-mcp"],
+ *       "args": ["--package=bunqueue", "bunqueue-mcp"],
  *       "env": {
  *         "BUNQUEUE_MODE": "tcp",
  *         "BUNQUEUE_HOST": "localhost",
@@ -40,94 +41,29 @@
  * }
  * ```
  */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { VERSION } from '../shared/version';
-import { createBackend } from './adapter';
-import { registerResources } from './resources';
-import { registerJobTools } from './tools/jobTools';
-import { registerJobMgmtTools } from './tools/jobMgmtTools';
-import { registerConsumptionTools } from './tools/consumptionTools';
-import { registerQueueTools } from './tools/queueTools';
-import { registerDlqTools } from './tools/dlqTools';
-import { registerCronTools } from './tools/cronTools';
-import { registerRateLimitTools } from './tools/rateLimitTools';
-import { registerWebhookTools } from './tools/webhookTools';
-import { registerWorkerMgmtTools } from './tools/workerMgmtTools';
-import { registerMonitoringTools } from './tools/monitoringTools';
-import { registerFlowTools } from './tools/flowTools';
-import { registerHandlerTools } from './tools/handlerTools';
-import { HttpHandlerRegistry } from './httpHandler';
-import { registerPrompts } from './prompts';
-import { mcpTracker } from './tools/mcpTracker';
-import { CloudAgent } from '../infrastructure/cloud/cloudAgent';
-import { getSharedManager } from '../client/manager';
-async function main() {
-    const backend = await createBackend();
-    const mode = process.env.BUNQUEUE_MODE ?? 'embedded';
-    const server = new McpServer({
-        name: 'bunqueue-mcp',
-        version: VERSION,
-    });
-    const handlerRegistry = new HttpHandlerRegistry();
-    // Register all tools (73 total) and prompts (3)
-    registerJobTools(server, backend);
-    registerJobMgmtTools(server, backend);
-    registerConsumptionTools(server, backend);
-    registerQueueTools(server, backend);
-    registerDlqTools(server, backend);
-    registerCronTools(server, backend);
-    registerRateLimitTools(server, backend);
-    registerWebhookTools(server, backend);
-    registerWorkerMgmtTools(server, backend);
-    registerMonitoringTools(server, backend);
-    registerFlowTools(server, backend);
-    registerHandlerTools(server, handlerRegistry);
-    // Register resources and prompts
-    registerResources(server, backend);
-    registerPrompts(server, backend);
-    // Start Cloud agent for MCP telemetry (embedded mode only)
-    let cloudAgent = null;
-    if (mode === 'embedded' && process.env.BUNQUEUE_CLOUD_URL) {
-        const manager = getSharedManager();
-        cloudAgent = CloudAgent.create(manager);
-        if (cloudAgent) {
-            cloudAgent.setServerHandles({
-                getConnectionCount: () => 0,
-                getWsClientCount: () => 0,
-                getSseClientCount: () => 0,
-                getMcpOperations: () => {
-                    // IMPORTANT: getSummary() MUST be called before drain() — drain empties the buffer
-                    const summary = mcpTracker.getSummary();
-                    const operations = mcpTracker.drain();
-                    return { operations, summary };
-                },
-            });
-        }
+// The MCP server implementation lives in ./server.ts and is loaded LAZILY via
+// dynamic import below. This keeps `@modelcontextprotocol/sdk` (and its zod
+// sub-dependency) out of this entrypoint's static import graph, so they can be
+// an OPTIONAL peer dependency: queue-only consumers of bunqueue never download
+// the SDK + zod + its HTTP stack (~24 MB). If a user starts `bunqueue-mcp`
+// without the SDK installed, the guard below prints an actionable install hint.
+async function launch() {
+    try {
+        const mod = await import('./server.js');
+        await mod.run();
     }
-    // Graceful shutdown — allow backend and transport to flush before exit
-    const shutdown = async () => {
-        try {
-            if (cloudAgent)
-                await cloudAgent.stop();
-            handlerRegistry.shutdown();
-            backend.shutdown();
-            await server.close();
-        }
-        catch {
-            // Ignore cleanup errors during shutdown
+    catch (err) {
+        const e = err;
+        const msg = String(e?.message ?? err);
+        const isModuleNotFound = e?.code === 'ERR_MODULE_NOT_FOUND' || /Cannot find (module|package)/i.test(msg);
+        const mentionsMcpDeps = /@modelcontextprotocol\/sdk|(^|\W)zod(\W|$)/i.test(msg);
+        if (isModuleNotFound && mentionsMcpDeps) {
+            process.stderr.write('[bunqueue-mcp] The MCP server requires "@modelcontextprotocol/sdk" (an optional peer dependency).\n' +
+                'Install it with:  bun add @modelcontextprotocol/sdk\n');
+            process.exit(1);
         }
-        process.exit(0);
-    };
-    process.on('SIGINT', () => void shutdown());
-    process.on('SIGTERM', () => void shutdown());
-    // Connect via stdio transport
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    process.stderr.write(`bunqueue MCP server started (mode: ${mode}, version: ${VERSION})\n`);
+        process.stderr.write(`Fatal error: ${err}\n`);
+        process.exit(1);
+    }
 }
-main().catch((err) => {
-    process.stderr.write(`Fatal error: ${err}\n`);
-    process.exit(1);
-});
-//# sourceMappingURL=index.js.map
+void launch();

package/dist/mcp/prompts.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from './adapter';
 export declare function registerPrompts(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=prompts.d.ts.map

package/dist/mcp/prompts.js

@@ -215,4 +215,3 @@ Identify the most likely root cause and provide specific actions using bunqueue
         }
     });
 }
-//# sourceMappingURL=prompts.js.map

package/dist/mcp/resources.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from './adapter';
 export declare function registerResources(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=resources.d.ts.map

package/dist/mcp/resources.js

@@ -93,4 +93,3 @@ export function registerResources(server, backend) {
         };
     }));
 }
-//# sourceMappingURL=resources.js.map

package/dist/mcp/server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * bunqueue MCP Server — implementation.
+ *
+ * Loaded lazily by ./index.ts (the `bunqueue-mcp` bin) via dynamic import, so
+ * that the static `@modelcontextprotocol/sdk` imports below are only resolved
+ * when the MCP server is actually started.
+ *
+ * `@modelcontextprotocol/sdk` is an OPTIONAL peer dependency (declared in
+ * package.json). `zod` (used by the tool schemas) is NOT declared by bunqueue
+ * at all — it resolves transitively from the SDK, which hard-depends on
+ * `zod: "^3.25 || ^4.0"`. Queue-only consumers download neither. If a future
+ * SDK major drops or peer-izes zod, declare zod explicitly here.
+ * See ./index.ts for the install-hint guard when the SDK is absent.
+ */
+export declare function run(): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,100 @@
+/**
+ * bunqueue MCP Server — implementation.
+ *
+ * Loaded lazily by ./index.ts (the `bunqueue-mcp` bin) via dynamic import, so
+ * that the static `@modelcontextprotocol/sdk` imports below are only resolved
+ * when the MCP server is actually started.
+ *
+ * `@modelcontextprotocol/sdk` is an OPTIONAL peer dependency (declared in
+ * package.json). `zod` (used by the tool schemas) is NOT declared by bunqueue
+ * at all — it resolves transitively from the SDK, which hard-depends on
+ * `zod: "^3.25 || ^4.0"`. Queue-only consumers download neither. If a future
+ * SDK major drops or peer-izes zod, declare zod explicitly here.
+ * See ./index.ts for the install-hint guard when the SDK is absent.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { VERSION } from '../shared/version';
+import { createBackend } from './adapter';
+import { registerResources } from './resources';
+import { registerJobTools } from './tools/jobTools';
+import { registerJobMgmtTools } from './tools/jobMgmtTools';
+import { registerConsumptionTools } from './tools/consumptionTools';
+import { registerQueueTools } from './tools/queueTools';
+import { registerDlqTools } from './tools/dlqTools';
+import { registerCronTools } from './tools/cronTools';
+import { registerRateLimitTools } from './tools/rateLimitTools';
+import { registerWebhookTools } from './tools/webhookTools';
+import { registerWorkerMgmtTools } from './tools/workerMgmtTools';
+import { registerMonitoringTools } from './tools/monitoringTools';
+import { registerFlowTools } from './tools/flowTools';
+import { registerHandlerTools } from './tools/handlerTools';
+import { HttpHandlerRegistry } from './httpHandler';
+import { registerPrompts } from './prompts';
+import { mcpTracker } from './tools/mcpTracker';
+import { CloudAgent } from '../infrastructure/cloud/cloudAgent';
+import { getSharedManager } from '../client/manager';
+export async function run() {
+    const backend = await createBackend();
+    const mode = process.env.BUNQUEUE_MODE ?? 'embedded';
+    const server = new McpServer({
+        name: 'bunqueue-mcp',
+        version: VERSION,
+    });
+    const handlerRegistry = new HttpHandlerRegistry();
+    // Register all tools (73 total) and prompts (3)
+    registerJobTools(server, backend);
+    registerJobMgmtTools(server, backend);
+    registerConsumptionTools(server, backend);
+    registerQueueTools(server, backend);
+    registerDlqTools(server, backend);
+    registerCronTools(server, backend);
+    registerRateLimitTools(server, backend);
+    registerWebhookTools(server, backend);
+    registerWorkerMgmtTools(server, backend);
+    registerMonitoringTools(server, backend);
+    registerFlowTools(server, backend);
+    registerHandlerTools(server, handlerRegistry);
+    // Register resources and prompts
+    registerResources(server, backend);
+    registerPrompts(server, backend);
+    // Start Cloud agent for MCP telemetry (embedded mode only)
+    let cloudAgent = null;
+    if (mode === 'embedded' && process.env.BUNQUEUE_CLOUD_URL) {
+        const manager = getSharedManager();
+        cloudAgent = CloudAgent.create(manager);
+        if (cloudAgent) {
+            cloudAgent.setServerHandles({
+                getConnectionCount: () => 0,
+                getWsClientCount: () => 0,
+                getSseClientCount: () => 0,
+                getMcpOperations: () => {
+                    // IMPORTANT: getSummary() MUST be called before drain() — drain empties the buffer
+                    const summary = mcpTracker.getSummary();
+                    const operations = mcpTracker.drain();
+                    return { operations, summary };
+                },
+            });
+        }
+    }
+    // Graceful shutdown — allow backend and transport to flush before exit
+    const shutdown = async () => {
+        try {
+            if (cloudAgent)
+                await cloudAgent.stop();
+            handlerRegistry.shutdown();
+            backend.shutdown();
+            await server.close();
+        }
+        catch {
+            // Ignore cleanup errors during shutdown
+        }
+        process.exit(0);
+    };
+    process.on('SIGINT', () => void shutdown());
+    process.on('SIGTERM', () => void shutdown());
+    // Connect via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`bunqueue MCP server started (mode: ${mode}, version: ${VERSION})\n`);
+}

package/dist/mcp/tools/consumptionTools.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerConsumptionTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=consumptionTools.d.ts.map

package/dist/mcp/tools/consumptionTools.js

@@ -92,4 +92,3 @@ export function registerConsumptionTools(server, backend) {
         return { content: [{ type: 'text', text: JSON.stringify({ success, jobId }) }] };
     }));
 }
-//# sourceMappingURL=consumptionTools.js.map

package/dist/mcp/tools/cronTools.d.ts

@@ -4,4 +4,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerCronTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=cronTools.d.ts.map

package/dist/mcp/tools/cronTools.js

@@ -49,4 +49,3 @@ export function registerCronTools(server, backend) {
         return { content: [{ type: 'text', text: JSON.stringify({ success, name }) }] };
     }));
 }
-//# sourceMappingURL=cronTools.js.map

package/dist/mcp/tools/dlqTools.d.ts

@@ -4,4 +4,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerDlqTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=dlqTools.d.ts.map

package/dist/mcp/tools/dlqTools.js

@@ -55,4 +55,3 @@ export function registerDlqTools(server, backend) {
         };
     }));
 }
-//# sourceMappingURL=dlqTools.js.map

package/dist/mcp/tools/flowTools.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerFlowTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=flowTools.d.ts.map

package/dist/mcp/tools/flowTools.js

@@ -84,4 +84,3 @@ export function registerFlowTools(server, backend) {
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     }));
 }
-//# sourceMappingURL=flowTools.js.map

package/dist/mcp/tools/handlerTools.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { HttpHandlerRegistry } from '../httpHandler';
 export declare function registerHandlerTools(server: McpServer, registry: HttpHandlerRegistry): void;
-//# sourceMappingURL=handlerTools.d.ts.map

package/dist/mcp/tools/handlerTools.js

@@ -64,4 +64,3 @@ export function registerHandlerTools(server, registry) {
         };
     }));
 }
-//# sourceMappingURL=handlerTools.js.map

package/dist/mcp/tools/jobMgmtTools.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerJobMgmtTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=jobMgmtTools.d.ts.map

package/dist/mcp/tools/jobMgmtTools.js

@@ -59,4 +59,3 @@ export function registerJobMgmtTools(server, backend) {
         };
     }));
 }
-//# sourceMappingURL=jobMgmtTools.js.map

package/dist/mcp/tools/jobTools.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerJobTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=jobTools.d.ts.map

package/dist/mcp/tools/jobTools.js

@@ -112,4 +112,3 @@ export function registerJobTools(server, backend) {
         return { content: [{ type: 'text', text: JSON.stringify({ jobId, completed }) }] };
     }));
 }
-//# sourceMappingURL=jobTools.js.map

package/dist/mcp/tools/mcpTracker.d.ts

@@ -50,4 +50,3 @@ declare class McpOperationTracker {
 /** Global singleton — shared between withErrorHandler (producer) and cloud agent (consumer) */
 export declare const mcpTracker: McpOperationTracker;
 export {};
-//# sourceMappingURL=mcpTracker.d.ts.map

package/dist/mcp/tools/mcpTracker.js

@@ -62,4 +62,3 @@ class McpOperationTracker {
 }
 /** Global singleton — shared between withErrorHandler (producer) and cloud agent (consumer) */
 export const mcpTracker = new McpOperationTracker();
-//# sourceMappingURL=mcpTracker.js.map

package/dist/mcp/tools/monitoringTools.d.ts

@@ -4,4 +4,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerMonitoringTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=monitoringTools.d.ts.map

package/dist/mcp/tools/monitoringTools.js

@@ -90,4 +90,3 @@ export function registerMonitoringTools(server, backend) {
         };
     }));
 }
-//# sourceMappingURL=monitoringTools.js.map

package/dist/mcp/tools/queueTools.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerQueueTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=queueTools.d.ts.map

package/dist/mcp/tools/queueTools.js

@@ -99,10 +99,13 @@ export function registerQueueTools(server, backend) {
             .describe('State to clean (default: both completed and failed)'),
         limit: z.number().optional().describe('Maximum number of jobs to remove'),
     }, withErrorHandler('bunqueue_clean_queue', async ({ queue, graceMs, state, limit }) => {
-        const removed = await backend.cleanQueue(queue, graceMs, state, limit);
+        const ids = await backend.cleanQueue(queue, graceMs, state, limit);
         return {
             content: [
-                { type: 'text', text: JSON.stringify({ success: true, queue, removed }) },
+                {
+                    type: 'text',
+                    text: JSON.stringify({ success: true, queue, removed: ids.length, ids }),
+                },
             ],
         };
     }));
@@ -112,7 +115,7 @@ export function registerQueueTools(server, backend) {
         const paused = await backend.isPaused(queue);
         return { content: [{ type: 'text', text: JSON.stringify({ queue, paused }) }] };
     }));
-    server.tool('bunqueue_get_counts_per_priority', 'Get job count breakdown by priority level for a queue.', {
+    server.tool('bunqueue_get_counts_per_priority', 'Get job count breakdown by priority level for a queue. Counts only waiting/delayed (queued) jobs — active, completed and failed jobs are not included.', {
         queue: z.string().describe('Queue name'),
     }, withErrorHandler('bunqueue_get_counts_per_priority', async ({ queue }) => {
         const counts = await backend.getCountsPerPriority(queue);
@@ -123,4 +126,3 @@ export function registerQueueTools(server, backend) {
         };
     }));
 }
-//# sourceMappingURL=queueTools.js.map

package/dist/mcp/tools/rateLimitTools.d.ts

@@ -4,4 +4,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerRateLimitTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=rateLimitTools.d.ts.map

package/dist/mcp/tools/rateLimitTools.js

@@ -60,4 +60,3 @@ export function registerRateLimitTools(server, backend) {
         };
     }));
 }
-//# sourceMappingURL=rateLimitTools.js.map

package/dist/mcp/tools/webhookTools.d.ts

@@ -4,4 +4,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerWebhookTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=webhookTools.d.ts.map

package/dist/mcp/tools/webhookTools.js

@@ -6,7 +6,7 @@ import { z } from 'zod';
 import { withErrorHandler } from './withErrorHandler';
 export function registerWebhookTools(server, backend) {
     server.tool('bunqueue_add_webhook', 'Add a webhook to receive notifications for job events.', {
-        url: z.url().describe('Webhook URL to receive POST requests'),
+        url: z.string().url().describe('Webhook URL to receive POST requests'),
         events: z
             .array(z.enum([
             'job.completed',
@@ -53,4 +53,3 @@ export function registerWebhookTools(server, backend) {
         };
     }));
 }
-//# sourceMappingURL=webhookTools.js.map

package/dist/mcp/tools/withErrorHandler.d.ts

@@ -17,4 +17,3 @@ interface ToolResult {
  */
 export declare function withErrorHandler<T>(toolName: string, fn: (args: T) => Promise<ToolResult>): (args: T) => Promise<ToolResult>;
 export {};
-//# sourceMappingURL=withErrorHandler.d.ts.map

package/dist/mcp/tools/withErrorHandler.js

@@ -69,4 +69,3 @@ function extractErrorText(result) {
     // Fall back to raw text content (truncated to avoid huge payloads)
     return text.length > 200 ? text.slice(0, 200) : text;
 }
-//# sourceMappingURL=withErrorHandler.js.map

package/dist/mcp/tools/workerMgmtTools.d.ts

@@ -5,4 +5,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { McpBackend } from '../adapter';
 export declare function registerWorkerMgmtTools(server: McpServer, backend: McpBackend): void;
-//# sourceMappingURL=workerMgmtTools.d.ts.map

package/dist/mcp/tools/workerMgmtTools.js

@@ -30,4 +30,3 @@ export function registerWorkerMgmtTools(server, backend) {
         return { content: [{ type: 'text', text: JSON.stringify({ success, workerId }) }] };
     }));
 }
-//# sourceMappingURL=workerMgmtTools.js.map

package/dist/shared/boundedMap.d.ts

@@ -28,4 +28,3 @@ export declare class BoundedMap<K, V> implements MapLike<K, V> {
     forEach(callback: (value: V, key: K) => void): void;
     [Symbol.iterator](): IterableIterator<[K, V]>;
 }
-//# sourceMappingURL=boundedMap.d.ts.map