openai 0.114.0 → 0.115.1

data/rbi/openai/models/responses/responses_client_event.rbi

@@ -56,6 +56,15 @@ module OpenAI
           sig { returns(T.nilable(T.any(String, OpenAI::Responses::ResponseConversationParam))) }
           attr_accessor :conversation
 
+          # Whether to generate output for this response. Defaults to true when omitted. Set
+          # to false to prepare request state without model output; the response ID can be
+          # used as previous_response_id on a later turn.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :generate
+
+          sig { params(generate: T::Boolean).void }
+          attr_writer :generate
+
           # Specify additional output data to include in the model response. Currently
           # supported values are:
           #
@@ -496,6 +505,8 @@ module OpenAI
 
               conversation: T.nilable(T.any(String, OpenAI::Responses::ResponseConversationParam::OrHash)),
 
+              generate: T::Boolean,
+
               include: T.nilable(T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]),
 
               input: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::Input::Variants,
@@ -607,6 +618,11 @@ module OpenAI
             # response completes.
             conversation: nil,
 
+            # Whether to generate output for this response. Defaults to true when omitted. Set
+            # to false to prepare request state without model output; the response ID can be
+            # used as previous_response_id on a later turn.
+            generate: nil,
+
             # Specify additional output data to include in the model response. Currently
             # supported values are:
             #
@@ -870,6 +886,7 @@ module OpenAI
                   T::Array[OpenAI::Responses::ResponsesClientEvent::ResponseCreate::ContextManagement]
                 ),
                 conversation: T.nilable(T.any(String, OpenAI::Responses::ResponseConversationParam)),
+                generate: T.nilable(T::Boolean),
                 include: T.nilable(T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]),
                 input: T.nilable(OpenAI::Responses::ResponsesClientEvent::ResponseCreate::Input::Variants),
                 instructions: T.nilable(String),

data/rbi/openai/models/responses/tool.rbi

@@ -979,8 +979,8 @@ module OpenAI
 
           # Control how much effort the model will exert to match the style and features,
           # especially facial features, of input images. Supports `high` and `low` on
-          # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          # this parameter. Defaults to `low` on supported models.
           sig { returns(T.nilable(OpenAI::Responses::Tool::ImageGeneration::InputFidelity::OrSymbol)) }
           attr_accessor :input_fidelity
 
@@ -1110,8 +1110,8 @@ module OpenAI
 
             # Control how much effort the model will exert to match the style and features,
             # especially facial features, of input images. Supports `high` and `low` on
-            # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+            # this parameter. Defaults to `low` on supported models.
             input_fidelity: nil,
 
             # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -1229,8 +1229,8 @@ module OpenAI
 
           # Control how much effort the model will exert to match the style and features,
           # especially facial features, of input images. Supports `high` and `low` on
-          # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-          # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+          # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+          # this parameter. Defaults to `low` on supported models.
           module InputFidelity
             extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/net_http_client.rbi

@@ -2,6 +2,11 @@
 
 module OpenAI
   class NetHTTPClient < OpenAI::HTTPClient
+    # @api private
+    sig { returns(T::Boolean) }
+    def default_configuration?
+    end
+
     KEEP_ALIVE_TIMEOUT = 30
 
     DEFAULT_MAX_CONNECTIONS = T.let(T.unsafe(nil), Integer)

data/rbi/openai/resources/admin/organization/external_keys.rbi

@@ -0,0 +1,86 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Admin
+
+      class Organization
+
+        class ExternalKeys
+
+          # Add an external key config for an organization
+          sig {
+            params(
+              body: T.any(
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Aws::OrHash,
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Gcp::OrHash,
+                OpenAI::Admin::Organization::ExternalKeyCreateParams::Body::Azure::OrHash
+              ),
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Admin::Organization::ExternalKey)
+          }
+          def create(body:, request_options: {})
+          end
+
+          # Retrieve a stored external key registration for the user's organization.
+          sig {
+            params(external_key_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Admin::Organization::ExternalKey
+            )
+          }
+          def retrieve(external_key_id, request_options: {})
+          end
+
+          # List the external key configs registered on the user's organization
+          sig {
+            params(
+              after: T.nilable(String),
+              limit: Integer,
+              order: OpenAI::Admin::Organization::ExternalKeyListParams::Order::OrSymbol,
+              purpose: OpenAI::Admin::Organization::ExternalKeyListParams::Purpose::OrSymbol,
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Internal::CursorPage[OpenAI::Admin::Organization::ExternalKey])
+          }
+          def list(
+            after: nil,
+            limit: nil,
+            order: nil,
+            # Filter by key purpose. When omitted, returns keys of all purposes.
+            purpose: nil,
+            request_options: {}
+          )
+          end
+
+          # Delete an external key config for the user's organization
+          sig {
+            params(external_key_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Admin::Organization::ExternalKey
+            )
+          }
+          def delete(external_key_id, request_options: {})
+          end
+
+          # Validate an external key config for the user's organization
+          sig {
+            params(external_key_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+              OpenAI::Models::Admin::Organization::ExternalKeyValidateResponse
+            )
+          }
+          def validate(external_key_id, request_options: {})
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/admin/organization.rbi

@@ -32,6 +32,9 @@ module OpenAI
         sig { returns(OpenAI::Resources::Admin::Organization::DataRetention) }
         attr_reader :data_retention
 
+        sig { returns(OpenAI::Resources::Admin::Organization::ExternalKeys) }
+        attr_reader :external_keys
+
         sig { returns(OpenAI::Resources::Admin::Organization::ExternalStorage) }
         attr_reader :external_storage
 

data/rbi/openai/resources/audio/speech.rbi

@@ -11,6 +11,14 @@ module OpenAI
         # Generates audio from the input text.
         #
         # Returns the audio file content, or a stream of audio events.
+        #
+        # The `tts-1`, `tts-1-hd`, `gpt-4o-mini-tts`, `gpt-4o-mini-tts-2025-03-20`, and
+        # `gpt-4o-mini-tts-2025-12-15` models are deprecated and scheduled to shut down on
+        # January 6, 2027. These examples use the existing Speech API; for new
+        # integrations, migrate to `gpt-realtime-2.1-mini` through the
+        # [Realtime API](https://developers.openai.com/api/docs/guides/realtime). See the
+        # [deprecation schedule](https://developers.openai.com/api/docs/deprecations) for
+        # migration details.
         sig {
           params(
             input: String,

data/rbi/openai/resources/audio/translations.rbi

@@ -9,6 +9,12 @@ module OpenAI
       class Translations
 
         # Translates audio into English.
+        #
+        # This endpoint supports only `whisper-1`. The endpoint and model are deprecated
+        # and scheduled to shut down on February 26, 2027. Migrate to
+        # `/v1/realtime/translations`, which requires a separate integration. See the
+        # [deprecation schedule](https://developers.openai.com/api/docs/deprecations) for
+        # details.
         sig {
           params(
             file: OpenAI::Internal::FileInput,

data/rbi/openai/resources/beta/agents/sessions.rbi

@@ -44,6 +44,7 @@ module OpenAI
               agent_id: String,
               input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
               metadata: T.nilable(T::Hash[Symbol, String]),
+              review: OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol,
               spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
               vault_ids: T.nilable(T::Array[String]),
               stream: T.noreturn,
@@ -68,6 +69,8 @@ module OpenAI
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
+            # Action review mode. Omit to use none.
+            review: nil,
             # Optional spending limit in USD cents. Omission or null creates an unlimited
             # session.
             spend_control: nil,
@@ -99,6 +102,7 @@ module OpenAI
               output_type: T.nilable(T.class_of(OpenAI::Helpers::StructuredOutput::BaseModel)),
               input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
               metadata: T.nilable(T::Hash[Symbol, String]),
+              review: OpenAI::Beta::Agents::SessionCreateParams::Review::OrSymbol,
               spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
               vault_ids: T.nilable(T::Array[String]),
               stream: T.noreturn,
@@ -125,6 +129,8 @@ module OpenAI
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
+            # Action review mode. Omit to use none.
+            review: nil,
             # Optional spending limit in USD cents. Omission or null creates an unlimited
             # session.
             spend_control: nil,
@@ -151,7 +157,7 @@ module OpenAI
           )
           end
 
-          # Updates session metadata, model, reasoning effort, or service tier. Model
+          # Updates session tools, metadata, model, reasoning effort, or service tier. Model
           # settings apply to subsequent turns. Omitted fields are unchanged. See
           # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
           sig {
@@ -159,6 +165,7 @@ module OpenAI
               session_id: String,
               agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent::OrHash,
               metadata: T.nilable(T::Hash[Symbol, String]),
+              review: OpenAI::Beta::Agents::SessionUpdateParams::Review::OrSymbol,
               spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash),
               request_options: OpenAI::RequestOptions::OrHash
             )
@@ -167,12 +174,15 @@ module OpenAI
           def update(
             # The ID of the session.
             session_id,
-            # Model settings for subsequent turns. Omitted fields stay unchanged.
+            # Agent settings to update on this session. Omitted fields stay unchanged.
             agent: nil,
             # Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it.
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters.
             metadata: nil,
+            # Default action review for new root turns. Existing turns and their subagents
+            # keep their review mode.
+            review: nil,
             # Omit to retain the limit; null or a null limit removes it without resetting
             # spend.
             spend_control: nil,
@@ -188,6 +198,7 @@ module OpenAI
               after: String,
               agent_id: String,
               limit: Integer,
+              metadata: T::Hash[Symbol, String],
               order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
               request_options: OpenAI::RequestOptions::OrHash
             )
@@ -201,6 +212,11 @@ module OpenAI
             agent_id: nil,
             # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
+            # Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+            # match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+            # characters. New sessions and metadata updates may take time to appear in
+            # filtered results.
+            metadata: nil,
             # The order in which resources are returned. Defaults to `desc`.
             order: nil,
             request_options: {}

data/rbi/openai/resources/beta/agents.rbi

@@ -21,6 +21,8 @@ module OpenAI
         sig {
           params(
             model: String,
+            compaction: T.nilable(OpenAI::Beta::AgentCreateParams::Compaction::OrHash),
+            experimental: OpenAI::Beta::AgentCreateParams::Experimental::OrHash,
             instructions: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             multi_agent: T.nilable(OpenAI::Beta::MultiAgentConfigParam::OrHash),
@@ -48,6 +50,10 @@ module OpenAI
         def create(
           # The model to use for the agent. The requested model name is preserved.
           model:,
+          # Context compaction settings. Omission or null enables background compaction.
+          compaction: nil,
+          # Experimental agent settings. All experimental features default to disabled.
+          experimental: nil,
           # Additional instructions appended to the agent's default base instructions. Omit
           # or set to null to add no custom instructions.
           instructions: nil,
@@ -88,6 +94,8 @@ module OpenAI
         sig {
           params(
             agent_id: String,
+            compaction: T.nilable(OpenAI::Beta::AgentUpdateParams::Compaction::OrHash),
+            experimental: OpenAI::Beta::AgentUpdateParams::Experimental::OrHash,
             instructions: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, String]),
             model: String,
@@ -116,6 +124,13 @@ module OpenAI
         def update(
           # The ID of the reusable agent.
           agent_id,
+          # Context compaction settings. Omit to keep the current settings. A supplied
+          # object replaces the settings; null or an empty object enables background
+          # compaction.
+          compaction: nil,
+          # Experimental settings to merge by key. Omitted settings keep their current
+          # values.
+          experimental: nil,
           # Additional instructions appended to the agent's default base instructions. Omit
           # to leave unchanged.
           instructions: nil,

data/rbi/openai/resources/images.rbi

@@ -59,6 +59,7 @@ module OpenAI
           prompt: String,
           background: T.nilable(OpenAI::ImageEditParams::Background::OrSymbol),
           input_fidelity: T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol),
+          markup: OpenAI::Internal::FileInput,
           mask: OpenAI::Internal::FileInput,
           model: T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol)),
           n: T.nilable(Integer),
@@ -78,12 +79,12 @@ module OpenAI
       def edit(
         # The image(s) to edit. Must be a supported image file or an array of images.
         #
-        # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-        # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
-        # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-        # `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`), each image should
-        # be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
-        # images.
+        # For the GPT image models (`gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+        # `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+        # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`, and
+        # `gpt-image-2.5-flare-2026-09-08`), each image should be a `png`, `webp`, or
+        # `jpg` file less than 50MB. You can provide up to 16 images.
+        # `chatgpt-image-latest` follows the same input constraints as GPT image models.
         #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -104,9 +105,17 @@ module OpenAI
         background: nil,
         # Control how much effort the model will exert to match the style and features,
         # especially facial features, of input images. Supports `high` and `low` on
-        # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-        # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+        # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+        # this parameter. Defaults to `low` on supported models.
         input_fidelity: nil,
+        # A transparent PNG overlaid on the first image to guide the edit. Must match that
+        # image's dimensions after orientation and contain transparent pixels. Supports
+        # GPT Image 2.5 and 2.6. Cannot be combined with mask.
+        #
+        # `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.
+        markup: nil,
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
         # indicate where `image` should be edited. If there are multiple images provided,
         # the mask will be applied on the first image. Must be a valid PNG file, less than
@@ -191,6 +200,7 @@ module OpenAI
           prompt: String,
           background: T.nilable(OpenAI::ImageEditParams::Background::OrSymbol),
           input_fidelity: T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol),
+          markup: OpenAI::Internal::FileInput,
           mask: OpenAI::Internal::FileInput,
           model: T.nilable(T.any(String, OpenAI::ImageModel::OrSymbol)),
           n: T.nilable(Integer),
@@ -210,12 +220,12 @@ module OpenAI
       def edit_stream_raw(
         # The image(s) to edit. Must be a supported image file or an array of images.
         #
-        # For the GPT image models (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`,
-        # `gpt-image-2`, `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
-        # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`,
-        # `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`), each image should
-        # be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
-        # images.
+        # For the GPT image models (`gpt-image-1-mini`, `gpt-image-1.5`, `gpt-image-2`,
+        # `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
+        # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`, and
+        # `gpt-image-2.5-flare-2026-09-08`), each image should be a `png`, `webp`, or
+        # `jpg` file less than 50MB. You can provide up to 16 images.
+        # `chatgpt-image-latest` follows the same input constraints as GPT image models.
         #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
@@ -236,9 +246,17 @@ module OpenAI
         background: nil,
         # Control how much effort the model will exert to match the style and features,
         # especially facial features, of input images. Supports `high` and `low` on
-        # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
-        # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+        # `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For `gpt-image-2`, omit
+        # this parameter. Defaults to `low` on supported models.
         input_fidelity: nil,
+        # A transparent PNG overlaid on the first image to guide the edit. Must match that
+        # image's dimensions after orientation and contain transparent pixels. Supports
+        # GPT Image 2.5 and 2.6. Cannot be combined with mask.
+        #
+        # `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.
+        markup: nil,
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
         # indicate where `image` should be edited. If there are multiple images provided,
         # the mask will be applied on the first image. Must be a valid PNG file, less than

data/rbi/openai/resources/responses.rbi

@@ -864,6 +864,7 @@ module OpenAI
                 T::Array[OpenAI::Responses::ResponsesClientEvent::ResponseCreate::ContextManagement::OrHash]
               ),
               conversation: T.nilable(T.any(String, OpenAI::Responses::ResponseConversationParam::OrHash)),
+              generate: T::Boolean,
               include: T.nilable(T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]),
               input: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::Input::Variants,
               instructions: T.nilable(String),
@@ -933,6 +934,7 @@ module OpenAI
             background: nil,
             context_management: nil,
             conversation: nil,
+            generate: nil,
             include: nil,
             input: nil,
             instructions: nil,

data/realtime.md

@@ -596,6 +596,12 @@ settings. `transport_options` therefore cannot override those fields and are
 snapshotted before authentication so later caller mutation cannot alter the
 handshake.
 
+If your client has a custom `http_client:` or a configured
+`OpenAI::NetHTTPClient`, supply a compatible `transport:` with the required
+WebSocket connection settings. Otherwise, the SDK rejects the connection
+before reading credentials. This also applies to transcription, call sideband
+and Translation connections.
+
 ## Current scope
 
 The examples in this guide cover local function calling, image input, and MCP

data/responses-websocket.md

@@ -155,6 +155,54 @@ compatible event bytes retained for collection. Choose budgets for legitimate
 large output, including images and tool results. Queue overflow closes the
 session's connection; collection overflow leaves raw events and other lanes usable.
 
+### Bound a caller-fed preview
+
+`OpenAI::Responses::IncrementalResponse` builds provisional output from events
+you feed it. Use a separate instance for each lane. It does not read, close, or
+write to the connection. Tools remain data. Its `output` may be unavailable
+if the events do not contain enough information; its admitted terminal event
+stays exact, including an absent output field. Call `reset` to discard only
+the preview's state.
+
+Session limits govern the session's queues and final-response collector.
+They do not bound a separate `IncrementalResponse`. Choose a finite budget
+for the encoded events that you feed to each preview and a finite lifetime.
+Check the complete event before every `add`, including unknowns, errors, and
+terminal events. Stop feeding when an event would exceed the budget. Never
+report a completed preview for a terminal event that you did not admit.
+
+The runnable [preview example](examples/responses/websocket_workflows.rb)
+sets a decoded per-message cap, uses the session's separate limits, and applies
+a 4 MiB cumulative preview budget with a 15-second lifetime:
+
+```sh
+bundle exec ruby examples/responses/websocket_workflows.rb preview
+```
+
+`preview_lane` uses the model's `deep_to_h` for known events and the raw
+`to_h` for unknown events. It counts the UTF-8 bytes in the encoded JSON,
+including nested and unknown fields. These are encoded event bytes, not the
+original wire bytes or a bound on total heap memory. It also checks a
+monotonic deadline while draining queued events; the
+Async timeout interrupts an idle wait. Choose budgets large enough for legitimate
+image, audio, tool, or other large output in your application.
+
+The result has `outcome: :terminal`, `:budget_exceeded`, or `:timeout`.
+Only `:terminal` includes `terminal_event`, the exact admitted completion,
+failure, incomplete, or error event. Inspect that event's type and status.
+A stop after a read can include `last_received_event`. With `:budget_exceeded`,
+the event was not admitted to the preview. With `:timeout`, it may already
+have been admitted; a terminal event can cross the deadline during preview
+assembly. This field reports what was read and does not guarantee that the
+event is safe to process again. Only `outcome: :terminal` reports a completed
+preview.
+
+Raw events, lane finals and other lanes keep their normal SDK contracts.
+A preview timeout or budget stop resets the preview; it does not close the
+lane, cancel the response, or choose a continuation for you. The outer session
+still closes when its owning block exits. EOF, transport failures and other
+cancellation propagate as usual.
+
 Register lanes before sending and consume each response before creating another
 on that lane. One Async task reads the physical connection; each lane has one
 consumer, and all session operations use the owning Ruby thread. `lane.receive`
@@ -329,6 +377,11 @@ acknowledgment, and it does not guarantee that a response stopped executing.
   entry point. A nonempty `request_options.extra_query` or nonzero
   `request_options.max_retries` is rejected. Supported workload identity has a
   narrow pre-handshake 401 refresh; that is not live-session recovery.
+- If your client uses a configured HTTP transport, pass a compatible WebSocket
+  `transport:` with its own connection settings. The default WebSocket transport
+  cannot carry over HTTP connection policies. It rejects that configuration
+  before requesting credentials or opening a socket. Default HTTP clients and
+  their copies keep using the default WebSocket transport.
 - Large events are valid. Plan memory and application backpressure for your
   workload without treating a fixed payload size as a protocol maximum.
 

data/sig/openai/helpers/live/websocket.rbs

@@ -35,15 +35,7 @@ module OpenAI
         OpenAI::Models::Live::fork_client_event
         | ::Hash[Symbol | String, untyped]
       type sideband_connection_client_event =
-        OpenAI::Models::Live::SessionUpdateEvent
-        | OpenAI::Models::Live::InputAudioMuteEvent
-        | OpenAI::Models::Live::InputAudioUnmuteEvent
-        | OpenAI::Models::Live::InstructionsAppendEvent
-        | OpenAI::Models::Live::ThinkingAppendEvent
-        | OpenAI::Models::Live::CommentaryAppendEvent
-        | OpenAI::Models::Live::ResponseItemCreateEvent
-        | OpenAI::Models::Live::ResponseCreateEvent
-        | OpenAI::Models::Live::SessionCloseEvent
+        OpenAI::Models::Live::sideband_client_event
         | ::Hash[Symbol | String, untyped]
 
       class UnknownServerEvent

data/sig/openai/helpers/realtime/connection.rbs

@@ -42,6 +42,9 @@ module OpenAI
 
         # @api private
         def abort: -> nil
+
+        # @api private
+        def enable_no_status_recovery: -> nil
         def closed?: -> bool
         def reconnecting?: -> bool
         def pending_messages: -> Array[String]

data/sig/openai/helpers/realtime/transports/async_websocket.rbs

@@ -17,6 +17,9 @@ module OpenAI
             # @api private
             def abort: -> void
 
+            # @api private
+            def enable_no_status_recovery: -> nil
+
             # @api private
             def aborted?: -> bool
             def closed?: -> bool

data/sig/openai/helpers/responses_websocket/connection.rbs

@@ -32,8 +32,14 @@ module OpenAI
         ) -> nil
 
         # @api private
-        def encode_client_event: (
+        def send_response_create: (
           OpenAI::Models::Responses::connection_client_event event
+        ) -> nil
+
+        # @api private
+        def encode_client_event: (
+          OpenAI::Models::Responses::connection_client_event event,
+          ?response_create: bool
         ) -> ::Hash[Symbol, untyped]
 
         # @api private

data/sig/openai/helpers/structured_output.rbs

@@ -1,6 +1,15 @@
 module OpenAI
   module Helpers
     module StructuredOutput
+      module RequestWithFormatUpdate
+        attr_accessor text_model: top
+      end
+
+      # @api private
+      def self.prepare_configuration_updates!: [K, V] (
+        ::Hash[K, V] request
+      ) -> ::Hash[K, V]
+
       class BaseModel < OpenAI::Internal::Type::BaseModel
         def self.optional: -> bot
         def self.to_json_schema: -> Hash[Symbol, untyped]

data/sig/openai/internal/type/union.rbs

@@ -39,6 +39,10 @@ module OpenAI
           state: OpenAI::Internal::Type::Converter::coerce_state
         ) -> top
 
+        def variant_for_dump: (
+          top value
+        ) -> OpenAI::Internal::Type::Converter::input?
+
         def dump: (
           top value,
           state: OpenAI::Internal::Type::Converter::dump_state