hatchet-sdk 0.2.0 → 0.3.0

data/sig/hatchet/durable_context.rbs

@@ -1,7 +1,13 @@
 module Hatchet
   class DurableContext < Context
-    def sleep_for: (duration: Integer | String) -> Hash[String, untyped]?
-    def wait_for: (String key, untyped condition) -> Hash[String, untyped]
+    attr_accessor eviction_manager: WorkerRuntime::DurableEviction::DurableEvictionManager?
+    attr_accessor action_key: String?
+    attr_accessor durable_event_listener: WorkerRuntime::DurableEventListener?
+    attr_accessor invocation_count: Integer?
+    attr_accessor engine_version: String?
+
+    def sleep_for: (duration: Integer | String, ?label: String?) -> Hash[String, untyped]?
+    def wait_for: (String key, untyped condition, ?label: String?) -> Hash[String, untyped]
 
     private
 

data/sig/hatchet/engine_version.rbs

@@ -0,0 +1,12 @@
+module Hatchet
+  module MinEngineVersion
+    SLOT_CONFIG: String
+    DURABLE_EVICTION: String
+    OBSERVABILITY: String
+  end
+
+  module EngineVersion
+    def self.parse_semver: (String? version) -> [Integer, Integer, Integer]
+    def self.semver_less_than: (String? a, String? b) -> bool
+  end
+end

data/sig/hatchet/eviction_policy.rbs

@@ -0,0 +1,14 @@
+module Hatchet
+  class EvictionPolicy
+    attr_reader ttl: Numeric?
+    attr_reader allow_capacity_eviction: bool
+    attr_reader priority: Integer
+
+    def initialize: (ttl: Numeric?, ?allow_capacity_eviction: bool, ?priority: Integer) -> void
+    def ==: (untyped other) -> bool
+    def eql?: (untyped other) -> bool
+    def hash: () -> Integer
+  end
+
+  DEFAULT_DURABLE_TASK_EVICTION_POLICY: EvictionPolicy
+end

data/sig/hatchet/exceptions.rbs

@@ -23,4 +23,16 @@ module Hatchet
 
     def initialize: (Array[TaskRunError] exceptions) -> void
   end
+
+  class NonDeterminismError < Error
+    attr_reader task_external_id: String?
+    attr_reader invocation_count: Integer?
+    attr_reader node_id: Integer?
+
+    def initialize: (String message, ?task_external_id: String?, ?invocation_count: Integer?, ?node_id: Integer?) -> void
+  end
+
+  class DurableTaskEvictedError < Error
+    def initialize: (?String message) -> void
+  end
 end

data/sig/hatchet/task.rbs

@@ -13,6 +13,7 @@ module Hatchet
     attr_reader wait_for: Array[untyped]
     attr_reader skip_if: Array[untyped]
     attr_reader durable: bool
+    attr_reader eviction_policy: EvictionPolicy?
     attr_reader fn: Proc?
     attr_reader workflow: Workflow?
     attr_reader client: Client?
@@ -32,6 +33,7 @@ module Hatchet
       ?wait_for: Array[untyped],
       ?skip_if: Array[untyped],
       ?durable: bool,
+      ?eviction_policy: EvictionPolicy?,
       ?workflow: Workflow?,
       ?client: Client?,
       ?deps: Hash[Symbol, Proc]?

data/sig/hatchet/worker/durable_event_listener.rbs

@@ -0,0 +1,31 @@
+module Hatchet
+  module WorkerRuntime
+    class DurableEventListener
+      DEFAULT_RECONNECT_INTERVAL: Integer
+      EVICTION_ACK_TIMEOUT_SECONDS: Float
+
+      class WaitForEvent < Struct[untyped]
+        attr_accessor wait_for_conditions: untyped
+        attr_accessor label: String?
+      end
+
+      class MemoEvent < Struct[untyped]
+        attr_accessor memo_key: String
+        attr_accessor result: String?
+      end
+
+      attr_reader worker_id: String?
+
+      def initialize: (config: Config, channel: untyped, logger: Logger, ?on_server_evict: Proc?) -> void
+      def start: (String worker_id) -> void
+      def ensure_started: (String worker_id) -> void
+      def stop: () -> void
+      def send_event: (String durable_task_external_id, Integer invocation_count, (WaitForEvent | MemoEvent) event) -> untyped
+      def wait_for_callback: (String durable_task_external_id, Integer invocation_count, Integer branch_id, Integer node_id) -> Hash[Symbol, untyped]
+      def send_evict_invocation: (String durable_task_external_id, Integer invocation_count, ?reason: String?) -> void
+      def send_memo_completed_notification: (durable_task_external_id: String, node_id: Integer, branch_id: Integer, invocation_count: Integer, memo_key: String, memo_result_payload: String) -> void
+      def cleanup_task_state: (String durable_task_external_id, Integer invocation_count) -> void
+      def handle_response_for_test: (untyped response) -> void
+    end
+  end
+end

data/sig/hatchet/worker/durable_eviction/cache.rbs

@@ -0,0 +1,41 @@
+module Hatchet
+  module WorkerRuntime
+    module DurableEviction
+      module EvictionCause
+        TTL_EXCEEDED: Symbol
+        CAPACITY_PRESSURE: Symbol
+        WORKER_SHUTDOWN: Symbol
+      end
+
+      class DurableRunRecord
+        attr_reader key: String
+        attr_reader step_run_id: String
+        attr_reader invocation_count: Integer
+        attr_reader eviction_policy: EvictionPolicy?
+        attr_reader registered_at: Time
+        attr_accessor waiting_since: Time?
+        attr_accessor wait_kind: String?
+        attr_accessor wait_resource_id: String?
+        attr_accessor eviction_reason: String?
+        attr_accessor wait_count: Integer
+
+        def initialize: (key: String, step_run_id: String, invocation_count: Integer, eviction_policy: EvictionPolicy?, registered_at: Time) -> void
+        def waiting?: () -> bool
+      end
+
+      class DurableEvictionCache
+        def initialize: () -> void
+        def register_run: (String key, step_run_id: String, invocation_count: Integer, now: Time, eviction_policy: EvictionPolicy?) -> void
+        def unregister_run: (String key) -> void
+        def get: (String key) -> DurableRunRecord?
+        def all_waiting: () -> Array[DurableRunRecord]
+        def find_key_by_step_run_id: (String step_run_id) -> String?
+        def mark_waiting: (String key, now: Time, wait_kind: String, resource_id: String) -> void
+        def mark_active: (String key, now: Time) -> void
+        def select_eviction_candidate: (now: Time, durable_slots: Integer, reserve_slots: Integer, min_wait_for_capacity_eviction: Numeric) -> String?
+
+        def self.build_eviction_reason: (Symbol cause, DurableRunRecord rec, ?ttl: Numeric?) -> String
+      end
+    end
+  end
+end

data/sig/hatchet/worker/durable_eviction/manager.rbs

@@ -0,0 +1,37 @@
+module Hatchet
+  module WorkerRuntime
+    module DurableEviction
+      class DurableEvictionConfig
+        attr_reader check_interval: Float
+        attr_reader reserve_slots: Integer
+        attr_reader min_wait_for_capacity_eviction: Float
+
+        def initialize: (?check_interval: Float, ?reserve_slots: Integer, ?min_wait_for_capacity_eviction: Float) -> void
+      end
+
+      DEFAULT_DURABLE_EVICTION_CONFIG: DurableEvictionConfig
+
+      class DurableEvictionManager
+        attr_reader cache: DurableEvictionCache
+
+        def initialize: (
+          durable_slots: Integer,
+          cancel_local: Proc,
+          request_eviction_with_ack: Proc,
+          ?config: DurableEvictionConfig,
+          ?cache: DurableEvictionCache?,
+          ?logger: Logger?
+        ) -> void
+
+        def start: () -> void
+        def stop: () -> void
+        def register_run: (String key, step_run_id: String, invocation_count: Integer, eviction_policy: EvictionPolicy?) -> void
+        def unregister_run: (String key) -> void
+        def mark_waiting: (String key, wait_kind: String, resource_id: String) -> void
+        def mark_active: (String key) -> void
+        def handle_server_eviction: (String step_run_id, Integer invocation_count) -> void
+        def evict_all_waiting: () -> Integer
+      end
+    end
+  end
+end

data/sig/hatchet/worker/runner.rbs

@@ -1,13 +1,19 @@
 module Hatchet
   module WorkerRuntime
     class Runner
+      attr_reader eviction_manager: DurableEviction::DurableEvictionManager?
+      attr_reader durable_event_listener: DurableEventListener?
+
       def initialize: (
         workflows: Array[Workflow | Task],
         slots: Integer,
         dispatcher_client: Clients::Grpc::Dispatcher,
         event_client: Clients::Grpc::EventClient,
         logger: Logger,
-        client: Client
+        client: Client,
+        ?engine_version: String?,
+        ?durable_slots: Integer?,
+        ?worker_id: String?
       ) -> void
 
       def execute: (untyped action) -> void

data/sig/hatchet/worker_obj.rbs

@@ -6,12 +6,15 @@ module Hatchet
     attr_reader labels: Hash[String, String | Integer]
     attr_reader client: Client
     attr_accessor worker_id: String?
+    attr_reader durable_slots: Integer
+    attr_reader engine_version: String?
 
     def initialize: (
       name: String,
       client: Client,
       ?workflows: Array[Workflow | Task],
       ?slots: Integer,
+      ?durable_slots: Integer?,
       ?labels: Hash[String, String | Integer]
     ) -> void
 

data/sig/hatchet/workflow.rbs

@@ -27,7 +27,7 @@ module Hatchet
     ) -> void
 
     def task: (Symbol | String name, **untyped opts) { (Hash[String, untyped], Context) -> untyped } -> Task
-    def durable_task: (Symbol | String name, **untyped opts) { (Hash[String, untyped], DurableContext) -> untyped } -> Task
+    def durable_task: (Symbol | String name, ?eviction_policy: EvictionPolicy?, **untyped opts) { (Hash[String, untyped], DurableContext) -> untyped } -> Task
     def on_failure_task: (**untyped opts) { (Hash[String, untyped], Context) -> untyped } -> Task
     def on_success_task: (**untyped opts) { (Hash[String, untyped], Context) -> untyped } -> Task
     def to_proto: (Config config) -> untyped

data/sig/hatchet-sdk.rbs

@@ -40,7 +40,7 @@ module Hatchet
 
     def workflow: (name: String, **untyped opts) -> Workflow
     def task: (name: String, **untyped opts) { (Hash[String, untyped], Context) -> untyped } -> Task
-    def durable_task: (name: String, **untyped opts) { (Hash[String, untyped], DurableContext) -> untyped } -> Task
+    def durable_task: (name: String, ?eviction_policy: EvictionPolicy?, **untyped opts) { (Hash[String, untyped], DurableContext) -> untyped } -> Task
     def worker: (String name, **untyped opts) -> Worker
 
     def logger: () -> Logger

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hatchet-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - gabriel ruttner
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-04 00:00:00.000000000 Z
+date: 2026-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -142,14 +142,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.13'
 description: The official Ruby SDK for Hatchet, a distributed, fault-tolerant task
   orchestration engine. Easily integrate Hatchet's task scheduling and workflow orchestration
   capabilities into your Ruby applications.
@@ -450,12 +450,15 @@ files:
 - lib/hatchet/contracts/v1/dispatcher_pb.rb
 - lib/hatchet/contracts/v1/dispatcher_services_pb.rb
 - lib/hatchet/contracts/v1/shared/condition_pb.rb
+- lib/hatchet/contracts/v1/shared/trigger_pb.rb
 - lib/hatchet/contracts/v1/workflows_pb.rb
 - lib/hatchet/contracts/v1/workflows_services_pb.rb
 - lib/hatchet/contracts/workflows/workflows_pb.rb
 - lib/hatchet/contracts/workflows/workflows_services_pb.rb
 - lib/hatchet/default_filter.rb
 - lib/hatchet/durable_context.rb
+- lib/hatchet/engine_version.rb
+- lib/hatchet/eviction_policy.rb
 - lib/hatchet/exceptions.rb
 - lib/hatchet/features/cel.rb
 - lib/hatchet/features/cron.rb
@@ -475,6 +478,9 @@ files:
 - lib/hatchet/trigger_options.rb
 - lib/hatchet/version.rb
 - lib/hatchet/worker/action_listener.rb
+- lib/hatchet/worker/durable_event_listener.rb
+- lib/hatchet/worker/durable_eviction/cache.rb
+- lib/hatchet/worker/durable_eviction/manager.rb
 - lib/hatchet/worker/health_check.rb
 - lib/hatchet/worker/runner.rb
 - lib/hatchet/worker/workflow_run_listener.rb
@@ -498,6 +504,8 @@ files:
 - sig/hatchet/context_vars.rbs
 - sig/hatchet/default_filter.rbs
 - sig/hatchet/durable_context.rbs
+- sig/hatchet/engine_version.rbs
+- sig/hatchet/eviction_policy.rbs
 - sig/hatchet/exceptions.rbs
 - sig/hatchet/features/cel.rbs
 - sig/hatchet/features/cron.rbs
@@ -517,6 +525,9 @@ files:
 - sig/hatchet/trigger_options.rbs
 - sig/hatchet/version.rbs
 - sig/hatchet/worker/action_listener.rbs
+- sig/hatchet/worker/durable_event_listener.rbs
+- sig/hatchet/worker/durable_eviction/cache.rbs
+- sig/hatchet/worker/durable_eviction/manager.rbs
 - sig/hatchet/worker/health_check.rbs
 - sig/hatchet/worker/runner.rbs
 - sig/hatchet/worker/workflow_run_listener.rbs