chrome-bridge-mcp 1.10.0 → 1.10.1

package/README.md

@@ -1,6 +1,6 @@
 # Chrome Bridge
 
-![License: MIT](https://img.shields.io/badge/license-MIT-green) ![Node 18+](https://img.shields.io/badge/node-%E2%89%A518-brightgreen) ![Chrome 135+](https://img.shields.io/badge/chrome-%E2%89%A5135-blue) ![Tests](https://img.shields.io/badge/tests-131%20unit%20%2B%20e2e-brightgreen) [![Chrome Web Store](https://img.shields.io/badge/web%20store-published-blue)](https://chromewebstore.google.com/detail/chrome-bridge-for-claude/bioknpaeahidbelaljjohjofiloeodmb)
+![License: MIT](https://img.shields.io/badge/license-MIT-green) ![Node 18+](https://img.shields.io/badge/node-%E2%89%A518-brightgreen) ![Chrome 135+](https://img.shields.io/badge/chrome-%E2%89%A5135-blue) ![Tests](https://img.shields.io/badge/tests-132%20unit%20%2B%20e2e-brightgreen) [![Chrome Web Store](https://img.shields.io/badge/web%20store-published-blue)](https://chromewebstore.google.com/detail/chrome-bridge-for-claude/bioknpaeahidbelaljjohjofiloeodmb)
 
 **Chrome Bridge is an MCP server that connects Claude Code to your real, logged-in Chrome browser — measured 2.75× fewer turns and 2.28× lower cost than the official "Claude in Chrome" extension on a form-filling task, with ~3× the toolset and no paid plan.**
 
@@ -63,7 +63,7 @@ Claude Code calls `navigate` (returning clickable element refs), `accessibility_
 
 ## Token-Efficient Design
 
-- **Opt-in Surface**: 31 core tools cost ≈7.4k tokens of `tools/list`, all 60 cost ≈14.1k; specialized groups (audits, visual, network, storage, dom, files) are opt-in via `--caps`. That core figure was ≈3.8k in 1.8.0 and roughly doubled in 1.10.0: MCP annotations on every tool, rewritten descriptions, and a documented `.describe()` on all 254 parameters (coverage went from 35% to 100%). The trade is deliberate and it is not free — on the form benchmark it adds ≈8% to the cache-read tokens per turn — but the measured advantage was never prefix size, it was round trips: 2.75× fewer turns. Playwright MCP's 23 core tools measured ≈4.6k in July 2026, so on prefix size alone it is the leaner one. Measure ours with `npm run measure`.
+- **Opt-in Surface**: 31 core tools cost ≈7.6k tokens of `tools/list`, all 60 cost ≈14.6k; specialized groups (audits, visual, network, storage, dom, files) are opt-in via `--caps`. That core figure was ≈3.8k in 1.8.0 and roughly doubled in 1.10.0: MCP annotations on every tool, rewritten descriptions, and a documented `.describe()` on all 254 parameters (coverage went from 35% to 100%). The trade is deliberate and it is not free — on the form benchmark it adds ≈8% to the cache-read tokens per turn — but the measured advantage was never prefix size, it was round trips: 2.75× fewer turns. Playwright MCP's 23 core tools measured ≈4.6k in July 2026, so on prefix size alone it is the leaner one. Measure ours with `npm run measure`.
 - **Act-from-Result**: Tools attach a capped preview of interactive elements with short refs. Actions only report a `page_changed` delta when the URL or title actually changes.
 - **Optimized Media**: Screenshots are downscaled to ≤1568px. Full-page captures are sliced into readable segments.
 - **Zero-Token Escape Hatches**: The [CLI](#cli) skips MCP schemas entirely, and recorded flows [replay](#launch-mode-headless--ci) without any model in the loop.

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Chrome Bridge for Claude Code",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Bridge your browser to Claude Code: 60 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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chrome-bridge-mcp",
   "mcpName": "io.github.frsorrentino/chrome-bridge",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "type": "module",
   "description": "MCP server with 60 tools for browser automation via Chrome extension. Works on ChromeOS/Crostini.",
   "main": "server/index.js",

package/server/protocol.js

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

package/server/tools.js

@@ -586,7 +586,11 @@ export function registerTools(server, wsManager, caps = 'all') {
   // --- type_text ---
   server.tool(
     'type_text',
-    'Type text into an input, by CSS selector or by ref from get_interactives.',
+    'Put text into an input, textarea or contenteditable, by CSS selector or by a ref from get_interactives. '
+      + 'Replaces the whole value rather than appending, and assigns through the native setter so React and '
+      + 'Vue controlled inputs register the change, then fires input and change. mode=keys instead emits '
+      + 'keydown/input/keyup per character, which is what autocomplete and masked fields need — slower, so '
+      + 'reach for it only when mode=set leaves the field empty or the dropdown never opens.',
     {
       selector: z.string().optional().describe('CSS selector; ">>>" pierces shadow DOM. Ignored when ref is given'),
       ref:      z.string().optional().describe('From get_interactives, e.g. "n3"'),
@@ -859,7 +863,11 @@ export function registerTools(server, wsManager, caps = 'all') {
   // --- wait_for ---
   server.tool(
     'wait_for',
-    'Wait for: element (selector in DOM), function (JS expression truthy; needs "Allow user scripts"), navigation (mode=spa for route changes), network_idle.',
+    'Block until a condition holds: element (selector in the DOM), function (JS expression turns truthy; needs '
+      + 'the "Allow user scripts" toggle), navigation (mode=spa for client-side route changes), network_idle. '
+      + 'Polls until timeout — 10s for element and function, 15s for navigation and network_idle — then '
+      + '**returns `found: false` with a reason instead of raising**, so a caller that ignores the result '
+      + 'silently proceeds as if the wait had succeeded. Read-only: waiting changes nothing on the page.',
     {
       condition: z.enum(['element', 'function', 'navigation', 'network_idle']).describe('function needs expression; element needs selector'),
       selector: z.string().optional().describe('condition=element'),
@@ -983,7 +991,11 @@ export function registerTools(server, wsManager, caps = 'all') {
   // --- viewport_resize ---
   server.tool(
     'viewport_resize',
-    'Resize Chrome window to preset (mobile/tablet/desktop) or custom dimensions',
+    'Resize the Chrome **window** to a preset (mobile 375x812, tablet 768x1024, desktop 1440x900) or to explicit '
+      + 'dimensions. The rendered viewport ends up smaller than what you ask for, by the height of the browser '
+      + 'chrome — measure it with execute_js if the exact number matters. width and height each override the '
+      + 'corresponding half of the preset, so preset plus width gives a custom width at the preset height. '
+      + 'A maximized window on ChromeOS ignores the request.',
     {
       preset: z.enum(['mobile', 'tablet', 'desktop']).optional().describe('375x812, 768x1024, 1440x900'),
       width: z.number().optional().describe('Overrides preset'),
@@ -1072,7 +1084,10 @@ export function registerTools(server, wsManager, caps = 'all') {
   // --- highlight_elements ---
   server.tool(
     'highlight_elements',
-    'Add colored overlay on elements matching a CSS selector. remove=true clears all highlights.',
+    'Outline every element matching a selector with a coloured overlay, to see on a screenshot what a selector '
+      + 'actually caught. Each call clears the overlays left by the previous one instead of stacking them, and '
+      + 'remove=true clears without adding. The overlays are injected DOM nodes: a reload or a navigation drops '
+      + 'them, and they sit above the page without altering its layout or its own styles.',
     {
       selector: z.string().optional().describe('CSS selector; ">>>" pierces shadow DOM. Every match is outlined'),
       color: z.string().optional().default('rgba(255,0,0,0.3)').describe('Any CSS color for the overlay label'),
@@ -1740,7 +1755,11 @@ export function registerTools(server, wsManager, caps = 'all') {
   // --- session_fixture ---
   server.tool(
     'session_fixture',
-    'Save/restore localStorage+sessionStorage+cookies as a named fixture (e.g. a logged-in state). Restore requires the tab to be on the origin recorded at save.',
+    'Snapshot localStorage, sessionStorage and cookies of the current origin into a named fixture on the server, '
+      + 'restore one, or list what has been saved. A logged-in state is the usual reason. save overwrites a '
+      + 'fixture of the same name without asking; restore writes entries on top of what is already there '
+      + 'rather than clearing first, and refuses outright when the tab sits on a different origin than the '
+      + 'one recorded — cookies would otherwise attach to the wrong site. name is required except for list.',
     {
       action: z.enum(['save', 'restore', 'list']).describe('save snapshots the current origin; restore writes it back'),
       name: z.string().optional().describe('Required for save/restore'),