@mastra/observability 1.21.1-alpha.1 → 1.21.1-alpha.2

package/dist/index.js

@@ -12,7 +12,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 +79,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 +154,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 +520,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 +729,7 @@ var ObservabilityBus = class extends BaseObservabilityEventBus {
 		await super.shutdown();
 	}
 };
-//#endregion
-//#region src/config.ts
+// src/config.ts
 /**
 * Sampling strategy types
 */
@@ -860,8 +856,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 +924,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 +992,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 +1067,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 +1130,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 +1261,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 +1612,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 +1648,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 +1682,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 +1914,7 @@ function estimateCostForMeter(args) {
 		}
 	};
 }
-//#endregion
-//#region src/metrics/auto-extract.ts
+// src/metrics/auto-extract.ts
 /**
 * Emits metrics derived from live spans.
 */
@@ -2083,8 +2068,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 +2099,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 +2284,7 @@ function addUsageStats(a, b) {
 		outputDetails: mergeOutputDetails(a.outputDetails, b.outputDetails)
 	};
 }
-//#endregion
-//#region src/model-tracing.ts
+// src/model-tracing.ts
 /**
 * Model Span Tracing
 *
@@ -3102,8 +3084,7 @@ var ModelSpanTracker = class {
 		} }));
 	}
 };
-//#endregion
-//#region src/spans/metadata.ts
+// src/spans/metadata.ts
 /**
 * Shared span-metadata helpers.
 *
@@ -3170,8 +3151,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 +3162,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) {
@@ -3578,7 +3558,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 +3601,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 +3646,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 +3837,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 +3856,7 @@ var NoOpSpan = class extends BaseSpan {
 		return true;
 	}
 };
-//#endregion
-//#region src/exporters/base.ts
+// src/exporters/base.ts
 /**
 * Base Exporter for Observability
 *
@@ -4040,8 +4018,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
@@ -4192,8 +4169,7 @@ var EventBuffer = class {
 		});
 	}
 };
-//#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 +4607,7 @@ var DefaultExporter = class extends BaseExporter {
 		this.logger.info("DefaultExporter shutdown complete");
 	}
 };
-//#endregion
-//#region src/exporters/mastra-storage.ts
+// src/exporters/mastra-storage.ts
 /**
 * Resolves the final tracing storage strategy based on config and observability store hints
 */
@@ -5069,8 +5044,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 +5052,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 +5765,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 +5957,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 +6028,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 +6166,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 +7247,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 +7284,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 +7365,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 +7785,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 +7848,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",
@@ -8416,8 +8379,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 +9425,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 +9434,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 +9738,7 @@ function hydrateRecordedTrace(args) {
 		debugRecordedAnnotationUnavailable
 	});
 }
-//#endregion
-//#region src/registry.ts
+// src/registry.ts
 /**
 * Registry for Observability instances.
 */
@@ -9868,8 +9827,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 +10037,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 +10372,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 +10411,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 +10432,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