@voltagent/core 1.2.19 → 1.2.20

package/dist/index.d.mts

@@ -457,6 +457,11 @@ type ProviderTextResponse<TOriginalResponse> = {
 type StreamPart = TextStreamPart<any> & {
     subAgentId?: string;
     subAgentName?: string;
+    executingAgentId?: string;
+    executingAgentName?: string;
+    parentAgentId?: string;
+    parentAgentName?: string;
+    agentPath?: string[];
 };
 /**
  * Response type for text streaming operations
@@ -3084,10 +3089,29 @@ type VoltAgentTextStreamPart<TOOLS extends Record<string, any> = Record<string,
      * Optional identifier for the subagent that generated this event
      */
     subAgentId?: string;
+    /**
+     * Optional identifier for the agent that actually executed the step
+     * (same as subAgentId for first-level handoffs)
+     */
+    executingAgentId?: string;
     /**
      * Optional name of the subagent that generated this event
      */
     subAgentName?: string;
+    /**
+     * Optional name of the agent that actually executed the step
+     * (same as subAgentName for first-level handoffs)
+     */
+    executingAgentName?: string;
+    /**
+     * Parent agent reference when forwarded through supervisors
+     */
+    parentAgentId?: string;
+    parentAgentName?: string;
+    /**
+     * Ordered list of agent names from supervisor -> executing agent
+     */
+    agentPath?: string[];
 };
 /**
  * Extended StreamTextResult that uses VoltAgentTextStreamPart for fullStream.

package/dist/index.d.ts

@@ -457,6 +457,11 @@ type ProviderTextResponse<TOriginalResponse> = {
 type StreamPart = TextStreamPart<any> & {
     subAgentId?: string;
     subAgentName?: string;
+    executingAgentId?: string;
+    executingAgentName?: string;
+    parentAgentId?: string;
+    parentAgentName?: string;
+    agentPath?: string[];
 };
 /**
  * Response type for text streaming operations
@@ -3084,10 +3089,29 @@ type VoltAgentTextStreamPart<TOOLS extends Record<string, any> = Record<string,
      * Optional identifier for the subagent that generated this event
      */
     subAgentId?: string;
+    /**
+     * Optional identifier for the agent that actually executed the step
+     * (same as subAgentId for first-level handoffs)
+     */
+    executingAgentId?: string;
     /**
      * Optional name of the subagent that generated this event
      */
     subAgentName?: string;
+    /**
+     * Optional name of the agent that actually executed the step
+     * (same as subAgentName for first-level handoffs)
+     */
+    executingAgentName?: string;
+    /**
+     * Parent agent reference when forwarded through supervisors
+     */
+    parentAgentId?: string;
+    parentAgentName?: string;
+    /**
+     * Ordered list of agent names from supervisor -> executing agent
+     */
+    agentPath?: string[];
 };
 /**
  * Extended StreamTextResult that uses VoltAgentTextStreamPart for fullStream.

package/dist/index.js

@@ -5850,6 +5850,21 @@ var WorkflowStreamWriterImpl = class {
       if (part.subAgentName) {
         metadata.subAgentName = part.subAgentName;
       }
+      if (part.executingAgentId) {
+        metadata.executingAgentId = part.executingAgentId;
+      }
+      if (part.executingAgentName) {
+        metadata.executingAgentName = part.executingAgentName;
+      }
+      if (part.parentAgentId) {
+        metadata.parentAgentId = part.parentAgentId;
+      }
+      if (part.parentAgentName) {
+        metadata.parentAgentName = part.parentAgentName;
+      }
+      if (part.agentPath) {
+        metadata.agentPath = part.agentPath;
+      }
       let input;
       let output;
       let status;
@@ -16098,11 +16113,11 @@ function createMetadataEnrichedStream(originalStream, metadata, allowedTypes) {
               type: SUBAGENT_DATA_EVENT_TYPE,
               // Don't include id to prevent overwriting in AI SDK - each delta should be a new part
               data: {
-                subAgentName: metadata.subAgentName,
-                subAgentId: metadata.subAgentId,
-                originalType: chunkObj.type,
-                // Include all original chunk data
-                ...chunkObj
+                // Include original chunk first so metadata can override it
+                ...chunkObj,
+                ...metadata,
+                // Preserve the original event type for consumers
+                originalType: chunkObj.type
               }
             };
             controller.enqueue(dataEvent);
@@ -16404,6 +16419,10 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
       };
       if (this.isDirectAgent(targetAgentConfig)) {
         const response = await targetAgent.streamText(messages, baseOptions);
+        const forwardingMetadata = this.buildForwardingMetadata(
+          targetAgent,
+          parentOperationContext
+        );
         const uiStreamWriter = parentOperationContext?.systemContext?.get(
           "uiStreamWriter"
         );
@@ -16414,10 +16433,7 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
           const subagentUIStream = response.toUIMessageStream();
           const enrichedStream = createMetadataEnrichedStream(
             subagentUIStream,
-            {
-              subAgentId: targetAgent.id,
-              subAgentName: targetAgent.name
-            },
+            forwardingMetadata,
             this.supervisorConfig?.fullStreamEventForwarding?.types || ["tool-call", "tool-result"]
           );
           uiStreamWriter.merge(enrichedStream);
@@ -16435,8 +16451,7 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
                 }
                 const enrichedPart = {
                   ...part,
-                  subAgentId: targetAgent.id,
-                  subAgentName: targetAgent.name
+                  ...forwardingMetadata
                 };
                 this.registerToolCallMetadata(parentOperationContext, enrichedPart, targetAgent);
                 await fullStreamWriter.write(enrichedPart);
@@ -16462,6 +16477,10 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
       } else if (this.isStreamTextConfig(targetAgentConfig)) {
         const options2 = { ...baseOptions, ...targetAgentConfig.options };
         const response = await targetAgent.streamText(messages, options2);
+        const forwardingMetadata = this.buildForwardingMetadata(
+          targetAgent,
+          parentOperationContext
+        );
         const uiStreamWriter = parentOperationContext?.systemContext?.get(
           "uiStreamWriter"
         );
@@ -16472,10 +16491,7 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
           const subagentUIStream = response.toUIMessageStream();
           const enrichedStream = createMetadataEnrichedStream(
             subagentUIStream,
-            {
-              subAgentId: targetAgent.id,
-              subAgentName: targetAgent.name
-            },
+            forwardingMetadata,
             this.supervisorConfig?.fullStreamEventForwarding?.types || ["tool-call", "tool-result"]
           );
           uiStreamWriter.merge(enrichedStream);
@@ -16493,8 +16509,7 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
                 }
                 const enrichedPart = {
                   ...part,
-                  subAgentId: targetAgent.id,
-                  subAgentName: targetAgent.name
+                  ...forwardingMetadata
                 };
                 this.registerToolCallMetadata(parentOperationContext, enrichedPart, targetAgent);
                 await fullStreamWriter.write(enrichedPart);
@@ -16790,6 +16805,18 @@ Context: ${(0, import_utils17.safeStringify)(contextObj, { indentation: 2 })}`;
       return subAgentData;
     });
   }
+  buildForwardingMetadata(agent, oc) {
+    const parentMetadata = oc?.systemContext?.get(AGENT_METADATA_CONTEXT_KEY);
+    return {
+      subAgentId: agent.id,
+      subAgentName: agent.name,
+      executingAgentId: agent.id,
+      executingAgentName: agent.name,
+      parentAgentId: parentMetadata?.agentId,
+      parentAgentName: parentMetadata?.agentName,
+      agentPath: parentMetadata ? [parentMetadata.agentName, agent.name] : [agent.name]
+    };
+  }
   registerToolCallMetadata(oc, part, agent) {
     if (!oc || !part?.type || !part.type.startsWith("tool-") || !part.toolCallId) {
       return;