feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-498dee72535c9b0585491899c8e5173ac2b83676710c741ef41faef415821683.yml
-openapi_spec_hash: aff11e3516f652d05f5416f6593994d1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-d992d797939cfe674a14745104fb3219af457d283b625d5599d11617acf447e0.yml
+openapi_spec_hash: 7059cc4dcba4efaa4e14513b4f26f9ed
 config_hash: a4a6c3089a2e53425351cc9f42b4b5aa

src/groq/types/chat/chat_completion_message.py

@@ -8,6 +8,9 @@
 
 __all__ = [
     "ChatCompletionMessage",
+    "Annotation",
+    "AnnotationDocumentCitation",
+    "AnnotationFunctionCitation",
     "ExecutedTool",
     "ExecutedToolBrowserResult",
     "ExecutedToolCodeResult",
@@ -19,6 +22,45 @@
 ]
 
 
+class AnnotationDocumentCitation(BaseModel):
+    document_id: str
+    """
+    The ID of the document being cited, corresponding to a document provided in the
+    request.
+    """
+
+    end_index: int
+    """The character index in the message content where this citation ends."""
+
+    start_index: int
+    """The character index in the message content where this citation begins."""
+
+
+class AnnotationFunctionCitation(BaseModel):
+    end_index: int
+    """The character index in the message content where this citation ends."""
+
+    start_index: int
+    """The character index in the message content where this citation begins."""
+
+    tool_call_id: str
+    """
+    The ID of the tool call being cited, corresponding to a tool call made during
+    the conversation.
+    """
+
+
+class Annotation(BaseModel):
+    type: Literal["document_citation", "function_citation"]
+    """The type of annotation."""
+
+    document_citation: Optional[AnnotationDocumentCitation] = None
+    """A citation referencing a specific document that was provided in the request."""
+
+    function_citation: Optional[AnnotationFunctionCitation] = None
+    """A citation referencing the result of a function or tool call."""
+
+
 class ExecutedToolBrowserResult(BaseModel):
     title: str
     """The title of the browser window"""
@@ -189,6 +231,12 @@ class ChatCompletionMessage(BaseModel):
     role: Literal["assistant"]
     """The role of the author of this message."""
 
+    annotations: Optional[List[Annotation]] = None
+    """
+    A list of annotations providing citations and references for the content in the
+    message.
+    """
+
     executed_tools: Optional[List[ExecutedTool]] = None
     """
     A list of tools that were executed during the chat completion for compound AI