@xbrowser/cli 1.15.0 → 1.17.0

package/dist/{browser-4FKHBUBJ.js → browser-GPRLH6P6.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-K5E4CWRV.js";
-import "./chunk-NTTFKS6T.js";
+} from "./chunk-CE3L6HYV.js";
+import "./chunk-3KUJOXUE.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";
 import "./chunk-A6LPGFAL.js";

package/dist/{browser-JNT2I73V.js → browser-HY7UXUQV.js}

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

package/dist/{browser-YYMKZWTU.js → browser-ZVNDI4TR.js}

@@ -20,8 +20,8 @@ import {
   saveSessionDiskMeta,
   setActivePage,
   touchSession
-} from "./chunk-XQ4KOZ37.js";
-import "./chunk-UXDGEDT7.js";
+} from "./chunk-UQUJVBXE.js";
+import "./chunk-W4JETHAD.js";
 import "./chunk-3FWLW7FS.js";
 import "./chunk-TNEN6VQ2.js";
 import "./chunk-GDKLH7ZY.js";

package/dist/{cdp-driver-7RW4NY2X.js → cdp-driver-FIAUJTBZ.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-UXDGEDT7.js";
+} from "./chunk-W4JETHAD.js";
 import "./chunk-3FWLW7FS.js";
 import {
   connectToCDP,

package/dist/{cdp-driver-QX72T7SU.js → cdp-driver-GMDP4KDN.js}

@@ -14,7 +14,7 @@ import {
   scrollIntoView,
   waitForActionable,
   waitForNetworkIdle
-} from "./chunk-NTTFKS6T.js";
+} from "./chunk-3KUJOXUE.js";
 import {
   connectToCDP,
   findChrome,

package/dist/{cdp-driver-FTGIYCFO.js → cdp-driver-TPVLBEFT.js}

@@ -515,6 +515,49 @@ var XBMouseImpl = class {
     this._x = x;
     this._y = y;
   }
+  /**
+   * Drag from the CURRENT cursor position to (x, y): press, traverse a
+   * bezier trajectory with the button held, release. Drives the REAL
+   * HTML5 DnD pipeline — field-verified (d59): this sequence fires
+   * dragstart → dragover… → drop → dragend, all isTrusted=true. No
+   * Input.dispatchDragEvent needed.
+   */
+  async drag(x, y, opts = {}) {
+    const stealth = process.env.XBROWSER_STEALTH !== "off";
+    await this.send("Input.dispatchMouseEvent", {
+      type: "mousePressed",
+      x: this._x,
+      y: this._y,
+      button: "left",
+      clickCount: 1
+    });
+    this._button = "left";
+    const steps = opts.steps ?? Math.max(10, Math.min(24, Math.round(Math.hypot(x - this._x, y - this._y) / 20)));
+    const fx = this._x, fy = this._y;
+    for (let i = 1; i <= steps; i++) {
+      if (stealth) await sleep(rand(16, 28));
+      const t = i / steps;
+      this._x = fx + (x - fx) * t;
+      this._y = fy + (y - fy) * t;
+      await this.send("Input.dispatchMouseEvent", {
+        type: "mouseMoved",
+        x: this._x,
+        y: this._y,
+        button: this._button
+      });
+    }
+    this._x = x;
+    this._y = y;
+    await sleep(rand(60, 140));
+    await this.send("Input.dispatchMouseEvent", {
+      type: "mouseReleased",
+      x,
+      y,
+      button: "left",
+      clickCount: 1
+    });
+    this._button = "none";
+  }
   async wheel(deltaX, deltaY) {
     await this.send("Input.dispatchMouseEvent", {
       type: "mouseWheel",
@@ -701,6 +744,26 @@ var XBKeyboardImpl = class {
       ...mapping.keyCode ? { windowsVirtualKeyCode: mapping.keyCode } : {}
     });
   }
+  /**
+   * Shortcut combo press (modifier+key) with explicit per-event modifiers
+   * bitmask — plain down(mod)+press(key) inserts the raw character because
+   * CDP modifiers are per-event fields, not session state (d56: Meta,v
+   * typed a literal 'v'). keyDown type carries the default action so the
+   * browser's shortcut dispatcher sees the combo (e.g. native paste).
+   */
+  async pressCombo(key, modifier) {
+    const MODBIT = { Alt: 1, Control: 2, Meta: 4, Shift: 8 };
+    const m = resolveKeyMapping(modifier);
+    const k = resolveKeyMapping(key);
+    const bits = MODBIT[modifier] ?? 0;
+    await this.dispatchKeyEvent({ type: "rawKeyDown", key: m.key, code: m.code, ...m.keyCode ? { windowsVirtualKeyCode: m.keyCode } : {}, modifiers: bits });
+    await this.dispatchKeyEvent({ type: "keyDown", key: k.key, code: k.code, ...k.keyCode ? { windowsVirtualKeyCode: k.keyCode } : {}, modifiers: bits });
+    if (process.env.XBROWSER_STEALTH !== "off") {
+      await sleep2(rand(...DEFAULT_STEALTH_CONFIG.keyPressDuration));
+    }
+    await this.dispatchKeyEvent({ type: "keyUp", key: k.key, code: k.code, ...k.keyCode ? { windowsVirtualKeyCode: k.keyCode } : {}, modifiers: bits });
+    await this.dispatchKeyEvent({ type: "keyUp", key: m.key, code: m.code, ...m.keyCode ? { windowsVirtualKeyCode: m.keyCode } : {}, modifiers: 0 });
+  }
   async dispatchKeyEvent(params) {
     await this.conn.send("Input.dispatchKeyEvent", params, this.sessionId);
   }
@@ -1084,6 +1147,18 @@ var XBLocatorImpl = class _XBLocatorImpl {
     await waitForActionable(this.page, this.selector, opts);
     await scrollIntoView(this.page, this.selector);
     await this.click({ ...opts });
+    if (process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type") {
+      try {
+        const { pasteViaClipboard, syntheticPaste } = await import("./clipboard-XRP54ENE.js");
+        await pasteViaClipboard(this.page, value);
+        const got = await this.page.evaluate(
+          `(function(){ const el = ${this._q(this.selector)}; return el ? (el.value || '') : ''; })()`
+        );
+        if (got === value) return;
+        if (await syntheticPaste(this.page, this._q(this.selector), value)) return;
+      } catch {
+      }
+    }
     await this.page.keyboard.type(value, { stealth: true });
     return;
     await this.page.evaluate(`
@@ -1223,6 +1298,21 @@ var XBLocatorImpl = class _XBLocatorImpl {
     `);
     return selected;
   }
+  async dragAndDrop(source, target) {
+    const boxes = await this.page.evaluate(`
+      (function() {
+        const s = ${this._q(source)}, t = ${this._q(target)};
+        if (!s || !t) return null;
+        const c = (el) => { const r = el.getBoundingClientRect(); return { x: r.x + r.width / 2, y: r.y + r.height / 2 }; };
+        return [c(s), c(t)];
+      })()
+    `);
+    if (!boxes || !boxes[0] || !boxes[1]) {
+      throw new Error(`dragAndDrop: element not found (${source} / ${target})`);
+    }
+    await this.page.mouse.move(boxes[0].x, boxes[0].y);
+    await this.page.mouse.drag(boxes[1].x, boxes[1].y);
+  }
   async screenshot(opts = {}) {
     await waitForActionable(this.page, this.selector);
     const box = await this.page.evaluate(`

package/dist/{chunk-NTTFKS6T.js → chunk-3KUJOXUE.js}

@@ -525,6 +525,49 @@ var XBMouseImpl = class {
     this._x = x;
     this._y = y;
   }
+  /**
+   * Drag from the CURRENT cursor position to (x, y): press, traverse a
+   * bezier trajectory with the button held, release. Drives the REAL
+   * HTML5 DnD pipeline — field-verified (d59): this sequence fires
+   * dragstart → dragover… → drop → dragend, all isTrusted=true. No
+   * Input.dispatchDragEvent needed.
+   */
+  async drag(x, y, opts = {}) {
+    const stealth = process.env.XBROWSER_STEALTH !== "off";
+    await this.send("Input.dispatchMouseEvent", {
+      type: "mousePressed",
+      x: this._x,
+      y: this._y,
+      button: "left",
+      clickCount: 1
+    });
+    this._button = "left";
+    const steps = opts.steps ?? Math.max(10, Math.min(24, Math.round(Math.hypot(x - this._x, y - this._y) / 20)));
+    const fx = this._x, fy = this._y;
+    for (let i = 1; i <= steps; i++) {
+      if (stealth) await sleep2(rand(16, 28));
+      const t = i / steps;
+      this._x = fx + (x - fx) * t;
+      this._y = fy + (y - fy) * t;
+      await this.send("Input.dispatchMouseEvent", {
+        type: "mouseMoved",
+        x: this._x,
+        y: this._y,
+        button: this._button
+      });
+    }
+    this._x = x;
+    this._y = y;
+    await sleep2(rand(60, 140));
+    await this.send("Input.dispatchMouseEvent", {
+      type: "mouseReleased",
+      x,
+      y,
+      button: "left",
+      clickCount: 1
+    });
+    this._button = "none";
+  }
   async wheel(deltaX, deltaY) {
     await this.send("Input.dispatchMouseEvent", {
       type: "mouseWheel",
@@ -711,6 +754,26 @@ var XBKeyboardImpl = class {
       ...mapping.keyCode ? { windowsVirtualKeyCode: mapping.keyCode } : {}
     });
   }
+  /**
+   * Shortcut combo press (modifier+key) with explicit per-event modifiers
+   * bitmask — plain down(mod)+press(key) inserts the raw character because
+   * CDP modifiers are per-event fields, not session state (d56: Meta,v
+   * typed a literal 'v'). keyDown type carries the default action so the
+   * browser's shortcut dispatcher sees the combo (e.g. native paste).
+   */
+  async pressCombo(key, modifier) {
+    const MODBIT = { Alt: 1, Control: 2, Meta: 4, Shift: 8 };
+    const m = resolveKeyMapping(modifier);
+    const k = resolveKeyMapping(key);
+    const bits = MODBIT[modifier] ?? 0;
+    await this.dispatchKeyEvent({ type: "rawKeyDown", key: m.key, code: m.code, ...m.keyCode ? { windowsVirtualKeyCode: m.keyCode } : {}, modifiers: bits });
+    await this.dispatchKeyEvent({ type: "keyDown", key: k.key, code: k.code, ...k.keyCode ? { windowsVirtualKeyCode: k.keyCode } : {}, modifiers: bits });
+    if (process.env.XBROWSER_STEALTH !== "off") {
+      await sleep3(rand(...DEFAULT_STEALTH_CONFIG.keyPressDuration));
+    }
+    await this.dispatchKeyEvent({ type: "keyUp", key: k.key, code: k.code, ...k.keyCode ? { windowsVirtualKeyCode: k.keyCode } : {}, modifiers: bits });
+    await this.dispatchKeyEvent({ type: "keyUp", key: m.key, code: m.code, ...m.keyCode ? { windowsVirtualKeyCode: m.keyCode } : {}, modifiers: 0 });
+  }
   async dispatchKeyEvent(params) {
     await this.conn.send("Input.dispatchKeyEvent", params, this.sessionId);
   }
@@ -1094,6 +1157,18 @@ var XBLocatorImpl = class _XBLocatorImpl {
     await waitForActionable(this.page, this.selector, opts);
     await scrollIntoView(this.page, this.selector);
     await this.click({ ...opts });
+    if (process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type") {
+      try {
+        const { pasteViaClipboard, syntheticPaste } = await import("./clipboard-BOL2GP2E.js");
+        await pasteViaClipboard(this.page, value);
+        const got = await this.page.evaluate(
+          `(function(){ const el = ${this._q(this.selector)}; return el ? (el.value || '') : ''; })()`
+        );
+        if (got === value) return;
+        if (await syntheticPaste(this.page, this._q(this.selector), value)) return;
+      } catch {
+      }
+    }
     await this.page.keyboard.type(value, { stealth: true });
     return;
     await this.page.evaluate(`
@@ -1233,6 +1308,21 @@ var XBLocatorImpl = class _XBLocatorImpl {
     `);
     return selected;
   }
+  async dragAndDrop(source, target) {
+    const boxes = await this.page.evaluate(`
+      (function() {
+        const s = ${this._q(source)}, t = ${this._q(target)};
+        if (!s || !t) return null;
+        const c = (el) => { const r = el.getBoundingClientRect(); return { x: r.x + r.width / 2, y: r.y + r.height / 2 }; };
+        return [c(s), c(t)];
+      })()
+    `);
+    if (!boxes || !boxes[0] || !boxes[1]) {
+      throw new Error(`dragAndDrop: element not found (${source} / ${target})`);
+    }
+    await this.page.mouse.move(boxes[0].x, boxes[0].y);
+    await this.page.mouse.drag(boxes[1].x, boxes[1].y);
+  }
   async screenshot(opts = {}) {
     await waitForActionable(this.page, this.selector);
     const box = await this.page.evaluate(`

package/dist/{chunk-HFP4QCZL.js → chunk-3LVR44KG.js}

@@ -528,6 +528,49 @@ var XBMouseImpl = class {
     this._x = x;
     this._y = y;
   }
+  /**
+   * Drag from the CURRENT cursor position to (x, y): press, traverse a
+   * bezier trajectory with the button held, release. Drives the REAL
+   * HTML5 DnD pipeline — field-verified (d59): this sequence fires
+   * dragstart → dragover… → drop → dragend, all isTrusted=true. No
+   * Input.dispatchDragEvent needed.
+   */
+  async drag(x, y, opts = {}) {
+    const stealth = process.env.XBROWSER_STEALTH !== "off";
+    await this.send("Input.dispatchMouseEvent", {
+      type: "mousePressed",
+      x: this._x,
+      y: this._y,
+      button: "left",
+      clickCount: 1
+    });
+    this._button = "left";
+    const steps = opts.steps ?? Math.max(10, Math.min(24, Math.round(Math.hypot(x - this._x, y - this._y) / 20)));
+    const fx = this._x, fy = this._y;
+    for (let i = 1; i <= steps; i++) {
+      if (stealth) await sleep2(rand(16, 28));
+      const t = i / steps;
+      this._x = fx + (x - fx) * t;
+      this._y = fy + (y - fy) * t;
+      await this.send("Input.dispatchMouseEvent", {
+        type: "mouseMoved",
+        x: this._x,
+        y: this._y,
+        button: this._button
+      });
+    }
+    this._x = x;
+    this._y = y;
+    await sleep2(rand(60, 140));
+    await this.send("Input.dispatchMouseEvent", {
+      type: "mouseReleased",
+      x,
+      y,
+      button: "left",
+      clickCount: 1
+    });
+    this._button = "none";
+  }
   async wheel(deltaX, deltaY) {
     await this.send("Input.dispatchMouseEvent", {
       type: "mouseWheel",
@@ -714,6 +757,26 @@ var XBKeyboardImpl = class {
       ...mapping.keyCode ? { windowsVirtualKeyCode: mapping.keyCode } : {}
     });
   }
+  /**
+   * Shortcut combo press (modifier+key) with explicit per-event modifiers
+   * bitmask — plain down(mod)+press(key) inserts the raw character because
+   * CDP modifiers are per-event fields, not session state (d56: Meta,v
+   * typed a literal 'v'). keyDown type carries the default action so the
+   * browser's shortcut dispatcher sees the combo (e.g. native paste).
+   */
+  async pressCombo(key, modifier) {
+    const MODBIT = { Alt: 1, Control: 2, Meta: 4, Shift: 8 };
+    const m = resolveKeyMapping(modifier);
+    const k = resolveKeyMapping(key);
+    const bits = MODBIT[modifier] ?? 0;
+    await this.dispatchKeyEvent({ type: "rawKeyDown", key: m.key, code: m.code, ...m.keyCode ? { windowsVirtualKeyCode: m.keyCode } : {}, modifiers: bits });
+    await this.dispatchKeyEvent({ type: "keyDown", key: k.key, code: k.code, ...k.keyCode ? { windowsVirtualKeyCode: k.keyCode } : {}, modifiers: bits });
+    if (process.env.XBROWSER_STEALTH !== "off") {
+      await sleep3(rand(...DEFAULT_STEALTH_CONFIG.keyPressDuration));
+    }
+    await this.dispatchKeyEvent({ type: "keyUp", key: k.key, code: k.code, ...k.keyCode ? { windowsVirtualKeyCode: k.keyCode } : {}, modifiers: bits });
+    await this.dispatchKeyEvent({ type: "keyUp", key: m.key, code: m.code, ...m.keyCode ? { windowsVirtualKeyCode: m.keyCode } : {}, modifiers: 0 });
+  }
   async dispatchKeyEvent(params) {
     await this.conn.send("Input.dispatchKeyEvent", params, this.sessionId);
   }
@@ -1097,6 +1160,18 @@ var XBLocatorImpl = class _XBLocatorImpl {
     await waitForActionable(this.page, this.selector, opts);
     await scrollIntoView(this.page, this.selector);
     await this.click({ ...opts });
+    if (process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type") {
+      try {
+        const { pasteViaClipboard, syntheticPaste } = await import("./clipboard-BOL2GP2E.js");
+        await pasteViaClipboard(this.page, value);
+        const got = await this.page.evaluate(
+          `(function(){ const el = ${this._q(this.selector)}; return el ? (el.value || '') : ''; })()`
+        );
+        if (got === value) return;
+        if (await syntheticPaste(this.page, this._q(this.selector), value)) return;
+      } catch {
+      }
+    }
     await this.page.keyboard.type(value, { stealth: true });
     return;
     await this.page.evaluate(`
@@ -1236,6 +1311,21 @@ var XBLocatorImpl = class _XBLocatorImpl {
     `);
     return selected;
   }
+  async dragAndDrop(source, target) {
+    const boxes = await this.page.evaluate(`
+      (function() {
+        const s = ${this._q(source)}, t = ${this._q(target)};
+        if (!s || !t) return null;
+        const c = (el) => { const r = el.getBoundingClientRect(); return { x: r.x + r.width / 2, y: r.y + r.height / 2 }; };
+        return [c(s), c(t)];
+      })()
+    `);
+    if (!boxes || !boxes[0] || !boxes[1]) {
+      throw new Error(`dragAndDrop: element not found (${source} / ${target})`);
+    }
+    await this.page.mouse.move(boxes[0].x, boxes[0].y);
+    await this.page.mouse.drag(boxes[1].x, boxes[1].y);
+  }
   async screenshot(opts = {}) {
     await waitForActionable(this.page, this.selector);
     const box = await this.page.evaluate(`
@@ -5363,16 +5453,14 @@ process.on("exit", () => {
 async function getCDPTargets2(cdpEndpoint) {
   try {
     const ep = String(cdpEndpoint);
-    let host = "localhost";
-    let port = "9222";
+    let url = "http://localhost:9222/json/list";
     if (ep.startsWith("http://") || ep.startsWith("https://")) {
       const u = new URL(ep);
-      host = u.hostname;
-      port = u.port || "9222";
+      u.pathname = (u.pathname.replace(/\/+$/, "") || "") + "/json/list";
+      url = u.toString();
     } else if (/^\d+$/.test(ep)) {
-      port = ep;
+      url = `http://localhost:${ep}/json/list`;
     }
-    const url = `http://${host}:${port}/json/list`;
     const resp = await fetch(url);
     return await resp.json();
   } catch {
@@ -5843,20 +5931,48 @@ async function createSession(name, url, options) {
         (t) => t.url && t.url !== "about:blank" && !t.url.startsWith("chrome://") && !t.url.startsWith("chrome-untrusted://") && !t.url.startsWith("chrome-error://") && (url ? t.url.includes(new URL(url).hostname) : true)
       );
       if (matchTarget && matchTarget.url) {
-        targetPage = await context.newPage();
-        await targetPage.goto(matchTarget.url, { waitUntil: "domcontentloaded", timeout: 15e3 }).catch(() => {
+        const existing2 = context.pages().find((p) => {
+          try {
+            return p.url() === matchTarget.url;
+          } catch {
+            return false;
+          }
         });
+        if (existing2) {
+          targetPage = existing2;
+        } else {
+          targetPage = await context.newPage();
+          await targetPage.goto(matchTarget.url, { waitUntil: "domcontentloaded", timeout: 15e3 }).catch(() => {
+          });
+        }
       }
     }
     if (!targetPage) {
       const pages = context.pages();
-      if (pages.length > 0) {
+      if (pages.length > 1) {
+        try {
+          for (const p of pages) {
+            const vis = await p.evaluate("document.visibilityState").catch(() => "hidden");
+            if (vis === "visible") {
+              targetPage = p;
+              break;
+            }
+          }
+        } catch {
+        }
+      }
+      if (!targetPage && pages.length > 0) {
         targetPage = pages[0];
-      } else {
+      }
+      if (!targetPage) {
         targetPage = await context.newPage();
       }
     }
     page = targetPage;
+    if (isCDP) {
+      await Promise.resolve(targetPage.bringToFront?.()).catch(() => {
+      });
+    }
   } else {
     context = await b.newContext({ viewport: { width: 1920, height: 1080 } });
     page = await context.newPage();

package/dist/{chunk-K5E4CWRV.js → chunk-CE3L6HYV.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-NTTFKS6T.js";
+} from "./chunk-3KUJOXUE.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -161,16 +161,14 @@ process.on("exit", () => {
 async function getCDPTargets(cdpEndpoint) {
   try {
     const ep = String(cdpEndpoint);
-    let host = "localhost";
-    let port = "9222";
+    let url = "http://localhost:9222/json/list";
     if (ep.startsWith("http://") || ep.startsWith("https://")) {
       const u = new URL(ep);
-      host = u.hostname;
-      port = u.port || "9222";
+      u.pathname = (u.pathname.replace(/\/+$/, "") || "") + "/json/list";
+      url = u.toString();
     } else if (/^\d+$/.test(ep)) {
-      port = ep;
+      url = `http://localhost:${ep}/json/list`;
     }
-    const url = `http://${host}:${port}/json/list`;
     const resp = await fetch(url);
     return await resp.json();
   } catch {
@@ -641,20 +639,48 @@ async function createSession(name, url, options) {
         (t) => t.url && t.url !== "about:blank" && !t.url.startsWith("chrome://") && !t.url.startsWith("chrome-untrusted://") && !t.url.startsWith("chrome-error://") && (url ? t.url.includes(new URL(url).hostname) : true)
       );
       if (matchTarget && matchTarget.url) {
-        targetPage = await context.newPage();
-        await targetPage.goto(matchTarget.url, { waitUntil: "domcontentloaded", timeout: 15e3 }).catch(() => {
+        const existing2 = context.pages().find((p) => {
+          try {
+            return p.url() === matchTarget.url;
+          } catch {
+            return false;
+          }
         });
+        if (existing2) {
+          targetPage = existing2;
+        } else {
+          targetPage = await context.newPage();
+          await targetPage.goto(matchTarget.url, { waitUntil: "domcontentloaded", timeout: 15e3 }).catch(() => {
+          });
+        }
       }
     }
     if (!targetPage) {
       const pages = context.pages();
-      if (pages.length > 0) {
+      if (pages.length > 1) {
+        try {
+          for (const p of pages) {
+            const vis = await p.evaluate("document.visibilityState").catch(() => "hidden");
+            if (vis === "visible") {
+              targetPage = p;
+              break;
+            }
+          }
+        } catch {
+        }
+      }
+      if (!targetPage && pages.length > 0) {
         targetPage = pages[0];
-      } else {
+      }
+      if (!targetPage) {
         targetPage = await context.newPage();
       }
     }
     page = targetPage;
+    if (isCDP) {
+      await Promise.resolve(targetPage.bringToFront?.()).catch(() => {
+      });
+    }
   } else {
     context = await b.newContext({ viewport: { width: 1920, height: 1080 } });
     page = await context.newPage();

package/dist/{chunk-XQ4KOZ37.js → chunk-UQUJVBXE.js}

@@ -1,7 +1,7 @@
 import {
   createRuleEngine,
   launch
-} from "./chunk-UXDGEDT7.js";
+} from "./chunk-W4JETHAD.js";
 import {
   errMsg
 } from "./chunk-GDKLH7ZY.js";
@@ -588,16 +588,14 @@ process.on("exit", () => {
 async function getCDPTargets(cdpEndpoint) {
   try {
     const ep = String(cdpEndpoint);
-    let host = "localhost";
-    let port = "9222";
+    let url = "http://localhost:9222/json/list";
     if (ep.startsWith("http://") || ep.startsWith("https://")) {
       const u = new URL(ep);
-      host = u.hostname;
-      port = u.port || "9222";
+      u.pathname = (u.pathname.replace(/\/+$/, "") || "") + "/json/list";
+      url = u.toString();
     } else if (/^\d+$/.test(ep)) {
-      port = ep;
+      url = `http://localhost:${ep}/json/list`;
     }
-    const url = `http://${host}:${port}/json/list`;
     const resp = await fetch(url);
     return await resp.json();
   } catch {
@@ -1068,20 +1066,48 @@ async function createSession(name, url, options) {
         (t) => t.url && t.url !== "about:blank" && !t.url.startsWith("chrome://") && !t.url.startsWith("chrome-untrusted://") && !t.url.startsWith("chrome-error://") && (url ? t.url.includes(new URL(url).hostname) : true)
       );
       if (matchTarget && matchTarget.url) {
-        targetPage = await context.newPage();
-        await targetPage.goto(matchTarget.url, { waitUntil: "domcontentloaded", timeout: 15e3 }).catch(() => {
+        const existing2 = context.pages().find((p) => {
+          try {
+            return p.url() === matchTarget.url;
+          } catch {
+            return false;
+          }
         });
+        if (existing2) {
+          targetPage = existing2;
+        } else {
+          targetPage = await context.newPage();
+          await targetPage.goto(matchTarget.url, { waitUntil: "domcontentloaded", timeout: 15e3 }).catch(() => {
+          });
+        }
       }
     }
     if (!targetPage) {
       const pages = context.pages();
-      if (pages.length > 0) {
+      if (pages.length > 1) {
+        try {
+          for (const p of pages) {
+            const vis = await p.evaluate("document.visibilityState").catch(() => "hidden");
+            if (vis === "visible") {
+              targetPage = p;
+              break;
+            }
+          }
+        } catch {
+        }
+      }
+      if (!targetPage && pages.length > 0) {
         targetPage = pages[0];
-      } else {
+      }
+      if (!targetPage) {
         targetPage = await context.newPage();
       }
     }
     page = targetPage;
+    if (isCDP) {
+      await Promise.resolve(targetPage.bringToFront?.()).catch(() => {
+      });
+    }
   } else {
     context = await b.newContext({ viewport: { width: 1920, height: 1080 } });
     page = await context.newPage();

package/dist/{chunk-UXDGEDT7.js → chunk-W4JETHAD.js}

@@ -526,6 +526,49 @@ var XBMouseImpl = class {
     this._x = x;
     this._y = y;
   }
+  /**
+   * Drag from the CURRENT cursor position to (x, y): press, traverse a
+   * bezier trajectory with the button held, release. Drives the REAL
+   * HTML5 DnD pipeline — field-verified (d59): this sequence fires
+   * dragstart → dragover… → drop → dragend, all isTrusted=true. No
+   * Input.dispatchDragEvent needed.
+   */
+  async drag(x, y, opts = {}) {
+    const stealth = process.env.XBROWSER_STEALTH !== "off";
+    await this.send("Input.dispatchMouseEvent", {
+      type: "mousePressed",
+      x: this._x,
+      y: this._y,
+      button: "left",
+      clickCount: 1
+    });
+    this._button = "left";
+    const steps = opts.steps ?? Math.max(10, Math.min(24, Math.round(Math.hypot(x - this._x, y - this._y) / 20)));
+    const fx = this._x, fy = this._y;
+    for (let i = 1; i <= steps; i++) {
+      if (stealth) await sleep2(rand(16, 28));
+      const t = i / steps;
+      this._x = fx + (x - fx) * t;
+      this._y = fy + (y - fy) * t;
+      await this.send("Input.dispatchMouseEvent", {
+        type: "mouseMoved",
+        x: this._x,
+        y: this._y,
+        button: this._button
+      });
+    }
+    this._x = x;
+    this._y = y;
+    await sleep2(rand(60, 140));
+    await this.send("Input.dispatchMouseEvent", {
+      type: "mouseReleased",
+      x,
+      y,
+      button: "left",
+      clickCount: 1
+    });
+    this._button = "none";
+  }
   async wheel(deltaX, deltaY) {
     await this.send("Input.dispatchMouseEvent", {
       type: "mouseWheel",
@@ -712,6 +755,26 @@ var XBKeyboardImpl = class {
       ...mapping.keyCode ? { windowsVirtualKeyCode: mapping.keyCode } : {}
     });
   }
+  /**
+   * Shortcut combo press (modifier+key) with explicit per-event modifiers
+   * bitmask — plain down(mod)+press(key) inserts the raw character because
+   * CDP modifiers are per-event fields, not session state (d56: Meta,v
+   * typed a literal 'v'). keyDown type carries the default action so the
+   * browser's shortcut dispatcher sees the combo (e.g. native paste).
+   */
+  async pressCombo(key, modifier) {
+    const MODBIT = { Alt: 1, Control: 2, Meta: 4, Shift: 8 };
+    const m = resolveKeyMapping(modifier);
+    const k = resolveKeyMapping(key);
+    const bits = MODBIT[modifier] ?? 0;
+    await this.dispatchKeyEvent({ type: "rawKeyDown", key: m.key, code: m.code, ...m.keyCode ? { windowsVirtualKeyCode: m.keyCode } : {}, modifiers: bits });
+    await this.dispatchKeyEvent({ type: "keyDown", key: k.key, code: k.code, ...k.keyCode ? { windowsVirtualKeyCode: k.keyCode } : {}, modifiers: bits });
+    if (process.env.XBROWSER_STEALTH !== "off") {
+      await sleep3(rand(...DEFAULT_STEALTH_CONFIG.keyPressDuration));
+    }
+    await this.dispatchKeyEvent({ type: "keyUp", key: k.key, code: k.code, ...k.keyCode ? { windowsVirtualKeyCode: k.keyCode } : {}, modifiers: bits });
+    await this.dispatchKeyEvent({ type: "keyUp", key: m.key, code: m.code, ...m.keyCode ? { windowsVirtualKeyCode: m.keyCode } : {}, modifiers: 0 });
+  }
   async dispatchKeyEvent(params) {
     await this.conn.send("Input.dispatchKeyEvent", params, this.sessionId);
   }
@@ -993,6 +1056,18 @@ var XBLocatorImpl = class _XBLocatorImpl {
     await waitForActionable(this.page, this.selector, opts);
     await scrollIntoView(this.page, this.selector);
     await this.click({ ...opts });
+    if (process.env.XBROWSER_STEALTH !== "off" && value.length >= 40 && process.env.XBROWSER_FILL_TYPE !== "type") {
+      try {
+        const { pasteViaClipboard, syntheticPaste } = await import("./clipboard-BOL2GP2E.js");
+        await pasteViaClipboard(this.page, value);
+        const got = await this.page.evaluate(
+          `(function(){ const el = ${this._q(this.selector)}; return el ? (el.value || '') : ''; })()`
+        );
+        if (got === value) return;
+        if (await syntheticPaste(this.page, this._q(this.selector), value)) return;
+      } catch {
+      }
+    }
     await this.page.keyboard.type(value, { stealth: true });
     return;
     await this.page.evaluate(`
@@ -1132,6 +1207,21 @@ var XBLocatorImpl = class _XBLocatorImpl {
     `);
     return selected;
   }
+  async dragAndDrop(source, target) {
+    const boxes = await this.page.evaluate(`
+      (function() {
+        const s = ${this._q(source)}, t = ${this._q(target)};
+        if (!s || !t) return null;
+        const c = (el) => { const r = el.getBoundingClientRect(); return { x: r.x + r.width / 2, y: r.y + r.height / 2 }; };
+        return [c(s), c(t)];
+      })()
+    `);
+    if (!boxes || !boxes[0] || !boxes[1]) {
+      throw new Error(`dragAndDrop: element not found (${source} / ${target})`);
+    }
+    await this.page.mouse.move(boxes[0].x, boxes[0].y);
+    await this.page.mouse.drag(boxes[1].x, boxes[1].y);
+  }
   async screenshot(opts = {}) {
     await waitForActionable(this.page, this.selector);
     const box = await this.page.evaluate(`

package/dist/cli.js

@@ -26,6 +26,16 @@ import {
 import {
   buildViewerUrl
 } from "./chunk-3OD76SUE.js";
+import {
+  NPM_REGISTRY_URL,
+  NPM_SCOPE,
+  getConfigValue,
+  getMarketplaceUrl,
+  loadConfig,
+  resolveNpmPackageWithFallback,
+  resolveScreenshotsDir,
+  setConfigValue
+} from "./chunk-ZTHE5RBZ.js";
 import {
   getDaemonConfig,
   getDaemonProcessStatus,
@@ -62,7 +72,7 @@ import {
   setActivePage,
   sleep,
   wheelDelta
-} from "./chunk-HFP4QCZL.js";
+} from "./chunk-3LVR44KG.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -71,16 +81,6 @@ import {
   detectAntiBot,
   formatDetectionMessage
 } from "./chunk-JKVUFP3G.js";
-import {
-  NPM_REGISTRY_URL,
-  NPM_SCOPE,
-  getConfigValue,
-  getMarketplaceUrl,
-  loadConfig,
-  resolveNpmPackageWithFallback,
-  resolveScreenshotsDir,
-  setConfigValue
-} from "./chunk-ZTHE5RBZ.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/router.ts
@@ -947,14 +947,14 @@ var mouseCommand = registerCommand({
   description: "Control the mouse (move, click, etc.)",
   scope: "page",
   parameters: z6.object({
-    action: z6.enum(["move", "down", "up", "click", "dblclick"]),
+    action: z6.enum(["move", "down", "up", "click", "dblclick", "drag"]),
     x: z6.coerce.number(),
     y: z6.coerce.number(),
     button: z6.enum(["left", "right", "middle"]).optional(),
     steps: z6.coerce.number().optional()
   }),
   result: z6.object({
-    action: z6.enum(["move", "down", "up", "click", "dblclick"]),
+    action: z6.enum(["move", "down", "up", "click", "dblclick", "drag"]),
     x: z6.number(),
     y: z6.number()
   }),
@@ -978,6 +978,9 @@ var mouseCommand = registerCommand({
       case "dblclick":
         await ctx.page.mouse.dblclick(p.x, p.y, { button });
         break;
+      case "drag":
+        await ctx.page.mouse.drag(p.x, p.y, p.steps ? { steps: p.steps } : {});
+        break;
     }
     return ok6({ action: p.action, x: p.x, y: p.y });
   }
@@ -7542,7 +7545,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-JNT2I73V.js");
+    const { findTargetPage } = await import("./browser-HY7UXUQV.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.`);
@@ -7756,7 +7759,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     const errorMessage = errMsg(err);
     if (session?.page && process.env.XBROWSER_RECOVERY && !extraOpts?._recoveryAttempted) {
       try {
-        const { attemptRecovery } = await import("./recovery-FTZGV6VY.js");
+        const { attemptRecovery } = await import("./recovery-NXC35EQN.js");
         const recovery = await attemptRecovery(
           session.page,
           sessionName,
@@ -13717,7 +13720,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-JNT2I73V.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-HY7UXUQV.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -13993,7 +13996,7 @@ async function main() {
     const command = process.argv[2];
     const isLongRunning = command === "preview" || command === "serve";
     if (!isLongRunning) {
-      const { ensureProcessCanExit } = await import("./browser-JNT2I73V.js");
+      const { ensureProcessCanExit } = await import("./browser-HY7UXUQV.js");
       await ensureProcessCanExit().catch(() => {
       });
       process.exit(process.exitCode || exitCode);

package/dist/clipboard-BOL2GP2E.js

@@ -0,0 +1,58 @@
+import "./chunk-KFQGP6VL.js";
+
+// src/utils/clipboard.ts
+import { exec, execSync } from "child_process";
+function writeClipboard(text) {
+  const plat = process.platform;
+  if (plat === "darwin") {
+    const p = exec("pbcopy");
+    if (!p.stdin) throw new Error("pbcopy stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("sleep 0.05");
+  } else if (plat === "linux") {
+    execSync("command -v xclip >/dev/null 2>&1 && echo ok", { stdio: "ignore" });
+    const p = exec("xclip -selection clipboard -in");
+    if (!p.stdin) throw new Error("xclip stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("sleep 0.05");
+  } else if (plat === "win32") {
+    const p = exec("clip");
+    if (!p.stdin) throw new Error("clip stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("timeout /t 1 /nobreak >nul");
+  } else {
+    throw new Error(`Unsupported platform for clipboard: ${plat}`);
+  }
+}
+async function pasteViaClipboard(page, text) {
+  writeClipboard(text);
+  const kb = page.keyboard;
+  const mod = process.platform === "darwin" ? "Meta" : "Control";
+  await kb.pressCombo("v", mod);
+  await new Promise((r) => setTimeout(r, 150));
+}
+async function syntheticPaste(page, selector, text) {
+  const result = await page.evaluate(`
+    (function() {
+      const el = ${"{SELECTOR}"};
+      if (!el) return false;
+      el.focus();
+      if (el.value) { el.select(); document.execCommand('delete'); }
+      try {
+        const dt = new DataTransfer();
+        dt.setData('text/plain', ${JSON.stringify(text)});
+        el.dispatchEvent(new ClipboardEvent('paste', { clipboardData: dt, bubbles: true, cancelable: true }));
+      } catch (e) { /* ClipboardEvent ctor guard */ }
+      const ok = document.execCommand('insertText', false, ${JSON.stringify(text)});
+      return ok === true && (el.value || '') === ${JSON.stringify(text)};
+    })()
+  `.replace("{SELECTOR}", selector));
+  return result === true;
+}
+export {
+  pasteViaClipboard,
+  syntheticPaste
+};

package/dist/clipboard-XRP54ENE.js

@@ -0,0 +1,58 @@
+import "./chunk-3RG5ZIWI.js";
+
+// src/utils/clipboard.ts
+import { exec, execSync } from "child_process";
+function writeClipboard(text) {
+  const plat = process.platform;
+  if (plat === "darwin") {
+    const p = exec("pbcopy");
+    if (!p.stdin) throw new Error("pbcopy stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("sleep 0.05");
+  } else if (plat === "linux") {
+    execSync("command -v xclip >/dev/null 2>&1 && echo ok", { stdio: "ignore" });
+    const p = exec("xclip -selection clipboard -in");
+    if (!p.stdin) throw new Error("xclip stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("sleep 0.05");
+  } else if (plat === "win32") {
+    const p = exec("clip");
+    if (!p.stdin) throw new Error("clip stdin unavailable");
+    p.stdin.write(text);
+    p.stdin.end();
+    execSync("timeout /t 1 /nobreak >nul");
+  } else {
+    throw new Error(`Unsupported platform for clipboard: ${plat}`);
+  }
+}
+async function pasteViaClipboard(page, text) {
+  writeClipboard(text);
+  const kb = page.keyboard;
+  const mod = process.platform === "darwin" ? "Meta" : "Control";
+  await kb.pressCombo("v", mod);
+  await new Promise((r) => setTimeout(r, 150));
+}
+async function syntheticPaste(page, selector, text) {
+  const result = await page.evaluate(`
+    (function() {
+      const el = ${"{SELECTOR}"};
+      if (!el) return false;
+      el.focus();
+      if (el.value) { el.select(); document.execCommand('delete'); }
+      try {
+        const dt = new DataTransfer();
+        dt.setData('text/plain', ${JSON.stringify(text)});
+        el.dispatchEvent(new ClipboardEvent('paste', { clipboardData: dt, bubbles: true, cancelable: true }));
+      } catch (e) { /* ClipboardEvent ctor guard */ }
+      const ok = document.execCommand('insertText', false, ${JSON.stringify(text)});
+      return ok === true && (el.value || '') === ${JSON.stringify(text)};
+    })()
+  `.replace("{SELECTOR}", selector));
+  return result === true;
+}
+export {
+  pasteViaClipboard,
+  syntheticPaste
+};

package/dist/daemon-main.js

@@ -7,6 +7,10 @@ import {
 import {
   buildViewerUrl
 } from "./chunk-TZPKFUBT.js";
+import {
+  ScreencastCapturer,
+  resolveScreenshotsDir
+} from "./chunk-HBMEFSTB.js";
 import "./chunk-CG3D3CHY.js";
 import {
   commandLogStore,
@@ -30,13 +34,13 @@ import {
   resolveLaunchOpts,
   saveSessionDiskMeta,
   setActivePage
-} from "./chunk-XQ4KOZ37.js";
+} from "./chunk-UQUJVBXE.js";
 import {
   createRuleEngine,
   rand,
   sleep,
   wheelDelta
-} from "./chunk-UXDGEDT7.js";
+} from "./chunk-W4JETHAD.js";
 import {
   queryJS
 } from "./chunk-3FWLW7FS.js";
@@ -48,10 +52,6 @@ import {
   detectAntiBot,
   formatDetectionMessage
 } from "./chunk-JKVUFP3G.js";
-import {
-  ScreencastCapturer,
-  resolveScreenshotsDir
-} from "./chunk-HBMEFSTB.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/daemon/daemon-main.ts
@@ -907,14 +907,14 @@ var mouseCommand = registerCommand({
   description: "Control the mouse (move, click, etc.)",
   scope: "page",
   parameters: z6.object({
-    action: z6.enum(["move", "down", "up", "click", "dblclick"]),
+    action: z6.enum(["move", "down", "up", "click", "dblclick", "drag"]),
     x: z6.coerce.number(),
     y: z6.coerce.number(),
     button: z6.enum(["left", "right", "middle"]).optional(),
     steps: z6.coerce.number().optional()
   }),
   result: z6.object({
-    action: z6.enum(["move", "down", "up", "click", "dblclick"]),
+    action: z6.enum(["move", "down", "up", "click", "dblclick", "drag"]),
     x: z6.number(),
     y: z6.number()
   }),
@@ -938,6 +938,9 @@ var mouseCommand = registerCommand({
       case "dblclick":
         await ctx.page.mouse.dblclick(p.x, p.y, { button });
         break;
+      case "drag":
+        await ctx.page.mouse.drag(p.x, p.y, p.steps ? { steps: p.steps } : {});
+        break;
     }
     return ok6({ action: p.action, x: p.x, y: p.y });
   }
@@ -7060,7 +7063,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-YYMKZWTU.js");
+    const { findTargetPage } = await import("./browser-ZVNDI4TR.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.`);
@@ -7274,7 +7277,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     const errorMessage = errMsg(err);
     if (session?.page && process.env.XBROWSER_RECOVERY && !extraOpts?._recoveryAttempted) {
       try {
-        const { attemptRecovery } = await import("./recovery-Z3RDZENA.js");
+        const { attemptRecovery } = await import("./recovery-MDWAVXE4.js");
         const recovery = await attemptRecovery(
           session.page,
           sessionName,
@@ -8314,7 +8317,7 @@ function createRPCHandler() {
       return result;
     } catch (err) {
       const errorMessage = errMsg(err);
-      const { attemptRecovery } = await import("./recovery-Z3RDZENA.js");
+      const { attemptRecovery } = await import("./recovery-MDWAVXE4.js");
       const recovery = await attemptRecovery(
         session?.page,
         sessionName,
@@ -8879,7 +8882,7 @@ function createRPCHandler() {
     if (isNewFormat) {
       try {
         const replayErrors = [];
-        const { SessionReplayer } = await import("./session-replayer-DKHXF3DZ.js");
+        const { SessionReplayer } = await import("./session-replayer-NV65I6OQ.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.d.ts

@@ -311,6 +311,10 @@ interface XBMouse {
         steps?: number;
     }): Promise<void>;
     wheel(deltaX: number, deltaY: number): Promise<void>;
+    /** Drag from current position to (x,y) — drives the real HTML5 DnD pipeline */
+    drag(x: number, y: number, opts?: {
+        steps?: number;
+    }): Promise<void>;
 }
 interface XBKeyboard {
     press(key: string, opts?: {
@@ -318,6 +322,8 @@ interface XBKeyboard {
     }): Promise<void>;
     /** Navigation key with CDP 'keyDown' type (carries browser default actions) */
     pressNav(key: string): Promise<void>;
+    /** Shortcut combo (modifier+key) with explicit per-event modifiers bitmask */
+    pressCombo(key: string, modifier: 'Meta' | 'Control' | 'Alt' | 'Shift'): Promise<void>;
     down(key: string): Promise<void>;
     up(key: string): Promise<void>;
     type(text: string, opts?: {

package/dist/index.js

@@ -1,3 +1,24 @@
+import {
+  filterRecording,
+  parseExcludeTypes
+} from "./chunk-ANVL2ID2.js";
+import {
+  closeAllSessions,
+  closeEphemeralContext,
+  closeSessionByName,
+  createEphemeralContext,
+  createSession,
+  destroyBrowser,
+  findOrRestoreSession,
+  findSession,
+  getAllSessions,
+  getBrowser,
+  getSessionById,
+  resetForTesting,
+  resolveLaunchOpts,
+  saveSessionDiskMeta,
+  setActivePage
+} from "./chunk-CE3L6HYV.js";
 import {
   detectAntiBot,
   formatDetectionMessage
@@ -61,43 +82,11 @@ import {
   extractRecording,
   printExtractSummary
 } from "./chunk-X46HDAOT.js";
-import {
-  filterRecording,
-  parseExcludeTypes
-} from "./chunk-ANVL2ID2.js";
-import {
-  SessionRecorder
-} from "./chunk-NODRQGOK.js";
-import {
-  addKnownIssue,
-  getKnowledgePath,
-  init_site_knowledge,
-  listSiteKnowledge,
-  readSiteKnowledge,
-  readSiteKnowledgeMarkdown
-} from "./chunk-OZKD3W4X.js";
-import {
-  closeAllSessions,
-  closeEphemeralContext,
-  closeSessionByName,
-  createEphemeralContext,
-  createSession,
-  destroyBrowser,
-  findOrRestoreSession,
-  findSession,
-  getAllSessions,
-  getBrowser,
-  getSessionById,
-  resetForTesting,
-  resolveLaunchOpts,
-  saveSessionDiskMeta,
-  setActivePage
-} from "./chunk-K5E4CWRV.js";
 import {
   rand,
   sleep,
   wheelDelta
-} from "./chunk-NTTFKS6T.js";
+} from "./chunk-3KUJOXUE.js";
 import "./chunk-TNEN6VQ2.js";
 import {
   errMsg
@@ -118,6 +107,17 @@ import {
   networkAnomalyRule,
   pageLifecycleRule
 } from "./chunk-H2A5JUK5.js";
+import {
+  SessionRecorder
+} from "./chunk-NODRQGOK.js";
+import {
+  addKnownIssue,
+  getKnowledgePath,
+  init_site_knowledge,
+  listSiteKnowledge,
+  readSiteKnowledge,
+  readSiteKnowledgeMarkdown
+} from "./chunk-OZKD3W4X.js";
 import {
   __require
 } from "./chunk-KFQGP6VL.js";
@@ -981,14 +981,14 @@ var mouseCommand = registerCommand({
   description: "Control the mouse (move, click, etc.)",
   scope: "page",
   parameters: z6.object({
-    action: z6.enum(["move", "down", "up", "click", "dblclick"]),
+    action: z6.enum(["move", "down", "up", "click", "dblclick", "drag"]),
     x: z6.coerce.number(),
     y: z6.coerce.number(),
     button: z6.enum(["left", "right", "middle"]).optional(),
     steps: z6.coerce.number().optional()
   }),
   result: z6.object({
-    action: z6.enum(["move", "down", "up", "click", "dblclick"]),
+    action: z6.enum(["move", "down", "up", "click", "dblclick", "drag"]),
     x: z6.number(),
     y: z6.number()
   }),
@@ -1012,6 +1012,9 @@ var mouseCommand = registerCommand({
       case "dblclick":
         await ctx.page.mouse.dblclick(p.x, p.y, { button });
         break;
+      case "drag":
+        await ctx.page.mouse.drag(p.x, p.y, p.steps ? { steps: p.steps } : {});
+        break;
     }
     return ok6({ action: p.action, x: p.x, y: p.y });
   }
@@ -7893,7 +7896,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
   }
   let targetPageOverride = null;
   if (_target && extraOpts?.cdpEndpoint) {
-    const { findTargetPage } = await import("./browser-4FKHBUBJ.js");
+    const { findTargetPage } = await import("./browser-GPRLH6P6.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.`);
@@ -14106,7 +14109,7 @@ Run "xbrowser ${command} ${subCommand} --help" to see available parameters.`
               const targetPage = pages[cmdTabIndex];
               await targetPage.bringToFront().catch(() => {
               });
-              const { setActivePage: setActivePage2 } = await import("./browser-4FKHBUBJ.js");
+              const { setActivePage: setActivePage2 } = await import("./browser-GPRLH6P6.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -17279,7 +17282,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-QX72T7SU.js");
+    const { launch } = await import("./cdp-driver-GMDP4KDN.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-DKHXF3DZ.js → session-replayer-NV65I6OQ.js}

@@ -34,7 +34,7 @@ var SessionReplayer = class {
     if (this.opts.page) {
       this.page = this.opts.page;
     } else if (this.opts.cdpUrl) {
-      const { launch } = await import("./cdp-driver-7RW4NY2X.js");
+      const { launch } = await import("./cdp-driver-FIAUJTBZ.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.15.0",
+  "version": "1.17.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": {

package/dist/{recovery-Z3RDZENA.js → recovery-MDWAVXE4.js}

@@ -1,11 +1,11 @@
-import {
-  buildViewerUrl
-} from "./chunk-TZPKFUBT.js";
-import "./chunk-CG3D3CHY.js";
 import {
   HumanInteractionManager
 } from "./chunk-OMU63E6J.js";
+import {
+  buildViewerUrl
+} from "./chunk-TZPKFUBT.js";
 import "./chunk-HBMEFSTB.js";
+import "./chunk-CG3D3CHY.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/recovery.ts

package/dist/{recovery-FTZGV6VY.js → recovery-NXC35EQN.js}

@@ -1,11 +1,11 @@
-import {
-  buildViewerUrl
-} from "./chunk-3OD76SUE.js";
-import "./chunk-Q2DFJQGS.js";
 import {
   HumanInteractionManager
 } from "./chunk-TEXCXIBW.js";
+import {
+  buildViewerUrl
+} from "./chunk-3OD76SUE.js";
 import "./chunk-ZTHE5RBZ.js";
+import "./chunk-Q2DFJQGS.js";
 import "./chunk-KFQGP6VL.js";
 
 // src/recovery.ts