@mastra/core 0.0.0-a2a-20250421213654

package/dist/base-BlGpZfLc.d.ts

@@ -0,0 +1,2139 @@
+import * as ai from 'ai';
+import { Tool as Tool$1, ToolExecutionOptions, LanguageModelV1, CoreMessage as CoreMessage$1, GenerateTextResult, GenerateObjectResult, StreamTextResult, StreamObjectResult, EmbeddingModel, Message, UserContent, AssistantContent, TelemetrySettings, generateText, generateObject, streamText, streamObject, CoreSystemMessage as CoreSystemMessage$1, CoreAssistantMessage as CoreAssistantMessage$1, CoreUserMessage as CoreUserMessage$1, CoreToolMessage as CoreToolMessage$1, EmbedResult as EmbedResult$1, EmbedManyResult as EmbedManyResult$1, GenerateTextOnStepFinishCallback, StreamTextOnFinishCallback, StreamObjectOnFinishCallback, StreamTextOnStepFinishCallback, LanguageModel as LanguageModel$1, DeepPartial, ToolContent } from 'ai';
+import { M as MastraBase, T as Telemetry, O as OtelConfig } from './base-DT2poiVK.js';
+import { a as Metric, M as MetricResult, T as TestInfo } from './types-BtMyV38I.js';
+import { Query } from 'sift';
+import { z, ZodSchema } from 'zod';
+import { JSONSchema7 } from 'json-schema';
+import { Container } from './di/index.js';
+import { B as BaseLogMessage, R as RegisteredLogger, L as Logger, d as Run } from './index-CquI0inB.js';
+import { Span } from '@opentelemetry/api';
+import * as xstate from 'xstate';
+import { Snapshot } from 'xstate';
+import EventEmitter from 'node:events';
+import { MastraVector } from './vector/index.js';
+import { MastraTTS } from './tts/index.js';
+import { MastraDeployer } from './deployer/index.js';
+import { Handler, MiddlewareHandler } from 'hono';
+import { cors } from 'hono/cors';
+import { DescribeRouteOptions } from 'hono-openapi';
+
+type VercelTool = Tool$1;
+type CoreTool = {
+    id?: string;
+    description?: string;
+    parameters: ZodSchema;
+    execute?: (params: any, options: ToolExecutionOptions) => Promise<any>;
+} & ({
+    type?: 'function' | undefined;
+    id?: string;
+} | {
+    type: 'provider-defined';
+    id: `${string}.${string}`;
+    args: Record<string, unknown>;
+});
+interface ToolExecutionContext<TSchemaIn extends z.ZodSchema | undefined = undefined> extends IExecutionContext<TSchemaIn> {
+    mastra?: MastraUnion;
+    container: Container;
+}
+interface ToolAction<TSchemaIn extends z.ZodSchema | undefined = undefined, TSchemaOut extends z.ZodSchema | undefined = undefined, TContext extends ToolExecutionContext<TSchemaIn> = ToolExecutionContext<TSchemaIn>> extends IAction<string, TSchemaIn, TSchemaOut, TContext, ToolExecutionOptions> {
+    description: string;
+    execute?: (context: TContext, options?: ToolExecutionOptions) => Promise<TSchemaOut extends z.ZodSchema ? z.infer<TSchemaOut> : unknown>;
+    mastra?: Mastra;
+}
+
+declare class Tool<TSchemaIn extends z.ZodSchema | undefined = undefined, TSchemaOut extends z.ZodSchema | undefined = undefined, TContext extends ToolExecutionContext<TSchemaIn> = ToolExecutionContext<TSchemaIn>> implements ToolAction<TSchemaIn, TSchemaOut, TContext> {
+    id: string;
+    description: string;
+    inputSchema?: TSchemaIn;
+    outputSchema?: TSchemaOut;
+    execute?: ToolAction<TSchemaIn, TSchemaOut, TContext>['execute'];
+    mastra?: Mastra;
+    constructor(opts: ToolAction<TSchemaIn, TSchemaOut, TContext>);
+}
+declare function createTool<TSchemaIn extends z.ZodSchema | undefined = undefined, TSchemaOut extends z.ZodSchema | undefined = undefined, TContext extends ToolExecutionContext<TSchemaIn> = ToolExecutionContext<TSchemaIn>>(opts: ToolAction<TSchemaIn, TSchemaOut, TContext>): Tool<TSchemaIn, TSchemaOut, TContext>;
+
+type AgentNetworkConfig = {
+    name: string;
+    agents: Agent[];
+    model: LanguageModelV1;
+    instructions: string;
+};
+
+declare class AgentNetwork extends MastraBase {
+    #private;
+    constructor(config: AgentNetworkConfig);
+    formatAgentId(name: string): string;
+    getTools(): {
+        readonly transmit: Tool<z.ZodObject<{
+            actions: z.ZodArray<z.ZodObject<{
+                agent: z.ZodString;
+                input: z.ZodString;
+                includeHistory: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                input: string;
+                agent: string;
+                includeHistory?: boolean | undefined;
+            }, {
+                input: string;
+                agent: string;
+                includeHistory?: boolean | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            actions: {
+                input: string;
+                agent: string;
+                includeHistory?: boolean | undefined;
+            }[];
+        }, {
+            actions: {
+                input: string;
+                agent: string;
+                includeHistory?: boolean | undefined;
+            }[];
+        }>, undefined, ToolExecutionContext<z.ZodObject<{
+            actions: z.ZodArray<z.ZodObject<{
+                agent: z.ZodString;
+                input: z.ZodString;
+                includeHistory: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                input: string;
+                agent: string;
+                includeHistory?: boolean | undefined;
+            }, {
+                input: string;
+                agent: string;
+                includeHistory?: boolean | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            actions: {
+                input: string;
+                agent: string;
+                includeHistory?: boolean | undefined;
+            }[];
+        }, {
+            actions: {
+                input: string;
+                agent: string;
+                includeHistory?: boolean | undefined;
+            }[];
+        }>>>;
+    };
+    getAgentHistory(agentId: string): {
+        input: string;
+        output: string;
+        timestamp: string;
+    }[];
+    /**
+     * Get the history of all agent interactions that have occurred in this network
+     * @returns A record of agent interactions, keyed by agent ID
+     */
+    getAgentInteractionHistory(): {
+        [x: string]: {
+            input: string;
+            output: string;
+            timestamp: string;
+        }[];
+    };
+    /**
+     * Get a summary of agent interactions in a more readable format, displayed chronologically
+     * @returns A formatted string with all agent interactions in chronological order
+     */
+    getAgentInteractionSummary(): string;
+    executeAgent(agentId: string, input: CoreMessage$1[], includeHistory?: boolean, container?: Container): Promise<string>;
+    getInstructions(): string;
+    getRoutingAgent(): Agent<string, ToolsInput, Record<string, Metric>>;
+    getAgents(): Agent<string, ToolsInput, Record<string, Metric>>[];
+    generate<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[], args?: AgentGenerateOptions<Z> & {
+        output?: never;
+        experimental_output?: never;
+    }): Promise<GenerateTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown>>;
+    generate<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[], args?: AgentGenerateOptions<Z> & ({
+        output: Z;
+        experimental_output?: never;
+    } | {
+        experimental_output: Z;
+        output?: never;
+    })): Promise<GenerateObjectResult<Z extends ZodSchema ? z.infer<Z> : unknown>>;
+    stream<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[], args?: AgentStreamOptions<Z> & {
+        output?: never;
+        experimental_output?: never;
+    }): Promise<StreamTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown>>;
+    stream<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[], args?: AgentStreamOptions<Z> & ({
+        output: Z;
+        experimental_output?: never;
+    } | {
+        experimental_output: Z;
+        output?: never;
+    })): Promise<StreamObjectResult<any, Z extends ZodSchema ? z.infer<Z> : unknown, any>>;
+    __registerMastra(p: Mastra): void;
+}
+
+interface WorkflowOptions<TWorkflowName extends string = string, TSteps extends Step<string, any, any, any>[] = Step<string, any, any, any>[], TTriggerSchema extends z.ZodObject<any> = any, TResultSchema extends z.ZodObject<any> = any> {
+    steps?: TSteps;
+    name: TWorkflowName;
+    triggerSchema?: TTriggerSchema;
+    result?: {
+        schema: TResultSchema;
+        mapping?: {
+            [K in keyof z.infer<TResultSchema>]?: any;
+        };
+    };
+    events?: Record<string, {
+        schema: z.ZodObject<any>;
+    }>;
+    retryConfig?: RetryConfig;
+    mastra?: Mastra;
+}
+interface StepExecutionContext<TSchemaIn extends z.ZodSchema | undefined = undefined, TContext extends WorkflowContext = WorkflowContext> extends IExecutionContext<TSchemaIn> {
+    context: TSchemaIn extends z.ZodSchema ? {
+        inputData: z.infer<TSchemaIn>;
+    } & TContext : TContext;
+    suspend: (payload?: unknown, softSuspend?: any) => Promise<void>;
+    runId: string;
+    emit: (event: string, data: any) => void;
+    mastra?: MastraUnion;
+    container: Container;
+}
+interface StepAction<TId extends string, TSchemaIn extends z.ZodSchema | undefined, TSchemaOut extends z.ZodSchema | undefined, TContext extends StepExecutionContext<TSchemaIn>> extends IAction<TId, TSchemaIn, TSchemaOut, TContext> {
+    mastra?: Mastra;
+    payload?: TSchemaIn extends z.ZodSchema ? Partial<z.infer<TSchemaIn>> : unknown;
+    execute: (context: TContext) => Promise<TSchemaOut extends z.ZodSchema ? z.infer<TSchemaOut> : unknown>;
+    retryConfig?: RetryConfig;
+    workflow?: Workflow;
+    workflowId?: string;
+}
+interface SimpleConditionalType {
+    [key: `${string}.${string}`]: string | Query<any>;
+}
+type StepVariableType<TId extends string, TSchemaIn extends z.ZodSchema | undefined, TSchemaOut extends z.ZodSchema | undefined, TContext extends StepExecutionContext<TSchemaIn>> = StepAction<TId, TSchemaIn, TSchemaOut, TContext> | 'trigger' | {
+    id: string;
+};
+type StepNode = {
+    id: string;
+    step: StepAction<any, any, any, any>;
+    config: StepDef<any, any, any, any>[any];
+};
+type StepGraph = {
+    initial: StepNode[];
+    [key: string]: StepNode[];
+};
+type RetryConfig = {
+    attempts?: number;
+    delay?: number;
+};
+type VariableReference<TStep extends StepVariableType<any, any, any, any>, TTriggerSchema extends z.ZodObject<any>> = TStep extends StepAction<any, any, any, any> ? {
+    step: TStep;
+    path: PathsToStringProps<ExtractSchemaType<ExtractSchemaFromStep<TStep, 'outputSchema'>>> | '' | '.';
+} : TStep extends 'trigger' ? {
+    step: 'trigger';
+    path: PathsToStringProps<ExtractSchemaType<TTriggerSchema>> | '.' | '';
+} : {
+    step: {
+        id: string;
+    };
+    path: string;
+};
+interface BaseCondition<TStep extends StepVariableType<any, any, any, any>, TTriggerSchema extends z.ZodObject<any>> {
+    ref: TStep extends StepAction<any, any, any, any> ? {
+        step: TStep;
+        path: PathsToStringProps<ExtractSchemaType<ExtractSchemaFromStep<TStep, 'outputSchema'>>> | '' | '.' | 'status';
+    } : TStep extends 'trigger' ? {
+        step: 'trigger';
+        path: PathsToStringProps<ExtractSchemaType<TTriggerSchema>> | '.' | '';
+    } : {
+        step: {
+            id: string;
+        };
+        path: string;
+    };
+    query: Query<any>;
+}
+type ActionContext<TSchemaIn extends z.ZodType<any>> = StepExecutionContext<z.infer<TSchemaIn>, WorkflowContext>;
+declare enum WhenConditionReturnValue {
+    CONTINUE = "continue",
+    CONTINUE_FAILED = "continue_failed",
+    ABORT = "abort",
+    LIMBO = "limbo"
+}
+type StepDef<TStepId extends TSteps[number]['id'], TSteps extends StepAction<any, any, any, any>[], TSchemaIn extends z.ZodType<any>, TSchemaOut extends z.ZodType<any>> = Record<TStepId, {
+    id?: string;
+    when?: Condition<any, any> | ((args: {
+        context: WorkflowContext;
+        mastra?: Mastra;
+    }) => Promise<boolean | WhenConditionReturnValue>);
+    serializedWhen?: Condition<any, any> | string;
+    loopLabel?: string;
+    loopType?: 'while' | 'until';
+    data: TSchemaIn;
+    handler: (args: ActionContext<TSchemaIn>) => Promise<z.infer<TSchemaOut>>;
+}>;
+type StepCondition<TStep extends StepVariableType<any, any, any, any>, TTriggerSchema extends z.ZodObject<any>> = BaseCondition<TStep, TTriggerSchema> | SimpleConditionalType | {
+    and: StepCondition<TStep, TTriggerSchema>[];
+} | {
+    or: StepCondition<TStep, TTriggerSchema>[];
+} | {
+    not: StepCondition<TStep, TTriggerSchema>;
+};
+type Condition<TStep extends StepVariableType<any, any, any, any>, TTriggerSchema extends z.ZodObject<any>> = BaseCondition<TStep, TTriggerSchema> | SimpleConditionalType | {
+    and: Condition<TStep, TTriggerSchema>[];
+} | {
+    or: Condition<TStep, TTriggerSchema>[];
+} | {
+    not: Condition<TStep, TTriggerSchema>;
+};
+interface StepConfig<TStep extends StepAction<any, any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>, TTriggerSchema extends z.ZodObject<any>, TSteps extends Step<string, any, any, any>[] = Step<string, any, any, any>[]> {
+    when?: Condition<CondStep, TTriggerSchema> | ((args: {
+        context: WorkflowContext<TTriggerSchema, TSteps>;
+        mastra?: Mastra;
+    }) => Promise<boolean | WhenConditionReturnValue>);
+    variables?: StepInputType<TStep, 'inputSchema'> extends never ? Record<string, VariableReference<VarStep, TTriggerSchema>> : {
+        [K in keyof StepInputType<TStep, 'inputSchema'>]?: VariableReference<VarStep, TTriggerSchema>;
+    };
+    '#internal'?: {
+        when?: Condition<CondStep, TTriggerSchema> | ((args: {
+            context: WorkflowContext<TTriggerSchema, TSteps>;
+            mastra?: Mastra;
+        }) => Promise<boolean | WhenConditionReturnValue>);
+        loopLabel?: string;
+        loopType?: 'while' | 'until' | undefined;
+    };
+    id?: string;
+}
+type StepSuccess<T> = {
+    status: 'success';
+    output: T;
+};
+type StepSuspended<T> = {
+    status: 'suspended';
+    suspendPayload?: any;
+    output?: T;
+};
+type StepWaiting = {
+    status: 'waiting';
+};
+type StepFailure = {
+    status: 'failed';
+    error: string;
+};
+type StepSkipped = {
+    status: 'skipped';
+};
+type StepResult<T> = StepSuccess<T> | StepFailure | StepSuspended<T> | StepWaiting | StepSkipped;
+type StepsRecord<T extends readonly Step<any, any, z.ZodType<any> | undefined>[]> = {
+    [K in T[number]['id']]: Extract<T[number], {
+        id: K;
+    }>;
+};
+interface WorkflowRunResult<T extends z.ZodObject<any>, TSteps extends Step<string, any, z.ZodType<any> | undefined>[], TResult extends z.ZodObject<any>> {
+    triggerData?: z.infer<T>;
+    result?: z.infer<TResult>;
+    results: {
+        [K in keyof StepsRecord<TSteps>]: StepsRecord<TSteps>[K]['outputSchema'] extends undefined ? StepResult<unknown> : StepResult<z.infer<NonNullable<StepsRecord<TSteps>[K]['outputSchema']>>>;
+    };
+    runId: string;
+    timestamp: number;
+    activePaths: Map<keyof StepsRecord<TSteps>, {
+        status: string;
+        suspendPayload?: any;
+        stepPath: string[];
+    }>;
+}
+interface WorkflowContext<TTrigger extends z.ZodObject<any> = any, TSteps extends Step<string, any, any, any>[] = Step<string, any, any, any>[], TInputData extends Record<string, any> = Record<string, any>> {
+    isResume?: {
+        runId: string;
+        stepId: string;
+    };
+    mastra?: MastraUnion;
+    steps: {
+        [K in keyof StepsRecord<TSteps>]: StepsRecord<TSteps>[K]['outputSchema'] extends undefined ? StepResult<unknown> : StepResult<z.infer<NonNullable<StepsRecord<TSteps>[K]['outputSchema']>>>;
+    };
+    triggerData: z.infer<TTrigger>;
+    inputData: TInputData;
+    attempts: Record<string, number>;
+    getStepResult(stepId: 'trigger'): z.infer<TTrigger>;
+    getStepResult<T extends keyof StepsRecord<TSteps> | unknown>(stepId: T extends keyof StepsRecord<TSteps> ? T : string): T extends keyof StepsRecord<TSteps> ? StepsRecord<TSteps>[T]['outputSchema'] extends undefined ? unknown : z.infer<NonNullable<StepsRecord<TSteps>[T]['outputSchema']>> : T;
+    getStepResult<T extends Step<any, any, any, any>>(stepId: T): T['outputSchema'] extends undefined ? unknown : z.infer<NonNullable<T['outputSchema']>>;
+}
+interface WorkflowLogMessage extends BaseLogMessage {
+    type: typeof RegisteredLogger.WORKFLOW;
+    workflowName: string;
+    stepId?: StepId;
+    data?: unknown;
+    runId?: string;
+}
+type WorkflowEvent = {
+    type: 'RESET_TO_PENDING';
+    stepId: string;
+} | {
+    type: 'CONDITIONS_MET';
+    stepId: string;
+} | {
+    type: 'CONDITION_FAILED';
+    stepId: string;
+    error: string;
+} | {
+    type: 'SUSPENDED';
+    stepId: string;
+    suspendPayload?: any;
+    softSuspend?: any;
+} | {
+    type: 'WAITING';
+    stepId: string;
+} | {
+    type: `xstate.error.actor.${string}`;
+    error: Error;
+} | {
+    type: `xstate.done.actor.${string}`;
+    output: ResolverFunctionOutput;
+};
+type ResolverFunctionInput = {
+    stepNode: StepNode;
+    context: WorkflowContext;
+};
+type ResolverFunctionOutput = {
+    stepId: StepId;
+    result: unknown;
+};
+type SubscriberFunctionOutput = {
+    stepId: StepId;
+    result: unknown;
+};
+type DependencyCheckOutput = {
+    type: 'CONDITIONS_MET';
+} | {
+    type: 'CONDITIONS_SKIPPED';
+} | {
+    type: 'CONDITIONS_SKIP_TO_COMPLETED';
+} | {
+    type: 'CONDITION_FAILED';
+    error: string;
+} | {
+    type: 'SUSPENDED';
+} | {
+    type: 'WAITING';
+} | {
+    type: 'CONDITIONS_LIMBO';
+};
+type StepResolverOutput = {
+    type: 'STEP_SUCCESS';
+    output: unknown;
+} | {
+    type: 'STEP_FAILED';
+    error: string;
+} | {
+    type: 'STEP_WAITING';
+};
+type WorkflowActors = {
+    resolverFunction: {
+        input: ResolverFunctionInput;
+        output: StepResolverOutput;
+    };
+    conditionCheck: {
+        input: {
+            context: WorkflowContext;
+            stepId: string;
+        };
+        output: DependencyCheckOutput;
+    };
+    spawnSubscriberFunction: {
+        input: {
+            context: WorkflowContext;
+            stepId: string;
+        };
+        output: SubscriberFunctionOutput;
+    };
+};
+type WorkflowActionParams = {
+    stepId: string;
+};
+type WorkflowActions = {
+    type: 'updateStepResult' | 'setStepError' | 'notifyStepCompletion' | 'decrementAttemptCount';
+    params: WorkflowActionParams;
+};
+type WorkflowState = {
+    [key: string]: {
+        initial: 'pending';
+        states: {
+            pending: {
+                invoke: {
+                    src: 'conditionCheck';
+                    input: ({ context }: {
+                        context: WorkflowContext;
+                    }) => {
+                        context: WorkflowContext;
+                        stepId: string;
+                    };
+                    onDone: [
+                        {
+                            guard: (_: any, event: {
+                                output: DependencyCheckOutput;
+                            }) => boolean;
+                            target: 'executing';
+                        },
+                        {
+                            guard: (_: any, event: {
+                                output: DependencyCheckOutput;
+                            }) => boolean;
+                            target: 'waiting';
+                        }
+                    ];
+                };
+            };
+            waiting: {
+                after: {
+                    CHECK_INTERVAL: {
+                        target: 'pending';
+                    };
+                };
+            };
+            executing: {
+                invoke: {
+                    src: 'resolverFunction';
+                    input: ({ context }: {
+                        context: WorkflowContext;
+                    }) => ResolverFunctionInput;
+                    onDone: {
+                        target: 'completed';
+                        actions: ['updateStepResult'];
+                    };
+                    onError: {
+                        target: 'failed';
+                        actions: ['setStepError'];
+                    };
+                };
+            };
+            completed: {
+                type: 'final';
+                entry: ['notifyStepCompletion'];
+            };
+            failed: {
+                type: 'final';
+                entry: ['notifyStepCompletion'];
+            };
+        };
+    };
+};
+declare const StepIdBrand: unique symbol;
+type StepId = string & {
+    readonly [StepIdBrand]: typeof StepIdBrand;
+};
+type ExtractSchemaFromStep<TStep extends StepAction<any, any, any, any>, TKey extends 'inputSchema' | 'outputSchema'> = TStep[TKey];
+type ExtractStepResult<T> = T extends (data: any) => Promise<infer R> ? R : never;
+type StepInputType<TStep extends StepAction<any, any, any, any>, TKey extends 'inputSchema' | 'outputSchema'> = ExtractSchemaFromStep<TStep, TKey> extends infer Schema ? Schema extends z.ZodType<any> ? z.infer<Schema> : never : never;
+type ExtractSchemaType<T extends z.ZodSchema> = T extends z.ZodSchema<infer V> ? V : never;
+type PathsToStringProps<T> = T extends object ? {
+    [K in keyof T]: T[K] extends object ? K extends string ? K | `${K}.${PathsToStringProps<T[K]>}` : never : K extends string ? K : never;
+}[keyof T] : never;
+interface WorkflowRunState {
+    value: Record<string, string>;
+    context: {
+        steps: Record<string, {
+            status: 'success' | 'failed' | 'suspended' | 'waiting' | 'skipped';
+            payload?: any;
+            error?: string;
+        }>;
+        triggerData: Record<string, any>;
+        attempts: Record<string, number>;
+    };
+    activePaths: Array<{
+        stepPath: string[];
+        stepId: string;
+        status: string;
+    }>;
+    runId: string;
+    timestamp: number;
+    childStates?: Record<string, WorkflowRunState>;
+    suspendedSteps?: Record<string, string>;
+}
+type WorkflowResumeResult<TTriggerSchema extends z.ZodObject<any>> = {
+    triggerData?: z.infer<TTriggerSchema>;
+    results: Record<string, StepResult<any>>;
+};
+
+declare class Step<TStepId extends string = any, TSchemaIn extends z.ZodSchema | undefined = undefined, TSchemaOut extends z.ZodSchema | undefined = undefined, TContext extends StepExecutionContext<TSchemaIn> = StepExecutionContext<TSchemaIn>> implements StepAction<TStepId, TSchemaIn, TSchemaOut, TContext> {
+    id: TStepId;
+    description?: string;
+    inputSchema?: TSchemaIn;
+    outputSchema?: TSchemaOut;
+    payload?: TSchemaIn extends z.ZodSchema ? Partial<z.infer<TSchemaIn>> : unknown;
+    execute: (context: TContext) => Promise<TSchemaOut extends z.ZodSchema ? z.infer<TSchemaOut> : unknown>;
+    retryConfig?: RetryConfig;
+    mastra?: Mastra;
+    constructor({ id, description, execute, payload, outputSchema, inputSchema, retryConfig, }: StepAction<TStepId, TSchemaIn, TSchemaOut, TContext>);
+}
+declare function createStep<TId extends string, TSchemaIn extends z.ZodSchema | undefined, TSchemaOut extends z.ZodSchema | undefined, TContext extends StepExecutionContext<TSchemaIn>>(opts: StepAction<TId, TSchemaIn, TSchemaOut, TContext>): Step<TId, TSchemaIn, TSchemaOut, TContext>;
+
+declare class Machine<TSteps extends Step<any, any, any, any>[] = Step<any, any, any, any>[], TTriggerSchema extends z.ZodObject<any> = any, TResultSchema extends z.ZodObject<any> = any> extends EventEmitter {
+    #private;
+    logger: Logger;
+    name: string;
+    constructor({ logger, mastra, container, workflowInstance, executionSpan, name, runId, steps, stepGraph, retryConfig, startStepId, }: {
+        logger: Logger;
+        mastra?: Mastra;
+        container: Container;
+        workflowInstance: WorkflowInstance;
+        executionSpan?: Span;
+        name: string;
+        runId: string;
+        steps: Record<string, StepNode>;
+        stepGraph: StepGraph;
+        retryConfig?: RetryConfig;
+        startStepId: string;
+    });
+    get startStepId(): string;
+    execute({ stepId, input, snapshot, resumeData, }?: {
+        stepId?: string;
+        input?: any;
+        snapshot?: Snapshot<any>;
+        resumeData?: any;
+    }): Promise<Pick<WorkflowRunResult<TTriggerSchema, TSteps, TResultSchema>, 'results' | 'activePaths' | 'runId' | 'timestamp'>>;
+    private initializeMachine;
+    getSnapshot(): xstate.MachineSnapshot<Omit<WorkflowContext<any, Step<string, any, any, any>[], Record<string, any>>, "getStepResult">, {
+        type: "RESET_TO_PENDING";
+        stepId: string;
+    } | {
+        type: "CONDITIONS_MET";
+        stepId: string;
+    } | {
+        type: "CONDITION_FAILED";
+        stepId: string;
+        error: string;
+    } | {
+        type: "SUSPENDED";
+        stepId: string;
+        suspendPayload?: any;
+        softSuspend?: any;
+    } | {
+        type: "WAITING";
+        stepId: string;
+    } | {
+        type: `xstate.error.actor.${string}`;
+        error: Error;
+    } | {
+        type: `xstate.done.actor.${string}`;
+        output: ResolverFunctionOutput;
+    }, {
+        [x: string]: xstate.ActorRefFromLogic<xstate.PromiseActorLogic<{
+            type: "CONDITIONS_MET";
+            error?: undefined;
+        } | {
+            type: "CONDITIONS_SKIP_TO_COMPLETED";
+            error?: undefined;
+        } | {
+            type: "CONDITIONS_LIMBO";
+            error?: undefined;
+        } | {
+            type: "CONDITIONS_SKIPPED";
+            error?: undefined;
+        } | {
+            type: "CONDITION_FAILED";
+            error: string;
+        }, {
+            context: WorkflowContext;
+            stepNode: StepNode;
+        }, xstate.EventObject>> | xstate.ActorRefFromLogic<xstate.PromiseActorLogic<{
+            type: "STEP_FAILED";
+            error: string;
+            stepId: string;
+            result?: undefined;
+        } | {
+            type: "STEP_WAITING";
+            stepId: string;
+            error?: undefined;
+            result?: undefined;
+        } | {
+            type: "STEP_SUCCESS";
+            result: any;
+            stepId: string;
+            error?: undefined;
+        }, ResolverFunctionInput, xstate.EventObject>> | xstate.ActorRefFromLogic<xstate.PromiseActorLogic<{
+            steps: {};
+        }, {
+            parentStepId: string;
+            context: WorkflowContext;
+        }, xstate.EventObject>> | undefined;
+    }, {
+        [x: string]: {} | {
+            [x: string]: {} | /*elided*/ any | {
+                [x: string]: {} | /*elided*/ any | /*elided*/ any;
+            };
+        } | {
+            [x: string]: {} | {
+                [x: string]: {} | /*elided*/ any | /*elided*/ any;
+            } | /*elided*/ any;
+        };
+    }, string, xstate.NonReducibleUnknown, xstate.MetaObject, {
+        readonly id: string;
+        readonly type: "parallel";
+        readonly context: ({ input }: {
+            spawn: {
+                <TSrc extends "conditionCheck" | "resolverFunction" | "spawnSubscriberFunction">(logic: TSrc, ...[options]: ({
+                    src: "conditionCheck";
+                    logic: xstate.PromiseActorLogic<{
+                        type: "CONDITIONS_MET";
+                        error?: undefined;
+                    } | {
+                        type: "CONDITIONS_SKIP_TO_COMPLETED";
+                        error?: undefined;
+                    } | {
+                        type: "CONDITIONS_LIMBO";
+                        error?: undefined;
+                    } | {
+                        type: "CONDITIONS_SKIPPED";
+                        error?: undefined;
+                    } | {
+                        type: "CONDITION_FAILED";
+                        error: string;
+                    }, {
+                        context: WorkflowContext;
+                        stepNode: StepNode;
+                    }, xstate.EventObject>;
+                    id: string | undefined;
+                } extends infer T ? T extends {
+                    src: "conditionCheck";
+                    logic: xstate.PromiseActorLogic<{
+                        type: "CONDITIONS_MET";
+                        error?: undefined;
+                    } | {
+                        type: "CONDITIONS_SKIP_TO_COMPLETED";
+                        error?: undefined;
+                    } | {
+                        type: "CONDITIONS_LIMBO";
+                        error?: undefined;
+                    } | {
+                        type: "CONDITIONS_SKIPPED";
+                        error?: undefined;
+                    } | {
+                        type: "CONDITION_FAILED";
+                        error: string;
+                    }, {
+                        context: WorkflowContext;
+                        stepNode: StepNode;
+                    }, xstate.EventObject>;
+                    id: string | undefined;
+                } ? T extends {
+                    src: TSrc;
+                } ? xstate.ConditionalRequired<[options?: ({
+                    id?: T["id"] | undefined;
+                    systemId?: string;
+                    input?: xstate.InputFrom<T["logic"]> | undefined;
+                    syncSnapshot?: boolean;
+                } & { [K in xstate.RequiredActorOptions<T>]: unknown; }) | undefined], xstate.IsNotNever<xstate.RequiredActorOptions<T>>> : never : never : never) | ({
+                    src: "resolverFunction";
+                    logic: xstate.PromiseActorLogic<{
+                        type: "STEP_FAILED";
+                        error: string;
+                        stepId: string;
+                        result?: undefined;
+                    } | {
+                        type: "STEP_WAITING";
+                        stepId: string;
+                        error?: undefined;
+                        result?: undefined;
+                    } | {
+                        type: "STEP_SUCCESS";
+                        result: any;
+                        stepId: string;
+                        error?: undefined;
+                    }, ResolverFunctionInput, xstate.EventObject>;
+                    id: string | undefined;
+                } extends infer T_1 ? T_1 extends {
+                    src: "resolverFunction";
+                    logic: xstate.PromiseActorLogic<{
+                        type: "STEP_FAILED";
+                        error: string;
+                        stepId: string;
+                        result?: undefined;
+                    } | {
+                        type: "STEP_WAITING";
+                        stepId: string;
+                        error?: undefined;
+                        result?: undefined;
+                    } | {
+                        type: "STEP_SUCCESS";
+                        result: any;
+                        stepId: string;
+                        error?: undefined;
+                    }, ResolverFunctionInput, xstate.EventObject>;
+                    id: string | undefined;
+                } ? T_1 extends {
+                    src: TSrc;
+                } ? xstate.ConditionalRequired<[options?: ({
+                    id?: T_1["id"] | undefined;
+                    systemId?: string;
+                    input?: xstate.InputFrom<T_1["logic"]> | undefined;
+                    syncSnapshot?: boolean;
+                } & { [K_1 in xstate.RequiredActorOptions<T_1>]: unknown; }) | undefined], xstate.IsNotNever<xstate.RequiredActorOptions<T_1>>> : never : never : never) | ({
+                    src: "spawnSubscriberFunction";
+                    logic: xstate.PromiseActorLogic<{
+                        steps: {};
+                    }, {
+                        parentStepId: string;
+                        context: WorkflowContext;
+                    }, xstate.EventObject>;
+                    id: string | undefined;
+                } extends infer T_2 ? T_2 extends {
+                    src: "spawnSubscriberFunction";
+                    logic: xstate.PromiseActorLogic<{
+                        steps: {};
+                    }, {
+                        parentStepId: string;
+                        context: WorkflowContext;
+                    }, xstate.EventObject>;
+                    id: string | undefined;
+                } ? T_2 extends {
+                    src: TSrc;
+                } ? xstate.ConditionalRequired<[options?: ({
+                    id?: T_2["id"] | undefined;
+                    systemId?: string;
+                    input?: xstate.InputFrom<T_2["logic"]> | undefined;
+                    syncSnapshot?: boolean;
+                } & { [K_2 in xstate.RequiredActorOptions<T_2>]: unknown; }) | undefined], xstate.IsNotNever<xstate.RequiredActorOptions<T_2>>> : never : never : never)): xstate.ActorRefFromLogic<xstate.GetConcreteByKey<xstate.Values<{
+                    conditionCheck: {
+                        src: "conditionCheck";
+                        logic: xstate.PromiseActorLogic<{
+                            type: "CONDITIONS_MET";
+                            error?: undefined;
+                        } | {
+                            type: "CONDITIONS_SKIP_TO_COMPLETED";
+                            error?: undefined;
+                        } | {
+                            type: "CONDITIONS_LIMBO";
+                            error?: undefined;
+                        } | {
+                            type: "CONDITIONS_SKIPPED";
+                            error?: undefined;
+                        } | {
+                            type: "CONDITION_FAILED";
+                            error: string;
+                        }, {
+                            context: WorkflowContext;
+                            stepNode: StepNode;
+                        }, xstate.EventObject>;
+                        id: string | undefined;
+                    };
+                    resolverFunction: {
+                        src: "resolverFunction";
+                        logic: xstate.PromiseActorLogic<{
+                            type: "STEP_FAILED";
+                            error: string;
+                            stepId: string;
+                            result?: undefined;
+                        } | {
+                            type: "STEP_WAITING";
+                            stepId: string;
+                            error?: undefined;
+                            result?: undefined;
+                        } | {
+                            type: "STEP_SUCCESS";
+                            result: any;
+                            stepId: string;
+                            error?: undefined;
+                        }, ResolverFunctionInput, xstate.EventObject>;
+                        id: string | undefined;
+                    };
+                    spawnSubscriberFunction: {
+                        src: "spawnSubscriberFunction";
+                        logic: xstate.PromiseActorLogic<{
+                            steps: {};
+                        }, {
+                            parentStepId: string;
+                            context: WorkflowContext;
+                        }, xstate.EventObject>;
+                        id: string | undefined;
+                    };
+                }>, "src", TSrc>["logic"]>;
+                <TLogic extends xstate.AnyActorLogic>(src: TLogic, ...[options]: xstate.ConditionalRequired<[options?: ({
+                    id?: never;
+                    systemId?: string;
+                    input?: xstate.InputFrom<TLogic> | undefined;
+                    syncSnapshot?: boolean;
+                } & { [K in xstate.RequiredLogicInput<TLogic>]: unknown; }) | undefined], xstate.IsNotNever<xstate.RequiredLogicInput<TLogic>>>): xstate.ActorRefFromLogic<TLogic>;
+            };
+            input: Omit<WorkflowContext<any, Step<string, any, any, any>[], Record<string, any>>, "getStepResult">;
+            self: xstate.ActorRef<xstate.MachineSnapshot<Omit<WorkflowContext<any, Step<string, any, any, any>[], Record<string, any>>, "getStepResult">, {
+                type: "RESET_TO_PENDING";
+                stepId: string;
+            } | {
+                type: "CONDITIONS_MET";
+                stepId: string;
+            } | {
+                type: "CONDITION_FAILED";
+                stepId: string;
+                error: string;
+            } | {
+                type: "SUSPENDED";
+                stepId: string;
+                suspendPayload?: any;
+                softSuspend?: any;
+            } | {
+                type: "WAITING";
+                stepId: string;
+            } | {
+                type: `xstate.error.actor.${string}`;
+                error: Error;
+            } | {
+                type: `xstate.done.actor.${string}`;
+                output: ResolverFunctionOutput;
+            }, Record<string, xstate.AnyActorRef | undefined>, xstate.StateValue, string, unknown, any, any>, {
+                type: "RESET_TO_PENDING";
+                stepId: string;
+            } | {
+                type: "CONDITIONS_MET";
+                stepId: string;
+            } | {
+                type: "CONDITION_FAILED";
+                stepId: string;
+                error: string;
+            } | {
+                type: "SUSPENDED";
+                stepId: string;
+                suspendPayload?: any;
+                softSuspend?: any;
+            } | {
+                type: "WAITING";
+                stepId: string;
+            } | {
+                type: `xstate.error.actor.${string}`;
+                error: Error;
+            } | {
+                type: `xstate.done.actor.${string}`;
+                output: ResolverFunctionOutput;
+            }, xstate.AnyEventObject>;
+        }) => {
+            mastra?: MastraUnion | undefined;
+            triggerData: any;
+            isResume?: {
+                runId: string;
+                stepId: string;
+            } | undefined;
+            steps: {
+                [x: string]: {
+                    status: "failed";
+                    error: string;
+                } | {
+                    status: "waiting";
+                } | {
+                    status: "skipped";
+                } | {
+                    status: "success";
+                    output: unknown;
+                } | {
+                    status: "suspended";
+                    suspendPayload?: any;
+                    output?: unknown;
+                } | {
+                    status: "success";
+                    output: any;
+                } | {
+                    status: "suspended";
+                    suspendPayload?: any;
+                    output?: any;
+                };
+            };
+            inputData: Record<string, any>;
+            attempts: Record<string, number>;
+        };
+        readonly states: any;
+    }> | undefined;
+}
+
+interface WorkflowResultReturn<TResult extends z.ZodObject<any>, T extends z.ZodObject<any>, TSteps extends Step<any, any, any>[]> {
+    runId: string;
+    start: (props?: {
+        triggerData?: z.infer<T>;
+        container?: Container;
+    } | undefined) => Promise<WorkflowRunResult<T, TSteps, TResult>>;
+    watch: (onTransition: (state: Pick<WorkflowRunResult<T, TSteps, TResult>, 'results' | 'activePaths' | 'runId'>) => void) => () => void;
+    resume: (props: {
+        stepId: string;
+        context?: Record<string, any>;
+        container?: Container;
+    }) => Promise<Omit<WorkflowRunResult<T, TSteps, TResult>, 'runId'> | undefined>;
+    resumeWithEvent: (eventName: string, data: any, container?: Container) => Promise<Omit<WorkflowRunResult<T, TSteps, TResult>, 'runId'> | undefined>;
+}
+declare class WorkflowInstance<TSteps extends Step<any, any, any, any>[] = Step<any, any, any, any>[], TTriggerSchema extends z.ZodObject<any> = any, TResult extends z.ZodObject<any> = any> implements WorkflowResultReturn<TResult, TTriggerSchema, TSteps> {
+    #private;
+    name: string;
+    logger: Logger;
+    events?: Record<string, {
+        schema: z.ZodObject<any>;
+    }>;
+    constructor({ name, logger, steps, runId, retryConfig, mastra, stepGraph, stepSubscriberGraph, onFinish, onStepTransition, resultMapping, events, }: {
+        name: string;
+        logger: Logger;
+        steps: Record<string, StepNode>;
+        mastra?: Mastra;
+        retryConfig?: RetryConfig;
+        runId?: string;
+        stepGraph: StepGraph;
+        stepSubscriberGraph: Record<string, StepGraph>;
+        onFinish?: () => void;
+        onStepTransition?: Set<(state: Pick<WorkflowRunResult<TTriggerSchema, TSteps, TResult>, 'results' | 'activePaths' | 'runId' | 'timestamp'>) => void | Promise<void>>;
+        resultMapping?: Record<string, {
+            step: StepAction<any, any, any, any>;
+            path: string;
+        }>;
+        events?: Record<string, {
+            schema: z.ZodObject<any>;
+        }>;
+    });
+    setState(state: any): void;
+    get runId(): string;
+    get executionSpan(): Span | undefined;
+    watch(onTransition: (state: Pick<WorkflowRunResult<TTriggerSchema, TSteps, TResult>, 'results' | 'activePaths' | 'runId' | 'timestamp'>) => void): () => void;
+    start({ triggerData, container }?: {
+        triggerData?: z.infer<TTriggerSchema>;
+        container?: Container;
+    }): Promise<{
+        runId: string;
+        timestamp: number;
+        result?: z.TypeOf<TResult> | undefined;
+        triggerData?: z.TypeOf<TTriggerSchema> | undefined;
+        results: { [K in keyof StepsRecord<TSteps>]: StepsRecord<TSteps>[K]["outputSchema"] extends undefined ? StepResult<unknown> : StepResult<z.TypeOf<NonNullable<StepsRecord<TSteps>[K]["outputSchema"]>>>; };
+        activePaths: Map<TSteps[number]["id"], {
+            status: string;
+            suspendPayload?: any;
+            stepPath: string[];
+        }>;
+    }>;
+    private isCompoundDependencyMet;
+    execute({ triggerData, snapshot, stepId, resumeData, container, }?: {
+        stepId?: string;
+        triggerData?: z.infer<TTriggerSchema>;
+        snapshot?: Snapshot<any>;
+        resumeData?: any;
+        container: Container;
+    }): Promise<Omit<WorkflowRunResult<TTriggerSchema, TSteps, TResult>, 'runId'>>;
+    hasSubscribers(stepId: string): boolean;
+    runMachine(parentStepId: string, input: any, container?: Container): Promise<(Pick<WorkflowRunResult<TTriggerSchema, TSteps, TResult>, "runId" | "timestamp" | "results" | "activePaths"> | undefined)[]>;
+    suspend(stepId: string, machine: Machine<TSteps, TTriggerSchema>): Promise<void>;
+    /**
+     * Persists the workflow state to the database
+     */
+    persistWorkflowSnapshot(): Promise<void>;
+    getState(): Promise<WorkflowRunState | null>;
+    resumeWithEvent(eventName: string, data: any, container?: Container): Promise<Omit<WorkflowRunResult<TTriggerSchema, TSteps, TResult>, "runId"> | undefined>;
+    resume({ stepId, context: resumeContext, container, }: {
+        stepId: string;
+        context?: Record<string, any>;
+        container?: Container;
+    }): Promise<Omit<WorkflowRunResult<TTriggerSchema, TSteps, TResult>, "runId"> | undefined>;
+    _resume({ stepId, context: resumeContext, container, }: {
+        stepId: string;
+        context?: Record<string, any>;
+        container: Container;
+    }): Promise<Omit<WorkflowRunResult<TTriggerSchema, TSteps, TResult>, "runId"> | undefined>;
+}
+
+type WorkflowBuilder<T extends Workflow<any, any>> = Pick<T, 'step' | 'then' | 'after' | 'while' | 'until' | 'if' | 'else' | 'afterEvent' | 'commit'>;
+declare class Workflow<TSteps extends Step<string, any, any>[] = Step<string, any, any>[], TStepId extends string = string, TTriggerSchema extends z.ZodObject<any> = any, TResultSchema extends z.ZodObject<any> = any> extends MastraBase {
+    #private;
+    name: TStepId;
+    triggerSchema?: TTriggerSchema;
+    resultSchema?: TResultSchema;
+    resultMapping?: Record<string, {
+        step: StepAction<string, any, any, any>;
+        path: string;
+    }>;
+    events?: Record<string, {
+        schema: z.ZodObject<any>;
+    }>;
+    isNested: boolean;
+    /**
+     * Creates a new Workflow instance
+     * @param name - Identifier for the workflow (not necessarily unique)
+     * @param logger - Optional logger instance
+     */
+    constructor({ name, triggerSchema, result, retryConfig, mastra, events, }: WorkflowOptions<TStepId, TSteps, TTriggerSchema, TResultSchema>);
+    step<TWorkflow extends Workflow<any, any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>, Steps extends StepAction<any, any, any, any>[] = TSteps>(next: TWorkflow, config?: StepConfig<ReturnType<TWorkflow['toStep']>, CondStep, VarStep, TTriggerSchema, Steps>): WorkflowBuilder<this>;
+    step<TAgent extends Agent<any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>, Steps extends StepAction<any, any, any, any>[] = TSteps>(next: TAgent, config?: StepConfig<ReturnType<TAgent['toStep']>, CondStep, VarStep, TTriggerSchema, Steps>): WorkflowBuilder<this>;
+    step<TStep extends StepAction<any, any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>, Steps extends StepAction<any, any, any, any>[] = TSteps>(step: TStep, config?: StepConfig<TStep, CondStep, VarStep, TTriggerSchema, Steps>): WorkflowBuilder<this>;
+    then<TStep extends StepAction<string, any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>>(next: TStep | TStep[], config?: StepConfig<TStep, CondStep, VarStep, TTriggerSchema>): this;
+    then<TWorkflow extends Workflow<any, any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>>(next: TWorkflow | TWorkflow[], config?: StepConfig<StepAction<string, any, any, any>, CondStep, VarStep, TTriggerSchema>): this;
+    then<TAgent extends Agent<any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>>(next: TAgent | TAgent[], config?: StepConfig<StepAction<string, any, any, any>, CondStep, VarStep, TTriggerSchema>): this;
+    private loop;
+    while<FallbackStep extends StepAction<string, any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>>(condition: StepConfig<FallbackStep, CondStep, VarStep, TTriggerSchema, TSteps>['when'], fallbackStep: FallbackStep, variables?: StepConfig<FallbackStep, CondStep, VarStep, TTriggerSchema, TSteps>['variables']): Pick<WorkflowBuilder<this>, "then" | "commit">;
+    until<FallbackStep extends StepAction<string, any, any, any>, CondStep extends StepVariableType<any, any, any, any>, VarStep extends StepVariableType<any, any, any, any>>(condition: StepConfig<FallbackStep, CondStep, VarStep, TTriggerSchema, TSteps>['when'], fallbackStep: FallbackStep, variables?: StepConfig<FallbackStep, CondStep, VarStep, TTriggerSchema, TSteps>['variables']): Pick<WorkflowBuilder<this>, "then" | "commit">;
+    if<TStep extends StepAction<string, any, any, any>>(condition: StepConfig<TStep, any, any, TTriggerSchema>['when'], ifStep?: TStep | Workflow, elseStep?: TStep | Workflow): this | WorkflowBuilder<this>;
+    else(): WorkflowBuilder<this>;
+    after<TStep extends StepAction<string, any, any, any>>(steps: string | TStep | TStep[] | (TStep | string)[]): Omit<WorkflowBuilder<this>, 'then' | 'after'>;
+    after<TWorkflow extends Workflow<any, any, any, any>>(steps: TWorkflow | TWorkflow[]): Omit<WorkflowBuilder<this>, 'then' | 'after'>;
+    after<TAgent extends Agent<any, any, any>>(steps: TAgent | TAgent[]): Omit<WorkflowBuilder<this>, 'then' | 'after'>;
+    afterEvent(eventName: string): WorkflowBuilder<this>;
+    /**
+     * Executes the workflow with the given trigger data
+     * @param triggerData - Initial data to start the workflow with
+     * @returns Promise resolving to workflow results or rejecting with error
+     * @throws Error if trigger schema validation fails
+     */
+    createRun({ runId, events, }?: {
+        runId?: string;
+        events?: Record<string, {
+            schema: z.ZodObject<any>;
+        }>;
+    }): WorkflowResultReturn<TResultSchema, TTriggerSchema, TSteps>;
+    /**
+     * Gets a workflow run instance by ID
+     * @param runId - ID of the run to retrieve
+     * @returns The workflow run instance if found, undefined otherwise
+     */
+    getRun(runId: string): WorkflowInstance<TSteps, TTriggerSchema, any> | undefined;
+    /**
+     * Rebuilds the machine with the current steps configuration and validates the workflow
+     *
+     * This is the last step of a workflow builder method chain
+     * @throws Error if validation fails
+     *
+     * @returns this instance for method chaining
+     */
+    commit(): this;
+    getWorkflowRuns(): Promise<WorkflowRuns>;
+    getExecutionSpan(runId: string): Span | undefined;
+    getState(runId: string): Promise<WorkflowRunState | null>;
+    resume({ runId, stepId, context: resumeContext, container, }: {
+        runId: string;
+        stepId: string;
+        context?: Record<string, any>;
+        container: Container;
+    }): Promise<Omit<WorkflowRunResult<TTriggerSchema, TSteps, any>, "runId"> | undefined>;
+    watch(onTransition: (state: Pick<WorkflowRunResult<TTriggerSchema, TSteps, TResultSchema>, 'results' | 'activePaths' | 'runId' | 'timestamp'>) => void): () => void;
+    resumeWithEvent(runId: string, eventName: string, data: any): Promise<Omit<WorkflowRunResult<TTriggerSchema, TSteps, any>, "runId"> | undefined>;
+    __registerMastra(mastra: Mastra): void;
+    __registerPrimitives(p: MastraPrimitives): void;
+    get stepGraph(): StepGraph;
+    get stepSubscriberGraph(): Record<string, StepGraph>;
+    get serializedStepGraph(): StepGraph;
+    get serializedStepSubscriberGraph(): Record<string, StepGraph>;
+    get steps(): Record<string, StepAction<string, any, any, any>>;
+    setNested(isNested: boolean): void;
+    toStep(): Step<TStepId, TTriggerSchema, z.ZodType<WorkflowRunResult<TTriggerSchema, TSteps, TResultSchema>>, any>;
+}
+
+type MemoryProcessorOpts = {
+    systemMessage?: string;
+    memorySystemMessage?: string;
+    newMessages?: CoreMessage$1[];
+};
+/**
+ * Interface for message processors that can filter or transform messages
+ * before they're sent to the LLM.
+ */
+declare abstract class MemoryProcessor extends MastraBase {
+    /**
+     * Process a list of messages and return a filtered or transformed list.
+     * @param messages The messages to process
+     * @returns The processed messages
+     */
+    process(messages: CoreMessage$1[], _opts: MemoryProcessorOpts): CoreMessage$1[];
+}
+/**
+ * Abstract Memory class that defines the interface for storing and retrieving
+ * conversation threads and messages.
+ */
+declare abstract class MastraMemory extends MastraBase {
+    MAX_CONTEXT_TOKENS?: number;
+    storage: MastraStorage;
+    vector?: MastraVector;
+    embedder?: EmbeddingModel<string>;
+    private processors;
+    protected threadConfig: MemoryConfig;
+    constructor(config: {
+        name: string;
+    } & SharedMemoryConfig);
+    setStorage(storage: MastraStorage): void;
+    setVector(vector: MastraVector): void;
+    setEmbedder(embedder: EmbeddingModel<string>): void;
+    /**
+     * Get a system message to inject into the conversation.
+     * This will be called before each conversation turn.
+     * Implementations can override this to inject custom system messages.
+     */
+    getSystemMessage(_input: {
+        threadId: string;
+        memoryConfig?: MemoryConfig;
+    }): Promise<string | null>;
+    /**
+     * Get tools that should be available to the agent.
+     * This will be called when converting tools for the agent.
+     * Implementations can override this to provide additional tools.
+     */
+    getTools(_config?: MemoryConfig): Record<string, CoreTool>;
+    protected createEmbeddingIndex(dimensions?: number): Promise<{
+        indexName: string;
+    }>;
+    getMergedThreadConfig(config?: MemoryConfig): MemoryConfig;
+    /**
+     * Apply all configured message processors to a list of messages.
+     * @param messages The messages to process
+     * @returns The processed messages
+     */
+    private applyProcessors;
+    processMessages({ messages, processors, ...opts }: {
+        messages: CoreMessage$1[];
+        processors?: MemoryProcessor[];
+    } & MemoryProcessorOpts): CoreMessage$1[];
+    abstract rememberMessages({ threadId, resourceId, vectorMessageSearch, systemMessage, config, }: {
+        threadId: string;
+        resourceId?: string;
+        vectorMessageSearch?: string;
+        systemMessage?: CoreMessage$1;
+        config?: MemoryConfig;
+    }): Promise<{
+        threadId: string;
+        messages: CoreMessage$1[];
+        uiMessages: Message[];
+    }>;
+    estimateTokens(text: string): number;
+    protected parseMessages(messages: MessageType[]): CoreMessage$1[];
+    protected convertToUIMessages(messages: MessageType[]): Message[];
+    /**
+     * Retrieves a specific thread by its ID
+     * @param threadId - The unique identifier of the thread
+     * @returns Promise resolving to the thread or null if not found
+     */
+    abstract getThreadById({ threadId }: {
+        threadId: string;
+    }): Promise<StorageThreadType | null>;
+    abstract getThreadsByResourceId({ resourceId }: {
+        resourceId: string;
+    }): Promise<StorageThreadType[]>;
+    /**
+     * Saves or updates a thread
+     * @param thread - The thread data to save
+     * @returns Promise resolving to the saved thread
+     */
+    abstract saveThread({ thread, memoryConfig, }: {
+        thread: StorageThreadType;
+        memoryConfig?: MemoryConfig;
+    }): Promise<StorageThreadType>;
+    /**
+     * Saves messages to a thread
+     * @param messages - Array of messages to save
+     * @returns Promise resolving to the saved messages
+     */
+    abstract saveMessages({ messages, memoryConfig, }: {
+        messages: MessageType[];
+        memoryConfig: MemoryConfig | undefined;
+    }): Promise<MessageType[]>;
+    /**
+     * Retrieves all messages for a specific thread
+     * @param threadId - The unique identifier of the thread
+     * @returns Promise resolving to array of messages and uiMessages
+     */
+    abstract query({ threadId, resourceId, selectBy, }: StorageGetMessagesArg): Promise<{
+        messages: CoreMessage$1[];
+        uiMessages: Message[];
+    }>;
+    /**
+     * Helper method to create a new thread
+     * @param title - Optional title for the thread
+     * @param metadata - Optional metadata for the thread
+     * @returns Promise resolving to the created thread
+     */
+    createThread({ threadId, resourceId, title, metadata, memoryConfig, }: {
+        resourceId: string;
+        threadId?: string;
+        title?: string;
+        metadata?: Record<string, unknown>;
+        memoryConfig?: MemoryConfig;
+    }): Promise<StorageThreadType>;
+    /**
+     * Helper method to delete a thread
+     * @param threadId - the id of the thread to delete
+     */
+    abstract deleteThread(threadId: string): Promise<void>;
+    /**
+     * Helper method to add a single message to a thread
+     * @param threadId - The thread to add the message to
+     * @param content - The message content
+     * @param role - The role of the message sender
+     * @param type - The type of the message
+     * @param toolNames - Optional array of tool names that were called
+     * @param toolCallArgs - Optional array of tool call arguments
+     * @param toolCallIds - Optional array of tool call ids
+     * @returns Promise resolving to the saved message
+     */
+    addMessage({ threadId, resourceId, config, content, role, type, toolNames, toolCallArgs, toolCallIds, }: {
+        threadId: string;
+        resourceId: string;
+        config?: MemoryConfig;
+        content: UserContent | AssistantContent;
+        role: 'user' | 'assistant';
+        type: 'text' | 'tool-call' | 'tool-result';
+        toolNames?: string[];
+        toolCallArgs?: Record<string, unknown>[];
+        toolCallIds?: string[];
+    }): Promise<MessageType>;
+    /**
+     * Generates a unique identifier
+     * @returns A unique string ID
+     */
+    generateId(): string;
+}
+
+type LanguageModel = MastraLanguageModel;
+type CoreMessage = CoreMessage$1;
+type CoreSystemMessage = CoreSystemMessage$1;
+type CoreAssistantMessage = CoreAssistantMessage$1;
+type CoreUserMessage = CoreUserMessage$1;
+type CoreToolMessage = CoreToolMessage$1;
+type EmbedResult<T> = EmbedResult$1<T>;
+type EmbedManyResult<T> = EmbedManyResult$1<T>;
+type BaseStructuredOutputType = 'string' | 'number' | 'boolean' | 'date';
+type StructuredOutputType = 'array' | 'string' | 'number' | 'object' | 'boolean' | 'date';
+type StructuredOutputArrayItem = {
+    type: BaseStructuredOutputType;
+} | {
+    type: 'object';
+    items: StructuredOutput;
+};
+type StructuredOutput = {
+    [key: string]: {
+        type: BaseStructuredOutputType;
+    } | {
+        type: 'object';
+        items: StructuredOutput;
+    } | {
+        type: 'array';
+        items: StructuredOutputArrayItem;
+    };
+};
+type GenerateReturn<Z extends ZodSchema | JSONSchema7 | undefined = undefined> = Z extends undefined ? GenerateTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown> : GenerateObjectResult<Z extends ZodSchema ? z.infer<Z> : unknown>;
+type StreamReturn<Z extends ZodSchema | JSONSchema7 | undefined = undefined> = Z extends undefined ? StreamTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown> : StreamObjectResult<any, Z extends ZodSchema ? z.infer<Z> : unknown, any>;
+type OutputType = StructuredOutput | ZodSchema | JSONSchema7 | undefined;
+type GenerateTextOptions = Parameters<typeof generateText>[0];
+type StreamTextOptions = Parameters<typeof streamText>[0];
+type GenerateObjectOptions = Parameters<typeof generateObject>[0];
+type StreamObjectOptions = Parameters<typeof streamObject>[0];
+type MastraCustomLLMOptionsKeys = 'messages' | 'tools' | 'model' | 'onStepFinish' | 'experimental_output' | 'experimental_telemetry' | 'messages' | 'onFinish' | 'output';
+type DefaultLLMTextOptions = Omit<GenerateTextOptions, MastraCustomLLMOptionsKeys>;
+type DefaultLLMTextObjectOptions = Omit<GenerateObjectOptions, MastraCustomLLMOptionsKeys>;
+type DefaultLLMStreamOptions = Omit<StreamTextOptions, MastraCustomLLMOptionsKeys>;
+type DefaultLLMStreamObjectOptions = Omit<StreamObjectOptions, MastraCustomLLMOptionsKeys>;
+type MastraCustomLLMOptions<Z extends ZodSchema | JSONSchema7 | undefined = undefined> = {
+    tools?: ToolsInput;
+    convertedTools?: Record<string, CoreTool>;
+    onStepFinish?: (step: unknown) => void;
+    experimental_output?: Z;
+    telemetry?: TelemetrySettings;
+    threadId?: string;
+    resourceId?: string;
+    container: Container;
+} & Run;
+type LLMTextOptions<Z extends ZodSchema | JSONSchema7 | undefined = undefined> = {
+    messages: CoreMessage[];
+} & MastraCustomLLMOptions<Z> & DefaultLLMTextOptions;
+type LLMTextObjectOptions<T extends ZodSchema | JSONSchema7 | undefined = undefined> = LLMTextOptions<T> & DefaultLLMTextObjectOptions & {
+    structuredOutput: JSONSchema7 | z.ZodType<T> | StructuredOutput;
+};
+type LLMStreamOptions<Z extends ZodSchema | JSONSchema7 | undefined = undefined> = {
+    output?: OutputType | Z;
+    onFinish?: (result: string) => Promise<void> | void;
+} & MastraCustomLLMOptions<Z> & DefaultLLMStreamOptions;
+type LLMInnerStreamOptions<Z extends ZodSchema | JSONSchema7 | undefined = undefined> = {
+    messages: CoreMessage[];
+    onFinish?: (result: string) => Promise<void> | void;
+} & MastraCustomLLMOptions<Z> & DefaultLLMStreamOptions;
+type LLMStreamObjectOptions<T extends ZodSchema | JSONSchema7 | undefined = undefined> = {
+    structuredOutput: JSONSchema7 | z.ZodType<T> | StructuredOutput;
+} & LLMInnerStreamOptions<T> & DefaultLLMStreamObjectOptions;
+
+type VoiceEventType = 'speaking' | 'writing' | 'error' | string;
+interface VoiceEventMap {
+    speaker: NodeJS.ReadableStream;
+    speaking: {
+        audio?: string;
+    };
+    writing: {
+        text: string;
+        role: 'assistant' | 'user';
+    };
+    error: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+    [key: string]: unknown;
+}
+interface BuiltInModelConfig {
+    name: string;
+    apiKey?: string;
+}
+interface VoiceConfig<T = unknown> {
+    listeningModel?: BuiltInModelConfig;
+    speechModel?: BuiltInModelConfig;
+    speaker?: string;
+    name?: string;
+    realtimeConfig?: {
+        model?: string;
+        apiKey?: string;
+        options?: T;
+    };
+}
+declare abstract class MastraVoice<TOptions = unknown, TSpeakOptions = unknown, TListenOptions = unknown, TTools extends ToolsInput = ToolsInput, TEventArgs extends VoiceEventMap = VoiceEventMap, TSpeakerMetadata = unknown> extends MastraBase {
+    protected listeningModel?: BuiltInModelConfig;
+    protected speechModel?: BuiltInModelConfig;
+    protected speaker?: string;
+    protected realtimeConfig?: {
+        model?: string;
+        apiKey?: string;
+        options?: TOptions;
+    };
+    constructor({ listeningModel, speechModel, speaker, realtimeConfig, name }?: VoiceConfig<TOptions>);
+    traced<T extends Function>(method: T, methodName: string): T;
+    /**
+     * Convert text to speech
+     * @param input Text or text stream to convert to speech
+     * @param options Speech options including speaker and provider-specific options
+     * @returns Audio stream
+     */
+    /**
+     * Convert text to speech
+     * @param input Text or text stream to convert to speech
+     * @param options Speech options including speaker and provider-specific options
+     * @returns Audio stream or void if in chat mode
+     */
+    abstract speak(input: string | NodeJS.ReadableStream, options?: {
+        speaker?: string;
+    } & TSpeakOptions): Promise<NodeJS.ReadableStream | void>;
+    /**
+     * Convert speech to text
+     * @param audioStream Audio stream to transcribe
+     * @param options Provider-specific transcription options
+     * @returns Text or text stream
+     */
+    /**
+     * Convert speech to text
+     * @param audioStream Audio stream to transcribe
+     * @param options Provider-specific transcription options
+     * @returns Text, text stream, or void if in chat mode
+     */
+    abstract listen(audioStream: NodeJS.ReadableStream | unknown, // Allow other audio input types for OpenAI realtime API
+    options?: TListenOptions): Promise<string | NodeJS.ReadableStream | void>;
+    updateConfig(_options: Record<string, unknown>): void;
+    /**
+     * Initializes a WebSocket or WebRTC connection for real-time communication
+     * @returns Promise that resolves when the connection is established
+     */
+    connect(_options?: Record<string, unknown>): Promise<void>;
+    /**
+     * Relay audio data to the voice provider for real-time processing
+     * @param audioData Audio data to relay
+     */
+    send(_audioData: NodeJS.ReadableStream | Int16Array): Promise<void>;
+    /**
+     * Trigger voice providers to respond
+     */
+    answer(_options?: Record<string, unknown>): Promise<void>;
+    /**
+     * Equip the voice provider with instructions
+     * @param instructions Instructions to add
+     */
+    addInstructions(_instructions?: string): void;
+    /**
+     * Equip the voice provider with tools
+     * @param tools Array of tools to add
+     */
+    addTools(_tools: TTools): void;
+    /**
+     * Disconnect from the WebSocket or WebRTC connection
+     */
+    close(): void;
+    /**
+     * Register an event listener
+     * @param event Event name (e.g., 'speaking', 'writing', 'error')
+     * @param callback Callback function that receives event data
+     */
+    on<E extends VoiceEventType>(_event: E, _callback: (data: E extends keyof TEventArgs ? TEventArgs[E] : unknown) => void): void;
+    /**
+     * Remove an event listener
+     * @param event Event name (e.g., 'speaking', 'writing', 'error')
+     * @param callback Callback function to remove
+     */
+    off<E extends VoiceEventType>(_event: E, _callback: (data: E extends keyof TEventArgs ? TEventArgs[E] : unknown) => void): void;
+    /**
+     * Get available speakers/voices
+     * @returns Array of available voice IDs and their metadata
+     */
+    getSpeakers(): Promise<Array<{
+        voiceId: string;
+    } & TSpeakerMetadata>>;
+}
+
+declare class CompositeVoice extends MastraVoice<unknown, unknown, unknown, ToolsInput, VoiceEventMap> {
+    protected speakProvider?: MastraVoice;
+    protected listenProvider?: MastraVoice;
+    protected realtimeProvider?: MastraVoice;
+    constructor({ input, output, realtime, speakProvider, listenProvider, realtimeProvider, }: {
+        /** @deprecated use output instead */
+        speakProvider?: MastraVoice;
+        /** @deprecated use input instead */
+        listenProvider?: MastraVoice;
+        /** @deprecated use realtime instead */
+        realtimeProvider?: MastraVoice;
+        input?: MastraVoice;
+        output?: MastraVoice;
+        realtime?: MastraVoice;
+    });
+    /**
+     * Convert text to speech using the configured provider
+     * @param input Text or text stream to convert to speech
+     * @param options Speech options including speaker and provider-specific options
+     * @returns Audio stream or void if in realtime mode
+     */
+    speak(input: string | NodeJS.ReadableStream, options?: {
+        speaker?: string;
+    } & any): Promise<NodeJS.ReadableStream | void>;
+    listen(audioStream: NodeJS.ReadableStream, options?: any): Promise<string | void | NodeJS.ReadableStream>;
+    getSpeakers(): Promise<{
+        voiceId: string;
+    }[]>;
+    updateConfig(options: Record<string, unknown>): void;
+    /**
+     * Initializes a WebSocket or WebRTC connection for real-time communication
+     * @returns Promise that resolves when the connection is established
+     */
+    connect(options?: Record<string, unknown>): Promise<void>;
+    /**
+     * Relay audio data to the voice provider for real-time processing
+     * @param audioData Audio data to send
+     */
+    send(audioData: NodeJS.ReadableStream | Int16Array): Promise<void>;
+    /**
+     * Trigger voice providers to respond
+     */
+    answer(options?: Record<string, unknown>): Promise<void>;
+    /**
+     * Equip the voice provider with instructions
+     * @param instructions Instructions to add
+     */
+    addInstructions(instructions: string): void;
+    /**
+     * Equip the voice provider with tools
+     * @param tools Array of tools to add
+     */
+    addTools(tools: ToolsInput): void;
+    /**
+     * Disconnect from the WebSocket or WebRTC connection
+     */
+    close(): void;
+    /**
+     * Register an event listener
+     * @param event Event name (e.g., 'speaking', 'writing', 'error')
+     * @param callback Callback function that receives event data
+     */
+    on<E extends VoiceEventType>(event: E, callback: (data: E extends keyof VoiceEventMap ? VoiceEventMap[E] : unknown) => void): void;
+    /**
+     * Remove an event listener
+     * @param event Event name (e.g., 'speaking', 'writing', 'error')
+     * @param callback Callback function to remove
+     */
+    off<E extends VoiceEventType>(event: E, callback: (data: E extends keyof VoiceEventMap ? VoiceEventMap[E] : unknown) => void): void;
+}
+
+type ToolsInput = Record<string, ToolAction<any, any, any> | VercelTool>;
+type ToolsetsInput = Record<string, ToolsInput>;
+type MastraLanguageModel = LanguageModelV1;
+interface AgentConfig<TAgentId extends string = string, TTools extends ToolsInput = ToolsInput, TMetrics extends Record<string, Metric> = Record<string, Metric>> {
+    name: TAgentId;
+    instructions: string;
+    model: MastraLanguageModel;
+    defaultGenerateOptions?: AgentGenerateOptions;
+    defaultStreamOptions?: AgentStreamOptions;
+    tools?: TTools;
+    mastra?: Mastra;
+    /** @deprecated This property is deprecated. Use evals instead to add evaluation metrics. */
+    metrics?: TMetrics;
+    evals?: TMetrics;
+    memory?: MastraMemory;
+    voice?: CompositeVoice;
+}
+/**
+ * Options for generating responses with an agent
+ * @template Z - The schema type for structured output (Zod schema or JSON schema)
+ */
+type AgentGenerateOptions<Z extends ZodSchema | JSONSchema7 | undefined = undefined> = {
+    /** Optional instructions to override the agent's default instructions */
+    instructions?: string;
+    /** Additional tool sets that can be used for this generation */
+    toolsets?: ToolsetsInput;
+    clientTools?: ToolsInput;
+    /** Additional context messages to include */
+    context?: CoreMessage[];
+    /** Memory configuration options */
+    memoryOptions?: MemoryConfig;
+    /** Unique ID for this generation run */
+    runId?: string;
+    /** Callback fired after each generation step completes */
+    onStepFinish?: Z extends undefined ? GenerateTextOnStepFinishCallback<any> : never;
+    /** Maximum number of steps allowed for generation */
+    maxSteps?: number;
+    /** Schema for structured output, does not work with tools, use experimental_output instead */
+    output?: OutputType | Z;
+    /** Schema for structured output generation alongside tool calls. */
+    experimental_output?: Z;
+    /** Controls how tools are selected during generation */
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        type: 'tool';
+        toolName: string;
+    };
+    /** Telemetry settings */
+    telemetry?: TelemetrySettings;
+    /** Container for dependency injection */
+    container?: Container;
+} & ({
+    resourceId?: undefined;
+    threadId?: undefined;
+} | {
+    resourceId: string;
+    threadId: string;
+}) & (Z extends undefined ? DefaultLLMTextOptions : DefaultLLMTextObjectOptions);
+/**
+ * Options for streaming responses with an agent
+ * @template Z - The schema type for structured output (Zod schema or JSON schema)
+ */
+type AgentStreamOptions<Z extends ZodSchema | JSONSchema7 | undefined = undefined> = {
+    /** Optional instructions to override the agent's default instructions */
+    instructions?: string;
+    /** Additional tool sets that can be used for this generation */
+    toolsets?: ToolsetsInput;
+    clientTools?: ToolsInput;
+    /** Additional context messages to include */
+    context?: CoreMessage[];
+    /** Memory configuration options */
+    memoryOptions?: MemoryConfig;
+    /** Unique ID for this generation run */
+    runId?: string;
+    /** Callback fired when streaming completes */
+    onFinish?: Z extends undefined ? StreamTextOnFinishCallback<any> : Z extends ZodSchema ? StreamObjectOnFinishCallback<z.infer<Z>> : StreamObjectOnFinishCallback<any>;
+    /** Callback fired after each generation step completes */
+    onStepFinish?: Z extends undefined ? StreamTextOnStepFinishCallback<any> : never;
+    /** Maximum number of steps allowed for generation */
+    maxSteps?: number;
+    /** Schema for structured output */
+    output?: OutputType | Z;
+    /** Temperature parameter for controlling randomness */
+    temperature?: number;
+    /** Controls how tools are selected during generation */
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        type: 'tool';
+        toolName: string;
+    };
+    /** Experimental schema for structured output */
+    experimental_output?: Z;
+    /** Telemetry settings */
+    telemetry?: TelemetrySettings;
+    /** Container for dependency injection */
+    container?: Container;
+} & ({
+    resourceId?: undefined;
+    threadId?: undefined;
+} | {
+    resourceId: string;
+    threadId: string;
+}) & (Z extends undefined ? DefaultLLMStreamOptions : DefaultLLMStreamObjectOptions);
+
+type Methods = 'GET' | 'POST' | 'PUT' | 'DELETE';
+type ApiRoute = {
+    path: string;
+    method: Methods;
+    handler: Handler;
+    middleware?: MiddlewareHandler | MiddlewareHandler[];
+    openapi?: DescribeRouteOptions;
+};
+type Middleware = MiddlewareHandler | {
+    path: string;
+    handler: MiddlewareHandler;
+};
+type ServerConfig = {
+    port?: number;
+    timeout?: number;
+    apiRoutes?: ApiRoute[];
+    middleware?: Middleware | Middleware[];
+    /**
+     * CORS configuration for the server
+     * @default { origin: '*', allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'], allowHeaders: ['Content-Type', 'Authorization', 'x-mastra-client-type'], exposeHeaders: ['Content-Length', 'X-Requested-With'], credentials: false }
+     */
+    cors?: Parameters<typeof cors>[0] | false;
+};
+
+interface Config<TAgents extends Record<string, Agent<any>> = Record<string, Agent<any>>, TWorkflows extends Record<string, Workflow> = Record<string, Workflow>, TVectors extends Record<string, MastraVector> = Record<string, MastraVector>, TTTS extends Record<string, MastraTTS> = Record<string, MastraTTS>, TLogger extends Logger = Logger, TNetworks extends Record<string, AgentNetwork> = Record<string, AgentNetwork>> {
+    agents?: TAgents;
+    networks?: TNetworks;
+    storage?: MastraStorage;
+    vectors?: TVectors;
+    logger?: TLogger | false;
+    workflows?: TWorkflows;
+    tts?: TTTS;
+    telemetry?: OtelConfig;
+    deployer?: MastraDeployer;
+    server?: ServerConfig;
+    /**
+     * Server middleware functions to be applied to API routes
+     * Each middleware can specify a path pattern (defaults to '/api/*')
+     * @deprecated use server.middleware instead
+     */
+    serverMiddleware?: Array<{
+        handler: (c: any, next: () => Promise<void>) => Promise<Response | void>;
+        path?: string;
+    }>;
+    memory?: MastraMemory;
+}
+declare class Mastra<TAgents extends Record<string, Agent<any>> = Record<string, Agent<any>>, TWorkflows extends Record<string, Workflow> = Record<string, Workflow>, TVectors extends Record<string, MastraVector> = Record<string, MastraVector>, TTTS extends Record<string, MastraTTS> = Record<string, MastraTTS>, TLogger extends Logger = Logger, TNetworks extends Record<string, AgentNetwork> = Record<string, AgentNetwork>> {
+    #private;
+    /**
+     * @deprecated use getTelemetry() instead
+     */
+    get telemetry(): Telemetry | undefined;
+    /**
+     * @deprecated use getStorage() instead
+     */
+    get storage(): MastraStorage | undefined;
+    /**
+     * @deprecated use getMemory() instead
+     */
+    get memory(): MastraMemory | undefined;
+    constructor(config?: Config<TAgents, TWorkflows, TVectors, TTTS, TLogger>);
+    getAgent<TAgentName extends keyof TAgents>(name: TAgentName): TAgents[TAgentName];
+    getAgents(): TAgents;
+    getVector<TVectorName extends keyof TVectors>(name: TVectorName): TVectors[TVectorName];
+    getVectors(): TVectors | undefined;
+    getDeployer(): MastraDeployer | undefined;
+    getWorkflow<TWorkflowId extends keyof TWorkflows>(id: TWorkflowId, { serialized }?: {
+        serialized?: boolean;
+    }): TWorkflows[TWorkflowId];
+    getWorkflows(props?: {
+        serialized?: boolean;
+    }): Record<string, Workflow>;
+    setStorage(storage: MastraStorage): void;
+    setLogger({ logger }: {
+        logger: TLogger;
+    }): void;
+    setTelemetry(telemetry: OtelConfig): void;
+    getTTS(): TTTS | undefined;
+    getLogger(): TLogger;
+    getTelemetry(): Telemetry | undefined;
+    getMemory(): MastraMemory | undefined;
+    getStorage(): MastraStorage | undefined;
+    getServerMiddleware(): {
+        handler: (c: any, next: () => Promise<void>) => Promise<Response | void>;
+        path: string;
+    }[];
+    getNetworks(): AgentNetwork[];
+    getServer(): ServerConfig | undefined;
+    /**
+     * Get a specific network by ID
+     * @param networkId - The ID of the network to retrieve
+     * @returns The network with the specified ID, or undefined if not found
+     */
+    getNetwork(networkId: string): AgentNetwork | undefined;
+    getLogsByRunId({ runId, transportId }: {
+        runId: string;
+        transportId: string;
+    }): Promise<BaseLogMessage[] | undefined>;
+    getLogs(transportId: string): Promise<BaseLogMessage[]>;
+}
+
+type MastraPrimitives = {
+    logger?: Logger;
+    telemetry?: Telemetry;
+    storage?: MastraStorage;
+    agents?: Record<string, Agent>;
+    tts?: Record<string, MastraTTS>;
+    vectors?: Record<string, MastraVector>;
+    memory?: MastraMemory;
+};
+type MastraUnion = {
+    [K in keyof Mastra]: Mastra[K];
+} & MastraPrimitives;
+interface IExecutionContext<TSchemaIn extends z.ZodSchema | undefined = undefined> {
+    context: TSchemaIn extends z.ZodSchema ? z.infer<TSchemaIn> : {};
+    runId?: string;
+    threadId?: string;
+    resourceId?: string;
+}
+interface IAction<TId extends string, TSchemaIn extends z.ZodSchema | undefined, TSchemaOut extends z.ZodSchema | undefined, TContext extends IExecutionContext<TSchemaIn>, TOptions extends unknown = unknown> {
+    id: TId;
+    description?: string;
+    inputSchema?: TSchemaIn;
+    outputSchema?: TSchemaOut;
+    execute?: (context: TContext, options?: TOptions) => Promise<TSchemaOut extends z.ZodSchema ? z.infer<TSchemaOut> : unknown>;
+}
+
+declare class MastraLLMBase extends MastraBase {
+    #private;
+    constructor({ name, model }: {
+        name: string;
+        model: LanguageModel$1;
+    });
+    getProvider(): string;
+    getModelId(): string;
+    getModel(): ai.LanguageModelV1;
+    convertToMessages(messages: string | string[] | CoreMessage$1[]): CoreMessage$1[];
+    __registerPrimitives(p: MastraPrimitives): void;
+    __registerMastra(p: Mastra): void;
+    __text<Z extends ZodSchema | JSONSchema7 | undefined>(input: LLMTextOptions<Z>): Promise<GenerateTextResult<any, any>>;
+    __textObject<T extends ZodSchema | JSONSchema7 | undefined>(input: LLMTextObjectOptions<T>): Promise<GenerateObjectResult<T>>;
+    generate<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[], options: LLMStreamOptions<Z>): Promise<GenerateReturn<Z>>;
+    __stream<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(input: LLMInnerStreamOptions<Z>): Promise<StreamTextResult<any, any>>;
+    __streamObject<T extends ZodSchema | JSONSchema7 | undefined>(input: LLMStreamObjectOptions<T>): Promise<StreamObjectResult<DeepPartial<T>, T, never>>;
+    stream<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[], options: LLMStreamOptions<Z>): Promise<StreamReturn<Z>>;
+}
+
+declare class Agent<TAgentId extends string = string, TTools extends ToolsInput = ToolsInput, TMetrics extends Record<string, Metric> = Record<string, Metric>> extends MastraBase {
+    #private;
+    name: TAgentId;
+    readonly llm: MastraLLMBase;
+    instructions: string;
+    readonly model?: MastraLanguageModel;
+    tools: TTools;
+    /** @deprecated This property is deprecated. Use evals instead. */
+    metrics: TMetrics;
+    evals: TMetrics;
+    voice: CompositeVoice;
+    constructor(config: AgentConfig<TAgentId, TTools, TMetrics>);
+    hasOwnMemory(): boolean;
+    getMemory(): MastraMemory | undefined;
+    __updateInstructions(newInstructions: string): void;
+    __registerPrimitives(p: MastraPrimitives): void;
+    __registerMastra(mastra: Mastra): void;
+    /**
+     * Set the concrete tools for the agent
+     * @param tools
+     */
+    __setTools(tools: TTools): void;
+    generateTitleFromUserMessage({ message }: {
+        message: CoreUserMessage$1;
+    }): Promise<string>;
+    getMostRecentUserMessage(messages: Array<CoreMessage$1>): CoreUserMessage$1 | undefined;
+    genTitle(userMessage: CoreUserMessage$1 | undefined): Promise<string>;
+    fetchMemory({ threadId, thread: passedThread, memoryConfig, resourceId, userMessages, systemMessage, runId, }: {
+        resourceId: string;
+        threadId: string;
+        thread?: StorageThreadType;
+        memoryConfig?: MemoryConfig;
+        userMessages: CoreMessage$1[];
+        systemMessage: CoreMessage$1;
+        time?: Date;
+        keyword?: string;
+        runId?: string;
+    }): Promise<{
+        threadId: string;
+        messages: CoreMessage$1[];
+    }>;
+    private getResponseMessages;
+    sanitizeResponseMessages(messages: Array<CoreMessage$1>): Array<CoreMessage$1>;
+    convertTools({ toolsets, clientTools, threadId, resourceId, runId, container, }: {
+        toolsets?: ToolsetsInput;
+        clientTools?: ToolsInput;
+        threadId?: string;
+        resourceId?: string;
+        runId?: string;
+        container: Container;
+    }): Record<string, CoreTool>;
+    preExecute({ resourceId, runId, threadId, thread, memoryConfig, messages, systemMessage, }: {
+        runId?: string;
+        threadId: string;
+        thread?: StorageThreadType;
+        memoryConfig?: MemoryConfig;
+        messages: CoreMessage$1[];
+        resourceId: string;
+        systemMessage: CoreMessage$1;
+    }): Promise<{
+        coreMessages: CoreMessage$1[];
+        threadIdToUse: string;
+    }>;
+    __primitive({ instructions, messages, context, threadId, memoryConfig, resourceId, runId, toolsets, clientTools, container, }: {
+        instructions?: string;
+        toolsets?: ToolsetsInput;
+        clientTools?: ToolsInput;
+        resourceId?: string;
+        threadId?: string;
+        memoryConfig?: MemoryConfig;
+        context?: CoreMessage$1[];
+        runId?: string;
+        messages: CoreMessage$1[];
+        container: Container;
+    }): {
+        before: () => Promise<{
+            messageObjects: CoreMessage$1[];
+            convertedTools: Record<string, CoreTool> | undefined;
+            threadId: string;
+            thread: StorageThreadType | null | undefined;
+        }>;
+        after: ({ result, thread: threadAfter, threadId, memoryConfig, outputText, runId, }: {
+            runId: string;
+            result: Record<string, any>;
+            thread: StorageThreadType | null | undefined;
+            threadId: string;
+            memoryConfig: MemoryConfig | undefined;
+            outputText: string;
+        }) => Promise<void>;
+    };
+    generate<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[] | Message[], args?: AgentGenerateOptions<Z> & {
+        output?: never;
+        experimental_output?: never;
+    }): Promise<GenerateTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown>>;
+    generate<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[] | Message[], args?: AgentGenerateOptions<Z> & {
+        output?: Z;
+        experimental_output?: never;
+    }): Promise<GenerateObjectResult<Z extends ZodSchema ? z.infer<Z> : unknown>>;
+    generate<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[] | Message[], args?: AgentGenerateOptions<Z> & {
+        output?: never;
+        experimental_output?: Z;
+    }): Promise<GenerateTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown> & {
+        object: Z extends ZodSchema ? z.infer<Z> : unknown;
+    }>;
+    stream<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[] | Message[], args?: AgentStreamOptions<Z> & {
+        output?: never;
+        experimental_output?: never;
+    }): Promise<StreamTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown>>;
+    stream<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[] | Message[], args?: AgentStreamOptions<Z> & {
+        output?: Z;
+        experimental_output?: never;
+    }): Promise<StreamObjectResult<any, Z extends ZodSchema ? z.infer<Z> : unknown, any>>;
+    stream<Z extends ZodSchema | JSONSchema7 | undefined = undefined>(messages: string | string[] | CoreMessage$1[] | Message[], args?: AgentStreamOptions<Z> & {
+        output?: never;
+        experimental_output?: Z;
+    }): Promise<StreamTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown> & {
+        partialObjectStream: StreamTextResult<any, Z extends ZodSchema ? z.infer<Z> : unknown>['experimental_partialOutputStream'];
+    }>;
+    /**
+     * Convert text to speech using the configured voice provider
+     * @param input Text or text stream to convert to speech
+     * @param options Speech options including speaker and provider-specific options
+     * @returns Audio stream
+     * @deprecated Use agent.voice.speak() instead
+     */
+    speak(input: string | NodeJS.ReadableStream, options?: {
+        speaker?: string;
+        [key: string]: any;
+    }): Promise<NodeJS.ReadableStream | void>;
+    /**
+     * Convert speech to text using the configured voice provider
+     * @param audioStream Audio stream to transcribe
+     * @param options Provider-specific transcription options
+     * @returns Text or text stream
+     * @deprecated Use agent.voice.listen() instead
+     */
+    listen(audioStream: NodeJS.ReadableStream, options?: {
+        [key: string]: any;
+    }): Promise<string | NodeJS.ReadableStream | void>;
+    /**
+     * Get a list of available speakers from the configured voice provider
+     * @throws {Error} If no voice provider is configured
+     * @returns {Promise<Array<{voiceId: string}>>} List of available speakers
+     * @deprecated Use agent.voice.getSpeakers() instead
+     */
+    getSpeakers(): Promise<{
+        voiceId: string;
+    }[]>;
+    toStep(): Step<TAgentId, z.ZodObject<{
+        prompt: z.ZodString;
+    }>, z.ZodObject<{
+        text: z.ZodString;
+    }>, any>;
+}
+
+interface StorageColumn {
+    type: 'text' | 'timestamp' | 'uuid' | 'jsonb' | 'integer' | 'bigint';
+    primaryKey?: boolean;
+    nullable?: boolean;
+    references?: {
+        table: string;
+        column: string;
+    };
+}
+interface WorkflowRow {
+    workflow_name: string;
+    run_id: string;
+    snapshot: WorkflowRunState;
+    created_at: Date;
+    updated_at: Date;
+}
+interface WorkflowRuns {
+    runs: Array<{
+        workflowName: string;
+        runId: string;
+        snapshot: WorkflowRunState | string;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    total: number;
+}
+type StorageGetMessagesArg = {
+    threadId: string;
+    resourceId?: string;
+    selectBy?: {
+        vectorSearchString?: string;
+        last?: number | false;
+        include?: {
+            id: string;
+            withPreviousMessages?: number;
+            withNextMessages?: number;
+        }[];
+    };
+    threadConfig?: MemoryConfig;
+};
+type EvalRow = {
+    input: string;
+    output: string;
+    result: MetricResult;
+    agentName: string;
+    createdAt: string;
+    metricName: string;
+    instructions: string;
+    runId: string;
+    globalRunId: string;
+    testInfo?: TestInfo;
+};
+
+declare const TABLE_WORKFLOW_SNAPSHOT = "mastra_workflow_snapshot";
+declare const TABLE_EVALS = "mastra_evals";
+declare const TABLE_MESSAGES = "mastra_messages";
+declare const TABLE_THREADS = "mastra_threads";
+declare const TABLE_TRACES = "mastra_traces";
+type TABLE_NAMES = typeof TABLE_WORKFLOW_SNAPSHOT | typeof TABLE_EVALS | typeof TABLE_MESSAGES | typeof TABLE_THREADS | typeof TABLE_TRACES;
+declare const TABLE_SCHEMAS: Record<TABLE_NAMES, Record<string, StorageColumn>>;
+
+type MessageType = {
+    id: string;
+    content: UserContent | AssistantContent | ToolContent;
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    createdAt: Date;
+    threadId: string;
+    resourceId: string;
+    toolCallIds?: string[];
+    toolCallArgs?: Record<string, unknown>[];
+    toolNames?: string[];
+    type: 'text' | 'tool-call' | 'tool-result';
+};
+type StorageThreadType = {
+    id: string;
+    title?: string;
+    resourceId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    metadata?: Record<string, unknown>;
+};
+type MessageResponse<T extends 'raw' | 'core_message'> = {
+    raw: MessageType[];
+    core_message: CoreMessage$1[];
+}[T];
+type MemoryConfig = {
+    lastMessages?: number | false;
+    semanticRecall?: boolean | {
+        topK: number;
+        messageRange: number | {
+            before: number;
+            after: number;
+        };
+    };
+    workingMemory?: {
+        enabled: boolean;
+        template?: string;
+        use?: 'text-stream' | 'tool-call';
+    };
+    threads?: {
+        generateTitle?: boolean;
+    };
+};
+type SharedMemoryConfig = {
+    storage?: MastraStorage;
+    options?: MemoryConfig;
+    vector?: MastraVector | false;
+    embedder?: EmbeddingModel<string>;
+    processors?: MemoryProcessor[];
+};
+
+declare abstract class MastraStorage extends MastraBase {
+    /** @deprecated import from { TABLE_WORKFLOW_SNAPSHOT } '@mastra/core/storage' instead */
+    static readonly TABLE_WORKFLOW_SNAPSHOT = "mastra_workflow_snapshot";
+    /** @deprecated import from { TABLE_EVALS } '@mastra/core/storage' instead */
+    static readonly TABLE_EVALS = "mastra_evals";
+    /** @deprecated import from { TABLE_MESSAGES } '@mastra/core/storage' instead */
+    static readonly TABLE_MESSAGES = "mastra_messages";
+    /** @deprecated import from { TABLE_THREADS } '@mastra/core/storage' instead */
+    static readonly TABLE_THREADS = "mastra_threads";
+    /** @deprecated import { TABLE_TRACES } from '@mastra/core/storage' instead */
+    static readonly TABLE_TRACES = "mastra_traces";
+    protected hasInitialized: null | Promise<boolean>;
+    protected shouldCacheInit: boolean;
+    constructor({ name }: {
+        name: string;
+    });
+    abstract createTable({ tableName }: {
+        tableName: TABLE_NAMES;
+        schema: Record<string, StorageColumn>;
+    }): Promise<void>;
+    abstract clearTable({ tableName }: {
+        tableName: TABLE_NAMES;
+    }): Promise<void>;
+    abstract insert({ tableName, record }: {
+        tableName: TABLE_NAMES;
+        record: Record<string, any>;
+    }): Promise<void>;
+    abstract batchInsert({ tableName, records, }: {
+        tableName: TABLE_NAMES;
+        records: Record<string, any>[];
+    }): Promise<void>;
+    batchTraceInsert({ records }: {
+        records: Record<string, any>[];
+    }): Promise<void>;
+    abstract load<R>({ tableName, keys }: {
+        tableName: TABLE_NAMES;
+        keys: Record<string, string>;
+    }): Promise<R | null>;
+    abstract getThreadById({ threadId }: {
+        threadId: string;
+    }): Promise<StorageThreadType | null>;
+    abstract getThreadsByResourceId({ resourceId }: {
+        resourceId: string;
+    }): Promise<StorageThreadType[]>;
+    abstract saveThread({ thread }: {
+        thread: StorageThreadType;
+    }): Promise<StorageThreadType>;
+    abstract updateThread({ id, title, metadata, }: {
+        id: string;
+        title: string;
+        metadata: Record<string, unknown>;
+    }): Promise<StorageThreadType>;
+    abstract deleteThread({ threadId }: {
+        threadId: string;
+    }): Promise<void>;
+    abstract getMessages({ threadId, selectBy, threadConfig }: StorageGetMessagesArg): Promise<MessageType[]>;
+    abstract saveMessages({ messages }: {
+        messages: MessageType[];
+    }): Promise<MessageType[]>;
+    abstract getTraces({ name, scope, page, perPage, attributes, filters, }: {
+        name?: string;
+        scope?: string;
+        page: number;
+        perPage: number;
+        attributes?: Record<string, string>;
+        filters?: Record<string, any>;
+    }): Promise<any[]>;
+    init(): Promise<void>;
+    persistWorkflowSnapshot({ workflowName, runId, snapshot, }: {
+        workflowName: string;
+        runId: string;
+        snapshot: WorkflowRunState;
+    }): Promise<void>;
+    loadWorkflowSnapshot({ workflowName, runId, }: {
+        workflowName: string;
+        runId: string;
+    }): Promise<WorkflowRunState | null>;
+    abstract getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
+    abstract getWorkflowRuns(args?: {
+        namespace?: string;
+        workflowName?: string;
+        fromDate?: Date;
+        toDate?: Date;
+        limit?: number;
+        offset?: number;
+    }): Promise<WorkflowRuns>;
+}
+
+export { type MemoryConfig as $, type ApiRoute as A, type BaseStructuredOutputType as B, CompositeVoice as C, type StructuredOutputType as D, type EvalRow as E, type StructuredOutputArrayItem as F, type StructuredOutput as G, type GenerateReturn as H, type StreamReturn as I, type DefaultLLMTextOptions as J, type DefaultLLMTextObjectOptions as K, type LanguageModel as L, type Methods as M, type DefaultLLMStreamOptions as N, type OutputType as O, type DefaultLLMStreamObjectOptions as P, type LLMTextOptions as Q, type LLMTextObjectOptions as R, type StorageColumn as S, type TABLE_NAMES as T, type LLMStreamOptions as U, type VoiceEventType as V, type WorkflowRunState as W, type LLMInnerStreamOptions as X, type LLMStreamObjectOptions as Y, type Config as Z, type MessageResponse as _, Mastra as a, type SharedMemoryConfig as a0, type MemoryProcessorOpts as a1, MemoryProcessor as a2, createTool as a3, type VercelTool as a4, type CoreTool as a5, type StepExecutionContext as a6, type StepAction as a7, type StepVariableType as a8, type StepNode as a9, type ExtractStepResult as aA, type StepInputType as aB, type ExtractSchemaType as aC, type PathsToStringProps as aD, type WorkflowResumeResult as aE, createStep as aF, type MastraLanguageModel as aG, type ToolsInput as aH, type MastraPrimitives as aI, AgentNetwork as aJ, type AgentNetworkConfig as aK, type ToolsetsInput as aL, type AgentGenerateOptions as aM, type AgentStreamOptions as aN, TABLE_WORKFLOW_SNAPSHOT as aO, TABLE_EVALS as aP, TABLE_MESSAGES as aQ, TABLE_THREADS as aR, TABLE_TRACES as aS, TABLE_SCHEMAS as aT, type StepGraph as aa, type RetryConfig as ab, type VariableReference as ac, type BaseCondition as ad, type ActionContext as ae, WhenConditionReturnValue as af, type StepDef as ag, type StepCondition as ah, type StepConfig as ai, type StepResult as aj, type StepsRecord as ak, type WorkflowRunResult as al, type WorkflowContext as am, type WorkflowLogMessage as an, type WorkflowEvent as ao, type ResolverFunctionInput as ap, type ResolverFunctionOutput as aq, type SubscriberFunctionOutput as ar, type DependencyCheckOutput as as, type StepResolverOutput as at, type WorkflowActors as au, type WorkflowActionParams as av, type WorkflowActions as aw, type WorkflowState as ax, type StepId as ay, type ExtractSchemaFromStep as az, MastraVoice as b, type VoiceEventMap as c, type VoiceConfig as d, MastraStorage as e, type StorageThreadType as f, type MessageType as g, type StorageGetMessagesArg as h, type ToolAction as i, Agent as j, type AgentConfig as k, MastraMemory as l, type ToolExecutionContext as m, Tool as n, Step as o, Workflow as p, type WorkflowOptions as q, type WorkflowRow as r, type WorkflowRuns as s, type CoreMessage as t, type CoreSystemMessage as u, type CoreAssistantMessage as v, type CoreUserMessage as w, type CoreToolMessage as x, type EmbedResult as y, type EmbedManyResult as z };