handinger 0.2.0 → 0.3.0

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_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) }
@@ -38,11 +35,7 @@ module Handinger
       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
@@ -56,8 +49,7 @@ module Handinger
           title: String,
           updated_at: T.nilable(String),
           user_id: String,
-          visibility:
-            Handinger::Models::WorkerCreateResponse::Visibility::OrSymbol
+          visibility: Handinger::WorkerTemplate::Visibility::OrSymbol
         ).returns(T.attached_class)
       end
       def self.new(
@@ -86,8 +78,7 @@ module Handinger
             title: String,
             updated_at: T.nilable(String),
             user_id: String,
-            visibility:
-              Handinger::Models::WorkerCreateResponse::Visibility::TaggedSymbol
+            visibility: Handinger::WorkerTemplate::Visibility::TaggedSymbol
           }
         )
       end
@@ -98,27 +89,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_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

data/sig/handinger/models/update_worker.rbs

@@ -0,0 +1,61 @@
+module Handinger
+  module Models
+    type update_worker =
+      {
+        instructions: String,
+        output_schema: ::Hash[Symbol, top]?,
+        summary: String,
+        title: String,
+        visibility: Handinger::Models::UpdateWorker::visibility
+      }
+
+    class UpdateWorker < Handinger::Internal::Type::BaseModel
+      attr_reader instructions: String?
+
+      def instructions=: (String) -> String
+
+      attr_accessor output_schema: ::Hash[Symbol, top]?
+
+      attr_reader summary: String?
+
+      def summary=: (String) -> String
+
+      attr_reader title: String?
+
+      def title=: (String) -> String
+
+      attr_reader visibility: Handinger::Models::UpdateWorker::visibility?
+
+      def visibility=: (
+        Handinger::Models::UpdateWorker::visibility
+      ) -> Handinger::Models::UpdateWorker::visibility
+
+      def initialize: (
+        ?instructions: String,
+        ?output_schema: ::Hash[Symbol, top]?,
+        ?summary: String,
+        ?title: String,
+        ?visibility: Handinger::Models::UpdateWorker::visibility
+      ) -> void
+
+      def to_hash: -> {
+        instructions: String,
+        output_schema: ::Hash[Symbol, top]?,
+        summary: String,
+        title: String,
+        visibility: Handinger::Models::UpdateWorker::visibility
+      }
+
+      type visibility = :public | :private
+
+      module Visibility
+        extend Handinger::Internal::Type::Enum
+
+        PUBLIC: :public
+        PRIVATE: :private
+
+        def self?.values: -> ::Array[Handinger::Models::UpdateWorker::visibility]
+      end
+    end
+  end
+end

data/sig/handinger/models/worker_delete_params.rbs

@@ -0,0 +1,23 @@
+module Handinger
+  module Models
+    type worker_delete_params =
+      { worker_id: String } & Handinger::Internal::Type::request_parameters
+
+    class WorkerDeleteParams < Handinger::Internal::Type::BaseModel
+      extend Handinger::Internal::Type::RequestParameters::Converter
+      include Handinger::Internal::Type::RequestParameters
+
+      attr_accessor worker_id: 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_create_response.rbs → worker_template.rbs}

@@ -1,6 +1,6 @@
 module Handinger
   module Models
-    type worker_create_response =
+    type worker_template =
       {
         id: String,
         created_at: String?,
@@ -11,10 +11,10 @@ module Handinger
         title: String,
         updated_at: String?,
         user_id: String,
-        visibility: Handinger::Models::WorkerCreateResponse::visibility
+        visibility: Handinger::Models::WorkerTemplate::visibility
       }
 
-    class WorkerCreateResponse < Handinger::Internal::Type::BaseModel
+    class WorkerTemplate < Handinger::Internal::Type::BaseModel
       attr_accessor id: String
 
       attr_accessor created_at: String?
@@ -33,7 +33,7 @@ module Handinger
 
       attr_accessor user_id: String
 
-      attr_accessor visibility: Handinger::Models::WorkerCreateResponse::visibility
+      attr_accessor visibility: Handinger::Models::WorkerTemplate::visibility
 
       def initialize: (
         id: String,
@@ -45,7 +45,7 @@ module Handinger
         title: String,
         updated_at: String?,
         user_id: String,
-        visibility: Handinger::Models::WorkerCreateResponse::visibility
+        visibility: Handinger::Models::WorkerTemplate::visibility
       ) -> void
 
       def to_hash: -> {
@@ -58,7 +58,7 @@ module Handinger
         title: String,
         updated_at: String?,
         user_id: String,
-        visibility: Handinger::Models::WorkerCreateResponse::visibility
+        visibility: Handinger::Models::WorkerTemplate::visibility
       }
 
       type visibility = :public | :private
@@ -69,7 +69,7 @@ module Handinger
         PUBLIC: :public
         PRIVATE: :private
 
-        def self?.values: -> ::Array[Handinger::Models::WorkerCreateResponse::visibility]
+        def self?.values: -> ::Array[Handinger::Models::WorkerTemplate::visibility]
       end
     end
   end

data/sig/handinger/models/worker_update_params.rbs

@@ -0,0 +1,25 @@
+module Handinger
+  module Models
+    type worker_update_params =
+      { worker_id: String } & Handinger::Internal::Type::request_parameters
+
+    class WorkerUpdateParams < Handinger::Models::UpdateWorker
+      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.rbs

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

data/sig/handinger/resources/tasks.rbs

@@ -18,6 +18,11 @@ module Handinger
         ?request_options: Handinger::request_opts
       ) -> Handinger::TaskWithTurns
 
+      def delete: (
+        String task_id,
+        ?request_options: Handinger::request_opts
+      ) -> Handinger::DeleteTaskResponse
+
       def initialize: (client: Handinger::Client) -> void
     end
   end