poltertab 1.7.0-beta.3 → 1.7.0

package/README.md

@@ -203,7 +203,8 @@ next use.
 
 One agent can drive many tabs. Each agent (and each secondary server) has its
 own **current tab**; page-facing tools without `tabId`/`session` act there. An
-explicit `tabId` acts on that tab without changing the current one. If the
+explicit `tabId` acts on that tab without changing the current one; a `tabId`
+Chrome does not have returns `tab_not_found` on any tool that takes one. If the
 current tab is closed, untargeted calls fail with a message naming the closed
 tab instead of quietly acting on another one.
 
@@ -211,7 +212,7 @@ tab instead of quietly acting on another one.
 | -------- | ----------- | ------------- |
 | `browser_tab_new` | `url`, `session`, `background` | Open a tab and make it current |
 | `browser_tab_list` | `all` | PolterTab's tabs (or every tab), marking the current one |
-| `browser_tab_switch` | `tabId` or `session`, `focus` | Make another tab current |
+| `browser_tab_switch` | `tabId` or `session`, `focus` | Make another tab current. A tab that does not exist in Chrome returns `tab_not_found`. |
 | `browser_tab_close` | `tabId` or `session`, `force` | Close a tab (default: current). Tabs not opened by PolterTab (including ones adopted via `browser_session_create({tabId})`) return `needs_user_permission` — ask the user, then retry with `force: true`. A tab that does not exist in Chrome returns `tab_not_found`. |
 
 ### Site memory

package/mcp-server/bridge.js

@@ -359,7 +359,15 @@ function setupPrimaryWss(wss) {
           }, COMMAND_TIMEOUT_MS);
 
           pendingCommands.set(id, { isProxy: true, sourceWs: ws, timer });
-          extensionSocket.send(JSON.stringify({ id, action, ...params }));
+          // Same envelope construction as the direct path, so a tool argument
+          // named id or action cannot override the routing here either. The
+          // Primary's own id is kept last: pendingCommands is keyed on it.
+          extensionSocket.send(
+            JSON.stringify({
+              ..._buildEnvelope(action, msg.params, ws.nodeId),
+              id,
+            }),
+          );
           return;
         }
 

package/mcp-server/tools.js

@@ -11,7 +11,7 @@ const TARGET = {
   tabId: {
     type: "number",
     description:
-      "Act on this tab (an id from browser_tab_list) without making it current. Omit to use this agent's current tab: the last one navigated, opened or switched to.",
+      "Act on this tab (an id from browser_tab_list) without making it current. Omit to use this agent's current tab: the last one navigated, opened or switched to. A tabId Chrome does not have returns tab_not_found.",
   },
   session: {
     type: "string",
@@ -498,7 +498,11 @@ const BROWSER_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        tabId: { type: "number" },
+        tabId: {
+          type: "number",
+          description:
+            "Tab to switch to; a tabId Chrome does not have returns tab_not_found",
+        },
         session: { type: "string" },
         focus: {
           type: "boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poltertab",
-  "version": "1.7.0-beta.3",
+  "version": "1.7.0",
   "description": "Let any AI assistant drive and scrape your existing Chrome profile — no headless browser, no complex setup.",
   "bin": {
     "poltertab": "./bin/poltertab.js"

package/skills/browser-navigation-strategy/SKILL.md

@@ -204,7 +204,9 @@ commandeer the tab the user is looking at — and later calls reuse it.
 For several tabs: `browser_tab_new` opens one and makes it current,
 `browser_tab_list` shows them with their ids, `browser_tab_switch` changes the
 current one, and `browser_tab_close` closes one. Pass `tabId` to act on a tab
-once without switching to it, or name tabs with `session` and pass that. If a
+once without switching to it — a `tabId` Chrome does not have returns
+`tab_not_found` on any tool that takes one — or name tabs with `session` and
+pass that. If a
 call says your tab was closed, list and switch — do not assume another tab is
 the same page. Close what you opened.