@mcp-b/chrome-devtools-mcp 2.1.0 → 2.2.0

package/build/src/trace-processing/parse.js

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { AgentFocus, TraceEngine, PerformanceTraceFormatter, PerformanceInsightFormatter, } from '../../vendor/chrome-devtools-frontend/mcp/mcp.js';
 import { logger } from '../logger.js';
-const engine = TraceEngine.TraceModel.Model.createWithAllHandlers();
+import { DevTools } from '../third_party/index.js';
+const engine = DevTools.TraceEngine.TraceModel.Model.createWithAllHandlers();
 export function traceResultIsSuccess(x) {
     return 'parsedTrace' in x;
 }
@@ -48,12 +48,12 @@ export async function parseRawTraceBuffer(buffer) {
 }
 const extraFormatDescriptions = `Information on performance traces may contain main thread activity represented as call frames and network requests.
 
-${PerformanceTraceFormatter.callFrameDataFormatDescription}
+${DevTools.PerformanceTraceFormatter.callFrameDataFormatDescription}
 
-${PerformanceTraceFormatter.networkDataFormatDescription}`;
+${DevTools.PerformanceTraceFormatter.networkDataFormatDescription}`;
 export function getTraceSummary(result) {
-    const focus = AgentFocus.fromParsedTrace(result.parsedTrace);
-    const formatter = new PerformanceTraceFormatter(focus);
+    const focus = DevTools.AgentFocus.fromParsedTrace(result.parsedTrace);
+    const formatter = new DevTools.PerformanceTraceFormatter(focus);
     const summaryText = formatter.formatTraceSummary();
     return `## Summary of Performance trace findings:
 ${summaryText}
@@ -79,6 +79,6 @@ export function getInsightOutput(result, insightSetId, insightName) {
             error: `No Insight with the name ${insightName} found. Double check the name you provided is accurate and try again.`,
         };
     }
-    const formatter = new PerformanceInsightFormatter(AgentFocus.fromParsedTrace(result.parsedTrace), matchingInsight);
+    const formatter = new DevTools.PerformanceInsightFormatter(DevTools.AgentFocus.fromParsedTrace(result.parsedTrace), matchingInsight);
     return { output: formatter.formatInsight() };
 }

package/build/src/types.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/build/src/utils/files.js

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+export async function saveTemporaryFile(data, filename) {
+    try {
+        const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'chrome-devtools-mcp-'));
+        const filepath = path.join(dir, filename);
+        await fs.writeFile(filepath, data);
+        return { filepath };
+    }
+    catch (err) {
+        throw new Error('Could not save a file', { cause: err });
+    }
+}

package/build/src/version.js

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// If moved update release-please config
+// x-release-please-start-version
+export const VERSION = '0.20.0';
+// x-release-please-end

package/package.json

@@ -1,32 +1,7 @@
 {
   "name": "@mcp-b/chrome-devtools-mcp",
-  "version": "2.1.0",
-  "description": "MCP server for Chrome DevTools with WebMCP integration for connecting to website MCP tools",
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "chrome",
-    "devtools",
-    "browser-automation",
-    "puppeteer",
-    "ai-agent",
-    "claude",
-    "cursor",
-    "copilot",
-    "gemini",
-    "webmcp",
-    "web-model-context",
-    "ai-tools",
-    "llm",
-    "ai-assistant",
-    "browser-testing",
-    "debugging",
-    "performance",
-    "screenshots",
-    "web-automation",
-    "anthropic",
-    "openai"
-  ],
+  "version": "2.2.0",
+  "description": "MCP server for Chrome DevTools",
   "homepage": "https://github.com/WebMCP-org/npm-packages/tree/main/packages/chrome-devtools-mcp#readme",
   "bugs": {
     "url": "https://github.com/WebMCP-org/npm-packages/issues"
@@ -39,62 +14,50 @@
   "license": "Apache-2.0",
   "author": "Google LLC",
   "type": "module",
-  "exports": {
-    ".": {
-      "types": "./build/src/index.d.ts",
-      "import": "./build/src/index.js",
-      "default": "./build/src/index.js"
-    }
+  "main": "./build/src/index.js",
+  "bin": {
+    "chrome-devtools": "./build/src/bin/chrome-devtools.js",
+    "chrome-devtools-mcp": "./build/src/bin/chrome-devtools-mcp.js"
   },
-  "main": "index.js",
-  "bin": "./build/src/index.js",
   "files": [
     "build/src",
-    "build/vendor",
     "LICENSE",
     "!*.tsbuildinfo"
   ],
-  "dependencies": {
-    "@composio/json-schema-to-zod": "^0.1.19",
-    "@modelcontextprotocol/sdk": "1.26.0",
-    "core-js": "3.48.0",
-    "debug": "4.4.3",
-    "esbuild": "^0.27.2",
-    "puppeteer": "24.37.2",
-    "puppeteer-core": "24.37.2",
-    "yargs": "18.0.0",
-    "zod": "3.25.76"
-  },
   "devDependencies": {
     "@eslint/js": "^9.35.0",
-    "@modelcontextprotocol/sdk": "1.26.0",
+    "@google/genai": "^1.37.0",
+    "@modelcontextprotocol/sdk": "1.27.1",
+    "@puppeteer/browsers": "2.13.0",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@stylistic/eslint-plugin": "^5.7.1",
+    "@stylistic/eslint-plugin": "^5.4.0",
     "@types/debug": "^4.1.12",
     "@types/filesystem": "^0.0.36",
-    "@types/node": "^24.3.3",
+    "@types/node": "25.0.0",
     "@types/sinon": "^21.0.0",
     "@types/yargs": "^17.0.33",
-    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1579812",
+    "chrome-devtools-frontend": "1.0.1596260",
     "core-js": "3.48.0",
     "debug": "4.4.3",
-    "eslint": "^9.39.2",
+    "eslint": "^9.35.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
-    "globals": "^16.4.0",
-    "prettier": "^3.8.1",
-    "puppeteer": "24.37.2",
-    "puppeteer-core": "24.37.2",
+    "globals": "^17.0.0",
+    "lighthouse": "13.0.3",
+    "prettier": "^3.6.2",
+    "puppeteer": "24.39.0",
+    "puppeteer-core": "24.39.0",
     "rollup": "4.59.0",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
-    "sinon": "^21.0.1",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.53.1",
+    "sinon": "^21.0.0",
+    "tiktoken": "^1.0.22",
+    "typescript": "5.9.2",
+    "typescript-eslint": "^8.43.0",
     "yargs": "18.0.0",
     "zod": "3.25.76"
   },
@@ -105,27 +68,32 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "mcpName": "@mcp-b/chrome-devtools-mcp",
   "upstream": {
     "repository": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
     "mcpName": "io.github.ChromeDevTools/chrome-devtools-mcp"
   },
   "scripts": {
-    "build": "rm -rf build/vendor build/node_modules build/tsconfig.tsbuildinfo && tsc && node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/post-build.ts",
-    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs",
+    "build": "npm run clean && tsc && node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/post-build.ts",
+    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs && node -e \"require('fs').rmSync('build/node_modules', {recursive: true, force: true})\" && node --experimental-strip-types scripts/append-lighthouse-notices.ts",
     "check-format": "eslint --cache . && prettier --check --cache .;",
     "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
-    "docs": "npm run build && npm run docs:generate && npm run format",
+    "cli:generate": "node --experimental-strip-types scripts/generate-cli.ts",
+    "count-tokens": "node --experimental-strip-types scripts/count_tokens.ts",
     "docs:generate": "node --experimental-strip-types scripts/generate-docs.ts",
+    "eval": "npm run build && node --experimental-strip-types scripts/eval_gemini.ts",
     "format": "eslint --cache --fix . && prettier --write --cache .",
+    "gen": "npm run build && npm run docs:generate && npm run cli:generate && npm run format",
     "start": "npm run build && node build/src/index.js",
     "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/index.js",
-    "test": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test \"build/tests/**/*.test.js\"",
-    "test:e2e": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test build/tests/webmcp.runtime-contract.e2e.test.js",
-    "test:node20": "node --require ./build/tests/setup.js --test-reporter spec --test-force-exit --test build/tests",
-    "test:only": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
-    "test:only:no-build": "node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-reporter spec --test-force-exit --test --test-only \"build/tests/**/*.test.js\"",
-    "test:update-snapshots": "npm run build && node --require ./build/tests/setup.js --no-warnings=ExperimentalWarning --test-force-exit --test --test-update-snapshots \"build/tests/**/*.test.js\"",
+    "test": "npm run build && node scripts/test.mjs",
+    "test:e2e": "npm run build && node scripts/test.mjs build/tests/e2e",
+    "test:no-build": "node scripts/test.mjs",
+    "test:only": "npm run build && node scripts/test.mjs --test-only",
+    "test:update-snapshots": "npm run build && node scripts/test.mjs --test-update-snapshots",
     "typecheck": "tsc --noEmit",
+    "update-lighthouse": "node --experimental-strip-types scripts/update-lighthouse.ts",
+    "verify-npm-package": "node scripts/verify-npm-package.mjs",
     "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts"
   }
 }

package/build/src/main.js

@@ -1,372 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import process from 'node:process';
-import './polyfill.js';
-import { connectToNewBrowser, disconnectBrowser, ensureBrowserConnected, ensureBrowserLaunched } from './browser.js';
-import { parseArguments } from './cli.js';
-import { loadIssueDescriptions } from './issue-descriptions.js';
-import { logger, saveLogsToFile } from './logger.js';
-import { McpContext } from './McpContext.js';
-import { McpResponse } from './McpResponse.js';
-import { Mutex } from './Mutex.js';
-import { McpServer, StdioServerTransport, SetLevelRequestSchema, zod, } from './third_party/index.js';
-import { registerPrompts } from './prompts/index.js';
-import { ToolCategory } from './tools/categories.js';
-import { tools } from './tools/tools.js';
-import { WebMCPToolHub } from './tools/WebMCPToolHub.js';
-/**
- * Package version (managed by release-please).
- * @remarks If moved, update release-please config.
- */
-// x-release-please-start-version
-const VERSION = '1.5.6';
-// x-release-please-end
-process.on('unhandledRejection', (reason, promise) => {
-    logger('Unhandled promise rejection', promise, reason);
-});
-/**
- * Cleanup handler for graceful shutdown.
- * Closes the session window when the MCP server is killed.
- */
-let isCleaningUp = false;
-async function cleanup() {
-    if (isCleaningUp)
-        return;
-    isCleaningUp = true;
-    logger('Shutting down MCP server...');
-    if (context) {
-        try {
-            await context.closeSessionWindow();
-        }
-        catch (err) {
-            logger('Error during cleanup:', err);
-        }
-    }
-    process.exit(0);
-}
-// Handle various termination signals
-process.on('SIGINT', () => {
-    logger('Received SIGINT');
-    cleanup();
-});
-process.on('SIGTERM', () => {
-    logger('Received SIGTERM');
-    cleanup();
-});
-process.on('SIGHUP', () => {
-    logger('Received SIGHUP');
-    cleanup();
-});
-export const args = parseArguments(VERSION);
-const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
-logger(`Starting Chrome DevTools MCP Server v${VERSION}`);
-const server = new McpServer({
-    name: 'chrome_devtools',
-    title: 'Chrome DevTools MCP server',
-    version: VERSION,
-}, { capabilities: { logging: {}, prompts: {}, tools: { listChanged: true } } });
-// Register WebMCP development prompts
-registerPrompts(server);
-server.server.setRequestHandler(SetLevelRequestSchema, () => {
-    return {};
-});
-/** Cached McpContext instance for the current browser. */
-let context;
-/**
- * Get or create the McpContext for browser operations.
- *
- * Handles browser connection/launch with the following priority:
- * 1. Explicit browserUrl/wsEndpoint - connect directly
- * 2. autoConnect enabled - try connecting, fall back to launching
- * 3. Otherwise - launch a new browser
- *
- * @returns Initialized McpContext ready for tool operations.
- */
-async function getContext() {
-    const extraArgs = (args.chromeArg ?? []).map(String);
-    if (args.proxyServer) {
-        extraArgs.push(`--proxy-server=${args.proxyServer}`);
-    }
-    const devtools = args.experimentalDevtools ?? false;
-    let browser;
-    let wasLaunched = false;
-    // If explicit browserUrl or wsEndpoint is provided, connect without fallback
-    if (args.browserUrl || args.wsEndpoint) {
-        browser = await ensureBrowserConnected({
-            browserURL: args.browserUrl,
-            wsEndpoint: args.wsEndpoint,
-            wsHeaders: args.wsHeaders,
-            devtools,
-            channel: undefined,
-            userDataDir: args.userDataDir,
-            includeExtensionPages: args.includeExtensionPages,
-        });
-    }
-    // If autoConnect is true, try connecting first, then fall back to launching
-    else if (args.autoConnect) {
-        try {
-            logger('Attempting to connect to running browser instance...');
-            browser = await ensureBrowserConnected({
-                browserURL: undefined,
-                wsEndpoint: undefined,
-                wsHeaders: undefined,
-                devtools,
-                channel: args.channel,
-                userDataDir: args.userDataDir,
-                includeExtensionPages: args.includeExtensionPages,
-            });
-            logger('Successfully connected to running browser instance');
-        }
-        catch (err) {
-            logger('Failed to connect to running browser, launching new instance...', err);
-            browser = await ensureBrowserLaunched({
-                headless: args.headless,
-                executablePath: args.executablePath,
-                channel: args.channel,
-                isolated: args.isolated ?? false,
-                userDataDir: args.userDataDir,
-                logFile,
-                viewport: args.viewport,
-                args: extraArgs,
-                acceptInsecureCerts: args.acceptInsecureCerts,
-                devtools,
-                includeExtensionPages: args.includeExtensionPages,
-            });
-            wasLaunched = true;
-        }
-    }
-    // Otherwise, just launch a new browser
-    else {
-        browser = await ensureBrowserLaunched({
-            headless: args.headless,
-            executablePath: args.executablePath,
-            channel: args.channel,
-            isolated: args.isolated ?? false,
-            userDataDir: args.userDataDir,
-            logFile,
-            viewport: args.viewport,
-            args: extraArgs,
-            acceptInsecureCerts: args.acceptInsecureCerts,
-            devtools,
-            includeExtensionPages: args.includeExtensionPages,
-        });
-        wasLaunched = true;
-    }
-    if (context?.browser !== browser) {
-        context = await McpContext.from(browser, logger, {
-            experimentalDevToolsDebugging: devtools,
-            experimentalIncludeAllPages: args.experimentalIncludeAllPages,
-            includeExtensionPages: args.includeExtensionPages,
-            onReconnect,
-        });
-        if (wasLaunched) {
-            // Fresh browser launch - use the existing default page
-            // Mark it as explicitly selected so this session stays pinned to it
-            context.selectPage(context.getSelectedPage(), true);
-            // Capture windowId for session scoping and resize the window
-            try {
-                const page = context.getSelectedPage();
-                const windowId = await context.getWindowIdForPage(page);
-                context.setSessionWindowId(windowId);
-                logger(`Using existing window for this MCP session, windowId: ${windowId}`);
-                // Resize to nearly full screen
-                const browserTarget = browser.target();
-                const cdpSession = await browserTarget.createCDPSession();
-                await cdpSession.send('Browser.setWindowBounds', {
-                    windowId,
-                    bounds: {
-                        left: 20,
-                        top: 20,
-                        width: 1800,
-                        height: 1200,
-                        windowState: 'normal',
-                    },
-                });
-                await cdpSession.detach();
-                logger('Resized window to nearly full screen');
-            }
-            catch (err) {
-                // Non-fatal: window sizing is best-effort, but windowId capture is important
-                logger('Failed to capture windowId or resize window:', err);
-            }
-        }
-        else {
-            // Connected to existing browser - create new window for isolation
-            // This ensures multiple MCP clients don't step on each other's toes
-            const { windowId } = await context.newWindow();
-            context.setSessionWindowId(windowId);
-            logger(`Created new window for this MCP session, windowId: ${windowId}`);
-        }
-        // Initialize WebMCP tool hub for dynamic tool registration
-        const toolHub = new WebMCPToolHub(server, context);
-        context.setToolHub(toolHub);
-        logger('WebMCPToolHub initialized for dynamic tool registration');
-    }
-    return context;
-}
-/**
- * Reconnect callback invoked by the connect_to_browser tool.
- *
- * Tears down the current browser session and connects to a new browser,
- * rebuilding all infrastructure (McpContext, WebMCPToolHub, session window).
- * Retries connection with exponential backoff for browsers that are still starting.
- */
-async function onReconnect(options) {
-    const timeout = options.timeout ?? 30_000;
-    const retryInterval = 2_000;
-    const devtools = args.experimentalDevtools ?? false;
-    // 1. Tear down old session
-    if (context) {
-        try {
-            await context.closeSessionWindow();
-        }
-        catch (err) {
-            logger('Error closing session window during reconnect:', err);
-        }
-        context.dispose();
-    }
-    disconnectBrowser();
-    // 2. Retry loop to connect to new browser
-    const deadline = Date.now() + timeout;
-    let lastError;
-    while (Date.now() < deadline) {
-        try {
-            const newBrowser = await connectToNewBrowser({
-                browserURL: options.browserURL,
-                wsEndpoint: options.wsEndpoint,
-                wsHeaders: options.wsHeaders,
-                includeExtensionPages: args.includeExtensionPages,
-            });
-            // 3. Rebuild context
-            context = await McpContext.from(newBrowser, logger, {
-                experimentalDevToolsDebugging: devtools,
-                experimentalIncludeAllPages: args.experimentalIncludeAllPages,
-                includeExtensionPages: args.includeExtensionPages,
-                onReconnect,
-            });
-            // 4. Create session window
-            const { windowId } = await context.newWindow();
-            context.setSessionWindowId(windowId);
-            logger(`Reconnect: new session window ${windowId}`);
-            // 5. Rebuild tool hub
-            const toolHub = new WebMCPToolHub(server, context);
-            context.setToolHub(toolHub);
-            logger('Reconnect: WebMCPToolHub rebuilt');
-            // 6. Build response
-            const pages = context.getPages().map((page, index) => ({
-                index,
-                url: page.url(),
-                selected: context.isPageSelected(page),
-            }));
-            const wsEndpoint = newBrowser.wsEndpoint();
-            return { pages, wsEndpoint };
-        }
-        catch (err) {
-            lastError = err instanceof Error ? err : new Error(String(err));
-            logger(`Reconnect attempt failed: ${lastError.message}`);
-            const remaining = deadline - Date.now();
-            if (remaining > retryInterval) {
-                await new Promise(resolve => setTimeout(resolve, retryInterval));
-            }
-            else {
-                break;
-            }
-        }
-    }
-    throw new Error(`Failed to connect to browser after ${timeout}ms: ${lastError?.message ?? 'unknown error'}`);
-}
-/**
- * Log security disclaimers to stderr.
- *
- * Warns users that browser content is exposed to MCP clients.
- */
-const logDisclaimers = () => {
-    console.error(`chrome-devtools-mcp exposes content of the browser instance to the MCP clients allowing them to inspect,
-debug, and modify any data in the browser or DevTools.
-Avoid sharing sensitive or personal information that you do not want to share with MCP clients.`);
-};
-/**
- * Mutex to serialize tool execution and prevent concurrent modifications.
- */
-const toolMutex = new Mutex();
-/**
- * Register a tool with the MCP server.
- *
- * Handles category-based filtering (emulation, performance, network)
- * and wraps the handler with context initialization and error handling.
- *
- * @param tool - Tool definition to register.
- */
-function registerTool(tool) {
-    if (tool.annotations.category === ToolCategory.EMULATION &&
-        args.categoryEmulation === false) {
-        return;
-    }
-    if (tool.annotations.category === ToolCategory.PERFORMANCE &&
-        args.categoryPerformance === false) {
-        return;
-    }
-    if (tool.annotations.category === ToolCategory.NETWORK &&
-        args.categoryNetwork === false) {
-        return;
-    }
-    server.registerTool(tool.name, {
-        description: tool.description,
-        inputSchema: zod.object(tool.schema).strict(),
-        annotations: tool.annotations,
-    }, async (params) => {
-        const guard = await toolMutex.acquire();
-        try {
-            logger(`${tool.name} request: ${JSON.stringify(params, null, '  ')}`);
-            const context = await getContext();
-            logger(`${tool.name} context: resolved`);
-            await context.detectOpenDevToolsWindows();
-            const response = new McpResponse();
-            await tool.handler({
-                params,
-            }, response, context);
-            // Re-fetch context in case the handler swapped it (e.g. connect_to_browser).
-            // The local `const context` shadows the module-level `let context`, so we
-            // must call getContext() to pick up any reassignment by onReconnect.
-            const activeContext = await getContext();
-            const content = await response.handle(tool.name, activeContext);
-            const result = {
-                content,
-            };
-            if (response.isError) {
-                result.isError = true;
-            }
-            return result;
-        }
-        catch (err) {
-            logger(`${tool.name} error:`, err, err?.stack);
-            let errorText = err && 'message' in err ? err.message : String(err);
-            if ('cause' in err && err.cause) {
-                errorText += `\nCause: ${err.cause.message}`;
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: errorText,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        finally {
-            guard.dispose();
-        }
-    });
-}
-for (const tool of tools) {
-    registerTool(tool);
-}
-await loadIssueDescriptions();
-const transport = new StdioServerTransport();
-await server.connect(transport);
-logger('Chrome DevTools MCP Server connected');
-logDisclaimers();

package/build/src/polyfillLoader.js

@@ -1,44 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { createRequire } from 'node:module';
-import { readFileSync } from 'node:fs';
-const require = createRequire(import.meta.url);
-let cachedPolyfill = null;
-/**
- * Load the @mcp-b/global IIFE polyfill code.
- * This polyfill provides the navigator.modelContext API for pages that don't have WebMCP.
- * Cached after first load for performance.
- *
- * @returns The IIFE JavaScript code as a string
- * @throws Error if the polyfill file cannot be found or read
- */
-export function getPolyfillCode() {
-    if (cachedPolyfill) {
-        return cachedPolyfill;
-    }
-    try {
-        // Use Node's module resolution to find the package regardless of
-        // workspace structure or installation method (pnpm, npm, yarn).
-        // Use the package's exported subpath '@mcp-b/global/iife' which resolves
-        // to the IIFE bundle via the exports field in package.json.
-        const polyfillPath = require.resolve('@mcp-b/global/iife');
-        cachedPolyfill = readFileSync(polyfillPath, 'utf-8');
-        return cachedPolyfill;
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        // Provide actionable error message
-        throw new Error(`Could not find @mcp-b/global polyfill: ${message}\n` +
-            'Run `pnpm build` in the global package or ensure @mcp-b/global is installed.');
-    }
-}
-/**
- * Clear the cached polyfill code, forcing the next getPolyfillCode() call
- * to reload from disk. Useful for testing or after @mcp-b/global updates.
- */
-export function clearPolyfillCache() {
-    cachedPolyfill = null;
-}