@theokit/sdk 5.15.0 → 5.15.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 5.15.1
+
+### Patch Changes
+
+- [#956](https://github.com/usetheokit/theokit-sdk/pull/956) [`2604fa9`](https://github.com/usetheokit/theokit-sdk/commit/2604fa9e54454ac8b50dfbfb8dcd02dfc57d0d01) Thanks [@aifactory-paulohenriquevn](https://github.com/apps/aifactory-paulohenriquevn)! - llm: recover several `print(default_api.<tool>(…))` calls under one Gemini `<ctrl42>call` marker (calls to undeclared tools stay text), and name the recovered format in the diagnostic.
+
+- [#954](https://github.com/usetheokit/theokit-sdk/pull/954) [`c5c236a`](https://github.com/usetheokit/theokit-sdk/commit/c5c236abd0815b6e4ce9929e4ebd89e36bb04ddd) Thanks [@aifactory-paulohenriquevn](https://github.com/apps/aifactory-paulohenriquevn)! - Streaming no longer emits Gemini's `<ctrl42>call print(default_api.<tool>(...))` text as `text_delta` for a declared tool; the call is recovered when the stream ends.
+
+- [#948](https://github.com/usetheokit/theokit-sdk/pull/948) [`f4f87f0`](https://github.com/usetheokit/theokit-sdk/commit/f4f87f0382796e539a2a4e682ac3c2c567e653cc) Thanks [@aifactory-paulohenriquevn](https://github.com/apps/aifactory-paulohenriquevn)! - Documentation: the `postRun` hook fires on a failed run, but it is internal-only. `.theokit/hooks.json` cannot register it (Claude Code has no per-run event), and `Stop` fires only on a finished run. `HookEvent` now says so.
+
+- [#952](https://github.com/usetheokit/theokit-sdk/pull/952) [`3be74fb`](https://github.com/usetheokit/theokit-sdk/commit/3be74fb098206f7b6a15da826ff464eff588d044) Thanks [@aifactory-paulohenriquevn](https://github.com/apps/aifactory-paulohenriquevn)! - README "Failed runs" states that under `throwOnError` the canonical error code is `err.metadata?.code ?? err.code`, since a provider-mapped `err.code` can be prefixed.
+
 ## 5.15.0
 
 ### Minor Changes

package/dist/{agent-DRDGUU6T.js → agent-66U5QCPF.js}

@@ -1,6 +1,6 @@
-export { Agent } from './chunk-5M5GQYBM.js';
+export { Agent } from './chunk-ZQWRUJHE.js';
 import './chunk-HWMGR3HA.js';
-import './chunk-23SS4ID4.js';
+import './chunk-VNRNZ3WI.js';
 import './chunk-K2BQQ445.js';
 import './chunk-3BBTHFGJ.js';
 import './chunk-HJ2LV464.js';
@@ -10,7 +10,7 @@ import './chunk-H73MEMQB.js';
 import './chunk-QK2ERTO3.js';
 import './chunk-LCCT5ZXJ.js';
 import './chunk-RGVMJU57.js';
-import './chunk-IOBHFP2E.js';
+import './chunk-26GI3OYA.js';
 import './chunk-NK5EOTDY.js';
 import './chunk-2XC6KDJM.js';
 import './chunk-7ACS6P5Z.js';
@@ -59,5 +59,5 @@ import './chunk-5IUDICRK.js';
 import './chunk-Q7GYMXVC.js';
 import './chunk-TNFOU6SB.js';
 import './chunk-3OY6H3I7.js';
-//# sourceMappingURL=agent-DRDGUU6T.js.map
-//# sourceMappingURL=agent-DRDGUU6T.js.map
+//# sourceMappingURL=agent-66U5QCPF.js.map
+//# sourceMappingURL=agent-66U5QCPF.js.map

package/dist/{agent-DRDGUU6T.js.map → agent-66U5QCPF.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-DRDGUU6T.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-66U5QCPF.js"}

package/dist/{agent-B6FQad6P.d.cts → agent-BL4kxgwq.d.cts}

@@ -171,7 +171,13 @@ interface BudgetTracker {
  *
  * @public
  */
-/** The five lifecycle events the runtime actually fires. */
+/**
+ * The five lifecycle events the runtime actually fires.
+ *
+ * `postRun` (once per run, including a failed run) is internal-only: it is reachable from the
+ * SDK's own hook config and spies, but `.theokit/hooks.json` (Claude Code event names) cannot
+ * register it, because no Claude Code event means "end of a run". `Stop` fires only on a finished run.
+ */
 type HookEvent = "preRun" | "postRun" | "preToolUse" | "postToolUse" | "stop";
 /**
  * #631 — what the consumer is shown when asked to approve a hook.

package/dist/{agent-B6C9i_qu.d.ts → agent-ByDx7K30.d.ts}

@@ -171,7 +171,13 @@ interface BudgetTracker {
  *
  * @public
  */
-/** The five lifecycle events the runtime actually fires. */
+/**
+ * The five lifecycle events the runtime actually fires.
+ *
+ * `postRun` (once per run, including a failed run) is internal-only: it is reachable from the
+ * SDK's own hook config and spies, but `.theokit/hooks.json` (Claude Code event names) cannot
+ * register it, because no Claude Code event means "end of a run". `Stop` fires only on a finished run.
+ */
 type HookEvent = "preRun" | "postRun" | "preToolUse" | "postToolUse" | "stop";
 /**
  * #631 — what the consumer is shown when asked to approve a hook.

package/dist/{agent-VI2HITPT.cjs → agent-CB27KF6O.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk64ECM3XM_cjs = require('./chunk-64ECM3XM.cjs');
+var chunk26UQG242_cjs = require('./chunk-26UQG242.cjs');
 require('./chunk-L7JPXZ2C.cjs');
-require('./chunk-U7PRI3XM.cjs');
+require('./chunk-FBIDOOJM.cjs');
 require('./chunk-BUUUWQMB.cjs');
 require('./chunk-NEH3BPFD.cjs');
 require('./chunk-7YUPSBDV.cjs');
@@ -12,7 +12,7 @@ require('./chunk-GHX4P3V2.cjs');
 require('./chunk-RS7YQR4X.cjs');
 require('./chunk-VWYFGE27.cjs');
 require('./chunk-FTXY4D44.cjs');
-require('./chunk-DJKGDLYZ.cjs');
+require('./chunk-3E3VSMB6.cjs');
 require('./chunk-55LLQFHW.cjs');
 require('./chunk-YJNYDJ2T.cjs');
 require('./chunk-3F53FLQ7.cjs');
@@ -66,7 +66,7 @@ require('./chunk-RNXXYF22.cjs');
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunk64ECM3XM_cjs.Agent; }
+  get: function () { return chunk26UQG242_cjs.Agent; }
 });
-//# sourceMappingURL=agent-VI2HITPT.cjs.map
-//# sourceMappingURL=agent-VI2HITPT.cjs.map
+//# sourceMappingURL=agent-CB27KF6O.cjs.map
+//# sourceMappingURL=agent-CB27KF6O.cjs.map

package/dist/{agent-VI2HITPT.cjs.map → agent-CB27KF6O.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-VI2HITPT.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-CB27KF6O.cjs"}

package/dist/{chunk-IOBHFP2E.js → chunk-26GI3OYA.js}

@@ -1539,16 +1539,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(),
@@ -1557,10 +1579,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 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 = {};
@@ -1578,6 +1627,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";
   }
@@ -1589,6 +1642,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;
@@ -1944,7 +2011,7 @@ var OpenAIStreamAccumulator = class {
         text = recovered.residualText;
         stopReason = "tool_use";
         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(",")})
 `
         );
       }
@@ -3526,5 +3593,5 @@ async function autoCompactIfNeeded(opts) {
 }
 
 export { COMPACT_SUMMARY_MARKER, COMPACT_USER_MESSAGE_MAX_TOKENS, CircuitBreaker, DEFAULT_PRE_COMPACT_TIMEOUT_MS, abortError, autoCompactIfNeeded, buildDefaultSummarizer, compactSessionTranscript, discoverProviderPlugins, getConfiguredBaseUrl, httpRequest, inferApiMode, isCompactSummary, isFixtureApiKey, mapOllamaHttpError, mapOllamaTransportError, mergeExplicitApiKey, normalizeUsage, parseSseStream, presentProviderCredentialEnvVars, readErrorResponseBody, readTrustArray, relayStream, renderToolResultContentText, resolveProviderChain, resolveRunProvider, resolveSummarizerRoute, shouldAutoCompact, shouldUseFixtureMode, shouldUseRealLocalRuntime, trustFilePath, tryFirstEvent, validateApiKeyShape };
-//# sourceMappingURL=chunk-IOBHFP2E.js.map
-//# sourceMappingURL=chunk-IOBHFP2E.js.map
+//# sourceMappingURL=chunk-26GI3OYA.js.map
+//# sourceMappingURL=chunk-26GI3OYA.js.map