@surething/cockpit 1.0.217 → 1.0.218

package/chrome-extension/manifest.json

@@ -30,7 +30,7 @@
   },
   "web_accessible_resources": [
     {
-      "resources": ["disguise.js", "automation.js", "network-capture.js"],
+      "resources": ["disguise.js", "automation.js", "network-capture.js", "messages.js"],
       "matches": ["<all_urls>"]
     }
   ],

package/chrome-extension/messages.js

@@ -0,0 +1,45 @@
+/**
+ * Extension-side error templates.
+ *
+ * Used by automation.js. Generated strings are returned to the CLI as
+ * `data.error` and printed verbatim — so they MUST be self-contained and
+ * include actionable next steps with generic examples (no case-specific
+ * selectors or API paths).
+ *
+ * The CLI side has its own copy in bin/cock-browser.messages.mjs; this file
+ * stays in sync manually (only ~3 templates here, drift risk is low).
+ */
+
+const EXAMPLES = Object.freeze({
+  selectorSubmit: 'button[type="submit"]',
+  selectorAriaSave: 'button[aria-label="Save"]',
+  textSignIn: 'Sign in',
+  textSave: 'Save',
+});
+
+function staleRefMsg(ref, currentEpoch, kind) {
+  return `Element ref "${ref}" is stale (current snapshot v=${currentEpoch}; kind: ${kind}).
+  Refs are valid only until the next snapshot / re-render / route change.
+  Fix one of:
+    1. Re-run \`snapshot\` to get fresh refs (look for v=${currentEpoch} in the banner).
+    2. Use a CSS selector or visible text directly:
+       cockpit browser <id> click --text "${EXAMPLES.textSignIn}"
+       cockpit browser <id> click --selector '${EXAMPLES.selectorSubmit}'
+    3. Drop to evaluate:
+       cockpit browser <id> evaluate "(() => document.querySelector('${EXAMPLES.selectorAriaSave}').click())()"`;
+}
+
+function unknownActionMsg(action, suggestions) {
+  const hint = suggestions && suggestions.length
+    ? `\n  Did you mean: ${suggestions.join(', ')}?`
+    : '';
+  return `Unknown action "${action}".${hint}
+  Run: cockpit browser --help-all`;
+}
+
+// Expose on globalThis so automation.js (loaded as module) can use them
+// without an explicit import path that differs by build mode.
+if (typeof window !== 'undefined') {
+  window.__cockpitBrowserMessages = { staleRefMsg, unknownActionMsg, EXAMPLES };
+}
+export { staleRefMsg, unknownActionMsg, EXAMPLES };

package/dist/{chunk-W6G6X3FP.mjs → chunk-WOM47O75.mjs}

@@ -88,6 +88,7 @@ function createPendingRequest(reqId, timeout) {
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
       pendingRequests.delete(reqId);
+      recordCommandResolved(reqId, false);
       reject(new Error(`Timeout after ${timeout}ms`));
     }, timeout);
     pendingRequests.set(reqId, { resolve, reject, timer });
@@ -95,15 +96,20 @@ function createPendingRequest(reqId, timeout) {
 }
 function resolvePendingRequest(reqId, ok2, data, error) {
   const pending = pendingRequests.get(reqId);
-  if (!pending) return;
+  if (!pending) {
+    recordCommandResolved(reqId, ok2);
+    return;
+  }
   clearTimeout(pending.timer);
   pendingRequests.delete(reqId);
+  recordCommandResolved(reqId, ok2);
   if (ok2) {
     pending.resolve(data);
   } else {
     pending.reject(new Error(error || "Browser command failed"));
   }
 }
+var reqIdMeta = globalThis.__cockpitBrowserReqMeta ?? (globalThis.__cockpitBrowserReqMeta = /* @__PURE__ */ new Map());
 function sendCommandToBrowser(shortId, reqId, action, params) {
   const entry = registry.get(shortId);
   if (!entry || !entry.ws || entry.ws.readyState !== WebSocket.OPEN) {
@@ -115,8 +121,48 @@ function sendCommandToBrowser(shortId, reqId, action, params) {
     action,
     params
   }));
+  reqIdMeta.set(reqId, { shortId, action });
   return true;
 }
+function recordCommandResolved(reqId, ok2) {
+  const meta = reqIdMeta.get(reqId);
+  if (!meta) return;
+  reqIdMeta.delete(reqId);
+  if (ok2) {
+    const entry = registry.get(meta.shortId);
+    if (entry) {
+      entry.lastSuccessTs = Date.now();
+      entry.lastSuccessAction = meta.action;
+      entry.lastSeen = Date.now();
+    }
+  }
+}
+function getBrowserHealth(shortId) {
+  const entry = registry.get(shortId);
+  if (!entry) {
+    return {
+      found: false,
+      ws: "unknown",
+      lastSeenMs: null,
+      lastSuccessMs: null,
+      lastSuccessAction: null,
+      pendingCommands: 0
+    };
+  }
+  const now = Date.now();
+  let pending = 0;
+  for (const reqId of pendingRequests.keys()) {
+    if (reqIdMeta.get(reqId)?.shortId === shortId) pending += 1;
+  }
+  return {
+    found: true,
+    ws: entry.ws && entry.ws.readyState === WebSocket.OPEN ? "open" : "closed",
+    lastSeenMs: entry.lastSeen ? now - entry.lastSeen : null,
+    lastSuccessMs: entry.lastSuccessTs ? now - entry.lastSuccessTs : null,
+    lastSuccessAction: entry.lastSuccessAction ?? null,
+    pendingCommands: pending
+  };
+}
 
 // packages/feature/console/src/server/plugins/jupyter/JupyterKernelManager.ts
 import { spawn } from "child_process";
@@ -1121,6 +1167,8 @@ export {
   createPendingRequest,
   resolvePendingRequest,
   sendCommandToBrowser,
+  recordCommandResolved,
+  getBrowserHealth,
   kernelManager,
   registerTerminal,
   finalizeTerminal,

package/dist/httpApi.mjs

@@ -3,6 +3,7 @@ import {
   addOutputListener,
   createPendingRequest,
   getBrowserByShortId,
+  getBrowserHealth,
   getFirstAvailableLine,
   getRunningCommand,
   getTerminalByShortId,
@@ -20,7 +21,7 @@ import {
   unregisterBrowser,
   unregisterTerminal,
   writeStdinToCommand
-} from "./chunk-W6G6X3FP.mjs";
+} from "./chunk-WOM47O75.mjs";
 import {
   getTerminalHistoryPath
 } from "./chunk-GCYLMG43.mjs";
@@ -391,36 +392,95 @@ async function handleBrowserApi(req, res) {
     sendJson(200, { ok: true });
     return true;
   }
+  if (action === "health" && !cmdParams?.deep) {
+    if (!id) {
+      sendJson(400, { ok: false, error: "Missing browser id" });
+      return true;
+    }
+    sendJson(200, { ok: true, data: getBrowserHealth(id) });
+    return true;
+  }
   if (!id) {
     sendJson(400, { ok: false, error: "Missing browser id" });
     return true;
   }
   const browser = getBrowserByShortId(id);
   if (!browser) {
-    sendJson(404, { ok: false, error: `Browser "${id}" not found` });
+    const all = listBrowsers().map((b) => b.shortId);
+    const suggestions = fuzzyTopK(id, all, 3);
+    const hint = suggestions.length ? `
+  Did you mean: ${suggestions.join(", ")}?` : all.length ? `
+  Available: ${all.join(", ")}` : "\n  No browsers currently connected. Open a browser bubble in the cockpit console.";
+    sendJson(404, {
+      ok: false,
+      error: `Browser "${id}" not found.${hint}
+  Run: cockpit browser list`
+    });
     return true;
   }
   if (!browser.ws || browser.ws.readyState !== WebSocket.OPEN) {
     sendJson(503, {
       ok: false,
-      error: `Browser "${id}" is disconnected`
+      error: `Browser "${id}" is disconnected (WS closed).
+  Recover:
+    1. Refresh the browser tab to re-register the extension.
+    2. Run \`cockpit browser list\` to confirm the shortId.
+    3. If the bubble is gone, re-open it from the cockpit console panel.`
     });
     return true;
   }
+  const wsAction = action === "health" ? "health_deep" : action;
   const reqId = `r-${randomUUID().slice(0, 8)}`;
-  const sent = sendCommandToBrowser(id, reqId, action, cmdParams);
+  const sent = sendCommandToBrowser(id, reqId, wsAction, cmdParams);
   if (!sent) {
-    sendJson(503, { ok: false, error: "Failed to send command" });
+    sendJson(503, { ok: false, error: "Failed to send command (WS write failed)" });
     return true;
   }
   try {
     const data = await createPendingRequest(reqId, timeout);
     sendJson(200, { ok: true, data });
   } catch (err) {
-    sendJson(504, { ok: false, error: err.message });
+    const msg = err.message;
+    if (/timeout/i.test(msg)) {
+      const h = getBrowserHealth(id);
+      sendJson(504, {
+        ok: false,
+        error: `${msg} (action "${action}").
+  Bridge state: ws=${h.ws} pending=${h.pendingCommands}` + (h.lastSuccessMs !== null ? ` lastSuccess=${Math.round(h.lastSuccessMs / 1e3)}s ago (${h.lastSuccessAction})` : "") + `
+  Diagnose:
+    cockpit browser ${id} health                # cheap server-side probe
+    cockpit browser ${id} wait --extension-ready (Phase 2)
+  If the bridge state shows fresh activity, the page itself is blocked.
+  Consider a service-level test if driven by an async LLM/agent flow.`
+      });
+    } else {
+      sendJson(504, { ok: false, error: msg });
+    }
   }
   return true;
 }
+function fuzzyTopK(input, candidates, k) {
+  if (!input || !candidates.length) return [];
+  const inputLow = input.toLowerCase();
+  const bag = bagCounts(inputLow);
+  const scored = candidates.map((c) => {
+    const cl = c.toLowerCase();
+    const cBag = bagCounts(cl);
+    let inter = 0;
+    for (const [ch, n] of bag) inter += Math.min(n, cBag.get(ch) ?? 0);
+    const ratio = inter / Math.max(inputLow.length, cl.length);
+    const startsWith = cl.startsWith(inputLow) ? 0.5 : 0;
+    const contains = cl.includes(inputLow) ? 0.3 : 0;
+    return { c, score: ratio + startsWith + contains };
+  });
+  scored.sort((a, b) => b.score - a.score);
+  return scored.slice(0, k).filter((s) => s.score >= 0.6).map((s) => s.c);
+}
+function bagCounts(s) {
+  const m = /* @__PURE__ */ new Map();
+  for (const ch of s) m.set(ch, (m.get(ch) ?? 0) + 1);
+  return m;
+}
 async function handleConnectionApi(req, res) {
   const { pathname } = parse(req.url || "", true);
   const match = pathname?.match(/^\/api\/connection\/([a-z]+)$/);

package/dist/scheduledTasks.mjs

@@ -75,7 +75,12 @@ var sendChatMessageEff = (task) => {
       "WebFetch",
       "WebSearch",
       "Task",
-      "TodoWrite",
+      // Task management — claude-agent-sdk@0.3.142 replaced TodoWrite
+      // with per-task TaskCreate/Update/Get/List events.
+      "TaskCreate",
+      "TaskUpdate",
+      "TaskGet",
+      "TaskList",
       "mcp__*"
     ],
     permissionMode: "bypassPermissions",

package/dist/{server-ZBUZ24TC.mjs → server-SNB4H35J.mjs}

@@ -11,6 +11,7 @@ import {
   findSafeStart,
   getAllProjectCwds,
   getBrowserByShortId,
+  getBrowserHealth,
   getFirstAvailableLine,
   getLinesView,
   getRegistrySize,
@@ -29,6 +30,7 @@ import {
   readHead,
   readSince,
   readTail,
+  recordCommandResolved,
   registerBrowser,
   registerCommand,
   registerTerminal,
@@ -39,7 +41,7 @@ import {
   unregisterTerminal,
   updateBrowserWs,
   writeStdinToCommand
-} from "./chunk-W6G6X3FP.mjs";
+} from "./chunk-WOM47O75.mjs";
 import {
   createNeo4jDriver,
   runCypherWithDriver,
@@ -60,6 +62,7 @@ export {
   findSafeStart,
   getAllProjectCwds,
   getBrowserByShortId,
+  getBrowserHealth,
   getFirstAvailableLine,
   getLinesView,
   getRegistrySize,
@@ -78,6 +81,7 @@ export {
   readHead,
   readSince,
   readTail,
+  recordCommandResolved,
   registerBrowser,
   registerCommand,
   registerTerminal,

package/dist/wsServer.mjs

@@ -16,7 +16,7 @@ import {
   resolvePendingRequest,
   unregisterBrowser,
   writeStdinToCommand
-} from "./chunk-W6G6X3FP.mjs";
+} from "./chunk-WOM47O75.mjs";
 import {
   AppError,
   Effect_exports,
@@ -683,7 +683,7 @@ var handleJupyter = (conn, bubbleId, cwd) => Effect_exports.gen(function* () {
     Effect_exports.annotateLogs("cwd", cwd)
   );
   const { kernelManager } = yield* Effect_exports.tryPromise({
-    try: () => import("./server-ZBUZ24TC.mjs"),
+    try: () => import("./server-SNB4H35J.mjs"),
     catch: (cause) => new AppError({
       message: "failed to import kernel manager",
       cause
@@ -1165,6 +1165,8 @@ var runTerminalHandler = (ws, projectCwd) => {
 // packages/feature/explorer/src/server/codeMap/projectGraph/codeIndex.ts
 import { promises as fs4 } from "fs";
 import path6 from "path";
+import { exec as exec2 } from "child_process";
+import { promisify as promisify2 } from "util";
 
 // packages/feature/explorer/src/server/codeMap/projectGraph/buildGraph.ts
 import { exec } from "child_process";
@@ -3872,6 +3874,7 @@ function registerWatcherSubscriber(fn) {
     }
   }
 }
+var execAsync2 = promisify2(exec2);
 
 // src/lib/codeIndexSync.ts
 var wired = false;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@surething/cockpit",
-  "version": "1.0.217",
-  "description": "Claude Code GUI for parallel AI coding — drive Claude (default), OpenAI Codex, DeepSeek, Kimi, or local Ollama in tabs. Multi-project sessions, terminal, browser & DB bubbles, code review, slash modes. Local-first, MIT.",
+  "version": "1.0.218",
+  "description": "Claude Code GUI for parallel AI coding — drive Claude (default), Codex, DeepSeek, Kimi, or local Ollama in tabs. Multi-project sessions, terminal, browser & DB bubbles, code review, slash modes. Local-first, MIT.",
   "author": "Robert",
   "license": "MIT",
   "repository": {
@@ -19,7 +19,6 @@
     "claude-code-client",
     "claude-agent-sdk",
     "anthropic",
-    "openai-codex",
     "codex",
     "deepseek",
     "deepseek-gui",
@@ -93,7 +92,7 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^3.0.52",
-    "@anthropic-ai/claude-agent-sdk": "^0.2.112",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.158",
     "@dagrejs/dagre": "^3.0.0",
     "@tanstack/react-virtual": "^3.13.18",
     "@tiptap/extension-link": "^3.19.0",
@@ -168,7 +167,6 @@
     "typescript": "5.9.3"
   },
   "overrides": {
-    "@anthropic-ai/sdk": "^0.91.1",
     "postcss": "^8.5.10"
   }
 }