daytona 0.218.0 → 0.220.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8e213814357ddef2964bbb51dd2bc1639961337e6ec59e06dba8144d905aa4f
-  data.tar.gz: a924ea5a93b4e0d0366e4758135bcd96685eb095ba2bfbd32efa414d6e6a17c0
+  metadata.gz: 6c916e09a640a2761766f1a78652af5821f19a1a123e819844372d87651ca7fc
+  data.tar.gz: 486825b3ac58633a87e865a51ad51cdfc42f8bcd1a50f336b83cd43f90aa2856
 SHA512:
-  metadata.gz: 0571d6830e6918b940119843ad602ff2c6bdb3342f84b36b4cd3d0586269e532a21721792e174e995bcdc700e2e8daae27c12f31143d669c5cd592f308631931
-  data.tar.gz: 570d51ca03353f3b9ea61d4a988c914acf5dce042c872aa82da8243df22045211153e7431a2388c9b4ede46ec064319d2145c5c4de5626cd06518daf06a1e398
+  metadata.gz: 83c22f64c8aaaf2522945b4fdd7ee1ac6f8fd6f96657027f0e445428ec1907cce96f0f112caee3213ac653ad88a8bca701b0447ce6851451438dca5b834b0576
+  data.tar.gz: 7db19827791d02beea4c549c6f53aaa85748504056027f5c0636caaf86a87c18f1017e9ce0c761e1f644da3b30a39dc988c3f09691dea14ee138fe1b834c17f6

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/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.220.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.220.0
 platform: ruby
 authors:
 - Daytona Platforms Inc.
@@ -91,42 +91,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.220.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.220.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.220.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.220.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.220.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.218.0
+        version: 0.220.0
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement