openai 0.94.0 → 0.96.0

data/lib/openai/models/video_create_error.rb

@@ -15,12 +15,19 @@ module OpenAI
       #   @return [String]
       required :message, String
 
+      # @!attribute headers
+      #   The Retry-After and Retry-After-Ms headers returned with the original error, if
+      #   any.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, OpenAI::Internal::Type::HashOf[String]
+
       # @!attribute misalignment
       #
       #   @return [OpenAI::Models::VideoCreateError::Misalignment, nil]
       optional :misalignment, -> { OpenAI::VideoCreateError::Misalignment }
 
-      # @!method initialize(code:, message:, misalignment: nil)
+      # @!method initialize(code:, message:, headers: nil, misalignment: nil)
       #   An error that occurred while generating the response.
       #
       #   @param code [String]
@@ -29,6 +36,10 @@ module OpenAI
       #   @param message [String]
       #     A human-readable description of the error that was returned.
       #
+      #   @param headers [Hash{Symbol=>String}]
+      #     The Retry-After and Retry-After-Ms headers returned with the original error, if
+      #     any.
+      #
       #   @param misalignment [OpenAI::Models::VideoCreateError::Misalignment]
 
       # @see OpenAI::Models::VideoCreateError#misalignment

data/lib/openai/net_http_client.rb

@@ -246,7 +246,6 @@ module OpenAI
       finished = false
       request_may_have_been_sent = false
 
-      # rubocop:disable Metrics/BlockLength
       enum = Enumerator.new do |y|
         next if finished
 
@@ -331,7 +330,6 @@ module OpenAI
           )
         )
       end
-      # rubocop:enable Metrics/BlockLength
 
       _, response = enum.next
       body = OpenAI::Internal::Util.fused_enum(enum, external: true) do

data/lib/openai/resources/admin/organization/external_storage.rb

@@ -10,7 +10,7 @@ module OpenAI
           # @overload create(project_id:, provider:, request_options: {})
           #
           # @param project_id [String]
-          # @param provider [OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Aws, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Azure]
+          # @param provider [OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Aws, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Azure, OpenAI::Models::Admin::Organization::ExternalStorageCreateParams::Provider::Gcp]
           # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
           #
           # @return [OpenAI::Models::Admin::Organization::ExternalStorageConfiguration]

data/lib/openai/resources/audio/transcriptions.rb

@@ -11,7 +11,8 @@ module OpenAI
         # Transcribes audio into the input language.
         #
         # Returns a transcription object in `json`, `diarized_json`, or `verbose_json`
-        # format, or a stream of transcript events.
+        # format, plain text in `text`, `srt`, or `vtt` format, or a stream of transcript
+        # events. Supported formats depend on the model.
         #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -108,7 +109,7 @@ module OpenAI
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [OpenAI::Models::Audio::Transcription, OpenAI::Models::Audio::TranscriptionDiarized, OpenAI::Models::Audio::TranscriptionVerbose]
+        # @return [OpenAI::Models::Audio::Transcription, OpenAI::Models::Audio::TranscriptionDiarized, OpenAI::Models::Audio::TranscriptionVerbose, StringIO]
         #
         # @see OpenAI::Models::Audio::TranscriptionCreateParams
         def create(params)
@@ -135,7 +136,8 @@ module OpenAI
         # Transcribes audio into the input language.
         #
         # Returns a transcription object in `json`, `diarized_json`, or `verbose_json`
-        # format, or a stream of transcript events.
+        # format, plain text in `text`, `srt`, or `vtt` format, or a stream of transcript
+        # events. Supported formats depend on the model.
         #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or

data/lib/openai/resources/audio/translations.rb

@@ -46,7 +46,7 @@ module OpenAI
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [OpenAI::Models::Audio::Translation, OpenAI::Models::Audio::TranslationVerbose]
+        # @return [OpenAI::Models::Audio::Translation, OpenAI::Models::Audio::TranslationVerbose, StringIO]
         #
         # @see OpenAI::Models::Audio::TranslationCreateParams
         def create(params)

data/lib/openai/resources/beta/agents/environments/templates.rb

@@ -27,7 +27,7 @@ module OpenAI
             #
             # @param network [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Network, nil]
             #   Network access policy for the environment. Defaults to disabled for GA requests
-            #   and enabled for alpha/beta requests.
+            #   and enabled for beta requests.
             #
             # @param packages [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Packages, nil]
             #   Packages to install in the environment. Defaults to empty package lists.
@@ -106,8 +106,8 @@ module OpenAI
             #
             # @param network [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Network, nil]
             #   Network access available after setup completes. Omit to preserve the current
-            #   policy, or pass `null` to reset to disabled for GA requests or enabled for
-            #   alpha/beta requests.
+            #   policy, or pass `null` to reset to disabled for GA requests or enabled for beta
+            #   requests.
             #
             # @param packages [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Packages, nil]
             #   Packages installed before the runtime network policy applies.

data/lib/openai/resources/beta/agents/vaults/credentials.rb

@@ -10,7 +10,7 @@ module OpenAI
             # See
             # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
             #
-            # @overload create(vault_id, auth:, name:, request_options: {})
+            # @overload create(vault_id, auth:, name:, metadata: nil, request_options: {})
             #
             # @param vault_id [String]
             #   The ID of the vault.
@@ -22,6 +22,10 @@ module OpenAI
             #   The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after
             #   trimming.
             #
+            # @param metadata [Hash{Symbol=>String}]
+            #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+            #   characters. Defaults to an empty map.
+            #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [OpenAI::Models::Beta::Agents::Vaults::Credential]
@@ -70,11 +74,10 @@ module OpenAI
               )
             end
 
-            # Rotates a vault credential's write-only secret and returns only credential
-            # metadata. See
+            # Updates credential metadata or rotates its write-only secret. See
             # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
             #
-            # @overload update(credential_id, vault_id:, auth:, request_options: {})
+            # @overload update(credential_id, vault_id:, auth: nil, metadata: nil, request_options: {})
             #
             # @param credential_id [String]
             #   Path param: The ID of the vault credential.
@@ -86,6 +89,11 @@ module OpenAI
             #   Body param: Replacement values for the credential's existing authentication
             #   method.
             #
+            # @param metadata [Hash{Symbol=>String}]
+            #   Body param: Replaces all metadata. Omit to preserve it, or pass {} to clear it.
+            #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+            #   characters.
+            #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
             # @return [OpenAI::Models::Beta::Agents::Vaults::Credential]

data/lib/openai/resources/beta/responses.rb

@@ -27,7 +27,10 @@ module OpenAI
         # [file search](https://developers.openai.com/api/docs/guides/tools-file-search)
         # to use your own data as input for the model's response.
         #
-        # @overload create(background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, betas: nil, request_options: {})
+        # @overload create(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, betas: nil, request_options: {})
+        #
+        # @param access_programs [OpenAI::Models::Beta::ResponseCreateParams::AccessPrograms]
+        #   Body param: Domain-specific access programs to use for this request.
         #
         # @param background [Boolean, nil]
         #   Body param: Whether to run the model response in the background.
@@ -325,7 +328,10 @@ module OpenAI
         # [file search](https://developers.openai.com/api/docs/guides/tools-file-search)
         # to use your own data as input for the model's response.
         #
-        # @overload stream_raw(background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, betas: nil, request_options: {})
+        # @overload stream_raw(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, multi_agent: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, betas: nil, request_options: {})
+        #
+        # @param access_programs [OpenAI::Models::Beta::ResponseCreateParams::AccessPrograms]
+        #   Body param: Domain-specific access programs to use for this request.
         #
         # @param background [Boolean, nil]
         #   Body param: Whether to run the model response in the background.

data/lib/openai/resources/responses.rb

@@ -28,7 +28,10 @@ module OpenAI
       # [file search](https://developers.openai.com/api/docs/guides/tools-file-search)
       # to use your own data as input for the model's response.
       #
-      # @overload create(background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+      # @overload create(access_programs: nil, background: nil, context_management: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, moderation: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+      #
+      # @param access_programs [OpenAI::Models::Responses::ResponseCreateParams::AccessPrograms]
+      #   Domain-specific access programs to use for this request.
       #
       # @param background [Boolean, nil]
       #   Whether to run the model response in the background.
@@ -305,6 +308,10 @@ module OpenAI
       end
 
       # Creates or resumes a streaming response and parses structured outputs.
+      # @overload stream(access_programs: nil, **params)
+      #   @param access_programs [OpenAI::Models::Responses::ResponseCreateParams::AccessPrograms]
+      #     Domain-specific access programs to use for this request.
+      #   @param params [Hash{Symbol=>Object}] Other response creation or retrieval parameters.
       def stream(params)
         parsed, options = OpenAI::Responses::ResponseCreateParams.dump_request(params)
         starting_after, response_id = parsed.values_at(:starting_after, :response_id)

data/lib/openai/version.rb

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

data/lib/openai.rb

@@ -256,6 +256,7 @@ require_relative "openai/models/admin/organization/external_storage_delete_param
 require_relative "openai/models/admin/organization/external_storage_list_params"
 require_relative "openai/models/admin/organization/external_storage_retrieve_params"
 require_relative "openai/models/admin/organization/external_storage_validate_params"
+require_relative "openai/models/admin/organization/gcp_external_storage_provider"
 require_relative "openai/models/admin/organization/group"
 require_relative "openai/models/admin/organization/group_create_params"
 require_relative "openai/models/admin/organization/group_delete_params"
@@ -1593,6 +1594,7 @@ require_relative "openai/streaming"
 require_relative "openai/helpers/websocket"
 require_relative "openai/helpers/realtime"
 require_relative "openai/helpers/responses_websocket"
+require_relative "openai/helpers/live/websocket"
 
 require_relative "openai/helpers/agents/session_stream"
 require_relative "openai/helpers/agents/message"

data/rbi/openai/helpers/live/transcript_grouper.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Live
+      class TranscriptGrouper
+        class Segment < Data
+          sig { returns(String) }
+          attr_reader :id
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :previous_id
+
+          # :user or :assistant
+          sig { returns(Symbol) }
+          attr_reader :speaker
+
+          sig { returns(String) }
+          attr_reader :text
+
+          sig { returns(Integer) }
+          attr_reader :start_ms, :end_ms
+        end
+
+        class ClosedSegment < Data
+          sig { returns(Segment) }
+          attr_reader :segment
+
+          # :speaker_change, :inactivity, :timestamp_reset, :session_closed or :manual
+          sig { returns(Symbol) }
+          attr_reader :reason
+        end
+
+        sig do
+          params(
+            on_segment_updated: T.nilable(T.proc.params(segment: Segment).void),
+            on_segment_closed: T.nilable(T.proc.params(event: ClosedSegment).void),
+            min_turn_separation_ms: T.any(Integer, Float),
+            assistant_silence_ms: T.any(Integer, Float),
+            backchannel_max_duration_ms: T.any(Integer, Float),
+            backchannel_isolation_ms: T.any(Integer, Float),
+            additional_acknowledgments: T::Array[String]
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+          on_segment_updated: nil,
+          on_segment_closed: nil,
+          min_turn_separation_ms: 500,
+          assistant_silence_ms: 2000,
+          backchannel_max_duration_ms: 1000,
+          backchannel_isolation_ms: 2000,
+          additional_acknowledgments: []
+        )
+        end
+
+        sig { params(event: T.anything).void }
+        def push(event)
+        end
+
+        sig { void }
+        def close
+        end
+      end
+    end
+  end
+end

data/rbi/openai/helpers/live/websocket.rbi

@@ -0,0 +1,299 @@
+# typed: strong
+
+module OpenAI
+  class Client < OpenAI::Internal::Transport::BaseClient
+    # @api private
+    sig do
+      params(
+        path: T.any(String, T::Array[String]),
+        query: T::Hash[String, String],
+        websocket_base_url: T.nilable(String),
+        options: T.nilable(OpenAI::RequestOptions::OrHash),
+        block: T
+          .proc
+          .params(
+            request: OpenAI::Internal::Transport::BaseClient::RequestInput,
+            mark_handshake_completed: T.proc.void
+          )
+          .returns(T.anything)
+      )
+        .returns(T.anything)
+    end
+    def with_live_websocket_connection_request(
+      path: "live/sessions",
+      query: {},
+      websocket_base_url: nil,
+      options: nil,
+      &block
+    )
+    end
+  end
+
+  module Errors
+    class LiveConnectionError < OpenAI::Errors::WebSocketConnectionError
+    end
+
+    class LiveProtocolError < OpenAI::Errors::WebSocketProtocolError
+      sig { returns(T.attached_class) }
+      def self.new
+      end
+    end
+  end
+
+  module Models
+    module Live
+      class UnknownServerEvent
+        sig { returns(Symbol) }
+        attr_reader :type
+        sig { returns(T::Hash[T.any(String, Symbol), T.anything]) }
+        attr_reader :data
+        sig { params(data: T::Hash[T.any(String, Symbol), T.anything]).returns(T.attached_class) }
+        def self.new(data:)
+        end
+
+        sig { returns(T::Hash[T.any(String, Symbol), T.anything]) }
+        def to_h
+        end
+
+        sig { returns(String) }
+        def inspect
+        end
+
+        alias to_s inspect
+      end
+
+      class Connection
+        include Enumerable
+        ServerEvent = T.type_alias { T.any(OpenAI::Live::ServerEvent::Variants, OpenAI::Live::UnknownServerEvent) }
+        ClientEvent = T.type_alias do
+          T.any(OpenAI::Live::ClientEvent::Variants, T::Hash[T.any(String, Symbol), T.anything])
+        end
+
+        Elem = type_member { {fixed: ServerEvent} }
+        sig { returns(URI::Generic) }
+        attr_reader :url
+        sig { params(socket: T.anything, url: URI::Generic).returns(T.attached_class) }
+        def self.new(socket:, url:)
+        end
+
+        sig do
+          params(block: T.nilable(T.proc.params(event: ServerEvent).void)).returns(
+            T.any(OpenAI::Live::Connection, T::Enumerator[ServerEvent])
+          )
+        end
+        def each(&block)
+        end
+
+        sig { returns(T.nilable(ServerEvent)) }
+        def receive
+        end
+
+        sig { returns(T.nilable(String)) }
+        def receive_raw
+        end
+
+        sig { params(event: ClientEvent).void }
+        def send_event(event)
+        end
+
+        sig { params(data: String).void }
+        def send_raw(data)
+        end
+
+        sig { params(code: Integer, reason: String).void }
+        def close(code: 1000, reason: "")
+        end
+
+        sig { void }
+        def abort
+        end
+
+        sig { returns(T::Boolean) }
+        def closed?
+        end
+      end
+
+      class SidebandConnection
+        include Enumerable
+        ClientEvent = T.type_alias do
+          T.any(
+            OpenAI::Live::SessionUpdateEvent,
+            OpenAI::Live::InputAudioMuteEvent,
+            OpenAI::Live::InputAudioUnmuteEvent,
+            OpenAI::Live::InstructionsAppendEvent,
+            OpenAI::Live::ThinkingAppendEvent,
+            OpenAI::Live::CommentaryAppendEvent,
+            OpenAI::Live::ResponseItemCreateEvent,
+            OpenAI::Live::ResponseCreateEvent,
+            OpenAI::Live::SessionCloseEvent,
+            T::Hash[T.any(String, Symbol), T.anything]
+          )
+        end
+
+        Elem = type_member { {fixed: Connection::ServerEvent} }
+        sig { returns(URI::Generic) }
+        attr_reader :url
+        sig { params(socket: T.anything, url: URI::Generic).returns(T.attached_class) }
+        def self.new(socket:, url:)
+        end
+
+        sig do
+          params(block: T.nilable(T.proc.params(event: Connection::ServerEvent).void)).returns(
+            T.any(OpenAI::Live::SidebandConnection, T::Enumerator[Connection::ServerEvent])
+          )
+        end
+        def each(&block)
+        end
+
+        sig { returns(T.nilable(Connection::ServerEvent)) }
+        def receive
+        end
+
+        sig { returns(T.nilable(String)) }
+        def receive_raw
+        end
+
+        sig { params(event: ClientEvent).void }
+        def send_event(event)
+        end
+
+        sig { params(data: String).void }
+        def send_raw(data)
+        end
+
+        sig { params(code: Integer, reason: String).void }
+        def close(code: 1000, reason: "")
+        end
+
+        sig { void }
+        def abort
+        end
+
+        sig { returns(T::Boolean) }
+        def closed?
+        end
+      end
+
+      # Fork sessions use distinct input/output variants; expose that protocol
+      # directly so the primary Connection's shipped signatures stay precise.
+      class ForkConnection
+        include Enumerable
+        ServerEvent = T.type_alias { T.any(OpenAI::Live::ForkServerEvent::Variants, OpenAI::Live::UnknownServerEvent) }
+        ClientEvent = T.type_alias do
+          T.any(OpenAI::Live::ForkClientEvent::Variants, T::Hash[T.any(String, Symbol), T.anything])
+        end
+
+        Elem = type_member { {fixed: ServerEvent} }
+        sig { returns(URI::Generic) }
+        attr_reader :url
+        sig { params(socket: T.anything, url: URI::Generic).returns(T.attached_class) }
+        def self.new(socket:, url:)
+        end
+
+        sig do
+          params(block: T.nilable(T.proc.params(event: ServerEvent).void)).returns(
+            T.any(OpenAI::Live::ForkConnection, T::Enumerator[ServerEvent])
+          )
+        end
+        def each(&block)
+        end
+
+        sig { returns(T.nilable(ServerEvent)) }
+        def receive
+        end
+
+        sig { returns(T.nilable(String)) }
+        def receive_raw
+        end
+
+        sig { params(event: ClientEvent).void }
+        def send_event(event)
+        end
+
+        sig { params(data: String).void }
+        def send_raw(data)
+        end
+
+        sig { params(code: Integer, reason: String).void }
+        def close(code: 1000, reason: "")
+        end
+
+        sig { void }
+        def abort
+        end
+
+        sig { returns(T::Boolean) }
+        def closed?
+        end
+      end
+    end
+  end
+
+  module Resources
+    class Live
+      sig do
+        type_parameters(:T)
+          .params(
+            websocket_base_url: T.nilable(String),
+            request_options: T.nilable(OpenAI::RequestOptions::OrHash),
+            transport: T.untyped,
+            transport_options: T::Hash[Symbol, T.anything],
+            block: T.proc.params(connection: OpenAI::Live::Connection).returns(T.type_parameter(:T))
+          )
+          .returns(T.type_parameter(:T))
+      end
+      def connect(websocket_base_url: nil, request_options: nil, transport: nil, transport_options: {}, &block)
+      end
+
+      class Sideband
+        sig do
+          type_parameters(:T)
+            .params(
+              session_id: String,
+              graceful_close: T.nilable(T::Boolean),
+              websocket_base_url: T.nilable(String),
+              request_options: T.nilable(OpenAI::RequestOptions::OrHash),
+              transport: T.untyped,
+              transport_options: T::Hash[Symbol, T.anything],
+              block: T.proc.params(connection: OpenAI::Live::SidebandConnection).returns(T.type_parameter(:T))
+            )
+            .returns(T.type_parameter(:T))
+        end
+        def connect(
+          session_id,
+          graceful_close: nil,
+          websocket_base_url: nil,
+          request_options: nil,
+          transport: nil,
+          transport_options: {},
+          &block
+        )
+        end
+      end
+
+      class Forks
+        sig do
+          type_parameters(:T)
+            .params(
+              session_id: String,
+              websocket_base_url: T.nilable(String),
+              request_options: T.nilable(OpenAI::RequestOptions::OrHash),
+              transport: T.untyped,
+              transport_options: T::Hash[Symbol, T.anything],
+              block: T.proc.params(connection: OpenAI::Live::ForkConnection).returns(T.type_parameter(:T))
+            )
+            .returns(T.type_parameter(:T))
+        end
+        def connect(
+          session_id,
+          websocket_base_url: nil,
+          request_options: nil,
+          transport: nil,
+          transport_options: {},
+          &block
+        )
+        end
+      end
+    end
+  end
+end