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

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

@@ -0,0 +1,197 @@
+/**
+ * @fileoverview WorkflowExtractorAgent - 工作流提取 Agent
+ *
+ * 负责从自然语言描述或 Task 对话历史中提取 Workflow YAML。
+ */
+/**
+ * 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() {
+    return {
+        type: "sub",
+        name: "workflow-extractor",
+        systemPrompt: WORKFLOW_EXTRACTOR_PROMPT,
+        maxIterations: 10,
+        filterHistory: false,
+    };
+}
+/**
+ * 格式化提取器输入 - 从 Task 提取
+ */
+export function formatExtractorInput(params) {
+    const lines = [];
+    // 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) {
+    const lines = [];
+    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) {
+    // 提取 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);
+        // 验证必要字段
+        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;
+    }
+}
+//# sourceMappingURL=workflow-extractor-agent.js.map

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

@@ -0,0 +1,8 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=workflow-extractor-agent.test.d.ts.map

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

@@ -0,0 +1,88 @@
+/**
+ * @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.js";
+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);
+    });
+});
+//# sourceMappingURL=workflow-extractor-agent.test.js.map

package/dist/core/src/env/task/storage/index.d.ts

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

package/dist/core/src/env/task/storage/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Task Storage Index
+ */
+export { SQLiteTaskStore } from "./sqlite-task-store.js";
+export { getDefaultTaskDbPath, getDefaultDataDir } from "./sqlite-task-store.js";
+//# sourceMappingURL=index.js.map

package/dist/core/src/env/task/storage/sqlite-task-store.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview SQLite Task Store
+ *
+ * SQLite-based implementation of TaskStore.
+ * Uses Bun's built-in bun:sqlite module for persistence.
+ *
+ * 参考 Session SQLiteStore 实现模式：
+ * - 使用 bun:sqlite 内置模块
+ * - 内存缓存提高性能
+ * - 默认路径：~/.local/share/roy-agent/tasks.db
+ */
+import type { Task, TaskOperation, TaskTag, CreateTaskOptions, UpdateTaskOptions, ListTasksOptions, CreateOperationOptions, ListOperationsOptions } from "../types";
+import type { ListTagsOptions, SearchTagsOptions } from "../tag-service";
+/**
+ * Get default data directory for task storage
+ */
+declare function getDefaultDataDir(): string;
+/**
+ * Get default database path for task storage
+ */
+declare function getDefaultTaskDbPath(): string;
+export interface TaskStore {
+    createTask(options: CreateTaskOptions): Promise<Task>;
+    getTask(id: number): Promise<Task | undefined>;
+    updateTask(id: number, options: UpdateTaskOptions): Promise<Task | undefined>;
+    deleteTask(id: number): Promise<boolean>;
+    listTasks(options?: ListTasksOptions): Promise<Task[]>;
+    createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
+    getOperation(id: number): Promise<TaskOperation | undefined>;
+    updateOperation(id: number, updates: {
+        actionTitle?: string;
+        actionDescription?: string;
+    }): Promise<TaskOperation | undefined>;
+    deleteOperation(id: number): Promise<boolean>;
+    listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    createTag(name: string): Promise<TaskTag>;
+    getTag(id: number): Promise<TaskTag | undefined>;
+    getTagByName(name: string): Promise<TaskTag | undefined>;
+    listTags(options?: ListTagsOptions): Promise<TaskTag[]>;
+    searchTags(options: SearchTagsOptions): Promise<TaskTag[]>;
+    deleteTag(id: number): Promise<boolean>;
+    addTagsToTask(taskId: number, tagIds: number[]): Promise<void>;
+    removeTagsFromTask(taskId: number, tagIds: number[]): Promise<void>;
+    getTagsForTask(taskId: number): Promise<TaskTag[]>;
+    getTaskIdsByTags(tagNames: string[]): Promise<number[]>;
+    updateTaskTags(taskId: number, tagNames: string[]): Promise<void>;
+    /** Search tasks by keywords (tags, description, goals, operations) */
+    searchTasksByKeywords(keywords: string[], options?: {
+        limit?: number;
+        excludeTaskId?: number;
+    }): Promise<Task[]>;
+    /** Find similar tasks using new keywords search */
+    findSimilarTasksByKeywords(keywords: string[], options?: {
+        limit?: number;
+        excludeTaskId?: number;
+    }): Promise<Task[]>;
+    findSimilarTasks(taskId: number, limit?: number): Promise<Task[]>;
+    searchTasks(query: string, limit?: number): Promise<Task[]>;
+    close(): void;
+}
+/**
+ * SQLite-based Task Store
+ *
+ * 参考 Session SQLiteStore 实现模式：
+ * - 使用 bun:sqlite 内置模块
+ * - 内存缓存提高性能
+ * - 默认路径：~/.local/share/roy-agent/tasks.db
+ */
+export declare class SQLiteTaskStore implements TaskStore {
+    private db;
+    private dbPath;
+    private initialized;
+    private tasksCache;
+    private operationsCache;
+    constructor(dbPath?: string);
+    private initialize;
+    createTask(options: CreateTaskOptions): Promise<Task>;
+    getTask(id: number): Promise<Task | undefined>;
+    updateTask(id: number, options: UpdateTaskOptions): Promise<Task | undefined>;
+    deleteTask(id: number): Promise<boolean>;
+    listTasks(options?: ListTasksOptions): Promise<Task[]>;
+    createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
+    getOperation(id: number): Promise<TaskOperation | undefined>;
+    updateOperation(id: number, updates: {
+        actionTitle?: string;
+        actionDescription?: string;
+    }): Promise<TaskOperation | undefined>;
+    deleteOperation(id: number): Promise<boolean>;
+    listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    private rowToTask;
+    private rowToOperation;
+    createTag(name: string): Promise<TaskTag>;
+    getTag(id: number): Promise<TaskTag | undefined>;
+    getTagByName(name: string): Promise<TaskTag | undefined>;
+    listTags(options?: ListTagsOptions): Promise<TaskTag[]>;
+    searchTags(options: SearchTagsOptions): Promise<TaskTag[]>;
+    deleteTag(id: number): Promise<boolean>;
+    addTagsToTask(taskId: number, tagIds: number[]): Promise<void>;
+    removeTagsFromTask(taskId: number, tagIds: number[]): Promise<void>;
+    getTagsForTask(taskId: number): Promise<TaskTag[]>;
+    getTaskIdsByTags(tagNames: string[]): Promise<number[]>;
+    updateTaskTags(taskId: number, tagNames: string[]): Promise<void>;
+    /**
+     * Search tasks by keywords list
+     * Searches in: tags (JSON), description, goals_and_expected_deliverables, operations
+     */
+    searchTasksByKeywords(keywords: string[], options?: {
+        limit?: number;
+        excludeTaskId?: number;
+    }): Promise<Task[]>;
+    /**
+     * Find similar tasks by keywords
+     * Excludes the target task and sorts by relevance
+     * Default limit is 5 to keep prompt concise
+     */
+    findSimilarTasksByKeywords(keywords: string[], options?: {
+        limit?: number;
+        excludeTaskId?: number;
+    }): Promise<Task[]>;
+    findSimilarTasks(taskId: number, limit?: number): Promise<Task[]>;
+    searchTasks(query: string, limit?: number): Promise<Task[]>;
+    private rowToTag;
+    private syncTaskTagsJson;
+    close(): Promise<void>;
+}
+export { getDefaultTaskDbPath, getDefaultDataDir };
+//# sourceMappingURL=sqlite-task-store.d.ts.map