@xbrowser/cli 1.9.8 → 1.10.0

package/dist/recovery-ZJVVHP7N.js

@@ -0,0 +1,76 @@
+import {
+  buildViewerUrl
+} from "./chunk-3OD76SUE.js";
+import {
+  HumanInteractionManager
+} from "./chunk-DWDXEGVK.js";
+import "./chunk-Q2DFJQGS.js";
+import "./chunk-KFQGP6VL.js";
+
+// src/recovery.ts
+function getRecoveryConfig() {
+  const val = process.env.XBROWSER_RECOVERY?.toLowerCase();
+  return {
+    enabled: val === "true" || val === "1" || val === "yes",
+    timeout: Math.max(10, parseInt(process.env.XBROWSER_RECOVERY_TIMEOUT || "120", 10))
+  };
+}
+async function attemptRecovery(page, sessionName, commandName, errorMessage, previewWS) {
+  const cfg = getRecoveryConfig();
+  if (!cfg.enabled) return { recovered: false };
+  if (!page) {
+    return { recovered: false };
+  }
+  const viewerUrl = buildViewerUrl(sessionName);
+  if (previewWS) {
+    try {
+      previewWS.registerSession(sessionName, page);
+      const manager = new HumanInteractionManager(previewWS, page);
+      const result = await manager.waitForHuman({
+        reason: `Command "${commandName}" failed: ${errorMessage}. Fix the issue and confirm via viewer.`,
+        timeout: cfg.timeout,
+        autoDetect: false
+      });
+      return { recovered: result.solved };
+    } catch {
+    }
+  }
+  console.log("");
+  console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+  console.log(`\u26A0\uFE0F  COMMAND FAILED: ${commandName}`);
+  console.log(`\u26A0\uFE0F  Error: ${errorMessage}`);
+  console.log(`\u26A0\uFE0F  `);
+  console.log(`\u26A0\uFE0F  Recovery mode activated`);
+  if (viewerUrl) {
+    console.log(`\u26A0\uFE0F  Viewer: ${viewerUrl}`);
+  }
+  console.log(`\u26A0\uFE0F  `);
+  console.log(`\u26A0\uFE0F  Fix the issue, then press ENTER to retry`);
+  console.log(`\u26A0\uFE0F  Type "abort" + ENTER to cancel`);
+  console.log(`\u26A0\uFE0F  (${cfg.timeout}s timeout)`);
+  console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+  console.log("");
+  return new Promise((resolve) => {
+    const cleanup = () => {
+      clearTimeout(timeoutTimer);
+      process.stdin.removeListener("data", onData);
+      process.stdin.pause();
+    };
+    const timeoutTimer = setTimeout(() => {
+      console.log("\u23F0 Recovery timeout \u2014 aborting");
+      cleanup();
+      resolve({ recovered: false });
+    }, cfg.timeout * 1e3);
+    const onData = (buf) => {
+      const line = buf.toString().trim().toLowerCase();
+      cleanup();
+      resolve({ recovered: line !== "abort" && line !== "q" && line !== "exit" });
+    };
+    process.stdin.resume();
+    process.stdin.on("data", onData);
+  });
+}
+export {
+  attemptRecovery,
+  getRecoveryConfig
+};

package/dist/{session-recorder-K3K63Q33.js → session-recorder-H3KEYU26.js}

@@ -1,6 +1,6 @@
 import {
   SessionRecorder
-} from "./chunk-VEWTHYDG.js";
+} from "./chunk-5UGR6MUK.js";
 import "./chunk-KFQGP6VL.js";
 export {
   SessionRecorder

package/dist/{session-recorder-AG6CH6EI.js → session-recorder-QRZMKFVL.js}

@@ -1,6 +1,6 @@
 import {
   SessionRecorder
-} from "./chunk-C3LIGO4V.js";
+} from "./chunk-4452SPFI.js";
 import "./chunk-OZKD3W4X.js";
 import "./chunk-KFQGP6VL.js";
 export {

package/dist/{session-replayer-V4MP6M6I.js → session-replayer-LJUC4TI7.js}

@@ -31,7 +31,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-PUZLDSQU.js");
+      const { launch } = await import("./cdp-driver-J3YQ4LJV.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {
@@ -79,6 +79,11 @@ var SessionReplayer = class {
     const page = this.page;
     const timeout = this.opts.stepTimeout;
     switch (action.type) {
+      // Proactive sensing actions are observations, not user actions — skip
+      // them during replay (they don't represent anything the user did).
+      case "popup_appear":
+      case "discovered_filters":
+        return;
       case "navigation":
         await page.goto(action.url, { waitUntil: "load", timeout });
         break;
@@ -153,7 +158,19 @@ var SessionReplayer = class {
       }
       case "hover": {
         const selector = await this.resolveAndWait(action);
-        await page.hover(selector);
+        if (selector) {
+          await page.hover(selector);
+        }
+        const firstPopup = action.hoverContext?.appeared?.[0];
+        if (firstPopup?.selector) {
+          try {
+            await page.waitForSelector(firstPopup.selector, {
+              state: "visible",
+              timeout: 1e3
+            });
+          } catch {
+          }
+        }
         break;
       }
       case "drag": {
@@ -257,7 +274,9 @@ var SessionReplayer = class {
    * Returns the first matching selector, or throws if none match.
    * Fallback order:
    *   1. Primary CSS selector (always tried first)
-   *   2. textFallback selector (for low-confidence selectors when primary fails)
+   *   2. textFallback selector (used when primary fails — not just for low
+   *      confidence, since high-confidence selectors from dynamic attributes
+   *      like data-spm-anchor-id can also fail on replay)
    *   3. Tag-based fallback (last resort)
    */
   async resolveAndWait(action) {
@@ -267,10 +286,8 @@ var SessionReplayer = class {
     const timeout = this.opts.stepTimeout;
     const candidates = [];
     if (el.selector) candidates.push(el.selector);
-    if (el.confidence === "low" && el.textFallback?.selector) {
-      if (!candidates.includes(el.textFallback.selector)) {
-        candidates.push(el.textFallback.selector);
-      }
+    if (el.textFallback?.selector && !candidates.includes(el.textFallback.selector)) {
+      candidates.push(el.textFallback.selector);
     }
     if (el.tag && !candidates.includes(el.tag)) {
       candidates.push(el.tag);

package/package.json

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