@voltagent/core 0.1.79 → 0.1.81

package/dist/index.d.mts

@@ -269,6 +269,11 @@ interface WorkflowExecuteContext<INPUT, DATA, SUSPEND_DATA, RESUME_DATA> {
      * Provides execution-scoped logging with full context (userId, conversationId, executionId).
      */
     logger: Logger;
+    /**
+     * Stream writer for emitting events during streaming execution.
+     * Always available - uses NoOpWorkflowStreamWriter when not streaming
+     */
+    writer: WorkflowStreamWriter;
 }
 /**
  * A function that can be executed by the workflow
@@ -371,6 +376,8 @@ type WorkflowState<INPUT, RESULT> = {
     error: Error | null;
     /** suspension metadata when workflow is suspended */
     suspension?: WorkflowSuspensionMetadata;
+    /** accumulated usage from andAgent calls */
+    usage: UsageInfo;
 };
 
 interface WorkflowSuspensionMetadata<SUSPEND_DATA = DangerouslyAllowAny> {
@@ -414,9 +421,9 @@ interface WorkflowSuspendController {
     getReason: () => string | undefined;
 }
 /**
- * Result returned from workflow execution with suspend/resume capabilities
+ * Base result interface shared by all workflow execution results
  */
-interface WorkflowExecutionResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA extends z.ZodTypeAny = z.ZodAny> {
+interface WorkflowExecutionResultBase<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA extends z.ZodTypeAny = z.ZodAny> {
     /**
      * Unique execution ID for this workflow run
      */
@@ -432,23 +439,38 @@ interface WorkflowExecutionResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCH
     /**
      * When the workflow execution ended (completed, suspended, or errored)
      */
-    endAt: Date;
+    endAt: Date | Promise<Date>;
     /**
      * Current status of the workflow execution
      */
-    status: "completed" | "suspended" | "error";
+    status: "completed" | "suspended" | "error" | Promise<"completed" | "suspended" | "error">;
     /**
      * The result data if workflow completed successfully
      */
-    result: z.infer<RESULT_SCHEMA> | null;
+    result: z.infer<RESULT_SCHEMA> | null | Promise<z.infer<RESULT_SCHEMA> | null>;
     /**
      * Suspension metadata if workflow was suspended
      */
-    suspension?: WorkflowSuspensionMetadata;
+    suspension?: WorkflowSuspensionMetadata | Promise<WorkflowSuspensionMetadata | undefined>;
     /**
      * Error information if workflow failed
      */
+    error?: unknown | Promise<unknown | undefined>;
+    /**
+     * Total token usage from all andAgent steps in the workflow
+     */
+    usage: UsageInfo | Promise<UsageInfo>;
+}
+/**
+ * Result returned from workflow execution with suspend/resume capabilities
+ */
+interface WorkflowExecutionResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA extends z.ZodTypeAny = z.ZodAny> extends WorkflowExecutionResultBase<RESULT_SCHEMA, RESUME_SCHEMA> {
+    endAt: Date;
+    status: "completed" | "suspended" | "error";
+    result: z.infer<RESULT_SCHEMA> | null;
+    suspension?: WorkflowSuspensionMetadata;
     error?: unknown;
+    usage: UsageInfo;
     /**
      * Resume a suspended workflow execution
      * @param input - Optional new input data for resuming (validated against resumeSchema if provided)
@@ -459,6 +481,31 @@ interface WorkflowExecutionResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCH
         stepId?: string;
     }) => Promise<WorkflowExecutionResult<RESULT_SCHEMA, RESUME_SCHEMA>>;
 }
+/**
+ * Result returned from workflow stream execution
+ * Extends base with streaming capabilities and promise-based fields
+ */
+interface WorkflowStreamResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA extends z.ZodTypeAny = z.ZodAny> extends WorkflowExecutionResultBase<RESULT_SCHEMA, RESUME_SCHEMA>, AsyncIterable<WorkflowStreamEvent> {
+    endAt: Promise<Date>;
+    status: Promise<"completed" | "suspended" | "error">;
+    result: Promise<z.infer<RESULT_SCHEMA> | null>;
+    suspension: Promise<WorkflowSuspensionMetadata | undefined>;
+    error: Promise<unknown | undefined>;
+    usage: Promise<UsageInfo>;
+    /**
+     * Resume a suspended workflow execution
+     * @param input - Optional new input data for resuming (validated against resumeSchema if provided)
+     * @param options - Optional options for resuming, including stepId to resume from a specific step
+     * @returns A new stream result that can also be resumed if suspended again
+     */
+    resume: (input: z.infer<RESUME_SCHEMA>, options?: {
+        stepId?: string;
+    }) => Promise<WorkflowStreamResult<RESULT_SCHEMA, RESUME_SCHEMA>>;
+    /**
+     * Abort the workflow execution
+     */
+    abort: () => void;
+}
 interface WorkflowRunOptions {
     /**
      * The active step, this can be used to track the current step in a workflow
@@ -650,9 +697,17 @@ type Workflow<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema, RESULT_SCHEM
     /**
      * Execute the workflow with the given input
      * @param input - The input to the workflow
-     * @returns The result of the workflow
+     * @param options - Options for the workflow execution
+     * @returns Execution result with final result
      */
     run: (input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions) => Promise<WorkflowExecutionResult<RESULT_SCHEMA, RESUME_SCHEMA>>;
+    /**
+     * Execute the workflow with streaming support
+     * @param input - The input to the workflow
+     * @param options - Options for the workflow execution
+     * @returns Stream result with real-time events and promise-based fields
+     */
+    stream: (input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions) => WorkflowStreamResult<RESULT_SCHEMA, RESUME_SCHEMA>;
     /**
      * Create a WorkflowSuspendController that can be used to suspend the workflow
      * @returns A WorkflowSuspendController instance
@@ -744,6 +799,80 @@ interface WorkflowStats {
     averageExecutionTime: number;
     lastExecutionTime?: Date;
 }
+/**
+ * Event emitted during workflow streaming
+ */
+interface WorkflowStreamEvent {
+    /**
+     * Type of the event (e.g., "step-start", "step-complete", "custom", "agent-stream")
+     */
+    type: string;
+    /**
+     * Unique execution ID for this workflow run
+     */
+    executionId: string;
+    /**
+     * Source of the event (step ID or name)
+     */
+    from: string;
+    /**
+     * Input data for the step/event
+     */
+    input?: Record<string, DangerouslyAllowAny>;
+    /**
+     * Output data from the step/event
+     */
+    output?: Record<string, DangerouslyAllowAny>;
+    /**
+     * Current status of the step/event
+     */
+    status: "pending" | "running" | "success" | "error" | "suspended";
+    /**
+     * User context passed through the workflow
+     */
+    userContext?: UserContext;
+    /**
+     * Timestamp of the event
+     */
+    timestamp: string;
+    /**
+     * Current step index in the workflow
+     */
+    stepIndex?: number;
+    /**
+     * Step type for step events
+     */
+    stepType?: "agent" | "func" | "conditional-when" | "parallel-all" | "parallel-race" | "tap" | "workflow";
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, DangerouslyAllowAny>;
+    /**
+     * Error information if status is "error"
+     */
+    error?: DangerouslyAllowAny;
+}
+/**
+ * Writer interface for emitting stream events from workflow steps
+ */
+interface WorkflowStreamWriter {
+    /**
+     * Write a custom event to the stream
+     */
+    write(event: Partial<WorkflowStreamEvent> & {
+        type: string;
+    }): void;
+    /**
+     * Pipe events from an agent's fullStream to the workflow stream
+     * @param fullStream - The agent's fullStream async iterable
+     * @param options - Optional configuration for piping
+     */
+    pipeFrom(fullStream: AsyncIterable<DangerouslyAllowAny>, options?: {
+        prefix?: string;
+        agentId?: string;
+        filter?: (part: DangerouslyAllowAny) => boolean;
+    }): Promise<void>;
+}
 /**
  * Options for creating workflow execution
  */
@@ -842,6 +971,11 @@ interface WorkflowExecutionContext {
      * Provides execution-scoped logging with full context (userId, conversationId, executionId)
      */
     logger: Logger;
+    /**
+     * Stream writer for emitting events during streaming execution
+     * Always available - uses NoOpWorkflowStreamWriter when not streaming
+     */
+    streamWriter: WorkflowStreamWriter;
 }
 /**
  * Workflow step context for individual step tracking
@@ -5464,6 +5598,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<z.infer<OS>>;
         id: string;
         name?: string;
@@ -5488,6 +5624,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<NEW_DATA>;
         id: string;
         name?: string;
@@ -5512,6 +5650,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<z.infer<OS>>;
         id: string;
         name?: string;
@@ -5536,6 +5676,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RS>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<NEW_DATA>;
         id: string;
         name?: string;
@@ -5576,6 +5718,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<NEW_DATA>;
         id: string;
         name?: string;
@@ -5604,6 +5748,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<boolean>;
     }): WorkflowChain<INPUT_SCHEMA, RESULT_SCHEMA, z.infer<OS> | z.infer<IS>, SUSPEND_SCHEMA, RESUME_SCHEMA>;
     /**
@@ -5663,6 +5809,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<void>;
         id: string;
         name?: string;
@@ -5702,6 +5850,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<void>;
         id: string;
         name?: string;
@@ -5835,6 +5985,10 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
      * Execute the workflow with the given input
      */
     run(input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions): Promise<WorkflowExecutionResult<RESULT_SCHEMA, RESUME_SCHEMA>>;
+    /**
+     * Execute the workflow with streaming support
+     */
+    stream(input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions): WorkflowStreamResult<RESULT_SCHEMA, RESUME_SCHEMA>;
 }
 /**
  * Creates a new workflow chain with the given configuration
@@ -6130,6 +6284,7 @@ declare class WorkflowRegistry extends EventEmitter {
         endAt: Date;
         status: "completed" | "suspended" | "error";
         result: any;
+        usage: UsageInfo;
         suspension?: any;
         error?: unknown;
     } | null>;

package/dist/index.d.ts

@@ -269,6 +269,11 @@ interface WorkflowExecuteContext<INPUT, DATA, SUSPEND_DATA, RESUME_DATA> {
      * Provides execution-scoped logging with full context (userId, conversationId, executionId).
      */
     logger: Logger;
+    /**
+     * Stream writer for emitting events during streaming execution.
+     * Always available - uses NoOpWorkflowStreamWriter when not streaming
+     */
+    writer: WorkflowStreamWriter;
 }
 /**
  * A function that can be executed by the workflow
@@ -371,6 +376,8 @@ type WorkflowState<INPUT, RESULT> = {
     error: Error | null;
     /** suspension metadata when workflow is suspended */
     suspension?: WorkflowSuspensionMetadata;
+    /** accumulated usage from andAgent calls */
+    usage: UsageInfo;
 };
 
 interface WorkflowSuspensionMetadata<SUSPEND_DATA = DangerouslyAllowAny> {
@@ -414,9 +421,9 @@ interface WorkflowSuspendController {
     getReason: () => string | undefined;
 }
 /**
- * Result returned from workflow execution with suspend/resume capabilities
+ * Base result interface shared by all workflow execution results
  */
-interface WorkflowExecutionResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA extends z.ZodTypeAny = z.ZodAny> {
+interface WorkflowExecutionResultBase<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA extends z.ZodTypeAny = z.ZodAny> {
     /**
      * Unique execution ID for this workflow run
      */
@@ -432,23 +439,38 @@ interface WorkflowExecutionResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCH
     /**
      * When the workflow execution ended (completed, suspended, or errored)
      */
-    endAt: Date;
+    endAt: Date | Promise<Date>;
     /**
      * Current status of the workflow execution
      */
-    status: "completed" | "suspended" | "error";
+    status: "completed" | "suspended" | "error" | Promise<"completed" | "suspended" | "error">;
     /**
      * The result data if workflow completed successfully
      */
-    result: z.infer<RESULT_SCHEMA> | null;
+    result: z.infer<RESULT_SCHEMA> | null | Promise<z.infer<RESULT_SCHEMA> | null>;
     /**
      * Suspension metadata if workflow was suspended
      */
-    suspension?: WorkflowSuspensionMetadata;
+    suspension?: WorkflowSuspensionMetadata | Promise<WorkflowSuspensionMetadata | undefined>;
     /**
      * Error information if workflow failed
      */
+    error?: unknown | Promise<unknown | undefined>;
+    /**
+     * Total token usage from all andAgent steps in the workflow
+     */
+    usage: UsageInfo | Promise<UsageInfo>;
+}
+/**
+ * Result returned from workflow execution with suspend/resume capabilities
+ */
+interface WorkflowExecutionResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA extends z.ZodTypeAny = z.ZodAny> extends WorkflowExecutionResultBase<RESULT_SCHEMA, RESUME_SCHEMA> {
+    endAt: Date;
+    status: "completed" | "suspended" | "error";
+    result: z.infer<RESULT_SCHEMA> | null;
+    suspension?: WorkflowSuspensionMetadata;
     error?: unknown;
+    usage: UsageInfo;
     /**
      * Resume a suspended workflow execution
      * @param input - Optional new input data for resuming (validated against resumeSchema if provided)
@@ -459,6 +481,31 @@ interface WorkflowExecutionResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCH
         stepId?: string;
     }) => Promise<WorkflowExecutionResult<RESULT_SCHEMA, RESUME_SCHEMA>>;
 }
+/**
+ * Result returned from workflow stream execution
+ * Extends base with streaming capabilities and promise-based fields
+ */
+interface WorkflowStreamResult<RESULT_SCHEMA extends z.ZodTypeAny, RESUME_SCHEMA extends z.ZodTypeAny = z.ZodAny> extends WorkflowExecutionResultBase<RESULT_SCHEMA, RESUME_SCHEMA>, AsyncIterable<WorkflowStreamEvent> {
+    endAt: Promise<Date>;
+    status: Promise<"completed" | "suspended" | "error">;
+    result: Promise<z.infer<RESULT_SCHEMA> | null>;
+    suspension: Promise<WorkflowSuspensionMetadata | undefined>;
+    error: Promise<unknown | undefined>;
+    usage: Promise<UsageInfo>;
+    /**
+     * Resume a suspended workflow execution
+     * @param input - Optional new input data for resuming (validated against resumeSchema if provided)
+     * @param options - Optional options for resuming, including stepId to resume from a specific step
+     * @returns A new stream result that can also be resumed if suspended again
+     */
+    resume: (input: z.infer<RESUME_SCHEMA>, options?: {
+        stepId?: string;
+    }) => Promise<WorkflowStreamResult<RESULT_SCHEMA, RESUME_SCHEMA>>;
+    /**
+     * Abort the workflow execution
+     */
+    abort: () => void;
+}
 interface WorkflowRunOptions {
     /**
      * The active step, this can be used to track the current step in a workflow
@@ -650,9 +697,17 @@ type Workflow<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema, RESULT_SCHEM
     /**
      * Execute the workflow with the given input
      * @param input - The input to the workflow
-     * @returns The result of the workflow
+     * @param options - Options for the workflow execution
+     * @returns Execution result with final result
      */
     run: (input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions) => Promise<WorkflowExecutionResult<RESULT_SCHEMA, RESUME_SCHEMA>>;
+    /**
+     * Execute the workflow with streaming support
+     * @param input - The input to the workflow
+     * @param options - Options for the workflow execution
+     * @returns Stream result with real-time events and promise-based fields
+     */
+    stream: (input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions) => WorkflowStreamResult<RESULT_SCHEMA, RESUME_SCHEMA>;
     /**
      * Create a WorkflowSuspendController that can be used to suspend the workflow
      * @returns A WorkflowSuspendController instance
@@ -744,6 +799,80 @@ interface WorkflowStats {
     averageExecutionTime: number;
     lastExecutionTime?: Date;
 }
+/**
+ * Event emitted during workflow streaming
+ */
+interface WorkflowStreamEvent {
+    /**
+     * Type of the event (e.g., "step-start", "step-complete", "custom", "agent-stream")
+     */
+    type: string;
+    /**
+     * Unique execution ID for this workflow run
+     */
+    executionId: string;
+    /**
+     * Source of the event (step ID or name)
+     */
+    from: string;
+    /**
+     * Input data for the step/event
+     */
+    input?: Record<string, DangerouslyAllowAny>;
+    /**
+     * Output data from the step/event
+     */
+    output?: Record<string, DangerouslyAllowAny>;
+    /**
+     * Current status of the step/event
+     */
+    status: "pending" | "running" | "success" | "error" | "suspended";
+    /**
+     * User context passed through the workflow
+     */
+    userContext?: UserContext;
+    /**
+     * Timestamp of the event
+     */
+    timestamp: string;
+    /**
+     * Current step index in the workflow
+     */
+    stepIndex?: number;
+    /**
+     * Step type for step events
+     */
+    stepType?: "agent" | "func" | "conditional-when" | "parallel-all" | "parallel-race" | "tap" | "workflow";
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, DangerouslyAllowAny>;
+    /**
+     * Error information if status is "error"
+     */
+    error?: DangerouslyAllowAny;
+}
+/**
+ * Writer interface for emitting stream events from workflow steps
+ */
+interface WorkflowStreamWriter {
+    /**
+     * Write a custom event to the stream
+     */
+    write(event: Partial<WorkflowStreamEvent> & {
+        type: string;
+    }): void;
+    /**
+     * Pipe events from an agent's fullStream to the workflow stream
+     * @param fullStream - The agent's fullStream async iterable
+     * @param options - Optional configuration for piping
+     */
+    pipeFrom(fullStream: AsyncIterable<DangerouslyAllowAny>, options?: {
+        prefix?: string;
+        agentId?: string;
+        filter?: (part: DangerouslyAllowAny) => boolean;
+    }): Promise<void>;
+}
 /**
  * Options for creating workflow execution
  */
@@ -842,6 +971,11 @@ interface WorkflowExecutionContext {
      * Provides execution-scoped logging with full context (userId, conversationId, executionId)
      */
     logger: Logger;
+    /**
+     * Stream writer for emitting events during streaming execution
+     * Always available - uses NoOpWorkflowStreamWriter when not streaming
+     */
+    streamWriter: WorkflowStreamWriter;
 }
 /**
  * Workflow step context for individual step tracking
@@ -5464,6 +5598,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<z.infer<OS>>;
         id: string;
         name?: string;
@@ -5488,6 +5624,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<NEW_DATA>;
         id: string;
         name?: string;
@@ -5512,6 +5650,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<z.infer<OS>>;
         id: string;
         name?: string;
@@ -5536,6 +5676,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RS>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<NEW_DATA>;
         id: string;
         name?: string;
@@ -5576,6 +5718,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<NEW_DATA>;
         id: string;
         name?: string;
@@ -5604,6 +5748,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<boolean>;
     }): WorkflowChain<INPUT_SCHEMA, RESULT_SCHEMA, z.infer<OS> | z.infer<IS>, SUSPEND_SCHEMA, RESUME_SCHEMA>;
     /**
@@ -5663,6 +5809,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: SS extends z.ZodTypeAny ? z.infer<SS> : z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: RS extends z.ZodTypeAny ? z.infer<RS> : z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<void>;
         id: string;
         name?: string;
@@ -5702,6 +5850,8 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
             } | undefined;
             suspend: (reason?: string, suspendData?: z.infer<SUSPEND_SCHEMA>) => Promise<never>;
             resumeData?: z.infer<RESUME_SCHEMA>;
+            logger: Logger;
+            writer: WorkflowStreamWriter;
         }) => Promise<void>;
         id: string;
         name?: string;
@@ -5835,6 +5985,10 @@ declare class WorkflowChain<INPUT_SCHEMA extends InternalBaseWorkflowInputSchema
      * Execute the workflow with the given input
      */
     run(input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions): Promise<WorkflowExecutionResult<RESULT_SCHEMA, RESUME_SCHEMA>>;
+    /**
+     * Execute the workflow with streaming support
+     */
+    stream(input: WorkflowInput<INPUT_SCHEMA>, options?: WorkflowRunOptions): WorkflowStreamResult<RESULT_SCHEMA, RESUME_SCHEMA>;
 }
 /**
  * Creates a new workflow chain with the given configuration
@@ -6130,6 +6284,7 @@ declare class WorkflowRegistry extends EventEmitter {
         endAt: Date;
         status: "completed" | "suspended" | "error";
         result: any;
+        usage: UsageInfo;
         suspension?: any;
         error?: unknown;
     } | null>;