@mastra/otel-exporter 1.3.16-alpha.1 → 1.4.0-alpha.0

package/dist/features.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Feature detection for paired @mastra/core and @mastra/observability versions.
+ *
+ * Both are resolved synchronously so span classification is stable from the
+ * very first span: `OtelBridge.createSpan()` picks the OTEL SpanKind at
+ * `startSpan()` time, where it can no longer change, so detection must not
+ * depend on a pending dynamic import.
+ *
+ * `@mastra/observability` is a hard dependency, but older versions do not
+ * export `observabilityFeatures`. The namespace import reads it as `undefined`
+ * in that case instead of failing to link, which is the graceful fallback
+ * documented in `observability/mastra/src/features.ts`.
+ */
+/**
+ * Returns true when both packages report the `model-inference-span` feature,
+ * meaning MODEL_INFERENCE spans are emitted by the tracker. Drives which span
+ * is exported as the GenAI `chat` call (new: MODEL_INFERENCE; legacy:
+ * MODEL_GENERATION).
+ */
+export declare function isModelInferenceEnabled(): boolean;
+/**
+ * @internal Test-only override. Allows tests to simulate a paired older or
+ * newer `@mastra/observability` without juggling module mocks.
+ */
+export declare function __setObservabilityFeaturesForTest(features: ReadonlySet<string> | undefined): void;
+//# sourceMappingURL=features.d.ts.map

package/dist/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI,CAEjG"}

package/dist/gen-ai-semantics.d.ts

@@ -8,6 +8,7 @@
  * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/non-normative/examples-llm-calls/
  * @see https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/
  */
+import { SpanType } from '@mastra/core/observability';
 import type { AnyExportedSpan, UsageStats } from '@mastra/core/observability';
 import type { Attributes } from '@opentelemetry/api';
 import { ATTR_GEN_AI_USAGE_INPUT_TOKENS, ATTR_GEN_AI_USAGE_OUTPUT_TOKENS, ATTR_GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS, ATTR_GEN_AI_USAGE_CACHE_CREATION_INPUT_TOKENS } from '@opentelemetry/semantic-conventions/incubating';
@@ -30,13 +31,30 @@ export interface OtelUsageMetrics {
  * Formats UsageStats to OTel GenAI semantic convention attributes.
  */
 export declare function formatUsageMetrics(usage?: UsageStats): OtelUsageMetrics;
+/**
+ * Whether this span is exported as the GenAI inference (`chat`) span.
+ *
+ * Exactly one span per model call carries `gen_ai.request.model`, the messages
+ * and `gen_ai.usage.*`, because OTel backends (Langfuse, Phoenix, ...) sum usage
+ * across nested spans. With paired packages that emit MODEL_INFERENCE, that is
+ * the call; MODEL_GENERATION is then the parent loop and MODEL_STEP one turn of
+ * it. Older pairings only emit MODEL_GENERATION, which keeps the `chat` role.
+ */
+export declare function isModelCallSpan(type: SpanType): boolean;
+export interface GenAISemanticsOptions {
+    /**
+     * Override {@link isModelCallSpan} for this span. Exporters that flatten the
+     * generation loop into a single `chat` span pass `true` for MODEL_GENERATION.
+     */
+    modelCall?: boolean;
+}
 /**
  * Get an OTEL-compliant span name based on span type and attributes
  */
-export declare function getSpanName(span: AnyExportedSpan): string;
+export declare function getSpanName(span: AnyExportedSpan, options?: GenAISemanticsOptions): string;
 /**
  * Gets OpenTelemetry attributes from Mastra Span
  * Following OTEL Semantic Conventions for GenAI
  */
-export declare function getAttributes(span: AnyExportedSpan): Attributes;
+export declare function getAttributes(span: AnyExportedSpan, options?: GenAISemanticsOptions): Attributes;
 //# sourceMappingURL=gen-ai-semantics.d.ts.map

package/dist/gen-ai-semantics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gen-ai-semantics.d.ts","sourceRoot":"","sources":["../src/gen-ai-semantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAEV,eAAe,EAKf,UAAU,EASX,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAgBL,8BAA8B,EAC9B,+BAA+B,EAC/B,yCAAyC,EACzC,6CAA6C,EAY9C,MAAM,gDAAgD,CAAC;AAGxD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,8BAA8B,CAAC,CAAC,EAAE,MAAM,CAAC;IAC1C,CAAC,+BAA+B,CAAC,CAAC,EAAE,MAAM,CAAC;IAC3C,CAAC,yCAAyC,CAAC,CAAC,EAAE,MAAM,CAAC;IACrD,CAAC,6CAA6C,CAAC,CAAC,EAAE,MAAM,CAAC;IACzD,6CAA6C,CAAC,EAAE,MAAM,CAAC;IACvD,6CAA6C,CAAC,EAAE,MAAM,CAAC;IACvD,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,kCAAkC,CAAC,EAAE,MAAM,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,gBAAgB,CA2CvE;AA8ED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAUzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAyT/D"}
+{"version":3,"file":"gen-ai-semantics.d.ts","sourceRoot":"","sources":["../src/gen-ai-semantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,KAAK,EAEV,eAAe,EAOf,UAAU,EASX,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAgBL,8BAA8B,EAC9B,+BAA+B,EAC/B,yCAAyC,EACzC,6CAA6C,EAY9C,MAAM,gDAAgD,CAAC;AAIxD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,8BAA8B,CAAC,CAAC,EAAE,MAAM,CAAC;IAC1C,CAAC,+BAA+B,CAAC,CAAC,EAAE,MAAM,CAAC;IAC3C,CAAC,yCAAyC,CAAC,CAAC,EAAE,MAAM,CAAC;IACrD,CAAC,6CAA6C,CAAC,CAAC,EAAE,MAAM,CAAC;IACzD,6CAA6C,CAAC,EAAE,MAAM,CAAC;IACvD,6CAA6C,CAAC,EAAE,MAAM,CAAC;IACvD,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,kCAAkC,CAAC,EAAE,MAAM,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,gBAAgB,CA2CvE;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEvD;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAmED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAU1F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,UAAU,CAoUhG"}

package/dist/index.cjs

@@ -1,6 +1,29 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
 let _mastra_core_observability = require("@mastra/core/observability");
 let _mastra_observability = require("@mastra/observability");
+_mastra_observability = __toESM(_mastra_observability, 1);
 let _opentelemetry_api = require("@opentelemetry/api");
 let _opentelemetry_core = require("@opentelemetry/core");
 let _opentelemetry_resources = require("@opentelemetry/resources");
@@ -11,6 +34,7 @@ let _opentelemetry_api_logs = require("@opentelemetry/api-logs");
 let fs = require("fs");
 let url = require("url");
 let _opentelemetry_semantic_conventions_incubating = require("@opentelemetry/semantic-conventions/incubating");
+let _mastra_core_features = require("@mastra/core/features");
 //#region src/loadExporter.ts
 const EXPORTER_SPECS = {
 	traces: {
@@ -267,6 +291,39 @@ function resolveCustomConfig(config) {
 	};
 }
 //#endregion
+//#region src/features.ts
+/**
+* Feature detection for paired @mastra/core and @mastra/observability versions.
+*
+* Both are resolved synchronously so span classification is stable from the
+* very first span: `OtelBridge.createSpan()` picks the OTEL SpanKind at
+* `startSpan()` time, where it can no longer change, so detection must not
+* depend on a pending dynamic import.
+*
+* `@mastra/observability` is a hard dependency, but older versions do not
+* export `observabilityFeatures`. The namespace import reads it as `undefined`
+* in that case instead of failing to link, which is the graceful fallback
+* documented in `observability/mastra/src/features.ts`.
+*/
+const FEATURE = "model-inference-span";
+let observabilityFeatures = _mastra_observability.observabilityFeatures;
+/**
+* Returns true when both packages report the `model-inference-span` feature,
+* meaning MODEL_INFERENCE spans are emitted by the tracker. Drives which span
+* is exported as the GenAI `chat` call (new: MODEL_INFERENCE; legacy:
+* MODEL_GENERATION).
+*/
+function isModelInferenceEnabled() {
+	return observabilityFeatures?.has(FEATURE) === true && _mastra_core_features.coreFeatures.has(FEATURE);
+}
+/**
+* @internal Test-only override. Allows tests to simulate a paired older or
+* newer `@mastra/observability` without juggling module mocks.
+*/
+function __setObservabilityFeaturesForTest(features) {
+	observabilityFeatures = features;
+}
+//#endregion
 //#region src/gen-ai-messages.ts
 const isMastraMessagePart = (p) => {
 	return typeof p === "object" && p != null && "type" in p && (p.type === "text" || p.type === "tool-call" || p.type === "tool-result") && (p.type === "text" && "text" in p || p.type === "tool-call" && "toolCallId" in p && "toolName" in p && "input" in p || p.type === "tool-result" && "toolCallId" in p && "toolName" in p && "output" in p);
@@ -377,11 +434,24 @@ function addModelRequestAttributes(attributes, attrs) {
 	Object.assign(attributes, formatUsageMetrics(attrs.usage));
 }
 /**
+* Whether this span is exported as the GenAI inference (`chat`) span.
+*
+* Exactly one span per model call carries `gen_ai.request.model`, the messages
+* and `gen_ai.usage.*`, because OTel backends (Langfuse, Phoenix, ...) sum usage
+* across nested spans. With paired packages that emit MODEL_INFERENCE, that is
+* the call; MODEL_GENERATION is then the parent loop and MODEL_STEP one turn of
+* it. Older pairings only emit MODEL_GENERATION, which keeps the `chat` role.
+*/
+function isModelCallSpan(type) {
+	return type === (isModelInferenceEnabled() ? _mastra_core_observability.SpanType.MODEL_INFERENCE : _mastra_core_observability.SpanType.MODEL_GENERATION);
+}
+/**
 * Get the operation name based on span type for gen_ai.operation.name
 */
-function getOperationName(span) {
+function getOperationName(span, modelCall = isModelCallSpan(span.type)) {
+	if (modelCall) return "chat";
 	switch (span.type) {
-		case _mastra_core_observability.SpanType.MODEL_GENERATION: return "chat";
+		case _mastra_core_observability.SpanType.MODEL_STEP: return "agent_step";
 		case _mastra_core_observability.SpanType.RAG_EMBEDDING: return "embeddings";
 		case _mastra_core_observability.SpanType.TOOL_CALL:
 		case _mastra_core_observability.SpanType.MCP_TOOL_CALL:
@@ -399,7 +469,8 @@ function sanitizeSpanName(name) {
 }
 function getSpanIdentifier(span) {
 	switch (span.type) {
-		case _mastra_core_observability.SpanType.MODEL_GENERATION: return span.attributes?.model;
+		case _mastra_core_observability.SpanType.MODEL_GENERATION:
+		case _mastra_core_observability.SpanType.MODEL_INFERENCE: return span.attributes?.model;
 		case _mastra_core_observability.SpanType.RAG_EMBEDDING: return span.attributes?.model;
 		case _mastra_core_observability.SpanType.WORKFLOW_STEP: return span.entityId;
 		case _mastra_core_observability.SpanType.WORKFLOW_CONDITIONAL:
@@ -414,33 +485,34 @@ function getSpanIdentifier(span) {
 /**
 * Get an OTEL-compliant span name based on span type and attributes
 */
-function getSpanName(span) {
+function getSpanName(span, options) {
 	const identifier = getSpanIdentifier(span);
-	if (identifier) return `${getOperationName(span)} ${identifier}`;
+	if (identifier) return `${getOperationName(span, options?.modelCall)} ${identifier}`;
 	return sanitizeSpanName(span.name);
 }
 /**
 * Gets OpenTelemetry attributes from Mastra Span
 * Following OTEL Semantic Conventions for GenAI
 */
-function getAttributes(span) {
+function getAttributes(span, options) {
 	const attributes = {};
 	const spanType = span.type.toLowerCase();
-	attributes[_opentelemetry_semantic_conventions_incubating.ATTR_GEN_AI_OPERATION_NAME] = getOperationName(span);
+	const modelCall = options?.modelCall ?? isModelCallSpan(span.type);
+	attributes[_opentelemetry_semantic_conventions_incubating.ATTR_GEN_AI_OPERATION_NAME] = getOperationName(span, modelCall);
 	attributes["mastra.span.type"] = span.type;
 	if (span.input !== void 0) {
 		const inputStr = typeof span.input === "string" ? span.input : JSON.stringify(span.input);
-		if (span.type === _mastra_core_observability.SpanType.MODEL_GENERATION) attributes[_opentelemetry_semantic_conventions_incubating.ATTR_GEN_AI_INPUT_MESSAGES] = convertMastraMessagesToGenAIMessages(inputStr);
+		if (modelCall) attributes[_opentelemetry_semantic_conventions_incubating.ATTR_GEN_AI_INPUT_MESSAGES] = convertMastraMessagesToGenAIMessages(inputStr);
 		else if (span.type === _mastra_core_observability.SpanType.TOOL_CALL || span.type === _mastra_core_observability.SpanType.MCP_TOOL_CALL || span.type === _mastra_core_observability.SpanType.PROVIDER_TOOL_CALL) attributes["gen_ai.tool.call.arguments"] = inputStr;
 		else attributes[`mastra.${spanType}.input`] = inputStr;
 	}
 	if (span.output !== void 0) {
 		const outputStr = typeof span.output === "string" ? span.output : JSON.stringify(span.output);
-		if (span.type === _mastra_core_observability.SpanType.MODEL_GENERATION) attributes[_opentelemetry_semantic_conventions_incubating.ATTR_GEN_AI_OUTPUT_MESSAGES] = convertMastraMessagesToGenAIMessages(outputStr);
+		if (modelCall) attributes[_opentelemetry_semantic_conventions_incubating.ATTR_GEN_AI_OUTPUT_MESSAGES] = convertMastraMessagesToGenAIMessages(outputStr);
 		else if (span.type === _mastra_core_observability.SpanType.TOOL_CALL || span.type === _mastra_core_observability.SpanType.MCP_TOOL_CALL || span.type === _mastra_core_observability.SpanType.PROVIDER_TOOL_CALL) attributes["gen_ai.tool.call.result"] = outputStr;
 		else attributes[`mastra.${spanType}.output`] = outputStr;
 	}
-	if (span.type === _mastra_core_observability.SpanType.MODEL_GENERATION && span.attributes) {
+	if (modelCall && span.attributes) {
 		const modelAttrs = span.attributes;
 		addModelRequestAttributes(attributes, modelAttrs);
 		if (span.entityId) attributes[_opentelemetry_semantic_conventions_incubating.ATTR_GEN_AI_AGENT_ID] = span.entityId;
@@ -462,6 +534,11 @@ function getAttributes(span) {
 		if (modelAttrs.serverAddress) attributes[_opentelemetry_semantic_conventions_incubating.ATTR_SERVER_ADDRESS] = modelAttrs.serverAddress;
 		if (modelAttrs.serverPort !== void 0) attributes[_opentelemetry_semantic_conventions_incubating.ATTR_SERVER_PORT] = modelAttrs.serverPort;
 	}
+	if (span.type === _mastra_core_observability.SpanType.MODEL_STEP && span.attributes) {
+		const stepAttrs = span.attributes;
+		if (stepAttrs.stepIndex !== void 0) attributes[`mastra.${spanType}.step_index`] = stepAttrs.stepIndex;
+		if (stepAttrs.isContinued !== void 0) attributes[`mastra.${spanType}.is_continued`] = stepAttrs.isContinued;
+	}
 	if (span.type === _mastra_core_observability.SpanType.RAG_EMBEDDING && span.attributes) {
 		const embeddingAttrs = span.attributes;
 		addModelRequestAttributes(attributes, embeddingAttrs);
@@ -720,8 +797,8 @@ async function getPackageVersion(pkgName) {
 * @returns The appropriate OTEL SpanKind
 */
 function getSpanKind(type) {
+	if (isModelCallSpan(type)) return _opentelemetry_api.SpanKind.CLIENT;
 	switch (type) {
-		case _mastra_core_observability.SpanType.MODEL_GENERATION:
 		case _mastra_core_observability.SpanType.RAG_EMBEDDING:
 		case _mastra_core_observability.SpanType.MCP_TOOL_CALL: return _opentelemetry_api.SpanKind.CLIENT;
 		default: return _opentelemetry_api.SpanKind.INTERNAL;
@@ -1107,11 +1184,13 @@ var OtelExporter = class extends _mastra_observability.BaseExporter {
 //#endregion
 exports.OtelExporter = OtelExporter;
 exports.SpanConverter = SpanConverter;
+exports.__setObservabilityFeaturesForTest = __setObservabilityFeaturesForTest;
 exports.buildLogAttributes = buildLogAttributes;
 exports.convertLog = convertLog;
 exports.getAttributes = getAttributes;
 exports.getSpanKind = getSpanKind;
 exports.getSpanName = getSpanName;
+exports.isModelCallSpan = isModelCallSpan;
 exports.mapSeverity = mapSeverity;
 
 //# sourceMappingURL=index.cjs.map