@xbrowser/cli 1.1.2 → 1.2.0

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-XVZ6NKRJ.js";
+} from "./chunk-MNFOCOL6.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -800,6 +800,21 @@ var waitForSelectorDef = {
   }
 };
 var waitCommand = registerCommand({ name: "wait", selectorParams: ["selector"], ...waitForSelectorDef });
+var waitForTimeoutCommand = registerCommand({
+  name: "waitForTimeout",
+  description: "Wait for a specified number of milliseconds",
+  scope: "project",
+  parameters: z4.object({
+    timeout: z4.number().describe("Milliseconds to wait").default(1e3)
+  }),
+  result: z4.object({
+    waited: z4.number()
+  }),
+  handler: async (p) => {
+    await new Promise((r) => setTimeout(r, p.timeout));
+    return ok4({ waited: p.timeout });
+  }
+});
 
 // src/commands/scroll.ts
 import { z as z5 } from "zod";
@@ -1665,7 +1680,7 @@ var healthCheckCommand = registerCommand({
             issues.push({
               severity: "error",
               category: "links",
-              message: `Broken link (fetch error): ${href} \u2014 ${errMsg(err) || "unknown"}`
+              message: `Broken link (fetch error): ${href} \u2014 ${(err instanceof Error ? err.message : String(err)) || "unknown"}`
             });
           }
         }
@@ -2341,9 +2356,53 @@ var scrapeCommand = registerCommand({
           }
           let content;
           switch (p.format) {
-            case "markdown":
+            case "markdown": {
+              const tablesMd = await page.evaluate(() => {
+                const tableSelectors = [
+                  "table",
+                  '[role="table"]',
+                  '[role="grid"]',
+                  '[class*="el-table"]',
+                  // Element UI
+                  '[class*="ant-table"]',
+                  // Ant Design
+                  '[class*="MuiTable"]',
+                  // Material UI
+                  '[class*="table"]'
+                  // Generic table-like
+                ].join(",");
+                const tables = document.querySelectorAll(tableSelectors);
+                if (tables.length === 0) return "";
+                return Array.from(tables).map((table) => {
+                  const rows = table.querySelectorAll('tr, [role="row"], [class*="row"]');
+                  if (rows.length === 0) return "";
+                  const mdRows = Array.from(rows).map((row) => {
+                    const cells = row.querySelectorAll('th, td, [role="columnheader"], [role="cell"], [class*="cell"], [class*="col"]');
+                    return "| " + Array.from(cells).map((c) => {
+                      const cellText = c.innerText?.trim().replace(/\n/g, " ") || "";
+                      return cellText.replace(/\|/g, "\\|") || "";
+                    }).join(" | ") + " |";
+                  }).join("\n");
+                  const headerRow = rows[0];
+                  const headerCells = headerRow.querySelectorAll('th, [role="columnheader"], [class*="header"]');
+                  const hasHeader = headerCells.length > 0;
+                  if (hasHeader && mdRows) {
+                    const headerCount = headerCells.length;
+                    const sep = "| " + Array(headerCount).fill("---").join(" | ") + " |";
+                    return mdRows.split("\n").map((line, i) => {
+                      if (i === 0) return line + "\n" + sep;
+                      return line;
+                    }).join("\n");
+                  }
+                  return mdRows;
+                }).join("\n\n");
+              });
               content = htmlToMarkdown(html, { onlyMainContent: p.onlyMainContent });
+              if (tablesMd) {
+                content = tablesMd + "\n\n" + content;
+              }
               break;
+            }
             case "html":
               content = html;
               break;
@@ -5283,6 +5342,7 @@ function parseCommandChain(input, options) {
         continue;
       }
       if (char === ";") {
+        lastOperator = "sequence";
         flushPipeline();
         continue;
       }
@@ -5337,6 +5397,7 @@ registerCommandDefinition("uncheck", ["selector"]);
 registerCommandDefinition("hover", ["selector"]);
 registerCommandDefinition("dblclick", ["selector"]);
 registerCommandDefinition("wait", ["selector"]);
+registerCommandDefinition("waitForTimeout", ["timeout"]);
 registerCommandDefinition("screenshot", []);
 registerCommandDefinition("eval", ["expression"]);
 registerCommandDefinition("scroll", ["direction"]);
@@ -6969,7 +7030,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-DZVIVKOA.js");
+    const { findTargetPage } = await import("./browser-PZX7PO23.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.`);
@@ -9477,7 +9538,17 @@ var SELECTOR_COMMANDS = /* @__PURE__ */ new Set([
   "dblclick",
   "wait"
 ]);
+var CAMEL_TO_KEBAB = {
+  getCookies: "get-cookies",
+  setCookie: "set-cookie",
+  clearCookies: "clear-cookies",
+  getLocalStorage: "get-local-storage",
+  setLocalStorage: "set-local-storage",
+  clearLocalStorage: "clear-local-storage",
+  setViewport: "set-viewport"
+};
 async function handleBrowserCommand(command, args, options, sessionName, mode, cdpEndpoint) {
+  command = CAMEL_TO_KEBAB[command] || command;
   if (args.includes("--help") || args.includes("-h") || options.help || options.h) {
     const cmdDef = getCommand(command);
     if (cmdDef) {
@@ -9607,7 +9678,7 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
           type: options.type,
           selector: options.selector || options.s,
           base64: !!options.base64,
-          output: options.output || options.o
+          output: options.output || options.o || args[0]
         };
         break;
       case "eval":
@@ -9844,6 +9915,7 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
       outputResult(result.data, mode);
       console.error(`
   \u26A0\uFE0F  ${hint}`);
+      process.exit(1);
     } else {
       outputResult(result.data, mode);
     }
@@ -9938,11 +10010,6 @@ async function handleSession(args, options, mode, _cdpEndpoint) {
 }
 
 // src/cli/plugin-routes.ts
-var pluginLoader3 = null;
-function getPluginLoader2() {
-  if (!pluginLoader3) pluginLoader3 = new XBrowserPluginLoader();
-  return pluginLoader3;
-}
 async function buildRuntimePluginInfo() {
   const loader = await getPluginLoader();
   const sites = loader.getCore().loader.getSites();
@@ -10200,6 +10267,10 @@ async function handlePlugin(args, options, mode) {
       } else {
         result = await installer.installWithMarketplaceFallback(source, installOpts);
       }
+      try {
+        await (await getPluginLoader()).reloadPlugin(result.name);
+      } catch {
+      }
       outputResult(
         { ok: true, name: result.name, source: result.source, path: result.path },
         mode
@@ -10215,6 +10286,11 @@ async function handlePlugin(args, options, mode) {
         outputError(`Plugin "${name}" is not installed. Use 'xbrowser plugin list' to see installed plugins.`);
       }
       await installer.uninstall(name);
+      try {
+        const loader = await getPluginLoader();
+        await loader.reloadPlugin(name);
+      } catch {
+      }
       outputResult({ ok: true, name }, mode);
       break;
     }
@@ -10268,7 +10344,7 @@ Total: ${enrichedPlugins.length} plugins`);
     case "reload": {
       const name = subArgs[0];
       if (!name) outputError("Usage: xbrowser plugin reload <name>");
-      await getPluginLoader2().reloadPlugin(name);
+      (await getPluginLoader()).reloadPlugin(name);
       outputResult({ ok: true, name }, mode);
       break;
     }
@@ -12116,10 +12192,18 @@ function extractCdpFromArgv(argv) {
 async function handleStdinMode(stdinCommands, argv) {
   const chain = stdinCommands.join(" && ");
   const cdpEndpoint = argv ? extractCdpFromArgv(argv) : void 0;
-  const chainResult = await executeChain(chain, { fileMode: true, cdpEndpoint });
+  const sessionName = argv ? extractSessionNameFromArgv(argv) : "default";
+  const chainResult = await executeChain(chain, { fileMode: true, cdpEndpoint, sessionName });
   printChainResult(chainResult);
   if (!chainResult.success) throw new Error("Command failed");
 }
+function extractSessionNameFromArgv(argv) {
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === "--session" && argv[i + 1]) return argv[i + 1];
+    if (typeof argv[i] === "string" && argv[i].startsWith("--session=")) return argv[i].slice(10);
+  }
+  return process.env.XBROWSER_SESSION || "default";
+}
 async function handleEvalMode(argv) {
   const evalCommands = parseEvalFlags(argv);
   if (evalCommands.length === 0) return;
@@ -12259,6 +12343,31 @@ async function routeCommand(argvIn, stdinCommands) {
       }
       return;
     }
+    const SUBCOMMAND_HELP = {
+      session: "session open|close|kill|list [--session <name>] [--cdp <endpoint>]",
+      plugin: "plugin install|uninstall|list|reload|schema|search|info <name>",
+      record: "record start|stop|status [--url <url>] [--name <flow>]",
+      daemon: "daemon status [--port <port>]",
+      replay: "replay <file> [--slow-mo <ms>] [--stop-on-error]",
+      create: "create <name> [--template static|dynamic|login|api]",
+      run: "run <file>",
+      serve: "serve [--port <port>] [--token <token>]",
+      remote: "remote <url> [command] [--token <token>]",
+      convert: "convert <file> [--to js|py|sh]",
+      extract: "extract <file> [--format json|yaml]",
+      filter: "filter <file> [--include <type>] [--exclude <type>]",
+      test: "test <name> [--cdp <endpoint>]",
+      viewer: "viewer [--session <name>]",
+      kill: "kill [--all]",
+      net: "net [--cdp <endpoint>]"
+    };
+    const subHelp = SUBCOMMAND_HELP[command];
+    if (subHelp) {
+      console.log(`
+  Usage: xbrowser ${subHelp}
+`);
+      return;
+    }
     showMainHelp();
     return;
   }
@@ -12745,7 +12854,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-DZVIVKOA.js");
+      const { ensureProcessCanExit } = await import("./browser-PZX7PO23.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);

package/dist/daemon-main.js

@@ -21,8 +21,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-NDAMCPIJ.js";
-import "./chunk-E5WWMKXB.js";
+} from "./chunk-SLQR57XZ.js";
+import "./chunk-QFROODUU.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getDaemonConfig,
@@ -758,6 +758,21 @@ var waitForSelectorDef = {
   }
 };
 var waitCommand = registerCommand({ name: "wait", selectorParams: ["selector"], ...waitForSelectorDef });
+var waitForTimeoutCommand = registerCommand({
+  name: "waitForTimeout",
+  description: "Wait for a specified number of milliseconds",
+  scope: "project",
+  parameters: z4.object({
+    timeout: z4.number().describe("Milliseconds to wait").default(1e3)
+  }),
+  result: z4.object({
+    waited: z4.number()
+  }),
+  handler: async (p) => {
+    await new Promise((r) => setTimeout(r, p.timeout));
+    return ok4({ waited: p.timeout });
+  }
+});
 
 // src/commands/scroll.ts
 import { z as z5 } from "zod";
@@ -1623,7 +1638,7 @@ var healthCheckCommand = registerCommand({
             issues.push({
               severity: "error",
               category: "links",
-              message: `Broken link (fetch error): ${href} \u2014 ${errMsg(err) || "unknown"}`
+              message: `Broken link (fetch error): ${href} \u2014 ${(err instanceof Error ? err.message : String(err)) || "unknown"}`
             });
           }
         }
@@ -2299,9 +2314,53 @@ var scrapeCommand = registerCommand({
           }
           let content;
           switch (p.format) {
-            case "markdown":
+            case "markdown": {
+              const tablesMd = await page.evaluate(() => {
+                const tableSelectors = [
+                  "table",
+                  '[role="table"]',
+                  '[role="grid"]',
+                  '[class*="el-table"]',
+                  // Element UI
+                  '[class*="ant-table"]',
+                  // Ant Design
+                  '[class*="MuiTable"]',
+                  // Material UI
+                  '[class*="table"]'
+                  // Generic table-like
+                ].join(",");
+                const tables = document.querySelectorAll(tableSelectors);
+                if (tables.length === 0) return "";
+                return Array.from(tables).map((table) => {
+                  const rows = table.querySelectorAll('tr, [role="row"], [class*="row"]');
+                  if (rows.length === 0) return "";
+                  const mdRows = Array.from(rows).map((row) => {
+                    const cells = row.querySelectorAll('th, td, [role="columnheader"], [role="cell"], [class*="cell"], [class*="col"]');
+                    return "| " + Array.from(cells).map((c) => {
+                      const cellText = c.innerText?.trim().replace(/\n/g, " ") || "";
+                      return cellText.replace(/\|/g, "\\|") || "";
+                    }).join(" | ") + " |";
+                  }).join("\n");
+                  const headerRow = rows[0];
+                  const headerCells = headerRow.querySelectorAll('th, [role="columnheader"], [class*="header"]');
+                  const hasHeader = headerCells.length > 0;
+                  if (hasHeader && mdRows) {
+                    const headerCount = headerCells.length;
+                    const sep = "| " + Array(headerCount).fill("---").join(" | ") + " |";
+                    return mdRows.split("\n").map((line, i) => {
+                      if (i === 0) return line + "\n" + sep;
+                      return line;
+                    }).join("\n");
+                  }
+                  return mdRows;
+                }).join("\n\n");
+              });
               content = htmlToMarkdown(html, { onlyMainContent: p.onlyMainContent });
+              if (tablesMd) {
+                content = tablesMd + "\n\n" + content;
+              }
               break;
+            }
             case "html":
               content = html;
               break;
@@ -5241,6 +5300,7 @@ function parseCommandChain(input, options) {
         continue;
       }
       if (char === ";") {
+        lastOperator = "sequence";
         flushPipeline();
         continue;
       }
@@ -5295,6 +5355,7 @@ registerCommandDefinition("uncheck", ["selector"]);
 registerCommandDefinition("hover", ["selector"]);
 registerCommandDefinition("dblclick", ["selector"]);
 registerCommandDefinition("wait", ["selector"]);
+registerCommandDefinition("waitForTimeout", ["timeout"]);
 registerCommandDefinition("screenshot", []);
 registerCommandDefinition("eval", ["expression"]);
 registerCommandDefinition("scroll", ["direction"]);
@@ -6927,7 +6988,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-ZF4EJ3SK.js");
+    const { findTargetPage } = await import("./browser-CWI6BXYK.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.`);
@@ -8611,7 +8672,7 @@ function createRPCHandler() {
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {
       try {
-        const { SessionReplayer } = await import("./session-replayer-UHITXIOZ.js");
+        const { SessionReplayer } = await import("./session-replayer-IXLSCF5U.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.js

@@ -81,8 +81,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-OH7CB2P6.js";
-import "./chunk-E5WWMKXB.js";
+} from "./chunk-6V57JME6.js";
+import "./chunk-QFROODUU.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -840,6 +840,21 @@ var waitForSelectorDef = {
   }
 };
 var waitCommand = registerCommand({ name: "wait", selectorParams: ["selector"], ...waitForSelectorDef });
+var waitForTimeoutCommand = registerCommand({
+  name: "waitForTimeout",
+  description: "Wait for a specified number of milliseconds",
+  scope: "project",
+  parameters: z4.object({
+    timeout: z4.number().describe("Milliseconds to wait").default(1e3)
+  }),
+  result: z4.object({
+    waited: z4.number()
+  }),
+  handler: async (p) => {
+    await new Promise((r) => setTimeout(r, p.timeout));
+    return ok4({ waited: p.timeout });
+  }
+});
 
 // src/commands/scroll.ts
 import { z as z5 } from "zod";
@@ -1705,7 +1720,7 @@ var healthCheckCommand = registerCommand({
             issues.push({
               severity: "error",
               category: "links",
-              message: `Broken link (fetch error): ${href} \u2014 ${errMsg(err) || "unknown"}`
+              message: `Broken link (fetch error): ${href} \u2014 ${(err instanceof Error ? err.message : String(err)) || "unknown"}`
             });
           }
         }
@@ -2381,9 +2396,53 @@ var scrapeCommand = registerCommand({
           }
           let content;
           switch (p.format) {
-            case "markdown":
+            case "markdown": {
+              const tablesMd = await page.evaluate(() => {
+                const tableSelectors = [
+                  "table",
+                  '[role="table"]',
+                  '[role="grid"]',
+                  '[class*="el-table"]',
+                  // Element UI
+                  '[class*="ant-table"]',
+                  // Ant Design
+                  '[class*="MuiTable"]',
+                  // Material UI
+                  '[class*="table"]'
+                  // Generic table-like
+                ].join(",");
+                const tables = document.querySelectorAll(tableSelectors);
+                if (tables.length === 0) return "";
+                return Array.from(tables).map((table) => {
+                  const rows = table.querySelectorAll('tr, [role="row"], [class*="row"]');
+                  if (rows.length === 0) return "";
+                  const mdRows = Array.from(rows).map((row) => {
+                    const cells = row.querySelectorAll('th, td, [role="columnheader"], [role="cell"], [class*="cell"], [class*="col"]');
+                    return "| " + Array.from(cells).map((c) => {
+                      const cellText = c.innerText?.trim().replace(/\n/g, " ") || "";
+                      return cellText.replace(/\|/g, "\\|") || "";
+                    }).join(" | ") + " |";
+                  }).join("\n");
+                  const headerRow = rows[0];
+                  const headerCells = headerRow.querySelectorAll('th, [role="columnheader"], [class*="header"]');
+                  const hasHeader = headerCells.length > 0;
+                  if (hasHeader && mdRows) {
+                    const headerCount = headerCells.length;
+                    const sep = "| " + Array(headerCount).fill("---").join(" | ") + " |";
+                    return mdRows.split("\n").map((line, i) => {
+                      if (i === 0) return line + "\n" + sep;
+                      return line;
+                    }).join("\n");
+                  }
+                  return mdRows;
+                }).join("\n\n");
+              });
               content = htmlToMarkdown(html, { onlyMainContent: p.onlyMainContent });
+              if (tablesMd) {
+                content = tablesMd + "\n\n" + content;
+              }
               break;
+            }
             case "html":
               content = html;
               break;
@@ -5600,6 +5659,7 @@ function parseCommandChain(input, options) {
         continue;
       }
       if (char === ";") {
+        lastOperator = "sequence";
         flushPipeline();
         continue;
       }
@@ -5654,6 +5714,7 @@ registerCommandDefinition("uncheck", ["selector"]);
 registerCommandDefinition("hover", ["selector"]);
 registerCommandDefinition("dblclick", ["selector"]);
 registerCommandDefinition("wait", ["selector"]);
+registerCommandDefinition("waitForTimeout", ["timeout"]);
 registerCommandDefinition("screenshot", []);
 registerCommandDefinition("eval", ["expression"]);
 registerCommandDefinition("scroll", ["direction"]);
@@ -7289,7 +7350,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-H55TWH2I.js");
+    const { findTargetPage } = await import("./browser-JP2LFPR2.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.`);
@@ -9817,7 +9878,17 @@ var SELECTOR_COMMANDS = /* @__PURE__ */ new Set([
   "dblclick",
   "wait"
 ]);
+var CAMEL_TO_KEBAB = {
+  getCookies: "get-cookies",
+  setCookie: "set-cookie",
+  clearCookies: "clear-cookies",
+  getLocalStorage: "get-local-storage",
+  setLocalStorage: "set-local-storage",
+  clearLocalStorage: "clear-local-storage",
+  setViewport: "set-viewport"
+};
 async function handleBrowserCommand(command, args, options, sessionName, mode, cdpEndpoint) {
+  command = CAMEL_TO_KEBAB[command] || command;
   if (args.includes("--help") || args.includes("-h") || options.help || options.h) {
     const cmdDef = getCommand(command);
     if (cmdDef) {
@@ -9947,7 +10018,7 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
           type: options.type,
           selector: options.selector || options.s,
           base64: !!options.base64,
-          output: options.output || options.o
+          output: options.output || options.o || args[0]
         };
         break;
       case "eval":
@@ -10184,6 +10255,7 @@ async function handleBrowserCommand(command, args, options, sessionName, mode, c
       outputResult(result.data, mode);
       console.error(`
   \u26A0\uFE0F  ${hint}`);
+      process.exit(1);
     } else {
       outputResult(result.data, mode);
     }
@@ -10278,11 +10350,6 @@ async function handleSession(args, options, mode, _cdpEndpoint) {
 }
 
 // src/cli/plugin-routes.ts
-var pluginLoader3 = null;
-function getPluginLoader2() {
-  if (!pluginLoader3) pluginLoader3 = new XBrowserPluginLoader();
-  return pluginLoader3;
-}
 async function buildRuntimePluginInfo() {
   const loader = await getPluginLoader();
   const sites = loader.getCore().loader.getSites();
@@ -10540,6 +10607,10 @@ async function handlePlugin(args, options, mode) {
       } else {
         result = await installer.installWithMarketplaceFallback(source, installOpts);
       }
+      try {
+        await (await getPluginLoader()).reloadPlugin(result.name);
+      } catch {
+      }
       outputResult(
         { ok: true, name: result.name, source: result.source, path: result.path },
         mode
@@ -10555,6 +10626,11 @@ async function handlePlugin(args, options, mode) {
         outputError(`Plugin "${name}" is not installed. Use 'xbrowser plugin list' to see installed plugins.`);
       }
       await installer.uninstall(name);
+      try {
+        const loader = await getPluginLoader();
+        await loader.reloadPlugin(name);
+      } catch {
+      }
       outputResult({ ok: true, name }, mode);
       break;
     }
@@ -10608,7 +10684,7 @@ Total: ${enrichedPlugins.length} plugins`);
     case "reload": {
       const name = subArgs[0];
       if (!name) outputError("Usage: xbrowser plugin reload <name>");
-      await getPluginLoader2().reloadPlugin(name);
+      (await getPluginLoader()).reloadPlugin(name);
       outputResult({ ok: true, name }, mode);
       break;
     }
@@ -12456,10 +12532,18 @@ function extractCdpFromArgv(argv) {
 async function handleStdinMode(stdinCommands, argv) {
   const chain = stdinCommands.join(" && ");
   const cdpEndpoint = argv ? extractCdpFromArgv(argv) : void 0;
-  const chainResult = await executeChain(chain, { fileMode: true, cdpEndpoint });
+  const sessionName = argv ? extractSessionNameFromArgv(argv) : "default";
+  const chainResult = await executeChain(chain, { fileMode: true, cdpEndpoint, sessionName });
   printChainResult(chainResult);
   if (!chainResult.success) throw new Error("Command failed");
 }
+function extractSessionNameFromArgv(argv) {
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === "--session" && argv[i + 1]) return argv[i + 1];
+    if (typeof argv[i] === "string" && argv[i].startsWith("--session=")) return argv[i].slice(10);
+  }
+  return process.env.XBROWSER_SESSION || "default";
+}
 async function handleEvalMode(argv) {
   const evalCommands = parseEvalFlags(argv);
   if (evalCommands.length === 0) return;
@@ -12599,6 +12683,31 @@ async function routeCommand(argvIn, stdinCommands) {
       }
       return;
     }
+    const SUBCOMMAND_HELP = {
+      session: "session open|close|kill|list [--session <name>] [--cdp <endpoint>]",
+      plugin: "plugin install|uninstall|list|reload|schema|search|info <name>",
+      record: "record start|stop|status [--url <url>] [--name <flow>]",
+      daemon: "daemon status [--port <port>]",
+      replay: "replay <file> [--slow-mo <ms>] [--stop-on-error]",
+      create: "create <name> [--template static|dynamic|login|api]",
+      run: "run <file>",
+      serve: "serve [--port <port>] [--token <token>]",
+      remote: "remote <url> [command] [--token <token>]",
+      convert: "convert <file> [--to js|py|sh]",
+      extract: "extract <file> [--format json|yaml]",
+      filter: "filter <file> [--include <type>] [--exclude <type>]",
+      test: "test <name> [--cdp <endpoint>]",
+      viewer: "viewer [--session <name>]",
+      kill: "kill [--all]",
+      net: "net [--cdp <endpoint>]"
+    };
+    const subHelp = SUBCOMMAND_HELP[command];
+    if (subHelp) {
+      console.log(`
+  Usage: xbrowser ${subHelp}
+`);
+      return;
+    }
     showMainHelp();
     return;
   }
@@ -15872,7 +15981,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-WWQBRTPF.js");
+    const { launch } = await import("./cdp-driver-S5STYUZZ.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-UHITXIOZ.js → session-replayer-IXLSCF5U.js}

@@ -31,7 +31,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-WWQBRTPF.js");
+      const { launch } = await import("./cdp-driver-S5STYUZZ.js");
       const { browser } = await launch({ cdpEndpoint: this.opts.cdpUrl });
       let contexts = browser.contexts();
       for (let i = 0; i < 10 && contexts.length === 0; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xbrowser/cli",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Browser automation CLI for web scraping, headless browsing, SEO analysis, and AI agent workflows. A command-line alternative to Playwright, Puppeteer, and Selenium.",
   "type": "module",
   "bin": {
@@ -96,7 +96,7 @@
     "sharp": "^0.34.5",
     "turndown": "^7.2.4",
     "turndown-plugin-gfm": "^1.0.2",
-    "ws": "^8.20.0",
+    "ws": "^8.21.0",
     "yaml": "^2.8.4",
     "zod": "^3.24.0"
   },