@jackwener/opencli 1.5.7 → 1.5.9

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [1.5.9](https://github.com/jackwener/opencli/compare/v1.5.8...v1.5.9) (2026-04-02)
+
+
+### Features
+
+* **amazon:** add browser adapter — bestsellers, search, product, offer, discussion ([#659](https://github.com/jackwener/opencli/issues/659))
+* **skills:** create skills/ directory structure with opencli-usage, opencli-explorer, opencli-oneshot ([#670](https://github.com/jackwener/opencli/issues/670))
+* **record:** add minimal record write candidates ([#665](https://github.com/jackwener/opencli/issues/665))
+
+
+### Refactoring
+
+* src cleanup — deduplicate errors, cache VM, extract BasePage, remove Playwright MCP legacy ([#667](https://github.com/jackwener/opencli/issues/667))
+* remove bind-current, restore owned-only browser automation model ([#664](https://github.com/jackwener/opencli/issues/664))
+
+
+### Chores
+
+* remove .agents directory ([#668](https://github.com/jackwener/opencli/issues/668))
+
+
+## [1.5.8](https://github.com/jackwener/opencli/compare/v1.5.7...v1.5.8) (2026-04-01)
+
+
+### Bug Fixes
+
+* **extension:** avoid mutating healthy tabs before debugger attach and add regression coverage ([#662](https://github.com/jackwener/opencli/issues/662))
+
+
 ## [1.5.7](https://github.com/jackwener/opencli/compare/v1.5.6...v1.5.7) (2026-04-01)
 
 

package/README.md

@@ -90,6 +90,20 @@ opencli bilibili hot --limit 5         # Browser command (requires Extension)
 npm install -g @jackwener/opencli@latest
 ```
 
+### Install AI Skills
+
+OpenCLI provides [skills](./skills/) for AI agents (Claude Code, etc.):
+
+```bash
+# Install all OpenCLI skills
+npx skills add jackwener/opencli
+
+# Or install specific skills
+npx skills add jackwener/opencli --skill opencli-usage      # Command reference
+npx skills add jackwener/opencli --skill opencli-explorer    # Adapter development guide
+npx skills add jackwener/opencli --skill opencli-oneshot     # Quick command reference
+```
+
 ---
 
 ### For Developers
@@ -123,7 +137,9 @@ git clone git@github.com:jackwener/opencli.git && cd opencli && npm install && n
 | **tieba** | `hot` `posts` `search` `read` |
 | **twitter** | `trending` `search` `timeline` `bookmarks` `post` `download` `profile` `article` `like` `likes` `notifications` `reply` `reply-dm` `thread` `follow` `unfollow` `followers` `following` `block` `unblock` `bookmark` `unbookmark` `delete` `hide-reply` `accept` |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `user` `user-posts` `user-comments` `read` `save` `saved` `subscribe` `upvote` `upvoted` `comment` |
-| **notebooklm** | `status` `list` `current` `get` `metadata` `bind-current` `use` `source-list` `source-get` `source-fulltext` `source-guide` `history` `note-list` `notes-list` `notes-get` `summary` |
+| **amazon** | `bestsellers` `search` `product` `offer` `discussion` |
+| **gemini** | `new` `ask` `image` |
+| **notebooklm** | `status` `list` `open` `select` `current` `get` `metadata` `source-list` `source-get` `source-fulltext` `source-guide` `history` `note-list` `notes-list` `notes-get` `summary` |
 | **spotify** | `auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat` |
 
 66+ adapters in total — **[→ see all supported sites & commands](./docs/adapters/index.md)**

package/README.zh-CN.md

@@ -116,6 +116,20 @@ opencli list  # 可以在任何地方使用了！
 npm install -g @jackwener/opencli@latest
 ```
 
+### 安装 AI Skills
+
+OpenCLI 提供 [skills](./skills/) 供 AI Agent（Claude Code 等）使用：
+
+```bash
+# 安装所有 OpenCLI skills
+npx skills add jackwener/opencli
+
+# 或安装特定 skill
+npx skills add jackwener/opencli --skill opencli-usage      # 命令参考
+npx skills add jackwener/opencli --skill opencli-explorer    # 适配器开发指南
+npx skills add jackwener/opencli --skill opencli-oneshot     # 快速命令参考
+```
+
 ## 内置命令
 
 运行 `opencli list` 查看完整注册表。
@@ -176,8 +190,10 @@ npm install -g @jackwener/opencli@latest
 | **douban** | `search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot` | 浏览器 |
 | **facebook** | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` | 浏览器 |
 | **google** | `news` `search` `suggest` `trends` | 公开 |
+| **amazon** | `bestsellers` `search` `product` `offer` `discussion` | 浏览器 |
+| **gemini** | `new` `ask` `image` | 浏览器 |
 | **spotify** | `auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat` | OAuth API |
-| **notebooklm** | `status` `list` `current` `get` `metadata` `bind-current` `use` `source-list` `source-get` `source-fulltext` `source-guide` `history` `note-list` `notes-list` `notes-get` `summary` | 浏览器 |
+| **notebooklm** | `status` `list` `open` `select` `current` `get` `metadata` `source-list` `source-get` `source-fulltext` `source-guide` `history` `note-list` `notes-list` `notes-get` `summary` | 浏览器 |
 | **36kr** | `news` `hot` `search` `article` | 公开 / 浏览器 |
 | **imdb** | `search` `title` `top` `trending` `person` `reviews` | 公开 |
 | **producthunt** | `posts` `today` `hot` `browse` | 公开 / 浏览器 |

package/dist/browser/base-page.d.ts

@@ -0,0 +1,48 @@
+/**
+ * BasePage — shared IPage method implementations for DOM helpers.
+ *
+ * Both Page (daemon-backed) and CDPPage (direct CDP) execute JS the same way
+ * for DOM operations. This base class deduplicates ~200 lines of identical
+ * click/type/scroll/wait/snapshot/interceptor methods.
+ *
+ * Subclasses implement the transport-specific methods: goto, evaluate,
+ * getCookies, screenshot, tabs, etc.
+ */
+import type { BrowserCookie, IPage, ScreenshotOptions, SnapshotOptions, WaitOptions } from '../types.js';
+export declare abstract class BasePage implements IPage {
+    protected _lastUrl: string | null;
+    abstract goto(url: string, options?: {
+        waitUntil?: 'load' | 'none';
+        settleMs?: number;
+    }): Promise<void>;
+    abstract evaluate(js: string): Promise<unknown>;
+    abstract getCookies(opts?: {
+        domain?: string;
+        url?: string;
+    }): Promise<BrowserCookie[]>;
+    abstract screenshot(options?: ScreenshotOptions): Promise<string>;
+    abstract tabs(): Promise<unknown[]>;
+    abstract closeTab(index?: number): Promise<void>;
+    abstract newTab(): Promise<void>;
+    abstract selectTab(index: number): Promise<void>;
+    click(ref: string): Promise<void>;
+    typeText(ref: string, text: string): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    scrollTo(ref: string): Promise<unknown>;
+    getFormState(): Promise<Record<string, unknown>>;
+    scroll(direction?: string, amount?: number): Promise<void>;
+    autoScroll(options?: {
+        times?: number;
+        delayMs?: number;
+    }): Promise<void>;
+    networkRequests(includeStatic?: boolean): Promise<unknown[]>;
+    consoleMessages(_level?: string): Promise<unknown[]>;
+    wait(options: number | WaitOptions): Promise<void>;
+    snapshot(opts?: SnapshotOptions): Promise<unknown>;
+    getCurrentUrl(): Promise<string | null>;
+    installInterceptor(pattern: string): Promise<void>;
+    getInterceptedRequests(): Promise<unknown[]>;
+    waitForCapture(timeout?: number): Promise<void>;
+    /** Fallback basic snapshot */
+    protected _basicSnapshot(opts?: Pick<SnapshotOptions, 'interactive' | 'compact' | 'maxDepth' | 'raw'>): Promise<unknown>;
+}

package/dist/browser/base-page.js

@@ -0,0 +1,160 @@
+/**
+ * BasePage — shared IPage method implementations for DOM helpers.
+ *
+ * Both Page (daemon-backed) and CDPPage (direct CDP) execute JS the same way
+ * for DOM operations. This base class deduplicates ~200 lines of identical
+ * click/type/scroll/wait/snapshot/interceptor methods.
+ *
+ * Subclasses implement the transport-specific methods: goto, evaluate,
+ * getCookies, screenshot, tabs, etc.
+ */
+import { generateSnapshotJs, scrollToRefJs, getFormStateJs } from './dom-snapshot.js';
+import { clickJs, typeTextJs, pressKeyJs, waitForTextJs, waitForCaptureJs, waitForSelectorJs, scrollJs, autoScrollJs, networkRequestsJs, waitForDomStableJs, } from './dom-helpers.js';
+import { formatSnapshot } from '../snapshotFormatter.js';
+export class BasePage {
+    _lastUrl = null;
+    // ── Shared DOM helper implementations ──
+    async click(ref) {
+        await this.evaluate(clickJs(ref));
+    }
+    async typeText(ref, text) {
+        await this.evaluate(typeTextJs(ref, text));
+    }
+    async pressKey(key) {
+        await this.evaluate(pressKeyJs(key));
+    }
+    async scrollTo(ref) {
+        return this.evaluate(scrollToRefJs(ref));
+    }
+    async getFormState() {
+        return (await this.evaluate(getFormStateJs()));
+    }
+    async scroll(direction = 'down', amount = 500) {
+        await this.evaluate(scrollJs(direction, amount));
+    }
+    async autoScroll(options) {
+        const times = options?.times ?? 3;
+        const delayMs = options?.delayMs ?? 2000;
+        await this.evaluate(autoScrollJs(times, delayMs));
+    }
+    async networkRequests(includeStatic = false) {
+        const result = await this.evaluate(networkRequestsJs(includeStatic));
+        return Array.isArray(result) ? result : [];
+    }
+    async consoleMessages(_level = 'info') {
+        return [];
+    }
+    async wait(options) {
+        if (typeof options === 'number') {
+            if (options >= 1) {
+                try {
+                    const maxMs = options * 1000;
+                    await this.evaluate(waitForDomStableJs(maxMs, Math.min(500, maxMs)));
+                    return;
+                }
+                catch {
+                    // Fallback: fixed sleep
+                }
+            }
+            await new Promise(resolve => setTimeout(resolve, options * 1000));
+            return;
+        }
+        if (typeof options.time === 'number') {
+            await new Promise(resolve => setTimeout(resolve, options.time * 1000));
+            return;
+        }
+        if (options.selector) {
+            const timeout = (options.timeout ?? 10) * 1000;
+            await this.evaluate(waitForSelectorJs(options.selector, timeout));
+            return;
+        }
+        if (options.text) {
+            const timeout = (options.timeout ?? 30) * 1000;
+            await this.evaluate(waitForTextJs(options.text, timeout));
+        }
+    }
+    async snapshot(opts = {}) {
+        const snapshotJs = generateSnapshotJs({
+            viewportExpand: opts.viewportExpand ?? 800,
+            maxDepth: Math.max(1, Math.min(Number(opts.maxDepth) || 50, 200)),
+            interactiveOnly: opts.interactive ?? false,
+            maxTextLength: opts.maxTextLength ?? 120,
+            includeScrollInfo: true,
+            bboxDedup: true,
+        });
+        try {
+            return await this.evaluate(snapshotJs);
+        }
+        catch {
+            return this._basicSnapshot(opts);
+        }
+    }
+    async getCurrentUrl() {
+        if (this._lastUrl)
+            return this._lastUrl;
+        try {
+            const current = await this.evaluate('window.location.href');
+            if (typeof current === 'string' && current) {
+                this._lastUrl = current;
+                return current;
+            }
+        }
+        catch {
+            // Best-effort
+        }
+        return null;
+    }
+    async installInterceptor(pattern) {
+        const { generateInterceptorJs } = await import('../interceptor.js');
+        await this.evaluate(generateInterceptorJs(JSON.stringify(pattern), {
+            arrayName: '__opencli_xhr',
+            patchGuard: '__opencli_interceptor_patched',
+        }));
+    }
+    async getInterceptedRequests() {
+        const { generateReadInterceptedJs } = await import('../interceptor.js');
+        const result = await this.evaluate(generateReadInterceptedJs('__opencli_xhr'));
+        return Array.isArray(result) ? result : [];
+    }
+    async waitForCapture(timeout = 10) {
+        const maxMs = timeout * 1000;
+        await this.evaluate(waitForCaptureJs(maxMs));
+    }
+    /** Fallback basic snapshot */
+    async _basicSnapshot(opts = {}) {
+        const maxDepth = Math.max(1, Math.min(Number(opts.maxDepth) || 50, 200));
+        const code = `
+      (async () => {
+        function buildTree(node, depth) {
+          if (depth > ${maxDepth}) return '';
+          const role = node.getAttribute?.('role') || node.tagName?.toLowerCase() || 'generic';
+          const name = node.getAttribute?.('aria-label') || node.getAttribute?.('alt') || node.textContent?.trim().slice(0, 80) || '';
+          const isInteractive = ['a', 'button', 'input', 'select', 'textarea'].includes(node.tagName?.toLowerCase()) || node.getAttribute?.('tabindex') != null;
+
+          ${opts.interactive ? 'if (!isInteractive && !node.children?.length) return "";' : ''}
+
+          let indent = '  '.repeat(depth);
+          let line = indent + role;
+          if (name) line += ' "' + name.replace(/"/g, '\\\\\\"') + '"';
+          if (node.tagName?.toLowerCase() === 'a' && node.href) line += ' [' + node.href + ']';
+          if (node.tagName?.toLowerCase() === 'input') line += ' [' + (node.type || 'text') + ']';
+
+          let result = line + '\\n';
+          if (node.children) {
+            for (const child of node.children) {
+              result += buildTree(child, depth + 1);
+            }
+          }
+          return result;
+        }
+        return buildTree(document.body, 0);
+      })()
+    `;
+        const raw = await this.evaluate(code);
+        if (opts.raw)
+            return raw;
+        if (typeof raw === 'string')
+            return formatSnapshot(raw, opts);
+        return raw;
+    }
+}

package/dist/browser/cdp.js

@@ -11,11 +11,11 @@ import { WebSocket } from 'ws';
 import { request as httpRequest } from 'node:http';
 import { request as httpsRequest } from 'node:https';
 import { wrapForEval } from './utils.js';
-import { generateSnapshotJs, scrollToRefJs, getFormStateJs } from './dom-snapshot.js';
 import { generateStealthJs } from './stealth.js';
-import { clickJs, typeTextJs, pressKeyJs, waitForTextJs, scrollJs, autoScrollJs, networkRequestsJs, waitForDomStableJs, waitForCaptureJs, waitForSelectorJs, } from './dom-helpers.js';
+import { waitForDomStableJs } from './dom-helpers.js';
 import { isRecord, saveBase64ToFile } from '../utils.js';
 import { getAllElectronApps } from '../electron-apps.js';
+import { BasePage } from './base-page.js';
 const CDP_SEND_TIMEOUT = 30_000;
 export class CDPBridge {
     _ws = null;
@@ -133,11 +133,11 @@ export class CDPBridge {
         });
     }
 }
-class CDPPage {
+class CDPPage extends BasePage {
     bridge;
     _pageEnabled = false;
-    _lastUrl = null;
     constructor(bridge) {
+        super();
         this.bridge = bridge;
     }
     async goto(url, options) {
@@ -174,70 +174,6 @@ class CDPPage {
             ? cookies.filter((cookie) => isCookie(cookie) && matchesCookieDomain(cookie.domain, domain))
             : cookies;
     }
-    async snapshot(opts = {}) {
-        const snapshotJs = generateSnapshotJs({
-            viewportExpand: opts.viewportExpand ?? 800,
-            maxDepth: Math.max(1, Math.min(Number(opts.maxDepth) || 50, 200)),
-            interactiveOnly: opts.interactive ?? false,
-            maxTextLength: opts.maxTextLength ?? 120,
-            includeScrollInfo: true,
-            bboxDedup: true,
-        });
-        return this.evaluate(snapshotJs);
-    }
-    async click(ref) {
-        await this.evaluate(clickJs(ref));
-    }
-    async typeText(ref, text) {
-        await this.evaluate(typeTextJs(ref, text));
-    }
-    async pressKey(key) {
-        await this.evaluate(pressKeyJs(key));
-    }
-    async scrollTo(ref) {
-        return this.evaluate(scrollToRefJs(ref));
-    }
-    async getFormState() {
-        return (await this.evaluate(getFormStateJs()));
-    }
-    async wait(options) {
-        if (typeof options === 'number') {
-            if (options >= 1) {
-                try {
-                    const maxMs = options * 1000;
-                    await this.evaluate(waitForDomStableJs(maxMs, Math.min(500, maxMs)));
-                    return;
-                }
-                catch {
-                    // Fallback: fixed sleep
-                }
-            }
-            await new Promise((resolve) => setTimeout(resolve, options * 1000));
-            return;
-        }
-        if (typeof options.time === 'number') {
-            const waitTime = options.time;
-            await new Promise((resolve) => setTimeout(resolve, waitTime * 1000));
-            return;
-        }
-        if (options.selector) {
-            const timeout = (options.timeout ?? 10) * 1000;
-            await this.evaluate(waitForSelectorJs(options.selector, timeout));
-            return;
-        }
-        if (options.text) {
-            const timeout = (options.timeout ?? 30) * 1000;
-            await this.evaluate(waitForTextJs(options.text, timeout));
-        }
-    }
-    async scroll(direction = 'down', amount = 500) {
-        await this.evaluate(scrollJs(direction, amount));
-    }
-    async autoScroll(options) {
-        const times = options?.times ?? 3;
-        const delayMs = options?.delayMs ?? 2000;
-        await this.evaluate(autoScrollJs(times, delayMs));
-    }
     async screenshot(options = {}) {
         const result = await this.bridge.send('Page.captureScreenshot', {
             format: options.format ?? 'png',
@@ -250,10 +186,6 @@ class CDPPage {
         }
         return base64;
     }
-    async networkRequests(includeStatic = false) {
-        const result = await this.evaluate(networkRequestsJs(includeStatic));
-        return Array.isArray(result) ? result : [];
-    }
     async tabs() {
         return [];
     }
@@ -266,40 +198,6 @@ class CDPPage {
     async selectTab(_index) {
         // Not supported in direct CDP mode
     }
-    async consoleMessages(_level) {
-        return [];
-    }
-    async getCurrentUrl() {
-        if (this._lastUrl)
-            return this._lastUrl;
-        try {
-            const current = await this.evaluate('window.location.href');
-            if (typeof current === 'string' && current) {
-                this._lastUrl = current;
-                return current;
-            }
-        }
-        catch {
-            // Best-effort: direct CDP sessions may not have a ready page yet.
-        }
-        return null;
-    }
-    async installInterceptor(pattern) {
-        const { generateInterceptorJs } = await import('../interceptor.js');
-        await this.evaluate(generateInterceptorJs(JSON.stringify(pattern), {
-            arrayName: '__opencli_xhr',
-            patchGuard: '__opencli_interceptor_patched',
-        }));
-    }
-    async getInterceptedRequests() {
-        const { generateReadInterceptedJs } = await import('../interceptor.js');
-        const result = await this.evaluate(generateReadInterceptedJs('__opencli_xhr'));
-        return Array.isArray(result) ? result : [];
-    }
-    async waitForCapture(timeout = 10) {
-        const maxMs = timeout * 1000;
-        await this.evaluate(waitForCaptureJs(maxMs));
-    }
 }
 function isCookie(value) {
     return isRecord(value)

package/dist/browser/daemon-client.d.ts

@@ -6,7 +6,7 @@
 import type { BrowserSessionInfo } from '../types.js';
 export interface DaemonCommand {
     id: string;
-    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window' | 'sessions' | 'set-file-input' | 'bind-current';
+    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window' | 'sessions' | 'set-file-input';
     tabId?: number;
     code?: string;
     workspace?: string;
@@ -14,8 +14,6 @@ export interface DaemonCommand {
     op?: string;
     index?: number;
     domain?: string;
-    matchDomain?: string;
-    matchPathPrefix?: string;
     format?: 'png' | 'jpeg';
     quality?: number;
     fullPage?: boolean;
@@ -45,7 +43,3 @@ export declare function isExtensionConnected(): Promise<boolean>;
  */
 export declare function sendCommand(action: DaemonCommand['action'], params?: Omit<DaemonCommand, 'id' | 'action'>): Promise<unknown>;
 export declare function listSessions(): Promise<BrowserSessionInfo[]>;
-export declare function bindCurrentTab(workspace: string, opts?: {
-    matchDomain?: string;
-    matchPathPrefix?: string;
-}): Promise<unknown>;

package/dist/browser/daemon-client.js

@@ -5,6 +5,7 @@
  */
 import { DEFAULT_DAEMON_PORT } from '../constants.js';
 import { sleep } from '../utils.js';
+import { isTransientBrowserError } from './errors.js';
 const DAEMON_PORT = parseInt(process.env.OPENCLI_DAEMON_PORT ?? String(DEFAULT_DAEMON_PORT), 10);
 const DAEMON_URL = `http://127.0.0.1:${DAEMON_PORT}`;
 let _idCounter = 0;
@@ -74,12 +75,7 @@ export async function sendCommand(action, params = {}) {
             const result = (await res.json());
             if (!result.ok) {
                 // Check if error is a transient extension issue worth retrying
-                const errMsg = result.error ?? '';
-                const isTransient = errMsg.includes('Extension disconnected')
-                    || errMsg.includes('Extension not connected')
-                    || errMsg.includes('attach failed')
-                    || errMsg.includes('no longer exists');
-                if (isTransient && attempt < maxRetries) {
+                if (isTransientBrowserError(new Error(result.error ?? '')) && attempt < maxRetries) {
                     // Longer delay for extension recovery (service worker restart)
                     await sleep(1500);
                     continue;
@@ -105,6 +101,3 @@ export async function listSessions() {
     const result = await sendCommand('sessions');
     return Array.isArray(result) ? result : [];
 }
-export async function bindCurrentTab(workspace, opts = {}) {
-    return sendCommand('bind-current', { workspace, ...opts });
-}

package/dist/browser/discover.d.ts

@@ -1,8 +1,5 @@
 /**
- * Daemon discovery — simplified from MCP server path discovery.
- *
- * Only needs to check if the daemon is running. No more file system
- * scanning for @playwright/mcp locations.
+ * Daemon discovery — checks if the daemon is running.
  */
 import { isDaemonRunning } from './daemon-client.js';
 export { isDaemonRunning };

package/dist/browser/discover.js

@@ -1,8 +1,5 @@
 /**
- * Daemon discovery — simplified from MCP server path discovery.
- *
- * Only needs to check if the daemon is running. No more file system
- * scanning for @playwright/mcp locations.
+ * Daemon discovery — checks if the daemon is running.
  */
 import { DEFAULT_DAEMON_PORT } from '../constants.js';
 import { isDaemonRunning } from './daemon-client.js';

package/dist/browser/errors.d.ts

@@ -5,5 +5,9 @@
  * The daemon architecture has a single failure mode: daemon not reachable or extension not connected.
  */
 import { BrowserConnectError, type BrowserConnectKind } from '../errors.js';
+/**
+ * Check if an error message indicates a transient browser error worth retrying.
+ */
+export declare function isTransientBrowserError(err: unknown): boolean;
 export type ConnectFailureKind = BrowserConnectKind;
 export declare function formatBrowserConnectError(kind: ConnectFailureKind, detail?: string): BrowserConnectError;

package/dist/browser/errors.js

@@ -6,6 +6,26 @@
  */
 import { BrowserConnectError } from '../errors.js';
 import { DEFAULT_DAEMON_PORT } from '../constants.js';
+/**
+ * Transient browser error patterns — shared across daemon-client, pipeline executor,
+ * and page retry logic. These errors indicate temporary conditions (extension restart,
+ * service worker cycle, tab navigation) that are worth retrying.
+ */
+const TRANSIENT_ERROR_PATTERNS = [
+    'Extension disconnected',
+    'Extension not connected',
+    'attach failed',
+    'no longer exists',
+    'CDP connection',
+    'Daemon command failed',
+];
+/**
+ * Check if an error message indicates a transient browser error worth retrying.
+ */
+export function isTransientBrowserError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return TRANSIENT_ERROR_PATTERNS.some(pattern => msg.includes(pattern));
+}
 export function formatBrowserConnectError(kind, detail) {
     switch (kind) {
         case 'daemon-not-running':

package/dist/browser/index.d.ts

@@ -5,7 +5,7 @@
  * External code should import from './browser/index.js' (or './browser.js' via Node resolution).
  */
 export { Page } from './page.js';
-export { BrowserBridge } from './mcp.js';
+export { BrowserBridge } from './bridge.js';
 export { CDPBridge } from './cdp.js';
 export { isDaemonRunning } from './daemon-client.js';
 export { generateSnapshotJs, scrollToRefJs, getFormStateJs } from './dom-snapshot.js';

package/dist/browser/index.js

@@ -5,7 +5,7 @@
  * External code should import from './browser/index.js' (or './browser.js' via Node resolution).
  */
 export { Page } from './page.js';
-export { BrowserBridge } from './mcp.js';
+export { BrowserBridge } from './bridge.js';
 export { CDPBridge } from './cdp.js';
 export { isDaemonRunning } from './daemon-client.js';
 export { generateSnapshotJs, scrollToRefJs, getFormStateJs } from './dom-snapshot.js';