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

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.",
@@ -7996,7 +8021,7 @@ var ORCHESTRATOR_TOOLS = {
   },
   PROPOSE: {
     name: "deskfree_propose",
-    description: "Propose a plan for human approval. Nothing is created until the human reviews and approves in a modal. One initiative per call \u2014 make multiple calls for multiple initiatives. Include substeps as human-reviewable checklist items.",
+    description: "Propose a plan for human approval. Nothing is created until the human reviews and approves in a modal. One initiative per call \u2014 make multiple calls for multiple initiatives. Put all steps and details in the instructions field using simple markdown (bold, lists, inline code). Do NOT use markdown headers (#) \u2014 use **bold text** instead for section labels.",
     parameters: Type.Object({
       initiative: Type.Optional(
         Type.Union(
@@ -8035,12 +8060,12 @@ var ORCHESTRATOR_TOOLS = {
           }),
           instructions: Type.Optional(
             Type.String({
-              description: "Detailed instructions: what to do, why, what done looks like, known constraints"
+              description: "Detailed instructions in simple markdown (bold, lists, inline code \u2014 no # headers). Include: what to do, steps, why, what done looks like, known constraints."
             })
           ),
           substeps: Type.Optional(
             Type.Array(Type.String(), {
-              description: "Human-reviewable checklist items. The human can toggle each on/off before approving. Use for discrete steps within the task.",
+              description: "DEPRECATED \u2014 put steps in the instructions field as markdown instead. This field is ignored.",
               minItems: 1,
               maxItems: 20
             })
@@ -8159,7 +8184,7 @@ var SHARED_TOOLS = {
   },
   PROPOSE: {
     name: "deskfree_propose",
-    description: "Propose a plan for human approval. Nothing is created until the human reviews and approves in a modal. One initiative per call \u2014 make multiple calls for multiple initiatives. Include substeps as human-reviewable checklist items.",
+    description: "Propose a plan for human approval. Nothing is created until the human reviews and approves in a modal. One initiative per call \u2014 make multiple calls for multiple initiatives. Put all steps and details in the instructions field using simple markdown (bold, lists, inline code). Do NOT use markdown headers (#) \u2014 use **bold text** instead for section labels.",
     parameters: Type.Object({
       initiative: Type.Optional(
         Type.Union(
@@ -8198,12 +8223,12 @@ var SHARED_TOOLS = {
           }),
           instructions: Type.Optional(
             Type.String({
-              description: "Detailed instructions: what to do, why, what done looks like, known constraints"
+              description: "Detailed instructions in simple markdown (bold, lists, inline code \u2014 no # headers). Include: what to do, steps, why, what done looks like, known constraints."
             })
           ),
           substeps: Type.Optional(
             Type.Array(Type.String(), {
-              description: "Human-reviewable checklist items. The human can toggle each on/off before approving. Use for discrete steps within the task.",
+              description: "DEPRECATED \u2014 put steps in the instructions field as markdown instead. This field is ignored.",
               minItems: 1,
               maxItems: 20
             })
@@ -8854,7 +8879,7 @@ You are the orchestrator. Your job: turn human intent into approved tasks, then
 
 You do NOT claim tasks or do work directly. Sub-agents handle execution.
 - When a human writes in a task thread, you receive it with recent context. Use \`deskfree_reopen_task\` if it needs more work.
-- Write task instructions as if briefing a contractor who has never seen the codebase.
+- Write task instructions as rich markdown (bold, lists, inline code \u2014 no # headers). Brief a contractor who has never seen the codebase.
 - Estimate token cost per task \u2014 consider files to read, reasoning, output.
 - One initiative per proposal \u2014 make multiple calls for multiple initiatives.`;
 var DESKFREE_WORKER_DIRECTIVE = `## DeskFree Worker
@@ -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)