@pyrokine/mcp-chrome 1.0.0 → 1.3.0

package/README.md

@@ -2,7 +2,8 @@
 
 English | [中文](README_zh.md)
 
-Chrome browser automation MCP Server using Chrome DevTools Protocol (CDP).
+Chrome browser automation MCP Server with dual-mode architecture: **Extension mode** (recommended) controls your
+existing browser, **CDP mode** (fallback) launches a dedicated instance.
 
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org/)
@@ -10,12 +11,18 @@ Chrome browser automation MCP Server using Chrome DevTools Protocol (CDP).
 
 ## Features
 
-- **Native CDP**: Direct Chrome DevTools Protocol communication, no Puppeteer/Playwright dependency
-- **8 Unified Tools**: Reduced from 30+ granular tools to 8 action-based tools
-- **Semantic Targeting**: 10 ways to locate elements (role, text, label, css, xpath, coordinates, etc.)
-- **Auto-Wait**: Built-in clickability and input-ready detection
-- **Structured Errors**: Every error includes code, message, suggestion, and context
+- **Dual Mode**: Extension mode shares your login sessions; CDP mode for headless/isolated scenarios
+- **8 Unified Tools**: Action-based design covering browse, input, extract, wait, evaluate, manage, cookies, logs
+- **Multi-Tab Parallel**: `tabId` parameter enables operations on any tab without switching focus
+- **iframe Penetration**: `frame` parameter targets elements inside iframes (CSS selector or index, Extension mode)
+- **Semantic Targeting**: 11 ways to locate elements (role, text, label, css, css+text combo, xpath, coordinates, etc.)
+- **Auto-Wait**: Built-in clickability and input-ready detection with deadline-based timeout budget
+- **Dual Input Mode**: `precise` (debugger API, bypasses CSP) or `stealth` (JS injection, no debug banner)
+- **Smart Output**: Bare `return` auto-wrapped in IIFE; large results (>100KB) auto-saved to file; `output` writes raw
+  text for strings
+- **Multi-Server**: Extension auto-discovers and connects to multiple MCP Server instances simultaneously
 - **Anti-Detection**: Optional fingerprint masking and behavior simulation
+- **Structured Errors**: Every error includes code, message, suggestion, and context
 
 ## Compatible Clients
 
@@ -29,6 +36,12 @@ Chrome browser automation MCP Server using Chrome DevTools Protocol (CDP).
 
 ## Installation
 
+```bash
+npm install -g @pyrokine/mcp-chrome
+```
+
+Or from source:
+
 ```bash
 git clone https://github.com/Pyrokine/claude-mcp-tools.git
 cd claude-mcp-tools/mcp-chrome
@@ -38,30 +51,26 @@ npm run build
 
 ## Quick Start
 
-### 1. Start Chrome with Remote Debugging
-
-```bash
-# With UI
-./scripts/start-chrome.sh
+### Mode 1: Extension Mode (Recommended)
 
-# Headless mode
-./scripts/start-chrome-headless.sh
+Extension mode controls your existing Chrome — shares login sessions, cookies, and browsing context.
 
-# Or manually:
-google-chrome --remote-debugging-port=9222
-```
+**Step 1: Install Chrome Extension**
 
-### 2. Configure MCP Client
+1. Open `chrome://extensions/` in Chrome
+2. Enable "Developer mode" (top-right toggle)
+3. Click "Load unpacked" → select `mcp-chrome/extension/dist/` directory
+4. The MCP Chrome icon appears in the toolbar
 
-#### Claude Code
+**Step 2: Configure MCP Client**
 
 ```bash
+# Claude Code
 claude mcp add chrome -- node /path/to/mcp-chrome/dist/index.js
 ```
 
-#### Claude Desktop / Other Clients
-
 ```json
+// Claude Desktop / Other Clients
 {
   "mcpServers": {
     "chrome": {
@@ -72,29 +81,53 @@ claude mcp add chrome -- node /path/to/mcp-chrome/dist/index.js
 }
 ```
 
+**Step 3: Connect**
+
+The Extension auto-connects to the MCP Server via HTTP/WebSocket (port 19222-19299). Click the toolbar icon to verify
+connection status.
+
+```
+browse(action="list")          // List all tabs
+browse(action="open", url="https://example.com")
+extract(type="screenshot")
+```
+
+### Mode 2: CDP Mode (Fallback)
+
+CDP mode launches or connects to a dedicated Chrome instance. Used when the Extension is not installed, or for
+headless/isolated scenarios.
+
+```bash
+# Start Chrome with remote debugging
+google-chrome --remote-debugging-port=9222
+```
+
+```
+browse(action="connect", port=9222)
+browse(action="open", url="https://example.com")
+```
+
+> When the Extension is connected, all tools use Extension mode automatically. CDP mode activates only when the
+> Extension is unavailable.
+
 ## Available Tools (8 Tools)
 
 ### browse - Browser Management & Navigation
 
-| Action    | Description                                                  |
-|-----------|--------------------------------------------------------------|
-| `launch`  | Launch new Chrome instance                                   |
-| `connect` | Connect to running Chrome (requires --remote-debugging-port) |
-| `list`    | List all available pages/targets                             |
-| `attach`  | Attach to a specific page                                    |
-| `open`    | Navigate to URL                                              |
-| `back`    | Go back in history                                           |
-| `forward` | Go forward in history                                        |
-| `refresh` | Reload page                                                  |
-| `close`   | Close browser                                                |
-
-**Anti-detection modes** (for `launch`/`connect`):
-
-| Mode         | Description                                                           |
-|--------------|-----------------------------------------------------------------------|
-| `off`        | Disabled - pure mode for testing/CI                                   |
-| `safe`       | Minimal changes (default) - removes webdriver flag, cleans CDP traces |
-| `aggressive` | Full masking - plugins, WebGL, languages (may have side effects)      |
+| Action    | Description                           |
+|-----------|---------------------------------------|
+| `launch`  | Launch new Chrome instance (CDP mode) |
+| `connect` | Connect to running Chrome (CDP mode)  |
+| `list`    | List all pages/tabs                   |
+| `attach`  | Attach to a specific page/tab         |
+| `open`    | Navigate to URL                       |
+| `back`    | Go back in history                    |
+| `forward` | Go forward in history                 |
+| `refresh` | Reload page                           |
+| `close`   | Close browser connection              |
+
+Extension-specific: `list` returns `managed` field (whether tab is in MCP Chrome group) and `isActive` field (whether
+it's the current operation target). `open` auto-creates tab group (cyan color).
 
 ### input - Keyboard & Mouse Input
 
@@ -110,6 +143,9 @@ Event sequence model supporting arbitrary combinations:
 | `type`                                  | Type text                  |
 | `wait`                                  | Pause between events       |
 
+Parameters: `humanize` enables Bézier curve movement and random delays. `tabId` targets a specific tab. `frame` targets
+an iframe (CSS selector or index). Both Extension mode only.
+
 ### extract - Content Extraction
 
 | Type         | Description                                       |
@@ -120,6 +156,9 @@ Event sequence model supporting arbitrary combinations:
 | `screenshot` | Take screenshot                                   |
 | `state`      | Get page state (URL, title, interactive elements) |
 
+Parameters: `output` saves result to file. `tabId` targets a specific tab. `frame` targets an iframe. Both Extension
+mode only.
+
 ### wait - Wait for Conditions
 
 | For          | Description                                         |
@@ -129,16 +168,37 @@ Event sequence model supporting arbitrary combinations:
 | `time`       | Fixed delay                                         |
 | `idle`       | Wait for network idle                               |
 
+Parameters: `tabId` targets a specific tab. `frame` targets an iframe. Both Extension mode only.
+
+### evaluate - JavaScript Execution
+
+Execute JavaScript in page context.
+
+| Parameter | Description                                                               |
+|-----------|---------------------------------------------------------------------------|
+| `script`  | JavaScript code (required). Bare `return` statements auto-wrapped in IIFE |
+| `args`    | Arguments passed to script (script must be a function expression)         |
+| `mode`    | `precise` (default, debugger API) or `stealth` (JS injection)             |
+| `output`  | Save result to file (strings written as raw text, others as JSON)         |
+| `tabId`   | Target a specific tab (Extension mode)                                    |
+| `frame`   | Target an iframe by CSS selector or index (Extension mode)                |
+| `timeout` | End-to-end budget (ms)                                                    |
+
+Results >100KB are auto-saved to `/tmp/` with a structured hint returned.
+
 ### manage - Page & Environment Management
 
-| Action       | Description                           |
-|--------------|---------------------------------------|
-| `newPage`    | Create new page/tab                   |
-| `closePage`  | Close page                            |
-| `clearCache` | Clear cache/cookies/storage           |
-| `viewport`   | Set viewport size                     |
-| `userAgent`  | Set User-Agent                        |
-| `emulate`    | Device emulation (iPhone, iPad, etc.) |
+| Action       | Description                                              |
+|--------------|----------------------------------------------------------|
+| `newPage`    | Create new page/tab                                      |
+| `closePage`  | Close page                                               |
+| `clearCache` | Clear cache/cookies/storage                              |
+| `viewport`   | Set viewport size                                        |
+| `userAgent`  | Set User-Agent                                           |
+| `emulate`    | Device emulation (iPhone, iPad, etc.)                    |
+| `inputMode`  | Query or set input mode (`precise` / `stealth`)          |
+| `stealth`    | Inject anti-detection scripts                            |
+| `cdp`        | Send raw CDP command (advanced, e.g. `Runtime.evaluate`) |
 
 ### logs - Browser Logs
 
@@ -147,6 +207,9 @@ Event sequence model supporting arbitrary combinations:
 | `console` | Console logs (with level filter)       |
 | `network` | Network request logs (with URL filter) |
 
+Parameters: `output` saves result to file. `tabId` targets a specific tab (Extension mode). `frame` is not applicable
+for logs.
+
 ### cookies - Cookie Management
 
 | Action   | Description       |
@@ -156,52 +219,90 @@ Event sequence model supporting arbitrary combinations:
 | `delete` | Delete cookie     |
 | `clear`  | Clear all cookies |
 
-### evaluate - JavaScript Execution
-
-Execute arbitrary JavaScript in page context.
-
 ## Target: Unified Element Locator
 
 All tools use a unified `Target` type for element location:
 
 ```typescript
 // By accessibility (recommended - most stable)
-{ role: "button", name: "Submit" }
+{
+    role: "button", name
+:
+    "Submit"
+}
 
 // By text content
-{ text: "Click here", exact: true }
+{
+    text: "Click here", exact
+:
+    true
+}
 
 // By form label
-{ label: "Email" }
+{
+    label: "Email"
+}
 
 // By placeholder
-{ placeholder: "Enter your name" }
+{
+    placeholder: "Enter your name"
+}
 
 // By title attribute
-{ title: "Close dialog" }
+{
+    title: "Close dialog"
+}
 
 // By alt text (images)
-{ alt: "Profile picture" }
+{
+    alt: "Profile picture"
+}
 
 // By test ID
-{ testId: "submit-button" }
+{
+    testId: "submit-button"
+}
 
 // By CSS selector
-{ css: "#login-form .submit-btn" }
+{
+    css: "#login-form .submit-btn"
+}
+
+// Disambiguate multiple matches (0-based)
+{
+    css: ".ant-select-input", nth
+:
+    1
+}
+
+// By CSS + text (filter by text content)
+{
+    css: "button", text
+:
+    "Submit", exact
+:
+    true
+}
 
 // By XPath
-{ xpath: "//button[@type='submit']" }
+{
+    xpath: "//button[@type='submit']"
+}
 
 // By coordinates
-{ x: 100, y: 200 }
+{
+    x: 100, y
+:
+    200
+}
 ```
 
 ## Usage Examples
 
-### Basic: Connect and Navigate
+### Basic: List Tabs and Navigate
 
 ```
-browse(action="connect", port=9222)
+browse(action="list")
 browse(action="open", url="https://example.com")
 extract(type="state")
 ```
@@ -225,15 +326,12 @@ input(events=[
 ])
 ```
 
-### Complex: Ctrl+Click with Human-like Movement
+### Multi-Tab Operation (Extension Mode)
 
 ```
-input(events=[
-  { type: "keydown", key: "Control" },
-  { type: "mousedown", target: { css: ".item" }, button: "left" },
-  { type: "mouseup" },
-  { type: "keyup", key: "Control" }
-], humanize=true)
+// Operate on a specific tab without switching focus
+extract(type="screenshot", tabId="12345")
+evaluate(script="document.title", tabId="12345")
 ```
 
 ### Screenshot
@@ -242,8 +340,28 @@ input(events=[
 // Full page
 extract(type="screenshot", fullPage=true)
 
-// Specific element
-extract(type="screenshot", target={ css: "#chart" })
+// JPEG with quality (smaller file)
+extract(type="screenshot", format="jpeg", quality=80, output="/tmp/screenshot.jpg")
+
+// Save to file
+extract(type="screenshot", output="/tmp/screenshot.png")
+```
+
+### iframe Operations (Extension Mode)
+
+```
+// Target iframe by CSS selector
+evaluate(script="document.title", frame="iframe#main")
+
+// Target iframe by index
+extract(type="text", frame=0)
+
+// Input inside iframe
+input(events=[
+  { type: "mousedown", target: { label: "Username" } },
+  { type: "mouseup" },
+  { type: "type", text: "admin" }
+], frame="iframe.login-frame")
 ```
 
 ### Wait for Element
@@ -255,25 +373,32 @@ wait(for="element", target={ text: "Loading complete" }, state="visible")
 ## Architecture
 
 ```
-┌─────────────────┐
-│   MCP Client    │
-│ (Claude, etc.)  │
-└────────┬────────┘
-         │ stdio (JSON-RPC)
-         ▼
-┌─────────────────┐
-│   MCP-Chrome    │
-│   (8 tools)     │
-│  ├─ core/       │  Session, Locator, AutoWait
-│  ├─ cdp/        │  Native CDP client
-│  └─ tools/      │  Tool implementations
-└────────┬────────┘
-         │ WebSocket (CDP)
-         ▼
-┌─────────────────┐
-│  Chrome Browser │
-│  (port 9222)    │
-└─────────────────┘
+┌───────────────────┐
+│    MCP Client     │
+│  (Claude, etc.)   │
+└─────────┬─────────┘
+          │ stdio (JSON-RPC)
+          ▼
+┌───────────────────┐
+│    MCP-Chrome     │
+│    (8 tools)      │
+│  ├─ core/         │  UnifiedSession, Locator, AutoWait
+│  ├─ cdp/          │  Native CDP client
+│  ├─ extension/    │  Extension bridge (HTTP + WebSocket)
+│  └─ tools/        │  Tool implementations
+└────┬─────────┬────┘
+     │         │
+     │ HTTP/WS │ WebSocket (CDP)
+     │         │
+     ▼         ▼
+┌──────────┐  ┌──────────────────┐
+│ Extension│  │ Chrome (CDP)     │
+│ (19222+) │  │ (port 9222)      │
+│          │  │ Dedicated browser│
+│ Controls │  └──────────────────┘
+│ user's   │
+│ browser  │
+└──────────┘
 ```
 
 ## Project Structure
@@ -293,18 +418,29 @@ mcp-chrome/
 │   │   ├── evaluate.ts
 │   │   └── schema.ts         # Shared JSON Schema (Target oneOf)
 │   ├── core/                 # Core abstractions
-│   │   ├── session.ts        # Session management
-│   │   ├── locator.ts        # Element locator
+│   │   ├── unified-session.ts # Dual-mode session (Extension + CDP)
+│   │   ├── session.ts        # CDP session management
+│   │   ├── locator.ts        # Element locator (deadline-based timeout)
 │   │   ├── auto-wait.ts      # Auto-wait mechanism
 │   │   ├── retry.ts          # Retry logic
 │   │   ├── types.ts          # Type definitions
 │   │   └── errors.ts         # Error types
+│   ├── extension/            # Extension bridge
+│   │   ├── bridge.ts         # High-level Extension API
+│   │   └── http-server.ts    # HTTP + WebSocket server
 │   ├── cdp/                  # CDP layer
 │   │   ├── client.ts         # WebSocket CDP client
 │   │   └── launcher.ts       # Chrome launcher
 │   └── anti-detection/       # Anti-detection (optional)
 │       ├── injection.ts
 │       └── behavior.ts
+├── extension/                # Chrome Extension (Manifest V3)
+│   ├── manifest.json
+│   ├── src/
+│   │   ├── background/       # Service Worker
+│   │   ├── content/          # Content scripts
+│   │   └── popup/            # Popup UI
+│   └── dist/                 # Built extension (load this in Chrome)
 ├── scripts/
 │   ├── start-chrome.sh
 │   └── start-chrome-headless.sh
@@ -313,15 +449,19 @@ mcp-chrome/
 
 ## Security Notes
 
-- CDP provides full browser control - use only on trusted machines
-- Default debugging port binds to 127.0.0.1 only
+- Extension mode: shares your browser sessions — only use on trusted machines
+- CDP mode: provides full browser control via DevTools Protocol
+- Default ports bind to 127.0.0.1 only (localhost)
 - The `evaluate` tool can execute arbitrary JavaScript
+- The `manage cdp` action can send arbitrary CDP commands
 - Network logs may contain sensitive information
 
 ## Known Limitations
 
-- **Single session**: Currently supports one browser session at a time
 - **Chrome only**: Only supports Chrome/Chromium browsers (no Firefox/Safari)
+- **Single CDP session**: CDP mode supports one browser session at a time
+- **Extension mode requires Chrome**: Extension is Manifest V3, Chrome-specific
+- **iframe**: Only single-level iframe targeting (no nested `>>` syntax); Extension mode only
 
 ## License
 

package/dist/anti-detection/behavior.d.ts

@@ -46,13 +46,5 @@ export declare class BehaviorSimulator {
      * 更新当前鼠标位置
      */
     setCurrentPosition(point: Point): void;
-    /**
-     * 生成人类化的鼠标移动路径
-     */
-    generateHumanMousePath(to: Point): Point[];
-    /**
-     * 生成人类化的打字延迟序列
-     */
-    generateTypingDelays(textLength: number, baseDelay?: number): number[];
 }
 //# sourceMappingURL=behavior.d.ts.map

package/dist/anti-detection/behavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behavior.d.ts","sourceRoot":"","sources":["../../src/anti-detection/behavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAA;AAE3C;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,KAAK,EACT,KAAK,CAAC,EAAE,MAAM,GACf,KAAK,EAAE,CA4BT;AAwBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,GAAE,MAAY,GAAG,MAAM,CAI9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,eAAe,CAAsB;IAE7C;;OAEG;IACH,kBAAkB,IAAI,KAAK;IAI3B;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAItC;;OAEG;IACH,sBAAsB,CAAC,EAAE,EAAE,KAAK,GAAG,KAAK,EAAE;IAI1C;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,EAAE;CAO9E"}
+{"version":3,"file":"behavior.d.ts","sourceRoot":"","sources":["../../src/anti-detection/behavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAA;AAE3C;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,KAAK,EACT,KAAK,CAAC,EAAE,MAAM,GACf,KAAK,EAAE,CA4BT;AAwBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,GAAE,MAAY,GAAG,MAAM,CAI9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,eAAe,CAAsB;IAE7C;;OAEG;IACH,kBAAkB,IAAI,KAAK;IAI3B;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAIzC"}

package/dist/anti-detection/behavior.js

@@ -93,21 +93,5 @@ export class BehaviorSimulator {
     setCurrentPosition(point) {
         this.currentPosition = { ...point };
     }
-    /**
-     * 生成人类化的鼠标移动路径
-     */
-    generateHumanMousePath(to) {
-        return generateBezierPath(this.currentPosition, to);
-    }
-    /**
-     * 生成人类化的打字延迟序列
-     */
-    generateTypingDelays(textLength, baseDelay = 100) {
-        const delays = [];
-        for (let i = 0; i < textLength; i++) {
-            delays.push(getTypingDelay(baseDelay));
-        }
-        return delays;
-    }
 }
 //# sourceMappingURL=behavior.js.map

package/dist/anti-detection/behavior.js.map

@@ -1 +1 @@
-{"version":3,"file":"behavior.js","sourceRoot":"","sources":["../../src/anti-detection/behavior.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"behavior.js","sourceRoot":"","sources":["../../src/anti-detection/behavior.ts"],"names":[],"mappings":"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"}

package/dist/cdp/client.d.ts

@@ -19,8 +19,7 @@ export declare class CDPClient extends EventEmitter {
     private callbacks;
     private nextId;
     private eventListeners;
-    private _endpoint;
-    get endpoint(): string;
+    private activeEventWaiters;
     get isConnected(): boolean;
     /**
      * 连接到 CDP 端点
@@ -40,16 +39,25 @@ export declare class CDPClient extends EventEmitter {
     offEvent(event: string, listener: CDPEventListener): void;
     /**
      * 等待特定事件
+     *
+     * close()/handleClose() 会立即 reject 所有活跃的等待者，不必等 timer 超时。
      */
     waitForEvent<T = unknown>(event: string, predicate?: (params: T) => boolean, timeout?: number): Promise<T>;
     /**
      * 关闭连接
+     *
+     * 立即 reject 所有 pending callbacks 和 waitForEvent，
+     * 然后发出 'disconnected' 信号供外部等待者（如 waitForAnyEvent）清理。
      */
     close(): void;
     /**
      * 处理收到的消息
      */
     private handleMessage;
+    /**
+     * 立即 reject 所有 pending callbacks 和 waitForEvent 等待者
+     */
+    private rejectAllPending;
     /**
      * 处理连接关闭
      */

package/dist/cdp/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cdp/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAA;AAanC;;GAEG;AACH,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAElD;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACvC,aAAa;IACb,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IACvD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAiD;IAEvE,OAAO,CAAC,SAAS,CAAgB;IAEjC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgD/D;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,MAA0C,GACpD,OAAO,CAAC,CAAC,CAAC;IAoCb;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAOxD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAOzD;;OAEG;IACH,YAAY,CAAC,CAAC,GAAG,OAAO,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,EAClC,OAAO,SAAQ,GAChB,OAAO,CAAC,CAAC,CAAC;IAmBb;;OAEG;IACH,KAAK,IAAI,IAAI;IAeb;;OAEG;IACH,OAAO,CAAC,aAAa;IAiDrB;;OAEG;IACH,OAAO,CAAC,WAAW;CAQtB;AAKD;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA6B,GACvC,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA6B,GACvC,OAAO,CACN,KAAK,CAAC;IACF,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;CAChC,CAAC,CACL,CA8BA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cdp/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAA;AAwBnC;;GAEG;AACH,KAAK,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAElD;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACvC,aAAa;IACb,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAkB;IACjE,OAAO,CAAC,EAAE,CAA4C;IACtD,OAAO,CAAC,SAAS,CAAmE;IACpF,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,cAAc,CAAoE;IAC1F,OAAO,CAAC,kBAAkB,CAA8C;IAExE,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CzE;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,MAA0C,GACpD,OAAO,CAAC,CAAC,CAAC;IA6Cb;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAOxD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAOzD;;;;OAIG;IACH,YAAY,CAAC,CAAC,GAAG,OAAO,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,EAClC,OAAO,SAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IA8Bb;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,OAAO,CAAC,aAAa;IAiDrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,WAAW;CAStB;AAgCD;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA6B,GACvC,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAA6B,GACvC,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAExG"}