@midscene/web 1.9.8 → 1.10.1-beta-20260624112700.0

package/dist/types/cdp-proxy.d.ts

@@ -22,7 +22,7 @@
  *  3. SIGTERM / SIGINT.
  *  4. Duplicate proxy detected on startup (exits 0 with stderr notice).
  *
- * Usage (spawned by mcp-tools-cdp.ts):
+ * Usage (spawned by agent-tools-cdp.ts):
  *   node cdp-proxy.js <chrome-ws-endpoint>
  *
  * On startup, prints the proxy endpoint to stdout as a single JSON line:

package/dist/types/index.d.ts

@@ -4,6 +4,6 @@ export { Agent as PageAgent, type AgentOpt } from '@midscene/core/agent';
 export { PuppeteerAgent } from './puppeteer';
 export { PlaywrightAgent } from './playwright';
 export { StaticPageAgent, StaticPage } from './static';
-export { WebMidsceneTools } from './mcp-tools';
+export { WebMidsceneTools } from './agent-tools';
 export { webPlaygroundPlatform } from './platform';
-export { WebCdpMidsceneTools } from './mcp-tools-cdp';
+export { WebCdpMidsceneTools } from './agent-tools-cdp';

package/dist/types/puppeteer/base-page.d.ts

@@ -41,7 +41,7 @@ export declare class Page<AgentType extends 'puppeteer' | 'playwright', Interfac
     size(): Promise<Size>;
     screenshotBase64(): Promise<string>;
     private screenshotBase64ByPlaywrightCdp;
-    private createScreencastCdpSession;
+    private createPageCdpSession;
     waitForDomQuiet(opts?: {
         quietMs?: number;
         timeoutMs?: number;
@@ -79,6 +79,7 @@ export declare class Page<AgentType extends 'puppeteer' | 'playwright', Interfac
         down: (key: KeyInput) => Promise<void>;
         up: (key: KeyInput) => Promise<void>;
     };
+    private selectAllByCdp;
     clearInput(element?: ElementInfo): Promise<void>;
     private everMoved;
     private moveToPointBeforeScroll;
@@ -117,12 +118,4 @@ export declare class Page<AgentType extends 'puppeteer' | 'playwright', Interfac
     }>;
 }
 export declare function forceClosePopup(page: PuppeteerPage | PlaywrightPage, debugProfile: DebugFunction): void;
-/**
- * Force Chrome to render select elements using base-select appearance instead of OS-native rendering.
- * This makes select elements visible in screenshots captured by Playwright/Puppeteer.
- *
- * Reference: https://developer.chrome.com/blog/a-customizable-select
- *
- * Adds a style tag with CSS rules to make all select elements use base-select appearance.
- */
 export declare function forceChromeSelectRendering(page: PuppeteerPage | PlaywrightPage): void;

package/dist/types/static/static-page.d.ts

@@ -1,7 +1,14 @@
-import type { DeviceAction, Point, UIContext } from '@midscene/core';
+import type { DeviceAction, Point, ScreenshotRef, UIContext } from '@midscene/core';
 import type { AbstractInterface } from '@midscene/core/device';
 import { type InputPrimitives } from '@midscene/core/device';
-type StaticPageUIContext = Omit<UIContext, 'deprecatedDpr'>;
+type SerializedStaticScreenshot = {
+    base64?: unknown;
+    _base64?: unknown;
+    type?: unknown;
+} & Partial<Omit<ScreenshotRef, 'type'>>;
+type StaticPageUIContext = Omit<UIContext, 'deprecatedDpr' | 'screenshot'> & {
+    screenshot: UIContext['screenshot'] | SerializedStaticScreenshot;
+};
 export default class StaticPage implements AbstractInterface {
     interfaceType: string;
     private uiContext;

package/dist/types/web-element.d.ts

@@ -20,6 +20,9 @@ export type WebPageOpt = {
      * Reference: https://developer.chrome.com/blog/a-customizable-select
      *
      * When enabled, adds a style tag with `select { appearance: base-select !important; }` to the page.
+     *
+     * Defaults to `true`. Set to `false` to opt out (e.g. on older Chrome/driver
+     * versions that do not support `appearance: base-select`).
      */
     forceChromeSelectRendering?: boolean;
     beforeInvokeAction?: () => Promise<void>;

package/package.json

@@ -8,7 +8,7 @@
     "Browser use",
     "Android use"
   ],
-  "version": "1.9.8",
+  "version": "1.10.1-beta-20260624112700.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -84,11 +84,6 @@
       "types": "./dist/types/static/index.d.ts",
       "require": "./dist/lib/static/index.js",
       "import": "./dist/es/static/index.mjs"
-    },
-    "./mcp-server": {
-      "types": "./dist/types/mcp-server.d.ts",
-      "import": "./dist/es/mcp-server.mjs",
-      "require": "./dist/lib/mcp-server.js"
     }
   },
   "bin": {
@@ -111,9 +106,9 @@
     "socket.io": "^4.8.1",
     "socket.io-client": "4.8.1",
     "ws": "^8.18.1",
-    "@midscene/shared": "1.9.8",
-    "@midscene/playground": "1.9.8",
-    "@midscene/core": "1.9.8"
+    "@midscene/core": "1.10.1-beta-20260624112700.0",
+    "@midscene/playground": "1.10.1-beta-20260624112700.0",
+    "@midscene/shared": "1.10.1-beta-20260624112700.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.45.0",

package/dist/es/mcp-server.mjs

@@ -1,35 +0,0 @@
-import { BaseMCPServer, createMCPServerLauncher } from "@midscene/shared/mcp";
-import { WebMidsceneTools } from "./mcp-tools.mjs";
-class WebMCPServer extends BaseMCPServer {
-    createToolsManager() {
-        return new WebMidsceneTools();
-    }
-    constructor(toolsManager){
-        super({
-            name: '@midscene/web-bridge-mcp',
-            version: "1.9.8",
-            description: 'Control the browser using natural language commands'
-        }, toolsManager);
-    }
-}
-function mcpServerForAgent(agent) {
-    return createMCPServerLauncher({
-        agent,
-        platformName: 'Web',
-        ToolsManagerClass: WebMidsceneTools,
-        MCPServerClass: WebMCPServer
-    });
-}
-async function mcpKitForAgent(agent) {
-    const toolsManager = new WebMidsceneTools();
-    const webAgent = agent;
-    toolsManager.setAgent(webAgent);
-    await toolsManager.initTools();
-    return {
-        description: 'Midscene Bridge MCP Server: Control the browser using natural language commands for navigation, clicking, input, hovering, screenshots waitFor, and achieving goals.',
-        tools: toolsManager.getToolDefinitions()
-    };
-}
-export { WebMCPServer, mcpKitForAgent, mcpServerForAgent };
-
-//# sourceMappingURL=mcp-server.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server.mjs","sources":["../../src/mcp-server.ts"],"sourcesContent":["import type { GenericAgent } from '@midscene/shared/mcp';\nimport {\n  BaseMCPServer,\n  type Tool,\n  createMCPServerLauncher,\n} from '@midscene/shared/mcp';\nimport type { AgentOverChromeBridge } from './bridge-mode';\nimport { WebMidsceneTools } from './mcp-tools';\n\ndeclare const __VERSION__: string;\n\n/**\n * Web MCP Server class\n */\nexport class WebMCPServer extends BaseMCPServer {\n  constructor(toolsManager?: WebMidsceneTools) {\n    super(\n      {\n        name: '@midscene/web-bridge-mcp',\n        version: __VERSION__,\n        description: 'Control the browser using natural language commands',\n      },\n      toolsManager,\n    );\n  }\n\n  protected createToolsManager(): WebMidsceneTools {\n    return new WebMidsceneTools();\n  }\n}\n\n/**\n * Create an MCP server launcher for a specific Agent\n */\nexport function mcpServerForAgent(agent: GenericAgent) {\n  return createMCPServerLauncher({\n    agent,\n    platformName: 'Web',\n    ToolsManagerClass: WebMidsceneTools,\n    MCPServerClass: WebMCPServer,\n  });\n}\n\n/**\n * Create MCP kit for a specific Agent\n */\nexport async function mcpKitForAgent(agent: GenericAgent): Promise<{\n  description: string;\n  tools: Tool[];\n}> {\n  const toolsManager = new WebMidsceneTools();\n\n  // Convert to AgentOverChromeBridge for Web tools manager\n  const webAgent = agent as AgentOverChromeBridge;\n  toolsManager.setAgent(webAgent);\n  await toolsManager.initTools();\n\n  return {\n    description:\n      'Midscene Bridge MCP Server: Control the browser using natural language commands for navigation, clicking, input, hovering, screenshots waitFor, and achieving goals.',\n    tools: toolsManager.getToolDefinitions(),\n  };\n}\n"],"names":["WebMCPServer","BaseMCPServer","WebMidsceneTools","toolsManager","__VERSION__","mcpServerForAgent","agent","createMCPServerLauncher","mcpKitForAgent","webAgent"],"mappings":";;AAcO,MAAMA,qBAAqBC;IAYtB,qBAAuC;QAC/C,OAAO,IAAIC;IACb;IAbA,YAAYC,YAA+B,CAAE;QAC3C,KAAK,CACH;YACE,MAAM;YACN,SAASC;YACT,aAAa;QACf,GACAD;IAEJ;AAKF;AAKO,SAASE,kBAAkBC,KAAmB;IACnD,OAAOC,wBAAwB;QAC7BD;QACA,cAAc;QACd,mBAAmBJ;QACnB,gBAAgBF;IAClB;AACF;AAKO,eAAeQ,eAAeF,KAAmB;IAItD,MAAMH,eAAe,IAAID;IAGzB,MAAMO,WAAWH;IACjBH,aAAa,QAAQ,CAACM;IACtB,MAAMN,aAAa,SAAS;IAE5B,OAAO;QACL,aACE;QACF,OAAOA,aAAa,kBAAkB;IACxC;AACF"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools-cdp.mjs","sources":["../../src/mcp-tools-cdp.ts"],"sourcesContent":["import { ScreenshotItem } from '@midscene/core';\nimport { getDebug } from '@midscene/shared/logger';\nimport {\n  extractAgentBehaviorInitArgs,\n  getAgentInitArgsSignature,\n  shouldRebuildAgentForInitArgs,\n} from '@midscene/shared/mcp/agent-behavior-init-args';\nimport {\n  BaseMidsceneTools,\n  type InitArgSpec,\n} 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 { getProxyEndpoint } from './cdp-proxy-manager';\nimport {\n  cleanupTargetIdFile,\n  readSavedTargetId,\n  saveTargetId,\n} from './cdp-target-store';\nimport { defaultStaticPageViewportSize } from './common/viewport';\nimport {\n  type WebAgentInitArgs,\n  adaptWebAgentInitArgs,\n  webAgentInitArgShape,\n} from './mcp-agent-init-args';\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 * puppeteer-core does not expose a public method for the underlying CDP\n * target id, so we reach into `_targetId`. Centralised here so a future\n * puppeteer release exposing this properly only requires one change.\n * 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/**\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<\n  PuppeteerAgent,\n  WebAgentInitArgs\n> {\n  protected getCliReportSessionName() {\n    return 'midscene-web';\n  }\n  private cdpEndpoint: string;\n  private activeBrowser: Browser | null = null;\n  private lastInitArgsSignature?: string;\n\n  constructor(cdpEndpoint: string) {\n    super();\n    this.cdpEndpoint = cdpEndpoint;\n  }\n\n  protected readonly initArgSpec: InitArgSpec<WebAgentInitArgs> = {\n    namespace: 'web',\n    shape: webAgentInitArgShape,\n    cli: {\n      preferBareKeys: true,\n    },\n    adapt: adaptWebAgentInitArgs,\n  };\n\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: defaultStaticPageViewportSize,\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    initArgs?: WebAgentInitArgs,\n  ): Promise<PuppeteerAgent> {\n    const navigateToUrl = initArgs?.url;\n    const nextSignature = getAgentInitArgsSignature(initArgs);\n    const shouldNavigateToUrl = typeof navigateToUrl === 'string';\n\n    if (\n      this.agent &&\n      (shouldNavigateToUrl ||\n        shouldRebuildAgentForInitArgs(\n          this.lastInitArgsSignature,\n          nextSignature,\n        ))\n    ) {\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    const reportOptions = this.readCliReportAgentOptions();\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage, {\n      ...(extractAgentBehaviorInitArgs(initArgs) ?? {}),\n      ...(reportOptions ?? {}),\n    });\n    this.lastInitArgsSignature = nextSignature;\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    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: this.getAgentInitArgSchema(),\n        cli: this.getAgentInitArgCliMetadata(),\n        handler: async (args) => {\n          const initArgs = this.extractAgentInitParam(args);\n          const url = initArgs?.url;\n\n          // Explicit connect always starts a fresh page session.\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during connect:', e);\n            }\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n\n          const reportSession = this.createNewCliReportSession(\n            url ?? 'current-page',\n          );\n          this.commitCliReportSession(reportSession);\n          this.agent = await this.ensureAgent(initArgs);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current page';\n\n          return {\n            content: [\n              { type: 'text', text: `Connected 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            this.lastInitArgsSignature = 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"],"names":["debug","getDebug","CDP_TARGET_DISCOVERY_DELAY_MS","getTargetId","page","WebCdpMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","defaultStaticPageViewportSize","initArgs","navigateToUrl","nextSignature","getAgentInitArgsSignature","shouldNavigateToUrl","shouldRebuildAgentForInitArgs","error","console","undefined","endpoint","getProxyEndpoint","puppeteer","browser","pages","Promise","r","setTimeout","webPages","p","savedTargetId","readSavedTargetId","matchedPage","targetId","saveTargetId","reportOptions","PuppeteerAgent","extractAgentBehaviorInitArgs","args","url","e","reportSession","screenshot","label","cleanupTargetIdFile","cdpEndpoint","webAgentInitArgShape","adaptWebAgentInitArgs"],"mappings":"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"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools.mjs","sources":["../../src/mcp-tools.ts"],"sourcesContent":["import { ScreenshotItem } from '@midscene/core';\nimport {\n  extractAgentBehaviorInitArgs,\n  getAgentInitArgsSignature,\n  shouldRebuildAgentForInitArgs,\n} from '@midscene/shared/mcp/agent-behavior-init-args';\nimport {\n  BaseMidsceneTools,\n  type InitArgSpec,\n} from '@midscene/shared/mcp/base-tools';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport { AgentOverChromeBridge } from './bridge-mode';\nimport { defaultStaticPageViewportSize } from './common/viewport';\nimport {\n  type WebAgentInitArgs,\n  adaptWebAgentInitArgs,\n  webAgentInitArgShape,\n} from './mcp-agent-init-args';\nimport { StaticPage } from './static';\n\n/**\n * Tools manager for Web bridge-mode MCP\n */\nexport class WebMidsceneTools extends BaseMidsceneTools<\n  AgentOverChromeBridge,\n  WebAgentInitArgs\n> {\n  private lastInitArgsSignature?: string;\n\n  protected getCliReportSessionName() {\n    return 'midscene-web';\n  }\n\n  protected readonly initArgSpec: InitArgSpec<WebAgentInitArgs> = {\n    namespace: 'web',\n    shape: webAgentInitArgShape,\n    cli: {\n      preferBareKeys: true,\n    },\n    adapt: adaptWebAgentInitArgs,\n  };\n\n  protected createTemporaryDevice() {\n    // 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: defaultStaticPageViewportSize,\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    initArgs?: WebAgentInitArgs,\n  ): Promise<AgentOverChromeBridge> {\n    const nextSignature = getAgentInitArgsSignature(initArgs);\n    const shouldOpenUrl = typeof initArgs?.url === 'string';\n\n    if (\n      this.agent &&\n      (shouldOpenUrl ||\n        shouldRebuildAgentForInitArgs(\n          this.lastInitArgsSignature,\n          nextSignature,\n        ))\n    ) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (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(initArgs);\n    this.lastInitArgsSignature = nextSignature;\n\n    return this.agent;\n  }\n\n  private async initBridgeModeAgent(\n    initArgs?: WebAgentInitArgs,\n  ): Promise<AgentOverChromeBridge> {\n    const url = initArgs?.url;\n    const reportOptions = this.readCliReportAgentOptions();\n    const agent = new AgentOverChromeBridge({\n      closeConflictServer: true,\n      ...(extractAgentBehaviorInitArgs(initArgs) ?? {}),\n      ...(reportOptions ?? {}),\n    });\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: this.getAgentInitArgSchema(),\n        cli: this.getAgentInitArgCliMetadata(),\n        handler: async (args) => {\n          const initArgs = this.extractAgentInitParam(args);\n          const url = initArgs?.url;\n\n          // Explicit connect always starts a fresh bridge session.\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n          const reportSession = this.createNewCliReportSession(\n            url ?? 'current-tab',\n          );\n          this.commitCliReportSession(reportSession);\n          this.agent = await this.ensureAgent(initArgs);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current 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: async () => {\n          if (!this.agent) {\n            return this.buildTextResult('No active connection to disconnect');\n          }\n\n          try {\n            await this.agent.destroy?.();\n          } catch {}\n          this.agent = undefined;\n          this.lastInitArgsSignature = undefined;\n\n          return this.buildTextResult('Disconnected from web page');\n        },\n      },\n    ];\n  }\n}\n"],"names":["WebMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","defaultStaticPageViewportSize","initArgs","nextSignature","getAgentInitArgsSignature","shouldOpenUrl","shouldRebuildAgentForInitArgs","error","console","undefined","url","reportOptions","agent","AgentOverChromeBridge","extractAgentBehaviorInitArgs","args","reportSession","screenshot","label","webAgentInitArgShape","adaptWebAgentInitArgs"],"mappings":"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"}

package/dist/lib/mcp-server.js

@@ -1,75 +0,0 @@
-"use strict";
-var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.d = (exports1, definition)=>{
-        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
-            enumerable: true,
-            get: definition[key]
-        });
-    };
-})();
-(()=>{
-    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
-})();
-(()=>{
-    __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
-            value: 'Module'
-        });
-        Object.defineProperty(exports1, '__esModule', {
-            value: true
-        });
-    };
-})();
-var __webpack_exports__ = {};
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-    mcpKitForAgent: ()=>mcpKitForAgent,
-    mcpServerForAgent: ()=>mcpServerForAgent,
-    WebMCPServer: ()=>WebMCPServer
-});
-const mcp_namespaceObject = require("@midscene/shared/mcp");
-const external_mcp_tools_js_namespaceObject = require("./mcp-tools.js");
-class WebMCPServer extends mcp_namespaceObject.BaseMCPServer {
-    createToolsManager() {
-        return new external_mcp_tools_js_namespaceObject.WebMidsceneTools();
-    }
-    constructor(toolsManager){
-        super({
-            name: '@midscene/web-bridge-mcp',
-            version: "1.9.8",
-            description: 'Control the browser using natural language commands'
-        }, toolsManager);
-    }
-}
-function mcpServerForAgent(agent) {
-    return (0, mcp_namespaceObject.createMCPServerLauncher)({
-        agent,
-        platformName: 'Web',
-        ToolsManagerClass: external_mcp_tools_js_namespaceObject.WebMidsceneTools,
-        MCPServerClass: WebMCPServer
-    });
-}
-async function mcpKitForAgent(agent) {
-    const toolsManager = new external_mcp_tools_js_namespaceObject.WebMidsceneTools();
-    const webAgent = agent;
-    toolsManager.setAgent(webAgent);
-    await toolsManager.initTools();
-    return {
-        description: 'Midscene Bridge MCP Server: Control the browser using natural language commands for navigation, clicking, input, hovering, screenshots waitFor, and achieving goals.',
-        tools: toolsManager.getToolDefinitions()
-    };
-}
-exports.WebMCPServer = __webpack_exports__.WebMCPServer;
-exports.mcpKitForAgent = __webpack_exports__.mcpKitForAgent;
-exports.mcpServerForAgent = __webpack_exports__.mcpServerForAgent;
-for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "WebMCPServer",
-    "mcpKitForAgent",
-    "mcpServerForAgent"
-].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
-Object.defineProperty(exports, '__esModule', {
-    value: true
-});
-
-//# sourceMappingURL=mcp-server.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server.js","sources":["webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/mcp-server.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 type { GenericAgent } from '@midscene/shared/mcp';\nimport {\n  BaseMCPServer,\n  type Tool,\n  createMCPServerLauncher,\n} from '@midscene/shared/mcp';\nimport type { AgentOverChromeBridge } from './bridge-mode';\nimport { WebMidsceneTools } from './mcp-tools';\n\ndeclare const __VERSION__: string;\n\n/**\n * Web MCP Server class\n */\nexport class WebMCPServer extends BaseMCPServer {\n  constructor(toolsManager?: WebMidsceneTools) {\n    super(\n      {\n        name: '@midscene/web-bridge-mcp',\n        version: __VERSION__,\n        description: 'Control the browser using natural language commands',\n      },\n      toolsManager,\n    );\n  }\n\n  protected createToolsManager(): WebMidsceneTools {\n    return new WebMidsceneTools();\n  }\n}\n\n/**\n * Create an MCP server launcher for a specific Agent\n */\nexport function mcpServerForAgent(agent: GenericAgent) {\n  return createMCPServerLauncher({\n    agent,\n    platformName: 'Web',\n    ToolsManagerClass: WebMidsceneTools,\n    MCPServerClass: WebMCPServer,\n  });\n}\n\n/**\n * Create MCP kit for a specific Agent\n */\nexport async function mcpKitForAgent(agent: GenericAgent): Promise<{\n  description: string;\n  tools: Tool[];\n}> {\n  const toolsManager = new WebMidsceneTools();\n\n  // Convert to AgentOverChromeBridge for Web tools manager\n  const webAgent = agent as AgentOverChromeBridge;\n  toolsManager.setAgent(webAgent);\n  await toolsManager.initTools();\n\n  return {\n    description:\n      'Midscene Bridge MCP Server: Control the browser using natural language commands for navigation, clicking, input, hovering, screenshots waitFor, and achieving goals.',\n    tools: toolsManager.getToolDefinitions(),\n  };\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","WebMCPServer","BaseMCPServer","WebMidsceneTools","toolsManager","__VERSION__","mcpServerForAgent","agent","createMCPServerLauncher","mcpKitForAgent","webAgent"],"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;;;;;;;;;;;ACQO,MAAMI,qBAAqBC,oBAAAA,aAAaA;IAYnC,qBAAuC;QAC/C,OAAO,IAAIC,sCAAAA,gBAAgBA;IAC7B;IAbA,YAAYC,YAA+B,CAAE;QAC3C,KAAK,CACH;YACE,MAAM;YACN,SAASC;YACT,aAAa;QACf,GACAD;IAEJ;AAKF;AAKO,SAASE,kBAAkBC,KAAmB;IACnD,OAAOC,AAAAA,IAAAA,oBAAAA,uBAAAA,AAAAA,EAAwB;QAC7BD;QACA,cAAc;QACd,mBAAmBJ,sCAAAA,gBAAgBA;QACnC,gBAAgBF;IAClB;AACF;AAKO,eAAeQ,eAAeF,KAAmB;IAItD,MAAMH,eAAe,IAAID,sCAAAA,gBAAgBA;IAGzC,MAAMO,WAAWH;IACjBH,aAAa,QAAQ,CAACM;IACtB,MAAMN,aAAa,SAAS;IAE5B,OAAO;QACL,aACE;QACF,OAAOA,aAAa,kBAAkB;IACxC;AACF"}

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

@@ -1 +0,0 @@
-{"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 { ScreenshotItem } from '@midscene/core';\nimport { getDebug } from '@midscene/shared/logger';\nimport {\n  extractAgentBehaviorInitArgs,\n  getAgentInitArgsSignature,\n  shouldRebuildAgentForInitArgs,\n} from '@midscene/shared/mcp/agent-behavior-init-args';\nimport {\n  BaseMidsceneTools,\n  type InitArgSpec,\n} 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 { getProxyEndpoint } from './cdp-proxy-manager';\nimport {\n  cleanupTargetIdFile,\n  readSavedTargetId,\n  saveTargetId,\n} from './cdp-target-store';\nimport { defaultStaticPageViewportSize } from './common/viewport';\nimport {\n  type WebAgentInitArgs,\n  adaptWebAgentInitArgs,\n  webAgentInitArgShape,\n} from './mcp-agent-init-args';\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 * puppeteer-core does not expose a public method for the underlying CDP\n * target id, so we reach into `_targetId`. Centralised here so a future\n * puppeteer release exposing this properly only requires one change.\n * 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/**\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<\n  PuppeteerAgent,\n  WebAgentInitArgs\n> {\n  protected getCliReportSessionName() {\n    return 'midscene-web';\n  }\n  private cdpEndpoint: string;\n  private activeBrowser: Browser | null = null;\n  private lastInitArgsSignature?: string;\n\n  constructor(cdpEndpoint: string) {\n    super();\n    this.cdpEndpoint = cdpEndpoint;\n  }\n\n  protected readonly initArgSpec: InitArgSpec<WebAgentInitArgs> = {\n    namespace: 'web',\n    shape: webAgentInitArgShape,\n    cli: {\n      preferBareKeys: true,\n    },\n    adapt: adaptWebAgentInitArgs,\n  };\n\n  protected createTemporaryDevice() {\n    return new StaticPage({\n      screenshot: ScreenshotItem.create('', Date.now()),\n      shotSize: defaultStaticPageViewportSize,\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    initArgs?: WebAgentInitArgs,\n  ): Promise<PuppeteerAgent> {\n    const navigateToUrl = initArgs?.url;\n    const nextSignature = getAgentInitArgsSignature(initArgs);\n    const shouldNavigateToUrl = typeof navigateToUrl === 'string';\n\n    if (\n      this.agent &&\n      (shouldNavigateToUrl ||\n        shouldRebuildAgentForInitArgs(\n          this.lastInitArgsSignature,\n          nextSignature,\n        ))\n    ) {\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    const reportOptions = this.readCliReportAgentOptions();\n    this.agent = new PuppeteerAgent(page as unknown as PuppeteerPage, {\n      ...(extractAgentBehaviorInitArgs(initArgs) ?? {}),\n      ...(reportOptions ?? {}),\n    });\n    this.lastInitArgsSignature = nextSignature;\n    return this.agent;\n  }\n\n  public async destroy(): Promise<void> {\n    await super.destroy();\n    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: this.getAgentInitArgSchema(),\n        cli: this.getAgentInitArgCliMetadata(),\n        handler: async (args) => {\n          const initArgs = this.extractAgentInitParam(args);\n          const url = initArgs?.url;\n\n          // Explicit connect always starts a fresh page session.\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch (e) {\n              console.debug('Failed to destroy agent during connect:', e);\n            }\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n\n          const reportSession = this.createNewCliReportSession(\n            url ?? 'current-page',\n          );\n          this.commitCliReportSession(reportSession);\n          this.agent = await this.ensureAgent(initArgs);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current page';\n\n          return {\n            content: [\n              { type: 'text', text: `Connected 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            this.lastInitArgsSignature = 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"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","debug","getDebug","CDP_TARGET_DISCOVERY_DELAY_MS","getTargetId","page","WebCdpMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","defaultStaticPageViewportSize","initArgs","navigateToUrl","nextSignature","getAgentInitArgsSignature","shouldNavigateToUrl","shouldRebuildAgentForInitArgs","error","console","undefined","endpoint","getProxyEndpoint","puppeteer","browser","pages","Promise","r","setTimeout","webPages","p","savedTargetId","readSavedTargetId","matchedPage","targetId","saveTargetId","reportOptions","PuppeteerAgent","extractAgentBehaviorInitArgs","args","url","e","reportSession","screenshot","label","cleanupTargetIdFile","cdpEndpoint","webAgentInitArgShape","adaptWebAgentInitArgs"],"mappings":"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"}

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

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

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

@@ -1 +0,0 @@
-{"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 } from '@midscene/core';\nimport {\n  extractAgentBehaviorInitArgs,\n  getAgentInitArgsSignature,\n  shouldRebuildAgentForInitArgs,\n} from '@midscene/shared/mcp/agent-behavior-init-args';\nimport {\n  BaseMidsceneTools,\n  type InitArgSpec,\n} from '@midscene/shared/mcp/base-tools';\nimport type { ToolDefinition } from '@midscene/shared/mcp/types';\nimport { AgentOverChromeBridge } from './bridge-mode';\nimport { defaultStaticPageViewportSize } from './common/viewport';\nimport {\n  type WebAgentInitArgs,\n  adaptWebAgentInitArgs,\n  webAgentInitArgShape,\n} from './mcp-agent-init-args';\nimport { StaticPage } from './static';\n\n/**\n * Tools manager for Web bridge-mode MCP\n */\nexport class WebMidsceneTools extends BaseMidsceneTools<\n  AgentOverChromeBridge,\n  WebAgentInitArgs\n> {\n  private lastInitArgsSignature?: string;\n\n  protected getCliReportSessionName() {\n    return 'midscene-web';\n  }\n\n  protected readonly initArgSpec: InitArgSpec<WebAgentInitArgs> = {\n    namespace: 'web',\n    shape: webAgentInitArgShape,\n    cli: {\n      preferBareKeys: true,\n    },\n    adapt: adaptWebAgentInitArgs,\n  };\n\n  protected createTemporaryDevice() {\n    // 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: defaultStaticPageViewportSize,\n      shrunkShotToLogicalRatio: 1,\n    });\n  }\n\n  protected async ensureAgent(\n    initArgs?: WebAgentInitArgs,\n  ): Promise<AgentOverChromeBridge> {\n    const nextSignature = getAgentInitArgsSignature(initArgs);\n    const shouldOpenUrl = typeof initArgs?.url === 'string';\n\n    if (\n      this.agent &&\n      (shouldOpenUrl ||\n        shouldRebuildAgentForInitArgs(\n          this.lastInitArgsSignature,\n          nextSignature,\n        ))\n    ) {\n      try {\n        await this.agent?.destroy?.();\n      } catch (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(initArgs);\n    this.lastInitArgsSignature = nextSignature;\n\n    return this.agent;\n  }\n\n  private async initBridgeModeAgent(\n    initArgs?: WebAgentInitArgs,\n  ): Promise<AgentOverChromeBridge> {\n    const url = initArgs?.url;\n    const reportOptions = this.readCliReportAgentOptions();\n    const agent = new AgentOverChromeBridge({\n      closeConflictServer: true,\n      ...(extractAgentBehaviorInitArgs(initArgs) ?? {}),\n      ...(reportOptions ?? {}),\n    });\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: this.getAgentInitArgSchema(),\n        cli: this.getAgentInitArgCliMetadata(),\n        handler: async (args) => {\n          const initArgs = this.extractAgentInitParam(args);\n          const url = initArgs?.url;\n\n          // Explicit connect always starts a fresh bridge session.\n          if (this.agent) {\n            try {\n              await this.agent.destroy?.();\n            } catch {}\n            this.agent = undefined;\n            this.lastInitArgsSignature = undefined;\n          }\n          const reportSession = this.createNewCliReportSession(\n            url ?? 'current-tab',\n          );\n          this.commitCliReportSession(reportSession);\n          this.agent = await this.ensureAgent(initArgs);\n\n          const screenshot = await this.agent.page?.screenshotBase64();\n          const label = url ?? 'current 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: async () => {\n          if (!this.agent) {\n            return this.buildTextResult('No active connection to disconnect');\n          }\n\n          try {\n            await this.agent.destroy?.();\n          } catch {}\n          this.agent = undefined;\n          this.lastInitArgsSignature = undefined;\n\n          return this.buildTextResult('Disconnected from web page');\n        },\n      },\n    ];\n  }\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","WebMidsceneTools","BaseMidsceneTools","StaticPage","ScreenshotItem","Date","defaultStaticPageViewportSize","initArgs","nextSignature","getAgentInitArgsSignature","shouldOpenUrl","shouldRebuildAgentForInitArgs","error","console","undefined","url","reportOptions","agent","AgentOverChromeBridge","extractAgentBehaviorInitArgs","args","reportSession","screenshot","label","webAgentInitArgShape","adaptWebAgentInitArgs"],"mappings":"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"}

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

@@ -1,26 +0,0 @@
-import type { GenericAgent } from '@midscene/shared/mcp';
-import { BaseMCPServer, type Tool } from '@midscene/shared/mcp';
-import { WebMidsceneTools } from './mcp-tools';
-/**
- * Web MCP Server class
- */
-export declare class WebMCPServer extends BaseMCPServer {
-    constructor(toolsManager?: WebMidsceneTools);
-    protected createToolsManager(): WebMidsceneTools;
-}
-/**
- * Create an MCP server launcher for a specific Agent
- */
-export declare function mcpServerForAgent(agent: GenericAgent): {
-    launch(options?: {
-        verbose?: boolean;
-    }): Promise<import("@midscene/shared/mcp").LaunchMCPServerResult>;
-    launchHttp(options: import("@midscene/shared/mcp").LaunchMCPServerOptions): Promise<import("@midscene/shared/mcp").LaunchMCPServerResult>;
-};
-/**
- * Create MCP kit for a specific Agent
- */
-export declare function mcpKitForAgent(agent: GenericAgent): Promise<{
-    description: string;
-    tools: Tool[];
-}>;