@midscene/web 1.7.5-beta-20260420032657.0 → 1.7.5-beta-20260420052829.0

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

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

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

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

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

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

package/dist/es/cli.mjs

@@ -40,7 +40,7 @@ tools = isBridge ? new WebMidsceneTools() : isCdp ? new WebCdpMidsceneTools(cdpE
 runToolsCLI(tools, 'midscene-web', {
     stripPrefix: 'web_',
     argv,
-    version: "1.7.5-beta-20260420032657.0",
+    version: "1.7.5-beta-20260420052829.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     if (!(e instanceof CLIError)) console.error(e);

package/dist/es/mcp-server.mjs

@@ -7,7 +7,7 @@ class WebMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/web-bridge-mcp',
-            version: "1.7.5-beta-20260420032657.0",
+            version: "1.7.5-beta-20260420052829.0",
             description: 'Control the browser using natural language commands'
         }, toolsManager);
     }

package/dist/es/mcp-tools-cdp.mjs

@@ -4,7 +4,7 @@ import node_http from "node:http";
 import { join } from "node:path";
 import { ScreenshotItem, z } from "@midscene/core";
 import { getDebug } from "@midscene/shared/logger";
-import { BaseMidsceneTools } from "@midscene/shared/mcp";
+import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import puppeteer_core from "puppeteer-core";
 import { PROXY_ENDPOINT_FILE, PROXY_PID_FILE, PROXY_UPSTREAM_FILE, TARGET_ID_FILE } from "./cdp-proxy-constants.mjs";
 import { PuppeteerAgent } from "./puppeteer/index.mjs";

package/dist/es/mcp-tools-cdp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools-cdp.mjs","sources":["../../src/mcp-tools-cdp.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';\nimport http from 'node:http';\nimport { join } from 'node:path';\nimport { ScreenshotItem, z } from '@midscene/core';\nimport { getDebug } from '@midscene/shared/logger';\nimport { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\nimport {\n  PROXY_ENDPOINT_FILE,\n  PROXY_PID_FILE,\n  PROXY_UPSTREAM_FILE,\n  TARGET_ID_FILE,\n} from './cdp-proxy-constants';\nimport { PuppeteerAgent } from './puppeteer';\nimport { StaticPage } from './static';\n\nconst debug = getDebug('mcp:cdp');\n\n/** CDP target discovery may need a brief moment after WebSocket open. */\nconst CDP_TARGET_DISCOVERY_DELAY_MS = 500;\n\n/**\n * Check if a CDP endpoint is a page-level URL (e.g., /devtools/page/XXX).\n */\nfunction isPageLevelEndpoint(endpoint: string): boolean {\n  return /\\/devtools\\/page\\//.test(endpoint);\n}\n\n/**\n * Try to resolve a page-level CDP endpoint to a browser-level endpoint\n * by fetching /json/version from the same host:port.\n */\nfunction resolveBrowserEndpoint(pageEndpoint: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let host: string;\n    try {\n      const url = new URL(pageEndpoint);\n      host = url.host; // host includes port (e.g. \"127.0.0.1:9222\")\n    } catch {\n      reject(new Error(`Invalid CDP endpoint URL: ${pageEndpoint}`));\n      return;\n    }\n\n    const req = http.get(\n      `http://${host}/json/version`,\n      { timeout: 5000 },\n      (res) => {\n        if (res.statusCode && res.statusCode >= 400) {\n          reject(new Error(`/json/version returned HTTP ${res.statusCode}`));\n          res.resume();\n          return;\n        }\n        let data = '';\n        res.on('data', (chunk: Buffer) => {\n          data += chunk.toString();\n        });\n        res.on('end', () => {\n          try {\n            const info = JSON.parse(data);\n            if (info.webSocketDebuggerUrl) {\n              resolve(info.webSocketDebuggerUrl);\n            } else {\n              reject(\n                new Error(\n                  'webSocketDebuggerUrl not found in /json/version response',\n                ),\n              );\n            }\n          } catch {\n            reject(\n              new Error(`Failed to parse /json/version response: ${data}`),\n            );\n          }\n        });\n      },\n    );\n    req.on('error', (err) =>\n      reject(new Error(`Failed to fetch /json/version: ${err.message}`)),\n    );\n    req.on('timeout', () => {\n      req.destroy();\n      reject(new Error('Timeout fetching /json/version'));\n    });\n  });\n}\n\n/**\n * Check if a previously spawned proxy process is still alive.\n */\nfunction isProxyAlive(): boolean {\n  if (!existsSync(PROXY_PID_FILE)) return false;\n  try {\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    process.kill(pid, 0); // signal 0 = existence check\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Read the proxy endpoint written by cdp-proxy.ts.\n */\nfunction readProxyEndpoint(): string | null {\n  if (!existsSync(PROXY_ENDPOINT_FILE)) return null;\n  try {\n    return readFileSync(PROXY_ENDPOINT_FILE, 'utf-8').trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Read the Chrome endpoint that the running proxy is connected to.\n */\nfunction readProxyUpstream(): string | null {\n  if (!existsSync(PROXY_UPSTREAM_FILE)) return null;\n  try {\n    return readFileSync(PROXY_UPSTREAM_FILE, 'utf-8').trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Kill the running proxy process and clear all CDP-mode metadata files\n * (proxy endpoint/pid/upstream and the cross-command targetId).\n */\nfunction killProxy(): void {\n  if (!existsSync(PROXY_PID_FILE)) return;\n  try {\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    process.kill(pid, 'SIGTERM');\n    debug('Killed proxy pid: %d', pid);\n  } catch (err) {\n    // ESRCH (already dead) is the common case; surface anything else\n    // (e.g. EPERM) via debug so it does not vanish silently.\n    debug('killProxy failed: %s', err);\n  }\n  try {\n    if (existsSync(PROXY_ENDPOINT_FILE)) unlinkSync(PROXY_ENDPOINT_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_PID_FILE)) unlinkSync(PROXY_PID_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_UPSTREAM_FILE)) unlinkSync(PROXY_UPSTREAM_FILE);\n  } catch {}\n  // The saved targetId points into the now-defunct upstream's tab list,\n  // so it cannot match anything in a fresh Chrome and must be discarded.\n  cleanupTargetIdFile();\n}\n\n/**\n * Read the saved targetId from the temporary file.\n */\nfunction readSavedTargetId(): string | null {\n  if (!existsSync(TARGET_ID_FILE)) return null;\n  try {\n    return readFileSync(TARGET_ID_FILE, 'utf-8').trim() || null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Save a targetId to the temporary file for cross-command tab reuse.\n */\nfunction saveTargetId(targetId: string): void {\n  try {\n    writeFileSync(TARGET_ID_FILE, targetId, 'utf-8');\n    debug('Saved targetId: %s', targetId);\n  } catch (err) {\n    debug('Failed to save targetId: %s', err);\n  }\n}\n\n/**\n * Remove the saved targetId file.\n */\nfunction cleanupTargetIdFile(): void {\n  try {\n    if (existsSync(TARGET_ID_FILE)) unlinkSync(TARGET_ID_FILE);\n  } catch {}\n}\n\n/**\n * puppeteer-core does not expose a public method for the underlying\n * CDP target id, so we reach into `_targetId`. Centralised here so that\n * a future puppeteer release exposing this properly only requires one\n * change. Callers must treat the result as optional.\n */\nfunction getTargetId(page: Page): string | undefined {\n  return (page.target() as unknown as { _targetId?: string })._targetId;\n}\n\n/** Keep at most this many bytes of proxy stderr for diagnostics. */\nconst PROXY_STDERR_BUFFER_LIMIT = 8 * 1024;\n\n/**\n * Spawn the CDP proxy process and wait for it to print the endpoint.\n *\n * Captures the child's stderr so that when startup fails we can surface\n * the real reason (upstream closed / duplicate proxy / upstream error)\n * instead of the generic \"exited before ready\".\n */\nfunction spawnProxy(chromeEndpoint: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const proxyScript = join(__dirname, 'cdp-proxy.js');\n    const proc = spawn(process.execPath, [proxyScript, chromeEndpoint], {\n      detached: true,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n    proc.unref();\n\n    let output = '';\n    let stderrBuf = '';\n    let settled = false;\n\n    const appendStderr = (chunk: Buffer) => {\n      stderrBuf += chunk.toString();\n      if (stderrBuf.length > PROXY_STDERR_BUFFER_LIMIT) {\n        stderrBuf = stderrBuf.slice(-PROXY_STDERR_BUFFER_LIMIT);\n      }\n    };\n    proc.stderr!.on('data', appendStderr);\n\n    const formatStderr = () => {\n      const trimmed = stderrBuf.trim();\n      return trimmed ? ` (stderr: ${trimmed})` : '';\n    };\n\n    const timer = setTimeout(() => {\n      if (!settled) {\n        settled = true;\n        reject(new Error(`Proxy startup timeout (10s)${formatStderr()}`));\n      }\n    }, 10000);\n\n    const onData = (chunk: Buffer) => {\n      output += chunk.toString();\n      const lines = output.split('\\n');\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        try {\n          const parsed = JSON.parse(line);\n          if (parsed.endpoint && !settled) {\n            settled = true;\n            clearTimeout(timer);\n            proc.stdout!.removeListener('data', onData);\n            proc.stderr!.removeListener('data', appendStderr);\n            // Destroy the stdio pipes so they don't keep the parent\n            // process event loop alive after we've read the endpoint.\n            proc.stdout!.destroy();\n            proc.stderr!.destroy();\n            resolve(parsed.endpoint);\n            return;\n          }\n        } catch {\n          // stdout may contain non-JSON lines during startup — skip them\n        }\n      }\n    };\n    proc.stdout!.on('data', onData);\n\n    proc.on('error', (err) => {\n      if (!settled) {\n        settled = true;\n        clearTimeout(timer);\n        reject(new Error(`Failed to spawn proxy: ${err.message}`));\n      }\n    });\n    proc.on('exit', (code, signal) => {\n      if (!settled) {\n        settled = true;\n        clearTimeout(timer);\n        const how = signal ? `signal ${signal}` : `code ${code}`;\n        reject(\n          new Error(`Proxy exited with ${how} before ready${formatStderr()}`),\n        );\n      }\n    });\n  });\n}\n\n/**\n * Get the proxy endpoint, spawning the proxy if needed.\n * Falls back to direct connection if proxy cannot be started.\n *\n * If the user provides a page-level CDP URL, automatically resolves it\n * to a browser-level endpoint via /json/version.\n */\nasync function getProxyEndpoint(chromeEndpoint: string): Promise<string> {\n  // If the user passed a page-level endpoint, resolve to browser-level first\n  let browserEndpoint = chromeEndpoint;\n  if (isPageLevelEndpoint(chromeEndpoint)) {\n    debug(\n      'Page-level CDP endpoint detected, resolving via /json/version: %s',\n      chromeEndpoint,\n    );\n    try {\n      browserEndpoint = await resolveBrowserEndpoint(chromeEndpoint);\n      debug('Resolved browser endpoint: %s', browserEndpoint);\n    } catch (err) {\n      throw new Error(\n        `Cannot use page-level CDP endpoint directly. Puppeteer requires a browser-level endpoint (e.g., ws://host:port/devtools/browser/<id>). Auto-resolution via /json/version failed: ${(err as Error).message}. Please provide a browser-level CDP endpoint instead.`,\n      );\n    }\n  }\n\n  // If proxy is alive and connected to the same Chrome, reuse it\n  if (isProxyAlive()) {\n    const endpoint = readProxyEndpoint();\n    const savedUpstream = readProxyUpstream();\n    if (endpoint) {\n      if (savedUpstream && savedUpstream !== browserEndpoint) {\n        // Proxy is connected to a different Chrome — kill it and start fresh\n        debug(\n          'Proxy connected to different upstream (%s), killing',\n          savedUpstream,\n        );\n        killProxy();\n      } else {\n        return endpoint;\n      }\n    }\n  }\n\n  // Spawn a new proxy\n  try {\n    return await spawnProxy(browserEndpoint);\n  } catch (err) {\n    console.warn(\n      `[cdp] proxy failed, falling back to direct connection: ${err}`,\n    );\n    return browserEndpoint;\n  }\n}\n\n/**\n * Tools manager for Web CDP-mode MCP.\n * Connects to an existing Chrome browser via CDP (Chrome DevTools Protocol) endpoint.\n * Unlike WebPuppeteerMidsceneTools which launches its own Chrome, this connects\n * to a browser that is already running with remote debugging enabled.\n *\n * Uses a persistent WebSocket proxy to avoid repeated Chrome permission popups\n * when Chrome's settings-based remote debugging is used.\n */\nexport class WebCdpMidsceneTools extends BaseMidsceneTools<PuppeteerAgent> {\n  private cdpEndpoint: string;\n  private activeBrowser: Browser | null = null;\n\n  constructor(cdpEndpoint: string) {\n    super();\n    this.cdpEndpoint = cdpEndpoint;\n  }\n\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(navigateToUrl?: string): Promise<PuppeteerAgent> {\n    // Re-init if URL provided\n    if (this.agent && navigateToUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect via proxy to avoid repeated Chrome permission popups\n    if (!this.activeBrowser) {\n      const endpoint = await getProxyEndpoint(this.cdpEndpoint);\n      this.activeBrowser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n        defaultViewport: null,\n      });\n    }\n\n    const browser = this.activeBrowser;\n    let pages = await browser.pages();\n\n    // If no pages discovered, wait briefly and retry — some CDP targets\n    // need a moment to appear after the WebSocket connection is established.\n    if (pages.length === 0) {\n      await new Promise((r) => setTimeout(r, CDP_TARGET_DISCOVERY_DELAY_MS));\n      pages = await browser.pages();\n    }\n\n    const webPages = pages.filter((p) => /^https?:\\/\\//.test(p.url()));\n    debug(\n      'Found %d page(s), %d web page(s): %o',\n      pages.length,\n      webPages.length,\n      pages.map((p) => p.url()),\n    );\n    let page: Page;\n\n    if (navigateToUrl) {\n      if (webPages.length > 0) {\n        // Reuse an existing page and navigate it — avoids creating invisible\n        // tabs when Chrome uses settings-based remote debugging (no HTTP\n        // discovery endpoints, /devtools/page/* returns 403).\n        page = webPages[webPages.length - 1];\n        await page.bringToFront();\n        await page.goto(navigateToUrl, {\n          timeout: 30000,\n          waitUntil: 'domcontentloaded',\n        });\n      } else {\n        // No existing web pages — fall back to creating a new tab\n        page = await browser.newPage();\n        await page.goto(navigateToUrl, {\n          timeout: 30000,\n          waitUntil: 'domcontentloaded',\n        });\n      }\n    } else {\n      // Try to find the exact tab from a previous `connect` command via saved targetId.\n      const savedTargetId = readSavedTargetId();\n      let matchedPage: Page | undefined;\n\n      if (savedTargetId && pages.length > 0) {\n        matchedPage = pages.find((p) => getTargetId(p) === savedTargetId);\n        if (matchedPage) {\n          debug('Matched saved targetId %s', savedTargetId);\n        } else {\n          debug(\n            'Saved targetId %s not found among %d pages, falling back',\n            savedTargetId,\n            pages.length,\n          );\n        }\n      }\n\n      if (matchedPage) {\n        page = matchedPage;\n      } else if (webPages.length > 0) {\n        page = webPages[webPages.length - 1];\n      } else if (pages.length > 0) {\n        page = pages[pages.length - 1];\n      } else {\n        page = await browser.newPage();\n      }\n\n      await page.bringToFront();\n    }\n\n    // Persist the targetId so subsequent CLI commands can find this exact tab\n    const targetId = getTargetId(page);\n    if (targetId) {\n      saveTargetId(targetId);\n    } else {\n      // If puppeteer ever drops the private _targetId field, this branch\n      // makes the regression visible instead of silently disabling the\n      // cross-command tab reuse path.\n      debug(\n        'No targetId on page.target(); cross-command tab reuse disabled until puppeteer integration is updated.',\n      );\n    }\n\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage);\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    if (this.activeBrowser) {\n      this.activeBrowser.disconnect();\n      this.activeBrowser = null;\n    }\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to a web page via CDP. Opens a new tab with the given URL, or reuses the current page.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to use current page)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Destroy existing agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during connect:', e);\n            }\n            this.agent = undefined;\n          }\n\n          this.agent = await this.ensureAgent(url);\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 via CDP 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 (managed externally).',\n        schema: {},\n        handler: async () => {\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during disconnect:', e);\n            }\n            this.agent = undefined;\n          }\n          if (this.activeBrowser) {\n            this.activeBrowser.disconnect();\n            this.activeBrowser = null;\n          }\n          cleanupTargetIdFile();\n          return this.buildTextResult(\n            'Disconnected from web page (browser still running externally)',\n          );\n        },\n      },\n    ];\n  }\n}\n\n/**\n * Internal helpers exposed for unit tests. Not part of the public API.\n */\nexport const __test__ = {\n  getProxyEndpoint,\n  killProxy,\n  readProxyUpstream,\n  isProxyAlive,\n};\n"],"names":["debug","getDebug","CDP_TARGET_DISCOVERY_DELAY_MS","isPageLevelEndpoint","endpoint","resolveBrowserEndpoint","pageEndpoint","Promise","resolve","reject","host","url","URL","Error","req","http","res","data","chunk","info","JSON","err","isProxyAlive","existsSync","PROXY_PID_FILE","pid","Number","readFileSync","process","readProxyEndpoint","PROXY_ENDPOINT_FILE","readProxyUpstream","PROXY_UPSTREAM_FILE","killProxy","unlinkSync","cleanupTargetIdFile","readSavedTargetId","TARGET_ID_FILE","saveTargetId","targetId","writeFileSync","getTargetId","page","PROXY_STDERR_BUFFER_LIMIT","spawnProxy","chromeEndpoint","proxyScript","join","__dirname","proc","spawn","output","stderrBuf","settled","appendStderr","formatStderr","trimmed","timer","setTimeout","onData","lines","line","parsed","clearTimeout","code","signal","how","getProxyEndpoint","browserEndpoint","savedUpstream","console","WebCdpMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","navigateToUrl","error","undefined","puppeteer","browser","pages","r","webPages","p","savedTargetId","matchedPage","PuppeteerAgent","z","args","e","screenshot","label","cdpEndpoint","__test__"],"mappings":"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"}
+{"version":3,"file":"mcp-tools-cdp.mjs","sources":["../../src/mcp-tools-cdp.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';\nimport http from 'node:http';\nimport { join } from 'node:path';\nimport { ScreenshotItem, z } from '@midscene/core';\nimport { getDebug } from '@midscene/shared/logger';\nimport { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\nimport {\n  PROXY_ENDPOINT_FILE,\n  PROXY_PID_FILE,\n  PROXY_UPSTREAM_FILE,\n  TARGET_ID_FILE,\n} from './cdp-proxy-constants';\nimport { PuppeteerAgent } from './puppeteer';\nimport { StaticPage } from './static';\n\nconst debug = getDebug('mcp:cdp');\n\n/** CDP target discovery may need a brief moment after WebSocket open. */\nconst CDP_TARGET_DISCOVERY_DELAY_MS = 500;\n\n/**\n * Check if a CDP endpoint is a page-level URL (e.g., /devtools/page/XXX).\n */\nfunction isPageLevelEndpoint(endpoint: string): boolean {\n  return /\\/devtools\\/page\\//.test(endpoint);\n}\n\n/**\n * Try to resolve a page-level CDP endpoint to a browser-level endpoint\n * by fetching /json/version from the same host:port.\n */\nfunction resolveBrowserEndpoint(pageEndpoint: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let host: string;\n    try {\n      const url = new URL(pageEndpoint);\n      host = url.host; // host includes port (e.g. \"127.0.0.1:9222\")\n    } catch {\n      reject(new Error(`Invalid CDP endpoint URL: ${pageEndpoint}`));\n      return;\n    }\n\n    const req = http.get(\n      `http://${host}/json/version`,\n      { timeout: 5000 },\n      (res) => {\n        if (res.statusCode && res.statusCode >= 400) {\n          reject(new Error(`/json/version returned HTTP ${res.statusCode}`));\n          res.resume();\n          return;\n        }\n        let data = '';\n        res.on('data', (chunk: Buffer) => {\n          data += chunk.toString();\n        });\n        res.on('end', () => {\n          try {\n            const info = JSON.parse(data);\n            if (info.webSocketDebuggerUrl) {\n              resolve(info.webSocketDebuggerUrl);\n            } else {\n              reject(\n                new Error(\n                  'webSocketDebuggerUrl not found in /json/version response',\n                ),\n              );\n            }\n          } catch {\n            reject(\n              new Error(`Failed to parse /json/version response: ${data}`),\n            );\n          }\n        });\n      },\n    );\n    req.on('error', (err) =>\n      reject(new Error(`Failed to fetch /json/version: ${err.message}`)),\n    );\n    req.on('timeout', () => {\n      req.destroy();\n      reject(new Error('Timeout fetching /json/version'));\n    });\n  });\n}\n\n/**\n * Check if a previously spawned proxy process is still alive.\n */\nfunction isProxyAlive(): boolean {\n  if (!existsSync(PROXY_PID_FILE)) return false;\n  try {\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    process.kill(pid, 0); // signal 0 = existence check\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Read the proxy endpoint written by cdp-proxy.ts.\n */\nfunction readProxyEndpoint(): string | null {\n  if (!existsSync(PROXY_ENDPOINT_FILE)) return null;\n  try {\n    return readFileSync(PROXY_ENDPOINT_FILE, 'utf-8').trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Read the Chrome endpoint that the running proxy is connected to.\n */\nfunction readProxyUpstream(): string | null {\n  if (!existsSync(PROXY_UPSTREAM_FILE)) return null;\n  try {\n    return readFileSync(PROXY_UPSTREAM_FILE, 'utf-8').trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Kill the running proxy process and clear all CDP-mode metadata files\n * (proxy endpoint/pid/upstream and the cross-command targetId).\n */\nfunction killProxy(): void {\n  if (!existsSync(PROXY_PID_FILE)) return;\n  try {\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    process.kill(pid, 'SIGTERM');\n    debug('Killed proxy pid: %d', pid);\n  } catch (err) {\n    // ESRCH (already dead) is the common case; surface anything else\n    // (e.g. EPERM) via debug so it does not vanish silently.\n    debug('killProxy failed: %s', err);\n  }\n  try {\n    if (existsSync(PROXY_ENDPOINT_FILE)) unlinkSync(PROXY_ENDPOINT_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_PID_FILE)) unlinkSync(PROXY_PID_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_UPSTREAM_FILE)) unlinkSync(PROXY_UPSTREAM_FILE);\n  } catch {}\n  // The saved targetId points into the now-defunct upstream's tab list,\n  // so it cannot match anything in a fresh Chrome and must be discarded.\n  cleanupTargetIdFile();\n}\n\n/**\n * Read the saved targetId from the temporary file.\n */\nfunction readSavedTargetId(): string | null {\n  if (!existsSync(TARGET_ID_FILE)) return null;\n  try {\n    return readFileSync(TARGET_ID_FILE, 'utf-8').trim() || null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Save a targetId to the temporary file for cross-command tab reuse.\n */\nfunction saveTargetId(targetId: string): void {\n  try {\n    writeFileSync(TARGET_ID_FILE, targetId, 'utf-8');\n    debug('Saved targetId: %s', targetId);\n  } catch (err) {\n    debug('Failed to save targetId: %s', err);\n  }\n}\n\n/**\n * Remove the saved targetId file.\n */\nfunction cleanupTargetIdFile(): void {\n  try {\n    if (existsSync(TARGET_ID_FILE)) unlinkSync(TARGET_ID_FILE);\n  } catch {}\n}\n\n/**\n * puppeteer-core does not expose a public method for the underlying\n * CDP target id, so we reach into `_targetId`. Centralised here so that\n * a future puppeteer release exposing this properly only requires one\n * change. Callers must treat the result as optional.\n */\nfunction getTargetId(page: Page): string | undefined {\n  return (page.target() as unknown as { _targetId?: string })._targetId;\n}\n\n/** Keep at most this many bytes of proxy stderr for diagnostics. */\nconst PROXY_STDERR_BUFFER_LIMIT = 8 * 1024;\n\n/**\n * Spawn the CDP proxy process and wait for it to print the endpoint.\n *\n * Captures the child's stderr so that when startup fails we can surface\n * the real reason (upstream closed / duplicate proxy / upstream error)\n * instead of the generic \"exited before ready\".\n */\nfunction spawnProxy(chromeEndpoint: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const proxyScript = join(__dirname, 'cdp-proxy.js');\n    const proc = spawn(process.execPath, [proxyScript, chromeEndpoint], {\n      detached: true,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n    proc.unref();\n\n    let output = '';\n    let stderrBuf = '';\n    let settled = false;\n\n    const appendStderr = (chunk: Buffer) => {\n      stderrBuf += chunk.toString();\n      if (stderrBuf.length > PROXY_STDERR_BUFFER_LIMIT) {\n        stderrBuf = stderrBuf.slice(-PROXY_STDERR_BUFFER_LIMIT);\n      }\n    };\n    proc.stderr!.on('data', appendStderr);\n\n    const formatStderr = () => {\n      const trimmed = stderrBuf.trim();\n      return trimmed ? ` (stderr: ${trimmed})` : '';\n    };\n\n    const timer = setTimeout(() => {\n      if (!settled) {\n        settled = true;\n        reject(new Error(`Proxy startup timeout (10s)${formatStderr()}`));\n      }\n    }, 10000);\n\n    const onData = (chunk: Buffer) => {\n      output += chunk.toString();\n      const lines = output.split('\\n');\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        try {\n          const parsed = JSON.parse(line);\n          if (parsed.endpoint && !settled) {\n            settled = true;\n            clearTimeout(timer);\n            proc.stdout!.removeListener('data', onData);\n            proc.stderr!.removeListener('data', appendStderr);\n            // Destroy the stdio pipes so they don't keep the parent\n            // process event loop alive after we've read the endpoint.\n            proc.stdout!.destroy();\n            proc.stderr!.destroy();\n            resolve(parsed.endpoint);\n            return;\n          }\n        } catch {\n          // stdout may contain non-JSON lines during startup — skip them\n        }\n      }\n    };\n    proc.stdout!.on('data', onData);\n\n    proc.on('error', (err) => {\n      if (!settled) {\n        settled = true;\n        clearTimeout(timer);\n        reject(new Error(`Failed to spawn proxy: ${err.message}`));\n      }\n    });\n    proc.on('exit', (code, signal) => {\n      if (!settled) {\n        settled = true;\n        clearTimeout(timer);\n        const how = signal ? `signal ${signal}` : `code ${code}`;\n        reject(\n          new Error(`Proxy exited with ${how} before ready${formatStderr()}`),\n        );\n      }\n    });\n  });\n}\n\n/**\n * Get the proxy endpoint, spawning the proxy if needed.\n * Falls back to direct connection if proxy cannot be started.\n *\n * If the user provides a page-level CDP URL, automatically resolves it\n * to a browser-level endpoint via /json/version.\n */\nasync function getProxyEndpoint(chromeEndpoint: string): Promise<string> {\n  // If the user passed a page-level endpoint, resolve to browser-level first\n  let browserEndpoint = chromeEndpoint;\n  if (isPageLevelEndpoint(chromeEndpoint)) {\n    debug(\n      'Page-level CDP endpoint detected, resolving via /json/version: %s',\n      chromeEndpoint,\n    );\n    try {\n      browserEndpoint = await resolveBrowserEndpoint(chromeEndpoint);\n      debug('Resolved browser endpoint: %s', browserEndpoint);\n    } catch (err) {\n      throw new Error(\n        `Cannot use page-level CDP endpoint directly. Puppeteer requires a browser-level endpoint (e.g., ws://host:port/devtools/browser/<id>). Auto-resolution via /json/version failed: ${(err as Error).message}. Please provide a browser-level CDP endpoint instead.`,\n      );\n    }\n  }\n\n  // If proxy is alive and connected to the same Chrome, reuse it\n  if (isProxyAlive()) {\n    const endpoint = readProxyEndpoint();\n    const savedUpstream = readProxyUpstream();\n    if (endpoint) {\n      if (savedUpstream && savedUpstream !== browserEndpoint) {\n        // Proxy is connected to a different Chrome — kill it and start fresh\n        debug(\n          'Proxy connected to different upstream (%s), killing',\n          savedUpstream,\n        );\n        killProxy();\n      } else {\n        return endpoint;\n      }\n    }\n  }\n\n  // Spawn a new proxy\n  try {\n    return await spawnProxy(browserEndpoint);\n  } catch (err) {\n    console.warn(\n      `[cdp] proxy failed, falling back to direct connection: ${err}`,\n    );\n    return browserEndpoint;\n  }\n}\n\n/**\n * Tools manager for Web CDP-mode MCP.\n * Connects to an existing Chrome browser via CDP (Chrome DevTools Protocol) endpoint.\n * Unlike WebPuppeteerMidsceneTools which launches its own Chrome, this connects\n * to a browser that is already running with remote debugging enabled.\n *\n * Uses a persistent WebSocket proxy to avoid repeated Chrome permission popups\n * when Chrome's settings-based remote debugging is used.\n */\nexport class WebCdpMidsceneTools extends BaseMidsceneTools<PuppeteerAgent> {\n  private cdpEndpoint: string;\n  private activeBrowser: Browser | null = null;\n\n  constructor(cdpEndpoint: string) {\n    super();\n    this.cdpEndpoint = cdpEndpoint;\n  }\n\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(navigateToUrl?: string): Promise<PuppeteerAgent> {\n    // Re-init if URL provided\n    if (this.agent && navigateToUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect via proxy to avoid repeated Chrome permission popups\n    if (!this.activeBrowser) {\n      const endpoint = await getProxyEndpoint(this.cdpEndpoint);\n      this.activeBrowser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n        defaultViewport: null,\n      });\n    }\n\n    const browser = this.activeBrowser;\n    let pages = await browser.pages();\n\n    // If no pages discovered, wait briefly and retry — some CDP targets\n    // need a moment to appear after the WebSocket connection is established.\n    if (pages.length === 0) {\n      await new Promise((r) => setTimeout(r, CDP_TARGET_DISCOVERY_DELAY_MS));\n      pages = await browser.pages();\n    }\n\n    const webPages = pages.filter((p) => /^https?:\\/\\//.test(p.url()));\n    debug(\n      'Found %d page(s), %d web page(s): %o',\n      pages.length,\n      webPages.length,\n      pages.map((p) => p.url()),\n    );\n    let page: Page;\n\n    if (navigateToUrl) {\n      if (webPages.length > 0) {\n        // Reuse an existing page and navigate it — avoids creating invisible\n        // tabs when Chrome uses settings-based remote debugging (no HTTP\n        // discovery endpoints, /devtools/page/* returns 403).\n        page = webPages[webPages.length - 1];\n        await page.bringToFront();\n        await page.goto(navigateToUrl, {\n          timeout: 30000,\n          waitUntil: 'domcontentloaded',\n        });\n      } else {\n        // No existing web pages — fall back to creating a new tab\n        page = await browser.newPage();\n        await page.goto(navigateToUrl, {\n          timeout: 30000,\n          waitUntil: 'domcontentloaded',\n        });\n      }\n    } else {\n      // Try to find the exact tab from a previous `connect` command via saved targetId.\n      const savedTargetId = readSavedTargetId();\n      let matchedPage: Page | undefined;\n\n      if (savedTargetId && pages.length > 0) {\n        matchedPage = pages.find((p) => getTargetId(p) === savedTargetId);\n        if (matchedPage) {\n          debug('Matched saved targetId %s', savedTargetId);\n        } else {\n          debug(\n            'Saved targetId %s not found among %d pages, falling back',\n            savedTargetId,\n            pages.length,\n          );\n        }\n      }\n\n      if (matchedPage) {\n        page = matchedPage;\n      } else if (webPages.length > 0) {\n        page = webPages[webPages.length - 1];\n      } else if (pages.length > 0) {\n        page = pages[pages.length - 1];\n      } else {\n        page = await browser.newPage();\n      }\n\n      await page.bringToFront();\n    }\n\n    // Persist the targetId so subsequent CLI commands can find this exact tab\n    const targetId = getTargetId(page);\n    if (targetId) {\n      saveTargetId(targetId);\n    } else {\n      // If puppeteer ever drops the private _targetId field, this branch\n      // makes the regression visible instead of silently disabling the\n      // cross-command tab reuse path.\n      debug(\n        'No targetId on page.target(); cross-command tab reuse disabled until puppeteer integration is updated.',\n      );\n    }\n\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage);\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    if (this.activeBrowser) {\n      this.activeBrowser.disconnect();\n      this.activeBrowser = null;\n    }\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to a web page via CDP. Opens a new tab with the given URL, or reuses the current page.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to use current page)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Destroy existing agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during connect:', e);\n            }\n            this.agent = undefined;\n          }\n\n          this.agent = await this.ensureAgent(url);\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 via CDP 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 (managed externally).',\n        schema: {},\n        handler: async () => {\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during disconnect:', e);\n            }\n            this.agent = undefined;\n          }\n          if (this.activeBrowser) {\n            this.activeBrowser.disconnect();\n            this.activeBrowser = null;\n          }\n          cleanupTargetIdFile();\n          return this.buildTextResult(\n            'Disconnected from web page (browser still running externally)',\n          );\n        },\n      },\n    ];\n  }\n}\n\n/**\n * Internal helpers exposed for unit tests. Not part of the public API.\n */\nexport const __test__ = {\n  getProxyEndpoint,\n  killProxy,\n  readProxyUpstream,\n  isProxyAlive,\n};\n"],"names":["debug","getDebug","CDP_TARGET_DISCOVERY_DELAY_MS","isPageLevelEndpoint","endpoint","resolveBrowserEndpoint","pageEndpoint","Promise","resolve","reject","host","url","URL","Error","req","http","res","data","chunk","info","JSON","err","isProxyAlive","existsSync","PROXY_PID_FILE","pid","Number","readFileSync","process","readProxyEndpoint","PROXY_ENDPOINT_FILE","readProxyUpstream","PROXY_UPSTREAM_FILE","killProxy","unlinkSync","cleanupTargetIdFile","readSavedTargetId","TARGET_ID_FILE","saveTargetId","targetId","writeFileSync","getTargetId","page","PROXY_STDERR_BUFFER_LIMIT","spawnProxy","chromeEndpoint","proxyScript","join","__dirname","proc","spawn","output","stderrBuf","settled","appendStderr","formatStderr","trimmed","timer","setTimeout","onData","lines","line","parsed","clearTimeout","code","signal","how","getProxyEndpoint","browserEndpoint","savedUpstream","console","WebCdpMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","navigateToUrl","error","undefined","puppeteer","browser","pages","r","webPages","p","savedTargetId","matchedPage","PuppeteerAgent","z","args","e","screenshot","label","cdpEndpoint","__test__"],"mappings":"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"}

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

@@ -4,7 +4,8 @@ import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { ScreenshotItem, z } from "@midscene/core";
-import { BaseMidsceneTools, resolveChromePath } from "@midscene/shared/mcp";
+import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
+import { resolveChromePath } from "@midscene/shared/mcp/chrome-path";
 import puppeteer_core from "puppeteer-core";
 import { PuppeteerAgent } from "./puppeteer/index.mjs";
 import { StaticPage } from "./static/index.mjs";

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools-puppeteer.mjs","sources":["../../src/mcp-tools-puppeteer.ts"],"sourcesContent":["import { 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, z } from '@midscene/core';\nimport {\n  BaseMidsceneTools,\n  type ToolDefinition,\n  resolveChromePath,\n} from '@midscene/shared/mcp';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\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');\n\n/**\n * Persistent Puppeteer browser manager.\n * Launches a detached Chrome and persists the WS endpoint across CLI calls.\n */\nconst browserManager = {\n  activeBrowser: null as Browser | null,\n\n  async getOrLaunch(): Promise<{ browser: Browser; reused: boolean }> {\n    if (existsSync(ENDPOINT_FILE)) {\n      try {\n        const endpoint = (await readFile(ENDPOINT_FILE, '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(ENDPOINT_FILE);\n        } catch {}\n      }\n    }\n\n    const wsEndpoint = await this.launchDetachedChrome();\n    await writeFile(ENDPOINT_FILE, 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    if (!existsSync(ENDPOINT_FILE)) return;\n    try {\n      const endpoint = (await readFile(ENDPOINT_FILE, 'utf-8')).trim();\n      const browser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n      });\n      await browser.close();\n    } catch {}\n    try {\n      await unlink(ENDPOINT_FILE);\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(): Promise<string> {\n    const chromePath = resolveChromePath();\n\n    await mkdir(USER_DATA_DIR, { recursive: true });\n\n    const args = [\n      '--headless=new',\n      `--user-data-dir=${USER_DATA_DIR}`,\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=1280,800',\n      '--force-color-profile=srgb',\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      const onData = (data: Buffer) => {\n        output += data.toString();\n        const match = output.match(/DevTools listening on (ws:\\/\\/[^\\s]+)/);\n        if (match) {\n          proc.stderr!.removeListener('data', onData);\n          resolve(match[1]);\n        }\n      };\n      proc.stderr!.on('data', onData);\n\n      proc.on('exit', (code) => {\n        proc.stderr!.removeListener('data', onData);\n        reject(\n          new Error(\n            `Chrome exited with code ${code} before DevTools was ready.\\nChrome stderr: ${output}\\nTip: try setting MIDSCENE_MCP_NO_SANDBOX=1 if running in a container.`,\n          ),\n        );\n      });\n\n      setTimeout(\n        () =>\n          reject(\n            new Error(\n              `Chrome launch timeout.\\nChrome stderr: ${output}\\nTip: try setting MIDSCENE_MCP_NO_SANDBOX=1 if running in a container.`,\n            ),\n          ),\n        15000,\n      );\n    });\n  },\n};\n\n/**\n * Tools manager for Web Puppeteer-mode MCP.\n * Uses a persistent headless Chrome browser that survives across CLI calls.\n */\nexport class WebPuppeteerMidsceneTools extends BaseMidsceneTools<PuppeteerAgent> {\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(navigateToUrl?: string): Promise<PuppeteerAgent> {\n    // Re-init if URL provided\n    if (this.agent && navigateToUrl) {\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 browserManager.getOrLaunch();\n    browserManager.activeBrowser = browser;\n\n    const pages = await browser.pages();\n    let page: Page;\n\n    if (navigateToUrl) {\n      page = await browser.newPage();\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    }\n\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage);\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    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: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to use current page)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Destroy existing agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n\n          this.agent = await this.ensureAgent(url);\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          }\n          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          }\n          await browserManager.closeBrowser();\n          return this.buildTextResult('Browser closed');\n        },\n      },\n    ];\n  }\n}\n"],"names":["ENDPOINT_FILE","join","tmpdir","USER_DATA_DIR","browserManager","existsSync","endpoint","readFile","browser","puppeteer","unlink","wsEndpoint","writeFile","chromePath","resolveChromePath","mkdir","args","proc","spawn","Promise","resolve","reject","output","onData","data","match","code","Error","setTimeout","WebPuppeteerMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","navigateToUrl","undefined","reused","pages","page","webPages","p","PuppeteerAgent","z","url","screenshot","label"],"mappings":"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"}
+{"version":3,"file":"mcp-tools-puppeteer.mjs","sources":["../../src/mcp-tools-puppeteer.ts"],"sourcesContent":["import { 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, z } from '@midscene/core';\nimport { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';\nimport { resolveChromePath } from '@midscene/shared/mcp/chrome-path';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\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');\n\n/**\n * Persistent Puppeteer browser manager.\n * Launches a detached Chrome and persists the WS endpoint across CLI calls.\n */\nconst browserManager = {\n  activeBrowser: null as Browser | null,\n\n  async getOrLaunch(): Promise<{ browser: Browser; reused: boolean }> {\n    if (existsSync(ENDPOINT_FILE)) {\n      try {\n        const endpoint = (await readFile(ENDPOINT_FILE, '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(ENDPOINT_FILE);\n        } catch {}\n      }\n    }\n\n    const wsEndpoint = await this.launchDetachedChrome();\n    await writeFile(ENDPOINT_FILE, 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    if (!existsSync(ENDPOINT_FILE)) return;\n    try {\n      const endpoint = (await readFile(ENDPOINT_FILE, 'utf-8')).trim();\n      const browser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n      });\n      await browser.close();\n    } catch {}\n    try {\n      await unlink(ENDPOINT_FILE);\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(): Promise<string> {\n    const chromePath = resolveChromePath();\n\n    await mkdir(USER_DATA_DIR, { recursive: true });\n\n    const args = [\n      '--headless=new',\n      `--user-data-dir=${USER_DATA_DIR}`,\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=1280,800',\n      '--force-color-profile=srgb',\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      const onData = (data: Buffer) => {\n        output += data.toString();\n        const match = output.match(/DevTools listening on (ws:\\/\\/[^\\s]+)/);\n        if (match) {\n          proc.stderr!.removeListener('data', onData);\n          resolve(match[1]);\n        }\n      };\n      proc.stderr!.on('data', onData);\n\n      proc.on('exit', (code) => {\n        proc.stderr!.removeListener('data', onData);\n        reject(\n          new Error(\n            `Chrome exited with code ${code} before DevTools was ready.\\nChrome stderr: ${output}\\nTip: try setting MIDSCENE_MCP_NO_SANDBOX=1 if running in a container.`,\n          ),\n        );\n      });\n\n      setTimeout(\n        () =>\n          reject(\n            new Error(\n              `Chrome launch timeout.\\nChrome stderr: ${output}\\nTip: try setting MIDSCENE_MCP_NO_SANDBOX=1 if running in a container.`,\n            ),\n          ),\n        15000,\n      );\n    });\n  },\n};\n\n/**\n * Tools manager for Web Puppeteer-mode MCP.\n * Uses a persistent headless Chrome browser that survives across CLI calls.\n */\nexport class WebPuppeteerMidsceneTools extends BaseMidsceneTools<PuppeteerAgent> {\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(navigateToUrl?: string): Promise<PuppeteerAgent> {\n    // Re-init if URL provided\n    if (this.agent && navigateToUrl) {\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 browserManager.getOrLaunch();\n    browserManager.activeBrowser = browser;\n\n    const pages = await browser.pages();\n    let page: Page;\n\n    if (navigateToUrl) {\n      page = await browser.newPage();\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    }\n\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage);\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    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: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to use current page)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Destroy existing agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n\n          this.agent = await this.ensureAgent(url);\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          }\n          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          }\n          await browserManager.closeBrowser();\n          return this.buildTextResult('Browser closed');\n        },\n      },\n    ];\n  }\n}\n"],"names":["ENDPOINT_FILE","join","tmpdir","USER_DATA_DIR","browserManager","existsSync","endpoint","readFile","browser","puppeteer","unlink","wsEndpoint","writeFile","chromePath","resolveChromePath","mkdir","args","proc","spawn","Promise","resolve","reject","output","onData","data","match","code","Error","setTimeout","WebPuppeteerMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","navigateToUrl","undefined","reused","pages","page","webPages","p","PuppeteerAgent","z","url","screenshot","label"],"mappings":"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"}

package/dist/es/mcp-tools.mjs

@@ -1,5 +1,5 @@
 import { ScreenshotItem, z } from "@midscene/core";
-import { BaseMidsceneTools } from "@midscene/shared/mcp";
+import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { AgentOverChromeBridge } from "./bridge-mode/index.mjs";
 import { StaticPage } from "./static/index.mjs";
 class WebMidsceneTools extends BaseMidsceneTools {

package/dist/es/mcp-tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools.mjs","sources":["../../src/mcp-tools.ts"],"sourcesContent":["import { ScreenshotItem, z } from '@midscene/core';\nimport { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';\nimport { AgentOverChromeBridge } from './bridge-mode';\nimport { StaticPage } from './static';\n\n/**\n * Tools manager for Web bridge-mode MCP\n */\nexport class WebMidsceneTools extends BaseMidsceneTools<AgentOverChromeBridge> {\n  protected createTemporaryDevice() {\n    // Use require to avoid type incompatibility with DeviceAction vs ActionSpaceItem\n    // StaticPage.actionSpace() returns DeviceAction[] which is compatible at runtime\n    // Use screenshotBase64 field to avoid async ScreenshotItem.create()\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    openNewTabWithUrl?: string,\n  ): Promise<AgentOverChromeBridge> {\n    // Re-init if URL provided\n    if (this.agent && openNewTabWithUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect to current tab when no URL provided (handles CLI stateless calls)\n    this.agent = await this.initBridgeModeAgent(openNewTabWithUrl);\n\n    return this.agent;\n  }\n\n  private async initBridgeModeAgent(\n    url?: string,\n  ): Promise<AgentOverChromeBridge> {\n    const agent = new AgentOverChromeBridge({ closeConflictServer: true });\n\n    if (!url) {\n      await agent.connectCurrentTab();\n    } else {\n      await agent.connectNewTabWithUrl(url);\n    }\n\n    return agent;\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to web page. If URL provided, opens new tab; otherwise connects to current tab.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to connect current tab)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Bypass ensureAgent's URL check — directly init bridge agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n          this.agent = await this.initBridgeModeAgent(url);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current tab';\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 and release browser resources',\n        schema: {},\n        handler: this.createDisconnectHandler('web page'),\n      },\n    ];\n  }\n}\n"],"names":["WebMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","openNewTabWithUrl","error","console","undefined","url","agent","AgentOverChromeBridge","z","args","screenshot","label"],"mappings":";;;;AAQO,MAAMA,yBAAyBC;IAC1B,wBAAwB;QAIhC,OAAO,IAAIC,WAAW;YACpB,YAAYC,eAAe,MAAM,CAAC,IAAIC,KAAK,GAAG;YAC9C,UAAU;gBAAE,OAAO;gBAAM,QAAQ;YAAK;YACtC,0BAA0B;QAC5B;IACF;IAEA,MAAgB,YACdC,iBAA0B,EACM;QAEhC,IAAI,IAAI,CAAC,KAAK,IAAIA,mBAAmB;YACnC,IAAI;gBACF,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB,EAAE,OAAOC,OAAO;gBACdC,QAAQ,KAAK,CAAC,2CAA2CD;YAC3D;YACA,IAAI,CAAC,KAAK,GAAGE;QACf;QAEA,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK;QAGjC,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACH;QAE5C,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,MAAc,oBACZI,GAAY,EACoB;QAChC,MAAMC,QAAQ,IAAIC,sBAAsB;YAAE,qBAAqB;QAAK;QAEpE,IAAKF,KAGH,MAAMC,MAAM,oBAAoB,CAACD;aAFjC,MAAMC,MAAM,iBAAiB;QAK/B,OAAOA;IACT;IAEU,uBAAyC;QACjD,OAAO;YACL;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ;oBACN,KAAKE,EAAAA,MACI,GACN,GAAG,GACH,QAAQ,GACR,QAAQ,CAAC;gBACd;gBACA,SAAS,OAAOC;oBACd,MAAM,EAAEJ,GAAG,EAAE,GAAGI;oBAGhB,IAAI,IAAI,CAAC,KAAK,EAAE;wBACd,IAAI;4BACF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO;wBAC1B,EAAE,OAAM,CAAC;wBACT,IAAI,CAAC,KAAK,GAAGL;oBACf;oBACA,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACC;oBAE5C,MAAMK,aAAa,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC1C,MAAMC,QAAQN,OAAO;oBAErB,OAAO;wBACL,SAAS;4BACP;gCAAE,MAAM;gCAAQ,MAAM,CAAC,cAAc,EAAEM,OAAO;4BAAC;+BAC3CD,aAAa,IAAI,CAAC,sBAAsB,CAACA,cAAc,EAAE;yBAC9D;oBACH;gBACF;YACF;YACA;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ,CAAC;gBACT,SAAS,IAAI,CAAC,uBAAuB,CAAC;YACxC;SACD;IACH;AACF"}
+{"version":3,"file":"mcp-tools.mjs","sources":["../../src/mcp-tools.ts"],"sourcesContent":["import { ScreenshotItem, z } from '@midscene/core';\nimport { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport { AgentOverChromeBridge } from './bridge-mode';\nimport { StaticPage } from './static';\n\n/**\n * Tools manager for Web bridge-mode MCP\n */\nexport class WebMidsceneTools extends BaseMidsceneTools<AgentOverChromeBridge> {\n  protected createTemporaryDevice() {\n    // Use require to avoid type incompatibility with DeviceAction vs ActionSpaceItem\n    // StaticPage.actionSpace() returns DeviceAction[] which is compatible at runtime\n    // Use screenshotBase64 field to avoid async ScreenshotItem.create()\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    openNewTabWithUrl?: string,\n  ): Promise<AgentOverChromeBridge> {\n    // Re-init if URL provided\n    if (this.agent && openNewTabWithUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect to current tab when no URL provided (handles CLI stateless calls)\n    this.agent = await this.initBridgeModeAgent(openNewTabWithUrl);\n\n    return this.agent;\n  }\n\n  private async initBridgeModeAgent(\n    url?: string,\n  ): Promise<AgentOverChromeBridge> {\n    const agent = new AgentOverChromeBridge({ closeConflictServer: true });\n\n    if (!url) {\n      await agent.connectCurrentTab();\n    } else {\n      await agent.connectNewTabWithUrl(url);\n    }\n\n    return agent;\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to web page. If URL provided, opens new tab; otherwise connects to current tab.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to connect current tab)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Bypass ensureAgent's URL check — directly init bridge agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n          this.agent = await this.initBridgeModeAgent(url);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current tab';\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 and release browser resources',\n        schema: {},\n        handler: this.createDisconnectHandler('web page'),\n      },\n    ];\n  }\n}\n"],"names":["WebMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","openNewTabWithUrl","error","console","undefined","url","agent","AgentOverChromeBridge","z","args","screenshot","label"],"mappings":";;;;AASO,MAAMA,yBAAyBC;IAC1B,wBAAwB;QAIhC,OAAO,IAAIC,WAAW;YACpB,YAAYC,eAAe,MAAM,CAAC,IAAIC,KAAK,GAAG;YAC9C,UAAU;gBAAE,OAAO;gBAAM,QAAQ;YAAK;YACtC,0BAA0B;QAC5B;IACF;IAEA,MAAgB,YACdC,iBAA0B,EACM;QAEhC,IAAI,IAAI,CAAC,KAAK,IAAIA,mBAAmB;YACnC,IAAI;gBACF,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB,EAAE,OAAOC,OAAO;gBACdC,QAAQ,KAAK,CAAC,2CAA2CD;YAC3D;YACA,IAAI,CAAC,KAAK,GAAGE;QACf;QAEA,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK;QAGjC,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACH;QAE5C,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,MAAc,oBACZI,GAAY,EACoB;QAChC,MAAMC,QAAQ,IAAIC,sBAAsB;YAAE,qBAAqB;QAAK;QAEpE,IAAKF,KAGH,MAAMC,MAAM,oBAAoB,CAACD;aAFjC,MAAMC,MAAM,iBAAiB;QAK/B,OAAOA;IACT;IAEU,uBAAyC;QACjD,OAAO;YACL;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ;oBACN,KAAKE,EAAAA,MACI,GACN,GAAG,GACH,QAAQ,GACR,QAAQ,CAAC;gBACd;gBACA,SAAS,OAAOC;oBACd,MAAM,EAAEJ,GAAG,EAAE,GAAGI;oBAGhB,IAAI,IAAI,CAAC,KAAK,EAAE;wBACd,IAAI;4BACF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO;wBAC1B,EAAE,OAAM,CAAC;wBACT,IAAI,CAAC,KAAK,GAAGL;oBACf;oBACA,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACC;oBAE5C,MAAMK,aAAa,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC1C,MAAMC,QAAQN,OAAO;oBAErB,OAAO;wBACL,SAAS;4BACP;gCAAE,MAAM;gCAAQ,MAAM,CAAC,cAAc,EAAEM,OAAO;4BAAC;+BAC3CD,aAAa,IAAI,CAAC,sBAAsB,CAACA,cAAc,EAAE;yBAC9D;oBACH;gBACF;YACF;YACA;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ,CAAC;gBACT,SAAS,IAAI,CAAC,uBAAuB,CAAC;YACxC;SACD;IACH;AACF"}

package/dist/lib/bridge-mode/io-client.js

@@ -51,7 +51,7 @@ class BridgeClient {
                     ]
                 } : {},
                 query: {
-                    version: "1.7.5-beta-20260420032657.0"
+                    version: "1.7.5-beta-20260420052829.0"
                 }
             });
             const timeout = setTimeout(()=>{

package/dist/lib/bridge-mode/io-server.js

@@ -115,7 +115,7 @@ class BridgeServer {
                     (0, shared_utils_namespaceObject.logMsg)('one client connected');
                     this.socket = socket;
                     const clientVersion = socket.handshake.query.version;
-                    (0, shared_utils_namespaceObject.logMsg)(`Bridge connected, cli-side version v1.7.5-beta-20260420032657.0, browser-side version v${clientVersion}`);
+                    (0, shared_utils_namespaceObject.logMsg)(`Bridge connected, cli-side version v1.7.5-beta-20260420052829.0, browser-side version v${clientVersion}`);
                     socket.on(external_common_js_namespaceObject.BridgeEvent.CallResponse, (params)=>{
                         const id = params.id;
                         const response = params.response;
@@ -139,7 +139,7 @@ class BridgeServer {
                     setTimeout(()=>{
                         this.onConnect?.();
                         const payload = {
-                            version: "1.7.5-beta-20260420032657.0"
+                            version: "1.7.5-beta-20260420052829.0"
                         };
                         socket.emit(external_common_js_namespaceObject.BridgeEvent.Connected, payload);
                         Promise.resolve().then(()=>{

package/dist/lib/bridge-mode/page-browser-side.js

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

package/dist/lib/cli.js

@@ -64,7 +64,7 @@ tools = isBridge ? new external_mcp_tools_js_namespaceObject.WebMidsceneTools()
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-web', {
     stripPrefix: 'web_',
     argv,
-    version: "1.7.5-beta-20260420032657.0",
+    version: "1.7.5-beta-20260420052829.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     if (!(e instanceof cli_namespaceObject.CLIError)) console.error(e);

package/dist/lib/mcp-server.js

@@ -37,7 +37,7 @@ class WebMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/web-bridge-mcp',
-            version: "1.7.5-beta-20260420032657.0",
+            version: "1.7.5-beta-20260420052829.0",
             description: 'Control the browser using natural language commands'
         }, toolsManager);
     }

package/dist/lib/mcp-tools-cdp.js

@@ -43,7 +43,7 @@ var external_node_http_default = /*#__PURE__*/ __webpack_require__.n(external_no
 const external_node_path_namespaceObject = require("node:path");
 const core_namespaceObject = require("@midscene/core");
 const logger_namespaceObject = require("@midscene/shared/logger");
-const mcp_namespaceObject = require("@midscene/shared/mcp");
+const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 const external_puppeteer_core_namespaceObject = require("puppeteer-core");
 var external_puppeteer_core_default = /*#__PURE__*/ __webpack_require__.n(external_puppeteer_core_namespaceObject);
 const external_cdp_proxy_constants_js_namespaceObject = require("./cdp-proxy-constants.js");
@@ -269,7 +269,7 @@ async function getProxyEndpoint(chromeEndpoint) {
         return browserEndpoint;
     }
 }
-class WebCdpMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+class WebCdpMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new external_static_index_js_namespaceObject.StaticPage({
             screenshot: core_namespaceObject.ScreenshotItem.create('', Date.now()),

package/dist/lib/mcp-tools-cdp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools-cdp.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/mcp-tools-cdp.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { spawn } from 'node:child_process';\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';\nimport http from 'node:http';\nimport { join } from 'node:path';\nimport { ScreenshotItem, z } from '@midscene/core';\nimport { getDebug } from '@midscene/shared/logger';\nimport { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\nimport {\n  PROXY_ENDPOINT_FILE,\n  PROXY_PID_FILE,\n  PROXY_UPSTREAM_FILE,\n  TARGET_ID_FILE,\n} from './cdp-proxy-constants';\nimport { PuppeteerAgent } from './puppeteer';\nimport { StaticPage } from './static';\n\nconst debug = getDebug('mcp:cdp');\n\n/** CDP target discovery may need a brief moment after WebSocket open. */\nconst CDP_TARGET_DISCOVERY_DELAY_MS = 500;\n\n/**\n * Check if a CDP endpoint is a page-level URL (e.g., /devtools/page/XXX).\n */\nfunction isPageLevelEndpoint(endpoint: string): boolean {\n  return /\\/devtools\\/page\\//.test(endpoint);\n}\n\n/**\n * Try to resolve a page-level CDP endpoint to a browser-level endpoint\n * by fetching /json/version from the same host:port.\n */\nfunction resolveBrowserEndpoint(pageEndpoint: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let host: string;\n    try {\n      const url = new URL(pageEndpoint);\n      host = url.host; // host includes port (e.g. \"127.0.0.1:9222\")\n    } catch {\n      reject(new Error(`Invalid CDP endpoint URL: ${pageEndpoint}`));\n      return;\n    }\n\n    const req = http.get(\n      `http://${host}/json/version`,\n      { timeout: 5000 },\n      (res) => {\n        if (res.statusCode && res.statusCode >= 400) {\n          reject(new Error(`/json/version returned HTTP ${res.statusCode}`));\n          res.resume();\n          return;\n        }\n        let data = '';\n        res.on('data', (chunk: Buffer) => {\n          data += chunk.toString();\n        });\n        res.on('end', () => {\n          try {\n            const info = JSON.parse(data);\n            if (info.webSocketDebuggerUrl) {\n              resolve(info.webSocketDebuggerUrl);\n            } else {\n              reject(\n                new Error(\n                  'webSocketDebuggerUrl not found in /json/version response',\n                ),\n              );\n            }\n          } catch {\n            reject(\n              new Error(`Failed to parse /json/version response: ${data}`),\n            );\n          }\n        });\n      },\n    );\n    req.on('error', (err) =>\n      reject(new Error(`Failed to fetch /json/version: ${err.message}`)),\n    );\n    req.on('timeout', () => {\n      req.destroy();\n      reject(new Error('Timeout fetching /json/version'));\n    });\n  });\n}\n\n/**\n * Check if a previously spawned proxy process is still alive.\n */\nfunction isProxyAlive(): boolean {\n  if (!existsSync(PROXY_PID_FILE)) return false;\n  try {\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    process.kill(pid, 0); // signal 0 = existence check\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Read the proxy endpoint written by cdp-proxy.ts.\n */\nfunction readProxyEndpoint(): string | null {\n  if (!existsSync(PROXY_ENDPOINT_FILE)) return null;\n  try {\n    return readFileSync(PROXY_ENDPOINT_FILE, 'utf-8').trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Read the Chrome endpoint that the running proxy is connected to.\n */\nfunction readProxyUpstream(): string | null {\n  if (!existsSync(PROXY_UPSTREAM_FILE)) return null;\n  try {\n    return readFileSync(PROXY_UPSTREAM_FILE, 'utf-8').trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Kill the running proxy process and clear all CDP-mode metadata files\n * (proxy endpoint/pid/upstream and the cross-command targetId).\n */\nfunction killProxy(): void {\n  if (!existsSync(PROXY_PID_FILE)) return;\n  try {\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    process.kill(pid, 'SIGTERM');\n    debug('Killed proxy pid: %d', pid);\n  } catch (err) {\n    // ESRCH (already dead) is the common case; surface anything else\n    // (e.g. EPERM) via debug so it does not vanish silently.\n    debug('killProxy failed: %s', err);\n  }\n  try {\n    if (existsSync(PROXY_ENDPOINT_FILE)) unlinkSync(PROXY_ENDPOINT_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_PID_FILE)) unlinkSync(PROXY_PID_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_UPSTREAM_FILE)) unlinkSync(PROXY_UPSTREAM_FILE);\n  } catch {}\n  // The saved targetId points into the now-defunct upstream's tab list,\n  // so it cannot match anything in a fresh Chrome and must be discarded.\n  cleanupTargetIdFile();\n}\n\n/**\n * Read the saved targetId from the temporary file.\n */\nfunction readSavedTargetId(): string | null {\n  if (!existsSync(TARGET_ID_FILE)) return null;\n  try {\n    return readFileSync(TARGET_ID_FILE, 'utf-8').trim() || null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Save a targetId to the temporary file for cross-command tab reuse.\n */\nfunction saveTargetId(targetId: string): void {\n  try {\n    writeFileSync(TARGET_ID_FILE, targetId, 'utf-8');\n    debug('Saved targetId: %s', targetId);\n  } catch (err) {\n    debug('Failed to save targetId: %s', err);\n  }\n}\n\n/**\n * Remove the saved targetId file.\n */\nfunction cleanupTargetIdFile(): void {\n  try {\n    if (existsSync(TARGET_ID_FILE)) unlinkSync(TARGET_ID_FILE);\n  } catch {}\n}\n\n/**\n * puppeteer-core does not expose a public method for the underlying\n * CDP target id, so we reach into `_targetId`. Centralised here so that\n * a future puppeteer release exposing this properly only requires one\n * change. Callers must treat the result as optional.\n */\nfunction getTargetId(page: Page): string | undefined {\n  return (page.target() as unknown as { _targetId?: string })._targetId;\n}\n\n/** Keep at most this many bytes of proxy stderr for diagnostics. */\nconst PROXY_STDERR_BUFFER_LIMIT = 8 * 1024;\n\n/**\n * Spawn the CDP proxy process and wait for it to print the endpoint.\n *\n * Captures the child's stderr so that when startup fails we can surface\n * the real reason (upstream closed / duplicate proxy / upstream error)\n * instead of the generic \"exited before ready\".\n */\nfunction spawnProxy(chromeEndpoint: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const proxyScript = join(__dirname, 'cdp-proxy.js');\n    const proc = spawn(process.execPath, [proxyScript, chromeEndpoint], {\n      detached: true,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n    proc.unref();\n\n    let output = '';\n    let stderrBuf = '';\n    let settled = false;\n\n    const appendStderr = (chunk: Buffer) => {\n      stderrBuf += chunk.toString();\n      if (stderrBuf.length > PROXY_STDERR_BUFFER_LIMIT) {\n        stderrBuf = stderrBuf.slice(-PROXY_STDERR_BUFFER_LIMIT);\n      }\n    };\n    proc.stderr!.on('data', appendStderr);\n\n    const formatStderr = () => {\n      const trimmed = stderrBuf.trim();\n      return trimmed ? ` (stderr: ${trimmed})` : '';\n    };\n\n    const timer = setTimeout(() => {\n      if (!settled) {\n        settled = true;\n        reject(new Error(`Proxy startup timeout (10s)${formatStderr()}`));\n      }\n    }, 10000);\n\n    const onData = (chunk: Buffer) => {\n      output += chunk.toString();\n      const lines = output.split('\\n');\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        try {\n          const parsed = JSON.parse(line);\n          if (parsed.endpoint && !settled) {\n            settled = true;\n            clearTimeout(timer);\n            proc.stdout!.removeListener('data', onData);\n            proc.stderr!.removeListener('data', appendStderr);\n            // Destroy the stdio pipes so they don't keep the parent\n            // process event loop alive after we've read the endpoint.\n            proc.stdout!.destroy();\n            proc.stderr!.destroy();\n            resolve(parsed.endpoint);\n            return;\n          }\n        } catch {\n          // stdout may contain non-JSON lines during startup — skip them\n        }\n      }\n    };\n    proc.stdout!.on('data', onData);\n\n    proc.on('error', (err) => {\n      if (!settled) {\n        settled = true;\n        clearTimeout(timer);\n        reject(new Error(`Failed to spawn proxy: ${err.message}`));\n      }\n    });\n    proc.on('exit', (code, signal) => {\n      if (!settled) {\n        settled = true;\n        clearTimeout(timer);\n        const how = signal ? `signal ${signal}` : `code ${code}`;\n        reject(\n          new Error(`Proxy exited with ${how} before ready${formatStderr()}`),\n        );\n      }\n    });\n  });\n}\n\n/**\n * Get the proxy endpoint, spawning the proxy if needed.\n * Falls back to direct connection if proxy cannot be started.\n *\n * If the user provides a page-level CDP URL, automatically resolves it\n * to a browser-level endpoint via /json/version.\n */\nasync function getProxyEndpoint(chromeEndpoint: string): Promise<string> {\n  // If the user passed a page-level endpoint, resolve to browser-level first\n  let browserEndpoint = chromeEndpoint;\n  if (isPageLevelEndpoint(chromeEndpoint)) {\n    debug(\n      'Page-level CDP endpoint detected, resolving via /json/version: %s',\n      chromeEndpoint,\n    );\n    try {\n      browserEndpoint = await resolveBrowserEndpoint(chromeEndpoint);\n      debug('Resolved browser endpoint: %s', browserEndpoint);\n    } catch (err) {\n      throw new Error(\n        `Cannot use page-level CDP endpoint directly. Puppeteer requires a browser-level endpoint (e.g., ws://host:port/devtools/browser/<id>). Auto-resolution via /json/version failed: ${(err as Error).message}. Please provide a browser-level CDP endpoint instead.`,\n      );\n    }\n  }\n\n  // If proxy is alive and connected to the same Chrome, reuse it\n  if (isProxyAlive()) {\n    const endpoint = readProxyEndpoint();\n    const savedUpstream = readProxyUpstream();\n    if (endpoint) {\n      if (savedUpstream && savedUpstream !== browserEndpoint) {\n        // Proxy is connected to a different Chrome — kill it and start fresh\n        debug(\n          'Proxy connected to different upstream (%s), killing',\n          savedUpstream,\n        );\n        killProxy();\n      } else {\n        return endpoint;\n      }\n    }\n  }\n\n  // Spawn a new proxy\n  try {\n    return await spawnProxy(browserEndpoint);\n  } catch (err) {\n    console.warn(\n      `[cdp] proxy failed, falling back to direct connection: ${err}`,\n    );\n    return browserEndpoint;\n  }\n}\n\n/**\n * Tools manager for Web CDP-mode MCP.\n * Connects to an existing Chrome browser via CDP (Chrome DevTools Protocol) endpoint.\n * Unlike WebPuppeteerMidsceneTools which launches its own Chrome, this connects\n * to a browser that is already running with remote debugging enabled.\n *\n * Uses a persistent WebSocket proxy to avoid repeated Chrome permission popups\n * when Chrome's settings-based remote debugging is used.\n */\nexport class WebCdpMidsceneTools extends BaseMidsceneTools<PuppeteerAgent> {\n  private cdpEndpoint: string;\n  private activeBrowser: Browser | null = null;\n\n  constructor(cdpEndpoint: string) {\n    super();\n    this.cdpEndpoint = cdpEndpoint;\n  }\n\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(navigateToUrl?: string): Promise<PuppeteerAgent> {\n    // Re-init if URL provided\n    if (this.agent && navigateToUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect via proxy to avoid repeated Chrome permission popups\n    if (!this.activeBrowser) {\n      const endpoint = await getProxyEndpoint(this.cdpEndpoint);\n      this.activeBrowser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n        defaultViewport: null,\n      });\n    }\n\n    const browser = this.activeBrowser;\n    let pages = await browser.pages();\n\n    // If no pages discovered, wait briefly and retry — some CDP targets\n    // need a moment to appear after the WebSocket connection is established.\n    if (pages.length === 0) {\n      await new Promise((r) => setTimeout(r, CDP_TARGET_DISCOVERY_DELAY_MS));\n      pages = await browser.pages();\n    }\n\n    const webPages = pages.filter((p) => /^https?:\\/\\//.test(p.url()));\n    debug(\n      'Found %d page(s), %d web page(s): %o',\n      pages.length,\n      webPages.length,\n      pages.map((p) => p.url()),\n    );\n    let page: Page;\n\n    if (navigateToUrl) {\n      if (webPages.length > 0) {\n        // Reuse an existing page and navigate it — avoids creating invisible\n        // tabs when Chrome uses settings-based remote debugging (no HTTP\n        // discovery endpoints, /devtools/page/* returns 403).\n        page = webPages[webPages.length - 1];\n        await page.bringToFront();\n        await page.goto(navigateToUrl, {\n          timeout: 30000,\n          waitUntil: 'domcontentloaded',\n        });\n      } else {\n        // No existing web pages — fall back to creating a new tab\n        page = await browser.newPage();\n        await page.goto(navigateToUrl, {\n          timeout: 30000,\n          waitUntil: 'domcontentloaded',\n        });\n      }\n    } else {\n      // Try to find the exact tab from a previous `connect` command via saved targetId.\n      const savedTargetId = readSavedTargetId();\n      let matchedPage: Page | undefined;\n\n      if (savedTargetId && pages.length > 0) {\n        matchedPage = pages.find((p) => getTargetId(p) === savedTargetId);\n        if (matchedPage) {\n          debug('Matched saved targetId %s', savedTargetId);\n        } else {\n          debug(\n            'Saved targetId %s not found among %d pages, falling back',\n            savedTargetId,\n            pages.length,\n          );\n        }\n      }\n\n      if (matchedPage) {\n        page = matchedPage;\n      } else if (webPages.length > 0) {\n        page = webPages[webPages.length - 1];\n      } else if (pages.length > 0) {\n        page = pages[pages.length - 1];\n      } else {\n        page = await browser.newPage();\n      }\n\n      await page.bringToFront();\n    }\n\n    // Persist the targetId so subsequent CLI commands can find this exact tab\n    const targetId = getTargetId(page);\n    if (targetId) {\n      saveTargetId(targetId);\n    } else {\n      // If puppeteer ever drops the private _targetId field, this branch\n      // makes the regression visible instead of silently disabling the\n      // cross-command tab reuse path.\n      debug(\n        'No targetId on page.target(); cross-command tab reuse disabled until puppeteer integration is updated.',\n      );\n    }\n\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage);\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    if (this.activeBrowser) {\n      this.activeBrowser.disconnect();\n      this.activeBrowser = null;\n    }\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to a web page via CDP. Opens a new tab with the given URL, or reuses the current page.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to use current page)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Destroy existing agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during connect:', e);\n            }\n            this.agent = undefined;\n          }\n\n          this.agent = await this.ensureAgent(url);\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 via CDP 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 (managed externally).',\n        schema: {},\n        handler: async () => {\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during disconnect:', e);\n            }\n            this.agent = undefined;\n          }\n          if (this.activeBrowser) {\n            this.activeBrowser.disconnect();\n            this.activeBrowser = null;\n          }\n          cleanupTargetIdFile();\n          return this.buildTextResult(\n            'Disconnected from web page (browser still running externally)',\n          );\n        },\n      },\n    ];\n  }\n}\n\n/**\n * Internal helpers exposed for unit tests. Not part of the public API.\n */\nexport const __test__ = {\n  getProxyEndpoint,\n  killProxy,\n  readProxyUpstream,\n  isProxyAlive,\n};\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","debug","getDebug","CDP_TARGET_DISCOVERY_DELAY_MS","isPageLevelEndpoint","endpoint","resolveBrowserEndpoint","pageEndpoint","Promise","resolve","reject","host","url","URL","Error","req","http","res","data","chunk","info","JSON","err","isProxyAlive","existsSync","PROXY_PID_FILE","pid","Number","readFileSync","process","readProxyEndpoint","PROXY_ENDPOINT_FILE","readProxyUpstream","PROXY_UPSTREAM_FILE","killProxy","unlinkSync","cleanupTargetIdFile","readSavedTargetId","TARGET_ID_FILE","saveTargetId","targetId","writeFileSync","getTargetId","page","PROXY_STDERR_BUFFER_LIMIT","spawnProxy","chromeEndpoint","proxyScript","join","__dirname","proc","spawn","output","stderrBuf","settled","appendStderr","formatStderr","trimmed","timer","setTimeout","onData","lines","line","parsed","clearTimeout","code","signal","how","getProxyEndpoint","browserEndpoint","savedUpstream","console","WebCdpMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","navigateToUrl","error","undefined","puppeteer","browser","pages","r","webPages","p","savedTargetId","matchedPage","PuppeteerAgent","z","args","e","screenshot","label","cdpEndpoint","__test__"],"mappings":"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"}
+{"version":3,"file":"mcp-tools-cdp.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/mcp-tools-cdp.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { spawn } from 'node:child_process';\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';\nimport http from 'node:http';\nimport { join } from 'node:path';\nimport { ScreenshotItem, z } from '@midscene/core';\nimport { getDebug } from '@midscene/shared/logger';\nimport { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\nimport {\n  PROXY_ENDPOINT_FILE,\n  PROXY_PID_FILE,\n  PROXY_UPSTREAM_FILE,\n  TARGET_ID_FILE,\n} from './cdp-proxy-constants';\nimport { PuppeteerAgent } from './puppeteer';\nimport { StaticPage } from './static';\n\nconst debug = getDebug('mcp:cdp');\n\n/** CDP target discovery may need a brief moment after WebSocket open. */\nconst CDP_TARGET_DISCOVERY_DELAY_MS = 500;\n\n/**\n * Check if a CDP endpoint is a page-level URL (e.g., /devtools/page/XXX).\n */\nfunction isPageLevelEndpoint(endpoint: string): boolean {\n  return /\\/devtools\\/page\\//.test(endpoint);\n}\n\n/**\n * Try to resolve a page-level CDP endpoint to a browser-level endpoint\n * by fetching /json/version from the same host:port.\n */\nfunction resolveBrowserEndpoint(pageEndpoint: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let host: string;\n    try {\n      const url = new URL(pageEndpoint);\n      host = url.host; // host includes port (e.g. \"127.0.0.1:9222\")\n    } catch {\n      reject(new Error(`Invalid CDP endpoint URL: ${pageEndpoint}`));\n      return;\n    }\n\n    const req = http.get(\n      `http://${host}/json/version`,\n      { timeout: 5000 },\n      (res) => {\n        if (res.statusCode && res.statusCode >= 400) {\n          reject(new Error(`/json/version returned HTTP ${res.statusCode}`));\n          res.resume();\n          return;\n        }\n        let data = '';\n        res.on('data', (chunk: Buffer) => {\n          data += chunk.toString();\n        });\n        res.on('end', () => {\n          try {\n            const info = JSON.parse(data);\n            if (info.webSocketDebuggerUrl) {\n              resolve(info.webSocketDebuggerUrl);\n            } else {\n              reject(\n                new Error(\n                  'webSocketDebuggerUrl not found in /json/version response',\n                ),\n              );\n            }\n          } catch {\n            reject(\n              new Error(`Failed to parse /json/version response: ${data}`),\n            );\n          }\n        });\n      },\n    );\n    req.on('error', (err) =>\n      reject(new Error(`Failed to fetch /json/version: ${err.message}`)),\n    );\n    req.on('timeout', () => {\n      req.destroy();\n      reject(new Error('Timeout fetching /json/version'));\n    });\n  });\n}\n\n/**\n * Check if a previously spawned proxy process is still alive.\n */\nfunction isProxyAlive(): boolean {\n  if (!existsSync(PROXY_PID_FILE)) return false;\n  try {\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    process.kill(pid, 0); // signal 0 = existence check\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Read the proxy endpoint written by cdp-proxy.ts.\n */\nfunction readProxyEndpoint(): string | null {\n  if (!existsSync(PROXY_ENDPOINT_FILE)) return null;\n  try {\n    return readFileSync(PROXY_ENDPOINT_FILE, 'utf-8').trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Read the Chrome endpoint that the running proxy is connected to.\n */\nfunction readProxyUpstream(): string | null {\n  if (!existsSync(PROXY_UPSTREAM_FILE)) return null;\n  try {\n    return readFileSync(PROXY_UPSTREAM_FILE, 'utf-8').trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Kill the running proxy process and clear all CDP-mode metadata files\n * (proxy endpoint/pid/upstream and the cross-command targetId).\n */\nfunction killProxy(): void {\n  if (!existsSync(PROXY_PID_FILE)) return;\n  try {\n    const pid = Number(readFileSync(PROXY_PID_FILE, 'utf-8').trim());\n    process.kill(pid, 'SIGTERM');\n    debug('Killed proxy pid: %d', pid);\n  } catch (err) {\n    // ESRCH (already dead) is the common case; surface anything else\n    // (e.g. EPERM) via debug so it does not vanish silently.\n    debug('killProxy failed: %s', err);\n  }\n  try {\n    if (existsSync(PROXY_ENDPOINT_FILE)) unlinkSync(PROXY_ENDPOINT_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_PID_FILE)) unlinkSync(PROXY_PID_FILE);\n  } catch {}\n  try {\n    if (existsSync(PROXY_UPSTREAM_FILE)) unlinkSync(PROXY_UPSTREAM_FILE);\n  } catch {}\n  // The saved targetId points into the now-defunct upstream's tab list,\n  // so it cannot match anything in a fresh Chrome and must be discarded.\n  cleanupTargetIdFile();\n}\n\n/**\n * Read the saved targetId from the temporary file.\n */\nfunction readSavedTargetId(): string | null {\n  if (!existsSync(TARGET_ID_FILE)) return null;\n  try {\n    return readFileSync(TARGET_ID_FILE, 'utf-8').trim() || null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Save a targetId to the temporary file for cross-command tab reuse.\n */\nfunction saveTargetId(targetId: string): void {\n  try {\n    writeFileSync(TARGET_ID_FILE, targetId, 'utf-8');\n    debug('Saved targetId: %s', targetId);\n  } catch (err) {\n    debug('Failed to save targetId: %s', err);\n  }\n}\n\n/**\n * Remove the saved targetId file.\n */\nfunction cleanupTargetIdFile(): void {\n  try {\n    if (existsSync(TARGET_ID_FILE)) unlinkSync(TARGET_ID_FILE);\n  } catch {}\n}\n\n/**\n * puppeteer-core does not expose a public method for the underlying\n * CDP target id, so we reach into `_targetId`. Centralised here so that\n * a future puppeteer release exposing this properly only requires one\n * change. Callers must treat the result as optional.\n */\nfunction getTargetId(page: Page): string | undefined {\n  return (page.target() as unknown as { _targetId?: string })._targetId;\n}\n\n/** Keep at most this many bytes of proxy stderr for diagnostics. */\nconst PROXY_STDERR_BUFFER_LIMIT = 8 * 1024;\n\n/**\n * Spawn the CDP proxy process and wait for it to print the endpoint.\n *\n * Captures the child's stderr so that when startup fails we can surface\n * the real reason (upstream closed / duplicate proxy / upstream error)\n * instead of the generic \"exited before ready\".\n */\nfunction spawnProxy(chromeEndpoint: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const proxyScript = join(__dirname, 'cdp-proxy.js');\n    const proc = spawn(process.execPath, [proxyScript, chromeEndpoint], {\n      detached: true,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n    proc.unref();\n\n    let output = '';\n    let stderrBuf = '';\n    let settled = false;\n\n    const appendStderr = (chunk: Buffer) => {\n      stderrBuf += chunk.toString();\n      if (stderrBuf.length > PROXY_STDERR_BUFFER_LIMIT) {\n        stderrBuf = stderrBuf.slice(-PROXY_STDERR_BUFFER_LIMIT);\n      }\n    };\n    proc.stderr!.on('data', appendStderr);\n\n    const formatStderr = () => {\n      const trimmed = stderrBuf.trim();\n      return trimmed ? ` (stderr: ${trimmed})` : '';\n    };\n\n    const timer = setTimeout(() => {\n      if (!settled) {\n        settled = true;\n        reject(new Error(`Proxy startup timeout (10s)${formatStderr()}`));\n      }\n    }, 10000);\n\n    const onData = (chunk: Buffer) => {\n      output += chunk.toString();\n      const lines = output.split('\\n');\n      for (const line of lines) {\n        if (!line.trim()) continue;\n        try {\n          const parsed = JSON.parse(line);\n          if (parsed.endpoint && !settled) {\n            settled = true;\n            clearTimeout(timer);\n            proc.stdout!.removeListener('data', onData);\n            proc.stderr!.removeListener('data', appendStderr);\n            // Destroy the stdio pipes so they don't keep the parent\n            // process event loop alive after we've read the endpoint.\n            proc.stdout!.destroy();\n            proc.stderr!.destroy();\n            resolve(parsed.endpoint);\n            return;\n          }\n        } catch {\n          // stdout may contain non-JSON lines during startup — skip them\n        }\n      }\n    };\n    proc.stdout!.on('data', onData);\n\n    proc.on('error', (err) => {\n      if (!settled) {\n        settled = true;\n        clearTimeout(timer);\n        reject(new Error(`Failed to spawn proxy: ${err.message}`));\n      }\n    });\n    proc.on('exit', (code, signal) => {\n      if (!settled) {\n        settled = true;\n        clearTimeout(timer);\n        const how = signal ? `signal ${signal}` : `code ${code}`;\n        reject(\n          new Error(`Proxy exited with ${how} before ready${formatStderr()}`),\n        );\n      }\n    });\n  });\n}\n\n/**\n * Get the proxy endpoint, spawning the proxy if needed.\n * Falls back to direct connection if proxy cannot be started.\n *\n * If the user provides a page-level CDP URL, automatically resolves it\n * to a browser-level endpoint via /json/version.\n */\nasync function getProxyEndpoint(chromeEndpoint: string): Promise<string> {\n  // If the user passed a page-level endpoint, resolve to browser-level first\n  let browserEndpoint = chromeEndpoint;\n  if (isPageLevelEndpoint(chromeEndpoint)) {\n    debug(\n      'Page-level CDP endpoint detected, resolving via /json/version: %s',\n      chromeEndpoint,\n    );\n    try {\n      browserEndpoint = await resolveBrowserEndpoint(chromeEndpoint);\n      debug('Resolved browser endpoint: %s', browserEndpoint);\n    } catch (err) {\n      throw new Error(\n        `Cannot use page-level CDP endpoint directly. Puppeteer requires a browser-level endpoint (e.g., ws://host:port/devtools/browser/<id>). Auto-resolution via /json/version failed: ${(err as Error).message}. Please provide a browser-level CDP endpoint instead.`,\n      );\n    }\n  }\n\n  // If proxy is alive and connected to the same Chrome, reuse it\n  if (isProxyAlive()) {\n    const endpoint = readProxyEndpoint();\n    const savedUpstream = readProxyUpstream();\n    if (endpoint) {\n      if (savedUpstream && savedUpstream !== browserEndpoint) {\n        // Proxy is connected to a different Chrome — kill it and start fresh\n        debug(\n          'Proxy connected to different upstream (%s), killing',\n          savedUpstream,\n        );\n        killProxy();\n      } else {\n        return endpoint;\n      }\n    }\n  }\n\n  // Spawn a new proxy\n  try {\n    return await spawnProxy(browserEndpoint);\n  } catch (err) {\n    console.warn(\n      `[cdp] proxy failed, falling back to direct connection: ${err}`,\n    );\n    return browserEndpoint;\n  }\n}\n\n/**\n * Tools manager for Web CDP-mode MCP.\n * Connects to an existing Chrome browser via CDP (Chrome DevTools Protocol) endpoint.\n * Unlike WebPuppeteerMidsceneTools which launches its own Chrome, this connects\n * to a browser that is already running with remote debugging enabled.\n *\n * Uses a persistent WebSocket proxy to avoid repeated Chrome permission popups\n * when Chrome's settings-based remote debugging is used.\n */\nexport class WebCdpMidsceneTools extends BaseMidsceneTools<PuppeteerAgent> {\n  private cdpEndpoint: string;\n  private activeBrowser: Browser | null = null;\n\n  constructor(cdpEndpoint: string) {\n    super();\n    this.cdpEndpoint = cdpEndpoint;\n  }\n\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(navigateToUrl?: string): Promise<PuppeteerAgent> {\n    // Re-init if URL provided\n    if (this.agent && navigateToUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect via proxy to avoid repeated Chrome permission popups\n    if (!this.activeBrowser) {\n      const endpoint = await getProxyEndpoint(this.cdpEndpoint);\n      this.activeBrowser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n        defaultViewport: null,\n      });\n    }\n\n    const browser = this.activeBrowser;\n    let pages = await browser.pages();\n\n    // If no pages discovered, wait briefly and retry — some CDP targets\n    // need a moment to appear after the WebSocket connection is established.\n    if (pages.length === 0) {\n      await new Promise((r) => setTimeout(r, CDP_TARGET_DISCOVERY_DELAY_MS));\n      pages = await browser.pages();\n    }\n\n    const webPages = pages.filter((p) => /^https?:\\/\\//.test(p.url()));\n    debug(\n      'Found %d page(s), %d web page(s): %o',\n      pages.length,\n      webPages.length,\n      pages.map((p) => p.url()),\n    );\n    let page: Page;\n\n    if (navigateToUrl) {\n      if (webPages.length > 0) {\n        // Reuse an existing page and navigate it — avoids creating invisible\n        // tabs when Chrome uses settings-based remote debugging (no HTTP\n        // discovery endpoints, /devtools/page/* returns 403).\n        page = webPages[webPages.length - 1];\n        await page.bringToFront();\n        await page.goto(navigateToUrl, {\n          timeout: 30000,\n          waitUntil: 'domcontentloaded',\n        });\n      } else {\n        // No existing web pages — fall back to creating a new tab\n        page = await browser.newPage();\n        await page.goto(navigateToUrl, {\n          timeout: 30000,\n          waitUntil: 'domcontentloaded',\n        });\n      }\n    } else {\n      // Try to find the exact tab from a previous `connect` command via saved targetId.\n      const savedTargetId = readSavedTargetId();\n      let matchedPage: Page | undefined;\n\n      if (savedTargetId && pages.length > 0) {\n        matchedPage = pages.find((p) => getTargetId(p) === savedTargetId);\n        if (matchedPage) {\n          debug('Matched saved targetId %s', savedTargetId);\n        } else {\n          debug(\n            'Saved targetId %s not found among %d pages, falling back',\n            savedTargetId,\n            pages.length,\n          );\n        }\n      }\n\n      if (matchedPage) {\n        page = matchedPage;\n      } else if (webPages.length > 0) {\n        page = webPages[webPages.length - 1];\n      } else if (pages.length > 0) {\n        page = pages[pages.length - 1];\n      } else {\n        page = await browser.newPage();\n      }\n\n      await page.bringToFront();\n    }\n\n    // Persist the targetId so subsequent CLI commands can find this exact tab\n    const targetId = getTargetId(page);\n    if (targetId) {\n      saveTargetId(targetId);\n    } else {\n      // If puppeteer ever drops the private _targetId field, this branch\n      // makes the regression visible instead of silently disabling the\n      // cross-command tab reuse path.\n      debug(\n        'No targetId on page.target(); cross-command tab reuse disabled until puppeteer integration is updated.',\n      );\n    }\n\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage);\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    if (this.activeBrowser) {\n      this.activeBrowser.disconnect();\n      this.activeBrowser = null;\n    }\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to a web page via CDP. Opens a new tab with the given URL, or reuses the current page.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to use current page)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Destroy existing agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during connect:', e);\n            }\n            this.agent = undefined;\n          }\n\n          this.agent = await this.ensureAgent(url);\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 via CDP 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 (managed externally).',\n        schema: {},\n        handler: async () => {\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during disconnect:', e);\n            }\n            this.agent = undefined;\n          }\n          if (this.activeBrowser) {\n            this.activeBrowser.disconnect();\n            this.activeBrowser = null;\n          }\n          cleanupTargetIdFile();\n          return this.buildTextResult(\n            'Disconnected from web page (browser still running externally)',\n          );\n        },\n      },\n    ];\n  }\n}\n\n/**\n * Internal helpers exposed for unit tests. Not part of the public API.\n */\nexport const __test__ = {\n  getProxyEndpoint,\n  killProxy,\n  readProxyUpstream,\n  isProxyAlive,\n};\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","debug","getDebug","CDP_TARGET_DISCOVERY_DELAY_MS","isPageLevelEndpoint","endpoint","resolveBrowserEndpoint","pageEndpoint","Promise","resolve","reject","host","url","URL","Error","req","http","res","data","chunk","info","JSON","err","isProxyAlive","existsSync","PROXY_PID_FILE","pid","Number","readFileSync","process","readProxyEndpoint","PROXY_ENDPOINT_FILE","readProxyUpstream","PROXY_UPSTREAM_FILE","killProxy","unlinkSync","cleanupTargetIdFile","readSavedTargetId","TARGET_ID_FILE","saveTargetId","targetId","writeFileSync","getTargetId","page","PROXY_STDERR_BUFFER_LIMIT","spawnProxy","chromeEndpoint","proxyScript","join","__dirname","proc","spawn","output","stderrBuf","settled","appendStderr","formatStderr","trimmed","timer","setTimeout","onData","lines","line","parsed","clearTimeout","code","signal","how","getProxyEndpoint","browserEndpoint","savedUpstream","console","WebCdpMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","navigateToUrl","error","undefined","puppeteer","browser","pages","r","webPages","p","savedTargetId","matchedPage","PuppeteerAgent","z","args","e","screenshot","label","cdpEndpoint","__test__"],"mappings":"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"}

package/dist/lib/mcp-tools-puppeteer.js

@@ -41,7 +41,8 @@ const promises_namespaceObject = require("node:fs/promises");
 const external_node_os_namespaceObject = require("node:os");
 const external_node_path_namespaceObject = require("node:path");
 const core_namespaceObject = require("@midscene/core");
-const mcp_namespaceObject = require("@midscene/shared/mcp");
+const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
+const chrome_path_namespaceObject = require("@midscene/shared/mcp/chrome-path");
 const external_puppeteer_core_namespaceObject = require("puppeteer-core");
 var external_puppeteer_core_default = /*#__PURE__*/ __webpack_require__.n(external_puppeteer_core_namespaceObject);
 const index_js_namespaceObject = require("./puppeteer/index.js");
@@ -97,7 +98,7 @@ const browserManager = {
         }
     },
     async launchDetachedChrome () {
-        const chromePath = (0, mcp_namespaceObject.resolveChromePath)();
+        const chromePath = (0, chrome_path_namespaceObject.resolveChromePath)();
         await (0, promises_namespaceObject.mkdir)(USER_DATA_DIR, {
             recursive: true
         });
@@ -144,7 +145,7 @@ const browserManager = {
         });
     }
 };
-class WebPuppeteerMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+class WebPuppeteerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new external_static_index_js_namespaceObject.StaticPage({
             screenshot: core_namespaceObject.ScreenshotItem.create('', Date.now()),

package/dist/lib/mcp-tools-puppeteer.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools-puppeteer.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/mcp-tools-puppeteer.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { 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, z } from '@midscene/core';\nimport {\n  BaseMidsceneTools,\n  type ToolDefinition,\n  resolveChromePath,\n} from '@midscene/shared/mcp';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\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');\n\n/**\n * Persistent Puppeteer browser manager.\n * Launches a detached Chrome and persists the WS endpoint across CLI calls.\n */\nconst browserManager = {\n  activeBrowser: null as Browser | null,\n\n  async getOrLaunch(): Promise<{ browser: Browser; reused: boolean }> {\n    if (existsSync(ENDPOINT_FILE)) {\n      try {\n        const endpoint = (await readFile(ENDPOINT_FILE, '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(ENDPOINT_FILE);\n        } catch {}\n      }\n    }\n\n    const wsEndpoint = await this.launchDetachedChrome();\n    await writeFile(ENDPOINT_FILE, 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    if (!existsSync(ENDPOINT_FILE)) return;\n    try {\n      const endpoint = (await readFile(ENDPOINT_FILE, 'utf-8')).trim();\n      const browser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n      });\n      await browser.close();\n    } catch {}\n    try {\n      await unlink(ENDPOINT_FILE);\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(): Promise<string> {\n    const chromePath = resolveChromePath();\n\n    await mkdir(USER_DATA_DIR, { recursive: true });\n\n    const args = [\n      '--headless=new',\n      `--user-data-dir=${USER_DATA_DIR}`,\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=1280,800',\n      '--force-color-profile=srgb',\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      const onData = (data: Buffer) => {\n        output += data.toString();\n        const match = output.match(/DevTools listening on (ws:\\/\\/[^\\s]+)/);\n        if (match) {\n          proc.stderr!.removeListener('data', onData);\n          resolve(match[1]);\n        }\n      };\n      proc.stderr!.on('data', onData);\n\n      proc.on('exit', (code) => {\n        proc.stderr!.removeListener('data', onData);\n        reject(\n          new Error(\n            `Chrome exited with code ${code} before DevTools was ready.\\nChrome stderr: ${output}\\nTip: try setting MIDSCENE_MCP_NO_SANDBOX=1 if running in a container.`,\n          ),\n        );\n      });\n\n      setTimeout(\n        () =>\n          reject(\n            new Error(\n              `Chrome launch timeout.\\nChrome stderr: ${output}\\nTip: try setting MIDSCENE_MCP_NO_SANDBOX=1 if running in a container.`,\n            ),\n          ),\n        15000,\n      );\n    });\n  },\n};\n\n/**\n * Tools manager for Web Puppeteer-mode MCP.\n * Uses a persistent headless Chrome browser that survives across CLI calls.\n */\nexport class WebPuppeteerMidsceneTools extends BaseMidsceneTools<PuppeteerAgent> {\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(navigateToUrl?: string): Promise<PuppeteerAgent> {\n    // Re-init if URL provided\n    if (this.agent && navigateToUrl) {\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 browserManager.getOrLaunch();\n    browserManager.activeBrowser = browser;\n\n    const pages = await browser.pages();\n    let page: Page;\n\n    if (navigateToUrl) {\n      page = await browser.newPage();\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    }\n\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage);\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    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: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to use current page)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Destroy existing agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n\n          this.agent = await this.ensureAgent(url);\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          }\n          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          }\n          await browserManager.closeBrowser();\n          return this.buildTextResult('Browser closed');\n        },\n      },\n    ];\n  }\n}\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","ENDPOINT_FILE","join","tmpdir","USER_DATA_DIR","browserManager","existsSync","endpoint","readFile","browser","puppeteer","unlink","wsEndpoint","writeFile","chromePath","resolveChromePath","mkdir","args","proc","spawn","Promise","resolve","reject","output","onData","data","match","code","Error","setTimeout","WebPuppeteerMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","navigateToUrl","undefined","reused","pages","page","webPages","p","PuppeteerAgent","z","url","screenshot","label"],"mappings":"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"}
+{"version":3,"file":"mcp-tools-puppeteer.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/mcp-tools-puppeteer.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { 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, z } from '@midscene/core';\nimport { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';\nimport { resolveChromePath } from '@midscene/shared/mcp/chrome-path';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport type { Page as PuppeteerPage } from 'puppeteer';\nimport puppeteer from 'puppeteer-core';\nimport type { Browser, Page } from 'puppeteer-core';\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');\n\n/**\n * Persistent Puppeteer browser manager.\n * Launches a detached Chrome and persists the WS endpoint across CLI calls.\n */\nconst browserManager = {\n  activeBrowser: null as Browser | null,\n\n  async getOrLaunch(): Promise<{ browser: Browser; reused: boolean }> {\n    if (existsSync(ENDPOINT_FILE)) {\n      try {\n        const endpoint = (await readFile(ENDPOINT_FILE, '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(ENDPOINT_FILE);\n        } catch {}\n      }\n    }\n\n    const wsEndpoint = await this.launchDetachedChrome();\n    await writeFile(ENDPOINT_FILE, 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    if (!existsSync(ENDPOINT_FILE)) return;\n    try {\n      const endpoint = (await readFile(ENDPOINT_FILE, 'utf-8')).trim();\n      const browser = await puppeteer.connect({\n        browserWSEndpoint: endpoint,\n      });\n      await browser.close();\n    } catch {}\n    try {\n      await unlink(ENDPOINT_FILE);\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(): Promise<string> {\n    const chromePath = resolveChromePath();\n\n    await mkdir(USER_DATA_DIR, { recursive: true });\n\n    const args = [\n      '--headless=new',\n      `--user-data-dir=${USER_DATA_DIR}`,\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=1280,800',\n      '--force-color-profile=srgb',\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      const onData = (data: Buffer) => {\n        output += data.toString();\n        const match = output.match(/DevTools listening on (ws:\\/\\/[^\\s]+)/);\n        if (match) {\n          proc.stderr!.removeListener('data', onData);\n          resolve(match[1]);\n        }\n      };\n      proc.stderr!.on('data', onData);\n\n      proc.on('exit', (code) => {\n        proc.stderr!.removeListener('data', onData);\n        reject(\n          new Error(\n            `Chrome exited with code ${code} before DevTools was ready.\\nChrome stderr: ${output}\\nTip: try setting MIDSCENE_MCP_NO_SANDBOX=1 if running in a container.`,\n          ),\n        );\n      });\n\n      setTimeout(\n        () =>\n          reject(\n            new Error(\n              `Chrome launch timeout.\\nChrome stderr: ${output}\\nTip: try setting MIDSCENE_MCP_NO_SANDBOX=1 if running in a container.`,\n            ),\n          ),\n        15000,\n      );\n    });\n  },\n};\n\n/**\n * Tools manager for Web Puppeteer-mode MCP.\n * Uses a persistent headless Chrome browser that survives across CLI calls.\n */\nexport class WebPuppeteerMidsceneTools extends BaseMidsceneTools<PuppeteerAgent> {\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(navigateToUrl?: string): Promise<PuppeteerAgent> {\n    // Re-init if URL provided\n    if (this.agent && navigateToUrl) {\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 browserManager.getOrLaunch();\n    browserManager.activeBrowser = browser;\n\n    const pages = await browser.pages();\n    let page: Page;\n\n    if (navigateToUrl) {\n      page = await browser.newPage();\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    }\n\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage);\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    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: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to use current page)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Destroy existing agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n\n          this.agent = await this.ensureAgent(url);\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          }\n          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          }\n          await browserManager.closeBrowser();\n          return this.buildTextResult('Browser closed');\n        },\n      },\n    ];\n  }\n}\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","ENDPOINT_FILE","join","tmpdir","USER_DATA_DIR","browserManager","existsSync","endpoint","readFile","browser","puppeteer","unlink","wsEndpoint","writeFile","chromePath","resolveChromePath","mkdir","args","proc","spawn","Promise","resolve","reject","output","onData","data","match","code","Error","setTimeout","WebPuppeteerMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","navigateToUrl","undefined","reused","pages","page","webPages","p","PuppeteerAgent","z","url","screenshot","label"],"mappings":"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"}

package/dist/lib/mcp-tools.js

@@ -27,10 +27,10 @@ __webpack_require__.d(__webpack_exports__, {
     WebMidsceneTools: ()=>WebMidsceneTools
 });
 const core_namespaceObject = require("@midscene/core");
-const mcp_namespaceObject = require("@midscene/shared/mcp");
+const base_tools_namespaceObject = require("@midscene/shared/mcp/base-tools");
 const index_js_namespaceObject = require("./bridge-mode/index.js");
 const external_static_index_js_namespaceObject = require("./static/index.js");
-class WebMidsceneTools extends mcp_namespaceObject.BaseMidsceneTools {
+class WebMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools {
     createTemporaryDevice() {
         return new external_static_index_js_namespaceObject.StaticPage({
             screenshot: core_namespaceObject.ScreenshotItem.create('', Date.now()),

package/dist/lib/mcp-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/mcp-tools.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { ScreenshotItem, z } from '@midscene/core';\nimport { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';\nimport { AgentOverChromeBridge } from './bridge-mode';\nimport { StaticPage } from './static';\n\n/**\n * Tools manager for Web bridge-mode MCP\n */\nexport class WebMidsceneTools extends BaseMidsceneTools<AgentOverChromeBridge> {\n  protected createTemporaryDevice() {\n    // Use require to avoid type incompatibility with DeviceAction vs ActionSpaceItem\n    // StaticPage.actionSpace() returns DeviceAction[] which is compatible at runtime\n    // Use screenshotBase64 field to avoid async ScreenshotItem.create()\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    openNewTabWithUrl?: string,\n  ): Promise<AgentOverChromeBridge> {\n    // Re-init if URL provided\n    if (this.agent && openNewTabWithUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect to current tab when no URL provided (handles CLI stateless calls)\n    this.agent = await this.initBridgeModeAgent(openNewTabWithUrl);\n\n    return this.agent;\n  }\n\n  private async initBridgeModeAgent(\n    url?: string,\n  ): Promise<AgentOverChromeBridge> {\n    const agent = new AgentOverChromeBridge({ closeConflictServer: true });\n\n    if (!url) {\n      await agent.connectCurrentTab();\n    } else {\n      await agent.connectNewTabWithUrl(url);\n    }\n\n    return agent;\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to web page. If URL provided, opens new tab; otherwise connects to current tab.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to connect current tab)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Bypass ensureAgent's URL check — directly init bridge agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n          this.agent = await this.initBridgeModeAgent(url);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current tab';\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 and release browser resources',\n        schema: {},\n        handler: this.createDisconnectHandler('web page'),\n      },\n    ];\n  }\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","WebMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","openNewTabWithUrl","error","console","undefined","url","agent","AgentOverChromeBridge","z","args","screenshot","label"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,eAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;;ACEO,MAAMI,yBAAyBC,oBAAAA,iBAAiBA;IAC3C,wBAAwB;QAIhC,OAAO,IAAIC,yCAAAA,UAAUA,CAAC;YACpB,YAAYC,qBAAAA,cAAAA,CAAAA,MAAqB,CAAC,IAAIC,KAAK,GAAG;YAC9C,UAAU;gBAAE,OAAO;gBAAM,QAAQ;YAAK;YACtC,0BAA0B;QAC5B;IACF;IAEA,MAAgB,YACdC,iBAA0B,EACM;QAEhC,IAAI,IAAI,CAAC,KAAK,IAAIA,mBAAmB;YACnC,IAAI;gBACF,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB,EAAE,OAAOC,OAAO;gBACdC,QAAQ,KAAK,CAAC,2CAA2CD;YAC3D;YACA,IAAI,CAAC,KAAK,GAAGE;QACf;QAEA,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK;QAGjC,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACH;QAE5C,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,MAAc,oBACZI,GAAY,EACoB;QAChC,MAAMC,QAAQ,IAAIC,yBAAAA,qBAAqBA,CAAC;YAAE,qBAAqB;QAAK;QAEpE,IAAKF,KAGH,MAAMC,MAAM,oBAAoB,CAACD;aAFjC,MAAMC,MAAM,iBAAiB;QAK/B,OAAOA;IACT;IAEU,uBAAyC;QACjD,OAAO;YACL;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ;oBACN,KAAKE,qBAAAA,CAAAA,CAAAA,MACI,GACN,GAAG,GACH,QAAQ,GACR,QAAQ,CAAC;gBACd;gBACA,SAAS,OAAOC;oBACd,MAAM,EAAEJ,GAAG,EAAE,GAAGI;oBAGhB,IAAI,IAAI,CAAC,KAAK,EAAE;wBACd,IAAI;4BACF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO;wBAC1B,EAAE,OAAM,CAAC;wBACT,IAAI,CAAC,KAAK,GAAGL;oBACf;oBACA,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACC;oBAE5C,MAAMK,aAAa,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC1C,MAAMC,QAAQN,OAAO;oBAErB,OAAO;wBACL,SAAS;4BACP;gCAAE,MAAM;gCAAQ,MAAM,CAAC,cAAc,EAAEM,OAAO;4BAAC;+BAC3CD,aAAa,IAAI,CAAC,sBAAsB,CAACA,cAAc,EAAE;yBAC9D;oBACH;gBACF;YACF;YACA;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ,CAAC;gBACT,SAAS,IAAI,CAAC,uBAAuB,CAAC;YACxC;SACD;IACH;AACF"}
+{"version":3,"file":"mcp-tools.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/mcp-tools.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { ScreenshotItem, z } from '@midscene/core';\nimport { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport { AgentOverChromeBridge } from './bridge-mode';\nimport { StaticPage } from './static';\n\n/**\n * Tools manager for Web bridge-mode MCP\n */\nexport class WebMidsceneTools extends BaseMidsceneTools<AgentOverChromeBridge> {\n  protected createTemporaryDevice() {\n    // Use require to avoid type incompatibility with DeviceAction vs ActionSpaceItem\n    // StaticPage.actionSpace() returns DeviceAction[] which is compatible at runtime\n    // Use screenshotBase64 field to avoid async ScreenshotItem.create()\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: { width: 1920, height: 1080 },\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    openNewTabWithUrl?: string,\n  ): Promise<AgentOverChromeBridge> {\n    // Re-init if URL provided\n    if (this.agent && openNewTabWithUrl) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (error) {\n        console.debug('Failed to destroy agent during re-init:', error);\n      }\n      this.agent = undefined;\n    }\n\n    if (this.agent) return this.agent;\n\n    // Connect to current tab when no URL provided (handles CLI stateless calls)\n    this.agent = await this.initBridgeModeAgent(openNewTabWithUrl);\n\n    return this.agent;\n  }\n\n  private async initBridgeModeAgent(\n    url?: string,\n  ): Promise<AgentOverChromeBridge> {\n    const agent = new AgentOverChromeBridge({ closeConflictServer: true });\n\n    if (!url) {\n      await agent.connectCurrentTab();\n    } else {\n      await agent.connectNewTabWithUrl(url);\n    }\n\n    return agent;\n  }\n\n  protected preparePlatformTools(): ToolDefinition[] {\n    return [\n      {\n        name: 'web_connect',\n        description:\n          'Connect to web page. If URL provided, opens new tab; otherwise connects to current tab.',\n        schema: {\n          url: z\n            .string()\n            .url()\n            .optional()\n            .describe('URL to open in new tab (omit to connect current tab)'),\n        },\n        handler: async (args) => {\n          const { url } = args as { url?: string };\n\n          // Bypass ensureAgent's URL check — directly init bridge agent\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n          }\n          this.agent = await this.initBridgeModeAgent(url);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current tab';\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 and release browser resources',\n        schema: {},\n        handler: this.createDisconnectHandler('web page'),\n      },\n    ];\n  }\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","WebMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","openNewTabWithUrl","error","console","undefined","url","agent","AgentOverChromeBridge","z","args","screenshot","label"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,eAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;;ACGO,MAAMI,yBAAyBC,2BAAAA,iBAAiBA;IAC3C,wBAAwB;QAIhC,OAAO,IAAIC,yCAAAA,UAAUA,CAAC;YACpB,YAAYC,qBAAAA,cAAAA,CAAAA,MAAqB,CAAC,IAAIC,KAAK,GAAG;YAC9C,UAAU;gBAAE,OAAO;gBAAM,QAAQ;YAAK;YACtC,0BAA0B;QAC5B;IACF;IAEA,MAAgB,YACdC,iBAA0B,EACM;QAEhC,IAAI,IAAI,CAAC,KAAK,IAAIA,mBAAmB;YACnC,IAAI;gBACF,MAAM,IAAI,CAAC,KAAK,EAAE;YACpB,EAAE,OAAOC,OAAO;gBACdC,QAAQ,KAAK,CAAC,2CAA2CD;YAC3D;YACA,IAAI,CAAC,KAAK,GAAGE;QACf;QAEA,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK;QAGjC,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACH;QAE5C,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,MAAc,oBACZI,GAAY,EACoB;QAChC,MAAMC,QAAQ,IAAIC,yBAAAA,qBAAqBA,CAAC;YAAE,qBAAqB;QAAK;QAEpE,IAAKF,KAGH,MAAMC,MAAM,oBAAoB,CAACD;aAFjC,MAAMC,MAAM,iBAAiB;QAK/B,OAAOA;IACT;IAEU,uBAAyC;QACjD,OAAO;YACL;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ;oBACN,KAAKE,qBAAAA,CAAAA,CAAAA,MACI,GACN,GAAG,GACH,QAAQ,GACR,QAAQ,CAAC;gBACd;gBACA,SAAS,OAAOC;oBACd,MAAM,EAAEJ,GAAG,EAAE,GAAGI;oBAGhB,IAAI,IAAI,CAAC,KAAK,EAAE;wBACd,IAAI;4BACF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO;wBAC1B,EAAE,OAAM,CAAC;wBACT,IAAI,CAAC,KAAK,GAAGL;oBACf;oBACA,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAACC;oBAE5C,MAAMK,aAAa,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAC1C,MAAMC,QAAQN,OAAO;oBAErB,OAAO;wBACL,SAAS;4BACP;gCAAE,MAAM;gCAAQ,MAAM,CAAC,cAAc,EAAEM,OAAO;4BAAC;+BAC3CD,aAAa,IAAI,CAAC,sBAAsB,CAACA,cAAc,EAAE;yBAC9D;oBACH;gBACF;YACF;YACA;gBACE,MAAM;gBACN,aACE;gBACF,QAAQ,CAAC;gBACT,SAAS,IAAI,CAAC,uBAAuB,CAAC;YACxC;SACD;IACH;AACF"}

package/dist/types/mcp-tools-cdp.d.ts

@@ -1,4 +1,5 @@
-import { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';
+import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
+import type { ToolDefinition } from '@midscene/shared/mcp/types';
 import { PuppeteerAgent } from './puppeteer';
 import { StaticPage } from './static';
 /**

package/dist/types/mcp-tools-puppeteer.d.ts

@@ -1,4 +1,5 @@
-import { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';
+import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
+import type { ToolDefinition } from '@midscene/shared/mcp/types';
 import { PuppeteerAgent } from './puppeteer';
 import { StaticPage } from './static';
 /**

package/dist/types/mcp-tools.d.ts

@@ -1,4 +1,5 @@
-import { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';
+import { BaseMidsceneTools } from '@midscene/shared/mcp/base-tools';
+import type { ToolDefinition } from '@midscene/shared/mcp/types';
 import { AgentOverChromeBridge } from './bridge-mode';
 import { StaticPage } from './static';
 /**

package/package.json

@@ -8,7 +8,7 @@
     "Browser use",
     "Android use"
   ],
-  "version": "1.7.5-beta-20260420032657.0",
+  "version": "1.7.5-beta-20260420052829.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -110,9 +110,9 @@
     "socket.io": "^4.8.1",
     "socket.io-client": "4.8.1",
     "ws": "^8.18.1",
-    "@midscene/playground": "1.7.5-beta-20260420032657.0",
-    "@midscene/core": "1.7.5-beta-20260420032657.0",
-    "@midscene/shared": "1.7.5-beta-20260420032657.0"
+    "@midscene/core": "1.7.5-beta-20260420052829.0",
+    "@midscene/shared": "1.7.5-beta-20260420052829.0",
+    "@midscene/playground": "1.7.5-beta-20260420052829.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.45.0",