@langfuse/tracing 4.0.0-beta.2 → 4.0.0-beta.4

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _opentelemetry_api from '@opentelemetry/api';
-import { Span, TimeInput, Attributes, SpanContext } from '@opentelemetry/api';
+import { Span, TimeInput, Attributes, TracerProvider, SpanContext } from '@opentelemetry/api';
 import { OpenAiUsage } from '@langfuse/core';
 export { LangfuseOtelSpanAttributes } from '@langfuse/core';
 
@@ -444,6 +444,90 @@ declare function createSpanAttributes({ metadata, input, output, level, statusMe
  */
 declare function createGenerationAttributes({ completionStartTime, metadata, level, statusMessage, version, model, modelParameters, input, output, usageDetails, costDetails, prompt, }: LangfuseGenerationAttributes): Attributes;
 
+/**
+ * Sets an isolated TracerProvider for Langfuse tracing operations.
+ *
+ * This allows Langfuse to use its own TracerProvider instance, separate from
+ * the global OpenTelemetry TracerProvider. This is useful for avoiding conflicts
+ * with other OpenTelemetry instrumentation in the application.
+ *
+ * ⚠️  **Limitation: Span Context Sharing**
+ *
+ * While this function isolates span processing and export, it does NOT provide
+ * complete trace isolation. OpenTelemetry context (trace IDs, parent spans) is
+ * still shared between the global and isolated providers. This means:
+ *
+ * - Spans created with the isolated provider inherit trace IDs from global spans
+ * - Spans created with the isolated provider inherit parent relationships from global spans
+ * - This can result in spans from different providers being part of the same logical trace
+ *
+ * **Why this happens:**
+ * OpenTelemetry uses a global context propagation mechanism that operates at the
+ * JavaScript runtime level, independent of individual TracerProvider instances.
+ * The context (containing trace ID, span ID) flows through async boundaries and
+ * is inherited by all spans created within that context, regardless of which
+ * TracerProvider creates them.
+ *
+ * @example
+ * ```typescript
+ * import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+ * import { LangfuseSpanProcessor } from '@langfuse/otel';
+ * import { setLangfuseTracerProvider } from '@langfuse/tracing';
+ *
+ * // Create provider with span processors in constructor
+ * const provider = new NodeTracerProvider({
+ *   spanProcessors: [new LangfuseSpanProcessor()]
+ * });
+ *
+ * setLangfuseTracerProvider(provider);
+ *
+ * // Note: Spans created with getLangfuseTracer() may still inherit
+ * // context from spans created with the global tracer
+ * ```
+ *
+ * @param provider - The TracerProvider instance to use, or null to clear the isolated provider
+ * @public
+ */
+declare function setLangfuseTracerProvider(provider: TracerProvider | null): void;
+/**
+ * Gets the TracerProvider for Langfuse tracing operations.
+ *
+ * Returns the isolated TracerProvider if one has been set via setLangfuseTracerProvider(),
+ * otherwise falls back to the global OpenTelemetry TracerProvider.
+ *
+ * @example
+ * ```typescript
+ * import { getLangfuseTracerProvider } from '@langfuse/tracing';
+ *
+ * const provider = getLangfuseTracerProvider();
+ * const tracer = provider.getTracer('my-tracer', '1.0.0');
+ * ```
+ *
+ * @returns The TracerProvider instance to use for Langfuse tracing
+ * @public
+ */
+declare function getLangfuseTracerProvider(): TracerProvider;
+/**
+ * Gets the OpenTelemetry tracer instance for Langfuse.
+ *
+ * This function returns a tracer specifically configured for Langfuse
+ * with the correct tracer name and version. Used internally by all
+ * Langfuse tracing functions to ensure consistent trace creation.
+ *
+ * @returns The Langfuse OpenTelemetry tracer instance
+ *
+ * @example
+ * ```typescript
+ * import { getLangfuseTracer } from '@langfuse/tracing';
+ *
+ * const tracer = getLangfuseTracer();
+ * const span = tracer.startSpan('my-operation');
+ * ```
+ *
+ * @public
+ */
+declare function getLangfuseTracer(): _opentelemetry_api.Tracer;
+
 /**
  * Options for starting observations (spans, generations, events).
  *
@@ -455,6 +539,17 @@ type StartObservationOptions = {
     /** Parent span context to attach this observation to */
     parentSpanContext?: SpanContext;
 };
+/**
+ * Options for starting an observations set to active in context
+ *
+ * Extends StartObservationOptions with additional context-specific configuration.
+ *
+ * @public
+ */
+type StartActiveObservationContext = StartObservationOptions & {
+    /** Whether to automatically end the observation when exiting the context. Default is true */
+    endOnExit?: boolean;
+};
 /**
  * Creates and starts a new Langfuse span for general-purpose tracing.
  *
@@ -614,7 +709,7 @@ declare function createEvent(name: string, attributes?: LangfuseEventAttributes,
  *
  * @public
  */
-declare function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F>;
+declare function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(name: string, fn: F, options?: StartActiveObservationContext): ReturnType<F>;
 /**
  * Starts an active generation and executes a function within its context.
  *
@@ -650,7 +745,7 @@ declare function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(name
  *
  * @public
  */
-declare function startActiveGeneration<F extends (span: LangfuseGeneration) => unknown>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F>;
+declare function startActiveGeneration<F extends (span: LangfuseGeneration) => unknown>(name: string, fn: F, options?: StartActiveObservationContext): ReturnType<F>;
 /**
  * Updates the currently active trace with new attributes.
  *
@@ -739,6 +834,10 @@ interface ObserveOptions {
     captureInput?: boolean;
     /** Whether to capture function output as observation output */
     captureOutput?: boolean;
+    /** Parent span context to attach this observation to */
+    parentSpanContext?: SpanContext;
+    /** Whether to automatically end the observation when exiting the context. Default is true */
+    endOnExit?: boolean;
 }
 /**
  * Decorator function that automatically wraps a function with Langfuse tracing.
@@ -843,5 +942,25 @@ declare function observe<T extends (...args: unknown[]) => unknown>(fn: T, optio
  * @public
  */
 declare function createTraceId(seed?: string): Promise<string>;
+/**
+ * Gets the current active trace ID.
+ *
+ * If there is no span in the current context, returns undefined.
+ *
+ * @returns The trace ID of the currently active span, or undefined if no span is active
+ *
+ * @public
+ */
+declare function getActiveTraceId(): string | undefined;
+/**
+ * Gets the current active observation ID.
+ *
+ * If there is no OTEL span in the current context, returns undefined.
+ *
+ * @returns The ID of the currently active OTEL span, or undefined if no OTEL span is active
+ *
+ * @public
+ */
+declare function getActiveSpanId(): string | undefined;
 
-export { type LangfuseAttributes, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, type LangfuseObservation, type LangfuseObservationType, LangfuseSpan, type LangfuseSpanAttributes, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartObservationOptions, createEvent, createGenerationAttributes, createSpanAttributes, createTraceAttributes, createTraceId, observe, startActiveGeneration, startActiveSpan, startGeneration, startSpan, updateActiveGeneration, updateActiveSpan, updateActiveTrace };
+export { type LangfuseAttributes, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, type LangfuseObservation, type LangfuseObservationType, LangfuseSpan, type LangfuseSpanAttributes, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartActiveObservationContext, type StartObservationOptions, createEvent, createGenerationAttributes, createSpanAttributes, createTraceAttributes, createTraceId, getActiveSpanId, getActiveTraceId, getLangfuseTracer, getLangfuseTracerProvider, observe, setLangfuseTracerProvider, startActiveGeneration, startActiveSpan, startGeneration, startSpan, updateActiveGeneration, updateActiveSpan, updateActiveTrace };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _opentelemetry_api from '@opentelemetry/api';
-import { Span, TimeInput, Attributes, SpanContext } from '@opentelemetry/api';
+import { Span, TimeInput, Attributes, TracerProvider, SpanContext } from '@opentelemetry/api';
 import { OpenAiUsage } from '@langfuse/core';
 export { LangfuseOtelSpanAttributes } from '@langfuse/core';
 
@@ -444,6 +444,90 @@ declare function createSpanAttributes({ metadata, input, output, level, statusMe
  */
 declare function createGenerationAttributes({ completionStartTime, metadata, level, statusMessage, version, model, modelParameters, input, output, usageDetails, costDetails, prompt, }: LangfuseGenerationAttributes): Attributes;
 
+/**
+ * Sets an isolated TracerProvider for Langfuse tracing operations.
+ *
+ * This allows Langfuse to use its own TracerProvider instance, separate from
+ * the global OpenTelemetry TracerProvider. This is useful for avoiding conflicts
+ * with other OpenTelemetry instrumentation in the application.
+ *
+ * ⚠️  **Limitation: Span Context Sharing**
+ *
+ * While this function isolates span processing and export, it does NOT provide
+ * complete trace isolation. OpenTelemetry context (trace IDs, parent spans) is
+ * still shared between the global and isolated providers. This means:
+ *
+ * - Spans created with the isolated provider inherit trace IDs from global spans
+ * - Spans created with the isolated provider inherit parent relationships from global spans
+ * - This can result in spans from different providers being part of the same logical trace
+ *
+ * **Why this happens:**
+ * OpenTelemetry uses a global context propagation mechanism that operates at the
+ * JavaScript runtime level, independent of individual TracerProvider instances.
+ * The context (containing trace ID, span ID) flows through async boundaries and
+ * is inherited by all spans created within that context, regardless of which
+ * TracerProvider creates them.
+ *
+ * @example
+ * ```typescript
+ * import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+ * import { LangfuseSpanProcessor } from '@langfuse/otel';
+ * import { setLangfuseTracerProvider } from '@langfuse/tracing';
+ *
+ * // Create provider with span processors in constructor
+ * const provider = new NodeTracerProvider({
+ *   spanProcessors: [new LangfuseSpanProcessor()]
+ * });
+ *
+ * setLangfuseTracerProvider(provider);
+ *
+ * // Note: Spans created with getLangfuseTracer() may still inherit
+ * // context from spans created with the global tracer
+ * ```
+ *
+ * @param provider - The TracerProvider instance to use, or null to clear the isolated provider
+ * @public
+ */
+declare function setLangfuseTracerProvider(provider: TracerProvider | null): void;
+/**
+ * Gets the TracerProvider for Langfuse tracing operations.
+ *
+ * Returns the isolated TracerProvider if one has been set via setLangfuseTracerProvider(),
+ * otherwise falls back to the global OpenTelemetry TracerProvider.
+ *
+ * @example
+ * ```typescript
+ * import { getLangfuseTracerProvider } from '@langfuse/tracing';
+ *
+ * const provider = getLangfuseTracerProvider();
+ * const tracer = provider.getTracer('my-tracer', '1.0.0');
+ * ```
+ *
+ * @returns The TracerProvider instance to use for Langfuse tracing
+ * @public
+ */
+declare function getLangfuseTracerProvider(): TracerProvider;
+/**
+ * Gets the OpenTelemetry tracer instance for Langfuse.
+ *
+ * This function returns a tracer specifically configured for Langfuse
+ * with the correct tracer name and version. Used internally by all
+ * Langfuse tracing functions to ensure consistent trace creation.
+ *
+ * @returns The Langfuse OpenTelemetry tracer instance
+ *
+ * @example
+ * ```typescript
+ * import { getLangfuseTracer } from '@langfuse/tracing';
+ *
+ * const tracer = getLangfuseTracer();
+ * const span = tracer.startSpan('my-operation');
+ * ```
+ *
+ * @public
+ */
+declare function getLangfuseTracer(): _opentelemetry_api.Tracer;
+
 /**
  * Options for starting observations (spans, generations, events).
  *
@@ -455,6 +539,17 @@ type StartObservationOptions = {
     /** Parent span context to attach this observation to */
     parentSpanContext?: SpanContext;
 };
+/**
+ * Options for starting an observations set to active in context
+ *
+ * Extends StartObservationOptions with additional context-specific configuration.
+ *
+ * @public
+ */
+type StartActiveObservationContext = StartObservationOptions & {
+    /** Whether to automatically end the observation when exiting the context. Default is true */
+    endOnExit?: boolean;
+};
 /**
  * Creates and starts a new Langfuse span for general-purpose tracing.
  *
@@ -614,7 +709,7 @@ declare function createEvent(name: string, attributes?: LangfuseEventAttributes,
  *
  * @public
  */
-declare function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F>;
+declare function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(name: string, fn: F, options?: StartActiveObservationContext): ReturnType<F>;
 /**
  * Starts an active generation and executes a function within its context.
  *
@@ -650,7 +745,7 @@ declare function startActiveSpan<F extends (span: LangfuseSpan) => unknown>(name
  *
  * @public
  */
-declare function startActiveGeneration<F extends (span: LangfuseGeneration) => unknown>(name: string, fn: F, options?: StartObservationOptions): ReturnType<F>;
+declare function startActiveGeneration<F extends (span: LangfuseGeneration) => unknown>(name: string, fn: F, options?: StartActiveObservationContext): ReturnType<F>;
 /**
  * Updates the currently active trace with new attributes.
  *
@@ -739,6 +834,10 @@ interface ObserveOptions {
     captureInput?: boolean;
     /** Whether to capture function output as observation output */
     captureOutput?: boolean;
+    /** Parent span context to attach this observation to */
+    parentSpanContext?: SpanContext;
+    /** Whether to automatically end the observation when exiting the context. Default is true */
+    endOnExit?: boolean;
 }
 /**
  * Decorator function that automatically wraps a function with Langfuse tracing.
@@ -843,5 +942,25 @@ declare function observe<T extends (...args: unknown[]) => unknown>(fn: T, optio
  * @public
  */
 declare function createTraceId(seed?: string): Promise<string>;
+/**
+ * Gets the current active trace ID.
+ *
+ * If there is no span in the current context, returns undefined.
+ *
+ * @returns The trace ID of the currently active span, or undefined if no span is active
+ *
+ * @public
+ */
+declare function getActiveTraceId(): string | undefined;
+/**
+ * Gets the current active observation ID.
+ *
+ * If there is no OTEL span in the current context, returns undefined.
+ *
+ * @returns The ID of the currently active OTEL span, or undefined if no OTEL span is active
+ *
+ * @public
+ */
+declare function getActiveSpanId(): string | undefined;
 
-export { type LangfuseAttributes, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, type LangfuseObservation, type LangfuseObservationType, LangfuseSpan, type LangfuseSpanAttributes, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartObservationOptions, createEvent, createGenerationAttributes, createSpanAttributes, createTraceAttributes, createTraceId, observe, startActiveGeneration, startActiveSpan, startGeneration, startSpan, updateActiveGeneration, updateActiveSpan, updateActiveTrace };
+export { type LangfuseAttributes, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, type LangfuseObservation, type LangfuseObservationType, LangfuseSpan, type LangfuseSpanAttributes, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartActiveObservationContext, type StartObservationOptions, createEvent, createGenerationAttributes, createSpanAttributes, createTraceAttributes, createTraceId, getActiveSpanId, getActiveTraceId, getLangfuseTracer, getLangfuseTracerProvider, observe, setLangfuseTracerProvider, startActiveGeneration, startActiveSpan, startGeneration, startSpan, updateActiveGeneration, updateActiveSpan, updateActiveTrace };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/index.ts
-import { getGlobalLogger } from "@langfuse/core";
+import { getGlobalLogger as getGlobalLogger2 } from "@langfuse/core";
 import {
   trace as trace2,
   context,
@@ -145,11 +145,61 @@ function _flattenAndSerializeMetadata(metadata, type) {
   return metadataAttributes;
 }
 
-// src/utils.ts
-import { LANGFUSE_SDK_VERSION, LANGFUSE_TRACER_NAME } from "@langfuse/core";
+// src/tracerProvider.ts
+import {
+  getGlobalLogger,
+  LANGFUSE_SDK_VERSION,
+  LANGFUSE_TRACER_NAME
+} from "@langfuse/core";
 import { trace } from "@opentelemetry/api";
+var LANGFUSE_GLOBAL_SYMBOL = Symbol.for("langfuse");
+function createState() {
+  return {
+    isolatedTracerProvider: null
+  };
+}
+function getGlobalState() {
+  const initialState = createState();
+  try {
+    const g = globalThis;
+    if (typeof g !== "object" || g === null) {
+      getGlobalLogger().warn(
+        "globalThis is not available, using fallback state"
+      );
+      return initialState;
+    }
+    if (!g[LANGFUSE_GLOBAL_SYMBOL]) {
+      Object.defineProperty(g, LANGFUSE_GLOBAL_SYMBOL, {
+        value: initialState,
+        writable: false,
+        // lock the slot (not the contents)
+        configurable: false,
+        enumerable: false
+      });
+    }
+    return g[LANGFUSE_GLOBAL_SYMBOL];
+  } catch (err) {
+    if (err instanceof Error) {
+      getGlobalLogger().error(`Failed to access global state: ${err.message}`);
+    } else {
+      getGlobalLogger().error(`Failed to access global state: ${String(err)}`);
+    }
+    return initialState;
+  }
+}
+function setLangfuseTracerProvider(provider) {
+  getGlobalState().isolatedTracerProvider = provider;
+}
+function getLangfuseTracerProvider() {
+  const { isolatedTracerProvider } = getGlobalState();
+  if (isolatedTracerProvider) return isolatedTracerProvider;
+  return trace.getTracerProvider();
+}
 function getLangfuseTracer() {
-  return trace.getTracer(LANGFUSE_TRACER_NAME, LANGFUSE_SDK_VERSION);
+  return getLangfuseTracerProvider().getTracer(
+    LANGFUSE_TRACER_NAME,
+    LANGFUSE_SDK_VERSION
+  );
 }
 
 // src/spanWrapper.ts
@@ -353,17 +403,22 @@ function createParentContext(parentSpanContext) {
   if (!parentSpanContext) return;
   return trace2.setSpanContext(context.active(), parentSpanContext);
 }
-function wrapPromise(promise, span) {
+function wrapPromise(promise, span, endOnExit) {
   return promise.then(
     (value) => {
-      span.end();
+      if (endOnExit !== false) {
+        span.end();
+      }
       return value;
     },
     (err) => {
       span.setStatus({
         code: SpanStatusCode.ERROR,
         message: err instanceof Error ? err.message : "Unknown error"
-      }).end();
+      });
+      if (endOnExit !== false) {
+        span.end();
+      }
       throw err;
     }
   );
@@ -402,16 +457,21 @@ function startActiveSpan(name, fn, options) {
       try {
         const result = fn(new LangfuseSpan({ otelSpan: span }));
         if (result instanceof Promise) {
-          return wrapPromise(result, span);
+          return wrapPromise(result, span, options == null ? void 0 : options.endOnExit);
         } else {
-          span.end();
+          if ((options == null ? void 0 : options.endOnExit) !== false) {
+            span.end();
+          }
           return result;
         }
       } catch (err) {
         span.setStatus({
           code: SpanStatusCode.ERROR,
           message: err instanceof Error ? err.message : "Unknown error"
-        }).end();
+        });
+        if ((options == null ? void 0 : options.endOnExit) !== false) {
+          span.end();
+        }
         throw err;
       }
     }
@@ -427,16 +487,21 @@ function startActiveGeneration(name, fn, options) {
       try {
         const result = fn(new LangfuseGeneration({ otelSpan: span }));
         if (result instanceof Promise) {
-          return wrapPromise(result, span);
+          return wrapPromise(result, span, options == null ? void 0 : options.endOnExit);
         } else {
-          span.end();
+          if ((options == null ? void 0 : options.endOnExit) !== false) {
+            span.end();
+          }
           return result;
         }
       } catch (err) {
         span.setStatus({
           code: SpanStatusCode.ERROR,
           message: err instanceof Error ? err.message : "Unknown error"
-        }).end();
+        });
+        if ((options == null ? void 0 : options.endOnExit) !== false) {
+          span.end();
+        }
         throw err;
       }
     }
@@ -445,7 +510,7 @@ function startActiveGeneration(name, fn, options) {
 function updateActiveTrace(attributes) {
   const span = trace2.getActiveSpan();
   if (!span) {
-    getGlobalLogger().warn(
+    getGlobalLogger2().warn(
       "No active OTEL span in context. Skipping trace update."
     );
     return;
@@ -455,7 +520,7 @@ function updateActiveTrace(attributes) {
 function updateActiveSpan(attributes) {
   const span = trace2.getActiveSpan();
   if (!span) {
-    getGlobalLogger().warn(
+    getGlobalLogger2().warn(
       "No active OTEL span in context. Skipping span update."
     );
     return;
@@ -465,7 +530,7 @@ function updateActiveSpan(attributes) {
 function updateActiveGeneration(attributes) {
   const span = trace2.getActiveSpan();
   if (!span) {
-    getGlobalLogger().warn(
+    getGlobalLogger2().warn(
       "No active OTEL span in context. Skipping generation update."
     );
     return;
@@ -477,21 +542,28 @@ function observe(fn, options = {}) {
     name = fn.name || "anonymous-function",
     asType = "span",
     captureInput = true,
-    captureOutput = true
+    captureOutput = true,
+    parentSpanContext = void 0
   } = options;
-  const wrappedFunction = (...args) => {
+  const wrappedFunction = function(...args) {
     const inputData = captureInput ? _captureArguments(args) : void 0;
-    const observation = asType === "generation" ? startGeneration(name, inputData ? { input: inputData } : {}) : startSpan(name, inputData ? { input: inputData } : {});
+    const observation = asType === "generation" ? startGeneration(name, inputData ? { input: inputData } : {}, {
+      parentSpanContext
+    }) : startSpan(name, inputData ? { input: inputData } : {}, {
+      parentSpanContext
+    });
     const activeContext = trace2.setSpan(context.active(), observation.otelSpan);
     try {
-      const result = context.with(activeContext, () => fn(...args));
+      const result = context.with(activeContext, () => fn.apply(this, args));
       if (result instanceof Promise) {
         return result.then(
           (value) => {
             if (captureOutput) {
               observation.update({ output: _captureOutput(value) });
             }
-            observation.end();
+            if ((options == null ? void 0 : options.endOnExit) !== false) {
+              observation.end();
+            }
             return value;
           },
           (error) => {
@@ -499,7 +571,10 @@ function observe(fn, options = {}) {
               level: "ERROR",
               statusMessage: (error instanceof Error ? error.message : String(error)) || "Function threw an error",
               output: captureOutput ? { error: String(error) } : void 0
-            }).end();
+            });
+            if ((options == null ? void 0 : options.endOnExit) !== false) {
+              observation.end();
+            }
             throw error;
           }
         );
@@ -507,7 +582,9 @@ function observe(fn, options = {}) {
         if (captureOutput) {
           observation.update({ output: _captureOutput(result) });
         }
-        observation.end();
+        if ((options == null ? void 0 : options.endOnExit) !== false) {
+          observation.end();
+        }
         return result;
       }
     } catch (error) {
@@ -515,7 +592,10 @@ function observe(fn, options = {}) {
         level: "ERROR",
         statusMessage: (error instanceof Error ? error.message : String(error)) || "Function threw an error",
         output: captureOutput ? { error: String(error) } : void 0
-      }).end();
+      });
+      if ((options == null ? void 0 : options.endOnExit) !== false) {
+        observation.end();
+      }
       throw error;
     }
   };
@@ -552,6 +632,14 @@ async function createTraceId(seed) {
 function uint8ArrayToHex(array) {
   return Array.from(array).map((b) => b.toString(16).padStart(2, "0")).join("");
 }
+function getActiveTraceId() {
+  var _a;
+  return (_a = trace2.getActiveSpan()) == null ? void 0 : _a.spanContext().traceId;
+}
+function getActiveSpanId() {
+  var _a;
+  return (_a = trace2.getActiveSpan()) == null ? void 0 : _a.spanContext().spanId;
+}
 export {
   LangfuseEvent,
   LangfuseGeneration,
@@ -562,7 +650,12 @@ export {
   createSpanAttributes,
   createTraceAttributes,
   createTraceId,
+  getActiveSpanId,
+  getActiveTraceId,
+  getLangfuseTracer,
+  getLangfuseTracerProvider,
   observe,
+  setLangfuseTracerProvider,
   startActiveGeneration,
   startActiveSpan,
   startGeneration,