@mastra/inngest 0.0.0-cloudflare-deployer-dont-install-deps-20250714111754 → 0.0.0-cloudflare-file-url-lazy-20260130204903

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,33 +1,630 @@
1
1
  'use strict';
2
2
 
3
- var crypto = require('crypto');
4
- var realtime = require('@inngest/realtime');
5
- 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');
6
7
  var tools = require('@mastra/core/tools');
7
8
  var workflows = require('@mastra/core/workflows');
8
9
  var _constants = require('@mastra/core/workflows/_constants');
9
- var hono = require('inngest/hono');
10
10
  var zod = require('zod');
11
+ var crypto$1 = require('crypto');
12
+ var di = require('@mastra/core/di');
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');
18
+ var hono = require('inngest/hono');
11
19
 
12
20
  // src/index.ts
13
- function serve({ mastra, inngest }) {
14
- const wfs = mastra.getWorkflows();
15
- const functions = Array.from(
16
- new Set(
17
- Object.values(wfs).flatMap((wf) => {
18
- if (wf instanceof InngestWorkflow) {
19
- wf.__registerMastra(mastra);
20
- return wf.getFunctions();
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;
28
+ }
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"
43
+ });
44
+ return errorInstance.toJSON();
45
+ }
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));
69
+ }
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
+ };
21
102
  }
22
- return [];
23
- })
24
- )
25
- );
26
- return hono.serve({
27
- client: inngest,
28
- functions
29
- });
30
- }
103
+ }
104
+ }
105
+ return { ok: false, error: { status: "failed", error: new Error("Unknown error"), endedAt: Date.now() } };
106
+ }
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);
112
+ }
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
+ });
147
+ }
148
+ });
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
186
+ });
187
+ return span?.exportSpan();
188
+ });
189
+ if (exportedSpan) {
190
+ const observability = this.mastra?.observability?.getSelectedInstance({});
191
+ return observability?.rebuildSpan(exportedSpan);
192
+ }
193
+ return void 0;
194
+ }
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);
203
+ });
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);
213
+ });
214
+ }
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();
231
+ });
232
+ if (exportedSpan) {
233
+ const observability = this.mastra?.observability?.getSelectedInstance({});
234
+ return observability?.rebuildSpan(exportedSpan);
235
+ }
236
+ return void 0;
237
+ }
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);
246
+ });
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);
256
+ });
257
+ }
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;
359
+ }
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
372
+ };
373
+ }
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
+ }
502
+ });
503
+ return { executionContext, result: { status: "success", output: result?.result, endedAt: Date.now() } };
504
+ }
505
+ );
506
+ Object.assign(executionContext, res.executionContext);
507
+ return {
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
513
+ };
514
+ }
515
+ };
516
+ var InngestPubSub = class extends events.PubSub {
517
+ inngest;
518
+ workflowId;
519
+ publishFn;
520
+ subscriptions = /* @__PURE__ */ new Map();
521
+ constructor(inngest, workflowId, publishFn) {
522
+ super();
523
+ this.inngest = inngest;
524
+ this.workflowId = workflowId;
525
+ this.publishFn = publishFn;
526
+ }
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;
536
+ }
537
+ const match = topic.match(/^workflow\.events\.v2\.(.+)$/);
538
+ if (!match) {
539
+ return;
540
+ }
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);
550
+ }
551
+ }
552
+ /**
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}"
557
+ */
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(
571
+ {
572
+ channel,
573
+ topics: ["watch"],
574
+ app: this.inngest
575
+ },
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
+ }
588
+ );
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
596
+ });
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);
611
+ }
612
+ }
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();
624
+ }
625
+ this.subscriptions.clear();
626
+ }
627
+ };
31
628
  var InngestRun = class extends workflows.Run {
32
629
  inngest;
33
630
  serializedStepGraph;
@@ -39,82 +636,209 @@ var InngestRun = class extends workflows.Run {
39
636
  this.#mastra = params.mastra;
40
637
  }
41
638
  async getRuns(eventId) {
42
- const response = await fetch(`${this.inngest.apiBaseUrl ?? "https://api.inngest.com"}/v1/events/${eventId}/runs`, {
43
- headers: {
44
- Authorization: `Bearer ${process.env.INNGEST_SIGNING_KEY}`
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}`
648
+ }
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
+ }
45
671
  }
46
- });
47
- const json = await response.json();
48
- return json.data;
672
+ }
673
+ throw new inngest.NonRetriableError(`Failed to get runs after ${maxRetries} attempts: ${lastError?.message}`);
49
674
  }
50
- async getRunOutput(eventId) {
51
- let runs = await this.getRuns(eventId);
52
- while (runs?.[0]?.status !== "Completed" || runs?.[0]?.event_id !== eventId) {
53
- await new Promise((resolve) => setTimeout(resolve, 1e3));
54
- runs = await this.getRuns(eventId);
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
+ }
55
694
  if (runs?.[0]?.status === "Failed") {
56
- console.log("run", runs?.[0]);
57
- throw new Error(`Function run ${runs?.[0]?.status}`);
58
- } else if (runs?.[0]?.status === "Cancelled") {
59
- const snapshot = await this.#mastra?.storage?.loadWorkflowSnapshot({
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 })
709
+ }
710
+ }
711
+ };
712
+ }
713
+ if (runs?.[0]?.status === "Cancelled") {
714
+ const snapshot = await workflowsStore?.loadWorkflowSnapshot({
60
715
  workflowName: this.workflowId,
61
716
  runId: this.runId
62
717
  });
63
718
  return { output: { result: { steps: snapshot?.context, status: "canceled" } } };
64
719
  }
720
+ await new Promise((resolve) => setTimeout(resolve, 1e3 + Math.random() * 1e3));
65
721
  }
66
- return runs?.[0];
67
- }
68
- async sendEvent(event, data) {
69
- await this.inngest.send({
70
- name: `user-event-${event}`,
71
- data
72
- });
722
+ throw new inngest.NonRetriableError(`Workflow did not complete within ${maxWaitMs}ms`);
73
723
  }
74
724
  async cancel() {
725
+ const storage = this.#mastra?.getStorage();
75
726
  await this.inngest.send({
76
727
  name: `cancel.workflow.${this.workflowId}`,
77
728
  data: {
78
729
  runId: this.runId
79
730
  }
80
731
  });
81
- const snapshot = await this.#mastra?.storage?.loadWorkflowSnapshot({
732
+ const workflowsStore = await storage?.getStore("workflows");
733
+ const snapshot = await workflowsStore?.loadWorkflowSnapshot({
82
734
  workflowName: this.workflowId,
83
735
  runId: this.runId
84
736
  });
85
737
  if (snapshot) {
86
- await this.#mastra?.storage?.persistWorkflowSnapshot({
738
+ await workflowsStore?.persistWorkflowSnapshot({
87
739
  workflowName: this.workflowId,
88
740
  runId: this.runId,
741
+ resourceId: this.resourceId,
89
742
  snapshot: {
90
743
  ...snapshot,
91
- status: "canceled"
744
+ status: "canceled",
745
+ value: snapshot.value
92
746
  }
93
747
  });
94
748
  }
95
749
  }
96
- async start({
97
- inputData
98
- }) {
99
- await this.#mastra.getStorage()?.persistWorkflowSnapshot({
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({
100
762
  workflowName: this.workflowId,
101
763
  runId: this.runId,
764
+ resourceId: this.resourceId,
102
765
  snapshot: {
103
766
  runId: this.runId,
104
767
  serializedStepGraph: this.serializedStepGraph,
768
+ status: "running",
105
769
  value: {},
106
770
  context: {},
107
771
  activePaths: [],
108
772
  suspendedPaths: {},
109
- timestamp: Date.now(),
110
- status: "running"
773
+ activeStepsPath: {},
774
+ resumeLabels: {},
775
+ waitingPaths: {},
776
+ timestamp: Date.now()
111
777
  }
112
778
  });
779
+ const inputDataToUse = await this._validateInput(args.inputData);
780
+ const initialStateToUse = await this._validateInitialState(args.initialState ?? {});
113
781
  const eventOutput = await this.inngest.send({
114
782
  name: `workflow.${this.workflowId}`,
115
783
  data: {
116
- inputData,
117
- runId: this.runId
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
118
842
  }
119
843
  });
120
844
  const eventId = eventOutput.ids[0];
@@ -123,9 +847,7 @@ var InngestRun = class extends workflows.Run {
123
847
  }
124
848
  const runOutput = await this.getRunOutput(eventId);
125
849
  const result = runOutput?.output?.result;
126
- if (result.status === "failed") {
127
- result.error = new Error(result.error);
128
- }
850
+ this.hydrateFailedResult(result);
129
851
  if (result.status !== "suspended") {
130
852
  this.cleanup?.();
131
853
  }
@@ -143,26 +865,41 @@ var InngestRun = class extends workflows.Run {
143
865
  return p;
144
866
  }
145
867
  async _resume(params) {
146
- const steps = (Array.isArray(params.step) ? params.step : [params.step]).map(
147
- (step) => typeof step === "string" ? step : step?.id
148
- );
149
- const snapshot = await this.#mastra?.storage?.loadWorkflowSnapshot({
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({
150
879
  workflowName: this.workflowId,
151
880
  runId: this.runId
152
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 };
153
887
  const eventOutput = await this.inngest.send({
154
888
  name: `workflow.${this.workflowId}`,
155
889
  data: {
156
- inputData: params.resumeData,
890
+ inputData: resumeDataToUse,
891
+ initialState: snapshot?.value ?? {},
157
892
  runId: this.runId,
893
+ workflowId: this.workflowId,
158
894
  stepResults: snapshot?.context,
159
895
  resume: {
160
896
  steps,
161
897
  stepResults: snapshot?.context,
162
- resumePayload: params.resumeData,
163
- // @ts-ignore
164
- resumePath: snapshot?.suspendedPaths?.[steps?.[0]]
165
- }
898
+ resumePayload: resumeDataToUse,
899
+ resumePath: steps?.[0] ? snapshot?.suspendedPaths?.[steps?.[0]] : void 0
900
+ },
901
+ requestContext: mergedRequestContext,
902
+ perStep: params.perStep
166
903
  }
167
904
  });
168
905
  const eventId = eventOutput.ids[0];
@@ -171,17 +908,108 @@ var InngestRun = class extends workflows.Run {
171
908
  }
172
909
  const runOutput = await this.getRunOutput(eventId);
173
910
  const result = runOutput?.output?.result;
174
- if (result.status === "failed") {
175
- result.error = new Error(result.error);
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");
176
1001
  }
1002
+ const runOutput = await this.getRunOutput(eventId);
1003
+ const result = runOutput?.output?.result;
1004
+ this.hydrateFailedResult(result);
177
1005
  return result;
178
1006
  }
179
- watch(cb, type = "watch") {
1007
+ watch(cb) {
180
1008
  let active = true;
181
1009
  const streamPromise = realtime.subscribe(
182
1010
  {
183
1011
  channel: `workflow:${this.workflowId}:${this.runId}`,
184
- topics: [type],
1012
+ topics: ["watch"],
185
1013
  app: this.inngest
186
1014
  },
187
1015
  (message) => {
@@ -199,16 +1027,34 @@ var InngestRun = class extends workflows.Run {
199
1027
  });
200
1028
  };
201
1029
  }
202
- stream({ inputData, runtimeContext } = {}) {
1030
+ streamLegacy({ inputData, requestContext } = {}) {
203
1031
  const { readable, writable } = new TransformStream();
204
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
+ });
205
1038
  const unwatch = this.watch(async (event) => {
206
1039
  try {
207
- await writer.write(event);
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);
208
1049
  } catch {
209
1050
  }
210
- }, "watch-v2");
1051
+ });
211
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
+ });
212
1058
  unwatch();
213
1059
  try {
214
1060
  await writer.close();
@@ -218,7 +1064,7 @@ var InngestRun = class extends workflows.Run {
218
1064
  writer.releaseLock();
219
1065
  }
220
1066
  };
221
- this.executionResults = this.start({ inputData, runtimeContext }).then((result) => {
1067
+ this.executionResults = this._start({ inputData, requestContext, format: "legacy" }).then((result) => {
222
1068
  if (result.status !== "suspended") {
223
1069
  this.closeStreamAction?.().catch(() => {
224
1070
  });
@@ -230,55 +1076,203 @@ var InngestRun = class extends workflows.Run {
230
1076
  getWorkflowState: () => this.executionResults
231
1077
  };
232
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
+ }
233
1238
  };
1239
+
1240
+ // src/workflow.ts
234
1241
  var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
235
1242
  #mastra;
236
1243
  inngest;
237
1244
  function;
1245
+ cronFunction;
1246
+ flowControlConfig;
1247
+ cronConfig;
238
1248
  constructor(params, inngest) {
239
- super(params);
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;
240
1256
  this.#mastra = params.mastra;
241
1257
  this.inngest = inngest;
242
- }
243
- async getWorkflowRuns(args) {
244
- const storage = this.#mastra?.getStorage();
245
- if (!storage) {
246
- this.logger.debug("Cannot get workflow runs. Mastra engine is not initialized");
247
- return { runs: [], total: 0 };
1258
+ if (cron) {
1259
+ this.cronConfig = { cron, inputData, initialState };
248
1260
  }
249
- return storage.getWorkflowRuns({ workflowName: this.id, ...args ?? {} });
250
1261
  }
251
- async getWorkflowRunById(runId) {
1262
+ async listWorkflowRuns(args) {
252
1263
  const storage = this.#mastra?.getStorage();
253
1264
  if (!storage) {
254
1265
  this.logger.debug("Cannot get workflow runs. Mastra engine is not initialized");
255
- return this.runs.get(runId) ? { ...this.runs.get(runId), workflowName: this.id } : null;
256
- }
257
- const run = await storage.getWorkflowRunById({ runId, workflowName: this.id });
258
- return run ?? (this.runs.get(runId) ? { ...this.runs.get(runId), workflowName: this.id } : null);
259
- }
260
- async getWorkflowRunExecutionResult(runId) {
261
- const storage = this.#mastra?.getStorage();
262
- if (!storage) {
263
- this.logger.debug("Cannot get workflow run execution result. Mastra storage is not initialized");
264
- return null;
265
- }
266
- const run = await storage.getWorkflowRunById({ runId, workflowName: this.id });
267
- if (!run?.snapshot) {
268
- return null;
1266
+ return { runs: [], total: 0 };
269
1267
  }
270
- if (typeof run.snapshot === "string") {
271
- return null;
1268
+ const workflowsStore = await storage.getStore("workflows");
1269
+ if (!workflowsStore) {
1270
+ return { runs: [], total: 0 };
272
1271
  }
273
- return {
274
- status: run.snapshot.status,
275
- result: run.snapshot.result,
276
- error: run.snapshot.error,
277
- payload: run.snapshot.context?.input,
278
- steps: run.snapshot.context
279
- };
1272
+ return workflowsStore.listWorkflowRuns({ workflowName: this.id, ...args ?? {} });
280
1273
  }
281
1274
  __registerMastra(mastra) {
1275
+ super.__registerMastra(mastra);
282
1276
  this.#mastra = mastra;
283
1277
  this.executionEngine.__registerMastra(mastra);
284
1278
  const updateNested = (step) => {
@@ -296,62 +1290,85 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
296
1290
  }
297
1291
  }
298
1292
  }
299
- createRun(options) {
300
- const runIdToUse = options?.runId || crypto.randomUUID();
301
- const run = this.runs.get(runIdToUse) ?? new InngestRun(
302
- {
303
- workflowId: this.id,
304
- runId: runIdToUse,
305
- executionEngine: this.executionEngine,
306
- executionGraph: this.executionGraph,
307
- serializedStepGraph: this.serializedStepGraph,
308
- mastra: this.#mastra,
309
- retryConfig: this.retryConfig,
310
- cleanup: () => this.runs.delete(runIdToUse)
311
- },
312
- this.inngest
313
- );
314
- this.runs.set(runIdToUse, run);
315
- return run;
316
- }
317
- async createRunAsync(options) {
318
- const runIdToUse = options?.runId || crypto.randomUUID();
319
- const run = this.runs.get(runIdToUse) ?? new InngestRun(
1293
+ async createRun(options) {
1294
+ const runIdToUse = options?.runId || crypto$1.randomUUID();
1295
+ const existingInMemoryRun = this.runs.get(runIdToUse);
1296
+ const newRun = new InngestRun(
320
1297
  {
321
1298
  workflowId: this.id,
322
1299
  runId: runIdToUse,
1300
+ resourceId: options?.resourceId,
323
1301
  executionEngine: this.executionEngine,
324
1302
  executionGraph: this.executionGraph,
325
1303
  serializedStepGraph: this.serializedStepGraph,
326
1304
  mastra: this.#mastra,
327
1305
  retryConfig: this.retryConfig,
328
- cleanup: () => this.runs.delete(runIdToUse)
1306
+ cleanup: () => this.runs.delete(runIdToUse),
1307
+ workflowSteps: this.steps,
1308
+ workflowEngineType: this.engineType,
1309
+ validateInputs: this.options.validateInputs
329
1310
  },
330
1311
  this.inngest
331
1312
  );
1313
+ const run = existingInMemoryRun ?? newRun;
332
1314
  this.runs.set(runIdToUse, run);
333
- const workflowSnapshotInStorage = await this.getWorkflowRunExecutionResult(runIdToUse);
334
- if (!workflowSnapshotInStorage) {
335
- await this.mastra?.getStorage()?.persistWorkflowSnapshot({
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({
336
1326
  workflowName: this.id,
337
1327
  runId: runIdToUse,
1328
+ resourceId: options?.resourceId,
338
1329
  snapshot: {
339
1330
  runId: runIdToUse,
340
1331
  status: "pending",
341
1332
  value: {},
342
1333
  context: {},
343
1334
  activePaths: [],
1335
+ activeStepsPath: {},
1336
+ waitingPaths: {},
344
1337
  serializedStepGraph: this.serializedStepGraph,
345
1338
  suspendedPaths: {},
1339
+ resumeLabels: {},
346
1340
  result: void 0,
347
1341
  error: void 0,
348
- // @ts-ignore
349
1342
  timestamp: Date.now()
350
1343
  }
351
1344
  });
352
1345
  }
353
1346
  return run;
354
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
+ }
355
1372
  getFunction() {
356
1373
  if (this.function) {
357
1374
  return this.function;
@@ -359,53 +1376,134 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
359
1376
  this.function = this.inngest.createFunction(
360
1377
  {
361
1378
  id: `workflow.${this.id}`,
362
- // @ts-ignore
363
- retries: this.retryConfig?.attempts ?? 0,
364
- cancelOn: [{ event: `cancel.workflow.${this.id}` }]
1379
+ retries: 0,
1380
+ cancelOn: [{ event: `cancel.workflow.${this.id}` }],
1381
+ // Spread flow control configuration
1382
+ ...this.flowControlConfig
365
1383
  },
366
1384
  { event: `workflow.${this.id}` },
367
1385
  async ({ event, step, attempt, publish }) => {
368
- let { inputData, runId, resume } = event.data;
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;
369
1398
  if (!runId) {
370
1399
  runId = await step.run(`workflow.${this.id}.runIdGen`, async () => {
371
- return crypto.randomUUID();
1400
+ return crypto$1.randomUUID();
372
1401
  });
373
1402
  }
374
- const emitter = {
375
- emit: async (event2, data) => {
376
- if (!publish) {
377
- return;
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
+ }
378
1463
  }
379
- try {
380
- await publish({
381
- channel: `workflow:${this.id}:${runId}`,
382
- topic: event2,
383
- data
384
- });
385
- } catch (err) {
386
- this.logger.error("Error emitting event: " + (err?.stack ?? err?.message ?? err));
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
+ }
387
1499
  }
388
- },
389
- on: (_event, _callback) => {
390
- },
391
- off: (_event, _callback) => {
392
- },
393
- once: (_event, _callback) => {
394
1500
  }
395
- };
396
- const engine = new InngestExecutionEngine(this.#mastra, step, attempt);
397
- const result = await engine.execute({
398
- workflowId: this.id,
399
- runId,
400
- graph: this.executionGraph,
401
- serializedStepGraph: this.serializedStepGraph,
402
- input: inputData,
403
- emitter,
404
- retryConfig: this.retryConfig,
405
- runtimeContext: new di.RuntimeContext(),
406
- // TODO
407
- resume,
408
- abortController: new AbortController()
1501
+ if (result.status === "failed") {
1502
+ throw new inngest.NonRetriableError(`Workflow failed`, {
1503
+ cause: result
1504
+ });
1505
+ }
1506
+ return result;
409
1507
  });
410
1508
  return { result, runId };
411
1509
  }
@@ -426,833 +1524,733 @@ var InngestWorkflow = class _InngestWorkflow extends workflows.Workflow {
426
1524
  });
427
1525
  }
428
1526
  getFunctions() {
429
- 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
+ ];
430
1532
  }
431
1533
  };
432
- function isAgent(params) {
433
- 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;
1567
+ }
1568
+ function isAgent(input) {
1569
+ return input instanceof agent.Agent;
1570
+ }
1571
+ function isToolStep(input) {
1572
+ return input instanceof tools.Tool;
434
1573
  }
435
- function isTool(params) {
436
- return params instanceof tools.Tool;
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);
437
1576
  }
438
- function createStep(params) {
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
+ }
439
1584
  if (isAgent(params)) {
440
- return {
441
- id: params.name,
442
- // @ts-ignore
443
- inputSchema: zod.z.object({
444
- prompt: zod.z.string()
445
- // resourceId: z.string().optional(),
446
- // threadId: z.string().optional(),
447
- }),
448
- // @ts-ignore
449
- outputSchema: zod.z.object({
450
- text: zod.z.string()
451
- }),
452
- execute: async ({ inputData, [_constants.EMITTER_SYMBOL]: emitter, runtimeContext, abortSignal, abort }) => {
453
- let streamPromise = {};
454
- streamPromise.promise = new Promise((resolve, reject) => {
455
- streamPromise.resolve = resolve;
456
- streamPromise.reject = reject;
457
- });
458
- const toolData = {
459
- name: params.name,
460
- args: inputData
461
- };
462
- await emitter.emit("watch-v2", {
463
- type: "tool-call-streaming-start",
464
- ...toolData
465
- });
466
- const { fullStream } = await params.stream(inputData.prompt, {
467
- // resourceId: inputData.resourceId,
468
- // threadId: inputData.threadId,
469
- runtimeContext,
470
- onFinish: (result) => {
471
- streamPromise.resolve(result.text);
472
- },
473
- abortSignal
474
- });
475
- if (abortSignal.aborted) {
476
- return abort();
477
- }
478
- for await (const chunk of fullStream) {
479
- switch (chunk.type) {
480
- case "text-delta":
481
- await emitter.emit("watch-v2", {
482
- type: "tool-call-delta",
483
- ...toolData,
484
- argsTextDelta: chunk.textDelta
485
- });
486
- break;
487
- case "step-start":
488
- case "step-finish":
489
- case "finish":
490
- break;
491
- case "tool-call":
492
- case "tool-result":
493
- case "tool-call-streaming-start":
494
- case "tool-call-delta":
495
- case "source":
496
- case "file":
497
- default:
498
- await emitter.emit("watch-v2", chunk);
499
- break;
500
- }
501
- }
502
- return {
503
- text: await streamPromise.promise
504
- };
505
- }
506
- };
1585
+ return createStepFromAgent(params, agentOrToolOptions);
507
1586
  }
508
- if (isTool(params)) {
509
- if (!params.inputSchema || !params.outputSchema) {
510
- throw new Error("Tool must have input and output schemas defined");
511
- }
512
- return {
513
- // TODO: tool probably should have strong id type
514
- // @ts-ignore
515
- id: params.id,
516
- inputSchema: params.inputSchema,
517
- outputSchema: params.outputSchema,
518
- execute: async ({ inputData, mastra, runtimeContext }) => {
519
- return params.execute({
520
- context: inputData,
521
- mastra,
522
- runtimeContext
523
- });
524
- }
525
- };
1587
+ if (isToolStep(params)) {
1588
+ return createStepFromTool(params, agentOrToolOptions);
526
1589
  }
1590
+ if (isStepParams(params)) {
1591
+ return createStepFromParams(params);
1592
+ }
1593
+ if (isProcessor(params)) {
1594
+ return createStepFromProcessor(params);
1595
+ }
1596
+ throw new Error("Invalid input: expected StepParams, Agent, ToolStep, Processor, or InngestWorkflow");
1597
+ }
1598
+ function createStepFromParams(params) {
527
1599
  return {
528
1600
  id: params.id,
529
1601
  description: params.description,
530
1602
  inputSchema: params.inputSchema,
1603
+ stateSchema: params.stateSchema,
531
1604
  outputSchema: params.outputSchema,
532
1605
  resumeSchema: params.resumeSchema,
533
1606
  suspendSchema: params.suspendSchema,
534
- execute: params.execute
1607
+ scorers: params.scorers,
1608
+ retries: params.retries,
1609
+ execute: params.execute.bind(params)
535
1610
  };
536
1611
  }
537
- 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 ?? {};
538
1616
  return {
539
- createWorkflow(params) {
540
- return new InngestWorkflow(params, inngest);
541
- },
542
- createStep,
543
- cloneStep(step, opts) {
544
- return {
545
- id: opts.id,
546
- description: step.description,
547
- inputSchema: step.inputSchema,
548
- outputSchema: step.outputSchema,
549
- execute: step.execute
550
- };
551
- },
552
- cloneWorkflow(workflow, opts) {
553
- const wf = new workflows.Workflow({
554
- id: opts.id,
555
- inputSchema: workflow.inputSchema,
556
- outputSchema: workflow.outputSchema,
557
- steps: workflow.stepDefs,
558
- mastra: workflow.mastra
559
- });
560
- wf.setStepFlow(workflow.stepGraph);
561
- wf.commit();
562
- return wf;
563
- }
564
- };
565
- }
566
- var InngestExecutionEngine = class extends workflows.DefaultExecutionEngine {
567
- inngestStep;
568
- inngestAttempts;
569
- constructor(mastra, inngestStep, inngestAttempts = 0) {
570
- super({ mastra });
571
- this.inngestStep = inngestStep;
572
- this.inngestAttempts = inngestAttempts;
573
- }
574
- async execute(params) {
575
- await params.emitter.emit("watch-v2", {
576
- type: "start",
577
- payload: { runId: params.runId }
578
- });
579
- const result = await super.execute(params);
580
- await params.emitter.emit("watch-v2", {
581
- type: "finish",
582
- payload: { runId: params.runId }
583
- });
584
- return result;
585
- }
586
- async fmtReturnValue(executionSpan, emitter, stepResults, lastOutput, error) {
587
- const base = {
588
- status: lastOutput.status,
589
- steps: stepResults
590
- };
591
- if (lastOutput.status === "success") {
592
- await emitter.emit("watch", {
593
- type: "watch",
594
- payload: {
595
- workflowState: {
596
- status: lastOutput.status,
597
- steps: stepResults,
598
- result: lastOutput.output
599
- }
600
- },
601
- eventTimestamp: Date.now()
602
- });
603
- base.result = lastOutput.output;
604
- } else if (lastOutput.status === "failed") {
605
- base.error = error instanceof Error ? error?.stack ?? error.message : lastOutput?.error instanceof Error ? lastOutput.error.message : lastOutput.error ?? error ?? "Unknown error";
606
- await emitter.emit("watch", {
607
- type: "watch",
608
- payload: {
609
- workflowState: {
610
- status: lastOutput.status,
611
- steps: stepResults,
612
- result: null,
613
- error: base.error
614
- }
615
- },
616
- eventTimestamp: Date.now()
617
- });
618
- } else if (lastOutput.status === "suspended") {
619
- await emitter.emit("watch", {
620
- type: "watch",
621
- payload: {
622
- workflowState: {
623
- status: lastOutput.status,
624
- steps: stepResults,
625
- result: null,
626
- error: null
627
- }
628
- },
629
- eventTimestamp: Date.now()
630
- });
631
- const suspendedStepIds = Object.entries(stepResults).flatMap(([stepId, stepResult]) => {
632
- if (stepResult?.status === "suspended") {
633
- const nestedPath = stepResult?.payload?.__workflow_meta?.path;
634
- return nestedPath ? [[stepId, ...nestedPath]] : [[stepId]];
635
- }
636
- return [];
637
- });
638
- base.suspended = suspendedStepIds;
639
- }
640
- executionSpan?.end();
641
- return base;
642
- }
643
- async superExecuteStep({
644
- workflowId,
645
- runId,
646
- step,
647
- stepResults,
648
- executionContext,
649
- resume,
650
- prevOutput,
651
- emitter,
652
- abortController,
653
- runtimeContext
654
- }) {
655
- return super.executeStep({
656
- workflowId,
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,
657
1627
  runId,
658
- step,
659
- stepResults,
660
- executionContext,
661
- resume,
662
- prevOutput,
663
- emitter,
664
- abortController,
665
- runtimeContext
666
- });
667
- }
668
- // async executeSleep({ id, duration }: { id: string; duration: number }): Promise<void> {
669
- // await this.inngestStep.sleep(id, duration);
670
- // }
671
- async executeSleep({
672
- workflowId,
673
- runId,
674
- entry,
675
- prevOutput,
676
- stepResults,
677
- emitter,
678
- abortController,
679
- runtimeContext
680
- }) {
681
- let { duration, fn } = entry;
682
- if (fn) {
683
- duration = await this.inngestStep.run(`workflow.${workflowId}.sleep.${entry.id}`, async () => {
684
- return await fn({
685
- runId,
686
- mastra: this.mastra,
687
- runtimeContext,
688
- inputData: prevOutput,
689
- runCount: -1,
690
- getInitData: () => stepResults?.input,
691
- getStepResult: (step) => {
692
- if (!step?.id) {
693
- return null;
694
- }
695
- const result = stepResults[step.id];
696
- if (result?.status === "success") {
697
- return result.output;
698
- }
699
- return null;
700
- },
701
- // TODO: this function shouldn't have suspend probably?
702
- suspend: async (_suspendPayload) => {
703
- },
704
- bail: () => {
705
- },
706
- abort: () => {
707
- abortController?.abort();
708
- },
709
- [_constants.EMITTER_SYMBOL]: emitter,
710
- engine: { step: this.inngestStep },
711
- abortSignal: abortController?.signal
712
- });
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;
713
1640
  });
714
- }
715
- await this.inngestStep.sleep(entry.id, !duration || duration < 0 ? 0 : duration);
716
- }
717
- async executeSleepUntil({
718
- workflowId,
719
- runId,
720
- entry,
721
- prevOutput,
722
- stepResults,
723
- emitter,
724
- abortController,
725
- runtimeContext
726
- }) {
727
- let { date, fn } = entry;
728
- if (fn) {
729
- date = await this.inngestStep.run(`workflow.${workflowId}.sleepUntil.${entry.id}`, async () => {
730
- return await fn({
731
- runId,
732
- mastra: this.mastra,
733
- runtimeContext,
734
- inputData: prevOutput,
735
- runCount: -1,
736
- getInitData: () => stepResults?.input,
737
- getStepResult: (step) => {
738
- if (!step?.id) {
739
- return null;
740
- }
741
- const result = stepResults[step.id];
742
- if (result?.status === "success") {
743
- return result.output;
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;
744
1656
  }
745
- return null;
746
- },
747
- // TODO: this function shouldn't have suspend probably?
748
- suspend: async (_suspendPayload) => {
749
- },
750
- bail: () => {
751
- },
752
- abort: () => {
753
- abortController?.abort();
1657
+ streamPromise.resolve(result.text);
1658
+ void agentOptions?.onFinish?.(result);
754
1659
  },
755
- [_constants.EMITTER_SYMBOL]: emitter,
756
- engine: { step: this.inngestStep },
757
- abortSignal: abortController?.signal
1660
+ abortSignal
758
1661
  });
759
- });
760
- }
761
- if (!(date instanceof Date)) {
762
- return;
763
- }
764
- await this.inngestStep.sleepUntil(entry.id, date);
765
- }
766
- async executeWaitForEvent({ event, timeout }) {
767
- const eventData = await this.inngestStep.waitForEvent(`user-event-${event}`, {
768
- event: `user-event-${event}`,
769
- timeout: timeout ?? 5e3
770
- });
771
- if (eventData === null) {
772
- throw "Timeout waiting for event";
773
- }
774
- return eventData?.data;
775
- }
776
- async executeStep({
777
- step,
778
- stepResults,
779
- executionContext,
780
- resume,
781
- prevOutput,
782
- emitter,
783
- abortController,
784
- runtimeContext
785
- }) {
786
- const startedAt = await this.inngestStep.run(
787
- `workflow.${executionContext.workflowId}.run.${executionContext.runId}.step.${step.id}.running_ev`,
788
- async () => {
789
- const startedAt2 = Date.now();
790
- await emitter.emit("watch", {
791
- type: "watch",
792
- payload: {
793
- currentStep: {
794
- id: step.id,
795
- status: "running"
796
- },
797
- workflowState: {
798
- status: "running",
799
- steps: {
800
- ...stepResults,
801
- [step.id]: {
802
- status: "running"
803
- }
804
- },
805
- result: null,
806
- error: null
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;
807
1672
  }
1673
+ streamPromise.resolve(result.text);
1674
+ void agentOptions?.onFinish?.(result);
808
1675
  },
809
- eventTimestamp: Date.now()
810
- });
811
- await emitter.emit("watch-v2", {
812
- type: "step-start",
813
- payload: {
814
- id: step.id,
815
- status: "running",
816
- payload: prevOutput,
817
- startedAt: startedAt2
818
- }
1676
+ abortSignal
819
1677
  });
820
- return startedAt2;
1678
+ stream = modelOutput.fullStream;
821
1679
  }
822
- );
823
- if (step instanceof InngestWorkflow) {
824
- const isResume = !!resume?.steps?.length;
825
- let result;
826
- let runId;
827
- if (isResume) {
828
- runId = stepResults[resume?.steps?.[0]]?.payload?.__workflow_meta?.runId ?? crypto.randomUUID();
829
- const snapshot = await this.mastra?.getStorage()?.loadWorkflowSnapshot({
830
- workflowName: step.id,
831
- runId
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 ?? {} }
832
1685
  });
833
- const invokeResp = await this.inngestStep.invoke(`workflow.${executionContext.workflowId}.step.${step.id}`, {
834
- function: step.getFunction(),
835
- data: {
836
- inputData: prevOutput,
837
- runId,
838
- resume: {
1686
+ for await (const chunk of stream) {
1687
+ if (chunk.type === "text-delta") {
1688
+ await pubsub.publish(`workflow.events.v2.${runId}`, {
1689
+ type: "watch",
839
1690
  runId,
840
- steps: resume.steps.slice(1),
841
- stepResults: snapshot?.context,
842
- resumePayload: resume.resumePayload,
843
- // @ts-ignore
844
- resumePath: snapshot?.suspendedPaths?.[resume.steps?.[1]]
845
- }
1691
+ data: { type: "tool-call-delta", ...toolData ?? {}, argsTextDelta: chunk.textDelta }
1692
+ });
846
1693
  }
1694
+ }
1695
+ await pubsub.publish(`workflow.events.v2.${runId}`, {
1696
+ type: "watch",
1697
+ runId,
1698
+ data: { type: "tool-call-streaming-finish", ...toolData ?? {} }
847
1699
  });
848
- result = invokeResp.result;
849
- runId = invokeResp.runId;
850
1700
  } else {
851
- const invokeResp = await this.inngestStep.invoke(`workflow.${executionContext.workflowId}.step.${step.id}`, {
852
- function: step.getFunction(),
853
- data: {
854
- inputData: prevOutput
855
- }
856
- });
857
- result = invokeResp.result;
858
- runId = invokeResp.runId;
1701
+ for await (const chunk of stream) {
1702
+ await writer.write(chunk);
1703
+ }
859
1704
  }
860
- const res = await this.inngestStep.run(
861
- `workflow.${executionContext.workflowId}.step.${step.id}.nestedwf-results`,
862
- async () => {
863
- if (result.status === "failed") {
864
- await emitter.emit("watch", {
865
- type: "watch",
866
- payload: {
867
- currentStep: {
868
- id: step.id,
869
- status: "failed",
870
- error: result?.error
871
- },
872
- workflowState: {
873
- status: "running",
874
- steps: stepResults,
875
- result: null,
876
- error: null
877
- }
878
- },
879
- eventTimestamp: Date.now()
880
- });
881
- await emitter.emit("watch-v2", {
882
- type: "step-result",
883
- payload: {
884
- id: step.id,
885
- status: "failed",
886
- error: result?.error,
887
- payload: prevOutput
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
1755
+ }
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;
1776
+ }
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";
1792
+ }
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;
1808
+ }
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;
1845
+ }
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
1859
+ }
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;
1903
+ }
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
+ });
888
1916
  }
889
- });
890
- return { executionContext, result: { status: "failed", error: result?.error } };
891
- } else if (result.status === "suspended") {
892
- const suspendedSteps = Object.entries(result.steps).filter(([_stepName, stepResult]) => {
893
- const stepRes2 = stepResult;
894
- return stepRes2?.status === "suspended";
895
- });
896
- for (const [stepName, stepResult] of suspendedSteps) {
897
- const suspendPath = [stepName, ...stepResult?.payload?.__workflow_meta?.path ?? []];
898
- executionContext.suspendedPaths[step.id] = executionContext.executionPath;
899
- await emitter.emit("watch", {
900
- type: "watch",
901
- payload: {
902
- currentStep: {
903
- id: step.id,
904
- status: "suspended",
905
- payload: { ...stepResult?.payload, __workflow_meta: { runId, path: suspendPath } }
906
- },
907
- workflowState: {
908
- status: "running",
909
- steps: stepResults,
910
- result: null,
911
- error: null
912
- }
913
- },
914
- 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 ?? []
915
1924
  });
916
- await emitter.emit("watch-v2", {
917
- type: "step-suspended",
918
- payload: {
919
- id: step.id,
920
- 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
+ });
921
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 ?? []
922
1995
  });
923
- return {
924
- executionContext,
925
- result: {
926
- status: "suspended",
927
- payload: { ...stepResult?.payload, __workflow_meta: { runId, path: suspendPath } }
928
- }
929
- };
1996
+ const validatedResult = await processors.ProcessorRunner.validateAndFormatProcessInputStepResult(result, {
1997
+ messageList: passThrough.messageList,
1998
+ processor,
1999
+ stepNumber: stepNumber ?? 0
2000
+ });
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 };
930
2013
  }
931
- await emitter.emit("watch", {
932
- type: "watch",
933
- payload: {
934
- currentStep: {
935
- id: step.id,
936
- status: "suspended",
937
- payload: {}
938
- },
939
- workflowState: {
940
- status: "running",
941
- steps: stepResults,
942
- result: null,
943
- error: null
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
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];
944
2058
  }
945
- },
946
- eventTimestamp: Date.now()
947
- });
948
- return {
949
- executionContext,
950
- result: {
951
- status: "suspended",
952
- payload: {}
2059
+ } catch (error) {
2060
+ if (error instanceof agent.TripWire) {
2061
+ processorSpan2?.end({ output: { tripwire: error.message } });
2062
+ } else {
2063
+ processorSpan2?.error({ error, endSpan: true });
2064
+ }
2065
+ delete mutableState[spanKey];
2066
+ throw error;
953
2067
  }
954
- };
2068
+ return { ...passThrough, state: mutableState, part: result };
2069
+ }
2070
+ return { ...passThrough, part };
955
2071
  }
956
- await emitter.emit("watch", {
957
- type: "watch",
958
- payload: {
959
- currentStep: {
960
- id: step.id,
961
- status: "success",
962
- output: result?.result
963
- },
964
- workflowState: {
965
- status: "running",
966
- steps: stepResults,
967
- result: null,
968
- error: null
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
+ });
969
2081
  }
970
- },
971
- eventTimestamp: Date.now()
972
- });
973
- await emitter.emit("watch-v2", {
974
- type: "step-result",
975
- payload: {
976
- id: step.id,
977
- status: "success",
978
- output: result?.result
979
- }
980
- });
981
- await emitter.emit("watch-v2", {
982
- type: "step-finish",
983
- payload: {
984
- id: step.id,
985
- metadata: {}
986
- }
987
- });
988
- return { executionContext, result: { status: "success", output: result?.result } };
989
- }
990
- );
991
- Object.assign(executionContext, res.executionContext);
992
- return res.result;
993
- }
994
- const stepRes = await this.inngestStep.run(`workflow.${executionContext.workflowId}.step.${step.id}`, async () => {
995
- let execResults;
996
- let suspended;
997
- let bailed;
998
- try {
999
- const result = await step.execute({
1000
- runId: executionContext.runId,
1001
- mastra: this.mastra,
1002
- runtimeContext,
1003
- inputData: prevOutput,
1004
- resumeData: resume?.steps[0] === step.id ? resume?.resumePayload : void 0,
1005
- getInitData: () => stepResults?.input,
1006
- getStepResult: (step2) => {
1007
- const result2 = stepResults[step2.id];
1008
- if (result2?.status === "success") {
1009
- return result2.output;
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 };
1010
2129
  }
1011
- return null;
1012
- },
1013
- suspend: async (suspendPayload) => {
1014
- executionContext.suspendedPaths[step.id] = executionContext.executionPath;
1015
- suspended = { payload: suspendPayload };
1016
- },
1017
- bail: (result2) => {
1018
- bailed = { payload: result2 };
1019
- },
1020
- resume: {
1021
- steps: resume?.steps?.slice(1) || [],
1022
- resumePayload: resume?.resumePayload,
1023
- // @ts-ignore
1024
- runId: stepResults[step.id]?.payload?.__workflow_meta?.runId
1025
- },
1026
- [_constants.EMITTER_SYMBOL]: emitter,
1027
- engine: {
1028
- step: this.inngestStep
1029
- },
1030
- abortSignal: abortController.signal
1031
- });
1032
- const endedAt = Date.now();
1033
- execResults = {
1034
- status: "success",
1035
- output: result,
1036
- startedAt,
1037
- endedAt,
1038
- payload: prevOutput,
1039
- resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
1040
- resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
1041
- };
1042
- } catch (e) {
1043
- execResults = {
1044
- status: "failed",
1045
- payload: prevOutput,
1046
- error: e instanceof Error ? e.message : String(e),
1047
- endedAt: Date.now(),
1048
- startedAt,
1049
- resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
1050
- resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
1051
- };
1052
- }
1053
- if (suspended) {
1054
- execResults = {
1055
- status: "suspended",
1056
- suspendedPayload: suspended.payload,
1057
- payload: prevOutput,
1058
- suspendedAt: Date.now(),
1059
- startedAt,
1060
- resumedAt: resume?.steps[0] === step.id ? startedAt : void 0,
1061
- resumePayload: resume?.steps[0] === step.id ? resume?.resumePayload : void 0
1062
- };
1063
- } else if (bailed) {
1064
- execResults = { status: "bailed", output: bailed.payload, payload: prevOutput, endedAt: Date.now(), startedAt };
1065
- }
1066
- if (execResults.status === "failed") {
1067
- if (executionContext.retryConfig.attempts > 0 && this.inngestAttempts < executionContext.retryConfig.attempts) {
1068
- throw execResults.error;
1069
- }
1070
- }
1071
- await emitter.emit("watch", {
1072
- type: "watch",
1073
- payload: {
1074
- currentStep: {
1075
- id: step.id,
1076
- ...execResults
1077
- },
1078
- workflowState: {
1079
- status: "running",
1080
- steps: { ...stepResults, [step.id]: execResults },
1081
- result: null,
1082
- error: null
1083
- }
1084
- },
1085
- eventTimestamp: Date.now()
1086
- });
1087
- if (execResults.status === "suspended") {
1088
- await emitter.emit("watch-v2", {
1089
- type: "step-suspended",
1090
- payload: {
1091
- id: step.id,
1092
- ...execResults
1093
- }
1094
- });
1095
- } else {
1096
- await emitter.emit("watch-v2", {
1097
- type: "step-result",
1098
- payload: {
1099
- id: step.id,
1100
- ...execResults
1101
- }
1102
- });
1103
- await emitter.emit("watch-v2", {
1104
- type: "step-finish",
1105
- payload: {
1106
- id: step.id,
1107
- metadata: {}
1108
- }
1109
- });
1110
- }
1111
- return { result: execResults, executionContext, stepResults };
1112
- });
1113
- Object.assign(executionContext.suspendedPaths, stepRes.executionContext.suspendedPaths);
1114
- Object.assign(stepResults, stepRes.stepResults);
1115
- return stepRes.result;
1116
- }
1117
- async persistStepUpdate({
1118
- workflowId,
1119
- runId,
1120
- stepResults,
1121
- executionContext,
1122
- serializedStepGraph,
1123
- workflowStatus,
1124
- result,
1125
- error
1126
- }) {
1127
- await this.inngestStep.run(
1128
- `workflow.${workflowId}.run.${runId}.path.${JSON.stringify(executionContext.executionPath)}.stepUpdate`,
1129
- async () => {
1130
- await this.mastra?.getStorage()?.persistWorkflowSnapshot({
1131
- workflowName: workflowId,
1132
- runId,
1133
- snapshot: {
1134
- runId,
1135
- value: {},
1136
- context: stepResults,
1137
- activePaths: [],
1138
- suspendedPaths: executionContext.suspendedPaths,
1139
- serializedStepGraph,
1140
- status: workflowStatus,
1141
- result,
1142
- error,
1143
- // @ts-ignore
1144
- timestamp: Date.now()
2130
+ return { ...passThrough, messages };
1145
2131
  }
1146
- });
1147
- }
1148
- );
1149
- }
1150
- async executeConditional({
1151
- workflowId,
1152
- runId,
1153
- entry,
1154
- prevOutput,
1155
- prevStep,
1156
- stepResults,
1157
- serializedStepGraph,
1158
- resume,
1159
- executionContext,
1160
- emitter,
1161
- abortController,
1162
- runtimeContext
1163
- }) {
1164
- let execResults;
1165
- const truthyIndexes = (await Promise.all(
1166
- entry.conditions.map(
1167
- (cond, index) => this.inngestStep.run(`workflow.${workflowId}.conditional.${index}`, async () => {
1168
- try {
1169
- const result = await cond({
1170
- runId,
1171
- mastra: this.mastra,
1172
- runtimeContext,
1173
- runCount: -1,
1174
- inputData: prevOutput,
1175
- getInitData: () => stepResults?.input,
1176
- getStepResult: (step) => {
1177
- if (!step?.id) {
1178
- return null;
1179
- }
1180
- const result2 = stepResults[step.id];
1181
- if (result2?.status === "success") {
1182
- return result2.output;
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
+ });
2141
+ }
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
+ });
1183
2163
  }
1184
- return null;
1185
- },
1186
- // TODO: this function shouldn't have suspend probably?
1187
- suspend: async (_suspendPayload) => {
1188
- },
1189
- bail: () => {
1190
- },
1191
- abort: () => {
1192
- abortController.abort();
1193
- },
1194
- [_constants.EMITTER_SYMBOL]: emitter,
1195
- engine: {
1196
- step: this.inngestStep
1197
- },
1198
- abortSignal: abortController.signal
1199
- });
1200
- return result ? index : null;
1201
- } catch (e) {
1202
- return null;
1203
- }
1204
- })
1205
- )
1206
- )).filter((index) => index !== null);
1207
- const stepsToRun = entry.steps.filter((_, index) => truthyIndexes.includes(index));
1208
- const results = await Promise.all(
1209
- stepsToRun.map(
1210
- (step, index) => this.executeEntry({
1211
- workflowId,
1212
- runId,
1213
- entry: step,
1214
- prevStep,
1215
- stepResults,
1216
- resume,
1217
- serializedStepGraph,
1218
- executionContext: {
1219
- workflowId,
1220
- runId,
1221
- executionPath: [...executionContext.executionPath, index],
1222
- suspendedPaths: executionContext.suspendedPaths,
1223
- retryConfig: executionContext.retryConfig,
1224
- executionSpan: executionContext.executionSpan
1225
- },
1226
- emitter,
1227
- abortController,
1228
- runtimeContext
1229
- })
1230
- )
1231
- );
1232
- const hasFailed = results.find((result) => result.result.status === "failed");
1233
- const hasSuspended = results.find((result) => result.result.status === "suspended");
1234
- if (hasFailed) {
1235
- execResults = { status: "failed", error: hasFailed.result.error };
1236
- } else if (hasSuspended) {
1237
- execResults = { status: "suspended", payload: hasSuspended.result.suspendPayload };
1238
- } else {
1239
- execResults = {
1240
- status: "success",
1241
- output: results.reduce((acc, result, index) => {
1242
- if (result.result.status === "success") {
1243
- acc[stepsToRun[index].step.id] = result.output;
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
+ };
2193
+ }
2194
+ return { ...passThrough, messages };
2195
+ }
2196
+ return { ...passThrough, messages };
1244
2197
  }
1245
- return acc;
1246
- }, {})
2198
+ default:
2199
+ return { ...passThrough, messages };
2200
+ }
2201
+ });
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
1247
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
2238
+ });
2239
+ wf.setStepFlow(workflow.stepGraph);
2240
+ wf.commit();
2241
+ return wf;
1248
2242
  }
1249
- return execResults;
1250
- }
1251
- };
2243
+ };
2244
+ }
1252
2245
 
1253
2246
  exports.InngestExecutionEngine = InngestExecutionEngine;
2247
+ exports.InngestPubSub = InngestPubSub;
1254
2248
  exports.InngestRun = InngestRun;
1255
2249
  exports.InngestWorkflow = InngestWorkflow;
2250
+ exports._compatibilityCheck = _compatibilityCheck;
2251
+ exports.createServe = createServe;
1256
2252
  exports.createStep = createStep;
1257
2253
  exports.init = init;
1258
2254
  exports.serve = serve;
2255
+ //# sourceMappingURL=index.cjs.map
2256
+ //# sourceMappingURL=index.cjs.map