@mastra/langfuse 1.4.5 → 1.4.6

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/langfuse
 
+## 1.4.6
+
+### Patch Changes
+
+- Updated dependencies [[`ce93a3c`](https://github.com/mastra-ai/mastra/commit/ce93a3c114ea1cbfbd576f3db41d7c26c9844f5b), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`a211d09`](https://github.com/mastra-ai/mastra/commit/a211d09185dc65a746534914cf38b67f21ee9bac), [`0dca9d0`](https://github.com/mastra-ai/mastra/commit/0dca9d0b1356024a53b72ea6f040db528b126caa), [`6218217`](https://github.com/mastra-ai/mastra/commit/62182171b6cfca0b099f1c6a77a2e65e7639ab86), [`5807d3a`](https://github.com/mastra-ai/mastra/commit/5807d3ae1d259b8b7d6df7e5bf2b485c694af9c8), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`05db566`](https://github.com/mastra-ai/mastra/commit/05db566fcbdcbf33d0bffca0c72ec30129e2e3ca), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093), [`29c584a`](https://github.com/mastra-ai/mastra/commit/29c584a13a88831e5ed1fdeb0ff8e82eae180433), [`c093146`](https://github.com/mastra-ai/mastra/commit/c0931466404d3c521308ea119cb165bb7e695155), [`8124754`](https://github.com/mastra-ai/mastra/commit/8124754ae89fbc69f8136d1df4a91904d0f84c4e), [`d12b2e4`](https://github.com/mastra-ai/mastra/commit/d12b2e4023fd9e3d3e93a9169f5088bcee2a849c), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093)]:
+  - @mastra/core@1.54.0
+  - @mastra/observability@1.16.3
+  - @mastra/otel-exporter@1.3.6
+
+## 1.4.6-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`ce93a3c`](https://github.com/mastra-ai/mastra/commit/ce93a3c114ea1cbfbd576f3db41d7c26c9844f5b), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`5807d3a`](https://github.com/mastra-ai/mastra/commit/5807d3ae1d259b8b7d6df7e5bf2b485c694af9c8), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`5718a22`](https://github.com/mastra-ai/mastra/commit/5718a229281dcfd36bcd1f42a242e3717e510a33), [`57661af`](https://github.com/mastra-ai/mastra/commit/57661afeca52ff9af4e72675ede2134fa503d5a5), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093), [`c093146`](https://github.com/mastra-ai/mastra/commit/c0931466404d3c521308ea119cb165bb7e695155), [`d1b7e3a`](https://github.com/mastra-ai/mastra/commit/d1b7e3a978a309a5653eeaa490d2d6c7c53bd093)]:
+  - @mastra/core@1.54.0-alpha.1
+  - @mastra/observability@1.16.3-alpha.0
+  - @mastra/otel-exporter@1.3.6-alpha.0
+
 ## 1.4.5
 
 ### Patch Changes

package/dist/index.cjs

@@ -1,302 +1,307 @@
-'use strict';
-
-var client = require('@langfuse/client');
-var otel = require('@langfuse/otel');
-var observability$1 = require('@mastra/core/observability');
-var observability = require('@mastra/observability');
-var otelExporter = require('@mastra/otel-exporter');
-
-// src/tracing.ts
-var LOG_PREFIX = "[LangfuseExporter]";
-var LANGFUSE_DEFAULT_BASE_URL = "https://cloud.langfuse.com";
-var LangfuseExporter = class extends observability.BaseExporter {
-  name = "langfuse";
-  #processor;
-  #client;
-  #spanConverter;
-  #realtime;
-  #environment;
-  #release;
-  constructor(config = {}) {
-    super(config);
-    const publicKey = config.publicKey ?? process.env.LANGFUSE_PUBLIC_KEY;
-    const secretKey = config.secretKey ?? process.env.LANGFUSE_SECRET_KEY;
-    const baseUrl = stripTrailingSlashes(config.baseUrl ?? process.env.LANGFUSE_BASE_URL ?? LANGFUSE_DEFAULT_BASE_URL);
-    this.#realtime = config.realtime ?? false;
-    if (!publicKey || !secretKey) {
-      const publicKeySource = config.publicKey ? "from config" : process.env.LANGFUSE_PUBLIC_KEY ? "from env" : "missing";
-      const secretKeySource = config.secretKey ? "from config" : process.env.LANGFUSE_SECRET_KEY ? "from env" : "missing";
-      this.setDisabled(
-        `${LOG_PREFIX} Missing required credentials (publicKey: ${publicKeySource}, secretKey: ${secretKeySource}). Set LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY environment variables or pass them in config.`
-      );
-      return;
-    }
-    this.#processor = new otel.LangfuseSpanProcessor({
-      publicKey,
-      secretKey,
-      baseUrl,
-      environment: config.environment,
-      release: config.release,
-      exportMode: this.#realtime ? "immediate" : "batched",
-      flushAt: config.flushAt,
-      flushInterval: config.flushInterval,
-      // Export all spans — the default filter only passes spans with gen_ai.* attributes
-      // or known LLM instrumentation scopes, but Mastra spans use mastra.* attributes.
-      shouldExportSpan: () => true
-    });
-    this.#client = new client.LangfuseClient({
-      publicKey,
-      secretKey,
-      baseUrl
-    });
-    this.#environment = config.environment ?? process.env.LANGFUSE_TRACING_ENVIRONMENT;
-    this.#release = config.release ?? process.env.LANGFUSE_RELEASE;
-  }
-  init(options) {
-    this.#spanConverter = new otelExporter.SpanConverter({
-      packageName: "@mastra/langfuse",
-      serviceName: options.config?.serviceName,
-      format: "GenAI_v1_38_0"
-    });
-  }
-  async _exportTracingEvent(event) {
-    if (event.type !== observability$1.TracingEventType.SPAN_ENDED) return;
-    if (!this.#processor) return;
-    await this.exportSpan(event.exportedSpan);
-  }
-  async exportSpan(span) {
-    if (!this.#spanConverter) {
-      this.#spanConverter = new otelExporter.SpanConverter({
-        packageName: "@mastra/langfuse",
-        serviceName: "mastra-service",
-        format: "GenAI_v1_38_0"
-      });
-    }
-    try {
-      const otelSpan = await this.#spanConverter.convertSpan(span);
-      mapMastraToLangfuseAttributes(otelSpan.attributes, span, this.#environment, this.#release);
-      this.#processor.onEnd(otelSpan);
-    } catch (error) {
-      this.logger.error(`${LOG_PREFIX} Failed to export span ${span.id}:`, error);
-    }
-  }
-  /**
-   * The LangfuseClient instance for advanced Langfuse features.
-   * Use this for prompt management, evaluations, datasets, and direct API access.
-   */
-  get client() {
-    return this.#client;
-  }
-  /**
-   * Submit a score to Langfuse. Used by both the new `onScoreEvent` path and the
-   * deprecated `addScoreToTrace` wrapper.
-   */
-  submitScore(args) {
-    if (!this.#client) return;
-    const { id, traceId, spanId, name, value, comment, metadata } = args;
-    try {
-      this.#client.score.create({
-        id,
-        traceId,
-        ...spanId ? { observationId: spanId } : {},
-        name,
-        value,
-        ...comment ? { comment } : {},
-        ...metadata ? { metadata } : {},
-        dataType: "NUMERIC"
-      });
-    } catch (error) {
-      this.logger.error(`${LOG_PREFIX} Error submitting score`, {
-        error,
-        traceId,
-        spanId,
-        name
-      });
-    }
-  }
-  async onScoreEvent(event) {
-    const { score } = event;
-    if (!score.traceId) return;
-    this.submitScore({
-      id: score.scoreId,
-      traceId: score.traceId,
-      spanId: score.spanId,
-      name: score.scorerName ?? score.scorerId,
-      value: score.score,
-      comment: score.reason,
-      metadata: score.metadata
-    });
-  }
-  /**
-   * @deprecated Use the observability score event pipeline (`mastra.observability.addScore`)
-   * instead. This method is preserved for backwards compatibility and forwards to the same
-   * underlying client call as `onScoreEvent`.
-   */
-  async addScoreToTrace({
-    traceId,
-    spanId,
-    score,
-    reason,
-    scorerName,
-    metadata
-  }) {
-    this.submitScore({
-      id: `${traceId}-${spanId || ""}-${scorerName}`,
-      traceId,
-      spanId,
-      name: scorerName,
-      value: score,
-      comment: reason,
-      metadata
-    });
-  }
-  async flush() {
-    await Promise.all([this.#processor?.forceFlush(), this.#client?.flush()]);
-  }
-  async shutdown() {
-    await Promise.all([this.#processor?.shutdown(), this.#client?.shutdown()]);
-  }
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _langfuse_client = require("@langfuse/client");
+let _langfuse_otel = require("@langfuse/otel");
+let _mastra_core_observability = require("@mastra/core/observability");
+let _mastra_observability = require("@mastra/observability");
+let _mastra_otel_exporter = require("@mastra/otel-exporter");
+//#region src/tracing.ts
+/**
+* Langfuse Exporter for Mastra Observability
+*
+* Sends observability data to Langfuse using the official @langfuse/otel span processor
+* and @langfuse/client for non-tracing features (scoring, prompt management, evaluations).
+*
+* @see https://langfuse.com/docs/observability/sdk/typescript/overview
+*/
+const LOG_PREFIX = "[LangfuseExporter]";
+const LANGFUSE_DEFAULT_BASE_URL = "https://cloud.langfuse.com";
+var LangfuseExporter = class extends _mastra_observability.BaseExporter {
+	name = "langfuse";
+	#processor;
+	#client;
+	#spanConverter;
+	#realtime;
+	#environment;
+	#release;
+	constructor(config = {}) {
+		super(config);
+		const publicKey = config.publicKey ?? process.env.LANGFUSE_PUBLIC_KEY;
+		const secretKey = config.secretKey ?? process.env.LANGFUSE_SECRET_KEY;
+		const baseUrl = stripTrailingSlashes(config.baseUrl ?? process.env.LANGFUSE_BASE_URL ?? "https://cloud.langfuse.com");
+		this.#realtime = config.realtime ?? false;
+		if (!publicKey || !secretKey) {
+			const publicKeySource = config.publicKey ? "from config" : process.env.LANGFUSE_PUBLIC_KEY ? "from env" : "missing";
+			const secretKeySource = config.secretKey ? "from config" : process.env.LANGFUSE_SECRET_KEY ? "from env" : "missing";
+			this.setDisabled(`${LOG_PREFIX} Missing required credentials (publicKey: ${publicKeySource}, secretKey: ${secretKeySource}). Set LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY environment variables or pass them in config.`);
+			return;
+		}
+		this.#processor = new _langfuse_otel.LangfuseSpanProcessor({
+			publicKey,
+			secretKey,
+			baseUrl,
+			environment: config.environment,
+			release: config.release,
+			exportMode: this.#realtime ? "immediate" : "batched",
+			flushAt: config.flushAt,
+			flushInterval: config.flushInterval,
+			shouldExportSpan: () => true
+		});
+		this.#client = new _langfuse_client.LangfuseClient({
+			publicKey,
+			secretKey,
+			baseUrl
+		});
+		this.#environment = config.environment ?? process.env.LANGFUSE_TRACING_ENVIRONMENT;
+		this.#release = config.release ?? process.env.LANGFUSE_RELEASE;
+	}
+	init(options) {
+		this.#spanConverter = new _mastra_otel_exporter.SpanConverter({
+			packageName: "@mastra/langfuse",
+			serviceName: options.config?.serviceName,
+			format: "GenAI_v1_38_0"
+		});
+	}
+	async _exportTracingEvent(event) {
+		if (event.type !== _mastra_core_observability.TracingEventType.SPAN_ENDED) return;
+		if (!this.#processor) return;
+		await this.exportSpan(event.exportedSpan);
+	}
+	async exportSpan(span) {
+		if (!this.#spanConverter) this.#spanConverter = new _mastra_otel_exporter.SpanConverter({
+			packageName: "@mastra/langfuse",
+			serviceName: "mastra-service",
+			format: "GenAI_v1_38_0"
+		});
+		try {
+			const otelSpan = await this.#spanConverter.convertSpan(span);
+			mapMastraToLangfuseAttributes(otelSpan.attributes, span, this.#environment, this.#release);
+			this.#processor.onEnd(otelSpan);
+		} catch (error) {
+			this.logger.error(`${LOG_PREFIX} Failed to export span ${span.id}:`, error);
+		}
+	}
+	/**
+	* The LangfuseClient instance for advanced Langfuse features.
+	* Use this for prompt management, evaluations, datasets, and direct API access.
+	*/
+	get client() {
+		return this.#client;
+	}
+	/**
+	* Submit a score to Langfuse. Used by both the new `onScoreEvent` path and the
+	* deprecated `addScoreToTrace` wrapper.
+	*/
+	submitScore(args) {
+		if (!this.#client) return;
+		const { id, traceId, spanId, name, value, comment, metadata } = args;
+		try {
+			this.#client.score.create({
+				id,
+				traceId,
+				...spanId ? { observationId: spanId } : {},
+				name,
+				value,
+				...comment ? { comment } : {},
+				...metadata ? { metadata } : {},
+				dataType: "NUMERIC"
+			});
+		} catch (error) {
+			this.logger.error(`${LOG_PREFIX} Error submitting score`, {
+				error,
+				traceId,
+				spanId,
+				name
+			});
+		}
+	}
+	async onScoreEvent(event) {
+		const { score } = event;
+		if (!score.traceId) return;
+		this.submitScore({
+			id: score.scoreId,
+			traceId: score.traceId,
+			spanId: score.spanId,
+			name: score.scorerName ?? score.scorerId,
+			value: score.score,
+			comment: score.reason,
+			metadata: score.metadata
+		});
+	}
+	/**
+	* @deprecated Use the observability score event pipeline (`mastra.observability.addScore`)
+	* instead. This method is preserved for backwards compatibility and forwards to the same
+	* underlying client call as `onScoreEvent`.
+	*/
+	async addScoreToTrace({ traceId, spanId, score, reason, scorerName, metadata }) {
+		this.submitScore({
+			id: `${traceId}-${spanId || ""}-${scorerName}`,
+			traceId,
+			spanId,
+			name: scorerName,
+			value: score,
+			comment: reason,
+			metadata
+		});
+	}
+	async flush() {
+		await Promise.all([this.#processor?.forceFlush(), this.#client?.flush()]);
+	}
+	async shutdown() {
+		await Promise.all([this.#processor?.shutdown(), this.#client?.shutdown()]);
+	}
 };
+/**
+* Maps Mastra-specific OTel attributes to the langfuse.* namespace that
+* Langfuse's OTLP endpoint reads for prompt linking, TTFT, and other features.
+*
+* SpanConverter produces attributes like mastra.metadata.*, mastra.completion_start_time, etc.
+* Langfuse's OTLP server only reads langfuse.observation.prompt.name, langfuse.observation.completion_start_time, etc.
+*
+* This function mutates the attributes object in place.
+* @see https://langfuse.com/integrations/native/opentelemetry#property-mapping
+*/
 function mapMastraToLangfuseAttributes(attributes, span, environment, release) {
-  if (environment) {
-    attributes["langfuse.environment"] = environment;
-  }
-  if (release) {
-    attributes["langfuse.release"] = release;
-  }
-  const langfuseMetadata = attributes["mastra.metadata.langfuse"];
-  if (langfuseMetadata) {
-    try {
-      const parsed = typeof langfuseMetadata === "string" ? JSON.parse(langfuseMetadata) : langfuseMetadata;
-      if (parsed && typeof parsed === "object") {
-        if (parsed.prompt) {
-          if (parsed.prompt.name !== void 0) {
-            attributes["langfuse.observation.prompt.name"] = parsed.prompt.name;
-          }
-          if (parsed.prompt.version !== void 0) {
-            attributes["langfuse.observation.prompt.version"] = parsed.prompt.version;
-          }
-        }
-        for (const [key, value] of Object.entries(parsed)) {
-          if (key === "prompt" || value === null || value === void 0) {
-            continue;
-          }
-          const traceKey = `langfuse.trace.metadata.${key}`;
-          if (attributes[traceKey] === void 0) {
-            attributes[traceKey] = typeof value === "string" ? value : JSON.stringify(value);
-          }
-        }
-      }
-    } catch {
-    }
-    delete attributes["mastra.metadata.langfuse"];
-  }
-  if (attributes["mastra.completion_start_time"]) {
-    attributes["langfuse.observation.completion_start_time"] = attributes["mastra.completion_start_time"];
-    delete attributes["mastra.completion_start_time"];
-  }
-  if (attributes["mastra.metadata.userId"]) {
-    attributes["user.id"] = attributes["mastra.metadata.userId"];
-    delete attributes["mastra.metadata.userId"];
-  }
-  const sessionId = attributes["mastra.metadata.sessionId"] ?? attributes["mastra.metadata.threadId"];
-  if (sessionId) {
-    attributes["session.id"] = sessionId;
-    delete attributes["mastra.metadata.sessionId"];
-    delete attributes["mastra.metadata.threadId"];
-  }
-  if (attributes["mastra.tags"]) {
-    attributes["langfuse.trace.tags"] = attributes["mastra.tags"];
-    delete attributes["mastra.tags"];
-  }
-  if (attributes["mastra.metadata.traceName"]) {
-    attributes["langfuse.trace.name"] = attributes["mastra.metadata.traceName"];
-    delete attributes["mastra.metadata.traceName"];
-  }
-  if (attributes["mastra.metadata.version"]) {
-    attributes["langfuse.trace.version"] = attributes["mastra.metadata.version"];
-    delete attributes["mastra.metadata.version"];
-  }
-  if (span.isRootSpan) {
-    if (span.type === observability$1.SpanType.AGENT_RUN) {
-      if (!attributes["langfuse.trace.name"] && (span.entityName || span.entityId)) {
-        attributes["langfuse.trace.name"] = span.entityName ?? span.entityId;
-      }
-      if (span.entityId) {
-        attributes["langfuse.trace.metadata.agentId"] = span.entityId;
-      }
-      if (span.entityName) {
-        attributes["langfuse.trace.metadata.agentName"] = span.entityName;
-      }
-    } else if (span.type === observability$1.SpanType.WORKFLOW_RUN) {
-      if (!attributes["langfuse.trace.name"] && (span.entityName || span.entityId)) {
-        attributes["langfuse.trace.name"] = span.entityName ?? span.entityId;
-      }
-      if (span.entityId) {
-        attributes["langfuse.trace.metadata.workflowId"] = span.entityId;
-      }
-      if (span.entityName) {
-        attributes["langfuse.trace.metadata.workflowName"] = span.entityName;
-      }
-    }
-  }
-  if (attributes["gen_ai.agent.id"]) {
-    attributes["langfuse.observation.metadata.agentId"] = attributes["gen_ai.agent.id"];
-  }
-  if (attributes["gen_ai.agent.name"]) {
-    attributes["langfuse.observation.metadata.agentName"] = attributes["gen_ai.agent.name"];
-  }
-  if (attributes["mastra.span.type"]) {
-    attributes["langfuse.observation.metadata.spanType"] = attributes["mastra.span.type"];
-  }
-  if (attributes["gen_ai.operation.name"]) {
-    attributes["langfuse.observation.metadata.operationName"] = attributes["gen_ai.operation.name"];
-  }
-  if (!attributes["gen_ai.input.messages"] && !attributes["gen_ai.tool.call.arguments"]) {
-    for (const key of Object.keys(attributes)) {
-      if (key.startsWith("mastra.") && key.endsWith(".input")) {
-        attributes["langfuse.observation.input"] = attributes[key];
-        break;
-      }
-    }
-  }
-  if (!attributes["gen_ai.output.messages"] && !attributes["gen_ai.tool.call.result"]) {
-    for (const key of Object.keys(attributes)) {
-      if (key.startsWith("mastra.") && key.endsWith(".output")) {
-        attributes["langfuse.observation.output"] = attributes[key];
-        break;
-      }
-    }
-  }
+	if (environment) attributes["langfuse.environment"] = environment;
+	if (release) attributes["langfuse.release"] = release;
+	const langfuseMetadata = attributes["mastra.metadata.langfuse"];
+	if (langfuseMetadata) {
+		try {
+			const parsed = typeof langfuseMetadata === "string" ? JSON.parse(langfuseMetadata) : langfuseMetadata;
+			if (parsed && typeof parsed === "object") {
+				if (parsed.prompt) {
+					if (parsed.prompt.name !== void 0) attributes["langfuse.observation.prompt.name"] = parsed.prompt.name;
+					if (parsed.prompt.version !== void 0) attributes["langfuse.observation.prompt.version"] = parsed.prompt.version;
+				}
+				for (const [key, value] of Object.entries(parsed)) {
+					if (key === "prompt" || value === null || value === void 0) continue;
+					const traceKey = `langfuse.trace.metadata.${key}`;
+					if (attributes[traceKey] === void 0) attributes[traceKey] = typeof value === "string" ? value : JSON.stringify(value);
+				}
+			}
+		} catch {}
+		delete attributes["mastra.metadata.langfuse"];
+	}
+	if (attributes["mastra.completion_start_time"]) {
+		attributes["langfuse.observation.completion_start_time"] = attributes["mastra.completion_start_time"];
+		delete attributes["mastra.completion_start_time"];
+	}
+	if (attributes["mastra.metadata.userId"]) {
+		attributes["user.id"] = attributes["mastra.metadata.userId"];
+		delete attributes["mastra.metadata.userId"];
+	}
+	const sessionId = attributes["mastra.metadata.sessionId"] ?? attributes["mastra.metadata.threadId"];
+	if (sessionId) {
+		attributes["session.id"] = sessionId;
+		delete attributes["mastra.metadata.sessionId"];
+		delete attributes["mastra.metadata.threadId"];
+	}
+	if (attributes["mastra.tags"]) {
+		attributes["langfuse.trace.tags"] = attributes["mastra.tags"];
+		delete attributes["mastra.tags"];
+	}
+	if (attributes["mastra.metadata.traceName"]) {
+		attributes["langfuse.trace.name"] = attributes["mastra.metadata.traceName"];
+		delete attributes["mastra.metadata.traceName"];
+	}
+	if (attributes["mastra.metadata.version"]) {
+		attributes["langfuse.trace.version"] = attributes["mastra.metadata.version"];
+		delete attributes["mastra.metadata.version"];
+	}
+	if (span.isRootSpan) {
+		if (span.type === _mastra_core_observability.SpanType.AGENT_RUN) {
+			if (!attributes["langfuse.trace.name"] && (span.entityName || span.entityId)) attributes["langfuse.trace.name"] = span.entityName ?? span.entityId;
+			if (span.entityId) attributes["langfuse.trace.metadata.agentId"] = span.entityId;
+			if (span.entityName) attributes["langfuse.trace.metadata.agentName"] = span.entityName;
+		} else if (span.type === _mastra_core_observability.SpanType.WORKFLOW_RUN) {
+			if (!attributes["langfuse.trace.name"] && (span.entityName || span.entityId)) attributes["langfuse.trace.name"] = span.entityName ?? span.entityId;
+			if (span.entityId) attributes["langfuse.trace.metadata.workflowId"] = span.entityId;
+			if (span.entityName) attributes["langfuse.trace.metadata.workflowName"] = span.entityName;
+		}
+	}
+	if (attributes["gen_ai.agent.id"]) attributes["langfuse.observation.metadata.agentId"] = attributes["gen_ai.agent.id"];
+	if (attributes["gen_ai.agent.name"]) attributes["langfuse.observation.metadata.agentName"] = attributes["gen_ai.agent.name"];
+	if (attributes["mastra.span.type"]) attributes["langfuse.observation.metadata.spanType"] = attributes["mastra.span.type"];
+	if (attributes["gen_ai.operation.name"]) attributes["langfuse.observation.metadata.operationName"] = attributes["gen_ai.operation.name"];
+	if (!attributes["gen_ai.input.messages"] && !attributes["gen_ai.tool.call.arguments"]) {
+		for (const key of Object.keys(attributes)) if (key.startsWith("mastra.") && key.endsWith(".input")) {
+			attributes["langfuse.observation.input"] = attributes[key];
+			break;
+		}
+	}
+	if (!attributes["gen_ai.output.messages"] && !attributes["gen_ai.tool.call.result"]) {
+		for (const key of Object.keys(attributes)) if (key.startsWith("mastra.") && key.endsWith(".output")) {
+			attributes["langfuse.observation.output"] = attributes[key];
+			break;
+		}
+	}
 }
+/**
+* Remove trailing "/" characters procedurally. Avoids polynomial
+* backtracking that a greedy regex like `/\/+$/` can exhibit when the
+* input is attacker-controlled.
+*/
 function stripTrailingSlashes(s) {
-  let end = s.length;
-  while (end > 0 && s.charCodeAt(end - 1) === 47) {
-    end--;
-  }
-  return end === s.length ? s : s.slice(0, end);
+	let end = s.length;
+	while (end > 0 && s.charCodeAt(end - 1) === 47) end--;
+	return end === s.length ? s : s.slice(0, end);
 }
-
-// src/helpers.ts
+//#endregion
+//#region src/helpers.ts
+/**
+* Adds Langfuse prompt metadata to the tracing options
+* to enable Langfuse Prompt Tracing.
+*
+* The metadata is added under `metadata.langfuse.prompt` and includes:
+* - `name` - Prompt name (required for Langfuse v5)
+* - `version` - Prompt version (required for Langfuse v5)
+*
+* All fields are deeply merged with any existing metadata.
+*
+* @param prompt - Prompt fields for linking (`name` and `version` required)
+* @returns A TracingOptionsUpdater function for use with `buildTracingOptions`
+*
+* @example
+* ```typescript
+* import { buildTracingOptions } from '@mastra/observability';
+* import { withLangfusePrompt } from '@mastra/langfuse';
+*
+* // Link a generation to a Langfuse prompt by name and version
+* const tracingOptions = buildTracingOptions(
+*   withLangfusePrompt({ name: 'customer-support', version: 1 }),
+* );
+*
+* // Or directly in agent config
+* const agent = new Agent({
+*   name: 'support-agent',
+*   instructions: 'You are a helpful assistant',
+*   model: openai('gpt-4o'),
+*   defaultGenerateOptions: {
+*     tracingOptions: buildTracingOptions(
+*       withLangfusePrompt({ name: 'my-prompt', version: 1 }),
+*     ),
+*   },
+* });
+* ```
+*/
 function withLangfusePrompt(prompt) {
-  return (opts) => ({
-    ...opts,
-    metadata: {
-      ...opts.metadata,
-      langfuse: {
-        ...opts.metadata?.langfuse,
-        prompt: {
-          ...prompt.name !== void 0 && { name: prompt.name },
-          ...prompt.version !== void 0 && { version: prompt.version },
-          ...prompt.id !== void 0 && { id: prompt.id }
-        }
-      }
-    }
-  });
+	return (opts) => ({
+		...opts,
+		metadata: {
+			...opts.metadata,
+			langfuse: {
+				...opts.metadata?.langfuse,
+				prompt: {
+					...prompt.name !== void 0 && { name: prompt.name },
+					...prompt.version !== void 0 && { version: prompt.version },
+					...prompt.id !== void 0 && { id: prompt.id }
+				}
+			}
+		}
+	});
 }
-
+//#endregion
 exports.LANGFUSE_DEFAULT_BASE_URL = LANGFUSE_DEFAULT_BASE_URL;
 exports.LangfuseExporter = LangfuseExporter;
 exports.withLangfusePrompt = withLangfusePrompt;
-//# sourceMappingURL=index.cjs.map
+
 //# sourceMappingURL=index.cjs.map