feat(providers): add Opper as a built-in API-key gateway provider #4981
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -208,6 +208,7 @@ Published as SVG and committed with only comments, `<title>`/`<desc>` and | |
| - `digitalocean.svg` — `digitalocean.com` favicon, 32x32. | ||
| - `featherless.svg` — `featherless.ai/favicon.svg`, 256x256. | ||
| - `kilo.svg` — `kilo.ai/favicon/favicon.svg`, 32x32. Keeps its `oklch()` plate. | ||
| - `opper.svg` — supplied in PR #4823 by an Opper employee, 315x315 single-ink mark. | ||
|
There was a problem hiding this comment.
The commit explicitly says it carries #4823 by @Felixkw12, but its message contains no AGENTS.md reference: AGENTS.md:L288-L292 Useful? React with 👍 / 👎. |
||
| - `nanogpt.svg` — `nano-gpt.com/logo.svg`, 181x187, gradient. | ||
| - `nebius.svg` — `nebius.com/favicon/favicon.svg`, 96x96. | ||
| - `neuralwatt.svg` — the site's Webflow-hosted brand asset, 32x32. | ||
|
|
||
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -390,6 +390,10 @@ vision support from a provider-wide multimodal label. | |
|
|
||
| [Anthropic seed image metadata](runtime.md#capability-aware-image-admission) supplies missing capability evidence; subagent selection and eligibility rules remain unchanged. | ||
|
|
||
| Opper's fallback pool seeds carry provider-scoped text/image declarations from | ||
| `src/providers/registry/model-seeds.ts`. They feed the same capability-aware image admission and | ||
| do not change subagent selection, roster order, or eligibility. | ||
|
|
||
| Provider-scoped approval reviewer settings are projected by the [catalog owner](catalog.md#provider-scoped-approval-reviewer); this surface retains its existing routing, transport and account-selection behavior. | ||
|
|
||
| Renamed fixed-key providers receive [missing reasoning metadata](catalog.md#renamed-destination-reasoning-metadata) during derivation; explicit per-model entries and provider defaults retain precedence. | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -40,7 +40,7 @@ surface is listed here so a maintainer can find the owner without grepping: | |
| | OAuth account failover | `src/oauth/generic-account-failover.ts`, `src/oauth/anthropic-routing.ts` | Reactive pre-output 429 recovery is presence-driven with 2+ eligible accounts. Pool and `oauthAccountFailover` flags govern proactive routing, not the reactive retry: a disabled Anthropic pool recovers through quota ordering rather than its dormant strategy, and a per-provider `enabled` beats the global default in either direction. | | ||
| | OAuth login callback (inbound) | `src/oauth/callback-server.ts` | Every response, including non-callback 404s, closes its connection so a pooled socket cannot deliver a later login to a retired flow on the same callback port. | | ||
| | Alibaba regions | `src/providers/alibaba-region-backup.ts`, `src/providers/alibaba-region-migration.ts`, `src/providers/alibaba-region-startup.ts` | Region migration backs up before rewriting and is idempotent across restarts. | | ||
| | Discovery and quota | `src/providers/model-discovery.ts`, `src/providers/quota.ts`, `src/providers/registry.ts` | Discovery rejects a response over 4 MiB or past 2,000 raw rows before caching it. Provider-scoped hints fill capabilities omitted by live rosters; OpenCode Go's `deepseek-v4.1-flash` keeps its 1,048,576-token context window. The fixed-key Opper preset uses the shared OpenAI Chat adapter at `https://api.opper.ai/v3/compat`, discovers models through its conventional authenticated `/models` path, preserves an older same-named custom destination, and falls back to bare pool ids while passing vendor-prefixed ids through unchanged. Codex quota DTOs suppress retired Spark evidence under the [OpenAI scope contract](../providers/openai-tiers.md#public-provider-contract), retaining ordinary custom windows. | | ||
|
|
||
| The registry's first-party `deepseek-flash` row declares native `text` and `image` input, so image | ||
| requests bypass the vision sidecar by default; explicit `noVisionModels` or text-only declarations | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -881,6 +881,7 @@ | |
| "opencode-zen-rate-limit.test.ts": "providers", | ||
| "openrouter-provider-routing.test.ts": "providers", | ||
| "openrouter-quota-reset-cooldown-4024.test.ts": "providers", | ||
| "opper-provider.test.ts": "providers", | ||
| "optional-shutdown-hooks.test.ts": "lib", | ||
| "orcarouter-provider.test.ts": "providers", | ||
| "outbound-body-guard.test.ts": "server", | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,106 @@ | ||
| import { describe, expect, test } from "bun:test"; | ||
| import { KEY_LOGIN_PROVIDERS } from "../../src/oauth/key-providers"; | ||
| import { deriveProviderPresets, providerConfigSeed } from "../../src/providers/derive"; | ||
| import { resolveProviderModelDiscoveryUrl } from "../../src/providers/model-discovery"; | ||
| import { PROVIDER_REGISTRY } from "../../src/providers/registry"; | ||
| import { routeModel } from "../../src/router"; | ||
| import type { OcxConfig } from "../../src/types"; | ||
| import { en } from "../../gui/src/i18n/en"; | ||
| import { interpolate, type TFn } from "../../gui/src/i18n/shared"; | ||
| import { formatProviderDisplayName, providerIconPaint, providerIconSrc } from "../../gui/src/provider-icons"; | ||
|
|
||
| const englishT: TFn = (key, vars) => interpolate(en[key], vars); | ||
| const OPPER_BASE_URL = "https://api.opper.ai/v3/compat"; | ||
|
|
||
| function registryEntry() { | ||
| const entry = PROVIDER_REGISTRY.find(row => row.id === "opper"); | ||
| if (!entry) throw new Error("missing opper registry entry"); | ||
| return entry; | ||
| } | ||
|
|
||
| describe("Opper gateway provider", () => { | ||
| test("is a fixed OpenAI-compatible API-key gateway seeded with bare pool ids", () => { | ||
| const entry = registryEntry(); | ||
| expect(entry).toMatchObject({ | ||
| label: "Opper", | ||
| adapter: "openai-chat", | ||
| baseUrl: OPPER_BASE_URL, | ||
| authKind: "key", | ||
| liveModels: true, | ||
| preserveCustomDestination: true, | ||
| defaultModel: "claude-sonnet-4-6", | ||
| }); | ||
| expect(entry.allowBaseUrlOverride).toBeUndefined(); | ||
| expect(entry.models).toContain(entry.defaultModel!); | ||
| for (const id of entry.models ?? []) { | ||
| // Pool names carry no vendor prefix; Opper resolves the route per request. | ||
| expect(id).toMatch(/^[a-z0-9.-]+$/); | ||
| expect(entry.modelContextWindows?.[id]).toBeGreaterThan(0); | ||
| expect(entry.modelMaxOutputTokens?.[id]).toBeGreaterThan(0); | ||
| expect(entry.modelMaxOutputTokens?.[id]).toBeLessThanOrEqual(entry.modelContextWindows?.[id] ?? 0); | ||
| expect(entry.modelInputModalities?.[id]?.[0]).toBe("text"); | ||
| } | ||
| // Only pools whose every member takes images advertise the image modality. | ||
| expect(entry.modelInputModalities?.["claude-sonnet-4-6"]).toEqual(["text", "image"]); | ||
| expect(entry.modelInputModalities?.["deepseek-v4-pro"]).toEqual(["text"]); | ||
| expect(entry.modelInputModalities?.["kimi-k3"]).toEqual(["text"]); | ||
| }); | ||
|
|
||
| test("derives the key-login preset and config seed from the registry row", () => { | ||
| const entry = registryEntry(); | ||
| expect(KEY_LOGIN_PROVIDERS.opper).toMatchObject({ | ||
| label: "Opper", | ||
| adapter: "openai-chat", | ||
| baseUrl: OPPER_BASE_URL, | ||
| defaultModel: "claude-sonnet-4-6", | ||
| }); | ||
| expect(deriveProviderPresets().find(row => row.id === "opper")).toMatchObject({ auth: "key" }); | ||
| const seed = providerConfigSeed(entry); | ||
| expect(seed).toMatchObject({ | ||
| adapter: "openai-chat", | ||
| baseUrl: OPPER_BASE_URL, | ||
| liveModels: true, | ||
| models: entry.models, | ||
| modelContextWindows: entry.modelContextWindows, | ||
| }); | ||
| expect(seed).not.toHaveProperty("preserveCustomDestination"); | ||
| expect(seed).not.toHaveProperty("note"); | ||
| }); | ||
|
|
||
| test("uses the authenticated compat model list for key validation", () => { | ||
| // The original provider author reported that /v3/compat/models answers 401 without a key; | ||
| // this test statically pins the resulting registry policy and URL, not that upstream behavior. | ||
| expect(registryEntry().apiKeyValidation).toBeUndefined(); | ||
| expect(resolveProviderModelDiscoveryUrl( | ||
| "opper", | ||
| { adapter: "openai-chat", baseUrl: OPPER_BASE_URL, authMode: "key" }, | ||
| OPPER_BASE_URL, | ||
| `${OPPER_BASE_URL}/models`, | ||
| )).toBe("https://api.opper.ai/v3/compat/models"); | ||
| }); | ||
|
|
||
| test("routes the provider prefix and forwards pool and pinned model ids unchanged", () => { | ||
| const config: OcxConfig = { | ||
| port: 10100, | ||
| defaultProvider: "opper", | ||
| providers: { | ||
| opper: { ...providerConfigSeed(registryEntry()), apiKey: "test-key" }, | ||
| }, | ||
| }; | ||
| // Bare pool id: Opper picks the provider. | ||
| const pooled = routeModel(config, "opper/claude-sonnet-4-6"); | ||
| expect(pooled.modelId).toBe("claude-sonnet-4-6"); | ||
| expect(pooled.provider.baseUrl).toBe(OPPER_BASE_URL); | ||
| expect(pooled.provider.adapter).toBe("openai-chat"); | ||
| // Vendor-prefixed id pins one route; the extra slash must survive the provider split. | ||
| const pinned = routeModel(config, "opper/anthropic/claude-sonnet-4-6"); | ||
| expect(pinned.modelId).toBe("anthropic/claude-sonnet-4-6"); | ||
| expect(pinned.provider.baseUrl).toBe(OPPER_BASE_URL); | ||
| }); | ||
|
|
||
| test("ships a masked single-ink mark and a brand display name in the dashboard", () => { | ||
| expect(providerIconSrc("opper")).toBe("/provider-icons/opper.svg"); | ||
| expect(providerIconPaint(providerIconSrc("opper"))).toBe("mask"); | ||
| expect(formatProviderDisplayName("opper", englishT)).toBe("Opper"); | ||
| }); | ||
| }); |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -38,7 +38,7 @@ const EXPECTED_KEY_PROVIDER_IDS = [ | |
| "deepseek", "cerebras", "chutes", "deepinfra", "hyperbolic", "nscale", "vultr", "baseten", "commandcode", "sambanova", "nebius", "crusoe", "digitalocean", "scaleway", "featherless", "novita", "together", "fireworks", "firepass", "moonshot", | ||
| "huggingface", "nvidia", "venice", "zai", "zhipu-bigmodel", "zhipu-bigmodel-coding", "zhipu-bigmodel-responses", "nanogpt", "synthetic", "siliconflow", "qwen-cloud", "tencent-coding-plan", | ||
| "volcengine", "volcengine-coding-plan", "volcengine-agent-plan", "qianfan", "alibaba", "alibaba-token-plan", "alibaba-token-plan-intl", "parallel", "zenmux", "litellm", "ollama-cloud", "mistral", | ||
| "minimax", "minimax-cn", "kimi-code", "opencode-zen", "vercel-ai-gateway", "opper", | ||
| "opencode-free", "xiaomi", "xiaomi-mimo", "kilo", "mimo-free", "mimo", "cloudflare-ai-gateway", "cloudflare-workers-ai", "gitlab-duo", | ||
| "qoder", "qoder-cn", "codebuddy", "codebuddy-cn", | ||
| ]; | ||
|
|
||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win
🔎 Supported by static analysis
🏁 Script executed:
Repository: lidge-jun/opencodex
Length of output: 783
🏁 Script executed:
Repository: lidge-jun/opencodex
Length of output: 50377
🏁 Script executed:
Repository: lidge-jun/opencodex
Length of output: 19420
Update all translated provider guides.
The Japanese, Korean, Russian, and Simplified Chinese guides still report 94 presets and 78 key-based presets at
ja/guides/providers.md:171,ko/guides/providers.md:169,ru/guides/providers.md:182, andzh-cn/guides/providers.md:162. None includes the new Opper catalog entry. Update these catalog sections to match the English guide.🤖 Prompt for AI Agents
Source: Path instructions