bb-browser 0.1.0 → 0.1.2

package/dist/{chunk-KATHFDYJ.js → chunk-YAVLEXUJ.js}

@@ -17,4 +17,4 @@ export {
   SSE_HEARTBEAT_INTERVAL,
   COMMAND_TIMEOUT
 };
-//# sourceMappingURL=chunk-KATHFDYJ.js.map
+//# sourceMappingURL=chunk-YAVLEXUJ.js.map

package/dist/chunk-YAVLEXUJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../packages/shared/src/protocol.ts","../packages/shared/src/constants.ts"],"sourcesContent":["/**\n * CLI 与 Chrome Extension 之间的通信协议类型定义\n */\n\n/** 支持的操作类型 */\nexport type ActionType =\n  | \"open\"\n  | \"snapshot\"\n  | \"click\"\n  | \"hover\"\n  | \"fill\"\n  | \"type\"\n  | \"check\"\n  | \"uncheck\"\n  | \"select\"\n  | \"get\"\n  | \"screenshot\"\n  | \"close\"\n  | \"wait\"\n  | \"press\"\n  | \"scroll\"\n  | \"back\"\n  | \"forward\"\n  | \"refresh\"\n  | \"eval\"\n  | \"tab_list\"\n  | \"tab_new\"\n  | \"tab_select\"\n  | \"tab_close\"\n  | \"frame\"\n  | \"frame_main\"\n  | \"dialog\"\n  | \"network\"\n  | \"console\"\n  | \"errors\"\n  | \"trace\";\n\n/** 请求类型 */\nexport interface Request {\n  /** 请求唯一标识 */\n  id: string;\n  /** 操作类型 */\n  action: ActionType;\n  /** 目标 URL（open 操作时必填） */\n  url?: string;\n  /** 元素引用（click, fill, get 操作时使用） */\n  ref?: string;\n  /** 输入文本（fill 操作时使用） */\n  text?: string;\n  /** 获取属性类型（get 操作时使用） */\n  attribute?: string;\n  /** 截图保存路径（screenshot 操作时使用） */\n  path?: string;\n  /** 是否只输出可交互元素（snapshot 命令使用） */\n  interactive?: boolean;\n  /** JavaScript 代码（eval 命令使用） */\n  script?: string;\n  /** 选项值（select 命令使用） */\n  value?: string;\n  /** 标签页索引（tab_select, tab_close 命令使用） */\n  index?: number;\n  /** 标签页 ID（tab_select, tab_close 命令使用，优先于 index） */\n  tabId?: number | string;\n  /** CSS 选择器（frame 命令使用，定位 iframe） */\n  selector?: string;\n  /** dialog 响应类型（dialog 命令使用） */\n  dialogResponse?: \"accept\" | \"dismiss\";\n  /** prompt 对话框的输入文本（dialog accept 时可选） */\n  promptText?: string;\n  /** network 子命令：requests, route, unroute, clear */\n  networkCommand?: \"requests\" | \"route\" | \"unroute\" | \"clear\";\n  /** network route 选项 */\n  routeOptions?: {\n    abort?: boolean;\n    body?: string;\n    status?: number;\n    headers?: Record<string, string>;\n  };\n  /** 过滤字符串（network requests, console 使用） */\n  filter?: string;\n  /** console 子命令：get, clear */\n  consoleCommand?: \"get\" | \"clear\";\n  /** errors 子命令：get, clear */\n  errorsCommand?: \"get\" | \"clear\";\n  /** trace 子命令：start, stop, status */\n  traceCommand?: \"start\" | \"stop\" | \"status\";\n}\n\n/** 元素引用信息 */\nexport interface RefInfo {\n  /** 元素的 XPath */\n  xpath: string;\n  /** 可访问性角色 */\n  role: string;\n  /** 可访问名称 */\n  name?: string;\n  /** 标签名 */\n  tagName: string;\n}\n\n/** 标签页信息 */\nexport interface TabInfo {\n  /** 标签页在窗口中的索引（0-based） */\n  index: number;\n  /** 标签页 URL */\n  url: string;\n  /** 标签页标题 */\n  title: string;\n  /** 是否是当前活动标签页 */\n  active: boolean;\n  /** 标签页 ID */\n  tabId: number;\n}\n\n/** Snapshot 命令返回的数据 */\nexport interface SnapshotData {\n  /** 文本格式的可访问性树 */\n  snapshot: string;\n  /** 元素引用映射，key 为 ref ID */\n  refs: Record<string, RefInfo>;\n}\n\n/** 网络请求信息 */\nexport interface NetworkRequestInfo {\n  requestId: string;\n  url: string;\n  method: string;\n  type: string;\n  timestamp: number;\n  status?: number;\n  statusText?: string;\n  failed?: boolean;\n  failureReason?: string;\n}\n\n/** 控制台消息 */\nexport interface ConsoleMessageInfo {\n  type: 'log' | 'info' | 'warn' | 'error' | 'debug';\n  text: string;\n  timestamp: number;\n  url?: string;\n  lineNumber?: number;\n}\n\n/** JS 错误信息 */\nexport interface JSErrorInfo {\n  message: string;\n  url?: string;\n  lineNumber?: number;\n  columnNumber?: number;\n  stackTrace?: string;\n  timestamp: number;\n}\n\n/** Trace 事件类型 - 录制用户操作 */\nexport interface TraceEvent {\n  /** 事件类型 */\n  type: 'click' | 'fill' | 'select' | 'check' | 'press' | 'scroll' | 'navigation';\n  /** 时间戳 */\n  timestamp: number;\n  /** 事件发生时的页面 URL */\n  url: string;\n  \n  /** 元素引用 - highlightIndex，可直接用于 @ref */\n  ref?: number;\n  /** 备用定位 - XPath */\n  xpath?: string;\n  /** CSS 选择器 */\n  cssSelector?: string;\n  \n  /** 操作参数 - fill/select 的值 */\n  value?: string;\n  /** 操作参数 - press 的按键 */\n  key?: string;\n  /** 操作参数 - scroll 方向 */\n  direction?: 'up' | 'down' | 'left' | 'right';\n  /** 操作参数 - scroll 距离 */\n  pixels?: number;\n  /** 操作参数 - check/uncheck 状态 */\n  checked?: boolean;\n  \n  /** 语义信息 - 元素角色 */\n  elementRole?: string;\n  /** 语义信息 - 元素名称 */\n  elementName?: string;\n  /** 语义信息 - 元素标签 */\n  elementTag?: string;\n}\n\n/** Trace 录制状态 */\nexport interface TraceStatus {\n  /** 是否正在录制 */\n  recording: boolean;\n  /** 已录制事件数量 */\n  eventCount: number;\n  /** 录制的标签页 ID */\n  tabId?: number;\n}\n\n/** 响应数据 */\nexport interface ResponseData {\n  /** 页面标题 */\n  title?: string;\n  /** 当前 URL */\n  url?: string;\n  /** Tab ID */\n  tabId?: number;\n  /** Snapshot 数据（snapshot 操作返回） */\n  snapshotData?: SnapshotData;\n  /** 获取的文本或属性值（get 操作返回） */\n  value?: string;\n  /** 截图路径（screenshot 操作返回） */\n  screenshotPath?: string;\n  /** eval 执行结果 */\n  result?: unknown;\n  /** 标签页列表（tab_list 命令返回） */\n  tabs?: TabInfo[];\n  /** 当前活动标签页索引（tab_list 命令返回） */\n  activeIndex?: number;\n  /** Frame 信息（frame 命令返回） */\n  frameInfo?: {\n    /** iframe 的 CSS 选择器 */\n    selector?: string;\n    /** iframe 的 name 属性 */\n    name?: string;\n    /** iframe 的 URL */\n    url?: string;\n    /** frame ID */\n    frameId?: number;\n  };\n  /** dialog 信息（dialog 命令返回） */\n  dialogInfo?: {\n    /** 对话框类型：alert, confirm, prompt, beforeunload */\n    type: string;\n    /** 对话框消息 */\n    message: string;\n    /** 是否成功处理 */\n    handled: boolean;\n  };\n  /** 网络请求列表（network requests 命令返回） */\n  networkRequests?: NetworkRequestInfo[];\n  /** 网络路由规则数量（network route/unroute 命令返回） */\n  routeCount?: number;\n  /** 控制台消息列表（console 命令返回） */\n  consoleMessages?: ConsoleMessageInfo[];\n  /** JS 错误列表（errors 命令返回） */\n  jsErrors?: JSErrorInfo[];\n  /** Trace 事件列表（trace stop 命令返回） */\n  traceEvents?: TraceEvent[];\n  /** Trace 录制状态（trace status 命令返回） */\n  traceStatus?: TraceStatus;\n}\n\n/** 响应类型 */\nexport interface Response {\n  /** 对应请求的 ID */\n  id: string;\n  /** 操作是否成功 */\n  success: boolean;\n  /** 成功时返回的数据 */\n  data?: ResponseData;\n  /** 失败时的错误信息 */\n  error?: string;\n}\n\n/** SSE 事件类型 */\nexport type SSEEventType = \"connected\" | \"heartbeat\" | \"command\";\n\n/** SSE 事件数据 */\nexport interface SSEEvent {\n  type: SSEEventType;\n  data: unknown;\n}\n\n/** Daemon 状态 */\nexport interface DaemonStatus {\n  running: boolean;\n  extensionConnected: boolean;\n  pendingRequests: number;\n  uptime: number;\n}\n\n/**\n * 生成唯一请求 ID\n * @returns UUID v4 格式的字符串\n */\nexport function generateId(): string {\n  return crypto.randomUUID();\n}\n","/**\n * bb-browser 共享常量\n */\n\n/** Daemon HTTP 服务端口 */\nexport const DAEMON_PORT = 19824;\n\n/** Daemon 主机地址 */\nexport const DAEMON_HOST = \"localhost\";\n\n/** Daemon 基础 URL */\nexport const DAEMON_BASE_URL = `http://${DAEMON_HOST}:${DAEMON_PORT}`;\n\n/** SSE 心跳间隔（毫秒） - 15秒确保 MV3 Service Worker 不休眠 */\nexport const SSE_HEARTBEAT_INTERVAL = 15000; // 15 秒\n\n/** 命令执行超时时间（毫秒） */\nexport const COMMAND_TIMEOUT = 30000; // 30 秒\n\n/** SSE 重连延迟（毫秒） */\nexport const SSE_RECONNECT_DELAY = 3000; // 3 秒\n\n/** SSE 最大重连尝试次数 */\nexport const SSE_MAX_RECONNECT_ATTEMPTS = 5;\n"],"mappings":";;;AA8RO,SAAS,aAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AC3RO,IAAM,cAAc;AAGpB,IAAM,cAAc;AAGpB,IAAM,kBAAkB,UAAU,WAAW,IAAI,WAAW;AAG5D,IAAM,yBAAyB;AAG/B,IAAM,kBAAkB;","names":[]}

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   COMMAND_TIMEOUT,
   DAEMON_BASE_URL,
   generateId
-} from "./chunk-KATHFDYJ.js";
+} from "./chunk-YAVLEXUJ.js";
 
 // packages/cli/src/client.ts
 async function sendCommand(request) {
@@ -186,7 +186,8 @@ async function snapshotCommand(options = {}) {
   const request = {
     id: generateId(),
     action: "snapshot",
-    interactive: options.interactive
+    interactive: options.interactive,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -219,7 +220,8 @@ async function clickCommand(ref, options = {}) {
   const request = {
     id: generateId(),
     action: "click",
-    ref: parsedRef
+    ref: parsedRef,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -253,7 +255,8 @@ async function hoverCommand(ref, options = {}) {
   const request = {
     id: generateId(),
     action: "hover",
-    ref: parsedRef
+    ref: parsedRef,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -291,7 +294,8 @@ async function fillCommand(ref, text, options = {}) {
     id: generateId(),
     action: "fill",
     ref: parsedRef,
-    text
+    text,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -330,7 +334,8 @@ async function typeCommand(ref, text, options = {}) {
     id: generateId(),
     action: "type",
     ref: parsedRef,
-    text
+    text,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -357,7 +362,8 @@ async function closeCommand(options = {}) {
   await ensureDaemonRunning();
   const request = {
     id: generateId(),
-    action: "close"
+    action: "close",
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -390,7 +396,8 @@ async function getCommand(attribute, ref, options = {}) {
     id: generateId(),
     action: "get",
     attribute,
-    ref: ref ? parseRef5(ref) : void 0
+    ref: ref ? parseRef5(ref) : void 0,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -429,7 +436,8 @@ async function screenshotCommand(outputPath, options = {}) {
   const filePath = outputPath ? path.resolve(outputPath) : getDefaultPath();
   const request = {
     id: generateId(),
-    action: "screenshot"
+    action: "screenshot",
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (response.success && response.data?.dataUrl) {
@@ -473,7 +481,8 @@ async function waitCommand(target, options = {}) {
       id: generateId(),
       action: "wait",
       waitType: "time",
-      ms
+      ms,
+      tabId: options.tabId
     };
   } else {
     const ref = parseRef6(target);
@@ -481,7 +490,8 @@ async function waitCommand(target, options = {}) {
       id: generateId(),
       action: "wait",
       waitType: "element",
-      ref
+      ref,
+      tabId: options.tabId
     };
   }
   const response = await sendCommand(request);
@@ -529,7 +539,8 @@ async function pressCommand(keyString, options = {}) {
     id: generateId(),
     action: "press",
     key,
-    modifiers
+    modifiers,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -569,7 +580,8 @@ async function scrollCommand(direction, pixels, options = {}) {
     id: generateId(),
     action: "scroll",
     direction,
-    pixels: pixelValue
+    pixels: pixelValue,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -758,7 +770,8 @@ async function backCommand(options = {}) {
   await ensureDaemonRunning();
   const request = {
     id: generateId(),
-    action: "back"
+    action: "back",
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -781,7 +794,8 @@ async function forwardCommand(options = {}) {
   await ensureDaemonRunning();
   const request = {
     id: generateId(),
-    action: "forward"
+    action: "forward",
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -804,7 +818,8 @@ async function refreshCommand(options = {}) {
   await ensureDaemonRunning();
   const request = {
     id: generateId(),
-    action: "refresh"
+    action: "refresh",
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -837,7 +852,8 @@ async function checkCommand(ref, options = {}) {
   const request = {
     id: generateId(),
     action: "check",
-    ref: parsedRef
+    ref: parsedRef,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -875,7 +891,8 @@ async function uncheckCommand(ref, options = {}) {
   const request = {
     id: generateId(),
     action: "uncheck",
-    ref: parsedRef
+    ref: parsedRef,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -922,7 +939,8 @@ async function selectCommand(ref, value, options = {}) {
     id: generateId(),
     action: "select",
     ref: parsedRef,
-    value
+    value,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -959,7 +977,8 @@ async function evalCommand(script, options = {}) {
   const request = {
     id: generateId(),
     action: "eval",
-    script
+    script,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -984,7 +1003,17 @@ async function evalCommand(script, options = {}) {
 }
 
 // packages/cli/src/commands/tab.ts
-function parseTabSubcommand(args) {
+function parseTabSubcommand(args, rawArgv) {
+  let tabId;
+  if (rawArgv) {
+    const idIdx = rawArgv.indexOf("--id");
+    if (idIdx >= 0 && rawArgv[idIdx + 1]) {
+      tabId = parseInt(rawArgv[idIdx + 1], 10);
+      if (isNaN(tabId)) {
+        throw new Error(`\u65E0\u6548\u7684 tabId: ${rawArgv[idIdx + 1]}`);
+      }
+    }
+  }
   if (args.length === 0) {
     return { action: "tab_list" };
   }
@@ -992,7 +1021,16 @@ function parseTabSubcommand(args) {
   if (first === "new") {
     return { action: "tab_new", url: args[1] };
   }
+  if (first === "select") {
+    if (tabId !== void 0) {
+      return { action: "tab_select", tabId };
+    }
+    throw new Error("tab select \u9700\u8981 --id \u53C2\u6570\uFF0C\u7528\u6CD5\uFF1Abb-browser tab select --id <tabId>");
+  }
   if (first === "close") {
+    if (tabId !== void 0) {
+      return { action: "tab_close", tabId };
+    }
     const indexArg = args[1];
     if (indexArg !== void 0) {
       const index2 = parseInt(indexArg, 10);
@@ -1021,12 +1059,13 @@ function formatTabList(tabs, activeIndex) {
 }
 async function tabCommand(args, options = {}) {
   await ensureDaemonRunning();
-  const parsed = parseTabSubcommand(args);
+  const parsed = parseTabSubcommand(args, process.argv);
   const request = {
     id: generateId(),
     action: parsed.action,
     url: parsed.url,
-    index: parsed.index
+    index: parsed.index,
+    tabId: parsed.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -1074,7 +1113,8 @@ async function frameCommand(selector, options = {}) {
   const request = {
     id: generateId(),
     action: "frame",
-    selector
+    selector,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -1097,7 +1137,8 @@ async function frameMainCommand(options = {}) {
   await ensureDaemonRunning();
   const request = {
     id: generateId(),
-    action: "frame_main"
+    action: "frame_main",
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -1122,7 +1163,8 @@ async function dialogCommand(subCommand, promptText, options = {}) {
     id: generateId(),
     action: "dialog",
     dialogResponse: subCommand,
-    promptText: subCommand === "accept" ? promptText : void 0
+    promptText: subCommand === "accept" ? promptText : void 0,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
@@ -1154,7 +1196,8 @@ async function networkCommand(subCommand, urlOrFilter, options = {}) {
     routeOptions: subCommand === "route" ? {
       abort: options.abort,
       body: options.body
-    } : void 0
+    } : void 0,
+    tabId: options.tabId
   });
   if (options.json) {
     console.log(JSON.stringify(response));
@@ -1217,7 +1260,8 @@ async function consoleCommand(options = {}) {
   const response = await sendCommand({
     id: crypto.randomUUID(),
     action: "console",
-    consoleCommand: options.clear ? "clear" : "get"
+    consoleCommand: options.clear ? "clear" : "get",
+    tabId: options.tabId
   });
   if (options.json) {
     console.log(JSON.stringify(response));
@@ -1261,7 +1305,8 @@ async function errorsCommand(options = {}) {
   const response = await sendCommand({
     id: crypto.randomUUID(),
     action: "errors",
-    errorsCommand: options.clear ? "clear" : "get"
+    errorsCommand: options.clear ? "clear" : "get",
+    tabId: options.tabId
   });
   if (options.json) {
     console.log(JSON.stringify(response));
@@ -1300,7 +1345,8 @@ async function traceCommand(subCommand, options = {}) {
   const response = await sendCommand({
     id: crypto.randomUUID(),
     action: "trace",
-    traceCommand: subCommand
+    traceCommand: subCommand,
+    tabId: options.tabId
   });
   if (options.json) {
     console.log(JSON.stringify(response));
@@ -1376,7 +1422,7 @@ async function traceCommand(subCommand, options = {}) {
 }
 
 // packages/cli/src/index.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.2";
 var HELP_TEXT = `
 bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
 
@@ -1412,8 +1458,10 @@ bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
   refresh           \u5237\u65B0\u9875\u9762
   tab               \u5217\u51FA\u6240\u6709\u6807\u7B7E\u9875
   tab new [url]     \u65B0\u5EFA\u6807\u7B7E\u9875
-  tab <n>           \u5207\u6362\u5230\u7B2C n \u4E2A\u6807\u7B7E\u9875
-  tab close [n]     \u5173\u95ED\u6807\u7B7E\u9875\uFF08\u9ED8\u8BA4\u5F53\u524D\uFF09
+  tab <n>           \u5207\u6362\u5230\u7B2C n \u4E2A\u6807\u7B7E\u9875\uFF08\u6309 index\uFF09
+  tab select --id <id>  \u5207\u6362\u5230\u6307\u5B9A tabId \u7684\u6807\u7B7E\u9875
+  tab close [n]     \u5173\u95ED\u6807\u7B7E\u9875\uFF08\u6309 index\uFF0C\u9ED8\u8BA4\u5F53\u524D\uFF09
+  tab close --id <id>   \u5173\u95ED\u6307\u5B9A tabId \u7684\u6807\u7B7E\u9875
   frame <selector>  \u5207\u6362\u5230\u6307\u5B9A iframe
   frame main        \u8FD4\u56DE\u4E3B frame
   dialog accept [text]  \u63A5\u53D7\u5BF9\u8BDD\u6846\uFF08alert/confirm/prompt\uFF09
@@ -1433,6 +1481,7 @@ bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
 \u9009\u9879\uFF1A
   --json          \u4EE5 JSON \u683C\u5F0F\u8F93\u51FA
   -i, --interactive \u53EA\u8F93\u51FA\u53EF\u4EA4\u4E92\u5143\u7D20\uFF08snapshot \u547D\u4EE4\uFF09
+  --tab <tabId>   \u6307\u5B9A\u64CD\u4F5C\u7684\u6807\u7B7E\u9875 ID
   --help, -h      \u663E\u793A\u5E2E\u52A9\u4FE1\u606F
   --version, -v   \u663E\u793A\u7248\u672C\u53F7
 
@@ -1461,7 +1510,12 @@ function parseArgs(argv) {
       interactive: false
     }
   };
+  let skipNext = false;
   for (const arg of args) {
+    if (skipNext) {
+      skipNext = false;
+      continue;
+    }
     if (arg === "--json") {
       result.flags.json = true;
     } else if (arg === "--help" || arg === "-h") {
@@ -1470,6 +1524,10 @@ function parseArgs(argv) {
       result.flags.version = true;
     } else if (arg === "--interactive" || arg === "-i") {
       result.flags.interactive = true;
+    } else if (arg === "--id") {
+      skipNext = true;
+    } else if (arg === "--tab" && !result.command) {
+      skipNext = true;
     } else if (arg.startsWith("-")) {
     } else if (result.command === null) {
       result.command = arg;
@@ -1481,6 +1539,8 @@ function parseArgs(argv) {
 }
 async function main() {
   const parsed = parseArgs(process.argv);
+  const tabArgIdx = process.argv.indexOf("--tab");
+  const globalTabId = tabArgIdx >= 0 && process.argv[tabArgIdx + 1] ? parseInt(process.argv[tabArgIdx + 1], 10) : void 0;
   if (parsed.flags.version) {
     console.log(VERSION);
     return;
@@ -1504,7 +1564,7 @@ async function main() {
         break;
       }
       case "snapshot": {
-        await snapshotCommand({ json: parsed.flags.json, interactive: parsed.flags.interactive });
+        await snapshotCommand({ json: parsed.flags.json, interactive: parsed.flags.interactive, tabId: globalTabId });
         break;
       }
       case "click": {
@@ -1515,7 +1575,7 @@ async function main() {
           console.error("\u793A\u4F8B\uFF1Abb-browser click @5");
           process.exit(1);
         }
-        await clickCommand(ref, { json: parsed.flags.json });
+        await clickCommand(ref, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "hover": {
@@ -1526,7 +1586,7 @@ async function main() {
           console.error("\u793A\u4F8B\uFF1Abb-browser hover @5");
           process.exit(1);
         }
-        await hoverCommand(ref, { json: parsed.flags.json });
+        await hoverCommand(ref, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "check": {
@@ -1537,7 +1597,7 @@ async function main() {
           console.error("\u793A\u4F8B\uFF1Abb-browser check @5");
           process.exit(1);
         }
-        await checkCommand(ref, { json: parsed.flags.json });
+        await checkCommand(ref, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "uncheck": {
@@ -1548,7 +1608,7 @@ async function main() {
           console.error("\u793A\u4F8B\uFF1Abb-browser uncheck @5");
           process.exit(1);
         }
-        await uncheckCommand(ref, { json: parsed.flags.json });
+        await uncheckCommand(ref, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "fill": {
@@ -1566,7 +1626,7 @@ async function main() {
           console.error('\u793A\u4F8B\uFF1Abb-browser fill @3 "hello world"');
           process.exit(1);
         }
-        await fillCommand(ref, text, { json: parsed.flags.json });
+        await fillCommand(ref, text, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "type": {
@@ -1584,7 +1644,7 @@ async function main() {
           console.error('\u793A\u4F8B\uFF1Abb-browser type @3 "append text"');
           process.exit(1);
         }
-        await typeCommand(ref, text, { json: parsed.flags.json });
+        await typeCommand(ref, text, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "select": {
@@ -1602,7 +1662,7 @@ async function main() {
           console.error('\u793A\u4F8B\uFF1Abb-browser select @4 "option1"');
           process.exit(1);
         }
-        await selectCommand(ref, value, { json: parsed.flags.json });
+        await selectCommand(ref, value, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "eval": {
@@ -1613,7 +1673,7 @@ async function main() {
           console.error('\u793A\u4F8B\uFF1Abb-browser eval "document.title"');
           process.exit(1);
         }
-        await evalCommand(script, { json: parsed.flags.json });
+        await evalCommand(script, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "get": {
@@ -1631,7 +1691,7 @@ async function main() {
           process.exit(1);
         }
         const ref = parsed.args[1];
-        await getCommand(attribute, ref, { json: parsed.flags.json });
+        await getCommand(attribute, ref, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "daemon":
@@ -1652,24 +1712,24 @@ async function main() {
         break;
       }
       case "close": {
-        await closeCommand({ json: parsed.flags.json });
+        await closeCommand({ json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "back": {
-        await backCommand({ json: parsed.flags.json });
+        await backCommand({ json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "forward": {
-        await forwardCommand({ json: parsed.flags.json });
+        await forwardCommand({ json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "refresh": {
-        await refreshCommand({ json: parsed.flags.json });
+        await refreshCommand({ json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "screenshot": {
         const outputPath = parsed.args[0];
-        await screenshotCommand(outputPath, { json: parsed.flags.json });
+        await screenshotCommand(outputPath, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "wait": {
@@ -1681,7 +1741,7 @@ async function main() {
           console.error("      bb-browser wait @5");
           process.exit(1);
         }
-        await waitCommand(target, { json: parsed.flags.json });
+        await waitCommand(target, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "press": {
@@ -1693,7 +1753,7 @@ async function main() {
           console.error("      bb-browser press Control+a");
           process.exit(1);
         }
-        await pressCommand(key, { json: parsed.flags.json });
+        await pressCommand(key, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "scroll": {
@@ -1706,7 +1766,7 @@ async function main() {
           console.error("      bb-browser scroll up 500");
           process.exit(1);
         }
-        await scrollCommand(direction, pixels, { json: parsed.flags.json });
+        await scrollCommand(direction, pixels, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "tab": {
@@ -1723,9 +1783,9 @@ async function main() {
           process.exit(1);
         }
         if (selectorOrMain === "main") {
-          await frameMainCommand({ json: parsed.flags.json });
+          await frameMainCommand({ json: parsed.flags.json, tabId: globalTabId });
         } else {
-          await frameCommand(selectorOrMain, { json: parsed.flags.json });
+          await frameCommand(selectorOrMain, { json: parsed.flags.json, tabId: globalTabId });
         }
         break;
       }
@@ -1740,7 +1800,7 @@ async function main() {
           process.exit(1);
         }
         const promptText = parsed.args[1];
-        await dialogCommand(subCommand, promptText, { json: parsed.flags.json });
+        await dialogCommand(subCommand, promptText, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       case "network": {
@@ -1749,17 +1809,17 @@ async function main() {
         const abort = process.argv.includes("--abort");
         const bodyIndex = process.argv.findIndex((a) => a === "--body");
         const body = bodyIndex >= 0 ? process.argv[bodyIndex + 1] : void 0;
-        await networkCommand(subCommand, urlOrFilter, { json: parsed.flags.json, abort, body });
+        await networkCommand(subCommand, urlOrFilter, { json: parsed.flags.json, abort, body, tabId: globalTabId });
         break;
       }
       case "console": {
         const clear = process.argv.includes("--clear");
-        await consoleCommand({ json: parsed.flags.json, clear });
+        await consoleCommand({ json: parsed.flags.json, clear, tabId: globalTabId });
         break;
       }
       case "errors": {
         const clear = process.argv.includes("--clear");
-        await errorsCommand({ json: parsed.flags.json, clear });
+        await errorsCommand({ json: parsed.flags.json, clear, tabId: globalTabId });
         break;
       }
       case "trace": {
@@ -1772,7 +1832,7 @@ async function main() {
           console.error("      bb-browser trace status");
           process.exit(1);
         }
-        await traceCommand(subCmd, { json: parsed.flags.json });
+        await traceCommand(subCmd, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
       default: {