[MLOB-6991] Add session interaction type to LLM Observability API spec

.generator/schemas/v2/openapi.yaml

@@ -38173,7 +38173,7 @@ components:
             $ref: "#/components/schemas/LLMObsAnnotationItem"
           type: array
         content_id:
-          description: Identifier of the content for this interaction.
+          description: Identifier of the content (trace ID or session ID) for this interaction.
           example: "trace-abc-123"
           type: string
         id:
@@ -38376,7 +38376,7 @@ components:
       description: A single interaction to add to an annotation queue.
       properties:
         content_id:
-          description: Identifier of the content (such as trace ID) for this interaction.
+          description: Identifier of the content (trace ID or session ID) for this interaction.
           example: "trace-abc-123"
           type: string
         type:
@@ -38393,7 +38393,7 @@ components:
           example: false
           type: boolean
         content_id:
-          description: Identifier of the content for this interaction.
+          description: Identifier of the content (trace ID or session ID) for this interaction.
           example: "trace-abc-123"
           type: string
         id:
@@ -39912,11 +39912,13 @@ components:
       enum:
         - trace
         - experiment_trace
+        - session
       example: trace
       type: string
       x-enum-varnames:
         - TRACE
         - EXPERIMENT_TRACE
+        - SESSION
     LLMObsLabelSchema:
       description: Schema definition for a single label in an annotation queue.
       properties:
@@ -104738,7 +104740,7 @@ paths:
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/llm-obs/v1/annotation-queues/{queue_id}/annotated-interactions:
     get:
-      description: Retrieve all interactions and their annotations for a given annotation queue.
+      description: Retrieve all interactions (traces and sessions) and their annotations for a given annotation queue.
       operationId: GetLLMObsAnnotatedInteractions
       parameters:
         - $ref: "#/components/parameters/LLMObsAnnotationQueueIDPathParameter"
@@ -104787,7 +104789,7 @@ paths:
   /api/v2/llm-obs/v1/annotation-queues/{queue_id}/interactions:
     post:
       description: |-
-        Add one or more interactions (traces) to an annotation queue.
+        Add one or more interactions (traces or sessions) to an annotation queue.
         At least one interaction must be provided.
       operationId: CreateLLMObsAnnotationQueueInteractions
       parameters:

src/datadog_api_client/v2/api/llm_observability_api.py

@@ -890,7 +890,7 @@ def create_llm_obs_annotation_queue_interactions(
     ) -> LLMObsAnnotationQueueInteractionsResponse:
         """Add annotation queue interactions.
 
-        Add one or more interactions (traces) to an annotation queue.
+        Add one or more interactions (traces or sessions) to an annotation queue.
         At least one interaction must be provided.
 
         :param queue_id: The ID of the LLM Observability annotation queue.
@@ -1156,7 +1156,7 @@ def get_llm_obs_annotated_interactions(
     ) -> LLMObsAnnotatedInteractionsResponse:
         """Get annotated queue interactions.
 
-        Retrieve all interactions and their annotations for a given annotation queue.
+        Retrieve all interactions (traces and sessions) and their annotations for a given annotation queue.
 
         :param queue_id: The ID of the LLM Observability annotation queue.
         :type queue_id: str

src/datadog_api_client/v2/model/llm_obs_annotated_interaction_item.py

@@ -45,7 +45,7 @@ def __init__(
         :param annotations: List of annotations for this interaction.
         :type annotations: [LLMObsAnnotationItem]
 
-        :param content_id: Identifier of the content for this interaction.
+        :param content_id: Identifier of the content (trace ID or session ID) for this interaction.
         :type content_id: str
 
         :param id: Unique identifier of the interaction.

src/datadog_api_client/v2/model/llm_obs_annotation_queue_interaction_item.py

@@ -34,7 +34,7 @@ def __init__(self_, content_id: str, type: LLMObsInteractionType, **kwargs):
         """
         A single interaction to add to an annotation queue.
 
-        :param content_id: Identifier of the content (such as trace ID) for this interaction.
+        :param content_id: Identifier of the content (trace ID or session ID) for this interaction.
         :type content_id: str
 
         :param type: Type of interaction in an annotation queue.

src/datadog_api_client/v2/model/llm_obs_annotation_queue_interaction_response_item.py

@@ -41,7 +41,7 @@ def __init__(self_, already_existed: bool, content_id: str, id: str, type: LLMOb
         :param already_existed: Whether this interaction already existed in the queue.
         :type already_existed: bool
 
-        :param content_id: Identifier of the content for this interaction.
+        :param content_id: Identifier of the content (trace ID or session ID) for this interaction.
         :type content_id: str
 
         :param id: Unique identifier of the interaction.

src/datadog_api_client/v2/model/llm_obs_interaction_type.py

@@ -16,16 +16,18 @@ class LLMObsInteractionType(ModelSimple):
     """
     Type of interaction in an annotation queue.
 
-    :param value: Must be one of ["trace", "experiment_trace"].
+    :param value: Must be one of ["trace", "experiment_trace", "session"].
     :type value: str
     """
 
     allowed_values = {
         "trace",
         "experiment_trace",
+        "session",
     }
     TRACE: ClassVar["LLMObsInteractionType"]
     EXPERIMENT_TRACE: ClassVar["LLMObsInteractionType"]
+    SESSION: ClassVar["LLMObsInteractionType"]
 
     @cached_property
     def openapi_types(_):
@@ -36,3 +38,4 @@ def openapi_types(_):
 
 LLMObsInteractionType.TRACE = LLMObsInteractionType("trace")
 LLMObsInteractionType.EXPERIMENT_TRACE = LLMObsInteractionType("experiment_trace")
+LLMObsInteractionType.SESSION = LLMObsInteractionType("session")