openai 0.70.0 → 0.72.0

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

@@ -805,30 +805,32 @@ module OpenAI
             # @!attribute annotations
             #   Citations associated with the text content.
             #
-            #   @return [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>, nil]
+            #   @return [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation>, nil]
             optional :annotations,
-                     union: -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations }
+                     -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation] }
 
             # @!method initialize(text:, annotations: nil, type: :output_text)
             #   @param text [String] The text content.
             #
-            #   @param annotations [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>] Citations associated with the text content.
+            #   @param annotations [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation>] Citations associated with the text content.
             #
             #   @param type [Symbol, :output_text] The content type. Always `output_text`.
 
-            # Citations associated with the text content.
-            #
-            # @see OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output#annotations
-            module Annotations
+            module Annotation
               extend OpenAI::Internal::Type::Union
 
-              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0Array }
+              discriminator :type
+
+              variant :file_citation,
+                      -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation }
 
-              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1Array }
+              variant :url_citation,
+                      -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation }
 
-              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2Array }
+              variant :container_file_citation,
+                      -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation }
 
-              class UnionMember0 < OpenAI::Internal::Type::BaseModel
+              class FileCitation < OpenAI::Internal::Type::BaseModel
                 # @!attribute file_id
                 #   The ID of the file.
                 #
@@ -863,7 +865,7 @@ module OpenAI
                 #   @param type [Symbol, :file_citation] The citation type. Always `file_citation`.
               end
 
-              class UnionMember1 < OpenAI::Internal::Type::BaseModel
+              class URLCitation < OpenAI::Internal::Type::BaseModel
                 # @!attribute end_index
                 #   The index of the last character of the citation in the message.
                 #
@@ -906,7 +908,7 @@ module OpenAI
                 #   @param type [Symbol, :url_citation] The citation type. Always `url_citation`.
               end
 
-              class UnionMember2 < OpenAI::Internal::Type::BaseModel
+              class ContainerFileCitation < OpenAI::Internal::Type::BaseModel
                 # @!attribute container_id
                 #   The ID of the container.
                 #
@@ -958,25 +960,7 @@ module OpenAI
               end
 
               # @!method self.variants
-              #   @return [Array(Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>)]
-
-              # @type [OpenAI::Internal::Type::Converter]
-              UnionMember0Array =
-                OpenAI::Internal::Type::ArrayOf[-> {
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0
-                }]
-
-              # @type [OpenAI::Internal::Type::Converter]
-              UnionMember1Array =
-                OpenAI::Internal::Type::ArrayOf[-> {
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1
-                }]
-
-              # @type [OpenAI::Internal::Type::Converter]
-              UnionMember2Array =
-                OpenAI::Internal::Type::ArrayOf[-> {
-                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2
-                }]
+              #   @return [Array(OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::FileCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::URLCitation, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotation::ContainerFileCitation)]
             end
           end
 

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

@@ -25,7 +25,8 @@ module OpenAI
         # @!attribute verbosity
         #   Constrains the verbosity of the model's response. Lower values will result in
         #   more concise responses, while higher values will result in more verbose
-        #   responses. Currently supported values are `low`, `medium`, and `high`.
+        #   responses. Currently supported values are `low`, `medium`, and `high`. The
+        #   default is `medium`.
         #
         #   @return [Symbol, OpenAI::Models::Beta::BetaResponseTextConfig::Verbosity, nil]
         optional :verbosity, enum: -> { OpenAI::Beta::BetaResponseTextConfig::Verbosity }, nil?: true
@@ -46,7 +47,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         #
         # @see OpenAI::Models::Beta::BetaResponseTextConfig#verbosity
         module Verbosity

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

@@ -188,7 +188,7 @@ module OpenAI
           #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
           #
           #   @return [String, nil]
-          optional :prompt_cache_key, String
+          optional :prompt_cache_key, String, nil?: true
 
           # @!attribute prompt_cache_options
           #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -253,7 +253,7 @@ module OpenAI
           #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           #
           #   @return [String, nil]
-          optional :safety_identifier, String
+          optional :safety_identifier, String, nil?: true
 
           # @!attribute service_tier
           #   Specifies the processing type used for serving the request.
@@ -443,7 +443,7 @@ module OpenAI
           #
           #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
           #
-          #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+          #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
           #
           #   @param prompt_cache_options [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
           #
@@ -451,7 +451,7 @@ module OpenAI
           #
           #   @param reasoning [OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning, nil] **gpt-5 and o-series models only**
           #
-          #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+          #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
           #
           #   @param service_tier [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier, nil] Specifies the processing type used for serving the request.
           #
@@ -1102,7 +1102,10 @@ module OpenAI
           # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#reasoning
           class Reasoning < OpenAI::Internal::Type::BaseModel
             # @!attribute context
-            #   Controls which reasoning items are rendered back to the model on later turns.
+            #   Controls which reasoning items are rendered back to the model on later turns. If
+            #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             #   When returned on a response, this is the effective reasoning context mode used
             #   for the response.
             #
@@ -1181,7 +1184,10 @@ module OpenAI
             #
             #   @param summary [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             #

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

@@ -163,7 +163,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -223,7 +223,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -392,7 +392,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Beta::ResponseCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -400,7 +400,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Beta::ResponseCreateParams::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Beta::ResponseCreateParams::ServiceTier, nil] Specifies the processing type used for serving the request.
         #
@@ -1027,7 +1027,10 @@ module OpenAI
 
         class Reasoning < OpenAI::Internal::Type::BaseModel
           # @!attribute context
-          #   Controls which reasoning items are rendered back to the model on later turns.
+          #   Controls which reasoning items are rendered back to the model on later turns. If
+          #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           #   When returned on a response, this is the effective reasoning context mode used
           #   for the response.
           #
@@ -1097,7 +1100,10 @@ module OpenAI
           #
           #   @param summary [Symbol, OpenAI::Models::Beta::ResponseCreateParams::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-          # Controls which reasoning items are rendered back to the model on later turns.
+          # Controls which reasoning items are rendered back to the model on later turns. If
+          # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+          # model family defaults to `all_turns`; earlier models default to `current_turn`.
+          #
           # When returned on a response, this is the effective reasoning context mode used
           # for the response.
           #

data/lib/openai/models/beta/responses/input_token_count_params.rb

@@ -214,7 +214,10 @@ module OpenAI
 
           class Reasoning < OpenAI::Internal::Type::BaseModel
             # @!attribute context
-            #   Controls which reasoning items are rendered back to the model on later turns.
+            #   Controls which reasoning items are rendered back to the model on later turns. If
+            #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             #   When returned on a response, this is the effective reasoning context mode used
             #   for the response.
             #
@@ -289,7 +292,10 @@ module OpenAI
             #
             #   @param summary [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-            # Controls which reasoning items are rendered back to the model on later turns.
+            # Controls which reasoning items are rendered back to the model on later turns. If
+            # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+            # model family defaults to `all_turns`; earlier models default to `current_turn`.
+            #
             # When returned on a response, this is the effective reasoning context mode used
             # for the response.
             #
@@ -419,7 +425,8 @@ module OpenAI
             # @!attribute verbosity
             #   Constrains the verbosity of the model's response. Lower values will result in
             #   more concise responses, while higher values will result in more verbose
-            #   responses. Currently supported values are `low`, `medium`, and `high`.
+            #   responses. Currently supported values are `low`, `medium`, and `high`. The
+            #   default is `medium`.
             #
             #   @return [Symbol, OpenAI::Models::Beta::Responses::InputTokenCountParams::Text::Verbosity, nil]
             optional :verbosity,
@@ -442,7 +449,8 @@ module OpenAI
 
             # Constrains the verbosity of the model's response. Lower values will result in
             # more concise responses, while higher values will result in more verbose
-            # responses. Currently supported values are `low`, `medium`, and `high`.
+            # responses. Currently supported values are `low`, `medium`, and `high`. The
+            # default is `medium`.
             #
             # @see OpenAI::Models::Beta::Responses::InputTokenCountParams::Text#verbosity
             module Verbosity

data/lib/openai/models/chat/completion_create_params.rb

@@ -194,7 +194,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -271,7 +271,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute seed
         #   @deprecated
@@ -401,7 +401,8 @@ module OpenAI
         # @!attribute verbosity
         #   Constrains the verbosity of the model's response. Lower values will result in
         #   more concise responses, while higher values will result in more verbose
-        #   responses. Currently supported values are `low`, `medium`, and `high`.
+        #   responses. Currently supported values are `low`, `medium`, and `high`. The
+        #   default is `medium`.
         #
         #   @return [Symbol, OpenAI::Models::Chat::CompletionCreateParams::Verbosity, nil]
         optional :verbosity, enum: -> { OpenAI::Chat::CompletionCreateParams::Verbosity }, nil?: true
@@ -452,7 +453,7 @@ module OpenAI
         #
         #   @param presence_penalty [Float, nil] Number between -2.0 and 2.0. Positive values penalize new tokens based on
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Chat::CompletionCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -462,7 +463,7 @@ module OpenAI
         #
         #   @param response_format [OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONSchema, OpenAI::StructuredOutput::JsonSchemaConverter, OpenAI::Models::ResponseFormatJSONObject] An object specifying the format that the model must output.
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param seed [Integer, nil] This feature is in Beta.
         #
@@ -894,7 +895,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         module Verbosity
           extend OpenAI::Internal::Type::Enum
 

data/lib/openai/models/reasoning.rb

@@ -4,7 +4,10 @@ module OpenAI
   module Models
     class Reasoning < OpenAI::Internal::Type::BaseModel
       # @!attribute context
-      #   Controls which reasoning items are rendered back to the model on later turns.
+      #   Controls which reasoning items are rendered back to the model on later turns. If
+      #   omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+      #   model family defaults to `all_turns`; earlier models default to `current_turn`.
+      #
       #   When returned on a response, this is the effective reasoning context mode used
       #   for the response.
       #
@@ -72,7 +75,10 @@ module OpenAI
       #
       #   @param summary [Symbol, OpenAI::Models::Reasoning::Summary, nil] A summary of the reasoning performed by the model. This can be
 
-      # Controls which reasoning items are rendered back to the model on later turns.
+      # Controls which reasoning items are rendered back to the model on later turns. If
+      # omitted or set to `auto`, the model determines the context mode. The `gpt-5.6`
+      # model family defaults to `all_turns`; earlier models default to `current_turn`.
+      #
       # When returned on a response, this is the effective reasoning context mode used
       # for the response.
       #

data/lib/openai/models/responses/input_token_count_params.rb

@@ -225,7 +225,8 @@ module OpenAI
           # @!attribute verbosity
           #   Constrains the verbosity of the model's response. Lower values will result in
           #   more concise responses, while higher values will result in more verbose
-          #   responses. Currently supported values are `low`, `medium`, and `high`.
+          #   responses. Currently supported values are `low`, `medium`, and `high`. The
+          #   default is `medium`.
           #
           #   @return [Symbol, OpenAI::Models::Responses::InputTokenCountParams::Text::Verbosity, nil]
           optional :verbosity,
@@ -250,7 +251,8 @@ module OpenAI
 
           # Constrains the verbosity of the model's response. Lower values will result in
           # more concise responses, while higher values will result in more verbose
-          # responses. Currently supported values are `low`, `medium`, and `high`.
+          # responses. Currently supported values are `low`, `medium`, and `high`. The
+          # default is `medium`.
           #
           # @see OpenAI::Models::Responses::InputTokenCountParams::Text#verbosity
           module Verbosity

data/lib/openai/models/responses/response.rb

@@ -204,7 +204,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   The prompt-caching options that were applied to the response. Supported for
@@ -257,7 +257,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -402,7 +402,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Responses::Response::PromptCacheOptions] The prompt-caching options that were applied to the response. Supported for `gpt
         #
@@ -410,7 +410,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Responses::Response::ServiceTier, nil] Specifies the processing type used for serving the request.
         #

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

@@ -161,7 +161,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -221,7 +221,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -389,7 +389,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Responses::ResponseCreateParams::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -397,7 +397,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Responses::ResponseCreateParams::ServiceTier, nil] Specifies the processing type used for serving the request.
         #

data/lib/openai/models/responses/response_error.rb

@@ -35,6 +35,7 @@ module OpenAI
           SERVER_ERROR = :server_error
           RATE_LIMIT_EXCEEDED = :rate_limit_exceeded
           INVALID_PROMPT = :invalid_prompt
+          DATA_RESIDENCY_MISMATCH = :data_residency_mismatch
           BIO_POLICY = :bio_policy
           VECTOR_STORE_TIMEOUT = :vector_store_timeout
           INVALID_IMAGE = :invalid_image

data/lib/openai/models/responses/response_text_config.rb

@@ -25,7 +25,8 @@ module OpenAI
         # @!attribute verbosity
         #   Constrains the verbosity of the model's response. Lower values will result in
         #   more concise responses, while higher values will result in more verbose
-        #   responses. Currently supported values are `low`, `medium`, and `high`.
+        #   responses. Currently supported values are `low`, `medium`, and `high`. The
+        #   default is `medium`.
         #
         #   @return [Symbol, OpenAI::Models::Responses::ResponseTextConfig::Verbosity, nil]
         optional :verbosity, enum: -> { OpenAI::Responses::ResponseTextConfig::Verbosity }, nil?: true
@@ -46,7 +47,8 @@ module OpenAI
 
         # Constrains the verbosity of the model's response. Lower values will result in
         # more concise responses, while higher values will result in more verbose
-        # responses. Currently supported values are `low`, `medium`, and `high`.
+        # responses. Currently supported values are `low`, `medium`, and `high`. The
+        # default is `medium`.
         #
         # @see OpenAI::Models::Responses::ResponseTextConfig#verbosity
         module Verbosity

data/lib/openai/models/responses/responses_client_event.rb

@@ -161,7 +161,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
         #
         #   @return [String, nil]
-        optional :prompt_cache_key, String
+        optional :prompt_cache_key, String, nil?: true
 
         # @!attribute prompt_cache_options
         #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
@@ -221,7 +221,7 @@ module OpenAI
         #   [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         #
         #   @return [String, nil]
-        optional :safety_identifier, String
+        optional :safety_identifier, String, nil?: true
 
         # @!attribute service_tier
         #   Specifies the processing type used for serving the request.
@@ -394,7 +394,7 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Responses::ResponsePrompt, nil] Reference to a prompt template and its variables.
         #
-        #   @param prompt_cache_key [String] Used by OpenAI to cache responses for similar requests to optimize your cache hi
+        #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Responses::ResponsesClientEvent::PromptCacheOptions] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
         #
@@ -402,7 +402,7 @@ module OpenAI
         #
         #   @param reasoning [OpenAI::Models::Reasoning, nil] **gpt-5 and o-series models only**
         #
-        #   @param safety_identifier [String] A stable identifier used to help detect users of your application that may be vi
+        #   @param safety_identifier [String, nil] A stable identifier used to help detect users of your application that may be vi
         #
         #   @param service_tier [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::ServiceTier, nil] Specifies the processing type used for serving the request.
         #

data/lib/openai/provider.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module OpenAI
+  # Opaque configuration for an OpenAI-supported third-party provider.
+  #
+  # Provider instances are created by factories in OpenAI::Providers.
+  class Provider
+    # @api private
+    def initialize(definition) = @definition = definition
+
+    def inspect = "#<OpenAI::Provider>"
+
+    attr_reader(:definition)
+    private(:definition)
+
+    private_class_method :new, :allocate
+  end
+end