chrome-bridge-mcp 1.32.2 → 1.32.3

package/extension/lib/command-outcome.js

@@ -23,7 +23,41 @@ export function elementOutcome(results, selector) {
   if (first?.result != null) return first.result;
   if (first?.error?.message) throw new Error(first.error.message);
   if (!selector) throw new Error('The page returned no result for the command');
-  throw new Error(`Element not found: ${selector} (no element matches; check it with query_dom)`);
+  throw notFoundError(selector);
+}
+
+/**
+ * Sintassi di Playwright, jQuery o XPath dentro un selettore CSS: querySelector
+ * la rifiuta con un SyntaxError, che executeScript riduce a un risultato vuoto.
+ * «no element matches» faceva credere a un selettore valido senza riscontri
+ * (note observe chrome-bridg-a1255c1b, chrome-bridg-5a9d399e, 1.32.1). Le
+ * stringhe tra virgolette si tolgono prima: `[title=":visible"]` è CSS valido.
+ */
+export function nonCssToken(selector) {
+  const s = String(selector).replace(/"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'/g, '""');
+  if (/^\s*\(?\/\//.test(s) || /(^|[\s,])xpath=/.test(s)) return 'XPath';
+  const engine = /(^|[\s,])(text|css|id|role|data-testid|internal:[\w-]+)=/.exec(s);
+  if (engine) return `${engine[2]}=`;
+  if (/(^|[^>])>>(?!>)/.test(s)) return '>>';
+  const pseudo = /:(has-text|text-is|text-matches|text|visible|hidden|nth-match|left-of|right-of|above|below|near|contains|eq|gt|lt|first|last|even|odd)(?![\w-])/.exec(s);
+  return pseudo ? `:${pseudo[1]}` : null;
+}
+
+export function notFoundError(selector) {
+  const token = nonCssToken(selector);
+  if (!token && String(selector).includes('>>>')) {
+    // ">>>" entra nello shadowRoot del primo elemento che la parte prima trova:
+    // un antenato senza shadowRoot («main >>> span») non trova niente anche
+    // se lo span c'è (note observe chrome-bridg-6379570f, chrome-bridg-f262acc4).
+    const host = String(selector).split('>>>')[0].trim();
+    return new Error(`Element not found: ${selector} (no element matches; ">>>" enters the shadowRoot of the first element "${host}" matches, `
+      + 'so that part must be the shadow host itself, e.g. the custom element\'s tag, not an ancestor of it. '
+      + 'Check it with query_dom, or locate the target by its visible text with find_text, which searches inside shadow roots)');
+  }
+  if (!token) return new Error(`Element not found: ${selector} (no element matches; check it with query_dom)`);
+  const what = token === 'XPath' ? 'XPath is not CSS' : `"${token}" is Playwright/jQuery syntax, not CSS`;
+  return new Error(`Invalid selector: ${selector} — ${what}: the page rejects the whole selector, every item of a comma list included. `
+    + 'Use plain CSS (">>>" pierces shadow DOM), a ref from get_interactives, or find_text to locate by visible text.');
 }
 
 /**

package/extension/lib/trusted-input.js

@@ -100,10 +100,33 @@ async function attach(tabId, purpose) {
   } catch (e) {
     const msg = String(e?.message ?? e);
     if (/already attached/i.test(msg)) throw new Error(`${purpose} unavailable: another debugger (DevTools?) is attached to this tab — close it, or retry without it`);
+    if (/chrome-extension:\/\/ URL of different extension/i.test(msg)) throw new Error(`${purpose} unavailable: ${await foreignExtensionCause(tabId, purpose)}`);
     throw new Error(`${purpose} unavailable: ${msg}`);
   }
 }
 
+// Chrome rifiuta chrome.debugger.attach su una scheda che contiene anche un
+// solo frame di un'altra estensione (password manager, traduttore, correttore
+// che iniettano un iframe chrome-extension://). Il messaggio grezzo non dice
+// quale frame né che riprovare è inutile: un agente ha ripetuto lo stesso
+// click 7 volte (nota observe chrome-bridg-8f18b944, 1.32.1).
+async function foreignExtensionCause(tabId, purpose) {
+  let ids = [];
+  try {
+    const frames = await chrome.webNavigation.getAllFrames({ tabId });
+    const self = chrome.runtime?.id;
+    ids = [...new Set((frames || [])
+      .map((f) => /^chrome-extension:\/\/([^/]+)/.exec(f.url || '')?.[1])
+      .filter((id) => id && id !== self))];
+  } catch { /* scheda chiusa o frame illeggibili: resta la causa senza id */ }
+  const which = ids.length ? ` (chrome-extension://${ids.join(', chrome-extension://')})` : '';
+  const remedy = purpose === 'trusted input'
+    ? 'Retry without trusted (synthetic events)'
+    : 'Use the options that work without the debugger';
+  return `another extension has a frame in this page${which}, and Chrome does not let chrome.debugger attach to a tab that holds another extension's frame: retrying the same call fails the same way. `
+    + `${remedy}, or turn that extension off for this site (chrome://extensions → Details → Site access) and reload the tab.`;
+}
+
 /** Tiene il debugger agganciato alla scheda per un motivo, finché releaseDebugger. */
 export async function holdDebugger(tabId, why, purpose = why) {
   listenDetach();

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Chrome Bridge for Claude Code",
-  "version": "1.32.2",
+  "version": "1.32.3",
   "description": "Bridge your browser to Claude Code: 69 token-efficient web-dev automation tools over a local WebSocket. ChromeOS included.",
   "homepage_url": "https://github.com/frsorrentino/chrome-bridge",
   "minimum_chrome_version": "135",

package/extension/service-worker.js

@@ -13,7 +13,7 @@ import { computeTiles } from './lib/tile-layout.js';
 import { classifyDownload } from './lib/download-state.js';
 import { downloadName } from './lib/capture-names.js';
 import { findTextInPage } from './lib/find-text.js';
-import { elementOutcome, watchNavErrors, navErrorMessage } from './lib/command-outcome.js';
+import { elementOutcome, notFoundError, watchNavErrors, navErrorMessage } from './lib/command-outcome.js';
 import { withDebugger, keyEvents, mouseClickEvents, holdDebugger, releaseDebugger, debuggerHeld } from './lib/trusted-input.js';
 import { emulationCommands } from './lib/emulation.js';
 const { pushError } = globalThis.__cbTelemetry;
@@ -1021,7 +1021,7 @@ async function trustedTarget(tabId, frame_id, selector, what) {
     world: 'MAIN',
   });
   const out = results?.[0]?.result;
-  if (!out || out.missing) throw new Error(`Element not found: ${selector} (no element matches; check it with query_dom)`);
+  if (!out || out.missing) throw notFoundError(selector);
   return out;
 }
 
@@ -3458,7 +3458,7 @@ async function cmdWatchDom({ selector = 'body', attributes = true, childList = t
     args: [selector, { attributes, childList, characterData, subtree }],
     world: 'MAIN',
   });
-  if (install?.[0]?.result?.missing) throw new Error(`Element not found: ${selector} (no element matches; check it with query_dom)`);
+  if (install?.[0]?.result?.missing) throw notFoundError(selector);
 
   // Read mutations
   const results = await chrome.scripting.executeScript({

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "chrome-bridge-mcp",
-  "version": "1.32.2",
+  "version": "1.32.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "chrome-bridge-mcp",
-      "version": "1.32.2",
+      "version": "1.32.3",
       "license": "MIT",
       "dependencies": {
         "@jridgewell/trace-mapping": "^0.3.31",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chrome-bridge-mcp",
   "mcpName": "io.github.frsorrentino/chrome-bridge",
-  "version": "1.32.2",
+  "version": "1.32.3",
   "type": "module",
   "description": "Chrome Bridge by frsorrentino: MCP server that lets Claude Code borrow a tab from your own logged-in Chrome and hand it back — logins, 2FA and CAPTCHAs stay with you (handoff). 69 tools; 2.8-4.3× cheaper and up to 9.3× fewer turns than Claude in Chrome, measured; ChromeOS included.",
   "main": "server/index.js",

package/server/protocol.js

@@ -105,7 +105,7 @@ export const MessageType = Object.freeze({
 });
 
 // Versione
-export const VERSION               = '1.32.2';
+export const VERSION               = '1.32.3';
 
 // Configurazione
 export const DEFAULT_PORT          = 8765;