bullpane 0.6.0 → 0.6.1

package/dist/lua/searchJobs.lua

@@ -16,7 +16,10 @@
   ARGV[9]     byteBudget: stop the call once this many payload bytes were copied
               into Lua, even if `batch` hashes were not reached. The cursor comes
               back as usual and the UI keeps streaming.
-  ARGV[10..]  hash fields to HMGET (must include name, data, failedReason)
+  ARGV[10]    group id (BullMQ Pro), or "" for no group filter
+  ARGV[11]    the hash fields that may hold the group id, comma separated
+              (GROUP_ID_FIELDS in keys.ts); `opts.group.id` is the fallback
+  ARGV[12..]  hash fields to HMGET (must include name, data, failedReason)
 
   Returns { matches, nextCursor, scanned, total, skipped }
     matches     rows shaped exactly like getJobs.lua rows (…, dataTruncated, dataBytes)
@@ -30,6 +33,11 @@
   call independent of both queue size and payload size: at most `batch` hashes
   and at most `byteBudget` payload bytes. Before them a search over 1000 × 1 MB
   jobs kept Redis busy for 13 s; with them a call is a few milliseconds.
+
+  With a group id, a job outside the group costs one HMGET of its group fields
+  and opts (a few hundred bytes, counted in the byte budget) and its payload is
+  never read. Pro keeps a group's delayed, failed and completed jobs in the
+  queue-wide state keys, so this is the only way to list them per group.
 ]]
 local rcall = redis.call
 local key = KEYS[1]
@@ -42,9 +50,14 @@ local qprefix = ARGV[6]
 local previewBytes = tonumber(ARGV[7])
 local maxFieldBytes = tonumber(ARGV[8])
 local byteBudget = tonumber(ARGV[9])
+local group = ARGV[10]
+
+local groupFields = {}
+for f in string.gmatch(ARGV[11], "[^,]+") do groupFields[#groupFields + 1] = f end
+groupFields[#groupFields + 1] = "opts"
 
 local fields = {}
-for i = 10, #ARGV do fields[#fields + 1] = ARGV[i] end
+for i = 12, #ARGV do fields[#fields + 1] = ARGV[i] end
 local SKIP = "\0skip"
 
 local dataIdx, retIdx, nameIdx, reasonIdx = nil, nil, nil, nil
@@ -83,9 +96,25 @@ local function has(hay, needle)
   return hay and string.find(string.lower(hay), needle, 1, true) ~= nil
 end
 
+-- Exact group match: a group id field on the hash, else opts.group.id. opts is
+-- only decoded when it contains the id as plain text, so most misses cost a find.
+local function inGroup(hkey)
+  local vals = rcall("HMGET", hkey, unpack(groupFields))
+  local opts = vals[#vals]
+  if opts then bytes = bytes + #opts end
+  for i = 1, #vals - 1 do
+    if vals[i] then return vals[i] == group end
+  end
+  if not opts or not string.find(opts, group, 1, true) then return false end
+  local ok, decoded = pcall(cjson.decode, opts)
+  if not ok or type(decoded) ~= "table" or type(decoded.group) ~= "table" then return false end
+  local id = decoded.group.id
+  return id ~= nil and tostring(id) == group
+end
+
 for _, id in ipairs(ids) do
   scanned = scanned + 1
-  if string.sub(id, 1, 2) ~= "0:" then
+  if string.sub(id, 1, 2) ~= "0:" and (group == "" or inGroup(qprefix .. id)) then
     local hkey = qprefix .. id
     local dataBytes = dataIdx and rcall("HSTRLEN", hkey, "data") or 0
     local retBytes = retIdx and rcall("HSTRLEN", hkey, "returnvalue") or 0
@@ -129,12 +158,13 @@ for _, id in ipairs(ids) do
           break
         end
       end
-      if bytes >= byteBudget then
-        stoppedEarly = true
-        break
-      end
     end
   end
+  -- Also after a group miss: those read opts, which counts against the budget.
+  if bytes >= byteBudget then
+    stoppedEarly = true
+    break
+  end
 end
 
 local nextCursor = cursor + scanned

package/dist/server.mjs

@@ -254,10 +254,16 @@ var listJobsQuerySchema = z.object({
 });
 var searchJobsQuerySchema = z.object({
   state: jobStateSchema.default("failed"),
-  q: z.string().min(1).max(500),
+  q: z.string().max(500).default(""),
+  /**
+   * BullMQ Pro: only jobs of this group (exact id). A delayed, failed or completed
+   * job sits in the queue-wide state key, not under its group, so this is the only
+   * way to list a group's jobs outside `waiting`. With it, `q` may be empty.
+   */
+  groupId: z.string().min(1).max(200).optional(),
   cursor: z.string().optional(),
   limit: z.coerce.number().int().min(1).max(200).default(50)
-});
+}).refine((v) => v.q.length > 0 || v.groupId !== void 0, { message: "q or groupId is required", path: ["q"] });
 var hideQueueSchema = z.object({
   queueName: z.string().min(1).max(255)
 });
@@ -1344,7 +1350,7 @@ var PgInspector = class {
    */
   async searchJobs(queueName, state, query, opts) {
     const s = STATE_SQL[state];
-    if (!s) return { jobs: [], nextCursor: null, scanned: 0, total: 0, skippedLargePayloads: 0 };
+    if (!s || opts.groupId !== void 0) return { jobs: [], nextCursor: null, scanned: 0, total: 0, skippedLargePayloads: 0 };
     const cursor = Math.max(0, Math.trunc(Number(opts.cursor ?? 0)) || 0);
     const limit = Math.max(1, opts.limit);
     const ob = orderBy(state, "desc");
@@ -2300,6 +2306,7 @@ var DEFAULTS2 = {
   discoveryTtlMs: 3e4,
   previewBytes: 2048,
   maxScanPerCall: 1e3,
+  groupScanPerCall: 1e4,
   connectTimeoutMs: 5e3,
   maxScanIterations: 2e3,
   discoveryScanBudgetMs: 1500,
@@ -2775,22 +2782,28 @@ var RedisInspector = class {
    * are not read at all), plain substring match done in Lua. The cursor is the
    * index of the next job (newest = 0). Measured: 1000 × 1 MB jobs used to hold
    * Redis for 13 s per call; both bounds keep a call in the milliseconds.
+   *
+   * `groupId` filters before any payload is read (one HMGET of the group fields
+   * and opts per job), so a group scan covers groupScanPerCall jobs per call.
    */
   async searchJobs(queueName, state, query, opts) {
     const c = await this.ensureConnected();
     const cursor = Math.max(0, toInt(opts.cursor ?? "0", 0));
+    const group = opts.groupId ?? "";
     const reply = asArray(
       await callScript(c, "getJobsSearch", [
         stateKey(this.config.prefix, queueName, state),
         STATE_KEY[state].type,
         cursor,
-        this.opts.maxScanPerCall,
+        group ? this.opts.groupScanPerCall : this.opts.maxScanPerCall,
         query.toLowerCase(),
         Math.max(1, opts.limit),
         queueKeyPrefix(this.config.prefix, queueName),
         this.opts.previewBytes,
         this.opts.searchFieldCapBytes,
         this.opts.searchByteBudget,
+        group,
+        GROUP_ID_FIELDS.join(","),
         ...JOB_SUMMARY_FIELDS
       ])
     );
@@ -6470,7 +6483,7 @@ async function jobRoutes(app) {
     const query = searchJobsQuerySchema.parse(request.query);
     const inspector = await app.ctx.connections.getInspector(request.params.id);
     return withRedis(
-      () => inspector.searchJobs(request.params.queue, query.state, query.q, { cursor: query.cursor ?? null, limit: query.limit })
+      () => inspector.searchJobs(request.params.queue, query.state, query.q, { cursor: query.cursor ?? null, limit: query.limit, groupId: query.groupId })
     );
   });
   app.post(base, { preHandler: [operator] }, async (request, reply) => {
@@ -9199,21 +9212,31 @@ var MCP_TOOLS = [
   tool({
     name: "search_jobs",
     title: "Search jobs",
-    description: "Searches the jobs of one state for a text in the job id, name, data or failure reason. Scans in pages: pass next_cursor back as cursor to continue.",
+    description: "Searches the jobs of one state for a text in the job id, name, data or failure reason. With group_id (BullMQ Pro) only that group's jobs are returned and query may be omitted: this is how to list a group's delayed, failed or completed jobs, which list_groups does not count. Scans in pages: pass next_cursor back as cursor to continue.",
     access: "read",
     inputSchema: object(
       {
         ...QUEUE,
-        query: str4("Text to look for"),
+        query: str4("Text to look for (optional with group_id)"),
+        group_id: str4("BullMQ Pro group id (exact): only jobs of this group"),
         state: str4("Job state to search", { enum: [...JOB_STATES], default: "failed" }),
         cursor: str4("Cursor from a previous call's nextCursor"),
         limit: int3("Max matches", 1, 200)
       },
-      ["connection_id", "queue", "query"]
+      ["connection_id", "queue"]
     ),
     annotations: ro,
-    schema: zQueue.extend({ query: z10.string().min(1).max(500), state: zState.optional(), cursor: z10.string().optional(), limit: z10.number().int().min(1).max(200).optional() }),
-    run: (a, ctx) => forward(ctx, { method: "GET", url: `${queuePath(a)}/jobs/search${qs({ q: a.query, state: a.state, cursor: a.cursor, limit: a.limit })}` })
+    schema: zQueue.extend({
+      query: z10.string().max(500).optional(),
+      group_id: z10.string().min(1).max(200).optional(),
+      state: zState.optional(),
+      cursor: z10.string().optional(),
+      limit: z10.number().int().min(1).max(200).optional()
+    }).refine((a) => !!a.query || !!a.group_id, { message: "query or group_id is required", path: ["query"] }),
+    run: (a, ctx) => forward(ctx, {
+      method: "GET",
+      url: `${queuePath(a)}/jobs/search${qs({ q: a.query || void 0, groupId: a.group_id, state: a.state, cursor: a.cursor, limit: a.limit })}`
+    })
   }),
   tool({
     name: "get_job",
@@ -9248,7 +9271,7 @@ var MCP_TOOLS = [
   tool({
     name: "list_groups",
     title: "List groups (BullMQ Pro)",
-    description: "BullMQ Pro groups of a queue: status (rate limited, paused, maxed), waiting and active per group. Empty on plain BullMQ.",
+    description: "BullMQ Pro groups of a queue: status (rate limited, paused, maxed), waiting and active per group. Empty on plain BullMQ. Delayed jobs are not under their group in Pro, so a group with only delayed jobs is not listed: use search_jobs with group_id and state delayed.",
     access: "read",
     inputSchema: object({ ...QUEUE, page: int3("Page, from 1", 1, 1e4), page_size: int3("Per page", 1, 200) }, ["connection_id", "queue"]),
     annotations: ro,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bullpane",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Self-hosted dashboard for BullMQ and BullMQ Pro, on Redis or on BullMQ 6's Postgres backend: queues, jobs, failures, metrics, server health, flows and Pro groups. A bull-board alternative you can run with npx.",
   "keywords": [
     "bullmq",

package/web/assets/{FlowsPage-CRkXK3KR.js → FlowsPage-BAChK8uT.js}

@@ -1,4 +1,4 @@
-import{c as ae,u as $,a as Z,j as e,L as G,P as _,S as J,E as A,W as O,N as ne,r as N,b as oe,d as re,e as le,f as c,g as ie,h as de,i as ce,k as S,l as v,B as b,R as ue,m as me,n as F,I as xe,o as R,p as K,q as U,t as E,T as ge,s as P,v as X,D as he,w as pe,x as fe}from"./index-xn9W6Th4.js";import{u as be,a as je,l as H,i as ve,B as Ne,b as we,C as ye,M as ke,c as Ce,H as V,P as Q}from"./flowLayout-CPGuWm9t.js";/**
+import{c as ae,u as $,a as Z,j as e,L as G,P as _,S as J,E as A,W as O,N as ne,r as N,b as oe,d as re,e as le,f as c,g as ie,h as de,i as ce,k as S,l as v,B as b,R as ue,m as me,n as F,I as xe,o as R,p as K,q as U,t as E,T as ge,s as P,v as X,D as he,w as pe,x as fe}from"./index-BuZ0fAkt.js";import{u as be,a as je,l as H,i as ve,B as Ne,b as we,C as ye,M as ke,c as Ce,H as V,P as Q}from"./flowLayout-g8b3XZHS.js";/**
  * @license lucide-react v0.469.0 - ISC
  *
  * This source code is licensed under the ISC license.

package/web/assets/{JobTreePage-CcNNhc6M.js → JobTreePage-Vvq6aoQU.js}

@@ -1,4 +1,4 @@
-import{c as T,b as B,y as L,J as P,j as e,P as g,K as b,S as $,E as f,p as x,r as u,n as z,M as w,l as p,C as F,f as h,O as j,v as N,o as K,Q as O,U as S,V as y}from"./index-xn9W6Th4.js";import{u as A,a as H,i as q,B as I,b as J,C as V,M as G,l as R,c as D,H as k,P as v}from"./flowLayout-CPGuWm9t.js";/**
+import{c as T,b as B,y as L,J as P,j as e,P as g,K as b,S as $,E as f,p as x,r as u,n as z,M as w,l as p,C as F,f as h,O as j,v as N,o as K,Q as O,U as S,V as y}from"./index-BuZ0fAkt.js";import{u as A,a as H,i as q,B as I,b as J,C as V,M as G,l as R,c as D,H as k,P as v}from"./flowLayout-g8b3XZHS.js";/**
  * @license lucide-react v0.469.0 - ISC
  *
  * This source code is licensed under the ISC license.

package/web/assets/{McpConsentPage-BXb_LIdx.js → McpConsentPage-BHmbIbrR.js}

@@ -1 +1 @@
-import{y as S,z as P,e as N,j as e,A as o,C as M,S as C,N as A,F as B,G as q,f as p,n as j,B as m,H as E,v as z}from"./index-xn9W6Th4.js";function L(){const[n]=S(),t=P(),{user:s,loading:a}=N(),r=n.get("error"),i=n.get("request");return r||!i?e.jsx(o,{title:"Could not connect to Bullpane",children:e.jsxs("p",{className:"flex gap-2 text-sm text-fg",children:[e.jsx(M,{className:"mt-0.5 size-4 shrink-0 text-danger"}),r??"This page needs a sign-in request from an MCP client. Start the connection again from Claude."]})}):a?e.jsx("div",{className:"flex min-h-screen items-center justify-center",children:e.jsx(C,{})}):s?e.jsx(D,{request:i}):e.jsx(A,{to:"/login",replace:!0,state:{from:t}})}function D({request:n}){const{user:t}=N(),s=B(n),a=q(),[r,i]=p.useState(null),[f,g]=p.useState(null);if(s.isLoading)return e.jsx("div",{className:"flex min-h-screen items-center justify-center",children:e.jsx(C,{})});if(s.isError||!s.data)return e.jsx(o,{title:"Could not connect to Bullpane",children:e.jsx("p",{className:"text-sm text-fg",children:j(s.error,"This sign-in request is no longer valid. Start the connection again from Claude.")})});const{clientName:c,redirectHost:w,allowed:l,requested:y,maxAccess:k}=s.data,d=r??(l==="write"&&y==="write"?"write":"read"),h=l==="write"?null:k!=="write"?"an admin limited MCP to read only":`your role is ${t==null?void 0:t.role}`,x=v=>{g(null),a.mutate({request:n,approve:v,access:d},{onSuccess:({redirectTo:u})=>window.location.assign(u),onError:u=>g(j(u))})};return l==="off"?e.jsxs(o,{title:"MCP is turned off",children:[e.jsxs("p",{className:"text-sm text-fg-muted",children:["An admin has to allow MCP clients in ",e.jsx("span",{className:"text-fg",children:"Settings → MCP"})," before ",c," can connect."]}),e.jsxs(m,{className:"mt-5 w-full",variant:"secondary",loading:a.isPending,onClick:()=>x(!1),children:["Back to ",c]})]}):e.jsxs(o,{title:`Connect ${c} to Bullpane`,description:e.jsxs(e.Fragment,{children:["It will act as ",e.jsx("span",{className:"text-fg",children:t==null?void 0:t.email})," (",t==null?void 0:t.role,") and send you back to ",w,"."]}),children:[e.jsxs("div",{className:"flex flex-col gap-2",role:"radiogroup","aria-label":"Access",children:[e.jsx(b,{selected:d==="read",onSelect:()=>i("read"),title:"Read only",detail:"See connections, queues, jobs, logs and schedulers."}),e.jsx(b,{selected:d==="write",disabled:l!=="write",onSelect:()=>i("write"),title:"Read & write",detail:h?`Not available: ${h}.`:"Also retry, promote, remove and add jobs, pause and resume queues."})]}),e.jsxs("p",{className:"mt-3 flex gap-1.5 text-[11px] text-fg-subtle",children:[e.jsx(E,{className:"size-3.5 shrink-0"}),"Every change is in the audit log. Drain, clean and obliterate always need you in the dashboard. Disconnect any time in Settings → MCP."]}),f&&e.jsx("p",{className:"mt-3 text-xs text-danger",children:f}),e.jsxs("div",{className:"mt-5 flex gap-2",children:[e.jsx(m,{className:"flex-1",variant:"ghost",disabled:a.isPending,onClick:()=>x(!1),children:"Cancel"}),e.jsx(m,{className:"flex-1",variant:"primary",loading:a.isPending,onClick:()=>x(!0),children:"Allow"})]})]})}function b({selected:n,disabled:t,onSelect:s,title:a,detail:r}){return e.jsxs("button",{type:"button",role:"radio","aria-checked":n,disabled:t,onClick:s,className:z("rounded-md border px-3 py-2.5 text-left transition-colors disabled:cursor-not-allowed disabled:opacity-60",n?"border-accent bg-accent/10":"border-border bg-surface-2 hover:border-border-strong"),children:[e.jsx("span",{className:"block text-sm font-medium text-fg",children:a}),e.jsx("span",{className:"mt-0.5 block text-xs text-fg-muted",children:r})]})}export{L as McpConsentPage};
+import{y as S,z as P,e as N,j as e,A as o,C as M,S as C,N as A,F as B,G as q,f as p,n as j,B as m,H as E,v as z}from"./index-BuZ0fAkt.js";function L(){const[n]=S(),t=P(),{user:s,loading:a}=N(),r=n.get("error"),i=n.get("request");return r||!i?e.jsx(o,{title:"Could not connect to Bullpane",children:e.jsxs("p",{className:"flex gap-2 text-sm text-fg",children:[e.jsx(M,{className:"mt-0.5 size-4 shrink-0 text-danger"}),r??"This page needs a sign-in request from an MCP client. Start the connection again from Claude."]})}):a?e.jsx("div",{className:"flex min-h-screen items-center justify-center",children:e.jsx(C,{})}):s?e.jsx(D,{request:i}):e.jsx(A,{to:"/login",replace:!0,state:{from:t}})}function D({request:n}){const{user:t}=N(),s=B(n),a=q(),[r,i]=p.useState(null),[f,g]=p.useState(null);if(s.isLoading)return e.jsx("div",{className:"flex min-h-screen items-center justify-center",children:e.jsx(C,{})});if(s.isError||!s.data)return e.jsx(o,{title:"Could not connect to Bullpane",children:e.jsx("p",{className:"text-sm text-fg",children:j(s.error,"This sign-in request is no longer valid. Start the connection again from Claude.")})});const{clientName:c,redirectHost:w,allowed:l,requested:y,maxAccess:k}=s.data,d=r??(l==="write"&&y==="write"?"write":"read"),h=l==="write"?null:k!=="write"?"an admin limited MCP to read only":`your role is ${t==null?void 0:t.role}`,x=v=>{g(null),a.mutate({request:n,approve:v,access:d},{onSuccess:({redirectTo:u})=>window.location.assign(u),onError:u=>g(j(u))})};return l==="off"?e.jsxs(o,{title:"MCP is turned off",children:[e.jsxs("p",{className:"text-sm text-fg-muted",children:["An admin has to allow MCP clients in ",e.jsx("span",{className:"text-fg",children:"Settings → MCP"})," before ",c," can connect."]}),e.jsxs(m,{className:"mt-5 w-full",variant:"secondary",loading:a.isPending,onClick:()=>x(!1),children:["Back to ",c]})]}):e.jsxs(o,{title:`Connect ${c} to Bullpane`,description:e.jsxs(e.Fragment,{children:["It will act as ",e.jsx("span",{className:"text-fg",children:t==null?void 0:t.email})," (",t==null?void 0:t.role,") and send you back to ",w,"."]}),children:[e.jsxs("div",{className:"flex flex-col gap-2",role:"radiogroup","aria-label":"Access",children:[e.jsx(b,{selected:d==="read",onSelect:()=>i("read"),title:"Read only",detail:"See connections, queues, jobs, logs and schedulers."}),e.jsx(b,{selected:d==="write",disabled:l!=="write",onSelect:()=>i("write"),title:"Read & write",detail:h?`Not available: ${h}.`:"Also retry, promote, remove and add jobs, pause and resume queues."})]}),e.jsxs("p",{className:"mt-3 flex gap-1.5 text-[11px] text-fg-subtle",children:[e.jsx(E,{className:"size-3.5 shrink-0"}),"Every change is in the audit log. Drain, clean and obliterate always need you in the dashboard. Disconnect any time in Settings → MCP."]}),f&&e.jsx("p",{className:"mt-3 text-xs text-danger",children:f}),e.jsxs("div",{className:"mt-5 flex gap-2",children:[e.jsx(m,{className:"flex-1",variant:"ghost",disabled:a.isPending,onClick:()=>x(!1),children:"Cancel"}),e.jsx(m,{className:"flex-1",variant:"primary",loading:a.isPending,onClick:()=>x(!0),children:"Allow"})]})]})}function b({selected:n,disabled:t,onSelect:s,title:a,detail:r}){return e.jsxs("button",{type:"button",role:"radio","aria-checked":n,disabled:t,onClick:s,className:z("rounded-md border px-3 py-2.5 text-left transition-colors disabled:cursor-not-allowed disabled:opacity-60",n?"border-accent bg-accent/10":"border-border bg-surface-2 hover:border-border-strong"),children:[e.jsx("span",{className:"block text-sm font-medium text-fg",children:a}),e.jsx("span",{className:"mt-0.5 block text-xs text-fg-muted",children:r})]})}export{L as McpConsentPage};