@xbrowser/cli 1.23.1 → 1.24.0

package/dist/{chunk-TBSS7ES4.js → chunk-A7RZYSWM.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,
@@ -8385,7 +8414,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 +8442,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,
@@ -8520,7 +8558,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-LFX24QJZ.js → chunk-BROEUPL3.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);
@@ -7558,6 +7558,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 +8734,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 +8762,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,
@@ -8840,7 +8878,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-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-A7RZYSWM.js";
 import "./chunk-JKVUFP3G.js";
 import {
   forwardCommandLog,
@@ -5957,6 +5957,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 +6272,7 @@ async function handleRemote(args, options, mode) {
   }
 }
 async function startMcpServer() {
-  const { startMcpStdio } = await import("./server-HU4F5KN7.js");
+  const { startMcpStdio } = await import("./server-YVMWMNHD.js");
   startMcpStdio();
 }
 

package/dist/daemon-main.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,
@@ -8101,7 +8139,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 +9071,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,

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.
@@ -2488,6 +2492,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 +2513,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-BROEUPL3.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,
@@ -6053,6 +6053,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 +6368,7 @@ async function handleRemote(args, options, mode) {
   }
 }
 async function startMcpServer() {
-  const { startMcpStdio } = await import("./server-DZUIBVVR.js");
+  const { startMcpStdio } = await import("./server-NPINOVJS.js");
   startMcpStdio();
 }
 

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-DZUIBVVR.js → server-NPINOVJS.js}

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

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

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

package/package.json

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