@xbrowser/cli 1.25.2 → 1.27.0

package/dist/index.js

@@ -48,7 +48,7 @@ import {
   splitCommand,
   waitForAIResponse,
   waitForPage
-} from "./chunk-DRKL2RFQ.js";
+} from "./chunk-IDXOIXQR.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-WDDGIV3C.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-IBQGNDSB.js → server-WDDGIV3C.js}

@@ -1,20 +1,114 @@
 import {
   executeChain,
   executeCommand
-} from "./chunk-DRKL2RFQ.js";
-import "./chunk-NNI5RT4A.js";
+} from "./chunk-IDXOIXQR.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/{server-EZJW6IHU.js → server-YKMRFDEM.js}

@@ -1,17 +1,111 @@
 import {
   executeChain,
   executeCommand
-} from "./chunk-PO27V5UH.js";
+} from "./chunk-YITK42HZ.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/{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.27.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": {