@ai-setting/roy-agent-core 1.5.56 → 1.5.58

package/dist/config/index.js

@@ -10,7 +10,7 @@ import {
   parseJSONCWithProtocols,
   substituteEnvVars,
   substituteProtocolRefs
-} from "../shared/@ai-setting/roy-agent-core-2c9ms8gv.js";
+} from "../shared/@ai-setting/roy-agent-core-prdngx28.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/agent/index.js

@@ -1,7 +1,7 @@
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-qzhkgbyj.js";
+} from "../../shared/@ai-setting/roy-agent-core-6ph5va4n.js";
 import"../../shared/@ai-setting/roy-agent-core-65yjzwv5.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";

package/dist/env/index.js

@@ -38,14 +38,14 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-qzhkgbyj.js";
+} from "../shared/@ai-setting/roy-agent-core-6ph5va4n.js";
 import"../shared/@ai-setting/roy-agent-core-65yjzwv5.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-2tna3t64.js";
+} from "../shared/@ai-setting/roy-agent-core-skaha0yj.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-eraxs53g.js";
+import"../shared/@ai-setting/roy-agent-core-0hhxwz5f.js";
 import"../shared/@ai-setting/roy-agent-core-w4f871e2.js";
 import"../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
 import {

package/dist/env/prompt/index.js

@@ -3,7 +3,7 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-grt8ysq2.js";
+} from "../../shared/@ai-setting/roy-agent-core-q16bh5e9.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/task/delegate/index.js

@@ -3,7 +3,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-eraxs53g.js";
+} from "../../../shared/@ai-setting/roy-agent-core-0hhxwz5f.js";
 import"../../../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-92z6t4he.js";

package/dist/env/task/index.js

@@ -5,11 +5,11 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-2tna3t64.js";
+} from "../../shared/@ai-setting/roy-agent-core-skaha0yj.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-eraxs53g.js";
+import"../../shared/@ai-setting/roy-agent-core-0hhxwz5f.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   PromptStore,
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-grt8ysq2.js";
+} from "./shared/@ai-setting/roy-agent-core-q16bh5e9.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -14,7 +14,7 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-sfqx98j6.js";
 import {
   ConfigComponent
-} from "./shared/@ai-setting/roy-agent-core-2c9ms8gv.js";
+} from "./shared/@ai-setting/roy-agent-core-prdngx28.js";
 import {
   CommandsComponent
 } from "./shared/@ai-setting/roy-agent-core-7wdjpbcr.js";
@@ -114,7 +114,7 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-qzhkgbyj.js";
+} from "./shared/@ai-setting/roy-agent-core-6ph5va4n.js";
 import {
   createInvokeConfig,
   invoke,
@@ -127,9 +127,9 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-2tna3t64.js";
+} from "./shared/@ai-setting/roy-agent-core-skaha0yj.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-eraxs53g.js";
+import"./shared/@ai-setting/roy-agent-core-0hhxwz5f.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

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

@@ -9,8 +9,10 @@ import {
   init_global_hook_manager
 } from "./roy-agent-core-7tp56w6n.js";
 import {
-  init_env_context,
-  setCurrentTaskId
+  init_context
+} from "./roy-agent-core-qg4rma4c.js";
+import {
+  getCurrentTaskId
 } from "./roy-agent-core-y5d04fm3.js";
 import {
   TracedAs,
@@ -26,8 +28,8 @@ import {
 
 // src/env/task/delegate/delegate-tool.ts
 init_logger();
-init_env_context();
 init_decorator();
+init_context();
 import { z } from "zod";
 
 // src/env/task/delegate/subagent-resolver.ts
@@ -205,10 +207,7 @@ var DelegateToolParameters = z.object({
   description: z.string().describe("A short (3-5 words) description of the task"),
   prompt: z.string().describe("The task for the agent to perform"),
   subagent_type: z.string().describe("The type of specialized agent to use for this task").default("general"),
-  background: z.boolean().describe("Whether to run the task in background. If true, returns immediately and notifies when complete (default: false)").default(false),
   timeout: z.number().describe("Task timeout in milliseconds. Default: 1800000 (30 minutes). If set, task will be terminated after timeout.").optional(),
-  cleanup: z.enum(["delete", "keep"]).describe("Whether to delete sub session after completion. 'delete' removes the session, 'keep' retains it (default: keep)").default("keep").optional(),
-  task_id: z.number().describe("Optional task ID to associate with this delegate task, for tracking in operation records").optional(),
   reason: z.string().describe("Brief reason for calling this tool (max 30 chars, e.g., 'Delegate refactor task')").optional()
 });
 var DEFAULT_TIMEOUT = 1800000;
@@ -239,8 +238,8 @@ class BackgroundTaskManager {
     }
   }
   async createTask(options) {
-    const { parentSessionId, description, prompt, subagentType, timeout, cleanup, taskId } = options;
-    const taskIdGen = `task_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+    const { parentSessionId, description, prompt, subagentType, timeout } = options;
+    const taskIdGen = `process_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
     const sessionComponent = this.getSessionComponent();
     if (!sessionComponent) {
       throw new Error("SessionComponent not found");
@@ -254,9 +253,6 @@ class BackgroundTaskManager {
       created_by: "subagent",
       task_description: description
     };
-    if (taskId) {
-      metadata.task_id = taskId;
-    }
     const subSession = await sessionComponent.create({
       title: `${description} (@${subagentType} subagent)`,
       metadata
@@ -273,8 +269,7 @@ class BackgroundTaskManager {
       subagentType,
       status: "pending",
       createdAt: Date.now(),
-      abortController,
-      taskId
+      abortController
     };
     this.tasks.set(taskIdGen, task);
     this.abortControllers.set(taskIdGen, abortController);
@@ -283,11 +278,10 @@ class BackgroundTaskManager {
       subSessionId: subSession.id,
       parentSessionId,
       description,
-      subagentType,
-      associatedTaskId: taskId
+      subagentType
     };
     this.publishBackgroundEvent(BackgroundTaskEventTypes.STARTED, startedPayload, parentSessionId);
-    this.executeTask(taskIdGen, prompt, timeout, cleanup, parentSessionId).catch((err) => {
+    this.executeTask(taskIdGen, prompt, timeout, parentSessionId).catch((err) => {
       logger.error(`[BackgroundTaskManager] executeTask unhandled rejection`, {
         taskId: taskIdGen,
         error: err instanceof Error ? err.message : String(err)
@@ -295,7 +289,7 @@ class BackgroundTaskManager {
     });
     return { taskId: taskIdGen, subSessionId: subSession.id };
   }
-  async executeTask(taskId, prompt, timeout, cleanup, parentSessionId) {
+  async executeTask(taskId, prompt, timeout, parentSessionId) {
     const task = this.tasks.get(taskId);
     if (!task) {
       logger.warn(`[BackgroundTaskManager] executeTask: Task not found`, { taskId });
@@ -321,6 +315,13 @@ class BackgroundTaskManager {
       task.completedAt = Date.now();
       task.result = result;
       const executionTimeMs = task.completedAt - task.startedAt;
+      task.associatedTaskId = getCurrentTaskId();
+      if (task.associatedTaskId === undefined && result) {
+        const match = result.match(/Task\s+#?(\d+)/i);
+        if (match) {
+          task.associatedTaskId = parseInt(match[1], 10);
+        }
+      }
       const completedPayload = {
         backgroundTaskId: task.id,
         subSessionId: task.subSessionId,
@@ -329,7 +330,7 @@ class BackgroundTaskManager {
         result: task.result,
         description: task.description,
         executionTimeMs,
-        associatedTaskId: task.taskId
+        associatedTaskId: task.associatedTaskId
       };
       this.publishBackgroundEvent(BackgroundTaskEventTypes.COMPLETED, completedPayload, parentSessionId || task.parentSessionId);
       logger.info(`[BackgroundTaskManager] Task completed successfully`, {
@@ -340,6 +341,7 @@ class BackgroundTaskManager {
       const errorMessage = error instanceof Error ? error.message : String(error);
       const isStoppedError = errorMessage.toLowerCase().includes("stopped") || errorMessage.toLowerCase().includes("aborted");
       const executionTimeMs = task.startedAt ? Date.now() - task.startedAt : 0;
+      task.associatedTaskId = getCurrentTaskId();
       if (isStoppedError) {
         task.status = "stopped";
         const stoppedPayload = {
@@ -350,10 +352,10 @@ class BackgroundTaskManager {
           description: task.description,
           error: errorMessage,
           executionTimeMs,
-          associatedTaskId: task.taskId
+          associatedTaskId: task.associatedTaskId
         };
         this.publishBackgroundEvent(BackgroundTaskEventTypes.STOPPED, stoppedPayload, parentSessionId || task.parentSessionId);
-      } else if (errorMessage.includes("timeout")) {
+      } else if (errorMessage.startsWith("Task execution timeout after")) {
         task.status = "timeout";
         const timeoutPayload = {
           backgroundTaskId: task.id,
@@ -363,7 +365,7 @@ class BackgroundTaskManager {
           description: task.description,
           error: errorMessage,
           executionTimeMs,
-          associatedTaskId: task.taskId
+          associatedTaskId: task.associatedTaskId
         };
         this.publishBackgroundEvent(BackgroundTaskEventTypes.TIMEOUT, timeoutPayload, parentSessionId || task.parentSessionId);
       } else {
@@ -373,10 +375,9 @@ class BackgroundTaskManager {
           subSessionId: task.subSessionId,
           parentSessionId: parentSessionId || task.parentSessionId,
           status: "failed",
-          description: task.description,
           error: errorMessage,
           executionTimeMs,
-          associatedTaskId: task.taskId
+          associatedTaskId: task.associatedTaskId
         };
         this.publishBackgroundEvent(BackgroundTaskEventTypes.FAILED, failedPayload, parentSessionId || task.parentSessionId);
       }
@@ -402,13 +403,18 @@ class BackgroundTaskManager {
         const elapsedMs = Date.now() - task.startedAt;
         task.progress = Math.min(95, Math.floor(elapsedMs / PROGRESS_INTERVAL * 100));
       }
+      const currentTaskId = getCurrentTaskId();
+      if (currentTaskId !== undefined) {
+        task.associatedTaskId = currentTaskId;
+      }
       const progressPayload = {
         backgroundTaskId: taskId,
         subSessionId: task.subSessionId,
         parentSessionId,
         description: task.description,
         status: task.status,
-        progress: task.progress
+        progress: task.progress,
+        associatedTaskId: task.associatedTaskId
       };
       this.publishBackgroundEvent(BackgroundTaskEventTypes.PROGRESS, progressPayload, parentSessionId);
     }, PROGRESS_INTERVAL);
@@ -453,7 +459,8 @@ ${prompt}
 ## 执行规范
 - 使用可用工具完成任务
 - 返回清晰的任务执行结果摘要
-- 适时调用 task_operation_create 记录进展`;
+- 适时调用 task_operation_create 记录进展
+- 如果你通过 task_create 创建了任务，请在最终响应中明确报告 task_id（例如：Task #627）`;
     if (!agentComponent) {
       throw new Error("AgentComponent not found");
     }
@@ -471,15 +478,26 @@ ${prompt}
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
         reject(new Error(`Task execution timeout after ${timeoutMs}ms`));
+        try {
+          agentComponent?.abort?.(subagentType);
+        } catch {}
       }, timeoutMs);
       signal?.addEventListener("abort", () => {
         clearTimeout(timer);
+        try {
+          const env = this.env;
+          const agentComp = env?.getComponent?.("agent");
+          if (agentComp?.abort) {
+            agentComp.abort(subagentType);
+          }
+        } catch {}
         reject(new Error("Task execution stopped"));
       });
       this.env.handle_query?.(delegateQuery, {
         sessionId,
         deniedTools: deniedTools.length > 0 ? deniedTools : undefined,
-        agentType: subagentType
+        agentType: subagentType,
+        abort: signal
       })?.then((result) => {
         clearTimeout(timer);
         resolve(result);
@@ -512,7 +530,7 @@ ${prompt}
       description: task.description,
       error: "Task stopped by user",
       executionTimeMs: task.startedAt ? task.completedAt - task.startedAt : 0,
-      associatedTaskId: task.taskId
+      associatedTaskId: task.associatedTaskId
     };
     this.publishBackgroundEvent(BackgroundTaskEventTypes.STOPPED, stoppedPayload, task.parentSessionId);
     return { success: true, task, message: "Task has been stopped" };
@@ -554,7 +572,8 @@ function getAgentRegistry(taskComponent) {
 }
 function createDelegateTool(taskComponent) {
   const env = taskComponent.env;
-  const backgroundTaskManager = new BackgroundTaskManager(env);
+  const existingManager = taskComponent.backgroundTaskManager;
+  const backgroundTaskManager = existingManager ?? new BackgroundTaskManager(env);
   const registry = getAgentRegistry(taskComponent);
   taskComponent._backgroundTaskManager = backgroundTaskManager;
   const tool = {
@@ -569,26 +588,35 @@ When using the delegate_task tool, you must specify a subagent_type parameter to
 ## When to use delegate_task:
 - When you need to perform complex, multi-step tasks that require independent execution
 - When you need to explore a codebase thoroughly (use "explore" subagent)
-- When you need to run long-running tasks without blocking the main agent (use background=true)
+- When you need to run long-running tasks without blocking the main agent
+
+## How it works:
+This tool **always runs in background mode**. It returns immediately with:
+- **bgProcessId**: Internal background process ID (use with \`stop_task\` to cancel, different from Task #)
+- **subSessionId**: Sub-agent session ID (use with \`session_get\` to see full execution log, always retained)
+
+**After delegating, just WAIT for the notification.** The background process will automatically notify you when:
+- ✅ **completed** — with \`bgprocess:\` + \`Task #\` (if it created a task) + result summary
+- ⏱️ **timeout** — with \`bgprocess:\` + \`Task #\` (if available)
+- ❌ **failed** — with \`bgprocess:\` + \`Task #\` + error details
+- \uD83D\uDED1 **stopped** — with \`bgprocess:\` + \`Task #\`
+
+The sub-agent runs independently and creates its own tasks via \`task_create\`.
+No need to poll — just wait for the notification and use \`task_get\` with the Task # reported in it.
 
 ## Parameters:
 - **description**: A short (3-5 words) description of the task
 - **prompt**: The task for the agent to perform
 - **subagent_type**: The type of specialized agent to use (e.g., "general", "explore")
-- **background**: Whether to run in background (default: false)
-- **timeout**: Task timeout in milliseconds (optional)
-- **task_id**: Optional task ID to associate with this delegate task
-
-## Synchronous vs Background mode:
-**Synchronous mode (default)**: Waits for subagent to complete and returns result directly
-**Background mode (background=true)**: Returns immediately with "accepted" status, runs independently`,
+- **timeout**: Task timeout in milliseconds (optional, default 30 minutes)
+- **reason**: Brief reason for calling this tool (optional)`,
     parameters: DelegateToolParameters,
     execute: async (args, ctx) => {
       const startTime = Date.now();
       const params = DelegateToolParameters.parse(args);
-      const { description, prompt, subagent_type = "general", background = false, timeout, cleanup, task_id, reason } = params;
+      const { description, prompt, subagent_type = "general", timeout, reason } = params;
       const parentSessionId = ctx.session_id || "default";
-      logger.info(`[delegate_task] Called: description=${description}, subagent_type=${subagent_type}, background=${background}, task_id=${task_id}`);
+      logger.info(`[delegate_task] Called: description=${description}, subagent_type=${subagent_type}`);
       const registry2 = getAgentRegistry(taskComponent);
       if (!isKnownSubagentType(subagent_type, registry2)) {
         return {
@@ -601,12 +629,9 @@ When using the delegate_task tool, you must specify a subagent_type parameter to
       const tagService = taskComponent.getTagService();
       let promptWithTaskInfo = prompt;
       const delegateCtx = {
-        taskId: task_id,
         prompt: promptWithTaskInfo,
         subagentType: subagent_type,
-        background,
         timeout,
-        cleanup,
         reason,
         tagService
       };
@@ -619,212 +644,31 @@ When using the delegate_task tool, you must specify a subagent_type parameter to
       };
       await globalHookManager.execute(TaskHookPoints.DELEGATE_BEFORE, hookCtx, { sessionId: parentSessionId });
       promptWithTaskInfo = delegateCtx.prompt;
-      if (background) {
-        return await handleBackgroundTask(taskComponent, backgroundTaskManager, parentSessionId, description, promptWithTaskInfo, delegateCtx.subagentType, delegateCtx.timeout, delegateCtx.cleanup, delegateCtx.taskId);
-      } else {
-        return await handleSyncTask(taskComponent, parentSessionId, description, promptWithTaskInfo, delegateCtx.subagentType, delegateCtx.timeout, delegateCtx.taskId);
-      }
+      return await handleBackgroundTask(backgroundTaskManager, parentSessionId, description, promptWithTaskInfo, delegateCtx.subagentType, delegateCtx.timeout);
     }
   };
   return tool;
 }
-async function handleSyncTask(taskComponent, parentSessionId, description, prompt, subagentType, timeout, taskId) {
-  const startTime = Date.now();
-  try {
-    const sessionComponent = taskComponent.env?.getComponent?.("session");
-    if (!sessionComponent) {
-      return {
-        success: false,
-        output: "",
-        error: "SessionComponent not found",
-        metadata: { execution_time_ms: Date.now() - startTime }
-      };
-    }
-    const parentSession = await sessionComponent.get(parentSessionId);
-    if (!parentSession) {
-      return {
-        success: false,
-        output: "",
-        error: `Parent session not found: ${parentSessionId}`,
-        metadata: { execution_time_ms: Date.now() - startTime }
-      };
-    }
-    const metadata = {
-      subagent_type: subagentType,
-      created_by: "subagent",
-      task_description: description
-    };
-    if (taskId) {
-      metadata.task_id = taskId;
-    }
-    const subSession = await sessionComponent.create({
-      parentID: parentSessionId,
-      title: `${description} (@${subagentType} subagent)`,
-      metadata
-    });
-    if (!subSession) {
-      return {
-        success: false,
-        output: "",
-        error: "Failed to create sub-session",
-        metadata: { execution_time_ms: Date.now() - startTime }
-      };
-    }
-    const agentComponent = taskComponent.env?.getComponent?.("agent");
-    const registry = getAgentRegistry(taskComponent);
-    const resolved = await resolveSubAgentConfig(subagentType, { registry });
-    const subAgent = getSubAgentSpec(subagentType);
-    let basePrompt = resolved?.basePrompt || subAgent?.promptOverride || `You are a subagent. Complete this task: {task_description}`;
-    const deniedTools = resolved?.deniedTools || subAgent?.deniedTools || [];
-    const allowedTools = resolved?.allowedTools || subAgent?.allowedTools;
-    let fullPrompt = basePrompt.replace(/{task_description}/g, description || "N/A");
-    fullPrompt += `
-
----
-
-# Session Info
-- task_id: ${taskId || "N/A"}
-- session_id: ${subSession.id}
-
----
-
-## 用户指令
-${prompt}
-
----
-
-## 执行规范
-- 使用可用工具完成任务
-- 返回清晰的任务执行结果摘要
-- 适时调用 task_operation_create 记录进展`;
-    if (!agentComponent) {
-      return {
-        success: false,
-        output: "",
-        error: "AgentComponent not found",
-        metadata: { execution_time_ms: Date.now() - startTime }
-      };
-    }
-    const subAgentForRegister = subAgent ? { ...subAgent, allowedTools } : allowedTools ? {
-      id: subagentType,
-      name: subagentType,
-      mode: "subagent",
-      description: resolved?.description || "Custom agent",
-      allowedTools,
-      deniedTools
-    } : undefined;
-    ensureSubAgentRegistered(agentComponent, subagentType, basePrompt, subAgentForRegister, deniedTools);
-    const isWorkflowAgent = registry?.get(subagentType)?.type === "workflow";
-    const delegateQuery = isWorkflowAgent ? prompt : fullPrompt;
-    const timeoutMs = timeout || DEFAULT_TIMEOUT;
-    let result;
-    try {
-      result = await Promise.race([
-        taskComponent.env?.handle_query?.(delegateQuery, {
-          sessionId: subSession.id,
-          deniedTools: deniedTools.length > 0 ? deniedTools : undefined,
-          agentType: subagentType
-        }),
-        new Promise((_, reject) => setTimeout(() => reject(new Error(`Task execution timeout after ${timeoutMs}ms`)), timeoutMs))
-      ]);
-    } catch (error) {
-      result = error instanceof Error ? error.message : String(error);
-    }
-    await sessionComponent.addMessage(subSession.id, {
-      role: "assistant",
-      content: result
-    });
-    let taskNotification = "";
-    if (taskId) {
-      taskNotification = `
-
----
-\uD83D\uDCCB [委托任务完成] 已委托子智能体完成 Task #${taskId} 的处理工作，请知悉。可通过 task_get #${taskId} 查看最新状态。`;
-    }
-    setCurrentTaskId(undefined);
-    logger.info(`[delegate_task.sync] Task completed, currentTaskId cleared from EnvContext${taskId ? ` (was: #${taskId})` : ""}`);
-    return {
-      success: true,
-      output: result + taskNotification + `
-
-` + [
-        "<task_metadata>",
-        `session_id: ${subSession.id}`,
-        `subagent_type: ${subagentType}`,
-        "</task_metadata>"
-      ].join(`
-`),
-      metadata: {
-        execution_time_ms: Date.now() - startTime,
-        sessionId: subSession.id
-      }
-    };
-  } catch (error) {
-    setCurrentTaskId(undefined);
-    logger.info(`[delegate_task.sync] Error occurred, currentTaskId cleared from EnvContext${taskId ? ` (was: #${taskId})` : ""}`);
-    return {
-      success: false,
-      output: "",
-      error: error instanceof Error ? error.message : String(error),
-      metadata: { execution_time_ms: Date.now() - startTime }
-    };
-  }
-}
-async function handleBackgroundTask(taskComponent, backgroundTaskManager, parentSessionId, description, prompt, subagentType, timeout, cleanup, taskId) {
+async function handleBackgroundTask(backgroundTaskManager, parentSessionId, description, prompt, subagentType, timeout) {
   const startTime = Date.now();
   try {
-    let associatedTaskId = taskId;
-    if (!associatedTaskId) {
-      const newTask = await taskComponent.createTask({
-        title: description,
-        description: `Background task delegated to ${subagentType} subagent`,
-        priority: "medium",
-        goals_and_expected_deliverables: prompt,
-        sessionId: parentSessionId,
-        project_path: "unknown",
-        context: "unknown"
-      });
-      associatedTaskId = newTask.id;
-      await taskComponent.createOperation({
-        taskId: associatedTaskId,
-        sessionId: parentSessionId,
-        actionType: "create",
-        actionTitle: `Delegated to ${subagentType} subagent`,
-        actionDescription: `Background task started: ${description}`
-      });
-    } else {
-      await taskComponent.updateTask(associatedTaskId, {
-        status: "active",
-        current_status: `Running ${subagentType} subagent`
-      });
-      await taskComponent.createOperation({
-        taskId: associatedTaskId,
-        sessionId: parentSessionId,
-        actionType: "progress",
-        actionTitle: `Started ${subagentType} subagent`,
-        actionDescription: `Background task: ${description}`
-      });
-    }
-    const { taskId: bgTaskId, subSessionId } = await backgroundTaskManager.createTask({
+    const { taskId: bgProcessId, subSessionId } = await backgroundTaskManager.createTask({
       parentSessionId,
       description,
       prompt,
       subagentType,
-      timeout,
-      cleanup,
-      taskId: associatedTaskId
+      timeout
     });
     const output = [
       `✅ Background task accepted`,
       "",
-      `\uD83D\uDCCB Task ID: ${bgTaskId}`,
+      `\uD83D\uDCCB Process ID: ${bgProcessId}`,
       `\uD83D\uDCDD Description: ${description}`,
       `\uD83E\uDD16 Sub-agent: ${subagentType}`,
-      associatedTaskId ? `\uD83D\uDCCC Associated Task: #${associatedTaskId}` : "",
       `⏱️ Timeout: ${(timeout || DEFAULT_TIMEOUT) / 1000}s`,
       "",
-      `Use stop_task with task_id="${bgTaskId}" to cancel this task.`
-    ].filter(Boolean).join(`
+      `Use stop_task with task_id="${bgProcessId}" to cancel this task.`
+    ].join(`
 `);
     return {
       success: true,
@@ -834,8 +678,7 @@ async function handleBackgroundTask(taskComponent, backgroundTaskManager, parent
         sessionId: subSessionId,
         background: true,
         status: "accepted",
-        task_id: associatedTaskId,
-        bgTaskId
+        bgProcessId
       }
     };
   } catch (error) {

package/dist/shared/@ai-setting/{roy-agent-core-qzhkgbyj.js → roy-agent-core-6ph5va4n.js}

@@ -572,6 +572,7 @@ class AgentComponent extends BaseComponent {
     const parentEnvContext = getEnvContext();
     const envContext = {
       ...parentEnvContext,
+      agentContext: parentEnvContext?.agentContext ?? {},
       traceId: effectiveContext.metadata?.traceId,
       sessionId: effectiveContext.sessionId,
       userId: effectiveContext.metadata?.userId ?? "",

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

@@ -339,7 +339,7 @@ class FileSource {
     }
     try {
       this.watcherHandle = fsSync.watch(this.filePath, async (eventType) => {
-        if (eventType === "change") {
+        if (eventType === "change" || eventType === "rename") {
           await new Promise((r) => setTimeout(r, 50));
           await this.reloadFromFile();
         }

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

@@ -163,18 +163,21 @@ var builtInPrompts = {
 
 **roy** 的提示词中内置了任务生命周期——它知道如何使用 \`task_create\`、\`task_update\`、\`task_operation_create\` 和 \`task_complete\` 来跟踪每项工作。
 
-推荐使用（长时间运行任务使用后台模式）：
+推荐使用：
 \`\`\`
 delegate_task(
   description="简要 3-5 字摘要",
   prompt="详细说明。
 
 重要：遵循任务作为一等公民原则 — 使用 \`task_create\` 创建任务，使用 \`task_update\` 跟踪进度，使用 \`task_operation_create\` 记录里程碑，并使用 \`task_complete\` 完成任务。",
-  subagent_type="roy",
-  background=true
+  subagent_type="roy"
 )
 \`\`\`
 
+> **提示**：\`delegate_task\` 现在**总是后台模式**，立即返回。父 agent 通过返回的 \`task_id\` 用 \`task_get\` 查询进度。
+> - delegate_task 内部自动创建关联 Task，调用方无需传入 \`task_id\`
+> - sub-session 始终保留（不会自动删除），可通过 \`session_get\` 查看完整执行日志
+
 ### \uD83E\uDD48 次选：\`strict-task-agent\`（需要严格验证时使用）
 结构化 Plan → Execute → Verify 工作流智能体，内置自动重试（最多 8 次）。在以下情况使用：
 - **复杂功能开发** — 需要严格的 Plan→Execute→Verify 纪律
@@ -468,7 +471,7 @@ 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 (sync or background mode) |
+| \`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 |
@@ -510,9 +513,8 @@ Follow this lifecycle for every task:
                               ↓
 ┌─────────────────────────────────────────────────────────────────┐
 │ 3. EXECUTE (delegate_task)                                       │
-│    - Delegate sub-tasks to sub-agents for parallel execution     │
-│    - Use background mode (background=true) for long-running      │
-│      tasks to avoid blocking                                     │
+│    - delegate_task 总是后台执行，立即返回                          │
+│    - 通过返回的 task_id 主动用 task_get 查询进度                   │
 │                                                                   │
 │ Background mode is recommended when:                             │
 │    - Task duration > 5 minutes                                   │

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

@@ -5,7 +5,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-eraxs53g.js";
+} from "./roy-agent-core-0hhxwz5f.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

package/package.json

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