@xbrowser/cli 1.10.0 → 1.12.0

package/dist/{cdp-driver-2T4P4ZE2.js → chunk-Z6CUR3VG.js}

@@ -1,14 +1,17 @@
+import {
+  queryAllJS,
+  queryJS
+} from "./chunk-3FWLW7FS.js";
 import {
   connectToCDP,
-  errMsg,
-  findChrome,
-  getCDPTargets,
-  killChrome,
   launchChrome
-} from "./chunk-AMI64BSD.js";
+} from "./chunk-TNEN6VQ2.js";
+import {
+  errMsg
+} from "./chunk-GDKLH7ZY.js";
 import {
   __require
-} from "./chunk-3RG5ZIWI.js";
+} from "./chunk-KFQGP6VL.js";
 
 // src/cdp-driver/browser.ts
 import { EventEmitter as EventEmitter3 } from "events";
@@ -19,6 +22,285 @@ import { EventEmitter as EventEmitter2 } from "events";
 // src/cdp-driver/page.ts
 import { EventEmitter } from "events";
 
+// src/cdp-driver/stealth.ts
+var DEFAULT_STEALTH_CONFIG = {
+  bezierCurvature: [0.35, 0.6],
+  noiseAmplitude: 5.5,
+  overshootRange: [6, 14],
+  aimPause: [150, 400],
+  pressDuration: [60, 140],
+  releaseDrift: [0.8, 2.5],
+  landingOffsetSmall: [0.3, 2.5],
+  landingOffsetLarge: [1.5, 7],
+  smallElementThreshold: 30,
+  typingRhythm: {
+    fastProb: 0.22,
+    fastRange: [25, 60],
+    normalRange: [50, 350],
+    pauseProb: 0.18,
+    pauseRange: [400, 1200]
+  },
+  keyPressDuration: [50, 110],
+  typoProbability: 0.06,
+  wheelPeak: 180,
+  wheelDecayRate: 0.4
+};
+function rand(min, max) {
+  return min + Math.random() * (max - min);
+}
+function cosineEase(t) {
+  return 0.5 - 0.5 * Math.cos(Math.PI * t);
+}
+function bezierTrajectory(x0, y0, x1, y1, config = DEFAULT_STEALTH_CONFIG) {
+  const dist = Math.hypot(x1 - x0, y1 - y0);
+  const n = Math.max(10, Math.min(28, Math.round(dist / 15)));
+  const shortMove = dist < 120;
+  const curvature = shortMove ? rand(2, 6) : Math.max(dist * rand(...config.bezierCurvature), rand(18, 35));
+  const dir = Math.random() < 0.5 ? 1 : -1;
+  const d = dist || 1;
+  const dx = x1 - x0, dy = y1 - y0;
+  const c1x = x0 + dx * 0.3 - dy / d * curvature * 0.5 * dir;
+  const c1y = y0 + dy * 0.3 + dx / d * curvature * 0.5 * dir;
+  const c2x = x0 + dx * 0.7 - dy / d * curvature * 0.8 * dir;
+  const c2y = y0 + dy * 0.7 + dx / d * curvature * 0.8 * dir;
+  const points = [];
+  for (let i = 1; i <= n; i++) {
+    const t = cosineEase(i / n);
+    const mt = 1 - t;
+    let px = mt ** 3 * x0 + 3 * mt ** 2 * t * c1x + 3 * mt * t ** 2 * c2x + t ** 3 * x1;
+    let py = mt ** 3 * y0 + 3 * mt ** 2 * t * c1y + 3 * mt * t ** 2 * c2y + t ** 3 * y1;
+    const amp = shortMove ? Math.min(2, config.noiseAmplitude) : config.noiseAmplitude;
+    px += rand(-amp, amp);
+    py += rand(-amp, amp);
+    points.push({ x: px, y: py, delay: rand(9, 16) });
+  }
+  if (!shortMove) {
+    const over = rand(...config.overshootRange);
+    const ox = x1 + dx / d * over + rand(-2, 2);
+    const oy = y1 + dy / d * over + rand(-2, 2);
+    points.push({ x: ox, y: oy, delay: rand(14, 30) });
+    points.push({
+      x: x1 + dx / d * over * 0.4,
+      y: y1 + dy / d * over * 0.4,
+      delay: rand(14, 30)
+    });
+  }
+  points.push({ x: x1 + rand(-1, 1), y: y1 + rand(-1, 1), delay: rand(14, 30) });
+  return points;
+}
+function landingOffset(width, height, config = DEFAULT_STEALTH_CONFIG) {
+  const isSmall = Math.min(width, height) < config.smallElementThreshold;
+  const range = isSmall ? config.landingOffsetSmall : config.landingOffsetLarge;
+  const dx = rand(...range) * (Math.random() < 0.5 ? -1 : 1);
+  const dy = rand(...range) * (Math.random() < 0.5 ? -1 : 1);
+  return { dx, dy };
+}
+var KEY_MAP = {};
+for (let i = 97; i <= 122; i++) {
+  const ch = String.fromCharCode(i);
+  KEY_MAP[ch] = { key: ch, code: "Key" + ch.toUpperCase(), vk: i - 32 };
+}
+for (let i = 65; i <= 90; i++) {
+  const ch = String.fromCharCode(i);
+  KEY_MAP[ch] = { key: ch, code: "Key" + ch, vk: i, shift: true };
+}
+for (let i = 48; i <= 57; i++) {
+  const ch = String.fromCharCode(i);
+  KEY_MAP[ch] = { key: ch, code: "Digit" + ch, vk: i };
+}
+Object.assign(KEY_MAP, {
+  " ": { key: " ", code: "Space", vk: 32 },
+  ".": { key: ".", code: "Period", vk: 190 },
+  "-": { key: "-", code: "Minus", vk: 189 },
+  "@": { key: "@", code: "Digit2", vk: 50, shift: true },
+  "_": { key: "_", code: "Minus", vk: 189, shift: true }
+});
+function buildStealthInitScript() {
+  return [
+    "(function(){",
+    // 1. AEL event proxy
+    "  var o=EventTarget.prototype.addEventListener;",
+    "  var fc=new InputDeviceCapabilities({firesTouchEvents:false});",
+    "  var _ael=function(t,f){",
+    "    var op=arguments[2];",
+    '    if(typeof f!=="function")return o.call(this,t,f,op);',
+    "    var w=function(e){",
+    "      if(!e||e.constructor===FocusEvent||e.constructor===KeyboardEvent)return f.call(this,e);",
+    "      return f.call(this,new Proxy(e,{get:function(k,p){",
+    '        if(p==="sourceCapabilities")return fc;',
+    '        if(p==="isTrusted")return k.isTrusted;',
+    '        if((p==="clientX"||p==="clientY")&&k.type==="click"&&Number.isInteger(k[p])&&k.isTrusted===true){',
+    "          var _f=((k.timeStamp||Date.now())%89)/89*0.7+0.15;",
+    "          return k[p]+_f;",
+    "        }",
+    '        var v=Reflect.get(k,p);return typeof v==="function"?v.bind(k):v;',
+    "      }}));",
+    "    };",
+    "    return o.call(this,t,w,op);",
+    "  };",
+    "  EventTarget.prototype.addEventListener=_ael;",
+    // 2. Screen override (prototype-level, not instance-level)
+    "  var _gw=function(){return 1728};",
+    "  var _gh=function(){return 1117};",
+    "  var _gah=function(){return 1092};",
+    '  Object.defineProperty(Screen.prototype,"width",{get:_gw,configurable:true});',
+    '  Object.defineProperty(Screen.prototype,"height",{get:_gh,configurable:true});',
+    '  Object.defineProperty(Screen.prototype,"availWidth",{get:_gw,configurable:true});',
+    '  Object.defineProperty(Screen.prototype,"availHeight",{get:_gah,configurable:true});',
+    "  document.hasFocus=function(){return true};",
+    // 4. Canvas/WebGL fingerprint: per-session stable noise (d20).
+    //    Headless software raster differs subtly from Chrome GPU raster —
+    //    toDataURL hashes fingerprint the rasterizer. Inject a stable
+    //    (per-page-load) subpixel shift into fillText so hashes look like a
+    //    distinct-but-consistent real GPU, and hide the HEADLESS tell in
+    //    WebGL renderer strings.
+    "  var _seed=Math.floor(Math.random()*2147483647);",
+    "  var _prng=function(){_seed=(_seed*48271)%2147483647;return _seed/2147483647;};",
+    "  var _dx=(_prng()*0.4-0.2).toFixed(3)*1, _dy=(_prng()*0.4-0.2).toFixed(3)*1;",
+    "  var _fillText=CanvasRenderingContext2D.prototype.fillText;",
+    "  CanvasRenderingContext2D.prototype.fillText=function(t,x,y,m){",
+    "    return _fillText.call(this,t,x+_dx,y+_dy,m);",
+    "  };",
+    "  var _toDataURL=HTMLCanvasElement.prototype.toDataURL;",
+    "  HTMLCanvasElement.prototype.toDataURL=function(){",
+    '    var ctx=this.getContext("2d");',
+    "    if(ctx){var d=ctx.getImageData(0,0,Math.min(this.width,2),Math.min(this.height,2));",
+    "      for(var i=0;i<d.data.length;i+=4){if(d.data[i+3]>0){d.data[i]^=1;break;}}",
+    "      ctx.putImageData(d,0,0);}",
+    "    return _toDataURL.apply(this,arguments);",
+    "  };",
+    "  try{",
+    "    var _gl=HTMLCanvasElement.prototype.getContext;",
+    "    HTMLCanvasElement.prototype.getContext=function(t,o){",
+    "      var c=_gl.call(this,t,o);",
+    '      if(c&&(t==="webgl"||t==="experimental-webgl")&&c.getParameter){',
+    "        var _gp=c.getParameter.bind(c);",
+    "        c.getParameter=function(p){",
+    "          var v=_gp(p);",
+    '          if(typeof v==="string"&&/SwiftShader|Software|Rasterizer|Headless/i.test(v))',
+    '            return "ANGLE (Apple, ANGLE Metal Renderer: Apple M2 Max, Unspecified Version)";',
+    "          return v;};}",
+    "      return c;};",
+    "  }catch(e){}",
+    // 5. AudioContext fingerprint: per-load stable micro-noise on channel
+    //    data (d21). DSP sum differences between headless software audio and
+    //    real hardware audio are a classic fingerprint — add ±1e-7 level
+    //    noise (inaudible, changes the sum hash).
+    "  try{",
+    "    var _gcd=AudioBuffer.prototype.getChannelData;",
+    "    AudioBuffer.prototype.getChannelData=function(ch){",
+    "      var d=_gcd.call(this,ch);",
+    '      var key="__xb_audio_"+ch;',
+    "      if(!this[key]){",
+    "        this[key]=true;",
+    "        for(var i=0;i<d.length;i+=997){d[i]=d[i]+(_prng()-0.5)*2e-7;}",
+    "      }",
+    "      return d;",
+    "    };",
+    "    var _gffd=AnalyserNode.prototype.getFloatFrequencyData;",
+    "    AnalyserNode.prototype.getFloatFrequencyData=function(arr){",
+    "      _gffd.call(this,arr);",
+    "      for(var i=0;i<arr.length;i+=31){arr[i]=arr[i]+(_prng()-0.5)*0.01;}",
+    "    };",
+    "    var _gfbd=AnalyserNode.prototype.getByteFrequencyData;",
+    "    AnalyserNode.prototype.getByteFrequencyData=function(arr){",
+    "      _gfbd.call(this,arr);",
+    "      for(var i=0;i<arr.length;i+=31){arr[i]=(arr[i]+((_prng()*3)|0))&255;}",
+    "    };",
+    "  }catch(e){}",
+    // 3b. Font metrics + speechSynthesis + battery (d22): headless tells
+    "  try{",
+    "    var _mt=CanvasRenderingContext2D.prototype.measureText;",
+    '    var _tmw=Object.getOwnPropertyDescriptor(TextMetrics.prototype,"width");',
+    "    CanvasRenderingContext2D.prototype.measureText=function(t){",
+    "      var m=_mt.call(this,t);",
+    '      try{Object.defineProperty(m,"width",{get:function(){return _tmw.get.call(m)+_dx*0.01;},configurable:true});}catch(e){}',
+    "      return m;",
+    "    };",
+    "  }catch(e){}",
+    "  try{",
+    '    var _fakeVoices=["Alex","Daniel","Karen","Moira","Ralph","Samantha","Ting-Ting","Mei-Jia","Sinji","Yunda"];',
+    "    var _sv=speechSynthesis.getVoices.bind(speechSynthesis);",
+    "    speechSynthesis.getVoices=function(){",
+    "      var real=_sv();",
+    "      if(real&&real.length)return real;",
+    '      return _fakeVoices.map(function(n,i){return {name:n,lang:i<2?"en-US":i<6?"en-GB":"zh-TW",localService:true,default:i===0,voiceURI:n};});',
+    "    };",
+    "  }catch(e){}",
+    "  try{",
+    "    var _gb=navigator.getBattery.bind(navigator);",
+    "    navigator.getBattery=function(){",
+    "      return _gb().then(function(b){",
+    '        Object.defineProperty(b,"charging",{get:function(){return true;},configurable:true});',
+    "        return b;});",
+    "    };",
+    "  }catch(e){}",
+    // 3c. WebRTC local IP leak guard (d23): headless STUN candidates can
+    //     expose host IPs; mDNS-only candidates are the modern Chrome default.
+    "  try{",
+    "    var _oc=RTCPeerConnection.prototype.createOffer;",
+    "    RTCPeerConnection.prototype.createOffer=function(){",
+    "      var p=_oc.apply(this,arguments);",
+    "      var self=this;",
+    "      return p.then(function(offer){",
+    '        offer.sdp=offer.sdp.split(String.fromCharCode(10)).filter(function(l){return l.indexOf("typ host")<0}).join(String.fromCharCode(10));',
+    "        return offer;});",
+    "    };",
+    "  }catch(e){}",
+    // 3d. Chrome object depth (d24): automation fakes usually only set
+    //     window.chrome = {}; deep checks hit app.run/runtime/csi/loadTimes.
+    "  try{",
+    "    if(window.chrome){",
+    '      if(!window.chrome.app||!window.chrome.app.run)window.chrome.app={run:function(){},load:function(){},getDetails:function(){return null},InstallState:{DISABLED:"disabled",INSTALLED:"installed",NOT_INSTALLED:"not_installed"},RunningState:{CANNOT_RUN:"cannot_run",READY_TO_RUN:"ready_to_run",RUNNING:"running"}};',
+    '      if(!window.chrome.runtime)window.chrome.runtime={OnInstalledReason:{CHROME_UPDATE:"chrome_update",INSTALL:"install",UPDATE:"update"},PlatformOs:{ANDROID:"android",CROS:"cros",LINUX:"linux",MAC:"mac",OPENBSD:"openbsd",WIN:"win"},connect:function(){},sendMessage:function(){},id:undefined};',
+    "      if(!window.chrome.csi)window.chrome.csi=function(){return{};}",
+    "      if(!window.chrome.loadTimes)window.chrome.loadTimes=function(){return{};}",
+    "    }",
+    "  }catch(e){}",
+    // 3e. Font availability patch (d25): headless Chromium misses some system
+    //     fonts (e.g. Menlo on macOS) that real Chrome has. Register a FontFace
+    //     aliasing the missing font to a local() equivalent so offsetWidth-based
+    //     font probing sees the same availability as the faked environment.
+    "  try{",
+    '    var _fontAliases=[["Menlo","Courier New"],["SF Mono","Menlo"],["Segoe UI","Helvetica"]];',
+    "    _fontAliases.forEach(function(pa){",
+    '      try{var ff=new FontFace(pa[0],"local("+JSON.stringify(pa[1])+")");',
+    "        document.fonts.add(ff);ff.load();}catch(e2){}",
+    "    });",
+    "  }catch(e){}",
+    // 3. toString disguise (name-list based)
+    "  var _ts=Function.prototype.toString;",
+    "  var _hf=document.hasFocus;",
+    "  Function.prototype.toString=function(){",
+    '    if(this===_ael)return"function addEventListener(type, callback) { [native code] }";',
+    '    if(this===_hf)return"function hasFocus() { [native code] }";',
+    '    if(this===_gw)return"function get width() { [native code] }";',
+    '    if(this===_gh)return"function get height() { [native code] }";',
+    '    if(this===_gah)return"function get availHeight() { [native code] }";',
+    '    if(this===CanvasRenderingContext2D.prototype.fillText)return"function fillText() { [native code] }";',
+    '    if(this===HTMLCanvasElement.prototype.toDataURL)return"function toDataURL() { [native code] }";',
+    '    if(this===AnalyserNode.prototype.getFloatFrequencyData)return"function getFloatFrequencyData() { [native code] }";',
+    '    if(this===AudioBuffer.prototype.getChannelData)return"function getChannelData() { [native code] }";',
+    "    return _ts.call(this);",
+    "  };",
+    // 4. onclick prototype hijack (dual-stream consistency)
+    "  var _ba=function(k,p){",
+    '    if(p==="isTrusted")return k.isTrusted;',
+    '    if((p==="clientX"||p==="clientY")&&k.type==="click"&&Number.isInteger(k[p])&&k.isTrusted===true){',
+    "      var _f=((k.timeStamp||Date.now())%89)/89*0.7+0.15;return k[p]+_f;",
+    "    }",
+    '    var v=Reflect.get(k,p);return typeof v==="function"?v.bind(k):v;',
+    "  };",
+    '  Object.defineProperty(Document.prototype,"onclick",{',
+    "    configurable:true,",
+    "    get:function(){var raw=this.__ocRaw||null;if(!raw)return null;var self=this;",
+    "      return function(e){return raw.call(self,new Proxy(e,{get:function(k,p){return _ba(k,p)}}))}},",
+    "    set:function(fn){this.__ocRaw=fn}",
+    "  });",
+    "})()"
+  ].join("\n");
+}
+
 // src/cdp-driver/mouse.ts
 var XBMouseImpl = class {
   conn;
@@ -40,18 +322,46 @@ var XBMouseImpl = class {
   }
   async click(x, y, opts = {}) {
     const button = opts.button ?? "left";
-    const clickCount = opts.clickCount ?? 1;
-    const delay = opts.delay ?? 0;
-    await this.move(x, y);
-    await this.down({ button });
-    if (delay > 0) {
-      await sleep(delay);
+    const stealth = opts.stealth ?? process.env.XBROWSER_STEALTH !== "off";
+    let tx = x, ty = y;
+    if (stealth && opts.elementWidth !== void 0 && opts.elementHeight !== void 0) {
+      const off = landingOffset(opts.elementWidth, opts.elementHeight);
+      tx += off.dx;
+      ty += off.dy;
+    }
+    if (stealth) {
+      const traj = bezierTrajectory(this._x, this._y, tx, ty);
+      const _tb = Date.now();
+      let _truncated = false;
+      for (const p of traj) {
+        if (Date.now() - _tb > 5e3) {
+          _truncated = true;
+          break;
+        }
+        await this.send("Input.dispatchMouseEvent", { type: "mouseMoved", x: p.x, y: p.y, button: this._button });
+        this._x = p.x;
+        this._y = p.y;
+        await sleep(p.delay);
+      }
+      this._x = tx;
+      this._y = ty;
+      if (_truncated) {
+        await this.send("Input.dispatchMouseEvent", { type: "mouseMoved", x: tx, y: ty, button: this._button });
+      }
+      await sleep(rand(...DEFAULT_STEALTH_CONFIG.aimPause));
+    } else {
+      await this.move(tx, ty);
     }
-    await this.up({ button });
-    for (let i = 1; i < clickCount; i++) {
-      if (delay > 0) await sleep(delay);
+    await this.down({ button });
+    await sleep(stealth ? rand(...DEFAULT_STEALTH_CONFIG.pressDuration) : opts.delay ?? 0);
+    const rx = stealth ? this._x + rand(...DEFAULT_STEALTH_CONFIG.releaseDrift) * (Math.random() < 0.5 ? -1 : 1) : this._x;
+    const ry = stealth ? this._y + rand(...DEFAULT_STEALTH_CONFIG.releaseDrift) * (Math.random() < 0.5 ? -1 : 1) : this._y;
+    this._x = rx;
+    this._y = ry;
+    await this.send("Input.dispatchMouseEvent", { type: "mouseReleased", x: rx, y: ry, button, clickCount: opts.clickCount ?? 1 });
+    for (let i = 1; i < (opts.clickCount ?? 1); i++) {
+      if (opts.delay) await sleep(opts.delay);
       await this.down({ button });
-      if (delay > 0) await sleep(delay);
       await this.up({ button });
     }
   }
@@ -142,12 +452,20 @@ var XBKeyboardImpl = class {
     }
     await this.dispatchKeyEvent(downParams);
     if (mapping.text) {
+      if (process.env.XBROWSER_STEALTH !== "off") {
+        await sleep2(rand(...DEFAULT_STEALTH_CONFIG.keyPressDuration));
+      }
       await this.dispatchKeyEvent({
         type: "char",
         text: mapping.text
       });
     }
     if (delay > 0) await sleep2(delay);
+    else {
+      if (process.env.XBROWSER_STEALTH !== "off") {
+        await sleep2(rand(...DEFAULT_STEALTH_CONFIG.keyPressDuration));
+      }
+    }
     const upParams = {
       type: "keyUp",
       key: mapping.key,
@@ -230,7 +548,7 @@ var XBKeyboardImpl = class {
   }
 };
 function resolveKeyMapping(key) {
-  if (KEY_MAP[key]) return KEY_MAP[key];
+  if (KEY_MAP2[key]) return KEY_MAP2[key];
   if (key.length === 1) {
     const lower = key.toLowerCase();
     if (lower >= "a" && lower <= "z") {
@@ -247,7 +565,7 @@ function resolveKeyMapping(key) {
   }
   return { key, code: key };
 }
-var KEY_MAP = {
+var KEY_MAP2 = {
   Enter: { key: "Enter", code: "Enter", text: "\r", keyCode: 13 },
   Tab: { key: "Tab", code: "Tab", text: "	", keyCode: 9 },
   Escape: { key: "Escape", code: "Escape", keyCode: 27 },
@@ -283,96 +601,57 @@ function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-// src/cdp-driver/selector-utils.ts
-function queryJS(selector) {
-  if (selector.startsWith("xpath=")) {
-    const xpath = JSON.stringify(selector.slice(6));
-    return `document.evaluate(${xpath}, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue`;
-  }
-  if (selector.startsWith("text=")) {
-    const raw = selector.slice(5);
-    const exact = raw.startsWith('"') && raw.endsWith('"');
-    const text = exact ? raw.slice(1, -1) : raw;
-    return `(() => {
-      const target = ${JSON.stringify(text)};
-      const exact = ${exact};
-      const els = [...document.querySelectorAll('*')].filter(e => {
-        if (e.children.length > 0) return false;
-        if (e.offsetParent === null) return false;
-        const t = (e.textContent || '').trim();
-        if (!t) return false;
-        return exact ? t === target : t.toLowerCase().includes(target.toLowerCase());
-      });
-      return els[0] || null;
-    })()`;
-  }
-  if (selector.startsWith("popup-text=")) {
-    const text = selector.slice("popup-text=".length);
-    return `(() => {
-      const target = ${JSON.stringify(text)};
-      const els = [...document.querySelectorAll('*')].filter(e => {
-        if (e.children.length > 0) return false;
-        if (e.offsetParent === null) return false;
-        if ((e.textContent || '').trim() !== target) return false;
-        return true;
-      });
-      return els[0] || null;
-    })()`;
-  }
-  return `document.querySelector(${JSON.stringify(selector)})`;
-}
-function queryAllJS(selector) {
-  if (selector.startsWith("xpath=")) {
-    const xpath = JSON.stringify(selector.slice(6));
-    return `(() => { const it = document.evaluate(${xpath}, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null); const r=[]; for(let i=0;i<it.snapshotLength;i++) r.push(it.snapshotItem(i)); return r; })()`;
-  }
-  if (selector.startsWith("text=") || selector.startsWith("popup-text=")) {
-    return `(() => { const el = ${queryJS(selector)}; return el ? [el] : []; })()`;
-  }
-  return `document.querySelectorAll(${JSON.stringify(selector)})`;
-}
-
 // src/cdp-driver/actionability.ts
 async function waitForActionable(page, selector, opts = {}) {
   const timeout = opts.timeout ?? 3e4;
   if (opts.force) {
-    if (selector.startsWith("xpath=")) {
-      const rect2 = await page.evaluate(`
+    const deadline2 = Date.now() + timeout;
+    let lastError;
+    while (Date.now() < deadline2) {
+      const rect = 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 };
+          let x = r.x, y = r.y;
+          let doc = el.ownerDocument;
+          while (doc !== document) {
+            let host = null;
+            const scan = (d) => {
+              let frames;
+              try { frames = d.querySelectorAll('iframe'); } catch (e) { return null; }
+              for (const f of frames) {
+                let inner = null;
+                try { inner = f.contentDocument; } catch (e) { continue; }
+                if (!inner) continue;
+                if (inner === doc) return f;
+                const rr = scan(inner);
+                if (rr) return rr;
+              }
+              return null;
+            };
+            host = scan(document);
+            if (!host) break;
+            const hr = host.getBoundingClientRect();
+            x += hr.x; y += hr.y;
+            doc = host.ownerDocument;
+          }
+          return { x, y, width: r.width, height: r.height };
         })()
-      `);
-      if (!rect2) throw new Error(`Element not found: ${selector}`);
-      return { nodeId: 0, rect: rect2 };
-    }
-    const deadline2 = Date.now() + timeout;
-    let lastError;
-    let nodeId = 0;
-    let rect = null;
-    while (Date.now() < deadline2) {
-      nodeId = await page.querySelector(selector);
-      if (!nodeId) {
-        lastError = `Element not found: ${selector}`;
-        await page.waitForTimeout(200);
-        continue;
-      }
-      rect = await page.getBoxModel(nodeId);
-      if (rect) break;
-      lastError = `Element has no box: ${selector}`;
-      await page.waitForTimeout(500);
+      `).catch(() => null);
+      if (rect && rect.width > 0 && rect.height > 0) return { nodeId: 0, rect };
+      lastError = `Element not visible (zero size): ${selector}`;
+      lastError = `Element not found: ${selector}`;
+      await page.waitForTimeout(200);
     }
-    if (!rect) throw new Error(lastError || `Element has no box: ${selector}`);
-    return { nodeId, rect };
+    throw new Error(lastError || `Element not found: ${selector}`);
   }
   const deadline = Date.now() + timeout;
   while (Date.now() < deadline) {
     const result = await checkActionable(page, selector);
     if (result.ok && result.rect) {
-      const nodeId = await page.querySelector(selector);
-      if (nodeId) return { nodeId, rect: result.rect };
+      const nodeId = await page.querySelector(selector).catch(() => 0) ?? 0;
+      return { nodeId, rect: result.rect };
     }
     await page.waitForTimeout(50);
   }
@@ -405,12 +684,25 @@ async function checkActionable(page, selector) {
         return { ok: false, reason: 'parent_disabled' };
       }
 
-      // Check not covered by another element at center
+      // Check not covered by another element at center.
+      // elementFromPoint must run in the element's OWN document: for iframe-
+      // internal elements the main-document hit-test returns the <iframe>
+      // host itself, which falsely reports "covered" (rec-duel d01).
+      // For shadow-internal elements the hit-test retargets to the shadow
+      // HOST \u2014 walk the host chain before declaring coverage (rec-duel d04).
       const cx = rect.x + rect.width / 2;
       const cy = rect.y + rect.height / 2;
-      const topEl = document.elementFromPoint(cx, cy);
+      const topEl = el.ownerDocument.elementFromPoint(cx, cy);
       if (topEl && topEl !== el && !el.contains(topEl) && !topEl.contains(el)) {
-        return { ok: false, reason: 'covered', rect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height } };
+        let hostChain = [];
+        let rootNode = el.getRootNode();
+        while (rootNode && rootNode.host) {
+          hostChain.push(rootNode.host);
+          rootNode = rootNode.host.getRootNode();
+        }
+        if (!hostChain.includes(topEl)) {
+          return { ok: false, reason: 'covered', rect: { x: rect.x, y: rect.y, width: rect.width, height: rect.height } };
+        }
       }
 
       return {
@@ -455,21 +747,48 @@ var XBLocatorImpl = class _XBLocatorImpl {
         const el = ${this._q(this.selector)};
         if (!el) return null;
         const rect = el.getBoundingClientRect();
-        return { x: rect.x, y: rect.y, width: rect.width, height: rect.height };
+        let x = rect.x, y = rect.y;
+        let doc = el.ownerDocument;
+        while (doc !== document) {
+          let host = null;
+          const scan = (d) => {
+            let frames;
+            try { frames = d.querySelectorAll('iframe'); } catch (e) { return null; }
+            for (const f of frames) {
+              let inner = null;
+              try { inner = f.contentDocument; } catch (e) { continue; }
+              if (!inner) continue;
+              if (inner === doc) return f;
+              const r = scan(inner);
+              if (r) return r;
+            }
+            return null;
+          };
+          host = scan(document);
+          if (!host) break;
+          const hr = host.getBoundingClientRect();
+          x += hr.x; y += hr.y;
+          doc = host.ownerDocument;
+        }
+        return { x, y, width: rect.width, height: rect.height };
       })()
     `);
     const finalRect = updatedRect ?? rect;
     const cx = finalRect.x + finalRect.width / 2;
     const cy = finalRect.y + finalRect.height / 2;
     await this.page.mouse.click(cx, cy, {
-      button: opts.button ?? "left",
-      clickCount: opts.clickCount ?? 1,
-      delay: opts.delay
+      stealth: true,
+      elementWidth: finalRect.width,
+      elementHeight: finalRect.height,
+      ...{ button: opts.button ?? "left", clickCount: opts.clickCount ?? 1, delay: opts.delay }
     });
   }
   async fill(value, opts = {}) {
     await waitForActionable(this.page, this.selector, opts);
     await scrollIntoView(this.page, this.selector);
+    await this.click({ ...opts });
+    await this.page.keyboard.type(value, { stealth: true });
+    return;
     await this.page.evaluate(`
       (function() {
         const el = ${this._q(this.selector)};
@@ -1179,6 +1498,8 @@ var XBPageImpl = class _XBPageImpl {
     await this.conn.send("Page.enable", void 0, this.sessionId);
     await this.conn.send("Runtime.enable", void 0, this.sessionId);
     await this.conn.send("Network.enable", void 0, this.sessionId);
+    await this.conn.send("DOM.enable", void 0, this.sessionId).catch(() => {
+    });
     this.setupPageEvents();
     this.setupNetworkEvents();
     this.setupConsoleEvents();
@@ -1191,6 +1512,9 @@ var XBPageImpl = class _XBPageImpl {
       );
       this._url = info.url;
       this._title = info.title;
+      if (info.url && info.url !== "about:blank" && info.url !== "") {
+        this._loadState = { loadFired: true, domContentFired: true, networkIdle: true };
+      }
     } catch {
     }
   }
@@ -1203,6 +1527,16 @@ var XBPageImpl = class _XBPageImpl {
     const waitUntil = opts.waitUntil ?? "load";
     const timeout = opts.timeout ?? 3e4;
     this._loadState = { loadFired: false, domContentFired: false, networkIdle: false };
+    if (process.env.XBROWSER_STEALTH !== "off") {
+      try {
+        await this.conn.send(
+          "Page.addScriptToEvaluateOnNewDocument",
+          { source: buildStealthInitScript() },
+          this.sessionId
+        );
+      } catch {
+      }
+    }
     const result = await this.conn.send(
       "Page.navigate",
       { url, referrer: opts.referer },
@@ -1410,6 +1744,91 @@ Last error: ${lastError.message}` : "";
     }
     return result.result?.value;
   }
+  /**
+   * 在指定 iframe 上下文中执行表达式（攻防 D16 能力建设，2026-08-19）。
+   *
+   * 双路径：
+   *  1. 同进程 iframe —— Runtime.enable 收集 executionContextCreated，
+   *     找到目标 frameId 的 contextId，用 contextId 定向执行；
+   *  2. 跨域 OOPIF（独立 target）—— Target.setAutoAttach(flatten) 监听
+   *     attachedToTarget 中 type==='iframe' 的会话，用其 sessionId 执行。
+   *
+   * 这绕过了页面同源策略（那是页面 JS 的约束，CDP 是调试通道）——
+   * 支付窗/验证码/第三方嵌入内容的读写都靠它。
+   */
+  async evaluateInFrame(urlIncludes, expression) {
+    if (this._closed) throw new Error("Page is closed");
+    const evalIn = async (sessionId, contextId) => {
+      const params = { expression, returnByValue: true, awaitPromise: true };
+      if (contextId !== void 0) params.contextId = contextId;
+      const result = await this.conn.send("Runtime.evaluate", params, sessionId);
+      if (result.exceptionDetails) {
+        const detail = result.exceptionDetails.exception?.description ?? result.exceptionDetails.exception?.value ?? result.exceptionDetails.text;
+        throw new Error(`[frame ${urlIncludes}] ${detail}`);
+      }
+      return result.result?.value;
+    };
+    try {
+      const tg = await this.conn.send("Target.getTargets", void 0);
+      const hit2 = (tg.targetInfos || []).find((t) => t.type === "iframe" && (t.url || "").includes(urlIncludes));
+      if (hit2) {
+        const att = await this.conn.send("Target.attachToTarget", { targetId: hit2.targetId, flatten: true });
+        return evalIn(att.sessionId);
+      }
+    } catch {
+    }
+    const tree = await this.conn.send("Page.getFrameTree", void 0, this.sessionId);
+    const all = [];
+    const walk = (node) => {
+      all.push({ id: node.frame.id, url: node.frame.url });
+      for (const child of node.childFrames || []) walk(child);
+    };
+    walk(tree.frameTree);
+    const mainId = tree.frameTree?.frame?.id;
+    const target = all.find((f) => f.id !== mainId && f.url.includes(urlIncludes));
+    if (target) {
+      const contexts = [];
+      const onCtx = (raw) => {
+        const c = raw?.context;
+        if (c?.id && c?.auxData?.frameId) contexts.push({ id: c.id, frameId: c.auxData.frameId });
+      };
+      this.conn.on("Runtime.executionContextCreated", onCtx);
+      try {
+        await this.conn.send("Runtime.enable", void 0, this.sessionId).catch(() => {
+        });
+        await new Promise((r) => setTimeout(r, 400));
+      } finally {
+        this.conn.off("Runtime.executionContextCreated", onCtx);
+      }
+      const ctx = contexts.find((c) => c.frameId === target.id);
+      if (ctx) return evalIn(this.sessionId, ctx.id);
+    }
+    const attached = [];
+    const onAttach = (raw) => {
+      const ev = raw;
+      if (ev?.sessionId && ev.targetInfo?.type === "iframe") {
+        attached.push({ sessionId: ev.sessionId, url: ev.targetInfo.url || "" });
+      }
+    };
+    this.conn.on("Target.attachedToTarget", onAttach);
+    try {
+      await this.conn.send("Target.setAutoAttach", {
+        autoAttach: true,
+        waitForDebuggerOnStart: false,
+        flatten: true
+      }, this.sessionId);
+      await new Promise((r) => setTimeout(r, 600));
+    } finally {
+      this.conn.off("Target.attachedToTarget", onAttach);
+      this.conn.send("Target.setAutoAttach", { autoAttach: false, waitForDebuggerOnStart: false, flatten: true }, this.sessionId).catch(() => {
+      });
+    }
+    const hit = attached.find((a) => a.url.includes(urlIncludes));
+    if (!hit) {
+      throw new Error(`frame not found for "${urlIncludes}"\uFF08OOPIF target\u3001frame \u6811\u3001auto-attach \u4E09\u8DEF\u5747\u672A\u547D\u4E2D\uFF1B\u53EF\u80FD\u4ECD\u5728\u52A0\u8F7D\uFF09`);
+    }
+    return evalIn(hit.sessionId);
+  }
   /** evaluateHandle — evaluates fn and returns a handle for element bounding box */
   async evaluateHandle(fn, ...args) {
     let expression;
@@ -1654,6 +2073,10 @@ Last error: ${lastError.message}` : "";
       this.sessionId
     );
   }
+  /** 覆盖 User-Agent（headless 环境对抗 UA 检测的标配能力） */
+  async setUserAgent(userAgent) {
+    await this._setUserAgent(userAgent);
+  }
   /** Internal: set extra HTTP headers */
   async _setExtraHTTPHeaders(headers) {
     await this.setExtraHTTPHeaders(headers);
@@ -1780,16 +2203,21 @@ Last error: ${lastError.message}` : "";
       }
       return 1;
     }
-    const doc = await this.conn.send(
-      "DOM.getDocument",
-      { depth: 0 },
-      this.sessionId
+    const withTimeout = (p, ms) => Promise.race([p, new Promise((r) => setTimeout(() => r(null), ms))]);
+    const doc = await withTimeout(
+      this.conn.send("DOM.getDocument", { depth: 0 }, this.sessionId),
+      8e3
     );
-    const result = await this.conn.send(
-      "DOM.querySelector",
-      { nodeId: doc.root.nodeId, selector },
-      this.sessionId
+    if (!doc) return 0;
+    const result = await withTimeout(
+      this.conn.send(
+        "DOM.querySelector",
+        { nodeId: doc.root.nodeId, selector },
+        this.sessionId
+      ),
+      8e3
     );
+    if (!result) return 0;
     return result.nodeId;
   }
   /** Query all matching elements, returns array of CDP nodeIds */
@@ -2587,7 +3015,7 @@ var XBBrowserImpl = class {
       this._exitHandler = null;
     }
     if (this.childProcess) {
-      const { killChrome: killChrome2 } = await import("./launcher-OZXJQPNG.js");
+      const { killChrome: killChrome2 } = await import("./launcher-L2JNDB2H.js");
       await killChrome2(this.childProcess, this.tmpDir);
     }
     await this.conn.close();
@@ -2722,7 +3150,7 @@ var XBBrowserImpl = class {
     if (pageTargets.length === 0 && httpFallbackUrl) {
       console.log(`[discoverContexts] Target.getTargets returned ${targetInfos.length} targets (0 page type). Falling back to HTTP /json/list at ${httpFallbackUrl}`);
       try {
-        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-OZXJQPNG.js");
+        const { getCDPTargets: getCDPTargets2 } = await import("./launcher-L2JNDB2H.js");
         const httpPages = await getCDPTargets2(httpFallbackUrl);
         console.log(`[discoverContexts] HTTP /json/list returned ${httpPages.length} pages`);
         for (const p of httpPages) {
@@ -2778,9 +3206,971 @@ var XBBrowserImpl = class {
 // src/cdp-driver/connection.ts
 import { EventEmitter as EventEmitter4 } from "events";
 import { WebSocket } from "ws";
-var CDPConnection = class extends EventEmitter4 {
+
+// src/cdp-interceptor/rules/shared.ts
+var PLAYWRIGHT_INTERNAL_MARKERS = [
+  "__commonJS",
+  "module.exports",
+  "__require",
+  "__toESM",
+  "inject_utils"
+];
+function isPlaywrightInternal(code) {
+  return PLAYWRIGHT_INTERNAL_MARKERS.some((marker) => code.includes(marker));
+}
+function extractUserCode(ctx) {
+  if (ctx.method === "Runtime.evaluate") {
+    const expr = ctx.params.expression;
+    if (typeof expr === "string") {
+      if (isPlaywrightInternal(expr)) return null;
+      return expr;
+    }
+  }
+  if (ctx.method === "Runtime.callFunctionOn") {
+    const decl = ctx.params.functionDeclaration;
+    if (typeof decl === "string" && decl.includes("utilityScript.evaluate")) {
+      return extractAllStrings(ctx.params.arguments);
+    }
+    if (typeof decl === "string") return decl;
+  }
+  return null;
+}
+function extractAllStrings(rawArgs) {
+  if (!Array.isArray(rawArgs)) return null;
+  const strings = [];
+  for (const arg of rawArgs) {
+    if (arg && typeof arg === "object" && "value" in arg) {
+      const val = arg.value;
+      if (typeof val === "string" && val.length > 5 && !["true", "false"].includes(val)) {
+        strings.push(val);
+      }
+    }
+  }
+  return strings.length > 0 ? strings.join("\n") : null;
+}
+
+// src/cdp-interceptor/rules/dom-mutation.ts
+var DOM_PATTERNS = [
+  // ── P0: Value/Checked (bypasses React onChange) ────────────
+  { pattern: /\.value\s*=\s*(?!["'\s]*$)/, name: ".value =", severity: "danger", action: "pass", errorCode: -32001, suggestion: "Use page.fill(selector, value) which dispatches proper input/change events." },
+  { pattern: /\.checked\s*=\s*(?:true|false)/, name: ".checked =", severity: "danger", action: "pass", errorCode: -32001, suggestion: "Use page.check(selector) or page.uncheck(selector)." },
+  { pattern: /\.indeterminate\s*=\s*true/, name: ".indeterminate =", severity: "warn", action: "pass", errorCode: -32021, suggestion: "No human can set indeterminate state \u2014 remove this call." },
+  { pattern: /\.valueAsDate\s*=/, name: ".valueAsDate =", severity: "warn", action: "pass", errorCode: -32022, suggestion: "Use page.fill() with formatted date string instead." },
+  { pattern: /\.valueAsNumber\s*=/, name: ".valueAsNumber =", severity: "warn", action: "pass", errorCode: -32022, suggestion: "Use page.fill() with numeric string instead." },
+  // ── P1: Select/Option (bypasses React onChange on select) ─
+  { pattern: /\.selectedIndex\s*=\s*\d+/, name: ".selectedIndex =", severity: "danger", action: "pass", errorCode: -32003, suggestion: "Use page.selectOption(selector, value)." },
+  { pattern: /(?:options|children)\s*\[[^\]]*\]\s*\.\s*selected\s*=\s*(?:true|false)/, name: "options[N].selected =", severity: "danger", action: "pass", errorCode: -32003, suggestion: "Use page.selectOption(selector, value)." },
+  { pattern: /\.value\s*=\s*["'][^"']*["']\s*[;)]?\s*$/, name: "selectElement.value =", severity: "warn", action: "pass", errorCode: -32023, suggestion: "For select elements, use page.selectOption(selector, value)." },
+  // ── P2: Content properties (bypasses virtual DOM diffing) ──
+  { pattern: /\.innerHTML\s*=/, name: ".innerHTML =", severity: "info", action: "pass", errorCode: -32007, suggestion: ".innerHTML bypasses React/Vue diffing. Use component state or page.setContent()." },
+  { pattern: /\.outerHTML\s*=/, name: ".outerHTML =", severity: "info", action: "pass", errorCode: -32007, suggestion: "outerHTML replacement destroys React fiber tree. Use page.setContent()." },
+  { pattern: /\.innerText\s*=/, name: ".innerText =", severity: "warn", action: "pass", errorCode: -32024, suggestion: "Framework components should be updated via state, not innerText." },
+  { pattern: /\.textContent\s*=/, name: ".textContent =", severity: "warn", action: "pass", errorCode: -32024, suggestion: "textContent bypasses React/Vue diffing. Use component state instead." },
+  { pattern: /\.outerText\s*=/, name: ".outerText =", severity: "warn", action: "pass", errorCode: -32024, suggestion: "Non-standard property \u2014 use proper framework update methods." },
+  { pattern: /nodeValue\s*=/, name: "node.nodeValue =", severity: "info", action: "pass", errorCode: -32025, suggestion: "Direct text node mutation. Use textContent instead if needed." },
+  // ── P3: Style properties ──────────────────────────────────
+  { pattern: /\.style\s*=\s*["']/, name: ".style = (string override)", severity: "info", action: "pass", errorCode: -32008, suggestion: 'Setting style as a string overwrites CSSStyleDeclaration. Use element.style.prop = "value".' },
+  { pattern: /\.style\.cssText\s*=/, name: ".style.cssText =", severity: "info", action: "pass", errorCode: -32008, suggestion: "style.cssText replacement destroys inline styles \u2014 use individual property set." },
+  { pattern: /\.style\.setProperty\s*\(/, name: ".style.setProperty()", severity: "info", action: "pass", errorCode: -32008, suggestion: "Direct style property set bypasses CSS transitions." },
+  { pattern: /\.style\.removeProperty\s*\(/, name: ".style.removeProperty()", severity: "info", action: "pass", errorCode: -32026, suggestion: "Style removal without user interaction is suspicious." },
+  { pattern: /\.style\.animation\s*=/, name: ".style.animation =", severity: "info", action: "pass", errorCode: -32027, suggestion: "Forcing animation state via CDP is detectable." },
+  { pattern: /\.style\.transition\s*=/, name: ".style.transition =", severity: "info", action: "pass", errorCode: -32027, suggestion: "Manipulating CSS transitions is rare in normal browsing." },
+  // ── P4: Class/Attribute properties ────────────────────────
+  { pattern: /\.className\s*=/, name: ".className =", severity: "info", action: "pass", errorCode: -32009, suggestion: "Use component state or a Playwright locator instead." },
+  { pattern: /\.classList\.add\s*\(/, name: ".classList.add()", severity: "info", action: "pass", errorCode: -32009, suggestion: "classList manipulation via CDP bypasses framework state tracking." },
+  { pattern: /\.classList\.remove\s*\(/, name: ".classList.remove()", severity: "info", action: "pass", errorCode: -32009, suggestion: "Use component state or attribute selectors instead." },
+  { pattern: /\.classList\.toggle\s*\(/, name: ".classList.toggle()", severity: "info", action: "pass", errorCode: -32009, suggestion: "Toggle without user interaction is detectable." },
+  { pattern: /\.classList\.replace\s*\(/, name: ".classList.replace()", severity: "info", action: "pass", errorCode: -32028, suggestion: "Rare operation \u2014 likely automated." },
+  // ── P5: Attribute manipulation ────────────────────────────
+  { pattern: /\.setAttribute\s*\(/, name: ".setAttribute()", severity: "info", action: "pass", errorCode: -32010, suggestion: "setAttribute bypasses framework attribute tracking. Use component state." },
+  { pattern: /\.removeAttribute\s*\(/, name: ".removeAttribute()", severity: "info", action: "pass", errorCode: -32010, suggestion: "Attribute removal without user interaction is suspicious." },
+  { pattern: /\.toggleAttribute\s*\(/, name: ".toggleAttribute()", severity: "info", action: "pass", errorCode: -32029, suggestion: "Attribute toggling via CDP is detectable." },
+  { pattern: /\.dataset\.\w+\s*=/, name: ".dataset.* =", severity: "info", action: "pass", errorCode: -32030, suggestion: "dataset mutations via evaluate bypass native mutation observers." },
+  // ── P6: Focus/Selection properties ────────────────────────
+  { pattern: /\.selectionStart\s*=/, name: ".selectionStart =", severity: "info", action: "pass", errorCode: -32011, suggestion: "Setting cursor position without focus is detectable." },
+  { pattern: /\.selectionEnd\s*=/, name: ".selectionEnd =", severity: "info", action: "pass", errorCode: -32011, suggestion: "Selection range manipulation without user input is suspicious." },
+  { pattern: /\.selectionDirection\s*=/, name: ".selectionDirection =", severity: "info", action: "pass", errorCode: -32031, suggestion: "Selection direction changes normally via mouse drag." },
+  // ── P7: Boolean properties ────────────────────────────────
+  { pattern: /\.disabled\s*=/, name: ".disabled =", severity: "info", action: "pass", errorCode: -32012, suggestion: "Disabling elements via CDP mid-interaction is detectable." },
+  { pattern: /\.readOnly\s*=/, name: ".readOnly =", severity: "info", action: "pass", errorCode: -32032, suggestion: "readOnly changes without user action." },
+  { pattern: /\.hidden\s*=/, name: ".hidden =", severity: "info", action: "pass", errorCode: -32012, suggestion: "Hiding elements is a common scraper tactic \u2014 detectable." },
+  { pattern: /\.required\s*=/, name: ".required =", severity: "info", action: "pass", errorCode: -32032, suggestion: "Validation constraint changes mid-session." },
+  { pattern: /\.multiple\s*=/, name: ".multiple =", severity: "info", action: "pass", errorCode: -32032, suggestion: "Multiple attribute toggle is rare in normal browsing." },
+  { pattern: /\.autofocus\s*=/, name: ".autofocus =", severity: "info", action: "pass", errorCode: -32032, suggestion: "autofocus changes mid-session are suspicious." },
+  // ── P8: Frame/Navigation properties ───────────────────────
+  { pattern: /\.src\s*=/, name: ".src = (on img/iframe/script)", severity: "info", action: "pass", errorCode: -32013, suggestion: "Changing src via CDP bypasses user interaction. Use page.click() on the element." },
+  { pattern: /\.href\s*=/, name: ".href =", severity: "info", action: "pass", errorCode: -32033, suggestion: "Changing anchor href via evaluate \u2014 use page.click() instead." },
+  { pattern: /\.action\s*=/, name: "form.action =", severity: "info", action: "pass", errorCode: -32034, suggestion: "Changing form action URL is highly suspicious." },
+  { pattern: /\.method\s*=/, name: "form.method =", severity: "info", action: "pass", errorCode: -32034, suggestion: "Form method changes without user interaction." },
+  { pattern: /\.target\s*=/, name: "link/area.target =", severity: "info", action: "pass", errorCode: -32034, suggestion: "Link target manipulation via CDP." },
+  // ── P9: Media properties ──────────────────────────────────
+  { pattern: /\.currentTime\s*=/, name: "media.currentTime = (seeking)", severity: "info", action: "pass", errorCode: -32014, suggestion: "Video seeking without user interaction \u2014 common scraper pattern." },
+  { pattern: /\.playbackRate\s*=/, name: "media.playbackRate =", severity: "info", action: "pass", errorCode: -32014, suggestion: "Changing playback speed is detectable automation signal." },
+  { pattern: /\.volume\s*=/, name: "media.volume =", severity: "info", action: "pass", errorCode: -32035, suggestion: "Volume setting via evaluate is suspicious." },
+  { pattern: /\.muted\s*=/, name: "media.muted =", severity: "info", action: "pass", errorCode: -32035, suggestion: "Muting media without user click is suspicious." },
+  // ── P10: Element geometry ─────────────────────────────────
+  { pattern: /\.scrollTop\s*=/, name: ".scrollTop =", severity: "info", action: "pass", errorCode: -32015, suggestion: "Programmatic scroll without user gesture. Use page.mouse.wheel()." },
+  { pattern: /\.scrollLeft\s*=/, name: ".scrollLeft =", severity: "info", action: "pass", errorCode: -32015, suggestion: "Horizontal scroll without user gesture." },
+  { pattern: /\.scrollTo\s*\(/, name: ".scrollTo()", severity: "info", action: "pass", errorCode: -32015, suggestion: "ScrollTo bypasses user scroll detection." },
+  { pattern: /\.scrollBy\s*\(/, name: ".scrollBy()", severity: "info", action: "pass", errorCode: -32015, suggestion: "ScrollBy without user gesture." },
+  { pattern: /\.scrollIntoView\s*\(/, name: ".scrollIntoView()", severity: "info", action: "pass", errorCode: -32015, suggestion: "scrollIntoView is a common bot pattern. Let Playwright handle scrolling." },
+  // ── P11: Shadow DOM ───────────────────────────────────────
+  { pattern: /\.shadowRoot\s*=/, name: ".shadowRoot = (override)", severity: "info", action: "pass", errorCode: -32036, suggestion: "ShadowRoot is read-only \u2014 this set attempt is detectable." },
+  // ── P12: Force reflow / layout thrashing ──────────────────
+  { pattern: /\.offsetHeight\b(?!\s*===?\s*)/, name: ".offsetHeight read (forced reflow)", severity: "warn", action: "pass", errorCode: -32016, suggestion: "Reading offsetHeight triggers forced reflow \u2014 anti-crawlers detect this as layout probing." },
+  { pattern: /\.offsetWidth\b(?!\s*===?\s*)/, name: ".offsetWidth read (forced reflow)", severity: "warn", action: "pass", errorCode: -32016, suggestion: "Reading offsetWidth triggers forced reflow \u2014 detectable." },
+  { pattern: /getBoundingClientRect\s*\(/, name: "getBoundingClientRect()", severity: "warn", action: "pass", errorCode: -32037, suggestion: "getBoundingClientRect triggers reflow. Minimize calls." },
+  { pattern: /getComputedStyle\s*\(/, name: "getComputedStyle()", severity: "info", action: "pass", errorCode: -32038, suggestion: "getComputedStyle can trigger style recalculation." },
+  { pattern: /\.clientHeight\b/, name: ".clientHeight read", severity: "info", action: "pass", errorCode: -32038, suggestion: "clientHeight read triggers layout." },
+  { pattern: /\.clientWidth\b/, name: ".clientWidth read", severity: "info", action: "pass", errorCode: -32038, suggestion: "clientWidth read triggers layout." }
+];
+var domMutationRule = {
+  id: "dom-mutation",
+  name: "DOM Property Mutation Detection (50+ setters)",
+  priority: 10,
+  canHandle(ctx) {
+    return ctx.method === "Runtime.evaluate" || ctx.method === "Runtime.callFunctionOn";
+  },
+  evaluate(ctx) {
+    const userCode = extractUserCode(ctx);
+    if (!userCode) return null;
+    for (const p of DOM_PATTERNS) {
+      if (p.pattern.test(userCode)) {
+        return {
+          ruleId: "dom-mutation",
+          action: p.action,
+          severity: p.severity,
+          reason: `Direct DOM property setter: "${p.name}". This bypasses framework event systems and is detectable as automation.`,
+          suggestion: p.suggestion,
+          errorCode: p.errorCode,
+          errorMessage: p.severity === "danger" ? `[CDP Firewall] ${p.name} blocked \u2014 bypasses framework reactivity` : `[CDP Firewall] ${p.name} detected \u2014 use proper interaction API`
+        };
+      }
+    }
+    return null;
+  }
+};
+
+// src/cdp-interceptor/rules/mouse-trajectory.ts
+var TRACKER_KEY = "mouse-trajectory-tracker";
+var MAX_SAMPLES = 200;
+var MIN_SAMPLES_FOR_ANALYSIS = 5;
+var mouseTrajectoryRule = {
+  id: "mouse-trajectory",
+  name: "Mouse Trajectory Analysis",
+  priority: 20,
+  canHandle(ctx) {
+    return ctx.method === "Input.dispatchMouseEvent";
+  },
+  evaluate(ctx) {
+    const type = ctx.params.type;
+    const x = ctx.params.x;
+    const y = ctx.params.y;
+    if (typeof x !== "number" || typeof y !== "number") return null;
+    let tracker = ctx.sessionState.get(TRACKER_KEY);
+    if (!tracker) {
+      tracker = { samples: [], lastMouseDownAt: 0, isDragging: false };
+      ctx.sessionState.set(TRACKER_KEY, tracker);
+    }
+    if (type === "mousePressed") {
+      const priorResult = analyzeTrajectory(tracker.samples);
+      tracker.lastMouseDownAt = Date.now();
+      tracker.isDragging = true;
+      tracker.samples = [];
+      return priorResult;
+    }
+    if (type === "mouseReleased") {
+      tracker.isDragging = false;
+      const result = analyzeTrajectory(tracker.samples);
+      tracker.samples = [];
+      return result;
+    }
+    if (type === "mouseMoved") {
+      const now = Date.now();
+      const prevSample = tracker.samples[tracker.samples.length - 1];
+      const distanceTraveled = prevSample ? prevSample.distanceTraveled + distance(prevSample.x, prevSample.y, x, y) : 0;
+      const sample = { x, y, timestamp: now, distanceTraveled };
+      tracker.samples.push(sample);
+      if (tracker.samples.length > MAX_SAMPLES) {
+        tracker.samples.shift();
+      }
+      return null;
+    }
+    if (type === "mouseReleased" && tracker.samples.length < MIN_SAMPLES_FOR_ANALYSIS) {
+      tracker.samples = [];
+      return null;
+    }
+    return null;
+  }
+};
+function analyzeTrajectory(samples) {
+  if (samples.length < MIN_SAMPLES_FOR_ANALYSIS) return null;
+  const issues = [];
+  const startX = samples[0].x;
+  const startY = samples[0].y;
+  const endX = samples[samples.length - 1].x;
+  const endY = samples[samples.length - 1].y;
+  const lineLength = distance(startX, startY, endX, endY);
+  const collinearityResult = checkCollinearity(samples, startX, startY, endX, endY, lineLength);
+  if (collinearityResult) {
+    issues.push(collinearityResult);
+  }
+  const velocityResult = checkConstantVelocity(samples);
+  if (velocityResult) {
+    issues.push(velocityResult);
+  }
+  const jitterResult = checkJitter(samples);
+  if (jitterResult) {
+    issues.push(jitterResult);
+  }
+  if (issues.length === 0) return null;
+  const stopX = samples[samples.length - 1].x;
+  const stopY = samples[samples.length - 1].y;
+  return {
+    ruleId: "mouse-trajectory",
+    action: "pass",
+    severity: "danger",
+    reason: `Suspicious mouse trajectory: ${issues.join("; ")}`,
+    suggestion: `This mouse movement appears automated (straight line A\u2192B, no natural variation).
+  Use a humanized mouse API that generates:
+  - Bezier curves instead of straight lines
+  - Random acceleration/deceleration
+  - 1-3px micro-jitter per sample
+
+  Example: The 'faker' or 'ghost-cursor' libraries generate realistic mouse paths.
+  Target was: (${Math.round(startX)}, ${Math.round(startY)}) \u2192 (${Math.round(stopX)}, ${Math.round(stopY)})`,
+    errorCode: -32002,
+    errorMessage: "[CDP Firewall] Automated mouse trajectory blocked \u2014 appears non-human"
+  };
+}
+function distance(x1, y1, x2, y2) {
+  return Math.sqrt((x2 - x1) ** 2 + (y2 - y1) ** 2);
+}
+function checkCollinearity(samples, x1, y1, x2, y2, lineLength) {
+  if (lineLength < 5) return null;
+  let maxDeviation = 0;
+  const dx = x2 - x1;
+  const dy = y2 - y1;
+  for (let i = 1; i < samples.length - 1; i++) {
+    const { x, y } = samples[i];
+    const cross = Math.abs(dy * x - dx * y + x2 * y1 - y2 * x1);
+    const dev = cross / lineLength;
+    if (dev > maxDeviation) maxDeviation = dev;
+  }
+  if (maxDeviation < 1.5 && lineLength > 20) {
+    return `Perfectly straight line (max deviation ${maxDeviation.toFixed(1)}px over ${lineLength.toFixed(0)}px)`;
+  }
+  if (maxDeviation < 0.5 && lineLength > 10) {
+    return `Near-perfect straight line (max deviation ${maxDeviation.toFixed(1)}px)`;
+  }
+  return null;
+}
+function checkConstantVelocity(samples) {
+  if (samples.length < 3) return null;
+  const speeds = [];
+  for (let i = 1; i < samples.length; i++) {
+    const d = distance(
+      samples[i - 1].x,
+      samples[i - 1].y,
+      samples[i].x,
+      samples[i].y
+    );
+    const dt = samples[i].timestamp - samples[i - 1].timestamp;
+    if (dt > 0) speeds.push(d / dt);
+  }
+  if (speeds.length < 2) return null;
+  const mean = speeds.reduce((a, b) => a + b, 0) / speeds.length;
+  if (mean === 0) return null;
+  const variance = speeds.reduce((sum, v) => sum + (v - mean) ** 2, 0) / speeds.length;
+  const stddev = Math.sqrt(variance);
+  const cv = stddev / mean;
+  if (cv < 0.05) {
+    return `Constant velocity (CV=${cv.toFixed(3)}, mean=${mean.toFixed(1)} px/ms)`;
+  }
+  return null;
+}
+function checkJitter(samples) {
+  if (samples.length < 4) return null;
+  let totalLateralChange = 0;
+  for (let i = 1; i < samples.length; i++) {
+    const d = distance(
+      samples[i - 1].x,
+      samples[i - 1].y,
+      samples[i].x,
+      samples[i].y
+    );
+    totalLateralChange += d;
+  }
+  const avgLateral = totalLateralChange / (samples.length - 1);
+  if (avgLateral < 0.3) {
+    return "No micro-jitter (sub-pixel precision, impossible for human)";
+  }
+  return null;
+}
+
+// src/cdp-interceptor/rules/input-keystroke.ts
+var TRACKER_KEY2 = "keystroke-tracker";
+var MIN_KEYS_FOR_ANALYSIS = 4;
+var inputKeystrokeRule = {
+  id: "input-keystroke",
+  name: "Input Keystroke Timing Analysis",
+  priority: 40,
+  canHandle(ctx) {
+    return ctx.method === "Input.dispatchKeyEvent" || ctx.method === "Input.insertText";
+  },
+  evaluate(ctx) {
+    if (ctx.method === "Input.insertText") {
+      return {
+        ruleId: "input-keystroke",
+        action: "pass",
+        severity: "info",
+        reason: "Input.insertText bypasses native keyboard events. Playwright uses this internally for page.fill().",
+        suggestion: "Prefer page.type() with variable delay for human-like input.",
+        errorCode: -32004,
+        errorMessage: "[CDP Firewall] Input.insertText detected \u2014 note: Playwright uses this for fill()"
+      };
+    }
+    let tracker = ctx.sessionState.get(TRACKER_KEY2);
+    if (!tracker) {
+      tracker = { samples: [] };
+      ctx.sessionState.set(TRACKER_KEY2, tracker);
+    }
+    const type = ctx.params.type;
+    const code = ctx.params.code;
+    const key = ctx.params.key;
+    if (type === "keyDown" && key && key.length === 1) {
+      tracker.samples.push({
+        code,
+        key,
+        timestamp: Date.now(),
+        type
+      });
+    }
+    if (tracker.samples.length >= MIN_KEYS_FOR_ANALYSIS && (type === "keyUp" || type === "keyDown")) {
+      return analyzeKeyTiming(tracker.samples);
+    }
+    return null;
+  }
+};
+function analyzeKeyTiming(samples) {
+  if (samples.length < MIN_KEYS_FOR_ANALYSIS) return null;
+  const intervals = [];
+  for (let i = 1; i < samples.length; i++) {
+    const dt = samples[i].timestamp - samples[i - 1].timestamp;
+    if (dt > 0) intervals.push(dt);
+  }
+  if (intervals.length < 3) return null;
+  const mean = intervals.reduce((a, b) => a + b, 0) / intervals.length;
+  if (mean === 0) return null;
+  const variance = intervals.reduce((sum, v) => sum + (v - mean) ** 2, 0) / intervals.length;
+  const stddev = Math.sqrt(variance);
+  const cv = stddev / mean;
+  const uniqueIntervals = new Set(intervals);
+  const allIdentical = uniqueIntervals.size === 1;
+  if (allIdentical) {
+    return {
+      ruleId: "input-keystroke",
+      action: "pass",
+      severity: "danger",
+      reason: `All ${intervals.length} keystroke intervals are exactly ${intervals[0]}ms \u2014 impossible for human typing.`,
+      suggestion: `Use page.fill(selector, text) instead of page.type() with delay.
+Or add random variation: page.type(selector, text, {delay: 50 + Math.random() * 80}).`,
+      errorCode: -32004,
+      errorMessage: "[CDP Firewall] Constant keystroke timing detected \u2014 automated typing pattern"
+    };
+  }
+  if (cv < 0.08) {
+    return {
+      ruleId: "input-keystroke",
+      action: "pass",
+      severity: "warn",
+      reason: `Unnatural keystroke timing (CV=${cv.toFixed(3)}). Human typing has CV > 0.2 on average.`,
+      suggestion: `Add random variation to your typing delay: page.type(selector, text, {delay: 50 + Math.random() * 80}).`,
+      errorCode: -32004,
+      errorMessage: "[CDP Firewall] Suspicious keystroke timing \u2014 likely automated"
+    };
+  }
+  return null;
+}
+
+// src/cdp-interceptor/rules/automation-signals.ts
+var AUTOMATION_PATTERNS = [
+  // ── Playwright markers ─────────────────────────
+  { pattern: /window\s*\.\s*__playwright/, name: "window.__playwright", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__pw_[a-zA-Z]/, name: "window.__pw_*", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__pw_paused/, name: "window.__pw_paused", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*playwright\b/, name: "window.playwright", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__pw_recorder/, name: "window.__pw_recorder", severity: "warn", errorCode: -32041 },
+  { pattern: /window\s*\.\s*__pw_trace/, name: "window.__pw_trace", severity: "warn", errorCode: -32041 },
+  // ── Puppeteer markers ──────────────────────────
+  { pattern: /window\s*\.\s*__puppeteer\b/, name: "window.__puppeteer", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__puppeteer_evaluation_script/, name: "window.__puppeteer_evaluation_script", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__puppeteer_testId/, name: "window.__puppeteer_testId", severity: "warn", errorCode: -32041 },
+  { pattern: /window\s*\.\s*__puppeteer_/, name: "window.__puppeteer_*", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*_puppeteer\b/, name: "window._puppeteer", severity: "warn", errorCode: -32041 },
+  // ── Selenium / WebDriver markers ───────────────
+  { pattern: /window\s*\.\s*__webdriver_script_fn/, name: "window.__webdriver_script_fn", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__selenium\b/, name: "window.__selenium", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__selenium_evaluate/, name: "window.__selenium_evaluate", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__driver_evaluate/, name: "window.__driver_evaluate", severity: "warn", errorCode: -32041 },
+  { pattern: /window\s*\.\s*__webdriver_evaluate/, name: "window.__webdriver_evaluate", severity: "danger", errorCode: -32040 },
+  { pattern: /document\.\$cdc_/, name: "document.$cdc_* (Selenium marker)", severity: "danger", errorCode: -32040 },
+  { pattern: /document\.\$chrome_asyncScriptInfo/, name: "document.$chrome_asyncScriptInfo", severity: "danger", errorCode: -32040 },
+  // ── navigator.webdriver detection ─────────────
+  { pattern: /navigator\s*\.\s*webdriver/, name: "navigator.webdriver read", severity: "danger", errorCode: -32042 },
+  { pattern: /navigator\[["']webdriver["']\]/, name: 'navigator["webdriver"]', severity: "danger", errorCode: -32042 },
+  // ── Chrome headless API surface checks ────────
+  { pattern: /chrome\s*\.\s*app/, name: "chrome.app detection", severity: "danger", errorCode: -32043 },
+  { pattern: /chrome\s*\.\s*runtime/, name: "chrome.runtime detection", severity: "danger", errorCode: -32043 },
+  { pattern: /chrome\s*\.\s*loadTimes/, name: "chrome.loadTimes detection", severity: "warn", errorCode: -32044 },
+  { pattern: /chrome\s*\.\s*csi\b/, name: "chrome.csi detection", severity: "warn", errorCode: -32044 },
+  { pattern: /window\s*\.\s*chrome\b/, name: "window.chrome object probe", severity: "warn", errorCode: -32044 },
+  { pattern: /navigator\s*\.\s*plugins\b/, name: "navigator.plugins enumeration", severity: "warn", errorCode: -32044 },
+  { pattern: /navigator\s*\.\s*mimeTypes/, name: "navigator.mimeTypes enumeration", severity: "warn", errorCode: -32044 },
+  { pattern: /navigator\s*\.\s*hardwareConcurrency/, name: "navigator.hardwareConcurrency", severity: "warn", errorCode: -32044 },
+  { pattern: /navigator\s*\.\s*deviceMemory/, name: "navigator.deviceMemory", severity: "info", errorCode: -32045 },
+  { pattern: /navigator\s*\.\s*maxTouchPoints/, name: "navigator.maxTouchPoints", severity: "warn", errorCode: -32044 },
+  { pattern: /navigator\s*\.\s*languages/, name: "navigator.languages", severity: "info", errorCode: -32045 },
+  { pattern: /navigator\s*\.\s*platform/, name: "navigator.platform", severity: "info", errorCode: -32045 },
+  // ── Anti-detection injection attempts ─────────
+  { pattern: /navigator\.webdriver\s*=\s*(false|undefined|null)/, name: "navigator.webdriver override attempt", severity: "danger", errorCode: -32046, suggestionOverride: "Overriding navigator.webdriver is detectable. Use CDP Page.addScriptToEvaluateOnNewDocument instead." },
+  { pattern: /Object\.defineProperty\s*\([^)]*webdriver/, name: "Object.defineProperty navigator.webdriver", severity: "danger", errorCode: -32046, suggestionOverride: "Object.defineProperty patches are detectable via Function.prototype.toString checks." },
+  { pattern: /delete\s+navigator\s*\.\s*webdriver/, name: "delete navigator.webdriver", severity: "danger", errorCode: -32046, suggestionOverride: "Deleting webdriver flag is detectable \u2014 the delete itself is visible." },
+  // ── PhantomJS / Headless markers ──────────────
+  { pattern: /window\s*\.\s*callPhantom/, name: "window.callPhantom", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*_phantom/, name: "window._phantom", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*phantom\b/, name: "window.phantom", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*Buffer\b/, name: "window.Buffer (Node.js leak)", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*process\b/, name: "window.process (Node.js leak)", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*global\b/, name: "window.global (Node.js leak)", severity: "danger", errorCode: -32040 },
+  { pattern: /window\s*\.\s*__dirname/, name: "window.__dirname (Node.js leak)", severity: "danger", errorCode: -32040 }
+];
+var automationSignalsRule = {
+  id: "automation-signals",
+  name: "Browser Automation Signal Detection (35+ markers)",
+  priority: 20,
+  canHandle(ctx) {
+    return ctx.method === "Runtime.evaluate" || ctx.method === "Runtime.callFunctionOn" || ctx.method === "Page.addScriptToEvaluateOnNewDocument";
+  },
+  evaluate(ctx) {
+    if (ctx.method === "Page.addScriptToEvaluateOnNewDocument") {
+      const source = ctx.params.source;
+      if (typeof source === "string") {
+        for (const p of AUTOMATION_PATTERNS) {
+          if (p.pattern.test(source)) {
+            return makeDecision(p, source.substring(0, 60));
+          }
+        }
+      }
+      return null;
+    }
+    const userCode = extractUserCode(ctx);
+    if (!userCode) return null;
+    for (const p of AUTOMATION_PATTERNS) {
+      if (p.pattern.test(userCode)) {
+        return makeDecision(p, userCode.substring(0, 60));
+      }
+    }
+    return null;
+  }
+};
+function makeDecision(p, context) {
+  const suggestion = p.suggestionOverride ?? `Detected: "${p.name}" \u2014 an automation tool marker that anti-crawler systems immediately flag. Remove this pattern from your code.`;
+  return {
+    ruleId: "automation-signals",
+    action: "pass",
+    severity: p.severity,
+    reason: `Automation marker detected: "${p.name}". Context: "${context}..."`,
+    suggestion,
+    errorCode: p.errorCode,
+    errorMessage: p.severity === "danger" ? `[CDP Firewall] ${p.name} blocked \u2014 automation tool marker detected` : `[CDP Firewall] ${p.name} detected \u2014 potential automation signal`
+  };
+}
+
+// src/cdp-interceptor/rules/fingerprinting.ts
+var FP_PATTERNS = [
+  // ── Canvas Rendering fingerprinting ────────────────────
+  { pattern: /\.toDataURL\s*\(/, name: "canvas.toDataURL()", severity: "danger", errorCode: -32050, suggestion: "canvas.toDataURL() returns a unique hash that identifies the browser engine. Minimize calls." },
+  { pattern: /\.toBlob\s*\(/, name: "canvas.toBlob()", severity: "danger", errorCode: -32050, suggestion: "canvas.toBlob() is used for canvas fingerprinting. Avoid if possible." },
+  { pattern: /getImageData\s*\(/, name: "CanvasRenderingContext2D.getImageData()", severity: "danger", errorCode: -32050, suggestion: "getImageData reads pixel-level data used for fingerprinting." },
+  { pattern: /measureText\s*\(/, name: "CanvasRenderingContext2D.measureText()", severity: "warn", errorCode: -32051, suggestion: "Font metrics reveal installed fonts \u2014 a fingerprinting vector." },
+  { pattern: /OffscreenCanvas\s*\(/, name: "new OffscreenCanvas()", severity: "warn", errorCode: -32051, suggestion: "OffscreenCanvas is sometimes used to avoid visibility detection." },
+  { pattern: /convertToBlob\s*\(/, name: "OffscreenCanvas.convertToBlob()", severity: "warn", errorCode: -32051, suggestion: "Headless OffscreenCanvas rendering differs from real browser." },
+  // ── WebGL Fingerprinting ──────────────────────────────
+  { pattern: /getParameter\s*\([^)]*(?:VENDOR|RENDERER|VERSION)/, name: "WebGL getParameter(VENDOR/RENDERER)", severity: "danger", errorCode: -32052, suggestion: "WebGL VENDOR/RENDERER returns emulated values in headless. Cannot be reliably spoofed." },
+  { pattern: /getSupportedExtensions\s*\(/, name: "WebGL getSupportedExtensions()", severity: "warn", errorCode: -32053, suggestion: "WebGL extension list differs in headless mode." },
+  { pattern: /getShaderPrecisionFormat\s*\(/, name: "WebGL getShaderPrecisionFormat()", severity: "info", errorCode: -32054, suggestion: "Shader precision differs between headless and real GPU." },
+  { pattern: /UNMASKED_VENDOR_WEBGL/, name: "WEBGL_debug_renderer_info UNMASKED_VENDOR", severity: "warn", errorCode: -32053, suggestion: "Unmasked vendor info reveals the real GPU \u2014 blocked in many envs." },
+  { pattern: /UNMASKED_RENDERER_WEBGL/, name: "WEBGL_debug_renderer_info UNMASKED_RENDERER", severity: "warn", errorCode: -32053, suggestion: "Unmasked renderer string reveals the real GPU." },
+  // ── AudioContext Fingerprinting ────────────────────────
+  { pattern: /AnalyserNode\s*\(/, name: "new AnalyserNode()", severity: "warn", errorCode: -32055, suggestion: "Audio fingerprinting via AnalyserNode \u2014 produces silence in headless." },
+  { pattern: /getFloatFrequencyData\s*\(/, name: "AnalyserNode.getFloatFrequencyData()", severity: "danger", errorCode: -32050, suggestion: "Audio frequency data in headless returns silence (all zeros) \u2014 detectable." },
+  { pattern: /getByteFrequencyData\s*\(/, name: "AnalyserNode.getByteFrequencyData()", severity: "danger", errorCode: -32050, suggestion: "Audio byte frequency data in headless returns zeros." },
+  { pattern: /getByteTimeDomainData\s*\(/, name: "AnalyserNode.getByteTimeDomainData()", severity: "danger", errorCode: -32050, suggestion: "Time domain audio data in headless is a flat line \u2014 detectable." },
+  { pattern: /OfflineAudioContext\s*\(/, name: "new OfflineAudioContext()", severity: "warn", errorCode: -32055, suggestion: "Offline audio rendering is a known fingerprinting method." },
+  { pattern: /OscillatorNode\s*\(/, name: "new OscillatorNode()", severity: "info", errorCode: -32056, suggestion: "Audio oscillator used in fingerprinting probes." },
+  // ── Navigator property probing ───────────────────────
+  { pattern: /navigator\s*\.\s*connection\b/, name: "navigator.connection", severity: "info", errorCode: -32057, suggestion: 'Network connection info is used for fingerprinting (always "4g" in bots).' },
+  { pattern: /navigator\s*\.\s*getBattery\s*\(/, name: "navigator.getBattery()", severity: "warn", errorCode: -32058, suggestion: "Battery API is a fingerprinting vector. Returns fixed values in headless." },
+  { pattern: /navigator\s*\.\s*mediaDevices\s*\.\s*enumerateDevices/, name: "navigator.mediaDevices.enumerateDevices()", severity: "warn", errorCode: -32058, suggestion: "Media device enumeration returns empty/no devices in headless." },
+  { pattern: /navigator\s*\.\s*permissions\s*\.\s*query/, name: "navigator.permissions.query()", severity: "info", errorCode: -32059, suggestion: "Permission queries can reveal automation environment." },
+  // ── Screen / Window geometry probing ──────────────────
+  { pattern: /screen\.avail(Width|Height|Left|Top)/, name: "screen.avail*", severity: "warn", errorCode: -32060, suggestion: "screen.avail* values differ in headless (no OS chrome)." },
+  { pattern: /window\.outerWidth\s*-?\s*window\.innerWidth/, name: "window.outerWidth - window.innerWidth", severity: "danger", errorCode: -32050, suggestion: "This difference is 0 in headless (no browser chrome) \u2014 100% detection rate." },
+  { pattern: /window\.outerHeight\s*-?\s*window\.innerHeight/, name: "window.outerHeight - window.innerHeight", severity: "danger", errorCode: -32050, suggestion: "This difference is 0 in headless \u2014 immediate automation detection." },
+  { pattern: /screen\.width\b/, name: "screen.width", severity: "info", errorCode: -32061, suggestion: "Screen dimensions can be spoofed but inconsistencies with viewport are detectable." },
+  { pattern: /screen\.height\b/, name: "screen.height", severity: "info", errorCode: -32061, suggestion: "Screen dimension probes for viewport inconsistency detection." },
+  { pattern: /window\.devicePixelRatio/, name: "window.devicePixelRatio", severity: "warn", errorCode: -32060, suggestion: "devicePixelRatio is always 1 in headless \u2014 differs from real displays." },
+  { pattern: /matchMedia\s*\(/, name: "window.matchMedia()", severity: "warn", errorCode: -32060, suggestion: "matchMedia can detect CDP overridden viewport dimensions." },
+  // ── Performance / Timing API ──────────────────────────
+  { pattern: /performance\s*\.\s*now\s*\(/, name: "performance.now()", severity: "info", errorCode: -32062, suggestion: "High-resolution timer used for timing attacks and bot detection." },
+  { pattern: /performance\s*\.\s*memory/, name: "performance.memory", severity: "warn", errorCode: -32063, suggestion: "performance.memory shows VM memory limits in containers." },
+  { pattern: /performance\.getEntriesByType\s*\(\s*["']navigation["']\s*\)/, name: 'performance.getEntriesByType("navigation")', severity: "info", errorCode: -32062, suggestion: "Navigation timing reveals request pattern inconsistencies." },
+  { pattern: /performance\.getEntriesByType\s*\(\s*["']resource["']\s*\)/, name: 'performance.getEntriesByType("resource")', severity: "info", errorCode: -32062, suggestion: "Resource loading timing analysis for bot detection." },
+  // ── Font Detection ────────────────────────────────────
+  { pattern: /document\.fonts\.check\s*\(/, name: "document.fonts.check()", severity: "warn", errorCode: -32064, suggestion: "Font availability checks are used for fingerprinting. Installed font list is unique per user." },
+  { pattern: /document\.fonts\.ready/, name: "document.fonts.ready", severity: "info", errorCode: -32065, suggestion: "Font loading state probe for fingerprinting." },
+  // ── WebRTC / Connectivity ────────────────────────────
+  { pattern: /RTCPeerConnection\s*\(/, name: "new RTCPeerConnection()", severity: "warn", errorCode: -32066, suggestion: "WebRTC can leak internal IP and is used for connectivity fingerprinting." },
+  { pattern: /navigator\.mediaDevices\.getUserMedia/, name: "navigator.mediaDevices.getUserMedia()", severity: "info", errorCode: -32067, suggestion: "getUserMedia always fails in headless (no camera)." },
+  // ── Feature Consistency Checks ─────────────────────────
+  { pattern: /Intl\.DateTimeFormat.*resolvedOptions.*timeZone/, name: "Intl.DateTimeFormat timezone check", severity: "warn", errorCode: -32068, suggestion: "Timezone from Intl API vs Emulation.setTimezoneOverride will be inconsistent when mocked." },
+  { pattern: /new\s+Date\s*\(\s*\)\s*\.\s*getTimezoneOffset/, name: "Date.getTimezoneOffset()", severity: "info", errorCode: -32069, suggestion: "Timezone offset used for timing consistency cross-checks." },
+  { pattern: /Error\s*\(\s*\)\s*\.\s*stack/, name: "Error().stack format check", severity: "info", errorCode: -32070, suggestion: "Stack trace format differs between headless and full Chrome." },
+  { pattern: /Function\.prototype\.toString/, name: "Function.prototype.toString on native fn", severity: "info", errorCode: -32070, suggestion: "Native function toString() format can reveal patched APIs." }
+];
+var fingerprintingRule = {
+  id: "fingerprinting",
+  name: "Browser Fingerprinting Access Detection (35+ APIs)",
+  priority: 30,
+  canHandle(ctx) {
+    return ctx.method === "Runtime.evaluate" || ctx.method === "Runtime.callFunctionOn";
+  },
+  evaluate(ctx) {
+    const userCode = extractUserCode(ctx);
+    if (!userCode) return null;
+    for (const p of FP_PATTERNS) {
+      if (p.pattern.test(userCode)) {
+        return {
+          ruleId: "fingerprinting",
+          action: "pass",
+          severity: p.severity,
+          reason: `Browser fingerprinting API accessed: "${p.name}". Anti-crawler systems use this to identify your browser.`,
+          suggestion: p.suggestion,
+          errorCode: p.errorCode,
+          errorMessage: `[CDP Firewall] ${p.name} blocked \u2014 fingerprinting API access detected`
+        };
+      }
+    }
+    return null;
+  }
+};
+
+// src/cdp-interceptor/rules/event-simulation.ts
+var EVENT_PATTERNS = [
+  // ── Direct method calls (all isTrusted=false) ─────────
+  { pattern: /\.click\s*\(\s*\)/, name: "el.click()", severity: "danger", errorCode: -32070, suggestion: "el.click() fires isTrusted=false events. Use page.click(selector) which uses Input.dispatchMouseEvent (isTrusted=true)." },
+  { pattern: /\.focus\s*\(\s*\)/, name: "el.focus()", severity: "warn", errorCode: -32071, suggestion: "el.focus() without user interaction is detectable. Use page.click(selector) which naturally focuses." },
+  { pattern: /\.blur\s*\(\s*\)/, name: "el.blur()", severity: "danger", errorCode: -32071, suggestion: "el.blur() without user interaction. Avoid in automation scripts." },
+  { pattern: /\.submit\s*\(\s*\)/, name: "el.submit()", severity: "danger", errorCode: -32072, suggestion: `form.submit() bypasses onSubmit handlers. Click the submit button: page.click('button[type="submit"]').` },
+  { pattern: /\.reset\s*\(\s*\)/, name: "el.reset()", severity: "danger", errorCode: -32072, suggestion: "form.reset() without user action. Let the user clear fields manually." },
+  { pattern: /\.select\s*\(\s*\)/, name: "el.select()", severity: "warn", errorCode: -32073, suggestion: "input.select() selects text without user interaction. Use page.click(selector) instead." },
+  { pattern: /dialog\.close\s*\(\s*\)|showModal\(\)/, name: "dialog.showModal()/close()", severity: "danger", errorCode: -32074, suggestion: "dialog.showModal() requires user gesture. Let the user open the dialog naturally." },
+  { pattern: /\.showPopover\s*\(\s*\)/, name: "el.showPopover()", severity: "warn", errorCode: -32073, suggestion: "Popover.show() requires user gesture. Simulate a click on the popover trigger." },
+  { pattern: /\.hidePopover\s*\(\s*\)/, name: "el.hidePopover()", severity: "warn", errorCode: -32073, suggestion: "Hiding popovers via CDP is detectable." },
+  { pattern: /\.requestFullscreen\s*\(\s*\)/, name: "el.requestFullscreen()", severity: "danger", errorCode: -32074, suggestion: "Fullscreen requests require user gesture. Cannot be triggered by automation." },
+  { pattern: /\.requestPointerLock\s*\(\s*\)/, name: "el.requestPointerLock()", severity: "danger", errorCode: -32074, suggestion: "Pointer lock requires user gesture. Blocked in automation." },
+  { pattern: /\.setSelectionRange\s*\(/, name: "el.setSelectionRange()", severity: "warn", errorCode: -32073, suggestion: "Setting selection range without user interaction is suspicious." },
+  { pattern: /\.setRangeText\s*\(/, name: "el.setRangeText()", severity: "info", errorCode: -32076, suggestion: "Range text replacement without user input is detectable." },
+  { pattern: /\.showPicker\s*\(\s*\)/, name: "HTMLInputElement.showPicker()", severity: "info", errorCode: -32076, suggestion: "Date/color picker shown without click \u2014 detectable." },
+  { pattern: /\.reportValidity\s*\(\s*\)/, name: "el.reportValidity()", severity: "info", errorCode: -32076, suggestion: "Validity reporting without form submission attempt." },
+  // ── dispatchEvent with synthetic events (isTrusted=false) ──
+  { pattern: /dispatchEvent\s*\(\s*new\s+(?:Event|CustomEvent)\s*\(/, name: "dispatchEvent(new Event/CustomEvent)", severity: "warn", errorCode: -32077, suggestion: "Synthetic events have isTrusted=false. Use Input.dispatch* CDP methods for trusted events." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+MouseEvent\s*\(/, name: "dispatchEvent(new MouseEvent)", severity: "danger", errorCode: -32077, suggestion: "Synthetic mouse events (isTrusted=false). Use Input.dispatchMouseEvent CDP method." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+KeyboardEvent\s*\(/, name: "dispatchEvent(new KeyboardEvent)", severity: "danger", errorCode: -32077, suggestion: "Synthetic keyboard events (isTrusted=false). Use Input.dispatchKeyEvent CDP method." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+FocusEvent\s*\(/, name: "dispatchEvent(new FocusEvent)", severity: "warn", errorCode: -32078, suggestion: "Synthetic focus events bypass user interaction." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+InputEvent\s*\(/, name: "dispatchEvent(new InputEvent)", severity: "danger", errorCode: -32077, suggestion: "Synthetic input events (isTrusted=false). Use page.fill() or page.type()." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+(?:Event)\s*\(\s*["'](?:input|change|submit|reset)/, name: 'dispatchEvent("input"/"change"/"submit")', severity: "danger", errorCode: -32077, suggestion: "Synthetic input/change/submit events are trusted=false. Always detectable." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+PointerEvent\s*\(/, name: "dispatchEvent(new PointerEvent)", severity: "danger", errorCode: -32077, suggestion: "Synthetic pointer events bypass the trusted input pipeline." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+TouchEvent\s*\(/, name: "dispatchEvent(new TouchEvent)", severity: "danger", errorCode: -32077, suggestion: "Synthetic touch events on mobile are detectable." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+WheelEvent\s*\(/, name: "dispatchEvent(new WheelEvent)", severity: "warn", errorCode: -32078, suggestion: "Synthetic scroll events (isTrusted=false). Use Input.dispatchMouseEvent with wheel type." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+ClipboardEvent\s*\(/, name: "dispatchEvent(new ClipboardEvent)", severity: "warn", errorCode: -32078, suggestion: "Synthetic clipboard events are detectable." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+DragEvent\s*\(/, name: "dispatchEvent(new DragEvent)", severity: "warn", errorCode: -32078, suggestion: "Synthetic drag events bypass real user interaction." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+CompositionEvent\s*\(/, name: "dispatchEvent(new CompositionEvent)", severity: "info", errorCode: -32079, suggestion: "Synthetic IME composition events \u2014 detectable pattern." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+AnimationEvent\s*\(/, name: "dispatchEvent(new AnimationEvent)", severity: "info", errorCode: -32079, suggestion: "Forcing animation state transitions via fake events." },
+  { pattern: /dispatchEvent\s*\(\s*new\s+TransitionEvent\s*\(/, name: "dispatchEvent(new TransitionEvent)", severity: "info", errorCode: -32079, suggestion: "Forcing CSS transition end via fake events." }
+];
+var eventSimulationRule = {
+  id: "event-simulation",
+  name: "Event Simulation Detection (30+ patterns)",
+  priority: 40,
+  canHandle(ctx) {
+    return ctx.method === "Runtime.evaluate" || ctx.method === "Runtime.callFunctionOn";
+  },
+  evaluate(ctx) {
+    const userCode = extractUserCode(ctx);
+    if (!userCode) return null;
+    for (const p of EVENT_PATTERNS) {
+      if (p.pattern.test(userCode)) {
+        return {
+          ruleId: "event-simulation",
+          // danger 级硬拦（el.click 等 100% 暴露的模式）；
+          // warning 级放行+提示（dispatchEvent 在部分合法场景如 DataTransfer paste 使用）
+          action: p.severity === "danger" ? "block" : "pass",
+          severity: p.severity,
+          reason: `Event simulation detected: "${p.name}". Synthetic events have isTrusted=false and are 100% detectable.`,
+          suggestion: p.suggestion,
+          errorCode: p.errorCode,
+          errorMessage: p.severity === "danger" ? `[CDP Firewall] ${p.name} blocked \u2014 synthetic event (isTrusted=false)` : `[CDP Firewall] ${p.name} detected \u2014 event simulation`
+        };
+      }
+    }
+    return null;
+  }
+};
+
+// src/cdp-interceptor/rules/emulation-override.ts
+var OVERRIDE_PATTERNS = [
+  // ── Emulation overrides ──────────────────────────────
+  // NOTE: Emulation.setDeviceMetricsOverride is NOT included here because
+  // Playwright calls it internally for every new page (viewport setup).
+  // Blocking it would break page creation.
+  { method: "Emulation.setUserAgentOverride", name: "Emulation.setUserAgentOverride", severity: "danger", errorCode: -32080, suggestion: "navigator.userAgent override can be detected by checking consistency with navigator.plugins, WebGL vendor, etc." },
+  { method: "Emulation.setTouchEmulationEnabled", name: "Emulation.setTouchEmulationEnabled", severity: "warn", errorCode: -32081, suggestion: "Touch emulation creates inconsistent touch/mouse state. Windows touch events without real touch hardware." },
+  { method: "Emulation.setGeolocationOverride", name: "Emulation.setGeolocationOverride", severity: "danger", errorCode: -32082, suggestion: "Geolocation changing mid-session without user travel is impossible. Detectable via IP geo vs overridden geo." },
+  { method: "Emulation.setLocaleOverride", name: "Emulation.setLocaleOverride", severity: "warn", errorCode: -32081, suggestion: "Locale change without browser restart detectable via navigator.languages vs Accept-Language consistency." },
+  { method: "Emulation.setTimezoneOverride", name: "Emulation.setTimezoneOverride", severity: "danger", errorCode: -32082, suggestion: "Timezone mismatch vs IP geolocation + Date() is 100% detectable." },
+  { method: "Emulation.setDisabledImageTypes", name: "Emulation.setDisabledImageTypes", severity: "info", errorCode: -32083, suggestion: "Disabling image types prevents normal resource loading \u2014 visible to performance API." },
+  { method: "Emulation.setScriptExecutionDisabled", name: "Emulation.setScriptExecutionDisabled", severity: "info", errorCode: -32083, suggestion: "Disabling JS mid-session kills page interactivity \u2014 immediately obvious." },
+  { method: "Emulation.setCPUThrottlingRate", name: "Emulation.setCPUThrottlingRate", severity: "info", errorCode: -32083, suggestion: "CPU throttling creates unrealistic performance.now() profiles." },
+  { method: "Emulation.setVirtualTimePolicy", name: "Emulation.setVirtualTimePolicy", severity: "info", errorCode: -32083, suggestion: "Virtual time breaks Date.now() and performance.now() based detections \u2014 detectable via timer drift." },
+  // ── Network overrides ────────────────────────────────
+  { method: "Network.setUserAgentOverride", name: "Network.setUserAgentOverride (HTTP layer)", severity: "danger", errorCode: -32080, suggestion: "HTTP User-Agent vs navigator.userAgent inconsistency = immediate detection." },
+  { method: "Network.setExtraHTTPHeaders", name: "Network.setExtraHTTPHeaders", severity: "danger", errorCode: -32084, suggestion: "Custom headers can conflict with browser-generated headers. Missing client hints (Sec-CH-UA) are also detectable." },
+  { method: "Network.emulateNetworkConditions", name: "Network.emulateNetworkConditions", severity: "warn", errorCode: -32081, suggestion: "Network throttling creates unrealistic load timing patterns." },
+  { method: "Network.setCookie", name: "Network.setCookie", severity: "warn", errorCode: -32085, suggestion: "CDP-injected cookies are detectable via document.cookie vs Network.getCookies inconsistency." },
+  { method: "Network.deleteCookies", name: "Network.deleteCookies", severity: "warn", errorCode: -32085, suggestion: "Cookie deletion via CDP bypasses HTTP cookie expiration \u2014 detectable." },
+  // ── Security overrides ──────────────────────────────
+  { method: "Security.setIgnoreCertificateErrors", name: "Security.setIgnoreCertificateErrors", severity: "info", errorCode: -32086, suggestion: "Ignoring certificate errors creates unusual TLS behavior visible at network level." },
+  // ── Page overrides ──────────────────────────────────
+  { method: "Page.setDownloadBehavior", name: "Page.setDownloadBehavior", severity: "info", errorCode: -32087, suggestion: "Bypassing download dialogs \u2014 detectable via download event flow." },
+  { method: "Page.setWebLifecycleState", name: "Page.setWebLifecycleState", severity: "info", errorCode: -32087, suggestion: "Forcing page lifecycle transitions is unnatural." },
+  // ── Storage / Permissions ───────────────────────────
+  { method: "Storage.clearDataForOrigin", name: "Storage.clearDataForOrigin", severity: "info", errorCode: -32089, suggestion: "Clearing storage mid-session is unnatural for real users." },
+  { method: "Browser.grantPermissions", name: "Browser.grantPermissions", severity: "warn", errorCode: -32090, suggestion: "Granting permissions via CDP is detectable as the permission flow skips the user prompt." },
+  { method: "Browser.resetPermissions", name: "Browser.resetPermissions", severity: "info", errorCode: -32089, suggestion: "Permission resets without user action are unnatural." }
+];
+var emulationOverrideRule = {
+  id: "emulation-override",
+  name: "CDP Emulation / Override Detection (20+ methods)",
+  priority: 60,
+  canHandle(ctx) {
+    for (const p of OVERRIDE_PATTERNS) {
+      if (ctx.method === p.method) return true;
+    }
+    return false;
+  },
+  evaluate(ctx) {
+    for (const p of OVERRIDE_PATTERNS) {
+      if (ctx.method !== p.method) continue;
+      return {
+        ruleId: "emulation-override",
+        action: "pass",
+        severity: p.severity,
+        reason: `CDP emulation/override detected: "${p.name}". This creates detectable inconsistencies between the JS environment and real browser state.`,
+        suggestion: p.suggestion,
+        errorCode: p.errorCode,
+        errorMessage: `[CDP Firewall] ${p.name} blocked \u2014 creates detectable browser state inconsistency`
+      };
+    }
+    return null;
+  }
+};
+
+// src/cdp-interceptor/rules/network-anomaly.ts
+var networkAnomalyRule = {
+  id: "network-anomaly",
+  name: "Network Anomaly Detection (8+ patterns)",
+  priority: 70,
+  canHandle(ctx) {
+    const m = ctx.method;
+    return m === "Network.setExtraHTTPHeaders" || m === "Network.clearBrowserCache" || m === "Network.clearBrowserCookies" || m === "Network.setBlockedURLs" || m === "Network.setBypassServiceWorker" || m === "Fetch.enable" || m === "Network.enable";
+  },
+  evaluate(ctx) {
+    switch (ctx.method) {
+      case "Network.setExtraHTTPHeaders": {
+        const headers = ctx.params.headers;
+        if (headers) {
+          const headerStr = JSON.stringify(headers).toLowerCase();
+          if (!headerStr.includes("sec-ch-ua")) {
+            return {
+              ruleId: "network-anomaly",
+              action: "pass",
+              severity: "warn",
+              reason: "Network.setExtraHTTPHeaders called without Sec-CH-UA client hints \u2014 browser normally sends these.",
+              suggestion: "Modern browsers send Sec-CH-UA headers automatically. Adding custom headers without them creates detectable inconsistency.",
+              errorCode: -32110,
+              errorMessage: "[CDP Firewall] Missing client hints in custom headers"
+            };
+          }
+        }
+        return null;
+      }
+      case "Network.clearBrowserCache": {
+        return {
+          ruleId: "network-anomaly",
+          action: "pass",
+          severity: "warn",
+          reason: "Network.clearBrowserCache called \u2014 cache clearing mid-session is unnatural for real users.",
+          suggestion: "Avoid cache clearing during sessions. Start with a fresh profile if needed.",
+          errorCode: -32111,
+          errorMessage: "[CDP Firewall] Cache clearing detected"
+        };
+      }
+      case "Network.clearBrowserCookies": {
+        return {
+          ruleId: "network-anomaly",
+          action: "pass",
+          severity: "warn",
+          reason: "Network.clearBrowserCookies called \u2014 wiping cookies mid-session is a scraper optimization.",
+          suggestion: "Cookies should only be cleared via normal browser flow (expiration, user action).",
+          errorCode: -32112,
+          errorMessage: "[CDP Firewall] Cookie clearing detected"
+        };
+      }
+      case "Network.setBlockedURLs": {
+        return {
+          ruleId: "network-anomaly",
+          action: "pass",
+          severity: "warn",
+          reason: "Network.setBlockedURLs blocks resource loading \u2014 this changes the page behavior and is detectable.",
+          suggestion: "Blocking images/fonts/etc creates measurable differences in performance and page rendering.",
+          errorCode: -32113,
+          errorMessage: "[CDP Firewall] URL blocking detected"
+        };
+      }
+      case "Network.setBypassServiceWorker": {
+        return {
+          ruleId: "network-anomaly",
+          action: "block",
+          severity: "info",
+          reason: "Network.setBypassServiceWorker called \u2014 bypassing service workers for content extraction.",
+          suggestion: "Service worker bypass changes fetch behavior and is detectable server-side.",
+          errorCode: -32114,
+          errorMessage: "[CDP Firewall] Service worker bypass detected"
+        };
+      }
+      case "Fetch.enable": {
+        return {
+          ruleId: "network-anomaly",
+          action: "pass",
+          severity: "warn",
+          reason: "Fetch.enable intercepts all network requests \u2014 a man-in-the-middle approach used by scrapers.",
+          suggestion: "Do not use Fetch domain for network interception if avoiding detection.",
+          errorCode: -32115,
+          errorMessage: "[CDP Firewall] Fetch interception detected"
+        };
+      }
+      default:
+        return null;
+    }
+  }
+};
+
+// src/cdp-interceptor/rules/page-lifecycle.ts
+var STAT_KEY = "lifecycle-tracker";
+var pageLifecycleRule = {
+  id: "page-lifecycle",
+  name: "Page Lifecycle Anomaly Detection (10+ patterns)",
+  priority: 80,
+  canHandle(ctx) {
+    const m = ctx.method;
+    return m === "Page.navigate" || m === "Page.captureScreenshot" || m === "Page.printToPDF" || m === "Page.reload" || m === "Page.close" || m === "Runtime.evaluate" || m === "Runtime.callFunctionOn";
+  },
+  evaluate(ctx) {
+    let state = ctx.sessionState.get(STAT_KEY);
+    if (!state) {
+      state = { navigations: [], screenshots: 0, printToPDF: false, evaluateCount: 0, lastNavTime: 0, lastEvalTime: 0 };
+      ctx.sessionState.set(STAT_KEY, state);
+    }
+    const now = Date.now();
+    switch (ctx.method) {
+      case "Page.navigate": {
+        state.navigations.push(now);
+        if (state.navigations.length >= 2) {
+          const prev = state.navigations[state.navigations.length - 2];
+          const interval = now - prev;
+          if (interval < 100) {
+            return {
+              ruleId: "page-lifecycle",
+              action: "pass",
+              severity: "warn",
+              reason: `Multiple Page.navigate calls within ${interval}ms of each other \u2014 unnatural rapid navigation.`,
+              suggestion: "Add proper waits between navigations: wait for page load before navigating again.",
+              errorCode: -32100,
+              errorMessage: "[CDP Firewall] Rapid navigation sequence detected"
+            };
+          }
+        }
+        state.lastNavTime = now;
+        return null;
+      }
+      case "Page.captureScreenshot": {
+        state.screenshots++;
+        if (state.lastNavTime > 0 && now - state.lastNavTime < 500) {
+          return {
+            ruleId: "page-lifecycle",
+            action: "pass",
+            severity: "danger",
+            reason: "Page.captureScreenshot called within 500ms of navigation \u2014 content extraction pattern.",
+            suggestion: "Wait for the page to fully render before taking screenshots: wait for load/networkidle.",
+            errorCode: -32101,
+            errorMessage: "[CDP Firewall] Pre-render screenshot blocked \u2014 content extraction pattern"
+          };
+        }
+        if (state.screenshots > 3 && state.navigations.length < 2) {
+          return {
+            ruleId: "page-lifecycle",
+            action: "pass",
+            severity: "warn",
+            reason: "Multiple screenshots on a single page without navigation \u2014 suspicious extraction behavior.",
+            suggestion: "Consider if all screenshots are necessary.",
+            errorCode: -32102,
+            errorMessage: "[CDP Firewall] Excessive screenshot detection"
+          };
+        }
+        return null;
+      }
+      case "Page.printToPDF": {
+        return {
+          ruleId: "page-lifecycle",
+          action: "pass",
+          severity: "danger",
+          reason: "Page.printToPDF called \u2014 this is a telltale scraper pattern that gives away automation intent.",
+          suggestion: "Avoid PDF generation. If you must, add significant delays and user-like interaction first.",
+          errorCode: -32103,
+          errorMessage: "[CDP Firewall] printToPDF blocked \u2014 scraper intent detected"
+        };
+      }
+      case "Page.reload": {
+        if (state.lastNavTime > 0 && now - state.lastNavTime < 1e3) {
+          return {
+            ruleId: "page-lifecycle",
+            action: "pass",
+            severity: "warn",
+            reason: "Page.reload called immediately after navigate \u2014 unnatural fast-reload pattern.",
+            suggestion: "Introduce delays between navigation and reload to simulate human behavior.",
+            errorCode: -32104,
+            errorMessage: "[CDP Firewall] Rapid reload detected"
+          };
+        }
+        return null;
+      }
+      case "Page.close": {
+        if (state.navigations.length < 2) {
+          return {
+            ruleId: "page-lifecycle",
+            action: "pass",
+            severity: "info",
+            reason: "Page.close called after minimal interaction \u2014 zombie pages common in automation.",
+            suggestion: "Ensure meaningful interaction before closing pages.",
+            errorCode: -32105,
+            errorMessage: "[CDP Firewall] Page close after minimal interaction"
+          };
+        }
+        return null;
+      }
+      case "Runtime.evaluate":
+      case "Runtime.callFunctionOn": {
+        state.evaluateCount++;
+        if (state.evaluateCount > 50 && state.navigations.length === 0) {
+          return {
+            ruleId: "page-lifecycle",
+            action: "pass",
+            severity: "info",
+            reason: "50+ evaluate calls without any Page.navigate \u2014 data extraction without real browsing.",
+            suggestion: "Navigate to a real page first. Evaluate on about:blank is suspicious.",
+            errorCode: -32106,
+            errorMessage: "[CDP Firewall] Excessive evaluate without navigation"
+          };
+        }
+        return null;
+      }
+      default:
+        return null;
+    }
+  }
+};
+
+// src/cdp-interceptor/rules-engine.ts
+var BUILTIN_RULES = [
+  domMutationRule,
+  automationSignalsRule,
+  fingerprintingRule,
+  eventSimulationRule,
+  mouseTrajectoryRule,
+  inputKeystrokeRule,
+  emulationOverrideRule,
+  networkAnomalyRule,
+  pageLifecycleRule
+];
+function createRuleEngine(customRules) {
+  const rules = [...BUILTIN_RULES, ...customRules ?? []].sort((a, b) => a.priority - b.priority);
+  const sessionStates = /* @__PURE__ */ new Map();
+  function getSessionState(sessionId) {
+    let state = sessionStates.get(sessionId);
+    if (!state) {
+      state = /* @__PURE__ */ new Map();
+      sessionStates.set(sessionId, state);
+    }
+    return state;
+  }
+  return {
+    start() {
+      sessionStates.clear();
+    },
+    stop() {
+      sessionStates.clear();
+    },
+    evaluate(ctx) {
+      const fullCtx = {
+        ...ctx,
+        sessionState: getSessionState(ctx.sessionId)
+      };
+      for (const rule of rules) {
+        if (rule.canHandle && !rule.canHandle(fullCtx)) continue;
+        const decision = rule.evaluate(fullCtx);
+        if (!decision) continue;
+        if (decision.action !== "pass") return decision;
+      }
+      return null;
+    }
+  };
+}
+
+// src/cdp-driver/connection.ts
+var CDPConnection = class _CDPConnection extends EventEmitter4 {
   ws;
   nextId = 1;
+  /** CDP Guard：全部出站命令过规则引擎（env XBROWSER_CDP_GUARD=off 关闭）。
+   *  173 条规则 / 9 模块：合成事件 block、指纹暴露警告、自动化信号拦截。 */
+  static __guard;
+  get guard() {
+    if (_CDPConnection.__guard === void 0) {
+      if (process.env.XBROWSER_CDP_GUARD === "off") {
+        _CDPConnection.__guard = null;
+      } else {
+        try {
+          const g = createRuleEngine();
+          g.start();
+          _CDPConnection.__guard = g;
+        } catch {
+          _CDPConnection.__guard = null;
+        }
+      }
+    }
+    return _CDPConnection.__guard;
+  }
   pending = /* @__PURE__ */ new Map();
   closed = false;
   closeReason = null;
@@ -2804,6 +4194,8 @@ var CDPConnection = class extends EventEmitter4 {
    *  ping, the connection is considered dead and forcibly closed. */
   keepaliveTimer = null;
   pongTimer = null;
+  /** 最近一次收到任何 WS 消息的时间——有数据流动即证明连接存活 */
+  lastIncomingAt = Date.now();
   startKeepalive() {
     this.ws.on("pong", () => {
       if (this.pongTimer) {
@@ -2815,9 +4207,14 @@ var CDPConnection = class extends EventEmitter4 {
       if (this.ws.readyState === WebSocket.OPEN) {
         if (!this.pongTimer) {
           this.pongTimer = setTimeout(() => {
+            const recentlyActive = Date.now() - this.lastIncomingAt < 3e4;
+            if (recentlyActive) {
+              this.pongTimer = null;
+              return;
+            }
             if (!this.closed) {
               this.closed = true;
-              this.closeReason = "keepalive timeout (no pong in 10s)";
+              this.closeReason = "keepalive timeout (no pong and idle >30s)";
               try {
                 this.ws.terminate();
               } catch {
@@ -2829,7 +4226,7 @@ var CDPConnection = class extends EventEmitter4 {
               this.pending.clear();
               this.emit("disconnect");
             }
-          }, 1e4);
+          }, 6e4);
         }
         this.ws.ping?.();
       } else if (this.closed) {
@@ -2867,10 +4264,23 @@ var CDPConnection = class extends EventEmitter4 {
    * @param method — CDP domain.method (e.g. "Page.navigate")
    * @param params — method parameters
    * @param sessionId — optional flat session ID for sub-targets
-   * @param timeoutMs — response timeout (default: 30s)
+   * @param timeoutMs — response timeout (default: 30s；重 SPA 加载期间主线程忙，
+   *   evaluate 可排队 >30s——Runtime.evaluate 单独放宽到 90s)
    * @returns the `result` field from the CDP response
    */
-  async send(method, params, sessionId, timeoutMs = 3e4) {
+  async send(method, params, sessionId, timeoutMs) {
+    const effectiveTimeout = timeoutMs ?? (method === "Runtime.evaluate" ? 9e4 : 3e4);
+    if (this.guard) {
+      const decision = this.guard.evaluate({
+        method,
+        params: params ?? {},
+        sessionId: sessionId ?? this.defaultSessionId ?? "",
+        direction: "client\u2192browser"
+      });
+      if (decision && decision.action === "block") {
+        throw new Error(`[CDP-Guard] ${decision.reason}${decision.suggestion ? " | \u66FF\u4EE3: " + decision.suggestion : ""} [${decision.ruleId}]`);
+      }
+    }
     if (this.closed) {
       throw new Error(`CDP connection closed: ${this.closeReason ?? "unknown"}`);
     }
@@ -2885,8 +4295,8 @@ var CDPConnection = class extends EventEmitter4 {
     return new Promise((resolve, reject) => {
       const timeout = setTimeout(() => {
         this.pending.delete(id);
-        reject(new Error(`CDP timeout: ${method} (${timeoutMs}ms)`));
-      }, timeoutMs);
+        reject(new Error(`CDP timeout: ${method} (${effectiveTimeout}ms)`));
+      }, effectiveTimeout);
       this.pending.set(id, {
         resolve: (v) => {
           clearTimeout(timeout);
@@ -2969,6 +4379,7 @@ var CDPConnection = class extends EventEmitter4 {
   // ── Private ─────────────────────────────────────────────────
   bindWebSocket() {
     this.ws.on("message", (raw) => {
+      this.lastIncomingAt = Date.now();
       let msg;
       try {
         msg = JSON.parse(raw.toString());
@@ -3110,25 +4521,22 @@ async function launch(options = {}) {
   const browser = new XBBrowserImpl(conn, childProcess, tmpDir, httpEndpoint);
   return { browser, wsEndpoint };
 }
+
 export {
-  CDPConnection,
-  CDPProtocolError,
-  XBBrowserImpl,
-  XBCDPSessionImpl,
-  XBContextImpl,
-  XBElementHandleImpl,
-  XBKeyboardImpl,
-  XBLocatorImpl,
   XBMouseImpl,
-  XBPageImpl,
+  XBKeyboardImpl,
+  waitForActionable,
   checkActionable,
-  connectToCDP,
-  findChrome,
-  getCDPTargets,
-  killChrome,
-  launch,
-  launchChrome,
   scrollIntoView,
-  waitForActionable,
-  waitForNetworkIdle
+  XBLocatorImpl,
+  XBElementHandleImpl,
+  XBPageImpl,
+  XBCDPSessionImpl,
+  XBContextImpl,
+  XBBrowserImpl,
+  createRuleEngine,
+  CDPConnection,
+  CDPProtocolError,
+  waitForNetworkIdle,
+  launch
 };