handinger 0.12.1 → 0.13.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2031c5f448c9fe88ec00aca80a617c9a615b6c4bdba6c92ec6571a9d13b7fe5
-  data.tar.gz: 750e8fdacbc62754fde586ef760b5e985509dd257ee78993435f7f0f6dd384f8
+  metadata.gz: a452933631b479a699417708d1f6e57d772495ed1c63ba89b5b45ecebd924f21
+  data.tar.gz: 73ba3e1c4f986c900edd516f089584c5d3d0fe6d3784457cf25de0fc9b87e10d
 SHA512:
-  metadata.gz: f5b48117d32135846d6c341ee044db8be296df0b0eb672b9ffbae5bcf9dfe6432ce72dbde3e020f8fd9c7dfd19ffd96fd97eceb9e15e8f68e717b6f23c3cd0fe
-  data.tar.gz: 5f03e07b7b20b39a6f4c8dcbd35afdd206e8d21a77150fa0e60b8152007d45dace54da9b0ad15115a0d5f99ac75483cc57896e92be1639624ad07d5e92f5598e
+  metadata.gz: 4066a67f7dd3a8cc293bedecc376b3448bc123a4f65d10573905498a1b9e8c79410fdd253889a5ded53c302b67ff27d3f2ae3206c4c5981495d4acc11fd2bdf5
+  data.tar.gz: c9964bdc90c3dfa466ab409036bb5dfec30eb4e6f20251451747524ca6ad35c50e773e8aec7dfc76fd440c1543e86e75e8b74cdc0e11f87f5ad177d97500a65b

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** add files field and File model to TaskWithTurns::Turn ([0428e6c](https://github.com/ramensoft/handinger-ruby/commit/0428e6c7c8e66cf90fe2c5151ab0555787139ef9))
+
 ## 0.12.1 (2026-06-17)
 
 Full Changelog: [v0.12.0...v0.12.1](https://github.com/ramensoft/handinger-ruby/compare/v0.12.0...v0.12.1)

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.12.1"
+gem "handinger", "~> 0.13.1"
 ```
 
 <!-- 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.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.12.1"
+  VERSION = "0.13.1"
 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

data/rbi/handinger/models/worker.rbi

@@ -309,27 +309,17 @@ module Handinger
             T.any(Handinger::Worker::Usage, Handinger::Internal::AnyHash)
           end
 
-        sig { returns(T.nilable(Integer)) }
-        attr_reader :credits
-
-        sig { params(credits: Integer).void }
-        attr_writer :credits
-
         sig { returns(T.nilable(Integer)) }
         attr_reader :duration_ms
 
         sig { params(duration_ms: Integer).void }
         attr_writer :duration_ms
 
-        sig do
-          params(credits: Integer, duration_ms: Integer).returns(
-            T.attached_class
-          )
-        end
-        def self.new(credits: nil, duration_ms: nil)
+        sig { params(duration_ms: Integer).returns(T.attached_class) }
+        def self.new(duration_ms: nil)
         end
 
-        sig { override.returns({ credits: Integer, duration_ms: Integer }) }
+        sig { override.returns({ duration_ms: Integer }) }
         def to_hash
         end
       end

data/rbi/handinger/models.rbi

@@ -15,9 +15,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