handinger 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d1939ea3d98455445ddf4a85cf0e23de654376c91878240205d0ef9235e821a
-  data.tar.gz: 446e212d854b791c9c69d3d7323afd47ea5b1a80870e3d3c85c2fb43907d87be
+  metadata.gz: cc7d330384a0ff37cee9f18ad697e410a8cb931def3834447aca9724aa3fe098
+  data.tar.gz: 4e5e2ee2d79931da8d93b8ce0c3108be614b06de4cd2ed3b7f9156c03489dcf6
 SHA512:
-  metadata.gz: a5993e6b2104fb3e6f44a1c84ab4ca2649393afe7ad710332fc3b81228b1fd1c68dff46d2bf358cc7ff74163a752c6aaabfa32d5fe0d864ec4f33ef47a82172b
-  data.tar.gz: 3c04b1c562c222af01d2f612de2a4529ba6eb95c18e130af5ae75e18ab466148af69fff955b29d930d390b623faa0952e87e3a574c5fba7dfce1ac94601f61b1
+  metadata.gz: a894986cbb06d5de67b840d8e9b1206f09ce32321bbad244e7c10af3eb1e62a3ed16c8f953a627b274dc15c659518cd66a1fb0b9284f87ad9b03c36ae7c2b455
+  data.tar.gz: '096df7c53e269b14d163abe84d359260255453556a8af6ba8da4077cdbd7656973853ca96cc76437f61868f9e29a389ee752941f75e7672201dc02b4af7397ed'

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.12.0 (2026-06-03)
+
+Full Changelog: [v0.11.0...v0.12.0](https://github.com/ramensoft/handinger-ruby/compare/v0.11.0...v0.12.0)
+
+### Features
+
+* Refactor task chat to use WebSocket agent connection ([64008fb](https://github.com/ramensoft/handinger-ruby/commit/64008fbcc2b333c98b8314db285f191bb37ed104))
+
 ## 0.11.0 (2026-05-15)
 
 Full Changelog: [v0.10.1...v0.11.0](https://github.com/ramensoft/handinger-ruby/compare/v0.10.1...v0.11.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "handinger", "~> 0.11.0"
+gem "handinger", "~> 0.12.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/handinger/models/create_task.rb

@@ -15,13 +15,6 @@ module Handinger
       #   @return [Symbol, Handinger::Models::CreateTask::Budget, nil]
       optional :budget, enum: -> { Handinger::CreateTask::Budget }
 
-      # @!attribute stream
-      #   Stream the response as server-sent events instead of waiting for the final
-      #   payload.
-      #
-      #   @return [Boolean, nil]
-      optional :stream, Handinger::Internal::Type::Boolean
-
       # @!attribute task_id
       #   Optional client-provided task id. Reuse this id to add turns to an existing
       #   task.
@@ -36,7 +29,7 @@ module Handinger
       #   @return [String, nil]
       optional :worker_id, String, api_name: :workerId
 
-      # @!method initialize(input:, budget: nil, stream: nil, task_id: nil, worker_id: nil)
+      # @!method initialize(input:, budget: nil, task_id: nil, worker_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {Handinger::Models::CreateTask} for more details.
       #
@@ -44,8 +37,6 @@ module Handinger
       #
       #   @param budget [Symbol, Handinger::Models::CreateTask::Budget] Compute budget the worker is allowed to spend on the task. Defaults to `standard
       #
-      #   @param stream [Boolean] Stream the response as server-sent events instead of waiting for the final paylo
-      #
       #   @param task_id [String] Optional client-provided task id. Reuse this id to add turns to an existing task
       #
       #   @param worker_id [String] Worker id the task belongs to. If omitted, a new worker is created on-the-fly us

data/lib/handinger/models/worker_retrieve_params.rb

@@ -12,36 +12,22 @@ module Handinger
       #   @return [String]
       required :worker_id, String
 
-      # @!attribute stream
-      #   Set to "true" to receive a server-sent event stream that replays all stored
-      #   messages and then continues with live chunks from the active task (if any)
-      #   before closing.
+      # @!attribute task_id
+      #   Return the worker state and messages for a specific task instead of the most
+      #   recent one.
       #
-      #   @return [Symbol, Handinger::Models::WorkerRetrieveParams::Stream, nil]
-      optional :stream, enum: -> { Handinger::WorkerRetrieveParams::Stream }
+      #   @return [String, nil]
+      optional :task_id, String
 
-      # @!method initialize(worker_id:, stream: nil, request_options: {})
+      # @!method initialize(worker_id:, task_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Handinger::Models::WorkerRetrieveParams} for more details.
       #
       #   @param worker_id [String]
       #
-      #   @param stream [Symbol, Handinger::Models::WorkerRetrieveParams::Stream] Set to "true" to receive a server-sent event stream that replays all stored mess
+      #   @param task_id [String] Return the worker state and messages for a specific task instead of the most rec
       #
       #   @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}]
-
-      # Set to "true" to receive a server-sent event stream that replays all stored
-      # messages and then continues with live chunks from the active task (if any)
-      # before closing.
-      module Stream
-        extend Handinger::Internal::Type::Enum
-
-        TRUE = :true
-        FALSE = :false
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/handinger/resources/tasks.rb

@@ -7,19 +7,19 @@ module Handinger
       # Some parameter documentations has been truncated, see
       # {Handinger::Models::TaskCreateParams} for more details.
       #
-      # Run a new task against an existing worker. Send a `taskId` of a prior task to
-      # add a follow-up turn instead of starting a fresh task. Send
-      # `multipart/form-data` to attach files; the bytes are bootstrapped into the
-      # worker's workspace before the task starts.
+      # Run a new task against an existing worker and wait for the result. Send a
+      # `taskId` of a prior task to add a follow-up turn instead of starting a fresh
+      # task. Send `multipart/form-data` to attach files; the bytes are bootstrapped
+      # into the worker's workspace before the task starts. The task runs to completion
+      # on the server even if the connection drops; subscribe to task webhooks for
+      # long-running tasks.
       #
-      # @overload create(input:, budget: nil, stream: nil, task_id: nil, worker_id: nil, request_options: {})
+      # @overload create(input:, budget: nil, task_id: nil, worker_id: nil, request_options: {})
       #
       # @param input [String]
       #
       # @param budget [Symbol, Handinger::Models::CreateTask::Budget] Compute budget the worker is allowed to spend on the task. Defaults to `standard
       #
-      # @param stream [Boolean] Stream the response as server-sent events instead of waiting for the final paylo
-      #
       # @param task_id [String] Optional client-provided task id. Reuse this id to add turns to an existing task
       #
       # @param worker_id [String] Worker id the task belongs to. If omitted, a new worker is created on-the-fly us

data/lib/handinger/resources/workers.rb

@@ -51,15 +51,14 @@ module Handinger
       # Some parameter documentations has been truncated, see
       # {Handinger::Models::WorkerRetrieveParams} for more details.
       #
-      # Retrieve the current worker state and messages from its most recent task.
-      # Returns a JSON worker object by default, or a server-sent event stream when
-      # `stream=true`.
+      # Retrieve the current worker state and messages from its most recent task (or a
+      # specific task via `taskId`).
       #
-      # @overload retrieve(worker_id, stream: nil, request_options: {})
+      # @overload retrieve(worker_id, task_id: nil, request_options: {})
       #
       # @param worker_id [String] Worker id returned by the create worker endpoint.
       #
-      # @param stream [Symbol, Handinger::Models::WorkerRetrieveParams::Stream] Set to "true" to receive a server-sent event stream that replays all stored mess
+      # @param task_id [String] Return the worker state and messages for a specific task instead of the most rec
       #
       # @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -72,7 +71,7 @@ module Handinger
         @client.request(
           method: :get,
           path: ["api/workers/%1$s", worker_id],
-          query: query,
+          query: query.transform_keys(task_id: "taskId"),
           model: Handinger::Worker,
           options: options
         )

data/lib/handinger/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Handinger
-  VERSION = "0.11.0"
+  VERSION = "0.12.0"
 end

data/rbi/handinger/models/create_task.rbi

@@ -19,14 +19,6 @@ module Handinger
       sig { params(budget: Handinger::CreateTask::Budget::OrSymbol).void }
       attr_writer :budget
 
-      # Stream the response as server-sent events instead of waiting for the final
-      # payload.
-      sig { returns(T.nilable(T::Boolean)) }
-      attr_reader :stream
-
-      sig { params(stream: T::Boolean).void }
-      attr_writer :stream
-
       # Optional client-provided task id. Reuse this id to add turns to an existing
       # task.
       sig { returns(T.nilable(String)) }
@@ -47,7 +39,6 @@ module Handinger
         params(
           input: String,
           budget: Handinger::CreateTask::Budget::OrSymbol,
-          stream: T::Boolean,
           task_id: String,
           worker_id: String
         ).returns(T.attached_class)
@@ -57,9 +48,6 @@ module Handinger
         # Compute budget the worker is allowed to spend on the task. Defaults to
         # `standard`.
         budget: nil,
-        # Stream the response as server-sent events instead of waiting for the final
-        # payload.
-        stream: nil,
         # Optional client-provided task id. Reuse this id to add turns to an existing
         # task.
         task_id: nil,
@@ -74,7 +62,6 @@ module Handinger
           {
             input: String,
             budget: Handinger::CreateTask::Budget::OrSymbol,
-            stream: T::Boolean,
             task_id: String,
             worker_id: String
           }

data/rbi/handinger/models/worker_retrieve_params.rbi

@@ -14,32 +14,26 @@ module Handinger
       sig { returns(String) }
       attr_accessor :worker_id
 
-      # Set to "true" to receive a server-sent event stream that replays all stored
-      # messages and then continues with live chunks from the active task (if any)
-      # before closing.
-      sig do
-        returns(T.nilable(Handinger::WorkerRetrieveParams::Stream::OrSymbol))
-      end
-      attr_reader :stream
+      # Return the worker state and messages for a specific task instead of the most
+      # recent one.
+      sig { returns(T.nilable(String)) }
+      attr_reader :task_id
 
-      sig do
-        params(stream: Handinger::WorkerRetrieveParams::Stream::OrSymbol).void
-      end
-      attr_writer :stream
+      sig { params(task_id: String).void }
+      attr_writer :task_id
 
       sig do
         params(
           worker_id: String,
-          stream: Handinger::WorkerRetrieveParams::Stream::OrSymbol,
+          task_id: String,
           request_options: Handinger::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
         worker_id:,
-        # Set to "true" to receive a server-sent event stream that replays all stored
-        # messages and then continues with live chunks from the active task (if any)
-        # before closing.
-        stream: nil,
+        # Return the worker state and messages for a specific task instead of the most
+        # recent one.
+        task_id: nil,
         request_options: {}
       )
       end
@@ -48,39 +42,13 @@ module Handinger
         override.returns(
           {
             worker_id: String,
-            stream: Handinger::WorkerRetrieveParams::Stream::OrSymbol,
+            task_id: String,
             request_options: Handinger::RequestOptions
           }
         )
       end
       def to_hash
       end
-
-      # Set to "true" to receive a server-sent event stream that replays all stored
-      # messages and then continues with live chunks from the active task (if any)
-      # before closing.
-      module Stream
-        extend Handinger::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Handinger::WorkerRetrieveParams::Stream)
-          end
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        TRUE =
-          T.let(:true, Handinger::WorkerRetrieveParams::Stream::TaggedSymbol)
-        FALSE =
-          T.let(:false, Handinger::WorkerRetrieveParams::Stream::TaggedSymbol)
-
-        sig do
-          override.returns(
-            T::Array[Handinger::WorkerRetrieveParams::Stream::TaggedSymbol]
-          )
-        end
-        def self.values
-        end
-      end
     end
   end
 end

data/rbi/handinger/resources/tasks.rbi

@@ -4,15 +4,16 @@ module Handinger
   module Resources
     # Run and inspect tasks against a worker.
     class Tasks
-      # Run a new task against an existing worker. Send a `taskId` of a prior task to
-      # add a follow-up turn instead of starting a fresh task. Send
-      # `multipart/form-data` to attach files; the bytes are bootstrapped into the
-      # worker's workspace before the task starts.
+      # Run a new task against an existing worker and wait for the result. Send a
+      # `taskId` of a prior task to add a follow-up turn instead of starting a fresh
+      # task. Send `multipart/form-data` to attach files; the bytes are bootstrapped
+      # into the worker's workspace before the task starts. The task runs to completion
+      # on the server even if the connection drops; subscribe to task webhooks for
+      # long-running tasks.
       sig do
         params(
           input: String,
           budget: Handinger::CreateTask::Budget::OrSymbol,
-          stream: T::Boolean,
           task_id: String,
           worker_id: String,
           request_options: Handinger::RequestOptions::OrHash
@@ -23,9 +24,6 @@ module Handinger
         # Compute budget the worker is allowed to spend on the task. Defaults to
         # `standard`.
         budget: nil,
-        # Stream the response as server-sent events instead of waiting for the final
-        # payload.
-        stream: nil,
         # Optional client-provided task id. Reuse this id to add turns to an existing
         # task.
         task_id: nil,

data/rbi/handinger/resources/workers.rbi

@@ -47,23 +47,21 @@ module Handinger
       )
       end
 
-      # Retrieve the current worker state and messages from its most recent task.
-      # Returns a JSON worker object by default, or a server-sent event stream when
-      # `stream=true`.
+      # Retrieve the current worker state and messages from its most recent task (or a
+      # specific task via `taskId`).
       sig do
         params(
           worker_id: String,
-          stream: Handinger::WorkerRetrieveParams::Stream::OrSymbol,
+          task_id: String,
           request_options: Handinger::RequestOptions::OrHash
         ).returns(Handinger::Worker)
       end
       def retrieve(
         # Worker id returned by the create worker endpoint.
         worker_id,
-        # Set to "true" to receive a server-sent event stream that replays all stored
-        # messages and then continues with live chunks from the active task (if any)
-        # before closing.
-        stream: nil,
+        # Return the worker state and messages for a specific task instead of the most
+        # recent one.
+        task_id: nil,
         request_options: {}
       )
       end

data/sig/handinger/models/create_task.rbs

@@ -4,7 +4,6 @@ module Handinger
       {
         input: String,
         budget: Handinger::Models::CreateTask::budget,
-        stream: bool,
         task_id: String,
         worker_id: String
       }
@@ -18,10 +17,6 @@ module Handinger
         Handinger::Models::CreateTask::budget
       ) -> Handinger::Models::CreateTask::budget
 
-      attr_reader stream: bool?
-
-      def stream=: (bool) -> bool
-
       attr_reader task_id: String?
 
       def task_id=: (String) -> String
@@ -33,7 +28,6 @@ module Handinger
       def initialize: (
         input: String,
         ?budget: Handinger::Models::CreateTask::budget,
-        ?stream: bool,
         ?task_id: String,
         ?worker_id: String
       ) -> void
@@ -41,7 +35,6 @@ module Handinger
       def to_hash: -> {
         input: String,
         budget: Handinger::Models::CreateTask::budget,
-        stream: bool,
         task_id: String,
         worker_id: String
       }

data/sig/handinger/models/worker_retrieve_params.rbs

@@ -1,10 +1,7 @@
 module Handinger
   module Models
     type worker_retrieve_params =
-      {
-        worker_id: String,
-        stream: Handinger::Models::WorkerRetrieveParams::stream
-      }
+      { worker_id: String, task_id: String }
       & Handinger::Internal::Type::request_parameters
 
     class WorkerRetrieveParams < Handinger::Internal::Type::BaseModel
@@ -13,34 +10,21 @@ module Handinger
 
       attr_accessor worker_id: String
 
-      attr_reader stream: Handinger::Models::WorkerRetrieveParams::stream?
+      attr_reader task_id: String?
 
-      def stream=: (
-        Handinger::Models::WorkerRetrieveParams::stream
-      ) -> Handinger::Models::WorkerRetrieveParams::stream
+      def task_id=: (String) -> String
 
       def initialize: (
         worker_id: String,
-        ?stream: Handinger::Models::WorkerRetrieveParams::stream,
+        ?task_id: String,
         ?request_options: Handinger::request_opts
       ) -> void
 
       def to_hash: -> {
         worker_id: String,
-        stream: Handinger::Models::WorkerRetrieveParams::stream,
+        task_id: String,
         request_options: Handinger::RequestOptions
       }
-
-      type stream = :true | :false
-
-      module Stream
-        extend Handinger::Internal::Type::Enum
-
-        TRUE: :true
-        FALSE: :false
-
-        def self?.values: -> ::Array[Handinger::Models::WorkerRetrieveParams::stream]
-      end
     end
   end
 end

data/sig/handinger/resources/tasks.rbs

@@ -4,7 +4,6 @@ module Handinger
       def create: (
         input: String,
         ?budget: Handinger::Models::CreateTask::budget,
-        ?stream: bool,
         ?task_id: String,
         ?worker_id: String,
         ?request_options: Handinger::request_opts

data/sig/handinger/resources/workers.rbs

@@ -17,7 +17,7 @@ module Handinger
 
       def retrieve: (
         String worker_id,
-        ?stream: Handinger::Models::WorkerRetrieveParams::stream,
+        ?task_id: String,
         ?request_options: Handinger::request_opts
       ) -> Handinger::Worker
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: handinger
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Handinger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-15 00:00:00.000000000 Z
+date: 2026-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi