@xbrowser/cli 1.8.7 → 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,
@@ -7220,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.`);
@@ -11234,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");
@@ -13196,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);
             }
           }
@@ -13469,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);

package/dist/daemon-main.js

@@ -5,7 +5,7 @@ import {
 } from "./chunk-VEDJ5XSQ.js";
 import {
   SessionRecorder
-} from "./chunk-FL6DOSWV.js";
+} from "./chunk-TTZNR3QP.js";
 import {
   closeEphemeralContext,
   closeSessionByName,
@@ -21,7 +21,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-HXLMMSU3.js";
+} from "./chunk-OOJ2H7IL.js";
 import "./chunk-VJNMAWPZ.js";
 import "./chunk-TNEN6VQ2.js";
 import {
@@ -38,15 +38,13 @@ import {
 import "./chunk-KFQGP6VL.js";
 
 // src/daemon/daemon-main.ts
-import { writeFileSync as writeFileSync6, mkdirSync as mkdirSync6, appendFileSync, unlinkSync } from "fs";
-import { join as join8 } from "path";
-import { homedir as homedir8 } from "os";
+import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync5, appendFileSync, unlinkSync } from "fs";
+import { join as join7 } from "path";
+import { homedir as homedir7 } from "os";
 import { startHttpServer } from "@dyyz1993/xcli-core";
 
 // src/daemon/rpc-handlers.ts
-import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync5 } from "fs";
-import { join as join7 } from "path";
-import { homedir as homedir7 } from "os";
+import { readFileSync as readFileSync5 } from "fs";
 import {
   createSessionMeta,
   removeSession
@@ -6757,7 +6755,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-LW2MDJE4.js");
+    const { findTargetPage } = await import("./browser-6WJHQDPV.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.`);
@@ -7795,60 +7793,6 @@ var PlaybackEngine = class _PlaybackEngine {
 // src/daemon/rpc-handlers.ts
 var activeRecorders = /* @__PURE__ */ new Map();
 var replayResumeResolvers = /* @__PURE__ */ new Map();
-var CONFIG_DIR3 = join7(homedir7(), ".xbrowser");
-var RECORDING_INJECT_JS = `
-(function(){
-  if(window.__xb_rec) return;
-  window.__xb_rec = true;
-  window.__xb_evts = [];
-  window.__xb_t0 = Date.now();
-  function d(el){
-    if(!el||!el.tagName) return {tag:'unknown'};
-    var o={tag:el.tagName.toLowerCase(),text:(el.textContent||'').trim().substring(0,80)};
-    if(el.getAttribute('role')) o.role=el.getAttribute('role');
-    if(el.id) o.id=el.id;
-    if(el.getAttribute('type')) o.type=el.getAttribute('type');
-    if(el.getAttribute('placeholder')) o.placeholder=el.getAttribute('placeholder');
-    if(el.getAttribute('aria-label')) o.ariaLabel=el.getAttribute('aria-label');
-    if(el.contentEditable==='true') o.contentEditable=true;
-    return o;
-  }
-  function p(t,det){
-    var e={type:t,ts:Date.now()-window.__xb_t0,url:location.href};
-    for(var k in det) e[k]=det[k];
-    window.__xb_evts.push(e);
-  }
-  document.addEventListener('click',function(e){p('click',{target:d(e.target),x:e.clientX,y:e.clientY})},true);
-  document.addEventListener('dblclick',function(e){p('dblclick',{target:d(e.target),x:e.clientX,y:e.clientY})},true);
-  document.addEventListener('input',function(e){var el=e.target;p('input',{target:d(el),value:(el.value||el.textContent||'').substring(0,200)})},true);
-  document.addEventListener('change',function(e){p('change',{target:d(e.target),value:(e.target.value||'').substring(0,100)})},true);
-  document.addEventListener('keydown',function(e){if(e.key==='Enter'||e.key==='Tab'||e.key==='Escape'||e.key.startsWith('Arrow'))p('keydown',{key:e.key,target:d(e.target)})},true);
-  document.addEventListener('submit',function(e){p('submit',{target:d(e.target)})},true);
-  var __xb_last_focus=null;document.addEventListener('focus',function(e){var t=e.target.tagName;if(t==='INPUT'||t==='TEXTAREA'||e.target.contentEditable==='true'){var sel=e.target.id||e.target.name||e.target.placeholder;if(sel===__xb_last_focus)return;__xb_last_focus=sel;p('input_focused',{target:d(e.target)})}},true);
-  var obs=new MutationObserver(function(mutations){
-    for(var m of mutations){
-      for(var node of m.addedNodes){
-        if(node.nodeType===1&&node.tagName){
-          var text=(node.textContent||'').trim().substring(0,60);
-          if(text&&text.length>1) p('dom_added',{tag:node.tagName.toLowerCase(),role:node.getAttribute&&node.getAttribute('role'),text:text});
-        }
-      }
-    }
-  });
-  if(document.body) obs.observe(document.body,{childList:true,subtree:true});
-  p('recording_started',{url:location.href});
-})();
-`;
-async function injectRecording(page) {
-  try {
-    await page.evaluate(RECORDING_INJECT_JS);
-  } catch {
-  }
-  try {
-    await page.addInitScript(RECORDING_INJECT_JS);
-  } catch {
-  }
-}
 function createRPCHandler() {
   let previewWS = null;
   const INTERACTION_COMMANDS2 = /* @__PURE__ */ new Set([
@@ -7913,15 +7857,6 @@ function createRPCHandler() {
           return handleNetworkFeedback(params);
         case "network:export":
           return handleNetworkExport(params);
-        // ── Recording ──
-        case "recording:status":
-          return handleRecordingStatus(params);
-        case "recording:events":
-          return handleRecordingEvents(params);
-        case "recording:clear":
-          return handleRecordingClear(params);
-        case "recording:save":
-          return handleRecordingSave(params);
         // ── Command log ──
         case "command:log":
           return handleCommandLog(params);
@@ -7988,7 +7923,6 @@ function createRPCHandler() {
         session = await createSession(name, url);
       }
     }
-    await injectRecording(session.page);
     if (previewWS) previewWS.registerSession(session.name, session.page);
     saveSessionDiskMeta(name, {
       id: session.id,
@@ -8209,61 +8143,6 @@ function createRPCHandler() {
     if (!entry.capture) return { error: `Entry #${id} not found` };
     return exportEntry(entry.capture, lang);
   }
-  async function handleRecordingStatus(params) {
-    const sess = findSession(params.session || "default");
-    if (!sess) return { recording: false, error: "No session" };
-    try {
-      const result = await sess.page.evaluate(() => ({
-        active: !!window.__xb_rec,
-        events: window.__xb_evts?.length || 0,
-        url: location.href
-      }));
-      return { recording: true, ...result };
-    } catch {
-      return { recording: false, error: "Page unreachable" };
-    }
-  }
-  async function handleRecordingEvents(params) {
-    const sess = findSession(params.session || "default");
-    if (!sess) return { events: [], error: "No session" };
-    try {
-      const events = await sess.page.evaluate(() => window.__xb_evts || []);
-      return { events, url: sess.page.url() };
-    } catch {
-      return { events: [], error: "Page unreachable" };
-    }
-  }
-  async function handleRecordingClear(params) {
-    const sess = findSession(params.session || "default");
-    if (!sess) return { ok: false, error: "No session" };
-    try {
-      await sess.page.evaluate(() => {
-        window.__xb_evts = [];
-        window.__xb_t0 = Date.now();
-      });
-      return { ok: true };
-    } catch {
-      return { ok: false, error: "Page unreachable" };
-    }
-  }
-  async function handleRecordingSave(params) {
-    const sess = findSession(params.session || "default");
-    if (!sess) return { ok: false, error: "No session" };
-    try {
-      const events = await sess.page.evaluate(() => window.__xb_evts || []);
-      const recordingsDir = join7(CONFIG_DIR3, "recordings");
-      mkdirSync5(recordingsDir, { recursive: true });
-      const outPath = params.path || join7(recordingsDir, `recording-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.json`);
-      writeFileSync5(outPath, JSON.stringify({
-        startUrl: sess.page.url(),
-        recordedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        events
-      }, null, 2));
-      return { ok: true, path: outPath, events: events.length };
-    } catch (e) {
-      return { ok: false, error: errMsg(e) };
-    }
-  }
   function handleCommandLog(params) {
     const sessionName = params.session || "default";
     const limit = params.limit || 50;
@@ -8301,7 +8180,7 @@ function createRPCHandler() {
       } catch {
       }
     }
-    recorder.recordCommandAction({
+    await recorder.recordCommandAction({
       type: actionType,
       selector,
       value,
@@ -8324,7 +8203,6 @@ function createRPCHandler() {
       try {
         const sessionOpts = cdpEndpoint ? { cdpEndpoint } : void 0;
         session = await createSession(sessionName, url, sessionOpts);
-        await injectRecording(session.page);
         if (previewWS) previewWS.registerSession(session.name, session.page);
         saveSessionDiskMeta(sessionName, {
           id: session.id,
@@ -8360,8 +8238,8 @@ function createRPCHandler() {
       const existingData = SessionRecorder.readData(sessionName);
       if (existingData) {
         if (outputPath) {
-          const { writeFileSync: writeFileSync7 } = await import("fs");
-          writeFileSync7(outputPath, JSON.stringify(existingData, null, 2), "utf-8");
+          const { writeFileSync: writeFileSync6 } = await import("fs");
+          writeFileSync6(outputPath, JSON.stringify(existingData, null, 2), "utf-8");
         }
         return {
           ok: true,
@@ -8378,14 +8256,14 @@ function createRPCHandler() {
       const { data, summary } = await recorder.stop();
       activeRecorders.delete(sessionName);
       if (outputPath) {
-        const { writeFileSync: writeFileSync7, mkdirSync: mkdirSync7 } = await import("fs");
+        const { writeFileSync: writeFileSync6, mkdirSync: mkdirSync6 } = await import("fs");
         const { dirname: dirname2 } = await import("path");
-        mkdirSync7(dirname2(outputPath), { recursive: true });
+        mkdirSync6(dirname2(outputPath), { recursive: true });
         if (outputPath.endsWith(".yaml") || outputPath.endsWith(".yml")) {
           const yaml2 = (await import("yaml")).default;
-          writeFileSync7(outputPath, yaml2.stringify(data), "utf-8");
+          writeFileSync6(outputPath, yaml2.stringify(data), "utf-8");
         } else {
-          writeFileSync7(outputPath, JSON.stringify(data, null, 2), "utf-8");
+          writeFileSync6(outputPath, JSON.stringify(data, null, 2), "utf-8");
         }
       }
       return {
@@ -9594,12 +9472,12 @@ var FileListHandler = class {
     const msg = ctx.message;
     try {
       const { readdirSync, statSync } = await import("fs");
-      const { join: join9, resolve } = await import("path");
+      const { join: join8, resolve } = await import("path");
       const targetPath = resolve(msg.path);
       const entries = readdirSync(targetPath);
       const files = entries.map((name) => {
         try {
-          const stat = statSync(join9(targetPath, name));
+          const stat = statSync(join8(targetPath, name));
           return { name, isDir: stat.isDirectory(), size: stat.size, modified: stat.mtime.toISOString() };
         } catch {
           return { name, isDir: false, size: 0, modified: "" };
@@ -11260,8 +11138,8 @@ connectWS();
 }
 
 // src/daemon/daemon-main.ts
-var CONFIG_DIR4 = join8(homedir8(), ".xbrowser");
-var LOG_FILE = join8(CONFIG_DIR4, "daemon.log");
+var CONFIG_DIR3 = join7(homedir7(), ".xbrowser");
+var LOG_FILE = join7(CONFIG_DIR3, "daemon.log");
 function log(msg) {
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").substring(0, 19);
   const line = `[DAEMON ${ts}] ${msg}
@@ -11293,7 +11171,7 @@ async function main() {
     if (err.code === "EADDRINUSE") {
       log(`Port ${daemonPort} already in use \u2014 another daemon instance likely won the startup race. Exiting gracefully.`);
       try {
-        unlinkSync(join8(CONFIG_DIR4, "daemon.json"));
+        unlinkSync(join7(CONFIG_DIR3, "daemon.json"));
       } catch {
       }
       process.exit(0);
@@ -11327,8 +11205,8 @@ async function main() {
   rpcHandler.setPreviewWS(previewWS);
   previewWS.on("screencast-started", (sid) => log(`Preview screencast started: ${sid}`));
   previewWS.on("screencast-stopped", (sid) => log(`Preview screencast stopped: ${sid}`));
-  mkdirSync6(CONFIG_DIR4, { recursive: true });
-  writeFileSync6(join8(CONFIG_DIR4, "daemon.json"), JSON.stringify({
+  mkdirSync5(CONFIG_DIR3, { recursive: true });
+  writeFileSync5(join7(CONFIG_DIR3, "daemon.json"), JSON.stringify({
     port: daemonPort,
     pid: process.pid,
     startedAt: Date.now()

package/dist/index.d.ts

@@ -1737,6 +1737,8 @@ interface UserAction {
         distance: number;
         duration: number;
     };
+    /** Base64-encoded PNG screenshot of the target element (captured on key actions) */
+    elementScreenshot?: string;
 }
 interface NetworkEntry {
     id: number;
@@ -1854,7 +1856,7 @@ declare class SessionRecorder {
         value?: string;
         url?: string;
         element?: UserAction['element'];
-    }): void;
+    }): Promise<void>;
     get networkCount(): number;
     getLiveData(): RecordingData;
     addManualCheckpoint(type: string, hint: string, selector?: string): CheckpointEntry;
@@ -1884,6 +1886,14 @@ declare class SessionRecorder {
     private handleFileChooser;
     private pollActions;
     private flushPendingActions;
+    /**
+     * 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.
+     */
+    private captureElementScreenshot;
     /**
      * 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/index.js

@@ -57,7 +57,7 @@ import {
 } from "./chunk-GJAV3QGG.js";
 import {
   SessionRecorder
-} from "./chunk-RMYEHTLS.js";
+} from "./chunk-YSCY52UJ.js";
 import {
   addKnownIssue,
   getKnowledgePath,
@@ -82,7 +82,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-CJJ564VK.js";
+} from "./chunk-MSQIPXKE.js";
 import "./chunk-VJNMAWPZ.js";
 import "./chunk-TNEN6VQ2.js";
 import {
@@ -7540,7 +7540,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-TLIDFFEG.js");
+    const { findTargetPage } = await import("./browser-C63PFGPT.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.`);
@@ -11557,7 +11557,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: mkdirSync11, writeFileSync: writeFileSync13 } = await import("fs");
   const { join: join14 } = await import("path");
@@ -13519,7 +13519,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-TLIDFFEG.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-C63PFGPT.js");
               setActivePage2(session, targetPage);
             }
           }

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

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

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

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

package/package.json

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