openai 0.37.0 → 0.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 136d7cc343b404ef69a7d7d32adcc6942d66b3e87385ed6ad02d91cf6014dad6
-  data.tar.gz: b7192ae587a9921a96e547b52c64dbd312b8b8d66ee6b6de9f572b18a0809625
+  metadata.gz: 6fe08f20637a8f850964152557cf797e6c078ea740bd5c5e4d5e88ef0ed5c0b9
+  data.tar.gz: b372a97f47fe9ae0c1c41fdffbd0d5a7f9b42e46fb3d7a976e5c5f3c11970cba
 SHA512:
-  metadata.gz: 900ac61caada3d3a9e099ecd37807f331eaa2785b05183bad4b512deb5d2698b4926142cc5d63bcbb870f21bf5659a70601e4389309dbbcbe92e06d8513b3f96
-  data.tar.gz: 148cff14a45e1e1473e946221cad39b44c0c4162d993ee5333367cf64b850f2beafc11016596cc274e1ece7a2526ba5aed1d446a06451294a71c18b69eb280c8
+  metadata.gz: 5db010ad9ae69bc8bcc36538de8ef659e2e62438b80b08a7ee85ca952c6df79e67ac3f0d640846b31bac4ce55f41fcc45942062d23cf2ccc0f7e50b5ff2c28fb
+  data.tar.gz: 2f5c2ae60e053513757f7237af9e3559a09396e648549322e0ac35eda38811e95810992fb5ccf0fae1354c85f595dcebc6621d9d4a46e2e4ae54fdde1a4af82d

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.39.0 (2025-12-11)
+
+Full Changelog: [v0.38.0...v0.39.0](https://github.com/openai/openai-ruby/compare/v0.38.0...v0.39.0)
+
+### Features
+
+* **api:** gpt 5.2 ([369f26b](https://github.com/openai/openai-ruby/commit/369f26b5e42ddef31d07278e43776415f5d49b62))
+
+
+### Bug Fixes
+
+* Create new responses with previous_response_id ([#869](https://github.com/openai/openai-ruby/issues/869)) ([b14e2aa](https://github.com/openai/openai-ruby/commit/b14e2aa2351d102c4af30809ebb4a5cca61a1165))
+
+## 0.38.0 (2025-12-08)
+
+Full Changelog: [v0.37.0...v0.38.0](https://github.com/openai/openai-ruby/compare/v0.37.0...v0.38.0)
+
+### Features
+
+* **api:** make model required for the responses/compact endpoint ([94ad657](https://github.com/openai/openai-ruby/commit/94ad657d3824838dbb1517bb6aa43341a0581102))
+
 ## 0.37.0 (2025-12-04)
 
 Full Changelog: [v0.36.1...v0.37.0](https://github.com/openai/openai-ruby/compare/v0.36.1...v0.37.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.37.0"
+gem "openai", "~> 0.39.0"
 ```
 
 <!-- x-release-please-end -->
@@ -32,7 +32,7 @@ openai = OpenAI::Client.new(
 
 chat_completion = openai.chat.completions.create(
   messages: [{role: "user", content: "Say this is a test"}],
-  model: :"gpt-5.1"
+  model: :"gpt-5.2"
 )
 
 puts(chat_completion)
@@ -45,7 +45,7 @@ We provide support for streaming responses using Server-Sent Events (SSE).
 ```ruby
 stream = openai.responses.stream(
   input: "Write a haiku about OpenAI.",
-  model: :"gpt-5.1"
+  model: :"gpt-5.2"
 )
 
 stream.each do |event|
@@ -343,7 +343,7 @@ openai = OpenAI::Client.new(
 # Or, configure per-request:
 openai.chat.completions.create(
   messages: [{role: "user", content: "How can I get the name of the current day in JavaScript?"}],
-  model: :"gpt-5.1",
+  model: :"gpt-5.2",
   request_options: {max_retries: 5}
 )
 ```
@@ -361,7 +361,7 @@ openai = OpenAI::Client.new(
 # Or, configure per-request:
 openai.chat.completions.create(
   messages: [{role: "user", content: "How can I list all files in a directory using Python?"}],
-  model: :"gpt-5.1",
+  model: :"gpt-5.2",
   request_options: {timeout: 5}
 )
 ```
@@ -396,7 +396,7 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 chat_completion =
   openai.chat.completions.create(
     messages: [{role: "user", content: "How can I get the name of the current day in JavaScript?"}],
-    model: :"gpt-5.1",
+    model: :"gpt-5.2",
     request_options: {
       extra_query: {my_query_parameter: value},
       extra_body: {my_body_parameter: value},
@@ -444,7 +444,7 @@ You can provide typesafe request parameters like so:
 ```ruby
 openai.chat.completions.create(
   messages: [OpenAI::Chat::ChatCompletionUserMessageParam.new(content: "Say this is a test")],
-  model: :"gpt-5.1"
+  model: :"gpt-5.2"
 )
 ```
 
@@ -454,13 +454,13 @@ Or, equivalently:
 # Hashes work, but are not typesafe:
 openai.chat.completions.create(
   messages: [{role: "user", content: "Say this is a test"}],
-  model: :"gpt-5.1"
+  model: :"gpt-5.2"
 )
 
 # You can also splat a full Params class:
 params = OpenAI::Chat::CompletionCreateParams.new(
   messages: [OpenAI::Chat::ChatCompletionUserMessageParam.new(content: "Say this is a test")],
-  model: :"gpt-5.1"
+  model: :"gpt-5.2"
 )
 openai.chat.completions.create(**params)
 ```

data/lib/openai/internal/type/enum.rb

@@ -19,11 +19,11 @@ module OpenAI
       # @example
       #   # `chat_model` is a `OpenAI::ChatModel`
       #   case chat_model
-      #   when OpenAI::ChatModel::GPT_5_1
+      #   when OpenAI::ChatModel::GPT_5_2
       #     # ...
-      #   when OpenAI::ChatModel::GPT_5_1_2025_11_13
+      #   when OpenAI::ChatModel::GPT_5_2_2025_12_11
       #     # ...
-      #   when OpenAI::ChatModel::GPT_5_1_CODEX
+      #   when OpenAI::ChatModel::GPT_5_2_CHAT_LATEST
       #     # ...
       #   else
       #     puts(chat_model)
@@ -31,11 +31,11 @@ module OpenAI
       #
       # @example
       #   case chat_model
-      #   in :"gpt-5.1"
+      #   in :"gpt-5.2"
       #     # ...
-      #   in :"gpt-5.1-2025-11-13"
+      #   in :"gpt-5.2-2025-12-11"
       #     # ...
-      #   in :"gpt-5.1-codex"
+      #   in :"gpt-5.2-chat-latest"
       #     # ...
       #   else
       #     puts(chat_model)

data/lib/openai/models/beta/assistant_create_params.rb

@@ -61,7 +61,7 @@ module OpenAI
         #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
         #     support `none`.
         #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-        #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+        #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
         #
         #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
         optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/beta/assistant_update_params.rb

@@ -61,7 +61,7 @@ module OpenAI
         #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
         #     support `none`.
         #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-        #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+        #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
         #
         #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
         optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/beta/threads/run_create_params.rb

@@ -119,7 +119,7 @@ module OpenAI
           #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
           #     support `none`.
           #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-          #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+          #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
           #
           #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
           optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/chat/completion_create_params.rb

@@ -214,7 +214,7 @@ module OpenAI
         #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
         #     support `none`.
         #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-        #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+        #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
         #
         #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
         optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/chat_model.rb

@@ -5,6 +5,11 @@ module OpenAI
     module ChatModel
       extend OpenAI::Internal::Type::Enum
 
+      GPT_5_2 = :"gpt-5.2"
+      GPT_5_2_2025_12_11 = :"gpt-5.2-2025-12-11"
+      GPT_5_2_CHAT_LATEST = :"gpt-5.2-chat-latest"
+      GPT_5_2_PRO = :"gpt-5.2-pro"
+      GPT_5_2_PRO_2025_12_11 = :"gpt-5.2-pro-2025-12-11"
       GPT_5_1 = :"gpt-5.1"
       GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
       GPT_5_1_CODEX = :"gpt-5.1-codex"

data/lib/openai/models/evals/create_eval_completions_run_data_source.rb

@@ -472,7 +472,7 @@ module OpenAI
           #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
           #     support `none`.
           #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-          #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+          #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
           #
           #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
           optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/evals/run_cancel_response.rb

@@ -326,7 +326,7 @@ module OpenAI
                 #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 #     support `none`.
                 #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+                #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -675,7 +675,7 @@ module OpenAI
               #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
               #     support `none`.
               #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
               #
               #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
               optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/evals/run_create_params.rb

@@ -238,7 +238,7 @@ module OpenAI
                 #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 #     support `none`.
                 #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+                #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -603,7 +603,7 @@ module OpenAI
               #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
               #     support `none`.
               #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
               #
               #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
               optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/evals/run_create_response.rb

@@ -326,7 +326,7 @@ module OpenAI
                 #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 #     support `none`.
                 #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+                #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -675,7 +675,7 @@ module OpenAI
               #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
               #     support `none`.
               #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
               #
               #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
               optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/evals/run_list_response.rb

@@ -326,7 +326,7 @@ module OpenAI
                 #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 #     support `none`.
                 #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+                #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -675,7 +675,7 @@ module OpenAI
               #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
               #     support `none`.
               #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
               #
               #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
               optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/evals/run_retrieve_response.rb

@@ -326,7 +326,7 @@ module OpenAI
                 #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
                 #     support `none`.
                 #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+                #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
                 #
                 #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
                 optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -679,7 +679,7 @@ module OpenAI
               #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
               #     support `none`.
               #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-              #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+              #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
               #
               #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
               optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/graders/score_model_grader.rb

@@ -5,7 +5,8 @@ module OpenAI
     module Graders
       class ScoreModelGrader < OpenAI::Internal::Type::BaseModel
         # @!attribute input
-        #   The input text. This may include template strings.
+        #   The input messages evaluated by the grader. Supports text, output text, input
+        #   image, and input audio content blocks, and may include template strings.
         #
         #   @return [Array<OpenAI::Models::Graders::ScoreModelGrader::Input>]
         required :input, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Graders::ScoreModelGrader::Input] }
@@ -41,9 +42,12 @@ module OpenAI
         optional :sampling_params, -> { OpenAI::Graders::ScoreModelGrader::SamplingParams }
 
         # @!method initialize(input:, model:, name:, range: nil, sampling_params: nil, type: :score_model)
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Graders::ScoreModelGrader} for more details.
+        #
         #   A ScoreModelGrader object that uses a model to assign a score to the input.
         #
-        #   @param input [Array<OpenAI::Models::Graders::ScoreModelGrader::Input>] The input text. This may include template strings.
+        #   @param input [Array<OpenAI::Models::Graders::ScoreModelGrader::Input>] The input messages evaluated by the grader. Supports text, output text, input im
         #
         #   @param model [String] The model to use for the evaluation.
         #
@@ -232,7 +236,7 @@ module OpenAI
           #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
           #     support `none`.
           #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-          #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+          #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
           #
           #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
           optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true

data/lib/openai/models/reasoning.rb

@@ -16,7 +16,7 @@ module OpenAI
       #   - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
       #     support `none`.
       #   - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-      #   - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+      #   - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
       #
       #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
       optional :effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
@@ -38,7 +38,8 @@ module OpenAI
       #   debugging and understanding the model's reasoning process. One of `auto`,
       #   `concise`, or `detailed`.
       #
-      #   `concise` is only supported for `computer-use-preview` models.
+      #   `concise` is supported for `computer-use-preview` models and all reasoning
+      #   models after `gpt-5`.
       #
       #   @return [Symbol, OpenAI::Models::Reasoning::Summary, nil]
       optional :summary, enum: -> { OpenAI::Reasoning::Summary }, nil?: true
@@ -82,7 +83,8 @@ module OpenAI
       # debugging and understanding the model's reasoning process. One of `auto`,
       # `concise`, or `detailed`.
       #
-      # `concise` is only supported for `computer-use-preview` models.
+      # `concise` is supported for `computer-use-preview` models and all reasoning
+      # models after `gpt-5`.
       #
       # @see OpenAI::Models::Reasoning#summary
       module Summary

data/lib/openai/models/reasoning_effort.rb

@@ -14,7 +14,7 @@ module OpenAI
     # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
     #   support `none`.
     # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-    # - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+    # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
     module ReasoningEffort
       extend OpenAI::Internal::Type::Enum
 

data/lib/openai/models/responses/response_compact_params.rb

@@ -8,6 +8,16 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute model
+        #   Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a
+        #   wide range of models with different capabilities, performance characteristics,
+        #   and price points. Refer to the
+        #   [model guide](https://platform.openai.com/docs/models) to browse and compare
+        #   available models.
+        #
+        #   @return [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil]
+        required :model, union: -> { OpenAI::Responses::ResponseCompactParams::Model }, nil?: true
+
         # @!attribute input
         #   Text, image, or file inputs to the model, used to generate a response
         #
@@ -23,16 +33,6 @@ module OpenAI
         #   @return [String, nil]
         optional :instructions, String, nil?: true
 
-        # @!attribute model
-        #   Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a
-        #   wide range of models with different capabilities, performance characteristics,
-        #   and price points. Refer to the
-        #   [model guide](https://platform.openai.com/docs/models) to browse and compare
-        #   available models.
-        #
-        #   @return [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil]
-        optional :model, union: -> { OpenAI::Responses::ResponseCompactParams::Model }, nil?: true
-
         # @!attribute previous_response_id
         #   The unique ID of the previous response to the model. Use this to create
         #   multi-turn conversations. Learn more about
@@ -42,37 +42,20 @@ module OpenAI
         #   @return [String, nil]
         optional :previous_response_id, String, nil?: true
 
-        # @!method initialize(input: nil, instructions: nil, model: nil, previous_response_id: nil, request_options: {})
+        # @!method initialize(model:, input: nil, instructions: nil, previous_response_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::ResponseCompactParams} for more details.
         #
+        #   @param model [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil] Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wi
+        #
         #   @param input [String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>, nil] Text, image, or file inputs to the model, used to generate a response
         #
         #   @param instructions [String, nil] A system (or developer) message inserted into the model's context.
         #
-        #   @param model [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil] Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wi
-        #
         #   @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-tu
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-        # Text, image, or file inputs to the model, used to generate a response
-        module Input
-          extend OpenAI::Internal::Type::Union
-
-          # A text input to the model, equivalent to a text input with the `user` role.
-          variant String
-
-          variant -> { OpenAI::Models::Responses::ResponseCompactParams::Input::ResponseInputItemArray }
-
-          # @!method self.variants
-          #   @return [Array(String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>)]
-
-          # @type [OpenAI::Internal::Type::Converter]
-          ResponseInputItemArray =
-            OpenAI::Internal::Type::ArrayOf[union: -> { OpenAI::Responses::ResponseInputItem }]
-        end
-
         # Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a
         # wide range of models with different capabilities, performance characteristics,
         # and price points. Refer to the
@@ -81,6 +64,16 @@ module OpenAI
         module Model
           extend OpenAI::Internal::Type::Union
 
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_2 }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_2_2025_12_11 }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_2_CHAT_LATEST }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_2_PRO }
+
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_2_PRO_2025_12_11 }
+
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1 }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_5_1_2025_11_13 }
@@ -254,6 +247,11 @@ module OpenAI
 
           # @!group
 
+          GPT_5_2 = :"gpt-5.2"
+          GPT_5_2_2025_12_11 = :"gpt-5.2-2025-12-11"
+          GPT_5_2_CHAT_LATEST = :"gpt-5.2-chat-latest"
+          GPT_5_2_PRO = :"gpt-5.2-pro"
+          GPT_5_2_PRO_2025_12_11 = :"gpt-5.2-pro-2025-12-11"
           GPT_5_1 = :"gpt-5.1"
           GPT_5_1_2025_11_13 = :"gpt-5.1-2025-11-13"
           GPT_5_1_CODEX = :"gpt-5.1-codex"
@@ -338,6 +336,23 @@ module OpenAI
 
           # @!endgroup
         end
+
+        # Text, image, or file inputs to the model, used to generate a response
+        module Input
+          extend OpenAI::Internal::Type::Union
+
+          # A text input to the model, equivalent to a text input with the `user` role.
+          variant String
+
+          variant -> { OpenAI::Models::Responses::ResponseCompactParams::Input::ResponseInputItemArray }
+
+          # @!method self.variants
+          #   @return [Array(String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>)]
+
+          # @type [OpenAI::Internal::Type::Converter]
+          ResponseInputItemArray =
+            OpenAI::Internal::Type::ArrayOf[union: -> { OpenAI::Responses::ResponseInputItem }]
+        end
       end
     end
   end

data/lib/openai/resources/responses.rb

@@ -186,10 +186,10 @@ module OpenAI
       # @see OpenAI::Models::Responses::ResponseCreateParams
       def stream(params)
         parsed, options = OpenAI::Responses::ResponseCreateParams.dump_request(params)
-        starting_after, previous_response_id = parsed.values_at(:starting_after, :previous_response_id)
+        starting_after, response_id = parsed.values_at(:starting_after, :response_id)
 
-        if starting_after && !previous_response_id
-          raise ArgumentError, "starting_after can only be used with previous_response_id"
+        if starting_after && !response_id
+          raise ArgumentError, "starting_after can only be used with response_id"
         end
         model, tool_models = get_structured_output_models(parsed)
 
@@ -200,11 +200,11 @@ module OpenAI
           raw
         end
 
-        if previous_response_id
+        if response_id
           retrieve_params = params.slice(:include, :request_options)
 
           raw_stream = retrieve_streaming_internal(
-            previous_response_id,
+            response_id,
             params: retrieve_params,
             unwrap: unwrap
           )
@@ -464,14 +464,14 @@ module OpenAI
       #
       # Compact conversation
       #
-      # @overload compact(input: nil, instructions: nil, model: nil, previous_response_id: nil, request_options: {})
+      # @overload compact(model:, input: nil, instructions: nil, previous_response_id: nil, request_options: {})
+      #
+      # @param model [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil] Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wi
       #
       # @param input [String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>, nil] Text, image, or file inputs to the model, used to generate a response
       #
       # @param instructions [String, nil] A system (or developer) message inserted into the model's context.
       #
-      # @param model [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil] Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wi
-      #
       # @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-tu
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -479,7 +479,7 @@ module OpenAI
       # @return [OpenAI::Models::Responses::CompactedResponse]
       #
       # @see OpenAI::Models::Responses::ResponseCompactParams
-      def compact(params = {})
+      def compact(params)
         parsed, options = OpenAI::Responses::ResponseCompactParams.dump_request(params)
         @client.request(
           method: :post,

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.37.0"
+  VERSION = "0.39.0"
 end

data/rbi/openai/models/beta/assistant_create_params.rbi

@@ -57,7 +57,7 @@ module OpenAI
         # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
         #   support `none`.
         # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-        # - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+        # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
         sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
         attr_accessor :reasoning_effort
 
@@ -227,7 +227,7 @@ module OpenAI
           # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
           #   support `none`.
           # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-          # - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+          # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
           reasoning_effort: nil,
           # Specifies the format that the model must output. Compatible with
           # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),

data/rbi/openai/models/beta/assistant_update_params.rbi

@@ -77,7 +77,7 @@ module OpenAI
         # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
         #   support `none`.
         # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-        # - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+        # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
         sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
         attr_accessor :reasoning_effort
 
@@ -251,7 +251,7 @@ module OpenAI
           # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
           #   support `none`.
           # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-          # - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+          # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
           reasoning_effort: nil,
           # Specifies the format that the model must output. Compatible with
           # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),

data/rbi/openai/models/beta/threads/run_create_params.rbi

@@ -123,7 +123,7 @@ module OpenAI
           # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
           #   support `none`.
           # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-          # - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+          # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
           sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
           attr_accessor :reasoning_effort
 
@@ -349,7 +349,7 @@ module OpenAI
             # - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
             #   support `none`.
             # - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-            # - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+            # - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
             reasoning_effort: nil,
             # Specifies the format that the model must output. Compatible with
             # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),