@hasna/switcher 0.1.0 → 0.1.1

package/dist/serve/index.js

@@ -12,8 +12,8 @@ import { dirname, resolve } from "path";
 
 // src/domain.ts
 import { z } from "zod";
-var VERSION = "0.1.0";
-var harnessSchema = z.enum(["claude", "codex", "grok", "opencode2"]);
+var VERSION = "0.1.1";
+var harnessSchema = z.enum(["claude", "codex", "grok", "opencode2", "pi"]);
 var protocolSchema = z.enum(["anthropic-messages", "openai-responses", "openai-chat"]);
 var idSchema = z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$/);
 var label = z.string().min(1).max(200);
@@ -41,6 +41,7 @@ var modelSchema = z.object({
   id: z.string().min(1).max(300),
   name: label,
   description: z.string().max(8000).optional(),
+  available: z.boolean().optional(),
   contextWindow: z.number().int().positive().optional(),
   maxOutputTokens: z.number().int().positive().optional(),
   inputModalities: z.array(z.string().max(50)).max(20).optional(),
@@ -54,9 +55,32 @@ var providerInputSchema = z.object({
   protocol: protocolSchema,
   credentialEnv: envRef.optional(),
   authStyle: z.enum(["bearer", "x-api-key"]).default("bearer"),
+  catalogBaseUrl: urlSchema.optional(),
+  catalogFormat: z.enum(["openai", "ollama", "mistral", "together", "fireworks", "dashscope", "none"]).optional(),
+  catalogAuthStyle: z.enum(["bearer", "x-api-key", "none"]).optional(),
+  catalogCredentialEnv: envRef.optional(),
+  catalogAccountId: z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/).optional(),
   modelsPath: z.string().regex(/^[a-zA-Z0-9_/-]+$/).max(200).default("models"),
   manualModels: z.array(modelSchema).max(1e4).default([])
 }).strict().refine((p) => !p.modelsPath.split("/").includes("..") && !p.modelsPath.startsWith("/"), "modelsPath must be relative");
+var providerPresetSchema = z.object({
+  id: idSchema,
+  name: label,
+  credentialEnv: envRef.optional(),
+  credentialAliases: z.array(z.string().regex(/^[A-Z][A-Z0-9_]+$/)),
+  protocols: z.array(z.object({
+    protocol: protocolSchema,
+    baseUrl: urlSchema.optional(),
+    authStyle: z.enum(["bearer", "x-api-key"]),
+    catalogBaseUrl: urlSchema.optional(),
+    catalogFormat: z.enum(["openai", "ollama", "mistral", "together", "fireworks", "dashscope", "none"]),
+    catalogAuthStyle: z.enum(["bearer", "x-api-key", "none"]).optional(),
+    modelsPath: z.string(),
+    notes: z.array(z.string())
+  }).strict()).min(1),
+  sources: z.array(z.string().url()),
+  verification: z.literal("documented")
+}).strict();
 var profileInputSchema = z.object({
   id: idSchema,
   name: label,
@@ -94,7 +118,7 @@ function compatible(harness, protocol) {
   return harness === "claude" ? protocol === "anthropic-messages" : harness === "codex" ? protocol === "openai-responses" : true;
 }
 function codingEligible(model) {
-  return (!model.outputModalities || model.outputModalities.includes("text")) && (!model.supportedParameters || model.supportedParameters.includes("tools"));
+  return model.available !== false && (!model.outputModalities || model.outputModalities.includes("text")) && (!model.supportedParameters || model.supportedParameters.includes("tools"));
 }
 
 // src/store.ts
@@ -116,33 +140,37 @@ class Store {
   static async open(config) {
     if (!!config.databaseUrl === !!config.sqlitePath)
       throw new Fault(500, "storage_config", "Choose exactly one PostgreSQL URL or SQLite path.");
-    let sql;
-    let engine;
-    if (config.databaseUrl) {
-      if (!/^postgres(ql)?:\/\//.test(config.databaseUrl))
-        throw new Fault(500, "storage_config", "Database URL must use PostgreSQL.");
-      sql = new SQL(config.databaseUrl);
-      engine = "postgresql";
-    } else {
-      const file = config.sqlitePath;
-      if (file !== ":memory:")
-        await mkdir(dirname(resolve(file)), { recursive: true, mode: 448 });
-      sql = new SQL({ adapter: "sqlite", filename: file });
-      engine = "sqlite";
-      await sql.unsafe("PRAGMA foreign_keys = ON");
-      await sql.unsafe("PRAGMA busy_timeout = 5000");
-      await sql.unsafe("PRAGMA journal_mode = WAL");
-      if (file !== ":memory:")
-        await chmod(file, 384);
-    }
-    const store = new Store(sql, engine);
-    try {
-      await store.migrate();
-    } catch {
-      await sql.close();
-      throw new Fault(500, "storage_unavailable", "Database migration failed; check server database configuration.");
+    const engine = config.databaseUrl ? "postgresql" : "sqlite";
+    if (config.databaseUrl && !/^postgres(ql)?:\/\//.test(config.databaseUrl))
+      throw new Fault(500, "storage_config", "Database URL must use PostgreSQL.");
+    const file = config.sqlitePath;
+    if (engine === "sqlite" && file !== ":memory:")
+      await mkdir(dirname(resolve(file)), { recursive: true, mode: 448 });
+    const deadline = Date.now() + 1e4;
+    for (let attempt = 0;; attempt++) {
+      let sql;
+      try {
+        sql = engine === "postgresql" ? new SQL(config.databaseUrl) : new SQL({ adapter: "sqlite", filename: file });
+        if (engine === "sqlite") {
+          await sql.unsafe("PRAGMA busy_timeout = 5000");
+          await sql.unsafe("PRAGMA foreign_keys = ON");
+          await sql.unsafe("PRAGMA journal_mode = WAL");
+          if (file !== ":memory:")
+            await chmod(file, 384);
+        }
+        const store = new Store(sql, engine);
+        await store.migrate();
+        return store;
+      } catch (error) {
+        await sql?.close().catch(() => {});
+        const code = error?.code;
+        if (engine === "sqlite" && ["SQLITE_BUSY", "SQLITE_BUSY_SNAPSHOT", "SQLITE_LOCKED"].includes(code ?? "") && Date.now() < deadline) {
+          await new Promise((resolve2) => setTimeout(resolve2, Math.min(200, 20 * (attempt + 1))));
+          continue;
+        }
+        throw new Fault(500, "storage_unavailable", "Database startup failed; check configuration, permissions and other database users.");
+      }
     }
-    return store;
   }
   async migrate() {
     await this.sql.begin(async (tx) => {
@@ -292,24 +320,48 @@ async function boundedJson(response, maxBytes = MAX_BYTES) {
 // src/catalog.ts
 var positive = (v) => typeof v === "number" && Number.isInteger(v) && v > 0 ? v : undefined;
 var strings = (v) => Array.isArray(v) && v.every((i) => typeof i === "string") ? v : undefined;
-async function discover(provider, env = process.env) {
+var modalities = (v) => {
+  if (v === undefined)
+    return;
+  if (!Array.isArray(v) || !v.every((i) => typeof i === "string"))
+    throw new Fault(502, "invalid_catalog", "Provider returned malformed modality metadata.");
+  return v.map((i) => i.toLowerCase());
+};
+async function discover(provider, env = process.env, resolveCredential) {
   const refreshedAt = new Date().toISOString();
   if (provider.manualModels.length)
     return { models: provider.manualModels, source: "manual", refreshedAt };
+  if (provider.catalogFormat === "none")
+    throw new Fault(422, "catalog_unsupported", "This provider has no documented model-list contract; configure manual models or an explicit catalog URL and parser.");
   const headers = { accept: "application/json" };
-  if (provider.credentialEnv) {
-    const credential = env[provider.credentialEnv];
+  if (provider.catalogFormat === "fireworks" && !provider.catalogBaseUrl && !provider.catalogAccountId)
+    throw new Fault(422, "catalog_account_required", "Fireworks model discovery requires a catalog account ID or an explicit catalog URL.");
+  if (provider.catalogFormat === "fireworks" && !provider.catalogBaseUrl && new URL(provider.baseUrl).origin !== "https://api.fireworks.ai")
+    throw new Fault(422, "catalog_url_required", "A custom Fireworks inference authority requires an explicit catalog URL; its deployment prefix cannot be inferred.");
+  const catalogRoot = provider.catalogBaseUrl ?? (provider.catalogFormat === "fireworks" ? `https://api.fireworks.ai/v1/accounts/${encodeURIComponent(provider.catalogAccountId)}` : provider.baseUrl);
+  const url = new URL(`${catalogRoot}/${provider.modelsPath}`);
+  if (provider.catalogFormat === "fireworks")
+    url.searchParams.set("pageSize", "200");
+  const authStyle = provider.catalogAuthStyle ?? provider.authStyle;
+  const credentialEnv = provider.catalogCredentialEnv ?? provider.credentialEnv;
+  if (authStyle !== "none" && credentialEnv) {
+    if (url.origin !== new URL(provider.baseUrl).origin && !provider.catalogCredentialEnv)
+      throw new Fault(422, "catalog_credential_authority", "A different catalog origin requires an explicit catalog credential reference or catalogAuthStyle: none.");
+    const credential = resolveCredential ? await resolveCredential({ ...provider, baseUrl: provider.catalogBaseUrl ?? provider.baseUrl, credentialEnv }) : env[credentialEnv];
     if (!credential)
       throw new Fault(422, "credential_missing", "Provider credential environment variable is not available on the server.");
-    headers[provider.authStyle === "x-api-key" ? "x-api-key" : "authorization"] = provider.authStyle === "x-api-key" ? credential : `Bearer ${credential}`;
+    if (/[\r\n]/.test(credential))
+      throw new Fault(422, "credential_invalid", "Catalog credential contains invalid header characters.");
+    headers[authStyle === "x-api-key" ? "x-api-key" : "authorization"] = authStyle === "x-api-key" ? credential : `Bearer ${credential}`;
   }
-  const url = new URL(`${provider.baseUrl}/${provider.modelsPath}`);
   if (provider.protocol === "anthropic-messages" && url.hostname !== "openrouter.ai")
     headers["anthropic-version"] = "2023-06-01";
   if (url.hostname === "openrouter.ai")
     url.searchParams.set("output_modalities", "all");
   const models = new Map;
   const seenCursors = new Set;
+  const seenPages = new Set([url.href]);
+  let fireworksTotal;
   for (let page = 0;page < 100; page++) {
     let response;
     try {
@@ -322,21 +374,56 @@ async function discover(provider, env = process.env) {
       throw new Fault(502, "provider_rejected", `Provider catalog returned HTTP ${response.status}.`);
     }
     const data = await boundedJson(response);
-    if (!Array.isArray(data.data))
-      throw new Fault(502, "invalid_catalog", "Expected a provider catalog with a data array.");
-    for (const row of data.data) {
-      if (!row || typeof row.id !== "string")
+    if (provider.catalogFormat === "fireworks" && data?.totalSize !== undefined) {
+      if (typeof data.totalSize !== "number" || !Number.isInteger(data.totalSize) || data.totalSize < 0)
+        throw new Fault(502, "invalid_catalog", "Fireworks catalog count metadata is malformed.");
+      if (fireworksTotal !== undefined && fireworksTotal !== data.totalSize)
+        throw new Fault(502, "incomplete_catalog", "Provider catalog count changed during pagination; retry the refresh.");
+      fireworksTotal = data.totalSize;
+    }
+    const rows = provider.catalogFormat === "together" ? data : provider.catalogFormat === "ollama" ? data?.models : provider.catalogFormat === "fireworks" ? data?.models : provider.catalogFormat === "dashscope" ? data?.output?.models : data?.data;
+    if (!Array.isArray(rows))
+      throw new Fault(502, "invalid_catalog", "Expected a provider catalog with a model array matching its configured format.");
+    for (const row of rows) {
+      const id = provider.catalogFormat === "ollama" ? row?.model ?? row?.name : provider.catalogFormat === "fireworks" ? row?.name : provider.catalogFormat === "dashscope" ? row?.model : row?.id;
+      if (typeof id !== "string")
         throw new Fault(502, "invalid_catalog", "Catalog entry is missing a model ID.");
       const candidate = {
-        id: row.id,
-        name: row.name ?? row.display_name ?? row.id,
+        id,
+        name: row.displayName ?? row.name ?? row.display_name ?? id,
+        available: provider.catalogFormat === "mistral" && typeof row.archived === "boolean" ? !row.archived : undefined,
         description: typeof row.description === "string" ? row.description.slice(0, 8000) : undefined,
-        contextWindow: positive(row.context_length ?? row.context_window),
-        maxOutputTokens: positive(row.top_provider?.max_completion_tokens ?? row.max_output_tokens),
-        inputModalities: strings(row.architecture?.input_modalities ?? row.input_modalities),
-        outputModalities: strings(row.architecture?.output_modalities ?? row.output_modalities),
+        contextWindow: positive(row.context_length ?? row.context_window ?? row.contextLength ?? row.model_info?.context_window ?? (provider.catalogFormat === "mistral" ? row.max_context_length : undefined)),
+        maxOutputTokens: positive(row.top_provider?.max_completion_tokens ?? row.max_output_tokens ?? row.model_info?.max_output_tokens),
+        inputModalities: strings(row.architecture?.input_modalities ?? row.input_modalities) ?? modalities(row.inference_metadata?.request_modality),
+        outputModalities: strings(row.architecture?.output_modalities ?? row.output_modalities) ?? modalities(row.inference_metadata?.response_modality),
         supportedParameters: strings(row.supported_parameters)
       };
+      if (provider.catalogFormat === "mistral") {
+        const capabilities = row.capabilities;
+        if (typeof capabilities?.function_calling === "boolean")
+          candidate.supportedParameters = capabilities.function_calling ? ["tools"] : [];
+        if (typeof capabilities?.vision === "boolean")
+          candidate.inputModalities = capabilities.vision ? ["text", "image"] : ["text"];
+        if (typeof capabilities?.completion_chat === "boolean")
+          candidate.outputModalities = capabilities.completion_chat ? ["text"] : [];
+      }
+      if (provider.catalogFormat === "together") {
+        const modalities2 = { chat: ["text"], language: ["text"], code: ["text"], image: ["image"], audio: ["audio"], video: ["video"], embedding: ["embedding"], rerank: ["rerank"], moderation: ["classification"] };
+        candidate.outputModalities = modalities2[row.type];
+      }
+      if (provider.catalogFormat === "fireworks") {
+        if (row.supportsImageInput === true)
+          candidate.inputModalities = ["text", "image"];
+        if (typeof row.supportsTools === "boolean")
+          candidate.supportedParameters = row.supportsTools ? ["tools"] : [];
+      }
+      if (provider.catalogFormat === "dashscope") {
+        if (row.features !== undefined && !Array.isArray(row.features))
+          throw new Fault(502, "invalid_catalog", "DashScope model features metadata is malformed.");
+        if (Array.isArray(row.features))
+          candidate.supportedParameters = row.features.includes("function-calling") ? ["tools"] : [];
+      }
       const parsed = modelSchema.safeParse(candidate);
       if (!parsed.success)
         throw new Fault(502, "invalid_catalog", "Provider returned malformed model metadata.");
@@ -344,8 +431,68 @@ async function discover(provider, env = process.env) {
       if (models.size > 1e4)
         throw new Fault(502, "catalog_too_large", "Catalog exceeds 10,000 models; configure a narrower endpoint.");
     }
-    if (!data.has_more)
+    const next = data.links?.next;
+    if (next !== undefined && next !== null) {
+      if (typeof next !== "string" || !next || next.length > 2000)
+        throw new Fault(502, "invalid_catalog", "Provider returned an invalid catalog continuation link.");
+      let target;
+      try {
+        target = new URL(next, url);
+      } catch {
+        throw new Fault(502, "invalid_catalog", "Provider returned an invalid catalog continuation link.");
+      }
+      if (target.origin !== url.origin || target.pathname !== url.pathname || target.username || target.password || target.hash)
+        throw new Fault(502, "catalog_credential_authority", "Catalog pagination must stay on its original origin and path.");
+      if (url.searchParams.has("output_modalities"))
+        target.searchParams.set("output_modalities", url.searchParams.get("output_modalities"));
+      if (seenPages.has(target.href))
+        throw new Fault(502, "invalid_catalog", "Provider catalog pagination did not advance.");
+      seenPages.add(target.href);
+      url.href = target.href;
+      continue;
+    }
+    if (provider.catalogFormat === "fireworks" && data.nextPageToken !== undefined && data.nextPageToken !== null) {
+      if (typeof data.nextPageToken !== "string" || data.nextPageToken.length > 2000)
+        throw new Fault(502, "invalid_catalog", "Provider catalog pagination did not advance.");
+      if (data.nextPageToken) {
+        if (seenCursors.has(data.nextPageToken))
+          throw new Fault(502, "invalid_catalog", "Provider catalog pagination did not advance.");
+        seenCursors.add(data.nextPageToken);
+        url.searchParams.set("pageToken", data.nextPageToken);
+        url.searchParams.set("pageSize", "200");
+        continue;
+      }
+    }
+    if (provider.catalogFormat === "fireworks") {
+      if (fireworksTotal !== undefined && fireworksTotal !== models.size)
+        throw new Fault(502, "incomplete_catalog", "Provider catalog count does not match the collected models; retry the refresh.");
       return { models: [...models.values()], source: "remote", refreshedAt };
+    }
+    if (provider.catalogFormat === "dashscope") {
+      const output = data.output;
+      const total = output?.total;
+      const pageNo = output?.page_no;
+      const pageSize = output?.page_size;
+      if (typeof total !== "number" || !Number.isInteger(total) || total < 0 || typeof pageNo !== "number" || !Number.isInteger(pageNo) || pageNo < 1 || typeof pageSize !== "number" || !Number.isInteger(pageSize) || pageSize < 1)
+        throw new Fault(502, "invalid_catalog", "DashScope catalog pagination metadata is malformed.");
+      if (models.size < total && pageNo * pageSize < total) {
+        const nextPage = pageNo + 1;
+        if (seenCursors.has(String(nextPage)))
+          throw new Fault(502, "invalid_catalog", "Provider catalog pagination did not advance.");
+        seenCursors.add(String(nextPage));
+        url.searchParams.set("page_no", String(nextPage));
+        url.searchParams.set("page_size", String(pageSize));
+        continue;
+      }
+      if (models.size !== total)
+        throw new Fault(502, "incomplete_catalog", "Provider catalog count does not match the collected models; retry the refresh.");
+      return { models: [...models.values()], source: "remote", refreshedAt };
+    }
+    if (provider.catalogFormat === "together" || !data.has_more) {
+      if (typeof data.total_count === "number" && data.total_count !== models.size)
+        throw new Fault(502, "incomplete_catalog", "Provider catalog count does not match the collected models; retry the refresh.");
+      return { models: [...models.values()], source: "remote", refreshedAt };
+    }
     const cursor = data.last_id;
     if (typeof cursor !== "string" || seenCursors.has(cursor))
       throw new Fault(502, "invalid_catalog", "Provider catalog pagination did not advance.");
@@ -355,12 +502,92 @@ async function discover(provider, env = process.env) {
   }
   throw new Fault(502, "catalog_too_large", "Provider catalog pagination exceeded 100 pages.");
 }
+
+// src/presets.ts
+var route = (protocol, baseUrl, options = {}) => ({
+  protocol,
+  baseUrl,
+  authStyle: "bearer",
+  catalogFormat: "openai",
+  modelsPath: "models",
+  notes: [],
+  ...options
+});
+var preset = (id, name, protocols, sources, alias) => parse(providerPresetSchema, {
+  id,
+  name,
+  protocols,
+  sources,
+  credentialAliases: alias ? [alias] : [],
+  credentialEnv: alias ? `SWITCHER_PROVIDER_${id.toUpperCase().replace(/-/g, "_")}` : undefined,
+  verification: "documented"
+});
+var providerPresets = [
+  preset("deepseek", "DeepSeek", [
+    route("openai-chat", "https://api.deepseek.com", { catalogBaseUrl: "https://api.deepseek.com" }),
+    route("anthropic-messages", "https://api.deepseek.com/anthropic/v1", { catalogBaseUrl: "https://api.deepseek.com" })
+  ], ["https://api-docs.deepseek.com/guides/anthropic_api", "https://api-docs.deepseek.com/api/list-models"], "DEEPSEEK_API_KEY"),
+  preset("openrouter", "OpenRouter", ["openai-chat", "openai-responses", "anthropic-messages"].map((protocol) => route(protocol, "https://openrouter.ai/api/v1", { catalogAuthStyle: "none" })), ["https://openrouter.ai/docs/api/api-reference/models/list-all-models-and-their-properties", "https://openrouter.ai/docs/guides/overview"], "OPENROUTER_API_KEY"),
+  preset("anthropic", "Anthropic", [route("anthropic-messages", "https://api.anthropic.com/v1", { authStyle: "x-api-key" })], ["https://platform.claude.com/docs/en/api/overview", "https://platform.claude.com/docs/en/api/models/list"], "ANTHROPIC_API_KEY"),
+  preset("openai", "OpenAI", [route("openai-responses", "https://api.openai.com/v1"), route("openai-chat", "https://api.openai.com/v1")], ["https://platform.openai.com/docs/api-reference/introduction", "https://platform.openai.com/docs/api-reference/models/list"], "OPENAI_API_KEY"),
+  preset("xai", "xAI", ["openai-chat", "openai-responses", "anthropic-messages"].map((protocol) => route(protocol, "https://api.x.ai/v1")), ["https://api.x.ai/docs/", "https://docs.x.ai/developers/model-capabilities/text/generate-text"], "XAI_API_KEY"),
+  preset("ollama", "Ollama", ["openai-chat", "openai-responses"].map((protocol) => route(protocol, "http://127.0.0.1:11434/v1", {
+    catalogBaseUrl: "http://127.0.0.1:11434",
+    modelsPath: "api/tags",
+    catalogFormat: "ollama",
+    catalogAuthStyle: "none",
+    notes: protocol === "openai-responses" ? ["Requires Ollama 0.13.3 or newer; only stateless Responses are supported."] : []
+  })), ["https://docs.ollama.com/api/openai-compatibility", "https://docs.ollama.com/api/tags"]),
+  preset("lmstudio", "LM Studio", ["openai-chat", "openai-responses", "anthropic-messages"].map((protocol) => route(protocol, "http://127.0.0.1:1234/v1", {
+    notes: ["Server authentication is optional. Use --credential-env when authentication is enabled."]
+  })), ["https://lmstudio.ai/docs/developer/rest"]),
+  preset("vllm", "vLLM (operator endpoint)", [
+    route("openai-chat", undefined, { notes: ["Pass the operator's OpenAI-compatible URL, normally ending in /v1. vLLM exposes Chat Completions at /chat/completions and GET /models under that prefix; configure --credential-env only when the server was started with --api-key or VLLM_API_KEY."] }),
+    route("openai-responses", undefined, { notes: ["Pass the operator's OpenAI-compatible URL, normally ending in /v1. Responses is available for supported text-generation models at /responses; configure --credential-env only when the server was started with --api-key or VLLM_API_KEY."] }),
+    route("anthropic-messages", undefined, { notes: ["Pass the operator's URL, normally ending in /v1. vLLM exposes the Anthropic Messages API at /messages for supported deployments. Chat templates and the configured tool parser determine whether streaming and tool calls work for a served model; configure --credential-env only when the server was started with --api-key or VLLM_API_KEY."] })
+  ], ["https://docs.vllm.ai/en/latest/serving/online_serving/openai_compatible_server/", "https://github.com/vllm-project/vllm/blob/main/docs/serving/online_serving/README.md"]),
+  preset("litellm", "LiteLLM Proxy (operator endpoint)", [
+    route("openai-chat", undefined, { notes: ["Pass the proxy's documented OpenAI-compatible base URL exactly; the official quick start uses the root server URL, while a deployment may add a prefix such as /v1. LiteLLM serves Chat Completions and GET /models relative to that URL; use --credential-env for the proxy's configured master key or other bearer token."] }),
+    route("openai-responses", undefined, { notes: ["Pass the proxy's documented OpenAI-compatible base URL exactly; LiteLLM documents the Responses API under the same proxy root or deployment prefix. Use --credential-env for the proxy's configured master key or other bearer token."] }),
+    route("anthropic-messages", undefined, { notes: ["Pass the complete inference prefix ending in /v1, including any deployment prefix. LiteLLM registers /v1/messages; Switcher appends /messages to the stored prefix and discovers /models there. This is a gateway adapter: streaming and tool behavior depend on the configured upstream model and route, so verify those capabilities independently. Use --credential-env for the proxy's configured master key or other bearer token."] })
+  ], ["https://docs.litellm.ai/", "https://docs.litellm.ai/docs/proxy/quick_start", "https://github.com/BerriAI/litellm/blob/main/litellm/proxy/anthropic_endpoints/endpoints.py"]),
+  preset("groq", "Groq", [route("openai-chat", "https://api.groq.com/openai/v1"), route("openai-responses", "https://api.groq.com/openai/v1", { notes: ["Responses is an upstream beta API."] })], ["https://console.groq.com/docs/api-reference"], "GROQ_API_KEY"),
+  preset("cerebras", "Cerebras", [route("openai-chat", "https://api.cerebras.ai/v1")], ["https://inference-docs.cerebras.ai/api-reference/chat-completions"], "CEREBRAS_API_KEY"),
+  preset("mistral", "Mistral", [route("openai-chat", "https://api.mistral.ai/v1", { catalogFormat: "mistral" })], ["https://docs.mistral.ai/api/endpoint/chat", "https://docs.mistral.ai/api/endpoint/models"], "MISTRAL_API_KEY"),
+  preset("together", "Together AI", [route("openai-chat", "https://api.together.ai/v1", { catalogFormat: "together" })], ["https://docs.together.ai/docs/inference/openai-compatibility", "https://docs.together.ai/reference/models"], "TOGETHER_API_KEY"),
+  preset("fireworks", "Fireworks AI", [
+    route("openai-chat", "https://api.fireworks.ai/inference/v1", { catalogFormat: "fireworks", notes: ["Model discovery uses GET /v1/accounts/{account_id}/models; provide --catalog-account-id or --catalog-url."] }),
+    route("openai-responses", "https://api.fireworks.ai/inference/v1", { catalogFormat: "fireworks", notes: ["Model discovery uses GET /v1/accounts/{account_id}/models; provide --catalog-account-id or --catalog-url."] }),
+    route("anthropic-messages", "https://api.fireworks.ai/inference/v1", { catalogFormat: "fireworks", notes: ["Model discovery uses GET /v1/accounts/{account_id}/models; provide --catalog-account-id or --catalog-url."] })
+  ], ["https://docs.fireworks.ai/getting-started/quickstart", "https://docs.fireworks.ai/tools-sdks/python-client/api-reference", "https://docs.fireworks.ai/api-reference/anthropic-messages", "https://docs.fireworks.ai/api-reference/post-chatcompletions", "https://docs.fireworks.ai/api-reference/list-models"], "FIREWORKS_API_KEY"),
+  preset("moonshot", "Moonshot AI (Kimi)", [route("openai-chat", "https://api.moonshot.ai/v1", { catalogBaseUrl: "https://api.moonshot.ai/v1" })], ["https://platform.kimi.ai/docs/api/chat", "https://platform.kimi.ai/docs/api/list-models"], "MOONSHOT_API_KEY"),
+  preset("dashscope", "Alibaba Cloud Model Studio (Qwen)", [route("openai-chat", "https://dashscope-us.aliyuncs.com/compatible-mode/v1", {
+    catalogFormat: "none",
+    notes: ["Inference keys and endpoints are region/workspace-specific. Model discovery uses GET /api/v1/models on a documented region or workspace catalog URL; pass --catalog-url and --catalog-format dashscope."]
+  })], ["https://help.aliyun.com/en/model-studio/base-url", "https://help.aliyun.com/en/model-studio/compatibility-of-openai-with-dashscope", "https://help.aliyun.com/en/model-studio/list-models"], "DASHSCOPE_API_KEY"),
+  preset("zai", "Z.AI", [route("openai-chat", "https://api.z.ai/api/paas/v4", {
+    catalogFormat: "none",
+    notes: ["The published API reference documents inference endpoints but no model-list endpoint; use manual models or provide an explicit catalog URL and parser."]
+  })], ["https://docs.z.ai/api-reference/introduction", "https://docs.z.ai/devpack/quick-start"], "ZAI_API_KEY"),
+  preset("minimax", "MiniMax", [
+    route("openai-chat", "https://api.minimax.cn/v1", { catalogBaseUrl: "https://api.minimax.cn/v1", notes: ["The Open Platform contract uses api.minimax.cn and Bearer auth. Token Plan documentation uses api.minimaxi.com; select that authority explicitly with --url and matching auth/credential settings."] }),
+    route("anthropic-messages", "https://api.minimax.cn/anthropic/v1", { authStyle: "x-api-key", catalogBaseUrl: "https://api.minimax.cn/anthropic/v1", catalogAuthStyle: "x-api-key", notes: ["The Open Platform contract uses api.minimax.cn/anthropic/v1 and X-Api-Key. Token Plan documentation uses api.minimaxi.com/anthropic; select that authority explicitly with --url and matching auth/credential settings."] })
+  ], ["https://platform.minimaxi.com/docs/api-reference/text-chat-anthropic", "https://platform.minimaxi.com/docs/api-reference/models/anthropic/list-models", "https://platform.minimaxi.com/docs/api-reference/models/openai/list-models", "https://platform.minimaxi.com/docs/token-plan/other-tools"], "MINIMAX_API_KEY"),
+  preset("siliconflow", "SiliconFlow", [route("openai-chat", "https://api.siliconflow.cn/v1", { catalogBaseUrl: "https://api.siliconflow.cn/v1", catalogFormat: "openai", notes: ["The official SiliconCloud OpenAPI contract defines GET /models with Bearer auth and data[] model rows; optional type and sub_type filters are available at the upstream endpoint."] })], ["https://github.com/siliconflow/siliconcloud/blob/main/openapi.yaml", "https://docs.siliconflow.cn/docs/userguide/quickstart", "https://docs.siliconflow.cn/docs/api/chat-completions-post"], "SILICONFLOW_API_KEY"),
+  ...["anthropic-messages", "openai-responses", "openai-chat"].map((protocol) => preset(`generic-${protocol}`, `Custom ${protocol}`, [route(protocol)], []))
+];
+function getProviderPreset(id) {
+  const entry = providerPresets.find((p) => p.id === id);
+  if (!entry)
+    throw new Fault(404, "preset_not_found", "Unknown provider preset. Use switcher providers presets to list available presets.");
+  return structuredClone(entry);
+}
 // openapi.json
 var openapi_default = {
   openapi: "3.0.3",
   info: {
     title: "Switcher API",
-    version: "0.1.0",
+    version: "0.1.1",
     description: "Authenticated provider/profile/catalog control plane. Launches run locally; the API never returns provider credentials."
   },
   security: [
@@ -945,6 +1172,82 @@ var openapi_default = {
         }
       }
     },
+    "/v1/provider-presets": {
+      get: {
+        operationId: "listProviderPresets",
+        parameters: [],
+        responses: {
+          "200": {
+            description: "Success",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  required: [
+                    "data"
+                  ],
+                  properties: {
+                    data: {
+                      type: "array",
+                      items: {
+                        $ref: "#/components/schemas/ProviderPreset"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          default: {
+            description: "Structured error",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/provider-presets/{id}": {
+      get: {
+        operationId: "getProviderPreset",
+        parameters: [
+          {
+            name: "id",
+            in: "path",
+            required: true,
+            schema: {
+              type: "string"
+            }
+          }
+        ],
+        responses: {
+          "200": {
+            description: "Success",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/ProviderPreset"
+                }
+              }
+            }
+          },
+          default: {
+            description: "Structured error",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/providers/{id}/models": {
       get: {
         operationId: "listModels",
@@ -1465,6 +1768,122 @@ var openapi_default = {
       }
     },
     schemas: {
+      ProviderPreset: {
+        type: "object",
+        properties: {
+          id: {
+            type: "string",
+            pattern: "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$"
+          },
+          name: {
+            type: "string",
+            minLength: 1,
+            maxLength: 200
+          },
+          credentialEnv: {
+            type: "string",
+            pattern: "^SWITCHER_PROVIDER_[A-Z0-9_]+$"
+          },
+          credentialAliases: {
+            type: "array",
+            items: {
+              type: "string",
+              pattern: "^[A-Z][A-Z0-9_]+$"
+            }
+          },
+          protocols: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                protocol: {
+                  type: "string",
+                  enum: [
+                    "anthropic-messages",
+                    "openai-responses",
+                    "openai-chat"
+                  ]
+                },
+                baseUrl: {
+                  type: "string",
+                  maxLength: 2000
+                },
+                authStyle: {
+                  type: "string",
+                  enum: [
+                    "bearer",
+                    "x-api-key"
+                  ]
+                },
+                catalogBaseUrl: {
+                  type: "string",
+                  maxLength: 2000
+                },
+                catalogFormat: {
+                  type: "string",
+                  enum: [
+                    "openai",
+                    "ollama",
+                    "mistral",
+                    "together",
+                    "fireworks",
+                    "dashscope",
+                    "none"
+                  ]
+                },
+                catalogAuthStyle: {
+                  type: "string",
+                  enum: [
+                    "bearer",
+                    "x-api-key",
+                    "none"
+                  ]
+                },
+                modelsPath: {
+                  type: "string"
+                },
+                notes: {
+                  type: "array",
+                  items: {
+                    type: "string"
+                  }
+                }
+              },
+              required: [
+                "protocol",
+                "authStyle",
+                "catalogFormat",
+                "modelsPath",
+                "notes"
+              ],
+              additionalProperties: false
+            },
+            minItems: 1
+          },
+          sources: {
+            type: "array",
+            items: {
+              type: "string",
+              format: "uri"
+            }
+          },
+          verification: {
+            type: "string",
+            enum: [
+              "documented"
+            ]
+          }
+        },
+        required: [
+          "id",
+          "name",
+          "credentialAliases",
+          "protocols",
+          "sources",
+          "verification"
+        ],
+        additionalProperties: false
+      },
       ProviderInput: {
         type: "object",
         properties: {
@@ -1501,6 +1920,38 @@ var openapi_default = {
             ],
             default: "bearer"
           },
+          catalogBaseUrl: {
+            type: "string",
+            maxLength: 2000
+          },
+          catalogFormat: {
+            type: "string",
+            enum: [
+              "openai",
+              "ollama",
+              "mistral",
+              "together",
+              "fireworks",
+              "dashscope",
+              "none"
+            ]
+          },
+          catalogAuthStyle: {
+            type: "string",
+            enum: [
+              "bearer",
+              "x-api-key",
+              "none"
+            ]
+          },
+          catalogCredentialEnv: {
+            type: "string",
+            pattern: "^SWITCHER_PROVIDER_[A-Z0-9_]+$"
+          },
+          catalogAccountId: {
+            type: "string",
+            pattern: "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+          },
           modelsPath: {
             type: "string",
             pattern: "^[a-zA-Z0-9_/-]+$",
@@ -1526,6 +1977,9 @@ var openapi_default = {
                   type: "string",
                   maxLength: 8000
                 },
+                available: {
+                  type: "boolean"
+                },
                 contextWindow: {
                   type: "integer",
                   exclusiveMinimum: true,
@@ -1615,6 +2069,38 @@ var openapi_default = {
             ],
             default: "bearer"
           },
+          catalogBaseUrl: {
+            type: "string",
+            maxLength: 2000
+          },
+          catalogFormat: {
+            type: "string",
+            enum: [
+              "openai",
+              "ollama",
+              "mistral",
+              "together",
+              "fireworks",
+              "dashscope",
+              "none"
+            ]
+          },
+          catalogAuthStyle: {
+            type: "string",
+            enum: [
+              "bearer",
+              "x-api-key",
+              "none"
+            ]
+          },
+          catalogCredentialEnv: {
+            type: "string",
+            pattern: "^SWITCHER_PROVIDER_[A-Z0-9_]+$"
+          },
+          catalogAccountId: {
+            type: "string",
+            pattern: "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+          },
           modelsPath: {
             type: "string",
             pattern: "^[a-zA-Z0-9_/-]+$",
@@ -1640,6 +2126,9 @@ var openapi_default = {
                   type: "string",
                   maxLength: 8000
                 },
+                available: {
+                  type: "boolean"
+                },
                 contextWindow: {
                   type: "integer",
                   exclusiveMinimum: true,
@@ -1725,7 +2214,8 @@ var openapi_default = {
               "claude",
               "codex",
               "grok",
-              "opencode2"
+              "opencode2",
+              "pi"
             ]
           },
           model: {
@@ -1765,7 +2255,8 @@ var openapi_default = {
               "claude",
               "codex",
               "grok",
-              "opencode2"
+              "opencode2",
+              "pi"
             ]
           },
           model: {
@@ -1810,6 +2301,9 @@ var openapi_default = {
             type: "string",
             maxLength: 8000
           },
+          available: {
+            type: "boolean"
+          },
           contextWindow: {
             type: "integer",
             exclusiveMinimum: true,
@@ -1873,6 +2367,9 @@ var openapi_default = {
                   type: "string",
                   maxLength: 8000
                 },
+                available: {
+                  type: "boolean"
+                },
                 contextWindow: {
                   type: "integer",
                   exclusiveMinimum: true,
@@ -1971,6 +2468,9 @@ var openapi_default = {
                   type: "string",
                   maxLength: 8000
                 },
+                available: {
+                  type: "boolean"
+                },
                 contextWindow: {
                   type: "integer",
                   exclusiveMinimum: true,
@@ -2070,6 +2570,38 @@ var openapi_default = {
                 ],
                 default: "bearer"
               },
+              catalogBaseUrl: {
+                type: "string",
+                maxLength: 2000
+              },
+              catalogFormat: {
+                type: "string",
+                enum: [
+                  "openai",
+                  "ollama",
+                  "mistral",
+                  "together",
+                  "fireworks",
+                  "dashscope",
+                  "none"
+                ]
+              },
+              catalogAuthStyle: {
+                type: "string",
+                enum: [
+                  "bearer",
+                  "x-api-key",
+                  "none"
+                ]
+              },
+              catalogCredentialEnv: {
+                type: "string",
+                pattern: "^SWITCHER_PROVIDER_[A-Z0-9_]+$"
+              },
+              catalogAccountId: {
+                type: "string",
+                pattern: "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$"
+              },
               modelsPath: {
                 type: "string",
                 pattern: "^[a-zA-Z0-9_/-]+$",
@@ -2095,6 +2627,9 @@ var openapi_default = {
                       type: "string",
                       maxLength: 8000
                     },
+                    available: {
+                      type: "boolean"
+                    },
                     contextWindow: {
                       type: "integer",
                       exclusiveMinimum: true,
@@ -2180,7 +2715,8 @@ var openapi_default = {
                   "claude",
                   "codex",
                   "grok",
-                  "opencode2"
+                  "opencode2",
+                  "pi"
                 ]
               },
               model: {
@@ -2230,6 +2766,9 @@ var openapi_default = {
                       type: "string",
                       maxLength: 8000
                     },
+                    available: {
+                      type: "boolean"
+                    },
                     contextWindow: {
                       type: "integer",
                       exclusiveMinimum: true,
@@ -2322,7 +2861,8 @@ var openapi_default = {
               "claude",
               "codex",
               "grok",
-              "opencode2"
+              "opencode2",
+              "pi"
             ]
           },
           model: {
@@ -2379,7 +2919,8 @@ var openapi_default = {
               "claude",
               "codex",
               "grok",
-              "opencode2"
+              "opencode2",
+              "pi"
             ]
           },
           model: {
@@ -2562,7 +3103,7 @@ var openapi_default = {
 // src/service.ts
 var snapshot = (profile, provider, catalog) => createHash("sha256").update(JSON.stringify([profile, provider, { models: catalog.models, source: catalog.source }])).digest("hex");
 var hash = (s) => createHash("sha256").update(s).digest();
-function createHandler(store, apiKey, providerEnv = process.env) {
+function createHandler(store, apiKey, providerEnv = process.env, resolveCredential) {
   if (!apiKey || apiKey.length < 24)
     throw new Fault(500, "auth_config", "Set HASNA_SWITCHER_API_KEY to a random token of at least 24 characters.");
   const expected = hash(`Bearer ${apiKey}`);
@@ -2571,12 +3112,12 @@ function createHandler(store, apiKey, providerEnv = process.env) {
     const json = (body, status = 200) => Response.json(body, { status, headers: { "x-request-id": requestId, "cache-control": "no-store", "x-content-type-options": "nosniff" } });
     try {
       const url = new URL(request.url);
-      const route = url.pathname.replace(/\/$/, "");
-      if (request.method === "GET" && route === "/health")
+      const route2 = url.pathname.replace(/\/$/, "");
+      if (request.method === "GET" && route2 === "/health")
         return json({ status: "ok", version: VERSION, backend: store.engine });
-      if (request.method === "GET" && route === "/version")
+      if (request.method === "GET" && route2 === "/version")
         return json({ version: VERSION });
-      if (request.method === "GET" && route === "/ready") {
+      if (request.method === "GET" && route2 === "/ready") {
         try {
           await store.ready();
           return json({ ready: true });
@@ -2586,9 +3127,9 @@ function createHandler(store, apiKey, providerEnv = process.env) {
       }
       if (!timingSafeEqual(expected, hash(request.headers.get("authorization") ?? "")))
         throw new Fault(401, "unauthorized", "A valid API bearer token is required.");
-      if (request.method === "GET" && ["/v1/openapi.json", "/openapi.json"].includes(route))
+      if (request.method === "GET" && ["/v1/openapi.json", "/openapi.json"].includes(route2))
         return json(openapi_default);
-      const parts = route.split("/").filter(Boolean);
+      const parts = route2.split("/").filter(Boolean);
       if (parts[0] !== "v1")
         throw new Fault(404, "not_found", "Route was not found.");
       const resource = parts[1];
@@ -2601,6 +3142,8 @@ function createHandler(store, apiKey, providerEnv = process.env) {
         search: z2.string().max(200).default("")
       }).strict(), Object.fromEntries(url.searchParams));
       if (request.method === "GET") {
+        if (resource === "provider-presets" && parts.length <= 3)
+          return json(id ? getProviderPreset(id) : { data: providerPresets });
         if (["providers", "profiles", "runs"].includes(resource) && parts.length <= 3) {
           const kind = resource;
           return json(id ? await store.get(kind, id) : await store.list(kind, page()));
@@ -2628,7 +3171,7 @@ function createHandler(store, apiKey, providerEnv = process.env) {
           throw new Fault(400, "invalid_json", "Request must contain valid JSON under 1 MiB.");
         }
       }
-      const fingerprint = hash(JSON.stringify([request.method, route, body, request.headers.get("if-match")])).toString("hex");
+      const fingerprint = hash(JSON.stringify([request.method, route2, body, request.headers.get("if-match")])).toString("hex");
       const version = () => {
         const v = request.headers.get("if-match");
         if (!v || !/^[1-9]\d*$/.test(v))
@@ -2642,7 +3185,7 @@ function createHandler(store, apiKey, providerEnv = process.env) {
       if (resource === "providers" && id && parts[3] === "refresh" && parts.length === 4 && request.method === "POST") {
         parse(z2.object({}).strict(), body);
         const provider = await store.get("providers", id);
-        refreshed = { provider, catalog: await discover(provider, providerEnv) };
+        refreshed = { provider, catalog: await discover(provider, providerEnv, resolveCredential) };
       }
       const result = await store.mutate(key, fingerprint, async (db) => {
         if ((resource === "providers" || resource === "profiles") && parts.length <= 3) {
@@ -2747,6 +3290,46 @@ function createHandler(store, apiKey, providerEnv = process.env) {
   };
 }
 
+// src/server.ts
+async function startServer(options) {
+  const port = options.port ?? 0;
+  if (!Number.isInteger(port) || port < 0 || port > 65535)
+    throw new Fault(400, "invalid_port", "Port must be an integer between 0 and 65535.");
+  if (options.apiKey.length < 24 || /[\r\n]/.test(options.apiKey))
+    throw new Fault(500, "auth_config", "Use a random operator token of at least 24 characters.");
+  const store = await Store.open({ databaseUrl: options.databaseUrl, sqlitePath: options.sqlitePath });
+  let server;
+  try {
+    server = Bun.serve({
+      hostname: options.hostname ?? "127.0.0.1",
+      port,
+      maxRequestBodySize: 1024 * 1024,
+      idleTimeout: 60,
+      fetch: createHandler(store, options.apiKey, options.providerEnv, options.resolveCredential)
+    });
+    await store.ready();
+  } catch (error) {
+    await server?.stop(true);
+    await store.close();
+    throw error;
+  }
+  const listener = server;
+  let closing;
+  return {
+    url: listener.url.href,
+    storage: store.engine,
+    close() {
+      return closing ??= (async () => {
+        try {
+          await listener.stop(true);
+        } finally {
+          await store.close();
+        }
+      })();
+    }
+  };
+}
+
 // src/serve.ts
 async function main(args = process.argv.slice(2)) {
   const { values } = parseArgs({ args, options: {
@@ -2776,16 +3359,19 @@ Requires HASNA_SWITCHER_API_KEY (24+ characters). Provider credentials: SWITCHER
     throw new Fault(500, "auth_config", "Set HASNA_SWITCHER_API_KEY to a random token of at least 24 characters.");
   if (values.sqlite && values["data-dir"])
     throw new Fault(400, "storage_config", "Choose --sqlite or --data-dir.");
-  const store = await Store.open({ databaseUrl: process.env.HASNA_SWITCHER_DATABASE_URL, sqlitePath: values.sqlite ?? (values["data-dir"] ? join(values["data-dir"], "switcher.db") : process.env.HASNA_SWITCHER_SQLITE_PATH) });
-  const server = Bun.serve({ hostname: values.host ?? "127.0.0.1", port, maxRequestBodySize: 1024 * 1024, idleTimeout: 60, fetch: createHandler(store, apiKey) });
-  console.log(JSON.stringify({ event: "listening", version: VERSION, url: server.url.href, storage: store.engine }));
-  let stopping = false;
-  const stop = async () => {
-    if (stopping)
-      return;
-    stopping = true;
-    await server.stop();
-    await store.close();
+  const server = await startServer({
+    apiKey,
+    hostname: values.host ?? "127.0.0.1",
+    port,
+    databaseUrl: process.env.HASNA_SWITCHER_DATABASE_URL,
+    sqlitePath: values.sqlite ?? (values["data-dir"] ? join(values["data-dir"], "switcher.db") : process.env.HASNA_SWITCHER_SQLITE_PATH)
+  });
+  console.log(JSON.stringify({ event: "listening", version: VERSION, url: server.url, storage: server.storage }));
+  const stop = () => {
+    server.close().catch(() => {
+      console.error("Server shutdown failed.");
+      process.exitCode = 1;
+    });
   };
   process.once("SIGTERM", stop);
   process.once("SIGINT", stop);