@langfuse/core 4.4.2 → 4.4.4

package/dist/index.d.ts

@@ -846,8 +846,8 @@ interface BooleanScoreV1 extends BaseScoreV1 {
  */
 
 interface CategoricalScoreV1 extends BaseScoreV1 {
-    /** Only defined if a config is linked. Represents the numeric category mapping of the stringValue */
-    value?: number;
+    /** Represents the numeric category mapping of the stringValue. If no config is linked, defaults to 0. */
+    value: number;
     /** The string representation of the score value. If no config is linked, can be any string. Otherwise, must map to a config category */
     stringValue: string;
 }
@@ -929,8 +929,8 @@ interface BooleanScore extends BaseScore {
  */
 
 interface CategoricalScore extends BaseScore {
-    /** Only defined if a config is linked. Represents the numeric category mapping of the stringValue */
-    value?: number;
+    /** Represents the numeric category mapping of the stringValue. If no config is linked, defaults to 0. */
+    value: number;
     /** The string representation of the score value. If no config is linked, can be any string. Otherwise, must map to a config category */
     stringValue: string;
 }
@@ -1069,6 +1069,14 @@ interface DatasetRunWithItems extends DatasetRun {
 
 /**
  * Model definition used for transforming usage into USD cost and/or tokenization.
+ *
+ * Models can have either simple flat pricing or tiered pricing:
+ * - Flat pricing: Single price per usage type (legacy, but still supported)
+ * - Tiered pricing: Multiple pricing tiers with conditional matching based on usage patterns
+ *
+ * The pricing tiers approach is recommended for models with usage-based pricing variations.
+ * When using tiered pricing, the flat price fields (inputPrice, outputPrice, prices) are populated
+ * from the default tier for backward compatibility.
  */
 interface Model {
     id: string;
@@ -1091,8 +1099,27 @@ interface Model {
     /** Optional. Configuration for the selected tokenizer. Needs to be JSON. See docs for more details. */
     tokenizerConfig?: unknown;
     isLangfuseManaged: boolean;
-    /** Price (USD) by usage type */
+    /** Timestamp when the model was created */
+    createdAt: string;
+    /**
+     * Deprecated. Use 'pricingTiers' instead for models with usage-based pricing variations.
+     *
+     * This field shows prices by usage type from the default pricing tier. Maintained for backward compatibility.
+     * If the model uses tiered pricing, this field will be populated from the default tier's prices.
+     */
     prices: Record<string, ModelPrice>;
+    /**
+     * Array of pricing tiers with conditional pricing based on usage thresholds.
+     *
+     * Pricing tiers enable accurate cost tracking for models that charge different rates based on usage patterns
+     * (e.g., different rates for high-volume usage, large context windows, or cached tokens).
+     *
+     * Each model must have exactly one default tier (isDefault=true, priority=0) that serves as a fallback.
+     * Additional conditional tiers can be defined with specific matching criteria.
+     *
+     * If this array is empty, the model uses legacy flat pricing from the inputPrice/outputPrice/totalPrice fields.
+     */
+    pricingTiers: PricingTier[];
 }
 
 /**
@@ -1102,6 +1129,201 @@ interface ModelPrice {
     price: number;
 }
 
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+/**
+ * Condition for matching a pricing tier based on usage details. Used to implement tiered pricing models where costs vary based on usage thresholds.
+ *
+ * How it works:
+ * 1. The regex pattern matches against usage detail keys (e.g., "input_tokens", "input_cached")
+ * 2. Values of all matching keys are summed together
+ * 3. The sum is compared against the threshold value using the specified operator
+ * 4. All conditions in a tier must be met (AND logic) for the tier to match
+ *
+ * Common use cases:
+ * - Threshold-based pricing: Match when accumulated usage exceeds a certain amount
+ * - Usage-type-specific pricing: Different rates for cached vs non-cached tokens, or input vs output
+ * - Volume-based pricing: Different rates based on total request or token count
+ */
+interface PricingTierCondition {
+    /**
+     * Regex pattern to match against usage detail keys. All matching keys' values are summed for threshold comparison.
+     *
+     * Examples:
+     * - "^input" matches "input", "input_tokens", "input_cached", etc.
+     * - "^(input|prompt)" matches both "input_tokens" and "prompt_tokens"
+     * - "_cache$" matches "input_cache", "output_cache", etc.
+     *
+     * The pattern is case-insensitive by default. If no keys match, the sum is treated as zero.
+     */
+    usageDetailPattern: string;
+    /**
+     * Comparison operator to apply between the summed value and the threshold.
+     *
+     * - gt: greater than (sum > threshold)
+     * - gte: greater than or equal (sum >= threshold)
+     * - lt: less than (sum < threshold)
+     * - lte: less than or equal (sum <= threshold)
+     * - eq: equal (sum == threshold)
+     * - neq: not equal (sum != threshold)
+     */
+    operator: PricingTierOperator;
+    /** Threshold value for comparison. For token-based pricing, this is typically the token count threshold (e.g., 200000 for a 200K token threshold). */
+    value: number;
+    /** Whether the regex pattern matching is case-sensitive. Default is false (case-insensitive matching). */
+    caseSensitive: boolean;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+/**
+ * Pricing tier definition with conditional pricing based on usage thresholds.
+ *
+ * Pricing tiers enable accurate cost tracking for LLM providers that charge different rates based on usage patterns.
+ * For example, some providers charge higher rates when context size exceeds certain thresholds.
+ *
+ * How tier matching works:
+ * 1. Tiers are evaluated in ascending priority order (priority 1 before priority 2, etc.)
+ * 2. The first tier where ALL conditions match is selected
+ * 3. If no conditional tiers match, the default tier is used as a fallback
+ * 4. The default tier has priority 0 and no conditions
+ *
+ * Why priorities matter:
+ * - Lower priority numbers are evaluated first, allowing you to define specific cases before general ones
+ * - Example: Priority 1 for "high usage" (>200K tokens), Priority 2 for "medium usage" (>100K tokens), Priority 0 for default
+ * - Without proper ordering, a less specific condition might match before a more specific one
+ *
+ * Every model must have exactly one default tier to ensure cost calculation always succeeds.
+ */
+interface PricingTier {
+    /** Unique identifier for the pricing tier */
+    id: string;
+    /**
+     * Name of the pricing tier for display and identification purposes.
+     *
+     * Examples: "Standard", "High Volume Tier", "Large Context", "Extended Context Tier"
+     */
+    name: string;
+    /**
+     * Whether this is the default tier. Every model must have exactly one default tier with priority 0 and no conditions.
+     *
+     * The default tier serves as a fallback when no conditional tiers match, ensuring cost calculation always succeeds.
+     * It typically represents the base pricing for standard usage patterns.
+     */
+    isDefault: boolean;
+    /**
+     * Priority for tier matching evaluation. Lower numbers = higher priority (evaluated first).
+     *
+     * The default tier must always have priority 0. Conditional tiers should have priority 1, 2, 3, etc.
+     *
+     * Example ordering:
+     * - Priority 0: Default tier (no conditions, always matches as fallback)
+     * - Priority 1: High usage tier (e.g., >200K tokens)
+     * - Priority 2: Medium usage tier (e.g., >100K tokens)
+     *
+     * This ensures more specific conditions are checked before general ones.
+     */
+    priority: number;
+    /**
+     * Array of conditions that must ALL be met for this tier to match (AND logic).
+     *
+     * The default tier must have an empty conditions array. Conditional tiers should have one or more conditions
+     * that define when this tier's pricing applies.
+     *
+     * Multiple conditions enable complex matching scenarios (e.g., "high input tokens AND low output tokens").
+     */
+    conditions: PricingTierCondition[];
+    /**
+     * Prices (USD) by usage type for this tier.
+     *
+     * Common usage types: "input", "output", "total", "request", "image"
+     * Prices are specified in USD per unit (e.g., per token, per request, per second).
+     *
+     * Example: {"input": 0.000003, "output": 0.000015} means $3 per million input tokens and $15 per million output tokens.
+     */
+    prices: Record<string, number>;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+/**
+ * Input schema for creating a pricing tier. The tier ID will be automatically generated server-side.
+ *
+ * When creating a model with pricing tiers:
+ * - Exactly one tier must have isDefault=true (the fallback tier)
+ * - The default tier must have priority=0 and conditions=[]
+ * - All tier names and priorities must be unique within the model
+ * - Each tier must define at least one price
+ *
+ * See PricingTier for detailed information about how tiers work and why they're useful.
+ */
+interface PricingTierInput {
+    /**
+     * Name of the pricing tier for display and identification purposes.
+     *
+     * Must be unique within the model. Common patterns: "Standard", "High Volume Tier", "Extended Context"
+     */
+    name: string;
+    /**
+     * Whether this is the default tier. Exactly one tier per model must be marked as default.
+     *
+     * Requirements for default tier:
+     * - Must have isDefault=true
+     * - Must have priority=0
+     * - Must have empty conditions array (conditions=[])
+     *
+     * The default tier acts as a fallback when no conditional tiers match.
+     */
+    isDefault: boolean;
+    /**
+     * Priority for tier matching evaluation. Lower numbers = higher priority (evaluated first).
+     *
+     * Must be unique within the model. The default tier must have priority=0.
+     * Conditional tiers should use priority 1, 2, 3, etc. based on their specificity.
+     */
+    priority: number;
+    /**
+     * Array of conditions that must ALL be met for this tier to match (AND logic).
+     *
+     * The default tier must have an empty array (conditions=[]).
+     * Conditional tiers should define one or more conditions that specify when this tier's pricing applies.
+     *
+     * Each condition specifies a regex pattern, operator, and threshold value for matching against usage details.
+     */
+    conditions: PricingTierCondition[];
+    /**
+     * Prices (USD) by usage type for this tier. At least one price must be defined.
+     *
+     * Common usage types: "input", "output", "total", "request", "image"
+     * Prices are in USD per unit (e.g., per token).
+     *
+     * Example: {"input": 0.000003, "output": 0.000015} represents $3 per million input tokens and $15 per million output tokens.
+     */
+    prices: Record<string, number>;
+}
+
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Comparison operators for pricing tier conditions
+ */
+type PricingTierOperator = "gt" | "gte" | "lt" | "lte" | "eq" | "neq";
+declare const PricingTierOperator: {
+    readonly Gt: "gt";
+    readonly Gte: "gte";
+    readonly Lt: "lt";
+    readonly Lte: "lte";
+    readonly Eq: "eq";
+    readonly Neq: "neq";
+};
+
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
@@ -1345,6 +1567,10 @@ type index$n_NumericScoreV1 = NumericScoreV1;
 type index$n_Observation = Observation;
 declare const index$n_ObservationLevel: typeof ObservationLevel;
 type index$n_ObservationsView = ObservationsView;
+type index$n_PricingTier = PricingTier;
+type index$n_PricingTierCondition = PricingTierCondition;
+type index$n_PricingTierInput = PricingTierInput;
+declare const index$n_PricingTierOperator: typeof PricingTierOperator;
 type index$n_ScoreConfig = ScoreConfig;
 declare const index$n_ScoreDataType: typeof ScoreDataType;
 declare const index$n_ScoreSource: typeof ScoreSource;
@@ -1357,7 +1583,7 @@ type index$n_UnauthorizedError = UnauthorizedError;
 declare const index$n_UnauthorizedError: typeof UnauthorizedError;
 type index$n_Usage = Usage;
 declare namespace index$n {
-  export { index$n_AccessDeniedError as AccessDeniedError, type index$n_BaseScore as BaseScore, type index$n_BaseScoreV1 as BaseScoreV1, type index$n_BooleanScore as BooleanScore, type index$n_BooleanScoreV1 as BooleanScoreV1, type index$n_CategoricalScore as CategoricalScore, type index$n_CategoricalScoreV1 as CategoricalScoreV1, type index$n_Comment as Comment, index$n_CommentObjectType as CommentObjectType, type index$n_ConfigCategory as ConfigCategory, type index$n_CreateScoreValue as CreateScoreValue, type index$n_Dataset as Dataset, type index$n_DatasetItem as DatasetItem, type index$n_DatasetRun as DatasetRun, type index$n_DatasetRunItem as DatasetRunItem, type index$n_DatasetRunWithItems as DatasetRunWithItems, index$n_DatasetStatus as DatasetStatus, Error$1 as Error, type index$n_MapValue as MapValue, index$n_MethodNotAllowedError as MethodNotAllowedError, type index$n_Model as Model, type index$n_ModelPrice as ModelPrice, index$n_ModelUsageUnit as ModelUsageUnit, index$n_NotFoundError as NotFoundError, type index$n_NumericScore as NumericScore, type index$n_NumericScoreV1 as NumericScoreV1, type index$n_Observation as Observation, index$n_ObservationLevel as ObservationLevel, type index$n_ObservationsView as ObservationsView, Score$1 as Score, type index$n_ScoreConfig as ScoreConfig, index$n_ScoreDataType as ScoreDataType, index$n_ScoreSource as ScoreSource, index$n_ScoreV1 as ScoreV1, type index$n_Session as Session, type index$n_SessionWithTraces as SessionWithTraces, type Trace$1 as Trace, type index$n_TraceWithDetails as TraceWithDetails, type index$n_TraceWithFullDetails as TraceWithFullDetails, index$n_UnauthorizedError as UnauthorizedError, type index$n_Usage as Usage };
+  export { index$n_AccessDeniedError as AccessDeniedError, type index$n_BaseScore as BaseScore, type index$n_BaseScoreV1 as BaseScoreV1, type index$n_BooleanScore as BooleanScore, type index$n_BooleanScoreV1 as BooleanScoreV1, type index$n_CategoricalScore as CategoricalScore, type index$n_CategoricalScoreV1 as CategoricalScoreV1, type index$n_Comment as Comment, index$n_CommentObjectType as CommentObjectType, type index$n_ConfigCategory as ConfigCategory, type index$n_CreateScoreValue as CreateScoreValue, type index$n_Dataset as Dataset, type index$n_DatasetItem as DatasetItem, type index$n_DatasetRun as DatasetRun, type index$n_DatasetRunItem as DatasetRunItem, type index$n_DatasetRunWithItems as DatasetRunWithItems, index$n_DatasetStatus as DatasetStatus, Error$1 as Error, type index$n_MapValue as MapValue, index$n_MethodNotAllowedError as MethodNotAllowedError, type index$n_Model as Model, type index$n_ModelPrice as ModelPrice, index$n_ModelUsageUnit as ModelUsageUnit, index$n_NotFoundError as NotFoundError, type index$n_NumericScore as NumericScore, type index$n_NumericScoreV1 as NumericScoreV1, type index$n_Observation as Observation, index$n_ObservationLevel as ObservationLevel, type index$n_ObservationsView as ObservationsView, type index$n_PricingTier as PricingTier, type index$n_PricingTierCondition as PricingTierCondition, type index$n_PricingTierInput as PricingTierInput, index$n_PricingTierOperator as PricingTierOperator, Score$1 as Score, type index$n_ScoreConfig as ScoreConfig, index$n_ScoreDataType as ScoreDataType, index$n_ScoreSource as ScoreSource, index$n_ScoreV1 as ScoreV1, type index$n_Session as Session, type index$n_SessionWithTraces as SessionWithTraces, type Trace$1 as Trace, type index$n_TraceWithDetails as TraceWithDetails, type index$n_TraceWithFullDetails as TraceWithFullDetails, index$n_UnauthorizedError as UnauthorizedError, type index$n_Usage as Usage };
 }
 
 /**
@@ -2186,6 +2412,8 @@ interface LlmConnection {
     withDefaultModels: boolean;
     /** Keys of extra headers sent with requests (values excluded for security) */
     extraHeaderKeys: string[];
+    /** Adapter-specific configuration. Required for Bedrock (`{"region":"us-east-1"}`), optional for VertexAI (`{"location":"us-central1"}`), not used by other adapters. */
+    config?: Record<string, unknown>;
     createdAt: string;
     updatedAt: string;
 }
@@ -2221,6 +2449,8 @@ interface UpsertLlmConnectionRequest {
     withDefaultModels?: boolean;
     /** Extra headers to send with requests */
     extraHeaders?: Record<string, string>;
+    /** Adapter-specific configuration. Validation rules: - **Bedrock**: Required. Must be `{"region": "<aws-region>"}` (e.g., `{"region":"us-east-1"}`) - **VertexAI**: Optional. If provided, must be `{"location": "<gcp-location>"}` (e.g., `{"location":"us-central1"}`) - **Other adapters**: Not supported. Omit this field or set to null. */
+    config?: Record<string, unknown>;
 }
 
 /**
@@ -2325,7 +2555,7 @@ interface GetMediaUploadUrlResponse {
 /**
  * The MIME type of the media record
  */
-type MediaContentType = "image/png" | "image/jpeg" | "image/jpg" | "image/webp" | "image/gif" | "image/svg+xml" | "image/tiff" | "image/bmp" | "audio/mpeg" | "audio/mp3" | "audio/wav" | "audio/ogg" | "audio/oga" | "audio/aac" | "audio/mp4" | "audio/flac" | "video/mp4" | "video/webm" | "text/plain" | "text/html" | "text/css" | "text/csv" | "application/pdf" | "application/msword" | "application/vnd.ms-excel" | "application/zip" | "application/json" | "application/xml" | "application/octet-stream";
+type MediaContentType = "image/png" | "image/jpeg" | "image/jpg" | "image/webp" | "image/gif" | "image/svg+xml" | "image/tiff" | "image/bmp" | "image/avif" | "image/heic" | "audio/mpeg" | "audio/mp3" | "audio/wav" | "audio/ogg" | "audio/oga" | "audio/aac" | "audio/mp4" | "audio/flac" | "audio/opus" | "audio/webm" | "video/mp4" | "video/webm" | "video/ogg" | "video/mpeg" | "video/quicktime" | "video/x-msvideo" | "video/x-matroska" | "text/plain" | "text/html" | "text/css" | "text/csv" | "text/markdown" | "text/x-python" | "application/javascript" | "text/x-typescript" | "application/x-yaml" | "application/pdf" | "application/msword" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/zip" | "application/json" | "application/xml" | "application/octet-stream" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/rtf" | "application/x-ndjson" | "application/vnd.apache.parquet" | "application/gzip" | "application/x-tar" | "application/x-7z-compressed";
 declare const MediaContentType: {
     readonly ImagePng: "image/png";
     readonly ImageJpeg: "image/jpeg";
@@ -2335,6 +2565,8 @@ declare const MediaContentType: {
     readonly ImageSvgXml: "image/svg+xml";
     readonly ImageTiff: "image/tiff";
     readonly ImageBmp: "image/bmp";
+    readonly ImageAvif: "image/avif";
+    readonly ImageHeic: "image/heic";
     readonly AudioMpeg: "audio/mpeg";
     readonly AudioMp3: "audio/mp3";
     readonly AudioWav: "audio/wav";
@@ -2343,19 +2575,40 @@ declare const MediaContentType: {
     readonly AudioAac: "audio/aac";
     readonly AudioMp4: "audio/mp4";
     readonly AudioFlac: "audio/flac";
+    readonly AudioOpus: "audio/opus";
+    readonly AudioWebm: "audio/webm";
     readonly VideoMp4: "video/mp4";
     readonly VideoWebm: "video/webm";
+    readonly VideoOgg: "video/ogg";
+    readonly VideoMpeg: "video/mpeg";
+    readonly VideoQuicktime: "video/quicktime";
+    readonly VideoXMsvideo: "video/x-msvideo";
+    readonly VideoXMatroska: "video/x-matroska";
     readonly TextPlain: "text/plain";
     readonly TextHtml: "text/html";
     readonly TextCss: "text/css";
     readonly TextCsv: "text/csv";
+    readonly TextMarkdown: "text/markdown";
+    readonly TextXPython: "text/x-python";
+    readonly ApplicationJavascript: "application/javascript";
+    readonly TextXTypescript: "text/x-typescript";
+    readonly ApplicationXYaml: "application/x-yaml";
     readonly ApplicationPdf: "application/pdf";
     readonly ApplicationMsword: "application/msword";
     readonly ApplicationMsExcel: "application/vnd.ms-excel";
+    readonly ApplicationOpenxmlSpreadsheet: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
     readonly ApplicationZip: "application/zip";
     readonly ApplicationJson: "application/json";
     readonly ApplicationXml: "application/xml";
     readonly ApplicationOctetStream: "application/octet-stream";
+    readonly ApplicationOpenxmlWord: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    readonly ApplicationOpenxmlPresentation: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+    readonly ApplicationRtf: "application/rtf";
+    readonly ApplicationXNdjson: "application/x-ndjson";
+    readonly ApplicationParquet: "application/vnd.apache.parquet";
+    readonly ApplicationGzip: "application/gzip";
+    readonly ApplicationXTar: "application/x-tar";
+    readonly ApplicationX7ZCompressed: "application/x-7z-compressed";
 };
 
 type index$g_GetMediaResponse = GetMediaResponse;
@@ -2463,12 +2716,33 @@ interface CreateModelRequest {
     startDate?: string;
     /** Unit used by this model. */
     unit?: ModelUsageUnit;
-    /** Price (USD) per input unit */
+    /** Deprecated. Use 'pricingTiers' instead. Price (USD) per input unit. Creates a default tier if pricingTiers not provided. */
     inputPrice?: number;
-    /** Price (USD) per output unit */
+    /** Deprecated. Use 'pricingTiers' instead. Price (USD) per output unit. Creates a default tier if pricingTiers not provided. */
     outputPrice?: number;
-    /** Price (USD) per total units. Cannot be set if input or output price is set. */
+    /** Deprecated. Use 'pricingTiers' instead. Price (USD) per total units. Cannot be set if input or output price is set. Creates a default tier if pricingTiers not provided. */
     totalPrice?: number;
+    /**
+     * Optional. Array of pricing tiers for this model.
+     *
+     * Use pricing tiers for all models - both those with threshold-based pricing variations and those with simple flat pricing:
+     *
+     * - For models with standard flat pricing: Create a single default tier with your prices
+     *   (e.g., one tier with isDefault=true, priority=0, conditions=[], and your standard prices)
+     *
+     * - For models with threshold-based pricing: Create a default tier plus additional conditional tiers
+     *   (e.g., default tier for standard usage + high-volume tier for usage above certain thresholds)
+     *
+     * Requirements:
+     * - Cannot be provided with flat prices (inputPrice/outputPrice/totalPrice) - use one approach or the other
+     * - Must include exactly one default tier with isDefault=true, priority=0, and conditions=[]
+     * - All tier names and priorities must be unique within the model
+     * - Each tier must define at least one price
+     *
+     * If omitted, you must provide flat prices instead (inputPrice/outputPrice/totalPrice),
+     * which will automatically create a single default tier named "Standard".
+     */
+    pricingTiers?: PricingTierInput[];
     /** Optional. Tokenizer to be applied to observations which match to this model. See docs for more details. */
     tokenizerId?: string;
     /** Optional. Configuration for the selected tokenizer. Needs to be JSON. See docs for more details. */
@@ -2606,10 +2880,6 @@ interface GetObservationsRequest {
      * ### Structured Data
      * - `metadata` (stringObject/numberObject/categoryOptions) - Metadata key-value pairs. Use `key` parameter to filter on specific metadata keys.
      *
-     * ### Scores (requires join with scores table)
-     * - `scores_avg` (number) - Average of numeric scores (alias: `scores`)
-     * - `score_categories` (categoryOptions) - Categorical score values
-     *
      * ### Associated Trace Fields (requires join with traces table)
      * - `userId` (string) - User ID from associated trace
      * - `traceName` (string) - Name from associated trace
@@ -3710,6 +3980,10 @@ interface GetScoresRequest {
     configId?: string;
     /** Retrieve only scores with a specific sessionId. */
     sessionId?: string;
+    /** Retrieve only scores with a specific datasetRunId. */
+    datasetRunId?: string;
+    /** Retrieve only scores with a specific traceId. */
+    traceId?: string;
     /** Retrieve only scores with a specific annotation queueId. */
     queueId?: string;
     /** Retrieve only scores with a specific dataType. */
@@ -5178,7 +5452,8 @@ declare class LlmConnections {
      *         baseURL: undefined,
      *         customModels: undefined,
      *         withDefaultModels: undefined,
-     *         extraHeaders: undefined
+     *         extraHeaders: undefined,
+     *         config: undefined
      *     })
      */
     upsert(request: UpsertLlmConnectionRequest, requestOptions?: LlmConnections.RequestOptions): HttpResponsePromise<LlmConnection>;
@@ -5424,6 +5699,7 @@ declare class Models {
      *         inputPrice: undefined,
      *         outputPrice: undefined,
      *         totalPrice: undefined,
+     *         pricingTiers: undefined,
      *         tokenizerId: undefined,
      *         tokenizerConfig: undefined
      *     })
@@ -6090,7 +6366,8 @@ declare class PromptVersion {
     /**
      * Update labels for a specific prompt version
      *
-     * @param {string} name - The name of the prompt
+     * @param {string} name - The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"),
+     *                        the folder path must be URL encoded.
      * @param {number} version - Version of the prompt to update
      * @param {LangfuseAPI.UpdatePromptRequest} request
      * @param {PromptVersion.RequestOptions} requestOptions - Request-specific configuration.
@@ -6156,7 +6433,8 @@ declare class Prompts {
     /**
      * Get a prompt
      *
-     * @param {string} promptName - The name of the prompt
+     * @param {string} promptName - The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"),
+     *                              the folder path must be URL encoded.
      * @param {LangfuseAPI.GetPromptRequest} request
      * @param {Prompts.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -7341,4 +7619,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 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 GetModelsRequest, type GetObservationsRequest, 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 Model, type ModelPrice, ModelUsageUnit, NotFoundError, type NumericScore, type NumericScoreV1, type Observation, type ObservationBody, ObservationLevel, ObservationType, type Observations$1 as Observations, 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 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$q as annotationQueues, base64Decode, base64Encode, base64ToBytes, index$p as blobStorageIntegrations, bytesToBase64, index$o as comments, index$n as commons, configureGlobalLogger, createExperimentId, createExperimentItemId, createLogger, index$m as datasetItems, index$l as datasetRunItems, index$k as datasets, generateUUID, getEnv, getGlobalLogger, getPropagatedAttributesFromContext, index$j as health, index$i as ingestion, index$h as llmConnections, LoggerSingleton as logger, index$g as media, index$f as metrics, index$e as models, index$d as observations, 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 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 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 GetModelsRequest, type GetObservationsRequest, 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 Model, type ModelPrice, ModelUsageUnit, NotFoundError, type NumericScore, type NumericScoreV1, type Observation, type ObservationBody, ObservationLevel, ObservationType, type Observations$1 as Observations, 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$q as annotationQueues, base64Decode, base64Encode, base64ToBytes, index$p as blobStorageIntegrations, bytesToBase64, index$o as comments, index$n as commons, configureGlobalLogger, createExperimentId, createExperimentItemId, createLogger, index$m as datasetItems, index$l as datasetRunItems, index$k as datasets, generateUUID, getEnv, getGlobalLogger, getPropagatedAttributesFromContext, index$j as health, index$i as ingestion, index$h as llmConnections, LoggerSingleton as logger, index$g as media, index$f as metrics, index$e as models, index$d as observations, 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 };

package/dist/index.mjs

@@ -253,7 +253,7 @@ var resetGlobalLogger = () => {
 // package.json
 var package_default = {
   name: "@langfuse/core",
-  version: "4.4.2",
+  version: "4.4.4",
   description: "Core functions and utilities for Langfuse packages",
   type: "module",
   sideEffects: false,
@@ -404,11 +404,22 @@ __export(commons_exports, {
   ModelUsageUnit: () => ModelUsageUnit,
   NotFoundError: () => NotFoundError,
   ObservationLevel: () => ObservationLevel,
+  PricingTierOperator: () => PricingTierOperator,
   ScoreDataType: () => ScoreDataType,
   ScoreSource: () => ScoreSource,
   UnauthorizedError: () => UnauthorizedError
 });
 
+// src/api/api/resources/commons/types/PricingTierOperator.ts
+var PricingTierOperator = {
+  Gt: "gt",
+  Gte: "gte",
+  Lt: "lt",
+  Lte: "lte",
+  Eq: "eq",
+  Neq: "neq"
+};
+
 // src/api/api/resources/commons/types/ModelUsageUnit.ts
 var ModelUsageUnit = {
   Characters: "CHARACTERS",
@@ -648,6 +659,8 @@ var MediaContentType = {
   ImageSvgXml: "image/svg+xml",
   ImageTiff: "image/tiff",
   ImageBmp: "image/bmp",
+  ImageAvif: "image/avif",
+  ImageHeic: "image/heic",
   AudioMpeg: "audio/mpeg",
   AudioMp3: "audio/mp3",
   AudioWav: "audio/wav",
@@ -656,19 +669,40 @@ var MediaContentType = {
   AudioAac: "audio/aac",
   AudioMp4: "audio/mp4",
   AudioFlac: "audio/flac",
+  AudioOpus: "audio/opus",
+  AudioWebm: "audio/webm",
   VideoMp4: "video/mp4",
   VideoWebm: "video/webm",
+  VideoOgg: "video/ogg",
+  VideoMpeg: "video/mpeg",
+  VideoQuicktime: "video/quicktime",
+  VideoXMsvideo: "video/x-msvideo",
+  VideoXMatroska: "video/x-matroska",
   TextPlain: "text/plain",
   TextHtml: "text/html",
   TextCss: "text/css",
   TextCsv: "text/csv",
+  TextMarkdown: "text/markdown",
+  TextXPython: "text/x-python",
+  ApplicationJavascript: "application/javascript",
+  TextXTypescript: "text/x-typescript",
+  ApplicationXYaml: "application/x-yaml",
   ApplicationPdf: "application/pdf",
   ApplicationMsword: "application/msword",
   ApplicationMsExcel: "application/vnd.ms-excel",
+  ApplicationOpenxmlSpreadsheet: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
   ApplicationZip: "application/zip",
   ApplicationJson: "application/json",
   ApplicationXml: "application/xml",
-  ApplicationOctetStream: "application/octet-stream"
+  ApplicationOctetStream: "application/octet-stream",
+  ApplicationOpenxmlWord: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  ApplicationOpenxmlPresentation: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  ApplicationRtf: "application/rtf",
+  ApplicationXNdjson: "application/x-ndjson",
+  ApplicationParquet: "application/vnd.apache.parquet",
+  ApplicationGzip: "application/gzip",
+  ApplicationXTar: "application/x-tar",
+  ApplicationX7ZCompressed: "application/x-7z-compressed"
 };
 
 // src/api/api/resources/metrics/index.ts
@@ -5098,7 +5132,8 @@ var LlmConnections = class {
    *         baseURL: undefined,
    *         customModels: undefined,
    *         withDefaultModels: undefined,
-   *         extraHeaders: undefined
+   *         extraHeaders: undefined,
+   *         config: undefined
    *     })
    */
   upsert(request, requestOptions) {
@@ -5702,6 +5737,7 @@ var Models = class {
    *         inputPrice: undefined,
    *         outputPrice: undefined,
    *         totalPrice: undefined,
+   *         pricingTiers: undefined,
    *         tokenizerId: undefined,
    *         tokenizerConfig: undefined
    *     })
@@ -8212,7 +8248,8 @@ var PromptVersion = class {
   /**
    * Update labels for a specific prompt version
    *
-   * @param {string} name - The name of the prompt
+   * @param {string} name - The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"),
+   *                        the folder path must be URL encoded.
    * @param {number} version - Version of the prompt to update
    * @param {LangfuseAPI.UpdatePromptRequest} request
    * @param {PromptVersion.RequestOptions} requestOptions - Request-specific configuration.
@@ -8340,7 +8377,8 @@ var Prompts = class {
   /**
    * Get a prompt
    *
-   * @param {string} promptName - The name of the prompt
+   * @param {string} promptName - The name of the prompt. If the prompt is in a folder (e.g., "folder/subfolder/prompt-name"),
+   *                              the folder path must be URL encoded.
    * @param {LangfuseAPI.GetPromptRequest} request
    * @param {Prompts.RequestOptions} requestOptions - Request-specific configuration.
    *
@@ -9968,6 +10006,8 @@ var ScoreV2 = class {
       scoreIds,
       configId,
       sessionId,
+      datasetRunId,
+      traceId,
       queueId,
       dataType,
       traceTags
@@ -10016,6 +10056,12 @@ var ScoreV2 = class {
     if (sessionId != null) {
       _queryParams["sessionId"] = sessionId;
     }
+    if (datasetRunId != null) {
+      _queryParams["datasetRunId"] = datasetRunId;
+    }
+    if (traceId != null) {
+      _queryParams["traceId"] = traceId;
+    }
     if (queueId != null) {
       _queryParams["queueId"] = queueId;
     }
@@ -11886,6 +11932,7 @@ export {
   NotFoundError,
   ObservationLevel,
   ObservationType,
+  PricingTierOperator,
   PromptType,
   ScoreDataType,
   ScoreSource,