@xbrowser/cli 1.0.4 → 1.0.6

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({
@@ -6960,7 +6966,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.`);
@@ -9497,10 +9503,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 +9575,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 +9603,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 };
@@ -9760,7 +9783,16 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
   } else if (!result.success) {
     outputError(result.message || "Command failed");
   } else {
-    outputResult(result.data, mode);
+    const data = result.data;
+    const isEmptyResult = data && typeof data === "object" && Object.values(data).every((v) => v === "" || v === null || v === void 0);
+    if (isEmptyResult) {
+      const hint = cdpEndpoint ? `\u53EF\u80FD\u672A\u8FDE\u63A5\u5230\u6D4F\u89C8\u5668\u3002\u8BF7\u786E\u8BA4 ${cdpEndpoint} \u4E0A\u6709 Chrome \u8FD0\u884C\uFF08--remote-debugging-port\uFF09\u3002` : "\u53EF\u80FD\u672A\u8FDE\u63A5\u5230\u6D4F\u89C8\u5668\u3002\u8BF7\u4F7F\u7528 --cdp <endpoint> \u8FDE\u63A5\uFF0C\u6216\u5B89\u88C5 cdp-tunnel \u590D\u7528\u5DF2\u6709 Chrome\u3002";
+      outputResult(result.data, mode);
+      console.error(`
+  \u26A0\uFE0F  ${hint}`);
+    } else {
+      outputResult(result.data, mode);
+    }
   }
 }
 
@@ -12046,7 +12078,8 @@ async function handleChainInput(input, argv) {
   }
   if (!chainResult.success) throw new Error("Command failed");
 }
-async function routeCommand(argv, stdinCommands) {
+async function routeCommand(argvIn, stdinCommands) {
+  let argv = argvIn;
   try {
     if (stdinCommands && stdinCommands.length > 0) {
       await handleStdinMode(stdinCommands, argv);
@@ -12060,6 +12093,13 @@ async function routeCommand(argv, stdinCommands) {
       await handleChainInput(argv[0], argv);
       return;
     }
+    if (argv[0] && argv[0].includes(" ")) {
+      const spaceIdx = argv[0].indexOf(" ");
+      const possibleCmd = argv[0].substring(0, spaceIdx);
+      if (/^[a-zA-Z][\w-]*$/.test(possibleCmd)) {
+        argv = [possibleCmd, argv[0].substring(spaceIdx + 1), ...argv.slice(1)];
+      }
+    }
   } catch (e) {
     outputError(e instanceof Error ? e.message : String(e));
     return;
@@ -12633,7 +12673,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({
@@ -6918,7 +6924,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 +8608,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.d.ts

@@ -1267,7 +1267,7 @@ interface AISearchResult {
  * @param argv - Raw CLI argument array (typically `process.argv.slice(2)`).
  * @param stdinCommands - Optional array of commands read from stdin.
  */
-declare function routeCommand(argv: string[], stdinCommands?: string[]): Promise<void>;
+declare function routeCommand(argvIn: string[], stdinCommands?: string[]): Promise<void>;
 
 /**
  * Open a new browser session, navigate to the given URL, and persist session metadata.

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({
@@ -7280,7 +7286,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.`);
@@ -9837,10 +9843,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 +9915,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 +9943,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 };
@@ -10100,7 +10123,16 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
   } else if (!result.success) {
     outputError(result.message || "Command failed");
   } else {
-    outputResult(result.data, mode);
+    const data = result.data;
+    const isEmptyResult = data && typeof data === "object" && Object.values(data).every((v) => v === "" || v === null || v === void 0);
+    if (isEmptyResult) {
+      const hint = cdpEndpoint ? `\u53EF\u80FD\u672A\u8FDE\u63A5\u5230\u6D4F\u89C8\u5668\u3002\u8BF7\u786E\u8BA4 ${cdpEndpoint} \u4E0A\u6709 Chrome \u8FD0\u884C\uFF08--remote-debugging-port\uFF09\u3002` : "\u53EF\u80FD\u672A\u8FDE\u63A5\u5230\u6D4F\u89C8\u5668\u3002\u8BF7\u4F7F\u7528 --cdp <endpoint> \u8FDE\u63A5\uFF0C\u6216\u5B89\u88C5 cdp-tunnel \u590D\u7528\u5DF2\u6709 Chrome\u3002";
+      outputResult(result.data, mode);
+      console.error(`
+  \u26A0\uFE0F  ${hint}`);
+    } else {
+      outputResult(result.data, mode);
+    }
   }
 }
 
@@ -12386,7 +12418,8 @@ async function handleChainInput(input, argv) {
   }
   if (!chainResult.success) throw new Error("Command failed");
 }
-async function routeCommand(argv, stdinCommands) {
+async function routeCommand(argvIn, stdinCommands) {
+  let argv = argvIn;
   try {
     if (stdinCommands && stdinCommands.length > 0) {
       await handleStdinMode(stdinCommands, argv);
@@ -12400,6 +12433,13 @@ async function routeCommand(argv, stdinCommands) {
       await handleChainInput(argv[0], argv);
       return;
     }
+    if (argv[0] && argv[0].includes(" ")) {
+      const spaceIdx = argv[0].indexOf(" ");
+      const possibleCmd = argv[0].substring(0, spaceIdx);
+      if (/^[a-zA-Z][\w-]*$/.test(possibleCmd)) {
+        argv = [possibleCmd, argv[0].substring(spaceIdx + 1), ...argv.slice(1)];
+      }
+    }
   } catch (e) {
     outputError(e instanceof Error ? e.message : String(e));
     return;
@@ -15760,7 +15800,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.4",
+  "version": "1.0.6",
   "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": {