chrome-devtools-mcp 1.4.0 → 1.5.0

package/build/src/tools/memory.js

@@ -4,7 +4,6 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { zod } from '../third_party/index.js';
-import { ensureExtension } from '../utils/files.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool, defineTool } from './ToolDefinition.js';
 export const takeHeapSnapshot = definePageTool({
@@ -21,12 +20,13 @@ export const takeHeapSnapshot = definePageTool({
     },
     blockedByDialog: true,
     verifyFilesSchema: ['filePath'],
-    handler: async (request, response) => {
+    handler: async (request, response, context) => {
         const page = request.page;
+        const snapshotPath = await context.ensureExtension(request.params.filePath, '.heapsnapshot');
         await page.pptrPage.captureHeapSnapshot({
-            path: ensureExtension(request.params.filePath, '.heapsnapshot'),
+            path: snapshotPath,
         });
-        response.appendResponseLine(`Heap snapshot saved to ${request.params.filePath}`);
+        response.appendResponseLine(`Heap snapshot saved to ${snapshotPath}`);
     },
 });
 export const getHeapSnapshotSummary = defineTool({
@@ -224,4 +224,60 @@ export const getHeapSnapshotDominators = defineTool({
         response.setHeapSnapshotDominators(dominators);
     },
 });
+export const compareHeapSnapshots = defineTool({
+    name: 'compare_heapsnapshots',
+    description: 'Loads two memory heapsnapshots and returns the comparison. If classIndex is provided, returns detailed diff for that class, otherwise returns summary diff.',
+    annotations: {
+        category: ToolCategory.MEMORY,
+        readOnlyHint: true,
+        conditions: ['memoryDebugging'],
+    },
+    verifyFilesSchema: ['baseFilePath', 'currentFilePath'],
+    schema: {
+        baseFilePath: zod
+            .string()
+            .describe('A path to the base .heapsnapshot file (earlier snapshot).'),
+        currentFilePath: zod
+            .string()
+            .describe('A path to the current .heapsnapshot file (later snapshot).'),
+        classIndex: zod
+            .number()
+            .optional()
+            .describe('Optional 0-based index of the class in the summary list to filter results, showing individual objects.'),
+    },
+    blockedByDialog: false,
+    handler: async (request, response, context) => {
+        if (request.params.classIndex !== undefined) {
+            const classDiffResult = await context.getHeapSnapshotDetailedClassDiff(request.params.baseFilePath, request.params.currentFilePath, request.params.classIndex);
+            response.setHeapSnapshotDetailedClassDiff(classDiffResult);
+        }
+        else {
+            const diff = await context.getHeapSnapshotClassDiffs(request.params.baseFilePath, request.params.currentFilePath);
+            response.setHeapSnapshotClassDiffs(diff);
+        }
+    },
+});
+export const getHeapSnapshotDuplicateStrings = defineTool({
+    name: 'get_heapsnapshot_duplicate_strings',
+    description: 'Loads a memory heapsnapshot and returns duplicate strings grouped by their value.',
+    annotations: {
+        category: ToolCategory.MEMORY,
+        readOnlyHint: true,
+        conditions: ['memoryDebugging'],
+    },
+    blockedByDialog: false,
+    verifyFilesSchema: ['filePath'],
+    schema: {
+        filePath: zod.string().describe('A path to a .heapsnapshot file to read.'),
+        pageIdx: zod.number().optional().describe('The page index for pagination.'),
+        pageSize: zod.number().optional().describe('The page size for pagination.'),
+    },
+    handler: async (request, response, context) => {
+        const duplicateStrings = await context.getHeapSnapshotDuplicateStrings(request.params.filePath);
+        response.setHeapSnapshotDuplicateStrings(duplicateStrings, {
+            pageIdx: request.params.pageIdx,
+            pageSize: request.params.pageSize,
+        });
+    },
+});
 //# sourceMappingURL=memory.js.map

package/build/src/tools/screencast.js

@@ -7,7 +7,6 @@ import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { zod } from '../third_party/index.js';
-import { ensureExtension } from '../utils/files.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool } from './ToolDefinition.js';
 async function generateTempFilePath() {
@@ -53,7 +52,7 @@ export const startScreencast = definePageTool(args => ({
         const enforcedExtension = matchedExtension ?? '.mp4';
         const format = (matchedExtension?.substring(1) ??
             'mp4');
-        const resolvedPath = ensureExtension(path.resolve(filePath), enforcedExtension);
+        const resolvedPath = await context.ensureExtension(filePath, enforcedExtension);
         const page = request.page;
         let recorder;
         try {

package/build/src/tools/script.js

@@ -9,8 +9,7 @@ import { defineTool, pageIdSchema } from './ToolDefinition.js';
 export const evaluateScript = defineTool(cliArgs => {
     return {
         name: 'evaluate_script',
-        description: `Evaluate a JavaScript function inside the currently selected page${cliArgs?.categoryExtensions ? ' or service worker' : ''}. Returns the response as JSON,
-so returned values have to be JSON-serializable.`,
+        description: `Evaluate a JavaScript function inside the currently selected page${cliArgs?.categoryExtensions ? ' or service worker' : ''}. Returns the response as JSON, so returned values have to be JSON-serializable.`,
         annotations: {
             category: ToolCategory.DEBUGGING,
             readOnlyHint: false,
@@ -18,14 +17,8 @@ so returned values have to be JSON-serializable.`,
         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
-}\` or \`async () => {
-  return await fetch("example.com")
-}\`.
-Example with arguments: \`(el) => {
-  return el.innerText;
-}\`
+Example without arguments: \`() => document.title\` or \`async () => await fetch("example.com")\`.
+Example with arguments: \`(el) => el.innerText\`
 `),
             args: zod
                 .array(zod

package/build/src/tools/thirdPartyDeveloper.js

@@ -9,12 +9,12 @@ import { definePageTool } from './ToolDefinition.js';
 export const listThirdPartyDeveloperTools = definePageTool({
     name: 'list_3p_developer_tools',
     description: `Lists all third-party developer tools the page exposes for providing runtime information.
-  Third-party developer tools can be called via the 'execute_3p_developer_tool()' MCP tool.
-  Alternatively, third-party developer tools can be executed by calling 'evaluate_script' and adding the
-  following command to the script:
-  'window.__dtmcp.executeTool(toolName, params)'
-  This might be helpful when the third-party developer tools return non-serializable values or when composing
-  third-party developer tools with additional functionality.`,
+Third-party developer tools can be called via the 'execute_3p_developer_tool()' MCP tool.
+Alternatively, third-party developer tools can be executed by calling 'evaluate_script' and adding the
+following command to the script:
+\`window.__dtmcp.executeTool(toolName, params)\`
+This might be helpful when the third-party developer tools return non-serializable values or when composing
+third-party developer tools with additional functionality.`,
     annotations: {
         category: ToolCategory.THIRD_PARTY,
         readOnlyHint: true,

package/build/src/utils/files.js

@@ -11,10 +11,6 @@ export async function getTempFilePath(filename) {
     const filepath = path.join(dir, filename);
     return filepath;
 }
-export function ensureExtension(filepath, extension) {
-    const ext = path.extname(filepath);
-    return filepath.slice(0, filepath.length - ext.length) + extension;
-}
 export async function resolveCanonicalPath(filePath) {
     const absolutePath = path.resolve(filePath);
     try {

package/build/src/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -64,7 +64,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1650035",
+    "chrome-devtools-frontend": "1.0.1652307",
     "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
@@ -73,7 +73,7 @@
     "globals": "^17.0.0",
     "lighthouse": "13.4.0",
     "prettier": "^3.6.2",
-    "puppeteer": "25.2.0",
+    "puppeteer": "25.2.1",
     "rollup": "4.62.2",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
@@ -84,6 +84,14 @@
     "urlpattern-polyfill": "^10.1.0",
     "yargs": "18.0.0"
   },
+  "peerDependencies": {
+    "@toon-format/toon": "^2.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@toon-format/toon": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=23"
   },