@xbrowser/cli 1.15.0 → 1.16.0

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

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

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

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

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

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

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

@@ -701,6 +701,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 +1104,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(`

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

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

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

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

package/dist/{chunk-HFP4QCZL.js → chunk-5EYOEB4R.js}

@@ -714,6 +714,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 +1117,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(`
@@ -5363,16 +5395,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 {
@@ -5857,6 +5887,10 @@ async function createSession(name, url, options) {
       }
     }
     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-7V3B7VPX.js}

@@ -1,6 +1,6 @@
 import {
   launch
-} from "./chunk-NTTFKS6T.js";
+} from "./chunk-A5HJ6IRE.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 {
@@ -655,6 +653,10 @@ async function createSession(name, url, options) {
       }
     }
     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-NTTFKS6T.js → chunk-A5HJ6IRE.js}

@@ -711,6 +711,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 +1114,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(`

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

@@ -1,7 +1,7 @@
 import {
   createRuleEngine,
   launch
-} from "./chunk-UXDGEDT7.js";
+} from "./chunk-LTBNQERK.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 {
@@ -1082,6 +1080,10 @@ async function createSession(name, url, options) {
       }
     }
     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-LTBNQERK.js}

@@ -712,6 +712,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 +1013,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(`

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-5EYOEB4R.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
@@ -7542,7 +7542,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-KT4FOWBO.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 +7756,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 +13717,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-KT4FOWBO.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -13993,7 +13993,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-KT4FOWBO.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-GWQ5NTVE.js";
 import {
   createRuleEngine,
   rand,
   sleep,
   wheelDelta
-} from "./chunk-UXDGEDT7.js";
+} from "./chunk-LTBNQERK.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
@@ -7060,7 +7060,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-AOVQTGJ7.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 +7274,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 +8314,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 +8879,7 @@ function createRPCHandler() {
     if (isNewFormat) {
       try {
         const replayErrors = [];
-        const { SessionReplayer } = await import("./session-replayer-DKHXF3DZ.js");
+        const { SessionReplayer } = await import("./session-replayer-MJH5W7BB.js");
         const replayer = new SessionReplayer({
           page: session.page,
           stepDelay: slowMo * 500,

package/dist/index.d.ts

@@ -318,6 +318,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-7V3B7VPX.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-A5HJ6IRE.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";
@@ -7893,7 +7893,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-3KTEVTMU.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 +14106,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-3KTEVTMU.js");
               setActivePage2(session, targetPage);
             }
           }
@@ -17279,7 +17279,7 @@ var DataCollector = class {
     return results;
   }
   async createBrowserContext() {
-    const { launch } = await import("./cdp-driver-QX72T7SU.js");
+    const { launch } = await import("./cdp-driver-OC37OT4B.js");
     const { browser } = await launch({
       headless: true,
       args: ["--no-sandbox", "--disable-setuid-sandbox"]

package/dist/{session-replayer-DKHXF3DZ.js → session-replayer-MJH5W7BB.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-DKNLIA6B.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.16.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