@xbrowser/cli 1.9.0 → 1.9.2

package/dist/daemon-main.js

@@ -26,7 +26,7 @@ import "./chunk-VJNMAWPZ.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getPluginLoader
-} from "./chunk-2QQDTXDL.js";
+} from "./chunk-PIWNMC36.js";
 import {
   getDaemonConfig,
   getDaemonProcessStatus,
@@ -53,7 +53,7 @@ import {
 // src/executor.ts
 import {
   ok as ok25,
-  fail as fail9,
+  fail as fail11,
   isCommandResult,
   CompositeStorage as CompositeStorage2,
   TipCollector as TipCollector2,
@@ -918,7 +918,7 @@ var evaluateCommand = registerCommand({
 
 // src/commands/storage.ts
 import { z as z8 } from "zod";
-import { ok as ok8 } from "@dyyz1993/xcli-core";
+import { ok as ok8, fail as fail2 } from "@dyyz1993/xcli-core";
 var getCookiesCommand = registerCommand({
   name: "get-cookies",
   description: "Get all cookies for the current page",
@@ -940,6 +940,7 @@ var setCookieCommand = registerCommand({
     value: z8.coerce.string(),
     domain: z8.coerce.string().optional(),
     path: z8.coerce.string().optional(),
+    url: z8.string().optional().describe("Cookie URL (alternative to domain)"),
     expires: z8.number().optional(),
     httpOnly: z8.boolean().optional(),
     secure: z8.boolean().optional(),
@@ -959,6 +960,9 @@ var setCookieCommand = registerCommand({
         }
       }
     }
+    if (!cookie.domain && !cookie.url) {
+      return fail2("set-cookie requires --domain or --url, or a non-blank page URL to infer from");
+    }
     await ctx.browserContext.addCookies([cookie]);
     return ok8({ name: p.name });
   }
@@ -985,19 +989,23 @@ var getLocalStorageCommand = registerCommand({
     z8.object({ data: z8.record(z8.string()) })
   ]),
   handler: async (p, ctx) => {
-    if (p.key) {
-      const value = await ctx.page.evaluate((k) => localStorage.getItem(k), p.key);
-      return ok8({ key: p.key, value });
+    try {
+      if (p.key) {
+        const value = await ctx.page.evaluate((k) => localStorage.getItem(k), p.key);
+        return ok8({ key: p.key, value });
+      }
+      const data = await ctx.page.evaluate(() => {
+        const entries = {};
+        for (let i = 0; i < localStorage.length; i++) {
+          const key = localStorage.key(i);
+          if (key) entries[key] = localStorage.getItem(key) ?? "";
+        }
+        return entries;
+      });
+      return ok8({ data });
+    } catch (e) {
+      return fail2(`localStorage not accessible on this page: ${e instanceof Error ? e.message : String(e)}`);
     }
-    const data = await ctx.page.evaluate(() => {
-      const entries = {};
-      for (let i = 0; i < localStorage.length; i++) {
-        const key = localStorage.key(i);
-        if (key) entries[key] = localStorage.getItem(key) ?? "";
-      }
-      return entries;
-    });
-    return ok8({ data });
   }
 });
 var setLocalStorageCommand = registerCommand({
@@ -1010,13 +1018,17 @@ var setLocalStorageCommand = registerCommand({
   }),
   result: z8.object({ key: z8.string() }),
   handler: async (p, ctx) => {
-    await ctx.page.evaluate(
-      (args) => {
-        localStorage.setItem(args.key, args.value);
-      },
-      { key: p.key, value: p.value }
-    );
-    return ok8({ key: p.key });
+    try {
+      await ctx.page.evaluate(
+        (args) => {
+          localStorage.setItem(args.key, args.value);
+        },
+        { key: p.key, value: p.value }
+      );
+      return ok8({ key: p.key });
+    } catch (e) {
+      return fail2(`localStorage not accessible on this page: ${e instanceof Error ? e.message : String(e)}`);
+    }
   }
 });
 var clearLocalStorageCommand = registerCommand({
@@ -1025,21 +1037,35 @@ var clearLocalStorageCommand = registerCommand({
   scope: "page",
   result: z8.object({ cleared: z8.boolean() }),
   handler: async (_p, ctx) => {
-    await ctx.page.evaluate(() => localStorage.clear());
-    return ok8({ cleared: true });
+    try {
+      await ctx.page.evaluate(() => localStorage.clear());
+      return ok8({ cleared: true });
+    } catch (e) {
+      return fail2(`localStorage not accessible on this page: ${e instanceof Error ? e.message : String(e)}`);
+    }
   }
 });
 
 // src/commands/screenshot.ts
 import { z as z9 } from "zod";
-import { ok as ok9 } from "@dyyz1993/xcli-core";
+import { ok as ok9, fail as fail3 } from "@dyyz1993/xcli-core";
 import { writeFileSync, mkdirSync } from "fs";
-import { join as join2 } from "path";
+import { dirname, join as join2 } from "path";
 import { homedir as homedir2 } from "os";
 var SCREENSHOTS_DIR = join2(homedir2(), ".xbrowser", "screenshots");
 function ensureScreenshotsDir() {
   mkdirSync(SCREENSHOTS_DIR, { recursive: true });
 }
+function ensureParentDir(filePath) {
+  const dir = dirname(filePath);
+  if (dir === "." || dir === "/") return null;
+  try {
+    mkdirSync(dir, { recursive: true });
+    return null;
+  } catch (err) {
+    return err instanceof Error ? err.message : String(err);
+  }
+}
 function generateScreenshotPath(format) {
   const timestamp = Date.now();
   const random = Math.random().toString(36).slice(2, 8);
@@ -1083,7 +1109,15 @@ var screenshotCommand = registerCommand({
       buffer = await ctx.page.screenshot(options);
     }
     if (p.output) {
-      writeFileSync(p.output, buffer, "binary");
+      const dirErr = ensureParentDir(p.output);
+      if (dirErr) {
+        return fail3(`Cannot create directory for --output "${p.output}": ${dirErr}`);
+      }
+      try {
+        writeFileSync(p.output, buffer, "binary");
+      } catch (err) {
+        return fail3(`Failed to write screenshot to "${p.output}": ${err instanceof Error ? err.message : String(err)}`);
+      }
       return ok9({
         output: p.output,
         format,
@@ -1201,7 +1235,7 @@ var setViewportCommand = registerCommand({
 
 // src/commands/frame.ts
 import { z as z12 } from "zod";
-import { ok as ok12, fail as fail2 } from "@dyyz1993/xcli-core";
+import { ok as ok12, fail as fail4 } from "@dyyz1993/xcli-core";
 var framesCommand = registerCommand({
   name: "frames",
   description: "List all frames in the current page",
@@ -1226,10 +1260,10 @@ var framesCommand = registerCommand({
 });
 var frameCommand = registerCommand({
   name: "frame",
-  description: "Switch to a frame by index or name",
+  description: "Get frame info by index or name",
   scope: "page",
   parameters: z12.object({
-    index: z12.number().optional(),
+    index: z12.number().int().min(0).optional(),
     name: z12.string().optional()
   }),
   result: z12.object({
@@ -1246,10 +1280,10 @@ var frameCommand = registerCommand({
     } else if (p.name !== void 0) {
       targetFrame = rawFrames.find((f) => f.name() === p.name);
     } else {
-      return fail2("Must provide index or name");
+      return fail4("Must provide index or name");
     }
     if (!targetFrame) {
-      return fail2("Frame not found");
+      return fail4("Frame not found");
     }
     return ok12({
       name: targetFrame.name(),
@@ -1895,7 +1929,7 @@ var actionsCommand = registerCommand({
 
 // src/commands/scrape.ts
 import { z as z15 } from "zod";
-import { ok as ok15, fail as fail3 } from "@dyyz1993/xcli-core";
+import { ok as ok15, fail as fail5 } from "@dyyz1993/xcli-core";
 
 // src/lib/html-to-markdown.ts
 import * as cheerio from "cheerio";
@@ -2296,7 +2330,7 @@ var scrapeCommand = registerCommand({
     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.");
+        return fail5("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++) {
@@ -2450,7 +2484,7 @@ var scrapeCommand = registerCommand({
           }
         }
       }
-      return fail3(`Scrape failed after ${maxAttempts} attempt(s): ${lastError?.message ?? "unknown error"}`);
+      return fail5(`Scrape failed after ${maxAttempts} attempt(s): ${lastError?.message ?? "unknown error"}`);
     } finally {
       await closeEphemeralContext(context);
     }
@@ -2463,7 +2497,7 @@ var scrapeCommand = registerCommand({
 
 // src/commands/map.ts
 import { z as z16 } from "zod";
-import { ok as ok16, fail as fail4 } from "@dyyz1993/xcli-core";
+import { ok as ok16, fail as fail6 } from "@dyyz1993/xcli-core";
 
 // src/utils/url.ts
 var SKIP_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -2712,7 +2746,7 @@ var mapCommand = registerCommand({
     try {
       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.");
+        return fail6("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,
@@ -3557,7 +3591,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 fail5 } from "@dyyz1993/xcli-core";
+import { ok as ok19, fail as fail7 } from "@dyyz1993/xcli-core";
 function extractPath2(url) {
   try {
     const u = new URL(url);
@@ -3722,7 +3756,7 @@ var networkCommand = registerCommand({
     };
     if (p.listen) {
       const page2 = ctx.page;
-      if (!page2) return fail5("No active page. Use --cdp to connect first.");
+      if (!page2) return fail7("No active page. Use --cdp to connect first.");
       const captures = [];
       const consoleMessages = [];
       const wsCaptures = [];
@@ -4102,7 +4136,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 fail6, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
+import { ok as ok20, fail as fail8, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
 
 // src/runtime/ref-store.ts
 var sessions = /* @__PURE__ */ new Map();
@@ -4344,7 +4378,7 @@ async function resolveRefParams(page, params, selectorKeys, cache, sessionId) {
 
 // src/utils/site-semantics.ts
 import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync3, existsSync, readFileSync } from "fs";
-import { join as join4, dirname } from "path";
+import { join as join4, dirname as dirname2 } from "path";
 import { homedir as homedir4 } from "os";
 import { stringify, parse } from "yaml";
 import { execFile } from "child_process";
@@ -4437,7 +4471,7 @@ function extractDomain2(url) {
 }
 function saveSemantics(domain, pagePath, url, elements) {
   const filePath = getSemanticsPath(domain);
-  const dir = dirname(filePath);
+  const dir = dirname2(filePath);
   let site;
   if (existsSync(filePath)) {
     try {
@@ -5073,7 +5107,7 @@ var snapshotCommand = registerCommand({
       persistSemantics(url, aria);
       return ok20({ url, title, aria, text, dom }, normalizeTips3(tips));
     }
-    return fail6(`Unknown snapshot type: ${p.type}`);
+    return fail8(`Unknown snapshot type: ${p.type}`);
   }
 });
 function persistSemantics(url, aria) {
@@ -5242,7 +5276,7 @@ var waitForCommand = registerCommand({
 
 // src/commands/tab.ts
 import { z as z23 } from "zod";
-import { ok as ok22, fail as fail7 } from "@dyyz1993/xcli-core";
+import { ok as ok22, fail as fail9 } from "@dyyz1993/xcli-core";
 var TabParams = z23.object({
   subcommand: z23.enum(["list", "new", "close", "switch"]),
   url: z23.string().optional(),
@@ -5259,7 +5293,7 @@ var tabCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     if (!ctx.browserContext) {
-      return fail7("No browser context available. Use --cdp to connect to a browser first.");
+      return fail9("No browser context available. Use --cdp to connect to a browser first.");
     }
     const pages = ctx.browserContext.pages();
     switch (p.subcommand) {
@@ -5268,50 +5302,45 @@ var tabCommand = registerCommand({
       case "new":
         return handleNew(p, pages, ctx);
       case "close":
-        return handleClose(p, pages, ctx);
+        return handleClose(p, ctx);
       case "switch":
         return handleSwitch(p, pages, ctx);
       default:
-        return fail7(`Unknown subcommand: ${p.subcommand}`);
+        return fail9(`Unknown subcommand: ${p.subcommand}`);
     }
   }
 });
-function handleList(pages, ctx) {
-  const currentIndex = pages.indexOf(ctx.page);
-  const tabs = pages.map((page, i) => {
+async function handleList(pages, ctx) {
+  const tabs = [];
+  let activeIndex = -1;
+  for (let i = 0; i < pages.length; i++) {
+    const page = pages[i];
     const url = page.url();
-    let title = "";
-    try {
-      const t = page.title();
-      if (t instanceof Promise) {
-        void t.then((v) => {
-          title = v;
-        });
-      }
-    } catch {
-      title = "";
-    }
-    return {
-      index: i,
-      url,
-      title,
-      active: i === currentIndex
-    };
-  });
-  return ok22({ tabs, total: tabs.length, activeIndex: currentIndex });
+    const title = await page.title().catch(() => "");
+    const isActive = page === ctx.page;
+    if (isActive) activeIndex = i;
+    tabs.push({ index: i, url, title, active: isActive });
+  }
+  return ok22({ tabs, total: tabs.length, activeIndex });
 }
 async function handleNew(p, _pages, ctx) {
   const newPage = await ctx.browserContext.newPage();
+  const warnings = [];
   if (p.url) {
     let url = p.url;
-    if (!/^https?:\/\//i.test(url)) {
+    if (!/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(url)) {
       url = "https://" + url;
     }
-    await newPage.goto(url, { waitUntil: "domcontentloaded", timeout: 15e3 }).catch(() => {
-    });
+    try {
+      await newPage.goto(url, { waitUntil: "domcontentloaded", timeout: 15e3 });
+    } catch (err) {
+      warnings.push(`Navigation to "${url}" failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  try {
+    await newPage.waitForLoadState("domcontentloaded");
+  } catch {
   }
-  await newPage.waitForLoadState("domcontentloaded").catch(() => {
-  });
   const session = ctx.sessionId ? getSessionById(ctx.sessionId) : void 0;
   if (session) {
     setActivePage(session, newPage);
@@ -5324,18 +5353,20 @@ async function handleNew(p, _pages, ctx) {
     index: newIndex >= 0 ? newIndex : allPages.length - 1,
     url: newPage.url(),
     title,
-    total: allPages.length
+    total: allPages.length,
+    ...warnings.length > 0 ? { warning: warnings.join("; ") } : {}
   });
 }
-async function handleClose(p, pages, ctx) {
-  if (pages.length <= 1) {
-    return fail7("Cannot close the last remaining tab");
+async function handleClose(p, ctx) {
+  const currentPages = ctx.browserContext.pages();
+  if (currentPages.length <= 1) {
+    return fail9("Cannot close the last remaining tab");
   }
-  const closeIndex = p.index ?? pages.indexOf(ctx.page);
-  if (closeIndex < 0 || closeIndex >= pages.length) {
-    return fail7(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
+  const closeIndex = p.index ?? currentPages.findIndex((pg) => pg === ctx.page);
+  if (closeIndex < 0 || closeIndex >= currentPages.length) {
+    return fail9(`Invalid tab index: ${closeIndex}. Valid range: 0-${currentPages.length - 1}`);
   }
-  const pageToClose = pages[closeIndex];
+  const pageToClose = currentPages[closeIndex];
   const isActivePage = pageToClose === ctx.page;
   await pageToClose.close();
   const remainingPages = ctx.browserContext.pages();
@@ -5351,15 +5382,15 @@ async function handleClose(p, pages, ctx) {
   return ok22({
     closedIndex: closeIndex,
     total: remainingPages.length,
-    activeIndex: isActivePage ? closeIndex < remainingPages.length ? closeIndex : remainingPages.length - 1 : pages.indexOf(ctx.page)
+    activeIndex: isActivePage ? closeIndex < remainingPages.length ? closeIndex : remainingPages.length - 1 : remainingPages.findIndex((pg) => pg === ctx.page)
   });
 }
 async function handleSwitch(p, pages, ctx) {
   if (p.index === void 0) {
-    return fail7("Parameter --index is required for switch subcommand");
+    return fail9("Parameter --index is required for switch subcommand");
   }
   if (p.index < 0 || p.index >= pages.length) {
-    return fail7(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
+    return fail9(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
   }
   const targetPage = pages[p.index];
   await targetPage.bringToFront().catch(() => {
@@ -5611,7 +5642,7 @@ registerCommandDefinition("addinitscript", ["script"]);
 
 // src/commands/find.ts
 import { z as z25 } from "zod";
-import { ok as ok24, fail as fail8, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
+import { ok as ok24, fail as fail10, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
 var actionSchema2 = z25.enum(["click", "fill", "type", "select", "hover", "check"]);
 var findCommand = registerCommand({
   name: "find",
@@ -5652,7 +5683,7 @@ var findCommand = registerCommand({
     });
     const count = await locator.count();
     if (count === 0) {
-      return fail8(`No element found with ${p.strategy}="${p.value}"`);
+      return fail10(`No element found with ${p.strategy}="${p.value}"`);
     }
     const tips = [];
     const target = selectTarget(locator, p.strategy);
@@ -5664,15 +5695,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 fail8("find fill requires a value");
+      if (actionValue === void 0) return fail10("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 fail8("find type requires a value");
+      if (actionValue === void 0) return fail10("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 fail8("find select requires a value");
+      if (actionValue === void 0) return fail10("find select requires a value");
       await target.selectOption(actionValue);
       return okWithTips({ matched: count, selector, action: `select("${actionValue}")` }, tips);
     } else if (actionName === "hover") {
@@ -6678,7 +6709,7 @@ async function guardCheck(commandName) {
   }
 }
 function errorResult(message) {
-  return { ...fail9(message), duration: 0 };
+  return { ...fail11(message), duration: 0 };
 }
 function tipsToMessages(tips) {
   if (!tips || tips.length === 0) return [];
@@ -6979,7 +7010,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail9(errorMessage), duration };
+    return { ...fail11(errorMessage), duration };
   } finally {
   }
 }
@@ -7020,7 +7051,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail9(`Plugin "${cmdName}" requires a sub-command`),
+              ...fail11(`Plugin "${cmdName}" requires a sub-command`),
               duration: 0
             });
             if (type === "and") {
@@ -7039,7 +7070,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail9(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
+              ...fail11(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
               duration: 0
             });
             if (type === "and") {
@@ -7171,7 +7202,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail9(errorMessage),
+              ...fail11(errorMessage),
               duration: duration2
             });
             if (type === "and") {
@@ -8009,9 +8040,9 @@ function createRPCHandler() {
     return result;
   }
   async function handlePluginsReload() {
-    const { resetPluginLoader } = await import("./plugin-singleton-SYJF6BD6.js");
+    const { resetPluginLoader } = await import("./plugin-singleton-FCNDN3FX.js");
     resetPluginLoader();
-    const loader = await import("./plugin-singleton-SYJF6BD6.js").then((m) => m.getPluginLoader());
+    const loader = await import("./plugin-singleton-FCNDN3FX.js").then((m) => m.getPluginLoader());
     const sites = loader.getCore().loader.getSites();
     return { ok: true, plugins: sites.length };
   }
@@ -8257,8 +8288,8 @@ function createRPCHandler() {
       activeRecorders.delete(sessionName);
       if (outputPath) {
         const { writeFileSync: writeFileSync6, mkdirSync: mkdirSync6 } = await import("fs");
-        const { dirname: dirname2 } = await import("path");
-        mkdirSync6(dirname2(outputPath), { recursive: true });
+        const { dirname: dirname3 } = await import("path");
+        mkdirSync6(dirname3(outputPath), { recursive: true });
         if (outputPath.endsWith(".yaml") || outputPath.endsWith(".yml")) {
           const yaml2 = (await import("yaml")).default;
           writeFileSync6(outputPath, yaml2.stringify(data), "utf-8");
@@ -8347,13 +8378,6 @@ function createRPCHandler() {
     if (!file) {
       return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: "Missing file parameter" }] };
     }
-    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 }] };
-    }
-    if (!session.page) {
-      return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: "Session has no page: " + sessionName }] };
-    }
     let rawContent;
     let parsed;
     try {
@@ -8364,8 +8388,19 @@ function createRPCHandler() {
         const yaml2 = (await import("yaml")).default;
         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}.` }] };
+      }
     } catch (e) {
-      return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: "Failed to read/parse file: " + String(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]}` }] };
+    }
+    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}` }] };
+    }
+    if (!session.page) {
+      return { ok: false, success: false, duration: 0, eventsPlayed: 0, totalEvents: 0, errors: [{ eventIndex: -1, error: "Session has no page: " + sessionName }] };
     }
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {

package/dist/{extract-RM62AJXW.js → extract-DSU2RVMN.js}

@@ -2,7 +2,7 @@ import {
   extractAndSave,
   extractRecording,
   printExtractSummary
-} from "./chunk-MJFYLKGL.js";
+} from "./chunk-X46HDAOT.js";
 import "./chunk-KFQGP6VL.js";
 export {
   extractAndSave,

package/dist/{extract-O46CC533.js → extract-EUWPRSKH.js}

@@ -4,9 +4,33 @@ import "./chunk-KFQGP6VL.js";
 import * as fs from "fs";
 import * as yaml from "yaml";
 function extractRecording(filePath) {
-  const content = fs.readFileSync(filePath, "utf-8");
-  const recording = yaml.parse(content);
-  const events = recording.actions || recording.events || [];
+  let recording;
+  try {
+    const content = fs.readFileSync(filePath, "utf-8");
+    recording = yaml.parse(content);
+  } catch (e) {
+    throw new Error(`Failed to read "${filePath}": ${e instanceof Error ? e.message.split("\n")[0] : String(e)}`);
+  }
+  if (recording === null || typeof recording !== "object" || Array.isArray(recording)) {
+    throw new Error(`"${filePath}" does not contain a valid recording (expected a YAML object with events or actions).`);
+  }
+  let rawEvents = recording.events ?? [];
+  const rawActions = recording.actions;
+  if (Array.isArray(rawActions) && rawEvents.length === 0) {
+    rawEvents = rawActions.map((a) => {
+      const action = a;
+      const element = action.element ?? {};
+      return {
+        type: action.type,
+        selector: element.selector ?? action.selector,
+        tagName: element.tag ?? action.tagName,
+        data: { ...action.data, value: action.value, key: action.key },
+        timestamp: action.timestamp,
+        pageState: action.pageState
+      };
+    });
+  }
+  const events = rawEvents;
   const keyEvents = [];
   const eventTypes = {};
   for (const event of events) {

package/dist/{filter-K6FGRJQU.js → filter-3DXC6432.js}

@@ -1,7 +1,7 @@
 import {
   filterRecording,
   parseExcludeTypes
-} from "./chunk-GJAV3QGG.js";
+} from "./chunk-ANVL2ID2.js";
 import "./chunk-KFQGP6VL.js";
 export {
   filterRecording,

package/dist/{filter-TAAYMSYI.js → filter-7YOPVPVC.js}

@@ -24,9 +24,33 @@ var DEFAULT_EXCLUDE_TYPES = [
   "mousedown"
 ];
 function filterRecording(inputPath, outputPath, excludeTypes) {
-  const content = fs.readFileSync(inputPath, "utf-8");
-  const recording = yaml.parse(content);
-  const events = recording.actions || recording.events || [];
+  let recording;
+  try {
+    const content = fs.readFileSync(inputPath, "utf-8");
+    recording = yaml.parse(content);
+  } catch (e) {
+    throw new Error(`Failed to read "${inputPath}": ${e instanceof Error ? e.message.split("\n")[0] : String(e)}`);
+  }
+  if (recording === null || typeof recording !== "object" || Array.isArray(recording)) {
+    throw new Error(`"${inputPath}" does not contain a valid recording (expected a YAML object with events or actions).`);
+  }
+  let rawEvents = recording.events ?? [];
+  const rawActions = recording.actions;
+  if (Array.isArray(rawActions) && rawEvents.length === 0) {
+    rawEvents = rawActions.map((a) => {
+      const action = a;
+      const element = action.element ?? {};
+      return {
+        type: action.type,
+        selector: element.selector ?? action.selector,
+        data: { ...action.data, value: action.value, key: action.key },
+        scrollX: action.scrollX,
+        scrollY: action.scrollY
+      };
+    });
+    delete recording.actions;
+  }
+  const events = rawEvents;
   const originalCount = events.length;
   const exclude = excludeTypes || DEFAULT_EXCLUDE_TYPES;
   const filteredEvents = events.filter((event) => {