@mastra/inngest 0.10.6-alpha.2 → 0.11.0

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/inngest@0.10.6-alpha.2 build /home/runner/work/mastra/mastra/workflows/inngest
+> @mastra/inngest@0.11.0-alpha.3 build /home/runner/work/mastra/mastra/workflows/inngest
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.0
 TSC Build start
-TSC ⚡️ Build success in 9138ms
+TSC ⚡️ Build success in 9007ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/workflows/inngest/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/workflows/inngest/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 5865ms
+DTS ⚡️ Build success in 6069ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 31.43 KB
-CJS ⚡️ Build success in 236ms
-ESM dist/index.js 31.23 KB
-ESM ⚡️ Build success in 237ms
+ESM dist/index.js 32.52 KB
+ESM ⚡️ Build success in 218ms
+CJS dist/index.cjs 32.72 KB
+CJS ⚡️ Build success in 287ms

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @mastra/inngest
 
+## 0.11.0
+
+### Minor Changes
+
+- 8a3bfd2: Update peerdeps to latest core
+
+### Patch Changes
+
+- 8e1b6e9: dependencies updates:
+  - Updated dependency [`zod@^3.25.67` ↗︎](https://www.npmjs.com/package/zod/v/3.25.67) (from `^3.25.57`, in `dependencies`)
+- 9d52b17: Fix inngest workflows streaming and add step metadata
+- 4fb0cc2: Type safe variable mapping
+- 502fe05: createRun() -> createRunAsync()
+- 4efcfa0: Added bail() method and more ergonomic suspend function return value
+- Updated dependencies [15e9d26]
+- Updated dependencies [d1baedb]
+- Updated dependencies [d8f2d19]
+- Updated dependencies [4d21bf2]
+- Updated dependencies [07d6d88]
+- Updated dependencies [9d52b17]
+- Updated dependencies [2097952]
+- Updated dependencies [792c4c0]
+- Updated dependencies [5d74aab]
+- Updated dependencies [a8b194f]
+- Updated dependencies [4fb0cc2]
+- Updated dependencies [d2a7a31]
+- Updated dependencies [502fe05]
+- Updated dependencies [144eb0b]
+- Updated dependencies [8ba1b51]
+- Updated dependencies [4efcfa0]
+- Updated dependencies [0e17048]
+  - @mastra/core@0.10.7
+
+## 0.11.0-alpha.3
+
+### Minor Changes
+
+- 8a3bfd2: Update peerdeps to latest core
+
+### Patch Changes
+
+- 502fe05: createRun() -> createRunAsync()
+- 4efcfa0: Added bail() method and more ergonomic suspend function return value
+- Updated dependencies [792c4c0]
+- Updated dependencies [502fe05]
+- Updated dependencies [4efcfa0]
+  - @mastra/core@0.10.7-alpha.3
+
 ## 0.10.6-alpha.2
 
 ### Patch Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -233,6 +233,9 @@ export declare class InngestWorkflow<TEngineType = InngestEngineType, TSteps ext
     createRun(options?: {
         runId?: string;
     }): Run<TEngineType, TSteps, TInput, TOutput>;
+    createRunAsync(options?: {
+        runId?: string;
+    }): Promise<Run<TEngineType, TSteps, TInput, TOutput>>;
     getFunction(): InngestFunction<Omit<InngestFunction.Options<Inngest<ClientOptions>, InngestMiddleware.Stack, InngestFunction.Trigger<string>[] | [{
     cron: string;
     } & Partial<Record<"event" | "if", never>>] | [{

package/dist/_tsup-dts-rollup.d.ts

@@ -233,6 +233,9 @@ export declare class InngestWorkflow<TEngineType = InngestEngineType, TSteps ext
     createRun(options?: {
         runId?: string;
     }): Run<TEngineType, TSteps, TInput, TOutput>;
+    createRunAsync(options?: {
+        runId?: string;
+    }): Promise<Run<TEngineType, TSteps, TInput, TOutput>>;
     getFunction(): InngestFunction<Omit<InngestFunction.Options<Inngest<ClientOptions>, InngestMiddleware.Stack, InngestFunction.Trigger<string>[] | [{
     cron: string;
     } & Partial<Record<"event" | "if", never>>] | [{

package/dist/index.cjs

@@ -279,6 +279,41 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
     this.runs.set(runIdToUse, run);
     return run;
   }
+  async createRunAsync(options) {
+    const runIdToUse = options?.runId || crypto.randomUUID();
+    const run = this.runs.get(runIdToUse) ?? new InngestRun(
+      {
+        workflowId: this.id,
+        runId: runIdToUse,
+        executionEngine: this.executionEngine,
+        executionGraph: this.executionGraph,
+        serializedStepGraph: this.serializedStepGraph,
+        mastra: this.#mastra,
+        retryConfig: this.retryConfig,
+        cleanup: () => this.runs.delete(runIdToUse)
+      },
+      this.inngest
+    );
+    this.runs.set(runIdToUse, run);
+    await this.mastra?.getStorage()?.persistWorkflowSnapshot({
+      workflowName: this.id,
+      runId: runIdToUse,
+      snapshot: {
+        runId: runIdToUse,
+        status: "pending",
+        value: {},
+        context: {},
+        activePaths: [],
+        serializedStepGraph: this.serializedStepGraph,
+        suspendedPaths: {},
+        result: void 0,
+        error: void 0,
+        // @ts-ignore
+        timestamp: Date.now()
+      }
+    });
+    return run;
+  }
   getFunction() {
     if (this.function) {
       return this.function;
@@ -800,6 +835,7 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
     const stepRes = await this.inngestStep.run(`workflow.${executionContext.workflowId}.step.${step.id}`, async () => {
       let execResults;
       let suspended;
+      let bailed;
       try {
         const result = await step.execute({
           runId: executionContext.runId,
@@ -819,6 +855,9 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
             executionContext.suspendedPaths[step.id] = executionContext.executionPath;
             suspended = { payload: suspendPayload };
           },
+          bail: (result2) => {
+            bailed = { payload: result2 };
+          },
           resume: {
             steps: resume?.steps?.slice(1) || [],
             resumePayload: resume?.resumePayload,
@@ -861,6 +900,8 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
           resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
           resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
         };
+      } else if (bailed) {
+        execResults = { status: "bailed", output: bailed.payload, payload: prevOutput, endedAt: Date.now(), startedAt };
       }
       if (execResults.status === "failed") {
         if (executionContext.retryConfig.attempts > 0 && this.inngestAttempts < executionContext.retryConfig.attempts) {
@@ -985,6 +1026,8 @@ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
               // TODO: this function shouldn't have suspend probably?
               suspend: async (_suspendPayload) => {
               },
+              bail: () => {
+              },
               [_constants.EMITTER_SYMBOL]: emitter,
               engine: {
                 step: this.inngestStep

package/dist/index.js

@@ -277,6 +277,41 @@ var InngestWorkflow = class _InngestWorkflow extends Workflow {
     this.runs.set(runIdToUse, run);
     return run;
   }
+  async createRunAsync(options) {
+    const runIdToUse = options?.runId || randomUUID();
+    const run = this.runs.get(runIdToUse) ?? new InngestRun(
+      {
+        workflowId: this.id,
+        runId: runIdToUse,
+        executionEngine: this.executionEngine,
+        executionGraph: this.executionGraph,
+        serializedStepGraph: this.serializedStepGraph,
+        mastra: this.#mastra,
+        retryConfig: this.retryConfig,
+        cleanup: () => this.runs.delete(runIdToUse)
+      },
+      this.inngest
+    );
+    this.runs.set(runIdToUse, run);
+    await this.mastra?.getStorage()?.persistWorkflowSnapshot({
+      workflowName: this.id,
+      runId: runIdToUse,
+      snapshot: {
+        runId: runIdToUse,
+        status: "pending",
+        value: {},
+        context: {},
+        activePaths: [],
+        serializedStepGraph: this.serializedStepGraph,
+        suspendedPaths: {},
+        result: void 0,
+        error: void 0,
+        // @ts-ignore
+        timestamp: Date.now()
+      }
+    });
+    return run;
+  }
   getFunction() {
     if (this.function) {
       return this.function;
@@ -798,6 +833,7 @@ var InngestExecutionEngine = class extends DefaultExecutionEngine {
     const stepRes = await this.inngestStep.run(`workflow.${executionContext.workflowId}.step.${step.id}`, async () => {
       let execResults;
       let suspended;
+      let bailed;
       try {
         const result = await step.execute({
           runId: executionContext.runId,
@@ -817,6 +853,9 @@ var InngestExecutionEngine = class extends DefaultExecutionEngine {
             executionContext.suspendedPaths[step.id] = executionContext.executionPath;
             suspended = { payload: suspendPayload };
           },
+          bail: (result2) => {
+            bailed = { payload: result2 };
+          },
           resume: {
             steps: resume?.steps?.slice(1) || [],
             resumePayload: resume?.resumePayload,
@@ -859,6 +898,8 @@ var InngestExecutionEngine = class extends DefaultExecutionEngine {
           resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
           resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
         };
+      } else if (bailed) {
+        execResults = { status: "bailed", output: bailed.payload, payload: prevOutput, endedAt: Date.now(), startedAt };
       }
       if (execResults.status === "failed") {
         if (executionContext.retryConfig.attempts > 0 && this.inngestAttempts < executionContext.retryConfig.attempts) {
@@ -983,6 +1024,8 @@ var InngestExecutionEngine = class extends DefaultExecutionEngine {
               // TODO: this function shouldn't have suspend probably?
               suspend: async (_suspendPayload) => {
               },
+              bail: () => {
+              },
               [EMITTER_SYMBOL]: emitter,
               engine: {
                 step: this.inngestStep

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/inngest",
-  "version": "0.10.6-alpha.2",
+  "version": "0.11.0",
   "description": "Mastra Inngest integration",
   "type": "module",
   "main": "dist/index.js",
@@ -37,13 +37,13 @@
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "vitest": "^2.1.9",
-    "@mastra/core": "0.10.7-alpha.2",
-    "@internal/lint": "0.0.13",
-    "@mastra/libsql": "0.10.4-alpha.2",
-    "@mastra/deployer": "0.10.7-alpha.2"
+    "@internal/lint": "0.0.14",
+    "@mastra/core": "0.10.7",
+    "@mastra/libsql": "0.11.0",
+    "@mastra/deployer": "0.10.7"
   },
   "peerDependencies": {
-    "@mastra/core": "^0.10.2-alpha.0"
+    "@mastra/core": ">=0.10.7-0 <0.11.0-0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",

package/src/index.test.ts

@@ -44,6 +44,109 @@ describe('MastraInngestWorkflow', () => {
   });
 
   describe.sequential('Basic Workflow Execution', () => {
+    it('should be able to bail workflow execution', async ctx => {
+      const inngest = new Inngest({
+        id: 'mastra',
+        baseUrl: `http://localhost:${(ctx as any).inngestPort}`,
+        middleware: [realtimeMiddleware()],
+      });
+
+      const { createWorkflow, createStep } = init(inngest);
+
+      const step1 = createStep({
+        id: 'step1',
+        execute: async ({ bail, inputData }) => {
+          if (inputData.value === 'bail') {
+            return bail({ result: 'bailed' });
+          }
+
+          return { result: 'step1: ' + inputData.value };
+        },
+        inputSchema: z.object({ value: z.string() }),
+        outputSchema: z.object({ result: z.string() }),
+      });
+      const step2 = createStep({
+        id: 'step2',
+        execute: async ({ inputData }) => {
+          return { result: 'step2: ' + inputData.result };
+        },
+        inputSchema: z.object({ result: z.string() }),
+        outputSchema: z.object({ result: z.string() }),
+      });
+
+      const workflow = createWorkflow({
+        id: 'test-workflow',
+        inputSchema: z.object({ value: z.string() }),
+        outputSchema: z.object({
+          result: z.string(),
+        }),
+        steps: [step1, step2],
+      });
+
+      workflow.then(step1).then(step2).commit();
+
+      const mastra = new Mastra({
+        storage: new DefaultStorage({
+          url: ':memory:',
+        }),
+        workflows: {
+          'test-workflow': workflow,
+        },
+        server: {
+          apiRoutes: [
+            {
+              path: '/inngest/api',
+              method: 'ALL',
+              createHandler: async ({ mastra }) => inngestServe({ mastra, inngest }),
+            },
+          ],
+        },
+      });
+
+      const app = await createHonoServer(mastra);
+
+      const srv = serve({
+        fetch: app.fetch,
+        port: (ctx as any).handlerPort,
+      });
+
+      const run = await workflow.createRunAsync();
+      const result = await run.start({ inputData: { value: 'bail' } });
+
+      await new Promise(resolve => setTimeout(resolve, 2000));
+
+      expect(result.steps['step1']).toEqual({
+        status: 'success',
+        output: { result: 'bailed' },
+        payload: { value: 'bail' },
+        startedAt: expect.any(Number),
+        endedAt: expect.any(Number),
+      });
+
+      expect(result.steps['step2']).toBeUndefined();
+
+      const run2 = await workflow.createRunAsync();
+      const result2 = await run2.start({ inputData: { value: 'no-bail' } });
+
+      srv.close();
+
+      expect(result2.steps['step1']).toEqual({
+        status: 'success',
+        output: { result: 'step1: no-bail' },
+        payload: { value: 'no-bail' },
+        startedAt: expect.any(Number),
+        endedAt: expect.any(Number),
+      });
+
+      expect(result2.steps['step2']).toEqual({
+        status: 'success',
+        output: { result: 'step2: step1: no-bail' },
+        payload: { result: 'step1: no-bail' },
+        startedAt: expect.any(Number),
+        endedAt: expect.any(Number),
+      });
+    });
+
     it('should execute a single step workflow successfully', async ctx => {
       const inngest = new Inngest({
         id: 'mastra',
@@ -95,7 +198,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(execute).toHaveBeenCalled();
@@ -170,7 +273,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(step1Action).toHaveBeenCalled();
@@ -251,7 +354,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(executionOrder).toMatchObject(['step1', 'step2']);
@@ -325,7 +428,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const startTime = Date.now();
       const result = await run.start({ inputData: {} });
       const endTime = Date.now();
@@ -417,7 +520,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const startTime = Date.now();
       const result = await run.start({ inputData: {} });
       const endTime = Date.now();
@@ -507,7 +610,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const startTime = Date.now();
       setTimeout(() => {
         run.sendEvent('hello-event', { data: 'hello' });
@@ -601,7 +704,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const startTime = Date.now();
       const result = await run.start({ inputData: {} });
       const endTime = Date.now();
@@ -686,7 +789,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: { inputData: 'test-input' } });
 
       expect(result.steps.step1).toMatchObject({ status: 'success', output: { result: 'success' } });
@@ -773,7 +876,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: { inputValue: 'test-input' } });
 
       expect(step1Action).toHaveBeenCalled();
@@ -840,7 +943,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       await run.start({ inputData: { inputData: 'test-input' } });
 
       expect(execute).toHaveBeenCalledWith(
@@ -915,7 +1018,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: { cool: 'test-input' } });
 
       expect(execute).toHaveBeenCalledWith(
@@ -997,7 +1100,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       await run.start({ inputData: {} });
 
       expect(step2Action).toHaveBeenCalledWith(
@@ -1100,7 +1203,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: { status: 'success' } });
       srv.close();
 
@@ -1176,7 +1279,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       let result: Awaited<ReturnType<typeof run.start>> | undefined = undefined;
       try {
         result = await run.start({ inputData: {} });
@@ -1281,7 +1384,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: { status: 'success' } });
       srv.close();
 
@@ -1364,7 +1467,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: { count: 5 } });
       srv.close();
 
@@ -1432,7 +1535,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
 
       await expect(run.start({ inputData: {} })).resolves.toMatchObject({
         steps: {
@@ -1516,7 +1619,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(result.steps).toMatchObject({
@@ -1610,7 +1713,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = mainWorkflow.createRun();
+      const run = await mainWorkflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(result.steps).toMatchObject({
@@ -1738,7 +1841,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(step2Action).toHaveBeenCalled();
@@ -1840,7 +1943,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: { target: 10, value: 0 } });
 
       expect(increment).toHaveBeenCalledTimes(12);
@@ -1943,7 +2046,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: { target: 10, value: 0 } });
 
       expect(increment).toHaveBeenCalledTimes(12);
@@ -2032,7 +2135,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: [{ value: 1 }, { value: 22 }, { value: 333 }] });
 
       const endTime = Date.now();
@@ -2185,7 +2288,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: { startValue: 1 } });
 
       expect(start).toHaveBeenCalledTimes(1);
@@ -2334,7 +2437,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: { startValue: 6 } });
 
       expect(start).toHaveBeenCalledTimes(1);
@@ -2400,7 +2503,7 @@ describe('MastraInngestWorkflow', () => {
       ).rejects.toThrow();
 
       // Should pass validation
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       await run.start({
         inputData: {
           required: 'test',
@@ -2506,7 +2609,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(result.steps['nested-a']).toMatchObject({ status: 'success', output: { result: 'success3' } });
@@ -2572,7 +2675,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(result.steps.step1).toMatchObject({ status: 'success', output: { result: 'success' } });
@@ -2629,7 +2732,7 @@ describe('MastraInngestWorkflow', () => {
 
       workflow.then(step1).then(step2).commit();
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ inputData: {} });
 
       expect(result.steps.step1).toMatchObject({ status: 'success', output: { result: 'success' } });
@@ -2704,7 +2807,8 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const result = await workflow.createRun().start({ inputData: {} });
+      const run = await workflow.createRunAsync();
+      const result = await run.start({ inputData: {} });
 
       srv.close();
 
@@ -2775,7 +2879,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
 
       // Start watching the workflow
       let cnt = 0;
@@ -2964,7 +3068,7 @@ describe('MastraInngestWorkflow', () => {
       const onTransition = vi.fn();
       const onTransition2 = vi.fn();
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
 
       run.watch(onTransition);
       run.watch(onTransition2);
@@ -2974,7 +3078,7 @@ describe('MastraInngestWorkflow', () => {
       expect(onTransition).toHaveBeenCalledTimes(5);
       expect(onTransition2).toHaveBeenCalledTimes(5);
 
-      const run2 = workflow.createRun();
+      const run2 = await workflow.createRunAsync();
 
       run2.watch(onTransition2);
 
@@ -2983,7 +3087,7 @@ describe('MastraInngestWorkflow', () => {
       expect(onTransition).toHaveBeenCalledTimes(5);
       expect(onTransition2).toHaveBeenCalledTimes(10);
 
-      const run3 = workflow.createRun();
+      const run3 = await workflow.createRunAsync();
 
       run3.watch(onTransition);
 
@@ -3018,8 +3122,8 @@ describe('MastraInngestWorkflow', () => {
         outputSchema: z.object({}),
         steps: [],
       });
-      const run = workflow.createRun();
-      const run2 = workflow.createRun({ runId: run.runId });
+      const run = await workflow.createRunAsync();
+      const run2 = await workflow.createRunAsync({ runId: run.runId });
 
       expect(run.runId).toBeDefined();
       expect(run2.runId).toBeDefined();
@@ -3133,7 +3237,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = promptEvalWorkflow.createRun();
+      const run = await promptEvalWorkflow.createRunAsync();
 
       // Create a promise to track when the workflow is ready to resume
       let resolveWorkflowSuspended: (value: unknown) => void;
@@ -3283,7 +3387,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
 
       const started = run.start({ inputData: { input: 'test' } });
 
@@ -3485,7 +3589,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const started = run.start({ inputData: { input: 'test' } });
       let improvedResponseResultPromise: Promise<any | undefined>;
 
@@ -3679,7 +3783,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = promptEvalWorkflow.createRun();
+      const run = await promptEvalWorkflow.createRunAsync();
 
       const initialResult = await run.start({ inputData: { input: 'test' } });
       expect(initialResult.steps.promptAgent.status).toBe('suspended');
@@ -3690,7 +3794,11 @@ describe('MastraInngestWorkflow', () => {
       expect(initialResult.steps).toMatchObject({
         input: { input: 'test' },
         getUserInput: { status: 'success', output: { userInput: 'test input' } },
-        promptAgent: { status: 'suspended', payload: { testPayload: 'hello' } },
+        promptAgent: {
+          status: 'suspended',
+          suspendedPayload: { testPayload: 'hello' },
+          payload: { userInput: 'test input' },
+        },
       });
 
       const newCtx = {
@@ -3804,7 +3912,7 @@ describe('MastraInngestWorkflow', () => {
       await new Promise(resolve => setTimeout(resolve, 2000));
 
       // Access new instance properties directly - should work without warning
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       await run.start({ inputData: {} });
 
       expect(telemetry).toBeDefined();
@@ -3907,7 +4015,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({
         inputData: { prompt1: 'Capital of France, just the name', prompt2: 'Capital of UK, just the name' },
       });
@@ -4044,7 +4152,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({
         inputData: { prompt1: 'Capital of France, just the name', prompt2: 'Capital of UK, just the name' },
       });
@@ -4187,7 +4295,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: { startValue: 0 } });
 
       srv.close();
@@ -4339,7 +4447,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: { startValue: 0 } });
 
       srv.close();
@@ -4498,7 +4606,7 @@ describe('MastraInngestWorkflow', () => {
           port: (ctx as any).handlerPort,
         });
 
-        const run = counterWorkflow.createRun();
+        const run = await counterWorkflow.createRunAsync();
         const result = await run.start({ inputData: { startValue: 0 } });
 
         srv.close();
@@ -4657,7 +4765,7 @@ describe('MastraInngestWorkflow', () => {
           port: (ctx as any).handlerPort,
         });
 
-        const run = counterWorkflow.createRun();
+        const run = await counterWorkflow.createRunAsync();
         const result = await run.start({ inputData: { startValue: 0 } });
 
         srv.close();
@@ -4854,7 +4962,7 @@ describe('MastraInngestWorkflow', () => {
           port: (ctx as any).handlerPort,
         });
 
-        const run = counterWorkflow.createRun();
+        const run = await counterWorkflow.createRunAsync();
         const result = await run.start({ inputData: { startValue: 1 } });
 
         srv.close();
@@ -5008,7 +5116,7 @@ describe('MastraInngestWorkflow', () => {
         });
         await new Promise(resolve => setTimeout(resolve, 2000));
 
-        const run = counterWorkflow.createRun();
+        const run = await counterWorkflow.createRunAsync();
         const result = await run.start({ inputData: { startValue: 0 } });
 
         expect(begin).toHaveBeenCalledTimes(1);
@@ -5158,7 +5266,7 @@ describe('MastraInngestWorkflow', () => {
           port: (ctx as any).handlerPort,
         });
 
-        const run = counterWorkflow.createRun();
+        const run = await counterWorkflow.createRunAsync();
         const result = await run.start({ inputData: { startValue: 0 } });
         const results = result.steps;
 
@@ -5340,7 +5448,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: { startValue: 0 } });
 
       expect(passthroughStep.execute).toHaveBeenCalledTimes(2);
@@ -5502,7 +5610,7 @@ describe('MastraInngestWorkflow', () => {
       });
       await new Promise(resolve => setTimeout(resolve, 2000));
 
-      const run = counterWorkflow.createRun();
+      const run = await counterWorkflow.createRunAsync();
       const result = await run.start({ inputData: { startValue: 0 } });
 
       srv.close();
@@ -5578,7 +5686,7 @@ describe('MastraInngestWorkflow', () => {
       await new Promise(resolve => setTimeout(resolve, 2000));
 
       // Access new instance properties directly - should work without warning
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       await run.start({ inputData: {} });
 
       srv.close();
@@ -5639,7 +5747,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({ runtimeContext });
 
       srv.close();
@@ -5692,7 +5800,7 @@ describe('MastraInngestWorkflow', () => {
       });
       workflow.then(step).commit();
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       await run.start({ runtimeContext });
 
       const resumeruntimeContext = new RuntimeContext();
@@ -5764,7 +5872,7 @@ describe('MastraInngestWorkflow', () => {
         port: (ctx as any).handlerPort,
       });
 
-      const run = workflow.createRun();
+      const run = await workflow.createRunAsync();
       const result = await run.start({});
 
       srv.close();
@@ -5835,7 +5943,7 @@ describe('MastraInngestWorkflow', () => {
 
       const runId = 'test-run-id';
       let watchData: StreamEvent[] = [];
-      const run = workflow.createRun({
+      const run = await workflow.createRunAsync({
         runId,
       });
 
@@ -5998,7 +6106,7 @@ describe('MastraInngestWorkflow', () => {
 
       const runId = 'test-run-id';
       let watchData: StreamEvent[] = [];
-      const run = workflow.createRun({
+      const run = await workflow.createRunAsync({
         runId,
       });
 
@@ -6163,7 +6271,7 @@ describe('MastraInngestWorkflow', () => {
 
       const runId = 'test-run-id';
       let watchData: StreamEvent[] = [];
-      const run = workflow.createRun({
+      const run = await workflow.createRunAsync({
         runId,
       });
 
@@ -6388,7 +6496,7 @@ describe('MastraInngestWorkflow', () => {
 
       await new Promise(resolve => setTimeout(resolve, 1000));
 
-      const run = promptEvalWorkflow.createRun();
+      const run = await promptEvalWorkflow.createRunAsync();
 
       const { stream, getWorkflowState } = run.stream({ inputData: { input: 'test' } });
 
@@ -6577,10 +6685,10 @@ describe('MastraInngestWorkflow', () => {
 
       await new Promise(resolve => setTimeout(resolve, 1000));
 
-      const run = workflow.createRun({
+      const run = await workflow.createRunAsync({
         runId: 'test-run-id',
       });
-      const { stream } = await run.stream({
+      const { stream } = run.stream({
         inputData: {
           prompt1: 'Capital of France, just the name',
           prompt2: 'Capital of UK, just the name',

package/src/index.ts

@@ -410,6 +410,49 @@ export class InngestWorkflow<
     return run;
   }
 
+  async createRunAsync(options?: { runId?: string }): Promise<Run<TEngineType, TSteps, TInput, TOutput>> {
+    const runIdToUse = options?.runId || randomUUID();
+
+    // Return a new Run instance with object parameters
+    const run: Run<TEngineType, TSteps, TInput, TOutput> =
+      this.runs.get(runIdToUse) ??
+      new InngestRun(
+        {
+          workflowId: this.id,
+          runId: runIdToUse,
+          executionEngine: this.executionEngine,
+          executionGraph: this.executionGraph,
+          serializedStepGraph: this.serializedStepGraph,
+          mastra: this.#mastra,
+          retryConfig: this.retryConfig,
+          cleanup: () => this.runs.delete(runIdToUse),
+        },
+        this.inngest,
+      );
+
+    this.runs.set(runIdToUse, run);
+
+    await this.mastra?.getStorage()?.persistWorkflowSnapshot({
+      workflowName: this.id,
+      runId: runIdToUse,
+      snapshot: {
+        runId: runIdToUse,
+        status: 'pending',
+        value: {},
+        context: {},
+        activePaths: [],
+        serializedStepGraph: this.serializedStepGraph,
+        suspendedPaths: {},
+        result: undefined,
+        error: undefined,
+        // @ts-ignore
+        timestamp: Date.now(),
+      },
+    });
+
+    return run;
+  }
+
   getFunction() {
     if (this.function) {
       return this.function;
@@ -1163,6 +1206,7 @@ export class InngestExecutionEngine extends DefaultExecutionEngine {
     const stepRes = await this.inngestStep.run(`workflow.${executionContext.workflowId}.step.${step.id}`, async () => {
       let execResults: any;
       let suspended: { payload: any } | undefined;
+      let bailed: { payload: any } | undefined;
 
       try {
         const result = await step.execute({
@@ -1184,6 +1228,9 @@ export class InngestExecutionEngine extends DefaultExecutionEngine {
             executionContext.suspendedPaths[step.id] = executionContext.executionPath;
             suspended = { payload: suspendPayload };
           },
+          bail: (result: any) => {
+            bailed = { payload: result };
+          },
           resume: {
             steps: resume?.steps?.slice(1) || [],
             resumePayload: resume?.resumePayload,
@@ -1228,6 +1275,8 @@ export class InngestExecutionEngine extends DefaultExecutionEngine {
           resumedAt: resume?.steps[0] === step.id ? startedAt : undefined,
           resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : undefined,
         };
+      } else if (bailed) {
+        execResults = { status: 'bailed', output: bailed.payload, payload: prevOutput, endedAt: Date.now(), startedAt };
       }
 
       if (execResults.status === 'failed') {
@@ -1397,6 +1446,7 @@ export class InngestExecutionEngine extends DefaultExecutionEngine {
 
                 // TODO: this function shouldn't have suspend probably?
                 suspend: async (_suspendPayload: any) => {},
+                bail: () => {},
                 [EMITTER_SYMBOL]: emitter,
                 engine: {
                   step: this.inngestStep,