openai 0.17.1 → 0.19.0

data/rbi/openai/models/conversations/top_log_prob.rbi

@@ -0,0 +1,41 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Conversations
+      class TopLogProb < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(OpenAI::Conversations::TopLogProb, OpenAI::Internal::AnyHash)
+          end
+
+        sig { returns(String) }
+        attr_accessor :token
+
+        sig { returns(T::Array[Integer]) }
+        attr_accessor :bytes
+
+        sig { returns(Float) }
+        attr_accessor :logprob
+
+        sig do
+          params(
+            token: String,
+            bytes: T::Array[Integer],
+            logprob: Float
+          ).returns(T.attached_class)
+        end
+        def self.new(token:, bytes:, logprob:)
+        end
+
+        sig do
+          override.returns(
+            { token: String, bytes: T::Array[Integer], logprob: Float }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/conversations/url_citation_body.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Conversations
+      class URLCitationBody < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Conversations::URLCitationBody,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The index of the last character of the URL citation in the message.
+        sig { returns(Integer) }
+        attr_accessor :end_index
+
+        # The index of the first character of the URL citation in the message.
+        sig { returns(Integer) }
+        attr_accessor :start_index
+
+        # The title of the web resource.
+        sig { returns(String) }
+        attr_accessor :title
+
+        # The type of the URL citation. Always `url_citation`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # The URL of the web resource.
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig do
+          params(
+            end_index: Integer,
+            start_index: Integer,
+            title: String,
+            url: String,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The index of the last character of the URL citation in the message.
+          end_index:,
+          # The index of the first character of the URL citation in the message.
+          start_index:,
+          # The title of the web resource.
+          title:,
+          # The URL of the web resource.
+          url:,
+          # The type of the URL citation. Always `url_citation`.
+          type: :url_citation
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              end_index: Integer,
+              start_index: Integer,
+              title: String,
+              type: Symbol,
+              url: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/evals/create_eval_completions_run_data_source.rbi

@@ -441,7 +441,7 @@ module OpenAI
                 T::Array[
                   T.any(
                     OpenAI::Responses::EasyInputMessage,
-                    OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message
+                    OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem
                   )
                 ]
               )
@@ -458,7 +458,7 @@ module OpenAI
                   T::Array[
                     T.any(
                       OpenAI::Responses::EasyInputMessage::OrHash,
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::OrHash
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::OrHash
                     )
                   ],
                 type: Symbol
@@ -480,7 +480,7 @@ module OpenAI
                     T::Array[
                       T.any(
                         OpenAI::Responses::EasyInputMessage,
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem
                       )
                     ],
                   type: Symbol
@@ -502,15 +502,15 @@ module OpenAI
                 T.type_alias do
                   T.any(
                     OpenAI::Responses::EasyInputMessage,
-                    OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message
+                    OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem
                   )
                 end
 
-              class Message < OpenAI::Internal::Type::BaseModel
+              class EvalItem < OpenAI::Internal::Type::BaseModel
                 OrHash =
                   T.type_alias do
                     T.any(
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message,
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem,
                       OpenAI::Internal::AnyHash
                     )
                   end
@@ -521,8 +521,8 @@ module OpenAI
                     T.any(
                       String,
                       OpenAI::Responses::ResponseInputText,
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::OutputText,
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::InputImage,
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::OutputText,
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::InputImage,
                       T::Array[T.anything]
                     )
                   )
@@ -533,7 +533,7 @@ module OpenAI
                 # `developer`.
                 sig do
                   returns(
-                    OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role::OrSymbol
+                    OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role::OrSymbol
                   )
                 end
                 attr_accessor :role
@@ -542,7 +542,7 @@ module OpenAI
                 sig do
                   returns(
                     T.nilable(
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Type::OrSymbol
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Type::OrSymbol
                     )
                   )
                 end
@@ -551,7 +551,7 @@ module OpenAI
                 sig do
                   params(
                     type:
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Type::OrSymbol
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Type::OrSymbol
                   ).void
                 end
                 attr_writer :type
@@ -567,14 +567,14 @@ module OpenAI
                       T.any(
                         String,
                         OpenAI::Responses::ResponseInputText::OrHash,
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::OutputText::OrHash,
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::InputImage::OrHash,
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::OutputText::OrHash,
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::InputImage::OrHash,
                         T::Array[T.anything]
                       ),
                     role:
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role::OrSymbol,
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role::OrSymbol,
                     type:
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Type::OrSymbol
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Type::OrSymbol
                   ).returns(T.attached_class)
                 end
                 def self.new(
@@ -595,14 +595,14 @@ module OpenAI
                         T.any(
                           String,
                           OpenAI::Responses::ResponseInputText,
-                          OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::OutputText,
-                          OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::InputImage,
+                          OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::OutputText,
+                          OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::InputImage,
                           T::Array[T.anything]
                         ),
                       role:
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role::OrSymbol,
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role::OrSymbol,
                       type:
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Type::OrSymbol
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Type::OrSymbol
                     }
                   )
                 end
@@ -618,8 +618,8 @@ module OpenAI
                       T.any(
                         String,
                         OpenAI::Responses::ResponseInputText,
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::OutputText,
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::InputImage,
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::OutputText,
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::InputImage,
                         T::Array[T.anything]
                       )
                     end
@@ -628,7 +628,7 @@ module OpenAI
                     OrHash =
                       T.type_alias do
                         T.any(
-                          OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::OutputText,
+                          OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::OutputText,
                           OpenAI::Internal::AnyHash
                         )
                       end
@@ -664,7 +664,7 @@ module OpenAI
                     OrHash =
                       T.type_alias do
                         T.any(
-                          OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::InputImage,
+                          OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::InputImage,
                           OpenAI::Internal::AnyHash
                         )
                       end
@@ -716,7 +716,7 @@ module OpenAI
                   sig do
                     override.returns(
                       T::Array[
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Content::Variants
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Content::Variants
                       ]
                     )
                   end
@@ -741,7 +741,7 @@ module OpenAI
                     T.type_alias do
                       T.all(
                         Symbol,
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role
                       )
                     end
                   OrSymbol = T.type_alias { T.any(Symbol, String) }
@@ -749,28 +749,28 @@ module OpenAI
                   USER =
                     T.let(
                       :user,
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role::TaggedSymbol
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role::TaggedSymbol
                     )
                   ASSISTANT =
                     T.let(
                       :assistant,
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role::TaggedSymbol
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role::TaggedSymbol
                     )
                   SYSTEM =
                     T.let(
                       :system,
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role::TaggedSymbol
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role::TaggedSymbol
                     )
                   DEVELOPER =
                     T.let(
                       :developer,
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role::TaggedSymbol
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role::TaggedSymbol
                     )
 
                   sig do
                     override.returns(
                       T::Array[
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Role::TaggedSymbol
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Role::TaggedSymbol
                       ]
                     )
                   end
@@ -786,7 +786,7 @@ module OpenAI
                     T.type_alias do
                       T.all(
                         Symbol,
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Type
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Type
                       )
                     end
                   OrSymbol = T.type_alias { T.any(Symbol, String) }
@@ -794,13 +794,13 @@ module OpenAI
                   MESSAGE =
                     T.let(
                       :message,
-                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Type::TaggedSymbol
+                      OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Type::TaggedSymbol
                     )
 
                   sig do
                     override.returns(
                       T::Array[
-                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::Message::Type::TaggedSymbol
+                        OpenAI::Evals::CreateEvalCompletionsRunDataSource::InputMessages::Template::Template::EvalItem::Type::TaggedSymbol
                       ]
                     )
                   end

data/rbi/openai/models/file_create_params.rbi

@@ -22,10 +22,23 @@ module OpenAI
       sig { returns(OpenAI::FilePurpose::OrSymbol) }
       attr_accessor :purpose
 
+      # The expiration policy for a file. By default, files with `purpose=batch` expire
+      # after 30 days and all other files are persisted until they are manually deleted.
+      sig { returns(T.nilable(OpenAI::FileCreateParams::ExpiresAfter)) }
+      attr_reader :expires_after
+
+      sig do
+        params(
+          expires_after: OpenAI::FileCreateParams::ExpiresAfter::OrHash
+        ).void
+      end
+      attr_writer :expires_after
+
       sig do
         params(
           file: OpenAI::Internal::FileInput,
           purpose: OpenAI::FilePurpose::OrSymbol,
+          expires_after: OpenAI::FileCreateParams::ExpiresAfter::OrHash,
           request_options: OpenAI::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -37,6 +50,9 @@ module OpenAI
         # fine-tuning - `vision`: Images used for vision fine-tuning - `user_data`:
         # Flexible file type for any purpose - `evals`: Used for eval data sets
         purpose:,
+        # The expiration policy for a file. By default, files with `purpose=batch` expire
+        # after 30 days and all other files are persisted until they are manually deleted.
+        expires_after: nil,
         request_options: {}
       )
       end
@@ -46,12 +62,52 @@ module OpenAI
           {
             file: OpenAI::Internal::FileInput,
             purpose: OpenAI::FilePurpose::OrSymbol,
+            expires_after: OpenAI::FileCreateParams::ExpiresAfter,
             request_options: OpenAI::RequestOptions
           }
         )
       end
       def to_hash
       end
+
+      class ExpiresAfter < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::FileCreateParams::ExpiresAfter,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # Anchor timestamp after which the expiration policy applies. Supported anchors:
+        # `created_at`.
+        sig { returns(Symbol) }
+        attr_accessor :anchor
+
+        # The number of seconds after the anchor time that the file will expire. Must be
+        # between 3600 (1 hour) and 2592000 (30 days).
+        sig { returns(Integer) }
+        attr_accessor :seconds
+
+        # The expiration policy for a file. By default, files with `purpose=batch` expire
+        # after 30 days and all other files are persisted until they are manually deleted.
+        sig do
+          params(seconds: Integer, anchor: Symbol).returns(T.attached_class)
+        end
+        def self.new(
+          # The number of seconds after the anchor time that the file will expire. Must be
+          # between 3600 (1 hour) and 2592000 (30 days).
+          seconds:,
+          # Anchor timestamp after which the expiration policy applies. Supported anchors:
+          # `created_at`.
+          anchor: :created_at
+        )
+        end
+
+        sig { override.returns({ anchor: Symbol, seconds: Integer }) }
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/openai/models/graders/text_similarity_grader.rbi

@@ -14,8 +14,8 @@ module OpenAI
             )
           end
 
-        # The evaluation metric to use. One of `fuzzy_match`, `bleu`, `gleu`, `meteor`,
-        # `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
+        # The evaluation metric to use. One of `cosine`, `fuzzy_match`, `bleu`, `gleu`,
+        # `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
         sig do
           returns(
             OpenAI::Graders::TextSimilarityGrader::EvaluationMetric::OrSymbol
@@ -51,8 +51,8 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The evaluation metric to use. One of `fuzzy_match`, `bleu`, `gleu`, `meteor`,
-          # `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
+          # The evaluation metric to use. One of `cosine`, `fuzzy_match`, `bleu`, `gleu`,
+          # `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
           evaluation_metric:,
           # The text being graded.
           input:,
@@ -80,8 +80,8 @@ module OpenAI
         def to_hash
         end
 
-        # The evaluation metric to use. One of `fuzzy_match`, `bleu`, `gleu`, `meteor`,
-        # `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
+        # The evaluation metric to use. One of `cosine`, `fuzzy_match`, `bleu`, `gleu`,
+        # `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
         module EvaluationMetric
           extend OpenAI::Internal::Type::Enum
 
@@ -94,6 +94,11 @@ module OpenAI
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+          COSINE =
+            T.let(
+              :cosine,
+              OpenAI::Graders::TextSimilarityGrader::EvaluationMetric::TaggedSymbol
+            )
           FUZZY_MATCH =
             T.let(
               :fuzzy_match,

data/rbi/openai/models/reasoning.rbi

@@ -28,7 +28,7 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::Reasoning::Summary::OrSymbol)) }
       attr_accessor :summary
 
-      # **o-series models only**
+      # **gpt-5 and o-series models only**
       #
       # Configuration options for
       # [reasoning models](https://platform.openai.com/docs/guides/reasoning).

data/rbi/openai/models/responses/input_item_list_params.rbi

@@ -22,13 +22,6 @@ module OpenAI
         sig { params(after: String).void }
         attr_writer :after
 
-        # An item ID to list items before, used in pagination.
-        sig { returns(T.nilable(String)) }
-        attr_reader :before
-
-        sig { params(before: String).void }
-        attr_writer :before
-
         # Additional fields to include in the response. See the `include` parameter for
         # Response creation above for more information.
         sig do
@@ -74,7 +67,6 @@ module OpenAI
         sig do
           params(
             after: String,
-            before: String,
             include: T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol],
             limit: Integer,
             order: OpenAI::Responses::InputItemListParams::Order::OrSymbol,
@@ -84,8 +76,6 @@ module OpenAI
         def self.new(
           # An item ID to list items after, used in pagination.
           after: nil,
-          # An item ID to list items before, used in pagination.
-          before: nil,
           # Additional fields to include in the response. See the `include` parameter for
           # Response creation above for more information.
           include: nil,
@@ -105,7 +95,6 @@ module OpenAI
           override.returns(
             {
               after: String,
-              before: String,
               include:
                 T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol],
               limit: Integer,

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

@@ -136,6 +136,19 @@ module OpenAI
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :background
 
+        # The conversation that this response belongs to. Input items and output items
+        # from this response are automatically added to this conversation.
+        sig { returns(T.nilable(OpenAI::Responses::Response::Conversation)) }
+        attr_reader :conversation
+
+        sig do
+          params(
+            conversation:
+              T.nilable(OpenAI::Responses::Response::Conversation::OrHash)
+          ).void
+        end
+        attr_writer :conversation
+
         # An upper bound for the number of tokens that can be generated for a response,
         # including visible output tokens and
         # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
@@ -152,6 +165,7 @@ module OpenAI
         # The unique ID of the previous response to the model. Use this to create
         # multi-turn conversations. Learn more about
         # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+        # Cannot be used in conjunction with `conversation`.
         sig { returns(T.nilable(String)) }
         attr_accessor :previous_response_id
 
@@ -176,7 +190,7 @@ module OpenAI
         sig { params(prompt_cache_key: String).void }
         attr_writer :prompt_cache_key
 
-        # **o-series models only**
+        # **gpt-5 and o-series models only**
         #
         # Configuration options for
         # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
@@ -205,9 +219,8 @@ module OpenAI
         # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #   'priority', then the request will be processed with the corresponding service
-        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #   Priority processing.
+        #   '[priority](https://openai.com/api-priority-processing/)', then the request
+        #   will be processed with the corresponding service tier.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the
@@ -341,6 +354,8 @@ module OpenAI
               ],
             top_p: T.nilable(Float),
             background: T.nilable(T::Boolean),
+            conversation:
+              T.nilable(OpenAI::Responses::Response::Conversation::OrHash),
             max_output_tokens: T.nilable(Integer),
             max_tool_calls: T.nilable(Integer),
             previous_response_id: T.nilable(String),
@@ -433,6 +448,9 @@ module OpenAI
           # Whether to run the model response in the background.
           # [Learn more](https://platform.openai.com/docs/guides/background).
           background: nil,
+          # The conversation that this response belongs to. Input items and output items
+          # from this response are automatically added to this conversation.
+          conversation: nil,
           # An upper bound for the number of tokens that can be generated for a response,
           # including visible output tokens and
           # [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
@@ -445,6 +463,7 @@ module OpenAI
           # The unique ID of the previous response to the model. Use this to create
           # multi-turn conversations. Learn more about
           # [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+          # Cannot be used in conjunction with `conversation`.
           previous_response_id: nil,
           # Reference to a prompt template and its variables.
           # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
@@ -453,7 +472,7 @@ module OpenAI
           # hit rates. Replaces the `user` field.
           # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
           prompt_cache_key: nil,
-          # **o-series models only**
+          # **gpt-5 and o-series models only**
           #
           # Configuration options for
           # [reasoning models](https://platform.openai.com/docs/guides/reasoning).
@@ -472,9 +491,8 @@ module OpenAI
           # - If set to 'default', then the request will be processed with the standard
           #   pricing and performance for the selected model.
           # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-          #   'priority', then the request will be processed with the corresponding service
-          #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-          #   Priority processing.
+          #   '[priority](https://openai.com/api-priority-processing/)', then the request
+          #   will be processed with the corresponding service tier.
           # - When not set, the default behavior is 'auto'.
           #
           # When the `service_tier` parameter is set, the response body will include the
@@ -536,6 +554,8 @@ module OpenAI
               tools: T::Array[OpenAI::Responses::Tool::Variants],
               top_p: T.nilable(Float),
               background: T.nilable(T::Boolean),
+              conversation:
+                T.nilable(OpenAI::Responses::Response::Conversation),
               max_output_tokens: T.nilable(Integer),
               max_tool_calls: T.nilable(Integer),
               previous_response_id: T.nilable(String),
@@ -709,6 +729,33 @@ module OpenAI
           end
         end
 
+        class Conversation < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::Response::Conversation,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The unique ID of the conversation.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The conversation that this response belongs to. Input items and output items
+          # from this response are automatically added to this conversation.
+          sig { params(id: String).returns(T.attached_class) }
+          def self.new(
+            # The unique ID of the conversation.
+            id:
+          )
+          end
+
+          sig { override.returns({ id: String }) }
+          def to_hash
+          end
+        end
+
         # Specifies the processing type used for serving the request.
         #
         # - If set to 'auto', then the request will be processed with the service tier
@@ -717,9 +764,8 @@ module OpenAI
         # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #   'priority', then the request will be processed with the corresponding service
-        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #   Priority processing.
+        #   '[priority](https://openai.com/api-priority-processing/)', then the request
+        #   will be processed with the corresponding service tier.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the