feat(api): update API spec from langfuse/langfuse 966662e

[langfuse-bot]

Important

This PR adds a new CorrectionScore type, updates dataset item handling for versioning, and integrates the new score type into the API.

• New Features:
  • Introduces CorrectionScore in correction_score.py.
  • Adds Score_Correction to score.py and GetScoresResponseData_Correction to get_scores_response_data.py.
• API Changes:
  • Updates DatasetItemsClient in dataset_items/client.py to support versioned dataset retrieval.
  • Adds dataset_version to CreateDatasetRunItemRequest in create_dataset_run_item_request.py.
• Integration:
  • Updates imports and __all__ lists in __init__.py files across commons, score_v_2, and types directories to include new score types.
  • Modifies GetScoresResponseDataCorrection in get_scores_response_data_correction.py to extend CorrectionScore.

^{This description was created by for c2dd867. You can customize this summary. It will automatically update as commits are pushed.}

Disclaimer: Experimental PR review

Greptile Overview

Greptile Summary

This PR updates the Python SDK API specification from the upstream Langfuse repository (commit 966662e), adding two major features:

1. Correction Score Type

• Introduces a new CORRECTION score data type alongside existing NUMERIC, CATEGORICAL, and BOOLEAN types
• Adds CorrectionScore class extending BaseScore with value (always 0) and stringValue fields
• Adds Score_Correction and GetScoresResponseData_Correction variants to union types
• Updates all import/export chains to include the new correction types

2. Dataset Versioning

• Adds optional version parameter to DatasetItemsClient.list() method to retrieve dataset items at a specific point in time
• Adds optional datasetVersion field to CreateDatasetRunItemRequest to pin experiment runs to specific dataset versions
• Both use ISO 8601 timestamps (RFC 3339) in UTC format

The changes are auto-generated by Fern from the API definition, ensuring consistency with the backend API. All modified files follow established patterns for Pydantic models, client methods, and type unions. The changes are purely additive—no existing functionality is removed or modified.

Confidence Score: 5/5

• This PR is safe to merge with no issues found
• All changes are auto-generated from the upstream API specification using Fern, following consistent patterns throughout the codebase. The additions are purely additive with no breaking changes. Type safety is maintained through proper Pydantic models and union types. The code follows existing conventions for serialization, field aliases, and model configuration.
• No files require special attention

Important Files Changed

Filename	Overview
langfuse/api/resources/commons/types/correction_score.py	New Pydantic model for correction scores extending BaseScore with value (float) and stringValue fields
langfuse/api/resources/commons/types/score.py	Added Score_Correction variant to the Score union type with CORRECTION data type
langfuse/api/resources/dataset_items/client.py	Added optional version parameter to list() method for point-in-time dataset item retrieval
langfuse/api/resources/dataset_run_items/types/create_dataset_run_item_request.py	Added optional datasetVersion timestamp field to specify dataset version for experiment runs
langfuse/api/resources/score_v_2/types/get_scores_response_data_correction.py	New response model for correction scores extending CorrectionScore with optional trace data

Sequence Diagram

sequenceDiagram
    participant Client
    participant DatasetItemsAPI
    participant ScoreAPI
    participant Database

    Note over Client,Database: New Correction Score Feature
    Client->>ScoreAPI: Create/Get Score (with CORRECTION type)
    ScoreAPI->>Database: Store/Retrieve CorrectionScore
    Database-->>ScoreAPI: Return correction with value=0, stringValue
    ScoreAPI-->>Client: Return Score_Correction

    Note over Client,Database: Dataset Versioning Feature
    Client->>DatasetItemsAPI: list(version="2026-01-21T14:35:42Z")
    DatasetItemsAPI->>Database: Query items at timestamp
    Database-->>DatasetItemsAPI: Return historical dataset items
    DatasetItemsAPI-->>Client: PaginatedDatasetItems

    Client->>DatasetItemsAPI: create_dataset_run_item(datasetVersion="2026-01-21T14:35:42Z")
    DatasetItemsAPI->>Database: Link run to dataset version
    Database-->>DatasetItemsAPI: Confirm run created
    DatasetItemsAPI-->>Client: Dataset run item created

Loading

[greptile-apps]

_{5 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}