@xbrowser/cli 1.0.6 → 1.0.8

package/README.md

@@ -1,6 +1,6 @@
 # xbrowser
 
-> **Browser automation CLI** for web scraping, headless browsing, SEO analysis, and AI agent workflows. 49 commands, 69 plugins. A command-line alternative to Playwright, Puppeteer, and Selenium — **no code required**.
+> **Browser automation CLI** for web scraping, headless browsing, SEO analysis, and AI agent workflows. 49 commands, 20+ plugins. A command-line alternative to Playwright, Puppeteer, and Selenium — **no code required**.
 
 [![CI Status](https://github.com/dyyz1993/xbrowser/workflows/CI/badge.svg)](https://github.com/dyyz1993/xbrowser/actions)
 [![codecov](https://codecov.io/gh/dyyz1993/xbrowser/branch/master/graph/badge.svg)](https://codecov.io/gh/dyyz1993/xbrowser)
@@ -13,7 +13,7 @@
 - **命令链** — 用 `&&`、`,`、`+`、`->`、`;` 串联多个命令，一行搞定复杂流程
 - **管道 & Heredoc** — 支持 stdin 管道和 heredoc 批量执行
 - **录制 / 回放** — 录制浏览器操作为 YAML，随时回放，可转换为 JS/Python/Bash 脚本
-- **插件系统** — 基于 `@dyyz1993/xcli-core`，用 TypeScript 编写站点插件
+- **插件系统** — 基于 `@dyyz1993/xcli-core`，用 TypeScript 编写站点插件。快速开始：`xbrowser create my-plugin --template static`
 - **CDP 连接** — 连接已运行的 Chrome/Chromium，无需重新启动浏览器
 - **会话管理** — 多会话并行，独立上下文
 - **Daemon 模式** — 后台常驻，快速响应
@@ -50,8 +50,10 @@ xbrowser "goto https://example.com && wait .content && text --selector .content"
 
 **SEO & Backlink Automation**
 ```bash
-# Auto-publish articles to 13+ SEO platforms
-xbrowser publish --platform devto,juejin --file article.md
+# Publish articles to SEO platforms via site plugins
+xbrowser devto publish --file article.md
+xbrowser juejin publish --file article.md
+# (Each platform has its own plugin — run `xbrowser plugin list` to see available)
 ```
 
 ## 快速开始
@@ -256,7 +258,7 @@ xbrowser --cdp auto "goto https://example.com , title"
 | `html --selector "#main"` | 获取指定元素 HTML | `xbrowser html --selector "#main"` |
 | `text` | 获取页面文本 | `xbrowser text` |
 | `text --selector "#article"` | 获取指定元素文本 | `xbrowser text --selector "#article"` |
-| `getProperty <selector> <property>` | 获取元素属性 | `xbrowser getProperty "#link" href` |
+| `eval "expression"` | 执行 JS 获取元素属性 | `xbrowser eval "document.querySelector('#link').href"` |
 
 ### 截图与快照
 
@@ -282,20 +284,20 @@ xbrowser --cdp auto "goto https://example.com , title"
 |------|------|------|
 | `eval <expression>` | 执行 JS 表达式 | `xbrowser eval "document.title"` |
 | `eval "1 + 2"` | 计算表达式 | `xbrowser eval "1 + 2"` |
-| `evaluateFn <fn> --args 1 2` | 执行带参数的函数 | `xbrowser evaluateFn "return args[0] + args[1]" --args 1 2` |
+| `eval "(a, b) => a + b" --args 1 2` | 执行带参数的函数 | `xbrowser eval "(a, b) => a + b" --args 1 2` |
 
 ### 存储
 
 | 命令 | 说明 | 示例 |
 |------|------|------|
-| `getCookies` | 获取所有 Cookie | `xbrowser getCookies` |
-| `setCookie <name> <value>` | 设置 Cookie | `xbrowser setCookie session abc123` |
-| `setCookie <name> <value> --domain .example.com` | 指定域名 | `xbrowser setCookie session abc123 --domain .example.com` |
-| `clearCookies` | 清除所有 Cookie | `xbrowser clearCookies` |
-| `getLocalStorage` | 获取所有 localStorage | `xbrowser getLocalStorage` |
-| `getLocalStorage --key token` | 获取指定 key | `xbrowser getLocalStorage --key token` |
-| `setLocalStorage <key> <value>` | 设置 localStorage | `xbrowser setLocalStorage token "abc"` |
-| `clearLocalStorage` | 清除 localStorage | `xbrowser clearLocalStorage` |
+| `get-cookies` | 获取所有 Cookie | `xbrowser get-cookies` |
+| `set-cookie <name> <value>` | 设置 Cookie | `xbrowser set-cookie session abc123` |
+| `set-cookie <name> <value> --domain .example.com` | 指定域名 | `xbrowser set-cookie session abc123 --domain .example.com` |
+| `clear-cookies` | 清除所有 Cookie | `xbrowser clear-cookies` |
+| `get-local-storage` | 获取所有 localStorage | `xbrowser get-local-storage` |
+| `get-local-storage --key token` | 获取指定 key | `xbrowser get-local-storage --key token` |
+| `set-local-storage <key> <value>` | 设置 localStorage | `xbrowser set-local-storage token "abc"` |
+| `clear-local-storage` | 清除 localStorage | `xbrowser clear-local-storage` |
 
 ### 帧操作
 
@@ -309,8 +311,8 @@ xbrowser --cdp auto "goto https://example.com , title"
 
 | 命令 | 说明 | 示例 |
 |------|------|------|
-| `setViewport <width> <height>` | 设置视口大小 | `xbrowser setViewport 1920 1080` |
-| `setViewport 375 812 --isMobile true` | 移动设备模式 | `xbrowser setViewport 375 812 --isMobile true` |
+| `set-viewport <width> <height>` | 设置视口大小 | `xbrowser set-viewport 1920 1080` |
+| `set-viewport 375 812 --isMobile true` | 移动设备模式 | `xbrowser set-viewport 375 812 --isMobile true` |
 
 ### 配置管理
 
@@ -416,7 +418,10 @@ xbrowser create my-plugin --template static --force
 | `;` | 分割管线（前一个完成后开始下一个） | `goto https://example.com ; goto https://other.com` |
 | `\|\|` | 前一步成功则跳过后续 | `goto https://example.com \|\| goto https://fallback.com` |
 
-**注意**：命令链中如果包含特殊字符（如 `#`、`>`），需要用引号包裹整个命令链或对单个参数加引号。
+**注意**：
+- 命令链中如果包含特殊字符（如 `#`、`>`），需要用引号包裹整个命令链或对单个参数加引号。
+- `->` 和 `+` 分隔符要求两边有空格（`goto url -> title` ✅，`goto url->title` ❌）。
+- `,` 和 `;` 不要求空格。
 
 ```bash
 # 正确 — 整体引号
@@ -440,7 +445,7 @@ project > browser > page > element
 | Scope | 说明 | 需要的条件 | 典型命令 |
 |-------|------|------------|----------|
 | **project** | 项目级别 | 无 | config, daemon, plugin |
-| **browser** | 浏览器级别 | 浏览器实例 | setViewport, session |
+| **browser** | 浏览器级别 | 浏览器实例 | set-viewport, session |
 | **page** | 页面级别 | 活跃页面 | goto, wait, scroll, screenshot |
 | **element** | 元素级别 | 页面中的元素 | click, fill, type, hover |
 

package/dist/{browser-X7OVRKJH.js → browser-6QN42A4K.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-5QAYN5EZ.js";
-import "./chunk-SEFIJY2M.js";
+} from "./chunk-EUHVZVVL.js";
+import "./chunk-IX4JY6OO.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-ABXMBNQ6.js";

package/dist/{browser-U4VWPTS2.js → browser-AN6MKGOD.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-7POCCXIB.js";
+} from "./chunk-HRTXMFW4.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-AXCKBSWS.js → browser-MUPES4UY.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-MXG2H3HJ.js";
-import "./chunk-SEFIJY2M.js";
+} from "./chunk-JUNEBEGF.js";
+import "./chunk-IX4JY6OO.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{cdp-driver-CWNZVWHX.js → cdp-driver-E4I3AEJK.js}

@@ -1669,6 +1669,10 @@ Last error: ${lastError.message}` : "";
           }
         };
         this._emit("dialog", dialog);
+        setTimeout(() => {
+          this.conn.send("Page.handleJavaScriptDialog", { accept: false }, this.sessionId).catch(() => {
+          });
+        }, 100);
       })
     );
     this._subscriptions.push(

package/dist/{cdp-driver-ZAVN7GRB.js → cdp-driver-LKNM6OQI.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-SEFIJY2M.js";
+} from "./chunk-IX4JY6OO.js";
 import {
   connectToCDP,
   findChrome,

package/dist/{chunk-5QAYN5EZ.js → chunk-EUHVZVVL.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-SEFIJY2M.js";
+} from "./chunk-IX4JY6OO.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-7POCCXIB.js → chunk-HRTXMFW4.js}

@@ -1674,6 +1674,10 @@ Last error: ${lastError.message}` : "";
           }
         };
         this._emit("dialog", dialog);
+        setTimeout(() => {
+          this.conn.send("Page.handleJavaScriptDialog", { accept: false }, this.sessionId).catch(() => {
+          });
+        }, 100);
       })
     );
     this._subscriptions.push(

package/dist/{chunk-SEFIJY2M.js → chunk-IX4JY6OO.js}

@@ -1668,6 +1668,10 @@ Last error: ${lastError.message}` : "";
           }
         };
         this._emit("dialog", dialog);
+        setTimeout(() => {
+          this.conn.send("Page.handleJavaScriptDialog", { accept: false }, this.sessionId).catch(() => {
+          });
+        }, 100);
       })
     );
     this._subscriptions.push(

package/dist/{chunk-MXG2H3HJ.js → chunk-JUNEBEGF.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-SEFIJY2M.js";
+} from "./chunk-IX4JY6OO.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-7POCCXIB.js";
+} from "./chunk-HRTXMFW4.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -2131,6 +2131,7 @@ function createTurndown() {
   return turndown;
 }
 function postClean(md) {
+  md = md.replace(/<(?:table|div|tbody|thead|tr|td|th|span|colgroup|col)\b[^>]*(?:>[\s\S]{200,}?<\/(?:table|div|tbody|thead|tr|td|th|span|colgroup|col)>)/g, "\n[\u26A0\uFE0F HTML block removed \u2014 complex table/layout not converted to Markdown]\n");
   md = md.replace(/\n{3,}/g, "\n\n");
   md = md.replace(/!\[[^\]]*\]\(\s*\)/g, "");
   md = md.replace(/\[([^\]]*)\]\(\s*\)/g, "$1");
@@ -6966,7 +6967,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-U4VWPTS2.js");
+    const { findTargetPage } = await import("./browser-AN6MKGOD.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -8810,6 +8811,8 @@ var TEMPLATES = {
       {
         path: "index.ts",
         content: [
+          `import { z } from 'zod';`,
+          `import { ok } from '@dyyz1993/xcli-core';`,
           `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
           ``,
           `export default function (xcli: XCLIAPI): void {`,
@@ -8827,7 +8830,7 @@ var TEMPLATES = {
           `        (sel: string) => document.querySelector(sel)?.textContent ?? '',`,
           `        params.selector || 'body'`,
           `      );`,
-          `      return { ok: true, text };`,
+          `      return ok({ text });`,
           `    },`,
           `  });`,
           `}`
@@ -8835,14 +8838,21 @@ var TEMPLATES = {
       },
       {
         path: "package.json",
-        content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
-`
+        content: [
+          `{`,
+          `  "name": "xbrowser-plugin-{{projectName}}",`,
+          `  "version": "1.0.0",`,
+          `  "main": "index.ts",`,
+          `  "type": "module",`,
+          `  "dependencies": { "zod": "^3.24.0" },`,
+          `  "peerDependencies": { "@dyyz1993/xcli-core": ">=1.0.0" },`,
+          `  "xbrowser": {`,
+          `    "name": "{{projectName}}",`,
+          `    "description": "A static page plugin",`,
+          `    "commands": ["scrape"]`,
+          `  }`,
+          `}`
+        ].join("\n")
       }
     ]
   },
@@ -8853,6 +8863,8 @@ var TEMPLATES = {
       {
         path: "index.ts",
         content: [
+          `import { z } from 'zod';`,
+          `import { ok } from '@dyyz1993/xcli-core';`,
           `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
           ``,
           `export default function (xcli: XCLIAPI): void {`,
@@ -8867,7 +8879,7 @@ var TEMPLATES = {
           `    parameters: z.object({ url: z.string() }),`,
           `    handler: async (params, ctx) => {`,
           `      await ctx.page.goto(params.url);`,
-          `      return { ok: true };`,
+          `      return ok({ url: params.url });`,
           `    },`,
           `  });`,
           ``,
@@ -8882,7 +8894,7 @@ var TEMPLATES = {
           `        case 'fill': await page.fill(params.selector, ''); break;`,
           `        case 'hover': await page.hover(params.selector); break;`,
           `      }`,
-          `      return { ok: true };`,
+          `      return ok({ action: params.action, selector: params.selector });`,
           `    },`,
           `  });`,
           `}`
@@ -8890,14 +8902,21 @@ var TEMPLATES = {
       },
       {
         path: "package.json",
-        content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
-`
+        content: [
+          `{`,
+          `  "name": "xbrowser-plugin-{{projectName}}",`,
+          `  "version": "1.0.0",`,
+          `  "main": "index.ts",`,
+          `  "type": "module",`,
+          `  "dependencies": { "zod": "^3.24.0" },`,
+          `  "peerDependencies": { "@dyyz1993/xcli-core": ">=1.0.0" },`,
+          `  "xbrowser": {`,
+          `    "name": "{{projectName}}",`,
+          `    "description": "A dynamic page plugin",`,
+          `    "commands": ["navigate", "interact"]`,
+          `  }`,
+          `}`
+        ].join("\n")
       }
     ]
   },
@@ -8908,6 +8927,8 @@ var TEMPLATES = {
       {
         path: "index.ts",
         content: [
+          `import { z } from 'zod';`,
+          `import { ok } from '@dyyz1993/xcli-core';`,
           `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
           ``,
           `export default function (xcli: XCLIAPI): void {`,
@@ -8921,14 +8942,13 @@ var TEMPLATES = {
           `    description: 'Check login status',`,
           `    scope: 'project',`,
           `    parameters: z.object({}),`,
-          `    handler: async (_params, ctx) => {`,
+          `    handler: async () => {`,
           `      const loggedIn = await site.isLoggedIn();`,
-          `      return { ok: true, loggedIn };`,
+          `      return ok({ loggedIn });`,
           `    },`,
           `  });`,
           ``,
           `  site.login(async (ctx) => {`,
-          `    console.log('Login handler for {{projectName}}');`,
           `    await ctx.storage.set('auth_token', 'dummy');`,
           `  });`,
           ``,
@@ -8940,14 +8960,22 @@ var TEMPLATES = {
       },
       {
         path: "package.json",
-        content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
-`
+        content: [
+          `{`,
+          `  "name": "xbrowser-plugin-{{projectName}}",`,
+          `  "version": "1.0.0",`,
+          `  "main": "index.ts",`,
+          `  "type": "module",`,
+          `  "dependencies": { "zod": "^3.24.0" },`,
+          `  "peerDependencies": { "@dyyz1993/xcli-core": ">=1.0.0" },`,
+          `  "xbrowser": {`,
+          `    "name": "{{projectName}}",`,
+          `    "description": "A plugin with login/logout support",`,
+          `    "requiresLogin": true,`,
+          `    "commands": ["check"]`,
+          `  }`,
+          `}`
+        ].join("\n")
       }
     ]
   },
@@ -8958,6 +8986,8 @@ var TEMPLATES = {
       {
         path: "index.ts",
         content: [
+          `import { z } from 'zod';`,
+          `import { ok } from '@dyyz1993/xcli-core';`,
           `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
           ``,
           `export default function (xcli: XCLIAPI): void {`,
@@ -8970,9 +9000,9 @@ var TEMPLATES = {
           `    description: 'Fetch data from API',`,
           `    scope: 'project',`,
           `    parameters: z.object({ endpoint: z.string(), method: z.enum(['GET', 'POST']).optional() }),`,
-          `    handler: async (params, _ctx) => {`,
+          `    handler: async (params) => {`,
           `      const method = params.method || 'GET';`,
-          `      return { ok: true, endpoint: params.endpoint, method };`,
+          `      return ok({ endpoint: params.endpoint, method });`,
           `    },`,
           `  });`,
           ``,
@@ -8980,8 +9010,8 @@ var TEMPLATES = {
           `    description: 'List available endpoints',`,
           `    scope: 'project',`,
           `    parameters: z.object({}),`,
-          `    handler: async (_params, _ctx) => {`,
-          `      return { ok: true, endpoints: ['/api/data', '/api/status'] };`,
+          `    handler: async () => {`,
+          `      return ok({ endpoints: ['/api/data', '/api/status'] });`,
           `    },`,
           `  });`,
           `}`
@@ -8989,14 +9019,21 @@ var TEMPLATES = {
       },
       {
         path: "package.json",
-        content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
-`
+        content: [
+          `{`,
+          `  "name": "xbrowser-plugin-{{projectName}}",`,
+          `  "version": "1.0.0",`,
+          `  "main": "index.ts",`,
+          `  "type": "module",`,
+          `  "dependencies": { "zod": "^3.24.0" },`,
+          `  "peerDependencies": { "@dyyz1993/xcli-core": ">=1.0.0" },`,
+          `  "xbrowser": {`,
+          `    "name": "{{projectName}}",`,
+          `    "description": "An API integration plugin",`,
+          `    "commands": ["fetch", "list-endpoints"]`,
+          `  }`,
+          `}`
+        ].join("\n")
       }
     ]
   }
@@ -9611,6 +9648,18 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         params = { width, height };
         break;
       }
+      case "mouse": {
+        const action = options.action || args.find((a) => ["move", "click", "dblclick", "down", "up"].includes(a));
+        const actionIdx = action ? args.indexOf(action) : -1;
+        const x = options.x !== void 0 ? Number(options.x) : actionIdx >= 0 && args[actionIdx + 1] ? Number(args[actionIdx + 1]) : void 0;
+        const y = options.y !== void 0 ? Number(options.y) : actionIdx >= 0 && args[actionIdx + 2] ? Number(args[actionIdx + 2]) : void 0;
+        if (!action || x === void 0 || y === void 0) {
+          outputError("Usage: xbrowser mouse <move|click|dblclick> <x> <y>\n       xbrowser mouse --action <action> --x <x> --y <y>");
+        }
+        cmdName = "mouse";
+        params = { action, x, y, ...options.button ? { button: options.button } : {} };
+        break;
+      }
       case "html":
         cmdName = "html";
         params = { selector: options.selector || options.s };
@@ -10147,6 +10196,11 @@ async function handlePlugin(args, options, mode) {
     case "uninstall": {
       const name = subArgs[0];
       if (!name) outputError("Usage: xbrowser plugin uninstall <name>");
+      const installed = await installer.list();
+      const exists = installed.some((p) => p.name === name || p.metadata?.name === name);
+      if (!exists) {
+        outputError(`Plugin "${name}" is not installed. Use 'xbrowser plugin list' to see installed plugins.`);
+      }
       await installer.uninstall(name);
       outputResult({ ok: true, name }, mode);
       break;
@@ -12553,7 +12607,7 @@ async function handleServe(_args, options, mode) {
   \u{1F310} xbrowser HTTP Server`);
       console.log(`
   URL: ${output.url}`);
-      console.log(`  Auth: ${output.authRequired ? "Enabled (Bearer token)" : "Disabled (dev mode)"}
+      console.log(`  Auth: ${output.authRequired ? "Enabled (Bearer token, except /health)" : "Disabled (dev mode)"}
 `);
       console.log(`  Endpoints:`);
       for (const [, value] of Object.entries(output.endpoints)) {
@@ -12673,7 +12727,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-U4VWPTS2.js");
+      const { ensureProcessCanExit } = await import("./browser-AN6MKGOD.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);

package/dist/daemon-main.js

@@ -21,8 +21,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-MXG2H3HJ.js";
-import "./chunk-SEFIJY2M.js";
+} from "./chunk-JUNEBEGF.js";
+import "./chunk-IX4JY6OO.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getDaemonConfig,
@@ -2089,6 +2089,7 @@ function createTurndown() {
   return turndown;
 }
 function postClean(md) {
+  md = md.replace(/<(?:table|div|tbody|thead|tr|td|th|span|colgroup|col)\b[^>]*(?:>[\s\S]{200,}?<\/(?:table|div|tbody|thead|tr|td|th|span|colgroup|col)>)/g, "\n[\u26A0\uFE0F HTML block removed \u2014 complex table/layout not converted to Markdown]\n");
   md = md.replace(/\n{3,}/g, "\n\n");
   md = md.replace(/!\[[^\]]*\]\(\s*\)/g, "");
   md = md.replace(/\[([^\]]*)\]\(\s*\)/g, "$1");
@@ -6924,7 +6925,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-AXCKBSWS.js");
+    const { findTargetPage } = await import("./browser-MUPES4UY.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -8608,7 +8609,7 @@ function createRPCHandler() {
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {
       try {
-        const { SessionReplayer } = await import("./session-replayer-GCGY6KFK.js");
+        const { SessionReplayer } = await import("./session-replayer-YWMSSZWC.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.js

@@ -81,8 +81,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-5QAYN5EZ.js";
-import "./chunk-SEFIJY2M.js";
+} from "./chunk-EUHVZVVL.js";
+import "./chunk-IX4JY6OO.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -2171,6 +2171,7 @@ function createTurndown() {
   return turndown;
 }
 function postClean(md) {
+  md = md.replace(/<(?:table|div|tbody|thead|tr|td|th|span|colgroup|col)\b[^>]*(?:>[\s\S]{200,}?<\/(?:table|div|tbody|thead|tr|td|th|span|colgroup|col)>)/g, "\n[\u26A0\uFE0F HTML block removed \u2014 complex table/layout not converted to Markdown]\n");
   md = md.replace(/\n{3,}/g, "\n\n");
   md = md.replace(/!\[[^\]]*\]\(\s*\)/g, "");
   md = md.replace(/\[([^\]]*)\]\(\s*\)/g, "$1");
@@ -7286,7 +7287,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-X7OVRKJH.js");
+    const { findTargetPage } = await import("./browser-6QN42A4K.js");
     targetPageOverride = await findTargetPage(extraOpts.cdpEndpoint, _target);
     if (!targetPageOverride) {
       return errorResult(`Target "${_target}" not found. Use 'xbrowser targets --cdp ${extraOpts.cdpEndpoint}' to list available pages.`);
@@ -9145,6 +9146,8 @@ var TEMPLATES = {
       {
         path: "index.ts",
         content: [
+          `import { z } from 'zod';`,
+          `import { ok } from '@dyyz1993/xcli-core';`,
           `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
           ``,
           `export default function (xcli: XCLIAPI): void {`,
@@ -9162,7 +9165,7 @@ var TEMPLATES = {
           `        (sel: string) => document.querySelector(sel)?.textContent ?? '',`,
           `        params.selector || 'body'`,
           `      );`,
-          `      return { ok: true, text };`,
+          `      return ok({ text });`,
           `    },`,
           `  });`,
           `}`
@@ -9170,14 +9173,21 @@ var TEMPLATES = {
       },
       {
         path: "package.json",
-        content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
-`
+        content: [
+          `{`,
+          `  "name": "xbrowser-plugin-{{projectName}}",`,
+          `  "version": "1.0.0",`,
+          `  "main": "index.ts",`,
+          `  "type": "module",`,
+          `  "dependencies": { "zod": "^3.24.0" },`,
+          `  "peerDependencies": { "@dyyz1993/xcli-core": ">=1.0.0" },`,
+          `  "xbrowser": {`,
+          `    "name": "{{projectName}}",`,
+          `    "description": "A static page plugin",`,
+          `    "commands": ["scrape"]`,
+          `  }`,
+          `}`
+        ].join("\n")
       }
     ]
   },
@@ -9188,6 +9198,8 @@ var TEMPLATES = {
       {
         path: "index.ts",
         content: [
+          `import { z } from 'zod';`,
+          `import { ok } from '@dyyz1993/xcli-core';`,
           `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
           ``,
           `export default function (xcli: XCLIAPI): void {`,
@@ -9202,7 +9214,7 @@ var TEMPLATES = {
           `    parameters: z.object({ url: z.string() }),`,
           `    handler: async (params, ctx) => {`,
           `      await ctx.page.goto(params.url);`,
-          `      return { ok: true };`,
+          `      return ok({ url: params.url });`,
           `    },`,
           `  });`,
           ``,
@@ -9217,7 +9229,7 @@ var TEMPLATES = {
           `        case 'fill': await page.fill(params.selector, ''); break;`,
           `        case 'hover': await page.hover(params.selector); break;`,
           `      }`,
-          `      return { ok: true };`,
+          `      return ok({ action: params.action, selector: params.selector });`,
           `    },`,
           `  });`,
           `}`
@@ -9225,14 +9237,21 @@ var TEMPLATES = {
       },
       {
         path: "package.json",
-        content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
-`
+        content: [
+          `{`,
+          `  "name": "xbrowser-plugin-{{projectName}}",`,
+          `  "version": "1.0.0",`,
+          `  "main": "index.ts",`,
+          `  "type": "module",`,
+          `  "dependencies": { "zod": "^3.24.0" },`,
+          `  "peerDependencies": { "@dyyz1993/xcli-core": ">=1.0.0" },`,
+          `  "xbrowser": {`,
+          `    "name": "{{projectName}}",`,
+          `    "description": "A dynamic page plugin",`,
+          `    "commands": ["navigate", "interact"]`,
+          `  }`,
+          `}`
+        ].join("\n")
       }
     ]
   },
@@ -9243,6 +9262,8 @@ var TEMPLATES = {
       {
         path: "index.ts",
         content: [
+          `import { z } from 'zod';`,
+          `import { ok } from '@dyyz1993/xcli-core';`,
           `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
           ``,
           `export default function (xcli: XCLIAPI): void {`,
@@ -9256,14 +9277,13 @@ var TEMPLATES = {
           `    description: 'Check login status',`,
           `    scope: 'project',`,
           `    parameters: z.object({}),`,
-          `    handler: async (_params, ctx) => {`,
+          `    handler: async () => {`,
           `      const loggedIn = await site.isLoggedIn();`,
-          `      return { ok: true, loggedIn };`,
+          `      return ok({ loggedIn });`,
           `    },`,
           `  });`,
           ``,
           `  site.login(async (ctx) => {`,
-          `    console.log('Login handler for {{projectName}}');`,
           `    await ctx.storage.set('auth_token', 'dummy');`,
           `  });`,
           ``,
@@ -9275,14 +9295,22 @@ var TEMPLATES = {
       },
       {
         path: "package.json",
-        content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
-`
+        content: [
+          `{`,
+          `  "name": "xbrowser-plugin-{{projectName}}",`,
+          `  "version": "1.0.0",`,
+          `  "main": "index.ts",`,
+          `  "type": "module",`,
+          `  "dependencies": { "zod": "^3.24.0" },`,
+          `  "peerDependencies": { "@dyyz1993/xcli-core": ">=1.0.0" },`,
+          `  "xbrowser": {`,
+          `    "name": "{{projectName}}",`,
+          `    "description": "A plugin with login/logout support",`,
+          `    "requiresLogin": true,`,
+          `    "commands": ["check"]`,
+          `  }`,
+          `}`
+        ].join("\n")
       }
     ]
   },
@@ -9293,6 +9321,8 @@ var TEMPLATES = {
       {
         path: "index.ts",
         content: [
+          `import { z } from 'zod';`,
+          `import { ok } from '@dyyz1993/xcli-core';`,
           `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
           ``,
           `export default function (xcli: XCLIAPI): void {`,
@@ -9305,9 +9335,9 @@ var TEMPLATES = {
           `    description: 'Fetch data from API',`,
           `    scope: 'project',`,
           `    parameters: z.object({ endpoint: z.string(), method: z.enum(['GET', 'POST']).optional() }),`,
-          `    handler: async (params, _ctx) => {`,
+          `    handler: async (params) => {`,
           `      const method = params.method || 'GET';`,
-          `      return { ok: true, endpoint: params.endpoint, method };`,
+          `      return ok({ endpoint: params.endpoint, method });`,
           `    },`,
           `  });`,
           ``,
@@ -9315,8 +9345,8 @@ var TEMPLATES = {
           `    description: 'List available endpoints',`,
           `    scope: 'project',`,
           `    parameters: z.object({}),`,
-          `    handler: async (_params, _ctx) => {`,
-          `      return { ok: true, endpoints: ['/api/data', '/api/status'] };`,
+          `    handler: async () => {`,
+          `      return ok({ endpoints: ['/api/data', '/api/status'] });`,
           `    },`,
           `  });`,
           `}`
@@ -9324,14 +9354,21 @@ var TEMPLATES = {
       },
       {
         path: "package.json",
-        content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
-`
+        content: [
+          `{`,
+          `  "name": "xbrowser-plugin-{{projectName}}",`,
+          `  "version": "1.0.0",`,
+          `  "main": "index.ts",`,
+          `  "type": "module",`,
+          `  "dependencies": { "zod": "^3.24.0" },`,
+          `  "peerDependencies": { "@dyyz1993/xcli-core": ">=1.0.0" },`,
+          `  "xbrowser": {`,
+          `    "name": "{{projectName}}",`,
+          `    "description": "An API integration plugin",`,
+          `    "commands": ["fetch", "list-endpoints"]`,
+          `  }`,
+          `}`
+        ].join("\n")
       }
     ]
   }
@@ -9951,6 +9988,18 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         params = { width, height };
         break;
       }
+      case "mouse": {
+        const action = options.action || args.find((a) => ["move", "click", "dblclick", "down", "up"].includes(a));
+        const actionIdx = action ? args.indexOf(action) : -1;
+        const x = options.x !== void 0 ? Number(options.x) : actionIdx >= 0 && args[actionIdx + 1] ? Number(args[actionIdx + 1]) : void 0;
+        const y = options.y !== void 0 ? Number(options.y) : actionIdx >= 0 && args[actionIdx + 2] ? Number(args[actionIdx + 2]) : void 0;
+        if (!action || x === void 0 || y === void 0) {
+          outputError("Usage: xbrowser mouse <move|click|dblclick> <x> <y>\n       xbrowser mouse --action <action> --x <x> --y <y>");
+        }
+        cmdName = "mouse";
+        params = { action, x, y, ...options.button ? { button: options.button } : {} };
+        break;
+      }
       case "html":
         cmdName = "html";
         params = { selector: options.selector || options.s };
@@ -10487,6 +10536,11 @@ async function handlePlugin(args, options, mode) {
     case "uninstall": {
       const name = subArgs[0];
       if (!name) outputError("Usage: xbrowser plugin uninstall <name>");
+      const installed = await installer.list();
+      const exists = installed.some((p) => p.name === name || p.metadata?.name === name);
+      if (!exists) {
+        outputError(`Plugin "${name}" is not installed. Use 'xbrowser plugin list' to see installed plugins.`);
+      }
       await installer.uninstall(name);
       outputResult({ ok: true, name }, mode);
       break;
@@ -12893,7 +12947,7 @@ async function handleServe(_args, options, mode) {
   \u{1F310} xbrowser HTTP Server`);
       console.log(`
   URL: ${output.url}`);
-      console.log(`  Auth: ${output.authRequired ? "Enabled (Bearer token)" : "Disabled (dev mode)"}
+      console.log(`  Auth: ${output.authRequired ? "Enabled (Bearer token, except /health)" : "Disabled (dev mode)"}
 `);
       console.log(`  Endpoints:`);
       for (const [, value] of Object.entries(output.endpoints)) {
@@ -15800,7 +15854,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-ZAVN7GRB.js");
+    const { launch } = await import("./cdp-driver-LKNM6OQI.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-GCGY6KFK.js → session-replayer-YWMSSZWC.js}

@@ -31,7 +31,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-ZAVN7GRB.js");
+      const { launch } = await import("./cdp-driver-LKNM6OQI.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Browser automation CLI for web scraping, headless browsing, SEO analysis, and AI agent workflows. A command-line alternative to Playwright, Puppeteer, and Selenium.",
   "type": "module",
   "bin": {