@theokit/sdk 4.14.0 → 4.14.1

package/dist/internal/llm/openai.d.ts

@@ -1,4 +1,32 @@
 import type { LlmClient, LlmEvent, LlmFinish, LlmRequest } from "./types.js";
+export interface OpenAIClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    organization?: string;
+    fetch?: typeof fetch;
+    /**
+     * Provider name for error mapping dispatch (T1.1, ADR D185). When set
+     * to `"ollama"`, transport and HTTP errors go through `mapOllamaTransportError`
+     * / `mapOllamaHttpError` for actionable messages before falling back to
+     * the generic OpenAI-compatible mapper. Default `"openai"`.
+     */
+    providerName?: string;
+    /**
+     * Opt-in leaked-dialect safe-parse (theokit#58 follow-up). When `true`, a finish that carries
+     * ZERO native `tool_calls` has its assistant text scanned for the Hermes `<function=…></tool_call>`
+     * dialect; any recovered calls are surfaced as real `tool_calls` so the loop executes them.
+     * Default `false` — a code assistant can legitimately print a literal `<function=` in code text.
+     */
+    extractToolCallsFromContent?: boolean;
+    /**
+     * M41 — extra HTTP headers merged into the request (the profile's static `extraHeaders` + a provider
+     * `transform.headers(ctx)`). Spread AFTER the base `authorization`/`content-type`, so a provider that owns
+     * its auth CAN override them by design (document this on `ProviderTransform.headers`).
+     */
+    extraHeaders?: Record<string, string>;
+    /** M45 — explicit chat-completions path (from `ProviderProfile.chatCompletionsPath`). */
+    chatCompletionsPath?: string;
+}
 interface OpenAIDeltaChunk {
     choices?: Array<{
         index: number;

package/dist/internal/providers/builtin/cohere.d.ts

@@ -1,6 +1,8 @@
 /**
  * M45 — Cohere via its OpenAI-compatibility surface (`api.cohere.ai/compatibility/v1` — the native v2 API
  * is NOT chat_completions; the discovery flagged the old catalog baseUrl as doubly wrong). Models per
- * models.dev `cohere` (2026-07 snapshot).
+ * models.dev `cohere` (2026-07 snapshot). SOURCE NOTE (review L2): the compatibility endpoint + `CO_API_KEY`
+ * come from Cohere's own docs/python-SDK convention (not vendored in this repo's references) — verify with a
+ * live smoke when a key is available.
  */
 export declare const COHERE: import("../types.js").ProviderProfile;

package/dist/models.cjs

@@ -445,11 +445,22 @@ var DEEPINFRA = openAiCompatibleProfile({
   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"],
+  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"
 });
@@ -463,56 +474,6 @@ var GROQ = openAiCompatibleProfile({
   hostname: "api.groq.com"
 });
 
-// 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/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/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/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/llamacpp.ts
 var LLAMACPP = {
   name: "llamacpp",
@@ -539,6 +500,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",
@@ -933,6 +903,26 @@ var OPENROUTER = {
   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",
@@ -949,11 +939,26 @@ var VERTEX = {
   ]
 };
 
+// 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 registered = 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 (registered) return;
-  registered = true;
+  if (_registeredState.done) return;
+  _registeredState.done = true;
   registerProvider(ANTHROPIC);
   registerProvider(OPENAI);
   registerProvider(OPENAI_CHATGPT);