@jackwener/opencli 1.0.3 → 1.0.4

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

@@ -21,10 +21,28 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 20
+          cache: 'npm'
+          cache-dependency-path: extension/package-lock.json
+
+      - name: Install extension dependencies
+        run: npm ci
+        working-directory: extension
+
+      - name: Build extension
+        run: npm run build
+        working-directory: extension
+
+      - name: Prepare extension package
+        run: |
+          rm -rf extension-package
+          mkdir -p extension-package
+          cp extension/manifest.json extension-package/
+          cp -R extension/dist extension-package/
+          cp -R extension/icons extension-package/
 
       - name: Create Extension ZIP
         run: |
-          cd extension
+          cd extension-package
           zip -r ../opencli-extension.zip .
 
       - name: Create Extension CRX
@@ -33,11 +51,11 @@ jobs:
           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
+            crx3 pack extension-package -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
+            crx3 pack extension-package -o opencli-extension.crx
           fi
 
       - name: Upload Artifacts (Action Run)

package/.github/workflows/docs.yml

@@ -0,0 +1,52 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths: ['docs/**']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build docs
+        run: npm run docs:build
+
+      - uses: actions/configure-pages@v4
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/README.md

@@ -115,34 +115,34 @@ Run `opencli list` for the live registry.
 
 | Site | Commands | Mode |
 |------|----------|------|
-| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` | 🔐 Browser |
-| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 🔐 Browser |
-| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | 🖥️ Desktop |
-| **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 🔐 Browser |
-| **codex** | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` | 🖥️ Desktop |
-| **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` | 🖥️ Desktop |
-| **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` | 🖥️ Desktop |
-| **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` `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 |
-| **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | 🌐 Public |
-| **zhihu** | `hot` `search` `question` `download` | 🔐 Browser |
-| **youtube** | `search` `video` `transcript` | 🔐 Browser |
-| **boss** | `search` `detail` | 🔐 Browser |
-| **coupang** | `search` `add-to-cart` | 🔐 Browser |
-| **bbc** | `news` | 🌐 Public |
-| **ctrip** | `search` | 🔐 Browser |
-| **github** | `search` | 🌐 Public |
-| **hackernews** | `top` | 🌐 Public |
-| **linkedin** | `search` | 🔐 Browser |
-| **reuters** | `search` | 🔐 Browser |
-| **smzdm** | `search` | 🔐 Browser |
-| **weibo** | `hot` | 🔐 Browser |
-| **yahoo-finance** | `quote` | 🔐 Browser |
+| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` | Browser |
+| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | Browser |
+| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | Desktop |
+| **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | Browser |
+| **codex** | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` | Desktop |
+| **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` | Desktop |
+| **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` | Desktop |
+| **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` | Desktop |
+| **v2ex** | `hot` `latest` `topic` `daily` `me` `notifications` | Public / Browser |
+| **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `watchlist` | Browser |
+| **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 |
+| **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | Public |
+| **zhihu** | `hot` `search` `question` `download` | Browser |
+| **youtube** | `search` `video` `transcript` | Browser |
+| **boss** | `search` `detail` | Browser |
+| **coupang** | `search` `add-to-cart` | Browser |
+| **bbc** | `news` | Public |
+| **ctrip** | `search` | Browser |
+| **github** | `search` | Public |
+| **hackernews** | `top` | Public |
+| **linkedin** | `search` | Browser |
+| **reuters** | `search` | Browser |
+| **smzdm** | `search` | Browser |
+| **weibo** | `hot` | Browser |
+| **yahoo-finance** | `quote` | Browser |
 
 ### Desktop App Adapters
 

package/README.zh-CN.md

@@ -116,34 +116,34 @@ npm install -g @jackwener/opencli@latest
 
 | 站点 | 命令 | 模式 |
 |------|------|------|
-| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` | 🔐 浏览器 |
-| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 🔐 浏览器 |
-| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | 🖥️ 桌面端 |
-| **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 🔐 浏览器 |
-| **codex** | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` | 🖥️ 桌面端 |
-| **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` | 🖥️ 桌面端 |
-| **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` | 🖥️ 桌面端 |
-| **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` `dump` `extract-code` `model` `watch` | 🖥️ 桌面端 |
-| **chatgpt** | `status` `new` `send` `read` `ask` | 🖥️ 桌面端 |
-| **xiaohongshu** | `search` `notifications` `feed` `me` `user` `download` | 🔐 浏览器 |
-| **apple-podcasts** | `search` `episodes` `top` | 🌐 公开 |
-| **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | 🌐 公开 |
-| **zhihu** | `hot` `search` `question` `download` | 🔐 浏览器 |
-| **youtube** | `search` `video` `transcript` | 🔐 浏览器 |
-| **boss** | `search` `detail` | 🔐 浏览器 |
-| **coupang** | `search` `add-to-cart` | 🔐 浏览器 |
-| **bbc** | `news` | 🌐 公共 API |
-| **ctrip** | `search` | 🔐 浏览器 |
-| **github** | `search` | 🌐 公共 API |
-| **hackernews** | `top` | 🌐 公共 API |
-| **linkedin** | `search` | 🔐 浏览器 |
-| **reuters** | `search` | 🔐 浏览器 |
-| **smzdm** | `search` | 🔐 浏览器 |
-| **weibo** | `hot` | 🔐 浏览器 |
-| **yahoo-finance** | `quote` | 🔐 浏览器 |
+| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` | 浏览器 |
+| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 浏览器 |
+| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | 桌面端 |
+| **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 浏览器 |
+| **codex** | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` | 桌面端 |
+| **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` | 桌面端 |
+| **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` | 桌面端 |
+| **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` `dump` `extract-code` `model` `watch` | 桌面端 |
+| **chatgpt** | `status` `new` `send` `read` `ask` | 桌面端 |
+| **xiaohongshu** | `search` `notifications` `feed` `me` `user` `download` | 浏览器 |
+| **apple-podcasts** | `search` `episodes` `top` | 公开 |
+| **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | 公开 |
+| **zhihu** | `hot` `search` `question` `download` | 浏览器 |
+| **youtube** | `search` `video` `transcript` | 浏览器 |
+| **boss** | `search` `detail` | 浏览器 |
+| **coupang** | `search` `add-to-cart` | 浏览器 |
+| **bbc** | `news` | 公共 API |
+| **ctrip** | `search` | 浏览器 |
+| **github** | `search` | 公共 API |
+| **hackernews** | `top` | 公共 API |
+| **linkedin** | `search` | 浏览器 |
+| **reuters** | `search` | 浏览器 |
+| **smzdm** | `search` | 浏览器 |
+| **weibo** | `hot` | 浏览器 |
+| **yahoo-finance** | `quote` | 浏览器 |
 
 ### 桌面应用适配器
 

package/dist/browser/cdp.d.ts

@@ -1,5 +1,11 @@
 /**
  * CDP client — implements IPage by connecting directly to a Chrome/Electron CDP WebSocket.
+ *
+ * Fixes applied:
+ * - send() now has a 30s timeout guard (P0 #4)
+ * - goto() waits for Page.loadEventFired instead of hardcoded 1s sleep (P1 #3)
+ * - Implemented scroll, autoScroll, screenshot, networkRequests (P1 #2)
+ * - Shared DOM helper methods extracted to reduce duplication with Page (P1 #5)
  */
 import type { IPage } from '../types.js';
 export interface CDPTarget {
@@ -12,11 +18,20 @@ export declare class CDPBridge {
     private _ws;
     private _idCounter;
     private _pending;
+    private _eventListeners;
     connect(opts?: {
         timeout?: number;
+        workspace?: string;
     }): Promise<IPage>;
     close(): Promise<void>;
-    send(method: string, params?: any): Promise<any>;
+    /** Send a CDP command with timeout guard (P0 fix #4) */
+    send(method: string, params?: any, timeoutMs?: number): Promise<any>;
+    /** Listen for a CDP event */
+    on(event: string, handler: (params: any) => void): void;
+    /** Remove a CDP event listener */
+    off(event: string, handler: (params: any) => void): void;
+    /** Wait for a CDP event to fire (one-shot) */
+    waitForEvent(event: string, timeoutMs?: number): Promise<any>;
 }
 declare function selectCDPTarget(targets: CDPTarget[]): CDPTarget | undefined;
 declare function scoreCDPTarget(target: CDPTarget, preferredPattern?: RegExp): number;

package/dist/browser/cdp.js

@@ -1,12 +1,21 @@
 /**
  * CDP client — implements IPage by connecting directly to a Chrome/Electron CDP WebSocket.
+ *
+ * Fixes applied:
+ * - send() now has a 30s timeout guard (P0 #4)
+ * - goto() waits for Page.loadEventFired instead of hardcoded 1s sleep (P1 #3)
+ * - Implemented scroll, autoScroll, screenshot, networkRequests (P1 #2)
+ * - Shared DOM helper methods extracted to reduce duplication with Page (P1 #5)
  */
 import { WebSocket } from 'ws';
 import { wrapForEval } from './utils.js';
+import { clickJs, typeTextJs, pressKeyJs, waitForTextJs, scrollJs, autoScrollJs, networkRequestsJs, } from './dom-helpers.js';
+const CDP_SEND_TIMEOUT = 30_000; // 30s per command
 export class CDPBridge {
     _ws = null;
     _idCounter = 0;
     _pending = new Map();
+    _eventListeners = new Map();
     async connect(opts) {
         const endpoint = process.env.OPENCLI_CDP_ENDPOINT;
         if (!endpoint)
@@ -39,18 +48,28 @@ export class CDPBridge {
             ws.on('message', (data) => {
                 try {
                     const msg = JSON.parse(data.toString());
+                    // Handle command responses
                     if (msg.id && this._pending.has(msg.id)) {
-                        const { resolve, reject } = this._pending.get(msg.id);
+                        const entry = this._pending.get(msg.id);
+                        clearTimeout(entry.timer);
                         this._pending.delete(msg.id);
                         if (msg.error) {
-                            reject(new Error(msg.error.message));
+                            entry.reject(new Error(msg.error.message));
                         }
                         else {
-                            resolve(msg.result);
+                            entry.resolve(msg.result);
+                        }
+                    }
+                    // Handle CDP events
+                    if (msg.method) {
+                        const listeners = this._eventListeners.get(msg.method);
+                        if (listeners) {
+                            for (const fn of listeners)
+                                fn(msg.params);
                         }
                     }
                 }
-                catch (e) {
+                catch {
                     // ignore parsing errors
                 }
             });
@@ -62,29 +81,68 @@ export class CDPBridge {
             this._ws = null;
         }
         for (const p of this._pending.values()) {
+            clearTimeout(p.timer);
             p.reject(new Error('CDP connection closed'));
         }
         this._pending.clear();
+        this._eventListeners.clear();
     }
-    async send(method, params = {}) {
+    /** Send a CDP command with timeout guard (P0 fix #4) */
+    async send(method, params = {}, timeoutMs = CDP_SEND_TIMEOUT) {
         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 });
+            const timer = setTimeout(() => {
+                this._pending.delete(id);
+                reject(new Error(`CDP command '${method}' timed out after ${timeoutMs / 1000}s`));
+            }, timeoutMs);
+            this._pending.set(id, { resolve, reject, timer });
             this._ws.send(JSON.stringify({ id, method, params }));
         });
     }
+    /** Listen for a CDP event */
+    on(event, handler) {
+        let set = this._eventListeners.get(event);
+        if (!set) {
+            set = new Set();
+            this._eventListeners.set(event, set);
+        }
+        set.add(handler);
+    }
+    /** Remove a CDP event listener */
+    off(event, handler) {
+        this._eventListeners.get(event)?.delete(handler);
+    }
+    /** Wait for a CDP event to fire (one-shot) */
+    waitForEvent(event, timeoutMs = 15_000) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.off(event, handler);
+                reject(new Error(`Timed out waiting for CDP event '${event}'`));
+            }, timeoutMs);
+            const handler = (params) => {
+                clearTimeout(timer);
+                this.off(event, handler);
+                resolve(params);
+            };
+            this.on(event, handler);
+        });
+    }
 }
 class CDPPage {
     bridge;
     constructor(bridge) {
         this.bridge = bridge;
     }
+    /** Navigate with proper load event waiting (P1 fix #3) */
     async goto(url) {
+        await this.bridge.send('Page.enable');
+        const loadPromise = this.bridge.waitForEvent('Page.loadEventFired', 30_000)
+            .catch(() => { }); // Don't fail if event times out
         await this.bridge.send('Page.navigate', { url });
-        await new Promise(r => setTimeout(r, 1000));
+        await loadPromise;
     }
     async evaluate(js) {
         const expression = wrapForEval(js);
@@ -98,52 +156,26 @@ class CDPPage {
         }
         return result.result?.value;
     }
-    async snapshot(opts) {
-        throw new Error('Method not implemented.');
+    async getCookies(opts = {}) {
+        const result = await this.bridge.send('Network.getCookies', opts.url ? { urls: [opts.url] } : {});
+        const cookies = Array.isArray(result?.cookies) ? result.cookies : [];
+        return opts.domain
+            ? cookies.filter((cookie) => typeof cookie.domain === 'string' && cookie.domain.includes(opts.domain))
+            : cookies;
     }
+    async snapshot(_opts) {
+        // CDP doesn't have a built-in accessibility tree equivalent without additional setup
+        return '(snapshot not available in CDP mode)';
+    }
+    // ── Shared DOM operations (P1 fix #5 — using dom-helpers.ts) ──
     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);
+        await this.evaluate(clickJs(ref));
     }
     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);
+        await this.evaluate(typeTextJs(ref, text));
     }
     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);
+        await this.evaluate(pressKeyJs(key));
     }
     async wait(options) {
         if (typeof options === 'number') {
@@ -156,54 +188,66 @@ class CDPPage {
         }
         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);
+            await this.evaluate(waitForTextJs(options.text, timeout));
         }
     }
-    async tabs() {
-        throw new Error('Method not implemented.');
+    // ── Implemented methods (P1 fix #2) ──
+    async scroll(direction = 'down', amount = 500) {
+        await this.evaluate(scrollJs(direction, amount));
     }
-    async closeTab(index) {
-        throw new Error('Method not implemented.');
+    async autoScroll(options) {
+        const times = options?.times ?? 3;
+        const delayMs = options?.delayMs ?? 2000;
+        await this.evaluate(autoScrollJs(times, delayMs));
     }
-    async newTab() {
-        throw new Error('Method not implemented.');
+    async screenshot(options = {}) {
+        const result = await this.bridge.send('Page.captureScreenshot', {
+            format: options.format ?? 'png',
+            quality: options.format === 'jpeg' ? (options.quality ?? 80) : undefined,
+            captureBeyondViewport: options.fullPage ?? false,
+        });
+        const base64 = result.data;
+        if (options.path) {
+            const fs = await import('node:fs');
+            const path = await import('node:path');
+            const dir = path.dirname(options.path);
+            await fs.promises.mkdir(dir, { recursive: true });
+            await fs.promises.writeFile(options.path, Buffer.from(base64, 'base64'));
+        }
+        return base64;
     }
-    async selectTab(index) {
-        throw new Error('Method not implemented.');
+    async networkRequests(includeStatic = false) {
+        return this.evaluate(networkRequestsJs(includeStatic));
     }
-    async networkRequests(includeStatic) {
-        throw new Error('Method not implemented.');
+    async tabs() {
+        return [];
     }
-    async consoleMessages(level) {
-        throw new Error('Method not implemented.');
+    async closeTab(_index) {
+        // Not supported in direct CDP mode
     }
-    async scroll(direction, amount) {
-        throw new Error('Method not implemented.');
+    async newTab() {
+        await this.bridge.send('Target.createTarget', { url: 'about:blank' });
     }
-    async autoScroll(options) {
-        throw new Error('Method not implemented.');
+    async selectTab(_index) {
+        // Not supported in direct CDP mode
+    }
+    async consoleMessages(_level) {
+        return [];
     }
     async installInterceptor(pattern) {
-        throw new Error('Method not implemented.');
+        const { generateInterceptorJs } = await import('../interceptor.js');
+        await this.evaluate(generateInterceptorJs(JSON.stringify(pattern), {
+            arrayName: '__opencli_xhr',
+            patchGuard: '__opencli_interceptor_patched',
+        }));
     }
     async getInterceptedRequests() {
-        throw new Error('Method not implemented.');
-    }
-    async screenshot(options) {
-        throw new Error('Method not implemented.');
+        const { generateReadInterceptedJs } = await import('../interceptor.js');
+        const result = await this.evaluate(generateReadInterceptedJs('__opencli_xhr'));
+        return result || [];
     }
 }
+// ── CDP target selection (unchanged) ──
 function selectCDPTarget(targets) {
     const preferredPattern = compilePreferredPattern(process.env.OPENCLI_CDP_TARGET);
     const ranked = targets

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

@@ -5,9 +5,10 @@
  */
 export interface DaemonCommand {
     id: string;
-    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window';
+    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window' | 'sessions';
     tabId?: number;
     code?: string;
+    workspace?: string;
     url?: string;
     op?: string;
     index?: number;
@@ -35,3 +36,4 @@ export declare function isExtensionConnected(): Promise<boolean>;
  * Retries up to 3 times with 500ms delay for transient failures.
  */
 export declare function sendCommand(action: DaemonCommand['action'], params?: Omit<DaemonCommand, 'id' | 'action'>): Promise<unknown>;
+export declare function listSessions(): Promise<any[]>;

package/dist/browser/daemon-client.js

@@ -80,3 +80,7 @@ export async function sendCommand(action, params = {}) {
     // Unreachable — the loop always returns or throws
     throw new Error('sendCommand: max retries exhausted');
 }
+export async function listSessions() {
+    const result = await sendCommand('sessions');
+    return Array.isArray(result) ? result : [];
+}

package/dist/browser/dom-helpers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared DOM operation JS generators.
+ *
+ * Used by both Page (daemon mode) and CDPPage (direct CDP mode)
+ * to eliminate code duplication for click, type, press, wait, scroll, etc.
+ */
+/** Generate JS to click an element by ref */
+export declare function clickJs(ref: string): string;
+/** Generate JS to type text into an element by ref */
+export declare function typeTextJs(ref: string, text: string): string;
+/** Generate JS to press a keyboard key */
+export declare function pressKeyJs(key: string): string;
+/** Generate JS to wait for text to appear in the page */
+export declare function waitForTextJs(text: string, timeoutMs: number): string;
+/** Generate JS for scroll */
+export declare function scrollJs(direction: string, amount: number): string;
+/** Generate JS for auto-scroll with lazy-load detection */
+export declare function autoScrollJs(times: number, delayMs: number): string;
+/** Generate JS to read performance resource entries as network requests */
+export declare function networkRequestsJs(includeStatic: boolean): string;