@ai-setting/roy-agent-core 1.6.2 → 1.6.4

package/dist/env/agent/index.js

@@ -2,8 +2,8 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-47py6rej.js";
-import"../../shared/@ai-setting/roy-agent-core-j7jeqxhd.js";
+} from "../../shared/@ai-setting/roy-agent-core-xxfkvqqh.js";
+import"../../shared/@ai-setting/roy-agent-core-65qs21kf.js";
 import"../../shared/@ai-setting/roy-agent-core-6kygfd9x.js";
 import"../../shared/@ai-setting/roy-agent-core-5h49ct1a.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";

package/dist/env/event-source/index.js

@@ -10,7 +10,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-2t2n1epb.js";
+} from "../../shared/@ai-setting/roy-agent-core-bferdaw6.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -21,11 +21,11 @@ import {
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ds5f75pg.js";
 import"../../shared/@ai-setting/roy-agent-core-wmkx79b1.js";
-import"../../shared/@ai-setting/roy-agent-core-gexpbexm.js";
+import"../../shared/@ai-setting/roy-agent-core-aa0tdfb2.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-8wd3qwx5.js";
 import"../../shared/@ai-setting/roy-agent-core-4yq23m5g.js";
-import"../../shared/@ai-setting/roy-agent-core-9378eq5y.js";
+import"../../shared/@ai-setting/roy-agent-core-z9m38ytb.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
 import"../../shared/@ai-setting/roy-agent-core-pf1c360e.js";

package/dist/env/index.js

@@ -1,11 +1,11 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-97x9ymda.js";
+} from "../shared/@ai-setting/roy-agent-core-hd5xrr2q.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-2t2n1epb.js";
+} from "../shared/@ai-setting/roy-agent-core-bferdaw6.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -17,13 +17,13 @@ import"../shared/@ai-setting/roy-agent-core-wmkx79b1.js";
 import {
   PluginComponent
 } from "../shared/@ai-setting/roy-agent-core-z7dxedn6.js";
-import"../shared/@ai-setting/roy-agent-core-gexpbexm.js";
+import"../shared/@ai-setting/roy-agent-core-aa0tdfb2.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-ekptge19.js";
+} from "../shared/@ai-setting/roy-agent-core-2xpstxhz.js";
 import"../shared/@ai-setting/roy-agent-core-xgnpr28w.js";
-import"../shared/@ai-setting/roy-agent-core-gzzvcmg3.js";
+import"../shared/@ai-setting/roy-agent-core-kf3mw79k.js";
 import"../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../shared/@ai-setting/roy-agent-core-vf72n6qn.js";
 import"../shared/@ai-setting/roy-agent-core-q88vxmx5.js";
@@ -41,27 +41,27 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-47py6rej.js";
-import"../shared/@ai-setting/roy-agent-core-j7jeqxhd.js";
+} from "../shared/@ai-setting/roy-agent-core-xxfkvqqh.js";
+import"../shared/@ai-setting/roy-agent-core-65qs21kf.js";
 import"../shared/@ai-setting/roy-agent-core-6kygfd9x.js";
 import"../shared/@ai-setting/roy-agent-core-5h49ct1a.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-j25z80xr.js";
+} from "../shared/@ai-setting/roy-agent-core-tyqzn10b.js";
 import"../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-te3hf26b.js";
+import"../shared/@ai-setting/roy-agent-core-7afcdb2m.js";
 import"../shared/@ai-setting/roy-agent-core-pzeexnhf.js";
 import"../shared/@ai-setting/roy-agent-core-9xby523m.js";
-import"../shared/@ai-setting/roy-agent-core-9378eq5y.js";
+import"../shared/@ai-setting/roy-agent-core-z9m38ytb.js";
 import"../shared/@ai-setting/roy-agent-core-as3phr7n.js";
 import {
   XDG_PATHS,
   getXDGPath,
   getXDGPaths
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../shared/@ai-setting/roy-agent-core-0ye4q2jj.js";
+import"../shared/@ai-setting/roy-agent-core-ktbkp661.js";
 import"../shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import"../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import {

package/dist/env/llm/index.js

@@ -8,14 +8,14 @@ import {
   ProviderCapabilitiesSchema,
   ProviderConfigSchema,
   ProviderManager
-} from "../../shared/@ai-setting/roy-agent-core-fg5eaht3.js";
+} from "../../shared/@ai-setting/roy-agent-core-155408xq.js";
 import {
   convertToSDKMessages,
   createInvokeConfig,
   invoke,
   invokeNonStream,
   parseModelString
-} from "../../shared/@ai-setting/roy-agent-core-j7jeqxhd.js";
+} from "../../shared/@ai-setting/roy-agent-core-65qs21kf.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-8x4ngxcy.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";

package/dist/env/prompt/index.js

@@ -3,8 +3,8 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-1k7z350s.js";
-import"../../shared/@ai-setting/roy-agent-core-9378eq5y.js";
+} from "../../shared/@ai-setting/roy-agent-core-g7hfkszj.js";
+import"../../shared/@ai-setting/roy-agent-core-z9m38ytb.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-pf1c360e.js";

package/dist/env/task/delegate/index.js

@@ -3,9 +3,9 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-te3hf26b.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7afcdb2m.js";
 import"../../../shared/@ai-setting/roy-agent-core-pzeexnhf.js";
-import"../../../shared/@ai-setting/roy-agent-core-9378eq5y.js";
+import"../../../shared/@ai-setting/roy-agent-core-z9m38ytb.js";
 import"../../../shared/@ai-setting/roy-agent-core-as3phr7n.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";

package/dist/env/task/index.js

@@ -5,21 +5,21 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-j25z80xr.js";
+} from "../../shared/@ai-setting/roy-agent-core-tyqzn10b.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-te3hf26b.js";
+import"../../shared/@ai-setting/roy-agent-core-7afcdb2m.js";
 import"../../shared/@ai-setting/roy-agent-core-pzeexnhf.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-9xby523m.js";
-import"../../shared/@ai-setting/roy-agent-core-9378eq5y.js";
+import"../../shared/@ai-setting/roy-agent-core-z9m38ytb.js";
 import"../../shared/@ai-setting/roy-agent-core-as3phr7n.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-0ye4q2jj.js";
+import"../../shared/@ai-setting/roy-agent-core-ktbkp661.js";
 import"../../shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";

package/dist/env/task/plugins/index.js

@@ -8,11 +8,11 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-gexpbexm.js";
+} from "../../../shared/@ai-setting/roy-agent-core-aa0tdfb2.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-8wd3qwx5.js";
 import"../../../shared/@ai-setting/roy-agent-core-4yq23m5g.js";
-import"../../../shared/@ai-setting/roy-agent-core-9378eq5y.js";
+import"../../../shared/@ai-setting/roy-agent-core-z9m38ytb.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-zttjq1h3.js";
 import"../../../shared/@ai-setting/roy-agent-core-scp0afxg.js";

package/dist/env/task/tools/index.js

@@ -7,8 +7,9 @@ import {
   getTaskTool,
   listTasksTool,
   searchTasksTool,
+  treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-0ye4q2jj.js";
+} from "../../../shared/@ai-setting/roy-agent-core-ktbkp661.js";
 import"../../../shared/@ai-setting/roy-agent-core-scp0afxg.js";
 import"../../../shared/@ai-setting/roy-agent-core-cg146hmg.js";
 import"../../../shared/@ai-setting/roy-agent-core-vyygk314.js";
@@ -17,6 +18,7 @@ import"../../../shared/@ai-setting/roy-agent-core-c6592r3c.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   updateTaskTool,
+  treeTasksTool,
   searchTasksTool,
   listTasksTool,
   getTaskTool,

package/dist/env/workflow/engine/index.js

@@ -5,7 +5,7 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-gzzvcmg3.js";
+} from "../../../shared/@ai-setting/roy-agent-core-kf3mw79k.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../../shared/@ai-setting/roy-agent-core-vf72n6qn.js";
 import"../../../shared/@ai-setting/roy-agent-core-q88vxmx5.js";

package/dist/env/workflow/index.js

@@ -1,8 +1,8 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-ekptge19.js";
+} from "../../shared/@ai-setting/roy-agent-core-2xpstxhz.js";
 import"../../shared/@ai-setting/roy-agent-core-xgnpr28w.js";
-import"../../shared/@ai-setting/roy-agent-core-gzzvcmg3.js";
+import"../../shared/@ai-setting/roy-agent-core-kf3mw79k.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../shared/@ai-setting/roy-agent-core-vf72n6qn.js";
 import"../../shared/@ai-setting/roy-agent-core-q88vxmx5.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   PromptComponent,
   PromptStore
-} from "./shared/@ai-setting/roy-agent-core-1k7z350s.js";
+} from "./shared/@ai-setting/roy-agent-core-g7hfkszj.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -9,7 +9,7 @@ import {
   ModelLimitsSchema,
   ProviderCapabilitiesSchema,
   ProviderConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-fg5eaht3.js";
+} from "./shared/@ai-setting/roy-agent-core-155408xq.js";
 import {
   ConfigComponent
 } from "./shared/@ai-setting/roy-agent-core-33rhv946.js";
@@ -62,7 +62,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-97x9ymda.js";
+} from "./shared/@ai-setting/roy-agent-core-hd5xrr2q.js";
 import {
   BountyIMInstance,
   EventSourceComponent,
@@ -74,7 +74,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-2t2n1epb.js";
+} from "./shared/@ai-setting/roy-agent-core-bferdaw6.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -94,18 +94,18 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-gexpbexm.js";
+} from "./shared/@ai-setting/roy-agent-core-aa0tdfb2.js";
 import {
   BasePlugin
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "./shared/@ai-setting/roy-agent-core-ekptge19.js";
+} from "./shared/@ai-setting/roy-agent-core-2xpstxhz.js";
 import {
   init_node_registry_helper,
   registerDecoratorNodeType
 } from "./shared/@ai-setting/roy-agent-core-xgnpr28w.js";
-import"./shared/@ai-setting/roy-agent-core-gzzvcmg3.js";
+import"./shared/@ai-setting/roy-agent-core-kf3mw79k.js";
 import"./shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"./shared/@ai-setting/roy-agent-core-vf72n6qn.js";
 import"./shared/@ai-setting/roy-agent-core-q88vxmx5.js";
@@ -129,13 +129,13 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-47py6rej.js";
+} from "./shared/@ai-setting/roy-agent-core-xxfkvqqh.js";
 import {
   createInvokeConfig,
   invoke,
   invokeNonStream,
   parseModelString
-} from "./shared/@ai-setting/roy-agent-core-j7jeqxhd.js";
+} from "./shared/@ai-setting/roy-agent-core-65qs21kf.js";
 import {
   ToolComponent,
   ToolRegistry,
@@ -148,10 +148,10 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-j25z80xr.js";
+} from "./shared/@ai-setting/roy-agent-core-tyqzn10b.js";
 import"./shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-te3hf26b.js";
+import"./shared/@ai-setting/roy-agent-core-7afcdb2m.js";
 import"./shared/@ai-setting/roy-agent-core-pzeexnhf.js";
 import {
   SQLiteTaskStore,
@@ -160,7 +160,7 @@ import {
 import {
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-9378eq5y.js";
+} from "./shared/@ai-setting/roy-agent-core-z9m38ytb.js";
 import {
   AgentRegistry
 } from "./shared/@ai-setting/roy-agent-core-as3phr7n.js";
@@ -169,7 +169,7 @@ import {
   getXDGPath,
   getXDGPaths
 } from "./shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"./shared/@ai-setting/roy-agent-core-0ye4q2jj.js";
+import"./shared/@ai-setting/roy-agent-core-ktbkp661.js";
 import"./shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import {
   TaskHookPoints

package/dist/shared/@ai-setting/{roy-agent-core-fg5eaht3.js → roy-agent-core-155408xq.js}

@@ -1,6 +1,6 @@
 import {
   invoke
-} from "./roy-agent-core-j7jeqxhd.js";
+} from "./roy-agent-core-65qs21kf.js";
 import {
   ContextError,
   ErrorCodes

package/dist/shared/@ai-setting/{roy-agent-core-ekptge19.js → roy-agent-core-2xpstxhz.js}

@@ -6,7 +6,7 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-gzzvcmg3.js";
+} from "./roy-agent-core-kf3mw79k.js";
 import {
   askUserTool,
   createRunWorkflowTool,

package/dist/shared/@ai-setting/{roy-agent-core-j7jeqxhd.js → roy-agent-core-65qs21kf.js}

@@ -330,8 +330,8 @@ function convertToolChoice(toolChoice) {
   return { type: "tool", toolName };
 }
 function createEnvEventEmitter(env, context) {
-  if (!env) {
-    logger.warn("[invoke] createEnvEventEmitter: env is null/undefined, streaming events will be disabled");
+  if (!env || typeof env.pushEnvEvent !== "function") {
+    logger.warn("[invoke] createEnvEventEmitter: env is null/undefined or pushEnvEvent is unavailable, streaming events will be disabled");
     return null;
   }
   return (event) => {
@@ -721,7 +721,7 @@ async function invokeNonStream(config, options, ctx) {
     completionTokens: usage.completionTokens ?? 0,
     totalTokens: usage.totalTokens ?? 0
   } : undefined;
-  if (options.env) {
+  if (options.env && typeof options.env.pushEnvEvent === "function") {
     options.env.pushEnvEvent({
       id: randomUUID(),
       type: "llm.completed",

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

@@ -4,7 +4,7 @@ import {
 } from "./roy-agent-core-pzeexnhf.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-9378eq5y.js";
+} from "./roy-agent-core-z9m38ytb.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
 } from "./roy-agent-core-as3phr7n.js";

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

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-8wd3qwx5.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-9378eq5y.js";
+} from "./roy-agent-core-z9m38ytb.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
@@ -331,7 +331,7 @@ function createAutoTaskPlugin(config) {
       lastProcessedTraceId = traceId;
       logger2.debug(`[AutoTaskPlugin] new query detected (traceId=${traceId.slice(0, 20)}...)`);
       const reminderContent = `⚠️ **系统提醒**: 你已经调用了 ${ctx.iteration} 次工具，达到 iteration 阈值（默认 ${threshold}）。
-` + `当前请求较为复杂，建议通过 \`delegate_task\` 工具将整个任务委托给 \`roy\` sub-agent 处理。`;
+` + `当前请求较为复杂，建议通过 \`delegate_task\` 工具将整个任务委托给 \`roy\` sub-agent 处理。` + `注意，需要让roy为这个任务调用task create工具来创建任务进行跟踪，这个是必走程序哈。`;
       if (!ctx.toolResult) {
         logger2.warn(`[AutoTaskPlugin] toolResult missing, skip meta-protocol (iteration=${ctx.iteration})`);
         return { continue: true };

package/dist/shared/@ai-setting/{roy-agent-core-2t2n1epb.js → roy-agent-core-bferdaw6.js}

@@ -1,7 +1,7 @@
 import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook
-} from "./roy-agent-core-gexpbexm.js";
+} from "./roy-agent-core-aa0tdfb2.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-qxhq8ven.js";

package/dist/shared/@ai-setting/{roy-agent-core-1k7z350s.js → roy-agent-core-g7hfkszj.js}

@@ -1,6 +1,6 @@
 import {
   builtInPrompts
-} from "./roy-agent-core-9378eq5y.js";
+} from "./roy-agent-core-z9m38ytb.js";
 import {
   getXDGPath
 } from "./roy-agent-core-qxnbvgwe.js";

package/dist/shared/@ai-setting/{roy-agent-core-97x9ymda.js → roy-agent-core-hd5xrr2q.js}

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-gexpbexm.js";
+} from "./roy-agent-core-aa0tdfb2.js";
 import {
   ContextError,
   ErrorCodes
@@ -49,6 +49,15 @@ init_env_context();
 import * as fsSync from "fs";
 import * as path from "path";
 var logger = createLogger("environment");
+var DEFAULT_AGENT_NAME = "Roy";
+function injectAgentNamePlaceholder(prompt, context) {
+  if (!prompt.includes("{{agent_name}}")) {
+    return prompt;
+  }
+  const metadata = context?.metadata;
+  const defaultAgentName = typeof metadata?.defaultAgentName === "string" && metadata.defaultAgentName.length > 0 ? metadata.defaultAgentName : DEFAULT_AGENT_NAME;
+  return prompt.replace(/\{\{agent_name\}\}/g, defaultAgentName);
+}
 
 class BaseEnvironment extends BaseComponent {
   name;
@@ -146,6 +155,15 @@ class BaseEnvironment extends BaseComponent {
       finalSystemPrompt = finalSystemPrompt.replace("{{workspace_dir}}", workspaceDir);
       logger.debug(`[handle_query] Injected workspace_dir: ${workspaceDir}`);
     }
+    {
+      const prev = finalSystemPrompt;
+      finalSystemPrompt = injectAgentNamePlaceholder(finalSystemPrompt, context);
+      if (prev !== finalSystemPrompt) {
+        const metadata = context?.metadata;
+        const injectedName = typeof metadata?.defaultAgentName === "string" && metadata.defaultAgentName.length > 0 ? metadata.defaultAgentName : DEFAULT_AGENT_NAME;
+        logger.debug(`[handle_query] Injected agent_name: ${injectedName}`);
+      }
+    }
     let agent = agentComponent.getAgent(agentName);
     if (!agent) {
       if (agentName !== "default") {
@@ -221,6 +239,7 @@ class BaseEnvironment extends BaseComponent {
         if (agent.config.systemPrompt.includes("{{workspace_dir}}")) {
           agent.config.systemPrompt = agent.config.systemPrompt.replace("{{workspace_dir}}", process.cwd());
         }
+        agent.config.systemPrompt = injectAgentNamePlaceholder(agent.config.systemPrompt, context);
       }
       logger.debug(`[handle_query] Injected memory/workspace_dir for existing agent: ${agentName}`);
     }

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

@@ -1029,6 +1029,8 @@ var init_agent_node = __esm(() => {
         let inheritedModel;
         let inheritedAllowedTools;
         let inheritedDeniedTools;
+        let inheritedFromAgentName = false;
+        let agentTypeAllowsAllTools = false;
         if (agentName && this.agentRunner.hasAgent && this.agentRunner.getAgentConfig) {
           if (this.agentRunner.hasAgent(agentName)) {
             const agentConfig2 = this.agentRunner.getAgentConfig(agentName);
@@ -1037,6 +1039,7 @@ var init_agent_node = __esm(() => {
               inheritedModel = agentConfig2.model;
               inheritedAllowedTools = agentConfig2.allowedTools;
               inheritedDeniedTools = agentConfig2.deniedTools;
+              inheritedFromAgentName = true;
             }
           }
         }
@@ -1049,6 +1052,24 @@ var init_agent_node = __esm(() => {
             });
           }
         }
+        if (!inheritedFromAgentName && this.agentRunner.hasAgent && this.agentRunner.getAgentConfig) {
+          if (this.agentRunner.hasAgent(resolvedAgentType)) {
+            const typeConfig = this.agentRunner.getAgentConfig(resolvedAgentType);
+            if (typeConfig) {
+              if (inheritedModel === undefined && typeConfig.model !== undefined) {
+                inheritedModel = typeConfig.model;
+              }
+              if (inheritedDeniedTools === undefined && typeConfig.deniedTools !== undefined) {
+                inheritedDeniedTools = typeConfig.deniedTools;
+              }
+              if (typeConfig.allowedTools === undefined) {
+                agentTypeAllowsAllTools = true;
+              } else if (inheritedAllowedTools === undefined) {
+                inheritedAllowedTools = typeConfig.allowedTools;
+              }
+            }
+          }
+        }
         const userQuery = context.input?.userQuery ?? context.workflowInput?.userQuery;
         let agentSessionId = context.agentSessionId;
         if (!agentSessionId && context.sessionComponent) {
@@ -1065,7 +1086,7 @@ var init_agent_node = __esm(() => {
           }
         }
         const effectiveModel = options.model || inheritedModel;
-        const effectiveAllowedTools = options.allowedTools?.length ? options.allowedTools : inheritedAllowedTools?.length ? inheritedAllowedTools : ["ask_user"];
+        const effectiveAllowedTools = options.allowedTools?.length ? options.allowedTools : agentTypeAllowsAllTools ? undefined : inheritedAllowedTools?.length ? inheritedAllowedTools : ["ask_user"];
         const effectiveDeniedTools = options.deniedTools?.length ? options.deniedTools : inheritedDeniedTools;
         const agentConfig = {
           type: resolvedAgentType,
@@ -2071,16 +2092,10 @@ var init_engine = __esm(() => {
       const durationMs = Date.now() - sessionState.startedAt.getTime();
       const sessionId = sessionState.sessionId;
       const runId = this.getRunIdFromSessionId(sessionId);
-      const dagAnalysis = sessionState.dagManager.analyze();
-      const exitNodes = new Set(dagAnalysis.exitNodes);
-      const exitOutput = {};
+      const finalOutput = {};
       for (const [nodeId, nodeOutput] of sessionState.nodeOutputs) {
-        if (exitNodes.has(nodeId)) {
-          exitOutput[nodeId] = nodeOutput;
-        }
+        finalOutput[nodeId] = nodeOutput;
       }
-      const singleExit = exitNodes.size === 1 ? Array.from(exitNodes)[0] : undefined;
-      const finalOutput = singleExit && exitOutput[singleExit] !== undefined ? exitOutput[singleExit] : exitOutput;
       const allNodeOutputs = {};
       for (const [nodeId, nodeOutput] of sessionState.nodeOutputs) {
         allNodeOutputs[nodeId] = nodeOutput;

package/dist/shared/@ai-setting/{roy-agent-core-0ye4q2jj.js → roy-agent-core-ktbkp661.js}

@@ -20,11 +20,13 @@ var CreateTaskToolSchema = z.object({
   project_path: z.string().describe("Project root path for task positioning. " + "Used to locate the project space for this task. " + "Use 'unknown' if unknown."),
   parent_task_id: z.union([z.number(), z.null()]).optional().describe(`父任务 ID（可选）。不传或传 null 时，创建根任务（root task）。
 ` + `如需将任务挂载到某个父任务下，传入对应父任务 ID。
-` + `如何选择合适的父任务：
-` + `  1. 使用 task_list(depth=0) 查看当前所有根任务
-` + `  2. 使用 task_search 搜索与当前任务相关的父任务
-` + `  3. 按主题归类：将相似主题的任务挂载到同一个父任务下
-` + "如果确实找不到合适的父任务，可以直接创建根任务（不传 parent_task_id）。"),
+` + `**调用前必须先调用 task_tree(depth=2)** 查看现有任务树结构，避免重复创建根任务、避免孤儿任务。
+` + `决策路径（按顺序匹配）：
+` + `  A. 归属到现有 longterm 根（如「[Longterm] X 生态」）→ parent_task_id = 该根 ID
+` + `  B. 归属到现有主题聚类（非 longterm 根，但同主题）→ parent_task_id = 该根 ID
+` + `  C. 新建根任务 → 省略 parent_task_id（让树根 ≤10）
+` + `如何找到 parent_task_id：使用 task_tree(depth=2) 获取的树形结构，
+` + "根据节点 id 选择合适的父任务 ID（来自 tree 输出，**不要硬编码**数字）。"),
   context: z.string().describe("JSON string with time-space positioning information for task continuity. " + "This field is crucial for Agent task handoff. " + "Core fields: worktree_path (git worktree path), branch (current branch), type (feature/bug/refactor/chore). " + 'Example for coding: {"worktree_path": "/path/worktree", "branch": "feature/xyz", "type": "feature"}. ' + 'Example for other: {"type": "general"}. ' + `If unknown, use '{}' or '{"type":"unknown"}'. ` + "IMPORTANT: Must be a valid JSON string!")
 });
 var GetTaskToolSchema = z.object({
@@ -77,6 +79,14 @@ var BatchArchiveToolSchema = z.object({
 var BatchDeleteToolSchema = z.object({
   task_ids: z.array(z.number()).describe("要删除的任务 ID 列表")
 });
+var TreeTasksToolSchema = z.object({
+  depth: z.number().optional().default(2).describe("树的展开深度。默认 2 (根 + 一层子任务 + 二层孙任务)。" + "0 = 只返回根任务，不展开任何子节点。" + "-1 或负数 = 无限层级（全部展开）。"),
+  parent_task_id: z.number().optional().describe("只看指定父任务的子树。不传则从所有根任务（forest）开始。"),
+  status: z.enum(["todo", "active", "completed", "paused", "cancelled", "archived"]).optional().describe("按状态过滤（与 task_list 一致）。"),
+  priority: z.enum(["low", "medium", "high"]).optional().describe("按优先级过滤。"),
+  type: z.enum(["normal", "cycle", "longterm"]).optional().describe("按任务类型过滤。"),
+  include_archived: z.boolean().optional().default(false).describe("是否包含已归档任务（默认 false，与 task_list 一致）。")
+});
 
 // src/env/task/tools/create-tool.ts
 init_env_context();
@@ -87,63 +97,84 @@ function createTaskTool(taskComponent) {
     name: "task_create",
     description: `
       Create a new task for tracking work.
-      
+
+      ## ⚠️ CALL task_tree(depth=2) BEFORE THIS TOOL
+
+      Before calling \`task_create\`, you **MUST** first call
+      \`task_tree(depth=2)\` to inspect the existing task hierarchy.
+      This is critical because:
+
+      1. Avoid duplicating root tasks (root tasks should stay ≤ 10).
+      2. Find the right \`parent_task_id\` to attach under.
+      3. Avoid creating stranded/orphan tasks.
+
+      Workflow:
+        step 1: task_tree({depth: 2})
+        step 2: read the tree, then decide per "Decision Tree" below
+        step 3: task_create({...})
+
+      ## Decision Tree — How to choose parent_task_id
+
+      Walk these paths in order:
+
+      **Path A — Attach under a longterm root.**
+        The task belongs to a theme whose longterm root already exists
+        (e.g. "[Longterm] X ecosystem"). Set \`parent_task_id\` to that
+        root's id. This is the **preferred** path for incremental work
+        inside an established theme.
+
+      **Path B — Attach under an existing topic cluster.**
+        A non-longterm root already aggregates similar tasks and yours
+        belongs in the same cluster. Set \`parent_task_id\` to that root.
+
+      **Path C — Create a new root.**
+        Neither A nor B fits (cross-cutting work, or root count already
+        ≥ ~10). **Omit** \`parent_task_id\` (or pass \`null\`) and the
+        task becomes a new root.
+
+      ## Tree Hygiene Principles
+
+      Apply these when deciding parent_task_id:
+
+        - Root tasks ≤ 10 (keep tree width manageable)
+        - Depth ≤ 5 (avoid deep nesting)
+        - Same-theme tasks cluster under one parent
+        - Long-tail/stranded tasks should be archived or merged
+
       ## IMPORTANT: Task Continuity Fields
-      
-      This tool creates persistent task records that can be picked up by a 
-      Task Manager Agent to continue推进未完成的任务.
-      
+
+      This tool creates persistent task records that can be picked up by a
+      Task Manager Agent to continue advancing unfinished work.
+
       The following fields are critical for task context preservation:
-      
+
       - project_path: The project root path where this task belongs.
         Used to locate the project space for this task.
         If unknown, use 'unknown'.
-      
+
       - context: A JSON string containing time-space positioning information.
         This field is crucial for Agent task handoff.
-        
+
         **Required format**: Valid JSON string (parseable).
-        
+
         **Core fields**:
         - worktree_path: Git worktree path (for code development)
         - branch: Current branch name
         - type: Work type classification (feature/bug/refactor/chore).
           ⚠️ NOTE: This is the **context.type** (work classification), NOT the
           task's type field (normal/cycle/longterm). They are independent concepts.
-        
+
         **Example for coding tasks**:
-        {"worktree_path": "/path/to/worktree", "branch": "feature/xyz", "type": "feature", "parent_branch": "main"}
-        
+        {"worktree_path": "<worktree-path>", "branch": "<branch-name>", "type": "feature", "parent_branch": "main"}
+
         **Example for other tasks**:
         {"type": "general"}
-        
+
         If unable to fill in details, use at minimum:
         {"type": "unknown"}
-        
+
         **DO NOT leave this as plain text** - it must be valid JSON!
-      
-      ## parent_task_id is OPTIONAL
-      
-      Creating a root task (top-level task) is allowed and common. To create a root task,
-      simply **omit** \`parent_task_id\` (or pass \`null\`).
-      
-      To create a child task, provide an existing parent's \`parent_task_id\`. Best practices:
-      
-      1. First, use \`task_list(depth=0)\` to see all root tasks (top-level tasks).
-      2. Use \`task_search\` with relevant keywords to find existing tasks
-         that could serve as the parent.
-      3. Group by topic: put similar tasks under the same parent.
-      4. If no suitable parent exists, create a root task first (omit \`parent_task_id\`),
-         then create the child task with that root task's id.
-      
-      **Examples:**
-      - Root task: \`task_create(title="New project", ...)\` (no parent_task_id)
-      - Child task: \`task_create(title="New feature", parent_task_id=<root_task_id>, ...)\`
-        where \`<root_task_id>\` is the id returned by task_list, NOT a hardcoded number.
-      
-      **Hierarchy guidance** (not enforced):
-      - 根任务 ≤10 (keep root tasks manageable)
-      - 深度 ≤5 (avoid deep nesting)
+
     `,
     parameters: CreateTaskToolSchema,
     execute: async (args, ctx) => {
@@ -626,4 +657,142 @@ function completeTaskTool(taskComponent) {
     }
   };
 }
-export { createTaskTool, getTaskTool, listTasksTool, searchTasksTool, batchArchiveTaskTool, batchDeleteTaskTool, updateTaskTool, deleteTaskTool, completeTaskTool };
+// src/env/task/tools/task-tree-tool.ts
+function compareTasksDesc(a, b) {
+  if (a.updatedAt < b.updatedAt)
+    return 1;
+  if (a.updatedAt > b.updatedAt)
+    return -1;
+  if (a.id < b.id)
+    return 1;
+  if (a.id > b.id)
+    return -1;
+  return 0;
+}
+function trimToDepth(nodes, depth) {
+  if (depth < 0)
+    return nodes;
+  if (depth === 0) {
+    return nodes.map((n) => ({ ...n, children: [] }));
+  }
+  return nodes.map((n) => ({
+    ...n,
+    children: trimToDepth(n.children, depth - 1)
+  }));
+}
+function countNodes(nodes) {
+  let n = 0;
+  for (const node of nodes)
+    n += 1 + countNodes(node.children);
+  return n;
+}
+function buildTaskNodes(tasks) {
+  const nodeById = new Map;
+  const byParent = new Map;
+  const roots = [];
+  for (const t of tasks) {
+    nodeById.set(t.id, {
+      id: t.id,
+      title: t.title,
+      status: t.status,
+      type: t.type,
+      priority: t.priority,
+      progress: t.progress,
+      children: []
+    });
+  }
+  for (const t of tasks) {
+    const pid = t.parent_task_id;
+    if (pid !== undefined && pid !== null && nodeById.has(pid)) {
+      const list = byParent.get(pid) || [];
+      list.push(t);
+      byParent.set(pid, list);
+    } else {
+      roots.push(t);
+    }
+  }
+  for (const [parentId, children] of byParent.entries()) {
+    const parentNode = nodeById.get(parentId);
+    children.sort(compareTasksDesc);
+    parentNode.children = children.map((c) => nodeById.get(c.id));
+  }
+  roots.sort(compareTasksDesc);
+  return roots.map((r) => nodeById.get(r.id));
+}
+function treeTasksTool(taskComponent) {
+  return {
+    name: "task_tree",
+    description: "View the task tree (forest) with optional filters. " + "Use this BEFORE task_create to decide whether to create a root task " + "(omit parent_task_id) or attach to an existing parent. " + "depth: 0=只根任务, 1=根+一层子任务, 2=根+二层子任务 (default), " + "-1 or omitted as -1=无限层级. " + `Returns { total, truncated, depth, parent_task_id, nodes } where:
+` + `  - total: count of ALL tasks in the returned tree (incl. descendants)
+` + `  - truncated: always false for now (no pagination cap on tree)
+` + `  - depth: the resolved depth value
+` + `  - parent_task_id: the root's id, or null for forest mode
+` + `  - nodes: TaskNode[] with { id, title, status, type, priority, progress, children }
+` + "Note: `total` is the FIRST field in the response so it survives " + "tail-truncation by ToolComponent.truncateOutput.",
+    parameters: TreeTasksToolSchema,
+    execute: async (args, _ctx) => {
+      const params = TreeTasksToolSchema.parse(args);
+      try {
+        let flat = [];
+        let parent_task_id = params.parent_task_id ?? null;
+        if (params.parent_task_id !== undefined && params.parent_task_id !== null) {
+          const root = await taskComponent.getTask(params.parent_task_id);
+          if (!root) {
+            flat = [];
+          } else {
+            const descendants = await taskComponent.getTaskTree(params.parent_task_id, params.depth === -1 ? -1 : Math.max(0, params.depth - 1));
+            flat = [root, ...descendants];
+          }
+        } else {
+          const result = await taskComponent.listTasks({
+            status: params.status,
+            priority: params.priority,
+            type: params.type,
+            include_archived: params.include_archived,
+            limit: 9999,
+            offset: 0
+          });
+          flat = result.tasks;
+        }
+        if (params.parent_task_id !== undefined && params.parent_task_id !== null) {
+          if (params.status) {
+            flat = flat.filter((t) => t.status === params.status);
+          }
+          if (params.priority) {
+            flat = flat.filter((t) => t.priority === params.priority);
+          }
+          if (params.type) {
+            flat = flat.filter((t) => t.type === params.type);
+          }
+          if (!params.include_archived) {
+            flat = flat.filter((t) => t.status !== "archived");
+          }
+        }
+        let nodes = buildTaskNodes(flat);
+        if (params.parent_task_id === undefined || params.parent_task_id === null) {
+          nodes = trimToDepth(nodes, params.depth);
+        }
+        const total = countNodes(nodes);
+        return {
+          success: true,
+          output: JSON.stringify({
+            total,
+            truncated: false,
+            depth: params.depth,
+            parent_task_id,
+            nodes
+          }),
+          metadata: { execution_time_ms: 0 }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+export { createTaskTool, getTaskTool, listTasksTool, searchTasksTool, batchArchiveTaskTool, batchDeleteTaskTool, updateTaskTool, deleteTaskTool, completeTaskTool, treeTasksTool };

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

@@ -8,7 +8,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-te3hf26b.js";
+} from "./roy-agent-core-7afcdb2m.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
@@ -22,8 +22,9 @@ import {
   getTaskTool,
   listTasksTool,
   searchTasksTool,
+  treeTasksTool,
   updateTaskTool
-} from "./roy-agent-core-0ye4q2jj.js";
+} from "./roy-agent-core-ktbkp661.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -352,6 +353,7 @@ class TaskComponent extends BaseComponent {
       createTaskTool(this),
       getTaskTool(this),
       listTasksTool(this),
+      treeTasksTool(this),
       searchTasksTool(this),
       batchArchiveTaskTool(this),
       batchDeleteTaskTool(this),

package/dist/shared/@ai-setting/{roy-agent-core-47py6rej.js → roy-agent-core-xxfkvqqh.js}

@@ -1,6 +1,6 @@
 import {
   withTimeout
-} from "./roy-agent-core-j7jeqxhd.js";
+} from "./roy-agent-core-65qs21kf.js";
 import {
   truncateOutputInline
 } from "./roy-agent-core-6kygfd9x.js";
@@ -76,6 +76,8 @@ var AGENT_CONFIG_REGISTRATION = {
     { key: "agent.defaultAgent.systemPrompt", sources: ["env", "file"] },
     { key: "agent.defaultAgent.streaming", sources: ["env", "file"] },
     { key: "agent.defaultAgent.tools", sources: ["env", "file"] },
+    { key: "agent.defaultAgent.allowedTools", sources: ["env", "file"] },
+    { key: "agent.defaultAgent.deniedTools", sources: ["env", "file"] },
     { key: "agent.defaultAgent.maxErrorRetries", sources: ["env", "file"] },
     { key: "agent.defaultAgent.filterHistory", sources: ["env", "file"] }
   ]
@@ -86,6 +88,20 @@ init_decorator();
 init_global_hook_manager();
 init_context();
 init_workflow_hil();
+function parseToolList(v) {
+  if (v === undefined || v === null) {
+    return;
+  }
+  if (Array.isArray(v)) {
+    const arr = v.filter((x) => typeof x === "string");
+    return arr.length > 0 ? arr : undefined;
+  }
+  if (typeof v === "string") {
+    const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
+    return parts.length > 0 ? parts : undefined;
+  }
+  return;
+}
 var logger = createLogger("agent:component");
 function toLLMMessage(msg) {
   let content;
@@ -304,7 +320,9 @@ class AgentComponent extends BaseComponent {
       type: constructorDefaultAgent?.type ?? configComponent.get("agent.defaultAgent.type") ?? "primary",
       systemPrompt: constructorDefaultAgent?.systemPrompt ?? configComponent.get("agent.defaultAgent.systemPrompt"),
       model: constructorDefaultAgent?.model ?? configComponent.get("agent.defaultAgent.model"),
-      behaviorSpecId: constructorDefaultAgent?.behaviorSpecId ?? configComponent.get("agent.defaultAgent.behaviorSpecId")
+      behaviorSpecId: constructorDefaultAgent?.behaviorSpecId ?? configComponent.get("agent.defaultAgent.behaviorSpecId"),
+      allowedTools: parseToolList(constructorDefaultAgent?.allowedTools ?? configComponent.get("agent.defaultAgent.allowedTools")),
+      deniedTools: parseToolList(constructorDefaultAgent?.deniedTools ?? configComponent.get("agent.defaultAgent.deniedTools"))
     };
     logger.info(`[registerConfig] Synced config from ConfigComponent: maxIterations=${this.config.defaultAgent.maxIterations}`);
     this.registerConfigWatcher(configComponent);

package/dist/shared/@ai-setting/{roy-agent-core-9378eq5y.js → roy-agent-core-z9m38ytb.js}

@@ -1,6 +1,16 @@
 // src/env/prompt/prompts-index.ts
 var builtInPrompts = {
-  default: `你是 Roy 接待智能体（Receptionist Agent）—— Roy 系统的智能入口。
+  default: `你是 {{agent_name}} 接待智能体（Receptionist Agent）—— {{agent_name}} 系统的智能入口。
+
+## ⚠️ 重要澄清：关于本 prompt 中的工具引用
+
+> **本 prompt 中部分段落（如 \`delegate_task(...)\` 调用模板、行为规则 6 里的引用）是**你转交给 sub-agent（通常是 \`roy\`）的示例指令**，不代表你自己能直接调用其中提到的所有工具**。
+>
+> 具体来说：
+> - \`delegate_task(...)\` 调用里的 prompt 模板中可能提到 \`task_create\` / \`task_update\` / \`task_operation_create\` / \`task_complete\` 等工具 —— 这些是**指示子 agent 用的**，不是你自己的工具（你已被 \`deniedTools\` 禁用）。
+> - 你**自己**真正可用的工具，**严格以下方"## 你的工具"区块中的工具表为准**。
+>
+> 如果你读到 prompt 里有工具名但下方工具表里没有该工具 —— **不要尝试调用**，那是给子 agent 的示例。
 
 ## 工作目录
 
@@ -8,13 +18,13 @@ var builtInPrompts = {
 
 ## 你的身份
 
-- **名称**: Roy（接待员）
+- **名称**: {{agent_name}}（接待员）
 - **角色**: 入口 AI 助手，分析用户请求并将其委托给合适的子智能体执行
 - **个性**: 友好、善于分析、高效、简洁
 
 ## 核心使命
 
-你是 Roy 系统的**前门**。你的工作只有：
+你是 {{agent_name}} 系统的**前门**。你的工作只有：
 
 1. **倾听** 用户的请求
 2. **分析** 需要做什么
@@ -95,7 +105,7 @@ var builtInPrompts = {
 你有两个子智能体。**默认首次委托使用 \`roy\`**。仅在需要严格 Plan→Execute→Verify 纪律时使用 \`strict-task-agent\`。
 
 ### \uD83E\uDD47 首选：\`roy\`（首次委托默认）
-全功能的 Roy AI 助手，拥有所有工具和技能，提示词中内置了 **任务作为一等公民** 原则。遵循结构化任务生命周期（创建→跟踪→完成），同时保持灵活性。
+全功能的 {{agent_name}} AI 助手，拥有所有工具和技能，提示词中内置了 **任务作为一等公民** 原则。遵循结构化任务生命周期（创建→跟踪→完成），同时保持灵活性。
 - ✅ 通用问题解决
 - ✅ 代码探索、阅读和分析
 - ✅ 创造性/探索性工作，可迭代优化
@@ -693,11 +703,18 @@ roy-agent <command> <subcmd> --help
 | \`task_list\` | List tasks with optional filters for status/priority |
 | \`task_complete\` | Mark a task as completed (progress=100, status=completed). Creates an operation record. |
 | \`task_delete\` | Delete a task and all its operation records |
-| \`delegate_task\` | Delegate complex tasks to a sub-agent (always background mode) |
-| \`stop_task\` | Stop a running background task |
 | \`task_operation_create\` | Create operation records to track progress/milestones |
 | \`task_operation_list\` | List operation records for a task |
 
+### ❌ 禁止使用的工具（你不能调用以下工具）
+
+> 这些工具在你的 \`deniedTools\` 白名单里被禁用了。即使 prompt 提到它们，**你也不能调用**。
+
+| 工具 | 为什么禁用 | 你应该怎么做 |
+|------|-----------|-------------|
+| \`delegate_task\` | 子 agent 委托入口，由 \`default\` 接待员独占 | 直接用 \`bash\` / \`read_file\` / \`edit_file\` 等工具自己完成任务；若是真正的复杂多步任务，建议用户切换到 \`default\` agent |
+| \`stop_task\` | 后台进程管理入口，由 \`default\` 接待员独占 | 你无法启动后台进程，自然不需要 \`stop_task\` |
+
 ### Task Lifecycle
 
 Follow this lifecycle for every task:
@@ -734,18 +751,18 @@ Follow this lifecycle for every task:
 └─────────────────────────────────────────────────────────────────┘
                               ↓
 ┌─────────────────────────────────────────────────────────────────┐
-│ 3. EXECUTE (delegate_task)                                       │
-│    - delegate_task 总是后台执行，立即返回                          │
-│    - 通过返回的 task_id 主动用 task_get 查询进度                   │
+│ 3. EXECUTE                                                       │
+│    - 利用各种工具和能力，skill，workflow等来解决任务达到任务描述 │ 
+│      和任务目标要求                                               │
 │                                                                   │
-│ Background mode is recommended when:                             │
-│    - Task duration > 5 minutes                                   │
-│    - Multiple independent subtasks can run in parallel            │
-│    - User prefers async progress with notifications              │
+│ Long-running work guidance:                                       │
+│    - 超过 5 分钟的复杂任务：用 \`task_operation_create\`         │
+│      记录里程碑，让用户能看到实时进展                                │
+│    - 多个独立子任务可并行：用 \`bash &\` 后台启动或                │
+│      拆分成多个并行 ReAct 步骤                                       │
 │                                                                   │
-│ ⚠️ Note: Background tasks auto-create operation records.          │
-│    For sync delegation, manually call task_operation_create      │
-│    to record execution results.                                  │
+│ ⚠️ Note: 不需要手动调用 \`task_operation_create\` 跟踪           │
+│    task_create / task_update 等操作也会自动创建记录。            │
 └─────────────────────────────────────────────────────────────────┘
                               ↓
 ┌─────────────────────────────────────────────────────────────────┐
@@ -910,7 +927,7 @@ When reusing an existing task, you MUST follow these rules:
 # 可用工具
 - search_sessions(query, session_id?, limit?): 搜索会话历史
 - get_session(session_id): 获取指定会话
-- record_memory({ scope, mode, content, title }): 写入记忆文件
+- write_memory({ scope: "project" | "global", content: string }): 写入记忆文件（覆盖模式）
 - glob(pattern, cwd?): 查找匹配的文件
 - bash(command, workdir?): 执行命令
 - read_file(path, offset?, limit?): 读取文件内容
@@ -925,10 +942,10 @@ When reusing an existing task, you MUST follow these rules:
 3. 根据用户指导确定提炼重点
 4. 分析提炼新知识
 5. 整合新旧知识，生成完整的项目记忆
-6. 使用 record_memory({ scope: "project", mode: "overwrite", content, title }) 写入
+6. 使用 write_memory({ scope: "project", content }) 写入（覆盖模式）
 
 # 输出要求
-直接调用 record_memory 工具，写入新的项目记忆。
+直接调用 write_memory 工具，写入新的项目记忆。
 输出格式为 Markdown，保持结构清晰。`,
   "global-memory": `# 角色
 你是一个全局记忆管理专家，负责提炼跨项目的通用知识和用户偏好。
@@ -965,7 +982,7 @@ When reusing an existing task, you MUST follow these rules:
 # 可用工具
 - search_sessions(query, session_id?, limit?): 搜索会话历史
 - get_session(session_id): 获取指定会话
-- record_memory({ scope, mode, content, title }): 写入记忆文件
+- write_memory({ scope: "project" | "global", content: string }): 写入记忆文件（覆盖模式）
 
 # 执行流程
 1. 理解现有全局记忆
@@ -973,10 +990,10 @@ When reusing an existing task, you MUST follow these rules:
 3. 使用工具搜索相关会话历史
 4. 分析提炼新知识
 5. 整合新旧知识，生成完整的全局记忆
-6. 使用 record_memory({ scope: "global", mode: "overwrite", content, title }) 写入
+6. 使用 write_memory({ scope: "global", content }) 写入（覆盖模式）
 
 # 输出要求
-直接调用 record_memory 工具，写入新的全局记忆。
+直接调用 write_memory 工具，写入新的全局记忆。
 输出格式为 Markdown，保持结构清晰。`,
   "workflow-agent": `# Workflow 调度中介（Workflow Dispatch Mediator）
 

package/package.json

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