@mastra/core 0.24.8 → 0.24.9-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/core
 
+## 0.24.9-alpha.1
+
+## 0.24.9-alpha.0
+
+### Patch Changes
+
+- Fix memory leak in telemetry decorators when processing large payloads. The `@withSpan` decorator now uses bounded serialization utilities to prevent unbounded memory growth when tracing agents with large inputs like base64 images. ([#11231](https://github.com/mastra-ai/mastra/pull/11231))
+
 ## 0.24.8
 
 ## 0.24.8-alpha.0

package/dist/agent/index.cjs

@@ -1,53 +1,53 @@
 'use strict';
 
-var chunkYYKN3NDZ_cjs = require('../chunk-YYKN3NDZ.cjs');
-var chunk4YYPQOP7_cjs = require('../chunk-4YYPQOP7.cjs');
+var chunkZWWHTQ72_cjs = require('../chunk-ZWWHTQ72.cjs');
+var chunkRDD5YB3T_cjs = require('../chunk-RDD5YB3T.cjs');
 
 
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.Agent; }
+  get: function () { return chunkZWWHTQ72_cjs.Agent; }
 });
 Object.defineProperty(exports, "LanguageDetectorInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.LanguageDetectorInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.LanguageDetectorInputProcessor; }
 });
 Object.defineProperty(exports, "ModerationInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.ModerationInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.ModerationInputProcessor; }
 });
 Object.defineProperty(exports, "PIIDetectorInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.PIIDetectorInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.PIIDetectorInputProcessor; }
 });
 Object.defineProperty(exports, "PromptInjectionDetectorInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.PromptInjectionDetectorInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.PromptInjectionDetectorInputProcessor; }
 });
 Object.defineProperty(exports, "TripWire", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.TripWire; }
+  get: function () { return chunkZWWHTQ72_cjs.TripWire; }
 });
 Object.defineProperty(exports, "UnicodeNormalizerInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.UnicodeNormalizerInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.UnicodeNormalizerInputProcessor; }
 });
 Object.defineProperty(exports, "tryGenerateWithJsonFallback", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.tryGenerateWithJsonFallback; }
+  get: function () { return chunkZWWHTQ72_cjs.tryGenerateWithJsonFallback; }
 });
 Object.defineProperty(exports, "tryStreamWithJsonFallback", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.tryStreamWithJsonFallback; }
+  get: function () { return chunkZWWHTQ72_cjs.tryStreamWithJsonFallback; }
 });
 Object.defineProperty(exports, "MessageList", {
   enumerable: true,
-  get: function () { return chunk4YYPQOP7_cjs.MessageList; }
+  get: function () { return chunkRDD5YB3T_cjs.MessageList; }
 });
 Object.defineProperty(exports, "convertMessages", {
   enumerable: true,
-  get: function () { return chunk4YYPQOP7_cjs.convertMessages; }
+  get: function () { return chunkRDD5YB3T_cjs.convertMessages; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/agent/index.js

@@ -1,4 +1,4 @@
-export { Agent, LanguageDetectorInputProcessor, ModerationInputProcessor, PIIDetectorInputProcessor, PromptInjectionDetectorInputProcessor, TripWire, UnicodeNormalizerInputProcessor, tryGenerateWithJsonFallback, tryStreamWithJsonFallback } from '../chunk-Y2BH2LUD.js';
-export { MessageList, convertMessages } from '../chunk-GIK7MM2K.js';
+export { Agent, LanguageDetectorInputProcessor, ModerationInputProcessor, PIIDetectorInputProcessor, PromptInjectionDetectorInputProcessor, TripWire, UnicodeNormalizerInputProcessor, tryGenerateWithJsonFallback, tryStreamWithJsonFallback } from '../chunk-GSQD3QNR.js';
+export { MessageList, convertMessages } from '../chunk-NFJJ6B6P.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/agent/input-processor/index.cjs

@@ -1,28 +1,28 @@
 'use strict';
 
-var chunkYYKN3NDZ_cjs = require('../../chunk-YYKN3NDZ.cjs');
+var chunkZWWHTQ72_cjs = require('../../chunk-ZWWHTQ72.cjs');
 
 
 
 Object.defineProperty(exports, "LanguageDetectorInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.LanguageDetectorInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.LanguageDetectorInputProcessor; }
 });
 Object.defineProperty(exports, "ModerationInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.ModerationInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.ModerationInputProcessor; }
 });
 Object.defineProperty(exports, "PIIDetectorInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.PIIDetectorInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.PIIDetectorInputProcessor; }
 });
 Object.defineProperty(exports, "PromptInjectionDetectorInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.PromptInjectionDetectorInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.PromptInjectionDetectorInputProcessor; }
 });
 Object.defineProperty(exports, "UnicodeNormalizerInputProcessor", {
   enumerable: true,
-  get: function () { return chunkYYKN3NDZ_cjs.UnicodeNormalizerInputProcessor; }
+  get: function () { return chunkZWWHTQ72_cjs.UnicodeNormalizerInputProcessor; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/agent/input-processor/index.js

@@ -1,3 +1,3 @@
-export { LanguageDetectorInputProcessor, ModerationInputProcessor, PIIDetectorInputProcessor, PromptInjectionDetectorInputProcessor, UnicodeNormalizerInputProcessor } from '../../chunk-Y2BH2LUD.js';
+export { LanguageDetectorInputProcessor, ModerationInputProcessor, PIIDetectorInputProcessor, PromptInjectionDetectorInputProcessor, UnicodeNormalizerInputProcessor } from '../../chunk-GSQD3QNR.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/ai-tracing/index.cjs

@@ -1,148 +1,165 @@
 'use strict';
 
-var chunkYPYLWTZI_cjs = require('../chunk-YPYLWTZI.cjs');
+var chunkQGJF6TRY_cjs = require('../chunk-QGJF6TRY.cjs');
+var chunk3L3ISSMS_cjs = require('../chunk-3L3ISSMS.cjs');
 
 
 
 Object.defineProperty(exports, "AISpanType", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.AISpanType; }
+  get: function () { return chunkQGJF6TRY_cjs.AISpanType; }
 });
 Object.defineProperty(exports, "AITracingEventType", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.AITracingEventType; }
+  get: function () { return chunkQGJF6TRY_cjs.AITracingEventType; }
 });
 Object.defineProperty(exports, "BaseAISpan", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.BaseAISpan; }
+  get: function () { return chunkQGJF6TRY_cjs.BaseAISpan; }
 });
 Object.defineProperty(exports, "BaseAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.BaseAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.BaseAITracing; }
 });
 Object.defineProperty(exports, "BaseExporter", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.BaseExporter; }
+  get: function () { return chunkQGJF6TRY_cjs.BaseExporter; }
 });
 Object.defineProperty(exports, "CloudExporter", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.CloudExporter; }
+  get: function () { return chunkQGJF6TRY_cjs.CloudExporter; }
 });
 Object.defineProperty(exports, "ConsoleExporter", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.ConsoleExporter; }
+  get: function () { return chunkQGJF6TRY_cjs.ConsoleExporter; }
 });
 Object.defineProperty(exports, "DefaultAISpan", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.DefaultAISpan; }
+  get: function () { return chunkQGJF6TRY_cjs.DefaultAISpan; }
 });
 Object.defineProperty(exports, "DefaultAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.DefaultAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.DefaultAITracing; }
 });
 Object.defineProperty(exports, "DefaultExporter", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.DefaultExporter; }
+  get: function () { return chunkQGJF6TRY_cjs.DefaultExporter; }
 });
 Object.defineProperty(exports, "InternalSpans", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.InternalSpans; }
+  get: function () { return chunkQGJF6TRY_cjs.InternalSpans; }
 });
 Object.defineProperty(exports, "ModelSpanTracker", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.ModelSpanTracker; }
+  get: function () { return chunkQGJF6TRY_cjs.ModelSpanTracker; }
 });
 Object.defineProperty(exports, "NoOpAISpan", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.NoOpAISpan; }
+  get: function () { return chunkQGJF6TRY_cjs.NoOpAISpan; }
 });
 Object.defineProperty(exports, "SamplingStrategyType", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.SamplingStrategyType; }
+  get: function () { return chunkQGJF6TRY_cjs.SamplingStrategyType; }
 });
 Object.defineProperty(exports, "SensitiveDataFilter", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.SensitiveDataFilter; }
+  get: function () { return chunkQGJF6TRY_cjs.SensitiveDataFilter; }
 });
 Object.defineProperty(exports, "clearAITracingRegistry", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.clearAITracingRegistry; }
-});
-Object.defineProperty(exports, "deepClean", {
-  enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.deepClean; }
+  get: function () { return chunkQGJF6TRY_cjs.clearAITracingRegistry; }
 });
 Object.defineProperty(exports, "getAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.getAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.getAITracing; }
 });
 Object.defineProperty(exports, "getAllAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.getAllAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.getAllAITracing; }
 });
 Object.defineProperty(exports, "getDefaultAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.getDefaultAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.getDefaultAITracing; }
 });
 Object.defineProperty(exports, "getNestedValue", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.getNestedValue; }
+  get: function () { return chunkQGJF6TRY_cjs.getNestedValue; }
 });
 Object.defineProperty(exports, "getOrCreateSpan", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.getOrCreateSpan; }
+  get: function () { return chunkQGJF6TRY_cjs.getOrCreateSpan; }
 });
 Object.defineProperty(exports, "getSelectedAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.getSelectedAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.getSelectedAITracing; }
 });
 Object.defineProperty(exports, "getValidTraceId", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.getValidTraceId; }
+  get: function () { return chunkQGJF6TRY_cjs.getValidTraceId; }
 });
 Object.defineProperty(exports, "hasAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.hasAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.hasAITracing; }
 });
 Object.defineProperty(exports, "isMastra", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.isMastra; }
+  get: function () { return chunkQGJF6TRY_cjs.isMastra; }
 });
 Object.defineProperty(exports, "omitKeys", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.omitKeys; }
+  get: function () { return chunkQGJF6TRY_cjs.omitKeys; }
 });
 Object.defineProperty(exports, "registerAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.registerAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.registerAITracing; }
 });
 Object.defineProperty(exports, "selectFields", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.selectFields; }
+  get: function () { return chunkQGJF6TRY_cjs.selectFields; }
 });
 Object.defineProperty(exports, "setNestedValue", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.setNestedValue; }
+  get: function () { return chunkQGJF6TRY_cjs.setNestedValue; }
 });
 Object.defineProperty(exports, "setSelector", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.setSelector; }
+  get: function () { return chunkQGJF6TRY_cjs.setSelector; }
 });
 Object.defineProperty(exports, "setupAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.setupAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.setupAITracing; }
 });
 Object.defineProperty(exports, "shutdownAITracingRegistry", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.shutdownAITracingRegistry; }
+  get: function () { return chunkQGJF6TRY_cjs.shutdownAITracingRegistry; }
 });
 Object.defineProperty(exports, "unregisterAITracing", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.unregisterAITracing; }
+  get: function () { return chunkQGJF6TRY_cjs.unregisterAITracing; }
 });
 Object.defineProperty(exports, "wrapMastra", {
   enumerable: true,
-  get: function () { return chunkYPYLWTZI_cjs.wrapMastra; }
+  get: function () { return chunkQGJF6TRY_cjs.wrapMastra; }
+});
+Object.defineProperty(exports, "DEFAULT_KEYS_TO_STRIP", {
+  enumerable: true,
+  get: function () { return chunk3L3ISSMS_cjs.DEFAULT_KEYS_TO_STRIP; }
+});
+Object.defineProperty(exports, "DEFAULT_SERIALIZATION_LIMITS", {
+  enumerable: true,
+  get: function () { return chunk3L3ISSMS_cjs.DEFAULT_SERIALIZATION_LIMITS; }
+});
+Object.defineProperty(exports, "boundedStringify", {
+  enumerable: true,
+  get: function () { return chunk3L3ISSMS_cjs.boundedStringify; }
+});
+Object.defineProperty(exports, "deepClean", {
+  enumerable: true,
+  get: function () { return chunk3L3ISSMS_cjs.deepClean; }
+});
+Object.defineProperty(exports, "truncateString", {
+  enumerable: true,
+  get: function () { return chunk3L3ISSMS_cjs.truncateString; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -10,4 +10,5 @@ export * from './context.js';
 export * from './exporters/index.js';
 export * from './span_processors/index.js';
 export * from './model-tracing.js';
+export * from './serialization.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/ai-tracing/index.js

@@ -1,3 +1,4 @@
-export { AISpanType, AITracingEventType, BaseAISpan, BaseAITracing, BaseExporter, CloudExporter, ConsoleExporter, DefaultAISpan, DefaultAITracing, DefaultExporter, InternalSpans, ModelSpanTracker, NoOpAISpan, SamplingStrategyType, SensitiveDataFilter, clearAITracingRegistry, deepClean, getAITracing, getAllAITracing, getDefaultAITracing, getNestedValue, getOrCreateSpan, getSelectedAITracing, getValidTraceId, hasAITracing, isMastra, omitKeys, registerAITracing, selectFields, setNestedValue, setSelector, setupAITracing, shutdownAITracingRegistry, unregisterAITracing, wrapMastra } from '../chunk-PPAIPZ6C.js';
+export { AISpanType, AITracingEventType, BaseAISpan, BaseAITracing, BaseExporter, CloudExporter, ConsoleExporter, DefaultAISpan, DefaultAITracing, DefaultExporter, InternalSpans, ModelSpanTracker, NoOpAISpan, SamplingStrategyType, SensitiveDataFilter, clearAITracingRegistry, getAITracing, getAllAITracing, getDefaultAITracing, getNestedValue, getOrCreateSpan, getSelectedAITracing, getValidTraceId, hasAITracing, isMastra, omitKeys, registerAITracing, selectFields, setNestedValue, setSelector, setupAITracing, shutdownAITracingRegistry, unregisterAITracing, wrapMastra } from '../chunk-BBE22VBK.js';
+export { DEFAULT_KEYS_TO_STRIP, DEFAULT_SERIALIZATION_LIMITS, boundedStringify, deepClean, truncateString } from '../chunk-PA6Z5V6U.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,60 @@
+/**
+ * Bounded serialization utilities for AI tracing.
+ *
+ * These utilities prevent memory issues by enforcing strict limits on
+ * string lengths, array sizes, object depths, and total output size.
+ * They are designed to be used across all tracing/telemetry systems.
+ */
+/**
+ * Configuration limits for serialization.
+ * These defaults are intentionally conservative to prevent OOM issues.
+ */
+export interface SerializationLimits {
+    /** Maximum characters for any single attribute string (default: 1024) */
+    maxAttrChars: number;
+    /** Maximum depth for recursive serialization (default: 6) */
+    maxDepth: number;
+    /** Maximum object keys to serialize (default: 50) */
+    maxKeys: number;
+    /** Maximum array elements to serialize (default: 50) */
+    maxArrayItems: number;
+    /** Maximum total output characters (default: 8192) */
+    maxTotalChars: number;
+}
+export declare const DEFAULT_SERIALIZATION_LIMITS: SerializationLimits;
+/**
+ * Hard-cap any string to prevent unbounded growth.
+ */
+export declare function truncateString(s: string, maxChars: number): string;
+/**
+ * Default keys to strip from objects during deep cleaning.
+ * These are typically internal/sensitive fields that shouldn't be traced.
+ */
+export declare const DEFAULT_KEYS_TO_STRIP: Set<string>;
+export interface DeepCleanOptions {
+    keysToStrip?: Set<string>;
+    maxDepth?: number;
+    maxStringLength?: number;
+    maxArrayLength?: number;
+    maxObjectKeys?: number;
+}
+/**
+ * Recursively cleans a value by removing circular references, stripping problematic keys,
+ * and enforcing size limits on strings, arrays, and objects.
+ *
+ * This is used by AI tracing spans to sanitize input/output data before storing.
+ *
+ * @param value - The value to clean (object, array, primitive, etc.)
+ * @param options - Optional configuration for cleaning behavior
+ * @returns A cleaned version of the input with size limits enforced
+ */
+export declare function deepClean(value: any, options?: DeepCleanOptions): any;
+/**
+ * Bounded safe stringify for when you need JSON output.
+ * Uses deepClean internally, then JSON.stringify with total length limit.
+ *
+ * @param value - The value to stringify
+ * @returns A JSON string representation with enforced limits
+ */
+export declare function boundedStringify(value: unknown): string;
+//# sourceMappingURL=serialization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/ai-tracing/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,4BAA4B,EAAE,mBAMzC,CAAC;AAEH;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aAMhC,CAAC;AAKH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,gBAAqB,GAAG,GAAG,CAkHzE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYvD"}

package/dist/ai-tracing/spans/base.d.ts

@@ -45,21 +45,4 @@ export declare abstract class BaseAISpan<TType extends AISpanType = any> impleme
     /** Returns a lightweight span ready for export */
     exportSpan(includeInternalSpans?: boolean): ExportedAISpan<TType>;
 }
-export interface DeepCleanOptions {
-    keysToStrip?: Set<string>;
-    maxDepth?: number;
-}
-/**
- * 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 deepClean(value: any, options?: DeepCleanOptions, _seen?: WeakSet<any>, _depth?: number): any;
 //# sourceMappingURL=base.d.ts.map

package/dist/ai-tracing/spans/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/spans/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/spans/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,UAAU,EACX,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,UAAU,EAAiB,MAAM,UAAU,CAAC;AA4CrD,8BAAsB,UAAU,CAAC,KAAK,SAAS,UAAU,GAAG,GAAG,CAAE,YAAW,MAAM,CAAC,KAAK,CAAC;IACvF,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,SAAS,CAAC,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B,CAAC;IACK,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,UAAU,CAAC;IAC/B,0EAA0E;IAC1E,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS;IAsBnE,mBAAmB;IACnB,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAEnD,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI;IAEtD,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI;IAExD,eAAe,CAAC,UAAU,SAAS,UAAU,EAAE,OAAO,EAAE,gBAAgB,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;IAIzG,eAAe,CAAC,UAAU,SAAS,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;IAI1G,6DAA6D;IAC7D,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,oEAAoE;IACpE,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC;IAEhC,gEAAgE;IACzD,eAAe,CAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAW1E,qFAAqF;IAC9E,UAAU,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS;IAa3E,kDAAkD;IAC3C,UAAU,CAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC;CAkBzE"}

package/dist/ai-tracing/spans/default.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/spans/default.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAa,MAAM,QAAQ,CAAC;AAE/C,qBAAa,aAAa,CAAC,KAAK,SAAS,UAAU,CAAE,SAAQ,UAAU,CAAC,KAAK,CAAC;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS;IAmCnE,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAiB1C,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI;IAoC7C,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI;IAoB/C,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAUhC"}
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/ai-tracing/spans/default.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,qBAAa,aAAa,CAAC,KAAK,SAAS,UAAU,CAAE,SAAQ,UAAU,CAAC,KAAK,CAAC;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS;IAmCnE,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAiB1C,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI;IAoC7C,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI;IAoB/C,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAUhC"}

package/dist/{chunk-V2IMZSNO.js → chunk-2BIQL3SK.js}

@@ -1,4 +1,4 @@
-import { InstrumentClass } from './chunk-DSUKMFZY.js';
+import { InstrumentClass } from './chunk-5S5X3QPR.js';
 import { MastraBase } from './chunk-VQASQG5D.js';
 import { __decoratorStart, __decorateElement, __runInitializers } from './chunk-3HXBPDKN.js';
 
@@ -35,5 +35,5 @@ MastraTTS = /*@__PURE__*/(_ => {
 })();
 
 export { MastraTTS };
-//# sourceMappingURL=chunk-V2IMZSNO.js.map
-//# sourceMappingURL=chunk-V2IMZSNO.js.map
+//# sourceMappingURL=chunk-2BIQL3SK.js.map
+//# sourceMappingURL=chunk-2BIQL3SK.js.map

package/dist/{chunk-V2IMZSNO.js.map → chunk-2BIQL3SK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/tts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,IAAA;AAaA,GAAA,EAAA;AAAiB,IACf,KAAA,CAAQ;AAAA,MACR,SAAA,EAAA;AACF,KAAC,CAAA;AACM,IAAe,IAAA,CAAA,KAAA;AAA6B,EACjD;AAAA,EACA,MAAA,CAAA,MAAY,EAAE,UAAoB,EAAA;AAChC,IAAA,OAAM,IAAA,CAAA,SAAA,EAAA,WAAA,CAAA,MAAA,EAAA;AAAA,MACJ,QAAA,EAAA,CAAW,EAAA,IAAA,CAAA,KAAA,CAAA,IAAA,CAAA,KAAA,EAAA,UAAA,CAAA,CAAA;AAAA,MACZ,UAAA,EAAA;AACD,QAAA,UAAa,EAAA,CAAA,EAAA,IAAA,CAAA,KAAA,CAAA,IAAA,CAAA;AAAA;AACf,KAEA,CAAA;AACE,EAAA;AACsC;AACY,SAC9C,gBAAY,CAAA,CAAA,IAAA;AAAA,EAAA,KAAA,GACV,gBAAe,CAAA,EAAK,CAAA;AAAU,EAAA,SAChC,GAAA,iBAAA,CAAA,KAAA,EAAA,CAAA,EAAA,WAAA,EAAA,qBAAA,EAAA,SAAA,CAAA;AAAA,EAAA,iBACI,CAAA,KAAA,EAAA,CAAA,EAAA,SAAA,CAAA;AAAA,EAEV,OAAA,SAAA;AAIF,CAAA,EAAA","file":"chunk-V2IMZSNO.js","sourcesContent":["import { MastraBase } from '../base';\nimport { InstrumentClass } from '../telemetry';\n\ninterface BuiltInModelConfig {\n  provider: string;\n  name: string;\n  apiKey?: string;\n}\n\nexport interface TTSConfig {\n  model: BuiltInModelConfig;\n}\n\n@InstrumentClass({\n  prefix: 'tts',\n  excludeMethods: ['__setTools', '__setLogger', '__setTelemetry', '#log'],\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  traced<T extends Function>(method: T, methodName: string): T {\n    return (\n      this.telemetry?.traceMethod(method, {\n        spanName: `${this.model.name}-tts.${methodName}`,\n        attributes: {\n          'tts.type': `${this.model.name}`,\n        },\n      }) ?? method\n    );\n  }\n\n  abstract generate({ text }: { text: string }): Promise<any>;\n  abstract stream({ text }: { text: string }): Promise<any>;\n}\n"]}
+{"version":3,"sources":["../src/tts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,IAAA;AAaA,GAAA,EAAA;AAAiB,IACf,KAAA,CAAQ;AAAA,MACR,SAAA,EAAA;AACF,KAAC,CAAA;AACM,IAAe,IAAA,CAAA,KAAA;AAA6B,EACjD;AAAA,EACA,MAAA,CAAA,MAAY,EAAE,UAAoB,EAAA;AAChC,IAAA,OAAM,IAAA,CAAA,SAAA,EAAA,WAAA,CAAA,MAAA,EAAA;AAAA,MACJ,QAAA,EAAA,CAAW,EAAA,IAAA,CAAA,KAAA,CAAA,IAAA,CAAA,KAAA,EAAA,UAAA,CAAA,CAAA;AAAA,MACZ,UAAA,EAAA;AACD,QAAA,UAAa,EAAA,CAAA,EAAA,IAAA,CAAA,KAAA,CAAA,IAAA,CAAA;AAAA;AACf,KAEA,CAAA;AACE,EAAA;AACsC;AACY,SAC9C,gBAAY,CAAA,CAAA,IAAA;AAAA,EAAA,KAAA,GACV,gBAAe,CAAA,EAAK,CAAA;AAAU,EAAA,SAChC,GAAA,iBAAA,CAAA,KAAA,EAAA,CAAA,EAAA,WAAA,EAAA,qBAAA,EAAA,SAAA,CAAA;AAAA,EAAA,iBACI,CAAA,KAAA,EAAA,CAAA,EAAA,SAAA,CAAA;AAAA,EAEV,OAAA,SAAA;AAIF,CAAA,EAAA","file":"chunk-2BIQL3SK.js","sourcesContent":["import { MastraBase } from '../base';\nimport { InstrumentClass } from '../telemetry';\n\ninterface BuiltInModelConfig {\n  provider: string;\n  name: string;\n  apiKey?: string;\n}\n\nexport interface TTSConfig {\n  model: BuiltInModelConfig;\n}\n\n@InstrumentClass({\n  prefix: 'tts',\n  excludeMethods: ['__setTools', '__setLogger', '__setTelemetry', '#log'],\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  traced<T extends Function>(method: T, methodName: string): T {\n    return (\n      this.telemetry?.traceMethod(method, {\n        spanName: `${this.model.name}-tts.${methodName}`,\n        attributes: {\n          'tts.type': `${this.model.name}`,\n        },\n      }) ?? method\n    );\n  }\n\n  abstract generate({ text }: { text: string }): Promise<any>;\n  abstract stream({ text }: { text: string }): Promise<any>;\n}\n"]}

package/dist/chunk-3L3ISSMS.cjs

@@ -0,0 +1,130 @@
+'use strict';
+
+// src/ai-tracing/serialization.ts
+var DEFAULT_SERIALIZATION_LIMITS = Object.freeze({
+  maxAttrChars: 1024,
+  maxDepth: 6,
+  maxKeys: 50,
+  maxArrayItems: 50,
+  maxTotalChars: 8192
+});
+function truncateString(s, maxChars) {
+  if (s.length <= maxChars) return s;
+  return s.slice(0, maxChars) + "\u2026[truncated]";
+}
+var DEFAULT_KEYS_TO_STRIP = /* @__PURE__ */ new Set([
+  "logger",
+  "experimental_providerMetadata",
+  "providerMetadata",
+  "steps",
+  "tracingContext"
+]);
+var NO_KEYS_TO_STRIP = /* @__PURE__ */ new Set();
+function deepClean(value, options = {}) {
+  const {
+    keysToStrip = DEFAULT_KEYS_TO_STRIP,
+    maxDepth = DEFAULT_SERIALIZATION_LIMITS.maxDepth,
+    maxStringLength = DEFAULT_SERIALIZATION_LIMITS.maxAttrChars,
+    maxArrayLength = DEFAULT_SERIALIZATION_LIMITS.maxArrayItems,
+    maxObjectKeys = DEFAULT_SERIALIZATION_LIMITS.maxKeys
+  } = options;
+  const seen = /* @__PURE__ */ new WeakSet();
+  function helper(val, depth) {
+    if (depth > maxDepth) {
+      return "[MaxDepth]";
+    }
+    if (val === null || val === void 0) {
+      return val;
+    }
+    if (typeof val === "string") {
+      return truncateString(val, maxStringLength);
+    }
+    if (typeof val === "number" || typeof val === "boolean") {
+      return val;
+    }
+    if (typeof val === "bigint") {
+      return `${val}n`;
+    }
+    if (typeof val === "function") {
+      return "[Function]";
+    }
+    if (typeof val === "symbol") {
+      return val.description ? `[Symbol(${val.description})]` : "[Symbol]";
+    }
+    if (val instanceof Date) {
+      return val;
+    }
+    if (val instanceof Error) {
+      return {
+        name: val.name,
+        message: val.message ? truncateString(val.message, maxStringLength) : void 0
+      };
+    }
+    if (typeof val === "object") {
+      if (seen.has(val)) {
+        return "[Circular]";
+      }
+      seen.add(val);
+    }
+    if (Array.isArray(val)) {
+      const limitedArray = val.slice(0, maxArrayLength);
+      const cleaned2 = limitedArray.map((item) => helper(item, depth + 1));
+      if (val.length > maxArrayLength) {
+        cleaned2.push(`[\u2026${val.length - maxArrayLength} more items]`);
+      }
+      return cleaned2;
+    }
+    if (typeof Buffer !== "undefined" && Buffer.isBuffer(val)) {
+      return `[Buffer length=${val.length}]`;
+    }
+    if (ArrayBuffer.isView(val)) {
+      const ctor = val.constructor?.name ?? "TypedArray";
+      const byteLength = val.byteLength ?? "?";
+      return `[${ctor} byteLength=${byteLength}]`;
+    }
+    if (val instanceof ArrayBuffer) {
+      return `[ArrayBuffer byteLength=${val.byteLength}]`;
+    }
+    const cleaned = {};
+    const entries = Object.entries(val);
+    let keyCount = 0;
+    for (const [key, v] of entries) {
+      if (keysToStrip.has(key)) {
+        continue;
+      }
+      if (keyCount >= maxObjectKeys) {
+        cleaned["__truncated"] = `${entries.length - keyCount} more keys omitted`;
+        break;
+      }
+      try {
+        cleaned[key] = helper(v, depth + 1);
+        keyCount++;
+      } catch (error) {
+        cleaned[key] = `[${error instanceof Error ? error.message : String(error)}]`;
+        keyCount++;
+      }
+    }
+    return cleaned;
+  }
+  return helper(value, 0);
+}
+function boundedStringify(value) {
+  const cleaned = deepClean(value, { keysToStrip: NO_KEYS_TO_STRIP });
+  try {
+    const json = JSON.stringify(cleaned);
+    if (json.length > DEFAULT_SERIALIZATION_LIMITS.maxTotalChars) {
+      return json.slice(0, DEFAULT_SERIALIZATION_LIMITS.maxTotalChars) + "\u2026[truncated]";
+    }
+    return json;
+  } catch {
+    return "[Not Serializable]";
+  }
+}
+
+exports.DEFAULT_KEYS_TO_STRIP = DEFAULT_KEYS_TO_STRIP;
+exports.DEFAULT_SERIALIZATION_LIMITS = DEFAULT_SERIALIZATION_LIMITS;
+exports.boundedStringify = boundedStringify;
+exports.deepClean = deepClean;
+exports.truncateString = truncateString;
+//# sourceMappingURL=chunk-3L3ISSMS.cjs.map
+//# sourceMappingURL=chunk-3L3ISSMS.cjs.map

package/dist/chunk-3L3ISSMS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai-tracing/serialization.ts"],"names":["cleaned"],"mappings":"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","file":"chunk-3L3ISSMS.cjs","sourcesContent":["/**\n * Bounded serialization utilities for AI tracing.\n *\n * These utilities prevent memory issues by enforcing strict limits on\n * string lengths, array sizes, object depths, and total output size.\n * They are designed to be used across all tracing/telemetry systems.\n */\n\n/**\n * Configuration limits for serialization.\n * These defaults are intentionally conservative to prevent OOM issues.\n */\nexport interface SerializationLimits {\n  /** Maximum characters for any single attribute string (default: 1024) */\n  maxAttrChars: number;\n  /** Maximum depth for recursive serialization (default: 6) */\n  maxDepth: number;\n  /** Maximum object keys to serialize (default: 50) */\n  maxKeys: number;\n  /** Maximum array elements to serialize (default: 50) */\n  maxArrayItems: number;\n  /** Maximum total output characters (default: 8192) */\n  maxTotalChars: number;\n}\n\nexport const DEFAULT_SERIALIZATION_LIMITS: SerializationLimits = Object.freeze({\n  maxAttrChars: 1024,\n  maxDepth: 6,\n  maxKeys: 50,\n  maxArrayItems: 50,\n  maxTotalChars: 8192,\n});\n\n/**\n * Hard-cap any string to prevent unbounded growth.\n */\nexport function truncateString(s: string, maxChars: number): string {\n  if (s.length <= maxChars) return s;\n  return s.slice(0, maxChars) + '…[truncated]';\n}\n\n/**\n * Default keys to strip from objects during deep cleaning.\n * These are typically internal/sensitive fields that shouldn't be traced.\n */\nexport const DEFAULT_KEYS_TO_STRIP = new Set([\n  'logger',\n  'experimental_providerMetadata',\n  'providerMetadata',\n  'steps',\n  'tracingContext',\n]);\n\n/** Empty set for when you don't want to strip any keys */\nconst NO_KEYS_TO_STRIP = new Set<string>();\n\nexport interface DeepCleanOptions {\n  keysToStrip?: Set<string>;\n  maxDepth?: number;\n  maxStringLength?: number;\n  maxArrayLength?: number;\n  maxObjectKeys?: number;\n}\n\n/**\n * Recursively cleans a value by removing circular references, stripping problematic keys,\n * and enforcing size limits on strings, arrays, and objects.\n *\n * This is used by AI tracing spans to sanitize input/output data before storing.\n *\n * @param value - The value to clean (object, array, primitive, etc.)\n * @param options - Optional configuration for cleaning behavior\n * @returns A cleaned version of the input with size limits enforced\n */\nexport function deepClean(value: any, options: DeepCleanOptions = {}): any {\n  const {\n    keysToStrip = DEFAULT_KEYS_TO_STRIP,\n    maxDepth = DEFAULT_SERIALIZATION_LIMITS.maxDepth,\n    maxStringLength = DEFAULT_SERIALIZATION_LIMITS.maxAttrChars,\n    maxArrayLength = DEFAULT_SERIALIZATION_LIMITS.maxArrayItems,\n    maxObjectKeys = DEFAULT_SERIALIZATION_LIMITS.maxKeys,\n  } = options;\n\n  const seen = new WeakSet<any>();\n\n  function helper(val: any, depth: number): any {\n    if (depth > maxDepth) {\n      return '[MaxDepth]';\n    }\n\n    // Handle primitives\n    if (val === null || val === undefined) {\n      return val;\n    }\n\n    // Handle strings - enforce length limit\n    if (typeof val === 'string') {\n      return truncateString(val, maxStringLength);\n    }\n\n    // Handle other non-object primitives explicitly\n    if (typeof val === 'number' || typeof val === 'boolean') {\n      return val;\n    }\n    if (typeof val === 'bigint') {\n      return `${val}n`;\n    }\n    if (typeof val === 'function') {\n      return '[Function]';\n    }\n    if (typeof val === 'symbol') {\n      return val.description ? `[Symbol(${val.description})]` : '[Symbol]';\n    }\n\n    // Handle Date objects - preserve as-is\n    if (val instanceof Date) {\n      return val;\n    }\n\n    // Handle Errors specially - preserve name and message\n    if (val instanceof Error) {\n      return {\n        name: val.name,\n        message: val.message ? truncateString(val.message, maxStringLength) : undefined,\n      };\n    }\n\n    // Handle circular references\n    if (typeof val === 'object') {\n      if (seen.has(val)) {\n        return '[Circular]';\n      }\n      seen.add(val);\n    }\n\n    // Handle arrays - enforce length limit\n    if (Array.isArray(val)) {\n      const limitedArray = val.slice(0, maxArrayLength);\n      const cleaned = limitedArray.map(item => helper(item, depth + 1));\n      if (val.length > maxArrayLength) {\n        cleaned.push(`[…${val.length - maxArrayLength} more items]`);\n      }\n      return cleaned;\n    }\n\n    // Handle Buffer and typed arrays - don't serialize large binary data\n    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(val)) {\n      return `[Buffer length=${val.length}]`;\n    }\n\n    if (ArrayBuffer.isView(val)) {\n      const ctor = (val as any).constructor?.name ?? 'TypedArray';\n      const byteLength = (val as any).byteLength ?? '?';\n      return `[${ctor} byteLength=${byteLength}]`;\n    }\n\n    if (val instanceof ArrayBuffer) {\n      return `[ArrayBuffer byteLength=${val.byteLength}]`;\n    }\n\n    // Handle objects - enforce key limit\n    const cleaned: Record<string, any> = {};\n    const entries = Object.entries(val);\n    let keyCount = 0;\n\n    for (const [key, v] of entries) {\n      if (keysToStrip.has(key)) {\n        continue;\n      }\n\n      if (keyCount >= maxObjectKeys) {\n        cleaned['__truncated'] = `${entries.length - keyCount} more keys omitted`;\n        break;\n      }\n\n      try {\n        cleaned[key] = helper(v, depth + 1);\n        keyCount++;\n      } catch (error) {\n        cleaned[key] = `[${error instanceof Error ? error.message : String(error)}]`;\n        keyCount++;\n      }\n    }\n\n    return cleaned;\n  }\n\n  return helper(value, 0);\n}\n\n/**\n * Bounded safe stringify for when you need JSON output.\n * Uses deepClean internally, then JSON.stringify with total length limit.\n *\n * @param value - The value to stringify\n * @returns A JSON string representation with enforced limits\n */\nexport function boundedStringify(value: unknown): string {\n  const cleaned = deepClean(value, { keysToStrip: NO_KEYS_TO_STRIP });\n\n  try {\n    const json = JSON.stringify(cleaned);\n    if (json.length > DEFAULT_SERIALIZATION_LIMITS.maxTotalChars) {\n      return json.slice(0, DEFAULT_SERIALIZATION_LIMITS.maxTotalChars) + '…[truncated]';\n    }\n    return json;\n  } catch {\n    return '[Not Serializable]';\n  }\n}\n"]}