openai 0.15.0 → 0.16.0

data/rbi/openai/models/chat/chat_completion_store_message.rbi

@@ -18,17 +18,82 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :id
 
+        # If a content parts array was provided, this is an array of `text` and
+        # `image_url` parts. Otherwise, null.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                OpenAI::Chat::ChatCompletionStoreMessage::ContentPart::Variants
+              ]
+            )
+          )
+        end
+        attr_accessor :content_parts
+
         # A chat completion message generated by the model.
-        sig { params(id: String).returns(T.attached_class) }
+        sig do
+          params(
+            id: String,
+            content_parts:
+              T.nilable(
+                T::Array[
+                  T.any(
+                    OpenAI::Chat::ChatCompletionContentPartText::OrHash,
+                    OpenAI::Chat::ChatCompletionContentPartImage::OrHash
+                  )
+                ]
+              )
+          ).returns(T.attached_class)
+        end
         def self.new(
           # The identifier of the chat message.
-          id:
+          id:,
+          # If a content parts array was provided, this is an array of `text` and
+          # `image_url` parts. Otherwise, null.
+          content_parts: nil
         )
         end
 
-        sig { override.returns({ id: String }) }
+        sig do
+          override.returns(
+            {
+              id: String,
+              content_parts:
+                T.nilable(
+                  T::Array[
+                    OpenAI::Chat::ChatCompletionStoreMessage::ContentPart::Variants
+                  ]
+                )
+            }
+          )
+        end
         def to_hash
         end
+
+        # Learn about
+        # [text inputs](https://platform.openai.com/docs/guides/text-generation).
+        module ContentPart
+          extend OpenAI::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                OpenAI::Chat::ChatCompletionContentPartText,
+                OpenAI::Chat::ChatCompletionContentPartImage
+              )
+            end
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Chat::ChatCompletionStoreMessage::ContentPart::Variants
+              ]
+            )
+          end
+          def self.variants
+          end
+        end
       end
     end
   end

data/rbi/openai/models/chat/completion_create_params.rbi

@@ -216,6 +216,15 @@ module OpenAI
         sig { returns(T.nilable(Float)) }
         attr_accessor :presence_penalty
 
+        # Used by OpenAI to cache responses for similar requests to optimize your cache
+        # hit rates. Replaces the `user` field.
+        # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+        sig { returns(T.nilable(String)) }
+        attr_reader :prompt_cache_key
+
+        sig { params(prompt_cache_key: String).void }
+        attr_writer :prompt_cache_key
+
         # **o-series models only**
         #
         # Constrains effort on reasoning for
@@ -262,6 +271,17 @@ module OpenAI
         end
         attr_writer :response_format
 
+        # A stable identifier used to help detect users of your application that may be
+        # violating OpenAI's usage policies. The IDs should be a string that uniquely
+        # identifies each user. We recommend hashing their username or email address, in
+        # order to avoid sending us any identifying information.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+        sig { returns(T.nilable(String)) }
+        attr_reader :safety_identifier
+
+        sig { params(safety_identifier: String).void }
+        attr_writer :safety_identifier
+
         # This feature is in Beta. If specified, our system will make a best effort to
         # sample deterministically, such that repeated requests with the same `seed` and
         # parameters should return the same result. Determinism is not guaranteed, and you
@@ -399,9 +419,11 @@ module OpenAI
         sig { returns(T.nilable(Float)) }
         attr_accessor :top_p
 
-        # A stable identifier for your end-users. Used to boost cache hit rates by better
-        # bucketing similar requests and to help OpenAI detect and prevent abuse.
-        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+        # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+        # `prompt_cache_key` instead to maintain caching optimizations. A stable
+        # identifier for your end-users. Used to boost cache hit rates by better bucketing
+        # similar requests and to help OpenAI detect and prevent abuse.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
         attr_reader :user
 
@@ -465,6 +487,7 @@ module OpenAI
             prediction:
               T.nilable(OpenAI::Chat::ChatCompletionPredictionContent::OrHash),
             presence_penalty: T.nilable(Float),
+            prompt_cache_key: String,
             reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
             response_format:
               T.any(
@@ -473,6 +496,7 @@ module OpenAI
                 OpenAI::StructuredOutput::JsonSchemaConverter,
                 OpenAI::ResponseFormatJSONObject::OrHash
               ),
+            safety_identifier: String,
             seed: T.nilable(Integer),
             service_tier:
               T.nilable(
@@ -603,6 +627,10 @@ module OpenAI
           # whether they appear in the text so far, increasing the model's likelihood to
           # talk about new topics.
           presence_penalty: nil,
+          # Used by OpenAI to cache responses for similar requests to optimize your cache
+          # hit rates. Replaces the `user` field.
+          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+          prompt_cache_key: nil,
           # **o-series models only**
           #
           # Constrains effort on reasoning for
@@ -621,6 +649,12 @@ module OpenAI
           # ensures the message the model generates is valid JSON. Using `json_schema` is
           # preferred for models that support it.
           response_format: nil,
+          # A stable identifier used to help detect users of your application that may be
+          # violating OpenAI's usage policies. The IDs should be a string that uniquely
+          # identifies each user. We recommend hashing their username or email address, in
+          # order to avoid sending us any identifying information.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          safety_identifier: nil,
           # This feature is in Beta. If specified, our system will make a best effort to
           # sample deterministically, such that repeated requests with the same `seed` and
           # parameters should return the same result. Determinism is not guaranteed, and you
@@ -687,9 +721,11 @@ module OpenAI
           #
           # We generally recommend altering this or `temperature` but not both.
           top_p: nil,
-          # A stable identifier for your end-users. Used to boost cache hit rates by better
-          # bucketing similar requests and to help OpenAI detect and prevent abuse.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+          # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+          # `prompt_cache_key` instead to maintain caching optimizations. A stable
+          # identifier for your end-users. Used to boost cache hit rates by better bucketing
+          # similar requests and to help OpenAI detect and prevent abuse.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           user: nil,
           # This tool searches the web for relevant results to use in a response. Learn more
           # about the
@@ -739,6 +775,7 @@ module OpenAI
               prediction:
                 T.nilable(OpenAI::Chat::ChatCompletionPredictionContent),
               presence_penalty: T.nilable(Float),
+              prompt_cache_key: String,
               reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
               response_format:
                 T.any(
@@ -746,6 +783,7 @@ module OpenAI
                   OpenAI::ResponseFormatJSONSchema,
                   OpenAI::ResponseFormatJSONObject
                 ),
+              safety_identifier: String,
               seed: T.nilable(Integer),
               service_tier:
                 T.nilable(

data/rbi/openai/models/responses/response.rbi

@@ -165,6 +165,15 @@ module OpenAI
         end
         attr_writer :prompt
 
+        # Used by OpenAI to cache responses for similar requests to optimize your cache
+        # hit rates. Replaces the `user` field.
+        # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+        sig { returns(T.nilable(String)) }
+        attr_reader :prompt_cache_key
+
+        sig { params(prompt_cache_key: String).void }
+        attr_writer :prompt_cache_key
+
         # **o-series models only**
         #
         # Configuration options for
@@ -175,6 +184,17 @@ module OpenAI
         sig { params(reasoning: T.nilable(OpenAI::Reasoning::OrHash)).void }
         attr_writer :reasoning
 
+        # A stable identifier used to help detect users of your application that may be
+        # violating OpenAI's usage policies. The IDs should be a string that uniquely
+        # identifies each user. We recommend hashing their username or email address, in
+        # order to avoid sending us any identifying information.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+        sig { returns(T.nilable(String)) }
+        attr_reader :safety_identifier
+
+        sig { params(safety_identifier: String).void }
+        attr_writer :safety_identifier
+
         # Specifies the processing type used for serving the request.
         #
         # - If set to 'auto', then the request will be processed with the service tier
@@ -247,9 +267,11 @@ module OpenAI
         sig { params(usage: OpenAI::Responses::ResponseUsage::OrHash).void }
         attr_writer :usage
 
-        # A stable identifier for your end-users. Used to boost cache hit rates by better
-        # bucketing similar requests and to help OpenAI detect and prevent abuse.
-        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+        # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+        # `prompt_cache_key` instead to maintain caching optimizations. A stable
+        # identifier for your end-users. Used to boost cache hit rates by better bucketing
+        # similar requests and to help OpenAI detect and prevent abuse.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
         attr_reader :user
 
@@ -317,7 +339,9 @@ module OpenAI
             max_tool_calls: T.nilable(Integer),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
+            prompt_cache_key: String,
             reasoning: T.nilable(OpenAI::Reasoning::OrHash),
+            safety_identifier: String,
             service_tier:
               T.nilable(OpenAI::Responses::Response::ServiceTier::OrSymbol),
             status: OpenAI::Responses::ResponseStatus::OrSymbol,
@@ -417,11 +441,21 @@ module OpenAI
           # Reference to a prompt template and its variables.
           # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
           prompt: nil,
+          # Used by OpenAI to cache responses for similar requests to optimize your cache
+          # hit rates. Replaces the `user` field.
+          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+          prompt_cache_key: nil,
           # **o-series models only**
           #
           # Configuration options for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
           reasoning: nil,
+          # A stable identifier used to help detect users of your application that may be
+          # violating OpenAI's usage policies. The IDs should be a string that uniquely
+          # identifies each user. We recommend hashing their username or email address, in
+          # order to avoid sending us any identifying information.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          safety_identifier: nil,
           # Specifies the processing type used for serving the request.
           #
           # - If set to 'auto', then the request will be processed with the service tier
@@ -463,9 +497,11 @@ module OpenAI
           # Represents token usage details including input tokens, output tokens, a
           # breakdown of output tokens, and the total tokens used.
           usage: nil,
-          # A stable identifier for your end-users. Used to boost cache hit rates by better
-          # bucketing similar requests and to help OpenAI detect and prevent abuse.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+          # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+          # `prompt_cache_key` instead to maintain caching optimizations. A stable
+          # identifier for your end-users. Used to boost cache hit rates by better bucketing
+          # similar requests and to help OpenAI detect and prevent abuse.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           user: nil,
           # The object type of this resource - always set to `response`.
           object: :response
@@ -496,7 +532,9 @@ module OpenAI
               max_tool_calls: T.nilable(Integer),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Responses::ResponsePrompt),
+              prompt_cache_key: String,
               reasoning: T.nilable(OpenAI::Reasoning),
+              safety_identifier: String,
               service_tier:
                 T.nilable(
                   OpenAI::Responses::Response::ServiceTier::TaggedSymbol

data/rbi/openai/models/responses/response_create_params.rbi

@@ -148,6 +148,15 @@ module OpenAI
         end
         attr_writer :prompt
 
+        # Used by OpenAI to cache responses for similar requests to optimize your cache
+        # hit rates. Replaces the `user` field.
+        # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+        sig { returns(T.nilable(String)) }
+        attr_reader :prompt_cache_key
+
+        sig { params(prompt_cache_key: String).void }
+        attr_writer :prompt_cache_key
+
         # **o-series models only**
         #
         # Configuration options for
@@ -158,6 +167,17 @@ module OpenAI
         sig { params(reasoning: T.nilable(OpenAI::Reasoning::OrHash)).void }
         attr_writer :reasoning
 
+        # A stable identifier used to help detect users of your application that may be
+        # violating OpenAI's usage policies. The IDs should be a string that uniquely
+        # identifies each user. We recommend hashing their username or email address, in
+        # order to avoid sending us any identifying information.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+        sig { returns(T.nilable(String)) }
+        attr_reader :safety_identifier
+
+        sig { params(safety_identifier: String).void }
+        attr_writer :safety_identifier
+
         # Specifies the processing type used for serving the request.
         #
         # - If set to 'auto', then the request will be processed with the service tier
@@ -326,9 +346,11 @@ module OpenAI
         end
         attr_accessor :truncation
 
-        # A stable identifier for your end-users. Used to boost cache hit rates by better
-        # bucketing similar requests and to help OpenAI detect and prevent abuse.
-        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+        # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+        # `prompt_cache_key` instead to maintain caching optimizations. A stable
+        # identifier for your end-users. Used to boost cache hit rates by better bucketing
+        # similar requests and to help OpenAI detect and prevent abuse.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         sig { returns(T.nilable(String)) }
         attr_reader :user
 
@@ -356,7 +378,9 @@ module OpenAI
             parallel_tool_calls: T.nilable(T::Boolean),
             previous_response_id: T.nilable(String),
             prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
+            prompt_cache_key: String,
             reasoning: T.nilable(OpenAI::Reasoning::OrHash),
+            safety_identifier: String,
             service_tier:
               T.nilable(
                 OpenAI::Responses::ResponseCreateParams::ServiceTier::OrSymbol
@@ -462,11 +486,21 @@ module OpenAI
           # Reference to a prompt template and its variables.
           # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
           prompt: nil,
+          # Used by OpenAI to cache responses for similar requests to optimize your cache
+          # hit rates. Replaces the `user` field.
+          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+          prompt_cache_key: nil,
           # **o-series models only**
           #
           # Configuration options for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
           reasoning: nil,
+          # A stable identifier used to help detect users of your application that may be
+          # violating OpenAI's usage policies. The IDs should be a string that uniquely
+          # identifies each user. We recommend hashing their username or email address, in
+          # order to avoid sending us any identifying information.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          safety_identifier: nil,
           # Specifies the processing type used for serving the request.
           #
           # - If set to 'auto', then the request will be processed with the service tier
@@ -534,9 +568,11 @@ module OpenAI
           # - `disabled` (default): If a model response will exceed the context window size
           #   for a model, the request will fail with a 400 error.
           truncation: nil,
-          # A stable identifier for your end-users. Used to boost cache hit rates by better
-          # bucketing similar requests and to help OpenAI detect and prevent abuse.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+          # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+          # `prompt_cache_key` instead to maintain caching optimizations. A stable
+          # identifier for your end-users. Used to boost cache hit rates by better bucketing
+          # similar requests and to help OpenAI detect and prevent abuse.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           user: nil,
           request_options: {}
         )
@@ -564,7 +600,9 @@ module OpenAI
               parallel_tool_calls: T.nilable(T::Boolean),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Responses::ResponsePrompt),
+              prompt_cache_key: String,
               reasoning: T.nilable(OpenAI::Reasoning),
+              safety_identifier: String,
               service_tier:
                 T.nilable(
                   OpenAI::Responses::ResponseCreateParams::ServiceTier::OrSymbol

data/rbi/openai/resources/chat/completions.rbi

@@ -65,6 +65,7 @@ module OpenAI
             prediction:
               T.nilable(OpenAI::Chat::ChatCompletionPredictionContent::OrHash),
             presence_penalty: T.nilable(Float),
+            prompt_cache_key: String,
             reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
             response_format:
               T.any(
@@ -73,6 +74,7 @@ module OpenAI
                 OpenAI::StructuredOutput::JsonSchemaConverter,
                 OpenAI::ResponseFormatJSONObject::OrHash
               ),
+            safety_identifier: String,
             seed: T.nilable(Integer),
             service_tier:
               T.nilable(
@@ -204,6 +206,10 @@ module OpenAI
           # whether they appear in the text so far, increasing the model's likelihood to
           # talk about new topics.
           presence_penalty: nil,
+          # Used by OpenAI to cache responses for similar requests to optimize your cache
+          # hit rates. Replaces the `user` field.
+          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+          prompt_cache_key: nil,
           # **o-series models only**
           #
           # Constrains effort on reasoning for
@@ -222,6 +228,12 @@ module OpenAI
           # ensures the message the model generates is valid JSON. Using `json_schema` is
           # preferred for models that support it.
           response_format: nil,
+          # A stable identifier used to help detect users of your application that may be
+          # violating OpenAI's usage policies. The IDs should be a string that uniquely
+          # identifies each user. We recommend hashing their username or email address, in
+          # order to avoid sending us any identifying information.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          safety_identifier: nil,
           # This feature is in Beta. If specified, our system will make a best effort to
           # sample deterministically, such that repeated requests with the same `seed` and
           # parameters should return the same result. Determinism is not guaranteed, and you
@@ -288,9 +300,11 @@ module OpenAI
           #
           # We generally recommend altering this or `temperature` but not both.
           top_p: nil,
-          # A stable identifier for your end-users. Used to boost cache hit rates by better
-          # bucketing similar requests and to help OpenAI detect and prevent abuse.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+          # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+          # `prompt_cache_key` instead to maintain caching optimizations. A stable
+          # identifier for your end-users. Used to boost cache hit rates by better bucketing
+          # similar requests and to help OpenAI detect and prevent abuse.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           user: nil,
           # This tool searches the web for relevant results to use in a response. Learn more
           # about the
@@ -361,6 +375,7 @@ module OpenAI
             prediction:
               T.nilable(OpenAI::Chat::ChatCompletionPredictionContent::OrHash),
             presence_penalty: T.nilable(Float),
+            prompt_cache_key: String,
             reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
             response_format:
               T.any(
@@ -368,6 +383,7 @@ module OpenAI
                 OpenAI::ResponseFormatJSONSchema::OrHash,
                 OpenAI::ResponseFormatJSONObject::OrHash
               ),
+            safety_identifier: String,
             seed: T.nilable(Integer),
             service_tier:
               T.nilable(
@@ -493,6 +509,10 @@ module OpenAI
           # whether they appear in the text so far, increasing the model's likelihood to
           # talk about new topics.
           presence_penalty: nil,
+          # Used by OpenAI to cache responses for similar requests to optimize your cache
+          # hit rates. Replaces the `user` field.
+          # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+          prompt_cache_key: nil,
           # **o-series models only**
           #
           # Constrains effort on reasoning for
@@ -511,6 +531,12 @@ module OpenAI
           # ensures the message the model generates is valid JSON. Using `json_schema` is
           # preferred for models that support it.
           response_format: nil,
+          # A stable identifier used to help detect users of your application that may be
+          # violating OpenAI's usage policies. The IDs should be a string that uniquely
+          # identifies each user. We recommend hashing their username or email address, in
+          # order to avoid sending us any identifying information.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+          safety_identifier: nil,
           # This feature is in Beta. If specified, our system will make a best effort to
           # sample deterministically, such that repeated requests with the same `seed` and
           # parameters should return the same result. Determinism is not guaranteed, and you
@@ -577,9 +603,11 @@ module OpenAI
           #
           # We generally recommend altering this or `temperature` but not both.
           top_p: nil,
-          # A stable identifier for your end-users. Used to boost cache hit rates by better
-          # bucketing similar requests and to help OpenAI detect and prevent abuse.
-          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+          # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+          # `prompt_cache_key` instead to maintain caching optimizations. A stable
+          # identifier for your end-users. Used to boost cache hit rates by better bucketing
+          # similar requests and to help OpenAI detect and prevent abuse.
+          # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
           user: nil,
           # This tool searches the web for relevant results to use in a response. Learn more
           # about the

data/rbi/openai/resources/responses.rbi

@@ -40,7 +40,9 @@ module OpenAI
           parallel_tool_calls: T.nilable(T::Boolean),
           previous_response_id: T.nilable(String),
           prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
+          prompt_cache_key: String,
           reasoning: T.nilable(OpenAI::Reasoning::OrHash),
+          safety_identifier: String,
           service_tier:
             T.nilable(
               OpenAI::Responses::ResponseCreateParams::ServiceTier::OrSymbol
@@ -151,11 +153,21 @@ module OpenAI
         # Reference to a prompt template and its variables.
         # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
         prompt: nil,
+        # Used by OpenAI to cache responses for similar requests to optimize your cache
+        # hit rates. Replaces the `user` field.
+        # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+        prompt_cache_key: nil,
         # **o-series models only**
         #
         # Configuration options for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
         reasoning: nil,
+        # A stable identifier used to help detect users of your application that may be
+        # violating OpenAI's usage policies. The IDs should be a string that uniquely
+        # identifies each user. We recommend hashing their username or email address, in
+        # order to avoid sending us any identifying information.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+        safety_identifier: nil,
         # Specifies the processing type used for serving the request.
         #
         # - If set to 'auto', then the request will be processed with the service tier
@@ -223,9 +235,11 @@ module OpenAI
         # - `disabled` (default): If a model response will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         truncation: nil,
-        # A stable identifier for your end-users. Used to boost cache hit rates by better
-        # bucketing similar requests and to help OpenAI detect and prevent abuse.
-        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+        # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+        # `prompt_cache_key` instead to maintain caching optimizations. A stable
+        # identifier for your end-users. Used to boost cache hit rates by better bucketing
+        # similar requests and to help OpenAI detect and prevent abuse.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#stream_raw` or `#create`
         # for streaming and non-streaming use cases, respectively.
@@ -268,7 +282,9 @@ module OpenAI
           parallel_tool_calls: T.nilable(T::Boolean),
           previous_response_id: T.nilable(String),
           prompt: T.nilable(OpenAI::Responses::ResponsePrompt::OrHash),
+          prompt_cache_key: String,
           reasoning: T.nilable(OpenAI::Reasoning::OrHash),
+          safety_identifier: String,
           service_tier:
             T.nilable(
               OpenAI::Responses::ResponseCreateParams::ServiceTier::OrSymbol
@@ -385,11 +401,21 @@ module OpenAI
         # Reference to a prompt template and its variables.
         # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
         prompt: nil,
+        # Used by OpenAI to cache responses for similar requests to optimize your cache
+        # hit rates. Replaces the `user` field.
+        # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+        prompt_cache_key: nil,
         # **o-series models only**
         #
         # Configuration options for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
         reasoning: nil,
+        # A stable identifier used to help detect users of your application that may be
+        # violating OpenAI's usage policies. The IDs should be a string that uniquely
+        # identifies each user. We recommend hashing their username or email address, in
+        # order to avoid sending us any identifying information.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+        safety_identifier: nil,
         # Specifies the processing type used for serving the request.
         #
         # - If set to 'auto', then the request will be processed with the service tier
@@ -457,9 +483,11 @@ module OpenAI
         # - `disabled` (default): If a model response will exceed the context window size
         #   for a model, the request will fail with a 400 error.
         truncation: nil,
-        # A stable identifier for your end-users. Used to boost cache hit rates by better
-        # bucketing similar requests and to help OpenAI detect and prevent abuse.
-        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
+        # This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+        # `prompt_cache_key` instead to maintain caching optimizations. A stable
+        # identifier for your end-users. Used to boost cache hit rates by better bucketing
+        # similar requests and to help OpenAI detect and prevent abuse.
+        # [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#stream_raw` or `#create`
         # for streaming and non-streaming use cases, respectively.

data/sig/openai/models/chat/chat_completion_store_message.rbs

@@ -3,16 +3,42 @@ module OpenAI
     class ChatCompletionStoreMessage = Chat::ChatCompletionStoreMessage
 
     module Chat
-      type chat_completion_store_message = { id: String }
+      type chat_completion_store_message =
+        {
+          id: String,
+          content_parts: ::Array[OpenAI::Models::Chat::ChatCompletionStoreMessage::content_part]?
+        }
 
       class ChatCompletionStoreMessage < OpenAI::Models::Chat::ChatCompletionMessage
         def id: -> String
 
         def id=: (String _) -> String
 
-        def initialize: (id: String) -> void
+        def content_parts: -> ::Array[OpenAI::Models::Chat::ChatCompletionStoreMessage::content_part]?
 
-        def to_hash: -> { id: String }
+        def content_parts=: (
+          ::Array[OpenAI::Models::Chat::ChatCompletionStoreMessage::content_part]? _
+        ) -> ::Array[OpenAI::Models::Chat::ChatCompletionStoreMessage::content_part]?
+
+        def initialize: (
+          id: String,
+          ?content_parts: ::Array[OpenAI::Models::Chat::ChatCompletionStoreMessage::content_part]?
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          content_parts: ::Array[OpenAI::Models::Chat::ChatCompletionStoreMessage::content_part]?
+        }
+
+        type content_part =
+          OpenAI::Chat::ChatCompletionContentPartText
+          | OpenAI::Chat::ChatCompletionContentPartImage
+
+        module ContentPart
+          extend OpenAI::Internal::Type::Union
+
+          def self?.variants: -> ::Array[OpenAI::Models::Chat::ChatCompletionStoreMessage::content_part]
+        end
       end
     end
   end