@xbrowser/cli 1.8.6 → 1.9.0

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
@@ -55,7 +53,7 @@ import {
 // src/executor.ts
 import {
   ok as ok25,
-  fail as fail8,
+  fail as fail9,
   isCommandResult,
   CompositeStorage as CompositeStorage2,
   TipCollector as TipCollector2,
@@ -2283,7 +2281,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"),
@@ -2296,10 +2294,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(() => {
@@ -2360,7 +2362,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") {
@@ -2461,7 +2463,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([
@@ -2697,7 +2699,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(),
@@ -2708,7 +2710,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,
@@ -3551,7 +3557,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);
@@ -3716,7 +3722,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 = [];
@@ -4096,7 +4102,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();
@@ -5067,7 +5073,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) {
@@ -5236,7 +5242,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(),
@@ -5253,7 +5259,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) {
@@ -5266,7 +5272,7 @@ var tabCommand = registerCommand({
       case "switch":
         return handleSwitch(p, pages, ctx);
       default:
-        return fail6(`Unknown subcommand: ${p.subcommand}`);
+        return fail7(`Unknown subcommand: ${p.subcommand}`);
     }
   }
 });
@@ -5323,11 +5329,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;
@@ -5350,10 +5356,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(() => {
@@ -5605,7 +5611,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",
@@ -5646,7 +5652,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);
@@ -5658,15 +5664,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") {
@@ -6672,7 +6678,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 [];
@@ -6749,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.`);
@@ -6973,7 +6979,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail8(errorMessage), duration };
+    return { ...fail9(errorMessage), duration };
   } finally {
   }
 }
@@ -7014,7 +7020,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") {
@@ -7033,7 +7039,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") {
@@ -7165,7 +7171,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail8(errorMessage),
+              ...fail9(errorMessage),
               duration: duration2
             });
             if (type === "and") {
@@ -7787,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([
@@ -7905,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);
@@ -7980,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,
@@ -8201,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;
@@ -8293,7 +8180,7 @@ function createRPCHandler() {
       } catch {
       }
     }
-    recorder.recordCommandAction({
+    await recorder.recordCommandAction({
       type: actionType,
       selector,
       value,
@@ -8316,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,
@@ -8352,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,
@@ -8370,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 {
@@ -9586,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: "" };
@@ -11252,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}
@@ -11285,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);
@@ -11319,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