release: 0.35.0 (#244)

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.34.0"
+  ".": "0.35.0"
 }

.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-5d2697ad30ccbbd1502ade612deb9221a1e05e70d09a156da743d0ca120942f9.yml
+openapi_spec_hash: 0bde05b560fbd40711e91e6b562c3b0f
 config_hash: a4a6c3089a2e53425351cc9f42b4b5aa

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.35.0 (2025-11-05)
+
+Full Changelog: [v0.34.0...v0.35.0](https://github.com/groq/groq-typescript/compare/v0.34.0...v0.35.0)
+
+### Features
+
+* **api:** api update ([bca0314](https://github.com/groq/groq-typescript/commit/bca031417dfc044a8e5c2f0d847efe9a55f0ecbe))
+
 ## 0.34.0 (2025-10-16)
 
 Full Changelog: [v0.33.0...v0.34.0](https://github.com/groq/groq-typescript/compare/v0.33.0...v0.34.0)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "groq-sdk",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "description": "The official TypeScript library for the Groq API",
   "author": "Groq <[email protected]>",
   "types": "dist/index.d.ts",

src/resources/chat/completions.ts

@@ -290,6 +290,12 @@ export namespace ChatCompletionChunk {
      * A chat completion delta generated by streamed model responses.
      */
     export interface Delta {
+      /**
+       * A list of annotations providing citations and references for the content in the
+       * message.
+       */
+      annotations?: Array<Delta.Annotation>;
+
       /**
        * The contents of the chunk message.
        */
@@ -322,6 +328,70 @@ export namespace ChatCompletionChunk {
     }
 
     export namespace Delta {
+      /**
+       * An annotation that provides citations or references for content in a message.
+       */
+      export interface Annotation {
+        /**
+         * The type of annotation.
+         */
+        type: 'document_citation' | 'function_citation';
+
+        /**
+         * A citation referencing a specific document that was provided in the request.
+         */
+        document_citation?: Annotation.DocumentCitation;
+
+        /**
+         * A citation referencing the result of a function or tool call.
+         */
+        function_citation?: Annotation.FunctionCitation;
+      }
+
+      export namespace Annotation {
+        /**
+         * A citation referencing a specific document that was provided in the request.
+         */
+        export interface DocumentCitation {
+          /**
+           * The ID of the document being cited, corresponding to a document provided in the
+           * request.
+           */
+          document_id: string;
+
+          /**
+           * The character index in the message content where this citation ends.
+           */
+          end_index: number;
+
+          /**
+           * The character index in the message content where this citation begins.
+           */
+          start_index: number;
+        }
+
+        /**
+         * A citation referencing the result of a function or tool call.
+         */
+        export interface FunctionCitation {
+          /**
+           * The character index in the message content where this citation ends.
+           */
+          end_index: number;
+
+          /**
+           * The character index in the message content where this citation begins.
+           */
+          start_index: number;
+
+          /**
+           * The ID of the tool call being cited, corresponding to a tool call made during
+           * the conversation.
+           */
+          tool_call_id: string;
+        }
+      }
+
       export interface ExecutedTool {
         /**
          * The arguments passed to the tool in JSON format.
@@ -897,6 +967,12 @@ export interface ChatCompletionMessage {
    */
   role: 'assistant';
 
+  /**
+   * A list of annotations providing citations and references for the content in the
+   * message.
+   */
+  annotations?: Array<ChatCompletionMessage.Annotation>;
+
   /**
    * A list of tools that were executed during the chat completion for compound AI
    * systems.
@@ -922,6 +998,70 @@ export interface ChatCompletionMessage {
 }
 
 export namespace ChatCompletionMessage {
+  /**
+   * An annotation that provides citations or references for content in a message.
+   */
+  export interface Annotation {
+    /**
+     * The type of annotation.
+     */
+    type: 'document_citation' | 'function_citation';
+
+    /**
+     * A citation referencing a specific document that was provided in the request.
+     */
+    document_citation?: Annotation.DocumentCitation;
+
+    /**
+     * A citation referencing the result of a function or tool call.
+     */
+    function_citation?: Annotation.FunctionCitation;
+  }
+
+  export namespace Annotation {
+    /**
+     * A citation referencing a specific document that was provided in the request.
+     */
+    export interface DocumentCitation {
+      /**
+       * The ID of the document being cited, corresponding to a document provided in the
+       * request.
+       */
+      document_id: string;
+
+      /**
+       * The character index in the message content where this citation ends.
+       */
+      end_index: number;
+
+      /**
+       * The character index in the message content where this citation begins.
+       */
+      start_index: number;
+    }
+
+    /**
+     * A citation referencing the result of a function or tool call.
+     */
+    export interface FunctionCitation {
+      /**
+       * The character index in the message content where this citation ends.
+       */
+      end_index: number;
+
+      /**
+       * The character index in the message content where this citation begins.
+       */
+      start_index: number;
+
+      /**
+       * The ID of the tool call being cited, corresponding to a tool call made during
+       * the conversation.
+       */
+      tool_call_id: string;
+    }
+  }
+
   export interface ExecutedTool {
     /**
      * The arguments passed to the tool in JSON format.

src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.34.0'; // x-release-please-version
+export const VERSION = '0.35.0'; // x-release-please-version