@voltagent/core 2.4.2 → 2.4.4

package/dist/index.d.mts

@@ -10056,6 +10056,10 @@ interface WorkflowRunOptions {
      * The user ID, this can be used to track the current user in a workflow
      */
     userId?: string;
+    /**
+     * Additional execution metadata persisted with workflow state
+     */
+    metadata?: Record<string, unknown>;
     /**
      * The user context, this can be used to track the current user context in a workflow
      */

package/dist/index.d.ts

@@ -10056,6 +10056,10 @@ interface WorkflowRunOptions {
      * The user ID, this can be used to track the current user in a workflow
      */
     userId?: string;
+    /**
+     * Additional execution metadata persisted with workflow state
+     */
+    metadata?: Record<string, unknown>;
     /**
      * The user context, this can be used to track the current user context in a workflow
      */

package/dist/index.js

@@ -505,7 +505,7 @@ function convertWorkflowStateToParam(state, executionContext, signal) {
     executionId: state.executionId,
     conversationId: state.conversationId,
     userId: state.userId,
-    context: state.context,
+    context: executionContext?.context ?? state.context,
     workflowState: state.workflowState,
     active: state.active,
     startAt: state.startAt,
@@ -9701,6 +9701,13 @@ function createWorkflow({
     } else {
       executionId = options?.executionId || randomUUID();
     }
+    const mergeExecutionMetadata = /* @__PURE__ */ __name(async (patch) => {
+      const existingState = await executionMemory.getWorkflowState(executionId);
+      return {
+        ...existingState?.metadata ?? {},
+        ...patch
+      };
+    }, "mergeExecutionMetadata");
     const streamController = externalStreamController || null;
     const collectedEvents = [];
     const emitAndCollectEvent = /* @__PURE__ */ __name((event) => {
@@ -9725,6 +9732,7 @@ function createWorkflow({
     }, "emitAndCollectEvent");
     const observability = getObservability();
     const contextMap = options?.context instanceof Map ? options.context : options?.context ? new Map(Object.entries(options.context)) : /* @__PURE__ */ new Map();
+    const optionMetadata = options?.metadata && typeof options.metadata === "object" && !Array.isArray(options.metadata) ? options.metadata : void 0;
     const workflowStateStore = options?.workflowState ?? {};
     let resumedFrom;
     if (options?.resumeFrom?.executionId) {
@@ -9813,11 +9821,12 @@ function createWorkflow({
           workflowName: name,
           status: "running",
           input: input2,
-          context: options?.context ? Array.from(options.context.entries()) : void 0,
+          context: options?.context ? Array.from(contextMap.entries()) : void 0,
           workflowState: workflowStateStore,
           userId: options?.userId,
           conversationId: options?.conversationId,
           metadata: {
+            ...optionMetadata ?? {},
             traceId: rootSpan.spanContext().traceId,
             spanId: rootSpan.spanContext().spanId
           },
@@ -9834,7 +9843,7 @@ function createWorkflow({
           );
         }
       }
-      const streamWriter = streamController ? new WorkflowStreamWriterImpl(streamController, executionId, id, name, 0, options?.context) : new NoOpWorkflowStreamWriter();
+      const streamWriter = streamController ? new WorkflowStreamWriterImpl(streamController, executionId, id, name, 0, contextMap) : new NoOpWorkflowStreamWriter();
       const executionContext = {
         workflowId: id,
         executionId,
@@ -9888,7 +9897,7 @@ function createWorkflow({
         from: name,
         input: input2,
         status: "running",
-        context: options?.context,
+        context: contextMap,
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       });
       runLogger.debug(
@@ -9901,6 +9910,7 @@ function createWorkflow({
       if (options?.resumeFrom?.executionId) {
         stateManager.start(input2, {
           ...options,
+          context: contextMap,
           executionId,
           // Use the resumed execution ID
           active: options.resumeFrom.resumeStepIndex,
@@ -9909,6 +9919,7 @@ function createWorkflow({
       } else {
         stateManager.start(input2, {
           ...options,
+          context: contextMap,
           executionId,
           // Use the created execution ID
           workflowState: workflowStateStore
@@ -10022,7 +10033,7 @@ function createWorkflow({
               input: stateManager.state.data,
               output: void 0,
               status: "cancelled",
-              context: options?.context,
+              context: contextMap,
               timestamp: (/* @__PURE__ */ new Date()).toISOString(),
               stepIndex: index,
               stepType: step.type,
@@ -10042,10 +10053,10 @@ function createWorkflow({
                   cancelledAt: /* @__PURE__ */ new Date(),
                   reason
                 },
-                metadata: {
+                metadata: await mergeExecutionMetadata({
                   ...stateManager.state?.usage ? { usage: stateManager.state.usage } : {},
                   cancellationReason: reason
-                },
+                }),
                 updatedAt: /* @__PURE__ */ new Date()
               });
             } catch (memoryError) {
@@ -10058,7 +10069,7 @@ function createWorkflow({
               executionId,
               from: name,
               status: "cancelled",
-              context: options?.context,
+              context: contextMap,
               timestamp: (/* @__PURE__ */ new Date()).toISOString(),
               metadata: { reason }
             });
@@ -10190,7 +10201,7 @@ function createWorkflow({
             step.id,
             step.name || step.id,
             index,
-            options?.context
+            contextMap
           ) : new NoOpWorkflowStreamWriter();
           executionContext.streamWriter = stepWriter;
           emitAndCollectEvent({
@@ -10199,7 +10210,7 @@ function createWorkflow({
             from: step.name || step.id,
             input: stateManager.state.data,
             status: "running",
-            context: options?.context,
+            context: contextMap,
             timestamp: (/* @__PURE__ */ new Date()).toISOString(),
             stepIndex: index,
             stepType: step.type,
@@ -10269,7 +10280,7 @@ function createWorkflow({
               input: stateManager.state.data,
               output: void 0,
               status: "suspended",
-              context: options?.context,
+              context: contextMap,
               timestamp: (/* @__PURE__ */ new Date()).toISOString(),
               stepIndex: index,
               metadata: {
@@ -10337,7 +10348,7 @@ function createWorkflow({
                 step.id,
                 step.name || step.id,
                 index,
-                options?.context
+                contextMap
               ) : new NoOpWorkflowStreamWriter();
               const stepExecutionContext = {
                 ...executionContext,
@@ -10414,7 +10425,7 @@ function createWorkflow({
                 input: stateManager.state.data,
                 output: result2,
                 status: isSkipped ? "skipped" : "success",
-                context: options?.context,
+                context: contextMap,
                 timestamp: (/* @__PURE__ */ new Date()).toISOString(),
                 stepIndex: index,
                 stepType: step.type,
@@ -10539,7 +10550,7 @@ function createWorkflow({
           from: name,
           output: finalState.result,
           status: "success",
-          context: options?.context,
+          context: contextMap,
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
         });
         streamController?.close();
@@ -10569,7 +10580,7 @@ function createWorkflow({
             executionId,
             from: name,
             status: "cancelled",
-            context: options?.context,
+            context: contextMap,
             timestamp: (/* @__PURE__ */ new Date()).toISOString(),
             metadata: cancellationReason ? { reason: cancellationReason } : void 0
           });
@@ -10578,10 +10589,10 @@ function createWorkflow({
             await executionMemory.updateWorkflowState(executionId, {
               status: "cancelled",
               workflowState: stateManager.state.workflowState,
-              metadata: {
+              metadata: await mergeExecutionMetadata({
                 ...stateManager.state?.usage ? { usage: stateManager.state.usage } : {},
                 cancellationReason
-              },
+              }),
               updatedAt: /* @__PURE__ */ new Date()
             });
           } catch (memoryError) {
@@ -10645,7 +10656,7 @@ function createWorkflow({
           from: name,
           status: "error",
           error,
-          context: options?.context,
+          context: contextMap,
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
         });
         if (stateManager.state.status !== "completed" && stateManager.state.status !== "failed") {
@@ -10657,10 +10668,10 @@ function createWorkflow({
             workflowState: stateManager.state.workflowState,
             events: collectedEvents,
             // Store a lightweight error summary in metadata for debugging
-            metadata: {
+            metadata: await mergeExecutionMetadata({
               ...stateManager.state?.usage ? { usage: stateManager.state.usage } : {},
               errorMessage: error instanceof Error ? error.message : String(error)
-            },
+            }),
             updatedAt: /* @__PURE__ */ new Date()
           });
         } catch (memoryError) {
@@ -10784,6 +10795,7 @@ function createWorkflow({
               resumedReject = reject;
             }
           );
+          const resumedSuspendController = createSuspendController();
           const executeResume = /* @__PURE__ */ __name(async () => {
             if (!execResult.suspension) {
               throw new Error("No suspension metadata found");
@@ -10806,7 +10818,7 @@ function createWorkflow({
                 resumeStepIndex,
                 resumeData: input3
               },
-              suspendController
+              suspendController: resumedSuspendController
             };
             const resumed = await executeInternal(
               originalInput,
@@ -10849,10 +10861,10 @@ function createWorkflow({
               return streamResult.resume(input22, opts2);
             }, "resume"),
             suspend: /* @__PURE__ */ __name((reason) => {
-              suspendController.suspend(reason);
+              resumedSuspendController.suspend(reason);
             }, "suspend"),
             cancel: /* @__PURE__ */ __name((reason) => {
-              suspendController.cancel(reason);
+              resumedSuspendController.cancel(reason);
             }, "cancel"),
             abort: /* @__PURE__ */ __name(() => streamController.abort(), "abort"),
             toUIMessageStreamResponse: eventToUIMessageStreamResponse(streamController),