@ai-setting/roy-agent-cli 1.3.15 → 1.3.16

package/dist/core/src/env/task/plugins/task-tag-plugin.test.js

@@ -0,0 +1,310 @@
+/**
+ * @fileoverview TaskTagPlugin Tests
+ *
+ * 测试覆盖（简化版）：
+ * 1. Hook 注册和执行
+ * 2. delegateBefore: 类似任务信息注入（仅 ID、描述、目标）
+ */
+import { describe, test, expect, vi, beforeEach } from "bun:test";
+import { TaskTagPlugin } from "./task-tag-plugin.js";
+import { TaskHookPoints } from "../hooks/index.js";
+// Mock logger
+vi.mock("../../log-trace/logger", () => ({
+    createLogger: () => ({
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+    }),
+}));
+describe("TaskTagPlugin", () => {
+    let plugin;
+    let mockTagService;
+    let mockTaskComponent;
+    beforeEach(() => {
+        plugin = new TaskTagPlugin();
+        mockTagService = {
+            findSimilarTasksByKeywords: vi.fn().mockResolvedValue([]),
+        };
+        mockTaskComponent = {
+            getTask: vi.fn(),
+            listOperations: vi.fn().mockResolvedValue([]),
+            createOperation: vi.fn(),
+            env: {
+                getComponent: vi.fn().mockReturnValue(null),
+            },
+        };
+        plugin.setComponents(null, mockTaskComponent);
+    });
+    // ========================================================================
+    // Hook 注册测试
+    // ========================================================================
+    test("should have correct name and hooks", () => {
+        expect(plugin.name).toBe("TaskTagPlugin");
+        expect(plugin.hooks).toHaveLength(2);
+        expect(plugin.hooks.map(h => h.point)).toContain(TaskHookPoints.DELEGATE_BEFORE);
+        expect(plugin.hooks.map(h => h.point)).toContain(TaskHookPoints.OPERATION_AFTER_CREATE);
+    });
+    test("should have static getRequiredAgents method", () => {
+        expect(typeof TaskTagPlugin.getRequiredAgents).toBe("function");
+        const agents = TaskTagPlugin.getRequiredAgents();
+        expect(agents).toHaveLength(1);
+        expect(agents[0].name).toBe("workflow-extractor");
+    });
+    test("should skip execution when disabled", async () => {
+        const disabledPlugin = new TaskTagPlugin({ enabled: false });
+        disabledPlugin.setComponents(null, mockTaskComponent);
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                subagentType: "general",
+                background: false,
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await disabledPlugin.execute(ctx);
+        expect(mockTaskComponent.getTask).not.toHaveBeenCalled();
+    });
+    // ========================================================================
+    // delegateBefore 类似任务注入测试
+    // ========================================================================
+    test("should skip when no taskId", async () => {
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: undefined,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        expect(mockTaskComponent.getTask).not.toHaveBeenCalled();
+    });
+    test("should skip when task not found", async () => {
+        mockTaskComponent.getTask.mockResolvedValue(undefined);
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        expect(mockTagService.findSimilarTasksByKeywords).not.toHaveBeenCalled();
+    });
+    test("should skip when no keywords available", async () => {
+        mockTaskComponent.getTask.mockResolvedValue({
+            id: 123,
+            title: "123",
+            tags: undefined,
+        });
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        expect(mockTagService.findSimilarTasksByKeywords).not.toHaveBeenCalled();
+    });
+    test("should search using tags as keywords", async () => {
+        mockTaskComponent.getTask.mockResolvedValue({
+            id: 123,
+            title: "Fix login bug",
+            tags: ["bug", "authentication"],
+        });
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        expect(mockTagService.findSimilarTasksByKeywords).toHaveBeenCalledWith(expect.arrayContaining(["bug", "authentication"]), { limit: 5, excludeTaskId: 123 });
+    });
+    test("should search using title words as keywords", async () => {
+        mockTaskComponent.getTask.mockResolvedValue({
+            id: 123,
+            title: "Fix login bug",
+            tags: [],
+        });
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        expect(mockTagService.findSimilarTasksByKeywords).toHaveBeenCalledWith(expect.arrayContaining(["login", "bug"]), { limit: 5, excludeTaskId: 123 });
+    });
+    test("should skip when no similar tasks found", async () => {
+        mockTaskComponent.getTask.mockResolvedValue({
+            id: 123,
+            title: "Fix bug",
+            tags: ["bug"],
+        });
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        expect(ctx.data.prompt).toBe("Test prompt");
+    });
+    test("should inject similar tasks info (simplified)", async () => {
+        const similarTasks = [
+            { id: 10, title: "Fix similar bug #1", description: "Bug description", goals_and_expected_deliverables: "Goal 1" },
+            { id: 11, title: "Fix similar bug #2", description: "Another bug" },
+        ];
+        mockTaskComponent.getTask.mockResolvedValue({
+            id: 123,
+            title: "Fix bug",
+            tags: ["bug"],
+        });
+        mockTagService.findSimilarTasksByKeywords.mockResolvedValue(similarTasks);
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Fix this bug",
+                subagentType: "general",
+                background: false,
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        // 验证 prompt 被修改，包含类似任务信息
+        expect(ctx.data.prompt).toContain("类似任务参考");
+        expect(ctx.data.prompt).toContain("Task #10");
+        expect(ctx.data.prompt).toContain("Task #11");
+        expect(ctx.data.prompt).toContain("Description");
+        expect(ctx.data.prompt).toContain("Goal");
+        expect(ctx.data.prompt).toContain("task_operation_list"); // 提醒获取操作记录
+        expect(ctx.data.prompt).toContain("Fix this bug"); // 原 prompt 保留
+    });
+    // ========================================================================
+    // 关键词提取测试
+    // ========================================================================
+    test("should combine tags and title words", async () => {
+        mockTaskComponent.getTask.mockResolvedValue({
+            id: 123,
+            title: "Implement user authentication",
+            tags: ["backend", "security"],
+        });
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        const calledKeywords = mockTagService.findSimilarTasksByKeywords.mock.calls[0][0];
+        expect(calledKeywords).toContain("backend");
+        expect(calledKeywords).toContain("security");
+        expect(calledKeywords).toContain("user");
+        expect(calledKeywords).toContain("authentication");
+    });
+    test("should filter numeric-only title words", async () => {
+        mockTaskComponent.getTask.mockResolvedValue({
+            id: 123,
+            title: "Fix issue #1234",
+            tags: ["bug"],
+        });
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        const calledKeywords = mockTagService.findSimilarTasksByKeywords.mock.calls[0][0];
+        expect(calledKeywords).not.toContain("1234");
+        expect(calledKeywords).toContain("bug");
+    });
+    // ========================================================================
+    // 错误处理测试
+    // ========================================================================
+    test("should handle getTask error gracefully", async () => {
+        mockTaskComponent.getTask.mockRejectedValue(new Error("DB error"));
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        expect(ctx.data.prompt).toBe("Test prompt");
+    });
+    test("should handle search error gracefully", async () => {
+        mockTaskComponent.getTask.mockResolvedValue({
+            id: 123,
+            title: "Fix bug",
+            tags: ["bug"],
+        });
+        mockTagService.findSimilarTasksByKeywords.mockRejectedValue(new Error("Search error"));
+        const ctx = {
+            component: { name: "task", version: "1.0.0" },
+            data: {
+                taskId: 123,
+                prompt: "Test prompt",
+                tagService: mockTagService,
+            },
+            metadata: {},
+            phase: "before",
+            hookPoint: TaskHookPoints.DELEGATE_BEFORE,
+        };
+        await plugin.execute(ctx);
+        expect(ctx.data.prompt).toBe("Test prompt");
+    });
+});
+//# sourceMappingURL=task-tag-plugin.test.js.map

package/dist/core/src/env/task/plugins/task-workflow-extractor.integration.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Task Workflow Extractor Integration Tests
+ */
+export {};
+//# sourceMappingURL=task-workflow-extractor.integration.test.d.ts.map

package/dist/core/src/env/task/plugins/task-workflow-extractor.integration.test.js

@@ -0,0 +1,198 @@
+/**
+ * @fileoverview Task Workflow Extractor Integration Tests
+ */
+import { describe, test, expect, vi, beforeEach } from "vitest";
+import { TaskTagPlugin } from "./task-tag-plugin.js";
+// Mock logger
+vi.mock("../../log-trace/logger", () => ({
+    createLogger: () => ({
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+    }),
+}));
+describe("Task Workflow Extraction Integration", () => {
+    let plugin;
+    let mockTaskComponent;
+    let mockAgentComponent;
+    let mockWorkflowRepo;
+    let mockSessionComponent;
+    let mockWorkflowComponent;
+    beforeEach(() => {
+        plugin = new TaskTagPlugin();
+        mockWorkflowRepo = {
+            getByName: vi.fn().mockReturnValue(null), // No existing workflow
+            create: vi.fn().mockReturnValue({
+                id: "wf-123",
+                name: "test-extracted-workflow",
+                nodes: [
+                    { id: "node-1", type: "tool" },
+                    { id: "node-2", type: "tool" },
+                ],
+            }),
+        };
+        mockWorkflowComponent = {
+            workflowService: {
+                workflowRepository: mockWorkflowRepo,
+            },
+        };
+        mockSessionComponent = {
+            getContext: vi.fn().mockResolvedValue({
+                messages: [
+                    { role: "user", content: "Read the file" },
+                    { role: "assistant", content: "Reading file..." },
+                    { role: "user", content: "Write the changes" },
+                    { role: "assistant", content: "Writing changes..." },
+                ],
+            }),
+        };
+        mockAgentComponent = {
+            run: vi.fn().mockResolvedValue({
+                finalText: `
+\`\`\`yaml
+name: test-extracted-workflow
+version: "1.0"
+description: Test workflow
+nodes:
+  - id: node-1
+    type: tool
+    name: Read File
+    config:
+      toolName: read_file
+    depends_on: []
+  - id: node-2
+    type: tool
+    name: Write File
+    config:
+      toolName: write_file
+    depends_on: [node-1]
+\`\`\`
+`,
+            }),
+        };
+        mockTaskComponent = {
+            getTask: vi.fn().mockResolvedValue({
+                id: 1,
+                title: "Test Task",
+                description: "Test description",
+                goals_and_expected_deliverables: "Test goals",
+                status: "completed",
+            }),
+            listOperations: vi.fn().mockResolvedValue([
+                {
+                    id: 1,
+                    taskId: 1,
+                    sessionId: "session-1",
+                    actionType: "create",
+                    actionTitle: "Task created",
+                },
+                {
+                    id: 2,
+                    taskId: 1,
+                    sessionId: "session-1",
+                    actionType: "completed",
+                    actionTitle: "Task completed",
+                },
+            ]),
+            createOperation: vi.fn().mockResolvedValue({ id: 3 }),
+            env: {
+                getComponent: vi.fn((name) => {
+                    if (name === "agent")
+                        return mockAgentComponent;
+                    if (name === "session")
+                        return mockSessionComponent;
+                    if (name === "workflow")
+                        return mockWorkflowComponent;
+                    return null;
+                }),
+            },
+        };
+        plugin.setComponents(null, mockTaskComponent);
+    });
+    test("should extract workflow on task completion", async () => {
+        await plugin.extractWorkflow(1, "session-1");
+        // 验证 agent 被调用
+        expect(mockAgentComponent.run).toHaveBeenCalledWith("workflow-extractor", expect.stringContaining("Test Task"));
+        // 验证 workflow 被存储
+        expect(mockWorkflowRepo.create).toHaveBeenCalled();
+        // 验证 operation 被创建
+        expect(mockTaskComponent.createOperation).toHaveBeenCalledWith(expect.objectContaining({
+            taskId: 1,
+            sessionId: "session-1",
+            actionType: "workflow_extracted",
+        }));
+    });
+    test("should skip extraction when agent component unavailable", async () => {
+        // Create a new plugin with no agent component
+        const pluginNoAgent = new TaskTagPlugin();
+        const mockTaskComponentNoAgent = {
+            getTask: mockTaskComponent.getTask,
+            listOperations: mockTaskComponent.listOperations,
+            createOperation: mockTaskComponent.createOperation,
+            env: {
+                getComponent: vi.fn((name) => {
+                    if (name === "agent")
+                        return null; // No agent
+                    if (name === "session")
+                        return mockSessionComponent;
+                    if (name === "workflow")
+                        return mockWorkflowComponent;
+                    return null;
+                }),
+            },
+        };
+        pluginNoAgent.setComponents(null, mockTaskComponentNoAgent);
+        await pluginNoAgent.extractWorkflow(1, "session-1");
+        expect(mockAgentComponent.run).not.toHaveBeenCalled();
+    });
+    test("should skip when workflow has less than 2 nodes", async () => {
+        mockAgentComponent.run = vi.fn().mockResolvedValue({
+            finalText: `
+\`\`\`yaml
+name: single-node-workflow
+version: "1.0"
+nodes:
+  - id: node-1
+    type: tool
+    name: Single Node
+    config: {}
+    depends_on: []
+\`\`\`
+`,
+        });
+        await plugin.extractWorkflow(1, "session-1");
+        // Agent 应该被调用
+        expect(mockAgentComponent.run).toHaveBeenCalled();
+        // 但不应该存储（节点数不足）
+        expect(mockWorkflowRepo.create).not.toHaveBeenCalled();
+    });
+    test("should skip when workflow parsing fails", async () => {
+        mockAgentComponent.run = vi.fn().mockResolvedValue({
+            finalText: "This is not a valid workflow YAML",
+        });
+        await plugin.extractWorkflow(1, "session-1");
+        expect(mockAgentComponent.run).toHaveBeenCalled();
+        expect(mockWorkflowRepo.create).not.toHaveBeenCalled();
+    });
+    test("should collect messages from multiple sessions", async () => {
+        // 模拟多个 session
+        mockTaskComponent.listOperations = vi.fn().mockResolvedValue([
+            { id: 1, taskId: 1, sessionId: "session-1", actionType: "create", actionTitle: "Task created" },
+            { id: 2, taskId: 1, sessionId: "session-2", actionType: "progress", actionTitle: "Progress" },
+            { id: 3, taskId: 1, sessionId: "session-1", actionType: "completed", actionTitle: "Task completed" },
+        ]);
+        mockSessionComponent.getContext = vi.fn().mockImplementation((sessionId) => {
+            return Promise.resolve({
+                messages: [
+                    { role: "user", content: `Message from ${sessionId}` },
+                ],
+            });
+        });
+        await plugin.extractWorkflow(1, "session-1");
+        // 验证从多个 session 获取消息
+        expect(mockSessionComponent.getContext).toHaveBeenCalledTimes(2);
+        expect(mockSessionComponent.getContext).toHaveBeenCalledWith("session-1", expect.any(Object));
+        expect(mockSessionComponent.getContext).toHaveBeenCalledWith("session-2", expect.any(Object));
+    });
+});
+//# sourceMappingURL=task-workflow-extractor.integration.test.js.map

package/dist/core/src/env/task/plugins/workflow-extractor-agent.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview WorkflowExtractorAgent - 工作流提取 Agent
+ *
+ * 负责从自然语言描述或 Task 对话历史中提取 Workflow YAML。
+ */
+import type { AgentInstanceConfig } from "../../agent/types";
+import type { Task, TaskOperation } from "../types";
+import type { SessionMessage } from "../../session/session-component";
+import type { WorkflowDefinition } from "../../workflow/types";
+/**
+ * Workflow Extractor Agent System Prompt
+ */
+export declare const WORKFLOW_EXTRACTOR_PROMPT = "\u4F60\u662F Workflow \u63D0\u53D6\u4E13\u5BB6\uFF0C\u8D1F\u8D23\u5C06\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u8F6C\u6362\u4E3A\u7B26\u5408\u89C4\u8303\u7684 Workflow YAML\u3002\n\n## \u63D0\u53D6\u539F\u5219\n\n1. **\u4F18\u5148\u5177\u8C61\u8282\u70B9**\uFF1A\u4F18\u5148\u4F7F\u7528\u7279\u5B9A\u5DE5\u5177\u8282\u70B9\uFF08\u5982 read_file, write_file, grep, bash \u7B49\uFF09\n2. **Fallback \u5230\u901A\u7528\u8282\u70B9**\uFF1A\u6CA1\u6709\u5BF9\u5E94\u5DE5\u5177\u65F6\uFF0C\u4F7F\u7528 agent/llm/bash \u8282\u70B9\n3. **\u907F\u514D\u6761\u4EF6\u5206\u652F**\uFF1A\u4E0D\u63D0\u53D6\u5FAA\u73AF\u548C\u6761\u4EF6\u5224\u65AD\uFF0C\u4FDD\u6301\u7EBF\u6027\u6D41\u7A0B\n4. **\u6CDB\u5316\u4F46\u53EF\u6267\u884C**\uFF1A\u6B65\u9AA4\u63CF\u8FF0\u53EF\u6CDB\u5316\uFF0C\u4F46\u8282\u70B9\u7C7B\u578B\u548C\u5DE5\u5177\u8981\u5177\u4F53\n\n## \u6784\u5EFA\u6D41\u7A0B\n\n**\u91CD\u8981**\uFF1A\u6784\u5EFA\u7684 Workflow \u5FC5\u987B\u901A\u8FC7 `roy workflow validate` \u9A8C\u8BC1\u624D\u80FD\u8F93\u51FA\u3002\n\n```\n1. \u7406\u89E3\u7528\u6237\u9700\u6C42\n2. \u53C2\u8003 roy workflow nodes \u67E5\u770B\u53EF\u7528\u8282\u70B9\u7C7B\u578B\n3. \u53C2\u8003 roy workflow get <name> \u67E5\u770B\u5DF2\u6709 workflow \u793A\u4F8B\n4. \u751F\u6210 Workflow YAML\n5. \u4F7F\u7528 roy workflow validate --yaml \"<\u751F\u6210\u7684YAML>\" \u9A8C\u8BC1\n6. \u9A8C\u8BC1\u901A\u8FC7\u540E\u8F93\u51FA\u6700\u7EC8\u7ED3\u679C\n```\n\n## \u9A8C\u8BC1\u68C0\u67E5\u6E05\u5355\n\n\u5B8C\u6210 Workflow \u6784\u5EFA\u540E\uFF0C\u5FC5\u987B\u4F7F\u7528\u4EE5\u4E0B\u547D\u4EE4\u9A8C\u8BC1\uFF1A\n\n```bash\nroy workflow validate --yaml \"<your-yaml>\"\n```\n\n\u9A8C\u8BC1\u901A\u8FC7\u540E\uFF08\u65E0\u9519\u8BEF\u8F93\u51FA\uFF09\u624D\u8F93\u51FA\u6700\u7EC8\u7ED3\u679C\u3002\u9A8C\u8BC1\u5931\u8D25\u65F6\u6839\u636E\u9519\u8BEF\u4FE1\u606F\u4FEE\u6B63\u540E\u91CD\u65B0\u9A8C\u8BC1\u3002\n\n## \u53EF\u7528\u7684 Workflow \u8282\u70B9\u7C7B\u578B\n\n\u4F7F\u7528\u4EE5\u4E0B\u547D\u4EE4\u67E5\u770B\u6240\u6709\u8282\u70B9\u7C7B\u578B\u7684\u8BE6\u7EC6\u914D\u7F6E\uFF1A\n\n```bash\nroy workflow nodes              # \u5217\u51FA\u6240\u6709\u8282\u70B9\u7C7B\u578B\nroy workflow nodes <type>      # \u67E5\u770B\u7279\u5B9A\u8282\u70B9\u8BE6\u60C5\uFF08\u5982 tool, agent, skill\uFF09\n```\n\n**\u652F\u6301\u7684\u8282\u70B9\u7C7B\u578B\uFF1A**\n- **tool**\uFF1A\u6267\u884C\u5DE5\u5177\uFF08bash, read-file, write-file, grep \u7B49\uFF09\n- **skill**\uFF1A\u8C03\u7528\u6280\u80FD\n- **agent**\uFF1AAI Agent\n- **workflow**\uFF1A\u5B50\u5DE5\u4F5C\u6D41\n- **condition**\uFF1A\u6761\u4EF6\u5224\u65AD\n- **merge**\uFF1A\u5408\u5E76\u7ED3\u679C\n- **decorator**\uFF1A\u88C5\u9970\u5668\u65B9\u6CD5\n\n## \u67E5\u770B\u5DF2\u6709 Workflow \u793A\u4F8B\n\n\u4F7F\u7528\u4EE5\u4E0B\u547D\u4EE4\u67E5\u770B\u5DF2\u6709 workflow \u7684 YAML \u7ED3\u6784\uFF1A\n\n```bash\nroy workflow list              # \u5217\u51FA\u6240\u6709 workflow\nroy workflow get <name>       # \u83B7\u53D6\u6307\u5B9A workflow \u8BE6\u60C5\uFF08YAML \u683C\u5F0F\uFF09\n```\n\n## \u8F93\u51FA\u8981\u6C42\n\n\u9A8C\u8BC1\u901A\u8FC7\u540E\uFF0C\u8F93\u51FA\u7B26\u5408\u4EE5\u4E0B\u683C\u5F0F\u7684 YAML Workflow\uFF1A\n\n```yaml\nname: {\u6CDB\u5316\u7684\u4EFB\u52A1\u540D\u79F0}\nversion: \"1.0\"\ndescription: {\u4E00\u53E5\u8BDD\u63CF\u8FF0}\nnodes:\n  - id: node-1\n    type: tool|skill|agent|workflow|condition|merge|decorator\n    name: {\u8282\u70B9\u540D\u79F0}\n    config:\n      # \u6839\u636E\u7C7B\u578B\u914D\u7F6E\u5FC5\u586B\u5B57\u6BB5\uFF1A\n      # tool: tool, input/args\n      # skill: skill, input\n      # agent: agent_type, prompt, options\n      # workflow: workflow_name, input\n      # condition: condition\n      # merge: strategy, depends_on\n      # decorator: _methodName, _instance\n    depends_on: []\noutputs: []\n```\n\n## \u9650\u5236\n\n- \u81F3\u5C11 2 \u4E2A\u8282\u70B9\u624D\u6709\u610F\u4E49\n- \u4E0D\u8981\u751F\u6210\u6761\u4EF6\u8282\u70B9\uFF08if/else/switch\uFF09\n- \u4E0D\u8981\u751F\u6210\u5FAA\u73AF\u8282\u70B9\uFF08while/for\uFF09\n- \u6BCF\u4E2A\u8282\u70B9\u8981\u6709\u6E05\u6670\u7684\u540D\u79F0\u548C\u63CF\u8FF0\n- \u5FC5\u987B\u4E3A tool \u8282\u70B9\u6307\u5B9A tool \u540D\u79F0\n- \u5FC5\u987B\u4E3A agent \u8282\u70B9\u6307\u5B9A agent_type \u548C prompt";
+/**
+ * 创建 WorkflowExtractorAgent 配置
+ */
+export declare function createWorkflowExtractorAgent(): AgentInstanceConfig;
+/**
+ * 格式化提取器输入 - 从 Task 提取
+ */
+export declare function formatExtractorInput(params: {
+    task: Task;
+    operations: TaskOperation[];
+    messages: SessionMessage[];
+}): string;
+/**
+ * 格式化提取器输入 - 从自然语言描述提取
+ */
+export declare function formatExtractorInputFromDescription(params: {
+    description: string;
+}): string;
+/**
+ * 解析提取器输出
+ */
+export declare function parseExtractorOutput(output: string): Promise<WorkflowDefinition | null>;
+//# sourceMappingURL=workflow-extractor-agent.d.ts.map