chrome-devtools-mcp 1.1.0 → 1.2.0

package/build/src/tools/pages.js

@@ -22,7 +22,7 @@ async function navigateWithInterception(page, action, allowListString, timeout)
             void interceptedRequest.continue();
         }
         else {
-            logger(`Blocking request to: ${requestUrl}`);
+            logger?.(`Blocking request to: ${requestUrl}`);
             void interceptedRequest.abort('blockedbyclient');
         }
     };
@@ -30,7 +30,7 @@ async function navigateWithInterception(page, action, allowListString, timeout)
         if (allowList) {
             page.pptrPage.off('request', requestHandler);
             await page.pptrPage.setRequestInterception(false).catch(error => {
-                logger(`Failed to disable request interception`, error);
+                logger?.(`Failed to disable request interception`, error);
             });
         }
     };
@@ -62,6 +62,7 @@ export const listPages = defineTool(args => {
         },
         schema: {},
         blockedByDialog: false,
+        verifyFilesSchema: [],
         handler: async (_request, response) => {
             response.setIncludePages(true);
             response.setListThirdPartyDeveloperTools();
@@ -86,6 +87,7 @@ export const selectPage = defineTool({
             .describe('Whether to focus the page and bring it to the top.'),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response, context) => {
         const page = context.getPageById(request.params.pageId);
         context.selectPage(page);
@@ -110,6 +112,7 @@ export const closePage = defineTool({
             .describe('The ID of the page to close. Call list_pages to list pages.'),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response, context) => {
         try {
             await context.closePage(request.params.pageId);
@@ -157,6 +160,7 @@ export const newPage = defineTool(args => {
             ...timeoutSchema,
         },
         blockedByDialog: false,
+        verifyFilesSchema: [],
         handler: async (request, response, context) => {
             const page = await context.newPage(request.params.background, request.params.isolatedContext);
             await navigateWithInterception(page, () => page.pptrPage.goto(request.params.url, {
@@ -204,6 +208,7 @@ export const navigatePage = definePageTool(args => {
             ...timeoutSchema,
         },
         blockedByDialog: false,
+        verifyFilesSchema: [],
         handler: async (request, response) => {
             const page = request.page;
             const options = {
@@ -290,7 +295,7 @@ export const navigatePage = definePageTool(args => {
                     await page.pptrPage
                         .removeScriptToEvaluateOnNewDocument(initScriptId)
                         .catch(error => {
-                        logger(`Failed to remove init script`, error);
+                        logger?.(`Failed to remove init script`, error);
                     });
                 }
             }
@@ -312,6 +317,7 @@ export const resizePage = definePageTool({
         height: zod.number().describe('Page height'),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response, _context) => {
         const page = request.page;
         try {
@@ -354,6 +360,7 @@ export const handleDialog = definePageTool({
             .describe('Optional prompt text to enter into the dialog.'),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response, _context) => {
         const page = request.page;
         const dialog = page.getDialog();
@@ -367,7 +374,7 @@ export const handleDialog = definePageTool({
                 }
                 catch (err) {
                     // Likely already handled by the user outside of MCP.
-                    logger(err);
+                    logger?.(err);
                 }
                 response.appendResponseLine('Successfully accepted the dialog');
                 break;
@@ -378,7 +385,7 @@ export const handleDialog = definePageTool({
                 }
                 catch (err) {
                     // Likely already handled.
-                    logger(err);
+                    logger?.(err);
                 }
                 response.appendResponseLine('Successfully dismissed the dialog');
                 break;
@@ -402,6 +409,7 @@ export const getTabId = definePageTool({
             .describe(`The ID of the page to get the tab ID for. Call ${listPages().name} to get available pages.`),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response, context) => {
         const page = context.getPageById(request.params.pageId);
         const tabId = page.pptrPage._tabId;

package/build/src/tools/performance.js

@@ -32,8 +32,8 @@ export const startTrace = definePageTool({
         filePath: filePathSchema,
     },
     blockedByDialog: true,
+    verifyFilesSchema: ['filePath'],
     handler: async (request, response, context) => {
-        await context.validatePath(request.params.filePath);
         if (context.isRunningPerformanceTrace()) {
             response.appendResponseLine('Error: a performance trace is already running. Use performance_stop_trace to stop it. Only one trace can be running at any given time.');
             return;
@@ -96,8 +96,8 @@ export const stopTrace = definePageTool({
         filePath: filePathSchema,
     },
     blockedByDialog: true,
+    verifyFilesSchema: ['filePath'],
     handler: async (request, response, context) => {
-        await context.validatePath(request.params.filePath);
         if (!context.isRunningPerformanceTrace()) {
             return;
         }
@@ -121,6 +121,7 @@ export const analyzeInsight = definePageTool({
             .describe('The name of the Insight you want more information on. For example: "DocumentLatency" or "LCPBreakdown"'),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response, context) => {
         const lastRecording = context.recordedTraces().at(-1);
         if (!lastRecording) {
@@ -172,8 +173,8 @@ async function stopTracingAndAppendOutput(page, response, context, filePath) {
 }
 /** We tell CrUXManager to fetch data so it's available when DevTools.PerformanceTraceFormatter is invoked */
 async function populateCruxData(result) {
-    logger('populateCruxData called');
-    const cruxManager = DevTools.CrUXManager.instance();
+    logger?.('populateCruxData called');
+    const cruxManager = DevTools.CrUXManager.CrUXManager.instance();
     // go/jtfbx. Yes, we're aware this API key is public. ;)
     cruxManager.setEndpointForTesting('https://chromeuxreport.googleapis.com/v1/records:queryRecord?key=AIzaSyBn5gimNjhiEyA_euicSKko6IlD3HdgUfk');
     const cruxSetting = DevTools.Common.Settings.Settings.instance().createSetting('field-data', {
@@ -185,13 +186,13 @@ async function populateCruxData(result) {
     urls.push(result.parsedTrace.data.Meta.mainFrameURL);
     const urlSet = new Set(urls);
     if (urlSet.size === 0) {
-        logger('No URLs found for CrUX data');
+        logger?.('No URLs found for CrUX data');
         return;
     }
-    logger(`Fetching CrUX data for ${urlSet.size} URLs: ${Array.from(urlSet).join(', ')}`);
+    logger?.(`Fetching CrUX data for ${urlSet.size} URLs: ${Array.from(urlSet).join(', ')}`);
     const cruxData = await Promise.all(Array.from(urlSet).map(async (url) => {
         const data = await cruxManager.getFieldDataForPage(url);
-        logger(`CrUX data for ${url}: ${data ? 'found' : 'not found'}`);
+        logger?.(`CrUX data for ${url}: ${data ? 'found' : 'not found'}`);
         return data;
     }));
     result.parsedTrace.metadata.cruxFieldData = cruxData;

package/build/src/tools/screencast.js

@@ -30,8 +30,8 @@ export const startScreencast = definePageTool(args => ({
             .describe(`Output file path (${supportedExtensions.join(',')} are supported). Uses mkdtemp to generate a unique path if not provided.`),
     },
     blockedByDialog: false,
+    verifyFilesSchema: ['filePath'],
     handler: async (request, response, context) => {
-        await context.validatePath(request.params.filePath);
         if (context.getScreenRecorder() !== null) {
             response.appendResponseLine('Error: a screencast recording is already in progress. Use screencast_stop to stop it before starting a new one.');
             return;
@@ -78,6 +78,7 @@ export const stopScreencast = definePageTool({
     },
     schema: {},
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (_request, response, context) => {
         const data = context.getScreenRecorder();
         if (!data) {

package/build/src/tools/screenshot.js

@@ -39,8 +39,8 @@ export const screenshot = definePageTool({
             .describe('The absolute path, or a path relative to the current working directory, to save the screenshot to instead of attaching it to the response.'),
     },
     blockedByDialog: true,
+    verifyFilesSchema: ['filePath'],
     handler: async (request, response, context) => {
-        await context.validatePath(request.params.filePath);
         if (request.params.uid && request.params.fullPage) {
             throw new Error('Providing both "uid" and "fullPage" is not allowed.');
         }

package/build/src/tools/script.js

@@ -16,6 +16,7 @@ so returned values have to be JSON-serializable.`,
             readOnlyHint: false,
         },
         schema: {
+            ...(cliArgs?.experimentalPageIdRouting ? pageIdSchema : {}),
             function: zod.string().describe(`A JavaScript function declaration to be executed by the tool in the currently selected page.
 Example without arguments: \`() => {
   return document.title
@@ -40,7 +41,6 @@ Example with arguments: \`(el) => {
                 .string()
                 .optional()
                 .describe('Handle dialogs while execution. "accept", "dismiss", or string for response of window.prompt. Defaults to accept.'),
-            ...(cliArgs?.experimentalPageIdRouting ? pageIdSchema : {}),
             ...(cliArgs?.categoryExtensions
                 ? {
                     serviceWorkerId: zod
@@ -51,9 +51,9 @@ Example with arguments: \`(el) => {
                 : {}),
         },
         blockedByDialog: true,
+        verifyFilesSchema: ['filePath'],
         handler: async (request, response, context) => {
             const { serviceWorkerId, args: uidArgs, function: fnString, pageId, dialogAction, filePath, } = request.params;
-            await context.validatePath(filePath);
             if (cliArgs?.categoryExtensions && serviceWorkerId) {
                 if (uidArgs && uidArgs.length > 0) {
                     throw new Error('args (element uids) cannot be used when evaluating in a service worker.');

package/build/src/tools/slim/tools.js

@@ -16,6 +16,7 @@ export const screenshot = definePageTool({
     },
     schema: {},
     blockedByDialog: true,
+    verifyFilesSchema: [],
     handler: async (request, response, context) => {
         const page = request.page;
         const screenshot = await page.pptrPage.screenshot({
@@ -37,6 +38,7 @@ export const navigate = definePageTool({
         url: zod.string().describe('URL to navigate to'),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response) => {
         const page = request.page;
         const options = {
@@ -71,6 +73,7 @@ export const evaluate = definePageTool({
         script: zod.string().describe(`JS script to run on the page`),
     },
     blockedByDialog: true,
+    verifyFilesSchema: [],
     handler: async (request, response) => {
         const page = request.page;
         try {

package/build/src/tools/snapshot.js

@@ -27,8 +27,8 @@ in the DevTools Elements panel (if any).`,
             .describe('The absolute path, or a path relative to the current working directory, to save the snapshot to instead of attaching it to the response.'),
     },
     blockedByDialog: true,
-    handler: async (request, response, context) => {
-        await context.validatePath(request.params.filePath);
+    verifyFilesSchema: ['filePath'],
+    handler: async (request, response) => {
         response.includeSnapshot({
             verbose: request.params.verbose ?? false,
             filePath: request.params.filePath,
@@ -50,6 +50,7 @@ export const waitFor = definePageTool({
         ...timeoutSchema,
     },
     blockedByDialog: true,
+    verifyFilesSchema: [],
     handler: async (request, response, context) => {
         const page = request.page;
         await context.waitForTextOnPage(request.params.text, request.params.timeout, page.pptrPage);

package/build/src/tools/thirdPartyDeveloper.js

@@ -21,6 +21,7 @@ export const listThirdPartyDeveloperTools = definePageTool({
     },
     schema: {},
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (_request, response, _context) => {
         response.setListThirdPartyDeveloperTools();
     },
@@ -40,6 +41,7 @@ export const executeThirdPartyDeveloperTool = definePageTool({
             .describe('The JSON-stringified parameters to pass to the tool'),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response) => {
         const toolName = request.params.toolName;
         let params = {};
@@ -58,8 +60,16 @@ export const executeThirdPartyDeveloperTool = definePageTool({
                 throw new Error(`Failed to parse params as JSON: ${errorMessage}`);
             }
         }
-        const toolGroup = request.page.getThirdPartyDeveloperTools();
-        const tool = toolGroup?.tools.find(t => t.name === toolName);
+        const toolGroups = request.page.getThirdPartyDeveloperTools();
+        let tool;
+        if (toolGroups) {
+            for (const group of toolGroups) {
+                tool = group.tools?.find(t => t.name === toolName);
+                if (tool) {
+                    break;
+                }
+            }
+        }
         if (!tool) {
             throw new Error(`Tool ${toolName} not found`);
         }

package/build/src/tools/webmcp.js

@@ -15,6 +15,7 @@ export const listWebMcpTools = definePageTool({
     },
     schema: {},
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (_request, response, _context) => {
         response.setListWebMcpTools();
     },
@@ -34,6 +35,7 @@ export const executeWebMcpTool = definePageTool({
             .describe('The JSON-stringified parameters to pass to the WebMCP tool'),
     },
     blockedByDialog: false,
+    verifyFilesSchema: [],
     handler: async (request, response) => {
         const toolName = request.params.toolName;
         let input = {};

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

@@ -40,7 +40,7 @@ export async function parseRawTraceBuffer(buffer, metadata) {
     }
     catch (e) {
         const errorText = e instanceof Error ? e.message : JSON.stringify(e);
-        logger(`Unexpected error parsing trace: ${errorText}`);
+        logger?.(`Unexpected error parsing trace: ${errorText}`);
         return {
             error: errorText,
         };
@@ -51,9 +51,9 @@ const extraFormatDescriptions = `Information on performance traces may contain m
 ${DevTools.PerformanceTraceFormatter.callFrameDataFormatDescription}
 
 ${DevTools.PerformanceTraceFormatter.networkDataFormatDescription}`;
-export function getTraceSummary(result) {
+export function getTraceSummary(result, deviceScope) {
     const focus = DevTools.AgentFocus.fromParsedTrace(result.parsedTrace);
-    const formatter = new DevTools.PerformanceTraceFormatter(focus);
+    const formatter = new DevTools.PerformanceTraceFormatter(focus, deviceScope);
     const summaryText = formatter.formatTraceSummary();
     return `## Summary of Performance trace findings:
 ${summaryText}
@@ -61,7 +61,7 @@ ${summaryText}
 ## Details on call tree & network request formats:
 ${extraFormatDescriptions}`;
 }
-export function getInsightOutput(result, insightSetId, insightName) {
+export function getInsightOutput(result, insightSetId, insightName, deviceScope) {
     if (!result.insights) {
         return {
             error: 'No Performance insights are available for this trace.',
@@ -79,7 +79,7 @@ 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 DevTools.PerformanceInsightFormatter(DevTools.AgentFocus.fromParsedTrace(result.parsedTrace), matchingInsight);
+    const formatter = new DevTools.PerformanceInsightFormatter(DevTools.AgentFocus.fromParsedTrace(result.parsedTrace), matchingInsight, deviceScope);
     return { output: formatter.formatInsight() };
 }
 //# sourceMappingURL=parse.js.map

package/build/src/version.js

@@ -5,6 +5,6 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const VERSION = '1.1.0';
+export const VERSION = '1.2.0';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -9,28 +9,28 @@
   },
   "main": "./build/src/index.js",
   "scripts": {
-    "cli:generate": "node --experimental-strip-types scripts/generate-cli.ts",
+    "cli:generate": "node scripts/generate-cli.ts",
     "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
-    "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",
-    "build": "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 scripts/append-lighthouse-notices.ts",
+    "build": "tsc && node scripts/post-build.ts",
     "typecheck": "tsc --noEmit",
     "format": "eslint --cache --fix . && prettier --write --cache .",
     "check-format": "eslint --cache . && prettier --check --cache .;",
     "gen": "npm run build && npm run docs:generate && npm run cli:generate && npm run update-metrics && npm run format",
-    "docs:generate": "node --experimental-strip-types scripts/generate-docs.ts",
+    "docs:generate": "node scripts/generate-docs.ts",
     "start": "npm run build && node build/src/bin/chrome-devtools-mcp.js",
     "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/bin/chrome-devtools-mcp.js",
     "test": "npm run build && node scripts/test.mjs",
     "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",
-    "prepare": "node --experimental-strip-types scripts/prepare.ts",
-    "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts",
-    "update-lighthouse": "node --experimental-strip-types scripts/update-lighthouse.ts",
-    "update-metrics": "node --experimental-strip-types scripts/update_metrics.ts",
+    "prepare": "node scripts/prepare.ts",
+    "verify-server-json-version": "node scripts/verify-server-json-version.ts",
+    "update-lighthouse": "node scripts/update-lighthouse.ts",
+    "update-metrics": "node scripts/update_metrics.ts",
     "verify-npm-package": "node scripts/verify-npm-package.mjs",
-    "eval": "npm run build && node --experimental-strip-types scripts/eval_gemini.ts",
-    "count-tokens": "node --experimental-strip-types scripts/count_tokens.ts"
+    "eval": "npm run build && node scripts/eval_gemini.ts",
+    "count-tokens": "node scripts/count_tokens.ts"
   },
   "files": [
     "build/src",
@@ -54,6 +54,7 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@stylistic/eslint-plugin": "^5.4.0",
+    "@toon-format/toon": "^2.2.0",
     "@types/debug": "^4.1.12",
     "@types/filesystem": "^0.0.36",
     "@types/node": "^25.0.0",
@@ -62,7 +63,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1632065",
+    "chrome-devtools-frontend": "1.0.1641723",
     "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
@@ -72,7 +73,7 @@
     "lighthouse": "13.3.0",
     "prettier": "^3.6.2",
     "puppeteer": "25.1.0",
-    "rollup": "4.60.4",
+    "rollup": "4.61.0",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "semver": "^7.7.4",