@voltagent/core 0.1.44 → 0.1.45

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { Span } from '@opentelemetry/api';
-import { Simplify, LiteralUnion } from 'type-fest';
+import { Simplify, LiteralUnion, MergeDeep } from 'type-fest';
 import { Context } from 'hono';
 import { SpanExporter } from '@opentelemetry/sdk-trace-base';
 import { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
@@ -1051,15 +1051,15 @@ type AgentHandoffOptions = {
      * Parent history entry ID
      */
     parentHistoryEntryId?: string;
-    /**
-     * Optional user-defined context to be passed from the supervisor agent
-     */
-    userContext?: Map<string | symbol, unknown>;
     /**
      * Optional real-time event forwarder function
      * Used to forward SubAgent events to parent stream in real-time
      */
     forwardEvent?: (event: StreamEvent) => Promise<void>;
+    /**
+     * Parent's operation context to merge SubAgent steps into
+     */
+    parentOperationContext?: OperationContext;
 };
 /**
  * Result of a handoff to another agent
@@ -2873,12 +2873,17 @@ declare class SubAgentManager {
      */
     handoffToMultiple(options: Omit<AgentHandoffOptions, "targetAgent"> & {
         targetAgents: Agent<any>[];
-        userContext?: Map<string | symbol, unknown>;
     }): Promise<AgentHandoffResult[]>;
     /**
-     * Create a delegate tool for sub-agents
+     * Creates a tool that allows the supervisor agent to delegate a
+     * task to one or more specialized agents
      */
-    createDelegateTool(options?: Record<string, any>): BaseTool;
+    createDelegateTool(options: MergeDeep<{
+        sourceAgent: Agent<any>;
+        currentHistoryEntryId?: string;
+        operationContext?: OperationContext;
+        forwardEvent?: (event: StreamEvent) => Promise<void>;
+    }, Record<string, any>>): BaseTool;
     /**
      * Get sub-agent details for API exposure
      */

package/dist/index.js

@@ -6898,15 +6898,15 @@ ${agentsMemory || "No previous agent interactions available."}
   async handoffTask(options) {
     const {
       task,
-      targetAgent,
-      context = {},
       conversationId,
       userId,
-      sourceAgent,
       parentAgentId,
       parentHistoryEntryId,
-      userContext
+      parentOperationContext
     } = options;
+    const context = options.context;
+    const sourceAgent = options.sourceAgent;
+    const targetAgent = options.targetAgent;
     const handoffConversationId = conversationId || crypto.randomUUID();
     try {
       if (sourceAgent && targetAgent.hooks) {
@@ -6922,15 +6922,17 @@ ${task}
 Context: ${JSON.stringify(context, null, 2)}`;
       }
       const taskMessage = {
-        role: "system",
+        role: "user",
         content: taskContent
       };
       const streamResponse = await targetAgent.streamText([...sharedContext, taskMessage], {
         conversationId: handoffConversationId,
         userId,
+        // TODO: Fix the types here
+        // @ts-expect-error - bad types
         parentAgentId: sourceAgent?.id || parentAgentId,
         parentHistoryEntryId,
-        userContext
+        parentOperationContext
       });
       let finalText = "";
       if (streamResponse.fullStream) {
@@ -7021,8 +7023,8 @@ Context: ${JSON.stringify(context, null, 2)}`;
               const eventData = {
                 type: "error",
                 data: {
+                  // @ts-expect-error - fix bad type
                   error: part.error?.message || "Stream error occurred",
-                  // @ts-expect-error - code is not part of the StreamEventError type currently
                   code: "STREAM_ERROR"
                 },
                 timestamp,
@@ -7073,7 +7075,7 @@ Context: ${JSON.stringify(context, null, 2)}`;
       conversationId,
       parentAgentId,
       parentHistoryEntryId,
-      userContext,
+      parentOperationContext,
       ...restOptions
     } = options;
     const handoffConversationId = conversationId || crypto.randomUUID();
@@ -7086,7 +7088,7 @@ Context: ${JSON.stringify(context, null, 2)}`;
             conversationId: handoffConversationId,
             parentAgentId,
             parentHistoryEntryId,
-            userContext
+            parentOperationContext
           });
         } catch (error) {
           import_dev13.devLogger.error(`Error in handoffToMultiple for agent ${agent.name}:`, error);
@@ -7109,9 +7111,11 @@ Context: ${JSON.stringify(context, null, 2)}`;
     return results;
   }
   /**
-   * Create a delegate tool for sub-agents
+   * Creates a tool that allows the supervisor agent to delegate a
+   * task to one or more specialized agents
    */
-  createDelegateTool(options = {}) {
+  createDelegateTool(options) {
+    const { sourceAgent, forwardEvent, operationContext, currentHistoryEntryId, ...restOptions } = options;
     return createTool({
       id: "delegate_task",
       name: "delegate_task",
@@ -7143,11 +7147,6 @@ Context: ${JSON.stringify(context, null, 2)}`;
               `No valid target agents found. Available agents: ${this.subAgents.map((a) => a.name).join(", ")}`
             );
           }
-          const sourceAgent = options.sourceAgent;
-          const operationContext = options.operationContext;
-          const supervisorUserContext = operationContext?.userContext;
-          const currentHistoryEntryId = options.currentHistoryEntryId;
-          const forwardEvent = options.forwardEvent;
           const results = await this.handoffToMultiple({
             task,
             targetAgents: agents,
@@ -7155,12 +7154,13 @@ Context: ${JSON.stringify(context, null, 2)}`;
             sourceAgent,
             // Pass parent context for event propagation
             parentAgentId: sourceAgent?.id,
+            // Get current history entry ID for parent context
+            // This is passed from the Agent class via options when the tool is called
             parentHistoryEntryId: currentHistoryEntryId,
-            // Pass the supervisor's userContext to the handoff options
-            userContext: supervisorUserContext,
+            parentOperationContext: operationContext,
             // Pass the real-time event forwarder
             forwardEvent,
-            ...options
+            ...restOptions
           });
           const structuredResults = results.map((result, index) => {
             const status = result.status || "success";
@@ -7663,13 +7663,14 @@ ${context}`;
     });
     const opContext = {
       operationId: historyEntry.id,
-      userContext: options.userContext ?? /* @__PURE__ */ new Map(),
+      userContext: (options.parentOperationContext?.userContext || options.userContext) ?? /* @__PURE__ */ new Map(),
       historyEntry,
       isActive: true,
       parentAgentId: options.parentAgentId,
       parentHistoryEntryId: options.parentHistoryEntryId,
       otelSpan,
-      conversationSteps: []
+      // Use parent's conversationSteps if available (for SubAgents), otherwise create new array
+      conversationSteps: options.parentOperationContext?.conversationSteps || []
     };
     return opContext;
   }
@@ -7850,6 +7851,7 @@ ${context}`;
       conversationId: initialConversationId,
       parentAgentId,
       parentHistoryEntryId,
+      parentOperationContext,
       contextLimit = 10,
       userContext
     } = internalOptions;
@@ -7859,7 +7861,8 @@ ${context}`;
       operationName: "generateText",
       userContext,
       userId,
-      conversationId: initialConversationId
+      conversationId: initialConversationId,
+      parentOperationContext
     });
     const { messages: contextMessages, conversationId: finalConversationId } = await this.memoryManager.prepareConversationContext(
       operationContext,
@@ -8194,6 +8197,7 @@ ${context}`;
       conversationId: initialConversationId,
       parentAgentId,
       parentHistoryEntryId,
+      parentOperationContext,
       contextLimit = 10,
       userContext
     } = internalOptions;
@@ -8203,7 +8207,8 @@ ${context}`;
       operationName: "streamText",
       userContext,
       userId,
-      conversationId: initialConversationId
+      conversationId: initialConversationId,
+      parentOperationContext
     });
     const { messages: contextMessages, conversationId: finalConversationId } = await this.memoryManager.prepareConversationContext(
       operationContext,
@@ -8637,6 +8642,7 @@ ${context}`;
       conversationId: initialConversationId,
       parentAgentId,
       parentHistoryEntryId,
+      parentOperationContext,
       contextLimit = 10,
       userContext
     } = internalOptions;
@@ -8646,7 +8652,8 @@ ${context}`;
       operationName: "generateObject",
       userContext,
       userId,
-      conversationId: initialConversationId
+      conversationId: initialConversationId,
+      parentOperationContext
     });
     const { messages: contextMessages, conversationId: finalConversationId } = await this.memoryManager.prepareConversationContext(
       operationContext,
@@ -8866,6 +8873,7 @@ ${context}`;
       conversationId: initialConversationId,
       parentAgentId,
       parentHistoryEntryId,
+      parentOperationContext,
       provider,
       contextLimit = 10,
       userContext
@@ -8876,7 +8884,8 @@ ${context}`;
       operationName: "streamObject",
       userContext,
       userId,
-      conversationId: initialConversationId
+      conversationId: initialConversationId,
+      parentOperationContext
     });
     const { messages: contextMessages, conversationId: finalConversationId } = await this.memoryManager.prepareConversationContext(
       operationContext,