daytona 0.218.0 → 0.222.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8e213814357ddef2964bbb51dd2bc1639961337e6ec59e06dba8144d905aa4f
-  data.tar.gz: a924ea5a93b4e0d0366e4758135bcd96685eb095ba2bfbd32efa414d6e6a17c0
+  metadata.gz: 1571cb9675a6cbd58c204ff3d703743d0acf676960cd2cc1179a60c76733b645
+  data.tar.gz: 1d1e628fc6216525520dd42b03ebb93a478bb91591122a2da29e54178c1e9452
 SHA512:
-  metadata.gz: 0571d6830e6918b940119843ad602ff2c6bdb3342f84b36b4cd3d0586269e532a21721792e174e995bcdc700e2e8daae27c12f31143d669c5cd592f308631931
-  data.tar.gz: 570d51ca03353f3b9ea61d4a988c914acf5dce042c872aa82da8243df22045211153e7431a2388c9b4ede46ec064319d2145c5c4de5626cd06518daf06a1e398
+  metadata.gz: 19cd6e9eaad5b31424cb9c2d4fc5298f9a8293ff11df5b4e202fcb1632a94db2d1398e2ae7717ab590ef2b333dd6e41f6d916da8b8e06560ce565f456bfd6d88
+  data.tar.gz: 7e2eebf97b143b321ba3cf3547e5a72e3d99367367eddc04c6456e023d88e3c1daa0f18f3a2ce513d5ff2c74d2a49a8d2bf251dae6f61ebf3e24db77979ed67e

data/lib/daytona/common/daytona.rb

@@ -69,6 +69,9 @@ module Daytona
     # @return [Integer, nil] Time to live in minutes (0 to disable)
     attr_accessor :ttl_minutes
 
+    # @return [Integer, nil] Minutes to wait for runner assignment before the API auto-destroys the sandbox
+    attr_accessor :queue_timeout
+
     # @return [Boolean, nil] Whether the Sandbox should be ephemeral
     attr_accessor :ephemeral
 
@@ -110,6 +113,7 @@ module Daytona
     #   sandbox OTel data is sent to this endpoint instead of the default collector and will not be
     #   available in the Daytona analytics API or dashboard.
     # @param ttl_minutes [Integer, nil] Time to live in minutes (0 to disable)
+    # @param queue_timeout [Integer, nil] Minutes to wait for runner assignment before the API auto-destroys the sandbox
     # @param ephemeral [Boolean, nil] Whether the Sandbox should be ephemeral
     # @param spot [Boolean, nil] GPU-only. Whether the Sandbox may be instantly terminated to free GPU
     #   capacity for an on-demand GPU Sandbox
@@ -126,6 +130,7 @@ module Daytona
       auto_archive_interval: nil,
       auto_delete_interval: nil,
       ttl_minutes: nil,
+      queue_timeout: nil,
       volumes: nil,
       secrets: nil,
       network_block_all: nil,
@@ -149,6 +154,7 @@ module Daytona
       @auto_archive_interval = auto_archive_interval
       @auto_delete_interval = auto_delete_interval
       @ttl_minutes = ttl_minutes
+      @queue_timeout = queue_timeout
       @volumes = volumes
       @secrets = secrets
       @network_block_all = network_block_all
@@ -181,6 +187,7 @@ module Daytona
         auto_archive_interval:,
         auto_delete_interval:,
         ttl_minutes:,
+        queue_timeout:,
         volumes:,
         secrets:,
         network_block_all:,
@@ -238,6 +245,7 @@ module Daytona
     # @param auto_archive_interval [Integer, nil] Auto-archive interval in minutes
     # @param auto_delete_interval [Integer, nil] Auto-delete interval in minutes
     # @param ttl_minutes [Integer, nil] Time to live in minutes (0 to disable)
+    # @param queue_timeout [Integer, nil] Minutes to wait for runner assignment before the API auto-destroys the sandbox
     # @param volumes [Array<DaytonaApiClient::SandboxVolume>, nil] List of volumes mounts to attach to the Sandbox
     # @param secrets [Hash<String, String>, nil] Organization Secrets to expose in the Sandbox, as a
     #   mapping of env var name to existing Secret name
@@ -289,6 +297,7 @@ module Daytona
     # @param auto_archive_interval [Integer, nil] Auto-archive interval in minutes
     # @param auto_delete_interval [Integer, nil] Auto-delete interval in minutes
     # @param ttl_minutes [Integer, nil] Time to live in minutes (0 to disable)
+    # @param queue_timeout [Integer, nil] Minutes to wait for runner assignment before the API auto-destroys the sandbox
     # @param volumes [Array<DaytonaApiClient::SandboxVolume>, nil] List of volumes mounts to attach to the Sandbox
     # @param secrets [Hash<String, String>, nil] Organization Secrets to expose in the Sandbox, as a
     #   mapping of env var name to existing Secret name

data/lib/daytona/common/pty.rb

@@ -65,7 +65,7 @@ module Daytona
     # @param session_id [String] Session ID of the PTY session
     # @param handle_resize [Proc, nil] Optional callback for resizing the PTY
     # @param handle_kill [Proc, nil] Optional callback for killing the PTY
-    def initialize(websocket, session_id:, handle_resize: nil, handle_kill: nil)
+    def initialize(websocket, session_id:, handle_resize: nil, handle_kill: nil) # rubocop:disable Metrics/MethodLength
       @websocket = websocket
       @session_id = session_id
       @handle_resize = handle_resize
@@ -76,7 +76,9 @@ module Daytona
       @logger = Sdk.logger
 
       @status = Status::INIT
+      @write_mutex = Mutex.new
       subscribe
+      start_keepalive
     end
 
     # Check if connected to the PTY session
@@ -108,7 +110,7 @@ module Daytona
     def send_input(input)
       raise Sdk::Error, 'PTY session not connected' unless websocket.open?
 
-      websocket.send(input)
+      @write_mutex.synchronize { websocket.send(input) }
     end
 
     # Resize the PTY terminal
@@ -168,10 +170,37 @@ module Daytona
     # Disconnect from the PTY session
     #
     # @return [void]
-    def disconnect = websocket.close
+    def disconnect
+      stop_keepalive
+      websocket.close
+    end
 
     private
 
+    # A PTY can legitimately stay silent for a long time (a build or test run with no
+    # output) and intermediate proxies/load balancers drop connections that carry no
+    # traffic. Pings keep the connection alive without injecting input into the terminal.
+    #
+    # @return [void]
+    def start_keepalive
+      @keepalive_thread = Thread.new do
+        loop do
+          sleep(KEEPALIVE_INTERVAL)
+          break unless websocket.open?
+
+          @write_mutex.synchronize { websocket.send(nil, type: :ping) }
+        end
+      rescue StandardError => e
+        logger.debug("[Websocket] keepalive stopped: #{e.inspect}")
+      end
+    end
+
+    # @return [void]
+    def stop_keepalive
+      @keepalive_thread&.kill
+      @keepalive_thread = nil
+    end
+
     # @return [Symbol]
     attr_reader :status
 
@@ -206,6 +235,7 @@ module Daytona
     def on_websocket_close(error)
       logger.debug("[Websocket] close: #{error.inspect}")
       @status = Status::CLOSED
+      stop_keepalive
     end
 
     # @param error [WebSocket::Frame::Incoming::Client]
@@ -297,6 +327,9 @@ module Daytona
     SLEEP_INTERVAL = 0.1
     private_constant :SLEEP_INTERVAL
 
+    KEEPALIVE_INTERVAL = 20.0
+    private_constant :KEEPALIVE_INTERVAL
+
     module Status
       ALL = [
         INIT = 'init',

data/lib/daytona/daytona.rb

@@ -104,7 +104,7 @@ module Daytona
     # @param params [Daytona::CreateSandboxFromSnapshotParams, Daytona::CreateSandboxFromImageParams, Nil] Sandbox creation parameters
     # @return [Daytona::Sandbox] The created sandbox
     # @raise [Daytona::Sdk::Error] If auto_stop_interval, auto_pause_interval, auto_archive_interval, or ttl_minutes is negative,
-    #   or if auto_stop_interval and auto_pause_interval are both non-zero
+    #   if queue_timeout is not a positive integer, or if auto_stop_interval and auto_pause_interval are both non-zero
     def create(params = nil, on_snapshot_create_logs: nil)
       if params.nil?
         params = CreateSandboxFromSnapshotParams.new(language: CodeLanguage::PYTHON)
@@ -249,7 +249,7 @@ module Daytona
     # @param on_snapshot_create_logs [Proc]
     # @return [Daytona::Sandbox] The created sandbox
     # @raise [Daytona::Sdk::Error] If auto_stop_interval, auto_pause_interval, auto_archive_interval, or ttl_minutes is negative,
-    #   or if auto_stop_interval and auto_pause_interval are both non-zero
+    #   if queue_timeout is not a positive integer, or if auto_stop_interval and auto_pause_interval are both non-zero
     def _create(params, timeout: 60, on_snapshot_create_logs: nil)
       raise Sdk::Error, 'Timeout must be a non-negative number' if timeout.negative?
 
@@ -274,6 +274,10 @@ module Daytona
 
       raise Sdk::Error, 'ttl_minutes must be a non-negative integer' if params.ttl_minutes&.negative?
 
+      unless params.queue_timeout.nil? || (params.queue_timeout.is_a?(Integer) && params.queue_timeout >= 1)
+        raise Sdk::Error, 'queue_timeout must be a positive integer'
+      end
+
       labels = params.labels&.dup || {}
       labels[CODE_TOOLBOX_LANGUAGE_LABEL] = params.language.to_s if params.language
 
@@ -288,6 +292,7 @@ module Daytona
         auto_archive_interval: params.auto_archive_interval,
         auto_delete_interval: params.auto_delete_interval,
         ttl_minutes: params.ttl_minutes,
+        queue_timeout: params.queue_timeout,
         volumes: params.volumes,
         secrets: params.secrets&.map { |env_var, secret_name| { env_var.to_s => secret_name.to_s } },
         network_block_all: params.network_block_all,
@@ -333,13 +338,23 @@ module Daytona
           response = sandbox_api.get_sandbox(response.id)
         end
 
-        # Get build logs URL from API
-        build_logs_response = sandbox_api.get_build_logs_url(response.id)
-        uri = URI.parse("#{build_logs_response.url}?follow=true")
+        begin
+          build_logs_response = sandbox_api.get_build_logs_url(response.id)
+          uri = URI.parse("#{build_logs_response.url}?follow=true")
+
+          headers = {}
+          sandbox_api.api_client.update_params_for_auth!(headers, nil, ['bearer'])
+          Util.stream_async(uri:, headers:, on_chunk: on_snapshot_create_logs)
+        rescue StandardError => e
+          refreshed = begin
+            sandbox_api.get_sandbox(response.id)
+          rescue StandardError
+            raise e
+          end
+          raise e unless destroyed_by_lifecycle?(refreshed)
 
-        headers = {}
-        sandbox_api.api_client.update_params_for_auth!(headers, nil, ['bearer'])
-        Util.stream_async(uri:, headers:, on_chunk: on_snapshot_create_logs)
+          response = refreshed
+        end
       end
 
       sandbox = to_sandbox(sandbox_dto: response)
@@ -395,6 +410,15 @@ module Daytona
 
     # @param sandbox_dto [DaytonaApiClient::Sandbox, DaytonaApiClient::SandboxListItem]
     # @return [Daytona::Sandbox]
+    def destroyed_by_lifecycle?(sandbox_dto)
+      if sandbox_dto.state == DaytonaApiClient::SandboxState::DESTROYED &&
+         (sandbox_dto.queue_timed_out_at || sandbox_dto.spot_evicted_at)
+        true
+      else
+        false
+      end
+    end
+
     def to_sandbox(sandbox_dto:)
       Sandbox.new(
         sandbox_dto:,

data/lib/daytona/sandbox.rb

@@ -116,6 +116,9 @@ module Daytona
     # @return [String, nil] When the sandbox was evicted by spot preemption
     attr_reader :spot_evicted_at
 
+    # @return [String, nil] When the sandbox timed out waiting in the queue for a runner
+    attr_reader :queue_timed_out_at
+
     # @return [String, nil] The GPU type assigned to the sandbox
     attr_reader :gpu_type
 
@@ -166,6 +169,9 @@ module Daytona
     # @return [String, nil] When the sandbox will be automatically destroyed (nil if no TTL is set)
     attr_reader :auto_destroy_at
 
+    # @return [Integer, nil] Minutes the sandbox may wait for runner assignment before the API auto-destroys it
+    attr_reader :queue_timeout
+
     # @return [String] The creation timestamp of the sandbox
     attr_reader :created_at
 
@@ -1111,6 +1117,7 @@ module Daytona
       @gpu = sandbox_dto.gpu
       @spot = sandbox_dto.spot || false
       @spot_evicted_at = sandbox_dto.spot_evicted_at
+      @queue_timed_out_at = sandbox_dto.queue_timed_out_at
       @gpu_type = sandbox_dto.gpu_type
       @memory = sandbox_dto.memory
       @disk = sandbox_dto.disk
@@ -1122,6 +1129,7 @@ module Daytona
       @auto_archive_interval = sandbox_dto.auto_archive_interval
       @auto_delete_interval = sandbox_dto.auto_delete_interval
       @auto_destroy_at = sandbox_dto.auto_destroy_at
+      @queue_timeout = sandbox_dto.queue_timeout
       @created_at = sandbox_dto.created_at
       @updated_at = sandbox_dto.updated_at
       @last_activity_at = sandbox_dto.last_activity_at
@@ -1245,6 +1253,7 @@ module Daytona
           first_poll = false
 
           safe_refresh ? refresh_data_safe : refresh
+          raise_destroyed_lifecycle_error_if_needed(target_strings)
 
           mutex.synchronize do
             next if result_state
@@ -1270,6 +1279,8 @@ module Daytona
         rescue StandardError
           raise e
         end
+
+        raise_destroyed_lifecycle_error_if_needed(target_strings)
         current = state.to_s
         return if target_strings.include?(current)
 
@@ -1293,6 +1304,26 @@ module Daytona
     rescue StandardError # rubocop:disable Lint/SuppressedException
     end
 
+    def raise_destroyed_lifecycle_error_if_needed(target_strings)
+      return unless state.to_s == DaytonaApiClient::SandboxState::DESTROYED.to_s
+      return if target_strings.include?(DaytonaApiClient::SandboxState::DESTROYED.to_s)
+
+      raise Sdk::QueueTimeoutError, queue_timeout_message if queue_timed_out_at
+      return unless spot_evicted_at
+
+      raise Sdk::SpotEvictedError,
+            "Sandbox #{id} was evicted by spot preemption at #{spot_evicted_at}"
+    end
+
+    def queue_timeout_message
+      waited = if queue_timeout.nil?
+                 ''
+               else
+                 " #{queue_timeout} #{queue_timeout == 1 ? 'minute' : 'minutes'}"
+               end
+      "Sandbox #{id} was destroyed after waiting#{waited} for a runner (queue timed out at #{queue_timed_out_at})"
+    end
+
     def ensure_subscribed
       @waiter_mutex.synchronize do
         return unless @subscription_manager

data/lib/daytona/sdk/errors.rb

@@ -107,6 +107,17 @@ module Daytona
     # catch the broader connection-failure category also match.
     class ConnectionTimeoutError < ConnectionError; end
 
+    # ---------------------------------------------------------------------
+    # SDK-detected sandbox lifecycle
+    # ---------------------------------------------------------------------
+
+    # Raised when a Sandbox was destroyed by the API because it waited longer
+    # than its queue timeout for a runner.
+    class QueueTimeoutError < TimeoutError; end
+
+    # Raised when a Sandbox was destroyed by spot preemption.
+    class SpotEvictedError < Error; end
+
     # ---------------------------------------------------------------------
     # Domain subclasses — each inherits from the HTTP-status parent that
     # matches its server-side status code.

data/lib/daytona/sdk/version.rb

@@ -5,6 +5,6 @@
 
 module Daytona
   module Sdk
-    VERSION = '0.218.0'
+    VERSION = '0.222.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: daytona
 version: !ruby/object:Gem::Version
-  version: 0.218.0
+  version: 0.222.0
 platform: ruby
 authors:
 - Daytona Platforms Inc.
@@ -91,42 +91,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.222.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.222.0
 - !ruby/object:Gem::Dependency
   name: daytona_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.222.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.222.0
 - !ruby/object:Gem::Dependency
   name: daytona_toolbox_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.222.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.222.0
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement