@voltagent/core 0.1.3 → 0.1.4

package/dist/index.d.ts

@@ -1148,22 +1148,30 @@ type AgentHandoffOptions = {
     parentHistoryEntryId?: string;
 };
 /**
- * Agent handoff result
+ * Result of a handoff to another agent
  */
-type AgentHandoffResult = {
+interface AgentHandoffResult {
     /**
-     * The result of the handoff operation
+     * Result text from the agent
      */
     result: string;
     /**
-     * The conversation ID of the handoff
+     * Conversation ID used for the interaction
      */
     conversationId: string;
     /**
-     * The messages exchanged during the handoff
+     * Messages exchanged during the handoff
      */
     messages: BaseMessage[];
-};
+    /**
+     * Status of the handoff operation
+     */
+    status?: "success" | "error";
+    /**
+     * Error information if the handoff failed
+     */
+    error?: Error | string;
+}
 /**
  * Operation context to isolate state for concurrent operations
  * Prevents race conditions when the same agent instance is used concurrently
@@ -1553,8 +1561,9 @@ declare class SubAgentManager {
     /**
      * Generate enhanced system message for supervisor role
      * @param baseDescription - The base description of the agent
+     * @param agentsMemory - Optional string containing formatted memory from previous agent interactions
      */
-    generateSupervisorSystemMessage(baseDescription: string): string;
+    generateSupervisorSystemMessage(baseDescription: string, agentsMemory?: string): string;
     /**
      * Check if the agent has sub-agents
      */
@@ -1841,10 +1850,16 @@ declare class Agent<TProvider extends {
     /**
      * Get the system message for the agent
      */
-    protected getSystemMessage({ input, historyEntryId, }: {
+    protected getSystemMessage({ input, historyEntryId, contextMessages, }: {
         input?: string | BaseMessage[];
         historyEntryId: string;
+        contextMessages: BaseMessage[];
     }): Promise<BaseMessage>;
+    /**
+     * Prepare agents memory for the supervisor system message
+     * This fetches and formats recent interactions with sub-agents
+     */
+    private prepareAgentsMemory;
     /**
      * Add input to messages array based on type
      */
@@ -1911,7 +1926,7 @@ declare class Agent<TProvider extends {
      */
     private createStandardTimelineEvent;
     /**
-     * Tool event creator
+     * Fix delete operator usage for better performance
      */
     private addToolEvent;
     /**
@@ -2039,7 +2054,7 @@ interface ToolCall {
 declare function zodSchemaToJsonUI(schema: any): any;
 
 /**
- * Ajanlar, araçlar ve diğer bileşenler için node tipleri
+ * Node types for agents, tools, and other components
  */
 declare enum NodeType {
     AGENT = "agent",
@@ -2051,17 +2066,17 @@ declare enum NodeType {
     RETRIEVER = "retriever"
 }
 /**
- * Standart node ID oluşturma fonksiyonu
- * @param type Node tipi
- * @param name Ana tanımlayıcı (tool adı, agent adı vb.)
- * @param ownerId Sahibinin ID'si (isteğe bağlı)
- * @returns Standart formatlanmış node ID
+ * Standard node ID creation function
+ * @param type Node type
+ * @param name Main identifier (tool name, agent name, etc.)
+ * @param ownerId Owner ID (optional)
+ * @returns Standard formatted node ID
  */
 declare const createNodeId: (type: NodeType, name: string, ownerId?: string) => string;
 /**
- * NodeID'den node tipini çıkaran fonksiyon
+ * Function to extract node type from NodeID
  * @param nodeId Node ID
- * @returns NodeType veya null (tip bulunamazsa)
+ * @returns NodeType or null (if type cannot be found)
  */
 declare const getNodeTypeFromNodeId: (nodeId: string) => NodeType | null;
 

package/dist/index.js

@@ -3716,17 +3716,24 @@ var SubAgentManager = class {
   /**
    * Generate enhanced system message for supervisor role
    * @param baseDescription - The base description of the agent
+   * @param agentsMemory - Optional string containing formatted memory from previous agent interactions
    */
-  generateSupervisorSystemMessage(baseDescription) {
+  generateSupervisorSystemMessage(baseDescription, agentsMemory = "") {
     if (this.subAgents.length === 0) {
       return baseDescription;
     }
     const subAgentList = this.subAgents.map((agent) => `- ${agent.name}: ${agent.description}`).join("\n");
-    return `You are a supervisor agent that coordinates between specialized agents:
+    return `
+    You are a supervisor agent that coordinates between specialized agents:
 
+<specialized_agents>
 ${subAgentList}
+</specialized_agents>
+
+<instructions>
+${baseDescription}
+</instructions>
 
-When communicating with other agents, including the User, please follow these guidelines:
 <guidelines>
 - Provide a final answer to the User when you have a response from all agents.
 - Do not mention the name of any agent in your response.
@@ -3749,7 +3756,7 @@ When communicating with other agents, including the User, please follow these gu
 </guidelines>
 
 <agents_memory>
-{{AGENTS_MEMORY}}
+${agentsMemory || "No previous agent interactions available."}
 </agents_memory>
 `;
   }
@@ -3776,27 +3783,45 @@ When communicating with other agents, including the User, please follow these gu
         parentHistoryEntryId
       } = options;
       const handoffConversationId = conversationId || crypto.randomUUID();
-      if (sourceAgent && targetAgent.hooks) {
-        yield (_b = (_a = targetAgent.hooks).onHandoff) == null ? void 0 : _b.call(_a, targetAgent, sourceAgent);
-      }
-      const sharedContext = options.sharedContext || [];
-      const handoffMessage = {
-        role: "system",
-        content: `Task handed off from ${(sourceAgent == null ? void 0 : sourceAgent.name) || this.agentName} to ${targetAgent.name}:
+      try {
+        if (sourceAgent && targetAgent.hooks) {
+          yield (_b = (_a = targetAgent.hooks).onHandoff) == null ? void 0 : _b.call(_a, targetAgent, sourceAgent);
+        }
+        const sharedContext = options.sharedContext || [];
+        const handoffMessage = {
+          role: "system",
+          content: `Task handed off from ${(sourceAgent == null ? void 0 : sourceAgent.name) || this.agentName} to ${targetAgent.name}:
 ${task}
 Context: ${JSON.stringify(context)}`
-      };
-      const response = yield targetAgent.generateText([handoffMessage, ...sharedContext], {
-        conversationId: handoffConversationId,
-        userId,
-        parentAgentId: (sourceAgent == null ? void 0 : sourceAgent.id) || parentAgentId,
-        parentHistoryEntryId
-      });
-      return {
-        result: response.text,
-        conversationId: handoffConversationId,
-        messages: [handoffMessage, { role: "assistant", content: response.text }]
-      };
+        };
+        const response = yield targetAgent.generateText([handoffMessage, ...sharedContext], {
+          conversationId: handoffConversationId,
+          userId,
+          parentAgentId: (sourceAgent == null ? void 0 : sourceAgent.id) || parentAgentId,
+          parentHistoryEntryId
+        });
+        return {
+          result: response.text,
+          conversationId: handoffConversationId,
+          messages: [handoffMessage, { role: "assistant", content: response.text }],
+          status: "success"
+        };
+      } catch (error) {
+        console.error(`Error in handoffTask to ${targetAgent.name}:`, error);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+          result: `Error in delegating task to ${targetAgent.name}: ${errorMessage}`,
+          conversationId: handoffConversationId,
+          messages: [
+            {
+              role: "system",
+              content: `Error occurred during task handoff: ${errorMessage}`
+            }
+          ],
+          status: "error",
+          error: error instanceof Error ? error : String(error)
+        };
+      }
     });
   }
   /**
@@ -3805,16 +3830,35 @@ 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"]);
-      return Promise.all(
-        targetAgents.map(
-          (agent) => this.handoffTask(__spreadProps(__spreadValues({}, restOptions), {
-            targetAgent: agent,
-            conversationId,
-            parentAgentId,
-            parentHistoryEntryId
-          }))
-        )
+      const handoffConversationId = conversationId || crypto.randomUUID();
+      const results = yield Promise.all(
+        targetAgents.map((agent) => __async(this, null, function* () {
+          try {
+            return yield this.handoffTask(__spreadProps(__spreadValues({}, restOptions), {
+              targetAgent: agent,
+              conversationId: handoffConversationId,
+              parentAgentId,
+              parentHistoryEntryId
+            }));
+          } catch (error) {
+            console.error(`Error in handoffToMultiple for agent ${agent.name}:`, error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+              result: `Error in delegating task to ${agent.name}: ${errorMessage}`,
+              conversationId: handoffConversationId,
+              messages: [
+                {
+                  role: "system",
+                  content: `Error occurred during task handoff: ${errorMessage}`
+                }
+              ],
+              status: "error",
+              error: error instanceof Error ? error : String(error)
+            };
+          }
+        }))
       );
+      return results;
     });
   }
   /**
@@ -3830,26 +3874,56 @@ Context: ${JSON.stringify(context)}`
         context: import_zod.z.record(import_zod.z.unknown()).optional().describe("Additional context for the task")
       }),
       execute: (_0) => __async(this, [_0], function* ({ task, targetAgents, context = {} }) {
-        const agents = targetAgents.map((name) => this.subAgents.find((a) => a.name === name)).filter((agent) => agent !== void 0);
-        if (agents.length === 0) {
-          throw new Error("No valid target agents found");
+        try {
+          if (!task || task.trim() === "") {
+            throw new Error("Task cannot be empty");
+          }
+          if (!targetAgents || !Array.isArray(targetAgents) || targetAgents.length === 0) {
+            throw new Error("At least one target agent must be specified");
+          }
+          const agents = targetAgents.map((name) => {
+            const agent = this.subAgents.find((a) => a.name === name);
+            if (!agent) {
+              console.warn(
+                `Agent "${name}" not found. Available agents: ${this.subAgents.map((a) => a.name).join(", ")}`
+              );
+            }
+            return agent;
+          }).filter((agent) => agent !== void 0);
+          if (agents.length === 0) {
+            throw new Error(
+              `No valid target agents found. Available agents: ${this.subAgents.map((a) => a.name).join(", ")}`
+            );
+          }
+          const sourceAgent = options.sourceAgent;
+          const currentHistoryEntryId = options.currentHistoryEntryId;
+          const results = yield this.handoffToMultiple(__spreadValues({
+            task,
+            targetAgents: agents,
+            context,
+            sourceAgent,
+            // Pass parent context for event propagation
+            parentAgentId: sourceAgent == null ? void 0 : sourceAgent.id,
+            parentHistoryEntryId: currentHistoryEntryId
+          }, options));
+          return results.map((result, index) => {
+            const status = result.status || "success";
+            const errorInfo = status === "error" && result.error ? typeof result.error === "string" ? result.error : result.error.message : void 0;
+            return {
+              agentName: agents[index].name,
+              response: result.result,
+              conversationId: result.conversationId,
+              status,
+              error: errorInfo
+            };
+          });
+        } catch (error) {
+          console.error("Error in delegate_task tool execution:", error);
+          return {
+            error: `Failed to delegate task: ${error instanceof Error ? error.message : String(error)}`,
+            status: "error"
+          };
         }
-        const sourceAgent = options.sourceAgent;
-        const currentHistoryEntryId = options.currentHistoryEntryId;
-        const results = yield this.handoffToMultiple(__spreadValues({
-          task,
-          targetAgents: agents,
-          context,
-          sourceAgent,
-          // Pass parent context for event propagation
-          parentAgentId: sourceAgent == null ? void 0 : sourceAgent.id,
-          parentHistoryEntryId: currentHistoryEntryId
-        }, options));
-        return results.map((result, index) => ({
-          agentName: agents[index].name,
-          response: result.result,
-          conversationId: result.conversationId
-        }));
       })
     };
   }
@@ -3915,25 +3989,25 @@ var Agent = class {
       }
     }, "createStandardTimelineEvent");
     /**
-     * Tool event creator
+     * Fix delete operator usage for better performance
      */
     this.addToolEvent = /* @__PURE__ */ __name((_0, _1, _2, _3, ..._4) => __async(this, [_0, _1, _2, _3, ..._4], function* (context, eventName, toolName, status, data = {}) {
       const toolNodeId = createNodeId("tool" /* TOOL */, toolName, this.id);
       const metadata = __spreadValues({
         toolName
       }, data.metadata || {});
-      if (data.toolId) {
-        metadata.toolId = data.toolId;
-        delete data.toolId;
+      const { toolId, input, output, error, errorMessage } = data;
+      if (toolId) {
+        metadata.toolId = toolId;
       }
       const eventData = {
         affectedNodeId: toolNodeId,
         status,
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        input: data.input,
-        output: data.output,
-        error: data.error,
-        errorMessage: data.errorMessage,
+        input,
+        output,
+        error,
+        errorMessage,
         metadata
       };
       metadata.sourceAgentId = this.id;
@@ -3971,11 +4045,11 @@ var Agent = class {
      */
     this.addAgentEvent = /* @__PURE__ */ __name((context, eventName, status, data = {}) => {
       const metadata = __spreadValues({}, data.metadata || {});
-      if (data.usage) {
-        metadata.usage = data.usage;
-        delete data.usage;
+      const _a = data, { usage } = _a, standardData = __objRest(_a, ["usage"]);
+      if (usage) {
+        metadata.usage = usage;
       }
-      const standardData = __spreadProps(__spreadValues({}, data), {
+      const eventData = __spreadProps(__spreadValues({}, standardData), {
         metadata
       });
       this.createStandardTimelineEvent(
@@ -3984,7 +4058,7 @@ var Agent = class {
         status,
         "agent" /* AGENT */,
         this.id,
-        standardData,
+        eventData,
         "agent",
         context
       );
@@ -4016,7 +4090,8 @@ var Agent = class {
   getSystemMessage(_0) {
     return __async(this, arguments, function* ({
       input,
-      historyEntryId
+      historyEntryId,
+      contextMessages
     }) {
       let description = this.description;
       if (this.retriever && input && historyEntryId) {
@@ -4037,7 +4112,7 @@ var Agent = class {
         });
         try {
           const context = yield this.retriever.retrieve(input);
-          if (context && context.trim()) {
+          if (context == null ? void 0 : context.trim()) {
             description = `${description}
 
 Relevant Context:
@@ -4062,7 +4137,12 @@ ${context}`;
         }
       }
       if (this.subAgentManager.hasSubAgents()) {
-        description = this.subAgentManager.generateSupervisorSystemMessage(description);
+        const agentsMemory = yield this.prepareAgentsMemory(contextMessages);
+        description = this.subAgentManager.generateSupervisorSystemMessage(description, agentsMemory);
+        return {
+          role: "system",
+          content: description
+        };
       }
       return {
         role: "system",
@@ -4070,6 +4150,26 @@ ${context}`;
       };
     });
   }
+  /**
+   * Prepare agents memory for the supervisor system message
+   * This fetches and formats recent interactions with sub-agents
+   */
+  prepareAgentsMemory(contextMessages) {
+    return __async(this, null, function* () {
+      try {
+        const subAgents = this.subAgentManager.getSubAgents();
+        if (subAgents.length === 0)
+          return "";
+        const formattedMemory = contextMessages.filter((p) => p.role !== "system").filter((p) => p.role === "assistant" && !p.content.toString().includes("toolCallId")).map((message) => {
+          return `${message.role}: ${message.content}`;
+        }).join("\n\n");
+        return formattedMemory || "No previous agent interactions found.";
+      } catch (error) {
+        console.warn("Error preparing agents memory:", error);
+        return "Error retrieving agent history.";
+      }
+    });
+  }
   /**
    * Add input to messages array based on type
    */
@@ -4242,7 +4342,8 @@ ${context}`;
         );
         const systemMessage = yield this.getSystemMessage({
           input,
-          historyEntryId: context.historyEntry.id
+          historyEntryId: context.historyEntry.id,
+          contextMessages
         });
         let messages = [systemMessage, ...contextMessages];
         messages = yield this.formatInputMessages(messages, input);
@@ -4365,7 +4466,8 @@ ${context}`;
         );
         const systemMessage = yield this.getSystemMessage({
           input,
-          historyEntryId: context.historyEntry.id
+          historyEntryId: context.historyEntry.id,
+          contextMessages
         });
         let messages = [systemMessage, ...contextMessages];
         messages = yield this.formatInputMessages(messages, input);
@@ -4505,7 +4607,8 @@ ${context}`;
         );
         const systemMessage = yield this.getSystemMessage({
           input,
-          historyEntryId: context.historyEntry.id
+          historyEntryId: context.historyEntry.id,
+          contextMessages
         });
         let messages = [systemMessage, ...contextMessages];
         messages = yield this.formatInputMessages(messages, input);
@@ -4583,7 +4686,8 @@ ${context}`;
         );
         const systemMessage = yield this.getSystemMessage({
           input,
-          historyEntryId: context.historyEntry.id
+          historyEntryId: context.historyEntry.id,
+          contextMessages
         });
         let messages = [systemMessage, ...contextMessages];
         messages = yield this.formatInputMessages(messages, input);