openai 0.97.0 → 0.99.0

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

@@ -0,0 +1,321 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Audio
+
+      class VoiceCreateParams < OpenAI::Internal::Type::BaseModel
+
+        extend OpenAI::Internal::Type::RequestParameters::Converter
+        include OpenAI::Internal::Type::RequestParameters
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Audio::VoiceCreateParams,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # Creates a voice from a consent recording and an audio sample. Requires
+        # multipart/form-data.
+        sig {
+          returns(
+            T.any(OpenAI::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Audio::VoiceCreateParams::Body::Prompt)
+          )
+        }
+        attr_accessor :body
+
+        sig do
+          params(
+
+            body: T.any(
+              OpenAI::Audio::VoiceCreateParams::Body::AudioSample::OrHash,
+              OpenAI::Audio::VoiceCreateParams::Body::Prompt::OrHash
+            ),
+
+            request_options: OpenAI::RequestOptions::OrHash
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # Creates a voice from a consent recording and an audio sample. Requires
+          # multipart/form-data.
+          body:,
+
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              body: T.any(
+                OpenAI::Audio::VoiceCreateParams::Body::AudioSample,
+                OpenAI::Audio::VoiceCreateParams::Body::Prompt
+              ),
+              request_options: OpenAI::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Creates a voice from a consent recording and an audio sample. Requires
+        # multipart/form-data.
+        module Body
+          extend OpenAI::Internal::Type::Union
+
+          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
+              T.any(
+                OpenAI::Audio::VoiceCreateParams::Body::AudioSample,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The sample audio recording file. Maximum size is 10 MiB.
+            #
+            # Supported MIME types: `audio/mpeg`, `audio/wav`, `audio/x-wav`, `audio/ogg`,
+            # `audio/aac`, `audio/flac`, `audio/webm`, `audio/mp4`.
+            #
+            # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+            # metadata. Use `OpenAI::FilePart` when you need to override the filename or
+            # content type.
+            sig { returns(OpenAI::Internal::FileInput) }
+            attr_accessor :audio_sample
+
+            # The consent recording ID (for example, `cons_1234`).
+            sig { returns(String) }
+            attr_accessor :consent
+
+            # The name of the new voice.
+            sig { returns(String) }
+            attr_accessor :name
+
+            # The voice creation method. Defaults to `audio_sample` when omitted.
+            sig { returns(T.nilable(OpenAI::Audio::VoiceCreateParams::Body::AudioSample::Type::OrSymbol)) }
+            attr_reader :type
+
+            sig { params(type: OpenAI::Audio::VoiceCreateParams::Body::AudioSample::Type::OrSymbol).void }
+            attr_writer :type
+
+            # Creates a voice from a consent recording and an audio sample. Requires
+            # multipart/form-data.
+            sig do
+              params(
+
+                audio_sample: OpenAI::Internal::FileInput,
+
+                consent: String,
+
+                name: String,
+
+                type: OpenAI::Audio::VoiceCreateParams::Body::AudioSample::Type::OrSymbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The sample audio recording file. Maximum size is 10 MiB.
+              #
+              # Supported MIME types: `audio/mpeg`, `audio/wav`, `audio/x-wav`, `audio/ogg`,
+              # `audio/aac`, `audio/flac`, `audio/webm`, `audio/mp4`.
+              #
+              # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
+              # metadata. Use `OpenAI::FilePart` when you need to override the filename or
+              # content type.
+              audio_sample:,
+
+              # The consent recording ID (for example, `cons_1234`).
+              consent:,
+
+              # The name of the new voice.
+              name:,
+
+              # The voice creation method. Defaults to `audio_sample` when omitted.
+
+              type: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  audio_sample: OpenAI::Internal::FileInput,
+                  consent: String,
+                  name: String,
+                  type: OpenAI::Audio::VoiceCreateParams::Body::AudioSample::Type::OrSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The voice creation method. Defaults to `audio_sample` when omitted.
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Audio::VoiceCreateParams::Body::AudioSample::Type) }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              AUDIO_SAMPLE = T.let(
+                :audio_sample,
+                OpenAI::Audio::VoiceCreateParams::Body::AudioSample::Type::TaggedSymbol
+              )
+
+              sig {
+                override.returns(T::Array[OpenAI::Audio::VoiceCreateParams::Body::AudioSample::Type::TaggedSymbol])
+              }
+              def self.values
+              end
+            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_01 = T.let(
+                :"2026-10-01",
+                OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::TaggedSymbol
+              )
+
+            end
+          end
+
+          sig { override.returns(T::Array[OpenAI::Audio::VoiceCreateParams::Body::Variants]) }
+          def self.variants
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

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

@@ -206,9 +206,6 @@ module OpenAI
           # Uses the fast service tier.
           FAST = T.let(:fast, OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol)
 
-          # Uses the ultrafast service tier.
-          ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol)
-
           sig { override.returns(T::Array[OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol]) }
           def self.values
           end

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

@@ -217,9 +217,6 @@ module OpenAI
           # Uses the fast service tier.
           FAST = T.let(:fast, OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol)
 
-          # Uses the ultrafast service tier.
-          ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol)
-
           sig { override.returns(T::Array[OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol]) }
           def self.values
           end

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

@@ -312,9 +312,6 @@ module OpenAI
               # Uses the fast service tier.
               FAST = T.let(:fast, OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol)
 
-              # Uses the ultrafast service tier.
-              ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol)
-
               sig {
                 override.returns(T::Array[OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol])
               }

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

@@ -234,9 +234,6 @@ module OpenAI
               # Uses the fast service tier.
               FAST = T.let(:fast, OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol)
 
-              # Uses the ultrafast service tier.
-              ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol)
-
               sig {
                 override.returns(T::Array[OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol])
               }

data/rbi/openai/models/beta/agents/sessions/session_trace.rbi

@@ -0,0 +1,97 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        SessionTrace = Sessions::SessionTrace
+
+        module Sessions
+
+          class SessionTrace < OpenAI::Internal::Type::BaseModel
+
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::Sessions::SessionTrace,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The root turn ID. Use this ID as the pagination anchor.
+            sig { returns(String) }
+            attr_accessor :id
+
+            # The Unix timestamp in seconds when the root turn was created.
+            sig { returns(Integer) }
+            attr_accessor :created_at
+
+            # The object type, which is always `agent.session.trace`.
+            sig { returns(Symbol) }
+            attr_accessor :object
+
+            # An OTLP JSON ExportTraceServiceRequest containing resourceSpans. Only currently
+            # published data is returned; later trace updates are not awaited.
+            sig { returns(T::Hash[Symbol, T.anything]) }
+            attr_accessor :otlp
+
+            # The session that owns this trace.
+            sig { returns(String) }
+            attr_accessor :session_id
+
+            sig do
+              params(
+
+                id: String,
+
+                created_at: Integer,
+
+                otlp: T::Hash[Symbol, T.anything],
+
+                session_id: String,
+
+                object: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The root turn ID. Use this ID as the pagination anchor.
+              id:,
+
+              # The Unix timestamp in seconds when the root turn was created.
+              created_at:,
+
+              # An OTLP JSON ExportTraceServiceRequest containing resourceSpans. Only currently
+              # published data is returned; later trace updates are not awaited.
+              otlp:,
+
+              # The session that owns this trace.
+              session_id:,
+
+              # The object type, which is always `agent.session.trace`.
+
+              object: :"agent.session.trace"
+            )
+            end
+
+            sig do
+              override.returns(
+                {id: String, created_at: Integer, object: Symbol, otlp: T::Hash[Symbol, T.anything], session_id: String}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agents/sessions/trace_list_params.rbi

@@ -0,0 +1,121 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        module Sessions
+
+          class TraceListParams < 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::TraceListParams,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(String) }
+            attr_accessor :session_id
+
+            # 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 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::TraceListParams::Order::OrSymbol)) }
+            attr_reader :order
+
+            sig { params(order: OpenAI::Beta::Agents::Sessions::TraceListParams::Order::OrSymbol).void }
+            attr_writer :order
+
+            sig do
+              params(
+
+                session_id: String,
+
+                after: String,
+
+                limit: Integer,
+
+                order: OpenAI::Beta::Agents::Sessions::TraceListParams::Order::OrSymbol,
+
+                request_options: OpenAI::RequestOptions::OrHash
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              session_id:,
+
+              # Return resources after this resource ID in the selected order.
+              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,
+                  after: String,
+                  limit: Integer,
+                  order: OpenAI::Beta::Agents::Sessions::TraceListParams::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::TraceListParams::Order) }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              # Returns resources in ascending order.
+              ASC = T.let(:asc, OpenAI::Beta::Agents::Sessions::TraceListParams::Order::TaggedSymbol)
+
+              # Returns resources in descending order.
+              DESC = T.let(:desc, OpenAI::Beta::Agents::Sessions::TraceListParams::Order::TaggedSymbol)
+
+              sig { override.returns(T::Array[OpenAI::Beta::Agents::Sessions::TraceListParams::Order::TaggedSymbol]) }
+              def self.values
+              end
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agents/vaults/credential.rbi

@@ -64,14 +64,14 @@ module OpenAI
 
                 created_at: Integer,
 
-                metadata: T::Hash[Symbol, String],
-
                 name: String,
 
                 updated_at: Integer,
 
                 vault_id: String,
 
+                metadata: T::Hash[Symbol, String],
+
                 object: Symbol
               )
                 .returns(T.attached_class)
@@ -87,9 +87,6 @@ module OpenAI
               # The Unix timestamp, in seconds, when the credential was created.
               created_at:,
 
-              # Application-defined key-value pairs associated with this credential.
-              metadata:,
-
               # The human-readable name of the credential.
               name:,
 
@@ -99,6 +96,9 @@ module OpenAI
               # The ID of the vault containing this credential.
               vault_id:,
 
+              # Application-defined key-value pairs associated with this credential.
+              metadata: {},
+
               # The object type. Always `vault.credential`.
 
               object: :"vault.credential"

data/rbi/openai/models/beta/beta_response_output_text.rbi

@@ -131,7 +131,7 @@ module OpenAI
             sig { returns(String) }
             attr_accessor :filename
 
-            # The index of the file in the list of files.
+            # The index in the output text at which to insert the file citation.
             sig { returns(Integer) }
             attr_accessor :index
 
@@ -161,7 +161,7 @@ module OpenAI
               # The filename of the file cited.
               filename:,
 
-              # The index of the file in the list of files.
+              # The index in the output text at which to insert the file citation.
               index:,
 
               # The type of the file citation. Always `file_citation`.

data/rbi/openai/models/beta/beta_response_output_text_annotation_added_event.rbi

@@ -155,7 +155,7 @@ module OpenAI
             sig { returns(String) }
             attr_accessor :filename
 
-            # The index of the file in the list of files.
+            # The index in the output text at which to insert the file citation.
             sig { returns(Integer) }
             attr_accessor :index
 
@@ -185,7 +185,7 @@ module OpenAI
               # The filename of the file cited.
               filename:,
 
-              # The index of the file in the list of files.
+              # The index in the output text at which to insert the file citation.
               index:,
 
               # The type of the file citation. Always `file_citation`.

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

@@ -1050,9 +1050,7 @@ module OpenAI
           # the maximum supported resolution is `3840x2160`. The requested size must also
           # satisfy the model's current pixel and edge limits. The standard sizes
           # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-          # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-          # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-          # `1024x1024`, `1792x1024`, or `1024x1792`.
+          # `auto` is supported for models that allow automatic sizing.
           sig { returns(T.nilable(T.any(String, OpenAI::Beta::BetaTool::ImageGeneration::Size::OrSymbol))) }
           attr_reader :size
 
@@ -1150,9 +1148,7 @@ module OpenAI
             # the maximum supported resolution is `3840x2160`. The requested size must also
             # satisfy the model's current pixel and edge limits. The standard sizes
             # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-            # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-            # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-            # `1024x1024`, `1792x1024`, or `1024x1792`.
+            # `auto` is supported for models that allow automatic sizing.
             size: nil,
 
             # The type of the image generation tool. Always `image_generation`.
@@ -1407,9 +1403,7 @@ module OpenAI
           # the maximum supported resolution is `3840x2160`. The requested size must also
           # satisfy the model's current pixel and edge limits. The standard sizes
           # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
-          # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
-          # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
-          # `1024x1024`, `1792x1024`, or `1024x1792`.
+          # `auto` is supported for models that allow automatic sizing.
           module Size
             extend OpenAI::Internal::Type::Union