@monotykamary/pi-opencode-provider 1.0.6 → 1.0.7

package/README.md

@@ -15,7 +15,7 @@ _GPT, Claude, Gemini, GLM, MiniMax, Kimi, DeepSeek — unified API for [pi](http
 
 ## Features
 
-- **60+ AI Models** including GPT-5.x Codex, Claude Opus/Sonnet/Haiku, Gemini 3.x, GLM, MiniMax, Kimi K2.5, and more
+- **62+ AI Models** including GPT-5.x Codex, Claude Opus/Sonnet/Haiku, Gemini 3.x, GLM, MiniMax, Kimi K2.5, and more
 - **Multi-API Support** — uses the correct API protocol per model (Anthropic, OpenAI Responses, OpenAI Completions, Gemini)
 - **Cost Tracking** with per-model pricing for budget management
 - **Reasoning Models** with thinking level maps for proper effort control
@@ -83,14 +83,15 @@ pi
 | Claude Opus 4.7 | Anthropic | Text + Image | 1.0M | 128K | $5.00 | $25.00 |
 | Claude Opus 4.8 | Anthropic | Text + Image | 1.0M | 128K | $5.00 | $25.00 |
 | Claude Opus 5 | Anthropic | Text + Image | 1.0M | 128K | $5.00 | $25.00 |
-| Claude Sonnet 4 | Anthropic | Text + Image | 1.0M | 64K | $3.00 | $15.00 |
-| Claude Sonnet 4.5 | Anthropic | Text + Image | 1.0M | 64K | $3.00 | $15.00 |
+| Claude Sonnet 4 | Anthropic | Text + Image | 200K | 64K | $3.00 | $15.00 |
+| Claude Sonnet 4.5 | Anthropic | Text + Image | 200K | 64K | $3.00 | $15.00 |
 | Claude Sonnet 4.6 | Anthropic | Text + Image | 1.0M | 64K | $3.00 | $15.00 |
 | Claude Sonnet 5 | Anthropic | Text + Image | 1.0M | 128K | $2.00 | $10.00 |
 | DeepSeek V4 Flash | Completions | Text | 1.0M | 384K | $0.14 | $0.28 |
 | DeepSeek V4 Flash Free | Completions | Text | 200K | 128K | Free | Free |
 | DeepSeek V4 Pro | Completions | Text | 1.0M | 384K | $1.74 | $3.84 |
 | Gemini 3 Flash | Gemini | Text + Image | 1.0M | 66K | $0.50 | $3.00 |
+| Gemini 3 Pro | Gemini | Text + Image | 1.0M | 66K | $1.25 | $10.00 |
 | Gemini 3.1 Pro Preview | Gemini | Text + Image | 1.0M | 66K | $2.00 | $12.00 |
 | Gemini 3.5 Flash | Gemini | Text + Image | 1.0M | 66K | $1.50 | $9.00 |
 | Gemini 3.5 Flash Lite | Gemini | Text + Image | 1.0M | 66K | $0.30 | $2.50 |
@@ -109,7 +110,7 @@ pi
 | GPT-5.2 Codex | Responses | Text + Image | 400K | 128K | $1.75 | $14.00 |
 | GPT-5.3 Codex | Responses | Text + Image | 400K | 128K | $1.75 | $14.00 |
 | GPT-5.3 Codex Spark | Responses | Text | 128K | 128K | $1.75 | $14.00 |
-| GPT-5.4 | Responses | Text + Image | 1.1M | 128K | $2.50 | $15.00 |
+| GPT-5.4 | Responses | Text + Image | 272K | 128K | $2.50 | $15.00 |
 | GPT-5.4 Mini | Responses | Text + Image | 400K | 128K | $0.75 | $4.50 |
 | GPT-5.4 Nano | Responses | Text + Image | 400K | 128K | $0.20 | $1.25 |
 | GPT-5.4 Pro | Responses | Text + Image | 1.1M | 128K | $30.00 | $180.00 |
@@ -120,6 +121,7 @@ pi
 | GPT-5.6 Terra | Responses | Text + Image | 1.1M | 128K | $2.50 | $15.00 |
 | Grok 4.5 | Responses | Text + Image | 500K | 500K | $2.00 | $6.00 |
 | Grok Build 0.1 | Completions | Text + Image | 256K | 256K | $1.00 | $2.00 |
+| Grok Code | Completions | Text + Image | 256K | 256K | $1.00 | $2.00 |
 | Kimi K2.5 | Completions | Text + Image | 262K | 66K | $0.60 | $3.00 |
 | Kimi K2.6 | Completions | Text + Image | 262K | 66K | $0.95 | $4.00 |
 | Kimi K2.7 Code | Completions | Text + Image | 262K | 262K | $0.95 | $4.00 |

package/models.json

@@ -283,7 +283,7 @@
   },
   {
     "id": "deepseek-v4-flash",
-    "name": "DeepSeek V4 Flash",
+    "name": "DeepSeek V4 Flash 0731",
     "api": "openai-completions",
     "baseUrl": "https://opencode.ai/zen/v1",
     "reasoning": true,
@@ -429,7 +429,7 @@
   },
   {
     "id": "deepseek-v4-flash-free",
-    "name": "DeepSeek V4 Flash Free",
+    "name": "DeepSeek V4 Flash Free (New)",
     "api": "openai-completions",
     "baseUrl": "https://opencode.ai/zen/v1",
     "reasoning": true,
@@ -758,10 +758,10 @@
       "image"
     ],
     "cost": {
-      "input": 1,
-      "output": 6,
-      "cacheRead": 0.1,
-      "cacheWrite": 1.25
+      "input": 0.2,
+      "output": 1.2,
+      "cacheRead": 0.02,
+      "cacheWrite": 0.25
     },
     "contextWindow": 1050000,
     "maxTokens": 128000

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monotykamary/pi-opencode-provider",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Opencode provider extension for pi - Access GPT, Claude, Gemini, GLM, MiniMax, Kimi and more through the opencode.ai API",
   "type": "module",
   "main": "index.ts",

package/patch.json

@@ -1,49 +1,118 @@
 {
-  "claude-opus-4-6": {
-    "compat": {
-      "forceAdaptiveThinking": true
-    },
+  "gpt-5.1-codex-mini": {
     "thinkingLevelMap": {
-      "max": "max"
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "claude-opus-4-7": {
+  "claude-sonnet-4-6": {
+    "thinkingLevelMap": {
+      "max": "max"
+    },
     "compat": {
       "forceAdaptiveThinking": true
-    },
+    }
+  },
+  "gpt-5.5-pro": {
     "thinkingLevelMap": {
-      "xhigh": "xhigh"
+      "off": null,
+      "minimal": null,
+      "low": null,
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "claude-opus-4-8": {
+  "glm-5": {
     "compat": {
-      "forceAdaptiveThinking": true
-    },
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "gemini-3.5-flash": {
     "thinkingLevelMap": {
+      "off": null
+    }
+  },
+  "gpt-5.3-codex-spark": {
+    "thinkingLevelMap": {
+      "off": null,
       "xhigh": "xhigh"
     }
   },
-  "deepseek-v4-flash-free": {
-    "compat": {
-      "requiresReasoningContentOnAssistantMessages": true,
-      "thinkingFormat": "deepseek"
-    },
+  "gpt-5.4-pro": {
     "thinkingLevelMap": {
+      "off": null,
       "minimal": null,
       "low": null,
-      "medium": null,
+      "medium": "medium",
       "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
+    }
+  },
+  "gpt-5.6-sol": {
+    "thinkingLevelMap": {
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
       "max": "max"
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "gemini-3-flash": {
+  "glm-5.1": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "gemini-3.5-flash-lite": {
     "thinkingLevelMap": {
       "off": null
     }
   },
-  "gemini-3-pro": {
+  "claude-opus-4-6": {
     "thinkingLevelMap": {
-      "off": null
+      "max": "max"
+    },
+    "compat": {
+      "forceAdaptiveThinking": true
+    }
+  },
+  "claude-fable-5": {
+    "thinkingLevelMap": {
+      "off": null,
+      "xhigh": "xhigh",
+      "max": "max"
+    },
+    "compat": {
+      "forceAdaptiveThinking": true
     }
   },
   "gemini-3.1-pro": {
@@ -55,139 +124,538 @@
       "high": "HIGH"
     }
   },
-  "gemini-3.5-flash": {
+  "deepseek-v4-flash": {
+    "name": "DeepSeek V4 Flash",
     "thinkingLevelMap": {
-      "off": null
+      "off": null,
+      "minimal": null,
+      "low": null,
+      "medium": null,
+      "high": "high",
+      "xhigh": null,
+      "max": "max"
+    },
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens",
+      "supportsLongCacheRetention": false,
+      "requiresReasoningContentOnAssistantMessages": true
     }
   },
-  "gpt-5": {
+  "kimi-k2.5": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens",
+      "supportsLongCacheRetention": false
+    }
+  },
+  "minimax-m2.7": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens",
+      "supportsLongCacheRetention": false
+    }
+  },
+  "claude-opus-4-8": {
     "thinkingLevelMap": {
-      "off": null
+      "xhigh": "xhigh",
+      "max": "max"
+    },
+    "compat": {
+      "forceAdaptiveThinking": true,
+      "supportsTemperature": false
     }
   },
-  "gpt-5-codex": {
+  "north-mini-code-free": {
     "thinkingLevelMap": {
-      "off": null
+      "off": "none",
+      "minimal": null,
+      "low": null,
+      "medium": null,
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
     }
   },
-  "gpt-5-nano": {
+  "glm-5.2": {
     "thinkingLevelMap": {
-      "off": null
+      "off": null,
+      "minimal": null,
+      "low": null,
+      "medium": null,
+      "high": "high",
+      "xhigh": null,
+      "max": "max"
+    },
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
     }
   },
-  "gpt-5.1": {
+  "ling-3.0-flash-free": {
     "thinkingLevelMap": {
-      "off": null
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
     }
   },
-  "gpt-5.1-codex": {
+  "laguna-s-2.1-free": {
     "thinkingLevelMap": {
-      "off": null
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
     }
   },
-  "gpt-5.1-codex-max": {
+  "deepseek-v4-flash-free": {
+    "name": "DeepSeek V4 Flash Free",
     "thinkingLevelMap": {
-      "off": null
+      "off": null,
+      "minimal": null,
+      "low": null,
+      "medium": null,
+      "high": "high",
+      "xhigh": null,
+      "max": "max"
+    },
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens",
+      "requiresReasoningContentOnAssistantMessages": true
     }
   },
-  "gpt-5.1-codex-mini": {
+  "gemini-3-flash": {
     "thinkingLevelMap": {
       "off": null
     }
   },
-  "gpt-5.2": {
+  "kimi-k2.6": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "thinkingFormat": "deepseek",
+      "supportsReasoningEffort": false,
+      "maxTokensField": "max_tokens",
+      "supportsLongCacheRetention": false
+    }
+  },
+  "gpt-5.5": {
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "gpt-5.2-codex": {
+  "minimax-m3": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "gpt-5": {
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": "minimal",
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "gpt-5.3-codex": {
+  "gpt-5-codex": {
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "gpt-5.3-codex-spark": {
+  "claude-sonnet-4-5": {
+    "contextWindow": 200000
+  },
+  "deepseek-v4-pro": {
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": null,
+      "low": null,
+      "medium": null,
+      "high": "high",
+      "xhigh": null,
+      "max": "max"
+    },
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens",
+      "supportsLongCacheRetention": false,
+      "requiresReasoningContentOnAssistantMessages": true
     }
   },
   "gpt-5.4": {
+    "contextWindow": 272000,
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "gpt-5.4-mini": {
+  "gpt-5.2-codex": {
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
   "gpt-5.4-nano": {
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "gpt-5.4-pro": {
+  "gemini-3.6-flash": {
+    "thinkingLevelMap": {
+      "off": null
+    }
+  },
+  "claude-sonnet-4": {
+    "contextWindow": 200000
+  },
+  "gpt-5.4-mini": {
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "gpt-5.5": {
+  "minimax-m2.5": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "gpt-5.6-luna": {
+    "cost": {
+      "input": 1,
+      "output": 6,
+      "cacheRead": 0.1,
+      "cacheWrite": 1.25
+    },
     "thinkingLevelMap": {
       "off": null,
-      "xhigh": "xhigh"
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": "max"
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "gpt-5.5-pro": {
+  "mimo-v2.5-free": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "gpt-5.2": {
+    "thinkingLevelMap": {
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
+    }
+  },
+  "gpt-5.3-codex": {
     "thinkingLevelMap": {
       "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
       "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
+    }
+  },
+  "grok-4.5": {
+    "thinkingLevelMap": {
+      "off": null,
       "minimal": null,
-      "low": null
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession"
     }
   },
-  "grok-build-0.1": {
+  "kimi-k2.7-code": {
     "compat": {
-      "supportsReasoningEffort": false
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "gpt-5.1": {
+    "thinkingLevelMap": {
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
     },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
+    }
+  },
+  "big-pickle": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "grok-build-0.1": {
     "thinkingLevelMap": {
       "off": null,
       "minimal": null,
       "low": null,
       "medium": null
+    },
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "supportsReasoningEffort": false,
+      "maxTokensField": "max_tokens"
     }
   },
-  "grok-code": {
+  "kimi-k3": {
+    "thinkingLevelMap": {
+      "off": null,
+      "minimal": null,
+      "low": null,
+      "medium": null,
+      "high": null,
+      "xhigh": null,
+      "max": "max"
+    },
     "compat": {
-      "supportsReasoningEffort": false
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "gpt-5.1-codex": {
+    "thinkingLevelMap": {
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
+    }
+  },
+  "gpt-5-nano": {
+    "thinkingLevelMap": {
+      "off": null,
+      "minimal": "minimal",
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": null,
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
+    }
+  },
+  "claude-opus-4-7": {
+    "thinkingLevelMap": {
+      "xhigh": "xhigh",
+      "max": "max"
+    },
+    "compat": {
+      "forceAdaptiveThinking": true,
+      "supportsTemperature": false
+    }
+  },
+  "gpt-5.6-terra": {
+    "thinkingLevelMap": {
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": "max"
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
+    }
+  },
+  "claude-sonnet-5": {
+    "thinkingLevelMap": {
+      "xhigh": "xhigh",
+      "max": "max"
+    },
+    "compat": {
+      "forceAdaptiveThinking": true
+    }
+  },
+  "nemotron-3-ultra-free": {
+    "compat": {
+      "supportsStore": false,
+      "supportsDeveloperRole": false,
+      "maxTokensField": "max_tokens"
+    }
+  },
+  "claude-opus-5": {
+    "thinkingLevelMap": {
+      "xhigh": "xhigh",
+      "max": "max"
     },
+    "compat": {
+      "forceAdaptiveThinking": true,
+      "supportsTemperature": false
+    }
+  },
+  "gpt-5.1-codex-max": {
     "thinkingLevelMap": {
       "off": null,
       "minimal": null,
-      "low": null,
-      "medium": null
+      "low": "low",
+      "medium": "medium",
+      "high": "high",
+      "xhigh": "xhigh",
+      "max": null
+    },
+    "compat": {
+      "sessionAffinityFormat": "openai-nosession",
+      "supportsOpenAIGrammarTools": true
     }
   },
-  "kimi-k2.6": {
+  "gemini-3-pro": {
+    "thinkingLevelMap": {
+      "off": null
+    }
+  },
+  "grok-code": {
     "compat": {
-      "thinkingFormat": "deepseek",
       "supportsReasoningEffort": false
     },
     "thinkingLevelMap": {
+      "off": null,
       "minimal": null,
       "low": null,
       "medium": null
     }
   }
-}
+}

package/scripts/update-models.js

@@ -103,6 +103,46 @@ function convertModel(model) {
   };
 }
 
+// Load a layered JSON model file.
+function loadJson(fileName) {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(process.cwd(), fileName), 'utf8'));
+  } catch {
+    return fileName === 'patch.json' ? {} : [];
+  }
+}
+
+// Deep-merge patch overrides into a model for README documentation. The
+// generated models.json remains API-derived; only the displayed model map uses patches.
+function applyPatch(model, patch) {
+  if (!patch) return model;
+  const result = { ...model };
+  for (const [key, value] of Object.entries(patch)) {
+    if (key === 'cost' || key === 'compat' || key === 'thinkingLevelMap') {
+      result[key] = { ...(result[key] || {}), ...value };
+    } else {
+      result[key] = value;
+    }
+  }
+  if (!result.reasoning) {
+    delete result.thinkingLevelMap;
+    if (result.compat?.thinkingFormat) delete result.compat.thinkingFormat;
+  }
+  return result;
+}
+
+// Merge API models, patches, and custom models in the same order as index.ts.
+function buildModels(baseModels, customModels, patch) {
+  const byId = new Map(baseModels.map(model => [model.id, model]));
+  for (const [id, entry] of Object.entries(patch)) {
+    if (byId.has(id)) byId.set(id, applyPatch(byId.get(id), entry));
+  }
+  for (const model of customModels) {
+    byId.set(model.id, applyPatch(model, patch[model.id]));
+  }
+  return Array.from(byId.values());
+}
+
 // Generate README model table row
 function generateReadmeRow(model) {
   const cost = model.cost || {};
@@ -240,8 +280,10 @@ async function main() {
     fs.writeFileSync(modelsPath, JSON.stringify(models, null, 2) + '\n');
     console.log(`  Saved ${models.length} models to models.json`);
 
-    // Update README
-    updateReadme(models);
+    // Apply layered overrides for documentation: models.json → patch.json → custom-models.json.
+    const patch = loadJson('patch.json');
+    const customModels = Array.isArray(loadJson('custom-models.json')) ? loadJson('custom-models.json') : [];
+    updateReadme(buildModels(models, customModels, patch));
 
     console.log('\nDone!');
   } catch (error) {