@midscene/web 1.9.8 → 1.10.1-beta-20260624112700.0

package/dist/es/cdp-proxy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cdp-proxy.mjs","sources":["../../src/cdp-proxy.ts"],"sourcesContent":["/**\n * CDP WebSocket Proxy — standalone process.\n *\n * Holds a persistent WebSocket connection to Chrome's CDP endpoint and\n * exposes a local WebSocket server. Midscene CLI processes connect to the\n * proxy instead of Chrome directly, so Chrome's \"Allow remote debugging\"\n * permission popup only fires once (when the proxy connects).\n *\n * Lifecycle notes:\n *  - When all downstream clients disconnect the proxy stays running but\n *    marks the upstream as needing reconnection. The actual reconnect is\n *    deferred to the moment the next client connects, so Chrome's CDP\n *    state (notably Target.setDiscoverTargets) is reset and the new\n *    client receives all targetCreated events.\n *  - On startup, if another proxy is already alive the new instance\n *    announces \"duplicate proxy detected\" on stderr and exits 0 without\n *    touching the existing metadata files.\n *\n * Exit conditions:\n *  1. Upstream Chrome connection closes or errors.\n *  2. No downstream client message for IDLE_TIMEOUT_MS (default 5 min).\n *  3. SIGTERM / SIGINT.\n *  4. Duplicate proxy detected on startup (exits 0 with stderr notice).\n *\n * Usage (spawned by mcp-tools-cdp.ts):\n *   node cdp-proxy.js <chrome-ws-endpoint>\n *\n * On startup, prints the proxy endpoint to stdout as a single JSON line:\n *   {\"endpoint\":\"ws://127.0.0.1:<port>/devtools/browser\"}\n * and writes:\n *   - PROXY_ENDPOINT_FILE — the local proxy URL above\n *   - PROXY_PID_FILE      — this process's pid\n *   - PROXY_UPSTREAM_FILE — the Chrome endpoint the proxy is connected to,\n *                           so callers can detect when the requested\n *                           upstream has changed and replace the proxy.\n */\n\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';\nimport { createServer } from 'node:http';\nimport WebSocket, { WebSocketServer } from 'ws';\nimport {\n  PROXY_ENDPOINT_FILE,\n  PROXY_PID_FILE,\n  PROXY_UPSTREAM_FILE,\n} from './cdp-proxy-constants';\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nconst IDLE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes\n\nconst chromeEndpoint = process.argv[2];\nif (!chromeEndpoint) {\n  process.stderr.write('Usage: node cdp-proxy.js <chrome-ws-endpoint>\\n');\n  process.exit(1);\n}\n\n// ---------------------------------------------------------------------------\n// Cleanup\n// ---------------------------------------------------------------------------\n\nfunction cleanupIfOwned() {\n  // Only clean up if the PID file exists and records *our* PID.\n  // If the file is missing (e.g. already deleted by killProxy()) or\n  // unreadable, skip cleanup — another process may have taken over.\n  try {\n    if (!existsSync(PROXY_PID_FILE)) return;\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    if (pid !== process.pid) return;\n  } catch {\n    return;\n  }\n  try {\n    if (existsSync(PROXY_ENDPOINT_FILE)) unlinkSync(PROXY_ENDPOINT_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_PID_FILE)) unlinkSync(PROXY_PID_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_UPSTREAM_FILE)) unlinkSync(PROXY_UPSTREAM_FILE);\n  } catch {}\n}\n\n/**\n * Maximum time to wait for the stderr drain callback before forcing exit.\n * The callback should normally fire within microseconds, but if the pipe\n * has been closed by the parent it may never run. 500ms is generous\n * enough to be effectively unreachable in the happy path while still\n * keeping the process from hanging if something goes wrong.\n */\nconst STDERR_FLUSH_FALLBACK_MS = 500;\n\n/**\n * Exit after the stderr diagnostic has been flushed.\n *\n * When the proxy's stderr is a pipe (parent uses stdio 'pipe'), Node's\n * process.stderr.write() is asynchronous on POSIX. Calling process.exit()\n * immediately afterwards can drop the pending write, which would silently\n * lose the very diagnostic the caller is relying on. Wait for the drain\n * callback before exiting, with a short fallback timer in case the\n * callback never fires (e.g. the pipe is already closed).\n */\nfunction exitWithStderr(message: string, code = 0): void {\n  let exited = false;\n  const doExit = () => {\n    if (exited) return;\n    exited = true;\n    process.exit(code);\n  };\n  const fallback = setTimeout(doExit, STDERR_FLUSH_FALLBACK_MS);\n  fallback.unref?.();\n  try {\n    process.stderr.write(message, () => doExit());\n  } catch {\n    doExit();\n  }\n}\n\nfunction shutdown(reason: string): void {\n  cleanupIfOwned();\n  exitWithStderr(`[cdp-proxy] shutting down: ${reason}\\n`, 0);\n}\n\nprocess.on('SIGTERM', () => shutdown('SIGTERM'));\nprocess.on('SIGINT', () => shutdown('SIGINT'));\nprocess.on('uncaughtException', (e) => shutdown(`uncaught: ${e.message}`));\n\n// ---------------------------------------------------------------------------\n// Idle timer\n// ---------------------------------------------------------------------------\n\nlet idleTimer: ReturnType<typeof setTimeout> | null = null;\n\nfunction resetIdleTimer() {\n  if (idleTimer) clearTimeout(idleTimer);\n  idleTimer = setTimeout(\n    () => shutdown('idle timeout (5min)'),\n    IDLE_TIMEOUT_MS,\n  );\n}\n\nresetIdleTimer();\n\n// ---------------------------------------------------------------------------\n// Upstream: connect to Chrome\n// ---------------------------------------------------------------------------\n\nconst clients = new Set<WebSocket>();\n\n/**\n * Whether we are intentionally reconnecting the upstream WebSocket.\n * When true, the old upstream's close/error events should not trigger shutdown.\n */\nlet reconnecting = false;\n\n/**\n * Whether the upstream WebSocket needs to be reconnected before the next\n * client can use it.  Set to true when all downstream clients disconnect;\n * the actual reconnect is deferred until a new client connects so that\n * Chrome's permission popup only fires when someone actually needs it.\n */\nlet needsUpstreamReconnect = false;\n\n/**\n * Messages from downstream clients that arrived while the upstream WebSocket\n * was not yet open (e.g. during a reconnect). Flushed once upstream opens.\n */\nconst pendingUpstreamMessages: {\n  data: WebSocket.RawData;\n  isBinary: boolean;\n}[] = [];\n\n/**\n * Create a new upstream WebSocket to Chrome and bind its event handlers.\n * Used for both initial connection and reconnection.\n */\nfunction createUpstream(endpoint: string): WebSocket {\n  const ws = new WebSocket(endpoint);\n\n  ws.on('error', (err) => {\n    // A failed reconnect must not leave the flag stuck on.\n    reconnecting = false;\n    shutdown(`upstream error: ${err.message}`);\n  });\n\n  ws.on('close', (code, reasonBuf) => {\n    if (reconnecting) return;\n    const reason = reasonBuf?.toString?.() || '';\n    const detail = reason\n      ? ` (code=${code}, reason=${reason})`\n      : ` (code=${code})`;\n    shutdown(`upstream closed${detail}`);\n  });\n\n  // Forward upstream messages to all downstream clients\n  ws.on('message', (data, isBinary) => {\n    resetIdleTimer();\n    for (const client of clients) {\n      if (client.readyState === WebSocket.OPEN) {\n        client.send(data, { binary: isBinary });\n      }\n    }\n  });\n\n  ws.on('open', () => {\n    reconnecting = false;\n    for (const msg of pendingUpstreamMessages) {\n      ws.send(msg.data, { binary: msg.isBinary });\n    }\n    pendingUpstreamMessages.length = 0;\n  });\n\n  return ws;\n}\n\nlet upstream = createUpstream(chromeEndpoint);\n\n/**\n * Reconnect the upstream WebSocket to Chrome.\n *\n * Called when all downstream clients have disconnected. This resets the CDP\n * protocol state on Chrome's side — critically, the Target.setDiscoverTargets\n * subscription — so the next client that connects gets a fresh session and\n * receives all targetCreated events.\n *\n * `reconnecting` is cleared by the new upstream's `open` (or `error`) handler,\n * not here — the new socket is still CONNECTING when this returns.\n */\nfunction reconnectUpstream() {\n  reconnecting = true;\n  upstream.removeAllListeners();\n  upstream.close();\n  upstream = createUpstream(chromeEndpoint);\n  resetIdleTimer();\n}\n\n// ---------------------------------------------------------------------------\n// Downstream: local WebSocket server\n// ---------------------------------------------------------------------------\n\nconst httpServer = createServer((_req, res) => {\n  res.writeHead(404);\n  res.end();\n});\n\nconst wss = new WebSocketServer({ server: httpServer });\n\nwss.on('connection', (clientWs) => {\n  // Reconnect the upstream WebSocket if the previous session ended.\n  // This resets Chrome's CDP protocol state (Target.setDiscoverTargets, etc.)\n  // so the new client receives all targetCreated events.\n  if (needsUpstreamReconnect && upstream.readyState === WebSocket.OPEN) {\n    reconnectUpstream();\n    needsUpstreamReconnect = false;\n  }\n\n  clients.add(clientWs);\n  resetIdleTimer();\n\n  // Forward downstream messages to upstream (buffer if upstream is reconnecting)\n  clientWs.on('message', (data, isBinary) => {\n    resetIdleTimer();\n    if (upstream.readyState === WebSocket.OPEN) {\n      upstream.send(data, { binary: isBinary });\n    } else {\n      pendingUpstreamMessages.push({ data, isBinary });\n    }\n  });\n\n  const removeClient = () => {\n    clients.delete(clientWs);\n    // When all downstream clients disconnect, mark that the upstream needs\n    // reconnecting to reset Chrome's CDP protocol state.  The actual\n    // reconnect is deferred until the next client connects so we don't\n    // trigger Chrome's permission popup while nobody is using the proxy.\n    if (clients.size === 0) {\n      pendingUpstreamMessages.length = 0;\n      needsUpstreamReconnect = true;\n    }\n  };\n\n  clientWs.on('close', removeClient);\n  clientWs.on('error', removeClient);\n});\n\n// ---------------------------------------------------------------------------\n// Start\n// ---------------------------------------------------------------------------\n\n// Start the HTTP/WebSocket server once the initial upstream connection opens.\n// This listener is added *after* createUpstream() already bound its own 'open'\n// handler (which flushes pendingUpstreamMessages), so both will fire.\nupstream.once('open', () => {\n  // Check for duplicate proxy\n  if (existsSync(PROXY_PID_FILE)) {\n    try {\n      const existingPid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n      if (existingPid !== process.pid) {\n        try {\n          process.kill(existingPid, 0);\n          // Another proxy is alive — exit without cleanupIfOwned() (we don't\n          // own the metadata files). Announce the reason on stderr so the\n          // parent process can distinguish this path from upstream failures,\n          // then bail out of this open handler so we don't proceed to listen().\n          exitWithStderr(\n            `[cdp-proxy] duplicate proxy detected (existing pid=${existingPid})\\n`,\n            0,\n          );\n          return;\n        } catch {\n          // dead — we take over\n        }\n      }\n    } catch {}\n  }\n\n  httpServer.listen(0, '127.0.0.1', () => {\n    const addr = httpServer.address();\n    if (!addr || typeof addr === 'string') {\n      shutdown('failed to get server address');\n      return;\n    }\n\n    const proxyEndpoint = `ws://127.0.0.1:${addr.port}/devtools/browser`;\n\n    writeFileSync(PROXY_ENDPOINT_FILE, proxyEndpoint);\n    writeFileSync(PROXY_PID_FILE, String(process.pid));\n    writeFileSync(PROXY_UPSTREAM_FILE, chromeEndpoint);\n\n    process.stdout.write(`${JSON.stringify({ endpoint: proxyEndpoint })}\\n`);\n  });\n});\n"],"names":["IDLE_TIMEOUT_MS","chromeEndpoint","process","cleanupIfOwned","existsSync","PROXY_PID_FILE","pid","Number","readFileSync","PROXY_ENDPOINT_FILE","unlinkSync","PROXY_UPSTREAM_FILE","STDERR_FLUSH_FALLBACK_MS","exitWithStderr","message","code","exited","doExit","fallback","setTimeout","shutdown","reason","e","idleTimer","resetIdleTimer","clearTimeout","clients","Set","reconnecting","needsUpstreamReconnect","pendingUpstreamMessages","createUpstream","endpoint","ws","WebSocket","err","reasonBuf","detail","data","isBinary","client","msg","upstream","reconnectUpstream","httpServer","createServer","_req","res","wss","WebSocketServer","clientWs","removeClient","existingPid","addr","proxyEndpoint","writeFileSync","String","JSON"],"mappings":"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"}
+{"version":3,"file":"cdp-proxy.mjs","sources":["../../src/cdp-proxy.ts"],"sourcesContent":["/**\n * CDP WebSocket Proxy — standalone process.\n *\n * Holds a persistent WebSocket connection to Chrome's CDP endpoint and\n * exposes a local WebSocket server. Midscene CLI processes connect to the\n * proxy instead of Chrome directly, so Chrome's \"Allow remote debugging\"\n * permission popup only fires once (when the proxy connects).\n *\n * Lifecycle notes:\n *  - When all downstream clients disconnect the proxy stays running but\n *    marks the upstream as needing reconnection. The actual reconnect is\n *    deferred to the moment the next client connects, so Chrome's CDP\n *    state (notably Target.setDiscoverTargets) is reset and the new\n *    client receives all targetCreated events.\n *  - On startup, if another proxy is already alive the new instance\n *    announces \"duplicate proxy detected\" on stderr and exits 0 without\n *    touching the existing metadata files.\n *\n * Exit conditions:\n *  1. Upstream Chrome connection closes or errors.\n *  2. No downstream client message for IDLE_TIMEOUT_MS (default 5 min).\n *  3. SIGTERM / SIGINT.\n *  4. Duplicate proxy detected on startup (exits 0 with stderr notice).\n *\n * Usage (spawned by agent-tools-cdp.ts):\n *   node cdp-proxy.js <chrome-ws-endpoint>\n *\n * On startup, prints the proxy endpoint to stdout as a single JSON line:\n *   {\"endpoint\":\"ws://127.0.0.1:<port>/devtools/browser\"}\n * and writes:\n *   - PROXY_ENDPOINT_FILE — the local proxy URL above\n *   - PROXY_PID_FILE      — this process's pid\n *   - PROXY_UPSTREAM_FILE — the Chrome endpoint the proxy is connected to,\n *                           so callers can detect when the requested\n *                           upstream has changed and replace the proxy.\n */\n\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';\nimport { createServer } from 'node:http';\nimport WebSocket, { WebSocketServer } from 'ws';\nimport {\n  PROXY_ENDPOINT_FILE,\n  PROXY_PID_FILE,\n  PROXY_UPSTREAM_FILE,\n} from './cdp-proxy-constants';\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nconst IDLE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes\n\nconst chromeEndpoint = process.argv[2];\nif (!chromeEndpoint) {\n  process.stderr.write('Usage: node cdp-proxy.js <chrome-ws-endpoint>\\n');\n  process.exit(1);\n}\n\n// ---------------------------------------------------------------------------\n// Cleanup\n// ---------------------------------------------------------------------------\n\nfunction cleanupIfOwned() {\n  // Only clean up if the PID file exists and records *our* PID.\n  // If the file is missing (e.g. already deleted by killProxy()) or\n  // unreadable, skip cleanup — another process may have taken over.\n  try {\n    if (!existsSync(PROXY_PID_FILE)) return;\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    if (pid !== process.pid) return;\n  } catch {\n    return;\n  }\n  try {\n    if (existsSync(PROXY_ENDPOINT_FILE)) unlinkSync(PROXY_ENDPOINT_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_PID_FILE)) unlinkSync(PROXY_PID_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_UPSTREAM_FILE)) unlinkSync(PROXY_UPSTREAM_FILE);\n  } catch {}\n}\n\n/**\n * Maximum time to wait for the stderr drain callback before forcing exit.\n * The callback should normally fire within microseconds, but if the pipe\n * has been closed by the parent it may never run. 500ms is generous\n * enough to be effectively unreachable in the happy path while still\n * keeping the process from hanging if something goes wrong.\n */\nconst STDERR_FLUSH_FALLBACK_MS = 500;\n\n/**\n * Exit after the stderr diagnostic has been flushed.\n *\n * When the proxy's stderr is a pipe (parent uses stdio 'pipe'), Node's\n * process.stderr.write() is asynchronous on POSIX. Calling process.exit()\n * immediately afterwards can drop the pending write, which would silently\n * lose the very diagnostic the caller is relying on. Wait for the drain\n * callback before exiting, with a short fallback timer in case the\n * callback never fires (e.g. the pipe is already closed).\n */\nfunction exitWithStderr(message: string, code = 0): void {\n  let exited = false;\n  const doExit = () => {\n    if (exited) return;\n    exited = true;\n    process.exit(code);\n  };\n  const fallback = setTimeout(doExit, STDERR_FLUSH_FALLBACK_MS);\n  fallback.unref?.();\n  try {\n    process.stderr.write(message, () => doExit());\n  } catch {\n    doExit();\n  }\n}\n\nfunction shutdown(reason: string): void {\n  cleanupIfOwned();\n  exitWithStderr(`[cdp-proxy] shutting down: ${reason}\\n`, 0);\n}\n\nprocess.on('SIGTERM', () => shutdown('SIGTERM'));\nprocess.on('SIGINT', () => shutdown('SIGINT'));\nprocess.on('uncaughtException', (e) => shutdown(`uncaught: ${e.message}`));\n\n// ---------------------------------------------------------------------------\n// Idle timer\n// ---------------------------------------------------------------------------\n\nlet idleTimer: ReturnType<typeof setTimeout> | null = null;\n\nfunction resetIdleTimer() {\n  if (idleTimer) clearTimeout(idleTimer);\n  idleTimer = setTimeout(\n    () => shutdown('idle timeout (5min)'),\n    IDLE_TIMEOUT_MS,\n  );\n}\n\nresetIdleTimer();\n\n// ---------------------------------------------------------------------------\n// Upstream: connect to Chrome\n// ---------------------------------------------------------------------------\n\nconst clients = new Set<WebSocket>();\n\n/**\n * Whether we are intentionally reconnecting the upstream WebSocket.\n * When true, the old upstream's close/error events should not trigger shutdown.\n */\nlet reconnecting = false;\n\n/**\n * Whether the upstream WebSocket needs to be reconnected before the next\n * client can use it.  Set to true when all downstream clients disconnect;\n * the actual reconnect is deferred until a new client connects so that\n * Chrome's permission popup only fires when someone actually needs it.\n */\nlet needsUpstreamReconnect = false;\n\n/**\n * Messages from downstream clients that arrived while the upstream WebSocket\n * was not yet open (e.g. during a reconnect). Flushed once upstream opens.\n */\nconst pendingUpstreamMessages: {\n  data: WebSocket.RawData;\n  isBinary: boolean;\n}[] = [];\n\n/**\n * Create a new upstream WebSocket to Chrome and bind its event handlers.\n * Used for both initial connection and reconnection.\n */\nfunction createUpstream(endpoint: string): WebSocket {\n  const ws = new WebSocket(endpoint);\n\n  ws.on('error', (err) => {\n    // A failed reconnect must not leave the flag stuck on.\n    reconnecting = false;\n    shutdown(`upstream error: ${err.message}`);\n  });\n\n  ws.on('close', (code, reasonBuf) => {\n    if (reconnecting) return;\n    const reason = reasonBuf?.toString?.() || '';\n    const detail = reason\n      ? ` (code=${code}, reason=${reason})`\n      : ` (code=${code})`;\n    shutdown(`upstream closed${detail}`);\n  });\n\n  // Forward upstream messages to all downstream clients\n  ws.on('message', (data, isBinary) => {\n    resetIdleTimer();\n    for (const client of clients) {\n      if (client.readyState === WebSocket.OPEN) {\n        client.send(data, { binary: isBinary });\n      }\n    }\n  });\n\n  ws.on('open', () => {\n    reconnecting = false;\n    for (const msg of pendingUpstreamMessages) {\n      ws.send(msg.data, { binary: msg.isBinary });\n    }\n    pendingUpstreamMessages.length = 0;\n  });\n\n  return ws;\n}\n\nlet upstream = createUpstream(chromeEndpoint);\n\n/**\n * Reconnect the upstream WebSocket to Chrome.\n *\n * Called when all downstream clients have disconnected. This resets the CDP\n * protocol state on Chrome's side — critically, the Target.setDiscoverTargets\n * subscription — so the next client that connects gets a fresh session and\n * receives all targetCreated events.\n *\n * `reconnecting` is cleared by the new upstream's `open` (or `error`) handler,\n * not here — the new socket is still CONNECTING when this returns.\n */\nfunction reconnectUpstream() {\n  reconnecting = true;\n  upstream.removeAllListeners();\n  upstream.close();\n  upstream = createUpstream(chromeEndpoint);\n  resetIdleTimer();\n}\n\n// ---------------------------------------------------------------------------\n// Downstream: local WebSocket server\n// ---------------------------------------------------------------------------\n\nconst httpServer = createServer((_req, res) => {\n  res.writeHead(404);\n  res.end();\n});\n\nconst wss = new WebSocketServer({ server: httpServer });\n\nwss.on('connection', (clientWs) => {\n  // Reconnect the upstream WebSocket if the previous session ended.\n  // This resets Chrome's CDP protocol state (Target.setDiscoverTargets, etc.)\n  // so the new client receives all targetCreated events.\n  if (needsUpstreamReconnect && upstream.readyState === WebSocket.OPEN) {\n    reconnectUpstream();\n    needsUpstreamReconnect = false;\n  }\n\n  clients.add(clientWs);\n  resetIdleTimer();\n\n  // Forward downstream messages to upstream (buffer if upstream is reconnecting)\n  clientWs.on('message', (data, isBinary) => {\n    resetIdleTimer();\n    if (upstream.readyState === WebSocket.OPEN) {\n      upstream.send(data, { binary: isBinary });\n    } else {\n      pendingUpstreamMessages.push({ data, isBinary });\n    }\n  });\n\n  const removeClient = () => {\n    clients.delete(clientWs);\n    // When all downstream clients disconnect, mark that the upstream needs\n    // reconnecting to reset Chrome's CDP protocol state.  The actual\n    // reconnect is deferred until the next client connects so we don't\n    // trigger Chrome's permission popup while nobody is using the proxy.\n    if (clients.size === 0) {\n      pendingUpstreamMessages.length = 0;\n      needsUpstreamReconnect = true;\n    }\n  };\n\n  clientWs.on('close', removeClient);\n  clientWs.on('error', removeClient);\n});\n\n// ---------------------------------------------------------------------------\n// Start\n// ---------------------------------------------------------------------------\n\n// Start the HTTP/WebSocket server once the initial upstream connection opens.\n// This listener is added *after* createUpstream() already bound its own 'open'\n// handler (which flushes pendingUpstreamMessages), so both will fire.\nupstream.once('open', () => {\n  // Check for duplicate proxy\n  if (existsSync(PROXY_PID_FILE)) {\n    try {\n      const existingPid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n      if (existingPid !== process.pid) {\n        try {\n          process.kill(existingPid, 0);\n          // Another proxy is alive — exit without cleanupIfOwned() (we don't\n          // own the metadata files). Announce the reason on stderr so the\n          // parent process can distinguish this path from upstream failures,\n          // then bail out of this open handler so we don't proceed to listen().\n          exitWithStderr(\n            `[cdp-proxy] duplicate proxy detected (existing pid=${existingPid})\\n`,\n            0,\n          );\n          return;\n        } catch {\n          // dead — we take over\n        }\n      }\n    } catch {}\n  }\n\n  httpServer.listen(0, '127.0.0.1', () => {\n    const addr = httpServer.address();\n    if (!addr || typeof addr === 'string') {\n      shutdown('failed to get server address');\n      return;\n    }\n\n    const proxyEndpoint = `ws://127.0.0.1:${addr.port}/devtools/browser`;\n\n    writeFileSync(PROXY_ENDPOINT_FILE, proxyEndpoint);\n    writeFileSync(PROXY_PID_FILE, String(process.pid));\n    writeFileSync(PROXY_UPSTREAM_FILE, chromeEndpoint);\n\n    process.stdout.write(`${JSON.stringify({ endpoint: proxyEndpoint })}\\n`);\n  });\n});\n"],"names":["IDLE_TIMEOUT_MS","chromeEndpoint","process","cleanupIfOwned","existsSync","PROXY_PID_FILE","pid","Number","readFileSync","PROXY_ENDPOINT_FILE","unlinkSync","PROXY_UPSTREAM_FILE","STDERR_FLUSH_FALLBACK_MS","exitWithStderr","message","code","exited","doExit","fallback","setTimeout","shutdown","reason","e","idleTimer","resetIdleTimer","clearTimeout","clients","Set","reconnecting","needsUpstreamReconnect","pendingUpstreamMessages","createUpstream","endpoint","ws","WebSocket","err","reasonBuf","detail","data","isBinary","client","msg","upstream","reconnectUpstream","httpServer","createServer","_req","res","wss","WebSocketServer","clientWs","removeClient","existingPid","addr","proxyEndpoint","writeFileSync","String","JSON"],"mappings":"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"}

package/dist/es/cdp-target-store.mjs

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { getDebug } from "@midscene/shared/logger";
 import { TARGET_ID_FILE } from "./cdp-proxy-constants.mjs";
-const debug = getDebug('mcp:cdp:target-store');
+const debug = getDebug('agent-tools:cdp:target-store');
 function readSavedTargetId() {
     if (!existsSync(TARGET_ID_FILE)) return null;
     try {

package/dist/es/cdp-target-store.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cdp-target-store.mjs","sources":["../../src/cdp-target-store.ts"],"sourcesContent":["/**\n * Persistent store for the CDP-mode \"current tab\" targetId.\n *\n * The Midscene CLI runs each command as a fresh Node process, so anything\n * the previous command knew about which tab was being driven must survive\n * across processes. This store writes the chosen targetId to a temp file\n * after `connect`/`act`/etc. succeed, and the next command reads it back\n * to bind to the exact same tab — even when Chrome holds 14 of them.\n *\n * Owns nothing else. The CDP proxy lifecycle and its own metadata files\n * live in `cdp-proxy-manager.ts`.\n */\n\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';\nimport { getDebug } from '@midscene/shared/logger';\nimport { TARGET_ID_FILE } from './cdp-proxy-constants';\n\nconst debug = getDebug('mcp:cdp:target-store');\n\n/**\n * Read the saved targetId, or null if no command has stored one yet.\n */\nexport function readSavedTargetId(): string | null {\n  if (!existsSync(TARGET_ID_FILE)) return null;\n  try {\n    return readFileSync(TARGET_ID_FILE, 'utf-8').trim() || null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Save a targetId so the next CLI command can rebind to the same tab.\n */\nexport function saveTargetId(targetId: string): void {\n  try {\n    writeFileSync(TARGET_ID_FILE, targetId, 'utf-8');\n    debug('Saved targetId: %s', targetId);\n  } catch (err) {\n    debug('Failed to save targetId: %s', err);\n  }\n}\n\n/**\n * Discard the saved targetId — call when disconnecting or when the\n * upstream Chrome changes (the targetId would point into the old\n * browser's tab list).\n */\nexport function cleanupTargetIdFile(): void {\n  try {\n    if (existsSync(TARGET_ID_FILE)) unlinkSync(TARGET_ID_FILE);\n  } catch {}\n}\n"],"names":["debug","getDebug","readSavedTargetId","existsSync","TARGET_ID_FILE","readFileSync","saveTargetId","targetId","writeFileSync","err","cleanupTargetIdFile","unlinkSync"],"mappings":";;;AAiBA,MAAMA,QAAQC,SAAS;AAKhB,SAASC;IACd,IAAI,CAACC,WAAWC,iBAAiB,OAAO;IACxC,IAAI;QACF,OAAOC,aAAaD,gBAAgB,SAAS,IAAI,MAAM;IACzD,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAKO,SAASE,aAAaC,QAAgB;IAC3C,IAAI;QACFC,cAAcJ,gBAAgBG,UAAU;QACxCP,MAAM,sBAAsBO;IAC9B,EAAE,OAAOE,KAAK;QACZT,MAAM,+BAA+BS;IACvC;AACF;AAOO,SAASC;IACd,IAAI;QACF,IAAIP,WAAWC,iBAAiBO,WAAWP;IAC7C,EAAE,OAAM,CAAC;AACX"}
+{"version":3,"file":"cdp-target-store.mjs","sources":["../../src/cdp-target-store.ts"],"sourcesContent":["/**\n * Persistent store for the CDP-mode \"current tab\" targetId.\n *\n * The Midscene CLI runs each command as a fresh Node process, so anything\n * the previous command knew about which tab was being driven must survive\n * across processes. This store writes the chosen targetId to a temp file\n * after `connect`/`act`/etc. succeed, and the next command reads it back\n * to bind to the exact same tab — even when Chrome holds 14 of them.\n *\n * Owns nothing else. The CDP proxy lifecycle and its own metadata files\n * live in `cdp-proxy-manager.ts`.\n */\n\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';\nimport { getDebug } from '@midscene/shared/logger';\nimport { TARGET_ID_FILE } from './cdp-proxy-constants';\n\nconst debug = getDebug('agent-tools:cdp:target-store');\n\n/**\n * Read the saved targetId, or null if no command has stored one yet.\n */\nexport function readSavedTargetId(): string | null {\n  if (!existsSync(TARGET_ID_FILE)) return null;\n  try {\n    return readFileSync(TARGET_ID_FILE, 'utf-8').trim() || null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Save a targetId so the next CLI command can rebind to the same tab.\n */\nexport function saveTargetId(targetId: string): void {\n  try {\n    writeFileSync(TARGET_ID_FILE, targetId, 'utf-8');\n    debug('Saved targetId: %s', targetId);\n  } catch (err) {\n    debug('Failed to save targetId: %s', err);\n  }\n}\n\n/**\n * Discard the saved targetId — call when disconnecting or when the\n * upstream Chrome changes (the targetId would point into the old\n * browser's tab list).\n */\nexport function cleanupTargetIdFile(): void {\n  try {\n    if (existsSync(TARGET_ID_FILE)) unlinkSync(TARGET_ID_FILE);\n  } catch {}\n}\n"],"names":["debug","getDebug","readSavedTargetId","existsSync","TARGET_ID_FILE","readFileSync","saveTargetId","targetId","writeFileSync","err","cleanupTargetIdFile","unlinkSync"],"mappings":";;;AAiBA,MAAMA,QAAQC,SAAS;AAKhB,SAASC;IACd,IAAI,CAACC,WAAWC,iBAAiB,OAAO;IACxC,IAAI;QACF,OAAOC,aAAaD,gBAAgB,SAAS,IAAI,MAAM;IACzD,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAKO,SAASE,aAAaC,QAAgB;IAC3C,IAAI;QACFC,cAAcJ,gBAAgBG,UAAU;QACxCP,MAAM,sBAAsBO;IAC9B,EAAE,OAAOE,KAAK;QACZT,MAAM,+BAA+BS;IACvC;AACF;AAOO,SAASC;IACd,IAAI;QACF,IAAIP,WAAWC,iBAAiBO,WAAWP;IAC7C,EAAE,OAAM,CAAC;AACX"}

package/dist/es/cli.mjs

@@ -3,10 +3,10 @@ import { join } from "node:path";
 import { createReportCliCommands } from "@midscene/core";
 import { reportCLIError, runToolsCLI } from "@midscene/shared/cli";
 import dotenv from "dotenv";
+import { WebMidsceneTools } from "./agent-tools.mjs";
+import { WebCdpMidsceneTools } from "./agent-tools-cdp.mjs";
+import { WebPuppeteerMidsceneTools } from "./agent-tools-puppeteer.mjs";
 import { parseWebCliOptions } from "./cli-options.mjs";
-import { WebMidsceneTools } from "./mcp-tools.mjs";
-import { WebCdpMidsceneTools } from "./mcp-tools-cdp.mjs";
-import { WebPuppeteerMidsceneTools } from "./mcp-tools-puppeteer.mjs";
 const envFile = join(process.cwd(), '.env');
 if (existsSync(envFile)) dotenv.config({
     path: envFile
@@ -18,7 +18,7 @@ Promise.resolve().then(()=>{
     return runToolsCLI(tools, 'midscene-web', {
         stripPrefix: 'web_',
         argv: parsedOptions.argv,
-        version: "1.9.8",
+        version: "1.10.1-beta-20260624112700.0",
         extraCommands: createReportCliCommands()
     });
 }).catch((e)=>{

package/dist/es/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","sources":["../../src/cli.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { createReportCliCommands } from '@midscene/core';\nimport { reportCLIError, runToolsCLI } from '@midscene/shared/cli';\nimport dotenv from 'dotenv';\nimport { parseWebCliOptions } from './cli-options';\nimport { WebMidsceneTools } from './mcp-tools';\nimport { WebCdpMidsceneTools } from './mcp-tools-cdp';\nimport { WebPuppeteerMidsceneTools } from './mcp-tools-puppeteer';\n\n// Load .env early so MIDSCENE_CDP_ENDPOINT is available during arg parsing\nconst envFile = join(process.cwd(), '.env');\nif (existsSync(envFile)) {\n  dotenv.config({ path: envFile });\n}\n\ndeclare const __VERSION__: string;\n\nPromise.resolve()\n  .then(() => {\n    const parsedOptions = parseWebCliOptions(process.argv.slice(2));\n\n    let tools:\n      | WebMidsceneTools\n      | WebPuppeteerMidsceneTools\n      | WebCdpMidsceneTools;\n    if (parsedOptions.mode === 'bridge') {\n      tools = new WebMidsceneTools();\n    } else if (parsedOptions.mode === 'cdp') {\n      tools = new WebCdpMidsceneTools(parsedOptions.cdpEndpoint!);\n    } else {\n      tools = new WebPuppeteerMidsceneTools(parsedOptions.viewport);\n    }\n\n    return runToolsCLI(tools, 'midscene-web', {\n      stripPrefix: 'web_',\n      argv: parsedOptions.argv,\n      version: __VERSION__,\n      extraCommands: createReportCliCommands(),\n    });\n  })\n  .catch((e) => {\n    process.exit(reportCLIError(e));\n  });\n"],"names":["envFile","join","process","existsSync","dotenv","Promise","parsedOptions","parseWebCliOptions","tools","WebMidsceneTools","WebCdpMidsceneTools","WebPuppeteerMidsceneTools","runToolsCLI","__VERSION__","createReportCliCommands","e","reportCLIError"],"mappings":";;;;;;;;;AAWA,MAAMA,UAAUC,KAAKC,QAAQ,GAAG,IAAI;AACpC,IAAIC,WAAWH,UACbI,OAAO,MAAM,CAAC;IAAE,MAAMJ;AAAQ;AAKhCK,QAAQ,OAAO,GACZ,IAAI,CAAC;IACJ,MAAMC,gBAAgBC,mBAAmBL,QAAQ,IAAI,CAAC,KAAK,CAAC;IAE5D,IAAIM;IAKFA,QADEF,AAAuB,aAAvBA,cAAc,IAAI,GACZ,IAAIG,qBACHH,AAAuB,UAAvBA,cAAc,IAAI,GACnB,IAAII,oBAAoBJ,cAAc,WAAW,IAEjD,IAAIK,0BAA0BL,cAAc,QAAQ;IAG9D,OAAOM,YAAYJ,OAAO,gBAAgB;QACxC,aAAa;QACb,MAAMF,cAAc,IAAI;QACxB,SAASO;QACT,eAAeC;IACjB;AACF,GACC,KAAK,CAAC,CAACC;IACNb,QAAQ,IAAI,CAACc,eAAeD;AAC9B"}
+{"version":3,"file":"cli.mjs","sources":["../../src/cli.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { createReportCliCommands } from '@midscene/core';\nimport { reportCLIError, runToolsCLI } from '@midscene/shared/cli';\nimport dotenv from 'dotenv';\nimport { WebMidsceneTools } from './agent-tools';\nimport { WebCdpMidsceneTools } from './agent-tools-cdp';\nimport { WebPuppeteerMidsceneTools } from './agent-tools-puppeteer';\nimport { parseWebCliOptions } from './cli-options';\n\n// Load .env early so MIDSCENE_CDP_ENDPOINT is available during arg parsing\nconst envFile = join(process.cwd(), '.env');\nif (existsSync(envFile)) {\n  dotenv.config({ path: envFile });\n}\n\ndeclare const __VERSION__: string;\n\nPromise.resolve()\n  .then(() => {\n    const parsedOptions = parseWebCliOptions(process.argv.slice(2));\n\n    let tools:\n      | WebMidsceneTools\n      | WebPuppeteerMidsceneTools\n      | WebCdpMidsceneTools;\n    if (parsedOptions.mode === 'bridge') {\n      tools = new WebMidsceneTools();\n    } else if (parsedOptions.mode === 'cdp') {\n      tools = new WebCdpMidsceneTools(parsedOptions.cdpEndpoint!);\n    } else {\n      tools = new WebPuppeteerMidsceneTools(parsedOptions.viewport);\n    }\n\n    return runToolsCLI(tools, 'midscene-web', {\n      stripPrefix: 'web_',\n      argv: parsedOptions.argv,\n      version: __VERSION__,\n      extraCommands: createReportCliCommands(),\n    });\n  })\n  .catch((e) => {\n    process.exit(reportCLIError(e));\n  });\n"],"names":["envFile","join","process","existsSync","dotenv","Promise","parsedOptions","parseWebCliOptions","tools","WebMidsceneTools","WebCdpMidsceneTools","WebPuppeteerMidsceneTools","runToolsCLI","__VERSION__","createReportCliCommands","e","reportCLIError"],"mappings":";;;;;;;;;AAWA,MAAMA,UAAUC,KAAKC,QAAQ,GAAG,IAAI;AACpC,IAAIC,WAAWH,UACbI,OAAO,MAAM,CAAC;IAAE,MAAMJ;AAAQ;AAKhCK,QAAQ,OAAO,GACZ,IAAI,CAAC;IACJ,MAAMC,gBAAgBC,mBAAmBL,QAAQ,IAAI,CAAC,KAAK,CAAC;IAE5D,IAAIM;IAKFA,QADEF,AAAuB,aAAvBA,cAAc,IAAI,GACZ,IAAIG,qBACHH,AAAuB,UAAvBA,cAAc,IAAI,GACnB,IAAII,oBAAoBJ,cAAc,WAAW,IAEjD,IAAIK,0BAA0BL,cAAc,QAAQ;IAG9D,OAAOM,YAAYJ,OAAO,gBAAgB;QACxC,aAAa;QACb,MAAMF,cAAc,IAAI;QACxB,SAASO;QACT,eAAeC;IACjB;AACF,GACC,KAAK,CAAC,CAACC;IACNb,QAAQ,IAAI,CAACc,eAAeD;AAC9B"}

package/dist/es/index.mjs

@@ -2,7 +2,7 @@ import { PlaywrightAgent, PlaywrightAiFixture } from "./playwright/index.mjs";
 import { Agent } from "@midscene/core/agent";
 import { PuppeteerAgent } from "./puppeteer/index.mjs";
 import { StaticPage, StaticPageAgent } from "./static/index.mjs";
-import { WebMidsceneTools } from "./mcp-tools.mjs";
+import { WebMidsceneTools } from "./agent-tools.mjs";
 import { webPlaygroundPlatform } from "./platform.mjs";
-import { WebCdpMidsceneTools } from "./mcp-tools-cdp.mjs";
+import { WebCdpMidsceneTools } from "./agent-tools-cdp.mjs";
 export { Agent as PageAgent, PlaywrightAgent, PlaywrightAiFixture, PuppeteerAgent, StaticPage, StaticPageAgent, WebCdpMidsceneTools, WebMidsceneTools, webPlaygroundPlatform };

package/dist/es/playwright/index.mjs

@@ -24,11 +24,13 @@ class PlaywrightAgent extends Agent {
         if (!page) throw new Error('[midscene] PlaywrightAgent requires a valid Playwright page instance. Please make sure to pass a valid page object.');
         const webPage = new WebPage(page, opts);
         super(webPage, opts);
-        const { forceSameTabNavigation = true, forceChromeSelectRendering } = opts ?? {};
+        const { forceSameTabNavigation = true, forceChromeSelectRendering = true } = opts ?? {};
         if (forceSameTabNavigation) forceClosePopup(page, debug);
         if (forceChromeSelectRendering) {
-            const playwrightVersion = getPlaywrightVersion();
-            if (playwrightVersion && !semver.gte(playwrightVersion, '1.52.0')) console.warn(`[midscene:error] forceChromeSelectRendering requires Playwright >= 1.52.0, but current version is ${playwrightVersion}. This feature may not work correctly.`);
+            if (opts?.forceChromeSelectRendering === true) {
+                const playwrightVersion = getPlaywrightVersion();
+                if (playwrightVersion && !semver.gte(playwrightVersion, '1.52.0')) console.warn(`[midscene:error] forceChromeSelectRendering requires Playwright >= 1.52.0, but current version is ${playwrightVersion}. This feature may not work correctly.`);
+            }
             base_page_mjs_forceChromeSelectRendering(page);
         }
     }

package/dist/es/playwright/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"playwright/index.mjs","sources":["../../../src/playwright/index.ts"],"sourcesContent":["import { Agent as PageAgent } from '@midscene/core/agent';\nimport type { Page as PlaywrightPage } from 'playwright';\nimport { WebPage as PlaywrightWebPage } from './page';\n\nexport type {\n  PlayWrightAiFixtureType,\n  PlaywrightAiFixtureOptions,\n} from './ai-fixture';\nexport { PlaywrightAiFixture } from './ai-fixture';\nexport { overrideAIConfig } from '@midscene/shared/env';\nexport { WebPage as PlaywrightWebPage } from './page';\nexport type { WebPageAgentOpt } from '@/web-element';\nimport type { WebPageAgentOpt } from '@/web-element';\nimport { getDebug } from '@midscene/shared/logger';\nimport semver from 'semver';\nimport {\n  BROWSER_NAVIGATION_ERROR_PATTERN,\n  forceChromeSelectRendering as applyChromeSelectRendering,\n  forceClosePopup,\n} from '../puppeteer/base-page';\nimport { getWebpackRequire } from '../utils';\n\nconst debug = getDebug('playwright:agent');\n\n/**\n * Get Playwright version from package.json\n */\nfunction getPlaywrightVersion(): string | null {\n  try {\n    const playwrightPkg = getWebpackRequire()('playwright/package.json');\n    return playwrightPkg.version || null;\n  } catch (error) {\n    console.error('[midscene:error] Failed to get Playwright version', error);\n    return null;\n  }\n}\n\nexport class PlaywrightAgent extends PageAgent<PlaywrightWebPage> {\n  protected isRetryableContextError(error: unknown): boolean {\n    return (\n      error instanceof Error &&\n      BROWSER_NAVIGATION_ERROR_PATTERN.test(error.message)\n    );\n  }\n\n  constructor(page: PlaywrightPage, opts?: WebPageAgentOpt) {\n    if (!page) {\n      throw new Error(\n        '[midscene] PlaywrightAgent requires a valid Playwright page instance. Please make sure to pass a valid page object.',\n      );\n    }\n    const webPage = new PlaywrightWebPage(page, opts);\n    super(webPage, opts);\n\n    const { forceSameTabNavigation = true, forceChromeSelectRendering } =\n      opts ?? {};\n\n    if (forceSameTabNavigation) {\n      forceClosePopup(page, debug);\n    }\n\n    if (forceChromeSelectRendering) {\n      // Check Playwright version requirement (>= 1.52)\n      const playwrightVersion = getPlaywrightVersion();\n      if (playwrightVersion && !semver.gte(playwrightVersion, '1.52.0')) {\n        console.warn(\n          `[midscene:error] forceChromeSelectRendering requires Playwright >= 1.52.0, but current version is ${playwrightVersion}. This feature may not work correctly.`,\n        );\n      }\n      applyChromeSelectRendering(page);\n    }\n  }\n}\n"],"names":["debug","getDebug","getPlaywrightVersion","playwrightPkg","getWebpackRequire","error","console","PlaywrightAgent","PageAgent","Error","BROWSER_NAVIGATION_ERROR_PATTERN","page","opts","webPage","PlaywrightWebPage","forceSameTabNavigation","forceChromeSelectRendering","forceClosePopup","playwrightVersion","semver","applyChromeSelectRendering"],"mappings":";;;;;;;;AAsBA,MAAMA,QAAQC,SAAS;AAKvB,SAASC;IACP,IAAI;QACF,MAAMC,gBAAgBC,oBAAoB;QAC1C,OAAOD,cAAc,OAAO,IAAI;IAClC,EAAE,OAAOE,OAAO;QACdC,QAAQ,KAAK,CAAC,qDAAqDD;QACnE,OAAO;IACT;AACF;AAEO,MAAME,wBAAwBC;IACzB,wBAAwBH,KAAc,EAAW;QACzD,OACEA,iBAAiBI,SACjBC,iCAAiC,IAAI,CAACL,MAAM,OAAO;IAEvD;IAEA,YAAYM,IAAoB,EAAEC,IAAsB,CAAE;QACxD,IAAI,CAACD,MACH,MAAM,IAAIF,MACR;QAGJ,MAAMI,UAAU,IAAIC,QAAkBH,MAAMC;QAC5C,KAAK,CAACC,SAASD;QAEf,MAAM,EAAEG,yBAAyB,IAAI,EAAEC,0BAA0B,EAAE,GACjEJ,QAAQ,CAAC;QAEX,IAAIG,wBACFE,gBAAgBN,MAAMX;QAGxB,IAAIgB,4BAA4B;YAE9B,MAAME,oBAAoBhB;YAC1B,IAAIgB,qBAAqB,CAACC,OAAO,GAAG,CAACD,mBAAmB,WACtDZ,QAAQ,IAAI,CACV,CAAC,kGAAkG,EAAEY,kBAAkB,sCAAsC,CAAC;YAGlKE,yCAA2BT;QAC7B;IACF;AACF"}
+{"version":3,"file":"playwright/index.mjs","sources":["../../../src/playwright/index.ts"],"sourcesContent":["import { Agent as PageAgent } from '@midscene/core/agent';\nimport type { Page as PlaywrightPage } from 'playwright';\nimport { WebPage as PlaywrightWebPage } from './page';\n\nexport type {\n  PlayWrightAiFixtureType,\n  PlaywrightAiFixtureOptions,\n} from './ai-fixture';\nexport { PlaywrightAiFixture } from './ai-fixture';\nexport { overrideAIConfig } from '@midscene/shared/env';\nexport { WebPage as PlaywrightWebPage } from './page';\nexport type { WebPageAgentOpt } from '@/web-element';\nimport type { WebPageAgentOpt } from '@/web-element';\nimport { getDebug } from '@midscene/shared/logger';\nimport semver from 'semver';\nimport {\n  BROWSER_NAVIGATION_ERROR_PATTERN,\n  forceChromeSelectRendering as applyChromeSelectRendering,\n  forceClosePopup,\n} from '../puppeteer/base-page';\nimport { getWebpackRequire } from '../utils';\n\nconst debug = getDebug('playwright:agent');\n\n/**\n * Get Playwright version from package.json\n */\nfunction getPlaywrightVersion(): string | null {\n  try {\n    const playwrightPkg = getWebpackRequire()('playwright/package.json');\n    return playwrightPkg.version || null;\n  } catch (error) {\n    console.error('[midscene:error] Failed to get Playwright version', error);\n    return null;\n  }\n}\n\nexport class PlaywrightAgent extends PageAgent<PlaywrightWebPage> {\n  protected isRetryableContextError(error: unknown): boolean {\n    return (\n      error instanceof Error &&\n      BROWSER_NAVIGATION_ERROR_PATTERN.test(error.message)\n    );\n  }\n\n  constructor(page: PlaywrightPage, opts?: WebPageAgentOpt) {\n    if (!page) {\n      throw new Error(\n        '[midscene] PlaywrightAgent requires a valid Playwright page instance. Please make sure to pass a valid page object.',\n      );\n    }\n    const webPage = new PlaywrightWebPage(page, opts);\n    super(webPage, opts);\n\n    const { forceSameTabNavigation = true, forceChromeSelectRendering = true } =\n      opts ?? {};\n\n    if (forceSameTabNavigation) {\n      forceClosePopup(page, debug);\n    }\n\n    if (forceChromeSelectRendering) {\n      // Only warn about version requirements when the user explicitly opted in;\n      // it is on by default, so we should not nag users on older Playwright.\n      if (opts?.forceChromeSelectRendering === true) {\n        const playwrightVersion = getPlaywrightVersion();\n        if (playwrightVersion && !semver.gte(playwrightVersion, '1.52.0')) {\n          console.warn(\n            `[midscene:error] forceChromeSelectRendering requires Playwright >= 1.52.0, but current version is ${playwrightVersion}. This feature may not work correctly.`,\n          );\n        }\n      }\n      applyChromeSelectRendering(page);\n    }\n  }\n}\n"],"names":["debug","getDebug","getPlaywrightVersion","playwrightPkg","getWebpackRequire","error","console","PlaywrightAgent","PageAgent","Error","BROWSER_NAVIGATION_ERROR_PATTERN","page","opts","webPage","PlaywrightWebPage","forceSameTabNavigation","forceChromeSelectRendering","forceClosePopup","playwrightVersion","semver","applyChromeSelectRendering"],"mappings":";;;;;;;;AAsBA,MAAMA,QAAQC,SAAS;AAKvB,SAASC;IACP,IAAI;QACF,MAAMC,gBAAgBC,oBAAoB;QAC1C,OAAOD,cAAc,OAAO,IAAI;IAClC,EAAE,OAAOE,OAAO;QACdC,QAAQ,KAAK,CAAC,qDAAqDD;QACnE,OAAO;IACT;AACF;AAEO,MAAME,wBAAwBC;IACzB,wBAAwBH,KAAc,EAAW;QACzD,OACEA,iBAAiBI,SACjBC,iCAAiC,IAAI,CAACL,MAAM,OAAO;IAEvD;IAEA,YAAYM,IAAoB,EAAEC,IAAsB,CAAE;QACxD,IAAI,CAACD,MACH,MAAM,IAAIF,MACR;QAGJ,MAAMI,UAAU,IAAIC,QAAkBH,MAAMC;QAC5C,KAAK,CAACC,SAASD;QAEf,MAAM,EAAEG,yBAAyB,IAAI,EAAEC,6BAA6B,IAAI,EAAE,GACxEJ,QAAQ,CAAC;QAEX,IAAIG,wBACFE,gBAAgBN,MAAMX;QAGxB,IAAIgB,4BAA4B;YAG9B,IAAIJ,MAAM,+BAA+B,MAAM;gBAC7C,MAAMM,oBAAoBhB;gBAC1B,IAAIgB,qBAAqB,CAACC,OAAO,GAAG,CAACD,mBAAmB,WACtDZ,QAAQ,IAAI,CACV,CAAC,kGAAkG,EAAEY,kBAAkB,sCAAsC,CAAC;YAGpK;YACAE,yCAA2BT;QAC7B;IACF;AACF"}

package/dist/es/puppeteer/base-page.mjs

@@ -179,17 +179,15 @@ class Page {
                 const errorMsg = error instanceof Error ? error.message : String(error);
                 console.warn(`[Midscene] Playwright screenshot failed: ${errorMsg}. Falling back to CDP screenshot.`);
                 debugPage('playwright screenshot failed, trying CDP fallback: %s', error);
-                base64 = await this.screenshotBase64ByPlaywrightCdp(page, imgType, quality);
+                base64 = await this.screenshotBase64ByPlaywrightCdp(imgType, quality);
             }
         } else throw new Error('Unsupported page type for screenshot');
         const endTime = Date.now();
         debugPage(`screenshotBase64 end, cost: ${endTime - startTime}ms`);
         return base64;
     }
-    async screenshotBase64ByPlaywrightCdp(page, imgType, quality) {
-        const browserName = page.context().browser()?.browserType().name();
-        if (browserName && 'chromium' !== browserName) throw new Error(`CDP screenshot fallback requires Chromium-based browser, but current browser is "${browserName}".`);
-        const client = await page.context().newCDPSession(page);
+    async screenshotBase64ByPlaywrightCdp(imgType, quality) {
+        const client = await this.createPageCdpSession('CDP screenshot fallback');
         try {
             const result = await new Promise((resolve, reject)=>{
                 const timeoutId = setTimeout(()=>{
@@ -215,14 +213,18 @@ class Page {
             });
         }
     }
-    async createScreencastCdpSession() {
+    async createPageCdpSession(featureName) {
         if ('puppeteer' === this.interfaceType) {
             const page = this.underlyingPage;
-            return await page.target().createCDPSession();
+            const pageWithCdp = page;
+            if ('function' == typeof pageWithCdp.createCDPSession) return await pageWithCdp.createCDPSession();
+            const target = page.target?.();
+            if ('function' == typeof target?.createCDPSession) return await target.createCDPSession();
+            throw new Error(`${featureName} requires a browser page with CDP session support.`);
         }
         const page = this.underlyingPage;
         const browserName = page.context().browser()?.browserType().name();
-        if (browserName && 'chromium' !== browserName) throw new Error(`CDP screencast requires Chromium-based browser, but current browser is "${browserName}".`);
+        if (browserName && 'chromium' !== browserName) throw new Error(`${featureName} requires Chromium-based browser, but current browser is "${browserName}".`);
         return await page.context().newCDPSession(page);
     }
     async waitForDomQuiet(opts) {
@@ -307,7 +309,7 @@ class Page {
     async startMjpegStream(options) {
         const { signal, onFrame, onError } = options;
         if ('function' == typeof this.underlyingPage.bringToFront) await this.underlyingPage.bringToFront();
-        const client = await this.createScreencastCdpSession();
+        const client = await this.createPageCdpSession('CDP screencast');
         let stopped = false;
         const streamToken = Symbol('mjpeg-stream');
         const reportStreamError = (error)=>{
@@ -490,6 +492,22 @@ class Page {
             }
         };
     }
+    async selectAllByCdp() {
+        const client = await this.createPageCdpSession('clearInput');
+        try {
+            await client.send('Input.dispatchKeyEvent', {
+                type: 'rawKeyDown',
+                commands: [
+                    'selectAll'
+                ]
+            });
+            await client.send('Input.dispatchKeyEvent', {
+                type: 'keyUp'
+            });
+        } finally{
+            await client.detach().catch(()=>void 0);
+        }
+    }
     async clearInput(element) {
         const backspace = async ()=>{
             await sleep(100);
@@ -499,28 +517,17 @@ class Page {
                 }
             ]);
         };
-        const isMac = 'darwin' === process.platform;
         debugPage('clearInput begin');
-        if (isMac) {
-            if ('puppeteer' === this.interfaceType) {
-                element && await this.mouse.click(element.center[0], element.center[1], {
-                    count: 3
-                });
-                await backspace();
-            }
-            element && await this.mouse.click(element.center[0], element.center[1]);
-            await this.underlyingPage.keyboard.down('Meta');
-            await this.underlyingPage.keyboard.press('a');
-            await this.underlyingPage.keyboard.up('Meta');
-            await backspace();
-        } else {
-            element && await this.mouse.click(element.center[0], element.center[1]);
-            await this.underlyingPage.keyboard.down('Control');
-            await this.underlyingPage.keyboard.press('a');
-            await this.underlyingPage.keyboard.up('Control');
+        element && await this.mouse.click(element.center[0], element.center[1]);
+        try {
+            await this.selectAllByCdp();
             await backspace();
+        } catch (error) {
+            debugPage('clearInput cdp selectAll failed', error);
+            throw error;
+        } finally{
+            debugPage('clearInput end');
         }
-        debugPage('clearInput end');
     }
     async moveToPointBeforeScroll(point) {
         if (point) await this.mouse.move(point.left, point.top);
@@ -598,7 +605,7 @@ class Page {
     async stopLoading() {
         debugPage('stop loading');
         if ('puppeteer' === this.interfaceType) {
-            const client = await this.underlyingPage.target().createCDPSession();
+            const client = await this.createPageCdpSession('stopLoading');
             try {
                 await client.send('Page.stopLoading');
             } finally{
@@ -704,17 +711,7 @@ class Page {
         const delay = duration / steps;
         const halfStart = startDistance / 2;
         const halfEnd = endDistance / 2;
-        let client;
-        if ('puppeteer' === this.interfaceType) {
-            const page = this.underlyingPage;
-            client = await page.target().createCDPSession();
-        } else {
-            if ('playwright' !== this.interfaceType) return;
-            const page = this.underlyingPage;
-            const browserName = page.context().browser()?.browserType().name();
-            if (browserName && 'chromium' !== browserName) throw new Error(`Pinch gesture requires Chromium-based browser, but current browser is "${browserName}". CDP touch events are not supported in Firefox/WebKit.`);
-            client = await page.context().newCDPSession(page);
-        }
+        const client = await this.createPageCdpSession('Pinch gesture');
         try {
             await client.send('Input.dispatchTouchEvent', {
                 type: 'touchStart',
@@ -758,9 +755,9 @@ class Page {
             await client.detach();
         }
     }
-    async ensurePuppeteerFileChooserSession(page) {
+    async ensurePuppeteerFileChooserSession() {
         if (this.puppeteerFileChooserSession) return this.puppeteerFileChooserSession;
-        const session = await page.target().createCDPSession();
+        const session = await this.createPageCdpSession('Puppeteer file chooser');
         await session.send('Page.enable');
         await session.send('DOM.enable');
         await session.send('Page.setInterceptFileChooserDialog', {
@@ -771,8 +768,7 @@ class Page {
     }
     async registerFileChooserListener(handler) {
         if ('puppeteer' !== this.interfaceType) throw new Error('registerFileChooserListener is only supported in Puppeteer');
-        const page = this.underlyingPage;
-        const session = await this.ensurePuppeteerFileChooserSession(page);
+        const session = await this.ensurePuppeteerFileChooserSession();
         if (this.puppeteerFileChooserHandler) session.off('Page.fileChooserOpened', this.puppeteerFileChooserHandler);
         let capturedError;
         this.puppeteerFileChooserHandler = async (event)=>{
@@ -858,7 +854,10 @@ function forceClosePopup(page, debugProfile) {
         }
     });
 }
+const forceSelectRenderingPages = new WeakSet();
 function forceChromeSelectRendering(page) {
+    if (forceSelectRenderingPages.has(page)) return;
+    forceSelectRenderingPages.add(page);
     const styleContent = `
 /* Add by Midscene because of forceChromeSelectRendering is enabled*/
 select {