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

package/README.md

@@ -15,31 +15,30 @@ Agents can pick up tasks, post progress updates, mark work as done or blocked, m
 │   deskfree_state             Inbound messages from humans        │
 │   deskfree_start_task        Outbound replies from agent         │
 │   deskfree_complete_task     Real-time notifications             │
-│   deskfree_suggest_tasks                                           │
-│   deskfree_create_activity                                       │
-│   deskfree_update_activity                                       │
-│   deskfree_classify_task                                         │
-│   deskfree_learn_from_task                                       │
-│   deskfree_update_deliverable                                    │
-│   deskfree_send_message (+ task suggestions)                     │
+│   deskfree_send_message                                          │
+│   deskfree_propose                                               │
+│   deskfree_update_file                                           │
+│   deskfree_create_file                                           │
+│   deskfree_claim_evaluation                                      │
+│   deskfree_submit_evaluation                                     │
 └──────────┬───────────────────────────┬───────────────────────────┘
            │                           │
            ▼                           ▼
 ┌──────────────────────────────────────────────────────────────────┐
 │                      DeskFree Backend                           │
 │                                                                  │
-│   Tasks          Activities      Messages        WebSocket Gateway│
-│   ──────         ──────────      ────────        ─────────────── │
-│   State machine  Knowledge       1:1 bot↔user   DynamoDB-backed  │
-│   RLS-scoped     containers      Threaded by     Thin notifs      │
-│   Atomic claims  Learn loop      task            + polling fallback│
+│   Tasks          Files           Messages        WebSocket Gateway│
+│   ──────         ─────           ────────        ─────────────── │
+│   State machine  Persistent      1:1 bot↔user   DynamoDB-backed  │
+│   RLS-scoped     documents       Threaded by     Thin notifs      │
+│   Atomic claims  Versioned       task            + polling fallback│
 └──────────────────────────────────────────────────────────────────┘
 ```
 
 The plugin registers three things with OpenClaw:
 
 1. **Channel** — bidirectional messaging between DeskFree users and the agent
-2. **Tools** — 10 task, activity, and messaging tools the agent can call
+2. **Tools** — 9 task, file, and messaging tools the agent can call
 3. **Skill** — workflow knowledge that teaches the agent how to use the tools correctly
 
 ## Install
@@ -118,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.
@@ -132,7 +128,7 @@ See `skills/deskfree/references/tools.md` for the full tool reference.
 
 **Inbound (human → agent):** WebSocket sends thin notification (`hint: "message.new"`) → plugin fetches full message via HTTP. Fallback: polls every 30s if WebSocket is unavailable.
 
-**Outbound (agent → human):** Messages chunked at 2000 chars → `POST messages.send` per chunk.
+**Outbound (agent → human):** Supports streaming (progressive deltas via `streamChunk`, finalized via `updateMessage`) and non-streaming (direct `POST messages.send`). Text chunked at 2000 chars when streaming is not active.
 
 ### WebSocket Gateway
 

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;
@@ -460,6 +458,13 @@ interface TaskWithContext extends Task {
     instructions: string;
     messages: TaskMessage[];
     fileContext: FileContext | null;
+    skillContext?: Array<{
+        skillId: string;
+        name: string;
+        displayName: string;
+        instructions: string;
+        criticalSection: string;
+    }>;
 }
 interface CompleteTaskInput {
     taskId: string;
@@ -469,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;
@@ -498,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 {
@@ -566,6 +544,17 @@ declare class DeskFreeClient {
         messageId: string;
         content: string;
     }>;
+    /**
+     * Send a streaming chunk (delta only) for an in-progress message.
+     * Broadcasts delta over WS and stores full content in DynamoDB for crash recovery.
+     */
+    streamChunk(input: {
+        messageId: string;
+        delta: string;
+        fullContent: string;
+    }): Promise<{
+        messageId: string;
+    }>;
     /**
      * Send a text message to a DeskFree conversation.
      *
@@ -588,6 +577,7 @@ declare class DeskFreeClient {
     /** Fetch paginated message history for a conversation. */
     listMessages(input: {
         userId?: string;
+        taskId?: string;
         cursor?: string | null;
         limit?: number;
     }): Promise<MessagesResponse>;
@@ -596,6 +586,7 @@ declare class DeskFreeClient {
     /** Claim a task so the bot can begin working on it. Returns enriched context. */
     claimTask(input: {
         taskId: string;
+        runnerId?: string;
     }): Promise<TaskWithContext>;
     /** Fetch a lightweight task summary by ID. Read-only, no side effects. */
     getTask(input: {
@@ -672,48 +663,42 @@ declare class DeskFreeClient {
     completeTask(input: CompleteTaskInput): Promise<Task & {
         outcome: 'done' | 'blocked';
     }>;
-    /** Suggest tasks via the dedicated bot/tasks.suggest endpoint. */
-    suggestTasksDedicated(input: {
-        suggestions: Array<{
-            title: string;
+    /** Reopen a completed/human task back to bot status for further work. */
+    reopenTask(input: {
+        taskId: string;
+        reason?: string;
+    }): Promise<Task>;
+    /** Propose a plan — creates a proposal message with plan metadata. No DB rows until human approves. */
+    proposePlan(input: {
+        tasks: Array<{
+            title?: string;
             instructions?: string;
+            substeps?: string[];
+            file?: {
+                type: 'existing';
+                existingId: string;
+            } | {
+                type: 'new';
+                name: string;
+                description?: string;
+            };
             estimatedTokens?: number;
-            initiativeId?: string;
             scheduledFor?: string;
         }>;
-        parentTaskId?: string;
-        initiativeSuggestions?: Array<{
+        initiative?: string | {
             title: string;
             content: string;
-            taskRefs?: number[];
-        }>;
+        };
+        context?: string;
     }): Promise<{
-        suggestionIds: string[];
-        initiativeSuggestionIds?: string[];
+        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;
@@ -785,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 };