chore: unify in page tools category convention

Author: nroscino

docs/tool-reference.md

@@ -398,7 +398,7 @@ in the DevTools Elements panel (if any).
 
 ## Extensions
 
-> NOTE: Extensions are not active by default. Use the '--category-extensions' flag
+> NOTE: Extensions are not active by default. Use the '--categoryExtensions' flag
 
 ### `install_extension`
 

scripts/generate-docs.ts

@@ -13,6 +13,7 @@ import {get_encoding} from 'tiktoken';
 
 import {cliOptions} from '../build/src/bin/chrome-devtools-mcp-cli-options.js';
 import type {ParsedArguments} from '../build/src/bin/chrome-devtools-mcp-cli-options.js';
+import {buildFlag} from '../build/src/index.js';
 import {
   ToolCategory,
   OFF_BY_DEFAULT_CATEGORIES,
@@ -356,7 +357,7 @@ async function generateReference(
     markdown += `## ${categoryName}\n\n`;
 
     if (OFF_BY_DEFAULT_CATEGORIES.includes(category)) {
-      const flagName = `--category-${category}`;
+      const flagName = `--${buildFlag(category)}`;
 
       markdown += `> NOTE: ${categoryName} are not active by default. Use the '${flagName}' flag\n\n`;
     }
@@ -446,6 +447,11 @@ function getToolsAndCategories(tools: any) {
   // Convert ToolDefinitions to ToolWithAnnotations
   const toolsWithAnnotations: ToolWithAnnotations[] = tools
     .filter(tool => {
+      // Skipping in_page tools as they are not launched yet
+      if (tool.annotations.category.includes('experimental')) {
+        return false;
+      }
+
       if (!tool.annotations.conditions) {
         return true;
       }

src/tools/categories.ts

@@ -12,7 +12,7 @@ export enum ToolCategory {
   NETWORK = 'network',
   DEBUGGING = 'debugging',
   EXTENSIONS = 'extensions',
-  IN_PAGE = 'inPageTools',
+  IN_PAGE = 'experimentalInPage',
   MEMORY = 'memory',
 }
 

src/tools/inPage.ts

@@ -48,7 +48,6 @@ export const listInPageTools = definePageTool({
   annotations: {
     category: ToolCategory.IN_PAGE,
     readOnlyHint: true,
-    conditions: ['experimentalInPageTools'],
   },
   schema: {},
   handler: async (_request, response, _context) => {
@@ -62,7 +61,6 @@ export const executeInPageTool = definePageTool({
   annotations: {
     category: ToolCategory.IN_PAGE,
     readOnlyHint: false,
-    conditions: ['experimentalInPageTools'],
   },
   schema: {
     toolName: zod.string().describe('The name of the tool to execute'),

tests/index.test.ts

@@ -114,7 +114,7 @@ describe('e2e', () => {
         );
         assert.ok(listInPageTools);
       },
-      ['--category-in-page-tools', '--experimental-in-page-tools'],
+      ['--category-experimental-in-page'],
     );
   });