@xbrowser/cli 1.23.0 → 1.24.0

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-57VYIR56.js → human-interaction-V3VDGHHI.js}

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

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 {