openai 0.36.0 → 0.37.0

data/rbi/openai/models/responses/response_function_shell_call_output_content.rbi

@@ -12,7 +12,7 @@ module OpenAI
             )
           end
 
-        # The exit or timeout outcome associated with this chunk.
+        # The exit or timeout outcome associated with this shell call.
         sig do
           returns(
             T.any(
@@ -23,15 +23,15 @@ module OpenAI
         end
         attr_accessor :outcome
 
-        # Captured stderr output for this chunk of the shell call.
+        # Captured stderr output for the shell call.
         sig { returns(String) }
         attr_accessor :stderr
 
-        # Captured stdout output for this chunk of the shell call.
+        # Captured stdout output for the shell call.
         sig { returns(String) }
         attr_accessor :stdout
 
-        # Captured stdout and stderr for a portion of a function shell tool call output.
+        # Captured stdout and stderr for a portion of a shell tool call output.
         sig do
           params(
             outcome:
@@ -44,11 +44,11 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The exit or timeout outcome associated with this chunk.
+          # The exit or timeout outcome associated with this shell call.
           outcome:,
-          # Captured stderr output for this chunk of the shell call.
+          # Captured stderr output for the shell call.
           stderr:,
-          # Captured stdout output for this chunk of the shell call.
+          # Captured stdout output for the shell call.
           stdout:
         )
         end
@@ -69,7 +69,7 @@ module OpenAI
         def to_hash
         end
 
-        # The exit or timeout outcome associated with this chunk.
+        # The exit or timeout outcome associated with this shell call.
         module Outcome
           extend OpenAI::Internal::Type::Union
 
@@ -94,7 +94,7 @@ module OpenAI
             sig { returns(Symbol) }
             attr_accessor :type
 
-            # Indicates that the function shell call exceeded its configured time limit.
+            # Indicates that the shell call exceeded its configured time limit.
             sig { params(type: Symbol).returns(T.attached_class) }
             def self.new(
               # The outcome type. Always `timeout`.

data/rbi/openai/models/responses/response_function_shell_tool_call.rbi

@@ -12,8 +12,8 @@ module OpenAI
             )
           end
 
-        # The unique ID of the function shell tool call. Populated when this item is
-        # returned via API.
+        # The unique ID of the shell tool call. Populated when this item is returned via
+        # API.
         sig { returns(String) }
         attr_accessor :id
 
@@ -31,7 +31,7 @@ module OpenAI
         end
         attr_writer :action
 
-        # The unique ID of the function shell tool call generated by the model.
+        # The unique ID of the shell tool call generated by the model.
         sig { returns(String) }
         attr_accessor :call_id
 
@@ -69,12 +69,12 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The unique ID of the function shell tool call. Populated when this item is
-          # returned via API.
+          # The unique ID of the shell tool call. Populated when this item is returned via
+          # API.
           id:,
           # The shell commands and limits that describe how to run the tool call.
           action:,
-          # The unique ID of the function shell tool call generated by the model.
+          # The unique ID of the shell tool call generated by the model.
           call_id:,
           # The status of the shell call. One of `in_progress`, `completed`, or
           # `incomplete`.

data/rbi/openai/models/responses/response_function_shell_tool_call_output.rbi

@@ -188,7 +188,7 @@ module OpenAI
               sig { returns(Symbol) }
               attr_accessor :type
 
-              # Indicates that the function shell call exceeded its configured time limit.
+              # Indicates that the shell call exceeded its configured time limit.
               sig { params(type: Symbol).returns(T.attached_class) }
               def self.new(
                 # The outcome type. Always `timeout`.

data/rbi/openai/models/responses/response_input_item.rbi

@@ -24,6 +24,7 @@ module OpenAI
               OpenAI::Responses::ResponseFunctionToolCall,
               OpenAI::Responses::ResponseInputItem::FunctionCallOutput,
               OpenAI::Responses::ResponseReasoningItem,
+              OpenAI::Responses::ResponseCompactionItemParam,
               OpenAI::Responses::ResponseInputItem::ImageGenerationCall,
               OpenAI::Responses::ResponseCodeInterpreterToolCall,
               OpenAI::Responses::ResponseInputItem::LocalShellCall,
@@ -1102,16 +1103,16 @@ module OpenAI
           end
           attr_writer :action
 
-          # The unique ID of the function shell tool call generated by the model.
+          # The unique ID of the shell tool call generated by the model.
           sig { returns(String) }
           attr_accessor :call_id
 
-          # The type of the item. Always `function_shell_call`.
+          # The type of the item. Always `shell_call`.
           sig { returns(Symbol) }
           attr_accessor :type
 
-          # The unique ID of the function shell tool call. Populated when this item is
-          # returned via API.
+          # The unique ID of the shell tool call. Populated when this item is returned via
+          # API.
           sig { returns(T.nilable(String)) }
           attr_accessor :id
 
@@ -1143,15 +1144,15 @@ module OpenAI
           def self.new(
             # The shell commands and limits that describe how to run the tool call.
             action:,
-            # The unique ID of the function shell tool call generated by the model.
+            # The unique ID of the shell tool call generated by the model.
             call_id:,
-            # The unique ID of the function shell tool call. Populated when this item is
-            # returned via API.
+            # The unique ID of the shell tool call. Populated when this item is returned via
+            # API.
             id: nil,
             # The status of the shell call. One of `in_progress`, `completed`, or
             # `incomplete`.
             status: nil,
-            # The type of the item. Always `function_shell_call`.
+            # The type of the item. Always `shell_call`.
             type: :shell_call
           )
           end
@@ -1278,7 +1279,7 @@ module OpenAI
               )
             end
 
-          # The unique ID of the function shell tool call generated by the model.
+          # The unique ID of the shell tool call generated by the model.
           sig { returns(String) }
           attr_accessor :call_id
 
@@ -1293,12 +1294,12 @@ module OpenAI
           end
           attr_accessor :output
 
-          # The type of the item. Always `function_shell_call_output`.
+          # The type of the item. Always `shell_call_output`.
           sig { returns(Symbol) }
           attr_accessor :type
 
-          # The unique ID of the function shell tool call output. Populated when this item
-          # is returned via API.
+          # The unique ID of the shell tool call output. Populated when this item is
+          # returned via API.
           sig { returns(T.nilable(String)) }
           attr_accessor :id
 
@@ -1307,7 +1308,7 @@ module OpenAI
           sig { returns(T.nilable(Integer)) }
           attr_accessor :max_output_length
 
-          # The streamed output items emitted by a function shell tool call.
+          # The streamed output items emitted by a shell tool call.
           sig do
             params(
               call_id: String,
@@ -1321,18 +1322,18 @@ module OpenAI
             ).returns(T.attached_class)
           end
           def self.new(
-            # The unique ID of the function shell tool call generated by the model.
+            # The unique ID of the shell tool call generated by the model.
             call_id:,
             # Captured chunks of stdout and stderr output, along with their associated
             # outcomes.
             output:,
-            # The unique ID of the function shell tool call output. Populated when this item
-            # is returned via API.
+            # The unique ID of the shell tool call output. Populated when this item is
+            # returned via API.
             id: nil,
             # The maximum number of UTF-8 characters captured for this shell call's combined
             # output.
             max_output_length: nil,
-            # The type of the item. Always `function_shell_call_output`.
+            # The type of the item. Always `shell_call_output`.
             type: :shell_call_output
           )
           end
@@ -1667,10 +1668,7 @@ module OpenAI
           # Optional human-readable log text from the apply patch tool (e.g., patch results
           # or errors).
           sig { returns(T.nilable(String)) }
-          attr_reader :output
-
-          sig { params(output: String).void }
-          attr_writer :output
+          attr_accessor :output
 
           # The streamed output emitted by an apply patch tool call.
           sig do
@@ -1679,7 +1677,7 @@ module OpenAI
               status:
                 OpenAI::Responses::ResponseInputItem::ApplyPatchCallOutput::Status::OrSymbol,
               id: T.nilable(String),
-              output: String,
+              output: T.nilable(String),
               type: Symbol
             ).returns(T.attached_class)
           end
@@ -1707,7 +1705,7 @@ module OpenAI
                   OpenAI::Responses::ResponseInputItem::ApplyPatchCallOutput::Status::OrSymbol,
                 type: Symbol,
                 id: T.nilable(String),
-                output: String
+                output: T.nilable(String)
               }
             )
           end

data/rbi/openai/models/responses/response_output_item.rbi

@@ -16,6 +16,7 @@ module OpenAI
               OpenAI::Responses::ResponseFunctionWebSearch,
               OpenAI::Responses::ResponseComputerToolCall,
               OpenAI::Responses::ResponseReasoningItem,
+              OpenAI::Responses::ResponseCompactionItem,
               OpenAI::Responses::ResponseOutputItem::ImageGenerationCall,
               OpenAI::Responses::ResponseCodeInterpreterToolCall,
               OpenAI::Responses::ResponseOutputItem::LocalShellCall,

data/rbi/openai/models/responses/response_output_item_added_event.rbi

@@ -39,6 +39,7 @@ module OpenAI
                 OpenAI::Responses::ResponseFunctionWebSearch::OrHash,
                 OpenAI::Responses::ResponseComputerToolCall::OrHash,
                 OpenAI::Responses::ResponseReasoningItem::OrHash,
+                OpenAI::Responses::ResponseCompactionItem::OrHash,
                 OpenAI::Responses::ResponseOutputItem::ImageGenerationCall::OrHash,
                 OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,
                 OpenAI::Responses::ResponseOutputItem::LocalShellCall::OrHash,

data/rbi/openai/models/responses/response_output_item_done_event.rbi

@@ -39,6 +39,7 @@ module OpenAI
                 OpenAI::Responses::ResponseFunctionWebSearch::OrHash,
                 OpenAI::Responses::ResponseComputerToolCall::OrHash,
                 OpenAI::Responses::ResponseReasoningItem::OrHash,
+                OpenAI::Responses::ResponseCompactionItem::OrHash,
                 OpenAI::Responses::ResponseOutputItem::ImageGenerationCall::OrHash,
                 OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,
                 OpenAI::Responses::ResponseOutputItem::LocalShellCall::OrHash,

data/rbi/openai/models/responses/tool.rbi

@@ -632,7 +632,8 @@ module OpenAI
             end
 
           # The code interpreter container. Can be a container ID or an object that
-          # specifies uploaded file IDs to make available to your code.
+          # specifies uploaded file IDs to make available to your code, along with an
+          # optional `memory_limit` setting.
           sig do
             returns(
               T.any(
@@ -660,7 +661,8 @@ module OpenAI
           end
           def self.new(
             # The code interpreter container. Can be a container ID or an object that
-            # specifies uploaded file IDs to make available to your code.
+            # specifies uploaded file IDs to make available to your code, along with an
+            # optional `memory_limit` setting.
             container:,
             # The type of the code interpreter tool. Always `code_interpreter`.
             type: :code_interpreter
@@ -683,7 +685,8 @@ module OpenAI
           end
 
           # The code interpreter container. Can be a container ID or an object that
-          # specifies uploaded file IDs to make available to your code.
+          # specifies uploaded file IDs to make available to your code, along with an
+          # optional `memory_limit` setting.
           module Container
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/responses/tool_choice_shell.rbi

@@ -13,7 +13,7 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # Forces the model to call the function shell tool when a tool call is required.
+        # Forces the model to call the shell tool when a tool call is required.
         sig { params(type: Symbol).returns(T.attached_class) }
         def self.new(
           # The tool to call. Always `shell`.

data/rbi/openai/models/responses_model.rbi

@@ -88,6 +88,11 @@ module OpenAI
             :"gpt-5-pro-2025-10-06",
             OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
           )
+        GPT_5_1_CODEX_MAX =
+          T.let(
+            :"gpt-5.1-codex-max",
+            OpenAI::ResponsesModel::ResponsesOnlyModel::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/openai/models/video_create_params.rbi

@@ -22,21 +22,23 @@ module OpenAI
       sig { params(input_reference: OpenAI::Internal::FileInput).void }
       attr_writer :input_reference
 
-      # The video generation model to use. Defaults to `sora-2`.
+      # The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+      # to `sora-2`.
       sig { returns(T.nilable(OpenAI::VideoModel::OrSymbol)) }
       attr_reader :model
 
       sig { params(model: OpenAI::VideoModel::OrSymbol).void }
       attr_writer :model
 
-      # Clip duration in seconds. Defaults to 4 seconds.
+      # Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
       sig { returns(T.nilable(OpenAI::VideoSeconds::OrSymbol)) }
       attr_reader :seconds
 
       sig { params(seconds: OpenAI::VideoSeconds::OrSymbol).void }
       attr_writer :seconds
 
-      # Output resolution formatted as width x height. Defaults to 720x1280.
+      # Output resolution formatted as width x height (allowed values: 720x1280,
+      # 1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.
       sig { returns(T.nilable(OpenAI::VideoSize::OrSymbol)) }
       attr_reader :size
 
@@ -58,11 +60,13 @@ module OpenAI
         prompt:,
         # Optional image reference that guides generation.
         input_reference: nil,
-        # The video generation model to use. Defaults to `sora-2`.
+        # The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+        # to `sora-2`.
         model: nil,
-        # Clip duration in seconds. Defaults to 4 seconds.
+        # Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
         seconds: nil,
-        # Output resolution formatted as width x height. Defaults to 720x1280.
+        # Output resolution formatted as width x height (allowed values: 720x1280,
+        # 1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.
         size: nil,
         request_options: {}
       )

data/rbi/openai/resources/beta/assistants.rbi

@@ -62,9 +62,9 @@ module OpenAI
           name: nil,
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          # supported values are `none`, `minimal`, `low`, `medium`, and `high`. Reducing
-          # reasoning effort can result in faster responses and fewer tokens used on
-          # reasoning in a response.
+          # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
+          # Reducing reasoning effort can result in faster responses and fewer tokens used
+          # on reasoning in a response.
           #
           # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
           #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
@@ -72,6 +72,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`.
           reasoning_effort: nil,
           # Specifies the format that the model must output. Compatible with
           # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -196,9 +197,9 @@ module OpenAI
           name: nil,
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          # supported values are `none`, `minimal`, `low`, `medium`, and `high`. Reducing
-          # reasoning effort can result in faster responses and fewer tokens used on
-          # reasoning in a response.
+          # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
+          # Reducing reasoning effort can result in faster responses and fewer tokens used
+          # on reasoning in a response.
           #
           # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
           #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
@@ -206,6 +207,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`.
           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/resources/beta/threads/runs.rbi

@@ -125,9 +125,9 @@ module OpenAI
             parallel_tool_calls: nil,
             # Body param: Constrains effort on reasoning for
             # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-            # supported values are `none`, `minimal`, `low`, `medium`, and `high`. Reducing
-            # reasoning effort can result in faster responses and fewer tokens used on
-            # reasoning in a response.
+            # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
+            # Reducing reasoning effort can result in faster responses and fewer tokens used
+            # on reasoning in a response.
             #
             # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
             #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
@@ -135,6 +135,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`.
             reasoning_effort: nil,
             # Body param: Specifies the format that the model must output. Compatible with
             # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
@@ -311,9 +312,9 @@ module OpenAI
             parallel_tool_calls: nil,
             # Body param: Constrains effort on reasoning for
             # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-            # supported values are `none`, `minimal`, `low`, `medium`, and `high`. Reducing
-            # reasoning effort can result in faster responses and fewer tokens used on
-            # reasoning in a response.
+            # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
+            # Reducing reasoning effort can result in faster responses and fewer tokens used
+            # on reasoning in a response.
             #
             # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
             #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
@@ -321,6 +322,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`.
             reasoning_effort: nil,
             # Body param: Specifies the format that the model must output. Compatible with
             # [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),

data/rbi/openai/resources/chat/completions.rbi

@@ -228,9 +228,9 @@ module OpenAI
           prompt_cache_retention: nil,
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          # supported values are `none`, `minimal`, `low`, `medium`, and `high`. Reducing
-          # reasoning effort can result in faster responses and fewer tokens used on
-          # reasoning in a response.
+          # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
+          # Reducing reasoning effort can result in faster responses and fewer tokens used
+          # on reasoning in a response.
           #
           # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
           #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
@@ -238,6 +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`.
           reasoning_effort: nil,
           # An object specifying the format that the model must output.
           #
@@ -561,9 +562,9 @@ module OpenAI
           prompt_cache_retention: nil,
           # Constrains effort on reasoning for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-          # supported values are `none`, `minimal`, `low`, `medium`, and `high`. Reducing
-          # reasoning effort can result in faster responses and fewer tokens used on
-          # reasoning in a response.
+          # supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
+          # Reducing reasoning effort can result in faster responses and fewer tokens used
+          # on reasoning in a response.
           #
           # - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
           #   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
@@ -571,6 +572,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`.
           reasoning_effort: nil,
           # An object specifying the format that the model must output.
           #

data/rbi/openai/resources/containers.rbi

@@ -12,6 +12,7 @@ module OpenAI
           name: String,
           expires_after: OpenAI::ContainerCreateParams::ExpiresAfter::OrHash,
           file_ids: T::Array[String],
+          memory_limit: OpenAI::ContainerCreateParams::MemoryLimit::OrSymbol,
           request_options: OpenAI::RequestOptions::OrHash
         ).returns(OpenAI::Models::ContainerCreateResponse)
       end
@@ -22,6 +23,8 @@ module OpenAI
         expires_after: nil,
         # IDs of files to copy to the container.
         file_ids: nil,
+        # Optional memory limit for the container. Defaults to "1g".
+        memory_limit: nil,
         request_options: {}
       )
       end

data/rbi/openai/resources/conversations/items.rbi

@@ -21,6 +21,7 @@ module OpenAI
                   OpenAI::Responses::ResponseFunctionToolCall::OrHash,
                   OpenAI::Responses::ResponseInputItem::FunctionCallOutput::OrHash,
                   OpenAI::Responses::ResponseReasoningItem::OrHash,
+                  OpenAI::Responses::ResponseCompactionItemParam::OrHash,
                   OpenAI::Responses::ResponseInputItem::ImageGenerationCall::OrHash,
                   OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,
                   OpenAI::Responses::ResponseInputItem::LocalShellCall::OrHash,

data/rbi/openai/resources/conversations.rbi

@@ -23,6 +23,7 @@ module OpenAI
                   OpenAI::Responses::ResponseFunctionToolCall::OrHash,
                   OpenAI::Responses::ResponseInputItem::FunctionCallOutput::OrHash,
                   OpenAI::Responses::ResponseReasoningItem::OrHash,
+                  OpenAI::Responses::ResponseCompactionItemParam::OrHash,
                   OpenAI::Responses::ResponseInputItem::ImageGenerationCall::OrHash,
                   OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,
                   OpenAI::Responses::ResponseInputItem::LocalShellCall::OrHash,

data/rbi/openai/resources/realtime/calls.rbi

@@ -109,15 +109,20 @@ module OpenAI
           # limit, the conversation be truncated, meaning messages (starting from the
           # oldest) will not be included in the model's context. A 32k context model with
           # 4,096 max output tokens can only include 28,224 tokens in the context before
-          # truncation occurs. Clients can configure truncation behavior to truncate with a
-          # lower max token limit, which is an effective way to control token usage and
-          # cost. Truncation will reduce the number of cached tokens on the next turn
-          # (busting the cache), since messages are dropped from the beginning of the
-          # context. However, clients can also configure truncation to retain messages up to
-          # a fraction of the maximum context size, which will reduce the need for future
-          # truncations and thus improve the cache rate. Truncation can be disabled
-          # entirely, which means the server will never truncate but would instead return an
-          # error if the conversation exceeds the model's input token limit.
+          # truncation occurs.
+          #
+          # Clients can configure truncation behavior to truncate with a lower max token
+          # limit, which is an effective way to control token usage and cost.
+          #
+          # Truncation will reduce the number of cached tokens on the next turn (busting the
+          # cache), since messages are dropped from the beginning of the context. However,
+          # clients can also configure truncation to retain messages up to a fraction of the
+          # maximum context size, which will reduce the need for future truncations and thus
+          # improve the cache rate.
+          #
+          # Truncation can be disabled entirely, which means the server will never truncate
+          # but would instead return an error if the conversation exceeds the model's input
+          # token limit.
           truncation: nil,
           # The type of session to create. Always `realtime` for the Realtime API.
           type: :realtime,

data/rbi/openai/resources/responses.rbi

@@ -942,6 +942,48 @@ module OpenAI
       )
       end
 
+      # Compact conversation
+      sig do
+        params(
+          input:
+            T.nilable(
+              OpenAI::Responses::ResponseCompactParams::Input::Variants
+            ),
+          instructions: T.nilable(String),
+          model:
+            T.nilable(
+              T.any(
+                OpenAI::Responses::ResponseCompactParams::Model::OrSymbol,
+                String
+              )
+            ),
+          previous_response_id: T.nilable(String),
+          request_options: OpenAI::RequestOptions::OrHash
+        ).returns(OpenAI::Responses::CompactedResponse)
+      end
+      def compact(
+        # Text, image, or file inputs to the model, used to generate a response
+        input: nil,
+        # A system (or developer) message inserted into the model's context. When used
+        # along with `previous_response_id`, the instructions from a previous response
+        # will not be carried over to the next response. This makes it simple to swap out
+        # system (or developer) messages in new responses.
+        instructions: nil,
+        # 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.
+        model: nil,
+        # The unique ID of the previous response to the model. Use this to create
+        # multi-turn conversations. Learn more about
+        # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+        # Cannot be used in conjunction with `conversation`.
+        previous_response_id: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: OpenAI::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/openai/resources/videos.rbi

@@ -19,11 +19,13 @@ module OpenAI
         prompt:,
         # Optional image reference that guides generation.
         input_reference: nil,
-        # The video generation model to use. Defaults to `sora-2`.
+        # The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+        # to `sora-2`.
         model: nil,
-        # Clip duration in seconds. Defaults to 4 seconds.
+        # Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
         seconds: nil,
-        # Output resolution formatted as width x height. Defaults to 720x1280.
+        # Output resolution formatted as width x height (allowed values: 720x1280,
+        # 1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.
         size: nil,
         request_options: {}
       )

data/sig/openai/models/all_models.rbs

@@ -22,6 +22,7 @@ module OpenAI
         | :"gpt-5-codex"
         | :"gpt-5-pro"
         | :"gpt-5-pro-2025-10-06"
+        | :"gpt-5.1-codex-max"
 
       module ResponsesOnlyModel
         extend OpenAI::Internal::Type::Enum
@@ -39,6 +40,7 @@ module OpenAI
         GPT_5_CODEX: :"gpt-5-codex"
         GPT_5_PRO: :"gpt-5-pro"
         GPT_5_PRO_2025_10_06: :"gpt-5-pro-2025-10-06"
+        GPT_5_1_CODEX_MAX: :"gpt-5.1-codex-max"
 
         def self?.values: -> ::Array[OpenAI::Models::AllModels::responses_only_model]
       end