@jackwener/opencli 1.5.5 → 1.5.7

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [1.5.7](https://github.com/jackwener/opencli/compare/v1.5.6...v1.5.7) (2026-04-01)
+
+
+### Features
+
+* **daemon:** replace 5min idle timeout with long-lived daemon model (4h default, dual-condition exit) ([#641](https://github.com/jackwener/opencli/issues/641))
+* **daemon:** add `opencli daemon status/stop/restart` CLI commands ([#641](https://github.com/jackwener/opencli/issues/641))
+* **youtube:** add search filters — `--type` shorts/video/channel, `--upload`, `--sort` ([#616](https://github.com/jackwener/opencli/issues/616))
+* **notebooklm:** add read commands and compatibility layer ([#622](https://github.com/jackwener/opencli/issues/622))
+* **instagram:** add media download command ([#623](https://github.com/jackwener/opencli/issues/623))
+* **stealth:** harden CDP debugger detection countermeasures ([#644](https://github.com/jackwener/opencli/issues/644))
+* **v2ex:** add id, node, url, content, member fields to topic output ([#646](https://github.com/jackwener/opencli/issues/646), [#648](https://github.com/jackwener/opencli/issues/648))
+* **electron:** auto-launcher — zero-config CDP connection ([#653](https://github.com/jackwener/opencli/issues/653))
+
+
+### Bug Fixes
+
+* **douyin:** repair creator draft flow — switch from broken API pipeline to UI-driven approach ([#640](https://github.com/jackwener/opencli/issues/640))
+* **douyin:** support current creator API response shapes for activities, profile, collections, hashtag, videos ([#618](https://github.com/jackwener/opencli/issues/618))
+* **bilibili:** distinguish login-gated subtitles from empty results ([#645](https://github.com/jackwener/opencli/issues/645))
+* **facebook:** avoid in-page redirect in search — use navigate step instead of window.location.href ([#642](https://github.com/jackwener/opencli/issues/642))
+* **substack:** update selectors for DOM redesign ([#624](https://github.com/jackwener/opencli/issues/624))
+* **weread:** recover book details from cached shelf fallback ([#628](https://github.com/jackwener/opencli/issues/628))
+* **docs:** use relative links in adapter index ([#629](https://github.com/jackwener/opencli/issues/629))
+
+
 ## [1.4.1](https://github.com/jackwener/opencli/compare/v1.4.0...v1.4.1) (2026-03-25)
 
 

package/README.md

@@ -72,7 +72,8 @@ npm install -g @jackwener/opencli
 ### 3. Verify & Try
 
 ```bash
-opencli doctor   # Check extension + daemon connectivity
+opencli doctor          # Check extension + daemon connectivity
+opencli daemon status   # Check daemon state (PID, uptime, memory)
 ```
 
 **Try it out:**
@@ -117,12 +118,15 @@ git clone git@github.com:jackwener/opencli.git && cd opencli && npm install && n
 
 | Site | Commands |
 |------|----------|
-| **xiaohongshu** | `search` `feed` `user` `download` `publish` `comments` `notifications` `creator-notes` `creator-notes-summary` `creator-note-detail` `creator-profile` `creator-stats` |
+| **xiaohongshu** | `search` `note` `comments` `feed` `user` `download` `publish` `notifications` `creator-notes` `creator-notes-summary` `creator-note-detail` `creator-profile` `creator-stats` |
 | **bilibili** | `hot` `search` `history` `feed` `ranking` `download` `comments` `dynamic` `favorite` `following` `me` `subtitle` `user-videos` |
+| **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` |
+| **spotify** | `auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat` |
 
-65+ adapters in total — **[→ see all supported sites & commands](./docs/adapters/index.md)**
+66+ adapters in total — **[→ see all supported sites & commands](./docs/adapters/index.md)**
 
 ## CLI Hub
 
@@ -133,8 +137,9 @@ OpenCLI acts as a universal hub for your existing command-line tools — unified
 | **gh** | GitHub CLI | `opencli gh pr list --limit 5` |
 | **obsidian** | Obsidian vault management | `opencli obsidian search query="AI"` |
 | **docker** | Docker | `opencli docker ps` |
-| **gws** | Google Workspace CLI | `opencli gws docs list` |
 | **lark-cli** | Lark/Feishu — messages, docs, calendar, tasks, 200+ commands | `opencli lark-cli calendar +agenda` |
+| **dingtalk** | DingTalk — cross-platform CLI for DingTalk's full suite, designed for humans and AI agents | `opencli dingtalk msg send --to user "hello"` |
+| **wecom** | WeCom/企业微信 — CLI for WeCom open platform, for humans and AI agents | `opencli wecom msg send --to user "hello"` |
 | **vercel** | Vercel — deploy projects, manage domains, env vars, logs | `opencli vercel deploy --prod` |
 
 **Register your own** — add any local CLI so AI agents can discover it via `opencli list`:
@@ -192,6 +197,28 @@ opencli bilibili hot -f csv     # Spreadsheet-friendly
 opencli bilibili hot -v         # Verbose: show pipeline debug steps
 ```
 
+## Exit Codes
+
+opencli follows Unix `sysexits.h` conventions so it integrates naturally with shell pipelines and CI scripts:
+
+| Code | Meaning | When |
+|------|---------|------|
+| `0` | Success | Command completed normally |
+| `1` | Generic error | Unexpected / unclassified failure |
+| `2` | Usage error | Bad arguments or unknown command |
+| `66` | Empty result | No data returned (`EX_NOINPUT`) |
+| `69` | Service unavailable | Browser Bridge not connected (`EX_UNAVAILABLE`) |
+| `75` | Temporary failure | Command timed out — retry (`EX_TEMPFAIL`) |
+| `77` | Auth required | Not logged in to target site (`EX_NOPERM`) |
+| `78` | Config error | Missing credentials or bad config (`EX_CONFIG`) |
+| `130` | Interrupted | Ctrl-C / SIGINT |
+
+```bash
+opencli spotify status || echo "exit $?"   # 69 if browser not running
+opencli github issues 2>/dev/null
+[ $? -eq 77 ] && opencli github auth       # auto-auth if not logged in
+```
+
 ## Plugins
 
 Extend OpenCLI with community-contributed adapters:

package/README.zh-CN.md

@@ -73,9 +73,11 @@ OpenCLI 通过轻量化的 **Browser Bridge** Chrome 扩展 + 微型 daemon 与
 
 完成！运行任何 opencli 浏览器命令时，后台微型 daemon 会自动启动与浏览器通信。无需配 API Token，零代码配置。
 
-> **Tip**：后续诊断用 `opencli doctor`：
+> **Tip**：后续诊断和 daemon 管理：
 > ```bash
 > opencli doctor            # 检查扩展和 daemon 连通性
+> opencli daemon status     # 查看 daemon 状态
+> opencli daemon stop       # 停止 daemon
 > ```
 
 ## 快速开始
@@ -122,16 +124,17 @@ 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` `block` `unblock` `hide-reply` | 浏览器 |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 浏览器 |
+| **tieba** | `hot` `posts` `search` `read` | 浏览器 |
 | **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` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export` | 桌面端 |
 | **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` | 桌面端 |
-| **doubao** | `status` `new` `send` `read` `ask` | 浏览器 |
+| **doubao** | `status` `new` `send` `read` `ask` `history` `detail` `meeting-summary` `meeting-transcript` | 浏览器 |
 | **doubao-app** | `status` `new` `send` `read` `ask` `screenshot` `dump` | 桌面端 |
 | **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` | 桌面端 |
 | **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` | 桌面端 |
 | **v2ex** | `hot` `latest` `topic` `node` `user` `member` `replies` `nodes` `daily` `me` `notifications` | 公开 / 浏览器 |
-| **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `watchlist` `earnings-date` `fund-holdings` `fund-snapshot` | 浏览器 |
+| **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `comments` `watchlist` `earnings-date` `fund-holdings` `fund-snapshot` | 浏览器 |
 | **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` | 桌面端 |
 | **chatgpt** | `status` `new` `send` `read` `ask` `model` | 桌面端 |
 | **xiaohongshu** | `search` `notifications` `feed` `user` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | 浏览器 |
@@ -173,6 +176,8 @@ 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` | 公开 |
+| **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` | 浏览器 |
 | **36kr** | `news` `hot` `search` `article` | 公开 / 浏览器 |
 | **imdb** | `search` `title` `top` `trending` `person` `reviews` | 公开 |
 | **producthunt** | `posts` `today` `hot` `browse` | 公开 / 浏览器 |
@@ -183,7 +188,10 @@ npm install -g @jackwener/opencli@latest
 | **substack** | `feed` `search` `publication` | 浏览器 |
 | **pixiv** | `ranking` `search` `user` `illusts` `detail` `download` | 浏览器 |
 | **tiktok** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | 浏览器 |
+| **bluesky** | `search` `trending` `user` `profile` `thread` `feeds` `followers` `following` `starter-packs` | 公开 |
+| **douyin** | `videos` `publish` `drafts` `draft` `delete` `stats` `profile` `update` `hashtag` `location` `activities` `collections` | 浏览器 |
 
+66+ 适配器 — **[→ 查看完整命令列表](./docs/adapters/index.md)**
 
 ### 外部 CLI 枢纽
 
@@ -194,8 +202,10 @@ OpenCLI 也可以作为你现有命令行工具的统一入口，负责发现、
 | **gh** | GitHub CLI | `opencli gh pr list --limit 5` |
 | **obsidian** | Obsidian 仓库管理 | `opencli obsidian search query="AI"` |
 | **docker** | Docker 命令行工具 | `opencli docker ps` |
-| **readwise** | Readwise / Reader CLI | `opencli readwise login` |
-| **gws** | Google Workspace CLI — Docs, Sheets, Drive, Gmail, Calendar | `opencli gws docs list` |
+| **lark-cli** | 飞书 CLI — 消息、文档、日历、任务，200+ 命令 | `opencli lark-cli calendar +agenda` |
+| **dingtalk** | 钉钉 CLI — 钉钉全套产品能力的跨平台命令行工具，支持人类和 AI Agent 使用 | `opencli dingtalk msg send --to user "hello"` |
+| **wecom** | 企业微信 CLI — 企业微信开放平台命令行工具，支持人类和 AI Agent 使用 | `opencli wecom msg send --to user "hello"` |
+| **vercel** | Vercel — 部署项目、管理域名、环境变量、日志 | `opencli vercel deploy --prod` |
 
 **零配置透传**：OpenCLI 会把你的输入原样转发给底层二进制，保留原生 stdout / stderr 行为。
 
@@ -295,6 +305,31 @@ opencli bilibili hot -f csv     # CSV
 opencli bilibili hot -v         # 详细模式：展示管线执行步骤调试信息
 ```
 
+## 退出码
+
+opencli 遵循 Unix `sysexits.h` 惯例，可无缝接入 shell 管道和 CI 脚本：
+
+| 退出码 | 含义 | 触发场景 |
+|--------|------|----------|
+| `0` | 成功 | 命令正常完成 |
+| `1` | 通用错误 | 未分类的意外错误 |
+| `2` | 用法错误 | 参数错误或未知命令 |
+| `66` | 无数据 | 命令返回空结果（`EX_NOINPUT`） |
+| `69` | 服务不可用 | Browser Bridge 未连接（`EX_UNAVAILABLE`） |
+| `75` | 临时失败 | 命令超时，可重试（`EX_TEMPFAIL`） |
+| `77` | 需要认证 | 未登录目标网站（`EX_NOPERM`） |
+| `78` | 配置错误 | 凭证缺失或配置有误（`EX_CONFIG`） |
+| `130` | 中断 | Ctrl-C / SIGINT |
+
+```bash
+opencli bilibili hot 2>/dev/null
+case $? in
+  0)   echo "ok" ;;
+  69)  echo "请先启动 Browser Bridge" ;;
+  77)  echo "请先登录 bilibili.com" ;;
+esac
+```
+
 ## 插件
 
 通过社区贡献的插件扩展 OpenCLI。插件使用与内置命令相同的 YAML/TS 格式，启动时自动发现。

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."
-version: 1.4.1
+version: 1.5.6
 author: jackwener
 tags: [cli, browser, web, chrome-extension, cdp, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, youtube, boss, coupang, yollomi, AI, agent]
 ---

package/dist/browser/cdp.d.ts

@@ -23,6 +23,7 @@ export declare class CDPBridge implements IBrowserFactory {
     connect(opts?: {
         timeout?: number;
         workspace?: string;
+        cdpEndpoint?: string;
     }): Promise<IPage>;
     close(): Promise<void>;
     send(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;

package/dist/browser/cdp.js

@@ -15,6 +15,7 @@ import { generateSnapshotJs, scrollToRefJs, getFormStateJs } from './dom-snapsho
 import { generateStealthJs } from './stealth.js';
 import { clickJs, typeTextJs, pressKeyJs, waitForTextJs, scrollJs, autoScrollJs, networkRequestsJs, waitForDomStableJs, waitForCaptureJs, waitForSelectorJs, } from './dom-helpers.js';
 import { isRecord, saveBase64ToFile } from '../utils.js';
+import { getAllElectronApps } from '../electron-apps.js';
 const CDP_SEND_TIMEOUT = 30_000;
 export class CDPBridge {
     _ws = null;
@@ -24,9 +25,9 @@ export class CDPBridge {
     async connect(opts) {
         if (this._ws)
             throw new Error('CDPBridge is already connected. Call close() before reconnecting.');
-        const endpoint = process.env.OPENCLI_CDP_ENDPOINT;
+        const endpoint = opts?.cdpEndpoint ?? process.env.OPENCLI_CDP_ENDPOINT;
         if (!endpoint)
-            throw new Error('OPENCLI_CDP_ENDPOINT is not set');
+            throw new Error('CDP endpoint not provided (pass cdpEndpoint or set OPENCLI_CDP_ENDPOINT)');
         let wsUrl = endpoint;
         if (endpoint.startsWith('http')) {
             const targets = await fetchJsonDirect(`${endpoint.replace(/\/$/, '')}/json`);
@@ -269,7 +270,19 @@ class CDPPage {
         return [];
     }
     async getCurrentUrl() {
-        return this._lastUrl;
+        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');
@@ -346,30 +359,20 @@ function scoreCDPTarget(target, preferredPattern) {
         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 (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;
+    // Boost score for known Electron app names from the registry (builtin + user-defined)
+    const appNames = Object.values(getAllElectronApps()).map(a => (a.displayName ?? a.processName).toLowerCase());
+    for (const name of appNames) {
+        if (title.includes(name)) {
+            score += 120;
+            break;
+        }
+    }
+    for (const name of appNames) {
+        if (url.includes(name)) {
+            score += 100;
+            break;
+        }
+    }
     return score;
 }
 function compilePreferredPattern(raw) {

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';
+    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window' | 'sessions' | 'set-file-input' | 'bind-current';
     tabId?: number;
     code?: string;
     workspace?: string;
@@ -14,9 +14,15 @@ export interface DaemonCommand {
     op?: string;
     index?: number;
     domain?: string;
+    matchDomain?: string;
+    matchPathPrefix?: string;
     format?: 'png' | 'jpeg';
     quality?: number;
     fullPage?: boolean;
+    /** Local file paths for set-file-input action */
+    files?: string[];
+    /** CSS selector for file input element (set-file-input action) */
+    selector?: string;
 }
 export interface DaemonResult {
     id: string;
@@ -39,3 +45,7 @@ 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

@@ -105,3 +105,6 @@ 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/dom-helpers.js

@@ -103,6 +103,7 @@ export function scrollJs(direction, amount) {
 export function autoScrollJs(times, delayMs) {
     return `
     (async () => {
+      if (!document.body) return;
       for (let i = 0; i < ${times}; i++) {
         const lastHeight = document.body.scrollHeight;
         window.scrollTo(0, lastHeight);

package/dist/browser/dom-helpers.test.js

@@ -1,5 +1,18 @@
 import { describe, it, expect } from 'vitest';
-import { waitForCaptureJs, waitForSelectorJs } from './dom-helpers.js';
+import { autoScrollJs, waitForCaptureJs, waitForSelectorJs } from './dom-helpers.js';
+describe('autoScrollJs', () => {
+    it('returns early without error when document.body is null', async () => {
+        const g = globalThis;
+        const origDoc = g.document;
+        g.document = { body: null, documentElement: {} };
+        g.window = g;
+        const code = autoScrollJs(3, 500);
+        // Should resolve without throwing
+        await expect(eval(code)).resolves.not.toThrow();
+        g.document = origDoc;
+        delete g.window;
+    });
+});
 describe('waitForCaptureJs', () => {
     it('returns a non-empty string', () => {
         const code = waitForCaptureJs(1000);

package/dist/browser/mcp.js

@@ -50,29 +50,36 @@ export class BrowserBridge {
         this._state = 'closed';
     }
     async _ensureDaemon(timeoutSeconds) {
-        // Use default if not provided, zero, or negative
         const effectiveSeconds = (timeoutSeconds && timeoutSeconds > 0) ? timeoutSeconds : Math.ceil(DAEMON_SPAWN_TIMEOUT / 1000);
         const timeoutMs = effectiveSeconds * 1000;
+        // Fast path: extension already connected
         if (await isExtensionConnected())
             return;
+        // Daemon running but no extension — wait for extension with progress
         if (await isDaemonRunning()) {
+            if (process.env.OPENCLI_VERBOSE || process.stderr.isTTY) {
+                process.stderr.write('⏳ Waiting for Chrome extension to connect...\n');
+                process.stderr.write('   Make sure Chrome is open and the OpenCLI extension is enabled.\n');
+            }
+            const deadline = Date.now() + timeoutMs;
+            while (Date.now() < deadline) {
+                await new Promise(resolve => setTimeout(resolve, 200));
+                if (await isExtensionConnected())
+                    return;
+            }
             throw new Error('Daemon is running but the Browser Extension is not connected.\n' +
                 'Please install and enable the opencli Browser Bridge extension in Chrome.');
         }
-        // Find daemon relative to this file — works for both:
-        //   npx tsx src/main.ts  → src/browser/mcp.ts  → src/daemon.ts
-        //   node dist/main.js    → dist/browser/mcp.js → dist/daemon.js
+        // No daemon — spawn one
         const __dirname = path.dirname(fileURLToPath(import.meta.url));
         const parentDir = path.resolve(__dirname, '..');
         const daemonTs = path.join(parentDir, 'daemon.ts');
         const daemonJs = path.join(parentDir, 'daemon.js');
         const isTs = fs.existsSync(daemonTs);
         const daemonPath = isTs ? daemonTs : daemonJs;
-        if (process.env.OPENCLI_VERBOSE) {
-            console.error(`[opencli] Starting daemon (${isTs ? 'ts' : 'js'})...`);
+        if (process.env.OPENCLI_VERBOSE || process.stderr.isTTY) {
+            process.stderr.write('⏳ Starting daemon...\n');
         }
-        // For compiled .js, use the current node binary directly (fast).
-        // For .ts dev mode, node can't run .ts files — use tsx via --import.
         const spawnArgs = isTs
             ? [process.execPath, '--import', 'tsx/esm', daemonPath]
             : [process.execPath, daemonPath];
@@ -82,15 +89,13 @@ export class BrowserBridge {
             env: { ...process.env },
         });
         this._daemonProc.unref();
-        // Wait for daemon to be ready AND extension to connect (exponential backoff)
-        const backoffs = [50, 100, 200, 400, 800, 1500, 3000];
+        // Wait for daemon + extension with faster polling
         const deadline = Date.now() + timeoutMs;
-        for (let i = 0; Date.now() < deadline; i++) {
-            await new Promise(resolve => setTimeout(resolve, backoffs[Math.min(i, backoffs.length - 1)]));
+        while (Date.now() < deadline) {
+            await new Promise(resolve => setTimeout(resolve, 200));
             if (await isExtensionConnected())
                 return;
         }
-        // Daemon might be up but extension not connected — give a useful error
         if (await isDaemonRunning()) {
             throw new Error('Daemon is running but the Browser Extension is not connected.\n' +
                 'Please install and enable the opencli Browser Bridge extension in Chrome.');

package/dist/browser/page.d.ts

@@ -72,5 +72,11 @@ export declare class Page implements IPage {
     }): Promise<void>;
     installInterceptor(pattern: string): Promise<void>;
     getInterceptedRequests(): Promise<unknown[]>;
+    /**
+     * Set local file paths on a file input element via CDP DOM.setFileInputFiles.
+     * Chrome reads the files directly from the local filesystem, avoiding the
+     * payload size limits of base64-in-evaluate.
+     */
+    setFileInput(files: string[], selector?: string): Promise<void>;
     waitForCapture(timeout?: number): Promise<void>;
 }

package/dist/browser/page.js

@@ -96,7 +96,19 @@ export class Page {
         }
     }
     async getCurrentUrl() {
-        return this._lastUrl;
+        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: some commands may run before a debuggable tab is ready.
+        }
+        return null;
     }
     /** Close the automation window in the extension */
     async closeWindow() {
@@ -109,7 +121,15 @@ export class Page {
     }
     async evaluate(js) {
         const code = wrapForEval(js);
-        return sendCommand('exec', { code, ...this._cmdOpts() });
+        try {
+            return await sendCommand('exec', { code, ...this._cmdOpts() });
+        }
+        catch (err) {
+            if (!isRetryableSettleError(err))
+                throw err;
+            await new Promise((resolve) => setTimeout(resolve, 200));
+            return sendCommand('exec', { code, ...this._cmdOpts() });
+        }
     }
     async getCookies(opts = {}) {
         const result = await sendCommand('cookies', { ...this._wsOpt(), ...opts });
@@ -308,6 +328,21 @@ export class Page {
         const result = await this.evaluate(generateReadInterceptedJs('__opencli_xhr'));
         return Array.isArray(result) ? result : [];
     }
+    /**
+     * Set local file paths on a file input element via CDP DOM.setFileInputFiles.
+     * Chrome reads the files directly from the local filesystem, avoiding the
+     * payload size limits of base64-in-evaluate.
+     */
+    async setFileInput(files, selector) {
+        const result = await sendCommand('set-file-input', {
+            files,
+            selector,
+            ...this._cmdOpts(),
+        });
+        if (!result?.count) {
+            throw new Error('setFileInput returned no count — command may not be supported by the extension');
+        }
+    }
     async waitForCapture(timeout = 10) {
         const maxMs = timeout * 1000;
         await sendCommand('exec', {

package/dist/browser/page.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/browser/page.test.js

@@ -0,0 +1,44 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { sendCommandMock } = vi.hoisted(() => ({
+    sendCommandMock: vi.fn(),
+}));
+vi.mock('./daemon-client.js', () => ({
+    sendCommand: sendCommandMock,
+}));
+import { Page } from './page.js';
+describe('Page.getCurrentUrl', () => {
+    beforeEach(() => {
+        sendCommandMock.mockReset();
+    });
+    it('reads the real browser URL when no local navigation cache exists', async () => {
+        sendCommandMock.mockResolvedValueOnce('https://notebooklm.google.com/notebook/nb-live');
+        const page = new Page('site:notebooklm');
+        const url = await page.getCurrentUrl();
+        expect(url).toBe('https://notebooklm.google.com/notebook/nb-live');
+        expect(sendCommandMock).toHaveBeenCalledTimes(1);
+        expect(sendCommandMock).toHaveBeenCalledWith('exec', expect.objectContaining({
+            workspace: 'site:notebooklm',
+        }));
+    });
+    it('caches the discovered browser URL for later reads', async () => {
+        sendCommandMock.mockResolvedValueOnce('https://notebooklm.google.com/notebook/nb-live');
+        const page = new Page('site:notebooklm');
+        expect(await page.getCurrentUrl()).toBe('https://notebooklm.google.com/notebook/nb-live');
+        expect(await page.getCurrentUrl()).toBe('https://notebooklm.google.com/notebook/nb-live');
+        expect(sendCommandMock).toHaveBeenCalledTimes(1);
+    });
+});
+describe('Page.evaluate', () => {
+    beforeEach(() => {
+        sendCommandMock.mockReset();
+    });
+    it('retries once when the inspected target navigated during exec', async () => {
+        sendCommandMock
+            .mockRejectedValueOnce(new Error('{"code":-32000,"message":"Inspected target navigated or closed"}'))
+            .mockResolvedValueOnce(42);
+        const page = new Page('site:notebooklm');
+        const value = await page.evaluate('21 + 21');
+        expect(value).toBe(42);
+        expect(sendCommandMock).toHaveBeenCalledTimes(2);
+    });
+});