@xbrowser/cli 1.4.7 → 1.5.0

package/dist/{browser-SOML2EWR.js → browser-2FJ4OO4H.js}

@@ -20,7 +20,7 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-RGS6ECTH.js";
+} from "./chunk-H7R352A2.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-2OK26HBS.js → browser-IS6DTR5Y.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-NQSFETTQ.js";
-import "./chunk-2RHJEYWU.js";
+} from "./chunk-WCM4FNUB.js";
+import "./chunk-74QM55TC.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-KFQGP6VL.js";

package/dist/{browser-ZTTS2SVT.js → browser-ZFW2XADE.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-LYVU6SD3.js";
-import "./chunk-2RHJEYWU.js";
+} from "./chunk-MKEAO3XJ.js";
+import "./chunk-74QM55TC.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-ABXMBNQ6.js";

package/dist/{cdp-driver-67B5EI4C.js → cdp-driver-MR6OG3YF.js}

@@ -303,6 +303,18 @@ function queryAllJS(selector) {
 async function waitForActionable(page, selector, opts = {}) {
   const timeout = opts.timeout ?? 3e4;
   if (opts.force) {
+    if (selector.startsWith("xpath=")) {
+      const rect2 = await page.evaluate(`
+        (function() {
+          const el = ${queryJS(selector)};
+          if (!el) return null;
+          const r = el.getBoundingClientRect();
+          return { x: r.x, y: r.y, width: r.width, height: r.height };
+        })()
+      `);
+      if (!rect2) throw new Error(`Element not found: ${selector}`);
+      return { nodeId: 0, rect: rect2 };
+    }
     const nodeId = await page.querySelector(selector);
     if (!nodeId) throw new Error(`Element not found: ${selector}`);
     const rect = await page.getBoxModel(nodeId);
@@ -1165,17 +1177,43 @@ var XBPageImpl = class _XBPageImpl {
       headers: () => headers
     };
   }
-  async goBack(_opts = {}) {
-    const prevUrl = await this.evaluate("location.href").catch(() => "");
+  async goBack(opts = {}) {
+    try {
+      const navHistory = await this.conn.send("Page.getNavigationHistory", void 0, this.sessionId);
+      if (navHistory.currentIndex > 0) {
+        const prevUrl = navHistory.entries[navHistory.currentIndex - 1]?.url;
+        if (prevUrl && prevUrl !== "about:blank") {
+          await this.conn.send("Page.navigate", { url: prevUrl }, this.sessionId);
+          await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 1e4).catch(() => {
+          });
+          this._url = prevUrl;
+          return;
+        }
+      }
+    } catch {
+    }
     await this.evaluate("() => history.back()");
-    await this.waitForTimeout(2e3);
-    this._url = await this.evaluate("location.href").catch(() => prevUrl);
+    await this.waitForTimeout(3e3);
+    this._url = await this.evaluate("location.href").catch(() => this._url);
   }
-  async goForward(_opts = {}) {
-    const prevUrl = await this.evaluate("location.href").catch(() => "");
+  async goForward(opts = {}) {
+    try {
+      const navHistory = await this.conn.send("Page.getNavigationHistory", void 0, this.sessionId);
+      if (navHistory.currentIndex < navHistory.entries.length - 1) {
+        const nextUrl = navHistory.entries[navHistory.currentIndex + 1]?.url;
+        if (nextUrl && nextUrl !== "about:blank") {
+          await this.conn.send("Page.navigate", { url: nextUrl }, this.sessionId);
+          await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 1e4).catch(() => {
+          });
+          this._url = nextUrl;
+          return;
+        }
+      }
+    } catch {
+    }
     await this.evaluate("() => history.forward()");
-    await this.waitForTimeout(2e3);
-    this._url = await this.evaluate("location.href").catch(() => prevUrl);
+    await this.waitForTimeout(3e3);
+    this._url = await this.evaluate("location.href").catch(() => this._url);
   }
   async reload(opts = {}) {
     this._loadState = { loadFired: false, domContentFired: false, networkIdle: false };
@@ -1656,6 +1694,22 @@ Last error: ${lastError.message}` : "";
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {
+    if (selector.startsWith("xpath=")) {
+      const found = await this.evaluate(`
+        (() => { const el = ${queryJS(selector)}; return !!el; })()
+      `).catch(() => false);
+      if (!found) return 0;
+      try {
+        const search = await this.conn.send(
+          "DOM.performSearch",
+          { query: selector.slice(6) },
+          this.sessionId
+        );
+        if (search.nodeId) return search.nodeId;
+      } catch {
+      }
+      return 1;
+    }
     const doc = await this.conn.send(
       "DOM.getDocument",
       { depth: 0 },

package/dist/{cdp-driver-UGO45HXR.js → cdp-driver-QHTXQRQ2.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-2RHJEYWU.js";
+} from "./chunk-74QM55TC.js";
 import {
   connectToCDP,
   findChrome,

package/dist/{chunk-2RHJEYWU.js → chunk-74QM55TC.js}

@@ -302,6 +302,18 @@ function queryAllJS(selector) {
 async function waitForActionable(page, selector, opts = {}) {
   const timeout = opts.timeout ?? 3e4;
   if (opts.force) {
+    if (selector.startsWith("xpath=")) {
+      const rect2 = await page.evaluate(`
+        (function() {
+          const el = ${queryJS(selector)};
+          if (!el) return null;
+          const r = el.getBoundingClientRect();
+          return { x: r.x, y: r.y, width: r.width, height: r.height };
+        })()
+      `);
+      if (!rect2) throw new Error(`Element not found: ${selector}`);
+      return { nodeId: 0, rect: rect2 };
+    }
     const nodeId = await page.querySelector(selector);
     if (!nodeId) throw new Error(`Element not found: ${selector}`);
     const rect = await page.getBoxModel(nodeId);
@@ -1164,17 +1176,43 @@ var XBPageImpl = class _XBPageImpl {
       headers: () => headers
     };
   }
-  async goBack(_opts = {}) {
-    const prevUrl = await this.evaluate("location.href").catch(() => "");
+  async goBack(opts = {}) {
+    try {
+      const navHistory = await this.conn.send("Page.getNavigationHistory", void 0, this.sessionId);
+      if (navHistory.currentIndex > 0) {
+        const prevUrl = navHistory.entries[navHistory.currentIndex - 1]?.url;
+        if (prevUrl && prevUrl !== "about:blank") {
+          await this.conn.send("Page.navigate", { url: prevUrl }, this.sessionId);
+          await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 1e4).catch(() => {
+          });
+          this._url = prevUrl;
+          return;
+        }
+      }
+    } catch {
+    }
     await this.evaluate("() => history.back()");
-    await this.waitForTimeout(2e3);
-    this._url = await this.evaluate("location.href").catch(() => prevUrl);
+    await this.waitForTimeout(3e3);
+    this._url = await this.evaluate("location.href").catch(() => this._url);
   }
-  async goForward(_opts = {}) {
-    const prevUrl = await this.evaluate("location.href").catch(() => "");
+  async goForward(opts = {}) {
+    try {
+      const navHistory = await this.conn.send("Page.getNavigationHistory", void 0, this.sessionId);
+      if (navHistory.currentIndex < navHistory.entries.length - 1) {
+        const nextUrl = navHistory.entries[navHistory.currentIndex + 1]?.url;
+        if (nextUrl && nextUrl !== "about:blank") {
+          await this.conn.send("Page.navigate", { url: nextUrl }, this.sessionId);
+          await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 1e4).catch(() => {
+          });
+          this._url = nextUrl;
+          return;
+        }
+      }
+    } catch {
+    }
     await this.evaluate("() => history.forward()");
-    await this.waitForTimeout(2e3);
-    this._url = await this.evaluate("location.href").catch(() => prevUrl);
+    await this.waitForTimeout(3e3);
+    this._url = await this.evaluate("location.href").catch(() => this._url);
   }
   async reload(opts = {}) {
     this._loadState = { loadFired: false, domContentFired: false, networkIdle: false };
@@ -1655,6 +1693,22 @@ Last error: ${lastError.message}` : "";
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {
+    if (selector.startsWith("xpath=")) {
+      const found = await this.evaluate(`
+        (() => { const el = ${queryJS(selector)}; return !!el; })()
+      `).catch(() => false);
+      if (!found) return 0;
+      try {
+        const search = await this.conn.send(
+          "DOM.performSearch",
+          { query: selector.slice(6) },
+          this.sessionId
+        );
+        if (search.nodeId) return search.nodeId;
+      } catch {
+      }
+      return 1;
+    }
     const doc = await this.conn.send(
       "DOM.getDocument",
       { depth: 0 },

package/dist/{chunk-RGS6ECTH.js → chunk-H7R352A2.js}

@@ -308,6 +308,18 @@ function queryAllJS(selector) {
 async function waitForActionable(page, selector, opts = {}) {
   const timeout = opts.timeout ?? 3e4;
   if (opts.force) {
+    if (selector.startsWith("xpath=")) {
+      const rect2 = await page.evaluate(`
+        (function() {
+          const el = ${queryJS(selector)};
+          if (!el) return null;
+          const r = el.getBoundingClientRect();
+          return { x: r.x, y: r.y, width: r.width, height: r.height };
+        })()
+      `);
+      if (!rect2) throw new Error(`Element not found: ${selector}`);
+      return { nodeId: 0, rect: rect2 };
+    }
     const nodeId = await page.querySelector(selector);
     if (!nodeId) throw new Error(`Element not found: ${selector}`);
     const rect = await page.getBoxModel(nodeId);
@@ -1170,17 +1182,43 @@ var XBPageImpl = class _XBPageImpl {
       headers: () => headers
     };
   }
-  async goBack(_opts = {}) {
-    const prevUrl = await this.evaluate("location.href").catch(() => "");
+  async goBack(opts = {}) {
+    try {
+      const navHistory = await this.conn.send("Page.getNavigationHistory", void 0, this.sessionId);
+      if (navHistory.currentIndex > 0) {
+        const prevUrl = navHistory.entries[navHistory.currentIndex - 1]?.url;
+        if (prevUrl && prevUrl !== "about:blank") {
+          await this.conn.send("Page.navigate", { url: prevUrl }, this.sessionId);
+          await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 1e4).catch(() => {
+          });
+          this._url = prevUrl;
+          return;
+        }
+      }
+    } catch {
+    }
     await this.evaluate("() => history.back()");
-    await this.waitForTimeout(2e3);
-    this._url = await this.evaluate("location.href").catch(() => prevUrl);
+    await this.waitForTimeout(3e3);
+    this._url = await this.evaluate("location.href").catch(() => this._url);
   }
-  async goForward(_opts = {}) {
-    const prevUrl = await this.evaluate("location.href").catch(() => "");
+  async goForward(opts = {}) {
+    try {
+      const navHistory = await this.conn.send("Page.getNavigationHistory", void 0, this.sessionId);
+      if (navHistory.currentIndex < navHistory.entries.length - 1) {
+        const nextUrl = navHistory.entries[navHistory.currentIndex + 1]?.url;
+        if (nextUrl && nextUrl !== "about:blank") {
+          await this.conn.send("Page.navigate", { url: nextUrl }, this.sessionId);
+          await this.waitForLoadState(opts.waitUntil ?? "domcontentloaded", opts.timeout ?? 1e4).catch(() => {
+          });
+          this._url = nextUrl;
+          return;
+        }
+      }
+    } catch {
+    }
     await this.evaluate("() => history.forward()");
-    await this.waitForTimeout(2e3);
-    this._url = await this.evaluate("location.href").catch(() => prevUrl);
+    await this.waitForTimeout(3e3);
+    this._url = await this.evaluate("location.href").catch(() => this._url);
   }
   async reload(opts = {}) {
     this._loadState = { loadFired: false, domContentFired: false, networkIdle: false };
@@ -1661,6 +1699,22 @@ Last error: ${lastError.message}` : "";
   // ── CDP helpers exposed for locator/element ─────────────────
   /** Query a single element, returns CDP nodeId or 0 if not found */
   async querySelector(selector) {
+    if (selector.startsWith("xpath=")) {
+      const found = await this.evaluate(`
+        (() => { const el = ${queryJS(selector)}; return !!el; })()
+      `).catch(() => false);
+      if (!found) return 0;
+      try {
+        const search = await this.conn.send(
+          "DOM.performSearch",
+          { query: selector.slice(6) },
+          this.sessionId
+        );
+        if (search.nodeId) return search.nodeId;
+      } catch {
+      }
+      return 1;
+    }
     const doc = await this.conn.send(
       "DOM.getDocument",
       { depth: 0 },

package/dist/{chunk-LYVU6SD3.js → chunk-MKEAO3XJ.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-2RHJEYWU.js";
+} from "./chunk-74QM55TC.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/{chunk-NQSFETTQ.js → chunk-WCM4FNUB.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-2RHJEYWU.js";
+} from "./chunk-74QM55TC.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";

package/dist/cli.js

@@ -25,7 +25,7 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-RGS6ECTH.js";
+} from "./chunk-H7R352A2.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   forwardCommandLog,
@@ -1208,9 +1208,9 @@ var setViewportCommand = registerCommand({
   description: "Set the viewport size and properties",
   scope: "browser",
   parameters: z11.object({
-    width: z11.number(),
-    height: z11.number(),
-    deviceScaleFactor: z11.number().optional(),
+    width: z11.coerce.number(),
+    height: z11.coerce.number(),
+    deviceScaleFactor: z11.coerce.number().optional(),
     isMobile: z11.boolean().optional(),
     hasTouch: z11.boolean().optional()
   }),
@@ -7083,7 +7083,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-SOML2EWR.js");
+    const { findTargetPage } = await import("./browser-2FJ4OO4H.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.`);
@@ -11744,8 +11744,13 @@ Commands:
   session close [--session <name>]  Close session
   session list                      List sessions
   session kill [--session <name>]   Kill session
+
   goto <url>                        Navigate to URL
   open <url>                        Navigate to URL (alias for goto)
+  back                              Go back in history
+  forward                           Go forward in history
+  refresh                           Reload page
+
   click <selector>                  Click element (-s <sel>)
   fill <selector> <value>           Fill input (-s <sel> -v <val>)
   type <selector> <text>            Type text (-s <sel> -v <text>)
@@ -11755,21 +11760,61 @@ Commands:
   dblclick <selector>               Double click (-s <sel>)
   check <selector>                  Check checkbox (-s <sel>)
   uncheck <selector>                Uncheck checkbox (-s <sel>)
-  screenshot [--full-page] [--base64]  Take screenshot (saves to ~/.xbrowser/screenshots/; use --base64 for inline data)
+  mouse <action> <x> <y>            Mouse move/click at coordinates
+  scroll <direction> [--distance N] Scroll page
+
+  screenshot [--full-page] [--base64]  Take screenshot
   eval <expression>                 Evaluate JS
   wait <selector> [--timeout <ms>]  Wait for element (-s <sel>)
-  scroll <direction> [--distance N] Scroll page
+  waitForTimeout <ms>               Wait for milliseconds
+  waitFor --text <t>                Wait for text/url/selector predicate
   title                             Get page title
   url                               Get current URL
   html [--selector <sel>]           Get HTML content
   text [--selector <sel>]           Get text content
+  find <strategy> <value> [--action click|fill|hover]  Find element by text/role/label
+
+  set-viewport <width> <height>     Set viewport size
+  frames                            List all frames
+  frame --index <n>                 Switch to frame
+  tab list                          List browser tabs
+  tab new <url>                     Open new tab
+  tab close --index <n>             Close tab
+  tab switch --index <n>            Switch to tab
+
+  get-cookies                       Get all cookies
+  set-cookie <name> <value>         Set cookie
+  clear-cookies                     Clear cookies
+  get-local-storage                 Get localStorage
+  set-local-storage <key> <value>   Set localStorage item
+  clear-local-storage               Clear localStorage
+
+  snapshot                          Get page snapshot with element refs
+  observe                           AI agent: observe page state
+  act                               AI agent: perform action
+  actions <url> --action "..."      Execute action sequence
+
+  console                           Get console messages
+  net-debug                         Get network debug info
+  perf                              Get performance metrics
+  health                            Run page health check (SEO/links/errors)
+  structure                         Get page DOM structure
+  network <url>                     Capture network traffic
+  addinitscript <script>            Add init script
+
+  scrape <url>                      Scrape page to markdown
+  crawl <url>                       Crawl website (multi-page)
+  search "query"                    Search the web (--engine, --limit, --full)
+  map <url>                         Discover all URLs on a website
+
   convert <rec.yaml> <out.{js,py,sh}> Convert recording to script
   extract <rec.yaml>                Extract LLM-ready summary
   filter <in.yaml> <out.yaml>       Filter recording events
-  scrape <url>                      Scrape a page and convert to markdown
-   crawl <url>                       Crawl a website and extract content from multiple pages
-   search "query"                    Search the web and extract results (--engine, --limit, --full)
-   map <url>                         Discover all URLs on a website
+  replay <file>                     Replay recording
+  record start --url <url>          Start recording
+  record stop                       Stop recording
+  record status                     Recording status
+
   config <get|set|list>             Manage config
   plugin search <query>             Search for plugins
   plugin install <source>           Install plugin
@@ -11777,16 +11822,12 @@ Commands:
   plugin list                       List plugins
   plugin reload <name>              Reload plugin
   create <name> --template <type>   Create plugin
-  serve [--port <port>] [--token <t>] Start HTTP server for remote access
-  remote <url> [command] [--token <t>] Execute command on remote server
-  record start --url <url>          Start recording
-  record stop                       Stop recording
-  record status                     Recording status
-  replay <file>                     Replay recording
+  serve [--port <port>] [--token <t>] Start HTTP server
+  remote <url> [command] [--token <t>] Execute on remote server
   run <file>                        Execute commands from file
-  viewer [--name <n>] [--selector <sel>] Generate viewer URL
+  viewer [--name <n>]               Generate viewer URL
   help                              Show this help
-  --version, -v                     Show version
+  --version                         Show version
 Plugin Commands:
   Installed plugins provide additional commands.
   Use 'xbrowser plugin list' to see installed plugins and their commands.
@@ -11832,7 +11873,7 @@ Global Flags:
   --session <name>                  Use specific session
   --cdp <endpoint>                  Connect via CDP (url, port, or 'auto')
   --help, -h                        Show help
-  `);
+`);
 }
 
 // src/cli/chain-output.ts
@@ -13059,7 +13100,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-SOML2EWR.js");
+      const { ensureProcessCanExit } = await import("./browser-2FJ4OO4H.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(exitCode);

package/dist/daemon-main.js

@@ -21,8 +21,8 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-NQSFETTQ.js";
-import "./chunk-2RHJEYWU.js";
+} from "./chunk-WCM4FNUB.js";
+import "./chunk-74QM55TC.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   getPluginLoader
@@ -1169,9 +1169,9 @@ var setViewportCommand = registerCommand({
   description: "Set the viewport size and properties",
   scope: "browser",
   parameters: z11.object({
-    width: z11.number(),
-    height: z11.number(),
-    deviceScaleFactor: z11.number().optional(),
+    width: z11.coerce.number(),
+    height: z11.coerce.number(),
+    deviceScaleFactor: z11.coerce.number().optional(),
     isMobile: z11.boolean().optional(),
     hasTouch: z11.boolean().optional()
   }),
@@ -6614,7 +6614,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-2OK26HBS.js");
+    const { findTargetPage } = await import("./browser-IS6DTR5Y.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.`);
@@ -8330,7 +8330,7 @@ function createRPCHandler() {
     const isNewFormat = Array.isArray(parsed.actions);
     if (isNewFormat) {
       try {
-        const { SessionReplayer } = await import("./session-replayer-YIGRIIDD.js");
+        const { SessionReplayer } = await import("./session-replayer-SD2MWGP5.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-LYVU6SD3.js";
-import "./chunk-2RHJEYWU.js";
+} from "./chunk-MKEAO3XJ.js";
+import "./chunk-74QM55TC.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -1248,9 +1248,9 @@ var setViewportCommand = registerCommand({
   description: "Set the viewport size and properties",
   scope: "browser",
   parameters: z11.object({
-    width: z11.number(),
-    height: z11.number(),
-    deviceScaleFactor: z11.number().optional(),
+    width: z11.coerce.number(),
+    height: z11.coerce.number(),
+    deviceScaleFactor: z11.coerce.number().optional(),
     isMobile: z11.boolean().optional(),
     hasTouch: z11.boolean().optional()
   }),
@@ -7403,7 +7403,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-ZTTS2SVT.js");
+    const { findTargetPage } = await import("./browser-ZFW2XADE.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.`);
@@ -12084,8 +12084,13 @@ Commands:
   session close [--session <name>]  Close session
   session list                      List sessions
   session kill [--session <name>]   Kill session
+
   goto <url>                        Navigate to URL
   open <url>                        Navigate to URL (alias for goto)
+  back                              Go back in history
+  forward                           Go forward in history
+  refresh                           Reload page
+
   click <selector>                  Click element (-s <sel>)
   fill <selector> <value>           Fill input (-s <sel> -v <val>)
   type <selector> <text>            Type text (-s <sel> -v <text>)
@@ -12095,21 +12100,61 @@ Commands:
   dblclick <selector>               Double click (-s <sel>)
   check <selector>                  Check checkbox (-s <sel>)
   uncheck <selector>                Uncheck checkbox (-s <sel>)
-  screenshot [--full-page] [--base64]  Take screenshot (saves to ~/.xbrowser/screenshots/; use --base64 for inline data)
+  mouse <action> <x> <y>            Mouse move/click at coordinates
+  scroll <direction> [--distance N] Scroll page
+
+  screenshot [--full-page] [--base64]  Take screenshot
   eval <expression>                 Evaluate JS
   wait <selector> [--timeout <ms>]  Wait for element (-s <sel>)
-  scroll <direction> [--distance N] Scroll page
+  waitForTimeout <ms>               Wait for milliseconds
+  waitFor --text <t>                Wait for text/url/selector predicate
   title                             Get page title
   url                               Get current URL
   html [--selector <sel>]           Get HTML content
   text [--selector <sel>]           Get text content
+  find <strategy> <value> [--action click|fill|hover]  Find element by text/role/label
+
+  set-viewport <width> <height>     Set viewport size
+  frames                            List all frames
+  frame --index <n>                 Switch to frame
+  tab list                          List browser tabs
+  tab new <url>                     Open new tab
+  tab close --index <n>             Close tab
+  tab switch --index <n>            Switch to tab
+
+  get-cookies                       Get all cookies
+  set-cookie <name> <value>         Set cookie
+  clear-cookies                     Clear cookies
+  get-local-storage                 Get localStorage
+  set-local-storage <key> <value>   Set localStorage item
+  clear-local-storage               Clear localStorage
+
+  snapshot                          Get page snapshot with element refs
+  observe                           AI agent: observe page state
+  act                               AI agent: perform action
+  actions <url> --action "..."      Execute action sequence
+
+  console                           Get console messages
+  net-debug                         Get network debug info
+  perf                              Get performance metrics
+  health                            Run page health check (SEO/links/errors)
+  structure                         Get page DOM structure
+  network <url>                     Capture network traffic
+  addinitscript <script>            Add init script
+
+  scrape <url>                      Scrape page to markdown
+  crawl <url>                       Crawl website (multi-page)
+  search "query"                    Search the web (--engine, --limit, --full)
+  map <url>                         Discover all URLs on a website
+
   convert <rec.yaml> <out.{js,py,sh}> Convert recording to script
   extract <rec.yaml>                Extract LLM-ready summary
   filter <in.yaml> <out.yaml>       Filter recording events
-  scrape <url>                      Scrape a page and convert to markdown
-   crawl <url>                       Crawl a website and extract content from multiple pages
-   search "query"                    Search the web and extract results (--engine, --limit, --full)
-   map <url>                         Discover all URLs on a website
+  replay <file>                     Replay recording
+  record start --url <url>          Start recording
+  record stop                       Stop recording
+  record status                     Recording status
+
   config <get|set|list>             Manage config
   plugin search <query>             Search for plugins
   plugin install <source>           Install plugin
@@ -12117,16 +12162,12 @@ Commands:
   plugin list                       List plugins
   plugin reload <name>              Reload plugin
   create <name> --template <type>   Create plugin
-  serve [--port <port>] [--token <t>] Start HTTP server for remote access
-  remote <url> [command] [--token <t>] Execute command on remote server
-  record start --url <url>          Start recording
-  record stop                       Stop recording
-  record status                     Recording status
-  replay <file>                     Replay recording
+  serve [--port <port>] [--token <t>] Start HTTP server
+  remote <url> [command] [--token <t>] Execute on remote server
   run <file>                        Execute commands from file
-  viewer [--name <n>] [--selector <sel>] Generate viewer URL
+  viewer [--name <n>]               Generate viewer URL
   help                              Show this help
-  --version, -v                     Show version
+  --version                         Show version
 Plugin Commands:
   Installed plugins provide additional commands.
   Use 'xbrowser plugin list' to see installed plugins and their commands.
@@ -12172,7 +12213,7 @@ Global Flags:
   --session <name>                  Use specific session
   --cdp <endpoint>                  Connect via CDP (url, port, or 'auto')
   --help, -h                        Show help
-  `);
+`);
 }
 
 // src/cli/chain-output.ts
@@ -16186,7 +16227,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-UGO45HXR.js");
+    const { launch } = await import("./cdp-driver-QHTXQRQ2.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-YIGRIIDD.js → session-replayer-SD2MWGP5.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-UGO45HXR.js");
+      const { launch } = await import("./cdp-driver-QHTXQRQ2.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.4.7",
+  "version": "1.5.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": {