@lobehub/lobehub 2.0.0-next.294 → 2.0.0-next.296

package/packages/builtin-tool-gtd/src/executor/index.ts

@@ -7,14 +7,12 @@ import { useNotebookStore } from '@/store/notebook';
 import { GTDIdentifier } from '../manifest';
 import {
   type ClearTodosParams,
-  type CompleteTodosParams,
   type CreatePlanParams,
   type CreateTodosParams,
   type ExecTaskParams,
   type ExecTasksParams,
   GTDApiName,
   type Plan,
-  type RemoveTodosParams,
   type TodoItem,
   type TodoState,
   type UpdatePlanParams,
@@ -49,12 +47,10 @@ const syncTodosToPlan = async (topicId: string, todos: TodoState): Promise<void>
 // API enum for MVP (Todo + Plan)
 const GTDApiNameEnum = {
   clearTodos: GTDApiName.clearTodos,
-  completeTodos: GTDApiName.completeTodos,
   createPlan: GTDApiName.createPlan,
   createTodos: GTDApiName.createTodos,
   execTask: GTDApiName.execTask,
   execTasks: GTDApiName.execTasks,
-  removeTodos: GTDApiName.removeTodos,
   updatePlan: GTDApiName.updatePlan,
   updateTodos: GTDApiName.updateTodos,
 } as const;
@@ -82,7 +78,7 @@ class GTDExecutor extends BaseExecutor<typeof GTDApiNameEnum> {
     const itemsToAdd: TodoItem[] = params.items
       ? params.items
       : params.adds
-        ? params.adds.map((text) => ({ completed: false, text }))
+        ? params.adds.map((text) => ({ status: 'todo' as const, text }))
         : [];
 
     if (itemsToAdd.length === 0) {
@@ -144,7 +140,7 @@ class GTDExecutor extends BaseExecutor<typeof GTDApiNameEnum> {
       switch (op.type) {
         case 'add': {
           if (op.text) {
-            updatedTodos.push({ completed: false, text: op.text });
+            updatedTodos.push({ status: 'todo', text: op.text });
             results.push(`Added: "${op.text}"`);
           }
           break;
@@ -156,8 +152,9 @@ class GTDExecutor extends BaseExecutor<typeof GTDApiNameEnum> {
             if (op.newText !== undefined) {
               updatedItem.text = op.newText;
             }
-            if (op.completed !== undefined) {
-              updatedItem.completed = op.completed;
+            // Handle status field
+            if (op.status !== undefined) {
+              updatedItem.status = op.status;
             }
             updatedTodos[op.index] = updatedItem;
             results.push(`Updated item ${op.index + 1}`);
@@ -174,11 +171,19 @@ class GTDExecutor extends BaseExecutor<typeof GTDApiNameEnum> {
         case 'complete': {
           if (op.index !== undefined && op.index >= 0 && op.index < updatedTodos.length) {
             // Create a new object to avoid mutating frozen/immutable objects from store
-            updatedTodos[op.index] = { ...updatedTodos[op.index], completed: true };
+            updatedTodos[op.index] = { ...updatedTodos[op.index], status: 'completed' };
             results.push(`Completed: "${updatedTodos[op.index].text}"`);
           }
           break;
         }
+        case 'processing': {
+          if (op.index !== undefined && op.index >= 0 && op.index < updatedTodos.length) {
+            // Create a new object to avoid mutating frozen/immutable objects from store
+            updatedTodos[op.index] = { ...updatedTodos[op.index], status: 'processing' };
+            results.push(`In progress: "${updatedTodos[op.index].text}"`);
+          }
+          break;
+        }
       }
     }
 
@@ -206,154 +211,6 @@ class GTDExecutor extends BaseExecutor<typeof GTDApiNameEnum> {
     };
   };
 
-  /**
-   * Mark todo items as done by their indices
-   */
-  completeTodos = async (
-    params: CompleteTodosParams,
-    ctx: BuiltinToolContext,
-  ): Promise<BuiltinToolResult> => {
-    const { indices } = params;
-
-    if (!indices || indices.length === 0) {
-      return {
-        content: 'No indices provided to complete.',
-        success: false,
-      };
-    }
-
-    const existingTodos = getTodosFromContext(ctx);
-
-    if (existingTodos.length === 0) {
-      const now = new Date().toISOString();
-      return {
-        content: 'No todos to complete. The list is empty.\n\n' + formatTodoStateSummary([], now),
-        state: {
-          completedIndices: [],
-          todos: { items: [], updatedAt: now },
-        },
-        success: true,
-      };
-    }
-
-    // Validate indices
-    const validIndices = indices.filter((i: number) => i >= 0 && i < existingTodos.length);
-    const invalidIndices = indices.filter((i: number) => i < 0 || i >= existingTodos.length);
-
-    if (validIndices.length === 0) {
-      return {
-        content: `Invalid indices: ${indices.join(', ')}. Valid range is 0-${existingTodos.length - 1}.`,
-        success: false,
-      };
-    }
-
-    // Mark items as completed
-    const updatedTodos = existingTodos.map((todo, index) => {
-      if (validIndices.includes(index)) {
-        return { ...todo, completed: true };
-      }
-      return todo;
-    });
-
-    const completedItems = validIndices.map((i: number) => existingTodos[i].text);
-    const now = new Date().toISOString();
-
-    // Format response: action summary + todo state
-    let actionSummary = `✔️ Completed ${validIndices.length} item${validIndices.length > 1 ? 's' : ''}:\n`;
-    actionSummary += completedItems.map((text: string) => `- ${text}`).join('\n');
-
-    if (invalidIndices.length > 0) {
-      actionSummary += `\n\nNote: Ignored invalid indices: ${invalidIndices.join(', ')}`;
-    }
-
-    const todoState = { items: updatedTodos, updatedAt: now };
-
-    // Sync todos to Plan document if topic exists
-    if (ctx.topicId) {
-      await syncTodosToPlan(ctx.topicId, todoState);
-    }
-
-    return {
-      content: actionSummary + '\n\n' + formatTodoStateSummary(updatedTodos, now),
-      state: {
-        completedIndices: validIndices,
-        todos: todoState,
-      },
-      success: true,
-    };
-  };
-
-  /**
-   * Remove todo items by indices
-   */
-  removeTodos = async (
-    params: RemoveTodosParams,
-    ctx: BuiltinToolContext,
-  ): Promise<BuiltinToolResult> => {
-    const { indices } = params;
-
-    if (!indices || indices.length === 0) {
-      return {
-        content: 'No indices provided to remove.',
-        success: false,
-      };
-    }
-
-    const existingTodos = getTodosFromContext(ctx);
-
-    if (existingTodos.length === 0) {
-      const now = new Date().toISOString();
-      return {
-        content: 'No todos to remove. The list is empty.\n\n' + formatTodoStateSummary([], now),
-        state: {
-          removedIndices: [],
-          todos: { items: [], updatedAt: now },
-        },
-        success: true,
-      };
-    }
-
-    // Validate indices
-    const validIndices = indices.filter((i: number) => i >= 0 && i < existingTodos.length);
-    const invalidIndices = indices.filter((i: number) => i < 0 || i >= existingTodos.length);
-
-    if (validIndices.length === 0) {
-      return {
-        content: `Invalid indices: ${indices.join(', ')}. Valid range is 0-${existingTodos.length - 1}.`,
-        success: false,
-      };
-    }
-
-    // Remove items
-    const removedItems = validIndices.map((i: number) => existingTodos[i].text);
-    const updatedTodos = existingTodos.filter((_, index) => !validIndices.includes(index));
-    const now = new Date().toISOString();
-
-    // Format response: action summary + todo state
-    let actionSummary = `🗑️ Removed ${validIndices.length} item${validIndices.length > 1 ? 's' : ''}:\n`;
-    actionSummary += removedItems.map((text: string) => `- ${text}`).join('\n');
-
-    if (invalidIndices.length > 0) {
-      actionSummary += `\n\nNote: Ignored invalid indices: ${invalidIndices.join(', ')}`;
-    }
-
-    const todoState = { items: updatedTodos, updatedAt: now };
-
-    // Sync todos to Plan document if topic exists
-    if (ctx.topicId) {
-      await syncTodosToPlan(ctx.topicId, todoState);
-    }
-
-    return {
-      content: actionSummary + '\n\n' + formatTodoStateSummary(updatedTodos, now),
-      state: {
-        removedIndices: validIndices,
-        todos: todoState,
-      },
-      success: true,
-    };
-  };
-
   /**
    * Clear todo items
    */
@@ -388,7 +245,7 @@ class GTDExecutor extends BaseExecutor<typeof GTDApiNameEnum> {
       actionSummary = `🧹 Cleared all ${clearedCount} item${clearedCount > 1 ? 's' : ''} from todo list.`;
     } else {
       // mode === 'completed'
-      updatedTodos = existingTodos.filter((todo) => !todo.completed);
+      updatedTodos = existingTodos.filter((todo) => todo.status !== 'completed');
       clearedCount = existingTodos.length - updatedTodos.length;
 
       if (clearedCount === 0) {

package/packages/builtin-tool-gtd/src/manifest.ts

@@ -84,22 +84,23 @@ export const GTDManifest: BuiltinToolManifest = {
     {
       description: `Update todo items with batch operations. Each operation type requires specific fields:
 - "add": requires "text" (the todo text to add)
-- "update": requires "index", optional "newText" and/or "completed"
+- "update": requires "index", optional "newText" and/or "status"
 - "remove": requires "index" only
-- "complete": requires "index" only (marks item as completed)`,
+- "complete": requires "index" only (marks item as completed)
+- "processing": requires "index" only (marks item as in progress)`,
       name: GTDApiName.updateTodos,
       renderDisplayControl: 'expand',
       parameters: {
         properties: {
           operations: {
             description:
-              'Array of update operations. IMPORTANT: For "complete" and "remove" operations, only pass "type" and "index" - no other fields needed.',
+              'Array of update operations. IMPORTANT: For "complete", "processing" and "remove" operations, only pass "type" and "index" - no other fields needed.',
             items: {
               properties: {
                 type: {
                   description:
-                    'Operation type. "add" needs text, "update" needs index + optional newText/completed, "remove" and "complete" need index only.',
-                  enum: ['add', 'update', 'remove', 'complete'],
+                    'Operation type. "add" needs text, "update" needs index + optional newText/status, "remove", "complete" and "processing" need index only.',
+                  enum: ['add', 'update', 'remove', 'complete', 'processing'],
                   type: 'string',
                 },
                 text: {
@@ -108,16 +109,18 @@ export const GTDManifest: BuiltinToolManifest = {
                 },
                 index: {
                   description:
-                    'Required for "update", "remove", "complete": the item index (0-based).',
+                    'Required for "update", "remove", "complete", "processing": the item index (0-based).',
                   type: 'number',
                 },
                 newText: {
                   description: 'Optional for "update" only: the new text.',
                   type: 'string',
                 },
-                completed: {
-                  description: 'Optional for "update" only: set completed status.',
-                  type: 'boolean',
+                status: {
+                  description:
+                    'Optional for "update" only: set status (todo, processing, completed).',
+                  enum: ['todo', 'processing', 'completed'],
+                  type: 'string',
                 },
               },
               required: ['type'],
@@ -130,39 +133,6 @@ export const GTDManifest: BuiltinToolManifest = {
         type: 'object',
       },
     },
-    {
-      description: 'Mark todo items as completed by their indices (0-based).',
-      name: GTDApiName.completeTodos,
-      renderDisplayControl: 'expand',
-      parameters: {
-        properties: {
-          indices: {
-            description: 'Array of item indices (0-based) to mark as completed.',
-            items: { type: 'number' },
-            type: 'array',
-          },
-        },
-        required: ['indices'],
-        type: 'object',
-      },
-    },
-    {
-      description: 'Remove todo items by their indices (0-based).',
-      name: GTDApiName.removeTodos,
-      humanIntervention: 'always',
-      renderDisplayControl: 'expand',
-      parameters: {
-        properties: {
-          indices: {
-            description: 'Array of item indices (0-based) to remove.',
-            items: { type: 'number' },
-            type: 'array',
-          },
-        },
-        required: ['indices'],
-        type: 'object',
-      },
-    },
     {
       description: 'Clear todo items. Can clear only completed items or all items.',
       name: GTDApiName.clearTodos,

package/packages/builtin-tool-gtd/src/systemRole.ts

@@ -11,11 +11,11 @@ export const systemPrompt = `You have GTD (Getting Things Done) tools to help ma
 
 **Todo Tools** - For actionable execution items:
 - \`createTodos\`: Create new todo items from text array
-- \`updateTodos\`: Batch update todos (add, update, remove, complete operations)
-- \`completeTodos\`: Mark items as done by indices
-- \`removeTodos\`: Remove items by indices
+- \`updateTodos\`: Batch update todos (add, update, remove, complete, processing operations)
 - \`clearTodos\`: Clear completed or all items
 
+**Todo Status Workflow:** todo → processing → completed (use "processing" when actively working on an item)
+
 **Async Task Tools** - For long-running background tasks:
 - \`execTask\`: Execute a single async task in isolated context
 - \`execTasks\`: Execute multiple async tasks in parallel
@@ -98,23 +98,29 @@ Use \`execTask\` for a single task, \`execTasks\` for multiple parallel tasks.
 <updateTodos_usage>
 When using \`updateTodos\`, each operation type requires specific fields:
 
+**Todo Status:**
+- \`todo\`: Not started yet
+- \`processing\`: Currently in progress
+- \`completed\`: Done
+
 **Minimal required fields per operation type:**
 - \`{ "type": "add", "text": "todo text" }\` - only type + text
-- \`{ "type": "complete", "index": 0 }\` - only type + index
+- \`{ "type": "complete", "index": 0 }\` - only type + index (marks as completed)
+- \`{ "type": "processing", "index": 0 }\` - only type + index (marks as in progress)
 - \`{ "type": "remove", "index": 0 }\` - only type + index
-- \`{ "type": "update", "index": 0, "newText": "..." }\` - type + index + optional newText/completed
+- \`{ "type": "update", "index": 0, "newText": "..." }\` - type + index + optional newText/status
 
-**Example - mark items 0 and 1 as complete:**
+**Example - mark item 0 as processing, item 1 as complete:**
 \`\`\`json
 {
   "operations": [
-    { "type": "complete", "index": 0 },
+    { "type": "processing", "index": 0 },
     { "type": "complete", "index": 1 }
   ]
 }
 \`\`\`
 
-**DO NOT** add extra fields like \`"completed": true\` for complete operations - they are ignored.
+**DO NOT** add extra fields like \`"status": "completed"\` for complete/processing operations - they are ignored.
 </updateTodos_usage>
 
 <todo_granularity>

package/packages/builtin-tool-gtd/src/types.ts

@@ -14,44 +14,66 @@ export const GTDApiName = {
   /** Clear completed or all todos */
   clearTodos: 'clearTodos',
 
-  /** Mark todo items as done by indices */
-  completeTodos: 'completeTodos',
-
+  
   // ==================== Planning ====================
-  /** Create a structured plan by breaking down a goal into actionable steps */
-  createPlan: 'createPlan',
+/** Create a structured plan by breaking down a goal into actionable steps */
+createPlan: 'createPlan',
+
+  
+  
+
+/** Create new todo items */
+createTodos: 'createTodos',
+
+  
+  
+  
+// ==================== Async Tasks ====================
+/** Execute a single async task */
+execTask: 'execTask',
+
+  
+  
 
-  /** Create new todo items */
-  createTodos: 'createTodos',
 
-  // ==================== Async Tasks ====================
-  /** Execute a single async task */
-  execTask: 'execTask',
+/** Execute one or more async tasks */
+execTasks: 'execTasks',
 
-  /** Execute one or more async tasks */
-  execTasks: 'execTasks',
+  
+  
+  
 
-  /** Remove todo items by indices */
-  removeTodos: 'removeTodos',
 
-  /** Update an existing plan */
-  updatePlan: 'updatePlan',
+/** Update an existing plan */
+updatePlan: 'updatePlan',
 
-  /** Update todo items with batch operations (add, update, remove, complete) */
-  updateTodos: 'updateTodos',
+  
+  
+/** Update todo items with batch operations (add, update, remove, complete, processing) */
+updateTodos: 'updateTodos',
 } as const;
 
 export type GTDApiNameType = (typeof GTDApiName)[keyof typeof GTDApiName];
 
 // ==================== Todo Item ====================
 
+/** Status of a todo item */
+export type TodoStatus = 'todo' | 'processing' | 'completed';
+
 export interface TodoItem {
-  /** Whether the item is completed */
-  completed: boolean;
+  /** Status of the todo item */
+  status: TodoStatus;
   /** The todo item text */
   text: string;
 }
 
+/** Get the next status in the cycle: todo → processing → completed → todo */
+export const getNextTodoStatus = (current: TodoStatus): TodoStatus => {
+  const cycle: TodoStatus[] = ['todo', 'processing', 'completed'];
+  const index = cycle.indexOf(current);
+  return cycle[(index + 1) % cycle.length];
+};
+
 export interface TodoList {
   items: TodoItem[];
   updatedAt: string;
@@ -77,18 +99,18 @@ export interface CreateTodosParams {
 /**
  * Update operation types for batch updates
  */
-export type TodoUpdateOperationType = 'add' | 'update' | 'remove' | 'complete';
+export type TodoUpdateOperationType = 'add' | 'update' | 'remove' | 'complete' | 'processing';
 
 /**
  * Single update operation
  */
 export interface TodoUpdateOperation {
-  /** For 'update': the new completed status */
-  completed?: boolean;
-  /** For 'update', 'remove', 'complete': the index of the item (0-based) */
+  /** For 'update', 'remove', 'complete', 'processing': the index of the item (0-based) */
   index?: number;
   /** For 'update': the new text */
   newText?: string;
+  /** For 'update': the new status */
+  status?: TodoStatus;
   /** For 'add': the text to add */
   text?: string;
   /** Operation type */
@@ -97,29 +119,13 @@ export interface TodoUpdateOperation {
 
 /**
  * Update todo list with batch operations
- * Supports: add, update, remove, complete
+ * Supports: add, update, remove, complete, processing
  */
 export interface UpdateTodosParams {
   /** Array of update operations to apply */
   operations: TodoUpdateOperation[];
 }
 
-/**
- * Mark todo items as completed by indices
- */
-export interface CompleteTodosParams {
-  /** Indices of items to mark as completed (0-based) */
-  indices: number[];
-}
-
-/**
- * Remove todo items by indices
- */
-export interface RemoveTodosParams {
-  /** Indices of items to remove (0-based) */
-  indices: number[];
-}
-
 /**
  * Clear todo items
  */

package/packages/builtin-tool-memory/package.json

@@ -4,6 +4,7 @@
   "private": true,
   "exports": {
     ".": "./src/index.ts",
+    "./client": "./src/client/index.ts",
     "./executor": "./src/executor/index.ts"
   },
   "main": "./src/index.ts",
@@ -13,5 +14,12 @@
   },
   "devDependencies": {
     "@lobechat/types": "workspace:*"
+  },
+  "peerDependencies": {
+    "@lobehub/ui": "^4",
+    "antd-style": "*",
+    "lucide-react": "*",
+    "react": "*",
+    "react-i18next": "*"
   }
 }

package/packages/builtin-tool-memory/src/client/Inspector/AddContextMemory/index.tsx

@@ -0,0 +1,60 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { createStaticStyles, cssVar, cx } from 'antd-style';
+import { Check } from 'lucide-react';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { AddContextMemoryParams, AddContextMemoryState } from '../../../types';
+
+const styles = createStaticStyles(({ css }) => ({
+  statusIcon: css`
+    margin-block-end: -2px;
+    margin-inline-start: 4px;
+  `,
+}));
+
+export const AddContextMemoryInspector = memo<
+  BuiltinInspectorProps<AddContextMemoryParams, AddContextMemoryState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading, pluginState }) => {
+  const { t } = useTranslation('plugin');
+
+  const title = args?.title || partialArgs?.title;
+
+  // Initial streaming state
+  if (isArgumentsStreaming && !title) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-user-memory.apiName.addContextMemory')}</span>
+      </div>
+    );
+  }
+
+  const isSuccess = pluginState?.memoryId;
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-user-memory.apiName.addContextMemory')}</span>
+      {title && (
+        <>
+          : <span className={highlightTextStyles.primary}>{title}</span>
+        </>
+      )}
+      {!isLoading && isSuccess && (
+        <Check className={styles.statusIcon} color={cssVar.colorSuccess} size={14} />
+      )}
+    </div>
+  );
+});
+
+AddContextMemoryInspector.displayName = 'AddContextMemoryInspector';
+
+export default AddContextMemoryInspector;

package/packages/builtin-tool-memory/src/client/Inspector/AddExperienceMemory/index.tsx

@@ -0,0 +1,60 @@
+'use client';
+
+import type { BuiltinInspectorProps } from '@lobechat/types';
+import { createStaticStyles, cssVar, cx } from 'antd-style';
+import { Check } from 'lucide-react';
+import { memo } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+
+import type { AddExperienceMemoryParams, AddExperienceMemoryState } from '../../../types';
+
+const styles = createStaticStyles(({ css }) => ({
+  statusIcon: css`
+    margin-block-end: -2px;
+    margin-inline-start: 4px;
+  `,
+}));
+
+export const AddExperienceMemoryInspector = memo<
+  BuiltinInspectorProps<AddExperienceMemoryParams, AddExperienceMemoryState>
+>(({ args, partialArgs, isArgumentsStreaming, isLoading, pluginState }) => {
+  const { t } = useTranslation('plugin');
+
+  const title = args?.title || partialArgs?.title;
+
+  // Initial streaming state
+  if (isArgumentsStreaming && !title) {
+    return (
+      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+        <span>{t('builtins.lobe-user-memory.apiName.addExperienceMemory')}</span>
+      </div>
+    );
+  }
+
+  const isSuccess = pluginState?.memoryId;
+
+  return (
+    <div
+      className={cx(
+        inspectorTextStyles.root,
+        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
+      )}
+    >
+      <span>{t('builtins.lobe-user-memory.apiName.addExperienceMemory')}</span>
+      {title && (
+        <>
+          : <span className={highlightTextStyles.primary}>{title}</span>
+        </>
+      )}
+      {!isLoading && isSuccess && (
+        <Check className={styles.statusIcon} color={cssVar.colorSuccess} size={14} />
+      )}
+    </div>
+  );
+});
+
+AddExperienceMemoryInspector.displayName = 'AddExperienceMemoryInspector';
+
+export default AddExperienceMemoryInspector;