feat: improve zod to json schema conversion

- Add FastMCPCompat.js to monkey-patch zodToJsonSchema function
- Force JSON Schema Draft-07 instead of Draft 2020-12
- Use relative refs for better MCP client compatibility
- Fixes MCP server startup error in Augment IDE and other clients

Closes #1284

Co-authored-by: Ralph Khreish <Crunchyman-ralph@users.noreply.github.com>

docs/models.md

@@ -1,4 +1,4 @@
-# Available Models as of October 5, 2025
+# Available Models as of October 18, 2025
 
 ## Main Models
 
@@ -8,8 +8,11 @@
 | anthropic   | claude-opus-4-20250514                         | 0.725     | 15         | 75          |
 | anthropic   | claude-3-7-sonnet-20250219                     | 0.623     | 3          | 15          |
 | anthropic   | claude-3-5-sonnet-20241022                     | 0.49      | 3          | 15          |
+| anthropic   | claude-sonnet-4-5-20250929                     | 0.73      | 3          | 15          |
+| anthropic   | claude-haiku-4-5-20251001                      | 0.45      | 1          | 5           |
 | claude-code | opus                                           | 0.725     | 0          | 0           |
 | claude-code | sonnet                                         | 0.727     | 0          | 0           |
+| claude-code | haiku                                          | 0.45      | 0          | 0           |
 | codex-cli   | gpt-5                                          | 0.749     | 0          | 0           |
 | codex-cli   | gpt-5-codex                                    | 0.749     | 0          | 0           |
 | mcp         | mcp-sampling                                   | —         | 0          | 0           |
@@ -102,6 +105,7 @@
 | ----------- | -------------------------------------------- | --------- | ---------- | ----------- |
 | claude-code | opus                                         | 0.725     | 0          | 0           |
 | claude-code | sonnet                                       | 0.727     | 0          | 0           |
+| claude-code | haiku                                        | 0.45      | 0          | 0           |
 | codex-cli   | gpt-5                                        | 0.749     | 0          | 0           |
 | codex-cli   | gpt-5-codex                                  | 0.749     | 0          | 0           |
 | mcp         | mcp-sampling                                 | —         | 0          | 0           |
@@ -142,8 +146,11 @@
 | anthropic   | claude-opus-4-20250514                         | 0.725     | 15         | 75          |
 | anthropic   | claude-3-7-sonnet-20250219                     | 0.623     | 3          | 15          |
 | anthropic   | claude-3-5-sonnet-20241022                     | 0.49      | 3          | 15          |
+| anthropic   | claude-sonnet-4-5-20250929                     | 0.73      | 3          | 15          |
+| anthropic   | claude-haiku-4-5-20251001                      | 0.45      | 1          | 5           |
 | claude-code | opus                                           | 0.725     | 0          | 0           |
 | claude-code | sonnet                                         | 0.727     | 0          | 0           |
+| claude-code | haiku                                          | 0.45      | 0          | 0           |
 | codex-cli   | gpt-5                                          | 0.749     | 0          | 0           |
 | codex-cli   | gpt-5-codex                                    | 0.749     | 0          | 0           |
 | mcp         | mcp-sampling                                   | —         | 0          | 0           |

mcp-server/src/FastMCPCompat.js

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview FastMCP Draft-07 Compatibility Patch
+ *
+ * PROBLEM:
+ * - FastMCP uses Zod v3 + zod-to-json-schema → outputs JSON Schema Draft 2020-12
+ * - MCP clients (e.g., Augment IDE) only support Draft-07
+ * - This causes "MCP server startup error" in incompatible clients
+ *
+ * SOLUTION:
+ * Pre-convert Zod v4 schemas to Draft-07 using native toJSONSchema() before
+ * passing to FastMCP, preventing it from doing its own conversion.
+ *
+ * TEMPORARY PATCH:
+ * This will be removed once FastMCP, MCP spec, or Zod addresses the compatibility issue.
+ * Tracking: https://github.com/punkpeye/fastmcp/issues/189
+ */
+
+import { FastMCP as OriginalFastMCP } from 'fastmcp';
+import { toJSONSchema, ZodType } from 'zod';
+
+/**
+ * FastMCP wrapper that converts Zod schemas to JSON Schema Draft-07
+ */
+export class FastMCP extends OriginalFastMCP {
+	addTool(tool) {
+		// Pre-convert Zod schemas to Draft-07 before passing to FastMCP
+		if (tool.parameters instanceof ZodType) {
+			try {
+				const modifiedTool = {
+					...tool,
+					parameters: toJSONSchema(tool.parameters, { target: 'draft-7' })
+				};
+				return super.addTool(modifiedTool);
+			} catch (error) {
+				console.error(
+					`[FastMCPCompat] Failed to convert schema for tool "${tool.name}":`,
+					error
+				);
+			}
+		}
+
+		// Pass through as-is for non-Zod schemas or conversion failures
+		return super.addTool(tool);
+	}
+}

mcp-server/src/index.js

@@ -1,4 +1,4 @@
-import { FastMCP } from 'fastmcp';
+import { FastMCP } from './FastMCPCompat.js';
 import path from 'path';
 import dotenv from 'dotenv';
 import { fileURLToPath } from 'url';