feat: add @description JSDoc tags for .describe() generation

When extracting derived capability types during pre-processing, copy the
parent property's JSDoc description and add it as @description tag.

ts-to-zod then converts @description to .describe() calls in schemas:
- ClientTasksCapabilitySchema.describe('Present if the client supports...')
- ServerTasksCapabilitySchema.describe('Present if the server supports...')

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

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

Author: ochafik

scripts/generate-schemas.ts

@@ -318,12 +318,16 @@ function injectDerivedCapabilityTypes(sourceFile: SourceFile): void {
         // Remove trailing '?' or '| undefined' to get the non-optional type
         typeText = typeText.replace(/\s*\|\s*undefined\s*$/, '').trim();
 
-        // Create the derived type alias
+        // Get the JSDoc comment from the parent property for @description
+        const jsDocs = prop.getJsDocs();
+        const description = jsDocs.length > 0 ? jsDocs[0].getDescription().trim() : '';
+
+        // Create the derived type alias with @description for .describe() generation
         sourceFile.addTypeAlias({
             name: typeName,
             isExported: true,
             type: typeText,
-            docs: [`Extracted from ${parent}["${property}"] for standalone use.`]
+            docs: [description ? `@description ${description}` : `Extracted from ${parent}["${property}"].`]
         });
         console.log(`    ✓ Added derived type: ${typeName} from ${parent}.${property}`);
     }

src/generated/sdk.schemas.ts

@@ -1960,76 +1960,80 @@ export const ListToolsResultSchema = PaginatedResultSchema.extend({
     tools: z.array(ToolSchema)
 });
 
-/** Extracted from ClientCapabilities["tasks"] for standalone use. */
-export const ClientTasksCapabilitySchema = z.object({
-    /**
-     * Whether this client supports tasks/list.
-     */
-    list: z.record(z.string(), z.any()).optional(),
-    /**
-     * Whether this client supports tasks/cancel.
-     */
-    cancel: z.record(z.string(), z.any()).optional(),
-    /**
-     * Specifies which request types can be augmented with tasks.
-     */
-    requests: z
-        .object({
-            /**
-             * Task support for sampling-related requests.
-             */
-            sampling: z
-                .object({
-                    /**
-                     * Whether the client supports task-augmented sampling/createMessage requests.
-                     */
-                    createMessage: z.record(z.string(), z.any()).optional()
-                })
-                .optional(),
-            /**
-             * Task support for elicitation-related requests.
-             */
-            elicitation: z
-                .object({
-                    /**
-                     * Whether the client supports task-augmented elicitation/create requests.
-                     */
-                    create: z.record(z.string(), z.any()).optional()
-                })
-                .optional()
-        })
-        .optional()
-});
+/** @description Present if the client supports task-augmented requests. */
+export const ClientTasksCapabilitySchema = z
+    .object({
+        /**
+         * Whether this client supports tasks/list.
+         */
+        list: z.record(z.string(), z.any()).optional(),
+        /**
+         * Whether this client supports tasks/cancel.
+         */
+        cancel: z.record(z.string(), z.any()).optional(),
+        /**
+         * Specifies which request types can be augmented with tasks.
+         */
+        requests: z
+            .object({
+                /**
+                 * Task support for sampling-related requests.
+                 */
+                sampling: z
+                    .object({
+                        /**
+                         * Whether the client supports task-augmented sampling/createMessage requests.
+                         */
+                        createMessage: z.record(z.string(), z.any()).optional()
+                    })
+                    .optional(),
+                /**
+                 * Task support for elicitation-related requests.
+                 */
+                elicitation: z
+                    .object({
+                        /**
+                         * Whether the client supports task-augmented elicitation/create requests.
+                         */
+                        create: z.record(z.string(), z.any()).optional()
+                    })
+                    .optional()
+            })
+            .optional()
+    })
+    .describe('Present if the client supports task-augmented requests.');
 
-/** Extracted from ServerCapabilities["tasks"] for standalone use. */
-export const ServerTasksCapabilitySchema = z.object({
-    /**
-     * Whether this server supports tasks/list.
-     */
-    list: z.record(z.string(), z.any()).optional(),
-    /**
-     * Whether this server supports tasks/cancel.
-     */
-    cancel: z.record(z.string(), z.any()).optional(),
-    /**
-     * Specifies which request types can be augmented with tasks.
-     */
-    requests: z
-        .object({
-            /**
-             * Task support for tool-related requests.
-             */
-            tools: z
-                .object({
-                    /**
-                     * Whether the server supports task-augmented tools/call requests.
-                     */
-                    call: z.record(z.string(), z.any()).optional()
-                })
-                .optional()
-        })
-        .optional()
-});
+/** @description Present if the server supports task-augmented requests. */
+export const ServerTasksCapabilitySchema = z
+    .object({
+        /**
+         * Whether this server supports tasks/list.
+         */
+        list: z.record(z.string(), z.any()).optional(),
+        /**
+         * Whether this server supports tasks/cancel.
+         */
+        cancel: z.record(z.string(), z.any()).optional(),
+        /**
+         * Specifies which request types can be augmented with tasks.
+         */
+        requests: z
+            .object({
+                /**
+                 * Task support for tool-related requests.
+                 */
+                tools: z
+                    .object({
+                        /**
+                         * Whether the server supports task-augmented tools/call requests.
+                         */
+                        call: z.record(z.string(), z.any()).optional()
+                    })
+                    .optional()
+            })
+            .optional()
+    })
+    .describe('Present if the server supports task-augmented requests.');
 
 /**
  * A request that expects a response.

src/generated/sdk.types.ts

@@ -2557,7 +2557,7 @@ export type ServerResult =
     | GetTaskPayloadResult
     | ListTasksResult
     | CancelTaskResult;
-/** Extracted from ClientCapabilities["tasks"] for standalone use. */
+/** @description Present if the client supports task-augmented requests. */
 export type ClientTasksCapability = {
     /**
      * Whether this client supports tasks/list.
@@ -2591,7 +2591,7 @@ export type ClientTasksCapability = {
         };
     };
 };
-/** Extracted from ServerCapabilities["tasks"] for standalone use. */
+/** @description Present if the server supports task-augmented requests. */
 export type ServerTasksCapability = {
     /**
      * Whether this server supports tasks/list.