openai 0.95.0 → 0.96.0

data/lib/openai/models/chat_model.rb

@@ -6,6 +6,7 @@ module OpenAI
       extend OpenAI::Internal::Type::Enum
 
       GPT_6_ASTRA = :"gpt-6-astra"
+      GPT_6_1_SOL = :"gpt-6.1-sol"
       GPT_6_SOL = :"gpt-6-sol"
       GPT_6_LUNA = :"gpt-6-luna"
       GPT_5_6_SOL = :"gpt-5.6-sol"

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

@@ -13,6 +13,11 @@ module OpenAI
         #   @return [String]
         required :id, String
 
+        # @!attribute access_programs
+        #
+        #   @return [OpenAI::Models::Responses::Response::AccessPrograms, nil]
+        required :access_programs, -> { OpenAI::Responses::Response::AccessPrograms }, nil?: true
+
         # @!attribute created_at
         #   Unix timestamp (in seconds) of when this Response was created.
         #
@@ -374,10 +379,12 @@ 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, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_diagnostics: nil, prompt_cache_key: nil, prompt_cache_options: 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:, access_programs:, 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, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_diagnostics: nil, prompt_cache_key: nil, prompt_cache_options: 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)
         #   @param id [String]
         #     Unique identifier for this Response.
         #
+        #   @param access_programs [OpenAI::Models::Responses::Response::AccessPrograms, nil]
+        #
         #   @param created_at [Float]
         #     Unix timestamp (in seconds) of when this Response was created.
         #
@@ -608,6 +615,33 @@ module OpenAI
         #   @param object [Symbol, :response]
         #     The object type of this resource - always set to `response`.
 
+        # @see OpenAI::Models::Responses::Response#access_programs
+        class AccessPrograms < OpenAI::Internal::Type::BaseModel
+          # @!attribute cyber
+          #   The effective Cyber access program used for this response.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::Response::AccessPrograms::Cyber]
+          required :cyber, enum: -> { OpenAI::Responses::Response::AccessPrograms::Cyber }
+
+          # @!method initialize(cyber:)
+          #   @param cyber [Symbol, OpenAI::Models::Responses::Response::AccessPrograms::Cyber]
+          #     The effective Cyber access program used for this response.
+
+          # The effective Cyber access program used for this response.
+          #
+          # @see OpenAI::Models::Responses::Response::AccessPrograms#cyber
+          module Cyber
+            extend OpenAI::Internal::Type::Enum
+
+            STANDARD = :standard
+            DAYBREAK_BLUE = :daybreak_blue
+            DAYBREAK_RED = :daybreak_red
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         # @see OpenAI::Models::Responses::Response#incomplete_details
         class IncompleteDetails < OpenAI::Internal::Type::BaseModel
           # @!attribute reason

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

@@ -169,6 +169,8 @@ module OpenAI
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_6_ASTRA }
 
+          variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_6_1_SOL }
+
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_6_SOL }
 
           variant const: -> { OpenAI::Models::Responses::ResponseCompactParams::Model::GPT_6_LUNA }
@@ -413,6 +415,7 @@ module OpenAI
           # @!group
 
           GPT_6_ASTRA = :"gpt-6-astra"
+          GPT_6_1_SOL = :"gpt-6.1-sol"
           GPT_6_SOL = :"gpt-6-sol"
           GPT_6_LUNA = :"gpt-6-luna"
           GPT_5_6_SOL = :"gpt-5.6-sol"

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

@@ -10,6 +10,12 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute access_programs
+        #   Domain-specific access programs to use for this request.
+        #
+        #   @return [OpenAI::Models::Responses::ResponseCreateParams::AccessPrograms, nil]
+        optional :access_programs, -> { OpenAI::Responses::ResponseCreateParams::AccessPrograms }
+
         # @!attribute background
         #   Whether to run the model response in the background.
         #   [Learn more](https://developers.openai.com/api/docs/guides/background).
@@ -379,7 +385,10 @@ module OpenAI
         #   @return [String, nil]
         optional :user, String
 
-        # @!method initialize(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: {})
+        # @!method initialize(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.
         #     [Learn more](https://developers.openai.com/api/docs/guides/background).
@@ -627,6 +636,61 @@ module OpenAI
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
+        class AccessPrograms < OpenAI::Internal::Type::BaseModel
+          # @!attribute cyber
+          #   The Cyber access program to use for this request. Supported values are
+          #   `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+          #   the program from the model's Cyber tier and your organization and project
+          #   access, subject to model-specific eligibility restrictions. By default, models
+          #   without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+          #   authorized; otherwise they fall back to Standard unless the model requires
+          #   Daybreak access. Red-tier models use Daybreak Red and require authorization.
+          #   Requests that require unavailable Daybreak access return 403. An implicit
+          #   Standard fallback is represented by null in the response's access_programs
+          #   field, rather than an explicit Standard selection.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseCreateParams::AccessPrograms::Cyber, nil]
+          optional :cyber, enum: -> { OpenAI::Responses::ResponseCreateParams::AccessPrograms::Cyber }
+
+          # @!method initialize(cyber: nil)
+          #   Domain-specific access programs to use for this request.
+          #
+          #   @param cyber [Symbol, OpenAI::Models::Responses::ResponseCreateParams::AccessPrograms::Cyber]
+          #     The Cyber access program to use for this request. Supported values are
+          #     `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+          #     the program from the model's Cyber tier and your organization and project
+          #     access, subject to model-specific eligibility restrictions. By default, models
+          #     without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+          #     authorized; otherwise they fall back to Standard unless the model requires
+          #     Daybreak access. Red-tier models use Daybreak Red and require authorization.
+          #     Requests that require unavailable Daybreak access return 403. An implicit
+          #     Standard fallback is represented by null in the response's access_programs
+          #     field, rather than an explicit Standard selection.
+
+          # The Cyber access program to use for this request. Supported values are
+          # `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+          # the program from the model's Cyber tier and your organization and project
+          # access, subject to model-specific eligibility restrictions. By default, models
+          # without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+          # authorized; otherwise they fall back to Standard unless the model requires
+          # Daybreak access. Red-tier models use Daybreak Red and require authorization.
+          # Requests that require unavailable Daybreak access return 403. An implicit
+          # Standard fallback is represented by null in the response's access_programs
+          # field, rather than an explicit Standard selection.
+          #
+          # @see OpenAI::Models::Responses::ResponseCreateParams::AccessPrograms#cyber
+          module Cyber
+            extend OpenAI::Internal::Type::Enum
+
+            STANDARD = :standard
+            DAYBREAK_BLUE = :daybreak_blue
+            DAYBREAK_RED = :daybreak_red
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         class ContextManagement < OpenAI::Internal::Type::BaseModel
           # @!attribute type
           #   The context management entry type. Currently only 'compaction' is supported.

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

@@ -56,6 +56,12 @@ module OpenAI
           #   @return [Symbol, :"response.create"]
           required :type, const: :"response.create"
 
+          # @!attribute access_programs
+          #   Domain-specific access programs to use for this request.
+          #
+          #   @return [OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms, nil]
+          optional :access_programs, -> { OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms }
+
           # @!attribute background
           #   Whether to run the model response in the background.
           #   [Learn more](https://developers.openai.com/api/docs/guides/background).
@@ -457,7 +463,7 @@ module OpenAI
           #   @return [String, nil]
           optional :user, String
 
-          # @!method initialize(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: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
+          # @!method initialize(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: nil, stream_id: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, type: :"response.create")
           #   Client event for creating a response over a persistent WebSocket connection.
           #   This payload uses the same top-level fields as `POST /v1/responses`, plus
           #   WebSocket-only envelope metadata.
@@ -468,6 +474,9 @@ module OpenAI
           #   - `background` is not supported over WebSocket.
           #   - `stream_id` is WebSocket-only and is not part of `POST /v1/responses`.
           #
+          #   @param access_programs [OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms]
+          #     Domain-specific access programs to use for this request.
+          #
           #   @param background [Boolean, nil]
           #     Whether to run the model response in the background.
           #     [Learn more](https://developers.openai.com/api/docs/guides/background).
@@ -730,6 +739,66 @@ module OpenAI
           #
           #   @param type [Symbol, :"response.create"]
           #     The type of the client event. Always `response.create`.
+
+          # @see OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate#access_programs
+          class AccessPrograms < OpenAI::Internal::Type::BaseModel
+            # @!attribute cyber
+            #   The Cyber access program to use for this request. Supported values are
+            #   `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+            #   the program from the model's Cyber tier and your organization and project
+            #   access, subject to model-specific eligibility restrictions. By default, models
+            #   without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+            #   authorized; otherwise they fall back to Standard unless the model requires
+            #   Daybreak access. Red-tier models use Daybreak Red and require authorization.
+            #   Requests that require unavailable Daybreak access return 403. An implicit
+            #   Standard fallback is represented by null in the response's access_programs
+            #   field, rather than an explicit Standard selection.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber, nil]
+            optional(
+              :cyber,
+              enum: -> { OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber }
+            )
+
+            # @!method initialize(cyber: nil)
+            #   Domain-specific access programs to use for this request.
+            #
+            #   @param cyber [Symbol, OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber]
+            #     The Cyber access program to use for this request. Supported values are
+            #     `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+            #     the program from the model's Cyber tier and your organization and project
+            #     access, subject to model-specific eligibility restrictions. By default, models
+            #     without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+            #     authorized; otherwise they fall back to Standard unless the model requires
+            #     Daybreak access. Red-tier models use Daybreak Red and require authorization.
+            #     Requests that require unavailable Daybreak access return 403. An implicit
+            #     Standard fallback is represented by null in the response's access_programs
+            #     field, rather than an explicit Standard selection.
+
+            # The Cyber access program to use for this request. Supported values are
+            # `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+            # the program from the model's Cyber tier and your organization and project
+            # access, subject to model-specific eligibility restrictions. By default, models
+            # without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+            # authorized; otherwise they fall back to Standard unless the model requires
+            # Daybreak access. Red-tier models use Daybreak Red and require authorization.
+            # Requests that require unavailable Daybreak access return 403. An implicit
+            # Standard fallback is represented by null in the response's access_programs
+            # field, rather than an explicit Standard selection.
+            #
+            # @see OpenAI::Models::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms#cyber
+            module Cyber
+              extend OpenAI::Internal::Type::Enum
+
+              STANDARD = :standard
+              DAYBREAK_BLUE = :daybreak_blue
+              DAYBREAK_RED = :daybreak_red
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
           class ContextManagement < OpenAI::Internal::Type::BaseModel
             # @!attribute type
             #   The context management entry type. Currently only 'compaction' is supported.

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

@@ -27,7 +27,9 @@ module OpenAI
         optional :search_context_size, enum: -> { OpenAI::Responses::WebSearchPreviewTool::SearchContextSize }
 
         # @!attribute user_location
-        #   The user's location.
+        #   The approximate location of the user. If omitted or null, defaults to the United
+        #   States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        #   fields. To localize results, provide the relevant location fields.
         #
         #   @return [OpenAI::Models::Responses::WebSearchPreviewTool::UserLocation, nil]
         optional :user_location, -> { OpenAI::Responses::WebSearchPreviewTool::UserLocation }, nil?: true
@@ -48,7 +50,9 @@ module OpenAI
         #     search. One of `low`, `medium`, or `high`. `medium` is the default.
         #
         #   @param user_location [OpenAI::Models::Responses::WebSearchPreviewTool::UserLocation, nil]
-        #     The user's location.
+        #     The approximate location of the user. If omitted or null, defaults to the United
+        #     States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        #     fields. To localize results, provide the relevant location fields.
 
         # The type of the web search tool. One of `web_search_preview` or
         # `web_search_preview_2025_03_11`.
@@ -124,7 +128,9 @@ module OpenAI
           optional :timezone, String, nil?: true
 
           # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: :approximate)
-          #   The user's location.
+          #   The approximate location of the user. If omitted or null, defaults to the United
+          #   States. To avoid this fallback, pass `{"type": "approximate"}` without location
+          #   fields. To localize results, provide the relevant location fields.
           #
           #   @param city [String, nil]
           #     Free text input for the city of the user, e.g. `San Francisco`.

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

@@ -32,7 +32,9 @@ module OpenAI
         optional :search_context_size, enum: -> { OpenAI::Responses::WebSearchTool::SearchContextSize }
 
         # @!attribute user_location
-        #   The approximate location of the user.
+        #   The approximate location of the user. If omitted or null, defaults to the United
+        #   States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        #   fields. To localize results, provide the relevant location fields.
         #
         #   @return [OpenAI::Models::Responses::WebSearchTool::UserLocation, nil]
         optional :user_location, -> { OpenAI::Responses::WebSearchTool::UserLocation }, nil?: true
@@ -57,7 +59,9 @@ module OpenAI
         #     search. One of `low`, `medium`, or `high`. `medium` is the default.
         #
         #   @param user_location [OpenAI::Models::Responses::WebSearchTool::UserLocation, nil]
-        #     The approximate location of the user.
+        #     The approximate location of the user. If omitted or null, defaults to the United
+        #     States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        #     fields. To localize results, provide the relevant location fields.
 
         # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
         #
@@ -143,7 +147,9 @@ module OpenAI
           optional :type, enum: -> { OpenAI::Responses::WebSearchTool::UserLocation::Type }
 
           # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: nil)
-          #   The approximate location of the user.
+          #   The approximate location of the user. If omitted or null, defaults to the United
+          #   States. To avoid this fallback, pass `{"type": "approximate"}` without location
+          #   fields. To localize results, provide the relevant location fields.
           #
           #   @param city [String, nil]
           #     Free text input for the city of the user, e.g. `San Francisco`.

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/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.95.0"
+  VERSION = "0.96.0"
 end

data/lib/openai.rb

@@ -1594,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