@kortyx/agent 0.20.0 → 0.20.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.20.1](https://github.com/kortyx-io/kortyx/compare/agent-v0.20.0...agent-v0.20.1) (2026-09-11)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @kortyx/providers bumped to 0.6.1
+    * @kortyx/runtime bumped to 0.15.2
+  * devDependencies
+    * @kortyx/hooks bumped to 0.23.1
+
 ## [0.20.0](https://github.com/kortyx-io/kortyx/compare/agent-v0.19.0...agent-v0.20.0) (2026-09-11)
 
 

package/dist/index.js

@@ -432,6 +432,16 @@ var require_dist = __commonJS({
         ...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;
@@ -441,14 +451,10 @@ var require_dist = __commonJS({
       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_core22.throwIfExecutionAborted)(abortSignal);
       const model = args.model.provider.getModel(args.model.modelId, {
@@ -1861,6 +1867,7 @@ ${tryStringify2(args.response)}`
       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)) {
@@ -1875,6 +1882,17 @@ ${tryStringify2(args.response)}`
             "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) {
@@ -1882,6 +1900,8 @@ ${tryStringify2(args.response)}`
         }
       }
       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,
@@ -1916,6 +1936,7 @@ ${tryStringify2(args.response)}`
           messages,
           steps,
           approvedCalls,
+          finalizing,
           ...pending ? { pending } : {}
         };
         ctx.stateDirty = true;
@@ -1939,11 +1960,12 @@ ${tryStringify2(args.response)}`
           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,
@@ -1986,8 +2008,48 @@ ${tryStringify2(args.response)}`
               ...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({
@@ -2131,26 +2193,26 @@ ${tryStringify2(args.response)}`
                 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,
@@ -2232,6 +2294,9 @@ ${tryStringify2(args.response)}`
         args.model.options?.abortSignal
       );
       (0, import_core52.throwIfExecutionAborted)(abortSignal);
+      const allowValidatedToolOutput = Boolean(
+        args.outputSchema && !(args.responseFormat ?? args.model.options?.responseFormat)
+      );
       const inferred = inferOutputFormat(
         args.outputSchema,
         args.responseFormat ?? args.model.options?.responseFormat
@@ -2284,6 +2349,7 @@ ${tryStringify2(args.response)}`
       if (args.tools?.length) {
         return runReasonToolLoop({
           useReasonArgs: args,
+          allowValidatedToolOutput,
           checkpointKey,
           initialWarnings: inferred.warnings,
           ...id ? { id } : {},