feat: add schema export script for reviewer verification

- Add scripts/export-schemas-to-json.ts to export all Zod schemas as JSON Schema
- Add npm run export:schemas command
- Add missing TaskAugmentedRequestParamsSchema to re-exports

Reviewers can verify schema compatibility:
  git checkout main && npm run export:schemas > main.json
  git checkout pr-branch && npm run export:schemas > pr.json
  diff main.json pr.json

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

Co-Authored-By: Claude <[email protected]>

Author: ochafik

package.json

@@ -69,6 +69,7 @@
     "scripts": {
         "fetch:spec-types": "tsx scripts/fetch-spec-types.ts",
         "generate:schemas": "tsx scripts/generate-schemas.ts && prettier --write \"src/generated/**/*\"",
+        "export:schemas": "npm run build && tsx scripts/export-schemas-to-json.ts",
         "typecheck": "tsgo --noEmit",
         "build": "npm run build:esm && npm run build:cjs",
         "build:esm": "mkdir -p dist/esm && echo '{\"type\": \"module\"}' > dist/esm/package.json && tsc -p tsconfig.prod.json",

scripts/export-schemas-to-json.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env npx tsx
+/**
+ * Export all Zod schemas to JSON Schema format for comparison.
+ *
+ * This script is useful for verifying that schema changes don't break compatibility.
+ *
+ * Usage:
+ *   # On main branch
+ *   npx tsx scripts/export-schemas-to-json.ts > main-schemas.json
+ *
+ *   # On PR branch
+ *   npx tsx scripts/export-schemas-to-json.ts > pr-schemas.json
+ *
+ *   # Compare
+ *   diff main-schemas.json pr-schemas.json
+ */
+
+import { toJSONSchema } from 'zod/v4-mini';
+import type { $ZodType } from 'zod/v4/core';
+import * as types from '../dist/esm/types.js';
+
+// Get all exports that end with "Schema" and are Zod schemas
+const schemaExports: Record<string, unknown> = {};
+
+for (const [name, value] of Object.entries(types)) {
+    if (name.endsWith('Schema') && value && typeof value === 'object' && '_zod' in value) {
+        try {
+            // Convert to JSON Schema using Zod v4's built-in converter
+            const jsonSchema = toJSONSchema(value as $ZodType, {
+                target: 'draft-7',
+            });
+            schemaExports[name] = jsonSchema;
+        } catch (e) {
+            // Some schemas might not convert cleanly, note them
+            schemaExports[name] = { error: `Failed to convert: ${e}` };
+        }
+    }
+}
+
+// Sort by name for deterministic output
+const sortedSchemas: Record<string, unknown> = {};
+for (const name of Object.keys(schemaExports).sort()) {
+    sortedSchemas[name] = schemaExports[name];
+}
+
+// Output as pretty-printed JSON
+console.log(JSON.stringify(sortedSchemas, null, 2));

src/types.ts

@@ -266,6 +266,7 @@ export {
     RequestSchema,
     NotificationSchema,
     ResultSchema,
+    TaskAugmentedRequestParamsSchema,
     PaginatedResultSchema,
     PaginatedRequestSchema,
     PingRequestSchema,