@theokit/sdk 4.13.1 → 4.14.1

package/dist/index.cjs

@@ -758,13 +758,13 @@ function setAgentFacade(facade) {
   globalThis[FACADE_KEY] = facade;
 }
 function getAgentFacade() {
-  const registered3 = globalThis[FACADE_KEY];
-  if (registered3 === void 0) {
+  const registered2 = globalThis[FACADE_KEY];
+  if (registered2 === void 0) {
     throw new Error(
       "internal: Agent facade not registered. The `agent.ts` module must be loaded before internal subsystems (LocalAgent.runUntil/fork, eval, scorers, cron) invoke it."
     );
   }
-  return registered3;
+  return registered2;
 }
 var FACADE_KEY;
 var init_agent_factory_registry = __esm({
@@ -13247,6 +13247,9 @@ function getCatalogCapabilities(providerId) {
     _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];
@@ -14003,7 +14006,13 @@ var ANTHROPIC = {
   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"]
+  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, adapted verbatim from OpenCode's anthropic plugin (MIT © 2025 opencode). 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
@@ -14038,6 +14047,44 @@ function resolveBedrockBaseUrl(modelId) {
   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",
@@ -14049,6 +14096,24 @@ var GEMINI = {
   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",
@@ -14075,6 +14140,15 @@ var LMSTUDIO = {
   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",
@@ -14462,9 +14536,33 @@ var OPENROUTER = {
   baseUrl: "https://openrouter.ai/api",
   modelsUrl: "https://openrouter.ai/api/v1/models",
   hostname: "openrouter.ai",
-  fallbackModels: ["openai/gpt-4o-mini", "anthropic/claude-3-haiku"]
+  // M45 — models refreshed (claude-3-haiku retired upstream).
+  fallbackModels: ["openai/gpt-4o-mini", "anthropic/claude-haiku-4-5"],
+  // M45 — OpenRouter app-attribution headers (mechanism from OpenCode's openrouter plugin, MIT; 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",
@@ -14496,11 +14594,26 @@ 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 registered2 = false;
+var _registeredState = (() => {
+  const g = globalThis;
+  const sym = /* @__PURE__ */ Symbol.for("theokit-sdk.providers.builtins-registered");
+  if (g[sym] === void 0) g[sym] = { done: false };
+  return g[sym];
+})();
 function registerBuiltins() {
-  if (registered2) return;
-  registered2 = true;
+  if (_registeredState.done) return;
+  _registeredState.done = true;
   registerProvider(ANTHROPIC);
   registerProvider(OPENAI);
   registerProvider(OPENAI_CHATGPT);
@@ -14511,6 +14624,15 @@ function registerBuiltins() {
   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();
 }
 
@@ -14779,14 +14901,16 @@ var AnthropicClient = class {
   // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: HTTP+SSE handshake + accumulator is intentionally one block
   async *stream(request, signal) {
     const body = buildAnthropicBody(request);
+    const headers = {
+      "content-type": "application/json",
+      "x-api-key": this.options.apiKey,
+      "anthropic-version": this.options.version ?? "2023-06-01"
+    };
+    if (this.options.extraHeaders !== void 0) Object.assign(headers, this.options.extraHeaders);
     const response = await this.fetchImpl(`${this.baseUrl}/v1/messages`, {
       method: "POST",
       signal,
-      headers: {
-        "content-type": "application/json",
-        "x-api-key": this.options.apiKey,
-        "anthropic-version": this.options.version ?? "2023-06-01"
-      },
+      headers,
       body: JSON.stringify(body)
     });
     if (!response.ok) {
@@ -15659,15 +15783,24 @@ var StreamSuppressionBuffer = class {
 };
 
 // src/internal/llm/openai.ts
+function deriveChatPath(baseUrl) {
+  try {
+    return /\/v\d+[a-z]*(\/|$)/.test(new URL(baseUrl).pathname) ? "/chat/completions" : "/v1/chat/completions";
+  } catch {
+    return "/v1/chat/completions";
+  }
+}
 var OpenAIClient = class {
   constructor(options) {
     this.options = options;
-    this.baseUrl = options.baseUrl ?? "https://api.openai.com";
+    this.baseUrl = (options.baseUrl ?? "https://api.openai.com").replace(/\/+$/, "");
+    this.chatPath = options.chatCompletionsPath ?? deriveChatPath(this.baseUrl);
     this.fetchImpl = options.fetch ?? fetch;
   }
   options;
   name = "openai";
   baseUrl;
+  chatPath;
   fetchImpl;
   /**
    * Whether this client recovers leaked Hermes tool-call dialect from assistant
@@ -15690,7 +15823,7 @@ var OpenAIClient = class {
     const providerId = this.options.providerName ?? this.name;
     let response;
     try {
-      response = await this.fetchImpl(`${this.baseUrl}/v1/chat/completions`, {
+      response = await this.fetchImpl(`${this.baseUrl}${this.chatPath}`, {
         method: "POST",
         signal,
         headers,
@@ -16787,6 +16920,9 @@ function selectTransport(profile, apiKey) {
     if (profile.extractToolCallsFromContent === true) {
       opts.extractToolCallsFromContent = true;
     }
+    if (profile.chatCompletionsPath !== void 0) {
+      opts.chatCompletionsPath = profile.chatCompletionsPath;
+    }
     if (profile.name === "openai" && process.env.OPENAI_ORGANIZATION !== void 0) {
       opts.organization = process.env.OPENAI_ORGANIZATION;
     }
@@ -16806,6 +16942,11 @@ function selectTransport(profile, apiKey) {
     }
     const opts = { apiKey };
     opts.baseUrl = process.env.ANTHROPIC_API_BASE_URL ?? profile.baseUrl;
+    const t = applyTransform();
+    assertOAuthResolved(t);
+    if (t.fetch !== void 0) opts.fetch = t.fetch;
+    const merged = profile.extraHeaders !== void 0 || t.headers !== void 0 ? { ...profile.extraHeaders, ...t.headers } : void 0;
+    if (merged !== void 0) opts.extraHeaders = merged;
     return new AnthropicClient(opts);
   }
   if (profile.apiMode === "bedrock_anthropic") {
@@ -17124,12 +17265,12 @@ function resolveMcpCwd(configCwd) {
 
 // src/internal/providers/register-plugin-providers.ts
 function registerPluginProviderProfiles(entries) {
-  let registered3 = 0;
+  let registered2 = 0;
   for (const entry of entries) {
     registerProvider(entry.profile);
-    registered3 += 1;
+    registered2 += 1;
   }
-  return registered3;
+  return registered2;
 }
 
 // src/internal/local-agent/real-local-run.ts
@@ -17454,12 +17595,12 @@ var pluginProvidersAnnounced = false;
 function resolveRunProvider(options) {
   registerBuiltins();
   const profiles = options.pluginManager?.aggregated.providerProfiles ?? [];
-  const registered3 = registerPluginProviderProfiles(profiles);
-  if (registered3 > 0 && !pluginProvidersAnnounced) {
+  const registered2 = registerPluginProviderProfiles(profiles);
+  if (registered2 > 0 && !pluginProvidersAnnounced) {
     pluginProvidersAnnounced = true;
     const names = profiles.map((e) => e.profile.name).join(", ");
     process.stderr.write(
-      `[theokit-sdk] registered ${registered3} plugin provider profile(s): ${names}
+      `[theokit-sdk] registered ${registered2} plugin provider profile(s): ${names}
 `
     );
   }