handinger 0.2.0 → 0.4.0

data/rbi/handinger/models/delete_task_response.rbi

@@ -0,0 +1,23 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class DeleteTaskResponse < Handinger::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Handinger::DeleteTaskResponse, Handinger::Internal::AnyHash)
+        end
+
+      sig { returns(T::Boolean) }
+      attr_accessor :archived
+
+      sig { params(archived: T::Boolean).returns(T.attached_class) }
+      def self.new(archived:)
+      end
+
+      sig { override.returns({ archived: T::Boolean }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/handinger/models/delete_worker_response.rbi

@@ -0,0 +1,23 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class DeleteWorkerResponse < Handinger::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Handinger::DeleteWorkerResponse, Handinger::Internal::AnyHash)
+        end
+
+      sig { returns(T::Boolean) }
+      attr_accessor :deleted
+
+      sig { params(deleted: T::Boolean).returns(T.attached_class) }
+      def self.new(deleted:)
+      end
+
+      sig { override.returns({ deleted: T::Boolean }) }
+      def to_hash
+      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/task_delete_params.rbi

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

data/rbi/handinger/models/update_worker.rbi

@@ -0,0 +1,112 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class UpdateWorker < Handinger::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Handinger::UpdateWorker, Handinger::Internal::AnyHash)
+        end
+
+      # Replaces the persistent system prompt. Subsequent tasks pick up the new
+      # instructions immediately; in-flight tasks keep using the previous version.
+      sig { returns(T.nilable(String)) }
+      attr_reader :instructions
+
+      sig { params(instructions: String).void }
+      attr_writer :instructions
+
+      # Replace the worker's structured output schema. Pass `null` to clear it and
+      # return to free-form text responses.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_accessor :output_schema
+
+      # Replaces the worker's short one-line summary.
+      sig { returns(T.nilable(String)) }
+      attr_reader :summary
+
+      sig { params(summary: String).void }
+      attr_writer :summary
+
+      # New display name for the worker.
+      sig { returns(T.nilable(String)) }
+      attr_reader :title
+
+      sig { params(title: String).void }
+      attr_writer :title
+
+      # Change visibility between `public` (any org member can run tasks) and `private`
+      # (only invited members).
+      sig { returns(T.nilable(Handinger::UpdateWorker::Visibility::OrSymbol)) }
+      attr_reader :visibility
+
+      sig do
+        params(visibility: Handinger::UpdateWorker::Visibility::OrSymbol).void
+      end
+      attr_writer :visibility
+
+      sig do
+        params(
+          instructions: String,
+          output_schema: T.nilable(T::Hash[Symbol, T.anything]),
+          summary: String,
+          title: String,
+          visibility: Handinger::UpdateWorker::Visibility::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Replaces the persistent system prompt. Subsequent tasks pick up the new
+        # instructions immediately; in-flight tasks keep using the previous version.
+        instructions: nil,
+        # Replace the worker's structured output schema. Pass `null` to clear it and
+        # return to free-form text responses.
+        output_schema: nil,
+        # Replaces the worker's short one-line summary.
+        summary: nil,
+        # New display name for the worker.
+        title: nil,
+        # Change visibility between `public` (any org member can run tasks) and `private`
+        # (only invited members).
+        visibility: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            instructions: String,
+            output_schema: T.nilable(T::Hash[Symbol, T.anything]),
+            summary: String,
+            title: String,
+            visibility: Handinger::UpdateWorker::Visibility::OrSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Change visibility between `public` (any org member can run tasks) and `private`
+      # (only invited members).
+      module Visibility
+        extend Handinger::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Handinger::UpdateWorker::Visibility) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        PUBLIC =
+          T.let(:public, Handinger::UpdateWorker::Visibility::TaggedSymbol)
+        PRIVATE =
+          T.let(:private, Handinger::UpdateWorker::Visibility::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Handinger::UpdateWorker::Visibility::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

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_delete_params.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class WorkerDeleteParams < Handinger::Internal::Type::BaseModel
+      extend Handinger::Internal::Type::RequestParameters::Converter
+      include Handinger::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Handinger::WorkerDeleteParams, 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_create_response.rbi → worker_template.rbi}

@@ -2,13 +2,10 @@
 
 module Handinger
   module Models
-    class WorkerCreateResponse < Handinger::Internal::Type::BaseModel
+    class WorkerTemplate < Handinger::Internal::Type::BaseModel
       OrHash =
         T.type_alias do
-          T.any(
-            Handinger::Models::WorkerCreateResponse,
-            Handinger::Internal::AnyHash
-          )
+          T.any(Handinger::WorkerTemplate, Handinger::Internal::AnyHash)
         end
 
       sig { returns(String) }
@@ -35,14 +32,14 @@ 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
 
-      sig do
-        returns(
-          Handinger::Models::WorkerCreateResponse::Visibility::TaggedSymbol
-        )
-      end
+      sig { returns(Handinger::WorkerTemplate::Visibility::TaggedSymbol) }
       attr_accessor :visibility
 
       sig do
@@ -55,9 +52,9 @@ module Handinger
           summary: String,
           title: String,
           updated_at: T.nilable(String),
+          url: String,
           user_id: String,
-          visibility:
-            Handinger::Models::WorkerCreateResponse::Visibility::OrSymbol
+          visibility: Handinger::WorkerTemplate::Visibility::OrSymbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -69,6 +66,8 @@ module Handinger
         summary:,
         title:,
         updated_at:,
+        # Web URL of the worker in the Handinger dashboard.
+        url:,
         user_id:,
         visibility:
       )
@@ -85,9 +84,9 @@ module Handinger
             summary: String,
             title: String,
             updated_at: T.nilable(String),
+            url: String,
             user_id: String,
-            visibility:
-              Handinger::Models::WorkerCreateResponse::Visibility::TaggedSymbol
+            visibility: Handinger::WorkerTemplate::Visibility::TaggedSymbol
           }
         )
       end
@@ -98,27 +97,17 @@ module Handinger
         extend Handinger::Internal::Type::Enum
 
         TaggedSymbol =
-          T.type_alias do
-            T.all(Symbol, Handinger::Models::WorkerCreateResponse::Visibility)
-          end
+          T.type_alias { T.all(Symbol, Handinger::WorkerTemplate::Visibility) }
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         PUBLIC =
-          T.let(
-            :public,
-            Handinger::Models::WorkerCreateResponse::Visibility::TaggedSymbol
-          )
+          T.let(:public, Handinger::WorkerTemplate::Visibility::TaggedSymbol)
         PRIVATE =
-          T.let(
-            :private,
-            Handinger::Models::WorkerCreateResponse::Visibility::TaggedSymbol
-          )
+          T.let(:private, Handinger::WorkerTemplate::Visibility::TaggedSymbol)
 
         sig do
           override.returns(
-            T::Array[
-              Handinger::Models::WorkerCreateResponse::Visibility::TaggedSymbol
-            ]
+            T::Array[Handinger::WorkerTemplate::Visibility::TaggedSymbol]
           )
         end
         def self.values

data/rbi/handinger/models/worker_update_params.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Handinger
+  module Models
+    class WorkerUpdateParams < Handinger::Models::UpdateWorker
+      extend Handinger::Internal::Type::RequestParameters::Converter
+      include Handinger::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Handinger::WorkerUpdateParams, 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.rbi

@@ -5,21 +5,35 @@ module Handinger
 
   CreateWorker = Handinger::Models::CreateWorker
 
+  DeleteTaskResponse = Handinger::Models::DeleteTaskResponse
+
+  DeleteWorkerResponse = Handinger::Models::DeleteWorkerResponse
+
   Task = Handinger::Models::Task
 
   TaskCreateParams = Handinger::Models::TaskCreateParams
 
+  TaskDeleteParams = Handinger::Models::TaskDeleteParams
+
   TaskRetrieveParams = Handinger::Models::TaskRetrieveParams
 
   TaskWithTurns = Handinger::Models::TaskWithTurns
 
+  UpdateWorker = Handinger::Models::UpdateWorker
+
   Worker = Handinger::Models::Worker
 
   WorkerCreateParams = Handinger::Models::WorkerCreateParams
 
+  WorkerDeleteParams = Handinger::Models::WorkerDeleteParams
+
   WorkerRetrieveEmailParams = Handinger::Models::WorkerRetrieveEmailParams
 
   WorkerRetrieveParams = Handinger::Models::WorkerRetrieveParams
 
   Workers = Handinger::Models::Workers
+
+  WorkerTemplate = Handinger::Models::WorkerTemplate
+
+  WorkerUpdateParams = Handinger::Models::WorkerUpdateParams
 end

data/rbi/handinger/resources/tasks.rbi

@@ -4,9 +4,10 @@ module Handinger
   module Resources
     # Run and inspect tasks against a worker.
     class Tasks
-      # Run a new task against an existing worker. Send `multipart/form-data` to attach
-      # files; the bytes are bootstrapped into the worker's workspace before the task
-      # starts.
+      # Run a new task against an existing worker. Send a `taskId` of a prior task to
+      # add a follow-up turn instead of starting a fresh task. Send
+      # `multipart/form-data` to attach files; the bytes are bootstrapped into the
+      # worker's workspace before the task starts.
       sig do
         params(
           worker_id: String,
@@ -61,6 +62,21 @@ module Handinger
       )
       end
 
+      # Archive a task so it stops appearing in `GET /tasks` results. Turns and files
+      # are retained for audit purposes. Only the worker creator can archive a task.
+      sig do
+        params(
+          task_id: String,
+          request_options: Handinger::RequestOptions::OrHash
+        ).returns(Handinger::DeleteTaskResponse)
+      end
+      def delete(
+        # Task id returned by the create task endpoint.
+        task_id,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Handinger::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/handinger/resources/workers.rbi

@@ -19,7 +19,7 @@ module Handinger
           title: String,
           visibility: Handinger::CreateWorker::Visibility::OrSymbol,
           request_options: Handinger::RequestOptions::OrHash
-        ).returns(Handinger::Models::WorkerCreateResponse)
+        ).returns(Handinger::WorkerTemplate)
       end
       def create(
         # Persistent system prompt the worker uses for every task it runs.
@@ -64,6 +64,56 @@ module Handinger
       )
       end
 
+      # Update a worker's instructions, title, summary, visibility, or output schema.
+      # Only the fields you send are changed; omitted fields keep their current values.
+      # Only the worker creator can update a worker.
+      sig do
+        params(
+          worker_id: String,
+          instructions: String,
+          output_schema: T.nilable(T::Hash[Symbol, T.anything]),
+          summary: String,
+          title: String,
+          visibility: Handinger::UpdateWorker::Visibility::OrSymbol,
+          request_options: Handinger::RequestOptions::OrHash
+        ).returns(Handinger::WorkerTemplate)
+      end
+      def update(
+        # Worker id returned by the create worker endpoint.
+        worker_id,
+        # Replaces the persistent system prompt. Subsequent tasks pick up the new
+        # instructions immediately; in-flight tasks keep using the previous version.
+        instructions: nil,
+        # Replace the worker's structured output schema. Pass `null` to clear it and
+        # return to free-form text responses.
+        output_schema: nil,
+        # Replaces the worker's short one-line summary.
+        summary: nil,
+        # New display name for the worker.
+        title: nil,
+        # Change visibility between `public` (any org member can run tasks) and `private`
+        # (only invited members).
+        visibility: nil,
+        request_options: {}
+      )
+      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.
+      sig do
+        params(
+          worker_id: String,
+          request_options: Handinger::RequestOptions::OrHash
+        ).returns(Handinger::DeleteWorkerResponse)
+      end
+      def delete(
+        # Worker id returned by the create worker endpoint.
+        worker_id,
+        request_options: {}
+      )
+      end
+
       # Retrieve the inbound email address for a worker.
       sig do
         params(

data/sig/handinger/models/delete_task_response.rbs

@@ -0,0 +1,13 @@
+module Handinger
+  module Models
+    type delete_task_response = { archived: bool }
+
+    class DeleteTaskResponse < Handinger::Internal::Type::BaseModel
+      attr_accessor archived: bool
+
+      def initialize: (archived: bool) -> void
+
+      def to_hash: -> { archived: bool }
+    end
+  end
+end

data/sig/handinger/models/delete_worker_response.rbs

@@ -0,0 +1,13 @@
+module Handinger
+  module Models
+    type delete_worker_response = { deleted: bool }
+
+    class DeleteWorkerResponse < Handinger::Internal::Type::BaseModel
+      attr_accessor deleted: bool
+
+      def initialize: (deleted: bool) -> void
+
+      def to_hash: -> { deleted: bool }
+    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/task_delete_params.rbs

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