From 240ca42401366b75cf70b0eb0ff9f63425c9b358 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 26 Mar 2026 19:30:14 +0000
Subject: [PATCH 1/8] chore(internal): update multipart form array
 serialization

---
 scripts/mock | 4 ++--
 scripts/test | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/scripts/mock b/scripts/mock
index 9ecceca0..4931f304 100755
--- a/scripts/mock
+++ b/scripts/mock
@@ -24,7 +24,7 @@ if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
   npm exec --package=@stdy/cli@0.19.7 -- steady --version
 
-  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=brackets --validator-query-array-format=brackets --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL" &> .stdy.log &
+  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
 
   # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
@@ -48,5 +48,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=brackets --validator-query-array-format=brackets --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL"
+  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
 fi
diff --git a/scripts/test b/scripts/test
index 728c9521..bf69114d 100755
--- a/scripts/test
+++ b/scripts/test
@@ -43,7 +43,7 @@ elif ! steady_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.7 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-form-array-format=brackets --validator-query-array-format=brackets --validator-form-object-format=brackets --validator-query-object-format=brackets${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.7 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
   echo
 
   exit 1

From 9c56841ff2f052a7e54290b36c3f74528be3de19 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 26 Mar 2026 20:46:46 +0000
Subject: [PATCH 2/8] docs(api): clarify file_batches usage in vector stores
 files and file batches

---
 .stats.yml                                    |  4 +-
 .../filebatches/FileBatchCreateParams.kt      | 43 +++++++++++++------
 .../vectorstores/files/FileCreateParams.kt    | 20 +++++++--
 3 files changed, 49 insertions(+), 18 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index de3730f1..6fa3b40d 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 151
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-00994178cc8e20d71754b00c54b0e4f5b4128e1c1cce765e9b7d696bd8c80d33.yml
-openapi_spec_hash: 81f404053b663f987209b4fb2d08a230
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-24647ccd7356fee965aaca347476460727c6aec762e16a9eb41950d6fbccf0be.yml
+openapi_spec_hash: ef99e305f20ae8ae7b2758a205280cca
 config_hash: 5635033cdc8c930255f8b529a78de722
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/vectorstores/filebatches/FileBatchCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/vectorstores/filebatches/FileBatchCreateParams.kt
index ca03a868..275f87ef 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/vectorstores/filebatches/FileBatchCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/vectorstores/filebatches/FileBatchCreateParams.kt
@@ -61,7 +61,8 @@ private constructor(
      * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that the vector
      * store should use. Useful for tools like `file_search` that can access files. If `attributes`
      * or `chunking_strategy` are provided, they will be applied to all files in the batch. The
-     * maximum batch size is 2000 files. Mutually exclusive with `files`.
+     * maximum batch size is 2000 files. This endpoint is recommended for multi-file ingestion and
+     * helps reduce per-vector-store write request pressure. Mutually exclusive with `files`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -72,7 +73,9 @@ private constructor(
      * A list of objects that each include a `file_id` plus optional `attributes` or
      * `chunking_strategy`. Use this when you need to override metadata for specific files. The
      * global `attributes` or `chunking_strategy` will be ignored and must be specified for each
-     * file. The maximum batch size is 2000 files. Mutually exclusive with `file_ids`.
+     * file. The maximum batch size is 2000 files. This endpoint is recommended for multi-file
+     * ingestion and helps reduce per-vector-store write request pressure. Mutually exclusive with
+     * `file_ids`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -228,7 +231,9 @@ private constructor(
          * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that the
          * vector store should use. Useful for tools like `file_search` that can access files. If
          * `attributes` or `chunking_strategy` are provided, they will be applied to all files in
-         * the batch. The maximum batch size is 2000 files. Mutually exclusive with `files`.
+         * the batch. The maximum batch size is 2000 files. This endpoint is recommended for
+         * multi-file ingestion and helps reduce per-vector-store write request pressure. Mutually
+         * exclusive with `files`.
          */
         fun fileIds(fileIds: List<String>) = apply { body.fileIds(fileIds) }
 
@@ -252,7 +257,9 @@ private constructor(
          * A list of objects that each include a `file_id` plus optional `attributes` or
          * `chunking_strategy`. Use this when you need to override metadata for specific files. The
          * global `attributes` or `chunking_strategy` will be ignored and must be specified for each
-         * file. The maximum batch size is 2000 files. Mutually exclusive with `file_ids`.
+         * file. The maximum batch size is 2000 files. This endpoint is recommended for multi-file
+         * ingestion and helps reduce per-vector-store write request pressure. Mutually exclusive
+         * with `file_ids`.
          */
         fun files(files: List<File>) = apply { body.files(files) }
 
@@ -465,7 +472,9 @@ private constructor(
          * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that the
          * vector store should use. Useful for tools like `file_search` that can access files. If
          * `attributes` or `chunking_strategy` are provided, they will be applied to all files in
-         * the batch. The maximum batch size is 2000 files. Mutually exclusive with `files`.
+         * the batch. The maximum batch size is 2000 files. This endpoint is recommended for
+         * multi-file ingestion and helps reduce per-vector-store write request pressure. Mutually
+         * exclusive with `files`.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -476,7 +485,9 @@ private constructor(
          * A list of objects that each include a `file_id` plus optional `attributes` or
          * `chunking_strategy`. Use this when you need to override metadata for specific files. The
          * global `attributes` or `chunking_strategy` will be ignored and must be specified for each
-         * file. The maximum batch size is 2000 files. Mutually exclusive with `file_ids`.
+         * file. The maximum batch size is 2000 files. This endpoint is recommended for multi-file
+         * ingestion and helps reduce per-vector-store write request pressure. Mutually exclusive
+         * with `file_ids`.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -623,8 +634,9 @@ private constructor(
              * A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that the
              * vector store should use. Useful for tools like `file_search` that can access files.
              * If `attributes` or `chunking_strategy` are provided, they will be applied to all
-             * files in the batch. The maximum batch size is 2000 files. Mutually exclusive with
-             * `files`.
+             * files in the batch. The maximum batch size is 2000 files. This endpoint is
+             * recommended for multi-file ingestion and helps reduce per-vector-store write request
+             * pressure. Mutually exclusive with `files`.
              */
             fun fileIds(fileIds: List<String>) = fileIds(JsonField.of(fileIds))
 
@@ -655,8 +667,9 @@ private constructor(
              * A list of objects that each include a `file_id` plus optional `attributes` or
              * `chunking_strategy`. Use this when you need to override metadata for specific files.
              * The global `attributes` or `chunking_strategy` will be ignored and must be specified
-             * for each file. The maximum batch size is 2000 files. Mutually exclusive with
-             * `file_ids`.
+             * for each file. The maximum batch size is 2000 files. This endpoint is recommended for
+             * multi-file ingestion and helps reduce per-vector-store write request pressure.
+             * Mutually exclusive with `file_ids`.
              */
             fun files(files: List<File>) = files(JsonField.of(files))
 
@@ -902,7 +915,10 @@ private constructor(
 
         /**
          * A [File](https://platform.openai.com/docs/api-reference/files) ID that the vector store
-         * should use. Useful for tools like `file_search` that can access files.
+         * should use. Useful for tools like `file_search` that can access files. For multi-file
+         * ingestion, we recommend
+         * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+         * to minimize per-vector-store write requests.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -1000,7 +1016,10 @@ private constructor(
 
             /**
              * A [File](https://platform.openai.com/docs/api-reference/files) ID that the vector
-             * store should use. Useful for tools like `file_search` that can access files.
+             * store should use. Useful for tools like `file_search` that can access files. For
+             * multi-file ingestion, we recommend
+             * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+             * to minimize per-vector-store write requests.
              */
             fun fileId(fileId: String) = fileId(JsonField.of(fileId))
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/vectorstores/files/FileCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/vectorstores/files/FileCreateParams.kt
index c31d297d..e5f7cddb 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/vectorstores/files/FileCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/vectorstores/files/FileCreateParams.kt
@@ -42,7 +42,10 @@ private constructor(
 
     /**
      * A [File](https://platform.openai.com/docs/api-reference/files) ID that the vector store
-     * should use. Useful for tools like `file_search` that can access files.
+     * should use. Useful for tools like `file_search` that can access files. For multi-file
+     * ingestion, we recommend
+     * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+     * to minimize per-vector-store write requests.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -149,7 +152,10 @@ private constructor(
 
         /**
          * A [File](https://platform.openai.com/docs/api-reference/files) ID that the vector store
-         * should use. Useful for tools like `file_search` that can access files.
+         * should use. Useful for tools like `file_search` that can access files. For multi-file
+         * ingestion, we recommend
+         * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+         * to minimize per-vector-store write requests.
          */
         fun fileId(fileId: String) = apply { body.fileId(fileId) }
 
@@ -397,7 +403,10 @@ private constructor(
 
         /**
          * A [File](https://platform.openai.com/docs/api-reference/files) ID that the vector store
-         * should use. Useful for tools like `file_search` that can access files.
+         * should use. Useful for tools like `file_search` that can access files. For multi-file
+         * ingestion, we recommend
+         * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+         * to minimize per-vector-store write requests.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -495,7 +504,10 @@ private constructor(
 
             /**
              * A [File](https://platform.openai.com/docs/api-reference/files) ID that the vector
-             * store should use. Useful for tools like `file_search` that can access files.
+             * store should use. Useful for tools like `file_search` that can access files. For
+             * multi-file ingestion, we recommend
+             * [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+             * to minimize per-vector-store write requests.
              */
             fun fileId(fileId: String) = fileId(JsonField.of(fileId))
 

From 936b2ab08e8641bd1d6a1b2432140762185e22eb Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 27 Mar 2026 18:13:18 +0000
Subject: [PATCH 3/8] fix(api): remove web_search_call.results from
 ResponseIncludable

---
 .stats.yml                                     |  4 ++--
 .../realtime/RealtimeSessionCreateRequest.kt   | 12 ++++++------
 .../models/realtime/RealtimeTracingConfig.kt   |  5 +++--
 .../RealtimeSessionCreateResponse.kt           | 18 +++++++++---------
 .../models/responses/ResponseIncludable.kt     |  6 ------
 5 files changed, 20 insertions(+), 25 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 6fa3b40d..4c7a4f4a 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 151
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-24647ccd7356fee965aaca347476460727c6aec762e16a9eb41950d6fbccf0be.yml
-openapi_spec_hash: ef99e305f20ae8ae7b2758a205280cca
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-2fab88288cbbe872f5d61d1d47da2286662a123b4312bc7fc36addba6607cd67.yml
+openapi_spec_hash: a7ee80374e409ed9ecc8ea2e3cd31071
 config_hash: 5635033cdc8c930255f8b529a78de722
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeSessionCreateRequest.kt b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeSessionCreateRequest.kt
index 9bad2ba3..2557626d 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeSessionCreateRequest.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeSessionCreateRequest.kt
@@ -208,9 +208,9 @@ private constructor(
     fun tools(): Optional<List<RealtimeToolsConfigUnion>> = tools.getOptional("tools")
 
     /**
-     * Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces). Set to
-     * null to disable tracing. Once tracing is enabled for a session, the configuration cannot be
-     * modified.
+     * Realtime API can write session traces to the
+     * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to disable
+     * tracing. Once tracing is enabled for a session, the configuration cannot be modified.
      *
      * `auto` will create a trace for the session with default values for the workflow name, group
      * id, and metadata.
@@ -647,9 +647,9 @@ private constructor(
             addTool(RealtimeToolsConfigUnion.Mcp.builder().serverLabel(serverLabel).build())
 
         /**
-         * Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces). Set to
-         * null to disable tracing. Once tracing is enabled for a session, the configuration cannot
-         * be modified.
+         * Realtime API can write session traces to the
+         * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to disable
+         * tracing. Once tracing is enabled for a session, the configuration cannot be modified.
          *
          * `auto` will create a trace for the session with default values for the workflow name,
          * group id, and metadata.
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeTracingConfig.kt b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeTracingConfig.kt
index 1e8eeec3..50e2423d 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeTracingConfig.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeTracingConfig.kt
@@ -27,8 +27,9 @@ import java.util.Objects
 import java.util.Optional
 
 /**
- * Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces). Set to null to
- * disable tracing. Once tracing is enabled for a session, the configuration cannot be modified.
+ * Realtime API can write session traces to the
+ * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to disable tracing.
+ * Once tracing is enabled for a session, the configuration cannot be modified.
  *
  * `auto` will create a trace for the session with default values for the workflow name, group id,
  * and metadata.
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/realtime/clientsecrets/RealtimeSessionCreateResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/realtime/clientsecrets/RealtimeSessionCreateResponse.kt
index 438da705..f35310cf 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/realtime/clientsecrets/RealtimeSessionCreateResponse.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/realtime/clientsecrets/RealtimeSessionCreateResponse.kt
@@ -224,9 +224,9 @@ private constructor(
     fun tools(): Optional<List<Tool>> = tools.getOptional("tools")
 
     /**
-     * Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces). Set to
-     * null to disable tracing. Once tracing is enabled for a session, the configuration cannot be
-     * modified.
+     * Realtime API can write session traces to the
+     * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to disable
+     * tracing. Once tracing is enabled for a session, the configuration cannot be modified.
      *
      * `auto` will create a trace for the session with default values for the workflow name, group
      * id, and metadata.
@@ -664,9 +664,9 @@ private constructor(
         fun addTool(mcp: Tool.McpTool) = addTool(Tool.ofMcp(mcp))
 
         /**
-         * Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces). Set to
-         * null to disable tracing. Once tracing is enabled for a session, the configuration cannot
-         * be modified.
+         * Realtime API can write session traces to the
+         * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to disable
+         * tracing. Once tracing is enabled for a session, the configuration cannot be modified.
          *
          * `auto` will create a trace for the session with default values for the workflow name,
          * group id, and metadata.
@@ -6753,9 +6753,9 @@ private constructor(
     }
 
     /**
-     * Realtime API can write session traces to the [Traces Dashboard](/logs?api=traces). Set to
-     * null to disable tracing. Once tracing is enabled for a session, the configuration cannot be
-     * modified.
+     * Realtime API can write session traces to the
+     * [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to disable
+     * tracing. Once tracing is enabled for a session, the configuration cannot be modified.
      *
      * `auto` will create a trace for the session with default values for the workflow name, group
      * id, and metadata.
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseIncludable.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseIncludable.kt
index df8ddfbc..7ef11e8c 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseIncludable.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseIncludable.kt
@@ -37,8 +37,6 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
 
         @JvmField val FILE_SEARCH_CALL_RESULTS = of("file_search_call.results")
 
-        @JvmField val WEB_SEARCH_CALL_RESULTS = of("web_search_call.results")
-
         @JvmField val WEB_SEARCH_CALL_ACTION_SOURCES = of("web_search_call.action.sources")
 
         @JvmField val MESSAGE_INPUT_IMAGE_IMAGE_URL = of("message.input_image.image_url")
@@ -58,7 +56,6 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
     /** An enum containing [ResponseIncludable]'s known values. */
     enum class Known {
         FILE_SEARCH_CALL_RESULTS,
-        WEB_SEARCH_CALL_RESULTS,
         WEB_SEARCH_CALL_ACTION_SOURCES,
         MESSAGE_INPUT_IMAGE_IMAGE_URL,
         COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL,
@@ -78,7 +75,6 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
      */
     enum class Value {
         FILE_SEARCH_CALL_RESULTS,
-        WEB_SEARCH_CALL_RESULTS,
         WEB_SEARCH_CALL_ACTION_SOURCES,
         MESSAGE_INPUT_IMAGE_IMAGE_URL,
         COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL,
@@ -102,7 +98,6 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
     fun value(): Value =
         when (this) {
             FILE_SEARCH_CALL_RESULTS -> Value.FILE_SEARCH_CALL_RESULTS
-            WEB_SEARCH_CALL_RESULTS -> Value.WEB_SEARCH_CALL_RESULTS
             WEB_SEARCH_CALL_ACTION_SOURCES -> Value.WEB_SEARCH_CALL_ACTION_SOURCES
             MESSAGE_INPUT_IMAGE_IMAGE_URL -> Value.MESSAGE_INPUT_IMAGE_IMAGE_URL
             COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL -> Value.COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL
@@ -123,7 +118,6 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
     fun known(): Known =
         when (this) {
             FILE_SEARCH_CALL_RESULTS -> Known.FILE_SEARCH_CALL_RESULTS
-            WEB_SEARCH_CALL_RESULTS -> Known.WEB_SEARCH_CALL_RESULTS
             WEB_SEARCH_CALL_ACTION_SOURCES -> Known.WEB_SEARCH_CALL_ACTION_SOURCES
             MESSAGE_INPUT_IMAGE_IMAGE_URL -> Known.MESSAGE_INPUT_IMAGE_IMAGE_URL
             COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL -> Known.COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL

From e562a1701cfb7c92aa308d80d7bfe8e99c6394c8 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Mon, 30 Mar 2026 22:45:02 +0000
Subject: [PATCH 4/8] feat(api): add phase field to conversations Message

---
 .stats.yml                                    |   4 +-
 .../openai/models/conversations/Message.kt    | 184 +++++++++++++++++-
 .../models/conversations/MessageTest.kt       |   3 +
 .../items/ConversationItemListTest.kt         |   3 +
 .../items/ConversationItemTest.kt             |   2 +
 5 files changed, 190 insertions(+), 6 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 4c7a4f4a..8e034ba2 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 151
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-2fab88288cbbe872f5d61d1d47da2286662a123b4312bc7fc36addba6607cd67.yml
-openapi_spec_hash: a7ee80374e409ed9ecc8ea2e3cd31071
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-89e54b8e2c185d30e869f73e7798308d56a6a835a675d54628dd86836f147879.yml
+openapi_spec_hash: 85b0dd465aa1a034f2764b0758671f21
 config_hash: 5635033cdc8c930255f8b529a78de722
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/conversations/Message.kt b/openai-java-core/src/main/kotlin/com/openai/models/conversations/Message.kt
index 37430996..bd049627 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/conversations/Message.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/conversations/Message.kt
@@ -44,6 +44,7 @@ private constructor(
     private val role: JsonField<Role>,
     private val status: JsonField<Status>,
     private val type: JsonValue,
+    private val phase: JsonField<Phase>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -56,7 +57,8 @@ private constructor(
         @JsonProperty("role") @ExcludeMissing role: JsonField<Role> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(id, content, role, status, type, mutableMapOf())
+        @JsonProperty("phase") @ExcludeMissing phase: JsonField<Phase> = JsonMissing.of(),
+    ) : this(id, content, role, status, type, phase, mutableMapOf())
 
     /**
      * The unique ID of the message.
@@ -105,6 +107,17 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer
+     * (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up
+     * requests, preserve and resend phase on all assistant messages — dropping it can degrade
+     * performance. Not used for user messages.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun phase(): Optional<Phase> = phase.getOptional("phase")
+
     /**
      * Returns the raw JSON value of [id].
      *
@@ -133,6 +146,13 @@ private constructor(
      */
     @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
+    /**
+     * Returns the raw JSON value of [phase].
+     *
+     * Unlike [phase], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("phase") @ExcludeMissing fun _phase(): JsonField<Phase> = phase
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -169,6 +189,7 @@ private constructor(
         private var role: JsonField<Role>? = null
         private var status: JsonField<Status>? = null
         private var type: JsonValue = JsonValue.from("message")
+        private var phase: JsonField<Phase> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -178,6 +199,7 @@ private constructor(
             role = message.role
             status = message.status
             type = message.type
+            phase = message.phase
             additionalProperties = message.additionalProperties.toMutableMap()
         }
 
@@ -359,6 +381,25 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /**
+         * Labels an `assistant` message as intermediate commentary (`commentary`) or the final
+         * answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending
+         * follow-up requests, preserve and resend phase on all assistant messages — dropping it can
+         * degrade performance. Not used for user messages.
+         */
+        fun phase(phase: Phase?) = phase(JsonField.ofNullable(phase))
+
+        /** Alias for calling [Builder.phase] with `phase.orElse(null)`. */
+        fun phase(phase: Optional<Phase>) = phase(phase.getOrNull())
+
+        /**
+         * Sets [Builder.phase] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.phase] with a well-typed [Phase] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun phase(phase: JsonField<Phase>) = apply { this.phase = phase }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -400,6 +441,7 @@ private constructor(
                 checkRequired("role", role),
                 checkRequired("status", status),
                 type,
+                phase,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -420,6 +462,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        phase().ifPresent { it.validate() }
         validated = true
     }
 
@@ -442,7 +485,8 @@ private constructor(
             (content.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (role.asKnown().getOrNull()?.validity() ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
-            type.let { if (it == JsonValue.from("message")) 1 else 0 }
+            type.let { if (it == JsonValue.from("message")) 1 else 0 } +
+            (phase.asKnown().getOrNull()?.validity() ?: 0)
 
     /** A content part that makes up an input or output item. */
     @JsonDeserialize(using = Content.Deserializer::class)
@@ -1379,6 +1423,137 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer
+     * (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up
+     * requests, preserve and resend phase on all assistant messages — dropping it can degrade
+     * performance. Not used for user messages.
+     */
+    class Phase @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val COMMENTARY = of("commentary")
+
+            @JvmField val FINAL_ANSWER = of("final_answer")
+
+            @JvmStatic fun of(value: String) = Phase(JsonField.of(value))
+        }
+
+        /** An enum containing [Phase]'s known values. */
+        enum class Known {
+            COMMENTARY,
+            FINAL_ANSWER,
+        }
+
+        /**
+         * An enum containing [Phase]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Phase] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            COMMENTARY,
+            FINAL_ANSWER,
+            /** An enum member indicating that [Phase] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                COMMENTARY -> Value.COMMENTARY
+                FINAL_ANSWER -> Value.FINAL_ANSWER
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                COMMENTARY -> Known.COMMENTARY
+                FINAL_ANSWER -> Known.FINAL_ANSWER
+                else -> throw OpenAIInvalidDataException("Unknown Phase: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Phase = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Phase && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1390,15 +1565,16 @@ private constructor(
             role == other.role &&
             status == other.status &&
             type == other.type &&
+            phase == other.phase &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(id, content, role, status, type, additionalProperties)
+        Objects.hash(id, content, role, status, type, phase, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "Message{id=$id, content=$content, role=$role, status=$status, type=$type, additionalProperties=$additionalProperties}"
+        "Message{id=$id, content=$content, role=$role, status=$status, type=$type, phase=$phase, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/conversations/MessageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/conversations/MessageTest.kt
index 8de929c5..db242e06 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/conversations/MessageTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/conversations/MessageTest.kt
@@ -18,6 +18,7 @@ internal class MessageTest {
                 .addInputTextContent("text")
                 .role(Message.Role.UNKNOWN)
                 .status(Message.Status.IN_PROGRESS)
+                .phase(Message.Phase.COMMENTARY)
                 .build()
 
         assertThat(message.id()).isEqualTo("id")
@@ -27,6 +28,7 @@ internal class MessageTest {
             )
         assertThat(message.role()).isEqualTo(Message.Role.UNKNOWN)
         assertThat(message.status()).isEqualTo(Message.Status.IN_PROGRESS)
+        assertThat(message.phase()).contains(Message.Phase.COMMENTARY)
     }
 
     @Test
@@ -38,6 +40,7 @@ internal class MessageTest {
                 .addInputTextContent("text")
                 .role(Message.Role.UNKNOWN)
                 .status(Message.Status.IN_PROGRESS)
+                .phase(Message.Phase.COMMENTARY)
                 .build()
 
         val roundtrippedMessage =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemListTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemListTest.kt
index 59b6bcc2..135473c9 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemListTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemListTest.kt
@@ -20,6 +20,7 @@ internal class ConversationItemListTest {
                         .addInputTextContent("text")
                         .role(Message.Role.UNKNOWN)
                         .status(Message.Status.IN_PROGRESS)
+                        .phase(Message.Phase.COMMENTARY)
                         .build()
                 )
                 .firstId("first_id")
@@ -35,6 +36,7 @@ internal class ConversationItemListTest {
                         .addInputTextContent("text")
                         .role(Message.Role.UNKNOWN)
                         .status(Message.Status.IN_PROGRESS)
+                        .phase(Message.Phase.COMMENTARY)
                         .build()
                 )
             )
@@ -54,6 +56,7 @@ internal class ConversationItemListTest {
                         .addInputTextContent("text")
                         .role(Message.Role.UNKNOWN)
                         .status(Message.Status.IN_PROGRESS)
+                        .phase(Message.Phase.COMMENTARY)
                         .build()
                 )
                 .firstId("first_id")
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemTest.kt
index 80f79485..f075ef02 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemTest.kt
@@ -45,6 +45,7 @@ internal class ConversationItemTest {
                 .addInputTextContent("text")
                 .role(Message.Role.UNKNOWN)
                 .status(Message.Status.IN_PROGRESS)
+                .phase(Message.Phase.COMMENTARY)
                 .build()
 
         val conversationItem = ConversationItem.ofMessage(message)
@@ -86,6 +87,7 @@ internal class ConversationItemTest {
                     .addInputTextContent("text")
                     .role(Message.Role.UNKNOWN)
                     .status(Message.Status.IN_PROGRESS)
+                    .phase(Message.Phase.COMMENTARY)
                     .build()
             )
 

From a3c95b073d7b10a13ce83865947ab4fbec5a95d0 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 31 Mar 2026 13:33:34 +0000
Subject: [PATCH 5/8] chore(tests): bump steady to v0.20.1

---
 scripts/mock | 6 +++---
 scripts/test | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/scripts/mock b/scripts/mock
index 4931f304..8b82c3e5 100755
--- a/scripts/mock
+++ b/scripts/mock
@@ -22,9 +22,9 @@ echo "==> Starting mock server with URL ${URL}"
 # Run steady mock on the given spec
 if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
-  npm exec --package=@stdy/cli@0.19.7 -- steady --version
+  npm exec --package=@stdy/cli@0.20.1 -- steady --version
 
-  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
+  npm exec --package=@stdy/cli@0.20.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
 
   # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
@@ -48,5 +48,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
+  npm exec --package=@stdy/cli@0.20.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
 fi
diff --git a/scripts/test b/scripts/test
index bf69114d..bcdbfe4e 100755
--- a/scripts/test
+++ b/scripts/test
@@ -43,7 +43,7 @@ elif ! steady_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.7 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.20.1 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
   echo
 
   exit 1

From 78b1d5629bf7d31173ec1cec50f3191959cdba9d Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 31 Mar 2026 19:26:01 +0000
Subject: [PATCH 6/8] chore(tests): bump steady to v0.20.2

---
 scripts/mock | 6 +++---
 scripts/test | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/scripts/mock b/scripts/mock
index 8b82c3e5..886f2ffc 100755
--- a/scripts/mock
+++ b/scripts/mock
@@ -22,9 +22,9 @@ echo "==> Starting mock server with URL ${URL}"
 # Run steady mock on the given spec
 if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
-  npm exec --package=@stdy/cli@0.20.1 -- steady --version
+  npm exec --package=@stdy/cli@0.20.2 -- steady --version
 
-  npm exec --package=@stdy/cli@0.20.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
+  npm exec --package=@stdy/cli@0.20.2 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
 
   # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
@@ -48,5 +48,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stdy/cli@0.20.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
+  npm exec --package=@stdy/cli@0.20.2 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
 fi
diff --git a/scripts/test b/scripts/test
index bcdbfe4e..30e9cdf4 100755
--- a/scripts/test
+++ b/scripts/test
@@ -43,7 +43,7 @@ elif ! steady_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.20.1 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.20.2 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=brackets --validator-form-array-format=brackets --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
   echo
 
   exit 1

From eda0a61f837af3a0aba2851a23320aadfce82979 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 4 Apr 2026 04:45:02 +0000
Subject: [PATCH 7/8] feat(api): add WEB_SEARCH_CALL_RESULTS to
 ResponseIncludable enum

---
 .stats.yml                                                  | 4 ++--
 .../com/openai/models/responses/ResponseIncludable.kt       | 6 ++++++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 8e034ba2..e2b52c7b 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 151
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-89e54b8e2c185d30e869f73e7798308d56a6a835a675d54628dd86836f147879.yml
-openapi_spec_hash: 85b0dd465aa1a034f2764b0758671f21
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-dd99495ad509338e6de862802839360dfe394d5cd6d6ba6d13fec8fca92328b8.yml
+openapi_spec_hash: 68abda9122013a9ae3f084cfdbe8e8c1
 config_hash: 5635033cdc8c930255f8b529a78de722
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseIncludable.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseIncludable.kt
index 7ef11e8c..df8ddfbc 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseIncludable.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseIncludable.kt
@@ -37,6 +37,8 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
 
         @JvmField val FILE_SEARCH_CALL_RESULTS = of("file_search_call.results")
 
+        @JvmField val WEB_SEARCH_CALL_RESULTS = of("web_search_call.results")
+
         @JvmField val WEB_SEARCH_CALL_ACTION_SOURCES = of("web_search_call.action.sources")
 
         @JvmField val MESSAGE_INPUT_IMAGE_IMAGE_URL = of("message.input_image.image_url")
@@ -56,6 +58,7 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
     /** An enum containing [ResponseIncludable]'s known values. */
     enum class Known {
         FILE_SEARCH_CALL_RESULTS,
+        WEB_SEARCH_CALL_RESULTS,
         WEB_SEARCH_CALL_ACTION_SOURCES,
         MESSAGE_INPUT_IMAGE_IMAGE_URL,
         COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL,
@@ -75,6 +78,7 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
      */
     enum class Value {
         FILE_SEARCH_CALL_RESULTS,
+        WEB_SEARCH_CALL_RESULTS,
         WEB_SEARCH_CALL_ACTION_SOURCES,
         MESSAGE_INPUT_IMAGE_IMAGE_URL,
         COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL,
@@ -98,6 +102,7 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
     fun value(): Value =
         when (this) {
             FILE_SEARCH_CALL_RESULTS -> Value.FILE_SEARCH_CALL_RESULTS
+            WEB_SEARCH_CALL_RESULTS -> Value.WEB_SEARCH_CALL_RESULTS
             WEB_SEARCH_CALL_ACTION_SOURCES -> Value.WEB_SEARCH_CALL_ACTION_SOURCES
             MESSAGE_INPUT_IMAGE_IMAGE_URL -> Value.MESSAGE_INPUT_IMAGE_IMAGE_URL
             COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL -> Value.COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL
@@ -118,6 +123,7 @@ class ResponseIncludable @JsonCreator private constructor(private val value: Jso
     fun known(): Known =
         when (this) {
             FILE_SEARCH_CALL_RESULTS -> Known.FILE_SEARCH_CALL_RESULTS
+            WEB_SEARCH_CALL_RESULTS -> Known.WEB_SEARCH_CALL_RESULTS
             WEB_SEARCH_CALL_ACTION_SOURCES -> Known.WEB_SEARCH_CALL_ACTION_SOURCES
             MESSAGE_INPUT_IMAGE_IMAGE_URL -> Known.MESSAGE_INPUT_IMAGE_IMAGE_URL
             COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL -> Known.COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL

From 69157d412d8ca8ecaaf0cacca7e29b1f27da2309 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 4 Apr 2026 05:29:10 +0000
Subject: [PATCH 8/8] release: 4.31.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 26 ++++++++++++++++++++++++++
 README.md                     | 14 +++++++-------
 build.gradle.kts              |  2 +-
 4 files changed, 35 insertions(+), 9 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index ba2c94bf..a95c8527 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "4.30.0"
+  ".": "4.31.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 55bf3a5b..999a0a80 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,31 @@
 # Changelog
 
+## 4.31.0 (2026-04-04)
+
+Full Changelog: [v4.30.0...v4.31.0](https://github.com/openai/openai-java/compare/v4.30.0...v4.31.0)
+
+### Features
+
+* **api:** add phase field to conversations Message ([e562a17](https://github.com/openai/openai-java/commit/e562a1701cfb7c92aa308d80d7bfe8e99c6394c8))
+* **api:** add WEB_SEARCH_CALL_RESULTS to ResponseIncludable enum ([eda0a61](https://github.com/openai/openai-java/commit/eda0a61f837af3a0aba2851a23320aadfce82979))
+
+
+### Bug Fixes
+
+* **api:** remove web_search_call.results from ResponseIncludable ([936b2ab](https://github.com/openai/openai-java/commit/936b2ab08e8641bd1d6a1b2432140762185e22eb))
+
+
+### Chores
+
+* **internal:** update multipart form array serialization ([240ca42](https://github.com/openai/openai-java/commit/240ca42401366b75cf70b0eb0ff9f63425c9b358))
+* **tests:** bump steady to v0.20.1 ([a3c95b0](https://github.com/openai/openai-java/commit/a3c95b073d7b10a13ce83865947ab4fbec5a95d0))
+* **tests:** bump steady to v0.20.2 ([78b1d56](https://github.com/openai/openai-java/commit/78b1d5629bf7d31173ec1cec50f3191959cdba9d))
+
+
+### Documentation
+
+* **api:** clarify file_batches usage in vector stores files and file batches ([9c56841](https://github.com/openai/openai-java/commit/9c56841ff2f052a7e54290b36c3f74528be3de19))
+
 ## 4.30.0 (2026-03-25)
 
 Full Changelog: [v4.29.1...v4.30.0](https://github.com/openai/openai-java/compare/v4.29.1...v4.30.0)
diff --git a/README.md b/README.md
index f166faed..4448599e 100644
--- a/README.md
+++ b/README.md
@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.openai/openai-java)](https://central.sonatype.com/artifact/com.openai/openai-java/4.30.0)
-[![javadoc](https://javadoc.io/badge2/com.openai/openai-java/4.30.0/javadoc.svg)](https://javadoc.io/doc/com.openai/openai-java/4.30.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.openai/openai-java)](https://central.sonatype.com/artifact/com.openai/openai-java/4.31.0)
+[![javadoc](https://javadoc.io/badge2/com.openai/openai-java/4.31.0/javadoc.svg)](https://javadoc.io/doc/com.openai/openai-java/4.31.0)
 
 <!-- x-release-please-end -->
 
@@ -11,7 +11,7 @@ The OpenAI Java SDK provides convenient access to the [OpenAI REST API](https://
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [platform.openai.com](https://platform.openai.com/docs). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.openai/openai-java/4.30.0).
+The REST API documentation can be found on [platform.openai.com](https://platform.openai.com/docs). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.openai/openai-java/4.31.0).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [platform.openai.com](https://platfor
 ### Gradle
 
 ```kotlin
-implementation("com.openai:openai-java:4.30.0")
+implementation("com.openai:openai-java:4.31.0")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.openai:openai-java:4.30.0")
 <dependency>
   <groupId>com.openai</groupId>
   <artifactId>openai-java</artifactId>
-  <version>4.30.0</version>
+  <version>4.31.0</version>
 </dependency>
 ```
 
@@ -1342,7 +1342,7 @@ If you're using Spring Boot, then you can use the SDK's [Spring Boot starter](ht
 #### Gradle
 
 ```kotlin
-implementation("com.openai:openai-java-spring-boot-starter:4.30.0")
+implementation("com.openai:openai-java-spring-boot-starter:4.31.0")
 ```
 
 #### Maven
@@ -1351,7 +1351,7 @@ implementation("com.openai:openai-java-spring-boot-starter:4.30.0")
 <dependency>
   <groupId>com.openai</groupId>
   <artifactId>openai-java-spring-boot-starter</artifactId>
-  <version>4.30.0</version>
+  <version>4.31.0</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index 4ade3a79..9f350c47 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.openai"
-    version = "4.30.0" // x-release-please-version
+    version = "4.31.0" // x-release-please-version
 }
 
 subprojects {