@jackwener/opencli 0.9.6 → 1.0.0

package/README.zh-CN.md

@@ -1,7 +1,7 @@
 # OpenCLI
 
 > **把任何网站或 Electron 应用变成你的命令行工具。**  
-> 零风控 · 复用 Chrome 登录 · AI 自动发现接口 · 80+ 命令 · 19 站点
+> 零风控 · 复用 Chrome 登录 · AI 自动发现接口 · 浏览器与桌面端自动化
 
 [English](./README.md)
 
@@ -9,7 +9,7 @@
 [![Node.js Version](https://img.shields.io/node/v/@jackwener/opencli?style=flat-square)](https://nodejs.org)
 [![License](https://img.shields.io/npm/l/@jackwener/opencli?style=flat-square)](./LICENSE)
 
-OpenCLI 将任何网站或 Electron 应用（如 Antigravity）变成命令行工具 — B站、知乎、小红书、Twitter/X、Reddit、YouTube 等 [19 个站点](#内置命令) — 复用浏览器登录态，AI 驱动探索。
+OpenCLI 将任何网站或 Electron 应用（如 Antigravity）变成命令行工具 — B站、知乎、小红书、Twitter/X、Reddit、YouTube 等[多种站点与应用](#内置命令) — 复用浏览器登录态，AI 驱动探索。
 
 🔥 **opencli 支持 CLI 化所有 electron 应用！最强大更新来袭！** 🔥
 CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合出各种神奇的能力。
@@ -24,6 +24,7 @@ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合
 - [前置要求](#前置要求)
 - [快速开始](#快速开始)
 - [内置命令](#内置命令)
+- [下载支持](#下载支持)
 - [输出格式](#输出格式)
 - [致 AI Agent（开发者指南）](#致-ai-agent开发者指南)
 - [远程 Chrome（服务器/无头环境）](#远程-chrome服务器无头环境)
@@ -36,7 +37,7 @@ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合
 ## 亮点
 
 - **CLI All Electron** — 支持把所有 electron 应用（如 Antigravity Ultra）CLI 化，让 AI 控制自己！
-- **多站点覆盖** — B站、知乎、小红书、Twitter、Reddit 等 19 个站点，80+ 命令
+- **多站点覆盖** — 覆盖 B站、知乎、小红书、Twitter、Reddit，以及多种桌面应用
 - **零风控** — 复用 Chrome 登录态，无需存储任何凭证
 - **自修复配置** — `opencli setup` 自动发现 Token；`opencli doctor` 诊断 10+ 工具配置；`--fix` 一键修复
 - **AI 原生** — `explore` 自动发现 API，`synthesize` 生成适配器，`cascade` 探测认证策略
@@ -44,74 +45,32 @@ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合
 
 ## 前置要求
 
-- **Node.js**: >= 18.0.0
+- **Node.js**: >= 20.0.0
 - **Chrome** 浏览器正在运行，且**已登录目标网站**（如 bilibili.com、zhihu.com、xiaohongshu.com）
 
 > **⚠️ 重要**：大多数命令复用你的 Chrome 登录状态。运行命令前，你必须已在 Chrome 中打开目标网站并完成登录。如果获取到空数据或报错，请先检查你的浏览器登录状态。
 
-OpenCLI 通过 Playwright MCP Bridge 扩展与你的浏览器通信。
-它会优先复用本地或全局已安装的 `@playwright/mcp`，如果没有嗅探到可用 MCP server，则会自动回退到 `npx -y @playwright/mcp@latest` 启动。
+OpenCLI 通过轻量化的 **Browser Bridge** Chrome 扩展 + 微型 daemon 与浏览器通信（零配置，自动启动）。
 
-### Playwright MCP Bridge 扩展配置
+### Browser Bridge 扩展配置
 
-1. 安装 **[Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm)** 扩展
-2. 运行 `opencli setup` — 自动发现 Token、分发到各工具、验证连通性：
+1. 在 Chrome 中安装 **opencli Browser Bridge** 扩展：
+   - 打开 `chrome://extensions`，启用右上角的 **开发者模式**
+   - 点击 **加载已解压的扩展程序**，选择本仓库的 `extension/` 文件夹
+2. 完成！运行任何浏览器命令时 daemon 会自动启动。无需 token，无需手动配置。
 
-```bash
-opencli setup
-```
-
-交互式 TUI 会：
-- 🔍 从 Chrome 自动发现 `PLAYWRIGHT_MCP_EXTENSION_TOKEN`（无需手动复制）
-- ☑️ 显示所有支持的工具（Codex、Cursor、Claude Code、Gemini CLI 等）
-- ✏️ 只更新你选中的文件（空格切换，回车确认）
-- 🔌 完成后自动验证浏览器连通性
-
-> **Tip**：后续诊断和维护用 `opencli doctor`：
+> **Tip**：后续诊断用 `opencli doctor`：
 > ```bash
-> opencli doctor            # 只读 Token 与配置诊断
-> opencli doctor --live     # 额外测试浏览器连通性
-> opencli doctor --fix      # 修复不一致的配置（交互确认）
-> opencli doctor --fix -y   # 无交互直接修复所有配置
+> opencli doctor            # 检查扩展和 daemon 连通性
+> opencli doctor --live     # 额外测试浏览器命令
 > ```
 
-**备选方案：CDP 模式 (适用于服务器/无头环境)**
-如果你无法安装浏览器扩展（比如在远程无头服务器上运行 OpenCLI），你可以通过 SSH 隧道或反向代理，利用 CDP (Chrome DevTools Protocol) 连接到本地的 Chrome 浏览器。详细指南请参考 [CDP 连接教程](./CDP.zh-CN.md)。
-
-<details>
-<summary>手动配置（备选方案）</summary>
-
-配置你的 MCP 客户端（如 Claude/Cursor 等）：
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": ["-y", "@playwright/mcp@latest", "--extension"],
-      "env": {
-        "PLAYWRIGHT_MCP_EXTENSION_TOKEN": "<你的-token>"
-      }
-    }
-  }
-}
-```
-
-在终端环境变量中导出（建议写进 `~/.zshrc`）：
-
-```bash
-export PLAYWRIGHT_MCP_EXTENSION_TOKEN="<你的-token>"
-```
-
-</details>
-
 ## 快速开始
 
 ### npm 全局安装（推荐）
 
 ```bash
 npm install -g @jackwener/opencli
-opencli setup   # 首次使用：配置 Playwright MCP token
 ```
 
 直接使用：
@@ -144,34 +103,99 @@ npm install -g @jackwener/opencli@latest
 
 ## 内置命令
 
-**26 个站点 · 128 命令** — 运行 `opencli list` 查看完整注册表。
-
-| 站点 | 命令 | 数量 | 模式 |
-|------|------|:----:|------|
-| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` | 18 | 🔐 浏览器 |
-| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 15 | 🔐 浏览器 |
-| **antigravity** | `status` `send` `read` `new` `evaluate` | 5 | 🖥️ 桌面端 |
-| **chatgpt** | `status` `new` `send` `read` `ask` | 5 | 🖥️ 桌面端 |
-| **codex** | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` | 10 | 🖥️ 桌面端 |
-| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | 12 | 🖥️ 桌面端 |
-| **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` | 11 | 🔐 浏览器 |
-| **v2ex** | `hot` `latest` `topic` `daily` `me` `notifications` | 6 | 🌐 / 🔐 |
-| **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `watchlist` | 6 | 🔐 浏览器 |
-| **xiaohongshu** | `search` `notifications` `feed` `me` `user` | 5 | 🔐 浏览器 |
-| **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | 3 | 🌐 公开 |
-| **youtube** | `search` `video` `transcript` | 3 | 🔐 浏览器 |
-| **zhihu** | `hot` `search` `question` | 3 | 🔐 浏览器 |
-| **boss** | `search` `detail` | 2 | 🔐 浏览器 |
-| **coupang** | `search` `add-to-cart` | 2 | 🔐 浏览器 |
-| **bbc** | `news` | 1 | 🌐 公共 API |
-| **ctrip** | `search` | 1 | 🔐 浏览器 |
-| **github** | `search` | 1 | 🌐 公共 API |
-| **hackernews** | `top` | 1 | 🌐 公共 API |
-| **linkedin** | `search` | 1 | 🔐 浏览器 |
-| **reuters** | `search` | 1 | 🔐 浏览器 |
-| **smzdm** | `search` | 1 | 🔐 浏览器 |
-| **weibo** | `hot` | 1 | 🔐 浏览器 |
-| **yahoo-finance** | `quote` | 1 | 🔐 浏览器 |
+运行 `opencli list` 查看完整注册表。
+
+| 站点 | 命令 | 模式 |
+|------|------|------|
+| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` | 🔐 浏览器 |
+| **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` `evaluate` | 🖥️ 桌面端 |
+| **chatgpt** | `status` `new` `send` `read` `ask` | 🖥️ 桌面端 |
+| **xiaohongshu** | `search` `notifications` `feed` `me` `user` `download` | 🔐 浏览器 |
+| **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` | 🔐 浏览器 |
+
+## 下载支持
+
+OpenCLI 支持从各平台下载图片、视频和文章。
+
+### 支持的平台
+
+| 平台 | 内容类型 | 说明 |
+|------|----------|------|
+| **小红书** | 图片、视频 | 下载笔记中的所有媒体文件 |
+| **B站** | 视频 | 需要安装 `yt-dlp` |
+| **Twitter/X** | 图片、视频 | 从用户媒体页或单条推文下载 |
+| **知乎** | 文章（Markdown） | 导出文章，可选下载图片到本地 |
+
+### 前置依赖
+
+下载流媒体平台的视频需要安装 `yt-dlp`：
+
+```bash
+# 安装 yt-dlp
+pip install yt-dlp
+# 或者
+brew install yt-dlp
+```
+
+### 使用示例
+
+```bash
+# 下载小红书笔记中的图片/视频
+opencli xiaohongshu download --note-id abc123 --output ./xhs
+
+# 下载B站视频（需要 yt-dlp）
+opencli bilibili download --bvid BV1xxx --output ./bilibili
+opencli bilibili download --bvid BV1xxx --quality 1080p  # 指定画质
+
+# 下载 Twitter 用户的媒体
+opencli twitter download --username elonmusk --limit 20 --output ./twitter
+
+# 下载单条推文的媒体
+opencli twitter download --tweet-url "https://x.com/user/status/123" --output ./twitter
+
+# 导出知乎文章为 Markdown
+opencli zhihu download --url "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
+
+# 导出文章并下载图片到本地
+opencli zhihu download --url "https://zhuanlan.zhihu.com/p/xxx" --download-images
+```
+
+### Pipeline Step（用于 YAML 适配器）
+
+`download` step 可以在 YAML 管线中使用：
+
+```yaml
+pipeline:
+  - fetch: https://api.example.com/media
+  - download:
+      url: ${{ item.imageUrl }}
+      dir: ./downloads
+      filename: ${{ item.title | sanitize }}.jpg
+      concurrency: 5
+      skip_existing: true
+```
 
 ## 输出格式
 
@@ -214,16 +238,15 @@ opencli cascade https://api.example.com/data
 
 ## 常见问题排查
 
-- **"Failed to connect to Playwright MCP Bridge"** 报错
-  - 确保你当前的 Chrome 已安装且**开启了** Playwright MCP Bridge 浏览器插件。
-  - 如果是刚装完插件，需要重启 Chrome 浏览器。
+- **"Extension not connected" 报错**
+  - 确保你当前的 Chrome 已安装且**开启了** opencli Browser Bridge 扩展（在 `chrome://extensions` 中检查）。
 - **返回空数据，或者报错 "Unauthorized"**
-  - Chrome 里的登录态可能已经过期（甚至被要求过滑动验证码）。请打开当前 Chrome 页面，在新标签页重新手工登录或刷新该页面。
+  - Chrome 里的登录态可能已经过期。请打开当前 Chrome 页面，在新标签页重新手工登录或刷新该页面。
 - **Node API 错误 (如 parseArgs, fs 等)**
-  - 确保 Node.js 版本 `>= 18`。旧版不支持我们使用的现代核心库 API。
-- **Token 问题**
-  - 运行 `opencli doctor` 诊断所有工具的 Token 配置状态。
-  - 使用 `opencli doctor --live` 测试浏览器连通性。
+  - 确保 Node.js 版本 `>= 20`。
+- **Daemon 问题**
+  - 检查 daemon 状态：`curl localhost:19825/status`
+  - 查看扩展日志：`curl localhost:19825/logs`
 
 ## 版本发布
 

package/SKILL.md

@@ -3,7 +3,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
 author: jackwener
-tags: [cli, browser, web, mcp, playwright, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, youtube, boss, coupang, AI, agent]
+tags: [cli, browser, web, chrome-extension, cdp, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, youtube, boss, coupang, AI, agent]
 ---
 
 # OpenCLI
@@ -12,7 +12,7 @@ tags: [cli, browser, web, mcp, playwright, bilibili, zhihu, twitter, github, v2e
 
 > [!CAUTION]
 > **AI Agent 必读：创建或修改任何适配器之前，你必须先阅读 [CLI-EXPLORER.md](./CLI-EXPLORER.md)！**
-> 该文档包含完整的 API 发现工作流（必须使用 Playwright MCP Bridge 浏览器探索）、5 级认证策略决策树、平台 SDK 速查表、`tap` 步骤调试流程、分页 API 模板、级联请求模式、以及常见陷阱。
+> 该文档包含完整的 API 发现工作流（必须使用浏览器探索）、5 级认证策略决策树、平台 SDK 速查表、`tap` 步骤调试流程、分页 API 模板、级联请求模式、以及常见陷阱。
 > **本文件（SKILL.md）仅提供命令参考和简化模板，不足以正确开发适配器。**
 
 ## Install & Run
@@ -34,8 +34,8 @@ npm update -g @jackwener/opencli
 
 Browser commands require:
 1. Chrome browser running **(logged into target sites)**
-2. [Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm) extension installed
-3. Run `opencli setup` to auto-discover token and configure all tools
+2. **opencli Browser Bridge** Chrome extension installed (load `extension/` as unpacked in `chrome://extensions`)
+3. No further setup needed — the daemon auto-starts on first browser command
 
 > **Note**: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards.
 
@@ -227,7 +227,7 @@ opencli bilibili hot -v         # Show each pipeline step and data flow
 
 > [!IMPORTANT]
 > **完整模式 — 在写任何代码之前，先阅读 [CLI-EXPLORER.md](./CLI-EXPLORER.md)。**
-> 它包含：① AI Agent 浏览器探索工作流（必须用 Playwright MCP 抓包验证 API）② 认证策略决策树 ③ 平台 SDK（如 Bilibili 的 `apiGet`/`fetchJson`）④ YAML vs TS 选择指南 ⑤ `tap` 步骤调试方法 ⑥ 级联请求模板 ⑦ 常见陷阱表。
+> 它包含：① AI Agent 浏览器探索工作流 ② 认证策略决策树 ③ 平台 SDK（如 Bilibili 的 `apiGet`/`fetchJson`）④ YAML vs TS 选择指南 ⑤ `tap` 步骤调试方法 ⑥ 级联请求模板 ⑦ 常见陷阱表。
 > **下方仅为简化模板参考，直接使用极易踩坑。**
 
 ### YAML Pipeline (declarative, recommended)
@@ -374,16 +374,18 @@ ${{ index + 1 }}
 
 | Variable | Default | Description |
 |----------|---------|-------------|
+| `OPENCLI_DAEMON_PORT` | 19825 | Daemon listen port |
 | `OPENCLI_BROWSER_CONNECT_TIMEOUT` | 30 | Browser connection timeout (sec) |
 | `OPENCLI_BROWSER_COMMAND_TIMEOUT` | 45 | Command execution timeout (sec) |
 | `OPENCLI_BROWSER_EXPLORE_TIMEOUT` | 120 | Explore timeout (sec) |
-| `PLAYWRIGHT_MCP_EXTENSION_TOKEN` | — | Auto-approve extension connection |
+| `OPENCLI_VERBOSE` | — | Show daemon/extension logs |
 
 ## Troubleshooting
 
 | Issue | Solution |
 |-------|----------|
 | `npx not found` | Install Node.js: `brew install node` |
-| `Timed out connecting to browser` | 1) Chrome must be open 2) Install MCP Bridge extension and configure token |
+| `Extension not connected` | 1) Chrome must be open 2) Install opencli Browser Bridge extension |
 | `Target page context` error | Add `navigate:` step before `evaluate:` in YAML |
-| Empty table data | Check if evaluate returns JSON string (MCP parsing) or data path is wrong |
+| Empty table data | Check if evaluate returns correct data path |
+| Daemon issues | `curl localhost:19825/status` to check, `curl localhost:19825/logs` for extension logs |

package/TESTING.md

@@ -105,10 +105,10 @@ npx vitest src/
 
 ### 浏览器命令本地测试须知
 
-- 无 `PLAYWRIGHT_MCP_EXTENSION_TOKEN` 时，opencli 自动启动一个独立浏览器实例
+- opencli 通过 Browser Bridge 扩展连接已运行的 Chrome 浏览器
 - `browser-public.test.ts` 使用 `tryBrowserCommand()`，站点反爬导致空数据时 warn + pass
 - `browser-auth.test.ts` 验证 **graceful failure**（不 crash 不 hang 即通过）
-- 如需测试完整登录态，保持 Chrome 登录态 + 设置 `PLAYWRIGHT_MCP_EXTENSION_TOKEN`，手动跑对应测试
+- 如需测试完整登录态，保持 Chrome 登录态并安装 Browser Bridge 扩展，手动跑对应测试
 
 ---
 
@@ -202,12 +202,12 @@ steps:
 
 ## 浏览器模式
 
-opencli 根据 `PLAYWRIGHT_MCP_EXTENSION_TOKEN` 环境变量自动选择模式：
+opencli 通过 Browser Bridge 扩展连接浏览器：
 
-| 条件 | 模式 | MCP 参数 | 使用场景 |
-|---|---|---|---|
-| Token 已设置 | Extension 模式 | `--extension` | 本地用户，连接已登录的 Chrome |
-| Token 未设置 | Standalone 模式 | （无特殊 flag） | CI 或无扩展环境，自启浏览器 |
+| 条件 | 模式 | 使用场景 |
+|---|---|---|
+| 扩展已安装 | Extension 模式 | 本地用户，连接已登录的 Chrome |
+| 扩展未安装 | CLI 报错提示安装 | 需要安装 Browser Bridge 扩展 |
 
 CI 中使用 `OPENCLI_BROWSER_EXECUTABLE_PATH` 指定真实 Chrome 路径：
 

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

@@ -0,0 +1,37 @@
+/**
+ * HTTP client for communicating with the opencli daemon.
+ *
+ * Provides a typed send() function that posts a Command and returns a Result.
+ */
+export interface DaemonCommand {
+    id: string;
+    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot';
+    tabId?: number;
+    code?: string;
+    url?: string;
+    op?: string;
+    index?: number;
+    domain?: string;
+    format?: 'png' | 'jpeg';
+    quality?: number;
+    fullPage?: boolean;
+}
+export interface DaemonResult {
+    id: string;
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+}
+/**
+ * Check if daemon is running.
+ */
+export declare function isDaemonRunning(): Promise<boolean>;
+/**
+ * Check if daemon is running AND the extension is connected.
+ */
+export declare function isExtensionConnected(): Promise<boolean>;
+/**
+ * Send a command to the daemon and wait for a result.
+ * 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>;

package/dist/browser/daemon-client.js

@@ -0,0 +1,82 @@
+/**
+ * HTTP client for communicating with the opencli daemon.
+ *
+ * Provides a typed send() function that posts a Command and returns a Result.
+ */
+const DAEMON_PORT = parseInt(process.env.OPENCLI_DAEMON_PORT ?? '19825', 10);
+const DAEMON_URL = `http://127.0.0.1:${DAEMON_PORT}`;
+let _idCounter = 0;
+function generateId() {
+    return `cmd_${Date.now()}_${++_idCounter}`;
+}
+/**
+ * Check if daemon is running.
+ */
+export async function isDaemonRunning() {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(`${DAEMON_URL}/status`, { signal: controller.signal });
+        clearTimeout(timer);
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if daemon is running AND the extension is connected.
+ */
+export async function isExtensionConnected() {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(`${DAEMON_URL}/status`, { signal: controller.signal });
+        clearTimeout(timer);
+        if (!res.ok)
+            return false;
+        const data = await res.json();
+        return !!data.extensionConnected;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Send a command to the daemon and wait for a result.
+ * Retries up to 3 times with 500ms delay for transient failures.
+ */
+export async function sendCommand(action, params = {}) {
+    const id = generateId();
+    const command = { id, action, ...params };
+    const maxRetries = 3;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 30000);
+            const res = await fetch(`${DAEMON_URL}/command`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(command),
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            const result = (await res.json());
+            if (!result.ok) {
+                throw new Error(result.error ?? 'Daemon command failed');
+            }
+            return result.data;
+        }
+        catch (err) {
+            const isRetryable = err instanceof TypeError // fetch network error
+                || (err instanceof Error && err.name === 'AbortError');
+            if (isRetryable && attempt < maxRetries) {
+                await new Promise(r => setTimeout(r, 500));
+                continue;
+            }
+            throw err;
+        }
+    }
+    // Unreachable — the loop always returns or throws
+    throw new Error('sendCommand: max retries exhausted');
+}

package/dist/browser/discover.d.ts

@@ -1,38 +1,15 @@
 /**
- * MCP server path discovery and argument building.
+ * 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.
  */
-import { execSync } from 'node:child_process';
-import * as fs from 'node:fs';
-export declare function resetMcpServerPathCache(): void;
-export declare function setMcpDiscoveryTestHooks(input?: {
-    existsSync?: typeof fs.existsSync;
-    execSync?: typeof execSync;
-}): void;
-export declare function findMcpServerPath(): string | null;
+import { isDaemonRunning } from './daemon-client.js';
+export { isDaemonRunning };
 /**
- * Chrome 144+ auto-discovery: read DevToolsActivePort file to get CDP endpoint.
- *
- * Starting with Chrome 144, users can enable remote debugging from
- * chrome://inspect#remote-debugging without any command-line flags.
- * Chrome writes the active port and browser GUID to a DevToolsActivePort file
- * in the user data directory, which we read to construct the WebSocket endpoint.
+ * Check daemon status and return connection info.
  */
-export declare function discoverChromeEndpoint(): string | null;
-export declare function resolveCdpEndpoint(): {
-    endpoint?: string;
-    requestedCdp: boolean;
-};
-export declare function buildMcpArgs(input: {
-    mcpPath: string;
-    executablePath?: string | null;
-    cdpEndpoint?: string;
-}): string[];
-export declare function buildMcpLaunchSpec(input: {
-    mcpPath?: string | null;
-    executablePath?: string | null;
-    cdpEndpoint?: string;
-}): {
-    command: string;
-    args: string[];
-    usedNpxFallback: boolean;
-};
+export declare function checkDaemonStatus(): Promise<{
+    running: boolean;
+    extensionConnected: boolean;
+}>;