@seybel/breakhound 1.0.8 → 1.0.9

package/dist/cli.js

@@ -6420,7 +6420,7 @@ async function startBridge(opts) {
       case "/breakhound/checks/progress": {
         const check = checks.get(String(body.id));
         if (check && typeof body.done === "number" && typeof body.message === "string") {
-          check.onProgress?.(body.done, body.message.slice(0, 200));
+          check.onProgress?.(body.done, body.message.slice(0, 400));
         }
         return reply({});
       }
@@ -6526,6 +6526,9 @@ async function startBridge(opts) {
   };
 }
 
+// src/icon.ts
+var ICON_PNG = "data:image/png;base64,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";
+
 // src/mcp.ts
 var PROTOCOL_VERSIONS = ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
 var INSTRUCTIONS = `breakhound finds responsive layout bugs by resizing pages in a real browser, and tells you the exact widths where they happen.
@@ -6538,12 +6541,15 @@ How to fix issues with it:
 5. When verify is clean for a route, checkpoint it. That commits the fix on its own, so it can be undone later with undo.
 Before finishing, run verify with no routes to check every page.
 
+scan and verify answer within about 45 seconds. When one says it's still running, it carries on: call it again with the same arguments to get its result, rather than something else. It says what it's waiting for; if that's the developer's browser tab, ask them to bring it into view.
+
 Issues sent from the extension are checked again in the developer's own browser: verify asks the open breakhound panel to scan the pages, so their login and browser carry over. If no panel is open, verify says so; ask the developer to open it rather than calling scan, which replaces their issues with a headless scan.`;
 var FIX_PROMPT = `Fix the responsive layout issues breakhound found in this project.
 
 Start with list_issues: if I sent them from the breakhound extension they are already there, so don't scan again. Only scan when there are none.
 Work through the errors first, then the warnings. For each one: get_issue for the details, fix the cause in the code (not overflow: hidden), verify the routes you touched, and checkpoint each route once verify is clean for it.
 Before you finish, verify with no routes to check every page, and tell me what you fixed and anything you couldn't.`;
+var REPLY_WITHIN_MS = 45e3;
 var text = (t, isError = false) => ({
   content: [{ type: "text", text: t }],
   ...isError ? { isError } : {}
@@ -6602,6 +6608,7 @@ function createTools() {
   return [
     {
       name: "scan",
+      kind: "long",
       description: "Find the app (starting its dev server if needed), discover its routes and scan each one at every width from 320 to 1920px in a headless browser. Returns every issue with its id. The result is the baseline that verify compares with, replacing any issues the developer sent from the browser extension, so check list_issues first. Takes from seconds to a few minutes on large apps.",
       inputSchema: {
         type: "object",
@@ -6629,6 +6636,7 @@ function createTools() {
     },
     {
       name: "list_routes",
+      kind: "read",
       description: "Routes from the last scan, with their status and number of issues.",
       inputSchema: { type: "object", properties: {} },
       async run(_args, ctx) {
@@ -6638,6 +6646,7 @@ function createTools() {
     },
     {
       name: "list_issues",
+      kind: "read",
       description: "Issues from the last scan or verify, each listed once even when it shows up on several routes. Filter by route or severity.",
       inputSchema: {
         type: "object",
@@ -6657,6 +6666,7 @@ function createTools() {
     },
     {
       name: "get_issue",
+      kind: "read",
       description: "Everything about one issue: the widths, the element and where it is in the code (when known), measurements, computed styles, a likely fix, every page it is on, and a screenshot.",
       inputSchema: {
         type: "object",
@@ -6687,6 +6697,7 @@ function createTools() {
     },
     {
       name: "verify",
+      kind: "long",
       description: "Scan routes again and compare with the baseline from scan: which issues are fixed, which are still there, and which are new (a change broke something, maybe at another width or on another route). Pass the routes you changed for a quick check, and nothing to check every route before you finish.",
       inputSchema: {
         type: "object",
@@ -6861,6 +6872,8 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
   let clientCanListRoots = false;
   let root = process.env.BREAKHOUND_ROOT ?? null;
   let queue = Promise.resolve();
+  let job = null;
+  const replyWithinMs = Number(process.env.BREAKHOUND_REPLY_WITHIN_MS) || REPLY_WITHIN_MS;
   const send = (message) => io.output.write(`${JSON.stringify({ jsonrpc: "2.0", ...message })}
 `);
   const request = (method, params = {}) => new Promise((resolve8, reject) => {
@@ -6890,13 +6903,17 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
     root ??= cwd;
     return root;
   }
-  async function callTool(id, params) {
-    const tool = tools.find((t) => t.name === params.name);
-    if (!tool) {
-      send({ id, error: { code: -32602, message: `Unknown tool: ${String(params.name)}` } });
-      return;
-    }
+  const progressFor = (params) => {
     const token = params._meta?.progressToken;
+    return (done, message) => {
+      if (token !== void 0)
+        send({
+          method: "notifications/progress",
+          params: { progressToken: token, progress: done, message }
+        });
+    };
+  };
+  async function runTool(tool, params, progress) {
     try {
       const dir = await projectRoot();
       const { config, warnings } = await loadConfig(dir);
@@ -6907,23 +6924,94 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
           root: dir,
           config,
           bridge,
-          progress(done, message) {
-            if (token !== void 0)
-              send({
-                method: "notifications/progress",
-                params: { progressToken: token, progress: done, message }
-              });
-          }
+          progress
         })
       );
       if (warnings.length)
         result.content.push({ type: "text", text: `Config warnings: ${warnings.join(" ")}` });
-      send({ id, result });
+      return result;
     } catch (error) {
       if (error instanceof MemoryError) server.current = null;
-      send({ id, result: text(error instanceof Error ? error.message : String(error), true) });
+      return text(error instanceof Error ? error.message : String(error), true);
     }
   }
+  const running = (j) => `${j.label} has been running for ${Math.round((Date.now() - j.startedAt) / 1e3)}s${j.latest ? ` (${j.latest})` : ""}.`;
+  async function collect(j, params) {
+    const late = new Promise((r) => setTimeout(() => r(null), replyWithinMs).unref());
+    j.waiting = progressFor(params);
+    const result = await Promise.race([j.done, late]);
+    j.waiting = null;
+    if (result) {
+      if (job === j) job = null;
+      return result;
+    }
+    return text(
+      `Still running: ${running(j)} It carries on by itself. Call ${j.name} again with the same arguments to get its result; list_issues and get_issue answer meanwhile.`
+    );
+  }
+  async function callTool(id, params) {
+    const tool = tools.find((t) => t.name === params.name);
+    if (!tool) {
+      send({ id, error: { code: -32602, message: `Unknown tool: ${String(params.name)}` } });
+      return;
+    }
+    const key = `${tool.name} ${JSON.stringify(params.arguments ?? {})}`;
+    const busy = job && !job.finished ? job : null;
+    if (tool.kind === "read") {
+      const result = await runTool(tool, params, progressFor(params));
+      if (busy)
+        result.content.push({
+          type: "text",
+          text: `Note: ${running(busy)} Call ${busy.name} again with the same arguments for its result.`
+        });
+      send({ id, result });
+      return;
+    }
+    if (job?.key === key) {
+      send({ id, result: await collect(job, params) });
+      return;
+    }
+    if (busy) {
+      send({
+        id,
+        result: text(
+          `Not yet: ${running(busy)} Call ${busy.name} again with the same arguments to get its result first.`,
+          true
+        )
+      });
+      return;
+    }
+    if (tool.kind !== "long") {
+      job = null;
+      queue = queue.then(() => runTool(tool, params, progressFor(params)));
+      send({ id, result: await queue });
+      return;
+    }
+    const args = params.arguments ?? {};
+    const routes = strings(args.routes);
+    const j = {
+      key,
+      name: tool.name,
+      label: `${tool.name}${routes.length ? ` of ${routes.join(", ")}` : ""}`,
+      startedAt: Date.now(),
+      latest: "",
+      finished: false,
+      waiting: null,
+      done: Promise.resolve(text(""))
+    };
+    j.done = queue.then(
+      () => runTool(tool, params, (done, message) => {
+        j.latest = message;
+        j.waiting?.(done, message);
+      })
+    );
+    j.done.then(() => {
+      j.finished = true;
+    });
+    queue = j.done;
+    job = j;
+    send({ id, result: await collect(j, params) });
+  }
   function handle(message) {
     const { id, method } = message;
     const params = message.params ?? {};
@@ -6948,7 +7036,13 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
           result: {
             protocolVersion: PROTOCOL_VERSIONS.includes(asked) ? asked : PROTOCOL_VERSIONS[0],
             capabilities: { tools: { listChanged: false }, prompts: { listChanged: false } },
-            serverInfo: { name: "breakhound", version: VERSION },
+            serverInfo: {
+              name: "breakhound",
+              version: VERSION,
+              // Shown beside the server by clients that show icons. No sizes: some clients' older
+              // schemas expect another shape for it, and an icon isn't worth a failed connection.
+              icons: [{ src: ICON_PNG, mimeType: "image/png" }]
+            },
             instructions: INSTRUCTIONS
           }
         });
@@ -6996,7 +7090,7 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
         });
         return;
       case "tools/call":
-        queue = queue.then(() => callTool(id, params));
+        void callTool(id, params);
         return;
       default:
         send({ id, error: { code: -32601, message: `Method not found: ${String(method)}` } });
@@ -7140,6 +7234,7 @@ function show(path, cwd) {
   const rel = relative7(cwd, path);
   return rel.startsWith("..") ? path.replace(homedir(), "~") : rel;
 }
+var NOT_SHOWING_UP = "Not showing up? Your agent runs breakhound only while this folder is open in it, and with breakhound switched on in its MCP settings (Cursor and VS Code may add it switched off), so check both. How, for each agent: https://seybel.github.io/breakhound/guide/agents#not-connected";
 async function installMcp(cwd, options = {}) {
   const home = options.home ?? homedir();
   const clients = options.clients?.length ? allClients(cwd, home).filter((c) => options.clients?.includes(c.id)) : detectClients(cwd, home);
@@ -7151,20 +7246,26 @@ async function installMcp(cwd, options = {}) {
     return 1;
   }
   const changes = [];
+  let alreadySetUp = false;
   for (const client of clients) {
     const current = existsSync15(client.file) ? readFileSync18(client.file, "utf8") : null;
     try {
       const next = client.update(current);
-      if (next === null)
+      if (next === null) {
+        alreadySetUp = true;
         console.log(
           `${styleText8("green", "\u2714")} ${client.name}: already set up in ${show(client.file, cwd)}`
         );
-      else changes.push({ client, next });
+      } else changes.push({ client, next });
     } catch (error) {
       console.log(`${styleText8("yellow", "!")} ${client.name}: ${error.message}`);
     }
   }
-  if (!changes.length) return 0;
+  if (!changes.length) {
+    if (alreadySetUp) console.log(`
+${NOT_SHOWING_UP}`);
+    return 0;
+  }
   console.log("\nbreakhound will add its MCP server to:\n");
   const { command, args } = serverCommand();
   for (const { client } of changes) {
@@ -7195,6 +7296,7 @@ async function installMcp(cwd, options = {}) {
     `
 Restart your agent (or reload its MCP servers), then ask it to "fix the responsive issues breakhound finds".`
   );
+  console.log(NOT_SHOWING_UP);
   return 0;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seybel/breakhound",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Find where your layout breaks across every viewport width, then hand the fix to your coding agent.",
   "keywords": [
     "responsive",