@predotdev/mcp 2.1.0 → 2.1.2

package/README.md

@@ -59,6 +59,10 @@ Then restart your agent and try:
 
 The command is safe to run again at any time, and running it again updates to the latest version. `npx -y @predotdev/mcp check` shows the state of everything, and `uninstall` removes it from every agent.
 
+### Coming from Claude in Chrome?
+
+Run the setup command above, then type `/chrome` in Claude Code and turn off **Enabled by default** (or start a session with `claude --no-chrome`). Your Chrome profiles and logins carry over, because this server drives the Chrome you already use. The [switching guide](https://docs.pre.dev/browser-agents/switch-from-claude-in-chrome) maps each Claude in Chrome tool to its pre.dev tool and has a line you can paste into `CLAUDE.md`.
+
 ## Local or cloud?
 
 Both editions of pre.dev Browser Agents are in this server, and your agent picks per task.
@@ -128,7 +132,7 @@ Once you are signed in to pre.dev (`setup` or `login` does it, or set `PREDEV_AP
 - `chrome_act`: click or type into an element described in plain words, like *"the Create button in the dialog"*, in under a second with no snapshot needed. If it isn't sure, it lists the likely matches instead of guessing.
 - `chrome_wait` with `condition`: wait until a plain-words statement about the page is true, like *"the export has finished"*.
 
-**Pricing.** The MCP server is free and open source, and the Chrome tools run free on your Mac. Plain-words actions and the cloud tools use pre.dev credits, the same credits as the rest of pre.dev ([pricing](https://pre.dev/pricing)). Each action costs a small fraction of one credit, and the free trial's credits cover more than a thousand actions. They show up in your usage as `browser-agents-local`, and `check` shows your plan. If the free plan's allowance or your credits run out, your agent tells you and offers to open the [billing page](https://pre.dev/billing) in your Chrome; everything else keeps working. Every other tool runs entirely on your machine and never calls pre.dev.
+**Pricing.** The MCP server is free and open source, and the Chrome tools run free on your Mac. Plain-words actions and the cloud tools use pre.dev credits, the same credits as the rest of pre.dev ([pricing](https://pre.dev/pricing)). Each action costs a small fraction of one credit, and the free trial's credits cover hundreds of them. They show up in your usage as `browser-agents-local`, and `check` shows your plan. If the free plan's allowance or your credits run out, your agent tells you and offers to open the [billing page](https://pre.dev/billing) in your Chrome; everything else keeps working. Every other tool runs entirely on your machine and never calls pre.dev.
 
 ## Setup for every agent
 
@@ -169,7 +173,7 @@ pi mcp add predev -- npx -y @predotdev/mcp
 pi mcp list
 ```
 
-`pi mcp list` should say `predev: connected`. Pi versions without built-in MCP need `pi install npm:pi-mcp-adapter` first; it reads the same `~/.pi/agent/mcp.json`.
+`pi mcp list` should say `predev: connected`. `pi mcp add` needs Pi 0.99 or newer. On an older Pi, run `pi install npm:pi-mcp-adapter` and add the `predev` entry to `~/.pi/agent/mcp.json` by hand (`setup` writes it for you).
 
 </details>
 
@@ -512,6 +516,7 @@ npx -y @predotdev/mcp uninstall  # remove it from every agent and delete its fil
 | You had the hosted pre.dev MCP or an older `chrome` install | `setup` replaced it; this server has all of its tools. |
 | The agent can't start the server, or `npx`/`node` not found | Run `setup`: it registers full paths that work in desktop apps. |
 | Codex says a tool call timed out | Set `tool_timeout_sec = 900` (see the Codex setup). |
+| `codex exec` says a tool call `requires approval, but approval policy is never` | Non-interactive Codex can't ask you, so allow the tools for that run: `codex exec -c 'mcp_servers.predev.default_tools_approval_mode="approve"' "..."`. |
 | Anything else | Run `npx -y @predotdev/mcp check`, and look at `~/.predev/mcp/predev-mcp.log`. |
 
 ## Platform support

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@predotdev/mcp",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "pre.dev in any coding agent: Browser Agents in the Chrome you already use and in the cloud, plus specs and plans. One command to set up. Free and open source.",
   "type": "module",
   "bin": {

package/src/setup.mjs

@@ -481,10 +481,18 @@ export function createSetup(ctx) {
       if (!found) continue;
       try { if (agent.unregister()) ok(`Removed from ${agent.label}`); } catch (error) { skip(`${agent.label}: ${error.message}`); }
     }
-    const state = (() => { try { return JSON.parse(fs.readFileSync(path.join(stateDir, 'daemon.json'), 'utf8')); } catch { return null; } })();
-    if (state) await request(state, 'POST', '/shutdown', {}, 3000).catch(() => {});
-    fs.rmSync(APP_DIR, { recursive: true, force: true });
-    fs.rmSync(credentialsFile, { force: true });
+    // Every daemon it runs (one per Chrome data dir), then everything it keeps in ~/.predev/mcp:
+    // the stable copy, the saved key, logs and the cached profile list (names and emails).
+    const subdirs = (() => { try { return fs.readdirSync(baseStateDir, { withFileTypes: true }).filter(d => d.isDirectory()).map(d => path.join(baseStateDir, d.name)); } catch { return []; } })();
+    const alive = pid => { try { process.kill(pid, 0); return true; } catch { return false; } };
+    for (const dir of new Set([stateDir, baseStateDir, ...subdirs])) {
+      const state = (() => { try { return JSON.parse(fs.readFileSync(path.join(dir, 'daemon.json'), 'utf8')); } catch { return null; } })();
+      if (!state) continue;
+      await request(state, 'POST', '/shutdown', {}, 3000).catch(() => {});
+      // It exits just after answering; wait, so its last log line can't recreate the folder.
+      for (let i = 0; i < 30 && state.pid && alive(state.pid); i++) await sleep(100);
+    }
+    fs.rmSync(baseStateDir, { recursive: true, force: true });
     ok('Stopped it and deleted its files and saved key');
     console.log('\nDone. Restart your agents. To also turn off remote debugging, open chrome://inspect/#remote-debugging.');
   }

package/src/tools.mjs

@@ -180,10 +180,15 @@ async function pageLine(info, session) {
   return `Tab ${tabId(info)} · ${label(profileOf(info))} · ${(title || '(untitled)').slice(0, 100)}\n${shortUrl}`;
 }
 
+// Dev servers on this computer or the local network, which rarely speak https.
+const LOCAL_HOST = /^(localhost|127(\.\d{1,3}){3}|0\.0\.0\.0|\[::1\]|10(\.\d{1,3}){3}|192\.168(\.\d{1,3}){2}|172\.(1[6-9]|2\d|3[01])(\.\d{1,3}){2}|[^\s/:?#@]+\.(localhost|test))(:\d+)?([/?#]|$)/i;
+
 function normalizeUrl(url) {
   const value = String(url || '').trim();
   if (!value) throw new Error('Pass a url.');
-  return /^[a-z][a-z0-9+.-]*:/i.test(value) ? value : `https://${value}`;
+  // "https:", "about:", "chrome:"... is a scheme, but "localhost:3000/app" is a host and port.
+  if (/^[a-z][a-z0-9+.-]*:/i.test(value) && !/^[^\s/:?#@]+:\d+([/?#]|$)/.test(value)) return value;
+  return `${LOCAL_HOST.test(value) ? 'http' : 'https'}://${value}`;
 }
 
 const isLocalDev = url => {
@@ -274,9 +279,10 @@ function shortHref(href) {
     return s.length > 70 ? s.slice(0, 69) + '…' : s;
   } catch (e) { return ''; }
 }
-function snapshot(max) {
+// peek: list the elements without replacing the refs the agent got from its last snapshot.
+function snapshot(max, peek) {
   const refs = new Map();
-  window.__agentRefs = refs;
+  if (!peek) window.__agentRefs = refs;
   const found = new Set();
   collect(document, found);
   const all = [...found];
@@ -382,7 +388,7 @@ function point(q) {
     while (hit?.shadowRoot) { const inner = hit.shadowRoot.elementFromPoint(x, y); if (!inner || inner === hit) break; hit = inner; }
     if (hit && !contains(el, hit) && !contains(hit, el)) covered = describe(hit);
   }
-  return { x, y, desc: describe(el), covered };
+  return { x, y, desc: describe(el), covered, select: el.tagName === 'SELECT' };
 }
 function focus(q, clear) {
   const f = find(q);
@@ -548,11 +554,17 @@ async function matchElement(session, description, ctx) {
   return { ref: answer.ref || null, desc: answer.text, p: Number(answer.confidence) || 0, list };
 }
 
+// What a plain-words wait checks: the page's text and its interactive elements, since an empty field
+// or an icon button has no text of its own. Elements go first: pre.dev reads the first 12,000 characters.
 async function pageState(session) {
-  return evaluate(session, `(() => {
+  const [head, text] = await evaluate(session, `(() => {
     const dialog = [...document.querySelectorAll('[role=dialog],[aria-modal=true],dialog[open],[role=alert]')].map(d => d.innerText).join('\\n').slice(0, 1500);
-    return 'Title: ' + document.title + '\\nURL: ' + location.href + (dialog ? '\\nDialog/alert: ' + dialog : '') + '\\n\\n' + (document.body ? document.body.innerText : '').slice(0, 8000);
+    return ['Title: ' + document.title + '\\nURL: ' + location.href + (dialog ? '\\nDialog/alert: ' + dialog : ''), document.body ? document.body.innerText : ''];
   })()`, 10000);
+  const snap = await inPage(session, 'snapshot(150, true)', 10000).catch(() => '');
+  const elements = String(snap).split('\n').filter(line => /^\[e\d+\] /.test(line)).map(line => line.replace(/^\[e\d+\] /, '- ')).join('\n').slice(0, 3000);
+  const room = Math.min(8000, Math.max(2000, 11500 - head.length - elements.length));
+  return `${head}${elements ? `\nInteractive elements:\n${elements}` : ''}\n\nText:\n${text.slice(0, room)}`;
 }
 
 // ---------------------------------------------------------------- tools
@@ -681,6 +693,8 @@ const TOOLS = [
         ({ x, y } = hit);
         what = hit.desc;
         if (hit.covered) note = `\nNote: ${hit.covered} was on top of it at that point; the click went there.`;
+        // A click only opens a dropdown's list; arrow keys and option clicks don't reach it in every Chrome.
+        if (hit.select) note += `\nNote: this is a dropdown. To pick an option, call chrome_type with this element and the option's text.`;
       }
       await click(session, x, y, args.double ? 2 : 1);
       await settle(session, before);