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

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" };
@@ -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(
@@ -9099,6 +9079,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)