openai 0.101.1 → 0.103.0

data/rbi/openai/models/webhooks/agent_environment_expired_webhook_event.rbi

@@ -0,0 +1,133 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Webhooks
+
+      class AgentEnvironmentExpiredWebhookEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent,
+            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::AgentEnvironmentExpiredWebhookEvent::Data) }
+        attr_reader :data
+
+        sig { params(data: OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent::Data::OrHash).void }
+        attr_writer :data
+
+        # The object type. Always `event`.
+        sig { returns(Symbol) }
+        attr_accessor :object
+
+        # The event type. Always `agent.environment.expired`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Sent when an agent environment expires and can no longer resume from a snapshot.
+        sig do
+          params(
+
+            id: String,
+
+            created_at: Integer,
+
+            data: OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent::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.expired`.
+
+          type: :"agent.environment.expired"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Integer,
+              data: OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent::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::AgentEnvironmentExpiredWebhookEvent::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_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/agent_environment_suspended_webhook_event.rbi

@@ -0,0 +1,133 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Webhooks
+
+      class AgentEnvironmentSuspendedWebhookEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent,
+            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::AgentEnvironmentSuspendedWebhookEvent::Data) }
+        attr_reader :data
+
+        sig { params(data: OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent::Data::OrHash).void }
+        attr_writer :data
+
+        # The object type. Always `event`.
+        sig { returns(Symbol) }
+        attr_accessor :object
+
+        # The event type. Always `agent.environment.suspended`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Sent when an agent environment is suspended and can resume from a snapshot.
+        sig do
+          params(
+
+            id: String,
+
+            created_at: Integer,
+
+            data: OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent::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.suspended`.
+
+          type: :"agent.environment.suspended"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Integer,
+              data: OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent::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::AgentEnvironmentSuspendedWebhookEvent::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,16 @@ module OpenAI
 
     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
 
         Variants = T.type_alias do
           T.any(
+            OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent,
+            OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent,
+            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,22 @@ 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_ENVIRONMENT_SUSPENDED = T.let(
+            :"agent.environment.suspended",
+            OpenAI::Webhooks::WebhookCreateParams::EventType::TaggedSymbol
+          )
+          AGENT_ENVIRONMENT_EXPIRED = T.let(
+            :"agent.environment.expired",
+            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,22 @@ 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_ENVIRONMENT_SUSPENDED = T.let(
+            :"agent.environment.suspended",
+            OpenAI::Webhooks::WebhookTestParams::EventType::TaggedSymbol
+          )
+          AGENT_ENVIRONMENT_EXPIRED = T.let(
+            :"agent.environment.expired",
+            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,22 @@ 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_ENVIRONMENT_SUSPENDED = T.let(
+            :"agent.environment.suspended",
+            OpenAI::Webhooks::WebhookUpdateParams::EventType::TaggedSymbol
+          )
+          AGENT_ENVIRONMENT_EXPIRED = T.let(
+            :"agent.environment.expired",
+            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,10 @@ module OpenAI
         )
           .returns(
             T.any(
+              OpenAI::Webhooks::AgentEnvironmentExpiredWebhookEvent,
+              OpenAI::Webhooks::AgentEnvironmentSuspendedWebhookEvent,
+              OpenAI::Webhooks::AgentEnvironmentFailedWebhookEvent,
+              OpenAI::Webhooks::AgentEnvironmentReadyWebhookEvent,
               OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent,
               OpenAI::Webhooks::AgentSessionCreatedWebhookEvent,
               OpenAI::Webhooks::AgentSessionFailedWebhookEvent,