@questionbase/deskfree 0.3.0-alpha.30 → 0.3.0-alpha.31

package/dist/index.d.ts

@@ -668,6 +668,17 @@ declare class DeskFreeClient {
         taskId: string;
         reason?: string;
     }): Promise<Task>;
+    /** Snooze a task until a specified time. Task is hidden from active queues until then. */
+    snoozeTask(input: {
+        taskId: string;
+        scheduledFor: string;
+        initiator: 'human_request' | 'bot_decision';
+        reason: string;
+    }): Promise<Task>;
+    /** Unsnooze a task, making it immediately active before the snooze expires. */
+    unsnoozeTask(input: {
+        taskId: string;
+    }): Promise<Task>;
     /** Propose a plan — creates a proposal message with plan metadata. No DB rows until human approves. */
     proposePlan(input: {
         tasks: Array<{

package/dist/index.js

@@ -3942,6 +3942,18 @@ var DeskFreeClient = class {
     this.requireNonEmpty(input.taskId, "taskId");
     return this.request("POST", "tasks.reopen", input);
   }
+  /** Snooze a task until a specified time. Task is hidden from active queues until then. */
+  async snoozeTask(input) {
+    this.requireNonEmpty(input.taskId, "taskId");
+    this.requireNonEmpty(input.scheduledFor, "scheduledFor");
+    this.requireNonEmpty(input.reason, "reason");
+    return this.request("POST", "tasks.snooze", input);
+  }
+  /** Unsnooze a task, making it immediately active before the snooze expires. */
+  async unsnoozeTask(input) {
+    this.requireNonEmpty(input.taskId, "taskId");
+    return this.request("POST", "tasks.unsnooze", input);
+  }
   /** Propose a plan — creates a proposal message with plan metadata. No DB rows until human approves. */
   async proposePlan(input) {
     if (!input.tasks || input.tasks.length === 0) {
@@ -7944,6 +7956,19 @@ var ORCHESTRATOR_TOOLS = {
     description: "Get full workspace state \u2014 all tasks, recently done tasks, active initiatives. Use to assess what needs attention.",
     parameters: Type.Object({})
   },
+  SCHEDULE_TASK: {
+    name: "deskfree_schedule_task",
+    description: "Schedule or reschedule a task. Pass a future ISO datetime to defer the task until that time. Pass null to activate it immediately. Use when the human asks to defer, park, or reschedule a task.",
+    parameters: Type.Object({
+      taskId: Type.String({ description: "Task UUID to schedule" }),
+      scheduledFor: Type.Union([Type.String(), Type.Null()], {
+        description: "ISO 8601 datetime for when the task should activate. Pass null to activate immediately."
+      }),
+      reason: Type.String({
+        description: "Brief explanation (shown in task thread)"
+      })
+    })
+  },
   REOPEN_TASK: {
     name: "deskfree_reopen_task",
     description: "Reopen a completed or human-side task back to bot status. Use when a human message in a task thread indicates more work is needed. The task becomes available for a worker to claim.",
@@ -9276,6 +9301,41 @@ function createOrchestratorTools(api) {
         }
       }
     },
+    {
+      ...ORCHESTRATOR_TOOLS.SCHEDULE_TASK,
+      async execute(_id, params) {
+        try {
+          const taskId = validateStringParam(params, "taskId", true);
+          const scheduledFor = params?.scheduledFor;
+          const reason = validateStringParam(params, "reason", true);
+          if (scheduledFor) {
+            const result = await client.snoozeTask({
+              taskId,
+              scheduledFor,
+              initiator: "human_request",
+              reason
+            });
+            return formatTaskResponse(
+              result,
+              `Task "${result.title}" scheduled for ${new Date(scheduledFor).toLocaleString()}`,
+              [
+                `Reason: ${reason}`,
+                "Task will resurface automatically at the scheduled time"
+              ]
+            );
+          } else {
+            const result = await client.unsnoozeTask({ taskId });
+            return formatTaskResponse(
+              result,
+              `Task "${result.title}" activated immediately`,
+              ["Task is now available in the active queue"]
+            );
+          }
+        } catch (err) {
+          return errorResult(err);
+        }
+      }
+    },
     {
       ...ORCHESTRATOR_TOOLS.REOPEN_TASK,
       execute: makeReopenTaskHandler(client)