@langfuse/core 4.4.10 → 4.5.0

package/dist/index.d.cts

@@ -7478,7 +7478,7 @@ declare class LangfuseMedia {
  * within the context.
  */
 
-type CorrelatedKey = "userId" | "sessionId" | "metadata" | "version" | "tags";
+type CorrelatedKey = "userId" | "sessionId" | "metadata" | "version" | "tags" | "traceName";
 declare const experimentKeys: readonly ["experimentId", "experimentName", "experimentMetadata", "experimentDatasetId", "experimentItemId", "experimentItemMetadata", "experimentItemRootObservationId"];
 type ExperimentKey = (typeof experimentKeys)[number];
 type PropagatedKey = CorrelatedKey | ExperimentKey;
@@ -7526,6 +7526,11 @@ interface PropagateAttributesParams {
      * List of tags to categorize the group of observations
      */
     tags?: string[];
+    /**
+     * Trace name to associate with all spans in this context.
+     * Must be a string ≤200 characters.
+     */
+    traceName?: string;
     /**
      * If true, propagates attributes using OpenTelemetry baggage for
      * cross-process/service propagation.

package/dist/index.d.ts

@@ -7478,7 +7478,7 @@ declare class LangfuseMedia {
  * within the context.
  */
 
-type CorrelatedKey = "userId" | "sessionId" | "metadata" | "version" | "tags";
+type CorrelatedKey = "userId" | "sessionId" | "metadata" | "version" | "tags" | "traceName";
 declare const experimentKeys: readonly ["experimentId", "experimentName", "experimentMetadata", "experimentDatasetId", "experimentItemId", "experimentItemMetadata", "experimentItemRootObservationId"];
 type ExperimentKey = (typeof experimentKeys)[number];
 type PropagatedKey = CorrelatedKey | ExperimentKey;
@@ -7526,6 +7526,11 @@ interface PropagateAttributesParams {
      * List of tags to categorize the group of observations
      */
     tags?: string[];
+    /**
+     * Trace name to associate with all spans in this context.
+     * Must be a string ≤200 characters.
+     */
+    traceName?: string;
     /**
      * If true, propagates attributes using OpenTelemetry baggage for
      * cross-process/service propagation.

package/dist/index.mjs

@@ -253,7 +253,7 @@ var resetGlobalLogger = () => {
 // package.json
 var package_default = {
   name: "@langfuse/core",
-  version: "4.4.10-alpha.3",
+  version: "4.4.10",
   description: "Core functions and utilities for Langfuse packages",
   type: "module",
   sideEffects: false,
@@ -11670,6 +11670,7 @@ var LangfuseOtelContextKeys = {
   metadata: createContextKey("langfuse_metadata"),
   version: createContextKey("langfuse_version"),
   tags: createContextKey("langfuse_tags"),
+  traceName: createContextKey("langfuse_trace_name"),
   // Experiments
   experimentId: createContextKey("langfuse_experiment_id"),
   experimentName: createContextKey("langfuse_experiment_name"),
@@ -11688,7 +11689,15 @@ function propagateAttributes(params, fn) {
   let context = otelContextApi.active();
   const span = otelTraceApi.getActiveSpan();
   const asBaggage = (_a2 = params.asBaggage) != null ? _a2 : false;
-  const { userId, sessionId, metadata, version, tags, _internalExperiment } = params;
+  const {
+    userId,
+    sessionId,
+    metadata,
+    version,
+    tags,
+    traceName,
+    _internalExperiment
+  } = params;
   if (userId) {
     if (isValidPropagatedString({ value: userId, attributeName: "userId" })) {
       context = setPropagatedAttribute({
@@ -11728,6 +11737,20 @@ function propagateAttributes(params, fn) {
       });
     }
   }
+  if (traceName) {
+    if (isValidPropagatedString({
+      value: traceName,
+      attributeName: "traceName"
+    })) {
+      context = setPropagatedAttribute({
+        key: "traceName",
+        value: traceName,
+        context,
+        span,
+        asBaggage
+      });
+    }
+  }
   if (tags && tags.length > 0) {
     const validTags = tags.filter(
       (tag) => isValidPropagatedString({
@@ -11809,6 +11832,11 @@ function getPropagatedAttributesFromContext(context) {
     const spanKey = getSpanKeyForPropagatedKey("version");
     propagatedAttributes[spanKey] = version;
   }
+  const traceName = context.getValue(LangfuseOtelContextKeys["traceName"]);
+  if (traceName && typeof traceName === "string") {
+    const spanKey = getSpanKeyForPropagatedKey("traceName");
+    propagatedAttributes[spanKey] = traceName;
+  }
   const tags = context.getValue(LangfuseOtelContextKeys["tags"]);
   if (tags && Array.isArray(tags)) {
     const spanKey = getSpanKeyForPropagatedKey("tags");
@@ -11927,6 +11955,8 @@ function getSpanKeyForPropagatedKey(key) {
       return "session.id" /* TRACE_SESSION_ID */;
     case "version":
       return "langfuse.version" /* VERSION */;
+    case "traceName":
+      return "langfuse.trace.name" /* TRACE_NAME */;
     case "metadata":
       return "langfuse.trace.metadata" /* TRACE_METADATA */;
     case "tags":
@@ -11959,6 +11989,8 @@ function getBaggageKeyForPropagatedKey(key) {
       return `${LANGFUSE_BAGGAGE_PREFIX}session_id`;
     case "version":
       return `${LANGFUSE_BAGGAGE_PREFIX}version`;
+    case "traceName":
+      return `${LANGFUSE_BAGGAGE_PREFIX}trace_name`;
     case "metadata":
       return `${LANGFUSE_BAGGAGE_PREFIX}metadata`;
     case "tags":
@@ -11997,6 +12029,8 @@ function getSpanKeyFromBaggageKey(baggageKey) {
       return getSpanKeyForPropagatedKey("sessionId");
     case "version":
       return getSpanKeyForPropagatedKey("version");
+    case "trace_name":
+      return getSpanKeyForPropagatedKey("traceName");
     case "tags":
       return getSpanKeyForPropagatedKey("tags");
     case "experiment_id":