@theokit/sdk 2.11.3 → 2.13.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/llm/router.d.ts

@@ -7,6 +7,14 @@ export interface ProviderRouterOptions {
     apiKeys?: Record<string, string[]>;
     /** Pool rotation strategy per provider. Optional; default `"fill_first"`. */
     credentialPoolStrategy?: Record<string, CredentialPoolStrategy>;
+    /**
+     * Per-run opt-in leaked-dialect safe-parse derived from the chat route
+     * (theokit#58 follow-up). When `true`, the resolved profile is cloned with
+     * `extractToolCallsFromContent: true` so the OpenAI-compatible transport
+     * recovers Hermes `<function=…></tool_call>` dialect leaked as text. Applied
+     * to the resolved chain; fail-open, so a non-leaking provider is unaffected.
+     */
+    extractToolCallsFromContent?: boolean;
 }
 export declare function resolveProviderChainAsync(options: ProviderRouterOptions): Promise<LlmClient[]>;
 /**

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/dist/types/providers.d.ts

@@ -14,6 +14,17 @@ export interface ProviderRoute {
     capability: ProviderCapability;
     provider: string;
     model?: string;
+    /**
+     * Opt-in leaked-dialect safe-parse for this route's provider (theokit#58
+     * follow-up). When `true`, a `chat_completions` finish that carries ZERO
+     * native `tool_calls` has its assistant text scanned for the Hermes
+     * `<function=…></tool_call>` dialect, and any recovered calls are surfaced as
+     * real `tool_calls` so the loop executes them — for models (qwen3-coder via
+     * OpenRouter) that intermittently leak tool calls as text. Default `false`;
+     * fail-open (a partial/unclosed block never fabricates a call). Scoped to the
+     * resolved chat chain, so a non-leaking route is unaffected.
+     */
+    extractToolCallsFromContent?: boolean;
 }
 /**
  * Provider routing configuration accepted by `Agent.create()` via

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "2.11.3",
+  "version": "2.13.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"
   }
-}
+}