openai 0.101.1 → 0.102.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76f7d390fded7c11700ad3bd5449bce21cac262612deaedc06c5c2df965fa5e2
-  data.tar.gz: e29844fdeeb065f5ccce08487880a1ff5b1b89fe08c5a29fe2b5c9ab2cba6ddf
+  metadata.gz: e214fa257d53a7b24aa14ad9d7bbabb907c47e3b50b2fbf769177dac7bfe04b8
+  data.tar.gz: 4356c890b1060157f4d252b411eb234f6987782cea1ab79a4eba9d8d00028a87
 SHA512:
-  metadata.gz: b5c9ea9bfb85686d4ff3d061e88dd5bbb80bcfdb4789d87d93e5e21fe3dd0b429aa9cb3cc7ca537f8b9f93f9580ba2c9147105269c767ff37a3166605db23c33
-  data.tar.gz: 86de051adcf41d15877a3c20cf4c8592f01b44ae4ab95a318dce426493a76cfa9fc13ca5f2b74c02fbf051b3c36781e09f65f60f9b02de41d7e5af9e22cd779b
+  metadata.gz: 1b6c400866161baef0e067c3ebd597b483249954373a32e193e58b8383638d52a977d10270f8e0d876b8838109ec3d086049548d20e77aa9d2d6adbd21a778ea
+  data.tar.gz: dfa20d336ce432cd06d9a65e4ef94575581783885fed890600f35dc32a54b69af9cc2ef63b3d474d561edc88fcc9f944423832e5aa55812f550395a8622bb35e

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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)
 
 

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.1"
+gem "openai", "~> 0.102.0"
 ```
 
 <!-- x-release-please-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.

data/lib/openai/models/webhooks/agent_environment_failed_webhook_event.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Webhooks
+      class AgentEnvironmentFailedWebhookEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique ID of the event.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute created_at
+        #   The Unix timestamp, in seconds, when the event was created.
+        #
+        #   @return [Integer]
+        required :created_at, Integer
+
+        # @!attribute data
+        #   Identifies the environment whose lifecycle changed.
+        #
+        #   @return [OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent::Data]
+        required :data, -> { OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent::Data }
+
+        # @!attribute object
+        #   The object type. Always `event`.
+        #
+        #   @return [Symbol, :event]
+        required :object, const: :event
+
+        # @!attribute type
+        #   The event type. Always `agent.environment.failed`.
+        #
+        #   @return [Symbol, :"agent.environment.failed"]
+        required :type, const: :"agent.environment.failed"
+
+        # @!method initialize(id:, created_at:, data:, object: :event, type: :"agent.environment.failed")
+        #   Sent when setup fails for a prewarmed OpenAI-hosted environment before it is
+        #   attached to a session.
+        #
+        #   @param id [String]
+        #     The unique ID of the event.
+        #
+        #   @param created_at [Integer]
+        #     The Unix timestamp, in seconds, when the event was created.
+        #
+        #   @param data [OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent::Data]
+        #     Identifies the environment whose lifecycle changed.
+        #
+        #   @param object [Symbol, :event]
+        #     The object type. Always `event`.
+        #
+        #   @param type [Symbol, :"agent.environment.failed"]
+        #     The event type. Always `agent.environment.failed`.
+
+        # @see OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent#data
+        class Data < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the environment.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   Identifies the environment whose lifecycle changed.
+          #
+          #   @param id [String]
+          #     The ID of the environment.
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/webhooks/agent_environment_ready_webhook_event.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Webhooks
+      class AgentEnvironmentReadyWebhookEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique ID of the event.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute created_at
+        #   The Unix timestamp, in seconds, when the event was created.
+        #
+        #   @return [Integer]
+        required :created_at, Integer
+
+        # @!attribute data
+        #   Identifies the environment whose lifecycle changed.
+        #
+        #   @return [OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent::Data]
+        required :data, -> { OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent::Data }
+
+        # @!attribute object
+        #   The object type. Always `event`.
+        #
+        #   @return [Symbol, :event]
+        required :object, const: :event
+
+        # @!attribute type
+        #   The event type. Always `agent.environment.ready`.
+        #
+        #   @return [Symbol, :"agent.environment.ready"]
+        required :type, const: :"agent.environment.ready"
+
+        # @!method initialize(id:, created_at:, data:, object: :event, type: :"agent.environment.ready")
+        #   Sent when a prewarmed OpenAI-hosted environment finishes setup before being
+        #   attached to a session.
+        #
+        #   @param id [String]
+        #     The unique ID of the event.
+        #
+        #   @param created_at [Integer]
+        #     The Unix timestamp, in seconds, when the event was created.
+        #
+        #   @param data [OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent::Data]
+        #     Identifies the environment whose lifecycle changed.
+        #
+        #   @param object [Symbol, :event]
+        #     The object type. Always `event`.
+        #
+        #   @param type [Symbol, :"agent.environment.ready"]
+        #     The event type. Always `agent.environment.ready`.
+
+        # @see OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent#data
+        class Data < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the environment.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!method initialize(id:)
+          #   Identifies the environment whose lifecycle changed.
+          #
+          #   @param id [String]
+          #     The ID of the environment.
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/webhooks/unwrap_webhook_event.rb

@@ -3,13 +3,19 @@
 module OpenAI
   module Models
     module Webhooks
-      # Sent when an agent session requires an action. Retrieve the session for action
-      # details.
+      # Sent when setup fails for a prewarmed OpenAI-hosted environment before it is
+      # attached to a session.
       module UnwrapWebhookEvent
         extend OpenAI::Internal::Type::Union
 
         discriminator :type
 
+        # Sent when setup fails for a prewarmed OpenAI-hosted environment before it is attached to a session.
+        variant :"agent.environment.failed", -> { OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent }
+
+        # Sent when a prewarmed OpenAI-hosted environment finishes setup before being attached to a session.
+        variant :"agent.environment.ready", -> { OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent }
+
         # Sent when an agent session requires an action. Retrieve the session for action details.
         variant :"agent.session.action_required", -> { OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent }
 
@@ -97,7 +103,7 @@ module OpenAI
         variant :"safety.warning_issued", -> { OpenAI::Webhooks::SafetyWarningIssuedWebhookEvent }
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent, OpenAI::Models::Webhooks::AgentSessionCreatedWebhookEvent, OpenAI::Models::Webhooks::AgentSessionFailedWebhookEvent, OpenAI::Models::Webhooks::AgentSessionIdleWebhookEvent, OpenAI::Models::Webhooks::AgentSessionInProgressWebhookEvent, OpenAI::Models::Webhooks::BatchCancelledWebhookEvent, OpenAI::Models::Webhooks::BatchCompletedWebhookEvent, OpenAI::Models::Webhooks::BatchExpiredWebhookEvent, OpenAI::Models::Webhooks::BatchFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunCanceledWebhookEvent, OpenAI::Models::Webhooks::EvalRunFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunSucceededWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobCancelledWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobFailedWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobSucceededWebhookEvent, OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent, OpenAI::Models::Webhooks::LiveTransportIncomingWebhookEvent, OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent, OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent, OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent, OpenAI::Models::Webhooks::ResponseFailedWebhookEvent, OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent, OpenAI::Models::Webhooks::SafetyAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyDeactivationIssuedWebhookEvent, OpenAI::Models::Webhooks::SafetyOrgAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyWarningIssuedWebhookEvent)]
+        #   @return [Array(OpenAI::Models::Webhooks::AgentEnvironmentFailedWebhookEvent, OpenAI::Models::Webhooks::AgentEnvironmentReadyWebhookEvent, OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent, OpenAI::Models::Webhooks::AgentSessionCreatedWebhookEvent, OpenAI::Models::Webhooks::AgentSessionFailedWebhookEvent, OpenAI::Models::Webhooks::AgentSessionIdleWebhookEvent, OpenAI::Models::Webhooks::AgentSessionInProgressWebhookEvent, OpenAI::Models::Webhooks::BatchCancelledWebhookEvent, OpenAI::Models::Webhooks::BatchCompletedWebhookEvent, OpenAI::Models::Webhooks::BatchExpiredWebhookEvent, OpenAI::Models::Webhooks::BatchFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunCanceledWebhookEvent, OpenAI::Models::Webhooks::EvalRunFailedWebhookEvent, OpenAI::Models::Webhooks::EvalRunSucceededWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobCancelledWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobFailedWebhookEvent, OpenAI::Models::Webhooks::FineTuningJobSucceededWebhookEvent, OpenAI::Models::Webhooks::LiveCallIncomingWebhookEvent, OpenAI::Models::Webhooks::LiveTransportIncomingWebhookEvent, OpenAI::Models::Webhooks::RealtimeCallIncomingWebhookEvent, OpenAI::Models::Webhooks::ResponseCancelledWebhookEvent, OpenAI::Models::Webhooks::ResponseCompletedWebhookEvent, OpenAI::Models::Webhooks::ResponseFailedWebhookEvent, OpenAI::Models::Webhooks::ResponseIncompleteWebhookEvent, OpenAI::Models::Webhooks::SafetyAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyDeactivationIssuedWebhookEvent, OpenAI::Models::Webhooks::SafetyOrgAlertCreatedWebhookEvent, OpenAI::Models::Webhooks::SafetyWarningIssuedWebhookEvent)]
       end
     end
   end

data/lib/openai/models/webhooks/webhook_create_params.rb

@@ -62,6 +62,8 @@ module OpenAI
           REALTIME_CALL_INCOMING = :"realtime.call.incoming"
           VIDEO_COMPLETED = :"video.completed"
           VIDEO_FAILED = :"video.failed"
+          AGENT_ENVIRONMENT_READY = :"agent.environment.ready"
+          AGENT_ENVIRONMENT_FAILED = :"agent.environment.failed"
           AGENT_SESSION_CREATED = :"agent.session.created"
           AGENT_SESSION_ACTION_REQUIRED = :"agent.session.action_required"
           AGENT_SESSION_IN_PROGRESS = :"agent.session.in_progress"

data/lib/openai/models/webhooks/webhook_test_params.rb

@@ -48,6 +48,8 @@ module OpenAI
           REALTIME_CALL_INCOMING = :"realtime.call.incoming"
           VIDEO_COMPLETED = :"video.completed"
           VIDEO_FAILED = :"video.failed"
+          AGENT_ENVIRONMENT_READY = :"agent.environment.ready"
+          AGENT_ENVIRONMENT_FAILED = :"agent.environment.failed"
           AGENT_SESSION_CREATED = :"agent.session.created"
           AGENT_SESSION_ACTION_REQUIRED = :"agent.session.action_required"
           AGENT_SESSION_IN_PROGRESS = :"agent.session.in_progress"