Merge branch 'main' into codex/fix-langchain-stream-events-ttft

Author: JYbill

.github/workflows/codeql.yml

@@ -52,7 +52,7 @@ jobs:
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@5595ccaf912efad79be6eef63a5619ff05969be3 # v4.37.6
+        uses: github/codeql-action/init@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
         with:
           languages: ${{ matrix.language }}
           # If you wish to specify custom queries, you can do so here or in a config file.
@@ -70,7 +70,7 @@ jobs:
       # Autobuild attempts to build any compiled languages (C/C++, C#, Go, Java, or Swift).
       # If this step fails, then you should remove it and run the build manually (see below)
       - name: Autobuild
-        uses: github/codeql-action/autobuild@5595ccaf912efad79be6eef63a5619ff05969be3 # v4.37.6
+        uses: github/codeql-action/autobuild@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
 
       # ℹ️ Command-line programs to run using the OS shell.
       # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
@@ -83,6 +83,6 @@ jobs:
       #     ./location_of_script_within_repo/buildscript.sh
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@5595ccaf912efad79be6eef63a5619ff05969be3 # v4.37.6
+        uses: github/codeql-action/analyze@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
         with:
           category: "/language:${{matrix.language}}"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "langfuse-js",
-  "version": "5.10.1",
+  "version": "5.11.0",
   "description": "Langfuse JavaScript / TypeScript SDK",
   "author": "Langfuse",
   "license": "MIT",

packages/browser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langfuse/browser",
-  "version": "5.10.1",
+  "version": "5.11.0",
   "description": "Langfuse browser SDK for public-key score ingestion",
   "type": "module",
   "sideEffects": false,

packages/client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langfuse/client",
-  "version": "5.10.1",
+  "version": "5.11.0",
   "description": "Langfuse API client for universal JavaScript environments",
   "type": "module",
   "sideEffects": false,

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langfuse/core",
-  "version": "5.10.1",
+  "version": "5.11.0",
   "description": "Core functions and utilities for Langfuse packages",
   "type": "module",
   "sideEffects": false,

packages/core/src/api/Client.ts

@@ -10,6 +10,8 @@ import { Comments } from "./api/resources/comments/client/Client.js";
 import { DatasetItems } from "./api/resources/datasetItems/client/Client.js";
 import { DatasetRunItems } from "./api/resources/datasetRunItems/client/Client.js";
 import { Datasets } from "./api/resources/datasets/client/Client.js";
+import { EvaluationRules } from "./api/resources/evaluationRules/client/Client.js";
+import { Evaluators } from "./api/resources/evaluators/client/Client.js";
 import { Experiments } from "./api/resources/experiments/client/Client.js";
 import { Feedback } from "./api/resources/feedback/client/Client.js";
 import { Health } from "./api/resources/health/client/Client.js";
@@ -84,6 +86,8 @@ export class LangfuseAPIClient {
   protected _datasetItems: DatasetItems | undefined;
   protected _datasetRunItems: DatasetRunItems | undefined;
   protected _datasets: Datasets | undefined;
+  protected _evaluationRules: EvaluationRules | undefined;
+  protected _evaluators: Evaluators | undefined;
   protected _experiments: Experiments | undefined;
   protected _feedback: Feedback | undefined;
   protected _health: Health | undefined;
@@ -147,6 +151,14 @@ export class LangfuseAPIClient {
     return (this._datasets ??= new Datasets(this._options));
   }
 
+  public get evaluationRules(): EvaluationRules {
+    return (this._evaluationRules ??= new EvaluationRules(this._options));
+  }
+
+  public get evaluators(): Evaluators {
+    return (this._evaluators ??= new Evaluators(this._options));
+  }
+
   public get experiments(): Experiments {
     return (this._experiments ??= new Experiments(this._options));
   }

packages/core/src/api/api/resources/commons/types/Model.ts

@@ -9,7 +9,7 @@ import * as LangfuseAPI from "../../../index.js";
  *
  * 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
+ * - Tiered pricing: Multiple pricing tiers with conditional matching based on usage patterns or observation attributes
  *
  * 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
@@ -46,10 +46,10 @@ export interface Model {
    */
   prices: Record<string, LangfuseAPI.ModelPrice>;
   /**
-   * Array of pricing tiers with conditional pricing based on usage thresholds.
+   * Array of pricing tiers with conditional pricing based on usage thresholds or observation attributes.
    *
    * 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).
+   * or request attributes (e.g., high-volume usage, large context windows, cached tokens, or service tiers).
    *
    * 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.

packages/core/src/api/api/resources/commons/types/PricingTier.ts

@@ -5,10 +5,10 @@
 import * as LangfuseAPI from "../../../index.js";
 
 /**
- * Pricing tier definition with conditional pricing based on usage thresholds.
+ * Pricing tier definition with conditional pricing based on usage thresholds or observation attributes.
  *
- * 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.
+ * Pricing tiers enable accurate cost tracking for LLM providers that charge different rates based on usage patterns or request attributes.
+ * For example, some providers charge higher rates when context size exceeds certain thresholds or when an accelerated service tier is selected.
  *
  * How tier matching works:
  * 1. Tiers are evaluated in ascending priority order (priority 1 before priority 2, etc.)

packages/core/src/api/api/resources/commons/types/PricingTierAttributeCondition.ts

@@ -0,0 +1,19 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+import * as LangfuseAPI from "../../../index.js";
+
+/**
+ * Condition that matches any configured value for a top-level observation attribute.
+ */
+export interface PricingTierAttributeCondition {
+  /** Observation attribute object evaluated by this condition. */
+  source: LangfuseAPI.PricingTierAttributeSource;
+  /** Exact top-level attribute key. */
+  key: string;
+  /** Membership operator. */
+  operator: "in";
+  /** Accepted string attribute values. At least one value is required. */
+  values: string[];
+}

packages/core/src/api/api/resources/commons/types/PricingTierAttributeSource.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+
+export type PricingTierAttributeSource = "model_parameters" | "metadata";
+export const PricingTierAttributeSource = {
+  ModelParameters: "model_parameters",
+  Metadata: "metadata",
+} as const;