openai 0.101.0 → 0.102.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c9c92914efc09920f412b87f40bd0401a68b41f69fa4ffcaee090cf8ee93959
-  data.tar.gz: af39812b8849fa3bdb1f0f04dd5da8368c45b244ec24c52cfe901e5e22445690
+  metadata.gz: e214fa257d53a7b24aa14ad9d7bbabb907c47e3b50b2fbf769177dac7bfe04b8
+  data.tar.gz: 4356c890b1060157f4d252b411eb234f6987782cea1ab79a4eba9d8d00028a87
 SHA512:
-  metadata.gz: 49f421e6b6fca640e3abbee1028b7df1935c9cc7c79ddecebc6fb50b01e920ca5fc0cbed0b652cc065730b5e6696f0de18367d51e0f4fa0ceec8caee92ccdcf5
-  data.tar.gz: ae6558f4994712ecb02afe85d5961c26657bc48001ad4c8dde460f408b256434cf741a71f60bb17432e3c35d2dca4180d81a8b77ceafdc6831a8117ff7971116
+  metadata.gz: 1b6c400866161baef0e067c3ebd597b483249954373a32e193e58b8383638d52a977d10270f8e0d876b8838109ec3d086049548d20e77aa9d2d6adbd21a778ea
+  data.tar.gz: dfa20d336ce432cd06d9a65e4ef94575581783885fed890600f35dc32a54b69af9cc2ef63b3d474d561edc88fcc9f944423832e5aa55812f550395a8622bb35e

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.102.0](https://github.com/openai/openai-ruby/compare/v0.101.1...v0.102.0) (2026-10-09)
+
+
+### Features
+
+* **api:** add prewarmed hosted environments ([#818](https://github.com/openai/openai-ruby/issues/818)) ([a9e8015](https://github.com/openai/openai-ruby/commit/a9e80153b030395eca41bf4c6cce0b1e7fcea4dd))
+
+## [0.101.1](https://github.com/openai/openai-ruby/compare/v0.101.0...v0.101.1) (2026-10-08)
+
+
+### Bug Fixes
+
+* **api:** correct custom voice creation parameters ([#814](https://github.com/openai/openai-ruby/issues/814)) ([8e6daec](https://github.com/openai/openai-ruby/commit/8e6daecffadccb2f2cd5f442daa63cf4e2b73340))
+
 ## [0.101.0](https://github.com/openai/openai-ruby/compare/v0.100.0...v0.101.0) (2026-10-06)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.101.0"
+gem "openai", "~> 0.102.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -29,8 +29,7 @@ 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. Voices created from text
-        #   prompts are supported only in Live.
+        #   Custom voices must be created from audio samples.
         #
         #   @return [String, Symbol, OpenAI::Models::Audio::SpeechCreateParams::Voice::ID, OpenAI::Models::Audio::SpeechCreateParams::Voice]
         required :voice, union: -> { OpenAI::Audio::SpeechCreateParams::Voice }
@@ -79,8 +78,7 @@ 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. Voices created from text
-        #     prompts are supported only in Live.
+        #     Custom voices must be created from audio samples.
         #
         #   @param instructions [String]
         #     Control the voice of your generated audio with additional instructions. Does not
@@ -121,8 +119,7 @@ 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. Voices created from text
-        # prompts are supported only in Live.
+        # Custom voices must be created from audio samples.
         module Voice
           extend OpenAI::Internal::Type::Union
 

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

@@ -30,15 +30,13 @@ module OpenAI
         required :object, const: :"audio.voice"
 
         # @!attribute type
-        #   How the voice was created. Voices created from text prompts are supported only
-        #   in Live.
+        #   How the voice was created.
         #
         #   @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. Voices created from text
-        #   prompts are supported only in Live.
+        #   A custom voice that can be used for audio output.
         #
         #   @param id [String]
         #     The voice identifier, which can be referenced in API endpoints.
@@ -50,21 +48,18 @@ module OpenAI
         #     The name of the voice.
         #
         #   @param type [Symbol, OpenAI::Models::Audio::Voice::Type]
-        #     How the voice was created. Voices created from text prompts are supported only
-        #     in Live.
+        #     How the voice was created.
         #
         #   @param object [Symbol, :"audio.voice"]
         #     The object type, which is always `audio.voice`.
 
-        # How the voice was created. Voices created from text prompts are supported only
-        # in Live.
+        # How the voice was created.
         #
         # @see OpenAI::Models::Audio::Voice#type
         module Type
           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, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt]
+        #   @return [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample]
         required :body, union: -> { OpenAI::Audio::VoiceCreateParams::Body }
 
         # @!method initialize(body:, request_options: {})
-        #   @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt]
+        #   @param body [OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample]
         #     Creates a voice from a consent recording and an audio sample. Requires
         #     multipart/form-data.
         #
@@ -43,9 +43,6 @@ 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.
@@ -114,102 +111,8 @@ 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_01 }
-
-              # @!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_01 = :"2026-10-01"
-
-              # @!endgroup
-            end
-          end
-
           # @!method self.variants
-          #   @return [Array(OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample, OpenAI::Models::Audio::VoiceCreateParams::Body::Prompt)]
+          #   @return [Array(OpenAI::Models::Audio::VoiceCreateParams::Body::AudioSample)]
         end
       end
     end

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

@@ -0,0 +1,300 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Environments#create
+        class EnvironmentCreateParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute environment
+          #   The required hosting type and its configuration.
+          #
+          #   @return [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment]
+          required :environment, -> { OpenAI::Beta::Agents::EnvironmentCreateParams::Environment }
+
+          # @!attribute vault_ids
+          #   The IDs of up to 10 vaults made available to an OpenAI-hosted environment.
+          #
+          #   @return [Array<String>, nil]
+          optional :vault_ids, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+          # @!attribute idempotency_key
+          #
+          #   @return [String, nil]
+          optional :idempotency_key, String
+
+          # @!method initialize(environment:, vault_ids: nil, idempotency_key: nil, request_options: {})
+          #   @param environment [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment]
+          #     The required hosting type and its configuration.
+          #
+          #   @param vault_ids [Array<String>, nil]
+          #     The IDs of up to 10 vaults made available to an OpenAI-hosted environment.
+          #
+          #   @param idempotency_key [String]
+          #
+          #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+          class Environment < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #   The type of the object. Always `openai_hosted`.
+            #
+            #   @return [Symbol, :openai_hosted]
+            required :type, const: :openai_hosted
+
+            # @!attribute capability_directories
+            #   Directories that contain capabilities exposed to the agent. Defaults to an empty
+            #   list.
+            #
+            #   @return [Array<String>, nil]
+            optional :capability_directories, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!attribute desktop
+            #   Desktop provisioning. Omission or null inherits the template setting, or
+            #   defaults to disabled.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Desktop, nil]
+            optional(
+              :desktop,
+              -> {
+                OpenAI::Beta::Agents::EnvironmentCreateParams::Environment::Desktop
+              },
+              nil?: true
+            )
+
+            # @!attribute env
+            #   Environment variables made available to the agent.
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :env, OpenAI::Internal::Type::HashOf[String], nil?: true
+
+            # @!attribute environment_template_id
+            #   A reusable hosted template applied before inline configuration. Omitted fields
+            #   inherit the template; network overrides cannot broaden its policy.
+            #
+            #   @return [String, nil]
+            optional :environment_template_id, String
+
+            # @!attribute files
+            #   Files available before the agent starts. Defaults to an empty list.
+            #
+            #   @return [Array<OpenAI::Models::Beta::HostedEnvironmentFileParam::FileID, OpenAI::Models::Beta::HostedEnvironmentFileParam::Inline>, nil]
+            optional(
+              :files,
+              -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::HostedEnvironmentFileParam] },
+              nil?: true
+            )
+
+            # @!attribute network
+            #   Network access policy for the environment. If omitted, the API version
+            #   determines whether network access is enabled or disabled.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Network, nil]
+            optional(
+              :network,
+              -> {
+                OpenAI::Beta::Agents::EnvironmentCreateParams::Environment::Network
+              },
+              nil?: true
+            )
+
+            # @!attribute packages
+            #   Packages to install in the environment. Defaults to empty package lists.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Packages, nil]
+            optional(
+              :packages,
+              -> { OpenAI::Beta::Agents::EnvironmentCreateParams::Environment::Packages },
+              nil?: true
+            )
+
+            # @!attribute plugins
+            #   Plugins provided as inline ZIP archives. Defaults to an empty list.
+            #
+            #   @return [Array<OpenAI::Models::Beta::HostedPluginParam>, nil]
+            optional(
+              :plugins,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::HostedPluginParam]
+              },
+              nil?: true
+            )
+
+            # @!attribute setup_commands
+            #   Ordered, confidential setup commands. Command bodies are never returned.
+            #
+            #   @return [Array<OpenAI::Models::Beta::SetupCommandParam>, nil]
+            optional(
+              :setup_commands,
+              -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::SetupCommandParam] },
+              nil?: true
+            )
+
+            # @!attribute skills
+            #   Skills referenced by ID or provided as inline ZIP archives. Defaults to an empty
+            #   list.
+            #
+            #   @return [Array<OpenAI::Models::Beta::HostedSkillParam::SkillReference, OpenAI::Models::Beta::HostedSkillParam::Inline>, nil]
+            optional(
+              :skills,
+              -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::HostedSkillParam] },
+              nil?: true
+            )
+
+            # @!method initialize(capability_directories: nil, desktop: nil, env: nil, environment_template_id: nil, files: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, type: :openai_hosted)
+            #   The required hosting type and its configuration.
+            #
+            #   @param capability_directories [Array<String>, nil]
+            #     Directories that contain capabilities exposed to the agent. Defaults to an empty
+            #     list.
+            #
+            #   @param desktop [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Desktop, nil]
+            #     Desktop provisioning. Omission or null inherits the template setting, or
+            #     defaults to disabled.
+            #
+            #   @param env [Hash{Symbol=>String}, nil]
+            #     Environment variables made available to the agent.
+            #
+            #   @param environment_template_id [String]
+            #     A reusable hosted template applied before inline configuration. Omitted fields
+            #     inherit the template; network overrides cannot broaden its policy.
+            #
+            #   @param files [Array<OpenAI::Models::Beta::HostedEnvironmentFileParam::FileID, OpenAI::Models::Beta::HostedEnvironmentFileParam::Inline>, nil]
+            #     Files available before the agent starts. Defaults to an empty list.
+            #
+            #   @param network [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Network, nil]
+            #     Network access policy for the environment. If omitted, the API version
+            #     determines whether network access is enabled or disabled.
+            #
+            #   @param packages [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Packages, nil]
+            #     Packages to install in the environment. Defaults to empty package lists.
+            #
+            #   @param plugins [Array<OpenAI::Models::Beta::HostedPluginParam>, nil]
+            #     Plugins provided as inline ZIP archives. Defaults to an empty list.
+            #
+            #   @param setup_commands [Array<OpenAI::Models::Beta::SetupCommandParam>, nil]
+            #     Ordered, confidential setup commands. Command bodies are never returned.
+            #
+            #   @param skills [Array<OpenAI::Models::Beta::HostedSkillParam::SkillReference, OpenAI::Models::Beta::HostedSkillParam::Inline>, nil]
+            #     Skills referenced by ID or provided as inline ZIP archives. Defaults to an empty
+            #     list.
+            #
+            #   @param type [Symbol, :openai_hosted]
+            #     The type of the object. Always `openai_hosted`.
+
+            # @see OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment#desktop
+            class Desktop < OpenAI::Internal::Type::BaseModel
+              # @!attribute enabled
+              #   Whether to provision the desktop and its browser proxy.
+              #
+              #   @return [Boolean]
+              required :enabled, OpenAI::Internal::Type::Boolean
+
+              # @!method initialize(enabled:)
+              #   Desktop provisioning. Omission or null inherits the template setting, or
+              #   defaults to disabled.
+              #
+              #   @param enabled [Boolean]
+              #     Whether to provision the desktop and its browser proxy.
+            end
+
+            # @see OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment#network
+            class Network < OpenAI::Internal::Type::BaseModel
+              # @!attribute access
+              #   The environment's network access mode.
+              #
+              #   @return [Symbol, OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Network::Access]
+              required(
+                :access,
+                enum: -> { OpenAI::Beta::Agents::EnvironmentCreateParams::Environment::Network::Access }
+              )
+
+              # @!attribute allowed_domains
+              #   Domains the environment may access when network access is restricted.
+              #
+              #   @return [Array<String>, nil]
+              optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+              # @!attribute blocked_domains
+              #   Domains blocked for both executor and browser when access is restricted. A
+              #   nonempty list requires `access: restricted` and cannot be combined with nonempty
+              #   `allowed_domains`. Wildcard domains are not supported.
+              #
+              #   @return [Array<String>, nil]
+              optional :blocked_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+              # @!method initialize(access:, allowed_domains: nil, blocked_domains: nil)
+              #   Network access policy for the environment. If omitted, the API version
+              #   determines whether network access is enabled or disabled.
+              #
+              #   @param access [Symbol, OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Network::Access]
+              #     The environment's network access mode.
+              #
+              #   @param allowed_domains [Array<String>, nil]
+              #     Domains the environment may access when network access is restricted.
+              #
+              #   @param blocked_domains [Array<String>, nil]
+              #     Domains blocked for both executor and browser when access is restricted. A
+              #     nonempty list requires `access: restricted` and cannot be combined with nonempty
+              #     `allowed_domains`. Wildcard domains are not supported.
+
+              # The environment's network access mode.
+              #
+              # @see OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment::Network#access
+              module Access
+                extend OpenAI::Internal::Type::Enum
+
+                # Allows unrestricted network access.
+                ENABLED = :enabled
+
+                # Disables network access.
+                DISABLED = :disabled
+
+                # Applies the configured domain restrictions.
+                RESTRICTED = :restricted
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
+            # @see OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment#packages
+            class Packages < OpenAI::Internal::Type::BaseModel
+              # @!attribute npm
+              #   npm packages to install globally. Defaults to an empty list.
+              #
+              #   @return [Array<String>, nil]
+              optional :npm, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+              # @!attribute python
+              #   Python packages to install. Defaults to an empty list.
+              #
+              #   @return [Array<String>, nil]
+              optional :python, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+              # @!attribute system_
+              #   System packages to install. Defaults to an empty list.
+              #
+              #   @return [Array<String>, nil]
+              optional :system_, OpenAI::Internal::Type::ArrayOf[String], api_name: :system, nil?: true
+
+              # @!method initialize(npm: nil, python: nil, system_: nil)
+              #   Packages to install in the environment. Defaults to empty package lists.
+              #
+              #   @param npm [Array<String>, nil]
+              #     npm packages to install globally. Defaults to an empty list.
+              #
+              #   @param python [Array<String>, nil]
+              #     Python packages to install. Defaults to an empty list.
+              #
+              #   @param system_ [Array<String>, nil]
+              #     System packages to install. Defaults to an empty list.
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -4,7 +4,7 @@ module OpenAI
   module Models
     module Beta
       module Agents
-        # @see OpenAI::Resources::Beta::Agents::Environments#retrieve
+        # @see OpenAI::Resources::Beta::Agents::Environments#create
         class EnvironmentInfo < OpenAI::Internal::Type::BaseModel
           # @!attribute id
           #   The ID of the environment.
@@ -79,6 +79,9 @@ module OpenAI
             extend OpenAI::Internal::Type::Enum
 
             PENDING = :pending
+            # Provisioning succeeded and the environment is available for attachment or use.
+            READY = :ready
+
             CONNECTED = :connected
             DISCONNECTED = :disconnected
             EXPIRED = :expired

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

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      module Agents
+        # @see OpenAI::Resources::Beta::Agents::Environments#list
+        class EnvironmentListParams < OpenAI::Internal::Type::BaseModel
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @!attribute after
+          #   Return environments after this environment 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.
+          #
+          #   @return [Integer, nil]
+          optional :limit, Integer
+
+          # @!attribute order
+          #   The order in which environments are returned. Defaults to `desc`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::Agents::EnvironmentListParams::Order, nil]
+          optional :order, enum: -> { OpenAI::Beta::Agents::EnvironmentListParams::Order }
+
+          # @!attribute type
+          #   The hosting type to list. Defaults to `openai_hosted`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::Agents::EnvironmentListParams::Type, nil]
+          optional :type, enum: -> { OpenAI::Beta::Agents::EnvironmentListParams::Type }
+
+          # @!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.
+          #
+          #   @param limit [Integer]
+          #     The maximum number of environments 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`.
+          #
+          #   @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`.
+          module Order
+            extend OpenAI::Internal::Type::Enum
+
+            # Returns resources in ascending order.
+            ASC = :asc
+
+            # Returns resources in descending order.
+            DESC = :desc
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The hosting type to list. Defaults to `openai_hosted`.
+          module Type
+            extend OpenAI::Internal::Type::Enum
+
+            OPENAI_HOSTED = :openai_hosted
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -65,6 +65,13 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :env, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+          # @!attribute environment_id
+          #   An existing prewarmed environment. Cannot be combined with a template or inline
+          #   configuration.
+          #
+          #   @return [String, nil]
+          optional :environment_id, String
+
           # @!attribute environment_template_id
           #   A reusable hosted template applied before inline session configuration. Omitted
           #   fields inherit the template; network overrides cannot broaden its policy.
@@ -128,7 +135,7 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(capability_directories: nil, container_size: nil, desktop: nil, env: nil, environment_template_id: nil, files: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, type: :openai_hosted)
+          # @!method initialize(capability_directories: nil, container_size: nil, desktop: nil, env: nil, environment_id: nil, environment_template_id: nil, files: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, type: :openai_hosted)
           #   An existing OpenAI-hosted environment or new inline/template-based hosted
           #   configuration.
           #
@@ -146,6 +153,10 @@ module OpenAI
           #   @param env [Hash{Symbol=>String}, nil]
           #     Environment variables made available to the agent.
           #
+          #   @param environment_id [String]
+          #     An existing prewarmed environment. Cannot be combined with a template or inline
+          #     configuration.
+          #
           #   @param environment_template_id [String]
           #     A reusable hosted template applied before inline session configuration. Omitted
           #     fields inherit the template; network overrides cannot broaden its policy.