feat(opencode-go): add Opencode Go as a first-class provider (#172)

Opencode Go's models were only usable by configuring each one manually as a
separate OpenAI-Compatible provider, with no on-the-fly model switching.

Add Opencode Go as a dedicated OpenAI-compatible gateway provider
(https://opencode.ai/zen/go/v1) with an API key and a dynamic model list
fetched from /v1/models, so models can be switched on the fly via the model
picker. Mirrors the VercelAiGateway provider (RouterProvider + fetcher).

Pricing is intentionally not parsed (units undocumented; cost shown as unknown
rather than wrong). First pass covers the OpenAI-compatible models; the
Anthropic-format models on the Go plan (/v1/messages) are a follow-up.

Adds a fetcher spec. tsc/eslint/prettier and affected suites pass.

Author: proyectoauraorg

packages/types/src/global-settings.ts

@@ -279,6 +279,7 @@ export const SECRET_STATE_KEYS = [
 	"zaiApiKey",
 	"fireworksApiKey",
 	"vercelAiGatewayApiKey",
+	"opencodeGoApiKey",
 	"basetenApiKey",
 ] as const
 

packages/types/src/provider-settings.ts

@@ -43,6 +43,7 @@ export const dynamicProviders = [
 	"unbound",
 	"poe",
 	"deepseek",
+	"opencode-go",
 ] as const
 
 export type DynamicProvider = (typeof dynamicProviders)[number]
@@ -399,6 +400,11 @@ const vercelAiGatewaySchema = baseProviderSettingsSchema.extend({
 	vercelAiGatewayModelId: z.string().optional(),
 })
 
+const opencodeGoSchema = baseProviderSettingsSchema.extend({
+	opencodeGoApiKey: z.string().optional(),
+	opencodeGoModelId: z.string().optional(),
+})
+
 const basetenSchema = apiModelIdProviderModelSchema.extend({
 	basetenApiKey: z.string().optional(),
 })
@@ -437,6 +443,7 @@ export const providerSettingsSchemaDiscriminated = z.discriminatedUnion("apiProv
 	fireworksSchema.merge(z.object({ apiProvider: z.literal("fireworks") })),
 	qwenCodeSchema.merge(z.object({ apiProvider: z.literal("qwen-code") })),
 	vercelAiGatewaySchema.merge(z.object({ apiProvider: z.literal("vercel-ai-gateway") })),
+	opencodeGoSchema.merge(z.object({ apiProvider: z.literal("opencode-go") })),
 	defaultSchema,
 ])
 
@@ -471,6 +478,7 @@ export const providerSettingsSchema = z.object({
 	...fireworksSchema.shape,
 	...qwenCodeSchema.shape,
 	...vercelAiGatewaySchema.shape,
+	...opencodeGoSchema.shape,
 	...codebaseIndexProviderSchema.shape,
 })
 
@@ -501,6 +509,7 @@ export const modelIdKeys = [
 	"unboundModelId",
 	"litellmModelId",
 	"vercelAiGatewayModelId",
+	"opencodeGoModelId",
 ] as const satisfies readonly (keyof ProviderSettings)[]
 
 export type ModelIdKey = (typeof modelIdKeys)[number]
@@ -546,6 +555,7 @@ export const modelIdKeysByProvider: Record<TypicalProvider, ModelIdKey> = {
 	zai: "apiModelId",
 	fireworks: "apiModelId",
 	"vercel-ai-gateway": "vercelAiGatewayModelId",
+	"opencode-go": "opencodeGoModelId",
 }
 
 /**
@@ -662,6 +672,7 @@ export const MODELS_BY_PROVIDER: Record<
 	requesty: { id: "requesty", label: "Requesty", models: [] },
 	unbound: { id: "unbound", label: "Unbound", models: [] },
 	"vercel-ai-gateway": { id: "vercel-ai-gateway", label: "Vercel AI Gateway", models: [] },
+	"opencode-go": { id: "opencode-go", label: "Opencode Go", models: [] },
 
 	// Local providers; models discovered from localhost endpoints.
 	lmstudio: { id: "lmstudio", label: "LM Studio", models: [] },

packages/types/src/providers/index.ts

@@ -22,6 +22,7 @@ export * from "./vertex.js"
 export * from "./vscode-llm.js"
 export * from "./xai.js"
 export * from "./vercel-ai-gateway.js"
+export * from "./opencode-go.js"
 export * from "./zai.js"
 export * from "./minimax.js"
 export * from "./mimo.js"
@@ -46,6 +47,7 @@ import { vertexDefaultModelId } from "./vertex.js"
 import { vscodeLlmDefaultModelId } from "./vscode-llm.js"
 import { xaiDefaultModelId } from "./xai.js"
 import { vercelAiGatewayDefaultModelId } from "./vercel-ai-gateway.js"
+import { opencodeGoDefaultModelId } from "./opencode-go.js"
 import { internationalZAiDefaultModelId, mainlandZAiDefaultModelId } from "./zai.js"
 import { minimaxDefaultModelId } from "./minimax.js"
 import { mimoDefaultModelId } from "./mimo.js"
@@ -115,6 +117,8 @@ export function getProviderDefaultModelId(
 			return unboundDefaultModelId
 		case "vercel-ai-gateway":
 			return vercelAiGatewayDefaultModelId
+		case "opencode-go":
+			return opencodeGoDefaultModelId
 		case "anthropic":
 		case "gemini-cli":
 		case "fake-ai":

packages/types/src/providers/opencode-go.ts

@@ -0,0 +1,21 @@
+import type { ModelInfo } from "../model.js"
+
+// Opencode "Go" plan — OpenAI-compatible gateway.
+// https://opencode.ai/docs/go/ · base URL: https://opencode.ai/zen/go/v1
+//
+// The full model list (and metadata) is fetched dynamically from
+// `https://opencode.ai/zen/go/v1/models`, so models can be switched on the fly.
+// The values below are only a fallback used before the live list resolves.
+export const opencodeGoDefaultModelId = "glm-5.1"
+
+export const opencodeGoDefaultModelInfo: ModelInfo = {
+	maxTokens: 32_768,
+	contextWindow: 200_000,
+	supportsImages: false,
+	supportsPromptCache: false,
+	inputPrice: 0,
+	outputPrice: 0,
+	description: "Opencode Go plan model. Available models and metadata are resolved dynamically from /v1/models.",
+}
+
+export const OPENCODE_GO_DEFAULT_TEMPERATURE = 0

src/api/index.ts

@@ -32,6 +32,7 @@ import {
 	ZAiHandler,
 	FireworksHandler,
 	VercelAiGatewayHandler,
+	OpencodeGoHandler,
 	MiniMaxHandler,
 	MimoHandler,
 	BasetenHandler,
@@ -176,6 +177,8 @@ export function buildApiHandler(configuration: ProviderSettings): ApiHandler {
 			return new FireworksHandler(options)
 		case "vercel-ai-gateway":
 			return new VercelAiGatewayHandler(options)
+		case "opencode-go":
+			return new OpencodeGoHandler(options)
 		case "minimax":
 			return new MiniMaxHandler(options)
 		case "baseten":

src/api/providers/fetchers/__tests__/opencode-go.spec.ts

@@ -0,0 +1,76 @@
+// npx vitest run src/api/providers/fetchers/__tests__/opencode-go.spec.ts
+
+import axios from "axios"
+
+import { opencodeGoDefaultModelInfo } from "@roo-code/types"
+
+import { getOpencodeGoModels, parseOpencodeGoModel } from "../opencode-go"
+
+vitest.mock("axios")
+const mockedAxios = axios as any
+
+describe("Opencode Go Fetchers", () => {
+	beforeEach(() => {
+		vitest.clearAllMocks()
+	})
+
+	describe("getOpencodeGoModels", () => {
+		it("maps the /models response and sends the API key as a Bearer header", async () => {
+			mockedAxios.get.mockResolvedValue({
+				data: {
+					data: [
+						{
+							id: "glm-5.1",
+							name: "GLM-5.1",
+							description: "Zhipu GLM 5.1",
+							context_window: 202752,
+							max_output_tokens: 32768,
+						},
+						{ id: "deepseek-v4-pro", context_length: 1048576 },
+					],
+				},
+			})
+
+			const models = await getOpencodeGoModels("test-key")
+
+			expect(mockedAxios.get).toHaveBeenCalledWith("https://opencode.ai/zen/go/v1/models", {
+				headers: { Authorization: "Bearer test-key" },
+			})
+
+			expect(Object.keys(models).sort()).toEqual(["deepseek-v4-pro", "glm-5.1"])
+			expect(models["glm-5.1"]).toMatchObject({
+				contextWindow: 202752,
+				maxTokens: 32768,
+				supportsPromptCache: false,
+				description: "Zhipu GLM 5.1",
+			})
+			expect(models["deepseek-v4-pro"].contextWindow).toBe(1048576)
+		})
+
+		it("falls back to default context/max tokens when metadata is absent", async () => {
+			mockedAxios.get.mockResolvedValue({ data: { data: [{ id: "kimi-k2.6" }] } })
+
+			const models = await getOpencodeGoModels("k")
+
+			expect(models["kimi-k2.6"]).toMatchObject({
+				contextWindow: opencodeGoDefaultModelInfo.contextWindow,
+				maxTokens: opencodeGoDefaultModelInfo.maxTokens,
+				supportsPromptCache: false,
+			})
+		})
+
+		it("returns an empty map on network error", async () => {
+			mockedAxios.get.mockRejectedValue(new Error("network"))
+			expect(await getOpencodeGoModels("k")).toEqual({})
+		})
+	})
+
+	describe("parseOpencodeGoModel", () => {
+		it("treats a model with no cache pricing as not cache-capable", () => {
+			const info = parseOpencodeGoModel({ id: "x", context_window: 100000, max_tokens: 8000 })
+			expect(info.supportsPromptCache).toBe(false)
+			expect(info.contextWindow).toBe(100000)
+			expect(info.maxTokens).toBe(8000)
+		})
+	})
+})

src/api/providers/fetchers/modelCache.ts

@@ -18,6 +18,7 @@ import { fileExistsAtPath } from "../../../utils/fs"
 
 import { getOpenRouterModels } from "./openrouter"
 import { getVercelAiGatewayModels } from "./vercel-ai-gateway"
+import { getOpencodeGoModels } from "./opencode-go"
 import { getRequestyModels } from "./requesty"
 import { getUnboundModels } from "./unbound"
 import { getLiteLLMModels } from "./litellm"
@@ -86,6 +87,9 @@ async function fetchModelsFromProvider(options: GetModelsOptions): Promise<Model
 		case "vercel-ai-gateway":
 			models = await getVercelAiGatewayModels()
 			break
+		case "opencode-go":
+			models = await getOpencodeGoModels(options.apiKey)
+			break
 		case "poe":
 			models = await getPoeModels(options.apiKey, options.baseUrl)
 			break

src/api/providers/fetchers/opencode-go.ts

@@ -0,0 +1,65 @@
+import axios from "axios"
+import { z } from "zod"
+
+import type { ModelInfo } from "@roo-code/types"
+import { opencodeGoDefaultModelInfo } from "@roo-code/types"
+
+const OPENCODE_GO_BASE_URL = "https://opencode.ai/zen/go/v1"
+
+// The Opencode Go `/models` endpoint follows the OpenAI `/models` shape. The
+// `id` is the only guaranteed field; metadata is optional and best-effort, so
+// the schema is intentionally permissive. Pricing is intentionally NOT parsed:
+// the units returned by the endpoint aren't documented, and reporting a wrong
+// cost is worse than reporting "unknown" — so cost stays undefined until the
+// pricing shape is confirmed against the live endpoint.
+const opencodeGoModelSchema = z.object({
+	id: z.string(),
+	name: z.string().optional(),
+	description: z.string().optional(),
+	context_window: z.number().optional(),
+	context_length: z.number().optional(),
+	max_tokens: z.number().optional(),
+	max_output_tokens: z.number().optional(),
+	supports_images: z.boolean().optional(),
+})
+
+export type OpencodeGoModel = z.infer<typeof opencodeGoModelSchema>
+
+const opencodeGoModelsResponseSchema = z.object({
+	data: z.array(opencodeGoModelSchema),
+})
+
+export const parseOpencodeGoModel = (model: OpencodeGoModel): ModelInfo => ({
+	maxTokens: model.max_output_tokens ?? model.max_tokens ?? opencodeGoDefaultModelInfo.maxTokens,
+	contextWindow: model.context_window ?? model.context_length ?? opencodeGoDefaultModelInfo.contextWindow,
+	supportsImages: model.supports_images ?? false,
+	supportsPromptCache: false,
+	description: model.description ?? model.name,
+})
+
+export async function getOpencodeGoModels(apiKey?: string): Promise<Record<string, ModelInfo>> {
+	const models: Record<string, ModelInfo> = {}
+
+	try {
+		const response = await axios.get(`${OPENCODE_GO_BASE_URL}/models`, {
+			headers: apiKey ? { Authorization: `Bearer ${apiKey}` } : undefined,
+		})
+
+		const result = opencodeGoModelsResponseSchema.safeParse(response.data)
+		const data = result.success ? result.data.data : (response.data?.data ?? [])
+
+		if (!result.success) {
+			console.error(`Opencode Go models response is invalid: ${JSON.stringify(result.error.format())}`)
+		}
+
+		for (const model of data) {
+			if (model?.id) {
+				models[model.id] = parseOpencodeGoModel(model)
+			}
+		}
+	} catch (error) {
+		console.error(`Error fetching Opencode Go models: ${error instanceof Error ? error.message : String(error)}`)
+	}
+
+	return models
+}

src/api/providers/index.ts

@@ -25,6 +25,7 @@ export { XAIHandler } from "./xai"
 export { ZAiHandler } from "./zai"
 export { FireworksHandler } from "./fireworks"
 export { VercelAiGatewayHandler } from "./vercel-ai-gateway"
+export { OpencodeGoHandler } from "./opencode-go"
 export { MiniMaxHandler } from "./minimax"
 export { MimoHandler } from "./mimo"
 export { BasetenHandler } from "./baseten"