openai 0.102.0 → 0.103.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e214fa257d53a7b24aa14ad9d7bbabb907c47e3b50b2fbf769177dac7bfe04b8
-  data.tar.gz: 4356c890b1060157f4d252b411eb234f6987782cea1ab79a4eba9d8d00028a87
+  metadata.gz: 1b50a0bb1c17d033d4179a483168878412ecc245f68bd4192692600581db9bc0
+  data.tar.gz: 13eff5cdbaa168cb9837a9a04fc5b39a8cf8d19374d65a4f67be7028bb369d0f
 SHA512:
-  metadata.gz: 1b6c400866161baef0e067c3ebd597b483249954373a32e193e58b8383638d52a977d10270f8e0d876b8838109ec3d086049548d20e77aa9d2d6adbd21a778ea
-  data.tar.gz: dfa20d336ce432cd06d9a65e4ef94575581783885fed890600f35dc32a54b69af9cc2ef63b3d474d561edc88fcc9f944423832e5aa55812f550395a8622bb35e
+  metadata.gz: 63338541f098246944ee6a1e761d0c47ad8434eb722302059205ce4c75a92cb8ab92916d7d3d2156f6882a55ebeb79d051fd51ec25c9db8c6f515bf556d1151d
+  data.tar.gz: a8b900d61a286c864507f0a3ab0195a9df0886b825d10cb4beaa7d9125e918176a1f08f3dba71bcfd7d700df87f4a54c2ad62a0ff26232276dbb6e41d1a4d740

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.103.0](https://github.com/openai/openai-ruby/compare/v0.102.0...v0.103.0) (2026-10-09)
+
+
+### Features
+
+* **api:** add agent environment suspension and expiration ([#821](https://github.com/openai/openai-ruby/issues/821)) ([7405e40](https://github.com/openai/openai-ruby/commit/7405e4011978083f3c8599dc4e3a40a5ca6ecc5d))
+
 ## [0.102.0](https://github.com/openai/openai-ruby/compare/v0.101.1...v0.102.0) (2026-10-09)
 
 

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.102.0"
+gem "openai", "~> 0.103.0"
 ```
 
 <!-- x-release-please-end -->

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

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

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

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

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

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

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

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

data/lib/openai/models/beta/agents/environment_info.rb

@@ -84,6 +84,9 @@ module OpenAI
 
             CONNECTED = :connected
             DISCONNECTED = :disconnected
+            # The sandbox is stopped and can be resumed from its private checkpoint.
+            SUSPENDED = :suspended
+
             EXPIRED = :expired
             FAILED = :failed
 

data/lib/openai/models/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_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,18 @@
 module OpenAI
   module Models
     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
 
         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 }
 
@@ -103,7 +108,7 @@ module OpenAI
         variant :"safety.warning_issued", -> { OpenAI::Webhooks::SafetyWarningIssuedWebhookEvent }
 
         # @!method self.variants
-        #   @return [Array(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)]
+        #   @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

@@ -64,6 +64,8 @@ module OpenAI
           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

@@ -50,6 +50,8 @@ module OpenAI
           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

@@ -71,6 +71,8 @@ module OpenAI
           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/sessions/events.rb

@@ -57,7 +57,7 @@ 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 = {})

data/lib/openai/resources/webhooks.rb

@@ -203,7 +203,7 @@ module OpenAI
       # @param headers [Hash] The webhook headers
       # @param webhook_secret [String, nil] The webhook secret (optional, will use client webhook secret or ENV["OPENAI_WEBHOOK_SECRET"] if not provided)
       #
-      # @return [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]
+      # @return [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]
       #
       # @raise [ArgumentError] if signature verification fails
       def unwrap(

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.102.0"
+  VERSION = "0.103.0"
 end

data/lib/openai.rb

@@ -563,11 +563,13 @@ require_relative "openai/models/beta/agent_session_created_event"
 require_relative "openai/models/beta/agent_session_deleted"
 require_relative "openai/models/beta/agent_session_environment_connected_event"
 require_relative "openai/models/beta/agent_session_environment_disconnected_event"
+require_relative "openai/models/beta/agent_session_environment_expired_event"
 require_relative "openai/models/beta/agent_session_environment_failed_event"
 require_relative "openai/models/beta/agent_session_environment_pending_event"
 require_relative "openai/models/beta/agent_session_environment_ready_event"
 require_relative "openai/models/beta/agent_session_environment_reset_event"
 require_relative "openai/models/beta/agent_session_environment_state"
+require_relative "openai/models/beta/agent_session_environment_suspended_event"
 require_relative "openai/models/beta/agent_session_error_event"
 require_relative "openai/models/beta/agent_session_event"
 require_relative "openai/models/beta/agent_session_failed_event"
@@ -1448,8 +1450,10 @@ require_relative "openai/models/video_remix_params"
 require_relative "openai/models/video_retrieve_params"
 require_relative "openai/models/video_seconds"
 require_relative "openai/models/video_size"
+require_relative "openai/models/webhooks/agent_environment_expired_webhook_event"
 require_relative "openai/models/webhooks/agent_environment_failed_webhook_event"
 require_relative "openai/models/webhooks/agent_environment_ready_webhook_event"
+require_relative "openai/models/webhooks/agent_environment_suspended_webhook_event"
 require_relative "openai/models/webhooks/agent_session_action_required_webhook_event"
 require_relative "openai/models/webhooks/agent_session_created_webhook_event"
 require_relative "openai/models/webhooks/agent_session_failed_webhook_event"

data/rbi/openai/models/beta/agent_session_environment_expired_event.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      class AgentSessionEnvironmentExpiredEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Beta::AgentSessionEnvironmentExpiredEvent,
+            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.expired`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Emitted after a suspended hosted session environment and its checkpoint expire.
+        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.expired`.
+
+          type: :"agent.session.environment.expired"
+        )
+        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_environment_state.rbi

@@ -152,6 +152,12 @@ module OpenAI
           # The environment is disconnected.
           DISCONNECTED = T.let(:disconnected, OpenAI::Beta::AgentSessionEnvironmentState::Status::TaggedSymbol)
 
+          # The environment is stopped and can be resumed from its private checkpoint.
+          SUSPENDED = T.let(:suspended, OpenAI::Beta::AgentSessionEnvironmentState::Status::TaggedSymbol)
+
+          # The environment and its private checkpoint have expired.
+          EXPIRED = T.let(:expired, OpenAI::Beta::AgentSessionEnvironmentState::Status::TaggedSymbol)
+
           # The environment failed to connect.
           FAILED = T.let(:failed, OpenAI::Beta::AgentSessionEnvironmentState::Status::TaggedSymbol)