@voltagent/core 0.1.51 → 0.1.52

package/dist/index.d.ts

@@ -1102,6 +1102,11 @@ type AgentOptions = {
      * Sub-agents that this agent can delegate tasks to
      */
     subAgents?: any[];
+    /**
+     * Maximum number of steps (turns) the agent can take before stopping
+     * This overrides any supervisor config maxSteps setting
+     */
+    maxSteps?: number;
     /**
      * Optional user-defined context to be passed around
      */
@@ -1214,6 +1219,7 @@ interface CommonGenerateOptions {
     userId?: string;
     contextLimit?: number;
     tools?: BaseTool[];
+    maxSteps?: number;
     signal?: AbortSignal;
     historyEntryId?: string;
     operationContext?: OperationContext;
@@ -1326,6 +1332,11 @@ type AgentHandoffOptions = {
      * AbortSignal to cancel the handoff operation
      */
     signal?: AbortSignal;
+    /**
+     * Maximum number of steps for the subagent (inherited from parent or API call)
+     * If not provided, subagent will use its own maxSteps calculation
+     */
+    maxSteps?: number;
 };
 /**
  * Result of a handoff to another agent
@@ -2000,6 +2011,7 @@ type AgentStartEventMetadata = {
         stop?: string[];
         system?: string;
         toolChoice?: string;
+        maxSteps?: number;
     };
     systemPrompt?: string | BaseMessage | BaseMessage[];
     messages?: BaseMessage[];
@@ -2016,6 +2028,7 @@ interface AgentSuccessEventMetadata extends BaseEventMetadata {
         stop?: string[];
         system?: string;
         toolChoice?: string;
+        maxSteps?: number;
     };
 }
 interface MemoryEventMetadata extends BaseEventMetadata {
@@ -3202,7 +3215,7 @@ declare class SubAgentManager {
      * Calculate maximum number of steps based on sub-agents
      * More sub-agents means more potential steps
      */
-    calculateMaxSteps(): number;
+    calculateMaxSteps(agentMaxSteps?: number): number;
     /**
      * Generate enhanced system message for supervisor role
      * @param baseDescription - The base description of the agent
@@ -3232,6 +3245,7 @@ declare class SubAgentManager {
         currentHistoryEntryId?: string;
         operationContext?: OperationContext;
         forwardEvent?: (event: StreamEvent) => Promise<void>;
+        maxSteps?: number;
     }, Record<string, any>>): BaseTool;
     /**
      * Get sub-agent details for API exposure
@@ -3299,6 +3313,10 @@ declare class Agent<TProvider extends {
      * Indicates if the agent should format responses using Markdown.
      */
     readonly markdown: boolean;
+    /**
+     * Maximum number of steps the agent can take before stopping
+     */
+    readonly maxSteps?: number;
     /**
      * Memory manager for the agent
      */

package/dist/index.js

@@ -325,10 +325,6 @@ var BackgroundQueue = class {
       } catch (error) {
         lastError = error instanceof Error ? error : new Error(String(error));
         if (attempt < maxAttempts) {
-          import_dev.devLogger.warn(
-            `[Queue] Task ${task.id} failed (attempt ${attempt}/${maxAttempts}), retrying:`,
-            lastError.message
-          );
           await new Promise((resolve) => setTimeout(resolve, 50 * attempt));
         } else {
           import_dev.devLogger.error(
@@ -944,6 +940,10 @@ var GenerateOptionsSchema = import_zod_openapi.z.object({
   contextLimit: import_zod_openapi.z.number().int().positive().optional().default(10).openapi({
     description: "Optional limit for conversation history context"
   }),
+  maxSteps: import_zod_openapi.z.number().int().positive().optional().openapi({
+    description: "Maximum number of steps (turns) for this specific request (overrides agent's maxSteps)",
+    example: 5
+  }),
   temperature: import_zod_openapi.z.number().min(0).max(1).optional().default(0.7).openapi({ description: "Controls randomness (0-1)" }),
   maxTokens: import_zod_openapi.z.number().int().positive().optional().default(4e3).openapi({ description: "Maximum tokens to generate" }),
   topP: import_zod_openapi.z.number().min(0).max(1).optional().default(1).openapi({
@@ -7619,7 +7619,10 @@ var SubAgentManager = class {
    * Calculate maximum number of steps based on sub-agents
    * More sub-agents means more potential steps
    */
-  calculateMaxSteps() {
+  calculateMaxSteps(agentMaxSteps) {
+    if (agentMaxSteps !== void 0) {
+      return agentMaxSteps;
+    }
     return this.subAgents.length > 0 ? 10 * this.subAgents.length : 10;
   }
   /**
@@ -7685,7 +7688,8 @@ ${agentsMemory || "No previous agent interactions available."}
       userId,
       parentAgentId,
       parentHistoryEntryId,
-      parentOperationContext
+      parentOperationContext,
+      maxSteps
     } = options;
     const context = options.context;
     const sourceAgent = options.sourceAgent;
@@ -7717,7 +7721,9 @@ Context: ${JSON.stringify(context, null, 2)}`;
         parentHistoryEntryId,
         parentOperationContext,
         // Pass the abort signal from parent's operation context to subagent
-        signal: parentOperationContext?.signal
+        signal: parentOperationContext?.signal,
+        // Pass maxSteps from parent to subagent (inherits parent's effective maxSteps)
+        maxSteps
       });
       let finalText = "";
       if (streamResponse.fullStream) {
@@ -7861,6 +7867,7 @@ Context: ${JSON.stringify(context, null, 2)}`;
       parentAgentId,
       parentHistoryEntryId,
       parentOperationContext,
+      maxSteps,
       ...restOptions
     } = options;
     const handoffConversationId = conversationId || crypto.randomUUID();
@@ -7873,7 +7880,8 @@ Context: ${JSON.stringify(context, null, 2)}`;
             conversationId: handoffConversationId,
             parentAgentId,
             parentHistoryEntryId,
-            parentOperationContext
+            parentOperationContext,
+            maxSteps
           });
         } catch (error) {
           import_dev15.devLogger.error(`Error in handoffToMultiple for agent ${agent.name}:`, error);
@@ -7900,7 +7908,14 @@ Context: ${JSON.stringify(context, null, 2)}`;
    * task to one or more specialized agents
    */
   createDelegateTool(options) {
-    const { sourceAgent, forwardEvent, operationContext, currentHistoryEntryId, ...restOptions } = options;
+    const {
+      sourceAgent,
+      forwardEvent,
+      operationContext,
+      currentHistoryEntryId,
+      maxSteps,
+      ...restOptions
+    } = options;
     return createTool({
       id: "delegate_task",
       name: "delegate_task",
@@ -7945,6 +7960,8 @@ Context: ${JSON.stringify(context, null, 2)}`;
             parentOperationContext: operationContext,
             // Pass the real-time event forwarder
             forwardEvent,
+            // Pass maxSteps from parent to subagents
+            maxSteps,
             ...restOptions
           });
           const structuredResults = results.map((result, index) => {
@@ -8050,6 +8067,10 @@ var Agent = class {
    * Indicates if the agent should format responses using Markdown.
    */
   markdown;
+  /**
+   * Maximum number of steps the agent can take before stopping
+   */
+  maxSteps;
   /**
    * Memory manager for the agent
    */
@@ -8092,6 +8113,7 @@ var Agent = class {
     this.retriever = options.retriever;
     this.voice = options.voice;
     this.markdown = options.markdown ?? false;
+    this.maxSteps = options.maxSteps;
     this.voltOpsClient = options.voltOpsClient;
     if (options.hooks) {
       this.hooks = options.hooks;
@@ -8344,7 +8366,7 @@ ${retrieverContext}`;
    * Calculate maximum number of steps based on sub-agents
    */
   calculateMaxSteps() {
-    return this.subAgentManager.calculateMaxSteps();
+    return this.subAgentManager.calculateMaxSteps(this.maxSteps);
   }
   /**
    * Prepare common options for text generation
@@ -8352,6 +8374,7 @@ ${retrieverContext}`;
   async prepareTextOptions(options = {}) {
     const {
       tools: dynamicTools,
+      maxSteps: optionsMaxSteps,
       historyEntryId,
       operationContext,
       internalStreamForwarder
@@ -8429,6 +8452,8 @@ ${retrieverContext}`;
         operationContext: options.operationContext,
         forwardEvent,
         // Pass the real-time event forwarder
+        // Pass effective maxSteps (options override or agent default)
+        maxSteps: optionsMaxSteps ?? this.calculateMaxSteps(),
         ...options
       });
       const delegateIndex = toolsToUse.findIndex((tool2) => tool2.name === "delegate_task");
@@ -8440,7 +8465,7 @@ ${retrieverContext}`;
     }
     return {
       tools: toolsToUse,
-      maxSteps: this.calculateMaxSteps()
+      maxSteps: optionsMaxSteps ?? this.calculateMaxSteps()
     };
   }
   /**
@@ -8784,7 +8809,8 @@ ${retrieverContext}`;
             temperature: internalOptions.provider?.temperature,
             topP: internalOptions.provider?.topP,
             frequencyPenalty: internalOptions.provider?.frequencyPenalty,
-            presencePenalty: internalOptions.provider?.presencePenalty
+            presencePenalty: internalOptions.provider?.presencePenalty,
+            maxSteps: internalOptions.maxSteps
           }
         },
         traceId: operationContext.historyEntry.id
@@ -8973,7 +8999,8 @@ ${retrieverContext}`;
             temperature: internalOptions.provider?.temperature,
             topP: internalOptions.provider?.topP,
             frequencyPenalty: internalOptions.provider?.frequencyPenalty,
-            presencePenalty: internalOptions.provider?.presencePenalty
+            presencePenalty: internalOptions.provider?.presencePenalty,
+            maxSteps: internalOptions.maxSteps
           }
         },
         traceId: operationContext.historyEntry.id,
@@ -9144,7 +9171,8 @@ ${retrieverContext}`;
           temperature: internalOptions.provider?.temperature,
           topP: internalOptions.provider?.topP,
           frequencyPenalty: internalOptions.provider?.frequencyPenalty,
-          presencePenalty: internalOptions.provider?.presencePenalty
+          presencePenalty: internalOptions.provider?.presencePenalty,
+          maxSteps: internalOptions.maxSteps
         }
       },
       traceId: operationContext.historyEntry.id
@@ -9381,7 +9409,8 @@ ${retrieverContext}`;
               temperature: internalOptions.provider?.temperature,
               topP: internalOptions.provider?.topP,
               frequencyPenalty: internalOptions.provider?.frequencyPenalty,
-              presencePenalty: internalOptions.provider?.presencePenalty
+              presencePenalty: internalOptions.provider?.presencePenalty,
+              maxSteps: internalOptions.maxSteps
             }
           },
           traceId: operationContext.historyEntry.id,
@@ -9611,7 +9640,8 @@ ${retrieverContext}`;
             temperature: internalOptions.provider?.temperature,
             topP: internalOptions.provider?.topP,
             frequencyPenalty: internalOptions.provider?.frequencyPenalty,
-            presencePenalty: internalOptions.provider?.presencePenalty
+            presencePenalty: internalOptions.provider?.presencePenalty,
+            maxSteps: internalOptions.maxSteps
           }
         },
         traceId: operationContext.historyEntry.id
@@ -9684,7 +9714,8 @@ ${retrieverContext}`;
             temperature: internalOptions.provider?.temperature,
             topP: internalOptions.provider?.topP,
             frequencyPenalty: internalOptions.provider?.frequencyPenalty,
-            presencePenalty: internalOptions.provider?.presencePenalty
+            presencePenalty: internalOptions.provider?.presencePenalty,
+            maxSteps: internalOptions.maxSteps
           }
         },
         traceId: operationContext.historyEntry.id,
@@ -9857,7 +9888,8 @@ ${retrieverContext}`;
           temperature: internalOptions.provider?.temperature,
           topP: internalOptions.provider?.topP,
           frequencyPenalty: internalOptions.provider?.frequencyPenalty,
-          presencePenalty: internalOptions.provider?.presencePenalty
+          presencePenalty: internalOptions.provider?.presencePenalty,
+          maxSteps: internalOptions.maxSteps
         }
       },
       traceId: operationContext.historyEntry.id
@@ -9934,7 +9966,8 @@ ${retrieverContext}`;
                 temperature: internalOptions.provider?.temperature,
                 topP: internalOptions.provider?.topP,
                 frequencyPenalty: internalOptions.provider?.frequencyPenalty,
-                presencePenalty: internalOptions.provider?.presencePenalty
+                presencePenalty: internalOptions.provider?.presencePenalty,
+                maxSteps: internalOptions.maxSteps
               }
             },
             traceId: operationContext.historyEntry.id,