Update(zen-go): add claude-opus-4-8, minimax-m3, mimo-v2.5-free models and proper effort level integration for Zen/Go models

README.md

@@ -162,8 +162,8 @@ Advanced and source-build guides:
 | Codex OAuth | `/provider` | Opens ChatGPT sign-in in your browser and stores Codex credentials securely |
 | Codex | `/provider` | Uses existing Codex CLI auth, OpenClaude secure storage, or env credentials |
 | Gitlawb Opengateway | Startup default, `/provider`, or env vars | Smart gateway at `https://opengateway.gitlawb.com/v1`; requires an API key from https://gitlawb.com/opengateway/keys and routes Xiaomi MiMo and GMI Cloud partner models by `OPENAI_MODEL` |
-| OpenCode Zen | `/provider` or env vars | Pay-as-you-go AI gateway (41 models); uses `OPENCODE_API_KEY` via `https://opencode.ai/zen/v1`; shared key with OpenCode Go |
-| OpenCode Go | `/provider` or env vars | $10/mo subscription for open models (12 models); uses `OPENCODE_API_KEY` via `https://opencode.ai/zen/go/v1`; shared key with OpenCode Zen |
+| OpenCode Zen | `/provider` or env vars | Pay-as-you-go AI gateway (43 models); uses `OPENCODE_API_KEY` via `https://opencode.ai/zen/v1`; shared key with OpenCode Go |
+| OpenCode Go | `/provider` or env vars | $10/mo subscription for open models (13 models); uses `OPENCODE_API_KEY` via `https://opencode.ai/zen/go/v1`; shared key with OpenCode Zen |
 | Xiaomi MiMo | `/provider` or env vars | OpenAI-compatible API at `https://mimo.mi.com`; uses `MIMO_API_KEY` and defaults to `mimo-v2.5-pro` |
 | Ollama | `/provider` or env vars | Local inference with no API key |
 | Atomic Chat | `/provider`, env vars, or `bun run dev:atomic-chat` | Local Model Provider; auto-detects loaded models |

docs/advanced-setup.md

@@ -194,7 +194,7 @@ export OPENAI_MODEL=gpt-5.4
 openclaude
 ```
 
-OpenCode Zen is a pay-as-you-go AI gateway with 41 models (GPT, Claude, Gemini,
+OpenCode Zen is a pay-as-you-go AI gateway with 43 models (GPT, Claude, Gemini,
 Qwen, MiniMax, GLM, Kimi, Grok, Big Pickle, DeepSeek, Nemotron). Uses the same
 `OPENCODE_API_KEY` as OpenCode Go. Get your key from https://opencode.ai.
 
@@ -209,7 +209,7 @@ export OPENAI_MODEL=glm-5.1
 openclaude
 ```
 
-OpenCode Go is a $10/mo subscription for 12 open models (GLM, Kimi, DeepSeek,
+OpenCode Go is a $10/mo subscription for 13 open models (GLM, Kimi, DeepSeek,
 MiMo, MiniMax, Qwen). Uses the same `OPENCODE_API_KEY` as OpenCode Zen.
 
 ### Gitlawb Opengateway

src/entrypoints/sdk/runtimeTypes.ts

@@ -1 +1 @@
-export type EffortLevel = 'low' | 'medium' | 'high' | 'max'
+export type EffortLevel = 'low' | 'medium' | 'high' | 'max' | 'xhigh'

src/integrations/gateways/opencode-go.ts

@@ -29,7 +29,7 @@ export default defineGateway({
   preset: {
     id: 'opencode-go',
     vendorId: 'openai',
-    description: 'OpenCode Go — $10/mo subscription for open models (12 models)',
+    description: 'OpenCode Go — $10/mo subscription for open models (13 models)',
     apiKeyEnvVars: ['OPENCODE_API_KEY'],
     modelEnvVars: ['OPENAI_MODEL'],
   },
@@ -50,6 +50,7 @@ export default defineGateway({
       { id: 'opencode-go-minimax-m2.5', apiName: 'minimax-m2.5', label: 'MiniMax M2.5', modelDescriptorId: 'opencode-go-minimax-m2.5', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
       { id: 'opencode-go-qwen3.6-plus', apiName: 'qwen3.6-plus', label: 'Qwen3.6 Plus', modelDescriptorId: 'opencode-go-qwen3.6-plus', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
       { id: 'opencode-go-qwen3.5-plus', apiName: 'qwen3.5-plus', label: 'Qwen3.5 Plus', modelDescriptorId: 'opencode-go-qwen3.5-plus', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
+      { id: 'opencode-go-minimax-m3', apiName: 'minimax-m3', label: 'MiniMax M3', modelDescriptorId: 'opencode-go-minimax-m3', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
     ],
   },
   usage: { supported: false },

src/integrations/gateways/opencode.test.ts

@@ -284,12 +284,12 @@ describe('OpenCode model catalog', () => {
 
   test('zen model count matches expected', () => {
     const models = getCatalogEntriesForRoute('opencode')
-    expect(models.length).toBe(41)
+    expect(models.length).toBe(43)
   })
 
   test('go model count matches expected', () => {
     const models = getCatalogEntriesForRoute('opencode-go')
-    expect(models.length).toBe(12)
+    expect(models.length).toBe(13)
   })
 
   test('all zen gpt models have modelDescriptorId', () => {

src/integrations/gateways/opencode.ts

@@ -20,7 +20,7 @@ export default defineGateway({
   preset: {
     id: 'opencode',
     vendorId: 'openai',
-    description: 'OpenCode Zen — pay-as-you-go AI gateway (41 models)',
+    description: 'OpenCode Zen — pay-as-you-go AI gateway (43 models)',
     apiKeyEnvVars: ['OPENCODE_API_KEY'],
     modelEnvVars: ['OPENAI_MODEL'],
   },
@@ -56,6 +56,7 @@ export default defineGateway({
       { id: 'gpt-5-nano', apiName: 'gpt-5-nano', label: 'GPT 5 Nano', modelDescriptorId: 'opencode-gpt-5-nano', transportOverrides: { openaiShim: { endpointPath: '/responses' } } },
       // Claude family — /zen/v1/messages
       { id: 'claude-opus-4-7', apiName: 'claude-opus-4-7', label: 'Claude Opus 4.7', modelDescriptorId: 'opencode-claude-opus-4-7', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
+      { id: 'claude-opus-4-8', apiName: 'claude-opus-4-8', label: 'Claude Opus 4.8', modelDescriptorId: 'opencode-claude-opus-4-8', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
       { id: 'claude-opus-4-6', apiName: 'claude-opus-4-6', label: 'Claude Opus 4.6', modelDescriptorId: 'opencode-claude-opus-4-6', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
       { id: 'claude-opus-4-5', apiName: 'claude-opus-4-5', label: 'Claude Opus 4.5', modelDescriptorId: 'opencode-claude-opus-4-5', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
       { id: 'claude-opus-4-1', apiName: 'claude-opus-4-1', label: 'Claude Opus 4.1', modelDescriptorId: 'opencode-claude-opus-4-1', transportOverrides: { openaiShim: { endpointPath: '/messages' } } },
@@ -82,6 +83,7 @@ export default defineGateway({
       { id: 'big-pickle', apiName: 'big-pickle', label: 'Big Pickle', modelDescriptorId: 'opencode-big-pickle' },
       { id: 'deepseek-v4-flash-free', apiName: 'deepseek-v4-flash-free', label: 'DeepSeek V4 Flash Free', modelDescriptorId: 'opencode-deepseek-v4-flash-free' },
       { id: 'nemotron-3-super-free', apiName: 'nemotron-3-super-free', label: 'Nemotron 3 Super Free', modelDescriptorId: 'opencode-nemotron-3-super-free' },
+      { id: 'mimo-v2.5-free', apiName: 'mimo-v2.5-free', label: 'MiMo V2.5 Free', modelDescriptorId: 'opencode-mimo-v2.5-free' },
     ],
   },
   usage: { supported: false },

src/integrations/generated/integrationArtifacts.generated.ts

@@ -309,7 +309,7 @@ export const PROVIDER_PRESET_MANIFEST = [
     "routeId": "opencode-go",
     "vendorId": "openai",
     "gatewayId": "opencode-go",
-    "description": "OpenCode Go — $10/mo subscription for open models (12 models)",
+    "description": "OpenCode Go — $10/mo subscription for open models (13 models)",
     "apiKeyEnvVars": [
       "OPENCODE_API_KEY"
     ],
@@ -323,7 +323,7 @@ export const PROVIDER_PRESET_MANIFEST = [
     "routeId": "opencode",
     "vendorId": "openai",
     "gatewayId": "opencode",
-    "description": "OpenCode Zen — pay-as-you-go AI gateway (41 models)",
+    "description": "OpenCode Zen — pay-as-you-go AI gateway (43 models)",
     "apiKeyEnvVars": [
       "OPENCODE_API_KEY"
     ],

src/integrations/models/opencode.ts

@@ -332,6 +332,24 @@ export default [
     contextWindow: 200_000,
     maxOutputTokens: 65_536,
   }),
+  defineModel({
+    id: 'opencode-claude-opus-4-8',
+    label: 'Claude Opus 4.8',
+
+    vendorId: 'openai',
+    classification: ['chat', 'reasoning'],
+    defaultModel: 'opencode-claude-opus-4-8',
+    capabilities: {
+      supportsVision: true,
+      supportsStreaming: true,
+      supportsFunctionCalling: true,
+      supportsJsonMode: true,
+      supportsReasoning: true,
+      supportsPreciseTokenCount: false,
+    },
+    contextWindow: 200_000,
+    maxOutputTokens: 65_536,
+  }),
   defineModel({
     id: 'opencode-claude-opus-4-6',
     label: 'Claude Opus 4.6',
@@ -752,6 +770,24 @@ export default [
     contextWindow: 131_072,
     maxOutputTokens: 32_768,
   }),
+  defineModel({
+    id: 'opencode-mimo-v2.5-free',
+    label: 'MiMo V2.5 Free',
+
+    vendorId: 'openai',
+    classification: ['chat'],
+    defaultModel: 'opencode-mimo-v2.5-free',
+    capabilities: {
+      supportsVision: false,
+      supportsStreaming: true,
+      supportsFunctionCalling: true,
+      supportsJsonMode: true,
+      supportsReasoning: false,
+      supportsPreciseTokenCount: false,
+    },
+    contextWindow: 131_072,
+    maxOutputTokens: 32_768,
+  }),
 
   // ============================================================
   // GO MODELS — https://opencode.ai/zen/go/v1
@@ -976,4 +1012,22 @@ export default [
     contextWindow: 131_072,
     maxOutputTokens: 32_768,
   }),
+  defineModel({
+    id: 'opencode-go-minimax-m3',
+    label: 'MiniMax M3',
+
+    vendorId: 'openai',
+    classification: ['chat'],
+    defaultModel: 'minimax-m3',
+    capabilities: {
+      supportsVision: false,
+      supportsStreaming: true,
+      supportsFunctionCalling: true,
+      supportsJsonMode: true,
+      supportsReasoning: false,
+      supportsPreciseTokenCount: false,
+    },
+    contextWindow: 131_072,
+    maxOutputTokens: 32_768,
+  }),
 ]

src/services/api/openaiShim.ts

@@ -2229,6 +2229,11 @@ class OpenAIShimMessages {
 
       if (params.temperature !== undefined) responsesBody.temperature = params.temperature
       if (params.top_p !== undefined) responsesBody.top_p = params.top_p
+      if (request.reasoning?.effort) {
+        responsesBody.reasoning_effort = request.reasoning.effort
+        responsesBody.reasoning_summary = 'auto'
+        responsesBody.include = ['reasoning.encrypted_content']
+      }
 
       if (!omitResponsesTools && params.tools && params.tools.length > 0) {
         const convertedTools = convertToolsToResponsesTools(
@@ -2279,6 +2284,31 @@ class OpenAIShimMessages {
         anthropicBody.tool_choice = params.tool_choice
       }
 
+      if (request.reasoning?.effort) {
+        // Shim receives OpenAI effort levels (xhigh) from client.ts, but
+        // Anthropic API expects 'max' not 'xhigh'. Convert for the effort field.
+        const effort = request.reasoning.effort === 'xhigh' ? 'max' : request.reasoning.effort
+        const modelLower = request.resolvedModel.toLowerCase()
+        const isAdaptive = modelLower.includes('opus-4-7') || modelLower.includes('opus-4-6') ||
+          modelLower.includes('opus-4-8') ||
+          modelLower.includes('opus-4.6') || modelLower.includes('opus-4.7') ||
+          modelLower.includes('opus-4.8') ||
+          modelLower.includes('sonnet-4-6') || modelLower.includes('sonnet-4.6')
+        const isOpus45 = modelLower.includes('opus-4-5') || modelLower.includes('opus-4.5')
+
+        if (isAdaptive) {
+          anthropicBody.thinking = { type: 'adaptive' }
+          anthropicBody.effort = effort
+        } else if (isOpus45) {
+          anthropicBody.effort = effort
+        } else if (effort === 'high' || effort === 'max') {
+          anthropicBody.thinking = {
+            type: 'enabled',
+            budgetTokens: effort === 'max' ? 31_999 : 16_000,
+          }
+        }
+      }
+
       return anthropicBody
     }
 
@@ -2372,6 +2402,10 @@ class OpenAIShimMessages {
       }
       if (params.temperature !== undefined) genConfig.temperature = params.temperature
       if (params.top_p !== undefined) genConfig.topP = params.top_p
+      if (request.reasoning?.effort) {
+        const level = request.reasoning.effort === 'xhigh' ? 'high' : request.reasoning.effort
+        genConfig.thinkingConfig = { includeThoughts: true, thinkingLevel: level }
+      }
       if (Object.keys(genConfig).length > 0) {
         geminiBody.generationConfig = genConfig
       }

src/utils/effort.codex.test.ts

@@ -106,13 +106,13 @@ test('gpt-5.3-codex-spark stays without effort controls', async () => {
   expect(getAvailableEffortLevels('gpt-5.3-codex-spark')).toEqual([])
 })
 
-test('toPersistableEffort normalizes xhigh to max so it survives settings write', async () => {
+test('toPersistableEffort passes xhigh through as a first-class level', async () => {
   const { toPersistableEffort } = await importFreshEffortModule({
     provider: 'openai',
     supportsCodexReasoningEffort: true,
   })
 
-  expect(toPersistableEffort('xhigh')).toBe('max')
+  expect(toPersistableEffort('xhigh')).toBe('xhigh')
   expect(toPersistableEffort('max')).toBe('max')
   expect(toPersistableEffort('high')).toBe('high')
   expect(toPersistableEffort('medium')).toBe('medium')
@@ -128,12 +128,13 @@ test('standardEffortToOpenAI maps max to xhigh for shim payload', async () => {
     })
 
   expect(standardEffortToOpenAI('max')).toBe('xhigh')
+  expect(standardEffortToOpenAI('xhigh')).toBe('xhigh')
   expect(standardEffortToOpenAI('high')).toBe('high')
-  expect(openAIEffortToStandard('xhigh')).toBe('max')
+  expect(openAIEffortToStandard('xhigh')).toBe('xhigh')
   expect(openAIEffortToStandard('high')).toBe('high')
 })
 
-test('e2e: xhigh → persisted max → resolveAppliedEffort → wire xhigh on OpenAI/Codex (no high clamp)', async () => {
+test('e2e: xhigh → persisted xhigh → resolveAppliedEffort → wire xhigh on OpenAI/Codex (no high clamp)', async () => {
   const {
     toPersistableEffort,
     resolveAppliedEffort,
@@ -143,18 +144,16 @@ test('e2e: xhigh → persisted max → resolveAppliedEffort → wire xhigh on Op
     supportsCodexReasoningEffort: true,
   })
 
-  // Picker writes the OpenAI-shaped value; toPersistableEffort normalizes.
+  // Picker writes 'xhigh'; toPersistableEffort passes it through.
   const persisted = toPersistableEffort('xhigh')
-  expect(persisted).toBe('max')
+  expect(persisted).toBe('xhigh')
 
-  // App state holds 'max'. Non-Opus 'max' must NOT be downgraded to 'high'
-  // when the model uses the OpenAI effort scheme — the shim converts back
-  // to 'xhigh' on the wire.
+  // App state holds 'xhigh'. The OpenAI-shaped 'xhigh' is sent to the API as-is.
   const applied = resolveAppliedEffort('gpt-5.4', persisted)
-  expect(applied).toBe('max')
+  expect(applied).toBe('xhigh')
 
   // Final wire value the client shim emits.
-  expect(standardEffortToOpenAI(applied as 'max')).toBe('xhigh')
+  expect(standardEffortToOpenAI(applied as 'xhigh')).toBe('xhigh')
 })
 
 test('e2e: max on non-Opus Anthropic model still clamps to high', async () => {
@@ -165,3 +164,70 @@ test('e2e: max on non-Opus Anthropic model still clamps to high', async () => {
 
   expect(resolveAppliedEffort('claude-sonnet-4-6', 'max')).toBe('high')
 })
+
+test('modelSupportsXHighEffort: opus-4-7 and opus-4-8 are allowed; other Claude models are not', async () => {
+  const { modelSupportsXHighEffort } = await importFreshEffortModule({
+    provider: 'firstParty' as unknown as 'openai',
+    supportsCodexReasoningEffort: false,
+  })
+
+  expect(modelSupportsXHighEffort('claude-opus-4-7')).toBe(true)
+  expect(modelSupportsXHighEffort('claude-opus-4-8')).toBe(true)
+  expect(modelSupportsXHighEffort('opencode-claude-opus-4-8')).toBe(true)
+  expect(modelSupportsXHighEffort('claude-opus-4-6')).toBe(false)
+  expect(modelSupportsXHighEffort('claude-sonnet-4-6')).toBe(false)
+  expect(modelSupportsXHighEffort('claude-sonnet-4-5')).toBe(false)
+  expect(modelSupportsXHighEffort('claude-haiku-4-5')).toBe(false)
+  expect(modelSupportsXHighEffort('claude-3-5-haiku')).toBe(false)
+})
+
+test('xhigh does not appear in available levels for non-supporting models', async () => {
+  const { getAvailableEffortLevels } = await importFreshEffortModule({
+    provider: 'firstParty' as unknown as 'openai',
+    supportsCodexReasoningEffort: false,
+  })
+
+  // No xhigh, no max
+  expect(getAvailableEffortLevels('claude-sonnet-4-6')).toEqual([
+    'low',
+    'medium',
+    'high',
+  ])
+  expect(getAvailableEffortLevels('claude-haiku-4-5')).toEqual([])
+
+  // Has xhigh AND max (opus-4-8)
+  const opusLevels = getAvailableEffortLevels('claude-opus-4-8')
+  expect(opusLevels).toEqual(['low', 'medium', 'high', 'xhigh', 'max'])
+})
+
+test('xhigh clamps to high on non-supporting models so stale settings.json values do not produce API errors', async () => {
+  const { resolveAppliedEffort } = await importFreshEffortModule({
+    provider: 'firstParty' as unknown as 'openai',
+    supportsCodexReasoningEffort: false,
+  })
+
+  // sonnet-4-6 supports effort but not xhigh — clamp
+  expect(resolveAppliedEffort('claude-sonnet-4-6', 'xhigh')).toBe('high')
+  // opus-4-8 supports xhigh — pass through
+  expect(resolveAppliedEffort('claude-opus-4-8', 'xhigh')).toBe('xhigh')
+})
+
+test('modelUsesOpenAIEffort: Claude/Gemini are excluded even on the openai provider (OpenCode native route)', async () => {
+  const { modelUsesOpenAIEffort, getAvailableEffortLevels } =
+    await importFreshEffortModule({
+      provider: 'openai',
+      supportsCodexReasoningEffort: true,
+    })
+
+  // Native Claude/Gemini on OpenCode use Anthropic/Google format, not OpenAI
+  expect(modelUsesOpenAIEffort('claude-opus-4-8')).toBe(false)
+  expect(modelUsesOpenAIEffort('claude-sonnet-4-6')).toBe(false)
+  expect(modelUsesOpenAIEffort('gemini-3-flash')).toBe(false)
+  // Real OpenAI-shaped models still classify as OpenAI
+  expect(modelUsesOpenAIEffort('gpt-5.4')).toBe(true)
+
+  // And the picker excludes xhigh for OpenCode Claude on openai provider
+  const opusLevels = getAvailableEffortLevels('claude-opus-4-8')
+  // Standard branch: no OPENAI_EFFORT_LEVELS, just the supported standard levels
+  expect(opusLevels).toEqual(['low', 'medium', 'high', 'xhigh', 'max'])
+})