@midscene/web 1.14.1-beta-20261008033312.0 → 1.15.0

package/dist/es/bridge-mode/io-client.mjs

@@ -23,7 +23,7 @@ class BridgeClient {
                     ]
                 } : {},
                 query: {
-                    version: "1.14.1-beta-20261008033312.0"
+                    version: "1.15.0"
                 }
             });
             const timeout = setTimeout(()=>{

package/dist/es/bridge-mode/io-server.mjs

@@ -101,7 +101,7 @@ class BridgeServer {
                     logMsg('one client connected');
                     this.socket = socket;
                     const clientVersion = socket.handshake.query.version;
-                    logMsg(`Bridge connected, cli-side version v1.14.1-beta-20261008033312.0, browser-side version v${clientVersion}`);
+                    logMsg(`Bridge connected, cli-side version v1.15.0, browser-side version v${clientVersion}`);
                     socket.on(BridgeEvent.CallResponse, (params)=>{
                         const id = params.id;
                         const response = params.response;
@@ -125,7 +125,7 @@ class BridgeServer {
                     setTimeout(()=>{
                         this.onConnect?.();
                         const payload = {
-                            version: "1.14.1-beta-20261008033312.0"
+                            version: "1.15.0"
                         };
                         socket.emit(BridgeEvent.Connected, payload);
                         Promise.resolve().then(()=>{

package/dist/es/bridge-mode/io-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-mode/io-server.mjs","sources":["../../../src/bridge-mode/io-server.ts"],"sourcesContent":["import {\n  type IncomingMessage,\n  type ServerResponse,\n  createServer,\n} from 'node:http';\nimport { sleep } from '@midscene/core/utils';\nimport { getDebug } from '@midscene/shared/logger';\nimport { logMsg } from '@midscene/shared/utils';\nimport { Server, type Socket as ServerSocket } from 'socket.io';\nimport { io as ClientIO } from 'socket.io-client';\n\nimport {\n  type BridgeCall,\n  type BridgeCallResponse,\n  BridgeCallTimeout,\n  type BridgeConnectedEventPayload,\n  BridgeErrorCodeNoClientConnected,\n  BridgeEvent,\n  BridgeSignalKill,\n  DefaultBridgeServerHost,\n  DefaultBridgeServerPort,\n} from './common';\n\nconst debug = getDebug('web:bridge:io-server');\n\ndeclare const __VERSION__: string;\n\n/**\n * Returns true if the given Origin header value is allowed to connect\n * to the bridge server. Trusted origins are:\n * - No Origin header (local Node.js processes like killRunningServer)\n * - chrome-extension:// origins (the Midscene Chrome extension)\n *\n * Browser pages (https://evil.com, etc.) are rejected to prevent\n * Cross-Site WebSocket Hijacking (CSWSH) attacks.\n */\nfunction isTrustedOrigin(origin: string | undefined): boolean {\n  if (!origin) return true;\n  if (origin.startsWith('chrome-extension://')) return true;\n  return false;\n}\n\nexport const killRunningServer = async (\n  port?: number,\n  host = DefaultBridgeServerHost,\n) => {\n  try {\n    const client = ClientIO(`ws://${host}:${port || DefaultBridgeServerPort}`, {\n      query: {\n        [BridgeSignalKill]: 1,\n      },\n    });\n    await sleep(300);\n    await client.close();\n  } catch (e) {\n    debug('failed to kill port: %O', e);\n  }\n};\n\n// ws server, this is where the request is sent\nexport class BridgeServer {\n  private callId = 0;\n  private io: Server | null = null;\n  private socket: ServerSocket | null = null;\n  private listeningTimeoutId: NodeJS.Timeout | null = null;\n  private listeningTimerFlag = false;\n  private connectionTipTimer: NodeJS.Timeout | null = null;\n  public calls: Record<string, BridgeCall> = {};\n\n  private connectionLost = false;\n  private connectionLostReason = '';\n\n  constructor(\n    public host: string,\n    public port: number,\n    public onConnect?: () => void,\n    public onDisconnect?: (reason: string) => void,\n    public closeConflictServer?: boolean,\n  ) {}\n\n  async listen(\n    opts: {\n      timeout?: number | false;\n    } = {},\n  ): Promise<void> {\n    const { timeout = 30000 } = opts;\n\n    if (this.closeConflictServer) {\n      await killRunningServer(this.port, this.host);\n    }\n\n    return new Promise((resolve, reject) => {\n      if (this.listeningTimerFlag) {\n        return reject(new Error('already listening'));\n      }\n      this.listeningTimerFlag = true;\n\n      this.listeningTimeoutId = timeout\n        ? setTimeout(() => {\n            reject(\n              new Error(\n                `no extension connected after ${timeout}ms (${BridgeErrorCodeNoClientConnected})`,\n              ),\n            );\n          }, timeout)\n        : null;\n\n      this.connectionTipTimer =\n        !timeout || timeout > 3000\n          ? setTimeout(() => {\n              logMsg('waiting for bridge to connect...');\n            }, 2000)\n          : null;\n\n      // Create HTTP server — no /bridge-auth endpoint needed since we use\n      // pure Origin checking in the Socket.IO middleware below.\n      const httpServer = createServer(\n        (_req: IncomingMessage, res: ServerResponse) => {\n          res.writeHead(404);\n          res.end();\n        },\n      );\n\n      // Set up HTTP server event listeners FIRST\n      httpServer.once('listening', () => {\n        resolve();\n      });\n\n      httpServer.once('error', (err: Error) => {\n        reject(new Error(`Bridge Listening Error: ${err.message}`));\n      });\n\n      // Always honor the configured interface, including the loopback default.\n      httpServer.listen(this.port, this.host);\n\n      // Now create Socket.IO Server attached to the already-listening HTTP server\n      this.io = new Server(httpServer, {\n        maxHttpBufferSize: 100 * 1024 * 1024, // 100MB\n        // Increase pingTimeout to tolerate Chrome MV3 Service Worker suspension.\n        // The SW keepalive alarm fires every ~24s; default pingTimeout (20s) may\n        // be too short if the SW is suspended between alarm pings.\n        pingTimeout: 60000,\n      });\n\n      this.io.use((socket, next) => {\n        // Reject connections from untrusted browser origins to prevent\n        // Cross-Site WebSocket Hijacking (CSWSH) and unauthorized kill signals.\n        // The browser automatically sets the Origin header on WebSocket\n        // handshakes, and JavaScript cannot override it.\n        const origin = socket.handshake.headers.origin;\n        if (!isTrustedOrigin(origin)) {\n          debug('connection rejected: untrusted origin=%s', origin);\n          return next(new Error('origin not allowed'));\n        }\n\n        // Allow new connections to replace old ones (reconnection after\n        // extension Stop→Start). If the old socket is already disconnected\n        // or unresponsive, accept the new connection immediately.\n        if (\n          socket.handshake.url.includes(BridgeSignalKill) === false &&\n          this.socket?.connected\n        ) {\n          return next(new Error('server already connected by another client'));\n        }\n        next();\n      });\n\n      this.io.on('connection', (socket) => {\n        // check the connection url\n        const url = socket.handshake.url;\n        if (url.includes(BridgeSignalKill)) {\n          console.warn('kill signal received, closing bridge server');\n          return this.close();\n        }\n\n        this.connectionLost = false;\n        this.connectionLostReason = '';\n        this.listeningTimeoutId && clearTimeout(this.listeningTimeoutId);\n        this.listeningTimeoutId = null;\n        this.connectionTipTimer && clearTimeout(this.connectionTipTimer);\n        this.connectionTipTimer = null;\n        if (this.socket?.connected) {\n          socket.emit(BridgeEvent.Refused);\n          socket.disconnect();\n          logMsg(\n            'refused new connection: server already connected by another client',\n          );\n          return;\n        }\n\n        // Clean up stale old socket if it exists but is no longer connected\n        if (this.socket) {\n          try {\n            this.socket.disconnect();\n          } catch (e) {\n            logMsg(`failed to disconnect stale socket: ${e}`);\n          }\n          this.socket = null;\n        }\n\n        try {\n          logMsg('one client connected');\n          this.socket = socket;\n\n          const clientVersion = socket.handshake.query.version;\n          logMsg(\n            `Bridge connected, cli-side version v${__VERSION__}, browser-side version v${clientVersion}`,\n          );\n\n          socket.on(BridgeEvent.CallResponse, (params: BridgeCallResponse) => {\n            const id = params.id;\n            const response = params.response;\n            const error = params.error;\n\n            this.triggerCallResponseCallback(id, error, response);\n          });\n\n          socket.on('disconnect', (reason: string) => {\n            this.connectionLost = true;\n            this.connectionLostReason = reason;\n            this.socket = null;\n\n            // flush all pending calls as error and clean up completed calls\n            for (const id in this.calls) {\n              const call = this.calls[id];\n\n              if (!call.responseTime) {\n                const errorMessage = this.connectionLostErrorMsg();\n                this.triggerCallResponseCallback(\n                  id,\n                  new Error(errorMessage),\n                  null,\n                );\n              }\n            }\n\n            // Clean up completed calls to prevent memory leaks in long-running sessions\n            for (const id in this.calls) {\n              if (this.calls[id].responseTime) {\n                delete this.calls[id];\n              }\n            }\n\n            this.onDisconnect?.(reason);\n          });\n\n          setTimeout(() => {\n            this.onConnect?.();\n\n            const payload = {\n              version: __VERSION__,\n            } as BridgeConnectedEventPayload;\n            socket.emit(BridgeEvent.Connected, payload);\n            Promise.resolve().then(() => {\n              for (const id in this.calls) {\n                if (this.calls[id].callTime === 0) {\n                  this.emitCall(id);\n                }\n              }\n            });\n          }, 0);\n        } catch (e) {\n          logMsg(`failed to handle connection event: ${e}`);\n        }\n      });\n\n      this.io.on('close', () => {\n        this.close();\n      });\n    });\n  }\n\n  private connectionLostErrorMsg = () => {\n    return `Connection lost, reason: ${this.connectionLostReason}`;\n  };\n\n  private async triggerCallResponseCallback(\n    id: string | number,\n    error: Error | string | null,\n    response: any,\n  ) {\n    const call = this.calls[id];\n    if (!call) {\n      throw new Error(`call ${id} not found`);\n    }\n    // Ensure error is always an Error object (bridge client may send strings)\n    if (error) {\n      call.error =\n        error instanceof Error\n          ? error\n          : new Error(typeof error === 'string' ? error : String(error));\n    } else {\n      call.error = undefined;\n    }\n    call.response = response;\n    call.responseTime = Date.now();\n\n    call.callback(call.error, response);\n  }\n\n  private async emitCall(id: string) {\n    const call = this.calls[id];\n    if (!call) {\n      throw new Error(`call ${id} not found`);\n    }\n\n    if (this.connectionLost) {\n      const message = `Connection lost, reason: ${this.connectionLostReason}`;\n      call.callback(new Error(message), null);\n      return;\n    }\n\n    if (this.socket) {\n      this.socket.emit(BridgeEvent.Call, {\n        id,\n        method: call.method,\n        args: call.args,\n      });\n      call.callTime = Date.now();\n    }\n  }\n\n  async call<T = any>(\n    method: string,\n    args: any[],\n    timeout = BridgeCallTimeout,\n  ): Promise<T> {\n    const id = `${this.callId++}`;\n\n    return new Promise((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        logMsg(`bridge call timeout, id=${id}, method=${method}, args=`, args);\n        this.calls[id].error = new Error(\n          `Bridge call timeout after ${timeout}ms: ${method}`,\n        );\n        reject(this.calls[id].error);\n      }, timeout);\n\n      this.calls[id] = {\n        method,\n        args,\n        response: null,\n        callTime: 0,\n        responseTime: 0,\n        callback: (error: Error | undefined, response: any) => {\n          clearTimeout(timeoutId);\n          if (error) {\n            reject(error);\n          } else {\n            resolve(response);\n          }\n        },\n      };\n\n      this.emitCall(id);\n    });\n  }\n\n  // do NOT restart after close\n  async close() {\n    this.listeningTimeoutId && clearTimeout(this.listeningTimeoutId);\n    this.connectionTipTimer && clearTimeout(this.connectionTipTimer);\n    const closeProcess = this.io?.close();\n    this.io = null;\n\n    return closeProcess;\n  }\n}\n"],"names":["debug","getDebug","isTrustedOrigin","origin","killRunningServer","port","host","DefaultBridgeServerHost","client","ClientIO","DefaultBridgeServerPort","BridgeSignalKill","sleep","e","BridgeServer","opts","timeout","Promise","resolve","reject","Error","setTimeout","BridgeErrorCodeNoClientConnected","logMsg","httpServer","createServer","_req","res","err","Server","socket","next","url","console","clearTimeout","BridgeEvent","clientVersion","params","id","response","error","reason","call","errorMessage","payload","__VERSION__","String","undefined","Date","message","method","args","BridgeCallTimeout","timeoutId","closeProcess","onConnect","onDisconnect","closeConflictServer"],"mappings":"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"}
+{"version":3,"file":"bridge-mode/io-server.mjs","sources":["../../../src/bridge-mode/io-server.ts"],"sourcesContent":["import {\n  type IncomingMessage,\n  type ServerResponse,\n  createServer,\n} from 'node:http';\nimport { sleep } from '@midscene/core/utils';\nimport { getDebug } from '@midscene/shared/logger';\nimport { logMsg } from '@midscene/shared/utils';\nimport { Server, type Socket as ServerSocket } from 'socket.io';\nimport { io as ClientIO } from 'socket.io-client';\n\nimport {\n  type BridgeCall,\n  type BridgeCallResponse,\n  BridgeCallTimeout,\n  type BridgeConnectedEventPayload,\n  BridgeErrorCodeNoClientConnected,\n  BridgeEvent,\n  BridgeSignalKill,\n  DefaultBridgeServerHost,\n  DefaultBridgeServerPort,\n} from './common';\n\nconst debug = getDebug('web:bridge:io-server');\n\ndeclare const __VERSION__: string;\n\n/**\n * Returns true if the given Origin header value is allowed to connect\n * to the bridge server. Trusted origins are:\n * - No Origin header (local Node.js processes like killRunningServer)\n * - chrome-extension:// origins (the Midscene Chrome extension)\n *\n * Browser pages (https://evil.com, etc.) are rejected to prevent\n * Cross-Site WebSocket Hijacking (CSWSH) attacks.\n */\nfunction isTrustedOrigin(origin: string | undefined): boolean {\n  if (!origin) return true;\n  if (origin.startsWith('chrome-extension://')) return true;\n  return false;\n}\n\nexport const killRunningServer = async (\n  port?: number,\n  host = DefaultBridgeServerHost,\n) => {\n  try {\n    const client = ClientIO(`ws://${host}:${port || DefaultBridgeServerPort}`, {\n      query: {\n        [BridgeSignalKill]: 1,\n      },\n    });\n    await sleep(300);\n    await client.close();\n  } catch (e) {\n    debug('failed to kill port: %O', e);\n  }\n};\n\n// ws server, this is where the request is sent\nexport class BridgeServer {\n  private callId = 0;\n  private io: Server | null = null;\n  private socket: ServerSocket | null = null;\n  private listeningTimeoutId: NodeJS.Timeout | null = null;\n  private listeningTimerFlag = false;\n  private connectionTipTimer: NodeJS.Timeout | null = null;\n  public calls: Record<string, BridgeCall> = {};\n\n  private connectionLost = false;\n  private connectionLostReason = '';\n\n  constructor(\n    public host: string,\n    public port: number,\n    public onConnect?: () => void,\n    public onDisconnect?: (reason: string) => void,\n    public closeConflictServer?: boolean,\n  ) {}\n\n  async listen(\n    opts: {\n      timeout?: number | false;\n    } = {},\n  ): Promise<void> {\n    const { timeout = 30000 } = opts;\n\n    if (this.closeConflictServer) {\n      await killRunningServer(this.port, this.host);\n    }\n\n    return new Promise((resolve, reject) => {\n      if (this.listeningTimerFlag) {\n        return reject(new Error('already listening'));\n      }\n      this.listeningTimerFlag = true;\n\n      this.listeningTimeoutId = timeout\n        ? setTimeout(() => {\n            reject(\n              new Error(\n                `no extension connected after ${timeout}ms (${BridgeErrorCodeNoClientConnected})`,\n              ),\n            );\n          }, timeout)\n        : null;\n\n      this.connectionTipTimer =\n        !timeout || timeout > 3000\n          ? setTimeout(() => {\n              logMsg('waiting for bridge to connect...');\n            }, 2000)\n          : null;\n\n      // Create HTTP server — no /bridge-auth endpoint needed since we use\n      // pure Origin checking in the Socket.IO middleware below.\n      const httpServer = createServer(\n        (_req: IncomingMessage, res: ServerResponse) => {\n          res.writeHead(404);\n          res.end();\n        },\n      );\n\n      // Set up HTTP server event listeners FIRST\n      httpServer.once('listening', () => {\n        resolve();\n      });\n\n      httpServer.once('error', (err: Error) => {\n        reject(new Error(`Bridge Listening Error: ${err.message}`));\n      });\n\n      // Always honor the configured interface, including the loopback default.\n      httpServer.listen(this.port, this.host);\n\n      // Now create Socket.IO Server attached to the already-listening HTTP server\n      this.io = new Server(httpServer, {\n        maxHttpBufferSize: 100 * 1024 * 1024, // 100MB\n        // Increase pingTimeout to tolerate Chrome MV3 Service Worker suspension.\n        // The SW keepalive alarm fires every ~24s; default pingTimeout (20s) may\n        // be too short if the SW is suspended between alarm pings.\n        pingTimeout: 60000,\n      });\n\n      this.io.use((socket, next) => {\n        // Reject connections from untrusted browser origins to prevent\n        // Cross-Site WebSocket Hijacking (CSWSH) and unauthorized kill signals.\n        // The browser automatically sets the Origin header on WebSocket\n        // handshakes, and JavaScript cannot override it.\n        const origin = socket.handshake.headers.origin;\n        if (!isTrustedOrigin(origin)) {\n          debug('connection rejected: untrusted origin=%s', origin);\n          return next(new Error('origin not allowed'));\n        }\n\n        // Allow new connections to replace old ones (reconnection after\n        // extension Stop→Start). If the old socket is already disconnected\n        // or unresponsive, accept the new connection immediately.\n        if (\n          socket.handshake.url.includes(BridgeSignalKill) === false &&\n          this.socket?.connected\n        ) {\n          return next(new Error('server already connected by another client'));\n        }\n        next();\n      });\n\n      this.io.on('connection', (socket) => {\n        // check the connection url\n        const url = socket.handshake.url;\n        if (url.includes(BridgeSignalKill)) {\n          console.warn('kill signal received, closing bridge server');\n          return this.close();\n        }\n\n        this.connectionLost = false;\n        this.connectionLostReason = '';\n        this.listeningTimeoutId && clearTimeout(this.listeningTimeoutId);\n        this.listeningTimeoutId = null;\n        this.connectionTipTimer && clearTimeout(this.connectionTipTimer);\n        this.connectionTipTimer = null;\n        if (this.socket?.connected) {\n          socket.emit(BridgeEvent.Refused);\n          socket.disconnect();\n          logMsg(\n            'refused new connection: server already connected by another client',\n          );\n          return;\n        }\n\n        // Clean up stale old socket if it exists but is no longer connected\n        if (this.socket) {\n          try {\n            this.socket.disconnect();\n          } catch (e) {\n            logMsg(`failed to disconnect stale socket: ${e}`);\n          }\n          this.socket = null;\n        }\n\n        try {\n          logMsg('one client connected');\n          this.socket = socket;\n\n          const clientVersion = socket.handshake.query.version;\n          logMsg(\n            `Bridge connected, cli-side version v${__VERSION__}, browser-side version v${clientVersion}`,\n          );\n\n          socket.on(BridgeEvent.CallResponse, (params: BridgeCallResponse) => {\n            const id = params.id;\n            const response = params.response;\n            const error = params.error;\n\n            this.triggerCallResponseCallback(id, error, response);\n          });\n\n          socket.on('disconnect', (reason: string) => {\n            this.connectionLost = true;\n            this.connectionLostReason = reason;\n            this.socket = null;\n\n            // flush all pending calls as error and clean up completed calls\n            for (const id in this.calls) {\n              const call = this.calls[id];\n\n              if (!call.responseTime) {\n                const errorMessage = this.connectionLostErrorMsg();\n                this.triggerCallResponseCallback(\n                  id,\n                  new Error(errorMessage),\n                  null,\n                );\n              }\n            }\n\n            // Clean up completed calls to prevent memory leaks in long-running sessions\n            for (const id in this.calls) {\n              if (this.calls[id].responseTime) {\n                delete this.calls[id];\n              }\n            }\n\n            this.onDisconnect?.(reason);\n          });\n\n          setTimeout(() => {\n            this.onConnect?.();\n\n            const payload = {\n              version: __VERSION__,\n            } as BridgeConnectedEventPayload;\n            socket.emit(BridgeEvent.Connected, payload);\n            Promise.resolve().then(() => {\n              for (const id in this.calls) {\n                if (this.calls[id].callTime === 0) {\n                  this.emitCall(id);\n                }\n              }\n            });\n          }, 0);\n        } catch (e) {\n          logMsg(`failed to handle connection event: ${e}`);\n        }\n      });\n\n      this.io.on('close', () => {\n        this.close();\n      });\n    });\n  }\n\n  private connectionLostErrorMsg = () => {\n    return `Connection lost, reason: ${this.connectionLostReason}`;\n  };\n\n  private async triggerCallResponseCallback(\n    id: string | number,\n    error: Error | string | null,\n    response: any,\n  ) {\n    const call = this.calls[id];\n    if (!call) {\n      throw new Error(`call ${id} not found`);\n    }\n    // Ensure error is always an Error object (bridge client may send strings)\n    if (error) {\n      call.error =\n        error instanceof Error\n          ? error\n          : new Error(typeof error === 'string' ? error : String(error));\n    } else {\n      call.error = undefined;\n    }\n    call.response = response;\n    call.responseTime = Date.now();\n\n    call.callback(call.error, response);\n  }\n\n  private async emitCall(id: string) {\n    const call = this.calls[id];\n    if (!call) {\n      throw new Error(`call ${id} not found`);\n    }\n\n    if (this.connectionLost) {\n      const message = `Connection lost, reason: ${this.connectionLostReason}`;\n      call.callback(new Error(message), null);\n      return;\n    }\n\n    if (this.socket) {\n      this.socket.emit(BridgeEvent.Call, {\n        id,\n        method: call.method,\n        args: call.args,\n      });\n      call.callTime = Date.now();\n    }\n  }\n\n  async call<T = any>(\n    method: string,\n    args: any[],\n    timeout = BridgeCallTimeout,\n  ): Promise<T> {\n    const id = `${this.callId++}`;\n\n    return new Promise((resolve, reject) => {\n      const timeoutId = setTimeout(() => {\n        logMsg(`bridge call timeout, id=${id}, method=${method}, args=`, args);\n        this.calls[id].error = new Error(\n          `Bridge call timeout after ${timeout}ms: ${method}`,\n        );\n        reject(this.calls[id].error);\n      }, timeout);\n\n      this.calls[id] = {\n        method,\n        args,\n        response: null,\n        callTime: 0,\n        responseTime: 0,\n        callback: (error: Error | undefined, response: any) => {\n          clearTimeout(timeoutId);\n          if (error) {\n            reject(error);\n          } else {\n            resolve(response);\n          }\n        },\n      };\n\n      this.emitCall(id);\n    });\n  }\n\n  // do NOT restart after close\n  async close() {\n    this.listeningTimeoutId && clearTimeout(this.listeningTimeoutId);\n    this.connectionTipTimer && clearTimeout(this.connectionTipTimer);\n    const closeProcess = this.io?.close();\n    this.io = null;\n\n    return closeProcess;\n  }\n}\n"],"names":["debug","getDebug","isTrustedOrigin","origin","killRunningServer","port","host","DefaultBridgeServerHost","client","ClientIO","DefaultBridgeServerPort","BridgeSignalKill","sleep","e","BridgeServer","opts","timeout","Promise","resolve","reject","Error","setTimeout","BridgeErrorCodeNoClientConnected","logMsg","httpServer","createServer","_req","res","err","Server","socket","next","url","console","clearTimeout","BridgeEvent","clientVersion","params","id","response","error","reason","call","errorMessage","payload","__VERSION__","String","undefined","Date","message","method","args","BridgeCallTimeout","timeoutId","closeProcess","onConnect","onDisconnect","closeConflictServer"],"mappings":"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"}

package/dist/es/bridge-mode/page-browser-side.mjs

@@ -100,7 +100,7 @@ class ExtensionBridgePageBrowserSide extends page {
                 throw new Error('Connection denied by user');
             }
         }
-        this.onLogMessage(`Bridge connected, cli-side version v${this.bridgeClient.serverVersion}, browser-side version v1.14.1-beta-20261008033312.0`, 'log');
+        this.onLogMessage(`Bridge connected, cli-side version v${this.bridgeClient.serverVersion}, browser-side version v1.15.0`, 'log');
     }
     async connect() {
         return await this.setupBridgeClient();

package/dist/es/bridge-mode/page-browser-side.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-mode/page-browser-side.mjs","sources":["../../../src/bridge-mode/page-browser-side.ts"],"sourcesContent":["import { assert } from '@midscene/shared/utils';\nimport ChromeExtensionProxyPage from '../chrome-extension/page';\nimport type {\n  ChromePageDestroyOptions,\n  KeyboardAction,\n  MouseAction,\n} from '../web-page';\nimport {\n  type BridgeConnectTabOptions,\n  BridgeEvent,\n  DefaultBridgeServerHost,\n  DefaultBridgeServerPort,\n  KeyboardEvent,\n  MouseEvent,\n} from './common';\nimport { BridgeClient } from './io-client';\n\ndeclare const __VERSION__: string;\n\nconst NEW_TAB_LOAD_TIMEOUT_MS = 30_000;\n\nfunction isBlankUrl(url: string | undefined): boolean {\n  if (!url) return true;\n  return url === 'about:blank' || url.startsWith('chrome://newtab');\n}\n\n// Wait until the freshly created tab has navigated away from about:blank\n// and reached `status === 'complete'`. Resolves on timeout instead of\n// throwing so callers degrade to the existing lazy-attach behavior.\nfunction waitForTabNavigationComplete(\n  tabId: number,\n  targetUrl: string,\n  timeoutMs = NEW_TAB_LOAD_TIMEOUT_MS,\n): Promise<void> {\n  return new Promise((resolve) => {\n    let settled = false;\n    const finish = () => {\n      if (settled) return;\n      settled = true;\n      try {\n        chrome.tabs.onUpdated.removeListener(onUpdated);\n      } catch {}\n      clearTimeout(timer);\n      resolve();\n    };\n\n    const isReady = (tab: chrome.tabs.Tab | undefined): boolean => {\n      if (!tab) return false;\n      if (tab.status !== 'complete') return false;\n      const currentUrl = tab.url || tab.pendingUrl || '';\n      // Skip the initial about:blank \"complete\" that fires before\n      // the target URL navigation kicks in.\n      if (isBlankUrl(currentUrl) && !isBlankUrl(targetUrl)) return false;\n      return true;\n    };\n\n    const onUpdated = (\n      id: number,\n      _info: chrome.tabs.TabChangeInfo,\n      tab: chrome.tabs.Tab,\n    ) => {\n      if (id !== tabId) return;\n      if (isReady(tab)) finish();\n    };\n\n    chrome.tabs.onUpdated.addListener(onUpdated);\n    const timer = setTimeout(finish, timeoutMs);\n\n    // Handle the race where the tab already finished loading before\n    // we registered the listener.\n    chrome.tabs\n      .get(tabId)\n      .then((tab) => {\n        if (isReady(tab)) finish();\n      })\n      .catch(() => {});\n  });\n}\n\nexport class ExtensionBridgePageBrowserSide extends ChromeExtensionProxyPage {\n  public bridgeClient: BridgeClient | null = null;\n\n  private destroyOptions?: ChromePageDestroyOptions;\n\n  private newlyCreatedTabIds: number[] = [];\n\n  // Connection confirmation state\n  private confirmationPromise: Promise<boolean> | null = null;\n\n  constructor(\n    public serverEndpoint?: string,\n    public onDisconnect: () => void = () => {},\n    public onLogMessage: (\n      message: string,\n      type: 'log' | 'status',\n    ) => void = () => {},\n    forceSameTabNavigation = true,\n    public onConnectionRequest?: () => Promise<boolean>,\n  ) {\n    super(forceSameTabNavigation);\n  }\n\n  private async setupBridgeClient() {\n    const endpoint =\n      this.serverEndpoint ||\n      `ws://${DefaultBridgeServerHost}:${DefaultBridgeServerPort}`;\n\n    // Create confirmation gate BEFORE establishing connection,\n    // so that any calls received immediately after connection are blocked\n    // until user confirms. This prevents a race condition where server-side\n    // queued calls bypass the confirmation dialog.\n    let resolveConfirmationGate: (allowed: boolean) => void = () => {};\n    if (this.onConnectionRequest) {\n      this.confirmationPromise = new Promise<boolean>((resolve) => {\n        resolveConfirmationGate = resolve;\n      });\n    }\n\n    this.bridgeClient = new BridgeClient(\n      endpoint,\n      async (method, args: any[]) => {\n        // Wait for user confirmation before processing any commands\n        if (this.confirmationPromise) {\n          const allowed = await this.confirmationPromise;\n          if (!allowed) {\n            throw new Error('Connection denied by user');\n          }\n        }\n\n        this.onLogMessage(`bridge call from cli side: ${method}`, 'log');\n        if (method === BridgeEvent.ConnectNewTabWithUrl) {\n          return this.connectNewTabWithUrl.apply(\n            this,\n            args as unknown as [string],\n          );\n        }\n\n        if (method === BridgeEvent.GetBrowserTabList) {\n          return this.getBrowserTabList.apply(this, args as any);\n        }\n\n        if (method === BridgeEvent.SetActiveTabId) {\n          return this.setActiveTabId.apply(this, args as any);\n        }\n\n        if (method === BridgeEvent.ConnectCurrentTab) {\n          return this.connectCurrentTab.apply(this, args as any);\n        }\n\n        if (method === BridgeEvent.UpdateAgentStatus) {\n          return this.onLogMessage(args[0] as string, 'status');\n        }\n\n        const tabId = await this.getActiveTabId();\n        if (!tabId || tabId === 0) {\n          throw new Error('no tab is connected');\n        }\n\n        // this.onLogMessage(`calling method: ${method}`);\n\n        if (method.startsWith(MouseEvent.PREFIX)) {\n          const actionName = method.split('.')[1] as keyof MouseAction;\n          if (actionName === 'drag') {\n            return this.mouse[actionName].apply(this.mouse, args as any);\n          }\n          return this.mouse[actionName].apply(this.mouse, args as any);\n        }\n\n        if (method.startsWith(KeyboardEvent.PREFIX)) {\n          const actionName = method.split('.')[1] as keyof KeyboardAction;\n          if (actionName === 'press') {\n            return this.keyboard[actionName].apply(this.keyboard, args as any);\n          }\n          return this.keyboard[actionName].apply(this.keyboard, args as any);\n        }\n\n        // Generic method lookup. Methods like `setWaterFlowAnimationEnabled`\n        // and `getWaterFlowAnimationEnabled` are inherited from\n        // ChromeExtensionProxyPage and found via `this[method]`.\n        if (!this[method as keyof ChromeExtensionProxyPage]) {\n          this.onLogMessage(`method not found: ${method}`, 'log');\n          return undefined;\n        }\n\n        try {\n          // @ts-expect-error\n          const result = await this[method as keyof ChromeExtensionProxyPage](\n            ...args,\n          );\n          return result;\n        } catch (e) {\n          const errorMessage = e instanceof Error ? e.message : 'Unknown error';\n          this.onLogMessage(\n            `Error calling method: ${method}, ${errorMessage}`,\n            'log',\n          );\n          throw new Error(errorMessage, { cause: e });\n        }\n      },\n      // on disconnect\n      () => {\n        return this.destroy();\n      },\n    );\n    await this.bridgeClient.connect();\n\n    // Show confirmation dialog after connection is established\n    if (this.onConnectionRequest) {\n      this.onLogMessage('Waiting for user confirmation...', 'log');\n      const allowed = await this.onConnectionRequest();\n      resolveConfirmationGate(allowed);\n      this.confirmationPromise = null;\n\n      if (!allowed) {\n        this.onLogMessage('Connection denied by user', 'log');\n        this.bridgeClient.disconnect();\n        this.bridgeClient = null;\n        throw new Error('Connection denied by user');\n      }\n    }\n\n    this.onLogMessage(\n      `Bridge connected, cli-side version v${this.bridgeClient.serverVersion}, browser-side version v${__VERSION__}`,\n      'log',\n    );\n  }\n\n  public async connect() {\n    return await this.setupBridgeClient();\n  }\n\n  public async connectNewTabWithUrl(\n    url: string,\n    options: BridgeConnectTabOptions = {\n      forceSameTabNavigation: true,\n    },\n  ) {\n    // Set the water-flow animation flag BEFORE any debugger commands are\n    // sent (which trigger enableWaterFlowAnimation via sendCommandToDebugger).\n    // Otherwise the animation gets injected during the connection flow\n    // before the CLI side's setWaterFlowAnimationEnabled(false) arrives.\n    if (options.enableWaterFlowAnimation !== undefined) {\n      this.waterFlowAnimationEnabled = options.enableWaterFlowAnimation;\n    }\n\n    // Preserve the historical default: activate the new tab unless the caller opts into background mode.\n    const activate = options.activateTab ?? true;\n    const tab = await chrome.tabs.create({ url, active: activate });\n    const tabId = tab.id;\n    assert(tabId, 'failed to get tabId after creating a new tab');\n\n    // new tab\n    this.onLogMessage(`Creating new tab: ${url}`, 'log');\n    this.newlyCreatedTabIds.push(tabId);\n\n    if (options?.forceSameTabNavigation) {\n      this.forceSameTabNavigation = true;\n    }\n\n    // chrome.tabs.create returns immediately with an about:blank target,\n    // then navigates to `url`. If we attach the debugger during that\n    // cross-origin transition Site Isolation will detach it again, leaving\n    // the first CDP command to fail with \"Debugger is not attached to the\n    // tab\". Wait for navigation to settle so the lazy attach lands on a\n    // stable target.\n    await waitForTabNavigationComplete(tabId, url);\n\n    await this.setActiveTabId(tabId, { activate });\n  }\n\n  public async connectCurrentTab(\n    options: BridgeConnectTabOptions = {\n      forceSameTabNavigation: true,\n    },\n  ) {\n    // Set the water-flow animation flag BEFORE any debugger commands are\n    // sent (which trigger enableWaterFlowAnimation via sendCommandToDebugger).\n    if (options.enableWaterFlowAnimation !== undefined) {\n      this.waterFlowAnimationEnabled = options.enableWaterFlowAnimation;\n    }\n\n    const tabs = await chrome.tabs.query({ active: true, currentWindow: true });\n    const tabId = tabs[0]?.id;\n    assert(tabId, 'failed to get tabId');\n\n    this.onLogMessage(`Connected to current tab: ${tabs[0]?.url}`, 'log');\n\n    if (options?.forceSameTabNavigation) {\n      this.forceSameTabNavigation = true;\n    }\n\n    await this.setActiveTabId(tabId);\n  }\n\n  public async setDestroyOptions(options: ChromePageDestroyOptions) {\n    this.destroyOptions = options;\n  }\n\n  async destroy() {\n    if (this.destroyOptions?.closeTab && this.newlyCreatedTabIds.length > 0) {\n      this.onLogMessage('Closing all newly created tabs by bridge...', 'log');\n      for (const tabId of this.newlyCreatedTabIds) {\n        await chrome.tabs.remove(tabId);\n      }\n      this.newlyCreatedTabIds = [];\n    }\n\n    await super.destroy();\n\n    if (this.bridgeClient) {\n      this.bridgeClient.disconnect();\n      this.bridgeClient = null;\n      this.onDisconnect();\n    }\n  }\n}\n"],"names":["NEW_TAB_LOAD_TIMEOUT_MS","isBlankUrl","url","waitForTabNavigationComplete","tabId","targetUrl","timeoutMs","Promise","resolve","settled","finish","chrome","onUpdated","clearTimeout","timer","isReady","tab","currentUrl","id","_info","setTimeout","ExtensionBridgePageBrowserSide","ChromeExtensionProxyPage","endpoint","DefaultBridgeServerHost","DefaultBridgeServerPort","resolveConfirmationGate","BridgeClient","method","args","allowed","Error","BridgeEvent","MouseEvent","actionName","KeyboardEvent","result","e","errorMessage","options","undefined","activate","assert","tabs","serverEndpoint","onDisconnect","onLogMessage","forceSameTabNavigation","onConnectionRequest"],"mappings":"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"}
+{"version":3,"file":"bridge-mode/page-browser-side.mjs","sources":["../../../src/bridge-mode/page-browser-side.ts"],"sourcesContent":["import { assert } from '@midscene/shared/utils';\nimport ChromeExtensionProxyPage from '../chrome-extension/page';\nimport type {\n  ChromePageDestroyOptions,\n  KeyboardAction,\n  MouseAction,\n} from '../web-page';\nimport {\n  type BridgeConnectTabOptions,\n  BridgeEvent,\n  DefaultBridgeServerHost,\n  DefaultBridgeServerPort,\n  KeyboardEvent,\n  MouseEvent,\n} from './common';\nimport { BridgeClient } from './io-client';\n\ndeclare const __VERSION__: string;\n\nconst NEW_TAB_LOAD_TIMEOUT_MS = 30_000;\n\nfunction isBlankUrl(url: string | undefined): boolean {\n  if (!url) return true;\n  return url === 'about:blank' || url.startsWith('chrome://newtab');\n}\n\n// Wait until the freshly created tab has navigated away from about:blank\n// and reached `status === 'complete'`. Resolves on timeout instead of\n// throwing so callers degrade to the existing lazy-attach behavior.\nfunction waitForTabNavigationComplete(\n  tabId: number,\n  targetUrl: string,\n  timeoutMs = NEW_TAB_LOAD_TIMEOUT_MS,\n): Promise<void> {\n  return new Promise((resolve) => {\n    let settled = false;\n    const finish = () => {\n      if (settled) return;\n      settled = true;\n      try {\n        chrome.tabs.onUpdated.removeListener(onUpdated);\n      } catch {}\n      clearTimeout(timer);\n      resolve();\n    };\n\n    const isReady = (tab: chrome.tabs.Tab | undefined): boolean => {\n      if (!tab) return false;\n      if (tab.status !== 'complete') return false;\n      const currentUrl = tab.url || tab.pendingUrl || '';\n      // Skip the initial about:blank \"complete\" that fires before\n      // the target URL navigation kicks in.\n      if (isBlankUrl(currentUrl) && !isBlankUrl(targetUrl)) return false;\n      return true;\n    };\n\n    const onUpdated = (\n      id: number,\n      _info: chrome.tabs.TabChangeInfo,\n      tab: chrome.tabs.Tab,\n    ) => {\n      if (id !== tabId) return;\n      if (isReady(tab)) finish();\n    };\n\n    chrome.tabs.onUpdated.addListener(onUpdated);\n    const timer = setTimeout(finish, timeoutMs);\n\n    // Handle the race where the tab already finished loading before\n    // we registered the listener.\n    chrome.tabs\n      .get(tabId)\n      .then((tab) => {\n        if (isReady(tab)) finish();\n      })\n      .catch(() => {});\n  });\n}\n\nexport class ExtensionBridgePageBrowserSide extends ChromeExtensionProxyPage {\n  public bridgeClient: BridgeClient | null = null;\n\n  private destroyOptions?: ChromePageDestroyOptions;\n\n  private newlyCreatedTabIds: number[] = [];\n\n  // Connection confirmation state\n  private confirmationPromise: Promise<boolean> | null = null;\n\n  constructor(\n    public serverEndpoint?: string,\n    public onDisconnect: () => void = () => {},\n    public onLogMessage: (\n      message: string,\n      type: 'log' | 'status',\n    ) => void = () => {},\n    forceSameTabNavigation = true,\n    public onConnectionRequest?: () => Promise<boolean>,\n  ) {\n    super(forceSameTabNavigation);\n  }\n\n  private async setupBridgeClient() {\n    const endpoint =\n      this.serverEndpoint ||\n      `ws://${DefaultBridgeServerHost}:${DefaultBridgeServerPort}`;\n\n    // Create confirmation gate BEFORE establishing connection,\n    // so that any calls received immediately after connection are blocked\n    // until user confirms. This prevents a race condition where server-side\n    // queued calls bypass the confirmation dialog.\n    let resolveConfirmationGate: (allowed: boolean) => void = () => {};\n    if (this.onConnectionRequest) {\n      this.confirmationPromise = new Promise<boolean>((resolve) => {\n        resolveConfirmationGate = resolve;\n      });\n    }\n\n    this.bridgeClient = new BridgeClient(\n      endpoint,\n      async (method, args: any[]) => {\n        // Wait for user confirmation before processing any commands\n        if (this.confirmationPromise) {\n          const allowed = await this.confirmationPromise;\n          if (!allowed) {\n            throw new Error('Connection denied by user');\n          }\n        }\n\n        this.onLogMessage(`bridge call from cli side: ${method}`, 'log');\n        if (method === BridgeEvent.ConnectNewTabWithUrl) {\n          return this.connectNewTabWithUrl.apply(\n            this,\n            args as unknown as [string],\n          );\n        }\n\n        if (method === BridgeEvent.GetBrowserTabList) {\n          return this.getBrowserTabList.apply(this, args as any);\n        }\n\n        if (method === BridgeEvent.SetActiveTabId) {\n          return this.setActiveTabId.apply(this, args as any);\n        }\n\n        if (method === BridgeEvent.ConnectCurrentTab) {\n          return this.connectCurrentTab.apply(this, args as any);\n        }\n\n        if (method === BridgeEvent.UpdateAgentStatus) {\n          return this.onLogMessage(args[0] as string, 'status');\n        }\n\n        const tabId = await this.getActiveTabId();\n        if (!tabId || tabId === 0) {\n          throw new Error('no tab is connected');\n        }\n\n        // this.onLogMessage(`calling method: ${method}`);\n\n        if (method.startsWith(MouseEvent.PREFIX)) {\n          const actionName = method.split('.')[1] as keyof MouseAction;\n          if (actionName === 'drag') {\n            return this.mouse[actionName].apply(this.mouse, args as any);\n          }\n          return this.mouse[actionName].apply(this.mouse, args as any);\n        }\n\n        if (method.startsWith(KeyboardEvent.PREFIX)) {\n          const actionName = method.split('.')[1] as keyof KeyboardAction;\n          if (actionName === 'press') {\n            return this.keyboard[actionName].apply(this.keyboard, args as any);\n          }\n          return this.keyboard[actionName].apply(this.keyboard, args as any);\n        }\n\n        // Generic method lookup. Methods like `setWaterFlowAnimationEnabled`\n        // and `getWaterFlowAnimationEnabled` are inherited from\n        // ChromeExtensionProxyPage and found via `this[method]`.\n        if (!this[method as keyof ChromeExtensionProxyPage]) {\n          this.onLogMessage(`method not found: ${method}`, 'log');\n          return undefined;\n        }\n\n        try {\n          // @ts-expect-error\n          const result = await this[method as keyof ChromeExtensionProxyPage](\n            ...args,\n          );\n          return result;\n        } catch (e) {\n          const errorMessage = e instanceof Error ? e.message : 'Unknown error';\n          this.onLogMessage(\n            `Error calling method: ${method}, ${errorMessage}`,\n            'log',\n          );\n          throw new Error(errorMessage, { cause: e });\n        }\n      },\n      // on disconnect\n      () => {\n        return this.destroy();\n      },\n    );\n    await this.bridgeClient.connect();\n\n    // Show confirmation dialog after connection is established\n    if (this.onConnectionRequest) {\n      this.onLogMessage('Waiting for user confirmation...', 'log');\n      const allowed = await this.onConnectionRequest();\n      resolveConfirmationGate(allowed);\n      this.confirmationPromise = null;\n\n      if (!allowed) {\n        this.onLogMessage('Connection denied by user', 'log');\n        this.bridgeClient.disconnect();\n        this.bridgeClient = null;\n        throw new Error('Connection denied by user');\n      }\n    }\n\n    this.onLogMessage(\n      `Bridge connected, cli-side version v${this.bridgeClient.serverVersion}, browser-side version v${__VERSION__}`,\n      'log',\n    );\n  }\n\n  public async connect() {\n    return await this.setupBridgeClient();\n  }\n\n  public async connectNewTabWithUrl(\n    url: string,\n    options: BridgeConnectTabOptions = {\n      forceSameTabNavigation: true,\n    },\n  ) {\n    // Set the water-flow animation flag BEFORE any debugger commands are\n    // sent (which trigger enableWaterFlowAnimation via sendCommandToDebugger).\n    // Otherwise the animation gets injected during the connection flow\n    // before the CLI side's setWaterFlowAnimationEnabled(false) arrives.\n    if (options.enableWaterFlowAnimation !== undefined) {\n      this.waterFlowAnimationEnabled = options.enableWaterFlowAnimation;\n    }\n\n    // Preserve the historical default: activate the new tab unless the caller opts into background mode.\n    const activate = options.activateTab ?? true;\n    const tab = await chrome.tabs.create({ url, active: activate });\n    const tabId = tab.id;\n    assert(tabId, 'failed to get tabId after creating a new tab');\n\n    // new tab\n    this.onLogMessage(`Creating new tab: ${url}`, 'log');\n    this.newlyCreatedTabIds.push(tabId);\n\n    if (options?.forceSameTabNavigation) {\n      this.forceSameTabNavigation = true;\n    }\n\n    // chrome.tabs.create returns immediately with an about:blank target,\n    // then navigates to `url`. If we attach the debugger during that\n    // cross-origin transition Site Isolation will detach it again, leaving\n    // the first CDP command to fail with \"Debugger is not attached to the\n    // tab\". Wait for navigation to settle so the lazy attach lands on a\n    // stable target.\n    await waitForTabNavigationComplete(tabId, url);\n\n    await this.setActiveTabId(tabId, { activate });\n  }\n\n  public async connectCurrentTab(\n    options: BridgeConnectTabOptions = {\n      forceSameTabNavigation: true,\n    },\n  ) {\n    // Set the water-flow animation flag BEFORE any debugger commands are\n    // sent (which trigger enableWaterFlowAnimation via sendCommandToDebugger).\n    if (options.enableWaterFlowAnimation !== undefined) {\n      this.waterFlowAnimationEnabled = options.enableWaterFlowAnimation;\n    }\n\n    const tabs = await chrome.tabs.query({ active: true, currentWindow: true });\n    const tabId = tabs[0]?.id;\n    assert(tabId, 'failed to get tabId');\n\n    this.onLogMessage(`Connected to current tab: ${tabs[0]?.url}`, 'log');\n\n    if (options?.forceSameTabNavigation) {\n      this.forceSameTabNavigation = true;\n    }\n\n    await this.setActiveTabId(tabId);\n  }\n\n  public async setDestroyOptions(options: ChromePageDestroyOptions) {\n    this.destroyOptions = options;\n  }\n\n  async destroy() {\n    if (this.destroyOptions?.closeTab && this.newlyCreatedTabIds.length > 0) {\n      this.onLogMessage('Closing all newly created tabs by bridge...', 'log');\n      for (const tabId of this.newlyCreatedTabIds) {\n        await chrome.tabs.remove(tabId);\n      }\n      this.newlyCreatedTabIds = [];\n    }\n\n    await super.destroy();\n\n    if (this.bridgeClient) {\n      this.bridgeClient.disconnect();\n      this.bridgeClient = null;\n      this.onDisconnect();\n    }\n  }\n}\n"],"names":["NEW_TAB_LOAD_TIMEOUT_MS","isBlankUrl","url","waitForTabNavigationComplete","tabId","targetUrl","timeoutMs","Promise","resolve","settled","finish","chrome","onUpdated","clearTimeout","timer","isReady","tab","currentUrl","id","_info","setTimeout","ExtensionBridgePageBrowserSide","ChromeExtensionProxyPage","endpoint","DefaultBridgeServerHost","DefaultBridgeServerPort","resolveConfirmationGate","BridgeClient","method","args","allowed","Error","BridgeEvent","MouseEvent","actionName","KeyboardEvent","result","e","errorMessage","options","undefined","activate","assert","tabs","serverEndpoint","onDisconnect","onLogMessage","forceSameTabNavigation","onConnectionRequest"],"mappings":"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"}

package/dist/es/cli.mjs

@@ -18,7 +18,7 @@ Promise.resolve().then(()=>{
     return runToolsCLI(tools, 'midscene-web', {
         stripPrefix: 'web_',
         argv: parsedOptions.argv,
-        version: "1.14.1-beta-20261008033312.0",
+        version: "1.15.0",
         extraCommands: createReportCliCommands()
     });
 }).catch((e)=>{

package/dist/es/puppeteer/agent-launcher.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"puppeteer/agent-launcher.mjs","sources":["../../../src/puppeteer/agent-launcher.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport path from 'node:path';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert } from '@midscene/shared/utils';\n\nimport { resolveBrowserAgentRuntimeOptions } from '@/common/browser-agent';\nimport {\n  defaultViewportHeight,\n  defaultViewportWidth,\n  resolveWebViewportSize,\n} from '@/common/viewport';\nimport { PuppeteerAgent, PuppeteerBrowserAgent } from '@/puppeteer/index';\nimport { PuppeteerPageOwnership } from '@/puppeteer/page-ownership';\nimport { createScopedPuppeteerBrowserAgent } from '@/puppeteer/scoped-browser-agent';\nimport type { AgentOpt, Cache, MidsceneYamlScriptWebEnv } from '@midscene/core';\nimport { DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT } from '@midscene/shared/constants';\nimport puppeteer, {\n  type Browser,\n  type BrowserContext,\n  type DownloadBehavior,\n  type Page,\n} from 'puppeteer';\n\nexport { defaultViewportWidth, defaultViewportHeight } from '@/common/viewport';\n\nexport const defaultUA =\n  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36';\n// Setting deviceScaleFactor value to `0` means reset this value to the system default in Puppeteer.\nexport const defaultViewportScale = 0;\nexport const defaultWaitForNetworkIdleTimeout =\n  DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT;\n\nexport function resolveAiActionContext(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: Partial<Pick<AgentOpt, 'aiActionContext' | 'aiActContext'>>,\n): AgentOpt['aiActionContext'] | undefined {\n  // Prefer agent-level preference if provided; otherwise fall back to target-level context.\n  // Priority: preference.aiActContext > preference.aiActionContext (deprecated) > target.aiActionContext\n  const data =\n    preference?.aiActContext ??\n    preference?.aiActionContext ??\n    target.aiActionContext;\n  return data;\n}\n\n/**\n * Chrome arguments that may reduce browser security.\n * These should only be used in controlled testing environments.\n *\n * Security implications:\n * - `--no-sandbox`: Disables Chrome's sandbox security model\n * - `--disable-setuid-sandbox`: Disables setuid sandbox on Linux\n * - `--disable-web-security`: Allows cross-origin requests without CORS\n * - `--ignore-certificate-errors`: Ignores SSL/TLS certificate errors\n * - `--disable-features=IsolateOrigins`: Disables origin isolation\n * - `--disable-site-isolation-trials`: Disables site isolation\n * - `--allow-running-insecure-content`: Allows mixed HTTP/HTTPS content\n */\nconst DANGEROUS_ARGS = [\n  '--no-sandbox',\n  '--disable-setuid-sandbox',\n  '--disable-web-security',\n  '--ignore-certificate-errors',\n  '--disable-features=IsolateOrigins',\n  '--disable-site-isolation-trials',\n  '--allow-running-insecure-content',\n] as const;\n\n/**\n * Validates Chrome launch arguments for security concerns.\n * Emits a warning if dangerous arguments are detected.\n *\n * This function filters out arguments that are already present in baseArgs\n * to avoid warning about platform-specific defaults (e.g., --no-sandbox on non-Windows).\n *\n * @param args - Chrome launch arguments to validate\n * @param baseArgs - Base Chrome arguments already configured\n *\n * @example\n * ```typescript\n * // Will show warning for --disable-web-security\n * validateChromeArgs(['--disable-web-security', '--headless'], ['--no-sandbox']);\n *\n * // Will NOT show warning for --no-sandbox (already in baseArgs)\n * validateChromeArgs(['--no-sandbox'], ['--no-sandbox', '--headless']);\n * ```\n */\nfunction validateChromeArgs(args: string[], baseArgs: string[]): void {\n  // Filter out arguments that are already in baseArgs\n  const newArgs = args.filter(\n    (arg) =>\n      !baseArgs.some((baseArg) => {\n        // Check if arg starts with the same flag as baseArg (before '=' if present)\n        const argFlag = arg.split('=')[0];\n        const baseFlag = baseArg.split('=')[0];\n        return argFlag === baseFlag;\n      }),\n  );\n\n  const dangerousArgs = newArgs.filter((arg) =>\n    DANGEROUS_ARGS.some((dangerous) => arg.startsWith(dangerous)),\n  );\n\n  if (dangerousArgs.length > 0) {\n    console.warn(\n      `Warning: Dangerous Chrome arguments detected: ${dangerousArgs.join(', ')}.\\nThese arguments may reduce browser security. Use only in controlled testing environments.`,\n    );\n  }\n}\n\ninterface FreeFn {\n  name: string;\n  fn: () => void | Promise<void>;\n}\n\nconst launcherDebug = getDebug('puppeteer:launcher');\nconst launcherWarning = getDebug('puppeteer:launcher', { console: true });\n\nasync function cleanupFailedLaunch(freeFn: FreeFn[]): Promise<void> {\n  for (const cleanup of [...freeFn].reverse()) {\n    try {\n      await cleanup.fn();\n    } catch (error) {\n      launcherWarning(\n        `failed to run ${cleanup.name} after Puppeteer page initialization failed`,\n        error,\n      );\n    }\n  }\n}\n\nexport function buildDownloadBehavior(\n  downloadPath: string | undefined,\n): DownloadBehavior | undefined {\n  if (!downloadPath) {\n    return undefined;\n  }\n\n  return {\n    policy: 'allow',\n    downloadPath: path.resolve(downloadPath),\n  };\n}\n\nexport interface BuildChromeArgsOptions {\n  userAgent?: string;\n  windowSize?: { width: number; height: number };\n  chromeArgs?: string[];\n}\n\n/**\n * Builds Chrome launch arguments with sensible defaults.\n *\n * Platform-specific behavior:\n * - On non-Windows systems, automatically adds --no-sandbox and --disable-setuid-sandbox\n *   for compatibility with containerized/CI environments\n *\n * @param options - Configuration options for Chrome arguments\n * @returns Array of Chrome launch arguments\n *\n * @example\n * ```typescript\n * // Basic usage\n * const args = buildChromeArgs();\n *\n * // With custom arguments\n * const args = buildChromeArgs({\n *   chromeArgs: ['--disable-gpu', '--disable-dev-shm-usage'],\n *   userAgent: 'CustomUA/1.0',\n *   windowSize: { width: 1920, height: 1080 },\n * });\n * ```\n */\nexport function buildChromeArgs(options?: BuildChromeArgsOptions): string[] {\n  const isWindows = process.platform === 'win32';\n\n  const sandboxArgs = isWindows\n    ? []\n    : ['--no-sandbox', '--disable-setuid-sandbox'];\n  const featureArgs = [\n    '--disable-features=HttpsFirstBalancedModeAutoEnable',\n    '--disable-features=PasswordLeakDetection',\n    '--disable-save-password-bubble',\n  ];\n  const userAgentArg = options?.userAgent\n    ? [`--user-agent=\"${options.userAgent}\"`]\n    : [];\n  const windowSizeArg = options?.windowSize\n    ? [`--window-size=${options.windowSize.width},${options.windowSize.height}`]\n    : [];\n\n  const baseArgs = [\n    ...sandboxArgs,\n    ...featureArgs,\n    ...userAgentArg,\n    ...windowSizeArg,\n  ];\n\n  if (options?.chromeArgs?.length) {\n    validateChromeArgs(options.chromeArgs, baseArgs);\n    return [...baseArgs, ...options.chromeArgs];\n  }\n\n  return baseArgs;\n}\n\nasync function preparePuppeteerPage(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n    ignoreDefaultArgs?: boolean | string[];\n  },\n  browser?: Browser,\n  existingPage?: Page,\n  browserContext?: BrowserContext,\n) {\n  assert(target.url, 'url is required');\n  const freeFn: FreeFn[] = [];\n\n  // prepare the environment\n  const ua = target.userAgent || defaultUA;\n  const { width, height } = resolveWebViewportSize(target);\n  let dpr = defaultViewportScale;\n  if (\n    target.deviceScaleFactor !== undefined &&\n    target.deviceScaleFactor !== null\n  ) {\n    assert(\n      typeof target.deviceScaleFactor === 'number',\n      'deviceScaleFactor must be a number',\n    );\n    dpr = target.deviceScaleFactor;\n    assert(dpr > 0, `deviceScaleFactor must be > 0, but got ${dpr}`);\n  }\n  const viewportConfig = {\n    width,\n    height,\n    deviceScaleFactor: dpr,\n  };\n\n  const headed = preference?.headed || preference?.keepWindow;\n  const defaultViewportConfig = headed ? null : viewportConfig;\n\n  // launch the browser\n  if (headed && process.env.CI === '1') {\n    console.warn(\n      'you are probably running headed mode in CI, this will usually fail.',\n    );\n  }\n\n  // Build Chrome arguments using the shared helper\n  // Only pass windowSize in headed mode; in headless mode, defaultViewport takes precedence\n  // Add 100px to height to account for browser UI (address bar, tabs, etc.)\n  const browserUIHeight = 100;\n  const args = buildChromeArgs({\n    userAgent: ua,\n    windowSize: headed\n      ? { width, height: height + browserUIHeight }\n      : undefined,\n    chromeArgs: target.chromeArgs,\n  });\n  const downloadBehavior = buildDownloadBehavior(target.downloadPath);\n\n  launcherDebug(\n    'launching browser with viewport, headed',\n    headed,\n    'viewport',\n    viewportConfig,\n    'args',\n    args,\n    'preference',\n    preference,\n  );\n  // Callers may provide a page when they need to own its lifecycle. Otherwise\n  // create a new page in the supplied browser (or a newly launched browser).\n  let page: Page;\n  let browserInstance = browser;\n  let ownsBrowser = false;\n\n  try {\n    if (existingPage) {\n      page = existingPage;\n      launcherDebug('using caller-provided page');\n\n      // Get the browser instance from the existing page\n      if (!browserInstance) {\n        browserInstance = page.browser();\n      }\n    } else {\n      // Create a new browser and page\n      if (!browserInstance) {\n        browserInstance = await puppeteer.launch({\n          headless: !preference?.headed,\n          defaultViewport: defaultViewportConfig,\n          downloadBehavior,\n          args,\n          acceptInsecureCerts: target.acceptInsecureCerts,\n          ignoreDefaultArgs: preference?.ignoreDefaultArgs,\n        });\n        ownsBrowser = true;\n        freeFn.push({\n          name: 'puppeteer_browser',\n          fn: async () => {\n            if (preference?.keepWindow) {\n              return;\n            }\n            if (process.platform === 'win32') {\n              await new Promise((resolve) => setTimeout(resolve, 800));\n            }\n            await browserInstance?.close();\n          },\n        });\n      }\n      page = browserContext\n        ? await browserContext.newPage()\n        : await browserInstance.newPage();\n      if (!ownsBrowser) {\n        const createdPage = page;\n        freeFn.push({\n          name: 'puppeteer_page',\n          fn: async () => {\n            if (!preference?.keepWindow && !createdPage.isClosed()) {\n              try {\n                await createdPage.close();\n              } catch (error) {\n                throw new Error('Failed to close a YAML execution page', {\n                  cause: error,\n                });\n              }\n            }\n          },\n        });\n      }\n    }\n\n    if (target.cookie) {\n      const cookieFileContent = readFileSync(target.cookie, 'utf-8');\n      await page.browserContext().setCookie(...JSON.parse(cookieFileContent));\n    }\n\n    if (ua) {\n      await page.setUserAgent(ua);\n    }\n\n    if (target.extraHTTPHeaders) {\n      // YAML may parse unquoted values into booleans/numbers (e.g. `yes` -> true),\n      // but Puppeteer requires string header values, so normalize them here.\n      const normalizedHeaders = Object.fromEntries(\n        Object.entries(target.extraHTTPHeaders).map(([key, value]) => [\n          key,\n          String(value),\n        ]),\n      );\n      await page.setExtraHTTPHeaders(normalizedHeaders);\n    }\n\n    if (viewportConfig) {\n      await page.setViewport(viewportConfig);\n    }\n\n    return { page, freeFn };\n  } catch (error) {\n    await cleanupFailedLaunch(freeFn);\n    throw error;\n  }\n}\n\nasync function navigatePuppeteerPage(\n  page: Page,\n  target: MidsceneYamlScriptWebEnv,\n): Promise<void> {\n  const waitForNetworkIdleTimeout =\n    typeof target.waitForNetworkIdle?.timeout === 'number'\n      ? target.waitForNetworkIdle.timeout\n      : defaultWaitForNetworkIdleTimeout;\n\n  launcherDebug('goto', target.url);\n  await page.goto(target.url);\n\n  if (waitForNetworkIdleTimeout <= 0) {\n    return;\n  }\n\n  launcherDebug('waitForNetworkIdle', waitForNetworkIdleTimeout);\n  try {\n    await page.waitForNetworkIdle({\n      timeout: waitForNetworkIdleTimeout,\n    });\n  } catch (error) {\n    if (target.waitForNetworkIdle?.continueOnNetworkIdleError === false) {\n      throw new Error(`failed to wait for network idle: ${error}`, {\n        cause: error,\n      });\n    }\n    launcherWarning(\n      `failed to wait for network idle after ${waitForNetworkIdleTimeout}ms, but the script will continue.`,\n      error,\n    );\n  }\n}\n\nexport async function launchPuppeteerPage(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n    ignoreDefaultArgs?: boolean | string[];\n  },\n  browser?: Browser,\n  existingPage?: Page,\n  browserContext?: BrowserContext,\n) {\n  const preparedPage = await preparePuppeteerPage(\n    target,\n    preference,\n    browser,\n    existingPage,\n    browserContext,\n  );\n  try {\n    await navigatePuppeteerPage(preparedPage.page, target);\n    return preparedPage;\n  } catch (error) {\n    await cleanupFailedLaunch(preparedPage.freeFn);\n    throw error;\n  }\n}\n\nexport async function puppeteerAgentForTarget(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n  } & Partial<\n    Pick<\n      AgentOpt,\n      | 'groupName'\n      | 'groupDescription'\n      | 'generateReport'\n      | 'persistExecutionDump'\n      | 'autoPrintReportMsg'\n      | 'reportFileName'\n      | 'replanningCycleLimit'\n      | 'cache'\n      | 'aiActionContext'\n    >\n  >,\n  browser?: Browser,\n  existingPage?: Page,\n  browserContext?: BrowserContext,\n) {\n  const mode = target.mode ?? 'page';\n\n  if (mode !== 'page' && mode !== 'browser') {\n    throw new Error(\n      `[midscene] web target mode must be either \"page\" or \"browser\", but got \"${mode}\".`,\n    );\n  }\n\n  const runtimeOptions = resolveBrowserAgentRuntimeOptions({\n    agentName: 'YAML web target',\n    pageScope: mode,\n    forceSameTabNavigation: target.forceSameTabNavigation,\n    autoFollowNewPage: target.autoFollowNewPage,\n  });\n\n  const { page, freeFn } = await preparePuppeteerPage(\n    target,\n    preference,\n    browser,\n    existingPage,\n    browserContext,\n  );\n  const aiActContext = resolveAiActionContext(target, preference);\n\n  const { aiActionContext, ...preferenceToUse } = preference ?? {};\n\n  const commonAgentOpts = {\n    ...preferenceToUse,\n    aiActContext,\n    waitForNetworkIdleTimeout:\n      typeof target.waitForNetworkIdle?.timeout === 'number'\n        ? target.waitForNetworkIdle.timeout\n        : undefined,\n  };\n\n  // Install page ownership and BrowserAgent listeners before the first\n  // navigation. Initial document loading may synchronously open a popup; if\n  // listeners are installed after goto(), that page escapes the YAML scope.\n  let agent: PuppeteerAgent | PuppeteerBrowserAgent | undefined;\n  let pageOwnership: PuppeteerPageOwnership | undefined;\n  try {\n    if (mode === 'browser' && browser && !existingPage) {\n      pageOwnership = new PuppeteerPageOwnership(page);\n    }\n\n    if (mode === 'browser') {\n      const browserAgentOptions = {\n        ...commonAgentOpts,\n        autoFollowNewPage: runtimeOptions.autoFollowNewPage,\n      };\n      agent = pageOwnership\n        ? createScopedPuppeteerBrowserAgent(\n            page.browser(),\n            page,\n            browserAgentOptions,\n            pageOwnership,\n          )\n        : await PuppeteerBrowserAgent.create(page.browser(), {\n            ...browserAgentOptions,\n            initialPage: page,\n          });\n    } else {\n      agent = new PuppeteerAgent(page, {\n        ...commonAgentOpts,\n        forceSameTabNavigation: runtimeOptions.forceSameTabNavigation,\n      });\n    }\n\n    await navigatePuppeteerPage(page, target);\n  } catch (error) {\n    const failedLaunchCleanup = pageOwnership\n      ? [\n          ...freeFn.filter((cleanup) => cleanup.name !== 'puppeteer_page'),\n          {\n            name: 'puppeteer_page_scope',\n            fn: () =>\n              preference?.keepWindow\n                ? pageOwnership?.release()\n                : pageOwnership?.close(),\n          },\n        ]\n      : [...freeFn];\n    if (agent) {\n      failedLaunchCleanup.push({\n        name: 'midscene_puppeteer_agent',\n        fn: () => agent?.destroy(),\n      });\n    }\n    await cleanupFailedLaunch(failedLaunchCleanup);\n    throw error;\n  }\n\n  assert(agent, 'failed to initialize the Puppeteer agent');\n  const launchedAgent = agent;\n\n  const agentCleanup: FreeFn = {\n    name: 'midscene_puppeteer_agent',\n    fn: () => launchedAgent.destroy(),\n  };\n  const pageOwnershipCleanup: FreeFn | undefined = pageOwnership\n    ? {\n        name: 'puppeteer_page_scope',\n        fn: () =>\n          preference?.keepWindow\n            ? pageOwnership.release()\n            : pageOwnership.close(),\n      }\n    : undefined;\n  const launcherCleanup = pageOwnership\n    ? freeFn.filter((cleanup) => cleanup.name !== 'puppeteer_page')\n    : freeFn;\n\n  return {\n    agent: launchedAgent,\n    freeFn: [\n      agentCleanup,\n      ...(pageOwnershipCleanup ? [pageOwnershipCleanup] : []),\n      ...launcherCleanup,\n    ],\n  };\n}\n"],"names":["defaultUA","defaultViewportScale","defaultWaitForNetworkIdleTimeout","DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT","resolveAiActionContext","target","preference","data","DANGEROUS_ARGS","validateChromeArgs","args","baseArgs","newArgs","arg","baseArg","argFlag","baseFlag","dangerousArgs","dangerous","console","launcherDebug","getDebug","launcherWarning","cleanupFailedLaunch","freeFn","cleanup","error","buildDownloadBehavior","downloadPath","path","buildChromeArgs","options","isWindows","process","sandboxArgs","featureArgs","userAgentArg","windowSizeArg","preparePuppeteerPage","browser","existingPage","browserContext","assert","ua","width","height","resolveWebViewportSize","dpr","undefined","viewportConfig","headed","defaultViewportConfig","browserUIHeight","downloadBehavior","page","browserInstance","ownsBrowser","puppeteer","Promise","resolve","setTimeout","createdPage","Error","cookieFileContent","readFileSync","JSON","normalizedHeaders","Object","key","value","String","navigatePuppeteerPage","waitForNetworkIdleTimeout","launchPuppeteerPage","preparedPage","puppeteerAgentForTarget","mode","runtimeOptions","resolveBrowserAgentRuntimeOptions","aiActContext","aiActionContext","preferenceToUse","commonAgentOpts","agent","pageOwnership","PuppeteerPageOwnership","browserAgentOptions","createScopedPuppeteerBrowserAgent","PuppeteerBrowserAgent","PuppeteerAgent","failedLaunchCleanup","launchedAgent","agentCleanup","pageOwnershipCleanup","launcherCleanup"],"mappings":"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"}
+{"version":3,"file":"puppeteer/agent-launcher.mjs","sources":["../../../src/puppeteer/agent-launcher.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport path from 'node:path';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert } from '@midscene/shared/utils';\n\nimport { resolveBrowserAgentRuntimeOptions } from '@/common/browser-agent';\nimport {\n  defaultViewportHeight,\n  defaultViewportWidth,\n  resolveWebViewportSize,\n} from '@/common/viewport';\nimport { PuppeteerAgent, PuppeteerBrowserAgent } from '@/puppeteer/index';\nimport { PuppeteerPageOwnership } from '@/puppeteer/page-ownership';\nimport { createScopedPuppeteerBrowserAgent } from '@/puppeteer/scoped-browser-agent';\nimport type { AgentOpt, Cache, MidsceneYamlScriptWebEnv } from '@midscene/core';\nimport { DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT } from '@midscene/shared/constants';\nimport puppeteer, {\n  type Browser,\n  type BrowserContext,\n  type DownloadBehavior,\n  type Page,\n} from 'puppeteer';\n\nexport { defaultViewportWidth, defaultViewportHeight } from '@/common/viewport';\n\nexport const defaultUA =\n  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36';\n// Setting deviceScaleFactor value to `0` means reset this value to the system default in Puppeteer.\nexport const defaultViewportScale = 0;\nexport const defaultWaitForNetworkIdleTimeout =\n  DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT;\n\nexport function resolveAiActionContext(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: Partial<Pick<AgentOpt, 'aiActionContext' | 'aiActContext'>>,\n): AgentOpt['aiActionContext'] | undefined {\n  // Prefer agent-level preference if provided; otherwise fall back to target-level context.\n  // Priority: preference.aiActContext > preference.aiActionContext (deprecated) > target.aiActionContext\n  const data =\n    preference?.aiActContext ??\n    preference?.aiActionContext ??\n    target.aiActionContext;\n  return data;\n}\n\n/**\n * Chrome arguments that may reduce browser security.\n * These should only be used in controlled testing environments.\n *\n * Security implications:\n * - `--no-sandbox`: Disables Chrome's sandbox security model\n * - `--disable-setuid-sandbox`: Disables setuid sandbox on Linux\n * - `--disable-web-security`: Allows cross-origin requests without CORS\n * - `--ignore-certificate-errors`: Ignores SSL/TLS certificate errors\n * - `--disable-features=IsolateOrigins`: Disables origin isolation\n * - `--disable-site-isolation-trials`: Disables site isolation\n * - `--allow-running-insecure-content`: Allows mixed HTTP/HTTPS content\n */\nconst DANGEROUS_ARGS = [\n  '--no-sandbox',\n  '--disable-setuid-sandbox',\n  '--disable-web-security',\n  '--ignore-certificate-errors',\n  '--disable-features=IsolateOrigins',\n  '--disable-site-isolation-trials',\n  '--allow-running-insecure-content',\n] as const;\n\n/**\n * Validates Chrome launch arguments for security concerns.\n * Emits a warning if dangerous arguments are detected.\n *\n * This function filters out arguments that are already present in baseArgs\n * to avoid warning about platform-specific defaults (e.g., --no-sandbox on non-Windows).\n *\n * @param args - Chrome launch arguments to validate\n * @param baseArgs - Base Chrome arguments already configured\n *\n * @example\n * ```typescript\n * // Will show warning for --disable-web-security\n * validateChromeArgs(['--disable-web-security', '--headless'], ['--no-sandbox']);\n *\n * // Will NOT show warning for --no-sandbox (already in baseArgs)\n * validateChromeArgs(['--no-sandbox'], ['--no-sandbox', '--headless']);\n * ```\n */\nfunction validateChromeArgs(args: string[], baseArgs: string[]): void {\n  // Filter out arguments that are already in baseArgs\n  const newArgs = args.filter(\n    (arg) =>\n      !baseArgs.some((baseArg) => {\n        // Check if arg starts with the same flag as baseArg (before '=' if present)\n        const argFlag = arg.split('=')[0];\n        const baseFlag = baseArg.split('=')[0];\n        return argFlag === baseFlag;\n      }),\n  );\n\n  const dangerousArgs = newArgs.filter((arg) =>\n    DANGEROUS_ARGS.some((dangerous) => arg.startsWith(dangerous)),\n  );\n\n  if (dangerousArgs.length > 0) {\n    console.warn(\n      `Warning: Dangerous Chrome arguments detected: ${dangerousArgs.join(', ')}.\\nThese arguments may reduce browser security. Use only in controlled testing environments.`,\n    );\n  }\n}\n\ninterface FreeFn {\n  name: string;\n  fn: () => void | Promise<void>;\n}\n\nconst launcherDebug = getDebug('puppeteer:launcher');\nconst launcherWarning = getDebug('puppeteer:launcher', { console: true });\n\nasync function cleanupFailedLaunch(freeFn: FreeFn[]): Promise<void> {\n  for (const cleanup of [...freeFn].reverse()) {\n    try {\n      await cleanup.fn();\n    } catch (error) {\n      launcherWarning(\n        `failed to run ${cleanup.name} after Puppeteer page initialization failed`,\n        error,\n      );\n    }\n  }\n}\n\nexport function buildDownloadBehavior(\n  downloadPath: string | undefined,\n): DownloadBehavior | undefined {\n  if (!downloadPath) {\n    return undefined;\n  }\n\n  return {\n    policy: 'allow',\n    downloadPath: path.resolve(downloadPath),\n  };\n}\n\nexport interface BuildChromeArgsOptions {\n  userAgent?: string;\n  windowSize?: { width: number; height: number };\n  chromeArgs?: string[];\n}\n\n/**\n * Builds Chrome launch arguments with sensible defaults.\n *\n * Platform-specific behavior:\n * - On non-Windows systems, automatically adds --no-sandbox and --disable-setuid-sandbox\n *   for compatibility with containerized/CI environments\n *\n * @param options - Configuration options for Chrome arguments\n * @returns Array of Chrome launch arguments\n *\n * @example\n * ```typescript\n * // Basic usage\n * const args = buildChromeArgs();\n *\n * // With custom arguments\n * const args = buildChromeArgs({\n *   chromeArgs: ['--disable-gpu', '--disable-dev-shm-usage'],\n *   userAgent: 'CustomUA/1.0',\n *   windowSize: { width: 1920, height: 1080 },\n * });\n * ```\n */\nexport function buildChromeArgs(options?: BuildChromeArgsOptions): string[] {\n  const isWindows = process.platform === 'win32';\n\n  const sandboxArgs = isWindows\n    ? []\n    : ['--no-sandbox', '--disable-setuid-sandbox'];\n  const featureArgs = [\n    '--disable-features=HttpsFirstBalancedModeAutoEnable',\n    '--disable-features=PasswordLeakDetection',\n    '--disable-save-password-bubble',\n  ];\n  const userAgentArg = options?.userAgent\n    ? [`--user-agent=\"${options.userAgent}\"`]\n    : [];\n  const windowSizeArg = options?.windowSize\n    ? [`--window-size=${options.windowSize.width},${options.windowSize.height}`]\n    : [];\n\n  const baseArgs = [\n    ...sandboxArgs,\n    ...featureArgs,\n    ...userAgentArg,\n    ...windowSizeArg,\n  ];\n\n  if (options?.chromeArgs?.length) {\n    validateChromeArgs(options.chromeArgs, baseArgs);\n    return [...baseArgs, ...options.chromeArgs];\n  }\n\n  return baseArgs;\n}\n\nasync function preparePuppeteerPage(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n    ignoreDefaultArgs?: boolean | string[];\n  },\n  browser?: Browser,\n  existingPage?: Page,\n  browserContext?: BrowserContext,\n) {\n  assert(target.url, 'url is required');\n  const freeFn: FreeFn[] = [];\n\n  // prepare the environment\n  const ua = target.userAgent || defaultUA;\n  const { width, height } = resolveWebViewportSize(target);\n  let dpr = defaultViewportScale;\n  if (\n    target.deviceScaleFactor !== undefined &&\n    target.deviceScaleFactor !== null\n  ) {\n    assert(\n      typeof target.deviceScaleFactor === 'number',\n      'deviceScaleFactor must be a number',\n    );\n    dpr = target.deviceScaleFactor;\n    assert(dpr > 0, `deviceScaleFactor must be > 0, but got ${dpr}`);\n  }\n  const viewportConfig = {\n    width,\n    height,\n    deviceScaleFactor: dpr,\n  };\n\n  const headed = preference?.headed || preference?.keepWindow;\n  const defaultViewportConfig = headed ? null : viewportConfig;\n\n  // launch the browser\n  if (headed && process.env.CI === '1') {\n    console.warn(\n      'you are probably running headed mode in CI, this will usually fail.',\n    );\n  }\n\n  // Build Chrome arguments using the shared helper\n  // Only pass windowSize in headed mode; in headless mode, defaultViewport takes precedence\n  // Add 100px to height to account for browser UI (address bar, tabs, etc.)\n  const browserUIHeight = 100;\n  const args = buildChromeArgs({\n    userAgent: ua,\n    windowSize: headed\n      ? { width, height: height + browserUIHeight }\n      : undefined,\n    chromeArgs: target.chromeArgs,\n  });\n  const downloadBehavior = buildDownloadBehavior(target.downloadPath);\n\n  launcherDebug(\n    'launching browser with viewport, headed',\n    headed,\n    'viewport',\n    viewportConfig,\n    'args',\n    args,\n    'preference',\n    preference,\n  );\n  // Callers may provide a page when they need to own its lifecycle. Otherwise\n  // create a new page in the supplied browser (or a newly launched browser).\n  let page: Page;\n  let browserInstance = browser;\n  let ownsBrowser = false;\n\n  try {\n    if (existingPage) {\n      page = existingPage;\n      launcherDebug('using caller-provided page');\n\n      // Get the browser instance from the existing page\n      if (!browserInstance) {\n        browserInstance = page.browser();\n      }\n    } else {\n      // Create a new browser and page\n      if (!browserInstance) {\n        browserInstance = await puppeteer.launch({\n          headless: !preference?.headed,\n          defaultViewport: defaultViewportConfig,\n          downloadBehavior,\n          args,\n          acceptInsecureCerts: target.acceptInsecureCerts,\n          ignoreDefaultArgs: preference?.ignoreDefaultArgs,\n        });\n        ownsBrowser = true;\n        freeFn.push({\n          name: 'puppeteer_browser',\n          fn: async () => {\n            if (preference?.keepWindow) {\n              return;\n            }\n            if (process.platform === 'win32') {\n              await new Promise((resolve) => setTimeout(resolve, 800));\n            }\n            await browserInstance?.close();\n          },\n        });\n      }\n      page = browserContext\n        ? await browserContext.newPage()\n        : await browserInstance.newPage();\n      if (!ownsBrowser) {\n        const createdPage = page;\n        freeFn.push({\n          name: 'puppeteer_page',\n          fn: async () => {\n            if (!preference?.keepWindow && !createdPage.isClosed()) {\n              try {\n                await createdPage.close();\n              } catch (error) {\n                throw new Error('Failed to close a YAML execution page', {\n                  cause: error,\n                });\n              }\n            }\n          },\n        });\n      }\n    }\n\n    if (target.cookie) {\n      const cookieFileContent = readFileSync(target.cookie, 'utf-8');\n      await page.browserContext().setCookie(...JSON.parse(cookieFileContent));\n    }\n\n    if (ua) {\n      await page.setUserAgent(ua);\n    }\n\n    if (target.extraHTTPHeaders) {\n      // YAML may parse unquoted values into booleans/numbers (e.g. `yes` -> true),\n      // but Puppeteer requires string header values, so normalize them here.\n      const normalizedHeaders = Object.fromEntries(\n        Object.entries(target.extraHTTPHeaders).map(([key, value]) => [\n          key,\n          String(value),\n        ]),\n      );\n      await page.setExtraHTTPHeaders(normalizedHeaders);\n    }\n\n    if (viewportConfig) {\n      await page.setViewport(viewportConfig);\n    }\n\n    return { page, freeFn };\n  } catch (error) {\n    await cleanupFailedLaunch(freeFn);\n    throw error;\n  }\n}\n\nasync function navigatePuppeteerPage(\n  page: Page,\n  target: MidsceneYamlScriptWebEnv,\n): Promise<void> {\n  const waitForNetworkIdleTimeout =\n    typeof target.waitForNetworkIdle?.timeout === 'number'\n      ? target.waitForNetworkIdle.timeout\n      : defaultWaitForNetworkIdleTimeout;\n\n  launcherDebug('goto', target.url);\n  await page.goto(target.url);\n\n  if (waitForNetworkIdleTimeout <= 0) {\n    return;\n  }\n\n  launcherDebug('waitForNetworkIdle', waitForNetworkIdleTimeout);\n  try {\n    await page.waitForNetworkIdle({\n      timeout: waitForNetworkIdleTimeout,\n    });\n  } catch (error) {\n    if (target.waitForNetworkIdle?.continueOnNetworkIdleError === false) {\n      throw new Error(`failed to wait for network idle: ${error}`, {\n        cause: error,\n      });\n    }\n    launcherWarning(\n      `failed to wait for network idle after ${waitForNetworkIdleTimeout}ms, but the script will continue.`,\n      error,\n    );\n  }\n}\n\nexport async function launchPuppeteerPage(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n    ignoreDefaultArgs?: boolean | string[];\n  },\n  browser?: Browser,\n  existingPage?: Page,\n  browserContext?: BrowserContext,\n) {\n  const preparedPage = await preparePuppeteerPage(\n    target,\n    preference,\n    browser,\n    existingPage,\n    browserContext,\n  );\n  try {\n    await navigatePuppeteerPage(preparedPage.page, target);\n    return preparedPage;\n  } catch (error) {\n    await cleanupFailedLaunch(preparedPage.freeFn);\n    throw error;\n  }\n}\n\nexport async function puppeteerAgentForTarget(\n  target: MidsceneYamlScriptWebEnv,\n  preference?: {\n    headed?: boolean;\n    keepWindow?: boolean;\n  } & Partial<\n    Pick<\n      AgentOpt,\n      | 'groupName'\n      | 'groupDescription'\n      | 'generateReport'\n      | 'persistExecutionDump'\n      | 'autoPrintReportMsg'\n      | 'reportFileName'\n      | 'replanningCycleLimit'\n      | 'cache'\n      | 'aiActionContext'\n      | 'waitForActionReady'\n    >\n  >,\n  browser?: Browser,\n  existingPage?: Page,\n  browserContext?: BrowserContext,\n) {\n  const mode = target.mode ?? 'page';\n\n  if (mode !== 'page' && mode !== 'browser') {\n    throw new Error(\n      `[midscene] web target mode must be either \"page\" or \"browser\", but got \"${mode}\".`,\n    );\n  }\n\n  const runtimeOptions = resolveBrowserAgentRuntimeOptions({\n    agentName: 'YAML web target',\n    pageScope: mode,\n    forceSameTabNavigation: target.forceSameTabNavigation,\n    autoFollowNewPage: target.autoFollowNewPage,\n  });\n\n  const { page, freeFn } = await preparePuppeteerPage(\n    target,\n    preference,\n    browser,\n    existingPage,\n    browserContext,\n  );\n  const aiActContext = resolveAiActionContext(target, preference);\n\n  const { aiActionContext, ...preferenceToUse } = preference ?? {};\n\n  const commonAgentOpts = {\n    ...preferenceToUse,\n    aiActContext,\n    waitForNetworkIdleTimeout:\n      typeof target.waitForNetworkIdle?.timeout === 'number'\n        ? target.waitForNetworkIdle.timeout\n        : undefined,\n  };\n\n  // Install page ownership and BrowserAgent listeners before the first\n  // navigation. Initial document loading may synchronously open a popup; if\n  // listeners are installed after goto(), that page escapes the YAML scope.\n  let agent: PuppeteerAgent | PuppeteerBrowserAgent | undefined;\n  let pageOwnership: PuppeteerPageOwnership | undefined;\n  try {\n    if (mode === 'browser' && browser && !existingPage) {\n      pageOwnership = new PuppeteerPageOwnership(page);\n    }\n\n    if (mode === 'browser') {\n      const browserAgentOptions = {\n        ...commonAgentOpts,\n        autoFollowNewPage: runtimeOptions.autoFollowNewPage,\n      };\n      agent = pageOwnership\n        ? createScopedPuppeteerBrowserAgent(\n            page.browser(),\n            page,\n            browserAgentOptions,\n            pageOwnership,\n          )\n        : await PuppeteerBrowserAgent.create(page.browser(), {\n            ...browserAgentOptions,\n            initialPage: page,\n          });\n    } else {\n      agent = new PuppeteerAgent(page, {\n        ...commonAgentOpts,\n        forceSameTabNavigation: runtimeOptions.forceSameTabNavigation,\n      });\n    }\n\n    await navigatePuppeteerPage(page, target);\n  } catch (error) {\n    const failedLaunchCleanup = pageOwnership\n      ? [\n          ...freeFn.filter((cleanup) => cleanup.name !== 'puppeteer_page'),\n          {\n            name: 'puppeteer_page_scope',\n            fn: () =>\n              preference?.keepWindow\n                ? pageOwnership?.release()\n                : pageOwnership?.close(),\n          },\n        ]\n      : [...freeFn];\n    if (agent) {\n      failedLaunchCleanup.push({\n        name: 'midscene_puppeteer_agent',\n        fn: () => agent?.destroy(),\n      });\n    }\n    await cleanupFailedLaunch(failedLaunchCleanup);\n    throw error;\n  }\n\n  assert(agent, 'failed to initialize the Puppeteer agent');\n  const launchedAgent = agent;\n\n  const agentCleanup: FreeFn = {\n    name: 'midscene_puppeteer_agent',\n    fn: () => launchedAgent.destroy(),\n  };\n  const pageOwnershipCleanup: FreeFn | undefined = pageOwnership\n    ? {\n        name: 'puppeteer_page_scope',\n        fn: () =>\n          preference?.keepWindow\n            ? pageOwnership.release()\n            : pageOwnership.close(),\n      }\n    : undefined;\n  const launcherCleanup = pageOwnership\n    ? freeFn.filter((cleanup) => cleanup.name !== 'puppeteer_page')\n    : freeFn;\n\n  return {\n    agent: launchedAgent,\n    freeFn: [\n      agentCleanup,\n      ...(pageOwnershipCleanup ? [pageOwnershipCleanup] : []),\n      ...launcherCleanup,\n    ],\n  };\n}\n"],"names":["defaultUA","defaultViewportScale","defaultWaitForNetworkIdleTimeout","DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT","resolveAiActionContext","target","preference","data","DANGEROUS_ARGS","validateChromeArgs","args","baseArgs","newArgs","arg","baseArg","argFlag","baseFlag","dangerousArgs","dangerous","console","launcherDebug","getDebug","launcherWarning","cleanupFailedLaunch","freeFn","cleanup","error","buildDownloadBehavior","downloadPath","path","buildChromeArgs","options","isWindows","process","sandboxArgs","featureArgs","userAgentArg","windowSizeArg","preparePuppeteerPage","browser","existingPage","browserContext","assert","ua","width","height","resolveWebViewportSize","dpr","undefined","viewportConfig","headed","defaultViewportConfig","browserUIHeight","downloadBehavior","page","browserInstance","ownsBrowser","puppeteer","Promise","resolve","setTimeout","createdPage","Error","cookieFileContent","readFileSync","JSON","normalizedHeaders","Object","key","value","String","navigatePuppeteerPage","waitForNetworkIdleTimeout","launchPuppeteerPage","preparedPage","puppeteerAgentForTarget","mode","runtimeOptions","resolveBrowserAgentRuntimeOptions","aiActContext","aiActionContext","preferenceToUse","commonAgentOpts","agent","pageOwnership","PuppeteerPageOwnership","browserAgentOptions","createScopedPuppeteerBrowserAgent","PuppeteerBrowserAgent","PuppeteerAgent","failedLaunchCleanup","launchedAgent","agentCleanup","pageOwnershipCleanup","launcherCleanup"],"mappings":";;;;;;;;;;;AAyBO,MAAMA,YACX;AAEK,MAAMC,uBAAuB;AAC7B,MAAMC,mCACXC;AAEK,SAASC,uBACdC,MAAgC,EAChCC,UAAwE;IAIxE,MAAMC,OACJD,YAAY,gBACZA,YAAY,mBACZD,OAAO,eAAe;IACxB,OAAOE;AACT;AAeA,MAAMC,iBAAiB;IACrB;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAqBD,SAASC,mBAAmBC,IAAc,EAAEC,QAAkB;IAE5D,MAAMC,UAAUF,KAAK,MAAM,CACzB,CAACG,MACC,CAACF,SAAS,IAAI,CAAC,CAACG;YAEd,MAAMC,UAAUF,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE;YACjC,MAAMG,WAAWF,QAAQ,KAAK,CAAC,IAAI,CAAC,EAAE;YACtC,OAAOC,YAAYC;QACrB;IAGJ,MAAMC,gBAAgBL,QAAQ,MAAM,CAAC,CAACC,MACpCL,eAAe,IAAI,CAAC,CAACU,YAAcL,IAAI,UAAU,CAACK;IAGpD,IAAID,cAAc,MAAM,GAAG,GACzBE,QAAQ,IAAI,CACV,CAAC,8CAA8C,EAAEF,cAAc,IAAI,CAAC,MAAM,4FAA4F,CAAC;AAG7K;AAOA,MAAMG,gBAAgBC,SAAS;AAC/B,MAAMC,kBAAkBD,SAAS,sBAAsB;IAAE,SAAS;AAAK;AAEvE,eAAeE,oBAAoBC,MAAgB;IACjD,KAAK,MAAMC,WAAW;WAAID;KAAO,CAAC,OAAO,GACvC,IAAI;QACF,MAAMC,QAAQ,EAAE;IAClB,EAAE,OAAOC,OAAO;QACdJ,gBACE,CAAC,cAAc,EAAEG,QAAQ,IAAI,CAAC,2CAA2C,CAAC,EAC1EC;IAEJ;AAEJ;AAEO,SAASC,sBACdC,YAAgC;IAEhC,IAAI,CAACA,cACH;IAGF,OAAO;QACL,QAAQ;QACR,cAAcC,UAAAA,OAAY,CAACD;IAC7B;AACF;AA+BO,SAASE,gBAAgBC,OAAgC;IAC9D,MAAMC,YAAYC,AAAqB,YAArBA,QAAQ,QAAQ;IAElC,MAAMC,cAAcF,YAChB,EAAE,GACF;QAAC;QAAgB;KAA2B;IAChD,MAAMG,cAAc;QAClB;QACA;QACA;KACD;IACD,MAAMC,eAAeL,SAAS,YAC1B;QAAC,CAAC,cAAc,EAAEA,QAAQ,SAAS,CAAC,CAAC,CAAC;KAAC,GACvC,EAAE;IACN,MAAMM,gBAAgBN,SAAS,aAC3B;QAAC,CAAC,cAAc,EAAEA,QAAQ,UAAU,CAAC,KAAK,CAAC,CAAC,EAAEA,QAAQ,UAAU,CAAC,MAAM,EAAE;KAAC,GAC1E,EAAE;IAEN,MAAMpB,WAAW;WACZuB;WACAC;WACAC;WACAC;KACJ;IAED,IAAIN,SAAS,YAAY,QAAQ;QAC/BtB,mBAAmBsB,QAAQ,UAAU,EAAEpB;QACvC,OAAO;eAAIA;eAAaoB,QAAQ,UAAU;SAAC;IAC7C;IAEA,OAAOpB;AACT;AAEA,eAAe2B,qBACbjC,MAAgC,EAChCC,UAIC,EACDiC,OAAiB,EACjBC,YAAmB,EACnBC,cAA+B;IAE/BC,OAAOrC,OAAO,GAAG,EAAE;IACnB,MAAMmB,SAAmB,EAAE;IAG3B,MAAMmB,KAAKtC,OAAO,SAAS,IAAIL;IAC/B,MAAM,EAAE4C,KAAK,EAAEC,MAAM,EAAE,GAAGC,uBAAuBzC;IACjD,IAAI0C,MAAM9C;IACV,IACEI,AAA6B2C,WAA7B3C,OAAO,iBAAiB,IACxBA,AAA6B,SAA7BA,OAAO,iBAAiB,EACxB;QACAqC,OACE,AAAoC,YAApC,OAAOrC,OAAO,iBAAiB,EAC/B;QAEF0C,MAAM1C,OAAO,iBAAiB;QAC9BqC,OAAOK,MAAM,GAAG,CAAC,uCAAuC,EAAEA,KAAK;IACjE;IACA,MAAME,iBAAiB;QACrBL;QACAC;QACA,mBAAmBE;IACrB;IAEA,MAAMG,SAAS5C,YAAY,UAAUA,YAAY;IACjD,MAAM6C,wBAAwBD,SAAS,OAAOD;IAG9C,IAAIC,UAAUjB,AAAmB,QAAnBA,QAAQ,GAAG,CAAC,EAAE,EAC1Bd,QAAQ,IAAI,CACV;IAOJ,MAAMiC,kBAAkB;IACxB,MAAM1C,OAAOoB,gBAAgB;QAC3B,WAAWa;QACX,YAAYO,SACR;YAAEN;YAAO,QAAQC,SAASO;QAAgB,IAC1CJ;QACJ,YAAY3C,OAAO,UAAU;IAC/B;IACA,MAAMgD,mBAAmB1B,sBAAsBtB,OAAO,YAAY;IAElEe,cACE,2CACA8B,QACA,YACAD,gBACA,QACAvC,MACA,cACAJ;IAIF,IAAIgD;IACJ,IAAIC,kBAAkBhB;IACtB,IAAIiB,cAAc;IAElB,IAAI;QACF,IAAIhB,cAAc;YAChBc,OAAOd;YACPpB,cAAc;YAGd,IAAI,CAACmC,iBACHA,kBAAkBD,KAAK,OAAO;QAElC,OAAO;YAEL,IAAI,CAACC,iBAAiB;gBACpBA,kBAAkB,MAAME,UAAU,MAAM,CAAC;oBACvC,UAAU,CAACnD,YAAY;oBACvB,iBAAiB6C;oBACjBE;oBACA3C;oBACA,qBAAqBL,OAAO,mBAAmB;oBAC/C,mBAAmBC,YAAY;gBACjC;gBACAkD,cAAc;gBACdhC,OAAO,IAAI,CAAC;oBACV,MAAM;oBACN,IAAI;wBACF,IAAIlB,YAAY,YACd;wBAEF,IAAI2B,AAAqB,YAArBA,QAAQ,QAAQ,EAClB,MAAM,IAAIyB,QAAQ,CAACC,UAAYC,WAAWD,SAAS;wBAErD,MAAMJ,iBAAiB;oBACzB;gBACF;YACF;YACAD,OAAOb,iBACH,MAAMA,eAAe,OAAO,KAC5B,MAAMc,gBAAgB,OAAO;YACjC,IAAI,CAACC,aAAa;gBAChB,MAAMK,cAAcP;gBACpB9B,OAAO,IAAI,CAAC;oBACV,MAAM;oBACN,IAAI;wBACF,IAAI,CAAClB,YAAY,cAAc,CAACuD,YAAY,QAAQ,IAClD,IAAI;4BACF,MAAMA,YAAY,KAAK;wBACzB,EAAE,OAAOnC,OAAO;4BACd,MAAM,IAAIoC,MAAM,yCAAyC;gCACvD,OAAOpC;4BACT;wBACF;oBAEJ;gBACF;YACF;QACF;QAEA,IAAIrB,OAAO,MAAM,EAAE;YACjB,MAAM0D,oBAAoBC,aAAa3D,OAAO,MAAM,EAAE;YACtD,MAAMiD,KAAK,cAAc,GAAG,SAAS,IAAIW,KAAK,KAAK,CAACF;QACtD;QAEA,IAAIpB,IACF,MAAMW,KAAK,YAAY,CAACX;QAG1B,IAAItC,OAAO,gBAAgB,EAAE;YAG3B,MAAM6D,oBAAoBC,OAAO,WAAW,CAC1CA,OAAO,OAAO,CAAC9D,OAAO,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC+D,KAAKC,MAAM,GAAK;oBAC5DD;oBACAE,OAAOD;iBACR;YAEH,MAAMf,KAAK,mBAAmB,CAACY;QACjC;QAEA,IAAIjB,gBACF,MAAMK,KAAK,WAAW,CAACL;QAGzB,OAAO;YAAEK;YAAM9B;QAAO;IACxB,EAAE,OAAOE,OAAO;QACd,MAAMH,oBAAoBC;QAC1B,MAAME;IACR;AACF;AAEA,eAAe6C,sBACbjB,IAAU,EACVjD,MAAgC;IAEhC,MAAMmE,4BACJ,AAA8C,YAA9C,OAAOnE,OAAO,kBAAkB,EAAE,UAC9BA,OAAO,kBAAkB,CAAC,OAAO,GACjCH;IAENkB,cAAc,QAAQf,OAAO,GAAG;IAChC,MAAMiD,KAAK,IAAI,CAACjD,OAAO,GAAG;IAE1B,IAAImE,6BAA6B,GAC/B;IAGFpD,cAAc,sBAAsBoD;IACpC,IAAI;QACF,MAAMlB,KAAK,kBAAkB,CAAC;YAC5B,SAASkB;QACX;IACF,EAAE,OAAO9C,OAAO;QACd,IAAIrB,OAAO,kBAAkB,EAAE,+BAA+B,OAC5D,MAAM,IAAIyD,MAAM,CAAC,iCAAiC,EAAEpC,OAAO,EAAE;YAC3D,OAAOA;QACT;QAEFJ,gBACE,CAAC,sCAAsC,EAAEkD,0BAA0B,iCAAiC,CAAC,EACrG9C;IAEJ;AACF;AAEO,eAAe+C,oBACpBpE,MAAgC,EAChCC,UAIC,EACDiC,OAAiB,EACjBC,YAAmB,EACnBC,cAA+B;IAE/B,MAAMiC,eAAe,MAAMpC,qBACzBjC,QACAC,YACAiC,SACAC,cACAC;IAEF,IAAI;QACF,MAAM8B,sBAAsBG,aAAa,IAAI,EAAErE;QAC/C,OAAOqE;IACT,EAAE,OAAOhD,OAAO;QACd,MAAMH,oBAAoBmD,aAAa,MAAM;QAC7C,MAAMhD;IACR;AACF;AAEO,eAAeiD,wBACpBtE,MAAgC,EAChCC,UAiBC,EACDiC,OAAiB,EACjBC,YAAmB,EACnBC,cAA+B;IAE/B,MAAMmC,OAAOvE,OAAO,IAAI,IAAI;IAE5B,IAAIuE,AAAS,WAATA,QAAmBA,AAAS,cAATA,MACrB,MAAM,IAAId,MACR,CAAC,wEAAwE,EAAEc,KAAK,EAAE,CAAC;IAIvF,MAAMC,iBAAiBC,kCAAkC;QACvD,WAAW;QACX,WAAWF;QACX,wBAAwBvE,OAAO,sBAAsB;QACrD,mBAAmBA,OAAO,iBAAiB;IAC7C;IAEA,MAAM,EAAEiD,IAAI,EAAE9B,MAAM,EAAE,GAAG,MAAMc,qBAC7BjC,QACAC,YACAiC,SACAC,cACAC;IAEF,MAAMsC,eAAe3E,uBAAuBC,QAAQC;IAEpD,MAAM,EAAE0E,eAAe,EAAE,GAAGC,iBAAiB,GAAG3E,cAAc,CAAC;IAE/D,MAAM4E,kBAAkB;QACtB,GAAGD,eAAe;QAClBF;QACA,2BACE,AAA8C,YAA9C,OAAO1E,OAAO,kBAAkB,EAAE,UAC9BA,OAAO,kBAAkB,CAAC,OAAO,GACjC2C;IACR;IAKA,IAAImC;IACJ,IAAIC;IACJ,IAAI;QACF,IAAIR,AAAS,cAATA,QAAsBrC,WAAW,CAACC,cACpC4C,gBAAgB,IAAIC,uBAAuB/B;QAG7C,IAAIsB,AAAS,cAATA,MAAoB;YACtB,MAAMU,sBAAsB;gBAC1B,GAAGJ,eAAe;gBAClB,mBAAmBL,eAAe,iBAAiB;YACrD;YACAM,QAAQC,gBACJG,kCACEjC,KAAK,OAAO,IACZA,MACAgC,qBACAF,iBAEF,MAAMI,sBAAsB,MAAM,CAAClC,KAAK,OAAO,IAAI;gBACjD,GAAGgC,mBAAmB;gBACtB,aAAahC;YACf;QACN,OACE6B,QAAQ,IAAIM,eAAenC,MAAM;YAC/B,GAAG4B,eAAe;YAClB,wBAAwBL,eAAe,sBAAsB;QAC/D;QAGF,MAAMN,sBAAsBjB,MAAMjD;IACpC,EAAE,OAAOqB,OAAO;QACd,MAAMgE,sBAAsBN,gBACxB;eACK5D,OAAO,MAAM,CAAC,CAACC,UAAYA,AAAiB,qBAAjBA,QAAQ,IAAI;YAC1C;gBACE,MAAM;gBACN,IAAI,IACFnB,YAAY,aACR8E,eAAe,YACfA,eAAe;YACvB;SACD,GACD;eAAI5D;SAAO;QACf,IAAI2D,OACFO,oBAAoB,IAAI,CAAC;YACvB,MAAM;YACN,IAAI,IAAMP,OAAO;QACnB;QAEF,MAAM5D,oBAAoBmE;QAC1B,MAAMhE;IACR;IAEAgB,OAAOyC,OAAO;IACd,MAAMQ,gBAAgBR;IAEtB,MAAMS,eAAuB;QAC3B,MAAM;QACN,IAAI,IAAMD,cAAc,OAAO;IACjC;IACA,MAAME,uBAA2CT,gBAC7C;QACE,MAAM;QACN,IAAI,IACF9E,YAAY,aACR8E,cAAc,OAAO,KACrBA,cAAc,KAAK;IAC3B,IACApC;IACJ,MAAM8C,kBAAkBV,gBACpB5D,OAAO,MAAM,CAAC,CAACC,UAAYA,AAAiB,qBAAjBA,QAAQ,IAAI,IACvCD;IAEJ,OAAO;QACL,OAAOmE;QACP,QAAQ;YACNC;eACIC,uBAAuB;gBAACA;aAAqB,GAAG,EAAE;eACnDC;SACJ;IACH;AACF"}

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

@@ -759,11 +759,13 @@ class Page {
     async beforeInvokeAction(name, param) {
         if (this.onBeforeInvokeAction) await this.onBeforeInvokeAction(name, param);
     }
-    async afterInvokeAction(name, param) {
+    async defaultActionWait(name, _param) {
         await Promise.all([
             this.waitForNavigation('afterInvokeAction', name),
             this.waitForNetworkIdle('afterInvokeAction', name)
         ]);
+    }
+    async afterInvokeAction(name, param) {
         if (this.onAfterInvokeAction) await this.onAfterInvokeAction(name, param);
     }
     async destroy() {}