@xbrowser/cli 1.2.2 → 1.3.1

package/dist/daemon-main.js

@@ -21,12 +21,12 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-SLQR57XZ.js";
-import "./chunk-QFROODUU.js";
+} from "./chunk-7OGKQWXE.js";
+import "./chunk-N4PIGZDG.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getPluginLoader
-} from "./chunk-PHBK3TRN.js";
+} from "./chunk-2QQDTXDL.js";
 import {
   getDaemonConfig,
   getDaemonProcessStatus
@@ -54,7 +54,7 @@ import {
 // src/executor.ts
 import {
   ok as ok25,
-  fail as fail7,
+  fail as fail8,
   isCommandResult,
   CompositeStorage as CompositeStorage2,
   TipCollector as TipCollector2,
@@ -224,7 +224,7 @@ var NoopSiteInstance = class {
 
 // src/commands/navigation.ts
 import { z } from "zod";
-import { ok } from "@dyyz1993/xcli-core";
+import { ok, fail } from "@dyyz1993/xcli-core";
 
 // src/commands/command-registry.ts
 var registry = /* @__PURE__ */ new Map();
@@ -313,13 +313,19 @@ var gotoCommand = registerCommand({
       if (/^[\w-]+(\.[\w-]+)+/.test(url) || url.startsWith("localhost")) {
         url = "https://" + url;
       } else {
-        throw new Error(`Invalid URL: "${url}". Expected http(s)://, file://, about:, data:, or a domain name.`);
+        return fail(`Invalid URL: "${url}". Expected http(s)://, file://, about:, data:, or a domain name.`);
       }
     }
-    const response = await ctx.page.goto(url, {
-      waitUntil: p.waitUntil || "domcontentloaded",
-      ...p.timeout ? { timeout: p.timeout } : {}
-    });
+    let response;
+    try {
+      response = await ctx.page.goto(url, {
+        waitUntil: p.waitUntil || "domcontentloaded",
+        ...p.timeout ? { timeout: p.timeout } : {}
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return fail(`Navigation failed: ${msg}`);
+    }
     const ssr = await detectSsr(ctx.page);
     return ok({ url, status: response?.status(), ...ssr ? { ssr } : {} });
   }
@@ -634,6 +640,22 @@ var checkCommand = registerCommand({
     return ok2({ selector: p.selector });
   }
 });
+var uncheckCommand = registerCommand({
+  name: "uncheck",
+  description: "Uncheck checkbox or radio",
+  scope: "element",
+  selectorParams: ["selector"],
+  parameters: z2.object({
+    selector: z2.string()
+  }),
+  result: z2.object({
+    selector: z2.string()
+  }),
+  handler: async (p, ctx) => {
+    await ctx.page.uncheck(p.selector, { timeout: 1e4 });
+    return ok2({ selector: p.selector });
+  }
+});
 var hoverCommand = registerCommand({
   name: "hover",
   description: "Hover over element",
@@ -1175,7 +1197,7 @@ var setViewportCommand = registerCommand({
 
 // src/commands/frame.ts
 import { z as z12 } from "zod";
-import { ok as ok12, fail } from "@dyyz1993/xcli-core";
+import { ok as ok12, fail as fail2 } from "@dyyz1993/xcli-core";
 var framesCommand = registerCommand({
   name: "frames",
   description: "List all frames in the current page",
@@ -1188,7 +1210,9 @@ var framesCommand = registerCommand({
     }))
   }),
   handler: async (_p, ctx) => {
-    const frameList = ctx.page.frames().map((frame, index) => ({
+    const discover = ctx.page.discoverFrames;
+    const rawFrames = discover ? await discover.call(ctx.page) : ctx.page.frames();
+    const frameList = rawFrames.map((frame, index) => ({
       index,
       name: frame.name(),
       url: frame.url()
@@ -1210,17 +1234,18 @@ var frameCommand = registerCommand({
     error: z12.string().optional()
   }),
   handler: async (p, ctx) => {
-    const allFrames = ctx.page.frames();
+    const discover = ctx.page.discoverFrames;
+    const rawFrames = discover ? await discover.call(ctx.page) : ctx.page.frames();
     let targetFrame;
     if (p.index !== void 0) {
-      targetFrame = allFrames[p.index];
+      targetFrame = rawFrames[p.index];
     } else if (p.name !== void 0) {
-      targetFrame = allFrames.find((f) => f.name() === p.name);
+      targetFrame = rawFrames.find((f) => f.name() === p.name);
     } else {
-      return fail("Must provide index or name");
+      return fail2("Must provide index or name");
     }
     if (!targetFrame) {
-      return fail("Frame not found");
+      return fail2("Frame not found");
     }
     return ok12({
       name: targetFrame.name(),
@@ -1866,7 +1891,7 @@ var actionsCommand = registerCommand({
 
 // src/commands/scrape.ts
 import { z as z15 } from "zod";
-import { ok as ok15, fail as fail2 } from "@dyyz1993/xcli-core";
+import { ok as ok15, fail as fail3 } from "@dyyz1993/xcli-core";
 
 // src/lib/html-to-markdown.ts
 import * as cheerio from "cheerio";
@@ -2382,7 +2407,7 @@ var scrapeCommand = registerCommand({
           }
         }
       }
-      return fail2(`Scrape failed after ${maxAttempts} attempt(s): ${lastError?.message ?? "unknown error"}`);
+      return fail3(`Scrape failed after ${maxAttempts} attempt(s): ${lastError?.message ?? "unknown error"}`);
     } finally {
       await closeEphemeralContext(context);
     }
@@ -3446,7 +3471,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 fail3 } from "@dyyz1993/xcli-core";
+import { ok as ok19, fail as fail4 } from "@dyyz1993/xcli-core";
 function extractPath2(url) {
   try {
     const u = new URL(url);
@@ -3611,7 +3636,7 @@ var networkCommand = registerCommand({
     };
     if (p.listen) {
       const page2 = ctx.page;
-      if (!page2) return fail3("No active page. Use --cdp to connect first.");
+      if (!page2) return fail4("No active page. Use --cdp to connect first.");
       const captures = [];
       const consoleMessages = [];
       const wsCaptures = [];
@@ -3991,7 +4016,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 fail4, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
+import { ok as ok20, fail as fail5, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
 
 // src/runtime/ref-store.ts
 var sessions = /* @__PURE__ */ new Map();
@@ -4947,7 +4972,7 @@ var snapshotCommand = registerCommand({
       persistSemantics(url, aria);
       return ok20({ url, title, aria, text, dom }, normalizeTips3(tips));
     }
-    return fail4(`Unknown snapshot type: ${p.type}`);
+    return fail5(`Unknown snapshot type: ${p.type}`);
   }
 });
 function persistSemantics(url, aria) {
@@ -5116,7 +5141,7 @@ var waitForCommand = registerCommand({
 
 // src/commands/tab.ts
 import { z as z23 } from "zod";
-import { ok as ok22, fail as fail5 } from "@dyyz1993/xcli-core";
+import { ok as ok22, fail as fail6 } from "@dyyz1993/xcli-core";
 var TabParams = z23.object({
   subcommand: z23.enum(["list", "new", "close", "switch"]),
   url: z23.string().optional(),
@@ -5143,7 +5168,7 @@ var tabCommand = registerCommand({
       case "switch":
         return handleSwitch(p, pages, ctx);
       default:
-        return fail5(`Unknown subcommand: ${p.subcommand}`);
+        return fail6(`Unknown subcommand: ${p.subcommand}`);
     }
   }
 });
@@ -5200,11 +5225,11 @@ async function handleNew(p, _pages, ctx) {
 }
 async function handleClose(p, pages, ctx) {
   if (pages.length <= 1) {
-    return fail5("Cannot close the last remaining tab");
+    return fail6("Cannot close the last remaining tab");
   }
   const closeIndex = p.index ?? pages.indexOf(ctx.page);
   if (closeIndex < 0 || closeIndex >= pages.length) {
-    return fail5(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
+    return fail6(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
   }
   const pageToClose = pages[closeIndex];
   const isActivePage = pageToClose === ctx.page;
@@ -5227,10 +5252,10 @@ async function handleClose(p, pages, ctx) {
 }
 async function handleSwitch(p, pages, ctx) {
   if (p.index === void 0) {
-    return fail5("Parameter --index is required for switch subcommand");
+    return fail6("Parameter --index is required for switch subcommand");
   }
   if (p.index < 0 || p.index >= pages.length) {
-    return fail5(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
+    return fail6(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
   }
   const targetPage = pages[p.index];
   await targetPage.bringToFront().catch(() => {
@@ -5476,7 +5501,7 @@ registerCommandDefinition("addinitscript", ["script"]);
 
 // src/commands/find.ts
 import { z as z25 } from "zod";
-import { ok as ok24, fail as fail6, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
+import { ok as ok24, fail as fail7, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
 var actionSchema2 = z25.enum(["click", "fill", "type", "select", "hover", "check"]);
 var findCommand = registerCommand({
   name: "find",
@@ -5517,7 +5542,7 @@ var findCommand = registerCommand({
     });
     const count = await locator.count();
     if (count === 0) {
-      return fail6(`No element found with ${p.strategy}="${p.value}"`);
+      return fail7(`No element found with ${p.strategy}="${p.value}"`);
     }
     const tips = [];
     const target = selectTarget(locator, p.strategy);
@@ -5529,15 +5554,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 fail6("find fill requires a value");
+      if (actionValue === void 0) return fail7("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 fail6("find type requires a value");
+      if (actionValue === void 0) return fail7("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 fail6("find select requires a value");
+      if (actionValue === void 0) return fail7("find select requires a value");
       await target.selectOption(actionValue);
       return okWithTips({ matched: count, selector, action: `select("${actionValue}")` }, tips);
     } else if (actionName === "hover") {
@@ -6531,7 +6556,7 @@ async function guardCheck(commandName) {
   }
 }
 function errorResult(message) {
-  return { ...fail7(message), duration: 0 };
+  return { ...fail8(message), duration: 0 };
 }
 function tipsToMessages(tips) {
   if (!tips || tips.length === 0) return [];
@@ -6564,7 +6589,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-CWI6BXYK.js");
+    const { findTargetPage } = await import("./browser-ALV2PLW4.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.`);
@@ -6768,7 +6793,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail7(errorMessage), duration };
+    return { ...fail8(errorMessage), duration };
   } finally {
   }
 }
@@ -6809,7 +6834,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail7(`Plugin "${cmdName}" requires a sub-command`),
+              ...fail8(`Plugin "${cmdName}" requires a sub-command`),
               duration: 0
             });
             if (type === "and") {
@@ -6828,7 +6853,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail7(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
+              ...fail8(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
               duration: 0
             });
             if (type === "and") {
@@ -6960,7 +6985,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail7(errorMessage),
+              ...fail8(errorMessage),
               duration: duration2
             });
             if (type === "and") {
@@ -7863,9 +7888,9 @@ function createRPCHandler() {
     return result;
   }
   async function handlePluginsReload() {
-    const { resetPluginLoader } = await import("./plugin-singleton-ZBVTWEYK.js");
+    const { resetPluginLoader } = await import("./plugin-singleton-SYJF6BD6.js");
     resetPluginLoader();
-    const loader = await import("./plugin-singleton-ZBVTWEYK.js").then((m) => m.getPluginLoader());
+    const loader = await import("./plugin-singleton-SYJF6BD6.js").then((m) => m.getPluginLoader());
     const sites = loader.getCore().loader.getSites();
     return { ok: true, plugins: sites.length };
   }
@@ -8280,7 +8305,7 @@ function createRPCHandler() {
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {
       try {
-        const { SessionReplayer } = await import("./session-replayer-IXLSCF5U.js");
+        const { SessionReplayer } = await import("./session-replayer-JIVFXVUL.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

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

@@ -6,9 +6,10 @@ 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 || [];
   const keyEvents = [];
   const eventTypes = {};
-  for (const event of recording.events || []) {
+  for (const event of events) {
     const type = event.type;
     eventTypes[type] = (eventTypes[type] || 0) + 1;
     if (["click", "input", "type", "keydown", "keypress", "hover", "hover_enter", "hover_leave"].includes(type)) {
@@ -27,7 +28,7 @@ function extractRecording(filePath) {
   }
   return {
     startUrl: recording.startUrl,
-    totalEvents: (recording.events || []).length,
+    totalEvents: events.length,
     keyEventsCount: keyEvents.length,
     eventTypes,
     operations: keyEvents.map((e, i) => ({

package/dist/{extract-2ZFW2MX7.js → extract-RM62AJXW.js}

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

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

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

package/dist/{filter-EDTFGLS5.js → filter-TAAYMSYI.js}

@@ -26,9 +26,9 @@ var DEFAULT_EXCLUDE_TYPES = [
 function filterRecording(inputPath, outputPath, excludeTypes) {
   const content = fs.readFileSync(inputPath, "utf-8");
   const recording = yaml.parse(content);
-  const exclude = excludeTypes || DEFAULT_EXCLUDE_TYPES;
-  const events = recording.events || [];
+  const events = recording.actions || recording.events || [];
   const originalCount = events.length;
+  const exclude = excludeTypes || DEFAULT_EXCLUDE_TYPES;
   const filteredEvents = events.filter((event) => {
     return !exclude.includes(event.type);
   });

package/dist/index.d.ts

@@ -1497,6 +1497,16 @@ declare class PluginInstaller {
      * @throws If the plugin already exists without `force`, or if installation fails.
      */
     install(source: string, options?: InstallOptions): Promise<InstalledPlugin>;
+    /**
+     * Fix missing `../shared/` dependencies after installation.
+     *
+     * Some marketplace/npm packages import from `../shared/` (e.g. ssr-detect.js,
+     * ai-chat-base.ts) but the `shared/` directory is not included in the package.
+     * This method scans the installed plugin's index.ts for such imports and
+     * copies the missing files from the local repository's `.xcli/plugins/shared/`
+     * directory (if available).
+     */
+    private fixSharedDeps;
     installFromMarketplace(slug: string, options?: InstallOptions): Promise<InstalledPlugin>;
     installWithMarketplaceFallback(source: string, options?: InstallOptions): Promise<InstalledPlugin>;
     /**