handinger 0.12.1 → 0.13.1

data/rbi/handinger/resources/tasks.rbi

@@ -34,12 +34,12 @@ module Handinger
       )
       end
 
-      # Retrieve a single task and its individual turns.
+      # Retrieve a single task.
       sig do
         params(
           task_id: String,
           request_options: Handinger::RequestOptions::OrHash
-        ).returns(Handinger::TaskWithTurns)
+        ).returns(Handinger::Models::TaskRetrieveResponse)
       end
       def retrieve(
         # Task id returned by the create task endpoint.
@@ -63,6 +63,20 @@ module Handinger
       )
       end
 
+      # List the individual turns for a task in execution order.
+      sig do
+        params(
+          task_id: String,
+          request_options: Handinger::RequestOptions::OrHash
+        ).returns(Handinger::TaskTurnList)
+      end
+      def list_turns(
+        # Task id returned by the create task endpoint.
+        task_id,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Handinger::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/handinger/models/task_list_turns_params.rbs

@@ -0,0 +1,23 @@
+module Handinger
+  module Models
+    type task_list_turns_params =
+      { task_id: String } & Handinger::Internal::Type::request_parameters
+
+    class TaskListTurnsParams < Handinger::Internal::Type::BaseModel
+      extend Handinger::Internal::Type::RequestParameters::Converter
+      include Handinger::Internal::Type::RequestParameters
+
+      attr_accessor task_id: String
+
+      def initialize: (
+        task_id: String,
+        ?request_options: Handinger::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        task_id: String,
+        request_options: Handinger::RequestOptions
+      }
+    end
+  end
+end

data/sig/handinger/models/task_retrieve_response.rbs

@@ -0,0 +1,13 @@
+module Handinger
+  module Models
+    type task_retrieve_response = { task: Handinger::Task }
+
+    class TaskRetrieveResponse < Handinger::Internal::Type::BaseModel
+      attr_accessor task: Handinger::Task
+
+      def initialize: (task: Handinger::Task) -> void
+
+      def to_hash: -> { task: Handinger::Task }
+    end
+  end
+end

data/sig/handinger/models/task_turn_list.rbs

@@ -0,0 +1,15 @@
+module Handinger
+  module Models
+    type task_turn_list = { items: ::Array[Handinger::Turn], task_id: String }
+
+    class TaskTurnList < Handinger::Internal::Type::BaseModel
+      attr_accessor items: ::Array[Handinger::Turn]
+
+      attr_accessor task_id: String
+
+      def initialize: (items: ::Array[Handinger::Turn], task_id: String) -> void
+
+      def to_hash: -> { items: ::Array[Handinger::Turn], task_id: String }
+    end
+  end
+end

data/sig/handinger/models/turn.rbs

@@ -0,0 +1,119 @@
+module Handinger
+  module Models
+    type turn =
+      {
+        id: String,
+        completed_at: String?,
+        credits: Integer,
+        duration_ms: Integer,
+        files: ::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: ::Hash[Symbol, top]?,
+        task_id: String
+      }
+
+    class Turn < Handinger::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor completed_at: String?
+
+      attr_accessor credits: Integer
+
+      attr_accessor duration_ms: Integer
+
+      attr_accessor files: ::Array[Handinger::Turn::File]
+
+      attr_accessor input: String
+
+      attr_accessor input_tokens: Integer
+
+      attr_accessor output_text: String
+
+      attr_accessor output_tokens: Integer
+
+      attr_accessor role: String
+
+      attr_accessor seq: Integer
+
+      attr_accessor started_at: String
+
+      attr_accessor status: String
+
+      attr_accessor structured_output: ::Hash[Symbol, top]?
+
+      attr_accessor task_id: String
+
+      def initialize: (
+        id: String,
+        completed_at: String?,
+        credits: Integer,
+        duration_ms: Integer,
+        files: ::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: ::Hash[Symbol, top]?,
+        task_id: String
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        completed_at: String?,
+        credits: Integer,
+        duration_ms: Integer,
+        files: ::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: ::Hash[Symbol, top]?,
+        task_id: String
+      }
+
+      type file =
+        { filename: String?, media_type: String, url: String, size: Integer }
+
+      class File < Handinger::Internal::Type::BaseModel
+        attr_accessor filename: String?
+
+        attr_accessor media_type: String
+
+        attr_accessor url: String
+
+        attr_reader size: Integer?
+
+        def size=: (Integer) -> Integer
+
+        def initialize: (
+          filename: String?,
+          media_type: String,
+          url: String,
+          ?size: Integer
+        ) -> void
+
+        def to_hash: -> {
+          filename: String?,
+          media_type: String,
+          url: String,
+          size: Integer
+        }
+      end
+    end
+  end
+end

data/sig/handinger/models/worker.rbs

@@ -204,20 +204,16 @@ module Handinger
         def self?.values: -> ::Array[Handinger::Models::Worker::status]
       end
 
-      type usage = { credits: Integer, duration_ms: Integer }
+      type usage = { duration_ms: Integer }
 
       class Usage < Handinger::Internal::Type::BaseModel
-        attr_reader credits: Integer?
-
-        def credits=: (Integer) -> Integer
-
         attr_reader duration_ms: Integer?
 
         def duration_ms=: (Integer) -> Integer
 
-        def initialize: (?credits: Integer, ?duration_ms: Integer) -> void
+        def initialize: (?duration_ms: Integer) -> void
 
-        def to_hash: -> { credits: Integer, duration_ms: Integer }
+        def to_hash: -> { duration_ms: Integer }
       end
     end
   end

data/sig/handinger/models.rbs

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

data/sig/handinger/resources/tasks.rbs

@@ -12,13 +12,18 @@ module Handinger
       def retrieve: (
         String task_id,
         ?request_options: Handinger::request_opts
-      ) -> Handinger::TaskWithTurns
+      ) -> Handinger::Models::TaskRetrieveResponse
 
       def delete: (
         String task_id,
         ?request_options: Handinger::request_opts
       ) -> Handinger::DeleteTaskResponse
 
+      def list_turns: (
+        String task_id,
+        ?request_options: Handinger::request_opts
+      ) -> Handinger::TaskTurnList
+
       def initialize: (client: Handinger::Client) -> void
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: handinger
 version: !ruby/object:Gem::Version
-  version: 0.12.1
+  version: 0.13.1
 platform: ruby
 authors:
 - Handinger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-17 00:00:00.000000000 Z
+date: 2026-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -76,8 +76,11 @@ files:
 - lib/handinger/models/task.rb
 - lib/handinger/models/task_create_params.rb
 - lib/handinger/models/task_delete_params.rb
+- lib/handinger/models/task_list_turns_params.rb
 - lib/handinger/models/task_retrieve_params.rb
-- lib/handinger/models/task_with_turns.rb
+- lib/handinger/models/task_retrieve_response.rb
+- lib/handinger/models/task_turn_list.rb
+- lib/handinger/models/turn.rb
 - lib/handinger/models/update_worker.rb
 - lib/handinger/models/worker.rb
 - lib/handinger/models/worker_create_params.rb
@@ -135,8 +138,11 @@ files:
 - rbi/handinger/models/task.rbi
 - rbi/handinger/models/task_create_params.rbi
 - rbi/handinger/models/task_delete_params.rbi
+- rbi/handinger/models/task_list_turns_params.rbi
 - rbi/handinger/models/task_retrieve_params.rbi
-- rbi/handinger/models/task_with_turns.rbi
+- rbi/handinger/models/task_retrieve_response.rbi
+- rbi/handinger/models/task_turn_list.rbi
+- rbi/handinger/models/turn.rbi
 - rbi/handinger/models/update_worker.rbi
 - rbi/handinger/models/worker.rbi
 - rbi/handinger/models/worker_create_params.rbi
@@ -193,8 +199,11 @@ files:
 - sig/handinger/models/task.rbs
 - sig/handinger/models/task_create_params.rbs
 - sig/handinger/models/task_delete_params.rbs
+- sig/handinger/models/task_list_turns_params.rbs
 - sig/handinger/models/task_retrieve_params.rbs
-- sig/handinger/models/task_with_turns.rbs
+- sig/handinger/models/task_retrieve_response.rbs
+- sig/handinger/models/task_turn_list.rbs
+- sig/handinger/models/turn.rbs
 - sig/handinger/models/update_worker.rbs
 - sig/handinger/models/worker.rbs
 - sig/handinger/models/worker_create_params.rbs

data/lib/handinger/models/task_with_turns.rb

@@ -1,131 +0,0 @@
-# frozen_string_literal: true
-
-module Handinger
-  module Models
-    # @see Handinger::Resources::Tasks#retrieve
-    class TaskWithTurns < Handinger::Internal::Type::BaseModel
-      # @!attribute task
-      #
-      #   @return [Handinger::Models::Task]
-      required :task, -> { Handinger::Task }
-
-      # @!attribute turns
-      #
-      #   @return [Array<Handinger::Models::TaskWithTurns::Turn>]
-      required :turns, -> { Handinger::Internal::Type::ArrayOf[Handinger::TaskWithTurns::Turn] }
-
-      # @!method initialize(task:, turns:)
-      #   @param task [Handinger::Models::Task]
-      #   @param turns [Array<Handinger::Models::TaskWithTurns::Turn>]
-
-      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 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:, 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 [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] Structured JSON payload when the worker is configured with an output schema. `nu
-        #
-        #   @param task_id [String]
-      end
-    end
-  end
-end

data/rbi/handinger/models/task_with_turns.rbi

@@ -1,153 +0,0 @@
-# typed: strong
-
-module Handinger
-  module Models
-    class TaskWithTurns < Handinger::Internal::Type::BaseModel
-      OrHash =
-        T.type_alias do
-          T.any(Handinger::TaskWithTurns, Handinger::Internal::AnyHash)
-        end
-
-      sig { returns(Handinger::Task) }
-      attr_reader :task
-
-      sig { params(task: Handinger::Task::OrHash).void }
-      attr_writer :task
-
-      sig { returns(T::Array[Handinger::TaskWithTurns::Turn]) }
-      attr_accessor :turns
-
-      sig do
-        params(
-          task: Handinger::Task::OrHash,
-          turns: T::Array[Handinger::TaskWithTurns::Turn::OrHash]
-        ).returns(T.attached_class)
-      end
-      def self.new(task:, turns:)
-      end
-
-      sig do
-        override.returns(
-          {
-            task: Handinger::Task,
-            turns: T::Array[Handinger::TaskWithTurns::Turn]
-          }
-        )
-      end
-      def to_hash
-      end
-
-      class Turn < Handinger::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(Handinger::TaskWithTurns::Turn, Handinger::Internal::AnyHash)
-          end
-
-        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
-
-        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,
-            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:,
-          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,
-              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
-      end
-    end
-  end
-end