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

package/dist/__tests__/adapters/_utils.d.ts

@@ -0,0 +1,18 @@
+import { Mastra } from '@mastra/core/mastra';
+import { Inngest } from 'inngest';
+import type { InngestWorkflow } from '../../workflow.js';
+export declare const INNGEST_PORT = 4000;
+export declare const HANDLER_PORT = 4001;
+export declare function createTestInngest(id: string): Inngest<{
+    id: string;
+    baseUrl: string;
+}>;
+export declare function resetInngest(): Promise<void>;
+export declare function waitForInngestSync(ms?: number): Promise<void>;
+export interface TestWorkflowResult {
+    workflow: InngestWorkflow<any, any, any>;
+    mastra: Mastra;
+    inngest: Inngest;
+}
+export declare function createTestWorkflow(adapterId: string): TestWorkflowResult;
+//# sourceMappingURL=_utils.d.ts.map

package/dist/__tests__/adapters/_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../../src/__tests__/adapters/_utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM;;;GAK3C;AAED,wBAAsB,YAAY,kBAIjC;AAED,wBAAsB,kBAAkB,CAAC,EAAE,SAAO,iBAEjD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CA0CxE"}

package/dist/execution-engine.d.ts

@@ -0,0 +1,206 @@
+import type { RequestContext } from '@mastra/core/di';
+import type { SerializedError } from '@mastra/core/error';
+import type { PubSub } from '@mastra/core/events';
+import type { Mastra } from '@mastra/core/mastra';
+import { DefaultExecutionEngine } from '@mastra/core/workflows';
+import type { ExecutionContext, Step, StepResult, ExecutionEngineOptions, TimeTravelExecutionParams } from '@mastra/core/workflows';
+import type { Inngest, BaseContext } from 'inngest';
+export declare class InngestExecutionEngine extends DefaultExecutionEngine {
+    private inngestStep;
+    private inngestAttempts;
+    constructor(mastra: Mastra, inngestStep: BaseContext<Inngest>['step'], inngestAttempts: number | undefined, options: ExecutionEngineOptions);
+    /**
+     * Format errors while preserving Error instances and their custom properties.
+     * Uses getErrorFromUnknown to ensure all error properties are preserved.
+     */
+    protected formatResultError(error: Error | string | undefined, lastOutput: StepResult<any, any, any, any>): SerializedError;
+    /**
+     * Detect InngestWorkflow instances for special nested workflow handling
+     */
+    isNestedWorkflowStep(step: Step<any, any, any>): boolean;
+    /**
+     * Inngest requires requestContext serialization for memoization.
+     * When steps are replayed, the original function doesn't re-execute,
+     * so requestContext modifications must be captured and restored.
+     */
+    requiresDurableContextSerialization(): boolean;
+    /**
+     * Execute a step with retry logic for Inngest.
+     * Retries are handled via step-level retry (RetryAfterError thrown INSIDE step.run()).
+     * After retries exhausted, error propagates here and we return a failed result.
+     */
+    executeStepWithRetry<T>(stepId: string, runStep: () => Promise<T>, params: {
+        retries: number;
+        delay: number;
+        stepSpan?: any;
+        workflowId: string;
+        runId: string;
+    }): Promise<{
+        ok: true;
+        result: T;
+    } | {
+        ok: false;
+        error: {
+            status: 'failed';
+            error: Error;
+            endedAt: number;
+        };
+    }>;
+    /**
+     * Use Inngest's sleep primitive for durability
+     */
+    executeSleepDuration(duration: number, sleepId: string, workflowId: string): Promise<void>;
+    /**
+     * Use Inngest's sleepUntil primitive for durability
+     */
+    executeSleepUntilDate(date: Date, sleepUntilId: string, workflowId: string): Promise<void>;
+    /**
+     * Wrap durable operations in Inngest step.run() for durability.
+     *
+     * IMPORTANT: Errors are wrapped with a cause structure before throwing.
+     * This is necessary because Inngest's error serialization (serialize-error-cjs)
+     * only captures standard Error properties (message, name, stack, code, cause).
+     * Custom properties like statusCode, responseHeaders from AI SDK errors would
+     * be lost. By putting our serialized error (via getErrorFromUnknown with toJSON())
+     * in the cause property, we ensure custom properties survive serialization.
+     * The cause property is in serialize-error-cjs's allowlist, and when the cause
+     * object is finally JSON.stringify'd, our error's toJSON() is called.
+     */
+    wrapDurableOperation<T>(operationId: string, operationFn: () => Promise<T>): Promise<T>;
+    /**
+     * Provide Inngest step primitive in engine context
+     */
+    getEngineContext(): Record<string, any>;
+    /**
+     * For Inngest, lifecycle callbacks are invoked in the workflow's finalize step
+     * (wrapped in step.run for durability), not in execute(). Override to skip.
+     */
+    invokeLifecycleCallbacks(_result: {
+        status: any;
+        result?: any;
+        error?: any;
+        steps: Record<string, any>;
+        tripwire?: any;
+        runId: string;
+        workflowId: string;
+        resourceId?: string;
+        input?: any;
+        requestContext: RequestContext;
+        state: Record<string, any>;
+    }): Promise<void>;
+    /**
+     * Actually invoke the lifecycle callbacks. Called from workflow.ts finalize step.
+     */
+    invokeLifecycleCallbacksInternal(result: {
+        status: any;
+        result?: any;
+        error?: any;
+        steps: Record<string, any>;
+        tripwire?: any;
+        runId: string;
+        workflowId: string;
+        resourceId?: string;
+        input?: any;
+        requestContext: RequestContext;
+        state: Record<string, any>;
+    }): Promise<void>;
+    /**
+     * Create a step span durably - on first execution, creates and exports span.
+     * On replay, returns cached span data without re-creating.
+     */
+    createStepSpan(params: {
+        parentSpan: any;
+        stepId: string;
+        operationId: string;
+        options: {
+            name: string;
+            type: any;
+            input?: unknown;
+            entityType?: string;
+            entityId?: string;
+            tracingPolicy?: any;
+        };
+        executionContext: ExecutionContext;
+    }): Promise<any>;
+    /**
+     * End a step span durably.
+     */
+    endStepSpan(params: {
+        span: any;
+        operationId: string;
+        endOptions: {
+            output?: unknown;
+            attributes?: Record<string, unknown>;
+        };
+    }): Promise<void>;
+    /**
+     * Record error on step span durably.
+     */
+    errorStepSpan(params: {
+        span: any;
+        operationId: string;
+        errorOptions: {
+            error: Error;
+            attributes?: Record<string, unknown>;
+        };
+    }): Promise<void>;
+    /**
+     * Create a generic child span durably (for control-flow operations).
+     * On first execution, creates and exports span. On replay, returns cached span data.
+     */
+    createChildSpan(params: {
+        parentSpan: any;
+        operationId: string;
+        options: {
+            name: string;
+            type: any;
+            input?: unknown;
+            attributes?: Record<string, unknown>;
+        };
+        executionContext: ExecutionContext;
+    }): Promise<any>;
+    /**
+     * End a generic child span durably (for control-flow operations).
+     */
+    endChildSpan(params: {
+        span: any;
+        operationId: string;
+        endOptions?: {
+            output?: unknown;
+            attributes?: Record<string, unknown>;
+        };
+    }): Promise<void>;
+    /**
+     * Record error on a generic child span durably (for control-flow operations).
+     */
+    errorChildSpan(params: {
+        span: any;
+        operationId: string;
+        errorOptions: {
+            error: Error;
+            attributes?: Record<string, unknown>;
+        };
+    }): Promise<void>;
+    /**
+     * Execute nested InngestWorkflow using inngestStep.invoke() for durability.
+     * This MUST be called directly (not inside step.run()) due to Inngest constraints.
+     */
+    executeWorkflowStep(params: {
+        step: Step<string, any, any>;
+        stepResults: Record<string, StepResult<any, any, any, any>>;
+        executionContext: ExecutionContext;
+        resume?: {
+            steps: string[];
+            resumePayload: any;
+            runId?: string;
+        };
+        timeTravel?: TimeTravelExecutionParams;
+        prevOutput: any;
+        inputData: any;
+        pubsub: PubSub;
+        startedAt: number;
+        perStep?: boolean;
+        stepSpan?: any;
+    }): Promise<StepResult<any, any, any, any> | null>;
+}
+//# sourceMappingURL=execution-engine.d.ts.map

package/dist/execution-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-engine.d.ts","sourceRoot":"","sources":["../src/execution-engine.ts"],"names":[],"mappings":"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"}