openai 0.123.0 → 0.124.0

data/rbi/openai/models/beta/agents/session_create_params.rbi

@@ -59,6 +59,19 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :metadata
 
+          # Default prompt cache lifetime for turns in this session. Omit to use the model
+          # default.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions)) }
+          attr_reader :prompt_cache_options
+
+          sig {
+            params(
+              prompt_cache_options: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::OrHash)
+            )
+              .void
+          }
+          attr_writer :prompt_cache_options
+
           # Action review mode. Omit to use none.
           sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol)) }
           attr_reader :review
@@ -76,6 +89,13 @@ module OpenAI
           }
           attr_writer :spend_control
 
+          # Options for the event stream. Only allowed when `stream` is `true`.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::StreamOptions)) }
+          attr_reader :stream_options
+
+          sig { params(stream_options: OpenAI::Beta::Agents::SessionCreateParams::StreamOptions::OrHash).void }
+          attr_writer :stream_options
+
           # The IDs of vaults made available to the session.
           sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :vault_ids
@@ -97,10 +117,14 @@ module OpenAI
 
               metadata: T.nilable(T::Hash[Symbol, String]),
 
+              prompt_cache_options: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::OrHash),
+
               review: OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol,
 
               spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
 
+              stream_options: OpenAI::Beta::Agents::SessionCreateParams::StreamOptions::OrHash,
+
               vault_ids: T.nilable(T::Array[String]),
 
               request_options: OpenAI::RequestOptions::OrHash
@@ -130,6 +154,10 @@ module OpenAI
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
 
+            # Default prompt cache lifetime for turns in this session. Omit to use the model
+            # default.
+            prompt_cache_options: nil,
+
             # Action review mode. Omit to use none.
             review: nil,
 
@@ -137,6 +165,9 @@ module OpenAI
             # session.
             spend_control: nil,
 
+            # Options for the event stream. Only allowed when `stream` is `true`.
+            stream_options: nil,
+
             # The IDs of vaults made available to the session.
             vault_ids: nil,
 
@@ -156,8 +187,10 @@ module OpenAI
                 agent_id: String,
                 input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
                 metadata: T.nilable(T::Hash[Symbol, String]),
+                prompt_cache_options: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions),
                 review: OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol,
                 spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl),
+                stream_options: OpenAI::Beta::Agents::SessionCreateParams::StreamOptions,
                 vault_ids: T.nilable(T::Array[String]),
                 request_options: OpenAI::RequestOptions
               }
@@ -502,6 +535,68 @@ module OpenAI
 
           end
 
+          class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl::OrSymbol)) }
+            attr_reader :ttl
+
+            sig { params(ttl: OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl::OrSymbol).void }
+            attr_writer :ttl
+
+            # Default prompt cache lifetime for turns in this session. Omit to use the model
+            # default.
+            sig do
+              params(
+
+                ttl: OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl::OrSymbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+
+              ttl: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {ttl: OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl::OrSymbol}
+              )
+            end
+            def to_hash
+            end
+
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            module Ttl
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias {
+                T.all(Symbol, OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              TTL_30M = T.let(:"30m", OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl::TaggedSymbol)
+              TTL_12H = T.let(:"12h", OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl::TaggedSymbol)
+
+              sig {
+                override.returns(
+                  T::Array[OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl::TaggedSymbol]
+                )
+              }
+              def self.values
+              end
+            end
+          end
+
           # Action review mode. Omit to use none.
           module Review
             extend OpenAI::Internal::Type::Enum
@@ -559,6 +654,49 @@ module OpenAI
 
           end
 
+          class StreamOptions < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::SessionCreateParams::StreamOptions,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Whether to include obfuscation padding in events on this connection. Defaults to
+            # `true`.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :include_obfuscation
+
+            sig { params(include_obfuscation: T::Boolean).void }
+            attr_writer :include_obfuscation
+
+            # Options for the event stream. Only allowed when `stream` is `true`.
+            sig do
+              params(
+
+                include_obfuscation: T::Boolean
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Whether to include obfuscation padding in events on this connection. Defaults to
+              # `true`.
+
+              include_obfuscation: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {include_obfuscation: T::Boolean}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
         end
 
       end

data/rbi/openai/models/beta/agents/session_update_params.rbi

@@ -35,6 +35,19 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :metadata
 
+          # Default prompt cache lifetime for future turns. Send null to clear the session
+          # default.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions)) }
+          attr_reader :prompt_cache_options
+
+          sig {
+            params(
+              prompt_cache_options: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::OrHash)
+            )
+              .void
+          }
+          attr_writer :prompt_cache_options
+
           # Default action review for new root turns. Existing turns and their subagents
           # keep their review mode.
           sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::Review::OrSymbol)) }
@@ -62,6 +75,8 @@ module OpenAI
 
               metadata: T.nilable(T::Hash[Symbol, String]),
 
+              prompt_cache_options: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::OrHash),
+
               review: OpenAI::Beta::Agents::SessionUpdateParams::Review::OrSymbol,
 
               spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash),
@@ -82,6 +97,10 @@ module OpenAI
             # characters.
             metadata: nil,
 
+            # Default prompt cache lifetime for future turns. Send null to clear the session
+            # default.
+            prompt_cache_options: nil,
+
             # Default action review for new root turns. Existing turns and their subagents
             # keep their review mode.
             review: nil,
@@ -100,6 +119,7 @@ module OpenAI
                 session_id: String,
                 agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent,
                 metadata: T.nilable(T::Hash[Symbol, String]),
+                prompt_cache_options: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions),
                 review: OpenAI::Beta::Agents::SessionUpdateParams::Review::OrSymbol,
                 spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl),
                 request_options: OpenAI::RequestOptions
@@ -331,6 +351,68 @@ module OpenAI
             end
           end
 
+          class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl::OrSymbol)) }
+            attr_reader :ttl
+
+            sig { params(ttl: OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl::OrSymbol).void }
+            attr_writer :ttl
+
+            # Default prompt cache lifetime for future turns. Send null to clear the session
+            # default.
+            sig do
+              params(
+
+                ttl: OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl::OrSymbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+
+              ttl: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {ttl: OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl::OrSymbol}
+              )
+            end
+            def to_hash
+            end
+
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            module Ttl
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias {
+                T.all(Symbol, OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              TTL_30M = T.let(:"30m", OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl::TaggedSymbol)
+              TTL_12H = T.let(:"12h", OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl::TaggedSymbol)
+
+              sig {
+                override.returns(
+                  T::Array[OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl::TaggedSymbol]
+                )
+              }
+              def self.values
+              end
+            end
+          end
+
           # Default action review for new root turns. Existing turns and their subagents
           # keep their review mode.
           module Review

data/rbi/openai/models/beta/agents/sessions/event_create_params.rbi

@@ -29,6 +29,7 @@ module OpenAI
               returns(
                 T::Array[
                   T.any(
+                    OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMcpApprovalRequestResult,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMessage,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputCancel,
@@ -52,6 +53,7 @@ module OpenAI
 
                 events: T::Array[
                   T.any(
+                    OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMcpApprovalRequestResult::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMessage::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputCancel::OrHash,
@@ -84,6 +86,7 @@ module OpenAI
                   session_id: String,
                   events: T::Array[
                     T.any(
+                      OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMcpApprovalRequestResult,
                       OpenAI::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult,
                       OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMessage,
                       OpenAI::Beta::AgentSessionInputParam::AgentSessionInputCancel,

data/rbi/openai/models/beta/agents/sessions/event_stream_params.rbi

@@ -24,11 +24,21 @@ module OpenAI
             sig { returns(String) }
             attr_accessor :session_id
 
+            # Whether to include obfuscation padding in events on this connection. Defaults to
+            # `true`.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :include_obfuscation
+
+            sig { params(include_obfuscation: T::Boolean).void }
+            attr_writer :include_obfuscation
+
             sig do
               params(
 
                 session_id: String,
 
+                include_obfuscation: T::Boolean,
+
                 request_options: OpenAI::RequestOptions::OrHash
               )
                 .returns(T.attached_class)
@@ -37,13 +47,17 @@ module OpenAI
 
               session_id:,
 
+              # Whether to include obfuscation padding in events on this connection. Defaults to
+              # `true`.
+              include_obfuscation: nil,
+
               request_options: {}
             )
             end
 
             sig do
               override.returns(
-                {session_id: String, request_options: OpenAI::RequestOptions}
+                {session_id: String, include_obfuscation: T::Boolean, request_options: OpenAI::RequestOptions}
               )
             end
             def to_hash

data/rbi/openai/models/beta/agents/sessions/turn.rbi

@@ -71,6 +71,17 @@ module OpenAI
             sig { params(usage: T.nilable(OpenAI::Beta::TokenUsage::OrHash)).void }
             attr_writer :usage
 
+            # Prompt cache lifetime selected when this turn started, including an inherited
+            # session TTL. Null when the turn used the model default or no TTL was recorded.
+            sig { returns(T.nilable(OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions)) }
+            attr_reader :prompt_cache_options
+
+            sig {
+              params(prompt_cache_options: T.nilable(OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::OrHash))
+                .void
+            }
+            attr_writer :prompt_cache_options
+
             # The canonical public representation of a session turn.
             sig do
               params(
@@ -95,6 +106,8 @@ module OpenAI
 
                 usage: T.nilable(OpenAI::Beta::TokenUsage::OrHash),
 
+                prompt_cache_options: T.nilable(OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::OrHash),
+
                 object: Symbol
               )
                 .returns(T.attached_class)
@@ -134,6 +147,10 @@ module OpenAI
               # change.
               usage:,
 
+              # Prompt cache lifetime selected when this turn started, including an inherited
+              # session TTL. Null when the turn used the model default or no TTL was recorded.
+              prompt_cache_options: nil,
+
               # The object type. Always `agent.session.turn`.
 
               object: :"agent.session.turn"
@@ -153,7 +170,8 @@ module OpenAI
                   started_at: T.nilable(Integer),
                   status: OpenAI::Beta::Agents::Sessions::Turn::Status::TaggedSymbol,
                   subagent_id: T.nilable(String),
-                  usage: T.nilable(OpenAI::Beta::TokenUsage)
+                  usage: T.nilable(OpenAI::Beta::TokenUsage),
+                  prompt_cache_options: T.nilable(OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions)
                 }
               )
             end
@@ -190,6 +208,61 @@ module OpenAI
               end
             end
 
+            class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              sig { returns(OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl::TaggedSymbol) }
+              attr_accessor :ttl
+
+              # Prompt cache lifetime selected when this turn started, including an inherited
+              # session TTL. Null when the turn used the model default or no TTL was recorded.
+              sig do
+                params(
+
+                  ttl: OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl::OrSymbol
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                ttl:
+              )
+              end
+
+              sig do
+                override.returns(
+                  {ttl: OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl::TaggedSymbol}
+                )
+              end
+              def to_hash
+              end
+
+              module Ttl
+                extend OpenAI::Internal::Type::Enum
+
+                TaggedSymbol = T.type_alias {
+                  T.all(Symbol, OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl)
+                }
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                TTL_30M = T.let(:"30m", OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl::TaggedSymbol)
+                TTL_12H = T.let(:"12h", OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl::TaggedSymbol)
+
+                sig {
+                  override.returns(
+                    T::Array[OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl::TaggedSymbol]
+                  )
+                }
+                def self.values
+                end
+              end
+            end
+
           end
 
         end

data/rbi/openai/models/beta/beta_response.rbi

@@ -342,7 +342,9 @@ module OpenAI
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,
         #   the model will truncate the response to fit the context window by dropping
-        #   items from the beginning of the conversation.
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit, even if you set a lower `max_output_tokens`.
         # - `disabled` (default): If the input size will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         sig { returns(T.nilable(OpenAI::Beta::BetaResponse::Truncation::TaggedSymbol)) }
@@ -755,7 +757,9 @@ module OpenAI
           #
           # - `auto`: If the input to this Response exceeds the model's context window size,
           #   the model will truncate the response to fit the context window by dropping
-          #   items from the beginning of the conversation.
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit, even if you set a lower `max_output_tokens`.
           # - `disabled` (default): If the input size will exceed the context window size
           #   for a model, the request will fail with a 400 error.
           truncation: nil,
@@ -2875,7 +2879,9 @@ module OpenAI
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,
         #   the model will truncate the response to fit the context window by dropping
-        #   items from the beginning of the conversation.
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit, even if you set a lower `max_output_tokens`.
         # - `disabled` (default): If the input size will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         module Truncation

data/rbi/openai/models/beta/beta_response_tool_search_output_item_param.rbi

@@ -1377,7 +1377,8 @@ module OpenAI
             # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
             # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
             # `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
-            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2.6-sunburst`.
             #
             # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             # `gpt-image-2.5-flare` instead.
@@ -1614,7 +1615,8 @@ module OpenAI
               # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
               # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
               # `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
-              # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+              # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+              # `gpt-image-2.6-sunburst`.
               #
               # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
               # `gpt-image-2.5-flare` instead.
@@ -1902,7 +1904,8 @@ module OpenAI
             # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
             # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
             # `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
-            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2.6-sunburst`.
             #
             # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             # `gpt-image-2.5-flare` instead.

data/rbi/openai/models/beta/beta_responses_client_event.rbi

@@ -480,7 +480,9 @@ module OpenAI
           #
           # - `auto`: If the input to this Response exceeds the model's context window size,
           #   the model will truncate the response to fit the context window by dropping
-          #   items from the beginning of the conversation.
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit, even if you set a lower `max_output_tokens`.
           # - `disabled` (default): If the input size will exceed the context window size
           #   for a model, the request will fail with a 400 error.
           sig { returns(T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Truncation::OrSymbol)) }
@@ -882,7 +884,9 @@ module OpenAI
             #
             # - `auto`: If the input to this Response exceeds the model's context window size,
             #   the model will truncate the response to fit the context window by dropping
-            #   items from the beginning of the conversation.
+            #   items from the beginning of the conversation. On some models, trimming can
+            #   begin earlier because the API subtracts the model's maximum output allowance
+            #   from its input limit, even if you set a lower `max_output_tokens`.
             # - `disabled` (default): If the input size will exceed the context window size
             #   for a model, the request will fail with a 400 error.
             truncation: nil,
@@ -2778,7 +2782,9 @@ module OpenAI
           #
           # - `auto`: If the input to this Response exceeds the model's context window size,
           #   the model will truncate the response to fit the context window by dropping
-          #   items from the beginning of the conversation.
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit, even if you set a lower `max_output_tokens`.
           # - `disabled` (default): If the input size will exceed the context window size
           #   for a model, the request will fail with a 400 error.
           module Truncation

data/rbi/openai/models/beta/beta_tool.rbi

@@ -1021,7 +1021,8 @@ module OpenAI
           # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
           # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
           # `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
-          # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+          # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+          # `gpt-image-2.6-sunburst`.
           #
           # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
           # `gpt-image-2.5-flare` instead.
@@ -1183,7 +1184,8 @@ module OpenAI
             # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
             # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
             # `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
-            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+            # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+            # `gpt-image-2.6-sunburst`.
             #
             # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
             # `gpt-image-2.5-flare` instead.
@@ -1398,7 +1400,8 @@ module OpenAI
           # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
           # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
           # `gpt-image-2.5-flare-2026-09-08`, `gpt-image-2.6-sunburst`,
-          # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default: `gpt-image-2`.
+          # `gpt-image-2.6-flare`, or `chatgpt-image-latest`. Default:
+          # `gpt-image-2.6-sunburst`.
           #
           # `gpt-image-1` was shut down on October 23, 2026. Use `gpt-image-2.5-sunburst` or
           # `gpt-image-2.5-flare` instead.

data/rbi/openai/models/beta/response_create_params.rbi

@@ -409,7 +409,9 @@ module OpenAI
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,
         #   the model will truncate the response to fit the context window by dropping
-        #   items from the beginning of the conversation.
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit, even if you set a lower `max_output_tokens`.
         # - `disabled` (default): If the input size will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         sig { returns(T.nilable(OpenAI::Beta::ResponseCreateParams::Truncation::OrSymbol)) }
@@ -780,7 +782,9 @@ module OpenAI
           #
           # - `auto`: If the input to this Response exceeds the model's context window size,
           #   the model will truncate the response to fit the context window by dropping
-          #   items from the beginning of the conversation.
+          #   items from the beginning of the conversation. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit, even if you set a lower `max_output_tokens`.
           # - `disabled` (default): If the input size will exceed the context window size
           #   for a model, the request will fail with a 400 error.
           truncation: nil,
@@ -2195,7 +2199,9 @@ module OpenAI
         #
         # - `auto`: If the input to this Response exceeds the model's context window size,
         #   the model will truncate the response to fit the context window by dropping
-        #   items from the beginning of the conversation.
+        #   items from the beginning of the conversation. On some models, trimming can
+        #   begin earlier because the API subtracts the model's maximum output allowance
+        #   from its input limit, even if you set a lower `max_output_tokens`.
         # - `disabled` (default): If the input size will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         module Truncation