import { getModels } from "@mariozechner/pi-ai"; import { registerProviderPlugin, registerSingleProviderPlugin, } from "openclaw/plugin-sdk/plugin-test-runtime"; import { expectPassthroughReplayPolicy } from "openclaw/plugin-sdk/provider-test-contracts"; import { describe, expect, it } from "vitest"; import plugin from "./index.js"; function requireRecord(value: unknown, label: string): Record { if (value === null || typeof value !== "object" || Array.isArray(value)) { throw new Error(`expected ${label} to be a record`); } return value as Record; } function requireMapEntry(map: Map, id: string): T { const entry = map.get(id); if (!entry) { throw new Error(`expected model ${id}`); } return entry; } function requireCatalogEntry(entries: readonly unknown[] | null | undefined, id: string) { if (!entries) { throw new Error("expected supplemental catalog entries"); } const entry = entries.find((candidate) => requireRecord(candidate, "catalog entry").id === id); if (!entry) { throw new Error(`expected supplemental catalog entry ${id}`); } return requireRecord(entry, `supplemental catalog entry ${id}`); } describe("opencode-go provider plugin", () => { it("registers image media understanding through the OpenCode Go plugin", async () => { const { mediaProviders } = await registerProviderPlugin({ plugin, id: "opencode-go", name: "OpenCode Go Provider", }); const mediaProvider = mediaProviders.find((provider) => provider.id === "opencode-go"); expect(mediaProvider).toBeDefined(); expect(mediaProvider?.capabilities).toEqual(["image"]); expect(mediaProvider?.defaultModels).toEqual({ image: "kimi-k2.6" }); expect(typeof mediaProvider?.describeImage).toBe("function"); expect(typeof mediaProvider?.describeImages).toBe("function"); }); it("owns passthrough-gemini replay policy for Gemini-backed models", async () => { await expectPassthroughReplayPolicy({ plugin, providerId: "opencode-go", modelId: "gemini-2.5-pro", sanitizeThoughtSignatures: true, }); }); it("keeps non-Gemini replay policy minimal on passthrough routes", async () => { await expectPassthroughReplayPolicy({ plugin, providerId: "opencode-go", modelId: "qwen3-coder", }); }); it("keeps OpenCode Go catalog coverage aligned with upstream", async () => { const provider = await registerSingleProviderPlugin(plugin); expect(provider.catalog).toBeUndefined(); const models = new Map(getModels("opencode-go").map((model) => [model.id, model])); expect([...models.keys()]).toEqual([ "deepseek-v4-flash", "deepseek-v4-pro", "glm-5", "glm-5.1", "kimi-k2.5", "kimi-k2.6", "mimo-v2.5", "mimo-v2.5-pro", "minimax-m2.5", "minimax-m2.7", "qwen3.5-plus", "qwen3.6-plus", ]); const supplemental = await provider.augmentModelCatalog?.({ entries: [...models.values()].map((model) => ({ provider: model.provider, id: model.id, name: model.name, })), } as never); const deepSeekPro = requireCatalogEntry(supplemental, "deepseek-v4-pro"); expect(deepSeekPro.provider).toBe("opencode-go"); expect(deepSeekPro.name).toBe("DeepSeek V4 Pro"); const deepSeekFlash = requireCatalogEntry(supplemental, "deepseek-v4-flash"); expect(deepSeekFlash.provider).toBe("opencode-go"); expect(deepSeekFlash.name).toBe("DeepSeek V4 Flash"); const kimi = requireMapEntry(models, "kimi-k2.6"); expect(kimi.api).toBe("openai-completions"); expect(kimi.baseUrl).toBe("https://opencode.ai/zen/go/v1"); expect(kimi.input).toEqual(["text", "image"]); expect(kimi.reasoning).toBe(true); expect(kimi.contextWindow).toBe(262_144); expect(kimi.maxTokens).toBe(65_536); const minimax = requireMapEntry(models, "minimax-m2.7"); expect(minimax.api).toBe("openai-completions"); expect(minimax.baseUrl).toBe("https://opencode.ai/zen/go/v1"); expect(minimax.reasoning).toBe(true); expect(minimax.contextWindow).toBe(204_800); expect(minimax.maxTokens).toBe(131_072); const mimoPro = requireMapEntry(models, "mimo-v2.5-pro"); expect(mimoPro.api).toBe("openai-completions"); expect(mimoPro.baseUrl).toBe("https://opencode.ai/zen/go/v1"); expect(mimoPro.input).toEqual(["text"]); expect(mimoPro.reasoning).toBe(true); expect(mimoPro.contextWindow).toBe(1_048_576); expect(mimoPro.maxTokens).toBe(128_000); const mimo = requireMapEntry(models, "mimo-v2.5"); expect(mimo.input).toEqual(["text", "image"]); expect(mimo.reasoning).toBe(true); expect(mimo.contextWindow).toBe(1_000_000); expect(mimo.maxTokens).toBe(128_000); const dynamicModel = requireRecord( provider.resolveDynamicModel?.({ modelId: "deepseek-v4-pro", } as never), "dynamic model", ); expect(dynamicModel.id).toBe("deepseek-v4-pro"); expect(dynamicModel.api).toBe("openai-completions"); expect(dynamicModel.provider).toBe("opencode-go"); expect(dynamicModel.baseUrl).toBe("https://opencode.ai/zen/go/v1"); expect(dynamicModel.reasoning).toBe(true); expect(dynamicModel.contextWindow).toBe(1_000_000); expect(dynamicModel.maxTokens).toBe(384_000); const compat = requireRecord(dynamicModel.compat, "dynamic model compat"); expect(compat.supportsUsageInStreaming).toBe(true); expect(compat.supportsReasoningEffort).toBe(true); expect(compat.maxTokensField).toBe("max_tokens"); }); it("disables invalid DeepSeek V4 reasoning_effort off payloads on OpenCode Go", async () => { const provider = await registerSingleProviderPlugin(plugin); const capturedPayloads: Record[] = []; const baseStreamFn = (_model: unknown, _context: unknown, options: unknown) => { const payload = { model: "deepseek-v4-flash", reasoning_effort: "off", reasoning: "off", }; (options as { onPayload?: (payload: Record) => void })?.onPayload?.(payload); capturedPayloads.push(payload); return {} as never; }; const streamFn = provider.wrapStreamFn?.({ streamFn: baseStreamFn as never, providerId: "opencode-go", modelId: "deepseek-v4-flash", thinkingLevel: "off", } as never); expect(streamFn).toBeTypeOf("function"); await streamFn?.( { provider: "opencode-go", id: "deepseek-v4-flash" } as never, {} as never, {}, ); expect(capturedPayloads).toEqual([ { model: "deepseek-v4-flash", thinking: { type: "disabled" }, }, ]); }); it("canonicalizes stale OpenCode Go base URLs", async () => { const provider = await registerSingleProviderPlugin(plugin); const normalizedConfig = requireRecord( provider.normalizeConfig?.({ provider: "opencode-go", providerConfig: { api: "openai-completions", baseUrl: "https://opencode.ai/go/v1/", models: [], }, } as never), "normalized config", ); expect(normalizedConfig.baseUrl).toBe("https://opencode.ai/zen/go/v1"); const normalizedModel = requireRecord( provider.normalizeResolvedModel?.({ provider: "opencode-go", model: { provider: "opencode-go", id: "kimi-k2.5", name: "Kimi K2.5", api: "openai-completions", baseUrl: "https://opencode.ai/go/v1", reasoning: true, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 262_144, maxTokens: 65_536, }, } as never), "normalized model", ); expect(normalizedModel.baseUrl).toBe("https://opencode.ai/zen/go/v1"); expect( provider.normalizeTransport?.({ provider: "opencode-go", api: "openai-completions", baseUrl: "https://opencode.ai/go/v1", } as never), ).toEqual({ api: "openai-completions", baseUrl: "https://opencode.ai/zen/go/v1", }); expect( provider.normalizeTransport?.({ provider: "opencode-go", api: "anthropic-messages", baseUrl: "https://opencode.ai/go", } as never), ).toEqual({ api: "anthropic-messages", baseUrl: "https://opencode.ai/zen/go", }); }); });