axon-code 2.4.0

package/dist/tools/todo.js

@@ -0,0 +1,204 @@
+/**
+ * Todo 工具
+ * 任务管理
+ */
+import { BaseTool } from './base.js';
+import { t } from '../i18n/index.js';
+// 官方常量：自动提醒配置
+const TODO_REMINDER_CONFIG = {
+    TURNS_SINCE_WRITE: 7, // 自上次使用 TodoWrite 以来的回合数
+    TURNS_BETWEEN_REMINDERS: 3, // 提醒之间的最少回合数
+};
+// 全局 Todo 存储（按 agentId 分组）
+const todosStorage = {};
+// 默认 agentId（当前项目没有 multi-agent 系统）
+const DEFAULT_AGENT_ID = 'main';
+/**
+ * 获取指定 agentId 的 todos
+ */
+export function getTodos(agentId = DEFAULT_AGENT_ID) {
+    return [...(todosStorage[agentId] || [])];
+}
+/**
+ * 设置指定 agentId 的 todos
+ */
+export function setTodos(todos, agentId = DEFAULT_AGENT_ID) {
+    todosStorage[agentId] = [...todos];
+}
+/**
+ * 计算自上次使用 TodoWrite 以来的回合数（官方 ax5 函数）
+ * @param messages 消息历史
+ * @returns 回合数统计
+ */
+function calculateTurnsSinceTodoWrite(messages) {
+    let lastTodoWriteIndex = -1;
+    let lastReminderIndex = -1;
+    let turnsSinceLastTodoWrite = 0;
+    let turnsSinceLastReminder = 0;
+    // 从最新消息向前遍历
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        // 计数助手回合
+        if (msg?.type === 'assistant') {
+            // 跳过被中断的消息
+            if (msg.interrupted)
+                continue;
+            if (lastTodoWriteIndex === -1) {
+                turnsSinceLastTodoWrite++;
+            }
+            if (lastReminderIndex === -1) {
+                turnsSinceLastReminder++;
+            }
+            // 查找 TodoWrite 工具使用
+            if (lastTodoWriteIndex === -1 &&
+                'message' in msg &&
+                Array.isArray(msg.message?.content)) {
+                const hasTodoWrite = msg.message.content.some((block) => block.type === 'tool_use' && block.name === 'TodoWrite');
+                if (hasTodoWrite) {
+                    lastTodoWriteIndex = i;
+                }
+            }
+        }
+        // 查找提醒附件
+        else if (lastReminderIndex === -1 &&
+            msg?.type === 'attachment' &&
+            msg.attachment?.type === 'todo_reminder') {
+            lastReminderIndex = i;
+        }
+        // 如果两个都找到了，可以提前退出
+        if (lastTodoWriteIndex !== -1 && lastReminderIndex !== -1) {
+            break;
+        }
+    }
+    return {
+        turnsSinceLastTodoWrite,
+        turnsSinceLastReminder,
+    };
+}
+/**
+ * 生成 todo 提醒附件（官方 ox5 函数）
+ * @param messages 消息历史
+ * @param agentId Agent ID
+ * @returns 提醒附件数组
+ */
+export function generateTodoReminder(messages, agentId = DEFAULT_AGENT_ID) {
+    if (!messages || messages.length === 0) {
+        return [];
+    }
+    const { turnsSinceLastTodoWrite, turnsSinceLastReminder } = calculateTurnsSinceTodoWrite(messages);
+    // 检查是否需要提醒
+    if (turnsSinceLastTodoWrite >= TODO_REMINDER_CONFIG.TURNS_SINCE_WRITE &&
+        turnsSinceLastReminder >= TODO_REMINDER_CONFIG.TURNS_BETWEEN_REMINDERS) {
+        const currentTodos = getTodos(agentId);
+        // 生成提醒消息
+        let reminderMessage = `The TodoWrite tool hasn't been used recently. If you're working on tasks that would benefit from tracking progress, consider using the TodoWrite tool to track progress. Also consider cleaning up the todo list if has become stale and no longer matches what you are working on. Only use it if it's relevant to the current work. This is just a gentle reminder - ignore if not applicable. Make sure that you NEVER mention this reminder to the user`;
+        // 如果有现有的 todos，添加到提醒中
+        if (currentTodos.length > 0) {
+            const todoList = currentTodos
+                .map((todo, idx) => `${idx + 1}. [${todo.status}] ${todo.content}`)
+                .join('\n');
+            reminderMessage += `\n\nHere are the existing contents of your todo list:\n\n[${todoList}]`;
+        }
+        return [
+            {
+                type: 'todo_reminder',
+                content: currentTodos,
+                itemCount: currentTodos.length,
+            },
+        ];
+    }
+    return [];
+}
+export class TodoWriteTool extends BaseTool {
+    name = 'TodoWrite';
+    shouldDefer = true;
+    searchHint = 'todo list, track progress, task checklist, show steps, mark done';
+    description = `Create and manage a structured task list for your current coding session. Helps track progress and give the user visibility into your work.
+
+## When to Use
+- Complex multi-step tasks (3+ distinct steps)
+- User provides multiple tasks (numbered or comma-separated)
+- User explicitly requests a todo list
+- Non-trivial tasks requiring planning
+
+## When NOT to Use
+- Single, straightforward task
+- Trivial task completable in <3 steps
+- Purely conversational or informational request
+
+## Task States
+- pending: Not yet started
+- in_progress: Currently working on (limit to ONE at a time)
+- completed: Finished successfully
+
+## Rules
+- Each task needs both content (imperative: "Run tests") and activeForm (continuous: "Running tests")
+- Mark tasks complete IMMEDIATELY after finishing (don't batch)
+- Only ONE task can be in_progress at any time
+- ONLY mark completed when FULLY accomplished (not if tests failing, partial implementation, or unresolved errors)
+- When all tasks are completed, the list auto-clears
+- Remove tasks that are no longer relevant
+`;
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                todos: {
+                    type: 'array',
+                    description: 'The updated todo list',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            content: {
+                                type: 'string',
+                                minLength: 1,
+                                description: 'Task description',
+                            },
+                            status: {
+                                type: 'string',
+                                enum: ['pending', 'in_progress', 'completed'],
+                                description: 'Task status',
+                            },
+                            activeForm: {
+                                type: 'string',
+                                minLength: 1,
+                                description: 'Present continuous form (e.g., "Running tests")',
+                            },
+                        },
+                        required: ['content', 'status', 'activeForm'],
+                    },
+                },
+            },
+            required: ['todos'],
+        };
+    }
+    async execute(input, context) {
+        const { todos } = input;
+        // 获取 agentId（如果有的话）
+        const agentId = context?.agentId || DEFAULT_AGENT_ID;
+        // 验证任务：只能有一个 in_progress
+        const inProgress = todos.filter((t) => t.status === 'in_progress');
+        if (inProgress.length > 1) {
+            return {
+                success: false,
+                error: t('todo.onlyOneInProgress'),
+            };
+        }
+        // 获取旧的 todos
+        const oldTodos = getTodos(agentId);
+        // 官方逻辑：如果全部完成，自动清空 todos
+        const newTodos = todos.every((t) => t.status === 'completed') ? [] : todos;
+        // 保存 todos（按 agentId 分组）
+        setTodos(newTodos, agentId);
+        // 返回官方格式：{ data: { oldTodos, newTodos } }
+        return {
+            success: true,
+            output: 'Todos have been modified successfully. Ensure that you continue to use the todo list to track your progress. Please proceed with the current tasks if applicable',
+            data: {
+                oldTodos,
+                newTodos: todos, // 注意：这里返回原始输入的 todos，而不是 newTodos
+            },
+        };
+    }
+}
+//# sourceMappingURL=todo.js.map

package/dist/tools/todo.js.map

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

package/dist/tools/trigger-e2e-test.d.ts

@@ -0,0 +1,62 @@
+/**
+ * TriggerE2ETest 工具 - LeadAgent 专用
+ *
+ * 设计理念：
+ * - LeadAgent 在所有任务完成并通过集成检查后，调用此工具触发 E2E 端到端测试
+ * - E2E Agent 独立执行浏览器测试，使用 Chrome MCP 工具
+ * - 测试结果同步返回给 LeadAgent，LeadAgent 可以根据结果决定是否修复
+ * - 形成 LeadAgent ↔ E2E Agent 的双向通信闭环
+ *
+ * 流程：
+ * LeadAgent 调用 TriggerE2ETest → 创建 E2ETestAgent → 等待执行完成 → 返回结果给 LeadAgent
+ * LeadAgent 审查结果 → 如果有问题，自己修复或派 Worker 修复 → 再次调用 TriggerE2ETest
+ */
+import { BaseTool } from './base.js';
+import type { ToolResult, ToolDefinition } from '../types/index.js';
+import type { Blueprint, TechStack } from '../blueprint/types.js';
+interface E2EToolContext {
+    blueprint: Blueprint;
+    projectPath: string;
+    techStack: TechStack;
+    /** 事件回调：转发 E2E Agent 的流式事件给前端 */
+    onEvent: (event: {
+        type: string;
+        data: Record<string, unknown>;
+    }) => void;
+    /** 完成回调：通知 LeadAgent 执行完成（用于 Planner 通知） */
+    onComplete?: (result: {
+        success: boolean;
+        summary: string;
+    }) => void;
+}
+interface TriggerE2ETestInput {
+    /** 应用 URL（默认 http://localhost:3000） */
+    appUrl?: string;
+    /** 设计图对比相似度阈值 (0-100)，默认 80 */
+    similarityThreshold?: number;
+    /** 使用的模型（默认 opus） */
+    model?: string;
+    /** 最大测试时间（毫秒），默认 30 分钟 */
+    maxTestDuration?: number;
+}
+/**
+ * TriggerE2ETest 工具
+ * LeadAgent 专用，用于触发 E2E 端到端测试并同步等待结果
+ */
+export declare class TriggerE2ETestTool extends BaseTool<TriggerE2ETestInput, ToolResult> {
+    name: string;
+    description: string;
+    private static context;
+    /**
+     * 设置上下文（由 LeadAgent 在启动前调用）
+     */
+    static setContext(ctx: E2EToolContext): void;
+    /**
+     * 清理上下文
+     */
+    static clearContext(): void;
+    getInputSchema(): ToolDefinition['inputSchema'];
+    execute(input: TriggerE2ETestInput): Promise<ToolResult>;
+}
+export {};
+//# sourceMappingURL=trigger-e2e-test.d.ts.map

package/dist/tools/trigger-e2e-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-e2e-test.d.ts","sourceRoot":"","sources":["../../src/tools/trigger-e2e-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQlE,UAAU,cAAc;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,iCAAiC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1E,4CAA4C;IAC5C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACtE;AAED,UAAU,mBAAmB;IAC3B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,mBAAmB,EAAE,UAAU,CAAC;IAC/E,IAAI,SAAoB;IACxB,WAAW,SAsBqE;IAGhF,OAAO,CAAC,MAAM,CAAC,OAAO,CAA+B;IAErD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAI5C;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,IAAI;IAI3B,cAAc,IAAI,cAAc,CAAC,aAAa,CAAC;IA0BzC,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;CAgK/D"}

package/dist/tools/trigger-e2e-test.js

@@ -0,0 +1,228 @@
+/**
+ * TriggerE2ETest 工具 - LeadAgent 专用
+ *
+ * 设计理念：
+ * - LeadAgent 在所有任务完成并通过集成检查后，调用此工具触发 E2E 端到端测试
+ * - E2E Agent 独立执行浏览器测试，使用 Chrome MCP 工具
+ * - 测试结果同步返回给 LeadAgent，LeadAgent 可以根据结果决定是否修复
+ * - 形成 LeadAgent ↔ E2E Agent 的双向通信闭环
+ *
+ * 流程：
+ * LeadAgent 调用 TriggerE2ETest → 创建 E2ETestAgent → 等待执行完成 → 返回结果给 LeadAgent
+ * LeadAgent 审查结果 → 如果有问题，自己修复或派 Worker 修复 → 再次调用 TriggerE2ETest
+ */
+import { BaseTool } from './base.js';
+import { t } from '../i18n/index.js';
+// v4.9: 共享 E2E Agent 注册表，支持用户插嘴
+import { registerE2EAgent as registerAgent, unregisterE2EAgent as unregisterAgent } from '../blueprint/e2e-agent-registry.js';
+/**
+ * TriggerE2ETest 工具
+ * LeadAgent 专用，用于触发 E2E 端到端测试并同步等待结果
+ */
+export class TriggerE2ETestTool extends BaseTool {
+    name = 'TriggerE2ETest';
+    description = `Trigger E2E end-to-end testing (LeadAgent exclusive)
+
+## When to Use
+After all development tasks are completed and pass integration checks (build, unit tests), call this tool to start E2E browser testing.
+
+## Test Content
+E2E Agent will automatically:
+1. Start the application service
+2. Open browser, validate according to blueprint-defined business flows
+3. Compare design mockups with actual pages
+4. Attempt automatic fixes when issues found (up to 3 rounds)
+5. Submit test report
+
+## Return Value
+Complete E2E test results, including:
+- Passed/failed test steps
+- Design comparison results
+- Fix attempt records
+- Test summary
+
+## Next Steps
+- If tests pass -> task complete
+- If tests fail -> fix code based on report, then call this tool again to verify`;
+    // 静态上下文
+    static context = null;
+    /**
+     * 设置上下文（由 LeadAgent 在启动前调用）
+     */
+    static setContext(ctx) {
+        TriggerE2ETestTool.context = ctx;
+    }
+    /**
+     * 清理上下文
+     */
+    static clearContext() {
+        TriggerE2ETestTool.context = null;
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                appUrl: {
+                    type: 'string',
+                    description: 'Application URL (default http://localhost:3000)',
+                },
+                similarityThreshold: {
+                    type: 'number',
+                    description: 'Design comparison similarity threshold (0-100), default 80',
+                },
+                model: {
+                    type: 'string',
+                    enum: ['haiku', 'sonnet', 'opus'],
+                    description: 'Model used by E2E Agent (default opus)',
+                },
+                maxTestDuration: {
+                    type: 'number',
+                    description: 'Maximum test duration (milliseconds), default 1800000 (30 minutes)',
+                },
+            },
+            required: [],
+        };
+    }
+    async execute(input) {
+        const ctx = TriggerE2ETestTool.context;
+        if (!ctx) {
+            return {
+                success: false,
+                output: t('triggerE2E.noContext'),
+            };
+        }
+        const e2eTaskId = `e2e-test-${Date.now()}`;
+        const e2eWorkerId = 'e2e-worker';
+        // 通知前端 E2E 测试开始
+        ctx.onEvent({
+            type: 'e2e:started',
+            data: {
+                blueprintId: ctx.blueprint.id,
+                e2eTaskId,
+                status: 'running',
+                message: t('triggerE2E.starting'),
+            },
+        });
+        try {
+            // 动态导入 E2E Agent（避免循环依赖）
+            const { createE2ETestAgent } = await import('../blueprint/e2e-test-agent.js');
+            const agent = createE2ETestAgent({
+                model: (input.model || 'opus'),
+                similarityThreshold: input.similarityThreshold || 80,
+                maxTestDuration: input.maxTestDuration || 1800000,
+            });
+            // v4.9: 注册 E2E Agent 到共享注册表，支持用户插嘴
+            registerAgent(ctx.blueprint.id, agent);
+            // 转发 E2E Agent 的流式事件给前端
+            agent.on('log', (msg) => {
+                console.log(`[E2E via LeadAgent] ${msg}`);
+            });
+            agent.on('stream:text', (data) => {
+                ctx.onEvent({
+                    type: 'worker:stream',
+                    data: {
+                        workerId: e2eWorkerId,
+                        taskId: e2eTaskId,
+                        streamType: 'text',
+                        content: data.content,
+                    },
+                });
+            });
+            agent.on('stream:tool_start', (data) => {
+                ctx.onEvent({
+                    type: 'worker:stream',
+                    data: {
+                        workerId: e2eWorkerId,
+                        taskId: e2eTaskId,
+                        streamType: 'tool_start',
+                        toolName: data.toolName,
+                        toolInput: data.toolInput,
+                    },
+                });
+            });
+            agent.on('stream:tool_end', (data) => {
+                ctx.onEvent({
+                    type: 'worker:stream',
+                    data: {
+                        workerId: e2eWorkerId,
+                        taskId: e2eTaskId,
+                        streamType: 'tool_end',
+                        toolName: data.toolName,
+                        toolInput: data.toolInput,
+                        toolResult: data.toolResult,
+                        toolError: data.toolError,
+                    },
+                });
+            });
+            agent.on('stream:system_prompt', (data) => {
+                ctx.onEvent({
+                    type: 'worker:stream',
+                    data: {
+                        workerId: e2eWorkerId,
+                        taskId: e2eTaskId,
+                        streamType: 'system_prompt',
+                        systemPrompt: data.systemPrompt,
+                        agentType: 'e2e',
+                    },
+                });
+            });
+            // 构建 E2E 测试上下文
+            const e2eContext = {
+                blueprint: ctx.blueprint,
+                projectPath: ctx.projectPath,
+                techStack: ctx.techStack,
+                designImages: ctx.blueprint.designImages || [],
+                appUrl: input.appUrl || 'http://localhost:3000',
+            };
+            // 同步等待 E2E Agent 执行完成
+            const result = await agent.execute(e2eContext);
+            // v4.9: 执行完成后注销 E2E Agent
+            unregisterAgent(ctx.blueprint.id);
+            // 通知前端 E2E 测试完成
+            ctx.onEvent({
+                type: 'e2e:completed',
+                data: {
+                    blueprintId: ctx.blueprint.id,
+                    e2eTaskId,
+                    status: result.success ? 'passed' : 'failed',
+                    result: {
+                        totalTests: result.passedSteps + result.failedSteps + result.skippedSteps,
+                        passedTests: result.passedSteps,
+                        failedTests: result.failedSteps,
+                        skippedTests: result.skippedSteps,
+                    },
+                },
+            });
+            // 通知完成回调（用于 Planner 通知）
+            ctx.onComplete?.({
+                success: result.success,
+                summary: result.summary,
+            });
+            // v10.1: 完全对齐 TaskTool — 直接返回 E2E Agent 的 raw text
+            // 与 CLI TaskTool 一致：上级 agent 拿到下级的原始文本输出
+            const rawResponse = result.rawResponse || '';
+            const output = rawResponse || t('triggerE2E.noOutput', { success: String(result.success) });
+            return { success: result.success, output };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            // v4.9: 异常时也注销 E2E Agent
+            unregisterAgent(ctx.blueprint.id);
+            // 通知前端 E2E 测试失败
+            ctx.onEvent({
+                type: 'e2e:completed',
+                data: {
+                    blueprintId: ctx.blueprint.id,
+                    e2eTaskId,
+                    status: 'failed',
+                    error: errorMsg,
+                },
+            });
+            return {
+                success: false,
+                output: t('triggerE2E.startFailed', { error: errorMsg }),
+            };
+        }
+    }
+}
+//# sourceMappingURL=trigger-e2e-test.js.map

package/dist/tools/trigger-e2e-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-e2e-test.js","sourceRoot":"","sources":["../../src/tools/trigger-e2e-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AAErC,gCAAgC;AAChC,OAAO,EAAE,gBAAgB,IAAI,aAAa,EAAE,kBAAkB,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AA2B9H;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,QAAyC;IAC/E,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;iFAsBiE,CAAC;IAEhF,QAAQ;IACA,MAAM,CAAC,OAAO,GAA0B,IAAI,CAAC;IAErD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAmB;QACnC,kBAAkB,CAAC,OAAO,GAAG,GAAG,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY;QACjB,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;IACpC,CAAC;IAED,cAAc;QACZ,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iDAAiD;iBAC/D;gBACD,mBAAmB,EAAE;oBACnB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;oBACjC,WAAW,EAAE,wCAAwC;iBACtD;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oEAAoE;iBAClF;aACF;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA0B;QACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,sBAAsB,CAAC;aAClC,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,YAAY,CAAC;QAEjC,gBAAgB;QAChB,GAAG,CAAC,OAAO,CAAC;YACV,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE;gBACJ,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE;gBAC7B,SAAS;gBACT,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,CAAC,CAAC,qBAAqB,CAAC;aAClC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,yBAAyB;YACzB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;YAE9E,MAAM,KAAK,GAAG,kBAAkB,CAAC;gBAC/B,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,MAAM,CAAQ;gBACrC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,EAAE;gBACpD,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,OAAO;aAClD,CAAC,CAAC;YAEH,mCAAmC;YACnC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAEvC,wBAAwB;YACxB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE;gBAC9B,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAyB,EAAE,EAAE;gBACpD,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,eAAe;oBACrB,IAAI,EAAE;wBACJ,QAAQ,EAAE,WAAW;wBACrB,MAAM,EAAE,SAAS;wBACjB,UAAU,EAAE,MAAM;wBAClB,OAAO,EAAE,IAAI,CAAC,OAAO;qBACtB;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,IAA0C,EAAE,EAAE;gBAC3E,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,eAAe;oBACrB,IAAI,EAAE;wBACJ,QAAQ,EAAE,WAAW;wBACrB,MAAM,EAAE,SAAS;wBACjB,UAAU,EAAE,YAAY;wBACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;qBAC1B;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,IAAoF,EAAE,EAAE;gBACnH,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,eAAe;oBACrB,IAAI,EAAE;wBACJ,QAAQ,EAAE,WAAW;wBACrB,MAAM,EAAE,SAAS;wBACjB,UAAU,EAAE,UAAU;wBACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;wBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;qBAC1B;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,IAAS,EAAE,EAAE;gBAC7C,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,eAAe;oBACrB,IAAI,EAAE;wBACJ,QAAQ,EAAE,WAAW;wBACrB,MAAM,EAAE,SAAS;wBACjB,UAAU,EAAE,eAAe;wBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;wBAC/B,SAAS,EAAE,KAAK;qBACjB;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,eAAe;YACf,MAAM,UAAU,GAAG;gBACjB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,YAAY,EAAE,GAAG,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE;gBAC9C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,uBAAuB;aAChD,CAAC;YAEF,sBAAsB;YACtB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAE/C,0BAA0B;YAC1B,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAElC,gBAAgB;YAChB,GAAG,CAAC,OAAO,CAAC;gBACV,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE;oBACJ,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE;oBAC7B,SAAS;oBACT,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;oBAC5C,MAAM,EAAE;wBACN,UAAU,EAAE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,YAAY;wBACzE,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;qBAClC;iBACF;aACF,CAAC,CAAC;YAEH,wBAAwB;YACxB,GAAG,CAAC,UAAU,EAAE,CAAC;gBACf,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;YAEH,mDAAmD;YACnD,yCAAyC;YACzC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,WAAW,IAAI,CAAC,CAAC,qBAAqB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAE5F,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAExE,yBAAyB;YACzB,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAElC,gBAAgB;YAChB,GAAG,CAAC,OAAO,CAAC;gBACV,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE;oBACJ,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE;oBAC7B,SAAS;oBACT,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,QAAQ;iBAChB;aACF,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;aACzD,CAAC;QACJ,CAAC;IACH,CAAC"}

package/dist/tools/update-task-plan.d.ts

@@ -0,0 +1,43 @@
+/**
+ * UpdateTaskPlan 工具 - LeadAgent 专用
+ *
+ * v9.0: LeadAgent 动态更新执行计划中的任务状态
+ *
+ * 核心功能：
+ * - start_task:    标记任务开始执行（自己做或即将派给Worker）
+ * - complete_task:  标记任务完成
+ * - fail_task:      标记任务失败
+ * - skip_task:      跳过不合理的任务
+ * - add_task:       动态新增任务到执行计划
+ *
+ * 事件链路：
+ * UpdateTaskPlan.execute() → 静态回调 → LeadAgent.emit('task:plan_update')
+ * → Coordinator 更新 currentPlan.tasks → emit swarm:task_update → WebSocket → 前端
+ */
+import { BaseTool } from './base.js';
+import type { ToolResult, ToolDefinition } from '../types/index.js';
+import type { TaskPlanUpdateInput, TaskPlanContext } from '../blueprint/types.js';
+/**
+ * UpdateTaskPlan 工具
+ * LeadAgent 专用，用于动态更新执行计划中的任务状态
+ */
+export declare class UpdateTaskPlanTool extends BaseTool<TaskPlanUpdateInput, ToolResult> {
+    name: string;
+    description: string;
+    private static context;
+    /**
+     * 设置任务计划上下文（由 LeadAgent 在启动 ConversationLoop 前调用）
+     */
+    static setContext(ctx: TaskPlanContext): void;
+    /**
+     * 获取当前上下文（供 DispatchWorker 等其他工具调用）
+     */
+    static getContext(): TaskPlanContext | null;
+    /**
+     * 清理上下文
+     */
+    static clearContext(): void;
+    getInputSchema(): ToolDefinition['inputSchema'];
+    execute(input: TaskPlanUpdateInput): Promise<ToolResult>;
+}
+//# sourceMappingURL=update-task-plan.d.ts.map

package/dist/tools/update-task-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-task-plan.d.ts","sourceRoot":"","sources":["../../src/tools/update-task-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,mBAAmB,EAAE,UAAU,CAAC;IAC/E,IAAI,SAAoB;IACxB,WAAW,SA2CL;IAGN,OAAO,CAAC,MAAM,CAAC,OAAO,CAAgC;IAEtD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAI7C;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,eAAe,GAAG,IAAI;IAI3C;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,IAAI;IAI3B,cAAc,IAAI,cAAc,CAAC,aAAa,CAAC;IA+DzC,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;CAmE/D"}