@ai-setting/roy-agent-core 1.5.81 → 1.5.84

package/dist/shared/@ai-setting/{roy-agent-core-w83v54mj.js → roy-agent-core-7fdzfsm6.js}

@@ -369,11 +369,11 @@ ${prompt}`;
     }
     if (!this._workflowRepo) {
       try {
-        const sqlite = await import("./roy-agent-core-74cp3zp1.js");
+        const sqlite = await import("./roy-agent-core-taxvytzz.js");
         this.ensureDataDir();
         const db = sqlite.getDatabase();
         sqlite.initializeTables();
-        const { WorkflowRepository } = await import("./roy-agent-core-am646wfz.js");
+        const { WorkflowRepository } = await import("./roy-agent-core-86d4exyf.js");
         this._workflowRepo = new WorkflowRepository(db);
         return this._workflowRepo;
       } catch {
@@ -393,67 +393,11 @@ init_logger();
 init_decorator();
 var logger2 = createLogger("AutoTaskPlugin");
 function createAutoTaskPlugin(config) {
-  const threshold = config?.threshold ?? 30;
+  const threshold = config?.threshold ?? 20;
   const agentName = config?.agentName ?? "default";
-  const llmRef = config?.llmComponent ?? null;
-  const toolRef = config?.toolComponent ?? null;
-  const toolChoiceModel = config?.model;
-  const subagentType = config?.subagentType ?? "roy";
+  const agentComponent = config?.agentComponent ?? null;
+  const subagentType = config?.subagentType ?? "task-agent";
   let lastProcessedTraceId = "";
-  let cachedDelegateToolInfo = undefined;
-  function getDelegateToolInfoImpl() {
-    if (cachedDelegateToolInfo !== undefined)
-      return cachedDelegateToolInfo;
-    if (!toolRef || typeof toolRef.getTool !== "function") {
-      cachedDelegateToolInfo = null;
-      return null;
-    }
-    const tool = toolRef.getTool("delegate_task");
-    if (!tool) {
-      cachedDelegateToolInfo = null;
-      return null;
-    }
-    cachedDelegateToolInfo = {
-      name: tool.name,
-      description: tool.description || "",
-      parameters: tool.parameters ?? {}
-    };
-    return cachedDelegateToolInfo;
-  }
-  const getDelegateToolInfo = wrapFunction(getDelegateToolInfoImpl, "plugin.auto-task.get-tool-info", { recordParams: false, recordResult: true, log: true });
-  async function tryInvokeForDelegateImpl(msgs, delegateToolInfo, model, sid) {
-    const result = await llmRef.invoke({
-      messages: msgs,
-      tools: [delegateToolInfo],
-      model,
-      context: { sessionId: sid },
-      skipThresholdCheck: true
-    });
-    const toolCalls = result?.output?.toolCalls;
-    if (!toolCalls || toolCalls.length === 0) {
-      logger2.warn(`[AutoTaskPlugin] LLM returned no toolCalls (session=${sid.slice(0, 12)}...)`);
-      return null;
-    }
-    for (const tc of toolCalls) {
-      const tcName = tc.function?.name ?? tc.name;
-      const rawArgs = tc.function?.arguments ?? tc.arguments;
-      const rawArgsStr = typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs ?? {});
-      logger2.debug(`[AutoTaskPlugin] inspecting toolCall name=${tcName ?? "unknown"}, rawArgs=${rawArgsStr.slice(0, 80)} (session=${sid.slice(0, 12)}...)`);
-      if (tcName !== "delegate_task")
-        continue;
-      try {
-        const args = JSON.parse(typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs ?? {}));
-        if (args.description && args.prompt) {
-          return args;
-        }
-        logger2.warn(`[AutoTaskPlugin] delegate_task args missing required fields: ${JSON.stringify(args).slice(0, 100)}`);
-      } catch {
-        logger2.warn(`[AutoTaskPlugin] Failed to parse delegate_task args: ${String(rawArgs).slice(0, 100)}`);
-      }
-    }
-    return null;
-  }
-  const tryInvokeForDelegate = wrapFunction(tryInvokeForDelegateImpl, "plugin.auto-task.invoke-llm", { recordParams: true, recordResult: true, log: true });
   async function executeImpl(ctx) {
     try {
       logger2.debug(`[AutoTaskPlugin] agentName=${ctx.agent.name} (expected=${agentName})`);
@@ -470,90 +414,53 @@ function createAutoTaskPlugin(config) {
       }
       lastProcessedTraceId = traceId;
       logger2.debug(`[AutoTaskPlugin] new query detected (traceId=${traceId.slice(0, 20)}...)`);
-      if (!llmRef || !toolRef) {
-        logger2.warn(`[AutoTaskPlugin] llmComponent or toolComponent not provided at creation (session=${sid.slice(0, 12)}...)`);
-        return { continue: true };
-      }
-      const delegateToolInfo = getDelegateToolInfo();
-      if (!delegateToolInfo) {
-        logger2.warn(`[AutoTaskPlugin] delegate_task tool not found in toolComponent (session=${sid.slice(0, 12)}...)`);
+      if (!agentComponent || typeof agentComponent.run !== "function") {
+        logger2.warn(`[AutoTaskPlugin] agentComponent not provided or invalid (session=${sid.slice(0, 12)}...)`);
         return { continue: true };
       }
-      const msgs = [];
-      for (const m of ctx.messages) {
+      let userQuery = "";
+      for (let i = ctx.messages.length - 1;i >= 0; i--) {
+        const m = ctx.messages[i];
         if (m.role === "user") {
-          msgs.push({
-            role: "user",
-            content: typeof m.content === "string" ? m.content : JSON.stringify(m.content)
-          });
-        } else if (m.role === "assistant") {
-          const text = typeof m.content === "string" ? m.content : "";
-          if (text.trim()) {
-            msgs.push({ role: "assistant", content: text });
-          }
+          userQuery = typeof m.content === "string" ? m.content : JSON.stringify(m.content);
+          break;
         }
       }
-      msgs.push({
-        role: "user",
-        content: `Based on the conversation above, please call \`delegate_task\` to hand off the current work to a sub-agent.
-
-Parameters for delegate_task:
-- description: A short 3-8 word title describing this work
-- prompt: Detailed instructions for the sub-agent to continue the work
-- subagent_type: Use "${subagentType}"
-- similar_task_ids: []
+      if (!userQuery) {
+        userQuery = "分析项目结构并执行相关任务";
+      }
+      logger2.info(`[AutoTaskPlugin] Calling agentComponent.run("${subagentType}") at iteration ${ctx.iteration} (session=${sid.slice(0, 12)}..., persistSession=false)`);
+      const shortDesc = typeof userQuery === "string" ? userQuery.slice(0, 50) : "分析需求";
+      const beforeMsg = `
 
-Call delegate_task now.`
-      });
-      const model = toolChoiceModel ?? ctx.context?.model ?? ctx.agent?.config?.model;
-      logger2.info(`[AutoTaskPlugin] Invoking LLM (model=${model}) for delegate_task args at iteration ${ctx.iteration} (session=${sid.slice(0, 12)}...)`);
-      let args = await tryInvokeForDelegate(msgs, delegateToolInfo, model, sid);
-      if (!args) {
-        logger2.info(`[AutoTaskPlugin] Retrying with alternative prompt (session=${sid.slice(0, 12)}...)`);
-        const retryMsgs = [
-          ...msgs,
-          {
-            role: "user",
-            content: `Please call \`delegate_task\` now with description (short title), prompt (detailed instructions), subagent_type="${subagentType}", and similar_task_ids=[].`
-          }
-        ];
-        args = await tryInvokeForDelegate(retryMsgs, delegateToolInfo, model, sid);
+---
+⏳ **${subagentType} 正在执行**: ${shortDesc}（等待结果...）`;
+      if (ctx.toolResult?.result?.output !== undefined) {
+        ctx.toolResult.result.output += beforeMsg;
       }
-      if (!args) {
-        logger2.warn(`[AutoTaskPlugin] Failed to get delegate_task args after retry (session=${sid.slice(0, 12)}...)`);
-        return { continue: true };
+      let taskAgentFinalText = "";
+      try {
+        const taskAgentResult = await agentComponent.run(subagentType, userQuery, {
+          sessionId: sid,
+          traceId,
+          persistSession: false
+        });
+        taskAgentFinalText = taskAgentResult?.finalText || "";
+        logger2.info(`[AutoTaskPlugin] task-agent completed (session=${sid.slice(0, 12)}..., finalTextLength=${taskAgentFinalText.length})`);
+      } catch (err) {
+        logger2.error(`[AutoTaskPlugin] task-agent failed: ${err instanceof Error ? err.message : String(err)}`);
+        taskAgentFinalText = `❌ **${subagentType} 执行失败**: ${err instanceof Error ? err.message : String(err)}`;
       }
-      logger2.info(`[AutoTaskPlugin] LLM generated delegate_task args: description="${String(args.description).slice(0, 50)}", subagent_type=${args.subagent_type}`);
-      const execResult = await toolRef.execute({
-        name: "delegate_task",
-        args: {
-          description: args.description,
-          prompt: args.prompt,
-          subagent_type: args.subagent_type || subagentType,
-          similar_task_ids: args.similar_task_ids || []
-        },
-        context: {
-          session_id: sid,
-          agent: ctx.agent.name
-        },
-        skipHooks: true
-      });
-      if (execResult.success && ctx.toolResult?.result?.output !== undefined) {
-        const bgProcessId = execResult.result?.bgProcessId ?? "unknown";
+      if (taskAgentFinalText && ctx.toolResult?.result?.output !== undefined) {
         const injection = `
 
 ---
-\uD83D\uDE80 **Task Delegated**: 已通过 delegate_task 委托给子 agent（${subagentType}）在后台运行。
-
-⏳ 请等待后台任务运行结果通知，无需额外操作。
-
-\uD83D\uDCCB 后台进程 ID: \`${bgProcessId}\`
+${taskAgentFinalText}
 ---`;
         ctx.toolResult.result.output += injection;
-        logger2.info(`[AutoTaskPlugin] delegate_task called (bgProcessId=${bgProcessId}, session=${sid.slice(0, 12)}...)`);
-      } else {
-        const errMsg = execResult?.output || execResult?.error || "unknown error";
-        logger2.warn(`[AutoTaskPlugin] delegate_task execution failed: success=${execResult?.success}, error=${String(errMsg).slice(0, 200)}`);
+        logger2.info(`[AutoTaskPlugin] task-agent finalText injected (session=${sid.slice(0, 12)}...)`);
+      } else if (!ctx.toolResult?.result?.output) {
+        logger2.warn(`[AutoTaskPlugin] toolResult unavailable for injection`);
       }
       return { continue: true };
     } catch (err) {
@@ -561,15 +468,15 @@ Call delegate_task now.`
       return { continue: true };
     }
   }
-  const execute = wrapFunction(executeImpl, "plugin.auto-task.tool-call-hook", {
+  const execute = wrapFunction(executeImpl, "plugin.auto-task.launch-agent", {
     recordParams: false,
     recordResult: true,
     log: true
   });
   return {
     name: "AutoTaskPlugin",
-    version: "3.0.0",
-    description: "ReAct iteration 达到阈值时通过 LLM 生成 delegate_task 入参并直接调用",
+    version: "4.5.0",
+    description: "ReAct iteration 达到阈值时 await task-agent 执行并提取 delegate_task 结果注入 tool result",
     hooks: [
       { point: "agent:after.tool", priority: 50 }
     ],

package/dist/shared/@ai-setting/{roy-agent-core-df3ng0pz.js → roy-agent-core-7nh5h9fn.js}

@@ -66,7 +66,8 @@ var UpdateTaskToolSchema = z.object({
   due_date: z.string().optional(),
   tags: z.array(z.string()).optional(),
   project_path: z.string().optional().describe("Project path, identifies which project this task belongs to"),
-  context: z.string().optional().describe("Task context information for storing additional context")
+  context: z.string().optional().describe("Task context information for storing additional context"),
+  parent_task_id: z.union([z.number(), z.null()]).optional().describe("Parent task ID (set to null to make it a root task)")
 });
 var DeleteTaskToolSchema = z.object({
   task_id: z.number().describe("Task ID")
@@ -446,6 +447,22 @@ function batchDeleteTaskTool(taskComponent) {
 init_env_context();
 init_logger();
 var logger2 = createLogger("tool:update-task");
+async function detectCycle(taskComponent, taskId, newParentId) {
+  const visited = new Set;
+  let currentId = newParentId;
+  while (currentId !== null && currentId !== undefined) {
+    if (currentId === taskId)
+      return true;
+    if (visited.has(currentId))
+      break;
+    visited.add(currentId);
+    const currentTask = await taskComponent.getTask(currentId);
+    if (!currentTask)
+      break;
+    currentId = currentTask.parent_task_id;
+  }
+  return false;
+}
 function updateTaskTool(taskComponent) {
   return {
     name: "task_update",
@@ -455,6 +472,17 @@ function updateTaskTool(taskComponent) {
       const params = UpdateTaskToolSchema.parse(args);
       const sessionId = ctx.session_id || "unknown";
       try {
+        if (params.parent_task_id !== undefined && params.parent_task_id !== null) {
+          const hasCycle = await detectCycle(taskComponent, params.task_id, params.parent_task_id);
+          if (hasCycle) {
+            return {
+              success: false,
+              output: "",
+              error: `Circular reference detected: setting parent_task_id to ${params.parent_task_id} for task #${params.task_id} would create a cycle`,
+              metadata: { execution_time_ms: 0 }
+            };
+          }
+        }
         const task = await taskComponent.updateTask(params.task_id, {
           title: params.title,
           description: params.description,
@@ -467,7 +495,8 @@ function updateTaskTool(taskComponent) {
           due_date: params.due_date,
           tags: params.tags,
           project_path: params.project_path,
-          context: params.context
+          context: params.context,
+          parent_task_id: params.parent_task_id
         });
         if (!task) {
           return {

package/dist/shared/@ai-setting/{roy-agent-core-am646wfz.js → roy-agent-core-86d4exyf.js}

@@ -1,14 +1,17 @@
 import {
   WorkflowRepository,
+  migrateEmptyTagsToDefault,
   rowToWorkflow
-} from "./roy-agent-core-496zzm5a.js";
-import"./roy-agent-core-6b57g1zk.js";
+} from "./roy-agent-core-h4h55x4h.js";
+import"./roy-agent-core-3sv590cv.js";
 import"./roy-agent-core-rvxg1wps.js";
+import"./roy-agent-core-k05v31rc.js";
 import"./roy-agent-core-shme7set.js";
 import"./roy-agent-core-7z9b1fm8.js";
 import"./roy-agent-core-c6592r3c.js";
 import"./roy-agent-core-fs0mn2jk.js";
 export {
   rowToWorkflow,
+  migrateEmptyTagsToDefault,
   WorkflowRepository
 };

package/dist/shared/@ai-setting/{roy-agent-core-vgyj2rq9.js → roy-agent-core-akepggsr.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
 
@@ -930,7 +1027,54 @@ workflow_run(workflow_name="strict-task-agent", input={"task_description": "修
 >
 > 设计文档：.roy/design/2026-06-29-workflow-subagent-entry-agent-design.md
 
-记住：你是 workflow 的"调度员"，不是 workflow 本身。`
+记住：你是 workflow 的"调度员"，不是 workflow 本身。`,
+  "task-agent": `# Task Agent — 任务优先智能体
+
+## 你的身份
+当主 agent（default）在 ReAct 循环中达到迭代阈值时，你被调用。你的职责：
+1. 分析对话历史，理解用户需求
+2. task_create 创建任务
+3. task_search 搜索相似任务
+4. delegate_task 委托给 roy
+
+## 工作目录
+
+**workspace_dir**: {{workspace_dir}}
+
+## 可用工具（全部 task 工具 + delegate_task + bash）
+
+### 任务查询工具
+- task_search(keywords=[...]) — 搜索相关任务（返回任务 ID 列表，用于 similar_task_ids）
+- task_get(task_id=123) — 查看任务详情
+- task_list(status="active") — 列出任务
+- task_operation_list(task_id=123) — 查看操作记录
+
+### 任务生命周期工具
+- task_create(title=..., description=..., progress=0, status="active") — 创建新任务
+- task_update(task_id=..., ...) — 更新任务状态
+- task_operation_create(task_id=..., ...) — 记录操作记录
+- task_complete(task_id=...) — 完成任务
+
+### 执行工具
+- delegate_task(description=..., prompt=..., subagent_type="roy", similar_task_ids=[...]) — 委托给子 agent
+- bash(command=...) — 执行 shell 命令
+
+## 工作流程（严格执行）
+1. **分析对话** → 理解用户到底需要做什么
+2. **task_create** → 创建任务（title 简短 3-8 字，description 详细，progress=0, status="active"）
+3. **task_operation_create** → 记录"任务已创建，开始搜索相似任务"里程碑
+4. **task_search** → 搜索相似任务获取 similar_task_ids
+5. **task_get** → 获取相似任务详情（可选，最多 3 个）
+6. **delegate_task** → 委托给 roy：
+   - description: 简短标题（3-8 字）
+   - prompt: 详细的委托指令，包含用户原始需求
+   - subagent_type: "roy"
+   - similar_task_ids: 真实搜索到的 ID 列表（最多 3 个）
+
+## 重要规则
+- delegate_task 是后台模式，调用后立即返回 bgProcessId
+- 调用 delegate_task 后立即停止，不要再做其他操作
+- 通过 task_operation_create 记录里程碑`
 };
 function getBuiltInPromptNames() {
   return Object.keys(builtInPrompts);

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

@@ -7,17 +7,20 @@ import {
   exports_engine,
   init_engine
 } from "./roy-agent-core-6b0r2e7j.js";
-import {
-  WorkflowService
-} from "./roy-agent-core-4t40mkpv.js";
 import {
   askUserTool,
   createRunWorkflowTool,
+  createWorkflowAddTool,
   createWorkflowGetTool,
   createWorkflowListTool,
   createWorkflowRunStatusTool,
-  createWorkflowRunStopTool
-} from "./roy-agent-core-a6j7g1qe.js";
+  createWorkflowRunStopTool,
+  createWorkflowSearchTool,
+  createWorkflowTagListTool
+} from "./roy-agent-core-r5axf0ad.js";
+import {
+  WorkflowService
+} from "./roy-agent-core-tq9528d3.js";
 import {
   BaseComponent
 } from "./roy-agent-core-rgckng3p.js";
@@ -128,7 +131,7 @@ class WorkflowComponent extends BaseComponent {
       registerDecoratorNodeType2(registry);
       return new WorkflowEngine2(registry, sessionComponentForEngine, options.workflowRepository);
     };
-    this.workflowService = new WorkflowService(options.workflowRepository, engineFactory, options.sessionComponent);
+    this.workflowService = new WorkflowService(options.workflowRepository, engineFactory, options.sessionComponent, options.tagRepository);
     return this.workflowService;
   }
   async runWorkflow(definition, input, options) {
@@ -164,7 +167,7 @@ class WorkflowComponent extends BaseComponent {
     if (this.workflowService) {
       this.workflowService = null;
       try {
-        const { closeDatabase } = await import("./roy-agent-core-74cp3zp1.js");
+        const { closeDatabase } = await import("./roy-agent-core-taxvytzz.js");
         closeDatabase();
         componentLogger.info("[WorkflowComponent] SQLite database closed");
       } catch (error) {
@@ -214,6 +217,9 @@ class WorkflowComponent extends BaseComponent {
       const tools = [
         createWorkflowGetTool(this.workflowService),
         createWorkflowListTool(this.workflowService),
+        createWorkflowAddTool(this.workflowService),
+        createWorkflowSearchTool(this.workflowService),
+        createWorkflowTagListTool(this.workflowService),
         createRunWorkflowTool(this.workflowService),
         createWorkflowRunStatusTool(this.workflowService),
         createWorkflowRunStopTool(this.workflowService)
@@ -228,11 +234,13 @@ class WorkflowComponent extends BaseComponent {
   }
   async initSqliteService() {
     try {
-      const { getDatabase, initializeTables } = await import("./roy-agent-core-74cp3zp1.js");
-      const { WorkflowRepository } = await import("./roy-agent-core-am646wfz.js");
+      const { getDatabase, initializeTables } = await import("./roy-agent-core-taxvytzz.js");
+      const { WorkflowRepository } = await import("./roy-agent-core-86d4exyf.js");
+      const { TagRepository } = await import("./roy-agent-core-c67wr8sp.js");
       const db = getDatabase();
       initializeTables();
       const workflowRepository = new WorkflowRepository(db);
+      const tagRepository = new TagRepository(db);
       const toolComponent = this.toolComponent || this._workflowEnv?.getComponent("tool");
       const llmComponent = this.llmComponent || this._workflowEnv?.getComponent("llm");
       const agentComponent = this._workflowEnv?.getComponent("agent");
@@ -245,6 +253,7 @@ class WorkflowComponent extends BaseComponent {
       }
       this.createService({
         workflowRepository,
+        tagRepository,
         toolComponent,
         llmComponent,
         env: this._workflowEnv,
@@ -299,7 +308,7 @@ class WorkflowComponent extends BaseComponent {
     this.workflowService = null;
     this.nodeRegistry = null;
     try {
-      const { closeDatabase } = await import("./roy-agent-core-74cp3zp1.js");
+      const { closeDatabase } = await import("./roy-agent-core-taxvytzz.js");
       closeDatabase();
     } catch {}
     this._status = "stopped";

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

@@ -0,0 +1,11 @@
+import {
+  TagRepository
+} from "./roy-agent-core-3sv590cv.js";
+import"./roy-agent-core-k05v31rc.js";
+import"./roy-agent-core-shme7set.js";
+import"./roy-agent-core-7z9b1fm8.js";
+import"./roy-agent-core-c6592r3c.js";
+import"./roy-agent-core-fs0mn2jk.js";
+export {
+  TagRepository
+};