@theokit/sdk 2.11.3 → 2.12.0

package/dist/internal/llm/hermes-tool-extract.d.ts

@@ -0,0 +1,6 @@
+export interface HermesExtractResult {
+    /** Recovered tool calls (empty when none matched). */
+    toolCalls: LlmToolCallPart[];
+    /** Content with every recovered block removed + trimmed; original content when nothing matched. */
+    residualText: string;
+}

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

@@ -64,6 +64,8 @@ export declare class OpenAIClient implements LlmClient {
     stream(request: LlmRequest, signal: AbortSignal): AsyncGenerator<LlmEvent, LlmFinish, void>;
 }
 declare class OpenAIStreamAccumulator {
+    private readonly extractFromContent;
+    private readonly providerName;
     private text;
     private stopReason;
     private inputTokens?;
@@ -72,6 +74,11 @@ declare class OpenAIStreamAccumulator {
     private cacheWriteTokens?;
     private reasoningTokens?;
     private readonly toolCalls;
+    /**
+     * @param extractFromContent opt-in leaked-dialect safe-parse (theokit#58). Default false.
+     * @param providerName provider id, used only to label the recovery log line.
+     */
+    constructor(extractFromContent?: boolean, providerName?: string);
     consume(chunk: OpenAIDeltaChunk): LlmEvent[];
     private applyReasoningDelta;
     private applyUsage;

package/dist/internal/providers/types.d.ts

@@ -24,4 +24,11 @@ export interface ProviderProfile {
     fallbackModels: ReadonlyArray<string>;
     extraHeaders?: Record<string, string>;
     bodyOverrides?: Record<string, unknown>;
+    /**
+     * Opt-in leaked-dialect safe-parse (theokit#58 follow-up). When `true`, a chat_completions finish
+     * with ZERO native `tool_calls` has its assistant content scanned for the Hermes
+     * `<function=…></tool_call>` dialect and any recovered calls are surfaced as real `tool_calls`.
+     * Default off — only enable for routes/models known to leak (e.g. a qwen3-coder profile variant).
+     */
+    extractToolCallsFromContent?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "2.11.3",
+  "version": "2.12.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheo/theokit-sdk#readme",
@@ -298,6 +298,15 @@
     "**/agent.js",
     "**/agent.cjs"
   ],
+  "scripts": {
+    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
+    "test": "vitest run --no-file-parallelism",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs:json": "typedoc --options typedoc.json",
+    "docs:drift": "tsx scripts/check-docs-drift.ts"
+  },
   "peerDependencies": {
     "@lancedb/lancedb": "^0.30.0",
     "@types/ws": ">=8.0.0",
@@ -354,6 +363,8 @@
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/sdk-trace-base": "^1.30.1",
+    "@theokit/sdk-handoff": "workspace:*",
+    "@theokit/sdk-memory": "workspace:*",
     "@types/better-sqlite3": "^7.6.13",
     "@types/proper-lockfile": "^4.1.4",
     "@types/ws": "^8.18.0",
@@ -363,17 +374,6 @@
     "sqlite-vec": "^0.1.9",
     "typedoc": "^0.28.19",
     "ws": "^8.18.0",
-    "zod": "^4.0.0",
-    "@theokit/sdk-memory": "0.2.0",
-    "@theokit/sdk-handoff": "0.1.0"
-  },
-  "scripts": {
-    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
-    "test": "vitest run --no-file-parallelism",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "docs:json": "typedoc --options typedoc.json",
-    "docs:drift": "tsx scripts/check-docs-drift.ts"
+    "zod": "^4.0.0"
   }
-}
+}