chrome-devtools-mcp 1.0.1 → 1.1.0

package/build/src/tools/ToolDefinition.js

@@ -30,7 +30,7 @@ export function definePageTool(definition) {
 }
 export const CLOSE_PAGE_ERROR = 'The last open page cannot be closed. It is fine to keep it open.';
 export const pageIdSchema = {
-    pageId: zod.number().optional().describe('Targets a specific page by ID.'),
+    pageId: zod.number().describe('Targets a specific page by ID.'),
 };
 export const timeoutSchema = {
     timeout: zod

package/build/src/tools/emulation.js

@@ -7,6 +7,26 @@
 import { zod, PredefinedNetworkConditions } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool, geolocationTransform, viewportTransform, } from './ToolDefinition.js';
+function headerStringTransform(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === '') {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            throw new Error('Headers must be a JSON object');
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON for headers: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
 const throttlingOptions = [
     'Offline',
     ...Object.keys(PredefinedNetworkConditions),
@@ -47,6 +67,11 @@ export const emulate = definePageTool({
             .optional()
             .transform(viewportTransform)
             .describe(`Emulate device viewports '<width>x<height>x<devicePixelRatio>[,mobile][,touch][,landscape]'. 'touch' and 'mobile' to emulate mobile devices. 'landscape' to emulate landscape mode.`),
+        extraHttpHeaders: zod
+            .string()
+            .optional()
+            .transform(headerStringTransform)
+            .describe('Extra HTTP headers as a JSON string object, e.g. {"X-Custom": "value", "Authorization": "Bearer token"}. Headers are included into every HTTP request originating from the page and persist across navigations until cleared. Pass an empty string to clear all extra headers.'),
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {

package/build/src/tools/extensions.js

@@ -21,6 +21,7 @@ export const installExtension = defineTool({
     blockedByDialog: false,
     handler: async (request, response, context) => {
         const { path } = request.params;
+        await context.validatePath(path);
         const id = await context.installExtension(path);
         response.appendResponseLine(`Extension installed. Id: ${id}`);
     },
@@ -72,6 +73,7 @@ export const reloadExtension = defineTool({
         if (!extension) {
             throw new Error(`Extension with ID ${id} not found.`);
         }
+        await context.validatePath(extension.path);
         await context.installExtension(extension.path);
         response.appendResponseLine('Extension reloaded.');
     },

package/build/src/tools/input.js

@@ -393,7 +393,7 @@ export const uploadFile = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const { uid, filePath } = request.params;
-        context.validatePath(filePath);
+        await context.validatePath(filePath);
         const handle = (await request.page.getElementByUid(uid));
         try {
             try {

package/build/src/tools/lighthouse.js

@@ -40,7 +40,7 @@ export const lighthouseAudit = definePageTool({
         ];
         const formats = ['json', 'html'];
         const { mode = 'navigation', device = 'desktop', outputDirPath, } = request.params;
-        context.validatePath(outputDirPath);
+        await context.validatePath(outputDirPath);
         const flags = {
             onlyCategories: categories,
             output: formats,

package/build/src/tools/memory.js

@@ -7,8 +7,8 @@ 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 takeMemorySnapshot = definePageTool({
-    name: 'take_memory_snapshot',
+export const takeHeapSnapshot = definePageTool({
+    name: 'take_heapsnapshot',
     description: `Capture a heap snapshot of the currently selected page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.`,
     annotations: {
         category: ToolCategory.MEMORY,
@@ -22,15 +22,15 @@ export const takeMemorySnapshot = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         await page.pptrPage.captureHeapSnapshot({
             path: ensureExtension(request.params.filePath, '.heapsnapshot'),
         });
         response.appendResponseLine(`Heap snapshot saved to ${request.params.filePath}`);
     },
 });
-export const exploreMemorySnapshot = defineTool({
-    name: 'load_memory_snapshot',
+export const getHeapSnapshotSummary = defineTool({
+    name: 'get_heapsnapshot_summary',
     description: 'Loads a memory heapsnapshot and returns snapshot summary stats.',
     annotations: {
         category: ToolCategory.MEMORY,
@@ -42,14 +42,14 @@ export const exploreMemorySnapshot = defineTool({
     },
     blockedByDialog: false,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         const stats = await context.getHeapSnapshotStats(request.params.filePath);
         const staticData = await context.getHeapSnapshotStaticData(request.params.filePath);
         response.setHeapSnapshotStats(stats, staticData);
     },
 });
-export const getMemorySnapshotDetails = defineTool({
-    name: 'get_memory_snapshot_details',
+export const getHeapSnapshotDetails = defineTool({
+    name: 'get_heapsnapshot_details',
     description: 'Loads a memory heapsnapshot and returns all available information including statistics, static data, and aggregated node information. Supports pagination for aggregates.',
     annotations: {
         category: ToolCategory.MEMORY,
@@ -69,7 +69,7 @@ export const getMemorySnapshotDetails = defineTool({
     },
     blockedByDialog: false,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         const aggregates = await context.getHeapSnapshotAggregates(request.params.filePath);
         response.setHeapSnapshotAggregates(aggregates, {
             pageIdx: request.params.pageIdx,
@@ -77,9 +77,9 @@ export const getMemorySnapshotDetails = defineTool({
         });
     },
 });
-export const getNodesByClass = defineTool({
-    name: 'get_nodes_by_class',
-    description: 'Loads a memory heapsnapshot and returns instances of a specific class with their stable IDs.',
+export const getHeapSnapshotClassNodes = defineTool({
+    name: 'get_heapsnapshot_class_nodes',
+    description: 'Loads a memory heapsnapshot and returns instances of a specific class with their IDs.',
     annotations: {
         category: ToolCategory.MEMORY,
         readOnlyHint: true,
@@ -87,24 +87,22 @@ export const getNodesByClass = defineTool({
     },
     schema: {
         filePath: zod.string().describe('A path to a .heapsnapshot file to read.'),
-        uid: zod
-            .number()
-            .describe('The unique UID for the class, obtained from aggregates listing.'),
+        id: zod.number().describe('The ID for the class, obtained from details.'),
         pageIdx: zod.number().optional().describe('The page index for pagination.'),
         pageSize: zod.number().optional().describe('The page size for pagination.'),
     },
     blockedByDialog: false,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
-        const nodes = await context.getHeapSnapshotNodesByUid(request.params.filePath, request.params.uid);
+        await context.validatePath(request.params.filePath);
+        const nodes = await context.getHeapSnapshotNodesById(request.params.filePath, request.params.id);
         response.setHeapSnapshotNodes(nodes, {
             pageIdx: request.params.pageIdx,
             pageSize: request.params.pageSize,
         });
     },
 });
-export const getNodeRetainers = defineTool({
-    name: 'get_node_retainers',
+export const getHeapSnapshotRetainers = defineTool({
+    name: 'get_heapsnapshot_retainers',
     description: 'Loads a memory heapsnapshot and returns retainers for a specific node ID.',
     annotations: {
         category: ToolCategory.MEMORY,
@@ -114,12 +112,12 @@ export const getNodeRetainers = defineTool({
     blockedByDialog: false,
     schema: {
         filePath: zod.string().describe('A path to a .heapsnapshot file to read.'),
-        nodeId: zod.number().describe('The stable node ID to get retainers for.'),
+        nodeId: zod.number().describe('The node ID to get retainers for.'),
         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) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         const retainers = await context.getHeapSnapshotRetainers(request.params.filePath, request.params.nodeId);
         response.setHeapSnapshotNodes(retainers, {
             pageIdx: request.params.pageIdx,

package/build/src/tools/network.js

@@ -96,8 +96,8 @@ export const getNetworkRequest = definePageTool({
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.requestFilePath);
-        context.validatePath(request.params.responseFilePath);
+        await context.validatePath(request.params.requestFilePath);
+        await context.validatePath(request.params.responseFilePath);
         if (request.params.reqid) {
             response.attachNetworkRequest(request.params.reqid, {
                 requestFilePath: request.params.requestFilePath,

package/build/src/tools/performance.js

@@ -33,7 +33,7 @@ export const startTrace = definePageTool({
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        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;
@@ -78,7 +78,7 @@ export const startTrace = definePageTool({
         }
         if (request.params.autoStop) {
             await new Promise(resolve => setTimeout(resolve, 5_000));
-            await stopTracingAndAppendOutput(page.pptrPage, response, context, request.params.filePath);
+            await stopTracingAndAppendOutput(page, response, context, request.params.filePath);
         }
         else {
             response.appendResponseLine(`The performance trace is being recorded. Use performance_stop_trace to stop it.`);
@@ -97,12 +97,12 @@ export const stopTrace = definePageTool({
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         if (!context.isRunningPerformanceTrace()) {
             return;
         }
         const page = request.page;
-        await stopTracingAndAppendOutput(page.pptrPage, response, context, request.params.filePath);
+        await stopTracingAndAppendOutput(page, response, context, request.params.filePath);
     },
 });
 export const analyzeInsight = definePageTool({
@@ -132,7 +132,7 @@ export const analyzeInsight = definePageTool({
 });
 async function stopTracingAndAppendOutput(page, response, context, filePath) {
     try {
-        const traceEventsBuffer = await page.tracing.stop();
+        const traceEventsBuffer = await page.pptrPage.tracing.stop();
         if (filePath && traceEventsBuffer) {
             let dataToWrite = traceEventsBuffer;
             if (filePath.endsWith('.gz')) {
@@ -150,7 +150,10 @@ async function stopTracingAndAppendOutput(page, response, context, filePath) {
             const file = await context.saveFile(dataToWrite, filePath, filePath.endsWith('.gz') ? '.json.gz' : '.json');
             response.appendResponseLine(`The raw trace data was saved to ${file.filename}.`);
         }
-        const result = await parseRawTraceBuffer(traceEventsBuffer);
+        const result = await parseRawTraceBuffer(traceEventsBuffer, {
+            cpuThrottling: page.cpuThrottlingRate,
+            networkThrottling: page.networkConditions ?? undefined,
+        });
         response.appendResponseLine('The performance trace has been stopped.');
         if (traceResultIsSuccess(result)) {
             if (context.isCruxEnabled()) {

package/build/src/tools/screencast.js

@@ -31,7 +31,7 @@ export const startScreencast = definePageTool(args => ({
     },
     blockedByDialog: false,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        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;

package/build/src/tools/screenshot.js

@@ -40,7 +40,7 @@ export const screenshot = definePageTool({
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        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

@@ -53,7 +53,7 @@ Example with arguments: \`(el) => {
         blockedByDialog: true,
         handler: async (request, response, context) => {
             const { serviceWorkerId, args: uidArgs, function: fnString, pageId, dialogAction, filePath, } = request.params;
-            context.validatePath(filePath);
+            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/snapshot.js

@@ -28,7 +28,7 @@ in the DevTools Elements panel (if any).`,
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         response.includeSnapshot({
             verbose: request.params.verbose ?? false,
             filePath: request.params.filePath,

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

@@ -9,7 +9,7 @@ const engine = DevTools.TraceEngine.TraceModel.Model.createWithAllHandlers();
 export function traceResultIsSuccess(x) {
     return 'parsedTrace' in x;
 }
-export async function parseRawTraceBuffer(buffer) {
+export async function parseRawTraceBuffer(buffer, metadata) {
     engine.resetProcessor();
     if (!buffer) {
         return {
@@ -25,7 +25,7 @@ export async function parseRawTraceBuffer(buffer) {
     try {
         const data = JSON.parse(asString);
         const events = Array.isArray(data) ? data : data.traceEvents;
-        await engine.parse(events);
+        await engine.parse(events, { metadata });
         const parsedTrace = engine.parsedTrace();
         if (!parsedTrace) {
             return {

package/build/src/utils/files.js

@@ -15,4 +15,47 @@ 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 {
+        // Get the true canonical path, resolving all symlinks.
+        return await fs.realpath(absolutePath);
+    }
+    catch (err) {
+        if (err &&
+            typeof err === 'object' &&
+            'code' in err &&
+            err.code === 'ENOENT') {
+            // Find the nearest existing ancestor directory on the filesystem.
+            let current = absolutePath;
+            const missingSegments = [];
+            while (true) {
+                const parent = path.dirname(current);
+                if (parent === current) {
+                    // Reached root directory but still couldn't resolve anything.
+                    throw err;
+                }
+                try {
+                    const canonicalParent = await fs.realpath(parent);
+                    return path.join(canonicalParent, path.basename(current), ...missingSegments);
+                }
+                catch (parentErr) {
+                    if (parentErr &&
+                        typeof parentErr === 'object' &&
+                        'code' in parentErr &&
+                        parentErr.code === 'ENOENT') {
+                        missingSegments.unshift(path.basename(current));
+                        current = parent;
+                    }
+                    else {
+                        throw parentErr;
+                    }
+                }
+            }
+        }
+        else {
+            throw err;
+        }
+    }
+}
 //# sourceMappingURL=files.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.0.1';
+export const VERSION = '1.1.0';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -62,7 +62,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1631386",
+    "chrome-devtools-frontend": "1.0.1632065",
     "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
@@ -71,7 +71,7 @@
     "globals": "^17.0.0",
     "lighthouse": "13.3.0",
     "prettier": "^3.6.2",
-    "puppeteer": "25.0.4",
+    "puppeteer": "25.1.0",
     "rollup": "4.60.4",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",