@theokit/sdk 2.11.1 → 2.11.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 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;
@@ -11211,6 +11217,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(