@ai-setting/roy-agent-core 1.3.10 → 1.3.11

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

@@ -1,226 +0,0 @@
-/**
- * @fileoverview Task Workflow Extractor Integration Tests
- */
-
-import { describe, test, expect, vi, beforeEach } from "vitest";
-import { TaskTagPlugin } from "./task-tag-plugin";
-import type { Task, TaskOperation } from "../types";
-
-// Mock logger
-vi.mock("../../log-trace/logger", () => ({
-  createLogger: () => ({
-    debug: vi.fn(),
-    info: vi.fn(),
-    warn: vi.fn(),
-  }),
-}));
-
-describe("Task Workflow Extraction Integration", () => {
-  let plugin: TaskTagPlugin;
-  let mockTaskComponent: any;
-  let mockAgentComponent: any;
-  let mockWorkflowRepo: any;
-  let mockSessionComponent: any;
-  let mockWorkflowComponent: any;
-
-  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" as const,
-      }),
-      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: string) => {
-          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: string) => {
-          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: string) => {
-      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));
-  });
-});

package/src/env/task/plugins/workflow-extractor-agent.test.ts

@@ -1,107 +0,0 @@
-/**
- * @fileoverview Workflow Extractor Agent Tests (TDD)
- * 
- * RED Phase: Tests for workflow-extractor-agent prompt content
- * These tests verify the prompt includes the required validation reminder.
- */
-
-import { describe, it, expect } from 'bun:test';
-import { WORKFLOW_EXTRACTOR_PROMPT } from './workflow-extractor-agent';
-
-describe('Workflow Extractor Agent Prompt', () => {
-  describe('validation reminder', () => {
-    it('should include roy workflow validate command in prompt', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('roy workflow validate');
-    });
-
-    it('should include validation check instructions', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('验证检查清单');
-    });
-
-    it('should instruct to use validate after building workflow', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('验证通过后');
-    });
-
-    it('should mention using --yaml option for validate command', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('--yaml');
-    });
-
-    it('should include build workflow flow', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('构建流程');
-    });
-
-    it('should include node type information', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('roy workflow nodes');
-    });
-
-    it('should include workflow examples command', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('roy workflow list');
-    });
-
-    it('should include workflow get command', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('roy workflow get');
-    });
-  });
-
-  describe('prompt structure', () => {
-    it('should have extraction principles section', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('提取原则');
-    });
-
-    it('should have output requirements section', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('输出要求');
-    });
-
-    it('should have limitations section', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('限制');
-    });
-
-    it('should mention YAML output format', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('yaml');
-    });
-
-    it('should mention validation is required before output', () => {
-      expect(WORKFLOW_EXTRACTOR_PROMPT).toContain('才能输出');
-    });
-  });
-});
-
-describe('createWorkflowExtractorAgent', () => {
-  it('should export createWorkflowExtractorAgent function', async () => {
-    const { createWorkflowExtractorAgent } = await import('./workflow-extractor-agent');
-    expect(typeof createWorkflowExtractorAgent).toBe('function');
-  });
-
-  it('should return agent config with correct name', async () => {
-    const { createWorkflowExtractorAgent } = await import('./workflow-extractor-agent');
-    const config = createWorkflowExtractorAgent();
-    expect(config.name).toBe('workflow-extractor');
-  });
-
-  it('should return agent config with type sub', async () => {
-    const { createWorkflowExtractorAgent } = await import('./workflow-extractor-agent');
-    const config = createWorkflowExtractorAgent();
-    expect(config.type).toBe('sub');
-  });
-
-  it('should return agent config with systemPrompt', async () => {
-    const { createWorkflowExtractorAgent } = await import('./workflow-extractor-agent');
-    const config = createWorkflowExtractorAgent();
-    expect(config.systemPrompt).toBeTruthy();
-    expect(typeof config.systemPrompt).toBe('string');
-  });
-
-  it('should return agent config with maxIterations 10 for natural language generation', async () => {
-    const { createWorkflowExtractorAgent } = await import('./workflow-extractor-agent');
-    const config = createWorkflowExtractorAgent();
-    // Natural language workflow generation needs multiple iterations:
-    // generate YAML → validate → fix errors → repeat until validation passes
-    expect(config.maxIterations).toBe(10);
-  });
-
-  it('should return agent config with filterHistory false', async () => {
-    const { createWorkflowExtractorAgent } = await import('./workflow-extractor-agent');
-    const config = createWorkflowExtractorAgent();
-    expect(config.filterHistory).toBe(false);
-  });
-});

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

@@ -1,225 +0,0 @@
-/**
- * @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 const WORKFLOW_EXTRACTOR_PROMPT = `你是 Workflow 提取专家，负责将自然语言描述转换为符合规范的 Workflow YAML。
-
-## 提取原则
-
-1. **优先具象节点**：优先使用特定工具节点（如 read_file, write_file, grep, bash 等）
-2. **Fallback 到通用节点**：没有对应工具时，使用 agent/llm/bash 节点
-3. **避免条件分支**：不提取循环和条件判断，保持线性流程
-4. **泛化但可执行**：步骤描述可泛化，但节点类型和工具要具体
-
-## 构建流程
-
-**重要**：构建的 Workflow 必须通过 \`roy workflow validate\` 验证才能输出。
-
-\`\`\`
-1. 理解用户需求
-2. 参考 roy workflow nodes 查看可用节点类型
-3. 参考 roy workflow get <name> 查看已有 workflow 示例
-4. 生成 Workflow YAML
-5. 使用 roy workflow validate --yaml "<生成的YAML>" 验证
-6. 验证通过后输出最终结果
-\`\`\`
-
-## 验证检查清单
-
-完成 Workflow 构建后，必须使用以下命令验证：
-
-\`\`\`bash
-roy workflow validate --yaml "<your-yaml>"
-\`\`\`
-
-验证通过后（无错误输出）才输出最终结果。验证失败时根据错误信息修正后重新验证。
-
-## 可用的 Workflow 节点类型
-
-使用以下命令查看所有节点类型的详细配置：
-
-\`\`\`bash
-roy workflow nodes              # 列出所有节点类型
-roy workflow nodes <type>      # 查看特定节点详情（如 tool, agent, skill）
-\`\`\`
-
-**支持的节点类型：**
-- **tool**：执行工具（bash, read-file, write-file, grep 等）
-- **skill**：调用技能
-- **agent**：AI Agent
-- **workflow**：子工作流
-- **condition**：条件判断
-- **merge**：合并结果
-- **decorator**：装饰器方法
-
-## 查看已有 Workflow 示例
-
-使用以下命令查看已有 workflow 的 YAML 结构：
-
-\`\`\`bash
-roy workflow list              # 列出所有 workflow
-roy workflow get <name>       # 获取指定 workflow 详情（YAML 格式）
-\`\`\`
-
-## 输出要求
-
-验证通过后，输出符合以下格式的 YAML Workflow：
-
-\`\`\`yaml
-name: {泛化的任务名称}
-version: "1.0"
-description: {一句话描述}
-nodes:
-  - id: node-1
-    type: tool|skill|agent|workflow|condition|merge|decorator
-    name: {节点名称}
-    config:
-      # 根据类型配置必填字段：
-      # tool: tool, input/args
-      # skill: skill, input
-      # agent: agent_type, prompt, options
-      # workflow: workflow_name, input
-      # condition: condition
-      # merge: strategy, depends_on
-      # decorator: _methodName, _instance
-    depends_on: []
-outputs: []
-\`\`\`
-
-## 限制
-
-- 至少 2 个节点才有意义
-- 不要生成条件节点（if/else/switch）
-- 不要生成循环节点（while/for）
-- 每个节点要有清晰的名称和描述
-- 必须为 tool 节点指定 tool 名称
-- 必须为 agent 节点指定 agent_type 和 prompt`;
-
-/**
- * 创建 WorkflowExtractorAgent 配置
- */
-export function createWorkflowExtractorAgent(): AgentInstanceConfig {
-  return {
-    type: "sub",
-    name: "workflow-extractor",
-    systemPrompt: WORKFLOW_EXTRACTOR_PROMPT,
-    maxIterations: 10,
-    filterHistory: false,
-  };
-}
-
-/**
- * 格式化提取器输入 - 从 Task 提取
- */
-export function formatExtractorInput(params: {
-  task: Task;
-  operations: TaskOperation[];
-  messages: SessionMessage[];
-}): string {
-  const lines: string[] = [];
-  
-  // Task Info
-  lines.push("# 任务信息");
-  lines.push(`- 标题: ${params.task.title}`);
-  if (params.task.description) {
-    lines.push(`- 描述: ${params.task.description}`);
-  }
-  if (params.task.goals_and_expected_deliverables) {
-    lines.push(`- 目标: ${params.task.goals_and_expected_deliverables}`);
-  }
-  lines.push("");
-  
-  // Operations
-  if (params.operations.length > 0) {
-    lines.push("# 操作记录");
-    for (const op of params.operations) {
-      lines.push(`- [${op.actionType}] ${op.actionTitle}`);
-      if (op.actionDescription) {
-        lines.push(`  ${op.actionDescription.slice(0, 200)}`);
-      }
-    }
-    lines.push("");
-  }
-  
-  // Messages
-  lines.push("# Session 消息历史");
-  lines.push("(以下是相关的对话历史，请从中提取 Workflow)");
-  for (const msg of params.messages.slice(-50)) { // 限制消息数量
-    const content = typeof msg.content === 'string' 
-      ? msg.content 
-      : JSON.stringify(msg.content);
-    const truncated = content.slice(0, 500);
-    lines.push(`**${msg.role}**: ${truncated}${content.length > 500 ? '...' : ''}`);
-  }
-  lines.push("");
-  
-  lines.push("## 任务");
-  lines.push("请分析以上信息，构建一个可复用的 Workflow。");
-  lines.push("使用迭代式流程：生成 YAML → validate 验证 → 修正错误 → 重复直到通过验证。");
-  
-  return lines.join("\n");
-}
-
-/**
- * 格式化提取器输入 - 从自然语言描述提取
- */
-export function formatExtractorInputFromDescription(params: {
-  description: string;
-}): string {
-  const lines: string[] = [];
-  
-  lines.push("# Workflow 描述");
-  lines.push(params.description);
-  lines.push("");
-  
-  lines.push("## 任务");
-  lines.push("请根据以上描述，构建一个可复用的 Workflow。");
-  lines.push("使用迭代式流程：生成 YAML → validate 验证 → 修正错误 → 重复直到通过验证。");
-  
-  return lines.join("\n");
-}
-
-/**
- * 解析提取器输出
- */
-export async function parseExtractorOutput(output: string): Promise<WorkflowDefinition | null> {
-  // 提取 YAML 代码块
-  const yamlMatch = output.match(/```yaml\n?([\s\S]*?)\n?```/) ||
-                    output.match(/```\n?([\s\S]*?)\n?```/) ||
-                    output.match(/(\|[\s\S]*?)(?:\n\n|$)/);
-  
-  const yamlContent = yamlMatch?.[1] || output;
-  
-  try {
-    // 动态导入 yaml 包（与 workflow.ts 中的模式一致）
-    const YAML = await import("yaml");
-    const parsed = YAML.parse(yamlContent) as WorkflowDefinition;
-    
-    // 验证必要字段
-    if (!parsed.name || !parsed.nodes || !Array.isArray(parsed.nodes)) {
-      return null;
-    }
-    
-    // 至少 2 个节点
-    if (parsed.nodes.length < 2) {
-      return null;
-    }
-    
-    // 确保 version 有默认值
-    parsed.version = parsed.version || "1.0";
-    
-    return parsed;
-  } catch {
-    return null;
-  }
-}

package/src/env/task/storage/index.ts

@@ -1,6 +0,0 @@
-/**
- * @fileoverview Task Storage Index
- */
-
-export { SQLiteTaskStore, type TaskStore } from "./sqlite-task-store";
-export { getDefaultTaskDbPath, getDefaultDataDir } from "./sqlite-task-store";