chrome-devtools-mcp 0.24.0 → 0.25.0

package/build/src/third_party/issue-descriptions/genericFormModelContextMissingToolDescription.md

@@ -0,0 +1,5 @@
+# Missing tool description for a WebMCP declarative tool definition
+
+This form is intended to be used as a WebMCP declarative tool definition, but it lacks a description explaining what the tool does. Descriptions are critical for AI models to decide when to use a given tool.
+
+To fix this issue, provide a tool description via the `tooldescription` attribute.

package/build/src/third_party/issue-descriptions/genericFormModelContextMissingToolName.md

@@ -0,0 +1,5 @@
+# Missing tool name for a WebMCP declarative tool definition
+
+This form is intended to be used as a WebMCP declarative tool definition, but it does not specify a name. A tool name is required for an AI model to correctly identify and invoke the tool.
+
+To fix this issue, provide a tool name via the `toolname` attribute.

package/build/src/third_party/issue-descriptions/genericFormModelContextParameterMissingName.md

@@ -0,0 +1,5 @@
+# Parameter missing name for a WebMCP declarative tool definition
+
+An input element within this form lacks a `name` attribute. Without a name, the AI model cannot format the parameter payload correctly when invoking the tool.
+
+To fix this issue, ensure form parameters have a `name` attribute.

package/build/src/third_party/issue-descriptions/genericFormModelContextParameterMissingTitleAndDescription.md

@@ -0,0 +1,5 @@
+# Missing parameter title and description for a WebMCP declarative tool definition
+
+A parameter within this form (such as an `<input>` field) is missing both a title and a description. An AI model needs this metadata to understand what information should be passed to this parameter when invoking the tool.
+
+To fix this issue, add a title and description to the form parameter.

package/build/src/third_party/issue-descriptions/genericFormModelContextRequiredParameterMissingName.md

@@ -0,0 +1,5 @@
+# Required parameter missing name for a WebMCP declarative tool definition
+
+A required input element within this form lacks a `name` attribute. Without a name, the AI model cannot format the parameter payload correctly when invoking the tool.
+
+To fix this issue, ensure all required form parameters have a `name` attribute.

package/build/src/tools/categories.js

@@ -12,8 +12,9 @@ export var ToolCategory;
     ToolCategory["NETWORK"] = "network";
     ToolCategory["DEBUGGING"] = "debugging";
     ToolCategory["EXTENSIONS"] = "extensions";
-    ToolCategory["IN_PAGE"] = "experimentalInPage";
+    ToolCategory["THIRD_PARTY"] = "experimentalThirdParty";
     ToolCategory["MEMORY"] = "memory";
+    ToolCategory["WEBMCP"] = "experimentalWebmcp";
 })(ToolCategory || (ToolCategory = {}));
 export const labels = {
     [ToolCategory.INPUT]: 'Input automation',
@@ -23,11 +24,13 @@ export const labels = {
     [ToolCategory.NETWORK]: 'Network',
     [ToolCategory.DEBUGGING]: 'Debugging',
     [ToolCategory.EXTENSIONS]: 'Extensions',
-    [ToolCategory.IN_PAGE]: 'In-page tools',
+    [ToolCategory.THIRD_PARTY]: 'Third-party',
     [ToolCategory.MEMORY]: 'Memory',
+    [ToolCategory.WEBMCP]: 'WebMCP',
 };
 export const OFF_BY_DEFAULT_CATEGORIES = [
     ToolCategory.EXTENSIONS,
-    ToolCategory.IN_PAGE,
+    ToolCategory.THIRD_PARTY,
+    ToolCategory.WEBMCP,
 ];
 //# sourceMappingURL=categories.js.map

package/build/src/tools/input.js

@@ -26,6 +26,44 @@ function handleActionError(error, uid) {
         cause: error,
     });
 }
+async function selectNativeSelectOption(handle) {
+    const selectHandle = await handle.evaluateHandle(node => {
+        if (!(node instanceof HTMLOptionElement)) {
+            return null;
+        }
+        const select = node.closest('select');
+        if (!select || select.multiple || select.disabled || node.disabled) {
+            return null;
+        }
+        const parentElement = node.parentElement;
+        if (parentElement instanceof HTMLOptGroupElement &&
+            parentElement.disabled) {
+            return null;
+        }
+        return select;
+    });
+    try {
+        const select = selectHandle.asElement();
+        if (!select) {
+            return false;
+        }
+        const valueHandle = await handle.getProperty('value');
+        try {
+            const value = await valueHandle.jsonValue();
+            if (typeof value !== 'string') {
+                return false;
+            }
+            await select.asLocator().fill(value);
+        }
+        finally {
+            void valueHandle.dispose();
+        }
+        return true;
+    }
+    finally {
+        void selectHandle.dispose();
+    }
+}
 export const click = definePageTool({
     name: 'click',
     description: `Clicks on the provided element`,
@@ -44,8 +82,14 @@ export const click = definePageTool({
     handler: async (request, response) => {
         const uid = request.params.uid;
         const handle = await request.page.getElementByUid(uid);
+        const aXNode = request.page.getAXNodeByUid(uid);
+        const shouldSelectNativeOption = !request.params.dblClick && aXNode?.role === 'option';
         try {
             await request.page.waitForEventsAfterAction(async () => {
+                if (shouldSelectNativeOption &&
+                    (await selectNativeSelectOption(handle))) {
+                    return;
+                }
                 await handle.asLocator().click({
                     count: request.params.dblClick ? 2 : 1,
                 });

package/build/src/tools/pages.js

@@ -64,7 +64,7 @@ export const listPages = defineTool(args => {
         blockedByDialog: false,
         handler: async (_request, response) => {
             response.setIncludePages(true);
-            response.setListInPageTools();
+            response.setListThirdPartyDeveloperTools();
             response.setListWebMcpTools();
         },
     };
@@ -90,7 +90,7 @@ export const selectPage = defineTool({
         const page = context.getPageById(request.params.pageId);
         context.selectPage(page);
         response.setIncludePages(true);
-        response.setListInPageTools();
+        response.setListThirdPartyDeveloperTools();
         response.setListWebMcpTools();
         if (request.params.bringToFront) {
             await page.pptrPage.bringToFront();
@@ -123,7 +123,7 @@ export const closePage = defineTool({
             }
         }
         response.setIncludePages(true);
-        response.setListInPageTools();
+        response.setListThirdPartyDeveloperTools();
     },
 });
 export const newPage = defineTool(args => {
@@ -163,7 +163,7 @@ export const newPage = defineTool(args => {
                 timeout: request.params.timeout,
             }), request.params.allowList, request.params.timeout);
             response.setIncludePages(true);
-            response.setListInPageTools();
+            response.setListThirdPartyDeveloperTools();
         },
     };
 });
@@ -295,7 +295,7 @@ export const navigatePage = definePageTool(args => {
                 }
             }
             response.setIncludePages(true);
-            response.setListInPageTools();
+            response.setListThirdPartyDeveloperTools();
             response.setListWebMcpTools();
         },
     };

package/build/src/tools/{inPage.js → thirdPartyDeveloper.js}

@@ -6,30 +6,30 @@
 import { zod, ajv } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool } from './ToolDefinition.js';
-export const listInPageTools = definePageTool({
-    name: 'list_in_page_tools',
-    description: `Lists all in-page tools the page exposes for providing runtime information.
-  In-page tools can be called via the 'execute_in_page_tool()' MCP tool.
-  Alternatively, in-page tools can be executed by calling 'evaluate_script' and adding the
+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 in-page-tools return non-serializable values or when composing
-  the in-page-tools with additional functionality.`,
+  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.IN_PAGE,
+        category: ToolCategory.THIRD_PARTY,
         readOnlyHint: true,
     },
     schema: {},
     blockedByDialog: false,
     handler: async (_request, response, _context) => {
-        response.setListInPageTools();
+        response.setListThirdPartyDeveloperTools();
     },
 });
-export const executeInPageTool = definePageTool({
-    name: 'execute_in_page_tool',
+export const executeThirdPartyDeveloperTool = definePageTool({
+    name: 'execute_3p_developer_tool',
     description: `Executes a tool exposed by the page.`,
     annotations: {
-        category: ToolCategory.IN_PAGE,
+        category: ToolCategory.THIRD_PARTY,
         readOnlyHint: false,
     },
     schema: {
@@ -58,7 +58,7 @@ export const executeInPageTool = definePageTool({
                 throw new Error(`Failed to parse params as JSON: ${errorMessage}`);
             }
         }
-        const toolGroup = request.page.getInPageTools();
+        const toolGroup = request.page.getThirdPartyDeveloperTools();
         const tool = toolGroup?.tools.find(t => t.name === toolName);
         if (!tool) {
             throw new Error(`Tool ${toolName} not found`);
@@ -69,7 +69,7 @@ export const executeInPageTool = definePageTool({
         if (!valid) {
             throw new Error(`Invalid parameters for tool ${toolName}: ${ajvInstance.errorsText(validate.errors)}`);
         }
-        await request.page.executeInPageTool(toolName, params, response);
+        await request.page.executeThirdPartyDeveloperTool(toolName, params, response);
     },
 });
-//# sourceMappingURL=inPage.js.map
+//# sourceMappingURL=thirdPartyDeveloper.js.map

package/build/src/tools/tools.js

@@ -6,7 +6,6 @@
 import * as consoleTools from './console.js';
 import * as emulationTools from './emulation.js';
 import * as extensionTools from './extensions.js';
-import * as inPageTools from './inPage.js';
 import * as inputTools from './input.js';
 import * as lighthouseTools from './lighthouse.js';
 import * as memoryTools from './memory.js';
@@ -18,6 +17,7 @@ import * as screenshotTools from './screenshot.js';
 import * as scriptTools from './script.js';
 import * as slimTools from './slim/tools.js';
 import * as snapshotTools from './snapshot.js';
+import * as thirdPartyDeveloperTools from './thirdPartyDeveloper.js';
 import * as webmcpTools from './webmcp.js';
 export const createTools = (args) => {
     const rawTools = args.slim
@@ -26,7 +26,6 @@ export const createTools = (args) => {
             ...Object.values(consoleTools),
             ...Object.values(emulationTools),
             ...Object.values(extensionTools),
-            ...Object.values(inPageTools),
             ...Object.values(inputTools),
             ...Object.values(lighthouseTools),
             ...Object.values(memoryTools),
@@ -37,6 +36,7 @@ export const createTools = (args) => {
             ...Object.values(screenshotTools),
             ...Object.values(scriptTools),
             ...Object.values(snapshotTools),
+            ...Object.values(thirdPartyDeveloperTools),
             ...Object.values(webmcpTools),
         ];
     const tools = [];

package/build/src/tools/webmcp.js

@@ -10,9 +10,8 @@ export const listWebMcpTools = definePageTool({
     name: 'list_webmcp_tools',
     description: `Lists all WebMCP tools the page exposes.`,
     annotations: {
-        category: ToolCategory.DEBUGGING,
+        category: ToolCategory.WEBMCP,
         readOnlyHint: true,
-        conditions: ['experimentalWebmcp'],
     },
     schema: {},
     blockedByDialog: false,
@@ -24,9 +23,8 @@ export const executeWebMcpTool = definePageTool({
     name: 'execute_webmcp_tool',
     description: `Executes a WebMCP tool exposed by the page.`,
     annotations: {
-        category: ToolCategory.DEBUGGING,
+        category: ToolCategory.WEBMCP,
         readOnlyHint: false,
-        conditions: ['experimentalWebmcp'],
     },
     schema: {
         toolName: zod.string().describe('The name of the WebMCP tool to execute'),

package/build/src/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.24.0",
+  "version": "0.25.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.1618066",
+    "chrome-devtools-frontend": "1.0.1625079",
     "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
@@ -71,13 +71,12 @@
     "globals": "^17.0.0",
     "lighthouse": "13.2.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.42.0",
+    "puppeteer": "24.43.0",
     "rollup": "4.60.2",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "semver": "^7.7.4",
     "sinon": "^21.0.0",
-    "tiktoken": "^1.0.22",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.43.0",
     "urlpattern-polyfill": "^10.1.0",