Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

Studio: load OpenRouter models from the API (#16562)

Nilay9e1b9d5fc73a
diff --git a/studio/backend/core/inference/external_provider.py b/studio/backend/core/inference/external_provider.py
index 710749394bb..3e50a0ed039 100644
--- a/studio/backend/core/inference/external_provider.py
+++ b/studio/backend/core/inference/external_provider.py
@@ -1148,6 +1148,40 @@ async def _stream_post_with_compat_fallbacks(
return
+_OPENROUTER_CATALOG_TTL_S = 3600.0
+_OPENROUTER_CATALOG_RETRY_S = 60.0
+# cache key -> (expires_at, models)
+_openrouter_catalog: dict[str, tuple[float, list[dict[str, Any]]]] = {}
+_openrouter_catalog_locks: dict[str, asyncio.Lock] = {}
+_OPENROUTER_MODEL_KEYS = (
+ "id",
+ "context_length",
+ "architecture",
+ "reasoning",
+ "top_provider",
+ "supported_parameters",
+)
+
+
+def _slim_openrouter_models(payload: Any) -> list[dict[str, Any]]:
+ raw = payload.get("data") if isinstance(payload, dict) else None
+ models = []
+ for m in raw or []:
+ if not isinstance(m, dict) or not m.get("id"):
+ continue
+ endpoints = m.get("endpoints")
+ if isinstance(endpoints, list) and "/api/v1/chat/completions" not in endpoints:
+ continue
+ outputs = (m.get("architecture") or {}).get("output_modalities")
+ if isinstance(outputs, list) and "text" not in outputs:
+ continue
+ slim = {k: m[k] for k in _OPENROUTER_MODEL_KEYS if k in m}
+ slim["created"] = m.get("created") or 0
+ models.append(slim)
+ models.sort(key = lambda m: m["created"], reverse = True)
+ return models
+
+
def _client() -> httpx.AsyncClient:
"""The shared client for the owner; a screening client of its own for each managed account."""
from utils.account_context import current_account_id, is_owner_context
@@ -7319,6 +7353,8 @@ class ExternalProviderClient:
async def list_models(self) -> list[dict[str, Any]]:
"""return each provider's OpenAI-compatible /models entries, including Anthropic."""
+ if self.provider_type == "openrouter":
+ return await self._list_openrouter_models()
try:
data, models = await self._models_payload(self._timeout)
if self.provider_type == "ollama":
@@ -7334,6 +7370,43 @@ class ExternalProviderClient:
logger.error("Failed to list models from %s: %s", self.provider_type, exc)
raise
+ async def _list_openrouter_models(self) -> list[dict[str, Any]]:
+ key_digest = hashlib.sha256((self.api_key or "").encode("utf-8")).hexdigest()[:16]
+ cache_key = f"{self.base_url}\n{key_digest}"
+ cached = _openrouter_catalog.get(cache_key)
+ if cached and time.monotonic() < cached[0]:
+ return cached[1]
+ # Per key, so a slow proxy or account never holds up another connection's catalog.
+ async with _openrouter_catalog_locks.setdefault(cache_key, asyncio.Lock()):
+ cached = _openrouter_catalog.get(cache_key)
+ if cached and time.monotonic() < cached[0]:
+ return cached[1]
+ try:
+ response = await _client().get(
+ f"{self.base_url}/models",
+ headers = self._auth_headers(),
+ timeout = self._timeout,
+ )
+ response.raise_for_status()
+ models = _slim_openrouter_models(response.json())
+ except (httpx.HTTPError, ValueError) as exc:
+ if cached:
+ logger.warning("OpenRouter catalog refresh failed, serving cache: %s", exc)
+ # Back off, or every waiter queued behind a timed-out refresh retries in turn.
+ _openrouter_catalog[cache_key] = (
+ time.monotonic() + _OPENROUTER_CATALOG_RETRY_S,
+ cached[1],
+ )
+ return cached[1]
+ logger.error("Failed to list models from openrouter: %s", exc)
+ raise
+ if models:
+ _openrouter_catalog[cache_key] = (
+ time.monotonic() + _OPENROUTER_CATALOG_TTL_S,
+ models,
+ )
+ return models
+
async def _models_payload(self, timeout: Any) -> tuple[Any, list[dict[str, Any]]]:
response = await _client().get(
f"{self.base_url}/models",
diff --git a/studio/backend/core/inference/providers.py b/studio/backend/core/inference/providers.py
index 2d053d2f655..dc592bfe150 100644
--- a/studio/backend/core/inference/providers.py
+++ b/studio/backend/core/inference/providers.py
@@ -509,26 +509,20 @@ PROVIDER_REGISTRY: dict[str, dict[str, Any]] = {
"openrouter": {
"display_name": "OpenRouter",
"base_url": "https://openrouter.ai/api/v1",
- # Curated picker list (locked, not live /models).
+ # Live /models fills the rest; ~*-latest aliases track new releases.
"default_models": [
"openrouter/free",
- "openai/gpt-4o",
- "anthropic/claude-sonnet-4-5",
- "google/gemini-2.5-flash",
- "mistralai/mistral-large-2411",
- "deepseek/deepseek-r1",
- "mistralai/mistral-small-3.1-24b-instruct",
- "perceptron/perceptron-mk1",
- "inclusionai/ring-2.6-1t:free",
- "google/gemini-3.1-flash-lite",
- "baidu/cobuddy:free",
- "openai/gpt-chat-latest",
- "x-ai/grok-4.3",
- "ibm-granite/granite-4.1-8b",
- "openrouter/owl-alpha",
- "poolside/laguna-xs.2:free",
+ "openrouter/auto",
+ "~anthropic/claude-sonnet-latest",
+ "~anthropic/claude-opus-latest",
+ "~openai/gpt-sol-latest",
+ "~openai/gpt-mini-latest",
"~google/gemini-pro-latest",
+ "~google/gemini-flash-latest",
+ "~x-ai/grok-latest",
+ "~deepseek/deepseek-flash-latest",
"~moonshotai/kimi-latest",
+ "~z-ai/glm-latest",
],
"supports_streaming": True,
"supports_vision": True,
@@ -543,7 +537,6 @@ PROVIDER_REGISTRY: dict[str, dict[str, Any]] = {
"X-Title": "Unsloth Studio",
},
"notes": "Unified gateway to 300+ models across all major providers. HTTP-Referer and X-Title headers sent for attribution.",
- "model_list_mode": "curated",
},
"typesafe": {
"display_name": "TypeSafe",
diff --git a/studio/backend/routes/providers.py b/studio/backend/routes/providers.py
index 51629202e3d..46b5553c729 100644
--- a/studio/backend/routes/providers.py
+++ b/studio/backend/routes/providers.py
@@ -984,6 +984,8 @@ async def test_provider(
try:
if answers_decisions_only(payload.provider_type, payload.api_type):
await client.list_decision_models()
+ elif payload.provider_type == "openrouter":
+ await client.verify_models_endpoint_lightweight()
else:
await client.list_models()
except Exception:
@@ -1019,6 +1021,8 @@ async def test_provider(
),
models_count = None,
)
+ if payload.provider_type == "openrouter":
+ await client.verify_models_endpoint_lightweight()
models = await client.list_models()
if payload.provider_type in _KEY_CHECKED_PROVIDERS and await client.api_key_rejected():
return ProviderTestResult(
diff --git a/studio/backend/tests/test_openrouter_models.py b/studio/backend/tests/test_openrouter_models.py
new file mode 100644
index 00000000000..10bb0bd4594
--- /dev/null
+++ b/studio/backend/tests/test_openrouter_models.py
@@ -0,0 +1,172 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
+
+import asyncio
+
+import httpx
+import pytest
+
+from core.inference import external_provider as ep_mod
+from core.inference.external_provider import ExternalProviderClient
+from core.inference.provider_model_capabilities import provider_model_capabilities
+from core.inference.providers import get_provider_info
+from models.providers import ProviderTestRequest
+from routes import providers as providers_route
+
+CATALOG = {
+ "data": [
+ {
+ "id": "old/chat",
+ "created": 100,
+ "context_length": 8192,
+ "architecture": {"output_modalities": ["text"]},
+ "endpoints": ["/api/v1/chat/completions"],
+ },
+ {
+ "id": "new/chat",
+ "created": 300,
+ "context_length": 131072,
+ "architecture": {"input_modalities": ["text"], "output_modalities": ["text"]},
+ "endpoints": ["/api/v1/chat/completions", "/api/v1/messages"],
+ "reasoning": {"supported_efforts": ["low", "high"], "mandatory": False},
+ "top_provider": {"max_completion_tokens": 32768},
+ "supported_parameters": ["reasoning", "tools"],
+ },
+ {
+ "id": "new/chat:batch",
+ "created": 300,
+ "architecture": {"output_modalities": ["text"]},
+ "endpoints": [],
+ },
+ {
+ "id": "some/image-gen",
+ "created": 200,
+ "architecture": {"output_modalities": ["image"]},
+ "endpoints": ["/api/v1/chat/completions"],
+ },
+ {"id": "legacy/no-metadata", "created": 50},
+ ]
+}
+
+
+def catalog_server(monkeypatch):
+ state = {"calls": 0, "fail": False}
+
+ async def handler(request: httpx.Request) -> httpx.Response:
+ state["calls"] += 1
+ await asyncio.sleep(0.01)
+ assert request.url.path == "/api/v1/models"
+ if state["fail"]:
+ return httpx.Response(503)
+ return httpx.Response(200, json = CATALOG)
+
+ monkeypatch.setattr(
+ ep_mod, "_http_client", httpx.AsyncClient(transport = httpx.MockTransport(handler))
+ )
+ monkeypatch.setattr(ep_mod, "_openrouter_catalog", {})
+ monkeypatch.setattr(ep_mod, "_openrouter_catalog_locks", {})
+ return state
+
+
+def _expire_catalog():
+ for key, (_, models) in ep_mod._openrouter_catalog.items():
+ ep_mod._openrouter_catalog[key] = (0.0, models)
+
+
+def _client(api_key: str = "") -> ExternalProviderClient:
+ return ExternalProviderClient(
+ provider_type = "openrouter",
+ base_url = "https://openrouter.ai/api/v1",
+ api_key = api_key,
+ )
+
+
+def test_registry_uses_live_catalog_with_live_defaults():
+ info = get_provider_info("openrouter")
+ assert info.get("model_list_mode", "remote") == "remote"
+ assert "openrouter/free" in info["default_models"]
+
+
+def test_filters_non_chat_models_and_sorts_newest_first(catalog_server):
+ models = asyncio.run(_client().list_models())
+ assert [m["id"] for m in models] == ["new/chat", "old/chat", "legacy/no-metadata"]
+ assert models[0]["context_length"] == 131072
+
+
+def test_keeps_metadata_for_model_capabilities(catalog_server):
+ models = asyncio.run(_client().list_models())
+ caps = {c["id"]: c for c in provider_model_capabilities("openrouter", models)}
+ assert caps["new/chat"]["input_modalities"] == ["text"]
+ assert caps["new/chat"]["reasoning"]["supported_efforts"] == ["low", "high"]
+ assert caps["new/chat"]["max_output_tokens"] == 32768
+ assert caps["new/chat"]["supported_parameters"] == ["reasoning", "tools"]
+
+
+def test_catalog_is_cached_across_clients(catalog_server):
+ async def run():
+ await asyncio.gather(*(_client().list_models() for _ in range(5)))
+ await _client().list_models()
+
+ asyncio.run(run())
+ assert catalog_server["calls"] == 1
+
+
+def test_catalog_cache_is_scoped_to_the_api_key(catalog_server):
+ async def run():
+ await _client("key-a").list_models()
+ await _client("key-b").list_models()
+ await _client("key-a").list_models()
+
+ asyncio.run(run())
+ assert catalog_server["calls"] == 2
+
+
+def test_serves_stale_catalog_and_backs_off_when_refresh_fails(catalog_server):
+ first = asyncio.run(_client().list_models())
+ _expire_catalog()
+ catalog_server["fail"] = True
+ assert asyncio.run(_client().list_models()) == first
+ assert asyncio.run(_client().list_models()) == first
+ assert catalog_server["calls"] == 2
+
+
+def test_a_slow_catalog_does_not_block_another_key(monkeypatch):
+ release = asyncio.Event()
+
+ async def handler(request: httpx.Request) -> httpx.Response:
+ if request.headers.get("authorization") == "Bearer slow":
+ await release.wait()
+ return httpx.Response(200, json = CATALOG)
+
+ monkeypatch.setattr(
+ ep_mod, "_http_client", httpx.AsyncClient(transport = httpx.MockTransport(handler))
+ )
+ monkeypatch.setattr(ep_mod, "_openrouter_catalog", {})
+ monkeypatch.setattr(ep_mod, "_openrouter_catalog_locks", {})
+
+ async def run():
+ slow = asyncio.create_task(_client("slow").list_models())
+ await asyncio.sleep(0)
+ fast = await asyncio.wait_for(_client("fast").list_models(), timeout = 1)
+ release.set()
+ await slow
+ return fast
+
+ assert [m["id"] for m in asyncio.run(run())][0] == "new/chat"
+
+
+def test_raises_when_no_cache_and_fetch_fails(catalog_server):
+ catalog_server["fail"] = True
+ with pytest.raises(httpx.HTTPStatusError):
+ asyncio.run(_client().list_models())
+
+
+def test_connection_test_does_not_pass_on_a_cached_catalog(catalog_server, monkeypatch):
+ monkeypatch.setattr(providers_route, "validate_provider_base_url", lambda url: url)
+ monkeypatch.setattr(providers_route, "resolve_provider_api_key_or_400", lambda *a, **k: "")
+ request = ProviderTestRequest(provider_type = "openrouter")
+ assert asyncio.run(providers_route.test_provider(request, "tester", False)).success
+ catalog_server["fail"] = True
+ result = asyncio.run(providers_route.test_provider(request, "tester", False))
+ assert not result.success
diff --git a/studio/frontend/src/features/chat/chat-providers-dialog.tsx b/studio/frontend/src/features/chat/chat-providers-dialog.tsx
index 2d610fb410c..00d0935c717 100644
--- a/studio/frontend/src/features/chat/chat-providers-dialog.tsx
+++ b/studio/frontend/src/features/chat/chat-providers-dialog.tsx
@@ -141,6 +141,14 @@ function capProviderMenuAtItem(item: HTMLElement | null) {
content.style.maxHeight = `min(var(--radix-select-content-available-height), ${top}px)`;
}
+function hasPublicModelCatalog(providerType: string | null | undefined): boolean {
+ return providerType === "openrouter";
+}
+
+export function withSavedModelIds(catalog: string[], saved: string[]): string[] {
+ return [...catalog, ...saved.filter((id) => !catalog.includes(id))];
+}
+
function parseManualModelIds(text: string): string[] {
const seen = new Set<string>();
const out: string[] = [];
@@ -277,6 +285,8 @@ export function ChatProvidersSettings({
}: ChatProvidersSettingsProps) {
const providersRef = useRef(providers);
const seededProviderTypeRef = useRef<string | null>(null);
+ // One object per automatic load: a reopened form reuses the key, never the request.
+ const autoLoadedCatalogRef = useRef<{ key: string } | null>(null);
// One-shot latch; user navigation sets it too so a slow first sync cannot pull them into the form.
const autoOpenedAddFormRef = useRef(false);
const [page, setPage] = useState<"list" | "form">("list");
@@ -302,6 +312,8 @@ export function ChatProvidersSettings({
const [syncingProviders, setSyncingProviders] = useState(false);
const [registryLoading, setRegistryLoading] = useState(false);
const [modelsLoading, setModelsLoading] = useState(false);
+ // Kept apart from modelsLoading: an automatic catalog load must not hold up saving.
+ const [catalogAutoLoad, setCatalogAutoLoad] = useState<{ key: string } | null>(null);
const codexCatalogRequestRef = useRef(0);
const [mutatingProvider, setMutatingProvider] = useState(false);
const [testingProviderIds, setTestingProviderIds] = useState<
@@ -447,10 +459,18 @@ export function ChatProvidersSettings({
const missingModelCatalogApiKey =
!isCustomProvider &&
!isCuratedModelList &&
+ !hasPublicModelCatalog(providerType) &&
apiKey.trim().length === 0 &&
!(editingProviderHasSavedKey && !clearApiKeyRequested);
+ const autoLoadCatalogKey =
+ page === "form" && hasPublicModelCatalog(providerType)
+ ? `${editingProviderId ?? "new"}:${providerType}`
+ : null;
+ const catalogAutoLoading =
+ catalogAutoLoad !== null && catalogAutoLoad.key === autoLoadCatalogKey;
const loadModelsDisabled =
modelsLoading ||
+ catalogAutoLoading ||
mutatingProvider ||
isManualModelList ||
missingModelCatalogBaseUrl ||
@@ -493,6 +513,17 @@ export function ChatProvidersSettings({
providersRef.current = providers;
}, [providers]);
+ useEffect(() => {
+ if (!autoLoadCatalogKey) return;
+ const autoLoad = { key: autoLoadCatalogKey };
+ autoLoadedCatalogRef.current = autoLoad;
+ void loadModels({ autoLoad });
+ // Leaving the form or unmounting retires the request, so its response cannot write stale state.
+ return () => {
+ if (autoLoadedCatalogRef.current === autoLoad) autoLoadedCatalogRef.current = null;
+ };
+ }, [autoLoadCatalogKey]); // eslint-disable-line react-hooks/exhaustive-deps
+
useEffect(() => {
if (!providerType || editingProviderId) return;
if (seededProviderTypeRef.current === providerType) return;
@@ -509,8 +540,9 @@ export function ChatProvidersSettings({
}
return;
}
- // Seed defaults only for curated providers; others stay empty until "Load available models".
- const seedDefaults = entry.model_list_mode === "curated";
+ // Seed defaults for curated providers and OpenRouter; others stay empty until "Load available models".
+ const seedDefaults =
+ entry.model_list_mode === "curated" || hasPublicModelCatalog(providerType);
setAvailableModels(seedDefaults ? [...entry.default_models] : []);
setSelectedModelIds(
isDecisionConnection({ providerType })
@@ -629,7 +661,11 @@ export function ChatProvidersSettings({
function openAddProvider() {
resetForm();
const entry = providerType ? registryByType.get(providerType) : null;
- if (entry?.model_list_mode === "curated") {
+ if (
+ entry &&
+ (entry.model_list_mode === "curated" ||
+ hasPublicModelCatalog(providerType))
+ ) {
setAvailableModels([...entry.default_models]);
}
if (entry && isDecisionConnection({ providerType: entry.provider_type })) {
@@ -707,7 +743,10 @@ export function ChatProvidersSettings({
return value;
}
- async function loadModels() {
+ async function loadModels({
+ autoLoad,
+ }: { autoLoad?: { key: string } } = {}) {
+ const silent = autoLoad !== undefined;
if (!providerType) {
toast.error("Choose a connection first.");
return;
@@ -742,7 +781,12 @@ export function ChatProvidersSettings({
);
return;
}
- if (!isCustomProvider && !apiKey.trim() && !editingProviderHasSavedKey) {
+ if (
+ !isCustomProvider &&
+ !hasPublicModelCatalog(providerType) &&
+ !apiKey.trim() &&
+ !editingProviderHasSavedKey
+ ) {
toast.error("Add an API key first.");
return;
}
@@ -755,23 +799,28 @@ export function ChatProvidersSettings({
toast.info("Save the new Base URL first, then load its models.");
return;
}
- setModelsLoading(true);
+ if (silent) setCatalogAutoLoad(autoLoad);
+ else setModelsLoading(true);
try {
- const baseUrl = parseBaseUrlForProvider(
- baseUrlDraft,
- supportsRemoteModelCatalog(providerType),
- providerType,
- );
+ // Auto-loads can run before the form drops the previous provider's key and Base URL.
+ const baseUrl = silent
+ ? editingProvider?.baseUrl || null
+ : parseBaseUrlForProvider(
+ baseUrlDraft,
+ supportsRemoteModelCatalog(providerType),
+ providerType,
+ );
const backendProviderType =
toExternalBackendProviderType(providerType) ?? providerType;
const models = await listProviderModels({
providerType: backendProviderType,
providerId: editingProviderId,
- apiKey: apiKey.trim(),
+ apiKey: silent ? "" : apiKey.trim(),
baseUrl,
apiType: providerType === LEGACY_CUSTOM_PROVIDER_TYPE ? apiType : undefined,
});
+ if (silent && autoLoadedCatalogRef.current !== autoLoad) return;
// The picker keeps only ids, so per-model capabilities are learned here or lost.
learnCatalogModelCapabilities(providerType, models);
const registryDefaults = supportsRemoteModelCatalog(providerType)
@@ -786,17 +835,22 @@ export function ChatProvidersSettings({
].filter((id) => id.length > 0),
),
]);
- setAvailableModels(modelIds);
- setSelectedModelIds((prev) =>
- prev.filter((id) => modelIds.includes(id)),
- );
- if (modelIds.length === 0) {
+ // OpenRouter routing variants (:nitro, :floor) are valid ids that /models never lists.
+ if (silent || hasPublicModelCatalog(providerType)) {
+ setAvailableModels(withSavedModelIds(modelIds, selectedModelIds));
+ } else {
+ setAvailableModels(modelIds);
+ setSelectedModelIds((prev) =>
+ prev.filter((id) => modelIds.includes(id)),
+ );
+ }
+ if (!silent && modelIds.length === 0) {
const hint =
providerType === LEGACY_CUSTOM_PROVIDER_TYPE && apiType === "systemone"
? SYSTEM_ONE_EMPTY_CATALOG_HINT
: emptyCatalogHint(providerType);
toast.info(hint.title, { description: hint.description });
- } else {
+ } else if (!silent) {
toast.success(
`Found ${modelIds.length} ${modelIds.length === 1 ? "model" : "models"}.`,
);
@@ -810,12 +864,13 @@ export function ChatProvidersSettings({
),
);
}
- setModelSearchQuery("");
+ if (!silent) setModelSearchQuery("");
} catch (error) {
const message = error instanceof Error ? error.message : "Unknown error";
- toast.error(`Could not load models: ${message}`);
+ if (!silent) toast.error(`Could not load models: ${message}`);
} finally {
- setModelsLoading(false);
+ if (silent) setCatalogAutoLoad((current) => (current === autoLoad ? null : current));
+ else setModelsLoading(false);
}
}
@@ -2056,7 +2111,7 @@ export function ChatProvidersSettings({
title={loadModelsTitle}
onClick={() => void loadModels()}
>
- {modelsLoading ? (
+ {modelsLoading || catalogAutoLoading ? (
<>
<Spinner className="mr-2 size-3.5" />
Loading…
diff --git a/studio/frontend/src/features/chat/provider-capabilities.ts b/studio/frontend/src/features/chat/provider-capabilities.ts
index eb01acec956..49d805c256f 100644
--- a/studio/frontend/src/features/chat/provider-capabilities.ts
+++ b/studio/frontend/src/features/chat/provider-capabilities.ts
@@ -317,10 +317,11 @@ export function resolveExternalMaxTokensClamp(input: {
function _inferProviderFromOpenrouterId(
normalizedId: string,
): string | null {
- if (normalizedId.startsWith("openai/")) return "openai";
- if (normalizedId.startsWith("anthropic/")) return "anthropic";
- if (normalizedId.startsWith("google/")) return "gemini";
- if (normalizedId.startsWith("deepseek/")) return "deepseek";
+ const id = normalizedId.replace(/^~/, "");
+ if (id.startsWith("openai/")) return "openai";
+ if (id.startsWith("anthropic/")) return "anthropic";
+ if (id.startsWith("google/")) return "gemini";
+ if (id.startsWith("deepseek/")) return "deepseek";
return null;
}
diff --git a/studio/frontend/tests/openrouter-auto-load-keeps-saved-models.test.ts b/studio/frontend/tests/openrouter-auto-load-keeps-saved-models.test.ts
new file mode 100644
index 00000000000..fecb4915bd9
--- /dev/null
+++ b/studio/frontend/tests/openrouter-auto-load-keeps-saved-models.test.ts
@@ -0,0 +1,68 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
+
+import assert from "node:assert/strict";
+import { after, before, test } from "node:test";
+import { createServer, type ViteDevServer } from "vite";
+
+import { readSrc } from "./helpers/kit.ts";
+
+let vite: ViteDevServer;
+let withSavedModelIds: (catalog: string[], saved: string[]) => string[];
+
+before(async () => {
+ vite = await createServer({ appType: "custom", server: { middlewareMode: true } });
+ const loaded = await vite.ssrLoadModule(
+ "/src/features/chat/chat-providers-dialog.tsx",
+ );
+ withSavedModelIds = loaded.withSavedModelIds;
+});
+
+after(async () => {
+ await vite.close();
+});
+
+test("saved ids missing from the live catalog stay pickable", () => {
+ assert.deepEqual(
+ withSavedModelIds(
+ ["openai/gpt-5.5", "deepseek/deepseek-v4-pro"],
+ ["deepseek/deepseek-v4-pro:nitro", "openai/gpt-5.5"],
+ ),
+ ["openai/gpt-5.5", "deepseek/deepseek-v4-pro", "deepseek/deepseek-v4-pro:nitro"],
+ );
+});
+
+test("automatic catalog loads ignore the typed API key and Base URL", () => {
+ const dialog = readSrc("features/chat/chat-providers-dialog.tsx");
+ assert.match(dialog, /apiKey: silent \? "" : apiKey\.trim\(\),/);
+ assert.match(
+ dialog,
+ /const baseUrl = silent\s*\? editingProvider\?\.baseUrl \|\| null\s*: parseBaseUrlForProvider\(\s*baseUrlDraft,/,
+ );
+});
+
+test("explicit OpenRouter reloads keep saved routing variants too", () => {
+ const dialog = readSrc("features/chat/chat-providers-dialog.tsx");
+ assert.match(
+ dialog,
+ /if \(silent \|\| hasPublicModelCatalog\(providerType\)\) \{\s*setAvailableModels\(withSavedModelIds\(modelIds, selectedModelIds\)\);/,
+ );
+});
+
+test("automatic catalog loads do not disable saving", () => {
+ const dialog = readSrc("features/chat/chat-providers-dialog.tsx");
+ assert.match(dialog, /if \(silent\) setCatalogAutoLoad\(autoLoad\);\s*else setModelsLoading\(true\);/);
+ const save = dialog.match(/disabled=\{\s*registryLoading \|\|[^}]*\}\s*onClick=\{\(\) =>\s*editingProviderId\s*\? void saveProviderEdits\(\)/);
+ assert.ok(save, "Save button not found");
+ assert.doesNotMatch(save[0], /catalogAutoLoading/);
+});
+
+test("a response from a retired automatic load is dropped by identity, not key", () => {
+ const dialog = readSrc("features/chat/chat-providers-dialog.tsx");
+ assert.match(dialog, /const autoLoad = \{ key: autoLoadCatalogKey \};\s*autoLoadedCatalogRef\.current = autoLoad;/);
+ assert.match(dialog, /if \(silent && autoLoadedCatalogRef\.current !== autoLoad\) return;/);
+ assert.match(
+ dialog,
+ /return \(\) => \{\s*if \(autoLoadedCatalogRef\.current === autoLoad\) autoLoadedCatalogRef\.current = null;\s*\};\s*\}, \[autoLoadCatalogKey\]\);/,
+ );
+});