@aalis/plugin-todo-list 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @aalis/plugin-todo-list
+
+运行时插件
+
+## 角色
+
+运行时插件
+
+## 安装
+
+```bash
+pnpm add @aalis/plugin-todo-list
+```
+
+## 文档
+
+详见 [docs/plugins/plugin-todo-list.md](../../docs/plugins/plugin-todo-list.md)。
+
+## 许可
+
+见仓库根目录 LICENSE。

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { ConfigSchema, Context, PluginModule } from '@aalis/core';
+import '@aalis/plugin-tools-api';
+export declare const name = "@aalis/plugin-todo-list";
+export declare const displayName = "\u4EFB\u52A1\u8BA1\u5212";
+export declare const subsystem = "scheduler";
+export declare const inject: {};
+export declare const configSchema: ConfigSchema;
+export interface TodoItem {
+    id: number;
+    title: string;
+    status: 'not-started' | 'in-progress' | 'completed';
+}
+declare module '@aalis/core' {
+    interface AalisEvents {
+        'todo:updated': [sessionId: string, items: TodoItem[]];
+    }
+}
+export declare const actions: PluginModule['actions'];
+export declare function apply(ctx: Context, config: Record<string, unknown>): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKvE,OAAO,yBAAyB,CAAC;AAKjC,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,WAAW,6BAAS,CAAC;AAClC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,MAAM,IAAK,CAAC;AAEzB,eAAO,MAAM,YAAY,EAAE,YAE1B,CAAC;AAIF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,WAAW,CAAC;CACrD;AAmCD,OAAO,QAAQ,aAAa,CAAC;IAC3B,UAAU,WAAW;QACnB,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;KACxD;CACF;AAID,eAAO,MAAM,OAAO,EAAE,YAAY,CAAC,SAAS,CAkB3C,CAAC;AAIF,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAsHzE"}

package/dist/index.js

@@ -0,0 +1,174 @@
+import { useToolService } from '@aalis/plugin-tools-api';
+import '@aalis/plugin-tools-api';
+// ===== 插件元数据 =====
+export const name = '@aalis/plugin-todo-list';
+export const displayName = '任务计划';
+export const subsystem = 'scheduler';
+export const inject = {};
+export const configSchema = {
+    enabled: { type: 'boolean', label: '启用任务计划工具', default: true },
+};
+/** sessionId → TodoItem[] */
+const store = new Map();
+const TODO_NAMESPACE = 'todo-list';
+const MAX_TODO_ITEMS = 50;
+const MAX_TODO_TITLE_LENGTH = 120;
+/** 将 todo 持久化到 MemoryService */
+async function persistTodos(ctx, sessionId, items) {
+    const memory = ctx.getService('memory');
+    if (memory?.saveMetadata) {
+        await memory.saveMetadata(TODO_NAMESPACE, sessionId, { items });
+    }
+}
+/** 从 MemoryService 加载 todo（优先内存缓存） */
+async function loadTodos(ctx, sessionId) {
+    const cached = store.get(sessionId);
+    if (cached)
+        return cached;
+    const memory = ctx.getService('memory');
+    if (memory?.getMetadata) {
+        const data = await memory.getMetadata(TODO_NAMESPACE, sessionId);
+        if (data?.items && Array.isArray(data.items)) {
+            const items = data.items;
+            store.set(sessionId, items);
+            return items;
+        }
+    }
+    return [];
+}
+// ===== Actions =====
+export const actions = {
+    async getTodos(ctx, args) {
+        const sessionId = args.sessionId;
+        if (!sessionId)
+            return [];
+        return await loadTodos(ctx, sessionId);
+    },
+    async clearTodos(ctx, args) {
+        const sessionId = args.sessionId;
+        if (!sessionId)
+            throw new Error('缺少 sessionId');
+        store.delete(sessionId);
+        const memory = ctx.getService('memory');
+        if (memory?.deleteMetadata) {
+            await memory.deleteMetadata(TODO_NAMESPACE, sessionId);
+        }
+        await ctx.emit('todo:updated', sessionId, []);
+        return { success: true };
+    },
+};
+// ===== 插件入口 =====
+export function apply(ctx, config) {
+    if (config.enabled === false)
+        return;
+    // 注册工具分组
+    useToolService(ctx).registerGroup({
+        name: 'todo',
+        label: '任务计划',
+        description: '创建和管理任务计划列表，拆分复杂任务并追踪进度',
+    });
+    // ---- manage_todo_list ----
+    useToolService(ctx).register({
+        groups: ['todo'],
+        definition: {
+            type: 'function',
+            function: {
+                name: 'manage_todo_list',
+                description: [
+                    '管理当前会话的任务计划列表，用于规划和追踪多步骤任务的执行进度。',
+                    '传入完整的 todoList 数组以创建或更新计划。每次调用需提供所有 todo 项（包括已有项和新增项）。',
+                    '',
+                    '工作流程：',
+                    '1. 收到复杂任务时，规划 todo 列表（所有项 status=not-started）',
+                    '2. 开始某项前，将其标记为 in-progress（同一时间最多一项 in-progress）',
+                    '3. 完成某项后，立即将其标记为 completed',
+                    '4. 继续下一项，重复步骤 2-3',
+                    '',
+                    '你可以随时调整计划：重新排序、修改标题、插入新步骤、删除多余步骤均可。',
+                    '发现更优执行顺序或需要增补步骤时，直接传入更新后的完整数组即可。',
+                    '',
+                    '【子任务协作时必须使用 todo】：',
+                    '当需要创建子任务时，todo 列表应包含：准备工作（如创建共享文档）→ 创建子任务 → 等待子任务完成 → 整合结果/保存文档。',
+                    '这样能确保不会遗忘等待子任务或丢失结果。',
+                    '',
+                    'Todo 状态：',
+                    '- not-started: 尚未开始',
+                    '- in-progress: 正在执行（限一项）',
+                    '- completed: 已完成',
+                ].join('\n'),
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        todoList: {
+                            type: 'array',
+                            description: '完整的任务列表数组，每次调用必须包含所有项',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    id: { type: 'number', description: '唯一 ID，从 1 开始递增' },
+                                    title: { type: 'string', description: '简洁的任务描述（3-10 字）' },
+                                    status: {
+                                        type: 'string',
+                                        enum: ['not-started', 'in-progress', 'completed'],
+                                        description: '任务状态',
+                                    },
+                                },
+                                required: ['id', 'title', 'status'],
+                            },
+                        },
+                    },
+                    required: ['todoList'],
+                    additionalProperties: false,
+                },
+            },
+        },
+        handler: async (args, callCtx) => {
+            const rawList = args.todoList;
+            if (!Array.isArray(rawList)) {
+                return JSON.stringify({ error: 'todoList 必须是数组' });
+            }
+            if (rawList.length > MAX_TODO_ITEMS) {
+                return JSON.stringify({ error: `todoList 最多允许 ${MAX_TODO_ITEMS} 项` });
+            }
+            const longTitleIndex = rawList.findIndex((item) => {
+                const obj = item;
+                return String(obj.title ?? '').length > MAX_TODO_TITLE_LENGTH;
+            });
+            if (longTitleIndex >= 0) {
+                return JSON.stringify({
+                    error: `第 ${longTitleIndex + 1} 项 todo 标题最多允许 ${MAX_TODO_TITLE_LENGTH} 个字符`,
+                });
+            }
+            const items = rawList.map((item) => {
+                const obj = item;
+                const title = String(obj.title ?? '');
+                return {
+                    id: Number(obj.id),
+                    title,
+                    status: ['not-started', 'in-progress', 'completed'].includes(obj.status)
+                        ? obj.status
+                        : 'not-started',
+                };
+            });
+            store.set(callCtx.sessionId, items);
+            await persistTodos(ctx, callCtx.sessionId, items);
+            await ctx.emit('todo:updated', callCtx.sessionId, items);
+            const total = items.length;
+            const completed = items.filter(i => i.status === 'completed').length;
+            const inProgress = items.filter(i => i.status === 'in-progress').length;
+            return JSON.stringify({
+                success: true,
+                summary: `${completed}/${total} 已完成${inProgress > 0 ? `，${inProgress} 项进行中` : ''}`,
+            });
+        },
+    });
+    // 会话删除时清理
+    ctx.on('session:deleted', (sessionId) => {
+        store.delete(sessionId);
+        const memory = ctx.getService('memory');
+        if (memory?.deleteMetadata) {
+            memory.deleteMetadata(TODO_NAMESPACE, sessionId).catch(() => { });
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@aalis/plugin-todo-list",
+  "version": "0.1.0",
+  "type": "module",
+  "keywords": [
+    "aalis-plugin"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aalis/plugin-tools-api": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "@aalis/plugin-webui-api": "0.1.0",
+    "@aalis/core": "0.1.0",
+    "@aalis/plugin-memory-api": "0.1.0",
+    "@aalis/plugin-session-manager-api": "0.1.0"
+  },
+  "peerDependencies": {
+    "@aalis/core": "^0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}