handinger 0.0.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db02eb1d7aab2f238e5d877338bfc035ef7e45302fb38843a88c5f5dcffb52f8
-  data.tar.gz: b08be745f2c5e418e306307934152b57c74e19edebba9500bb877bd2e1d245e7
+  metadata.gz: 1ae7f9037381d42cd6aa3a76e17a2d9fabd3d181ec11de76508cfab052ec59f8
+  data.tar.gz: 860f3d892ca6812067ec4c75813980af4a78465eb9082777b78f12023c78bf65
 SHA512:
-  metadata.gz: 31e1ed12a630550e9d5569a9be34aeb383e3afad565c1d39642a5dfa5c855b72c4c223cf1ab4b9c78d0404d625fa9237e5d103f0e353d47cd37c4ae6e45bd1ff
-  data.tar.gz: c69f006ce101cdfe879d4ba6d6b9160f53ec5903a576b4ee3203e0819b12023b2fea28c30e38ced0e35f8a6c54a4a1609d36fc33acd28c2325e297d142387234
+  metadata.gz: 4b7755b6f5b51e59b2f5f909b938ac4afa885e000db0b042b3a5fc433a59ff7f8b037ee2b462ca813290940db0c2de4ba11a5311fb18a38a893bf6448c265b37
+  data.tar.gz: '09e651e70da0ca7df7fe4f72e11518e77e3a3cc0305ec5e0eb18f21af8cb81f90b67a304ef8fd88437ec6e4ed0eff52157c0937e88bf557636bee80e7afab7a3'

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 0.2.0 (2026-05-09)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/Ramensoft/handinger-ruby/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* Add JSON Schema output validation and structured display ([d2d009f](https://github.com/Ramensoft/handinger-ruby/commit/d2d009fef801e296238abb13f66980523f6fe635))
+* Add worker avatars and summaries with edit UI ([9363cd1](https://github.com/Ramensoft/handinger-ruby/commit/9363cd185a2973a889324097215bff9c3f4fe59d))
+* **api:** api update ([24ba9a1](https://github.com/Ramensoft/handinger-ruby/commit/24ba9a1bacb86f4f72dc6599223678c34fb40eb8))
+* **api:** api update ([05d22fc](https://github.com/Ramensoft/handinger-ruby/commit/05d22fc5b3de4a8c4115ef234b362f667fc08eb7))
+* **api:** api update ([edee7a7](https://github.com/Ramensoft/handinger-ruby/commit/edee7a788bda863304a5b3216abdf6d9273dc95e))
+* **api:** api update ([a335064](https://github.com/Ramensoft/handinger-ruby/commit/a335064d021768f799f38c2a5d8766d42b36816c))
+* File uploads ([d7fd499](https://github.com/Ramensoft/handinger-ruby/commit/d7fd499cfc7a9d0d15875b3f4e0ebc0571177f15))
+* Le big refactor ([9631a55](https://github.com/Ramensoft/handinger-ruby/commit/9631a55979db401c85faf3d90ac827aea41dd19d))
+* Overhaul email/permissions and ids ([e686bb8](https://github.com/Ramensoft/handinger-ruby/commit/e686bb8e9de4e492083c7ca3bf47d89662bb141b))
+* support setting headers via env ([cf53d6e](https://github.com/Ramensoft/handinger-ruby/commit/cf53d6ed1323a7253e9c5ffc03047ac2b9f1aeb7))
+
+
+### Bug Fixes
+
+* avoid gzip buffering during streaming ([7d1e1bc](https://github.com/Ramensoft/handinger-ruby/commit/7d1e1bcd465f422cc6e1b5fce68c308f25030cd5))
+
+
+### Chores
+
+* **internal:** more robust bootstrap script ([61ba919](https://github.com/Ramensoft/handinger-ruby/commit/61ba919436fe1ccdf663b8822904623421ee773c))
+
+## 0.1.0 (2026-04-23)
+
+Full Changelog: [v0.0.2...v0.1.0](https://github.com/Ramensoft/handinger-ruby/compare/v0.0.2...v0.1.0)
+
+### Features
+
+* **api:** api update ([5c0591e](https://github.com/Ramensoft/handinger-ruby/commit/5c0591e29115cea09ef85378a030154bef123afb))
+
 ## 0.0.2 (2026-04-23)
 
 Full Changelog: [v0.0.1...v0.0.2](https://github.com/Ramensoft/handinger-ruby/compare/v0.0.1...v0.0.2)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "handinger", "~> 0.0.2"
+gem "handinger", "~> 0.2.0"
 ```
 
 <!-- x-release-please-end -->
@@ -30,7 +30,7 @@ handinger = Handinger::Client.new(
   api_key: ENV["HANDINGER_API_KEY"] # This is the default and can be omitted
 )
 
-worker = handinger.workers.create(input: "What's the weather today in Barcelona?")
+worker = handinger.tasks.create(worker_id: "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM")
 
 puts(worker.id)
 ```
@@ -41,7 +41,7 @@ When the library is unable to connect to the API, or if the API returns a non-su
 
 ```ruby
 begin
-  worker = handinger.workers.create(input: "What's the weather today in Barcelona?")
+  task = handinger.tasks.create(worker_id: "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM")
 rescue Handinger::Errors::APIConnectionError => e
   puts("The server could not be reached")
   puts(e.cause)  # an underlying Exception, likely raised within `net/http`
@@ -84,8 +84,8 @@ handinger = Handinger::Client.new(
 )
 
 # Or, configure per-request:
-handinger.workers.create(
-  input: "What's the weather today in Barcelona?",
+handinger.tasks.create(
+  worker_id: "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM",
   request_options: {max_retries: 5}
 )
 ```
@@ -101,7 +101,7 @@ handinger = Handinger::Client.new(
 )
 
 # Or, configure per-request:
-handinger.workers.create(input: "What's the weather today in Barcelona?", request_options: {timeout: 5})
+handinger.tasks.create(worker_id: "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM", request_options: {timeout: 5})
 ```
 
 On timeout, `Handinger::Errors::APITimeoutError` is raised.
@@ -132,8 +132,8 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 
 ```ruby
 worker =
-  handinger.workers.create(
-    input: "What's the weather today in Barcelona?",
+  handinger.tasks.create(
+    worker_id: "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM",
     request_options: {
       extra_query: {my_query_parameter: value},
       extra_body: {my_body_parameter: value},
@@ -179,18 +179,18 @@ This library provides comprehensive [RBI](https://sorbet.org/docs/rbi) definitio
 You can provide typesafe request parameters like so:
 
 ```ruby
-handinger.workers.create(input: "What's the weather today in Barcelona?")
+handinger.tasks.create(worker_id: "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM")
 ```
 
 Or, equivalently:
 
 ```ruby
 # Hashes work, but are not typesafe:
-handinger.workers.create(input: "What's the weather today in Barcelona?")
+handinger.tasks.create(worker_id: "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM")
 
 # You can also splat a full Params class:
-params = Handinger::WorkerCreateParams.new(input: "What's the weather today in Barcelona?")
-handinger.workers.create(**params)
+params = Handinger::TaskCreateParams.new(worker_id: "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM")
+handinger.tasks.create(**params)
 ```
 
 ### Enums
@@ -198,11 +198,11 @@ handinger.workers.create(**params)
 Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
 
 ```ruby
-# :low
-puts(Handinger::CreateWorker::Budget::LOW)
+# :public
+puts(Handinger::CreateWorker::Visibility::PUBLIC)
 
-# Revealed type: `T.all(Handinger::CreateWorker::Budget, Symbol)`
-T.reveal_type(Handinger::CreateWorker::Budget::LOW)
+# Revealed type: `T.all(Handinger::CreateWorker::Visibility, Symbol)`
+T.reveal_type(Handinger::CreateWorker::Visibility::PUBLIC)
 ```
 
 Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
@@ -210,13 +210,13 @@ Enum parameters have a "relaxed" type, so you can either pass in enum constants
 ```ruby
 # Using the enum constants preserves the tagged type information:
 handinger.workers.create(
-  budget: Handinger::CreateWorker::Budget::LOW,
+  visibility: Handinger::CreateWorker::Visibility::PUBLIC,
   # …
 )
 
 # Literal values are also permissible:
 handinger.workers.create(
-  budget: :low,
+  visibility: :public,
   # …
 )
 ```

data/lib/handinger/client.rb

@@ -18,9 +18,14 @@ module Handinger
     # @return [String]
     attr_reader :api_key
 
+    # Create, retrieve, and manage agent worker templates.
     # @return [Handinger::Resources::Workers]
     attr_reader :workers
 
+    # Run and inspect tasks against a worker.
+    # @return [Handinger::Resources::Tasks]
+    attr_reader :tasks
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -58,6 +63,19 @@ module Handinger
         raise ArgumentError.new("api_key is required, and can be set via environ: \"HANDINGER_API_KEY\"")
       end
 
+      headers = {}
+      custom_headers_env = ENV["HANDINGER_CUSTOM_HEADERS"]
+      unless custom_headers_env.nil?
+        parsed = {}
+        custom_headers_env.split("\n").each do |line|
+          colon = line.index(":")
+          unless colon.nil?
+            parsed[line[0...colon].strip] = line[(colon + 1)..].strip
+          end
+        end
+        headers = parsed.merge(headers)
+      end
+
       @api_key = api_key.to_s
 
       super(
@@ -65,10 +83,12 @@ module Handinger
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay
+        max_retry_delay: max_retry_delay,
+        headers: headers
       )
 
       @workers = Handinger::Resources::Workers.new(client: self)
+      @tasks = Handinger::Resources::Tasks.new(client: self)
     end
   end
 end

data/lib/handinger/internal/transport/base_client.rb

@@ -549,9 +549,7 @@ module Handinger
                 )
               ),
               page: T.nilable(T::Class[Handinger::Internal::Type::BasePage[Handinger::Internal::Type::BaseModel]]),
-              stream: T.nilable(
-                T::Class[Handinger::Internal::Type::BaseStream[T.anything, Handinger::Internal::Type::BaseModel]]
-              ),
+              stream: T.nilable(T::Class[T.anything]),
               model: T.nilable(Handinger::Internal::Type::Converter::Input),
               options: T.nilable(Handinger::RequestOptions::OrHash)
             }

data/lib/handinger/internal/type/base_model.rb

@@ -440,9 +440,9 @@ module Handinger
         # @example
         #   # `create_worker` is a `Handinger::CreateWorker`
         #   create_worker => {
-        #     input: input,
-        #     budget: budget,
-        #     stream: stream
+        #     instructions: instructions,
+        #     output_schema: output_schema,
+        #     prompt: prompt
         #   }
         def deconstruct_keys(keys)
           (keys || self.class.known_fields.keys)

data/lib/handinger/models/create_task.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Handinger
+  module Models
+    class CreateTask < Handinger::Models::CreateWorker
+      # @!attribute worker_id
+      #   Worker id the task belongs to.
+      #
+      #   @return [String]
+      required :worker_id, String, api_name: :workerId
+
+      # @!attribute task_id
+      #   Optional client-provided task id. Reuse this id to add turns to an existing
+      #   task.
+      #
+      #   @return [String, nil]
+      optional :task_id, String, api_name: :taskId
+
+      # @!method initialize(worker_id:, task_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Handinger::Models::CreateTask} for more details.
+      #
+      #   @param worker_id [String] Worker id the task belongs to.
+      #
+      #   @param task_id [String] Optional client-provided task id. Reuse this id to add turns to an existing task
+    end
+  end
+end

data/lib/handinger/models/create_worker.rb

@@ -3,34 +3,74 @@
 module Handinger
   module Models
     class CreateWorker < Handinger::Internal::Type::BaseModel
-      # @!attribute input
+      # @!attribute instructions
+      #   Persistent system prompt the worker uses for every task it runs.
       #
-      #   @return [String]
-      required :input, String
+      #   @return [String, nil]
+      optional :instructions, String
 
-      # @!attribute budget
+      # @!attribute output_schema
+      #   Optional JSON Schema (Draft-07) describing the structured object the worker must
+      #   produce. When set, every task response is validated against the schema and
+      #   exposed as `structuredOutput`.
       #
-      #   @return [Symbol, Handinger::Models::CreateWorker::Budget, nil]
-      optional :budget, enum: -> { Handinger::CreateWorker::Budget }
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :output_schema,
+               Handinger::Internal::Type::HashOf[Handinger::Internal::Type::Unknown],
+               api_name: :outputSchema
 
-      # @!attribute stream
+      # @!attribute prompt
+      #   Natural-language description of the worker to use for AI-generated instructions
+      #   when `instructions` is omitted.
       #
-      #   @return [Boolean, nil]
-      optional :stream, Handinger::Internal::Type::Boolean
+      #   @return [String, nil]
+      optional :prompt, String
 
-      # @!method initialize(input:, budget: nil, stream: nil)
-      #   @param input [String]
-      #   @param budget [Symbol, Handinger::Models::CreateWorker::Budget]
-      #   @param stream [Boolean]
+      # @!attribute summary
+      #   Short one-line description of the worker's purpose. Auto-generated when omitted
+      #   and a `prompt` is provided.
+      #
+      #   @return [String, nil]
+      optional :summary, String
+
+      # @!attribute title
+      #   Optional display name. When omitted, Handinger assigns a random dog-themed name.
+      #
+      #   @return [String, nil]
+      optional :title, String
 
-      # @see Handinger::Models::CreateWorker#budget
-      module Budget
+      # @!attribute visibility
+      #   `public` (default) is visible to all org members. `private` is only visible to
+      #   invited members.
+      #
+      #   @return [Symbol, Handinger::Models::CreateWorker::Visibility, nil]
+      optional :visibility, enum: -> { Handinger::CreateWorker::Visibility }
+
+      # @!method initialize(instructions: nil, output_schema: nil, prompt: nil, summary: nil, title: nil, visibility: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Handinger::Models::CreateWorker} for more details.
+      #
+      #   @param instructions [String] Persistent system prompt the worker uses for every task it runs.
+      #
+      #   @param output_schema [Hash{Symbol=>Object}] Optional JSON Schema (Draft-07) describing the structured object the worker must
+      #
+      #   @param prompt [String] Natural-language description of the worker to use for AI-generated instructions
+      #
+      #   @param summary [String] Short one-line description of the worker's purpose. Auto-generated when omitted
+      #
+      #   @param title [String] Optional display name. When omitted, Handinger assigns a random dog-themed name.
+      #
+      #   @param visibility [Symbol, Handinger::Models::CreateWorker::Visibility] `public` (default) is visible to all org members. `private` is only visible to i
+
+      # `public` (default) is visible to all org members. `private` is only visible to
+      # invited members.
+      #
+      # @see Handinger::Models::CreateWorker#visibility
+      module Visibility
         extend Handinger::Internal::Type::Enum
 
-        LOW = :low
-        STANDARD = :standard
-        HIGH = :high
-        UNLIMITED = :unlimited
+        PUBLIC = :public
+        PRIVATE = :private
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/handinger/models/task.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module Handinger
+  module Models
+    class Task < 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 created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute created_by_user_id
+      #
+      #   @return [String, nil]
+      required :created_by_user_id, String, api_name: :createdByUserId, nil?: true
+
+      # @!attribute organization_id
+      #
+      #   @return [String]
+      required :organization_id, String, api_name: :organizationId
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Handinger::Models::Task::Status]
+      required :status, enum: -> { Handinger::Task::Status }
+
+      # @!attribute title
+      #
+      #   @return [String]
+      required :title, String
+
+      # @!attribute totals
+      #
+      #   @return [Handinger::Models::Task::Totals]
+      required :totals, -> { Handinger::Task::Totals }
+
+      # @!attribute triggered_by
+      #
+      #   @return [Symbol, Handinger::Models::Task::TriggeredBy]
+      required :triggered_by, enum: -> { Handinger::Task::TriggeredBy }, api_name: :triggeredBy
+
+      # @!attribute worker_id
+      #
+      #   @return [String]
+      required :worker_id, String, api_name: :workerId
+
+      # @!method initialize(id:, completed_at:, created_at:, created_by_user_id:, organization_id:, status:, title:, totals:, triggered_by:, worker_id:)
+      #   @param id [String]
+      #   @param completed_at [String, nil]
+      #   @param created_at [String]
+      #   @param created_by_user_id [String, nil]
+      #   @param organization_id [String]
+      #   @param status [Symbol, Handinger::Models::Task::Status]
+      #   @param title [String]
+      #   @param totals [Handinger::Models::Task::Totals]
+      #   @param triggered_by [Symbol, Handinger::Models::Task::TriggeredBy]
+      #   @param worker_id [String]
+
+      # @see Handinger::Models::Task#status
+      module Status
+        extend Handinger::Internal::Type::Enum
+
+        PENDING = :pending
+        RUNNING = :running
+        COMPLETED = :completed
+        ERROR = :error
+        ABORTED = :aborted
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Handinger::Models::Task#totals
+      class Totals < Handinger::Internal::Type::BaseModel
+        # @!attribute credits
+        #
+        #   @return [Float]
+        required :credits, Float
+
+        # @!attribute duration_ms
+        #
+        #   @return [Float]
+        required :duration_ms, Float, api_name: :durationMs
+
+        # @!attribute turn_count
+        #
+        #   @return [Float]
+        required :turn_count, Float, api_name: :turnCount
+
+        # @!method initialize(credits:, duration_ms:, turn_count:)
+        #   @param credits [Float]
+        #   @param duration_ms [Float]
+        #   @param turn_count [Float]
+      end
+
+      # @see Handinger::Models::Task#triggered_by
+      module TriggeredBy
+        extend Handinger::Internal::Type::Enum
+
+        API = :api
+        EMAIL = :email
+        SCHEDULE = :schedule
+        UI = :ui
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/handinger/models/task_create_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Handinger
+  module Models
+    # @see Handinger::Resources::Tasks#create
+    class TaskCreateParams < Handinger::Models::CreateTask
+      extend Handinger::Internal::Type::RequestParameters::Converter
+      include Handinger::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/handinger/models/{worker_continue_params.rb → task_retrieve_params.rb}

@@ -2,18 +2,18 @@
 
 module Handinger
   module Models
-    # @see Handinger::Resources::Workers#continue
-    class WorkerContinueParams < Handinger::Models::CreateWorker
+    # @see Handinger::Resources::Tasks#retrieve
+    class TaskRetrieveParams < Handinger::Internal::Type::BaseModel
       extend Handinger::Internal::Type::RequestParameters::Converter
       include Handinger::Internal::Type::RequestParameters
 
-      # @!attribute worker_id
+      # @!attribute task_id
       #
       #   @return [String]
-      required :worker_id, String
+      required :task_id, String
 
-      # @!method initialize(worker_id:, request_options: {})
-      #   @param worker_id [String]
+      # @!method initialize(task_id:, request_options: {})
+      #   @param task_id [String]
       #   @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/handinger/models/task_with_turns.rb

@@ -0,0 +1,113 @@
+# 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 [Float]
+        required :credits, Float
+
+        # @!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
+        #
+        #   @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:)
+        #   @param id [String]
+        #   @param completed_at [String, nil]
+        #   @param credits [Float]
+        #   @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]
+        #   @param task_id [String]
+      end
+    end
+  end
+end