openai 0.101.1 → 0.103.0

data/lib/openai/resources/beta/threads/runs.rb

@@ -166,10 +166,11 @@ module OpenAI
               method: :post,
               path: ["threads/%1$s/runs", thread_id],
               query: query,
+              headers: {"openai-beta" => "assistants=v2"},
               body: parsed.except(*query_params),
               model: OpenAI::Beta::Threads::Run,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+              options: options
             )
           end
 
@@ -328,12 +329,16 @@ module OpenAI
               method: :post,
               path: ["threads/%1$s/runs", thread_id],
               query: query,
-              headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
+              headers: {
+                "openai-beta" => "assistants=v2",
+                "accept" => "text/event-stream",
+                "accept-encoding" => "identity"
+              },
               body: parsed.except(*query_params),
               stream: OpenAI::Internal::Stream,
               model: OpenAI::Beta::AssistantStreamEvent,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+              options: options
             )
           end
 
@@ -365,9 +370,10 @@ module OpenAI
             @client.request(
               method: :get,
               path: ["threads/%1$s/runs/%2$s", thread_id, run_id],
+              headers: {"openai-beta" => "assistants=v2"},
               model: OpenAI::Beta::Threads::Run,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+              options: options
             )
           end
 
@@ -407,10 +413,11 @@ module OpenAI
             @client.request(
               method: :post,
               path: ["threads/%1$s/runs/%2$s", thread_id, run_id],
+              headers: {"openai-beta" => "assistants=v2"},
               body: parsed,
               model: OpenAI::Beta::Threads::Run,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+              options: options
             )
           end
 
@@ -455,10 +462,11 @@ module OpenAI
               method: :get,
               path: ["threads/%1$s/runs", thread_id],
               query: query,
+              headers: {"openai-beta" => "assistants=v2"},
               page: OpenAI::Internal::CursorPage,
               model: OpenAI::Beta::Threads::Run,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+              options: options
             )
           end
 
@@ -488,9 +496,10 @@ module OpenAI
             @client.request(
               method: :post,
               path: ["threads/%1$s/runs/%2$s/cancel", thread_id, run_id],
+              headers: {"openai-beta" => "assistants=v2"},
               model: OpenAI::Beta::Threads::Run,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+              options: options
             )
           end
 
@@ -536,10 +545,11 @@ module OpenAI
             @client.request(
               method: :post,
               path: ["threads/%1$s/runs/%2$s/submit_tool_outputs", thread_id, run_id],
+              headers: {"openai-beta" => "assistants=v2"},
               body: parsed,
               model: OpenAI::Beta::Threads::Run,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+              options: options
             )
           end
 
@@ -586,12 +596,16 @@ module OpenAI
             @client.request(
               method: :post,
               path: ["threads/%1$s/runs/%2$s/submit_tool_outputs", thread_id, run_id],
-              headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
+              headers: {
+                "openai-beta" => "assistants=v2",
+                "accept" => "text/event-stream",
+                "accept-encoding" => "identity"
+              },
               body: parsed,
               stream: OpenAI::Internal::Stream,
               model: OpenAI::Beta::AssistantStreamEvent,
               security: {bearer_auth: true},
-              options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+              options: options
             )
           end
 

data/lib/openai/resources/beta/threads.rb

@@ -50,10 +50,11 @@ module OpenAI
           @client.request(
             method: :post,
             path: "threads",
+            headers: {"openai-beta" => "assistants=v2"},
             body: parsed,
             model: OpenAI::Beta::Thread,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -75,9 +76,10 @@ module OpenAI
           @client.request(
             method: :get,
             path: ["threads/%1$s", thread_id],
+            headers: {"openai-beta" => "assistants=v2"},
             model: OpenAI::Beta::Thread,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **params[:request_options].to_h}
+            options: params[:request_options]
           )
         end
 
@@ -114,10 +116,11 @@ module OpenAI
           @client.request(
             method: :post,
             path: ["threads/%1$s", thread_id],
+            headers: {"openai-beta" => "assistants=v2"},
             body: parsed,
             model: OpenAI::Beta::Thread,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -139,9 +142,10 @@ module OpenAI
           @client.request(
             method: :delete,
             path: ["threads/%1$s", thread_id],
+            headers: {"openai-beta" => "assistants=v2"},
             model: OpenAI::Beta::ThreadDeleted,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **params[:request_options].to_h}
+            options: params[:request_options]
           )
         end
 
@@ -272,10 +276,11 @@ module OpenAI
           @client.request(
             method: :post,
             path: "threads/runs",
+            headers: {"openai-beta" => "assistants=v2"},
             body: parsed,
             model: OpenAI::Beta::Threads::Run,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -412,12 +417,16 @@ module OpenAI
           @client.request(
             method: :post,
             path: "threads/runs",
-            headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
+            headers: {
+              "openai-beta" => "assistants=v2",
+              "accept" => "text/event-stream",
+              "accept-encoding" => "identity"
+            },
             body: parsed,
             stream: OpenAI::Internal::Stream,
             model: OpenAI::Beta::AssistantStreamEvent,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 

data/lib/openai/resources/vector_stores/file_batches.rb

@@ -50,16 +50,11 @@ module OpenAI
           @client.request(
             method: :post,
             path: ["vector_stores/%1$s/file_batches", vector_store_id],
+            headers: {"openai-beta" => "assistants=v2"},
             body: parsed,
             model: OpenAI::VectorStores::VectorStoreFileBatch,
             security: {bearer_auth: true},
-            options: {
-              **options,
-              extra_headers: OpenAI::Internal::Util.normalized_headers(
-                {"OpenAI-Beta" => "assistants=v2"},
-                options[:extra_headers].to_h
-              )
-            }
+            options: options
           )
         end
 
@@ -144,9 +139,10 @@ module OpenAI
           @client.request(
             method: :get,
             path: ["vector_stores/%1$s/file_batches/%2$s", vector_store_id, batch_id],
+            headers: {"openai-beta" => "assistants=v2"},
             model: OpenAI::VectorStores::VectorStoreFileBatch,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -175,9 +171,10 @@ module OpenAI
           @client.request(
             method: :post,
             path: ["vector_stores/%1$s/file_batches/%2$s/cancel", vector_store_id, batch_id],
+            headers: {"openai-beta" => "assistants=v2"},
             model: OpenAI::VectorStores::VectorStoreFileBatch,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -231,10 +228,11 @@ module OpenAI
             method: :get,
             path: ["vector_stores/%1$s/file_batches/%2$s/files", vector_store_id, batch_id],
             query: query,
+            headers: {"openai-beta" => "assistants=v2"},
             page: OpenAI::Internal::CursorPage,
             model: OpenAI::VectorStores::VectorStoreFile,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 

data/lib/openai/resources/vector_stores/files.rb

@@ -43,16 +43,11 @@ module OpenAI
           @client.request(
             method: :post,
             path: ["vector_stores/%1$s/files", vector_store_id],
+            headers: {"openai-beta" => "assistants=v2"},
             body: parsed,
             model: OpenAI::VectorStores::VectorStoreFile,
             security: {bearer_auth: true},
-            options: {
-              **options,
-              extra_headers: OpenAI::Internal::Util.normalized_headers(
-                {"OpenAI-Beta" => "assistants=v2"},
-                options[:extra_headers].to_h
-              )
-            }
+            options: options
           )
         end
 
@@ -132,9 +127,10 @@ module OpenAI
           @client.request(
             method: :get,
             path: ["vector_stores/%1$s/files/%2$s", vector_store_id, file_id],
+            headers: {"openai-beta" => "assistants=v2"},
             model: OpenAI::VectorStores::VectorStoreFile,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -169,10 +165,11 @@ module OpenAI
           @client.request(
             method: :post,
             path: ["vector_stores/%1$s/files/%2$s", vector_store_id, file_id],
+            headers: {"openai-beta" => "assistants=v2"},
             body: parsed,
             model: OpenAI::VectorStores::VectorStoreFile,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -218,10 +215,11 @@ module OpenAI
             method: :get,
             path: ["vector_stores/%1$s/files", vector_store_id],
             query: query,
+            headers: {"openai-beta" => "assistants=v2"},
             page: OpenAI::Internal::CursorPage,
             model: OpenAI::VectorStores::VectorStoreFile,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -252,9 +250,10 @@ module OpenAI
           @client.request(
             method: :delete,
             path: ["vector_stores/%1$s/files/%2$s", vector_store_id, file_id],
+            headers: {"openai-beta" => "assistants=v2"},
             model: OpenAI::VectorStores::VectorStoreFileDeleted,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 
@@ -416,10 +415,11 @@ module OpenAI
           @client.request(
             method: :get,
             path: ["vector_stores/%1$s/files/%2$s/content", vector_store_id, file_id],
+            headers: {"openai-beta" => "assistants=v2"},
             page: OpenAI::Internal::Page,
             model: OpenAI::Models::VectorStores::FileContentResponse,
             security: {bearer_auth: true},
-            options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+            options: options
           )
         end
 

data/lib/openai/resources/vector_stores.rb

@@ -50,10 +50,11 @@ module OpenAI
         @client.request(
           method: :post,
           path: "vector_stores",
+          headers: {"openai-beta" => "assistants=v2"},
           body: parsed,
           model: OpenAI::VectorStore,
           security: {bearer_auth: true},
-          options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+          options: options
         )
       end
 
@@ -73,9 +74,10 @@ module OpenAI
         @client.request(
           method: :get,
           path: ["vector_stores/%1$s", vector_store_id],
+          headers: {"openai-beta" => "assistants=v2"},
           model: OpenAI::VectorStore,
           security: {bearer_auth: true},
-          options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **params[:request_options].to_h}
+          options: params[:request_options]
         )
       end
 
@@ -110,10 +112,11 @@ module OpenAI
         @client.request(
           method: :post,
           path: ["vector_stores/%1$s", vector_store_id],
+          headers: {"openai-beta" => "assistants=v2"},
           body: parsed,
           model: OpenAI::VectorStore,
           security: {bearer_auth: true},
-          options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+          options: options
         )
       end
 
@@ -153,10 +156,11 @@ module OpenAI
           method: :get,
           path: "vector_stores",
           query: query,
+          headers: {"openai-beta" => "assistants=v2"},
           page: OpenAI::Internal::CursorPage,
           model: OpenAI::VectorStore,
           security: {bearer_auth: true},
-          options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+          options: options
         )
       end
 
@@ -176,9 +180,10 @@ module OpenAI
         @client.request(
           method: :delete,
           path: ["vector_stores/%1$s", vector_store_id],
+          headers: {"openai-beta" => "assistants=v2"},
           model: OpenAI::VectorStoreDeleted,
           security: {bearer_auth: true},
-          options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **params[:request_options].to_h}
+          options: params[:request_options]
         )
       end
 
@@ -216,11 +221,12 @@ module OpenAI
         @client.request(
           method: :post,
           path: ["vector_stores/%1$s/search", vector_store_id],
+          headers: {"openai-beta" => "assistants=v2"},
           body: parsed,
           page: OpenAI::Internal::Page,
           model: OpenAI::Models::VectorStoreSearchResponse,
           security: {bearer_auth: true},
-          options: {extra_headers: {"OpenAI-Beta" => "assistants=v2"}, **options}
+          options: options
         )
       end
 

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::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.101.1"
+  VERSION = "0.103.0"
 end

data/lib/openai.rb

@@ -493,7 +493,9 @@ require_relative "openai/models/beta/agent_reasoning_item"
 require_relative "openai/models/beta/agent_reasoning_param"
 require_relative "openai/models/beta/agent_resume_subagent_call_item"
 require_relative "openai/models/beta/agent_retrieve_params"
+require_relative "openai/models/beta/agents/environment_create_params"
 require_relative "openai/models/beta/agents/environment_info"
+require_relative "openai/models/beta/agents/environment_list_params"
 require_relative "openai/models/beta/agents/environment_retrieve_params"
 require_relative "openai/models/beta/agents/environments/environment_file"
 require_relative "openai/models/beta/agents/environments/environment_template"
@@ -561,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"
@@ -1446,6 +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)
 

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,