openai 0.102.0 → 0.103.0

data/rbi/openai/models/beta/agent_session_environment_suspended_event.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      class AgentSessionEnvironmentSuspendedEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Beta::AgentSessionEnvironmentSuspendedEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The current environment state.
+        sig { returns(OpenAI::Beta::AgentSessionEnvironmentState) }
+        attr_reader :environment
+
+        sig { params(environment: OpenAI::Beta::AgentSessionEnvironmentState::OrHash).void }
+        attr_writer :environment
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :event_id
+
+        # The ID of the session associated with the event.
+        sig { returns(String) }
+        attr_accessor :session_id
+
+        # The ID of the turn associated with the event, when applicable.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :turn_id
+
+        # The type of the object. Always `agent.session.environment.suspended`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Emitted after an idle hosted session environment is checkpointed and stopped.
+        sig do
+          params(
+
+            environment: OpenAI::Beta::AgentSessionEnvironmentState::OrHash,
+
+            event_id: String,
+
+            session_id: String,
+
+            turn_id: T.nilable(String),
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The current environment state.
+          environment:,
+
+          # The unique ID of the event.
+          event_id:,
+
+          # The ID of the session associated with the event.
+          session_id:,
+
+          # The ID of the turn associated with the event, when applicable.
+          turn_id:,
+
+          # The type of the object. Always `agent.session.environment.suspended`.
+
+          type: :"agent.session.environment.suspended"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              environment: OpenAI::Beta::AgentSessionEnvironmentState,
+              event_id: String,
+              session_id: String,
+              turn_id: T.nilable(String),
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agent_session_event.rbi

@@ -13,6 +13,8 @@ module OpenAI
           T.any(
             OpenAI::Beta::AgentSessionErrorEvent,
             OpenAI::Beta::AgentSessionEnvironmentReadyEvent,
+            OpenAI::Beta::AgentSessionEnvironmentSuspendedEvent,
+            OpenAI::Beta::AgentSessionEnvironmentExpiredEvent,
             OpenAI::Beta::AgentSessionEnvironmentResetEvent,
             OpenAI::Beta::AgentOutputCommandExecutionOutputDeltaEvent,
             OpenAI::Beta::AgentSessionCreatedEvent,

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

@@ -126,6 +126,9 @@ module OpenAI
 
             CONNECTED = T.let(:connected, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
             DISCONNECTED = T.let(:disconnected, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
+            # The sandbox is stopped and can be resumed from its private checkpoint.
+            SUSPENDED = T.let(:suspended, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
+
             EXPIRED = T.let(:expired, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
             FAILED = T.let(:failed, OpenAI::Beta::Agents::EnvironmentInfo::Status::TaggedSymbol)
 

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_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,14 @@ module OpenAI
 
     module Webhooks
 
-      # Sent when setup fails for a prewarmed OpenAI-hosted environment before it is
-      # attached to a session.
+      # 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,

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

@@ -129,6 +129,14 @@ module OpenAI
             :"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

@@ -114,6 +114,14 @@ module OpenAI
             :"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

@@ -146,6 +146,14 @@ module OpenAI
             :"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/webhooks.rbi

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

data/sig/openai/models/beta/agent_session_environment_expired_event.rbs

@@ -0,0 +1,57 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_session_environment_expired_event =
+        {
+          environment: OpenAI::Beta::AgentSessionEnvironmentState,
+          event_id: String,
+          session_id: String,
+          turn_id: String?,
+          ?type: :"agent.session.environment.expired"
+        }
+
+      class AgentSessionEnvironmentExpiredEvent < OpenAI::Internal::Type::BaseModel
+        # The current environment state.
+        attr_accessor environment: OpenAI::Beta::AgentSessionEnvironmentState
+
+        # The unique ID of the event.
+        attr_accessor event_id: String
+
+        # The ID of the session associated with the event.
+        attr_accessor session_id: String
+
+        # The ID of the turn associated with the event, when applicable.
+        attr_accessor turn_id: String?
+
+        # The type of the object. Always `agent.session.environment.expired`.
+        attr_accessor type: :"agent.session.environment.expired"
+
+        # @param environment
+        #   The current environment state.
+        # @param event_id
+        #   The unique ID of the event.
+        # @param session_id
+        #   The ID of the session associated with the event.
+        # @param turn_id
+        #   The ID of the turn associated with the event, when applicable.
+        # @param type
+        #   The type of the object. Always `agent.session.environment.expired`.
+        def initialize: (
+          environment: OpenAI::Beta::AgentSessionEnvironmentState,
+          event_id: String,
+          session_id: String,
+          turn_id: String?,
+          ?type: :"agent.session.environment.expired"
+        ) -> void
+
+        def to_hash: -> {
+          environment: OpenAI::Beta::AgentSessionEnvironmentState,
+          event_id: String,
+          session_id: String,
+          turn_id: String?,
+          ?type: :"agent.session.environment.expired"
+        }
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_session_environment_state.rbs

@@ -67,7 +67,14 @@ module OpenAI
           def to_hash: -> { code: String, message: String, type: String }
         end
 
-        type status = :pending | :ready | :connected | :disconnected | :failed
+        type status =
+          :pending
+          | :ready
+          | :connected
+          | :disconnected
+          | :suspended
+          | :expired
+          | :failed
 
         module Status
           extend OpenAI::Internal::Type::Enum
@@ -84,6 +91,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/sig/openai/models/beta/agent_session_environment_suspended_event.rbs

@@ -0,0 +1,57 @@
+module OpenAI
+  module Models
+    module Beta
+      type agent_session_environment_suspended_event =
+        {
+          environment: OpenAI::Beta::AgentSessionEnvironmentState,
+          event_id: String,
+          session_id: String,
+          turn_id: String?,
+          ?type: :"agent.session.environment.suspended"
+        }
+
+      class AgentSessionEnvironmentSuspendedEvent < OpenAI::Internal::Type::BaseModel
+        # The current environment state.
+        attr_accessor environment: OpenAI::Beta::AgentSessionEnvironmentState
+
+        # The unique ID of the event.
+        attr_accessor event_id: String
+
+        # The ID of the session associated with the event.
+        attr_accessor session_id: String
+
+        # The ID of the turn associated with the event, when applicable.
+        attr_accessor turn_id: String?
+
+        # The type of the object. Always `agent.session.environment.suspended`.
+        attr_accessor type: :"agent.session.environment.suspended"
+
+        # @param environment
+        #   The current environment state.
+        # @param event_id
+        #   The unique ID of the event.
+        # @param session_id
+        #   The ID of the session associated with the event.
+        # @param turn_id
+        #   The ID of the turn associated with the event, when applicable.
+        # @param type
+        #   The type of the object. Always `agent.session.environment.suspended`.
+        def initialize: (
+          environment: OpenAI::Beta::AgentSessionEnvironmentState,
+          event_id: String,
+          session_id: String,
+          turn_id: String?,
+          ?type: :"agent.session.environment.suspended"
+        ) -> void
+
+        def to_hash: -> {
+          environment: OpenAI::Beta::AgentSessionEnvironmentState,
+          event_id: String,
+          session_id: String,
+          turn_id: String?,
+          ?type: :"agent.session.environment.suspended"
+        }
+      end
+    end
+  end
+end

data/sig/openai/models/beta/agent_session_event.rbs

@@ -4,6 +4,8 @@ module OpenAI
       type agent_session_event =
         OpenAI::Beta::AgentSessionErrorEvent
         | OpenAI::Beta::AgentSessionEnvironmentReadyEvent
+        | OpenAI::Beta::AgentSessionEnvironmentSuspendedEvent
+        | OpenAI::Beta::AgentSessionEnvironmentExpiredEvent
         | OpenAI::Beta::AgentSessionEnvironmentResetEvent
         | OpenAI::Beta::AgentOutputCommandExecutionOutputDeltaEvent
         | OpenAI::Beta::AgentSessionCreatedEvent

data/sig/openai/models/beta/agents/environment_info.rbs

@@ -70,7 +70,13 @@ module OpenAI
           }
 
           type status =
-            :pending | :ready | :connected | :disconnected | :expired | :failed
+            :pending
+            | :ready
+            | :connected
+            | :disconnected
+            | :suspended
+            | :expired
+            | :failed
 
           module Status
             extend OpenAI::Internal::Type::Enum
@@ -82,6 +88,10 @@ module OpenAI
 
             CONNECTED: :connected
             DISCONNECTED: :disconnected
+
+            # The sandbox is stopped and can be resumed from its private checkpoint.
+            SUSPENDED: :suspended
+
             EXPIRED: :expired
             FAILED: :failed