@langfuse/tracing 4.6.0 → 5.0.0-beta.0

package/dist/index.d.cts

@@ -101,36 +101,22 @@ type LangfuseEmbeddingAttributes = LangfuseGenerationAttributes;
  */
 type LangfuseObservationAttributes = LangfuseSpanAttributes & LangfuseGenerationAttributes & LangfuseEventAttributes & LangfuseAgentAttributes & LangfuseToolAttributes & LangfuseChainAttributes & LangfuseRetrieverAttributes & LangfuseEvaluatorAttributes & LangfuseGuardrailAttributes;
 /**
- * Attributes for Langfuse traces.
+ * Attributes for setting trace-level input and output only.
  *
- * Traces are the top-level containers that group related observations together.
- * They represent a complete workflow, request, or user interaction.
+ * This is a restricted type used by the deprecated setTraceIO methods,
+ * which only allow setting input and output on traces for backward
+ * compatibility with legacy Langfuse platform features.
+ *
+ * @deprecated This type is for backward compatibility with legacy platform features
+ * that still rely on trace-level input/output. Use propagateAttributes for other trace attributes.
  *
  * @public
  */
 type LangfuseTraceAttributes = {
-    /** Human-readable name for the trace */
-    name?: string;
-    /** Identifier for the user associated with this trace */
-    userId?: string;
-    /** Session identifier for grouping related traces */
-    sessionId?: string;
-    /** Version identifier for the code/application */
-    version?: string;
-    /** Release identifier for deployment tracking */
-    release?: string;
     /** Input data that initiated the trace */
     input?: unknown;
     /** Final output data from the trace */
     output?: unknown;
-    /** Additional metadata for the trace */
-    metadata?: unknown;
-    /** Tags for categorizing and filtering traces */
-    tags?: string[];
-    /** Whether this trace should be publicly visible */
-    public?: boolean;
-    /** Environment where the trace was captured */
-    environment?: string;
 };
 
 /**
@@ -157,9 +143,6 @@ type LangfuseTraceAttributes = {
  * // Function accepting any observation type
  * function logObservation(obs: LangfuseObservation) {
  *   console.log(`Observation ${obs.id} in trace ${obs.traceId}`);
- *
- *   // All observations have common methods
- *   obs.updateTrace({ tags: ['logged'] });
  *   obs.end();
  * }
  *
@@ -209,7 +192,7 @@ type LangfuseObservationParams = {
  *
  * ## Common Methods
  * - `end()`: Marks the observation as complete with optional timestamp
- * - `updateTrace()`: Sets trace-level attributes like user ID, session ID, tags
+ * - `setTraceIO()`: Sets trace-level input/output (deprecated, for legacy platform features)
  * - `startObservation()`: Creates child observations with inherited context
  *
  * @example
@@ -222,13 +205,6 @@ type LangfuseObservationParams = {
  * console.log(`Trace ID: ${observation.traceId}`);
  * console.log(`Type: ${observation.type}`);
  *
- * // Common methods available on all observations
- * observation.updateTrace({
- *   userId: 'user-123',
- *   sessionId: 'session-456',
- *   tags: ['production', 'api-v2']
- * });
- *
  * // Create child observations
  * const child = observation.startObservation('child-operation', {
  *   input: { step: 'processing' }
@@ -261,9 +237,45 @@ declare abstract class LangfuseBaseObservation {
     end(endTime?: TimeInput): void;
     updateOtelSpanAttributes(attributes: LangfuseObservationAttributes): void;
     /**
-     * Updates the parent trace with new attributes.
+     * Set trace-level input and output for the trace this observation belongs to.
+     *
+     * @deprecated This is a legacy method for backward compatibility with Langfuse platform
+     * features that still rely on trace-level input/output (e.g., legacy LLM-as-a-judge
+     * evaluators). It will be removed in a future major version.
+     *
+     * For setting other trace attributes (userId, sessionId, metadata, tags, version),
+     * use {@link propagateAttributes} instead.
+     *
+     * @param attributes - Input and output data to associate with the trace
+     * @returns The observation instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * const span = startObservation('my-operation');
+     * span.setTraceIO({
+     *   input: { query: 'user question' },
+     *   output: { response: 'assistant answer' }
+     * });
+     * ```
+     */
+    setTraceIO(attributes: LangfuseTraceAttributes): this;
+    /**
+     * Make the trace this observation belongs to publicly accessible via its URL.
+     *
+     * When a trace is published, anyone with the trace link can view the full trace
+     * without needing to be logged in to Langfuse. This action cannot be undone
+     * programmatically - once any span in a trace is published, the entire trace
+     * becomes public.
+     *
+     * @returns The observation instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * const span = startObservation('my-operation');
+     * span.setTraceAsPublic();
+     * ```
      */
-    updateTrace(attributes: LangfuseTraceAttributes): this;
+    setTraceAsPublic(): this;
     /**
      * Creates a new child observation within this observation's context with full type safety.
      *
@@ -1358,32 +1370,20 @@ declare class LangfuseEvent extends LangfuseBaseObservation {
 }
 
 /**
- * Creates OpenTelemetry attributes from Langfuse trace attributes.
+ * Creates OpenTelemetry attributes from Langfuse trace IO attributes.
  *
- * Converts user-friendly trace attributes into the internal OpenTelemetry
+ * Converts trace input/output into the internal OpenTelemetry
  * attribute format required by the span processor.
  *
- * @param attributes - Langfuse trace attributes to convert
+ * @param attributes - Langfuse trace IO attributes to convert
  * @returns OpenTelemetry attributes object with non-null values
  *
- * @example
- * ```typescript
- * import { createTraceAttributes } from '@langfuse/tracing';
- *
- * const otelAttributes = createTraceAttributes({
- *   name: 'user-checkout-flow',
- *   userId: 'user-123',
- *   sessionId: 'session-456',
- *   tags: ['checkout', 'payment'],
- *   metadata: { version: '2.1.0' }
- * });
- *
- * span.setAttributes(otelAttributes);
- * ```
+ * @deprecated This is for backward compatibility with legacy platform features
+ * that still rely on trace-level input/output. Use propagateAttributes for other trace attributes.
  *
- * @public
+ * @internal
  */
-declare function createTraceAttributes({ name, userId, sessionId, version, release, input, output, metadata, tags, environment, public: isPublic, }?: LangfuseTraceAttributes): Attributes;
+declare function createTraceAttributes({ input, output, }?: LangfuseTraceAttributes): Attributes;
 declare function createObservationAttributes(type: LangfuseObservationType, attributes: LangfuseObservationAttributes): Attributes;
 
 /**
@@ -1568,30 +1568,57 @@ declare function startActiveObservation<F extends (span: LangfuseSpan) => unknow
     asType?: "span";
 }): ReturnType<F>;
 /**
- * Updates the currently active trace with new attributes.
+ * Set trace-level input and output for the currently active trace.
+ *
+ * This function finds the currently active OpenTelemetry span and sets
+ * trace-level input/output on it. If no active span is found, a warning is logged.
  *
- * This function finds the currently active OpenTelemetry span and updates
- * it with trace-level attributes. If no active span is found, a warning is logged.
+ * @deprecated This is a legacy function for backward compatibility with Langfuse platform
+ * features that still rely on trace-level input/output (e.g., legacy LLM-as-a-judge
+ * evaluators). It will be removed in a future major version.
  *
- * @param attributes - Trace attributes to set
+ * For setting other trace attributes (userId, sessionId, metadata, tags, version),
+ * use {@link propagateAttributes} instead.
+ *
+ * @param attributes - Input and output data to associate with the trace
  *
  * @example
  * ```typescript
- * import { updateActiveTrace } from '@langfuse/tracing';
+ * import { setActiveTraceIO } from '@langfuse/tracing';
  *
  * // Inside an active span context
- * updateActiveTrace({
- *   name: 'user-workflow',
- *   userId: '123',
- *   sessionId: 'session-456',
- *   tags: ['production', 'critical'],
- *   public: true
+ * setActiveTraceIO({
+ *   input: { query: 'user question' },
+ *   output: { response: 'assistant answer' }
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function setActiveTraceIO(attributes: LangfuseTraceAttributes): void;
+/**
+ * Make the trace of the currently active span publicly accessible via its URL.
+ *
+ * When a trace is published, anyone with the trace link can view the full trace
+ * without needing to be logged in to Langfuse. This action cannot be undone
+ * programmatically - once any span in a trace is published, the entire trace
+ * becomes public.
+ *
+ * If called outside of an active span context, the operation is skipped with a warning.
+ *
+ * @example
+ * ```typescript
+ * import { setActiveTraceAsPublic, startActiveObservation } from '@langfuse/tracing';
+ *
+ * startActiveObservation('my-operation', () => {
+ *   // Make this trace publicly accessible
+ *   setActiveTraceAsPublic();
  * });
  * ```
  *
  * @public
  */
-declare function updateActiveTrace(attributes: LangfuseTraceAttributes): void;
+declare function setActiveTraceAsPublic(): void;
 /**
  * Updates the currently active observation with new attributes.
  *
@@ -1719,7 +1746,7 @@ declare function updateActiveTrace(attributes: LangfuseTraceAttributes): void;
  * ```
  *
  * @see {@link startActiveObservation} - For creating active observation contexts
- * @see {@link updateActiveTrace} - For updating trace-level attributes
+ * @see {@link setActiveTraceIO} - For setting trace-level input/output (deprecated)
  *
  * @public
  */
@@ -2087,4 +2114,4 @@ declare function getActiveTraceId(): string | undefined;
  */
 declare function getActiveSpanId(): string | undefined;
 
-export { LangfuseAgent, LangfuseChain, LangfuseEmbedding, LangfuseEvaluator, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, LangfuseGuardrail, type LangfuseObservation, type LangfuseObservationAttributes, type LangfuseObservationType, LangfuseRetriever, LangfuseSpan, type LangfuseSpanAttributes, LangfuseTool, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartActiveObservationContext, type StartActiveObservationOpts, type StartObservationOptions, type StartObservationOpts, createObservationAttributes, createTraceAttributes, createTraceId, getActiveSpanId, getActiveTraceId, getLangfuseTracer, getLangfuseTracerProvider, observe, setLangfuseTracerProvider, startActiveObservation, startObservation, updateActiveObservation, updateActiveTrace };
+export { LangfuseAgent, LangfuseChain, LangfuseEmbedding, LangfuseEvaluator, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, LangfuseGuardrail, type LangfuseObservation, type LangfuseObservationAttributes, type LangfuseObservationType, LangfuseRetriever, LangfuseSpan, type LangfuseSpanAttributes, LangfuseTool, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartActiveObservationContext, type StartActiveObservationOpts, type StartObservationOptions, type StartObservationOpts, createObservationAttributes, createTraceAttributes, createTraceId, getActiveSpanId, getActiveTraceId, getLangfuseTracer, getLangfuseTracerProvider, observe, setActiveTraceAsPublic, setActiveTraceIO, setLangfuseTracerProvider, startActiveObservation, startObservation, updateActiveObservation };

package/dist/index.d.ts

@@ -101,36 +101,22 @@ type LangfuseEmbeddingAttributes = LangfuseGenerationAttributes;
  */
 type LangfuseObservationAttributes = LangfuseSpanAttributes & LangfuseGenerationAttributes & LangfuseEventAttributes & LangfuseAgentAttributes & LangfuseToolAttributes & LangfuseChainAttributes & LangfuseRetrieverAttributes & LangfuseEvaluatorAttributes & LangfuseGuardrailAttributes;
 /**
- * Attributes for Langfuse traces.
+ * Attributes for setting trace-level input and output only.
  *
- * Traces are the top-level containers that group related observations together.
- * They represent a complete workflow, request, or user interaction.
+ * This is a restricted type used by the deprecated setTraceIO methods,
+ * which only allow setting input and output on traces for backward
+ * compatibility with legacy Langfuse platform features.
+ *
+ * @deprecated This type is for backward compatibility with legacy platform features
+ * that still rely on trace-level input/output. Use propagateAttributes for other trace attributes.
  *
  * @public
  */
 type LangfuseTraceAttributes = {
-    /** Human-readable name for the trace */
-    name?: string;
-    /** Identifier for the user associated with this trace */
-    userId?: string;
-    /** Session identifier for grouping related traces */
-    sessionId?: string;
-    /** Version identifier for the code/application */
-    version?: string;
-    /** Release identifier for deployment tracking */
-    release?: string;
     /** Input data that initiated the trace */
     input?: unknown;
     /** Final output data from the trace */
     output?: unknown;
-    /** Additional metadata for the trace */
-    metadata?: unknown;
-    /** Tags for categorizing and filtering traces */
-    tags?: string[];
-    /** Whether this trace should be publicly visible */
-    public?: boolean;
-    /** Environment where the trace was captured */
-    environment?: string;
 };
 
 /**
@@ -157,9 +143,6 @@ type LangfuseTraceAttributes = {
  * // Function accepting any observation type
  * function logObservation(obs: LangfuseObservation) {
  *   console.log(`Observation ${obs.id} in trace ${obs.traceId}`);
- *
- *   // All observations have common methods
- *   obs.updateTrace({ tags: ['logged'] });
  *   obs.end();
  * }
  *
@@ -209,7 +192,7 @@ type LangfuseObservationParams = {
  *
  * ## Common Methods
  * - `end()`: Marks the observation as complete with optional timestamp
- * - `updateTrace()`: Sets trace-level attributes like user ID, session ID, tags
+ * - `setTraceIO()`: Sets trace-level input/output (deprecated, for legacy platform features)
  * - `startObservation()`: Creates child observations with inherited context
  *
  * @example
@@ -222,13 +205,6 @@ type LangfuseObservationParams = {
  * console.log(`Trace ID: ${observation.traceId}`);
  * console.log(`Type: ${observation.type}`);
  *
- * // Common methods available on all observations
- * observation.updateTrace({
- *   userId: 'user-123',
- *   sessionId: 'session-456',
- *   tags: ['production', 'api-v2']
- * });
- *
  * // Create child observations
  * const child = observation.startObservation('child-operation', {
  *   input: { step: 'processing' }
@@ -261,9 +237,45 @@ declare abstract class LangfuseBaseObservation {
     end(endTime?: TimeInput): void;
     updateOtelSpanAttributes(attributes: LangfuseObservationAttributes): void;
     /**
-     * Updates the parent trace with new attributes.
+     * Set trace-level input and output for the trace this observation belongs to.
+     *
+     * @deprecated This is a legacy method for backward compatibility with Langfuse platform
+     * features that still rely on trace-level input/output (e.g., legacy LLM-as-a-judge
+     * evaluators). It will be removed in a future major version.
+     *
+     * For setting other trace attributes (userId, sessionId, metadata, tags, version),
+     * use {@link propagateAttributes} instead.
+     *
+     * @param attributes - Input and output data to associate with the trace
+     * @returns The observation instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * const span = startObservation('my-operation');
+     * span.setTraceIO({
+     *   input: { query: 'user question' },
+     *   output: { response: 'assistant answer' }
+     * });
+     * ```
+     */
+    setTraceIO(attributes: LangfuseTraceAttributes): this;
+    /**
+     * Make the trace this observation belongs to publicly accessible via its URL.
+     *
+     * When a trace is published, anyone with the trace link can view the full trace
+     * without needing to be logged in to Langfuse. This action cannot be undone
+     * programmatically - once any span in a trace is published, the entire trace
+     * becomes public.
+     *
+     * @returns The observation instance for method chaining
+     *
+     * @example
+     * ```typescript
+     * const span = startObservation('my-operation');
+     * span.setTraceAsPublic();
+     * ```
      */
-    updateTrace(attributes: LangfuseTraceAttributes): this;
+    setTraceAsPublic(): this;
     /**
      * Creates a new child observation within this observation's context with full type safety.
      *
@@ -1358,32 +1370,20 @@ declare class LangfuseEvent extends LangfuseBaseObservation {
 }
 
 /**
- * Creates OpenTelemetry attributes from Langfuse trace attributes.
+ * Creates OpenTelemetry attributes from Langfuse trace IO attributes.
  *
- * Converts user-friendly trace attributes into the internal OpenTelemetry
+ * Converts trace input/output into the internal OpenTelemetry
  * attribute format required by the span processor.
  *
- * @param attributes - Langfuse trace attributes to convert
+ * @param attributes - Langfuse trace IO attributes to convert
  * @returns OpenTelemetry attributes object with non-null values
  *
- * @example
- * ```typescript
- * import { createTraceAttributes } from '@langfuse/tracing';
- *
- * const otelAttributes = createTraceAttributes({
- *   name: 'user-checkout-flow',
- *   userId: 'user-123',
- *   sessionId: 'session-456',
- *   tags: ['checkout', 'payment'],
- *   metadata: { version: '2.1.0' }
- * });
- *
- * span.setAttributes(otelAttributes);
- * ```
+ * @deprecated This is for backward compatibility with legacy platform features
+ * that still rely on trace-level input/output. Use propagateAttributes for other trace attributes.
  *
- * @public
+ * @internal
  */
-declare function createTraceAttributes({ name, userId, sessionId, version, release, input, output, metadata, tags, environment, public: isPublic, }?: LangfuseTraceAttributes): Attributes;
+declare function createTraceAttributes({ input, output, }?: LangfuseTraceAttributes): Attributes;
 declare function createObservationAttributes(type: LangfuseObservationType, attributes: LangfuseObservationAttributes): Attributes;
 
 /**
@@ -1568,30 +1568,57 @@ declare function startActiveObservation<F extends (span: LangfuseSpan) => unknow
     asType?: "span";
 }): ReturnType<F>;
 /**
- * Updates the currently active trace with new attributes.
+ * Set trace-level input and output for the currently active trace.
+ *
+ * This function finds the currently active OpenTelemetry span and sets
+ * trace-level input/output on it. If no active span is found, a warning is logged.
  *
- * This function finds the currently active OpenTelemetry span and updates
- * it with trace-level attributes. If no active span is found, a warning is logged.
+ * @deprecated This is a legacy function for backward compatibility with Langfuse platform
+ * features that still rely on trace-level input/output (e.g., legacy LLM-as-a-judge
+ * evaluators). It will be removed in a future major version.
  *
- * @param attributes - Trace attributes to set
+ * For setting other trace attributes (userId, sessionId, metadata, tags, version),
+ * use {@link propagateAttributes} instead.
+ *
+ * @param attributes - Input and output data to associate with the trace
  *
  * @example
  * ```typescript
- * import { updateActiveTrace } from '@langfuse/tracing';
+ * import { setActiveTraceIO } from '@langfuse/tracing';
  *
  * // Inside an active span context
- * updateActiveTrace({
- *   name: 'user-workflow',
- *   userId: '123',
- *   sessionId: 'session-456',
- *   tags: ['production', 'critical'],
- *   public: true
+ * setActiveTraceIO({
+ *   input: { query: 'user question' },
+ *   output: { response: 'assistant answer' }
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function setActiveTraceIO(attributes: LangfuseTraceAttributes): void;
+/**
+ * Make the trace of the currently active span publicly accessible via its URL.
+ *
+ * When a trace is published, anyone with the trace link can view the full trace
+ * without needing to be logged in to Langfuse. This action cannot be undone
+ * programmatically - once any span in a trace is published, the entire trace
+ * becomes public.
+ *
+ * If called outside of an active span context, the operation is skipped with a warning.
+ *
+ * @example
+ * ```typescript
+ * import { setActiveTraceAsPublic, startActiveObservation } from '@langfuse/tracing';
+ *
+ * startActiveObservation('my-operation', () => {
+ *   // Make this trace publicly accessible
+ *   setActiveTraceAsPublic();
  * });
  * ```
  *
  * @public
  */
-declare function updateActiveTrace(attributes: LangfuseTraceAttributes): void;
+declare function setActiveTraceAsPublic(): void;
 /**
  * Updates the currently active observation with new attributes.
  *
@@ -1719,7 +1746,7 @@ declare function updateActiveTrace(attributes: LangfuseTraceAttributes): void;
  * ```
  *
  * @see {@link startActiveObservation} - For creating active observation contexts
- * @see {@link updateActiveTrace} - For updating trace-level attributes
+ * @see {@link setActiveTraceIO} - For setting trace-level input/output (deprecated)
  *
  * @public
  */
@@ -2087,4 +2114,4 @@ declare function getActiveTraceId(): string | undefined;
  */
 declare function getActiveSpanId(): string | undefined;
 
-export { LangfuseAgent, LangfuseChain, LangfuseEmbedding, LangfuseEvaluator, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, LangfuseGuardrail, type LangfuseObservation, type LangfuseObservationAttributes, type LangfuseObservationType, LangfuseRetriever, LangfuseSpan, type LangfuseSpanAttributes, LangfuseTool, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartActiveObservationContext, type StartActiveObservationOpts, type StartObservationOptions, type StartObservationOpts, createObservationAttributes, createTraceAttributes, createTraceId, getActiveSpanId, getActiveTraceId, getLangfuseTracer, getLangfuseTracerProvider, observe, setLangfuseTracerProvider, startActiveObservation, startObservation, updateActiveObservation, updateActiveTrace };
+export { LangfuseAgent, LangfuseChain, LangfuseEmbedding, LangfuseEvaluator, LangfuseEvent, type LangfuseEventAttributes, LangfuseGeneration, type LangfuseGenerationAttributes, LangfuseGuardrail, type LangfuseObservation, type LangfuseObservationAttributes, type LangfuseObservationType, LangfuseRetriever, LangfuseSpan, type LangfuseSpanAttributes, LangfuseTool, type LangfuseTraceAttributes, type ObservationLevel, type ObserveOptions, type StartActiveObservationContext, type StartActiveObservationOpts, type StartObservationOptions, type StartObservationOpts, createObservationAttributes, createTraceAttributes, createTraceId, getActiveSpanId, getActiveTraceId, getLangfuseTracer, getLangfuseTracerProvider, observe, setActiveTraceAsPublic, setActiveTraceIO, setLangfuseTracerProvider, startActiveObservation, startObservation, updateActiveObservation };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/index.ts
-import { getGlobalLogger as getGlobalLogger2, LangfuseOtelSpanAttributes as LangfuseOtelSpanAttributes2 } from "@langfuse/core";
+import { getGlobalLogger as getGlobalLogger2, LangfuseOtelSpanAttributes as LangfuseOtelSpanAttributes3 } from "@langfuse/core";
 import {
   trace as trace2,
   context,
@@ -9,30 +9,12 @@ import {
 // src/attributes.ts
 import { LangfuseOtelSpanAttributes } from "@langfuse/core";
 function createTraceAttributes({
-  name,
-  userId,
-  sessionId,
-  version,
-  release,
   input,
-  output,
-  metadata,
-  tags,
-  environment,
-  public: isPublic
+  output
 } = {}) {
   const attributes = {
-    [LangfuseOtelSpanAttributes.TRACE_NAME]: name,
-    [LangfuseOtelSpanAttributes.TRACE_USER_ID]: userId,
-    [LangfuseOtelSpanAttributes.TRACE_SESSION_ID]: sessionId,
-    [LangfuseOtelSpanAttributes.VERSION]: version,
-    [LangfuseOtelSpanAttributes.RELEASE]: release,
     [LangfuseOtelSpanAttributes.TRACE_INPUT]: _serialize(input),
-    [LangfuseOtelSpanAttributes.TRACE_OUTPUT]: _serialize(output),
-    [LangfuseOtelSpanAttributes.TRACE_TAGS]: tags,
-    [LangfuseOtelSpanAttributes.ENVIRONMENT]: environment,
-    [LangfuseOtelSpanAttributes.TRACE_PUBLIC]: isPublic,
-    ..._flattenAndSerializeMetadata(metadata, "trace")
+    [LangfuseOtelSpanAttributes.TRACE_OUTPUT]: _serialize(output)
   };
   return Object.fromEntries(
     Object.entries(attributes).filter(([_, v]) => v != null)
@@ -105,6 +87,9 @@ function _flattenAndSerializeMetadata(metadata, type) {
   return metadataAttributes;
 }
 
+// src/spanWrapper.ts
+import { LangfuseOtelSpanAttributes as LangfuseOtelSpanAttributes2 } from "@langfuse/core";
+
 // src/tracerProvider.ts
 import {
   getGlobalLogger,
@@ -193,12 +178,53 @@ var LangfuseBaseObservation = class {
     );
   }
   /**
-   * Updates the parent trace with new attributes.
+   * Set trace-level input and output for the trace this observation belongs to.
+   *
+   * @deprecated This is a legacy method for backward compatibility with Langfuse platform
+   * features that still rely on trace-level input/output (e.g., legacy LLM-as-a-judge
+   * evaluators). It will be removed in a future major version.
+   *
+   * For setting other trace attributes (userId, sessionId, metadata, tags, version),
+   * use {@link propagateAttributes} instead.
+   *
+   * @param attributes - Input and output data to associate with the trace
+   * @returns The observation instance for method chaining
+   *
+   * @example
+   * ```typescript
+   * const span = startObservation('my-operation');
+   * span.setTraceIO({
+   *   input: { query: 'user question' },
+   *   output: { response: 'assistant answer' }
+   * });
+   * ```
    */
-  updateTrace(attributes) {
+  setTraceIO(attributes) {
     this.otelSpan.setAttributes(createTraceAttributes(attributes));
     return this;
   }
+  /**
+   * Make the trace this observation belongs to publicly accessible via its URL.
+   *
+   * When a trace is published, anyone with the trace link can view the full trace
+   * without needing to be logged in to Langfuse. This action cannot be undone
+   * programmatically - once any span in a trace is published, the entire trace
+   * becomes public.
+   *
+   * @returns The observation instance for method chaining
+   *
+   * @example
+   * ```typescript
+   * const span = startObservation('my-operation');
+   * span.setTraceAsPublic();
+   * ```
+   */
+  setTraceAsPublic() {
+    this.otelSpan.setAttributes({
+      [LangfuseOtelSpanAttributes2.TRACE_PUBLIC]: true
+    });
+    return this;
+  }
   startObservation(name, attributes, options) {
     const { asType = "span" } = options || {};
     return startObservation(name, attributes, {
@@ -408,7 +434,7 @@ var LangfuseEvent = class extends LangfuseBaseObservation {
 import {
   propagateAttributes
 } from "@langfuse/core";
-import { LangfuseOtelSpanAttributes as LangfuseOtelSpanAttributes3 } from "@langfuse/core";
+import { LangfuseOtelSpanAttributes as LangfuseOtelSpanAttributes4 } from "@langfuse/core";
 function createOtelSpan(params) {
   return getLangfuseTracer().startSpan(
     params.name,
@@ -596,16 +622,28 @@ function startActiveObservation(name, fn, options) {
     }
   );
 }
-function updateActiveTrace(attributes) {
+function setActiveTraceIO(attributes) {
   const span = trace2.getActiveSpan();
   if (!span) {
     getGlobalLogger2().warn(
-      "No active OTEL span in context. Skipping trace update."
+      "No active OTEL span in context. Skipping trace IO update."
     );
     return;
   }
   span.setAttributes(createTraceAttributes(attributes));
 }
+function setActiveTraceAsPublic() {
+  const span = trace2.getActiveSpan();
+  if (!span) {
+    getGlobalLogger2().warn(
+      "No active OTEL span in context. Skipping trace publish."
+    );
+    return;
+  }
+  span.setAttributes({
+    [LangfuseOtelSpanAttributes3.TRACE_PUBLIC]: true
+  });
+}
 function updateActiveObservation(attributes, options) {
   var _a;
   const span = trace2.getActiveSpan();
@@ -620,7 +658,7 @@ function updateActiveObservation(attributes, options) {
     attributes
   );
   if (!(options == null ? void 0 : options.asType)) {
-    otelAttributes[LangfuseOtelSpanAttributes2.OBSERVATION_TYPE] = void 0;
+    otelAttributes[LangfuseOtelSpanAttributes3.OBSERVATION_TYPE] = void 0;
   }
   span.setAttributes(otelAttributes);
 }
@@ -739,7 +777,7 @@ export {
   LangfuseEvent,
   LangfuseGeneration,
   LangfuseGuardrail,
-  LangfuseOtelSpanAttributes3 as LangfuseOtelSpanAttributes,
+  LangfuseOtelSpanAttributes4 as LangfuseOtelSpanAttributes,
   LangfuseRetriever,
   LangfuseSpan,
   LangfuseTool,
@@ -752,10 +790,11 @@ export {
   getLangfuseTracerProvider,
   observe,
   propagateAttributes,
+  setActiveTraceAsPublic,
+  setActiveTraceIO,
   setLangfuseTracerProvider,
   startActiveObservation,
   startObservation,
-  updateActiveObservation,
-  updateActiveTrace
+  updateActiveObservation
 };
 //# sourceMappingURL=index.mjs.map