openai 0.42.0 → 0.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 464227db3c30bad373f3cd4600bb7409c8ace214249c3257016363d533d848c8
-  data.tar.gz: a3828202f21732efa015e97198bf160fff5dca941a25cc1010f688a583ac8ccb
+  metadata.gz: 10373778f29256c14ae2a86c73559f1666fead459817c6261b4960c64d0a8c6e
+  data.tar.gz: d923d898c5f7adcd2430cfa8baf05a7b76bb0b4450ed7a808e4cb85d5cb49b9c
 SHA512:
-  metadata.gz: c062d515f082c87524e10ccce322304923f4db54cd489218248f63e2d47e1f976db323f9e1cff5753f66a603112d8b56df3a9ed4f9a144d4e8867c6cdc075e52
-  data.tar.gz: 566f420ae6db1b332fe1dd253544271c470f9863d4278ebcf22a873ff2cc4102999d0ed741f68671011c5a761e39d988e3679e41e139f2a7d526334ba48cd452
+  metadata.gz: 5131c4e4918e766e222df46cffd15582461fa8dd677a55ae2e6602c0283ed3c6a48682b562dbf1135573329fa295d4b4e2ac2bb52897b032dd5297c5ff85e191
+  data.tar.gz: c13000c1ad47d32f6c4fad58b2974f3dec4dfb58a751e34d4c76da1cb032391439fdc07f4f8a8052b1c8e7fe1dc181567c26acdacf65cb09b30376b8167598aa

data/CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## 0.45.0 (2026-02-04)
+
+Full Changelog: [v0.44.0...v0.45.0](https://github.com/openai/openai-ruby/compare/v0.44.0...v0.45.0)
+
+### Features
+
+* **api:** add shell_call_output status field ([b235617](https://github.com/openai/openai-ruby/commit/b2356174e90b573b98f16a3176a51cc2b4a108b4))
+* **api:** image generation actions for responses; ResponseFunctionCallArgumentsDoneEvent.name ([da359de](https://github.com/openai/openai-ruby/commit/da359de522a5532b287094b04f625248687d08f3))
+
+
+### Bug Fixes
+
+* **client:** always add content-length to post body, even when empty ([b6faa94](https://github.com/openai/openai-ruby/commit/b6faa94ec4454515c576c067a584e2a62fa33666))
+* **client:** undo change to web search Find action ([e10a7dd](https://github.com/openai/openai-ruby/commit/e10a7dd8f601a66b5b1e7c769623f51f9e191a9f))
+* **client:** update type for `find_in_page` action ([dd727fa](https://github.com/openai/openai-ruby/commit/dd727fadbd82ae42181fae53582043809e4dd391))
+
+
+### Chores
+
+* **client:** improve example values ([3c8e152](https://github.com/openai/openai-ruby/commit/3c8e1520fd7bea47442814fe2a4196c68f2062c7))
+* **docs:** remove www prefix ([6ef56a3](https://github.com/openai/openai-ruby/commit/6ef56a36260ed01f4ea302ae69a73aed366e5e94))
+
+## 0.44.0 (2026-01-27)
+
+Full Changelog: [v0.43.0...v0.44.0](https://github.com/openai/openai-ruby/compare/v0.43.0...v0.44.0)
+
+### Features
+
+* **api:** api update ([407360e](https://github.com/openai/openai-ruby/commit/407360eb65bd70de1e4398e2b892624d0d674ea9))
+* **api:** api updates ([d3b882e](https://github.com/openai/openai-ruby/commit/d3b882ec9547197583f8002395842cc861b08774))
+
+
+### Bug Fixes
+
+* **api:** mark assistants as deprecated ([5baf7da](https://github.com/openai/openai-ruby/commit/5baf7dab0fecd0fb64720ce586377e9999d76b9e))
+
+
+### Chores
+
+* **internal:** update `actions/checkout` version ([78251bd](https://github.com/openai/openai-ruby/commit/78251bd3cdaccc09f57feda8ee5b73cab03d6625))
+
+## 0.43.0 (2026-01-09)
+
+Full Changelog: [v0.42.0...v0.43.0](https://github.com/openai/openai-ruby/compare/v0.42.0...v0.43.0)
+
+### Features
+
+* **api:** add new Response completed_at prop ([c32e1c2](https://github.com/openai/openai-ruby/commit/c32e1c2a0a0ae6a9b7724e1c6d251ba14e8499e1))
+
+
+### Chores
+
+* add ci tests for ruby 4 compatibility [#235](https://github.com/openai/openai-ruby/issues/235) ([#236](https://github.com/openai/openai-ruby/issues/236)) ([1aa0d7a](https://github.com/openai/openai-ruby/commit/1aa0d7abf5a4714fa28cfe7ee5aecefbe2c683d2))
+* **internal:** codegen related update ([ef23de3](https://github.com/openai/openai-ruby/commit/ef23de347b5f541853a32a288cd02a54938793cf))
+* **internal:** use different example values for some enums ([8b6c4ad](https://github.com/openai/openai-ruby/commit/8b6c4ade813244e8c65690c66fe09f2566dd3ff0))
+* move `cgi` into dependencies for ruby 4 ([bd9c798](https://github.com/openai/openai-ruby/commit/bd9c798552a3d378ec943c7e07d6cf1334f72b1d))
+
 ## 0.42.0 (2025-12-19)
 
 Full Changelog: [v0.41.0...v0.42.0](https://github.com/openai/openai-ruby/compare/v0.41.0...v0.42.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.42.0"
+gem "openai", "~> 0.45.0"
 ```
 
 <!-- x-release-please-end -->
@@ -30,10 +30,7 @@ openai = OpenAI::Client.new(
   api_key: ENV["OPENAI_API_KEY"] # This is the default and can be omitted
 )
 
-chat_completion = openai.chat.completions.create(
-  messages: [{role: "user", content: "Say this is a test"}],
-  model: :"gpt-5.2"
-)
+chat_completion = openai.chat.completions.create(messages: [{role: "user", content: "Say this is a test"}], model: "gpt-5.2")
 
 puts(chat_completion)
 ```
@@ -45,7 +42,7 @@ We provide support for streaming responses using Server-Sent Events (SSE).
 ```ruby
 stream = openai.responses.stream(
   input: "Write a haiku about OpenAI.",
-  model: :"gpt-5.2"
+  model: "gpt-5.2"
 )
 
 stream.each do |event|
@@ -214,7 +211,7 @@ end
 client = OpenAI::Client.new
 
 response = client.responses.create(
-  model: "gpt-4o-2024-08-06",
+  model: "gpt-5.2",
   input: [
     {role: :system, content: "Extract the event information."},
     {
@@ -250,7 +247,7 @@ To make the equivalent request using raw JSON schema format, you would do the fo
 
 ```ruby
 response = client.responses.create(
-  model: "gpt-4o-2024-08-06",
+  model: "gpt-5.2",
   input: [
     {role: :system, content: "Extract the event information."},
     {
@@ -298,7 +295,7 @@ When the library is unable to connect to the API, or if the API returns a non-su
 
 ```ruby
 begin
-  job = openai.fine_tuning.jobs.create(model: :"babbage-002", training_file: "file-abc123")
+  job = openai.fine_tuning.jobs.create(model: "gpt-4o", training_file: "file-abc123")
 rescue OpenAI::Errors::APIConnectionError => e
   puts("The server could not be reached")
   puts(e.cause)  # an underlying Exception, likely raised within `net/http`
@@ -343,7 +340,7 @@ openai = OpenAI::Client.new(
 # Or, configure per-request:
 openai.chat.completions.create(
   messages: [{role: "user", content: "How can I get the name of the current day in JavaScript?"}],
-  model: :"gpt-5.2",
+  model: "gpt-5.2",
   request_options: {max_retries: 5}
 )
 ```
@@ -361,7 +358,7 @@ openai = OpenAI::Client.new(
 # Or, configure per-request:
 openai.chat.completions.create(
   messages: [{role: "user", content: "How can I list all files in a directory using Python?"}],
-  model: :"gpt-5.2",
+  model: "gpt-5.2",
   request_options: {timeout: 5}
 )
 ```
@@ -396,7 +393,7 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 chat_completion =
   openai.chat.completions.create(
     messages: [{role: "user", content: "How can I get the name of the current day in JavaScript?"}],
-    model: :"gpt-5.2",
+    model: "gpt-5.2",
     request_options: {
       extra_query: {my_query_parameter: value},
       extra_body: {my_body_parameter: value},
@@ -444,7 +441,7 @@ You can provide typesafe request parameters like so:
 ```ruby
 openai.chat.completions.create(
   messages: [OpenAI::Chat::ChatCompletionUserMessageParam.new(content: "Say this is a test")],
-  model: :"gpt-5.2"
+  model: "gpt-5.2"
 )
 ```
 
@@ -452,15 +449,12 @@ Or, equivalently:
 
 ```ruby
 # Hashes work, but are not typesafe:
-openai.chat.completions.create(
-  messages: [{role: "user", content: "Say this is a test"}],
-  model: :"gpt-5.2"
-)
+openai.chat.completions.create(messages: [{role: "user", content: "Say this is a test"}], model: "gpt-5.2")
 
 # You can also splat a full Params class:
 params = OpenAI::Chat::CompletionCreateParams.new(
   messages: [OpenAI::Chat::ChatCompletionUserMessageParam.new(content: "Say this is a test")],
-  model: :"gpt-5.2"
+  model: "gpt-5.2"
 )
 openai.chat.completions.create(**params)
 ```

data/lib/openai/internal/transport/pooled_net_requester.rb

@@ -75,7 +75,7 @@ module OpenAI
 
             case body
             in nil
-              nil
+              req["content-length"] ||= 0 unless req["transfer-encoding"]
             in String
               req["content-length"] ||= body.bytesize.to_s unless req["transfer-encoding"]
               req.body_stream = OpenAI::Internal::Util::ReadIOAdapter.new(body, &blk)

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

@@ -22,9 +22,10 @@ module OpenAI
         required :model, union: -> { OpenAI::Audio::SpeechCreateParams::Model }
 
         # @!attribute voice
-        #   The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
-        #   `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and
-        #   `verse`. Previews of the voices are available in the
+        #   The voice to use when generating the audio. Supported built-in voices are
+        #   `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+        #   `shimmer`, `verse`, `marin`, and `cedar`. Previews of the voices are available
+        #   in the
         #   [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
         #
         #   @return [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice]
@@ -66,7 +67,7 @@ module OpenAI
         #
         #   @param model [String, Symbol, OpenAI::Models::Audio::SpeechModel] One of the available [TTS models](https://platform.openai.com/docs/models#tts):
         #
-        #   @param voice [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice] The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
+        #   @param voice [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice] The voice to use when generating the audio. Supported built-in voices are `alloy
         #
         #   @param instructions [String] Control the voice of your generated audio with additional instructions. Does not
         #
@@ -92,9 +93,10 @@ module OpenAI
           #   @return [Array(String, Symbol, OpenAI::Models::Audio::SpeechModel)]
         end
 
-        # The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
-        # `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and
-        # `verse`. Previews of the voices are available in the
+        # The voice to use when generating the audio. Supported built-in voices are
+        # `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+        # `shimmer`, `verse`, `marin`, and `cedar`. Previews of the voices are available
+        # in the
         # [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
         module Voice
           extend OpenAI::Internal::Type::Union

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

@@ -3,6 +3,8 @@
 module OpenAI
   module Models
     module Beta
+      # @deprecated
+      #
       # @see OpenAI::Resources::Beta::Assistants#create
       class Assistant < OpenAI::Internal::Type::BaseModel
         # @!attribute id

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

@@ -12,8 +12,9 @@ module OpenAI
         required :format_, enum: -> { OpenAI::Chat::ChatCompletionAudioParam::Format }, api_name: :format
 
         # @!attribute voice
-        #   The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-        #   `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+        #   The voice the model uses to respond. Supported built-in voices are `alloy`,
+        #   `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+        #   `marin`, and `cedar`.
         #
         #   @return [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice]
         required :voice, union: -> { OpenAI::Chat::ChatCompletionAudioParam::Voice }
@@ -28,7 +29,7 @@ module OpenAI
         #
         #   @param format_ [Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Format] Specifies the output audio format. Must be one of `wav`, `mp3`, `flac`,
         #
-        #   @param voice [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice] The voice the model uses to respond. Supported voices are
+        #   @param voice [String, Symbol, OpenAI::Models::Chat::ChatCompletionAudioParam::Voice] The voice the model uses to respond. Supported built-in voices are `alloy`, `ash
 
         # Specifies the output audio format. Must be one of `wav`, `mp3`, `flac`, `opus`,
         # or `pcm16`.
@@ -48,8 +49,9 @@ module OpenAI
           #   @return [Array<Symbol>]
         end
 
-        # The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-        # `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+        # `marin`, and `cedar`.
         #
         # @see OpenAI::Models::Chat::ChatCompletionAudioParam#voice
         module Voice

data/lib/openai/models/conversations/conversation_item.rb

@@ -57,7 +57,7 @@ module OpenAI
         # A tool call that executes one or more shell commands in a managed environment.
         variant :shell_call, -> { OpenAI::Responses::ResponseFunctionShellToolCall }
 
-        # The output of a shell tool call.
+        # The output of a shell tool call that was emitted.
         variant :shell_call_output, -> { OpenAI::Responses::ResponseFunctionShellToolCallOutput }
 
         # A tool call that applies file diffs by creating, deleting, or updating files.

data/lib/openai/models/conversations/message.rb

@@ -52,7 +52,7 @@ module OpenAI
         #
         #   @param type [Symbol, :message] The type of the message. Always set to `message`.
 
-        # A text input to the model.
+        # A content part that makes up an input or output item.
         module Content
           extend OpenAI::Internal::Type::Union
 

data/lib/openai/models/file_create_params.rb

@@ -14,10 +14,14 @@ module OpenAI
       required :file, OpenAI::Internal::Type::FileInput
 
       # @!attribute purpose
-      #   The intended purpose of the uploaded file. One of: - `assistants`: Used in the
-      #   Assistants API - `batch`: Used in the Batch API - `fine-tune`: Used for
-      #   fine-tuning - `vision`: Images used for vision fine-tuning - `user_data`:
-      #   Flexible file type for any purpose - `evals`: Used for eval data sets
+      #   The intended purpose of the uploaded file. One of:
+      #
+      #   - `assistants`: Used in the Assistants API
+      #   - `batch`: Used in the Batch API
+      #   - `fine-tune`: Used for fine-tuning
+      #   - `vision`: Images used for vision fine-tuning
+      #   - `user_data`: Flexible file type for any purpose
+      #   - `evals`: Used for eval data sets
       #
       #   @return [Symbol, OpenAI::Models::FilePurpose]
       required :purpose, enum: -> { OpenAI::FilePurpose }
@@ -35,7 +39,7 @@ module OpenAI
       #
       #   @param file [Pathname, StringIO, IO, String, OpenAI::FilePart] The File object (not file name) to be uploaded.
       #
-      #   @param purpose [Symbol, OpenAI::Models::FilePurpose] The intended purpose of the uploaded file. One of: - `assistants`: Used in the A
+      #   @param purpose [Symbol, OpenAI::Models::FilePurpose] The intended purpose of the uploaded file. One of:
       #
       #   @param expires_after [OpenAI::Models::FileCreateParams::ExpiresAfter] The expiration policy for a file. By default, files with `purpose=batch` expire
       #

data/lib/openai/models/file_purpose.rb

@@ -2,10 +2,14 @@
 
 module OpenAI
   module Models
-    # The intended purpose of the uploaded file. One of: - `assistants`: Used in the
-    # Assistants API - `batch`: Used in the Batch API - `fine-tune`: Used for
-    # fine-tuning - `vision`: Images used for vision fine-tuning - `user_data`:
-    # Flexible file type for any purpose - `evals`: Used for eval data sets
+    # The intended purpose of the uploaded file. One of:
+    #
+    # - `assistants`: Used in the Assistants API
+    # - `batch`: Used in the Batch API
+    # - `fine-tune`: Used for fine-tuning
+    # - `vision`: Images used for vision fine-tuning
+    # - `user_data`: Flexible file type for any purpose
+    # - `evals`: Used for eval data sets
     module FilePurpose
       extend OpenAI::Internal::Type::Enum
 

data/lib/openai/models/realtime/conversation_item_create_event.rb

@@ -24,10 +24,14 @@ module OpenAI
 
         # @!attribute previous_item_id
         #   The ID of the preceding item after which the new item will be inserted. If not
-        #   set, the new item will be appended to the end of the conversation. If set to
-        #   `root`, the new item will be added to the beginning of the conversation. If set
-        #   to an existing ID, it allows an item to be inserted mid-conversation. If the ID
-        #   cannot be found, an error will be returned and the item will not be added.
+        #   set, the new item will be appended to the end of the conversation.
+        #
+        #   If set to `root`, the new item will be added to the beginning of the
+        #   conversation.
+        #
+        #   If set to an existing ID, it allows an item to be inserted mid-conversation. If
+        #   the ID cannot be found, an error will be returned and the item will not be
+        #   added.
         #
         #   @return [String, nil]
         optional :previous_item_id, String
@@ -48,7 +52,7 @@ module OpenAI
         #
         #   @param event_id [String] Optional client-generated ID used to identify this event.
         #
-        #   @param previous_item_id [String] The ID of the preceding item after which the new item will be inserted.
+        #   @param previous_item_id [String] The ID of the preceding item after which the new item will be inserted. If not s
         #
         #   @param type [Symbol, :"conversation.item.create"] The event type, must be `conversation.item.create`.
       end

data/lib/openai/models/realtime/realtime_audio_config_output.rb

@@ -23,10 +23,10 @@ module OpenAI
         optional :speed, Float
 
         # @!attribute voice
-        #   The voice the model uses to respond. Voice cannot be changed during the session
-        #   once the model has responded with audio at least once. Current voice options are
-        #   `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-        #   and `cedar`. We recommend `marin` and `cedar` for best quality.
+        #   The voice the model uses to respond. Supported built-in voices are `alloy`,
+        #   `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+        #   `cedar`. Voice cannot be changed during the session once the model has responded
+        #   with audio at least once. We recommend `marin` and `cedar` for best quality.
         #
         #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice, nil]
         optional :voice, union: -> { OpenAI::Realtime::RealtimeAudioConfigOutput::Voice }
@@ -39,12 +39,12 @@ module OpenAI
         #
         #   @param speed [Float] The speed of the model's spoken response as a multiple of the original speed.
         #
-        #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice] The voice the model uses to respond. Voice cannot be changed during the
+        #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeAudioConfigOutput::Voice] The voice the model uses to respond. Supported built-in voices are `alloy`, `ash
 
-        # The voice the model uses to respond. Voice cannot be changed during the session
-        # once the model has responded with audio at least once. Current voice options are
-        # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-        # and `cedar`. We recommend `marin` and `cedar` for best quality.
+        # The voice the model uses to respond. Supported built-in voices are `alloy`,
+        # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+        # `cedar`. Voice cannot be changed during the session once the model has responded
+        # with audio at least once. We recommend `marin` and `cedar` for best quality.
         #
         # @see OpenAI::Models::Realtime::RealtimeAudioConfigOutput#voice
         module Voice

data/lib/openai/models/realtime/realtime_response_create_audio_output.rb

@@ -23,10 +23,10 @@ module OpenAI
           optional :format_, union: -> { OpenAI::Realtime::RealtimeAudioFormats }, api_name: :format
 
           # @!attribute voice
-          #   The voice the model uses to respond. Voice cannot be changed during the session
-          #   once the model has responded with audio at least once. Current voice options are
-          #   `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-          #   and `cedar`. We recommend `marin` and `cedar` for best quality.
+          #   The voice the model uses to respond. Supported built-in voices are `alloy`,
+          #   `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          #   `cedar`. Voice cannot be changed during the session once the model has responded
+          #   with audio at least once.
           #
           #   @return [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice, nil]
           optional :voice, union: -> { OpenAI::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice }
@@ -38,12 +38,12 @@ module OpenAI
           #
           #   @param format_ [OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCM, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMU, OpenAI::Models::Realtime::RealtimeAudioFormats::AudioPCMA] The format of the output audio.
           #
-          #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice] The voice the model uses to respond. Voice cannot be changed during the
+          #   @param voice [String, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::Voice] The voice the model uses to respond. Supported built-in voices are `alloy`, `ash
 
-          # The voice the model uses to respond. Voice cannot be changed during the session
-          # once the model has responded with audio at least once. Current voice options are
-          # `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-          # and `cedar`. We recommend `marin` and `cedar` for best quality.
+          # The voice the model uses to respond. Supported built-in voices are `alloy`,
+          # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+          # `cedar`. Voice cannot be changed during the session once the model has responded
+          # with audio at least once.
           #
           # @see OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output#voice
           module Voice

data/lib/openai/models/realtime/response_function_call_arguments_done_event.rb

@@ -28,6 +28,12 @@ module OpenAI
         #   @return [String]
         required :item_id, String
 
+        # @!attribute name
+        #   The name of the function that was called.
+        #
+        #   @return [String]
+        required :name, String
+
         # @!attribute output_index
         #   The index of the output item in the response.
         #
@@ -46,7 +52,7 @@ module OpenAI
         #   @return [Symbol, :"response.function_call_arguments.done"]
         required :type, const: :"response.function_call_arguments.done"
 
-        # @!method initialize(arguments:, call_id:, event_id:, item_id:, output_index:, response_id:, type: :"response.function_call_arguments.done")
+        # @!method initialize(arguments:, call_id:, event_id:, item_id:, name:, output_index:, response_id:, type: :"response.function_call_arguments.done")
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Realtime::ResponseFunctionCallArgumentsDoneEvent} for more
         #   details.
@@ -62,6 +68,8 @@ module OpenAI
         #
         #   @param item_id [String] The ID of the function call item.
         #
+        #   @param name [String] The name of the function that was called.
+        #
         #   @param output_index [Integer] The index of the output item in the response.
         #
         #   @param response_id [String] The ID of the response.

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

@@ -79,9 +79,7 @@ module OpenAI
         optional :text, -> { OpenAI::Responses::InputTokenCountParams::Text }, nil?: true
 
         # @!attribute tool_choice
-        #   How the model should select which tool (or tools) to use when generating a
-        #   response. See the `tools` parameter to see how to specify which tools the model
-        #   can call.
+        #   Controls which tool the model should use, if any.
         #
         #   @return [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell, nil]
         optional :tool_choice, union: -> { OpenAI::Responses::InputTokenCountParams::ToolChoice }, nil?: true
@@ -123,7 +121,7 @@ module OpenAI
         #
         #   @param text [OpenAI::Models::Responses::InputTokenCountParams::Text, nil] Configuration options for a text response from the model. Can be plain
         #
-        #   @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell, nil] How the model should select which tool (or tools) to use when generating
+        #   @param tool_choice [Symbol, OpenAI::Models::Responses::ToolChoiceOptions, OpenAI::Models::Responses::ToolChoiceAllowed, OpenAI::Models::Responses::ToolChoiceTypes, OpenAI::Models::Responses::ToolChoiceFunction, OpenAI::Models::Responses::ToolChoiceMcp, OpenAI::Models::Responses::ToolChoiceCustom, OpenAI::Models::Responses::ToolChoiceApplyPatch, OpenAI::Models::Responses::ToolChoiceShell, nil] Controls which tool the model should use, if any.
         #
         #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>, nil] An array of tools the model may call while generating a response. You can specif
         #
@@ -155,6 +153,7 @@ module OpenAI
           # A text input to the model, equivalent to a text input with the `user` role.
           variant String
 
+          # A list of one or many input items to the model, containing different content types.
           variant -> { OpenAI::Models::Responses::InputTokenCountParams::Input::ResponseInputItemArray }
 
           # @!method self.variants
@@ -227,9 +226,7 @@ module OpenAI
           end
         end
 
-        # How the model should select which tool (or tools) to use when generating a
-        # response. See the `tools` parameter to see how to specify which tools the model
-        # can call.
+        # Controls which tool the model should use, if any.
         module ToolChoice
           extend OpenAI::Internal::Type::Union
 

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

@@ -144,9 +144,16 @@ module OpenAI
         #   @return [Boolean, nil]
         optional :background, OpenAI::Internal::Type::Boolean, nil?: true
 
+        # @!attribute completed_at
+        #   Unix timestamp (in seconds) of when this Response was completed. Only present
+        #   when the status is `completed`.
+        #
+        #   @return [Float, nil]
+        optional :completed_at, Float, nil?: true
+
         # @!attribute conversation
-        #   The conversation that this response belongs to. Input items and output items
-        #   from this response are automatically added to this conversation.
+        #   The conversation that this response belonged to. Input items and output items
+        #   from this response were automatically added to this conversation.
         #
         #   @return [OpenAI::Models::Responses::Response::Conversation, nil]
         optional :conversation, -> { OpenAI::Responses::Response::Conversation }, nil?: true
@@ -318,7 +325,7 @@ module OpenAI
           texts.join
         end
 
-        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
+        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Responses::Response} for more details.
         #
@@ -350,7 +357,9 @@ module OpenAI
         #
         #   @param background [Boolean, nil] Whether to run the model response in the background.
         #
-        #   @param conversation [OpenAI::Models::Responses::Response::Conversation, nil] The conversation that this response belongs to. Input items and output items fro
+        #   @param completed_at [Float, nil] Unix timestamp (in seconds) of when this Response was completed.
+        #
+        #   @param conversation [OpenAI::Models::Responses::Response::Conversation, nil] The conversation that this response belonged to. Input items and output items fr
         #
         #   @param max_output_tokens [Integer, nil] An upper bound for the number of tokens that can be generated for a response, in
         #
@@ -484,16 +493,16 @@ module OpenAI
         # @see OpenAI::Models::Responses::Response#conversation
         class Conversation < OpenAI::Internal::Type::BaseModel
           # @!attribute id
-          #   The unique ID of the conversation.
+          #   The unique ID of the conversation that this response was associated with.
           #
           #   @return [String]
           required :id, String
 
           # @!method initialize(id:)
-          #   The conversation that this response belongs to. Input items and output items
-          #   from this response are automatically added to this conversation.
+          #   The conversation that this response belonged to. Input items and output items
+          #   from this response were automatically added to this conversation.
           #
-          #   @param id [String] The unique ID of the conversation.
+          #   @param id [String] The unique ID of the conversation that this response was associated with.
         end
 
         # The retention policy for the prompt cache. Set to `24h` to enable extended

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

@@ -344,6 +344,7 @@ module OpenAI
           # A text input to the model, equivalent to a text input with the `user` role.
           variant String
 
+          # A list of one or many input items to the model, containing different content types.
           variant -> { OpenAI::Models::Responses::ResponseCompactParams::Input::ResponseInputItemArray }
 
           # @!method self.variants

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

@@ -11,6 +11,7 @@ module OpenAI
         required :id, String
 
         # @!attribute encrypted_content
+        #   The encrypted content that was produced by compaction.
         #
         #   @return [String]
         required :encrypted_content, String
@@ -22,6 +23,7 @@ module OpenAI
         required :type, const: :compaction
 
         # @!attribute created_by
+        #   The identifier of the actor that created the item.
         #
         #   @return [String, nil]
         optional :created_by, String
@@ -32,9 +34,9 @@ module OpenAI
         #
         #   @param id [String] The unique ID of the compaction item.
         #
-        #   @param encrypted_content [String]
+        #   @param encrypted_content [String] The encrypted content that was produced by compaction.
         #
-        #   @param created_by [String]
+        #   @param created_by [String] The identifier of the actor that created the item.
         #
         #   @param type [Symbol, :compaction] The type of the item. Always `compaction`.
       end

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

@@ -5,6 +5,7 @@ module OpenAI
     module Responses
       class ResponseCompactionItemParam < OpenAI::Internal::Type::BaseModel
         # @!attribute encrypted_content
+        #   The encrypted content of the compaction summary.
         #
         #   @return [String]
         required :encrypted_content, String
@@ -25,7 +26,7 @@ module OpenAI
         #   A compaction item generated by the
         #   [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
         #
-        #   @param encrypted_content [String]
+        #   @param encrypted_content [String] The encrypted content of the compaction summary.
         #
         #   @param id [String, nil] The ID of the compaction item.
         #