@langfuse/core 5.5.0-beta.2 → 5.5.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -458,9 +458,9 @@ declare const BlobStorageExportFrequency: {
458
458
  */
459
459
  /**
460
460
  * What data the integration exports.
461
- * - `LEGACY_TRACES_OBSERVATIONS`: traces, observations, and scores tables with a fixed column set. The `exportFieldGroups` field is not applicable.
461
+ * - `LEGACY_TRACES_OBSERVATIONS`: traces, observations, and scores tables. Observation columns are controlled by `exportFieldGroups`; field groups without a counterpart in this data model (e.g. `trace_context`) are omitted.
462
462
  * - `OBSERVATIONS_V2`: same data model as the `/api/public/v2/observations` endpoint, plus scores. Columns are controlled by `exportFieldGroups`.
463
- * - `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS`: both sets. For the `OBSERVATIONS_V2` portion, columns are controlled by `exportFieldGroups`.
463
+ * - `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS`: both sets. Observation columns of both portions are controlled by `exportFieldGroups`.
464
464
  *
465
465
  * **Note:** `OBSERVATIONS_V2` and the enriched-observations portion of `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` rely on the enriched observations table (Langfuse Fast Preview / v4), which is currently available on Langfuse Cloud only. See https://langfuse.com/docs/v4.
466
466
  */
@@ -475,7 +475,7 @@ declare const BlobStorageExportSource: {
475
475
  * This file was auto-generated by Fern from our API Definition.
476
476
  */
477
477
  /**
478
- * Field group for the OBSERVATIONS_V2 and LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS export.
478
+ * Field group selecting which observation columns are included in the export. Applies to all export sources; groups without a counterpart in the legacy data model (e.g. `trace_context`) are omitted from the legacy observations export.
479
479
  */
480
480
  type BlobStorageExportFieldGroup = "core" | "basic" | "time" | "io" | "metadata" | "model" | "usage" | "prompt" | "metrics" | "tools" | "trace_context";
481
481
  declare const BlobStorageExportFieldGroup: {
@@ -524,17 +524,15 @@ interface CreateBlobStorageIntegrationRequest {
524
524
  /** Enable gzip compression for exported files (.csv.gz, .json.gz, .jsonl.gz). Defaults to true. */
525
525
  compressed?: boolean;
526
526
  /**
527
- * Data to export. When omitted on update, the existing value is preserved. When omitted on create: pre-cutoff Cloud projects and self-hosted deployments fall back to `LEGACY_TRACES_OBSERVATIONS`; post-cutoff Cloud projects (created on or after 2026-05-20) auto-default to `OBSERVATIONS_V2`. Required when `exportFieldGroups` is provided.
527
+ * Data to export. When omitted on update, the existing value is preserved. When omitted on create: integrations on Langfuse Cloud default to `OBSERVATIONS_V2`; self-hosted deployments fall back to `LEGACY_TRACES_OBSERVATIONS`. Required when `exportFieldGroups` is provided.
528
528
  *
529
- * **Cloud-only deprecation gate (effective 2026-05-20):** For projects created on or after 2026-05-20 on Langfuse Cloud, `LEGACY_TRACES_OBSERVATIONS` and `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` are rejected with HTTP 400. Omitting `exportSource` on these projects silently defaults to `OBSERVATIONS_V2` rather than the schema column default. Use `OBSERVATIONS_V2` for all new integrations. Projects created before 2026-05-20 and self-hosted deployments are unaffected.
529
+ * **Cloud-only project deprecation gate (effective 2026-05-20):** For projects created on or after 2026-05-20 on Langfuse Cloud, `LEGACY_TRACES_OBSERVATIONS` and `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` are rejected with HTTP 400. Use `OBSERVATIONS_V2` for all new integrations. Self-hosted deployments are unaffected.
530
+ *
531
+ * **Cloud-only integration deprecation gate (effective 2026-06-22):** On Langfuse Cloud, legacy export sources are only accepted for blob storage integrations created before 2026-06-22, regardless of project age. Requests that would create a new integration with `LEGACY_TRACES_OBSERVATIONS` or `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` are rejected with HTTP 400. Use `OBSERVATIONS_V2` instead. Self-hosted deployments are unaffected.
530
532
  */
531
533
  exportSource?: BlobStorageExportSource;
532
534
  /**
533
- * Field groups to include in each exported row.
534
- *
535
- * For exportSource `OBSERVATIONS_V2` or `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS`: must include `core` if provided. When omitted on create, the column default (all groups) applies. When omitted on update, the existing value is preserved.
536
- *
537
- * For exportSource `LEGACY_TRACES_OBSERVATIONS`: this field must be omitted or null. Sending an array (including an empty array) returns 400, because that source uses a fixed column set and does not honor field groups.
535
+ * Field groups to include in each exported observation row. Applies to all export sources; must include `core` if provided. When omitted on create, the column default (all groups) applies. When omitted on update, the existing value is preserved.
538
536
  *
539
537
  * `exportFieldGroups` requires `exportSource` to be provided in the same request.
540
538
  */
@@ -562,7 +560,7 @@ interface BlobStorageIntegrationResponse {
562
560
  exportStartDate: string | null;
563
561
  compressed: boolean;
564
562
  exportSource: BlobStorageExportSource;
565
- /** Field groups included in each exported row for `OBSERVATIONS_V2` / `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` sources. Always `null` when exportSource is `LEGACY_TRACES_OBSERVATIONS` (the field does not apply to that source; any legacy DB value is hidden from the public surface). */
563
+ /** Field groups included in each exported observation row. An empty list is treated as all groups during export. */
566
564
  exportFieldGroups: BlobStorageExportFieldGroup[] | null;
567
565
  nextSyncAt: string | null;
568
566
  lastSyncAt: string | null;
@@ -1905,7 +1903,7 @@ interface CreateDatasetItemRequest {
1905
1903
  metadata?: unknown;
1906
1904
  sourceTraceId?: string;
1907
1905
  sourceObservationId?: string;
1908
- /** Dataset items are upserted on their id. Id needs to be unique (project-level) and cannot be reused across datasets. */
1906
+ /** Dataset items are upserted on their id. Id needs to be unique (project-level), cannot be reused across datasets, and must be at most 255 characters. */
1909
1907
  id?: string;
1910
1908
  /** Defaults to ACTIVE for newly created items */
1911
1909
  status?: DatasetStatus;
@@ -4901,7 +4899,7 @@ interface GetScoresV3Request {
4901
4899
  limit?: number;
4902
4900
  /** URL-safe base64 (base64url) cursor for pagination. Use the cursor from the previous response to get the next page. Absent on the final page. */
4903
4901
  cursor?: string;
4904
- /** Comma-separated field groups to include. Allowed: core, details, subject, annotation. Defaults to "core". Unknown names return HTTP 400. */
4902
+ /** Comma-separated field groups to include in addition to the always-returned core fields. Allowed: details, subject, annotation — see the endpoint description for the fields each group adds. Unknown names return HTTP 400. */
4905
4903
  fields?: string;
4906
4904
  /** Comma-separated list of score IDs to filter by (OR within, AND across filters). */
4907
4905
  id?: string;
@@ -6738,6 +6736,17 @@ declare namespace index$5 {
6738
6736
  export { type index$5_CodeEvaluationRuleEvaluatorReference as CodeEvaluationRuleEvaluatorReference, type index$5_CreateCodeEvaluationRuleRequest as CreateCodeEvaluationRuleRequest, type index$5_CreateEvaluationRuleRequest as CreateEvaluationRuleRequest, type index$5_CreateLlmAsJudgeEvaluationRuleRequest as CreateLlmAsJudgeEvaluationRuleRequest, type index$5_DeleteEvaluationRuleResponse as DeleteEvaluationRuleResponse, type index$5_EvaluationRule as EvaluationRule, type index$5_EvaluationRuleEvaluator as EvaluationRuleEvaluator, type index$5_EvaluationRuleEvaluatorReference as EvaluationRuleEvaluatorReference, type EvaluationRules$1 as EvaluationRules, type index$5_ListEvaluationRulesRequest as ListEvaluationRulesRequest, type index$5_LlmAsJudgeEvaluationRuleEvaluatorReference as LlmAsJudgeEvaluationRuleEvaluatorReference, index$5_LlmAsJudgeEvaluatorType as LlmAsJudgeEvaluatorType, type index$5_UpdateEvaluationRuleRequest as UpdateEvaluationRuleRequest };
6739
6737
  }
6740
6738
 
6739
+ /**
6740
+ * This file was auto-generated by Fern from our API Definition.
6741
+ */
6742
+ /**
6743
+ * Confirmation response returned after successful deletion.
6744
+ */
6745
+ interface DeleteEvaluatorResponse {
6746
+ /** Always `Evaluator successfully deleted`. */
6747
+ message: string;
6748
+ }
6749
+
6741
6750
  /**
6742
6751
  * This file was auto-generated by Fern from our API Definition.
6743
6752
  */
@@ -6905,12 +6914,13 @@ type index$4_CodeEvaluator = CodeEvaluator;
6905
6914
  type index$4_CreateCodeEvaluatorRequest = CreateCodeEvaluatorRequest;
6906
6915
  declare const index$4_CreateEvaluatorRequest: typeof CreateEvaluatorRequest;
6907
6916
  type index$4_CreateLlmAsJudgeEvaluatorRequest = CreateLlmAsJudgeEvaluatorRequest;
6917
+ type index$4_DeleteEvaluatorResponse = DeleteEvaluatorResponse;
6908
6918
  declare const index$4_Evaluator: typeof Evaluator;
6909
6919
  type index$4_EvaluatorBase = EvaluatorBase;
6910
6920
  type index$4_ListEvaluatorsRequest = ListEvaluatorsRequest;
6911
6921
  type index$4_LlmAsJudgeEvaluator = LlmAsJudgeEvaluator;
6912
6922
  declare namespace index$4 {
6913
- export { type index$4_CodeEvaluator as CodeEvaluator, type index$4_CreateCodeEvaluatorRequest as CreateCodeEvaluatorRequest, index$4_CreateEvaluatorRequest as CreateEvaluatorRequest, type index$4_CreateLlmAsJudgeEvaluatorRequest as CreateLlmAsJudgeEvaluatorRequest, index$4_Evaluator as Evaluator, type index$4_EvaluatorBase as EvaluatorBase, type Evaluators$1 as Evaluators, type index$4_ListEvaluatorsRequest as ListEvaluatorsRequest, type index$4_LlmAsJudgeEvaluator as LlmAsJudgeEvaluator };
6923
+ export { type index$4_CodeEvaluator as CodeEvaluator, type index$4_CreateCodeEvaluatorRequest as CreateCodeEvaluatorRequest, index$4_CreateEvaluatorRequest as CreateEvaluatorRequest, type index$4_CreateLlmAsJudgeEvaluatorRequest as CreateLlmAsJudgeEvaluatorRequest, type index$4_DeleteEvaluatorResponse as DeleteEvaluatorResponse, index$4_Evaluator as Evaluator, type index$4_EvaluatorBase as EvaluatorBase, type Evaluators$1 as Evaluators, type index$4_ListEvaluatorsRequest as ListEvaluatorsRequest, type index$4_LlmAsJudgeEvaluator as LlmAsJudgeEvaluator };
6914
6924
  }
6915
6925
 
6916
6926
  type index$3_AccessDeniedError = AccessDeniedError;
@@ -6933,6 +6943,7 @@ type index$3_CreateLlmAsJudgeEvaluationRuleRequest = CreateLlmAsJudgeEvaluationR
6933
6943
  type index$3_CreateLlmAsJudgeEvaluatorRequest = CreateLlmAsJudgeEvaluatorRequest;
6934
6944
  type index$3_DateTimeEvaluationRuleFilter = DateTimeEvaluationRuleFilter;
6935
6945
  type index$3_DeleteEvaluationRuleResponse = DeleteEvaluationRuleResponse;
6946
+ type index$3_DeleteEvaluatorResponse = DeleteEvaluatorResponse;
6936
6947
  type index$3_EvaluationRule = EvaluationRule;
6937
6948
  declare const index$3_EvaluationRuleArrayOptionsFilterOperator: typeof EvaluationRuleArrayOptionsFilterOperator;
6938
6949
  declare const index$3_EvaluationRuleBooleanFilterOperator: typeof EvaluationRuleBooleanFilterOperator;
@@ -6989,7 +7000,7 @@ type index$3_UnprocessableContentError = UnprocessableContentError;
6989
7000
  declare const index$3_UnprocessableContentError: typeof UnprocessableContentError;
6990
7001
  type index$3_UpdateEvaluationRuleRequest = UpdateEvaluationRuleRequest;
6991
7002
  declare namespace index$3 {
6992
- export { index$3_AccessDeniedError as AccessDeniedError, type index$3_ArrayOptionsEvaluationRuleFilter as ArrayOptionsEvaluationRuleFilter, index$3_BadRequestError as BadRequestError, type index$3_BooleanEvaluationRuleFilter as BooleanEvaluationRuleFilter, type index$3_CategoryOptionsEvaluationRuleFilter as CategoryOptionsEvaluationRuleFilter, type index$3_CodeEvaluationRuleEvaluatorReference as CodeEvaluationRuleEvaluatorReference, type index$3_CodeEvaluator as CodeEvaluator, index$3_CodeEvaluatorSourceCodeLanguage as CodeEvaluatorSourceCodeLanguage, index$3_ConflictError as ConflictError, type index$3_CreateCodeEvaluationRuleRequest as CreateCodeEvaluationRuleRequest, type index$3_CreateCodeEvaluatorRequest as CreateCodeEvaluatorRequest, type index$3_CreateEvaluationRuleRequest as CreateEvaluationRuleRequest, index$3_CreateEvaluatorRequest as CreateEvaluatorRequest, type index$3_CreateLlmAsJudgeEvaluationRuleRequest as CreateLlmAsJudgeEvaluationRuleRequest, type index$3_CreateLlmAsJudgeEvaluatorRequest as CreateLlmAsJudgeEvaluatorRequest, type index$3_DateTimeEvaluationRuleFilter as DateTimeEvaluationRuleFilter, type index$3_DeleteEvaluationRuleResponse as DeleteEvaluationRuleResponse, type index$3_EvaluationRule as EvaluationRule, index$3_EvaluationRuleArrayOptionsFilterOperator as EvaluationRuleArrayOptionsFilterOperator, index$3_EvaluationRuleBooleanFilterOperator as EvaluationRuleBooleanFilterOperator, type index$3_EvaluationRuleEvaluator as EvaluationRuleEvaluator, type index$3_EvaluationRuleEvaluatorReference as EvaluationRuleEvaluatorReference, index$3_EvaluationRuleFilter as EvaluationRuleFilter, type index$3_EvaluationRuleMapping as EvaluationRuleMapping, index$3_EvaluationRuleMappingSource as EvaluationRuleMappingSource, index$3_EvaluationRuleNullFilterOperator as EvaluationRuleNullFilterOperator, index$3_EvaluationRuleNumberFilterOperator as EvaluationRuleNumberFilterOperator, index$3_EvaluationRuleOptionsFilterOperator as EvaluationRuleOptionsFilterOperator, index$3_EvaluationRuleStatus as EvaluationRuleStatus, index$3_EvaluationRuleStringFilterOperator as EvaluationRuleStringFilterOperator, index$3_EvaluationRuleTarget as EvaluationRuleTarget, type EvaluationRules$1 as EvaluationRules, index$3_Evaluator as Evaluator, type index$3_EvaluatorBase as EvaluatorBase, type index$3_EvaluatorModelConfig as EvaluatorModelConfig, index$3_EvaluatorOutputDataType as EvaluatorOutputDataType, index$3_EvaluatorOutputDefinition as EvaluatorOutputDefinition, type index$3_EvaluatorOutputFieldDefinition as EvaluatorOutputFieldDefinition, index$3_EvaluatorScope as EvaluatorScope, index$3_EvaluatorType as EvaluatorType, type Evaluators$1 as Evaluators, index$3_InternalServerError as InternalServerError, type index$3_ListEvaluationRulesRequest as ListEvaluationRulesRequest, type index$3_ListEvaluatorsRequest as ListEvaluatorsRequest, type index$3_LlmAsJudgeEvaluationRuleEvaluatorReference as LlmAsJudgeEvaluationRuleEvaluatorReference, type index$3_LlmAsJudgeEvaluator as LlmAsJudgeEvaluator, index$3_LlmAsJudgeEvaluatorType as LlmAsJudgeEvaluatorType, index$3_MethodNotAllowedError as MethodNotAllowedError, index$3_NotFoundError as NotFoundError, type index$3_NullEvaluationRuleFilter as NullEvaluationRuleFilter, type index$3_NumberEvaluationRuleFilter as NumberEvaluationRuleFilter, type index$3_NumberObjectEvaluationRuleFilter as NumberObjectEvaluationRuleFilter, type index$3_PublicApiError as PublicApiError, index$3_PublicApiErrorCode as PublicApiErrorCode, type index$3_PublicApiErrorDetails as PublicApiErrorDetails, type index$3_PublicApiValidationIssue as PublicApiValidationIssue, type index$3_PublicBooleanEvaluatorOutputDefinition as PublicBooleanEvaluatorOutputDefinition, type index$3_PublicCategoricalEvaluatorOutputDefinition as PublicCategoricalEvaluatorOutputDefinition, type index$3_PublicCategoricalEvaluatorOutputScoreDefinition as PublicCategoricalEvaluatorOutputScoreDefinition, index$3_PublicEvaluatorOutputDefinition as PublicEvaluatorOutputDefinition, type index$3_PublicNumericEvaluatorOutputDefinition as PublicNumericEvaluatorOutputDefinition, type index$3_StringEvaluationRuleFilter as StringEvaluationRuleFilter, type index$3_StringObjectEvaluationRuleFilter as StringObjectEvaluationRuleFilter, type index$3_StringOptionsEvaluationRuleFilter as StringOptionsEvaluationRuleFilter, index$3_TooManyRequestsError as TooManyRequestsError, index$3_UnauthorizedError as UnauthorizedError, index$3_UnprocessableContentError as UnprocessableContentError, type index$3_UpdateEvaluationRuleRequest as UpdateEvaluationRuleRequest, index$7 as commons, index$6 as errors, index$5 as evaluationRules, index$4 as evaluators };
7003
+ export { index$3_AccessDeniedError as AccessDeniedError, type index$3_ArrayOptionsEvaluationRuleFilter as ArrayOptionsEvaluationRuleFilter, index$3_BadRequestError as BadRequestError, type index$3_BooleanEvaluationRuleFilter as BooleanEvaluationRuleFilter, type index$3_CategoryOptionsEvaluationRuleFilter as CategoryOptionsEvaluationRuleFilter, type index$3_CodeEvaluationRuleEvaluatorReference as CodeEvaluationRuleEvaluatorReference, type index$3_CodeEvaluator as CodeEvaluator, index$3_CodeEvaluatorSourceCodeLanguage as CodeEvaluatorSourceCodeLanguage, index$3_ConflictError as ConflictError, type index$3_CreateCodeEvaluationRuleRequest as CreateCodeEvaluationRuleRequest, type index$3_CreateCodeEvaluatorRequest as CreateCodeEvaluatorRequest, type index$3_CreateEvaluationRuleRequest as CreateEvaluationRuleRequest, index$3_CreateEvaluatorRequest as CreateEvaluatorRequest, type index$3_CreateLlmAsJudgeEvaluationRuleRequest as CreateLlmAsJudgeEvaluationRuleRequest, type index$3_CreateLlmAsJudgeEvaluatorRequest as CreateLlmAsJudgeEvaluatorRequest, type index$3_DateTimeEvaluationRuleFilter as DateTimeEvaluationRuleFilter, type index$3_DeleteEvaluationRuleResponse as DeleteEvaluationRuleResponse, type index$3_DeleteEvaluatorResponse as DeleteEvaluatorResponse, type index$3_EvaluationRule as EvaluationRule, index$3_EvaluationRuleArrayOptionsFilterOperator as EvaluationRuleArrayOptionsFilterOperator, index$3_EvaluationRuleBooleanFilterOperator as EvaluationRuleBooleanFilterOperator, type index$3_EvaluationRuleEvaluator as EvaluationRuleEvaluator, type index$3_EvaluationRuleEvaluatorReference as EvaluationRuleEvaluatorReference, index$3_EvaluationRuleFilter as EvaluationRuleFilter, type index$3_EvaluationRuleMapping as EvaluationRuleMapping, index$3_EvaluationRuleMappingSource as EvaluationRuleMappingSource, index$3_EvaluationRuleNullFilterOperator as EvaluationRuleNullFilterOperator, index$3_EvaluationRuleNumberFilterOperator as EvaluationRuleNumberFilterOperator, index$3_EvaluationRuleOptionsFilterOperator as EvaluationRuleOptionsFilterOperator, index$3_EvaluationRuleStatus as EvaluationRuleStatus, index$3_EvaluationRuleStringFilterOperator as EvaluationRuleStringFilterOperator, index$3_EvaluationRuleTarget as EvaluationRuleTarget, type EvaluationRules$1 as EvaluationRules, index$3_Evaluator as Evaluator, type index$3_EvaluatorBase as EvaluatorBase, type index$3_EvaluatorModelConfig as EvaluatorModelConfig, index$3_EvaluatorOutputDataType as EvaluatorOutputDataType, index$3_EvaluatorOutputDefinition as EvaluatorOutputDefinition, type index$3_EvaluatorOutputFieldDefinition as EvaluatorOutputFieldDefinition, index$3_EvaluatorScope as EvaluatorScope, index$3_EvaluatorType as EvaluatorType, type Evaluators$1 as Evaluators, index$3_InternalServerError as InternalServerError, type index$3_ListEvaluationRulesRequest as ListEvaluationRulesRequest, type index$3_ListEvaluatorsRequest as ListEvaluatorsRequest, type index$3_LlmAsJudgeEvaluationRuleEvaluatorReference as LlmAsJudgeEvaluationRuleEvaluatorReference, type index$3_LlmAsJudgeEvaluator as LlmAsJudgeEvaluator, index$3_LlmAsJudgeEvaluatorType as LlmAsJudgeEvaluatorType, index$3_MethodNotAllowedError as MethodNotAllowedError, index$3_NotFoundError as NotFoundError, type index$3_NullEvaluationRuleFilter as NullEvaluationRuleFilter, type index$3_NumberEvaluationRuleFilter as NumberEvaluationRuleFilter, type index$3_NumberObjectEvaluationRuleFilter as NumberObjectEvaluationRuleFilter, type index$3_PublicApiError as PublicApiError, index$3_PublicApiErrorCode as PublicApiErrorCode, type index$3_PublicApiErrorDetails as PublicApiErrorDetails, type index$3_PublicApiValidationIssue as PublicApiValidationIssue, type index$3_PublicBooleanEvaluatorOutputDefinition as PublicBooleanEvaluatorOutputDefinition, type index$3_PublicCategoricalEvaluatorOutputDefinition as PublicCategoricalEvaluatorOutputDefinition, type index$3_PublicCategoricalEvaluatorOutputScoreDefinition as PublicCategoricalEvaluatorOutputScoreDefinition, index$3_PublicEvaluatorOutputDefinition as PublicEvaluatorOutputDefinition, type index$3_PublicNumericEvaluatorOutputDefinition as PublicNumericEvaluatorOutputDefinition, type index$3_StringEvaluationRuleFilter as StringEvaluationRuleFilter, type index$3_StringObjectEvaluationRuleFilter as StringObjectEvaluationRuleFilter, type index$3_StringOptionsEvaluationRuleFilter as StringOptionsEvaluationRuleFilter, index$3_TooManyRequestsError as TooManyRequestsError, index$3_UnauthorizedError as UnauthorizedError, index$3_UnprocessableContentError as UnprocessableContentError, type index$3_UpdateEvaluationRuleRequest as UpdateEvaluationRuleRequest, index$7 as commons, index$6 as errors, index$5 as evaluationRules, index$4 as evaluators };
6993
7004
  }
6994
7005
 
6995
7006
  /**
@@ -9950,15 +9961,22 @@ declare class ScoresV3 {
9950
9961
  /**
9951
9962
  * Get a list of scores with a polymorphic `value` field (v3).
9952
9963
  *
9953
- * This endpoint requires Langfuse v4 or later.
9954
- *
9955
9964
  * The `value` field type depends on `dataType`:
9956
9965
  * - `NUMERIC` → number
9957
9966
  * - `BOOLEAN` → boolean
9958
9967
  * - `CATEGORICAL`, `TEXT`, `CORRECTION` → string
9959
9968
  *
9960
- * Use the `fields` parameter to include optional field groups beyond the
9961
- * default `core`. Unknown group names return HTTP 400.
9969
+ * The response always includes the core fields: id, projectId, name,
9970
+ * value, dataType, source, timestamp, environment, createdAt, updatedAt.
9971
+ *
9972
+ * Additional field groups can be requested via the `fields` parameter:
9973
+ * - `details` — adds comment, configId, metadata
9974
+ * - `subject` — adds the subject object describing the entity the score
9975
+ * is attached to: kind (trace, observation, session, or experiment),
9976
+ * id, and traceId for observation-level scores
9977
+ * - `annotation` — adds authorUserId, queueId
9978
+ *
9979
+ * Unknown group names return HTTP 400.
9962
9980
  *
9963
9981
  * @param {LangfuseAPI.GetScoresV3Request} request
9964
9982
  * @param {ScoresV3.RequestOptions} requestOptions - Request-specific configuration.
@@ -10020,6 +10038,9 @@ declare class Scores {
10020
10038
  protected readonly _options: Scores.Options;
10021
10039
  constructor(_options: Scores.Options);
10022
10040
  /**
10041
+ * **Deprecated.** Use `GET /api/public/v3/scores` instead. This endpoint
10042
+ * is no longer available on Langfuse v4 and later.
10043
+ *
10023
10044
  * Get a list of scores (supports both trace and session scores)
10024
10045
  *
10025
10046
  * @param {LangfuseAPI.GetScoresRequest} request
@@ -10037,6 +10058,9 @@ declare class Scores {
10037
10058
  getMany(request?: GetScoresRequest, requestOptions?: Scores.RequestOptions): HttpResponsePromise<GetScoresResponse>;
10038
10059
  private __getMany;
10039
10060
  /**
10061
+ * **Deprecated.** Use `GET /api/public/v3/scores` with the `id` filter
10062
+ * instead. This endpoint is no longer available on Langfuse v4 and later.
10063
+ *
10040
10064
  * Get a score (supports both trace and session scores)
10041
10065
  *
10042
10066
  * @param {string} scoreId - The unique langfuse identifier of a score
@@ -10739,6 +10763,37 @@ declare class Evaluators {
10739
10763
  */
10740
10764
  get(evaluatorId: string, requestOptions?: Evaluators.RequestOptions): HttpResponsePromise<Evaluator>;
10741
10765
  private __get;
10766
+ /**
10767
+ * Delete an evaluator.
10768
+ *
10769
+ * Important behavior:
10770
+ * - This deletes the evaluator including all of its stored versions; `evaluatorId` may reference any version.
10771
+ * - The API returns `409` while evaluation rules still reference the evaluator. Delete those evaluation rules first.
10772
+ * - Langfuse-managed evaluators (`scope=managed`) cannot be deleted; the API returns `403`.
10773
+ * - Scores already produced by the evaluator are not deleted.
10774
+ *
10775
+ * @param {string} evaluatorId - Evaluator identifier returned by the evaluator endpoints.
10776
+ * @param {Evaluators.RequestOptions} requestOptions - Request-specific configuration.
10777
+ *
10778
+ * @throws {@link LangfuseAPI.unstable.BadRequestError}
10779
+ * @throws {@link LangfuseAPI.unstable.UnauthorizedError}
10780
+ * @throws {@link LangfuseAPI.unstable.AccessDeniedError}
10781
+ * @throws {@link LangfuseAPI.unstable.NotFoundError}
10782
+ * @throws {@link LangfuseAPI.unstable.MethodNotAllowedError}
10783
+ * @throws {@link LangfuseAPI.unstable.ConflictError}
10784
+ * @throws {@link LangfuseAPI.unstable.TooManyRequestsError}
10785
+ * @throws {@link LangfuseAPI.unstable.InternalServerError}
10786
+ * @throws {@link LangfuseAPI.Error}
10787
+ * @throws {@link LangfuseAPI.UnauthorizedError}
10788
+ * @throws {@link LangfuseAPI.AccessDeniedError}
10789
+ * @throws {@link LangfuseAPI.MethodNotAllowedError}
10790
+ * @throws {@link LangfuseAPI.NotFoundError}
10791
+ *
10792
+ * @example
10793
+ * await client.unstable.evaluators.delete("evaluatorId")
10794
+ */
10795
+ delete(evaluatorId: string, requestOptions?: Evaluators.RequestOptions): HttpResponsePromise<DeleteEvaluatorResponse>;
10796
+ private __delete;
10742
10797
  protected _getAuthorizationHeader(): Promise<string | undefined>;
10743
10798
  }
10744
10799
 
package/dist/index.d.ts CHANGED
@@ -458,9 +458,9 @@ declare const BlobStorageExportFrequency: {
458
458
  */
459
459
  /**
460
460
  * What data the integration exports.
461
- * - `LEGACY_TRACES_OBSERVATIONS`: traces, observations, and scores tables with a fixed column set. The `exportFieldGroups` field is not applicable.
461
+ * - `LEGACY_TRACES_OBSERVATIONS`: traces, observations, and scores tables. Observation columns are controlled by `exportFieldGroups`; field groups without a counterpart in this data model (e.g. `trace_context`) are omitted.
462
462
  * - `OBSERVATIONS_V2`: same data model as the `/api/public/v2/observations` endpoint, plus scores. Columns are controlled by `exportFieldGroups`.
463
- * - `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS`: both sets. For the `OBSERVATIONS_V2` portion, columns are controlled by `exportFieldGroups`.
463
+ * - `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS`: both sets. Observation columns of both portions are controlled by `exportFieldGroups`.
464
464
  *
465
465
  * **Note:** `OBSERVATIONS_V2` and the enriched-observations portion of `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` rely on the enriched observations table (Langfuse Fast Preview / v4), which is currently available on Langfuse Cloud only. See https://langfuse.com/docs/v4.
466
466
  */
@@ -475,7 +475,7 @@ declare const BlobStorageExportSource: {
475
475
  * This file was auto-generated by Fern from our API Definition.
476
476
  */
477
477
  /**
478
- * Field group for the OBSERVATIONS_V2 and LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS export.
478
+ * Field group selecting which observation columns are included in the export. Applies to all export sources; groups without a counterpart in the legacy data model (e.g. `trace_context`) are omitted from the legacy observations export.
479
479
  */
480
480
  type BlobStorageExportFieldGroup = "core" | "basic" | "time" | "io" | "metadata" | "model" | "usage" | "prompt" | "metrics" | "tools" | "trace_context";
481
481
  declare const BlobStorageExportFieldGroup: {
@@ -524,17 +524,15 @@ interface CreateBlobStorageIntegrationRequest {
524
524
  /** Enable gzip compression for exported files (.csv.gz, .json.gz, .jsonl.gz). Defaults to true. */
525
525
  compressed?: boolean;
526
526
  /**
527
- * Data to export. When omitted on update, the existing value is preserved. When omitted on create: pre-cutoff Cloud projects and self-hosted deployments fall back to `LEGACY_TRACES_OBSERVATIONS`; post-cutoff Cloud projects (created on or after 2026-05-20) auto-default to `OBSERVATIONS_V2`. Required when `exportFieldGroups` is provided.
527
+ * Data to export. When omitted on update, the existing value is preserved. When omitted on create: integrations on Langfuse Cloud default to `OBSERVATIONS_V2`; self-hosted deployments fall back to `LEGACY_TRACES_OBSERVATIONS`. Required when `exportFieldGroups` is provided.
528
528
  *
529
- * **Cloud-only deprecation gate (effective 2026-05-20):** For projects created on or after 2026-05-20 on Langfuse Cloud, `LEGACY_TRACES_OBSERVATIONS` and `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` are rejected with HTTP 400. Omitting `exportSource` on these projects silently defaults to `OBSERVATIONS_V2` rather than the schema column default. Use `OBSERVATIONS_V2` for all new integrations. Projects created before 2026-05-20 and self-hosted deployments are unaffected.
529
+ * **Cloud-only project deprecation gate (effective 2026-05-20):** For projects created on or after 2026-05-20 on Langfuse Cloud, `LEGACY_TRACES_OBSERVATIONS` and `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` are rejected with HTTP 400. Use `OBSERVATIONS_V2` for all new integrations. Self-hosted deployments are unaffected.
530
+ *
531
+ * **Cloud-only integration deprecation gate (effective 2026-06-22):** On Langfuse Cloud, legacy export sources are only accepted for blob storage integrations created before 2026-06-22, regardless of project age. Requests that would create a new integration with `LEGACY_TRACES_OBSERVATIONS` or `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` are rejected with HTTP 400. Use `OBSERVATIONS_V2` instead. Self-hosted deployments are unaffected.
530
532
  */
531
533
  exportSource?: BlobStorageExportSource;
532
534
  /**
533
- * Field groups to include in each exported row.
534
- *
535
- * For exportSource `OBSERVATIONS_V2` or `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS`: must include `core` if provided. When omitted on create, the column default (all groups) applies. When omitted on update, the existing value is preserved.
536
- *
537
- * For exportSource `LEGACY_TRACES_OBSERVATIONS`: this field must be omitted or null. Sending an array (including an empty array) returns 400, because that source uses a fixed column set and does not honor field groups.
535
+ * Field groups to include in each exported observation row. Applies to all export sources; must include `core` if provided. When omitted on create, the column default (all groups) applies. When omitted on update, the existing value is preserved.
538
536
  *
539
537
  * `exportFieldGroups` requires `exportSource` to be provided in the same request.
540
538
  */
@@ -562,7 +560,7 @@ interface BlobStorageIntegrationResponse {
562
560
  exportStartDate: string | null;
563
561
  compressed: boolean;
564
562
  exportSource: BlobStorageExportSource;
565
- /** Field groups included in each exported row for `OBSERVATIONS_V2` / `LEGACY_TRACES_AND_ENRICHED_OBSERVATIONS` sources. Always `null` when exportSource is `LEGACY_TRACES_OBSERVATIONS` (the field does not apply to that source; any legacy DB value is hidden from the public surface). */
563
+ /** Field groups included in each exported observation row. An empty list is treated as all groups during export. */
566
564
  exportFieldGroups: BlobStorageExportFieldGroup[] | null;
567
565
  nextSyncAt: string | null;
568
566
  lastSyncAt: string | null;
@@ -1905,7 +1903,7 @@ interface CreateDatasetItemRequest {
1905
1903
  metadata?: unknown;
1906
1904
  sourceTraceId?: string;
1907
1905
  sourceObservationId?: string;
1908
- /** Dataset items are upserted on their id. Id needs to be unique (project-level) and cannot be reused across datasets. */
1906
+ /** Dataset items are upserted on their id. Id needs to be unique (project-level), cannot be reused across datasets, and must be at most 255 characters. */
1909
1907
  id?: string;
1910
1908
  /** Defaults to ACTIVE for newly created items */
1911
1909
  status?: DatasetStatus;
@@ -4901,7 +4899,7 @@ interface GetScoresV3Request {
4901
4899
  limit?: number;
4902
4900
  /** URL-safe base64 (base64url) cursor for pagination. Use the cursor from the previous response to get the next page. Absent on the final page. */
4903
4901
  cursor?: string;
4904
- /** Comma-separated field groups to include. Allowed: core, details, subject, annotation. Defaults to "core". Unknown names return HTTP 400. */
4902
+ /** Comma-separated field groups to include in addition to the always-returned core fields. Allowed: details, subject, annotation — see the endpoint description for the fields each group adds. Unknown names return HTTP 400. */
4905
4903
  fields?: string;
4906
4904
  /** Comma-separated list of score IDs to filter by (OR within, AND across filters). */
4907
4905
  id?: string;
@@ -6738,6 +6736,17 @@ declare namespace index$5 {
6738
6736
  export { type index$5_CodeEvaluationRuleEvaluatorReference as CodeEvaluationRuleEvaluatorReference, type index$5_CreateCodeEvaluationRuleRequest as CreateCodeEvaluationRuleRequest, type index$5_CreateEvaluationRuleRequest as CreateEvaluationRuleRequest, type index$5_CreateLlmAsJudgeEvaluationRuleRequest as CreateLlmAsJudgeEvaluationRuleRequest, type index$5_DeleteEvaluationRuleResponse as DeleteEvaluationRuleResponse, type index$5_EvaluationRule as EvaluationRule, type index$5_EvaluationRuleEvaluator as EvaluationRuleEvaluator, type index$5_EvaluationRuleEvaluatorReference as EvaluationRuleEvaluatorReference, type EvaluationRules$1 as EvaluationRules, type index$5_ListEvaluationRulesRequest as ListEvaluationRulesRequest, type index$5_LlmAsJudgeEvaluationRuleEvaluatorReference as LlmAsJudgeEvaluationRuleEvaluatorReference, index$5_LlmAsJudgeEvaluatorType as LlmAsJudgeEvaluatorType, type index$5_UpdateEvaluationRuleRequest as UpdateEvaluationRuleRequest };
6739
6737
  }
6740
6738
 
6739
+ /**
6740
+ * This file was auto-generated by Fern from our API Definition.
6741
+ */
6742
+ /**
6743
+ * Confirmation response returned after successful deletion.
6744
+ */
6745
+ interface DeleteEvaluatorResponse {
6746
+ /** Always `Evaluator successfully deleted`. */
6747
+ message: string;
6748
+ }
6749
+
6741
6750
  /**
6742
6751
  * This file was auto-generated by Fern from our API Definition.
6743
6752
  */
@@ -6905,12 +6914,13 @@ type index$4_CodeEvaluator = CodeEvaluator;
6905
6914
  type index$4_CreateCodeEvaluatorRequest = CreateCodeEvaluatorRequest;
6906
6915
  declare const index$4_CreateEvaluatorRequest: typeof CreateEvaluatorRequest;
6907
6916
  type index$4_CreateLlmAsJudgeEvaluatorRequest = CreateLlmAsJudgeEvaluatorRequest;
6917
+ type index$4_DeleteEvaluatorResponse = DeleteEvaluatorResponse;
6908
6918
  declare const index$4_Evaluator: typeof Evaluator;
6909
6919
  type index$4_EvaluatorBase = EvaluatorBase;
6910
6920
  type index$4_ListEvaluatorsRequest = ListEvaluatorsRequest;
6911
6921
  type index$4_LlmAsJudgeEvaluator = LlmAsJudgeEvaluator;
6912
6922
  declare namespace index$4 {
6913
- export { type index$4_CodeEvaluator as CodeEvaluator, type index$4_CreateCodeEvaluatorRequest as CreateCodeEvaluatorRequest, index$4_CreateEvaluatorRequest as CreateEvaluatorRequest, type index$4_CreateLlmAsJudgeEvaluatorRequest as CreateLlmAsJudgeEvaluatorRequest, index$4_Evaluator as Evaluator, type index$4_EvaluatorBase as EvaluatorBase, type Evaluators$1 as Evaluators, type index$4_ListEvaluatorsRequest as ListEvaluatorsRequest, type index$4_LlmAsJudgeEvaluator as LlmAsJudgeEvaluator };
6923
+ export { type index$4_CodeEvaluator as CodeEvaluator, type index$4_CreateCodeEvaluatorRequest as CreateCodeEvaluatorRequest, index$4_CreateEvaluatorRequest as CreateEvaluatorRequest, type index$4_CreateLlmAsJudgeEvaluatorRequest as CreateLlmAsJudgeEvaluatorRequest, type index$4_DeleteEvaluatorResponse as DeleteEvaluatorResponse, index$4_Evaluator as Evaluator, type index$4_EvaluatorBase as EvaluatorBase, type Evaluators$1 as Evaluators, type index$4_ListEvaluatorsRequest as ListEvaluatorsRequest, type index$4_LlmAsJudgeEvaluator as LlmAsJudgeEvaluator };
6914
6924
  }
6915
6925
 
6916
6926
  type index$3_AccessDeniedError = AccessDeniedError;
@@ -6933,6 +6943,7 @@ type index$3_CreateLlmAsJudgeEvaluationRuleRequest = CreateLlmAsJudgeEvaluationR
6933
6943
  type index$3_CreateLlmAsJudgeEvaluatorRequest = CreateLlmAsJudgeEvaluatorRequest;
6934
6944
  type index$3_DateTimeEvaluationRuleFilter = DateTimeEvaluationRuleFilter;
6935
6945
  type index$3_DeleteEvaluationRuleResponse = DeleteEvaluationRuleResponse;
6946
+ type index$3_DeleteEvaluatorResponse = DeleteEvaluatorResponse;
6936
6947
  type index$3_EvaluationRule = EvaluationRule;
6937
6948
  declare const index$3_EvaluationRuleArrayOptionsFilterOperator: typeof EvaluationRuleArrayOptionsFilterOperator;
6938
6949
  declare const index$3_EvaluationRuleBooleanFilterOperator: typeof EvaluationRuleBooleanFilterOperator;
@@ -6989,7 +7000,7 @@ type index$3_UnprocessableContentError = UnprocessableContentError;
6989
7000
  declare const index$3_UnprocessableContentError: typeof UnprocessableContentError;
6990
7001
  type index$3_UpdateEvaluationRuleRequest = UpdateEvaluationRuleRequest;
6991
7002
  declare namespace index$3 {
6992
- export { index$3_AccessDeniedError as AccessDeniedError, type index$3_ArrayOptionsEvaluationRuleFilter as ArrayOptionsEvaluationRuleFilter, index$3_BadRequestError as BadRequestError, type index$3_BooleanEvaluationRuleFilter as BooleanEvaluationRuleFilter, type index$3_CategoryOptionsEvaluationRuleFilter as CategoryOptionsEvaluationRuleFilter, type index$3_CodeEvaluationRuleEvaluatorReference as CodeEvaluationRuleEvaluatorReference, type index$3_CodeEvaluator as CodeEvaluator, index$3_CodeEvaluatorSourceCodeLanguage as CodeEvaluatorSourceCodeLanguage, index$3_ConflictError as ConflictError, type index$3_CreateCodeEvaluationRuleRequest as CreateCodeEvaluationRuleRequest, type index$3_CreateCodeEvaluatorRequest as CreateCodeEvaluatorRequest, type index$3_CreateEvaluationRuleRequest as CreateEvaluationRuleRequest, index$3_CreateEvaluatorRequest as CreateEvaluatorRequest, type index$3_CreateLlmAsJudgeEvaluationRuleRequest as CreateLlmAsJudgeEvaluationRuleRequest, type index$3_CreateLlmAsJudgeEvaluatorRequest as CreateLlmAsJudgeEvaluatorRequest, type index$3_DateTimeEvaluationRuleFilter as DateTimeEvaluationRuleFilter, type index$3_DeleteEvaluationRuleResponse as DeleteEvaluationRuleResponse, type index$3_EvaluationRule as EvaluationRule, index$3_EvaluationRuleArrayOptionsFilterOperator as EvaluationRuleArrayOptionsFilterOperator, index$3_EvaluationRuleBooleanFilterOperator as EvaluationRuleBooleanFilterOperator, type index$3_EvaluationRuleEvaluator as EvaluationRuleEvaluator, type index$3_EvaluationRuleEvaluatorReference as EvaluationRuleEvaluatorReference, index$3_EvaluationRuleFilter as EvaluationRuleFilter, type index$3_EvaluationRuleMapping as EvaluationRuleMapping, index$3_EvaluationRuleMappingSource as EvaluationRuleMappingSource, index$3_EvaluationRuleNullFilterOperator as EvaluationRuleNullFilterOperator, index$3_EvaluationRuleNumberFilterOperator as EvaluationRuleNumberFilterOperator, index$3_EvaluationRuleOptionsFilterOperator as EvaluationRuleOptionsFilterOperator, index$3_EvaluationRuleStatus as EvaluationRuleStatus, index$3_EvaluationRuleStringFilterOperator as EvaluationRuleStringFilterOperator, index$3_EvaluationRuleTarget as EvaluationRuleTarget, type EvaluationRules$1 as EvaluationRules, index$3_Evaluator as Evaluator, type index$3_EvaluatorBase as EvaluatorBase, type index$3_EvaluatorModelConfig as EvaluatorModelConfig, index$3_EvaluatorOutputDataType as EvaluatorOutputDataType, index$3_EvaluatorOutputDefinition as EvaluatorOutputDefinition, type index$3_EvaluatorOutputFieldDefinition as EvaluatorOutputFieldDefinition, index$3_EvaluatorScope as EvaluatorScope, index$3_EvaluatorType as EvaluatorType, type Evaluators$1 as Evaluators, index$3_InternalServerError as InternalServerError, type index$3_ListEvaluationRulesRequest as ListEvaluationRulesRequest, type index$3_ListEvaluatorsRequest as ListEvaluatorsRequest, type index$3_LlmAsJudgeEvaluationRuleEvaluatorReference as LlmAsJudgeEvaluationRuleEvaluatorReference, type index$3_LlmAsJudgeEvaluator as LlmAsJudgeEvaluator, index$3_LlmAsJudgeEvaluatorType as LlmAsJudgeEvaluatorType, index$3_MethodNotAllowedError as MethodNotAllowedError, index$3_NotFoundError as NotFoundError, type index$3_NullEvaluationRuleFilter as NullEvaluationRuleFilter, type index$3_NumberEvaluationRuleFilter as NumberEvaluationRuleFilter, type index$3_NumberObjectEvaluationRuleFilter as NumberObjectEvaluationRuleFilter, type index$3_PublicApiError as PublicApiError, index$3_PublicApiErrorCode as PublicApiErrorCode, type index$3_PublicApiErrorDetails as PublicApiErrorDetails, type index$3_PublicApiValidationIssue as PublicApiValidationIssue, type index$3_PublicBooleanEvaluatorOutputDefinition as PublicBooleanEvaluatorOutputDefinition, type index$3_PublicCategoricalEvaluatorOutputDefinition as PublicCategoricalEvaluatorOutputDefinition, type index$3_PublicCategoricalEvaluatorOutputScoreDefinition as PublicCategoricalEvaluatorOutputScoreDefinition, index$3_PublicEvaluatorOutputDefinition as PublicEvaluatorOutputDefinition, type index$3_PublicNumericEvaluatorOutputDefinition as PublicNumericEvaluatorOutputDefinition, type index$3_StringEvaluationRuleFilter as StringEvaluationRuleFilter, type index$3_StringObjectEvaluationRuleFilter as StringObjectEvaluationRuleFilter, type index$3_StringOptionsEvaluationRuleFilter as StringOptionsEvaluationRuleFilter, index$3_TooManyRequestsError as TooManyRequestsError, index$3_UnauthorizedError as UnauthorizedError, index$3_UnprocessableContentError as UnprocessableContentError, type index$3_UpdateEvaluationRuleRequest as UpdateEvaluationRuleRequest, index$7 as commons, index$6 as errors, index$5 as evaluationRules, index$4 as evaluators };
7003
+ export { index$3_AccessDeniedError as AccessDeniedError, type index$3_ArrayOptionsEvaluationRuleFilter as ArrayOptionsEvaluationRuleFilter, index$3_BadRequestError as BadRequestError, type index$3_BooleanEvaluationRuleFilter as BooleanEvaluationRuleFilter, type index$3_CategoryOptionsEvaluationRuleFilter as CategoryOptionsEvaluationRuleFilter, type index$3_CodeEvaluationRuleEvaluatorReference as CodeEvaluationRuleEvaluatorReference, type index$3_CodeEvaluator as CodeEvaluator, index$3_CodeEvaluatorSourceCodeLanguage as CodeEvaluatorSourceCodeLanguage, index$3_ConflictError as ConflictError, type index$3_CreateCodeEvaluationRuleRequest as CreateCodeEvaluationRuleRequest, type index$3_CreateCodeEvaluatorRequest as CreateCodeEvaluatorRequest, type index$3_CreateEvaluationRuleRequest as CreateEvaluationRuleRequest, index$3_CreateEvaluatorRequest as CreateEvaluatorRequest, type index$3_CreateLlmAsJudgeEvaluationRuleRequest as CreateLlmAsJudgeEvaluationRuleRequest, type index$3_CreateLlmAsJudgeEvaluatorRequest as CreateLlmAsJudgeEvaluatorRequest, type index$3_DateTimeEvaluationRuleFilter as DateTimeEvaluationRuleFilter, type index$3_DeleteEvaluationRuleResponse as DeleteEvaluationRuleResponse, type index$3_DeleteEvaluatorResponse as DeleteEvaluatorResponse, type index$3_EvaluationRule as EvaluationRule, index$3_EvaluationRuleArrayOptionsFilterOperator as EvaluationRuleArrayOptionsFilterOperator, index$3_EvaluationRuleBooleanFilterOperator as EvaluationRuleBooleanFilterOperator, type index$3_EvaluationRuleEvaluator as EvaluationRuleEvaluator, type index$3_EvaluationRuleEvaluatorReference as EvaluationRuleEvaluatorReference, index$3_EvaluationRuleFilter as EvaluationRuleFilter, type index$3_EvaluationRuleMapping as EvaluationRuleMapping, index$3_EvaluationRuleMappingSource as EvaluationRuleMappingSource, index$3_EvaluationRuleNullFilterOperator as EvaluationRuleNullFilterOperator, index$3_EvaluationRuleNumberFilterOperator as EvaluationRuleNumberFilterOperator, index$3_EvaluationRuleOptionsFilterOperator as EvaluationRuleOptionsFilterOperator, index$3_EvaluationRuleStatus as EvaluationRuleStatus, index$3_EvaluationRuleStringFilterOperator as EvaluationRuleStringFilterOperator, index$3_EvaluationRuleTarget as EvaluationRuleTarget, type EvaluationRules$1 as EvaluationRules, index$3_Evaluator as Evaluator, type index$3_EvaluatorBase as EvaluatorBase, type index$3_EvaluatorModelConfig as EvaluatorModelConfig, index$3_EvaluatorOutputDataType as EvaluatorOutputDataType, index$3_EvaluatorOutputDefinition as EvaluatorOutputDefinition, type index$3_EvaluatorOutputFieldDefinition as EvaluatorOutputFieldDefinition, index$3_EvaluatorScope as EvaluatorScope, index$3_EvaluatorType as EvaluatorType, type Evaluators$1 as Evaluators, index$3_InternalServerError as InternalServerError, type index$3_ListEvaluationRulesRequest as ListEvaluationRulesRequest, type index$3_ListEvaluatorsRequest as ListEvaluatorsRequest, type index$3_LlmAsJudgeEvaluationRuleEvaluatorReference as LlmAsJudgeEvaluationRuleEvaluatorReference, type index$3_LlmAsJudgeEvaluator as LlmAsJudgeEvaluator, index$3_LlmAsJudgeEvaluatorType as LlmAsJudgeEvaluatorType, index$3_MethodNotAllowedError as MethodNotAllowedError, index$3_NotFoundError as NotFoundError, type index$3_NullEvaluationRuleFilter as NullEvaluationRuleFilter, type index$3_NumberEvaluationRuleFilter as NumberEvaluationRuleFilter, type index$3_NumberObjectEvaluationRuleFilter as NumberObjectEvaluationRuleFilter, type index$3_PublicApiError as PublicApiError, index$3_PublicApiErrorCode as PublicApiErrorCode, type index$3_PublicApiErrorDetails as PublicApiErrorDetails, type index$3_PublicApiValidationIssue as PublicApiValidationIssue, type index$3_PublicBooleanEvaluatorOutputDefinition as PublicBooleanEvaluatorOutputDefinition, type index$3_PublicCategoricalEvaluatorOutputDefinition as PublicCategoricalEvaluatorOutputDefinition, type index$3_PublicCategoricalEvaluatorOutputScoreDefinition as PublicCategoricalEvaluatorOutputScoreDefinition, index$3_PublicEvaluatorOutputDefinition as PublicEvaluatorOutputDefinition, type index$3_PublicNumericEvaluatorOutputDefinition as PublicNumericEvaluatorOutputDefinition, type index$3_StringEvaluationRuleFilter as StringEvaluationRuleFilter, type index$3_StringObjectEvaluationRuleFilter as StringObjectEvaluationRuleFilter, type index$3_StringOptionsEvaluationRuleFilter as StringOptionsEvaluationRuleFilter, index$3_TooManyRequestsError as TooManyRequestsError, index$3_UnauthorizedError as UnauthorizedError, index$3_UnprocessableContentError as UnprocessableContentError, type index$3_UpdateEvaluationRuleRequest as UpdateEvaluationRuleRequest, index$7 as commons, index$6 as errors, index$5 as evaluationRules, index$4 as evaluators };
6993
7004
  }
6994
7005
 
6995
7006
  /**
@@ -9950,15 +9961,22 @@ declare class ScoresV3 {
9950
9961
  /**
9951
9962
  * Get a list of scores with a polymorphic `value` field (v3).
9952
9963
  *
9953
- * This endpoint requires Langfuse v4 or later.
9954
- *
9955
9964
  * The `value` field type depends on `dataType`:
9956
9965
  * - `NUMERIC` → number
9957
9966
  * - `BOOLEAN` → boolean
9958
9967
  * - `CATEGORICAL`, `TEXT`, `CORRECTION` → string
9959
9968
  *
9960
- * Use the `fields` parameter to include optional field groups beyond the
9961
- * default `core`. Unknown group names return HTTP 400.
9969
+ * The response always includes the core fields: id, projectId, name,
9970
+ * value, dataType, source, timestamp, environment, createdAt, updatedAt.
9971
+ *
9972
+ * Additional field groups can be requested via the `fields` parameter:
9973
+ * - `details` — adds comment, configId, metadata
9974
+ * - `subject` — adds the subject object describing the entity the score
9975
+ * is attached to: kind (trace, observation, session, or experiment),
9976
+ * id, and traceId for observation-level scores
9977
+ * - `annotation` — adds authorUserId, queueId
9978
+ *
9979
+ * Unknown group names return HTTP 400.
9962
9980
  *
9963
9981
  * @param {LangfuseAPI.GetScoresV3Request} request
9964
9982
  * @param {ScoresV3.RequestOptions} requestOptions - Request-specific configuration.
@@ -10020,6 +10038,9 @@ declare class Scores {
10020
10038
  protected readonly _options: Scores.Options;
10021
10039
  constructor(_options: Scores.Options);
10022
10040
  /**
10041
+ * **Deprecated.** Use `GET /api/public/v3/scores` instead. This endpoint
10042
+ * is no longer available on Langfuse v4 and later.
10043
+ *
10023
10044
  * Get a list of scores (supports both trace and session scores)
10024
10045
  *
10025
10046
  * @param {LangfuseAPI.GetScoresRequest} request
@@ -10037,6 +10058,9 @@ declare class Scores {
10037
10058
  getMany(request?: GetScoresRequest, requestOptions?: Scores.RequestOptions): HttpResponsePromise<GetScoresResponse>;
10038
10059
  private __getMany;
10039
10060
  /**
10061
+ * **Deprecated.** Use `GET /api/public/v3/scores` with the `id` filter
10062
+ * instead. This endpoint is no longer available on Langfuse v4 and later.
10063
+ *
10040
10064
  * Get a score (supports both trace and session scores)
10041
10065
  *
10042
10066
  * @param {string} scoreId - The unique langfuse identifier of a score
@@ -10739,6 +10763,37 @@ declare class Evaluators {
10739
10763
  */
10740
10764
  get(evaluatorId: string, requestOptions?: Evaluators.RequestOptions): HttpResponsePromise<Evaluator>;
10741
10765
  private __get;
10766
+ /**
10767
+ * Delete an evaluator.
10768
+ *
10769
+ * Important behavior:
10770
+ * - This deletes the evaluator including all of its stored versions; `evaluatorId` may reference any version.
10771
+ * - The API returns `409` while evaluation rules still reference the evaluator. Delete those evaluation rules first.
10772
+ * - Langfuse-managed evaluators (`scope=managed`) cannot be deleted; the API returns `403`.
10773
+ * - Scores already produced by the evaluator are not deleted.
10774
+ *
10775
+ * @param {string} evaluatorId - Evaluator identifier returned by the evaluator endpoints.
10776
+ * @param {Evaluators.RequestOptions} requestOptions - Request-specific configuration.
10777
+ *
10778
+ * @throws {@link LangfuseAPI.unstable.BadRequestError}
10779
+ * @throws {@link LangfuseAPI.unstable.UnauthorizedError}
10780
+ * @throws {@link LangfuseAPI.unstable.AccessDeniedError}
10781
+ * @throws {@link LangfuseAPI.unstable.NotFoundError}
10782
+ * @throws {@link LangfuseAPI.unstable.MethodNotAllowedError}
10783
+ * @throws {@link LangfuseAPI.unstable.ConflictError}
10784
+ * @throws {@link LangfuseAPI.unstable.TooManyRequestsError}
10785
+ * @throws {@link LangfuseAPI.unstable.InternalServerError}
10786
+ * @throws {@link LangfuseAPI.Error}
10787
+ * @throws {@link LangfuseAPI.UnauthorizedError}
10788
+ * @throws {@link LangfuseAPI.AccessDeniedError}
10789
+ * @throws {@link LangfuseAPI.MethodNotAllowedError}
10790
+ * @throws {@link LangfuseAPI.NotFoundError}
10791
+ *
10792
+ * @example
10793
+ * await client.unstable.evaluators.delete("evaluatorId")
10794
+ */
10795
+ delete(evaluatorId: string, requestOptions?: Evaluators.RequestOptions): HttpResponsePromise<DeleteEvaluatorResponse>;
10796
+ private __delete;
10742
10797
  protected _getAuthorizationHeader(): Promise<string | undefined>;
10743
10798
  }
10744
10799