openai 0.102.0 → 0.104.0

data/rbi/openai/models/audio/voice_create_params.rbi

@@ -19,13 +19,20 @@ module OpenAI
 
         # Creates a voice from a consent recording and an audio sample. Requires
         # multipart/form-data.
-        sig { returns(OpenAI::Audio::VoiceCreateParams::Body::AudioSample) }
+        sig {
+          returns(
+            T.any(OpenAI::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Audio::VoiceCreateParams::Body::Prompt)
+          )
+        }
         attr_accessor :body
 
         sig do
           params(
 
-            body: OpenAI::Audio::VoiceCreateParams::Body::AudioSample::OrHash,
+            body: T.any(
+              OpenAI::Audio::VoiceCreateParams::Body::AudioSample::OrHash,
+              OpenAI::Audio::VoiceCreateParams::Body::Prompt::OrHash
+            ),
 
             request_options: OpenAI::RequestOptions::OrHash
           )
@@ -43,7 +50,13 @@ module OpenAI
 
         sig do
           override.returns(
-            {body: OpenAI::Audio::VoiceCreateParams::Body::AudioSample, request_options: OpenAI::RequestOptions}
+            {
+              body: T.any(
+                OpenAI::Audio::VoiceCreateParams::Body::AudioSample,
+                OpenAI::Audio::VoiceCreateParams::Body::Prompt
+              ),
+              request_options: OpenAI::RequestOptions
+            }
           )
         end
         def to_hash
@@ -54,7 +67,9 @@ module OpenAI
         module Body
           extend OpenAI::Internal::Type::Union
 
-          Variants = T.type_alias { OpenAI::Audio::VoiceCreateParams::Body::AudioSample }
+          Variants = T.type_alias {
+            T.any(OpenAI::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Audio::VoiceCreateParams::Body::Prompt)
+          }
 
           class AudioSample < OpenAI::Internal::Type::BaseModel
             OrHash = T.type_alias do
@@ -162,6 +177,136 @@ module OpenAI
             end
           end
 
+          class Prompt < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Audio::VoiceCreateParams::Body::Prompt,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The name of the new voice.
+            sig { returns(String) }
+            attr_accessor :name
+
+            # A description of the desired voice. Must not contain only whitespace.
+            sig { returns(String) }
+            attr_accessor :prompt
+
+            # Set to `prompt` to create a voice from a text description.
+            sig { returns(OpenAI::Audio::VoiceCreateParams::Body::Prompt::Type::OrSymbol) }
+            attr_accessor :type
+
+            # The voice creation model to use. Defaults to `auto`.
+            sig { returns(T.nilable(T.any(String, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::OrSymbol))) }
+            attr_reader :model
+
+            sig { params(model: T.any(String, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::OrSymbol)).void }
+            attr_writer :model
+
+            # Optional text for the voice to speak during creation. If omitted, a script is
+            # generated from the prompt. Must not be blank after trimming whitespace; scripts
+            # that are too short are rejected.
+            sig { returns(T.nilable(String)) }
+            attr_reader :script_hint
+
+            sig { params(script_hint: String).void }
+            attr_writer :script_hint
+
+            # Creates a synthetic voice from a text description. Supports application/json or
+            # multipart/form-data.
+            sig do
+              params(
+
+                name: String,
+
+                prompt: String,
+
+                type: OpenAI::Audio::VoiceCreateParams::Body::Prompt::Type::OrSymbol,
+
+                model: T.any(String, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::OrSymbol),
+
+                script_hint: String
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The name of the new voice.
+              name:,
+
+              # A description of the desired voice. Must not contain only whitespace.
+              prompt:,
+
+              # Set to `prompt` to create a voice from a text description.
+              type:,
+
+              # The voice creation model to use. Defaults to `auto`.
+              model: nil,
+
+              # Optional text for the voice to speak during creation. If omitted, a script is
+              # generated from the prompt. Must not be blank after trimming whitespace; scripts
+              # that are too short are rejected.
+
+              script_hint: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  name: String,
+                  prompt: String,
+                  type: OpenAI::Audio::VoiceCreateParams::Body::Prompt::Type::OrSymbol,
+                  model: T.any(String, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::OrSymbol),
+                  script_hint: String
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Set to `prompt` to create a voice from a text description.
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Type) }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              PROMPT = T.let(:prompt, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Type::TaggedSymbol)
+
+              sig { override.returns(T::Array[OpenAI::Audio::VoiceCreateParams::Body::Prompt::Type::TaggedSymbol]) }
+              def self.values
+              end
+            end
+
+            # The voice creation model to use. Defaults to `auto`.
+            module Model
+              extend OpenAI::Internal::Type::Union
+
+              Variants = T.type_alias {
+                T.any(String, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::TaggedSymbol)
+              }
+
+              sig { override.returns(T::Array[OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::Variants]) }
+              def self.variants
+              end
+
+              TaggedSymbol = T.type_alias do
+                T.all(Symbol, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model)
+              end
+
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              AUTO = T.let(:auto, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::TaggedSymbol)
+              MODEL_2026_10_08 = T.let(
+                :"2026-10-08",
+                OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::TaggedSymbol
+              )
+
+            end
+          end
+
           sig { override.returns(T::Array[OpenAI::Audio::VoiceCreateParams::Body::Variants]) }
           def self.variants
           end

data/rbi/openai/models/beta/agent_create_params.rbi

@@ -62,7 +62,8 @@ module OpenAI
         sig { params(text: T.nilable(OpenAI::Beta::AgentTextParam::OrHash)).void }
         attr_writer :text
 
-        # Tools available to the agent. Defaults to an empty list.
+        # Tools available to the agent. Defaults to an empty list. The tool list must fit
+        # within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         sig {
           returns(
             T.nilable(
@@ -147,7 +148,8 @@ module OpenAI
           # verbosity.
           text: nil,
 
-          # Tools available to the agent. Defaults to an empty list.
+          # Tools available to the agent. Defaults to an empty list. The tool list must fit
+          # within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
           tools: nil,
 
           request_options: {}

data/rbi/openai/models/beta/agent_list_params.rbi

@@ -24,9 +24,12 @@ module OpenAI
         sig { params(after: String).void }
         attr_writer :after
 
-        # The maximum number of resources to return.
+        # The maximum number of resources to return, between 1 and 100. Defaults to 20.
         sig { returns(T.nilable(Integer)) }
-        attr_accessor :limit
+        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::AgentListParams::Order::OrSymbol)) }
@@ -40,7 +43,7 @@ module OpenAI
 
             after: String,
 
-            limit: T.nilable(Integer),
+            limit: Integer,
 
             order: OpenAI::Beta::AgentListParams::Order::OrSymbol,
 
@@ -53,7 +56,7 @@ module OpenAI
           # Return resources after this resource ID in the selected order.
           after: nil,
 
-          # The maximum number of resources to return.
+          # 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`.
@@ -67,7 +70,7 @@ module OpenAI
           override.returns(
             {
               after: String,
-              limit: T.nilable(Integer),
+              limit: Integer,
               order: OpenAI::Beta::AgentListParams::Order::OrSymbol,
               request_options: OpenAI::RequestOptions
             }

data/rbi/openai/models/beta/agent_session.rbi

@@ -69,6 +69,14 @@ module OpenAI
         sig { returns(T::Array[String]) }
         attr_accessor :vault_ids
 
+        # Configured spending limit and best-effort consumption, in USD cents. Unlimited
+        # sessions omit this object.
+        sig { returns(T.nilable(OpenAI::Beta::AgentSession::SpendControl)) }
+        attr_reader :spend_control
+
+        sig { params(spend_control: OpenAI::Beta::AgentSession::SpendControl::OrHash).void }
+        attr_writer :spend_control
+
         # A Managed Agents session.
         sig do
           params(
@@ -105,6 +113,8 @@ module OpenAI
 
             vault_ids: T::Array[String],
 
+            spend_control: OpenAI::Beta::AgentSession::SpendControl::OrHash,
+
             object: Symbol
           )
             .returns(T.attached_class)
@@ -145,6 +155,10 @@ module OpenAI
           # The IDs of vaults made available to the session.
           vault_ids:,
 
+          # Configured spending limit and best-effort consumption, in USD cents. Unlimited
+          # sessions omit this object.
+          spend_control: nil,
+
           # The object type. Always `agent.session`.
 
           object: :"agent.session"
@@ -165,7 +179,8 @@ module OpenAI
               required_actions: T::Array[OpenAI::Beta::AgentSession::RequiredAction::Variants],
               status: OpenAI::Beta::AgentSession::Status::TaggedSymbol,
               usage: T.nilable(OpenAI::Beta::TokenUsage),
-              vault_ids: T::Array[String]
+              vault_ids: T::Array[String],
+              spend_control: OpenAI::Beta::AgentSession::SpendControl
             }
           )
         end
@@ -861,6 +876,54 @@ module OpenAI
           end
         end
 
+        class SpendControl < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::AgentSession::SpendControl,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Best-effort recorded spend floored to whole USD cents, or null when unavailable.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :consumed
+
+          # The configured positive limit in USD cents.
+          sig { returns(Integer) }
+          attr_accessor :limit
+
+          # Configured spending limit and best-effort consumption, in USD cents. Unlimited
+          # sessions omit this object.
+          sig do
+            params(
+
+              consumed: T.nilable(Integer),
+
+              limit: Integer
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Best-effort recorded spend floored to whole USD cents, or null when unavailable.
+            consumed:,
+
+            # The configured positive limit in USD cents.
+
+            limit:
+          )
+          end
+
+          sig do
+            override.returns(
+              {consumed: T.nilable(Integer), limit: Integer}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
       end
 
     end

data/rbi/openai/models/beta/agent_session_environment_expired_event.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      class AgentSessionEnvironmentExpiredEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Beta::AgentSessionEnvironmentExpiredEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The current environment state.
+        sig { returns(OpenAI::Beta::AgentSessionEnvironmentState) }
+        attr_reader :environment
+
+        sig { params(environment: OpenAI::Beta::AgentSessionEnvironmentState::OrHash).void }
+        attr_writer :environment
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :event_id
+
+        # The ID of the session associated with the event.
+        sig { returns(String) }
+        attr_accessor :session_id
+
+        # The ID of the turn associated with the event, when applicable.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :turn_id
+
+        # The type of the object. Always `agent.session.environment.expired`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Emitted after a suspended hosted session environment and its checkpoint expire.
+        sig do
+          params(
+
+            environment: OpenAI::Beta::AgentSessionEnvironmentState::OrHash,
+
+            event_id: String,
+
+            session_id: String,
+
+            turn_id: T.nilable(String),
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The current environment state.
+          environment:,
+
+          # The unique ID of the event.
+          event_id:,
+
+          # The ID of the session associated with the event.
+          session_id:,
+
+          # The ID of the turn associated with the event, when applicable.
+          turn_id:,
+
+          # The type of the object. Always `agent.session.environment.expired`.
+
+          type: :"agent.session.environment.expired"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              environment: OpenAI::Beta::AgentSessionEnvironmentState,
+              event_id: String,
+              session_id: String,
+              turn_id: T.nilable(String),
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agent_session_environment_state.rbi

@@ -152,6 +152,12 @@ module OpenAI
           # The environment is disconnected.
           DISCONNECTED = T.let(:disconnected, OpenAI::Beta::AgentSessionEnvironmentState::Status::TaggedSymbol)
 
+          # The environment is stopped and can be resumed from its private checkpoint.
+          SUSPENDED = T.let(:suspended, OpenAI::Beta::AgentSessionEnvironmentState::Status::TaggedSymbol)
+
+          # The environment and its private checkpoint have expired.
+          EXPIRED = T.let(:expired, OpenAI::Beta::AgentSessionEnvironmentState::Status::TaggedSymbol)
+
           # The environment failed to connect.
           FAILED = T.let(:failed, OpenAI::Beta::AgentSessionEnvironmentState::Status::TaggedSymbol)
 

data/rbi/openai/models/beta/agent_session_environment_suspended_event.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      class AgentSessionEnvironmentSuspendedEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Beta::AgentSessionEnvironmentSuspendedEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The current environment state.
+        sig { returns(OpenAI::Beta::AgentSessionEnvironmentState) }
+        attr_reader :environment
+
+        sig { params(environment: OpenAI::Beta::AgentSessionEnvironmentState::OrHash).void }
+        attr_writer :environment
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :event_id
+
+        # The ID of the session associated with the event.
+        sig { returns(String) }
+        attr_accessor :session_id
+
+        # The ID of the turn associated with the event, when applicable.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :turn_id
+
+        # The type of the object. Always `agent.session.environment.suspended`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Emitted after an idle hosted session environment is checkpointed and stopped.
+        sig do
+          params(
+
+            environment: OpenAI::Beta::AgentSessionEnvironmentState::OrHash,
+
+            event_id: String,
+
+            session_id: String,
+
+            turn_id: T.nilable(String),
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The current environment state.
+          environment:,
+
+          # The unique ID of the event.
+          event_id:,
+
+          # The ID of the session associated with the event.
+          session_id:,
+
+          # The ID of the turn associated with the event, when applicable.
+          turn_id:,
+
+          # The type of the object. Always `agent.session.environment.suspended`.
+
+          type: :"agent.session.environment.suspended"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              environment: OpenAI::Beta::AgentSessionEnvironmentState,
+              event_id: String,
+              session_id: String,
+              turn_id: T.nilable(String),
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agent_session_event.rbi

@@ -13,6 +13,8 @@ module OpenAI
           T.any(
             OpenAI::Beta::AgentSessionErrorEvent,
             OpenAI::Beta::AgentSessionEnvironmentReadyEvent,
+            OpenAI::Beta::AgentSessionEnvironmentSuspendedEvent,
+            OpenAI::Beta::AgentSessionEnvironmentExpiredEvent,
             OpenAI::Beta::AgentSessionEnvironmentResetEvent,
             OpenAI::Beta::AgentOutputCommandExecutionOutputDeltaEvent,
             OpenAI::Beta::AgentSessionCreatedEvent,

data/rbi/openai/models/beta/agent_update_params.rbi

@@ -68,7 +68,8 @@ module OpenAI
         sig { params(text: T.nilable(OpenAI::Beta::AgentTextParam::OrHash)).void }
         attr_writer :text
 
-        # Tools available to the agent.
+        # Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.
+        # The replacement must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
         sig {
           returns(
             T.nilable(
@@ -157,7 +158,8 @@ module OpenAI
           # Configuration for text generated by the agent.
           text: nil,
 
-          # Tools available to the agent.
+          # Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.
+          # The replacement must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
           tools: nil,
 
           request_options: {}

data/rbi/openai/models/beta/agents/environment_info.rbi

@@ -126,6 +126,9 @@ module OpenAI
 
             CONNECTED = T.let(:connected, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
             DISCONNECTED = T.let(:disconnected, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
+            # The sandbox is stopped and can be resumed from its private checkpoint.
+            SUSPENDED = T.let(:suspended, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
+
             EXPIRED = T.let(:expired, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
             FAILED = T.let(:failed, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
 

data/rbi/openai/models/beta/agents/environment_list_params.rbi

@@ -19,21 +19,21 @@ module OpenAI
             )
           end
 
-          # Return environments after this environment ID in the selected order.
+          # Return resources after this resource ID in the selected order.
           sig { returns(T.nilable(String)) }
           attr_reader :after
 
           sig { params(after: String).void }
           attr_writer :after
 
-          # The maximum number of environments to return, between 1 and 100. Defaults to 20.
+          # 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 environments are returned. Defaults to `desc`.
+          # The order in which resources are returned. Defaults to `desc`.
           sig { returns(T.nilable(OpenAI::Beta::Agents::EnvironmentListParams::Order::OrSymbol)) }
           attr_reader :order
 
@@ -64,13 +64,13 @@ module OpenAI
           end
           def self.new(
 
-            # Return environments after this environment ID in the selected order.
+            # Return resources after this resource ID in the selected order.
             after: nil,
 
-            # The maximum number of environments to return, between 1 and 100. Defaults to 20.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
 
-            # The order in which environments are returned. Defaults to `desc`.
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
 
             # The hosting type to list. Defaults to `openai_hosted`.
@@ -94,7 +94,7 @@ module OpenAI
           def to_hash
           end
 
-          # The order in which environments are returned. Defaults to `desc`.
+          # The order in which resources are returned. Defaults to `desc`.
           module Order
             extend OpenAI::Internal::Type::Enum