@xbrowser/cli 1.9.4 → 1.9.6

package/dist/index.d.ts

@@ -1812,6 +1812,13 @@ interface RecordingStep {
         networkId: number;
         paramName: string;
     }>;
+    signals: ActionSignal[];
+}
+/** Success / verification signal attached to a recording step */
+interface ActionSignal {
+    type: 'network_success' | 'url_change' | 'dialog' | 'dom_change';
+    value?: string;
+    label: string;
 }
 interface RecordingSummary {
     startUrl: string;
@@ -1871,12 +1878,17 @@ declare class SessionRecorder {
     private lastActionTs;
     private activePages;
     private lastKnownUrl;
-    /** Dedup window: after a CDP command action, ignore matching action signals within this window */
-    private cdpActionDedup;
+    /** Dedup map: key = normalizedType|tag|value → expiration timestamp.
+     *  Replaces old single-entry cdpActionDedup for bidirectional dedup. */
+    private dedupMap;
+    private dedupActionCount;
     /** Network dedup: last request key for short-window dedup */
     private _lastRequestKey;
     private _lastRequestTs;
     private _isRecording;
+    private streamMode;
+    /** Ambient action types: filtered out in clean mode */
+    private static readonly AMBIENT_TYPES;
     constructor(context: XBContext, page: XBPage, sessionName: string);
     get isRecording(): boolean;
     get actionCount(): number;
@@ -1888,6 +1900,8 @@ declare class SessionRecorder {
         url?: string;
         element?: UserAction['element'];
     }): Promise<void>;
+    /** Generate dedup key for an action (normalized type + selector/tag + value). */
+    private dedupKey;
     get networkCount(): number;
     getLiveData(): RecordingData;
     addManualCheckpoint(type: string, hint: string, selector?: string): CheckpointEntry;
@@ -1898,7 +1912,9 @@ declare class SessionRecorder {
     get controlFilePath(): string;
     /** Path to the stop signal file (written by `record stop`). */
     get stopSignalPath(): string;
-    start(url?: string): Promise<void>;
+    start(url?: string, options?: {
+        stream?: 'clean' | 'raw';
+    }): Promise<void>;
     stop(): Promise<{
         data: RecordingData;
         summary: RecordingSummary;
@@ -1932,6 +1948,11 @@ declare class SessionRecorder {
      */
     private captureClickContext;
     private detectCheckpoints;
+    /**
+     * After a key action (click/submit/input), check for success signals:
+     * URL changes, recent successful network responses, dialog appearances.
+     */
+    private verifyAction;
     private flushToDisk;
     private writeFinalOutput;
     private buildData;

package/dist/index.js

@@ -44,7 +44,7 @@ import {
   startDaemonProcess,
   stopDaemonProcess,
   version
-} from "./chunk-53LRNYPG.js";
+} from "./chunk-YAUG3NSI.js";
 import {
   generateBashScript,
   generateJSScript,
@@ -61,7 +61,7 @@ import {
 } from "./chunk-ANVL2ID2.js";
 import {
   SessionRecorder
-} from "./chunk-YSCY52UJ.js";
+} from "./chunk-CH5ZQV64.js";
 import {
   addKnownIssue,
   getKnowledgePath,
@@ -86,7 +86,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-MSQIPXKE.js";
+} from "./chunk-5JSOGINQ.js";
 import "./chunk-VJNMAWPZ.js";
 import "./chunk-TNEN6VQ2.js";
 import {
@@ -6678,6 +6678,22 @@ async function checkPluginLoginRequired(options) {
   const requiresLogin = command.requiresLogin === true || site.config?.requiresLogin === true || loginConfig?.requiresLogin === true || command.loginRequired === "required";
   if (!requiresLogin) return { ok: true };
   const pluginName = site.name || "plugin";
+  const siteConfig = site.config;
+  const configIsLogin = siteConfig?.isLogin;
+  if (configIsLogin) {
+    try {
+      const loggedIn = await configIsLogin(ctx);
+      if (loggedIn) return { ok: true };
+      return buildLoginRequired({
+        plugin: pluginName,
+        command: commandName,
+        reason: "config.isLogin returned false",
+        sessionName,
+        loginConfig
+      });
+    } catch {
+    }
+  }
   if (typeof site.isLoggedIn === "function") {
     try {
       const loggedIn = await site.isLoggedIn(ctx);
@@ -7390,7 +7406,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-C63PFGPT.js");
+    const { findTargetPage } = await import("./browser-ZPQP6VW7.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.`);
@@ -7407,7 +7423,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     params = result.data;
   }
   if (command.scope !== "cli" && !process.env.XBROWSER_DAEMON_WORKER) {
-    const { forwardExec } = await import("./daemon-client-TOUDMIY5.js");
+    const { forwardExec } = await import("./daemon-client-CMRAWXTN.js");
     const result = await forwardExec(commandName, params, sessionName, extraOpts?.cdpEndpoint);
     if (result) return result;
   }
@@ -8852,7 +8868,7 @@ var PluginInstaller = class {
 import { outputFormatter, OutputFormatter } from "@dyyz1993/xcli-core";
 var formatter = new OutputFormatter();
 function outputResult(result, mode = "text") {
-  if (typeof result === "object" && result !== null) {
+  if (mode !== "json" && mode !== "yaml" && typeof result === "object" && result !== null) {
     const r = result;
     if (r.success === false) {
       outputError(r.message ? String(r.message) : "Unknown error");
@@ -10866,7 +10882,7 @@ async function handlePlugin(args, options, mode) {
       } catch {
       }
       try {
-        const { daemonPing } = await import("./daemon-client-TOUDMIY5.js");
+        const { daemonPing } = await import("./daemon-client-CMRAWXTN.js");
         if (await daemonPing()) {
           await fetch("http://localhost:9224/rpc", {
             method: "POST",
@@ -11024,7 +11040,8 @@ async function handleRecord(args, options, mode) {
       const url = options.url;
       const sessionName = options.session || "default";
       const cdpEndpoint = options.cdp;
-      const result = await forwardRecordStart(sessionName, url, cdpEndpoint);
+      const stream = options.stream || "clean";
+      const result = await forwardRecordStart(sessionName, url, cdpEndpoint, stream);
       if (!result.ok) {
         outputError(String(result.error || "Failed to start recording"));
         return;
@@ -11319,7 +11336,15 @@ async function handleReplay(args, options, mode) {
   const absPath = await import("path").then((p) => p.resolve(filePath));
   const result = await forwardReplay(absPath, sessionName, slowMo);
   if (!result.ok) {
-    outputError(String(result.errors ? result.errors.map((e) => e.error).join("; ") : result.error || "Replay failed"));
+    if (mode === "json" || mode === "yaml") {
+      outputResult({
+        ...result,
+        success: false,
+        message: result.errors ? result.errors.map((e) => e.error).join("; ") : result.error || "Replay failed"
+      }, mode);
+    } else {
+      outputError(String(result.errors ? result.errors.map((e) => e.error).join("; ") : result.error || "Replay failed"));
+    }
     return;
   }
   outputResult(result, mode);
@@ -11423,7 +11448,7 @@ async function handleFilter(args, _mode, options) {
   }
 }
 async function handleGeneratePlugin(sessionName, pluginName, outputDir) {
-  const { SessionRecorder: SessionRecorder2 } = await import("./session-recorder-KPU4YQAE.js");
+  const { SessionRecorder: SessionRecorder2 } = await import("./session-recorder-RFOPX4SF.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");
@@ -13360,7 +13385,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
           }
           const needsBrowser = cmdEntry.scope === "page" || cmdEntry.scope === "browser";
           if (needsBrowser && !process.env.XBROWSER_DAEMON_WORKER) {
-            const { forwardExec } = await import("./daemon-client-TOUDMIY5.js");
+            const { forwardExec } = await import("./daemon-client-CMRAWXTN.js");
             const userTimeout = typeof params.timeout === "number" && params.timeout > 0 ? params.timeout * 1e3 + 3e4 : void 0;
             const result = await forwardExec(`${command}.${subCommand}`, params, sessionName, cdpEndpoint, userTimeout);
             const resultData = result && typeof result === "object" && "data" in result ? result.data : void 0;
@@ -13400,7 +13425,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-C63PFGPT.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-ZPQP6VW7.js");
               setActivePage2(session, targetPage);
             }
           }

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

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

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

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

package/dist/{session-replayer-RWFOWH3F.js → session-replayer-3HEIJBJ2.js}

@@ -56,15 +56,17 @@ var SessionReplayer = class {
           await this.replayTrajectory(action.trajectory);
         }
         await this.replayAction(action);
+        if (action.type !== "resize" && action.type !== "clipboard" && action.type !== "visibility") {
+          try {
+            await this.page.waitForLoadState("domcontentloaded", this.opts.stepTimeout);
+          } catch {
+          }
+        }
         success++;
       } catch (e) {
         const err = e instanceof Error ? e : new Error(String(e));
         this.opts.onError?.(action, err);
-        if (action.type === "navigation") {
-          skipped++;
-        } else {
-          failed++;
-        }
+        failed++;
       }
       if (i < actions.length - 1) {
         await new Promise((r) => setTimeout(r, this.opts.stepDelay));
@@ -78,41 +80,36 @@ var SessionReplayer = class {
     const timeout = this.opts.stepTimeout;
     switch (action.type) {
       case "navigation":
-        await page.goto(action.url, { waitUntil: "domcontentloaded", timeout });
+        await page.goto(action.url, { waitUntil: "load", timeout });
         break;
       case "goto":
-        await page.goto(action.url, { waitUntil: "domcontentloaded", timeout });
+        await page.goto(action.url, { waitUntil: "load", timeout });
         break;
       case "click":
       case "cdp-click": {
-        const selector = this.resolveSelector(action);
-        await page.waitForSelector(selector, { state: "visible", timeout });
+        const selector = await this.resolveAndWait(action);
         await page.click(selector, { timeout });
         break;
       }
       case "input": {
-        const selector = this.resolveSelector(action);
-        await page.waitForSelector(selector, { state: "visible", timeout });
+        const selector = await this.resolveAndWait(action);
         await page.fill(selector, action.value ?? "", { timeout });
         break;
       }
       case "cdp-fill": {
-        const selector = this.resolveSelector(action);
-        await page.waitForSelector(selector, { state: "visible", timeout });
+        const selector = await this.resolveAndWait(action);
         await page.fill(selector, action.value ?? "", { timeout });
         break;
       }
       case "change": {
-        const selector = this.resolveSelector(action);
-        await page.waitForSelector(selector, { state: "visible", timeout });
+        const selector = await this.resolveAndWait(action);
         if (action.value) {
           await page.selectOption(selector, action.value);
         }
         break;
       }
       case "filechooser": {
-        const selector = this.resolveSelector(action);
-        await page.waitForSelector(selector, { state: "visible", timeout });
+        const selector = await this.resolveAndWait(action);
         const files = this.resolveFiles(action);
         if (files.length > 0) {
           await page.setInputFiles(selector, files);
@@ -155,11 +152,8 @@ var SessionReplayer = class {
         break;
       }
       case "hover": {
-        const selector = this.resolveSelector(action);
-        if (selector) {
-          await page.waitForSelector(selector, { state: "visible", timeout });
-          await page.hover(selector);
-        }
+        const selector = await this.resolveAndWait(action);
+        await page.hover(selector);
         break;
       }
       case "drag": {
@@ -199,10 +193,9 @@ var SessionReplayer = class {
         break;
       }
       case "focus": {
-        const selector = this.resolveSelector(action);
-        if (selector && action.focus?.focusType === "focus") {
-          await page.waitForSelector(selector, { state: "visible", timeout });
-          await page.click(selector, { timeout });
+        const selector = await this.resolveAndWait(action);
+        if (action.focus?.focusType === "focus") {
+          await page.locator(selector).focus();
         }
         break;
       }
@@ -210,10 +203,16 @@ var SessionReplayer = class {
         break;
       }
       case "submit": {
-        const selector = this.resolveSelector(action);
-        if (selector) {
-          await page.click(selector, { timeout });
-        }
+        const selector = await this.resolveAndWait(action);
+        await page.evaluate((sel) => {
+          const form = document.querySelector(sel);
+          if (!form) return;
+          if (typeof form.requestSubmit === "function") {
+            form.requestSubmit();
+          } else {
+            form.dispatchEvent(new Event("submit", { bubbles: true, cancelable: true }));
+          }
+        }, selector);
         break;
       }
       case "scroll": {
@@ -239,12 +238,10 @@ var SessionReplayer = class {
       await page.mouse.move(x, y);
     }
   }
-  /** Resolve the best selector for an action */
+  /** Resolve the best selector for an action (primary selector only) */
   resolveSelector(action) {
     const el = action.element;
     if (!el) return "";
-    if (el.textFallback) {
-    }
     if (el.selector) {
       return el.selector;
     }
@@ -253,6 +250,41 @@ var SessionReplayer = class {
     }
     return "";
   }
+  /**
+   * X2: Wait for an element using the best available selector, with
+   * confidence-based fallback support.
+   *
+   * 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)
+   *   3. Tag-based fallback (last resort)
+   */
+  async resolveAndWait(action) {
+    const el = action.element;
+    if (!el) throw new Error("No element metadata");
+    const page = this.page;
+    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.tag && !candidates.includes(el.tag)) {
+      candidates.push(el.tag);
+    }
+    if (candidates.length === 0) throw new Error("No selector available for element");
+    for (const sel of candidates) {
+      try {
+        await page.waitForSelector(sel, { state: "visible", timeout });
+        return sel;
+      } catch {
+      }
+    }
+    throw new Error(`Element not found, tried: ${candidates.join(", ")}`);
+  }
   /** Resolve file payloads from a filechooser action */
   resolveFiles(action) {
     if (!action.files?.fileData) return [];

package/package.json

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