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

package/dist/shared/@ai-setting/{roy-agent-core-4ws3w7cx.js → roy-agent-core-qbgd7bp6.js}

@@ -7,7 +7,7 @@ import {
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-zf62vkc4.js";
+} from "./roy-agent-core-mbre4fxg.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";
@@ -299,6 +299,8 @@ class AgentComponent extends BaseComponent {
       });
       const loadedCount = await this.registry.load();
       logger.info(`[AgentComponent] Loaded ${loadedCount} agents from config directory`);
+      this.registry.registerWorkflowAgent();
+      logger.info("[AgentComponent] Registered built-in workflow-agent");
       for (const agentDef of this.registry.list()) {
         if (!this.agents.has(agentDef.name)) {
           const systemPrompt = await this.registry.getSystemPrompt(agentDef.name);
@@ -550,6 +552,7 @@ class AgentComponent extends BaseComponent {
       ...context,
       agentType: agent.config.type,
       model: context?.model ?? agent.config.model,
+      traceId: context?.metadata?.traceId ?? context?.traceId,
       abort: abortController.signal
     };
     const result = {
@@ -1107,7 +1110,7 @@ ${additionInfo}`
         context: toolContext
       };
       let result;
-      const isLongRunningTool = toolName === "delegate_task" || toolName === "stop_task" || toolName === "bash";
+      const isLongRunningTool = toolName === "delegate_task" || toolName === "stop_task" || toolName === "bash" || toolName === "workflow_run" || toolName === "run-workflow";
       const isExtraTool = this.toolComponent?.getTool ? !this.toolComponent.getTool(toolName) : false;
       if (isExtraTool) {
         logger.debug(`[executeTool] Tool "${toolName}" is an extraTool, executing directly`);

package/dist/shared/@ai-setting/{roy-agent-core-8x1gmqcv.js → roy-agent-core-t2q0rwt7.js}

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-n9tw52zb.js";
+} from "./roy-agent-core-w83v54mj.js";
 import {
   ContextError,
   ErrorCodes
@@ -198,11 +198,12 @@ class BaseEnvironment extends BaseComponent {
         const llmRef = this.getComponent("llm");
         const toolRef = this.getComponent("tool");
         const autoTaskPlugin = createAutoTaskPlugin({
+          threshold: 30,
           llmComponent: llmRef ?? undefined,
           toolComponent: toolRef ?? undefined
         });
         agentComponent.registerPlugin("default", autoTaskPlugin);
-        logger.info("[handle_query] AutoTaskPlugin v3 registered on default agent");
+        logger.info("[handle_query] AutoTaskPlugin v3 registered on default agent (threshold=30)");
       } catch (err) {
         logger.warn(`[handle_query] Failed to register AutoTaskPlugin: ${err}`);
       }

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-vgyj2rq9.js}

@@ -828,7 +828,109 @@ 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 本身。`
 };
 function getBuiltInPromptNames() {
   return Object.keys(builtInPrompts);

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

@@ -436,9 +436,11 @@ function createAutoTaskPlugin(config) {
     }
     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;
-      const rawArgs = tc.function?.arguments ?? tc.arguments;
       try {
         const args = JSON.parse(typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs ?? {}));
         if (args.description && args.prompt) {
@@ -508,11 +510,14 @@ Call delegate_task now.`
       let args = await tryInvokeForDelegate(msgs, delegateToolInfo, model, sid);
       if (!args) {
         logger2.info(`[AutoTaskPlugin] Retrying with alternative prompt (session=${sid.slice(0, 12)}...)`);
-        msgs.push({
-          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(msgs, delegateToolInfo, model, sid);
+        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);
       }
       if (!args) {
         logger2.warn(`[AutoTaskPlugin] Failed to get delegate_task args after retry (session=${sid.slice(0, 12)}...)`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.5.79",
+  "version": "1.5.81",
   "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 };