handinger 0.8.0 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2da95055e66f45cde46af0ef457dd77d4583bd7946d6f3c244fb9281f93b0e4
-  data.tar.gz: 8735d12d6338850b6ca41a70cff2ab88b6b1f0b67dacc7722743ca79962c6a16
+  metadata.gz: a10350d5ac1598c471ad065b5d471a4a7f665e3a9db0e70d1fd91a6f6566647f
+  data.tar.gz: 935c3249b83f564c8500949cf6c85a25766d54b67439017ea8053bc79d696491
 SHA512:
-  metadata.gz: 06e00886ab79b1ef3daf23fc66b732611f37065f7d8f9585ff18e48c00798430b4264f94bcdc594353bb3e5277ae5e29ca6ad549a8cc38c36e5da2c20ee2161c
-  data.tar.gz: c6da45cc9db8b1a80166d30c45fc191d15ec6deb62973ae2f563cf911fff0acca95d6df67527d5f4199e74f7c79ab826b3d3ad40ffbc62112f4b8bf459306dbe
+  metadata.gz: ac7249bc09d63dccc2ef162de41ddcb86f7ded981837b4039485af5fe214177b58fae34f2e88a17840ad7ccd54d6a60bb2de08274eadca3745c4a4818048a150
+  data.tar.gz: 748b50c64d7f68859a34dc894d3253dd2a9f4671614af841686cb62c3a88ed9fc738b1ec534f0c72953fa37c2fec0baf1214d0bfaaaf78347617e62740eb57b0

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.8.2 (2026-05-11)
+
+Full Changelog: [v0.8.1...v0.8.2](https://github.com/ramensoft/handinger-ruby/compare/v0.8.1...v0.8.2)
+
+### Chores
+
+* configure new SDK language ([337e427](https://github.com/ramensoft/handinger-ruby/commit/337e4273d24723fb9cee74d0bb5082b5a7b0a2e9))
+
+## 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)

data/README.md

@@ -4,6 +4,15 @@ The Handinger Ruby library provides convenient access to the Handinger REST API
 
 It is generated with [Stainless](https://www.stainless.com/).
 
+## MCP Server
+
+Use the Handinger MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
+
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40ramensoft%2Fhandinger-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkByYW1lbnNvZnQvaGFuZGluZ2VyLW1jcCJdLCJlbnYiOnsiSEFORElOR0VSX0FQSV9LRVkiOiJNeSBBUEkgS2V5In19)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40ramensoft%2Fhandinger-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40ramensoft%2Fhandinger-mcp%22%5D%2C%22env%22%3A%7B%22HANDINGER_API_KEY%22%3A%22My%20API%20Key%22%7D%7D)
+
+> Note: You may need to set environment variables in your MCP client.
+
 ## Documentation
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/handinger).
@@ -17,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "handinger", "~> 0.8.0"
+gem "handinger", "~> 0.8.2"
 ```
 
 <!-- x-release-please-end -->

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.8.0"
+  VERSION = "0.8.2"
 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.8.0
+  version: 0.8.2
 platform: ruby
 authors:
 - Handinger