@midscene/web 1.10.4-beta-20260710115744.0 → 1.10.4-beta-20260710135045.0

package/dist/es/agent-tools-puppeteer.mjs

@@ -1,12 +1,13 @@
 import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
-import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { mkdir, open as promises_open, readFile, unlink, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { ScreenshotItem } from "@midscene/core";
 import { extractAgentBehaviorInitArgs, getAgentInitArgsSignature, shouldRebuildAgentForInitArgs } from "@midscene/shared/agent-tools/agent-behavior-init-args";
 import { BaseMidsceneTools } from "@midscene/shared/agent-tools/base-tools";
 import { resolveChromePath } from "@midscene/shared/agent-tools/chrome-path";
+import { getDebug } from "@midscene/shared/logger";
 import puppeteer_core from "puppeteer-core";
 import { adaptWebAgentInitArgs, webAgentInitArgShape } from "./agent-init-args.mjs";
 import { defaultPuppeteerWindowViewportSize, defaultStaticPageViewportSize } from "./common/viewport.mjs";
@@ -24,7 +25,10 @@ function _define_property(obj, key, value) {
 }
 const ENDPOINT_FILE = join(tmpdir(), 'midscene-puppeteer-endpoint');
 const USER_DATA_DIR = join(tmpdir(), 'midscene-puppeteer-profile');
+const TARGET_ID_FILE = join(tmpdir(), 'midscene-puppeteer-target-id');
 const DETACHED_CHROME_LAUNCH_TIMEOUT_MS = 30000;
+const DETACHED_CHROME_ENDPOINT_POLL_INTERVAL_MS = 25;
+const debug = getDebug('agent-tools:puppeteer');
 const PUPPETEER_ENDPOINT_FILE = ENDPOINT_FILE;
 function buildDetachedChromeArgs(options) {
     const viewport = options.viewport ?? defaultPuppeteerWindowViewportSize;
@@ -54,6 +58,67 @@ function terminateDetachedChrome(proc) {
         proc.kill('SIGKILL');
     } catch  {}
 }
+function getTargetId(page) {
+    return page.target()._targetId;
+}
+function waitForDetachedChromeEndpoint(proc, stderrFile, timeoutMs = DETACHED_CHROME_LAUNCH_TIMEOUT_MS) {
+    return new Promise((resolve, reject)=>{
+        let output = '';
+        let settled = false;
+        let exited = false;
+        let pollTimer;
+        const cleanup = ()=>{
+            clearTimeout(timeout);
+            if (pollTimer) clearTimeout(pollTimer);
+            proc.removeListener('exit', onExit);
+            proc.removeListener('error', onError);
+        };
+        const resolveOnce = (value)=>{
+            if (settled) return;
+            settled = true;
+            cleanup();
+            resolve(value);
+        };
+        const rejectOnce = (error, terminate = false)=>{
+            if (settled) return;
+            settled = true;
+            if (terminate) terminateDetachedChrome(proc);
+            cleanup();
+            reject(error);
+        };
+        const onExit = (code, signal)=>{
+            exited = true;
+            readFile(stderrFile, 'utf-8').catch(()=>output).then((latestOutput)=>{
+                output = latestOutput;
+                rejectOnce(new Error(`Chrome exited with code ${code ?? signal} before DevTools was ready.\nChrome stderr: ${output}\nTip: if running in a container, launch Chrome with sandbox-compatible arguments.`));
+            });
+        };
+        const onError = (error)=>{
+            rejectOnce(new Error(`Failed to launch Chrome. Stderr log: "${stderrFile}".`, {
+                cause: error
+            }), true);
+        };
+        const pollForEndpoint = async ()=>{
+            if (settled || exited) return;
+            try {
+                output = await readFile(stderrFile, 'utf-8');
+            } catch (error) {
+                rejectOnce(new Error(`Failed to read Chrome stderr log "${stderrFile}".`, {
+                    cause: error
+                }), true);
+                return;
+            }
+            if (settled || exited) return;
+            const match = output.match(/DevTools listening on (ws:\/\/[^\s]+)/);
+            if (match) return void resolveOnce(match[1]);
+            pollTimer = setTimeout(()=>void pollForEndpoint(), DETACHED_CHROME_ENDPOINT_POLL_INTERVAL_MS);
+        };
+        const timeout = setTimeout(()=>rejectOnce(new Error(`Chrome launch timeout.\nChrome stderr: ${output}\nTip: if running in a container, launch Chrome with sandbox-compatible arguments.`), true), timeoutMs);
+        proc.on('exit', onExit);
+        proc.on('error', onError);
+        pollForEndpoint();
+    });
+}
 class PuppeteerBrowserManager {
     get endpointFile() {
         return this.persistence.endpointFile || ENDPOINT_FILE;
@@ -61,6 +126,53 @@ class PuppeteerBrowserManager {
     get userDataDir() {
         return this.persistence.userDataDir || USER_DATA_DIR;
     }
+    get targetIdFile() {
+        return this.persistence.targetIdFile || TARGET_ID_FILE;
+    }
+    get chromeStderrFile() {
+        return join(this.userDataDir, 'chrome-stderr.log');
+    }
+    async readSavedTargetId() {
+        let content;
+        try {
+            content = await readFile(this.targetIdFile, 'utf-8');
+        } catch (error) {
+            if ('ENOENT' === error.code) return null;
+            throw new Error(`Failed to read Puppeteer targetId from "${this.targetIdFile}".`, {
+                cause: error
+            });
+        }
+        const targetId = content.trim();
+        if (!targetId) throw new Error(`Puppeteer targetId file "${this.targetIdFile}" is empty.`);
+        return targetId;
+    }
+    async saveTargetId(targetId) {
+        try {
+            await writeFile(this.targetIdFile, targetId, 'utf-8');
+            debug('Saved Puppeteer targetId: %s', targetId);
+        } catch (error) {
+            throw new Error(`Failed to save Puppeteer targetId to "${this.targetIdFile}".`, {
+                cause: error
+            });
+        }
+    }
+    async cleanupTargetIdFile() {
+        try {
+            await unlink(this.targetIdFile);
+        } catch (error) {
+            if ('ENOENT' === error.code) return;
+            throw new Error(`Failed to remove Puppeteer targetId file "${this.targetIdFile}".`, {
+                cause: error
+            });
+        }
+    }
+    async cleanupChromeStderrFile() {
+        try {
+            await unlink(this.chromeStderrFile);
+        } catch (error) {
+            if ('ENOENT' !== error.code) debug('Failed to clean Chrome stderr log: %s', error);
+        }
+    }
     async getOrLaunch(viewport) {
         const endpointFile = this.endpointFile;
         if (existsSync(endpointFile)) try {
@@ -73,11 +185,14 @@ class PuppeteerBrowserManager {
                 browser,
                 reused: true
             };
-        } catch  {
+        } catch (error) {
+            debug('Failed to reuse persisted Puppeteer endpoint: %s', error);
             try {
                 await unlink(endpointFile);
             } catch  {}
+            await this.cleanupTargetIdFile();
         }
+        await this.cleanupTargetIdFile();
         const wsEndpoint = await this.launchDetachedChrome(viewport);
         await writeFile(endpointFile, wsEndpoint);
         const browser = await puppeteer_core.connect({
@@ -91,17 +206,20 @@ class PuppeteerBrowserManager {
     }
     async closeBrowser() {
         const endpointFile = this.endpointFile;
-        if (!existsSync(endpointFile)) return;
-        try {
+        if (existsSync(endpointFile)) try {
             const endpoint = (await readFile(endpointFile, 'utf-8')).trim();
             const browser = await puppeteer_core.connect({
                 browserWSEndpoint: endpoint
             });
             await browser.close();
-        } catch  {}
+        } catch (error) {
+            debug('Failed to close persisted Puppeteer browser: %s', error);
+        }
         try {
-            await unlink(endpointFile);
+            if (existsSync(endpointFile)) await unlink(endpointFile);
         } catch  {}
+        await this.cleanupTargetIdFile();
+        await this.cleanupChromeStderrFile();
     }
     disconnect() {
         if (this.activeBrowser) {
@@ -119,48 +237,34 @@ class PuppeteerBrowserManager {
             userDataDir,
             viewport
         });
-        const proc = spawn(chromePath, args, {
-            detached: true,
-            stdio: [
-                'ignore',
-                'ignore',
-                'pipe'
-            ]
-        });
+        const stderrFile = this.chromeStderrFile;
+        const stderrHandle = await promises_open(stderrFile, 'w');
+        let proc;
+        try {
+            proc = spawn(chromePath, args, {
+                detached: true,
+                stdio: [
+                    'ignore',
+                    'ignore',
+                    stderrHandle.fd
+                ]
+            });
+        } catch (error) {
+            await stderrHandle.close();
+            throw error;
+        }
+        const endpointPromise = waitForDetachedChromeEndpoint(proc, stderrFile);
         proc.unref();
-        return new Promise((resolve, reject)=>{
-            let output = '';
-            let settled = false;
-            const cleanup = ()=>{
-                clearTimeout(timeout);
-                proc.stderr.removeListener('data', onData);
-                proc.removeListener('exit', onExit);
-            };
-            const resolveOnce = (value)=>{
-                if (settled) return;
-                settled = true;
-                cleanup();
-                resolve(value);
-            };
-            const rejectOnce = (error, terminate = false)=>{
-                if (settled) return;
-                settled = true;
-                if (terminate) terminateDetachedChrome(proc);
-                cleanup();
-                reject(error);
-            };
-            const onData = (data)=>{
-                output += data.toString();
-                const match = output.match(/DevTools listening on (ws:\/\/[^\s]+)/);
-                if (match) resolveOnce(match[1]);
-            };
-            proc.stderr.on('data', onData);
-            const onExit = (code, signal)=>{
-                rejectOnce(new Error(`Chrome exited with code ${code ?? signal} before DevTools was ready.\nChrome stderr: ${output}\nTip: if running in a container, launch Chrome with sandbox-compatible arguments.`));
-            };
-            proc.on('exit', onExit);
-            const timeout = setTimeout(()=>rejectOnce(new Error(`Chrome launch timeout.\nChrome stderr: ${output}\nTip: if running in a container, launch Chrome with sandbox-compatible arguments.`), true), DETACHED_CHROME_LAUNCH_TIMEOUT_MS);
-        });
+        try {
+            await stderrHandle.close();
+        } catch (error) {
+            terminateDetachedChrome(proc);
+            await endpointPromise.catch(()=>void 0);
+            throw new Error(`Failed to close Chrome stderr log "${stderrFile}".`, {
+                cause: error
+            });
+        }
+        return endpointPromise;
     }
     constructor(persistence = {}){
         _define_property(this, "persistence", void 0);
@@ -204,11 +308,16 @@ class WebPuppeteerMidsceneTools extends BaseMidsceneTools {
                 waitUntil: 'domcontentloaded'
             });
         } else {
+            const savedTargetId = await this.browserManager.readSavedTargetId();
+            const matchedPage = savedTargetId ? pages.find((candidate)=>getTargetId(candidate) === savedTargetId) : void 0;
             const webPages = pages.filter((p)=>/^https?:\/\//.test(p.url()));
-            page = webPages.length > 0 ? webPages[webPages.length - 1] : pages[pages.length - 1] || await browser.newPage();
+            page = matchedPage ?? (webPages.length > 0 ? webPages[webPages.length - 1] : pages[pages.length - 1] || await browser.newPage());
             if (reused) await page.bringToFront();
             if (this.viewport) await page.setViewport(this.viewport);
         }
+        const targetId = getTargetId(page);
+        if (!targetId) throw new Error('Failed to persist Puppeteer page session because Puppeteer did not expose a Chrome targetId.');
+        await this.browserManager.saveTargetId(targetId);
         const reportOptions = this.readCliReportAgentOptions();
         this.agent = new PuppeteerAgent(page, {
             ...extractAgentBehaviorInitArgs(initArgs) ?? {},
@@ -267,6 +376,7 @@ class WebPuppeteerMidsceneTools extends BaseMidsceneTools {
                         this.lastInitArgsSignature = void 0;
                     }
                     this.browserManager.disconnect();
+                    await this.browserManager.cleanupTargetIdFile();
                     return this.buildTextResult('Disconnected from web page (browser still running)');
                 }
             },
@@ -303,6 +413,6 @@ class WebPuppeteerMidsceneTools extends BaseMidsceneTools {
         this.browserManager = options.persistence ? new PuppeteerBrowserManager(options.persistence) : defaultBrowserManager;
     }
 }
-export { PUPPETEER_ENDPOINT_FILE, WebPuppeteerMidsceneTools, buildDetachedChromeArgs };
+export { PUPPETEER_ENDPOINT_FILE, WebPuppeteerMidsceneTools, buildDetachedChromeArgs, waitForDetachedChromeEndpoint };
 
 //# sourceMappingURL=agent-tools-puppeteer.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-tools-puppeteer.mjs","sources":["../../src/agent-tools-puppeteer.ts"],"sourcesContent":["import { type ChildProcess, spawn } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { ScreenshotItem } from '@midscene/core';\nimport {\n  extractAgentBehaviorInitArgs,\n  getAgentInitArgsSignature,\n  shouldRebuildAgentForInitArgs,\n} from '@midscene/shared/agent-tools/agent-behavior-init-args';\nimport {\n  BaseMidsceneTools,\n  type InitArgSpec,\n} from '@midscene/shared/agent-tools/base-tools';\nimport { resolveChromePath } from '@midscene/shared/agent-tools/chrome-path';\nimport type { ToolDefinition } from '@midscene/shared/agent-tools/types';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\nimport {\n  type WebAgentInitArgs,\n  adaptWebAgentInitArgs,\n  webAgentInitArgShape,\n} from './agent-init-args';\nimport {\n  type ViewportSize,\n  defaultPuppeteerWindowViewportSize,\n  defaultStaticPageViewportSize,\n} from './common/viewport';\nimport { PuppeteerAgent } from './puppeteer';\nimport { StaticPage } from './static';\n\nconst ENDPOINT_FILE = join(tmpdir(), 'midscene-puppeteer-endpoint');\nconst USER_DATA_DIR = join(tmpdir(), 'midscene-puppeteer-profile');\nconst DETACHED_CHROME_LAUNCH_TIMEOUT_MS = 30_000;\n\nexport const PUPPETEER_ENDPOINT_FILE = ENDPOINT_FILE;\n\nexport interface PuppeteerPersistenceOptions {\n  endpointFile?: string;\n  userDataDir?: string;\n}\n\nexport interface WebPuppeteerMidsceneToolsOptions {\n  persistence?: PuppeteerPersistenceOptions;\n}\n\nexport function buildDetachedChromeArgs(options: {\n  userDataDir: string;\n  viewport?: ViewportSize;\n}): string[] {\n  const viewport = options.viewport ?? defaultPuppeteerWindowViewportSize;\n\n  return [\n    '--headless=new',\n    `--user-data-dir=${options.userDataDir}`,\n    '--remote-debugging-port=0',\n    '--no-first-run',\n    '--no-default-browser-check',\n    '--disable-extensions',\n    '--disable-default-apps',\n    '--disable-sync',\n    '--disable-background-networking',\n    '--password-store=basic',\n    '--use-mock-keychain',\n    `--window-size=${viewport.width},${viewport.height}`,\n    '--force-color-profile=srgb',\n  ];\n}\n\nfunction terminateDetachedChrome(proc: ChildProcess): void {\n  if (proc.killed || proc.exitCode !== null || proc.signalCode !== null) {\n    return;\n  }\n\n  if (process.platform !== 'win32' && proc.pid) {\n    try {\n      process.kill(-proc.pid, 'SIGKILL');\n      return;\n    } catch {}\n  }\n\n  try {\n    proc.kill('SIGKILL');\n  } catch {}\n}\n\n/**\n * Persistent Puppeteer browser manager.\n * Launches a detached Chrome and persists the WS endpoint across CLI calls.\n */\nclass PuppeteerBrowserManager {\n  activeBrowser: Browser | null = null;\n\n  constructor(private readonly persistence: PuppeteerPersistenceOptions = {}) {}\n\n  private get endpointFile() {\n    return this.persistence.endpointFile || ENDPOINT_FILE;\n  }\n\n  private get userDataDir() {\n    return this.persistence.userDataDir || USER_DATA_DIR;\n  }\n\n  async getOrLaunch(\n    viewport?: ViewportSize,\n  ): Promise<{ browser: Browser; reused: boolean }> {\n    const endpointFile = this.endpointFile;\n    if (existsSync(endpointFile)) {\n      try {\n        const endpoint = (await readFile(endpointFile, 'utf-8')).trim();\n        const browser = await puppeteer.connect({\n          browserWSEndpoint: endpoint,\n          defaultViewport: null,\n        });\n        return { browser, reused: true };\n      } catch {\n        try {\n          await unlink(endpointFile);\n        } catch {}\n      }\n    }\n\n    const wsEndpoint = await this.launchDetachedChrome(viewport);\n    await writeFile(endpointFile, wsEndpoint);\n\n    const browser = await puppeteer.connect({\n      browserWSEndpoint: wsEndpoint,\n      defaultViewport: null,\n    });\n    return { browser, reused: false };\n  }\n\n  async closeBrowser(): Promise<void> {\n    const endpointFile = this.endpointFile;\n    if (!existsSync(endpointFile)) return;\n    try {\n      const endpoint = (await readFile(endpointFile, 'utf-8')).trim();\n      const browser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n      });\n      await browser.close();\n    } catch {}\n    try {\n      await unlink(endpointFile);\n    } catch {}\n  }\n\n  disconnect(): void {\n    if (this.activeBrowser) {\n      this.activeBrowser.disconnect();\n      this.activeBrowser = null;\n    }\n  }\n\n  async launchDetachedChrome(viewport?: ViewportSize): Promise<string> {\n    const chromePath = resolveChromePath();\n    const userDataDir = this.userDataDir;\n\n    await mkdir(userDataDir, { recursive: true });\n\n    const args = buildDetachedChromeArgs({\n      userDataDir,\n      viewport,\n    });\n\n    const proc = spawn(chromePath, args, {\n      detached: true,\n      stdio: ['ignore', 'ignore', 'pipe'],\n    });\n    proc.unref();\n\n    return new Promise<string>((resolve, reject) => {\n      let output = '';\n      let settled = false;\n      const cleanup = () => {\n        clearTimeout(timeout);\n        proc.stderr!.removeListener('data', onData);\n        proc.removeListener('exit', onExit);\n      };\n      const resolveOnce = (value: string) => {\n        if (settled) return;\n        settled = true;\n        cleanup();\n        resolve(value);\n      };\n      const rejectOnce = (error: Error, terminate = false) => {\n        if (settled) return;\n        settled = true;\n        if (terminate) {\n          terminateDetachedChrome(proc);\n        }\n        cleanup();\n        reject(error);\n      };\n      const onData = (data: Buffer) => {\n        output += data.toString();\n        const match = output.match(/DevTools listening on (ws:\\/\\/[^\\s]+)/);\n        if (match) {\n          resolveOnce(match[1]);\n        }\n      };\n      proc.stderr!.on('data', onData);\n\n      const onExit = (code: number | null, signal: NodeJS.Signals | null) => {\n        rejectOnce(\n          new Error(\n            `Chrome exited with code ${code ?? signal} before DevTools was ready.\\nChrome stderr: ${output}\\nTip: if running in a container, launch Chrome with sandbox-compatible arguments.`,\n          ),\n        );\n      };\n      proc.on('exit', onExit);\n\n      const timeout = setTimeout(\n        () =>\n          rejectOnce(\n            new Error(\n              `Chrome launch timeout.\\nChrome stderr: ${output}\\nTip: if running in a container, launch Chrome with sandbox-compatible arguments.`,\n            ),\n            true,\n          ),\n        DETACHED_CHROME_LAUNCH_TIMEOUT_MS,\n      );\n    });\n  }\n}\n\nconst defaultBrowserManager = new PuppeteerBrowserManager();\n\n/**\n * Tools manager for Web Puppeteer mode.\n * Uses a persistent headless Chrome browser that survives across CLI calls.\n */\nexport class WebPuppeteerMidsceneTools extends BaseMidsceneTools<\n  PuppeteerAgent,\n  WebAgentInitArgs\n> {\n  private readonly viewport?: ViewportSize;\n  private readonly browserManager: PuppeteerBrowserManager;\n  private lastInitArgsSignature?: string;\n\n  constructor(\n    viewport?: ViewportSize,\n    options: WebPuppeteerMidsceneToolsOptions = {},\n  ) {\n    super();\n    this.viewport = viewport ? { ...viewport } : undefined;\n    this.browserManager = options.persistence\n      ? new PuppeteerBrowserManager(options.persistence)\n      : defaultBrowserManager;\n  }\n\n  protected getCliReportSessionName() {\n    return 'midscene-web';\n  }\n\n  protected readonly initArgSpec: InitArgSpec<WebAgentInitArgs> = {\n    namespace: 'web',\n    shape: webAgentInitArgShape,\n    cli: {\n      preferBareKeys: true,\n    },\n    adapt: adaptWebAgentInitArgs,\n  };\n\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: this.viewport ?? defaultStaticPageViewportSize,\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    initArgs?: WebAgentInitArgs,\n  ): Promise<PuppeteerAgent> {\n    const navigateToUrl = initArgs?.url;\n    const nextSignature = getAgentInitArgsSignature(initArgs);\n    const shouldOpenUrl = typeof navigateToUrl === 'string';\n\n    if (\n      this.agent &&\n      (shouldOpenUrl ||\n        shouldRebuildAgentForInitArgs(\n          this.lastInitArgsSignature,\n          nextSignature,\n        ))\n    ) {\n      try {\n        await this.agent?.destroy?.();\n      } catch {}\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    const { browser, reused } = await this.browserManager.getOrLaunch(\n      this.viewport,\n    );\n    this.browserManager.activeBrowser = browser;\n\n    const pages = await browser.pages();\n    let page: Page;\n\n    if (navigateToUrl) {\n      page = await browser.newPage();\n      if (this.viewport) {\n        await page.setViewport(this.viewport);\n      }\n      await page.goto(navigateToUrl, {\n        timeout: 30000,\n        waitUntil: 'domcontentloaded',\n      });\n    } else {\n      // Reuse the last web page\n      const webPages = pages.filter((p) => /^https?:\\/\\//.test(p.url()));\n      page =\n        webPages.length > 0\n          ? webPages[webPages.length - 1]\n          : pages[pages.length - 1] || (await browser.newPage());\n\n      if (reused) {\n        await page.bringToFront();\n      }\n      if (this.viewport) {\n        await page.setViewport(this.viewport);\n      }\n    }\n\n    const reportOptions = this.readCliReportAgentOptions();\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage, {\n      ...(extractAgentBehaviorInitArgs(initArgs) ?? {}),\n      ...(reportOptions ?? {}),\n    });\n    this.lastInitArgsSignature = nextSignature;\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    this.browserManager.disconnect();\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to a web page. Opens a new tab with the given URL, or reuses the current page.',\n        schema: this.getAgentInitArgSchema(),\n        cli: this.getAgentInitArgCliMetadata(),\n        handler: async (args) => {\n          const initArgs = this.extractAgentInitParam(args);\n          const url = initArgs?.url;\n\n          // Explicit connect always starts a fresh page session.\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n\n          const reportSession = this.createNewCliReportSession(\n            url ?? 'current-page',\n          );\n          this.commitCliReportSession(reportSession);\n          this.agent = await this.ensureAgent(initArgs);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current page';\n\n          return {\n            content: [\n              { type: 'text', text: `Connected to: ${label}` },\n              ...(screenshot ? this.buildScreenshotContent(screenshot) : []),\n            ],\n          };\n        },\n      },\n      {\n        name: 'web_disconnect',\n        description:\n          'Disconnect from current web page. The browser stays running for future calls.',\n        schema: {},\n        handler: async () => {\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n          this.browserManager.disconnect();\n          return this.buildTextResult(\n            'Disconnected from web page (browser still running)',\n          );\n        },\n      },\n      {\n        name: 'web_close',\n        description: 'Close the browser completely and release all resources.',\n        schema: {},\n        handler: async () => {\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n          await this.browserManager.closeBrowser();\n          return this.buildTextResult('Browser closed');\n        },\n      },\n    ];\n  }\n}\n"],"names":["ENDPOINT_FILE","join","tmpdir","USER_DATA_DIR","DETACHED_CHROME_LAUNCH_TIMEOUT_MS","PUPPETEER_ENDPOINT_FILE","buildDetachedChromeArgs","options","viewport","defaultPuppeteerWindowViewportSize","terminateDetachedChrome","proc","process","PuppeteerBrowserManager","endpointFile","existsSync","endpoint","readFile","browser","puppeteer","unlink","wsEndpoint","writeFile","chromePath","resolveChromePath","userDataDir","mkdir","args","spawn","Promise","resolve","reject","output","settled","cleanup","clearTimeout","timeout","onData","onExit","resolveOnce","value","rejectOnce","error","terminate","data","match","code","signal","Error","setTimeout","persistence","defaultBrowserManager","WebPuppeteerMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","defaultStaticPageViewportSize","initArgs","navigateToUrl","nextSignature","getAgentInitArgsSignature","shouldOpenUrl","shouldRebuildAgentForInitArgs","undefined","reused","pages","page","webPages","p","reportOptions","PuppeteerAgent","extractAgentBehaviorInitArgs","url","reportSession","screenshot","label","webAgentInitArgShape","adaptWebAgentInitArgs"],"mappings":"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"}
+{"version":3,"file":"agent-tools-puppeteer.mjs","sources":["../../src/agent-tools-puppeteer.ts"],"sourcesContent":["import { type ChildProcess, spawn } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { mkdir, open, readFile, unlink, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { ScreenshotItem } from '@midscene/core';\nimport {\n  extractAgentBehaviorInitArgs,\n  getAgentInitArgsSignature,\n  shouldRebuildAgentForInitArgs,\n} from '@midscene/shared/agent-tools/agent-behavior-init-args';\nimport {\n  BaseMidsceneTools,\n  type InitArgSpec,\n} from '@midscene/shared/agent-tools/base-tools';\nimport { resolveChromePath } from '@midscene/shared/agent-tools/chrome-path';\nimport type { ToolDefinition } from '@midscene/shared/agent-tools/types';\nimport { getDebug } from '@midscene/shared/logger';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\nimport {\n  type WebAgentInitArgs,\n  adaptWebAgentInitArgs,\n  webAgentInitArgShape,\n} from './agent-init-args';\nimport {\n  type ViewportSize,\n  defaultPuppeteerWindowViewportSize,\n  defaultStaticPageViewportSize,\n} from './common/viewport';\nimport { PuppeteerAgent } from './puppeteer';\nimport { StaticPage } from './static';\n\nconst ENDPOINT_FILE = join(tmpdir(), 'midscene-puppeteer-endpoint');\nconst USER_DATA_DIR = join(tmpdir(), 'midscene-puppeteer-profile');\nconst TARGET_ID_FILE = join(tmpdir(), 'midscene-puppeteer-target-id');\nconst DETACHED_CHROME_LAUNCH_TIMEOUT_MS = 30_000;\nconst DETACHED_CHROME_ENDPOINT_POLL_INTERVAL_MS = 25;\nconst debug = getDebug('agent-tools:puppeteer');\n\nexport const PUPPETEER_ENDPOINT_FILE = ENDPOINT_FILE;\n\nexport interface PuppeteerPersistenceOptions {\n  endpointFile?: string;\n  userDataDir?: string;\n  targetIdFile?: string;\n}\n\nexport interface WebPuppeteerMidsceneToolsOptions {\n  persistence?: PuppeteerPersistenceOptions;\n}\n\nexport function buildDetachedChromeArgs(options: {\n  userDataDir: string;\n  viewport?: ViewportSize;\n}): string[] {\n  const viewport = options.viewport ?? defaultPuppeteerWindowViewportSize;\n\n  return [\n    '--headless=new',\n    `--user-data-dir=${options.userDataDir}`,\n    '--remote-debugging-port=0',\n    '--no-first-run',\n    '--no-default-browser-check',\n    '--disable-extensions',\n    '--disable-default-apps',\n    '--disable-sync',\n    '--disable-background-networking',\n    '--password-store=basic',\n    '--use-mock-keychain',\n    `--window-size=${viewport.width},${viewport.height}`,\n    '--force-color-profile=srgb',\n  ];\n}\n\nfunction terminateDetachedChrome(proc: ChildProcess): void {\n  if (proc.killed || proc.exitCode !== null || proc.signalCode !== null) {\n    return;\n  }\n\n  if (process.platform !== 'win32' && proc.pid) {\n    try {\n      process.kill(-proc.pid, 'SIGKILL');\n      return;\n    } catch {}\n  }\n\n  try {\n    proc.kill('SIGKILL');\n  } catch {}\n}\n\nfunction getTargetId(page: Page): string | undefined {\n  return (page.target() as unknown as { _targetId?: string })._targetId;\n}\n\nexport function waitForDetachedChromeEndpoint(\n  proc: ChildProcess,\n  stderrFile: string,\n  timeoutMs = DETACHED_CHROME_LAUNCH_TIMEOUT_MS,\n): Promise<string> {\n  return new Promise<string>((resolve, reject) => {\n    let output = '';\n    let settled = false;\n    let exited = false;\n    let pollTimer: NodeJS.Timeout | undefined;\n    const cleanup = () => {\n      clearTimeout(timeout);\n      if (pollTimer) {\n        clearTimeout(pollTimer);\n      }\n      proc.removeListener('exit', onExit);\n      proc.removeListener('error', onError);\n    };\n    const resolveOnce = (value: string) => {\n      if (settled) return;\n      settled = true;\n      cleanup();\n      resolve(value);\n    };\n    const rejectOnce = (error: Error, terminate = false) => {\n      if (settled) return;\n      settled = true;\n      if (terminate) {\n        terminateDetachedChrome(proc);\n      }\n      cleanup();\n      reject(error);\n    };\n    const onExit = (code: number | null, signal: NodeJS.Signals | null) => {\n      exited = true;\n      void readFile(stderrFile, 'utf-8')\n        .catch(() => output)\n        .then((latestOutput) => {\n          output = latestOutput;\n          rejectOnce(\n            new Error(\n              `Chrome exited with code ${code ?? signal} before DevTools was ready.\\nChrome stderr: ${output}\\nTip: if running in a container, launch Chrome with sandbox-compatible arguments.`,\n            ),\n          );\n        });\n    };\n    const onError = (error: Error) => {\n      rejectOnce(\n        new Error(`Failed to launch Chrome. Stderr log: \"${stderrFile}\".`, {\n          cause: error,\n        }),\n        true,\n      );\n    };\n    const pollForEndpoint = async (): Promise<void> => {\n      if (settled || exited) return;\n      try {\n        output = await readFile(stderrFile, 'utf-8');\n      } catch (error) {\n        rejectOnce(\n          new Error(`Failed to read Chrome stderr log \"${stderrFile}\".`, {\n            cause: error,\n          }),\n          true,\n        );\n        return;\n      }\n\n      if (settled || exited) return;\n      const match = output.match(/DevTools listening on (ws:\\/\\/[^\\s]+)/);\n      if (match) {\n        resolveOnce(match[1]);\n        return;\n      }\n      pollTimer = setTimeout(\n        () => void pollForEndpoint(),\n        DETACHED_CHROME_ENDPOINT_POLL_INTERVAL_MS,\n      );\n    };\n    const timeout = setTimeout(\n      () =>\n        rejectOnce(\n          new Error(\n            `Chrome launch timeout.\\nChrome stderr: ${output}\\nTip: if running in a container, launch Chrome with sandbox-compatible arguments.`,\n          ),\n          true,\n        ),\n      timeoutMs,\n    );\n\n    proc.on('exit', onExit);\n    proc.on('error', onError);\n    void pollForEndpoint();\n  });\n}\n\n/**\n * Persistent Puppeteer browser manager.\n * Launches a detached Chrome and persists the WS endpoint across CLI calls.\n */\nclass PuppeteerBrowserManager {\n  activeBrowser: Browser | null = null;\n\n  constructor(private readonly persistence: PuppeteerPersistenceOptions = {}) {}\n\n  private get endpointFile() {\n    return this.persistence.endpointFile || ENDPOINT_FILE;\n  }\n\n  private get userDataDir() {\n    return this.persistence.userDataDir || USER_DATA_DIR;\n  }\n\n  private get targetIdFile() {\n    return this.persistence.targetIdFile || TARGET_ID_FILE;\n  }\n\n  private get chromeStderrFile() {\n    return join(this.userDataDir, 'chrome-stderr.log');\n  }\n\n  async readSavedTargetId(): Promise<string | null> {\n    let content: string;\n    try {\n      content = await readFile(this.targetIdFile, 'utf-8');\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === 'ENOENT') return null;\n      throw new Error(\n        `Failed to read Puppeteer targetId from \"${this.targetIdFile}\".`,\n        { cause: error },\n      );\n    }\n\n    const targetId = content.trim();\n    if (!targetId) {\n      throw new Error(\n        `Puppeteer targetId file \"${this.targetIdFile}\" is empty.`,\n      );\n    }\n    return targetId;\n  }\n\n  async saveTargetId(targetId: string): Promise<void> {\n    try {\n      await writeFile(this.targetIdFile, targetId, 'utf-8');\n      debug('Saved Puppeteer targetId: %s', targetId);\n    } catch (error) {\n      throw new Error(\n        `Failed to save Puppeteer targetId to \"${this.targetIdFile}\".`,\n        { cause: error },\n      );\n    }\n  }\n\n  async cleanupTargetIdFile(): Promise<void> {\n    try {\n      await unlink(this.targetIdFile);\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === 'ENOENT') return;\n      throw new Error(\n        `Failed to remove Puppeteer targetId file \"${this.targetIdFile}\".`,\n        { cause: error },\n      );\n    }\n  }\n\n  async cleanupChromeStderrFile(): Promise<void> {\n    try {\n      await unlink(this.chromeStderrFile);\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n        debug('Failed to clean Chrome stderr log: %s', error);\n      }\n    }\n  }\n\n  async getOrLaunch(\n    viewport?: ViewportSize,\n  ): Promise<{ browser: Browser; reused: boolean }> {\n    const endpointFile = this.endpointFile;\n    if (existsSync(endpointFile)) {\n      try {\n        const endpoint = (await readFile(endpointFile, 'utf-8')).trim();\n        const browser = await puppeteer.connect({\n          browserWSEndpoint: endpoint,\n          defaultViewport: null,\n        });\n        return { browser, reused: true };\n      } catch (error) {\n        debug('Failed to reuse persisted Puppeteer endpoint: %s', error);\n        try {\n          await unlink(endpointFile);\n        } catch {}\n        await this.cleanupTargetIdFile();\n      }\n    }\n\n    await this.cleanupTargetIdFile();\n    const wsEndpoint = await this.launchDetachedChrome(viewport);\n    await writeFile(endpointFile, wsEndpoint);\n\n    const browser = await puppeteer.connect({\n      browserWSEndpoint: wsEndpoint,\n      defaultViewport: null,\n    });\n    return { browser, reused: false };\n  }\n\n  async closeBrowser(): Promise<void> {\n    const endpointFile = this.endpointFile;\n    if (existsSync(endpointFile)) {\n      try {\n        const endpoint = (await readFile(endpointFile, 'utf-8')).trim();\n        const browser = await puppeteer.connect({\n          browserWSEndpoint: endpoint,\n        });\n        await browser.close();\n      } catch (error) {\n        debug('Failed to close persisted Puppeteer browser: %s', error);\n      }\n    }\n    try {\n      if (existsSync(endpointFile)) {\n        await unlink(endpointFile);\n      }\n    } catch {}\n    await this.cleanupTargetIdFile();\n    await this.cleanupChromeStderrFile();\n  }\n\n  disconnect(): void {\n    if (this.activeBrowser) {\n      this.activeBrowser.disconnect();\n      this.activeBrowser = null;\n    }\n  }\n\n  async launchDetachedChrome(viewport?: ViewportSize): Promise<string> {\n    const chromePath = resolveChromePath();\n    const userDataDir = this.userDataDir;\n\n    await mkdir(userDataDir, { recursive: true });\n\n    const args = buildDetachedChromeArgs({\n      userDataDir,\n      viewport,\n    });\n\n    const stderrFile = this.chromeStderrFile;\n    const stderrHandle = await open(stderrFile, 'w');\n    let proc: ChildProcess;\n    try {\n      proc = spawn(chromePath, args, {\n        detached: true,\n        stdio: ['ignore', 'ignore', stderrHandle.fd],\n      });\n    } catch (error) {\n      await stderrHandle.close();\n      throw error;\n    }\n    const endpointPromise = waitForDetachedChromeEndpoint(proc, stderrFile);\n    proc.unref();\n    try {\n      await stderrHandle.close();\n    } catch (error) {\n      terminateDetachedChrome(proc);\n      await endpointPromise.catch(() => undefined);\n      throw new Error(`Failed to close Chrome stderr log \"${stderrFile}\".`, {\n        cause: error,\n      });\n    }\n\n    return endpointPromise;\n  }\n}\n\nconst defaultBrowserManager = new PuppeteerBrowserManager();\n\n/**\n * Tools manager for Web Puppeteer mode.\n * Uses a persistent headless Chrome browser that survives across CLI calls.\n */\nexport class WebPuppeteerMidsceneTools extends BaseMidsceneTools<\n  PuppeteerAgent,\n  WebAgentInitArgs\n> {\n  private readonly viewport?: ViewportSize;\n  private readonly browserManager: PuppeteerBrowserManager;\n  private lastInitArgsSignature?: string;\n\n  constructor(\n    viewport?: ViewportSize,\n    options: WebPuppeteerMidsceneToolsOptions = {},\n  ) {\n    super();\n    this.viewport = viewport ? { ...viewport } : undefined;\n    this.browserManager = options.persistence\n      ? new PuppeteerBrowserManager(options.persistence)\n      : defaultBrowserManager;\n  }\n\n  protected getCliReportSessionName() {\n    return 'midscene-web';\n  }\n\n  protected readonly initArgSpec: InitArgSpec<WebAgentInitArgs> = {\n    namespace: 'web',\n    shape: webAgentInitArgShape,\n    cli: {\n      preferBareKeys: true,\n    },\n    adapt: adaptWebAgentInitArgs,\n  };\n\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: this.viewport ?? defaultStaticPageViewportSize,\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    initArgs?: WebAgentInitArgs,\n  ): Promise<PuppeteerAgent> {\n    const navigateToUrl = initArgs?.url;\n    const nextSignature = getAgentInitArgsSignature(initArgs);\n    const shouldOpenUrl = typeof navigateToUrl === 'string';\n\n    if (\n      this.agent &&\n      (shouldOpenUrl ||\n        shouldRebuildAgentForInitArgs(\n          this.lastInitArgsSignature,\n          nextSignature,\n        ))\n    ) {\n      try {\n        await this.agent?.destroy?.();\n      } catch {}\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    const { browser, reused } = await this.browserManager.getOrLaunch(\n      this.viewport,\n    );\n    this.browserManager.activeBrowser = browser;\n\n    const pages = await browser.pages();\n    let page: Page;\n\n    if (navigateToUrl) {\n      page = await browser.newPage();\n      if (this.viewport) {\n        await page.setViewport(this.viewport);\n      }\n      await page.goto(navigateToUrl, {\n        timeout: 30000,\n        waitUntil: 'domcontentloaded',\n      });\n    } else {\n      const savedTargetId = await this.browserManager.readSavedTargetId();\n      const matchedPage = savedTargetId\n        ? pages.find((candidate) => getTargetId(candidate) === savedTargetId)\n        : undefined;\n      const webPages = pages.filter((p) => /^https?:\\/\\//.test(p.url()));\n      page =\n        matchedPage ??\n        (webPages.length > 0\n          ? webPages[webPages.length - 1]\n          : pages[pages.length - 1] || (await browser.newPage()));\n\n      if (reused) {\n        await page.bringToFront();\n      }\n      if (this.viewport) {\n        await page.setViewport(this.viewport);\n      }\n    }\n\n    const targetId = getTargetId(page);\n    if (!targetId) {\n      throw new Error(\n        'Failed to persist Puppeteer page session because Puppeteer did not expose a Chrome targetId.',\n      );\n    }\n    await this.browserManager.saveTargetId(targetId);\n\n    const reportOptions = this.readCliReportAgentOptions();\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage, {\n      ...(extractAgentBehaviorInitArgs(initArgs) ?? {}),\n      ...(reportOptions ?? {}),\n    });\n    this.lastInitArgsSignature = nextSignature;\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    this.browserManager.disconnect();\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to a web page. Opens a new tab with the given URL, or reuses the current page.',\n        schema: this.getAgentInitArgSchema(),\n        cli: this.getAgentInitArgCliMetadata(),\n        handler: async (args) => {\n          const initArgs = this.extractAgentInitParam(args);\n          const url = initArgs?.url;\n\n          // Explicit connect always starts a fresh page session.\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n\n          const reportSession = this.createNewCliReportSession(\n            url ?? 'current-page',\n          );\n          this.commitCliReportSession(reportSession);\n          this.agent = await this.ensureAgent(initArgs);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current page';\n\n          return {\n            content: [\n              { type: 'text', text: `Connected to: ${label}` },\n              ...(screenshot ? this.buildScreenshotContent(screenshot) : []),\n            ],\n          };\n        },\n      },\n      {\n        name: 'web_disconnect',\n        description:\n          'Disconnect from current web page. The browser stays running for future calls.',\n        schema: {},\n        handler: async () => {\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n          this.browserManager.disconnect();\n          await this.browserManager.cleanupTargetIdFile();\n          return this.buildTextResult(\n            'Disconnected from web page (browser still running)',\n          );\n        },\n      },\n      {\n        name: 'web_close',\n        description: 'Close the browser completely and release all resources.',\n        schema: {},\n        handler: async () => {\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n          await this.browserManager.closeBrowser();\n          return this.buildTextResult('Browser closed');\n        },\n      },\n    ];\n  }\n}\n"],"names":["ENDPOINT_FILE","join","tmpdir","USER_DATA_DIR","TARGET_ID_FILE","DETACHED_CHROME_LAUNCH_TIMEOUT_MS","DETACHED_CHROME_ENDPOINT_POLL_INTERVAL_MS","debug","getDebug","PUPPETEER_ENDPOINT_FILE","buildDetachedChromeArgs","options","viewport","defaultPuppeteerWindowViewportSize","terminateDetachedChrome","proc","process","getTargetId","page","waitForDetachedChromeEndpoint","stderrFile","timeoutMs","Promise","resolve","reject","output","settled","exited","pollTimer","cleanup","clearTimeout","timeout","onExit","onError","resolveOnce","value","rejectOnce","error","terminate","code","signal","readFile","latestOutput","Error","pollForEndpoint","match","setTimeout","PuppeteerBrowserManager","content","targetId","writeFile","unlink","endpointFile","existsSync","endpoint","browser","puppeteer","wsEndpoint","chromePath","resolveChromePath","userDataDir","mkdir","args","stderrHandle","open","spawn","endpointPromise","undefined","persistence","defaultBrowserManager","WebPuppeteerMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","defaultStaticPageViewportSize","initArgs","navigateToUrl","nextSignature","getAgentInitArgsSignature","shouldOpenUrl","shouldRebuildAgentForInitArgs","reused","pages","savedTargetId","matchedPage","candidate","webPages","p","reportOptions","PuppeteerAgent","extractAgentBehaviorInitArgs","url","reportSession","screenshot","label","webAgentInitArgShape","adaptWebAgentInitArgs"],"mappings":"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"}

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

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

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

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

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.10.4-beta-20260710115744.0`, 'log');
+        this.onLogMessage(`Bridge connected, cli-side version v${this.bridgeClient.serverVersion}, browser-side version v1.10.4-beta-20260710135045.0`, 'log');
     }
     async connect() {
         return await this.setupBridgeClient();

package/dist/es/cli.mjs

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

package/dist/es/index.mjs

@@ -1,8 +1,8 @@
-import { PlaywrightAgent, PlaywrightAiFixture, PlaywrightBrowserAgent, PlaywrightPageAgent } from "./playwright/index.mjs";
+import { PlaywrightAgent, PlaywrightAiFixture } from "./playwright/index.mjs";
 import { Agent } from "@midscene/core/agent";
-import { PuppeteerAgent, PuppeteerBrowserAgent, PuppeteerPageAgent } from "./puppeteer/index.mjs";
+import { PuppeteerAgent } from "./puppeteer/index.mjs";
 import { StaticPage, StaticPageAgent } from "./static/index.mjs";
 import { WebMidsceneTools } from "./agent-tools.mjs";
 import { webPlaygroundPlatform } from "./platform.mjs";
 import { WebCdpMidsceneTools } from "./agent-tools-cdp.mjs";
-export { Agent as PageAgent, PlaywrightAgent, PlaywrightAiFixture, PlaywrightBrowserAgent, PlaywrightPageAgent, PuppeteerAgent, PuppeteerBrowserAgent, PuppeteerPageAgent, StaticPage, StaticPageAgent, WebCdpMidsceneTools, WebMidsceneTools, webPlaygroundPlatform };
+export { Agent as PageAgent, PlaywrightAgent, PlaywrightAiFixture, PuppeteerAgent, StaticPage, StaticPageAgent, WebCdpMidsceneTools, WebMidsceneTools, webPlaygroundPlatform };

package/dist/es/playwright/ai-fixture.mjs

@@ -1,5 +1,4 @@
-import { resolveBrowserAgentRuntimeOptions } from "../common/browser-agent.mjs";
-import { PlaywrightAgent, PlaywrightBrowserAgent } from "./index.mjs";
+import { PlaywrightAgent } from "./index.mjs";
 import { processCacheConfig } from "@midscene/core/utils";
 import { DEFAULT_WAIT_FOR_NAVIGATION_TIMEOUT, DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT } from "@midscene/shared/constants";
 import { getDebug } from "@midscene/shared/logger";
@@ -32,7 +31,7 @@ const groupAndCaseForTest = (testInfo)=>{
 const midsceneAgentKeyId = '_midsceneAgentId';
 const midsceneDumpAnnotationId = 'MIDSCENE_DUMP_ANNOTATION';
 const PlaywrightAiFixture = (options)=>{
-    const { forceSameTabNavigation = true, autoFollowNewPage = false, waitForNetworkIdleTimeout = DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT, waitForNavigationTimeout = DEFAULT_WAIT_FOR_NAVIGATION_TIMEOUT, cache, ...sharedAgentOptions } = options ?? {};
+    const { forceSameTabNavigation = true, waitForNetworkIdleTimeout = DEFAULT_WAIT_FOR_NETWORK_IDLE_TIMEOUT, waitForNavigationTimeout = DEFAULT_WAIT_FOR_NAVIGATION_TIMEOUT, cache, ...sharedAgentOptions } = options ?? {};
     const processTestCacheConfig = (testInfo)=>{
         const { id } = groupAndCaseForTest(testInfo);
         return processCacheConfig(cache, id);
@@ -71,29 +70,16 @@ const PlaywrightAiFixture = (options)=>{
             const { file, title } = groupAndCaseForTest(testInfo);
             const cacheConfig = processTestCacheConfig(testInfo);
             const reportTag = `playwright-${title.replace(/[\\/]/g, '-')}-${idForPage}`;
-            if (autoFollowNewPage && true === forceSameTabNavigation) throw new Error('[midscene] autoFollowNewPage cannot be used with forceSameTabNavigation: true.');
-            const runtimeOptions = resolveBrowserAgentRuntimeOptions({
-                agentName: 'PlaywrightAiFixture',
-                pageScope: autoFollowNewPage ? 'browser' : 'page',
-                forceSameTabNavigation: autoFollowNewPage ? void 0 : forceSameTabNavigation,
-                autoFollowNewPage
-            });
-            const commonAgentOpts = {
+            const agent = new PlaywrightAgent(page, {
                 testId: reportTag,
                 reportFileName: reportTag,
+                forceSameTabNavigation,
                 cache: cacheConfig,
                 groupName: title,
                 groupDescription: file,
                 generateReport: true,
                 ...sharedAgentOptions,
                 ...opts
-            };
-            const agent = autoFollowNewPage ? new PlaywrightBrowserAgent(page.context(), page, {
-                ...commonAgentOpts,
-                autoFollowNewPage: runtimeOptions.autoFollowNewPage
-            }) : new PlaywrightAgent(page, {
-                ...commonAgentOpts,
-                forceSameTabNavigation: runtimeOptions.forceSameTabNavigation
             });
             pageAgentMap[idForPage] = agent;
             const records = getAgentRecordsForTest(testInfo);