openai 0.123.0 → 0.124.0

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

@@ -53,7 +53,13 @@ module OpenAI
         #   @return [Symbol, :"agent.session.turn.reasoning_summary_part.added"]
         required :type, const: :"agent.session.turn.reasoning_summary_part.added"
 
-        # @!method initialize(event_id:, item_id:, output_index:, part:, session_id:, summary_index:, turn_id:, type: :"agent.session.turn.reasoning_summary_part.added")
+        # @!attribute obfuscation
+        #   Random alphanumeric padding. Present when stream obfuscation is enabled.
+        #
+        #   @return [String, nil]
+        optional :obfuscation, String
+
+        # @!method initialize(event_id:, item_id:, output_index:, part:, session_id:, summary_index:, turn_id:, obfuscation: nil, type: :"agent.session.turn.reasoning_summary_part.added")
         #   Emitted when a reasoning summary content part is added.
         #
         #   @param event_id [String]
@@ -77,6 +83,9 @@ module OpenAI
         #   @param turn_id [String, nil]
         #     The ID of the turn associated with the event, when applicable.
         #
+        #   @param obfuscation [String]
+        #     Random alphanumeric padding. Present when stream obfuscation is enabled.
+        #
         #   @param type [Symbol, :"agent.session.turn.reasoning_summary_part.added"]
         #     The type of the object. Always
         #     `agent.session.turn.reasoning_summary_part.added`.

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

@@ -58,7 +58,13 @@ module OpenAI
         #   @return [Symbol, :"agent.session.turn.reasoning_summary_part.done"]
         required :type, const: :"agent.session.turn.reasoning_summary_part.done"
 
-        # @!method initialize(event_id:, item_id:, output_index:, part:, session_id:, summary_index:, turn_id:, status: :incomplete, type: :"agent.session.turn.reasoning_summary_part.done")
+        # @!attribute obfuscation
+        #   Random alphanumeric padding. Present when stream obfuscation is enabled.
+        #
+        #   @return [String, nil]
+        optional :obfuscation, String
+
+        # @!method initialize(event_id:, item_id:, output_index:, part:, session_id:, summary_index:, turn_id:, obfuscation: nil, status: :incomplete, type: :"agent.session.turn.reasoning_summary_part.done")
         #   Emitted when a reasoning summary part is complete.
         #
         #   @param event_id [String]
@@ -82,6 +88,9 @@ module OpenAI
         #   @param turn_id [String, nil]
         #     The ID of the turn associated with the event, when applicable.
         #
+        #   @param obfuscation [String]
+        #     Random alphanumeric padding. Present when stream obfuscation is enabled.
+        #
         #   @param status [Symbol, :incomplete, nil]
         #     Present as `incomplete` when summary generation was interrupted.
         #

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

@@ -53,7 +53,13 @@ module OpenAI
         #   @return [Symbol, :"agent.session.turn.reasoning_summary_text.delta"]
         required :type, const: :"agent.session.turn.reasoning_summary_text.delta"
 
-        # @!method initialize(delta:, event_id:, item_id:, output_index:, session_id:, summary_index:, turn_id:, type: :"agent.session.turn.reasoning_summary_text.delta")
+        # @!attribute obfuscation
+        #   Random alphanumeric padding. Present when stream obfuscation is enabled.
+        #
+        #   @return [String, nil]
+        optional :obfuscation, String
+
+        # @!method initialize(delta:, event_id:, item_id:, output_index:, session_id:, summary_index:, turn_id:, obfuscation: nil, type: :"agent.session.turn.reasoning_summary_text.delta")
         #   Emitted when text is appended to a reasoning summary.
         #
         #   @param delta [String]
@@ -77,6 +83,9 @@ module OpenAI
         #   @param turn_id [String, nil]
         #     The ID of the turn associated with the event, when applicable.
         #
+        #   @param obfuscation [String]
+        #     Random alphanumeric padding. Present when stream obfuscation is enabled.
+        #
         #   @param type [Symbol, :"agent.session.turn.reasoning_summary_text.delta"]
         #     The type of the object. Always
         #     `agent.session.turn.reasoning_summary_text.delta`.

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

@@ -52,7 +52,13 @@ module OpenAI
         #   @return [Symbol, :"agent.session.turn.reasoning_summary_text.done"]
         required :type, const: :"agent.session.turn.reasoning_summary_text.done"
 
-        # @!method initialize(event_id:, item_id:, output_index:, session_id:, summary_index:, text:, turn_id:, type: :"agent.session.turn.reasoning_summary_text.done")
+        # @!attribute obfuscation
+        #   Random alphanumeric padding. Present when stream obfuscation is enabled.
+        #
+        #   @return [String, nil]
+        optional :obfuscation, String
+
+        # @!method initialize(event_id:, item_id:, output_index:, session_id:, summary_index:, text:, turn_id:, obfuscation: nil, type: :"agent.session.turn.reasoning_summary_text.done")
         #   Emitted when a reasoning summary content part is complete.
         #
         #   @param event_id [String]
@@ -76,6 +82,9 @@ module OpenAI
         #   @param turn_id [String, nil]
         #     The ID of the turn associated with the event, when applicable.
         #
+        #   @param obfuscation [String]
+        #     Random alphanumeric padding. Present when stream obfuscation is enabled.
+        #
         #   @param type [Symbol, :"agent.session.turn.reasoning_summary_text.done"]
         #     The type of the object. Always `agent.session.turn.reasoning_summary_text.done`.
       end

data/lib/openai/models/beta/agents/session_create_params.rb

@@ -47,6 +47,17 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+          # @!attribute prompt_cache_options
+          #   Default prompt cache lifetime for turns in this session. Omit to use the model
+          #   default.
+          #
+          #   @return [OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions, nil]
+          optional(
+            :prompt_cache_options,
+            -> { OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions },
+            nil?: true
+          )
+
           # @!attribute review
           #   Action review mode. Omit to use none.
           #
@@ -66,13 +77,19 @@ module OpenAI
             nil?: true
           )
 
+          # @!attribute stream_options
+          #   Options for the event stream. Only allowed when `stream` is `true`.
+          #
+          #   @return [OpenAI::Models::Beta::Agents::SessionCreateParams::StreamOptions, nil]
+          optional :stream_options, -> { OpenAI::Beta::Agents::SessionCreateParams::StreamOptions }
+
           # @!attribute vault_ids
           #   The IDs of vaults made available to the session.
           #
           #   @return [Array<String>, nil]
           optional :vault_ids, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
-          # @!method initialize(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, review: nil, spend_control: nil, vault_ids: nil, request_options: {})
+          # @!method initialize(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, prompt_cache_options: nil, review: nil, spend_control: nil, stream_options: nil, vault_ids: nil, request_options: {})
           #   @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #     An inline execution environment or a reference to an environment template.
           #
@@ -94,6 +111,10 @@ module OpenAI
           #     Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #     characters. Omission or null defaults to an empty map.
           #
+          #   @param prompt_cache_options [OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions, nil]
+          #     Default prompt cache lifetime for turns in this session. Omit to use the model
+          #     default.
+          #
           #   @param review [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review]
           #     Action review mode. Omit to use none.
           #
@@ -101,6 +122,9 @@ module OpenAI
           #     Optional spending limit in USD cents. Omission or null creates an unlimited
           #     session.
           #
+          #   @param stream_options [OpenAI::Models::Beta::Agents::SessionCreateParams::StreamOptions]
+          #     Options for the event stream. Only allowed when `stream` is `true`.
+          #
           #   @param vault_ids [Array<String>, nil]
           #     The IDs of vaults made available to the session.
           #
@@ -310,6 +334,34 @@ module OpenAI
             ]
           end
 
+          class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+            # @!attribute ttl
+            #   Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            #
+            #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl, nil]
+            optional :ttl, enum: -> { OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl }
+
+            # @!method initialize(ttl: nil)
+            #   Default prompt cache lifetime for turns in this session. Omit to use the model
+            #   default.
+            #
+            #   @param ttl [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::Ttl]
+            #     Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            #
+            # @see OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions#ttl
+            module Ttl
+              extend OpenAI::Internal::Type::Enum
+
+              TTL_30M = :"30m"
+              TTL_12H = :"12h"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
           # Action review mode. Omit to use none.
           module Review
             extend OpenAI::Internal::Type::Enum
@@ -338,6 +390,22 @@ module OpenAI
             #   @param limit [Integer, nil]
             #     Positive USD cents, or null to remove the limit.
           end
+
+          class StreamOptions < OpenAI::Internal::Type::BaseModel
+            # @!attribute include_obfuscation
+            #   Whether to include obfuscation padding in events on this connection. Defaults to
+            #   `true`.
+            #
+            #   @return [Boolean, nil]
+            optional :include_obfuscation, OpenAI::Internal::Type::Boolean
+
+            # @!method initialize(include_obfuscation: nil)
+            #   Options for the event stream. Only allowed when `stream` is `true`.
+            #
+            #   @param include_obfuscation [Boolean]
+            #     Whether to include obfuscation padding in events on this connection. Defaults to
+            #     `true`.
+          end
         end
       end
     end

data/lib/openai/models/beta/agents/session_update_params.rb

@@ -28,6 +28,17 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+          # @!attribute prompt_cache_options
+          #   Default prompt cache lifetime for future turns. Send null to clear the session
+          #   default.
+          #
+          #   @return [OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions, nil]
+          optional(
+            :prompt_cache_options,
+            -> { OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions },
+            nil?: true
+          )
+
           # @!attribute review
           #   Default action review for new root turns. Existing turns and their subagents
           #   keep their review mode.
@@ -48,7 +59,7 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(session_id:, agent: nil, metadata: nil, review: nil, spend_control: nil, request_options: {})
+          # @!method initialize(session_id:, agent: nil, metadata: nil, prompt_cache_options: nil, review: nil, spend_control: nil, request_options: {})
           #   @param session_id [String]
           #
           #   @param agent [OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent]
@@ -59,6 +70,10 @@ module OpenAI
           #     Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #     characters.
           #
+          #   @param prompt_cache_options [OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions, nil]
+          #     Default prompt cache lifetime for future turns. Send null to clear the session
+          #     default.
+          #
           #   @param review [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::Review]
           #     Default action review for new root turns. Existing turns and their subagents
           #     keep their review mode.
@@ -189,6 +204,34 @@ module OpenAI
             end
           end
 
+          class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+            # @!attribute ttl
+            #   Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            #
+            #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl, nil]
+            optional :ttl, enum: -> { OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl }
+
+            # @!method initialize(ttl: nil)
+            #   Default prompt cache lifetime for future turns. Send null to clear the session
+            #   default.
+            #
+            #   @param ttl [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::Ttl]
+            #     Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            #
+            # @see OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions#ttl
+            module Ttl
+              extend OpenAI::Internal::Type::Enum
+
+              TTL_30M = :"30m"
+              TTL_12H = :"12h"
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
           # Default action review for new root turns. Existing turns and their subagents
           # keep their review mode.
           module Review

data/lib/openai/models/beta/agents/sessions/event_create_params.rb

@@ -18,7 +18,7 @@ module OpenAI
             # @!attribute events
             #   The input events to submit to the session.
             #
-            #   @return [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
+            #   @return [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMcpApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
             required :events, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentSessionInputParam] }
 
             # @!attribute idempotency_key
@@ -29,7 +29,7 @@ module OpenAI
             # @!method initialize(session_id:, events:, idempotency_key: nil, request_options: {})
             #   @param session_id [String]
             #
-            #   @param events [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
+            #   @param events [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMcpApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
             #     The input events to submit to the session.
             #
             #   @param idempotency_key [String]

data/lib/openai/models/beta/agents/sessions/event_stream_params.rb

@@ -15,8 +15,20 @@ module OpenAI
             #   @return [String]
             required :session_id, String
 
-            # @!method initialize(session_id:, request_options: {})
+            # @!attribute include_obfuscation
+            #   Whether to include obfuscation padding in events on this connection. Defaults to
+            #   `true`.
+            #
+            #   @return [Boolean, nil]
+            optional :include_obfuscation, OpenAI::Internal::Type::Boolean
+
+            # @!method initialize(session_id:, include_obfuscation: nil, request_options: {})
             #   @param session_id [String]
+            #
+            #   @param include_obfuscation [Boolean]
+            #     Whether to include obfuscation padding in events on this connection. Defaults to
+            #     `true`.
+            #
             #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
           end
         end

data/lib/openai/models/beta/agents/sessions/turn.rb

@@ -76,7 +76,18 @@ module OpenAI
             #   @return [OpenAI::Models::Beta::TokenUsage, nil]
             required :usage, -> { OpenAI::Beta::TokenUsage }, nil?: true
 
-            # @!method initialize(id:, agent_id:, completed_at:, created_at:, error:, session_id:, started_at:, status:, subagent_id:, usage:, object: :"agent.session.turn")
+            # @!attribute prompt_cache_options
+            #   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.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions, nil]
+            optional(
+              :prompt_cache_options,
+              -> { OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions },
+              nil?: true
+            )
+
+            # @!method initialize(id:, agent_id:, completed_at:, created_at:, error:, session_id:, started_at:, status:, subagent_id:, usage:, prompt_cache_options: nil, object: :"agent.session.turn")
             #   The canonical public representation of a session turn.
             #
             #   @param id [String]
@@ -112,6 +123,10 @@ module OpenAI
             #     Best-effort token usage for the turn, or null if unknown. Recorded usage may
             #     change.
             #
+            #   @param prompt_cache_options [OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions, nil]
+            #     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.
+            #
             #   @param object [Symbol, :"agent.session.turn"]
             #     The object type. Always `agent.session.turn`.
 
@@ -142,6 +157,31 @@ module OpenAI
               # @!method self.values
               #   @return [Array<Symbol>]
             end
+
+            # @see OpenAI::Models::Beta::Agents::Sessions::Turn#prompt_cache_options
+            class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+              # @!attribute ttl
+              #
+              #   @return [Symbol, OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl]
+              required :ttl, enum: -> { OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl }
+
+              # @!method initialize(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.
+              #
+              #   @param ttl [Symbol, OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions::Ttl]
+
+              # @see OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions#ttl
+              module Ttl
+                extend OpenAI::Internal::Type::Enum
+
+                TTL_30M = :"30m"
+                TTL_12H = :"12h"
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
           end
         end
       end

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

@@ -363,7 +363,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.
         #
@@ -626,7 +628,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.
         #
@@ -2431,7 +2435,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.
         #

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

@@ -811,7 +811,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.
@@ -943,7 +944,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.
@@ -1092,7 +1094,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/lib/openai/models/beta/beta_responses_client_event.rb

@@ -473,7 +473,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.
           #
@@ -770,7 +772,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.
           #
@@ -2409,7 +2413,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.
           #

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

@@ -681,7 +681,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.
@@ -798,7 +799,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.
@@ -947,7 +949,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/lib/openai/models/beta/response_compact_params.rb

@@ -31,6 +31,8 @@ module OpenAI
         optional :input, union: -> { OpenAI::Beta::ResponseCompactParams::Input }, nil?: true
 
         # @!attribute instructions
+        #   @deprecated
+        #
         #   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

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

@@ -364,7 +364,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.
         #
@@ -632,7 +634,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.
         #
@@ -2019,7 +2023,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/lib/openai/models/beta/responses/input_token_count_params.rb

@@ -107,11 +107,15 @@ module OpenAI
           # @!attribute truncation
           #   @deprecated
           #
-          #   The truncation strategy to use for the model response. - `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. - `disabled` (default): If the input size will exceed the
-          #   context window size for a model, the request will fail with a 400 error.
+          #   The truncation strategy to use for the model response.
+          #
+          #   - `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. On some models, trimming can
+          #     begin earlier because the API subtracts the model's maximum output allowance
+          #     from its input limit before counting tokens.
+          #   - `disabled` (default): If the input size will exceed the context window size
+          #     for a model, the request will fail with a 400 error.
           #
           #   @return [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Truncation, nil]
           optional :truncation, enum: -> { OpenAI::Beta::Responses::InputTokenCountParams::Truncation }
@@ -180,11 +184,15 @@ module OpenAI
           #     specify which tool to use by setting the `tool_choice` parameter.
           #
           #   @param truncation [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Truncation]
-          #     The truncation strategy to use for the model response. - `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. - `disabled` (default): If the input size will exceed the
-          #     context window size for a model, the request will fail with a 400 error.
+          #     The truncation strategy to use for the model response.
+          #
+          #     - `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. On some models, trimming can
+          #       begin earlier because the API subtracts the model's maximum output allowance
+          #       from its input limit before counting tokens.
+          #     - `disabled` (default): If the input size will exceed the context window size
+          #       for a model, the request will fail with a 400 error.
           #
           #   @param betas [Array<Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Beta>]
           #
@@ -614,11 +622,15 @@ module OpenAI
 
           # @deprecated
           #
-          # The truncation strategy to use for the model response. - `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. - `disabled` (default): If the input size will exceed the
-          # context window size for a model, the request will fail with a 400 error.
+          # The truncation strategy to use for the model response.
+          #
+          # - `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. On some models, trimming can
+          #   begin earlier because the API subtracts the model's maximum output allowance
+          #   from its input limit before counting 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
             extend OpenAI::Internal::Type::Enum