handinger 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a53acab611d6eb55ba8f32f3b21854f6d936ff7fc2bdc0bda9da0394040bd3af
-  data.tar.gz: 3f7daaeb057baa8ebf48a03e2db9a5d83706c3bdf3d46377337103be73bb569f
+  metadata.gz: ecd40670a310e06ad0f0b33baa0f620b434bb11398f45a9e44e9c536533441bd
+  data.tar.gz: 18bf80c24a1126bb839e73146ec8d5aab5c62aba54fbdf8d56f32a0fb3c97ec1
 SHA512:
-  metadata.gz: 22c03ed4a0641b1b16427f0928804b695cb23923534a9abb233a47a247ecd94a77f0a34553c3658de15a556979abd85e10af7ae6a7e25fe07e48234db1d63c40
-  data.tar.gz: 5e0bc25dc0a11ed63751c99f7d06ae807b778865bf5c96e6f141f9f5e40d512c95d9b740d4a99bd4ba50435f6889351659defb4340ad8fe8901c75f76bf452eb
+  metadata.gz: 7520dd4bf1e744831db561b4bc1af8ac9aea2c767f5f477e81604a6d7b1a4a45fc70328bf569832e774eed201bf7bff0ea0c6a80c015f6fea1130caeb6367b91
+  data.tar.gz: 40b7e0965ddc840e39988a2d3659d31d3a47074770054149e4c31534ddbee84162eb16ab61ae0831b8dba59b6bd312691223526e06c0dae9a8ff269fef63465f

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.5.0 (2026-05-11)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/Ramensoft/handinger-ruby/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* Duplicate workers ([95c3bab](https://github.com/Ramensoft/handinger-ruby/commit/95c3babf3d9e97ad4d0b410f90c601e3613bdbee))
+
+
+### Chores
+
+* remove custom code ([e9cece7](https://github.com/Ramensoft/handinger-ruby/commit/e9cece7ce4e8a03e89b558253048b19f2872f27a))
+
+## 0.4.0 (2026-05-11)
+
+Full Changelog: [v0.3.0...v0.4.0](https://github.com/Ramensoft/handinger-ruby/compare/v0.3.0...v0.4.0)
+
+### Features
+
+* Add worker and task url ([f1ebd4a](https://github.com/Ramensoft/handinger-ruby/commit/f1ebd4a48111a66ccc69f6b5bdec5c861a4c07b9))
+
 ## 0.3.0 (2026-05-11)
 
 Full Changelog: [v0.2.0...v0.3.0](https://github.com/Ramensoft/handinger-ruby/compare/v0.2.0...v0.3.0)

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.3.0"
+gem "handinger", "~> 0.5.0"
 ```
 
 <!-- x-release-please-end -->
@@ -32,7 +32,7 @@ handinger = Handinger::Client.new(
   api_key: ENV["HANDINGER_API_KEY"] # This is the default and can be omitted
 )
 
-worker = handinger.tasks.create(worker_id: "wrk_vk81XUHKHG-qr4")
+worker = handinger.tasks.create(input: "What's the weather today in Barcelona?", worker_id: "wrk_vk81XUHKHG-qr4")
 
 puts(worker.id)
 ```
@@ -43,7 +43,7 @@ When the library is unable to connect to the API, or if the API returns a non-su
 
 ```ruby
 begin
-  task = handinger.tasks.create(worker_id: "wrk_vk81XUHKHG-qr4")
+  task = handinger.tasks.create(input: "What's the weather today in Barcelona?", worker_id: "wrk_vk81XUHKHG-qr4")
 rescue Handinger::Errors::APIConnectionError => e
   puts("The server could not be reached")
   puts(e.cause)  # an underlying Exception, likely raised within `net/http`
@@ -86,7 +86,11 @@ handinger = Handinger::Client.new(
 )
 
 # Or, configure per-request:
-handinger.tasks.create(worker_id: "wrk_vk81XUHKHG-qr4", request_options: {max_retries: 5})
+handinger.tasks.create(
+  input: "What's the weather today in Barcelona?",
+  worker_id: "wrk_vk81XUHKHG-qr4",
+  request_options: {max_retries: 5}
+)
 ```
 
 ### Timeouts
@@ -100,7 +104,11 @@ handinger = Handinger::Client.new(
 )
 
 # Or, configure per-request:
-handinger.tasks.create(worker_id: "wrk_vk81XUHKHG-qr4", request_options: {timeout: 5})
+handinger.tasks.create(
+  input: "What's the weather today in Barcelona?",
+  worker_id: "wrk_vk81XUHKHG-qr4",
+  request_options: {timeout: 5}
+)
 ```
 
 On timeout, `Handinger::Errors::APITimeoutError` is raised.
@@ -132,6 +140,7 @@ Note: the `extra_` parameters of the same name overrides the documented paramete
 ```ruby
 worker =
   handinger.tasks.create(
+    input: "What's the weather today in Barcelona?",
     worker_id: "wrk_vk81XUHKHG-qr4",
     request_options: {
       extra_query: {my_query_parameter: value},
@@ -178,17 +187,20 @@ This library provides comprehensive [RBI](https://sorbet.org/docs/rbi) definitio
 You can provide typesafe request parameters like so:
 
 ```ruby
-handinger.tasks.create(worker_id: "wrk_vk81XUHKHG-qr4")
+handinger.tasks.create(input: "What's the weather today in Barcelona?", worker_id: "wrk_vk81XUHKHG-qr4")
 ```
 
 Or, equivalently:
 
 ```ruby
 # Hashes work, but are not typesafe:
-handinger.tasks.create(worker_id: "wrk_vk81XUHKHG-qr4")
+handinger.tasks.create(input: "What's the weather today in Barcelona?", worker_id: "wrk_vk81XUHKHG-qr4")
 
 # You can also splat a full Params class:
-params = Handinger::TaskCreateParams.new(worker_id: "wrk_vk81XUHKHG-qr4")
+params = Handinger::TaskCreateParams.new(
+  input: "What's the weather today in Barcelona?",
+  worker_id: "wrk_vk81XUHKHG-qr4"
+)
 handinger.tasks.create(**params)
 ```
 

data/lib/handinger/client.rb

@@ -57,7 +57,7 @@ module Handinger
       initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
       max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY
     )
-      base_url ||= "https://v3.handinger.com"
+      base_url ||= "https://handinger.com"
 
       if api_key.nil?
         raise ArgumentError.new("api_key is required, and can be set via environ: \"HANDINGER_API_KEY\"")

data/lib/handinger/models/create_task.rb

@@ -2,12 +2,21 @@
 
 module Handinger
   module Models
-    class CreateTask < Handinger::Models::CreateWorker
-      # @!attribute worker_id
-      #   Worker id the task belongs to.
+    class CreateTask < Handinger::Internal::Type::BaseModel
+      # @!attribute input
       #
       #   @return [String]
-      required :worker_id, String, api_name: :workerId
+      required :input, String
+
+      # @!attribute budget
+      #
+      #   @return [Symbol, Handinger::Models::CreateTask::Budget, nil]
+      optional :budget, enum: -> { Handinger::CreateTask::Budget }
+
+      # @!attribute stream
+      #
+      #   @return [Boolean, nil]
+      optional :stream, Handinger::Internal::Type::Boolean
 
       # @!attribute task_id
       #   Optional client-provided task id. Reuse this id to add turns to an existing
@@ -16,13 +25,39 @@ module Handinger
       #   @return [String, nil]
       optional :task_id, String, api_name: :taskId
 
-      # @!method initialize(worker_id:, task_id: nil)
+      # @!attribute worker_id
+      #   Worker id the task belongs to. If omitted, a new worker is created on-the-fly
+      #   using the input as instructions.
+      #
+      #   @return [String, nil]
+      optional :worker_id, String, api_name: :workerId
+
+      # @!method initialize(input:, budget: nil, stream: nil, task_id: nil, worker_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 input [String]
+      #
+      #   @param budget [Symbol, Handinger::Models::CreateTask::Budget]
+      #
+      #   @param stream [Boolean]
       #
       #   @param task_id [String] Optional client-provided task id. Reuse this id to add turns to an existing task
+      #
+      #   @param worker_id [String] Worker id the task belongs to. If omitted, a new worker is created on-the-fly us
+
+      # @see Handinger::Models::CreateTask#budget
+      module Budget
+        extend Handinger::Internal::Type::Enum
+
+        LOW = :low
+        STANDARD = :standard
+        HIGH = :high
+        UNLIMITED = :unlimited
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/handinger/models/task.rb

@@ -48,21 +48,38 @@ module Handinger
       #   @return [Symbol, Handinger::Models::Task::TriggeredBy]
       required :triggered_by, enum: -> { Handinger::Task::TriggeredBy }, api_name: :triggeredBy
 
+      # @!attribute url
+      #   Web URL of the task in the Handinger dashboard.
+      #
+      #   @return [String]
+      required :url, String
+
       # @!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:)
+      # @!method initialize(id:, completed_at:, created_at:, created_by_user_id:, organization_id:, status:, title:, totals:, triggered_by:, url:, 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 url [String] Web URL of the task in the Handinger dashboard.
+      #
       #   @param worker_id [String]
 
       # @see Handinger::Models::Task#status

data/lib/handinger/models/worker.rb

@@ -76,26 +76,48 @@ module Handinger
                Handinger::Internal::Type::HashOf[Handinger::Internal::Type::Unknown],
                nil?: true
 
+      # @!attribute url
+      #   Web URL of the worker in the Handinger dashboard.
+      #
+      #   @return [String]
+      required :url, String
+
       # @!attribute usage
       #
       #   @return [Handinger::Models::Worker::Usage, nil]
       optional :usage, -> { Handinger::Worker::Usage }
 
-      # @!method initialize(id:, created_at:, error:, files:, incomplete_details:, messages:, metadata:, object:, output:, output_text:, running:, sources:, status:, structured_output:, usage: nil)
+      # @!method initialize(id:, created_at:, error:, files:, incomplete_details:, messages:, metadata:, object:, output:, output_text:, running:, sources:, status:, structured_output:, url:, usage: nil)
       #   @param id [String]
+      #
       #   @param created_at [Integer, nil]
+      #
       #   @param error [nil]
+      #
       #   @param files [Array<Handinger::Models::Worker::File>]
+      #
       #   @param incomplete_details [nil]
+      #
       #   @param messages [Array<Object>]
+      #
       #   @param metadata [Hash{Symbol=>Object}]
+      #
       #   @param object [Symbol, Handinger::Models::Worker::Object]
+      #
       #   @param output [Array<Handinger::Models::Worker::Output>]
+      #
       #   @param output_text [String]
+      #
       #   @param running [Boolean]
+      #
       #   @param sources [Array<Handinger::Models::Worker::Source>]
+      #
       #   @param status [Symbol, Handinger::Models::Worker::Status]
+      #
       #   @param structured_output [Hash{Symbol=>Object}, nil]
+      #
+      #   @param url [String] Web URL of the worker in the Handinger dashboard.
+      #
       #   @param usage [Handinger::Models::Worker::Usage]
 
       class File < Handinger::Internal::Type::BaseModel

data/lib/handinger/models/worker_template.rb

@@ -47,6 +47,12 @@ module Handinger
       #   @return [String, nil]
       required :updated_at, String, api_name: :updatedAt, nil?: true
 
+      # @!attribute url
+      #   Web URL of the worker in the Handinger dashboard.
+      #
+      #   @return [String]
+      required :url, String
+
       # @!attribute user_id
       #
       #   @return [String]
@@ -57,16 +63,27 @@ module Handinger
       #   @return [Symbol, Handinger::Models::WorkerTemplate::Visibility]
       required :visibility, enum: -> { Handinger::WorkerTemplate::Visibility }
 
-      # @!method initialize(id:, created_at:, instructions:, organization_id:, output_schema:, summary:, title:, updated_at:, user_id:, visibility:)
+      # @!method initialize(id:, created_at:, instructions:, organization_id:, output_schema:, summary:, title:, updated_at:, url:, user_id:, visibility:)
       #   @param id [String]
+      #
       #   @param created_at [String, nil]
+      #
       #   @param instructions [String]
+      #
       #   @param organization_id [String]
+      #
       #   @param output_schema [Hash{Symbol=>Object}, nil]
+      #
       #   @param summary [String]
+      #
       #   @param title [String]
+      #
       #   @param updated_at [String, nil]
+      #
+      #   @param url [String] Web URL of the worker in the Handinger dashboard.
+      #
       #   @param user_id [String]
+      #
       #   @param visibility [Symbol, Handinger::Models::WorkerTemplate::Visibility]
 
       # @see Handinger::Models::WorkerTemplate#visibility

data/lib/handinger/resources/tasks.rb

@@ -12,23 +12,17 @@ module Handinger
       # `multipart/form-data` to attach files; the bytes are bootstrapped into the
       # worker's workspace before the task starts.
       #
-      # @overload create(worker_id:, instructions: nil, output_schema: nil, prompt: nil, summary: nil, task_id: nil, title: nil, visibility: nil, request_options: {})
+      # @overload create(input:, budget: nil, stream: nil, task_id: nil, worker_id: nil, request_options: {})
       #
-      # @param worker_id [String] Worker id the task belongs to.
+      # @param input [String]
       #
-      # @param instructions [String] Persistent system prompt the worker uses for every task it runs.
+      # @param budget [Symbol, Handinger::Models::CreateTask::Budget]
       #
-      # @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 stream [Boolean]
       #
       # @param task_id [String] Optional client-provided task id. Reuse this id to add turns to an existing task
       #
-      # @param title [String] Optional display name. When omitted, Handinger assigns a random dog-themed name.
-      #
-      # @param visibility [Symbol, Handinger::Models::CreateTask::Visibility] `public` (default) is visible to all org members. `private` is only visible to i
+      # @param worker_id [String] Worker id the task belongs to. If omitted, a new worker is created on-the-fly us
       #
       # @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/handinger/resources/workers.rb

@@ -111,9 +111,9 @@ module Handinger
         )
       end
 
-      # Permanently delete a worker template along with its tasks, turns, files,
-      # schedules, and integrations. This action is not reversible. Only the worker
-      # creator can delete a worker.
+      # Soft-delete a worker template so it no longer appears in list or retrieve
+      # endpoints. Tasks, turns, files, schedules, and integrations remain in the
+      # database for analytics. Only the worker creator can delete a worker.
       #
       # @overload delete(worker_id, request_options: {})
       #

data/lib/handinger/version.rb

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

data/lib/handinger.rb

@@ -52,8 +52,8 @@ require_relative "handinger/errors"
 require_relative "handinger/internal/transport/base_client"
 require_relative "handinger/internal/transport/pooled_net_requester"
 require_relative "handinger/client"
-require_relative "handinger/models/create_worker"
 require_relative "handinger/models/create_task"
+require_relative "handinger/models/create_worker"
 require_relative "handinger/models/update_worker"
 require_relative "handinger/models/delete_task_response"
 require_relative "handinger/models/delete_worker_response"

data/rbi/handinger/models/create_task.rbi

@@ -2,15 +2,26 @@
 
 module Handinger
   module Models
-    class CreateTask < Handinger::Models::CreateWorker
+    class CreateTask < Handinger::Internal::Type::BaseModel
       OrHash =
         T.type_alias do
           T.any(Handinger::CreateTask, Handinger::Internal::AnyHash)
         end
 
-      # Worker id the task belongs to.
       sig { returns(String) }
-      attr_accessor :worker_id
+      attr_accessor :input
+
+      sig { returns(T.nilable(Handinger::CreateTask::Budget::OrSymbol)) }
+      attr_reader :budget
+
+      sig { params(budget: Handinger::CreateTask::Budget::OrSymbol).void }
+      attr_writer :budget
+
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :stream
+
+      sig { params(stream: T::Boolean).void }
+      attr_writer :stream
 
       # Optional client-provided task id. Reuse this id to add turns to an existing
       # task.
@@ -20,21 +31,71 @@ module Handinger
       sig { params(task_id: String).void }
       attr_writer :task_id
 
+      # Worker id the task belongs to. If omitted, a new worker is created on-the-fly
+      # using the input as instructions.
+      sig { returns(T.nilable(String)) }
+      attr_reader :worker_id
+
+      sig { params(worker_id: String).void }
+      attr_writer :worker_id
+
       sig do
-        params(worker_id: String, task_id: String).returns(T.attached_class)
+        params(
+          input: String,
+          budget: Handinger::CreateTask::Budget::OrSymbol,
+          stream: T::Boolean,
+          task_id: String,
+          worker_id: String
+        ).returns(T.attached_class)
       end
       def self.new(
-        # Worker id the task belongs to.
-        worker_id:,
+        input:,
+        budget: nil,
+        stream: nil,
         # Optional client-provided task id. Reuse this id to add turns to an existing
         # task.
-        task_id: nil
+        task_id: nil,
+        # Worker id the task belongs to. If omitted, a new worker is created on-the-fly
+        # using the input as instructions.
+        worker_id: nil
       )
       end
 
-      sig { override.returns({ worker_id: String, task_id: String }) }
+      sig do
+        override.returns(
+          {
+            input: String,
+            budget: Handinger::CreateTask::Budget::OrSymbol,
+            stream: T::Boolean,
+            task_id: String,
+            worker_id: String
+          }
+        )
+      end
       def to_hash
       end
+
+      module Budget
+        extend Handinger::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Handinger::CreateTask::Budget) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        LOW = T.let(:low, Handinger::CreateTask::Budget::TaggedSymbol)
+        STANDARD = T.let(:standard, Handinger::CreateTask::Budget::TaggedSymbol)
+        HIGH = T.let(:high, Handinger::CreateTask::Budget::TaggedSymbol)
+        UNLIMITED =
+          T.let(:unlimited, Handinger::CreateTask::Budget::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Handinger::CreateTask::Budget::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/handinger/models/task.rbi

@@ -36,6 +36,10 @@ module Handinger
       sig { returns(Handinger::Task::TriggeredBy::TaggedSymbol) }
       attr_accessor :triggered_by
 
+      # Web URL of the task in the Handinger dashboard.
+      sig { returns(String) }
+      attr_accessor :url
+
       sig { returns(String) }
       attr_accessor :worker_id
 
@@ -50,6 +54,7 @@ module Handinger
           title: String,
           totals: Handinger::Task::Totals::OrHash,
           triggered_by: Handinger::Task::TriggeredBy::OrSymbol,
+          url: String,
           worker_id: String
         ).returns(T.attached_class)
       end
@@ -63,6 +68,8 @@ module Handinger
         title:,
         totals:,
         triggered_by:,
+        # Web URL of the task in the Handinger dashboard.
+        url:,
         worker_id:
       )
       end
@@ -79,6 +86,7 @@ module Handinger
             title: String,
             totals: Handinger::Task::Totals,
             triggered_by: Handinger::Task::TriggeredBy::TaggedSymbol,
+            url: String,
             worker_id: String
           }
         )

data/rbi/handinger/models/worker.rbi

@@ -48,6 +48,10 @@ module Handinger
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_accessor :structured_output
 
+      # Web URL of the worker in the Handinger dashboard.
+      sig { returns(String) }
+      attr_accessor :url
+
       sig { returns(T.nilable(Handinger::Worker::Usage)) }
       attr_reader :usage
 
@@ -70,6 +74,7 @@ module Handinger
           sources: T::Array[Handinger::Worker::Source::OrHash],
           status: Handinger::Worker::Status::OrSymbol,
           structured_output: T.nilable(T::Hash[Symbol, T.anything]),
+          url: String,
           usage: Handinger::Worker::Usage::OrHash
         ).returns(T.attached_class)
       end
@@ -88,6 +93,8 @@ module Handinger
         sources:,
         status:,
         structured_output:,
+        # Web URL of the worker in the Handinger dashboard.
+        url:,
         usage: nil
       )
       end
@@ -109,6 +116,7 @@ module Handinger
             sources: T::Array[Handinger::Worker::Source],
             status: Handinger::Worker::Status::TaggedSymbol,
             structured_output: T.nilable(T::Hash[Symbol, T.anything]),
+            url: String,
             usage: Handinger::Worker::Usage
           }
         )

data/rbi/handinger/models/worker_template.rbi

@@ -32,6 +32,10 @@ module Handinger
       sig { returns(T.nilable(String)) }
       attr_accessor :updated_at
 
+      # Web URL of the worker in the Handinger dashboard.
+      sig { returns(String) }
+      attr_accessor :url
+
       sig { returns(String) }
       attr_accessor :user_id
 
@@ -48,6 +52,7 @@ module Handinger
           summary: String,
           title: String,
           updated_at: T.nilable(String),
+          url: String,
           user_id: String,
           visibility: Handinger::WorkerTemplate::Visibility::OrSymbol
         ).returns(T.attached_class)
@@ -61,6 +66,8 @@ module Handinger
         summary:,
         title:,
         updated_at:,
+        # Web URL of the worker in the Handinger dashboard.
+        url:,
         user_id:,
         visibility:
       )
@@ -77,6 +84,7 @@ module Handinger
             summary: String,
             title: String,
             updated_at: T.nilable(String),
+            url: String,
             user_id: String,
             visibility: Handinger::WorkerTemplate::Visibility::TaggedSymbol
           }

data/rbi/handinger/resources/tasks.rbi

@@ -10,40 +10,24 @@ module Handinger
       # worker's workspace before the task starts.
       sig do
         params(
-          worker_id: String,
-          instructions: String,
-          output_schema: T::Hash[Symbol, T.anything],
-          prompt: String,
-          summary: String,
+          input: String,
+          budget: Handinger::CreateTask::Budget::OrSymbol,
+          stream: T::Boolean,
           task_id: String,
-          title: String,
-          visibility: Handinger::CreateTask::Visibility::OrSymbol,
+          worker_id: String,
           request_options: Handinger::RequestOptions::OrHash
         ).returns(Handinger::Worker)
       end
       def create(
-        # Worker id the task belongs to.
-        worker_id:,
-        # Persistent system prompt the worker uses for every task it runs.
-        instructions: nil,
-        # 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`.
-        output_schema: nil,
-        # Natural-language description of the worker to use for AI-generated instructions
-        # when `instructions` is omitted.
-        prompt: nil,
-        # Short one-line description of the worker's purpose. Auto-generated when omitted
-        # and a `prompt` is provided.
-        summary: nil,
+        input:,
+        budget: nil,
+        stream: nil,
         # Optional client-provided task id. Reuse this id to add turns to an existing
         # task.
         task_id: nil,
-        # Optional display name. When omitted, Handinger assigns a random dog-themed name.
-        title: nil,
-        # `public` (default) is visible to all org members. `private` is only visible to
-        # invited members.
-        visibility: nil,
+        # Worker id the task belongs to. If omitted, a new worker is created on-the-fly
+        # using the input as instructions.
+        worker_id: nil,
         request_options: {}
       )
       end

data/rbi/handinger/resources/workers.rbi

@@ -98,9 +98,9 @@ module Handinger
       )
       end
 
-      # Permanently delete a worker template along with its tasks, turns, files,
-      # schedules, and integrations. This action is not reversible. Only the worker
-      # creator can delete a worker.
+      # Soft-delete a worker template so it no longer appears in list or retrieve
+      # endpoints. Tasks, turns, files, schedules, and integrations remain in the
+      # database for analytics. Only the worker creator can delete a worker.
       sig do
         params(
           worker_id: String,

data/sig/handinger/models/create_task.rbs

@@ -1,19 +1,63 @@
 module Handinger
   module Models
-    type create_task = { worker_id: String, task_id: String }
+    type create_task =
+      {
+        input: String,
+        budget: Handinger::Models::CreateTask::budget,
+        stream: bool,
+        task_id: String,
+        worker_id: String
+      }
 
-    class CreateTask < Handinger::Models::CreateWorker
-      def worker_id: -> String
+    class CreateTask < Handinger::Internal::Type::BaseModel
+      attr_accessor input: String
 
-      def worker_id=: (String _) -> String
+      attr_reader budget: Handinger::Models::CreateTask::budget?
 
-      def task_id: -> String?
+      def budget=: (
+        Handinger::Models::CreateTask::budget
+      ) -> Handinger::Models::CreateTask::budget
 
-      def task_id=: (String _) -> String
+      attr_reader stream: bool?
 
-      def initialize: (worker_id: String, ?task_id: String) -> void
+      def stream=: (bool) -> bool
 
-      def to_hash: -> { worker_id: String, task_id: String }
+      attr_reader task_id: String?
+
+      def task_id=: (String) -> String
+
+      attr_reader worker_id: String?
+
+      def worker_id=: (String) -> String
+
+      def initialize: (
+        input: String,
+        ?budget: Handinger::Models::CreateTask::budget,
+        ?stream: bool,
+        ?task_id: String,
+        ?worker_id: String
+      ) -> void
+
+      def to_hash: -> {
+        input: String,
+        budget: Handinger::Models::CreateTask::budget,
+        stream: bool,
+        task_id: String,
+        worker_id: String
+      }
+
+      type budget = :low | :standard | :high | :unlimited
+
+      module Budget
+        extend Handinger::Internal::Type::Enum
+
+        LOW: :low
+        STANDARD: :standard
+        HIGH: :high
+        UNLIMITED: :unlimited
+
+        def self?.values: -> ::Array[Handinger::Models::CreateTask::budget]
+      end
     end
   end
 end

data/sig/handinger/models/task.rbs

@@ -11,6 +11,7 @@ module Handinger
         title: String,
         totals: Handinger::Task::Totals,
         triggered_by: Handinger::Models::Task::triggered_by,
+        url: String,
         worker_id: String
       }
 
@@ -33,6 +34,8 @@ module Handinger
 
       attr_accessor triggered_by: Handinger::Models::Task::triggered_by
 
+      attr_accessor url: String
+
       attr_accessor worker_id: String
 
       def initialize: (
@@ -45,6 +48,7 @@ module Handinger
         title: String,
         totals: Handinger::Task::Totals,
         triggered_by: Handinger::Models::Task::triggered_by,
+        url: String,
         worker_id: String
       ) -> void
 
@@ -58,6 +62,7 @@ module Handinger
         title: String,
         totals: Handinger::Task::Totals,
         triggered_by: Handinger::Models::Task::triggered_by,
+        url: String,
         worker_id: String
       }
 

data/sig/handinger/models/worker.rbs

@@ -16,6 +16,7 @@ module Handinger
         sources: ::Array[Handinger::Worker::Source],
         status: Handinger::Models::Worker::status,
         structured_output: ::Hash[Symbol, top]?,
+        url: String,
         usage: Handinger::Worker::Usage
       }
 
@@ -48,6 +49,8 @@ module Handinger
 
       attr_accessor structured_output: ::Hash[Symbol, top]?
 
+      attr_accessor url: String
+
       attr_reader usage: Handinger::Worker::Usage?
 
       def usage=: (Handinger::Worker::Usage) -> Handinger::Worker::Usage
@@ -67,6 +70,7 @@ module Handinger
         sources: ::Array[Handinger::Worker::Source],
         status: Handinger::Models::Worker::status,
         structured_output: ::Hash[Symbol, top]?,
+        url: String,
         ?usage: Handinger::Worker::Usage
       ) -> void
 
@@ -85,6 +89,7 @@ module Handinger
         sources: ::Array[Handinger::Worker::Source],
         status: Handinger::Models::Worker::status,
         structured_output: ::Hash[Symbol, top]?,
+        url: String,
         usage: Handinger::Worker::Usage
       }
 

data/sig/handinger/models/worker_template.rbs

@@ -10,6 +10,7 @@ module Handinger
         summary: String,
         title: String,
         updated_at: String?,
+        url: String,
         user_id: String,
         visibility: Handinger::Models::WorkerTemplate::visibility
       }
@@ -31,6 +32,8 @@ module Handinger
 
       attr_accessor updated_at: String?
 
+      attr_accessor url: String
+
       attr_accessor user_id: String
 
       attr_accessor visibility: Handinger::Models::WorkerTemplate::visibility
@@ -44,6 +47,7 @@ module Handinger
         summary: String,
         title: String,
         updated_at: String?,
+        url: String,
         user_id: String,
         visibility: Handinger::Models::WorkerTemplate::visibility
       ) -> void
@@ -57,6 +61,7 @@ module Handinger
         summary: String,
         title: String,
         updated_at: String?,
+        url: String,
         user_id: String,
         visibility: Handinger::Models::WorkerTemplate::visibility
       }

data/sig/handinger/resources/tasks.rbs

@@ -2,14 +2,11 @@ module Handinger
   module Resources
     class Tasks
       def create: (
-        worker_id: String,
-        ?instructions: String,
-        ?output_schema: ::Hash[Symbol, top],
-        ?prompt: String,
-        ?summary: String,
+        input: String,
+        ?budget: Handinger::Models::CreateTask::budget,
+        ?stream: bool,
         ?task_id: String,
-        ?title: String,
-        ?visibility: Handinger::Models::CreateTask::visibility,
+        ?worker_id: String,
         ?request_options: Handinger::request_opts
       ) -> Handinger::Worker
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: handinger
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Handinger