@theokit/sdk 5.14.0 → 5.15.1

package/dist/{chunk-SNVYOX46.cjs → chunk-3E3VSMB6.cjs}

@@ -1,15 +1,15 @@
 'use strict';
 
-var chunkSXH37C7X_cjs = require('./chunk-SXH37C7X.cjs');
+var chunk55LLQFHW_cjs = require('./chunk-55LLQFHW.cjs');
 var chunkYJNYDJ2T_cjs = require('./chunk-YJNYDJ2T.cjs');
-var chunkNP362THY_cjs = require('./chunk-NP362THY.cjs');
+var chunk3F53FLQ7_cjs = require('./chunk-3F53FLQ7.cjs');
 var chunkQOGNZMHD_cjs = require('./chunk-QOGNZMHD.cjs');
 var chunkYSTXFWQE_cjs = require('./chunk-YSTXFWQE.cjs');
 var chunkFRITRLZQ_cjs = require('./chunk-FRITRLZQ.cjs');
 var chunk3WKWBYPO_cjs = require('./chunk-3WKWBYPO.cjs');
 var chunkKX5QXLBS_cjs = require('./chunk-KX5QXLBS.cjs');
 var chunk3EE6LVWT_cjs = require('./chunk-3EE6LVWT.cjs');
-var chunk4TEGFMSP_cjs = require('./chunk-4TEGFMSP.cjs');
+var chunkP7QYG4RZ_cjs = require('./chunk-P7QYG4RZ.cjs');
 var chunkNVXXWAU7_cjs = require('./chunk-NVXXWAU7.cjs');
 var chunk5645PMVU_cjs = require('./chunk-5645PMVU.cjs');
 var chunkEHD25JBZ_cjs = require('./chunk-EHD25JBZ.cjs');
@@ -116,7 +116,7 @@ async function loadOne(dir, entryName) {
       if (plugin !== null && typeof plugin === "object" && plugin.kind === "model-provider") {
         const profile = plugin.profile;
         if (profile !== void 0 && typeof profile === "object") {
-          chunk4TEGFMSP_cjs.registerProvider(profile);
+          chunkP7QYG4RZ_cjs.registerProvider(profile);
         }
       }
       return;
@@ -134,7 +134,7 @@ function mapAnthropicError(args) {
   const { status, body, headers, endpoint } = args;
   const code = mapAnthropicStatusToCode(status, body);
   const message = formatMessage(status, code);
-  const metadata = chunkNP362THY_cjs.buildErrorMetadata({
+  const metadata = chunk3F53FLQ7_cjs.buildErrorMetadata({
     provider: "anthropic",
     endpoint,
     code,
@@ -148,7 +148,7 @@ function mapAnthropicError(args) {
   if (status === 429) {
     return new chunkCEGU5AVD_cjs.RateLimitError(message, { code: "anthropic_rate_limit", metadata });
   }
-  if (status === 400) {
+  if (status === 400 || code === "model_unavailable") {
     return new chunkCEGU5AVD_cjs.ConfigurationError(message, {
       code: `anthropic_${code}`,
       metadata
@@ -163,17 +163,23 @@ function mapAnthropicError(args) {
   return new chunkCEGU5AVD_cjs.UnknownAgentError(message, { code: "anthropic_unknown", metadata });
 }
 function mapAnthropicStatusToCode(status, body) {
-  if (status === 400) {
-    const text = JSON.stringify(body ?? "").toLowerCase();
-    if (text.includes("context") && (text.includes("too long") || text.includes("too_long") || text.includes("length"))) {
-      return "context_too_long";
-    }
-    if (text.includes("filtered") || text.includes("content policy") || text.includes("content_policy")) {
-      return "content_filtered";
-    }
-    return "invalid_request";
+  if (status === 400) return classify400(body);
+  if (status === 404 && isModelNotFound(body)) return "model_unavailable";
+  return chunk3F53FLQ7_cjs.httpStatusToErrorCode(status);
+}
+function classify400(body) {
+  const text = JSON.stringify(body ?? "").toLowerCase();
+  if (text.includes("context") && (text.includes("too long") || text.includes("too_long") || text.includes("length"))) {
+    return "context_too_long";
   }
-  return chunkNP362THY_cjs.httpStatusToErrorCode(status);
+  if (text.includes("filtered") || text.includes("content policy") || text.includes("content_policy")) {
+    return "content_filtered";
+  }
+  return "invalid_request";
+}
+function isModelNotFound(body) {
+  const error = body?.error;
+  return error?.type === "not_found_error" && typeof error.message === "string" && /^model\b/i.test(error.message);
 }
 function formatMessage(status, code) {
   return `Anthropic API error: ${code} (HTTP ${status})`;
@@ -577,6 +583,12 @@ var CONTENT_FRAMES = /* @__PURE__ */ new Set([
   "content_block_delta",
   "message_delta"
 ]);
+function redactedParseCause(err) {
+  const name = err instanceof Error ? err.name : "Error";
+  const cause = new Error(`${name}: frame body is not valid JSON (body withheld)`);
+  cause.name = name;
+  return cause;
+}
 function parseAnthropicFrame(record) {
   try {
     return JSON.parse(record.data);
@@ -586,7 +598,7 @@ function parseAnthropicFrame(record) {
     if (CONTENT_FRAMES.has(event)) {
       throw new chunkCEGU5AVD_cjs.NetworkError(
         `Anthropic SSE ${event} frame (${size}) is not valid JSON; the turn would lose content`,
-        { code: "stream_malformed_frame", cause: parseErr }
+        { code: "stream_malformed_frame", cause: redactedParseCause(parseErr) }
       );
     }
     chunkRNXXYF22_cjs.diag(
@@ -755,10 +767,10 @@ function classifyBedrockError(args, awsType, message) {
     return "invalid_request";
   }
   if (awsType.includes("Timeout")) return "timeout";
-  return chunkNP362THY_cjs.httpStatusToErrorCode(args.status);
+  return chunk3F53FLQ7_cjs.httpStatusToErrorCode(args.status);
 }
 function buildBedrockMetadata(args, code) {
-  return chunkNP362THY_cjs.buildErrorMetadata({
+  return chunk3F53FLQ7_cjs.buildErrorMetadata({
     provider: "bedrock",
     endpoint: args.endpoint,
     code,
@@ -768,7 +780,7 @@ function buildBedrockMetadata(args, code) {
   });
 }
 function mapBedrockError(args) {
-  const parsed = chunkNP362THY_cjs.parseErrorBody(args.body);
+  const parsed = chunk3F53FLQ7_cjs.parseErrorBody(args.body);
   const awsType = parsed.__type ?? "";
   const message = parsed.message ?? parsed.Message ?? "Bedrock request failed";
   const code = classifyBedrockError(args, awsType, message);
@@ -802,7 +814,7 @@ async function resolveBedrockToken(region) {
     return cachedToken.value;
   }
   try {
-    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-SNVYOX46.cjs', document.baseURI).href)));
+    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-3E3VSMB6.cjs', document.baseURI).href)));
     const gen = r("@aws/bedrock-token-generator");
     if (typeof gen.getToken !== "function") return void 0;
     const providers = r("@aws-sdk/credential-providers");
@@ -836,10 +848,10 @@ var BedrockAnthropicClient = class {
     );
   }
   async *stream(request, signal) {
-    const region = chunk4TEGFMSP_cjs.inferRegionFromModelId(request.model) ?? process.env.AWS_REGION ?? "us-east-1";
+    const region = chunkP7QYG4RZ_cjs.inferRegionFromModelId(request.model) ?? process.env.AWS_REGION ?? "us-east-1";
     const token = await this.resolveTokenOrThrow(region);
-    const bareModel = chunk4TEGFMSP_cjs.stripBedrockPrefix(request.model);
-    const baseUrl = this.options.baseUrl ?? chunk4TEGFMSP_cjs.resolveBedrockBaseUrl(request.model);
+    const bareModel = chunkP7QYG4RZ_cjs.stripBedrockPrefix(request.model);
+    const baseUrl = this.options.baseUrl ?? chunkP7QYG4RZ_cjs.resolveBedrockBaseUrl(request.model);
     const endpoint = `/model/${encodeURIComponent(bareModel)}/invoke`;
     const url = `${baseUrl}${endpoint}`;
     const response = await postAnthropicRequest({
@@ -894,7 +906,7 @@ var FaultInjectingLlmClient = class {
       return yield* this.inner.stream(request, signal);
     }
     if (parsed.status >= 400) {
-      throw chunkNP362THY_cjs.mapOpenAICompatibleError({
+      throw chunk3F53FLQ7_cjs.mapOpenAICompatibleError({
         providerId: this.name,
         status: parsed.status,
         body: parsed.body,
@@ -969,7 +981,7 @@ function mapOllamaTransportError(args) {
   if (args.providerId !== "ollama") return void 0;
   const causeCode = extractCauseCode(args.cause);
   if (causeCode !== "ECONNREFUSED" && causeCode !== "ENOTFOUND") return void 0;
-  const metadata = chunkNP362THY_cjs.buildErrorMetadata({
+  const metadata = chunk3F53FLQ7_cjs.buildErrorMetadata({
     provider: "ollama",
     endpoint: args.endpoint,
     code: "network",
@@ -987,7 +999,7 @@ function mapOllamaHttpError(args) {
   const errString = extractErrorString(args.body).toLowerCase();
   if (args.status === 404 && errString.includes("not found") && errString.includes("pull")) {
     const modelHint = extractModelName(errString);
-    const metadata = chunkNP362THY_cjs.buildErrorMetadata({
+    const metadata = chunk3F53FLQ7_cjs.buildErrorMetadata({
       provider: "ollama",
       endpoint: args.endpoint,
       code: "model_unavailable",
@@ -1002,7 +1014,7 @@ function mapOllamaHttpError(args) {
     );
   }
   if (args.status === 503 && errString.includes("model is loading")) {
-    const metadata = chunkNP362THY_cjs.buildErrorMetadata({
+    const metadata = chunk3F53FLQ7_cjs.buildErrorMetadata({
       provider: "ollama",
       endpoint: args.endpoint,
       code: "server_error",
@@ -1089,7 +1101,7 @@ var OllamaNativeClient = class {
         endpoint: "/api/chat"
       });
       if (mapped !== void 0) throw mapped;
-      throw chunkNP362THY_cjs.mapOpenAICompatibleError({
+      throw chunk3F53FLQ7_cjs.mapOpenAICompatibleError({
         providerId: "ollama",
         status: response.status,
         body: bodyJson,
@@ -1395,7 +1407,12 @@ function netOfCache(total, cacheReadTokens, cacheWriteTokens) {
 function normalizeOpenAIChat(raw) {
   const outputTokens = int(raw.completion_tokens);
   const completionDetails = raw.completion_tokens_details ?? {};
-  const split = splitChatCompletionsPrompt(raw);
+  const rawDetails = raw.prompt_tokens_details ?? {};
+  const details = { ...rawDetails };
+  for (const key of ["cached_tokens", "cache_write_tokens"]) {
+    if (sent(details[key]) && Number.isNaN(strictCount(details[key]))) details[key] = 0;
+  }
+  const split = splitChatCompletionsPrompt({ ...raw, prompt_tokens_details: details });
   const inputTokens = int(split.inputTokens);
   const cacheReadTokens = int(split.cacheReadTokens);
   const cacheWriteTokens = int(split.cacheWriteTokens);
@@ -1525,16 +1542,38 @@ function pickString(record, key) {
 // src/internal/llm/hermes-tool-extract.ts
 var HERMES_BLOCK = /<function=\s*([^>\s]+)\s*>([\s\S]*?)<\/tool_call>/g;
 var HERMES_PARAM = /<parameter=\s*([^>\s]+)\s*>([\s\S]*?)<\/parameter>/g;
+var CTRL_CALL_SRC = String.raw`print\(\s*default_api\.([A-Za-z_]\w*)\(([\s\S]*?)\)\s*\)(?=\s*(?:print\(\s*default_api\.|<ctrl\d+>|$))`;
+var CTRL_BLOCK = new RegExp(`<ctrl42>call\\s*((?:${CTRL_CALL_SRC}\\s*)+)(?=<ctrl\\d+>|$)`, "g");
+var CTRL_MARKER = "<ctrl42>call";
+var CTRL_PREFIX = "print(default_api.";
 function extractHermesToolCalls(content, makeId, allowedToolNames) {
   const isPromoted = (name) => name.length > 0 && (allowedToolNames === void 0 || allowedToolNames.has(name));
   const toolCalls = [];
   const droppedNames = [];
+  const formats = /* @__PURE__ */ new Set();
+  for (const block of content.matchAll(CTRL_BLOCK)) {
+    for (const call of (block[1] ?? "").matchAll(new RegExp(CTRL_CALL_SRC, "g"))) {
+      const name = call[1] ?? "";
+      if (!isPromoted(name)) {
+        if (allowedToolNames !== void 0) droppedNames.push(name);
+        continue;
+      }
+      toolCalls.push({
+        type: "tool_use",
+        id: makeId(),
+        name,
+        input: parseCtrlArgs(call[2] ?? "")
+      });
+      formats.add("gemini-ctrl42");
+    }
+  }
   for (const block of content.matchAll(HERMES_BLOCK)) {
     const name = (block[1] ?? "").trim();
     if (!isPromoted(name)) {
       if (name.length > 0 && allowedToolNames !== void 0) droppedNames.push(name);
       continue;
     }
+    formats.add("hermes");
     toolCalls.push({
       type: "tool_use",
       id: makeId(),
@@ -1543,10 +1582,37 @@ function extractHermesToolCalls(content, makeId, allowedToolNames) {
     });
   }
   const residualText = toolCalls.length === 0 ? content : content.replace(
+    CTRL_BLOCK,
+    (_full, calls) => keepUnpromotedCtrl(calls, isPromoted)
+  ).replace(
     HERMES_BLOCK,
     (full, rawName) => isPromoted((rawName ?? "").trim()) ? "" : full
   ).trim();
-  return { toolCalls, residualText, droppedNames };
+  return { toolCalls, residualText, droppedNames, formats: [...formats] };
+}
+function keepUnpromotedCtrl(calls, isPromoted) {
+  const kept = [...calls.matchAll(new RegExp(CTRL_CALL_SRC, "g"))].filter((c) => !isPromoted(c[1] ?? "")).map((c) => c[0]);
+  return kept.length === 0 ? "" : `<ctrl42>call
+${kept.join("\n")}`;
+}
+var CTRL_ARG = /\s*([A-Za-z_]\w*)\s*=\s*("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|[^,]+)\s*(?:,|$)/y;
+function parseCtrlArgs(raw) {
+  const input = {};
+  CTRL_ARG.lastIndex = 0;
+  for (let m = CTRL_ARG.exec(raw); m !== null; m = CTRL_ARG.exec(raw)) {
+    input[m[1]] = parseCtrlValue(m[2].trim());
+  }
+  return chunkYSTXFWQE_cjs.sanitizeToolInput(input, { trim: true }).value;
+}
+function parseCtrlValue(v) {
+  const q = v[0];
+  if ((q === '"' || q === "'") && v.length >= 2 && v.endsWith(q)) {
+    return v.slice(1, -1).replace(/\\(.)/g, (_, c) => c === "n" ? "\n" : c === "t" ? "	" : c);
+  }
+  if (v === "True") return true;
+  if (v === "False") return false;
+  if (v === "None") return null;
+  return /^-?\d+(\.\d+)?$/.test(v) ? Number(v) : v;
 }
 function parseHermesParams(inner) {
   const input = {};
@@ -1564,6 +1630,10 @@ var isStreamWs = (c) => c === " " || c === "	" || c === "\n" || c === "\r";
 function streamToolCallBufferState(held, allowedToolNames, cap = DEFAULT_STREAM_BUFFER_CAP) {
   if (allowedToolNames.size === 0) return "impossible";
   const t = held.trimStart();
+  if (t.startsWith("<c")) return ctrlState(t, held.length, allowedToolNames, cap);
+  return functionMarkerState(held, t, allowedToolNames, cap);
+}
+function functionMarkerState(held, t, allowedToolNames, cap) {
   if (t.length < STREAM_MARKER.length) {
     return STREAM_MARKER.startsWith(t) ? "possible" : "impossible";
   }
@@ -1575,6 +1645,20 @@ function streamToolCallBufferState(held, allowedToolNames, cap = DEFAULT_STREAM_
   if (!nameOk) return "impossible";
   return held.length > cap ? "impossible" : "possible";
 }
+function ctrlState(t, heldLength, allowedToolNames, cap) {
+  if (t.length < CTRL_MARKER.length) return CTRL_MARKER.startsWith(t) ? "possible" : "impossible";
+  if (!t.startsWith(CTRL_MARKER)) return "impossible";
+  const rest = t.slice(CTRL_MARKER.length).trimStart();
+  if (rest.length <= CTRL_PREFIX.length)
+    return CTRL_PREFIX.startsWith(rest) ? "possible" : "impossible";
+  if (!rest.startsWith(CTRL_PREFIX)) return "impossible";
+  const afterPrefix = rest.slice(CTRL_PREFIX.length);
+  const paren = afterPrefix.indexOf("(");
+  const name = paren === -1 ? afterPrefix : afterPrefix.slice(0, paren);
+  if (!/^\w*$/.test(name)) return "impossible";
+  const nameOk = paren === -1 ? someToolNameStartsWith(allowedToolNames, name) : allowedToolNames.has(name);
+  return nameOk && heldLength <= cap ? "possible" : "impossible";
+}
 function parseStreamMarkerName(t) {
   let cursor = STREAM_MARKER.length;
   while (cursor < t.length && isStreamWs(t[cursor])) cursor += 1;
@@ -1763,7 +1847,7 @@ var OpenAIClient = class {
         endpoint: "/v1/chat/completions"
       });
       if (ollamaMapped !== void 0) throw ollamaMapped;
-      throw chunkNP362THY_cjs.mapOpenAICompatibleError({
+      throw chunk3F53FLQ7_cjs.mapOpenAICompatibleError({
         providerId,
         status: response.status,
         body,
@@ -1799,7 +1883,7 @@ var OpenAIClient = class {
       }
       if (chunk.error !== void 0 && chunk.error !== null) {
         const status = typeof chunk.error.code === "number" ? chunk.error.code : 502;
-        throw chunkNP362THY_cjs.mapOpenAICompatibleError({
+        throw chunk3F53FLQ7_cjs.mapOpenAICompatibleError({
           providerId,
           status,
           body: chunk,
@@ -1930,7 +2014,7 @@ var OpenAIStreamAccumulator = class {
         text = recovered.residualText;
         stopReason = "tool_use";
         chunkRNXXYF22_cjs.diag(
-          `[theokit-sdk] recovered ${recovered.toolCalls.length} leaked tool call(s) from assistant content (provider="${this.providerName}", names=${recovered.toolCalls.map((c) => c.name).join(",")})
+          `[theokit-sdk] recovered ${recovered.toolCalls.length} leaked tool call(s) from assistant content (provider="${this.providerName}", format=${recovered.formats.join(",") || "hermes"}, names=${recovered.toolCalls.map((c) => c.name).join(",")})
 `
         );
       }
@@ -2483,7 +2567,7 @@ var ResponsesApiClient = class {
       body = JSON.parse(text);
     } catch {
     }
-    return chunkNP362THY_cjs.mapOpenAICompatibleError({
+    return chunk3F53FLQ7_cjs.mapOpenAICompatibleError({
       providerId,
       status: response.status,
       body,
@@ -2519,7 +2603,7 @@ var ResponsesApiClient = class {
         const failure = ResponsesStreamAccumulator.failureMessage(event);
         if (failure !== void 0) {
           yield { type: "error", message: failure };
-          throw chunkNP362THY_cjs.mapOpenAICompatibleError({
+          throw chunk3F53FLQ7_cjs.mapOpenAICompatibleError({
             providerId,
             status: 502,
             body: { error: { message: failure } },
@@ -2633,11 +2717,11 @@ function classifyVertexError(args, errStatus) {
   for (const rule of VERTEX_RULES) {
     if (rule.test(args.status, errStatus)) return rule.code;
   }
-  const shared = chunkNP362THY_cjs.httpStatusToErrorCode(args.status);
+  const shared = chunk3F53FLQ7_cjs.httpStatusToErrorCode(args.status);
   return shared === "auth_failed" ? "auth_permission" : shared;
 }
 function vertexMetadata(args, code) {
-  return chunkNP362THY_cjs.buildErrorMetadata({
+  return chunk3F53FLQ7_cjs.buildErrorMetadata({
     provider: "vertex",
     endpoint: args.endpoint,
     code,
@@ -2669,7 +2753,7 @@ var VERTEX_ERROR_BUILDERS = {
   unknown: (args, msg) => new chunkCEGU5AVD_cjs.UnknownAgentError(`Vertex unknown: ${msg}`, { metadata: vertexMetadata(args, "unknown") })
 };
 function mapVertexError(args) {
-  const parsed = chunkNP362THY_cjs.parseErrorBody(args.body);
+  const parsed = chunk3F53FLQ7_cjs.parseErrorBody(args.body);
   const errStatus = parsed.error?.status ?? "";
   const message = parsed.error?.message ?? "Vertex request failed";
   const code = classifyVertexError(args, errStatus);
@@ -2691,7 +2775,7 @@ async function resolveVertexAccessToken() {
 async function getAuthClientOrThrow() {
   let mod;
   try {
-    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-SNVYOX46.cjs', document.baseURI).href)));
+    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-3E3VSMB6.cjs', document.baseURI).href)));
     mod = r("google-auth-library");
   } catch (err) {
     const isModuleMissing = err instanceof Error && (err.message.includes("Cannot find module") || err.code === "MODULE_NOT_FOUND");
@@ -2752,8 +2836,8 @@ var VertexAnthropicClient = class {
     const projectId = this.resolveProjectOrThrow();
     const location = this.options.location ?? resolveVertexLocation();
     const accessToken = await this.resolveTokenOrThrow();
-    const baseUrl = chunk4TEGFMSP_cjs.resolveVertexBaseUrl({ projectId, location, modelDialect: "anthropic" });
-    const bareModel = chunk4TEGFMSP_cjs.stripVertexPrefix(request.model);
+    const baseUrl = chunkP7QYG4RZ_cjs.resolveVertexBaseUrl({ projectId, location, modelDialect: "anthropic" });
+    const bareModel = chunkP7QYG4RZ_cjs.stripVertexPrefix(request.model);
     const endpoint = `/models/${encodeURIComponent(bareModel)}:rawPredict`;
     const url = `${baseUrl}${endpoint}`;
     const response = await postAnthropicRequest({
@@ -2802,7 +2886,7 @@ var VertexGeminiClient = class {
         { code: "auth_failed" }
       );
     }
-    const baseUrl = chunk4TEGFMSP_cjs.resolveVertexBaseUrl({ projectId, location, modelDialect: "gemini" });
+    const baseUrl = chunkP7QYG4RZ_cjs.resolveVertexBaseUrl({ projectId, location, modelDialect: "gemini" });
     const url = `${baseUrl}/chat/completions`;
     const innerFetch = chunkEHD25JBZ_cjs.boundFetch(this.options.fetch);
     const rewriteFetch = (_input, init) => innerFetch(url, init);
@@ -2824,7 +2908,7 @@ var VertexRouterClient = class {
   options;
   name = "vertex";
   async *stream(request, signal) {
-    const dialect = chunk4TEGFMSP_cjs.inferModelDialect(request.model);
+    const dialect = chunkP7QYG4RZ_cjs.inferModelDialect(request.model);
     if (dialect === "anthropic") {
       const inner2 = new VertexAnthropicClient(this.options);
       return yield* inner2.stream(request, signal);
@@ -2836,7 +2920,7 @@ var VertexRouterClient = class {
 
 // src/internal/llm/router.ts
 function resolveProviderChain(options) {
-  chunk4TEGFMSP_cjs.registerBuiltins();
+  chunkP7QYG4RZ_cjs.registerBuiltins();
   return buildChain(options);
 }
 function buildChain(options) {
@@ -2851,9 +2935,12 @@ function buildChain(options) {
     if (client !== void 0) clients.push(maybeWrapWithFaultInjection(client));
   };
   addClient(options.primary, options.baseUrl);
-  for (const fallback of options.fallback ?? []) addClient(fallback);
+  for (const fallback of options.fallback ?? []) {
+    warnUnknownFallback(fallback);
+    addClient(fallback);
+  }
   if (clients.length === 0) {
-    if (chunk4TEGFMSP_cjs.getProviderProfile(normalizeProviderName(options.primary)) === void 0) {
+    if (chunkP7QYG4RZ_cjs.getProviderProfile(normalizeProviderName(options.primary)) === void 0) {
       throw new chunkCEGU5AVD_cjs.ConfigurationError(unregisteredProviderMessage(options.primary), {
         code: "provider_unresolved"
       });
@@ -2870,7 +2957,7 @@ function normalizeProviderName(name) {
 }
 function unregisteredProviderMessage(name) {
   const normalized = normalizeProviderName(name);
-  const caseOnlyMatch = chunk4TEGFMSP_cjs.listProviders().find(
+  const caseOnlyMatch = chunkP7QYG4RZ_cjs.listProviders().find(
     (profile) => normalizeProviderName(profile.name) === normalized
   );
   if (caseOnlyMatch !== void 0) {
@@ -2878,11 +2965,11 @@ function unregisteredProviderMessage(name) {
   }
   const aliasMessage = caseOnlyAliasMessage(name, normalized);
   if (aliasMessage !== void 0) return aliasMessage;
-  const registered = chunk4TEGFMSP_cjs.listProviders().map((profile) => profile.name).sort((a, b) => a.localeCompare(b)).join(", ");
+  const registered = chunkP7QYG4RZ_cjs.listProviders().map((profile) => profile.name).sort((a, b) => a.localeCompare(b)).join(", ");
   return `No provider client could be resolved: "${name}" is not a known provider. Registered providers: ${registered}.`;
 }
 function caseOnlyAliasMessage(name, normalized) {
-  for (const profile of chunk4TEGFMSP_cjs.listProviders()) {
+  for (const profile of chunkP7QYG4RZ_cjs.listProviders()) {
     const alias = profile.aliases?.find((entry) => normalizeProviderName(entry) === normalized);
     if (alias === void 0) continue;
     return `No provider client could be resolved: "${name}" matches the alias "${alias}" of the registered provider "${profile.name}" only when case is ignored, and routes look provider names up in lowercase. Register the alias as "${normalized}", or route to "${profile.name}".`;
@@ -2890,11 +2977,11 @@ function caseOnlyAliasMessage(name, normalized) {
   return void 0;
 }
 function buildTransport(name, routerOptions, perCallBaseUrl) {
-  const baseProfile = chunk4TEGFMSP_cjs.getProviderProfile(name);
+  const baseProfile = chunkP7QYG4RZ_cjs.getProviderProfile(name);
   if (baseProfile === void 0) return void 0;
   const profile = routerOptions.extractToolCallsFromContent === true && baseProfile.extractToolCallsFromContent !== true ? { ...baseProfile, extractToolCallsFromContent: true } : baseProfile;
   const resilience = routerOptions.onRateLimit !== void 0 ? { onRateLimit: routerOptions.onRateLimit } : {};
-  const ambient = chunkSXH37C7X_cjs.currentCredentialPool(name);
+  const ambient = chunk55LLQFHW_cjs.currentCredentialPool(name);
   if (ambient !== void 0) {
     return new PoolAwareLlmClient(
       ambient,
@@ -2926,9 +3013,9 @@ function buildPoolOrSingle(args) {
   if (poolKeys !== void 0 && poolKeys.length >= 2) {
     const strategy = routerOptions.credentialPoolStrategy?.[name] ?? "fill_first";
     const entries = poolKeys.map(
-      (accessToken, priority) => chunkSXH37C7X_cjs.newPooledCredential({ provider: name, accessToken, priority, source: "manual" })
+      (accessToken, priority) => chunk55LLQFHW_cjs.newPooledCredential({ provider: name, accessToken, priority, source: "manual" })
     );
-    const pool = new chunkSXH37C7X_cjs.CredentialPool(name, entries, strategy);
+    const pool = new chunk55LLQFHW_cjs.CredentialPool(name, entries, strategy);
     const resilience = routerOptions.onRateLimit !== void 0 ? { onRateLimit: routerOptions.onRateLimit } : {};
     return new PoolAwareLlmClient(
       pool,
@@ -2985,7 +3072,7 @@ function warnUnknownProvidersInApiKeys(apiKeys) {
   if (apiKeys === void 0) return;
   for (const name of Object.keys(apiKeys)) {
     if (warnedProviders.has(name)) continue;
-    const profile = chunk4TEGFMSP_cjs.getProviderProfile(name);
+    const profile = chunkP7QYG4RZ_cjs.getProviderProfile(name);
     if (profile === void 0) {
       warnedProviders.add(name);
       chunkRNXXYF22_cjs.diag(
@@ -2995,6 +3082,16 @@ function warnUnknownProvidersInApiKeys(apiKeys) {
     }
   }
 }
+function warnUnknownFallback(name) {
+  const key = `fallback:${normalizeProviderName(name)}`;
+  if (warnedProviders.has(key)) return;
+  if (chunkP7QYG4RZ_cjs.getProviderProfile(normalizeProviderName(name)) !== void 0) return;
+  warnedProviders.add(key);
+  chunkRNXXYF22_cjs.diag(
+    `[theokit-sdk] providers.fallback: unknown provider "${name}" (no profile registered) \u2014 dropped from the fallback chain
+`
+  );
+}
 function resolveApiKey(envVars) {
   for (const v of envVars) {
     const value = process.env[v];
@@ -3160,7 +3257,7 @@ function checkProviderPrefix(key, provider) {
 function registerPluginProviderProfiles(entries) {
   let registered = 0;
   for (const entry of entries) {
-    chunk4TEGFMSP_cjs.registerProvider(entry.profile);
+    chunkP7QYG4RZ_cjs.registerProvider(entry.profile);
     registered += 1;
   }
   return registered;
@@ -3244,7 +3341,7 @@ function shouldUseRealLocalRuntime(apiKey) {
 function inferProviderFromApiKey(apiKey) {
   const provider = chunkFRITRLZQ_cjs.providerFromApiKeyPrefix(apiKey);
   if (provider === void 0) return void 0;
-  return chunk4TEGFMSP_cjs.getProviderProfile(provider) === void 0 ? void 0 : provider;
+  return chunkP7QYG4RZ_cjs.getProviderProfile(provider) === void 0 ? void 0 : provider;
 }
 function detectPrimaryProvider() {
   if (process.env.ANTHROPIC_API_KEY !== void 0 && process.env.ANTHROPIC_API_KEY.length > 0) {
@@ -3271,7 +3368,7 @@ function warnProviderPrecedenceOnce(asked, used) {
 }
 var pluginProvidersAnnounced = false;
 function resolveRunProvider(options) {
-  chunk4TEGFMSP_cjs.registerBuiltins();
+  chunkP7QYG4RZ_cjs.registerBuiltins();
   const profiles = options.pluginManager?.aggregated.providerProfiles ?? [];
   const registered = registerPluginProviderProfiles(profiles);
   if (registered > 0 && !pluginProvidersAnnounced) {
@@ -3281,7 +3378,7 @@ function resolveRunProvider(options) {
 `);
   }
   const parsedModel = chunk3EE6LVWT_cjs.parseModelId(options.model?.id);
-  const modelInferredProvider = parsedModel.provider !== void 0 && chunk4TEGFMSP_cjs.getProviderProfile(parsedModel.provider) !== void 0 ? parsedModel.provider : void 0;
+  const modelInferredProvider = parsedModel.provider !== void 0 && chunkP7QYG4RZ_cjs.getProviderProfile(parsedModel.provider) !== void 0 ? parsedModel.provider : void 0;
   const keyInferredProvider = inferProviderFromApiKey(options.agentOptions.apiKey);
   const primary = options.agentOptions.providers?.routes?.[0]?.provider ?? keyInferredProvider ?? modelInferredProvider ?? detectPrimaryProvider();
   warnProviderPrecedenceOnce(modelInferredProvider, primary);
@@ -3421,9 +3518,9 @@ function resolveSummarizerRoute(opts) {
 }
 function buildDefaultSummarizer(opts) {
   return async (messages) => {
-    chunk4TEGFMSP_cjs.registerBuiltins();
+    chunkP7QYG4RZ_cjs.registerBuiltins();
     const modelPrefix = opts.agentModel.includes("/") ? opts.agentModel.slice(0, opts.agentModel.indexOf("/")) : void 0;
-    const prefixProfile = modelPrefix !== void 0 ? chunk4TEGFMSP_cjs.getProviderProfile(modelPrefix) : void 0;
+    const prefixProfile = modelPrefix !== void 0 ? chunkP7QYG4RZ_cjs.getProviderProfile(modelPrefix) : void 0;
     const prefixUsable = prefixProfile !== void 0 && (prefixProfile.authType !== "api_key" || prefixProfile.envVars.some((v) => (process.env[v] ?? "").length > 0));
     const route = resolveSummarizerRoute({
       keyProvider: inferProviderFromApiKey(opts.apiKey),
@@ -3531,5 +3628,5 @@ exports.shouldUseRealLocalRuntime = shouldUseRealLocalRuntime;
 exports.trustFilePath = trustFilePath;
 exports.tryFirstEvent = tryFirstEvent;
 exports.validateApiKeyShape = validateApiKeyShape;
-//# sourceMappingURL=chunk-SNVYOX46.cjs.map
-//# sourceMappingURL=chunk-SNVYOX46.cjs.map
+//# sourceMappingURL=chunk-3E3VSMB6.cjs.map
+//# sourceMappingURL=chunk-3E3VSMB6.cjs.map