feat(api): update API spec from langfuse/langfuse be747a7

langfuse/api/__init__.py

@@ -304,7 +304,6 @@
         IngestionEvent_ObservationCreate,
         IngestionEvent_ObservationUpdate,
         IngestionEvent_ScoreCreate,
-        IngestionEvent_SdkLog,
         IngestionEvent_SpanCreate,
         IngestionEvent_SpanUpdate,
         IngestionEvent_TraceCreate,
@@ -319,8 +318,6 @@
         OptionalObservationBody,
         ScoreBody,
         ScoreEvent,
-        SdkLogBody,
-        SdkLogEvent,
         TraceBody,
         TraceEvent,
         UpdateEventBody,
@@ -669,7 +666,6 @@
     "IngestionEvent_ObservationCreate": ".ingestion",
     "IngestionEvent_ObservationUpdate": ".ingestion",
     "IngestionEvent_ScoreCreate": ".ingestion",
-    "IngestionEvent_SdkLog": ".ingestion",
     "IngestionEvent_SpanCreate": ".ingestion",
     "IngestionEvent_SpanUpdate": ".ingestion",
     "IngestionEvent_TraceCreate": ".ingestion",
@@ -820,8 +816,6 @@
     "Score_Correction": ".commons",
     "Score_Numeric": ".commons",
     "Score_Text": ".commons",
-    "SdkLogBody": ".ingestion",
-    "SdkLogEvent": ".ingestion",
     "ServiceProviderConfig": ".scim",
     "ServiceUnavailableError": ".health",
     "Session": ".commons",
@@ -1124,7 +1118,6 @@ def __dir__():
     "IngestionEvent_ObservationCreate",
     "IngestionEvent_ObservationUpdate",
     "IngestionEvent_ScoreCreate",
-    "IngestionEvent_SdkLog",
     "IngestionEvent_SpanCreate",
     "IngestionEvent_SpanUpdate",
     "IngestionEvent_TraceCreate",
@@ -1275,8 +1268,6 @@ def __dir__():
     "Score_Correction",
     "Score_Numeric",
     "Score_Text",
-    "SdkLogBody",
-    "SdkLogEvent",
     "ServiceProviderConfig",
     "ServiceUnavailableError",
     "Session",

langfuse/api/comments/client.py

@@ -1,5 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
+import datetime as dt
 import typing
 
 from ..commons.types.comment import Comment
@@ -36,6 +37,7 @@ def create(
         object_id: str,
         content: str,
         author_user_id: typing.Optional[str] = OMIT,
+        object_start_time: typing.Optional[dt.datetime] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CreateCommentResponse:
         """
@@ -58,6 +60,9 @@ def create(
         author_user_id : typing.Optional[str]
             The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
 
+        object_start_time : typing.Optional[dt.datetime]
+            The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -90,6 +95,7 @@ def create(
             object_id=object_id,
             content=content,
             author_user_id=author_user_id,
+            object_start_time=object_start_time,
             request_options=request_options,
         )
         return _response.data
@@ -221,6 +227,7 @@ async def create(
         object_id: str,
         content: str,
         author_user_id: typing.Optional[str] = OMIT,
+        object_start_time: typing.Optional[dt.datetime] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CreateCommentResponse:
         """
@@ -243,6 +250,9 @@ async def create(
         author_user_id : typing.Optional[str]
             The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
 
+        object_start_time : typing.Optional[dt.datetime]
+            The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -283,6 +293,7 @@ async def main() -> None:
             object_id=object_id,
             content=content,
             author_user_id=author_user_id,
+            object_start_time=object_start_time,
             request_options=request_options,
         )
         return _response.data

langfuse/api/comments/raw_client.py

@@ -1,5 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
+import datetime as dt
 import typing
 from json.decoder import JSONDecodeError
 
@@ -34,6 +35,7 @@ def create(
         object_id: str,
         content: str,
         author_user_id: typing.Optional[str] = OMIT,
+        object_start_time: typing.Optional[dt.datetime] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[CreateCommentResponse]:
         """
@@ -56,6 +58,9 @@ def create(
         author_user_id : typing.Optional[str]
             The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
 
+        object_start_time : typing.Optional[dt.datetime]
+            The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -72,6 +77,7 @@ def create(
                 "objectId": object_id,
                 "content": content,
                 "authorUserId": author_user_id,
+                "objectStartTime": object_start_time,
             },
             request_options=request_options,
             omit=OMIT,
@@ -398,6 +404,7 @@ async def create(
         object_id: str,
         content: str,
         author_user_id: typing.Optional[str] = OMIT,
+        object_start_time: typing.Optional[dt.datetime] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[CreateCommentResponse]:
         """
@@ -420,6 +427,9 @@ async def create(
         author_user_id : typing.Optional[str]
             The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
 
+        object_start_time : typing.Optional[dt.datetime]
+            The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -436,6 +446,7 @@ async def create(
                 "objectId": object_id,
                 "content": content,
                 "authorUserId": author_user_id,
+                "objectStartTime": object_start_time,
             },
             request_options=request_options,
             omit=OMIT,

langfuse/api/comments/types/create_comment_request.py

@@ -1,5 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
+import datetime as dt
 import typing
 
 import pydantic
@@ -42,6 +43,13 @@ class CreateCommentRequest(UniversalBaseModel):
     The id of the user who created the comment. Must be a member of the organization that owns the project, otherwise an error will be thrown.
     """
 
+    object_start_time: typing_extensions.Annotated[
+        typing.Optional[dt.datetime], FieldMetadata(alias="objectStartTime")
+    ] = pydantic.Field(default=None)
+    """
+    The start time of the referenced object (for observations, the observation's start time). Optional performance hint - when provided, Langfuse narrows the lookup to validate the reference faster. It only affects speed - an incorrect or omitted value never changes the result.
+    """
+
     model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
         extra="allow", frozen=True
     )

langfuse/api/evaluation_commons/types/evaluation_rule_filter.py

@@ -34,7 +34,7 @@ class EvaluationRuleFilter_Datetime(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -97,7 +97,7 @@ class EvaluationRuleFilter_String(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -160,7 +160,7 @@ class EvaluationRuleFilter_Number(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -223,7 +223,7 @@ class EvaluationRuleFilter_StringOptions(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -286,7 +286,7 @@ class EvaluationRuleFilter_CategoryOptions(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -350,7 +350,7 @@ class EvaluationRuleFilter_ArrayOptions(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -413,7 +413,7 @@ class EvaluationRuleFilter_StringObject(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -477,7 +477,7 @@ class EvaluationRuleFilter_NumberObject(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -541,7 +541,7 @@ class EvaluationRuleFilter_Boolean(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 
@@ -604,7 +604,7 @@ class EvaluationRuleFilter_Null(UniversalBaseModel):
     - `datetime`: `"="`, `">"`, `"<"`, `">="`, `"<="`
     - `stringOptions`: `any of`, `none of`
     - `arrayOptions`: `any of`, `none of`, `all of`
-    - `stringObject`: same operators as `string`
+    - `stringObject`: `"="`, `contains`, `does not contain`, `starts with`, `ends with`, `is set`, `is not set` (use `is set` / `is not set` for key presence; an empty value for `contains`, `starts with`, or `ends with` is treated as `is set`)
     - `boolean`: `"="`, `"<>"`
     - `null`: `is null`, `is not null`
 

langfuse/api/experiments/client.py

@@ -47,7 +47,10 @@ def list(
         Parameters
         ----------
         from_start_time : dt.datetime
-            Retrieve only experiments on or after this datetime.
+            Required. Retrieve only experiments with events on or after this
+            datetime. A lower bound is required so the query stays fast on
+            large projects; pair it with `toStartTime` to select a specific
+            window.
 
         fields : typing.Optional[str]
             Comma-separated list of field groups to include. Available groups:
@@ -145,7 +148,10 @@ def list_items(
         Parameters
         ----------
         from_start_time : dt.datetime
-            Retrieve only experiment items started on or after this datetime.
+            Required. Retrieve only experiment items started on or after this
+            datetime. A lower bound is required so the query stays fast on
+            large projects; pair it with `toStartTime` to select a specific
+            window.
 
         fields : typing.Optional[str]
             Comma-separated list of field groups to include. Available groups:
@@ -263,7 +269,10 @@ async def list(
         Parameters
         ----------
         from_start_time : dt.datetime
-            Retrieve only experiments on or after this datetime.
+            Required. Retrieve only experiments with events on or after this
+            datetime. A lower bound is required so the query stays fast on
+            large projects; pair it with `toStartTime` to select a specific
+            window.
 
         fields : typing.Optional[str]
             Comma-separated list of field groups to include. Available groups:
@@ -368,7 +377,10 @@ async def list_items(
         Parameters
         ----------
         from_start_time : dt.datetime
-            Retrieve only experiment items started on or after this datetime.
+            Required. Retrieve only experiment items started on or after this
+            datetime. A lower bound is required so the query stays fast on
+            large projects; pair it with `toStartTime` to select a specific
+            window.
 
         fields : typing.Optional[str]
             Comma-separated list of field groups to include. Available groups:

langfuse/api/experiments/raw_client.py

@@ -45,7 +45,10 @@ def list(
         Parameters
         ----------
         from_start_time : dt.datetime
-            Retrieve only experiments on or after this datetime.
+            Required. Retrieve only experiments with events on or after this
+            datetime. A lower bound is required so the query stays fast on
+            large projects; pair it with `toStartTime` to select a specific
+            window.
 
         fields : typing.Optional[str]
             Comma-separated list of field groups to include. Available groups:
@@ -205,7 +208,10 @@ def list_items(
         Parameters
         ----------
         from_start_time : dt.datetime
-            Retrieve only experiment items started on or after this datetime.
+            Required. Retrieve only experiment items started on or after this
+            datetime. A lower bound is required so the query stays fast on
+            large projects; pair it with `toStartTime` to select a specific
+            window.
 
         fields : typing.Optional[str]
             Comma-separated list of field groups to include. Available groups:
@@ -374,7 +380,10 @@ async def list(
         Parameters
         ----------
         from_start_time : dt.datetime
-            Retrieve only experiments on or after this datetime.
+            Required. Retrieve only experiments with events on or after this
+            datetime. A lower bound is required so the query stays fast on
+            large projects; pair it with `toStartTime` to select a specific
+            window.
 
         fields : typing.Optional[str]
             Comma-separated list of field groups to include. Available groups:
@@ -534,7 +543,10 @@ async def list_items(
         Parameters
         ----------
         from_start_time : dt.datetime
-            Retrieve only experiment items started on or after this datetime.
+            Required. Retrieve only experiment items started on or after this
+            datetime. A lower bound is required so the query stays fast on
+            large projects; pair it with `toStartTime` to select a specific
+            window.
 
         fields : typing.Optional[str]
             Comma-separated list of field groups to include. Available groups: