@theokit/sdk 4.13.1 → 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;
@@ -59,6 +87,7 @@ export declare class OpenAIClient implements LlmClient {
     private readonly options;
     readonly name = "openai";
     private readonly baseUrl;
+    private readonly chatPath;
     private readonly fetchImpl;
     constructor(options: OpenAIClientOptions);
     stream(request: LlmRequest, signal: AbortSignal): AsyncGenerator<LlmEvent, LlmFinish, void>;

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

@@ -0,0 +1,5 @@
+/**
+ * M45 — Cerebras. Integration header adapted from OpenCode's `cerebras.ts` (MIT — value changed to
+ * `theokit`, never `opencode`: the header attributes TRAFFIC). Models per models.dev (2026-07 snapshot).
+ */
+export declare const CEREBRAS: import("../types.js").ProviderProfile;

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

@@ -0,0 +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). 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/internal/providers/builtin/deepinfra.d.ts

@@ -0,0 +1,2 @@
+/** M45 — DeepInfra. OpenAI-compat surface under /v1/openai (models.dev `deepinfra`, OpenCode profile map). */
+export declare const DEEPINFRA: import("../types.js").ProviderProfile;

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

@@ -0,0 +1,6 @@
+/**
+ * M45 — Google Gemini via the DIRECT OpenAI-compat endpoint (a Google API key, not OpenRouter). Distinct
+ * from the `gemini` builtin (an OpenRouter passthrough) by ADR D3 — two routes, two names. Endpoint + env
+ * vars per Google's OpenAI-compatibility docs (mirrored by models.dev `google` + the M44 catalog entry).
+ */
+export declare const GOOGLE: import("../types.js").ProviderProfile;

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

@@ -0,0 +1,2 @@
+/** M45 — Groq. Values per models.dev `groq` (2026-07 snapshot); OpenAI-compat surface under /openai/v1. */
+export declare const GROQ: import("../types.js").ProviderProfile;

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

@@ -0,0 +1,2 @@
+/** M45 — Mistral (La Plateforme). Values per models.dev `mistral` (2026-07 snapshot). */
+export declare const MISTRAL: import("../types.js").ProviderProfile;

package/dist/internal/providers/builtin/openai-compatible.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,5 @@
+/**
+ * M45 — Perplexity. Its endpoint is UNVERSIONED (`/chat/completions`) — the explicit `chatCompletionsPath`
+ * escape expresses it (the sonar-online model family was retired; models per models.dev `perplexity`).
+ */
+export declare const PERPLEXITY: import("../types.js").ProviderProfile;

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

@@ -0,0 +1,2 @@
+/** M45 — Together AI (models.dev id `togetherai` — kept as an alias). Values per the 2026-07 snapshot. */
+export declare const TOGETHER: import("../types.js").ProviderProfile;

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

@@ -0,0 +1,2 @@
+/** M45 — xAI (Grok). Values per models.dev `xai` (2026-07 snapshot; grok-2 retired). */
+export declare const XAI: import("../types.js").ProviderProfile;

package/dist/models.cjs

@@ -382,7 +382,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
@@ -401,6 +407,44 @@ var BEDROCK = {
   ]
 };
 
+// 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",
@@ -412,6 +456,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",
@@ -438,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",
@@ -825,9 +896,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",
@@ -844,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);
@@ -859,6 +969,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();
 }