@mastra/inngest 1.0.0-beta.8 → 1.0.0

package/dist/index.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var agent = require('@mastra/core/agent');
+var error = require('@mastra/core/error');
+var observability = require('@mastra/core/observability');
+var processors = require('@mastra/core/processors');
 var tools = require('@mastra/core/tools');
 var workflows = require('@mastra/core/workflows');
 var _constants = require('@mastra/core/workflows/_constants');
@@ -7,7 +11,6 @@ var zod = require('zod');
 var crypto$1 = require('crypto');
 var di = require('@mastra/core/di');
 var inngest = require('inngest');
-var error = require('@mastra/core/error');
 var realtime = require('@inngest/realtime');
 var events = require('@mastra/core/events');
 var web = require('stream/web');
@@ -60,38 +63,46 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
    * After retries exhausted, error propagates here and we return a failed result.
    */
   async executeStepWithRetry(stepId, runStep, params) {
-    try {
-      const result = await this.wrapDurableOperation(stepId, runStep, { delay: params.delay });
-      return { ok: true, result };
-    } catch (e) {
-      const cause = e?.cause;
-      if (cause?.status === "failed") {
-        params.stepSpan?.error({
-          error: e,
-          attributes: { status: "failed" }
-        });
-        if (cause.error && !(cause.error instanceof Error)) {
-          cause.error = error.getErrorFromUnknown(cause.error, { serializeStack: false });
-        }
-        return { ok: false, error: cause };
+    for (let i = 0; i < params.retries + 1; i++) {
+      if (i > 0 && params.delay) {
+        await new Promise((resolve) => setTimeout(resolve, params.delay));
       }
-      const errorInstance = error.getErrorFromUnknown(e, {
-        serializeStack: false,
-        fallbackMessage: "Unknown step execution error"
-      });
-      params.stepSpan?.error({
-        error: errorInstance,
-        attributes: { status: "failed" }
-      });
-      return {
-        ok: false,
-        error: {
-          status: "failed",
-          error: errorInstance,
-          endedAt: Date.now()
+      try {
+        const result = await this.wrapDurableOperation(stepId, runStep);
+        return { ok: true, result };
+      } catch (e) {
+        if (i === params.retries) {
+          const cause = e?.cause;
+          if (cause?.status === "failed") {
+            params.stepSpan?.error({
+              error: e,
+              attributes: { status: "failed" }
+            });
+            if (cause.error && !(cause.error instanceof Error)) {
+              cause.error = error.getErrorFromUnknown(cause.error, { serializeStack: false });
+            }
+            return { ok: false, error: cause };
+          }
+          const errorInstance = error.getErrorFromUnknown(e, {
+            serializeStack: false,
+            fallbackMessage: "Unknown step execution error"
+          });
+          params.stepSpan?.error({
+            error: errorInstance,
+            attributes: { status: "failed" }
+          });
+          return {
+            ok: false,
+            error: {
+              status: "failed",
+              error: errorInstance,
+              endedAt: Date.now()
+            }
+          };
         }
-      };
+      }
     }
+    return { ok: false, error: { status: "failed", error: new Error("Unknown error"), endedAt: Date.now() } };
   }
   /**
    * Use Inngest's sleep primitive for durability
@@ -107,28 +118,32 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
   }
   /**
    * Wrap durable operations in Inngest step.run() for durability.
-   * If retryConfig is provided, throws RetryAfterError INSIDE step.run() to trigger
-   * Inngest's step-level retry mechanism (not function-level retry).
+   *
+   * IMPORTANT: Errors are wrapped with a cause structure before throwing.
+   * This is necessary because Inngest's error serialization (serialize-error-cjs)
+   * only captures standard Error properties (message, name, stack, code, cause).
+   * Custom properties like statusCode, responseHeaders from AI SDK errors would
+   * be lost. By putting our serialized error (via getErrorFromUnknown with toJSON())
+   * in the cause property, we ensure custom properties survive serialization.
+   * The cause property is in serialize-error-cjs's allowlist, and when the cause
+   * object is finally JSON.stringify'd, our error's toJSON() is called.
    */
-  async wrapDurableOperation(operationId, operationFn, retryConfig) {
+  async wrapDurableOperation(operationId, operationFn) {
     return this.inngestStep.run(operationId, async () => {
       try {
         return await operationFn();
       } catch (e) {
-        if (retryConfig) {
-          const errorInstance = error.getErrorFromUnknown(e, {
-            serializeStack: false,
-            fallbackMessage: "Unknown step execution error"
-          });
-          throw new inngest.RetryAfterError(errorInstance.message, retryConfig.delay, {
-            cause: {
-              status: "failed",
-              error: errorInstance,
-              endedAt: Date.now()
-            }
-          });
-        }
-        throw e;
+        const errorInstance = error.getErrorFromUnknown(e, {
+          serializeStack: false,
+          fallbackMessage: "Unknown step execution error"
+        });
+        throw new Error(errorInstance.message, {
+          cause: {
+            status: "failed",
+            error: errorInstance,
+            endedAt: Date.now()
+          }
+        });
       }
     });
   }
@@ -150,6 +165,96 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
   async invokeLifecycleCallbacksInternal(result) {
     return super.invokeLifecycleCallbacks(result);
   }
+  // =============================================================================
+  // Durable Span Lifecycle Hooks
+  // =============================================================================
+  /**
+   * Create a step span durably - on first execution, creates and exports span.
+   * On replay, returns cached span data without re-creating.
+   */
+  async createStepSpan(params) {
+    const { executionContext, operationId, options, parentSpan } = params;
+    const parentSpanId = parentSpan?.id ?? executionContext.tracingIds?.workflowSpanId;
+    const exportedSpan = await this.wrapDurableOperation(operationId, async () => {
+      const observability = this.mastra?.observability?.getSelectedInstance({});
+      if (!observability) return void 0;
+      const span = observability.startSpan({
+        ...options,
+        entityType: options.entityType,
+        traceId: executionContext.tracingIds?.traceId,
+        parentSpanId
+      });
+      return span?.exportSpan();
+    });
+    if (exportedSpan) {
+      const observability = this.mastra?.observability?.getSelectedInstance({});
+      return observability?.rebuildSpan(exportedSpan);
+    }
+    return void 0;
+  }
+  /**
+   * End a step span durably.
+   */
+  async endStepSpan(params) {
+    const { span, operationId, endOptions } = params;
+    if (!span) return;
+    await this.wrapDurableOperation(operationId, async () => {
+      span.end(endOptions);
+    });
+  }
+  /**
+   * Record error on step span durably.
+   */
+  async errorStepSpan(params) {
+    const { span, operationId, errorOptions } = params;
+    if (!span) return;
+    await this.wrapDurableOperation(operationId, async () => {
+      span.error(errorOptions);
+    });
+  }
+  /**
+   * Create a generic child span durably (for control-flow operations).
+   * On first execution, creates and exports span. On replay, returns cached span data.
+   */
+  async createChildSpan(params) {
+    const { executionContext, operationId, options, parentSpan } = params;
+    const parentSpanId = parentSpan?.id ?? executionContext.tracingIds?.workflowSpanId;
+    const exportedSpan = await this.wrapDurableOperation(operationId, async () => {
+      const observability = this.mastra?.observability?.getSelectedInstance({});
+      if (!observability) return void 0;
+      const span = observability.startSpan({
+        ...options,
+        traceId: executionContext.tracingIds?.traceId,
+        parentSpanId
+      });
+      return span?.exportSpan();
+    });
+    if (exportedSpan) {
+      const observability = this.mastra?.observability?.getSelectedInstance({});
+      return observability?.rebuildSpan(exportedSpan);
+    }
+    return void 0;
+  }
+  /**
+   * End a generic child span durably (for control-flow operations).
+   */
+  async endChildSpan(params) {
+    const { span, operationId, endOptions } = params;
+    if (!span) return;
+    await this.wrapDurableOperation(operationId, async () => {
+      span.end(endOptions);
+    });
+  }
+  /**
+   * Record error on a generic child span durably (for control-flow operations).
+   */
+  async errorChildSpan(params) {
+    const { span, operationId, errorOptions } = params;
+    if (!span) return;
+    await this.wrapDurableOperation(operationId, async () => {
+      span.error(errorOptions);
+    });
+  }
   /**
    * Execute nested InngestWorkflow using inngestStep.invoke() for durability.
    * This MUST be called directly (not inside step.run()) due to Inngest constraints.
@@ -158,7 +263,23 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
     if (!(params.step instanceof InngestWorkflow)) {
       return null;
     }
-    const { step, stepResults, executionContext, resume, timeTravel, prevOutput, inputData, pubsub, startedAt } = params;
+    const {
+      step,
+      stepResults,
+      executionContext,
+      resume,
+      timeTravel,
+      prevOutput,
+      inputData,
+      pubsub,
+      startedAt,
+      perStep,
+      stepSpan
+    } = params;
+    const nestedTracingContext = executionContext.tracingIds?.traceId ? {
+      traceId: executionContext.tracingIds.traceId,
+      parentSpanId: stepSpan?.id
+    } : void 0;
     const isResume = !!resume?.steps?.length;
     let result;
     let runId;
@@ -166,7 +287,8 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
     try {
       if (isResume) {
         runId = stepResults[resume?.steps?.[0] ?? ""]?.suspendPayload?.__workflow_meta?.runId ?? crypto$1.randomUUID();
-        const snapshot = await this.mastra?.getStorage()?.loadWorkflowSnapshot({
+        const workflowsStore = await this.mastra?.getStorage()?.getStore("workflows");
+        const snapshot = await workflowsStore?.loadWorkflowSnapshot({
           workflowName: step.id,
           runId
         });
@@ -183,14 +305,17 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
               resumePayload: resume.resumePayload,
               resumePath: resume.steps?.[1] ? snapshot?.suspendedPaths?.[resume.steps?.[1]] : void 0
             },
-            outputOptions: { includeState: true }
+            outputOptions: { includeState: true },
+            perStep,
+            tracingOptions: nestedTracingContext
           }
         });
         result = invokeResp.result;
         runId = invokeResp.runId;
         executionContext.state = invokeResp.result.state;
       } else if (isTimeTravel) {
-        const snapshot = await this.mastra?.getStorage()?.loadWorkflowSnapshot({
+        const workflowsStoreForTimeTravel = await this.mastra?.getStorage()?.getStore("workflows");
+        const snapshot = await workflowsStoreForTimeTravel?.loadWorkflowSnapshot({
           workflowName: step.id,
           runId: executionContext.runId
         }) ?? { context: {} };
@@ -209,7 +334,9 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
             timeTravel: timeTravelParams,
             initialState: executionContext.state ?? {},
             runId: executionContext.runId,
-            outputOptions: { includeState: true }
+            outputOptions: { includeState: true },
+            perStep,
+            tracingOptions: nestedTracingContext
           }
         });
         result = invokeResp.result;
@@ -221,7 +348,9 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
           data: {
             inputData,
             initialState: executionContext.state ?? {},
-            outputOptions: { includeState: true }
+            outputOptions: { includeState: true },
+            perStep,
+            tracingOptions: nestedTracingContext
           }
         });
         result = invokeResp.result;
@@ -260,7 +389,7 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
               }
             }
           });
-          return { executionContext, result: { status: "failed", error: result?.error } };
+          return { executionContext, result: { status: "failed", error: result?.error, endedAt: Date.now() } };
         } else if (result.status === "suspended") {
           const suspendedSteps = Object.entries(result.steps).filter(([_stepName, stepResult]) => {
             const stepRes = stepResult;
@@ -284,6 +413,7 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
               executionContext,
               result: {
                 status: "suspended",
+                suspendedAt: Date.now(),
                 payload: stepResult.payload,
                 suspendPayload: {
                   ...stepResult?.suspendPayload,
@@ -296,6 +426,7 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
             executionContext,
             result: {
               status: "suspended",
+              suspendedAt: Date.now(),
               payload: {}
             }
           };
@@ -317,9 +448,34 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
             executionContext,
             result: {
               status: "tripwire",
-              tripwire: result?.tripwire
+              tripwire: result?.tripwire,
+              endedAt: Date.now()
             }
           };
+        } else if (perStep || result.status === "paused") {
+          await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
+            type: "watch",
+            runId: executionContext.runId,
+            data: {
+              type: "workflow-step-result",
+              payload: {
+                id: step.id,
+                status: "paused"
+              }
+            }
+          });
+          await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
+            type: "watch",
+            runId: executionContext.runId,
+            data: {
+              type: "workflow-step-finish",
+              payload: {
+                id: step.id,
+                metadata: {}
+              }
+            }
+          });
+          return { executionContext, result: { status: "paused" } };
         }
         await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
           type: "watch",
@@ -344,14 +500,13 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
             }
           }
         });
-        return { executionContext, result: { status: "success", output: result?.result } };
+        return { executionContext, result: { status: "success", output: result?.result, endedAt: Date.now() } };
       }
     );
     Object.assign(executionContext, res.executionContext);
     return {
       ...res.result,
       startedAt,
-      endedAt: Date.now(),
       payload: inputData,
       resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
       resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
@@ -520,6 +675,7 @@ var InngestRun = class extends workflows.Run {
   async getRunOutput(eventId, maxWaitMs = 3e5) {
     const startTime = Date.now();
     const storage = this.#mastra?.getStorage();
+    const workflowsStore = await storage?.getStore("workflows");
     while (Date.now() - startTime < maxWaitMs) {
       let runs;
       try {
@@ -536,7 +692,7 @@ var InngestRun = class extends workflows.Run {
         return runs[0];
       }
       if (runs?.[0]?.status === "Failed") {
-        const snapshot = await storage?.loadWorkflowSnapshot({
+        const snapshot = await workflowsStore?.loadWorkflowSnapshot({
           workflowName: this.workflowId,
           runId: this.runId
         });
@@ -555,7 +711,7 @@ var InngestRun = class extends workflows.Run {
         };
       }
       if (runs?.[0]?.status === "Cancelled") {
-        const snapshot = await storage?.loadWorkflowSnapshot({
+        const snapshot = await workflowsStore?.loadWorkflowSnapshot({
           workflowName: this.workflowId,
           runId: this.runId
         });
@@ -573,12 +729,13 @@ var InngestRun = class extends workflows.Run {
         runId: this.runId
       }
     });
-    const snapshot = await storage?.loadWorkflowSnapshot({
+    const workflowsStore = await storage?.getStore("workflows");
+    const snapshot = await workflowsStore?.loadWorkflowSnapshot({
       workflowName: this.workflowId,
       runId: this.runId
     });
     if (snapshot) {
-      await storage?.persistWorkflowSnapshot({
+      await workflowsStore?.persistWorkflowSnapshot({
         workflowName: this.workflowId,
         runId: this.runId,
         resourceId: this.resourceId,
@@ -590,8 +747,8 @@ var InngestRun = class extends workflows.Run {
       });
     }
   }
-  async start(params) {
-    return this._start(params);
+  async start(args) {
+    return this._start(args);
   }
   /**
    * Starts the workflow execution without waiting for completion (fire-and-forget).
@@ -599,8 +756,9 @@ var InngestRun = class extends workflows.Run {
    * The workflow executes independently in Inngest.
    * Use this when you don't need to wait for the result or want to avoid polling failures.
    */
-  async startAsync(params) {
-    await this.#mastra.getStorage()?.persistWorkflowSnapshot({
+  async startAsync(args) {
+    const workflowsStore = await this.#mastra.getStorage()?.getStore("workflows");
+    await workflowsStore?.persistWorkflowSnapshot({
       workflowName: this.workflowId,
       runId: this.runId,
       resourceId: this.resourceId,
@@ -618,8 +776,8 @@ var InngestRun = class extends workflows.Run {
         timestamp: Date.now()
       }
     });
-    const inputDataToUse = await this._validateInput(params.inputData);
-    const initialStateToUse = await this._validateInitialState(params.initialState ?? {});
+    const inputDataToUse = await this._validateInput(args.inputData);
+    const initialStateToUse = await this._validateInitialState(args.initialState ?? {});
     const eventOutput = await this.inngest.send({
       name: `workflow.${this.workflowId}`,
       data: {
@@ -627,9 +785,10 @@ var InngestRun = class extends workflows.Run {
         initialState: initialStateToUse,
         runId: this.runId,
         resourceId: this.resourceId,
-        outputOptions: params.outputOptions,
-        tracingOptions: params.tracingOptions,
-        requestContext: params.requestContext ? Object.fromEntries(params.requestContext.entries()) : {}
+        outputOptions: args.outputOptions,
+        tracingOptions: args.tracingOptions,
+        requestContext: args.requestContext ? Object.fromEntries(args.requestContext.entries()) : {},
+        perStep: args.perStep
       }
     });
     const eventId = eventOutput.ids[0];
@@ -644,9 +803,11 @@ var InngestRun = class extends workflows.Run {
     outputOptions,
     tracingOptions,
     format,
-    requestContext
+    requestContext,
+    perStep
   }) {
-    await this.#mastra.getStorage()?.persistWorkflowSnapshot({
+    const workflowsStore = await this.#mastra.getStorage()?.getStore("workflows");
+    await workflowsStore?.persistWorkflowSnapshot({
       workflowName: this.workflowId,
       runId: this.runId,
       resourceId: this.resourceId,
@@ -676,7 +837,8 @@ var InngestRun = class extends workflows.Run {
         outputOptions,
         tracingOptions,
         format,
-        requestContext: requestContext ? Object.fromEntries(requestContext.entries()) : {}
+        requestContext: requestContext ? Object.fromEntries(requestContext.entries()) : {},
+        perStep
       }
     });
     const eventId = eventOutput.ids[0];
@@ -712,7 +874,8 @@ var InngestRun = class extends workflows.Run {
         (step) => typeof step === "string" ? step : step?.id
       );
     }
-    const snapshot = await storage?.loadWorkflowSnapshot({
+    const workflowsStore = await storage?.getStore("workflows");
+    const snapshot = await workflowsStore?.loadWorkflowSnapshot({
       workflowName: this.workflowId,
       runId: this.runId
     });
@@ -735,7 +898,8 @@ var InngestRun = class extends workflows.Run {
           resumePayload: resumeDataToUse,
           resumePath: steps?.[0] ? snapshot?.suspendedPaths?.[steps?.[0]] : void 0
         },
-        requestContext: mergedRequestContext
+        requestContext: mergedRequestContext,
+        perStep: params.perStep
       }
     });
     const eventId = eventOutput.ids[0];
@@ -774,12 +938,13 @@ var InngestRun = class extends workflows.Run {
       throw new Error("No steps provided to timeTravel");
     }
     const storage = this.#mastra?.getStorage();
-    const snapshot = await storage?.loadWorkflowSnapshot({
+    const workflowsStore = await storage?.getStore("workflows");
+    const snapshot = await workflowsStore?.loadWorkflowSnapshot({
       workflowName: this.workflowId,
       runId: this.runId
     });
     if (!snapshot) {
-      await storage?.persistWorkflowSnapshot({
+      await workflowsStore?.persistWorkflowSnapshot({
         workflowName: this.workflowId,
         runId: this.runId,
         resourceId: this.resourceId,
@@ -813,7 +978,8 @@ var InngestRun = class extends workflows.Run {
       nestedStepsContext: params.nestedStepsContext,
       snapshot: snapshot ?? { context: {} },
       graph: this.executionGraph,
-      initialState: params.initialState
+      initialState: params.initialState,
+      perStep: params.perStep
     });
     const eventOutput = await this.inngest.send({
       name: `workflow.${this.workflowId}`,
@@ -825,7 +991,8 @@ var InngestRun = class extends workflows.Run {
         timeTravel: timeTravelData,
         tracingOptions: params.tracingOptions,
         outputOptions: params.outputOptions,
-        requestContext: params.requestContext ? Object.fromEntries(params.requestContext.entries()) : {}
+        requestContext: params.requestContext ? Object.fromEntries(params.requestContext.entries()) : {},
+        perStep: params.perStep
       }
     });
     const eventId = eventOutput.ids[0];
@@ -916,7 +1083,8 @@ var InngestRun = class extends workflows.Run {
     tracingOptions,
     closeOnSuspend = true,
     initialState,
-    outputOptions
+    outputOptions,
+    perStep
   } = {}) {
     if (this.closeStreamAction && this.streamOutput) {
       return this.streamOutput;
@@ -952,7 +1120,8 @@ var InngestRun = class extends workflows.Run {
           initialState,
           tracingOptions,
           outputOptions,
-          format: "vnext"
+          format: "vnext",
+          perStep
         });
         let executionResults;
         try {
@@ -983,9 +1152,6 @@ var InngestRun = class extends workflows.Run {
     });
     return this.streamOutput;
   }
-  streamVNext(args = {}) {
-    return this.stream(args);
-  }
   timeTravelStream({
     inputData,
     resumeData,
@@ -994,8 +1160,10 @@ var InngestRun = class extends workflows.Run {
     context,
     nestedStepsContext,
     requestContext,
+    // tracingContext,
     tracingOptions,
-    outputOptions
+    outputOptions,
+    perStep
   }) {
     this.closeStreamAction = async () => {
     };
@@ -1030,7 +1198,8 @@ var InngestRun = class extends workflows.Run {
           initialState,
           requestContext,
           tracingOptions,
-          outputOptions
+          outputOptions,
+          perStep
         });
         self.executionResults = executionResultsPromise;
         let executionResults;
@@ -1074,9 +1243,11 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
   #mastra;
   inngest;
   function;
+  cronFunction;
   flowControlConfig;
+  cronConfig;
   constructor(params, inngest) {
-    const { concurrency, rateLimit, throttle, debounce, priority, ...workflowParams } = params;
+    const { concurrency, rateLimit, throttle, debounce, priority, cron, inputData, initialState, ...workflowParams } = params;
     super(workflowParams);
     this.engineType = "inngest";
     const flowControlEntries = Object.entries({ concurrency, rateLimit, throttle, debounce, priority }).filter(
@@ -1085,6 +1256,9 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
     this.flowControlConfig = flowControlEntries.length > 0 ? Object.fromEntries(flowControlEntries) : void 0;
     this.#mastra = params.mastra;
     this.inngest = inngest;
+    if (cron) {
+      this.cronConfig = { cron, inputData, initialState };
+    }
   }
   async listWorkflowRuns(args) {
     const storage = this.#mastra?.getStorage();
@@ -1092,16 +1266,11 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
       this.logger.debug("Cannot get workflow runs. Mastra engine is not initialized");
       return { runs: [], total: 0 };
     }
-    return storage.listWorkflowRuns({ workflowName: this.id, ...args ?? {} });
-  }
-  async getWorkflowRunById(runId) {
-    const storage = this.#mastra?.getStorage();
-    if (!storage) {
-      this.logger.debug("Cannot get workflow runs. Mastra engine is not initialized");
-      return this.runs.get(runId) ? { ...this.runs.get(runId), workflowName: this.id } : null;
+    const workflowsStore = await storage.getStore("workflows");
+    if (!workflowsStore) {
+      return { runs: [], total: 0 };
     }
-    const run = await storage.getWorkflowRunById({ runId, workflowName: this.id });
-    return run ?? (this.runs.get(runId) ? { ...this.runs.get(runId), workflowName: this.id } : null);
+    return workflowsStore.listWorkflowRuns({ workflowName: this.id, ...args ?? {} });
   }
   __registerMastra(mastra) {
     super.__registerMastra(mastra);
@@ -1124,7 +1293,8 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
   }
   async createRun(options) {
     const runIdToUse = options?.runId || crypto$1.randomUUID();
-    const run = this.runs.get(runIdToUse) ?? new InngestRun(
+    const existingInMemoryRun = this.runs.get(runIdToUse);
+    const newRun = new InngestRun(
       {
         workflowId: this.id,
         runId: runIdToUse,
@@ -1141,14 +1311,19 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
       },
       this.inngest
     );
+    const run = existingInMemoryRun ?? newRun;
     this.runs.set(runIdToUse, run);
     const shouldPersistSnapshot = this.options.shouldPersistSnapshot({
       workflowStatus: run.workflowRunStatus,
       stepResults: {}
     });
-    const workflowSnapshotInStorage = await this.getWorkflowRunExecutionResult(runIdToUse, false);
-    if (!workflowSnapshotInStorage && shouldPersistSnapshot) {
-      await this.mastra?.getStorage()?.persistWorkflowSnapshot({
+    const existingStoredRun = await this.getWorkflowRunById(runIdToUse, {
+      withNestedWorkflows: false
+    });
+    const existsInStorage = existingStoredRun && !existingStoredRun.isFromInMemory;
+    if (!existsInStorage && shouldPersistSnapshot) {
+      const workflowsStore = await this.mastra?.getStorage()?.getStore("workflows");
+      await workflowsStore?.persistWorkflowSnapshot({
         workflowName: this.id,
         runId: runIdToUse,
         resourceId: options?.resourceId,
@@ -1171,6 +1346,30 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
     }
     return run;
   }
+  //createCronFunction is only called if cronConfig.cron is defined.
+  createCronFunction() {
+    if (this.cronFunction) {
+      return this.cronFunction;
+    }
+    this.cronFunction = this.inngest.createFunction(
+      {
+        id: `workflow.${this.id}.cron`,
+        retries: 0,
+        cancelOn: [{ event: `cancel.workflow.${this.id}` }],
+        ...this.flowControlConfig
+      },
+      { cron: this.cronConfig?.cron ?? "" },
+      async () => {
+        const run = await this.createRun();
+        const result = await run.start({
+          inputData: this.cronConfig?.inputData,
+          initialState: this.cronConfig?.initialState
+        });
+        return { result, runId: run.runId };
+      }
+    );
+    return this.cronFunction;
+  }
   getFunction() {
     if (this.function) {
       return this.function;
@@ -1178,52 +1377,128 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
     this.function = this.inngest.createFunction(
       {
         id: `workflow.${this.id}`,
-        retries: Math.min(this.retryConfig?.attempts ?? 0, 20),
+        retries: 0,
         cancelOn: [{ event: `cancel.workflow.${this.id}` }],
         // Spread flow control configuration
         ...this.flowControlConfig
       },
       { event: `workflow.${this.id}` },
       async ({ event, step, attempt, publish }) => {
-        let { inputData, initialState, runId, resourceId, resume, outputOptions, format, timeTravel } = event.data;
+        let {
+          inputData,
+          initialState,
+          runId,
+          resourceId,
+          resume,
+          outputOptions,
+          format,
+          timeTravel,
+          perStep,
+          tracingOptions
+        } = event.data;
         if (!runId) {
           runId = await step.run(`workflow.${this.id}.runIdGen`, async () => {
             return crypto$1.randomUUID();
           });
         }
         const pubsub = new InngestPubSub(this.inngest, this.id, publish);
+        const requestContext = new di.RequestContext(Object.entries(event.data.requestContext ?? {}));
+        const mastra = this.#mastra;
+        const tracingPolicy = this.options.tracingPolicy;
+        const workflowSpanData = await step.run(`workflow.${this.id}.span.start`, async () => {
+          const observability$1 = mastra?.observability?.getSelectedInstance({ requestContext });
+          if (!observability$1) return void 0;
+          const span = observability$1.startSpan({
+            type: observability.SpanType.WORKFLOW_RUN,
+            name: `workflow run: '${this.id}'`,
+            entityType: observability.EntityType.WORKFLOW_RUN,
+            entityId: this.id,
+            input: inputData,
+            metadata: {
+              resourceId,
+              runId
+            },
+            tracingPolicy,
+            tracingOptions,
+            requestContext
+          });
+          return span?.exportSpan();
+        });
         const engine = new InngestExecutionEngine(this.#mastra, step, attempt, this.options);
-        const result = await engine.execute({
-          workflowId: this.id,
-          runId,
-          resourceId,
-          graph: this.executionGraph,
-          serializedStepGraph: this.serializedStepGraph,
-          input: inputData,
-          initialState,
-          pubsub,
-          retryConfig: this.retryConfig,
-          requestContext: new di.RequestContext(Object.entries(event.data.requestContext ?? {})),
-          resume,
-          timeTravel,
-          format,
-          abortController: new AbortController(),
-          // currentSpan: undefined, // TODO: Pass actual parent Span from workflow execution context
-          outputOptions,
-          outputWriter: async (chunk) => {
-            try {
-              await pubsub.publish(`workflow.events.v2.${runId}`, {
-                type: "watch",
-                runId,
-                data: chunk
-              });
-            } catch (err) {
-              this.logger.debug?.("Failed to publish watch event:", err);
+        let result;
+        try {
+          result = await engine.execute({
+            workflowId: this.id,
+            runId,
+            resourceId,
+            graph: this.executionGraph,
+            serializedStepGraph: this.serializedStepGraph,
+            input: inputData,
+            initialState,
+            pubsub,
+            retryConfig: this.retryConfig,
+            requestContext,
+            resume,
+            timeTravel,
+            perStep,
+            format,
+            abortController: new AbortController(),
+            // For Inngest, we don't pass workflowSpan - step spans use tracingIds instead
+            workflowSpan: void 0,
+            // Pass tracing IDs for durable span operations
+            tracingIds: workflowSpanData ? {
+              traceId: workflowSpanData.traceId,
+              workflowSpanId: workflowSpanData.id
+            } : void 0,
+            outputOptions,
+            outputWriter: async (chunk) => {
+              try {
+                await pubsub.publish(`workflow.events.v2.${runId}`, {
+                  type: "watch",
+                  runId,
+                  data: chunk
+                });
+              } catch (err) {
+                this.logger.debug?.("Failed to publish watch event:", err);
+              }
             }
-          }
-        });
+          });
+        } catch (error) {
+          throw error;
+        }
         await step.run(`workflow.${this.id}.finalize`, async () => {
-          await engine.invokeLifecycleCallbacksInternal(result);
+          if (result.status !== "paused") {
+            await engine.invokeLifecycleCallbacksInternal({
+              status: result.status,
+              result: "result" in result ? result.result : void 0,
+              error: "error" in result ? result.error : void 0,
+              steps: result.steps,
+              tripwire: "tripwire" in result ? result.tripwire : void 0,
+              runId,
+              workflowId: this.id,
+              resourceId,
+              input: inputData,
+              requestContext,
+              state: result.state ?? initialState ?? {}
+            });
+          }
+          if (workflowSpanData) {
+            const observability = mastra?.observability?.getSelectedInstance({ requestContext });
+            if (observability) {
+              const workflowSpan = observability.rebuildSpan(workflowSpanData);
+              if (result.status === "failed") {
+                workflowSpan.error({
+                  error: result.error instanceof Error ? result.error : new Error(String(result.error)),
+                  attributes: { status: "failed" }
+                });
+              } else {
+                workflowSpan.end({
+                  output: result.status === "success" ? result.result : void 0,
+                  attributes: { status: result.status }
+                });
+              }
+            }
+          }
           if (result.status === "failed") {
             throw new inngest.NonRetriableError(`Workflow failed`, {
               cause: result
@@ -1250,15 +1525,14 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
     });
   }
   getFunctions() {
-    return [this.getFunction(), ...this.getNestedFunctions(this.executionGraph.steps)];
+    return [
+      this.getFunction(),
+      ...this.cronConfig?.cron ? [this.createCronFunction()] : [],
+      ...this.getNestedFunctions(this.executionGraph.steps)
+    ];
   }
 };
-function serve({
-  mastra,
-  inngest,
-  functions: userFunctions = [],
-  registerOptions
-}) {
+function prepareServeOptions({ mastra, inngest, functions: userFunctions = [], registerOptions }) {
   const wfs = mastra.listWorkflows();
   const workflowFunctions = Array.from(
     new Set(
@@ -1271,177 +1545,181 @@ function serve({
       })
     )
   );
-  return hono.serve({
+  return {
     ...registerOptions,
     client: inngest,
     functions: [...workflowFunctions, ...userFunctions]
-  });
+  };
 }
+function createServe(adapter) {
+  return (options) => {
+    const serveOptions = prepareServeOptions(options);
+    return adapter(serveOptions);
+  };
+}
+var serve = createServe(hono.serve);
 
 // src/types.ts
 var _compatibilityCheck = true;
 
 // src/index.ts
-function isAgent(params) {
-  return params?.component === "AGENT";
+function isInngestWorkflow(input) {
+  return input instanceof InngestWorkflow;
+}
+function isAgent(input) {
+  return input instanceof agent.Agent;
+}
+function isToolStep(input) {
+  return input instanceof tools.Tool;
 }
-function isTool(params) {
-  return params instanceof tools.Tool;
+function isStepParams(input) {
+  return input !== null && typeof input === "object" && "id" in input && "execute" in input && !(input instanceof agent.Agent) && !(input instanceof tools.Tool) && !(input instanceof InngestWorkflow);
 }
-function isInngestWorkflow(params) {
-  return params instanceof InngestWorkflow;
+function isProcessor(obj) {
+  return obj !== null && typeof obj === "object" && "id" in obj && typeof obj.id === "string" && !(obj instanceof agent.Agent) && !(obj instanceof tools.Tool) && !(obj instanceof InngestWorkflow) && (typeof obj.processInput === "function" || typeof obj.processInputStep === "function" || typeof obj.processOutputStream === "function" || typeof obj.processOutputResult === "function" || typeof obj.processOutputStep === "function");
 }
-function createStep(params, agentOptions) {
+function createStep(params, agentOrToolOptions) {
   if (isInngestWorkflow(params)) {
     return params;
   }
   if (isAgent(params)) {
-    const outputSchema = agentOptions?.structuredOutput?.schema ?? zod.z.object({ text: zod.z.string() });
-    return {
-      id: params.name,
-      description: params.getDescription(),
-      inputSchema: zod.z.object({
-        prompt: zod.z.string()
-        // resourceId: z.string().optional(),
-        // threadId: z.string().optional(),
-      }),
-      outputSchema,
-      execute: async ({
-        inputData,
-        runId,
-        [_constants.PUBSUB_SYMBOL]: pubsub,
-        [_constants.STREAM_FORMAT_SYMBOL]: streamFormat,
-        requestContext,
-        tracingContext,
-        abortSignal,
-        abort,
-        writer
-      }) => {
-        let streamPromise = {};
-        streamPromise.promise = new Promise((resolve, reject) => {
-          streamPromise.resolve = resolve;
-          streamPromise.reject = reject;
+    return createStepFromAgent(params, agentOrToolOptions);
+  }
+  if (isToolStep(params)) {
+    return createStepFromTool(params, agentOrToolOptions);
+  }
+  if (isStepParams(params)) {
+    return createStepFromParams(params);
+  }
+  if (isProcessor(params)) {
+    return createStepFromProcessor(params);
+  }
+  throw new Error("Invalid input: expected StepParams, Agent, ToolStep, Processor, or InngestWorkflow");
+}
+function createStepFromParams(params) {
+  return {
+    id: params.id,
+    description: params.description,
+    inputSchema: params.inputSchema,
+    stateSchema: params.stateSchema,
+    outputSchema: params.outputSchema,
+    resumeSchema: params.resumeSchema,
+    suspendSchema: params.suspendSchema,
+    scorers: params.scorers,
+    retries: params.retries,
+    execute: params.execute.bind(params)
+  };
+}
+function createStepFromAgent(params, agentOrToolOptions) {
+  const options = agentOrToolOptions ?? {};
+  const outputSchema = options?.structuredOutput?.schema ?? zod.z.object({ text: zod.z.string() });
+  const { retries, scorers, ...agentOptions } = options ?? {};
+  return {
+    id: params.name,
+    description: params.getDescription(),
+    inputSchema: zod.z.object({
+      prompt: zod.z.string()
+    }),
+    outputSchema,
+    retries,
+    scorers,
+    execute: async ({
+      inputData,
+      runId,
+      [_constants.PUBSUB_SYMBOL]: pubsub,
+      [_constants.STREAM_FORMAT_SYMBOL]: streamFormat,
+      requestContext,
+      tracingContext,
+      abortSignal,
+      abort,
+      writer
+    }) => {
+      let streamPromise = {};
+      streamPromise.promise = new Promise((resolve, reject) => {
+        streamPromise.resolve = resolve;
+        streamPromise.reject = reject;
+      });
+      let structuredResult = null;
+      const toolData = {
+        name: params.name,
+        args: inputData
+      };
+      let stream;
+      if ((await params.getModel()).specificationVersion === "v1") {
+        const { fullStream } = await params.streamLegacy(inputData.prompt, {
+          ...agentOptions ?? {},
+          requestContext,
+          tracingContext,
+          onFinish: (result) => {
+            const resultWithObject = result;
+            if (agentOptions?.structuredOutput?.schema && resultWithObject.object) {
+              structuredResult = resultWithObject.object;
+            }
+            streamPromise.resolve(result.text);
+            void agentOptions?.onFinish?.(result);
+          },
+          abortSignal
         });
-        let structuredResult = null;
-        const toolData = {
-          name: params.name,
-          args: inputData
-        };
-        let stream;
-        if ((await params.getModel()).specificationVersion === "v1") {
-          const { fullStream } = await params.streamLegacy(inputData.prompt, {
-            ...agentOptions ?? {},
-            // resourceId: inputData.resourceId,
-            // threadId: inputData.threadId,
-            requestContext,
-            tracingContext,
-            onFinish: (result) => {
-              const resultWithObject = result;
-              if (agentOptions?.structuredOutput?.schema && resultWithObject.object) {
-                structuredResult = resultWithObject.object;
-              }
-              streamPromise.resolve(result.text);
-              void agentOptions?.onFinish?.(result);
-            },
-            abortSignal
-          });
-          stream = fullStream;
-        } else {
-          const modelOutput = await params.stream(inputData.prompt, {
-            ...agentOptions ?? {},
-            requestContext,
-            tracingContext,
-            onFinish: (result) => {
-              const resultWithObject = result;
-              if (agentOptions?.structuredOutput?.schema && resultWithObject.object) {
-                structuredResult = resultWithObject.object;
-              }
-              streamPromise.resolve(result.text);
-              void agentOptions?.onFinish?.(result);
-            },
-            abortSignal
-          });
-          stream = modelOutput.fullStream;
-        }
-        if (streamFormat === "legacy") {
-          await pubsub.publish(`workflow.events.v2.${runId}`, {
-            type: "watch",
-            runId,
-            data: { type: "tool-call-streaming-start", ...toolData ?? {} }
-          });
-          for await (const chunk of stream) {
-            if (chunk.type === "text-delta") {
-              await pubsub.publish(`workflow.events.v2.${runId}`, {
-                type: "watch",
-                runId,
-                data: { type: "tool-call-delta", ...toolData ?? {}, argsTextDelta: chunk.textDelta }
-              });
+        stream = fullStream;
+      } else {
+        const modelOutput = await params.stream(inputData.prompt, {
+          ...agentOptions ?? {},
+          requestContext,
+          tracingContext,
+          onFinish: (result) => {
+            const resultWithObject = result;
+            if (agentOptions?.structuredOutput?.schema && resultWithObject.object) {
+              structuredResult = resultWithObject.object;
             }
-          }
-          await pubsub.publish(`workflow.events.v2.${runId}`, {
-            type: "watch",
-            runId,
-            data: { type: "tool-call-streaming-finish", ...toolData ?? {} }
-          });
-        } else {
-          for await (const chunk of stream) {
-            await writer.write(chunk);
+            streamPromise.resolve(result.text);
+            void agentOptions?.onFinish?.(result);
+          },
+          abortSignal
+        });
+        stream = modelOutput.fullStream;
+      }
+      if (streamFormat === "legacy") {
+        await pubsub.publish(`workflow.events.v2.${runId}`, {
+          type: "watch",
+          runId,
+          data: { type: "tool-call-streaming-start", ...toolData ?? {} }
+        });
+        for await (const chunk of stream) {
+          if (chunk.type === "text-delta") {
+            await pubsub.publish(`workflow.events.v2.${runId}`, {
+              type: "watch",
+              runId,
+              data: { type: "tool-call-delta", ...toolData ?? {}, argsTextDelta: chunk.textDelta }
+            });
           }
         }
-        if (abortSignal.aborted) {
-          return abort();
-        }
-        if (structuredResult !== null) {
-          return structuredResult;
+        await pubsub.publish(`workflow.events.v2.${runId}`, {
+          type: "watch",
+          runId,
+          data: { type: "tool-call-streaming-finish", ...toolData ?? {} }
+        });
+      } else {
+        for await (const chunk of stream) {
+          await writer.write(chunk);
         }
-        return {
-          text: await streamPromise.promise
-        };
-      },
-      component: params.component
-    };
-  }
-  if (isTool(params)) {
-    if (!params.inputSchema || !params.outputSchema) {
-      throw new Error("Tool must have input and output schemas defined");
-    }
-    return {
-      // TODO: tool probably should have strong id type
-      id: params.id,
-      description: params.description,
-      inputSchema: params.inputSchema,
-      outputSchema: params.outputSchema,
-      suspendSchema: params.suspendSchema,
-      resumeSchema: params.resumeSchema,
-      execute: async ({
-        inputData,
-        mastra,
-        requestContext,
-        tracingContext,
-        suspend,
-        resumeData,
-        runId,
-        workflowId,
-        state,
-        setState
-      }) => {
-        const toolContext = {
-          mastra,
-          requestContext,
-          tracingContext,
-          workflow: {
-            runId,
-            resumeData,
-            suspend,
-            workflowId,
-            state,
-            setState
-          }
-        };
-        return params.execute(inputData, toolContext);
-      },
-      component: "TOOL"
-    };
+      }
+      if (abortSignal.aborted) {
+        return abort();
+      }
+      if (structuredResult !== null) {
+        return structuredResult;
+      }
+      return {
+        text: await streamPromise.promise
+      };
+    },
+    component: params.component
+  };
+}
+function createStepFromTool(params, agentOrToolOptions) {
+  const toolOpts = agentOrToolOptions;
+  if (!params.inputSchema || !params.outputSchema) {
+    throw new Error("Tool must have input and output schemas defined");
   }
   return {
     id: params.id,
@@ -1450,7 +1728,480 @@ function createStep(params, agentOptions) {
     outputSchema: params.outputSchema,
     resumeSchema: params.resumeSchema,
     suspendSchema: params.suspendSchema,
-    execute: params.execute
+    retries: toolOpts?.retries,
+    scorers: toolOpts?.scorers,
+    execute: async ({
+      inputData,
+      mastra,
+      requestContext,
+      tracingContext,
+      suspend,
+      resumeData,
+      runId,
+      workflowId,
+      state,
+      setState
+    }) => {
+      const toolContext = {
+        mastra,
+        requestContext,
+        tracingContext,
+        workflow: {
+          runId,
+          resumeData,
+          suspend,
+          workflowId,
+          state,
+          setState
+        }
+      };
+      return params.execute(inputData, toolContext);
+    },
+    component: "TOOL"
+  };
+}
+function createStepFromProcessor(processor) {
+  const getProcessorEntityType = (phase) => {
+    switch (phase) {
+      case "input":
+        return observability.EntityType.INPUT_PROCESSOR;
+      case "inputStep":
+        return observability.EntityType.INPUT_STEP_PROCESSOR;
+      case "outputStream":
+      case "outputResult":
+        return observability.EntityType.OUTPUT_PROCESSOR;
+      case "outputStep":
+        return observability.EntityType.OUTPUT_STEP_PROCESSOR;
+      default:
+        return observability.EntityType.OUTPUT_PROCESSOR;
+    }
+  };
+  const getSpanNamePrefix = (phase) => {
+    switch (phase) {
+      case "input":
+        return "input processor";
+      case "inputStep":
+        return "input step processor";
+      case "outputStream":
+        return "output stream processor";
+      case "outputResult":
+        return "output processor";
+      case "outputStep":
+        return "output step processor";
+      default:
+        return "processor";
+    }
+  };
+  const hasPhaseMethod = (phase) => {
+    switch (phase) {
+      case "input":
+        return !!processor.processInput;
+      case "inputStep":
+        return !!processor.processInputStep;
+      case "outputStream":
+        return !!processor.processOutputStream;
+      case "outputResult":
+        return !!processor.processOutputResult;
+      case "outputStep":
+        return !!processor.processOutputStep;
+      default:
+        return false;
+    }
+  };
+  return {
+    id: `processor:${processor.id}`,
+    description: processor.name ?? `Processor ${processor.id}`,
+    inputSchema: processors.ProcessorStepSchema,
+    outputSchema: processors.ProcessorStepOutputSchema,
+    execute: async ({ inputData, requestContext, tracingContext }) => {
+      const input = inputData;
+      const {
+        phase,
+        messages,
+        messageList,
+        stepNumber,
+        systemMessages,
+        part,
+        streamParts,
+        state,
+        finishReason,
+        toolCalls,
+        text,
+        retryCount,
+        // inputStep phase fields for model/tools configuration
+        model,
+        tools,
+        toolChoice,
+        activeTools,
+        providerOptions,
+        modelSettings,
+        structuredOutput,
+        steps
+      } = input;
+      const abort = (reason, options) => {
+        throw new agent.TripWire(reason || `Tripwire triggered by ${processor.id}`, options, processor.id);
+      };
+      if (!hasPhaseMethod(phase)) {
+        return input;
+      }
+      const currentSpan = tracingContext?.currentSpan;
+      const parentSpan = phase === "inputStep" || phase === "outputStep" ? currentSpan?.findParent(observability.SpanType.MODEL_STEP) || currentSpan : currentSpan?.findParent(observability.SpanType.AGENT_RUN) || currentSpan;
+      const processorSpan = phase !== "outputStream" ? parentSpan?.createChildSpan({
+        type: observability.SpanType.PROCESSOR_RUN,
+        name: `${getSpanNamePrefix(phase)}: ${processor.id}`,
+        entityType: getProcessorEntityType(phase),
+        entityId: processor.id,
+        entityName: processor.name ?? processor.id,
+        input: { phase, messageCount: messages?.length },
+        attributes: {
+          processorExecutor: "workflow",
+          // Read processorIndex from processor (set in combineProcessorsIntoWorkflow)
+          processorIndex: processor.processorIndex
+        }
+      }) : void 0;
+      const processorTracingContext = processorSpan ? { currentSpan: processorSpan } : tracingContext;
+      const baseContext = {
+        abort,
+        retryCount: retryCount ?? 0,
+        requestContext,
+        tracingContext: processorTracingContext
+      };
+      const passThrough = {
+        phase,
+        // Auto-create MessageList from messages if not provided
+        // This enables running processor workflows from the UI where messageList can't be serialized
+        messageList: messageList ?? (Array.isArray(messages) ? new agent.MessageList().add(messages, "input").addSystem(systemMessages ?? []) : void 0),
+        stepNumber,
+        systemMessages,
+        streamParts,
+        state,
+        finishReason,
+        toolCalls,
+        text,
+        retryCount,
+        // inputStep phase fields for model/tools configuration
+        model,
+        tools,
+        toolChoice,
+        activeTools,
+        providerOptions,
+        modelSettings,
+        structuredOutput,
+        steps
+      };
+      const executePhaseWithSpan = async (fn) => {
+        try {
+          const result = await fn();
+          processorSpan?.end({ output: result });
+          return result;
+        } catch (error) {
+          if (error instanceof agent.TripWire) {
+            processorSpan?.end({ output: { tripwire: error.message } });
+          } else {
+            processorSpan?.error({ error, endSpan: true });
+          }
+          throw error;
+        }
+      };
+      return executePhaseWithSpan(async () => {
+        switch (phase) {
+          case "input": {
+            if (processor.processInput) {
+              if (!passThrough.messageList) {
+                throw new error.MastraError({
+                  category: error.ErrorCategory.USER,
+                  domain: error.ErrorDomain.MASTRA_WORKFLOW,
+                  id: "PROCESSOR_MISSING_MESSAGE_LIST",
+                  text: `Processor ${processor.id} requires messageList or messages for processInput phase`
+                });
+              }
+              const idsBeforeProcessing = messages.map((m) => m.id);
+              const check = passThrough.messageList.makeMessageSourceChecker();
+              const result = await processor.processInput({
+                ...baseContext,
+                messages,
+                messageList: passThrough.messageList,
+                systemMessages: systemMessages ?? []
+              });
+              if (result instanceof agent.MessageList) {
+                if (result !== passThrough.messageList) {
+                  throw new error.MastraError({
+                    category: error.ErrorCategory.USER,
+                    domain: error.ErrorDomain.MASTRA_WORKFLOW,
+                    id: "PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST",
+                    text: `Processor ${processor.id} returned a MessageList instance other than the one passed in. Use the messageList argument instead.`
+                  });
+                }
+                return {
+                  ...passThrough,
+                  messages: result.get.all.db(),
+                  systemMessages: result.getAllSystemMessages()
+                };
+              } else if (Array.isArray(result)) {
+                processors.ProcessorRunner.applyMessagesToMessageList(
+                  result,
+                  passThrough.messageList,
+                  idsBeforeProcessing,
+                  check,
+                  "input"
+                );
+                return { ...passThrough, messages: result };
+              } else if (result && "messages" in result && "systemMessages" in result) {
+                const typedResult = result;
+                processors.ProcessorRunner.applyMessagesToMessageList(
+                  typedResult.messages,
+                  passThrough.messageList,
+                  idsBeforeProcessing,
+                  check,
+                  "input"
+                );
+                passThrough.messageList.replaceAllSystemMessages(typedResult.systemMessages);
+                return {
+                  ...passThrough,
+                  messages: typedResult.messages,
+                  systemMessages: typedResult.systemMessages
+                };
+              }
+              return { ...passThrough, messages };
+            }
+            return { ...passThrough, messages };
+          }
+          case "inputStep": {
+            if (processor.processInputStep) {
+              if (!passThrough.messageList) {
+                throw new error.MastraError({
+                  category: error.ErrorCategory.USER,
+                  domain: error.ErrorDomain.MASTRA_WORKFLOW,
+                  id: "PROCESSOR_MISSING_MESSAGE_LIST",
+                  text: `Processor ${processor.id} requires messageList or messages for processInputStep phase`
+                });
+              }
+              const idsBeforeProcessing = messages.map((m) => m.id);
+              const check = passThrough.messageList.makeMessageSourceChecker();
+              const result = await processor.processInputStep({
+                ...baseContext,
+                messages,
+                messageList: passThrough.messageList,
+                stepNumber: stepNumber ?? 0,
+                systemMessages: systemMessages ?? [],
+                // Pass model/tools configuration fields - types match ProcessInputStepArgs
+                model,
+                tools,
+                toolChoice,
+                activeTools,
+                providerOptions,
+                modelSettings,
+                structuredOutput,
+                steps: steps ?? []
+              });
+              const validatedResult = await processors.ProcessorRunner.validateAndFormatProcessInputStepResult(result, {
+                messageList: passThrough.messageList,
+                processor,
+                stepNumber: stepNumber ?? 0
+              });
+              if (validatedResult.messages) {
+                processors.ProcessorRunner.applyMessagesToMessageList(
+                  validatedResult.messages,
+                  passThrough.messageList,
+                  idsBeforeProcessing,
+                  check
+                );
+              }
+              if (validatedResult.systemMessages) {
+                passThrough.messageList.replaceAllSystemMessages(validatedResult.systemMessages);
+              }
+              return { ...passThrough, messages, ...validatedResult };
+            }
+            return { ...passThrough, messages };
+          }
+          case "outputStream": {
+            if (processor.processOutputStream) {
+              const spanKey = `__outputStreamSpan_${processor.id}`;
+              const mutableState = state ?? {};
+              let processorSpan2 = mutableState[spanKey];
+              if (!processorSpan2 && parentSpan) {
+                processorSpan2 = parentSpan.createChildSpan({
+                  type: observability.SpanType.PROCESSOR_RUN,
+                  name: `output stream processor: ${processor.id}`,
+                  entityType: observability.EntityType.OUTPUT_PROCESSOR,
+                  entityId: processor.id,
+                  entityName: processor.name ?? processor.id,
+                  input: { phase, streamParts: [] },
+                  attributes: {
+                    processorExecutor: "workflow",
+                    processorIndex: processor.processorIndex
+                  }
+                });
+                mutableState[spanKey] = processorSpan2;
+              }
+              if (processorSpan2) {
+                processorSpan2.input = {
+                  phase,
+                  streamParts: streamParts ?? [],
+                  totalChunks: (streamParts ?? []).length
+                };
+              }
+              const processorTracingContext2 = processorSpan2 ? { currentSpan: processorSpan2 } : baseContext.tracingContext;
+              let result;
+              try {
+                result = await processor.processOutputStream({
+                  ...baseContext,
+                  tracingContext: processorTracingContext2,
+                  part,
+                  streamParts: streamParts ?? [],
+                  state: mutableState,
+                  messageList: passThrough.messageList
+                  // Optional for stream processing
+                });
+                if (part && part.type === "finish") {
+                  processorSpan2?.end({ output: result });
+                  delete mutableState[spanKey];
+                }
+              } catch (error) {
+                if (error instanceof agent.TripWire) {
+                  processorSpan2?.end({ output: { tripwire: error.message } });
+                } else {
+                  processorSpan2?.error({ error, endSpan: true });
+                }
+                delete mutableState[spanKey];
+                throw error;
+              }
+              return { ...passThrough, state: mutableState, part: result };
+            }
+            return { ...passThrough, part };
+          }
+          case "outputResult": {
+            if (processor.processOutputResult) {
+              if (!passThrough.messageList) {
+                throw new error.MastraError({
+                  category: error.ErrorCategory.USER,
+                  domain: error.ErrorDomain.MASTRA_WORKFLOW,
+                  id: "PROCESSOR_MISSING_MESSAGE_LIST",
+                  text: `Processor ${processor.id} requires messageList or messages for processOutputResult phase`
+                });
+              }
+              const idsBeforeProcessing = messages.map((m) => m.id);
+              const check = passThrough.messageList.makeMessageSourceChecker();
+              const result = await processor.processOutputResult({
+                ...baseContext,
+                messages,
+                messageList: passThrough.messageList
+              });
+              if (result instanceof agent.MessageList) {
+                if (result !== passThrough.messageList) {
+                  throw new error.MastraError({
+                    category: error.ErrorCategory.USER,
+                    domain: error.ErrorDomain.MASTRA_WORKFLOW,
+                    id: "PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST",
+                    text: `Processor ${processor.id} returned a MessageList instance other than the one passed in. Use the messageList argument instead.`
+                  });
+                }
+                return {
+                  ...passThrough,
+                  messages: result.get.all.db(),
+                  systemMessages: result.getAllSystemMessages()
+                };
+              } else if (Array.isArray(result)) {
+                processors.ProcessorRunner.applyMessagesToMessageList(
+                  result,
+                  passThrough.messageList,
+                  idsBeforeProcessing,
+                  check,
+                  "response"
+                );
+                return { ...passThrough, messages: result };
+              } else if (result && "messages" in result && "systemMessages" in result) {
+                const typedResult = result;
+                processors.ProcessorRunner.applyMessagesToMessageList(
+                  typedResult.messages,
+                  passThrough.messageList,
+                  idsBeforeProcessing,
+                  check,
+                  "response"
+                );
+                passThrough.messageList.replaceAllSystemMessages(typedResult.systemMessages);
+                return {
+                  ...passThrough,
+                  messages: typedResult.messages,
+                  systemMessages: typedResult.systemMessages
+                };
+              }
+              return { ...passThrough, messages };
+            }
+            return { ...passThrough, messages };
+          }
+          case "outputStep": {
+            if (processor.processOutputStep) {
+              if (!passThrough.messageList) {
+                throw new error.MastraError({
+                  category: error.ErrorCategory.USER,
+                  domain: error.ErrorDomain.MASTRA_WORKFLOW,
+                  id: "PROCESSOR_MISSING_MESSAGE_LIST",
+                  text: `Processor ${processor.id} requires messageList or messages for processOutputStep phase`
+                });
+              }
+              const idsBeforeProcessing = messages.map((m) => m.id);
+              const check = passThrough.messageList.makeMessageSourceChecker();
+              const result = await processor.processOutputStep({
+                ...baseContext,
+                messages,
+                messageList: passThrough.messageList,
+                stepNumber: stepNumber ?? 0,
+                finishReason,
+                toolCalls,
+                text,
+                systemMessages: systemMessages ?? [],
+                steps: steps ?? []
+              });
+              if (result instanceof agent.MessageList) {
+                if (result !== passThrough.messageList) {
+                  throw new error.MastraError({
+                    category: error.ErrorCategory.USER,
+                    domain: error.ErrorDomain.MASTRA_WORKFLOW,
+                    id: "PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST",
+                    text: `Processor ${processor.id} returned a MessageList instance other than the one passed in. Use the messageList argument instead.`
+                  });
+                }
+                return {
+                  ...passThrough,
+                  messages: result.get.all.db(),
+                  systemMessages: result.getAllSystemMessages()
+                };
+              } else if (Array.isArray(result)) {
+                processors.ProcessorRunner.applyMessagesToMessageList(
+                  result,
+                  passThrough.messageList,
+                  idsBeforeProcessing,
+                  check,
+                  "response"
+                );
+                return { ...passThrough, messages: result };
+              } else if (result && "messages" in result && "systemMessages" in result) {
+                const typedResult = result;
+                processors.ProcessorRunner.applyMessagesToMessageList(
+                  typedResult.messages,
+                  passThrough.messageList,
+                  idsBeforeProcessing,
+                  check,
+                  "response"
+                );
+                passThrough.messageList.replaceAllSystemMessages(typedResult.systemMessages);
+                return {
+                  ...passThrough,
+                  messages: typedResult.messages,
+                  systemMessages: typedResult.systemMessages
+                };
+              }
+              return { ...passThrough, messages };
+            }
+            return { ...passThrough, messages };
+          }
+          default:
+            return { ...passThrough, messages };
+        }
+      });
+    },
+    component: "PROCESSOR"
   };
 }
 function init(inngest) {
@@ -1498,6 +2249,7 @@ exports.InngestPubSub = InngestPubSub;
 exports.InngestRun = InngestRun;
 exports.InngestWorkflow = InngestWorkflow;
 exports._compatibilityCheck = _compatibilityCheck;
+exports.createServe = createServe;
 exports.createStep = createStep;
 exports.init = init;
 exports.serve = serve;