@ai-setting/roy-agent-core 1.5.83 → 1.5.85

package/dist/shared/@ai-setting/{roy-agent-core-496zzm5a.js → roy-agent-core-h4h55x4h.js}

@@ -1,16 +1,135 @@
 import {
-  getDatabase
-} from "./roy-agent-core-6b57g1zk.js";
+  TagRepository
+} from "./roy-agent-core-3sv590cv.js";
 import {
   exports_search_query_parser,
   init_search_query_parser
 } from "./roy-agent-core-rvxg1wps.js";
 import {
+  createLogger,
+  init_logger
+} from "./roy-agent-core-shme7set.js";
+import {
+  __require,
   __toCommonJS
 } from "./roy-agent-core-fs0mn2jk.js";
 
 // src/env/workflow/storage/workflow-repo.ts
 import { randomUUID } from "crypto";
+
+// src/env/workflow/storage/sqlite.ts
+init_logger();
+import { join } from "path";
+var logger = createLogger("workflow:sqlite");
+function getDatabaseClass() {
+  if (typeof Bun !== "undefined") {
+    const { Database } = __require("bun:sqlite");
+    return Database;
+  } else {
+    return __require("better-sqlite3");
+  }
+}
+function createCompatibleDatabase(path) {
+  const Database = getDatabaseClass();
+  const db = new Database(path);
+  if (typeof db.run !== "function") {
+    db.run = function(sql, ...params) {
+      if (params.length > 0) {
+        return this.prepare(sql).run(...params);
+      } else {
+        return this.exec(sql);
+      }
+    };
+  }
+  return db;
+}
+function getDefaultDataDir() {
+  const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+  return join(home, ".local", "share", "roy-agent");
+}
+function getDatabasePath() {
+  return join(getDefaultDataDir(), "workflows.db");
+}
+var dbInstance = null;
+function getDatabase(path) {
+  if (!dbInstance) {
+    const dbPath = path ?? getDatabasePath();
+    const dbDir = dbPath.substring(0, dbPath.lastIndexOf("/"));
+    if (dbDir && dbDir !== "/") {
+      try {
+        const { mkdirSync } = __require("fs");
+        mkdirSync(dbDir, { recursive: true });
+      } catch {}
+    }
+    dbInstance = createCompatibleDatabase(dbPath);
+    try {
+      if (typeof dbInstance.pragma === "function") {
+        dbInstance.pragma("journal_mode = WAL");
+      }
+    } catch {
+      logger?.debug("WAL mode not available, using default journal mode");
+    }
+  }
+  return dbInstance;
+}
+function closeDatabase() {
+  if (dbInstance) {
+    dbInstance.close();
+    dbInstance = null;
+  }
+}
+function initializeTables() {
+  const db = getDatabase();
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS workflows (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL UNIQUE,
+      version TEXT NOT NULL DEFAULT '1.0',
+      description TEXT,
+      definition TEXT NOT NULL,
+      config TEXT NOT NULL DEFAULT '{}',
+      metadata TEXT NOT NULL DEFAULT '{}',
+      tags TEXT NOT NULL DEFAULT '[]',
+      task_id INTEGER,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    )
+  `);
+  db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_workflows_name ON workflows(name);
+    CREATE INDEX IF NOT EXISTS idx_workflows_tags ON workflows(tags);
+    CREATE INDEX IF NOT EXISTS idx_workflows_task_id ON workflows(task_id);
+  `);
+  TagRepository.createTable(db);
+  const migrated = migrateEmptyTagsToDefault(db);
+  if (migrated > 0) {
+    logger?.info?.(`[workflow:sqlite] Auto-migrated ${migrated} workflow(s) to default tag`);
+  }
+  const countRow = db.prepare("SELECT COUNT(*) as c FROM workflows WHERE tags LIKE ?").get('%"default"%');
+  const expectedDefaultCount = countRow.c;
+  if (expectedDefaultCount > 0) {
+    const tagRepo = new TagRepository(db);
+    const existing = tagRepo.get("default");
+    const now = new Date().toISOString();
+    if (!existing) {
+      db.prepare(`INSERT INTO workflow_tags (name, usage_count, created_at, updated_at)
+         VALUES ('default', ?, ?, ?)`).run(expectedDefaultCount, now, now);
+    } else if (existing.usage_count !== expectedDefaultCount) {
+      db.prepare("UPDATE workflow_tags SET usage_count = ?, updated_at = ? WHERE name = ?").run(expectedDefaultCount, now, "default");
+    }
+  }
+}
+function resetDatabase() {
+  closeDatabase();
+  dbInstance = null;
+}
+function initDatabase(path) {
+  const db = getDatabase(path);
+  initializeTables();
+  return db;
+}
+
+// src/env/workflow/storage/workflow-repo.ts
 function rowToWorkflow(row) {
   const metadata = JSON.parse(row.metadata);
   if (row.task_id !== null) {
@@ -185,6 +304,38 @@ class WorkflowRepository {
     const result = this.db.prepare("SELECT COUNT(*) as count FROM workflows").get();
     return result.count;
   }
+  countAll(options) {
+    let sql = "SELECT * FROM workflows";
+    const params = [];
+    const conditions = [];
+    if (options?.tag) {
+      conditions.push("tags LIKE ?");
+      params.push(`%${options.tag}%`);
+    }
+    if (options?.taskId !== undefined) {
+      conditions.push("task_id = ?");
+      params.push(options.taskId);
+    }
+    if (conditions.length > 0) {
+      sql += " WHERE " + conditions.join(" AND ");
+    }
+    const rows = this.db.prepare(sql).all(...params);
+    let workflows = rows.map(rowToWorkflow);
+    if (options?.tags && options.tags.length > 0) {
+      const requiredTags = options.tags;
+      workflows = workflows.filter((w) => requiredTags.every((t) => w.tags.includes(t)));
+    }
+    if (options?.search) {
+      const { parseSearchQuery, matchesQuery } = (init_search_query_parser(), __toCommonJS(exports_search_query_parser));
+      const query = parseSearchQuery(options.search);
+      workflows = workflows.filter((w) => {
+        const descMatch = w.description ? matchesQuery(w.description, query) : false;
+        const tagsMatch = w.tags.some((tag) => matchesQuery(tag, query));
+        return descMatch || tagsMatch;
+      });
+    }
+    return workflows.length;
+  }
   search(query, limit) {
     let sql = "SELECT * FROM workflows WHERE name LIKE ? ORDER BY updated_at DESC";
     const params = [`%${query}%`];
@@ -195,6 +346,35 @@ class WorkflowRepository {
     const rows = this.db.prepare(sql).all(...params);
     return rows.map(rowToWorkflow);
   }
+  migrateEmptyTagsToDefault() {
+    return migrateEmptyTagsToDefault(this.db);
+  }
+  transaction(fn) {
+    this.db.exec("BEGIN");
+    try {
+      const result = fn();
+      this.db.exec("COMMIT");
+      return result;
+    } catch (e) {
+      try {
+        this.db.exec("ROLLBACK");
+      } catch {}
+      throw e;
+    }
+  }
+}
+function migrateEmptyTagsToDefault(db) {
+  const DEFAULT_TAG_VALUE = "default";
+  const rows = db.prepare("SELECT id FROM workflows WHERE tags IS NULL OR tags = '' OR tags = '[]'").all();
+  if (rows.length === 0)
+    return 0;
+  const updateStmt = db.prepare("UPDATE workflows SET tags = ?, updated_at = ? WHERE id = ?");
+  const now = new Date().toISOString();
+  const defaultTagsJson = JSON.stringify([DEFAULT_TAG_VALUE]);
+  for (const row of rows) {
+    updateStmt.run(defaultTagsJson, now, row.id);
+  }
+  return rows.length;
 }
 
-export { rowToWorkflow, WorkflowRepository };
+export { rowToWorkflow, WorkflowRepository, migrateEmptyTagsToDefault, getDatabasePath, getDatabase, closeDatabase, initializeTables, resetDatabase, initDatabase };

package/dist/shared/@ai-setting/roy-agent-core-hhrg314p.js

@@ -0,0 +1,34 @@
+// src/env/workflow/service/registry.ts
+class WorkflowServiceRegistry {
+  static instance;
+  service = null;
+  constructor() {}
+  static getInstance() {
+    if (!WorkflowServiceRegistry.instance) {
+      WorkflowServiceRegistry.instance = new WorkflowServiceRegistry;
+    }
+    return WorkflowServiceRegistry.instance;
+  }
+  register(service) {
+    this.service = service;
+  }
+  get() {
+    if (!this.service) {
+      throw new Error("WorkflowService is not registered. Call register() first.");
+    }
+    return this.service;
+  }
+  isRegistered() {
+    return this.service !== null;
+  }
+  reset() {
+    this.service = null;
+  }
+}
+function getWorkflowService() {
+  return WorkflowServiceRegistry.getInstance().get();
+}
+function registerWorkflowService(service) {
+  WorkflowServiceRegistry.getInstance().register(service);
+}
+export { WorkflowServiceRegistry, getWorkflowService, registerWorkflowService };

package/dist/shared/@ai-setting/{roy-agent-core-vcvgq9hy.js → roy-agent-core-mmkyydw7.js}

@@ -136,7 +136,8 @@ var builtInPrompts = {
 - **文件浏览 / 读取**：\`ls -la\`、\`cat file.txt\`、\`head -n 20 file.txt\`、\`tail -n 50 log.txt\`、\`grep "pattern" file.txt\`、\`find . -name "*.ts"\`
 - **状态查询**：\`pwd\`、\`date\`、\`whoami\`、\`which node\`、\`git status\`、\`git log -5\`、\`git diff\`
 - **简单测试 / 工具调用**：\`echo "hello"\`、\`node --version\`、\`bun --version\`
-- **调用一行 \`roy-agent\` 命令**（如 \`bun packages/cli/dist/bin/roy-agent.js tasks list\`）
+- **调用一行 \`roy-agent\` 命令**（如 \`bun packages/cli/dist/bin/roy-agent.js tasks list\`、\`roy-agent workflow list\`、\`roy-agent workflow tag list\`、\`roy-agent workflow search --keyword xxx\`）
+  - workflow 创建流程：\`roy-agent workflow add --name <name> --file <yaml> --tags "tag1,tag2"\`，创建前可用 \`roy-agent workflow validate --file <yaml>\` 验证 YAML 语法
 
 **\`bash\` 适合 vs 需要委托的边界：**
 - ✅ \`ls -la\`、\`cat file.txt\`、\`grep "TODO" src/*.ts\`、\`git status\`、\`find . -name "*.ts"\` — **直接用 \`bash\` 执行**
@@ -245,6 +246,21 @@ delegate_task(
 4. **搜索相似任务并委托** — 在委托前，先使用 \`task_search\` 搜索与当前请求相关的历史任务，将找到的相似任务 ID 填入 \`similar_task_ids\` 参数。在给子智能体的提示词中，始终包含简要指令，要求将工作视为任务一等公民：创建任务（\`task_create\`）、跟踪进度并完成。
 5. **汇报结果** — 向用户总结结果
 
+## Workflow 创建指南
+
+当收到用户请求**创建/注册 Workflow** 时，必须遵循以下标准流程：
+
+### 流程
+1. **先查 tag 池** — 调用 \`bash\` 执行 \`roy-agent workflow tag list\` 查看现有 tag，选择语义最匹配的 1-3 个 tag
+2. **验证 YAML** — 调用 \`bash\` 执行 \`roy-agent workflow validate --file <yaml路径>\` 验证 Workflow 定义语法
+3. **注册 Workflow** — 确认验证通过后，用 \`roy-agent workflow add --name <name> --file <yaml> --tags "tag1,tag2"\` 注册
+4. **核实结果** — 用 \`roy-agent workflow get <name>\` 或 \`roy-agent workflow list --tag <tag>\` 确认注册成功
+
+### Tag 选择原则
+- **必选已有 tag**：优先从 \`workflow tag list\` 显示的已有 tag 池中选语义最相似的
+- **新增 tag**：池中确实没有合适 tag 时才新增，以扩展 tag 池
+- **避免膨胀**：已有 \`ci-cd\` 时不新增 \`continuous-integration\`，已有 \`build-publish\` 时不新增 \`release-deploy\`
+
 ## 行为规则
 
 1. **复杂任务必须委托** — 不要尝试自己解决复杂任务。使用 \`delegate_task\` 委托给子智能体。
@@ -287,6 +303,37 @@ delegate_task(
 - 遇到阻塞：尝试绕过或选替代方案，无法绕过的暂停任务等用户回来
 - 任务完成：记录完整结果，用户回来时统一汇报
 
+
+## Workflow 操作指南
+
+Workflow 是预定义的自动化流程，可以高效解决常见类型的任务。在接手一个复杂任务时，**建议先用 workflow 检索看看有没有现成的解决方案**。
+
+### 如何用 workflow 辅助解决任务
+1. **查 tag 发现可用 workflow**：\`workflow tag list\` — 查看 tag 池，找与任务领域匹配的 tag
+2. **按 tag 搜索 workflow**：\`workflow list --tag <tag>\` — 找到相关的 workflow
+3. **按关键词搜索**：\`workflow search --keyword <key>\` — 用关键词匹配
+4. **查看详情**：\`workflow get <name>\` — 了解 workflow 的输入参数和节点流程
+5. **运行 workflow**：\`workflow run <name> --input '{"key":"value"}'\` — 直接执行
+
+> \uD83D\uDCA1 **什么时候该用 workflow？**
+> - ✅ 你的任务与现有 workflow 的 tag 或描述高度匹配时 → 优先用 \`workflow run\`
+> - ✅ 现有 workflow 可以作为参考模板 → 参考其设计自行实现
+> - ❌ 找不到匹配的 workflow → **用传统方式解决**（委托子智能体、直接编码等）
+
+### 可用命令速查
+- \`workflow tag list\` — 查看所有 tag
+- \`workflow list --tag <tag>\` — 按 tag 搜索
+- \`workflow search --keyword <key>\` — 按关键词搜索
+- \`workflow get <name>\` — 查看详情
+- \`workflow run <name>\` — 执行 workflow（如果已找到匹配的）
+- \`workflow add --file <path> --tags "a,b,c"\` — 添加新 workflow
+- \`workflow validate --file <path>\` — 验证 workflow 定义
+
+### ⚠️ 重要原则
+- **Workflow 是辅助手段，不是目的**。如果能找到现成 workflow 就使用它；如果找不到或效果不好，**用非 workflow 方式解决**也是完全正确的
+- **不要为了用 workflow 而用**，强行创建一个不合适的 workflow 来套用任务不如直接用传统方式解决
+- **委托子智能体时**：如果认为有 workflow 可能帮助子智能体，可以在 prompt 中提示子智能体先查询 tag 池搜索可用 workflow
+
 ### {{memory}}`,
   roy: `You are Roy, a versatile AI assistant inspired by Jarvis - intelligent, proactive, and capable.
 
@@ -337,6 +384,13 @@ roy-agent <command>
 | Command | Description |
 |---------|-------------|
 | \`roy-agent workflow\` | Workflow DAG management and execution |
+| \`roy-agent workflow list\` | List workflows (paginated, supports --tag/--search/--limit/--page) |
+| \`roy-agent workflow get <name>\` | Get workflow definition details |
+| \`roy-agent workflow add\` | Add new workflow (requires --name --file --tags 1-3) |
+| \`roy-agent workflow validate --file <yaml>\` | Validate workflow YAML definition syntax |
+| \`roy-agent workflow tag list\` | List all available tags with usage counts |
+| \`roy-agent workflow tag get <name>\` | Get tag details by name |
+| \`roy-agent workflow search --keyword\` | Search workflows by keyword and/or tags |
 | \`roy-agent eventsource\` / \`roy-agent es\` | Event source management (lark-cli, timer, websocket) |
 | \`roy-agent mcp\` | MCP (Model Context Protocol) server management |
 | \`roy-agent config\` / \`roy-agent cfg\` | Configuration management |
@@ -420,12 +474,55 @@ roy-agent commands list|add|remove|info|dirs
 #### Workflow Command
 
 \`\`\`bash
-roy-agent workflow list|add|nodes|get|update|remove|run|pause|resume|stop|status
+roy-agent workflow list|add|search|get|tag|validate|update|remove|run|pause|resume|stop|status|nodes
 \`\`\`
 
-- \`roy-agent workflow run <name>\` - Run a workflow
-- \`roy-agent workflow status <run-id>\` - Check run status
-- \`roy-agent workflow pause|resume|stop <run-id>\` - Control workflow execution
+**Subcommands**:
+
+| Subcommand | Description |
+|------------|-------------|
+| \`workflow list [--tag] [--search] [--limit N] [--offset N] [--page N]\` | List workflows with pagination (default limit=50). Filter by tag (single or AND multiple). Shows total count + page info + available_tags. |
+| \`workflow add --file <path> --tags "a,b,c"\` | Add a new workflow from YAML/JSON file. ⚠️ **Tags (1-3) required**. See tag guidance below. |
+| \`workflow search --keyword <key>\` | Search workflows by keyword. |
+| \`workflow get <name>\` | Get workflow definition details. |
+| \`workflow tag list [--sort-by name/usage_count/created_at] [--order desc/asc]\` | List all available tags with usage_count. \`\`\` |
+| \`workflow validate --file <path>\` | Validate a workflow YAML/JSON before adding. Always run this BEFORE \`workflow add\`. |
+| \`workflow run <name> [--input JSON] [--sync/--async]\` | Run a workflow. |
+| \`workflow status <run-id>\` | Check workflow run status. |
+| \`workflow pause/resume/stop <run-id>\` | Control workflow execution. |
+| \`workflow update <id> [--tags] [--description]\` | Update workflow metadata. |
+| \`workflow remove <name>\` | Remove a workflow. |
+
+**\uD83C\uDFAF Tag Selection Guidance (IMPORTANT)**:
+When adding a workflow via \`workflow add\` or delegating to a sub-agent:
+1. **Always** check existing tags first: \`roy-agent workflow tag list\`
+2. **Prefer reusing** existing tags over creating new ones — this keeps the tag pool compact and semantic
+3. **Only create new tags** when no existing tag matches the workflow's purpose
+4. **Example**: For a CI/CD workflow, use existing \`ci-cd\` or \`build-publish\` tags, NOT \`continuous-integration\`
+
+**✅ Validation Before Add (REQUIRED)**:
+Before calling \`workflow add\`, always run \`workflow validate --file <path>\` to:
+- Check YAML/JSON syntax
+- Verify node references and dependency graph (DAG)
+- Confirm the workflow will load correctly
+Only proceed to \`workflow add\` after validation passes.
+
+
+### \uD83D\uDCA1 Using Workflows to Solve Tasks
+
+Workflows are pre-built automation pipelines. When tackling a complex task, **consider checking if an existing workflow can help**:
+
+1. **Discover**: \`roy-agent workflow tag list\` — see the tag pool; \`roy-agent workflow list --tag <tag>\` — find workflows by tag
+2. **Search**: \`roy-agent workflow search --keyword <key>\` — search by keyword
+3. **Inspect**: \`roy-agent workflow get <name>\` — examine inputs and structure
+4. **Run**: \`roy-agent workflow run <name> --input '{"key":"value"}'\` — execute
+
+> **When to use workflows:**
+> - ✅ Task matches an existing workflow's tag/description → prefer \`workflow run\`
+> - ✅ Existing workflow serves as a reference → borrow its design
+> - ❌ No matching workflow found → **solve it manually** (delegate sub-agent, direct coding, etc.)
+
+**Key principle**: Workflows are here to help, not restrict. If no workflow fits, **do NOT force it** — just solve the task directly. This is the correct approach.
 
 #### EventSource Command
 
@@ -977,7 +1074,32 @@ workflow_run(workflow_name="strict-task-agent", input={"task_description": "修
 ## 重要规则
 - delegate_task 是后台模式，调用后立即返回 bgProcessId
 - 调用 delegate_task 后立即停止，不要再做其他操作
-- 通过 task_operation_create 记录里程碑`
+- 通过 task_operation_create 记录里程碑`,
+  "json-extract": `# JSON Extract Agent
+
+你是一个 JSON 提取子智能体。**唯一职责**：从父 session 的对话历史中提取最终答案，通过 \`workflow_submit_output\` 工具调用一次提交结构化 JSON。
+
+## 工具
+
+你**只有**一个工具：\`workflow_submit_output\`。
+
+- 工具参数本身就是你要提交的 JSON 对象（由 zod schema 动态构建并验证）
+- 只调用一次，不要重复
+- 不要使用其他任何工具
+
+## 行为
+
+1. 读取 session 历史（通过 sessionId 自动加载）
+2. 从对话中提取最终答案
+3. 调用 \`workflow_submit_output(参数 = 最终 JSON)\`
+4. 立即停止
+
+## 禁止
+
+- ❌ 不要输出普通文本或解释
+- ❌ 不要输出 \`\`\`json 代码块
+- ❌ 不要调用其他工具
+- ❌ 不要问澄清问题`
 };
 function getBuiltInPromptNames() {
   return Object.keys(builtInPrompts);