daytona 0.204.0 → 0.205.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9262546e49c3718967e3a0300303d4a29307bf48e05d3858adbbd64ed3c5476
-  data.tar.gz: f7292a5cb930340df80595e497782a28fab1beb9bb3bbb5b8147a52ed8a4c952
+  metadata.gz: ba9a97a7af09b8d505de9b5d107a764c5e150e21c5b336bd732f5ff8d98341cb
+  data.tar.gz: 22057c0b0bd750faa8403fed0b52716ff423d0223cbfc8059935a412bc127f2f
 SHA512:
-  metadata.gz: 5ea724b9fd64d2efc919c764b7236b008e4eeda909b1796d0c05b91e31085cc379fe7a8215949ec1d0f8de40851a045edffd9aaabdfa13767d2346567876ef18
-  data.tar.gz: 44b45171c7a2d21e1060c52f85ef90a9379d10ddaeaf5bd4b66ecd3dd097ba6cfe1b67ec86e8feb00cdd96bd25853ef82e8bcd35b53db3e395fcc39b04199420
+  metadata.gz: e66d5b8c8a2b3e11468840705f4bbc8c199ece6639047c9cbab4e0c69981740a413f474ea1a18b3162963e5c599aced27878f963899b4f890094f51000baa885
+  data.tar.gz: 888b3b55cdaded8230e1662816eb4b8bea4541737025da1796d997cd619d1438b6108d138a6e09f19fe0956e37d6c3a2ff47bf5ea55289184c97d703ea18a252

data/lib/daytona/common/daytona.rb

@@ -59,12 +59,20 @@ module Daytona
     # @return [String, nil] Outbound proxy URL to route the Sandbox HTTP(S) traffic through
     attr_accessor :outbound_proxy_url
 
+    # @return [String, nil] OTel collector endpoint override for the Sandbox
+    attr_accessor :otel_endpoint_override
+
     # @return [Integer, nil] Time to live in minutes (0 to disable)
     attr_accessor :ttl_minutes
 
     # @return [Boolean, nil] Whether the Sandbox should be ephemeral
     attr_accessor :ephemeral
 
+    # @return [Boolean, nil] GPU-only. When true, the Sandbox may be instantly terminated without notice
+    #   to free GPU capacity for an on-demand (non-spot) GPU Sandbox. Rejected when the Sandbox
+    #   requests no GPUs.
+    attr_accessor :spot
+
     # @return [String, nil] ID or name of an existing Sandbox to link the new Sandbox to. The new
     #   Sandbox will be scheduled on the same runner as the linked Sandbox so a local network can be
     #   established between them. Linked Sandboxes must be
@@ -92,8 +100,13 @@ module Daytona
     # @param outbound_proxy_url [String, nil] Outbound proxy URL to route the Sandbox HTTP(S) traffic through.
     #   Applied via the HTTP(S)_PROXY environment variables; combine with domain_allow_list for
     #   network-layer enforcement.
+    # @param otel_endpoint_override [String, nil] OTel collector endpoint override for the Sandbox. When set,
+    #   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 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
     # @param linked_sandbox [String, nil] ID or name of an existing Sandbox to link the new Sandbox to
     def initialize( # rubocop:disable Metrics/MethodLength, Metrics/ParameterLists
       language: nil,
@@ -113,7 +126,9 @@ module Daytona
       network_allow_list: nil,
       domain_allow_list: nil,
       outbound_proxy_url: nil,
+      otel_endpoint_override: nil,
       ephemeral: nil,
+      spot: nil,
       linked_sandbox: nil
     )
       @language = language
@@ -133,7 +148,9 @@ module Daytona
       @network_allow_list = network_allow_list
       @domain_allow_list = domain_allow_list
       @outbound_proxy_url = outbound_proxy_url
+      @otel_endpoint_override = otel_endpoint_override
       @ephemeral = ephemeral
+      @spot = spot
       @linked_sandbox = linked_sandbox
 
       # Handle ephemeral and auto_delete_interval conflict
@@ -162,7 +179,9 @@ module Daytona
         network_allow_list:,
         domain_allow_list:,
         outbound_proxy_url:,
+        otel_endpoint_override:,
         ephemeral:,
+        spot:,
         linked_sandbox:
       }.compact
     end
@@ -219,6 +238,9 @@ module Daytona
     # @param outbound_proxy_url [String, nil] Outbound proxy URL to route the Sandbox HTTP(S) traffic through.
     #   Applied via the HTTP(S)_PROXY environment variables; combine with domain_allow_list for
     #   network-layer enforcement.
+    # @param otel_endpoint_override [String, nil] OTel collector endpoint override for the Sandbox. When set,
+    #   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 ephemeral [Boolean, nil] Whether the Sandbox should be ephemeral
     def initialize(image:, resources: nil, **args)
       @image = image
@@ -265,6 +287,9 @@ module Daytona
     # @param outbound_proxy_url [String, nil] Outbound proxy URL to route the Sandbox HTTP(S) traffic through.
     #   Applied via the HTTP(S)_PROXY environment variables; combine with domain_allow_list for
     #   network-layer enforcement.
+    # @param otel_endpoint_override [String, nil] OTel collector endpoint override for the Sandbox. When set,
+    #   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 ephemeral [Boolean, nil] Whether the Sandbox should be ephemeral
     def initialize(snapshot: nil, **args)
       @snapshot = snapshot

data/lib/daytona/daytona.rb

@@ -25,6 +25,9 @@ module Daytona
     # @return [Daytona::SecretService]
     attr_reader :secret
 
+    # @return [Daytona::WarmPoolService]
+    attr_reader :warm_pool
+
     # @return [DaytonaApiClient::ObjectStorageApi]
     attr_reader :object_storage_api
 
@@ -53,6 +56,7 @@ module Daytona
       @analytics_api_url_mutex = Mutex.new
       @volume = VolumeService.new(DaytonaApiClient::VolumesApi.new(api_client), otel_state:)
       @secret = SecretService.new(DaytonaApiClient::SecretApi.new(api_client), otel_state:)
+      @warm_pool = WarmPoolService.new(DaytonaApiClient::WarmPoolsApi.new(api_client), otel_state:)
       @object_storage_api = DaytonaApiClient::ObjectStorageApi.new(api_client)
       @snapshots_api = DaytonaApiClient::SnapshotsApi.new(api_client)
       @snapshot = SnapshotService.new(
@@ -290,7 +294,9 @@ module Daytona
         network_allow_list: params.network_allow_list,
         domain_allow_list: params.domain_allow_list,
         outbound_proxy_url: params.outbound_proxy_url,
-        linked_sandbox: params.linked_sandbox
+        otel_endpoint_override: params.otel_endpoint_override,
+        linked_sandbox: params.linked_sandbox,
+        spot: params.spot
       )
 
       create_sandbox.snapshot = params.snapshot if params.respond_to?(:snapshot)

data/lib/daytona/sandbox.rb

@@ -101,6 +101,13 @@ module Daytona
     # @return [Float] The GPU quota for the sandbox
     attr_reader :gpu
 
+    # @return [Boolean] Whether this is a spot GPU sandbox. Spot sandboxes may be instantly terminated
+    #   to free capacity for on-demand GPU sandboxes.
+    attr_reader :spot
+
+    # @return [String, nil] When the sandbox was evicted by spot preemption
+    attr_reader :spot_evicted_at
+
     # @return [Float] The memory quota for the sandbox
     attr_reader :memory
 
@@ -1085,6 +1092,8 @@ module Daytona
       @target = sandbox_dto.target
       @cpu = sandbox_dto.cpu
       @gpu = sandbox_dto.gpu
+      @spot = sandbox_dto.spot || false
+      @spot_evicted_at = sandbox_dto.spot_evicted_at
       @memory = sandbox_dto.memory
       @disk = sandbox_dto.disk
       @desired_state = sandbox_dto.desired_state

data/lib/daytona/sdk/version.rb

@@ -5,6 +5,6 @@
 
 module Daytona
   module Sdk
-    VERSION = '0.204.0'
+    VERSION = '0.205.0'
   end
 end

data/lib/daytona/sdk.rb

@@ -47,6 +47,8 @@ require_relative 'snapshot_service'
 require_relative 'util'
 require_relative 'volume'
 require_relative 'volume_service'
+require_relative 'warm_pool'
+require_relative 'warm_pool_service'
 require_relative 'process'
 
 module Daytona

data/lib/daytona/warm_pool.rb

@@ -0,0 +1,75 @@
+# Copyright Daytona Platforms Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+# frozen_string_literal: true
+
+module Daytona
+  # A warm pool of ready-to-use Sandboxes for a snapshot. `current_size` versus
+  # `pool` is the pool's status: `current_size` is the number of ready warm
+  # sandboxes, `pool` is the desired number. `error_reason` is set when the
+  # pool cannot be filled.
+  class WarmPool
+    # @return [String]
+    attr_reader :id
+
+    # @return [String]
+    attr_reader :organization_id
+
+    # @return [String]
+    attr_reader :snapshot
+
+    # @return [String]
+    attr_reader :target
+
+    # @return [Integer]
+    attr_reader :pool
+
+    # @return [Integer]
+    attr_reader :current_size
+
+    # @return [Integer]
+    attr_reader :cpu
+
+    # @return [Integer]
+    attr_reader :mem
+
+    # @return [Integer]
+    attr_reader :disk
+
+    # @return [String]
+    attr_reader :os_user
+
+    # @return [Hash{String => String}]
+    attr_reader :env
+
+    # @return [String, nil]
+    attr_reader :error_reason
+
+    # @return [String]
+    attr_reader :created_at
+
+    # @return [String]
+    attr_reader :updated_at
+
+    # Initialize warm pool from DTO
+    #
+    # @param warm_pool_dto [DaytonaApiClient::WarmPool]
+    def initialize(warm_pool_dto)
+      @id = warm_pool_dto.id
+      @organization_id = warm_pool_dto.organization_id
+      @snapshot = warm_pool_dto.snapshot
+      @target = warm_pool_dto.target
+      # The generated client deserializes OpenAPI numbers as Float; these are all integral.
+      @pool = warm_pool_dto.pool.to_i
+      @current_size = warm_pool_dto.current_size.to_i
+      @cpu = warm_pool_dto.cpu.to_i
+      @mem = warm_pool_dto.mem.to_i
+      @disk = warm_pool_dto.disk.to_i
+      @os_user = warm_pool_dto.os_user
+      @env = warm_pool_dto.env
+      @error_reason = warm_pool_dto.error_reason
+      @created_at = warm_pool_dto.created_at
+      @updated_at = warm_pool_dto.updated_at
+    end
+  end
+end

data/lib/daytona/warm_pool_service.rb

@@ -0,0 +1,61 @@
+# Copyright Daytona Platforms Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+# frozen_string_literal: true
+
+module Daytona
+  class WarmPoolService
+    include Instrumentation
+
+    # Service for managing Daytona Warm Pools. Can be used to list, create, update and delete Warm Pools.
+    #
+    # @param warm_pools_api [DaytonaApiClient::WarmPoolsApi]
+    # @param otel_state [Daytona::OtelState, nil]
+    def initialize(warm_pools_api, otel_state: nil)
+      @warm_pools_api = warm_pools_api
+      @otel_state = otel_state
+    end
+
+    # Create a new Warm Pool.
+    #
+    # @param snapshot [String] The snapshot (ID or name) to keep warm sandboxes for
+    # @param pool [Integer] Number of warm sandboxes to keep ready
+    # @param target [String, nil] Target region; defaults to the organization default region
+    # @return [Daytona::WarmPool]
+    def create(snapshot, pool, target: nil)
+      WarmPool.new(warm_pools_api.create_warm_pool(DaytonaApiClient::CreateWarmPool.new(snapshot:, pool:, target:)))
+    end
+
+    # Delete a Warm Pool.
+    #
+    # @param warm_pool_id [String]
+    # @return [void]
+    def delete(warm_pool_id) = warm_pools_api.delete_warm_pool(warm_pool_id)
+
+    # List all Warm Pools.
+    #
+    # @return [Array<Daytona::WarmPool>]
+    def list
+      warm_pools_api.list_warm_pools.map { |warm_pool| WarmPool.new(warm_pool) }
+    end
+
+    # Update the desired size of a Warm Pool.
+    #
+    # @param warm_pool_id [String]
+    # @param pool [Integer] New desired number of warm sandboxes (0 drains the pool)
+    # @return [Daytona::WarmPool]
+    def update(warm_pool_id, pool)
+      WarmPool.new(warm_pools_api.update_warm_pool(warm_pool_id, DaytonaApiClient::UpdateWarmPool.new(pool:)))
+    end
+
+    instrument :create, :delete, :list, :update, component: 'WarmPoolService'
+
+    private
+
+    # @return [DaytonaApiClient::WarmPoolsApi]
+    attr_reader :warm_pools_api
+
+    # @return [Daytona::OtelState, nil]
+    attr_reader :otel_state
+  end
+end

data/project.json

@@ -92,7 +92,7 @@
       "dependsOn": [
         {
           "target": "publish",
-          "projects": ["api-client-ruby", "toolbox-api-client-ruby", "analytics-api-client-ruby"]
+          "projects": ["analytics-api-client-ruby"]
         },
         "build"
       ]

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: daytona
 version: !ruby/object:Gem::Version
-  version: 0.204.0
+  version: 0.205.0
 platform: ruby
 authors:
 - Daytona Platforms Inc.
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 1980-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-exporter-otlp
@@ -85,42 +85,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.204.0
+        version: 0.205.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.204.0
+        version: 0.205.0
 - !ruby/object:Gem::Dependency
   name: daytona_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.204.0
+        version: 0.205.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.204.0
+        version: 0.205.0
 - !ruby/object:Gem::Dependency
   name: daytona_toolbox_api_client
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.204.0
+        version: 0.205.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.204.0
+        version: 0.205.0
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement
@@ -238,6 +238,8 @@ files:
 - lib/daytona/utils/file_url_signing.rb
 - lib/daytona/volume.rb
 - lib/daytona/volume_service.rb
+- lib/daytona/warm_pool.rb
+- lib/daytona/warm_pool_service.rb
 - project.json
 - scripts/generate-docs.rb
 - sig/daytona/sdk.rbs
@@ -264,7 +266,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Ruby SDK for Daytona
 test_files: []