@theokit/sdk 5.9.0 → 5.9.2

package/dist/chunk-SVCPJRUB.js

@@ -0,0 +1,1874 @@
+import { globalSingleton } from './chunk-AGACYRJ2.js';
+import { resolveCredential } from './chunk-TX56N7FR.js';
+import { readStoredOAuth } from './chunk-5Q4RTLMP.js';
+import { AuthenticationError } from './chunk-B5MHRQJZ.js';
+import { diag } from './chunk-CZJ6Q7CW.js';
+import { z } from 'zod';
+import { homedir } from 'os';
+
+// src/internal/providers/registry.ts
+var REGISTRY = globalSingleton(
+  "theokit-sdk.providers.registry",
+  () => /* @__PURE__ */ new Map()
+);
+var ALIASES = globalSingleton("theokit-sdk.providers.aliases", () => /* @__PURE__ */ new Map());
+function registerProvider(profile) {
+  if (REGISTRY.has(profile.name)) {
+    diag(`[theokit-sdk] Provider "${profile.name}" overridden by user plugin.
+`);
+  }
+  REGISTRY.set(profile.name, profile);
+  for (const alias of profile.aliases ?? []) {
+    const previous = ALIASES.get(alias);
+    if (previous !== void 0 && previous !== profile.name) {
+      diag(`[theokit-sdk] Alias "${alias}" collision: was "${previous}", now "${profile.name}".
+`);
+    }
+    ALIASES.set(alias, profile.name);
+  }
+}
+function getProviderProfile(name) {
+  const canonical = ALIASES.get(name) ?? name;
+  return REGISTRY.get(canonical);
+}
+function listProviders() {
+  return Array.from(REGISTRY.values());
+}
+var MODALITIES = ["text", "audio", "image", "video", "pdf"];
+var costSchema = z.object({
+  /** USD per 1M tokens (models.dev convention). */
+  input: z.number().nonnegative(),
+  output: z.number().nonnegative(),
+  cache_read: z.number().nonnegative().optional(),
+  cache_write: z.number().nonnegative().optional()
+}).loose();
+var limitSchema = z.object({
+  context: z.number().positive(),
+  input: z.number().positive().optional(),
+  output: z.number().positive().optional()
+}).loose();
+var modalitiesSchema = z.object({
+  input: z.array(z.enum(MODALITIES)).optional(),
+  output: z.array(z.enum(MODALITIES)).optional()
+}).loose();
+var catalogModelSchema = z.object({
+  name: z.string().optional(),
+  release_date: z.string().optional(),
+  attachment: z.boolean().optional(),
+  reasoning: z.boolean().optional(),
+  temperature: z.boolean().optional(),
+  tool_call: z.boolean().optional(),
+  /** theokit extension — maps to ModelCapabilities.supportsStructuredOutput. */
+  structured_output: z.boolean().optional(),
+  /** theokit extension — maps to ModelCapabilities.supportsCacheControl. */
+  cache_control: z.boolean().optional(),
+  cost: costSchema.optional(),
+  limit: limitSchema.optional(),
+  modalities: modalitiesSchema.optional(),
+  status: z.enum(["alpha", "beta", "deprecated"]).optional()
+}).loose();
+var catalogEntrySchema = z.object({
+  id: z.string().min(1),
+  displayName: z.string().min(1),
+  apiMode: z.enum([
+    "chat_completions",
+    "anthropic_messages",
+    "responses_api",
+    "bedrock",
+    "bedrock_anthropic"
+  ]),
+  authType: z.enum([
+    "api_key",
+    "oauth_device_code",
+    "oauth_external",
+    "aws_sdk",
+    "aws_bearer",
+    "gcp_oauth",
+    "none"
+  ]),
+  baseUrl: z.string(),
+  envVars: z.array(z.string()),
+  fallbackModels: z.array(z.string()),
+  capabilities: z.object({
+    supportsToolUse: z.boolean(),
+    supportsVision: z.boolean(),
+    supportsStructuredOutput: z.boolean(),
+    supportsStreaming: z.boolean(),
+    supportsCacheControl: z.boolean(),
+    maxContextTokens: z.number().int().positive().optional(),
+    maxOutputTokens: z.number().int().positive().optional()
+  }),
+  aliases: z.array(z.string()).optional(),
+  modelsUrl: z.string().optional(),
+  hostname: z.string().optional(),
+  extraHeaders: z.record(z.string(), z.string()).optional(),
+  models: z.record(z.string(), catalogModelSchema).optional()
+}).loose();
+
+// src/internal/providers/provider-catalog.json
+var provider_catalog_default = [
+  {
+    id: "openai",
+    displayName: "OpenAI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.openai.com/v1",
+    envVars: ["OPENAI_API_KEY"],
+    fallbackModels: ["gpt-4o-mini", "gpt-4o"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["openai", "openai-chatgpt"],
+    models: {
+      "gpt-4o-mini": {
+        name: "GPT-4o mini",
+        release_date: "2024-07-18",
+        attachment: true,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 0.15,
+          output: 0.6,
+          cache_read: 0.075
+        },
+        limit: {
+          context: 128e3,
+          output: 16384
+        },
+        modalities: {
+          input: ["text", "image"],
+          output: ["text"]
+        },
+        cache_control: false
+      },
+      "gpt-4o": {
+        name: "GPT-4o",
+        release_date: "2024-05-13",
+        attachment: true,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 2.5,
+          output: 10,
+          cache_read: 1.25
+        },
+        limit: {
+          context: 128e3,
+          output: 16384
+        },
+        modalities: {
+          input: ["text", "image"],
+          output: ["text"]
+        },
+        cache_control: false
+      },
+      "gpt-4-turbo": {
+        name: "GPT-4 Turbo",
+        release_date: "2023-11-06",
+        attachment: true,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        structured_output: false,
+        cost: {
+          input: 10,
+          output: 30
+        },
+        limit: {
+          context: 128e3,
+          output: 4096
+        },
+        modalities: {
+          input: ["text", "image"],
+          output: ["text"]
+        },
+        cache_control: false
+      },
+      o1: {
+        name: "o1",
+        release_date: "2024-12-05",
+        attachment: true,
+        reasoning: true,
+        temperature: false,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 15,
+          output: 60,
+          cache_read: 7.5
+        },
+        limit: {
+          context: 2e5,
+          output: 1e5
+        },
+        modalities: {
+          input: ["text"],
+          output: ["text"]
+        },
+        cache_control: false
+      },
+      o3: {
+        name: "o3",
+        release_date: "2025-04-16",
+        attachment: true,
+        reasoning: true,
+        temperature: false,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 2,
+          output: 8,
+          cache_read: 0.5
+        },
+        limit: {
+          context: 2e5,
+          output: 1e5
+        },
+        modalities: {
+          input: ["text"],
+          output: ["text"]
+        },
+        cache_control: false
+      },
+      "gpt-4.1": {
+        name: "GPT-4.1",
+        release_date: "2025-04-14",
+        attachment: true,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 2,
+          output: 8,
+          cache_read: 0.5
+        },
+        limit: {
+          context: 1047576,
+          output: 32768
+        },
+        modalities: {
+          input: ["text", "image"],
+          output: ["text"]
+        },
+        cache_control: false
+      },
+      "gpt-5.4": {
+        limit: {
+          context: 4e5,
+          output: 128e3
+        }
+      },
+      "gpt-5.4-mini": {
+        limit: {
+          context: 4e5,
+          output: 128e3
+        }
+      },
+      "gpt-5.3": {
+        limit: {
+          context: 4e5,
+          output: 128e3
+        }
+      },
+      "gpt-5.2": {
+        limit: {
+          context: 4e5,
+          output: 128e3
+        }
+      }
+    }
+  },
+  {
+    id: "anthropic",
+    displayName: "Anthropic",
+    apiMode: "anthropic_messages",
+    authType: "api_key",
+    baseUrl: "https://api.anthropic.com/v1",
+    envVars: ["ANTHROPIC_API_KEY"],
+    fallbackModels: ["claude-sonnet-4-20250514", "claude-3-5-haiku-latest"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: true
+    },
+    aliases: ["anthropic"],
+    models: {
+      "claude-3-5-haiku-latest": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text"]
+        },
+        limit: {
+          context: 2e5,
+          output: 8192
+        }
+      },
+      "claude-opus-4-7": {
+        name: "Claude Opus 4.7",
+        release_date: "2026-04-14",
+        attachment: true,
+        reasoning: true,
+        temperature: false,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 5,
+          output: 25,
+          cache_read: 0.5,
+          cache_write: 6.25
+        },
+        limit: {
+          context: 1e6,
+          output: 128e3
+        },
+        modalities: {
+          input: ["text", "image", "pdf"],
+          output: ["text"]
+        },
+        cache_control: true
+      },
+      "claude-sonnet-4-6": {
+        name: "Claude Sonnet 4.6",
+        release_date: "2026-02-17",
+        attachment: true,
+        reasoning: true,
+        temperature: true,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 3,
+          output: 15,
+          cache_read: 0.3,
+          cache_write: 3.75
+        },
+        limit: {
+          context: 1e6,
+          output: 128e3
+        },
+        modalities: {
+          input: ["text", "image", "pdf"],
+          output: ["text"]
+        },
+        cache_control: true
+      },
+      "claude-haiku-4-5-20251001": {
+        name: "Claude Haiku 4.5",
+        release_date: "2025-10-15",
+        attachment: true,
+        reasoning: true,
+        temperature: true,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 1,
+          output: 5,
+          cache_read: 0.1,
+          cache_write: 1.25
+        },
+        limit: {
+          context: 2e5,
+          output: 64e3
+        },
+        modalities: {
+          input: ["text", "image", "pdf"],
+          output: ["text"]
+        },
+        cache_control: true
+      },
+      "claude-opus-4": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 32e3
+        }
+      },
+      "claude-sonnet-4": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 16e3
+        }
+      },
+      "claude-3-5-sonnet": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 8192
+        }
+      },
+      "claude-3-5-sonnet-latest": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 8192
+        }
+      },
+      "claude-3-haiku": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 4096
+        }
+      },
+      "claude-3-opus": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 4096
+        }
+      },
+      "claude-opus-4.1": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 32e3
+        }
+      },
+      "claude-sonnet-4.5": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 16e3
+        }
+      },
+      "claude-3.5-sonnet": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: true,
+        modalities: {
+          input: ["text", "image"]
+        },
+        limit: {
+          context: 2e5,
+          output: 8192
+        }
+      }
+    }
+  },
+  {
+    id: "openrouter",
+    displayName: "OpenRouter",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://openrouter.ai/api/v1",
+    envVars: ["OPENROUTER_API_KEY"],
+    fallbackModels: ["openai/gpt-4o-mini"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["openrouter"]
+  },
+  {
+    id: "groq",
+    displayName: "Groq",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.groq.com/openai/v1",
+    envVars: ["GROQ_API_KEY"],
+    fallbackModels: ["llama-3.3-70b-versatile"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    models: {
+      "llama-3.3-70b-versatile": {
+        name: "Llama 3.3 70B",
+        release_date: "2024-12-06",
+        attachment: false,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        cost: {
+          input: 0.59,
+          output: 0.79
+        },
+        limit: {
+          context: 131072,
+          output: 32768
+        },
+        modalities: {
+          input: ["text"],
+          output: ["text"]
+        }
+      }
+    }
+  },
+  {
+    id: "mistral",
+    displayName: "Mistral AI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.mistral.ai/v1",
+    envVars: ["MISTRAL_API_KEY"],
+    fallbackModels: ["mistral-large-latest"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    models: {
+      "mistral-large-latest": {
+        name: "Mistral Large (latest)",
+        release_date: "2024-11-01",
+        attachment: true,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        cost: {
+          input: 0.5,
+          output: 1.5
+        },
+        limit: {
+          context: 262144,
+          output: 262144
+        },
+        modalities: {
+          input: ["text", "image"],
+          output: ["text"]
+        }
+      }
+    }
+  },
+  {
+    id: "deepseek",
+    displayName: "DeepSeek",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.deepseek.com/v1",
+    envVars: ["DEEPSEEK_API_KEY"],
+    fallbackModels: ["deepseek-chat"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    models: {
+      "deepseek-chat": {
+        name: "DeepSeek Chat",
+        release_date: "2025-12-01",
+        attachment: true,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        cost: {
+          input: 0.14,
+          output: 0.28,
+          cache_read: 28e-4
+        },
+        limit: {
+          context: 1e6,
+          output: 384e3
+        },
+        modalities: {
+          input: ["text"],
+          output: ["text"]
+        }
+      },
+      "deepseek-v4-flash": {
+        name: "DeepSeek V4 Flash",
+        release_date: "2026-04-24",
+        attachment: false,
+        reasoning: true,
+        temperature: true,
+        tool_call: true,
+        structured_output: false,
+        cost: {
+          input: 0.14,
+          output: 0.28,
+          cache_read: 28e-4
+        },
+        limit: {
+          context: 1048576,
+          output: 8e3
+        },
+        modalities: {
+          input: ["text"],
+          output: ["text"]
+        },
+        cache_control: false
+      },
+      "deepseek-v3.2": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: false,
+        modalities: {
+          input: ["text"]
+        },
+        limit: {
+          context: 131072,
+          output: 8e3
+        }
+      }
+    }
+  },
+  {
+    id: "together",
+    displayName: "Together AI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.together.xyz/v1",
+    envVars: ["TOGETHER_API_KEY"],
+    fallbackModels: ["meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "fireworks",
+    displayName: "Fireworks AI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.fireworks.ai/inference/v1",
+    envVars: ["FIREWORKS_API_KEY"],
+    fallbackModels: ["accounts/fireworks/models/llama-v3p1-70b-instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "google-gemini",
+    displayName: "Google Gemini",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+    envVars: ["GOOGLE_API_KEY", "GEMINI_API_KEY"],
+    fallbackModels: ["gemini-2.0-flash"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["gemini", "google"],
+    models: {
+      "gemini-2.0-flash": {
+        name: "Gemini 2.0 Flash",
+        release_date: "2024-12-11",
+        attachment: true,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 0.1,
+          output: 0.4,
+          cache_read: 0.025
+        },
+        limit: {
+          context: 1048576,
+          output: 8192
+        },
+        modalities: {
+          input: ["text", "image", "audio", "video", "pdf"],
+          output: ["text"]
+        },
+        status: "deprecated"
+      },
+      "gemini-2.5-flash-lite": {
+        name: "Gemini 2.5 Flash-Lite",
+        release_date: "2025-06-17",
+        attachment: true,
+        reasoning: true,
+        temperature: true,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 0.1,
+          output: 0.4,
+          cache_read: 0.01
+        },
+        limit: {
+          context: 1048576,
+          output: 8e3
+        },
+        modalities: {
+          input: ["text", "image"],
+          output: ["text"]
+        },
+        cache_control: false
+      },
+      "gemini-2.5-pro": {
+        name: "Gemini 2.5 Pro",
+        release_date: "2025-06-17",
+        attachment: true,
+        reasoning: true,
+        temperature: true,
+        tool_call: true,
+        structured_output: true,
+        cost: {
+          input: 1.25,
+          output: 10,
+          cache_read: 0.125
+        },
+        limit: {
+          context: 1048576,
+          output: 8e3
+        },
+        modalities: {
+          input: ["text", "image"],
+          output: ["text"]
+        },
+        cache_control: false
+      }
+    }
+  },
+  {
+    id: "ollama",
+    displayName: "Ollama",
+    apiMode: "chat_completions",
+    authType: "none",
+    baseUrl: "http://localhost:11434/v1",
+    envVars: [],
+    fallbackModels: ["llama3.2"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["ollama"]
+  },
+  {
+    id: "lmstudio",
+    displayName: "LM Studio",
+    apiMode: "chat_completions",
+    authType: "none",
+    baseUrl: "http://localhost:1234/v1",
+    envVars: [],
+    fallbackModels: ["lmstudio-community/default"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["lmstudio"]
+  },
+  {
+    id: "llamacpp",
+    displayName: "llama.cpp",
+    apiMode: "chat_completions",
+    authType: "none",
+    baseUrl: "http://localhost:8080/v1",
+    envVars: [],
+    fallbackModels: ["default"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["llamacpp"]
+  },
+  {
+    id: "bedrock",
+    displayName: "AWS Bedrock",
+    apiMode: "bedrock",
+    authType: "aws_sdk",
+    baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com",
+    envVars: ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"],
+    fallbackModels: ["anthropic.claude-3-5-sonnet-20241022-v2:0"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: true
+    },
+    aliases: ["bedrock"]
+  },
+  {
+    id: "vertex",
+    displayName: "Google Vertex AI",
+    apiMode: "chat_completions",
+    authType: "gcp_oauth",
+    baseUrl: "https://us-central1-aiplatform.googleapis.com/v1",
+    envVars: ["GOOGLE_APPLICATION_CREDENTIALS"],
+    fallbackModels: ["gemini-1.5-pro"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["vertex"]
+  },
+  {
+    id: "cohere",
+    displayName: "Cohere",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.cohere.com/v2",
+    envVars: ["COHERE_API_KEY"],
+    fallbackModels: ["command-r-plus"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "perplexity",
+    displayName: "Perplexity",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.perplexity.ai",
+    envVars: ["PERPLEXITY_API_KEY"],
+    fallbackModels: ["llama-3.1-sonar-large-128k-online"],
+    capabilities: {
+      supportsToolUse: false,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "xai",
+    displayName: "xAI (Grok)",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.x.ai/v1",
+    envVars: ["XAI_API_KEY"],
+    fallbackModels: ["grok-2"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["grok"]
+  },
+  {
+    id: "sambanova",
+    displayName: "SambaNova",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.sambanova.ai/v1",
+    envVars: ["SAMBANOVA_API_KEY"],
+    fallbackModels: ["Meta-Llama-3.1-70B-Instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "cerebras",
+    displayName: "Cerebras",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.cerebras.ai/v1",
+    envVars: ["CEREBRAS_API_KEY"],
+    fallbackModels: ["llama3.1-70b"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "deepinfra",
+    displayName: "DeepInfra",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.deepinfra.com/v1/openai",
+    envVars: ["DEEPINFRA_API_KEY"],
+    fallbackModels: ["meta-llama/Meta-Llama-3.1-70B-Instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "huggingface",
+    displayName: "Hugging Face",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api-inference.huggingface.co/v1",
+    envVars: ["HF_TOKEN", "HUGGINGFACE_API_KEY"],
+    fallbackModels: ["meta-llama/Llama-3.2-3B-Instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "nvidia",
+    displayName: "NVIDIA NIM",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://integrate.api.nvidia.com/v1",
+    envVars: ["NVIDIA_API_KEY"],
+    fallbackModels: ["meta/llama-3.1-70b-instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "lepton",
+    displayName: "Lepton AI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://llama3-1-70b.lepton.run/api/v1",
+    envVars: ["LEPTON_API_KEY"],
+    fallbackModels: ["llama3-1-70b"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "anyscale",
+    displayName: "Anyscale",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.endpoints.anyscale.com/v1",
+    envVars: ["ANYSCALE_API_KEY"],
+    fallbackModels: ["meta-llama/Meta-Llama-3-70B-Instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "replicate",
+    displayName: "Replicate",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://openai-proxy.replicate.com/v1",
+    envVars: ["REPLICATE_API_TOKEN"],
+    fallbackModels: ["meta/meta-llama-3-70b-instruct"],
+    capabilities: {
+      supportsToolUse: false,
+      supportsVision: true,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "ai21",
+    displayName: "AI21 Labs",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.ai21.com/studio/v1",
+    envVars: ["AI21_API_KEY"],
+    fallbackModels: ["jamba-1.5-large"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "aleph-alpha",
+    displayName: "Aleph Alpha",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.aleph-alpha.com/v1",
+    envVars: ["ALEPH_ALPHA_API_KEY"],
+    fallbackModels: ["luminous-extended"],
+    capabilities: {
+      supportsToolUse: false,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "cloudflare",
+    displayName: "Cloudflare Workers AI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1",
+    envVars: ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"],
+    fallbackModels: ["@cf/meta/llama-3.1-70b-instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "azure-openai",
+    displayName: "Azure OpenAI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://{resource}.openai.azure.com/openai/deployments/{deployment}",
+    envVars: ["AZURE_OPENAI_API_KEY", "AZURE_OPENAI_ENDPOINT"],
+    fallbackModels: ["gpt-4o"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "github-models",
+    displayName: "GitHub Models",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://models.inference.ai.azure.com",
+    envVars: ["GITHUB_TOKEN"],
+    fallbackModels: ["gpt-4o-mini"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "hyperbolic",
+    displayName: "Hyperbolic",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.hyperbolic.xyz/v1",
+    envVars: ["HYPERBOLIC_API_KEY"],
+    fallbackModels: ["meta-llama/Meta-Llama-3.1-70B-Instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "novita",
+    displayName: "Novita AI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.novita.ai/v3/openai",
+    envVars: ["NOVITA_API_KEY"],
+    fallbackModels: ["meta-llama/llama-3.1-70b-instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "moonshot",
+    displayName: "Moonshot (Kimi)",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.moonshot.cn/v1",
+    envVars: ["MOONSHOT_API_KEY"],
+    fallbackModels: ["moonshot-v1-8k"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "qwen",
+    displayName: "Qwen (Alibaba)",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
+    envVars: ["DASHSCOPE_API_KEY"],
+    fallbackModels: ["qwen-plus"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["dashscope"],
+    models: {
+      "qwen3-coder-30b-a3b-instruct": {
+        tool_call: true,
+        structured_output: false,
+        cache_control: false,
+        modalities: {
+          input: ["text"]
+        },
+        limit: {
+          context: 16e4,
+          output: 8e3
+        }
+      }
+    }
+  },
+  {
+    id: "zhipu",
+    displayName: "Zhipu AI (GLM)",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://open.bigmodel.cn/api/paas/v4",
+    envVars: ["ZHIPU_API_KEY"],
+    fallbackModels: ["glm-4-plus"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    aliases: ["glm", "z-ai"],
+    models: {
+      "glm-4.7-flash": {
+        name: "GLM-4.7-Flash",
+        release_date: "2026-01-19",
+        attachment: false,
+        reasoning: true,
+        temperature: true,
+        tool_call: true,
+        cost: {
+          input: 0,
+          output: 0,
+          cache_read: 0,
+          cache_write: 0
+        },
+        limit: {
+          context: 202752,
+          output: 8e3
+        },
+        modalities: {
+          input: ["text"],
+          output: ["text"]
+        },
+        structured_output: false,
+        cache_control: false
+      }
+    }
+  },
+  {
+    id: "minimax",
+    displayName: "MiniMax",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.minimax.chat/v1",
+    envVars: ["MINIMAX_API_KEY"],
+    fallbackModels: ["MiniMax-Text-01"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "baichuan",
+    displayName: "Baichuan",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.baichuan-ai.com/v1",
+    envVars: ["BAICHUAN_API_KEY"],
+    fallbackModels: ["Baichuan4"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "voyage",
+    displayName: "Voyage AI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.voyageai.com/v1",
+    envVars: ["VOYAGE_API_KEY"],
+    fallbackModels: ["voyage-3"],
+    capabilities: {
+      supportsToolUse: false,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: false,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "jina",
+    displayName: "Jina AI",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.jina.ai/v1",
+    envVars: ["JINA_API_KEY"],
+    fallbackModels: ["jina-embeddings-v3"],
+    capabilities: {
+      supportsToolUse: false,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: false,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "helicone",
+    displayName: "Helicone (Gateway)",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://oai.helicone.ai/v1",
+    envVars: ["HELICONE_API_KEY", "OPENAI_API_KEY"],
+    fallbackModels: ["gpt-4o-mini"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    },
+    models: {
+      "gpt-4o-mini": {
+        name: "OpenAI GPT-4o-mini",
+        release_date: "2024-07-18",
+        attachment: false,
+        reasoning: false,
+        temperature: true,
+        tool_call: true,
+        cost: {
+          input: 0.15,
+          output: 0.6,
+          cache_read: 0.075
+        },
+        limit: {
+          context: 128e3,
+          output: 16384
+        },
+        modalities: {
+          input: ["text", "image"],
+          output: ["text"]
+        }
+      }
+    }
+  },
+  {
+    id: "portkey",
+    displayName: "Portkey (Gateway)",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.portkey.ai/v1",
+    envVars: ["PORTKEY_API_KEY"],
+    fallbackModels: ["gpt-4o-mini"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: true,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "baseten",
+    displayName: "Baseten",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://bridge.baseten.co/v1",
+    envVars: ["BASETEN_API_KEY"],
+    fallbackModels: ["meta-llama/Meta-Llama-3-70B-Instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: true,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  },
+  {
+    id: "modal",
+    displayName: "Modal",
+    apiMode: "chat_completions",
+    authType: "api_key",
+    baseUrl: "https://api.modal.com/v1",
+    envVars: ["MODAL_TOKEN_ID", "MODAL_TOKEN_SECRET"],
+    fallbackModels: ["meta-llama/Meta-Llama-3-70B-Instruct"],
+    capabilities: {
+      supportsToolUse: true,
+      supportsVision: false,
+      supportsStructuredOutput: false,
+      supportsStreaming: true,
+      supportsCacheControl: false
+    }
+  }
+];
+
+// src/internal/providers/catalog-loader.ts
+var modelInfoIndex = globalSingleton(
+  "theokit-sdk.providers.model-info-index",
+  () => /* @__PURE__ */ new Map()
+);
+var patchedModelKeys = globalSingleton(
+  "theokit-sdk.providers.model-info-patched",
+  () => /* @__PURE__ */ new Set()
+);
+var indexState = globalSingleton("theokit-sdk.providers.model-info-loaded", () => ({
+  loaded: false
+}));
+function getCatalogModelInfo(key) {
+  ensureModelIndexLoaded();
+  return modelInfoIndex.get(key);
+}
+function isPatchedModelKey(key) {
+  return patchedModelKeys.has(key);
+}
+function patchModelInfo(key, model) {
+  ensureModelIndexLoaded();
+  const existing = modelInfoIndex.get(key);
+  modelInfoIndex.set(key, existing === void 0 ? model : { ...existing, ...model });
+  patchedModelKeys.add(key);
+}
+function ensureModelIndexLoaded() {
+  if (indexState.loaded) return;
+  indexState.loaded = true;
+  try {
+    const catalog = loadProviderCatalog();
+    for (const entry of Object.values(catalog)) {
+      indexEntryModels(entry);
+    }
+  } catch (err) {
+    diag(
+      `[theokit-sdk] WARN: provider catalog unavailable (${err.message}) \u2014 per-model data disabled
+`
+    );
+  }
+}
+function indexEntryModels(entry) {
+  if (entry.models === void 0 || typeof entry.models !== "object") return;
+  for (const [modelId, raw] of Object.entries(entry.models)) {
+    const parsed = catalogModelSchema.safeParse(raw);
+    if (!parsed.success) {
+      diag(
+        `[theokit-sdk] WARN: Skipping malformed catalog model "${entry.id}/${modelId}": ${parsed.error.issues[0]?.message ?? "invalid"}
+`
+      );
+      continue;
+    }
+    modelInfoIndex.set(`${entry.id}/${modelId}`, parsed.data);
+    for (const alias of entry.aliases ?? []) {
+      const key = `${alias}/${modelId}`;
+      if (!modelInfoIndex.has(key)) modelInfoIndex.set(key, parsed.data);
+    }
+  }
+}
+function validateEntry(raw) {
+  const parsed = catalogEntrySchema.safeParse(raw);
+  return parsed.success ? parsed.data : null;
+}
+function loadProviderCatalog(opts) {
+  let entries = [...provider_catalog_default];
+  if (opts?._testInjectMalformed) {
+    entries = [
+      ...entries,
+      { id: "malformed-provider", displayName: "Bad" }
+    ];
+  }
+  const result = {};
+  for (const raw of entries) {
+    const validated = validateEntry(raw);
+    if (validated === null) {
+      diag(
+        `[theokit-sdk] WARN: Skipping malformed catalog entry: ${JSON.stringify(raw).slice(0, 100)}
+`
+      );
+      continue;
+    }
+    result[validated.id] = validated;
+  }
+  return result;
+}
+var _capabilitiesCache = null;
+function getCatalogCapabilities(providerId) {
+  if (_capabilitiesCache === null) {
+    const catalog = loadProviderCatalog();
+    _capabilitiesCache = {};
+    for (const entry of Object.values(catalog)) {
+      _capabilitiesCache[entry.id] = entry.capabilities;
+      for (const alias of entry.aliases ?? []) {
+        if (_capabilitiesCache[alias] === void 0) _capabilitiesCache[alias] = entry.capabilities;
+      }
+    }
+  }
+  return _capabilitiesCache[providerId];
+}
+function registerCatalogProviders(opts) {
+  const catalog = loadProviderCatalog(opts);
+  for (const entry of Object.values(catalog)) {
+    if (getProviderProfile(entry.id) !== void 0) continue;
+    if (entry.aliases?.some((a) => getProviderProfile(a) !== void 0)) continue;
+    const profile = {
+      name: entry.id,
+      apiMode: entry.apiMode,
+      authType: entry.authType,
+      baseUrl: entry.baseUrl,
+      envVars: entry.envVars,
+      fallbackModels: entry.fallbackModels,
+      displayName: entry.displayName,
+      aliases: entry.aliases,
+      modelsUrl: entry.modelsUrl,
+      hostname: entry.hostname,
+      extraHeaders: entry.extraHeaders
+    };
+    registerProvider(profile);
+  }
+}
+
+// src/internal/providers/builtin/anthropic.ts
+var ANTHROPIC = {
+  name: "anthropic",
+  apiMode: "anthropic_messages",
+  envVars: ["ANTHROPIC_API_KEY"],
+  authType: "api_key",
+  baseUrl: "https://api.anthropic.com",
+  modelsUrl: "https://api.anthropic.com/v1/models",
+  hostname: "api.anthropic.com",
+  fallbackModels: ["claude-opus-4-7", "claude-sonnet-4-6", "claude-haiku-4-5-20251001"],
+  // M45 — the Anthropic beta-features header (interleaved thinking + fine-grained tool streaming). An
+  // Anthropic API constant. The
+  // SANCTIONED behavior delta of M45 (ADR D4) — consumed by the anthropic transport's extraHeaders wiring.
+  extraHeaders: {
+    "anthropic-beta": "interleaved-thinking-2025-05-14,fine-grained-tool-streaming-2025-05-14"
+  }
+};
+
+// src/internal/providers/builtin/bedrock.ts
+var BEDROCK = {
+  name: "bedrock",
+  apiMode: "bedrock_anthropic",
+  envVars: ["AWS_BEARER_TOKEN_BEDROCK"],
+  authType: "aws_bearer",
+  baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com",
+  modelsUrl: void 0,
+  hostname: "bedrock-runtime.amazonaws.com",
+  fallbackModels: [
+    "bedrock/us.anthropic.claude-sonnet-4-5-v1:0",
+    "bedrock/us.anthropic.claude-opus-4-7-v1:0",
+    "bedrock/global.anthropic.claude-haiku-4-5-v1:0"
+  ]
+};
+function stripBedrockPrefix(modelId) {
+  return modelId.replace(/^bedrock\//, "");
+}
+function inferRegionFromModelId(modelId) {
+  const id = stripBedrockPrefix(modelId);
+  if (id.startsWith("global.")) return "us-east-1";
+  if (id.startsWith("us.")) return process.env.AWS_REGION ?? "us-east-1";
+  if (id.startsWith("eu.")) return process.env.AWS_REGION ?? "eu-west-1";
+  if (id.startsWith("apac.")) return process.env.AWS_REGION ?? "ap-southeast-1";
+  if (id.startsWith("jp.")) return "ap-northeast-1";
+  return void 0;
+}
+function resolveBedrockBaseUrl(modelId) {
+  const region = inferRegionFromModelId(modelId) ?? process.env.AWS_REGION ?? "us-east-1";
+  return `https://bedrock-runtime.${region}.amazonaws.com`;
+}
+
+// src/internal/providers/builtin/openai-compatible.ts
+function openAiCompatibleProfile(p) {
+  return {
+    apiMode: "chat_completions",
+    authType: "api_key",
+    fallbackModels: [],
+    ...p
+  };
+}
+
+// src/internal/providers/builtin/cerebras.ts
+var CEREBRAS = openAiCompatibleProfile({
+  name: "cerebras",
+  baseUrl: "https://api.cerebras.ai/v1",
+  envVars: ["CEREBRAS_API_KEY"],
+  fallbackModels: ["gpt-oss-120b", "zai-glm-4.7"],
+  extraHeaders: { "X-Cerebras-3rd-Party-Integration": "theokit" },
+  hostname: "api.cerebras.ai"
+});
+
+// src/internal/providers/builtin/cohere.ts
+var COHERE = openAiCompatibleProfile({
+  name: "cohere",
+  baseUrl: "https://api.cohere.ai/compatibility/v1",
+  envVars: ["COHERE_API_KEY", "CO_API_KEY"],
+  fallbackModels: ["command-a-03-2025"],
+  hostname: "api.cohere.ai"
+});
+
+// src/internal/providers/builtin/deepinfra.ts
+var DEEPINFRA = openAiCompatibleProfile({
+  name: "deepinfra",
+  baseUrl: "https://api.deepinfra.com/v1/openai",
+  envVars: ["DEEPINFRA_API_KEY"],
+  fallbackModels: ["Qwen/Qwen3-32B"],
+  hostname: "api.deepinfra.com"
+});
+
+// src/internal/providers/builtin/gemini.ts
+var GEMINI = {
+  name: "gemini",
+  apiMode: "chat_completions",
+  envVars: ["OPENROUTER_API_KEY"],
+  authType: "api_key",
+  baseUrl: "https://openrouter.ai/api",
+  hostname: "openrouter.ai",
+  fallbackModels: ["google/gemini-2.0-flash-001"]
+};
+
+// src/internal/providers/builtin/google.ts
+var GOOGLE = openAiCompatibleProfile({
+  name: "google",
+  baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+  envVars: ["GOOGLE_API_KEY", "GEMINI_API_KEY", "GOOGLE_GENERATIVE_AI_API_KEY"],
+  fallbackModels: ["gemini-2.5-pro", "gemini-2.5-flash"],
+  hostname: "generativelanguage.googleapis.com"
+});
+
+// src/internal/providers/builtin/groq.ts
+var GROQ = openAiCompatibleProfile({
+  name: "groq",
+  baseUrl: "https://api.groq.com/openai/v1",
+  envVars: ["GROQ_API_KEY"],
+  fallbackModels: ["llama-3.3-70b-versatile", "llama-3.1-8b-instant"],
+  hostname: "api.groq.com"
+});
+
+// src/internal/providers/builtin/llamacpp.ts
+var LLAMACPP = {
+  name: "llamacpp",
+  aliases: ["llama-cpp", "llama.cpp"],
+  apiMode: "chat_completions",
+  envVars: ["LLAMACPP_API_KEY"],
+  authType: "none",
+  baseUrl: "http://localhost:8080",
+  modelsUrl: "http://localhost:8080/v1/models",
+  hostname: "localhost",
+  fallbackModels: ["loaded-model"]
+};
+
+// src/internal/providers/builtin/lmstudio.ts
+var LMSTUDIO = {
+  name: "lmstudio",
+  aliases: ["lm-studio", "lm_studio"],
+  apiMode: "chat_completions",
+  envVars: ["LMSTUDIO_API_KEY"],
+  authType: "none",
+  baseUrl: "http://localhost:1234",
+  modelsUrl: "http://localhost:1234/v1/models",
+  hostname: "localhost",
+  fallbackModels: ["loaded-model"]
+};
+
+// src/internal/providers/builtin/mistral.ts
+var MISTRAL = openAiCompatibleProfile({
+  name: "mistral",
+  baseUrl: "https://api.mistral.ai/v1",
+  envVars: ["MISTRAL_API_KEY"],
+  fallbackModels: ["mistral-large-latest", "codestral-latest"],
+  hostname: "api.mistral.ai"
+});
+
+// src/internal/providers/builtin/ollama.ts
+var OLLAMA = {
+  name: "ollama",
+  apiMode: "chat_completions",
+  envVars: ["OLLAMA_API_KEY"],
+  authType: "none",
+  baseUrl: "http://localhost:11434",
+  modelsUrl: "http://localhost:11434/v1/models",
+  hostname: "localhost",
+  fallbackModels: ["llama3.2", "qwen2.5", "mistral"]
+};
+
+// src/internal/providers/builtin/openai.ts
+var OPENAI = {
+  name: "openai",
+  apiMode: "chat_completions",
+  envVars: ["OPENAI_API_KEY"],
+  authType: "api_key",
+  baseUrl: "https://api.openai.com",
+  modelsUrl: "https://api.openai.com/v1/models",
+  hostname: "api.openai.com",
+  fallbackModels: ["gpt-4o", "gpt-4o-mini"]
+};
+var DEFAULT_STORE = {
+  home: homedir(),
+  dirName: ".theokit",
+  fileName: "auth.json",
+  homeEnvVar: "THEOKIT_AUTH_HOME"
+};
+var OPENAI_OAUTH_CONFIG = {
+  provider: "openai",
+  authorizeEndpoint: "https://auth.openai.com/oauth/authorize",
+  tokenEndpoint: "https://auth.openai.com/oauth/token",
+  clientId: "app_EMoamEEZ73f0CkXaXp7hrann",
+  scopes: ["openid", "profile", "email", "offline_access"],
+  redirectUri: "https://auth.openai.com/deviceauth/callback"
+};
+function codexFetch() {
+  return (async (input, init) => {
+    const env = process.env;
+    const resolved = await resolveCredential({
+      provider: "openai",
+      store: DEFAULT_STORE,
+      oauth: OPENAI_OAUTH_CONFIG,
+      env
+    });
+    if (resolved === void 0) {
+      throw new AuthenticationError(
+        'openai-chatgpt: no ChatGPT credential found \u2014 run the OpenAI device login (e.g. "/login openai") first.',
+        { code: "missing_credential" }
+      );
+    }
+    const accountId = readStoredOAuth(DEFAULT_STORE, env)?.account_id;
+    const headers = new Headers(init?.headers);
+    headers.set("authorization", `Bearer ${resolved.apiKey}`);
+    if (accountId !== void 0) headers.set("ChatGPT-Account-Id", accountId);
+    return fetch(input, { ...init, headers });
+  });
+}
+var OPENAI_CHATGPT = {
+  name: "openai-chatgpt",
+  apiMode: "responses_api",
+  authType: "oauth_device_code",
+  baseUrl: "https://chatgpt.com/backend-api/codex",
+  envVars: [],
+  fallbackModels: [
+    "openai-chatgpt/gpt-5.4",
+    "openai-chatgpt/gpt-5.4-mini",
+    "openai-chatgpt/gpt-5.5"
+  ],
+  // #165 — this shipped as `codex_cli_rs`, another vendor's client identifier. Claiming to be a different
+  // vendor's client is a false statement of identity. Third-party clients send their OWN name against
+  // this same endpoint, which also shows the route is not restricted to the official client.
+  extraHeaders: { originator: "theokit" },
+  // usetheokit/theokit-sdk#383 — carry the model's encrypted reasoning between the rounds of a turn.
+  // On for THIS profile and no other because this is the endpoint the issue measured: OpenAI Codex
+  // sends `include: ["reasoning.encrypted_content"]` with `reasoning.context: "all_turns"` to the
+  // same backend, same model, on the same account, so acceptance is observed rather than assumed.
+  // The issue's measurement — a third of our bytes, 2.8x our tokens — is what this closes together
+  // with `prompt_cache_key`.
+  encryptedReasoning: true,
+  transform: {
+    // Only `fetch` (async) can await the credential refresh; `headers` is sync and cannot.
+    fetch: () => codexFetch()
+  }
+};
+
+// src/internal/providers/builtin/openrouter.ts
+var OPENROUTER = {
+  name: "openrouter",
+  apiMode: "chat_completions",
+  aliases: ["or"],
+  // Ordered fallback (EC-10): OPENROUTER_API_KEY preferred, OPENAI_API_KEY as compat.
+  envVars: ["OPENROUTER_API_KEY", "OPENAI_API_KEY"],
+  authType: "api_key",
+  baseUrl: "https://openrouter.ai/api",
+  modelsUrl: "https://openrouter.ai/api/v1/models",
+  hostname: "openrouter.ai",
+  // M45 — models refreshed (claude-3-haiku retired upstream).
+  fallbackModels: ["openai/gpt-4o-mini", "anthropic/claude-haiku-4-5"],
+  // M45 — OpenRouter app-attribution headers. VALUES are
+  // theokit's own — copying another app's referer would misattribute traffic).
+  extraHeaders: { "HTTP-Referer": "https://usetheo.dev", "X-Title": "theokit" }
+};
+
+// src/internal/providers/builtin/perplexity.ts
+var PERPLEXITY = openAiCompatibleProfile({
+  name: "perplexity",
+  baseUrl: "https://api.perplexity.ai",
+  chatCompletionsPath: "/chat/completions",
+  envVars: ["PERPLEXITY_API_KEY"],
+  fallbackModels: ["sonar-pro", "sonar"],
+  hostname: "api.perplexity.ai"
+});
+
+// src/internal/providers/builtin/together.ts
+var TOGETHER = openAiCompatibleProfile({
+  name: "together",
+  aliases: ["togetherai"],
+  baseUrl: "https://api.together.xyz/v1",
+  envVars: ["TOGETHER_API_KEY"],
+  fallbackModels: ["Qwen/Qwen2.5-7B-Instruct-Turbo"],
+  hostname: "api.together.xyz"
+});
+
+// src/internal/providers/builtin/vertex.ts
+var VERTEX = {
+  name: "vertex",
+  apiMode: "anthropic_messages",
+  // sub-dispatched in selectTransport by profile.name
+  envVars: ["GOOGLE_APPLICATION_CREDENTIALS"],
+  authType: "gcp_oauth",
+  baseUrl: "https://us-central1-aiplatform.googleapis.com",
+  modelsUrl: void 0,
+  hostname: "aiplatform.googleapis.com",
+  fallbackModels: [
+    "vertex/anthropic/claude-sonnet-4-5@20250929",
+    "vertex/google/gemini-2.0-flash-001"
+  ]
+};
+function resolveVertexBaseUrl(opts) {
+  const host = opts.location === "global" ? "aiplatform.googleapis.com" : `${opts.location}-aiplatform.googleapis.com`;
+  if (opts.modelDialect === "gemini") {
+    return `https://${host}/v1/projects/${opts.projectId}/locations/${opts.location}/endpoints/openapi`;
+  }
+  return `https://${host}/v1/projects/${opts.projectId}/locations/${opts.location}/publishers/anthropic`;
+}
+function inferModelDialect(modelId) {
+  if (modelId.includes("/anthropic/")) return "anthropic";
+  if (modelId.includes("/google/")) return "gemini";
+  return "gemini";
+}
+function stripVertexPrefix(modelId) {
+  return modelId.replace(/^vertex\/(anthropic|google)\//, "");
+}
+
+// src/internal/providers/builtin/xai.ts
+var XAI = openAiCompatibleProfile({
+  name: "xai",
+  aliases: ["grok"],
+  baseUrl: "https://api.x.ai/v1",
+  envVars: ["XAI_API_KEY"],
+  fallbackModels: ["grok-4.5", "grok-4.3"],
+  hostname: "api.x.ai"
+});
+
+// src/internal/providers/builtin/index.ts
+var _registeredState = globalSingleton("theokit-sdk.providers.builtins-registered", () => ({
+  done: false
+}));
+function registerBuiltins() {
+  if (_registeredState.done) return;
+  _registeredState.done = true;
+  registerProvider(ANTHROPIC);
+  registerProvider(OPENAI);
+  registerProvider(OPENAI_CHATGPT);
+  registerProvider(OPENROUTER);
+  registerProvider(GEMINI);
+  registerProvider(OLLAMA);
+  registerProvider(LMSTUDIO);
+  registerProvider(LLAMACPP);
+  registerProvider(BEDROCK);
+  registerProvider(VERTEX);
+  registerProvider(GOOGLE);
+  registerProvider(MISTRAL);
+  registerProvider(GROQ);
+  registerProvider(COHERE);
+  registerProvider(DEEPINFRA);
+  registerProvider(TOGETHER);
+  registerProvider(XAI);
+  registerProvider(PERPLEXITY);
+  registerProvider(CEREBRAS);
+  registerCatalogProviders();
+}
+
+export { catalogModelSchema, getCatalogCapabilities, getCatalogModelInfo, getProviderProfile, inferModelDialect, inferRegionFromModelId, isPatchedModelKey, listProviders, loadProviderCatalog, patchModelInfo, registerBuiltins, registerProvider, resolveBedrockBaseUrl, resolveVertexBaseUrl, stripBedrockPrefix, stripVertexPrefix };
+//# sourceMappingURL=chunk-SVCPJRUB.js.map
+//# sourceMappingURL=chunk-SVCPJRUB.js.map