openai 0.103.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_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_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
 

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

@@ -59,6 +59,16 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :metadata
 
+          # Optional spending limit in USD cents. Omission or null creates an unlimited
+          # session.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl)) }
+          attr_reader :spend_control
+
+          sig {
+            params(spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash)).void
+          }
+          attr_writer :spend_control
+
           # The IDs of vaults made available to the session.
           sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :vault_ids
@@ -80,6 +90,8 @@ module OpenAI
 
               metadata: T.nilable(T::Hash[Symbol, String]),
 
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
+
               vault_ids: T.nilable(T::Array[String]),
 
               request_options: OpenAI::RequestOptions::OrHash
@@ -109,6 +121,10 @@ module OpenAI
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
 
+            # Optional spending limit in USD cents. Omission or null creates an unlimited
+            # session.
+            spend_control: nil,
+
             # The IDs of vaults made available to the session.
             vault_ids: nil,
 
@@ -128,6 +144,7 @@ module OpenAI
                 agent_id: String,
                 input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
                 metadata: T.nilable(T::Hash[Symbol, String]),
+                spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl),
                 vault_ids: T.nilable(T::Array[String]),
                 request_options: OpenAI::RequestOptions
               }
@@ -182,7 +199,9 @@ module OpenAI
             sig { params(text: T.nilable(OpenAI::Beta::AgentTextParam::OrHash)).void }
             attr_writer :text
 
-            # Tools available to the agent. Omit to inherit, or pass null to clear them.
+            # Tools available to the agent. Omit to inherit, or pass null to clear them. The
+            # resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8
+            # JSON.
             sig {
               returns(
                 T.nilable(
@@ -255,7 +274,9 @@ module OpenAI
               # Configuration for text generated by the agent.
               text: nil,
 
-              # Tools available to the agent. Omit to inherit, or pass null to clear them.
+              # Tools available to the agent. Omit to inherit, or pass null to clear them. The
+              # resolved tool list must fit within 3 MiB (3,145,728 bytes) of compact UTF-8
+              # JSON.
 
               tools: nil
             )
@@ -340,6 +361,45 @@ module OpenAI
 
           end
 
+          class SpendControl < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::SessionCreateParams::SpendControl,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Positive USD cents, or null to remove the limit.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :limit
+
+            # Optional spending limit in USD cents. Omission or null creates an unlimited
+            # session.
+            sig do
+              params(
+
+                limit: T.nilable(Integer)
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Positive USD cents, or null to remove the limit.
+
+              limit:
+            )
+            end
+
+            sig do
+              override.returns(
+                {limit: T.nilable(Integer)}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
         end
 
       end

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

@@ -34,12 +34,14 @@ module OpenAI
           sig { params(agent_id: String).void }
           attr_writer :agent_id
 
-          # 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
 
-          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          # `desc` for descending order. Defaults to `desc`.
+          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::SessionListParams::Order::OrSymbol)) }
           attr_reader :order
 
@@ -53,7 +55,7 @@ module OpenAI
 
               agent_id: String,
 
-              limit: T.nilable(Integer),
+              limit: Integer,
 
               order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
 
@@ -70,11 +72,10 @@ module OpenAI
             # all agents.
             agent_id: nil,
 
-            # The maximum number of resources to return.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
 
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
 
             request_options: {}
@@ -86,7 +87,7 @@ module OpenAI
               {
                 after: String,
                 agent_id: String,
-                limit: T.nilable(Integer),
+                limit: Integer,
                 order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
                 request_options: OpenAI::RequestOptions
               }
@@ -95,8 +96,7 @@ module OpenAI
           def to_hash
           end
 
-          # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-          # `desc` for descending order. Defaults to `desc`.
+          # The order in which resources are returned. Defaults to `desc`.
           module Order
             extend OpenAI::Internal::Type::Enum
 

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

@@ -35,6 +35,16 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :metadata
 
+          # Omit to retain the limit; null or a null limit removes it without resetting
+          # spend.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl)) }
+          attr_reader :spend_control
+
+          sig {
+            params(spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash)).void
+          }
+          attr_writer :spend_control
+
           sig do
             params(
 
@@ -44,6 +54,8 @@ module OpenAI
 
               metadata: T.nilable(T::Hash[Symbol, String]),
 
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash),
+
               request_options: OpenAI::RequestOptions::OrHash
             )
               .returns(T.attached_class)
@@ -60,6 +72,10 @@ module OpenAI
             # characters.
             metadata: nil,
 
+            # Omit to retain the limit; null or a null limit removes it without resetting
+            # spend.
+            spend_control: nil,
+
             request_options: {}
           )
           end
@@ -70,6 +86,7 @@ module OpenAI
                 session_id: String,
                 agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent,
                 metadata: T.nilable(T::Hash[Symbol, String]),
+                spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl),
                 request_options: OpenAI::RequestOptions
               }
             )
@@ -242,6 +259,45 @@ module OpenAI
             end
           end
 
+          class SpendControl < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::SessionUpdateParams::SpendControl,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # Positive USD cents, or null to remove the limit.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :limit
+
+            # Omit to retain the limit; null or a null limit removes it without resetting
+            # spend.
+            sig do
+              params(
+
+                limit: T.nilable(Integer)
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # Positive USD cents, or null to remove the limit.
+
+              limit:
+            )
+            end
+
+            sig do
+              override.returns(
+                {limit: T.nilable(Integer)}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
         end
 
       end