openai 0.113.0 → 0.115.0

data/lib/openai/models/admin/organization/external_key_create_params.rb

@@ -0,0 +1,311 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        # @see OpenAI::Resources::Admin::Organization::ExternalKeys#create
+        class ExternalKeyCreateParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute body
+          #
+          #   @return [OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Aws, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Gcp, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Azure]
+          required :body, union: -> { OpenAI::Admin::Organization::ExternalKeyCreateParams::Body }
+
+          # @!method initialize(body:, request_options: {})
+          #   @param body [OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Aws, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Gcp, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Azure]
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+          module Body
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            variant :aws, -> { OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Aws }
+
+            variant :gcp, -> { OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Gcp }
+
+            variant :azure, -> { OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure }
+
+            class Aws < OpenAI::Internal::Type::BaseModel
+              # @!attribute external_id
+              #   The ExternalID that OpenAI will pass in the AssumeRole call for the customer's
+              #   AWS account. This must be the OpenAI organization ID or an API project ID that
+              #   belongs to the organization.
+              #
+              #   @return [String]
+              required :external_id, String
+
+              # @!attribute kms_arn
+              #   The Key Management System ARN for the master key you manage
+              #
+              #   @return [String]
+              required :kms_arn, String
+
+              # @!attribute name
+              #   A friendly name to identify this config
+              #
+              #   @return [String]
+              required :name, String
+
+              # @!attribute role_arn
+              #   The Role ARN that OpenAI will assume to call your KMS
+              #
+              #   @return [String]
+              required :role_arn, String
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :aws]
+              required :type, const: :aws
+
+              # @!attribute purpose
+              #
+              #   @return [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Aws::Purpose, nil]
+              optional :purpose, enum: -> { OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Aws::Purpose }
+
+              # @!method initialize(external_id:, kms_arn:, name:, role_arn:, purpose: nil, type: :aws)
+              #   @param external_id [String]
+              #     The ExternalID that OpenAI will pass in the AssumeRole call for the customer's
+              #     AWS account. This must be the OpenAI organization ID or an API project ID that
+              #     belongs to the organization.
+              #
+              #   @param kms_arn [String]
+              #     The Key Management System ARN for the master key you manage
+              #
+              #   @param name [String]
+              #     A friendly name to identify this config
+              #
+              #   @param role_arn [String]
+              #     The Role ARN that OpenAI will assume to call your KMS
+              #
+              #   @param purpose [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Aws::Purpose]
+              #
+              #   @param type [Symbol, :aws]
+
+              # @see OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Aws#purpose
+              module Purpose
+                extend OpenAI::Internal::Type::Enum
+
+                EKM = :ekm
+                PSP_DECRYPTION = :psp_decryption
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            class Gcp < OpenAI::Internal::Type::BaseModel
+              # @!attribute audience
+              #   The aud field in the identity token OpenAI will pass in the call to the
+              #   customer's GCP STS. This must be the OpenAI organization ID or an API project ID
+              #   that belongs to the organization.
+              #
+              #   @return [String]
+              required :audience, String
+
+              # @!attribute kms_key_location
+              #   The region where your Key Management System master key is located
+              #
+              #   @return [String]
+              required :kms_key_location, String
+
+              # @!attribute kms_key_name
+              #   The name of the Key Management System master key you manage
+              #
+              #   @return [String]
+              required :kms_key_name, String
+
+              # @!attribute kms_key_ring_name
+              #   The Key Management System key ring for the master key you manage
+              #
+              #   @return [String]
+              required :kms_key_ring_name, String
+
+              # @!attribute kms_project_id
+              #   The string GCP project name where your KMS resides
+              #
+              #   @return [String]
+              required :kms_project_id, String
+
+              # @!attribute name
+              #   A friendly name to identify this config
+              #
+              #   @return [String]
+              required :name, String
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :gcp]
+              required :type, const: :gcp
+
+              # @!attribute workload_identity_pool_id
+              #   The pool containing the Workload Identity provider that you registered for
+              #   OpenAI
+              #
+              #   @return [String]
+              required :workload_identity_pool_id, String
+
+              # @!attribute workload_identity_project_number
+              #   The numeric GCP project number where you registered OpenAI's workload identity
+              #
+              #   @return [String]
+              required :workload_identity_project_number, String
+
+              # @!attribute workload_identity_provider_id
+              #   The Workload Identity provider that you registered for OpenAI
+              #
+              #   @return [String]
+              required :workload_identity_provider_id, String
+
+              # @!attribute kms_key_version
+              #   An exact CryptoKeyVersion number. Required for PSP decryption; not accepted for
+              #   EKM.
+              #
+              #   @return [String, nil]
+              optional :kms_key_version, String
+
+              # @!attribute purpose
+              #
+              #   @return [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Gcp::Purpose, nil]
+              optional :purpose, enum: -> { OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Gcp::Purpose }
+
+              # @!method initialize(audience:, kms_key_location:, kms_key_name:, kms_key_ring_name:, kms_project_id:, name:, workload_identity_pool_id:, workload_identity_project_number:, workload_identity_provider_id:, kms_key_version: nil, purpose: nil, type: :gcp)
+              #   @param audience [String]
+              #     The aud field in the identity token OpenAI will pass in the call to the
+              #     customer's GCP STS. This must be the OpenAI organization ID or an API project ID
+              #     that belongs to the organization.
+              #
+              #   @param kms_key_location [String]
+              #     The region where your Key Management System master key is located
+              #
+              #   @param kms_key_name [String]
+              #     The name of the Key Management System master key you manage
+              #
+              #   @param kms_key_ring_name [String]
+              #     The Key Management System key ring for the master key you manage
+              #
+              #   @param kms_project_id [String]
+              #     The string GCP project name where your KMS resides
+              #
+              #   @param name [String]
+              #     A friendly name to identify this config
+              #
+              #   @param workload_identity_pool_id [String]
+              #     The pool containing the Workload Identity provider that you registered for
+              #     OpenAI
+              #
+              #   @param workload_identity_project_number [String]
+              #     The numeric GCP project number where you registered OpenAI's workload identity
+              #
+              #   @param workload_identity_provider_id [String]
+              #     The Workload Identity provider that you registered for OpenAI
+              #
+              #   @param kms_key_version [String]
+              #     An exact CryptoKeyVersion number. Required for PSP decryption; not accepted for
+              #     EKM.
+              #
+              #   @param purpose [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Gcp::Purpose]
+              #
+              #   @param type [Symbol, :gcp]
+
+              # @see OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Gcp#purpose
+              module Purpose
+                extend OpenAI::Internal::Type::Enum
+
+                EKM = :ekm
+                PSP_DECRYPTION = :psp_decryption
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            class Azure < OpenAI::Internal::Type::BaseModel
+              # @!attribute key_name
+              #   The name of the Azure Key Vault master key that you manage
+              #
+              #   @return [String]
+              required :key_name, String
+
+              # @!attribute name
+              #   A friendly name to identify this config
+              #
+              #   @return [String]
+              required :name, String
+
+              # @!attribute tenant_id
+              #   Your Azure tenant UUID
+              #
+              #   @return [String]
+              required :tenant_id, String
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :azure]
+              required :type, const: :azure
+
+              # @!attribute vault_uri
+              #   The URI of the Azure vault containing the master key you manage
+              #
+              #   @return [String]
+              required :vault_uri, String
+
+              # @!attribute key_version
+              #   An exact Azure Key Vault key version. Required for PSP decryption; not accepted
+              #   for EKM.
+              #
+              #   @return [String, nil]
+              optional :key_version, String
+
+              # @!attribute purpose
+              #
+              #   @return [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Azure::Purpose, nil]
+              optional(
+                :purpose,
+                enum: -> { OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure::Purpose }
+              )
+
+              # @!method initialize(key_name:, name:, tenant_id:, vault_uri:, key_version: nil, purpose: nil, type: :azure)
+              #   @param key_name [String]
+              #     The name of the Azure Key Vault master key that you manage
+              #
+              #   @param name [String]
+              #     A friendly name to identify this config
+              #
+              #   @param tenant_id [String]
+              #     Your Azure tenant UUID
+              #
+              #   @param vault_uri [String]
+              #     The URI of the Azure vault containing the master key you manage
+              #
+              #   @param key_version [String]
+              #     An exact Azure Key Vault key version. Required for PSP decryption; not accepted
+              #     for EKM.
+              #
+              #   @param purpose [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Azure::Purpose]
+              #
+              #   @param type [Symbol, :azure]
+
+              # @see OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Azure#purpose
+              module Purpose
+                extend OpenAI::Internal::Type::Enum
+
+                EKM = :ekm
+                PSP_DECRYPTION = :psp_decryption
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Aws, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Gcp, OpenAI::Models::Admin::Organization::ExternalKeyCreateParams::Body::Azure)]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/external_key_delete_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        # @see OpenAI::Resources::Admin::Organization::ExternalKeys#delete
+        class ExternalKeyDeleteParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute external_key_id
+          #
+          #   @return [String]
+          required :external_key_id, String
+
+          # @!method initialize(external_key_id:, request_options: {})
+          #   @param external_key_id [String]
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/external_key_list_params.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        # @see OpenAI::Resources::Admin::Organization::ExternalKeys#list
+        class ExternalKeyListParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute after
+          #
+          #   @return [String, nil]
+          optional :after, String, nil?: true
+
+          # @!attribute limit
+          #
+          #   @return [Integer, nil]
+          optional :limit, Integer
+
+          # @!attribute order
+          #
+          #   @return [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyListParams::Order, nil]
+          optional :order, enum: -> { OpenAI::Admin::Organization::ExternalKeyListParams::Order }
+
+          # @!attribute purpose
+          #   Filter by key purpose. When omitted, returns keys of all purposes.
+          #
+          #   @return [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyListParams::Purpose, nil]
+          optional :purpose, enum: -> { OpenAI::Admin::Organization::ExternalKeyListParams::Purpose }
+
+          # @!method initialize(after: nil, limit: nil, order: nil, purpose: nil, request_options: {})
+          #   @param after [String, nil]
+          #
+          #   @param limit [Integer]
+          #
+          #   @param order [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyListParams::Order]
+          #
+          #   @param purpose [Symbol, OpenAI::Models::Admin::Organization::ExternalKeyListParams::Purpose]
+          #     Filter by key purpose. When omitted, returns keys of all purposes.
+          #
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+          module Order
+            extend OpenAI::Internal::Type::Enum
+
+            ASC = :asc
+            DESC = :desc
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # Filter by key purpose. When omitted, returns keys of all purposes.
+          module Purpose
+            extend OpenAI::Internal::Type::Enum
+
+            EKM = :ekm
+            PSP_DECRYPTION = :psp_decryption
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/external_key_retrieve_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        # @see OpenAI::Resources::Admin::Organization::ExternalKeys#retrieve
+        class ExternalKeyRetrieveParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute external_key_id
+          #
+          #   @return [String]
+          required :external_key_id, String
+
+          # @!method initialize(external_key_id:, request_options: {})
+          #   @param external_key_id [String]
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/external_key_validate_params.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        # @see OpenAI::Resources::Admin::Organization::ExternalKeys#validate
+        class ExternalKeyValidateParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute external_key_id
+          #
+          #   @return [String]
+          required :external_key_id, String
+
+          # @!method initialize(external_key_id:, request_options: {})
+          #   @param external_key_id [String]
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/admin/organization/external_key_validate_response.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Admin
+      module Organization
+        # @see OpenAI::Resources::Admin::Organization::ExternalKeys#validate
+        class ExternalKeyValidateResponse < OpenAI::Internal::Type::BaseModel
+          # @!attribute status
+          #
+          #   @return [String]
+          required :status, String
+
+          # @!method initialize(status:)
+          #   @param status [String]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/audio/speech_model.rb

@@ -6,9 +6,21 @@ module OpenAI
       module SpeechModel
         extend OpenAI::Internal::Type::Enum
 
+        # @deprecated Announced shutdown date: 2027-01-06. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         TTS_1 = :"tts-1"
+        # @deprecated Announced shutdown date: 2027-01-06. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         TTS_1_HD = :"tts-1-hd"
+        # @deprecated Announced shutdown date: 2027-01-06. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         GPT_4O_MINI_TTS = :"gpt-4o-mini-tts"
+        # @deprecated Announced shutdown date: 2027-01-06. See
+        # https://developers.openai.com/api/docs/deprecations for details and recommended
+        # replacements.
         GPT_4O_MINI_TTS_2025_12_15 = :"gpt-4o-mini-tts-2025-12-15"
 
         # @!method self.values

data/lib/openai/models/audio_model.rb

@@ -5,11 +5,26 @@ module OpenAI
     module AudioModel
       extend OpenAI::Internal::Type::Enum
 
+      # @deprecated Announced shutdown date: 2027-02-26. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       WHISPER_1 = :"whisper-1"
       GPT_TRANSCRIBE = :"gpt-transcribe"
+      # @deprecated Announced shutdown date: 2027-02-26. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O_TRANSCRIBE = :"gpt-4o-transcribe"
+      # @deprecated Announced shutdown date: 2027-02-26. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O_MINI_TRANSCRIBE = :"gpt-4o-mini-transcribe"
+      # @deprecated Announced shutdown date: 2027-02-26. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O_MINI_TRANSCRIBE_2025_12_15 = :"gpt-4o-mini-transcribe-2025-12-15"
+      # @deprecated Announced shutdown date: 2027-02-26. See
+      # https://developers.openai.com/api/docs/deprecations for details and recommended
+      # replacements.
       GPT_4O_TRANSCRIBE_DIARIZE = :"gpt-4o-transcribe-diarize"
 
       # @!method self.values

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

@@ -84,7 +84,19 @@ module OpenAI
         #   @return [Integer]
         required :updated_at, Integer
 
-        # @!method initialize(id:, created_at:, instructions:, metadata:, model:, multi_agent:, name:, reasoning:, service_tier:, text:, tools:, updated_at:, object: :agent)
+        # @!attribute compaction
+        #   The effective context compaction settings.
+        #
+        #   @return [OpenAI::Models::Beta::Agent::Compaction, nil]
+        optional :compaction, -> { OpenAI::Beta::Agent::Compaction }
+
+        # @!attribute experimental
+        #   The effective experimental settings for the agent.
+        #
+        #   @return [OpenAI::Models::Beta::Agent::Experimental, nil]
+        optional :experimental, -> { OpenAI::Beta::Agent::Experimental }
+
+        # @!method initialize(id:, created_at:, instructions:, metadata:, model:, multi_agent:, name:, reasoning:, service_tier:, text:, tools:, updated_at:, compaction: nil, experimental: nil, object: :agent)
         #   A reusable agent scoped to the caller's project.
         #
         #   @param id [String]
@@ -124,6 +136,12 @@ module OpenAI
         #   @param updated_at [Integer]
         #     The Unix timestamp, in seconds, when the agent was last updated.
         #
+        #   @param compaction [OpenAI::Models::Beta::Agent::Compaction]
+        #     The effective context compaction settings.
+        #
+        #   @param experimental [OpenAI::Models::Beta::Agent::Experimental]
+        #     The effective experimental settings for the agent.
+        #
         #   @param object [Symbol, :agent]
         #     The object type. Always `agent`.
 
@@ -143,6 +161,36 @@ module OpenAI
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # @see OpenAI::Models::Beta::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::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
     end
   end

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

@@ -14,6 +14,18 @@ module OpenAI
         #   @return [String]
         required :model, String
 
+        # @!attribute compaction
+        #   Context compaction settings. Omission or null enables background compaction.
+        #
+        #   @return [OpenAI::Models::Beta::AgentCreateParams::Compaction, nil]
+        optional :compaction, -> { OpenAI::Beta::AgentCreateParams::Compaction }, nil?: true
+
+        # @!attribute experimental
+        #   Experimental agent settings. All experimental features default to disabled.
+        #
+        #   @return [OpenAI::Models::Beta::AgentCreateParams::Experimental, nil]
+        optional :experimental, -> { OpenAI::Beta::AgentCreateParams::Experimental }
+
         # @!attribute instructions
         #   Additional instructions appended to the agent's default base instructions. Omit
         #   or set to null to add no custom instructions.
@@ -71,10 +83,16 @@ module OpenAI
           nil?: true
         )
 
-        # @!method initialize(model:, instructions: nil, metadata: nil, multi_agent: nil, name: nil, reasoning: nil, service_tier: nil, text: nil, tools: nil, request_options: {})
+        # @!method initialize(model:, compaction: nil, experimental: nil, instructions: nil, metadata: nil, multi_agent: nil, name: nil, reasoning: nil, service_tier: nil, text: nil, tools: nil, request_options: {})
         #   @param model [String]
         #     The model to use for the agent. The requested model name is preserved.
         #
+        #   @param compaction [OpenAI::Models::Beta::AgentCreateParams::Compaction, nil]
+        #     Context compaction settings. Omission or null enables background compaction.
+        #
+        #   @param experimental [OpenAI::Models::Beta::AgentCreateParams::Experimental]
+        #     Experimental agent settings. All experimental features default to disabled.
+        #
         #   @param instructions [String, nil]
         #     Additional instructions appended to the agent's default base instructions. Omit
         #     or set to null to add no custom instructions.
@@ -106,6 +124,38 @@ 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. Omission or null 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. Defaults to false.
+          #
+          #   @return [Boolean, nil]
+          optional :time_awareness, OpenAI::Internal::Type::Boolean
+
+          # @!method initialize(time_awareness: nil)
+          #   Experimental agent settings. All experimental features default to disabled.
+          #
+          #   @param time_awareness [Boolean]
+          #     Whether to give the model periodic current-time reminders. Defaults to false.
+        end
+
         # The service tier used for model requests. Defaults to `auto`.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum