@ai-setting/roy-agent-core 1.5.75 → 1.5.77

package/dist/env/agent/index.js

@@ -1,7 +1,7 @@
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-w6j4zyps.js";
+} from "../../shared/@ai-setting/roy-agent-core-4s4en7c6.js";
 import"../../shared/@ai-setting/roy-agent-core-r0m0at3x.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-zf62vkc4.js";

package/dist/env/index.js

@@ -21,7 +21,7 @@ import"../shared/@ai-setting/roy-agent-core-r12a2qfv.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-c4hhd1f2.js";
+} from "../shared/@ai-setting/roy-agent-core-vqkzn45t.js";
 import"../shared/@ai-setting/roy-agent-core-fjexv5nm.js";
 import"../shared/@ai-setting/roy-agent-core-4hh4s0w1.js";
 import"../shared/@ai-setting/roy-agent-core-9adgwts7.js";
@@ -39,7 +39,7 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-w6j4zyps.js";
+} from "../shared/@ai-setting/roy-agent-core-4s4en7c6.js";
 import"../shared/@ai-setting/roy-agent-core-r0m0at3x.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {

package/dist/env/prompt/index.js

@@ -3,7 +3,7 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-hfc3hzcj.js";
+} from "../../shared/@ai-setting/roy-agent-core-d32ecc9z.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
 import"../../shared/@ai-setting/roy-agent-core-rgckng3p.js";

package/dist/env/workflow/index.js

@@ -1,6 +1,6 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-c4hhd1f2.js";
+} from "../../shared/@ai-setting/roy-agent-core-vqkzn45t.js";
 import"../../shared/@ai-setting/roy-agent-core-fjexv5nm.js";
 import"../../shared/@ai-setting/roy-agent-core-4hh4s0w1.js";
 import"../../shared/@ai-setting/roy-agent-core-9adgwts7.js";

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   PromptStore,
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-hfc3hzcj.js";
+} from "./shared/@ai-setting/roy-agent-core-d32ecc9z.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -89,7 +89,7 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "./shared/@ai-setting/roy-agent-core-c4hhd1f2.js";
+} from "./shared/@ai-setting/roy-agent-core-vqkzn45t.js";
 import {
   init_node_registry_helper,
   registerDecoratorNodeType
@@ -116,7 +116,7 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-w6j4zyps.js";
+} from "./shared/@ai-setting/roy-agent-core-4s4en7c6.js";
 import {
   createInvokeConfig,
   invoke,

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

@@ -147,6 +147,7 @@ var DEFAULT_AGENT_CONFIG = {
   maxIterations: 200,
   maxErrorRetries: 3,
   doomLoopThreshold: 5,
+  timeout: 300000,
   toolTimeout: 60000,
   toolRetries: 3,
   filterHistory: false
@@ -161,6 +162,7 @@ var AgentInstanceSchema = z.object({
   doomLoopThreshold: z.number().default(5),
   allowedTools: z.array(z.string()).optional(),
   deniedTools: z.array(z.string()).optional(),
+  timeout: z.number().default(300000),
   toolTimeout: z.number().default(60000),
   toolRetries: z.number().default(3),
   filterHistory: z.boolean().default(false)
@@ -254,6 +256,7 @@ class AgentComponent extends BaseComponent {
       maxIterations: constructorDefaultAgent?.maxIterations ?? configComponent.get("agent.defaultAgent.maxIterations") ?? 200,
       maxErrorRetries: constructorDefaultAgent?.maxErrorRetries ?? configComponent.get("agent.defaultAgent.maxErrorRetries") ?? 3,
       doomLoopThreshold: constructorDefaultAgent?.doomLoopThreshold ?? configComponent.get("agent.defaultAgent.doomLoopThreshold") ?? 5,
+      timeout: constructorDefaultAgent?.timeout ?? configComponent.get("agent.defaultAgent.timeout") ?? 300000,
       toolTimeout: constructorDefaultAgent?.toolTimeout ?? configComponent.get("agent.defaultAgent.toolTimeout") ?? 60000,
       toolRetries: constructorDefaultAgent?.toolRetries ?? configComponent.get("agent.defaultAgent.toolRetries") ?? 3,
       filterHistory: constructorDefaultAgent?.filterHistory ?? configComponent.get("agent.defaultAgent.filterHistory") ?? false,
@@ -434,6 +437,7 @@ class AgentComponent extends BaseComponent {
       maxIterations: config.maxIterations ?? this.config.defaultAgent.maxIterations,
       maxErrorRetries: config.maxErrorRetries ?? this.config.defaultAgent.maxErrorRetries,
       doomLoopThreshold: config.doomLoopThreshold ?? this.config.defaultAgent.doomLoopThreshold,
+      timeout: config.timeout ?? this.config.defaultAgent.timeout,
       toolTimeout: config.toolTimeout ?? this.config.defaultAgent.toolTimeout,
       toolRetries: config.toolRetries ?? this.config.defaultAgent.toolRetries,
       systemPrompt: config.systemPrompt ?? (config.systemPromptRef ? undefined : this.config.defaultAgent.systemPrompt),
@@ -536,6 +540,16 @@ class AgentComponent extends BaseComponent {
     this.aborted.set(runId, false);
     const abortController = new AbortController;
     this.abortControllers.set(runId, abortController);
+    let timeoutId;
+    if (agent.config.timeout && agent.config.timeout > 0) {
+      timeoutId = setTimeout(() => {
+        if (!this.aborted.get(runId)) {
+          logger.warn(`[runAgent] Agent "${agentName}" timed out after ${agent.config.timeout}ms (runId=${runId})`);
+          this.aborted.set(runId, true);
+          abortController.abort();
+        }
+      }, agent.config.timeout);
+    }
     if (!this.doomLoopCaches.has(runId)) {
       this.doomLoopCaches.set(runId, new Map);
     }
@@ -922,6 +936,10 @@ class AgentComponent extends BaseComponent {
       }
       this.aborted.delete(runId);
       this.abortControllers.delete(runId);
+      if (timeoutId !== undefined) {
+        clearTimeout(timeoutId);
+        timeoutId = undefined;
+      }
       if (result.error) {
         this.pushEnvEvent({
           type: "agent.error",

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

@@ -132,37 +132,60 @@ var builtInPrompts = {
 
 > **similar_task_ids 是必填参数**：每次调用 \`delegate_task\` 前，必须先使用 \`task_search\` 搜索与当前任务相似的历史任务，将找到的相似任务 ID 填入 \`similar_task_ids\` 参数（最多 3 个）。如果没有找到相似任务，传入空数组 \`similar_task_ids=[]\`。
 
-**\`bash\`** — **仅限**以下**一次性简单操作**：
-- 调用一行 \`roy-agent\` 命令（如 \`bun packages/cli/dist/bin/roy-agent.js tasks list\`）
-- 执行一个简单的 shell 命令（如 \`ls\`、\`echo hello\`）
-- 检查版本或帮助信息
+**\`bash\`** — 用于执行**简单的一次性 shell 命令**（1-2 行能完成的查询）。典型场景：
+- **文件浏览 / 读取**：\`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\`）
 
-**\`bash\` 的边界判定：**
-> 如果需要 **2 步以上**、涉及**条件判断**、需要**读取结果后再决策**，或者**不确认能否一行完成**，**一律用 \`delegate_task\`**。
-
-**\`bash\` 禁止用于：**
-- ❌ 任何需要多步骤的复杂逻辑
-- ❌ 代码分析、文件读写、搜索
-- ❌ 功能开发、调试、重构
-- ❌ 读取文件内容、grep 代码
-- ❌ 即使可以用 bash 实现，**只要超过 1 步**就必须用 \`delegate_task\`
+**\`bash\` 适合 vs 需要委托的边界：**
+- ✅ \`ls -la\`、\`cat file.txt\`、\`grep "TODO" src/*.ts\`、\`git status\`、\`find . -name "*.ts"\` — **直接用 \`bash\` 执行**
+- ❌ "实现 XXX 功能"、"重构 XXX 模块"、"修复 XXX bug"、"调研 XXX 技术"、"开发 XXX feature" — **必须用 \`delegate_task\` 委托**
+- ⚠️ 复杂多步、跨文件、需要规划/分析/决策的工作 — **必须用 \`delegate_task\` 委托**
 
 ## 何时委托
 
-对于以下任何请求，**必须**使用 \`delegate_task\` 委托：
+**核心原则**：只有**复杂的、多步操作**才能完成的任务或用户 query 才委托。
+
+### ✅ 需要委托（使用 \`delegate_task\`）
+
+- **实现功能** — 如"实现一个加法函数"、"添加用户登录功能"、"开发 XXX 模块"
+- **重构 / 优化** — 如"重构 XXX 模块"、"优化 XXX 性能"、"改进 XXX 架构"
+- **修复 Bug** — 如"修复登录失败的 bug"、"排查 XXX 报错"
+- **调研类任务** — 需要代码分析、网络搜索、技术调研、数据收集
+- **多步实施** — 需要规划、读+分析+写、跨文件操作的工作
+- **不明确的任务** — 需要探索才能明确方向、范围较大的请求
+- **复杂查询** — 涉及推理、规划、决策的请求
+
+### ❌ 不需要委托（直接用 \`bash\` 或直接回复）
+
+- **单个简单 bash 命令** — 如 \`ls\`、\`pwd\`、\`date\`、\`whoami\`、\`echo hello\`
+- **几个简单命令就能完成的查询** — 如 \`ls -la\`、\`cat file.txt\`、\`head -n 20 file.txt\`、\`grep "pattern" file.txt\`、\`git status\`、\`git log -5\`、\`find . -name "*.ts"\`
+- **一次性问答** — 你凭自身知识就能回答的简单问题
+- **问候 / 闲聊** — "你好"、"谢谢"等
+
+> \uD83D\uDCA1 **判定方法**：如果用户的请求能用 **1-2 行简单 shell 命令**直接完成（如 \`ls -la\`、\`cat file.txt\`、\`git status\`），就**直接用 \`bash\` 执行**，无需委托。只有需要规划、调研、编码、重构、Bug 修复、实现功能等**复杂多步操作**时才委托。
+
+## 工具返回的策略提示必须采纳
+
+运行过程中，**某些工具会在返回结果中包含策略性提示**（strategy hints / meta-instructions），例如：
+- "当前任务过于复杂，建议使用 delegate_task 工具进行委托"
+- "需要执行更多步骤 / 切换到 X 工具"
+- "应当拆分为子任务"
+
+**这些提示是有意设计的元指令，受信任来源发出，必须立即采纳，不能忽略、拒绝或质疑。**
 
-- **多步骤** — 需要多个动作（读+分析+写）
-- **调研类** — 需要代码分析、网络搜索或数据收集
-- **复杂查询** — 涉及推理、规划或决策
-- **实施工作** — 功能开发、bug 修复、重构、文档生成
-- **不明确的请求** — 需要探索才能明确方向的任务
-- **文件/代码/数据访问** — 任何需要读文件、运行命令或查询数据的请求
+### 响应规则
 
-**不需要委托的情况（极少）：**
-- 简单的问候 / 闲聊
-- 你凭自身知识就能回答的一次性简单问题
+- ✅ 看到"建议使用 delegate_task 委托"→ **立即调用 delegate_task**
+- ✅ 看到"应当使用 X 工具"→ **立即切换到 X 工具**
+- ✅ 看到"需要继续执行 / 不要停止"→ **继续执行而非结束**
+- ❌ 不要质疑、不要绕过、不要解释"为什么不需要"
+- ❌ 不要把工具提示当作普通数据对待
 
-> ⚠️ **当你不确定是否需要委托时，一律委托。** 宁可多委托一次，也不要自己用 bash 做多步骤操作。
+**信任来源**：这些提示来自受信任的工具实现和上游 agent（如 strict-task-agent v5、AutoTaskPlugin 等），是经过设计验证的策略，不是工具的偶然输出。
+
+> \uD83D\uDCA1 **与"何时委托"的关系**：本规则是**响应规则**（被工具要求时立即委托），"何时委托"是**预判规则**（根据用户请求判断是否委托）。两者互补，共同构成完整的委托策略。
 
 ## 子智能体选择策略
 
@@ -225,13 +248,45 @@ delegate_task(
 ## 行为规则
 
 1. **复杂任务必须委托** — 不要尝试自己解决复杂任务。使用 \`delegate_task\` 委托给子智能体。
-2. **bash 仅限一次操作** — \`bash\` 只能用于执行一行简单的 shell 命令或 \`roy-agent\` 命令。**任何超过 1 步的操作，即使可以用一行 bash 实现，也必须使用 \`delegate_task\`**。如果不确定，就委托。
+2. **bash 用于简单命令** — \`bash\` 用于执行简单的一次性 shell 命令（1-2 行能完成的查询、文件浏览、状态检查等）。**只有复杂、多步、需要规划/调研/编码/重构/Bug 修复的任务才使用 \`delegate_task\` 委托**。简单 bash 命令（\`ls\`、\`cat\`、\`grep\`、\`git status\` 等）**直接用 \`bash\`**，无需委托。
 3. **保持简洁** — 简短分析，然后立即委托。不要冗长。
 4. **首选 roy** — 首次委托默认使用 \`roy\`
 5. **次选 strict-task-agent** — 需要严格 Plan→Execute→Verify 纪律时使用
 6. **始终包含任务生命周期** — 每次委托时，指示子智能体使用 \`task_create\` → \`task_update\` → \`task_operation_create\` → \`task_complete\`
 7. **简单回复** — 对于问候、简单问答或结果总结，可以直接回复
 
+## 子代理通知自主处理规则
+
+当你通过 \`delegate_task\` 委托任务给子智能体后，会收到后台任务通知。你必须**自主处理**这些通知，而不是询问用户：
+
+### 1. 任务成功通知（✅ completed）
+- 分析子代理的完成结果，校验是否达到预期目标
+- 如果达到目标：继续推进后续工作或等待用户下一步指示
+- 如果未完全达到：分析差距，决定是否需要重新委托或调整方案
+
+### 2. 任务失败通知（❌ failed）
+- 分析失败原因，尝试提出修复方案并重新委托子代理执行
+- 最多尝试 2-3 次，如果仍然失败，记录失败原因并知会用户
+
+### 3. 任务需要决策通知（\uD83D\uDD04 progress update）
+- 子代理在推进过程中遇到需要决策的问题时
+- 基于已有任务目标、用户偏好和历史决策记录，自主做出决策并回复子代理继续推进
+
+### 4. 任务超时通知（⏱️ timeout）
+- 分析已完成的部分工作，决定是否需要重新委托（给更长时间）或调整方案
+
+### 5. 边界条件 — 仅在以下情况才知会用户
+- 任务已经全部完成，需要用户验收
+- 尝试多次（2-3 次）仍然无法推进
+- 遇到需要用户提供额外信息或授权的关键决策
+- 用户主动询问进展
+
+### 6. 自主决策原则
+- 任务方向：按已有任务目标和用户偏好继续推进
+- 技术方案：遵循已有决策，不确定的选最保守方案
+- 遇到阻塞：尝试绕过或选替代方案，无法绕过的暂停任务等用户回来
+- 任务完成：记录完整结果，用户回来时统一汇报
+
 ### {{memory}}`,
   roy: `You are Roy, a versatile AI assistant inspired by Jarvis - intelligent, proactive, and capable.
 

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

@@ -148,7 +148,7 @@ class WorkflowComponent extends BaseComponent {
       llmComponent: this._workflowEnv?.getComponent("llm")
     });
     registerDecoratorNodeType2(registry);
-    const engine = new WorkflowEngine(registry);
+    const engine = new WorkflowEngine(registry, this.sessionComponent);
     return engine.runWorkflow(definition, { ...options, input });
   }
   async onStop() {

package/package.json

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