@questionbase/deskfree 0.3.0-alpha.25 → 0.3.0-alpha.27

package/dist/index.js

@@ -4697,6 +4697,12 @@ var wrapper_default = import_websocket.default;
 var activeTaskId = null;
 var completedTaskId = null;
 var inboundThreadId = null;
+function setActiveTaskId(taskId) {
+  if (taskId === null && activeTaskId !== null) {
+    completedTaskId = activeTaskId;
+  }
+  activeTaskId = taskId;
+}
 function getActiveTaskId() {
   return activeTaskId ?? completedTaskId ?? inboundThreadId;
 }
@@ -5202,7 +5208,7 @@ async function pollAndDeliver(client, ctx, cursor, log, account) {
       try {
         const botName = account?.botName;
         const humanName = account?.humanName;
-        const welcomeContent = botName && humanName ? `Hey ${botName}! I'm ${humanName}. We're connected through DeskFree \u2014 I'll send you tasks and you'll help me get things done. What should we work on first?` : "DeskFree is connected! Send me tasks and I'll help you get things done. What should we work on first?";
+        const welcomeContent = botName && humanName ? `Hey ${botName}! I'm ${humanName}. We're connected through DeskFree \u2014 I'll send you tasks and you'll help me get things done. What should we work on first? (Just reply to this \u2014 don't introduce yourself again on heartbeat, wait for my response.)` : "DeskFree is connected! Send me tasks and I'll help you get things done. What should we work on first? (Just reply to this \u2014 don't introduce yourself again on heartbeat, wait for my response.)";
         const welcomeMessage = {
           messageId: `welcome-${Date.now()}`,
           botId: "",
@@ -8805,6 +8811,7 @@ Tools: deskfree_start_task, deskfree_update_file, deskfree_complete_task, deskfr
 - Claim your task first with deskfree_start_task \u2014 this loads instructions, messages, and file context.
 - Save work to linked files with deskfree_update_file (incrementally).
 - Complete with deskfree_complete_task when done (summary required for outcome "done"). Include learnings if applicable.
+- If you need human input to proceed, send a message explaining what you need, then complete with outcome "review" \u2014 this marks the task as needing attention.
 - Propose follow-up tasks with deskfree_propose if you discover more work.`;
 function getDeskFreeContext(sessionKey) {
   const isWorker = sessionKey && (sessionKey.includes(":sub:") || sessionKey.includes(":spawn:") || sessionKey.includes(":run:"));
@@ -8841,6 +8848,54 @@ function resolveAccountFromConfig(api) {
     enabled: ch.enabled !== false
   };
 }
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+var MAX_TASK_CONTEXT_TOKENS = 8e3;
+var MAX_FULL_MESSAGES = 15;
+var MAX_FILE_CONTENT_CHARS = 4e3;
+function trimTaskContext(result) {
+  const raw = result;
+  const trimmed = {
+    taskId: result.taskId,
+    title: result.title,
+    status: result.status,
+    instructions: result.instructions
+  };
+  if (raw["substeps"]) {
+    trimmed.substeps = raw["substeps"];
+  }
+  if (raw["parentContext"]) {
+    trimmed.parentContext = raw["parentContext"];
+  }
+  if (result.messages && result.messages.length > 0) {
+    if (result.messages.length <= MAX_FULL_MESSAGES) {
+      trimmed.messages = result.messages;
+    } else {
+      const omitted = result.messages.length - MAX_FULL_MESSAGES;
+      const recentMessages = result.messages.slice(-MAX_FULL_MESSAGES);
+      trimmed.messages = recentMessages;
+      trimmed.messagesOmitted = `${omitted} earlier message(s) omitted \u2014 use deskfree_send_message to ask about history if needed`;
+    }
+  }
+  if (result.fileContext) {
+    const fc = result.fileContext;
+    if (fc.content.length > MAX_FILE_CONTENT_CHARS) {
+      trimmed.fileContext = {
+        fileId: fc.fileId,
+        name: fc.name,
+        description: fc.description,
+        contentFormat: fc.contentFormat,
+        version: fc.version,
+        content: fc.content.slice(0, MAX_FILE_CONTENT_CHARS),
+        contentTruncated: `Content truncated from ${fc.content.length} chars. Full content available \u2014 use deskfree_update_file with the complete replacement when editing.`
+      };
+    } else {
+      trimmed.fileContext = fc;
+    }
+  }
+  return trimmed;
+}
 function formatTaskResponse(task, summary, nextActions) {
   return {
     content: [
@@ -8946,6 +9001,33 @@ function validateStringParam(params, key, required) {
   }
   return value;
 }
+function validateEnumParam(params, key, allowedValues, required) {
+  if (!params) {
+    if (required) {
+      throw new Error(
+        `Required parameter '${key}' is missing (no params provided)`
+      );
+    }
+    return void 0;
+  }
+  const value = params[key];
+  if (value == null) {
+    if (required) throw new Error(`Required parameter '${key}' is missing`);
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    throw new Error(`Parameter '${key}' must be a string, got ${typeof value}`);
+  }
+  if (required && value.trim() === "") {
+    throw new Error(`Required parameter '${key}' cannot be empty`);
+  }
+  if (!allowedValues.includes(value)) {
+    throw new Error(
+      `Parameter '${key}' must be one of: ${allowedValues.join(", ")}, got: ${value}`
+    );
+  }
+  return value;
+}
 function parseProposeTasks(raw) {
   if (!Array.isArray(raw) || raw.length === 0) {
     throw new Error('Parameter "tasks" must be a non-empty array');
@@ -9001,6 +9083,65 @@ function parseInitiative(raw) {
   }
   return void 0;
 }
+function makeUpdateFileHandler(client) {
+  return async (_id, params) => {
+    try {
+      const fileId = validateStringParam(params, "fileId", true);
+      const content = validateStringParam(params, "content", true);
+      const contentFormat = validateEnumParam(
+        params,
+        "contentFormat",
+        ["markdown", "html"],
+        false
+      );
+      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"
+      ]);
+    } catch (err) {
+      return errorResult(err);
+    }
+  };
+}
+function makeCompleteTaskHandler(client) {
+  return async (_id, params) => {
+    try {
+      const taskId = validateStringParam(params, "taskId", true);
+      const outcome = validateEnumParam(
+        params,
+        "outcome",
+        ["done", "blocked"],
+        true
+      );
+      const summary = validateStringParam(params, "summary", false);
+      const evaluation = params?.evaluation;
+      const result = await client.completeTask({
+        taskId,
+        outcome,
+        summary,
+        ...evaluation ? { evaluation } : {}
+      });
+      setActiveTaskId(null);
+      const summaryVerb = outcome === "done" ? "completed" : "blocked";
+      const icon = outcome === "done" ? "\u2705" : "\u{1F6AB}";
+      await client.sendMessage({
+        content: `${icon} Task ${summaryVerb}: "${result.title}"`
+      }).catch(() => {
+      });
+      return formatTaskResponse(
+        result,
+        `Task "${result.title}" marked as ${summaryVerb} \u2014 waiting for human`,
+        [
+          outcome === "done" ? "Human will review your work summary" : "Human will review the blocker and provide guidance",
+          "Use deskfree_state to check for other tasks"
+        ]
+      );
+    } catch (err) {
+      return errorResult(err);
+    }
+  };
+}
 function makeReopenTaskHandler(client) {
   return async (_id, params) => {
     try {
@@ -9132,6 +9273,84 @@ function createOrchestratorTools(api) {
     }
   ];
 }
+function createWorkerTools(api) {
+  const account = resolveAccountFromConfig(api);
+  if (!account) return null;
+  const client = new DeskFreeClient(account.botToken, account.apiUrl);
+  return [
+    {
+      ...WORKER_TOOLS.START_TASK,
+      async execute(_id, params) {
+        try {
+          const taskId = validateStringParam(params, "taskId", true);
+          const runnerId = validateStringParam(params, "runnerId", false);
+          const result = await client.claimTask({ taskId, runnerId });
+          setActiveTaskId(taskId);
+          let skillInstructions = "";
+          if (result.skillContext?.length) {
+            skillInstructions = result.skillContext.map(
+              (s) => `
+\u26A0\uFE0F SKILL: ${s.displayName}
+${s.criticalSection}
+
+${s.instructions}`
+            ).join("\n\n---\n");
+          }
+          const trimmedTask = trimTaskContext(result);
+          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" : ""} active)` : ""}`,
+              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)"
+              ],
+              task: trimmedTask
+            },
+            null,
+            2
+          );
+          const totalTokens = estimateTokens(skillInstructions) + estimateTokens(taskJson);
+          const budgetWarning = totalTokens > MAX_TASK_CONTEXT_TOKENS ? `
+\u26A0\uFE0F Context budget: ~${totalTokens} tokens loaded (~${MAX_TASK_CONTEXT_TOKENS} target). Be concise in your reasoning.` : "";
+          return {
+            content: [
+              ...skillInstructions ? [{ type: "text", text: skillInstructions }] : [],
+              {
+                type: "text",
+                text: taskJson + budgetWarning
+              }
+            ]
+          };
+        } catch (err) {
+          return errorResult(err);
+        }
+      }
+    },
+    {
+      ...WORKER_TOOLS.UPDATE_FILE,
+      execute: makeUpdateFileHandler(client)
+    },
+    {
+      ...WORKER_TOOLS.COMPLETE_TASK,
+      execute: makeCompleteTaskHandler(client)
+    },
+    {
+      ...WORKER_TOOLS.SEND_MESSAGE,
+      execute: makeSendMessageHandler(client)
+    },
+    {
+      ...WORKER_TOOLS.PROPOSE,
+      execute: makeProposeHandler(client)
+    }
+  ];
+}
 
 // src/offline-queue.ts
 var MAX_QUEUE_SIZE2 = 100;
@@ -9247,7 +9466,17 @@ var plugin = {
     setDeskFreeRuntime(api.runtime);
     api.registerChannel({ plugin: deskFreePlugin });
     api.registerTool(() => {
-      return createOrchestratorTools(api);
+      const orchestratorTools = createOrchestratorTools(api) ?? [];
+      const workerTools = createWorkerTools(api) ?? [];
+      const seen = /* @__PURE__ */ new Set();
+      const allTools = [];
+      for (const tool of [...orchestratorTools, ...workerTools]) {
+        if (!seen.has(tool.name)) {
+          seen.add(tool.name);
+          allTools.push(tool);
+        }
+      }
+      return allTools.length > 0 ? allTools : null;
     });
     api.on("before_agent_start", (_event, ctx) => {
       return { prependContext: getDeskFreeContext(ctx.sessionKey) };