handinger 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 944762f22d72ab9b304851aa18a7d34221ad5aa7d785e50f423b7b55ba09eaed
-  data.tar.gz: 3b9a81528fce0edaedbbe54f0e155c00d91635f24e4275b7f5b40984873a9fc6
+  metadata.gz: ecd40670a310e06ad0f0b33baa0f620b434bb11398f45a9e44e9c536533441bd
+  data.tar.gz: 18bf80c24a1126bb839e73146ec8d5aab5c62aba54fbdf8d56f32a0fb3c97ec1
 SHA512:
-  metadata.gz: 0435c4ab79474558084bd58c91cc6731d56f46e53827d2d0944427c94a8015c310afbd47b1daed618f19f37b375191c338a54c91004c86c316454095a0dc0936
-  data.tar.gz: 8ea226be6e29c61cd4745a1a774319c951c01684386450bf3115ff0be3097022682c799533683140f96bf23eb3a1ed511b1e0a63bfa083b6b9f802ec43b03194
+  metadata.gz: 7520dd4bf1e744831db561b4bc1af8ac9aea2c767f5f477e81604a6d7b1a4a45fc70328bf569832e774eed201bf7bff0ea0c6a80c015f6fea1130caeb6367b91
+  data.tar.gz: 40b7e0965ddc840e39988a2d3659d31d3a47074770054149e4c31534ddbee84162eb16ab61ae0831b8dba59b6bd312691223526e06c0dae9a8ff269fef63465f

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 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)

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.4.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/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.4.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/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/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.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Handinger