@xbrowser/cli 1.4.4 → 1.4.5

package/README.md

@@ -1,6 +1,6 @@
 # xbrowser
 
-> **Browser automation CLI** for web scraping, headless browsing, SEO analysis, and AI agent workflows. 50 commands, 20+ 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. 51 commands, 70+ 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)

package/dist/{browser-KBUORWR3.js → browser-2OALOLR2.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-X3FKWJV4.js";
+} from "./chunk-Z6GGTJL5.js";
 import "./chunk-IDJ5NILK.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{browser-DS24BWJW.js → browser-5CM4GUZU.js}

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

package/dist/{browser-YKJO3BOQ.js → browser-V3VHXQQF.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-4W54GEMV.js";
+} from "./chunk-SMRIC22G.js";
 import "./chunk-IDJ5NILK.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{chunk-CFPPWKVO.js → chunk-NW3WE5JK.js}

@@ -4274,21 +4274,27 @@ 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
+    const ports = [9222, 9221, 9223, 9224];
+    for (const port of ports) {
+      try {
+        const httpResp = await fetchNoProxy(`http://localhost:${port}/json/version`);
+        if (httpResp.ok) {
+          const data = await httpResp.json();
+          if (data.webSocketDebuggerUrl) {
+            return data.webSocketDebuggerUrl;
+          }
+        }
+      } catch {
+      }
+    }
+    throw new Error(
+      `Could not auto-discover CDP endpoint. Tried ports: ${ports.join(", ")}.
+\u53EF\u80FD\u539F\u56E0\uFF1A\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
+  1. \u542F\u52A8 Chrome: google-chrome --remote-debugging-port=9222
+  2. \u6216\u7528 cdp-tunnel: 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");
-    }
-    return data.webSocketDebuggerUrl;
+    );
   }
   if (/^\d+$/.test(raw)) {
     const port = raw;

package/dist/{chunk-4W54GEMV.js → chunk-SMRIC22G.js}

@@ -1400,21 +1400,27 @@ 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
+    const ports = [9222, 9221, 9223, 9224];
+    for (const port of ports) {
+      try {
+        const httpResp = await fetchNoProxy(`http://localhost:${port}/json/version`);
+        if (httpResp.ok) {
+          const data = await httpResp.json();
+          if (data.webSocketDebuggerUrl) {
+            return data.webSocketDebuggerUrl;
+          }
+        }
+      } catch {
+      }
+    }
+    throw new Error(
+      `Could not auto-discover CDP endpoint. Tried ports: ${ports.join(", ")}.
+\u53EF\u80FD\u539F\u56E0\uFF1A\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
+  1. \u542F\u52A8 Chrome: google-chrome --remote-debugging-port=9222
+  2. \u6216\u7528 cdp-tunnel: 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");
-    }
-    return data.webSocketDebuggerUrl;
+    );
   }
   if (/^\d+$/.test(raw)) {
     const port = raw;

package/dist/{chunk-X3FKWJV4.js → chunk-Z6GGTJL5.js}

@@ -35,21 +35,27 @@ 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
+    const ports = [9222, 9221, 9223, 9224];
+    for (const port of ports) {
+      try {
+        const httpResp = await fetchNoProxy(`http://localhost:${port}/json/version`);
+        if (httpResp.ok) {
+          const data = await httpResp.json();
+          if (data.webSocketDebuggerUrl) {
+            return data.webSocketDebuggerUrl;
+          }
+        }
+      } catch {
+      }
+    }
+    throw new Error(
+      `Could not auto-discover CDP endpoint. Tried ports: ${ports.join(", ")}.
+\u53EF\u80FD\u539F\u56E0\uFF1A\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
+  1. \u542F\u52A8 Chrome: google-chrome --remote-debugging-port=9222
+  2. \u6216\u7528 cdp-tunnel: 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");
-    }
-    return data.webSocketDebuggerUrl;
+    );
   }
   if (/^\d+$/.test(raw)) {
     const port = raw;

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-CFPPWKVO.js";
+} from "./chunk-NW3WE5JK.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -397,8 +397,13 @@ var refreshCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    await ctx.page.reload();
-    return ok({ url: ctx.page.url() });
+    try {
+      await ctx.page.reload();
+    } catch (err) {
+      return fail(`Refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const url = await ctx.page.evaluate("location.href").catch(() => ctx.page.url());
+    return ok({ url });
   }
 });
 var titleCommand = registerCommand({
@@ -417,7 +422,8 @@ var urlCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    return ok({ url: ctx.page.url() || "about:blank" });
+    const url = await ctx.page.evaluate("location.href").catch(() => ctx.page.url() || "about:blank");
+    return ok({ url });
   }
 });
 registerCommand({
@@ -7077,7 +7083,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-DS24BWJW.js");
+    const { findTargetPage } = await import("./browser-5CM4GUZU.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.`);
@@ -11846,18 +11852,6 @@ function printChainResult(chainResult) {
     console.error(`Stopped: ${chainResult.stoppedReason}`);
   }
 }
-function printChainResultBrief(chainResult) {
-  for (const step of chainResult.steps) {
-    if (step.success) {
-      console.log(`[OK] ${step.raw}`);
-    } else {
-      console.error(`[FAIL] ${step.raw}: ${step.message}`);
-    }
-  }
-  if (chainResult.stoppedReason) {
-    console.error(`Stopped: ${chainResult.stoppedReason}`);
-  }
-}
 
 // src/server/http-server.ts
 import { createServer } from "http";
@@ -12386,10 +12380,10 @@ function extractSessionNameFromArgv(argv) {
 async function handleEvalMode(argv) {
   const evalCommands = parseEvalFlags(argv);
   if (evalCommands.length === 0) return;
-  const chain = evalCommands.join(" && ");
+  const chain = evalCommands.join(" ; ");
   const cdpEndpoint = extractCdpFromArgv(argv);
   const chainResult = await executeChain(chain, { cdpEndpoint });
-  printChainResultBrief(chainResult);
+  printChainResult(chainResult);
   if (!chainResult.success) throw new Error("Command failed");
 }
 async function handleChainInput(input, argv) {
@@ -12433,12 +12427,8 @@ async function routeCommand(argvIn, stdinCommands) {
       const possibleCmd = argv[0].substring(0, spaceIdx);
       if (/^[a-zA-Z][\w-]*$/.test(possibleCmd)) {
         const remainder = argv[0].substring(spaceIdx + 1);
-        if (remainder.includes("--")) {
-          const remainderParts = remainder.split(/\s+/).filter(Boolean);
-          argv = [possibleCmd, ...remainderParts, ...argv.slice(1)];
-        } else {
-          argv = [possibleCmd, remainder, ...argv.slice(1)];
-        }
+        const remainderParts = remainder.split(/\s+/).filter(Boolean);
+        argv = [possibleCmd, ...remainderParts, ...argv.slice(1)];
       }
     }
   } catch (e) {
@@ -13049,7 +13039,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-DS24BWJW.js");
+      const { ensureProcessCanExit } = await import("./browser-5CM4GUZU.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);

package/dist/daemon-main.js

@@ -21,7 +21,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-4W54GEMV.js";
+} from "./chunk-SMRIC22G.js";
 import "./chunk-IDJ5NILK.js";
 import "./chunk-TNEN6VQ2.js";
 import {
@@ -358,8 +358,13 @@ var refreshCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    await ctx.page.reload();
-    return ok({ url: ctx.page.url() });
+    try {
+      await ctx.page.reload();
+    } catch (err) {
+      return fail(`Refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const url = await ctx.page.evaluate("location.href").catch(() => ctx.page.url());
+    return ok({ url });
   }
 });
 var titleCommand = registerCommand({
@@ -378,7 +383,8 @@ var urlCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    return ok({ url: ctx.page.url() || "about:blank" });
+    const url = await ctx.page.evaluate("location.href").catch(() => ctx.page.url() || "about:blank");
+    return ok({ url });
   }
 });
 registerCommand({
@@ -6608,7 +6614,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-YKJO3BOQ.js");
+    const { findTargetPage } = await import("./browser-V3VHXQQF.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.`);

package/dist/index.js

@@ -81,7 +81,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-X3FKWJV4.js";
+} from "./chunk-Z6GGTJL5.js";
 import "./chunk-IDJ5NILK.js";
 import "./chunk-TNEN6VQ2.js";
 import {
@@ -437,8 +437,13 @@ var refreshCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    await ctx.page.reload();
-    return ok({ url: ctx.page.url() });
+    try {
+      await ctx.page.reload();
+    } catch (err) {
+      return fail(`Refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const url = await ctx.page.evaluate("location.href").catch(() => ctx.page.url());
+    return ok({ url });
   }
 });
 var titleCommand = registerCommand({
@@ -457,7 +462,8 @@ var urlCommand = registerCommand({
   scope: "page",
   result: z.object({ url: z.string() }),
   handler: async (_p, ctx) => {
-    return ok({ url: ctx.page.url() || "about:blank" });
+    const url = await ctx.page.evaluate("location.href").catch(() => ctx.page.url() || "about:blank");
+    return ok({ url });
   }
 });
 registerCommand({
@@ -7397,7 +7403,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-KBUORWR3.js");
+    const { findTargetPage } = await import("./browser-2OALOLR2.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.`);
@@ -12186,18 +12192,6 @@ function printChainResult(chainResult) {
     console.error(`Stopped: ${chainResult.stoppedReason}`);
   }
 }
-function printChainResultBrief(chainResult) {
-  for (const step of chainResult.steps) {
-    if (step.success) {
-      console.log(`[OK] ${step.raw}`);
-    } else {
-      console.error(`[FAIL] ${step.raw}: ${step.message}`);
-    }
-  }
-  if (chainResult.stoppedReason) {
-    console.error(`Stopped: ${chainResult.stoppedReason}`);
-  }
-}
 
 // src/server/http-server.ts
 import { createServer } from "http";
@@ -12726,10 +12720,10 @@ function extractSessionNameFromArgv(argv) {
 async function handleEvalMode(argv) {
   const evalCommands = parseEvalFlags(argv);
   if (evalCommands.length === 0) return;
-  const chain = evalCommands.join(" && ");
+  const chain = evalCommands.join(" ; ");
   const cdpEndpoint = extractCdpFromArgv(argv);
   const chainResult = await executeChain(chain, { cdpEndpoint });
-  printChainResultBrief(chainResult);
+  printChainResult(chainResult);
   if (!chainResult.success) throw new Error("Command failed");
 }
 async function handleChainInput(input, argv) {
@@ -12773,12 +12767,8 @@ async function routeCommand(argvIn, stdinCommands) {
       const possibleCmd = argv[0].substring(0, spaceIdx);
       if (/^[a-zA-Z][\w-]*$/.test(possibleCmd)) {
         const remainder = argv[0].substring(spaceIdx + 1);
-        if (remainder.includes("--")) {
-          const remainderParts = remainder.split(/\s+/).filter(Boolean);
-          argv = [possibleCmd, ...remainderParts, ...argv.slice(1)];
-        } else {
-          argv = [possibleCmd, remainder, ...argv.slice(1)];
-        }
+        const remainderParts = remainder.split(/\s+/).filter(Boolean);
+        argv = [possibleCmd, ...remainderParts, ...argv.slice(1)];
       }
     }
   } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "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": {