chrome-devtools-mcp 0.22.0 → 0.24.0

package/build/src/tools/ToolDefinition.js

@@ -70,3 +70,4 @@ export function geolocationTransform(arg) {
         longitude,
     };
 }
+//# sourceMappingURL=ToolDefinition.js.map

package/build/src/tools/categories.js

@@ -12,7 +12,7 @@ export var ToolCategory;
     ToolCategory["NETWORK"] = "network";
     ToolCategory["DEBUGGING"] = "debugging";
     ToolCategory["EXTENSIONS"] = "extensions";
-    ToolCategory["IN_PAGE"] = "in-page";
+    ToolCategory["IN_PAGE"] = "experimentalInPage";
     ToolCategory["MEMORY"] = "memory";
 })(ToolCategory || (ToolCategory = {}));
 export const labels = {
@@ -26,4 +26,8 @@ export const labels = {
     [ToolCategory.IN_PAGE]: 'In-page tools',
     [ToolCategory.MEMORY]: 'Memory',
 };
-export const OFF_BY_DEFAULT_CATEGORIES = [ToolCategory.EXTENSIONS];
+export const OFF_BY_DEFAULT_CATEGORIES = [
+    ToolCategory.EXTENSIONS,
+    ToolCategory.IN_PAGE,
+];
+//# sourceMappingURL=categories.js.map

package/build/src/tools/console.js

@@ -60,6 +60,7 @@ export const listConsoleMessages = definePageTool(cliArgs => {
                 .optional()
                 .describe('Set to true to return the preserved messages over the last 3 navigations.'),
         },
+        blockedByDialog: false,
         handler: async (request, response) => {
             response.setIncludeConsoleData(true, {
                 pageSize: request.params.pageSize,
@@ -82,7 +83,9 @@ export const getConsoleMessage = definePageTool({
             .number()
             .describe('The msgid of a console message on the page from the listed console messages'),
     },
+    blockedByDialog: false,
     handler: async (request, response) => {
         response.attachConsoleMessage(request.params.msgid);
     },
 });
+//# sourceMappingURL=console.js.map

package/build/src/tools/emulation.js

@@ -48,8 +48,10 @@ export const emulate = definePageTool({
             .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.`),
     },
+    blockedByDialog: true,
     handler: async (request, _response, context) => {
         const page = request.page;
         await context.emulate(request.params, page.pptrPage);
     },
 });
+//# sourceMappingURL=emulation.js.map

package/build/src/tools/extensions.js

@@ -18,6 +18,7 @@ export const installExtension = defineTool({
             .string()
             .describe('Absolute path to the unpacked extension folder.'),
     },
+    blockedByDialog: false,
     handler: async (request, response, context) => {
         const { path } = request.params;
         const id = await context.installExtension(path);
@@ -34,6 +35,7 @@ export const uninstallExtension = defineTool({
     schema: {
         id: zod.string().describe('ID of the extension to uninstall.'),
     },
+    blockedByDialog: false,
     handler: async (request, response, context) => {
         const { id } = request.params;
         await context.uninstallExtension(id);
@@ -48,6 +50,7 @@ export const listExtensions = defineTool({
         readOnlyHint: true,
     },
     schema: {},
+    blockedByDialog: false,
     handler: async (_request, response, _context) => {
         response.setListExtensions();
     },
@@ -62,6 +65,7 @@ export const reloadExtension = defineTool({
     schema: {
         id: zod.string().describe('ID of the extension to reload.'),
     },
+    blockedByDialog: false,
     handler: async (request, response, context) => {
         const { id } = request.params;
         const extension = await context.getExtension(id);
@@ -82,9 +86,11 @@ export const triggerExtensionAction = defineTool({
     schema: {
         id: zod.string().describe('ID of the extension to trigger the action for.'),
     },
+    blockedByDialog: false,
     handler: async (request, response, context) => {
         const { id } = request.params;
         await context.triggerExtensionAction(id);
         response.appendResponseLine(`Extension action triggered for ID ${id}`);
     },
 });
+//# sourceMappingURL=extensions.js.map

package/build/src/tools/inPage.js

@@ -3,7 +3,7 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { zod, ajv, } from '../third_party/index.js';
+import { zod, ajv } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool } from './ToolDefinition.js';
 export const listInPageTools = definePageTool({
@@ -18,9 +18,9 @@ export const listInPageTools = definePageTool({
     annotations: {
         category: ToolCategory.IN_PAGE,
         readOnlyHint: true,
-        conditions: ['inPageTools'],
     },
     schema: {},
+    blockedByDialog: false,
     handler: async (_request, response, _context) => {
         response.setListInPageTools();
     },
@@ -31,7 +31,6 @@ export const executeInPageTool = definePageTool({
     annotations: {
         category: ToolCategory.IN_PAGE,
         readOnlyHint: false,
-        conditions: ['inPageTools'],
     },
     schema: {
         toolName: zod.string().describe('The name of the tool to execute'),
@@ -40,6 +39,7 @@ export const executeInPageTool = definePageTool({
             .optional()
             .describe('The JSON-stringified parameters to pass to the tool'),
     },
+    blockedByDialog: false,
     handler: async (request, response) => {
         const toolName = request.params.toolName;
         let params = {};
@@ -58,19 +58,6 @@ export const executeInPageTool = definePageTool({
                 throw new Error(`Failed to parse params as JSON: ${errorMessage}`);
             }
         }
-        // Creates array of ElementHandles from the UIDs in the params.
-        // We do not replace the uids with the ElementsHandles yet, because
-        // the `evaluate` function only turns them into DOM elements if they
-        // are passed as non-nested arguments.
-        const handles = [];
-        for (const value of Object.values(params)) {
-            if (value instanceof Object &&
-                'uid' in value &&
-                typeof value.uid === 'string' &&
-                Object.keys(value).length === 1) {
-                handles.push(await request.page.getElementByUid(value.uid));
-            }
-        }
         const toolGroup = request.page.getInPageTools();
         const tool = toolGroup?.tools.find(t => t.name === toolName);
         if (!tool) {
@@ -82,24 +69,7 @@ export const executeInPageTool = definePageTool({
         if (!valid) {
             throw new Error(`Invalid parameters for tool ${toolName}: ${ajvInstance.errorsText(validate.errors)}`);
         }
-        const result = await request.page.pptrPage.evaluate(async (name, args, ...elements) => {
-            // Replace the UIDs with DOM elements.
-            for (const [key, value] of Object.entries(args)) {
-                if (value instanceof Object &&
-                    'uid' in value &&
-                    typeof value.uid === 'string' &&
-                    Object.keys(value).length === 1) {
-                    args[key] = elements.shift();
-                }
-            }
-            if (!window.__dtmcp?.executeTool) {
-                throw new Error('No tools found on the page');
-            }
-            const toolResult = await window.__dtmcp.executeTool(name, args);
-            return {
-                result: toolResult,
-            };
-        }, toolName, params, ...handles);
-        response.appendResponseLine(JSON.stringify(result, null, 2));
+        await request.page.executeInPageTool(toolName, params, response);
     },
 });
+//# sourceMappingURL=inPage.js.map

package/build/src/tools/input.js

@@ -40,6 +40,7 @@ export const click = definePageTool({
         dblClick: dblClickSchema,
         includeSnapshot: includeSnapshotSchema,
     },
+    blockedByDialog: true,
     handler: async (request, response) => {
         const uid = request.params.uid;
         const handle = await request.page.getElementByUid(uid);
@@ -70,7 +71,7 @@ export const clickAt = definePageTool({
     annotations: {
         category: ToolCategory.INPUT,
         readOnlyHint: false,
-        conditions: ['computerVision'],
+        conditions: ['experimentalVision'],
     },
     schema: {
         x: zod.number().describe('The x coordinate'),
@@ -78,6 +79,7 @@ export const clickAt = definePageTool({
         dblClick: dblClickSchema,
         includeSnapshot: includeSnapshotSchema,
     },
+    blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
         await page.waitForEventsAfterAction(async () => {
@@ -106,6 +108,7 @@ export const hover = definePageTool({
             .describe('The uid of an element on the page from the page content snapshot'),
         includeSnapshot: includeSnapshotSchema,
     },
+    blockedByDialog: true,
     handler: async (request, response) => {
         const uid = request.params.uid;
         const handle = await request.page.getElementByUid(uid);
@@ -200,6 +203,7 @@ export const fill = definePageTool({
         value: zod.string().describe('The value to fill in'),
         includeSnapshot: includeSnapshotSchema,
     },
+    blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
         await page.waitForEventsAfterAction(async () => {
@@ -222,6 +226,7 @@ export const typeText = definePageTool({
         text: zod.string().describe('The text to type'),
         submitKey: submitKeySchema,
     },
+    blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
         await page.waitForEventsAfterAction(async () => {
@@ -245,6 +250,7 @@ export const drag = definePageTool({
         to_uid: zod.string().describe('The uid of the element to drop into'),
         includeSnapshot: includeSnapshotSchema,
     },
+    blockedByDialog: true,
     handler: async (request, response) => {
         const fromHandle = await request.page.getElementByUid(request.params.from_uid);
         const toHandle = await request.page.getElementByUid(request.params.to_uid);
@@ -283,6 +289,7 @@ export const fillForm = definePageTool({
             .describe('Elements from snapshot to fill out.'),
         includeSnapshot: includeSnapshotSchema,
     },
+    blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
         for (const element of request.params.elements) {
@@ -310,8 +317,10 @@ export const uploadFile = definePageTool({
         filePath: zod.string().describe('The local path of the file to upload'),
         includeSnapshot: includeSnapshotSchema,
     },
-    handler: async (request, response) => {
+    blockedByDialog: true,
+    handler: async (request, response, context) => {
         const { uid, filePath } = request.params;
+        context.validatePath(filePath);
         const handle = (await request.page.getElementByUid(uid));
         try {
             try {
@@ -355,6 +364,7 @@ export const pressKey = definePageTool({
             .describe('A key or a combination (e.g., "Enter", "Control+A", "Control++", "Control+Shift+R"). Modifiers: Control, Shift, Alt, Meta'),
         includeSnapshot: includeSnapshotSchema,
     },
+    blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
         const tokens = parseKey(request.params.key);
@@ -374,3 +384,4 @@ export const pressKey = definePageTool({
         }
     },
 });
+//# sourceMappingURL=input.js.map

package/build/src/tools/lighthouse.js

@@ -4,13 +4,13 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import path from 'node:path';
-import { snapshot, navigation, generateReport, zod, } from '../third_party/index.js';
+import { snapshot, navigation, generateReport, zod, agenticBrowsingConfig, } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { startTrace } from './performance.js';
 import { definePageTool } from './ToolDefinition.js';
 export const lighthouseAudit = definePageTool({
     name: 'lighthouse_audit',
-    description: `Get Lighthouse score and reports for accessibility, SEO and best practices. This excludes performance. For performance audits, run ${startTrace.name}`,
+    description: `Get Lighthouse score and reports for accessibility, SEO, best practices, and agentic browsing. This excludes performance. For performance audits, run ${startTrace.name}`,
     annotations: {
         category: ToolCategory.DEBUGGING,
         readOnlyHint: false,
@@ -29,11 +29,18 @@ export const lighthouseAudit = definePageTool({
             .optional()
             .describe('Directory for reports. If omitted, uses temporary files.'),
     },
+    blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
-        const categories = ['accessibility', 'seo', 'best-practices'];
+        const categories = [
+            'accessibility',
+            'seo',
+            'best-practices',
+            'agentic-browsing',
+        ];
         const formats = ['json', 'html'];
         const { mode = 'navigation', device = 'desktop', outputDirPath, } = request.params;
+        context.validatePath(outputDirPath);
         const flags = {
             onlyCategories: categories,
             output: formats,
@@ -60,17 +67,17 @@ export const lighthouseAudit = definePageTool({
                 disabled: false,
             };
         }
+        const options = {
+            flags,
+            config: agenticBrowsingConfig,
+        };
         let result;
         try {
             if (mode === 'navigation') {
-                result = await navigation(page.pptrPage, page.pptrPage.url(), {
-                    flags,
-                });
+                result = await navigation(page.pptrPage, page.pptrPage.url(), options);
             }
             else {
-                result = await snapshot(page.pptrPage, {
-                    flags,
-                });
+                result = await snapshot(page.pptrPage, options);
             }
             if (!result) {
                 throw new Error('Lighthouse audit failed.');
@@ -121,3 +128,4 @@ export const lighthouseAudit = definePageTool({
         response.attachLighthouseResult(output);
     },
 });
+//# sourceMappingURL=lighthouse.js.map

package/build/src/tools/memory.js

@@ -19,8 +19,10 @@ export const takeMemorySnapshot = definePageTool({
             .string()
             .describe('A path to a .heapsnapshot file to save the heapsnapshot to.'),
     },
-    handler: async (request, response, _context) => {
+    blockedByDialog: true,
+    handler: async (request, response, context) => {
         const page = request.page;
+        context.validatePath(request.params.filePath);
         await page.pptrPage.captureHeapSnapshot({
             path: ensureExtension(request.params.filePath, '.heapsnapshot'),
         });
@@ -38,7 +40,9 @@ export const exploreMemorySnapshot = defineTool({
     schema: {
         filePath: zod.string().describe('A path to a .heapsnapshot file to read.'),
     },
+    blockedByDialog: false,
     handler: async (request, response, context) => {
+        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);
@@ -63,7 +67,9 @@ export const getMemorySnapshotDetails = defineTool({
             .optional()
             .describe('The page size for pagination of aggregates.'),
     },
+    blockedByDialog: false,
     handler: async (request, response, context) => {
+        context.validatePath(request.params.filePath);
         const aggregates = await context.getHeapSnapshotAggregates(request.params.filePath);
         response.setHeapSnapshotAggregates(aggregates, {
             pageIdx: request.params.pageIdx,
@@ -71,3 +77,30 @@ 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.',
+    annotations: {
+        category: ToolCategory.MEMORY,
+        readOnlyHint: true,
+        conditions: ['experimentalMemory'],
+    },
+    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.'),
+        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);
+        response.setHeapSnapshotNodes(nodes, {
+            pageIdx: request.params.pageIdx,
+            pageSize: request.params.pageSize,
+        });
+    },
+});
+//# sourceMappingURL=memory.js.map

package/build/src/tools/network.js

@@ -57,8 +57,9 @@ export const listNetworkRequests = definePageTool({
             .optional()
             .describe('Set to true to return the preserved requests over the last 3 navigations.'),
     },
+    blockedByDialog: false,
     handler: async (request, response, context) => {
-        const data = await context.getDevToolsData(request.page);
+        const data = await request.page.getDevToolsData();
         response.attachDevToolsData(data);
         const reqid = data?.cdpRequestId
             ? context.resolveCdpRequestId(request.page, data.cdpRequestId)
@@ -93,7 +94,10 @@ export const getNetworkRequest = definePageTool({
             .optional()
             .describe('The absolute or relative path to a .network-response file to save the response body to. If omitted, the body is returned inline.'),
     },
+    blockedByDialog: true,
     handler: async (request, response, context) => {
+        context.validatePath(request.params.requestFilePath);
+        context.validatePath(request.params.responseFilePath);
         if (request.params.reqid) {
             response.attachNetworkRequest(request.params.reqid, {
                 requestFilePath: request.params.requestFilePath,
@@ -101,7 +105,7 @@ export const getNetworkRequest = definePageTool({
             });
         }
         else {
-            const data = await context.getDevToolsData(request.page);
+            const data = await request.page.getDevToolsData();
             response.attachDevToolsData(data);
             const reqid = data?.cdpRequestId
                 ? context.resolveCdpRequestId(request.page, data.cdpRequestId)
@@ -118,3 +122,4 @@ export const getNetworkRequest = definePageTool({
         }
     },
 });
+//# sourceMappingURL=network.js.map