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

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
@@ -132,7 +131,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

@@ -460,6 +460,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;
@@ -566,6 +573,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 +606,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 +615,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,24 +692,35 @@ 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