@voltagent/core 2.6.7 → 2.6.8

package/dist/index.d.mts

@@ -9369,6 +9369,7 @@ declare class Agent {
      */
     private prepareExecution;
     private collectToolDataFromResult;
+    private ensureStructuredOutputGenerated;
     /**
      * Create execution context
      */

package/dist/index.d.ts

@@ -9369,6 +9369,7 @@ declare class Agent {
      */
     private prepareExecution;
     private collectToolDataFromResult;
+    private ensureStructuredOutputGenerated;
     /**
      * Create execution context
      */

package/dist/index.js

@@ -352,7 +352,7 @@ __export(index_exports, {
   hasFilePart: () => hasFilePart,
   hasImagePart: () => hasImagePart,
   hasTextPart: () => hasTextPart,
-  hasToolCall: () => import_ai8.hasToolCall,
+  hasToolCall: () => import_ai9.hasToolCall,
   isAbortError: () => isAbortError,
   isMiddlewareAbortError: () => isMiddlewareAbortError,
   isNodeRuntime: () => isNodeRuntime,
@@ -375,7 +375,7 @@ __export(index_exports, {
   serializeValueForDebug: () => serializeValueForDebug,
   setWaitUntil: () => setWaitUntil,
   shouldSample: () => shouldSample,
-  stepCountIs: () => import_ai8.stepCountIs,
+  stepCountIs: () => import_ai9.stepCountIs,
   tool: () => tool,
   trace: () => import_api9.trace,
   transformTextContent: () => transformTextContent,
@@ -30604,6 +30604,12 @@ var Agent = class {
                       onStepFinish: this.createStepHandler(oc, options)
                     })
                   );
+                  this.ensureStructuredOutputGenerated({
+                    result: response,
+                    output,
+                    tools,
+                    maxSteps
+                  });
                   const resolvedProviderUsage = response.usage ? await Promise.resolve(response.usage) : void 0;
                   finalizeLLMSpan(import_api16.SpanStatusCode.OK, {
                     usage: resolvedProviderUsage,
@@ -32345,6 +32351,42 @@ Metadata: ${(0, import_utils33.safeStringify)(metadata)}`;
       toolResults: stepToolResults.length > 0 ? stepToolResults : result.toolResults ?? []
     };
   }
+  ensureStructuredOutputGenerated(params) {
+    const { result, output, tools, maxSteps } = params;
+    if (!output) {
+      return;
+    }
+    try {
+      void result.output;
+    } catch (error) {
+      const isNoOutputGeneratedError = error instanceof import_ai7.NoOutputGeneratedError || error instanceof Error && error.name === "AI_NoOutputGeneratedError";
+      if (!isNoOutputGeneratedError) {
+        throw error;
+      }
+      const { toolCalls } = this.collectToolDataFromResult(result);
+      const configuredToolCount = Object.keys(tools ?? {}).length;
+      const stepCount = result.steps?.length ?? 0;
+      const finishReason = result.finishReason ?? "unknown";
+      const reachedMaxSteps = stepCount >= maxSteps;
+      const guidance = configuredToolCount > 0 || toolCalls.length > 0 ? "When tools are enabled, ensure the model emits a final non-tool response that matches the output schema, or split this into two calls (tools first, schema formatting second)." : "Ensure the model emits a final response that matches the requested output schema.";
+      const maxStepHint = reachedMaxSteps ? ` Generation stopped after ${stepCount} steps (maxSteps=${maxSteps}).` : "";
+      throw createVoltAgentError(
+        `Structured output was requested but no final output was generated (finishReason: ${finishReason}). ${guidance}${maxStepHint}`,
+        {
+          stage: "response_parsing",
+          code: "STRUCTURED_OUTPUT_NOT_GENERATED",
+          originalError: error,
+          metadata: {
+            finishReason,
+            stepCount,
+            maxSteps,
+            configuredToolCount,
+            toolCallCount: toolCalls.length
+          }
+        }
+      );
+    }
+  }
   /**
    * Create execution context
    */
@@ -33651,6 +33693,9 @@ ${retrieverContext}`;
     return true;
   }
   isRetryableError(error) {
+    if (isVoltAgentError(error) && error.code === "STRUCTURED_OUTPUT_NOT_GENERATED") {
+      return true;
+    }
     const retryable = error?.isRetryable;
     if (typeof retryable === "boolean") {
       return retryable;
@@ -41315,6 +41360,9 @@ var TriggerRegistry = class _TriggerRegistry {
   }
 };
 
+// src/voltagent.ts
+var import_ai8 = require("ai");
+
 // src/utils/voltops-validation.ts
 function isValidVoltOpsKeys(publicKey, secretKey) {
   if (!publicKey || !secretKey) {
@@ -41635,9 +41683,12 @@ var VoltAgent = class {
     process.once("SIGTERM", () => handleSignal("SIGTERM"));
     process.once("SIGINT", () => handleSignal("SIGINT"));
     process.on("unhandledRejection", (reason) => {
+      const isStructuredOutputWrapperError = isVoltAgentError(reason) && reason.code === "STRUCTURED_OUTPUT_NOT_GENERATED";
+      const isNoOutputGeneratedError = isStructuredOutputWrapperError || reason instanceof import_ai8.NoOutputGeneratedError || reason instanceof Error && reason.name === "AI_NoOutputGeneratedError";
       this.logger.error("[VoltAgent] Unhandled Promise Rejection:", {
         reason: reason instanceof Error ? reason.message : reason,
-        stack: reason instanceof Error ? reason.stack : void 0
+        stack: reason instanceof Error ? reason.stack : void 0,
+        hint: isNoOutputGeneratedError ? "Structured output was requested but no final output was generated. If tools are enabled, ensure a final schema-matching response or split into two calls." : void 0
       });
     });
   }
@@ -41943,7 +41994,7 @@ var VoltAgent = class {
 
 // src/index.ts
 var import_utils40 = require("@voltagent/internal/utils");
-var import_ai8 = require("ai");
+var import_ai9 = require("ai");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   A2AServerRegistry,