@jackwener/opencli 1.0.1 → 1.0.3

package/.github/workflows/build-extension.yml

@@ -0,0 +1,62 @@
+name: Build Chrome Extension
+
+on:
+  push:
+    branches: [ "main" ]
+    tags: [ "v*.*.*" ]
+  pull_request:
+    branches: [ "main" ]
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Create Extension ZIP
+        run: |
+          cd extension
+          zip -r ../opencli-extension.zip .
+
+      - name: Create Extension CRX
+        run: |
+          npm install -g crx3
+          if [ -n "${{ secrets.CRX_PRIVATE_KEY }}" ]; then
+            echo "Found CRX_PRIVATE_KEY, signing extension..."
+            echo "${{ secrets.CRX_PRIVATE_KEY }}" > crx-key.pem
+            crx3 pack extension -o opencli-extension.crx -p crx-key.pem
+            rm crx-key.pem
+          else
+            echo "No CRX_PRIVATE_KEY configured. Generating CRX with a temporary random key..."
+            crx3 pack extension -o opencli-extension.crx
+          fi
+
+      - name: Upload Artifacts (Action Run)
+        uses: actions/upload-artifact@v4
+        with:
+          name: opencli-extension-build
+          path: |
+            opencli-extension.zip
+            opencli-extension.crx
+          retention-days: 7
+
+      - name: Attach to GitHub Release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            opencli-extension.zip
+            opencli-extension.crx
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/ci.yml

@@ -18,9 +18,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v4
         with:
           node-version: '22'
           cache: 'npm'
@@ -43,9 +43,9 @@ jobs:
         node-version: ['20', '22']
         shard: [1, 2]
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
           cache: 'npm'
@@ -62,9 +62,9 @@ jobs:
     needs: build
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v4
         with:
           node-version: '22'
           cache: 'npm'

package/.github/workflows/e2e-headed.yml

@@ -16,9 +16,9 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v4
         with:
           node-version: '22'
           cache: 'npm'

package/.github/workflows/pkg-pr-new.yml

@@ -13,9 +13,9 @@ jobs:
     if: ${{ vars.PKG_PR_NEW_ENABLED == 'true' }}
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v4
         with:
           node-version: '22'
           cache: 'npm'

package/.github/workflows/release.yml

@@ -13,9 +13,9 @@ jobs:
   release:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v4
         with:
           node-version: '22'
           registry-url: 'https://registry.npmjs.org'
@@ -26,9 +26,6 @@ jobs:
       - name: Type check
         run: npx tsc --noEmit
 
-      - name: Build
-        run: npm run build
-
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:

package/.github/workflows/security.yml

@@ -19,9 +19,9 @@ jobs:
   audit:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
 
-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v4
         with:
           node-version: '22'
           cache: 'npm'

package/CDP.md

@@ -98,6 +98,6 @@ opencli doctor                    # Verify connection
 opencli bilibili hot --limit 5    # Test a command
 ```
 
-> *Tip: OpenCLI automatically requests the `/json/version` HTTP endpoint to discover the underlying WebSocket URL if you provide a standard HTTP/HTTPS address.*
+> *Tip: If you provide a standard HTTP/HTTPS CDP endpoint, OpenCLI requests the `/json` target list and picks the most likely inspectable app/page target automatically. If multiple app targets exist, you can further narrow selection with `OPENCLI_CDP_TARGET` (for example `antigravity` or `codex`).*
 
 If you plan to use this setup frequently, you can persist the environment variable by adding the `export` line to your `~/.bashrc` or `~/.zshrc` on the server.

package/CDP.zh-CN.md

@@ -98,6 +98,6 @@ opencli doctor                    # 查看并验证连接是否通畅
 opencli bilibili hot --limit 5    # 执行目标命令
 ```
 
-> *Tip: 如果你填写的是一个普通 HTTP/HTTPS 的 URL 地址，OpenCLI 会自动尝试抓取该地址下的 `/json/version` 节点，来动态解析并连接真正底层依赖的 WebSocket 地址。*
+> *Tip: 如果你填写的是一个普通 HTTP/HTTPS 的 CDP 地址，OpenCLI 会自动请求 `/json` target 列表，并挑选最可能的 app/page target；如果同一个端口下暴露了多个应用 target，还可以通过 `OPENCLI_CDP_TARGET`（例如 `antigravity`、`codex`）进一步缩小匹配范围。*
 
 如果你想在此服务器上永久启用该配置，可以将对应的 `export` 语句追加进入你的 `~/.bashrc` 或 `~/.zshrc` 配置文件中。

package/README.md

@@ -39,7 +39,7 @@ Turn ANY Electron application into a CLI tool! Recombine, script, and extend app
 - **CLI All Electron** — CLI-ify apps like Antigravity Ultra! Now AI can control itself natively using cc/openclaw!
 - **Account-safe** — Reuses Chrome's logged-in state; your credentials never leave the browser.
 - **AI Agent ready** — `explore` discovers APIs, `synthesize` generates adapters, `cascade` finds auth strategies.
-- **Self-healing setup** — `opencli setup` auto-discovers tokens; `opencli doctor` diagnoses config across 10+ tools; `--fix` repairs them all.
+- **Self-healing setup** — `opencli setup` verifies Browser Bridge connectivity; `opencli doctor` diagnoses daemon, extension, and live browser connectivity.
 - **Dynamic Loader** — Simply drop `.ts` or `.yaml` adapters into the `clis/` folder for auto-registration.
 - **Dual-Engine Architecture** — Supports both YAML declarative data pipelines and robust browser runtime TypeScript injections.
 
@@ -54,10 +54,18 @@ OpenCLI connects to your browser through a lightweight **Browser Bridge** Chrome
 
 ### Browser Bridge Extension Setup
 
-1. Install the **opencli Browser Bridge** extension in Chrome:
-   - Open `chrome://extensions`, enable **Developer mode** (top-right toggle)
-   - Click **Load unpacked**, select the `extension/` folder from this repo
-2. That's it! The daemon auto-starts when you run any browser command. No tokens, no manual configuration.
+You can install the extension via either method:
+
+**Method 1: Download Pre-built Release (Recommended)**
+1. Go to the GitHub [Releases page](https://github.com/jackwener/opencli/releases) and download the latest `opencli-extension.zip` or `opencli-extension.crx`.
+2. Open `chrome://extensions` and enable **Developer mode** (top-right toggle).
+3. Drag and drop the `.crx` file or the unzipped folder into the extensions page.
+
+**Method 2: Load Unpacked Source (For Developers)**
+1. Open `chrome://extensions` and enable **Developer mode**.
+2. Click **Load unpacked** and select the `extension/` directory from this repository.
+
+That's it! The daemon auto-starts when you run any browser command. No tokens, no manual configuration.
 
 > **Tip**: Use `opencli doctor` for ongoing diagnosis:
 > ```bash
@@ -117,7 +125,7 @@ Run `opencli list` for the live registry.
 | **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` | 🖥️ Desktop |
 | **v2ex** | `hot` `latest` `topic` `daily` `me` `notifications` | 🌐 / 🔐 |
 | **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `watchlist` | 🔐 Browser |
-| **antigravity** | `status` `send` `read` `new` `evaluate` | 🖥️ Desktop |
+| **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` | 🖥️ Desktop |
 | **chatgpt** | `status` `new` `send` `read` `ask` | 🖥️ Desktop |
 | **xiaohongshu** | `search` `notifications` `feed` `me` `user` `download` | 🔐 Browser |
 | **apple-podcasts** | `search` `episodes` `top` | 🌐 Public |
@@ -181,7 +189,7 @@ brew install yt-dlp
 
 ```bash
 # Download images/videos from Xiaohongshu note
-opencli xiaohongshu download --note-id abc123 --output ./xhs
+opencli xiaohongshu download --note_id abc123 --output ./xhs
 
 # Download Bilibili video (requires yt-dlp)
 opencli bilibili download --bvid BV1xxx --output ./bilibili

package/README.zh-CN.md

@@ -40,7 +40,7 @@ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合
 - **CLI All Electron** — 支持把所有 electron 应用（如 Antigravity Ultra）CLI 化，让 AI 控制自己！
 - **多站点覆盖** — 覆盖 B站、知乎、小红书、Twitter、Reddit，以及多种桌面应用
 - **零风控** — 复用 Chrome 登录态，无需存储任何凭证
-- **自修复配置** — `opencli setup` 自动发现 Token；`opencli doctor` 诊断 10+ 工具配置；`--fix` 一键修复
+- **自修复配置** — `opencli setup` 检查 Browser Bridge 连通性；`opencli doctor` 诊断 daemon、扩展和浏览器连接状态
 - **AI 原生** — `explore` 自动发现 API，`synthesize` 生成适配器，`cascade` 探测认证策略
 - **动态加载引擎** — 声明式的 `.yaml` 或者底层定制的 `.ts` 适配器，放入 `clis/` 文件夹即可自动注册生效
 
@@ -55,10 +55,18 @@ OpenCLI 通过轻量化的 **Browser Bridge** Chrome 扩展 + 微型 daemon 与
 
 ### Browser Bridge 扩展配置
 
-1. 在 Chrome 中安装 **opencli Browser Bridge** 扩展：
-   - 打开 `chrome://extensions`，启用右上角的 **开发者模式**
-   - 点击 **加载已解压的扩展程序**，选择本仓库的 `extension/` 文件夹
-2. 完成！运行任何浏览器命令时 daemon 会自动启动。无需 token，无需手动配置。
+你可以选择以下任一方式安装扩展：
+
+**方式一：下载构建好的安装包（推荐）**
+1. 到 GitHub [Releases 页面](https://github.com/jackwener/opencli/releases) 下载最新的 `opencli-extension.zip` 或 `opencli-extension.crx`。
+2. 打开 Chrome 的 `chrome://extensions`，启用右上角的 **开发者模式**。
+3. 将 `.crx` 拖入浏览器窗口，或将解压后的文件夹拖入即可完成安装。
+
+**方式二：加载源码（针对开发者）**
+1. 同样在 `chrome://extensions` 开启 **开发者模式**。
+2. 点击 **加载已解压的扩展程序**，选择本仓库代码树中的 `extension/` 文件夹。
+
+完成！运行任何 opencli 浏览器命令时，后台微型 daemon 会自动启动与浏览器通信。无需配 API Token，零代码配置。
 
 > **Tip**：后续诊断用 `opencli doctor`：
 > ```bash
@@ -118,7 +126,7 @@ npm install -g @jackwener/opencli@latest
 | **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` | 🖥️ 桌面端 |
 | **v2ex** | `hot` `latest` `topic` `daily` `me` `notifications` | 🌐 / 🔐 |
 | **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `watchlist` | 🔐 浏览器 |
-| **antigravity** | `status` `send` `read` `new` `evaluate` | 🖥️ 桌面端 |
+| **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` | 🖥️ 桌面端 |
 | **chatgpt** | `status` `new` `send` `read` `ask` | 🖥️ 桌面端 |
 | **xiaohongshu** | `search` `notifications` `feed` `me` `user` `download` | 🔐 浏览器 |
 | **apple-podcasts** | `search` `episodes` `top` | 🌐 公开 |
@@ -182,7 +190,7 @@ brew install yt-dlp
 
 ```bash
 # 下载小红书笔记中的图片/视频
-opencli xiaohongshu download --note-id abc123 --output ./xhs
+opencli xiaohongshu download --note_id abc123 --output ./xhs
 
 # 下载B站视频（需要 yt-dlp）
 opencli bilibili download --bvid BV1xxx --output ./bilibili

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: opencli
 description: "OpenCLI — Make any website or Electron App your CLI. Zero risk, AI-powered, reuse Chrome login. 80+ commands across 19 sites."
-version: 0.7.3
+version: 0.7.4
 author: jackwener
 tags: [cli, browser, web, chrome-extension, cdp, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, youtube, boss, coupang, AI, agent]
 ---
@@ -170,11 +170,9 @@ opencli list --json         # JSON output
 opencli list -f yaml        # YAML output
 opencli validate            # Validate all CLI definitions
 opencli validate bilibili   # Validate specific site
-opencli setup               # Interactive token setup (auto-discover + TUI checkbox)
-opencli doctor              # Diagnose token & extension config across all tools
+opencli setup               # Interactive Browser Bridge setup and connectivity check
+opencli doctor              # Diagnose daemon, extension, and browser connectivity
 opencli doctor --live       # Also test live browser connectivity
-opencli doctor --fix        # Fix mismatched configs (interactive confirmation)
-opencli doctor --fix -y     # Fix all configs non-interactively
 ```
 
 ### AI Agent Workflow

package/dist/browser/cdp.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CDP client — implements IPage by connecting directly to a Chrome/Electron CDP WebSocket.
+ */
+import type { IPage } from '../types.js';
+export interface CDPTarget {
+    type?: string;
+    url?: string;
+    title?: string;
+    webSocketDebuggerUrl?: string;
+}
+export declare class CDPBridge {
+    private _ws;
+    private _idCounter;
+    private _pending;
+    connect(opts?: {
+        timeout?: number;
+    }): Promise<IPage>;
+    close(): Promise<void>;
+    send(method: string, params?: any): Promise<any>;
+}
+declare function selectCDPTarget(targets: CDPTarget[]): CDPTarget | undefined;
+declare function scoreCDPTarget(target: CDPTarget, preferredPattern?: RegExp): number;
+export declare const __test__: {
+    selectCDPTarget: typeof selectCDPTarget;
+    scoreCDPTarget: typeof scoreCDPTarget;
+};
+export {};

package/dist/browser/cdp.js

@@ -0,0 +1,295 @@
+/**
+ * CDP client — implements IPage by connecting directly to a Chrome/Electron CDP WebSocket.
+ */
+import { WebSocket } from 'ws';
+import { wrapForEval } from './utils.js';
+export class CDPBridge {
+    _ws = null;
+    _idCounter = 0;
+    _pending = new Map();
+    async connect(opts) {
+        const endpoint = process.env.OPENCLI_CDP_ENDPOINT;
+        if (!endpoint)
+            throw new Error('OPENCLI_CDP_ENDPOINT is not set');
+        // If it's a direct ws:// URL, use it. Otherwise, fetch the /json endpoint to find a page.
+        let wsUrl = endpoint;
+        if (endpoint.startsWith('http')) {
+            const res = await fetch(`${endpoint.replace(/\/$/, '')}/json`);
+            if (!res.ok)
+                throw new Error(`Failed to fetch CDP targets: ${res.statusText}`);
+            const targets = await res.json();
+            const target = selectCDPTarget(targets);
+            if (!target || !target.webSocketDebuggerUrl) {
+                throw new Error('No inspectable targets found at CDP endpoint');
+            }
+            wsUrl = target.webSocketDebuggerUrl;
+        }
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(wsUrl);
+            const timeout = setTimeout(() => reject(new Error('CDP connect timeout')), opts?.timeout ?? 10000);
+            ws.on('open', () => {
+                clearTimeout(timeout);
+                this._ws = ws;
+                resolve(new CDPPage(this));
+            });
+            ws.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+            ws.on('message', (data) => {
+                try {
+                    const msg = JSON.parse(data.toString());
+                    if (msg.id && this._pending.has(msg.id)) {
+                        const { resolve, reject } = this._pending.get(msg.id);
+                        this._pending.delete(msg.id);
+                        if (msg.error) {
+                            reject(new Error(msg.error.message));
+                        }
+                        else {
+                            resolve(msg.result);
+                        }
+                    }
+                }
+                catch (e) {
+                    // ignore parsing errors
+                }
+            });
+        });
+    }
+    async close() {
+        if (this._ws) {
+            this._ws.close();
+            this._ws = null;
+        }
+        for (const p of this._pending.values()) {
+            p.reject(new Error('CDP connection closed'));
+        }
+        this._pending.clear();
+    }
+    async send(method, params = {}) {
+        if (!this._ws || this._ws.readyState !== WebSocket.OPEN) {
+            throw new Error('CDP connection is not open');
+        }
+        const id = ++this._idCounter;
+        return new Promise((resolve, reject) => {
+            this._pending.set(id, { resolve, reject });
+            this._ws.send(JSON.stringify({ id, method, params }));
+        });
+    }
+}
+class CDPPage {
+    bridge;
+    constructor(bridge) {
+        this.bridge = bridge;
+    }
+    async goto(url) {
+        await this.bridge.send('Page.navigate', { url });
+        await new Promise(r => setTimeout(r, 1000));
+    }
+    async evaluate(js) {
+        const expression = wrapForEval(js);
+        const result = await this.bridge.send('Runtime.evaluate', {
+            expression,
+            returnByValue: true,
+            awaitPromise: true
+        });
+        if (result.exceptionDetails) {
+            throw new Error('Evaluate error: ' + (result.exceptionDetails.exception?.description || 'Unknown exception'));
+        }
+        return result.result?.value;
+    }
+    async snapshot(opts) {
+        throw new Error('Method not implemented.');
+    }
+    async click(ref) {
+        const safeRef = JSON.stringify(ref);
+        const code = `
+      (() => {
+        const ref = ${safeRef};
+        const el = document.querySelector('[data-ref="' + ref + '"]')
+          || document.querySelectorAll('a, button, input, [role="button"], [tabindex]')[parseInt(ref, 10) || 0];
+        if (!el) throw new Error('Element not found: ' + ref);
+        el.scrollIntoView({ behavior: 'instant', block: 'center' });
+        el.click();
+        return 'clicked';
+      })()
+    `;
+        await this.evaluate(code);
+    }
+    async typeText(ref, text) {
+        const safeRef = JSON.stringify(ref);
+        const safeText = JSON.stringify(text);
+        const code = `
+      (() => {
+        const ref = ${safeRef};
+        const el = document.querySelector('[data-ref="' + ref + '"]')
+          || document.querySelectorAll('input, textarea, [contenteditable]')[parseInt(ref, 10) || 0];
+        if (!el) throw new Error('Element not found: ' + ref);
+        el.focus();
+        el.value = ${safeText};
+        el.dispatchEvent(new Event('input', { bubbles: true }));
+        el.dispatchEvent(new Event('change', { bubbles: true }));
+        return 'typed';
+      })()
+    `;
+        await this.evaluate(code);
+    }
+    async pressKey(key) {
+        const code = `
+      (() => {
+        const el = document.activeElement || document.body;
+        el.dispatchEvent(new KeyboardEvent('keydown', { key: ${JSON.stringify(key)}, bubbles: true }));
+        el.dispatchEvent(new KeyboardEvent('keyup', { key: ${JSON.stringify(key)}, bubbles: true }));
+        return 'pressed';
+      })()
+    `;
+        await this.evaluate(code);
+    }
+    async wait(options) {
+        if (typeof options === 'number') {
+            await new Promise(resolve => setTimeout(resolve, options * 1000));
+            return;
+        }
+        if (options.time) {
+            await new Promise(resolve => setTimeout(resolve, options.time * 1000));
+            return;
+        }
+        if (options.text) {
+            const timeout = (options.timeout ?? 30) * 1000;
+            const code = `
+        new Promise((resolve, reject) => {
+          const deadline = Date.now() + ${timeout};
+          const check = () => {
+            if (document.body.innerText.includes(${JSON.stringify(options.text)})) return resolve('found');
+            if (Date.now() > deadline) return reject(new Error('Text not found: ' + ${JSON.stringify(options.text)}));
+            setTimeout(check, 200);
+          };
+          check();
+        })
+      `;
+            await this.evaluate(code);
+        }
+    }
+    async tabs() {
+        throw new Error('Method not implemented.');
+    }
+    async closeTab(index) {
+        throw new Error('Method not implemented.');
+    }
+    async newTab() {
+        throw new Error('Method not implemented.');
+    }
+    async selectTab(index) {
+        throw new Error('Method not implemented.');
+    }
+    async networkRequests(includeStatic) {
+        throw new Error('Method not implemented.');
+    }
+    async consoleMessages(level) {
+        throw new Error('Method not implemented.');
+    }
+    async scroll(direction, amount) {
+        throw new Error('Method not implemented.');
+    }
+    async autoScroll(options) {
+        throw new Error('Method not implemented.');
+    }
+    async installInterceptor(pattern) {
+        throw new Error('Method not implemented.');
+    }
+    async getInterceptedRequests() {
+        throw new Error('Method not implemented.');
+    }
+    async screenshot(options) {
+        throw new Error('Method not implemented.');
+    }
+}
+function selectCDPTarget(targets) {
+    const preferredPattern = compilePreferredPattern(process.env.OPENCLI_CDP_TARGET);
+    const ranked = targets
+        .map((target, index) => ({ target, index, score: scoreCDPTarget(target, preferredPattern) }))
+        .filter(({ score }) => Number.isFinite(score))
+        .sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return a.index - b.index;
+    });
+    return ranked[0]?.target;
+}
+function scoreCDPTarget(target, preferredPattern) {
+    if (!target.webSocketDebuggerUrl)
+        return Number.NEGATIVE_INFINITY;
+    const type = (target.type ?? '').toLowerCase();
+    const url = (target.url ?? '').toLowerCase();
+    const title = (target.title ?? '').toLowerCase();
+    const haystack = `${title} ${url}`;
+    if (!haystack.trim() && !type)
+        return Number.NEGATIVE_INFINITY;
+    if (haystack.includes('devtools'))
+        return Number.NEGATIVE_INFINITY;
+    let score = 0;
+    if (preferredPattern && preferredPattern.test(haystack))
+        score += 1000;
+    if (type === 'app')
+        score += 120;
+    else if (type === 'webview')
+        score += 100;
+    else if (type === 'page')
+        score += 80;
+    else if (type === 'iframe')
+        score += 20;
+    if (url.startsWith('http://localhost') || url.startsWith('https://localhost'))
+        score += 90;
+    if (url.startsWith('file://'))
+        score += 60;
+    if (url.startsWith('http://127.0.0.1') || url.startsWith('https://127.0.0.1'))
+        score += 50;
+    if (url.startsWith('about:blank'))
+        score -= 120;
+    if (url === '' || url === 'about:blank')
+        score -= 40;
+    if (title && title !== 'devtools')
+        score += 25;
+    if (title.includes('antigravity'))
+        score += 120;
+    if (title.includes('codex'))
+        score += 120;
+    if (title.includes('cursor'))
+        score += 120;
+    if (title.includes('chatwise'))
+        score += 120;
+    if (title.includes('notion'))
+        score += 120;
+    if (title.includes('discord'))
+        score += 120;
+    if (title.includes('netease'))
+        score += 120;
+    if (url.includes('antigravity'))
+        score += 100;
+    if (url.includes('codex'))
+        score += 100;
+    if (url.includes('cursor'))
+        score += 100;
+    if (url.includes('chatwise'))
+        score += 100;
+    if (url.includes('notion'))
+        score += 100;
+    if (url.includes('discord'))
+        score += 100;
+    if (url.includes('netease'))
+        score += 100;
+    return score;
+}
+function compilePreferredPattern(raw) {
+    const value = raw?.trim();
+    if (!value)
+        return undefined;
+    return new RegExp(escapeRegExp(value.toLowerCase()));
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export const __test__ = {
+    selectCDPTarget,
+    scoreCDPTarget,
+};

package/dist/browser/index.d.ts

@@ -6,6 +6,7 @@
  */
 export { Page } from './page.js';
 export { BrowserBridge, BrowserBridge as PlaywrightMCP } from './mcp.js';
+export { CDPBridge } from './cdp.js';
 export { isDaemonRunning } from './daemon-client.js';
 import { extractTabEntries, diffTabIndexes, appendLimited } from './tabs.js';
 import { withTimeoutMs } from '../runtime.js';
@@ -14,4 +15,6 @@ export declare const __test__: {
     diffTabIndexes: typeof diffTabIndexes;
     appendLimited: typeof appendLimited;
     withTimeoutMs: typeof withTimeoutMs;
+    selectCDPTarget: (targets: import("./cdp.js").CDPTarget[]) => import("./cdp.js").CDPTarget | undefined;
+    scoreCDPTarget: (target: import("./cdp.js").CDPTarget, preferredPattern?: RegExp) => number;
 };

package/dist/browser/index.js

@@ -6,12 +6,16 @@
  */
 export { Page } from './page.js';
 export { BrowserBridge, BrowserBridge as PlaywrightMCP } from './mcp.js';
+export { CDPBridge } from './cdp.js';
 export { isDaemonRunning } from './daemon-client.js';
 import { extractTabEntries, diffTabIndexes, appendLimited } from './tabs.js';
+import { __test__ as cdpTest } from './cdp.js';
 import { withTimeoutMs } from '../runtime.js';
 export const __test__ = {
     extractTabEntries,
     diffTabIndexes,
     appendLimited,
     withTimeoutMs,
+    selectCDPTarget: cdpTest.selectCDPTarget,
+    scoreCDPTarget: cdpTest.scoreCDPTarget,
 };