@mastra/core 0.24.0 → 1.0.0-beta.0

package/dist/tools/types.d.ts

@@ -1,28 +1,103 @@
 import type { Tool, ToolV5, FlexibleSchema, ToolCallOptions, ToolExecutionOptions, Schema } from '@internal/external-types';
-import type { IAction, IExecutionContext, MastraUnion } from '../action/index.js';
-import type { TracingContext } from '../ai-tracing/index.js';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { ElicitRequest, ElicitResult } from '@modelcontextprotocol/sdk/types.js';
+import type { MastraUnion } from '../action/index.js';
 import type { Mastra } from '../mastra/index.js';
-import type { RuntimeContext } from '../runtime-context/index.js';
+import type { TracingContext } from '../observability/index.js';
+import type { RequestContext } from '../request-context/index.js';
 import type { ZodLikeSchema, InferZodLikeSchema } from '../types/zod-compat.js';
 import type { ToolStream } from './stream.js';
+import type { ValidationError } from './validation.js';
 export type VercelTool = Tool;
 export type VercelToolV5 = ToolV5;
 export type ToolInvocationOptions = ToolExecutionOptions | ToolCallOptions;
+/**
+ * MCP-specific context properties available during tool execution in MCP environments.
+ */
+export interface AgentToolExecutionContext<TSuspendSchema extends ZodLikeSchema = any, TResumeSchema extends ZodLikeSchema = any> {
+    toolCallId: string;
+    messages: any[];
+    suspend: (suspendPayload: InferZodLikeSchema<TSuspendSchema>) => Promise<any>;
+    threadId?: string;
+    resourceId?: string;
+    resumeData?: InferZodLikeSchema<TResumeSchema>;
+    writableStream?: WritableStream<any>;
+}
+export interface WorkflowToolExecutionContext<TSuspendSchema extends ZodLikeSchema = any, TResumeSchema extends ZodLikeSchema = any> {
+    runId: string;
+    workflowId: string;
+    state: any;
+    setState: (state: any) => void;
+    suspend: (suspendPayload: InferZodLikeSchema<TSuspendSchema>) => Promise<any>;
+    resumeData?: InferZodLikeSchema<TResumeSchema>;
+}
+export interface MCPToolExecutionContext {
+    /** MCP protocol context passed by the server */
+    extra: RequestHandlerExtra<any, any>;
+    /** Elicitation handler for interactive user input during tool execution */
+    elicitation: {
+        sendRequest: (request: ElicitRequest['params']) => Promise<ElicitResult>;
+    };
+}
 /**
  * Extended version of ToolInvocationOptions that includes Mastra-specific properties
  * for suspend/resume functionality, stream writing, and tracing context.
+ *
+ * This is used by CoreTool/InternalCoreTool for AI SDK compatibility (AI SDK expects this signature).
+ * Mastra v1.0 tools (ToolAction) use ToolExecutionContext instead.
+ *
+ * CoreToolBuilder acts as the adapter layer:
+ * - Receives: AI SDK calls with MastraToolInvocationOptions
+ * - Converts to: ToolExecutionContext for Mastra tool execution
+ * - Returns: Results back to AI SDK
  */
 export type MastraToolInvocationOptions = ToolInvocationOptions & {
     suspend?: (suspendPayload: any) => Promise<any>;
     resumeData?: any;
     writableStream?: WritableStream<any> | ToolStream<any>;
     tracingContext?: TracingContext;
+    /**
+     * Optional MCP-specific context passed when tool is executed in MCP server.
+     * This is populated by the MCP server and passed through to the tool's execution context.
+     */
+    mcp?: MCPToolExecutionContext;
 };
+/**
+ * The type of tool registered with the MCP server.
+ * This is used to categorize tools in the MCP Server playground.
+ * If not specified, it defaults to a regular tool.
+ */
+export type MCPToolType = 'agent' | 'workflow';
+export interface MCPToolProperties {
+    /**
+     * The type of tool registered with the MCP server.
+     * This is used to categorize tools in the MCP Server playground.
+     * If not specified, it defaults to a regular tool.
+     */
+    toolType?: MCPToolType;
+}
+/**
+ * CoreTool is the AI SDK-compatible tool format used when passing tools to the AI SDK.
+ * This matches the AI SDK's Tool interface.
+ *
+ * CoreToolBuilder converts Mastra tools (ToolAction) to this format and handles the
+ * signature transformation from Mastra's (inputData, context) to AI SDK format (params, options).
+ *
+ * Key differences from ToolAction:
+ * - Uses 'parameters' instead of 'inputSchema' (AI SDK naming)
+ * - Execute signature: (params, options: MastraToolInvocationOptions) (AI SDK format)
+ * - Supports FlexibleSchema | Schema for broader AI SDK compatibility
+ */
 export type CoreTool = {
     description?: string;
     parameters: FlexibleSchema<any> | Schema;
     outputSchema?: FlexibleSchema<any> | Schema;
     execute?: (params: any, options: MastraToolInvocationOptions) => Promise<any>;
+    /**
+     * Optional MCP-specific properties.
+     * Only populated when the tool is being used in an MCP context.
+     */
+    mcp?: MCPToolProperties;
 } & ({
     type?: 'function' | undefined;
     id?: string;
@@ -31,11 +106,22 @@ export type CoreTool = {
     id: `${string}.${string}`;
     args: Record<string, unknown>;
 });
+/**
+ * InternalCoreTool is identical to CoreTool but with stricter typing.
+ * Used internally where we know the schema has already been converted to AI SDK Schema format.
+ *
+ * The only difference: parameters must be Schema (not FlexibleSchema | Schema)
+ */
 export type InternalCoreTool = {
     description?: string;
     parameters: Schema;
     outputSchema?: Schema;
     execute?: (params: any, options: MastraToolInvocationOptions) => Promise<any>;
+    /**
+     * Optional MCP-specific properties.
+     * Only populated when the tool is being used in an MCP context.
+     */
+    mcp?: MCPToolProperties;
 } & ({
     type?: 'function' | undefined;
     id?: string;
@@ -44,19 +130,24 @@ export type InternalCoreTool = {
     id: `${string}.${string}`;
     args: Record<string, unknown>;
 });
-export interface ToolExecutionContext<TSchemaIn extends ZodLikeSchema | undefined = undefined, TSuspendSchema extends ZodLikeSchema = any, TResumeSchema extends ZodLikeSchema = any> extends IExecutionContext<TSchemaIn> {
+export interface ToolExecutionContext<TSuspendSchema extends ZodLikeSchema = any, TResumeSchema extends ZodLikeSchema = any> {
     mastra?: MastraUnion;
-    runtimeContext: RuntimeContext;
-    writer?: ToolStream<any>;
+    requestContext?: RequestContext;
     tracingContext?: TracingContext;
-    suspend?: (suspendPayload: InferZodLikeSchema<TSuspendSchema>) => Promise<any>;
-    resumeData?: InferZodLikeSchema<TResumeSchema>;
+    abortSignal?: AbortSignal;
+    writer?: ToolStream<any>;
+    agent?: AgentToolExecutionContext<TSuspendSchema, TResumeSchema>;
+    workflow?: WorkflowToolExecutionContext<TSuspendSchema, TResumeSchema>;
+    mcp?: MCPToolExecutionContext;
 }
-export interface ToolAction<TSchemaIn extends ZodLikeSchema | undefined = undefined, TSchemaOut extends ZodLikeSchema | undefined = undefined, TSuspendSchema extends ZodLikeSchema = any, TResumeSchema extends ZodLikeSchema = any, TContext extends ToolExecutionContext<TSchemaIn, TSuspendSchema, TResumeSchema> = ToolExecutionContext<TSchemaIn, TSuspendSchema, TResumeSchema>> extends IAction<string, TSchemaIn, TSchemaOut, TContext, MastraToolInvocationOptions> {
+export interface ToolAction<TSchemaIn extends ZodLikeSchema | undefined = undefined, TSchemaOut extends ZodLikeSchema | undefined = undefined, TSuspendSchema extends ZodLikeSchema = any, TResumeSchema extends ZodLikeSchema = any, TContext extends ToolExecutionContext<TSuspendSchema, TResumeSchema> = ToolExecutionContext<TSuspendSchema, TResumeSchema>> {
+    id: string;
+    description: string;
+    inputSchema?: TSchemaIn;
+    outputSchema?: TSchemaOut;
     suspendSchema?: TSuspendSchema;
     resumeSchema?: TResumeSchema;
-    description: string;
-    execute?: (context: TContext, options?: MastraToolInvocationOptions) => Promise<TSchemaOut extends ZodLikeSchema ? InferZodLikeSchema<TSchemaOut> : unknown>;
+    execute?: (inputData: TSchemaIn extends ZodLikeSchema ? InferZodLikeSchema<TSchemaIn> : unknown, context?: TContext) => Promise<(TSchemaOut extends ZodLikeSchema ? InferZodLikeSchema<TSchemaOut> : any) | ValidationError>;
     mastra?: Mastra;
     requireApproval?: boolean;
     onInputStart?: (options: ToolCallOptions) => void | PromiseLike<void>;

package/dist/tools/types.d.ts.map

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

package/dist/tools/validation.d.ts

@@ -6,11 +6,12 @@ export interface ValidationError<T = any> {
     validationErrors: z.ZodFormattedError<T>;
 }
 /**
- * Validates input against a Zod schema and returns a structured error if validation fails
+ * Validates raw input data against a Zod schema.
+ *
  * @param schema The Zod schema to validate against
- * @param input The input to validate
+ * @param input The raw input data to validate
  * @param toolId Optional tool ID for better error messages
- * @returns The validation error object if validation fails, undefined if successful
+ * @returns The validated data or a validation error
  */
 export declare function validateToolInput<T = any>(schema: ZodLikeSchema | undefined, input: unknown, toolId?: string): {
     data: T | unknown;

package/dist/tools/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/tools/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC,KAAK,EAAE,IAAI,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,GAAG,EACvC,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAAE,CA8FnD"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/tools/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC,KAAK,EAAE,IAAI,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,GAAG,EACvC,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAAE,CAyBnD"}

package/dist/tts/index.cjs

@@ -1,12 +1,18 @@
 'use strict';
 
-var chunkDMBN72QF_cjs = require('../chunk-DMBN72QF.cjs');
+var chunkKEXGB7FK_cjs = require('../chunk-KEXGB7FK.cjs');
 
+// src/tts/index.ts
+var MastraTTS = class extends chunkKEXGB7FK_cjs.MastraBase {
+  model;
+  constructor({ model }) {
+    super({
+      component: "TTS"
+    });
+    this.model = model;
+  }
+};
 
-
-Object.defineProperty(exports, "MastraTTS", {
-  enumerable: true,
-  get: function () { return chunkDMBN72QF_cjs.MastraTTS; }
-});
+exports.MastraTTS = MastraTTS;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/tts/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../../src/tts/index.ts"],"names":["MastraBase"],"mappings":";;;;;AAYO,IAAe,SAAA,GAAf,cAAiCA,4BAAA,CAAW;AAAA,EACjD,KAAA;AAAA,EACA,WAAA,CAAY,EAAE,KAAA,EAAM,EAAc;AAChC,IAAA,KAAA,CAAM;AAAA,MACJ,SAAA,EAAW;AAAA,KACZ,CAAA;AACD,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AAIF","file":"index.cjs","sourcesContent":["import { MastraBase } from '../base';\n\ninterface BuiltInModelConfig {\n  provider: string;\n  name: string;\n  apiKey?: string;\n}\n\nexport interface TTSConfig {\n  model: BuiltInModelConfig;\n}\n\nexport abstract class MastraTTS extends MastraBase {\n  model: BuiltInModelConfig;\n  constructor({ model }: TTSConfig) {\n    super({\n      component: 'TTS',\n    });\n    this.model = model;\n  }\n\n  abstract generate({ text }: { text: string }): Promise<any>;\n  abstract stream({ text }: { text: string }): Promise<any>;\n}\n"]}

package/dist/tts/index.d.ts

@@ -10,7 +10,6 @@ export interface TTSConfig {
 export declare abstract class MastraTTS extends MastraBase {
     model: BuiltInModelConfig;
     constructor({ model }: TTSConfig);
-    traced<T extends Function>(method: T, methodName: string): T;
     abstract generate({ text }: {
         text: string;
     }): Promise<any>;

package/dist/tts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,8BAIsB,SAAU,SAAQ,UAAU;IAChD,KAAK,EAAE,kBAAkB,CAAC;gBACd,EAAE,KAAK,EAAE,EAAE,SAAS;IAOhC,MAAM,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;IAW5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAC1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,8BAAsB,SAAU,SAAQ,UAAU;IAChD,KAAK,EAAE,kBAAkB,CAAC;gBACd,EAAE,KAAK,EAAE,EAAE,SAAS;IAOhC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;CAC1D"}

package/dist/tts/index.js

@@ -1,3 +1,16 @@
-export { MastraTTS } from '../chunk-NPNGPMT2.js';
+import { MastraBase } from '../chunk-S6URFGCZ.js';
+
+// src/tts/index.ts
+var MastraTTS = class extends MastraBase {
+  model;
+  constructor({ model }) {
+    super({
+      component: "TTS"
+    });
+    this.model = model;
+  }
+};
+
+export { MastraTTS };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/tts/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"sources":["../../src/tts/index.ts"],"names":[],"mappings":";;;AAYO,IAAe,SAAA,GAAf,cAAiC,UAAA,CAAW;AAAA,EACjD,KAAA;AAAA,EACA,WAAA,CAAY,EAAE,KAAA,EAAM,EAAc;AAChC,IAAA,KAAA,CAAM;AAAA,MACJ,SAAA,EAAW;AAAA,KACZ,CAAA;AACD,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AAIF","file":"index.js","sourcesContent":["import { MastraBase } from '../base';\n\ninterface BuiltInModelConfig {\n  provider: string;\n  name: string;\n  apiKey?: string;\n}\n\nexport interface TTSConfig {\n  model: BuiltInModelConfig;\n}\n\nexport abstract class MastraTTS extends MastraBase {\n  model: BuiltInModelConfig;\n  constructor({ model }: TTSConfig) {\n    super({\n      component: 'TTS',\n    });\n    this.model = model;\n  }\n\n  abstract generate({ text }: { text: string }): Promise<any>;\n  abstract stream({ text }: { text: string }): Promise<any>;\n}\n"]}

package/dist/types/dynamic-argument.d.ts

@@ -1,7 +1,7 @@
 import type { Mastra } from '../mastra/index.js';
-import type { RuntimeContext } from '../runtime-context/index.js';
-export type DynamicArgument<T> = T | (({ runtimeContext, mastra }: {
-    runtimeContext: RuntimeContext;
+import type { RequestContext } from '../request-context/index.js';
+export type DynamicArgument<T> = T | (({ requestContext, mastra }: {
+    requestContext: RequestContext;
     mastra?: Mastra;
 }) => Promise<T> | T);
 export type NonEmpty<T extends string> = T extends '' ? never : T;

package/dist/utils/fetchWithRetry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fetches a URL with retry logic
+ * @param url The URL to fetch
+ * @param options Fetch options
+ * @param maxRetries Maximum number of retry attempts
+ * @returns The fetch Response if successful
+ */
+export declare function fetchWithRetry(url: string, options?: RequestInit, maxRetries?: number): Promise<Response>;
+//# sourceMappingURL=fetchWithRetry.d.ts.map

package/dist/utils/fetchWithRetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchWithRetry.d.ts","sourceRoot":"","sources":["../../src/utils/fetchWithRetry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC,QAAQ,CAAC,CAgDnB"}

package/dist/utils.cjs

@@ -1,72 +1,88 @@
 'use strict';
 
-var chunkP35FNLTQ_cjs = require('./chunk-P35FNLTQ.cjs');
+var chunkWM6CK2F3_cjs = require('./chunk-WM6CK2F3.cjs');
 
 
 
 Object.defineProperty(exports, "checkEvalStorageFields", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.checkEvalStorageFields; }
+  get: function () { return chunkWM6CK2F3_cjs.checkEvalStorageFields; }
 });
 Object.defineProperty(exports, "createMastraProxy", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.createMastraProxy; }
+  get: function () { return chunkWM6CK2F3_cjs.createMastraProxy; }
 });
 Object.defineProperty(exports, "deepMerge", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.deepMerge; }
+  get: function () { return chunkWM6CK2F3_cjs.deepMerge; }
 });
 Object.defineProperty(exports, "delay", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.delay; }
+  get: function () { return chunkWM6CK2F3_cjs.delay; }
 });
 Object.defineProperty(exports, "ensureToolProperties", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.ensureToolProperties; }
+  get: function () { return chunkWM6CK2F3_cjs.ensureToolProperties; }
 });
 Object.defineProperty(exports, "fetchWithRetry", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.fetchWithRetry; }
+  get: function () { return chunkWM6CK2F3_cjs.fetchWithRetry; }
 });
 Object.defineProperty(exports, "generateEmptyFromSchema", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.generateEmptyFromSchema; }
+  get: function () { return chunkWM6CK2F3_cjs.generateEmptyFromSchema; }
+});
+Object.defineProperty(exports, "getNestedValue", {
+  enumerable: true,
+  get: function () { return chunkWM6CK2F3_cjs.getNestedValue; }
 });
 Object.defineProperty(exports, "isCoreMessage", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.isCoreMessage; }
+  get: function () { return chunkWM6CK2F3_cjs.isCoreMessage; }
 });
 Object.defineProperty(exports, "isUiMessage", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.isUiMessage; }
+  get: function () { return chunkWM6CK2F3_cjs.isUiMessage; }
 });
 Object.defineProperty(exports, "isZodType", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.isZodType; }
+  get: function () { return chunkWM6CK2F3_cjs.isZodType; }
 });
 Object.defineProperty(exports, "makeCoreTool", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.makeCoreTool; }
+  get: function () { return chunkWM6CK2F3_cjs.makeCoreTool; }
 });
 Object.defineProperty(exports, "makeCoreToolV5", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.makeCoreToolV5; }
+  get: function () { return chunkWM6CK2F3_cjs.makeCoreToolV5; }
 });
 Object.defineProperty(exports, "maskStreamTags", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.maskStreamTags; }
+  get: function () { return chunkWM6CK2F3_cjs.maskStreamTags; }
+});
+Object.defineProperty(exports, "omitKeys", {
+  enumerable: true,
+  get: function () { return chunkWM6CK2F3_cjs.omitKeys; }
 });
 Object.defineProperty(exports, "parseFieldKey", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.parseFieldKey; }
+  get: function () { return chunkWM6CK2F3_cjs.parseFieldKey; }
 });
 Object.defineProperty(exports, "parseSqlIdentifier", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.parseSqlIdentifier; }
+  get: function () { return chunkWM6CK2F3_cjs.parseSqlIdentifier; }
 });
 Object.defineProperty(exports, "resolveSerializedZodOutput", {
   enumerable: true,
-  get: function () { return chunkP35FNLTQ_cjs.resolveSerializedZodOutput; }
+  get: function () { return chunkWM6CK2F3_cjs.resolveSerializedZodOutput; }
+});
+Object.defineProperty(exports, "selectFields", {
+  enumerable: true,
+  get: function () { return chunkWM6CK2F3_cjs.selectFields; }
+});
+Object.defineProperty(exports, "setNestedValue", {
+  enumerable: true,
+  get: function () { return chunkWM6CK2F3_cjs.setNestedValue; }
 });
 //# sourceMappingURL=utils.cjs.map
 //# sourceMappingURL=utils.cjs.map

package/dist/utils.d.ts

@@ -1,14 +1,14 @@
 import type { WritableStream } from 'stream/web';
-import type { CoreMessage } from 'ai';
+import type { CoreMessage } from 'ai-sdk.types.d.ts';
 import { z } from 'zod';
 import type { MastraPrimitives } from './action/index.js';
 import type { ToolsInput } from './agent/index.js';
-import type { TracingContext, TracingPolicy } from './ai-tracing/index.js';
 import type { MastraLanguageModel } from './llm/model/shared.types.js';
 import type { IMastraLogger } from './logger/index.js';
 import type { Mastra } from './mastra/index.js';
 import type { AiMessageType, MastraMemory } from './memory/index.js';
-import type { RuntimeContext } from './runtime-context/index.js';
+import type { TracingContext, TracingPolicy } from './observability/index.js';
+import type { RequestContext } from './request-context/index.js';
 import type { ChunkType } from './stream/types.js';
 import type { CoreTool, VercelToolV5 } from './tools/index.js';
 import type { ToolToConvert } from './tools/tool-builder/builder.js';
@@ -49,8 +49,8 @@ export interface ToolOptions {
     logger?: IMastraLogger;
     description?: string;
     mastra?: (Mastra & MastraPrimitives) | MastraPrimitives;
-    runtimeContext: RuntimeContext;
-    /** Build-time tracing context (fallback for Legacy methods that can't pass runtime context) */
+    requestContext: RequestContext;
+    /** Build-time tracing context (fallback for Legacy methods that can't pass request context) */
     tracingContext?: TracingContext;
     tracingPolicy?: TracingPolicy;
     memory?: MastraMemory;
@@ -58,6 +58,10 @@ export interface ToolOptions {
     model?: MastraLanguageModel;
     writableStream?: WritableStream<ChunkType>;
     requireApproval?: boolean;
+    workflow?: any;
+    workflowId?: string;
+    state?: any;
+    setState?: (state: any) => void;
 }
 /**
  * Checks if a value is a Zod type
@@ -89,7 +93,7 @@ export declare function makeCoreToolV5(originalTool: ToolToConvert, options: Too
 export declare function createMastraProxy({ mastra, logger }: {
     mastra: Mastra;
     logger: IMastraLogger;
-}): Mastra<Record<string, import("./agent").Agent<any, ToolsInput, Record<string, import("./eval").Metric>>>, Record<string, import("./workflows/legacy").LegacyWorkflow<import("./workflows/legacy").LegacyStep<string, any, any, import("./workflows/legacy").StepExecutionContext<any, import("./workflows/legacy").WorkflowContext<any, import("./workflows/legacy").LegacyStep<string, any, any, any>[], Record<string, any>>>>[], string, any, any>>, Record<string, import("./workflows").Workflow<any, any, any, any, any, any, any>>, Record<string, import("./vector").MastraVector<import("./vector/filter").VectorFilter>>, Record<string, import("./tts").MastraTTS>, IMastraLogger, Record<string, import("./mcp").MCPServerBase>, Record<string, import("./scores").MastraScorer<any, any, any, any>>>;
+}): Mastra<Record<string, import("./agent").Agent<any, ToolsInput>>, Record<string, import("./workflows").Workflow<any, any, any, any, any, any, any>>, Record<string, import("./vector").MastraVector<import("./vector/filter").VectorFilter>>, Record<string, import("./tts").MastraTTS>, IMastraLogger, Record<string, import("./mcp").MCPServerBase>, Record<string, import("./evals").MastraScorer<any, any, any, any>>, Record<string, import("./tools").ToolAction<any, any, any, any, import("./tools").ToolExecutionContext<any, any>>>, Record<string, import("./processors").Processor>>;
 export declare function checkEvalStorageFields(traceObject: any, logger?: IMastraLogger): boolean;
 export declare function isUiMessage(message: CoreMessage | AiMessageType): message is AiMessageType;
 export declare function isCoreMessage(message: CoreMessage | AiMessageType): message is CoreMessage;
@@ -144,5 +148,34 @@ export declare function parseFieldKey(key: string): FieldKey;
  * @returns The fetch Response if successful
  */
 export declare function fetchWithRetry(url: string, options?: RequestInit, maxRetries?: number): Promise<Response>;
+/**
+ * Removes specific keys from an object.
+ * @param obj - The original object
+ * @param keysToOmit - Keys to exclude from the returned object
+ * @returns A new object with the specified keys removed
+ */
+export declare function omitKeys<T extends Record<string, any>>(obj: T, keysToOmit: string[]): Partial<T>;
+/**
+ * Selectively extracts specific fields from an object using dot notation.
+ * Does not error if fields don't exist - simply omits them from the result.
+ * @param obj - The source object to extract fields from
+ * @param fields - Array of field paths (supports dot notation like 'output.text')
+ * @returns New object containing only the specified fields
+ */
+export declare function selectFields(obj: any, fields: string[]): any;
+/**
+ * Gets a nested value from an object using dot notation
+ * @param obj - Source object
+ * @param path - Dot notation path (e.g., 'output.text')
+ * @returns The value at the path, or undefined if not found
+ */
+export declare function getNestedValue(obj: any, path: string): any;
+/**
+ * Sets a nested value in an object using dot notation
+ * @param obj - Target object
+ * @param path - Dot notation path (e.g., 'output.text')
+ * @param value - Value to set
+ */
+export declare function setNestedValue(obj: any, path: string, value: any): void;
 export {};
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

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

package/dist/utils.js

@@ -1,3 +1,3 @@
-export { checkEvalStorageFields, createMastraProxy, deepMerge, delay, ensureToolProperties, fetchWithRetry, generateEmptyFromSchema, isCoreMessage, isUiMessage, isZodType, makeCoreTool, makeCoreToolV5, maskStreamTags, parseFieldKey, parseSqlIdentifier, resolveSerializedZodOutput } from './chunk-DTTOVV72.js';
+export { checkEvalStorageFields, createMastraProxy, deepMerge, delay, ensureToolProperties, fetchWithRetry, generateEmptyFromSchema, getNestedValue, isCoreMessage, isUiMessage, isZodType, makeCoreTool, makeCoreToolV5, maskStreamTags, omitKeys, parseFieldKey, parseSqlIdentifier, resolveSerializedZodOutput, selectFields, setNestedValue } from './chunk-4CDL2QJT.js';
 //# sourceMappingURL=utils.js.map
 //# sourceMappingURL=utils.js.map

package/dist/vector/embed.d.ts

@@ -1,3 +1,3 @@
-export { embed as embedV1 } from 'ai';
+export { embed as embedV1 } from '../ai-sdk.types.d.ts';
 export { embed as embedV2 } from 'ai-v5';
 //# sourceMappingURL=embed.d.ts.map

package/dist/vector/embed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/vector/embed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/vector/embed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,OAAO,CAAC"}

package/dist/vector/index.cjs

@@ -1,20 +1,92 @@
 'use strict';
 
-var chunkNUAURT4I_cjs = require('../chunk-NUAURT4I.cjs');
+var chunkSVLMF4UZ_cjs = require('../chunk-SVLMF4UZ.cjs');
+var chunkTWH4PTDG_cjs = require('../chunk-TWH4PTDG.cjs');
+var chunkKEXGB7FK_cjs = require('../chunk-KEXGB7FK.cjs');
+var aiV5 = require('ai-v5');
 
+// src/vector/vector.ts
+var MastraVector = class extends chunkKEXGB7FK_cjs.MastraBase {
+  id;
+  constructor({ id }) {
+    if (!id || typeof id !== "string" || id.trim() === "") {
+      throw new chunkTWH4PTDG_cjs.MastraError({
+        id: "VECTOR_INVALID_ID",
+        text: "Vector id must be provided and cannot be empty",
+        domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
+        category: "USER" /* USER */
+      });
+    }
+    super({ name: "MastraVector", component: "VECTOR" });
+    this.id = id;
+  }
+  get indexSeparator() {
+    return "_";
+  }
+  async validateExistingIndex(indexName, dimension, metric) {
+    let info;
+    try {
+      info = await this.describeIndex({ indexName });
+    } catch (infoError) {
+      const mastraError = new chunkTWH4PTDG_cjs.MastraError(
+        {
+          id: "VECTOR_VALIDATE_INDEX_FETCH_FAILED",
+          text: `Index "${indexName}" already exists, but failed to fetch index info for dimension check.`,
+          domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
+          category: "SYSTEM" /* SYSTEM */,
+          details: { indexName }
+        },
+        infoError
+      );
+      this.logger?.trackException(mastraError);
+      this.logger?.error(mastraError.toString());
+      throw mastraError;
+    }
+    const existingDim = info?.dimension;
+    const existingMetric = info?.metric;
+    if (existingDim === dimension) {
+      this.logger?.info(
+        `Index "${indexName}" already exists with ${existingDim} dimensions and metric ${existingMetric}, skipping creation.`
+      );
+      if (existingMetric !== metric) {
+        this.logger?.warn(
+          `Attempted to create index with metric "${metric}", but index already exists with metric "${existingMetric}". To use a different metric, delete and recreate the index.`
+        );
+      }
+    } else if (info) {
+      const mastraError = new chunkTWH4PTDG_cjs.MastraError({
+        id: "VECTOR_VALIDATE_INDEX_DIMENSION_MISMATCH",
+        text: `Index "${indexName}" already exists with ${existingDim} dimensions, but ${dimension} dimensions were requested`,
+        domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
+        category: "USER" /* USER */,
+        details: { indexName, existingDim, requestedDim: dimension }
+      });
+      this.logger?.trackException(mastraError);
+      this.logger?.error(mastraError.toString());
+      throw mastraError;
+    } else {
+      const mastraError = new chunkTWH4PTDG_cjs.MastraError({
+        id: "VECTOR_VALIDATE_INDEX_NO_DIMENSION",
+        text: `Index "${indexName}" already exists, but could not retrieve its dimensions for validation.`,
+        domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
+        category: "SYSTEM" /* SYSTEM */,
+        details: { indexName }
+      });
+      this.logger?.trackException(mastraError);
+      this.logger?.error(mastraError.toString());
+      throw mastraError;
+    }
+  }
+};
 
-
-Object.defineProperty(exports, "MastraVector", {
-  enumerable: true,
-  get: function () { return chunkNUAURT4I_cjs.MastraVector; }
-});
 Object.defineProperty(exports, "embedV1", {
   enumerable: true,
-  get: function () { return chunkNUAURT4I_cjs.embed; }
+  get: function () { return chunkSVLMF4UZ_cjs.embed; }
 });
 Object.defineProperty(exports, "embedV2", {
   enumerable: true,
-  get: function () { return chunkNUAURT4I_cjs.embed2; }
+  get: function () { return aiV5.embed; }
 });
+exports.MastraVector = MastraVector;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map