handinger 0.12.1 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2031c5f448c9fe88ec00aca80a617c9a615b6c4bdba6c92ec6571a9d13b7fe5
-  data.tar.gz: 750e8fdacbc62754fde586ef760b5e985509dd257ee78993435f7f0f6dd384f8
+  metadata.gz: 9b96d81d9398bdd5ea67ae91d9bcf3b3e3d498c52280ba116e6eb6a3f3273fbe
+  data.tar.gz: 85ffb7daef655eae2825d41ffd079355198db1f4dc3f616a6d6e5e523bc7c255
 SHA512:
-  metadata.gz: f5b48117d32135846d6c341ee044db8be296df0b0eb672b9ffbae5bcf9dfe6432ce72dbde3e020f8fd9c7dfd19ffd96fd97eceb9e15e8f68e717b6f23c3cd0fe
-  data.tar.gz: 5f03e07b7b20b39a6f4c8dcbd35afdd206e8d21a77150fa0e60b8152007d45dace54da9b0ad15115a0d5f99ac75483cc57896e92be1639624ad07d5e92f5598e
+  metadata.gz: 8c54723c88d55fc9f17e389d88014c7c925255d00e361e2d08cbf4a8a4552619b5df03228747f96ab216fbb1632432d4c15d5d0f31e12ce134efb041ca189b5d
+  data.tar.gz: 0c9665fed05a9e941cf1f0cac4d2d40297fb1074c114c8cf5e3647e67f76540e0c52195e79b9af3d984a83ab61a9ed8af6dba6a7d60aecf0f56248ebf46b86c2

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/handinger/models/task_with_turns.rb

@@ -39,6 +39,12 @@ module Handinger
         #   @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]
@@ -94,7 +100,7 @@ module Handinger
         #   @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:)
+        # @!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.
         #
@@ -106,6 +112,8 @@ module Handinger
         #
         #   @param duration_ms [Integer]
         #
+        #   @param files [Array<Handinger::Models::TaskWithTurns::Turn::File>] Files published by this turn.
+        #
         #   @param input [String]
         #
         #   @param input_tokens [Integer]
@@ -125,6 +133,34 @@ module Handinger
         #   @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/version.rb

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

data/rbi/handinger/models/task_with_turns.rbi

@@ -55,6 +55,10 @@ module Handinger
         sig { returns(Integer) }
         attr_accessor :duration_ms
 
+        # Files published by this turn.
+        sig { returns(T::Array[Handinger::TaskWithTurns::Turn::File]) }
+        attr_accessor :files
+
         sig { returns(String) }
         attr_accessor :input
 
@@ -93,6 +97,7 @@ module Handinger
             completed_at: T.nilable(String),
             credits: Integer,
             duration_ms: Integer,
+            files: T::Array[Handinger::TaskWithTurns::Turn::File::OrHash],
             input: String,
             input_tokens: Integer,
             output_text: String,
@@ -110,6 +115,8 @@ module Handinger
           completed_at:,
           credits:,
           duration_ms:,
+          # Files published by this turn.
+          files:,
           input:,
           input_tokens:,
           output_text:,
@@ -132,6 +139,7 @@ module Handinger
               completed_at: T.nilable(String),
               credits: Integer,
               duration_ms: Integer,
+              files: T::Array[Handinger::TaskWithTurns::Turn::File],
               input: String,
               input_tokens: Integer,
               output_text: String,
@@ -147,6 +155,55 @@ module Handinger
         end
         def to_hash
         end
+
+        class File < Handinger::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Handinger::TaskWithTurns::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/sig/handinger/models/task_with_turns.rbs

@@ -24,6 +24,7 @@ module Handinger
           completed_at: String?,
           credits: Integer,
           duration_ms: Integer,
+          files: ::Array[Handinger::TaskWithTurns::Turn::File],
           input: String,
           input_tokens: Integer,
           output_text: String,
@@ -45,6 +46,8 @@ module Handinger
 
         attr_accessor duration_ms: Integer
 
+        attr_accessor files: ::Array[Handinger::TaskWithTurns::Turn::File]
+
         attr_accessor input: String
 
         attr_accessor input_tokens: Integer
@@ -70,6 +73,7 @@ module Handinger
           completed_at: String?,
           credits: Integer,
           duration_ms: Integer,
+          files: ::Array[Handinger::TaskWithTurns::Turn::File],
           input: String,
           input_tokens: Integer,
           output_text: String,
@@ -87,6 +91,7 @@ module Handinger
           completed_at: String?,
           credits: Integer,
           duration_ms: Integer,
+          files: ::Array[Handinger::TaskWithTurns::Turn::File],
           input: String,
           input_tokens: Integer,
           output_text: String,
@@ -98,6 +103,35 @@ module Handinger
           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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: handinger
 version: !ruby/object:Gem::Version
-  version: 0.12.1
+  version: 0.13.0
 platform: ruby
 authors:
 - Handinger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-17 00:00:00.000000000 Z
+date: 2026-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi