openai 0.101.1 → 0.103.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76f7d390fded7c11700ad3bd5449bce21cac262612deaedc06c5c2df965fa5e2
-  data.tar.gz: e29844fdeeb065f5ccce08487880a1ff5b1b89fe08c5a29fe2b5c9ab2cba6ddf
+  metadata.gz: 1b50a0bb1c17d033d4179a483168878412ecc245f68bd4192692600581db9bc0
+  data.tar.gz: 13eff5cdbaa168cb9837a9a04fc5b39a8cf8d19374d65a4f67be7028bb369d0f
 SHA512:
-  metadata.gz: b5c9ea9bfb85686d4ff3d061e88dd5bbb80bcfdb4789d87d93e5e21fe3dd0b429aa9cb3cc7ca537f8b9f93f9580ba2c9147105269c767ff37a3166605db23c33
-  data.tar.gz: 86de051adcf41d15877a3c20cf4c8592f01b44ae4ab95a318dce426493a76cfa9fc13ca5f2b74c02fbf051b3c36781e09f65f60f9b02de41d7e5af9e22cd779b
+  metadata.gz: 63338541f098246944ee6a1e761d0c47ad8434eb722302059205ce4c75a92cb8ab92916d7d3d2156f6882a55ebeb79d051fd51ec25c9db8c6f515bf556d1151d
+  data.tar.gz: a8b900d61a286c864507f0a3ab0195a9df0886b825d10cb4beaa7d9125e918176a1f08f3dba71bcfd7d700df87f4a54c2ad62a0ff26232276dbb6e41d1a4d740

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.103.0](https://github.com/openai/openai-ruby/compare/v0.102.0...v0.103.0) (2026-10-09)
+
+
+### Features
+
+* **api:** add agent environment suspension and expiration ([#821](https://github.com/openai/openai-ruby/issues/821)) ([7405e40](https://github.com/openai/openai-ruby/commit/7405e4011978083f3c8599dc4e3a40a5ca6ecc5d))
+
+## [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.103.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentSessionEnvironmentExpiredEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute environment
+        #   The current environment state.
+        #
+        #   @return [OpenAI::Models::Beta::AgentSessionEnvironmentState]
+        required :environment, -> { OpenAI::Beta::AgentSessionEnvironmentState }
+
+        # @!attribute event_id
+        #   The unique ID of the event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute session_id
+        #   The ID of the session associated with the event.
+        #
+        #   @return [String]
+        required :session_id, String
+
+        # @!attribute turn_id
+        #   The ID of the turn associated with the event, when applicable.
+        #
+        #   @return [String, nil]
+        required :turn_id, String, nil?: true
+
+        # @!attribute type
+        #   The type of the object. Always `agent.session.environment.expired`.
+        #
+        #   @return [Symbol, :"agent.session.environment.expired"]
+        required :type, const: :"agent.session.environment.expired"
+
+        # @!method initialize(environment:, event_id:, session_id:, turn_id:, type: :"agent.session.environment.expired")
+        #   Emitted after a suspended hosted session environment and its checkpoint expire.
+        #
+        #   @param environment [OpenAI::Models::Beta::AgentSessionEnvironmentState]
+        #     The current environment state.
+        #
+        #   @param event_id [String]
+        #     The unique ID of the event.
+        #
+        #   @param session_id [String]
+        #     The ID of the session associated with the event.
+        #
+        #   @param turn_id [String, nil]
+        #     The ID of the turn associated with the event, when applicable.
+        #
+        #   @param type [Symbol, :"agent.session.environment.expired"]
+        #     The type of the object. Always `agent.session.environment.expired`.
+      end
+    end
+  end
+end

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

@@ -94,6 +94,12 @@ module OpenAI
           # The environment is disconnected.
           DISCONNECTED = :disconnected
 
+          # The environment is stopped and can be resumed from its private checkpoint.
+          SUSPENDED = :suspended
+
+          # The environment and its private checkpoint have expired.
+          EXPIRED = :expired
+
           # The environment failed to connect.
           FAILED = :failed
 

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      class AgentSessionEnvironmentSuspendedEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute environment
+        #   The current environment state.
+        #
+        #   @return [OpenAI::Models::Beta::AgentSessionEnvironmentState]
+        required :environment, -> { OpenAI::Beta::AgentSessionEnvironmentState }
+
+        # @!attribute event_id
+        #   The unique ID of the event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute session_id
+        #   The ID of the session associated with the event.
+        #
+        #   @return [String]
+        required :session_id, String
+
+        # @!attribute turn_id
+        #   The ID of the turn associated with the event, when applicable.
+        #
+        #   @return [String, nil]
+        required :turn_id, String, nil?: true
+
+        # @!attribute type
+        #   The type of the object. Always `agent.session.environment.suspended`.
+        #
+        #   @return [Symbol, :"agent.session.environment.suspended"]
+        required :type, const: :"agent.session.environment.suspended"
+
+        # @!method initialize(environment:, event_id:, session_id:, turn_id:, type: :"agent.session.environment.suspended")
+        #   Emitted after an idle hosted session environment is checkpointed and stopped.
+        #
+        #   @param environment [OpenAI::Models::Beta::AgentSessionEnvironmentState]
+        #     The current environment state.
+        #
+        #   @param event_id [String]
+        #     The unique ID of the event.
+        #
+        #   @param session_id [String]
+        #     The ID of the session associated with the event.
+        #
+        #   @param turn_id [String, nil]
+        #     The ID of the turn associated with the event, when applicable.
+        #
+        #   @param type [Symbol, :"agent.session.environment.suspended"]
+        #     The type of the object. Always `agent.session.environment.suspended`.
+      end
+    end
+  end
+end

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

@@ -15,6 +15,12 @@ module OpenAI
         # Emitted when a hosted session environment is ready to connect.
         variant :"agent.session.environment.ready", -> { OpenAI::Beta::AgentSessionEnvironmentReadyEvent }
 
+        # Emitted after an idle hosted session environment is checkpointed and stopped.
+        variant :"agent.session.environment.suspended", -> { OpenAI::Beta::AgentSessionEnvironmentSuspendedEvent }
+
+        # Emitted after a suspended hosted session environment and its checkpoint expire.
+        variant :"agent.session.environment.expired", -> { OpenAI::Beta::AgentSessionEnvironmentExpiredEvent }
+
         # Emitted after a hosted sandbox is replaced. Conversation history survives; changes to the previous sandbox's files and processes do not.
         variant :"agent.session.environment.reset", -> { OpenAI::Beta::AgentSessionEnvironmentResetEvent }
 
@@ -124,7 +130,7 @@ module OpenAI
         )
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent)]
+        #   @return [Array(OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentSuspendedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentExpiredEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent)]
       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,8 +79,14 @@ 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
+            # The sandbox is stopped and can be resumed from its private checkpoint.
+            SUSPENDED = :suspended
+
             EXPIRED = :expired
             FAILED = :failed
 

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.