From 61a9e99c984e43432d823388435893408d84ce0f Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 6 Aug 2025 21:30:42 +0000
Subject: [PATCH 01/15] feat(api): api update

---
 .stats.yml                        | 4 ++--
 src/resources/chat/completions.ts | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 75e9530..4bc2259 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-4543b558a0a546fc45d3300535b9b535f9cf251f4284bc255d3bc337727e5a50.yml
-openapi_spec_hash: 09235cb11f84f84a07819c2b3f0a6d6a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-5e252fe47b07065677cacccc37e7c481164400596c65a11e8d2b0c474587d4ea.yml
+openapi_spec_hash: 2193160ecbc3670a87a83af8f47550ae
 config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89
diff --git a/src/resources/chat/completions.ts b/src/resources/chat/completions.ts
index ad926b0..bd68993 100644
--- a/src/resources/chat/completions.ts
+++ b/src/resources/chat/completions.ts
@@ -1409,9 +1409,10 @@ export namespace ChatCompletionTokenLogprob {
 
 export interface ChatCompletionTool {
   /**
-   * The type of the tool. Currently, only `function` is supported.
+   * The type of the tool. `function`, `browser_search`, and `code_interpreter` are
+   * supported.
    */
-  type: 'function' | 'browser_search' | 'code_interpreter';
+  type: 'function' | 'browser_search' | 'code_interpreter' | (string & {});
 
   function?: Shared.FunctionDefinition;
 }

From 2e12bd1022f8cd168d41b62d753615b3900ee1f1 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 6 Aug 2025 23:31:05 +0000
Subject: [PATCH 02/15] feat(api): api update

---
 .stats.yml                        |  4 ++--
 src/resources/chat/completions.ts | 12 ++++++------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 4bc2259..5464426 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-5e252fe47b07065677cacccc37e7c481164400596c65a11e8d2b0c474587d4ea.yml
-openapi_spec_hash: 2193160ecbc3670a87a83af8f47550ae
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-7b30a76357bf665ea0e09e88a4ad7ba5cc84f575df8f946e713e280a105f80a1.yml
+openapi_spec_hash: 5c5b5381c30d2d382c79839f5c5fe84b
 config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89
diff --git a/src/resources/chat/completions.ts b/src/resources/chat/completions.ts
index bd68993..f488d5b 100644
--- a/src/resources/chat/completions.ts
+++ b/src/resources/chat/completions.ts
@@ -1496,9 +1496,9 @@ export interface ChatCompletionCreateParamsBase {
   exclude_domains?: Array<string> | null;
 
   /**
-   * Number between -2.0 and 2.0. Positive values penalize new tokens based on their
-   * existing frequency in the text so far, decreasing the model's likelihood to
-   * repeat the same line verbatim.
+   * This is not yet supported by any of our models. Number between -2.0 and 2.0.
+   * Positive values penalize new tokens based on their existing frequency in the
+   * text so far, decreasing the model's likelihood to repeat the same line verbatim.
    */
   frequency_penalty?: number | null;
 
@@ -1581,9 +1581,9 @@ export interface ChatCompletionCreateParamsBase {
   parallel_tool_calls?: boolean | null;
 
   /**
-   * Number between -2.0 and 2.0. Positive values penalize new tokens based on
-   * whether they appear in the text so far, increasing the model's likelihood to
-   * talk about new topics.
+   * This is not yet supported by any of our models. Number between -2.0 and 2.0.
+   * Positive values penalize new tokens based on whether they appear in the text so
+   * far, increasing the model's likelihood to talk about new topics.
    */
   presence_penalty?: number | null;
 

From 5fe1890402075a67d6ea4472b6196273cd0b0f9e Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 7 Aug 2025 04:44:56 +0000
Subject: [PATCH 03/15] chore(internal): move publish config

---
 bin/publish-npm | 2 +-
 package.json    | 3 +++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/bin/publish-npm b/bin/publish-npm
index fa2243d..45e8aa8 100644
--- a/bin/publish-npm
+++ b/bin/publish-npm
@@ -58,4 +58,4 @@ else
 fi
 
 # Publish with the appropriate tag
-yarn publish --access public --tag "$TAG"
+yarn publish --tag "$TAG"
diff --git a/package.json b/package.json
index 95a198a..212fe41 100644
--- a/package.json
+++ b/package.json
@@ -13,6 +13,9 @@
     "**/*"
   ],
   "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "test": "./scripts/test",
     "build": "./scripts/build",

From f772446f655ff905c14f40f45cafc4109ef7f912 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 9 Aug 2025 01:11:40 +0000
Subject: [PATCH 04/15] feat(api): api update

---
 .stats.yml                        | 4 ++--
 src/resources/chat/completions.ts | 7 +++++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 5464426..5d7557a 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-7b30a76357bf665ea0e09e88a4ad7ba5cc84f575df8f946e713e280a105f80a1.yml
-openapi_spec_hash: 5c5b5381c30d2d382c79839f5c5fe84b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-8f955114b8dc48157b4a968ceb5538b361028faf92610b03b9720006f396bf51.yml
+openapi_spec_hash: 09e9371adca4293f21e7c73211c2dad9
 config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89
diff --git a/src/resources/chat/completions.ts b/src/resources/chat/completions.ts
index f488d5b..b66eeed 100644
--- a/src/resources/chat/completions.ts
+++ b/src/resources/chat/completions.ts
@@ -1588,8 +1588,11 @@ export interface ChatCompletionCreateParamsBase {
   presence_penalty?: number | null;
 
   /**
-   * this field is only available for qwen3 models. Set to 'none' to disable
-   * reasoning. Set to 'default' or null to let Qwen reason.
+   * qwen3 models support the following values Set to 'none' to disable reasoning.
+   * Set to 'default' or null to let Qwen reason.
+   *
+   * openai/gpt-oss-20b and openai/gpt-oss-120b support 'low', 'medium', or 'high'.
+   * 'medium' is the default value.
    */
   reasoning_effort?: 'none' | 'default' | 'low' | 'medium' | 'high' | null;
 

From 35cd68309611e5e77f04974ce18b516116f3346d Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 9 Aug 2025 05:41:34 +0000
Subject: [PATCH 05/15] chore: update @stainless-api/prism-cli to v5.15.0

---
 scripts/mock | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scripts/mock b/scripts/mock
index d2814ae..0b28f6e 100755
--- a/scripts/mock
+++ b/scripts/mock
@@ -21,7 +21,7 @@ echo "==> Starting mock server with URL ${URL}"
 
 # Run prism mock on the given spec
 if [ "$1" == "--daemon" ]; then
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL" &> .prism.log &
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
 
   # Wait for server to come online
   echo -n "Waiting for server"
@@ -37,5 +37,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stainless-api/prism-cli@5.8.5 -- prism mock "$URL"
+  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL"
 fi

From 2a69a4195d773bd0c6c1dcc0e49824ed6f50b24d Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 9 Aug 2025 05:44:21 +0000
Subject: [PATCH 06/15] chore(internal): update comment in script

---
 scripts/test | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/test b/scripts/test
index 2049e31..7bce051 100755
--- a/scripts/test
+++ b/scripts/test
@@ -43,7 +43,7 @@ elif ! prism_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the prism command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stoplight/prism-cli@~5.3.2 -- prism mock path/to/your.openapi.yml${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
   echo
 
   exit 1

From 44424c26018f43b69682bebca7e9c734b5d0f1e0 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 14 Aug 2025 00:32:13 +0000
Subject: [PATCH 07/15] feat(api): api update

---
 .stats.yml                                   |  4 +--
 src/resources/chat/completions.ts            | 26 ++++++++++++++++++++
 tests/api-resources/chat/completions.test.ts |  1 +
 3 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 5d7557a..fdeb2fe 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-8f955114b8dc48157b4a968ceb5538b361028faf92610b03b9720006f396bf51.yml
-openapi_spec_hash: 09e9371adca4293f21e7c73211c2dad9
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-006dd9001842930a2cfefe6df983816d3ff8f87444460245a1078f0d107d1410.yml
+openapi_spec_hash: 1225c7359fd89cae0db1099647495862
 config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89
diff --git a/src/resources/chat/completions.ts b/src/resources/chat/completions.ts
index b66eeed..a369897 100644
--- a/src/resources/chat/completions.ts
+++ b/src/resources/chat/completions.ts
@@ -1488,6 +1488,11 @@ export interface ChatCompletionCreateParamsBase {
     | 'llama3-70b-8192'
     | 'llama3-8b-8192';
 
+  /**
+   * Custom configuration of models and tools for Compound.
+   */
+  compound_custom?: CompletionCreateParams.CompoundCustom | null;
+
   /**
    * @deprecated Deprecated: Use search_settings.exclude_domains instead. A list of
    * domains to exclude from the search results when the model uses a web search
@@ -1711,6 +1716,27 @@ export interface ChatCompletionCreateParamsBase {
 }
 
 export namespace CompletionCreateParams {
+  /**
+   * Custom configuration of models and tools for Compound.
+   */
+  export interface CompoundCustom {
+    models?: CompoundCustom.Models | null;
+  }
+
+  export namespace CompoundCustom {
+    export interface Models {
+      /**
+       * Custom model to use for answering.
+       */
+      answering_model?: string | null;
+
+      /**
+       * Custom model to use for reasoning.
+       */
+      reasoning_model?: string | null;
+    }
+  }
+
   /**
    * @deprecated
    */
diff --git a/tests/api-resources/chat/completions.test.ts b/tests/api-resources/chat/completions.test.ts
index 8ceea1b..0c550dc 100644
--- a/tests/api-resources/chat/completions.test.ts
+++ b/tests/api-resources/chat/completions.test.ts
@@ -27,6 +27,7 @@ describe('resource completions', () => {
     const response = await client.chat.completions.create({
       messages: [{ content: 'string', role: 'system', name: 'name' }],
       model: 'meta-llama/llama-4-scout-17b-16e-instruct',
+      compound_custom: { models: { answering_model: 'answering_model', reasoning_model: 'reasoning_model' } },
       exclude_domains: ['string'],
       frequency_penalty: -2,
       function_call: 'none',

From 49384963049a83b196e87595046e7686fcdfcca0 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 16 Aug 2025 04:55:55 +0000
Subject: [PATCH 08/15] chore(deps): update dependency node-fetch to v2.6.13

---
 yarn.lock | 52 ++++++++++++++++++++++++++--------------------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/yarn.lock b/yarn.lock
index acefb7f..2bcc59e 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -852,19 +852,19 @@
   integrity sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==
 
 "@types/node-fetch@^2.6.4":
-  version "2.6.4"
-  resolved "https://registry.yarnpkg.com/@types/node-fetch/-/node-fetch-2.6.4.tgz#1bc3a26de814f6bf466b25aeb1473fa1afe6a660"
-  integrity sha512-1ZX9fcN4Rvkvgv4E6PAY5WXUFWFcRWxZa3EW83UjycOB9ljJCedb2CupIP4RZMEwF/M3eTcCihbBRgwtGbg5Rg==
+  version "2.6.13"
+  resolved "https://registry.yarnpkg.com/@types/node-fetch/-/node-fetch-2.6.13.tgz#e0c9b7b5edbdb1b50ce32c127e85e880872d56ee"
+  integrity sha512-QGpRVpzSaUs30JBSGPjOg4Uveu384erbHBoT1zeONvyCfwQxIkUshLAOqN/k9EjGviPRmWTTe6aH2qySWKTVSw==
   dependencies:
     "@types/node" "*"
-    form-data "^3.0.0"
+    form-data "^4.0.4"
 
 "@types/node@*":
-  version "20.10.5"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-20.10.5.tgz#47ad460b514096b7ed63a1dae26fad0914ed3ab2"
-  integrity sha512-nNPsNE65wjMxEKI93yOP+NPGGBJz/PoN3kZsVLee0XMiJolxSekEVD8wRwBUBqkwc7UWop0edW50yrCQW4CyRw==
+  version "24.3.0"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-24.3.0.tgz#89b09f45cb9a8ee69466f18ee5864e4c3eb84dec"
+  integrity sha512-aPTXCrfwnDLj4VvXrm+UUCQjNEvJgNA8s5F1cvwQU+3KNltTOkBm1j30uNLyqqPNe7gE3KFzImYoZEfLhp4Yow==
   dependencies:
-    undici-types "~5.26.4"
+    undici-types "~7.10.0"
 
 "@types/node@^18.11.18":
   version "18.11.18"
@@ -1097,7 +1097,7 @@ array-union@^2.1.0:
 asynckit@^0.4.0:
   version "0.4.0"
   resolved "https://registry.yarnpkg.com/asynckit/-/asynckit-0.4.0.tgz#c79ed97f7f34cb8f2ba1bc9790bcc366474b4b79"
-  integrity sha1-x57Zf380y48robyXkLzDZkdLS3k=
+  integrity sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==
 
 babel-jest@^29.7.0:
   version "29.7.0"
@@ -1441,7 +1441,7 @@ define-lazy-prop@^3.0.0:
 delayed-stream@~1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/delayed-stream/-/delayed-stream-1.0.0.tgz#df3ae199acadfb7d440aaae0b29e2272b24ec619"
-  integrity sha1-3zrhmayt+31ECqrgsp4icrJOxhk=
+  integrity sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==
 
 depd@^1.1.2:
   version "1.1.2"
@@ -1824,16 +1824,16 @@ form-data-encoder@1.7.2:
   resolved "https://registry.yarnpkg.com/form-data-encoder/-/form-data-encoder-1.7.2.tgz#1f1ae3dccf58ed4690b86d87e4f57c654fbab040"
   integrity sha512-qfqtYan3rxrnCk1VYaA4H+Ms9xdpPqvLZa6xmMgFvhO32x7/3J/ExcTd6qpxM0vH2GdMI+poehyBZvqfMTto8A==
 
-form-data@^3.0.0:
-  version "3.0.4"
-  resolved "https://registry.yarnpkg.com/form-data/-/form-data-3.0.4.tgz#938273171d3f999286a4557528ce022dc2c98df1"
-  integrity sha512-f0cRzm6dkyVYV3nPoooP8XlccPQukegwhAnpoLcXy+X+A8KfpGOoXwDr9FLZd3wzgLaBGQBE3lY93Zm/i1JvIQ==
+form-data@^4.0.4:
+  version "4.0.4"
+  resolved "https://registry.yarnpkg.com/form-data/-/form-data-4.0.4.tgz#784cdcce0669a9d68e94d11ac4eea98088edd2c4"
+  integrity sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==
   dependencies:
     asynckit "^0.4.0"
     combined-stream "^1.0.8"
     es-set-tostringtag "^2.1.0"
     hasown "^2.0.2"
-    mime-types "^2.1.35"
+    mime-types "^2.1.12"
 
 formdata-node@^4.3.2:
   version "4.3.3"
@@ -2733,7 +2733,7 @@ mime-db@1.52.0:
   resolved "https://registry.yarnpkg.com/mime-db/-/mime-db-1.52.0.tgz#bbabcdc02859f4987301c856e3387ce5ec43bf70"
   integrity sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==
 
-mime-types@^2.1.35:
+mime-types@^2.1.12:
   version "2.1.35"
   resolved "https://registry.yarnpkg.com/mime-types/-/mime-types-2.1.35.tgz#381a871b62a734450660ae3deee44813f70d959a"
   integrity sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==
@@ -2790,9 +2790,9 @@ node-domexception@1.0.0:
   integrity sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ==
 
 node-fetch@^2.6.7:
-  version "2.6.11"
-  resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.6.11.tgz#cde7fc71deef3131ef80a738919f999e6edfff25"
-  integrity sha512-4I6pdBY1EthSqDmJkiNk3JIT8cswwR9nfeW/cPdUagJYEQG7R95WRH74wpz7ma8Gh/9dI9FP+OU+0E4FvtA55w==
+  version "2.7.0"
+  resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.7.0.tgz#d0f0fa6e3e2dc1d27efcd8ad99d550bda94d187d"
+  integrity sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==
   dependencies:
     whatwg-url "^5.0.0"
 
@@ -3329,7 +3329,7 @@ to-regex-range@^5.0.1:
 tr46@~0.0.3:
   version "0.0.3"
   resolved "https://registry.yarnpkg.com/tr46/-/tr46-0.0.3.tgz#8184fd347dac9cdc185992f3a6622e14b9d9ab6a"
-  integrity sha1-gYT9NH2snNwYWZLzpmIuFLnZq2o=
+  integrity sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==
 
 ts-api-utils@^1.0.1:
   version "1.3.0"
@@ -3431,10 +3431,10 @@ typescript@^4.8.2:
   resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.9.5.tgz#095979f9bcc0d09da324d58d03ce8f8374cbe65a"
   integrity sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==
 
-undici-types@~5.26.4:
-  version "5.26.5"
-  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-5.26.5.tgz#bcd539893d00b56e964fd2657a4866b221a65617"
-  integrity sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==
+undici-types@~7.10.0:
+  version "7.10.0"
+  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-7.10.0.tgz#4ac2e058ce56b462b056e629cc6a02393d3ff350"
+  integrity sha512-t5Fy/nfn+14LuOc2KNYg75vZqClpAiqscVvMygNnlsHBFpSXdJaYtXMcdNLpl/Qvc3P2cB3s6lOV51nqsFq4ag==
 
 untildify@^4.0.0:
   version "4.0.0"
@@ -3490,12 +3490,12 @@ web-streams-polyfill@4.0.0-beta.1:
 webidl-conversions@^3.0.0:
   version "3.0.1"
   resolved "https://registry.yarnpkg.com/webidl-conversions/-/webidl-conversions-3.0.1.tgz#24534275e2a7bc6be7bc86611cc16ae0a5654871"
-  integrity sha1-JFNCdeKnvGvnvIZhHMFq4KVlSHE=
+  integrity sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==
 
 whatwg-url@^5.0.0:
   version "5.0.0"
   resolved "https://registry.yarnpkg.com/whatwg-url/-/whatwg-url-5.0.0.tgz#966454e8765462e37644d3626f6742ce8b70965d"
-  integrity sha1-lmRU6HZUYuN2RNNib2dCzotwll0=
+  integrity sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==
   dependencies:
     tr46 "~0.0.3"
     webidl-conversions "^3.0.0"

From a287d5e41f1b6bba338b0cc3e1b9212a35b4e824 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 16 Aug 2025 04:37:59 +0000
Subject: [PATCH 09/15] chore(internal): formatting change

---
 src/index.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/index.ts b/src/index.ts
index 6682f35..cc503c7 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -218,6 +218,7 @@ Groq.Audio = Audio;
 Groq.Models = Models;
 Groq.Batches = Batches;
 Groq.Files = Files;
+
 export declare namespace Groq {
   export type RequestOptions = Core.RequestOptions;
 

From be48d38f749dc4599ab71633ff226583f6e74b02 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 19 Aug 2025 13:23:23 +0000
Subject: [PATCH 10/15] feat(api): api update

---
 .stats.yml                                   |  4 ++--
 src/resources/chat/completions.ts            | 13 +++++++++++++
 tests/api-resources/chat/completions.test.ts |  1 +
 3 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index fdeb2fe..71b7ea6 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-006dd9001842930a2cfefe6df983816d3ff8f87444460245a1078f0d107d1410.yml
-openapi_spec_hash: 1225c7359fd89cae0db1099647495862
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-0a2779fa23c3e3a076b13af2d98a559e3081e1c2cb8fbfe1aa9195cceb338cfb.yml
+openapi_spec_hash: 3f5c8e24957acc056bc99c0d07b034e3
 config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89
diff --git a/src/resources/chat/completions.ts b/src/resources/chat/completions.ts
index a369897..9002705 100644
--- a/src/resources/chat/completions.ts
+++ b/src/resources/chat/completions.ts
@@ -1493,6 +1493,12 @@ export interface ChatCompletionCreateParamsBase {
    */
   compound_custom?: CompletionCreateParams.CompoundCustom | null;
 
+  /**
+   * A list of documents to provide context for the conversation. Each document
+   * contains text that can be referenced by the model.
+   */
+  documents?: Array<CompletionCreateParams.Document> | null;
+
   /**
    * @deprecated Deprecated: Use search_settings.exclude_domains instead. A list of
    * domains to exclude from the search results when the model uses a web search
@@ -1737,6 +1743,13 @@ export namespace CompletionCreateParams {
     }
   }
 
+  export interface Document {
+    /**
+     * The text content of the document.
+     */
+    text: string;
+  }
+
   /**
    * @deprecated
    */
diff --git a/tests/api-resources/chat/completions.test.ts b/tests/api-resources/chat/completions.test.ts
index 0c550dc..01944a3 100644
--- a/tests/api-resources/chat/completions.test.ts
+++ b/tests/api-resources/chat/completions.test.ts
@@ -28,6 +28,7 @@ describe('resource completions', () => {
       messages: [{ content: 'string', role: 'system', name: 'name' }],
       model: 'meta-llama/llama-4-scout-17b-16e-instruct',
       compound_custom: { models: { answering_model: 'answering_model', reasoning_model: 'reasoning_model' } },
+      documents: [{ text: 'text' }],
       exclude_domains: ['string'],
       frequency_penalty: -2,
       function_call: 'none',

From e863bc04c0324e2b5cdf2fab8abe36e2c4469907 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 23 Aug 2025 05:58:34 +0000
Subject: [PATCH 11/15] chore: update CI script

---
 scripts/utils/upload-artifact.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/utils/upload-artifact.sh b/scripts/utils/upload-artifact.sh
index 80e368c..9dc0825 100755
--- a/scripts/utils/upload-artifact.sh
+++ b/scripts/utils/upload-artifact.sh
@@ -12,7 +12,7 @@ if [[ "$SIGNED_URL" == "null" ]]; then
   exit 1
 fi
 
-UPLOAD_RESPONSE=$(tar -cz dist | curl -v -X PUT \
+UPLOAD_RESPONSE=$(tar -cz "${BUILD_PATH:-dist}" | curl -v -X PUT \
   -H "Content-Type: application/gzip" \
   --data-binary @- "$SIGNED_URL" 2>&1)
 

From 62083c6aedbf41f21e0f60d0fb3a7f1fa61971ed Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 29 Aug 2025 19:16:57 +0000
Subject: [PATCH 12/15] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 71b7ea6..92a3584 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-0a2779fa23c3e3a076b13af2d98a559e3081e1c2cb8fbfe1aa9195cceb338cfb.yml
-openapi_spec_hash: 3f5c8e24957acc056bc99c0d07b034e3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-7ff19dcc54e8e55851740a0cc0577a16e3db971fd07cf4514f5d986285e4e559.yml
+openapi_spec_hash: def41bfa81794ce4b00620e1eaf627ca
 config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89

From 523355dfac2fbdc077c8ae6b8c280e5ce5eeb420 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 30 Aug 2025 16:10:04 +0000
Subject: [PATCH 13/15] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 92a3584..6de13db 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-7ff19dcc54e8e55851740a0cc0577a16e3db971fd07cf4514f5d986285e4e559.yml
-openapi_spec_hash: def41bfa81794ce4b00620e1eaf627ca
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-a95a90928412afdb9cf5101b7fbb67ef2abbc4ecaa51ff18fa04643f9e8d2c95.yml
+openapi_spec_hash: d2e5cb1562a2b2beb8673256252b9bf5
 config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89

From 1c69897c7fe09a0d0df5f041749a17a95ed878cd Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 2 Sep 2025 16:17:34 +0000
Subject: [PATCH 14/15] fix: update example model from decommissioned models to
 gpt-oss-20b

---
 .stats.yml |  2 +-
 README.md  | 16 ++++++++--------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 6de13db..394ba41 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 17
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-a95a90928412afdb9cf5101b7fbb67ef2abbc4ecaa51ff18fa04643f9e8d2c95.yml
 openapi_spec_hash: d2e5cb1562a2b2beb8673256252b9bf5
-config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89
+config_hash: 961b4995e909aef11a454befa56ad3d2
diff --git a/README.md b/README.md
index 6d704ff..0fb105e 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,7 @@ const client = new Groq({
 
 const chatCompletion = await client.chat.completions.create({
   messages: [{ role: 'user', content: 'Explain the importance of low latency LLMs' }],
-  model: 'llama3-8b-8192',
+  model: 'openai/gpt-oss-20b',
 });
 
 console.log(chatCompletion.choices[0].message.content);
@@ -51,7 +51,7 @@ const params: Groq.Chat.CompletionCreateParams = {
     { role: 'system', content: 'You are a helpful assistant.' },
     { role: 'user', content: 'Explain the importance of low latency LLMs' },
   ],
-  model: 'llama3-8b-8192',
+  model: 'openai/gpt-oss-20b',
 };
 const chatCompletion: Groq.Chat.ChatCompletion = await client.chat.completions.create(params);
 ```
@@ -117,7 +117,7 @@ const chatCompletion = await client.chat.completions
       { role: 'system', content: 'You are a helpful assistant.' },
       { role: 'user', content: 'Explain the importance of low latency LLMs' },
     ],
-    model: 'llama3-8b-8192',
+    model: 'openai/gpt-oss-20b',
   })
   .catch(async (err) => {
     if (err instanceof Groq.APIError) {
@@ -159,7 +159,7 @@ const client = new Groq({
 });
 
 // Or, configure per-request:
-await client.chat.completions.create({ messages: [{ role: 'system', content: 'You are a helpful assistant.' }, { role: 'user', content: 'Explain the importance of low latency LLMs' }], model: 'llama3-8b-8192' }, {
+await client.chat.completions.create({ messages: [{ role: 'system', content: 'You are a helpful assistant.' }, { role: 'user', content: 'Explain the importance of low latency LLMs' }], model: 'openai/gpt-oss-20b' }, {
   maxRetries: 5,
 });
 ```
@@ -176,7 +176,7 @@ const client = new Groq({
 });
 
 // Override per-request:
-await client.chat.completions.create({ messages: [{ role: 'system', content: 'You are a helpful assistant.' }, { role: 'user', content: 'Explain the importance of low latency LLMs' }], model: 'llama3-8b-8192' }, {
+await client.chat.completions.create({ messages: [{ role: 'system', content: 'You are a helpful assistant.' }, { role: 'user', content: 'Explain the importance of low latency LLMs' }], model: 'openai/gpt-oss-20b' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -203,7 +203,7 @@ const response = await client.chat.completions
       { role: 'system', content: 'You are a helpful assistant.' },
       { role: 'user', content: 'Explain the importance of low latency LLMs' },
     ],
-    model: 'llama3-8b-8192',
+    model: 'openai/gpt-oss-20b',
   })
   .asResponse();
 console.log(response.headers.get('X-My-Header'));
@@ -215,7 +215,7 @@ const { data: chatCompletion, response: raw } = await client.chat.completions
       { role: 'system', content: 'You are a helpful assistant.' },
       { role: 'user', content: 'Explain the importance of low latency LLMs' },
     ],
-    model: 'llama3-8b-8192',
+    model: 'openai/gpt-oss-20b',
   })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
@@ -329,7 +329,7 @@ await client.chat.completions.create(
       { role: 'system', content: 'You are a helpful assistant.' },
       { role: 'user', content: 'Explain the importance of low latency LLMs' },
     ],
-    model: 'llama3-8b-8192',
+    model: 'openai/gpt-oss-20b',
   },
   {
     httpAgent: new http.Agent({ keepAlive: false }),

From 012474085f3d3076f1a3e5e43c381f5252965664 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 2 Sep 2025 16:17:52 +0000
Subject: [PATCH 15/15] release: 0.31.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 27 +++++++++++++++++++++++++++
 package.json                  |  2 +-
 src/version.ts                |  2 +-
 4 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 716d004..8e3d955 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.30.0"
+  ".": "0.31.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 700486e..23dadfc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.31.0 (2025-09-02)
+
+Full Changelog: [v0.30.0...v0.31.0](https://github.com/groq/groq-typescript/compare/v0.30.0...v0.31.0)
+
+### Features
+
+* **api:** api update ([be48d38](https://github.com/groq/groq-typescript/commit/be48d38f749dc4599ab71633ff226583f6e74b02))
+* **api:** api update ([44424c2](https://github.com/groq/groq-typescript/commit/44424c26018f43b69682bebca7e9c734b5d0f1e0))
+* **api:** api update ([f772446](https://github.com/groq/groq-typescript/commit/f772446f655ff905c14f40f45cafc4109ef7f912))
+* **api:** api update ([2e12bd1](https://github.com/groq/groq-typescript/commit/2e12bd1022f8cd168d41b62d753615b3900ee1f1))
+* **api:** api update ([61a9e99](https://github.com/groq/groq-typescript/commit/61a9e99c984e43432d823388435893408d84ce0f))
+
+
+### Bug Fixes
+
+* update example model from decommissioned models to gpt-oss-20b ([1c69897](https://github.com/groq/groq-typescript/commit/1c69897c7fe09a0d0df5f041749a17a95ed878cd))
+
+
+### Chores
+
+* **deps:** update dependency node-fetch to v2.6.13 ([4938496](https://github.com/groq/groq-typescript/commit/49384963049a83b196e87595046e7686fcdfcca0))
+* **internal:** formatting change ([a287d5e](https://github.com/groq/groq-typescript/commit/a287d5e41f1b6bba338b0cc3e1b9212a35b4e824))
+* **internal:** move publish config ([5fe1890](https://github.com/groq/groq-typescript/commit/5fe1890402075a67d6ea4472b6196273cd0b0f9e))
+* **internal:** update comment in script ([2a69a41](https://github.com/groq/groq-typescript/commit/2a69a4195d773bd0c6c1dcc0e49824ed6f50b24d))
+* update @stainless-api/prism-cli to v5.15.0 ([35cd683](https://github.com/groq/groq-typescript/commit/35cd68309611e5e77f04974ce18b516116f3346d))
+* update CI script ([e863bc0](https://github.com/groq/groq-typescript/commit/e863bc04c0324e2b5cdf2fab8abe36e2c4469907))
+
 ## 0.30.0 (2025-08-05)
 
 Full Changelog: [v0.29.0...v0.30.0](https://github.com/groq/groq-typescript/compare/v0.29.0...v0.30.0)
diff --git a/package.json b/package.json
index 212fe41..fffbb20 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "groq-sdk",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "The official TypeScript library for the Groq API",
   "author": "Groq <support@groq.com>",
   "types": "dist/index.d.ts",
diff --git a/src/version.ts b/src/version.ts
index 91a9bb6..b6314c2 100644
--- a/src/version.ts
+++ b/src/version.ts
@@ -1 +1 @@
-export const VERSION = '0.30.0'; // x-release-please-version
+export const VERSION = '0.31.0'; // x-release-please-version