@xbrowser/cli 1.25.2 → 1.26.0

package/dist/{browser-L3TUDYY3.js → browser-4IYIHZ6R.js}

@@ -20,10 +20,10 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-NNI5RT4A.js";
-import "./chunk-U6GFDVNI.js";
+} from "./chunk-KECYFWJO.js";
+import "./chunk-J3HXZVSN.js";
 import "./chunk-R3F4K2SB.js";
-import "./chunk-MYH6FIBZ.js";
+import "./chunk-SEEWE5SJ.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-WYETQ5C7.js";
 import "./chunk-75DNUI6M.js";

package/dist/{browser-33QQWEDI.js → browser-NYYCR4O7.js}

@@ -20,9 +20,9 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-2EEAXSBA.js";
+} from "./chunk-HSYRAV3H.js";
 import "./chunk-R3F4K2SB.js";
-import "./chunk-MYH6FIBZ.js";
+import "./chunk-SEEWE5SJ.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";
 export {

package/dist/{browser-4LOJSMWV.js → browser-ZD53IMUJ.js}

@@ -20,11 +20,11 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-ZOYM7QMS.js";
-import "./chunk-CGNHGAIJ.js";
+} from "./chunk-3PUOISKE.js";
+import "./chunk-ME5FO5YV.js";
 import "./chunk-A7NEA4PA.js";
 import "./chunk-R3F4K2SB.js";
-import "./chunk-MYH6FIBZ.js";
+import "./chunk-SEEWE5SJ.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";
 export {

package/dist/{cdp-driver-BYW7WY7E.js → cdp-driver-4X6Q62WI.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-CGNHGAIJ.js";
+} from "./chunk-ME5FO5YV.js";
 import "./chunk-A7NEA4PA.js";
 import "./chunk-R3F4K2SB.js";
 import {
@@ -23,7 +23,7 @@ import {
   getCDPTargets,
   killChrome,
   launchChrome
-} from "./chunk-MYH6FIBZ.js";
+} from "./chunk-SEEWE5SJ.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";
 export {

package/dist/{cdp-driver-5YVI5AIS.js → cdp-driver-EFEW4ZEN.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-U6GFDVNI.js";
+} from "./chunk-J3HXZVSN.js";
 import "./chunk-R3F4K2SB.js";
 import {
   connectToCDP,
@@ -22,7 +22,7 @@ import {
   getCDPTargets,
   killChrome,
   launchChrome
-} from "./chunk-MYH6FIBZ.js";
+} from "./chunk-SEEWE5SJ.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-75DNUI6M.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{cdp-driver-MEK5EDEK.js → cdp-driver-HB744QB4.js}

@@ -13,7 +13,7 @@ import {
   getCDPTargets,
   killChrome,
   launchChrome
-} from "./chunk-VCVDILH6.js";
+} from "./chunk-T2AI24A5.js";
 import {
   __require
 } from "./chunk-3RG5ZIWI.js";
@@ -3417,7 +3417,7 @@ var XBBrowserImpl = class {
       this._exitHandler = null;
     }
     if (this.childProcess) {
-      const { killChrome: killChrome2 } = await import("./launcher-LUOMMGZC.js");
+      const { killChrome: killChrome2 } = await import("./launcher-SJ44X25U.js");
       await killChrome2(this.childProcess, this.tmpDir);
     }
     await this.conn.close();
@@ -3587,7 +3587,7 @@ var XBBrowserImpl = class {
     if (pageTargets.length === 0 && httpFallbackUrl) {
       console.log(`[discoverContexts] Target.getTargets returned ${targetInfos.length} targets (0 page type). Falling back to HTTP /json/list at ${httpFallbackUrl}`);
       try {
-        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-LUOMMGZC.js");
+        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-SJ44X25U.js");
         const httpPages = await getCDPTargets2(httpFallbackUrl);
         console.log(`[discoverContexts] HTTP /json/list returned ${httpPages.length} pages`);
         for (const p of httpPages) {

package/dist/{chunk-ZOYM7QMS.js → chunk-3PUOISKE.js}

@@ -1,7 +1,7 @@
 import {
   createRuleEngine,
   launch
-} from "./chunk-CGNHGAIJ.js";
+} from "./chunk-ME5FO5YV.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-DRKL2RFQ.js → chunk-6OWOICQ3.js}

@@ -9,7 +9,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-NNI5RT4A.js";
+} from "./chunk-KECYFWJO.js";
 import {
   detectAntiBot,
   formatDetectionMessage
@@ -867,10 +867,14 @@ var clickCommand = registerCommand({
         targetIdsBefore = /* @__PURE__ */ new Set();
       }
       const pagePromise = new Promise((resolve3) => {
+        const waitMs = (() => {
+          const v = parseInt(process.env.XBROWSER_NEW_TAB_WAIT ?? "250", 10);
+          return Number.isFinite(v) && v > 0 ? v : 250;
+        })();
         const timer = setTimeout(() => {
           ctx.browserContext.off("page", handler);
           resolve3(void 0);
-        }, 3e3);
+        }, waitMs);
         const handler = (page2) => {
           if (targetIdsBefore.has(targetIdOf(page2))) return;
           try {
@@ -8295,7 +8299,10 @@ function buildSnapshot(elements) {
 }
 
 // src/tips/index.ts
-var DEBOUNCE_MS = 500;
+function tipsDebounceMs() {
+  const v = parseInt(process.env.XBROWSER_TIPS_DEBOUNCE ?? "120", 10);
+  return Number.isFinite(v) && v > 0 ? v : 0;
+}
 var SKIP_DETECT_COMMANDS = /* @__PURE__ */ new Set([
   "goto",
   // 导航命令不需要检测
@@ -8387,7 +8394,9 @@ var TipsManager = class {
     }
   }
   debounce() {
-    return new Promise((resolve3) => setTimeout(resolve3, DEBOUNCE_MS));
+    const ms = tipsDebounceMs();
+    if (ms <= 0) return Promise.resolve();
+    return new Promise((resolve3) => setTimeout(resolve3, ms));
   }
   formatTips(tips) {
     return tips.map((tip) => {
@@ -8636,7 +8645,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-L3TUDYY3.js");
+    const { findTargetPage } = await import("./browser-4IYIHZ6R.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/{chunk-PO27V5UH.js → chunk-HDFQRDBC.js}

@@ -20,7 +20,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-2EEAXSBA.js";
+} from "./chunk-HSYRAV3H.js";
 import {
   rand,
   sleep,
@@ -515,10 +515,14 @@ var clickCommand = registerCommand({
         targetIdsBefore = /* @__PURE__ */ new Set();
       }
       const pagePromise = new Promise((resolve3) => {
+        const waitMs = (() => {
+          const v = parseInt(process.env.XBROWSER_NEW_TAB_WAIT ?? "250", 10);
+          return Number.isFinite(v) && v > 0 ? v : 250;
+        })();
         const timer = setTimeout(() => {
           ctx.browserContext.off("page", handler);
           resolve3(void 0);
-        }, 3e3);
+        }, waitMs);
         const handler = (page2) => {
           if (targetIdsBefore.has(targetIdOf(page2))) return;
           try {
@@ -7981,7 +7985,10 @@ function buildSnapshot(elements) {
 }
 
 // src/tips/index.ts
-var DEBOUNCE_MS = 500;
+function tipsDebounceMs() {
+  const v = parseInt(process.env.XBROWSER_TIPS_DEBOUNCE ?? "120", 10);
+  return Number.isFinite(v) && v > 0 ? v : 0;
+}
 var SKIP_DETECT_COMMANDS = /* @__PURE__ */ new Set([
   "goto",
   // 导航命令不需要检测
@@ -8073,7 +8080,9 @@ var TipsManager = class {
     }
   }
   debounce() {
-    return new Promise((resolve3) => setTimeout(resolve3, DEBOUNCE_MS));
+    const ms = tipsDebounceMs();
+    if (ms <= 0) return Promise.resolve();
+    return new Promise((resolve3) => setTimeout(resolve3, ms));
   }
   formatTips(tips) {
     return tips.map((tip) => {
@@ -8319,7 +8328,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-33QQWEDI.js");
+    const { findTargetPage } = await import("./browser-NYYCR4O7.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/{chunk-2EEAXSBA.js → chunk-HSYRAV3H.js}

@@ -9,7 +9,7 @@ import {
 import {
   connectToCDP,
   launchChrome
-} from "./chunk-MYH6FIBZ.js";
+} from "./chunk-SEEWE5SJ.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -3422,7 +3422,7 @@ var XBBrowserImpl = class {
       this._exitHandler = null;
     }
     if (this.childProcess) {
-      const { killChrome: killChrome2 } = await import("./launcher-IK2FKW6T.js");
+      const { killChrome: killChrome2 } = await import("./launcher-XHKIC4GP.js");
       await killChrome2(this.childProcess, this.tmpDir);
     }
     await this.conn.close();
@@ -3592,7 +3592,7 @@ var XBBrowserImpl = class {
     if (pageTargets.length === 0 && httpFallbackUrl) {
       console.log(`[discoverContexts] Target.getTargets returned ${targetInfos.length} targets (0 page type). Falling back to HTTP /json/list at ${httpFallbackUrl}`);
       try {
-        const { getCDPTargets: getCDPTargets3 } = await import("./launcher-IK2FKW6T.js");
+        const { getCDPTargets: getCDPTargets3 } = await import("./launcher-XHKIC4GP.js");
         const httpPages = await getCDPTargets3(httpFallbackUrl);
         console.log(`[discoverContexts] HTTP /json/list returned ${httpPages.length} pages`);
         for (const p of httpPages) {

package/dist/{chunk-U6GFDVNI.js → chunk-J3HXZVSN.js}

@@ -9,7 +9,7 @@ import {
 import {
   connectToCDP,
   launchChrome
-} from "./chunk-MYH6FIBZ.js";
+} from "./chunk-SEEWE5SJ.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -3419,7 +3419,7 @@ var XBBrowserImpl = class {
       this._exitHandler = null;
     }
     if (this.childProcess) {
-      const { killChrome: killChrome2 } = await import("./launcher-IK2FKW6T.js");
+      const { killChrome: killChrome2 } = await import("./launcher-XHKIC4GP.js");
       await killChrome2(this.childProcess, this.tmpDir);
     }
     await this.conn.close();
@@ -3589,7 +3589,7 @@ var XBBrowserImpl = class {
     if (pageTargets.length === 0 && httpFallbackUrl) {
       console.log(`[discoverContexts] Target.getTargets returned ${targetInfos.length} targets (0 page type). Falling back to HTTP /json/list at ${httpFallbackUrl}`);
       try {
-        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-IK2FKW6T.js");
+        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-XHKIC4GP.js");
         const httpPages = await getCDPTargets2(httpFallbackUrl);
         console.log(`[discoverContexts] HTTP /json/list returned ${httpPages.length} pages`);
         for (const p of httpPages) {

package/dist/{chunk-NNI5RT4A.js → chunk-KECYFWJO.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-U6GFDVNI.js";
+} from "./chunk-J3HXZVSN.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-CGNHGAIJ.js → chunk-ME5FO5YV.js}

@@ -13,7 +13,7 @@ import {
 import {
   connectToCDP,
   launchChrome
-} from "./chunk-MYH6FIBZ.js";
+} from "./chunk-SEEWE5SJ.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -3318,7 +3318,7 @@ var XBBrowserImpl = class {
       this._exitHandler = null;
     }
     if (this.childProcess) {
-      const { killChrome: killChrome2 } = await import("./launcher-IK2FKW6T.js");
+      const { killChrome: killChrome2 } = await import("./launcher-XHKIC4GP.js");
       await killChrome2(this.childProcess, this.tmpDir);
     }
     await this.conn.close();
@@ -3488,7 +3488,7 @@ var XBBrowserImpl = class {
     if (pageTargets.length === 0 && httpFallbackUrl) {
       console.log(`[discoverContexts] Target.getTargets returned ${targetInfos.length} targets (0 page type). Falling back to HTTP /json/list at ${httpFallbackUrl}`);
       try {
-        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-IK2FKW6T.js");
+        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-XHKIC4GP.js");
         const httpPages = await getCDPTargets2(httpFallbackUrl);
         console.log(`[discoverContexts] HTTP /json/list returned ${httpPages.length} pages`);
         for (const p of httpPages) {

package/dist/{chunk-MYH6FIBZ.js → chunk-SEEWE5SJ.js}

@@ -52,7 +52,11 @@ var DEFAULT_ARGS = [
 ];
 var ANTI_DETECT_ARGS = [
   "--disable-blink-features=AutomationControlled",
-  "--disable-features=IsolateOrigins,site-per-process"
+  "--disable-features=IsolateOrigins,site-per-process",
+  // headless UA 清洗（browserscan 实测 2026-09-14）：headless 默认 UA 含
+  // "HeadlessChrome"——这是反爬系统最高频检测面之一。必须在 launch 级覆盖
+  // （stealth init-script 只能覆盖 JS 层 navigator.userAgent，HTTP header 盖不住）
+  "--user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36"
 ];
 function findChrome() {
   const platform = process.platform;

package/dist/{chunk-VCVDILH6.js → chunk-T2AI24A5.js}

@@ -56,7 +56,11 @@ var DEFAULT_ARGS = [
 ];
 var ANTI_DETECT_ARGS = [
   "--disable-blink-features=AutomationControlled",
-  "--disable-features=IsolateOrigins,site-per-process"
+  "--disable-features=IsolateOrigins,site-per-process",
+  // headless UA 清洗（browserscan 实测 2026-09-14）：headless 默认 UA 含
+  // "HeadlessChrome"——这是反爬系统最高频检测面之一。必须在 launch 级覆盖
+  // （stealth init-script 只能覆盖 JS 层 navigator.userAgent，HTTP header 盖不住）
+  "--user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36"
 ];
 function findChrome() {
   const platform = process.platform;

package/dist/cli.js

@@ -17,7 +17,7 @@ import {
   loadHooks,
   parsePluginParams,
   readJsonFile
-} from "./chunk-PO27V5UH.js";
+} from "./chunk-HDFQRDBC.js";
 import "./chunk-JKVUFP3G.js";
 import {
   forwardCommandLog,
@@ -81,9 +81,9 @@ import {
   findSession,
   getAllSessions,
   saveSessionDiskMeta
-} from "./chunk-2EEAXSBA.js";
+} from "./chunk-HSYRAV3H.js";
 import "./chunk-R3F4K2SB.js";
-import "./chunk-MYH6FIBZ.js";
+import "./chunk-SEEWE5SJ.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -6032,7 +6032,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage } = await import("./browser-33QQWEDI.js");
+              const { setActivePage } = await import("./browser-NYYCR4O7.js");
               setActivePage(session, targetPage);
             }
           }
@@ -6297,7 +6297,7 @@ async function handleRemote(args, options, mode) {
   }
 }
 async function startMcpServer() {
-  const { startMcpStdio } = await import("./server-EZJW6IHU.js");
+  const { startMcpStdio } = await import("./server-65LCP6S6.js");
   startMcpStdio();
 }
 
@@ -6316,7 +6316,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve" || command === "mcp";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-33QQWEDI.js");
+      const { ensureProcessCanExit } = await import("./browser-NYYCR4O7.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(process.exitCode || exitCode);

package/dist/daemon-main.js

@@ -38,10 +38,10 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-ZOYM7QMS.js";
+} from "./chunk-3PUOISKE.js";
 import {
   createRuleEngine
-} from "./chunk-CGNHGAIJ.js";
+} from "./chunk-ME5FO5YV.js";
 import {
   queryJS
 } from "./chunk-A7NEA4PA.js";
@@ -50,7 +50,7 @@ import {
   sleep,
   wheelDelta
 } from "./chunk-R3F4K2SB.js";
-import "./chunk-MYH6FIBZ.js";
+import "./chunk-SEEWE5SJ.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -535,10 +535,14 @@ var clickCommand = registerCommand({
         targetIdsBefore = /* @__PURE__ */ new Set();
       }
       const pagePromise = new Promise((resolve) => {
+        const waitMs = (() => {
+          const v = parseInt(process.env.XBROWSER_NEW_TAB_WAIT ?? "250", 10);
+          return Number.isFinite(v) && v > 0 ? v : 250;
+        })();
         const timer = setTimeout(() => {
           ctx.browserContext.off("page", handler);
           resolve(void 0);
-        }, 3e3);
+        }, waitMs);
         const handler = (page2) => {
           if (targetIdsBefore.has(targetIdOf(page2))) return;
           try {
@@ -7533,7 +7537,10 @@ function buildSnapshot(elements) {
 }
 
 // src/tips/index.ts
-var DEBOUNCE_MS = 500;
+function tipsDebounceMs() {
+  const v = parseInt(process.env.XBROWSER_TIPS_DEBOUNCE ?? "120", 10);
+  return Number.isFinite(v) && v > 0 ? v : 0;
+}
 var SKIP_DETECT_COMMANDS = /* @__PURE__ */ new Set([
   "goto",
   // 导航命令不需要检测
@@ -7625,7 +7632,9 @@ var TipsManager = class {
     }
   }
   debounce() {
-    return new Promise((resolve) => setTimeout(resolve, DEBOUNCE_MS));
+    const ms = tipsDebounceMs();
+    if (ms <= 0) return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
   }
   formatTips(tips) {
     return tips.map((tip) => {
@@ -7871,7 +7880,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-4LOJSMWV.js");
+    const { findTargetPage } = await import("./browser-ZD53IMUJ.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.`);
@@ -9711,7 +9720,7 @@ function createRPCHandler() {
     if (isNewFormat) {
       try {
         const replayErrors = [];
-        const { SessionReplayer } = await import("./session-replayer-PJIUH7KI.js");
+        const { SessionReplayer } = await import("./session-replayer-TXTNTG33.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.js

@@ -48,7 +48,7 @@ import {
   splitCommand,
   waitForAIResponse,
   waitForPage
-} from "./chunk-DRKL2RFQ.js";
+} from "./chunk-6OWOICQ3.js";
 import {
   SessionRecorder
 } from "./chunk-IR6C24P7.js";
@@ -63,7 +63,7 @@ import {
   getBrowser,
   resetForTesting,
   saveSessionDiskMeta
-} from "./chunk-NNI5RT4A.js";
+} from "./chunk-KECYFWJO.js";
 import "./chunk-JKVUFP3G.js";
 import {
   forwardCommandLog,
@@ -120,9 +120,9 @@ import {
   generateJSScript,
   generatePythonScript
 } from "./chunk-ETCO4SNK.js";
-import "./chunk-U6GFDVNI.js";
+import "./chunk-J3HXZVSN.js";
 import "./chunk-R3F4K2SB.js";
-import "./chunk-MYH6FIBZ.js";
+import "./chunk-SEEWE5SJ.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -6127,7 +6127,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage } = await import("./browser-L3TUDYY3.js");
+              const { setActivePage } = await import("./browser-4IYIHZ6R.js");
               setActivePage(session, targetPage);
             }
           }
@@ -6392,7 +6392,7 @@ async function handleRemote(args, options, mode) {
   }
 }
 async function startMcpServer() {
-  const { startMcpStdio } = await import("./server-IBQGNDSB.js");
+  const { startMcpStdio } = await import("./server-6KZ5NT6L.js");
   startMcpStdio();
 }
 
@@ -9307,7 +9307,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-5YVI5AIS.js");
+    const { launch } = await import("./cdp-driver-EFEW4ZEN.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{launcher-LUOMMGZC.js → launcher-SJ44X25U.js}

@@ -7,7 +7,7 @@ import {
   joinCdpHttpUrl,
   killChrome,
   launchChrome
-} from "./chunk-VCVDILH6.js";
+} from "./chunk-T2AI24A5.js";
 import "./chunk-3RG5ZIWI.js";
 export {
   ANTI_DETECT_ARGS,

package/dist/{launcher-IK2FKW6T.js → launcher-XHKIC4GP.js}

@@ -7,7 +7,7 @@ import {
   joinCdpHttpUrl,
   killChrome,
   launchChrome
-} from "./chunk-MYH6FIBZ.js";
+} from "./chunk-SEEWE5SJ.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";
 export {

package/dist/{server-EZJW6IHU.js → server-65LCP6S6.js}

@@ -1,17 +1,111 @@
 import {
   executeChain,
   executeCommand
-} from "./chunk-PO27V5UH.js";
+} from "./chunk-HDFQRDBC.js";
 import "./chunk-JKVUFP3G.js";
 import "./chunk-3OD76SUE.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
-import "./chunk-2EEAXSBA.js";
+import "./chunk-HSYRAV3H.js";
 import "./chunk-R3F4K2SB.js";
-import "./chunk-MYH6FIBZ.js";
+import "./chunk-SEEWE5SJ.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";
 
+// src/lib/heal-kb.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+var HEAL_KB_TTL_DAYS = 30;
+function healKbDir(dir) {
+  return dir ?? path.join(os.homedir(), ".xbrowser", "knowledge");
+}
+function domainFile(domain, dir) {
+  if (!/^[\w.-]+$/.test(domain)) throw new Error(`invalid domain: ${domain}`);
+  return path.join(dir, `heals-${domain}.json`);
+}
+function readHeals(domain, dir) {
+  try {
+    return JSON.parse(fs.readFileSync(domainFile(domain, healKbDir(dir)), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function lookupHeal(domain, primary, dir) {
+  if (!primary) return null;
+  const e = readHeals(domain, dir)[primary];
+  return e ? { ...e } : null;
+}
+function pruneExpiredHeals(domain, dir) {
+  const d = healKbDir(dir);
+  const file = domainFile(domain, d);
+  const data = readHeals(domain, d);
+  const cutoff = Date.now() - HEAL_KB_TTL_DAYS * 864e5;
+  let pruned = 0;
+  for (const k of Object.keys(data)) {
+    const ts = Date.parse(data[k]?.lastSeen ?? "");
+    if (!(ts >= cutoff)) {
+      delete data[k];
+      pruned++;
+    }
+  }
+  if (pruned > 0) {
+    fs.mkdirSync(d, { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(data, null, 2));
+  }
+  return pruned;
+}
+function writeHeal(domain, primary, entry, dir) {
+  if (!primary) throw new Error("primary selector is required");
+  if (!entry.healed || !entry.strategy) throw new Error("healed and strategy are required");
+  const d = healKbDir(dir);
+  const file = domainFile(domain, d);
+  const data = readHeals(domain, d);
+  const prev = data[primary];
+  const next = {
+    healed: entry.healed,
+    strategy: entry.strategy,
+    lastSeen: (/* @__PURE__ */ new Date()).toISOString(),
+    hits: (prev?.hits ?? 0) + 1
+  };
+  data[primary] = next;
+  fs.mkdirSync(d, { recursive: true });
+  fs.writeFileSync(file, JSON.stringify(data, null, 2));
+  pruneExpiredHeals(domain, d);
+  return next;
+}
+function forgetHeal(domain, primary, dir) {
+  const d = healKbDir(dir);
+  const data = readHeals(domain, d);
+  if (!data[primary]) return false;
+  delete data[primary];
+  fs.writeFileSync(domainFile(domain, d), JSON.stringify(data, null, 2));
+  return true;
+}
+function listHealDomains(dir) {
+  const d = healKbDir(dir);
+  let files = [];
+  try {
+    files = fs.readdirSync(d).filter((f) => f.startsWith("heals-") && f.endsWith(".json"));
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const f of files) {
+    const domain = f.slice("heals-".length, -".json".length);
+    const data = readHeals(domain, d);
+    const entries = Object.values(data);
+    if (entries.length === 0) continue;
+    out.push({
+      domain,
+      entries: entries.length,
+      hits: entries.reduce((s, e) => s + (e.hits ?? 0), 0),
+      lastSeen: entries.reduce((m, e) => e.lastSeen > m ? e.lastSeen : m, "")
+    });
+  }
+  return out.sort((a, b) => b.lastSeen.localeCompare(a.lastSeen));
+}
+
 // src/mcp/server.ts
 var TOOLS = [
   {
@@ -109,6 +203,32 @@ var TOOLS = [
       },
       required: ["file"]
     }
+  },
+  {
+    name: "heal_kb_read",
+    description: "Read the self-healing knowledge base (~/.xbrowser/knowledge/heals-{domain}.json). Mappings: broken primary selector \u2192 healed selector + strategy + hits. No args = list all domains; domain only = all entries for that domain; domain+selector = single lookup.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        domain: { type: "string", description: "Site domain, e.g. juejin.cn. Omit to list all domains." },
+        selector: { type: "string", description: "Broken primary selector to look up (requires domain)." }
+      }
+    }
+  },
+  {
+    name: "heal_kb_write",
+    description: "Write or remove an entry in the self-healing knowledge base \u2014 lets an external healer agent (selector-healer) persist re-located selectors that the replay engine will pick up as known-heal. Entries TTL-prune after 30 days without a hit.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        domain: { type: "string", description: "Site domain, e.g. juejin.cn" },
+        selector: { type: "string", description: "Broken primary selector (the recording-time selector)" },
+        healed: { type: "string", description: "The re-located working selector" },
+        strategy: { type: "string", description: "How it was healed, e.g. partial-id / text-anchor / label-anchor" },
+        remove: { type: "boolean", description: "true = forget this entry instead of writing" }
+      },
+      required: ["domain", "selector"]
+    }
   }
 ];
 var DEFAULT_SESSION = "mcp";
@@ -162,6 +282,28 @@ async function runTool(name, args) {
       const result = await executeCommand("replay", params, session, {});
       return text(result);
     }
+    case "heal_kb_read": {
+      const domain = args.domain;
+      const selector = args.selector;
+      if (!domain) return text({ domains: listHealDomains() });
+      if (selector) {
+        const entry = lookupHeal(domain, selector);
+        return text({ domain, selector, entry });
+      }
+      return text({ domain, entries: readHeals(domain) });
+    }
+    case "heal_kb_write": {
+      const domain = args.domain;
+      const selector = args.selector;
+      if (args.remove) {
+        return text({ domain, selector, removed: forgetHeal(domain, selector) });
+      }
+      const entry = writeHeal(domain, selector, {
+        healed: args.healed,
+        strategy: args.strategy
+      });
+      return text({ domain, selector, written: entry });
+    }
     default:
       throw new Error(`unknown tool: ${name}`);
   }
@@ -236,5 +378,6 @@ function startMcpStdio() {
   });
 }
 export {
+  runTool,
   startMcpStdio
 };

package/dist/{server-IBQGNDSB.js → server-6KZ5NT6L.js}

@@ -1,20 +1,114 @@
 import {
   executeChain,
   executeCommand
-} from "./chunk-DRKL2RFQ.js";
-import "./chunk-NNI5RT4A.js";
+} from "./chunk-6OWOICQ3.js";
+import "./chunk-KECYFWJO.js";
 import "./chunk-JKVUFP3G.js";
 import "./chunk-3OD76SUE.js";
 import "./chunk-ZTHE5RBZ.js";
 import "./chunk-Q2DFJQGS.js";
-import "./chunk-U6GFDVNI.js";
+import "./chunk-J3HXZVSN.js";
 import "./chunk-R3F4K2SB.js";
-import "./chunk-MYH6FIBZ.js";
+import "./chunk-SEEWE5SJ.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-WYETQ5C7.js";
 import "./chunk-75DNUI6M.js";
 import "./chunk-KFQGP6VL.js";
 
+// src/lib/heal-kb.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+var HEAL_KB_TTL_DAYS = 30;
+function healKbDir(dir) {
+  return dir ?? path.join(os.homedir(), ".xbrowser", "knowledge");
+}
+function domainFile(domain, dir) {
+  if (!/^[\w.-]+$/.test(domain)) throw new Error(`invalid domain: ${domain}`);
+  return path.join(dir, `heals-${domain}.json`);
+}
+function readHeals(domain, dir) {
+  try {
+    return JSON.parse(fs.readFileSync(domainFile(domain, healKbDir(dir)), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function lookupHeal(domain, primary, dir) {
+  if (!primary) return null;
+  const e = readHeals(domain, dir)[primary];
+  return e ? { ...e } : null;
+}
+function pruneExpiredHeals(domain, dir) {
+  const d = healKbDir(dir);
+  const file = domainFile(domain, d);
+  const data = readHeals(domain, d);
+  const cutoff = Date.now() - HEAL_KB_TTL_DAYS * 864e5;
+  let pruned = 0;
+  for (const k of Object.keys(data)) {
+    const ts = Date.parse(data[k]?.lastSeen ?? "");
+    if (!(ts >= cutoff)) {
+      delete data[k];
+      pruned++;
+    }
+  }
+  if (pruned > 0) {
+    fs.mkdirSync(d, { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(data, null, 2));
+  }
+  return pruned;
+}
+function writeHeal(domain, primary, entry, dir) {
+  if (!primary) throw new Error("primary selector is required");
+  if (!entry.healed || !entry.strategy) throw new Error("healed and strategy are required");
+  const d = healKbDir(dir);
+  const file = domainFile(domain, d);
+  const data = readHeals(domain, d);
+  const prev = data[primary];
+  const next = {
+    healed: entry.healed,
+    strategy: entry.strategy,
+    lastSeen: (/* @__PURE__ */ new Date()).toISOString(),
+    hits: (prev?.hits ?? 0) + 1
+  };
+  data[primary] = next;
+  fs.mkdirSync(d, { recursive: true });
+  fs.writeFileSync(file, JSON.stringify(data, null, 2));
+  pruneExpiredHeals(domain, d);
+  return next;
+}
+function forgetHeal(domain, primary, dir) {
+  const d = healKbDir(dir);
+  const data = readHeals(domain, d);
+  if (!data[primary]) return false;
+  delete data[primary];
+  fs.writeFileSync(domainFile(domain, d), JSON.stringify(data, null, 2));
+  return true;
+}
+function listHealDomains(dir) {
+  const d = healKbDir(dir);
+  let files = [];
+  try {
+    files = fs.readdirSync(d).filter((f) => f.startsWith("heals-") && f.endsWith(".json"));
+  } catch {
+    return [];
+  }
+  const out = [];
+  for (const f of files) {
+    const domain = f.slice("heals-".length, -".json".length);
+    const data = readHeals(domain, d);
+    const entries = Object.values(data);
+    if (entries.length === 0) continue;
+    out.push({
+      domain,
+      entries: entries.length,
+      hits: entries.reduce((s, e) => s + (e.hits ?? 0), 0),
+      lastSeen: entries.reduce((m, e) => e.lastSeen > m ? e.lastSeen : m, "")
+    });
+  }
+  return out.sort((a, b) => b.lastSeen.localeCompare(a.lastSeen));
+}
+
 // src/mcp/server.ts
 var TOOLS = [
   {
@@ -112,6 +206,32 @@ var TOOLS = [
       },
       required: ["file"]
     }
+  },
+  {
+    name: "heal_kb_read",
+    description: "Read the self-healing knowledge base (~/.xbrowser/knowledge/heals-{domain}.json). Mappings: broken primary selector \u2192 healed selector + strategy + hits. No args = list all domains; domain only = all entries for that domain; domain+selector = single lookup.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        domain: { type: "string", description: "Site domain, e.g. juejin.cn. Omit to list all domains." },
+        selector: { type: "string", description: "Broken primary selector to look up (requires domain)." }
+      }
+    }
+  },
+  {
+    name: "heal_kb_write",
+    description: "Write or remove an entry in the self-healing knowledge base \u2014 lets an external healer agent (selector-healer) persist re-located selectors that the replay engine will pick up as known-heal. Entries TTL-prune after 30 days without a hit.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        domain: { type: "string", description: "Site domain, e.g. juejin.cn" },
+        selector: { type: "string", description: "Broken primary selector (the recording-time selector)" },
+        healed: { type: "string", description: "The re-located working selector" },
+        strategy: { type: "string", description: "How it was healed, e.g. partial-id / text-anchor / label-anchor" },
+        remove: { type: "boolean", description: "true = forget this entry instead of writing" }
+      },
+      required: ["domain", "selector"]
+    }
   }
 ];
 var DEFAULT_SESSION = "mcp";
@@ -165,6 +285,28 @@ async function runTool(name, args) {
       const result = await executeCommand("replay", params, session, {});
       return text(result);
     }
+    case "heal_kb_read": {
+      const domain = args.domain;
+      const selector = args.selector;
+      if (!domain) return text({ domains: listHealDomains() });
+      if (selector) {
+        const entry = lookupHeal(domain, selector);
+        return text({ domain, selector, entry });
+      }
+      return text({ domain, entries: readHeals(domain) });
+    }
+    case "heal_kb_write": {
+      const domain = args.domain;
+      const selector = args.selector;
+      if (args.remove) {
+        return text({ domain, selector, removed: forgetHeal(domain, selector) });
+      }
+      const entry = writeHeal(domain, selector, {
+        healed: args.healed,
+        strategy: args.strategy
+      });
+      return text({ domain, selector, written: entry });
+    }
     default:
       throw new Error(`unknown tool: ${name}`);
   }
@@ -239,5 +381,6 @@ function startMcpStdio() {
   });
 }
 export {
+  runTool,
   startMcpStdio
 };

package/dist/{session-replayer-PJIUH7KI.js → session-replayer-TXTNTG33.js}

@@ -5,10 +5,91 @@ import {
 import "./chunk-KFQGP6VL.js";
 
 // src/recorder/session-replayer.ts
-import { readFileSync, writeFileSync, mkdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
+
+// src/lib/heal-kb.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
 var HEAL_KB_TTL_DAYS = 30;
+function healKbDir(dir) {
+  return dir ?? path.join(os.homedir(), ".xbrowser", "knowledge");
+}
+function domainFile(domain, dir) {
+  if (!/^[\w.-]+$/.test(domain)) throw new Error(`invalid domain: ${domain}`);
+  return path.join(dir, `heals-${domain}.json`);
+}
+function readHeals(domain, dir) {
+  try {
+    return JSON.parse(fs.readFileSync(domainFile(domain, healKbDir(dir)), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function lookupHeal(domain, primary, dir) {
+  if (!primary) return null;
+  const e = readHeals(domain, dir)[primary];
+  return e ? { ...e } : null;
+}
+function pruneExpiredHeals(domain, dir) {
+  const d = healKbDir(dir);
+  const file = domainFile(domain, d);
+  const data = readHeals(domain, d);
+  const cutoff = Date.now() - HEAL_KB_TTL_DAYS * 864e5;
+  let pruned = 0;
+  for (const k of Object.keys(data)) {
+    const ts = Date.parse(data[k]?.lastSeen ?? "");
+    if (!(ts >= cutoff)) {
+      delete data[k];
+      pruned++;
+    }
+  }
+  if (pruned > 0) {
+    fs.mkdirSync(d, { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(data, null, 2));
+  }
+  return pruned;
+}
+function writeHeal(domain, primary, entry, dir) {
+  if (!primary) throw new Error("primary selector is required");
+  if (!entry.healed || !entry.strategy) throw new Error("healed and strategy are required");
+  const d = healKbDir(dir);
+  const file = domainFile(domain, d);
+  const data = readHeals(domain, d);
+  const prev = data[primary];
+  const next = {
+    healed: entry.healed,
+    strategy: entry.strategy,
+    lastSeen: (/* @__PURE__ */ new Date()).toISOString(),
+    hits: (prev?.hits ?? 0) + 1
+  };
+  data[primary] = next;
+  fs.mkdirSync(d, { recursive: true });
+  fs.writeFileSync(file, JSON.stringify(data, null, 2));
+  pruneExpiredHeals(domain, d);
+  return next;
+}
+function bumpHeal(domain, primary, dir) {
+  const d = healKbDir(dir);
+  const data = readHeals(domain, d);
+  const e = data[primary];
+  if (!e) return false;
+  e.hits += 1;
+  e.lastSeen = (/* @__PURE__ */ new Date()).toISOString();
+  fs.writeFileSync(domainFile(domain, d), JSON.stringify(data, null, 2));
+  return true;
+}
+function forgetHeal(domain, primary, dir) {
+  const d = healKbDir(dir);
+  const data = readHeals(domain, d);
+  if (!data[primary]) return false;
+  delete data[primary];
+  fs.writeFileSync(domainFile(domain, d), JSON.stringify(data, null, 2));
+  return true;
+}
+
+// src/recorder/session-replayer.ts
 var NATIVE_VALUE_INJECT_TYPES = /* @__PURE__ */ new Set([
   "color",
   "date",
@@ -38,8 +119,8 @@ var SessionReplayer = class {
   /** Load a recording from a file path or parsed JSON */
   async load(source) {
     if (typeof source === "string") {
-      const fs = await import("fs");
-      const raw = fs.readFileSync(source, "utf8");
+      const fs2 = await import("fs");
+      const raw = fs2.readFileSync(source, "utf8");
       this.recording = JSON.parse(raw);
     } else {
       this.recording = source;
@@ -61,7 +142,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-BYW7WY7E.js");
+      const { launch } = await import("./cdp-driver-4X6Q62WI.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {
@@ -719,62 +800,26 @@ var SessionReplayer = class {
       return "unknown";
     }
   }
-  healKnowledgeFile(domain) {
-    return join(this.opts.healKnowledgeDir, `heals-${domain}.json`);
-  }
-  readHealFile(file) {
-    try {
-      return JSON.parse(readFileSync(file, "utf8"));
-    } catch {
-      return {};
-    }
-  }
   lookupHealKnowledge(domain, primary) {
     if (!primary || !this.opts.healKnowledgeDir) return null;
-    const data = this.readHealFile(this.healKnowledgeFile(domain));
-    const e = data[primary];
-    return e ? { healed: e.healed, strategy: e.strategy } : null;
+    return lookupHeal(domain, primary, this.opts.healKnowledgeDir);
   }
   persistHealKnowledge(action, primary, healed) {
     if (!this.opts.healKnowledgeDir || !primary || healed.strategy === "known-heal") return;
     try {
-      const file = this.healKnowledgeFile(this.pageDomain(action));
-      const data = this.readHealFile(file);
-      data[primary] = {
-        healed: healed.selector,
-        strategy: healed.strategy,
-        lastSeen: (/* @__PURE__ */ new Date()).toISOString(),
-        hits: (data[primary]?.hits ?? 0) + 1
-      };
-      const cutoff = Date.now() - HEAL_KB_TTL_DAYS * 864e5;
-      for (const k of Object.keys(data)) {
-        const ts = Date.parse(data[k]?.lastSeen ?? "");
-        if (!(ts >= cutoff)) delete data[k];
-      }
-      mkdirSync(this.opts.healKnowledgeDir, { recursive: true });
-      writeFileSync(file, JSON.stringify(data, null, 2));
+      writeHeal(this.pageDomain(action), primary, { healed: healed.selector, strategy: healed.strategy }, this.opts.healKnowledgeDir);
     } catch {
     }
   }
   bumpHealKnowledge(domain, primary) {
     try {
-      const file = this.healKnowledgeFile(domain);
-      const data = this.readHealFile(file);
-      const e = data[primary];
-      if (!e) return;
-      e.hits += 1;
-      e.lastSeen = (/* @__PURE__ */ new Date()).toISOString();
-      writeFileSync(file, JSON.stringify(data, null, 2));
+      bumpHeal(domain, primary, this.opts.healKnowledgeDir);
     } catch {
     }
   }
   forgetHealKnowledge(domain, primary) {
     try {
-      const file = this.healKnowledgeFile(domain);
-      const data = this.readHealFile(file);
-      if (!data[primary]) return;
-      delete data[primary];
-      writeFileSync(file, JSON.stringify(data, null, 2));
+      forgetHeal(domain, primary, this.opts.healKnowledgeDir);
     } catch {
     }
   }

package/package.json

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