@mastra/observability 1.21.0-alpha.2 → 1.21.0

package/dist/index.cjs

@@ -16,7 +16,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
@@ -77,9 +77,7 @@ function routeToHandler(handler, event, logger) {
 					}), handler.name, "score", logger);
 				}
 				break;
-			case "feedback":
-				if (handler.onFeedbackEvent) return catchAsyncResult(handler.onFeedbackEvent(event), handler.name, "feedback", logger);
-				break;
+			case "feedback": if (handler.onFeedbackEvent) return catchAsyncResult(handler.onFeedbackEvent(event), handler.name, "feedback", logger);
 		}
 	} catch (err) {
 		logger.error(`[Observability] Handler error [handler=${handler.name}]:`, err);
@@ -228,7 +226,7 @@ const VALUE_STRIP_KEYS = /* @__PURE__ */ new Set([
 const DEFAULT_DEEP_CLEAN_OPTIONS = Object.freeze({
 	keysToStrip: [],
 	maxDepth: 8,
-	maxStringLength: 128 * 1024,
+	maxStringLength: 131072,
 	maxArrayLength: 50,
 	maxObjectKeys: 50
 });
@@ -1302,8 +1300,8 @@ function isRecord(value) {
 //#endregion
 //#region src/metrics/pricing-registry.ts
 const DATA_FILE_NAME = "pricing-data.json";
-const REFRESH_INTERVAL_MS = 1440 * 60 * 1e3;
-const MIN_REFRESH_ATTEMPT_INTERVAL_MS = 3600 * 1e3;
+const REFRESH_INTERVAL_MS = 864e5;
+const MIN_REFRESH_ATTEMPT_INTERVAL_MS = 36e5;
 const REFRESH_TIMEOUT_MS = 5e3;
 const CACHE_FILE = () => path.default.join(os.default.homedir(), ".cache", "mastra", "pricing-data.json");
 const CACHE_VERSION = 1;
@@ -2962,9 +2960,7 @@ var ModelSpanTracker = class {
 				if (this.#currentChunkType !== "text") this.#startChunkSpan("text");
 				this.#appendToAccumulator("text", chunk.payload.text);
 				break;
-			case "text-end":
-				this.#endChunkSpan();
-				break;
+			case "text-end": this.#endChunkSpan();
 		}
 	}
 	/**
@@ -2979,9 +2975,7 @@ var ModelSpanTracker = class {
 				if (this.#currentChunkType !== "reasoning") this.#startChunkSpan("reasoning");
 				this.#appendToAccumulator("text", chunk.payload.text);
 				break;
-			case "reasoning-end":
-				this.#endChunkSpan();
-				break;
+			case "reasoning-end": this.#endChunkSpan();
 		}
 	}
 	/**
@@ -3024,9 +3018,7 @@ var ModelSpanTracker = class {
 			case "object":
 				if (this.#currentChunkType !== "object") this.#startChunkSpan("object");
 				break;
-			case "object-result":
-				this.#endChunkSpan(chunk.object);
-				break;
+			case "object-result": this.#endChunkSpan(chunk.object);
 		}
 	}
 	/**
@@ -3129,7 +3121,6 @@ var ModelSpanTracker = class {
 					this.#createEventSpan(chunk.type, spanOutput, { metadata });
 					break;
 				}
-				default: break;
 			}
 		} }));
 	}
@@ -3670,10 +3661,14 @@ var DefaultSpan = class extends BaseSpan {
 		}
 		this.traceId = getOrCreateTraceId(options);
 		this.id = generateSpanId();
-		if (options.parentSpanId) if (isValidSpanId(options.parentSpanId)) this.parentSpanId = options.parentSpanId;
-		else console.error(`[Mastra Tracing] Invalid parentSpanId: must be 1-16 hexadecimal characters, got "${options.parentSpanId}". Ignoring.`);
-		if (options.externalParentSpanId) if (isValidSpanId(options.externalParentSpanId)) this.externalParentSpanId = options.externalParentSpanId;
-		else console.error(`[Mastra Tracing] Invalid externalParentSpanId: must be 1-16 hexadecimal characters, got "${options.externalParentSpanId}". Ignoring.`);
+		if (options.parentSpanId) {
+			if (isValidSpanId(options.parentSpanId)) this.parentSpanId = options.parentSpanId;
+			else console.error(`[Mastra Tracing] Invalid parentSpanId: must be 1-16 hexadecimal characters, got "${options.parentSpanId}". Ignoring.`);
+		}
+		if (options.externalParentSpanId) {
+			if (isValidSpanId(options.externalParentSpanId)) this.externalParentSpanId = options.externalParentSpanId;
+			else console.error(`[Mastra Tracing] Invalid externalParentSpanId: must be 1-16 hexadecimal characters, got "${options.externalParentSpanId}". Ignoring.`);
+		}
 	}
 	end(options) {
 		if (this.isEvent) return;
@@ -3795,8 +3790,10 @@ function isValidSpanId(spanId) {
 	return /^[0-9a-f]{1,16}$/i.test(spanId);
 }
 function getOrCreateTraceId(options) {
-	if (options.traceId) if (isValidTraceId(options.traceId)) return options.traceId;
-	else console.error(`[Mastra Tracing] Invalid traceId: must be 1-32 hexadecimal characters, got "${options.traceId}". Generating new trace ID.`);
+	if (options.traceId) {
+		if (isValidTraceId(options.traceId)) return options.traceId;
+		else console.error(`[Mastra Tracing] Invalid traceId: must be 1-32 hexadecimal characters, got "${options.traceId}". Generating new trace ID.`);
+	}
 	return generateTraceId();
 }
 //#endregion
@@ -4045,17 +4042,13 @@ var EventBuffer = class {
 				switch (this.#storageStrategy) {
 					case "realtime":
 					case "event-sourced":
-					case "batch-with-updates":
-						this.pushCreate(event);
-						break;
+					case "batch-with-updates": this.pushCreate(event);
 				}
 				break;
 			case _mastra_core_observability.TracingEventType.SPAN_UPDATED:
 				switch (this.#storageStrategy) {
 					case "realtime":
-					case "batch-with-updates":
-						this.pushUpdate(event);
-						break;
+					case "batch-with-updates": this.pushUpdate(event);
 				}
 				break;
 			case _mastra_core_observability.TracingEventType.SPAN_ENDED:
@@ -4065,14 +4058,10 @@ var EventBuffer = class {
 					case "batch-with-updates":
 						this.pushUpdate(event);
 						break;
-					default:
-						this.pushCreate(event);
-						break;
+					default: this.pushCreate(event);
 				}
 				break;
-			default:
-				this.pushCreate(event);
-				break;
+			default: this.pushCreate(event);
 		}
 	}
 	/** Re-add failed create events to the buffer, returning events that exceed max retries. */
@@ -4447,17 +4436,13 @@ var DefaultExporter = class extends BaseExporter {
 			case "score":
 				createScoreEvents.push(createEvent);
 				break;
-			default:
-				createSpanEvents.push(createEvent);
-				break;
+			default: createSpanEvents.push(createEvent);
 		}
 		for (const updateEvent of updates) switch (updateEvent.type) {
 			case _mastra_core_observability.TracingEventType.SPAN_UPDATED:
 				updateSpanEvents.push(updateEvent);
 				break;
-			case _mastra_core_observability.TracingEventType.SPAN_ENDED:
-				endSpanEvents.push(updateEvent);
-				break;
+			case _mastra_core_observability.TracingEventType.SPAN_ENDED: endSpanEvents.push(updateEvent);
 		}
 		const flushResults = await Promise.all([
 			this.flushCreates("feedback", createFeedbackEvents, (events) => this.#observabilityStorage.batchCreateFeedback({ feedbacks: events.map((f) => (0, _mastra_core_storage.buildFeedbackRecord)(f)) })),
@@ -4474,13 +4459,15 @@ var DefaultExporter = class extends BaseExporter {
 		flushResults.push(await this.flushSpanUpdates(updateSpanEvents, deferredUpdates, false));
 		flushResults.push(await this.flushSpanUpdates(endSpanEvents, deferredUpdates, true));
 		let deferredDropCount = 0;
-		if (deferredUpdates.length > 0) if (this.#unsupportedSignals.has("tracing")) {
-			deferredDropCount = deferredUpdates.length;
-			this.emitDrop("tracing", "unsupported-storage", deferredDropCount);
-			deferredUpdates.length = 0;
-		} else {
-			deferredDropCount = this.#eventBuffer.reAddUpdates(deferredUpdates).length;
-			this.emitDrop("tracing", "retry-exhausted", deferredDropCount);
+		if (deferredUpdates.length > 0) {
+			if (this.#unsupportedSignals.has("tracing")) {
+				deferredDropCount = deferredUpdates.length;
+				this.emitDrop("tracing", "unsupported-storage", deferredDropCount);
+				deferredUpdates.length = 0;
+			} else {
+				deferredDropCount = this.#eventBuffer.reAddUpdates(deferredUpdates).length;
+				this.emitDrop("tracing", "retry-exhausted", deferredDropCount);
+			}
 		}
 		const retryAttempt = flushResults.reduce((earliestAttempt, result) => {
 			if (result.retryAttempt === void 0) return earliestAttempt;
@@ -4898,17 +4885,13 @@ var MastraStorageExporter = class extends BaseExporter {
 			case "score":
 				createScoreEvents.push(createEvent);
 				break;
-			default:
-				createSpanEvents.push(createEvent);
-				break;
+			default: createSpanEvents.push(createEvent);
 		}
 		for (const updateEvent of updates) switch (updateEvent.type) {
 			case _mastra_core_observability.TracingEventType.SPAN_UPDATED:
 				updateSpanEvents.push(updateEvent);
 				break;
-			case _mastra_core_observability.TracingEventType.SPAN_ENDED:
-				endSpanEvents.push(updateEvent);
-				break;
+			case _mastra_core_observability.TracingEventType.SPAN_ENDED: endSpanEvents.push(updateEvent);
 		}
 		const flushResults = await Promise.all([
 			this.flushCreates("feedback", createFeedbackEvents, (events) => this.#observabilityStorage.batchCreateFeedback({ feedbacks: events.map((f) => (0, _mastra_core_storage.buildFeedbackRecord)(f)) })),
@@ -4925,13 +4908,15 @@ var MastraStorageExporter = class extends BaseExporter {
 		flushResults.push(await this.flushSpanUpdates(updateSpanEvents, deferredUpdates, false));
 		flushResults.push(await this.flushSpanUpdates(endSpanEvents, deferredUpdates, true));
 		let deferredDropCount = 0;
-		if (deferredUpdates.length > 0) if (this.#unsupportedSignals.has("tracing")) {
-			deferredDropCount = deferredUpdates.length;
-			this.emitDrop("tracing", "unsupported-storage", deferredDropCount);
-			deferredUpdates.length = 0;
-		} else {
-			deferredDropCount = this.#eventBuffer.reAddUpdates(deferredUpdates).length;
-			this.emitDrop("tracing", "retry-exhausted", deferredDropCount);
+		if (deferredUpdates.length > 0) {
+			if (this.#unsupportedSignals.has("tracing")) {
+				deferredDropCount = deferredUpdates.length;
+				this.emitDrop("tracing", "unsupported-storage", deferredDropCount);
+				deferredUpdates.length = 0;
+			} else {
+				deferredDropCount = this.#eventBuffer.reAddUpdates(deferredUpdates).length;
+				this.emitDrop("tracing", "retry-exhausted", deferredDropCount);
+			}
 		}
 		const retryAttempt = flushResults.reduce((earliestAttempt, result) => {
 			if (result.retryAttempt === void 0) return earliestAttempt;
@@ -5451,10 +5436,13 @@ var BaseObservabilityInstance = class extends _mastra_core_base.MastraBase {
 			const parts = key.split(".");
 			const rootKey = parts[0];
 			const value = requestContext.get(rootKey);
-			if (value !== void 0) if (parts.length > 1) {
-				const nestedValue = (0, _mastra_core_utils.getNestedValue)(value, parts.slice(1).join("."));
-				if (nestedValue !== void 0) (0, _mastra_core_utils.setNestedValue)(result, key, nestedValue);
-			} else (0, _mastra_core_utils.setNestedValue)(result, key, value);
+			if (value !== void 0) {
+				if (parts.length > 1) {
+					const nestedPath = parts.slice(1).join(".");
+					const nestedValue = (0, _mastra_core_utils.getNestedValue)(value, nestedPath);
+					if (nestedValue !== void 0) (0, _mastra_core_utils.setNestedValue)(result, key, nestedValue);
+				} else (0, _mastra_core_utils.setNestedValue)(result, key, value);
+			}
 		}
 		return result;
 	}
@@ -6002,7 +5990,7 @@ function formatBaggage(entries) {
 const DEFAULT_LIMITS = {
 	maxSpans: 10,
 	maxLogs: 10,
-	maxPayloadBytes: 1024 * 1024
+	maxPayloadBytes: 1048576
 };
 var ClientObservabilityProxyImpl = class {
 	#resolveInstance;
@@ -6937,36 +6925,38 @@ var TrackingExporter = class extends BaseExporter {
 			method
 		});
 		const { exportedSpan } = await this._preExportTracingEvent(event);
-		if (!this.skipBuildRootTask && !traceData.hasRoot()) if (exportedSpan.isRootSpan) {
-			this.logger.debug(`${this.name}: Building root`, {
-				traceId: exportedSpan.traceId,
-				spanId: exportedSpan.id
-			});
-			const rootData = await this._buildRoot({
-				span: exportedSpan,
-				traceData
-			});
-			if (rootData) {
-				this.logger.debug(`${this.name}: Adding root`, {
+		if (!this.skipBuildRootTask && !traceData.hasRoot()) {
+			if (exportedSpan.isRootSpan) {
+				this.logger.debug(`${this.name}: Building root`, {
 					traceId: exportedSpan.traceId,
 					spanId: exportedSpan.id
 				});
-				traceData.addRoot({
-					rootId: exportedSpan.id,
-					rootData
+				const rootData = await this._buildRoot({
+					span: exportedSpan,
+					traceData
 				});
-				this.#scheduleProcessWaitingForRoot(traceId);
+				if (rootData) {
+					this.logger.debug(`${this.name}: Adding root`, {
+						traceId: exportedSpan.traceId,
+						spanId: exportedSpan.id
+					});
+					traceData.addRoot({
+						rootId: exportedSpan.id,
+						rootData
+					});
+					this.#scheduleProcessWaitingForRoot(traceId);
+				}
+			} else {
+				this.logger.debug(`${this.name}: Root does not exist, adding span to waiting queue.`, {
+					traceId: exportedSpan.traceId,
+					spanId: exportedSpan.id
+				});
+				traceData.addToWaitingQueue({
+					event,
+					waitingFor: "root"
+				});
+				return;
 			}
-		} else {
-			this.logger.debug(`${this.name}: Root does not exist, adding span to waiting queue.`, {
-				traceId: exportedSpan.traceId,
-				spanId: exportedSpan.id
-			});
-			traceData.addToWaitingQueue({
-				event,
-				waitingFor: "root"
-			});
-			return;
 		}
 		if (exportedSpan.metadata && this.name in exportedSpan.metadata) {
 			const metadata = exportedSpan.metadata[this.name];
@@ -7093,7 +7083,6 @@ var TrackingExporter = class extends BaseExporter {
 						traceData
 					});
 					if (traceData.activeSpanCount() === 0) this.#scheduleCleanup(traceId);
-					break;
 			}
 		} catch (error) {
 			this.logger.error(`${this.name}: exporter error`, {
@@ -7259,7 +7248,7 @@ function chainFormatters(formatters) {
 //#region src/exporters/auth-failure-cooldown.ts
 const AUTH_FAILURE_STATUSES = /* @__PURE__ */ new Set([401, 403]);
 const AUTH_COOLDOWN_BASE_MS = 6e4;
-const AUTH_COOLDOWN_MAX_MS = 15 * 6e4;
+const AUTH_COOLDOWN_MAX_MS = 9e5;
 const AUTH_COOLDOWN_JITTER_RATIO = .1;
 var AuthFailureError = class extends Error {
 	status;
@@ -7688,8 +7677,9 @@ var CloudExporter = class extends BaseExporter {
 				succeeded: false,
 				authFailureStatus: error.status
 			};
+			const errorId = `CLOUD_EXPORTER_FAILED_TO_BATCH_UPLOAD_${signal.toUpperCase()}`;
 			const mastraError = new _mastra_core_error.MastraError({
-				id: `CLOUD_EXPORTER_FAILED_TO_BATCH_UPLOAD_${signal.toUpperCase()}`,
+				id: errorId,
 				domain: _mastra_core_error.ErrorDomain.MASTRA_OBSERVABILITY,
 				category: _mastra_core_error.ErrorCategory.USER,
 				details: {
@@ -8278,8 +8268,9 @@ var MastraPlatformExporter = class extends BaseExporter {
 				succeeded: false,
 				authFailureStatus: error.status
 			};
+			const errorId = `MASTRA_PLATFORM_EXPORTER_FAILED_TO_BATCH_UPLOAD_${signal.toUpperCase()}`;
 			const mastraError = new _mastra_core_error.MastraError({
-				id: `MASTRA_PLATFORM_EXPORTER_FAILED_TO_BATCH_UPLOAD_${signal.toUpperCase()}`,
+				id: errorId,
 				domain: _mastra_core_error.ErrorDomain.MASTRA_OBSERVABILITY,
 				category: _mastra_core_error.ErrorCategory.USER,
 				details: {
@@ -9143,16 +9134,18 @@ var TestExporter = class extends BaseExporter {
 		for (let i = 0; i < maxLen; i++) {
 			const actualLine = actual[i];
 			const expectedLine = expected[i];
-			if (actualLine !== expectedLine) if (actualLine === void 0) {
-				diffs.push(`Line ${i + 1}: Missing in actual`);
-				diffs.push(`  Expected: ${expectedLine}`);
-			} else if (expectedLine === void 0) {
-				diffs.push(`Line ${i + 1}: Extra in actual`);
-				diffs.push(`  Actual: ${actualLine}`);
-			} else {
-				diffs.push(`Line ${i + 1}:`);
-				diffs.push(`  Expected: ${expectedLine}`);
-				diffs.push(`  Actual:   ${actualLine}`);
+			if (actualLine !== expectedLine) {
+				if (actualLine === void 0) {
+					diffs.push(`Line ${i + 1}: Missing in actual`);
+					diffs.push(`  Expected: ${expectedLine}`);
+				} else if (expectedLine === void 0) {
+					diffs.push(`Line ${i + 1}: Extra in actual`);
+					diffs.push(`  Actual: ${actualLine}`);
+				} else {
+					diffs.push(`Line ${i + 1}:`);
+					diffs.push(`  Expected: ${expectedLine}`);
+					diffs.push(`  Actual:   ${actualLine}`);
+				}
 			}
 		}
 		return diffs;
@@ -9161,15 +9154,15 @@ var TestExporter = class extends BaseExporter {
 	* Deep compare two values, supporting special markers like __or__ and __any__.
 	* Collects all mismatches into the provided array.
 	*/
-	#deepCompareWithMarkers(actual, expected, path$2, mismatches) {
+	#deepCompareWithMarkers(actual, expected, path, mismatches) {
 		if (this.#isOrMarker(expected)) {
 			const allowedValues = expected.__or__;
 			if (!allowedValues.some((allowed) => {
 				const tempMismatches = [];
-				this.#deepCompareWithMarkers(actual, allowed, path$2, tempMismatches);
+				this.#deepCompareWithMarkers(actual, allowed, path, tempMismatches);
 				return tempMismatches.length === 0;
 			})) mismatches.push({
-				path: path$2,
+				path,
 				expected: { __or__: allowedValues },
 				actual
 			});
@@ -9179,7 +9172,7 @@ var TestExporter = class extends BaseExporter {
 			const typeConstraint = expected.__any__;
 			if (actual === null || actual === void 0) {
 				mismatches.push({
-					path: path$2,
+					path,
 					expected: { __any__: typeConstraint },
 					actual
 				});
@@ -9188,7 +9181,7 @@ var TestExporter = class extends BaseExporter {
 			if (typeConstraint === true) return;
 			const actualType = Array.isArray(actual) ? "array" : typeof actual;
 			if (actualType !== typeConstraint) mismatches.push({
-				path: path$2,
+				path,
 				expected: { __any__: typeConstraint },
 				actual: `(${actualType}) ${JSON.stringify(actual).slice(0, 50)}...`
 			});
@@ -9197,7 +9190,7 @@ var TestExporter = class extends BaseExporter {
 		if (Array.isArray(expected)) {
 			if (!Array.isArray(actual)) {
 				mismatches.push({
-					path: path$2,
+					path,
 					expected,
 					actual
 				});
@@ -9205,19 +9198,19 @@ var TestExporter = class extends BaseExporter {
 			}
 			if (actual.length !== expected.length) {
 				mismatches.push({
-					path: `${path$2}.length`,
+					path: `${path}.length`,
 					expected: expected.length,
 					actual: actual.length
 				});
 				return;
 			}
-			for (let i = 0; i < expected.length; i++) this.#deepCompareWithMarkers(actual[i], expected[i], `${path$2}[${i}]`, mismatches);
+			for (let i = 0; i < expected.length; i++) this.#deepCompareWithMarkers(actual[i], expected[i], `${path}[${i}]`, mismatches);
 			return;
 		}
 		if (expected !== null && typeof expected === "object") {
 			if (actual === null || typeof actual !== "object" || Array.isArray(actual)) {
 				mismatches.push({
-					path: path$2,
+					path,
 					expected,
 					actual
 				});
@@ -9229,19 +9222,19 @@ var TestExporter = class extends BaseExporter {
 				if (this.#isMetadataKey(key)) continue;
 				if (!(key in actualObj)) {
 					if (expectedObj[key] !== void 0) mismatches.push({
-						path: `${path$2}.${key}`,
+						path: `${path}.${key}`,
 						expected: expectedObj[key],
 						actual: void 0
 					});
 					continue;
 				}
-				this.#deepCompareWithMarkers(actualObj[key], expectedObj[key], `${path$2}.${key}`, mismatches);
+				this.#deepCompareWithMarkers(actualObj[key], expectedObj[key], `${path}.${key}`, mismatches);
 			}
 			for (const key of Object.keys(actualObj)) {
 				if (this.#isMetadataKey(key)) continue;
 				if (!(key in expectedObj)) {
 					if (actualObj[key] !== void 0) mismatches.push({
-						path: `${path$2}.${key}`,
+						path: `${path}.${key}`,
 						expected: void 0,
 						actual: actualObj[key]
 					});
@@ -9250,7 +9243,7 @@ var TestExporter = class extends BaseExporter {
 			return;
 		}
 		if (actual !== expected) mismatches.push({
-			path: path$2,
+			path,
 			expected,
 			actual
 		});
@@ -9915,9 +9908,10 @@ var SensitiveDataFilter = class {
 		const filtered = {};
 		for (const key of Object.keys(obj)) {
 			const normKey = this.normalizeKey(key);
-			if (this.isSensitive(normKey)) if (obj[key] && typeof obj[key] === "object") filtered[key] = this.deepFilter(obj[key], seen, indexedState);
-			else filtered[key] = this.redactValue(obj[key], normKey, indexedState);
-			else filtered[key] = this.deepFilter(obj[key], seen, indexedState);
+			if (this.isSensitive(normKey)) {
+				if (obj[key] && typeof obj[key] === "object") filtered[key] = this.deepFilter(obj[key], seen, indexedState);
+				else filtered[key] = this.redactValue(obj[key], normKey, indexedState);
+			} else filtered[key] = this.deepFilter(obj[key], seen, indexedState);
 		}
 		return filtered;
 	}