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

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

@@ -6,13 +6,18 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-jazhr292.js";
+} from "./roy-agent-core-6b0r2e7j.js";
 import {
   WorkflowService
 } from "./roy-agent-core-4t40mkpv.js";
 import {
-  askUserTool
-} from "./roy-agent-core-0vbdz0x7.js";
+  askUserTool,
+  createRunWorkflowTool,
+  createWorkflowGetTool,
+  createWorkflowListTool,
+  createWorkflowRunStatusTool,
+  createWorkflowRunStopTool
+} from "./roy-agent-core-a6j7g1qe.js";
 import {
   BaseComponent
 } from "./roy-agent-core-rgckng3p.js";
@@ -173,6 +178,7 @@ class WorkflowComponent extends BaseComponent {
     await super.start();
     await this.initSqliteService();
     await this.registerAskUserTool();
+    await this.registerWorkflowTools();
   }
   async registerAskUserTool() {
     try {
@@ -194,6 +200,32 @@ class WorkflowComponent extends BaseComponent {
       componentLogger.warn("Failed to register ask_user tool:", error);
     }
   }
+  async registerWorkflowTools() {
+    if (!this.workflowService) {
+      componentLogger.warn("WorkflowService not initialized, cannot register workflow tools");
+      return;
+    }
+    try {
+      const toolComponent = this.toolComponent || this._workflowEnv?.getComponent("tool");
+      if (!toolComponent) {
+        componentLogger.warn("ToolComponent not available, cannot register workflow tools");
+        return;
+      }
+      const tools = [
+        createWorkflowGetTool(this.workflowService),
+        createWorkflowListTool(this.workflowService),
+        createRunWorkflowTool(this.workflowService),
+        createWorkflowRunStatusTool(this.workflowService),
+        createWorkflowRunStopTool(this.workflowService)
+      ];
+      for (const tool of tools) {
+        toolComponent.register(tool);
+        componentLogger.info(`[WorkflowComponent] Registered workflow tool: ${tool.name}`);
+      }
+    } catch (error) {
+      componentLogger.warn("Failed to register workflow tools:", error);
+    }
+  }
   async initSqliteService() {
     try {
       const { getDatabase, initializeTables } = await import("./roy-agent-core-74cp3zp1.js");

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

@@ -828,7 +828,156 @@ When reusing an existing task, you MUST follow these rules:
 
 # 输出要求
 直接调用 record_memory 工具，写入新的全局记忆。
-输出格式为 Markdown，保持结构清晰。`
+输出格式为 Markdown，保持结构清晰。`,
+  "workflow-agent": `# Workflow 调度中介（Workflow Dispatch Mediator）
+
+## 你的身份
+
+你是 Roy 系统的 workflow 调度中介（entry-agent）。当 \`delegate_task\` 收到一个 workflow 类型的子智能体请求时，你被自动调用，负责将请求转交给合适的 workflow 执行。
+
+- **类型**: primary（不是 subagent，不是 workflow，避免无限递归）
+- **职责**: 仅做 workflow 调度，不做其他任何工作
+- **边界**: 不要执行除 workflow 调度以外的任何任务
+
+## 工作目录
+
+**workspace_dir**: {{workspace_dir}}
+
+## 可用工具
+
+你只有以下 5 个 workflow 相关工具可用：
+
+1. **\`workflow_list\`** — 列出所有已注册的 workflow
+   - 参数：tag（可选），search（可选），limit，offset
+   - 返回值：workflow 列表（名称、版本、描述、标签）
+
+2. **\`workflow_get\`** — 获取 workflow 定义详情
+   - 参数：\`name\`（workflow 名称）或 \`run_id\`（run ID）
+   - 返回值：workflow 定义（名称、版本、描述、入参 inputs schema、节点列表），或 run 的状态
+
+3. **\`workflow_run\`** — 运行 workflow
+   - 参数：\`workflow_name\`（必填），\`input\`（可选 JSON），\`sync\`（是否等待完成，默认 true），\`timeout\`（可选）
+   - 返回值：run_id, status, output, error, duration_ms
+
+4. **\`workflow_run_status\`** — 查询 run 状态
+   - 参数：\`run_id\`（必填）
+   - 返回值：run_id, status, output, error
+
+5. **\`workflow_run_stop\`** — 停止 run
+   - 参数：\`run_id\`（必填），\`reason\`（可选）
+   - 返回值：success 状态
+
+## 核心使命
+
+当被调用时，你会收到：
+
+1. **workflow 名称** — 来自 \`subagent_type\`（例如 \`strict-task-agent\` 对应 workflow \`strict-task-agent\`）
+2. **用户原始 prompt** — 上游 agent 传给 delegate_task 的请求内容
+3. **任务上下文** — session_id、trace_id 等元数据
+
+你的工作流程：
+
+### 步骤 1: 查询 workflow 详情
+
+调用 \`workflow_get\` 工具，传入 workflow 名称，读取其入参 schema。
+
+### 步骤 2: 提取用户输入
+
+从用户原始 prompt 中，**仅**提取符合 schema 的字段，组装为 JSON。
+如果 schema 要求必填字段但用户 prompt 中没有，**不要猜测**——直接 \`workflow_run\` 让 workflow 自己处理默认值或报错。
+
+### 步骤 3: 触发 workflow run
+
+调用 \`workflow_run\` 工具，传入 workflow 名称和 input JSON。
+
+### 步骤 4: 查询状态（如需）
+
+调用 \`workflow_run_status\` 查询执行结果。
+
+### 步骤 5: 返回结果
+
+把 workflow run 的输出原样返回给上游 caller。
+
+## 工作流程示例
+
+\`\`\`
+# 步骤 1: 查看 workflow 入参
+workflow_get(name="strict-task-agent")
+# → 返回 inputs 中包含 task_description (required), priority (optional)
+
+# 步骤 2: 从 prompt 提取 input
+# prompt: "修复登录bug，优先级高"
+# → {"task_description": "修复登录bug", "priority": "high"}
+
+# 步骤 3: 执行 workflow
+workflow_run(workflow_name="strict-task-agent", input={"task_description": "修复登录bug", "priority": "high"})
+# → 返回 run_id, status, output
+\`\`\`
+
+## 严格约束
+
+- ✅ **只**通过 \`workflow_run\` 工具执行 workflow
+- ✅ 先调用 \`workflow_get\` 获取 schema，再调用 \`workflow_run\`
+- ❌ 不要直接读 workflow YAML 文件并尝试自己解释
+- ❌ 不要执行 workflow 调度以外的任何工作（写代码、查文件、做调研、改 bug 都不做）
+- ❌ 不要修改 workflow 定义
+- ❌ 不要使用 \`delegate_task\` 再次委托——你已经是最末端的执行者
+- ❌ 不要使用 \`bash\` 或其他非 workflow 工具——你的工具列表只有 5 个 workflow 工具
+
+## 为什么需要这个中介
+
+> 历史背景：在本次重构之前，\`delegate_task("strict-task-agent")\` 会被当作普通 subagent 直接执行，导致 subagent session 被创建但 workflow 引擎从未启动，session 内容是默认 subagent prompt 而不是 workflow run。本中介模式修复了这个 bug——所有 workflow 类型 subagent 的 delegate_task 都先经过本 agent，再走标准 \`workflow_run\` 路径。
+>
+> 设计文档：.roy/design/2026-06-29-workflow-subagent-entry-agent-design.md
+
+记住：你是 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.5.80",
+  "version": "1.5.83",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",

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

@@ -1,36 +0,0 @@
-import {
-  AskUserError,
-  init_workflow_hil
-} from "./roy-agent-core-e25xkv53.js";
-
-// src/env/workflow/tools/ask-user-tool.ts
-init_workflow_hil();
-import { z } from "zod";
-var AskUserInputSchema = z.object({
-  query: z.string().describe("The question or request to ask the user"),
-  options: z.array(z.string()).optional().describe("Optional choices for the user"),
-  required_confirm: z.boolean().optional().describe("If true, user must explicitly confirm")
-});
-var askUserTool = {
-  name: "ask_user",
-  description: "Ask user for input or confirmation. Use this tool when you need user input or validation to continue the workflow.",
-  parameters: AskUserInputSchema,
-  async execute(args, context) {
-    const runId = context.metadata?.runId || "unknown";
-    const sessionId = context.metadata?.sessionId || `workflow_${runId}`;
-    const nodeId = context.metadata?.nodeId || "unknown";
-    let fullQuery = args.query;
-    if (args.options && args.options.length > 0) {
-      fullQuery = `${args.query} (选项: ${args.options.join(", ")})`;
-    }
-    throw new AskUserError(runId, sessionId, nodeId, "agent", fullQuery);
-  },
-  metadata: {
-    category: "workflow",
-    tags: ["human-in-loop", "user-input"],
-    version: "1.0.0"
-  }
-};
-var askUserToolInstance = askUserTool;
-
-export { AskUserInputSchema, askUserTool, askUserToolInstance };