@questionbase/deskfree 0.3.0-alpha.40 → 0.3.0-alpha.41

package/dist/index.d.ts

@@ -699,6 +699,7 @@ declare class DeskFreeClient {
         tasks: Array<{
             title?: string;
             instructions?: string;
+            steps?: string[];
             substeps?: string[];
             file?: {
                 type: 'existing';

package/dist/index.js

@@ -4810,7 +4810,7 @@ async function deliverMessageToAgent(ctx, message, client) {
     From: message.humanId,
     To: message.humanId,
     MessageSid: message.messageId,
-    ThreadId: message.taskId ?? void 0,
+    MessageThreadId: message.taskId ?? void 0,
     Timestamp: message.createdAt,
     AccountId: ctx.accountId,
     FromName: message.userName ?? "Unknown",
@@ -8163,6 +8163,9 @@ var ORCHESTRATOR_TOOLS = {
     name: "deskfree_send_message",
     description: "Send a message to the human. Keep it short \u2014 1-3 sentences. No walls of text.",
     parameters: Type.Object({
+      type: Type.Union([Type.Literal("notify"), Type.Literal("ask")], {
+        description: "notify = general update (quiet). ask = needs human attention (surfaces prominently)."
+      }),
       content: Type.String({
         description: "Message content."
       }),
@@ -8323,11 +8326,6 @@ var SHARED_TOOLS = {
                 description: "Updated global Ways of Working (full replacement). Keep surgical \u2014 only add or modify relevant sections, do not inflate with restated context."
               })
             ),
-            initiativeId: Type.Optional(
-              Type.String({
-                description: "Initiative ID to update"
-              })
-            ),
             initiativeContent: Type.Optional(
               Type.String({
                 description: "Updated initiative content (full replacement). Keep surgical \u2014 evolve what exists, do not rewrite from scratch."
@@ -9001,16 +8999,17 @@ You do NOT claim tasks, complete tasks, or do work directly \u2014 you have no a
 - Initiative titles should reflect aspirations and outcomes, not activities. "AI Thought Leadership on LinkedIn" over "LinkedIn Content."
 - Initiative descriptions should be 2-3 sentences that make the human think "wow, this will enable my dreams." Reflect their ambition back to them. No headers, no phases, no formal structure. Aspirational, not operational.`;
 var DESKFREE_WORKER_DIRECTIVE = `## DeskFree Worker
-You are a worker sub-agent. Call \`deskfree_start_task\` with your taskId to claim and load context.
+You are a worker sub-agent. If you have prior conversation history with task context, continue from where you left off. Otherwise, call \`deskfree_start_task\` with your taskId to claim and load context.
 Tools: deskfree_start_task, deskfree_update_steps, deskfree_update_file, deskfree_complete_task, deskfree_send_message, deskfree_propose.
 
 **After claiming a task, your first message should be how you plan to approach it.** Work one step at a time and share progress naturally \u2014 like updating a coworker.
 
-- Claim your task first with deskfree_start_task \u2014 this loads steps, messages, and file context.
+- If continuing from a previous conversation (you can see prior tool calls and context), respond directly to the human's latest message \u2014 do NOT call deskfree_start_task again.
+- If starting fresh, claim your task first with deskfree_start_task \u2014 this loads steps, messages, and file context.
 - Use deskfree_update_steps to update step progress as you work. Send the full step list each time with updated statuses.
 - Save work to linked files with deskfree_update_file. Build up incrementally \u2014 start with structure/outline, then flesh out.
 - Use deskfree_send_message with type "notify" for progress updates. Keep it brief \u2014 1-3 sentences.
-- Use deskfree_send_message with type "ask" when you need human input OR when work is ready for review. Terminate after sending an ask.
+- Use deskfree_send_message with type "ask" when you need human input OR when work is ready for review.
 - Only complete (deskfree_complete_task with humanApproved: true) after the human has confirmed in the thread. Never self-complete without human response.
 - When completing: pass "learnings" only for genuine new knowledge. Pass "followUps" as brief handoffs.
 - On 409 or 404 errors: STOP. Do not retry. Call deskfree_state to find available tasks.`;
@@ -9330,6 +9329,11 @@ function parseProposeTasks(raw) {
     if (typeof title !== "string" || title.trim() === "") {
       throw new Error(`tasks[${i}].title must be a non-empty string`);
     }
+    let steps;
+    if (Array.isArray(item["steps"]) && item["steps"].length > 0) {
+      steps = item["steps"].filter((s2) => typeof s2 === "string" && s2.trim() !== "").map((s2) => s2.trim());
+      if (steps.length === 0) steps = void 0;
+    }
     let substeps;
     if (Array.isArray(item["substeps"]) && item["substeps"].length > 0) {
       substeps = item["substeps"].filter((s2) => typeof s2 === "string" && s2.trim() !== "").map((s2) => s2.trim());
@@ -9351,6 +9355,7 @@ function parseProposeTasks(raw) {
     return {
       title: title.trim(),
       instructions: typeof item["instructions"] === "string" ? item["instructions"] : void 0,
+      steps,
       substeps,
       file,
       estimatedTokens: typeof item["estimatedTokens"] === "number" ? item["estimatedTokens"] : void 0,
@@ -9381,7 +9386,8 @@ function makeUpdateStepsHandler(client) {
         throw new Error("steps must be a non-empty array");
       }
       const steps = rawSteps.map((s) => {
-        if (typeof s !== "object" || s === null) throw new Error("Invalid step");
+        if (typeof s !== "object" || s === null)
+          throw new Error("Invalid step");
         const obj = s;
         const label = typeof obj["label"] === "string" ? obj["label"].trim() : "";
         const status = typeof obj["status"] === "string" ? obj["status"] : "pending";
@@ -9392,10 +9398,16 @@ function makeUpdateStepsHandler(client) {
         return { label, status };
       });
       await client.updateSteps({ taskId, steps });
-      const doneCount = steps.filter((s) => s.status === "done").length;
+      const doneCount = steps.filter(
+        (s) => s.status === "done"
+      ).length;
+      const allDone = doneCount === steps.length;
       return formatConfirmation(
         `Updated steps for task ${taskId} (${doneCount}/${steps.length} done)`,
-        ["Step progress saved \u2014 continue working"]
+        allDone ? [
+          "All steps complete \u2014 send an ask message for human review",
+          'Use deskfree_send_message with type "ask" to request review, then terminate and wait'
+        ] : ["Step progress saved \u2014 continue working"]
       );
     } catch (err) {
       return errorResult(err);
@@ -9416,7 +9428,7 @@ function makeUpdateFileHandler(client) {
       await client.updateFile({ fileId, content, contentFormat });
       return formatConfirmation(`Updated file ${fileId}`, [
         "File content has been saved",
-        "Complete the task with deskfree_complete_task when ready"
+        'When work is ready for review, send an ask message with deskfree_send_message (type "ask") and terminate'
       ]);
     } catch (err) {
       return errorResult(err);
@@ -9521,6 +9533,7 @@ function makeProposeHandler(client) {
         tasks: tasks.map((t) => ({
           title: t.title,
           instructions: t.instructions,
+          steps: t.steps,
           substeps: t.substeps,
           file: t.file,
           estimatedTokens: t.estimatedTokens,
@@ -9630,16 +9643,13 @@ ${s.criticalSection}`
         const taskJson = JSON.stringify(
           {
             summary: `Claimed task "${result.title}" \u2014 full context loaded${result.skillContext?.length ? ` (${result.skillContext.length} skill${result.skillContext.length > 1 ? "s" : ""} loaded \u2014 use deskfree_read_skill_section for full details)` : ""}`,
-            mode: trimmedTask.mode ?? "work",
             nextActions: [
               "Read the instructions and message history carefully",
               ...result.fileContext ? [
                 `Task has a linked file "${result.fileContext.name}" (ID: ${result.fileContext.fileId}) \u2014 use deskfree_update_file to save your work to it`
               ] : [],
-              ...trimmedTask.mode === "evaluation" ? [
-                "This is an evaluation task \u2014 review the WoW context and provide your evaluation in deskfree_complete_task"
-              ] : [],
-              "Complete with deskfree_complete_task when done (summary required)"
+              'When work is done, send an ask message (deskfree_send_message type "ask") for human review, then terminate',
+              "Only call deskfree_complete_task after the human has responded in the thread"
             ],
             task: trimmedTask
           },