@langfuse/client 5.0.0 → 5.0.2

package/dist/index.d.cts

@@ -233,6 +233,8 @@ type ExperimentItemResult<Input = any, ExpectedOutput = any, Metadata extends Re
  * ```typescript
  * const result = await langfuse.experiment.run(config);
  *
+ * console.log(`Experiment ID: ${result.experimentId}`);
+ *
  * // Access individual results
  * console.log(`Processed ${result.itemResults.length} items`);
  *
@@ -255,6 +257,14 @@ type ExperimentItemResult<Input = any, ExpectedOutput = any, Metadata extends Re
  * @public
  */
 type ExperimentResult<Input = any, ExpectedOutput = any, Metadata extends Record<string, any> = Record<string, any>> = {
+    /**
+     * Stable identifier for this experiment execution.
+     *
+     * For Langfuse datasets, this is the dataset run ID when available.
+     * For local data, this is a generated fallback ID shared across all items
+     * in the run.
+     */
+    experimentId: string;
     /**
      * The experiment run name.
      *
@@ -641,6 +651,7 @@ declare class ExperimentManager {
      * @param config.maxConcurrency - Maximum number of concurrent task executions (default: 50)
      *
      * @returns Promise that resolves to experiment results including:
+     *   - experimentId: Stable identifier for the experiment execution
      *   - runName: The experiment run name (either provided or generated)
      *   - itemResults: Results for each processed data item
      *   - runEvaluations: Results from run-level evaluators

package/dist/index.d.ts

@@ -233,6 +233,8 @@ type ExperimentItemResult<Input = any, ExpectedOutput = any, Metadata extends Re
  * ```typescript
  * const result = await langfuse.experiment.run(config);
  *
+ * console.log(`Experiment ID: ${result.experimentId}`);
+ *
  * // Access individual results
  * console.log(`Processed ${result.itemResults.length} items`);
  *
@@ -255,6 +257,14 @@ type ExperimentItemResult<Input = any, ExpectedOutput = any, Metadata extends Re
  * @public
  */
 type ExperimentResult<Input = any, ExpectedOutput = any, Metadata extends Record<string, any> = Record<string, any>> = {
+    /**
+     * Stable identifier for this experiment execution.
+     *
+     * For Langfuse datasets, this is the dataset run ID when available.
+     * For local data, this is a generated fallback ID shared across all items
+     * in the run.
+     */
+    experimentId: string;
     /**
      * The experiment run name.
      *
@@ -641,6 +651,7 @@ declare class ExperimentManager {
      * @param config.maxConcurrency - Maximum number of concurrent task executions (default: 50)
      *
      * @returns Promise that resolves to experiment results including:
+     *   - experimentId: Stable identifier for the experiment execution
      *   - runName: The experiment run name (either provided or generated)
      *   - itemResults: Results for each processed data item
      *   - runEvaluations: Results from run-level evaluators

package/dist/index.mjs

@@ -206,6 +206,7 @@ var ExperimentManager = class {
    * @param config.maxConcurrency - Maximum number of concurrent task executions (default: 50)
    *
    * @returns Promise that resolves to experiment results including:
+   *   - experimentId: Stable identifier for the experiment execution
    *   - runName: The experiment run name (either provided or generated)
    *   - itemResults: Results for each processed data item
    *   - runEvaluations: Results from run-level evaluators
@@ -258,6 +259,7 @@ var ExperimentManager = class {
    * @public
    */
   async run(config) {
+    var _a;
     const {
       data,
       evaluators,
@@ -273,6 +275,7 @@ var ExperimentManager = class {
       name,
       runName: providedRunName
     });
+    const fallbackExperimentId = await createExperimentId();
     if (!this.isOtelRegistered()) {
       this.logger.warn(
         "OpenTelemetry has not been set up. Traces will not be sent to Langfuse.See our docs on how to set up OpenTelemetry: https://langfuse.com/docs/observability/sdk/typescript/setup#tracing-setup"
@@ -290,6 +293,7 @@ var ExperimentManager = class {
           experimentRunName: runName,
           experimentDescription: description,
           experimentMetadata: metadata,
+          fallbackExperimentId,
           datasetVersion: config.datasetVersion
         });
       });
@@ -310,7 +314,10 @@ var ExperimentManager = class {
       );
       itemResults.push(...results);
     }
-    const datasetRunId = itemResults.length > 0 ? itemResults[0].datasetRunId : void 0;
+    const datasetRunId = (_a = itemResults.find(
+      (item) => item.datasetRunId
+    )) == null ? void 0 : _a.datasetRunId;
+    const experimentId = datasetRunId || fallbackExperimentId;
     let datasetRunUrl = void 0;
     if (datasetRunId && data.length > 0 && "datasetId" in data[0]) {
       const datasetId = data[0].datasetId;
@@ -346,13 +353,14 @@ var ExperimentManager = class {
     }
     await this.langfuseClient.score.flush();
     return {
+      experimentId,
       runName,
       itemResults,
       datasetRunId,
       datasetRunUrl,
       runEvaluations,
       format: async (options) => {
-        var _a;
+        var _a2;
         return await this.prettyPrintResults({
           datasetRunUrl,
           itemResults,
@@ -361,7 +369,7 @@ var ExperimentManager = class {
           name: config.name,
           runName,
           description: config.description,
-          includeItemResults: (_a = options == null ? void 0 : options.includeItemResults) != null ? _a : false
+          includeItemResults: (_a2 = options == null ? void 0 : options.includeItemResults) != null ? _a2 : false
         });
       }
     };
@@ -426,7 +434,7 @@ var ExperimentManager = class {
         }
       }
       const experimentItemId = datasetItemId || await createExperimentItemId(input);
-      const experimentId = datasetRunId2 || await createExperimentId();
+      const experimentId = datasetRunId2 || params.fallbackExperimentId;
       const rootSpanAttributes = {
         [LangfuseOtelSpanAttributes.ENVIRONMENT]: LANGFUSE_SDK_EXPERIMENT_ENVIRONMENT
       };
@@ -1219,7 +1227,7 @@ var ChatPromptClient = class _ChatPromptClient extends BasePromptClient {
       }
     }
     return messagesWithPlaceholdersReplaced.map((item) => {
-      if (typeof item === "object" && item !== null && "role" in item && "content" in item) {
+      if (typeof item === "object" && item !== null && "role" in item && "content" in item && typeof item.content === "string") {
         return {
           ...item,
           content: mustache.render(item.content, variables != null ? variables : {})