handinger 0.0.2 → 0.2.0

data/sig/handinger/resources/workers.rbs

@@ -4,41 +4,25 @@ module Handinger
       attr_reader schedules: Handinger::Resources::Workers::Schedules
 
       def create: (
-        input: String,
-        ?budget: Handinger::Models::CreateWorker::budget,
-        ?stream: bool,
+        ?instructions: String,
+        ?output_schema: ::Hash[Symbol, top],
+        ?prompt: String,
+        ?summary: String,
+        ?title: String,
+        ?visibility: Handinger::Models::CreateWorker::visibility,
         ?request_options: Handinger::request_opts
-      ) -> Handinger::Worker
+      ) -> Handinger::Models::WorkerCreateResponse
 
       def retrieve: (
         String worker_id,
-        ?stream: bool,
-        ?request_options: Handinger::request_opts
-      ) -> Handinger::Worker
-
-      def continue: (
-        String worker_id,
-        input: String,
-        ?budget: Handinger::Models::CreateWorker::budget,
-        ?stream: bool,
+        ?stream: Handinger::Models::WorkerRetrieveParams::stream,
         ?request_options: Handinger::request_opts
       ) -> Handinger::Worker
 
       def retrieve_email: (
         String worker_id,
         ?request_options: Handinger::request_opts
-      ) -> String
-
-      def retrieve_file: (
-        String file_path,
-        worker_id: String,
-        ?request_options: Handinger::request_opts
-      ) -> StringIO
-
-      def stream_updates_streaming: (
-        String worker_id,
-        ?request_options: Handinger::request_opts
-      ) -> Handinger::Internal::Stream[String]
+      ) -> Handinger::Models::WorkerRetrieveEmailResponse
 
       def initialize: (client: Handinger::Client) -> void
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: handinger
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Handinger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-23 00:00:00.000000000 Z
+date: 2026-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -54,13 +54,11 @@ files:
 - lib/handinger/errors.rb
 - lib/handinger/file_part.rb
 - lib/handinger/internal.rb
-- lib/handinger/internal/stream.rb
 - lib/handinger/internal/transport/base_client.rb
 - lib/handinger/internal/transport/pooled_net_requester.rb
 - lib/handinger/internal/type/array_of.rb
 - lib/handinger/internal/type/base_model.rb
 - lib/handinger/internal/type/base_page.rb
-- lib/handinger/internal/type/base_stream.rb
 - lib/handinger/internal/type/boolean.rb
 - lib/handinger/internal/type/converter.rb
 - lib/handinger/internal/type/enum.rb
@@ -71,16 +69,18 @@ files:
 - lib/handinger/internal/type/unknown.rb
 - lib/handinger/internal/util.rb
 - lib/handinger/models.rb
+- lib/handinger/models/create_task.rb
 - lib/handinger/models/create_worker.rb
+- lib/handinger/models/task.rb
+- lib/handinger/models/task_create_params.rb
+- lib/handinger/models/task_retrieve_params.rb
+- lib/handinger/models/task_with_turns.rb
 - lib/handinger/models/worker.rb
-- lib/handinger/models/worker_continue_params.rb
 - lib/handinger/models/worker_create_params.rb
+- lib/handinger/models/worker_create_response.rb
 - lib/handinger/models/worker_retrieve_email_params.rb
 - lib/handinger/models/worker_retrieve_email_response.rb
-- lib/handinger/models/worker_retrieve_file_params.rb
 - lib/handinger/models/worker_retrieve_params.rb
-- lib/handinger/models/worker_stream_updates_params.rb
-- lib/handinger/models/worker_stream_updates_response.rb
 - lib/handinger/models/workers/schedule_cancel_params.rb
 - lib/handinger/models/workers/schedule_cancel_response.rb
 - lib/handinger/models/workers/schedule_create_params.rb
@@ -88,6 +88,7 @@ files:
 - lib/handinger/models/workers/schedule_list_response.rb
 - lib/handinger/models/workers/worker_schedule.rb
 - lib/handinger/request_options.rb
+- lib/handinger/resources/tasks.rb
 - lib/handinger/resources/workers.rb
 - lib/handinger/resources/workers/schedules.rb
 - lib/handinger/version.rb
@@ -96,13 +97,11 @@ files:
 - rbi/handinger/errors.rbi
 - rbi/handinger/file_part.rbi
 - rbi/handinger/internal.rbi
-- rbi/handinger/internal/stream.rbi
 - rbi/handinger/internal/transport/base_client.rbi
 - rbi/handinger/internal/transport/pooled_net_requester.rbi
 - rbi/handinger/internal/type/array_of.rbi
 - rbi/handinger/internal/type/base_model.rbi
 - rbi/handinger/internal/type/base_page.rbi
-- rbi/handinger/internal/type/base_stream.rbi
 - rbi/handinger/internal/type/boolean.rbi
 - rbi/handinger/internal/type/converter.rbi
 - rbi/handinger/internal/type/enum.rbi
@@ -113,16 +112,18 @@ files:
 - rbi/handinger/internal/type/unknown.rbi
 - rbi/handinger/internal/util.rbi
 - rbi/handinger/models.rbi
+- rbi/handinger/models/create_task.rbi
 - rbi/handinger/models/create_worker.rbi
+- rbi/handinger/models/task.rbi
+- rbi/handinger/models/task_create_params.rbi
+- rbi/handinger/models/task_retrieve_params.rbi
+- rbi/handinger/models/task_with_turns.rbi
 - rbi/handinger/models/worker.rbi
-- rbi/handinger/models/worker_continue_params.rbi
 - rbi/handinger/models/worker_create_params.rbi
+- rbi/handinger/models/worker_create_response.rbi
 - rbi/handinger/models/worker_retrieve_email_params.rbi
 - rbi/handinger/models/worker_retrieve_email_response.rbi
-- rbi/handinger/models/worker_retrieve_file_params.rbi
 - rbi/handinger/models/worker_retrieve_params.rbi
-- rbi/handinger/models/worker_stream_updates_params.rbi
-- rbi/handinger/models/worker_stream_updates_response.rbi
 - rbi/handinger/models/workers/schedule_cancel_params.rbi
 - rbi/handinger/models/workers/schedule_cancel_response.rbi
 - rbi/handinger/models/workers/schedule_create_params.rbi
@@ -130,6 +131,7 @@ files:
 - rbi/handinger/models/workers/schedule_list_response.rbi
 - rbi/handinger/models/workers/worker_schedule.rbi
 - rbi/handinger/request_options.rbi
+- rbi/handinger/resources/tasks.rbi
 - rbi/handinger/resources/workers.rbi
 - rbi/handinger/resources/workers/schedules.rbi
 - rbi/handinger/version.rbi
@@ -137,13 +139,11 @@ files:
 - sig/handinger/errors.rbs
 - sig/handinger/file_part.rbs
 - sig/handinger/internal.rbs
-- sig/handinger/internal/stream.rbs
 - sig/handinger/internal/transport/base_client.rbs
 - sig/handinger/internal/transport/pooled_net_requester.rbs
 - sig/handinger/internal/type/array_of.rbs
 - sig/handinger/internal/type/base_model.rbs
 - sig/handinger/internal/type/base_page.rbs
-- sig/handinger/internal/type/base_stream.rbs
 - sig/handinger/internal/type/boolean.rbs
 - sig/handinger/internal/type/converter.rbs
 - sig/handinger/internal/type/enum.rbs
@@ -154,16 +154,18 @@ files:
 - sig/handinger/internal/type/unknown.rbs
 - sig/handinger/internal/util.rbs
 - sig/handinger/models.rbs
+- sig/handinger/models/create_task.rbs
 - sig/handinger/models/create_worker.rbs
+- sig/handinger/models/task.rbs
+- sig/handinger/models/task_create_params.rbs
+- sig/handinger/models/task_retrieve_params.rbs
+- sig/handinger/models/task_with_turns.rbs
 - sig/handinger/models/worker.rbs
-- sig/handinger/models/worker_continue_params.rbs
 - sig/handinger/models/worker_create_params.rbs
+- sig/handinger/models/worker_create_response.rbs
 - sig/handinger/models/worker_retrieve_email_params.rbs
 - sig/handinger/models/worker_retrieve_email_response.rbs
-- sig/handinger/models/worker_retrieve_file_params.rbs
 - sig/handinger/models/worker_retrieve_params.rbs
-- sig/handinger/models/worker_stream_updates_params.rbs
-- sig/handinger/models/worker_stream_updates_response.rbs
 - sig/handinger/models/workers/schedule_cancel_params.rbs
 - sig/handinger/models/workers/schedule_cancel_response.rbs
 - sig/handinger/models/workers/schedule_create_params.rbs
@@ -171,6 +173,7 @@ files:
 - sig/handinger/models/workers/schedule_list_response.rbs
 - sig/handinger/models/workers/worker_schedule.rbs
 - sig/handinger/request_options.rbs
+- sig/handinger/resources/tasks.rbs
 - sig/handinger/resources/workers.rbs
 - sig/handinger/resources/workers/schedules.rbs
 - sig/handinger/version.rbs

data/lib/handinger/internal/stream.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module Handinger
-  module Internal
-    # @generic Elem
-    #
-    # @example
-    #   stream.each do |event|
-    #     puts(event)
-    #   end
-    class Stream
-      include Handinger::Internal::Type::BaseStream
-
-      # @api private
-      #
-      # @return [Enumerable<generic<Elem>>]
-      private def iterator
-        @iterator ||= Handinger::Internal::Util.chain_fused(@stream) do |y|
-          @stream.each do |msg|
-            next if (data = msg.fetch(:data)).nil?
-            decoded = JSON.parse(data, symbolize_names: true)
-            unwrapped = Handinger::Internal::Util.dig(decoded, @unwrap)
-            y << Handinger::Internal::Type::Converter.coerce(@model, unwrapped)
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,83 +0,0 @@
-# frozen_string_literal: true
-
-module Handinger
-  module Internal
-    module Type
-      # @api private
-      #
-      # @generic Elem
-      #
-      # This module provides a base implementation for streaming responses in the SDK.
-      #
-      # @see https://rubyapi.org/3.2/o/enumerable
-      module BaseStream
-        include Enumerable
-
-        # @return [Integer]
-        attr_reader :status
-
-        # @return [Hash{String=>String}]
-        attr_reader :headers
-
-        # @api public
-        #
-        # @return [void]
-        def close = Handinger::Internal::Util.close_fused!(@iterator)
-
-        # @api private
-        #
-        # @return [Enumerable<generic<Elem>>]
-        private def iterator = (raise NotImplementedError)
-
-        # @api public
-        #
-        # @param blk [Proc]
-        #
-        # @yieldparam [generic<Elem>]
-        # @return [void]
-        def each(&blk)
-          unless block_given?
-            raise ArgumentError.new("A block must be given to ##{__method__}")
-          end
-          @iterator.each(&blk)
-        end
-
-        # @api public
-        #
-        # @return [Enumerator<generic<Elem>>]
-        def to_enum = @iterator
-
-        alias_method :enum_for, :to_enum
-
-        # @api private
-        #
-        # @param model [Class, Handinger::Internal::Type::Converter]
-        # @param url [URI::Generic]
-        # @param status [Integer]
-        # @param headers [Hash{String=>String}]
-        # @param response [Net::HTTPResponse]
-        # @param unwrap [Symbol, Integer, Array<Symbol, Integer>, Proc]
-        # @param stream [Enumerable<Object>]
-        def initialize(model:, url:, status:, headers:, response:, unwrap:, stream:)
-          @model = model
-          @url = url
-          @status = status
-          @headers = headers
-          @response = response
-          @unwrap = unwrap
-          @stream = stream
-          @iterator = iterator
-        end
-
-        # @api private
-        #
-        # @return [String]
-        def inspect
-          model = Handinger::Internal::Type::Converter.inspect(@model, depth: 1)
-
-          "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)}>"
-        end
-      end
-    end
-  end
-end

data/lib/handinger/models/worker_retrieve_file_params.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module Handinger
-  module Models
-    # @see Handinger::Resources::Workers#retrieve_file
-    class WorkerRetrieveFileParams < Handinger::Internal::Type::BaseModel
-      extend Handinger::Internal::Type::RequestParameters::Converter
-      include Handinger::Internal::Type::RequestParameters
-
-      # @!attribute worker_id
-      #
-      #   @return [String]
-      required :worker_id, String
-
-      # @!attribute file_path
-      #
-      #   @return [String]
-      required :file_path, String
-
-      # @!method initialize(worker_id:, file_path:, request_options: {})
-      #   @param worker_id [String]
-      #   @param file_path [String]
-      #   @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}]
-    end
-  end
-end

data/lib/handinger/models/worker_stream_updates_params.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module Handinger
-  module Models
-    # @see Handinger::Resources::Workers#stream_updates_streaming
-    class WorkerStreamUpdatesParams < Handinger::Internal::Type::BaseModel
-      extend Handinger::Internal::Type::RequestParameters::Converter
-      include Handinger::Internal::Type::RequestParameters
-
-      # @!attribute worker_id
-      #
-      #   @return [String]
-      required :worker_id, String
-
-      # @!method initialize(worker_id:, request_options: {})
-      #   @param worker_id [String]
-      #   @param request_options [Handinger::RequestOptions, Hash{Symbol=>Object}]
-    end
-  end
-end

data/lib/handinger/models/worker_stream_updates_response.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module Handinger
-  module Models
-    WorkerStreamUpdatesResponse = String
-  end
-end

data/rbi/handinger/internal/stream.rbi

@@ -1,20 +0,0 @@
-# typed: strong
-
-module Handinger
-  module Internal
-    class Stream
-      Message =
-        type_member(:in) do
-          { fixed: Handinger::Internal::Util::ServerSentEvent }
-        end
-      Elem = type_member(:out)
-
-      include Handinger::Internal::Type::BaseStream
-
-      # @api private
-      sig { override.returns(T::Enumerable[Elem]) }
-      private def iterator
-      end
-    end
-  end
-end

data/rbi/handinger/internal/type/base_stream.rbi

@@ -1,75 +0,0 @@
-# typed: strong
-
-module Handinger
-  module Internal
-    module Type
-      # @api private
-      #
-      # This module provides a base implementation for streaming responses in the SDK.
-      module BaseStream
-        include Enumerable
-
-        Message = type_member(:in)
-        Elem = type_member(:out)
-
-        sig { returns(Integer) }
-        attr_reader :status
-
-        sig { returns(T::Hash[String, String]) }
-        attr_reader :headers
-
-        sig { void }
-        def close
-        end
-
-        # @api private
-        sig { overridable.returns(T::Enumerable[Elem]) }
-        private def iterator
-        end
-
-        sig { params(blk: T.proc.params(arg0: Elem).void).void }
-        def each(&blk)
-        end
-
-        sig { returns(T::Enumerator[Elem]) }
-        def to_enum
-        end
-
-        # @api private
-        sig do
-          params(
-            model:
-              T.any(T::Class[T.anything], Handinger::Internal::Type::Converter),
-            url: URI::Generic,
-            status: Integer,
-            headers: T::Hash[String, String],
-            response: Net::HTTPResponse,
-            unwrap:
-              T.any(
-                Symbol,
-                Integer,
-                T::Array[T.any(Symbol, Integer)],
-                T.proc.params(arg0: T.anything).returns(T.anything)
-              ),
-            stream: T::Enumerable[Message]
-          ).void
-        end
-        def initialize(
-          model:,
-          url:,
-          status:,
-          headers:,
-          response:,
-          unwrap:,
-          stream:
-        )
-        end
-
-        # @api private
-        sig { returns(String) }
-        def inspect
-        end
-      end
-    end
-  end
-end

data/rbi/handinger/models/worker_retrieve_file_params.rbi

@@ -1,46 +0,0 @@
-# typed: strong
-
-module Handinger
-  module Models
-    class WorkerRetrieveFileParams < Handinger::Internal::Type::BaseModel
-      extend Handinger::Internal::Type::RequestParameters::Converter
-      include Handinger::Internal::Type::RequestParameters
-
-      OrHash =
-        T.type_alias do
-          T.any(
-            Handinger::WorkerRetrieveFileParams,
-            Handinger::Internal::AnyHash
-          )
-        end
-
-      sig { returns(String) }
-      attr_accessor :worker_id
-
-      sig { returns(String) }
-      attr_accessor :file_path
-
-      sig do
-        params(
-          worker_id: String,
-          file_path: String,
-          request_options: Handinger::RequestOptions::OrHash
-        ).returns(T.attached_class)
-      end
-      def self.new(worker_id:, file_path:, request_options: {})
-      end
-
-      sig do
-        override.returns(
-          {
-            worker_id: String,
-            file_path: String,
-            request_options: Handinger::RequestOptions
-          }
-        )
-      end
-      def to_hash
-      end
-    end
-  end
-end

data/rbi/handinger/models/worker_stream_updates_params.rbi

@@ -1,38 +0,0 @@
-# typed: strong
-
-module Handinger
-  module Models
-    class WorkerStreamUpdatesParams < Handinger::Internal::Type::BaseModel
-      extend Handinger::Internal::Type::RequestParameters::Converter
-      include Handinger::Internal::Type::RequestParameters
-
-      OrHash =
-        T.type_alias do
-          T.any(
-            Handinger::WorkerStreamUpdatesParams,
-            Handinger::Internal::AnyHash
-          )
-        end
-
-      sig { returns(String) }
-      attr_accessor :worker_id
-
-      sig do
-        params(
-          worker_id: String,
-          request_options: Handinger::RequestOptions::OrHash
-        ).returns(T.attached_class)
-      end
-      def self.new(worker_id:, request_options: {})
-      end
-
-      sig do
-        override.returns(
-          { worker_id: String, request_options: Handinger::RequestOptions }
-        )
-      end
-      def to_hash
-      end
-    end
-  end
-end

data/rbi/handinger/models/worker_stream_updates_response.rbi

@@ -1,7 +0,0 @@
-# typed: strong
-
-module Handinger
-  module Models
-    WorkerStreamUpdatesResponse = String
-  end
-end

data/sig/handinger/internal/stream.rbs

@@ -1,9 +0,0 @@
-module Handinger
-  module Internal
-    class Stream[Elem]
-      include Handinger::Internal::Type::BaseStream[Handinger::Internal::Util::server_sent_event, Elem]
-
-      private def iterator: -> Enumerable[Elem]
-    end
-  end
-end

data/sig/handinger/internal/type/base_stream.rbs

@@ -1,38 +0,0 @@
-module Handinger
-  module Internal
-    module Type
-      module BaseStream[Message, Elem]
-        include Enumerable[Elem]
-
-        attr_reader status: Integer
-
-        attr_reader headers: ::Hash[String, String]
-
-        def close: -> void
-
-        private def iterator: -> Enumerable[Elem]
-
-        def each: { (Elem arg0) -> void } -> void
-
-        def to_enum: -> Enumerator[Elem]
-
-        alias enum_for to_enum
-
-        def initialize: (
-          model: Class | Handinger::Internal::Type::Converter,
-          url: URI::Generic,
-          status: Integer,
-          headers: ::Hash[String, String],
-          response: top,
-          unwrap: Symbol
-          | Integer
-          | ::Array[Symbol | Integer]
-          | ^(top arg0) -> top,
-          stream: Enumerable[Message]
-        ) -> void
-
-        def inspect: -> String
-      end
-    end
-  end
-end

data/sig/handinger/models/worker_continue_params.rbs

@@ -1,25 +0,0 @@
-module Handinger
-  module Models
-    type worker_continue_params =
-      { worker_id: String } & Handinger::Internal::Type::request_parameters
-
-    class WorkerContinueParams < Handinger::Models::CreateWorker
-      extend Handinger::Internal::Type::RequestParameters::Converter
-      include Handinger::Internal::Type::RequestParameters
-
-      def worker_id: -> String
-
-      def worker_id=: (String _) -> String
-
-      def initialize: (
-        worker_id: String,
-        ?request_options: Handinger::request_opts
-      ) -> void
-
-      def to_hash: -> {
-        worker_id: String,
-        request_options: Handinger::RequestOptions
-      }
-    end
-  end
-end

data/sig/handinger/models/worker_retrieve_file_params.rbs

@@ -1,28 +0,0 @@
-module Handinger
-  module Models
-    type worker_retrieve_file_params =
-      { worker_id: String, file_path: String }
-      & Handinger::Internal::Type::request_parameters
-
-    class WorkerRetrieveFileParams < Handinger::Internal::Type::BaseModel
-      extend Handinger::Internal::Type::RequestParameters::Converter
-      include Handinger::Internal::Type::RequestParameters
-
-      attr_accessor worker_id: String
-
-      attr_accessor file_path: String
-
-      def initialize: (
-        worker_id: String,
-        file_path: String,
-        ?request_options: Handinger::request_opts
-      ) -> void
-
-      def to_hash: -> {
-        worker_id: String,
-        file_path: String,
-        request_options: Handinger::RequestOptions
-      }
-    end
-  end
-end

data/sig/handinger/models/worker_stream_updates_response.rbs

@@ -1,5 +0,0 @@
-module Handinger
-  module Models
-    class WorkerStreamUpdatesResponse = String
-  end
-end