openai 0.114.0 → 0.115.1

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

@@ -80,6 +80,13 @@ module OpenAI
         #   @return [Array<String>]
         required :vault_ids, OpenAI::Internal::Type::ArrayOf[String]
 
+        # @!attribute review
+        #   Review applied to eligible actions in this session. Omitted when review is none
+        #   and automatic review is not enabled. Omission means none.
+        #
+        #   @return [Symbol, OpenAI::Models::Beta::AgentSession::Review, nil]
+        optional :review, enum: -> { OpenAI::Beta::AgentSession::Review }
+
         # @!attribute spend_control
         #   Configured spending limit and best-effort consumption, in USD cents. Unlimited
         #   sessions omit this object.
@@ -87,7 +94,7 @@ module OpenAI
         #   @return [OpenAI::Models::Beta::AgentSession::SpendControl, nil]
         optional :spend_control, -> { OpenAI::Beta::AgentSession::SpendControl }
 
-        # @!method initialize(id:, agent:, created_at:, environment:, error:, last_active_at:, metadata:, required_actions:, status:, usage:, vault_ids:, spend_control: nil, object: :"agent.session")
+        # @!method initialize(id:, agent:, created_at:, environment:, error:, last_active_at:, metadata:, required_actions:, status:, usage:, vault_ids:, review: nil, spend_control: nil, object: :"agent.session")
         #   A Managed Agents session.
         #
         #   @param id [String]
@@ -124,6 +131,10 @@ module OpenAI
         #   @param vault_ids [Array<String>]
         #     The IDs of vaults made available to the session.
         #
+        #   @param review [Symbol, OpenAI::Models::Beta::AgentSession::Review]
+        #     Review applied to eligible actions in this session. Omitted when review is none
+        #     and automatic review is not enabled. Omission means none.
+        #
         #   @param spend_control [OpenAI::Models::Beta::AgentSession::SpendControl]
         #     Configured spending limit and best-effort consumption, in USD cents. Unlimited
         #     sessions omit this object.
@@ -188,7 +199,19 @@ module OpenAI
           #   @return [Array<OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse, OpenAI::Models::Beta::AgentTool::Automations>]
           required :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentTool] }
 
-          # @!method initialize(id:, instructions:, model:, multi_agent:, name:, reasoning:, service_tier:, text:, tools:)
+          # @!attribute compaction
+          #   The effective context compaction settings.
+          #
+          #   @return [OpenAI::Models::Beta::AgentSession::Agent::Compaction, nil]
+          optional :compaction, -> { OpenAI::Beta::AgentSession::Agent::Compaction }
+
+          # @!attribute experimental
+          #   The effective experimental settings for the agent.
+          #
+          #   @return [OpenAI::Models::Beta::AgentSession::Agent::Experimental, nil]
+          optional :experimental, -> { OpenAI::Beta::AgentSession::Agent::Experimental }
+
+          # @!method initialize(id:, instructions:, model:, multi_agent:, name:, reasoning:, service_tier:, text:, tools:, compaction: nil, experimental: nil)
           #   The agent running in the session.
           #
           #   @param id [String]
@@ -218,6 +241,12 @@ module OpenAI
           #
           #   @param tools [Array<OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse, OpenAI::Models::Beta::AgentTool::Automations>]
           #     Tools available to the agent.
+          #
+          #   @param compaction [OpenAI::Models::Beta::AgentSession::Agent::Compaction]
+          #     The effective context compaction settings.
+          #
+          #   @param experimental [OpenAI::Models::Beta::AgentSession::Agent::Experimental]
+          #     The effective experimental settings for the agent.
 
           # The effective service-tier policy for model requests. Defaults to `auto`.
           #
@@ -235,6 +264,36 @@ module OpenAI
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # @see OpenAI::Models::Beta::AgentSession::Agent#compaction
+          class Compaction < OpenAI::Internal::Type::BaseModel
+            # @!attribute async
+            #   Whether context is compacted in the background. Defaults to true.
+            #
+            #   @return [Boolean]
+            required :async, OpenAI::Internal::Type::Boolean
+
+            # @!method initialize(async:)
+            #   The effective context compaction settings.
+            #
+            #   @param async [Boolean]
+            #     Whether context is compacted in the background. Defaults to true.
+          end
+
+          # @see OpenAI::Models::Beta::AgentSession::Agent#experimental
+          class Experimental < OpenAI::Internal::Type::BaseModel
+            # @!attribute time_awareness
+            #   Whether the model receives periodic current-time reminders.
+            #
+            #   @return [Boolean]
+            required :time_awareness, OpenAI::Internal::Type::Boolean
+
+            # @!method initialize(time_awareness:)
+            #   The effective experimental settings for the agent.
+            #
+            #   @param time_awareness [Boolean]
+            #     Whether the model receives periodic current-time reminders.
+          end
         end
 
         # An action that must be completed before a session can continue.
@@ -594,6 +653,20 @@ module OpenAI
           #   @return [Array<Symbol>]
         end
 
+        # Review applied to eligible actions in this session. Omitted when review is none
+        # and automatic review is not enabled. Omission means none.
+        #
+        # @see OpenAI::Models::Beta::AgentSession#review
+        module Review
+          extend OpenAI::Internal::Type::Enum
+
+          NONE = :none
+          AUTO_REVIEW = :auto_review
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see OpenAI::Models::Beta::AgentSession#spend_control
         class SpendControl < OpenAI::Internal::Type::BaseModel
           # @!attribute consumed

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

@@ -13,6 +13,21 @@ module OpenAI
         #   @return [String]
         required :agent_id, String
 
+        # @!attribute compaction
+        #   Context compaction settings. Omit to keep the current settings. A supplied
+        #   object replaces the settings; null or an empty object enables background
+        #   compaction.
+        #
+        #   @return [OpenAI::Models::Beta::AgentUpdateParams::Compaction, nil]
+        optional :compaction, -> { OpenAI::Beta::AgentUpdateParams::Compaction }, nil?: true
+
+        # @!attribute experimental
+        #   Experimental settings to merge by key. Omitted settings keep their current
+        #   values.
+        #
+        #   @return [OpenAI::Models::Beta::AgentUpdateParams::Experimental, nil]
+        optional :experimental, -> { OpenAI::Beta::AgentUpdateParams::Experimental }
+
         # @!attribute instructions
         #   Additional instructions appended to the agent's default base instructions. Omit
         #   to leave unchanged.
@@ -76,9 +91,18 @@ module OpenAI
           nil?: true
         )
 
-        # @!method initialize(agent_id:, instructions: nil, metadata: nil, model: nil, multi_agent: nil, name: nil, reasoning: nil, service_tier: nil, text: nil, tools: nil, request_options: {})
+        # @!method initialize(agent_id:, compaction: nil, experimental: nil, instructions: nil, metadata: nil, model: nil, multi_agent: nil, name: nil, reasoning: nil, service_tier: nil, text: nil, tools: nil, request_options: {})
         #   @param agent_id [String]
         #
+        #   @param compaction [OpenAI::Models::Beta::AgentUpdateParams::Compaction, nil]
+        #     Context compaction settings. Omit to keep the current settings. A supplied
+        #     object replaces the settings; null or an empty object enables background
+        #     compaction.
+        #
+        #   @param experimental [OpenAI::Models::Beta::AgentUpdateParams::Experimental]
+        #     Experimental settings to merge by key. Omitted settings keep their current
+        #     values.
+        #
         #   @param instructions [String, nil]
         #     Additional instructions appended to the agent's default base instructions. Omit
         #     to leave unchanged.
@@ -113,6 +137,43 @@ module OpenAI
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
+        class Compaction < OpenAI::Internal::Type::BaseModel
+          # @!attribute async
+          #   Whether to compact context in the background. Omission or null defaults to true.
+          #   Set to false to use blocking compaction. Background compaction may increase
+          #   token usage.
+          #
+          #   @return [Boolean, nil]
+          optional :async, OpenAI::Internal::Type::Boolean, nil?: true
+
+          # @!method initialize(async: nil)
+          #   Context compaction settings. Omit to keep the current settings. A supplied
+          #   object replaces the settings; null or an empty object enables background
+          #   compaction.
+          #
+          #   @param async [Boolean, nil]
+          #     Whether to compact context in the background. Omission or null defaults to true.
+          #     Set to false to use blocking compaction. Background compaction may increase
+          #     token usage.
+        end
+
+        class Experimental < OpenAI::Internal::Type::BaseModel
+          # @!attribute time_awareness
+          #   Whether to give the model periodic current-time reminders. Omit to keep the
+          #   current setting.
+          #
+          #   @return [Boolean, nil]
+          optional :time_awareness, OpenAI::Internal::Type::Boolean
+
+          # @!method initialize(time_awareness: nil)
+          #   Experimental settings to merge by key. Omitted settings keep their current
+          #   values.
+          #
+          #   @param time_awareness [Boolean]
+          #     Whether to give the model periodic current-time reminders. Omit to keep the
+          #     current setting.
+        end
+
         # The service tier used for model requests.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum

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

@@ -47,6 +47,12 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+          # @!attribute review
+          #   Action review mode. Omit to use none.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review, nil]
+          optional :review, enum: -> { OpenAI::Beta::Agents::SessionCreateParams::Review }
+
           # @!attribute spend_control
           #   Optional spending limit in USD cents. Omission or null creates an unlimited
           #   session.
@@ -66,7 +72,7 @@ module OpenAI
           #   @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, spend_control: nil, vault_ids: nil, request_options: {})
+          # @!method initialize(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, review: nil, spend_control: 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.
           #
@@ -88,6 +94,9 @@ 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 review [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review]
+          #     Action review mode. Omit to use none.
+          #
           #   @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
           #     Optional spending limit in USD cents. Omission or null creates an unlimited
           #     session.
@@ -98,6 +107,27 @@ module OpenAI
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
           class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute compaction
+            #   Context compaction settings. Omit to keep the current settings. A supplied
+            #   object replaces the settings; null or an empty object enables background
+            #   compaction.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::Compaction, nil]
+            optional(
+              :compaction,
+              -> {
+                OpenAI::Beta::Agents::SessionCreateParams::Agent::Compaction
+              },
+              nil?: true
+            )
+
+            # @!attribute experimental
+            #   Experimental settings to merge by key. Omitted settings keep their current
+            #   values.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::Experimental, nil]
+            optional :experimental, -> { OpenAI::Beta::Agents::SessionCreateParams::Agent::Experimental }
+
             # @!attribute instructions
             #   Additional instructions appended to the agent's default base instructions. Omit
             #   to leave unchanged.
@@ -154,10 +184,19 @@ module OpenAI
               nil?: true
             )
 
-            # @!method initialize(instructions: nil, model: nil, multi_agent: nil, reasoning: nil, service_tier: nil, text: nil, tools: nil)
+            # @!method initialize(compaction: nil, experimental: nil, instructions: nil, model: nil, multi_agent: nil, reasoning: nil, service_tier: nil, text: nil, tools: nil)
             #   Agent configuration. With `agent_id`, supplied fields override the saved agent
             #   for this session. Without `agent_id`, `model` is required.
             #
+            #   @param compaction [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::Compaction, nil]
+            #     Context compaction settings. Omit to keep the current settings. A supplied
+            #     object replaces the settings; null or an empty object enables background
+            #     compaction.
+            #
+            #   @param experimental [OpenAI::Models::Beta::Agents::SessionCreateParams::Agent::Experimental]
+            #     Experimental settings to merge by key. Omitted settings keep their current
+            #     values.
+            #
             #   @param instructions [String, nil]
             #     Additional instructions appended to the agent's default base instructions. Omit
             #     to leave unchanged.
@@ -183,6 +222,45 @@ module OpenAI
             #     resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8
             #     JSON.
 
+            # @see OpenAI::Models::Beta::Agents::SessionCreateParams::Agent#compaction
+            class Compaction < OpenAI::Internal::Type::BaseModel
+              # @!attribute async
+              #   Whether to compact context in the background. Omission or null defaults to true.
+              #   Set to false to use blocking compaction. Background compaction may increase
+              #   token usage.
+              #
+              #   @return [Boolean, nil]
+              optional :async, OpenAI::Internal::Type::Boolean, nil?: true
+
+              # @!method initialize(async: nil)
+              #   Context compaction settings. Omit to keep the current settings. A supplied
+              #   object replaces the settings; null or an empty object enables background
+              #   compaction.
+              #
+              #   @param async [Boolean, nil]
+              #     Whether to compact context in the background. Omission or null defaults to true.
+              #     Set to false to use blocking compaction. Background compaction may increase
+              #     token usage.
+            end
+
+            # @see OpenAI::Models::Beta::Agents::SessionCreateParams::Agent#experimental
+            class Experimental < OpenAI::Internal::Type::BaseModel
+              # @!attribute time_awareness
+              #   Whether to give the model periodic current-time reminders. Omit to keep the
+              #   current setting.
+              #
+              #   @return [Boolean, nil]
+              optional :time_awareness, OpenAI::Internal::Type::Boolean
+
+              # @!method initialize(time_awareness: nil)
+              #   Experimental settings to merge by key. Omitted settings keep their current
+              #   values.
+              #
+              #   @param time_awareness [Boolean]
+              #     Whether to give the model periodic current-time reminders. Omit to keep the
+              #     current setting.
+            end
+
             # The service tier used for model requests.
             #
             # @see OpenAI::Models::Beta::Agents::SessionCreateParams::Agent#service_tier
@@ -232,6 +310,20 @@ module OpenAI
             ]
           end
 
+          # Action review mode. Omit to use none.
+          module Review
+            extend OpenAI::Internal::Type::Enum
+
+            # Keep the existing execution behavior without automatic action review.
+            NONE = :none
+
+            # Review eligible actions automatically. Deny manual approval fallbacks.
+            AUTO_REVIEW = :auto_review
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           class SpendControl < OpenAI::Internal::Type::BaseModel
             # @!attribute limit
             #   Positive USD cents, or null to remove the limit.

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

@@ -28,13 +28,22 @@ module OpenAI
           #   @return [Integer, nil]
           optional :limit, Integer
 
+          # @!attribute metadata
+          #   Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          #   match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          #   characters. New sessions and metadata updates may take time to appear in
+          #   filtered results.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :metadata, OpenAI::Internal::Type::HashOf[String]
+
           # @!attribute order
           #   The order in which resources are returned. Defaults to `desc`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order, nil]
           optional :order, enum: -> { OpenAI::Beta::Agents::SessionListParams::Order }
 
-          # @!method initialize(after: nil, agent_id: nil, limit: nil, order: nil, request_options: {})
+          # @!method initialize(after: nil, agent_id: nil, limit: nil, metadata: nil, order: nil, request_options: {})
           #   @param after [String]
           #     Return resources after this resource ID in the selected order.
           #
@@ -45,6 +54,12 @@ module OpenAI
           #   @param limit [Integer]
           #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
+          #   @param metadata [Hash{Symbol=>String}]
+          #     Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+          #     match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+          #     characters. New sessions and metadata updates may take time to appear in
+          #     filtered results.
+          #
           #   @param order [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order]
           #     The order in which resources are returned. Defaults to `desc`.
           #

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

@@ -15,7 +15,7 @@ module OpenAI
           required :session_id, String
 
           # @!attribute agent
-          #   Model settings for subsequent turns. Omitted fields stay unchanged.
+          #   Agent settings to update on this session. Omitted fields stay unchanged.
           #
           #   @return [OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent, nil]
           optional :agent, -> { OpenAI::Beta::Agents::SessionUpdateParams::Agent }
@@ -28,6 +28,13 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+          # @!attribute review
+          #   Default action review for new root turns. Existing turns and their subagents
+          #   keep their review mode.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::Review, nil]
+          optional :review, enum: -> { OpenAI::Beta::Agents::SessionUpdateParams::Review }
+
           # @!attribute spend_control
           #   Omit to retain the limit; null or a null limit removes it without resetting
           #   spend.
@@ -41,17 +48,21 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(session_id:, agent: nil, metadata: nil, spend_control: nil, request_options: {})
+          # @!method initialize(session_id:, agent: nil, metadata: nil, review: nil, spend_control: nil, request_options: {})
           #   @param session_id [String]
           #
           #   @param agent [OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent]
-          #     Model settings for subsequent turns. Omitted fields stay unchanged.
+          #     Agent settings to update on this session. Omitted fields stay unchanged.
           #
           #   @param metadata [Hash{Symbol=>String}, nil]
           #     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 review [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::Review]
+          #     Default action review for new root turns. Existing turns and their subagents
+          #     keep their review mode.
+          #
           #   @param spend_control [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
           #     Omit to retain the limit; null or a null limit removes it without resetting
           #     spend.
@@ -81,8 +92,22 @@ module OpenAI
               nil?: true
             )
 
-            # @!method initialize(model: nil, reasoning: nil, service_tier: nil)
-            #   Model settings for subsequent turns. Omitted fields stay unchanged.
+            # @!attribute tools
+            #   Replaces the session tools. Functions and MCP servers change on the next model
+            #   call. Built-in tools change by the next turn. Omit to keep the current tools, or
+            #   pass null or an empty array to clear them.
+            #
+            #   @return [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch, OpenAI::Models::Beta::AgentToolParam::ComputerUse, OpenAI::Models::Beta::AgentToolParam::Automations>, nil]
+            optional(
+              :tools,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentToolParam]
+              },
+              nil?: true
+            )
+
+            # @!method initialize(model: nil, reasoning: nil, service_tier: nil, tools: nil)
+            #   Agent settings to update on this session. Omitted fields stay unchanged.
             #
             #   @param model [String]
             #     The model for subsequent turns. Omit to keep the current model.
@@ -92,6 +117,11 @@ module OpenAI
             #
             #   @param service_tier [Symbol, OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent::ServiceTier, nil]
             #     Omit to keep the current tier. Null resets it to auto.
+            #
+            #   @param tools [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch, OpenAI::Models::Beta::AgentToolParam::ComputerUse, OpenAI::Models::Beta::AgentToolParam::Automations>, nil]
+            #     Replaces the session tools. Functions and MCP servers change on the next model
+            #     call. Built-in tools change by the next turn. Omit to keep the current tools, or
+            #     pass null or an empty array to clear them.
 
             # @see OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent#reasoning
             class Reasoning < OpenAI::Internal::Type::BaseModel
@@ -159,6 +189,21 @@ module OpenAI
             end
           end
 
+          # Default action review for new root turns. Existing turns and their subagents
+          # keep their review mode.
+          module Review
+            extend OpenAI::Internal::Type::Enum
+
+            # Keep the existing execution behavior without automatic action review.
+            NONE = :none
+
+            # Review eligible actions automatically. Deny manual approval fallbacks.
+            AUTO_REVIEW = :auto_review
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           class SpendControl < OpenAI::Internal::Type::BaseModel
             # @!attribute limit
             #   Positive USD cents, or null to remove the limit.

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

@@ -310,11 +310,29 @@ module OpenAI
 
           # @!group
 
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5 = :"gpt-5"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_MINI = :"gpt-5-mini"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_NANO = :"gpt-5-nano"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_2025_08_07 = :"gpt-5-2025-08-07"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_MINI_2025_08_07 = :"gpt-5-mini-2025-08-07"
+          # @deprecated Announced shutdown date: 2026-12-11. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_5_NANO_2025_08_07 = :"gpt-5-nano-2025-08-07"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended