openai 0.86.0 → 0.88.0

data/lib/openai/resources/vector_stores.rb

@@ -9,24 +9,36 @@ module OpenAI
       # @return [OpenAI::Resources::VectorStores::FileBatches]
       attr_reader :file_batches
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VectorStoreCreateParams} for more details.
-      #
       # Create a vector store.
       #
       # @overload create(chunking_strategy: nil, description: nil, expires_after: nil, file_ids: nil, metadata: nil, name: nil, request_options: {})
       #
-      # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam] The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+      # @param chunking_strategy [OpenAI::Models::AutoFileChunkingStrategyParam, OpenAI::Models::StaticFileChunkingStrategyObjectParam]
+      #   The chunking strategy used to chunk the file(s). If not set, will use the `auto`
+      #   strategy. Only applicable if `file_ids` is non-empty.
+      #
+      # @param description [String]
+      #   A description for the vector store. Can be used to describe the vector store's
+      #   purpose.
       #
-      # @param description [String] A description for the vector store. Can be used to describe the vector store's p
+      # @param expires_after [OpenAI::Models::VectorStoreCreateParams::ExpiresAfter]
+      #   The expiration policy for a vector store.
       #
-      # @param expires_after [OpenAI::Models::VectorStoreCreateParams::ExpiresAfter] The expiration policy for a vector store.
+      # @param file_ids [Array<String>]
+      #   A list of [File](https://developers.openai.com/api/reference/resources/files)
+      #   IDs that the vector store should use. Useful for tools like `file_search` that
+      #   can access files.
       #
-      # @param file_ids [Array<String>] A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
+      # @param metadata [Hash{Symbol=>String}, nil]
+      #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+      #   for storing additional information about the object in a structured format, and
+      #   querying for objects via API or the dashboard.
       #
-      # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+      #   Keys are strings with a maximum length of 64 characters. Values are strings with
+      #   a maximum length of 512 characters.
       #
-      # @param name [String] The name of the vector store.
+      # @param name [String]
+      #   The name of the vector store.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -49,7 +61,8 @@ module OpenAI
       #
       # @overload retrieve(vector_store_id, request_options: {})
       #
-      # @param vector_store_id [String] The ID of the vector store to retrieve.
+      # @param vector_store_id [String]
+      #   The ID of the vector store to retrieve.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -66,20 +79,26 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VectorStoreUpdateParams} for more details.
-      #
       # Modifies a vector store.
       #
       # @overload update(vector_store_id, expires_after: nil, metadata: nil, name: nil, request_options: {})
       #
-      # @param vector_store_id [String] The ID of the vector store to modify.
+      # @param vector_store_id [String]
+      #   The ID of the vector store to modify.
       #
-      # @param expires_after [OpenAI::Models::VectorStoreUpdateParams::ExpiresAfter, nil] The expiration policy for a vector store.
+      # @param expires_after [OpenAI::Models::VectorStoreUpdateParams::ExpiresAfter, nil]
+      #   The expiration policy for a vector store.
       #
-      # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+      # @param metadata [Hash{Symbol=>String}, nil]
+      #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+      #   for storing additional information about the object in a structured format, and
+      #   querying for objects via API or the dashboard.
       #
-      # @param name [String, nil] The name of the vector store.
+      #   Keys are strings with a maximum length of 64 characters. Values are strings with
+      #   a maximum length of 512 characters.
+      #
+      # @param name [String, nil]
+      #   The name of the vector store.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -98,20 +117,29 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VectorStoreListParams} for more details.
-      #
       # Returns a list of vector stores.
       #
       # @overload list(after: nil, before: nil, limit: nil, order: nil, request_options: {})
       #
-      # @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
+      # @param after [String]
+      #   A cursor for use in pagination. `after` is an object ID that defines your place
+      #   in the list. For instance, if you make a list request and receive 100 objects,
+      #   ending with obj_foo, your subsequent call can include after=obj_foo in order to
+      #   fetch the next page of the list.
       #
-      # @param before [String] A cursor for use in pagination. `before` is an object ID that defines your place
+      # @param before [String]
+      #   A cursor for use in pagination. `before` is an object ID that defines your place
+      #   in the list. For instance, if you make a list request and receive 100 objects,
+      #   starting with obj_foo, your subsequent call can include before=obj_foo in order
+      #   to fetch the previous page of the list.
       #
-      # @param limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1
+      # @param limit [Integer]
+      #   A limit on the number of objects to be returned. Limit can range between 1 and
+      #   100, and the default is 20.
       #
-      # @param order [Symbol, OpenAI::Models::VectorStoreListParams::Order] Sort order by the `created_at` timestamp of the objects. `asc` for ascending ord
+      # @param order [Symbol, OpenAI::Models::VectorStoreListParams::Order]
+      #   Sort order by the `created_at` timestamp of the objects. `asc` for ascending
+      #   order and `desc` for descending order.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -136,7 +164,8 @@ module OpenAI
       #
       # @overload delete(vector_store_id, request_options: {})
       #
-      # @param vector_store_id [String] The ID of the vector store to delete.
+      # @param vector_store_id [String]
+      #   The ID of the vector store to delete.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -153,25 +182,29 @@ module OpenAI
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VectorStoreSearchParams} for more details.
-      #
       # Search a vector store for relevant chunks based on a query and file attributes
       # filter.
       #
       # @overload search(vector_store_id, query:, filters: nil, max_num_results: nil, ranking_options: nil, rewrite_query: nil, request_options: {})
       #
-      # @param vector_store_id [String] The ID of the vector store to search.
+      # @param vector_store_id [String]
+      #   The ID of the vector store to search.
       #
-      # @param query [String, Array<String>] A query string for a search
+      # @param query [String, Array<String>]
+      #   A query string for a search
       #
-      # @param filters [OpenAI::Models::ComparisonFilter, OpenAI::Models::CompoundFilter] A filter to apply based on file attributes.
+      # @param filters [OpenAI::Models::ComparisonFilter, OpenAI::Models::CompoundFilter]
+      #   A filter to apply based on file attributes.
       #
-      # @param max_num_results [Integer] The maximum number of results to return. This number should be between 1 and 50
+      # @param max_num_results [Integer]
+      #   The maximum number of results to return. This number should be between 1 and 50
+      #   inclusive.
       #
-      # @param ranking_options [OpenAI::Models::VectorStoreSearchParams::RankingOptions] Ranking options for search.
+      # @param ranking_options [OpenAI::Models::VectorStoreSearchParams::RankingOptions]
+      #   Ranking options for search.
       #
-      # @param rewrite_query [Boolean] Whether to rewrite the natural language query for vector search.
+      # @param rewrite_query [Boolean]
+      #   Whether to rewrite the natural language query for vector search.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/resources/videos.rb

@@ -7,9 +7,6 @@ module OpenAI
     class Videos
       # @deprecated The Sora API is scheduled to permanently shut down on September 24, 2026.
       #
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VideoCreateParams} for more details.
-      #
       # Create a new video generation job from a prompt and optional reference assets.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
@@ -18,15 +15,26 @@ module OpenAI
       #
       # @overload create(prompt:, input_reference: nil, model: nil, seconds: nil, size: nil, request_options: {})
       #
-      # @param prompt [String] Text prompt that describes the video to generate.
+      # @param prompt [String]
+      #   Text prompt that describes the video to generate.
+      #
+      # @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam]
+      #   Optional reference asset upload or reference object that guides generation.
       #
-      # @param input_reference [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::ImageInputReferenceParam] Optional reference asset upload or reference object that guides generation.
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
-      # @param model [String, Symbol, OpenAI::Models::VideoModel] The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+      # @param model [String, Symbol, OpenAI::Models::VideoModel]
+      #   The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults
+      #   to `sora-2`.
       #
-      # @param seconds [Symbol, OpenAI::Models::VideoSeconds] Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
+      # @param seconds [Symbol, OpenAI::Models::VideoSeconds]
+      #   Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.
       #
-      # @param size [Symbol, OpenAI::Models::VideoSize] Output resolution formatted as width x height (allowed values: 720x1280, 1280x72
+      # @param size [Symbol, OpenAI::Models::VideoSize]
+      #   Output resolution formatted as width x height (allowed values: 720x1280,
+      #   1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -52,7 +60,8 @@ module OpenAI
       #
       # @overload retrieve(video_id, request_options: {})
       #
-      # @param video_id [String] The identifier of the video to retrieve.
+      # @param video_id [String]
+      #   The identifier of the video to retrieve.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -71,18 +80,19 @@ module OpenAI
 
       # @deprecated The Sora API is scheduled to permanently shut down on September 24, 2026.
       #
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VideoListParams} for more details.
-      #
       # List recently generated videos for the current project.
       #
       # @overload list(after: nil, limit: nil, order: nil, request_options: {})
       #
-      # @param after [String] Identifier for the last item from the previous pagination request
+      # @param after [String]
+      #   Identifier for the last item from the previous pagination request
       #
-      # @param limit [Integer] Number of items to retrieve
+      # @param limit [Integer]
+      #   Number of items to retrieve
       #
-      # @param order [Symbol, OpenAI::Models::VideoListParams::Order] Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+      # @param order [Symbol, OpenAI::Models::VideoListParams::Order]
+      #   Sort order of results by timestamp. Use `asc` for ascending order or `desc` for
+      #   descending order.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -109,7 +119,8 @@ module OpenAI
       #
       # @overload delete(video_id, request_options: {})
       #
-      # @param video_id [String] The identifier of the video to delete.
+      # @param video_id [String]
+      #   The identifier of the video to delete.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -136,9 +147,15 @@ module OpenAI
       #
       # @overload create_character(name:, video:, request_options: {})
       #
-      # @param name [String] Display name for this API character.
+      # @param name [String]
+      #   Display name for this API character.
+      #
+      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart]
+      #   Video file used to create a character.
       #
-      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart] Video file used to create a character.
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -166,9 +183,11 @@ module OpenAI
       #
       # @overload download_content(video_id, variant: nil, request_options: {})
       #
-      # @param video_id [String] The identifier of the video whose media to download.
+      # @param video_id [String]
+      #   The identifier of the video whose media to download.
       #
-      # @param variant [Symbol, OpenAI::Models::VideoDownloadContentParams::Variant] Which downloadable asset to return. Defaults to the MP4 video.
+      # @param variant [Symbol, OpenAI::Models::VideoDownloadContentParams::Variant]
+      #   Which downloadable asset to return. Defaults to the MP4 video.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -200,9 +219,15 @@ module OpenAI
       #
       # @overload edit(prompt:, video:, request_options: {})
       #
-      # @param prompt [String] Text prompt that describes how to edit the source video.
+      # @param prompt [String]
+      #   Text prompt that describes how to edit the source video.
       #
-      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoEditParams::Video::VideoReferenceInputParam] Reference to the completed video to edit.
+      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoEditParams::Video::VideoReferenceInputParam]
+      #   Reference to the completed video to edit.
+      #
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -224,9 +249,6 @@ module OpenAI
 
       # @deprecated The Sora API is scheduled to permanently shut down on September 24, 2026.
       #
-      # Some parameter documentations has been truncated, see
-      # {OpenAI::Models::VideoExtendParams} for more details.
-      #
       # Create an extension of a completed video.
       #
       # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
@@ -235,11 +257,19 @@ module OpenAI
       #
       # @overload extend_(prompt:, seconds:, video:, request_options: {})
       #
-      # @param prompt [String] Updated text prompt that directs the extension generation.
+      # @param prompt [String]
+      #   Updated text prompt that directs the extension generation.
+      #
+      # @param seconds [Symbol, OpenAI::Models::VideoSeconds]
+      #   Length of the newly generated extension segment in seconds (allowed values: 4,
+      #   8, 12, 16, 20).
       #
-      # @param seconds [Symbol, OpenAI::Models::VideoSeconds] Length of the newly generated extension segment in seconds (allowed values: 4, 8
+      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam]
+      #   Reference to the completed video to extend.
       #
-      # @param video [Pathname, StringIO, IO, String, OpenAI::FilePart, OpenAI::Models::VideoExtendParams::Video::VideoReferenceInputParam] Reference to the completed video to extend.
+      #   `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+      #   metadata. Use `OpenAI::FilePart` when you need to override the filename or
+      #   content type.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -265,7 +295,8 @@ module OpenAI
       #
       # @overload get_character(character_id, request_options: {})
       #
-      # @param character_id [String] The identifier of the character to retrieve.
+      # @param character_id [String]
+      #   The identifier of the character to retrieve.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -288,9 +319,11 @@ module OpenAI
       #
       # @overload remix(video_id, prompt:, request_options: {})
       #
-      # @param video_id [String] The identifier of the completed video to remix.
+      # @param video_id [String]
+      #   The identifier of the completed video to remix.
       #
-      # @param prompt [String] Updated text prompt that directs the remix generation.
+      # @param prompt [String]
+      #   Updated text prompt that directs the remix generation.
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.86.0"
+  VERSION = "0.88.0"
 end

data/local-audio.md

@@ -0,0 +1,146 @@
+# Local recording and playback
+
+Use `OpenAI::LocalAudio` to record a finite microphone clip or play generated
+speech. These helpers run separately installed FFmpeg and FFplay executables.
+They do not add native gem dependencies. Loading `openai` or the helper does not
+open a device; calling `record` or `play` starts the corresponding operation.
+
+## Setup
+
+Install FFmpeg and FFplay and make both executables available on `PATH`. Your
+FFmpeg build must include the capture backend for your operating system. Allow
+microphone access in your operating system when recording.
+
+With `OPENAI_API_KEY` configured, run:
+
+```sh
+bundle exec ruby examples/audio/record_and_play.rb
+```
+
+The example records five seconds, uploads the clip for transcription, prints the
+transcript, and plays generated speech. Models and voice are constants at the top
+of the example so they are easy to change.
+
+## Record a clip
+
+```ruby
+require "openai"
+require "openai/helpers/local_audio"
+
+client = OpenAI::Client.new
+clip = OpenAI::LocalAudio.record(duration: 5, timeout: 10)
+transcript = client.audio.transcriptions.create(model: "gpt-transcribe", file: clip)
+puts(transcript.text)
+```
+
+`record(duration:, device: nil, timeout: nil)` returns an `OpenAI::FilePart`
+containing a rewound `StringIO`, named `audio.wav` with content type `audio/wav`.
+The audio is mono, 24 kHz, signed 16-bit PCM. The helper buffers the recording in
+memory, so memory use grows with recording duration.
+
+`duration` is required and must be positive and finite. `timeout` is an optional
+positive, finite wall-clock deadline in seconds. An expired deadline raises an
+error rather than returning a partial recording.
+
+### Choose a microphone
+
+On macOS and Linux, omitting `device:` uses the capture backend's default device.
+To select another microphone, pass `device:` directly:
+
+```ruby
+# macOS: AVFoundation audio device index (or its device name).
+clip = OpenAI::LocalAudio.record(duration: 5, device: 0)
+
+# Linux: ALSA device name; integer 0 is shorthand for "hw:0".
+clip = OpenAI::LocalAudio.record(duration: 5, device: "hw:0")
+
+# Windows: DirectShow requires an explicit audio device name.
+clip = OpenAI::LocalAudio.record(duration: 5, device: "Microphone (USB Audio)")
+```
+
+For Windows, add the appropriate `device:` argument to the example's `record`
+call. There is no device environment variable to configure. Device names and
+indices are local to your machine and may change when hardware is reconnected.
+
+List capture devices using your platform's tools:
+
+```sh
+# macOS (FFmpeg prints the list and exits without recording)
+ffmpeg -f avfoundation -list_devices true -i ""
+
+# Linux
+arecord -L
+
+# Windows (FFmpeg prints the list and exits without recording)
+ffmpeg -list_devices true -f dshow -i dummy
+```
+
+## Play speech
+
+```ruby
+speech = client.audio.speech.create(
+  model: "gpt-4o-mini-tts",
+  voice: "marin",
+  input: "Recording complete."
+)
+OpenAI::LocalAudio.play(speech, timeout: 30)
+```
+
+`play(source, format: :auto, timeout: nil)` waits for FFplay to finish and returns
+`nil`. It accepts `IO`, `StringIO`, or a `FilePart` containing IO or binary bytes.
+It reads from the source's current position and leaves caller-owned IO open. Bare
+strings are not interpreted as file paths or URLs.
+
+The default `format: :auto` supports self-contained WAV, MP3, Ogg, AAC and FLAC
+streams. For headerless mono 24 kHz signed little-endian PCM16, pass
+`format: :pcm`. PCM must end on a complete two-byte sample. Playback uses FFplay's
+configured output device; this helper has no output-device selector.
+
+Both methods close their pipes and terminate/reap owned subprocesses on errors
+or interruption. Errors are under `OpenAI::LocalAudio::Error`:
+`DependencyError`, `UnsupportedPlatformError`, `DeviceError`, `PlaybackError`,
+`FormatError`, and `TimeoutError`. Media subprocesses receive a restricted
+environment without the API key, and their diagnostics are not included in
+exceptions. FFplay can exit successfully despite a decoder or device error, so
+the helper drains error-level diagnostics through a pipe, retaining only whether
+an error occurred. Diagnostic contents are discarded and never written to disk.
+
+## Model choices
+
+Checked against OpenAI documentation on September 8, 2026:
+
+- [`gpt-transcribe`](https://developers.openai.com/api/docs/guides/speech-to-text) is the recommended model for general-purpose file transcription.
+- [`gpt-4o-mini-tts`](https://developers.openai.com/api/docs/guides/text-to-speech) is the current recommended speech-generation model; `marin` is one of the recommended voices for quality.
+
+## Realtime applications
+
+For streaming audio and conversation events, use the existing
+[Realtime API helpers](realtime.md) and [Realtime examples](examples/realtime/README.md).
+The finite helpers here do not manage a continuous microphone stream,
+interruptible voice conversation, echo cancellation, or playback-position tracking.
+
+## End-to-end verification
+
+Run the actual recording example against the live API without opening physical
+devices:
+
+```sh
+bundle exec ruby scripts/test-local-audio-examples.rb
+```
+
+To also run the invalid-audio regression against installed FFplay:
+
+```sh
+OPENAI_AUDIO_FFPLAY_TEST=1 bundle exec ruby test/openai/helpers/local_audio_test.rb
+```
+
+This opt-in test requires `OPENAI_API_KEY`, FFmpeg and FFplay and makes paid API
+calls. It generates synthetic speech, substitutes that file for microphone input,
+runs real FFmpeg capture and transcription, generates speech, and plays it through
+FFplay's dummy output driver. It checks the transcription and successful example
+completion with a 90-second example deadline. Captured API output is not logged;
+temporary synthetic media is removed on normal exit or exceptions.
+
+This verifies the software flow, not physical microphone permissions, speaker
+output, or device compatibility. Physical hardware and platform behavior must be
+checked on the intended host.

data/rbi/openai/helpers/local_audio/interface.rbi

@@ -0,0 +1,110 @@
+# typed: strong
+
+module OpenAI
+  module LocalAudio
+    sig {
+      params(duration: Numeric, device: T.nilable(T.any(String, Integer)), timeout: T.nilable(Numeric)).returns(
+        OpenAI::FilePart
+      )
+    }
+    def self.record(duration:, device: nil, timeout: nil)
+    end
+
+    sig {
+      params(source: T.any(IO, StringIO, OpenAI::FilePart), format: Symbol, timeout: T.nilable(Numeric)).returns(
+        NilClass
+      )
+    }
+    def self.play(source, format: :auto, timeout: nil)
+    end
+
+    # @api private
+    sig { params(source: T.any(IO, StringIO, OpenAI::FilePart)).returns(T.any(IO, StringIO)) }
+    def self.playback_source(source)
+    end
+
+    # @api private
+    sig { params(device: T.nilable(T.any(String, Integer)), platform: String).returns([String, String]) }
+    def self.capture_device(device, platform: RUBY_PLATFORM)
+    end
+
+    # @api private
+    sig { params(bytes: Integer).returns(String) }
+    def self.wav_header(bytes)
+    end
+
+    # @api private
+    class MediaProcess
+      sig { returns(T::Hash[String, String]) }
+      def self.environment
+      end
+
+      sig { returns(Float) }
+      def self.clock
+      end
+
+      sig { params(value: Numeric, name: T.any(String, Symbol)).returns(Float) }
+      def self.duration(value, name:)
+      end
+
+      sig {
+        params(
+          argv: T::Array[String],
+          input: T.any(IO, String),
+          output: T.any(IO, String),
+          timeout: T.nilable(Numeric),
+          capture_errors: T::Boolean
+        )
+          .void
+      }
+      def initialize(argv, input:, output:, timeout:, capture_errors: false)
+      end
+
+      sig { void }
+      def check_deadline
+      end
+
+      sig { returns(T::Boolean) }
+      def errors?
+      end
+
+      sig { params(io: T.any(IO, StringIO), stop_on_exit: T::Boolean).returns(T.nilable(String)) }
+      def read(io, stop_on_exit: false)
+      end
+
+      sig { params(io: IO, bytes: String).void }
+      def write(io, bytes)
+      end
+
+      sig { returns(Process::Status) }
+      def wait
+      end
+
+      sig { void }
+      def close
+      end
+    end
+
+    class Error < OpenAI::Errors::Error
+    end
+
+    class DependencyError < OpenAI::LocalAudio::Error
+    end
+
+    class UnsupportedPlatformError < OpenAI::LocalAudio::Error
+    end
+
+    class DeviceError < OpenAI::LocalAudio::Error
+    end
+
+    class PlaybackError < OpenAI::LocalAudio::Error
+    end
+
+    class TimeoutError < OpenAI::LocalAudio::Error
+    end
+
+    class FormatError < OpenAI::LocalAudio::Error
+    end
+
+  end
+end

data/rbi/openai/helpers/realtime/connection.rbi

@@ -39,9 +39,9 @@ module OpenAI
 
         # @api private
         sig do
-          params(socket: T.untyped, url: URI::Generic).returns(T.attached_class)
+          params(socket: T.untyped, url: URI::Generic, recovery: T.untyped).returns(T.attached_class)
         end
-        def self.new(socket:, url:)
+        def self.new(socket:, url:, recovery: nil)
         end
 
         sig do
@@ -75,6 +75,22 @@ module OpenAI
         def send_raw(data)
         end
 
+        sig { returns(T::Boolean) }
+        def reconnecting?
+        end
+
+        sig { returns(T::Array[String]) }
+        def pending_messages
+        end
+
+        sig { returns(T::Array[String]) }
+        def take_pending_messages
+        end
+
+        sig { void }
+        def flush_pending
+        end
+
         sig { params(code: Integer, reason: String).void }
         def close(code: 1000, reason: "")
         end