openai 0.99.0 → 0.101.0

data/sig/openai/models/beta/beta_responses_server_event.rbs

@@ -3376,6 +3376,7 @@ module OpenAI
               {
                 ?detailed_explanation: String,
                 ?error_type: OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::error_type,
+                ?review_target: String?,
                 ?steer: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::Steer
               }
 
@@ -3394,6 +3395,10 @@ module OpenAI
                 OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::error_type
               ) -> OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::error_type
 
+              # An opaque target for explicitly continuing this review, or null when
+              # unavailable.
+              attr_accessor review_target: String?
+
               # An optional public continuation instruction.
               attr_reader steer: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::Steer?
 
@@ -3406,17 +3411,22 @@ module OpenAI
               #   The public explanation for this block.
               # @param error_type
               #   An optional classification; clients must accept additional values.
+              # @param review_target
+              #   An opaque target for explicitly continuing this review, or null when
+              #   unavailable.
               # @param steer
               #   An optional public continuation instruction.
               def initialize: (
                 ?detailed_explanation: String,
                 ?error_type: OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::error_type,
+                ?review_target: String?,
                 ?steer: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::Steer
               ) -> void
 
               def to_hash: -> {
                 ?detailed_explanation: String,
                 ?error_type: OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::error_type,
+                ?review_target: String?,
                 ?steer: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::Steer
               }
 

data/sig/openai/models/beta/beta_tool.rbs

@@ -643,9 +643,10 @@ module OpenAI
             OpenAI::Models::Beta::BetaTool::ImageGeneration::background
           ) -> OpenAI::Models::Beta::BetaTool::ImageGeneration::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.
           attr_accessor input_fidelity: OpenAI::Models::Beta::BetaTool::ImageGeneration::input_fidelity?
 
           # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -759,9 +760,10 @@ module OpenAI
           #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
           #   set the output format to `png` or `webp`.
           # @param input_fidelity
-          #   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.
           # @param input_image_mask
           #   Optional mask for inpainting. Contains `image_url` (string, optional) and
           #   `file_id` (string, optional).

data/sig/openai/models/beta/beta_tool_search_output_namespace_tool.rbs

@@ -0,0 +1,162 @@
+module OpenAI
+  module Models
+    class BetaToolSearchOutputNamespaceTool = Beta::BetaToolSearchOutputNamespaceTool
+
+    module Beta
+      type beta_tool_search_output_namespace_tool =
+        {
+          description: String,
+          name: String,
+          tools: ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::tool],
+          ?type: :namespace
+        }
+
+      class BetaToolSearchOutputNamespaceTool < OpenAI::Internal::Type::BaseModel
+        # A description of the namespace shown to the model.
+        attr_accessor description: String
+
+        # The namespace name used in tool calls (for example, `crm`).
+        attr_accessor name: String
+
+        # The function/custom tools loaded inside this namespace.
+        attr_accessor tools: ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::tool]
+
+        # The type of the tool. Always `namespace`.
+        attr_accessor type: :namespace
+
+        # @param description
+        #   A description of the namespace shown to the model.
+        # @param name
+        #   The namespace name used in tool calls (for example, `crm`).
+        # @param tools
+        #   The function/custom tools loaded inside this namespace.
+        # @param type
+        #   The type of the tool. Always `namespace`.
+        def initialize: (
+          description: String,
+          name: String,
+          tools: ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::tool],
+          ?type: :namespace
+        ) -> void
+
+        def to_hash: -> {
+          description: String,
+          name: String,
+          tools: ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::tool],
+          ?type: :namespace
+        }
+
+        type tool =
+          OpenAI::Beta::BetaToolSearchOutputNamespaceTool::Tool::Function
+          | OpenAI::Beta::BetaCustomTool
+
+        module Tool
+          extend OpenAI::Internal::Type::Union
+
+          type function =
+            {
+              name: String,
+              ?type: :function,
+              ?allowed_callers: ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::Tool::Function::allowed_caller]?,
+              ?async: bool,
+              ?defer_loading: bool,
+              ?description: String?,
+              ?output_schema: ::Hash[Symbol, top]?,
+              ?parameters: top?,
+              ?strict: bool?
+            }
+
+          class Function < OpenAI::Internal::Type::BaseModel
+            # The name of the loaded function tool.
+            attr_accessor name: String
+
+            attr_accessor type: :function
+
+            # The tool invocation context(s).
+            attr_accessor allowed_callers: ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::Tool::Function::allowed_caller]?
+
+            # Whether the tool response can be returned asynchronously versus immediately
+            # returned on next response creation.
+            attr_reader async: bool?
+
+            # Whether the tool response can be returned asynchronously versus immediately
+            # returned on next response creation.
+            def async=: (bool) -> bool
+
+            # Whether this function should be deferred and discovered via tool search.
+            attr_reader defer_loading: bool?
+
+            # Whether this function should be deferred and discovered via tool search.
+            def defer_loading=: (bool) -> bool
+
+            attr_accessor description: String?
+
+            # A JSON Schema describing the JSON value encoded in string outputs for this
+            # function tool. This does not describe content-array outputs.
+            attr_accessor output_schema: ::Hash[Symbol, top]?
+
+            attr_accessor parameters: top?
+
+            # Whether to enforce strict parameter validation. If omitted, Responses attempts
+            # to use strict validation when the schema is compatible, and falls back to
+            # non-strict validation otherwise.
+            attr_accessor strict: bool?
+
+            # @param name
+            #   The name of the loaded function tool.
+            # @param allowed_callers
+            #   The tool invocation context(s).
+            # @param async
+            #   Whether the tool response can be returned asynchronously versus immediately
+            #   returned on next response creation.
+            # @param defer_loading
+            #   Whether this function should be deferred and discovered via tool search.
+            # @param output_schema
+            #   A JSON Schema describing the JSON value encoded in string outputs for this
+            #   function tool. This does not describe content-array outputs.
+            # @param strict
+            #   Whether to enforce strict parameter validation. If omitted, Responses attempts
+            #   to use strict validation when the schema is compatible, and falls back to
+            #   non-strict validation otherwise.
+            def initialize: (
+              name: String,
+              ?allowed_callers: ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::Tool::Function::allowed_caller]?,
+              ?async: bool,
+              ?defer_loading: bool,
+              ?description: String?,
+              ?output_schema: ::Hash[Symbol, top]?,
+              ?parameters: top?,
+              ?strict: bool?,
+              ?type: :function
+            ) -> void
+
+            def to_hash: -> {
+              name: String,
+              ?type: :function,
+              ?allowed_callers: ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::Tool::Function::allowed_caller]?,
+              ?async: bool,
+              ?defer_loading: bool,
+              ?description: String?,
+              ?output_schema: ::Hash[Symbol, top]?,
+              ?parameters: top?,
+              ?strict: bool?
+            }
+
+            type allowed_caller = :direct | :programmatic
+
+            module AllowedCaller
+              extend OpenAI::Internal::Type::Enum
+
+              DIRECT: :direct
+              PROGRAMMATIC: :programmatic
+
+              def self?.values: -> ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::Tool::Function::allowed_caller]
+            end
+          end
+
+          def self?.variants: -> ::Array[OpenAI::Models::Beta::BetaToolSearchOutputNamespaceTool::tool]
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/beta/environment_param.rbs

@@ -72,8 +72,8 @@ module OpenAI
           # Files available before the agent starts. Defaults to an empty list.
           attr_accessor files: ::Array[OpenAI::Models::Beta::hosted_environment_file_param]?
 
-          # 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.
           attr_accessor network: OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network?
 
           # Packages to install in the environment. Defaults to empty package lists.
@@ -105,8 +105,8 @@ module OpenAI
           # @param files
           #   Files available before the agent starts. Defaults to an empty list.
           # @param network
-          #   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.
           # @param packages
           #   Packages to install in the environment. Defaults to empty package lists.
           # @param plugins

data/sig/openai/models/beta/session_turn_error.rbs

@@ -29,6 +29,9 @@ module OpenAI
           :context_length_exceeded
           | :session_budget_exceeded
           | :usage_limit_exceeded
+          | :project_spend_limit_exceeded
+          | :organization_spend_limit_exceeded
+          | :organization_usage_limit_exceeded
           | :credit_balance_exhausted
           | :rate_limit_exceeded
           | :flex_unavailable
@@ -58,6 +61,15 @@ module OpenAI
           # The organization has reached a usage, plan, or billing limit.
           USAGE_LIMIT_EXCEEDED: :usage_limit_exceeded
 
+          # The project has reached its enforced spend limit.
+          PROJECT_SPEND_LIMIT_EXCEEDED: :project_spend_limit_exceeded
+
+          # The organization has reached its enforced spend limit.
+          ORGANIZATION_SPEND_LIMIT_EXCEEDED: :organization_spend_limit_exceeded
+
+          # The organization has reached its OpenAI-assigned usage limit.
+          ORGANIZATION_USAGE_LIMIT_EXCEEDED: :organization_usage_limit_exceeded
+
           # The organization has no API credits remaining.
           CREDIT_BALANCE_EXHAUSTED: :credit_balance_exhausted
 

data/sig/openai/models/chat/chat_completion_chunk.rbs

@@ -177,58 +177,65 @@ module OpenAI
         type choice =
           {
             delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta,
-            finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
             index: Integer,
+            ?finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
             ?logprobs: OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs?
           }
 
         class Choice < OpenAI::Internal::Type::BaseModel
-          # 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.
           attr_accessor delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta
 
+          # The index of the choice in the list of choices.
+          attr_accessor index: Integer
+
           # 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`.
           attr_accessor finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?
 
-          # The index of the choice in the list of choices.
-          attr_accessor index: Integer
-
           # Log probability information for the choice.
           attr_accessor logprobs: OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs?
 
           # @param delta
-          #   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.
+          # @param index
+          #   The index of the choice in the list of choices.
           # @param finish_reason
           #   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.
-          # @param index
-          #   The index of the choice in the list of choices.
+          #   function. Omitted from the final audio update containing only
+          #   `delta.audio.expires_at`.
           # @param logprobs
           #   Log probability information for the choice.
           def initialize: (
             delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta,
-            finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
             index: Integer,
+            ?finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
             ?logprobs: OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs?
           ) -> void
 
           def to_hash: -> {
             delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta,
-            finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
             index: Integer,
+            ?finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
             ?logprobs: OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs?
           }
 
           type delta =
             {
+              ?audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
               ?content: String?,
               ?function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall,
               ?refusal: String?,
@@ -237,6 +244,16 @@ module OpenAI
             }
 
           class Delta < OpenAI::Internal::Type::BaseModel
+            # A partial audio response. Audio chunks may carry an ID, base64 data, or
+            # transcript text; the final audio update contains only its expiry timestamp.
+            attr_reader audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio?
+
+            # A partial audio response. Audio chunks may carry an ID, base64 data, or
+            # transcript text; the final audio update contains only its expiry timestamp.
+            def audio=: (
+              OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio
+            ) -> OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio
+
             # The contents of the chunk message.
             attr_accessor content: String?
 
@@ -267,6 +284,9 @@ module OpenAI
               ::Array[OpenAI::Chat::ChatCompletionChunk::Choice::Delta::ToolCall]
             ) -> ::Array[OpenAI::Chat::ChatCompletionChunk::Choice::Delta::ToolCall]
 
+            # @param audio
+            #   A partial audio response. Audio chunks may carry an ID, base64 data, or
+            #   transcript text; the final audio update contains only its expiry timestamp.
             # @param content
             #   The contents of the chunk message.
             # @param function_call
@@ -277,6 +297,7 @@ module OpenAI
             # @param role
             #   The role of the author of this message.
             def initialize: (
+              ?audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
               ?content: String?,
               ?function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall,
               ?refusal: String?,
@@ -285,6 +306,7 @@ module OpenAI
             ) -> void
 
             def to_hash: -> {
+              ?audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
               ?content: String?,
               ?function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall,
               ?refusal: String?,
@@ -292,6 +314,68 @@ module OpenAI
               ?tool_calls: ::Array[OpenAI::Chat::ChatCompletionChunk::Choice::Delta::ToolCall]
             }
 
+            type audio =
+              {
+                ?id: String,
+                ?data: String,
+                ?expires_at: Integer,
+                ?transcript: String
+              }
+
+            class Audio < OpenAI::Internal::Type::BaseModel
+              # Unique identifier for this audio response.
+              attr_reader id: String?
+
+              # Unique identifier for this audio response.
+              def id=: (String) -> String
+
+              # Base64 encoded audio bytes generated by the model, in the format specified in
+              # the request.
+              attr_reader data: String?
+
+              # Base64 encoded audio bytes generated by the model, in the format specified in
+              # the request.
+              def data=: (String) -> String
+
+              # The Unix timestamp (in seconds) for when this audio response will no longer be
+              # accessible on the server for use in multi-turn conversations.
+              attr_reader expires_at: Integer?
+
+              # The Unix timestamp (in seconds) for when this audio response will no longer be
+              # accessible on the server for use in multi-turn conversations.
+              def expires_at=: (Integer) -> Integer
+
+              # Transcript text from this audio chunk.
+              attr_reader transcript: String?
+
+              # Transcript text from this audio chunk.
+              def transcript=: (String) -> String
+
+              # @param id
+              #   Unique identifier for this audio response.
+              # @param data
+              #   Base64 encoded audio bytes generated by the model, in the format specified in
+              #   the request.
+              # @param expires_at
+              #   The Unix timestamp (in seconds) for when this audio response will no longer be
+              #   accessible on the server for use in multi-turn conversations.
+              # @param transcript
+              #   Transcript text from this audio chunk.
+              def initialize: (
+                ?id: String,
+                ?data: String,
+                ?expires_at: Integer,
+                ?transcript: String
+              ) -> void
+
+              def to_hash: -> {
+                ?id: String,
+                ?data: String,
+                ?expires_at: Integer,
+                ?transcript: String
+              }
+            end
+
             type function_call = { ?arguments: String, ?name: String }
 
             class FunctionCall < OpenAI::Internal::Type::BaseModel