handinger 0.7.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9a4079727251cf6facfe9b5ade402158b369721afabd58044758ec3097d08e9
-  data.tar.gz: 8ee02c942394761ba33414318f021a38f2c30f25a943d0c1ebf071165ab533d0
+  metadata.gz: ac39fe33eef4532be4a8b24d374da675cb8f8deeaf38351f688be61a62b362aa
+  data.tar.gz: a753f2830ebf671e83301dad1979c4558bb3187aebaa93f572da40d68468106f
 SHA512:
-  metadata.gz: 3764c4d0dd72181c6b175478914d8c4f8a7791d4e412994f3d46d939c09aea17441ca0ba13a783beb122182466eac545eaee7d0a5ca19aa3ae76c14f89735178
-  data.tar.gz: 48b83da43ba817718a9e78cce13c4eab1fc8453bdaf55689e4d5f114e547c383cc713ed960ab14d003cdc7fc900444e197d6ab4e6b7e7083ea0ff5fe969a2830
+  metadata.gz: 91abd9f4b4c70208fd68bae48c793a4af3baa9647f9d0886b7ee6f1848780480ed6a871752d181611f38a977de0317d9ac60bd9d367c98d45bbd0bb5090c13d2
+  data.tar.gz: cd69e6e8129c46586317d02e98cc3ab2522229bfaf2419cb34d3fe826fd787ad2f80c1db6b1d24703a36bba3666854462978b3d00a6349840c0ff26f44f0b328

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.8.1 (2026-05-11)
+
+Full Changelog: [v0.8.0...v0.8.1](https://github.com/ramensoft/handinger-ruby/compare/v0.8.0...v0.8.1)
+
+### Bug Fixes
+
+* **types:** correct credits, duration, turn count to Integer in task models ([55ea3be](https://github.com/ramensoft/handinger-ruby/commit/55ea3be19918fd7819cbea61322ba8b6c39a1f73))
+
+## 0.8.0 (2026-05-11)
+
+Full Changelog: [v0.7.0...v0.8.0](https://github.com/ramensoft/handinger-ruby/compare/v0.7.0...v0.8.0)
+
+### Features
+
+* **api:** api update ([96453f6](https://github.com/ramensoft/handinger-ruby/commit/96453f63068bbf90122a10ffdfccec3c1760395f))
+
 ## 0.7.0 (2026-05-11)
 
 Full Changelog: [v0.6.0...v0.7.0](https://github.com/Ramensoft/handinger-ruby/compare/v0.6.0...v0.7.0)

data/README.md

@@ -1,6 +1,6 @@
 # Handinger Ruby API library
 
-The Handinger Ruby library provides convenient access to the Handinger REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/Ramensoft/handinger-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
+The Handinger Ruby library provides convenient access to the Handinger REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/ramensoft/handinger-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
@@ -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.7.0"
+gem "handinger", "~> 0.8.1"
 ```
 
 <!-- x-release-please-end -->
@@ -244,4 +244,4 @@ Ruby 3.2.0 or higher.
 
 ## Contributing
 
-See [the contributing documentation](https://github.com/Ramensoft/handinger-ruby/tree/main/CONTRIBUTING.md).
+See [the contributing documentation](https://github.com/ramensoft/handinger-ruby/tree/main/CONTRIBUTING.md).

data/lib/handinger/models/create_task.rb

@@ -9,11 +9,15 @@ module Handinger
       required :input, String
 
       # @!attribute budget
+      #   Compute budget the worker is allowed to spend on the task. Defaults to
+      #   `standard`.
       #
       #   @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
@@ -38,14 +42,17 @@ module Handinger
       #
       #   @param input [String]
       #
-      #   @param budget [Symbol, Handinger::Models::CreateTask::Budget]
+      #   @param budget [Symbol, Handinger::Models::CreateTask::Budget] Compute budget the worker is allowed to spend on the task. Defaults to `standard
       #
-      #   @param stream [Boolean]
+      #   @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
 
+      # Compute budget the worker is allowed to spend on the task. Defaults to
+      # `standard`.
+      #
       # @see Handinger::Models::CreateTask#budget
       module Budget
         extend Handinger::Internal::Type::Enum

data/lib/handinger/models/task.rb

@@ -39,6 +39,7 @@ module Handinger
       required :title, String
 
       # @!attribute totals
+      #   Aggregate credit spend, elapsed wall-clock, and number of turns across the task.
       #
       #   @return [Handinger::Models::Task::Totals]
       required :totals, -> { Handinger::Task::Totals }
@@ -60,6 +61,9 @@ module Handinger
       required :worker_id, String, api_name: :workerId
 
       # @!method initialize(id:, completed_at:, created_at:, created_by_user_id:, organization_id:, status:, title:, totals:, triggered_by:, url:, worker_id:)
+      #   Some parameter documentations has been truncated, see {Handinger::Models::Task}
+      #   for more details.
+      #
       #   @param id [String]
       #
       #   @param completed_at [String, nil]
@@ -74,7 +78,7 @@ module Handinger
       #
       #   @param title [String]
       #
-      #   @param totals [Handinger::Models::Task::Totals]
+      #   @param totals [Handinger::Models::Task::Totals] Aggregate credit spend, elapsed wall-clock, and number of turns across the task.
       #
       #   @param triggered_by [Symbol, Handinger::Models::Task::TriggeredBy]
       #
@@ -100,23 +104,25 @@ module Handinger
       class Totals < Handinger::Internal::Type::BaseModel
         # @!attribute credits
         #
-        #   @return [Float]
-        required :credits, Float
+        #   @return [Integer]
+        required :credits, Integer
 
         # @!attribute duration_ms
         #
-        #   @return [Float]
-        required :duration_ms, Float, api_name: :durationMs
+        #   @return [Integer]
+        required :duration_ms, Integer, api_name: :durationMs
 
         # @!attribute turn_count
         #
-        #   @return [Float]
-        required :turn_count, Float, api_name: :turnCount
+        #   @return [Integer]
+        required :turn_count, Integer, api_name: :turnCount
 
         # @!method initialize(credits:, duration_ms:, turn_count:)
-        #   @param credits [Float]
-        #   @param duration_ms [Float]
-        #   @param turn_count [Float]
+        #   Aggregate credit spend, elapsed wall-clock, and number of turns across the task.
+        #
+        #   @param credits [Integer]
+        #   @param duration_ms [Integer]
+        #   @param turn_count [Integer]
       end
 
       # @see Handinger::Models::Task#triggered_by

data/lib/handinger/models/task_with_turns.rb

@@ -31,8 +31,8 @@ module Handinger
 
         # @!attribute credits
         #
-        #   @return [Float]
-        required :credits, Float
+        #   @return [Integer]
+        required :credits, Integer
 
         # @!attribute duration_ms
         #
@@ -80,6 +80,8 @@ module Handinger
         required :status, String
 
         # @!attribute structured_output
+        #   Structured JSON payload when the worker is configured with an output schema.
+        #   `null` otherwise.
         #
         #   @return [Hash{Symbol=>Object}, nil]
         required :structured_output,
@@ -93,19 +95,35 @@ module Handinger
         required :task_id, String, api_name: :taskId
 
         # @!method initialize(id:, completed_at:, credits:, duration_ms:, input:, input_tokens:, output_text:, output_tokens:, role:, seq:, started_at:, status:, structured_output:, task_id:)
+        #   Some parameter documentations has been truncated, see
+        #   {Handinger::Models::TaskWithTurns::Turn} for more details.
+        #
         #   @param id [String]
+        #
         #   @param completed_at [String, nil]
-        #   @param credits [Float]
+        #
+        #   @param credits [Integer]
+        #
         #   @param duration_ms [Integer]
+        #
         #   @param input [String]
+        #
         #   @param input_tokens [Integer]
+        #
         #   @param output_text [String]
+        #
         #   @param output_tokens [Integer]
+        #
         #   @param role [String]
+        #
         #   @param seq [Integer]
+        #
         #   @param started_at [String]
+        #
         #   @param status [String]
-        #   @param structured_output [Hash{Symbol=>Object}, nil]
+        #
+        #   @param structured_output [Hash{Symbol=>Object}, nil] Structured JSON payload when the worker is configured with an output schema. `nu
+        #
         #   @param task_id [String]
       end
     end

data/lib/handinger/resources/tasks.rb

@@ -16,9 +16,9 @@ module Handinger
       #
       # @param input [String]
       #
-      # @param budget [Symbol, Handinger::Models::CreateTask::Budget]
+      # @param budget [Symbol, Handinger::Models::CreateTask::Budget] Compute budget the worker is allowed to spend on the task. Defaults to `standard
       #
-      # @param stream [Boolean]
+      # @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
       #

data/lib/handinger/version.rb

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

data/rbi/handinger/models/create_task.rbi

@@ -11,12 +11,16 @@ module Handinger
       sig { returns(String) }
       attr_accessor :input
 
+      # Compute budget the worker is allowed to spend on the task. Defaults to
+      # `standard`.
       sig { returns(T.nilable(Handinger::CreateTask::Budget::OrSymbol)) }
       attr_reader :budget
 
       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
 
@@ -50,7 +54,11 @@ module Handinger
       end
       def self.new(
         input:,
+        # 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.
@@ -75,6 +83,8 @@ module Handinger
       def to_hash
       end
 
+      # Compute budget the worker is allowed to spend on the task. Defaults to
+      # `standard`.
       module Budget
         extend Handinger::Internal::Type::Enum
 

data/rbi/handinger/models/task.rbi

@@ -27,6 +27,7 @@ module Handinger
       sig { returns(String) }
       attr_accessor :title
 
+      # Aggregate credit spend, elapsed wall-clock, and number of turns across the task.
       sig { returns(Handinger::Task::Totals) }
       attr_reader :totals
 
@@ -66,6 +67,7 @@ module Handinger
         organization_id:,
         status:,
         title:,
+        # Aggregate credit spend, elapsed wall-clock, and number of turns across the task.
         totals:,
         triggered_by:,
         # Web URL of the task in the Handinger dashboard.
@@ -119,26 +121,29 @@ module Handinger
             T.any(Handinger::Task::Totals, Handinger::Internal::AnyHash)
           end
 
-        sig { returns(Float) }
+        sig { returns(Integer) }
         attr_accessor :credits
 
-        sig { returns(Float) }
+        sig { returns(Integer) }
         attr_accessor :duration_ms
 
-        sig { returns(Float) }
+        sig { returns(Integer) }
         attr_accessor :turn_count
 
+        # Aggregate credit spend, elapsed wall-clock, and number of turns across the task.
         sig do
-          params(credits: Float, duration_ms: Float, turn_count: Float).returns(
-            T.attached_class
-          )
+          params(
+            credits: Integer,
+            duration_ms: Integer,
+            turn_count: Integer
+          ).returns(T.attached_class)
         end
         def self.new(credits:, duration_ms:, turn_count:)
         end
 
         sig do
           override.returns(
-            { credits: Float, duration_ms: Float, turn_count: Float }
+            { credits: Integer, duration_ms: Integer, turn_count: Integer }
           )
         end
         def to_hash

data/rbi/handinger/models/task_with_turns.rbi

@@ -49,7 +49,7 @@ module Handinger
         sig { returns(T.nilable(String)) }
         attr_accessor :completed_at
 
-        sig { returns(Float) }
+        sig { returns(Integer) }
         attr_accessor :credits
 
         sig { returns(Integer) }
@@ -79,6 +79,8 @@ module Handinger
         sig { returns(String) }
         attr_accessor :status
 
+        # Structured JSON payload when the worker is configured with an output schema.
+        # `null` otherwise.
         sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
         attr_accessor :structured_output
 
@@ -89,7 +91,7 @@ module Handinger
           params(
             id: String,
             completed_at: T.nilable(String),
-            credits: Float,
+            credits: Integer,
             duration_ms: Integer,
             input: String,
             input_tokens: Integer,
@@ -116,6 +118,8 @@ module Handinger
           seq:,
           started_at:,
           status:,
+          # Structured JSON payload when the worker is configured with an output schema.
+          # `null` otherwise.
           structured_output:,
           task_id:
         )
@@ -126,7 +130,7 @@ module Handinger
             {
               id: String,
               completed_at: T.nilable(String),
-              credits: Float,
+              credits: Integer,
               duration_ms: Integer,
               input: String,
               input_tokens: Integer,

data/rbi/handinger/resources/tasks.rbi

@@ -20,7 +20,11 @@ module Handinger
       end
       def create(
         input:,
+        # 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.

data/sig/handinger/models/task.rbs

@@ -80,25 +80,26 @@ module Handinger
         def self?.values: -> ::Array[Handinger::Models::Task::status]
       end
 
-      type totals = { credits: Float, duration_ms: Float, turn_count: Float }
+      type totals =
+        { credits: Integer, duration_ms: Integer, turn_count: Integer }
 
       class Totals < Handinger::Internal::Type::BaseModel
-        attr_accessor credits: Float
+        attr_accessor credits: Integer
 
-        attr_accessor duration_ms: Float
+        attr_accessor duration_ms: Integer
 
-        attr_accessor turn_count: Float
+        attr_accessor turn_count: Integer
 
         def initialize: (
-          credits: Float,
-          duration_ms: Float,
-          turn_count: Float
+          credits: Integer,
+          duration_ms: Integer,
+          turn_count: Integer
         ) -> void
 
         def to_hash: -> {
-          credits: Float,
-          duration_ms: Float,
-          turn_count: Float
+          credits: Integer,
+          duration_ms: Integer,
+          turn_count: Integer
         }
       end
 

data/sig/handinger/models/task_with_turns.rbs

@@ -22,7 +22,7 @@ module Handinger
         {
           id: String,
           completed_at: String?,
-          credits: Float,
+          credits: Integer,
           duration_ms: Integer,
           input: String,
           input_tokens: Integer,
@@ -41,7 +41,7 @@ module Handinger
 
         attr_accessor completed_at: String?
 
-        attr_accessor credits: Float
+        attr_accessor credits: Integer
 
         attr_accessor duration_ms: Integer
 
@@ -68,7 +68,7 @@ module Handinger
         def initialize: (
           id: String,
           completed_at: String?,
-          credits: Float,
+          credits: Integer,
           duration_ms: Integer,
           input: String,
           input_tokens: Integer,
@@ -85,7 +85,7 @@ module Handinger
         def to_hash: -> {
           id: String,
           completed_at: String?,
-          credits: Float,
+          credits: Integer,
           duration_ms: Integer,
           input: String,
           input_tokens: Integer,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: handinger
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Handinger
@@ -229,7 +229,7 @@ homepage: https://gemdocs.org/gems/handinger
 licenses: []
 metadata:
   homepage_uri: https://gemdocs.org/gems/handinger
-  source_code_uri: https://github.com/Ramensoft/handinger-ruby
+  source_code_uri: https://github.com/ramensoft/handinger-ruby
   rubygems_mfa_required: 'false'
 post_install_message:
 rdoc_options: []