openai 0.101.1 → 0.102.0

data/rbi/openai/models/beta/agents/environment_list_params.rbi

@@ -0,0 +1,136 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        class EnvironmentListParams < OpenAI::Internal::Type::BaseModel
+
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Beta::Agents::EnvironmentListParams,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # Return environments after this environment ID in the selected order.
+          sig { returns(T.nilable(String)) }
+          attr_reader :after
+
+          sig { params(after: String).void }
+          attr_writer :after
+
+          # The maximum number of environments to return, between 1 and 100. Defaults to 20.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :limit
+
+          sig { params(limit: Integer).void }
+          attr_writer :limit
+
+          # The order in which environments are returned. Defaults to `desc`.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::EnvironmentListParams::Order::OrSymbol)) }
+          attr_reader :order
+
+          sig { params(order: OpenAI::Beta::Agents::EnvironmentListParams::Order::OrSymbol).void }
+          attr_writer :order
+
+          # The hosting type to list. Defaults to `openai_hosted`.
+          sig { returns(T.nilable(OpenAI::Beta::Agents::EnvironmentListParams::Type::OrSymbol)) }
+          attr_reader :type
+
+          sig { params(type: OpenAI::Beta::Agents::EnvironmentListParams::Type::OrSymbol).void }
+          attr_writer :type
+
+          sig do
+            params(
+
+              after: String,
+
+              limit: Integer,
+
+              order: OpenAI::Beta::Agents::EnvironmentListParams::Order::OrSymbol,
+
+              type: OpenAI::Beta::Agents::EnvironmentListParams::Type::OrSymbol,
+
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # Return environments after this environment ID in the selected order.
+            after: nil,
+
+            # The maximum number of environments to return, between 1 and 100. Defaults to 20.
+            limit: nil,
+
+            # The order in which environments are returned. Defaults to `desc`.
+            order: nil,
+
+            # The hosting type to list. Defaults to `openai_hosted`.
+            type: nil,
+
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                after: String,
+                limit: Integer,
+                order: OpenAI::Beta::Agents::EnvironmentListParams::Order::OrSymbol,
+                type: OpenAI::Beta::Agents::EnvironmentListParams::Type::OrSymbol,
+                request_options: OpenAI::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The order in which environments are returned. Defaults to `desc`.
+          module Order
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Beta::Agents::EnvironmentListParams::Order) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            # Returns resources in ascending order.
+            ASC = T.let(:asc, OpenAI::Beta::Agents::EnvironmentListParams::Order::TaggedSymbol)
+
+            # Returns resources in descending order.
+            DESC = T.let(:desc, OpenAI::Beta::Agents::EnvironmentListParams::Order::TaggedSymbol)
+
+            sig { override.returns(T::Array[OpenAI::Beta::Agents::EnvironmentListParams::Order::TaggedSymbol]) }
+            def self.values
+            end
+          end
+
+          # The hosting type to list. Defaults to `openai_hosted`.
+          module Type
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::Beta::Agents::EnvironmentListParams::Type) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            OPENAI_HOSTED = T.let(:openai_hosted, OpenAI::Beta::Agents::EnvironmentListParams::Type::TaggedSymbol)
+
+            sig { override.returns(T::Array[OpenAI::Beta::Agents::EnvironmentListParams::Type::TaggedSymbol]) }
+            def self.values
+            end
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/environment_param.rbi

@@ -91,6 +91,14 @@ module OpenAI
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_accessor :env
 
+          # An existing prewarmed environment. Cannot be combined with a template or inline
+          # configuration.
+          sig { returns(T.nilable(String)) }
+          attr_reader :environment_id
+
+          sig { params(environment_id: String).void }
+          attr_writer :environment_id
+
           # A reusable hosted template applied before inline session configuration. Omitted
           # fields inherit the template; network overrides cannot broaden its policy.
           sig { returns(T.nilable(String)) }
@@ -161,6 +169,8 @@ module OpenAI
 
               env: T.nilable(T::Hash[Symbol, String]),
 
+              environment_id: String,
+
               environment_template_id: String,
 
               files: T.nilable(
@@ -209,6 +219,10 @@ module OpenAI
             # Environment variables made available to the agent.
             env: nil,
 
+            # An existing prewarmed environment. Cannot be combined with a template or inline
+            # configuration.
+            environment_id: nil,
+
             # A reusable hosted template applied before inline session configuration. Omitted
             # fields inherit the template; network overrides cannot broaden its policy.
             environment_template_id: nil,
@@ -247,6 +261,7 @@ module OpenAI
                 container_size: OpenAI::Beta::EnvironmentParam::OpenAIHosted::ContainerSize::OrSymbol,
                 desktop: T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop),
                 env: T.nilable(T::Hash[Symbol, String]),
+                environment_id: String,
                 environment_template_id: String,
                 files: T.nilable(
                   T::Array[

data/rbi/openai/models/webhooks/agent_environment_failed_webhook_event.rbi

@@ -0,0 +1,134 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Webhooks
+
+      class AgentEnvironmentFailedWebhookEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The Unix timestamp, in seconds, when the event was created.
+        sig { returns(Integer) }
+        attr_accessor :created_at
+
+        # Identifies the environment whose lifecycle changed.
+        sig { returns(OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent::Data) }
+        attr_reader :data
+
+        sig { params(data: OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent::Data::OrHash).void }
+        attr_writer :data
+
+        # The object type. Always `event`.
+        sig { returns(Symbol) }
+        attr_accessor :object
+
+        # The event type. Always `agent.environment.failed`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Sent when setup fails for a prewarmed OpenAI-hosted environment before it is
+        # attached to a session.
+        sig do
+          params(
+
+            id: String,
+
+            created_at: Integer,
+
+            data: OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent::Data::OrHash,
+
+            object: Symbol,
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The unique ID of the event.
+          id:,
+
+          # The Unix timestamp, in seconds, when the event was created.
+          created_at:,
+
+          # Identifies the environment whose lifecycle changed.
+          data:,
+
+          # The object type. Always `event`.
+          object: :event,
+
+          # The event type. Always `agent.environment.failed`.
+
+          type: :"agent.environment.failed"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Integer,
+              data: OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent::Data,
+              object: Symbol,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Data < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent::Data,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # The ID of the environment.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # Identifies the environment whose lifecycle changed.
+          sig do
+            params(
+
+              id: String
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # The ID of the environment.
+
+            id:
+          )
+          end
+
+          sig do
+            override.returns(
+              {id: String}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/webhooks/agent_environment_ready_webhook_event.rbi

@@ -0,0 +1,134 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Webhooks
+
+      class AgentEnvironmentReadyWebhookEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The Unix timestamp, in seconds, when the event was created.
+        sig { returns(Integer) }
+        attr_accessor :created_at
+
+        # Identifies the environment whose lifecycle changed.
+        sig { returns(OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent::Data) }
+        attr_reader :data
+
+        sig { params(data: OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent::Data::OrHash).void }
+        attr_writer :data
+
+        # The object type. Always `event`.
+        sig { returns(Symbol) }
+        attr_accessor :object
+
+        # The event type. Always `agent.environment.ready`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Sent when a prewarmed OpenAI-hosted environment finishes setup before being
+        # attached to a session.
+        sig do
+          params(
+
+            id: String,
+
+            created_at: Integer,
+
+            data: OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent::Data::OrHash,
+
+            object: Symbol,
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The unique ID of the event.
+          id:,
+
+          # The Unix timestamp, in seconds, when the event was created.
+          created_at:,
+
+          # Identifies the environment whose lifecycle changed.
+          data:,
+
+          # The object type. Always `event`.
+          object: :event,
+
+          # The event type. Always `agent.environment.ready`.
+
+          type: :"agent.environment.ready"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Integer,
+              data: OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent::Data,
+              object: Symbol,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Data < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent::Data,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # The ID of the environment.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # Identifies the environment whose lifecycle changed.
+          sig do
+            params(
+
+              id: String
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # The ID of the environment.
+
+            id:
+          )
+          end
+
+          sig do
+            override.returns(
+              {id: String}
+            )
+          end
+          def to_hash
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/webhooks/unwrap_webhook_event.rbi

@@ -5,13 +5,15 @@ module OpenAI
 
     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
 
         Variants = T.type_alias do
           T.any(
+            OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent,
+            OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent,
             OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent,
             OpenAI::Webhooks::AgentSessionCreatedWebhookEvent,
             OpenAI::Webhooks::AgentSessionFailedWebhookEvent,

data/rbi/openai/models/webhooks/webhook_create_params.rbi

@@ -121,6 +121,14 @@ module OpenAI
           )
           VIDEO_COMPLETED = T.let(:"video.completed", OpenAI::Webhooks::WebhookCreateParams::EventType::TaggedSymbol)
           VIDEO_FAILED = T.let(:"video.failed", OpenAI::Webhooks::WebhookCreateParams::EventType::TaggedSymbol)
+          AGENT_ENVIRONMENT_READY = T.let(
+            :"agent.environment.ready",
+            OpenAI::Webhooks::WebhookCreateParams::EventType::TaggedSymbol
+          )
+          AGENT_ENVIRONMENT_FAILED = T.let(
+            :"agent.environment.failed",
+            OpenAI::Webhooks::WebhookCreateParams::EventType::TaggedSymbol
+          )
           AGENT_SESSION_CREATED = T.let(
             :"agent.session.created",
             OpenAI::Webhooks::WebhookCreateParams::EventType::TaggedSymbol

data/rbi/openai/models/webhooks/webhook_test_params.rbi

@@ -106,6 +106,14 @@ module OpenAI
           )
           VIDEO_COMPLETED = T.let(:"video.completed", OpenAI::Webhooks::WebhookTestParams::EventType::TaggedSymbol)
           VIDEO_FAILED = T.let(:"video.failed", OpenAI::Webhooks::WebhookTestParams::EventType::TaggedSymbol)
+          AGENT_ENVIRONMENT_READY = T.let(
+            :"agent.environment.ready",
+            OpenAI::Webhooks::WebhookTestParams::EventType::TaggedSymbol
+          )
+          AGENT_ENVIRONMENT_FAILED = T.let(
+            :"agent.environment.failed",
+            OpenAI::Webhooks::WebhookTestParams::EventType::TaggedSymbol
+          )
           AGENT_SESSION_CREATED = T.let(
             :"agent.session.created",
             OpenAI::Webhooks::WebhookTestParams::EventType::TaggedSymbol

data/rbi/openai/models/webhooks/webhook_update_params.rbi

@@ -138,6 +138,14 @@ module OpenAI
           )
           VIDEO_COMPLETED = T.let(:"video.completed", OpenAI::Webhooks::WebhookUpdateParams::EventType::TaggedSymbol)
           VIDEO_FAILED = T.let(:"video.failed", OpenAI::Webhooks::WebhookUpdateParams::EventType::TaggedSymbol)
+          AGENT_ENVIRONMENT_READY = T.let(
+            :"agent.environment.ready",
+            OpenAI::Webhooks::WebhookUpdateParams::EventType::TaggedSymbol
+          )
+          AGENT_ENVIRONMENT_FAILED = T.let(
+            :"agent.environment.failed",
+            OpenAI::Webhooks::WebhookUpdateParams::EventType::TaggedSymbol
+          )
           AGENT_SESSION_CREATED = T.let(
             :"agent.session.created",
             OpenAI::Webhooks::WebhookUpdateParams::EventType::TaggedSymbol

data/rbi/openai/resources/beta/agents/environments.rbi

@@ -15,6 +15,34 @@ module OpenAI
           sig { returns(OpenAI::Resources::Beta::Agents::Environments::Templates) }
           attr_reader :templates
 
+          # Creates an OpenAI-hosted environment before creating a session. Requires access
+          # to the prewarming beta.
+          sig {
+            params(
+              environment: OpenAI::Beta::Agents::EnvironmentCreateParams::Environment::OrHash,
+              vault_ids: T.nilable(T::Array[String]),
+              idempotency_key: String,
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Beta::Agents::EnvironmentInfo)
+          }
+          def create(
+            # Body param: The required hosting type and its configuration.
+            environment:,
+            # Body param: The IDs of up to 10 vaults made available to an OpenAI-hosted
+            # environment.
+            vault_ids: nil,
+            # 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.
+            idempotency_key: nil,
+            request_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).
@@ -30,6 +58,31 @@ module OpenAI
           )
           end
 
+          # Lists OpenAI-hosted environments owned by the authenticated principal. Requires
+          # access to the prewarming beta.
+          sig {
+            params(
+              after: String,
+              limit: Integer,
+              order: OpenAI::Beta::Agents::EnvironmentListParams::Order::OrSymbol,
+              type: OpenAI::Beta::Agents::EnvironmentListParams::Type::OrSymbol,
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Internal::CursorPage[OpenAI::Beta::Agents::EnvironmentInfo])
+          }
+          def list(
+            # Return environments after this environment ID in the selected order.
+            after: nil,
+            # The maximum number of environments to return, between 1 and 100. Defaults to 20.
+            limit: nil,
+            # The order in which environments are returned. Defaults to `desc`.
+            order: nil,
+            # The hosting type to list. Defaults to `openai_hosted`.
+            type: nil,
+            request_options: {}
+          )
+          end
+
           # @api private
           sig { params(client: OpenAI::Client).returns(T.attached_class) }
           def self.new(client:)

data/rbi/openai/resources/webhooks.rbi

@@ -140,6 +140,8 @@ module OpenAI
         )
           .returns(
             T.any(
+              OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent,
+              OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent,
               OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent,
               OpenAI::Webhooks::AgentSessionCreatedWebhookEvent,
               OpenAI::Webhooks::AgentSessionFailedWebhookEvent,