march-cli 0.1.21 → 0.1.23

package/src/provider/custom-provider.mjs

@@ -1,113 +1,113 @@
-const CUSTOM_PROVIDER_TYPE = "openai-compatible";
-const DEFAULT_API = "openai-completions";
-const SUPPORTED_APIS = new Set(["openai-completions", "openai-responses"]);
-const DEFAULT_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
-
-export function registerCustomProviders(modelRegistry, providers = {}) {
-  if (!modelRegistry?.registerProvider) return [];
-  const registered = [];
-
-  for (const [providerId, profile] of Object.entries(providers ?? {})) {
-    if (!isCustomProviderProfile(profile)) continue;
-    modelRegistry.registerProvider(providerId, toProviderConfig(providerId, profile));
-    registered.push(providerId);
-  }
-
-  return registered;
-}
-
-export function isCustomProviderProfile(profile) {
-  return Boolean(profile && typeof profile === "object" && profile.type === CUSTOM_PROVIDER_TYPE);
-}
-
-function toProviderConfig(providerId, profile) {
-  const api = normalizeApi(providerId, profile.api ?? DEFAULT_API);
-  const baseUrl = requireString(providerId, "baseUrl", profile.baseUrl);
-  const models = normalizeModels(providerId, profile.models, { api, baseUrl });
-  return omitUndefined({
-    name: typeof profile.name === "string" && profile.name.trim() ? profile.name : providerId,
-    baseUrl,
-    apiKey: profile.auth?.method === "apiKey" ? profile.auth.apiKey : undefined,
-    api,
-    headers: normalizeHeaders(providerId, profile.headers),
-    authHeader: typeof profile.authHeader === "boolean" ? profile.authHeader : undefined,
-    models,
-  });
-}
-
-function normalizeModels(providerId, models, { api, baseUrl }) {
-  if (!Array.isArray(models) || models.length === 0) {
-    throw new Error(`Custom provider "${providerId}" requires a non-empty models array`);
-  }
-
-  return models.map((model, index) => {
-    if (!model || typeof model !== "object" || Array.isArray(model)) {
-      throw new Error(`Custom provider "${providerId}" model #${index + 1} must be an object`);
-    }
-    const id = requireString(providerId, `models[${index}].id`, model.id);
-    return omitUndefined({
-      ...model,
-      id,
-      name: typeof model.name === "string" && model.name.trim() ? model.name : id,
-      api: normalizeApi(providerId, model.api ?? api),
-      baseUrl: typeof model.baseUrl === "string" && model.baseUrl.trim() ? model.baseUrl : baseUrl,
-      reasoning: typeof model.reasoning === "boolean" ? model.reasoning : false,
-      input: normalizeInput(model.input, model.capabilities),
-      cost: normalizeCost(model.cost),
-      contextWindow: normalizePositiveNumber(model.contextWindow, 128000),
-      maxTokens: normalizePositiveNumber(model.maxTokens, 4096),
-      headers: normalizeHeaders(providerId, model.headers),
-    });
-  });
-}
-
-function normalizeApi(providerId, api) {
-  if (typeof api !== "string" || !SUPPORTED_APIS.has(api)) {
-    throw new Error(`Custom provider "${providerId}" api must be "openai-completions" or "openai-responses"`);
-  }
-  return api;
-}
-
-function requireString(providerId, field, value) {
-  if (typeof value !== "string" || !value.trim()) {
-    throw new Error(`Custom provider "${providerId}" requires ${field}`);
-  }
-  return value;
-}
-
-function normalizeInput(input, capabilities = null) {
-  const normalized = Array.isArray(input) ? input.filter((item) => item === "text" || item === "image") : [];
-  if ((capabilities?.images === true || capabilities?.vision === true) && !normalized.includes("image")) normalized.push("image");
-  if (!normalized.includes("text")) normalized.unshift("text");
-  return normalized.length > 0 ? normalized : ["text"];
-}
-
-function normalizeCost(cost) {
-  if (!cost || typeof cost !== "object" || Array.isArray(cost)) return DEFAULT_COST;
-  return {
-    input: normalizeNumber(cost.input, 0),
-    output: normalizeNumber(cost.output, 0),
-    cacheRead: normalizeNumber(cost.cacheRead, 0),
-    cacheWrite: normalizeNumber(cost.cacheWrite, 0),
-  };
-}
-
-function normalizeHeaders(providerId, headers) {
-  if (headers == null) return undefined;
-  if (typeof headers !== "object" || Array.isArray(headers)) {
-    throw new Error(`Custom provider "${providerId}" headers must be an object`);
-  }
-  return Object.fromEntries(Object.entries(headers).filter(([, value]) => typeof value === "string"));
-}
-
-function normalizePositiveNumber(value, fallback) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
-}
-
-function normalizeNumber(value, fallback) {
-  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
-}
-
-function omitUndefined(value) {
-  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
-}
+const CUSTOM_PROVIDER_TYPE = "openai-compatible";
+const DEFAULT_API = "openai-completions";
+const SUPPORTED_APIS = new Set(["openai-completions", "openai-responses"]);
+const DEFAULT_COST = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+
+export function registerCustomProviders(modelRegistry, providers = {}) {
+  if (!modelRegistry?.registerProvider) return [];
+  const registered = [];
+
+  for (const [providerId, profile] of Object.entries(providers ?? {})) {
+    if (!isCustomProviderProfile(profile)) continue;
+    modelRegistry.registerProvider(providerId, toProviderConfig(providerId, profile));
+    registered.push(providerId);
+  }
+
+  return registered;
+}
+
+export function isCustomProviderProfile(profile) {
+  return Boolean(profile && typeof profile === "object" && profile.type === CUSTOM_PROVIDER_TYPE);
+}
+
+function toProviderConfig(providerId, profile) {
+  const api = normalizeApi(providerId, profile.api ?? DEFAULT_API);
+  const baseUrl = requireString(providerId, "baseUrl", profile.baseUrl);
+  const models = normalizeModels(providerId, profile.models, { api, baseUrl });
+  return omitUndefined({
+    name: typeof profile.name === "string" && profile.name.trim() ? profile.name : providerId,
+    baseUrl,
+    apiKey: profile.auth?.method === "apiKey" ? profile.auth.apiKey : undefined,
+    api,
+    headers: normalizeHeaders(providerId, profile.headers),
+    authHeader: typeof profile.authHeader === "boolean" ? profile.authHeader : undefined,
+    models,
+  });
+}
+
+function normalizeModels(providerId, models, { api, baseUrl }) {
+  if (!Array.isArray(models) || models.length === 0) {
+    throw new Error(`Custom provider "${providerId}" requires a non-empty models array`);
+  }
+
+  return models.map((model, index) => {
+    if (!model || typeof model !== "object" || Array.isArray(model)) {
+      throw new Error(`Custom provider "${providerId}" model #${index + 1} must be an object`);
+    }
+    const id = requireString(providerId, `models[${index}].id`, model.id);
+    return omitUndefined({
+      ...model,
+      id,
+      name: typeof model.name === "string" && model.name.trim() ? model.name : id,
+      api: normalizeApi(providerId, model.api ?? api),
+      baseUrl: typeof model.baseUrl === "string" && model.baseUrl.trim() ? model.baseUrl : baseUrl,
+      reasoning: typeof model.reasoning === "boolean" ? model.reasoning : false,
+      input: normalizeInput(model.input, model.capabilities),
+      cost: normalizeCost(model.cost),
+      contextWindow: normalizePositiveNumber(model.contextWindow, 128000),
+      maxTokens: normalizePositiveNumber(model.maxTokens, 4096),
+      headers: normalizeHeaders(providerId, model.headers),
+    });
+  });
+}
+
+function normalizeApi(providerId, api) {
+  if (typeof api !== "string" || !SUPPORTED_APIS.has(api)) {
+    throw new Error(`Custom provider "${providerId}" api must be "openai-completions" or "openai-responses"`);
+  }
+  return api;
+}
+
+function requireString(providerId, field, value) {
+  if (typeof value !== "string" || !value.trim()) {
+    throw new Error(`Custom provider "${providerId}" requires ${field}`);
+  }
+  return value;
+}
+
+function normalizeInput(input, capabilities = null) {
+  const normalized = Array.isArray(input) ? input.filter((item) => item === "text" || item === "image") : [];
+  if ((capabilities?.images === true || capabilities?.vision === true) && !normalized.includes("image")) normalized.push("image");
+  if (!normalized.includes("text")) normalized.unshift("text");
+  return normalized.length > 0 ? normalized : ["text"];
+}
+
+function normalizeCost(cost) {
+  if (!cost || typeof cost !== "object" || Array.isArray(cost)) return DEFAULT_COST;
+  return {
+    input: normalizeNumber(cost.input, 0),
+    output: normalizeNumber(cost.output, 0),
+    cacheRead: normalizeNumber(cost.cacheRead, 0),
+    cacheWrite: normalizeNumber(cost.cacheWrite, 0),
+  };
+}
+
+function normalizeHeaders(providerId, headers) {
+  if (headers == null) return undefined;
+  if (typeof headers !== "object" || Array.isArray(headers)) {
+    throw new Error(`Custom provider "${providerId}" headers must be an object`);
+  }
+  return Object.fromEntries(Object.entries(headers).filter(([, value]) => typeof value === "string"));
+}
+
+function normalizePositiveNumber(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+
+function normalizeNumber(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+
+function omitUndefined(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+}

package/src/provider/hosted-tools.mjs

@@ -1,111 +1,111 @@
-const OPENAI_PROVIDERS = new Set(["openai"]);
-const OPENAI_CODEX_PROVIDERS = new Set(["openai-codex"]);
-const AZURE_OPENAI_PROVIDERS = new Set(["azure-openai-responses"]);
-const ANTHROPIC_PROVIDERS = new Set(["anthropic"]);
-const GOOGLE_PROVIDERS = new Set(["google", "google-vertex"]);
-const XAI_PROVIDERS = new Set(["xai", "supergrok-oauth", "xai-oauth"]);
-
-export function injectHostedTools(payload, model, config = {}) {
-  const capabilities = resolveHostedToolCapabilities(model).filter((tool) => isToolEnabled(tool, config));
-  if (capabilities.length === 0) return payload;
-  return injectPayloadHostedTools(payload, capabilities);
-}
-
-export function resolveHostedTools(model, config = {}) {
-  return resolveHostedToolCapabilities(model).filter((tool) => isToolEnabled(tool, config)).map(createHostedTool);
-}
-
-export function resolveHostedToolCapabilities(model) {
-  if (!model || typeof model !== "object") return [];
-  if (OPENAI_PROVIDERS.has(model.provider) && isOpenAiResponsesApi(model.api)) return ["openai.webSearch"];
-  if (OPENAI_CODEX_PROVIDERS.has(model.provider) && model.api === "openai-codex-responses") {
-    return ["openaiCodex.webSearch"];
-  }
-  if (AZURE_OPENAI_PROVIDERS.has(model.provider) && model.api === "azure-openai-responses") {
-    return ["azureOpenai.webSearch"];
-  }
-  if (ANTHROPIC_PROVIDERS.has(model.provider) && model.api === "anthropic-messages") return ["anthropic.webSearch"];
-  if (GOOGLE_PROVIDERS.has(model.provider) && isGoogleApi(model.api)) return ["google.webSearch"];
-  if (XAI_PROVIDERS.has(model.provider) && model.api === "openai-responses") return ["xai.webSearch", "xai.xSearch"];
-  return [];
-}
-
-function isToolEnabled(tool, config) {
-  const [provider, name] = tool.split(".");
-  const value = config?.[provider]?.[name] ?? "auto";
-  return value !== false;
-}
-
-function createHostedTool(tool) {
-  if (tool === "openai.webSearch" || tool === "azureOpenai.webSearch") return { type: "web_search_preview" };
-  if (tool === "openaiCodex.webSearch") return { type: "web_search" };
-  if (tool === "anthropic.webSearch") return { type: "web_search_20250305", name: "web_search" };
-  if (tool === "google.webSearch") return { googleSearch: {} };
-  if (tool === "xai.webSearch") return { type: "web_search", enable_image_understanding: true };
-  if (tool === "xai.xSearch") {
-    return { type: "x_search", enable_image_understanding: true, enable_video_understanding: true };
-  }
-  throw new Error(`Unsupported hosted tool capability: ${tool}`);
-}
-
-function isOpenAiResponsesApi(api) {
-  return api === "openai-responses";
-}
-
-function isGoogleApi(api) {
-  return api === "google-generative-ai" || api === "google-vertex";
-}
-
-function injectPayloadHostedTools(payload, capabilities) {
-  if (!payload || typeof payload !== "object") return payload;
-  if (payload.body && typeof payload.body === "object") {
-    return { ...payload, body: injectPayloadHostedTools(payload.body, capabilities) };
-  }
-  if (typeof payload.body === "string") return injectStringBodyHostedTools(payload, capabilities);
-  return capabilities.reduce((next, capability) => injectPayloadHostedTool(next, capability), payload);
-}
-
-function injectPayloadHostedTool(payload, capability) {
-  if (capability.startsWith("google.")) return appendGoogleTool(payload, createHostedTool(capability));
-  return appendTopLevelTool(payload, createHostedTool(capability));
-}
-
-function injectStringBodyHostedTools(payload, capabilities) {
-  try {
-    const body = JSON.parse(payload.body);
-    return { ...payload, body: JSON.stringify(injectPayloadHostedTools(body, capabilities)) };
-  } catch {
-    return payload;
-  }
-}
-
-function appendTopLevelTool(payload, tool) {
-  if (!Array.isArray(payload.tools)) return { ...payload, tools: [tool] };
-  return { ...payload, tools: mergeTools(payload.tools, [tool], getToolKey) };
-}
-
-function appendGoogleTool(payload, tool) {
-  const config = payload.config && typeof payload.config === "object" ? payload.config : {};
-  const tools = Array.isArray(config.tools) ? config.tools : [];
-  return {
-    ...payload,
-    config: {
-      ...config,
-      tools: mergeTools(tools, [tool], getGoogleToolKey),
-    },
-  };
-}
-
-function mergeTools(existing, added, keyForTool) {
-  const keys = new Set(existing.map(keyForTool).filter(Boolean));
-  return [...existing, ...added.filter((tool) => !keys.has(keyForTool(tool)))];
-}
-
-function getToolKey(tool) {
-  return tool?.type ?? tool?.name;
-}
-
-function getGoogleToolKey(tool) {
-  if (tool?.googleSearch) return "googleSearch";
-  return tool?.functionDeclarations ? "functionDeclarations" : getToolKey(tool);
-}
+const OPENAI_PROVIDERS = new Set(["openai"]);
+const OPENAI_CODEX_PROVIDERS = new Set(["openai-codex"]);
+const AZURE_OPENAI_PROVIDERS = new Set(["azure-openai-responses"]);
+const ANTHROPIC_PROVIDERS = new Set(["anthropic"]);
+const GOOGLE_PROVIDERS = new Set(["google", "google-vertex"]);
+const XAI_PROVIDERS = new Set(["xai", "supergrok-oauth", "xai-oauth"]);
+
+export function injectHostedTools(payload, model, config = {}) {
+  const capabilities = resolveHostedToolCapabilities(model).filter((tool) => isToolEnabled(tool, config));
+  if (capabilities.length === 0) return payload;
+  return injectPayloadHostedTools(payload, capabilities);
+}
+
+export function resolveHostedTools(model, config = {}) {
+  return resolveHostedToolCapabilities(model).filter((tool) => isToolEnabled(tool, config)).map(createHostedTool);
+}
+
+export function resolveHostedToolCapabilities(model) {
+  if (!model || typeof model !== "object") return [];
+  if (OPENAI_PROVIDERS.has(model.provider) && isOpenAiResponsesApi(model.api)) return ["openai.webSearch"];
+  if (OPENAI_CODEX_PROVIDERS.has(model.provider) && model.api === "openai-codex-responses") {
+    return ["openaiCodex.webSearch"];
+  }
+  if (AZURE_OPENAI_PROVIDERS.has(model.provider) && model.api === "azure-openai-responses") {
+    return ["azureOpenai.webSearch"];
+  }
+  if (ANTHROPIC_PROVIDERS.has(model.provider) && model.api === "anthropic-messages") return ["anthropic.webSearch"];
+  if (GOOGLE_PROVIDERS.has(model.provider) && isGoogleApi(model.api)) return ["google.webSearch"];
+  if (XAI_PROVIDERS.has(model.provider) && model.api === "openai-responses") return ["xai.webSearch", "xai.xSearch"];
+  return [];
+}
+
+function isToolEnabled(tool, config) {
+  const [provider, name] = tool.split(".");
+  const value = config?.[provider]?.[name] ?? "auto";
+  return value !== false;
+}
+
+function createHostedTool(tool) {
+  if (tool === "openai.webSearch" || tool === "azureOpenai.webSearch") return { type: "web_search_preview" };
+  if (tool === "openaiCodex.webSearch") return { type: "web_search" };
+  if (tool === "anthropic.webSearch") return { type: "web_search_20250305", name: "web_search" };
+  if (tool === "google.webSearch") return { googleSearch: {} };
+  if (tool === "xai.webSearch") return { type: "web_search", enable_image_understanding: true };
+  if (tool === "xai.xSearch") {
+    return { type: "x_search", enable_image_understanding: true, enable_video_understanding: true };
+  }
+  throw new Error(`Unsupported hosted tool capability: ${tool}`);
+}
+
+function isOpenAiResponsesApi(api) {
+  return api === "openai-responses";
+}
+
+function isGoogleApi(api) {
+  return api === "google-generative-ai" || api === "google-vertex";
+}
+
+function injectPayloadHostedTools(payload, capabilities) {
+  if (!payload || typeof payload !== "object") return payload;
+  if (payload.body && typeof payload.body === "object") {
+    return { ...payload, body: injectPayloadHostedTools(payload.body, capabilities) };
+  }
+  if (typeof payload.body === "string") return injectStringBodyHostedTools(payload, capabilities);
+  return capabilities.reduce((next, capability) => injectPayloadHostedTool(next, capability), payload);
+}
+
+function injectPayloadHostedTool(payload, capability) {
+  if (capability.startsWith("google.")) return appendGoogleTool(payload, createHostedTool(capability));
+  return appendTopLevelTool(payload, createHostedTool(capability));
+}
+
+function injectStringBodyHostedTools(payload, capabilities) {
+  try {
+    const body = JSON.parse(payload.body);
+    return { ...payload, body: JSON.stringify(injectPayloadHostedTools(body, capabilities)) };
+  } catch {
+    return payload;
+  }
+}
+
+function appendTopLevelTool(payload, tool) {
+  if (!Array.isArray(payload.tools)) return { ...payload, tools: [tool] };
+  return { ...payload, tools: mergeTools(payload.tools, [tool], getToolKey) };
+}
+
+function appendGoogleTool(payload, tool) {
+  const config = payload.config && typeof payload.config === "object" ? payload.config : {};
+  const tools = Array.isArray(config.tools) ? config.tools : [];
+  return {
+    ...payload,
+    config: {
+      ...config,
+      tools: mergeTools(tools, [tool], getGoogleToolKey),
+    },
+  };
+}
+
+function mergeTools(existing, added, keyForTool) {
+  const keys = new Set(existing.map(keyForTool).filter(Boolean));
+  return [...existing, ...added.filter((tool) => !keys.has(keyForTool(tool)))];
+}
+
+function getToolKey(tool) {
+  return tool?.type ?? tool?.name;
+}
+
+function getGoogleToolKey(tool) {
+  if (tool?.googleSearch) return "googleSearch";
+  return tool?.functionDeclarations ? "functionDeclarations" : getToolKey(tool);
+}

package/src/provider/presets.mjs

@@ -1,72 +1,72 @@
-import { getProviders } from "@earendil-works/pi-ai";
-import { getOAuthProviders } from "@earendil-works/pi-ai/oauth";
-import { registerSuperGrokOAuthProvider } from "../supergrok/oauth-provider.mjs";
-
-registerSuperGrokOAuthProvider();
-
-const PROVIDER_LABELS = {
-  anthropic: "Anthropic",
-  "amazon-bedrock": "Amazon Bedrock",
-  "azure-openai-responses": "Azure OpenAI Responses",
-  cerebras: "Cerebras",
-  "cloudflare-ai-gateway": "Cloudflare AI Gateway",
-  "cloudflare-workers-ai": "Cloudflare Workers AI",
-  deepseek: "DeepSeek",
-  fireworks: "Fireworks",
-  google: "Google Gemini",
-  "google-vertex": "Google Vertex AI",
-  groq: "Groq",
-  huggingface: "Hugging Face",
-  "kimi-coding": "Kimi For Coding",
-  mistral: "Mistral",
-  minimax: "MiniMax",
-  "minimax-cn": "MiniMax (China)",
-  moonshotai: "Moonshot AI",
-  "moonshotai-cn": "Moonshot AI (China)",
-  opencode: "OpenCode Zen",
-  "opencode-go": "OpenCode Go",
-  openai: "OpenAI",
-  "openai-codex": "OpenAI Codex",
-  openrouter: "OpenRouter",
-  "supergrok-oauth": "SuperGrok",
-  "vercel-ai-gateway": "Vercel AI Gateway",
-  xai: "xAI",
-  "xai-oauth": "xAI OAuth",
-  zai: "ZAI",
-  xiaomi: "Xiaomi MiMo",
-  "xiaomi-token-plan-cn": "Xiaomi MiMo Token Plan (China)",
-  "xiaomi-token-plan-ams": "Xiaomi MiMo Token Plan (Amsterdam)",
-  "xiaomi-token-plan-sgp": "Xiaomi MiMo Token Plan (Singapore)",
-};
-
-export const PROVIDER_PRESETS = buildProviderPresets();
-
-export function buildProviderPresets() {
-  const oauthProviderIds = new Set(getOAuthProviders().map((provider) => provider.id));
-  const ids = new Set([...getProviders(), ...oauthProviderIds]);
-  return [...ids].map((id) => {
-    const label = getProviderLabel(id);
-    return {
-      id,
-      label,
-      type: id,
-      authMethods: getAuthMethods(id, oauthProviderIds),
-      apiKeyLabel: `${label} API key`,
-    };
-  }).sort((a, b) => a.label.localeCompare(b.label));
-}
-
-export function getProviderPreset(id) {
-  return PROVIDER_PRESETS.find((preset) => preset.id === id || preset.type === id) ?? null;
-}
-
-export function getProviderLabel(id) {
-  return PROVIDER_LABELS[id] ?? id;
-}
-
-function getAuthMethods(id, oauthProviderIds) {
-  const methods = [];
-  if (oauthProviderIds.has(id)) methods.push("oauth");
-  methods.push("apiKey");
-  return methods;
-}
+import { getProviders } from "@earendil-works/pi-ai";
+import { getOAuthProviders } from "@earendil-works/pi-ai/oauth";
+import { registerSuperGrokOAuthProvider } from "../supergrok/oauth-provider.mjs";
+
+registerSuperGrokOAuthProvider();
+
+const PROVIDER_LABELS = {
+  anthropic: "Anthropic",
+  "amazon-bedrock": "Amazon Bedrock",
+  "azure-openai-responses": "Azure OpenAI Responses",
+  cerebras: "Cerebras",
+  "cloudflare-ai-gateway": "Cloudflare AI Gateway",
+  "cloudflare-workers-ai": "Cloudflare Workers AI",
+  deepseek: "DeepSeek",
+  fireworks: "Fireworks",
+  google: "Google Gemini",
+  "google-vertex": "Google Vertex AI",
+  groq: "Groq",
+  huggingface: "Hugging Face",
+  "kimi-coding": "Kimi For Coding",
+  mistral: "Mistral",
+  minimax: "MiniMax",
+  "minimax-cn": "MiniMax (China)",
+  moonshotai: "Moonshot AI",
+  "moonshotai-cn": "Moonshot AI (China)",
+  opencode: "OpenCode Zen",
+  "opencode-go": "OpenCode Go",
+  openai: "OpenAI",
+  "openai-codex": "OpenAI Codex",
+  openrouter: "OpenRouter",
+  "supergrok-oauth": "SuperGrok",
+  "vercel-ai-gateway": "Vercel AI Gateway",
+  xai: "xAI",
+  "xai-oauth": "xAI OAuth",
+  zai: "ZAI",
+  xiaomi: "Xiaomi MiMo",
+  "xiaomi-token-plan-cn": "Xiaomi MiMo Token Plan (China)",
+  "xiaomi-token-plan-ams": "Xiaomi MiMo Token Plan (Amsterdam)",
+  "xiaomi-token-plan-sgp": "Xiaomi MiMo Token Plan (Singapore)",
+};
+
+export const PROVIDER_PRESETS = buildProviderPresets();
+
+export function buildProviderPresets() {
+  const oauthProviderIds = new Set(getOAuthProviders().map((provider) => provider.id));
+  const ids = new Set([...getProviders(), ...oauthProviderIds]);
+  return [...ids].map((id) => {
+    const label = getProviderLabel(id);
+    return {
+      id,
+      label,
+      type: id,
+      authMethods: getAuthMethods(id, oauthProviderIds),
+      apiKeyLabel: `${label} API key`,
+    };
+  }).sort((a, b) => a.label.localeCompare(b.label));
+}
+
+export function getProviderPreset(id) {
+  return PROVIDER_PRESETS.find((preset) => preset.id === id || preset.type === id) ?? null;
+}
+
+export function getProviderLabel(id) {
+  return PROVIDER_LABELS[id] ?? id;
+}
+
+function getAuthMethods(id, oauthProviderIds) {
+  const methods = [];
+  if (oauthProviderIds.has(id)) methods.push("oauth");
+  methods.push("apiKey");
+  return methods;
+}