@hasna/switcher 0.1.1 → 0.1.2

package/dist/sdk.d.ts

@@ -57,12 +57,12 @@ export declare class SwitcherClient {
         credentialEnv?: string;
         credentialAliases: string[];
         protocols: {
-            protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+            protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
             baseUrl?: string;
-            authStyle: "bearer" | "x-api-key";
+            authStyle: "bearer" | "x-api-key" | "api-key";
             catalogBaseUrl?: string;
-            catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
-            catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+            catalogFormat: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+            catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
             modelsPath: string;
             notes: string[];
         }[];
@@ -73,12 +73,12 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         baseUrl: string;
-        protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
         credentialEnv?: string;
-        authStyle: "bearer" | "x-api-key";
+        authStyle: "bearer" | "x-api-key" | "api-key";
         catalogBaseUrl?: string;
-        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
-        catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
         catalogCredentialEnv?: string;
         catalogAccountId?: string;
         modelsPath: string;
@@ -92,6 +92,7 @@ export declare class SwitcherClient {
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         version: number;
         updatedAt: string;
@@ -100,12 +101,12 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         baseUrl: string;
-        protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
         credentialEnv?: string;
-        authStyle: "bearer" | "x-api-key";
+        authStyle: "bearer" | "x-api-key" | "api-key";
         catalogBaseUrl?: string;
-        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
-        catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
         catalogCredentialEnv?: string;
         catalogAccountId?: string;
         modelsPath: string;
@@ -119,6 +120,7 @@ export declare class SwitcherClient {
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         version: number;
         updatedAt: string;
@@ -127,12 +129,12 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         baseUrl: string;
-        protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
         credentialEnv?: string;
-        authStyle: "bearer" | "x-api-key";
+        authStyle: "bearer" | "x-api-key" | "api-key";
         catalogBaseUrl?: string;
-        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
-        catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
         catalogCredentialEnv?: string;
         catalogAccountId?: string;
         modelsPath: string;
@@ -146,6 +148,7 @@ export declare class SwitcherClient {
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         version: number;
         updatedAt: string;
@@ -154,12 +157,12 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         baseUrl: string;
-        protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+        protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
         credentialEnv?: string;
-        authStyle: "bearer" | "x-api-key";
+        authStyle: "bearer" | "x-api-key" | "api-key";
         catalogBaseUrl?: string;
-        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
-        catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+        catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+        catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
         catalogCredentialEnv?: string;
         catalogAccountId?: string;
         modelsPath: string;
@@ -173,6 +176,7 @@ export declare class SwitcherClient {
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         version: number;
         updatedAt: string;
@@ -191,6 +195,7 @@ export declare class SwitcherClient {
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
         }[];
         refreshedAt: string;
         source: "remote" | "manual";
@@ -206,6 +211,7 @@ export declare class SwitcherClient {
             inputModalities?: string[];
             outputModalities?: string[];
             supportedParameters?: string[];
+            supportedGenerationMethods?: string[];
             codingEligible: boolean;
         }[];
         total: number;
@@ -218,7 +224,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+        harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
         model: string;
         version: number;
         updatedAt: string;
@@ -227,7 +233,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+        harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
         model: string;
         version: number;
         updatedAt: string;
@@ -236,7 +242,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+        harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
         model: string;
         version: number;
         updatedAt: string;
@@ -245,7 +251,7 @@ export declare class SwitcherClient {
         id: string;
         name: string;
         providerId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+        harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
         model: string;
         version: number;
         updatedAt: string;
@@ -258,12 +264,12 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             baseUrl: string;
-            protocol: "anthropic-messages" | "openai-responses" | "openai-chat";
+            protocol: "anthropic-messages" | "openai-responses" | "openai-chat" | "gemini-generate-content";
             credentialEnv?: string;
-            authStyle: "bearer" | "x-api-key";
+            authStyle: "bearer" | "x-api-key" | "api-key";
             catalogBaseUrl?: string;
-            catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "none";
-            catalogAuthStyle?: "bearer" | "x-api-key" | "none";
+            catalogFormat?: "openai" | "ollama" | "mistral" | "together" | "fireworks" | "dashscope" | "gemini" | "none";
+            catalogAuthStyle?: "bearer" | "x-api-key" | "api-key" | "none";
             catalogCredentialEnv?: string;
             catalogAccountId?: string;
             modelsPath: string;
@@ -277,6 +283,7 @@ export declare class SwitcherClient {
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
             version: number;
             updatedAt: string;
@@ -285,7 +292,7 @@ export declare class SwitcherClient {
             id: string;
             name: string;
             providerId: string;
-            harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+            harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
             model: string;
             version: number;
             updatedAt: string;
@@ -301,6 +308,7 @@ export declare class SwitcherClient {
                 inputModalities?: string[];
                 outputModalities?: string[];
                 supportedParameters?: string[];
+                supportedGenerationMethods?: string[];
             }[];
             refreshedAt: string;
             source: "remote" | "manual";
@@ -310,7 +318,7 @@ export declare class SwitcherClient {
     }>;
     listRuns(options?: {}): Promise<Page<{
         profileId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+        harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
         model: string;
         planToken: string;
         version: number;
@@ -326,7 +334,7 @@ export declare class SwitcherClient {
     }>>;
     getRun(id: string): Promise<{
         profileId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+        harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
         model: string;
         planToken: string;
         version: number;
@@ -342,7 +350,7 @@ export declare class SwitcherClient {
     }>;
     createRun(input: components["schemas"]["RunInput"], idempotencyKey?: string): Promise<{
         profileId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+        harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
         model: string;
         planToken: string;
         version: number;
@@ -361,7 +369,7 @@ export declare class SwitcherClient {
         exitCode: number;
     }, idempotencyKey?: string): Promise<{
         profileId: string;
-        harness: "claude" | "codex" | "grok" | "opencode2" | "pi";
+        harness: "claude" | "codex" | "grok" | "opencode" | "opencode2" | "pi" | "omp" | "dsh" | "cline" | "hermes" | "prime-agent" | "gemini" | "aider" | "kilo";
         model: string;
         planToken: string;
         version: number;

package/dist/sdk.js

@@ -1,7 +1,7 @@
 // src/domain.ts
 import { z } from "zod";
-var harnessSchema = z.enum(["claude", "codex", "grok", "opencode2", "pi"]);
-var protocolSchema = z.enum(["anthropic-messages", "openai-responses", "openai-chat"]);
+var harnessSchema = z.enum(["claude", "codex", "grok", "opencode", "opencode2", "pi", "omp", "dsh", "cline", "hermes", "prime-agent", "gemini", "aider", "kilo"]);
+var protocolSchema = z.enum(["anthropic-messages", "openai-responses", "openai-chat", "gemini-generate-content"]);
 var idSchema = z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$/);
 var label = z.string().min(1).max(200);
 var envRef = z.string().regex(/^SWITCHER_PROVIDER_[A-Z0-9_]+$/);
@@ -33,7 +33,8 @@ var modelSchema = z.object({
   maxOutputTokens: z.number().int().positive().optional(),
   inputModalities: z.array(z.string().max(50)).max(20).optional(),
   outputModalities: z.array(z.string().max(50)).max(20).optional(),
-  supportedParameters: z.array(z.string().max(100)).max(100).optional()
+  supportedParameters: z.array(z.string().max(100)).max(100).optional(),
+  supportedGenerationMethods: z.array(z.string().min(1).max(100)).max(100).optional()
 }).strict();
 var providerInputSchema = z.object({
   id: idSchema,
@@ -41,10 +42,10 @@ var providerInputSchema = z.object({
   baseUrl: urlSchema,
   protocol: protocolSchema,
   credentialEnv: envRef.optional(),
-  authStyle: z.enum(["bearer", "x-api-key"]).default("bearer"),
+  authStyle: z.enum(["bearer", "x-api-key", "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(),
+  catalogFormat: z.enum(["openai", "ollama", "mistral", "together", "fireworks", "dashscope", "gemini", "none"]).optional(),
+  catalogAuthStyle: z.enum(["bearer", "x-api-key", "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"),
@@ -58,10 +59,10 @@ var providerPresetSchema = z.object({
   protocols: z.array(z.object({
     protocol: protocolSchema,
     baseUrl: urlSchema.optional(),
-    authStyle: z.enum(["bearer", "x-api-key"]),
+    authStyle: z.enum(["bearer", "x-api-key", "api-key"]),
     catalogBaseUrl: urlSchema.optional(),
-    catalogFormat: z.enum(["openai", "ollama", "mistral", "together", "fireworks", "dashscope", "none"]),
-    catalogAuthStyle: z.enum(["bearer", "x-api-key", "none"]).optional(),
+    catalogFormat: z.enum(["openai", "ollama", "mistral", "together", "fireworks", "dashscope", "gemini", "none"]),
+    catalogAuthStyle: z.enum(["bearer", "x-api-key", "api-key", "none"]).optional(),
     modelsPath: z.string(),
     notes: z.array(z.string())
   }).strict()).min(1),
@@ -102,7 +103,15 @@ function parse(schema, value) {
   return result.data;
 }
 function compatible(harness, protocol) {
-  return harness === "claude" ? protocol === "anthropic-messages" : harness === "codex" ? protocol === "openai-responses" : true;
+  if (harness === "claude")
+    return protocol === "anthropic-messages";
+  if (harness === "codex")
+    return protocol === "openai-responses";
+  if (harness === "gemini")
+    return protocol === "gemini-generate-content";
+  if (protocol === "gemini-generate-content")
+    return false;
+  return true;
 }
 
 // src/http.ts
@@ -168,7 +177,18 @@ var providerPresets = [
   ], ["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("gemini", "Google Gemini", [route("gemini-generate-content", "https://generativelanguage.googleapis.com/v1beta", {
+    authStyle: "x-api-key",
+    catalogBaseUrl: "https://generativelanguage.googleapis.com/v1beta",
+    catalogFormat: "gemini",
+    catalogAuthStyle: "x-api-key",
+    notes: ["Gemini CLI uses the native generateContent wire with x-goog-api-key authentication; model IDs are returned as models/{id}."]
+  }), route("openai-chat", "https://generativelanguage.googleapis.com/v1beta/openai")], ["https://ai.google.dev/api", "https://ai.google.dev/api/models", "https://github.com/google-gemini/gemini-cli", "https://ai.google.dev/gemini-api/docs/openai"], "GEMINI_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("azure-openai", "Azure OpenAI (v1)", [
+    route("openai-responses", undefined, { authStyle: "api-key", catalogFormat: "none", notes: ["Pass the Azure OpenAI v1 resource endpoint ending in /openai/v1. The request model is your deployment name. Azure's model-definition list is not a deployment catalog, so configure manual deployment models or an explicit deployment catalog parser; Switcher does not synthesize deployment paths or api-version query parameters."] }),
+    route("openai-chat", undefined, { authStyle: "api-key", catalogFormat: "none", notes: ["Pass the Azure OpenAI v1 resource endpoint ending in /openai/v1. Chat Completions is POST /chat/completions and accepts the literal api-key header. The request model is your deployment name; configure manual deployment models or an explicit deployment catalog parser because GET /models does not establish deployment names."] })
+  ], ["https://learn.microsoft.com/en-us/rest/api/aifoundry/azureopenai/models", "https://learn.microsoft.com/en-us/rest/api/microsoft-foundry/azureopenai/chat", "https://learn.microsoft.com/en-us/rest/api/aifoundry/azureopenai/responses"], "AZURE_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",
@@ -229,6 +249,8 @@ function providerFromPreset(presetId, options = {}) {
   const baseUrl = options.baseUrl ?? selected.baseUrl;
   if (!baseUrl)
     throw new Fault(400, "endpoint_required", "This preset requires an explicit --url for its inference endpoint.");
+  if (presetId === "azure-openai" && !/\/openai\/v1$/.test(endpoint(baseUrl)))
+    throw new Fault(400, "invalid_url", "Azure OpenAI v1 requires an explicit endpoint ending in /openai/v1; deployment and api-version URLs are unsupported.");
   if (options.baseUrl && selected.baseUrl && new URL(endpoint(options.baseUrl)).origin !== new URL(selected.baseUrl).origin && preset2.credentialEnv && !options.credentialEnv)
     throw new Fault(422, "credential_authority", "An endpoint on another origin requires an explicit --credential-env reference.");
   const suffix = selected.protocol === "anthropic-messages" ? "messages" : selected.protocol === "openai-responses" ? "responses" : "chat";
@@ -265,6 +287,26 @@ class SwitcherError extends Error {
     this.requestId = requestId;
   }
 }
+function apiError(status, data, apiKey) {
+  const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+  const error = object(data) && object(data.error) ? data.error : {};
+  const escape = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const base64 = Buffer.from(apiKey, "utf8").toString("base64");
+  const literal = [apiKey, JSON.stringify(apiKey).slice(1, -1), base64, base64.replace(/=+$/, ""), Buffer.from(apiKey, "utf8").toString("base64url")];
+  const encoded = [encodeURIComponent(apiKey), new URLSearchParams({ key: apiKey }).toString().slice(4)];
+  const patterns = [...new Set(literal)].sort((a, b) => b.length - a.length).map(escape);
+  for (const value of encoded) {
+    patterns.unshift(escape(value).replace(/%[0-9A-F]{2}/g, (part) => part.replace(/[A-F]/g, (letter) => `[${letter}${letter.toLowerCase()}]`)));
+  }
+  const reflected = new RegExp(patterns.join("|"), "g");
+  const redact = (value) => value.replace(reflected, "[REDACTED]");
+  const identifier = (value, pattern) => typeof value === "string" && pattern.test(value) && redact(value) === value ? value : undefined;
+  const code = identifier(error.code, /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/) ?? "api_error";
+  const requestId = identifier(error.requestId, /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/);
+  const fallback = `Switcher API returned HTTP ${status}.`;
+  const message = typeof error.message === "string" && error.message.length <= 4096 ? redact(error.message).replace(/[\x00-\x1f\x7f-\x9f]/g, " ").trim().slice(0, 2048) || fallback : fallback;
+  return new SwitcherError(status, code, message, requestId);
+}
 
 class SwitcherClient {
   options;
@@ -301,7 +343,7 @@ class SwitcherClient {
       throw new SwitcherError(response.status, "invalid_response", "Switcher API returned invalid JSON.");
     }
     if (!response.ok)
-      throw new SwitcherError(response.status, data?.error?.code ?? "api_error", data?.error?.message ?? `Switcher API returned HTTP ${response.status}.`, data?.error?.requestId);
+      throw apiError(response.status, data, apiKey);
     return data;
   }
   query(options = {}) {