@langfuse/core 4.5.1 → 4.6.0

package/dist/index.d.ts

@@ -97,6 +97,21 @@ declare class Logger {
      * @returns The current log level
      */
     getLevel(): LogLevel;
+    /**
+     * Checks if a given log level is enabled.
+     * Use this to guard expensive operations (like JSON.stringify) before debug logging.
+     *
+     * @param level - The log level to check
+     * @returns True if the level is enabled, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (logger.isLevelEnabled(LogLevel.DEBUG)) {
+     *   logger.debug('Expensive data:', JSON.stringify(largeObject));
+     * }
+     * ```
+     */
+    isLevelEnabled(level: LogLevel): boolean;
 }
 /**
  * Singleton class that manages a global logger instance.
@@ -587,27 +602,27 @@ interface Trace$1 {
     /** The timestamp when the trace was created */
     timestamp: string;
     /** The name of the trace */
-    name?: string;
+    name: string | null;
     /** The input data of the trace. Can be any JSON. */
     input?: unknown;
     /** The output data of the trace. Can be any JSON. */
     output?: unknown;
     /** The session identifier associated with the trace */
-    sessionId?: string;
+    sessionId: string | null;
     /** The release version of the application when the trace was created */
-    release?: string;
+    release: string | null;
     /** The version of the trace */
-    version?: string;
+    version: string | null;
     /** The user identifier associated with the trace */
-    userId?: string;
+    userId: string | null;
     /** The metadata associated with the trace. Can be any JSON. */
     metadata?: unknown;
-    /** The tags associated with the trace. Can be an array of strings or null. */
-    tags?: string[];
+    /** The tags associated with the trace. */
+    tags: string[];
     /** Public traces are accessible via url without login */
-    public?: boolean;
+    public: boolean;
     /** The environment from which this trace originated. Can be any lowercase alphanumeric string with hyphens and underscores that does not start with 'langfuse'. */
-    environment?: string;
+    environment: string;
 }
 
 /**
@@ -618,13 +633,13 @@ interface TraceWithDetails extends Trace$1 {
     /** Path of trace in Langfuse UI */
     htmlPath: string;
     /** Latency of trace in seconds */
-    latency: number;
+    latency?: number | null;
     /** Cost of trace in USD */
-    totalCost: number;
+    totalCost?: number | null;
     /** List of observation ids */
-    observations: string[];
+    observations?: string[] | null;
     /** List of score ids */
-    scores: string[];
+    scores?: string[] | null;
 }
 
 /**
@@ -635,9 +650,9 @@ interface TraceWithFullDetails extends Trace$1 {
     /** Path of trace in Langfuse UI */
     htmlPath: string;
     /** Latency of trace in seconds */
-    latency: number;
+    latency?: number | null;
     /** Cost of trace in USD */
-    totalCost: number;
+    totalCost?: number | null;
     /** List of observations */
     observations: ObservationsView[];
     /** List of scores */
@@ -652,7 +667,7 @@ interface Session {
     createdAt: string;
     projectId: string;
     /** The environment from which this session originated. */
-    environment?: string;
+    environment: string;
 }
 
 /**
@@ -671,45 +686,45 @@ interface Observation {
     /** The unique identifier of the observation */
     id: string;
     /** The trace ID associated with the observation */
-    traceId?: string;
+    traceId: string | null;
     /** The type of the observation */
     type: string;
     /** The name of the observation */
-    name?: string;
+    name: string | null;
     /** The start time of the observation */
     startTime: string;
     /** The end time of the observation. */
-    endTime?: string;
+    endTime: string | null;
     /** The completion start time of the observation */
-    completionStartTime?: string;
+    completionStartTime: string | null;
     /** The model used for the observation */
-    model?: string;
+    model: string | null;
     /** The parameters of the model used for the observation */
-    modelParameters?: Record<string, MapValue>;
+    modelParameters?: unknown;
     /** The input data of the observation */
     input?: unknown;
     /** The version of the observation */
-    version?: string;
+    version: string | null;
     /** Additional metadata of the observation */
     metadata?: unknown;
     /** The output data of the observation */
     output?: unknown;
     /** (Deprecated. Use usageDetails and costDetails instead.) The usage data of the observation */
-    usage?: Usage;
+    usage: Usage;
     /** The level of the observation */
     level: ObservationLevel;
     /** The status message of the observation */
-    statusMessage?: string;
+    statusMessage: string | null;
     /** The parent observation ID */
-    parentObservationId?: string;
+    parentObservationId: string | null;
     /** The prompt ID associated with the observation */
-    promptId?: string;
+    promptId: string | null;
     /** The usage details of the observation. Key is the name of the usage metric, value is the number of units consumed. The total key is the sum of all (non-total) usage metrics or the total value ingested. */
-    usageDetails?: Record<string, number>;
+    usageDetails: Record<string, number>;
     /** The cost details of the observation. Key is the name of the cost metric, value is the cost in USD. The total key is the sum of all (non-total) cost metrics or the total value ingested. */
-    costDetails?: Record<string, number>;
+    costDetails: Record<string, number>;
     /** The environment from which this observation originated. Can be any lowercase alphanumeric string with hyphens and underscores that does not start with 'langfuse'. */
-    environment?: string;
+    environment: string;
 }
 
 /**
@@ -718,44 +733,44 @@ interface Observation {
 
 interface ObservationsView extends Observation {
     /** The name of the prompt associated with the observation */
-    promptName?: string;
+    promptName: string | null;
     /** The version of the prompt associated with the observation */
-    promptVersion?: number;
+    promptVersion: number | null;
     /** The unique identifier of the model */
-    modelId?: string;
+    modelId: string | null;
     /** The price of the input in USD */
-    inputPrice?: number;
+    inputPrice: number | null;
     /** The price of the output in USD. */
-    outputPrice?: number;
+    outputPrice: number | null;
     /** The total price in USD. */
-    totalPrice?: number;
+    totalPrice: number | null;
     /** (Deprecated. Use usageDetails and costDetails instead.) The calculated cost of the input in USD */
-    calculatedInputCost?: number;
+    calculatedInputCost: number | null;
     /** (Deprecated. Use usageDetails and costDetails instead.) The calculated cost of the output in USD */
-    calculatedOutputCost?: number;
+    calculatedOutputCost: number | null;
     /** (Deprecated. Use usageDetails and costDetails instead.) The calculated total cost in USD */
-    calculatedTotalCost?: number;
+    calculatedTotalCost: number | null;
     /** The latency in seconds. */
-    latency?: number;
+    latency: number | null;
     /** The time to the first token in seconds */
-    timeToFirstToken?: number;
+    timeToFirstToken: number | null;
 }
 
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-
 /**
  * (Deprecated. Use usageDetails and costDetails instead.) Standard interface for usage and cost
  */
 interface Usage {
     /** Number of input units (e.g. tokens) */
-    input?: number;
+    input: number;
     /** Number of output units (e.g. tokens) */
-    output?: number;
+    output: number;
     /** Defaults to input+output if not set */
-    total?: number;
-    unit?: ModelUsageUnit;
+    total: number;
+    /** Unit of measurement */
+    unit: string | null;
     /** USD input cost */
     inputCost?: number;
     /** USD output cost */
@@ -777,16 +792,17 @@ interface ScoreConfig {
     createdAt: string;
     updatedAt: string;
     projectId: string;
-    dataType: ScoreDataType;
+    dataType: ScoreConfigDataType;
     /** Whether the score config is archived. Defaults to false */
     isArchived: boolean;
     /** Sets minimum value for numerical scores. If not set, the minimum value defaults to -∞ */
-    minValue?: number;
+    minValue?: number | null;
     /** Sets maximum value for numerical scores. If not set, the maximum value defaults to +∞ */
-    maxValue?: number;
+    maxValue?: number | null;
     /** Configures custom categories for categorical scores */
     categories?: ConfigCategory[];
-    description?: string;
+    /** Description of the score config */
+    description?: string | null;
 }
 
 /**
@@ -806,19 +822,23 @@ interface BaseScoreV1 {
     traceId: string;
     name: string;
     source: ScoreSource;
-    observationId?: string;
+    /** The observation ID associated with the score */
+    observationId?: string | null;
     timestamp: string;
     createdAt: string;
     updatedAt: string;
-    authorUserId?: string;
-    comment?: string;
+    /** The user ID of the author */
+    authorUserId: string | null;
+    /** Comment on the score */
+    comment: string | null;
+    /** Metadata associated with the score */
     metadata?: unknown;
     /** Reference a score config on a score. When set, config and score name must be equal and value must comply to optionally defined numerical range */
-    configId?: string;
+    configId: string | null;
     /** The annotation queue referenced by the score. Indicates if score was initially created while processing annotation queue. */
-    queueId?: string;
+    queueId: string | null;
     /** The environment from which this score originated. Can be any lowercase alphanumeric string with hyphens and underscores that does not start with 'langfuse'. */
-    environment?: string;
+    environment: string;
 }
 
 /**
@@ -884,24 +904,31 @@ declare namespace ScoreV1 {
 
 interface BaseScore {
     id: string;
-    traceId?: string;
-    sessionId?: string;
-    observationId?: string;
-    datasetRunId?: string;
+    /** The trace ID associated with the score */
+    traceId?: string | null;
+    /** The session ID associated with the score */
+    sessionId?: string | null;
+    /** The observation ID associated with the score */
+    observationId?: string | null;
+    /** The dataset run ID associated with the score */
+    datasetRunId?: string | null;
     name: string;
     source: ScoreSource;
     timestamp: string;
     createdAt: string;
     updatedAt: string;
-    authorUserId?: string;
-    comment?: string;
+    /** The user ID of the author */
+    authorUserId: string | null;
+    /** Comment on the score */
+    comment: string | null;
+    /** Metadata associated with the score */
     metadata?: unknown;
     /** Reference a score config on a score. When set, config and score name must be equal and value must comply to optionally defined numerical range */
-    configId?: string;
+    configId: string | null;
     /** The annotation queue referenced by the score. Indicates if score was initially created while processing annotation queue. */
-    queueId?: string;
+    queueId: string | null;
     /** The environment from which this score originated. Can be any lowercase alphanumeric string with hyphens and underscores that does not start with 'langfuse'. */
-    environment?: string;
+    environment: string;
 }
 
 /**
@@ -935,6 +962,17 @@ interface CategoricalScore extends BaseScore {
     stringValue: string;
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+interface CorrectionScore extends BaseScore {
+    /** The numeric value of the score. Always 0 for correction scores. */
+    value: number;
+    /** The string representation of the correction content */
+    stringValue: string;
+}
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -948,7 +986,10 @@ Score$1.Numeric
  | Score$1.Categorical
 /**
  * Score with BOOLEAN data type */
- | Score$1.Boolean;
+ | Score$1.Boolean
+/**
+ * Score with CORRECTION data type */
+ | Score$1.Correction;
 declare namespace Score$1 {
     interface Numeric extends NumericScore {
         dataType: "NUMERIC";
@@ -959,6 +1000,9 @@ declare namespace Score$1 {
     interface Boolean extends BooleanScore {
         dataType: "BOOLEAN";
     }
+    interface Correction extends CorrectionScore {
+        dataType: "CORRECTION";
+    }
 }
 
 /**
@@ -981,7 +1025,8 @@ interface Comment {
     objectType: CommentObjectType;
     objectId: string;
     content: string;
-    authorUserId?: string;
+    /** The user ID of the comment author */
+    authorUserId?: string | null;
 }
 
 /**
@@ -990,12 +1035,14 @@ interface Comment {
 interface Dataset {
     id: string;
     name: string;
-    description?: string;
+    /** Description of the dataset */
+    description: string | null;
+    /** Metadata associated with the dataset */
     metadata?: unknown;
     /** JSON Schema for validating dataset item inputs */
-    inputSchema?: unknown;
+    inputSchema: unknown | null;
     /** JSON Schema for validating dataset item expected outputs */
-    expectedOutputSchema?: unknown;
+    expectedOutputSchema: unknown | null;
     projectId: string;
     createdAt: string;
     updatedAt: string;
@@ -1008,11 +1055,16 @@ interface Dataset {
 interface DatasetItem {
     id: string;
     status: DatasetStatus;
+    /** Input data for the dataset item */
     input?: unknown;
+    /** Expected output for the dataset item */
     expectedOutput?: unknown;
+    /** Metadata associated with the dataset item */
     metadata?: unknown;
-    sourceTraceId?: string;
-    sourceObservationId?: string;
+    /** The trace ID that sourced this dataset item */
+    sourceTraceId: string | null;
+    /** The observation ID that sourced this dataset item */
+    sourceObservationId: string | null;
     datasetId: string;
     datasetName: string;
     createdAt: string;
@@ -1028,7 +1080,8 @@ interface DatasetRunItem {
     datasetRunName: string;
     datasetItemId: string;
     traceId: string;
-    observationId?: string;
+    /** The observation ID associated with this run item */
+    observationId: string | null;
     createdAt: string;
     updatedAt: string;
 }
@@ -1042,7 +1095,7 @@ interface DatasetRun {
     /** Name of the dataset run */
     name: string;
     /** Description of the run */
-    description?: string;
+    description: string | null;
     /** Metadata of the dataset run */
     metadata?: unknown;
     /** Id of the associated dataset */
@@ -1085,17 +1138,17 @@ interface Model {
     /** Regex pattern which matches this model definition to generation.model. Useful in case of fine-tuned models. If you want to exact match, use `(?i)^modelname$` */
     matchPattern: string;
     /** Apply only to generations which are newer than this ISO date. */
-    startDate?: string;
+    startDate: string | null;
     /** Unit used by this model. */
-    unit?: ModelUsageUnit;
+    unit?: ModelUsageUnit | null;
     /** Deprecated. See 'prices' instead. Price (USD) per input unit */
-    inputPrice?: number;
+    inputPrice: number | null;
     /** Deprecated. See 'prices' instead. Price (USD) per output unit */
-    outputPrice?: number;
+    outputPrice: number | null;
     /** Deprecated. See 'prices' instead. Price (USD) per total unit. Cannot be set if input or output price is set. */
-    totalPrice?: number;
+    totalPrice: number | null;
     /** Optional. Tokenizer to be applied to observations which match to this model. See docs for more details. */
-    tokenizerId?: string;
+    tokenizerId: string | null;
     /** Optional. Configuration for the selected tokenizer. Needs to be JSON. See docs for more details. */
     tokenizerConfig?: unknown;
     isLangfuseManaged: boolean;
@@ -1389,11 +1442,22 @@ declare const ScoreSource: {
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-type ScoreDataType = "NUMERIC" | "BOOLEAN" | "CATEGORICAL";
+type ScoreConfigDataType = "NUMERIC" | "BOOLEAN" | "CATEGORICAL";
+declare const ScoreConfigDataType: {
+    readonly Numeric: "NUMERIC";
+    readonly Boolean: "BOOLEAN";
+    readonly Categorical: "CATEGORICAL";
+};
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+type ScoreDataType = "NUMERIC" | "BOOLEAN" | "CATEGORICAL" | "CORRECTION";
 declare const ScoreDataType: {
     readonly Numeric: "NUMERIC";
     readonly Boolean: "BOOLEAN";
     readonly Categorical: "CATEGORICAL";
+    readonly Correction: "CORRECTION";
 };
 
 /**
@@ -1547,6 +1611,7 @@ type index$p_CategoricalScoreV1 = CategoricalScoreV1;
 type index$p_Comment = Comment;
 declare const index$p_CommentObjectType: typeof CommentObjectType;
 type index$p_ConfigCategory = ConfigCategory;
+type index$p_CorrectionScore = CorrectionScore;
 type index$p_CreateScoreValue = CreateScoreValue;
 type index$p_Dataset = Dataset;
 type index$p_DatasetItem = DatasetItem;
@@ -1572,6 +1637,7 @@ type index$p_PricingTierCondition = PricingTierCondition;
 type index$p_PricingTierInput = PricingTierInput;
 declare const index$p_PricingTierOperator: typeof PricingTierOperator;
 type index$p_ScoreConfig = ScoreConfig;
+declare const index$p_ScoreConfigDataType: typeof ScoreConfigDataType;
 declare const index$p_ScoreDataType: typeof ScoreDataType;
 declare const index$p_ScoreSource: typeof ScoreSource;
 declare const index$p_ScoreV1: typeof ScoreV1;
@@ -1583,7 +1649,7 @@ type index$p_UnauthorizedError = UnauthorizedError;
 declare const index$p_UnauthorizedError: typeof UnauthorizedError;
 type index$p_Usage = Usage;
 declare namespace index$p {
-  export { index$p_AccessDeniedError as AccessDeniedError, type index$p_BaseScore as BaseScore, type index$p_BaseScoreV1 as BaseScoreV1, type index$p_BooleanScore as BooleanScore, type index$p_BooleanScoreV1 as BooleanScoreV1, type index$p_CategoricalScore as CategoricalScore, type index$p_CategoricalScoreV1 as CategoricalScoreV1, type index$p_Comment as Comment, index$p_CommentObjectType as CommentObjectType, type index$p_ConfigCategory as ConfigCategory, type index$p_CreateScoreValue as CreateScoreValue, type index$p_Dataset as Dataset, type index$p_DatasetItem as DatasetItem, type index$p_DatasetRun as DatasetRun, type index$p_DatasetRunItem as DatasetRunItem, type index$p_DatasetRunWithItems as DatasetRunWithItems, index$p_DatasetStatus as DatasetStatus, Error$1 as Error, type index$p_MapValue as MapValue, index$p_MethodNotAllowedError as MethodNotAllowedError, type index$p_Model as Model, type index$p_ModelPrice as ModelPrice, index$p_ModelUsageUnit as ModelUsageUnit, index$p_NotFoundError as NotFoundError, type index$p_NumericScore as NumericScore, type index$p_NumericScoreV1 as NumericScoreV1, type index$p_Observation as Observation, index$p_ObservationLevel as ObservationLevel, type index$p_ObservationsView as ObservationsView, type index$p_PricingTier as PricingTier, type index$p_PricingTierCondition as PricingTierCondition, type index$p_PricingTierInput as PricingTierInput, index$p_PricingTierOperator as PricingTierOperator, Score$1 as Score, type index$p_ScoreConfig as ScoreConfig, index$p_ScoreDataType as ScoreDataType, index$p_ScoreSource as ScoreSource, index$p_ScoreV1 as ScoreV1, type index$p_Session as Session, type index$p_SessionWithTraces as SessionWithTraces, type Trace$1 as Trace, type index$p_TraceWithDetails as TraceWithDetails, type index$p_TraceWithFullDetails as TraceWithFullDetails, index$p_UnauthorizedError as UnauthorizedError, type index$p_Usage as Usage };
+  export { index$p_AccessDeniedError as AccessDeniedError, type index$p_BaseScore as BaseScore, type index$p_BaseScoreV1 as BaseScoreV1, type index$p_BooleanScore as BooleanScore, type index$p_BooleanScoreV1 as BooleanScoreV1, type index$p_CategoricalScore as CategoricalScore, type index$p_CategoricalScoreV1 as CategoricalScoreV1, type index$p_Comment as Comment, index$p_CommentObjectType as CommentObjectType, type index$p_ConfigCategory as ConfigCategory, type index$p_CorrectionScore as CorrectionScore, type index$p_CreateScoreValue as CreateScoreValue, type index$p_Dataset as Dataset, type index$p_DatasetItem as DatasetItem, type index$p_DatasetRun as DatasetRun, type index$p_DatasetRunItem as DatasetRunItem, type index$p_DatasetRunWithItems as DatasetRunWithItems, index$p_DatasetStatus as DatasetStatus, Error$1 as Error, type index$p_MapValue as MapValue, index$p_MethodNotAllowedError as MethodNotAllowedError, type index$p_Model as Model, type index$p_ModelPrice as ModelPrice, index$p_ModelUsageUnit as ModelUsageUnit, index$p_NotFoundError as NotFoundError, type index$p_NumericScore as NumericScore, type index$p_NumericScoreV1 as NumericScoreV1, type index$p_Observation as Observation, index$p_ObservationLevel as ObservationLevel, type index$p_ObservationsView as ObservationsView, type index$p_PricingTier as PricingTier, type index$p_PricingTierCondition as PricingTierCondition, type index$p_PricingTierInput as PricingTierInput, index$p_PricingTierOperator as PricingTierOperator, Score$1 as Score, type index$p_ScoreConfig as ScoreConfig, index$p_ScoreConfigDataType as ScoreConfigDataType, index$p_ScoreDataType as ScoreDataType, index$p_ScoreSource as ScoreSource, index$p_ScoreV1 as ScoreV1, type index$p_Session as Session, type index$p_SessionWithTraces as SessionWithTraces, type Trace$1 as Trace, type index$p_TraceWithDetails as TraceWithDetails, type index$p_TraceWithFullDetails as TraceWithFullDetails, index$p_UnauthorizedError as UnauthorizedError, type index$p_Usage as Usage };
 }
 
 /**
@@ -1631,6 +1697,12 @@ interface GetDatasetItemsRequest {
     datasetName?: string;
     sourceTraceId?: string;
     sourceObservationId?: string;
+    /**
+     * 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. Requires datasetName to be specified.
+     */
+    version?: string;
     /** page number, starts at 1 */
     page?: number;
     /** limit of items per page */
@@ -1658,6 +1730,13 @@ interface CreateDatasetRunItemRequest {
     observationId?: string;
     /** traceId should always be provided. For compatibility with older SDK versions it can also be inferred from the provided observationId. */
     traceId?: string;
+    /**
+     * ISO 8601 timestamp (RFC 3339, Section 5.6) in UTC (e.g., "2026-01-21T14:35:42Z").
+     * Specifies the dataset version to use for this experiment run.
+     * If provided, the experiment will use dataset items as they existed at or before this timestamp.
+     * If not provided, uses the latest version of dataset items.
+     */
+    datasetVersion?: string;
 }
 
 /**
@@ -2119,6 +2198,7 @@ interface ScoreBody {
     sessionId?: string;
     observationId?: string;
     datasetRunId?: string;
+    /** The name of the score. Always overrides "output" for correction scores. */
     name: string;
     environment?: string;
     /** The annotation queue referenced by the score. Indicates if score was initially created while processing annotation queue. */
@@ -2895,6 +2975,13 @@ interface GetObservationsV2Request {
      * Example: "basic,usage,model"
      */
     fields?: string;
+    /**
+     * Comma-separated list of metadata keys to return non-truncated.
+     * By default, metadata values over 200 characters are truncated.
+     * Use this parameter to retrieve full values for specific keys.
+     * Example: "key1,key2"
+     */
+    expandMetadata?: string;
     /** Number of items to return per page. Maximum 1000, default 50. */
     limit?: number;
     /** Base64-encoded cursor for pagination. Use the cursor from the previous response to get the next page. */
@@ -3482,9 +3569,22 @@ interface Projects$1 {
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+interface Organization {
+    /** The unique identifier of the organization */
+    id: string;
+    /** The name of the organization */
+    name: string;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
 interface Project {
     id: string;
     name: string;
+    /** The organization this project belongs to */
+    organization: Organization;
     /** Metadata for the project */
     metadata: Record<string, unknown>;
     /** Number of days to retain data. Null or 0 means no retention. Omitted if no retention is configured. */
@@ -3578,15 +3678,20 @@ interface CreateProjectRequest {
  *     {
  *         name: "name",
  *         metadata: undefined,
- *         retention: 1
+ *         retention: undefined
  *     }
  */
 interface UpdateProjectRequest {
     name: string;
     /** Optional metadata for the project */
     metadata?: Record<string, unknown>;
-    /** Number of days to retain data. Must be 0 or at least 3 days. Requires data-retention entitlement for non-zero values. Optional. */
-    retention: number;
+    /**
+     * Number of days to retain data.
+     * Must be 0 or at least 3 days.
+     * Requires data-retention entitlement for non-zero values.
+     * Optional. Will retain existing retention setting if omitted.
+     */
+    retention?: number;
 }
 
 /**
@@ -3615,11 +3720,12 @@ type index$a_ApiKeyResponse = ApiKeyResponse;
 type index$a_ApiKeySummary = ApiKeySummary;
 type index$a_CreateApiKeyRequest = CreateApiKeyRequest;
 type index$a_CreateProjectRequest = CreateProjectRequest;
+type index$a_Organization = Organization;
 type index$a_Project = Project;
 type index$a_ProjectDeletionResponse = ProjectDeletionResponse;
 type index$a_UpdateProjectRequest = UpdateProjectRequest;
 declare namespace index$a {
-  export type { index$a_ApiKeyDeletionResponse as ApiKeyDeletionResponse, index$a_ApiKeyList as ApiKeyList, index$a_ApiKeyResponse as ApiKeyResponse, index$a_ApiKeySummary as ApiKeySummary, index$a_CreateApiKeyRequest as CreateApiKeyRequest, index$a_CreateProjectRequest as CreateProjectRequest, index$a_Project as Project, index$a_ProjectDeletionResponse as ProjectDeletionResponse, Projects$1 as Projects, index$a_UpdateProjectRequest as UpdateProjectRequest };
+  export type { index$a_ApiKeyDeletionResponse as ApiKeyDeletionResponse, index$a_ApiKeyList as ApiKeyList, index$a_ApiKeyResponse as ApiKeyResponse, index$a_ApiKeySummary as ApiKeySummary, index$a_CreateApiKeyRequest as CreateApiKeyRequest, index$a_CreateProjectRequest as CreateProjectRequest, index$a_Organization as Organization, index$a_Project as Project, index$a_ProjectDeletionResponse as ProjectDeletionResponse, Projects$1 as Projects, index$a_UpdateProjectRequest as UpdateProjectRequest };
 }
 
 /**
@@ -4103,7 +4209,7 @@ interface ScoreConfigs$1 {
 
 interface CreateScoreConfigRequest {
     name: string;
-    dataType: ScoreDataType;
+    dataType: ScoreConfigDataType;
     /** Configure custom categories for categorical scores. Pass a list of objects with `label` and `value` properties. Categories are autogenerated for boolean configs and cannot be passed */
     categories?: ConfigCategory[];
     /** Configure a minimum value for numerical scores. If not set, the minimum value defaults to -∞ */
@@ -4194,7 +4300,15 @@ interface GetScoresResponseDataBoolean extends BooleanScore {
  * This file was auto-generated by Fern from our API Definition.
  */
 
-type GetScoresResponseData = GetScoresResponseData.Numeric | GetScoresResponseData.Categorical | GetScoresResponseData.Boolean;
+interface GetScoresResponseDataCorrection extends CorrectionScore {
+    trace?: GetScoresResponseTraceData;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+type GetScoresResponseData = GetScoresResponseData.Numeric | GetScoresResponseData.Categorical | GetScoresResponseData.Boolean | GetScoresResponseData.Correction;
 declare namespace GetScoresResponseData {
     interface Numeric extends GetScoresResponseDataNumeric {
         dataType: "NUMERIC";
@@ -4205,6 +4319,9 @@ declare namespace GetScoresResponseData {
     interface Boolean extends GetScoresResponseDataBoolean {
         dataType: "BOOLEAN";
     }
+    interface Correction extends GetScoresResponseDataCorrection {
+        dataType: "CORRECTION";
+    }
 }
 
 /**
@@ -4261,6 +4378,8 @@ interface GetScoresRequest {
     dataType?: ScoreDataType;
     /** Only scores linked to traces that include all of these tags will be returned. */
     traceTags?: string | string[];
+    /** Comma-separated list of field groups to include in the response. Available field groups: 'score' (core score fields), 'trace' (trace properties: userId, tags, environment). If not specified, both 'score' and 'trace' are returned by default. Example: 'score' to exclude trace data, 'score,trace' to include both. Note: When filtering by trace properties (using userId or traceTags parameters), the 'trace' field group must be included, otherwise a 400 error will be returned. */
+    fields?: string;
 }
 
 type index$6_GetScoresRequest = GetScoresRequest;
@@ -4268,10 +4387,11 @@ type index$6_GetScoresResponse = GetScoresResponse;
 declare const index$6_GetScoresResponseData: typeof GetScoresResponseData;
 type index$6_GetScoresResponseDataBoolean = GetScoresResponseDataBoolean;
 type index$6_GetScoresResponseDataCategorical = GetScoresResponseDataCategorical;
+type index$6_GetScoresResponseDataCorrection = GetScoresResponseDataCorrection;
 type index$6_GetScoresResponseDataNumeric = GetScoresResponseDataNumeric;
 type index$6_GetScoresResponseTraceData = GetScoresResponseTraceData;
 declare namespace index$6 {
-  export { type index$6_GetScoresRequest as GetScoresRequest, type index$6_GetScoresResponse as GetScoresResponse, index$6_GetScoresResponseData as GetScoresResponseData, type index$6_GetScoresResponseDataBoolean as GetScoresResponseDataBoolean, type index$6_GetScoresResponseDataCategorical as GetScoresResponseDataCategorical, type index$6_GetScoresResponseDataNumeric as GetScoresResponseDataNumeric, type index$6_GetScoresResponseTraceData as GetScoresResponseTraceData };
+  export { type index$6_GetScoresRequest as GetScoresRequest, type index$6_GetScoresResponse as GetScoresResponse, index$6_GetScoresResponseData as GetScoresResponseData, type index$6_GetScoresResponseDataBoolean as GetScoresResponseDataBoolean, type index$6_GetScoresResponseDataCategorical as GetScoresResponseDataCategorical, type index$6_GetScoresResponseDataCorrection as GetScoresResponseDataCorrection, type index$6_GetScoresResponseDataNumeric as GetScoresResponseDataNumeric, type index$6_GetScoresResponseTraceData as GetScoresResponseTraceData };
 }
 
 /**
@@ -5173,7 +5293,8 @@ declare class DatasetItems {
     get(id: string, requestOptions?: DatasetItems.RequestOptions): HttpResponsePromise<DatasetItem>;
     private __get;
     /**
-     * Get dataset items
+     * Get dataset items. Optionally specify a version to get the items as they existed at that point in time.
+     * Note: If version parameter is provided, datasetName must also be provided.
      *
      * @param {LangfuseAPI.GetDatasetItemsRequest} request
      * @param {DatasetItems.RequestOptions} requestOptions - Request-specific configuration.
@@ -5270,7 +5391,8 @@ declare class DatasetRunItems {
      *         metadata: undefined,
      *         datasetItemId: "datasetItemId",
      *         observationId: undefined,
-     *         traceId: undefined
+     *         traceId: undefined,
+     *         datasetVersion: undefined
      *     })
      */
     create(request: CreateDatasetRunItemRequest, requestOptions?: DatasetRunItems.RequestOptions): HttpResponsePromise<DatasetRunItem>;
@@ -6050,6 +6172,8 @@ declare class Metrics {
     /**
      * Get metrics from the Langfuse project using a query object.
      *
+     * Consider using the [v2 metrics endpoint](/api-reference#tag/metricsv2/GET/api/public/v2/metrics) for better performance.
+     *
      * For more details, see the [Metrics API documentation](https://langfuse.com/docs/metrics/features/metrics-api).
      *
      * @param {LangfuseAPI.GetMetricsRequest} request
@@ -6251,7 +6375,7 @@ declare class ObservationsV2 {
      * - `basic` - name, level, statusMessage, version, environment, bookmarked, public, userId, sessionId
      * - `time` - completionStartTime, createdAt, updatedAt
      * - `io` - input, output
-     * - `metadata` - metadata
+     * - `metadata` - metadata (truncated to 200 chars by default, use `expandMetadata` to get full values)
      * - `model` - providedModelName, internalModelId, modelParameters
      * - `usage` - usageDetails, costDetails, totalCost
      * - `prompt` - promptId, promptName, promptVersion
@@ -6340,7 +6464,9 @@ declare class Observations {
     get(observationId: string, requestOptions?: Observations.RequestOptions): HttpResponsePromise<ObservationsView>;
     private __get;
     /**
-     * Get a list of observations
+     * Get a list of observations.
+     *
+     * Consider using the [v2 observations endpoint](/api-reference#tag/observationsv2/GET/api/public/v2/observations) for cursor-based pagination and field selection.
      *
      * @param {LangfuseAPI.GetObservationsRequest} request
      * @param {Observations.RequestOptions} requestOptions - Request-specific configuration.
@@ -6759,7 +6885,7 @@ declare class Projects {
      *     await client.projects.update("projectId", {
      *         name: "name",
      *         metadata: undefined,
-     *         retention: 1
+     *         retention: undefined
      *     })
      */
     update(projectId: string, request: UpdateProjectRequest, requestOptions?: Projects.RequestOptions): HttpResponsePromise<Project>;
@@ -8166,4 +8292,4 @@ interface PropagateAttributesParams {
 declare function propagateAttributes<A extends unknown[], F extends (...args: A) => ReturnType<F>>(params: PropagateAttributesParams, fn: F): ReturnType<F>;
 declare function getPropagatedAttributesFromContext(context: Context): Record<string, string | string[]>;
 
-export { AccessDeniedError, type AnnotationQueue, type AnnotationQueueAssignmentRequest, type AnnotationQueueItem, AnnotationQueueObjectType, AnnotationQueueStatus, type ApiKeyDeletionResponse, type ApiKeyList, type ApiKeyResponse, type ApiKeySummary, type AuthenticationScheme, type BaseEvent, type BasePrompt, type BaseScore, type BaseScoreV1, BlobStorageExportFrequency, BlobStorageExportMode, type BlobStorageIntegrationDeletionResponse, BlobStorageIntegrationFileType, type BlobStorageIntegrationResponse, BlobStorageIntegrationType, type BlobStorageIntegrationsResponse, type BooleanScore, type BooleanScoreV1, type BulkConfig, type CategoricalScore, type CategoricalScoreV1, type ChatMessage, ChatMessageWithPlaceholders, type ChatPrompt, type Comment, CommentObjectType, type ConfigCategory, type CreateAnnotationQueueAssignmentResponse, type CreateAnnotationQueueItemRequest, type CreateAnnotationQueueRequest, type CreateApiKeyRequest, type CreateBlobStorageIntegrationRequest, type CreateChatPromptRequest, type CreateCommentRequest, type CreateCommentResponse, type CreateDatasetItemRequest, type CreateDatasetRequest, type CreateDatasetRunItemRequest, type CreateEventBody, type CreateEventEvent, type CreateGenerationBody, type CreateGenerationEvent, type CreateModelRequest, type CreateObservationEvent, type CreateProjectRequest, CreatePromptRequest, type CreateScoreConfigRequest, type CreateScoreRequest, type CreateScoreResponse, type CreateScoreValue, type CreateSpanBody, type CreateSpanEvent, type CreateTextPromptRequest, type CreateUserRequest, type Dataset, type DatasetItem, type DatasetRun, type DatasetRunItem, type DatasetRunWithItems, DatasetStatus, type DeleteAnnotationQueueAssignmentResponse, type DeleteAnnotationQueueItemResponse, type DeleteDatasetItemResponse, type DeleteDatasetRunResponse, type DeleteMembershipRequest, type DeletePromptRequest, type DeleteTraceResponse, type DeleteTracesRequest, type EmptyResponse, Error$1 as Error, type FilterConfig, type GetAnnotationQueueItemsRequest, type GetAnnotationQueuesRequest, type GetCommentsRequest, type GetCommentsResponse, type GetDatasetItemsRequest, type GetDatasetRunsRequest, type GetDatasetsRequest, type GetLlmConnectionsRequest, type GetMediaResponse, type GetMediaUploadUrlRequest, type GetMediaUploadUrlResponse, type GetMetricsRequest, type GetMetricsV2Request, type GetModelsRequest, type GetObservationsRequest, type GetObservationsV2Request, type GetPromptRequest, type GetScoreConfigsRequest, type GetScoresRequest, type GetScoresResponse, GetScoresResponseData, type GetScoresResponseDataBoolean, type GetScoresResponseDataCategorical, type GetScoresResponseDataNumeric, type GetScoresResponseTraceData, type GetSessionsRequest, type GetTracesRequest, type HealthResponse, type IngestionError, IngestionEvent, type IngestionRequest, type IngestionResponse, type IngestionSuccess, type IngestionUsage, LANGFUSE_SDK_EXPERIMENT_ENVIRONMENT, LANGFUSE_SDK_NAME, LANGFUSE_SDK_VERSION, LANGFUSE_TRACER_NAME, LangfuseAPIClient, LangfuseAPIError, LangfuseAPITimeoutError, LangfuseMedia, type LangfuseMediaParams, LangfuseOtelContextKeys, LangfuseOtelSpanAttributes, type ListDatasetRunItemsRequest, type ListPromptsMetaRequest, type ListUsersRequest, LlmAdapter, type LlmConnection, LogLevel, Logger, type LoggerConfig, type MapValue, MediaContentType, type MembershipDeletionResponse, type MembershipRequest, type MembershipResponse, MembershipRole, type MembershipsResponse, MethodNotAllowedError, type MetricsResponse, type MetricsV2Response, type Model, type ModelPrice, ModelUsageUnit, NotFoundError, type NumericScore, type NumericScoreV1, type Observation, type ObservationBody, ObservationLevel, ObservationType, type Observations$1 as Observations, type ObservationsV2Meta, type ObservationsV2Response, type ObservationsView, type ObservationsViews, type OpenAiCompletionUsageSchema, type OpenAiResponseUsageSchema, type OpenAiUsage, type OptionalObservationBody, type OrganizationApiKey, type OrganizationApiKeysResponse, type OrganizationProject, type OrganizationProjectsResponse, type OtelAttribute, type OtelAttributeValue, type OtelResource, type OtelResourceSpan, type OtelScope, type OtelScopeSpan, type OtelSpan, type OtelTraceRequest, type OtelTraceResponse, type PaginatedAnnotationQueueItems, type PaginatedAnnotationQueues, type PaginatedDatasetItems, type PaginatedDatasetRunItems, type PaginatedDatasetRuns, type PaginatedDatasets, type PaginatedLlmConnections, type PaginatedModels, type PaginatedSessions, type ParsedMediaReference, type PatchMediaBody, type PlaceholderMessage, type PricingTier, type PricingTierCondition, type PricingTierInput, PricingTierOperator, type Project, type ProjectDeletionResponse, type Projects$1 as Projects, Prompt, type PromptMeta, type PromptMetaListResponse, PromptType, type PropagateAttributesParams, type ResourceMeta, type ResourceType, type ResourceTypesResponse, type SchemaExtension, type SchemaResource, type SchemasResponse, type ScimEmail, type ScimFeatureSupport, type ScimName, type ScimUser, type ScimUsersListResponse, Score$1 as Score, type ScoreBody, type ScoreConfig, type ScoreConfigs$1 as ScoreConfigs, ScoreDataType, type ScoreEvent, ScoreSource, ScoreV1, type SdkLogBody, type SdkLogEvent, type ServiceProviderConfig, ServiceUnavailableError, type Session, type SessionWithTraces, type Sort, type TextPrompt, type Trace$1 as Trace, type TraceBody, type TraceEvent, type TraceWithDetails, type TraceWithFullDetails, type Traces, UnauthorizedError, type UpdateAnnotationQueueItemRequest, type UpdateEventBody, type UpdateGenerationBody, type UpdateGenerationEvent, type UpdateObservationEvent, type UpdateProjectRequest, type UpdatePromptRequest, type UpdateScoreConfigRequest, type UpdateSpanBody, type UpdateSpanEvent, type UpsertLlmConnectionRequest, type Usage, type UsageDetails, type UserMeta, index$s as annotationQueues, base64Decode, base64Encode, base64ToBytes, index$r as blobStorageIntegrations, bytesToBase64, index$q as comments, index$p as commons, configureGlobalLogger, createExperimentId, createExperimentItemId, createLogger, index$o as datasetItems, index$n as datasetRunItems, index$m as datasets, generateUUID, getEnv, getGlobalLogger, getPropagatedAttributesFromContext, index$l as health, index$k as ingestion, index$j as llmConnections, LoggerSingleton as logger, index$i as media, index$g as metrics, index$h as metricsV2, index$f as models, index$d as observations, index$e as observationsV2, index$c as opentelemetry, index$b as organizations, index$a as projects, index as promptVersion, index$9 as prompts, propagateAttributes, resetGlobalLogger, safeSetTimeout, index$8 as scim, index$5 as score, index$7 as scoreConfigs, index$6 as scoreV2, serializeValue, index$4 as sessions, index$3 as trace, index$1 as utils };
+export { AccessDeniedError, type AnnotationQueue, type AnnotationQueueAssignmentRequest, type AnnotationQueueItem, AnnotationQueueObjectType, AnnotationQueueStatus, type ApiKeyDeletionResponse, type ApiKeyList, type ApiKeyResponse, type ApiKeySummary, type AuthenticationScheme, type BaseEvent, type BasePrompt, type BaseScore, type BaseScoreV1, BlobStorageExportFrequency, BlobStorageExportMode, type BlobStorageIntegrationDeletionResponse, BlobStorageIntegrationFileType, type BlobStorageIntegrationResponse, BlobStorageIntegrationType, type BlobStorageIntegrationsResponse, type BooleanScore, type BooleanScoreV1, type BulkConfig, type CategoricalScore, type CategoricalScoreV1, type ChatMessage, ChatMessageWithPlaceholders, type ChatPrompt, type Comment, CommentObjectType, type ConfigCategory, type CorrectionScore, type CreateAnnotationQueueAssignmentResponse, type CreateAnnotationQueueItemRequest, type CreateAnnotationQueueRequest, type CreateApiKeyRequest, type CreateBlobStorageIntegrationRequest, type CreateChatPromptRequest, type CreateCommentRequest, type CreateCommentResponse, type CreateDatasetItemRequest, type CreateDatasetRequest, type CreateDatasetRunItemRequest, type CreateEventBody, type CreateEventEvent, type CreateGenerationBody, type CreateGenerationEvent, type CreateModelRequest, type CreateObservationEvent, type CreateProjectRequest, CreatePromptRequest, type CreateScoreConfigRequest, type CreateScoreRequest, type CreateScoreResponse, type CreateScoreValue, type CreateSpanBody, type CreateSpanEvent, type CreateTextPromptRequest, type CreateUserRequest, type Dataset, type DatasetItem, type DatasetRun, type DatasetRunItem, type DatasetRunWithItems, DatasetStatus, type DeleteAnnotationQueueAssignmentResponse, type DeleteAnnotationQueueItemResponse, type DeleteDatasetItemResponse, type DeleteDatasetRunResponse, type DeleteMembershipRequest, type DeletePromptRequest, type DeleteTraceResponse, type DeleteTracesRequest, type EmptyResponse, Error$1 as Error, type FilterConfig, type GetAnnotationQueueItemsRequest, type GetAnnotationQueuesRequest, type GetCommentsRequest, type GetCommentsResponse, type GetDatasetItemsRequest, type GetDatasetRunsRequest, type GetDatasetsRequest, type GetLlmConnectionsRequest, type GetMediaResponse, type GetMediaUploadUrlRequest, type GetMediaUploadUrlResponse, type GetMetricsRequest, type GetMetricsV2Request, type GetModelsRequest, type GetObservationsRequest, type GetObservationsV2Request, type GetPromptRequest, type GetScoreConfigsRequest, type GetScoresRequest, type GetScoresResponse, GetScoresResponseData, type GetScoresResponseDataBoolean, type GetScoresResponseDataCategorical, type GetScoresResponseDataCorrection, type GetScoresResponseDataNumeric, type GetScoresResponseTraceData, type GetSessionsRequest, type GetTracesRequest, type HealthResponse, type IngestionError, IngestionEvent, type IngestionRequest, type IngestionResponse, type IngestionSuccess, type IngestionUsage, LANGFUSE_SDK_EXPERIMENT_ENVIRONMENT, LANGFUSE_SDK_NAME, LANGFUSE_SDK_VERSION, LANGFUSE_TRACER_NAME, LangfuseAPIClient, LangfuseAPIError, LangfuseAPITimeoutError, LangfuseMedia, type LangfuseMediaParams, LangfuseOtelContextKeys, LangfuseOtelSpanAttributes, type ListDatasetRunItemsRequest, type ListPromptsMetaRequest, type ListUsersRequest, LlmAdapter, type LlmConnection, LogLevel, Logger, type LoggerConfig, type MapValue, MediaContentType, type MembershipDeletionResponse, type MembershipRequest, type MembershipResponse, MembershipRole, type MembershipsResponse, MethodNotAllowedError, type MetricsResponse, type MetricsV2Response, type Model, type ModelPrice, ModelUsageUnit, NotFoundError, type NumericScore, type NumericScoreV1, type Observation, type ObservationBody, ObservationLevel, ObservationType, type Observations$1 as Observations, type ObservationsV2Meta, type ObservationsV2Response, type ObservationsView, type ObservationsViews, type OpenAiCompletionUsageSchema, type OpenAiResponseUsageSchema, type OpenAiUsage, type OptionalObservationBody, type Organization, type OrganizationApiKey, type OrganizationApiKeysResponse, type OrganizationProject, type OrganizationProjectsResponse, type OtelAttribute, type OtelAttributeValue, type OtelResource, type OtelResourceSpan, type OtelScope, type OtelScopeSpan, type OtelSpan, type OtelTraceRequest, type OtelTraceResponse, type PaginatedAnnotationQueueItems, type PaginatedAnnotationQueues, type PaginatedDatasetItems, type PaginatedDatasetRunItems, type PaginatedDatasetRuns, type PaginatedDatasets, type PaginatedLlmConnections, type PaginatedModels, type PaginatedSessions, type ParsedMediaReference, type PatchMediaBody, type PlaceholderMessage, type PricingTier, type PricingTierCondition, type PricingTierInput, PricingTierOperator, type Project, type ProjectDeletionResponse, type Projects$1 as Projects, Prompt, type PromptMeta, type PromptMetaListResponse, PromptType, type PropagateAttributesParams, type ResourceMeta, type ResourceType, type ResourceTypesResponse, type SchemaExtension, type SchemaResource, type SchemasResponse, type ScimEmail, type ScimFeatureSupport, type ScimName, type ScimUser, type ScimUsersListResponse, Score$1 as Score, type ScoreBody, type ScoreConfig, ScoreConfigDataType, type ScoreConfigs$1 as ScoreConfigs, ScoreDataType, type ScoreEvent, ScoreSource, ScoreV1, type SdkLogBody, type SdkLogEvent, type ServiceProviderConfig, ServiceUnavailableError, type Session, type SessionWithTraces, type Sort, type TextPrompt, type Trace$1 as Trace, type TraceBody, type TraceEvent, type TraceWithDetails, type TraceWithFullDetails, type Traces, UnauthorizedError, type UpdateAnnotationQueueItemRequest, type UpdateEventBody, type UpdateGenerationBody, type UpdateGenerationEvent, type UpdateObservationEvent, type UpdateProjectRequest, type UpdatePromptRequest, type UpdateScoreConfigRequest, type UpdateSpanBody, type UpdateSpanEvent, type UpsertLlmConnectionRequest, type Usage, type UsageDetails, type UserMeta, index$s as annotationQueues, base64Decode, base64Encode, base64ToBytes, index$r as blobStorageIntegrations, bytesToBase64, index$q as comments, index$p as commons, configureGlobalLogger, createExperimentId, createExperimentItemId, createLogger, index$o as datasetItems, index$n as datasetRunItems, index$m as datasets, generateUUID, getEnv, getGlobalLogger, getPropagatedAttributesFromContext, index$l as health, index$k as ingestion, index$j as llmConnections, LoggerSingleton as logger, index$i as media, index$g as metrics, index$h as metricsV2, index$f as models, index$d as observations, index$e as observationsV2, index$c as opentelemetry, index$b as organizations, index$a as projects, index as promptVersion, index$9 as prompts, propagateAttributes, resetGlobalLogger, safeSetTimeout, index$8 as scim, index$5 as score, index$7 as scoreConfigs, index$6 as scoreV2, serializeValue, index$4 as sessions, index$3 as trace, index$1 as utils };