@langfuse/client 4.6.0 → 5.0.0-beta.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _langfuse_core from '@langfuse/core';
-import { DatasetItem, ScoreBody, Dataset, DatasetRunItem, LangfuseAPIClient, ParsedMediaReference, CreatePromptRequest, ChatMessage, ChatMessageWithPlaceholders, PlaceholderMessage, BasePrompt, Prompt } from '@langfuse/core';
+import { DatasetItem, ScoreBody, Dataset, DatasetRunItem, LangfuseAPIClient, ParsedMediaReference, CreateChatPromptRequest, ChatMessage, ChatMessageWithPlaceholders, PlaceholderMessage, BasePrompt, Prompt, CreateTextPromptRequest } from '@langfuse/core';
 import { Span } from '@opentelemetry/api';
 
 type ExperimentItem<Input = any, ExpectedOutput = any, Metadata extends Record<string, any> = Record<string, any>> = {
@@ -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;
 };
@@ -929,7 +940,7 @@ type LangchainMessagesPlaceholder = {
 type CreateChatPromptBodyWithPlaceholders = {
     /** Specifies this is a chat prompt */
     type: "chat";
-} & Omit<CreatePromptRequest.Chat, "type" | "prompt"> & {
+} & Omit<CreateChatPromptRequest, "type" | "prompt"> & {
     /** Array of chat messages and/or placeholders */
     prompt: (ChatMessage | ChatMessageWithPlaceholders)[];
 };
@@ -1166,7 +1177,7 @@ declare class PromptManager {
      * @param body - The prompt data to create (text prompt)
      * @returns Promise that resolves to a TextPromptClient
      */
-    create(body: Omit<CreatePromptRequest.Text, "type"> & {
+    create(body: Omit<CreateTextPromptRequest, "type"> & {
         type?: "text";
     }): Promise<TextPromptClient>;
     /**
@@ -1175,7 +1186,7 @@ declare class PromptManager {
      * @param body - The prompt data to create (chat prompt)
      * @returns Promise that resolves to a ChatPromptClient
      */
-    create(body: CreatePromptRequest.Chat): Promise<ChatPromptClient>;
+    create(body: CreateChatPromptRequest): Promise<ChatPromptClient>;
     /**
      * Updates the labels of an existing prompt version.
      *

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _langfuse_core from '@langfuse/core';
-import { DatasetItem, ScoreBody, Dataset, DatasetRunItem, LangfuseAPIClient, ParsedMediaReference, CreatePromptRequest, ChatMessage, ChatMessageWithPlaceholders, PlaceholderMessage, BasePrompt, Prompt } from '@langfuse/core';
+import { DatasetItem, ScoreBody, Dataset, DatasetRunItem, LangfuseAPIClient, ParsedMediaReference, CreateChatPromptRequest, ChatMessage, ChatMessageWithPlaceholders, PlaceholderMessage, BasePrompt, Prompt, CreateTextPromptRequest } from '@langfuse/core';
 import { Span } from '@opentelemetry/api';
 
 type ExperimentItem<Input = any, ExpectedOutput = any, Metadata extends Record<string, any> = Record<string, any>> = {
@@ -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;
 };
@@ -929,7 +940,7 @@ type LangchainMessagesPlaceholder = {
 type CreateChatPromptBodyWithPlaceholders = {
     /** Specifies this is a chat prompt */
     type: "chat";
-} & Omit<CreatePromptRequest.Chat, "type" | "prompt"> & {
+} & Omit<CreateChatPromptRequest, "type" | "prompt"> & {
     /** Array of chat messages and/or placeholders */
     prompt: (ChatMessage | ChatMessageWithPlaceholders)[];
 };
@@ -1166,7 +1177,7 @@ declare class PromptManager {
      * @param body - The prompt data to create (text prompt)
      * @returns Promise that resolves to a TextPromptClient
      */
-    create(body: Omit<CreatePromptRequest.Text, "type"> & {
+    create(body: Omit<CreateTextPromptRequest, "type"> & {
         type?: "text";
     }): Promise<TextPromptClient>;
     /**
@@ -1175,7 +1186,7 @@ declare class PromptManager {
      * @param body - The prompt data to create (chat prompt)
      * @returns Promise that resolves to a ChatPromptClient
      */
-    create(body: CreatePromptRequest.Chat): Promise<ChatPromptClient>;
+    create(body: CreateChatPromptRequest): Promise<ChatPromptClient>;
     /**
      * Updates the labels of an existing prompt version.
      *

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;
@@ -1356,7 +1362,10 @@ var PromptManager = class {
             name: item.name
           };
         } else {
-          return { type: "chatmessage" /* ChatMessage */, ...item };
+          return {
+            ...item,
+            type: "chatmessage" /* ChatMessage */
+          };
         }
       })
     } : {
@@ -1498,8 +1507,8 @@ var PromptManager = class {
                 ...sharedFallbackParams,
                 type: "chat",
                 prompt: options.fallback.map((msg) => ({
-                  type: "chatmessage" /* ChatMessage */,
-                  ...msg
+                  ...msg,
+                  type: "chatmessage" /* ChatMessage */
                 }))
               },
               true