@scoutqa/mastra-core 0.24.6-fork.1

package/dist/tools/tool.d.ts

@@ -0,0 +1,186 @@
+import type { Mastra } from '../mastra/index.js';
+import type { ZodLikeSchema } from '../types/zod-compat.js';
+import type { ToolAction, ToolExecutionContext, MastraToolInvocationOptions } from './types.js';
+/**
+ * A type-safe tool that agents and workflows can call to perform specific actions.
+ *
+ * @template TSchemaIn - Input schema type
+ * @template TSchemaOut - Output schema type
+ * @template TSuspendSchema - Suspend operation schema type
+ * @template TResumeSchema - Resume operation schema type
+ * @template TContext - Execution context type
+ *
+ * @example Basic tool with validation
+ * ```typescript
+ * const weatherTool = createTool({
+ *   id: 'get-weather',
+ *   description: 'Get weather for a location',
+ *   inputSchema: z.object({
+ *     location: z.string(),
+ *     units: z.enum(['celsius', 'fahrenheit']).optional()
+ *   }),
+ *   execute: async ({ context }) => {
+ *     return await fetchWeather(context.location, context.units);
+ *   }
+ * });
+ * ```
+ *
+ * @example Tool requiring approval
+ * ```typescript
+ * const deleteFileTool = createTool({
+ *   id: 'delete-file',
+ *   description: 'Delete a file',
+ *   requireApproval: true,
+ *   inputSchema: z.object({ filepath: z.string() }),
+ *   execute: async ({ context }) => {
+ *     await fs.unlink(context.filepath);
+ *     return { deleted: true };
+ *   }
+ * });
+ * ```
+ *
+ * @example Tool with Mastra integration
+ * ```typescript
+ * const saveTool = createTool({
+ *   id: 'save-data',
+ *   description: 'Save data to storage',
+ *   inputSchema: z.object({ key: z.string(), value: z.any() }),
+ *   execute: async ({ context, mastra }) => {
+ *     const storage = mastra?.getStorage();
+ *     await storage?.set(context.key, context.value);
+ *     return { saved: true };
+ *   }
+ * });
+ * ```
+ */
+export declare class Tool<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>> implements ToolAction<TSchemaIn, TSchemaOut, TSuspendSchema, TResumeSchema, TContext> {
+    /** Unique identifier for the tool */
+    id: string;
+    /** Description of what the tool does */
+    description: string;
+    /** Schema for validating input parameters */
+    inputSchema?: TSchemaIn;
+    /** Schema for validating output structure */
+    outputSchema?: TSchemaOut;
+    /** Schema for suspend operation data */
+    suspendSchema?: TSuspendSchema;
+    /** Schema for resume operation data */
+    resumeSchema?: TResumeSchema;
+    /**
+     * Function that performs the tool's action
+     * @param context - Execution context with validated input
+     * @param options - Invocation options including suspend/resume data
+     * @returns Promise resolving to tool output
+     */
+    execute?: ToolAction<TSchemaIn, TSchemaOut, TSuspendSchema, TResumeSchema, TContext>['execute'];
+    /** Parent Mastra instance for accessing shared resources */
+    mastra?: Mastra;
+    /**
+     * Whether the tool requires explicit user approval before execution
+     * @example
+     * ```typescript
+     * // For destructive operations
+     * requireApproval: true
+     * ```
+     */
+    requireApproval?: boolean;
+    /**
+     * Creates a new Tool instance with input validation wrapper.
+     *
+     * @param opts - Tool configuration and execute function
+     * @example
+     * ```typescript
+     * const tool = new Tool({
+     *   id: 'my-tool',
+     *   description: 'Does something useful',
+     *   inputSchema: z.object({ name: z.string() }),
+     *   execute: async ({ context }) => ({ greeting: `Hello ${context.name}` })
+     * });
+     * ```
+     */
+    constructor(opts: ToolAction<TSchemaIn, TSchemaOut, TSuspendSchema, TResumeSchema, TContext>);
+}
+/**
+ * Creates a type-safe tool with automatic input validation.
+ *
+ * @template TSchemaIn - Input schema type
+ * @template TSchemaOut - Output schema type
+ * @template TSuspendSchema - Suspend operation schema type
+ * @template TResumeSchema - Resume operation schema type
+ * @template TContext - Execution context type
+ * @template TExecute - Execute function type
+ *
+ * @param opts - Tool configuration including schemas and execute function
+ * @returns Type-safe Tool instance with conditional typing based on schemas
+ *
+ * @example Simple tool
+ * ```typescript
+ * const greetTool = createTool({
+ *   id: 'greet',
+ *   description: 'Say hello',
+ *   execute: async () => ({ message: 'Hello!' })
+ * });
+ * ```
+ *
+ * @example Tool with input validation
+ * ```typescript
+ * const calculateTool = createTool({
+ *   id: 'calculate',
+ *   description: 'Perform calculations',
+ *   inputSchema: z.object({
+ *     operation: z.enum(['add', 'subtract']),
+ *     a: z.number(),
+ *     b: z.number()
+ *   }),
+ *   execute: async ({ context }) => {
+ *     const result = context.operation === 'add'
+ *       ? context.a + context.b
+ *       : context.a - context.b;
+ *     return { result };
+ *   }
+ * });
+ * ```
+ *
+ * @example Tool with output schema
+ * ```typescript
+ * const userTool = createTool({
+ *   id: 'get-user',
+ *   description: 'Get user data',
+ *   inputSchema: z.object({ userId: z.string() }),
+ *   outputSchema: z.object({
+ *     id: z.string(),
+ *     name: z.string(),
+ *     email: z.string()
+ *   }),
+ *   execute: async ({ context }) => {
+ *     return await fetchUser(context.userId);
+ *   }
+ * });
+ * ```
+ *
+ * @example Tool with external API
+ * ```typescript
+ * const weatherTool = createTool({
+ *   id: 'weather',
+ *   description: 'Get weather data',
+ *   inputSchema: z.object({
+ *     city: z.string(),
+ *     units: z.enum(['metric', 'imperial']).default('metric')
+ *   }),
+ *   execute: async ({ context }) => {
+ *     const response = await fetch(
+ *       `https://api.weather.com/v1/weather?q=${context.city}&units=${context.units}`
+ *     );
+ *     return response.json();
+ *   }
+ * });
+ * ```
+ */
+export declare function createTool<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>, TExecute extends ToolAction<TSchemaIn, TSchemaOut, TSuspendSchema, TResumeSchema, TContext>['execute'] = ToolAction<TSchemaIn, TSchemaOut, TSuspendSchema, TResumeSchema, TContext>['execute']>(opts: ToolAction<TSchemaIn, TSchemaOut, TSuspendSchema, TResumeSchema, TContext> & {
+    execute?: TExecute;
+}): [TSchemaIn, TSchemaOut, TExecute] extends [ZodLikeSchema, ZodLikeSchema, Function] ? Tool<TSchemaIn, TSchemaOut, TSuspendSchema, TResumeSchema, TContext> & {
+    inputSchema: TSchemaIn;
+    outputSchema: TSchemaOut;
+    execute: (context: TContext, options: MastraToolInvocationOptions) => Promise<any>;
+} : Tool<TSchemaIn, TSchemaOut, TSuspendSchema, TResumeSchema, TContext>;
+//# sourceMappingURL=tool.d.ts.map

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

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

package/dist/tools/toolchecks.d.ts

@@ -0,0 +1,9 @@
+import type { ToolToConvert } from './tool-builder/builder.js';
+import type { VercelTool } from './types.js';
+/**
+ * Checks if a tool is a Vercel Tool
+ * @param tool - The tool to check
+ * @returns True if the tool is a Vercel Tool, false otherwise
+ */
+export declare function isVercelTool(tool?: ToolToConvert): tool is VercelTool;
+//# sourceMappingURL=toolchecks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolchecks.d.ts","sourceRoot":"","sources":["../../src/tools/toolchecks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,IAAI,UAAU,CAGrE"}

package/dist/tools/types.d.ts

@@ -0,0 +1,70 @@
+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 { Mastra } from '../mastra/index.js';
+import type { RuntimeContext } from '../runtime-context/index.js';
+import type { ZodLikeSchema, InferZodLikeSchema } from '../types/zod-compat.js';
+import type { ToolStream } from './stream.js';
+export type VercelTool = Tool;
+export type VercelToolV5 = ToolV5;
+export type ToolInvocationOptions = ToolExecutionOptions | ToolCallOptions;
+/**
+ * Extended version of ToolInvocationOptions that includes Mastra-specific properties
+ * for suspend/resume functionality, stream writing, and tracing context.
+ */
+export type MastraToolInvocationOptions = ToolInvocationOptions & {
+    suspend?: (suspendPayload: any) => Promise<any>;
+    resumeData?: any;
+    writableStream?: WritableStream<any> | ToolStream<any>;
+    tracingContext?: TracingContext;
+};
+export type CoreTool = {
+    description?: string;
+    parameters: FlexibleSchema<any> | Schema;
+    outputSchema?: FlexibleSchema<any> | Schema;
+    execute?: (params: any, options: MastraToolInvocationOptions) => Promise<any>;
+} & ({
+    type?: 'function' | undefined;
+    id?: string;
+} | {
+    type: 'provider-defined';
+    id: `${string}.${string}`;
+    args: Record<string, unknown>;
+});
+export type InternalCoreTool = {
+    description?: string;
+    parameters: Schema;
+    outputSchema?: Schema;
+    execute?: (params: any, options: MastraToolInvocationOptions) => Promise<any>;
+} & ({
+    type?: 'function' | undefined;
+    id?: string;
+} | {
+    type: 'provider-defined';
+    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> {
+    mastra?: MastraUnion;
+    runtimeContext: RuntimeContext;
+    writer?: ToolStream<any>;
+    tracingContext?: TracingContext;
+    suspend?: (suspendPayload: InferZodLikeSchema<TSuspendSchema>) => Promise<any>;
+    resumeData?: InferZodLikeSchema<TResumeSchema>;
+}
+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> {
+    suspendSchema?: TSuspendSchema;
+    resumeSchema?: TResumeSchema;
+    description: string;
+    execute?: (context: TContext, options?: MastraToolInvocationOptions) => Promise<TSchemaOut extends ZodLikeSchema ? InferZodLikeSchema<TSchemaOut> : unknown>;
+    mastra?: Mastra;
+    requireApproval?: boolean;
+    onInputStart?: (options: ToolCallOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & ToolCallOptions) => void | PromiseLike<void>;
+    onInputAvailable?: (options: {
+        input: InferZodLikeSchema<TSchemaIn>;
+    } & ToolCallOptions) => void | PromiseLike<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/ui-types.d.ts

@@ -0,0 +1,39 @@
+import type { z } from 'zod';
+import type { Tool } from './tool.js';
+/**
+ * UI tool type for use with AI SDK frontend components
+ */
+export type UITool = {
+    input: unknown;
+    output: unknown | undefined;
+};
+/**
+ * Infer the input type of a Mastra tool
+ */
+export type InferToolInput<T> = T extends Tool<infer I, any, any> ? (I extends z.ZodSchema ? z.infer<I> : never) : never;
+/**
+ * Infer the output type of a Mastra tool
+ */
+export type InferToolOutput<T> = T extends Tool<any, infer O, any> ? (O extends z.ZodSchema ? z.infer<O> : never) : never;
+/**
+ * Infer the input and output types of a tool so it can be used as a UI tool.
+ */
+export type InferUITool<TOOL> = {
+    input: InferToolInput<TOOL>;
+    output: InferToolOutput<TOOL>;
+};
+/**
+ * A set of tools (object with tool instances)
+ */
+export type ToolSet = Record<string, Tool<any, any, any>>;
+/**
+ * Infer the input and output types of a tool set so it can be used as a UI tool set.
+ */
+export type InferUITools<TOOLS extends ToolSet> = {
+    [NAME in keyof TOOLS & string]: InferUITool<TOOLS[NAME]>;
+};
+/**
+ * UI tools type for frontend components
+ */
+export type UITools = Record<string, UITool>;
+//# sourceMappingURL=ui-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui-types.d.ts","sourceRoot":"","sources":["../../src/tools/ui-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAC1B,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAC3B,CAAC,SAAS,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,IAAI;IAC9B,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,OAAO,IAAI;KAC/C,IAAI,IAAI,MAAM,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/tools/validation.d.ts

@@ -0,0 +1,19 @@
+import type { z } from 'zod';
+import type { ZodLikeSchema } from '../types/zod-compat.js';
+export interface ValidationError<T = any> {
+    error: true;
+    message: string;
+    validationErrors: z.ZodFormattedError<T>;
+}
+/**
+ * Validates input against a Zod schema and returns a structured error if validation fails
+ * @param schema The Zod schema to validate against
+ * @param input The input to validate
+ * @param toolId Optional tool ID for better error messages
+ * @returns The validation error object if validation fails, undefined if successful
+ */
+export declare function validateToolInput<T = any>(schema: ZodLikeSchema | undefined, input: unknown, toolId?: string): {
+    data: T | unknown;
+    error?: ValidationError<T>;
+};
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +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"}

package/dist/tts/index.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkDMBN72QF_cjs = require('../chunk-DMBN72QF.cjs');
+
+
+
+Object.defineProperty(exports, "MastraTTS", {
+  enumerable: true,
+  get: function () { return chunkDMBN72QF_cjs.MastraTTS; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/tts/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/tts/index.d.ts

@@ -0,0 +1,22 @@
+import { MastraBase } from '../base.js';
+interface BuiltInModelConfig {
+    provider: string;
+    name: string;
+    apiKey?: string;
+}
+export interface TTSConfig {
+    model: BuiltInModelConfig;
+}
+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>;
+    abstract stream({ text }: {
+        text: string;
+    }): Promise<any>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/tts/index.js

@@ -0,0 +1,3 @@
+export { MastraTTS } from '../chunk-NPNGPMT2.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/tts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

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

@@ -0,0 +1,7 @@
+import { MastraTTS as BaseMastraTTS } from './index.js';
+import type { TTSConfig } from './index.js';
+export * from './index.js';
+export declare abstract class MastraTTS extends BaseMastraTTS {
+    constructor(args: TTSConfig);
+}
+//# sourceMappingURL=index.warning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.warning.d.ts","sourceRoot":"","sources":["../../src/tts/index.warning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,cAAc,SAAS,CAAC;AAExB,8BAAsB,SAAU,SAAQ,aAAa;gBACvC,IAAI,EAAE,SAAS;CAK5B"}

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

@@ -0,0 +1,9 @@
+import type { Mastra } from '../mastra/index.js';
+import type { RuntimeContext } from '../runtime-context/index.js';
+export type DynamicArgument<T> = T | (({ runtimeContext, mastra }: {
+    runtimeContext: RuntimeContext;
+    mastra?: Mastra;
+}) => Promise<T> | T);
+export type NonEmpty<T extends string> = T extends '' ? never : T;
+export type MastraIdGenerator = () => NonEmpty<string>;
+//# sourceMappingURL=dynamic-argument.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-argument.d.ts","sourceRoot":"","sources":["../../src/types/dynamic-argument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,eAAe,CAAC,CAAC,IACzB,CAAC,GACD,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE;IAAE,cAAc,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1G,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC"}

package/dist/types/index.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './dynamic-argument.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types/zod-compat.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Type compatibility layer for Zod v3 and v4
+ *
+ * Zod v3 and v4 have different internal type structures, but they share
+ * the same public API. This type uses structural typing to accept schemas
+ * from both versions by checking for the presence of key methods rather
+ * than relying on exact type matching.
+ */
+export type ZodLikeSchema = {
+    parse: (data: unknown) => any;
+    safeParse: (data: unknown) => {
+        success: boolean;
+        data?: any;
+        error?: any;
+    };
+};
+/**
+ * Helper type for extracting the inferred type from a Zod-like schema
+ */
+export type InferZodLikeSchema<T> = T extends {
+    parse: (data: unknown) => infer U;
+} ? U : any;
+//# sourceMappingURL=zod-compat.d.ts.map

package/dist/types/zod-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-compat.d.ts","sourceRoot":"","sources":["../../src/types/zod-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,GAAG,CAAC;IAC9B,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;CAC7E,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,GAAG,CAAC"}

package/dist/utils.cjs

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

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"utils.cjs"}