@mastra/observability 1.21.1-alpha.1 → 1.22.0-alpha.3

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -20,11 +20,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
 let _mastra_core_base = require("@mastra/core/base");
 let _mastra_core_error = require("@mastra/core/error");
 let _mastra_core_logger = require("@mastra/core/logger");
 let _mastra_core_observability = require("@mastra/core/observability");
+_mastra_core_observability = __toESM(_mastra_core_observability, 1);
 let _mastra_core_utils = require("@mastra/core/utils");
 let zod_v4 = require("zod/v4");
 let fs = require("fs");
@@ -38,7 +38,7 @@ let stream_web = require("stream/web");
 let _mastra_core_features = require("@mastra/core/features");
 let _mastra_core_storage = require("@mastra/core/storage");
 let crypto$1 = require("crypto");
-//#region src/bus/route-event.ts
+// src/bus/route-event.ts
 /**
 * Route a single event to the appropriate method on a handler.
 *
@@ -105,8 +105,7 @@ function catchAsyncResult(result, handlerName, signal, logger) {
 		logger.error(`[Observability] ${signal} handler error [handler=${handlerName}]:`, err);
 	});
 }
-//#endregion
-//#region src/bus/base.ts
+// src/bus/base.ts
 /**
 * BaseObservabilityEventBus - Generic event bus for observability events.
 *
@@ -181,8 +180,7 @@ var BaseObservabilityEventBus = class BaseObservabilityEventBus extends _mastra_
 		this.subscribers.clear();
 	}
 };
-//#endregion
-//#region src/spans/serialization.ts
+// src/spans/serialization.ts
 /**
 * Bounded serialization utilities for AI tracing.
 *
@@ -548,8 +546,7 @@ function deepClean(value, options = DEFAULT_DEEP_CLEAN_OPTIONS) {
 	}
 	return helper(value, 0);
 }
-//#endregion
-//#region src/bus/observability-bus.ts
+// src/bus/observability-bus.ts
 /**
 * Apply deepClean() to non-tracing observability events. Tracing events are
 * already deep-cleaned at span construction time (see spans/base.ts and
@@ -758,8 +755,7 @@ var ObservabilityBus = class extends BaseObservabilityEventBus {
 		await super.shutdown();
 	}
 };
-//#endregion
-//#region src/config.ts
+// src/config.ts
 /**
 * Sampling strategy types
 */
@@ -886,8 +882,7 @@ const observabilityRegistryConfigSchema = zod_v4.z.object({
 	}
 	return true;
 }, { message: "A \"configSelector\" requires at least one config or default observability to be configured." });
-//#endregion
-//#region src/ids.ts
+// src/ids.ts
 /**
 * Signal and span id helpers.
 *
@@ -955,8 +950,7 @@ function resolveExportedSpanId(span) {
 	if (!span) return void 0;
 	return typeof span.getExportedSpanId === "function" ? span.getExportedSpanId() : span.id;
 }
-//#endregion
-//#region src/context/logger.ts
+// src/context/logger.ts
 /** Numeric priority used to compare log levels against the configured minimum. */
 const LOG_LEVEL_PRIORITY = {
 	debug: 0,
@@ -1024,8 +1018,7 @@ var LoggerContextImpl = class {
 		this.config.observabilityBus.emit(event);
 	}
 };
-//#endregion
-//#region src/context/metrics.ts
+// src/context/metrics.ts
 /**
 * User-facing metric emission API. All metrics are routed through
 * ObservabilityBus.emit() after validation and cardinality filtering.
@@ -1100,14 +1093,12 @@ function cloneCostContext(costContext) {
 		costMetadata: costContext.costMetadata ? structuredClone(costContext.costMetadata) : void 0
 	};
 }
-//#endregion
-//#region src/model-id.ts
+// src/model-id.ts
 /** Return the first model id that contains non-whitespace characters. */
 function resolveModelId(...candidates) {
 	return candidates.find((candidate) => candidate?.trim());
 }
-//#endregion
-//#region src/metrics/pricing-model.ts
+// src/metrics/pricing-model.ts
 var PricingTier = class {
 	index;
 	when;
@@ -1165,8 +1156,7 @@ var PricingModel = class {
 		return this.tiers[0] ?? null;
 	}
 };
-//#endregion
-//#region src/metrics/models-dev.ts
+// src/metrics/models-dev.ts
 /** Same catalog the model router reads in `@mastra/core` (`gateways/models-dev.ts`). */
 const MODELS_DEV_API_URL = "https://models.dev/api.json";
 /**
@@ -1297,8 +1287,7 @@ function sortedEntries(value) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-//#endregion
-//#region src/metrics/pricing-registry.ts
+// src/metrics/pricing-registry.ts
 const DATA_FILE_NAME = "pricing-data.json";
 const REFRESH_INTERVAL_MS = 864e5;
 const MIN_REFRESH_ATTEMPT_INTERVAL_MS = 36e5;
@@ -1649,8 +1638,7 @@ function stripDateSuffix(model) {
 	stripped = model.replace(/-\d{2}-20\d{2}$/, "");
 	return stripped;
 }
-//#endregion
-//#region src/metrics/types.ts
+// src/metrics/types.ts
 const PricingMeter = {
 	INPUT_TOKENS: "input_tokens",
 	INPUT_AUDIO_TOKENS: "input_audio_tokens",
@@ -1686,8 +1674,7 @@ const TokenMetrics = {
 	OUTPUT_AUDIO: "mastra_model_output_audio_tokens",
 	OUTPUT_IMAGE: "mastra_model_output_image_tokens"
 };
-//#endregion
-//#region src/metrics/usage-metrics.ts
+// src/metrics/usage-metrics.ts
 function getTokenMetricSamples(usage) {
 	const samples = [];
 	const pushIfDefined = (name, value) => {
@@ -1721,8 +1708,7 @@ function getTokenMetricSamples(usage) {
 	}
 	return samples;
 }
-//#endregion
-//#region src/metrics/estimator.ts
+// src/metrics/estimator.ts
 function estimateCosts(args, pricingRegistry = PricingRegistry.getGlobal()) {
 	const { provider, model, usage } = args;
 	const results = /* @__PURE__ */ new Map();
@@ -1954,8 +1940,7 @@ function estimateCostForMeter(args) {
 		}
 	};
 }
-//#endregion
-//#region src/metrics/auto-extract.ts
+// src/metrics/auto-extract.ts
 /**
 * Emits metrics derived from live spans.
 */
@@ -2109,8 +2094,7 @@ function getDurationMetricName(span) {
 		default: return null;
 	}
 }
-//#endregion
-//#region src/metrics/cardinality.ts
+// src/metrics/cardinality.ts
 /** Matches standard UUID v4 strings (case-insensitive). */
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var CardinalityFilter = class {
@@ -2141,8 +2125,7 @@ var CardinalityFilter = class {
 		return filtered;
 	}
 };
-//#endregion
-//#region src/usage.ts
+// src/usage.ts
 /**
 * For non-BYOK requests, `usage.cost` is the complete OpenRouter charge and
 * `usage.costDetails.upstreamInferenceCost` is only its upstream breakdown. For BYOK requests,
@@ -2327,8 +2310,7 @@ function addUsageStats(a, b) {
 		outputDetails: mergeOutputDetails(a.outputDetails, b.outputDetails)
 	};
 }
-//#endregion
-//#region src/model-tracing.ts
+// src/model-tracing.ts
 /**
 * Model Span Tracing
 *
@@ -2756,8 +2738,20 @@ var ModelSpanTracker = class {
 	* feature flag, or when called without an active step span. Auto-invoked from
 	* chunk handlers as a safety net; explicit callers get the most accurate
 	* start time.
+	*
+	* `payload.modelId` / `payload.provider` name the model the caller is about
+	* to invoke and are recorded on MODEL_STEP, also when a fallback attempt
+	* reuses the step's open inference span. The safety net never records them:
+	* a replayed step-start chunk names the model of the original call.
 	*/
 	startInference(payload) {
+		if (payload?.modelId && payload.provider) this.#currentStepSpan?.update({ attributes: {
+			model: payload.modelId,
+			provider: payload.provider
+		} });
+		this.#openInference(payload);
+	}
+	#openInference(payload) {
 		if (!supportsModelInference()) return;
 		if (!this.#currentStepSpan || this.#currentInferenceSpan) return;
 		this.#inferenceCompletionStartTime = void 0;
@@ -2882,7 +2876,7 @@ var ModelSpanTracker = class {
 	*/
 	#ensureStepAndInference() {
 		if (!this.#currentStepSpan) this.startStep();
-		if (!this.#currentInferenceSpan) this.startInference();
+		if (!this.#currentInferenceSpan) this.#openInference();
 	}
 	/**
 	* Create a new chunk span (for multi-part chunks like text-start/delta/end)
@@ -3082,7 +3076,7 @@ var ModelSpanTracker = class {
 					this.#inModelResponse = true;
 					if (this.#currentStepSpan) this.updateStep(chunk.payload);
 					else this.startStep(chunk.payload);
-					if (!this.#currentInferenceSpan) this.startInference(chunk.payload);
+					if (!this.#currentInferenceSpan) this.#openInference(chunk.payload);
 					break;
 				case "step-finish":
 					this.#inModelResponse = false;
@@ -3128,8 +3122,7 @@ var ModelSpanTracker = class {
 		} }));
 	}
 };
-//#endregion
-//#region src/spans/metadata.ts
+// src/spans/metadata.ts
 /**
 * Shared span-metadata helpers.
 *
@@ -3196,8 +3189,7 @@ function mergeMetadata$1(parentMetadata, metadata) {
 		return metadata;
 	}
 }
-//#endregion
-//#region src/spans/base.ts
+// src/spans/base.ts
 const LINEAGE_KEYS = [
 	"parentEntityType",
 	"parentEntityId",
@@ -3208,10 +3200,10 @@ const LINEAGE_KEYS = [
 	"rootEntityName",
 	"rootEntityVersionId"
 ];
-/** Copy only the lineage fields that have values, so spans don't carry undefined keys */
 function ownEntityVersionId(span) {
 	return span instanceof BaseSpan ? span.ownEntityVersionId : void 0;
 }
+/** Copy only the lineage fields that have values, so spans don't carry undefined keys */
 function definedLineage(source) {
 	const lineage = {};
 	for (const key of LINEAGE_KEYS) {
@@ -3290,6 +3282,19 @@ function getExternalParentId(options) {
 	if (parent.isInternal || parent.isExcluded) return parent.getParentSpanId(false);
 	return parent.id;
 }
+/**
+* Vercel AI Gateway reports which provider served a step, and any provider
+* attempts that failed first, only in `providerMetadata.gateway.routing`.
+* Read it defensively so a throwing getter never skips the strip below.
+*/
+function readGatewayRouting(providerMetadata) {
+	try {
+		const gateway = isPlainRecord(providerMetadata) ? providerMetadata.gateway : void 0;
+		return isPlainRecord(gateway) ? gateway.routing : void 0;
+	} catch {
+		return;
+	}
+}
 var BaseSpan = class BaseSpan {
 	name;
 	type;
@@ -3417,8 +3422,10 @@ var BaseSpan = class BaseSpan {
 		if (this.type !== _mastra_core_observability.SpanType.MODEL_STEP) return value;
 		try {
 			const prepared = { ...value };
+			const gatewayRouting = readGatewayRouting(prepared.providerMetadata);
 			delete prepared.providerMetadata;
 			delete prepared.experimental_providerMetadata;
+			if (gatewayRouting !== void 0) prepared.providerMetadata = { gateway: { routing: gatewayRouting } };
 			return prepared;
 		} catch {
 			return value;
@@ -3604,7 +3611,7 @@ var BaseSpan = class BaseSpan {
 			entityType: this.entityType,
 			entityId: this.entityId,
 			entityName: this.entityName,
-			entityVersionId: getMetadataString("entityVersionId"),
+			entityVersionId: this.ownEntityVersionId,
 			...parentLineage,
 			...rootLineage,
 			userId: getMetadataString("userId"),
@@ -3647,6 +3654,7 @@ var BaseSpan = class BaseSpan {
 			isEvent: this.isEvent,
 			isRootSpan: this.isRootSpan,
 			...this.isInternal ? { isInternal: true } : {},
+			...correlation.entityVersionId ? { entityVersionId: correlation.entityVersionId } : {},
 			...definedLineage(correlation),
 			parentSpanId: this.getParentSpanId(includeInternalSpans),
 			externalParentSpanId: this.getExportedExternalParentSpanId(includeInternalSpans),
@@ -3691,8 +3699,7 @@ var BaseSpan = class BaseSpan {
 		return fn();
 	}
 };
-//#endregion
-//#region src/spans/default.ts
+// src/spans/default.ts
 /** Every AI SDK `APICallError` (v4, v5 and v6) carries this shared marker symbol. */
 const API_CALL_ERROR_MARKER = Symbol.for("vercel.ai.error.AI_APICallError");
 function isApiCallError(value) {
@@ -3883,8 +3890,7 @@ function getOrCreateTraceId(options) {
 	}
 	return generateTraceId();
 }
-//#endregion
-//#region src/spans/no-op.ts
+// src/spans/no-op.ts
 var NoOpSpan = class extends BaseSpan {
 	id;
 	traceId;
@@ -3903,8 +3909,7 @@ var NoOpSpan = class extends BaseSpan {
 		return true;
 	}
 };
-//#endregion
-//#region src/exporters/base.ts
+// src/exporters/base.ts
 /**
 * Base Exporter for Observability
 *
@@ -4066,8 +4071,7 @@ var BaseExporter = class {
 		this.logger.info(`${this.name} shutdown complete`);
 	}
 };
-//#endregion
-//#region src/exporters/event-buffer.ts
+// src/exporters/event-buffer.ts
 /**
 * Buffers observability events (creates and updates) for batch flushing.
 * Handles strategy-aware routing of tracing events and tracks created spans
@@ -4078,6 +4082,8 @@ var EventBuffer = class {
 	#creates = [];
 	#updates = [];
 	#allCreatedSpans = /* @__PURE__ */ new Set();
+	/** Spans whose SPAN_STARTED this buffer has seen but whose create isn't confirmed yet */
+	#pendingCreateSpans = /* @__PURE__ */ new Set();
 	#firstEventTime;
 	#storageStrategy;
 	#maxRetries;
@@ -4128,8 +4134,11 @@ var EventBuffer = class {
 			case _mastra_core_observability.TracingEventType.SPAN_STARTED:
 				switch (this.#storageStrategy) {
 					case "realtime":
-					case "event-sourced":
-					case "batch-with-updates": this.pushCreate(event);
+					case "batch-with-updates":
+						if (!event.exportedSpan.isEvent) this.#pendingCreateSpans.add(this.exportedSpanKey(event.exportedSpan));
+						this.pushCreate(event);
+						break;
+					case "event-sourced": this.pushCreate(event);
 				}
 				break;
 			case _mastra_core_observability.TracingEventType.SPAN_UPDATED:
@@ -4198,28 +4207,44 @@ var EventBuffer = class {
 	buildSpanKey(span) {
 		return `${span.traceId}:${span.spanId}`;
 	}
+	exportedSpanKey(span) {
+		return this.buildSpanKey({
+			traceId: span.traceId,
+			spanId: span.id
+		});
+	}
 	/** Track successfully created spans so updates can verify span existence before flushing. */
 	addCreatedSpans(args) {
 		if (this.#storageStrategy === "event-sourced" || this.#storageStrategy === "insert-only") return;
-		for (const createRecord of args.records) if (!createRecord.isEvent) this.#allCreatedSpans.add(this.buildSpanKey(createRecord));
+		for (const createRecord of args.records) if (!createRecord.isEvent) {
+			const key = this.buildSpanKey(createRecord);
+			this.#pendingCreateSpans.delete(key);
+			this.#allCreatedSpans.add(key);
+		}
+	}
+	/** Stop waiting on creates that were dropped, so their updates aren't held back for them. */
+	forgetDroppedCreates(events) {
+		for (const event of events) if (event.type === _mastra_core_observability.TracingEventType.SPAN_STARTED) this.#pendingCreateSpans.delete(this.exportedSpanKey(event.exportedSpan));
 	}
 	/** Check whether a span's create record has already been flushed to storage. */
 	spanExists(span) {
-		return this.#allCreatedSpans?.has(this.buildSpanKey({
-			traceId: span.traceId,
-			spanId: span.id
-		}));
+		return this.#allCreatedSpans.has(this.exportedSpanKey(span));
+	}
+	/** Check whether this buffer saw the span's SPAN_STARTED but its create hasn't been confirmed yet. */
+	isAwaitingCreate(span) {
+		return this.#pendingCreateSpans.has(this.exportedSpanKey(span));
 	}
 	/** Remove completed spans from tracking after their SPAN_ENDED updates are flushed. */
 	endFinishedSpans(args) {
 		if (this.#storageStrategy === "event-sourced" || this.#storageStrategy === "insert-only") return;
 		args.records.forEach((r) => {
-			this.#allCreatedSpans.delete(this.buildSpanKey(r));
+			const key = this.buildSpanKey(r);
+			this.#allCreatedSpans.delete(key);
+			this.#pendingCreateSpans.delete(key);
 		});
 	}
 };
-//#endregion
-//#region src/exporters/default.ts
+// src/exporters/default.ts
 /**
 * Resolves the final tracing storage strategy based on config and observability store hints
 */
@@ -4657,8 +4682,22 @@ var DefaultExporter = class extends BaseExporter {
 		this.logger.info("DefaultExporter shutdown complete");
 	}
 };
-//#endregion
-//#region src/exporters/mastra-storage.ts
+// src/exporters/span-previews.ts
+const buildSpanPreviews = _mastra_core_observability.buildSpanPreviews;
+/** Older core versions retain their existing storage preview fallback. */
+function withSpanPreviews(span) {
+	if (!_mastra_core_features.coreFeatures.has("observability-span-previews")) return span;
+	try {
+		const previews = buildSpanPreviews?.(span);
+		return previews ? {
+			...span,
+			...previews
+		} : span;
+	} catch {
+		return span;
+	}
+}
+// src/exporters/mastra-storage.ts
 /**
 * Resolves the final tracing storage strategy based on config and observability store hints
 */
@@ -4861,6 +4900,7 @@ var MastraStorageExporter = class extends BaseExporter {
 				return { failed: true };
 			}
 			const dropped = this.#eventBuffer.reAddCreates(events);
+			this.#eventBuffer.forgetDroppedCreates(dropped);
 			const retryAttempt = this.retryAttempt(events);
 			this.logStorageFailure(signal, events, retryAttempt, error);
 			this.emitDrop(signal, "retry-exhausted", dropped.length, error);
@@ -4871,7 +4911,15 @@ var MastraStorageExporter = class extends BaseExporter {
 		}
 	}
 	/**
-	* Flush span update/end events, deferring any whose span hasn't been created yet.
+	* Flush span update/end events.
+	*
+	* When the store supports conditional updates, only spans this exporter started
+	* and hasn't confirmed the create for are deferred. Everything else, including
+	* spans another exporter instance started (such as a durable agent ending spans
+	* it rebuilt after a crash), goes straight to storage, and updates that didn't
+	* apply are counted as drops. Without conditional updates, updates for spans this
+	* exporter hasn't created are deferred until their create is flushed.
+	*
 	* When `isEnd` is true, successfully flushed spans are removed from tracking.
 	*/
 	async flushSpanUpdates(events, deferredUpdates, isEnd) {
@@ -4881,10 +4929,12 @@ var MastraStorageExporter = class extends BaseExporter {
 			this.emitDrop("tracing", "unsupported-storage", events.length);
 			return { failed: true };
 		}
+		const storage = this.#observabilityStorage;
+		const batchUpdateUnendedSpans = typeof storage.batchUpdateUnendedSpans === "function" ? storage.batchUpdateUnendedSpans.bind(storage) : void 0;
 		const partials = [];
 		for (const event of events) {
 			const span = event.exportedSpan;
-			if (this.#eventBuffer.spanExists(span)) partials.push({
+			if (batchUpdateUnendedSpans ? !this.#eventBuffer.isAwaitingCreate(span) : this.#eventBuffer.spanExists(span)) partials.push({
 				traceId: span.traceId,
 				spanId: span.id,
 				updates: (0, _mastra_core_storage.buildUpdateSpanRecord)(span)
@@ -4893,7 +4943,10 @@ var MastraStorageExporter = class extends BaseExporter {
 		}
 		if (partials.length === 0) return FLUSH_SUCCEEDED;
 		try {
-			await this.#observabilityStorage.batchUpdateSpans({ records: partials });
+			if (batchUpdateUnendedSpans) {
+				const { updated } = await batchUpdateUnendedSpans({ records: partials });
+				this.emitNotApplied(partials, updated);
+			} else await storage.batchUpdateSpans({ records: partials });
 			if (isEnd) this.#eventBuffer.endFinishedSpans({ records: partials });
 			return FLUSH_SUCCEEDED;
 		} catch (error) {
@@ -4917,6 +4970,27 @@ var MastraStorageExporter = class extends BaseExporter {
 		}
 	}
 	/**
+	* Reports conditional span updates that storage didn't apply: the span wasn't
+	* stored, or it had already ended. Ended spans are immutable, so these are dropped.
+	*/
+	emitNotApplied(partials, updated) {
+		const appliedCounts = /* @__PURE__ */ new Map();
+		for (const span of updated) {
+			const key = `${span.traceId}:${span.spanId}`;
+			appliedCounts.set(key, (appliedCounts.get(key) ?? 0) + 1);
+		}
+		let notApplied = 0;
+		for (const partial of partials) {
+			const key = `${partial.traceId}:${partial.spanId}`;
+			const remaining = appliedCounts.get(key) ?? 0;
+			if (remaining > 0) appliedCounts.set(key, remaining - 1);
+			else notApplied++;
+		}
+		if (notApplied === 0) return;
+		this.logger.debug("Span updates not applied: span not stored or already ended", { count: notApplied });
+		this.emitDrop("tracing", "span-not-updatable", notApplied);
+	}
+	/**
 	* Runs flushBuffer() and tracks its promise so flush() can wait for writes
 	* that a timer or size trigger started on their own.
 	*/
@@ -5026,7 +5100,10 @@ var MastraStorageExporter = class extends BaseExporter {
 			this.logger.debug("Cannot store traces. Observability storage is not initialized");
 			return;
 		}
-		this.#eventBuffer.addEvent(event);
+		this.#eventBuffer.addEvent({
+			...event,
+			exportedSpan: withSpanPreviews(event.exportedSpan)
+		});
 		await this.handleBatchedFlush();
 	}
 	/**
@@ -5095,8 +5172,7 @@ var MastraStorageExporter = class extends BaseExporter {
 		this.logger.info("MastraStorageExporter shutdown complete");
 	}
 };
-//#endregion
-//#region src/instances/platform-policy.ts
+// src/instances/platform-policy.ts
 const MASTRA_BUILT_IN_STORAGE_EXPORTER_NAMES = /* @__PURE__ */ new Set(["mastra-storage-exporter", "mastra-default-observability-exporter"]);
 function isMastraPlatformDeployment() {
 	return Boolean(process.env.MASTRA_DEPLOYMENT_ID);
@@ -5104,8 +5180,7 @@ function isMastraPlatformDeployment() {
 function isMastraBuiltInStorageExporter(exporter) {
 	return exporter instanceof MastraStorageExporter || exporter instanceof DefaultExporter || MASTRA_BUILT_IN_STORAGE_EXPORTER_NAMES.has(exporter.name);
 }
-//#endregion
-//#region src/instances/base.ts
+// src/instances/base.ts
 /**
 * BaseObservability - Abstract base class for Observability implementations
 */
@@ -5818,13 +5893,11 @@ var BaseObservabilityInstance = class extends _mastra_core_base.MastraBase {
 		this.logger.info(`[Observability] Shutdown completed [name=${this.name}]`);
 	}
 };
-//#endregion
-//#region src/client/id.ts
+// src/client/id.ts
 function generateClientSignalId() {
 	return globalThis.crypto.randomUUID();
 }
-//#endregion
-//#region src/client/otlp.ts
+// src/client/otlp.ts
 /**
 * Hand-rolled OTLP/JSON decoder for the subset we need to ingest from
 * client-side tool execution.
@@ -6012,8 +6085,7 @@ function buildExportedLog(decoded) {
 		data: decoded.attributes
 	};
 }
-//#endregion
-//#region src/client/w3c.ts
+// src/client/w3c.ts
 /**
 * Hand-rolled W3C Trace Context and Baggage propagation.
 *
@@ -6084,8 +6156,7 @@ function formatBaggage(entries) {
 	}
 	return parts.join(",");
 }
-//#endregion
-//#region src/client/proxy.ts
+// src/client/proxy.ts
 const DEFAULT_LIMITS = {
 	maxSpans: 10,
 	maxLogs: 10,
@@ -6223,8 +6294,7 @@ function validateParentLinks(spans, rootParent) {
 function createClientObservabilityProxy(options) {
 	return new ClientObservabilityProxyImpl(options);
 }
-//#endregion
-//#region src/exporters/tracking.ts
+// src/exporters/tracking.ts
 /**
 * TrackingExporter base class for vendor-specific observability exporters.
 *
@@ -7305,8 +7375,7 @@ var TrackingExporter = class extends BaseExporter {
 		await super.shutdown();
 	}
 };
-//#endregion
-//#region src/exporters/span-formatters.ts
+// src/exporters/span-formatters.ts
 /**
 * Chains multiple span formatters into a single formatter.
 *
@@ -7343,8 +7412,7 @@ function chainFormatters(formatters) {
 		return currentSpan;
 	};
 }
-//#endregion
-//#region src/exporters/auth-failure-cooldown.ts
+// 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 = 9e5;
@@ -7425,8 +7493,7 @@ var AuthFailureCooldown = class {
 		});
 	}
 };
-//#endregion
-//#region src/exporters/cloud.ts
+// src/exporters/cloud.ts
 const SIGNAL_PUBLISH_SUFFIXES$1 = {
 	traces: "/spans/publish",
 	logs: "/logs/publish",
@@ -7846,8 +7913,7 @@ var CloudExporter = class extends BaseExporter {
 		this.logger.info("CloudExporter shutdown complete");
 	}
 };
-//#endregion
-//#region src/exporters/console.ts
+// src/exporters/console.ts
 var ConsoleExporter = class extends BaseExporter {
 	name = "tracing-console-exporter";
 	constructor(config = {}) {
@@ -7910,8 +7976,7 @@ var ConsoleExporter = class extends BaseExporter {
 		this.logger.info("ConsoleExporter shutdown");
 	}
 };
-//#endregion
-//#region src/exporters/mastra-platform.ts
+// src/exporters/mastra-platform.ts
 const SIGNAL_PUBLISH_SUFFIXES = {
 	traces: "/spans/publish",
 	logs: "/logs/publish",
@@ -8142,7 +8207,7 @@ var MastraPlatformExporter = class extends BaseExporter {
 	}
 	formatSpan(span) {
 		return {
-			...span,
+			...withSpanPreviews(span),
 			spanId: span.id,
 			spanType: span.type,
 			startedAt: span.startTime,
@@ -8442,8 +8507,7 @@ var MastraPlatformExporter = class extends BaseExporter {
 		this.logger.info("MastraPlatformExporter shutdown complete");
 	}
 };
-//#endregion
-//#region src/exporters/test.ts
+// src/exporters/test.ts
 /**
 * Test Exporter for Observability
 *
@@ -9489,8 +9553,7 @@ var TestExporter = class extends BaseExporter {
 * @deprecated Use `TestExporter` instead. This alias will be removed in a future version.
 */
 const JsonExporter = TestExporter;
-//#endregion
-//#region src/instances/default.ts
+// src/instances/default.ts
 var DefaultObservabilityInstance = class extends BaseObservabilityInstance {
 	constructor(config) {
 		super(config);
@@ -9499,8 +9562,7 @@ var DefaultObservabilityInstance = class extends BaseObservabilityInstance {
 		return new DefaultSpan(options, this);
 	}
 };
-//#endregion
-//#region src/recorded.ts
+// src/recorded.ts
 function nullToUndefined(value) {
 	return value ?? void 0;
 }
@@ -9804,8 +9866,7 @@ function hydrateRecordedTrace(args) {
 		debugRecordedAnnotationUnavailable
 	});
 }
-//#endregion
-//#region src/registry.ts
+// src/registry.ts
 /**
 * Registry for Observability instances.
 */
@@ -9894,8 +9955,7 @@ var ObservabilityRegistry = class {
 		return new Map(this.#instances);
 	}
 };
-//#endregion
-//#region src/span_processors/sensitive-data-filter.ts
+// src/span_processors/sensitive-data-filter.ts
 /**
 * Maximum number of traces to keep indexed-redaction state for.
 * Spans never signal trace completion, so state is evicted least-recently-used.
@@ -10105,8 +10165,7 @@ var SensitiveDataFilter = class {
 		this.traceStates.clear();
 	}
 };
-//#endregion
-//#region src/default.ts
+// src/default.ts
 /**
 * Type guard to check if an object is a BaseObservability instance
 */
@@ -10441,8 +10500,7 @@ var Observability = class extends _mastra_core_base.MastraBase {
 		if (handlerResults.length > 0) await Promise.allSettled(handlerResults);
 	}
 };
-//#endregion
-//#region src/features.ts
+// src/features.ts
 /**
 * Feature flags for @mastra/observability
 *
@@ -10481,8 +10539,7 @@ var Observability = class extends _mastra_core_base.MastraBase {
 * ```
 */
 const observabilityFeatures = /* @__PURE__ */ new Set(["model-inference-span", "internal-usage-rollup"]);
-//#endregion
-//#region src/tracing-options.ts
+// src/tracing-options.ts
 /**
 * Builds TracingOptions by composing one or more updater functions.
 *
@@ -10503,7 +10560,6 @@ const observabilityFeatures = /* @__PURE__ */ new Set(["model-inference-span", "
 function buildTracingOptions(...updaters) {
 	return updaters.reduce((opts, updater) => updater(opts), {});
 }
-//#endregion
 exports.BaseExporter = BaseExporter;
 exports.BaseObservabilityEventBus = BaseObservabilityEventBus;
 exports.BaseObservabilityInstance = BaseObservabilityInstance;