@mastra/core 0.16.2-alpha.0 → 0.16.3-alpha.0

package/dist/ai-tracing/index.cjs

@@ -1,120 +1,116 @@
 'use strict';
 
-var chunkUGCG7DI3_cjs = require('../chunk-UGCG7DI3.cjs');
+var chunkVVUCWRGD_cjs = require('../chunk-VVUCWRGD.cjs');
 
 
 
 Object.defineProperty(exports, "AISpanType", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.AISpanType; }
+  get: function () { return chunkVVUCWRGD_cjs.AISpanType; }
 });
 Object.defineProperty(exports, "AITracingEventType", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.AITracingEventType; }
+  get: function () { return chunkVVUCWRGD_cjs.AITracingEventType; }
+});
+Object.defineProperty(exports, "CloudExporter", {
+  enumerable: true,
+  get: function () { return chunkVVUCWRGD_cjs.CloudExporter; }
 });
 Object.defineProperty(exports, "ConsoleExporter", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.ConsoleExporter; }
+  get: function () { return chunkVVUCWRGD_cjs.ConsoleExporter; }
 });
 Object.defineProperty(exports, "DefaultAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.DefaultAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.DefaultAITracing; }
 });
 Object.defineProperty(exports, "DefaultExporter", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.DefaultExporter; }
+  get: function () { return chunkVVUCWRGD_cjs.DefaultExporter; }
 });
 Object.defineProperty(exports, "MastraAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.MastraAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.MastraAITracing; }
 });
 Object.defineProperty(exports, "SamplingStrategyType", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.SamplingStrategyType; }
+  get: function () { return chunkVVUCWRGD_cjs.SamplingStrategyType; }
 });
 Object.defineProperty(exports, "SensitiveDataFilter", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.SensitiveDataFilter; }
+  get: function () { return chunkVVUCWRGD_cjs.SensitiveDataFilter; }
 });
-Object.defineProperty(exports, "aiTracingDefaultConfig", {
+Object.defineProperty(exports, "clearAITracingRegistry", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.aiTracingDefaultConfig; }
+  get: function () { return chunkVVUCWRGD_cjs.clearAITracingRegistry; }
 });
-Object.defineProperty(exports, "clearAITracingRegistry", {
+Object.defineProperty(exports, "deepClean", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.clearAITracingRegistry; }
+  get: function () { return chunkVVUCWRGD_cjs.deepClean; }
 });
 Object.defineProperty(exports, "getAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.getAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.getAITracing; }
 });
 Object.defineProperty(exports, "getAllAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.getAllAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.getAllAITracing; }
 });
 Object.defineProperty(exports, "getDefaultAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.getDefaultAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.getDefaultAITracing; }
 });
 Object.defineProperty(exports, "getOrCreateSpan", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.getOrCreateSpan; }
+  get: function () { return chunkVVUCWRGD_cjs.getOrCreateSpan; }
 });
 Object.defineProperty(exports, "getSelectedAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.getSelectedAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.getSelectedAITracing; }
+});
+Object.defineProperty(exports, "getValidTraceId", {
+  enumerable: true,
+  get: function () { return chunkVVUCWRGD_cjs.getValidTraceId; }
 });
 Object.defineProperty(exports, "hasAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.hasAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.hasAITracing; }
 });
 Object.defineProperty(exports, "isMastra", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.isMastra; }
+  get: function () { return chunkVVUCWRGD_cjs.isMastra; }
 });
 Object.defineProperty(exports, "omitKeys", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.omitKeys; }
+  get: function () { return chunkVVUCWRGD_cjs.omitKeys; }
 });
 Object.defineProperty(exports, "registerAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.registerAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.registerAITracing; }
 });
 Object.defineProperty(exports, "selectFields", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.selectFields; }
+  get: function () { return chunkVVUCWRGD_cjs.selectFields; }
 });
 Object.defineProperty(exports, "setAITracingSelector", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.setAITracingSelector; }
+  get: function () { return chunkVVUCWRGD_cjs.setAITracingSelector; }
 });
 Object.defineProperty(exports, "setupAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.setupAITracing; }
-});
-Object.defineProperty(exports, "shallowClean", {
-  enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.shallowClean; }
-});
-Object.defineProperty(exports, "shallowCleanArray", {
-  enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.shallowCleanArray; }
-});
-Object.defineProperty(exports, "shallowCleanObject", {
-  enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.shallowCleanObject; }
+  get: function () { return chunkVVUCWRGD_cjs.setupAITracing; }
 });
 Object.defineProperty(exports, "shutdownAITracingRegistry", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.shutdownAITracingRegistry; }
+  get: function () { return chunkVVUCWRGD_cjs.shutdownAITracingRegistry; }
 });
 Object.defineProperty(exports, "unregisterAITracing", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.unregisterAITracing; }
+  get: function () { return chunkVVUCWRGD_cjs.unregisterAITracing; }
 });
 Object.defineProperty(exports, "wrapMastra", {
   enumerable: true,
-  get: function () { return chunkUGCG7DI3_cjs.wrapMastra; }
+  get: function () { return chunkVVUCWRGD_cjs.wrapMastra; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/ai-tracing/index.js

@@ -1,3 +1,3 @@
-export { AISpanType, AITracingEventType, ConsoleExporter, DefaultAITracing, DefaultExporter, MastraAITracing, SamplingStrategyType, SensitiveDataFilter, aiTracingDefaultConfig, clearAITracingRegistry, getAITracing, getAllAITracing, getDefaultAITracing, getOrCreateSpan, getSelectedAITracing, hasAITracing, isMastra, omitKeys, registerAITracing, selectFields, setAITracingSelector, setupAITracing, shallowClean, shallowCleanArray, shallowCleanObject, shutdownAITracingRegistry, unregisterAITracing, wrapMastra } from '../chunk-2NKNTPFR.js';
+export { AISpanType, AITracingEventType, CloudExporter, ConsoleExporter, DefaultAITracing, DefaultExporter, MastraAITracing, SamplingStrategyType, SensitiveDataFilter, clearAITracingRegistry, deepClean, getAITracing, getAllAITracing, getDefaultAITracing, getOrCreateSpan, getSelectedAITracing, getValidTraceId, hasAITracing, isMastra, omitKeys, registerAITracing, selectFields, setAITracingSelector, setupAITracing, shutdownAITracingRegistry, unregisterAITracing, wrapMastra } from '../chunk-W5K2KOZX.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/ai-tracing/no-op.d.ts

@@ -57,5 +57,6 @@ export declare class NoOpAISpan<TType extends AISpanType = any> implements AISpa
         metadata?: Record<string, any>;
     }): void;
     get isRootSpan(): boolean;
+    get isValid(): boolean;
 }
 //# sourceMappingURL=no-op.d.ts.map

package/dist/ai-tracing/no-op.d.ts.map

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

package/dist/ai-tracing/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAGzC,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,eAAe,EAA2B,MAAM,SAAS,CAAC;AA2GnH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,UAAQ,GAAG,IAAI,CAElG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,SAAS,CAEjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,GAAG,SAAS,CAEnG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASlD;AAWD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAiB5D"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAIzC,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,eAAe,EAA2B,MAAM,SAAS,CAAC;AA2GnH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,UAAQ,GAAG,IAAI,CAElG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,SAAS,CAEjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,GAAG,SAAS,CAEnG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASlD;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA+C5D"}

package/dist/ai-tracing/types.d.ts

@@ -78,12 +78,17 @@ export interface LLMGenerationAttributes extends AIBaseAttributes {
     };
     /** Model parameters */
     parameters?: {
+        maxOutputTokens?: number;
         temperature?: number;
-        maxTokens?: number;
         topP?: number;
-        frequencyPenalty?: number;
+        topK?: number;
         presencePenalty?: number;
-        stop?: string[];
+        frequencyPenalty?: number;
+        stopSequences?: string[];
+        seed?: number;
+        maxRetries?: number;
+        abortSignal?: any;
+        headers?: Record<string, string | undefined>;
     };
     /** Whether this was a streaming response */
     streaming?: boolean;
@@ -306,6 +311,8 @@ export interface AISpan<TType extends AISpanType> {
     }): AISpan<TChildType>;
     /** Returns `TRUE` if the span is the root span of a trace */
     get isRootSpan(): boolean;
+    /** Returns `TRUE` if the span is a valid span (not a NO-OP Span) */
+    get isValid(): boolean;
 }
 /**
  * Union type for cases that need to handle any span
@@ -332,6 +339,27 @@ export interface AISpanOptions<TType extends AISpanType> {
     /** Is an event span? */
     isEvent: boolean;
 }
+/**
+ * Options passed when starting a new agent or workflow execution
+ */
+export interface TracingOptions {
+    /** Metadata to add to the root trace span */
+    metadata?: Record<string, any>;
+}
+/**
+ * Context for AI tracing that flows through workflow and agent execution
+ */
+export interface TracingContext {
+    /** Current AI span for creating child spans and adding metadata */
+    currentSpan?: AnyAISpan;
+}
+/**
+ * Properties returned to the user for working with traces externally.
+ */
+export type TracingProperties = {
+    /** Trace ID used on the execution (if the execution was traced). */
+    traceId?: string;
+};
 /**
  * Sampling strategy types
  */
@@ -367,10 +395,10 @@ export type TracingStrategy = 'realtime' | 'batch-with-updates' | 'insert-only';
  * Configuration for a single AI tracing instance
  */
 export interface AITracingInstanceConfig {
+    /** Unique identifier for this config in the ai tracing registry */
+    name: string;
     /** Service name for tracing */
     serviceName: string;
-    /** Instance name from the registry */
-    instanceName: string;
     /** Sampling strategy - controls whether tracing is collected (defaults to ALWAYS) */
     sampling?: SamplingStrategy;
     /** Custom exporters */
@@ -382,10 +410,14 @@ export interface AITracingInstanceConfig {
  * Complete AI Tracing configuration
  */
 export interface AITracingConfig {
+    /** Enables default exporters, with sampling: always, and sensitive data filtering */
+    default?: {
+        enabled?: boolean;
+    };
     /** Map of tracing instance names to their configurations or pre-instantiated instances */
-    instances: Record<string, Omit<AITracingInstanceConfig, 'instanceName'> | MastraAITracing>;
+    configs?: Record<string, Omit<AITracingInstanceConfig, 'name'> | MastraAITracing>;
     /** Optional selector function to choose which tracing instance to use */
-    selector?: TracingSelector;
+    configSelector?: TracingSelector;
 }
 /**
  * AI Tracing event types
@@ -444,11 +476,4 @@ export interface AITracingSelectorContext {
  * Returns the name of the tracing instance, or undefined to use default
  */
 export type TracingSelector = (context: AITracingSelectorContext, availableTracers: ReadonlyMap<string, MastraAITracing>) => string | undefined;
-/**
- * Context for AI tracing that flows through workflow and agent execution
- */
-export interface TracingContext {
-    /** Current AI span for creating child spans and adding metadata */
-    currentSpan?: AnyAISpan;
-}
 //# sourceMappingURL=types.d.ts.map

package/dist/ai-tracing/types.d.ts.map

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

package/dist/ai-tracing/utils.d.ts

@@ -3,27 +3,24 @@
  * used in AI tracing and observability.
  */
 import type { RuntimeContext } from '../di/index.js';
-import type { AISpan, AISpanType, AISpanTypeMap, TracingContext } from './types.js';
+import type { AISpan, AISpanType, AISpanTypeMap, AnyAISpan, TracingContext, TracingOptions } from './types.js';
+export interface DeepCleanOptions {
+    keysToStrip?: Set<string>;
+    maxDepth?: number;
+}
 /**
- * Cleans an object by testing each key-value pair for circular references.
- * Problematic values are replaced with error messages for debugging.
- * @param obj - Object to clean
- * @returns Cleaned object with circular references marked
- */
-export declare function shallowCleanObject(obj: Record<string, any>): Record<string, any>;
-/**
- * Cleans an array by applying object cleaning to each item.
- * @param arr - Array to clean
- * @returns Cleaned array with problematic items marked
- */
-export declare function shallowCleanArray(arr: any[]): any[];
-/**
- * Safely cleans any value by removing circular references and marking problematic data.
- * Provides detailed error information to help identify issues in source code.
- * @param value - Value to clean (object, array, primitive, etc.)
- * @returns Cleaned value with circular references marked
+ * Recursively cleans a value by removing circular references and stripping problematic or sensitive keys.
+ * Circular references are replaced with "[Circular]". Unserializable values are replaced with error messages.
+ * Keys like "logger" and "tracingContext" are stripped by default.
+ * A maximum recursion depth is enforced to avoid stack overflow or excessive memory usage.
+ *
+ * @param value - The value to clean (object, array, primitive, etc.)
+ * @param options - Optional configuration:
+ *   - keysToStrip: Set of keys to remove from objects (default: logger, tracingContext)
+ *   - maxDepth: Maximum recursion depth before values are replaced with "[MaxDepth]" (default: 10)
+ * @returns A cleaned version of the input with circular references, specified keys, and overly deep values handled
  */
-export declare function shallowClean(value: any): any;
+export declare function deepClean(value: any, options?: DeepCleanOptions, _seen?: WeakSet<any>, _depth?: number): any;
 /**
  * Removes specific keys from an object.
  * @param obj - The original object
@@ -55,6 +52,19 @@ export declare function getOrCreateSpan<T extends AISpanType>(options: {
     attributes?: AISpanTypeMap[T];
     metadata?: Record<string, any>;
     tracingContext?: TracingContext;
+    tracingOptions?: TracingOptions;
     runtimeContext?: RuntimeContext;
 }): AISpan<T> | undefined;
+/**
+ * Extracts the trace ID from a span if it is valid.
+ *
+ * This helper is typically used to safely retrieve the `traceId` from a span object,
+ * while gracefully handling invalid spans — such as no-op spans — by returning `undefined`.
+ *
+ * A span is considered valid if `span.isValid` is `true`.
+ *
+ * @param span - The span object to extract the trace ID from. May be `undefined`.
+ * @returns The `traceId` if the span is valid, otherwise `undefined`.
+ */
+export declare function getValidTraceId(span?: AnyAISpan): string | undefined;
 //# sourceMappingURL=utils.d.ts.map

package/dist/ai-tracing/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEjF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAchF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAenD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAoB5C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAe5D;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,EAAE;IAC7D,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAyBxB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAS5G,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,gBAAqB,EAC9B,KAAK,GAAE,OAAO,CAAC,GAAG,CAAiB,EACnC,MAAM,GAAE,MAAU,GACjB,GAAG,CAwCL;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAe5D;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,EAAE;IAC7D,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAgCxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAEpE"}

package/dist/{chunk-YI3AIJJL.js → chunk-3JG5JEKX.js}

@@ -1,4 +1,4 @@
-import { fetchWithRetry } from './chunk-TDLB5JKT.js';
+import { fetchWithRetry } from './chunk-W5K2KOZX.js';
 import { MastraError } from './chunk-MCOVMKIS.js';
 import { randomUUID } from 'crypto';
 import * as AIV4 from 'ai';
@@ -2858,5 +2858,5 @@ function convertMessages(messages) {
 }
 
 export { DefaultGeneratedFile, DefaultGeneratedFileWithType, MessageList, convertMessages };
-//# sourceMappingURL=chunk-YI3AIJJL.js.map
-//# sourceMappingURL=chunk-YI3AIJJL.js.map
+//# sourceMappingURL=chunk-3JG5JEKX.js.map
+//# sourceMappingURL=chunk-3JG5JEKX.js.map