openai 0.101.1 → 0.103.0

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

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Webhooks
+      class AgentEnvironmentExpiredWebhookEvent < 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::AgentEnvironmentExpiredWebhookEvent::Data]
+        required :data, -> { OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent::Data }
+
+        # @!attribute object
+        #   The object type. Always `event`.
+        #
+        #   @return [Symbol, :event]
+        required :object, const: :event
+
+        # @!attribute type
+        #   The event type. Always `agent.environment.expired`.
+        #
+        #   @return [Symbol, :"agent.environment.expired"]
+        required :type, const: :"agent.environment.expired"
+
+        # @!method initialize(id:, created_at:, data:, object: :event, type: :"agent.environment.expired")
+        #   Sent when an agent environment expires and can no longer resume from a snapshot.
+        #
+        #   @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::AgentEnvironmentExpiredWebhookEvent::Data]
+        #     Identifies the environment whose lifecycle changed.
+        #
+        #   @param object [Symbol, :event]
+        #     The object type. Always `event`.
+        #
+        #   @param type [Symbol, :"agent.environment.expired"]
+        #     The event type. Always `agent.environment.expired`.
+
+        # @see OpenAI::Models::Webhooks::AgentEnvironmentExpiredWebhookEvent#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_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/agent_environment_suspended_webhook_event.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Webhooks
+      class AgentEnvironmentSuspendedWebhookEvent < 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::AgentEnvironmentSuspendedWebhookEvent::Data]
+        required :data, -> { OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent::Data }
+
+        # @!attribute object
+        #   The object type. Always `event`.
+        #
+        #   @return [Symbol, :event]
+        required :object, const: :event
+
+        # @!attribute type
+        #   The event type. Always `agent.environment.suspended`.
+        #
+        #   @return [Symbol, :"agent.environment.suspended"]
+        required :type, const: :"agent.environment.suspended"
+
+        # @!method initialize(id:, created_at:, data:, object: :event, type: :"agent.environment.suspended")
+        #   Sent when an agent environment is suspended and can resume from a snapshot.
+        #
+        #   @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::AgentEnvironmentSuspendedWebhookEvent::Data]
+        #     Identifies the environment whose lifecycle changed.
+        #
+        #   @param object [Symbol, :event]
+        #     The object type. Always `event`.
+        #
+        #   @param type [Symbol, :"agent.environment.suspended"]
+        #     The event type. Always `agent.environment.suspended`.
+
+        # @see OpenAI::Models::Webhooks::AgentEnvironmentSuspendedWebhookEvent#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,24 @@
 module OpenAI
   module Models
     module Webhooks
-      # Sent when an agent session requires an action. Retrieve the session for action
-      # details.
+      # Sent when an agent environment expires and can no longer resume from a snapshot.
       module UnwrapWebhookEvent
         extend OpenAI::Internal::Type::Union
 
         discriminator :type
 
+        # Sent when an agent environment expires and can no longer resume from a snapshot.
+        variant :"agent.environment.expired", -> { OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent }
+
+        # Sent when an agent environment is suspended and can resume from a snapshot.
+        variant :"agent.environment.suspended", -> { OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent }
+
+        # 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 +108,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::AgentEnvironmentExpiredWebhookEvent, OpenAI::Models::Webhooks::AgentEnvironmentSuspendedWebhookEvent, 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,10 @@ 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_ENVIRONMENT_SUSPENDED = :"agent.environment.suspended"
+          AGENT_ENVIRONMENT_EXPIRED = :"agent.environment.expired"
           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,10 @@ 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_ENVIRONMENT_SUSPENDED = :"agent.environment.suspended"
+          AGENT_ENVIRONMENT_EXPIRED = :"agent.environment.expired"
           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_update_params.rb

@@ -69,6 +69,10 @@ 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_ENVIRONMENT_SUSPENDED = :"agent.environment.suspended"
+          AGENT_ENVIRONMENT_EXPIRED = :"agent.environment.expired"
           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/resources/beta/agents/environments/files.rb

@@ -59,10 +59,11 @@ module OpenAI
               @client.request(
                 method: :post,
                 path: ["agents/environments/%1$s/files", environment_id],
+                headers: {"openai-beta" => "agents=v1"},
                 body: parsed[:hosted_environment_file_param],
                 model: OpenAI::Beta::Agents::Environments::EnvironmentFile,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -99,10 +100,11 @@ module OpenAI
                 method: :get,
                 path: ["agents/environments/%1$s/files", environment_id],
                 query: query,
+                headers: {"openai-beta" => "agents=v1"},
                 page: OpenAI::Internal::TokenPage,
                 model: OpenAI::Beta::Agents::Environments::EnvironmentFile,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 

data/lib/openai/resources/beta/agents/environments/templates.rb

@@ -56,10 +56,11 @@ module OpenAI
               @client.request(
                 method: :post,
                 path: "agents/environments/templates",
+                headers: {"openai-beta" => "agents=v1"},
                 body: parsed,
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplate,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -81,9 +82,10 @@ module OpenAI
               @client.request(
                 method: :get,
                 path: ["agents/environments/templates/%1$s", environment_template_id],
+                headers: {"openai-beta" => "agents=v1"},
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplate,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+                options: params[:request_options]
               )
             end
 
@@ -137,10 +139,11 @@ module OpenAI
               @client.request(
                 method: :post,
                 path: ["agents/environments/templates/%1$s", environment_template_id],
+                headers: {"openai-beta" => "agents=v1"},
                 body: parsed,
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplate,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -170,10 +173,11 @@ module OpenAI
                 method: :get,
                 path: "agents/environments/templates",
                 query: query,
+                headers: {"openai-beta" => "agents=v1"},
                 page: OpenAI::Internal::CursorPage,
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplate,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -195,9 +199,10 @@ module OpenAI
               @client.request(
                 method: :delete,
                 path: ["agents/environments/templates/%1$s", environment_template_id],
+                headers: {"openai-beta" => "agents=v1"},
                 model: OpenAI::Beta::Agents::Environments::EnvironmentTemplateDeleted,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+                options: params[:request_options]
               )
             end
 

data/lib/openai/resources/beta/agents/environments.rb

@@ -11,6 +11,47 @@ module OpenAI
           # @return [OpenAI::Resources::Beta::Agents::Environments::Templates]
           attr_reader :templates
 
+          # Creates an OpenAI-hosted environment before creating a session. Requires access
+          # to the prewarming beta.
+          #
+          # @overload create(environment:, vault_ids: nil, idempotency_key: nil, request_options: {})
+          #
+          # @param environment [OpenAI::Models::Beta::Agents::EnvironmentCreateParams::Environment]
+          #   Body param: The required hosting type and its configuration.
+          #
+          # @param vault_ids [Array<String>, nil]
+          #   Body param: The IDs of up to 10 vaults made available to an OpenAI-hosted
+          #   environment.
+          #
+          # @param idempotency_key [String]
+          #   Header param: Deduplicates creation for 24 hours within the authenticated
+          #   organization, project, and creator. Retry the same JSON parameters with the same
+          #   key to retrieve the original environment in its current state. Different
+          #   parameters or an incomplete hosted creation return 409. Deleted environments are
+          #   not recreated. After retention expires, the key may create a new environment.
+          #   Without this header, each request creates a new environment.
+          #
+          # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [OpenAI::Models::Beta::Agents::EnvironmentInfo]
+          #
+          # @see OpenAI::Models::Beta::Agents::EnvironmentCreateParams
+          def create(params)
+            parsed, options = OpenAI::Beta::Agents::EnvironmentCreateParams.dump_request(params)
+            header_params = {idempotency_key: "idempotency-key"}
+            @client.request(
+              method: :post,
+              path: "agents/environments",
+              headers: {"openai-beta" => "agents=v1"}.merge(
+                parsed.slice(*header_params.keys).transform_keys(header_params)
+              ),
+              body: parsed.except(*header_params.keys),
+              model: OpenAI::Beta::Agents::EnvironmentInfo,
+              security: {bearer_auth: true},
+              options: options
+            )
+          end
+
           # Retrieves an execution environment's connection status and safe installed
           # metadata. See
           # [environment lifecycle](https://developers.openai.com/api/docs/guides/agents-api/environments/lifecycle).
@@ -29,9 +70,47 @@ module OpenAI
             @client.request(
               method: :get,
               path: ["agents/environments/%1$s", environment_id],
+              headers: {"openai-beta" => "agents=v1"},
+              model: OpenAI::Beta::Agents::EnvironmentInfo,
+              security: {bearer_auth: true},
+              options: params[:request_options]
+            )
+          end
+
+          # Lists OpenAI-hosted environments owned by the authenticated principal. Requires
+          # access to the prewarming beta.
+          #
+          # @overload list(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}, nil]
+          #
+          # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::Agents::EnvironmentInfo>]
+          #
+          # @see OpenAI::Models::Beta::Agents::EnvironmentListParams
+          def list(params = {})
+            parsed, options = OpenAI::Beta::Agents::EnvironmentListParams.dump_request(params)
+            query = OpenAI::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "agents/environments",
+              query: query,
+              headers: {"openai-beta" => "agents=v1"},
+              page: OpenAI::Internal::CursorPage,
               model: OpenAI::Beta::Agents::EnvironmentInfo,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+              options: options
             )
           end
 

data/lib/openai/resources/beta/agents/sessions/artifacts.rb

@@ -39,9 +39,10 @@ module OpenAI
               @client.request(
                 method: :get,
                 path: ["agents/sessions/%1$s/artifacts/%2$s", session_id, artifact_id],
+                headers: {"openai-beta" => "agents=v1"},
                 model: OpenAI::Beta::Agents::Sessions::SessionArtifact,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -77,10 +78,11 @@ module OpenAI
                 method: :get,
                 path: ["agents/sessions/%1$s/artifacts", session_id],
                 query: query,
+                headers: {"openai-beta" => "agents=v1"},
                 page: OpenAI::Internal::CursorPage,
                 model: OpenAI::Beta::Agents::Sessions::SessionArtifact,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -110,9 +112,10 @@ module OpenAI
               @client.request(
                 method: :delete,
                 path: ["agents/sessions/%1$s/artifacts/%2$s", session_id, artifact_id],
+                headers: {"openai-beta" => "agents=v1"},
                 model: OpenAI::Beta::Agents::Sessions::SessionArtifactDeleted,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -142,10 +145,10 @@ module OpenAI
               @client.request(
                 method: :get,
                 path: ["agents/sessions/%1$s/artifacts/%2$s/content", session_id, artifact_id],
-                headers: {"accept" => "application/octet-stream"},
+                headers: {"openai-beta" => "agents=v1", "accept" => "application/octet-stream"},
                 model: StringIO,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 

data/lib/openai/resources/beta/agents/sessions/events.rb

@@ -37,11 +37,13 @@ module OpenAI
               @client.request(
                 method: :post,
                 path: ["agents/sessions/%1$s/events", session_id],
-                headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+                headers: {"openai-beta" => "agents=v1"}.merge(
+                  parsed.slice(*header_params.keys).transform_keys(header_params)
+                ),
                 body: parsed.except(*header_params.keys),
                 model: NilClass,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end
 
@@ -55,18 +57,22 @@ module OpenAI
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [OpenAI::Internal::Stream<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 [OpenAI::Internal::Stream<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>]
             #
             # @see OpenAI::Models::Beta::Agents::Sessions::EventStreamParams
             def stream_streaming(session_id, params = {})
               @client.request(
                 method: :get,
                 path: ["agents/sessions/%1$s/events", session_id],
-                headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
+                headers: {
+                  "openai-beta" => "agents=v1",
+                  "accept" => "text/event-stream",
+                  "accept-encoding" => "identity"
+                },
                 stream: OpenAI::Internal::Stream,
                 model: OpenAI::Beta::AgentSessionEvent,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **params[:request_options].to_h}
+                options: params[:request_options]
               )
             end
 

data/lib/openai/resources/beta/agents/sessions/items.rb

@@ -36,10 +36,11 @@ module OpenAI
                 method: :get,
                 path: ["agents/sessions/%1$s/items", session_id],
                 query: query,
+                headers: {"openai-beta" => "agents=v1"},
                 page: OpenAI::Internal::CursorPage,
                 model: OpenAI::Beta::AgentSessionItem,
                 security: {bearer_auth: true},
-                options: {extra_headers: {"OpenAI-Beta" => "agents=v1"}, **options}
+                options: options
               )
             end