@mastra/inngest 0.0.0-unified-sidebar-20251010130811 → 0.0.0-unified-workspace-snapshot-20260128233410

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -1,435 +1,1504 @@
1
1
  'use strict';
2
2
 
3
- var crypto = require('crypto');
4
- var realtime = require('@inngest/realtime');
5
- var aiTracing = require('@mastra/core/ai-tracing');
6
- var di = require('@mastra/core/di');
3
+ var agent = require('@mastra/core/agent');
4
+ var error = require('@mastra/core/error');
5
+ var observability = require('@mastra/core/observability');
6
+ var processors = require('@mastra/core/processors');
7
7
  var tools = require('@mastra/core/tools');
8
8
  var workflows = require('@mastra/core/workflows');
9
9
  var _constants = require('@mastra/core/workflows/_constants');
10
+ var zod = require('zod');
11
+ var crypto$1 = require('crypto');
12
+ var di = require('@mastra/core/di');
10
13
  var inngest = require('inngest');
14
+ var realtime = require('@inngest/realtime');
15
+ var events = require('@mastra/core/events');
16
+ var web = require('stream/web');
17
+ var stream = require('@mastra/core/stream');
11
18
  var hono = require('inngest/hono');
12
- var zod = require('zod');
13
19
 
14
20
  // src/index.ts
15
- function serve({
16
- mastra,
17
- inngest,
18
- functions: userFunctions = [],
19
- registerOptions
20
- }) {
21
- const wfs = mastra.getWorkflows();
22
- const workflowFunctions = Array.from(
23
- new Set(
24
- Object.values(wfs).flatMap((wf) => {
25
- if (wf instanceof InngestWorkflow) {
26
- wf.__registerMastra(mastra);
27
- return wf.getFunctions();
28
- }
29
- return [];
30
- })
31
- )
32
- );
33
- return hono.serve({
34
- ...registerOptions,
35
- client: inngest,
36
- functions: [...workflowFunctions, ...userFunctions]
37
- });
38
- }
39
- var InngestRun = class extends workflows.Run {
40
- inngest;
41
- serializedStepGraph;
42
- #mastra;
43
- constructor(params, inngest) {
44
- super(params);
45
- this.inngest = inngest;
46
- this.serializedStepGraph = params.serializedStepGraph;
47
- this.#mastra = params.mastra;
21
+ var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
22
+ inngestStep;
23
+ inngestAttempts;
24
+ constructor(mastra, inngestStep, inngestAttempts = 0, options) {
25
+ super({ mastra, options });
26
+ this.inngestStep = inngestStep;
27
+ this.inngestAttempts = inngestAttempts;
48
28
  }
49
- async getRuns(eventId) {
50
- const response = await fetch(`${this.inngest.apiBaseUrl ?? "https://api.inngest.com"}/v1/events/${eventId}/runs`, {
51
- headers: {
52
- Authorization: `Bearer ${process.env.INNGEST_SIGNING_KEY}`
53
- }
29
+ // =============================================================================
30
+ // Hook Overrides
31
+ // =============================================================================
32
+ /**
33
+ * Format errors while preserving Error instances and their custom properties.
34
+ * Uses getErrorFromUnknown to ensure all error properties are preserved.
35
+ */
36
+ formatResultError(error$1, lastOutput) {
37
+ const outputError = lastOutput?.error;
38
+ const errorSource = error$1 || outputError;
39
+ const errorInstance = error.getErrorFromUnknown(errorSource, {
40
+ serializeStack: true,
41
+ // Include stack in JSON for better debugging in Inngest
42
+ fallbackMessage: "Unknown workflow error"
54
43
  });
55
- const json = await response.json();
56
- return json.data;
44
+ return errorInstance.toJSON();
57
45
  }
58
- async getRunOutput(eventId) {
59
- let runs = await this.getRuns(eventId);
60
- while (runs?.[0]?.status !== "Completed" || runs?.[0]?.event_id !== eventId) {
61
- await new Promise((resolve) => setTimeout(resolve, 1e3));
62
- runs = await this.getRuns(eventId);
63
- if (runs?.[0]?.status === "Failed") {
64
- const snapshot = await this.#mastra?.storage?.loadWorkflowSnapshot({
65
- workflowName: this.workflowId,
66
- runId: this.runId
67
- });
68
- return {
69
- output: { result: { steps: snapshot?.context, status: "failed", error: runs?.[0]?.output?.message } }
70
- };
46
+ /**
47
+ * Detect InngestWorkflow instances for special nested workflow handling
48
+ */
49
+ isNestedWorkflowStep(step) {
50
+ return step instanceof InngestWorkflow;
51
+ }
52
+ /**
53
+ * Inngest requires requestContext serialization for memoization.
54
+ * When steps are replayed, the original function doesn't re-execute,
55
+ * so requestContext modifications must be captured and restored.
56
+ */
57
+ requiresDurableContextSerialization() {
58
+ return true;
59
+ }
60
+ /**
61
+ * Execute a step with retry logic for Inngest.
62
+ * Retries are handled via step-level retry (RetryAfterError thrown INSIDE step.run()).
63
+ * After retries exhausted, error propagates here and we return a failed result.
64
+ */
65
+ async executeStepWithRetry(stepId, runStep, params) {
66
+ for (let i = 0; i < params.retries + 1; i++) {
67
+ if (i > 0 && params.delay) {
68
+ await new Promise((resolve) => setTimeout(resolve, params.delay));
71
69
  }
72
- if (runs?.[0]?.status === "Cancelled") {
73
- const snapshot = await this.#mastra?.storage?.loadWorkflowSnapshot({
74
- workflowName: this.workflowId,
75
- runId: this.runId
76
- });
77
- return { output: { result: { steps: snapshot?.context, status: "canceled" } } };
70
+ try {
71
+ const result = await this.wrapDurableOperation(stepId, runStep);
72
+ return { ok: true, result };
73
+ } catch (e) {
74
+ if (i === params.retries) {
75
+ const cause = e?.cause;
76
+ if (cause?.status === "failed") {
77
+ params.stepSpan?.error({
78
+ error: e,
79
+ attributes: { status: "failed" }
80
+ });
81
+ if (cause.error && !(cause.error instanceof Error)) {
82
+ cause.error = error.getErrorFromUnknown(cause.error, { serializeStack: false });
83
+ }
84
+ return { ok: false, error: cause };
85
+ }
86
+ const errorInstance = error.getErrorFromUnknown(e, {
87
+ serializeStack: false,
88
+ fallbackMessage: "Unknown step execution error"
89
+ });
90
+ params.stepSpan?.error({
91
+ error: errorInstance,
92
+ attributes: { status: "failed" }
93
+ });
94
+ return {
95
+ ok: false,
96
+ error: {
97
+ status: "failed",
98
+ error: errorInstance,
99
+ endedAt: Date.now()
100
+ }
101
+ };
102
+ }
78
103
  }
79
104
  }
80
- return runs?.[0];
105
+ return { ok: false, error: { status: "failed", error: new Error("Unknown error"), endedAt: Date.now() } };
81
106
  }
82
- async sendEvent(event, data) {
83
- await this.inngest.send({
84
- name: `user-event-${event}`,
85
- data
86
- });
107
+ /**
108
+ * Use Inngest's sleep primitive for durability
109
+ */
110
+ async executeSleepDuration(duration, sleepId, workflowId) {
111
+ await this.inngestStep.sleep(`workflow.${workflowId}.sleep.${sleepId}`, duration < 0 ? 0 : duration);
87
112
  }
88
- async cancel() {
89
- await this.inngest.send({
90
- name: `cancel.workflow.${this.workflowId}`,
91
- data: {
92
- runId: this.runId
113
+ /**
114
+ * Use Inngest's sleepUntil primitive for durability
115
+ */
116
+ async executeSleepUntilDate(date, sleepUntilId, workflowId) {
117
+ await this.inngestStep.sleepUntil(`workflow.${workflowId}.sleepUntil.${sleepUntilId}`, date);
118
+ }
119
+ /**
120
+ * Wrap durable operations in Inngest step.run() for durability.
121
+ *
122
+ * IMPORTANT: Errors are wrapped with a cause structure before throwing.
123
+ * This is necessary because Inngest's error serialization (serialize-error-cjs)
124
+ * only captures standard Error properties (message, name, stack, code, cause).
125
+ * Custom properties like statusCode, responseHeaders from AI SDK errors would
126
+ * be lost. By putting our serialized error (via getErrorFromUnknown with toJSON())
127
+ * in the cause property, we ensure custom properties survive serialization.
128
+ * The cause property is in serialize-error-cjs's allowlist, and when the cause
129
+ * object is finally JSON.stringify'd, our error's toJSON() is called.
130
+ */
131
+ async wrapDurableOperation(operationId, operationFn) {
132
+ return this.inngestStep.run(operationId, async () => {
133
+ try {
134
+ return await operationFn();
135
+ } catch (e) {
136
+ const errorInstance = error.getErrorFromUnknown(e, {
137
+ serializeStack: false,
138
+ fallbackMessage: "Unknown step execution error"
139
+ });
140
+ throw new Error(errorInstance.message, {
141
+ cause: {
142
+ status: "failed",
143
+ error: errorInstance,
144
+ endedAt: Date.now()
145
+ }
146
+ });
93
147
  }
94
148
  });
95
- const snapshot = await this.#mastra?.storage?.loadWorkflowSnapshot({
96
- workflowName: this.workflowId,
97
- runId: this.runId
98
- });
99
- if (snapshot) {
100
- await this.#mastra?.storage?.persistWorkflowSnapshot({
101
- workflowName: this.workflowId,
102
- runId: this.runId,
103
- resourceId: this.resourceId,
104
- snapshot: {
105
- ...snapshot,
106
- status: "canceled"
107
- }
149
+ }
150
+ /**
151
+ * Provide Inngest step primitive in engine context
152
+ */
153
+ getEngineContext() {
154
+ return { step: this.inngestStep };
155
+ }
156
+ /**
157
+ * For Inngest, lifecycle callbacks are invoked in the workflow's finalize step
158
+ * (wrapped in step.run for durability), not in execute(). Override to skip.
159
+ */
160
+ async invokeLifecycleCallbacks(_result) {
161
+ }
162
+ /**
163
+ * Actually invoke the lifecycle callbacks. Called from workflow.ts finalize step.
164
+ */
165
+ async invokeLifecycleCallbacksInternal(result) {
166
+ return super.invokeLifecycleCallbacks(result);
167
+ }
168
+ // =============================================================================
169
+ // Durable Span Lifecycle Hooks
170
+ // =============================================================================
171
+ /**
172
+ * Create a step span durably - on first execution, creates and exports span.
173
+ * On replay, returns cached span data without re-creating.
174
+ */
175
+ async createStepSpan(params) {
176
+ const { executionContext, operationId, options, parentSpan } = params;
177
+ const parentSpanId = parentSpan?.id ?? executionContext.tracingIds?.workflowSpanId;
178
+ const exportedSpan = await this.wrapDurableOperation(operationId, async () => {
179
+ const observability = this.mastra?.observability?.getSelectedInstance({});
180
+ if (!observability) return void 0;
181
+ const span = observability.startSpan({
182
+ ...options,
183
+ entityType: options.entityType,
184
+ traceId: executionContext.tracingIds?.traceId,
185
+ parentSpanId
108
186
  });
187
+ return span?.exportSpan();
188
+ });
189
+ if (exportedSpan) {
190
+ const observability = this.mastra?.observability?.getSelectedInstance({});
191
+ return observability?.rebuildSpan(exportedSpan);
109
192
  }
193
+ return void 0;
110
194
  }
111
- async start({
112
- inputData,
113
- initialState
114
- }) {
115
- await this.#mastra.getStorage()?.persistWorkflowSnapshot({
116
- workflowName: this.workflowId,
117
- runId: this.runId,
118
- resourceId: this.resourceId,
119
- snapshot: {
120
- runId: this.runId,
121
- serializedStepGraph: this.serializedStepGraph,
122
- value: {},
123
- context: {},
124
- activePaths: [],
125
- suspendedPaths: {},
126
- waitingPaths: {},
127
- timestamp: Date.now(),
128
- status: "running"
129
- }
195
+ /**
196
+ * End a step span durably.
197
+ */
198
+ async endStepSpan(params) {
199
+ const { span, operationId, endOptions } = params;
200
+ if (!span) return;
201
+ await this.wrapDurableOperation(operationId, async () => {
202
+ span.end(endOptions);
130
203
  });
131
- const inputDataToUse = await this._validateInput(inputData);
132
- const initialStateToUse = await this._validateInitialState(initialState ?? {});
133
- const eventOutput = await this.inngest.send({
134
- name: `workflow.${this.workflowId}`,
135
- data: {
136
- inputData: inputDataToUse,
137
- initialState: initialStateToUse,
138
- runId: this.runId,
139
- resourceId: this.resourceId
140
- }
204
+ }
205
+ /**
206
+ * Record error on step span durably.
207
+ */
208
+ async errorStepSpan(params) {
209
+ const { span, operationId, errorOptions } = params;
210
+ if (!span) return;
211
+ await this.wrapDurableOperation(operationId, async () => {
212
+ span.error(errorOptions);
141
213
  });
142
- const eventId = eventOutput.ids[0];
143
- if (!eventId) {
144
- throw new Error("Event ID is not set");
145
- }
146
- const runOutput = await this.getRunOutput(eventId);
147
- const result = runOutput?.output?.result;
148
- if (result.status === "failed") {
149
- result.error = new Error(result.error);
150
- }
151
- if (result.status !== "suspended") {
152
- this.cleanup?.();
153
- }
154
- return result;
155
214
  }
156
- async resume(params) {
157
- const p = this._resume(params).then((result) => {
158
- if (result.status !== "suspended") {
159
- this.closeStreamAction?.().catch(() => {
160
- });
161
- }
162
- return result;
215
+ /**
216
+ * Create a generic child span durably (for control-flow operations).
217
+ * On first execution, creates and exports span. On replay, returns cached span data.
218
+ */
219
+ async createChildSpan(params) {
220
+ const { executionContext, operationId, options, parentSpan } = params;
221
+ const parentSpanId = parentSpan?.id ?? executionContext.tracingIds?.workflowSpanId;
222
+ const exportedSpan = await this.wrapDurableOperation(operationId, async () => {
223
+ const observability = this.mastra?.observability?.getSelectedInstance({});
224
+ if (!observability) return void 0;
225
+ const span = observability.startSpan({
226
+ ...options,
227
+ traceId: executionContext.tracingIds?.traceId,
228
+ parentSpanId
229
+ });
230
+ return span?.exportSpan();
163
231
  });
164
- this.executionResults = p;
165
- return p;
232
+ if (exportedSpan) {
233
+ const observability = this.mastra?.observability?.getSelectedInstance({});
234
+ return observability?.rebuildSpan(exportedSpan);
235
+ }
236
+ return void 0;
166
237
  }
167
- async _resume(params) {
168
- const steps = (Array.isArray(params.step) ? params.step : [params.step]).map(
169
- (step) => typeof step === "string" ? step : step?.id
170
- );
171
- const snapshot = await this.#mastra?.storage?.loadWorkflowSnapshot({
172
- workflowName: this.workflowId,
173
- runId: this.runId
238
+ /**
239
+ * End a generic child span durably (for control-flow operations).
240
+ */
241
+ async endChildSpan(params) {
242
+ const { span, operationId, endOptions } = params;
243
+ if (!span) return;
244
+ await this.wrapDurableOperation(operationId, async () => {
245
+ span.end(endOptions);
174
246
  });
175
- const suspendedStep = this.workflowSteps[steps?.[0] ?? ""];
176
- const resumeDataToUse = await this._validateResumeData(params.resumeData, suspendedStep);
177
- const eventOutput = await this.inngest.send({
178
- name: `workflow.${this.workflowId}`,
179
- data: {
180
- inputData: resumeDataToUse,
181
- initialState: snapshot?.value ?? {},
182
- runId: this.runId,
183
- workflowId: this.workflowId,
184
- stepResults: snapshot?.context,
185
- resume: {
186
- steps,
187
- stepResults: snapshot?.context,
188
- resumePayload: resumeDataToUse,
189
- // @ts-ignore
190
- resumePath: snapshot?.suspendedPaths?.[steps?.[0]]
191
- }
192
- }
247
+ }
248
+ /**
249
+ * Record error on a generic child span durably (for control-flow operations).
250
+ */
251
+ async errorChildSpan(params) {
252
+ const { span, operationId, errorOptions } = params;
253
+ if (!span) return;
254
+ await this.wrapDurableOperation(operationId, async () => {
255
+ span.error(errorOptions);
193
256
  });
194
- const eventId = eventOutput.ids[0];
195
- if (!eventId) {
196
- throw new Error("Event ID is not set");
197
- }
198
- const runOutput = await this.getRunOutput(eventId);
199
- const result = runOutput?.output?.result;
200
- if (result.status === "failed") {
201
- result.error = new Error(result.error);
202
- }
203
- return result;
204
257
  }
205
- watch(cb, type = "watch") {
206
- let active = true;
207
- const streamPromise = realtime.subscribe(
208
- {
209
- channel: `workflow:${this.workflowId}:${this.runId}`,
210
- topics: [type],
211
- app: this.inngest
212
- },
213
- (message) => {
214
- if (active) {
215
- cb(message.data);
216
- }
258
+ /**
259
+ * Execute nested InngestWorkflow using inngestStep.invoke() for durability.
260
+ * This MUST be called directly (not inside step.run()) due to Inngest constraints.
261
+ */
262
+ async executeWorkflowStep(params) {
263
+ if (!(params.step instanceof InngestWorkflow)) {
264
+ return null;
265
+ }
266
+ const {
267
+ step,
268
+ stepResults,
269
+ executionContext,
270
+ resume,
271
+ timeTravel,
272
+ prevOutput,
273
+ inputData,
274
+ pubsub,
275
+ startedAt,
276
+ perStep,
277
+ stepSpan
278
+ } = params;
279
+ const nestedTracingContext = executionContext.tracingIds?.traceId ? {
280
+ traceId: executionContext.tracingIds.traceId,
281
+ parentSpanId: stepSpan?.id
282
+ } : void 0;
283
+ const isResume = !!resume?.steps?.length;
284
+ let result;
285
+ let runId;
286
+ const isTimeTravel = !!(timeTravel && timeTravel.steps?.length > 1 && timeTravel.steps[0] === step.id);
287
+ try {
288
+ if (isResume) {
289
+ runId = stepResults[resume?.steps?.[0] ?? ""]?.suspendPayload?.__workflow_meta?.runId ?? crypto$1.randomUUID();
290
+ const workflowsStore = await this.mastra?.getStorage()?.getStore("workflows");
291
+ const snapshot = await workflowsStore?.loadWorkflowSnapshot({
292
+ workflowName: step.id,
293
+ runId
294
+ });
295
+ const invokeResp = await this.inngestStep.invoke(`workflow.${executionContext.workflowId}.step.${step.id}`, {
296
+ function: step.getFunction(),
297
+ data: {
298
+ inputData,
299
+ initialState: executionContext.state ?? snapshot?.value ?? {},
300
+ runId,
301
+ resume: {
302
+ runId,
303
+ steps: resume.steps.slice(1),
304
+ stepResults: snapshot?.context,
305
+ resumePayload: resume.resumePayload,
306
+ resumePath: resume.steps?.[1] ? snapshot?.suspendedPaths?.[resume.steps?.[1]] : void 0
307
+ },
308
+ outputOptions: { includeState: true },
309
+ perStep,
310
+ tracingOptions: nestedTracingContext
311
+ }
312
+ });
313
+ result = invokeResp.result;
314
+ runId = invokeResp.runId;
315
+ executionContext.state = invokeResp.result.state;
316
+ } else if (isTimeTravel) {
317
+ const workflowsStoreForTimeTravel = await this.mastra?.getStorage()?.getStore("workflows");
318
+ const snapshot = await workflowsStoreForTimeTravel?.loadWorkflowSnapshot({
319
+ workflowName: step.id,
320
+ runId: executionContext.runId
321
+ }) ?? { context: {} };
322
+ const timeTravelParams = workflows.createTimeTravelExecutionParams({
323
+ steps: timeTravel.steps.slice(1),
324
+ inputData: timeTravel.inputData,
325
+ resumeData: timeTravel.resumeData,
326
+ context: timeTravel.nestedStepResults?.[step.id] ?? {},
327
+ nestedStepsContext: timeTravel.nestedStepResults ?? {},
328
+ snapshot,
329
+ graph: step.buildExecutionGraph()
330
+ });
331
+ const invokeResp = await this.inngestStep.invoke(`workflow.${executionContext.workflowId}.step.${step.id}`, {
332
+ function: step.getFunction(),
333
+ data: {
334
+ timeTravel: timeTravelParams,
335
+ initialState: executionContext.state ?? {},
336
+ runId: executionContext.runId,
337
+ outputOptions: { includeState: true },
338
+ perStep,
339
+ tracingOptions: nestedTracingContext
340
+ }
341
+ });
342
+ result = invokeResp.result;
343
+ runId = invokeResp.runId;
344
+ executionContext.state = invokeResp.result.state;
345
+ } else {
346
+ const invokeResp = await this.inngestStep.invoke(`workflow.${executionContext.workflowId}.step.${step.id}`, {
347
+ function: step.getFunction(),
348
+ data: {
349
+ inputData,
350
+ initialState: executionContext.state ?? {},
351
+ outputOptions: { includeState: true },
352
+ perStep,
353
+ tracingOptions: nestedTracingContext
354
+ }
355
+ });
356
+ result = invokeResp.result;
357
+ runId = invokeResp.runId;
358
+ executionContext.state = invokeResp.result.state;
217
359
  }
218
- );
219
- return () => {
220
- active = false;
221
- streamPromise.then(async (stream) => {
222
- return stream.cancel();
223
- }).catch((err) => {
224
- console.error(err);
225
- });
226
- };
227
- }
228
- stream({ inputData, runtimeContext } = {}) {
229
- const { readable, writable } = new TransformStream();
230
- const writer = writable.getWriter();
231
- const unwatch = this.watch(async (event) => {
232
- try {
233
- const e = {
234
- ...event,
235
- type: event.type.replace("workflow-", "")
360
+ } catch (e) {
361
+ const errorCause = e?.cause;
362
+ if (errorCause && typeof errorCause === "object") {
363
+ result = errorCause;
364
+ runId = errorCause.runId || crypto$1.randomUUID();
365
+ } else {
366
+ runId = crypto$1.randomUUID();
367
+ result = {
368
+ status: "failed",
369
+ error: e instanceof Error ? e : new Error(String(e)),
370
+ steps: {},
371
+ input: inputData
236
372
  };
237
- await writer.write(e);
238
- } catch {
239
373
  }
240
- }, "watch-v2");
241
- this.closeStreamAction = async () => {
242
- unwatch();
243
- try {
244
- await writer.close();
245
- } catch (err) {
246
- console.error("Error closing stream:", err);
247
- } finally {
248
- writer.releaseLock();
249
- }
250
- };
251
- this.executionResults = this.start({ inputData, runtimeContext }).then((result) => {
252
- if (result.status !== "suspended") {
253
- this.closeStreamAction?.().catch(() => {
374
+ }
375
+ const res = await this.inngestStep.run(
376
+ `workflow.${executionContext.workflowId}.step.${step.id}.nestedwf-results`,
377
+ async () => {
378
+ if (result.status === "failed") {
379
+ await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
380
+ type: "watch",
381
+ runId: executionContext.runId,
382
+ data: {
383
+ type: "workflow-step-result",
384
+ payload: {
385
+ id: step.id,
386
+ status: "failed",
387
+ error: result?.error,
388
+ payload: prevOutput
389
+ }
390
+ }
391
+ });
392
+ return { executionContext, result: { status: "failed", error: result?.error, endedAt: Date.now() } };
393
+ } else if (result.status === "suspended") {
394
+ const suspendedSteps = Object.entries(result.steps).filter(([_stepName, stepResult]) => {
395
+ const stepRes = stepResult;
396
+ return stepRes?.status === "suspended";
397
+ });
398
+ for (const [stepName, stepResult] of suspendedSteps) {
399
+ const suspendPath = [stepName, ...stepResult?.suspendPayload?.__workflow_meta?.path ?? []];
400
+ executionContext.suspendedPaths[step.id] = executionContext.executionPath;
401
+ await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
402
+ type: "watch",
403
+ runId: executionContext.runId,
404
+ data: {
405
+ type: "workflow-step-suspended",
406
+ payload: {
407
+ id: step.id,
408
+ status: "suspended"
409
+ }
410
+ }
411
+ });
412
+ return {
413
+ executionContext,
414
+ result: {
415
+ status: "suspended",
416
+ suspendedAt: Date.now(),
417
+ payload: stepResult.payload,
418
+ suspendPayload: {
419
+ ...stepResult?.suspendPayload,
420
+ __workflow_meta: { runId, path: suspendPath }
421
+ }
422
+ }
423
+ };
424
+ }
425
+ return {
426
+ executionContext,
427
+ result: {
428
+ status: "suspended",
429
+ suspendedAt: Date.now(),
430
+ payload: {}
431
+ }
432
+ };
433
+ } else if (result.status === "tripwire") {
434
+ await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
435
+ type: "watch",
436
+ runId: executionContext.runId,
437
+ data: {
438
+ type: "workflow-step-result",
439
+ payload: {
440
+ id: step.id,
441
+ status: "tripwire",
442
+ error: result?.tripwire?.reason,
443
+ payload: prevOutput
444
+ }
445
+ }
446
+ });
447
+ return {
448
+ executionContext,
449
+ result: {
450
+ status: "tripwire",
451
+ tripwire: result?.tripwire,
452
+ endedAt: Date.now()
453
+ }
454
+ };
455
+ } else if (perStep || result.status === "paused") {
456
+ await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
457
+ type: "watch",
458
+ runId: executionContext.runId,
459
+ data: {
460
+ type: "workflow-step-result",
461
+ payload: {
462
+ id: step.id,
463
+ status: "paused"
464
+ }
465
+ }
466
+ });
467
+ await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
468
+ type: "watch",
469
+ runId: executionContext.runId,
470
+ data: {
471
+ type: "workflow-step-finish",
472
+ payload: {
473
+ id: step.id,
474
+ metadata: {}
475
+ }
476
+ }
477
+ });
478
+ return { executionContext, result: { status: "paused" } };
479
+ }
480
+ await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
481
+ type: "watch",
482
+ runId: executionContext.runId,
483
+ data: {
484
+ type: "workflow-step-result",
485
+ payload: {
486
+ id: step.id,
487
+ status: "success",
488
+ output: result?.result
489
+ }
490
+ }
491
+ });
492
+ await pubsub.publish(`workflow.events.v2.${executionContext.runId}`, {
493
+ type: "watch",
494
+ runId: executionContext.runId,
495
+ data: {
496
+ type: "workflow-step-finish",
497
+ payload: {
498
+ id: step.id,
499
+ metadata: {}
500
+ }
501
+ }
254
502
  });
503
+ return { executionContext, result: { status: "success", output: result?.result, endedAt: Date.now() } };
255
504
  }
256
- return result;
257
- });
505
+ );
506
+ Object.assign(executionContext, res.executionContext);
258
507
  return {
259
- stream: readable,
260
- getWorkflowState: () => this.executionResults
508
+ ...res.result,
509
+ startedAt,
510
+ payload: inputData,
511
+ resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
512
+ resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
261
513
  };
262
514
  }
263
515
  };
264
- var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
265
- #mastra;
516
+ var InngestPubSub = class extends events.PubSub {
266
517
  inngest;
267
- function;
268
- flowControlConfig;
269
- constructor(params, inngest) {
270
- const { concurrency, rateLimit, throttle, debounce, priority, ...workflowParams } = params;
271
- super(workflowParams);
272
- const flowControlEntries = Object.entries({ concurrency, rateLimit, throttle, debounce, priority }).filter(
273
- ([_, value]) => value !== void 0
274
- );
275
- this.flowControlConfig = flowControlEntries.length > 0 ? Object.fromEntries(flowControlEntries) : void 0;
276
- this.#mastra = params.mastra;
518
+ workflowId;
519
+ publishFn;
520
+ subscriptions = /* @__PURE__ */ new Map();
521
+ constructor(inngest, workflowId, publishFn) {
522
+ super();
277
523
  this.inngest = inngest;
524
+ this.workflowId = workflowId;
525
+ this.publishFn = publishFn;
278
526
  }
279
- async getWorkflowRuns(args) {
280
- const storage = this.#mastra?.getStorage();
281
- if (!storage) {
282
- this.logger.debug("Cannot get workflow runs. Mastra engine is not initialized");
283
- return { runs: [], total: 0 };
527
+ /**
528
+ * Publish an event to Inngest's realtime system.
529
+ *
530
+ * Topic format: "workflow.events.v2.{runId}"
531
+ * Maps to Inngest channel: "workflow:{workflowId}:{runId}"
532
+ */
533
+ async publish(topic, event) {
534
+ if (!this.publishFn) {
535
+ return;
284
536
  }
285
- return storage.getWorkflowRuns({ workflowName: this.id, ...args ?? {} });
286
- }
287
- async getWorkflowRunById(runId) {
288
- const storage = this.#mastra?.getStorage();
289
- if (!storage) {
290
- this.logger.debug("Cannot get workflow runs. Mastra engine is not initialized");
291
- return this.runs.get(runId) ? { ...this.runs.get(runId), workflowName: this.id } : null;
537
+ const match = topic.match(/^workflow\.events\.v2\.(.+)$/);
538
+ if (!match) {
539
+ return;
292
540
  }
293
- const run = await storage.getWorkflowRunById({ runId, workflowName: this.id });
294
- return run ?? (this.runs.get(runId) ? { ...this.runs.get(runId), workflowName: this.id } : null);
295
- }
296
- __registerMastra(mastra) {
297
- this.#mastra = mastra;
298
- this.executionEngine.__registerMastra(mastra);
299
- const updateNested = (step) => {
300
- if ((step.type === "step" || step.type === "loop" || step.type === "foreach") && step.step instanceof _InngestWorkflow) {
301
- step.step.__registerMastra(mastra);
302
- } else if (step.type === "parallel" || step.type === "conditional") {
303
- for (const subStep of step.steps) {
304
- updateNested(subStep);
305
- }
306
- }
307
- };
308
- if (this.executionGraph.steps.length) {
309
- for (const step of this.executionGraph.steps) {
310
- updateNested(step);
311
- }
541
+ const runId = match[1];
542
+ try {
543
+ await this.publishFn({
544
+ channel: `workflow:${this.workflowId}:${runId}`,
545
+ topic: "watch",
546
+ data: event.data
547
+ });
548
+ } catch (err) {
549
+ console.error("InngestPubSub publish error:", err?.message ?? err);
312
550
  }
313
551
  }
314
552
  /**
315
- * @deprecated Use createRunAsync() instead.
316
- * @throws {Error} Always throws an error directing users to use createRunAsync()
553
+ * Subscribe to events from Inngest's realtime system.
554
+ *
555
+ * Topic format: "workflow.events.v2.{runId}"
556
+ * Maps to Inngest channel: "workflow:{workflowId}:{runId}"
317
557
  */
318
- createRun(_options) {
319
- throw new Error(
320
- "createRun() has been deprecated. Please use createRunAsync() instead.\n\nMigration guide:\n Before: const run = workflow.createRun();\n After: const run = await workflow.createRunAsync();\n\nNote: createRunAsync() is an async method, so make sure your calling function is async."
321
- );
322
- }
323
- async createRunAsync(options) {
324
- const runIdToUse = options?.runId || crypto.randomUUID();
325
- const run = this.runs.get(runIdToUse) ?? new InngestRun(
558
+ async subscribe(topic, cb) {
559
+ const match = topic.match(/^workflow\.events\.v2\.(.+)$/);
560
+ if (!match || !match[1]) {
561
+ return;
562
+ }
563
+ const runId = match[1];
564
+ if (this.subscriptions.has(topic)) {
565
+ this.subscriptions.get(topic).callbacks.add(cb);
566
+ return;
567
+ }
568
+ const callbacks = /* @__PURE__ */ new Set([cb]);
569
+ const channel = `workflow:${this.workflowId}:${runId}`;
570
+ const streamPromise = realtime.subscribe(
326
571
  {
327
- workflowId: this.id,
328
- runId: runIdToUse,
329
- resourceId: options?.resourceId,
330
- executionEngine: this.executionEngine,
331
- executionGraph: this.executionGraph,
332
- serializedStepGraph: this.serializedStepGraph,
333
- mastra: this.#mastra,
334
- retryConfig: this.retryConfig,
335
- cleanup: () => this.runs.delete(runIdToUse),
336
- workflowSteps: this.steps
572
+ channel,
573
+ topics: ["watch"],
574
+ app: this.inngest
337
575
  },
338
- this.inngest
576
+ (message) => {
577
+ const event = {
578
+ id: crypto.randomUUID(),
579
+ type: "watch",
580
+ runId,
581
+ data: message.data,
582
+ createdAt: /* @__PURE__ */ new Date()
583
+ };
584
+ for (const callback of callbacks) {
585
+ callback(event);
586
+ }
587
+ }
339
588
  );
340
- this.runs.set(runIdToUse, run);
341
- const shouldPersistSnapshot = this.options.shouldPersistSnapshot({
342
- workflowStatus: run.workflowRunStatus,
343
- stepResults: {}
589
+ this.subscriptions.set(topic, {
590
+ unsubscribe: () => {
591
+ streamPromise.then((stream) => stream.cancel()).catch((err) => {
592
+ console.error("InngestPubSub unsubscribe error:", err);
593
+ });
594
+ },
595
+ callbacks
344
596
  });
345
- const workflowSnapshotInStorage = await this.getWorkflowRunExecutionResult(runIdToUse, false);
346
- if (!workflowSnapshotInStorage && shouldPersistSnapshot) {
347
- await this.mastra?.getStorage()?.persistWorkflowSnapshot({
348
- workflowName: this.id,
349
- runId: runIdToUse,
350
- resourceId: options?.resourceId,
351
- snapshot: {
352
- runId: runIdToUse,
353
- status: "pending",
354
- value: {},
355
- context: {},
356
- activePaths: [],
357
- waitingPaths: {},
358
- serializedStepGraph: this.serializedStepGraph,
359
- suspendedPaths: {},
360
- result: void 0,
361
- error: void 0,
362
- // @ts-ignore
363
- timestamp: Date.now()
364
- }
365
- });
597
+ }
598
+ /**
599
+ * Unsubscribe a callback from a topic.
600
+ * If no callbacks remain, the underlying Inngest subscription is cancelled.
601
+ */
602
+ async unsubscribe(topic, cb) {
603
+ const sub = this.subscriptions.get(topic);
604
+ if (!sub) {
605
+ return;
606
+ }
607
+ sub.callbacks.delete(cb);
608
+ if (sub.callbacks.size === 0) {
609
+ sub.unsubscribe();
610
+ this.subscriptions.delete(topic);
366
611
  }
367
- return run;
368
612
  }
369
- getFunction() {
370
- if (this.function) {
371
- return this.function;
613
+ /**
614
+ * Flush any pending operations. No-op for Inngest.
615
+ */
616
+ async flush() {
617
+ }
618
+ /**
619
+ * Clean up all subscriptions during graceful shutdown.
620
+ */
621
+ async close() {
622
+ for (const [, sub] of this.subscriptions) {
623
+ sub.unsubscribe();
372
624
  }
373
- this.function = this.inngest.createFunction(
374
- {
375
- id: `workflow.${this.id}`,
376
- // @ts-ignore
377
- retries: this.retryConfig?.attempts ?? 0,
378
- cancelOn: [{ event: `cancel.workflow.${this.id}` }],
379
- // Spread flow control configuration
380
- ...this.flowControlConfig
381
- },
382
- { event: `workflow.${this.id}` },
383
- async ({ event, step, attempt, publish }) => {
384
- let { inputData, initialState, runId, resourceId, resume, outputOptions } = event.data;
385
- if (!runId) {
386
- runId = await step.run(`workflow.${this.id}.runIdGen`, async () => {
387
- return crypto.randomUUID();
388
- });
389
- }
390
- const emitter = {
391
- emit: async (event2, data) => {
392
- if (!publish) {
393
- return;
625
+ this.subscriptions.clear();
626
+ }
627
+ };
628
+ var InngestRun = class extends workflows.Run {
629
+ inngest;
630
+ serializedStepGraph;
631
+ #mastra;
632
+ constructor(params, inngest) {
633
+ super(params);
634
+ this.inngest = inngest;
635
+ this.serializedStepGraph = params.serializedStepGraph;
636
+ this.#mastra = params.mastra;
637
+ }
638
+ async getRuns(eventId) {
639
+ const maxRetries = 3;
640
+ let lastError = null;
641
+ for (let attempt = 0; attempt < maxRetries; attempt++) {
642
+ try {
643
+ const response = await fetch(
644
+ `${this.inngest.apiBaseUrl ?? "https://api.inngest.com"}/v1/events/${eventId}/runs`,
645
+ {
646
+ headers: {
647
+ Authorization: `Bearer ${process.env.INNGEST_SIGNING_KEY}`
394
648
  }
395
- try {
396
- await publish({
397
- channel: `workflow:${this.id}:${runId}`,
398
- topic: event2,
399
- data
400
- });
401
- } catch (err) {
402
- this.logger.error("Error emitting event: " + (err?.stack ?? err?.message ?? err));
649
+ }
650
+ );
651
+ if (response.status === 429) {
652
+ const retryAfter = parseInt(response.headers.get("retry-after") || "2", 10);
653
+ await new Promise((resolve) => setTimeout(resolve, retryAfter * 1e3));
654
+ continue;
655
+ }
656
+ if (!response.ok) {
657
+ throw new Error(`Inngest API error: ${response.status} ${response.statusText}`);
658
+ }
659
+ const text = await response.text();
660
+ if (!text) {
661
+ await new Promise((resolve) => setTimeout(resolve, 1e3 * (attempt + 1)));
662
+ continue;
663
+ }
664
+ const json = JSON.parse(text);
665
+ return json.data;
666
+ } catch (error) {
667
+ lastError = error;
668
+ if (attempt < maxRetries - 1) {
669
+ await new Promise((resolve) => setTimeout(resolve, 1e3 * Math.pow(2, attempt)));
670
+ }
671
+ }
672
+ }
673
+ throw new inngest.NonRetriableError(`Failed to get runs after ${maxRetries} attempts: ${lastError?.message}`);
674
+ }
675
+ async getRunOutput(eventId, maxWaitMs = 3e5) {
676
+ const startTime = Date.now();
677
+ const storage = this.#mastra?.getStorage();
678
+ const workflowsStore = await storage?.getStore("workflows");
679
+ while (Date.now() - startTime < maxWaitMs) {
680
+ let runs;
681
+ try {
682
+ runs = await this.getRuns(eventId);
683
+ } catch (error) {
684
+ if (error instanceof inngest.NonRetriableError) {
685
+ throw error;
686
+ }
687
+ throw new inngest.NonRetriableError(
688
+ `Failed to poll workflow status: ${error instanceof Error ? error.message : String(error)}`
689
+ );
690
+ }
691
+ if (runs?.[0]?.status === "Completed" && runs?.[0]?.event_id === eventId) {
692
+ return runs[0];
693
+ }
694
+ if (runs?.[0]?.status === "Failed") {
695
+ const snapshot = await workflowsStore?.loadWorkflowSnapshot({
696
+ workflowName: this.workflowId,
697
+ runId: this.runId
698
+ });
699
+ if (snapshot?.context) {
700
+ snapshot.context = workflows.hydrateSerializedStepErrors(snapshot.context);
701
+ }
702
+ return {
703
+ output: {
704
+ result: {
705
+ steps: snapshot?.context,
706
+ status: "failed",
707
+ // Get the original error from NonRetriableError's cause (which contains the workflow result)
708
+ error: error.getErrorFromUnknown(runs?.[0]?.output?.cause?.error, { serializeStack: false })
403
709
  }
404
- },
405
- on: (_event, _callback) => {
406
- },
407
- off: (_event, _callback) => {
408
- },
409
- once: (_event, _callback) => {
410
710
  }
411
711
  };
412
- const engine = new InngestExecutionEngine(this.#mastra, step, attempt, this.options);
413
- const result = await engine.execute({
414
- workflowId: this.id,
415
- runId,
416
- resourceId,
417
- graph: this.executionGraph,
418
- serializedStepGraph: this.serializedStepGraph,
419
- input: inputData,
420
- initialState,
421
- emitter,
422
- retryConfig: this.retryConfig,
423
- runtimeContext: new di.RuntimeContext(),
424
- // TODO
425
- resume,
426
- abortController: new AbortController(),
427
- currentSpan: void 0,
428
- // TODO: Pass actual parent AI span from workflow execution context
429
- outputOptions
712
+ }
713
+ if (runs?.[0]?.status === "Cancelled") {
714
+ const snapshot = await workflowsStore?.loadWorkflowSnapshot({
715
+ workflowName: this.workflowId,
716
+ runId: this.runId
430
717
  });
431
- await step.run(`workflow.${this.id}.finalize`, async () => {
432
- if (result.status === "failed") {
718
+ return { output: { result: { steps: snapshot?.context, status: "canceled" } } };
719
+ }
720
+ await new Promise((resolve) => setTimeout(resolve, 1e3 + Math.random() * 1e3));
721
+ }
722
+ throw new inngest.NonRetriableError(`Workflow did not complete within ${maxWaitMs}ms`);
723
+ }
724
+ async cancel() {
725
+ const storage = this.#mastra?.getStorage();
726
+ await this.inngest.send({
727
+ name: `cancel.workflow.${this.workflowId}`,
728
+ data: {
729
+ runId: this.runId
730
+ }
731
+ });
732
+ const workflowsStore = await storage?.getStore("workflows");
733
+ const snapshot = await workflowsStore?.loadWorkflowSnapshot({
734
+ workflowName: this.workflowId,
735
+ runId: this.runId
736
+ });
737
+ if (snapshot) {
738
+ await workflowsStore?.persistWorkflowSnapshot({
739
+ workflowName: this.workflowId,
740
+ runId: this.runId,
741
+ resourceId: this.resourceId,
742
+ snapshot: {
743
+ ...snapshot,
744
+ status: "canceled",
745
+ value: snapshot.value
746
+ }
747
+ });
748
+ }
749
+ }
750
+ async start(args) {
751
+ return this._start(args);
752
+ }
753
+ /**
754
+ * Starts the workflow execution without waiting for completion (fire-and-forget).
755
+ * Returns immediately with the runId after sending the event to Inngest.
756
+ * The workflow executes independently in Inngest.
757
+ * Use this when you don't need to wait for the result or want to avoid polling failures.
758
+ */
759
+ async startAsync(args) {
760
+ const workflowsStore = await this.#mastra.getStorage()?.getStore("workflows");
761
+ await workflowsStore?.persistWorkflowSnapshot({
762
+ workflowName: this.workflowId,
763
+ runId: this.runId,
764
+ resourceId: this.resourceId,
765
+ snapshot: {
766
+ runId: this.runId,
767
+ serializedStepGraph: this.serializedStepGraph,
768
+ status: "running",
769
+ value: {},
770
+ context: {},
771
+ activePaths: [],
772
+ suspendedPaths: {},
773
+ activeStepsPath: {},
774
+ resumeLabels: {},
775
+ waitingPaths: {},
776
+ timestamp: Date.now()
777
+ }
778
+ });
779
+ const inputDataToUse = await this._validateInput(args.inputData);
780
+ const initialStateToUse = await this._validateInitialState(args.initialState ?? {});
781
+ const eventOutput = await this.inngest.send({
782
+ name: `workflow.${this.workflowId}`,
783
+ data: {
784
+ inputData: inputDataToUse,
785
+ initialState: initialStateToUse,
786
+ runId: this.runId,
787
+ resourceId: this.resourceId,
788
+ outputOptions: args.outputOptions,
789
+ tracingOptions: args.tracingOptions,
790
+ requestContext: args.requestContext ? Object.fromEntries(args.requestContext.entries()) : {},
791
+ perStep: args.perStep
792
+ }
793
+ });
794
+ const eventId = eventOutput.ids[0];
795
+ if (!eventId) {
796
+ throw new Error("Event ID is not set");
797
+ }
798
+ return { runId: this.runId };
799
+ }
800
+ async _start({
801
+ inputData,
802
+ initialState,
803
+ outputOptions,
804
+ tracingOptions,
805
+ format,
806
+ requestContext,
807
+ perStep
808
+ }) {
809
+ const workflowsStore = await this.#mastra.getStorage()?.getStore("workflows");
810
+ await workflowsStore?.persistWorkflowSnapshot({
811
+ workflowName: this.workflowId,
812
+ runId: this.runId,
813
+ resourceId: this.resourceId,
814
+ snapshot: {
815
+ runId: this.runId,
816
+ serializedStepGraph: this.serializedStepGraph,
817
+ status: "running",
818
+ value: {},
819
+ context: {},
820
+ activePaths: [],
821
+ suspendedPaths: {},
822
+ activeStepsPath: {},
823
+ resumeLabels: {},
824
+ waitingPaths: {},
825
+ timestamp: Date.now()
826
+ }
827
+ });
828
+ const inputDataToUse = await this._validateInput(inputData);
829
+ const initialStateToUse = await this._validateInitialState(initialState ?? {});
830
+ const eventOutput = await this.inngest.send({
831
+ name: `workflow.${this.workflowId}`,
832
+ data: {
833
+ inputData: inputDataToUse,
834
+ initialState: initialStateToUse,
835
+ runId: this.runId,
836
+ resourceId: this.resourceId,
837
+ outputOptions,
838
+ tracingOptions,
839
+ format,
840
+ requestContext: requestContext ? Object.fromEntries(requestContext.entries()) : {},
841
+ perStep
842
+ }
843
+ });
844
+ const eventId = eventOutput.ids[0];
845
+ if (!eventId) {
846
+ throw new Error("Event ID is not set");
847
+ }
848
+ const runOutput = await this.getRunOutput(eventId);
849
+ const result = runOutput?.output?.result;
850
+ this.hydrateFailedResult(result);
851
+ if (result.status !== "suspended") {
852
+ this.cleanup?.();
853
+ }
854
+ return result;
855
+ }
856
+ async resume(params) {
857
+ const p = this._resume(params).then((result) => {
858
+ if (result.status !== "suspended") {
859
+ this.closeStreamAction?.().catch(() => {
860
+ });
861
+ }
862
+ return result;
863
+ });
864
+ this.executionResults = p;
865
+ return p;
866
+ }
867
+ async _resume(params) {
868
+ const storage = this.#mastra?.getStorage();
869
+ let steps = [];
870
+ if (typeof params.step === "string") {
871
+ steps = params.step.split(".");
872
+ } else {
873
+ steps = (Array.isArray(params.step) ? params.step : [params.step]).map(
874
+ (step) => typeof step === "string" ? step : step?.id
875
+ );
876
+ }
877
+ const workflowsStore = await storage?.getStore("workflows");
878
+ const snapshot = await workflowsStore?.loadWorkflowSnapshot({
879
+ workflowName: this.workflowId,
880
+ runId: this.runId
881
+ });
882
+ const suspendedStep = this.workflowSteps[steps?.[0] ?? ""];
883
+ const resumeDataToUse = await this._validateResumeData(params.resumeData, suspendedStep);
884
+ const persistedRequestContext = snapshot?.requestContext ?? {};
885
+ const newRequestContext = params.requestContext ? Object.fromEntries(params.requestContext.entries()) : {};
886
+ const mergedRequestContext = { ...persistedRequestContext, ...newRequestContext };
887
+ const eventOutput = await this.inngest.send({
888
+ name: `workflow.${this.workflowId}`,
889
+ data: {
890
+ inputData: resumeDataToUse,
891
+ initialState: snapshot?.value ?? {},
892
+ runId: this.runId,
893
+ workflowId: this.workflowId,
894
+ stepResults: snapshot?.context,
895
+ resume: {
896
+ steps,
897
+ stepResults: snapshot?.context,
898
+ resumePayload: resumeDataToUse,
899
+ resumePath: steps?.[0] ? snapshot?.suspendedPaths?.[steps?.[0]] : void 0
900
+ },
901
+ requestContext: mergedRequestContext,
902
+ perStep: params.perStep
903
+ }
904
+ });
905
+ const eventId = eventOutput.ids[0];
906
+ if (!eventId) {
907
+ throw new Error("Event ID is not set");
908
+ }
909
+ const runOutput = await this.getRunOutput(eventId);
910
+ const result = runOutput?.output?.result;
911
+ this.hydrateFailedResult(result);
912
+ return result;
913
+ }
914
+ async timeTravel(params) {
915
+ const p = this._timeTravel(params).then((result) => {
916
+ if (result.status !== "suspended") {
917
+ this.closeStreamAction?.().catch(() => {
918
+ });
919
+ }
920
+ return result;
921
+ });
922
+ this.executionResults = p;
923
+ return p;
924
+ }
925
+ async _timeTravel(params) {
926
+ if (!params.step || Array.isArray(params.step) && params.step?.length === 0) {
927
+ throw new Error("Step is required and must be a valid step or array of steps");
928
+ }
929
+ let steps = [];
930
+ if (typeof params.step === "string") {
931
+ steps = params.step.split(".");
932
+ } else {
933
+ steps = (Array.isArray(params.step) ? params.step : [params.step]).map(
934
+ (step) => typeof step === "string" ? step : step?.id
935
+ );
936
+ }
937
+ if (steps.length === 0) {
938
+ throw new Error("No steps provided to timeTravel");
939
+ }
940
+ const storage = this.#mastra?.getStorage();
941
+ const workflowsStore = await storage?.getStore("workflows");
942
+ const snapshot = await workflowsStore?.loadWorkflowSnapshot({
943
+ workflowName: this.workflowId,
944
+ runId: this.runId
945
+ });
946
+ if (!snapshot) {
947
+ await workflowsStore?.persistWorkflowSnapshot({
948
+ workflowName: this.workflowId,
949
+ runId: this.runId,
950
+ resourceId: this.resourceId,
951
+ snapshot: {
952
+ runId: this.runId,
953
+ serializedStepGraph: this.serializedStepGraph,
954
+ status: "pending",
955
+ value: {},
956
+ context: {},
957
+ activePaths: [],
958
+ suspendedPaths: {},
959
+ activeStepsPath: {},
960
+ resumeLabels: {},
961
+ waitingPaths: {},
962
+ timestamp: Date.now()
963
+ }
964
+ });
965
+ }
966
+ if (snapshot?.status === "running") {
967
+ throw new Error("This workflow run is still running, cannot time travel");
968
+ }
969
+ let inputDataToUse = params.inputData;
970
+ if (inputDataToUse && steps.length === 1) {
971
+ inputDataToUse = await this._validateTimetravelInputData(params.inputData, this.workflowSteps[steps[0]]);
972
+ }
973
+ const timeTravelData = workflows.createTimeTravelExecutionParams({
974
+ steps,
975
+ inputData: inputDataToUse,
976
+ resumeData: params.resumeData,
977
+ context: params.context,
978
+ nestedStepsContext: params.nestedStepsContext,
979
+ snapshot: snapshot ?? { context: {} },
980
+ graph: this.executionGraph,
981
+ initialState: params.initialState,
982
+ perStep: params.perStep
983
+ });
984
+ const eventOutput = await this.inngest.send({
985
+ name: `workflow.${this.workflowId}`,
986
+ data: {
987
+ initialState: timeTravelData.state,
988
+ runId: this.runId,
989
+ workflowId: this.workflowId,
990
+ stepResults: timeTravelData.stepResults,
991
+ timeTravel: timeTravelData,
992
+ tracingOptions: params.tracingOptions,
993
+ outputOptions: params.outputOptions,
994
+ requestContext: params.requestContext ? Object.fromEntries(params.requestContext.entries()) : {},
995
+ perStep: params.perStep
996
+ }
997
+ });
998
+ const eventId = eventOutput.ids[0];
999
+ if (!eventId) {
1000
+ throw new Error("Event ID is not set");
1001
+ }
1002
+ const runOutput = await this.getRunOutput(eventId);
1003
+ const result = runOutput?.output?.result;
1004
+ this.hydrateFailedResult(result);
1005
+ return result;
1006
+ }
1007
+ watch(cb) {
1008
+ let active = true;
1009
+ const streamPromise = realtime.subscribe(
1010
+ {
1011
+ channel: `workflow:${this.workflowId}:${this.runId}`,
1012
+ topics: ["watch"],
1013
+ app: this.inngest
1014
+ },
1015
+ (message) => {
1016
+ if (active) {
1017
+ cb(message.data);
1018
+ }
1019
+ }
1020
+ );
1021
+ return () => {
1022
+ active = false;
1023
+ streamPromise.then(async (stream) => {
1024
+ return stream.cancel();
1025
+ }).catch((err) => {
1026
+ console.error(err);
1027
+ });
1028
+ };
1029
+ }
1030
+ streamLegacy({ inputData, requestContext } = {}) {
1031
+ const { readable, writable } = new TransformStream();
1032
+ const writer = writable.getWriter();
1033
+ void writer.write({
1034
+ // @ts-expect-error - stream event type mismatch
1035
+ type: "start",
1036
+ payload: { runId: this.runId }
1037
+ });
1038
+ const unwatch = this.watch(async (event) => {
1039
+ try {
1040
+ const e = {
1041
+ ...event,
1042
+ type: event.type.replace("workflow-", "")
1043
+ };
1044
+ if (e.type === "step-output") {
1045
+ e.type = e.payload.output.type;
1046
+ e.payload = e.payload.output.payload;
1047
+ }
1048
+ await writer.write(e);
1049
+ } catch {
1050
+ }
1051
+ });
1052
+ this.closeStreamAction = async () => {
1053
+ await writer.write({
1054
+ type: "finish",
1055
+ // @ts-expect-error - stream event type mismatch
1056
+ payload: { runId: this.runId }
1057
+ });
1058
+ unwatch();
1059
+ try {
1060
+ await writer.close();
1061
+ } catch (err) {
1062
+ console.error("Error closing stream:", err);
1063
+ } finally {
1064
+ writer.releaseLock();
1065
+ }
1066
+ };
1067
+ this.executionResults = this._start({ inputData, requestContext, format: "legacy" }).then((result) => {
1068
+ if (result.status !== "suspended") {
1069
+ this.closeStreamAction?.().catch(() => {
1070
+ });
1071
+ }
1072
+ return result;
1073
+ });
1074
+ return {
1075
+ stream: readable,
1076
+ getWorkflowState: () => this.executionResults
1077
+ };
1078
+ }
1079
+ stream({
1080
+ inputData,
1081
+ requestContext,
1082
+ tracingOptions,
1083
+ closeOnSuspend = true,
1084
+ initialState,
1085
+ outputOptions,
1086
+ perStep
1087
+ } = {}) {
1088
+ if (this.closeStreamAction && this.streamOutput) {
1089
+ return this.streamOutput;
1090
+ }
1091
+ this.closeStreamAction = async () => {
1092
+ };
1093
+ const self = this;
1094
+ const stream$1 = new web.ReadableStream({
1095
+ async start(controller) {
1096
+ const unwatch = self.watch(async ({ type, from = stream.ChunkFrom.WORKFLOW, payload }) => {
1097
+ controller.enqueue({
1098
+ type,
1099
+ runId: self.runId,
1100
+ from,
1101
+ payload: {
1102
+ stepName: payload?.id,
1103
+ ...payload
1104
+ }
1105
+ });
1106
+ });
1107
+ self.closeStreamAction = async () => {
1108
+ unwatch();
1109
+ try {
1110
+ await controller.close();
1111
+ } catch (err) {
1112
+ console.error("Error closing stream:", err);
1113
+ }
1114
+ };
1115
+ const executionResultsPromise = self._start({
1116
+ inputData,
1117
+ requestContext,
1118
+ // tracingContext, // We are not able to pass a reference to a span here, what to do?
1119
+ initialState,
1120
+ tracingOptions,
1121
+ outputOptions,
1122
+ format: "vnext",
1123
+ perStep
1124
+ });
1125
+ let executionResults;
1126
+ try {
1127
+ executionResults = await executionResultsPromise;
1128
+ if (closeOnSuspend) {
1129
+ self.closeStreamAction?.().catch(() => {
1130
+ });
1131
+ } else if (executionResults.status !== "suspended") {
1132
+ self.closeStreamAction?.().catch(() => {
1133
+ });
1134
+ }
1135
+ if (self.streamOutput) {
1136
+ self.streamOutput.updateResults(
1137
+ executionResults
1138
+ );
1139
+ }
1140
+ } catch (err) {
1141
+ self.streamOutput?.rejectResults(err);
1142
+ self.closeStreamAction?.().catch(() => {
1143
+ });
1144
+ }
1145
+ }
1146
+ });
1147
+ this.streamOutput = new stream.WorkflowRunOutput({
1148
+ runId: this.runId,
1149
+ workflowId: this.workflowId,
1150
+ stream: stream$1
1151
+ });
1152
+ return this.streamOutput;
1153
+ }
1154
+ timeTravelStream({
1155
+ inputData,
1156
+ resumeData,
1157
+ initialState,
1158
+ step,
1159
+ context,
1160
+ nestedStepsContext,
1161
+ requestContext,
1162
+ // tracingContext,
1163
+ tracingOptions,
1164
+ outputOptions,
1165
+ perStep
1166
+ }) {
1167
+ this.closeStreamAction = async () => {
1168
+ };
1169
+ const self = this;
1170
+ const stream$1 = new web.ReadableStream({
1171
+ async start(controller) {
1172
+ const unwatch = self.watch(async ({ type, from = stream.ChunkFrom.WORKFLOW, payload }) => {
1173
+ controller.enqueue({
1174
+ type,
1175
+ runId: self.runId,
1176
+ from,
1177
+ payload: {
1178
+ stepName: payload?.id,
1179
+ ...payload
1180
+ }
1181
+ });
1182
+ });
1183
+ self.closeStreamAction = async () => {
1184
+ unwatch();
1185
+ try {
1186
+ controller.close();
1187
+ } catch (err) {
1188
+ console.error("Error closing stream:", err);
1189
+ }
1190
+ };
1191
+ const executionResultsPromise = self._timeTravel({
1192
+ inputData,
1193
+ step,
1194
+ context,
1195
+ nestedStepsContext,
1196
+ resumeData,
1197
+ initialState,
1198
+ requestContext,
1199
+ tracingOptions,
1200
+ outputOptions,
1201
+ perStep
1202
+ });
1203
+ self.executionResults = executionResultsPromise;
1204
+ let executionResults;
1205
+ try {
1206
+ executionResults = await executionResultsPromise;
1207
+ self.closeStreamAction?.().catch(() => {
1208
+ });
1209
+ if (self.streamOutput) {
1210
+ self.streamOutput.updateResults(executionResults);
1211
+ }
1212
+ } catch (err) {
1213
+ self.streamOutput?.rejectResults(err);
1214
+ self.closeStreamAction?.().catch(() => {
1215
+ });
1216
+ }
1217
+ }
1218
+ });
1219
+ this.streamOutput = new stream.WorkflowRunOutput({
1220
+ runId: this.runId,
1221
+ workflowId: this.workflowId,
1222
+ stream: stream$1
1223
+ });
1224
+ return this.streamOutput;
1225
+ }
1226
+ /**
1227
+ * Hydrates errors in a failed workflow result back to proper Error instances.
1228
+ * This ensures error.cause chains and custom properties are preserved.
1229
+ */
1230
+ hydrateFailedResult(result) {
1231
+ if (result.status === "failed") {
1232
+ result.error = error.getErrorFromUnknown(result.error, { serializeStack: false });
1233
+ if (result.steps) {
1234
+ workflows.hydrateSerializedStepErrors(result.steps);
1235
+ }
1236
+ }
1237
+ }
1238
+ };
1239
+
1240
+ // src/workflow.ts
1241
+ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
1242
+ #mastra;
1243
+ inngest;
1244
+ function;
1245
+ cronFunction;
1246
+ flowControlConfig;
1247
+ cronConfig;
1248
+ constructor(params, inngest) {
1249
+ const { concurrency, rateLimit, throttle, debounce, priority, cron, inputData, initialState, ...workflowParams } = params;
1250
+ super(workflowParams);
1251
+ this.engineType = "inngest";
1252
+ const flowControlEntries = Object.entries({ concurrency, rateLimit, throttle, debounce, priority }).filter(
1253
+ ([_, value]) => value !== void 0
1254
+ );
1255
+ this.flowControlConfig = flowControlEntries.length > 0 ? Object.fromEntries(flowControlEntries) : void 0;
1256
+ this.#mastra = params.mastra;
1257
+ this.inngest = inngest;
1258
+ if (cron) {
1259
+ this.cronConfig = { cron, inputData, initialState };
1260
+ }
1261
+ }
1262
+ async listWorkflowRuns(args) {
1263
+ const storage = this.#mastra?.getStorage();
1264
+ if (!storage) {
1265
+ this.logger.debug("Cannot get workflow runs. Mastra engine is not initialized");
1266
+ return { runs: [], total: 0 };
1267
+ }
1268
+ const workflowsStore = await storage.getStore("workflows");
1269
+ if (!workflowsStore) {
1270
+ return { runs: [], total: 0 };
1271
+ }
1272
+ return workflowsStore.listWorkflowRuns({ workflowName: this.id, ...args ?? {} });
1273
+ }
1274
+ __registerMastra(mastra) {
1275
+ super.__registerMastra(mastra);
1276
+ this.#mastra = mastra;
1277
+ this.executionEngine.__registerMastra(mastra);
1278
+ const updateNested = (step) => {
1279
+ if ((step.type === "step" || step.type === "loop" || step.type === "foreach") && step.step instanceof _InngestWorkflow) {
1280
+ step.step.__registerMastra(mastra);
1281
+ } else if (step.type === "parallel" || step.type === "conditional") {
1282
+ for (const subStep of step.steps) {
1283
+ updateNested(subStep);
1284
+ }
1285
+ }
1286
+ };
1287
+ if (this.executionGraph.steps.length) {
1288
+ for (const step of this.executionGraph.steps) {
1289
+ updateNested(step);
1290
+ }
1291
+ }
1292
+ }
1293
+ async createRun(options) {
1294
+ const runIdToUse = options?.runId || crypto$1.randomUUID();
1295
+ const existingInMemoryRun = this.runs.get(runIdToUse);
1296
+ const newRun = new InngestRun(
1297
+ {
1298
+ workflowId: this.id,
1299
+ runId: runIdToUse,
1300
+ resourceId: options?.resourceId,
1301
+ executionEngine: this.executionEngine,
1302
+ executionGraph: this.executionGraph,
1303
+ serializedStepGraph: this.serializedStepGraph,
1304
+ mastra: this.#mastra,
1305
+ retryConfig: this.retryConfig,
1306
+ cleanup: () => this.runs.delete(runIdToUse),
1307
+ workflowSteps: this.steps,
1308
+ workflowEngineType: this.engineType,
1309
+ validateInputs: this.options.validateInputs
1310
+ },
1311
+ this.inngest
1312
+ );
1313
+ const run = existingInMemoryRun ?? newRun;
1314
+ this.runs.set(runIdToUse, run);
1315
+ const shouldPersistSnapshot = this.options.shouldPersistSnapshot({
1316
+ workflowStatus: run.workflowRunStatus,
1317
+ stepResults: {}
1318
+ });
1319
+ const existingStoredRun = await this.getWorkflowRunById(runIdToUse, {
1320
+ withNestedWorkflows: false
1321
+ });
1322
+ const existsInStorage = existingStoredRun && !existingStoredRun.isFromInMemory;
1323
+ if (!existsInStorage && shouldPersistSnapshot) {
1324
+ const workflowsStore = await this.mastra?.getStorage()?.getStore("workflows");
1325
+ await workflowsStore?.persistWorkflowSnapshot({
1326
+ workflowName: this.id,
1327
+ runId: runIdToUse,
1328
+ resourceId: options?.resourceId,
1329
+ snapshot: {
1330
+ runId: runIdToUse,
1331
+ status: "pending",
1332
+ value: {},
1333
+ context: {},
1334
+ activePaths: [],
1335
+ activeStepsPath: {},
1336
+ waitingPaths: {},
1337
+ serializedStepGraph: this.serializedStepGraph,
1338
+ suspendedPaths: {},
1339
+ resumeLabels: {},
1340
+ result: void 0,
1341
+ error: void 0,
1342
+ timestamp: Date.now()
1343
+ }
1344
+ });
1345
+ }
1346
+ return run;
1347
+ }
1348
+ //createCronFunction is only called if cronConfig.cron is defined.
1349
+ createCronFunction() {
1350
+ if (this.cronFunction) {
1351
+ return this.cronFunction;
1352
+ }
1353
+ this.cronFunction = this.inngest.createFunction(
1354
+ {
1355
+ id: `workflow.${this.id}.cron`,
1356
+ retries: 0,
1357
+ cancelOn: [{ event: `cancel.workflow.${this.id}` }],
1358
+ ...this.flowControlConfig
1359
+ },
1360
+ { cron: this.cronConfig?.cron ?? "" },
1361
+ async () => {
1362
+ const run = await this.createRun();
1363
+ const result = await run.start({
1364
+ inputData: this.cronConfig?.inputData,
1365
+ initialState: this.cronConfig?.initialState
1366
+ });
1367
+ return { result, runId: run.runId };
1368
+ }
1369
+ );
1370
+ return this.cronFunction;
1371
+ }
1372
+ getFunction() {
1373
+ if (this.function) {
1374
+ return this.function;
1375
+ }
1376
+ this.function = this.inngest.createFunction(
1377
+ {
1378
+ id: `workflow.${this.id}`,
1379
+ retries: 0,
1380
+ cancelOn: [{ event: `cancel.workflow.${this.id}` }],
1381
+ // Spread flow control configuration
1382
+ ...this.flowControlConfig
1383
+ },
1384
+ { event: `workflow.${this.id}` },
1385
+ async ({ event, step, attempt, publish }) => {
1386
+ let {
1387
+ inputData,
1388
+ initialState,
1389
+ runId,
1390
+ resourceId,
1391
+ resume,
1392
+ outputOptions,
1393
+ format,
1394
+ timeTravel,
1395
+ perStep,
1396
+ tracingOptions
1397
+ } = event.data;
1398
+ if (!runId) {
1399
+ runId = await step.run(`workflow.${this.id}.runIdGen`, async () => {
1400
+ return crypto$1.randomUUID();
1401
+ });
1402
+ }
1403
+ const pubsub = new InngestPubSub(this.inngest, this.id, publish);
1404
+ const requestContext = new di.RequestContext(Object.entries(event.data.requestContext ?? {}));
1405
+ const mastra = this.#mastra;
1406
+ const tracingPolicy = this.options.tracingPolicy;
1407
+ const workflowSpanData = await step.run(`workflow.${this.id}.span.start`, async () => {
1408
+ const observability$1 = mastra?.observability?.getSelectedInstance({ requestContext });
1409
+ if (!observability$1) return void 0;
1410
+ const span = observability$1.startSpan({
1411
+ type: observability.SpanType.WORKFLOW_RUN,
1412
+ name: `workflow run: '${this.id}'`,
1413
+ entityType: observability.EntityType.WORKFLOW_RUN,
1414
+ entityId: this.id,
1415
+ input: inputData,
1416
+ metadata: {
1417
+ resourceId,
1418
+ runId
1419
+ },
1420
+ tracingPolicy,
1421
+ tracingOptions,
1422
+ requestContext
1423
+ });
1424
+ return span?.exportSpan();
1425
+ });
1426
+ const engine = new InngestExecutionEngine(this.#mastra, step, attempt, this.options);
1427
+ let result;
1428
+ try {
1429
+ result = await engine.execute({
1430
+ workflowId: this.id,
1431
+ runId,
1432
+ resourceId,
1433
+ graph: this.executionGraph,
1434
+ serializedStepGraph: this.serializedStepGraph,
1435
+ input: inputData,
1436
+ initialState,
1437
+ pubsub,
1438
+ retryConfig: this.retryConfig,
1439
+ requestContext,
1440
+ resume,
1441
+ timeTravel,
1442
+ perStep,
1443
+ format,
1444
+ abortController: new AbortController(),
1445
+ // For Inngest, we don't pass workflowSpan - step spans use tracingIds instead
1446
+ workflowSpan: void 0,
1447
+ // Pass tracing IDs for durable span operations
1448
+ tracingIds: workflowSpanData ? {
1449
+ traceId: workflowSpanData.traceId,
1450
+ workflowSpanId: workflowSpanData.id
1451
+ } : void 0,
1452
+ outputOptions,
1453
+ outputWriter: async (chunk) => {
1454
+ try {
1455
+ await pubsub.publish(`workflow.events.v2.${runId}`, {
1456
+ type: "watch",
1457
+ runId,
1458
+ data: chunk
1459
+ });
1460
+ } catch (err) {
1461
+ this.logger.debug?.("Failed to publish watch event:", err);
1462
+ }
1463
+ }
1464
+ });
1465
+ } catch (error) {
1466
+ throw error;
1467
+ }
1468
+ await step.run(`workflow.${this.id}.finalize`, async () => {
1469
+ if (result.status !== "paused") {
1470
+ await engine.invokeLifecycleCallbacksInternal({
1471
+ status: result.status,
1472
+ result: "result" in result ? result.result : void 0,
1473
+ error: "error" in result ? result.error : void 0,
1474
+ steps: result.steps,
1475
+ tripwire: "tripwire" in result ? result.tripwire : void 0,
1476
+ runId,
1477
+ workflowId: this.id,
1478
+ resourceId,
1479
+ input: inputData,
1480
+ requestContext,
1481
+ state: result.state ?? initialState ?? {}
1482
+ });
1483
+ }
1484
+ if (workflowSpanData) {
1485
+ const observability = mastra?.observability?.getSelectedInstance({ requestContext });
1486
+ if (observability) {
1487
+ const workflowSpan = observability.rebuildSpan(workflowSpanData);
1488
+ if (result.status === "failed") {
1489
+ workflowSpan.error({
1490
+ error: result.error instanceof Error ? result.error : new Error(String(result.error)),
1491
+ attributes: { status: "failed" }
1492
+ });
1493
+ } else {
1494
+ workflowSpan.end({
1495
+ output: result.status === "success" ? result.result : void 0,
1496
+ attributes: { status: result.status }
1497
+ });
1498
+ }
1499
+ }
1500
+ }
1501
+ if (result.status === "failed") {
433
1502
  throw new inngest.NonRetriableError(`Workflow failed`, {
434
1503
  cause: result
435
1504
  });
@@ -455,1084 +1524,731 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
455
1524
  });
456
1525
  }
457
1526
  getFunctions() {
458
- return [this.getFunction(), ...this.getNestedFunctions(this.executionGraph.steps)];
1527
+ return [
1528
+ this.getFunction(),
1529
+ ...this.cronConfig?.cron ? [this.createCronFunction()] : [],
1530
+ ...this.getNestedFunctions(this.executionGraph.steps)
1531
+ ];
459
1532
  }
460
1533
  };
461
- function isAgent(params) {
462
- return params?.component === "AGENT";
1534
+ function prepareServeOptions({ mastra, inngest, functions: userFunctions = [], registerOptions }) {
1535
+ const wfs = mastra.listWorkflows();
1536
+ const workflowFunctions = Array.from(
1537
+ new Set(
1538
+ Object.values(wfs).flatMap((wf) => {
1539
+ if (wf instanceof InngestWorkflow) {
1540
+ wf.__registerMastra(mastra);
1541
+ return wf.getFunctions();
1542
+ }
1543
+ return [];
1544
+ })
1545
+ )
1546
+ );
1547
+ return {
1548
+ ...registerOptions,
1549
+ client: inngest,
1550
+ functions: [...workflowFunctions, ...userFunctions]
1551
+ };
1552
+ }
1553
+ function createServe(adapter) {
1554
+ return (options) => {
1555
+ const serveOptions = prepareServeOptions(options);
1556
+ return adapter(serveOptions);
1557
+ };
1558
+ }
1559
+ var serve = createServe(hono.serve);
1560
+
1561
+ // src/types.ts
1562
+ var _compatibilityCheck = true;
1563
+
1564
+ // src/index.ts
1565
+ function isInngestWorkflow(input) {
1566
+ return input instanceof InngestWorkflow;
463
1567
  }
464
- function isTool(params) {
465
- return params instanceof tools.Tool;
1568
+ function isAgent(input) {
1569
+ return input instanceof agent.Agent;
466
1570
  }
467
- function createStep(params) {
1571
+ function isToolStep(input) {
1572
+ return input instanceof tools.Tool;
1573
+ }
1574
+ function isStepParams(input) {
1575
+ return input !== null && typeof input === "object" && "id" in input && "execute" in input && !(input instanceof agent.Agent) && !(input instanceof tools.Tool) && !(input instanceof InngestWorkflow);
1576
+ }
1577
+ function isProcessor(obj) {
1578
+ 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");
1579
+ }
1580
+ function createStep(params, agentOrToolOptions) {
1581
+ if (isInngestWorkflow(params)) {
1582
+ return params;
1583
+ }
468
1584
  if (isAgent(params)) {
469
- return {
470
- id: params.name,
471
- description: params.getDescription(),
472
- // @ts-ignore
473
- inputSchema: zod.z.object({
474
- prompt: zod.z.string()
475
- }),
476
- // @ts-ignore
477
- outputSchema: zod.z.object({
478
- text: zod.z.string()
479
- }),
480
- execute: async ({ inputData, [_constants.EMITTER_SYMBOL]: emitter, runtimeContext, abortSignal, abort, tracingContext }) => {
481
- let streamPromise = {};
482
- streamPromise.promise = new Promise((resolve, reject) => {
483
- streamPromise.resolve = resolve;
484
- streamPromise.reject = reject;
485
- });
486
- const toolData = {
487
- name: params.name,
488
- args: inputData
489
- };
490
- if ((await params.getLLM()).getModel().specificationVersion === `v2`) {
491
- const { fullStream } = await params.stream(inputData.prompt, {
492
- runtimeContext,
493
- tracingContext,
494
- onFinish: (result) => {
495
- streamPromise.resolve(result.text);
496
- },
497
- abortSignal
498
- });
499
- if (abortSignal.aborted) {
500
- return abort();
501
- }
502
- await emitter.emit("watch-v2", {
503
- type: "tool-call-streaming-start",
504
- ...toolData ?? {}
505
- });
506
- for await (const chunk of fullStream) {
507
- if (chunk.type === "text-delta") {
508
- await emitter.emit("watch-v2", {
509
- type: "tool-call-delta",
510
- ...toolData ?? {},
511
- argsTextDelta: chunk.payload.text
512
- });
513
- }
514
- }
515
- } else {
516
- const { fullStream } = await params.streamLegacy(inputData.prompt, {
517
- runtimeContext,
518
- tracingContext,
519
- onFinish: (result) => {
520
- streamPromise.resolve(result.text);
521
- },
522
- abortSignal
523
- });
524
- if (abortSignal.aborted) {
525
- return abort();
526
- }
527
- await emitter.emit("watch-v2", {
528
- type: "tool-call-streaming-start",
529
- ...toolData ?? {}
530
- });
531
- for await (const chunk of fullStream) {
532
- if (chunk.type === "text-delta") {
533
- await emitter.emit("watch-v2", {
534
- type: "tool-call-delta",
535
- ...toolData ?? {},
536
- argsTextDelta: chunk.textDelta
537
- });
538
- }
539
- }
540
- }
541
- await emitter.emit("watch-v2", {
542
- type: "tool-call-streaming-finish",
543
- ...toolData ?? {}
544
- });
545
- return {
546
- text: await streamPromise.promise
547
- };
548
- },
549
- component: params.component
550
- };
1585
+ return createStepFromAgent(params, agentOrToolOptions);
551
1586
  }
552
- if (isTool(params)) {
553
- if (!params.inputSchema || !params.outputSchema) {
554
- throw new Error("Tool must have input and output schemas defined");
555
- }
556
- return {
557
- // TODO: tool probably should have strong id type
558
- // @ts-ignore
559
- id: params.id,
560
- description: params.description,
561
- inputSchema: params.inputSchema,
562
- outputSchema: params.outputSchema,
563
- execute: async ({ inputData, mastra, runtimeContext, tracingContext, suspend, resumeData }) => {
564
- return params.execute({
565
- context: inputData,
566
- mastra: aiTracing.wrapMastra(mastra, tracingContext),
567
- runtimeContext,
568
- tracingContext,
569
- suspend,
570
- resumeData
571
- });
572
- },
573
- component: "TOOL"
574
- };
1587
+ if (isToolStep(params)) {
1588
+ return createStepFromTool(params, agentOrToolOptions);
1589
+ }
1590
+ if (isStepParams(params)) {
1591
+ return createStepFromParams(params);
1592
+ }
1593
+ if (isProcessor(params)) {
1594
+ return createStepFromProcessor(params);
575
1595
  }
1596
+ throw new Error("Invalid input: expected StepParams, Agent, ToolStep, Processor, or InngestWorkflow");
1597
+ }
1598
+ function createStepFromParams(params) {
576
1599
  return {
577
1600
  id: params.id,
578
1601
  description: params.description,
579
1602
  inputSchema: params.inputSchema,
1603
+ stateSchema: params.stateSchema,
580
1604
  outputSchema: params.outputSchema,
581
1605
  resumeSchema: params.resumeSchema,
582
1606
  suspendSchema: params.suspendSchema,
583
- execute: params.execute
1607
+ scorers: params.scorers,
1608
+ retries: params.retries,
1609
+ execute: params.execute.bind(params)
584
1610
  };
585
1611
  }
586
- function init(inngest) {
1612
+ function createStepFromAgent(params, agentOrToolOptions) {
1613
+ const options = agentOrToolOptions ?? {};
1614
+ const outputSchema = options?.structuredOutput?.schema ?? zod.z.object({ text: zod.z.string() });
1615
+ const { retries, scorers, ...agentOptions } = options ?? {};
587
1616
  return {
588
- createWorkflow(params) {
589
- return new InngestWorkflow(
590
- params,
591
- inngest
592
- );
593
- },
594
- createStep,
595
- cloneStep(step, opts) {
596
- return {
597
- id: opts.id,
598
- description: step.description,
599
- inputSchema: step.inputSchema,
600
- outputSchema: step.outputSchema,
601
- resumeSchema: step.resumeSchema,
602
- suspendSchema: step.suspendSchema,
603
- stateSchema: step.stateSchema,
604
- execute: step.execute,
605
- component: step.component
606
- };
607
- },
608
- cloneWorkflow(workflow, opts) {
609
- const wf = new workflows.Workflow({
610
- id: opts.id,
611
- inputSchema: workflow.inputSchema,
612
- outputSchema: workflow.outputSchema,
613
- steps: workflow.stepDefs,
614
- mastra: workflow.mastra
1617
+ id: params.name,
1618
+ description: params.getDescription(),
1619
+ inputSchema: zod.z.object({
1620
+ prompt: zod.z.string()
1621
+ }),
1622
+ outputSchema,
1623
+ retries,
1624
+ scorers,
1625
+ execute: async ({
1626
+ inputData,
1627
+ runId,
1628
+ [_constants.PUBSUB_SYMBOL]: pubsub,
1629
+ [_constants.STREAM_FORMAT_SYMBOL]: streamFormat,
1630
+ requestContext,
1631
+ tracingContext,
1632
+ abortSignal,
1633
+ abort,
1634
+ writer
1635
+ }) => {
1636
+ let streamPromise = {};
1637
+ streamPromise.promise = new Promise((resolve, reject) => {
1638
+ streamPromise.resolve = resolve;
1639
+ streamPromise.reject = reject;
615
1640
  });
616
- wf.setStepFlow(workflow.stepGraph);
617
- wf.commit();
618
- return wf;
619
- }
620
- };
621
- }
622
- var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
623
- inngestStep;
624
- inngestAttempts;
625
- constructor(mastra, inngestStep, inngestAttempts = 0, options) {
626
- super({ mastra, options });
627
- this.inngestStep = inngestStep;
628
- this.inngestAttempts = inngestAttempts;
629
- }
630
- async execute(params) {
631
- await params.emitter.emit("watch-v2", {
632
- type: "workflow-start",
633
- payload: { runId: params.runId }
634
- });
635
- const result = await super.execute(params);
636
- await params.emitter.emit("watch-v2", {
637
- type: "workflow-finish",
638
- payload: { runId: params.runId }
639
- });
640
- return result;
641
- }
642
- async fmtReturnValue(executionSpan, emitter, stepResults, lastOutput, error) {
643
- const base = {
644
- status: lastOutput.status,
645
- steps: stepResults
646
- };
647
- if (lastOutput.status === "success") {
648
- await emitter.emit("watch", {
649
- type: "watch",
650
- payload: {
651
- workflowState: {
652
- status: lastOutput.status,
653
- steps: stepResults,
654
- result: lastOutput.output
655
- }
656
- },
657
- eventTimestamp: Date.now()
658
- });
659
- base.result = lastOutput.output;
660
- } else if (lastOutput.status === "failed") {
661
- base.error = error instanceof Error ? error?.stack ?? error.message : lastOutput?.error instanceof Error ? lastOutput.error.message : lastOutput.error ?? error ?? "Unknown error";
662
- await emitter.emit("watch", {
663
- type: "watch",
664
- payload: {
665
- workflowState: {
666
- status: lastOutput.status,
667
- steps: stepResults,
668
- result: null,
669
- error: base.error
670
- }
671
- },
672
- eventTimestamp: Date.now()
673
- });
674
- } else if (lastOutput.status === "suspended") {
675
- await emitter.emit("watch", {
676
- type: "watch",
677
- payload: {
678
- workflowState: {
679
- status: lastOutput.status,
680
- steps: stepResults,
681
- result: null,
682
- error: null
683
- }
684
- },
685
- eventTimestamp: Date.now()
686
- });
687
- const suspendedStepIds = Object.entries(stepResults).flatMap(([stepId, stepResult]) => {
688
- if (stepResult?.status === "suspended") {
689
- const nestedPath = stepResult?.suspendPayload?.__workflow_meta?.path;
690
- return nestedPath ? [[stepId, ...nestedPath]] : [[stepId]];
691
- }
692
- return [];
693
- });
694
- base.suspended = suspendedStepIds;
695
- }
696
- executionSpan?.end();
697
- return base;
698
- }
699
- // async executeSleep({ id, duration }: { id: string; duration: number }): Promise<void> {
700
- // await this.inngestStep.sleep(id, duration);
701
- // }
702
- async executeSleep({
703
- workflowId,
704
- runId,
705
- entry,
706
- prevOutput,
707
- stepResults,
708
- emitter,
709
- abortController,
710
- runtimeContext,
711
- executionContext,
712
- writableStream,
713
- tracingContext
714
- }) {
715
- let { duration, fn } = entry;
716
- const sleepSpan = tracingContext?.currentSpan?.createChildSpan({
717
- type: aiTracing.AISpanType.WORKFLOW_SLEEP,
718
- name: `sleep: ${duration ? `${duration}ms` : "dynamic"}`,
719
- attributes: {
720
- durationMs: duration,
721
- sleepType: fn ? "dynamic" : "fixed"
722
- },
723
- tracingPolicy: this.options?.tracingPolicy
724
- });
725
- if (fn) {
726
- const stepCallId = crypto.randomUUID();
727
- duration = await this.inngestStep.run(`workflow.${workflowId}.sleep.${entry.id}`, async () => {
728
- return await fn({
729
- runId,
730
- workflowId,
731
- mastra: this.mastra,
732
- runtimeContext,
733
- inputData: prevOutput,
734
- state: executionContext.state,
735
- setState: (state) => {
736
- executionContext.state = state;
737
- },
738
- runCount: -1,
739
- tracingContext: {
740
- currentSpan: sleepSpan
741
- },
742
- getInitData: () => stepResults?.input,
743
- getStepResult: workflows.getStepResult.bind(this, stepResults),
744
- // TODO: this function shouldn't have suspend probably?
745
- suspend: async (_suspendPayload) => {
746
- },
747
- bail: () => {
1641
+ let structuredResult = null;
1642
+ const toolData = {
1643
+ name: params.name,
1644
+ args: inputData
1645
+ };
1646
+ let stream;
1647
+ if ((await params.getModel()).specificationVersion === "v1") {
1648
+ const { fullStream } = await params.streamLegacy(inputData.prompt, {
1649
+ ...agentOptions ?? {},
1650
+ requestContext,
1651
+ tracingContext,
1652
+ onFinish: (result) => {
1653
+ const resultWithObject = result;
1654
+ if (agentOptions?.structuredOutput?.schema && resultWithObject.object) {
1655
+ structuredResult = resultWithObject.object;
1656
+ }
1657
+ streamPromise.resolve(result.text);
1658
+ void agentOptions?.onFinish?.(result);
748
1659
  },
749
- abort: () => {
750
- abortController?.abort();
1660
+ abortSignal
1661
+ });
1662
+ stream = fullStream;
1663
+ } else {
1664
+ const modelOutput = await params.stream(inputData.prompt, {
1665
+ ...agentOptions ?? {},
1666
+ requestContext,
1667
+ tracingContext,
1668
+ onFinish: (result) => {
1669
+ const resultWithObject = result;
1670
+ if (agentOptions?.structuredOutput?.schema && resultWithObject.object) {
1671
+ structuredResult = resultWithObject.object;
1672
+ }
1673
+ streamPromise.resolve(result.text);
1674
+ void agentOptions?.onFinish?.(result);
751
1675
  },
752
- [_constants.EMITTER_SYMBOL]: emitter,
753
- // TODO: add streamVNext support
754
- [_constants.STREAM_FORMAT_SYMBOL]: executionContext.format,
755
- engine: { step: this.inngestStep },
756
- abortSignal: abortController?.signal,
757
- writer: new tools.ToolStream(
758
- {
759
- prefix: "workflow-step",
760
- callId: stepCallId,
761
- name: "sleep",
762
- runId
763
- },
764
- writableStream
765
- )
1676
+ abortSignal
766
1677
  });
767
- });
768
- sleepSpan?.update({
769
- attributes: {
770
- durationMs: duration
1678
+ stream = modelOutput.fullStream;
1679
+ }
1680
+ if (streamFormat === "legacy") {
1681
+ await pubsub.publish(`workflow.events.v2.${runId}`, {
1682
+ type: "watch",
1683
+ runId,
1684
+ data: { type: "tool-call-streaming-start", ...toolData ?? {} }
1685
+ });
1686
+ for await (const chunk of stream) {
1687
+ if (chunk.type === "text-delta") {
1688
+ await pubsub.publish(`workflow.events.v2.${runId}`, {
1689
+ type: "watch",
1690
+ runId,
1691
+ data: { type: "tool-call-delta", ...toolData ?? {}, argsTextDelta: chunk.textDelta }
1692
+ });
1693
+ }
771
1694
  }
772
- });
773
- }
774
- try {
775
- await this.inngestStep.sleep(entry.id, !duration || duration < 0 ? 0 : duration);
776
- sleepSpan?.end();
777
- } catch (e) {
778
- sleepSpan?.error({ error: e });
779
- throw e;
780
- }
781
- }
782
- async executeSleepUntil({
783
- workflowId,
784
- runId,
785
- entry,
786
- prevOutput,
787
- stepResults,
788
- emitter,
789
- abortController,
790
- runtimeContext,
791
- executionContext,
792
- writableStream,
793
- tracingContext
794
- }) {
795
- let { date, fn } = entry;
796
- const sleepUntilSpan = tracingContext?.currentSpan?.createChildSpan({
797
- type: aiTracing.AISpanType.WORKFLOW_SLEEP,
798
- name: `sleepUntil: ${date ? date.toISOString() : "dynamic"}`,
799
- attributes: {
800
- untilDate: date,
801
- durationMs: date ? Math.max(0, date.getTime() - Date.now()) : void 0,
802
- sleepType: fn ? "dynamic" : "fixed"
803
- },
804
- tracingPolicy: this.options?.tracingPolicy
805
- });
806
- if (fn) {
807
- date = await this.inngestStep.run(`workflow.${workflowId}.sleepUntil.${entry.id}`, async () => {
808
- const stepCallId = crypto.randomUUID();
809
- return await fn({
1695
+ await pubsub.publish(`workflow.events.v2.${runId}`, {
1696
+ type: "watch",
810
1697
  runId,
811
- workflowId,
812
- mastra: this.mastra,
813
- runtimeContext,
814
- inputData: prevOutput,
815
- state: executionContext.state,
816
- setState: (state) => {
817
- executionContext.state = state;
818
- },
819
- runCount: -1,
820
- tracingContext: {
821
- currentSpan: sleepUntilSpan
822
- },
823
- getInitData: () => stepResults?.input,
824
- getStepResult: workflows.getStepResult.bind(this, stepResults),
825
- // TODO: this function shouldn't have suspend probably?
826
- suspend: async (_suspendPayload) => {
827
- },
828
- bail: () => {
829
- },
830
- abort: () => {
831
- abortController?.abort();
832
- },
833
- [_constants.EMITTER_SYMBOL]: emitter,
834
- [_constants.STREAM_FORMAT_SYMBOL]: executionContext.format,
835
- // TODO: add streamVNext support
836
- engine: { step: this.inngestStep },
837
- abortSignal: abortController?.signal,
838
- writer: new tools.ToolStream(
839
- {
840
- prefix: "workflow-step",
841
- callId: stepCallId,
842
- name: "sleep",
843
- runId
844
- },
845
- writableStream
846
- )
1698
+ data: { type: "tool-call-streaming-finish", ...toolData ?? {} }
847
1699
  });
848
- });
849
- if (date && !(date instanceof Date)) {
850
- date = new Date(date);
1700
+ } else {
1701
+ for await (const chunk of stream) {
1702
+ await writer.write(chunk);
1703
+ }
851
1704
  }
852
- const time = !date ? 0 : date.getTime() - Date.now();
853
- sleepUntilSpan?.update({
854
- attributes: {
855
- durationMs: Math.max(0, time)
1705
+ if (abortSignal.aborted) {
1706
+ return abort();
1707
+ }
1708
+ if (structuredResult !== null) {
1709
+ return structuredResult;
1710
+ }
1711
+ return {
1712
+ text: await streamPromise.promise
1713
+ };
1714
+ },
1715
+ component: params.component
1716
+ };
1717
+ }
1718
+ function createStepFromTool(params, agentOrToolOptions) {
1719
+ const toolOpts = agentOrToolOptions;
1720
+ if (!params.inputSchema || !params.outputSchema) {
1721
+ throw new Error("Tool must have input and output schemas defined");
1722
+ }
1723
+ return {
1724
+ id: params.id,
1725
+ description: params.description,
1726
+ inputSchema: params.inputSchema,
1727
+ outputSchema: params.outputSchema,
1728
+ resumeSchema: params.resumeSchema,
1729
+ suspendSchema: params.suspendSchema,
1730
+ retries: toolOpts?.retries,
1731
+ scorers: toolOpts?.scorers,
1732
+ execute: async ({
1733
+ inputData,
1734
+ mastra,
1735
+ requestContext,
1736
+ tracingContext,
1737
+ suspend,
1738
+ resumeData,
1739
+ runId,
1740
+ workflowId,
1741
+ state,
1742
+ setState
1743
+ }) => {
1744
+ const toolContext = {
1745
+ mastra,
1746
+ requestContext,
1747
+ tracingContext,
1748
+ workflow: {
1749
+ runId,
1750
+ resumeData,
1751
+ suspend,
1752
+ workflowId,
1753
+ state,
1754
+ setState
856
1755
  }
857
- });
858
- }
859
- if (!(date instanceof Date)) {
860
- sleepUntilSpan?.end();
861
- return;
1756
+ };
1757
+ return params.execute(inputData, toolContext);
1758
+ },
1759
+ component: "TOOL"
1760
+ };
1761
+ }
1762
+ function createStepFromProcessor(processor) {
1763
+ const getProcessorEntityType = (phase) => {
1764
+ switch (phase) {
1765
+ case "input":
1766
+ return observability.EntityType.INPUT_PROCESSOR;
1767
+ case "inputStep":
1768
+ return observability.EntityType.INPUT_STEP_PROCESSOR;
1769
+ case "outputStream":
1770
+ case "outputResult":
1771
+ return observability.EntityType.OUTPUT_PROCESSOR;
1772
+ case "outputStep":
1773
+ return observability.EntityType.OUTPUT_STEP_PROCESSOR;
1774
+ default:
1775
+ return observability.EntityType.OUTPUT_PROCESSOR;
862
1776
  }
863
- try {
864
- await this.inngestStep.sleepUntil(entry.id, date);
865
- sleepUntilSpan?.end();
866
- } catch (e) {
867
- sleepUntilSpan?.error({ error: e });
868
- throw e;
1777
+ };
1778
+ const getSpanNamePrefix = (phase) => {
1779
+ switch (phase) {
1780
+ case "input":
1781
+ return "input processor";
1782
+ case "inputStep":
1783
+ return "input step processor";
1784
+ case "outputStream":
1785
+ return "output stream processor";
1786
+ case "outputResult":
1787
+ return "output processor";
1788
+ case "outputStep":
1789
+ return "output step processor";
1790
+ default:
1791
+ return "processor";
869
1792
  }
870
- }
871
- async executeWaitForEvent({ event, timeout }) {
872
- const eventData = await this.inngestStep.waitForEvent(`user-event-${event}`, {
873
- event: `user-event-${event}`,
874
- timeout: timeout ?? 5e3
875
- });
876
- if (eventData === null) {
877
- throw "Timeout waiting for event";
1793
+ };
1794
+ const hasPhaseMethod = (phase) => {
1795
+ switch (phase) {
1796
+ case "input":
1797
+ return !!processor.processInput;
1798
+ case "inputStep":
1799
+ return !!processor.processInputStep;
1800
+ case "outputStream":
1801
+ return !!processor.processOutputStream;
1802
+ case "outputResult":
1803
+ return !!processor.processOutputResult;
1804
+ case "outputStep":
1805
+ return !!processor.processOutputStep;
1806
+ default:
1807
+ return false;
878
1808
  }
879
- return eventData?.data;
880
- }
881
- async executeStep({
882
- step,
883
- stepResults,
884
- executionContext,
885
- resume,
886
- prevOutput,
887
- emitter,
888
- abortController,
889
- runtimeContext,
890
- tracingContext,
891
- writableStream,
892
- disableScorers
893
- }) {
894
- const stepAISpan = tracingContext?.currentSpan?.createChildSpan({
895
- name: `workflow step: '${step.id}'`,
896
- type: aiTracing.AISpanType.WORKFLOW_STEP,
897
- input: prevOutput,
898
- attributes: {
899
- stepId: step.id
900
- },
901
- tracingPolicy: this.options?.tracingPolicy
902
- });
903
- const { inputData, validationError } = await workflows.validateStepInput({
904
- prevOutput,
905
- step,
906
- validateInputs: this.options?.validateInputs ?? false
907
- });
908
- const startedAt = await this.inngestStep.run(
909
- `workflow.${executionContext.workflowId}.run.${executionContext.runId}.step.${step.id}.running_ev`,
910
- async () => {
911
- const startedAt2 = Date.now();
912
- await emitter.emit("watch", {
913
- type: "watch",
914
- payload: {
915
- currentStep: {
916
- id: step.id,
917
- status: "running"
918
- },
919
- workflowState: {
920
- status: "running",
921
- steps: {
922
- ...stepResults,
923
- [step.id]: {
924
- status: "running"
925
- }
926
- },
927
- result: null,
928
- error: null
929
- }
930
- },
931
- eventTimestamp: Date.now()
932
- });
933
- await emitter.emit("watch-v2", {
934
- type: "workflow-step-start",
935
- payload: {
936
- id: step.id,
937
- status: "running",
938
- payload: inputData,
939
- startedAt: startedAt2
940
- }
941
- });
942
- return startedAt2;
1809
+ };
1810
+ return {
1811
+ id: `processor:${processor.id}`,
1812
+ description: processor.name ?? `Processor ${processor.id}`,
1813
+ inputSchema: processors.ProcessorStepSchema,
1814
+ outputSchema: processors.ProcessorStepOutputSchema,
1815
+ execute: async ({ inputData, requestContext, tracingContext }) => {
1816
+ const input = inputData;
1817
+ const {
1818
+ phase,
1819
+ messages,
1820
+ messageList,
1821
+ stepNumber,
1822
+ systemMessages,
1823
+ part,
1824
+ streamParts,
1825
+ state,
1826
+ finishReason,
1827
+ toolCalls,
1828
+ text,
1829
+ retryCount,
1830
+ // inputStep phase fields for model/tools configuration
1831
+ model,
1832
+ tools,
1833
+ toolChoice,
1834
+ activeTools,
1835
+ providerOptions,
1836
+ modelSettings,
1837
+ structuredOutput,
1838
+ steps
1839
+ } = input;
1840
+ const abort = (reason, options) => {
1841
+ throw new agent.TripWire(reason || `Tripwire triggered by ${processor.id}`, options, processor.id);
1842
+ };
1843
+ if (!hasPhaseMethod(phase)) {
1844
+ return input;
943
1845
  }
944
- );
945
- if (step instanceof InngestWorkflow) {
946
- const isResume = !!resume?.steps?.length;
947
- let result;
948
- let runId;
949
- try {
950
- if (isResume) {
951
- runId = stepResults[resume?.steps?.[0]]?.suspendPayload?.__workflow_meta?.runId ?? crypto.randomUUID();
952
- const snapshot = await this.mastra?.getStorage()?.loadWorkflowSnapshot({
953
- workflowName: step.id,
954
- runId
955
- });
956
- const invokeResp = await this.inngestStep.invoke(`workflow.${executionContext.workflowId}.step.${step.id}`, {
957
- function: step.getFunction(),
958
- data: {
959
- inputData,
960
- initialState: executionContext.state ?? snapshot?.value ?? {},
961
- runId,
962
- resume: {
963
- runId,
964
- steps: resume.steps.slice(1),
965
- stepResults: snapshot?.context,
966
- resumePayload: resume.resumePayload,
967
- // @ts-ignore
968
- resumePath: snapshot?.suspendedPaths?.[resume.steps?.[1]]
969
- },
970
- outputOptions: { includeState: true }
971
- }
972
- });
973
- result = invokeResp.result;
974
- runId = invokeResp.runId;
975
- executionContext.state = invokeResp.result.state;
976
- } else {
977
- const invokeResp = await this.inngestStep.invoke(`workflow.${executionContext.workflowId}.step.${step.id}`, {
978
- function: step.getFunction(),
979
- data: {
980
- inputData,
981
- initialState: executionContext.state ?? {},
982
- outputOptions: { includeState: true }
983
- }
984
- });
985
- result = invokeResp.result;
986
- runId = invokeResp.runId;
987
- executionContext.state = invokeResp.result.state;
1846
+ const currentSpan = tracingContext?.currentSpan;
1847
+ const parentSpan = phase === "inputStep" || phase === "outputStep" ? currentSpan?.findParent(observability.SpanType.MODEL_STEP) || currentSpan : currentSpan?.findParent(observability.SpanType.AGENT_RUN) || currentSpan;
1848
+ const processorSpan = phase !== "outputStream" ? parentSpan?.createChildSpan({
1849
+ type: observability.SpanType.PROCESSOR_RUN,
1850
+ name: `${getSpanNamePrefix(phase)}: ${processor.id}`,
1851
+ entityType: getProcessorEntityType(phase),
1852
+ entityId: processor.id,
1853
+ entityName: processor.name ?? processor.id,
1854
+ input: { phase, messageCount: messages?.length },
1855
+ attributes: {
1856
+ processorExecutor: "workflow",
1857
+ // Read processorIndex from processor (set in combineProcessorsIntoWorkflow)
1858
+ processorIndex: processor.processorIndex
988
1859
  }
989
- } catch (e) {
990
- const errorCause = e?.cause;
991
- if (errorCause && typeof errorCause === "object") {
992
- result = errorCause;
993
- runId = errorCause.runId || crypto.randomUUID();
994
- } else {
995
- runId = crypto.randomUUID();
996
- result = {
997
- status: "failed",
998
- error: e instanceof Error ? e : new Error(String(e)),
999
- steps: {},
1000
- input: inputData
1001
- };
1860
+ }) : void 0;
1861
+ const processorTracingContext = processorSpan ? { currentSpan: processorSpan } : tracingContext;
1862
+ const baseContext = {
1863
+ abort,
1864
+ retryCount: retryCount ?? 0,
1865
+ requestContext,
1866
+ tracingContext: processorTracingContext
1867
+ };
1868
+ const passThrough = {
1869
+ phase,
1870
+ // Auto-create MessageList from messages if not provided
1871
+ // This enables running processor workflows from the UI where messageList can't be serialized
1872
+ messageList: messageList ?? (Array.isArray(messages) ? new agent.MessageList().add(messages, "input").addSystem(systemMessages ?? []) : void 0),
1873
+ stepNumber,
1874
+ systemMessages,
1875
+ streamParts,
1876
+ state,
1877
+ finishReason,
1878
+ toolCalls,
1879
+ text,
1880
+ retryCount,
1881
+ // inputStep phase fields for model/tools configuration
1882
+ model,
1883
+ tools,
1884
+ toolChoice,
1885
+ activeTools,
1886
+ providerOptions,
1887
+ modelSettings,
1888
+ structuredOutput,
1889
+ steps
1890
+ };
1891
+ const executePhaseWithSpan = async (fn) => {
1892
+ try {
1893
+ const result = await fn();
1894
+ processorSpan?.end({ output: result });
1895
+ return result;
1896
+ } catch (error) {
1897
+ if (error instanceof agent.TripWire) {
1898
+ processorSpan?.end({ output: { tripwire: error.message } });
1899
+ } else {
1900
+ processorSpan?.error({ error, endSpan: true });
1901
+ }
1902
+ throw error;
1002
1903
  }
1003
- }
1004
- const res = await this.inngestStep.run(
1005
- `workflow.${executionContext.workflowId}.step.${step.id}.nestedwf-results`,
1006
- async () => {
1007
- if (result.status === "failed") {
1008
- await emitter.emit("watch", {
1009
- type: "watch",
1010
- payload: {
1011
- currentStep: {
1012
- id: step.id,
1013
- status: "failed",
1014
- error: result?.error
1015
- },
1016
- workflowState: {
1017
- status: "running",
1018
- steps: stepResults,
1019
- result: null,
1020
- error: null
1021
- }
1022
- },
1023
- eventTimestamp: Date.now()
1024
- });
1025
- await emitter.emit("watch-v2", {
1026
- type: "workflow-step-result",
1027
- payload: {
1028
- id: step.id,
1029
- status: "failed",
1030
- error: result?.error,
1031
- payload: prevOutput
1904
+ };
1905
+ return executePhaseWithSpan(async () => {
1906
+ switch (phase) {
1907
+ case "input": {
1908
+ if (processor.processInput) {
1909
+ if (!passThrough.messageList) {
1910
+ throw new error.MastraError({
1911
+ category: error.ErrorCategory.USER,
1912
+ domain: error.ErrorDomain.MASTRA_WORKFLOW,
1913
+ id: "PROCESSOR_MISSING_MESSAGE_LIST",
1914
+ text: `Processor ${processor.id} requires messageList or messages for processInput phase`
1915
+ });
1032
1916
  }
1033
- });
1034
- return { executionContext, result: { status: "failed", error: result?.error } };
1035
- } else if (result.status === "suspended") {
1036
- const suspendedSteps = Object.entries(result.steps).filter(([_stepName, stepResult]) => {
1037
- const stepRes2 = stepResult;
1038
- return stepRes2?.status === "suspended";
1039
- });
1040
- for (const [stepName, stepResult] of suspendedSteps) {
1041
- const suspendPath = [stepName, ...stepResult?.suspendPayload?.__workflow_meta?.path ?? []];
1042
- executionContext.suspendedPaths[step.id] = executionContext.executionPath;
1043
- await emitter.emit("watch", {
1044
- type: "watch",
1045
- payload: {
1046
- currentStep: {
1047
- id: step.id,
1048
- status: "suspended",
1049
- payload: stepResult.payload,
1050
- suspendPayload: {
1051
- ...stepResult?.suspendPayload,
1052
- __workflow_meta: { runId, path: suspendPath }
1053
- }
1054
- },
1055
- workflowState: {
1056
- status: "running",
1057
- steps: stepResults,
1058
- result: null,
1059
- error: null
1060
- }
1061
- },
1062
- eventTimestamp: Date.now()
1917
+ const idsBeforeProcessing = messages.map((m) => m.id);
1918
+ const check = passThrough.messageList.makeMessageSourceChecker();
1919
+ const result = await processor.processInput({
1920
+ ...baseContext,
1921
+ messages,
1922
+ messageList: passThrough.messageList,
1923
+ systemMessages: systemMessages ?? []
1063
1924
  });
1064
- await emitter.emit("watch-v2", {
1065
- type: "workflow-step-suspended",
1066
- payload: {
1067
- id: step.id,
1068
- status: "suspended"
1925
+ if (result instanceof agent.MessageList) {
1926
+ if (result !== passThrough.messageList) {
1927
+ throw new error.MastraError({
1928
+ category: error.ErrorCategory.USER,
1929
+ domain: error.ErrorDomain.MASTRA_WORKFLOW,
1930
+ id: "PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST",
1931
+ text: `Processor ${processor.id} returned a MessageList instance other than the one passed in. Use the messageList argument instead.`
1932
+ });
1069
1933
  }
1934
+ return {
1935
+ ...passThrough,
1936
+ messages: result.get.all.db(),
1937
+ systemMessages: result.getAllSystemMessages()
1938
+ };
1939
+ } else if (Array.isArray(result)) {
1940
+ processors.ProcessorRunner.applyMessagesToMessageList(
1941
+ result,
1942
+ passThrough.messageList,
1943
+ idsBeforeProcessing,
1944
+ check,
1945
+ "input"
1946
+ );
1947
+ return { ...passThrough, messages: result };
1948
+ } else if (result && "messages" in result && "systemMessages" in result) {
1949
+ const typedResult = result;
1950
+ processors.ProcessorRunner.applyMessagesToMessageList(
1951
+ typedResult.messages,
1952
+ passThrough.messageList,
1953
+ idsBeforeProcessing,
1954
+ check,
1955
+ "input"
1956
+ );
1957
+ passThrough.messageList.replaceAllSystemMessages(typedResult.systemMessages);
1958
+ return {
1959
+ ...passThrough,
1960
+ messages: typedResult.messages,
1961
+ systemMessages: typedResult.systemMessages
1962
+ };
1963
+ }
1964
+ return { ...passThrough, messages };
1965
+ }
1966
+ return { ...passThrough, messages };
1967
+ }
1968
+ case "inputStep": {
1969
+ if (processor.processInputStep) {
1970
+ if (!passThrough.messageList) {
1971
+ throw new error.MastraError({
1972
+ category: error.ErrorCategory.USER,
1973
+ domain: error.ErrorDomain.MASTRA_WORKFLOW,
1974
+ id: "PROCESSOR_MISSING_MESSAGE_LIST",
1975
+ text: `Processor ${processor.id} requires messageList or messages for processInputStep phase`
1976
+ });
1977
+ }
1978
+ const idsBeforeProcessing = messages.map((m) => m.id);
1979
+ const check = passThrough.messageList.makeMessageSourceChecker();
1980
+ const result = await processor.processInputStep({
1981
+ ...baseContext,
1982
+ messages,
1983
+ messageList: passThrough.messageList,
1984
+ stepNumber: stepNumber ?? 0,
1985
+ systemMessages: systemMessages ?? [],
1986
+ // Pass model/tools configuration fields - types match ProcessInputStepArgs
1987
+ model,
1988
+ tools,
1989
+ toolChoice,
1990
+ activeTools,
1991
+ providerOptions,
1992
+ modelSettings,
1993
+ structuredOutput,
1994
+ steps: steps ?? []
1995
+ });
1996
+ const validatedResult = await processors.ProcessorRunner.validateAndFormatProcessInputStepResult(result, {
1997
+ messageList: passThrough.messageList,
1998
+ processor,
1999
+ stepNumber: stepNumber ?? 0
1070
2000
  });
1071
- return {
1072
- executionContext,
1073
- result: {
1074
- status: "suspended",
1075
- payload: stepResult.payload,
1076
- suspendPayload: {
1077
- ...stepResult?.suspendPayload,
1078
- __workflow_meta: { runId, path: suspendPath }
2001
+ if (validatedResult.messages) {
2002
+ processors.ProcessorRunner.applyMessagesToMessageList(
2003
+ validatedResult.messages,
2004
+ passThrough.messageList,
2005
+ idsBeforeProcessing,
2006
+ check
2007
+ );
2008
+ }
2009
+ if (validatedResult.systemMessages) {
2010
+ passThrough.messageList.replaceAllSystemMessages(validatedResult.systemMessages);
2011
+ }
2012
+ return { ...passThrough, messages, ...validatedResult };
2013
+ }
2014
+ return { ...passThrough, messages };
2015
+ }
2016
+ case "outputStream": {
2017
+ if (processor.processOutputStream) {
2018
+ const spanKey = `__outputStreamSpan_${processor.id}`;
2019
+ const mutableState = state ?? {};
2020
+ let processorSpan2 = mutableState[spanKey];
2021
+ if (!processorSpan2 && parentSpan) {
2022
+ processorSpan2 = parentSpan.createChildSpan({
2023
+ type: observability.SpanType.PROCESSOR_RUN,
2024
+ name: `output stream processor: ${processor.id}`,
2025
+ entityType: observability.EntityType.OUTPUT_PROCESSOR,
2026
+ entityId: processor.id,
2027
+ entityName: processor.name ?? processor.id,
2028
+ input: { phase, streamParts: [] },
2029
+ attributes: {
2030
+ processorExecutor: "workflow",
2031
+ processorIndex: processor.processorIndex
1079
2032
  }
2033
+ });
2034
+ mutableState[spanKey] = processorSpan2;
2035
+ }
2036
+ if (processorSpan2) {
2037
+ processorSpan2.input = {
2038
+ phase,
2039
+ streamParts: streamParts ?? [],
2040
+ totalChunks: (streamParts ?? []).length
2041
+ };
2042
+ }
2043
+ const processorTracingContext2 = processorSpan2 ? { currentSpan: processorSpan2 } : baseContext.tracingContext;
2044
+ let result;
2045
+ try {
2046
+ result = await processor.processOutputStream({
2047
+ ...baseContext,
2048
+ tracingContext: processorTracingContext2,
2049
+ part,
2050
+ streamParts: streamParts ?? [],
2051
+ state: mutableState,
2052
+ messageList: passThrough.messageList
2053
+ // Optional for stream processing
2054
+ });
2055
+ if (part && part.type === "finish") {
2056
+ processorSpan2?.end({ output: result });
2057
+ delete mutableState[spanKey];
1080
2058
  }
1081
- };
1082
- }
1083
- await emitter.emit("watch", {
1084
- type: "watch",
1085
- payload: {
1086
- currentStep: {
1087
- id: step.id,
1088
- status: "suspended",
1089
- payload: {}
1090
- },
1091
- workflowState: {
1092
- status: "running",
1093
- steps: stepResults,
1094
- result: null,
1095
- error: null
2059
+ } catch (error) {
2060
+ if (error instanceof agent.TripWire) {
2061
+ processorSpan2?.end({ output: { tripwire: error.message } });
2062
+ } else {
2063
+ processorSpan2?.error({ error, endSpan: true });
1096
2064
  }
1097
- },
1098
- eventTimestamp: Date.now()
1099
- });
1100
- return {
1101
- executionContext,
1102
- result: {
1103
- status: "suspended",
1104
- payload: {}
1105
- }
1106
- };
1107
- }
1108
- await emitter.emit("watch", {
1109
- type: "watch",
1110
- payload: {
1111
- currentStep: {
1112
- id: step.id,
1113
- status: "success",
1114
- output: result?.result
1115
- },
1116
- workflowState: {
1117
- status: "running",
1118
- steps: stepResults,
1119
- result: null,
1120
- error: null
2065
+ delete mutableState[spanKey];
2066
+ throw error;
1121
2067
  }
1122
- },
1123
- eventTimestamp: Date.now()
1124
- });
1125
- await emitter.emit("watch-v2", {
1126
- type: "workflow-step-result",
1127
- payload: {
1128
- id: step.id,
1129
- status: "success",
1130
- output: result?.result
1131
- }
1132
- });
1133
- await emitter.emit("watch-v2", {
1134
- type: "workflow-step-finish",
1135
- payload: {
1136
- id: step.id,
1137
- metadata: {}
2068
+ return { ...passThrough, state: mutableState, part: result };
1138
2069
  }
1139
- });
1140
- return { executionContext, result: { status: "success", output: result?.result } };
1141
- }
1142
- );
1143
- Object.assign(executionContext, res.executionContext);
1144
- return {
1145
- ...res.result,
1146
- startedAt,
1147
- endedAt: Date.now(),
1148
- payload: inputData,
1149
- resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
1150
- resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
1151
- };
1152
- }
1153
- let stepRes;
1154
- try {
1155
- stepRes = await this.inngestStep.run(`workflow.${executionContext.workflowId}.step.${step.id}`, async () => {
1156
- let execResults;
1157
- let suspended;
1158
- let bailed;
1159
- try {
1160
- if (validationError) {
1161
- throw validationError;
2070
+ return { ...passThrough, part };
1162
2071
  }
1163
- const result = await step.execute({
1164
- runId: executionContext.runId,
1165
- mastra: this.mastra,
1166
- runtimeContext,
1167
- writableStream,
1168
- state: executionContext?.state ?? {},
1169
- setState: (state) => {
1170
- executionContext.state = state;
1171
- },
1172
- inputData,
1173
- resumeData: resume?.steps[0] === step.id ? resume?.resumePayload : void 0,
1174
- tracingContext: {
1175
- currentSpan: stepAISpan
1176
- },
1177
- getInitData: () => stepResults?.input,
1178
- getStepResult: workflows.getStepResult.bind(this, stepResults),
1179
- suspend: async (suspendPayload) => {
1180
- executionContext.suspendedPaths[step.id] = executionContext.executionPath;
1181
- suspended = { payload: suspendPayload };
1182
- },
1183
- bail: (result2) => {
1184
- bailed = { payload: result2 };
1185
- },
1186
- resume: {
1187
- steps: resume?.steps?.slice(1) || [],
1188
- resumePayload: resume?.resumePayload,
1189
- // @ts-ignore
1190
- runId: stepResults[step.id]?.suspendPayload?.__workflow_meta?.runId
1191
- },
1192
- [_constants.EMITTER_SYMBOL]: emitter,
1193
- engine: {
1194
- step: this.inngestStep
1195
- },
1196
- abortSignal: abortController.signal
1197
- });
1198
- const endedAt = Date.now();
1199
- execResults = {
1200
- status: "success",
1201
- output: result,
1202
- startedAt,
1203
- endedAt,
1204
- payload: inputData,
1205
- resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
1206
- resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
1207
- };
1208
- } catch (e) {
1209
- const stepFailure = {
1210
- status: "failed",
1211
- payload: inputData,
1212
- error: e instanceof Error ? e.message : String(e),
1213
- endedAt: Date.now(),
1214
- startedAt,
1215
- resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
1216
- resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
1217
- };
1218
- execResults = stepFailure;
1219
- const fallbackErrorMessage = `Step ${step.id} failed`;
1220
- stepAISpan?.error({ error: new Error(execResults.error ?? fallbackErrorMessage) });
1221
- throw new inngest.RetryAfterError(execResults.error ?? fallbackErrorMessage, executionContext.retryConfig.delay, {
1222
- cause: execResults
1223
- });
1224
- }
1225
- if (suspended) {
1226
- execResults = {
1227
- status: "suspended",
1228
- suspendPayload: suspended.payload,
1229
- payload: inputData,
1230
- suspendedAt: Date.now(),
1231
- startedAt,
1232
- resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
1233
- resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
1234
- };
1235
- } else if (bailed) {
1236
- execResults = {
1237
- status: "bailed",
1238
- output: bailed.payload,
1239
- payload: inputData,
1240
- endedAt: Date.now(),
1241
- startedAt
1242
- };
1243
- }
1244
- await emitter.emit("watch", {
1245
- type: "watch",
1246
- payload: {
1247
- currentStep: {
1248
- id: step.id,
1249
- ...execResults
1250
- },
1251
- workflowState: {
1252
- status: "running",
1253
- steps: { ...stepResults, [step.id]: execResults },
1254
- result: null,
1255
- error: null
1256
- }
1257
- },
1258
- eventTimestamp: Date.now()
1259
- });
1260
- if (execResults.status === "suspended") {
1261
- await emitter.emit("watch-v2", {
1262
- type: "workflow-step-suspended",
1263
- payload: {
1264
- id: step.id,
1265
- ...execResults
1266
- }
1267
- });
1268
- } else {
1269
- await emitter.emit("watch-v2", {
1270
- type: "workflow-step-result",
1271
- payload: {
1272
- id: step.id,
1273
- ...execResults
1274
- }
1275
- });
1276
- await emitter.emit("watch-v2", {
1277
- type: "workflow-step-finish",
1278
- payload: {
1279
- id: step.id,
1280
- metadata: {}
2072
+ case "outputResult": {
2073
+ if (processor.processOutputResult) {
2074
+ if (!passThrough.messageList) {
2075
+ throw new error.MastraError({
2076
+ category: error.ErrorCategory.USER,
2077
+ domain: error.ErrorDomain.MASTRA_WORKFLOW,
2078
+ id: "PROCESSOR_MISSING_MESSAGE_LIST",
2079
+ text: `Processor ${processor.id} requires messageList or messages for processOutputResult phase`
2080
+ });
2081
+ }
2082
+ const idsBeforeProcessing = messages.map((m) => m.id);
2083
+ const check = passThrough.messageList.makeMessageSourceChecker();
2084
+ const result = await processor.processOutputResult({
2085
+ ...baseContext,
2086
+ messages,
2087
+ messageList: passThrough.messageList
2088
+ });
2089
+ if (result instanceof agent.MessageList) {
2090
+ if (result !== passThrough.messageList) {
2091
+ throw new error.MastraError({
2092
+ category: error.ErrorCategory.USER,
2093
+ domain: error.ErrorDomain.MASTRA_WORKFLOW,
2094
+ id: "PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST",
2095
+ text: `Processor ${processor.id} returned a MessageList instance other than the one passed in. Use the messageList argument instead.`
2096
+ });
2097
+ }
2098
+ return {
2099
+ ...passThrough,
2100
+ messages: result.get.all.db(),
2101
+ systemMessages: result.getAllSystemMessages()
2102
+ };
2103
+ } else if (Array.isArray(result)) {
2104
+ processors.ProcessorRunner.applyMessagesToMessageList(
2105
+ result,
2106
+ passThrough.messageList,
2107
+ idsBeforeProcessing,
2108
+ check,
2109
+ "response"
2110
+ );
2111
+ return { ...passThrough, messages: result };
2112
+ } else if (result && "messages" in result && "systemMessages" in result) {
2113
+ const typedResult = result;
2114
+ processors.ProcessorRunner.applyMessagesToMessageList(
2115
+ typedResult.messages,
2116
+ passThrough.messageList,
2117
+ idsBeforeProcessing,
2118
+ check,
2119
+ "response"
2120
+ );
2121
+ passThrough.messageList.replaceAllSystemMessages(typedResult.systemMessages);
2122
+ return {
2123
+ ...passThrough,
2124
+ messages: typedResult.messages,
2125
+ systemMessages: typedResult.systemMessages
2126
+ };
2127
+ }
2128
+ return { ...passThrough, messages };
1281
2129
  }
1282
- });
1283
- }
1284
- stepAISpan?.end({ output: execResults });
1285
- return { result: execResults, executionContext, stepResults };
1286
- });
1287
- } catch (e) {
1288
- const stepFailure = e instanceof Error ? e?.cause : {
1289
- status: "failed",
1290
- error: e instanceof Error ? e.message : String(e),
1291
- payload: inputData,
1292
- startedAt,
1293
- endedAt: Date.now()
1294
- };
1295
- stepRes = {
1296
- result: stepFailure,
1297
- executionContext,
1298
- stepResults: {
1299
- ...stepResults,
1300
- [step.id]: stepFailure
1301
- }
1302
- };
1303
- }
1304
- if (disableScorers !== false && stepRes.result.status === "success") {
1305
- await this.inngestStep.run(`workflow.${executionContext.workflowId}.step.${step.id}.score`, async () => {
1306
- if (step.scorers) {
1307
- await this.runScorers({
1308
- scorers: step.scorers,
1309
- runId: executionContext.runId,
1310
- input: inputData,
1311
- output: stepRes.result,
1312
- workflowId: executionContext.workflowId,
1313
- stepId: step.id,
1314
- runtimeContext,
1315
- disableScorers,
1316
- tracingContext: { currentSpan: stepAISpan }
1317
- });
1318
- }
1319
- });
1320
- }
1321
- Object.assign(executionContext.suspendedPaths, stepRes.executionContext.suspendedPaths);
1322
- Object.assign(stepResults, stepRes.stepResults);
1323
- executionContext.state = stepRes.executionContext.state;
1324
- return stepRes.result;
1325
- }
1326
- async persistStepUpdate({
1327
- workflowId,
1328
- runId,
1329
- stepResults,
1330
- resourceId,
1331
- executionContext,
1332
- serializedStepGraph,
1333
- workflowStatus,
1334
- result,
1335
- error
1336
- }) {
1337
- await this.inngestStep.run(
1338
- `workflow.${workflowId}.run.${runId}.path.${JSON.stringify(executionContext.executionPath)}.stepUpdate`,
1339
- async () => {
1340
- const shouldPersistSnapshot = this.options.shouldPersistSnapshot({ stepResults, workflowStatus });
1341
- if (!shouldPersistSnapshot) {
1342
- return;
1343
- }
1344
- await this.mastra?.getStorage()?.persistWorkflowSnapshot({
1345
- workflowName: workflowId,
1346
- runId,
1347
- resourceId,
1348
- snapshot: {
1349
- runId,
1350
- value: executionContext.state,
1351
- context: stepResults,
1352
- activePaths: [],
1353
- suspendedPaths: executionContext.suspendedPaths,
1354
- waitingPaths: {},
1355
- serializedStepGraph,
1356
- status: workflowStatus,
1357
- result,
1358
- error,
1359
- // @ts-ignore
1360
- timestamp: Date.now()
2130
+ return { ...passThrough, messages };
1361
2131
  }
1362
- });
1363
- }
1364
- );
1365
- }
1366
- async executeConditional({
1367
- workflowId,
1368
- runId,
1369
- entry,
1370
- prevOutput,
1371
- prevStep,
1372
- stepResults,
1373
- serializedStepGraph,
1374
- resume,
1375
- executionContext,
1376
- emitter,
1377
- abortController,
1378
- runtimeContext,
1379
- writableStream,
1380
- disableScorers,
1381
- tracingContext
1382
- }) {
1383
- const conditionalSpan = tracingContext?.currentSpan?.createChildSpan({
1384
- type: aiTracing.AISpanType.WORKFLOW_CONDITIONAL,
1385
- name: `conditional: '${entry.conditions.length} conditions'`,
1386
- input: prevOutput,
1387
- attributes: {
1388
- conditionCount: entry.conditions.length
1389
- },
1390
- tracingPolicy: this.options?.tracingPolicy
1391
- });
1392
- let execResults;
1393
- const truthyIndexes = (await Promise.all(
1394
- entry.conditions.map(
1395
- (cond, index) => this.inngestStep.run(`workflow.${workflowId}.conditional.${index}`, async () => {
1396
- const evalSpan = conditionalSpan?.createChildSpan({
1397
- type: aiTracing.AISpanType.WORKFLOW_CONDITIONAL_EVAL,
1398
- name: `condition: '${index}'`,
1399
- input: prevOutput,
1400
- attributes: {
1401
- conditionIndex: index
1402
- },
1403
- tracingPolicy: this.options?.tracingPolicy
1404
- });
1405
- try {
1406
- const result = await cond({
1407
- runId,
1408
- workflowId,
1409
- mastra: this.mastra,
1410
- runtimeContext,
1411
- runCount: -1,
1412
- inputData: prevOutput,
1413
- state: executionContext.state,
1414
- setState: (state) => {
1415
- executionContext.state = state;
1416
- },
1417
- tracingContext: {
1418
- currentSpan: evalSpan
1419
- },
1420
- getInitData: () => stepResults?.input,
1421
- getStepResult: workflows.getStepResult.bind(this, stepResults),
1422
- // TODO: this function shouldn't have suspend probably?
1423
- suspend: async (_suspendPayload) => {
1424
- },
1425
- bail: () => {
1426
- },
1427
- abort: () => {
1428
- abortController.abort();
1429
- },
1430
- [_constants.EMITTER_SYMBOL]: emitter,
1431
- [_constants.STREAM_FORMAT_SYMBOL]: executionContext.format,
1432
- // TODO: add streamVNext support
1433
- engine: {
1434
- step: this.inngestStep
1435
- },
1436
- abortSignal: abortController.signal,
1437
- writer: new tools.ToolStream(
1438
- {
1439
- prefix: "workflow-step",
1440
- callId: crypto.randomUUID(),
1441
- name: "conditional",
1442
- runId
1443
- },
1444
- writableStream
1445
- )
1446
- });
1447
- evalSpan?.end({
1448
- output: result,
1449
- attributes: {
1450
- result: !!result
2132
+ case "outputStep": {
2133
+ if (processor.processOutputStep) {
2134
+ if (!passThrough.messageList) {
2135
+ throw new error.MastraError({
2136
+ category: error.ErrorCategory.USER,
2137
+ domain: error.ErrorDomain.MASTRA_WORKFLOW,
2138
+ id: "PROCESSOR_MISSING_MESSAGE_LIST",
2139
+ text: `Processor ${processor.id} requires messageList or messages for processOutputStep phase`
2140
+ });
1451
2141
  }
1452
- });
1453
- return result ? index : null;
1454
- } catch (e) {
1455
- evalSpan?.error({
1456
- error: e instanceof Error ? e : new Error(String(e)),
1457
- attributes: {
1458
- result: false
2142
+ const idsBeforeProcessing = messages.map((m) => m.id);
2143
+ const check = passThrough.messageList.makeMessageSourceChecker();
2144
+ const result = await processor.processOutputStep({
2145
+ ...baseContext,
2146
+ messages,
2147
+ messageList: passThrough.messageList,
2148
+ stepNumber: stepNumber ?? 0,
2149
+ finishReason,
2150
+ toolCalls,
2151
+ text,
2152
+ systemMessages: systemMessages ?? [],
2153
+ steps: steps ?? []
2154
+ });
2155
+ if (result instanceof agent.MessageList) {
2156
+ if (result !== passThrough.messageList) {
2157
+ throw new error.MastraError({
2158
+ category: error.ErrorCategory.USER,
2159
+ domain: error.ErrorDomain.MASTRA_WORKFLOW,
2160
+ id: "PROCESSOR_RETURNED_EXTERNAL_MESSAGE_LIST",
2161
+ text: `Processor ${processor.id} returned a MessageList instance other than the one passed in. Use the messageList argument instead.`
2162
+ });
2163
+ }
2164
+ return {
2165
+ ...passThrough,
2166
+ messages: result.get.all.db(),
2167
+ systemMessages: result.getAllSystemMessages()
2168
+ };
2169
+ } else if (Array.isArray(result)) {
2170
+ processors.ProcessorRunner.applyMessagesToMessageList(
2171
+ result,
2172
+ passThrough.messageList,
2173
+ idsBeforeProcessing,
2174
+ check,
2175
+ "response"
2176
+ );
2177
+ return { ...passThrough, messages: result };
2178
+ } else if (result && "messages" in result && "systemMessages" in result) {
2179
+ const typedResult = result;
2180
+ processors.ProcessorRunner.applyMessagesToMessageList(
2181
+ typedResult.messages,
2182
+ passThrough.messageList,
2183
+ idsBeforeProcessing,
2184
+ check,
2185
+ "response"
2186
+ );
2187
+ passThrough.messageList.replaceAllSystemMessages(typedResult.systemMessages);
2188
+ return {
2189
+ ...passThrough,
2190
+ messages: typedResult.messages,
2191
+ systemMessages: typedResult.systemMessages
2192
+ };
1459
2193
  }
1460
- });
1461
- return null;
1462
- }
1463
- })
1464
- )
1465
- )).filter((index) => index !== null);
1466
- const stepsToRun = entry.steps.filter((_, index) => truthyIndexes.includes(index));
1467
- conditionalSpan?.update({
1468
- attributes: {
1469
- truthyIndexes,
1470
- selectedSteps: stepsToRun.map((s) => s.type === "step" ? s.step.id : `control-${s.type}`)
1471
- }
1472
- });
1473
- const results = await Promise.all(
1474
- stepsToRun.map(
1475
- (step, index) => this.executeEntry({
1476
- workflowId,
1477
- runId,
1478
- entry: step,
1479
- serializedStepGraph,
1480
- prevStep,
1481
- stepResults,
1482
- resume,
1483
- executionContext: {
1484
- workflowId,
1485
- runId,
1486
- executionPath: [...executionContext.executionPath, index],
1487
- suspendedPaths: executionContext.suspendedPaths,
1488
- retryConfig: executionContext.retryConfig,
1489
- executionSpan: executionContext.executionSpan,
1490
- state: executionContext.state
1491
- },
1492
- emitter,
1493
- abortController,
1494
- runtimeContext,
1495
- writableStream,
1496
- disableScorers,
1497
- tracingContext: {
1498
- currentSpan: conditionalSpan
1499
- }
1500
- })
1501
- )
1502
- );
1503
- const hasFailed = results.find((result) => result.result.status === "failed");
1504
- const hasSuspended = results.find((result) => result.result.status === "suspended");
1505
- if (hasFailed) {
1506
- execResults = { status: "failed", error: hasFailed.result.error };
1507
- } else if (hasSuspended) {
1508
- execResults = { status: "suspended", suspendPayload: hasSuspended.result.suspendPayload };
1509
- } else {
1510
- execResults = {
1511
- status: "success",
1512
- output: results.reduce((acc, result, index) => {
1513
- if (result.result.status === "success") {
1514
- acc[stepsToRun[index].step.id] = result.output;
2194
+ return { ...passThrough, messages };
2195
+ }
2196
+ return { ...passThrough, messages };
1515
2197
  }
1516
- return acc;
1517
- }, {})
1518
- };
1519
- }
1520
- if (execResults.status === "failed") {
1521
- conditionalSpan?.error({
1522
- error: new Error(execResults.error)
2198
+ default:
2199
+ return { ...passThrough, messages };
2200
+ }
1523
2201
  });
1524
- } else {
1525
- conditionalSpan?.end({
1526
- output: execResults.output || execResults
2202
+ },
2203
+ component: "PROCESSOR"
2204
+ };
2205
+ }
2206
+ function init(inngest) {
2207
+ return {
2208
+ createWorkflow(params) {
2209
+ return new InngestWorkflow(
2210
+ params,
2211
+ inngest
2212
+ );
2213
+ },
2214
+ createStep,
2215
+ cloneStep(step, opts) {
2216
+ return {
2217
+ id: opts.id,
2218
+ description: step.description,
2219
+ inputSchema: step.inputSchema,
2220
+ outputSchema: step.outputSchema,
2221
+ resumeSchema: step.resumeSchema,
2222
+ suspendSchema: step.suspendSchema,
2223
+ stateSchema: step.stateSchema,
2224
+ execute: step.execute,
2225
+ retries: step.retries,
2226
+ scorers: step.scorers,
2227
+ component: step.component
2228
+ };
2229
+ },
2230
+ cloneWorkflow(workflow, opts) {
2231
+ const wf = new workflows.Workflow({
2232
+ id: opts.id,
2233
+ inputSchema: workflow.inputSchema,
2234
+ outputSchema: workflow.outputSchema,
2235
+ steps: workflow.stepDefs,
2236
+ mastra: workflow.mastra,
2237
+ options: workflow.options
1527
2238
  });
2239
+ wf.setStepFlow(workflow.stepGraph);
2240
+ wf.commit();
2241
+ return wf;
1528
2242
  }
1529
- return execResults;
1530
- }
1531
- };
2243
+ };
2244
+ }
1532
2245
 
1533
2246
  exports.InngestExecutionEngine = InngestExecutionEngine;
2247
+ exports.InngestPubSub = InngestPubSub;
1534
2248
  exports.InngestRun = InngestRun;
1535
2249
  exports.InngestWorkflow = InngestWorkflow;
2250
+ exports._compatibilityCheck = _compatibilityCheck;
2251
+ exports.createServe = createServe;
1536
2252
  exports.createStep = createStep;
1537
2253
  exports.init = init;
1538
2254
  exports.serve = serve;