@xbrowser/cli 1.0.5 → 1.0.7

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 模式** — 后台常驻，快速响应
@@ -256,7 +256,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 +282,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 +309,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 +416,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 +443,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-ITLZZDHJ.js → browser-AXCKBSWS.js}

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

package/dist/{browser-5CTOA2WS.js → browser-U4VWPTS2.js}

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

package/dist/{browser-IUJXXNBT.js → browser-X7OVRKJH.js}

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

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

@@ -2179,8 +2179,14 @@ var XBContextImpl = class {
   // ── Cookies ─────────────────────────────────────────────────
   async cookies(urls) {
     const urlList = typeof urls === "string" ? [urls] : urls;
-    const result = await this.conn.send("Network.getCookies", urlList ? { urls: urlList } : void 0);
-    return result.cookies;
+    const params = urlList ? { urls: urlList } : void 0;
+    try {
+      const result = await this.conn.send("Storage.getCookies", params);
+      return result.cookies;
+    } catch {
+      const result = await this.conn.send("Network.getCookies", params);
+      return result.cookies;
+    }
   }
   async addCookies(cookies) {
     const cdpCookies = cookies.map((c) => ({
@@ -2193,10 +2199,18 @@ var XBContextImpl = class {
       secure: c.secure,
       sameSite: c.sameSite
     }));
-    await this.conn.send("Network.setCookies", { cookies: cdpCookies });
+    try {
+      await this.conn.send("Storage.setCookies", { cookies: cdpCookies });
+    } catch {
+      await this.conn.send("Network.setCookies", { cookies: cdpCookies });
+    }
   }
   async clearCookies() {
-    await this.conn.send("Network.clearBrowserCookies");
+    try {
+      await this.conn.send("Storage.clearCookies");
+    } catch {
+      await this.conn.send("Network.clearBrowserCookies");
+    }
   }
   on(event, handler) {
     this._emitter.on(event, handler);

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

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

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

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-N2JFPWMI.js";
+} from "./chunk-SEFIJY2M.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -36,6 +36,15 @@ async function fetchNoProxy(url) {
 async function resolveCDPEndpoint(raw) {
   if (raw === "auto") {
     const httpResp = await fetchNoProxy("http://localhost:9222/json/version");
+    if (!httpResp.ok) {
+      throw new Error(
+        `CDP port 9222 responded with ${httpResp.status} ${httpResp.statusText}. \u53EF\u80FD\u539F\u56E0\uFF1A9222 \u88AB\u50F5\u6B7B\u7684 Chrome \u5360\u7528\uFF0C\u6216\u6CA1\u6709 Chrome \u4EE5 --remote-debugging-port \u542F\u52A8\u3002
+\u89E3\u51B3\u65B9\u6CD5\uFF1A
+  1. \u6740\u6389\u6B8B\u7559 Chrome: pkill -f "remote-debugging-port"
+  2. \u91CD\u542F Chrome: npx cdp-tunnel setup
+  3. \u6216\u6307\u5B9A\u7AEF\u53E3: --cdp <port>`
+      );
+    }
     const data = await httpResp.json();
     if (!data.webSocketDebuggerUrl) {
       throw new Error("Could not auto-discover CDP endpoint from localhost:9222");

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

@@ -2184,8 +2184,14 @@ var XBContextImpl = class {
   // ── Cookies ─────────────────────────────────────────────────
   async cookies(urls) {
     const urlList = typeof urls === "string" ? [urls] : urls;
-    const result = await this.conn.send("Network.getCookies", urlList ? { urls: urlList } : void 0);
-    return result.cookies;
+    const params = urlList ? { urls: urlList } : void 0;
+    try {
+      const result = await this.conn.send("Storage.getCookies", params);
+      return result.cookies;
+    } catch {
+      const result = await this.conn.send("Network.getCookies", params);
+      return result.cookies;
+    }
   }
   async addCookies(cookies) {
     const cdpCookies = cookies.map((c) => ({
@@ -2198,10 +2204,18 @@ var XBContextImpl = class {
       secure: c.secure,
       sameSite: c.sameSite
     }));
-    await this.conn.send("Network.setCookies", { cookies: cdpCookies });
+    try {
+      await this.conn.send("Storage.setCookies", { cookies: cdpCookies });
+    } catch {
+      await this.conn.send("Network.setCookies", { cookies: cdpCookies });
+    }
   }
   async clearCookies() {
-    await this.conn.send("Network.clearBrowserCookies");
+    try {
+      await this.conn.send("Storage.clearCookies");
+    } catch {
+      await this.conn.send("Network.clearBrowserCookies");
+    }
   }
   on(event, handler) {
     this._emitter.on(event, handler);
@@ -4129,6 +4143,15 @@ async function fetchNoProxy(url) {
 async function resolveCDPEndpoint(raw) {
   if (raw === "auto") {
     const httpResp = await fetchNoProxy("http://localhost:9222/json/version");
+    if (!httpResp.ok) {
+      throw new Error(
+        `CDP port 9222 responded with ${httpResp.status} ${httpResp.statusText}. \u53EF\u80FD\u539F\u56E0\uFF1A9222 \u88AB\u50F5\u6B7B\u7684 Chrome \u5360\u7528\uFF0C\u6216\u6CA1\u6709 Chrome \u4EE5 --remote-debugging-port \u542F\u52A8\u3002
+\u89E3\u51B3\u65B9\u6CD5\uFF1A
+  1. \u6740\u6389\u6B8B\u7559 Chrome: pkill -f "remote-debugging-port"
+  2. \u91CD\u542F Chrome: npx cdp-tunnel setup
+  3. \u6216\u6307\u5B9A\u7AEF\u53E3: --cdp <port>`
+      );
+    }
     const data = await httpResp.json();
     if (!data.webSocketDebuggerUrl) {
       throw new Error("Could not auto-discover CDP endpoint from localhost:9222");

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

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-N2JFPWMI.js";
+} from "./chunk-SEFIJY2M.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -1401,6 +1401,15 @@ async function fetchNoProxy(url) {
 async function resolveCDPEndpoint(raw) {
   if (raw === "auto") {
     const httpResp = await fetchNoProxy("http://localhost:9222/json/version");
+    if (!httpResp.ok) {
+      throw new Error(
+        `CDP port 9222 responded with ${httpResp.status} ${httpResp.statusText}. \u53EF\u80FD\u539F\u56E0\uFF1A9222 \u88AB\u50F5\u6B7B\u7684 Chrome \u5360\u7528\uFF0C\u6216\u6CA1\u6709 Chrome \u4EE5 --remote-debugging-port \u542F\u52A8\u3002
+\u89E3\u51B3\u65B9\u6CD5\uFF1A
+  1. \u6740\u6389\u6B8B\u7559 Chrome: pkill -f "remote-debugging-port"
+  2. \u91CD\u542F Chrome: npx cdp-tunnel setup
+  3. \u6216\u6307\u5B9A\u7AEF\u53E3: --cdp <port>`
+      );
+    }
     const data = await httpResp.json();
     if (!data.webSocketDebuggerUrl) {
       throw new Error("Could not auto-discover CDP endpoint from localhost:9222");

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

@@ -2178,8 +2178,14 @@ var XBContextImpl = class {
   // ── Cookies ─────────────────────────────────────────────────
   async cookies(urls) {
     const urlList = typeof urls === "string" ? [urls] : urls;
-    const result = await this.conn.send("Network.getCookies", urlList ? { urls: urlList } : void 0);
-    return result.cookies;
+    const params = urlList ? { urls: urlList } : void 0;
+    try {
+      const result = await this.conn.send("Storage.getCookies", params);
+      return result.cookies;
+    } catch {
+      const result = await this.conn.send("Network.getCookies", params);
+      return result.cookies;
+    }
   }
   async addCookies(cookies) {
     const cdpCookies = cookies.map((c) => ({
@@ -2192,10 +2198,18 @@ var XBContextImpl = class {
       secure: c.secure,
       sameSite: c.sameSite
     }));
-    await this.conn.send("Network.setCookies", { cookies: cdpCookies });
+    try {
+      await this.conn.send("Storage.setCookies", { cookies: cdpCookies });
+    } catch {
+      await this.conn.send("Network.setCookies", { cookies: cdpCookies });
+    }
   }
   async clearCookies() {
-    await this.conn.send("Network.clearBrowserCookies");
+    try {
+      await this.conn.send("Storage.clearCookies");
+    } catch {
+      await this.conn.send("Network.clearBrowserCookies");
+    }
   }
   on(event, handler) {
     this._emitter.on(event, handler);

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-DKWR54XQ.js";
+} from "./chunk-7POCCXIB.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -346,8 +346,13 @@ var gotoCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     let url = p.url;
-    if (!/^https?:\/\//i.test(url) && !/^wss?:\/\//i.test(url)) {
-      url = "https://" + url;
+    const hasScheme = /^(https?|wss?|file|about|data|chrome|blob):/i.test(url);
+    if (!hasScheme) {
+      if (/^[\w-]+(\.[\w-]+)+/.test(url) || url.startsWith("localhost")) {
+        url = "https://" + url;
+      } else {
+        throw new Error(`Invalid URL: "${url}". Expected http(s)://, file://, about:, data:, or a domain name.`);
+      }
     }
     const response = await ctx.page.goto(url, {
       waitUntil: p.waitUntil || "domcontentloaded"
@@ -402,7 +407,7 @@ var urlCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    return ok({ url: ctx.page.url() });
+    return ok({ url: ctx.page.url() || "about:blank" });
   }
 });
 registerCommand({
@@ -565,7 +570,8 @@ var fillCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     const page = ctx.page;
-    if (p.clear) {
+    const shouldClear = p.clear !== false;
+    if (shouldClear) {
       await page.fill(p.selector, "", { force: true, timeout: 1e4 });
     }
     const isReact = await page.evaluate(() => {
@@ -591,7 +597,7 @@ var fillCommand = registerCommand({
     } else {
       await page.fill(p.selector, p.value, { force: true, timeout: 1e4 });
     }
-    return ok2({ selector: p.selector, value: p.value, cleared: p.clear || false, reactMode: !!isReact });
+    return ok2({ selector: p.selector, value: p.value, cleared: shouldClear, reactMode: !!isReact });
   }
 });
 var typeCommand = registerCommand({
@@ -2125,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");
@@ -6960,7 +6967,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-5CTOA2WS.js");
+    const { findTargetPage } = await import("./browser-U4VWPTS2.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.`);
@@ -8804,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 {`,
@@ -8821,7 +8830,7 @@ var TEMPLATES = {
           `        (sel: string) => document.querySelector(sel)?.textContent ?? '',`,
           `        params.selector || 'body'`,
           `      );`,
-          `      return { ok: true, text };`,
+          `      return ok({ text });`,
           `    },`,
           `  });`,
           `}`
@@ -8829,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")
       }
     ]
   },
@@ -8847,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 {`,
@@ -8861,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 });`,
           `    },`,
           `  });`,
           ``,
@@ -8876,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 });`,
           `    },`,
           `  });`,
           `}`
@@ -8884,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")
       }
     ]
   },
@@ -8902,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 {`,
@@ -8915,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');`,
           `  });`,
           ``,
@@ -8934,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")
       }
     ]
   },
@@ -8952,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 {`,
@@ -8964,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 });`,
           `    },`,
           `  });`,
           ``,
@@ -8974,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'] });`,
           `    },`,
           `  });`,
           `}`
@@ -8983,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")
       }
     ]
   }
@@ -9497,10 +9540,10 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         break;
       }
       case "press": {
-        const key = parsed.value || parsed.remaining[1];
-        if (!sel && !key) outputError("Usage: xbrowser press [selector] <key>");
+        const key = parsed.value || (sel ? parsed.remaining[1] : parsed.remaining[0]);
+        if (!key) outputError("Usage: xbrowser press [selector] <key>");
         cmdName = "press";
-        params = { ...sel ? { selector: sel } : {}, key: key || sel };
+        params = { ...sel ? { selector: sel } : {}, key };
         break;
       }
       case "select": {
@@ -9569,13 +9612,22 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         params = { expression: args.join(" ") };
         break;
       case "scroll": {
-        const direction = args[0] || "down";
-        if (!["up", "down", "left", "right"].includes(direction))
-          outputError("Direction must be: up, down, left, right");
+        let direction = "down";
+        let distance;
+        const firstArg = args[0];
+        if (firstArg && ["up", "down", "left", "right"].includes(firstArg)) {
+          direction = firstArg;
+          if (args[1] && /^\d+$/.test(args[1])) distance = Number(args[1]);
+        } else if (firstArg && /^\d+$/.test(firstArg)) {
+          distance = Number(firstArg);
+        } else if (firstArg) {
+          outputError(`Invalid scroll argument: "${firstArg}". Use up/down/left/right or a pixel number.`);
+        }
+        distance = distance ?? (options.distance ? Number(options.distance) : options.amount ? Number(options.amount) : void 0);
         cmdName = "scroll";
         params = {
           direction,
-          distance: options.distance ? Number(options.distance) : options.amount ? Number(options.amount) : void 0,
+          distance,
           selector: options.selector || options.s
         };
         break;
@@ -9588,6 +9640,14 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         cmdName = "url";
         params = {};
         break;
+      case "set-viewport": {
+        const width = options.width ? Number(options.width) : args[0] ? Number(args[0]) : void 0;
+        const height = options.height ? Number(options.height) : args[1] ? Number(args[1]) : void 0;
+        if (!width || !height) outputError("Usage: xbrowser set-viewport <width> <height>");
+        cmdName = "set-viewport";
+        params = { width, height };
+        break;
+      }
       case "html":
         cmdName = "html";
         params = { selector: options.selector || options.s };
@@ -10124,6 +10184,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;
@@ -12650,7 +12715,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-5CTOA2WS.js");
+      const { ensureProcessCanExit } = await import("./browser-U4VWPTS2.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);

package/dist/daemon-main.js

@@ -21,8 +21,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-LRBSUKUZ.js";
-import "./chunk-N2JFPWMI.js";
+} from "./chunk-MXG2H3HJ.js";
+import "./chunk-SEFIJY2M.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getDaemonConfig,
@@ -304,8 +304,13 @@ var gotoCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     let url = p.url;
-    if (!/^https?:\/\//i.test(url) && !/^wss?:\/\//i.test(url)) {
-      url = "https://" + url;
+    const hasScheme = /^(https?|wss?|file|about|data|chrome|blob):/i.test(url);
+    if (!hasScheme) {
+      if (/^[\w-]+(\.[\w-]+)+/.test(url) || url.startsWith("localhost")) {
+        url = "https://" + url;
+      } else {
+        throw new Error(`Invalid URL: "${url}". Expected http(s)://, file://, about:, data:, or a domain name.`);
+      }
     }
     const response = await ctx.page.goto(url, {
       waitUntil: p.waitUntil || "domcontentloaded"
@@ -360,7 +365,7 @@ var urlCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    return ok({ url: ctx.page.url() });
+    return ok({ url: ctx.page.url() || "about:blank" });
   }
 });
 registerCommand({
@@ -523,7 +528,8 @@ var fillCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     const page = ctx.page;
-    if (p.clear) {
+    const shouldClear = p.clear !== false;
+    if (shouldClear) {
       await page.fill(p.selector, "", { force: true, timeout: 1e4 });
     }
     const isReact = await page.evaluate(() => {
@@ -549,7 +555,7 @@ var fillCommand = registerCommand({
     } else {
       await page.fill(p.selector, p.value, { force: true, timeout: 1e4 });
     }
-    return ok2({ selector: p.selector, value: p.value, cleared: p.clear || false, reactMode: !!isReact });
+    return ok2({ selector: p.selector, value: p.value, cleared: shouldClear, reactMode: !!isReact });
   }
 });
 var typeCommand = registerCommand({
@@ -2083,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");
@@ -6918,7 +6925,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-ITLZZDHJ.js");
+    const { findTargetPage } = await import("./browser-AXCKBSWS.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.`);
@@ -8602,7 +8609,7 @@ function createRPCHandler() {
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {
       try {
-        const { SessionReplayer } = await import("./session-replayer-MY27H4DX.js");
+        const { SessionReplayer } = await import("./session-replayer-GCGY6KFK.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-TWWOIJM7.js";
-import "./chunk-N2JFPWMI.js";
+} from "./chunk-5QAYN5EZ.js";
+import "./chunk-SEFIJY2M.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -386,8 +386,13 @@ var gotoCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     let url = p.url;
-    if (!/^https?:\/\//i.test(url) && !/^wss?:\/\//i.test(url)) {
-      url = "https://" + url;
+    const hasScheme = /^(https?|wss?|file|about|data|chrome|blob):/i.test(url);
+    if (!hasScheme) {
+      if (/^[\w-]+(\.[\w-]+)+/.test(url) || url.startsWith("localhost")) {
+        url = "https://" + url;
+      } else {
+        throw new Error(`Invalid URL: "${url}". Expected http(s)://, file://, about:, data:, or a domain name.`);
+      }
     }
     const response = await ctx.page.goto(url, {
       waitUntil: p.waitUntil || "domcontentloaded"
@@ -442,7 +447,7 @@ var urlCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    return ok({ url: ctx.page.url() });
+    return ok({ url: ctx.page.url() || "about:blank" });
   }
 });
 registerCommand({
@@ -605,7 +610,8 @@ var fillCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     const page = ctx.page;
-    if (p.clear) {
+    const shouldClear = p.clear !== false;
+    if (shouldClear) {
       await page.fill(p.selector, "", { force: true, timeout: 1e4 });
     }
     const isReact = await page.evaluate(() => {
@@ -631,7 +637,7 @@ var fillCommand = registerCommand({
     } else {
       await page.fill(p.selector, p.value, { force: true, timeout: 1e4 });
     }
-    return ok2({ selector: p.selector, value: p.value, cleared: p.clear || false, reactMode: !!isReact });
+    return ok2({ selector: p.selector, value: p.value, cleared: shouldClear, reactMode: !!isReact });
   }
 });
 var typeCommand = registerCommand({
@@ -2165,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");
@@ -7280,7 +7287,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-IUJXXNBT.js");
+    const { findTargetPage } = await import("./browser-X7OVRKJH.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.`);
@@ -9139,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 {`,
@@ -9156,7 +9165,7 @@ var TEMPLATES = {
           `        (sel: string) => document.querySelector(sel)?.textContent ?? '',`,
           `        params.selector || 'body'`,
           `      );`,
-          `      return { ok: true, text };`,
+          `      return ok({ text });`,
           `    },`,
           `  });`,
           `}`
@@ -9164,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")
       }
     ]
   },
@@ -9182,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 {`,
@@ -9196,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 });`,
           `    },`,
           `  });`,
           ``,
@@ -9211,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 });`,
           `    },`,
           `  });`,
           `}`
@@ -9219,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")
       }
     ]
   },
@@ -9237,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 {`,
@@ -9250,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');`,
           `  });`,
           ``,
@@ -9269,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")
       }
     ]
   },
@@ -9287,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 {`,
@@ -9299,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 });`,
           `    },`,
           `  });`,
           ``,
@@ -9309,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'] });`,
           `    },`,
           `  });`,
           `}`
@@ -9318,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")
       }
     ]
   }
@@ -9837,10 +9880,10 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         break;
       }
       case "press": {
-        const key = parsed.value || parsed.remaining[1];
-        if (!sel && !key) outputError("Usage: xbrowser press [selector] <key>");
+        const key = parsed.value || (sel ? parsed.remaining[1] : parsed.remaining[0]);
+        if (!key) outputError("Usage: xbrowser press [selector] <key>");
         cmdName = "press";
-        params = { ...sel ? { selector: sel } : {}, key: key || sel };
+        params = { ...sel ? { selector: sel } : {}, key };
         break;
       }
       case "select": {
@@ -9909,13 +9952,22 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         params = { expression: args.join(" ") };
         break;
       case "scroll": {
-        const direction = args[0] || "down";
-        if (!["up", "down", "left", "right"].includes(direction))
-          outputError("Direction must be: up, down, left, right");
+        let direction = "down";
+        let distance;
+        const firstArg = args[0];
+        if (firstArg && ["up", "down", "left", "right"].includes(firstArg)) {
+          direction = firstArg;
+          if (args[1] && /^\d+$/.test(args[1])) distance = Number(args[1]);
+        } else if (firstArg && /^\d+$/.test(firstArg)) {
+          distance = Number(firstArg);
+        } else if (firstArg) {
+          outputError(`Invalid scroll argument: "${firstArg}". Use up/down/left/right or a pixel number.`);
+        }
+        distance = distance ?? (options.distance ? Number(options.distance) : options.amount ? Number(options.amount) : void 0);
         cmdName = "scroll";
         params = {
           direction,
-          distance: options.distance ? Number(options.distance) : options.amount ? Number(options.amount) : void 0,
+          distance,
           selector: options.selector || options.s
         };
         break;
@@ -9928,6 +9980,14 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
         cmdName = "url";
         params = {};
         break;
+      case "set-viewport": {
+        const width = options.width ? Number(options.width) : args[0] ? Number(args[0]) : void 0;
+        const height = options.height ? Number(options.height) : args[1] ? Number(args[1]) : void 0;
+        if (!width || !height) outputError("Usage: xbrowser set-viewport <width> <height>");
+        cmdName = "set-viewport";
+        params = { width, height };
+        break;
+      }
       case "html":
         cmdName = "html";
         params = { selector: options.selector || options.s };
@@ -10464,6 +10524,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;
@@ -15777,7 +15842,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-D6WMSMWX.js");
+    const { launch } = await import("./cdp-driver-ZAVN7GRB.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-MY27H4DX.js → session-replayer-GCGY6KFK.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-D6WMSMWX.js");
+      const { launch } = await import("./cdp-driver-ZAVN7GRB.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.5",
+  "version": "1.0.7",
   "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": {