Function getToolsAndCategories

scripts/generate-docs.ts:435–513

(tools: any)

// eslint-disable-next-line @typescript-eslint/no-explicit-any
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 === ToolCategory.IN_PAGE) {
        return false;
      }

      // Skipping internal interop tools not meant for public documentation
      const skipTools = ['get_tab_id'];
      if (skipTools.includes(tool.name)) {
        return false;
      }

      return true;
    })
    .map(tool => {
      const properties: Record<string, TypeInfo> = {};
      const required: string[] = [];

      for (const [key, schema] of Object.entries(
        tool.schema as unknown as Record<string, ZodSchema>,
      )) {
        const info = getZodTypeInfo(schema);
        properties[key] = info;
        if (isRequired(schema)) {
          required.push(key);
        }
      }

      return {
        name: tool.name,
        description: tool.description,
        inputSchema: {
          type: 'object',
          properties,
          required,
        },
        annotations: tool.annotations,
      };
    });
  // Group tools by category (based on annotations)
  const categories: Record<string, ToolWithAnnotations[]> = {};
  toolsWithAnnotations.forEach((tool: ToolWithAnnotations) => {
    const category = tool.annotations?.category || 'Uncategorized';
    if (!categories[category]) {
      categories[category] = [];
    }
    categories[category].push(tool);
  });

  // Sort categories using the enum order
  const categoryOrder = Object.values(ToolCategory);
  const sortedCategories = Object.keys(categories).sort((a, b) => {
    const aOff = OFF_BY_DEFAULT_CATEGORIES.includes(a as ToolCategory);
    const bOff = OFF_BY_DEFAULT_CATEGORIES.includes(b as ToolCategory);