@xbrowser/cli 1.8.6 → 1.8.7

package/dist/cli.js

@@ -182,7 +182,7 @@ function asZodSchema(value) {
 // src/executor.ts
 import {
   ok as ok25,
-  fail as fail8,
+  fail as fail9,
   isCommandResult,
   CompositeStorage as CompositeStorage2,
   TipCollector as TipCollector2,
@@ -2316,7 +2316,7 @@ var scrapeCommand = registerCommand({
   scope: "project",
   selectorParams: ["selector"],
   parameters: z15.object({
-    url: z15.string(),
+    url: z15.string().optional(),
     selector: z15.string().optional(),
     timeout: z15.number().default(3e4),
     format: z15.enum(["markdown", "html", "text"]).default("markdown"),
@@ -2329,10 +2329,14 @@ var scrapeCommand = registerCommand({
     const { context, page } = await createEphemeralContext(resolveLaunchOpts(ctx));
     const maxAttempts = p.retries + 1;
     try {
+      const targetUrl = p.url || page.url();
+      if (!targetUrl || targetUrl === "about:blank") {
+        return fail3("URL is required. Provide a URL or connect to a browser (--cdp) with a non-blank page.");
+      }
       let lastError;
       for (let attempt = 1; attempt <= maxAttempts; attempt++) {
         try {
-          await page.goto(p.url, { waitUntil: "commit", timeout: p.timeout });
+          await page.goto(targetUrl, { waitUntil: "commit", timeout: p.timeout });
           await page.waitForSelector("body", { timeout: p.timeout }).catch(() => {
           });
           await page.waitForLoadState("networkidle", Math.min(p.timeout, 8e3)).catch(() => {
@@ -2393,7 +2397,7 @@ var scrapeCommand = registerCommand({
               return { url: location.href, title: document.title, navigation, tables, forms: forms.slice(0, 20), links: links.slice(0, 30), mainText };
             });
             try {
-              persistFromScrape(p.url, structured);
+              persistFromScrape(targetUrl, structured);
             } catch {
             }
             if (p.mode === "smart") {
@@ -2494,7 +2498,7 @@ var scrapeCommand = registerCommand({
 
 // src/commands/map.ts
 import { z as z16 } from "zod";
-import { ok as ok16 } from "@dyyz1993/xcli-core";
+import { ok as ok16, fail as fail4 } from "@dyyz1993/xcli-core";
 
 // src/utils/url.ts
 var SKIP_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -2730,7 +2734,7 @@ var mapCommand = registerCommand({
   description: "Discover all URLs on a website via sitemap and page link extraction",
   scope: "project",
   parameters: z16.object({
-    url: z16.string(),
+    url: z16.string().optional(),
     search: z16.string().optional(),
     sitemap: z16.enum(["include", "only"]).optional(),
     includeSubdomains: z16.boolean().optional(),
@@ -2741,7 +2745,11 @@ var mapCommand = registerCommand({
   handler: async (p, ctx) => {
     const { context, page } = await createEphemeralContext(resolveLaunchOpts(ctx));
     try {
-      const links = await discoverUrls(page, p.url, {
+      const targetUrl = p.url || page.url();
+      if (!targetUrl || targetUrl === "about:blank") {
+        return fail4("URL is required. Provide a URL or connect to a browser (--cdp) with a non-blank page.");
+      }
+      const links = await discoverUrls(page, targetUrl, {
         sitemap: p.sitemap,
         includeSubdomains: p.includeSubdomains,
         allowExternalLinks: p.allowExternalLinks,
@@ -3584,7 +3592,7 @@ ${errors.map((e) => `  - ${e.engine}: ${e.error}`).join("\n")}`
 
 // src/commands/network.ts
 import { z as z19 } from "zod";
-import { ok as ok19, fail as fail4 } from "@dyyz1993/xcli-core";
+import { ok as ok19, fail as fail5 } from "@dyyz1993/xcli-core";
 function extractPath2(url) {
   try {
     const u = new URL(url);
@@ -3749,7 +3757,7 @@ var networkCommand = registerCommand({
     };
     if (p.listen) {
       const page2 = ctx.page;
-      if (!page2) return fail4("No active page. Use --cdp to connect first.");
+      if (!page2) return fail5("No active page. Use --cdp to connect first.");
       const captures = [];
       const consoleMessages = [];
       const wsCaptures = [];
@@ -4129,7 +4137,7 @@ var ENGINE_KEY_ENUM = z20.enum(ALL_ENGINE_KEYS);
 
 // src/commands/snapshot.ts
 import { z as z21 } from "zod";
-import { ok as ok20, fail as fail5, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
+import { ok as ok20, fail as fail6, normalizeTips as normalizeTips3 } from "@dyyz1993/xcli-core";
 
 // src/runtime/ref-store.ts
 var sessions = /* @__PURE__ */ new Map();
@@ -5100,7 +5108,7 @@ var snapshotCommand = registerCommand({
       persistSemantics(url, aria);
       return ok20({ url, title, aria, text, dom }, normalizeTips3(tips));
     }
-    return fail5(`Unknown snapshot type: ${p.type}`);
+    return fail6(`Unknown snapshot type: ${p.type}`);
   }
 });
 function persistSemantics(url, aria) {
@@ -5269,7 +5277,7 @@ var waitForCommand = registerCommand({
 
 // src/commands/tab.ts
 import { z as z23 } from "zod";
-import { ok as ok22, fail as fail6 } from "@dyyz1993/xcli-core";
+import { ok as ok22, fail as fail7 } from "@dyyz1993/xcli-core";
 var TabParams = z23.object({
   subcommand: z23.enum(["list", "new", "close", "switch"]),
   url: z23.string().optional(),
@@ -5286,7 +5294,7 @@ var tabCommand = registerCommand({
   }),
   handler: async (p, ctx) => {
     if (!ctx.browserContext) {
-      return fail6("No browser context available. Use --cdp to connect to a browser first.");
+      return fail7("No browser context available. Use --cdp to connect to a browser first.");
     }
     const pages = ctx.browserContext.pages();
     switch (p.subcommand) {
@@ -5299,7 +5307,7 @@ var tabCommand = registerCommand({
       case "switch":
         return handleSwitch(p, pages, ctx);
       default:
-        return fail6(`Unknown subcommand: ${p.subcommand}`);
+        return fail7(`Unknown subcommand: ${p.subcommand}`);
     }
   }
 });
@@ -5356,11 +5364,11 @@ async function handleNew(p, _pages, ctx) {
 }
 async function handleClose(p, pages, ctx) {
   if (pages.length <= 1) {
-    return fail6("Cannot close the last remaining tab");
+    return fail7("Cannot close the last remaining tab");
   }
   const closeIndex = p.index ?? pages.indexOf(ctx.page);
   if (closeIndex < 0 || closeIndex >= pages.length) {
-    return fail6(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
+    return fail7(`Invalid tab index: ${closeIndex}. Valid range: 0-${pages.length - 1}`);
   }
   const pageToClose = pages[closeIndex];
   const isActivePage = pageToClose === ctx.page;
@@ -5383,10 +5391,10 @@ async function handleClose(p, pages, ctx) {
 }
 async function handleSwitch(p, pages, ctx) {
   if (p.index === void 0) {
-    return fail6("Parameter --index is required for switch subcommand");
+    return fail7("Parameter --index is required for switch subcommand");
   }
   if (p.index < 0 || p.index >= pages.length) {
-    return fail6(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
+    return fail7(`Invalid tab index: ${p.index}. Valid range: 0-${pages.length - 1}`);
   }
   const targetPage = pages[p.index];
   await targetPage.bringToFront().catch(() => {
@@ -5638,7 +5646,7 @@ registerCommandDefinition("addinitscript", ["script"]);
 
 // src/commands/find.ts
 import { z as z25 } from "zod";
-import { ok as ok24, fail as fail7, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
+import { ok as ok24, fail as fail8, normalizeTips as normalizeTips5 } from "@dyyz1993/xcli-core";
 var actionSchema2 = z25.enum(["click", "fill", "type", "select", "hover", "check"]);
 var findCommand = registerCommand({
   name: "find",
@@ -5679,7 +5687,7 @@ var findCommand = registerCommand({
     });
     const count = await locator.count();
     if (count === 0) {
-      return fail7(`No element found with ${p.strategy}="${p.value}"`);
+      return fail8(`No element found with ${p.strategy}="${p.value}"`);
     }
     const tips = [];
     const target = selectTarget(locator, p.strategy);
@@ -5691,15 +5699,15 @@ var findCommand = registerCommand({
       await target.click({ timeout: p.timeout, force: true });
       return okWithTips({ matched: count, selector, action: "click" }, tips);
     } else if (actionName === "fill") {
-      if (actionValue === void 0) return fail7("find fill requires a value");
+      if (actionValue === void 0) return fail8("find fill requires a value");
       await target.fill(actionValue, { timeout: p.timeout, force: true });
       return okWithTips({ matched: count, selector, action: `fill("${actionValue}")` }, tips);
     } else if (actionName === "type") {
-      if (actionValue === void 0) return fail7("find type requires a value");
+      if (actionValue === void 0) return fail8("find type requires a value");
       await target.type(actionValue, { delay: 10, timeout: p.timeout });
       return okWithTips({ matched: count, selector, action: `type("${actionValue}")` }, tips);
     } else if (actionName === "select") {
-      if (actionValue === void 0) return fail7("find select requires a value");
+      if (actionValue === void 0) return fail8("find select requires a value");
       await target.selectOption(actionValue);
       return okWithTips({ matched: count, selector, action: `select("${actionValue}")` }, tips);
     } else if (actionName === "hover") {
@@ -7135,7 +7143,7 @@ async function guardCheck(commandName) {
   }
 }
 function errorResult(message) {
-  return { ...fail8(message), duration: 0 };
+  return { ...fail9(message), duration: 0 };
 }
 function tipsToMessages(tips) {
   if (!tips || tips.length === 0) return [];
@@ -7436,7 +7444,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail8(errorMessage), duration };
+    return { ...fail9(errorMessage), duration };
   } finally {
   }
 }
@@ -7477,7 +7485,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail8(`Plugin "${cmdName}" requires a sub-command`),
+              ...fail9(`Plugin "${cmdName}" requires a sub-command`),
               duration: 0
             });
             if (type === "and") {
@@ -7496,7 +7504,7 @@ async function executeChain(input, options) {
             results.push({
               command: cmdName,
               raw: cmdStr,
-              ...fail8(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
+              ...fail9(`Unknown command "${subCommand}" for plugin "${cmdName}"`),
               duration: 0
             });
             if (type === "and") {
@@ -7628,7 +7636,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail8(errorMessage),
+              ...fail9(errorMessage),
               duration: duration2
             });
             if (type === "and") {

package/dist/daemon-main.js

@@ -55,7 +55,7 @@ import {
 // src/executor.ts
 import {
   ok as ok25,
-  fail as fail8,
+  fail as fail9,
   isCommandResult,
   CompositeStorage as CompositeStorage2,
   TipCollector as TipCollector2,
@@ -2283,7 +2283,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 +2296,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 +2364,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 +2465,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 +2701,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 +2712,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 +3559,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 +3724,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 +4104,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 +5075,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 +5244,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 +5261,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 +5274,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 +5331,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 +5358,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 +5613,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 +5654,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 +5666,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 +6680,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 [];
@@ -6973,7 +6981,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail8(errorMessage), duration };
+    return { ...fail9(errorMessage), duration };
   } finally {
   }
 }
@@ -7014,7 +7022,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 +7041,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 +7173,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail8(errorMessage),
+              ...fail9(errorMessage),
               duration: duration2
             });
             if (type === "and") {

package/dist/index.js

@@ -109,7 +109,7 @@ import {
 // src/executor.ts
 import {
   ok as ok25,
-  fail as fail8,
+  fail as fail9,
   isCommandResult,
   CompositeStorage as CompositeStorage2,
   TipCollector as TipCollector2,
@@ -2356,7 +2356,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"),
@@ -2369,10 +2369,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(() => {
@@ -2433,7 +2437,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") {
@@ -2534,7 +2538,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([
@@ -2770,7 +2774,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(),
@@ -2781,7 +2785,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,
@@ -3624,7 +3632,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);
@@ -3789,7 +3797,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 = [];
@@ -4446,7 +4454,7 @@ function parseMarkdownResults(rawText) {
 
 // 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();
@@ -5417,7 +5425,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) {
@@ -5586,7 +5594,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(),
@@ -5603,7 +5611,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) {
@@ -5616,7 +5624,7 @@ var tabCommand = registerCommand({
       case "switch":
         return handleSwitch(p, pages, ctx);
       default:
-        return fail6(`Unknown subcommand: ${p.subcommand}`);
+        return fail7(`Unknown subcommand: ${p.subcommand}`);
     }
   }
 });
@@ -5673,11 +5681,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;
@@ -5700,10 +5708,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(() => {
@@ -5955,7 +5963,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",
@@ -5996,7 +6004,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);
@@ -6008,15 +6016,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") {
@@ -7452,7 +7460,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 [];
@@ -7756,7 +7764,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...fail8(errorMessage), duration };
+    return { ...fail9(errorMessage), duration };
   } finally {
   }
 }
@@ -7797,7 +7805,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") {
@@ -7816,7 +7824,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") {
@@ -7948,7 +7956,7 @@ async function executeChain(input, options) {
             results.push({
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
-              ...fail8(errorMessage),
+              ...fail9(errorMessage),
               duration: duration2
             });
             if (type === "and") {

package/package.json

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