bb-browser 0.10.1 → 0.11.0

package/dist/mcp.js

@@ -3,7 +3,7 @@ import {
   COMMAND_TIMEOUT,
   DAEMON_BASE_URL,
   generateId
-} from "./chunk-XYKHDJST.js";
+} from "./chunk-5WGFUZLM.js";
 import {
   __commonJS,
   __export,
@@ -20971,13 +20971,11 @@ import { execFile, spawn } from "child_process";
 import { existsSync } from "fs";
 import { fileURLToPath } from "url";
 import { dirname, resolve } from "path";
-var EXT_HINT = [
-  "Chrome extension not connected.",
+var CHROME_NOT_CONNECTED_HINT = [
+  "Chrome is not connected to the daemon.",
   "",
-  "1. Download extension: https://github.com/epiral/bb-browser/releases/latest",
-  "2. Unzip the downloaded file",
-  "3. Open chrome://extensions/ \u2192 Enable Developer Mode",
-  '4. Click "Load unpacked" \u2192 select the unzipped folder'
+  "Make sure Chrome is running and the daemon can connect to it via CDP.",
+  "Run: bb-browser daemon --help for details."
 ].join("\n");
 var sessionOpenedTabs = /* @__PURE__ */ new Set();
 function getDaemonPath() {
@@ -21029,7 +21027,7 @@ async function sendCommand(request) {
     });
     clearTimeout(timeoutId);
     if (response.status === 503) {
-      return { id: request.id, success: false, error: EXT_HINT };
+      return { id: request.id, success: false, error: CHROME_NOT_CONNECTED_HINT };
     }
     return await response.json();
   } catch {
@@ -21152,8 +21150,8 @@ async function runSiteCli(args) {
   return parsed ?? result.stdout.trim();
 }
 var server = new McpServer(
-  { name: "bb-browser", version: "0.10.1" },
-  { instructions: `bb-browser lets you control the user's real Chrome browser \u2014 with their login state, cookies, and sessions.
+  { name: "bb-browser", version: "0.11.0" },
+  { instructions: `bb-browser lets you control the user's real Chrome browser via CDP (Chrome DevTools Protocol).
 
 Your browser is the API. No headless browser, no cookie extraction, no anti-bot bypass.
 
@@ -21161,11 +21159,18 @@ Key capabilities:
 - browser_snapshot: Read page content via accessibility tree (use ref numbers to interact)
 - browser_click/fill/type: Interact with elements by ref from snapshot
 - browser_eval: Run JavaScript in page context (most powerful \u2014 full DOM/fetch access)
-- browser_network: Capture network requests/responses (API reverse engineering)
+- browser_network: Capture network requests/responses (API reverse engineering). Supports incremental queries with since: "last_action"
+- browser_console: Read console messages. Supports since/filter/limit
+- browser_errors: Read JavaScript errors. Supports since/limit
 - browser_screenshot: Visual page capture
-- browser_tab_list/tab_new: Multi-tab support \u2014 use tab parameter for concurrent operations
+- browser_tab_list/tab_new: Multi-tab support \u2014 use tab parameter (short ID like "c416") for concurrent operations
 - browser_close_all: Close tabs opened by bb-browser during the current MCP session
 
+Tab management:
+- Tab IDs are short hex strings (e.g. "c416") returned by tab_list or open commands
+- Pass tab short ID to any tool to target a specific tab
+- Omit tab to target the active tab
+
 Site adapters (pre-built commands for popular sites):
 - site_list/site_search/site_info: Discover available adapters and their signatures
 - site_recommend: Suggest adapters based on browsing history
@@ -21179,7 +21184,7 @@ server.tool(
   "browser_snapshot",
   "Get accessibility tree snapshot of the current page",
   {
-    tab: external_exports.number().optional().describe("Tab ID to target (omit for active tab)"),
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)"),
     interactive: external_exports.boolean().optional().describe("Only show interactive elements")
   },
   async ({ tab, interactive }) => {
@@ -21193,7 +21198,7 @@ server.tool(
   "Click an element by ref",
   {
     ref: external_exports.string().describe("Element ref from snapshot"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ ref, tab }) => {
     const resp = await runCommand({ action: "click", ref, tabId: tab });
@@ -21207,7 +21212,7 @@ server.tool(
   {
     ref: external_exports.string().describe("Element ref from snapshot"),
     text: external_exports.string().describe("Text to fill"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ ref, text, tab }) => {
     const resp = await runCommand({ action: "fill", ref, text, tabId: tab });
@@ -21221,7 +21226,7 @@ server.tool(
   {
     ref: external_exports.string().describe("Element ref from snapshot"),
     text: external_exports.string().describe("Text to type"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ ref, text, tab }) => {
     const resp = await runCommand({ action: "type", ref, text, tabId: tab });
@@ -21234,7 +21239,7 @@ server.tool(
   "Navigate to a URL",
   {
     url: external_exports.string().describe("URL to open"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ url, tab }) => {
     const resp = await runCommand({ action: "open", url, tabId: tab });
@@ -21273,7 +21278,7 @@ server.tool(
   "Press a keyboard key",
   {
     key: external_exports.string().describe("Key name to press, e.g. Enter or Control+a"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ key, tab }) => {
     const parts = key.split("+");
@@ -21292,7 +21297,7 @@ server.tool(
   {
     direction: external_exports.enum(["up", "down", "left", "right"]).describe("Scroll direction"),
     pixels: external_exports.number().optional().default(500).describe("Scroll distance in pixels"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ direction, pixels, tab }) => {
     const resp = await runCommand({ action: "scroll", direction, pixels, tabId: tab });
@@ -21305,7 +21310,7 @@ server.tool(
   "Execute JavaScript in page context",
   {
     script: external_exports.string().describe("JavaScript source to execute"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ script, tab }) => {
     const resp = await runCommand({ action: "eval", script, tabId: tab });
@@ -21318,27 +21323,100 @@ server.tool(
   "Inspect or clear network activity",
   {
     command: external_exports.enum(["requests", "clear"]).describe("Network command"),
-    filter: external_exports.string().optional().describe("Optional URL substring filter"),
-    withBody: external_exports.boolean().optional().describe("Include request and response bodies"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)"),
+    filter: external_exports.string().optional().describe("URL substring filter"),
+    since: external_exports.union([external_exports.literal("last_action"), external_exports.number()]).optional().describe("Incremental query: 'last_action' for events since last operation, or seq number"),
+    method: external_exports.string().optional().describe("Filter by HTTP method (GET, POST, etc.)"),
+    status: external_exports.string().optional().describe("Filter by status: '4xx', '5xx', or exact code like '200'"),
+    limit: external_exports.number().optional().describe("Max number of results to return"),
+    withBody: external_exports.boolean().optional().describe("Include request and response bodies")
   },
-  async ({ command, filter, withBody, tab }) => {
+  async ({ command, tab, filter, since, method, status, limit, withBody }) => {
     const resp = await runCommand({
       action: "network",
       networkCommand: command,
       filter,
+      since,
+      method,
+      status,
+      limit,
       withBody,
       tabId: tab
     });
     if (!resp.success) return responseError(resp);
-    return textResult(command === "requests" ? resp.data?.networkRequests || [] : resp.data || "Cleared");
+    if (command === "requests") {
+      const data = resp.data;
+      return textResult({
+        requests: data?.networkRequests || data?.requests || [],
+        cursor: data?.cursor
+      });
+    }
+    return textResult(resp.data || "Cleared");
+  }
+);
+server.tool(
+  "browser_console",
+  "Get or clear console messages",
+  {
+    command: external_exports.enum(["get", "clear"]).describe("Console command"),
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)"),
+    since: external_exports.union([external_exports.literal("last_action"), external_exports.number()]).optional().describe("Incremental query: 'last_action' for events since last operation, or seq number"),
+    filter: external_exports.string().optional().describe("Filter console messages by text substring"),
+    limit: external_exports.number().optional().describe("Max number of results to return")
+  },
+  async ({ command, tab, since, filter, limit }) => {
+    const resp = await runCommand({
+      action: "console",
+      consoleCommand: command,
+      filter,
+      since,
+      limit,
+      tabId: tab
+    });
+    if (!resp.success) return responseError(resp);
+    if (command === "get") {
+      const data = resp.data;
+      return textResult({
+        messages: data?.consoleMessages || data?.messages || [],
+        cursor: data?.cursor
+      });
+    }
+    return textResult(resp.data || "Cleared");
+  }
+);
+server.tool(
+  "browser_errors",
+  "Get or clear JavaScript errors",
+  {
+    command: external_exports.enum(["get", "clear"]).describe("Errors command"),
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)"),
+    since: external_exports.union([external_exports.literal("last_action"), external_exports.number()]).optional().describe("Incremental query: 'last_action' for events since last operation, or seq number"),
+    limit: external_exports.number().optional().describe("Max number of results to return")
+  },
+  async ({ command, tab, since, limit }) => {
+    const resp = await runCommand({
+      action: "errors",
+      errorsCommand: command,
+      since,
+      limit,
+      tabId: tab
+    });
+    if (!resp.success) return responseError(resp);
+    if (command === "get") {
+      const data = resp.data;
+      return textResult({
+        errors: data?.jsErrors || data?.errors || [],
+        cursor: data?.cursor
+      });
+    }
+    return textResult(resp.data || "Cleared");
   }
 );
 server.tool(
   "browser_screenshot",
   "Take a screenshot",
   {
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ tab }) => {
     const resp = await runCommand({ action: "screenshot", tabId: tab });
@@ -21360,7 +21438,7 @@ server.tool(
   {
     attribute: external_exports.enum(["text", "url", "title", "value", "html"]).describe("Attribute to retrieve"),
     ref: external_exports.string().optional().describe("Optional element ref"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ attribute, ref, tab }) => {
     const resp = await runCommand({ action: "get", attribute, ref, tabId: tab });
@@ -21372,7 +21450,7 @@ server.tool(
   "browser_close",
   "Close the current or specified tab",
   {
-    tab: external_exports.number().optional().describe("Tab ID to close")
+    tab: external_exports.string().optional().describe("Tab short ID to close")
   },
   async ({ tab }) => {
     const resp = await runCommand({ action: tab === void 0 ? "close" : "tab_close", tabId: tab });
@@ -21418,7 +21496,7 @@ server.tool(
   "Hover over an element",
   {
     ref: external_exports.string().describe("Element ref from snapshot"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ ref, tab }) => {
     const resp = await runCommand({ action: "hover", ref, tabId: tab });
@@ -21431,7 +21509,7 @@ server.tool(
   "Wait for a number of milliseconds",
   {
     time: external_exports.number().describe("Time to wait in milliseconds"),
-    tab: external_exports.number().optional().describe("Tab ID to target")
+    tab: external_exports.string().optional().describe("Tab short ID (from tab list or open command)")
   },
   async ({ time: time3, tab }) => {
     const resp = await runCommand({ action: "wait", waitType: "time", ms: time3, tabId: tab });
@@ -21508,7 +21586,7 @@ server.tool(
     name: external_exports.string().describe("Adapter name, e.g. twitter/search"),
     args: external_exports.array(external_exports.string()).optional().describe("Positional arguments in adapter-defined order"),
     namedArgs: external_exports.record(external_exports.string()).optional().describe("Named adapter arguments passed as --key value"),
-    tab: external_exports.number().optional().describe("Optional tab ID to target"),
+    tab: external_exports.string().optional().describe("Optional tab short ID to target"),
     openclaw: external_exports.boolean().optional().describe("Prefer the OpenClaw browser instead of the extension flow")
   },
   async ({ name, args, namedArgs, tab, openclaw }) => {