fix: process inline type literals for @description conversion

Add processPropertiesRecursively() to handle nested type literals within
interface properties. This ensures fields in inline types like:

  tasks?: {
    /** Whether this server supports tasks/list. */
    list?: object;
  }

Get their comments converted to @description and generate .describe() calls.

- Reordered transforms: convertJsDocToDescription now runs BEFORE injectDerivedCapabilityTypes
- 327 comments converted (up from 294)
- 226 .describe() calls in schemas (up from 183)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ochafik

scripts/generate-schemas.ts

@@ -155,12 +155,13 @@ function preProcessTypes(content: string): string {
     // Transform 4: Update Request.params to use RequestParams
     updateRequestParamsType(sourceFile);
 
-    // Transform 5: Add derived capability types
-    injectDerivedCapabilityTypes(sourceFile);
-
-    // Transform 6: Convert JSDoc comments to @description tags for .describe() generation
+    // Transform 5: Convert JSDoc comments to @description tags for .describe() generation
+    // (Must run before injectDerivedCapabilityTypes so inline types get @description)
     convertJsDocToDescription(sourceFile);
 
+    // Transform 6: Add derived capability types (extracts from parent interfaces)
+    injectDerivedCapabilityTypes(sourceFile);
+
     return sourceFile.getFullText();
 }
 
@@ -347,15 +348,13 @@ function injectDerivedCapabilityTypes(sourceFile: SourceFile): void {
 function convertJsDocToDescription(sourceFile: SourceFile): void {
     let count = 0;
 
-    // Process all interfaces
+    // Process all interfaces and their nested type literals
     for (const iface of sourceFile.getInterfaces()) {
         // Convert interface-level JSDoc
         count += convertNodeJsDoc(iface);
 
-        // Convert property-level JSDoc
-        for (const prop of iface.getProperties()) {
-            count += convertNodeJsDoc(prop);
-        }
+        // Convert property-level JSDoc (including nested type literals)
+        count += processPropertiesRecursively(iface);
     }
 
     // Process all type aliases
@@ -366,6 +365,30 @@ function convertJsDocToDescription(sourceFile: SourceFile): void {
     console.log(`    ✓ Converted ${count} JSDoc comments to @description`);
 }
 
+/**
+ * Recursively process properties, including those in inline type literals.
+ */
+function processPropertiesRecursively(node: { getProperties?: () => Array<unknown>; getTypeNode?: () => unknown }): number {
+    let count = 0;
+
+    // Process direct properties
+    if (node.getProperties) {
+        for (const prop of node.getProperties() as Array<{ getJsDocs: () => unknown[]; getTypeNode?: () => unknown }>) {
+            count += convertNodeJsDoc(prop as Parameters<typeof convertNodeJsDoc>[0]);
+
+            // Check if the property has an inline type literal
+            if (prop.getTypeNode) {
+                const typeNode = prop.getTypeNode();
+                if (typeNode && typeof typeNode === 'object' && 'getProperties' in typeNode) {
+                    count += processPropertiesRecursively(typeNode as { getProperties: () => Array<unknown> });
+                }
+            }
+        }
+    }
+
+    return count;
+}
+
 /**
  * Convert a node's JSDoc comment to use @description tag.
  * Returns 1 if converted, 0 otherwise.