@langfuse/client 4.6.0 → 4.6.1

package/dist/index.d.cts

@@ -177,6 +177,12 @@ type ExperimentParams<Input = any, ExpectedOutput = any, Metadata extends Record
      * Set lower values for expensive operations or rate-limited services.
      */
     maxConcurrency?: number;
+    /**
+     * Optional ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * If provided, returns state of dataset at this timestamp.
+     * If not provided, returns the latest version.
+     */
+    datasetVersion?: string;
 };
 type ExperimentItemResult<Input = any, ExpectedOutput = any, Metadata extends Record<string, any> = Record<string, any>> = Pick<ExperimentItem<Input, ExpectedOutput, Metadata>, "input" | "expectedOutput"> & {
     /**
@@ -364,6 +370,11 @@ type FetchedDataset = Dataset & {
     items: (DatasetItem & {
         link: LinkDatasetItemFunction;
     })[];
+    /** ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * If provided, returns state of dataset at this timestamp.
+     * If not provided, returns the latest version.
+     */
+    version?: string;
     /** Function to run experiments directly on this dataset */
     runExperiment: RunExperimentOnDataset;
 };

package/dist/index.d.ts

@@ -177,6 +177,12 @@ type ExperimentParams<Input = any, ExpectedOutput = any, Metadata extends Record
      * Set lower values for expensive operations or rate-limited services.
      */
     maxConcurrency?: number;
+    /**
+     * Optional ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * If provided, returns state of dataset at this timestamp.
+     * If not provided, returns the latest version.
+     */
+    datasetVersion?: string;
 };
 type ExperimentItemResult<Input = any, ExpectedOutput = any, Metadata extends Record<string, any> = Record<string, any>> = Pick<ExperimentItem<Input, ExpectedOutput, Metadata>, "input" | "expectedOutput"> & {
     /**
@@ -364,6 +370,11 @@ type FetchedDataset = Dataset & {
     items: (DatasetItem & {
         link: LinkDatasetItemFunction;
     })[];
+    /** ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * If provided, returns state of dataset at this timestamp.
+     * If not provided, returns the latest version.
+     */
+    version?: string;
     /** Function to run experiments directly on this dataset */
     runExperiment: RunExperimentOnDataset;
 };

package/dist/index.mjs

@@ -119,12 +119,14 @@ var DatasetManager = class {
     const runExperiment = (params) => {
       return this.langfuseClient.experiment.run({
         data: items,
+        datasetVersion: options == null ? void 0 : options.version,
         ...params
       });
     };
     const returnDataset = {
       ...dataset,
       items: itemsWithLinkMethod,
+      version: options == null ? void 0 : options.version,
       runExperiment
     };
     return returnDataset;
@@ -287,7 +289,8 @@ var ExperimentManager = class {
           experimentName: name,
           experimentRunName: runName,
           experimentDescription: description,
-          experimentMetadata: metadata
+          experimentMetadata: metadata,
+          datasetVersion: config.datasetVersion
         });
       });
       const settledResults = await Promise.allSettled(promises);
@@ -411,7 +414,10 @@ var ExperimentManager = class {
               metadata: params.experimentMetadata,
               datasetItemId,
               traceId: traceId2,
-              observationId: observationId2
+              observationId: observationId2,
+              ...params.datasetVersion && {
+                datasetVersion: params.datasetVersion
+              }
             }
           );
           datasetRunId2 = result.datasetRunId;