openai 0.123.0 → 0.124.0

data/sig/openai/models/beta/agent_session_turn_reasoning_summary_text_delta_event.rbs

@@ -10,7 +10,8 @@ module OpenAI
           session_id: String,
           summary_index: Integer,
           turn_id: String?,
-          ?type: :"agent.session.turn.reasoning_summary_text.delta"
+          ?type: :"agent.session.turn.reasoning_summary_text.delta",
+          ?obfuscation: String
         }
 
       class AgentSessionTurnReasoningSummaryTextDeltaEvent < OpenAI::Internal::Type::BaseModel
@@ -39,6 +40,12 @@ module OpenAI
         # `agent.session.turn.reasoning_summary_text.delta`.
         attr_accessor type: :"agent.session.turn.reasoning_summary_text.delta"
 
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        attr_reader obfuscation: String?
+
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        def obfuscation=: (String) -> String
+
         # @param delta
         #   The summary text that was appended.
         # @param event_id
@@ -53,6 +60,8 @@ module OpenAI
         #   The index of the summary content part.
         # @param turn_id
         #   The ID of the turn associated with the event, when applicable.
+        # @param obfuscation
+        #   Random alphanumeric padding. Present when stream obfuscation is enabled.
         # @param type
         #   The type of the object. Always
         #   `agent.session.turn.reasoning_summary_text.delta`.
@@ -64,6 +73,7 @@ module OpenAI
           session_id: String,
           summary_index: Integer,
           turn_id: String?,
+          ?obfuscation: String,
           ?type: :"agent.session.turn.reasoning_summary_text.delta"
         ) -> void
 
@@ -75,7 +85,8 @@ module OpenAI
           session_id: String,
           summary_index: Integer,
           turn_id: String?,
-          ?type: :"agent.session.turn.reasoning_summary_text.delta"
+          ?type: :"agent.session.turn.reasoning_summary_text.delta",
+          ?obfuscation: String
         }
       end
     end

data/sig/openai/models/beta/agent_session_turn_reasoning_summary_text_done_event.rbs

@@ -10,7 +10,8 @@ module OpenAI
           summary_index: Integer,
           text: String,
           turn_id: String?,
-          ?type: :"agent.session.turn.reasoning_summary_text.done"
+          ?type: :"agent.session.turn.reasoning_summary_text.done",
+          ?obfuscation: String
         }
 
       class AgentSessionTurnReasoningSummaryTextDoneEvent < OpenAI::Internal::Type::BaseModel
@@ -38,6 +39,12 @@ module OpenAI
         # The type of the object. Always `agent.session.turn.reasoning_summary_text.done`.
         attr_accessor type: :"agent.session.turn.reasoning_summary_text.done"
 
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        attr_reader obfuscation: String?
+
+        # Random alphanumeric padding. Present when stream obfuscation is enabled.
+        def obfuscation=: (String) -> String
+
         # @param event_id
         #   The unique ID of the event.
         # @param item_id
@@ -52,6 +59,8 @@ module OpenAI
         #   The complete reasoning summary text.
         # @param turn_id
         #   The ID of the turn associated with the event, when applicable.
+        # @param obfuscation
+        #   Random alphanumeric padding. Present when stream obfuscation is enabled.
         # @param type
         #   The type of the object. Always `agent.session.turn.reasoning_summary_text.done`.
         def initialize: (
@@ -62,6 +71,7 @@ module OpenAI
           summary_index: Integer,
           text: String,
           turn_id: String?,
+          ?obfuscation: String,
           ?type: :"agent.session.turn.reasoning_summary_text.done"
         ) -> void
 
@@ -73,7 +83,8 @@ module OpenAI
           summary_index: Integer,
           text: String,
           turn_id: String?,
-          ?type: :"agent.session.turn.reasoning_summary_text.done"
+          ?type: :"agent.session.turn.reasoning_summary_text.done",
+          ?obfuscation: String
         }
       end
     end

data/sig/openai/models/beta/agents/session_create_params.rbs

@@ -9,8 +9,10 @@ module OpenAI
             ?agent_id: String,
             ?input: OpenAI::Models::Beta::Agents::SessionCreateParams::input?,
             ?metadata: ::Hash[Symbol, String]?,
+            ?prompt_cache_options: OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions?,
             ?review: OpenAI::Models::Beta::Agents::SessionCreateParams::review,
             ?spend_control: OpenAI::Beta::Agents::SessionCreateParams::SpendControl?,
+            ?stream_options: OpenAI::Beta::Agents::SessionCreateParams::StreamOptions,
             ?vault_ids: ::Array[String]?,
             ?request_options: OpenAI::request_opts
           }
@@ -50,6 +52,10 @@ module OpenAI
           # characters. Omission or null defaults to an empty map.
           attr_accessor metadata: ::Hash[Symbol, String]?
 
+          # Default prompt cache lifetime for turns in this session. Omit to use the model
+          # default.
+          attr_accessor prompt_cache_options: OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions?
+
           # Action review mode. Omit to use none.
           attr_reader review: OpenAI::Models::Beta::Agents::SessionCreateParams::review?
 
@@ -62,6 +68,14 @@ module OpenAI
           # session.
           attr_accessor spend_control: OpenAI::Beta::Agents::SessionCreateParams::SpendControl?
 
+          # Options for the event stream. Only allowed when `stream` is `true`.
+          attr_reader stream_options: OpenAI::Beta::Agents::SessionCreateParams::StreamOptions?
+
+          # Options for the event stream. Only allowed when `stream` is `true`.
+          def stream_options=: (
+            OpenAI::Beta::Agents::SessionCreateParams::StreamOptions
+          ) -> OpenAI::Beta::Agents::SessionCreateParams::StreamOptions
+
           # The IDs of vaults made available to the session.
           attr_accessor vault_ids: ::Array[String]?
 
@@ -81,11 +95,16 @@ module OpenAI
           # @param metadata
           #   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
+          #   Default prompt cache lifetime for turns in this session. Omit to use the model
+          #   default.
           # @param review
           #   Action review mode. Omit to use none.
           # @param spend_control
           #   Optional spending limit in USD cents. Omission or null creates an unlimited
           #   session.
+          # @param stream_options
+          #   Options for the event stream. Only allowed when `stream` is `true`.
           # @param vault_ids
           #   The IDs of vaults made available to the session.
           def initialize: (
@@ -94,8 +113,10 @@ module OpenAI
             ?agent_id: String,
             ?input: OpenAI::Models::Beta::Agents::SessionCreateParams::input?,
             ?metadata: ::Hash[Symbol, String]?,
+            ?prompt_cache_options: OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions?,
             ?review: OpenAI::Models::Beta::Agents::SessionCreateParams::review,
             ?spend_control: OpenAI::Beta::Agents::SessionCreateParams::SpendControl?,
+            ?stream_options: OpenAI::Beta::Agents::SessionCreateParams::StreamOptions,
             ?vault_ids: ::Array[String]?,
             ?request_options: OpenAI::request_opts
           ) -> void
@@ -106,8 +127,10 @@ module OpenAI
             ?agent_id: String,
             ?input: OpenAI::Models::Beta::Agents::SessionCreateParams::input?,
             ?metadata: ::Hash[Symbol, String]?,
+            ?prompt_cache_options: OpenAI::Beta::Agents::SessionCreateParams::PromptCacheOptions?,
             ?review: OpenAI::Models::Beta::Agents::SessionCreateParams::review,
             ?spend_control: OpenAI::Beta::Agents::SessionCreateParams::SpendControl?,
+            ?stream_options: OpenAI::Beta::Agents::SessionCreateParams::StreamOptions,
             ?vault_ids: ::Array[String]?,
             ?request_options: OpenAI::RequestOptions
           }
@@ -293,6 +316,42 @@ module OpenAI
             AgentSessionInputMessageParamArray: OpenAI::Internal::Type::Converter
           end
 
+          type prompt_cache_options =
+            {
+              ?ttl: OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::ttl
+            }
+
+          class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            attr_reader ttl: OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::ttl?
+
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            def ttl=: (
+              OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::ttl
+            ) -> OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::ttl
+
+            # @param ttl
+            #   Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            def initialize: (
+              ?ttl: OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::ttl
+            ) -> void
+
+            def to_hash: -> {
+              ?ttl: OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::ttl
+            }
+
+            type ttl = :"30m" | :"12h"
+
+            module Ttl
+              extend OpenAI::Internal::Type::Enum
+
+              TTL_30M: :"30m"
+              TTL_12H: :"12h"
+
+              def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::SessionCreateParams::PromptCacheOptions::ttl]
+            end
+          end
+
           type review = :none | :auto_review
 
           module Review
@@ -319,6 +378,25 @@ module OpenAI
 
             def to_hash: -> { limit: Integer? }
           end
+
+          type stream_options = { ?include_obfuscation: bool }
+
+          class StreamOptions < OpenAI::Internal::Type::BaseModel
+            # Whether to include obfuscation padding in events on this connection. Defaults to
+            # `true`.
+            attr_reader include_obfuscation: bool?
+
+            # Whether to include obfuscation padding in events on this connection. Defaults to
+            # `true`.
+            def include_obfuscation=: (bool) -> bool
+
+            # @param include_obfuscation
+            #   Whether to include obfuscation padding in events on this connection. Defaults to
+            #   `true`.
+            def initialize: (?include_obfuscation: bool) -> void
+
+            def to_hash: -> { ?include_obfuscation: bool }
+          end
         end
       end
     end

data/sig/openai/models/beta/agents/session_update_params.rbs

@@ -7,6 +7,7 @@ module OpenAI
             session_id: String,
             ?agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent,
             ?metadata: ::Hash[Symbol, String]?,
+            ?prompt_cache_options: OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions?,
             ?review: OpenAI::Models::Beta::Agents::SessionUpdateParams::review,
             ?spend_control: OpenAI::Beta::Agents::SessionUpdateParams::SpendControl?,
             ?request_options: OpenAI::request_opts
@@ -31,6 +32,10 @@ module OpenAI
           # characters.
           attr_accessor metadata: ::Hash[Symbol, String]?
 
+          # Default prompt cache lifetime for future turns. Send null to clear the session
+          # default.
+          attr_accessor prompt_cache_options: OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions?
+
           # Default action review for new root turns. Existing turns and their subagents
           # keep their review mode.
           attr_reader review: OpenAI::Models::Beta::Agents::SessionUpdateParams::review?
@@ -51,6 +56,9 @@ module OpenAI
           #   Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it.
           #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #   characters.
+          # @param prompt_cache_options
+          #   Default prompt cache lifetime for future turns. Send null to clear the session
+          #   default.
           # @param review
           #   Default action review for new root turns. Existing turns and their subagents
           #   keep their review mode.
@@ -61,6 +69,7 @@ module OpenAI
             session_id: String,
             ?agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent,
             ?metadata: ::Hash[Symbol, String]?,
+            ?prompt_cache_options: OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions?,
             ?review: OpenAI::Models::Beta::Agents::SessionUpdateParams::review,
             ?spend_control: OpenAI::Beta::Agents::SessionUpdateParams::SpendControl?,
             ?request_options: OpenAI::request_opts
@@ -70,6 +79,7 @@ module OpenAI
             session_id: String,
             ?agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent,
             ?metadata: ::Hash[Symbol, String]?,
+            ?prompt_cache_options: OpenAI::Beta::Agents::SessionUpdateParams::PromptCacheOptions?,
             ?review: OpenAI::Models::Beta::Agents::SessionUpdateParams::review,
             ?spend_control: OpenAI::Beta::Agents::SessionUpdateParams::SpendControl?,
             ?request_options: OpenAI::RequestOptions
@@ -195,6 +205,42 @@ module OpenAI
             end
           end
 
+          type prompt_cache_options =
+            {
+              ?ttl: OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::ttl
+            }
+
+          class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            attr_reader ttl: OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::ttl?
+
+            # Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            def ttl=: (
+              OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::ttl
+            ) -> OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::ttl
+
+            # @param ttl
+            #   Minimum lifetime for new prompt cache entries. Defaults to 30 minutes.
+            def initialize: (
+              ?ttl: OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::ttl
+            ) -> void
+
+            def to_hash: -> {
+              ?ttl: OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::ttl
+            }
+
+            type ttl = :"30m" | :"12h"
+
+            module Ttl
+              extend OpenAI::Internal::Type::Enum
+
+              TTL_30M: :"30m"
+              TTL_12H: :"12h"
+
+              def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::SessionUpdateParams::PromptCacheOptions::ttl]
+            end
+          end
+
           type review = :none | :auto_review
 
           module Review

data/sig/openai/models/beta/agents/sessions/event_stream_params.rbs

@@ -4,7 +4,11 @@ module OpenAI
       module Agents
         module Sessions
           type event_stream_params =
-            { session_id: String, ?request_options: OpenAI::request_opts }
+            {
+              session_id: String,
+              ?include_obfuscation: bool,
+              ?request_options: OpenAI::request_opts
+            }
 
           class EventStreamParams < OpenAI::Internal::Type::BaseModel
             extend OpenAI::Internal::Type::RequestParameters::Converter
@@ -12,13 +16,26 @@ module OpenAI
 
             attr_accessor session_id: String
 
+            # Whether to include obfuscation padding in events on this connection. Defaults to
+            # `true`.
+            attr_reader include_obfuscation: bool?
+
+            # Whether to include obfuscation padding in events on this connection. Defaults to
+            # `true`.
+            def include_obfuscation=: (bool) -> bool
+
+            # @param include_obfuscation
+            #   Whether to include obfuscation padding in events on this connection. Defaults to
+            #   `true`.
             def initialize: (
               session_id: String,
+              ?include_obfuscation: bool,
               ?request_options: OpenAI::request_opts
             ) -> void
 
             def to_hash: -> {
               session_id: String,
+              ?include_obfuscation: bool,
               ?request_options: OpenAI::RequestOptions
             }
           end

data/sig/openai/models/beta/agents/sessions/turn.rbs

@@ -15,7 +15,8 @@ module OpenAI
               started_at: Integer?,
               status: OpenAI::Models::Beta::Agents::Sessions::Turn::status,
               subagent_id: String?,
-              usage: OpenAI::Beta::TokenUsage?
+              usage: OpenAI::Beta::TokenUsage?,
+              ?prompt_cache_options: OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions?
             }
 
           class Turn < OpenAI::Internal::Type::BaseModel
@@ -55,6 +56,10 @@ module OpenAI
             # change.
             attr_accessor usage: OpenAI::Beta::TokenUsage?
 
+            # 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.
+            attr_accessor prompt_cache_options: OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions?
+
             # @param id
             #   The ID of the turn.
             # @param agent_id
@@ -78,6 +83,9 @@ module OpenAI
             # @param usage
             #   Best-effort token usage for the turn, or null if unknown. Recorded usage may
             #   change.
+            # @param 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.
             # @param object
             #   The object type. Always `agent.session.turn`.
             def initialize: (
@@ -91,6 +99,7 @@ module OpenAI
               status: OpenAI::Models::Beta::Agents::Sessions::Turn::status,
               subagent_id: String?,
               usage: OpenAI::Beta::TokenUsage?,
+              ?prompt_cache_options: OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions?,
               ?object: :"agent.session.turn"
             ) -> void
 
@@ -105,7 +114,8 @@ module OpenAI
               started_at: Integer?,
               status: OpenAI::Models::Beta::Agents::Sessions::Turn::status,
               subagent_id: String?,
-              usage: OpenAI::Beta::TokenUsage?
+              usage: OpenAI::Beta::TokenUsage?,
+              ?prompt_cache_options: OpenAI::Beta::Agents::Sessions::Turn::PromptCacheOptions?
             }
 
             type status =
@@ -139,6 +149,34 @@ module OpenAI
 
               def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::Sessions::Turn::status]
             end
+
+            type prompt_cache_options =
+              {
+                ttl: OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions::ttl
+              }
+
+            class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+              attr_accessor ttl: OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions::ttl
+
+              def initialize: (
+                ttl: OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions::ttl
+              ) -> void
+
+              def to_hash: -> {
+                ttl: OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions::ttl
+              }
+
+              type ttl = :"30m" | :"12h"
+
+              module Ttl
+                extend OpenAI::Internal::Type::Enum
+
+                TTL_30M: :"30m"
+                TTL_12H: :"12h"
+
+                def self?.values: -> ::Array[OpenAI::Models::Beta::Agents::Sessions::Turn::PromptCacheOptions::ttl]
+              end
+            end
           end
         end
       end

data/sig/openai/models/beta/beta_response.rbs

@@ -336,7 +336,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.
         attr_accessor truncation: OpenAI::Models::Beta::BetaResponse::truncation?
@@ -564,7 +566,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.
         # @param usage

data/sig/openai/models/beta/beta_response_tool_search_output_item_param.rbs

@@ -772,7 +772,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.
@@ -782,7 +783,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.
@@ -920,7 +922,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/sig/openai/models/beta/beta_responses_client_event.rbs

@@ -415,7 +415,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.
           attr_accessor truncation: OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::truncation?
@@ -663,7 +665,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.
           # @param user

data/sig/openai/models/beta/beta_tool.rbs

@@ -697,7 +697,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.
@@ -707,7 +708,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.
@@ -845,7 +847,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/sig/openai/models/beta/response_create_params.rbs

@@ -373,7 +373,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.
         attr_accessor truncation: OpenAI::Models::Beta::ResponseCreateParams::truncation?
@@ -610,7 +612,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.
         # @param user

data/sig/openai/models/beta/responses/input_token_count_params.rbs

@@ -92,18 +92,26 @@ module OpenAI
           # specify which tool to use by setting the `tool_choice` parameter.
           attr_accessor tools: ::Array[OpenAI::Models::Beta::beta_tool]?
 
-          # 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.
           attr_reader truncation: 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.
           def truncation=: (
             OpenAI::Models::Beta::Responses::InputTokenCountParams::truncation
           ) -> OpenAI::Models::Beta::Responses::InputTokenCountParams::truncation
@@ -158,11 +166,15 @@ module OpenAI
           #   An array of tools the model may call while generating a response. You can
           #   specify which tool to use by setting the `tool_choice` parameter.
           # @param 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.
           def initialize: (
             ?conversation: OpenAI::Models::Beta::Responses::InputTokenCountParams::conversation?,
             ?input: OpenAI::Models::Beta::Responses::InputTokenCountParams::input?,

data/sig/openai/models/content_provenance_check_create_params.rbs

@@ -11,6 +11,7 @@ module OpenAI
       include OpenAI::Internal::Type::RequestParameters
 
       # The image or audio file to check for supported OpenAI provenance signals.
+      # Supported image formats are PNG, JPEG, WebP, and GIF (including animated GIFs).
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -19,6 +20,7 @@ module OpenAI
 
       # @param file
       #   The image or audio file to check for supported OpenAI provenance signals.
+      #   Supported image formats are PNG, JPEG, WebP, and GIF (including animated GIFs).
       #
       #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
       #   metadata. Use `OpenAI::FilePart` when you need to override the filename or