@xbrowser/cli 1.8.6 → 1.9.0

package/dist/{browser-XPKM344Y.js → browser-4KRHALJ3.js}

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

package/dist/{browser-LW2MDJE4.js → browser-6WJHQDPV.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-HXLMMSU3.js";
+} from "./chunk-OOJ2H7IL.js";
 import "./chunk-VJNMAWPZ.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{browser-TLIDFFEG.js → browser-C63PFGPT.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-CJJ564VK.js";
+} from "./chunk-MSQIPXKE.js";
 import "./chunk-VJNMAWPZ.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{chunk-CJJ564VK.js → chunk-MSQIPXKE.js}

@@ -656,7 +656,7 @@ async function closeSessionByName(name) {
       } catch {
       }
       try {
-        const { SessionRecorder } = await import("./session-recorder-33UKWCIR.js");
+        const { SessionRecorder } = await import("./session-recorder-KPU4YQAE.js");
         SessionRecorder.cleanup(session.name);
       } catch {
       }

package/dist/{chunk-HXLMMSU3.js → chunk-OOJ2H7IL.js}

@@ -2021,7 +2021,7 @@ async function closeSessionByName(name) {
       } catch {
       }
       try {
-        const { SessionRecorder } = await import("./session-recorder-BMIJ3ZJM.js");
+        const { SessionRecorder } = await import("./session-recorder-UTULJFTE.js");
         SessionRecorder.cleanup(session.name);
       } catch {
       }

package/dist/{chunk-FL6DOSWV.js → chunk-TTZNR3QP.js}

@@ -1639,7 +1639,7 @@ var SessionRecorder = class _SessionRecorder {
     return this.actions.length;
   }
   /** Record an action triggered by a CDP command (e.g. xbrowser fill/click/goto) */
-  recordCommandAction(action) {
+  async recordCommandAction(action) {
     const normalizedType = action.type === "cdp-fill" ? "input" : action.type === "cdp-click" ? "click" : action.type;
     const recent = this.actions[this.actions.length - 1];
     if (recent && Date.now() - recent.timestamp < 1500) {
@@ -1653,7 +1653,7 @@ var SessionRecorder = class _SessionRecorder {
     this.actionCounter++;
     const ts = Date.now();
     const actionUrl = action.url && action.url !== "about:blank" ? action.url : this.lastKnownUrl || this.page.url();
-    this.actions.push({
+    const actionToPush = {
       id: this.actionCounter,
       type: action.type,
       timestamp: ts,
@@ -1661,6 +1661,11 @@ var SessionRecorder = class _SessionRecorder {
       pageTitle: "",
       element: action.element || (action.selector ? { tag: "", selector: action.selector, text: "" } : void 0),
       value: action.value
+    };
+    this.actions.push(actionToPush);
+    actionToPush.elementScreenshot = await this.captureElementScreenshot(this.page, {
+      type: action.type,
+      element: actionToPush.element
     });
     this.lastActionTs = ts;
     this.cdpActionDedup = {
@@ -2319,6 +2324,8 @@ var SessionRecorder = class _SessionRecorder {
         clickContext,
         files: raw.files
       });
+      const pushed = this.actions[this.actions.length - 1];
+      pushed.elementScreenshot = await this.captureElementScreenshot(page, raw);
       this.lastActionTs = raw.ts;
       if (raw.type === "click" || raw.type === "navigate" || raw.type === "submit") {
         const detected = await this.detectCheckpoints(page);
@@ -2329,6 +2336,27 @@ var SessionRecorder = class _SessionRecorder {
       }
     }
   }
+  /**
+   * Capture a screenshot of the target element for key action types.
+   * Returns a base64-encoded PNG string, or undefined if the element has no
+   * selector or the screenshot fails (non-critical — never blocks recording).
+   *
+   * Only captures for: click, input, change, dblclick, and their CDP counterparts.
+   */
+  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;
+    try {
+      const buffer = await page.locator(action.element.selector).first().screenshot({
+        type: "png",
+        timeout: 2e3
+      });
+      return buffer.toString("base64");
+    } catch {
+      return;
+    }
+  }
   /**
    * After a click, wait 300ms then scan for popover/dropdown/menu elements
    * near the click position. This runs server-side to avoid race conditions

package/dist/{chunk-RMYEHTLS.js → chunk-YSCY52UJ.js}

@@ -1242,7 +1242,7 @@ var SessionRecorder = class _SessionRecorder {
     return this.actions.length;
   }
   /** Record an action triggered by a CDP command (e.g. xbrowser fill/click/goto) */
-  recordCommandAction(action) {
+  async recordCommandAction(action) {
     const normalizedType = action.type === "cdp-fill" ? "input" : action.type === "cdp-click" ? "click" : action.type;
     const recent = this.actions[this.actions.length - 1];
     if (recent && Date.now() - recent.timestamp < 1500) {
@@ -1256,7 +1256,7 @@ var SessionRecorder = class _SessionRecorder {
     this.actionCounter++;
     const ts = Date.now();
     const actionUrl = action.url && action.url !== "about:blank" ? action.url : this.lastKnownUrl || this.page.url();
-    this.actions.push({
+    const actionToPush = {
       id: this.actionCounter,
       type: action.type,
       timestamp: ts,
@@ -1264,6 +1264,11 @@ var SessionRecorder = class _SessionRecorder {
       pageTitle: "",
       element: action.element || (action.selector ? { tag: "", selector: action.selector, text: "" } : void 0),
       value: action.value
+    };
+    this.actions.push(actionToPush);
+    actionToPush.elementScreenshot = await this.captureElementScreenshot(this.page, {
+      type: action.type,
+      element: actionToPush.element
     });
     this.lastActionTs = ts;
     this.cdpActionDedup = {
@@ -1922,6 +1927,8 @@ var SessionRecorder = class _SessionRecorder {
         clickContext,
         files: raw.files
       });
+      const pushed = this.actions[this.actions.length - 1];
+      pushed.elementScreenshot = await this.captureElementScreenshot(page, raw);
       this.lastActionTs = raw.ts;
       if (raw.type === "click" || raw.type === "navigate" || raw.type === "submit") {
         const detected = await this.detectCheckpoints(page);
@@ -1932,6 +1939,27 @@ var SessionRecorder = class _SessionRecorder {
       }
     }
   }
+  /**
+   * Capture a screenshot of the target element for key action types.
+   * Returns a base64-encoded PNG string, or undefined if the element has no
+   * selector or the screenshot fails (non-critical — never blocks recording).
+   *
+   * Only captures for: click, input, change, dblclick, and their CDP counterparts.
+   */
+  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;
+    try {
+      const buffer = await page.locator(action.element.selector).first().screenshot({
+        type: "png",
+        timeout: 2e3
+      });
+      return buffer.toString("base64");
+    } catch {
+      return;
+    }
+  }
   /**
    * After a click, wait 300ms then scan for popover/dropdown/menu elements
    * near the click position. This runs server-side to avoid race conditions

package/dist/{chunk-SJLRCE6N.js → chunk-Z7WC4P2M.js}

@@ -4965,7 +4965,7 @@ async function closeSessionByName(name) {
       } catch {
       }
       try {
-        const { SessionRecorder } = await import("./session-recorder-33UKWCIR.js");
+        const { SessionRecorder } = await import("./session-recorder-KPU4YQAE.js");
         SessionRecorder.cleanup(session.name);
       } catch {
       }

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   SessionRecorder
-} from "./chunk-RMYEHTLS.js";
+} from "./chunk-YSCY52UJ.js";
 import {
   addKnownIssue,
   getKnowledgePath,
@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-SJLRCE6N.js";
+} from "./chunk-Z7WC4P2M.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -182,7 +182,7 @@ function asZodSchema(value) {
 // src/executor.ts
 import {
   ok as ok25,
-  fail as fail8,
+  fail as fail9,
   isCommandResult,
   CompositeStorage as CompositeStorage2,
   TipCollector as TipCollector2,
@@ -2316,7 +2316,7 @@ var scrapeCommand = registerCommand({
   scope: "project",
   selectorParams: ["selector"],
   parameters: z15.object({
-    url: z15.string(),
+    url: z15.string().optional(),
     selector: z15.string().optional(),
     timeout: z15.number().default(3e4),
     format: z15.enum(["markdown", "html", "text"]).default("markdown"),
@@ -2329,10 +2329,14 @@ var scrapeCommand = registerCommand({
     const { context, page } = await createEphemeralContext(resolveLaunchOpts(ctx));
     const maxAttempts = p.retries + 1;
     try {
+      const targetUrl = p.url || page.url();
+      if (!targetUrl || targetUrl === "about:blank") {
+        return fail3("URL is required. Provide a URL or connect to a browser (--cdp) with a non-blank page.");
+      }
       let lastError;
       for (let attempt = 1; attempt <= maxAttempts; attempt++) {
         try {
-          await page.goto(p.url, { waitUntil: "commit", timeout: p.timeout });
+          await page.goto(targetUrl, { waitUntil: "commit", timeout: p.timeout });
           await page.waitForSelector("body", { timeout: p.timeout }).catch(() => {
           });
           await page.waitForLoadState("networkidle", Math.min(p.timeout, 8e3)).catch(() => {
@@ -2393,7 +2397,7 @@ var scrapeCommand = registerCommand({
               return { url: location.href, title: document.title, navigation, tables, forms: forms.slice(0, 20), links: links.slice(0, 30), mainText };
             });
             try {
-              persistFromScrape(p.url, structured);
+              persistFromScrape(targetUrl, structured);
             } catch {
             }
             if (p.mode === "smart") {
@@ -2494,7 +2498,7 @@ var scrapeCommand = registerCommand({
 
 // src/commands/map.ts
 import { z as z16 } from "zod";
-import { ok as ok16 } from "@dyyz1993/xcli-core";
+import { ok as ok16, fail as fail4 } from "@dyyz1993/xcli-core";
 
 // src/utils/url.ts
 var SKIP_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -2730,7 +2734,7 @@ var mapCommand = registerCommand({
   description: "Discover all URLs on a website via sitemap and page link extraction",
   scope: "project",
   parameters: z16.object({
-    url: z16.string(),
+    url: z16.string().optional(),
     search: z16.string().optional(),
     sitemap: z16.enum(["include", "only"]).optional(),
     includeSubdomains: z16.boolean().optional(),
@@ -2741,7 +2745,11 @@ var mapCommand = registerCommand({
   handler: async (p, ctx) => {
     const { context, page } = await createEphemeralContext(resolveLaunchOpts(ctx));
     try {
-      const links = await discoverUrls(page, p.url, {
+      const targetUrl = p.url || page.url();
+      if (!targetUrl || targetUrl === "about:blank") {
+        return fail4("URL is required. Provide a URL or connect to a browser (--cdp) with a non-blank page.");
+      }
+      const links = await discoverUrls(page, targetUrl, {
         sitemap: p.sitemap,
         includeSubdomains: p.includeSubdomains,
         allowExternalLinks: p.allowExternalLinks,
@@ -3584,7 +3592,7 @@ ${errors.map((e) => `  - ${e.engine}: ${e.error}`).join("\n")}`
 
 // src/commands/network.ts
 import { z as z19 } from "zod";
-import { ok as ok19, fail as fail4 } from "@dyyz1993/xcli-core";
+import { ok as ok19, fail as fail5 } from "@dyyz1993/xcli-core";
 function extractPath2(url) {
   try {
     const u = new URL(url);
@@ -3749,7 +3757,7 @@ var networkCommand = registerCommand({
     };
     if (p.listen) {
       const page2 = ctx.page;
-      if (!page2) return fail4("No active page. Use --cdp to connect first.");
+      if (!page2) return fail5("No active page. Use --cdp to connect first.");
       const captures = [];
       const consoleMessages = [];
       const wsCaptures = [];
@@ -4129,7 +4137,7 @@ var ENGINE_KEY_ENUM = z20.enum(ALL_ENGINE_KEYS);
 
 // src/commands/snapshot.ts
 import { z as z21 } from "zod";
-import { ok as ok20, fail as fail5, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
+import { ok as ok20, fail as fail6, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
 
 // src/runtime/ref-store.ts
 var sessions = /* @__PURE__ */ new Map();
@@ -5100,7 +5108,7 @@ var snapshotCommand = registerCommand({
       persistSemantics(url, aria);
       return ok20({ url, title, aria, text, dom }, normalizeTips3(tips));
     }
-    return fail5(`Unknown snapshot type: ${p.type}`);
+    return fail6(`Unknown snapshot type: ${p.type}`);
   }
 });
 function persistSemantics(url, aria) {
@@ -5269,7 +5277,7 @@ var waitForCommand = registerCommand({
 
 // src/commands/tab.ts
 import { z as z23 } from "zod";
-import { ok as ok22, fail as fail6 } from "@dyyz1993/xcli-core";
+import { ok as ok22, fail as fail7 } from "@dyyz1993/xcli-core";
 var TabParams = z23.object({
   subcommand: z23.enum(["list", "new", "close", "switch"]),
   url: z23.string().optional(),
@@ -5286,7 +5294,7 @@ var tabCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     if (!ctx.browserContext) {
-      return fail6("No browser context available. Use --cdp to connect to a browser first.");
+      return fail7("No browser context available. Use --cdp to connect to a browser first.");
     }
     const pages = ctx.browserContext.pages();
     switch (p.subcommand) {
@@ -5299,7 +5307,7 @@ var tabCommand = registerCommand({
       case "switch":
         return handleSwitch(p, pages, ctx);
       default:
-        return fail6(`Unknown subcommand: ${p.subcommand}`);
+        return fail7(`Unknown subcommand: ${p.subcommand}`);
     }
   }
 });
@@ -5356,11 +5364,11 @@ async function handleNew(p, _pages, ctx) {
 }
 async function handleClose(p, pages, ctx) {
   if (pages.length <= 1) {
-    return fail6("Cannot close the last remaining tab");
+    return fail7("Cannot close the last remaining tab");
   }
   const closeIndex = p.index ?? pages.indexOf(ctx.page);
   if (closeIndex < 0 || closeIndex >= pages.length) {
-    return fail6(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
+    return fail7(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
   }
   const pageToClose = pages[closeIndex];
   const isActivePage = pageToClose === ctx.page;
@@ -5383,10 +5391,10 @@ async function handleClose(p, pages, ctx) {
 }
 async function handleSwitch(p, pages, ctx) {
   if (p.index === void 0) {
-    return fail6("Parameter --index is required for switch subcommand");
+    return fail7("Parameter --index is required for switch subcommand");
   }
   if (p.index < 0 || p.index >= pages.length) {
-    return fail6(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
+    return fail7(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
   }
   const targetPage = pages[p.index];
   await targetPage.bringToFront().catch(() => {
@@ -5638,7 +5646,7 @@ registerCommandDefinition("addinitscript", ["script"]);
 
 // src/commands/find.ts
 import { z as z25 } from "zod";
-import { ok as ok24, fail as fail7, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
+import { ok as ok24, fail as fail8, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
 var actionSchema2 = z25.enum(["click", "fill", "type", "select", "hover", "check"]);
 var findCommand = registerCommand({
   name: "find",
@@ -5679,7 +5687,7 @@ var findCommand = registerCommand({
     });
     const count = await locator.count();
     if (count === 0) {
-      return fail7(`No element found with ${p.strategy}="${p.value}"`);
+      return fail8(`No element found with ${p.strategy}="${p.value}"`);
     }
     const tips = [];
     const target = selectTarget(locator, p.strategy);
@@ -5691,15 +5699,15 @@ var findCommand = registerCommand({
       await target.click({ timeout: p.timeout, force: true });
       return okWithTips({ matched: count, selector, action: "click" }, tips);
     } else if (actionName === "fill") {
-      if (actionValue === void 0) return fail7("find fill requires a value");
+      if (actionValue === void 0) return fail8("find fill requires a value");
       await target.fill(actionValue, { timeout: p.timeout, force: true });
       return okWithTips({ matched: count, selector, action: `fill("${actionValue}")` }, tips);
     } else if (actionName === "type") {
-      if (actionValue === void 0) return fail7("find type requires a value");
+      if (actionValue === void 0) return fail8("find type requires a value");
       await target.type(actionValue, { delay: 10, timeout: p.timeout });
       return okWithTips({ matched: count, selector, action: `type("${actionValue}")` }, tips);
     } else if (actionName === "select") {
-      if (actionValue === void 0) return fail7("find select requires a value");
+      if (actionValue === void 0) return fail8("find select requires a value");
       await target.selectOption(actionValue);
       return okWithTips({ matched: count, selector, action: `select("${actionValue}")` }, tips);
     } else if (actionName === "hover") {
@@ -7135,7 +7143,7 @@ async function guardCheck(commandName) {
   }
 }
 function errorResult(message) {
-  return { ...fail8(message), duration: 0 };
+  return { ...fail9(message), duration: 0 };
 }
 function tipsToMessages(tips) {
   if (!tips || tips.length === 0) return [];
@@ -7212,7 +7220,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-XPKM344Y.js");
+    const { findTargetPage } = await import("./browser-4KRHALJ3.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.`);
@@ -7436,7 +7444,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail8(errorMessage), duration };
+    return { ...fail9(errorMessage), duration };
   } finally {
   }
 }
@@ -7477,7 +7485,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail8(`Plugin "${cmdName}" requires a sub-command`),
+              ...fail9(`Plugin "${cmdName}" requires a sub-command`),
               duration: 0
             });
             if (type === "and") {
@@ -7496,7 +7504,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail8(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
+              ...fail9(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
               duration: 0
             });
             if (type === "and") {
@@ -7628,7 +7636,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail8(errorMessage),
+              ...fail9(errorMessage),
               duration: duration2
             });
             if (type === "and") {
@@ -11226,7 +11234,7 @@ async function handleFilter(args, _mode, options) {
   console.log(`  Original: ${result.originalCount}, After: ${result.filteredCount}, Removed: ${result.removed} (${result.percentage}%)`);
 }
 async function handleGeneratePlugin(sessionName, pluginName, outputDir) {
-  const { SessionRecorder: SessionRecorder2 } = await import("./session-recorder-33UKWCIR.js");
+  const { SessionRecorder: SessionRecorder2 } = await import("./session-recorder-KPU4YQAE.js");
   const { readSiteKnowledge: readSiteKnowledge2, toMarkdown } = await import("./site-knowledge-SYC6VCDB.js");
   const { mkdirSync: mkdirSync10, writeFileSync: writeFileSync12 } = await import("fs");
   const { join: join14 } = await import("path");
@@ -13188,7 +13196,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-XPKM344Y.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-4KRHALJ3.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -13461,7 +13469,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-XPKM344Y.js");
+      const { ensureProcessCanExit } = await import("./browser-4KRHALJ3.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);