@theokit/sdk 2.11.1 → 2.11.3

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

@@ -42,6 +42,18 @@ interface OpenAIDeltaChunk {
         cache_creation_input_tokens?: number;
         cache_read_input_tokens?: number;
     };
+    /**
+     * In-stream provider error. OpenRouter (and some OpenAI-compatible proxies)
+     * report auth / quota / rate-limit failures as an HTTP 200 SSE body carrying
+     * `data: {"error":{"message":"...","code":401}}` instead of a non-2xx status.
+     * Without surfacing this, the round finishes empty and the failure is silent
+     * (usetheodev/theocode#31).
+     */
+    error?: {
+        message?: string;
+        code?: number | string;
+        type?: string;
+    };
 }
 export declare class OpenAIClient implements LlmClient {
     private readonly options;

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

@@ -92,6 +92,14 @@ export interface LlmRequest {
     reasoning?: {
         effort: string;
     };
+    /**
+     * Step-cap force-close: per-request tool gating. `"none"` tells the provider to emit no tool
+     * calls even when `tools` are present (forcing a text answer); `"required"` forces a tool call;
+     * `"auto"` (or omitted) is the default. Maps to OpenAI/OpenRouter `tool_choice`. The agent loop
+     * sets `"none"` on a final/ceiling round so a cached agent (whose tools cannot be un-registered)
+     * is still forced to produce a closing summary.
+     */
+    toolChoice?: "auto" | "none" | "required";
 }
 export type LlmEvent = {
     type: "text_delta";

package/dist/{run-D22b53SU.d.cts → run-TMdc7gmo.d.cts}

@@ -827,6 +827,13 @@ interface SendOptions {
     onDelta?: (args: {
         update: InteractionUpdate;
     }) => void | Promise<void>;
+    /**
+     * Per-call tool gate (OpenAI/OpenRouter `tool_choice`). `"none"` forces a text answer even when
+     * the agent has tools registered — used by an agent loop to force a closing summary at its step
+     * ceiling (a cached agent's tools cannot be un-registered, so the gate is per-send). `"required"`
+     * forces a tool call; `"auto"` (or omitted) is the default. Local runtime; OpenAI-compat providers.
+     */
+    toolChoice?: "auto" | "none" | "required";
     /** Local agents only. Expire a stuck active run before starting this message. */
     local?: {
         force?: boolean;

package/dist/{run-D22b53SU.d.ts → run-TMdc7gmo.d.ts}

@@ -827,6 +827,13 @@ interface SendOptions {
     onDelta?: (args: {
         update: InteractionUpdate;
     }) => void | Promise<void>;
+    /**
+     * Per-call tool gate (OpenAI/OpenRouter `tool_choice`). `"none"` forces a text answer even when
+     * the agent has tools registered — used by an agent loop to force a closing summary at its step
+     * ceiling (a cached agent's tools cannot be un-registered, so the gate is per-send). `"required"`
+     * forces a tool call; `"auto"` (or omitted) is the default. Local runtime; OpenAI-compat providers.
+     */
+    toolChoice?: "auto" | "none" | "required";
     /** Local agents only. Expire a stuck active run before starting this message. */
     local?: {
         force?: boolean;

package/dist/types/run.d.ts

@@ -221,6 +221,13 @@ export interface SendOptions {
     onDelta?: (args: {
         update: InteractionUpdate;
     }) => void | Promise<void>;
+    /**
+     * Per-call tool gate (OpenAI/OpenRouter `tool_choice`). `"none"` forces a text answer even when
+     * the agent has tools registered — used by an agent loop to force a closing summary at its step
+     * ceiling (a cached agent's tools cannot be un-registered, so the gate is per-send). `"required"`
+     * forces a tool call; `"auto"` (or omitted) is the default. Local runtime; OpenAI-compat providers.
+     */
+    toolChoice?: "auto" | "none" | "required";
     /** Local agents only. Expire a stuck active run before starting this message. */
     local?: {
         force?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "2.11.1",
+  "version": "2.11.3",
   "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",
@@ -364,8 +364,8 @@
     "typedoc": "^0.28.19",
     "ws": "^8.18.0",
     "zod": "^4.0.0",
-    "@theokit/sdk-handoff": "0.1.0",
-    "@theokit/sdk-memory": "0.2.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",