@xbrowser/cli 1.23.1 → 1.24.1

package/dist/{chunk-LFX24QJZ.js → chunk-5PZXCIDR.js}

@@ -7123,7 +7123,7 @@ function attachWaitForHuman(ctx, getOrCreateWSServer) {
     if (!ctx.page) {
       throw new Error("waitForHuman requires an active page");
     }
-    const { HumanInteractionManager } = await import("./human-interaction-DK6QGYNC.js");
+    const { HumanInteractionManager } = await import("./human-interaction-HJCK45SL.js");
     const wsServer2 = await getOrCreateWSServer(ctx.browserContext);
     const manager = new HumanInteractionManager(wsServer2, ctx.page);
     return manager.waitForHuman(options);
@@ -7146,7 +7146,7 @@ function setWSServerCache(browserContext, server) {
 import {
   Core
 } from "@dyyz1993/xcli-core";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve2, basename, dirname as dirname3 } from "path";
 import { existsSync as existsSync6, readdirSync } from "fs";
 import { homedir as homedir4 } from "os";
 
@@ -7450,6 +7450,8 @@ var XBrowserPluginLoader = class {
   core;
   loader;
   options;
+  /** 目录名 → 该插件注册的 site 名（site.name ≠ 目录名时的命令别名兜底） */
+  dirSiteAliases = /* @__PURE__ */ new Map();
   constructor(options) {
     patchLoginRequired();
     this.options = options ?? {};
@@ -7487,15 +7489,39 @@ var XBrowserPluginLoader = class {
   getLoadedPlugins() {
     return this.loader.getLoadedPlugins();
   }
+  /**
+   * 目录名别名兜底（小白用户实测踩坑）：`plugin list` 显示目录名，但命令路由
+   * 按 site.name 匹配——两者不一致时（如目录 alibaba-1688、site 名 1688），
+   * 用户按 list 显示的名字敲命令会 "Unknown command"。映射在 scanAndLoad/
+   * loadPlugin 时通过加载前后 site 快照 diff 记录（instance.siteName 返回的是
+   * 插件 id 而非 site 名，不可用）。
+   */
+  resolveSiteName(name) {
+    if (this.core.loader.getSite(name)) return name;
+    const aliased = this.dirSiteAliases.get(name);
+    if (aliased && this.core.loader.getSite(aliased)) return aliased;
+    return void 0;
+  }
+  /** 记录一次插件加载引入的 site：加载前后快照 diff（同插件可注册多个 site） */
+  recordSiteAliases(pluginDirName, before) {
+    for (const site of this.core.loader.getSites()) {
+      if (!before.has(site.name)) this.dirSiteAliases.set(pluginDirName, site.name);
+    }
+  }
   getPluginContract(siteName, commandName) {
-    const site = this.core.loader.getSite(siteName);
+    const resolved = this.resolveSiteName(siteName);
+    if (!resolved) return void 0;
+    const site = this.core.loader.getSite(resolved);
     if (!site) return void 0;
     const contract = buildPluginContract(site);
     if (!commandName) return contract;
     return contract.commands.find((command) => command.name === commandName);
   }
   async loadPlugin(pluginPath, id) {
-    return this.loader.loadPlugin(pluginPath, id);
+    const before = new Set(this.core.loader.getSites().map((s) => s.name));
+    const instance = await this.loader.loadPlugin(pluginPath, id);
+    this.recordSiteAliases(basename(dirname3(pluginPath)), before);
+    return instance;
   }
   async unloadPlugin(id) {
     return this.loader.unloadPlugin(id);
@@ -7558,6 +7584,35 @@ var XBrowserPluginLoader = class {
   }
 };
 
+// src/fail-codes.ts
+var FAIL_CODES = {
+  selectorNotFound: "RETRYABLE: selector-not-found",
+  pageNotReady: "RETRYABLE: page-not-ready",
+  elementGone: "RETRYABLE: element-gone",
+  captcha: "HUMAN: captcha",
+  loginWall: "HUMAN: login-wall",
+  permissionDenied: "FATAL: permission-denied",
+  targetGone: "FATAL: target-gone",
+  unknown: "FATAL: unknown"
+};
+function classifyFailure(message) {
+  const msg = (message || "").toLowerCase();
+  const pick = (code) => ({
+    code,
+    level: code.split(":")[0],
+    message: message || code
+  });
+  if (/captcha|验证码|人机校验|recaptcha|hcaptcha|turnstile/.test(msg)) return pick(FAIL_CODES.captcha);
+  if (/login|登录|signin|sign in|未登录|login-required|LOGIN_REQUIRED/.test(msg)) return pick(FAIL_CODES.loginWall);
+  if (/permission|权限|not allowed|forbidden|EACCES/.test(msg)) return pick(FAIL_CODES.permissionDenied);
+  if (/selector|选择器|element not found|未找到元素|no such element|queryselector returned null/.test(msg))
+    return pick(FAIL_CODES.selectorNotFound);
+  if (/timeout|超时|timed out|waiting for/.test(msg)) return pick(FAIL_CODES.pageNotReady);
+  if (/net::err|404|navigation failed|页面不存在|target closed|element-gone/.test(msg))
+    return pick(FAIL_CODES.targetGone);
+  return pick(FAIL_CODES.unknown);
+}
+
 // src/executor.ts
 import {
   ok as ok30,
@@ -8705,7 +8760,16 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       if (isSuccess) {
         return { ...ok30(raw.data, merged.length > 0 ? merged : raw.tips), duration, ...hookOutputs ? { hookOutputs } : {} };
       }
-      return { success: false, data: raw.data, message: raw.message, tips: mergedOrRaw, duration, ...hookOutputs ? { hookOutputs } : {} };
+      const fc = classifyFailure(raw.message);
+      return {
+        success: false,
+        data: raw.data,
+        message: raw.message,
+        tips: mergedOrRaw,
+        duration,
+        error: { code: fc.code, level: fc.level },
+        ...hookOutputs ? { hookOutputs } : {}
+      };
     }
     const smartTipNormalized = normalizeTips6(smartTips);
     recordArchive(session?.id, sessionName, {
@@ -8724,7 +8788,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     const errorMessage = errMsg(err);
     if (session?.page && process.env.XBROWSER_RECOVERY && !extraOpts?._recoveryAttempted) {
       try {
-        const { attemptRecovery } = await import("./recovery-67DMH2OM.js");
+        const { attemptRecovery } = await import("./recovery-IMZUGWSS.js");
         const recovery = await attemptRecovery(
           session.page,
           sessionName,
@@ -8799,7 +8863,8 @@ async function executeChain(input, options) {
         const cmdArgs = parts.slice(1);
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(cmdName);
+        const resolvedName = loader.resolveSiteName(cmdName);
+        const site = resolvedName ? internalLoader.getSite(resolvedName) : void 0;
         if (site) {
           const subCommand = cmdArgs[0];
           if (!subCommand) {
@@ -8840,7 +8905,15 @@ async function executeChain(input, options) {
             continue;
           }
           const pluginArgs = cmdArgs.slice(1);
-          const pluginParams = parsePluginParams(pluginArgs, cmdEntry.parameters);
+          let pluginParams = parsePluginParams(pluginArgs, cmdEntry.parameters);
+          if (cmdEntry.parameters) {
+            const schemaCheck = cmdEntry.parameters.safeParse(pluginParams);
+            if (schemaCheck.success) {
+              for (const [k, v] of Object.entries(schemaCheck.data)) {
+                if (!(k in pluginParams)) pluginParams[k] = v;
+              }
+            }
+          }
           const pluginCtx = {
             args: pluginArgs,
             options: pluginParams,

package/dist/{chunk-TBSS7ES4.js → chunk-AYNFXG7V.js}

@@ -30,6 +30,35 @@ import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
 
+// src/fail-codes.ts
+var FAIL_CODES = {
+  selectorNotFound: "RETRYABLE: selector-not-found",
+  pageNotReady: "RETRYABLE: page-not-ready",
+  elementGone: "RETRYABLE: element-gone",
+  captcha: "HUMAN: captcha",
+  loginWall: "HUMAN: login-wall",
+  permissionDenied: "FATAL: permission-denied",
+  targetGone: "FATAL: target-gone",
+  unknown: "FATAL: unknown"
+};
+function classifyFailure(message) {
+  const msg = (message || "").toLowerCase();
+  const pick = (code) => ({
+    code,
+    level: code.split(":")[0],
+    message: message || code
+  });
+  if (/captcha|验证码|人机校验|recaptcha|hcaptcha|turnstile/.test(msg)) return pick(FAIL_CODES.captcha);
+  if (/login|登录|signin|sign in|未登录|login-required|LOGIN_REQUIRED/.test(msg)) return pick(FAIL_CODES.loginWall);
+  if (/permission|权限|not allowed|forbidden|EACCES/.test(msg)) return pick(FAIL_CODES.permissionDenied);
+  if (/selector|选择器|element not found|未找到元素|no such element|queryselector returned null/.test(msg))
+    return pick(FAIL_CODES.selectorNotFound);
+  if (/timeout|超时|timed out|waiting for/.test(msg)) return pick(FAIL_CODES.pageNotReady);
+  if (/net::err|404|navigation failed|页面不存在|target closed|element-gone/.test(msg))
+    return pick(FAIL_CODES.targetGone);
+  return pick(FAIL_CODES.unknown);
+}
+
 // src/executor.ts
 import {
   ok as ok30,
@@ -7016,7 +7045,7 @@ function attachDetectAntiBot(ctx) {
 import {
   Core
 } from "@dyyz1993/xcli-core";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve2, basename, dirname as dirname3 } from "path";
 import { existsSync as existsSync6, readdirSync } from "fs";
 import { homedir as homedir5 } from "os";
 
@@ -7320,6 +7349,8 @@ var XBrowserPluginLoader = class {
   core;
   loader;
   options;
+  /** 目录名 → 该插件注册的 site 名（site.name ≠ 目录名时的命令别名兜底） */
+  dirSiteAliases = /* @__PURE__ */ new Map();
   constructor(options) {
     patchLoginRequired();
     this.options = options ?? {};
@@ -7357,15 +7388,39 @@ var XBrowserPluginLoader = class {
   getLoadedPlugins() {
     return this.loader.getLoadedPlugins();
   }
+  /**
+   * 目录名别名兜底（小白用户实测踩坑）：`plugin list` 显示目录名，但命令路由
+   * 按 site.name 匹配——两者不一致时（如目录 alibaba-1688、site 名 1688），
+   * 用户按 list 显示的名字敲命令会 "Unknown command"。映射在 scanAndLoad/
+   * loadPlugin 时通过加载前后 site 快照 diff 记录（instance.siteName 返回的是
+   * 插件 id 而非 site 名，不可用）。
+   */
+  resolveSiteName(name) {
+    if (this.core.loader.getSite(name)) return name;
+    const aliased = this.dirSiteAliases.get(name);
+    if (aliased && this.core.loader.getSite(aliased)) return aliased;
+    return void 0;
+  }
+  /** 记录一次插件加载引入的 site：加载前后快照 diff（同插件可注册多个 site） */
+  recordSiteAliases(pluginDirName, before) {
+    for (const site of this.core.loader.getSites()) {
+      if (!before.has(site.name)) this.dirSiteAliases.set(pluginDirName, site.name);
+    }
+  }
   getPluginContract(siteName, commandName) {
-    const site = this.core.loader.getSite(siteName);
+    const resolved = this.resolveSiteName(siteName);
+    if (!resolved) return void 0;
+    const site = this.core.loader.getSite(resolved);
     if (!site) return void 0;
     const contract = buildPluginContract(site);
     if (!commandName) return contract;
     return contract.commands.find((command) => command.name === commandName);
   }
   async loadPlugin(pluginPath, id) {
-    return this.loader.loadPlugin(pluginPath, id);
+    const before = new Set(this.core.loader.getSites().map((s) => s.name));
+    const instance = await this.loader.loadPlugin(pluginPath, id);
+    this.recordSiteAliases(basename(dirname3(pluginPath)), before);
+    return instance;
   }
   async unloadPlugin(id) {
     return this.loader.unloadPlugin(id);
@@ -8385,7 +8440,16 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       if (isSuccess) {
         return { ...ok30(raw.data, merged.length > 0 ? merged : raw.tips), duration, ...hookOutputs ? { hookOutputs } : {} };
       }
-      return { success: false, data: raw.data, message: raw.message, tips: mergedOrRaw, duration, ...hookOutputs ? { hookOutputs } : {} };
+      const fc = classifyFailure(raw.message);
+      return {
+        success: false,
+        data: raw.data,
+        message: raw.message,
+        tips: mergedOrRaw,
+        duration,
+        error: { code: fc.code, level: fc.level },
+        ...hookOutputs ? { hookOutputs } : {}
+      };
     }
     const smartTipNormalized = normalizeTips6(smartTips);
     recordArchive(session?.id, sessionName, {
@@ -8404,7 +8468,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     const errorMessage = errMsg(err);
     if (session?.page && process.env.XBROWSER_RECOVERY && !extraOpts?._recoveryAttempted) {
       try {
-        const { attemptRecovery } = await import("./recovery-6RI2FE3E.js");
+        const { attemptRecovery } = await import("./recovery-EBKORYEU.js");
         const recovery = await attemptRecovery(
           session.page,
           sessionName,
@@ -8479,7 +8543,8 @@ async function executeChain(input, options) {
         const cmdArgs = parts.slice(1);
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(cmdName);
+        const resolvedName = loader.resolveSiteName(cmdName);
+        const site = resolvedName ? internalLoader.getSite(resolvedName) : void 0;
         if (site) {
           const subCommand = cmdArgs[0];
           if (!subCommand) {
@@ -8520,7 +8585,15 @@ async function executeChain(input, options) {
             continue;
           }
           const pluginArgs = cmdArgs.slice(1);
-          const pluginParams = parsePluginParams(pluginArgs, cmdEntry.parameters);
+          let pluginParams = parsePluginParams(pluginArgs, cmdEntry.parameters);
+          if (cmdEntry.parameters) {
+            const schemaCheck = cmdEntry.parameters.safeParse(pluginParams);
+            if (schemaCheck.success) {
+              for (const [k, v] of Object.entries(schemaCheck.data)) {
+                if (!(k in pluginParams)) pluginParams[k] = v;
+              }
+            }
+          }
           const pluginCtx = {
             args: pluginArgs,
             options: pluginParams,

package/dist/{chunk-LPW6QS4M.js → chunk-FNXA6FDM.js}

@@ -251,6 +251,7 @@ var CaptchaDetector = class {
 };
 
 // src/webhook.ts
+import * as os from "os";
 var WebhookNotifier = class {
   url;
   constructor(url) {
@@ -264,11 +265,15 @@ var WebhookNotifier = class {
    */
   async notify(payload) {
     if (!this.url) return false;
+    if (this.isDrelEndpoint(this.url)) {
+      payload = { ...payload, previewUrl: this.lanify(payload.previewUrl) };
+    }
     try {
+      const body = this.isDrelEndpoint(this.url) ? JSON.stringify(this.toDrelPayload(payload)) : JSON.stringify(payload);
       const response = await fetch(this.url, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(payload),
+        body,
         signal: AbortSignal.timeout(5e3)
       });
       return response.ok;
@@ -276,6 +281,39 @@ var WebhookNotifier = class {
       return false;
     }
   }
+  /**
+   * previewUrl 里的 localhost/127.0.0.1 替换为本机局域网 IPv4——
+   * 推送目标是手机，localhost 在手机上不可达；同一 Wi-Fi 下局域网 IP 可达。
+   */
+  lanify(url) {
+    if (!url) return url;
+    if (!url.includes("localhost") && !url.includes("127.0.0.1")) return url;
+    const ips = Object.values(os.networkInterfaces()).flat().filter((i) => !!i && i.family === "IPv4" && !i.internal);
+    if (!ips.length) return url;
+    return url.replace("localhost", ips[0].address).replace("127.0.0.1", ips[0].address);
+  }
+  /** Drel 推送端点识别（api.drel.app/<token>） */
+  isDrelEndpoint(url) {
+    return url.includes("api.drel.app") || url.includes("drel.app");
+  }
+  toDrelPayload(payload) {
+    const eventLabel = {
+      "captcha-detected": "\u26A0\uFE0F \u68C0\u6D4B\u5230\u9A8C\u8BC1\u7801",
+      "captcha-resolved": "\u2705 \u9A8C\u8BC1\u7801\u5DF2\u89E3\u51B3",
+      "session-started": "\u25B6\uFE0F \u4F1A\u8BDD\u5F00\u59CB",
+      "session-ended": "\u23F9 \u4F1A\u8BDD\u7ED3\u675F"
+    };
+    const parts = [];
+    if (payload.reason) parts.push(payload.reason);
+    if (payload.targetUrl) parts.push(`\u76EE\u6807: ${payload.targetUrl}`);
+    if (payload.sessionId) parts.push(`\u4F1A\u8BDD: ${payload.sessionId}`);
+    if (payload.timeout) parts.push(`\u8D85\u65F6: ${payload.timeout}s`);
+    return {
+      title: payload.title || `${eventLabel[payload.event] || payload.event} \u2014 \u9700\u8981\u4F60\u4ECB\u5165`,
+      body: payload.body || parts.join("\n") || payload.event,
+      ...payload.previewUrl ? { url: payload.previewUrl } : {}
+    };
+  }
 };
 
 // src/human-interaction.ts

package/dist/{chunk-A3MORKYR.js → chunk-OSZNJT4U.js}

@@ -2,7 +2,7 @@
 import {
   Core
 } from "@dyyz1993/xcli-core";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve2, basename, dirname } from "path";
 import { existsSync as existsSync3, readdirSync } from "fs";
 import { homedir } from "os";
 
@@ -306,6 +306,8 @@ var XBrowserPluginLoader = class {
   core;
   loader;
   options;
+  /** 目录名 → 该插件注册的 site 名（site.name ≠ 目录名时的命令别名兜底） */
+  dirSiteAliases = /* @__PURE__ */ new Map();
   constructor(options) {
     patchLoginRequired();
     this.options = options ?? {};
@@ -343,15 +345,39 @@ var XBrowserPluginLoader = class {
   getLoadedPlugins() {
     return this.loader.getLoadedPlugins();
   }
+  /**
+   * 目录名别名兜底（小白用户实测踩坑）：`plugin list` 显示目录名，但命令路由
+   * 按 site.name 匹配——两者不一致时（如目录 alibaba-1688、site 名 1688），
+   * 用户按 list 显示的名字敲命令会 "Unknown command"。映射在 scanAndLoad/
+   * loadPlugin 时通过加载前后 site 快照 diff 记录（instance.siteName 返回的是
+   * 插件 id 而非 site 名，不可用）。
+   */
+  resolveSiteName(name) {
+    if (this.core.loader.getSite(name)) return name;
+    const aliased = this.dirSiteAliases.get(name);
+    if (aliased && this.core.loader.getSite(aliased)) return aliased;
+    return void 0;
+  }
+  /** 记录一次插件加载引入的 site：加载前后快照 diff（同插件可注册多个 site） */
+  recordSiteAliases(pluginDirName, before) {
+    for (const site of this.core.loader.getSites()) {
+      if (!before.has(site.name)) this.dirSiteAliases.set(pluginDirName, site.name);
+    }
+  }
   getPluginContract(siteName, commandName) {
-    const site = this.core.loader.getSite(siteName);
+    const resolved = this.resolveSiteName(siteName);
+    if (!resolved) return void 0;
+    const site = this.core.loader.getSite(resolved);
     if (!site) return void 0;
     const contract = buildPluginContract(site);
     if (!commandName) return contract;
     return contract.commands.find((command) => command.name === commandName);
   }
   async loadPlugin(pluginPath, id) {
-    return this.loader.loadPlugin(pluginPath, id);
+    const before = new Set(this.core.loader.getSites().map((s) => s.name));
+    const instance = await this.loader.loadPlugin(pluginPath, id);
+    this.recordSiteAliases(basename(dirname(pluginPath)), before);
+    return instance;
   }
   async unloadPlugin(id) {
     return this.loader.unloadPlugin(id);

package/dist/{chunk-FBQZ3PVD.js → chunk-PGKV24QN.js}

@@ -111,6 +111,7 @@ var CaptchaDetector = class {
 };
 
 // src/webhook.ts
+import * as os from "os";
 var WebhookNotifier = class {
   url;
   constructor(url) {
@@ -124,11 +125,15 @@ var WebhookNotifier = class {
    */
   async notify(payload) {
     if (!this.url) return false;
+    if (this.isDrelEndpoint(this.url)) {
+      payload = { ...payload, previewUrl: this.lanify(payload.previewUrl) };
+    }
     try {
+      const body = this.isDrelEndpoint(this.url) ? JSON.stringify(this.toDrelPayload(payload)) : JSON.stringify(payload);
       const response = await fetch(this.url, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(payload),
+        body,
         signal: AbortSignal.timeout(5e3)
       });
       return response.ok;
@@ -136,6 +141,39 @@ var WebhookNotifier = class {
       return false;
     }
   }
+  /**
+   * previewUrl 里的 localhost/127.0.0.1 替换为本机局域网 IPv4——
+   * 推送目标是手机，localhost 在手机上不可达；同一 Wi-Fi 下局域网 IP 可达。
+   */
+  lanify(url) {
+    if (!url) return url;
+    if (!url.includes("localhost") && !url.includes("127.0.0.1")) return url;
+    const ips = Object.values(os.networkInterfaces()).flat().filter((i) => !!i && i.family === "IPv4" && !i.internal);
+    if (!ips.length) return url;
+    return url.replace("localhost", ips[0].address).replace("127.0.0.1", ips[0].address);
+  }
+  /** Drel 推送端点识别（api.drel.app/<token>） */
+  isDrelEndpoint(url) {
+    return url.includes("api.drel.app") || url.includes("drel.app");
+  }
+  toDrelPayload(payload) {
+    const eventLabel = {
+      "captcha-detected": "\u26A0\uFE0F \u68C0\u6D4B\u5230\u9A8C\u8BC1\u7801",
+      "captcha-resolved": "\u2705 \u9A8C\u8BC1\u7801\u5DF2\u89E3\u51B3",
+      "session-started": "\u25B6\uFE0F \u4F1A\u8BDD\u5F00\u59CB",
+      "session-ended": "\u23F9 \u4F1A\u8BDD\u7ED3\u675F"
+    };
+    const parts = [];
+    if (payload.reason) parts.push(payload.reason);
+    if (payload.targetUrl) parts.push(`\u76EE\u6807: ${payload.targetUrl}`);
+    if (payload.sessionId) parts.push(`\u4F1A\u8BDD: ${payload.sessionId}`);
+    if (payload.timeout) parts.push(`\u8D85\u65F6: ${payload.timeout}s`);
+    return {
+      title: payload.title || `${eventLabel[payload.event] || payload.event} \u2014 \u9700\u8981\u4F60\u4ECB\u5165`,
+      body: payload.body || parts.join("\n") || payload.event,
+      ...payload.previewUrl ? { url: payload.previewUrl } : {}
+    };
+  }
 };
 
 // src/human-interaction.ts

package/dist/{chunk-W44UXZSC.js → chunk-SOPN4XDK.js}

@@ -251,6 +251,7 @@ var CaptchaDetector = class {
 };
 
 // src/webhook.ts
+import * as os from "os";
 var WebhookNotifier = class {
   url;
   constructor(url) {
@@ -264,11 +265,15 @@ var WebhookNotifier = class {
    */
   async notify(payload) {
     if (!this.url) return false;
+    if (this.isDrelEndpoint(this.url)) {
+      payload = { ...payload, previewUrl: this.lanify(payload.previewUrl) };
+    }
     try {
+      const body = this.isDrelEndpoint(this.url) ? JSON.stringify(this.toDrelPayload(payload)) : JSON.stringify(payload);
       const response = await fetch(this.url, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(payload),
+        body,
         signal: AbortSignal.timeout(5e3)
       });
       return response.ok;
@@ -276,6 +281,39 @@ var WebhookNotifier = class {
       return false;
     }
   }
+  /**
+   * previewUrl 里的 localhost/127.0.0.1 替换为本机局域网 IPv4——
+   * 推送目标是手机，localhost 在手机上不可达；同一 Wi-Fi 下局域网 IP 可达。
+   */
+  lanify(url) {
+    if (!url) return url;
+    if (!url.includes("localhost") && !url.includes("127.0.0.1")) return url;
+    const ips = Object.values(os.networkInterfaces()).flat().filter((i) => !!i && i.family === "IPv4" && !i.internal);
+    if (!ips.length) return url;
+    return url.replace("localhost", ips[0].address).replace("127.0.0.1", ips[0].address);
+  }
+  /** Drel 推送端点识别（api.drel.app/<token>） */
+  isDrelEndpoint(url) {
+    return url.includes("api.drel.app") || url.includes("drel.app");
+  }
+  toDrelPayload(payload) {
+    const eventLabel = {
+      "captcha-detected": "\u26A0\uFE0F \u68C0\u6D4B\u5230\u9A8C\u8BC1\u7801",
+      "captcha-resolved": "\u2705 \u9A8C\u8BC1\u7801\u5DF2\u89E3\u51B3",
+      "session-started": "\u25B6\uFE0F \u4F1A\u8BDD\u5F00\u59CB",
+      "session-ended": "\u23F9 \u4F1A\u8BDD\u7ED3\u675F"
+    };
+    const parts = [];
+    if (payload.reason) parts.push(payload.reason);
+    if (payload.targetUrl) parts.push(`\u76EE\u6807: ${payload.targetUrl}`);
+    if (payload.sessionId) parts.push(`\u4F1A\u8BDD: ${payload.sessionId}`);
+    if (payload.timeout) parts.push(`\u8D85\u65F6: ${payload.timeout}s`);
+    return {
+      title: payload.title || `${eventLabel[payload.event] || payload.event} \u2014 \u9700\u8981\u4F60\u4ECB\u5165`,
+      body: payload.body || parts.join("\n") || payload.event,
+      ...payload.previewUrl ? { url: payload.previewUrl } : {}
+    };
+  }
 };
 
 // src/human-interaction.ts

package/dist/cli.js

@@ -16,7 +16,7 @@ import {
   loadHooks,
   parsePluginParams,
   readJsonFile
-} from "./chunk-TBSS7ES4.js";
+} from "./chunk-AYNFXG7V.js";
 import "./chunk-JKVUFP3G.js";
 import {
   forwardCommandLog,
@@ -629,6 +629,9 @@ async function installFromMarketplace(pluginsDir, slug, options) {
   const realSlug = String(plugin.slug || slug);
   try {
     await downloadAndExtractMarketplaceTarball(baseUrl, realSlug, tmpDir, targetDir);
+  } catch (err) {
+    safeCleanup5(targetDir);
+    throw err;
   } finally {
     safeCleanup5(tmpDir);
   }
@@ -802,6 +805,7 @@ function ensureIndexFile(plugin, name, targetDir) {
 }
 
 // src/plugin/installer.ts
+import { safeCleanup as safeCleanup6 } from "@dyyz1993/xcli-core";
 var PluginInstaller = class {
   pluginsDir;
   constructor(pluginsDir) {
@@ -827,31 +831,29 @@ var PluginInstaller = class {
     }
     mkdirSync4(targetDir, { recursive: true });
     const resolvedSource = type === "npm" ? await resolveNpmPackageWithFallback(source) : source;
+    const withCleanup = async (fn) => {
+      try {
+        const r = await fn();
+        await this.fixSharedDeps(targetDir);
+        ensurePluginDependencies(this.pluginsDir);
+        if (!existsSync6(resolve6(targetDir, "index.ts")) && !existsSync6(resolve6(targetDir, "index.js"))) {
+          throw new Error("installed package has no index.ts/js entry");
+        }
+        return r;
+      } catch (err) {
+        safeCleanup6(targetDir);
+        throw err;
+      }
+    };
     switch (type) {
       case "local":
-        return await installFromLocal(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromLocal(source, name, targetDir));
       case "npm":
-        return await installFromNpm(resolvedSource, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromNpm(resolvedSource, name, targetDir));
       case "git":
-        return await installFromGit(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromGit(source, name, targetDir));
       case "url":
-        return await installFromUrl(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromUrl(source, name, targetDir));
     }
   }
   /**
@@ -5816,7 +5818,14 @@ async function routeCommand(argvIn, stdinCommands) {
       default: {
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(command);
+        const resolvedSiteName = loader.resolveSiteName(command);
+        const site = resolvedSiteName ? internalLoader.getSite(resolvedSiteName) : void 0;
+        if (site && resolvedSiteName !== command) {
+          if (mode !== "json" && mode !== "yaml") {
+            process.stderr.write(`\u2139\uFE0F "${command}" \u7684\u547D\u4EE4\u540D\u662F "${resolvedSiteName}"\uFF08\u63D2\u4EF6\u76EE\u5F55\u540D\u4E0E\u7AD9\u70B9\u540D\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u6620\u5C04\uFF09
+`);
+          }
+        }
         if (!site) {
           const globalFlagSet = /* @__PURE__ */ new Set(["--session", "--cdp", "--json", "--yaml", "--help", "-h", "--version", "--output", "-o"]);
           const cleanParts = [];
@@ -5957,6 +5966,14 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
           if (options.target && !params._target) {
             params._target = options.target;
           }
+          if (cmdEntry.parameters) {
+            const schemaFill = cmdEntry.parameters.safeParse(params);
+            if (schemaFill.success) {
+              for (const [k, v] of Object.entries(schemaFill.data)) {
+                if (!(k in params)) params[k] = v;
+              }
+            }
+          }
           const needsBrowser = cmdEntry.scope === "page" || cmdEntry.scope === "browser";
           if (needsBrowser && !process.env.XBROWSER_DAEMON_WORKER) {
             const { forwardPluginExec } = await import("./daemon-client-HEGAXWGK.js");
@@ -6264,7 +6281,7 @@ async function handleRemote(args, options, mode) {
   }
 }
 async function startMcpServer() {
-  const { startMcpStdio } = await import("./server-HU4F5KN7.js");
+  const { startMcpStdio } = await import("./server-KSHSG4TY.js");
   startMcpStdio();
 }
 

package/dist/daemon-main.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-JKVUFP3G.js";
 import {
   getPluginLoader
-} from "./chunk-A3MORKYR.js";
+} from "./chunk-OSZNJT4U.js";
 import {
   version
 } from "./chunk-43TEMG4U.js";
@@ -69,6 +69,35 @@ import {
   removeSession
 } from "@dyyz1993/xcli-core";
 
+// src/fail-codes.ts
+var FAIL_CODES = {
+  selectorNotFound: "RETRYABLE: selector-not-found",
+  pageNotReady: "RETRYABLE: page-not-ready",
+  elementGone: "RETRYABLE: element-gone",
+  captcha: "HUMAN: captcha",
+  loginWall: "HUMAN: login-wall",
+  permissionDenied: "FATAL: permission-denied",
+  targetGone: "FATAL: target-gone",
+  unknown: "FATAL: unknown"
+};
+function classifyFailure(message) {
+  const msg = (message || "").toLowerCase();
+  const pick = (code) => ({
+    code,
+    level: code.split(":")[0],
+    message: message || code
+  });
+  if (/captcha|验证码|人机校验|recaptcha|hcaptcha|turnstile/.test(msg)) return pick(FAIL_CODES.captcha);
+  if (/login|登录|signin|sign in|未登录|login-required|LOGIN_REQUIRED/.test(msg)) return pick(FAIL_CODES.loginWall);
+  if (/permission|权限|not allowed|forbidden|EACCES/.test(msg)) return pick(FAIL_CODES.permissionDenied);
+  if (/selector|选择器|element not found|未找到元素|no such element|queryselector returned null/.test(msg))
+    return pick(FAIL_CODES.selectorNotFound);
+  if (/timeout|超时|timed out|waiting for/.test(msg)) return pick(FAIL_CODES.pageNotReady);
+  if (/net::err|404|navigation failed|页面不存在|target closed|element-gone/.test(msg))
+    return pick(FAIL_CODES.targetGone);
+  return pick(FAIL_CODES.unknown);
+}
+
 // src/executor.ts
 import {
   ok as ok30,
@@ -7966,7 +7995,16 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       if (isSuccess) {
         return { ...ok30(raw.data, merged.length > 0 ? merged : raw.tips), duration, ...hookOutputs ? { hookOutputs } : {} };
       }
-      return { success: false, data: raw.data, message: raw.message, tips: mergedOrRaw, duration, ...hookOutputs ? { hookOutputs } : {} };
+      const fc = classifyFailure(raw.message);
+      return {
+        success: false,
+        data: raw.data,
+        message: raw.message,
+        tips: mergedOrRaw,
+        duration,
+        error: { code: fc.code, level: fc.level },
+        ...hookOutputs ? { hookOutputs } : {}
+      };
     }
     const smartTipNormalized = normalizeTips6(smartTips);
     recordArchive(session?.id, sessionName, {
@@ -7985,7 +8023,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     const errorMessage = errMsg(err);
     if (session?.page && process.env.XBROWSER_RECOVERY && !extraOpts?._recoveryAttempted) {
       try {
-        const { attemptRecovery } = await import("./recovery-LGY25LIM.js");
+        const { attemptRecovery } = await import("./recovery-5C4FBA5O.js");
         const recovery = await attemptRecovery(
           session.page,
           sessionName,
@@ -8060,7 +8098,8 @@ async function executeChain(input, options) {
         const cmdArgs = parts.slice(1);
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(cmdName);
+        const resolvedName = loader.resolveSiteName(cmdName);
+        const site = resolvedName ? internalLoader.getSite(resolvedName) : void 0;
         if (site) {
           const subCommand = cmdArgs[0];
           if (!subCommand) {
@@ -8101,7 +8140,15 @@ async function executeChain(input, options) {
             continue;
           }
           const pluginArgs = cmdArgs.slice(1);
-          const pluginParams = parsePluginParams(pluginArgs, cmdEntry.parameters);
+          let pluginParams = parsePluginParams(pluginArgs, cmdEntry.parameters);
+          if (cmdEntry.parameters) {
+            const schemaCheck = cmdEntry.parameters.safeParse(pluginParams);
+            if (schemaCheck.success) {
+              for (const [k, v] of Object.entries(schemaCheck.data)) {
+                if (!(k in pluginParams)) pluginParams[k] = v;
+              }
+            }
+          }
           const pluginCtx = {
             args: pluginArgs,
             options: pluginParams,
@@ -9025,7 +9072,7 @@ function createRPCHandler() {
       return result;
     } catch (err) {
       const errorMessage = errMsg(err);
-      const { attemptRecovery } = await import("./recovery-LGY25LIM.js");
+      const { attemptRecovery } = await import("./recovery-5C4FBA5O.js");
       const recovery = await attemptRecovery(
         session?.page,
         sessionName,
@@ -9192,9 +9239,9 @@ function createRPCHandler() {
     return result;
   }
   async function handlePluginsReload() {
-    const { resetPluginLoader } = await import("./plugin-singleton-GJO7EZXB.js");
+    const { resetPluginLoader } = await import("./plugin-singleton-GGSBI3EG.js");
     resetPluginLoader();
-    const loader = await import("./plugin-singleton-GJO7EZXB.js").then((m) => m.getPluginLoader());
+    const loader = await import("./plugin-singleton-GGSBI3EG.js").then((m) => m.getPluginLoader());
     const sites = loader.getCore().loader.getSites();
     return { ok: true, plugins: sites.length };
   }

package/dist/{human-interaction-MXST5ZQM.js → human-interaction-CTZ4IWXJ.js}

@@ -1,6 +1,6 @@
 import {
   HumanInteractionManager
-} from "./chunk-FBQZ3PVD.js";
+} from "./chunk-PGKV24QN.js";
 import "./chunk-HBMEFSTB.js";
 import "./chunk-KFQGP6VL.js";
 export {

package/dist/{human-interaction-67K43B4O.js → human-interaction-HJCK45SL.js}

@@ -1,6 +1,6 @@
 import {
   HumanInteractionManager
-} from "./chunk-LPW6QS4M.js";
+} from "./chunk-SOPN4XDK.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-KFQGP6VL.js";
 export {

package/dist/{human-interaction-DK6QGYNC.js → human-interaction-V3VDGHHI.js}

@@ -1,6 +1,6 @@
 import {
   HumanInteractionManager
-} from "./chunk-W44UXZSC.js";
+} from "./chunk-FNXA6FDM.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-KFQGP6VL.js";
 export {

package/dist/index.d.ts

@@ -836,6 +836,10 @@ interface ExecutionResult {
     duration: number;
     tips?: Tip[];
     hookOutputs?: HookOutput[];
+    error?: {
+        code: string;
+        level: string;
+    };
 }
 /**
  * Result of a single step within a command chain execution.
@@ -1630,6 +1634,8 @@ declare class XBrowserPluginLoader {
     private core;
     private loader;
     private options;
+    /** 目录名 → 该插件注册的 site 名（site.name ≠ 目录名时的命令别名兜底） */
+    private dirSiteAliases;
     constructor(options?: PluginLoaderOptions);
     getAPI(): XCLIAPI;
     /**
@@ -1640,6 +1646,16 @@ declare class XBrowserPluginLoader {
     getPlugin(id: string): PluginInstance | undefined;
     getPluginStatus(id: string): PluginStatus;
     getLoadedPlugins(): PluginInstance[];
+    /**
+     * 目录名别名兜底（小白用户实测踩坑）：`plugin list` 显示目录名，但命令路由
+     * 按 site.name 匹配——两者不一致时（如目录 alibaba-1688、site 名 1688），
+     * 用户按 list 显示的名字敲命令会 "Unknown command"。映射在 scanAndLoad/
+     * loadPlugin 时通过加载前后 site 快照 diff 记录（instance.siteName 返回的是
+     * 插件 id 而非 site 名，不可用）。
+     */
+    resolveSiteName(name: string): string | undefined;
+    /** 记录一次插件加载引入的 site：加载前后快照 diff（同插件可注册多个 site） */
+    private recordSiteAliases;
     getPluginContract(siteName: string, commandName?: string): PluginContract | PluginCommandContract | undefined;
     loadPlugin(pluginPath: string, id?: string): Promise<PluginInstance>;
     unloadPlugin(id: string): Promise<void>;
@@ -2488,6 +2504,10 @@ interface WebhookPayload {
     previewUrl?: string;
     targetUrl?: string;
     timeout?: number;
+    /** Drel 等推送服务的通知标题（可选；缺省由 event 推导） */
+    title?: string;
+    /** Drel 等推送服务的通知正文（可选；缺省由其余字段拼装） */
+    body?: string;
 }
 /**
  * Sends webhook notifications for browser automation lifecycle events.
@@ -2505,6 +2525,14 @@ declare class WebhookNotifier {
      * @returns `true` if the request succeeded (HTTP 2xx), `false` otherwise.
      */
     notify(payload: WebhookPayload): Promise<boolean>;
+    /**
+     * previewUrl 里的 localhost/127.0.0.1 替换为本机局域网 IPv4——
+     * 推送目标是手机，localhost 在手机上不可达；同一 Wi-Fi 下局域网 IP 可达。
+     */
+    private lanify;
+    /** Drel 推送端点识别（api.drel.app/<token>） */
+    private isDrelEndpoint;
+    private toDrelPayload;
 }
 
 interface CaptchaConfig {

package/dist/index.js

@@ -48,7 +48,7 @@ import {
   splitCommand,
   waitForAIResponse,
   waitForPage
-} from "./chunk-LFX24QJZ.js";
+} from "./chunk-5PZXCIDR.js";
 import {
   SessionRecorder
 } from "./chunk-IR6C24P7.js";
@@ -97,7 +97,7 @@ import {
   HumanInteractionManager,
   ScreencastCapturer,
   WebhookNotifier
-} from "./chunk-W44UXZSC.js";
+} from "./chunk-SOPN4XDK.js";
 import {
   NPM_REGISTRY_URL,
   NPM_SCOPE,
@@ -720,6 +720,9 @@ async function installFromMarketplace(pluginsDir, slug, options) {
   const realSlug = String(plugin.slug || slug);
   try {
     await downloadAndExtractMarketplaceTarball(baseUrl, realSlug, tmpDir, targetDir);
+  } catch (err) {
+    safeCleanup5(targetDir);
+    throw err;
   } finally {
     safeCleanup5(tmpDir);
   }
@@ -893,6 +896,7 @@ function ensureIndexFile(plugin, name, targetDir) {
 }
 
 // src/plugin/installer.ts
+import { safeCleanup as safeCleanup6 } from "@dyyz1993/xcli-core";
 var PluginInstaller = class {
   pluginsDir;
   constructor(pluginsDir) {
@@ -918,31 +922,29 @@ var PluginInstaller = class {
     }
     mkdirSync4(targetDir, { recursive: true });
     const resolvedSource = type === "npm" ? await resolveNpmPackageWithFallback(source) : source;
+    const withCleanup = async (fn) => {
+      try {
+        const r = await fn();
+        await this.fixSharedDeps(targetDir);
+        ensurePluginDependencies(this.pluginsDir);
+        if (!existsSync6(resolve6(targetDir, "index.ts")) && !existsSync6(resolve6(targetDir, "index.js"))) {
+          throw new Error("installed package has no index.ts/js entry");
+        }
+        return r;
+      } catch (err) {
+        safeCleanup6(targetDir);
+        throw err;
+      }
+    };
     switch (type) {
       case "local":
-        return await installFromLocal(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromLocal(source, name, targetDir));
       case "npm":
-        return await installFromNpm(resolvedSource, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromNpm(resolvedSource, name, targetDir));
       case "git":
-        return await installFromGit(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromGit(source, name, targetDir));
       case "url":
-        return await installFromUrl(source, name, targetDir).then(async (r) => {
-          await this.fixSharedDeps(targetDir);
-          ensurePluginDependencies(this.pluginsDir);
-          return r;
-        });
+        return await withCleanup(() => installFromUrl(source, name, targetDir));
     }
   }
   /**
@@ -5912,7 +5914,14 @@ async function routeCommand(argvIn, stdinCommands) {
       default: {
         const loader = await getPluginLoader();
         const internalLoader = loader.getCore().loader;
-        const site = internalLoader.getSite(command);
+        const resolvedSiteName = loader.resolveSiteName(command);
+        const site = resolvedSiteName ? internalLoader.getSite(resolvedSiteName) : void 0;
+        if (site && resolvedSiteName !== command) {
+          if (mode !== "json" && mode !== "yaml") {
+            process.stderr.write(`\u2139\uFE0F "${command}" \u7684\u547D\u4EE4\u540D\u662F "${resolvedSiteName}"\uFF08\u63D2\u4EF6\u76EE\u5F55\u540D\u4E0E\u7AD9\u70B9\u540D\u4E0D\u4E00\u81F4\uFF0C\u5DF2\u81EA\u52A8\u6620\u5C04\uFF09
+`);
+          }
+        }
         if (!site) {
           const globalFlagSet = /* @__PURE__ */ new Set(["--session", "--cdp", "--json", "--yaml", "--help", "-h", "--version", "--output", "-o"]);
           const cleanParts = [];
@@ -6053,6 +6062,14 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
           if (options.target && !params._target) {
             params._target = options.target;
           }
+          if (cmdEntry.parameters) {
+            const schemaFill = cmdEntry.parameters.safeParse(params);
+            if (schemaFill.success) {
+              for (const [k, v] of Object.entries(schemaFill.data)) {
+                if (!(k in params)) params[k] = v;
+              }
+            }
+          }
           const needsBrowser = cmdEntry.scope === "page" || cmdEntry.scope === "browser";
           if (needsBrowser && !process.env.XBROWSER_DAEMON_WORKER) {
             const { forwardPluginExec } = await import("./daemon-client-HEGAXWGK.js");
@@ -6360,7 +6377,7 @@ async function handleRemote(args, options, mode) {
   }
 }
 async function startMcpServer() {
-  const { startMcpStdio } = await import("./server-DZUIBVVR.js");
+  const { startMcpStdio } = await import("./server-NXXU3UGI.js");
   startMcpStdio();
 }
 

package/dist/{plugin-singleton-GJO7EZXB.js → plugin-singleton-GGSBI3EG.js}

@@ -1,7 +1,7 @@
 import {
   getPluginLoader,
   resetPluginLoader
-} from "./chunk-A3MORKYR.js";
+} from "./chunk-OSZNJT4U.js";
 import "./chunk-KFQGP6VL.js";
 export {
   getPluginLoader,

package/dist/{recovery-LGY25LIM.js → recovery-5C4FBA5O.js}

@@ -1,6 +1,6 @@
 import {
   HumanInteractionManager
-} from "./chunk-FBQZ3PVD.js";
+} from "./chunk-PGKV24QN.js";
 import {
   buildViewerUrl
 } from "./chunk-TZPKFUBT.js";

package/dist/{recovery-67DMH2OM.js → recovery-EBKORYEU.js}

@@ -1,9 +1,9 @@
+import {
+  HumanInteractionManager
+} from "./chunk-FNXA6FDM.js";
 import {
   buildViewerUrl
 } from "./chunk-3OD76SUE.js";
-import {
-  HumanInteractionManager
-} from "./chunk-W44UXZSC.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{recovery-6RI2FE3E.js → recovery-IMZUGWSS.js}

@@ -1,9 +1,9 @@
-import {
-  HumanInteractionManager
-} from "./chunk-LPW6QS4M.js";
 import {
   buildViewerUrl
 } from "./chunk-3OD76SUE.js";
+import {
+  HumanInteractionManager
+} from "./chunk-SOPN4XDK.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{server-HU4F5KN7.js → server-KSHSG4TY.js}

@@ -1,7 +1,7 @@
 import {
   executeChain,
   executeCommand
-} from "./chunk-TBSS7ES4.js";
+} from "./chunk-AYNFXG7V.js";
 import "./chunk-JKVUFP3G.js";
 import "./chunk-3OD76SUE.js";
 import "./chunk-ZTHE5RBZ.js";

package/dist/{server-DZUIBVVR.js → server-NXXU3UGI.js}

@@ -1,7 +1,7 @@
 import {
   executeChain,
   executeCommand
-} from "./chunk-LFX24QJZ.js";
+} from "./chunk-5PZXCIDR.js";
 import "./chunk-2Q3GQRUP.js";
 import "./chunk-JKVUFP3G.js";
 import "./chunk-3OD76SUE.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.23.1",
+  "version": "1.24.1",
   "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": {
@@ -130,4 +130,4 @@
   "optionalDependencies": {
     "undici": "^7.29.1"
   }
-}
+}