handinger 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b96d81d9398bdd5ea67ae91d9bcf3b3e3d498c52280ba116e6eb6a3f3273fbe
-  data.tar.gz: 85ffb7daef655eae2825d41ffd079355198db1f4dc3f616a6d6e5e523bc7c255
+  metadata.gz: e25b7889219202a4c100b312048bf8dd806029b793818d6a91fe483bd3752df6
+  data.tar.gz: 9c6621e9419095b18c01a8cb644703a814ed88853923b8828067c83fc4031753
 SHA512:
-  metadata.gz: 8c54723c88d55fc9f17e389d88014c7c925255d00e361e2d08cbf4a8a4552619b5df03228747f96ab216fbb1632432d4c15d5d0f31e12ce134efb041ca189b5d
-  data.tar.gz: 0c9665fed05a9e941cf1f0cac4d2d40297fb1074c114c8cf5e3647e67f76540e0c52195e79b9af3d984a83ab61a9ed8af6dba6a7d60aecf0f56248ebf46b86c2
+  metadata.gz: 5308f7c3c18be54a181a188285dba36175d2a60e30e25a0c64a821a540783a9f9ffee0017a7b039973b1e33f3677ccc27c0374543ef696bc49b8bafd87554f0b
+  data.tar.gz: dcb7a93774ba1e724eab3fed0b8a0ef43ce60c9a7a05776e1de8e92aa2a668f1f7e61d784be704d4ac4a6ea59c81d8dd80d6cde93b6a63512f76004564567377

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.14.0 (2026-07-10)
+
+Full Changelog: [v0.13.1...v0.14.0](https://github.com/ramensoft/handinger-ruby/compare/v0.13.1...v0.14.0)
+
+### Features
+
+* **api:** add timezone field to workers schedule list response ([61c8581](https://github.com/ramensoft/handinger-ruby/commit/61c8581d2b35a7eb4d3587e4dfddd0dcb75d240d))
+
+## 0.13.1 (2026-07-10)
+
+Full Changelog: [v0.13.0...v0.13.1](https://github.com/ramensoft/handinger-ruby/compare/v0.13.0...v0.13.1)
+
+### Bug Fixes
+
+* **api:** remove credits field from worker usage model ([47ef3e5](https://github.com/ramensoft/handinger-ruby/commit/47ef3e58e27b2e40a42f7902e76bee627f6190ae))
+
+
+### Chores
+
+* **internal:** bound formatter parallelism to CPU count ([611c87b](https://github.com/ramensoft/handinger-ruby/commit/611c87bb55ff2a7e76ec2a4540dbad0e716d161f))
+
 ## 0.13.0 (2026-06-23)
 
 Full Changelog: [v0.12.1...v0.13.0](https://github.com/ramensoft/handinger-ruby/compare/v0.12.1...v0.13.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.13.0"
+gem "handinger", "~> 0.14.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/handinger/models/task_list_turns_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Handinger
+  module Models
+    # @see Handinger::Resources::Tasks#list_turns
+    class TaskListTurnsParams < Handinger::Internal::Type::BaseModel
+      extend Handinger::Internal::Type::RequestParameters::Converter
+      include Handinger::Internal::Type::RequestParameters
+
+      # @!attribute task_id
+      #
+      #   @return [String]
+      required :task_id, String
+
+      # @!method initialize(task_id:, request_options: {})
+      #   @param task_id [String]
+      #   @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/handinger/models/task_retrieve_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Handinger
+  module Models
+    # @see Handinger::Resources::Tasks#retrieve
+    class TaskRetrieveResponse < Handinger::Internal::Type::BaseModel
+      # @!attribute task
+      #
+      #   @return [Handinger::Models::Task]
+      required :task, -> { Handinger::Task }
+
+      # @!method initialize(task:)
+      #   @param task [Handinger::Models::Task]
+    end
+  end
+end

data/lib/handinger/models/task_turn_list.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Handinger
+  module Models
+    # @see Handinger::Resources::Tasks#list_turns
+    class TaskTurnList < Handinger::Internal::Type::BaseModel
+      # @!attribute items
+      #
+      #   @return [Array<Handinger::Models::Turn>]
+      required :items, -> { Handinger::Internal::Type::ArrayOf[Handinger::Turn] }
+
+      # @!attribute task_id
+      #
+      #   @return [String]
+      required :task_id, String, api_name: :taskId
+
+      # @!method initialize(items:, task_id:)
+      #   @param items [Array<Handinger::Models::Turn>]
+      #   @param task_id [String]
+    end
+  end
+end

data/lib/handinger/models/turn.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+module Handinger
+  module Models
+    class Turn < Handinger::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute completed_at
+      #
+      #   @return [String, nil]
+      required :completed_at, String, api_name: :completedAt, nil?: true
+
+      # @!attribute credits
+      #
+      #   @return [Integer]
+      required :credits, Integer
+
+      # @!attribute duration_ms
+      #
+      #   @return [Integer]
+      required :duration_ms, Integer, api_name: :durationMs
+
+      # @!attribute files
+      #   Files published by this turn.
+      #
+      #   @return [Array<Handinger::Models::Turn::File>]
+      required :files, -> { Handinger::Internal::Type::ArrayOf[Handinger::Turn::File] }
+
+      # @!attribute input
+      #
+      #   @return [String]
+      required :input, String
+
+      # @!attribute input_tokens
+      #
+      #   @return [Integer]
+      required :input_tokens, Integer, api_name: :inputTokens
+
+      # @!attribute output_text
+      #
+      #   @return [String]
+      required :output_text, String, api_name: :outputText
+
+      # @!attribute output_tokens
+      #
+      #   @return [Integer]
+      required :output_tokens, Integer, api_name: :outputTokens
+
+      # @!attribute role
+      #
+      #   @return [String]
+      required :role, String
+
+      # @!attribute seq
+      #
+      #   @return [Integer]
+      required :seq, Integer
+
+      # @!attribute started_at
+      #
+      #   @return [String]
+      required :started_at, String, api_name: :startedAt
+
+      # @!attribute status
+      #
+      #   @return [String]
+      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,
+               Handinger::Internal::Type::HashOf[Handinger::Internal::Type::Unknown],
+               api_name: :structuredOutput,
+               nil?: true
+
+      # @!attribute task_id
+      #
+      #   @return [String]
+      required :task_id, String, api_name: :taskId
+
+      # @!method initialize(id:, completed_at:, credits:, duration_ms:, files:, 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::Turn}
+      #   for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param completed_at [String, nil]
+      #
+      #   @param credits [Integer]
+      #
+      #   @param duration_ms [Integer]
+      #
+      #   @param files [Array<Handinger::Models::Turn::File>] Files published by this turn.
+      #
+      #   @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] Structured JSON payload when the worker is configured with an output schema. `nu
+      #
+      #   @param task_id [String]
+
+      class File < Handinger::Internal::Type::BaseModel
+        # @!attribute filename
+        #
+        #   @return [String, nil]
+        required :filename, String, nil?: true
+
+        # @!attribute media_type
+        #
+        #   @return [String]
+        required :media_type, String, api_name: :mediaType
+
+        # @!attribute url
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!attribute size
+        #
+        #   @return [Integer, nil]
+        optional :size, Integer
+
+        # @!method initialize(filename:, media_type:, url:, size: nil)
+        #   @param filename [String, nil]
+        #   @param media_type [String]
+        #   @param url [String]
+        #   @param size [Integer]
+      end
+    end
+  end
+end

data/lib/handinger/models/worker.rb

@@ -240,18 +240,12 @@ module Handinger
 
       # @see Handinger::Models::Worker#usage
       class Usage < Handinger::Internal::Type::BaseModel
-        # @!attribute credits
-        #
-        #   @return [Integer, nil]
-        optional :credits, Integer
-
         # @!attribute duration_ms
         #
         #   @return [Integer, nil]
         optional :duration_ms, Integer, api_name: :durationMs
 
-        # @!method initialize(credits: nil, duration_ms: nil)
-        #   @param credits [Integer]
+        # @!method initialize(duration_ms: nil)
         #   @param duration_ms [Integer]
       end
     end

data/lib/handinger/models/workers/schedule_list_response.rb

@@ -10,13 +10,19 @@ module Handinger
         #   @return [Array<Handinger::Models::Workers::WorkerSchedule::Scheduled, Handinger::Models::Workers::WorkerSchedule::Delayed, Handinger::Models::Workers::WorkerSchedule::Cron, Handinger::Models::Workers::WorkerSchedule::Interval>]
         required :schedules, -> { Handinger::Internal::Type::ArrayOf[union: Handinger::Workers::WorkerSchedule] }
 
+        # @!attribute timezone
+        #
+        #   @return [String]
+        required :timezone, String
+
         # @!attribute worker_id
         #
         #   @return [String]
         required :worker_id, String, api_name: :workerId
 
-        # @!method initialize(schedules:, worker_id:)
+        # @!method initialize(schedules:, timezone:, worker_id:)
         #   @param schedules [Array<Handinger::Models::Workers::WorkerSchedule::Scheduled, Handinger::Models::Workers::WorkerSchedule::Delayed, Handinger::Models::Workers::WorkerSchedule::Cron, Handinger::Models::Workers::WorkerSchedule::Interval>]
+        #   @param timezone [String]
         #   @param worker_id [String]
       end
     end

data/lib/handinger/models.rb

@@ -53,9 +53,13 @@ module Handinger
 
   TaskDeleteParams = Handinger::Models::TaskDeleteParams
 
+  TaskListTurnsParams = Handinger::Models::TaskListTurnsParams
+
   TaskRetrieveParams = Handinger::Models::TaskRetrieveParams
 
-  TaskWithTurns = Handinger::Models::TaskWithTurns
+  TaskTurnList = Handinger::Models::TaskTurnList
+
+  Turn = Handinger::Models::Turn
 
   UpdateWorker = Handinger::Models::UpdateWorker
 

data/lib/handinger/resources/tasks.rb

@@ -40,7 +40,7 @@ module Handinger
         )
       end
 
-      # Retrieve a single task and its individual turns.
+      # Retrieve a single task.
       #
       # @overload retrieve(task_id, request_options: {})
       #
@@ -48,14 +48,14 @@ module Handinger
       #
       # @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Handinger::Models::TaskWithTurns]
+      # @return [Handinger::Models::TaskRetrieveResponse]
       #
       # @see Handinger::Models::TaskRetrieveParams
       def retrieve(task_id, params = {})
         @client.request(
           method: :get,
           path: ["api/tasks/%1$s", task_id],
-          model: Handinger::TaskWithTurns,
+          model: Handinger::Models::TaskRetrieveResponse,
           options: params[:request_options]
         )
       end
@@ -81,6 +81,26 @@ module Handinger
         )
       end
 
+      # List the individual turns for a task in execution order.
+      #
+      # @overload list_turns(task_id, request_options: {})
+      #
+      # @param task_id [String] Task id returned by the create task endpoint.
+      #
+      # @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Handinger::Models::TaskTurnList]
+      #
+      # @see Handinger::Models::TaskListTurnsParams
+      def list_turns(task_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["api/tasks/%1$s/turns", task_id],
+          model: Handinger::TaskTurnList,
+          options: params[:request_options]
+        )
+      end
+
       # @api private
       #
       # @param client [Handinger::Client]

data/lib/handinger/version.rb

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

data/lib/handinger.rb

@@ -61,8 +61,11 @@ require_relative "handinger/models/delete_worker_response"
 require_relative "handinger/models/task"
 require_relative "handinger/models/task_create_params"
 require_relative "handinger/models/task_delete_params"
+require_relative "handinger/models/task_list_turns_params"
 require_relative "handinger/models/task_retrieve_params"
-require_relative "handinger/models/task_with_turns"
+require_relative "handinger/models/task_retrieve_response"
+require_relative "handinger/models/task_turn_list"
+require_relative "handinger/models/turn"
 require_relative "handinger/models/worker"
 require_relative "handinger/models/worker_create_params"
 require_relative "handinger/models/worker_delete_params"

data/rbi/handinger/models/task_list_turns_params.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class TaskListTurnsParams < Handinger::Internal::Type::BaseModel
+      extend Handinger::Internal::Type::RequestParameters::Converter
+      include Handinger::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Handinger::TaskListTurnsParams, Handinger::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :task_id
+
+      sig do
+        params(
+          task_id: String,
+          request_options: Handinger::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(task_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { task_id: String, request_options: Handinger::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/handinger/models/task_retrieve_response.rbi

@@ -0,0 +1,29 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class TaskRetrieveResponse < Handinger::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Handinger::Models::TaskRetrieveResponse,
+            Handinger::Internal::AnyHash
+          )
+        end
+
+      sig { returns(Handinger::Task) }
+      attr_reader :task
+
+      sig { params(task: Handinger::Task::OrHash).void }
+      attr_writer :task
+
+      sig { params(task: Handinger::Task::OrHash).returns(T.attached_class) }
+      def self.new(task:)
+      end
+
+      sig { override.returns({ task: Handinger::Task }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/handinger/models/task_turn_list.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class TaskTurnList < Handinger::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Handinger::TaskTurnList, Handinger::Internal::AnyHash)
+        end
+
+      sig { returns(T::Array[Handinger::Turn]) }
+      attr_accessor :items
+
+      sig { returns(String) }
+      attr_accessor :task_id
+
+      sig do
+        params(
+          items: T::Array[Handinger::Turn::OrHash],
+          task_id: String
+        ).returns(T.attached_class)
+      end
+      def self.new(items:, task_id:)
+      end
+
+      sig do
+        override.returns({ items: T::Array[Handinger::Turn], task_id: String })
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/handinger/models/turn.rbi

@@ -0,0 +1,169 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class Turn < Handinger::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Handinger::Turn, Handinger::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :completed_at
+
+      sig { returns(Integer) }
+      attr_accessor :credits
+
+      sig { returns(Integer) }
+      attr_accessor :duration_ms
+
+      # Files published by this turn.
+      sig { returns(T::Array[Handinger::Turn::File]) }
+      attr_accessor :files
+
+      sig { returns(String) }
+      attr_accessor :input
+
+      sig { returns(Integer) }
+      attr_accessor :input_tokens
+
+      sig { returns(String) }
+      attr_accessor :output_text
+
+      sig { returns(Integer) }
+      attr_accessor :output_tokens
+
+      sig { returns(String) }
+      attr_accessor :role
+
+      sig { returns(Integer) }
+      attr_accessor :seq
+
+      sig { returns(String) }
+      attr_accessor :started_at
+
+      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
+
+      sig { returns(String) }
+      attr_accessor :task_id
+
+      sig do
+        params(
+          id: String,
+          completed_at: T.nilable(String),
+          credits: Integer,
+          duration_ms: Integer,
+          files: T::Array[Handinger::Turn::File::OrHash],
+          input: String,
+          input_tokens: Integer,
+          output_text: String,
+          output_tokens: Integer,
+          role: String,
+          seq: Integer,
+          started_at: String,
+          status: String,
+          structured_output: T.nilable(T::Hash[Symbol, T.anything]),
+          task_id: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        completed_at:,
+        credits:,
+        duration_ms:,
+        # Files published by this turn.
+        files:,
+        input:,
+        input_tokens:,
+        output_text:,
+        output_tokens:,
+        role:,
+        seq:,
+        started_at:,
+        status:,
+        # Structured JSON payload when the worker is configured with an output schema.
+        # `null` otherwise.
+        structured_output:,
+        task_id:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            completed_at: T.nilable(String),
+            credits: Integer,
+            duration_ms: Integer,
+            files: T::Array[Handinger::Turn::File],
+            input: String,
+            input_tokens: Integer,
+            output_text: String,
+            output_tokens: Integer,
+            role: String,
+            seq: Integer,
+            started_at: String,
+            status: String,
+            structured_output: T.nilable(T::Hash[Symbol, T.anything]),
+            task_id: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class File < Handinger::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Handinger::Turn::File, Handinger::Internal::AnyHash)
+          end
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :filename
+
+        sig { returns(String) }
+        attr_accessor :media_type
+
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :size
+
+        sig { params(size: Integer).void }
+        attr_writer :size
+
+        sig do
+          params(
+            filename: T.nilable(String),
+            media_type: String,
+            url: String,
+            size: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(filename:, media_type:, url:, size: nil)
+        end
+
+        sig do
+          override.returns(
+            {
+              filename: T.nilable(String),
+              media_type: String,
+              url: String,
+              size: Integer
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end