@questionbase/deskfree 0.3.0-alpha.19 → 0.3.0-alpha.20

package/README.md

@@ -21,8 +21,7 @@ Agents can pick up tasks, post progress updates, mark work as done or blocked, m
 │   deskfree_classify_task                                         │
 │   deskfree_learn_from_task                                       │
 │   deskfree_update_deliverable                                    │
-│   deskfree_send_message                                          │
-│   deskfree_suggest_tasks                                         │
+│   deskfree_send_message (+ task suggestions)                     │
 └──────────┬───────────────────────────┬───────────────────────────┘
            │                           │
            ▼                           ▼
@@ -40,7 +39,7 @@ Agents can pick up tasks, post progress updates, mark work as done or blocked, m
 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 (+ 1 suggest tool)
+2. **Tools** — 10 task, activity, and messaging tools the agent can call
 3. **Skill** — workflow knowledge that teaches the agent how to use the tools correctly
 
 ## Install
@@ -119,7 +118,7 @@ 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.
 
 ```
-ready_for_bot ──[start_task]──> working_on_it ──[complete_task(done)]──> waiting_for_human
+bot ──[start_task]──> bot (is_working) ──[complete_task(done)]──> human
                                        │                                        │
                                        └──[complete_task(blocked)]──>           │
                                                                      human approves/declines

package/dist/index.d.ts

@@ -415,20 +415,11 @@ interface WsNotification {
     action: 'notify';
     hint: string;
 }
-interface Activity {
-    id: string;
-    botId: string;
-    name: string;
-    description?: string | null;
-    instructions?: string | null;
-    taskCount: number;
-    createdAt: string;
-    updatedAt: string;
-}
 interface Task {
     taskId: string;
     title: string;
-    status: 'ready_for_bot' | 'working_on_it' | 'waiting_for_human' | 'done';
+    status: 'bot' | 'human' | 'done';
+    isWorking?: boolean;
     instructions?: string;
     createdAt: string;
     updatedAt: string;
@@ -436,6 +427,7 @@ interface Task {
     createdById: string;
     reason?: string | null;
     deliverable?: string | null;
+    deliverableFormat?: 'markdown' | 'html' | null;
 }
 interface TaskMessage {
     messageId: string;
@@ -464,22 +456,37 @@ interface CompleteTaskInput {
 interface WorkspaceStateTask {
     taskId: string;
     title: string;
-    status: 'ready_for_bot' | 'working_on_it' | 'waiting_for_human' | 'done';
+    status: 'bot' | 'human' | 'done';
+    isWorking?: boolean;
     instructions?: string | null;
     deliverable?: string | null;
     createdAt: string;
     updatedAt: string;
 }
-interface WorkspaceStateActivity {
-    id: string;
-    name: string;
-    description?: string | null;
-    instructions?: string | null;
-    taskCount: number;
-}
 interface WorkspaceState {
     tasks: WorkspaceStateTask[];
     recentlyDone: WorkspaceStateTask[];
+    waysOfWorking: string | null;
+    pendingEvaluations: Array<{
+        taskId: string;
+        taskNumber: number;
+        title: string;
+    }>;
+}
+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[];
 }
 
 /** Enhanced error class for DeskFree API errors with user-friendly messages */
@@ -521,13 +528,13 @@ declare class DeskFreeClient {
         content: string;
     }>;
     /**
-     * Send a text message (with optional attachments) to a DeskFree conversation.
+     * Send a text message (with optional attachments or suggestions) to a DeskFree conversation.
      *
-     * @param input - Message content, optional userId, taskId, and attachments
+     * @param input - Message content, optional userId, taskId, attachments, and suggestions
      */
     sendMessage(input: {
         userId?: string;
-        content: string;
+        content?: string;
         taskId?: string;
         attachments?: Array<{
             s3Key: string;
@@ -535,6 +542,10 @@ declare class DeskFreeClient {
             contentType: string;
             size: number;
         }>;
+        suggestions?: Array<{
+            title: string;
+            instructions?: string;
+        }>;
     }): Promise<{
         messageId: string;
         content: string;
@@ -547,41 +558,6 @@ declare class DeskFreeClient {
     }): Promise<MessagesResponse>;
     /** Obtain a one-time WebSocket authentication ticket for real-time notifications. */
     getWsTicket(): Promise<WsTicketResponse>;
-    /** Create a new activity — a knowledge container for a type of work. */
-    createActivity(input: {
-        name: string;
-        description?: string;
-        instructions?: string;
-    }): Promise<{
-        activity: Activity;
-    }>;
-    /** Update an activity's name, description, or instructions. */
-    updateActivity(input: {
-        activityId: string;
-        name?: string;
-        description?: string;
-        instructions?: string;
-    }): Promise<{
-        activity: Activity;
-    }>;
-    /** Find activities relevant to a task. Returns scored matches. */
-    classifyTask(input: {
-        taskTitle: string;
-        taskInstructions?: string;
-    }): Promise<{
-        matches: Array<Activity & {
-            score: number;
-        }>;
-        suggestNew: boolean;
-    }>;
-    /** Link a task to an activity and record learnings. */
-    learnFromTask(input: {
-        taskId: string;
-        activityId: string;
-        additionalInstructions?: string;
-    }): Promise<{
-        activity: Activity;
-    }>;
     /** Create a new task, optionally with a recurring schedule. */
     createTask(input: {
         title: string;
@@ -599,10 +575,11 @@ declare class DeskFreeClient {
     claimTask(input: {
         taskId: string;
     }): Promise<TaskWithContext>;
-    /** Update the deliverable (markdown content) for a task. */
+    /** Update the deliverable (markdown or HTML content) for a task. */
     updateDeliverable(input: {
         taskId: string;
         deliverable: string;
+        format?: 'markdown' | 'html';
     }): Promise<void>;
     /** Send an agent status update to DeskFree. */
     statusUpdate(input: {
@@ -633,23 +610,6 @@ declare class DeskFreeClient {
     }): Promise<{
         accepted: number;
     }>;
-    /** Get short-lived AWS credentials for S3 workspace access. */
-    workspaceCredentials(): Promise<{
-        accessKeyId: string;
-        secretAccessKey: string;
-        sessionToken: string;
-        expiration: Date;
-        s3Uri: string;
-        region: string;
-    }>;
-    /** Notify DeskFree that workspace files have changed locally. */
-    workspaceRead(input: {
-        path: string;
-    }): Promise<{
-        path: string;
-        content: string;
-        lastModified: string;
-    }>;
     /** Get full workspace snapshot — active tasks and recently done. */
     getState(): Promise<WorkspaceState>;
     /** Report token usage for a task. Atomically increments rollup columns. */
@@ -663,11 +623,11 @@ declare class DeskFreeClient {
     }): Promise<{
         success: boolean;
     }>;
-    /** Complete a task with an outcome. Moves task to waiting_for_human. */
+    /** Complete a task with an outcome. Moves task to human. */
     completeTask(input: CompleteTaskInput): Promise<Task & {
         outcome: 'done' | 'blocked';
     }>;
-    /** Suggest new tasks for the human to review and approve. */
+    /** Suggest new tasks for the human to review and approve (via messages.send with suggestions). */
     suggestTasks(input: {
         tasks: Array<{
             title: string;
@@ -675,8 +635,29 @@ declare class DeskFreeClient {
         }>;
         taskId?: string;
     }): Promise<{
-        suggested: number;
-        suggestionIds: string[];
+        messageId: string;
+        content: 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.
+     * If hasChanges is true and updatedContent is provided, inserts a new version.
+     * Clears evaluationPending and isWorking on the task.
+     */
+    submitEvaluation(input: {
+        taskId: string;
+        updatedContent?: string;
+        reasoning: string;
+        hasChanges: boolean;
+    }): Promise<{
+        success: boolean;
+        version?: number;
     }>;
     /**
      * Lightweight health check that verifies connectivity and authentication.
@@ -744,4 +725,4 @@ declare const plugin: {
     register(api: OpenClawPluginApi): void;
 };
 
-export { type Activity, 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 CreateTaskResponse, type DeskFreeChannelConfig, DeskFreeClient, DeskFreeError, type FinalizedMsgContext, 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 TaskWithContext, type WizardPrompter, type WorkspaceState, type WorkspaceStateActivity, 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 ClaimEvaluationResponse, type CompleteTaskInput, type CreateTaskResponse, type DeskFreeChannelConfig, DeskFreeClient, DeskFreeError, type EvaluationTaskMessage, type FinalizedMsgContext, 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 TaskWithContext, type WizardPrompter, type WorkspaceState, type WorkspaceStateTask, type WsNotification, type WsTicketResponse, plugin as default, reportError };