@ai-setting/roy-agent-cli 1.3.19 → 1.3.22

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

@@ -1,197 +0,0 @@
-/**
- * @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

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

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

@@ -1,88 +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.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

@@ -1,6 +0,0 @@
-/**
- * @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

@@ -1,6 +0,0 @@
-/**
- * @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

@@ -1,127 +0,0 @@
-/**
- * @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