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

package/dist/index.js

@@ -2,6 +2,7 @@ import { createRequire } from "module";
 import { MastraBase } from "@mastra/core/base";
 import { ErrorCategory, ErrorDomain, MastraError } from "@mastra/core/error";
 import { ConsoleLogger, LogLevel, RegisteredLogger } from "@mastra/core/logger";
+import * as coreObservability from "@mastra/core/observability";
 import { DEFAULT_BLOCKED_LABELS, EntityType, InternalSpans, SpanType, TracingEventType, noOpLoggerContext } from "@mastra/core/observability";
 import { fetchWithRetry, getNestedValue, setNestedValue } from "@mastra/core/utils";
 import { z } from "zod/v4";
@@ -12,7 +13,7 @@ import { TransformStream } from "stream/web";
 import { coreFeatures } from "@mastra/core/features";
 import { buildCreateSpanRecord, buildFeedbackRecord, buildLogRecord, buildMetricRecord, buildScoreRecord, buildUpdateSpanRecord } from "@mastra/core/storage";
 import { createHash } from "crypto";
-//#region src/bus/route-event.ts
+// src/bus/route-event.ts
 /**
 * Route a single event to the appropriate method on a handler.
 *
@@ -79,8 +80,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.
 *
@@ -155,8 +155,7 @@ var BaseObservabilityEventBus = class BaseObservabilityEventBus extends MastraBa
 		this.subscribers.clear();
 	}
 };
-//#endregion
-//#region src/spans/serialization.ts
+// src/spans/serialization.ts
 /**
 * Bounded serialization utilities for AI tracing.
 *
@@ -522,8 +521,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
@@ -732,8 +730,7 @@ var ObservabilityBus = class extends BaseObservabilityEventBus {
 		await super.shutdown();
 	}
 };
-//#endregion
-//#region src/config.ts
+// src/config.ts
 /**
 * Sampling strategy types
 */
@@ -860,8 +857,7 @@ const observabilityRegistryConfigSchema = 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.
 *
@@ -929,8 +925,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,
@@ -998,8 +993,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.
@@ -1074,14 +1068,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;
@@ -1139,8 +1131,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";
 /**
@@ -1271,8 +1262,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;
@@ -1623,8 +1613,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",
@@ -1660,8 +1649,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) => {
@@ -1695,8 +1683,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();
@@ -1928,8 +1915,7 @@ function estimateCostForMeter(args) {
 		}
 	};
 }
-//#endregion
-//#region src/metrics/auto-extract.ts
+// src/metrics/auto-extract.ts
 /**
 * Emits metrics derived from live spans.
 */
@@ -2083,8 +2069,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 {
@@ -2115,8 +2100,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,
@@ -2301,8 +2285,7 @@ function addUsageStats(a, b) {
 		outputDetails: mergeOutputDetails(a.outputDetails, b.outputDetails)
 	};
 }
-//#endregion
-//#region src/model-tracing.ts
+// src/model-tracing.ts
 /**
 * Model Span Tracing
 *
@@ -2730,8 +2713,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;
@@ -2856,7 +2851,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)
@@ -3056,7 +3051,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;
@@ -3102,8 +3097,7 @@ var ModelSpanTracker = class {
 		} }));
 	}
 };
-//#endregion
-//#region src/spans/metadata.ts
+// src/spans/metadata.ts
 /**
 * Shared span-metadata helpers.
 *
@@ -3170,8 +3164,7 @@ function mergeMetadata$1(parentMetadata, metadata) {
 		return metadata;
 	}
 }
-//#endregion
-//#region src/spans/base.ts
+// src/spans/base.ts
 const LINEAGE_KEYS = [
 	"parentEntityType",
 	"parentEntityId",
@@ -3182,10 +3175,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) {
@@ -3264,6 +3257,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;
@@ -3391,8 +3397,10 @@ var BaseSpan = class BaseSpan {
 		if (this.type !== 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;
@@ -3578,7 +3586,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"),
@@ -3621,6 +3629,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),
@@ -3665,8 +3674,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) {
@@ -3857,8 +3865,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;
@@ -3877,8 +3884,7 @@ var NoOpSpan = class extends BaseSpan {
 		return true;
 	}
 };
-//#endregion
-//#region src/exporters/base.ts
+// src/exporters/base.ts
 /**
 * Base Exporter for Observability
 *
@@ -4040,8 +4046,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
@@ -4052,6 +4057,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;
@@ -4102,8 +4109,11 @@ var EventBuffer = class {
 			case 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 TracingEventType.SPAN_UPDATED:
@@ -4172,28 +4182,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 === 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
 */
@@ -4631,8 +4657,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 = coreObservability.buildSpanPreviews;
+/** Older core versions retain their existing storage preview fallback. */
+function withSpanPreviews(span) {
+	if (!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
 */
@@ -4835,6 +4875,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);
@@ -4845,7 +4886,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) {
@@ -4855,10 +4904,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: buildUpdateSpanRecord(span)
@@ -4867,7 +4918,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) {
@@ -4891,6 +4945,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.
 	*/
@@ -5000,7 +5075,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();
 	}
 	/**
@@ -5069,8 +5147,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);
@@ -5078,8 +5155,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
 */
@@ -5792,13 +5868,11 @@ var BaseObservabilityInstance = class extends 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.
@@ -5986,8 +6060,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.
 *
@@ -6058,8 +6131,7 @@ function formatBaggage(entries) {
 	}
 	return parts.join(",");
 }
-//#endregion
-//#region src/client/proxy.ts
+// src/client/proxy.ts
 const DEFAULT_LIMITS = {
 	maxSpans: 10,
 	maxLogs: 10,
@@ -6197,8 +6269,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.
 *
@@ -7279,8 +7350,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.
 *
@@ -7317,8 +7387,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;
@@ -7399,8 +7468,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",
@@ -7820,8 +7888,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 = {}) {
@@ -7884,8 +7951,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",
@@ -8116,7 +8182,7 @@ var MastraPlatformExporter = class extends BaseExporter {
 	}
 	formatSpan(span) {
 		return {
-			...span,
+			...withSpanPreviews(span),
 			spanId: span.id,
 			spanType: span.type,
 			startedAt: span.startTime,
@@ -8416,8 +8482,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
 *
@@ -9463,8 +9528,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);
@@ -9473,8 +9537,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;
 }
@@ -9778,8 +9841,7 @@ function hydrateRecordedTrace(args) {
 		debugRecordedAnnotationUnavailable
 	});
 }
-//#endregion
-//#region src/registry.ts
+// src/registry.ts
 /**
 * Registry for Observability instances.
 */
@@ -9868,8 +9930,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.
@@ -10079,8 +10140,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
 */
@@ -10415,8 +10475,7 @@ var Observability = class extends MastraBase {
 		if (handlerResults.length > 0) await Promise.allSettled(handlerResults);
 	}
 };
-//#endregion
-//#region src/features.ts
+// src/features.ts
 /**
 * Feature flags for @mastra/observability
 *
@@ -10455,8 +10514,7 @@ var Observability = class extends 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.
 *
@@ -10477,7 +10535,6 @@ const observabilityFeatures = /* @__PURE__ */ new Set(["model-inference-span", "
 function buildTracingOptions(...updaters) {
 	return updaters.reduce((opts, updater) => updater(opts), {});
 }
-//#endregion
 export { BaseExporter, BaseObservabilityEventBus, BaseObservabilityInstance, BaseSpan, CardinalityFilter, CloudExporter, ConsoleExporter, DEFAULT_DEEP_CLEAN_OPTIONS, DEFAULT_LIMITS, DefaultExporter, DefaultObservabilityInstance, DefaultSpan, JsonExporter, LoggerContextImpl, MastraPlatformExporter, MastraStorageExporter, MetricsContextImpl, ModelSpanTracker, NoOpSpan, OBSERVABILITY_CAPABILITIES_HEADER, Observability, ObservabilityBus, QUOTA_PAUSE_CAPABILITY, SamplingStrategyType, SensitiveDataFilter, TestExporter, TraceData, TrackingExporter, buildExportedLog, buildExportedSpan, buildTracingOptions, chainFormatters, createClientObservabilityProxy, decodeResourceLogs, decodeResourceSpans, deepClean, formatBaggage, formatTraceparent, getExternalParentId, isSerializedMap, mergeSerializationOptions, observabilityConfigValueSchema, observabilityFeatures, observabilityInstanceConfigSchema, observabilityRegistryConfigSchema, otlpSeverityToLogLevel, parseBaggage, parseTraceparent, reconstructSerializedMap, routeToHandler, samplingStrategySchema, serializationOptionsSchema, truncateString };
 
 //# sourceMappingURL=index.js.map