openai 0.103.0 → 0.104.0

data/lib/openai/models/audio/speech_create_params.rb

@@ -29,7 +29,8 @@ module OpenAI
         #   object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         #   voices are available in the
         #   [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
-        #   Custom voices must be created from audio samples.
+        #   Custom voices must be created from audio samples. Voices created from text
+        #   prompts are supported only in Live.
         #
         #   @return [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID, OpenAI::Models::Audio::SpeechCreateParams::Voice]
         required :voice, union: -> { OpenAI::Audio::SpeechCreateParams::Voice }
@@ -78,7 +79,8 @@ module OpenAI
         #     object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         #     voices are available in the
         #     [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
-        #     Custom voices must be created from audio samples.
+        #     Custom voices must be created from audio samples. Voices created from text
+        #     prompts are supported only in Live.
         #
         #   @param instructions [String]
         #     Control the voice of your generated audio with additional instructions. Does not
@@ -119,7 +121,8 @@ module OpenAI
         # object with an `id`, for example `{ "id": "voice_1234" }`. Previews of the
         # voices are available in the
         # [Text to speech guide](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options).
-        # Custom voices must be created from audio samples.
+        # Custom voices must be created from audio samples. Voices created from text
+        # prompts are supported only in Live.
         module Voice
           extend OpenAI::Internal::Type::Union
 

data/lib/openai/models/audio/translation_create_response.rb

@@ -11,7 +11,6 @@ module OpenAI
 
         variant -> { OpenAI::Audio::TranslationVerbose }
 
-        # Text, SRT, and VTT responses retain the SDK's readable IO return value.
         variant StringIO
 
         # @!method self.variants

data/lib/openai/models/audio/voice.rb

@@ -35,8 +35,17 @@ module OpenAI
         #   @return [Symbol, OpenAI::Models::Audio::Voice::Type]
         required :type, enum: -> { OpenAI::Audio::Voice::Type }
 
-        # @!method initialize(id:, created_at:, name:, type:, object: :"audio.voice")
-        #   A custom voice that can be used for audio output.
+        # @!attribute prompt
+        #   The original text prompt used to create the voice. Present for prompt-generated
+        #   voices with a stored prompt; omitted for audio-sample voices and older voices
+        #   without a stored prompt.
+        #
+        #   @return [String, nil]
+        optional :prompt, String
+
+        # @!method initialize(id:, created_at:, name:, type:, prompt: nil, object: :"audio.voice")
+        #   A custom voice that can be used for audio output. Voices created from text
+        #   prompts are supported only in Live.
         #
         #   @param id [String]
         #     The voice identifier, which can be referenced in API endpoints.
@@ -50,6 +59,11 @@ module OpenAI
         #   @param type [Symbol, OpenAI::Models::Audio::Voice::Type]
         #     How the voice was created.
         #
+        #   @param prompt [String]
+        #     The original text prompt used to create the voice. Present for prompt-generated
+        #     voices with a stored prompt; omitted for audio-sample voices and older voices
+        #     without a stored prompt.
+        #
         #   @param object [Symbol, :"audio.voice"]
         #     The object type, which is always `audio.voice`.
 
@@ -60,6 +74,7 @@ module OpenAI
           extend OpenAI::Internal::Type::Enum
 
           AUDIO_SAMPLE = :audio_sample
+          PROMPT = :prompt
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/openai/models/audio/voice_create_params.rb

@@ -12,11 +12,11 @@ module OpenAI
         #   Creates a voice from a consent recording and an audio sample. Requires
         #   multipart/form-data.
         #
-        #   @return [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample]
+        #   @return [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt]
         required :body, union: -> { OpenAI::Audio::VoiceCreateParams::Body }
 
         # @!method initialize(body:, request_options: {})
-        #   @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample]
+        #   @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt]
         #     Creates a voice from a consent recording and an audio sample. Requires
         #     multipart/form-data.
         #
@@ -43,6 +43,9 @@ module OpenAI
           # Creates a voice from a consent recording and an audio sample. Requires multipart/form-data.
           variant :audio_sample, -> { OpenAI::Audio::VoiceCreateParams::Body::AudioSample }
 
+          # Creates a synthetic voice from a text description. Supports application/json or multipart/form-data.
+          variant :prompt, -> { OpenAI::Audio::VoiceCreateParams::Body::Prompt }
+
           class AudioSample < OpenAI::Internal::Type::BaseModel
             # @!attribute audio_sample
             #   The sample audio recording file. Maximum size is 10 MiB.
@@ -111,8 +114,102 @@ module OpenAI
             end
           end
 
+          class Prompt < OpenAI::Internal::Type::BaseModel
+            # @!attribute name
+            #   The name of the new voice.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute prompt
+            #   A description of the desired voice. Must not contain only whitespace.
+            #
+            #   @return [String]
+            required :prompt, String
+
+            # @!attribute type
+            #   Set to `prompt` to create a voice from a text description.
+            #
+            #   @return [Symbol, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::Type]
+            required :type, enum: -> { OpenAI::Audio::VoiceCreateParams::Body::Prompt::Type }
+
+            # @!attribute model
+            #   The voice creation model to use. Defaults to `auto`.
+            #
+            #   @return [String, Symbol, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::Model, nil]
+            optional :model, union: -> { OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model }
+
+            # @!attribute script_hint
+            #   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.
+            #
+            #   @return [String, nil]
+            optional :script_hint, String
+
+            # @!method initialize(name:, prompt:, type:, model: nil, script_hint: nil)
+            #   Creates a synthetic voice from a text description. Supports application/json or
+            #   multipart/form-data.
+            #
+            #   @param name [String]
+            #     The name of the new voice.
+            #
+            #   @param prompt [String]
+            #     A description of the desired voice. Must not contain only whitespace.
+            #
+            #   @param type [Symbol, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::Type]
+            #     Set to `prompt` to create a voice from a text description.
+            #
+            #   @param model [String, Symbol, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::Model]
+            #     The voice creation model to use. Defaults to `auto`.
+            #
+            #   @param script_hint [String]
+            #     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.
+
+            # Set to `prompt` to create a voice from a text description.
+            #
+            # @see OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt#type
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              PROMPT = :prompt
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # The voice creation model to use. Defaults to `auto`.
+            #
+            # @see OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt#model
+            module Model
+              extend OpenAI::Internal::Type::Union
+
+              variant String
+
+              variant const: -> { OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::Model::AUTO }
+
+              variant const: -> { OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt::Model::MODEL_2026_10_08 }
+
+              # @!method self.variants
+              #   @return [Array(String, Symbol)]
+
+              define_sorbet_constant!(:Variants) do
+                T.type_alias { T.any(String, OpenAI::Audio::VoiceCreateParams::Body::Prompt::Model::TaggedSymbol) }
+              end
+
+              # @!group
+
+              AUTO = :auto
+              MODEL_2026_10_08 = :"2026-10-08"
+
+              # @!endgroup
+            end
+          end
+
           # @!method self.variants
-          #   @return [Array(OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample)]
+          #   @return [Array(OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt)]
         end
       end
     end

data/lib/openai/models/beta/agent_create_params.rb

@@ -61,7 +61,8 @@ module OpenAI
         optional :text, -> { OpenAI::Beta::AgentTextParam }, nil?: true
 
         # @!attribute tools
-        #   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.
         #
         #   @return [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
         optional(
@@ -100,7 +101,8 @@ module OpenAI
         #     verbosity.
         #
         #   @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, 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.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/beta/agent_list_params.rb

@@ -15,10 +15,10 @@ module OpenAI
         optional :after, String
 
         # @!attribute limit
-        #   The maximum number of resources to return.
+        #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
         #
         #   @return [Integer, nil]
-        optional :limit, Integer, nil?: true
+        optional :limit, Integer
 
         # @!attribute order
         #   The order in which resources are returned. Defaults to `desc`.
@@ -30,8 +30,8 @@ module OpenAI
         #   @param after [String]
         #     Return resources after this resource ID in the selected order.
         #
-        #   @param limit [Integer, nil]
-        #     The maximum number of resources to return.
+        #   @param limit [Integer]
+        #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
         #
         #   @param order [Symbol, OpenAI::Models::Beta::AgentListParams::Order]
         #     The order in which resources are returned. Defaults to `desc`.

data/lib/openai/models/beta/agent_session.rb

@@ -80,7 +80,14 @@ module OpenAI
         #   @return [Array<String>]
         required :vault_ids, OpenAI::Internal::Type::ArrayOf[String]
 
-        # @!method initialize(id:, agent:, created_at:, environment:, error:, last_active_at:, metadata:, required_actions:, status:, usage:, vault_ids:, object: :"agent.session")
+        # @!attribute spend_control
+        #   Configured spending limit and best-effort consumption, in USD cents. Unlimited
+        #   sessions omit this object.
+        #
+        #   @return [OpenAI::Models::Beta::AgentSession::SpendControl, nil]
+        optional :spend_control, -> { OpenAI::Beta::AgentSession::SpendControl }
+
+        # @!method initialize(id:, agent:, created_at:, environment:, error:, last_active_at:, metadata:, required_actions:, status:, usage:, vault_ids:, spend_control: nil, object: :"agent.session")
         #   A Managed Agents session.
         #
         #   @param id [String]
@@ -117,6 +124,10 @@ module OpenAI
         #   @param vault_ids [Array<String>]
         #     The IDs of vaults made available to the session.
         #
+        #   @param spend_control [OpenAI::Models::Beta::AgentSession::SpendControl]
+        #     Configured spending limit and best-effort consumption, in USD cents. Unlimited
+        #     sessions omit this object.
+        #
         #   @param object [Symbol, :"agent.session"]
         #     The object type. Always `agent.session`.
 
@@ -582,6 +593,31 @@ module OpenAI
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # @see OpenAI::Models::Beta::AgentSession#spend_control
+        class SpendControl < OpenAI::Internal::Type::BaseModel
+          # @!attribute consumed
+          #   Best-effort recorded spend floored to whole USD cents, or null when unavailable.
+          #
+          #   @return [Integer, nil]
+          required :consumed, Integer, nil?: true
+
+          # @!attribute limit
+          #   The configured positive limit in USD cents.
+          #
+          #   @return [Integer]
+          required :limit, Integer
+
+          # @!method initialize(consumed:, limit:)
+          #   Configured spending limit and best-effort consumption, in USD cents. Unlimited
+          #   sessions omit this object.
+          #
+          #   @param consumed [Integer, nil]
+          #     Best-effort recorded spend floored to whole USD cents, or null when unavailable.
+          #
+          #   @param limit [Integer]
+          #     The configured positive limit in USD cents.
+        end
       end
     end
   end

data/lib/openai/models/beta/agent_update_params.rb

@@ -66,7 +66,8 @@ module OpenAI
         optional :text, -> { OpenAI::Beta::AgentTextParam }, nil?: true
 
         # @!attribute tools
-        #   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.
         #
         #   @return [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
         optional(
@@ -107,7 +108,8 @@ module OpenAI
         #     Configuration for text generated by the agent.
         #
         #   @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, 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.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/openai/models/beta/agents/environment_list_params.rb

@@ -10,19 +10,19 @@ module OpenAI
           include OpenAI::Internal::Type::RequestParameters
 
           # @!attribute after
-          #   Return environments after this environment ID in the selected order.
+          #   Return resources after this resource ID in the selected order.
           #
           #   @return [String, nil]
           optional :after, String
 
           # @!attribute limit
-          #   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.
           #
           #   @return [Integer, nil]
           optional :limit, Integer
 
           # @!attribute order
-          #   The order in which environments are returned. Defaults to `desc`.
+          #   The order in which resources are returned. Defaults to `desc`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::Agents::EnvironmentListParams::Order, nil]
           optional :order, enum: -> { OpenAI::Beta::Agents::EnvironmentListParams::Order }
@@ -35,20 +35,20 @@ module OpenAI
 
           # @!method initialize(after: nil, limit: nil, order: nil, type: nil, request_options: {})
           #   @param after [String]
-          #     Return environments after this environment ID in the selected order.
+          #     Return resources after this resource ID in the selected order.
           #
           #   @param limit [Integer]
-          #     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.
           #
           #   @param order [Symbol, OpenAI::Models::Beta::Agents::EnvironmentListParams::Order]
-          #     The order in which environments are returned. Defaults to `desc`.
+          #     The order in which resources are returned. Defaults to `desc`.
           #
           #   @param type [Symbol, OpenAI::Models::Beta::Agents::EnvironmentListParams::Type]
           #     The hosting type to list. Defaults to `openai_hosted`.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-          # 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/lib/openai/models/beta/agents/session_create_params.rb

@@ -47,13 +47,26 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+          # @!attribute spend_control
+          #   Optional spending limit in USD cents. Omission or null creates an unlimited
+          #   session.
+          #
+          #   @return [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
+          optional(
+            :spend_control,
+            -> {
+              OpenAI::Beta::Agents::SessionCreateParams::SpendControl
+            },
+            nil?: true
+          )
+
           # @!attribute vault_ids
           #   The IDs of vaults made available to the session.
           #
           #   @return [Array<String>, nil]
           optional :vault_ids, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
-          # @!method initialize(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, vault_ids: nil, request_options: {})
+          # @!method initialize(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, spend_control: nil, vault_ids: nil, request_options: {})
           #   @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
           #     An inline execution environment or a reference to an environment template.
           #
@@ -75,6 +88,10 @@ module OpenAI
           #     Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #     characters. Omission or null defaults to an empty map.
           #
+          #   @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
+          #     Optional spending limit in USD cents. Omission or null creates an unlimited
+          #     session.
+          #
           #   @param vault_ids [Array<String>, nil]
           #     The IDs of vaults made available to the session.
           #
@@ -124,7 +141,9 @@ module OpenAI
             optional :text, -> { OpenAI::Beta::AgentTextParam }, nil?: true
 
             # @!attribute tools
-            #   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.
             #
             #   @return [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch, OpenAI::Models::Beta::AgentToolParam::ComputerUse>, nil]
             optional(
@@ -160,7 +179,9 @@ module OpenAI
             #     Configuration for text generated by the agent.
             #
             #   @param tools [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch, OpenAI::Models::Beta::AgentToolParam::ComputerUse>, 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.
 
             # The service tier used for model requests.
             #
@@ -207,6 +228,21 @@ module OpenAI
               -> { OpenAI::Beta::AgentSessionInputMessageParam }
             ]
           end
+
+          class SpendControl < OpenAI::Internal::Type::BaseModel
+            # @!attribute limit
+            #   Positive USD cents, or null to remove the limit.
+            #
+            #   @return [Integer, nil]
+            required :limit, Integer, nil?: true
+
+            # @!method initialize(limit:)
+            #   Optional spending limit in USD cents. Omission or null creates an unlimited
+            #   session.
+            #
+            #   @param limit [Integer, nil]
+            #     Positive USD cents, or null to remove the limit.
+          end
         end
       end
     end

data/lib/openai/models/beta/agents/session_list_params.rb

@@ -23,14 +23,13 @@ module OpenAI
           optional :agent_id, String
 
           # @!attribute limit
-          #   The maximum number of resources to return.
+          #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
           #   @return [Integer, nil]
-          optional :limit, Integer, nil?: true
+          optional :limit, Integer
 
           # @!attribute order
-          #   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`.
           #
           #   @return [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order, nil]
           optional :order, enum: -> { OpenAI::Beta::Agents::SessionListParams::Order }
@@ -43,17 +42,15 @@ module OpenAI
           #     Only return sessions whose root agent has this ID. Omit to return sessions for
           #     all agents.
           #
-          #   @param limit [Integer, nil]
-          #     The maximum number of resources to return.
+          #   @param limit [Integer]
+          #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
           #
           #   @param order [Symbol, OpenAI::Models::Beta::Agents::SessionListParams::Order]
-          #     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`.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-          # 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/lib/openai/models/beta/agents/session_update_params.rb

@@ -28,7 +28,20 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
-          # @!method initialize(session_id:, agent: nil, metadata: nil, request_options: {})
+          # @!attribute spend_control
+          #   Omit to retain the limit; null or a null limit removes it without resetting
+          #   spend.
+          #
+          #   @return [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
+          optional(
+            :spend_control,
+            -> {
+              OpenAI::Beta::Agents::SessionUpdateParams::SpendControl
+            },
+            nil?: true
+          )
+
+          # @!method initialize(session_id:, agent: nil, metadata: nil, spend_control: nil, request_options: {})
           #   @param session_id [String]
           #
           #   @param agent [OpenAI::Models::Beta::Agents::SessionUpdateParams::Agent]
@@ -39,6 +52,10 @@ module OpenAI
           #     Up to 16 string key-value pairs, with keys up to 64 and values up to 512
           #     characters.
           #
+          #   @param spend_control [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
+          #     Omit to retain the limit; null or a null limit removes it without resetting
+          #     spend.
+          #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
           class Agent < OpenAI::Internal::Type::BaseModel
@@ -138,6 +155,21 @@ module OpenAI
               #   @return [Array<Symbol>]
             end
           end
+
+          class SpendControl < OpenAI::Internal::Type::BaseModel
+            # @!attribute limit
+            #   Positive USD cents, or null to remove the limit.
+            #
+            #   @return [Integer, nil]
+            required :limit, Integer, nil?: true
+
+            # @!method initialize(limit:)
+            #   Omit to retain the limit; null or a null limit removes it without resetting
+            #   spend.
+            #
+            #   @param limit [Integer, nil]
+            #     Positive USD cents, or null to remove the limit.
+          end
         end
       end
     end

data/lib/openai/models/beta/agents/sessions/artifact_list_params.rb

@@ -16,10 +16,10 @@ module OpenAI
             required :session_id, String
 
             # @!attribute after
-            #   Return artifacts after this immutable artifact ID.
+            #   Return resources after this resource ID in the selected order.
             #
             #   @return [String, nil]
-            optional :after, String, nil?: true
+            optional :after, String
 
             # @!attribute environment_id
             #   Restrict the listing to artifacts produced by this environment.
@@ -28,13 +28,13 @@ module OpenAI
             optional :environment_id, String, nil?: true
 
             # @!attribute limit
-            #   The maximum number of artifacts to return, between 1 and 100.
+            #   The maximum number of resources to return, between 1 and 100. Defaults to 20.
             #
             #   @return [Integer, nil]
-            optional :limit, Integer, nil?: true
+            optional :limit, Integer
 
             # @!attribute order
-            #   Sort by creation time and ID. Defaults to descending.
+            #   The order in which resources are returned. Defaults to `desc`.
             #
             #   @return [Symbol, OpenAI::Models::Beta::Agents::Sessions::ArtifactListParams::Order, nil]
             optional :order, enum: -> { OpenAI::Beta::Agents::Sessions::ArtifactListParams::Order }
@@ -42,21 +42,21 @@ module OpenAI
             # @!method initialize(session_id:, after: nil, environment_id: nil, limit: nil, order: nil, request_options: {})
             #   @param session_id [String]
             #
-            #   @param after [String, nil]
-            #     Return artifacts after this immutable artifact ID.
+            #   @param after [String]
+            #     Return resources after this resource ID in the selected order.
             #
             #   @param environment_id [String, nil]
             #     Restrict the listing to artifacts produced by this environment.
             #
-            #   @param limit [Integer, nil]
-            #     The maximum number of artifacts to return, between 1 and 100.
+            #   @param limit [Integer]
+            #     The maximum number of resources to return, between 1 and 100. Defaults to 20.
             #
             #   @param order [Symbol, OpenAI::Models::Beta::Agents::Sessions::ArtifactListParams::Order]
-            #     Sort by creation time and ID. Defaults to descending.
+            #     The order in which resources are returned. Defaults to `desc`.
             #
             #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
-            # Sort by creation time and ID. Defaults to descending.
+            # The order in which resources are returned. Defaults to `desc`.
             module Order
               extend OpenAI::Internal::Type::Enum