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

package/README.md

@@ -117,12 +117,9 @@ Edit your OpenClaw config file (`~/.openclaw/config.json5`):
 Tasks follow a strict state machine. The agent claims a task, works on it, and completes it (done or blocked) — always returning control to a human.
 
 ```
-bot ──[start_task]──> bot (is_working) ──[complete_task(done)]──> human
-                                       │                                        │
-                                       └──[complete_task(blocked)]──>           │
-                                                                     human approves/declines
-                                                                                │
-                                                                         [approve] → done
+pending ──[start_task]──> active ──[complete_task(review)]──> review ──[bot completes]──> done
+                                  └──[complete_task(done)]──> done
+                                  └──[complete_task(blocked)]──> review
 ```
 
 See `skills/deskfree/references/tools.md` for the full tool reference.

package/dist/index.d.ts

@@ -418,8 +418,7 @@ interface WsNotification {
 interface Task {
     taskId: string;
     title: string;
-    status: 'bot' | 'human' | 'done';
-    isWorking?: boolean;
+    status: 'pending' | 'active' | 'review' | 'done';
     instructions?: string;
     createdAt: string;
     updatedAt: string;
@@ -432,9 +431,8 @@ interface Task {
 interface TaskSummary {
     taskId: string;
     title: string;
-    status: 'bot' | 'human' | 'done';
+    status: 'pending' | 'active' | 'review' | 'done';
     instructions: string | null;
-    isWorking: boolean;
     fileId: string | null;
     fileName: string | null;
     createdAt: string;
@@ -476,8 +474,7 @@ interface CompleteTaskInput {
 interface WorkspaceStateTask {
     taskId: string;
     title: string;
-    status: 'bot' | 'human' | 'done';
-    isWorking?: boolean;
+    status: 'pending' | 'active' | 'review' | 'done';
     instructions?: string | null;
     fileId?: string | null;
     fileName?: string | null;
@@ -505,35 +502,9 @@ interface WorkspaceState {
     tasks: WorkspaceStateTask[];
     recentlyDone: WorkspaceStateTask[];
     waysOfWorking: string | null;
-    pendingEvaluations: Array<{
-        taskId: string;
-        taskNumber: number;
-        title: string;
-        initiativeId?: string | null;
-    }>;
     initiatives: Initiative[];
     files: WorkspaceFile[];
 }
-interface EvaluationTaskMessage {
-    messageId: string;
-    authorType: string;
-    content: string;
-    createdAt: string;
-    userName: string | null;
-}
-interface ClaimEvaluationResponse {
-    task: Task & {
-        evaluationPending: boolean;
-    };
-    waysOfWorking: string | null;
-    currentVersion: number;
-    messages: EvaluationTaskMessage[];
-    initiative?: {
-        id: string;
-        title: string;
-        content: string;
-    } | null;
-}
 
 /** Enhanced error class for DeskFree API errors with user-friendly messages */
 declare class DeskFreeError extends Error {
@@ -722,29 +693,12 @@ declare class DeskFreeClient {
     }): Promise<{
         messageId: string;
     }>;
-    /**
-     * Claim a pending evaluation for a task. Atomically sets isWorking=true where
-     * evaluationPending=true and isWorking=false. Returns null if already claimed.
-     */
-    claimEvaluation(input: {
-        taskId: string;
-    }): Promise<ClaimEvaluationResponse | null>;
-    /**
-     * Submit the result of a ways-of-working evaluation.
-     * Dual output: globalWoW (applies everywhere) and initiative (applies to the task's initiative).
-     * Clears evaluationPending and isWorking on the task.
-     */
-    submitEvaluation(input: {
-        taskId: string;
+    /** Update ways of working and/or initiative content based on learnings. */
+    updateKnowledge(input: {
+        globalWoW?: string;
+        initiativeId?: string;
+        initiativeContent?: string;
         reasoning: string;
-        globalWoW: {
-            hasChanges: boolean;
-            updatedContent?: string;
-        };
-        initiative: {
-            hasChanges: boolean;
-            updatedContent?: string;
-        };
     }): Promise<{
         success: boolean;
         globalVersion?: number;
@@ -816,4 +770,4 @@ declare const plugin: {
     register(api: OpenClawPluginApi): void;
 };
 
-export { type AnyAgentTool, type ChannelAccountSnapshot, type ChannelCapabilities, type ChannelConfigAdapter, type ChannelGatewayAdapter, type ChannelGatewayContext, type ChannelLogoutContext, type ChannelLogoutResult, type ChannelMessagingAdapter, type ChannelMessagingTargetResolver, type ChannelMeta, type ChannelOnboardingAdapter, type ChannelOnboardingResult, type ChannelOnboardingStatus, type ChannelOutboundAdapter, type ChannelOutboundContext, type ChannelPlugin, type ChannelProbeResult, type ChannelSecurityAdapter, type ChannelSecurityDmPolicy, type ChannelSetupAdapter, type ChannelStatusAdapter, type ChannelStatusIssue, type ChatMessage, type ChatMessageAttachment, type ClaimEvaluationResponse, type CompleteTaskInput, type DeskFreeChannelConfig, DeskFreeClient, DeskFreeError, type EvaluationTaskMessage, type FileContext, type FinalizedMsgContext, type Initiative, type MessagesResponse, OfflineQueue, type OpenClawConfig, type OpenClawPluginApi, type OpenClawPluginToolContext, type OpenClawPluginToolFactory, type OpenClawPluginToolOptions, type OutboundDeliveryResult, type PluginHookAgentContext, type PluginHookBeforeAgentStartEvent, type PluginHookBeforeAgentStartResult, type PluginHookHandlerMap, type PluginHookName, type PluginLogger, type PluginRuntime, type ReplyDispatcher, type ResolvedDeskFreeAccount, type Task, type TaskMessage, type TaskSummary, type TaskWithContext, type WizardPrompter, type WorkspaceFile, type WorkspaceState, type WorkspaceStateTask, type WsNotification, type WsTicketResponse, plugin as default, reportError };
+export { type AnyAgentTool, type ChannelAccountSnapshot, type ChannelCapabilities, type ChannelConfigAdapter, type ChannelGatewayAdapter, type ChannelGatewayContext, type ChannelLogoutContext, type ChannelLogoutResult, type ChannelMessagingAdapter, type ChannelMessagingTargetResolver, type ChannelMeta, type ChannelOnboardingAdapter, type ChannelOnboardingResult, type ChannelOnboardingStatus, type ChannelOutboundAdapter, type ChannelOutboundContext, type ChannelPlugin, type ChannelProbeResult, type ChannelSecurityAdapter, type ChannelSecurityDmPolicy, type ChannelSetupAdapter, type ChannelStatusAdapter, type ChannelStatusIssue, type ChatMessage, type ChatMessageAttachment, type CompleteTaskInput, type DeskFreeChannelConfig, DeskFreeClient, DeskFreeError, type FileContext, type FinalizedMsgContext, type Initiative, type MessagesResponse, OfflineQueue, type OpenClawConfig, type OpenClawPluginApi, type OpenClawPluginToolContext, type OpenClawPluginToolFactory, type OpenClawPluginToolOptions, type OutboundDeliveryResult, type PluginHookAgentContext, type PluginHookBeforeAgentStartEvent, type PluginHookBeforeAgentStartResult, type PluginHookHandlerMap, type PluginHookName, type PluginLogger, type PluginRuntime, type ReplyDispatcher, type ResolvedDeskFreeAccount, type Task, type TaskMessage, type TaskSummary, type TaskWithContext, type WizardPrompter, type WorkspaceFile, type WorkspaceState, type WorkspaceStateTask, type WsNotification, type WsTicketResponse, plugin as default, reportError };

package/dist/index.js

@@ -3954,23 +3954,10 @@ var DeskFreeClient = class {
     }
     return this.request("POST", "tasks.propose", input);
   }
-  /**
-   * Claim a pending evaluation for a task. Atomically sets isWorking=true where
-   * evaluationPending=true and isWorking=false. Returns null if already claimed.
-   */
-  async claimEvaluation(input) {
-    this.requireNonEmpty(input.taskId, "taskId");
-    return this.request("POST", "waysOfWorking.claim", input);
-  }
-  /**
-   * Submit the result of a ways-of-working evaluation.
-   * Dual output: globalWoW (applies everywhere) and initiative (applies to the task's initiative).
-   * Clears evaluationPending and isWorking on the task.
-   */
-  async submitEvaluation(input) {
-    this.requireNonEmpty(input.taskId, "taskId");
+  /** Update ways of working and/or initiative content based on learnings. */
+  async updateKnowledge(input) {
     this.requireNonEmpty(input.reasoning, "reasoning");
-    return this.request("POST", "waysOfWorking.evaluate", input);
+    return this.request("POST", "waysOfWorking.update", input);
   }
   /**
    * Lightweight health check that verifies connectivity and authentication.
@@ -4476,7 +4463,7 @@ function truncateAtWord(text, maxLen) {
   return (lastSpace > 0 ? truncated.slice(0, lastSpace) : truncated) + "\u2026";
 }
 function buildBodyForAgent(task, content, recentMessages) {
-  let prefix = `[Task thread: "${task.title}" | status: ${task.status} | isWorking: ${task.isWorking}]`;
+  let prefix = `[Task thread: "${task.title}" | status: ${task.status}]`;
   if (task.instructions) {
     prefix += "\n" + truncateAtWord(task.instructions, MAX_INSTRUCTIONS_LENGTH);
   }
@@ -4491,10 +4478,10 @@ function buildBodyForAgent(task, content, recentMessages) {
   return prefix + "\n\n" + content;
 }
 function resolveTaskRouting(task, hasAttachments) {
-  if (task.isWorking) {
+  if (task.status === "active") {
     return { target: "runner" };
   }
-  if (hasAttachments && (task.status === "human" || task.status === "done")) {
+  if (hasAttachments && (task.status === "review" || task.status === "done")) {
     return { target: "auto-reopen" };
   }
   return { target: "orchestrator" };
@@ -5215,7 +5202,7 @@ async function pollAndDeliver(client, ctx, cursor, log, account) {
       try {
         const botName = account?.botName;
         const humanName = account?.humanName;
-        const welcomeContent = botName && humanName ? `Hi! I'm ${humanName}. Your name is ${botName}. Welcome to DeskFree \u2014 read your BOOTSTRAP.md to get started, then check for any tasks.` : "DeskFree plugin installed! Read your BOOTSTRAP.md if you haven't already, then check for any tasks.";
+        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 welcomeMessage = {
           messageId: `welcome-${Date.now()}`,
           botId: "",
@@ -7912,6 +7899,30 @@ var ORCHESTRATOR_TOOLS = {
       )
     })
   },
+  UPDATE_KNOWLEDGE: {
+    name: "deskfree_update_knowledge",
+    description: "Update ways of working and/or initiative content based on learnings from completed tasks.",
+    parameters: Type.Object({
+      globalWoW: Type.Optional(
+        Type.String({
+          description: "Full updated global ways-of-working markdown content"
+        })
+      ),
+      initiativeId: Type.Optional(
+        Type.String({
+          description: "Initiative ID to update"
+        })
+      ),
+      initiativeContent: Type.Optional(
+        Type.String({
+          description: "Full updated initiative content markdown (required if initiativeId provided)"
+        })
+      ),
+      reasoning: Type.String({
+        description: "Explanation of why these updates were made and what was learned"
+      })
+    })
+  },
   SEND_MESSAGE: {
     name: "deskfree_send_message",
     description: "Send a message (progress update, question, status report). Used for communication outside of task threads.",
@@ -8049,60 +8060,29 @@ var SHARED_TOOLS = {
   },
   COMPLETE_TASK: {
     name: "deskfree_complete_task",
-    description: 'Finish a task. Outcome "done" = work complete (summary required). Outcome "blocked" = need human input. Both move to human. For evaluation tasks (mode="evaluation"), include the evaluation object when outcome is "done".',
+    description: "Finish a task. Transitions to review/done status based on outcome.",
     parameters: Type.Object({
       taskId: Type.String({ description: "Task UUID" }),
-      outcome: Type.Union([Type.Literal("done"), Type.Literal("blocked")], {
-        description: '"done" = work complete, "blocked" = need human input'
-      }),
+      outcome: Type.Union(
+        [
+          Type.Literal("review"),
+          Type.Literal("done"),
+          Type.Literal("blocked"),
+          Type.Literal("cancelled")
+        ],
+        {
+          description: '"review" = ready for human review, "done" = work complete, "blocked" = need human input, "cancelled" = task cancelled'
+        }
+      ),
       summary: Type.Optional(
         Type.String({
-          description: 'Brief summary of what was accomplished (required for outcome "done", max 2000 chars)'
+          description: "Brief summary of what was accomplished (max 2000 chars)"
         })
       ),
-      evaluation: Type.Optional(
-        Type.Object(
-          {
-            reasoning: Type.String({
-              description: "Explanation of your evaluation \u2014 what you analyzed and why you did or did not update the ways of working and/or initiative content"
-            }),
-            globalWoW: Type.Object(
-              {
-                hasChanges: Type.Boolean({
-                  description: "Whether the global ways of working should be updated"
-                }),
-                updatedContent: Type.Optional(
-                  Type.String({
-                    description: "Full updated global ways-of-working markdown (required if hasChanges=true)"
-                  })
-                )
-              },
-              {
-                description: "Global ways-of-working update \u2014 patterns that apply across all work"
-              }
-            ),
-            initiative: Type.Optional(
-              Type.Object(
-                {
-                  hasChanges: Type.Boolean({
-                    description: "Whether the initiative content should be updated (ignored if task has no initiative)"
-                  }),
-                  updatedContent: Type.Optional(
-                    Type.String({
-                      description: "Full updated initiative content markdown (required if hasChanges=true)"
-                    })
-                  )
-                },
-                {
-                  description: "Initiative content update \u2014 what was learned about this specific area of focus. Ignored if the task has no initiative_id."
-                }
-              )
-            )
-          },
-          {
-            description: 'Required when completing an evaluation task (mode="evaluation") with outcome "done". Review global WoW and initiative content and provide your analysis.'
-          }
-        )
+      learnings: Type.Optional(
+        Type.String({
+          description: "Key insights, patterns, or lessons learned from completing this task. Used to improve future work."
+        })
       )
     })
   },
@@ -8228,7 +8208,7 @@ var SHARED_TOOLS = {
 var WORKER_TOOLS = {
   START_TASK: {
     name: "deskfree_start_task",
-    description: 'Claim a bot task (isWorking=false) and start working. Returns full context (instructions, message history, and fileContext if the task has a linked file \u2014 use the file content as working context). For evaluation tasks, also returns WoW context and mode="evaluation".',
+    description: "Claim a pending task and start working. Returns full context (instructions, message history, and fileContext if the task has a linked file \u2014 use the file content as working context).",
     parameters: Type.Object({
       taskId: Type.String({ description: "Task UUID to claim" }),
       runnerId: Type.Optional(
@@ -8799,12 +8779,21 @@ var deskFreePlugin = {
 
 // src/context.ts
 var DESKFREE_AGENT_DIRECTIVE = `## DeskFree \u2014 Orchestrator
-You are the orchestrator. You assess state, propose plans, and dispatch work to sub-agents.
+You are the orchestrator. Your job: turn human intent into approved tasks, then dispatch work.
+
+**The core loop: propose \u2192 approve \u2192 work. Make this feel natural and fast.**
+
 1. **Check state** \u2192 \`deskfree_state\` \u2014 see tasks, initiatives, ways of working.
-2. **Propose plan** \u2192 \`deskfree_propose\` \u2014 ALL work requires human-approved tasks first.
-3. **Dispatch** \u2192 spawn a sub-agent for each approved task. Pass the taskId \u2014 the sub-agent claims it.
+2. **Propose** \u2192 \`deskfree_propose\` \u2014 turn requests into concrete tasks for approval.
+3. **Dispatch** \u2192 spawn a sub-agent for each approved task. Pass the taskId.
 4. **Communicate** \u2192 \`deskfree_send_message\` for updates outside task threads.
 
+**Bias toward action, not questions.** When a human gives you a direction:
+- Don't ask clarifying questions in the main thread. Propose tasks instead.
+- If the request is clear ("audit my LinkedIn profile"), propose the task directly \u2014 no scoping needed.
+- If the request is ambiguous ("I want to be a LinkedIn influencer"), propose a scoping task first: "Research current state and draft a plan" \u2014 the worker reports back with findings and follow-up proposals.
+- Discovery happens inside tasks, not in conversation. Tasks produce deliverables; questions don't.
+
 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.
@@ -8815,8 +8804,7 @@ You are a worker sub-agent. Call \`deskfree_start_task\` with your taskId to cla
 Tools: deskfree_start_task, deskfree_update_file, deskfree_complete_task, deskfree_send_message, deskfree_propose.
 - 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").
-- For evaluation tasks (mode="evaluation"), include the evaluation object in complete_task.
+- Complete with deskfree_complete_task when done (summary required for outcome "done"). Include learnings if applicable.
 - 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:"));
@@ -9099,6 +9087,41 @@ function createOrchestratorTools(api) {
       ...ORCHESTRATOR_TOOLS.REOPEN_TASK,
       execute: makeReopenTaskHandler(client)
     },
+    {
+      ...ORCHESTRATOR_TOOLS.UPDATE_KNOWLEDGE,
+      async execute(_id, params) {
+        try {
+          const globalWoW = validateStringParam(params, "globalWoW", false);
+          const initiativeId = validateStringParam(
+            params,
+            "initiativeId",
+            false
+          );
+          const initiativeContent = validateStringParam(
+            params,
+            "initiativeContent",
+            false
+          );
+          const reasoning = validateStringParam(params, "reasoning", true);
+          const result = await client.updateKnowledge({
+            globalWoW,
+            initiativeId,
+            initiativeContent,
+            reasoning
+          });
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Knowledge updated successfully: ${JSON.stringify(result, null, 2)}`
+              }
+            ]
+          };
+        } catch (err) {
+          return errorResult(err);
+        }
+      }
+    },
     {
       ...ORCHESTRATOR_TOOLS.SEND_MESSAGE,
       execute: makeSendMessageHandler(client)