@xbrowser/cli 1.9.7 → 1.9.8

package/dist/{browser-ALPLJNH2.js → browser-43YXUIML.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-37SHZSUR.js";
-import "./chunk-VJNMAWPZ.js";
+} from "./chunk-ENCEMM7Z.js";
+import "./chunk-GM3HWQ5U.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-JXIJF4VL.js → browser-GT4BMX6X.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-74S7UUI2.js";
+} from "./chunk-A4YHJW3Z.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-ZPQP6VW7.js → browser-SJWPJFN7.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-5JSOGINQ.js";
-import "./chunk-VJNMAWPZ.js";
+} from "./chunk-PBDID7SE.js";
+import "./chunk-GM3HWQ5U.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-ABXMBNQ6.js";

package/dist/{cdp-driver-6EVYLHL2.js → cdp-driver-PUZLDSQU.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-VJNMAWPZ.js";
+} from "./chunk-GM3HWQ5U.js";
 import {
   connectToCDP,
   findChrome,

package/dist/{cdp-driver-MI7VCE44.js → cdp-driver-WAFYSIIW.js}

@@ -1333,7 +1333,22 @@ Last error: ${lastError.message}` : "";
     return this._url;
   }
   async title() {
-    this._title = await this.evaluate("document.title");
+    for (let i = 0; i < 20; i++) {
+      try {
+        this._title = await this.evaluate("document.title");
+        if (this._title) return this._title;
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 50));
+    }
+    try {
+      const info = await this._cdpSend("Target.getTargetInfo", { targetId: this._targetId });
+      if (info?.title) {
+        this._title = info.title;
+        return this._title;
+      }
+    } catch {
+    }
     return this._title;
   }
   async content() {

package/dist/{chunk-74S7UUI2.js → chunk-A4YHJW3Z.js}

@@ -1338,7 +1338,22 @@ Last error: ${lastError.message}` : "";
     return this._url;
   }
   async title() {
-    this._title = await this.evaluate("document.title");
+    for (let i = 0; i < 20; i++) {
+      try {
+        this._title = await this.evaluate("document.title");
+        if (this._title) return this._title;
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 50));
+    }
+    try {
+      const info = await this._cdpSend("Target.getTargetInfo", { targetId: this._targetId });
+      if (info?.title) {
+        this._title = info.title;
+        return this._title;
+      }
+    } catch {
+    }
     return this._title;
   }
   async content() {
@@ -4965,7 +4980,7 @@ async function closeSessionByName(name) {
       } catch {
       }
       try {
-        const { SessionRecorder } = await import("./session-recorder-RFOPX4SF.js");
+        const { SessionRecorder } = await import("./session-recorder-AG6CH6EI.js");
         SessionRecorder.cleanup(session.name);
       } catch {
       }

package/dist/{chunk-CH5ZQV64.js → chunk-C3LIGO4V.js}

@@ -2020,17 +2020,37 @@ var SessionRecorder = class _SessionRecorder {
    * selector or the screenshot fails (non-critical — never blocks recording).
    *
    * Only captures for: click, input, change, dblclick, and their CDP counterparts.
+   *
+   * Retry strategy (3 attempts, 3s each):
+   *   1. element screenshot via locator
+   *   2. retry element screenshot (element may have been animating/detached)
+   *   3. fallback to viewport screenshot (so we always get *something*)
    */
   async captureElementScreenshot(page, action) {
     const keyTypes = ["click", "input", "change", "dblclick", "cdp-click", "cdp-fill", "filechooser"];
     if (!keyTypes.includes(action.type)) return;
     if (!action.element?.selector) return;
+    const selector = action.element.selector;
     try {
-      const buffer = await page.locator(action.element.selector).first().screenshot({
+      const buffer = await page.locator(selector).first().screenshot({
         type: "png",
-        timeout: 2e3
+        timeout: 3e3
       });
       return buffer.toString("base64");
+    } catch {
+    }
+    try {
+      await page.waitForSelector(selector, { state: "visible", timeout: 2e3 });
+      const buffer = await page.locator(selector).first().screenshot({
+        type: "png",
+        timeout: 3e3
+      });
+      return buffer.toString("base64");
+    } catch {
+    }
+    try {
+      const buffer = await page.screenshot({ type: "png", timeout: 3e3 });
+      return buffer.toString("base64");
     } catch {
       return;
     }

package/dist/{chunk-37SHZSUR.js → chunk-ENCEMM7Z.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-VJNMAWPZ.js";
+} from "./chunk-GM3HWQ5U.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -2021,7 +2021,7 @@ async function closeSessionByName(name) {
       } catch {
       }
       try {
-        const { SessionRecorder } = await import("./session-recorder-7GXI42FO.js");
+        const { SessionRecorder } = await import("./session-recorder-K3K63Q33.js");
         SessionRecorder.cleanup(session.name);
       } catch {
       }

package/dist/{chunk-VJNMAWPZ.js → chunk-GM3HWQ5U.js}

@@ -1332,7 +1332,22 @@ Last error: ${lastError.message}` : "";
     return this._url;
   }
   async title() {
-    this._title = await this.evaluate("document.title");
+    for (let i = 0; i < 20; i++) {
+      try {
+        this._title = await this.evaluate("document.title");
+        if (this._title) return this._title;
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 50));
+    }
+    try {
+      const info = await this._cdpSend("Target.getTargetInfo", { targetId: this._targetId });
+      if (info?.title) {
+        this._title = info.title;
+        return this._title;
+      }
+    } catch {
+    }
     return this._title;
   }
   async content() {

package/dist/{chunk-5JSOGINQ.js → chunk-PBDID7SE.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-VJNMAWPZ.js";
+} from "./chunk-GM3HWQ5U.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -656,7 +656,7 @@ async function closeSessionByName(name) {
       } catch {
       }
       try {
-        const { SessionRecorder } = await import("./session-recorder-RFOPX4SF.js");
+        const { SessionRecorder } = await import("./session-recorder-AG6CH6EI.js");
         SessionRecorder.cleanup(session.name);
       } catch {
       }

package/dist/{chunk-C4O73DQL.js → chunk-VEWTHYDG.js}

@@ -2417,17 +2417,37 @@ var SessionRecorder = class _SessionRecorder {
    * selector or the screenshot fails (non-critical — never blocks recording).
    *
    * Only captures for: click, input, change, dblclick, and their CDP counterparts.
+   *
+   * Retry strategy (3 attempts, 3s each):
+   *   1. element screenshot via locator
+   *   2. retry element screenshot (element may have been animating/detached)
+   *   3. fallback to viewport screenshot (so we always get *something*)
    */
   async captureElementScreenshot(page, action) {
     const keyTypes = ["click", "input", "change", "dblclick", "cdp-click", "cdp-fill", "filechooser"];
     if (!keyTypes.includes(action.type)) return;
     if (!action.element?.selector) return;
+    const selector = action.element.selector;
     try {
-      const buffer = await page.locator(action.element.selector).first().screenshot({
+      const buffer = await page.locator(selector).first().screenshot({
         type: "png",
-        timeout: 2e3
+        timeout: 3e3
       });
       return buffer.toString("base64");
+    } catch {
+    }
+    try {
+      await page.waitForSelector(selector, { state: "visible", timeout: 2e3 });
+      const buffer = await page.locator(selector).first().screenshot({
+        type: "png",
+        timeout: 3e3
+      });
+      return buffer.toString("base64");
+    } catch {
+    }
+    try {
+      const buffer = await page.screenshot({ type: "png", timeout: 3e3 });
+      return buffer.toString("base64");
     } catch {
       return;
     }

package/dist/cli.js

@@ -30,7 +30,7 @@ import {
 } from "./chunk-YAUG3NSI.js";
 import {
   SessionRecorder
-} from "./chunk-CH5ZQV64.js";
+} from "./chunk-C3LIGO4V.js";
 import {
   addKnownIssue,
   getKnowledgePath,
@@ -54,7 +54,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-74S7UUI2.js";
+} from "./chunk-A4YHJW3Z.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -7058,7 +7058,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-JXIJF4VL.js");
+    const { findTargetPage } = await import("./browser-GT4BMX6X.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.`);
@@ -11117,7 +11117,7 @@ async function handleFilter(args, _mode, options) {
   }
 }
 async function handleGeneratePlugin(sessionName, pluginName, outputDir) {
-  const { SessionRecorder: SessionRecorder2 } = await import("./session-recorder-RFOPX4SF.js");
+  const { SessionRecorder: SessionRecorder2 } = await import("./session-recorder-AG6CH6EI.js");
   const { readSiteKnowledge: readSiteKnowledge2, toMarkdown } = await import("./site-knowledge-SYC6VCDB.js");
   const { mkdirSync: mkdirSync10, writeFileSync: writeFileSync12 } = await import("fs");
   const { join: join13 } = await import("path");
@@ -13094,7 +13094,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-JXIJF4VL.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-GT4BMX6X.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -13370,7 +13370,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-JXIJF4VL.js");
+      const { ensureProcessCanExit } = await import("./browser-GT4BMX6X.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(process.exitCode || exitCode);

package/dist/daemon-main.js

@@ -13,7 +13,7 @@ import {
 } from "./chunk-VEDJ5XSQ.js";
 import {
   SessionRecorder
-} from "./chunk-C4O73DQL.js";
+} from "./chunk-VEWTHYDG.js";
 import {
   closeEphemeralContext,
   closeSessionByName,
@@ -29,8 +29,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-37SHZSUR.js";
-import "./chunk-VJNMAWPZ.js";
+} from "./chunk-ENCEMM7Z.js";
+import "./chunk-GM3HWQ5U.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -6575,7 +6575,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-ALPLJNH2.js");
+    const { findTargetPage } = await import("./browser-43YXUIML.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.`);
@@ -8167,7 +8167,7 @@ function createRPCHandler() {
     const sessionName = params.session || "default";
     const slowMo = params.slowMo || 1;
     if (!file) {
-      return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: "Missing file parameter" }] };
+      return normalizeReplayResult({ ok: false, errors: [{ eventIndex: -1, error: "Missing file parameter" }] });
     }
     let rawContent;
     let parsed;
@@ -8180,55 +8180,54 @@ function createRPCHandler() {
         parsed = yaml2.parse(rawContent);
       }
       if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-        return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: `File "${file}" does not contain a valid recording. Expected a JSON/YAML object with an "actions" or "events" array, got ${parsed === null ? "empty content" : typeof parsed}.` }] };
+        return normalizeReplayResult({ ok: false, errors: [{ eventIndex: -1, error: `File "${file}" does not contain a valid recording. Expected a JSON/YAML object with an "actions" or "events" array, got ${parsed === null ? "empty content" : typeof parsed}.` }] });
       }
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
-      return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: `Failed to parse "${file}" as JSON or YAML: ${msg.split("\n")[0]}` }] };
+      return normalizeReplayResult({ ok: false, errors: [{ eventIndex: -1, error: `Failed to parse "${file}" as JSON or YAML: ${msg.split("\n")[0]}` }] });
     }
     const session = findSession(sessionName);
     if (!session) {
-      return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: `Session not found: ${sessionName}. Open a browser first: xbrowser goto <url> --session ${sessionName}` }] };
+      return normalizeReplayResult({ ok: false, errors: [{ eventIndex: -1, error: `Session not found: ${sessionName}. Open a browser first: xbrowser goto <url> --session ${sessionName}` }] });
     }
     if (!session.page) {
-      return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: "Session has no page: " + sessionName }] };
+      return normalizeReplayResult({ ok: false, errors: [{ eventIndex: -1, error: "Session has no page: " + sessionName }] });
     }
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {
       try {
         const replayErrors = [];
-        const { SessionReplayer } = await import("./session-replayer-3HEIJBJ2.js");
+        const { SessionReplayer } = await import("./session-replayer-V4MP6M6I.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,
           onStep: (action, index, total) => {
             console.log(`[replay] Step ${index + 1}/${total}: ${action.type} ${action.element?.selector || action.url || ""}`);
           },
-          onError: (action, error) => {
+          onError: (action, error, index) => {
             const msg = `[${action?.type || "unknown"}] ${error?.message || String(error)}`;
             console.error("[replay] Error at step:", msg);
-            replayErrors.push({ eventIndex: -1, error: msg });
+            replayErrors.push({ eventIndex: index, error: msg });
           }
         });
         if (!Array.isArray(parsed.actions) || typeof parsed.startUrl !== "string") {
-          return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: "Invalid recording format: missing actions or startUrl" }] };
+          return normalizeReplayResult({ ok: false, errors: [{ eventIndex: -1, error: "Invalid recording format: missing actions or startUrl" }] });
         }
         await replayer.load(parsed);
         const startTime = Date.now();
         const result2 = await replayer.run();
         const duration = Date.now() - startTime;
-        return {
+        return normalizeReplayResult({
           ok: result2.failed === 0,
-          success: result2.failed === 0,
           duration,
           eventsPlayed: result2.success,
           totalEvents: result2.success + result2.failed + result2.skipped,
           errors: replayErrors
-        };
+        });
       } catch (e) {
         const msg = e instanceof Error ? e.message : String(e);
         console.error("[replay] SessionReplayer error:", msg);
-        return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: "Replay failed: " + msg }] };
+        return normalizeReplayResult({ ok: false, errors: [{ eventIndex: -1, error: "Replay failed: " + msg }] });
       }
     }
     const engine = PlaybackEngine.fromFile(session.page, file);
@@ -8242,7 +8241,21 @@ function createRPCHandler() {
         });
       }
     });
-    return { ok: result.success, ...result };
+    return normalizeReplayResult({ ok: result.success, ...result });
+  }
+  function normalizeReplayResult(input) {
+    const errors = Array.isArray(input.errors) ? input.errors : [];
+    const eventsPlayed = typeof input.eventsPlayed === "number" ? input.eventsPlayed : 0;
+    const totalEvents = typeof input.totalEvents === "number" ? input.totalEvents : eventsPlayed + errors.length;
+    const ok26 = input.ok ?? errors.length === 0;
+    return {
+      ok: ok26,
+      success: ok26,
+      duration: typeof input.duration === "number" ? input.duration : 0,
+      eventsPlayed,
+      totalEvents,
+      errors
+    };
   }
   async function handleViewerCheckSelector(params) {
     const name = params.name || "default";

package/dist/index.d.ts

@@ -1939,6 +1939,11 @@ declare class SessionRecorder {
      * selector or the screenshot fails (non-critical — never blocks recording).
      *
      * Only captures for: click, input, change, dblclick, and their CDP counterparts.
+     *
+     * Retry strategy (3 attempts, 3s each):
+     *   1. element screenshot via locator
+     *   2. retry element screenshot (element may have been animating/detached)
+     *   3. fallback to viewport screenshot (so we always get *something*)
      */
     private captureElementScreenshot;
     /**

package/dist/index.js

@@ -61,7 +61,7 @@ import {
 } from "./chunk-ANVL2ID2.js";
 import {
   SessionRecorder
-} from "./chunk-CH5ZQV64.js";
+} from "./chunk-C3LIGO4V.js";
 import {
   addKnownIssue,
   getKnowledgePath,
@@ -86,8 +86,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-5JSOGINQ.js";
-import "./chunk-VJNMAWPZ.js";
+} from "./chunk-PBDID7SE.js";
+import "./chunk-GM3HWQ5U.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -7406,7 +7406,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-ZPQP6VW7.js");
+    const { findTargetPage } = await import("./browser-SJWPJFN7.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.`);
@@ -11503,7 +11503,7 @@ async function handleFilter(args, _mode, options) {
   }
 }
 async function handleGeneratePlugin(sessionName, pluginName, outputDir) {
-  const { SessionRecorder: SessionRecorder2 } = await import("./session-recorder-RFOPX4SF.js");
+  const { SessionRecorder: SessionRecorder2 } = await import("./session-recorder-AG6CH6EI.js");
   const { readSiteKnowledge: readSiteKnowledge2, toMarkdown } = await import("./site-knowledge-SYC6VCDB.js");
   const { mkdirSync: mkdirSync11, writeFileSync: writeFileSync13 } = await import("fs");
   const { join: join14 } = await import("path");
@@ -13480,7 +13480,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-ZPQP6VW7.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-SJWPJFN7.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -16543,7 +16543,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-6EVYLHL2.js");
+    const { launch } = await import("./cdp-driver-PUZLDSQU.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

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

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

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

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

package/dist/{session-replayer-3HEIJBJ2.js → session-replayer-V4MP6M6I.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-6EVYLHL2.js");
+      const { launch } = await import("./cdp-driver-PUZLDSQU.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {
@@ -65,7 +65,7 @@ var SessionReplayer = class {
         success++;
       } catch (e) {
         const err = e instanceof Error ? e : new Error(String(e));
-        this.opts.onError?.(action, err);
+        this.opts.onError?.(action, err, i);
         failed++;
       }
       if (i < actions.length - 1) {

package/package.json

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