@kortyx/hooks 0.23.0 → 0.23.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.23.1](https://github.com/kortyx-io/kortyx/compare/hooks-v0.23.0...hooks-v0.23.1) (2026-09-11)
+
+
+### Bug Fixes
+
+* **providers:** preserve reasoning across tool workflows ([#169](https://github.com/kortyx-io/kortyx/issues/169)) ([6e4e403](https://github.com/kortyx-io/kortyx/commit/6e4e403d104d83586e05aab799510bc4c35b0f49))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/providers bumped to 0.6.1
+
 ## [0.23.0](https://github.com/kortyx-io/kortyx/compare/hooks-v0.22.0...hooks-v0.23.0) (2026-09-11)
 
 

package/dist/index.js

@@ -426,6 +426,16 @@ var emitNodeEvent = (emitEvent, nodeId, event, payload) => {
     ...typeof nodeId === "string" && nodeId.length > 0 ? { node: nodeId } : {}
   });
 };
+var resolveProviderOptions = (defaults, overrides) => {
+  const providerOptions = defaults || overrides ? { ...defaults, ...overrides } : void 0;
+  for (const [key, value] of Object.entries(overrides ?? {})) {
+    const previous = defaults?.[key];
+    if (previous && value && typeof previous === "object" && typeof value === "object" && !Array.isArray(previous) && !Array.isArray(value)) {
+      if (providerOptions) providerOptions[key] = { ...previous, ...value };
+    }
+  }
+  return providerOptions;
+};
 async function runReasonEngine(args) {
   let stream = args.stream ?? args.model.options?.streaming ?? true;
   const emit = args.emit ?? true;
@@ -435,14 +445,10 @@ async function runReasonEngine(args) {
   const abortSignal = args.abortSignal ?? args.model.options?.abortSignal;
   const reasoning = args.reasoning ?? args.model.options?.reasoning;
   const responseFormat = args.responseFormat ?? args.model.options?.responseFormat;
-  const defaults = args.model.options?.providerOptions;
-  const providerOptions = defaults || args.providerOptions ? { ...defaults, ...args.providerOptions } : void 0;
-  for (const [key, value] of Object.entries(args.providerOptions ?? {})) {
-    const previous = defaults?.[key];
-    if (previous && value && typeof previous === "object" && typeof value === "object" && !Array.isArray(previous) && !Array.isArray(value)) {
-      if (providerOptions) providerOptions[key] = { ...previous, ...value };
-    }
-  }
+  const providerOptions = resolveProviderOptions(
+    args.model.options?.providerOptions,
+    args.providerOptions
+  );
   const tools = args.tools ?? args.model.options?.tools;
   (0, import_core2.throwIfExecutionAborted)(abortSignal);
   const model = args.model.provider.getModel(args.model.modelId, {
@@ -1871,6 +1877,7 @@ var runReasonToolLoop = async (args) => {
   const tools = useReasonArgs.tools ?? [];
   const toolByName = /* @__PURE__ */ new Map();
   let validationCompleted = false;
+  let separateOutput = false;
   try {
     for (const tool of tools) {
       if (toolByName.has(tool.name)) {
@@ -1885,6 +1892,17 @@ var runReasonToolLoop = async (args) => {
         "useReason tools cannot be combined with useReason interrupt mode yet. Use toolExecution.approval for tool approval."
       );
     }
+    separateOutput = Boolean(
+      useReasonArgs.model.provider.getModel(useReasonArgs.model.modelId, {
+        ...useReasonArgs.model.options,
+        ...useReasonArgs.reasoning !== void 0 ? { reasoning: useReasonArgs.reasoning } : {},
+        ...useReasonArgs.responseFormat ? { responseFormat: useReasonArgs.responseFormat } : {},
+        providerOptions: resolveProviderOptions(
+          useReasonArgs.model.options?.providerOptions,
+          useReasonArgs.providerOptions
+        ) ?? {}
+      }).requiresSeparateStructuredOutput
+    );
     validationCompleted = true;
   } finally {
     if (!validationCompleted) {
@@ -1892,6 +1910,8 @@ var runReasonToolLoop = async (args) => {
     }
   }
   const toolDefinitions = toToolDefinitions(tools);
+  let finalizing = checkpoint?.finalizing ?? false;
+  let completed = false;
   const maxSteps = Math.max(1, useReasonArgs.toolExecution?.maxSteps ?? 3);
   const messages = checkpoint?.messages ?? createInitialMessages({
     system: useReasonArgs.system,
@@ -1926,6 +1946,7 @@ var runReasonToolLoop = async (args) => {
       messages,
       steps,
       approvedCalls,
+      finalizing,
       ...pending ? { pending } : {}
     };
     ctx.stateDirty = true;
@@ -1949,11 +1970,12 @@ var runReasonToolLoop = async (args) => {
       const stream = useReasonArgs.stream ?? useReasonArgs.model.options?.streaming ?? true;
       const emit = useReasonArgs.emit ?? true;
       let textStarted = false;
-      const structuredChunk = useReasonArgs.outputSchema && stream && emit && shouldStreamStructured(useReasonArgs.structured) ? createStructuredOutputStreamer(useReasonArgs, id, opId) : void 0;
+      const structuredChunk = useReasonArgs.outputSchema && (!separateOutput || finalizing) && stream && emit && shouldStreamStructured(useReasonArgs.structured) ? createStructuredOutputStreamer(useReasonArgs, id, opId) : void 0;
       const step = pending ?? await reasonEngine(
         {
           ...useReasonArgs,
-          tools: toolDefinitions,
+          tools: finalizing ? [] : toolDefinitions,
+          ...separateOutput && !finalizing ? { responseFormat: { type: "text" } } : {},
           messages,
           emit: false,
           stream,
@@ -1996,8 +2018,48 @@ var runReasonToolLoop = async (args) => {
           ...step.warnings ? { warnings: step.warnings } : {}
         });
       if (toolCalls.length === 0) {
+        if (separateOutput && !finalizing) {
+          if (args.allowValidatedToolOutput && useReasonArgs.outputSchema) {
+            try {
+              finalOutput = parseReasonOutputWithSchema({
+                text: step.text,
+                schema: useReasonArgs.outputSchema,
+                ...step.finishReason ? { finishReason: step.finishReason } : {},
+                label: "useReason output"
+              });
+              aggregatedWarnings = mergeWarnings(aggregatedWarnings, [
+                {
+                  type: "compatibility",
+                  feature: "responseFormat",
+                  details: "Reused locally validated tool-phase output without an extra native-schema request. Set responseFormat.schema explicitly to require provider schema enforcement."
+                }
+              ]);
+              completed = true;
+              break;
+            } catch {
+            }
+          }
+          messages.push({
+            role: "assistant",
+            content: step.text,
+            ...step.continuation ? { continuation: step.continuation } : {}
+          });
+          messages.push({
+            role: "user",
+            content: "Return the final answer using the requested output schema and the tool results above."
+          });
+          finalizing = true;
+          pending = void 0;
+          save();
+          continue;
+        }
+        completed = true;
         break;
       }
+      if (finalizing)
+        throw new Error(
+          "Provider requested a tool during schema-only finalization."
+        );
       if (!reused) {
         allToolCalls.push(...toolCalls);
         messages.push({
@@ -2141,26 +2203,26 @@ var runReasonToolLoop = async (args) => {
             message: result2.content
           });
         }
-        const completed = toolResults.at(-1);
-        if (completed)
+        const completed2 = toolResults.at(-1);
+        if (completed2)
           messages.push({
             role: "tool",
-            content: completed.content,
-            toolCallId: completed.toolCallId,
-            name: completed.name,
-            ...completed.isError !== void 0 ? { isError: completed.isError } : {}
+            content: completed2.content,
+            toolCallId: completed2.toolCallId,
+            name: completed2.name,
+            ...completed2.isError !== void 0 ? { isError: completed2.isError } : {}
           });
         save();
       }
       pending = void 0;
       save();
     }
-    if (steps.length >= maxSteps && steps.at(-1)?.toolCalls.length) {
+    if (!completed) {
       throw new Error(
         `useReason tool loop reached maxSteps (${maxSteps}) before producing a final response.`
       );
     }
-    if (useReasonArgs.outputSchema) {
+    if (useReasonArgs.outputSchema && finalOutput === void 0) {
       finalOutput = parseReasonOutputWithSchema({
         text: finalText,
         schema: useReasonArgs.outputSchema,
@@ -2244,6 +2306,9 @@ async function useReason(args) {
     args.model.options?.abortSignal
   );
   (0, import_core5.throwIfExecutionAborted)(abortSignal);
+  const allowValidatedToolOutput = Boolean(
+    args.outputSchema && !(args.responseFormat ?? args.model.options?.responseFormat)
+  );
   const inferred = inferOutputFormat(
     args.outputSchema,
     args.responseFormat ?? args.model.options?.responseFormat
@@ -2296,6 +2361,7 @@ async function useReason(args) {
   if (args.tools?.length) {
     return runReasonToolLoop({
       useReasonArgs: args,
+      allowValidatedToolOutput,
       checkpointKey,
       initialWarnings: inferred.warnings,
       ...id ? { id } : {},