@fased/fased 0.1.54 → 0.1.56

package/dist/providers/refresh.js

@@ -1,27 +1,30 @@
 import { BASE_THINKING_LEVELS } from "../shared/model-thinking.js";
 import { CLOUDFLARE_AI_GATEWAY_MODEL_IDS, CLOUDFLARE_AI_GATEWAY_PROVIDER_BRAND_ID, CLOUDFLARE_AI_GATEWAY_ROUTE_ID } from "./cloudflare-ai-gateway-shared.js";
 import { HUGGINGFACE_MODEL_IDS } from "./huggingface-models.js";
-import { LITELLM_BASE_URL, LITELLM_MODEL_IDS } from "./litellm-models.js";
 import { OPENCODE_ZEN_MODEL_IDS } from "./opencode-zen-shared.js";
 import { SYNTHETIC_MODEL_IDS } from "./synthetic-models.js";
 import { TOGETHER_MODEL_IDS } from "./together-models.js";
 import { VENICE_MODEL_IDS } from "./venice-models.js";
 import { VERCEL_AI_GATEWAY_MODEL_IDS } from "./vercel-ai-gateway-models.js";
 import { XIAOMI_MODEL_IDS } from "./xiaomi-models.js";
+import { LITELLM_BASE_URL } from "./litellm-models.js";
 import { ANTHROPIC_MODEL_IDS, ANTHROPIC_PROVIDER_BRAND_ID, ANTHROPIC_ROUTE_ID, BYTEPLUS_CODING_MODEL_IDS, BYTEPLUS_CODING_ROUTE_ID, BYTEPLUS_MODEL_IDS, BYTEPLUS_PLAN_ROUTE_ID, BYTEPLUS_PROVIDER_BRAND_ID, BYTEPLUS_ROUTE_ID, CHUTES_MODEL_IDS, CHUTES_PROVIDER_BRAND_ID, CHUTES_ROUTE_ID, COPILOT_PROVIDER_BRAND_ID, COPILOT_PROXY_MODEL_IDS, COPILOT_PROXY_ROUTE_ID, CUSTOM_PROVIDER_BRAND_ID, CUSTOM_PROVIDER_ROUTE_ID, GITHUB_COPILOT_ROUTE_ID, GOOGLE_API_ROUTE_ID, GOOGLE_GEMINI_CLI_ROUTE_ID, GOOGLE_GEMINI_MODEL_IDS, GOOGLE_PROVIDER_BRAND_ID, HUGGINGFACE_PROVIDER_BRAND_ID, HUGGINGFACE_ROUTE_ID, KIMI_CODING_MODEL_IDS, KIMI_CODING_ROUTE_ID, LITELLM_PROVIDER_BRAND_ID, LITELLM_ROUTE_ID, LMSTUDIO_PROVIDER_BRAND_ID, LMSTUDIO_ROUTE_ID, MINIMAX_API_ROUTE_ID, MINIMAX_CN_ROUTE_ID, MINIMAX_MODEL_IDS, MINIMAX_PORTAL_ROUTE_ID, MINIMAX_PROVIDER_BRAND_ID, MISTRAL_MODEL_IDS, MISTRAL_PROVIDER_BRAND_ID, MISTRAL_ROUTE_ID, MOONSHOT_MODEL_IDS, MOONSHOT_PROVIDER_BRAND_ID, MOONSHOT_ROUTE_ID, OLLAMA_PROVIDER_BRAND_ID, OLLAMA_ROUTE_ID, OPENAI_API_MODEL_IDS, OPENAI_API_ROUTE_ID, OPENAI_CODEX_ROUTE_ID, OPENAI_PROVIDER_BRAND_ID, OPENAI_SIGN_IN_MODEL_IDS, OPENCODE_ZEN_PROVIDER_BRAND_ID, OPENCODE_ZEN_ROUTE_ID, OPENROUTER_MODEL_IDS, OPENROUTER_PROVIDER_BRAND_ID, OPENROUTER_ROUTE_ID, QIANFAN_MODEL_IDS, QIANFAN_PROVIDER_BRAND_ID, QIANFAN_ROUTE_ID, QWEN_API_MODEL_IDS, QWEN_API_ROUTE_ID, QWEN_CODING_PLAN_MODEL_IDS, QWEN_CODING_PLAN_ROUTE_ID, QWEN_PROVIDER_BRAND_ID, SYNTHETIC_PROVIDER_BRAND_ID, SYNTHETIC_ROUTE_ID, TOGETHER_PROVIDER_BRAND_ID, TOGETHER_ROUTE_ID, VENICE_PROVIDER_BRAND_ID, VENICE_ROUTE_ID, VERCEL_AI_GATEWAY_PROVIDER_BRAND_ID, VERCEL_AI_GATEWAY_ROUTE_ID, VLLM_PROVIDER_BRAND_ID, VLLM_ROUTE_ID, VOLCENGINE_CODING_MODEL_IDS, VOLCENGINE_CODING_ROUTE_ID, VOLCENGINE_MODEL_IDS, VOLCENGINE_PLAN_ROUTE_ID, VOLCENGINE_PROVIDER_BRAND_ID, VOLCENGINE_ROUTE_ID, XAI_MODEL_IDS, XAI_PROVIDER_BRAND_ID, XAI_ROUTE_ID, XIAOMI_PROVIDER_BRAND_ID, XIAOMI_ROUTE_ID, ZAI_MODEL_IDS, ZAI_PROVIDER_BRAND_ID, ZAI_ROUTE_ID, listProviderBrandManifests, lookupProviderManifestModelCapability, resolveProviderRouteModelCapability } from "./registry.js";
 import { readFile } from "node:fs/promises";
+import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/providers/refresh.ts
 const OPENAI_DOCS_MODELS_URL = "https://developers.openai.com/api/docs/models/all";
+const OPENAI_API_MODELS_URL = "https://api.openai.com/v1/models";
 const CHUTES_MODELS_URL = "https://llm.chutes.ai/v1/models";
 const OPENROUTER_MODELS_URL = "https://openrouter.ai/api/v1/models";
 const VERCEL_AI_GATEWAY_MODELS_URL = "https://ai-gateway.vercel.sh/v1/models";
 const OPENCODE_ZEN_MODELS_URL = "https://opencode.ai/zen/v1/models";
 const HUGGINGFACE_MODELS_URL = "https://router.huggingface.co/v1/models";
 const VENICE_MODELS_URL = "https://api.venice.ai/api/v1/models";
+const PROVIDER_CATALOG_TIMEOUT_MS = 8e3;
 const ANTHROPIC_MODELS_URL = "https://api.anthropic.com/v1/models";
 const GOOGLE_GEMINI_MODELS_URL = "https://generativelanguage.googleapis.com/v1beta/models";
-const XAI_MODELS_URL = "https://api.x.ai/v1/models";
+const XAI_LANGUAGE_MODELS_URL = "https://api.x.ai/v1/language-models";
 const MISTRAL_MODELS_URL = "https://api.mistral.ai/v1/models";
 const MINIMAX_MODELS_URL = "https://api.minimax.io/v1/models";
 const MINIMAX_PORTAL_DEFAULT_BASE_URL = "https://api.minimax.io/anthropic";
@@ -44,9 +47,7 @@ const VLLM_DEFAULT_BASE_URL = "http://127.0.0.1:8000/v1";
 const OLLAMA_DEFAULT_BASE_URL = "http://127.0.0.1:11434";
 const LMSTUDIO_DEFAULT_BASE_URL = "http://127.0.0.1:1234/v1";
 const LITELLM_DEFAULT_BASE_URL = LITELLM_BASE_URL;
-const OPENAI_CURRENT_API_MODEL_RE = /^gpt-5\.(?:[4-9]|\d{2,})(?:-(?:mini|nano|terra|luna))?$/;
-const OPENAI_CURRENT_SIGN_IN_MODEL_RE = /^gpt-(?:5\.6-(?:sol|terra|luna)|5\.(?:[4-9]|\d{2,})(?:-mini)?|5\.3-codex-spark)$/;
-const CHUTES_CURRENT_NORMAL_UI_MODEL_RE = /^(?:google\/gemma-4-[^/]+-TEE|Qwen\/Qwen3(?:\.\d+)?-[^/]+-TEE|deepseek-ai\/DeepSeek-V3\.2-TEE|zai-org\/GLM-5(?:\.\d+)?-TEE|moonshotai\/Kimi-K2\.6-TEE)$/;
+const providerCatalogView = new AsyncLocalStorage();
 function normalizeModelIds(values, options = {}) {
 	const seen = new Set();
 	const result = [];
@@ -108,9 +109,19 @@ function metadataString(metadata, key) {
 function setProviderRefreshEnvFromProfile(params) {
 	const provider = params.profile.provider.trim();
 	const apiKey = resolveApiKeyProfileValue(params.profile, params.env);
+	const token = resolveTokenProfileValue(params.profile, params.env);
 	switch (provider) {
+		case "openai":
+			setProviderRefreshEnvValue(params.target, "OPENAI_API_KEY", apiKey);
+			break;
+		case "chutes":
+			setProviderRefreshEnvValue(params.target, "CHUTES_API_KEY", token);
+			break;
 		case "anthropic":
 			setProviderRefreshEnvValue(params.target, "ANTHROPIC_API_KEY", apiKey);
+			if (params.profile.type !== "api_key") {
+				setProviderRefreshEnvValue(params.target, "ANTHROPIC_OAUTH_TOKEN", token);
+			}
 			break;
 		case "google":
 		case "gemini":
@@ -124,7 +135,7 @@ function setProviderRefreshEnvFromProfile(params) {
 			break;
 		}
 		case "xai":
-			setProviderRefreshEnvValue(params.target, "XAI_API_KEY", apiKey);
+			setProviderRefreshEnvValue(params.target, "XAI_API_KEY", token);
 			break;
 		case "mistral":
 			setProviderRefreshEnvValue(params.target, "MISTRAL_API_KEY", apiKey);
@@ -187,6 +198,23 @@ function setProviderRefreshEnvFromProfile(params) {
 		case "together":
 			setProviderRefreshEnvValue(params.target, "TOGETHER_API_KEY", apiKey);
 			break;
+		case "openrouter":
+			setProviderRefreshEnvValue(params.target, "OPENROUTER_API_KEY", token);
+			break;
+		case "vercel-ai-gateway":
+		case "ai-gateway":
+			setProviderRefreshEnvValue(params.target, "AI_GATEWAY_API_KEY", apiKey);
+			break;
+		case "opencode":
+		case "opencode-zen":
+			setProviderRefreshEnvValue(params.target, "OPENCODE_API_KEY", apiKey);
+			break;
+		case "huggingface":
+			setProviderRefreshEnvValue(params.target, "HUGGINGFACE_HUB_TOKEN", apiKey);
+			break;
+		case "venice":
+			setProviderRefreshEnvValue(params.target, "VENICE_API_KEY", apiKey);
+			break;
 		default:
 			if (provider.startsWith("custom-")) {
 				setProviderRefreshEnvValue(params.target, "CUSTOM_PROVIDER_API_KEY", apiKey);
@@ -198,6 +226,28 @@ function setProviderRefreshEnvFromModelProvider(params) {
 	const apiKey = resolveEnvSecretValue(params.provider.apiKey, params.env);
 	const baseUrl = typeof params.provider.baseUrl === "string" ? params.provider.baseUrl.trim() : undefined;
 	switch (params.providerId) {
+		case "openai":
+			setProviderRefreshEnvValue(params.target, "OPENAI_API_KEY", apiKey);
+			break;
+		case "chutes":
+			setProviderRefreshEnvValue(params.target, "CHUTES_API_KEY", apiKey);
+			break;
+		case "openrouter":
+			setProviderRefreshEnvValue(params.target, "OPENROUTER_API_KEY", apiKey);
+			break;
+		case "vercel-ai-gateway":
+		case "ai-gateway":
+			setProviderRefreshEnvValue(params.target, "AI_GATEWAY_API_KEY", apiKey);
+			break;
+		case "opencode":
+			setProviderRefreshEnvValue(params.target, "OPENCODE_API_KEY", apiKey);
+			break;
+		case "huggingface":
+			setProviderRefreshEnvValue(params.target, "HUGGINGFACE_HUB_TOKEN", apiKey);
+			break;
+		case "venice":
+			setProviderRefreshEnvValue(params.target, "VENICE_API_KEY", apiKey);
+			break;
 		case "vllm":
 			setProviderRefreshEnvValue(params.target, "VLLM_API_KEY", apiKey);
 			setProviderRefreshEnvValue(params.target, "VLLM_BASE_URL", baseUrl);
@@ -278,6 +328,7 @@ function normalizeProviderRefreshModelEntry(entry) {
 	}
 	return {
 		id,
+		...entry.name ? { name: entry.name } : {},
 		...entry.input ? { input: entry.input } : {},
 		...entry.reasoning !== undefined ? { reasoning: entry.reasoning } : {},
 		...entry.tools !== undefined ? { tools: entry.tools } : {},
@@ -291,6 +342,7 @@ function normalizeProviderRefreshModelEntry(entry) {
 		...entry.reasoningBudgetSupported !== undefined ? { reasoningBudgetSupported: entry.reasoningBudgetSupported } : {},
 		...typeof entry.contextWindow === "number" && entry.contextWindow > 0 ? { contextWindow: entry.contextWindow } : {},
 		...typeof entry.maxTokens === "number" && entry.maxTokens > 0 ? { maxTokens: entry.maxTokens } : {},
+		...entry.price ? { price: entry.price } : {},
 		...entry.source ? { source: entry.source } : {}
 	};
 }
@@ -744,6 +796,57 @@ function readPositiveNumber(value) {
 	}
 	return undefined;
 }
+function readNonNegativeNumber(value) {
+	if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+		return value;
+	}
+	if (typeof value === "string") {
+		const parsed = Number(value);
+		return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;
+	}
+	return undefined;
+}
+function readNonNegativeNumberFrom(record, keys) {
+	for (const key of keys) {
+		const value = readNonNegativeNumber(record[key]);
+		if (value !== undefined) {
+			return value;
+		}
+	}
+	return undefined;
+}
+function readModelPrice(record) {
+	const pricing = asRecord(record.pricing);
+	const perTokenInput = readNonNegativeNumberFrom(pricing, ["prompt", "input"]);
+	const perTokenOutput = readNonNegativeNumberFrom(pricing, ["completion", "output"]);
+	if (perTokenInput !== undefined || perTokenOutput !== undefined) {
+		return {
+			input: (perTokenInput ?? 0) * 1e6,
+			output: (perTokenOutput ?? 0) * 1e6,
+			cacheRead: (readNonNegativeNumberFrom(pricing, ["input_cache_read", "cache_read"]) ?? 0) * 1e6,
+			cacheWrite: (readNonNegativeNumberFrom(pricing, ["input_cache_write", "cache_write"]) ?? 0) * 1e6
+		};
+	}
+	const input = readNonNegativeNumberFrom(record, [
+		"input_price_per_million",
+		"inputPricePerMillion",
+		"prompt_price_per_million"
+	]);
+	const output = readNonNegativeNumberFrom(record, [
+		"output_price_per_million",
+		"outputPricePerMillion",
+		"completion_price_per_million"
+	]);
+	if (input === undefined && output === undefined) {
+		return undefined;
+	}
+	return {
+		input: input ?? 0,
+		output: output ?? 0,
+		cacheRead: readNonNegativeNumberFrom(record, ["cache_read_price_per_million", "cacheReadPerMillion"]) ?? 0,
+		cacheWrite: readNonNegativeNumberFrom(record, ["cache_write_price_per_million", "cacheWritePerMillion"]) ?? 0
+	};
+}
 function asRecord(value) {
 	return value && typeof value === "object" ? value : {};
 }
@@ -875,8 +978,10 @@ function parseOpenRouterModelSnapshotsFromModelsResponse(payload) {
 			const speech = outputModalities.has("audio");
 			const contextWindow = readPositiveNumber(record.context_length) ?? readPositiveNumber(record.context_window) ?? readPositiveNumber(record.contextWindow);
 			const maxTokens = readPositiveNumber(topProvider.max_completion_tokens) ?? readPositiveNumber(record.max_tokens) ?? readPositiveNumber(record.maxTokens);
+			const price = readModelPrice(record);
 			return [{
 				id: entry.id,
+				...readString(record.name) ? { name: readString(record.name) } : {},
 				...input.length > 0 ? { input } : {},
 				...reasoning ? { reasoning } : {},
 				...tools ? { tools } : {},
@@ -886,6 +991,7 @@ function parseOpenRouterModelSnapshotsFromModelsResponse(payload) {
 				...speech ? { speech } : {},
 				...contextWindow ? { contextWindow } : {},
 				...maxTokens ? { maxTokens } : {},
+				...price ? { price } : {},
 				source: "catalog"
 			}];
 		}
@@ -965,8 +1071,11 @@ function parseGenericModelSnapshotsFromModelsResponse(payload) {
 			"outputTokenLimit",
 			"max_completion_tokens"
 		]);
+		const price = readModelPrice(record);
+		const displayName = readString(record.display_name) ?? readString(record.displayName) ?? (readString(record.id) || readString(record.key) || readString(record.model) ? readString(record.name) : undefined);
 		return [{
 			id: normalizeProviderModelId(id),
+			...displayName ? { name: displayName } : {},
 			...input ? { input } : {},
 			...reasoning !== undefined ? { reasoning } : {},
 			...tools !== undefined ? { tools } : {},
@@ -980,6 +1089,7 @@ function parseGenericModelSnapshotsFromModelsResponse(payload) {
 			...thinking.reasoningBudgetSupported !== undefined ? { reasoningBudgetSupported: thinking.reasoningBudgetSupported } : {},
 			...contextWindow ? { contextWindow } : {},
 			...maxTokens ? { maxTokens } : {},
+			...price ? { price } : {},
 			source: "catalog"
 		}];
 	});
@@ -1087,17 +1197,21 @@ function selectModelSnapshotsByIds(entries, selectedIds, route) {
 	});
 }
 function selectManifestModelsForNormalUi(modelIds, preferred) {
-	const allowed = new Set(preferred.map((id) => id.toLowerCase()));
-	return sortWithPreferredOrder(normalizeModelIds(modelIds).filter((id) => allowed.has(id.toLowerCase())), preferred);
+	const normalized = normalizeModelIds(modelIds);
+	if (providerCatalogView.getStore() === "available") {
+		return sortWithPreferredOrder(normalized, preferred);
+	}
+	const recommended = new Set(preferred.map((id) => id.toLowerCase()));
+	return sortWithPreferredOrder(normalized.filter((id) => recommended.has(id.toLowerCase())), preferred);
 }
 function selectOpenAIApiModelsForNormalUi(modelIds) {
-	return sortWithPreferredOrder(normalizeModelIds(modelIds, { lowercase: true }).filter((id) => OPENAI_CURRENT_API_MODEL_RE.test(id)), OPENAI_API_MODEL_IDS);
+	return selectManifestModelsForNormalUi(modelIds, OPENAI_API_MODEL_IDS);
 }
 function selectOpenAISignInModelsForNormalUi(modelIds) {
-	return sortWithPreferredOrder(normalizeModelIds(modelIds, { lowercase: true }).filter((id) => OPENAI_CURRENT_SIGN_IN_MODEL_RE.test(id)), OPENAI_SIGN_IN_MODEL_IDS);
+	return selectManifestModelsForNormalUi(modelIds, OPENAI_SIGN_IN_MODEL_IDS);
 }
 function selectChutesModelsForNormalUi(modelIds) {
-	return sortWithPreferredOrder(normalizeModelIds(modelIds).filter((id) => CHUTES_CURRENT_NORMAL_UI_MODEL_RE.test(id)), CHUTES_MODEL_IDS);
+	return selectManifestModelsForNormalUi(modelIds, CHUTES_MODEL_IDS);
 }
 function selectAnthropicModelsForNormalUi(modelIds) {
 	return selectManifestModelsForNormalUi(modelIds, ANTHROPIC_MODEL_IDS);
@@ -1163,8 +1277,7 @@ function selectDynamicProviderModelsForNormalUi(modelIds) {
 	return normalizeModelIds(modelIds);
 }
 function selectLitellmModelsForNormalUi(modelIds) {
-	const discovered = selectDynamicProviderModelsForNormalUi(modelIds);
-	return discovered.length > 0 ? discovered : [...LITELLM_MODEL_IDS];
+	return selectDynamicProviderModelsForNormalUi(modelIds);
 }
 function selectOpenRouterModelsForNormalUi(modelIds) {
 	return selectManifestModelsForNormalUi(modelIds, OPENROUTER_MODEL_IDS);
@@ -1176,12 +1289,10 @@ function selectOpencodeZenModelsForNormalUi(modelIds) {
 	return selectManifestModelsForNormalUi(modelIds, OPENCODE_ZEN_MODEL_IDS);
 }
 function selectHuggingfaceModelsForNormalUi(modelIds) {
-	const allowed = new Set(HUGGINGFACE_MODEL_IDS);
-	return sortWithPreferredOrder(normalizeModelIds(modelIds).filter((id) => allowed.has(id)), HUGGINGFACE_MODEL_IDS);
+	return selectManifestModelsForNormalUi(modelIds, HUGGINGFACE_MODEL_IDS);
 }
 function selectVeniceModelsForNormalUi(modelIds) {
-	const allowed = new Set(VENICE_MODEL_IDS);
-	return sortWithPreferredOrder(normalizeModelIds(modelIds).filter((id) => allowed.has(id)), VENICE_MODEL_IDS);
+	return selectManifestModelsForNormalUi(modelIds, VENICE_MODEL_IDS);
 }
 function readEnv(env, names) {
 	for (const name of names) {
@@ -1193,7 +1304,10 @@ function readEnv(env, names) {
 	return undefined;
 }
 async function fetchJsonCatalog(params) {
-	const response = await params.fetch(params.url, { headers: params.headers });
+	const response = await params.fetch(params.url, {
+		headers: params.headers,
+		signal: AbortSignal.timeout(PROVIDER_CATALOG_TIMEOUT_MS)
+	});
 	if (!response.ok) {
 		throw new Error(`${params.label} model catalog fetch failed: HTTP ${response.status}`);
 	}
@@ -1269,7 +1383,25 @@ function cloudflareAiGatewayHeaders(env, providerKey) {
 }
 async function fetchOpenAIProviderRefreshSnapshot(params = {}) {
 	const fetchImpl = params.fetch ?? fetch;
-	const response = await fetchImpl(OPENAI_DOCS_MODELS_URL);
+	const token = readEnv(params.env ?? process.env, ["OPENAI_API_KEY"]);
+	if (token) {
+		const payload = await fetchJsonCatalog({
+			fetch: fetchImpl,
+			url: OPENAI_API_MODELS_URL,
+			headers: bearerHeaders(token),
+			label: "OpenAI"
+		});
+		const models = parseGenericModelSnapshotsFromModelsResponse(payload);
+		const ids = selectOpenAIApiModelsForNormalUi(models.map((model) => model.id));
+		return { providers: { [OPENAI_PROVIDER_BRAND_ID]: {
+			missing: { [OPENAI_CODEX_ROUTE_ID]: {
+				reason: "catalog-unsupported",
+				detail: "ChatGPT sign-in models are discovered from the authenticated runtime."
+			} },
+			routes: { [OPENAI_API_ROUTE_ID]: selectModelSnapshotsByIds(models, ids, OPENAI_API_ROUTE_ID) }
+		} } };
+	}
+	const response = await fetchImpl(OPENAI_DOCS_MODELS_URL, { signal: AbortSignal.timeout(PROVIDER_CATALOG_TIMEOUT_MS) });
 	if (!response.ok) {
 		throw new Error(`OpenAI docs model fetch failed: HTTP ${response.status}`);
 	}
@@ -1280,34 +1412,47 @@ async function fetchOpenAIProviderRefreshSnapshot(params = {}) {
 			reason: "catalog-unsupported",
 			detail: "OpenAI public model docs do not verify ChatGPT sign-in route compatibility."
 		} },
-		routes: { [OPENAI_API_ROUTE_ID]: selectOpenAIApiModelsForNormalUi(ids) }
+		routes: { [OPENAI_API_ROUTE_ID]: selectOpenAIApiModelsForNormalUi(ids).map((id) => ({
+			id,
+			source: "official-docs"
+		})) }
 	} } };
 }
 async function fetchChutesProviderRefreshSnapshot(params = {}) {
-	const fetchImpl = params.fetch ?? fetch;
-	const response = await fetchImpl(CHUTES_MODELS_URL);
-	if (!response.ok) {
-		throw new Error(`Chutes model catalog fetch failed: HTTP ${response.status}`);
-	}
-	const payload = await response.json();
+	const token = readEnv(params.env ?? process.env, ["CHUTES_API_KEY"]);
+	const payload = await fetchJsonCatalog({
+		fetch: params.fetch ?? fetch,
+		url: CHUTES_MODELS_URL,
+		headers: optionalBearerHeaders(token),
+		label: "Chutes"
+	});
 	const models = parseGenericModelSnapshotsFromModelsResponse(payload);
 	const ids = models.map((model) => model.id);
 	return { providers: { [CHUTES_PROVIDER_BRAND_ID]: { routes: { [CHUTES_ROUTE_ID]: selectModelSnapshotsByIds(models, selectChutesModelsForNormalUi(ids), CHUTES_ROUTE_ID) } } } };
 }
 async function fetchAnthropicProviderRefreshSnapshot(params = {}) {
-	const token = readEnv(params.env ?? process.env, ["ANTHROPIC_API_KEY"]);
+	const env = params.env ?? process.env;
+	const apiKey = readEnv(env, ["ANTHROPIC_API_KEY"]);
+	const oauthToken = readEnv(env, ["ANTHROPIC_OAUTH_TOKEN"]);
+	const token = apiKey ?? oauthToken;
 	if (!token) {
 		return missingProviderRoutes(ANTHROPIC_PROVIDER_BRAND_ID, { [ANTHROPIC_ROUTE_ID]: {
 			reason: "credential-missing",
-			detail: "Set ANTHROPIC_API_KEY or configure an Anthropic API-key auth profile."
+			detail: "Configure Anthropic sign-in, setup-token, or API-key credentials before model discovery."
 		} });
 	}
 	const payload = await fetchJsonCatalog({
 		fetch: params.fetch ?? fetch,
 		url: ANTHROPIC_MODELS_URL,
-		headers: {
-			"x-api-key": token,
+		headers: apiKey ? {
+			"x-api-key": apiKey,
 			"anthropic-version": "2023-06-01"
+		} : {
+			Authorization: `Bearer ${oauthToken}`,
+			"anthropic-version": "2023-06-01",
+			"anthropic-beta": "claude-code-20250219,oauth-2025-04-20",
+			"user-agent": "fased-agent",
+			"x-app": "cli"
 		},
 		label: "Anthropic"
 	});
@@ -1370,7 +1515,7 @@ async function fetchXaiProviderRefreshSnapshot(params = {}) {
 	}
 	const payload = await fetchJsonCatalog({
 		fetch: params.fetch ?? fetch,
-		url: XAI_MODELS_URL,
+		url: XAI_LANGUAGE_MODELS_URL,
 		headers: bearerHeaders(token),
 		label: "xAI"
 	});
@@ -1864,56 +2009,73 @@ async function fetchTogetherProviderRefreshSnapshot(params = {}) {
 	return { providers: { [TOGETHER_PROVIDER_BRAND_ID]: { routes: { [TOGETHER_ROUTE_ID]: selectModelSnapshotsByIds(models, ids, TOGETHER_ROUTE_ID) } } } };
 }
 async function fetchOpenRouterProviderRefreshSnapshot(params = {}) {
-	const fetchImpl = params.fetch ?? fetch;
-	const response = await fetchImpl(OPENROUTER_MODELS_URL);
-	if (!response.ok) {
-		throw new Error(`OpenRouter model catalog fetch failed: HTTP ${response.status}`);
-	}
-	const payload = await response.json();
+	const token = readEnv(params.env ?? process.env, ["OPENROUTER_API_KEY"]);
+	const payload = await fetchJsonCatalog({
+		fetch: params.fetch ?? fetch,
+		url: OPENROUTER_MODELS_URL,
+		headers: optionalBearerHeaders(token),
+		label: "OpenRouter"
+	});
 	const models = parseOpenRouterModelSnapshotsFromModelsResponse(payload);
 	const ids = selectOpenRouterModelsForNormalUi(models.map((model) => model.id));
 	return { providers: { [OPENROUTER_PROVIDER_BRAND_ID]: { routes: { [OPENROUTER_ROUTE_ID]: selectModelSnapshotsByIds(models, ids, OPENROUTER_ROUTE_ID) } } } };
 }
 async function fetchVercelAiGatewayProviderRefreshSnapshot(params = {}) {
-	const fetchImpl = params.fetch ?? fetch;
-	const response = await fetchImpl(VERCEL_AI_GATEWAY_MODELS_URL);
-	if (!response.ok) {
-		throw new Error(`Vercel AI Gateway model catalog fetch failed: HTTP ${response.status}`);
-	}
-	const payload = await response.json();
+	const token = readEnv(params.env ?? process.env, ["AI_GATEWAY_API_KEY"]);
+	const payload = await fetchJsonCatalog({
+		fetch: params.fetch ?? fetch,
+		url: VERCEL_AI_GATEWAY_MODELS_URL,
+		headers: optionalBearerHeaders(token),
+		label: "Vercel AI Gateway"
+	});
 	const models = parseOpenRouterModelSnapshotsFromModelsResponse(payload);
 	const ids = selectVercelAiGatewayModelsForNormalUi(models.map((model) => model.id));
 	return { providers: { [VERCEL_AI_GATEWAY_PROVIDER_BRAND_ID]: { routes: { [VERCEL_AI_GATEWAY_ROUTE_ID]: selectModelSnapshotsByIds(models, ids, VERCEL_AI_GATEWAY_ROUTE_ID) } } } };
 }
 async function fetchOpencodeZenProviderRefreshSnapshot(params = {}) {
-	const fetchImpl = params.fetch ?? fetch;
-	const response = await fetchImpl(OPENCODE_ZEN_MODELS_URL);
-	if (!response.ok) {
-		throw new Error(`OpenCode Zen model catalog fetch failed: HTTP ${response.status}`);
-	}
-	const payload = await response.json();
+	const token = readEnv(params.env ?? process.env, ["OPENCODE_API_KEY"]);
+	const payload = await fetchJsonCatalog({
+		fetch: params.fetch ?? fetch,
+		url: OPENCODE_ZEN_MODELS_URL,
+		headers: optionalBearerHeaders(token),
+		label: "OpenCode Zen"
+	});
 	const models = parseOpenRouterModelSnapshotsFromModelsResponse(payload);
 	const ids = selectOpencodeZenModelsForNormalUi(models.map((model) => model.id));
 	return { providers: { [OPENCODE_ZEN_PROVIDER_BRAND_ID]: { routes: { [OPENCODE_ZEN_ROUTE_ID]: selectModelSnapshotsByIds(models, ids, OPENCODE_ZEN_ROUTE_ID) } } } };
 }
 async function fetchHuggingfaceProviderRefreshSnapshot(params = {}) {
-	const fetchImpl = params.fetch ?? fetch;
-	const response = await fetchImpl(HUGGINGFACE_MODELS_URL);
-	if (!response.ok) {
-		throw new Error(`Hugging Face model catalog fetch failed: HTTP ${response.status}`);
+	const token = readEnv(params.env ?? process.env, ["HUGGINGFACE_HUB_TOKEN", "HF_TOKEN"]);
+	if (!token) {
+		return missingProviderRoutes(HUGGINGFACE_PROVIDER_BRAND_ID, { [HUGGINGFACE_ROUTE_ID]: {
+			reason: "credential-missing",
+			detail: "Set HUGGINGFACE_HUB_TOKEN/HF_TOKEN or configure a Hugging Face token profile."
+		} });
 	}
-	const payload = await response.json();
+	const payload = await fetchJsonCatalog({
+		fetch: params.fetch ?? fetch,
+		url: HUGGINGFACE_MODELS_URL,
+		headers: bearerHeaders(token),
+		label: "Hugging Face"
+	});
 	const models = parseHuggingfaceModelSnapshotsFromModelsResponse(payload);
 	const ids = selectHuggingfaceModelsForNormalUi(models.map((model) => model.id));
 	return { providers: { [HUGGINGFACE_PROVIDER_BRAND_ID]: { routes: { [HUGGINGFACE_ROUTE_ID]: selectModelSnapshotsByIds(models, ids, HUGGINGFACE_ROUTE_ID) } } } };
 }
 async function fetchVeniceProviderRefreshSnapshot(params = {}) {
-	const fetchImpl = params.fetch ?? fetch;
-	const response = await fetchImpl(VENICE_MODELS_URL);
-	if (!response.ok) {
-		throw new Error(`Venice AI model catalog fetch failed: HTTP ${response.status}`);
+	const token = readEnv(params.env ?? process.env, ["VENICE_API_KEY"]);
+	if (!token) {
+		return missingProviderRoutes(VENICE_PROVIDER_BRAND_ID, { [VENICE_ROUTE_ID]: {
+			reason: "credential-missing",
+			detail: "Set VENICE_API_KEY or configure a Venice API-key auth profile."
+		} });
 	}
-	const payload = await response.json();
+	const payload = await fetchJsonCatalog({
+		fetch: params.fetch ?? fetch,
+		url: VENICE_MODELS_URL,
+		headers: bearerHeaders(token),
+		label: "Venice AI"
+	});
 	const models = parseVeniceModelSnapshotsFromModelsResponse(payload);
 	const ids = selectVeniceModelsForNormalUi(models.map((model) => model.id));
 	return { providers: { [VENICE_PROVIDER_BRAND_ID]: { routes: { [VENICE_ROUTE_ID]: selectModelSnapshotsByIds(models, ids, VENICE_ROUTE_ID) } } } };
@@ -1924,6 +2086,67 @@ function fetchStaticUnsupportedProviderRefreshSnapshot() {
 		detail: "Direct GitHub Copilot model catalog probing is not implemented; configure Copilot Proxy for a probeable /models route."
 	} })]);
 }
+function providerRefreshFetcherForBrand(brandId) {
+	switch (brandId) {
+		case OPENAI_PROVIDER_BRAND_ID: return fetchOpenAIProviderRefreshSnapshot;
+		case CHUTES_PROVIDER_BRAND_ID: return fetchChutesProviderRefreshSnapshot;
+		case ANTHROPIC_PROVIDER_BRAND_ID: return fetchAnthropicProviderRefreshSnapshot;
+		case GOOGLE_PROVIDER_BRAND_ID: return fetchGoogleGeminiProviderRefreshSnapshot;
+		case XAI_PROVIDER_BRAND_ID: return fetchXaiProviderRefreshSnapshot;
+		case MISTRAL_PROVIDER_BRAND_ID: return fetchMistralProviderRefreshSnapshot;
+		case VOLCENGINE_PROVIDER_BRAND_ID: return fetchVolcengineProviderRefreshSnapshot;
+		case BYTEPLUS_PROVIDER_BRAND_ID: return fetchBytePlusProviderRefreshSnapshot;
+		case MINIMAX_PROVIDER_BRAND_ID: return fetchMinimaxProviderRefreshSnapshot;
+		case MOONSHOT_PROVIDER_BRAND_ID: return fetchMoonshotProviderRefreshSnapshot;
+		case QWEN_PROVIDER_BRAND_ID: return fetchQwenProviderRefreshSnapshot;
+		case COPILOT_PROVIDER_BRAND_ID: return fetchCopilotProviderRefreshSnapshot;
+		case XIAOMI_PROVIDER_BRAND_ID: return fetchXiaomiProviderRefreshSnapshot;
+		case SYNTHETIC_PROVIDER_BRAND_ID: return fetchSyntheticProviderRefreshSnapshot;
+		case TOGETHER_PROVIDER_BRAND_ID: return fetchTogetherProviderRefreshSnapshot;
+		case OPENROUTER_PROVIDER_BRAND_ID: return fetchOpenRouterProviderRefreshSnapshot;
+		case ZAI_PROVIDER_BRAND_ID: return fetchZaiProviderRefreshSnapshot;
+		case QIANFAN_PROVIDER_BRAND_ID: return fetchQianfanProviderRefreshSnapshot;
+		case VERCEL_AI_GATEWAY_PROVIDER_BRAND_ID: return fetchVercelAiGatewayProviderRefreshSnapshot;
+		case OPENCODE_ZEN_PROVIDER_BRAND_ID: return fetchOpencodeZenProviderRefreshSnapshot;
+		case OLLAMA_PROVIDER_BRAND_ID: return fetchOllamaProviderRefreshSnapshot;
+		case LMSTUDIO_PROVIDER_BRAND_ID: return fetchLmStudioProviderRefreshSnapshot;
+		case VLLM_PROVIDER_BRAND_ID: return fetchVllmProviderRefreshSnapshot;
+		case LITELLM_PROVIDER_BRAND_ID: return fetchLitellmProviderRefreshSnapshot;
+		case CLOUDFLARE_AI_GATEWAY_PROVIDER_BRAND_ID: return fetchCloudflareAiGatewayProviderRefreshSnapshot;
+		case CUSTOM_PROVIDER_BRAND_ID: return fetchCustomProviderRefreshSnapshot;
+		case HUGGINGFACE_PROVIDER_BRAND_ID: return fetchHuggingfaceProviderRefreshSnapshot;
+		case VENICE_PROVIDER_BRAND_ID: return fetchVeniceProviderRefreshSnapshot;
+		default: return undefined;
+	}
+}
+function listProviderRefreshContractGaps(manifests = listProviderBrandManifests()) {
+	return manifests.flatMap((manifest) => providerRefreshFetcherForBrand(manifest.id) ? [] : [`${manifest.id}: no authenticated or operator catalog fetcher`]);
+}
+async function fetchProviderRefreshSnapshotForRoutes(params) {
+	return await providerCatalogView.run("available", async () => {
+		const requestedRoutes = new Set([...params.routes].map((route) => route.trim().toLowerCase()).filter(Boolean));
+		const fetchers = new Set();
+		for (const manifest of listProviderBrandManifests()) {
+			const routes = new Set([
+				...manifest.methods.map((method) => method.route.trim().toLowerCase()),
+				...(manifest.modelProviderIds ?? []).map((route) => route.trim().toLowerCase()),
+				...(manifest.routeAliases ?? []).map((route) => route.trim().toLowerCase())
+			]);
+			if (![...routes].some((route) => requestedRoutes.has(route))) {
+				continue;
+			}
+			const fetcher = providerRefreshFetcherForBrand(manifest.id);
+			if (fetcher) {
+				fetchers.add(fetcher);
+			}
+		}
+		const results = await Promise.allSettled([...fetchers].map((fetcher) => fetcher({
+			fetch: params.fetch,
+			env: params.env
+		})));
+		return mergeProviderRefreshSnapshots(results.flatMap((result) => result.status === "fulfilled" ? [result.value] : []));
+	});
+}
 function mergeProviderRefreshSnapshots(snapshots) {
 	const providers = {};
 	for (const snapshot of snapshots) {
@@ -1948,8 +2171,14 @@ function mergeProviderRefreshSnapshots(snapshots) {
 async function fetchOfficialProviderRefreshSnapshot(params = {}) {
 	const fetchImpl = params.fetch ?? fetch;
 	const [openai, chutes, anthropic, google, xai, mistral, volcengine, byteplus, minimax, moonshot, qwen, copilot, xiaomi, synthetic, together, openrouter, zai, qianfan, vercelAiGateway, opencodeZen, ollama, lmstudio, vllm, litellm, cloudflareAiGateway, custom, huggingface, venice, staticUnsupported] = await Promise.all([
-		fetchOpenAIProviderRefreshSnapshot({ fetch: fetchImpl }),
-		fetchChutesProviderRefreshSnapshot({ fetch: fetchImpl }),
+		fetchOpenAIProviderRefreshSnapshot({
+			fetch: fetchImpl,
+			env: params.env
+		}),
+		fetchChutesProviderRefreshSnapshot({
+			fetch: fetchImpl,
+			env: params.env
+		}),
 		fetchAnthropicProviderRefreshSnapshot({
 			fetch: fetchImpl,
 			env: params.env
@@ -2002,7 +2231,10 @@ async function fetchOfficialProviderRefreshSnapshot(params = {}) {
 			fetch: fetchImpl,
 			env: params.env
 		}),
-		fetchOpenRouterProviderRefreshSnapshot({ fetch: fetchImpl }),
+		fetchOpenRouterProviderRefreshSnapshot({
+			fetch: fetchImpl,
+			env: params.env
+		}),
 		fetchZaiProviderRefreshSnapshot({
 			fetch: fetchImpl,
 			env: params.env
@@ -2011,8 +2243,14 @@ async function fetchOfficialProviderRefreshSnapshot(params = {}) {
 			fetch: fetchImpl,
 			env: params.env
 		}),
-		fetchVercelAiGatewayProviderRefreshSnapshot({ fetch: fetchImpl }),
-		fetchOpencodeZenProviderRefreshSnapshot({ fetch: fetchImpl }),
+		fetchVercelAiGatewayProviderRefreshSnapshot({
+			fetch: fetchImpl,
+			env: params.env
+		}),
+		fetchOpencodeZenProviderRefreshSnapshot({
+			fetch: fetchImpl,
+			env: params.env
+		}),
 		fetchOllamaProviderRefreshSnapshot({
 			fetch: fetchImpl,
 			env: params.env
@@ -2037,8 +2275,14 @@ async function fetchOfficialProviderRefreshSnapshot(params = {}) {
 			fetch: fetchImpl,
 			env: params.env
 		}),
-		fetchHuggingfaceProviderRefreshSnapshot({ fetch: fetchImpl }),
-		fetchVeniceProviderRefreshSnapshot({ fetch: fetchImpl }),
+		fetchHuggingfaceProviderRefreshSnapshot({
+			fetch: fetchImpl,
+			env: params.env
+		}),
+		fetchVeniceProviderRefreshSnapshot({
+			fetch: fetchImpl,
+			env: params.env
+		}),
 		Promise.resolve(fetchStaticUnsupportedProviderRefreshSnapshot())
 	]);
 	return mergeProviderRefreshSnapshots([
@@ -2075,4 +2319,4 @@ async function fetchOfficialProviderRefreshSnapshot(params = {}) {
 }
 
 //#endregion
-export { applyProviderRefreshToRegistrySource, buildProviderCapabilityOverridesSource, buildProviderRefreshEnvFromCredentials, buildProviderRefreshReport, buildProviderRegistryReviewPatch, fetchOfficialProviderRefreshSnapshot, loadProviderRefreshSnapshotFromFile };
+export { applyProviderRefreshToRegistrySource, buildProviderCapabilityOverridesSource, buildProviderRefreshEnvFromCredentials, buildProviderRefreshReport, buildProviderRegistryReviewPatch, fetchOfficialProviderRefreshSnapshot, fetchProviderRefreshSnapshotForRoutes, loadProviderRefreshSnapshotFromFile, parseGenericModelSnapshotsFromModelsResponse };