daytona 0.217.0 → 0.220.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 234455e03a95507727b6e1ba8ca933aae0e5c53eb406a5fff4bc051f5f5cb5c9
-  data.tar.gz: bab2f5ee3e382488f213ff032fb8a3f270f25df077558083e3859e865b9b2b95
+  metadata.gz: 6c916e09a640a2761766f1a78652af5821f19a1a123e819844372d87651ca7fc
+  data.tar.gz: 486825b3ac58633a87e865a51ad51cdfc42f8bcd1a50f336b83cd43f90aa2856
 SHA512:
-  metadata.gz: a404264dccacf27a09c4e176e08baa625e55e66af8979622844b948ecc7b3a0ec7bb380caecfaa46eeb4e4b5ccec6782590bb4fc4ab5f34959283f502ba51574
-  data.tar.gz: 5849c58ff779775f1a017c099c6d104c4ec99774089c9fe8c10904d7b25eb76cb03918a9f10bc7e9f2476d4be5fdf147cd90b7e2c2856c6ca6fd2624adc08ab1
+  metadata.gz: 83c22f64c8aaaf2522945b4fdd7ee1ac6f8fd6f96657027f0e445428ec1907cce96f0f112caee3213ac653ad88a8bca701b0447ce6851451438dca5b834b0576
+  data.tar.gz: 7db19827791d02beea4c549c6f53aaa85748504056027f5c0636caaf86a87c18f1017e9ce0c761e1f644da3b30a39dc988c3f09691dea14ee138fe1b834c17f6

data/lib/daytona/common/daytona.rb

@@ -50,6 +50,10 @@ module Daytona
     # @return [Boolean, nil] Whether to block all network access for the Sandbox
     attr_accessor :network_block_all
 
+    # @return [Boolean, nil] Expose KVM (/dev/kvm) inside the sandbox via nested virtualization.
+    #   linux-vm snapshots only. Requires the sandbox_kvm feature for the organization.
+    attr_accessor :kvm
+
     # @return [String, nil] Comma-separated list of allowed CIDR network addresses for the Sandbox
     attr_accessor :network_allow_list
 
@@ -65,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
 
@@ -95,6 +102,8 @@ module Daytona
     # @param secrets [Hash<String, String>, nil] Organization Secrets to expose in the Sandbox, as a
     #   mapping of env var name to existing Secret name
     # @param network_block_all [Boolean, nil] Whether to block all network access for the Sandbox
+    # @param kvm [Boolean, nil] Expose KVM (/dev/kvm) inside the sandbox via nested virtualization.
+    #   linux-vm snapshots only. Requires the sandbox_kvm feature for the organization.
     # @param network_allow_list [String, nil] Comma-separated list of allowed CIDR network addresses for the Sandbox
     # @param domain_allow_list [String, nil] Comma-separated list of allowed domains for the Sandbox
     # @param outbound_proxy_url [String, nil] Outbound proxy URL to route the Sandbox HTTP(S) traffic through.
@@ -104,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
@@ -120,9 +130,11 @@ module Daytona
       auto_archive_interval: nil,
       auto_delete_interval: nil,
       ttl_minutes: nil,
+      queue_timeout: nil,
       volumes: nil,
       secrets: nil,
       network_block_all: nil,
+      kvm: nil,
       network_allow_list: nil,
       domain_allow_list: nil,
       outbound_proxy_url: nil,
@@ -142,9 +154,11 @@ 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
+      @kvm = kvm
       @network_allow_list = network_allow_list
       @domain_allow_list = domain_allow_list
       @outbound_proxy_url = outbound_proxy_url
@@ -173,9 +187,11 @@ module Daytona
         auto_archive_interval:,
         auto_delete_interval:,
         ttl_minutes:,
+        queue_timeout:,
         volumes:,
         secrets:,
         network_block_all:,
+        kvm:,
         network_allow_list:,
         domain_allow_list:,
         outbound_proxy_url:,
@@ -229,10 +245,13 @@ 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
     # @param network_block_all [Boolean, nil] Whether to block all network access for the Sandbox
+    # @param kvm [Boolean, nil] Expose KVM (/dev/kvm) inside the sandbox via nested virtualization.
+    #   linux-vm snapshots only. Requires the sandbox_kvm feature for the organization.
     # @param network_allow_list [String, nil] Comma-separated list of allowed CIDR network addresses for the Sandbox
     # @param domain_allow_list [String, nil] Comma-separated list of allowed domains for the Sandbox
     # @param outbound_proxy_url [String, nil] Outbound proxy URL to route the Sandbox HTTP(S) traffic through.
@@ -278,10 +297,13 @@ 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
     # @param network_block_all [Boolean, nil] Whether to block all network access for the Sandbox
+    # @param kvm [Boolean, nil] Expose KVM (/dev/kvm) inside the sandbox via nested virtualization.
+    #   linux-vm snapshots only. Requires the sandbox_kvm feature for the organization.
     # @param network_allow_list [String, nil] Comma-separated list of allowed CIDR network addresses for the Sandbox
     # @param domain_allow_list [String, nil] Comma-separated list of allowed domains for the Sandbox
     # @param outbound_proxy_url [String, nil] Outbound proxy URL to route the Sandbox HTTP(S) traffic through.

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,9 +292,11 @@ 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,
+        kvm: params.kvm,
         network_allow_list: params.network_allow_list,
         domain_allow_list: params.domain_allow_list,
         outbound_proxy_url: params.outbound_proxy_url,
@@ -332,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)
@@ -394,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

@@ -80,6 +80,10 @@ module Daytona
     #   Not returned by list results; call #refresh on each item to populate.
     attr_reader :network_block_all
 
+    # @return [Boolean, nil] Whether the sandbox exposes KVM (/dev/kvm) to its guest.
+    #   Not returned by list results; call #refresh on each item to populate.
+    attr_reader :kvm
+
     # @return [String, nil] Comma-separated list of allowed CIDR network addresses for the sandbox.
     #   Not returned by list results; call #refresh on each item to populate.
     attr_reader :network_allow_list
@@ -112,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
 
@@ -162,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
 
@@ -1107,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
@@ -1118,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
@@ -1136,6 +1148,7 @@ module Daytona
       if sandbox_dto.is_a?(DaytonaApiClient::Sandbox)
         @env = sandbox_dto.env
         @network_block_all = sandbox_dto.network_block_all
+        @kvm = sandbox_dto.kvm
         @network_allow_list = sandbox_dto.network_allow_list
         @domain_allow_list = sandbox_dto.domain_allow_list
         @outbound_proxy_url = sandbox_dto.outbound_proxy_url
@@ -1240,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
@@ -1265,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)
 
@@ -1288,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.217.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.217.0
+  version: 0.220.0
 platform: ruby
 authors:
 - Daytona Platforms Inc.
@@ -91,42 +91,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.217.0
+        version: 0.220.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.217.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.217.0
+        version: 0.220.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.217.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.217.0
+        version: 0.220.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.217.0
+        version: 0.220.0
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement