daytona 0.165.0 → 0.166.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d56e3aa79c1307df97fcf8b73d9a3a273948a92b28d84d853ee6ff74e1d1ff6
-  data.tar.gz: 25334be0faedc980f9582b52752c7124134ac5a5edd99cf5fe8ff3b7d48bdbe2
+  metadata.gz: a19065d8a53dd2a88abfa7062056867b4cc684faf401f6480ff6fa91c618311e
+  data.tar.gz: 451ace31b34a4360e70f3c5f79522c4faa0a5a3f5cd09aaf353117c2534a2953
 SHA512:
-  metadata.gz: 73d225c638a37f4f5b653bf3d9f1e838401ce12e7165cd6c08ce1df4b1b5a34f3b419a338ab2ed05bc101d290f34d517a2eb44fa6327520ea619898264c97366
-  data.tar.gz: b2bbd44eb6b91045e51b91c7614209321e0eba0a42714aee9b67affe44731435e0dce93c7db8ffc64b0e86bc9395fa19741e450585453f28be0142465e0a1cfd
+  metadata.gz: 22f3f2d140e3846532c57780774c1346c69e0575d53778e7cfda0d62cf2495d94bf79a28dd1a0c5f2779df332bc1eebf78ded0825473138b9422358638366ac1
+  data.tar.gz: 95044c2bae2db13b158e9530a83196cac9758711542733751c250791deeec5bbb4a7ba498be6482a63632c523feacd481692ee0d8b451fa784d30aea2cfc351c

data/lib/daytona/sandbox.rb

@@ -465,12 +465,59 @@ module Daytona
                                                                  DaytonaApiClient::SandboxState::DESTROYED])
     end
 
+    # Forks the Sandbox, creating a new Sandbox with an identical filesystem.
+    # The forked Sandbox is a copy-on-write clone of the original. It starts
+    # with the same disk contents but operates independently from that point on.
+    #
+    # @param name [String, nil] Optional name for the forked Sandbox
+    # @param timeout [Numeric] Maximum wait time in seconds (defaults to 60 s)
+    # @return [Daytona::Sandbox] The forked Sandbox
+    def experimental_fork(name: nil, timeout: DEFAULT_TIMEOUT) # rubocop:disable Metrics/MethodLength
+      forked_dto = nil
+      with_timeout(
+        timeout:,
+        message: "Sandbox #{id} fork failed to become ready within the #{timeout} seconds timeout period",
+        setup: proc {
+          forked_dto = sandbox_api.fork_sandbox(id, DaytonaApiClient::ForkSandbox.new(name:))
+        }
+      ) do
+        forked = Sandbox.new(
+          sandbox_dto: forked_dto,
+          config:,
+          sandbox_api:,
+          code_toolbox:,
+          otel_state:
+        )
+        forked.send(:wait_for_states, operation: OPERATION_START,
+                                      target_states: [DaytonaApiClient::SandboxState::STARTED])
+        return forked
+      end
+    end
+
+    # Creates a snapshot from the current state of the Sandbox.
+    # The Sandbox will temporarily enter a 'snapshotting' state and return to its previous state when complete.
+    #
+    # @param name [String] Name for the new snapshot
+    # @param timeout [Numeric] Maximum wait time in seconds (defaults to 60 s)
+    # @return [void]
+    def experimental_create_snapshot(name:, timeout: DEFAULT_TIMEOUT)
+      with_timeout(
+        timeout:,
+        message: "Sandbox #{id} snapshot failed within the #{timeout} seconds timeout period",
+        setup: proc {
+          sandbox_api.create_sandbox_snapshot(id, DaytonaApiClient::CreateSandboxSnapshot.new(name:))
+          refresh
+        }
+      ) { wait_for_snapshot_complete }
+    end
+
     instrument :archive, :auto_archive_interval=, :auto_delete_interval=, :auto_stop_interval=,
                :create_ssh_access, :delete, :get_user_home_dir, :get_work_dir, :labels=,
                :preview_url, :create_signed_preview_url, :expire_signed_preview_url,
                :refresh, :refresh_activity, :revoke_ssh_access, :start, :recover, :stop,
                :create_lsp_server, :validate_ssh_access, :wait_for_sandbox_start,
                :wait_for_sandbox_stop, :resize, :wait_for_resize_complete,
+               :experimental_fork, :experimental_create_snapshot,
                component: 'Sandbox'
 
     private
@@ -593,5 +640,25 @@ module Daytona
 
     OPERATION_RESIZE = :resize
     private_constant :OPERATION_RESIZE
+
+    def wait_for_snapshot_complete
+      interval = INITIAL_POLL_INTERVAL
+      start_time = ::Process.clock_gettime(::Process::CLOCK_MONOTONIC)
+      while state == DaytonaApiClient::SandboxState::SNAPSHOTTING
+        refresh
+
+        if [DaytonaApiClient::SandboxState::ERROR, DaytonaApiClient::SandboxState::BUILD_FAILED].include?(state)
+          raise Sdk::Error,
+                "Sandbox #{id} snapshot failed with state: #{state}, error reason: #{error_reason}"
+        end
+
+        break if state != DaytonaApiClient::SandboxState::SNAPSHOTTING
+
+        sleep(interval)
+        if ::Process.clock_gettime(::Process::CLOCK_MONOTONIC) - start_time > 5
+          interval = [interval * BACKOFF_MULTIPLIER, MAX_POLL_INTERVAL].min
+        end
+      end
+    end
   end
 end

data/lib/daytona/sdk/version.rb

@@ -2,6 +2,6 @@
 
 module Daytona
   module Sdk
-    VERSION = '0.165.0'
+    VERSION = '0.166.0'
   end
 end

metadata

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