@theokit/sdk 2.11.1 → 2.11.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 2.11.3
+
+### Patch Changes
+
+- bb3a7d8: Fail-loud on in-stream provider errors. OpenRouter (and some OpenAI-compatible proxies) report auth / quota / rate-limit failures as an HTTP 200 SSE body carrying `data: {"error":{"message":"...","code":401}}` rather than a non-2xx status. The stream accumulator only reads `choices`, so such an error-only chunk produced zero events and the turn finished empty — the failure was silently swallowed (a dead API key looked like an empty model response). The OpenAI client now detects an in-stream `error` chunk and throws the same typed error a non-2xx HTTP status would (`AuthenticationError` / `RateLimitError` / `ConfigurationError` / …), so callers surface it instead of a blank turn. Fixes usetheodev/theocode#31.
+
+## 2.11.2
+
+### Patch Changes
+
+- 8b411c5: Add `SendOptions.toolChoice` (`"auto" | "none" | "required"`), forwarded to the OpenAI/OpenRouter `tool_choice` request field. `"none"` forces a text answer even when the agent has tools registered — this lets an agent loop force a closing summary at its step ceiling (a cached agent's tools cannot be un-registered, so the gate must be applied per-send, not at agent creation). `tool_choice` is emitted only alongside a non-empty `tools` array. Additive and backward-compatible (absent ⇒ provider default).
+
 ## 2.11.1
 
 ### Patch Changes

package/dist/a2a/index.cjs

@@ -7108,6 +7108,9 @@ async function streamLlmTurn(inputs, ctx) {
         const effort = reasoningEffortFromParams(inputs.model.params);
         return effort !== void 0 ? { reasoning: { effort } } : {};
       })(),
+      // Step-cap force-close: forward the per-run tool gate (`"none"` on a ceiling round forces a
+      // text close even though tools are advertised). Absent ⇒ provider default (auto).
+      ...inputs.toolChoice !== void 0 ? { toolChoice: inputs.toolChoice } : {},
       messages: ctx.messages,
       tools: ctx.tools.map(toLlmTool)
     },
@@ -10114,6 +10117,14 @@ function applyReasoningRequest(body, effort, providerName) {
   }
   body.reasoning = { effort };
 }
+function applyToolsRequest(body, request) {
+  if (request.tools === void 0 || request.tools.length === 0) return;
+  body.tools = request.tools.map((tool) => ({
+    type: "function",
+    function: { name: tool.name, description: tool.description, parameters: tool.inputSchema }
+  }));
+  if (request.toolChoice !== void 0) body.tool_choice = request.toolChoice;
+}
 function buildOpenAIBody(request, providerName) {
   const messages = [];
   const systemText = openAISystemText(request.system);
@@ -10135,12 +10146,7 @@ function buildOpenAIBody(request, providerName) {
   if (request.temperature !== void 0) body.temperature = request.temperature;
   if (request.reasoning?.effort !== void 0)
     applyReasoningRequest(body, request.reasoning.effort, providerName);
-  if (request.tools !== void 0 && request.tools.length > 0) {
-    body.tools = request.tools.map((tool) => ({
-      type: "function",
-      function: { name: tool.name, description: tool.description, parameters: tool.inputSchema }
-    }));
-  }
+  applyToolsRequest(body, request);
   const responseFormat = encodeOpenAIResponseFormat(request.responseFormat);
   if (responseFormat !== void 0) body.response_format = responseFormat;
   return body;
@@ -10273,6 +10279,16 @@ var init_openai2 = __esm({
           } catch {
             continue;
           }
+          if (chunk.error !== void 0 && chunk.error !== null) {
+            const status = typeof chunk.error.code === "number" ? chunk.error.code : 502;
+            throw mapOpenAICompatibleError({
+              providerId,
+              status,
+              body: chunk,
+              headers: response.headers,
+              endpoint: "/v1/chat/completions"
+            });
+          }
           const events = accumulator.consume(chunk);
           for (const event of events) yield event;
         }
@@ -11211,6 +11227,7 @@ function buildLoopInputs(options, runId, userText) {
     ...options.systemPrompt !== void 0 ? { systemPrompt: options.systemPrompt } : {},
     ...options.onStep !== void 0 ? { onStep: options.onStep } : {},
     ...options.onDelta !== void 0 ? { onDelta: options.onDelta } : {},
+    ...options.sendOptions.toolChoice !== void 0 ? { toolChoice: options.sendOptions.toolChoice } : {},
     ...options.priorMessages !== void 0 ? { priorMessages: options.priorMessages } : {},
     ...options.memoryTools !== void 0 && options.memoryTools.length > 0 ? { memoryTools: options.memoryTools } : {},
     ...buildCustomToolsInput(