openai 0.99.0 → 0.100.0

data/rbi/openai/models/beta/agents/environments/template_create_params.rbi

@@ -59,8 +59,8 @@ module OpenAI
             sig { returns(T.nilable(String)) }
             attr_accessor :name
 
-            # Network access policy for the environment. Defaults to disabled for GA requests
-            # and enabled for beta requests.
+            # Network access policy for the environment. If omitted, the API version
+            # determines whether network access is enabled or disabled.
             sig { returns(T.nilable(OpenAI::Beta::Agents::Environments::TemplateCreateParams::Network)) }
             attr_reader :network
 
@@ -160,8 +160,8 @@ module OpenAI
               # An optional human-readable display name for the template.
               name: nil,
 
-              # Network access policy for the environment. Defaults to disabled for GA requests
-              # and enabled for beta requests.
+              # Network access policy for the environment. If omitted, the API version
+              # determines whether network access is enabled or disabled.
               network: nil,
 
               # Packages to install in the environment. Defaults to empty package lists.
@@ -273,8 +273,8 @@ module OpenAI
               sig { returns(T.nilable(T::Array[String])) }
               attr_accessor :blocked_domains
 
-              # Network access policy for the environment. Defaults to disabled for GA requests
-              # and enabled for beta requests.
+              # Network access policy for the environment. If omitted, the API version
+              # determines whether network access is enabled or disabled.
               sig do
                 params(
 

data/rbi/openai/models/beta/agents/environments/template_update_params.rbi

@@ -61,8 +61,7 @@ module OpenAI
             attr_accessor :name
 
             # 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 beta
-            # requests.
+            # policy, or pass `null` to reset to the default policy.
             sig { returns(T.nilable(OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Network)) }
             attr_reader :network
 
@@ -164,8 +163,7 @@ module OpenAI
               name: 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 beta
-              # requests.
+              # policy, or pass `null` to reset to the default policy.
               network: nil,
 
               # Packages installed before the runtime network policy applies.
@@ -277,8 +275,7 @@ module OpenAI
               attr_accessor :blocked_domains
 
               # 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 beta
-              # requests.
+              # policy, or pass `null` to reset to the default policy.
               sig do
                 params(
 

data/rbi/openai/models/beta/agents/sessions/turns/item_list_params.rbi

@@ -0,0 +1,139 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        module Sessions
+
+          module Turns
+
+            class ItemListParams < OpenAI::Internal::Type::BaseModel
+
+              extend OpenAI::Internal::Type::RequestParameters::Converter
+              include OpenAI::Internal::Type::RequestParameters
+
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::Sessions::Turns::ItemListParams,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              sig { returns(String) }
+              attr_accessor :session_id
+
+              sig { returns(String) }
+              attr_accessor :turn_id
+
+              # Return items after this cursor in the selected order. Pass the previous
+              # response's last_id, which can differ from the last item's ID.
+              sig { returns(T.nilable(String)) }
+              attr_reader :after
+
+              sig { params(after: String).void }
+              attr_writer :after
+
+              # The maximum number of resources to return, between 1 and 100. Defaults to 20.
+              sig { returns(T.nilable(Integer)) }
+              attr_reader :limit
+
+              sig { params(limit: Integer).void }
+              attr_writer :limit
+
+              # The order in which resources are returned. Defaults to `desc`.
+              sig { returns(T.nilable(OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order::OrSymbol)) }
+              attr_reader :order
+
+              sig { params(order: OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order::OrSymbol).void }
+              attr_writer :order
+
+              sig do
+                params(
+
+                  session_id: String,
+
+                  turn_id: String,
+
+                  after: String,
+
+                  limit: Integer,
+
+                  order: OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order::OrSymbol,
+
+                  request_options: OpenAI::RequestOptions::OrHash
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                session_id:,
+
+                turn_id:,
+
+                # Return items after this cursor in the selected order. Pass the previous
+                # response's last_id, which can differ from the last item's ID.
+                after: nil,
+
+                # The maximum number of resources to return, between 1 and 100. Defaults to 20.
+                limit: nil,
+
+                # The order in which resources are returned. Defaults to `desc`.
+                order: nil,
+
+                request_options: {}
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    session_id: String,
+                    turn_id: String,
+                    after: String,
+                    limit: Integer,
+                    order: OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order::OrSymbol,
+                    request_options: OpenAI::RequestOptions
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              # The order in which resources are returned. Defaults to `desc`.
+              module Order
+                extend OpenAI::Internal::Type::Enum
+
+                TaggedSymbol = T.type_alias {
+                  T.all(Symbol, OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order)
+                }
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                # Returns resources in ascending order.
+                ASC = T.let(:asc, OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order::TaggedSymbol)
+
+                # Returns resources in descending order.
+                DESC = T.let(:desc, OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order::TaggedSymbol)
+
+                sig {
+                  override.returns(T::Array[OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order::TaggedSymbol])
+                }
+                def self.values
+                end
+              end
+
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/beta_response_computer_tool_call_output_item.rbi

@@ -16,7 +16,7 @@ module OpenAI
           )
         end
 
-        # The unique ID of the computer call tool output.
+        # The ID of the computer tool call output.
         sig { returns(String) }
         attr_accessor :id
 
@@ -96,7 +96,7 @@ module OpenAI
         end
         def self.new(
 
-          # The unique ID of the computer call tool output.
+          # The ID of the computer tool call output.
           id:,
 
           # The ID of the computer tool call that produced the output.

data/rbi/openai/models/beta/beta_response_error.rbi

@@ -136,6 +136,11 @@ module OpenAI
           }
           attr_writer :error_type
 
+          # An opaque target for explicitly continuing this review, or null when
+          # unavailable.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :review_target
+
           # An optional public continuation instruction.
           sig { returns(T.nilable(OpenAI::Beta::BetaResponseError::Misalignment::Steer)) }
           attr_reader :steer
@@ -150,6 +155,8 @@ module OpenAI
 
               error_type: T.any(String, OpenAI::Beta::BetaResponseError::Misalignment::ErrorType::OrSymbol),
 
+              review_target: T.nilable(String),
+
               steer: OpenAI::Beta::BetaResponseError::Misalignment::Steer::OrHash
             )
               .returns(T.attached_class)
@@ -162,6 +169,10 @@ module OpenAI
             # An optional classification; clients must accept additional values.
             error_type: nil,
 
+            # An opaque target for explicitly continuing this review, or null when
+            # unavailable.
+            review_target: nil,
+
             # An optional public continuation instruction.
 
             steer: nil
@@ -173,6 +184,7 @@ module OpenAI
               {
                 detailed_explanation: String,
                 error_type: OpenAI::Beta::BetaResponseError::Misalignment::ErrorType::Variants,
+                review_target: T.nilable(String),
                 steer: OpenAI::Beta::BetaResponseError::Misalignment::Steer
               }
             )

data/rbi/openai/models/beta/beta_responses_server_event.rbi

@@ -5009,6 +5009,11 @@ module OpenAI
               }
               attr_writer :error_type
 
+              # An opaque target for explicitly continuing this review, or null when
+              # unavailable.
+              sig { returns(T.nilable(String)) }
+              attr_accessor :review_target
+
               # An optional public continuation instruction.
               sig {
                 returns(
@@ -5035,6 +5040,8 @@ module OpenAI
                     OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::ErrorType::OrSymbol
                   ),
 
+                  review_target: T.nilable(String),
+
                   steer: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::Steer::OrHash
                 )
                   .returns(T.attached_class)
@@ -5047,6 +5054,10 @@ module OpenAI
                 # An optional classification; clients must accept additional values.
                 error_type: nil,
 
+                # An opaque target for explicitly continuing this review, or null when
+                # unavailable.
+                review_target: nil,
+
                 # An optional public continuation instruction.
 
                 steer: nil
@@ -5060,6 +5071,7 @@ module OpenAI
                     error_type: T.nilable(
                       OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::ErrorType::Variants
                     ),
+                    review_target: T.nilable(String),
                     steer: T.nilable(
                       OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::Steer
                     )

data/rbi/openai/models/beta/beta_tool.rbi

@@ -976,9 +976,10 @@ module OpenAI
           sig { params(background: OpenAI::Beta::BetaTool::ImageGeneration::Background::OrSymbol).void }
           attr_writer :background
 
-          # Controls fidelity to the original input image(s). This parameter is supported
-          # for GPT image models that support input fidelity. `gpt-image-2` and
-          # `gpt-image-2-2026-04-21` ignore this parameter.
+          # 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.
           sig { returns(T.nilable(OpenAI::Beta::BetaTool::ImageGeneration::InputFidelity::OrSymbol)) }
           attr_accessor :input_fidelity
 
@@ -1103,9 +1104,10 @@ module OpenAI
             # set the output format to `png` or `webp`.
             background: nil,
 
-            # Controls fidelity to the original input image(s). This parameter is supported
-            # for GPT image models that support input fidelity. `gpt-image-2` and
-            # `gpt-image-2-2026-04-21` ignore this parameter.
+            # 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.
             input_fidelity: nil,
 
             # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -1218,9 +1220,10 @@ module OpenAI
             end
           end
 
-          # Controls fidelity to the original input image(s). This parameter is supported
-          # for GPT image models that support input fidelity. `gpt-image-2` and
-          # `gpt-image-2-2026-04-21` ignore this parameter.
+          # 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.
           module InputFidelity
             extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/environment_param.rbi

@@ -114,8 +114,8 @@ module OpenAI
           }
           attr_accessor :files
 
-          # Network access policy for the environment. Defaults to disabled for GA requests
-          # and enabled for beta requests.
+          # Network access policy for the environment. If omitted, the API version
+          # determines whether network access is enabled or disabled.
           sig { returns(T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network)) }
           attr_reader :network
 
@@ -216,8 +216,8 @@ module OpenAI
             # Files available before the agent starts. Defaults to an empty list.
             files: nil,
 
-            # Network access policy for the environment. Defaults to disabled for GA requests
-            # and enabled for beta requests.
+            # Network access policy for the environment. If omitted, the API version
+            # determines whether network access is enabled or disabled.
             network: nil,
 
             # Packages to install in the environment. Defaults to empty package lists.
@@ -350,8 +350,8 @@ module OpenAI
             sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :blocked_domains
 
-            # Network access policy for the environment. Defaults to disabled for GA requests
-            # and enabled for beta requests.
+            # Network access policy for the environment. If omitted, the API version
+            # determines whether network access is enabled or disabled.
             sig do
               params(
 

data/rbi/openai/models/beta/session_turn_error.rbi

@@ -67,6 +67,24 @@ module OpenAI
           # The organization has reached a usage, plan, or billing limit.
           USAGE_LIMIT_EXCEEDED = T.let(:usage_limit_exceeded, OpenAI::Beta::SessionTurnError::Code::TaggedSymbol)
 
+          # The project has reached its enforced spend limit.
+          PROJECT_SPEND_LIMIT_EXCEEDED = T.let(
+            :project_spend_limit_exceeded,
+            OpenAI::Beta::SessionTurnError::Code::TaggedSymbol
+          )
+
+          # The organization has reached its enforced spend limit.
+          ORGANIZATION_SPEND_LIMIT_EXCEEDED = T.let(
+            :organization_spend_limit_exceeded,
+            OpenAI::Beta::SessionTurnError::Code::TaggedSymbol
+          )
+
+          # The organization has reached its OpenAI-assigned usage limit.
+          ORGANIZATION_USAGE_LIMIT_EXCEEDED = T.let(
+            :organization_usage_limit_exceeded,
+            OpenAI::Beta::SessionTurnError::Code::TaggedSymbol
+          )
+
           # The organization has no API credits remaining.
           CREDIT_BALANCE_EXHAUSTED = T.let(
             :credit_balance_exhausted,

data/rbi/openai/models/chat/chat_completion_chunk.rbi

@@ -228,26 +228,29 @@ module OpenAI
             )
           end
 
-          # A chat completion delta generated by streamed model responses.
+          # A chat completion delta generated by streamed model responses. Streamed audio
+          # can arrive in partial updates with an ID, base64 data, or transcript text. The
+          # final audio update contains only its expiry timestamp.
           sig { returns(OpenAI::Chat::ChatCompletionChunk::Choice::Delta) }
           attr_reader :delta
 
           sig { params(delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::OrHash).void }
           attr_writer :delta
 
+          # The index of the choice in the list of choices.
+          sig { returns(Integer) }
+          attr_accessor :index
+
           # The reason the model stopped generating tokens. This will be `stop` if the model
           # hit a natural stop point or a provided stop sequence, `length` if the maximum
           # number of tokens specified in the request was reached, `content_filter` if
           # content was omitted due to a flag from our content filters, `tool_calls` if the
           # model called a tool, or `function_call` (deprecated) if the model called a
-          # function.
+          # function. Omitted from the final audio update containing only
+          # `delta.audio.expires_at`.
           sig { returns(T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::TaggedSymbol)) }
           attr_accessor :finish_reason
 
-          # The index of the choice in the list of choices.
-          sig { returns(Integer) }
-          attr_accessor :index
-
           # Log probability information for the choice.
           sig { returns(T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs)) }
           attr_reader :logprobs
@@ -260,29 +263,32 @@ module OpenAI
 
               delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::OrHash,
 
-              finish_reason: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::OrSymbol),
-
               index: Integer,
 
+              finish_reason: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::OrSymbol),
+
               logprobs: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs::OrHash)
             )
               .returns(T.attached_class)
           end
           def self.new(
 
-            # A chat completion delta generated by streamed model responses.
+            # A chat completion delta generated by streamed model responses. Streamed audio
+            # can arrive in partial updates with an ID, base64 data, or transcript text. The
+            # final audio update contains only its expiry timestamp.
             delta:,
 
+            # The index of the choice in the list of choices.
+            index:,
+
             # The reason the model stopped generating tokens. This will be `stop` if the model
             # hit a natural stop point or a provided stop sequence, `length` if the maximum
             # number of tokens specified in the request was reached, `content_filter` if
             # content was omitted due to a flag from our content filters, `tool_calls` if the
             # model called a tool, or `function_call` (deprecated) if the model called a
-            # function.
-            finish_reason:,
-
-            # The index of the choice in the list of choices.
-            index:,
+            # function. Omitted from the final audio update containing only
+            # `delta.audio.expires_at`.
+            finish_reason: nil,
 
             # Log probability information for the choice.
 
@@ -294,8 +300,8 @@ module OpenAI
             override.returns(
               {
                 delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta,
-                finish_reason: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::TaggedSymbol),
                 index: Integer,
+                finish_reason: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::FinishReason::TaggedSymbol),
                 logprobs: T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs)
               }
             )
@@ -311,6 +317,14 @@ module OpenAI
               )
             end
 
+            # A partial audio response. Audio chunks may carry an ID, base64 data, or
+            # transcript text; the final audio update contains only its expiry timestamp.
+            sig { returns(T.nilable(OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio)) }
+            attr_reader :audio
+
+            sig { params(audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio::OrHash).void }
+            attr_writer :audio
+
             # The contents of the chunk message.
             sig { returns(T.nilable(String)) }
             attr_accessor :content
@@ -342,10 +356,14 @@ module OpenAI
             }
             attr_writer :tool_calls
 
-            # A chat completion delta generated by streamed model responses.
+            # A chat completion delta generated by streamed model responses. Streamed audio
+            # can arrive in partial updates with an ID, base64 data, or transcript text. The
+            # final audio update contains only its expiry timestamp.
             sig do
               params(
 
+                audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio::OrHash,
+
                 content: T.nilable(String),
 
                 function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall::OrHash,
@@ -360,6 +378,10 @@ module OpenAI
             end
             def self.new(
 
+              # A partial audio response. Audio chunks may carry an ID, base64 data, or
+              # transcript text; the final audio update contains only its expiry timestamp.
+              audio: nil,
+
               # The contents of the chunk message.
               content: nil,
 
@@ -380,6 +402,7 @@ module OpenAI
             sig do
               override.returns(
                 {
+                  audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
                   content: T.nilable(String),
                   function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall,
                   refusal: T.nilable(String),
@@ -391,6 +414,88 @@ module OpenAI
             def to_hash
             end
 
+            class Audio < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # Unique identifier for this audio response.
+              sig { returns(T.nilable(String)) }
+              attr_reader :id
+
+              sig { params(id: String).void }
+              attr_writer :id
+
+              # Base64 encoded audio bytes generated by the model, in the format specified in
+              # the request.
+              sig { returns(T.nilable(String)) }
+              attr_reader :data
+
+              sig { params(data: String).void }
+              attr_writer :data
+
+              # The Unix timestamp (in seconds) for when this audio response will no longer be
+              # accessible on the server for use in multi-turn conversations.
+              sig { returns(T.nilable(Integer)) }
+              attr_reader :expires_at
+
+              sig { params(expires_at: Integer).void }
+              attr_writer :expires_at
+
+              # Transcript text from this audio chunk.
+              sig { returns(T.nilable(String)) }
+              attr_reader :transcript
+
+              sig { params(transcript: String).void }
+              attr_writer :transcript
+
+              # A partial audio response. Audio chunks may carry an ID, base64 data, or
+              # transcript text; the final audio update contains only its expiry timestamp.
+              sig do
+                params(
+
+                  id: String,
+
+                  data: String,
+
+                  expires_at: Integer,
+
+                  transcript: String
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # Unique identifier for this audio response.
+                id: nil,
+
+                # Base64 encoded audio bytes generated by the model, in the format specified in
+                # the request.
+                data: nil,
+
+                # The Unix timestamp (in seconds) for when this audio response will no longer be
+                # accessible on the server for use in multi-turn conversations.
+                expires_at: nil,
+
+                # Transcript text from this audio chunk.
+
+                transcript: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {id: String, data: String, expires_at: Integer, transcript: String}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
             class FunctionCall < OpenAI::Internal::Type::BaseModel
               OrHash = T.type_alias do
                 T.any(
@@ -633,7 +738,8 @@ module OpenAI
           # number of tokens specified in the request was reached, `content_filter` if
           # content was omitted due to a flag from our content filters, `tool_calls` if the
           # model called a tool, or `function_call` (deprecated) if the model called a
-          # function.
+          # function. Omitted from the final audio update containing only
+          # `delta.audio.expires_at`.
           module FinishReason
             extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/error_object.rbi

@@ -95,6 +95,11 @@ module OpenAI
         sig { params(error_type: T.any(String, OpenAI::ErrorObject::Misalignment::ErrorType::OrSymbol)).void }
         attr_writer :error_type
 
+        # An opaque target for explicitly continuing this review, or null when
+        # unavailable.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :review_target
+
         # An optional public continuation instruction.
         sig { returns(T.nilable(OpenAI::ErrorObject::Misalignment::Steer)) }
         attr_reader :steer
@@ -109,6 +114,8 @@ module OpenAI
 
             error_type: T.any(String, OpenAI::ErrorObject::Misalignment::ErrorType::OrSymbol),
 
+            review_target: T.nilable(String),
+
             steer: OpenAI::ErrorObject::Misalignment::Steer::OrHash
           )
             .returns(T.attached_class)
@@ -121,6 +128,10 @@ module OpenAI
           # An optional classification; clients must accept additional values.
           error_type: nil,
 
+          # An opaque target for explicitly continuing this review, or null when
+          # unavailable.
+          review_target: nil,
+
           # An optional public continuation instruction.
 
           steer: nil
@@ -132,6 +143,7 @@ module OpenAI
             {
               detailed_explanation: String,
               error_type: T.any(String, OpenAI::ErrorObject::Misalignment::ErrorType::OrSymbol),
+              review_target: T.nilable(String),
               steer: OpenAI::ErrorObject::Misalignment::Steer
             }
           )