handinger 0.13.0 → 0.14.0

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/workers/schedule_list_response.rbi

@@ -15,6 +15,9 @@ module Handinger
         sig { returns(T::Array[Handinger::Workers::WorkerSchedule::Variants]) }
         attr_accessor :schedules
 
+        sig { returns(String) }
+        attr_accessor :timezone
+
         sig { returns(String) }
         attr_accessor :worker_id
 
@@ -29,16 +32,18 @@ module Handinger
                   Handinger::Workers::WorkerSchedule::Interval::OrHash
                 )
               ],
+            timezone: String,
             worker_id: String
           ).returns(T.attached_class)
         end
-        def self.new(schedules:, worker_id:)
+        def self.new(schedules:, timezone:, worker_id:)
         end
 
         sig do
           override.returns(
             {
               schedules: T::Array[Handinger::Workers::WorkerSchedule::Variants],
+              timezone: String,
               worker_id: String
             }
           )

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
 

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/workers/schedule_list_response.rbs

@@ -4,21 +4,26 @@ module Handinger
       type schedule_list_response =
         {
           schedules: ::Array[Handinger::Models::Workers::worker_schedule],
+          timezone: String,
           worker_id: String
         }
 
       class ScheduleListResponse < Handinger::Internal::Type::BaseModel
         attr_accessor schedules: ::Array[Handinger::Models::Workers::worker_schedule]
 
+        attr_accessor timezone: String
+
         attr_accessor worker_id: String
 
         def initialize: (
           schedules: ::Array[Handinger::Models::Workers::worker_schedule],
+          timezone: String,
           worker_id: String
         ) -> void
 
         def to_hash: -> {
           schedules: ::Array[Handinger::Models::Workers::worker_schedule],
+          timezone: String,
           worker_id: String
         }
       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.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Handinger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-23 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,167 +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 files
-        #   Files published by this turn.
-        #
-        #   @return [Array<Handinger::Models::TaskWithTurns::Turn::File>]
-        required :files, -> { Handinger::Internal::Type::ArrayOf[Handinger::TaskWithTurns::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::TaskWithTurns::Turn} for more details.
-        #
-        #   @param id [String]
-        #
-        #   @param completed_at [String, nil]
-        #
-        #   @param credits [Integer]
-        #
-        #   @param duration_ms [Integer]
-        #
-        #   @param files [Array<Handinger::Models::TaskWithTurns::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
-end