@voltagent/core 0.1.15 → 0.1.17

package/dist/index.d.ts

@@ -457,6 +457,10 @@ type AgentOptions = {
      * Sub-agents that this agent can delegate tasks to
      */
     subAgents?: any[];
+    /**
+     * Optional user-defined context to be passed around
+     */
+    userContext?: Map<string | symbol, unknown>;
 } & ({
     /**
      * @deprecated Use `instructions` instead.
@@ -528,6 +532,7 @@ interface CommonGenerateOptions {
     signal?: AbortSignal;
     historyEntryId?: string;
     operationContext?: OperationContext;
+    userContext?: Map<string | symbol, unknown>;
 }
 /**
  * Public-facing generate options for external users
@@ -623,6 +628,10 @@ type AgentHandoffOptions = {
      * Parent history entry ID
      */
     parentHistoryEntryId?: string;
+    /**
+     * Optional user-defined context to be passed from the supervisor agent
+     */
+    userContext?: Map<string | symbol, unknown>;
 };
 /**
  * Result of a handoff to another agent
@@ -1805,6 +1814,7 @@ 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

package/dist/index.js

@@ -4380,7 +4380,8 @@ ${agentsMemory || "No previous agent interactions available."}
         userId,
         sourceAgent,
         parentAgentId,
-        parentHistoryEntryId
+        parentHistoryEntryId,
+        userContext
       } = options;
       const handoffConversationId = conversationId || crypto.randomUUID();
       try {
@@ -4398,7 +4399,8 @@ Context: ${JSON.stringify(context)}`
           conversationId: handoffConversationId,
           userId,
           parentAgentId: (sourceAgent == null ? void 0 : sourceAgent.id) || parentAgentId,
-          parentHistoryEntryId
+          parentHistoryEntryId,
+          userContext
         });
         return {
           result: response.text,
@@ -4429,7 +4431,19 @@ Context: ${JSON.stringify(context)}`
    */
   handoffToMultiple(options) {
     return __async(this, null, function* () {
-      const _a = options, { targetAgents, conversationId, parentAgentId, parentHistoryEntryId } = _a, restOptions = __objRest(_a, ["targetAgents", "conversationId", "parentAgentId", "parentHistoryEntryId"]);
+      const _a = options, {
+        targetAgents,
+        conversationId,
+        parentAgentId,
+        parentHistoryEntryId,
+        userContext
+      } = _a, restOptions = __objRest(_a, [
+        "targetAgents",
+        "conversationId",
+        "parentAgentId",
+        "parentHistoryEntryId",
+        "userContext"
+      ]);
       const handoffConversationId = conversationId || crypto.randomUUID();
       const results = yield Promise.all(
         targetAgents.map((agent) => __async(this, null, function* () {
@@ -4438,7 +4452,8 @@ Context: ${JSON.stringify(context)}`
               targetAgent: agent,
               conversationId: handoffConversationId,
               parentAgentId,
-              parentHistoryEntryId
+              parentHistoryEntryId,
+              userContext
             }));
           } catch (error) {
             console.error(`Error in handoffToMultiple for agent ${agent.name}:`, error);
@@ -4497,6 +4512,8 @@ Context: ${JSON.stringify(context)}`
             );
           }
           const sourceAgent = options.sourceAgent;
+          const operationContext = options.operationContext;
+          const supervisorUserContext = operationContext == null ? void 0 : operationContext.userContext;
           const currentHistoryEntryId = options.currentHistoryEntryId;
           const results = yield this.handoffToMultiple(__spreadValues({
             task,
@@ -4505,7 +4522,9 @@ Context: ${JSON.stringify(context)}`
             sourceAgent,
             // Pass parent context for event propagation
             parentAgentId: sourceAgent == null ? void 0 : sourceAgent.id,
-            parentHistoryEntryId: currentHistoryEntryId
+            parentHistoryEntryId: currentHistoryEntryId,
+            // Pass the supervisor's userContext to the handoff options
+            userContext: supervisorUserContext
           }, options));
           return results.map((result, index) => {
             const status = result.status || "success";
@@ -5137,7 +5156,7 @@ ${context}`;
       });
       const opContext = {
         operationId: historyEntry.id,
-        userContext: /* @__PURE__ */ new Map(),
+        userContext: options.userContext ? new Map(options.userContext) : /* @__PURE__ */ new Map(),
         historyEntry,
         eventUpdaters: /* @__PURE__ */ new Map(),
         isActive: true,
@@ -5240,12 +5259,14 @@ ${context}`;
         conversationId: initialConversationId,
         parentAgentId,
         parentHistoryEntryId,
-        contextLimit = 10
+        contextLimit = 10,
+        userContext
       } = internalOptions;
       const operationContext = yield this.initializeHistory(input, "working", {
         parentAgentId,
         parentHistoryEntryId,
-        operationName: "generateText"
+        operationName: "generateText",
+        userContext
       });
       const { messages: contextMessages, conversationId: finalConversationId } = yield this.memoryManager.prepareConversationContext(
         operationContext,
@@ -5438,12 +5459,14 @@ ${context}`;
         conversationId: initialConversationId,
         parentAgentId,
         parentHistoryEntryId,
-        contextLimit = 10
+        contextLimit = 10,
+        userContext
       } = internalOptions;
       const operationContext = yield this.initializeHistory(input, "working", {
         parentAgentId,
         parentHistoryEntryId,
-        operationName: "streamText"
+        operationName: "streamText",
+        userContext
       });
       const { messages: contextMessages, conversationId: finalConversationId } = yield this.memoryManager.prepareConversationContext(
         operationContext,
@@ -5687,12 +5710,14 @@ ${context}`;
         conversationId: initialConversationId,
         parentAgentId,
         parentHistoryEntryId,
-        contextLimit = 10
+        contextLimit = 10,
+        userContext
       } = internalOptions;
       const operationContext = yield this.initializeHistory(input, "working", {
         parentAgentId,
         parentHistoryEntryId,
-        operationName: "generateObject"
+        operationName: "generateObject",
+        userContext
       });
       const { messages: contextMessages, conversationId: finalConversationId } = yield this.memoryManager.prepareConversationContext(
         operationContext,
@@ -5823,12 +5848,14 @@ ${context}`;
         parentAgentId,
         parentHistoryEntryId,
         provider,
-        contextLimit = 10
+        contextLimit = 10,
+        userContext
       } = internalOptions;
       const operationContext = yield this.initializeHistory(input, "working", {
         parentAgentId,
         parentHistoryEntryId,
-        operationName: "streamObject"
+        operationName: "streamObject",
+        userContext
       });
       const { messages: contextMessages, conversationId: finalConversationId } = yield this.memoryManager.prepareConversationContext(
         operationContext,