@ai-setting/roy-agent-core 1.6.19 → 1.6.21

package/dist/env/agent/index.js

@@ -2,12 +2,12 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-qyb2z42s.js";
+} from "../../shared/@ai-setting/roy-agent-core-zeztnvvb.js";
 import"../../shared/@ai-setting/roy-agent-core-8n0e62y4.js";
 import"../../shared/@ai-setting/roy-agent-core-eskgj8nc.js";
 import"../../shared/@ai-setting/roy-agent-core-ataagh3a.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
+import"../../shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-7r72622v.js";

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

@@ -11,7 +11,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-8wd5awxg.js";
+} from "../../shared/@ai-setting/roy-agent-core-bwqjwa0d.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -22,13 +22,13 @@ import {
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ds5f75pg.js";
 import"../../shared/@ai-setting/roy-agent-core-1qjgwjjs.js";
-import"../../shared/@ai-setting/roy-agent-core-btp589bw.js";
+import"../../shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
 import"../../shared/@ai-setting/roy-agent-core-bq1gskrf.js";
 import"../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-4djnmd86.js";
+import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-akb8mb9v.js";

package/dist/env/index.js

@@ -1,11 +1,11 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-m0wy7p0q.js";
+} from "../shared/@ai-setting/roy-agent-core-b9q2jfx4.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-8wd5awxg.js";
+} from "../shared/@ai-setting/roy-agent-core-bwqjwa0d.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -17,11 +17,11 @@ import"../shared/@ai-setting/roy-agent-core-1qjgwjjs.js";
 import {
   PluginComponent
 } from "../shared/@ai-setting/roy-agent-core-gc75v3px.js";
-import"../shared/@ai-setting/roy-agent-core-btp589bw.js";
+import"../shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-mekk4as5.js";
+} from "../shared/@ai-setting/roy-agent-core-q06h6qf8.js";
 import"../shared/@ai-setting/roy-agent-core-77wfej1h.js";
 import"../shared/@ai-setting/roy-agent-core-f1cjs6c4.js";
 import"../shared/@ai-setting/roy-agent-core-6atd905e.js";
@@ -30,7 +30,7 @@ import"../shared/@ai-setting/roy-agent-core-ez91vxas.js";
 import"../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"../shared/@ai-setting/roy-agent-core-hhrg314p.js";
 import"../shared/@ai-setting/roy-agent-core-7kw06e4b.js";
-import"../shared/@ai-setting/roy-agent-core-kkt2ndpf.js";
+import"../shared/@ai-setting/roy-agent-core-j8t1tyhr.js";
 import"../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../shared/@ai-setting/roy-agent-core-r15sn7ve.js";
 import"../shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
@@ -41,22 +41,22 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-qyb2z42s.js";
+} from "../shared/@ai-setting/roy-agent-core-zeztnvvb.js";
 import"../shared/@ai-setting/roy-agent-core-8n0e62y4.js";
 import"../shared/@ai-setting/roy-agent-core-eskgj8nc.js";
 import"../shared/@ai-setting/roy-agent-core-ataagh3a.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-5kc9qtej.js";
+} from "../shared/@ai-setting/roy-agent-core-bb20se79.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-mqeqevym.js";
+import"../shared/@ai-setting/roy-agent-core-zvwdfm79.js";
 import"../shared/@ai-setting/roy-agent-core-44g3synv.js";
 import"../shared/@ai-setting/roy-agent-core-zdzkzx5g.js";
-import"../shared/@ai-setting/roy-agent-core-4djnmd86.js";
+import"../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../shared/@ai-setting/roy-agent-core-tycbpm17.js";
+import"../shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import {
   XDG_PATHS,
   getXDGPath,
@@ -71,9 +71,9 @@ import {
 import"../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../shared/@ai-setting/roy-agent-core-fnv3ev18.js";
 import"../shared/@ai-setting/roy-agent-core-mdp8y7ky.js";
-import"../shared/@ai-setting/roy-agent-core-bqe4c9f2.js";
+import"../shared/@ai-setting/roy-agent-core-kr58bgz0.js";
 import"../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
-import"../shared/@ai-setting/roy-agent-core-zs4f0tcy.js";
+import"../shared/@ai-setting/roy-agent-core-xjj88tpn.js";
 import"../shared/@ai-setting/roy-agent-core-7r72622v.js";
 import"../shared/@ai-setting/roy-agent-core-e0kaxcy1.js";
 import"../shared/@ai-setting/roy-agent-core-7hh0brvs.js";

package/dist/env/prompt/index.js

@@ -3,8 +3,8 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-5ka95kh7.js";
-import"../../shared/@ai-setting/roy-agent-core-4djnmd86.js";
+} from "../../shared/@ai-setting/roy-agent-core-ett06sn8.js";
+import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-akb8mb9v.js";

package/dist/env/session/index.js

@@ -3,11 +3,11 @@ import {
   MIN_SESSION_ID_LENGTH,
   SessionComponent,
   isValidSessionId
-} from "../../shared/@ai-setting/roy-agent-core-bqe4c9f2.js";
+} from "../../shared/@ai-setting/roy-agent-core-kr58bgz0.js";
 import"../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
 import {
   MemorySessionStore
-} from "../../shared/@ai-setting/roy-agent-core-zs4f0tcy.js";
+} from "../../shared/@ai-setting/roy-agent-core-xjj88tpn.js";
 import {
   SessionMessageConverter
 } from "../../shared/@ai-setting/roy-agent-core-7r72622v.js";

package/dist/env/session/storage/index.js

@@ -3,7 +3,7 @@ import {
   SQLiteSessionStore,
   getDefaultDataDir,
   getDefaultSessionDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-zs4f0tcy.js";
+} from "../../../shared/@ai-setting/roy-agent-core-xjj88tpn.js";
 import"../../../shared/@ai-setting/roy-agent-core-7r72622v.js";
 import"../../../shared/@ai-setting/roy-agent-core-e0kaxcy1.js";
 import"../../../shared/@ai-setting/roy-agent-core-nna4s0qs.js";

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

@@ -3,11 +3,11 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-mqeqevym.js";
+} from "../../../shared/@ai-setting/roy-agent-core-zvwdfm79.js";
 import"../../../shared/@ai-setting/roy-agent-core-44g3synv.js";
-import"../../../shared/@ai-setting/roy-agent-core-4djnmd86.js";
+import"../../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
+import"../../../shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-vc7p80sd.js";

package/dist/env/task/index.js

@@ -5,20 +5,20 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-5kc9qtej.js";
+} from "../../shared/@ai-setting/roy-agent-core-bb20se79.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-mqeqevym.js";
+import"../../shared/@ai-setting/roy-agent-core-zvwdfm79.js";
 import"../../shared/@ai-setting/roy-agent-core-44g3synv.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-zdzkzx5g.js";
-import"../../shared/@ai-setting/roy-agent-core-4djnmd86.js";
+import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../shared/@ai-setting/roy-agent-core-tycbpm17.js";
+import"../../shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c7e3htaq.js";
 import"../../shared/@ai-setting/roy-agent-core-rn57psp0.js";

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

@@ -8,13 +8,13 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-btp589bw.js";
+} from "../../../shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
 import"../../../shared/@ai-setting/roy-agent-core-bq1gskrf.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../../shared/@ai-setting/roy-agent-core-4djnmd86.js";
+import"../../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-sqt96sam.js";
 import"../../../shared/@ai-setting/roy-agent-core-dtkbj8fk.js";

package/dist/env/workflow/index.js

@@ -1,6 +1,6 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-mekk4as5.js";
+} from "../../shared/@ai-setting/roy-agent-core-q06h6qf8.js";
 import"../../shared/@ai-setting/roy-agent-core-77wfej1h.js";
 import"../../shared/@ai-setting/roy-agent-core-f1cjs6c4.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
@@ -9,7 +9,7 @@ import"../../shared/@ai-setting/roy-agent-core-ez91vxas.js";
 import"../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"../../shared/@ai-setting/roy-agent-core-hhrg314p.js";
 import"../../shared/@ai-setting/roy-agent-core-7kw06e4b.js";
-import"../../shared/@ai-setting/roy-agent-core-kkt2ndpf.js";
+import"../../shared/@ai-setting/roy-agent-core-j8t1tyhr.js";
 import"../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../shared/@ai-setting/roy-agent-core-r15sn7ve.js";
 import"../../shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
@@ -84,9 +84,9 @@ import {
   createWorkflowAskUserEvent
 } from "../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../shared/@ai-setting/roy-agent-core-bqe4c9f2.js";
+import"../../shared/@ai-setting/roy-agent-core-kr58bgz0.js";
 import"../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
-import"../../shared/@ai-setting/roy-agent-core-zs4f0tcy.js";
+import"../../shared/@ai-setting/roy-agent-core-xjj88tpn.js";
 import"../../shared/@ai-setting/roy-agent-core-7r72622v.js";
 import"../../shared/@ai-setting/roy-agent-core-e0kaxcy1.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";

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

@@ -24,7 +24,7 @@ import {
   getRunWorkflowTool,
   initRunWorkflowTool,
   resetRunWorkflowTool
-} from "../../../shared/@ai-setting/roy-agent-core-kkt2ndpf.js";
+} from "../../../shared/@ai-setting/roy-agent-core-j8t1tyhr.js";
 import {
   WORKFLOW_SUBMIT_OUTPUT_TOOL_NAME,
   WorkflowJsonOutputMarker,
@@ -38,9 +38,9 @@ import"../../../shared/@ai-setting/roy-agent-core-bq1gskrf.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../../shared/@ai-setting/roy-agent-core-bqe4c9f2.js";
+import"../../../shared/@ai-setting/roy-agent-core-kr58bgz0.js";
 import"../../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
-import"../../../shared/@ai-setting/roy-agent-core-zs4f0tcy.js";
+import"../../../shared/@ai-setting/roy-agent-core-xjj88tpn.js";
 import"../../../shared/@ai-setting/roy-agent-core-7r72622v.js";
 import"../../../shared/@ai-setting/roy-agent-core-e0kaxcy1.js";
 import"../../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   PromptComponent,
   PromptStore
-} from "./shared/@ai-setting/roy-agent-core-5ka95kh7.js";
+} from "./shared/@ai-setting/roy-agent-core-ett06sn8.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -63,7 +63,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-m0wy7p0q.js";
+} from "./shared/@ai-setting/roy-agent-core-b9q2jfx4.js";
 import {
   BountyIMInstance,
   EventSourceComponent,
@@ -76,7 +76,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-8wd5awxg.js";
+} from "./shared/@ai-setting/roy-agent-core-bwqjwa0d.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -96,13 +96,13 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-btp589bw.js";
+} from "./shared/@ai-setting/roy-agent-core-grajzyhd.js";
 import {
   BasePlugin
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "./shared/@ai-setting/roy-agent-core-mekk4as5.js";
+} from "./shared/@ai-setting/roy-agent-core-q06h6qf8.js";
 import {
   init_node_registry_helper,
   registerDecoratorNodeType
@@ -114,7 +114,7 @@ import"./shared/@ai-setting/roy-agent-core-ez91vxas.js";
 import"./shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"./shared/@ai-setting/roy-agent-core-hhrg314p.js";
 import"./shared/@ai-setting/roy-agent-core-7kw06e4b.js";
-import"./shared/@ai-setting/roy-agent-core-kkt2ndpf.js";
+import"./shared/@ai-setting/roy-agent-core-j8t1tyhr.js";
 import"./shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"./shared/@ai-setting/roy-agent-core-r15sn7ve.js";
 import"./shared/@ai-setting/roy-agent-core-1mrc9a1r.js";
@@ -131,7 +131,7 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-qyb2z42s.js";
+} from "./shared/@ai-setting/roy-agent-core-zeztnvvb.js";
 import {
   createInvokeConfig,
   invoke,
@@ -150,10 +150,10 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-5kc9qtej.js";
+} from "./shared/@ai-setting/roy-agent-core-bb20se79.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-mqeqevym.js";
+import"./shared/@ai-setting/roy-agent-core-zvwdfm79.js";
 import"./shared/@ai-setting/roy-agent-core-44g3synv.js";
 import {
   SQLiteTaskStore,
@@ -162,11 +162,11 @@ import {
 import {
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-4djnmd86.js";
+} from "./shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"./shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import {
   AgentRegistry
-} from "./shared/@ai-setting/roy-agent-core-tycbpm17.js";
+} from "./shared/@ai-setting/roy-agent-core-fntxq0gf.js";
 import {
   XDG_PATHS,
   getXDGPath,
@@ -199,11 +199,11 @@ import"./shared/@ai-setting/roy-agent-core-fnv3ev18.js";
 import"./shared/@ai-setting/roy-agent-core-mdp8y7ky.js";
 import {
   SessionComponent
-} from "./shared/@ai-setting/roy-agent-core-bqe4c9f2.js";
+} from "./shared/@ai-setting/roy-agent-core-kr58bgz0.js";
 import"./shared/@ai-setting/roy-agent-core-rvxg1wps.js";
 import {
   MemorySessionStore
-} from "./shared/@ai-setting/roy-agent-core-zs4f0tcy.js";
+} from "./shared/@ai-setting/roy-agent-core-xjj88tpn.js";
 import"./shared/@ai-setting/roy-agent-core-7r72622v.js";
 import"./shared/@ai-setting/roy-agent-core-e0kaxcy1.js";
 import"./shared/@ai-setting/roy-agent-core-7hh0brvs.js";

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

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-btp589bw.js";
+} from "./roy-agent-core-grajzyhd.js";
 import {
   ContextError,
   ErrorCodes

package/dist/shared/@ai-setting/{roy-agent-core-5kc9qtej.js → roy-agent-core-bb20se79.js}

@@ -8,7 +8,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-mqeqevym.js";
+} from "./roy-agent-core-zvwdfm79.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

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

@@ -1,7 +1,7 @@
 import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook
-} from "./roy-agent-core-btp589bw.js";
+} from "./roy-agent-core-grajzyhd.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";

package/dist/shared/@ai-setting/{roy-agent-core-5ka95kh7.js → roy-agent-core-ett06sn8.js}

@@ -1,6 +1,6 @@
 import {
   builtInPrompts
-} from "./roy-agent-core-4djnmd86.js";
+} from "./roy-agent-core-skqt40yy.js";
 import {
   getXDGPath
 } from "./roy-agent-core-qxnbvgwe.js";

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

@@ -165,7 +165,7 @@ class AgentRegistry {
     const agent = {
       name,
       type: "sub",
-      description: "Workflow runner — 负责调用 workflow_run 启动 workflow，支持 session resume 和 stop；失败接管由 prompt 推理触发 (Task #2251 简化版)。",
+      description: "Workflow runner — 接受带 workflow_name（必填）的委托，或指示其按 search-first 流程自行选定（workflow_tag_list + workflow_search + workflow_list + workflow_get），然后通过 workflow_run 执行 workflow；支持 session resume 和 stop；失败接管由 prompt 推理触发 (Task #2251)。**调用方必须在 prompt 中明确指定 workflow 名，或指示 sub-agent 自行搜索选择；禁止盲猜/绕过/跳过 schema 验证** (Task #2486)。",
       systemPromptRef: "workflow-runner",
       deniedTools: ["delegate_task", "stop_task"],
       maxIterations: 30

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

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-1mrc9a1r.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-4djnmd86.js";
+} from "./roy-agent-core-skqt40yy.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";

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

@@ -14,7 +14,7 @@ import {
 } from "./roy-agent-core-c1v263jn.js";
 import {
   isValidSessionId
-} from "./roy-agent-core-bqe4c9f2.js";
+} from "./roy-agent-core-kr58bgz0.js";
 import {
   TracedAs,
   init_decorator

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

@@ -6,7 +6,7 @@ import {
 import {
   MemorySessionStore,
   SQLiteSessionStore
-} from "./roy-agent-core-zs4f0tcy.js";
+} from "./roy-agent-core-xjj88tpn.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";
@@ -664,6 +664,14 @@ class SessionComponent extends BaseComponent {
     }
     return success;
   }
+  async endSessionCleanup(sessionId, opts) {
+    const store = this.store;
+    if (typeof store?.endSessionCleanup === "function") {
+      await store.endSessionCleanup(sessionId, opts);
+    } else {
+      logger.debug(`[SessionComponent] endSessionCleanup skipped: store type ${this.config?.storage?.type ?? "unknown"} 不实现该方法`);
+    }
+  }
   async getContext(sessionId, options) {
     const session = await this.get(sessionId);
     if (!session) {

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

@@ -18,7 +18,7 @@ import {
   createWorkflowSearchTool,
   createWorkflowTagListTool,
   createWorkflowValidateTool
-} from "./roy-agent-core-kkt2ndpf.js";
+} from "./roy-agent-core-j8t1tyhr.js";
 import {
   WorkflowService
 } from "./roy-agent-core-r15sn7ve.js";

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

@@ -110,6 +110,10 @@ var builtInPrompts = {
 
 ## 子智能体选择策略
 
+**核心铁律**：选了某个 subagent 后，必须**遵循该 subagent 的工作模式**——把任务用它的 prompt 模板、工具集和决策路径表达，**不能用自己的方式硬塞**。
+
+> \uD83D\uDCA1 **典型例子**：选 \`workflow-runner\` 时，prompt 必须**明确指定 workflow 名**（让 sub-agent 直接 \`workflow_run\`）**或**让 sub-agent **先 \`workflow_search\` / \`workflow_list\` / \`workflow_get\` 自行选定**——不要让 sub-agent 替你做不属于它的决策（如 \`workflow_creat\`）。
+
 你有多类子智能体。**默认首次委托使用 \`roy\`**。**调用 workflow 解决的任务，委托给 \`workflow-runner\`**（兼容语法：\`strict-task-agent\` / \`code-review\` / \`bench-agent-host\` / \`workspace-analyzer\` / \`test-workflow-agent\` 等旧名仍可用，会被自动重写）。
 
 ### \uD83E\uDD47 首选：\`roy\`（首次委托默认）
@@ -147,15 +151,34 @@ delegate_task(
 - **安全关键型变更** — 验证不可妥协
 - **代码审查/审计** — 需要系统性对照目标进行检查
 
-使用：
+#### 两种合法委托模式（**workflow_name 必传 / search-first 二选一**）
+
+\`workflow-runner\` 的 \`<workflow_name>\` 是它的第一铁律（参见 \`workflow-runner\` prompt 的"## ⚠️ workflow_name 处理规则"）。委托时必须在 prompt 里：
+
+- **模式 A — 传具体 workflow_name**（首选）：你已经知道该跑哪个 workflow，直接在 prompt 中指定名字，sub-agent 直接 \`workflow_get(name)\` → \`workflow_run\`。
+- **模式 B — search-first 兜底**：你只知道任务目标但不确定 workflow 名，指示 sub-agent 自行 \`workflow_tag_list\` + \`workflow_search\` + \`workflow_list\` + \`workflow_get\` 选定再 \`workflow_run\`。
+
+**禁止**：让 sub-agent 猜 workflow_name、绕过 workflow 自己完成任务、或跳过 schema 验证。
+
+#### 模式 A 示例 — 传具体 workflow_name
+
 \`\`\`
 delegate_task(
-  description="简要 3-5 字摘要",
-  prompt="详细说明。
+  description="执行 strict-task-agent workflow",
+  prompt="调用 workflow_run 执行 workflow strict-task-agent，任务是修复 roy-rd-with-trace 中的 X bug。",
+  subagent_type="workflow-runner",
+  similar_task_ids=[]
+)
+\`\`\`
 
-重要：遵循任务作为一等公民原则 — 使用 \`task_create\` 创建任务，使用 \`task_update\` 跟踪进度，使用 \`task_operation_create\` 记录里程碑，并使用 \`task_complete\` 完成任务。",
-  subagent_type="workflow-runner", prompt="运行 workflow strict-task-agent，任务是..."
-  similar_task_ids=[]  // 必填：先使用 task_search 搜索相似任务，将找到的 ID 填入此处（最多 3 个）
+#### 模式 B 示例 — search-first 兜底
+
+\`\`\`
+delegate_task(
+  description="寻找并执行合适的 workflow",
+  prompt="用户目标：批量跑 stock 筛选分析。请按 workflow-runner 的 search-first 流程：先 \`workflow_tag_list\` + \`workflow_search --keyword stock\` + \`workflow_list\` 找到匹配的 workflow，再 \`workflow_get <name>\` 验证 schema，最后 \`workflow_run <name>\` 执行。不要猜测 workflow 名。",
+  subagent_type="workflow-runner",
+  similar_task_ids=[]
 )
 \`\`\`
 
@@ -379,13 +402,22 @@ const status = await query_background_process({ bgProcessId: result.bgProcessId
 
 Workflow 是预定义的自动化流程，可以高效解决常见类型的任务。**Default agent 自身不应直接 bash 跑 workflow**——所有 workflow 调用必须通过 \`delegate_task\` 委托给 \`workflow-runner\` 子智能体执行。
 
+### ⚠️ 委托时 workflow_name 必传 / search-first 二选一（Task #2486）
+
+\`workflow-runner\` 的 \`<workflow_name>\` 是它的**第一铁律**（详见 \`workflow-runner\` prompt "## ⚠️ workflow_name 处理规则"）。**Default agent 在委托时必须**：
+
+- **指定 workflow 名** — prompt 里明确写出 \`运行 workflow <workflow-name>\`，sub-agent 直接 \`workflow_get(name)\` → \`workflow_run\`。
+- **或指示 sub-agent 自行搜索** — prompt 里说"按 search-first 流程：先 \`workflow_tag_list\` + \`workflow_search\` + \`workflow_list\` + \`workflow_get\` 选定再执行"，让 sub-agent 自决。
+
+**绝对禁止**：让 sub-agent 猜 workflow 名 / 绕过 workflow / 跳过 schema 验证。
+
 ### 如何通过 \`delegate_task\` 调用 workflow（标准路径）
 
 1. **查 tag 发现可用 workflow**：\`workflow tag list\` — 查看 tag 池，找与任务领域匹配的 tag
 2. **按 tag 搜索 workflow**：\`workflow list --tag <tag>\` — 找到相关的 workflow
 3. **按关键词搜索**：\`workflow search --keyword <key>\` — 用关键词匹配
 4. **查看详情**：\`workflow get <name>\` — 了解 workflow 的输入参数和节点流程
-5. **委托 \`workflow-runner\` 执行**：用下列模板派发
+5. **委托 \`workflow-runner\` 执行**：用下列模板派发（workflow_name 由 default agent 自己查好后填入，或改成"按 search-first 流程自行选定"）
 
 \`\`\`text
 delegate_task(
@@ -394,6 +426,14 @@ delegate_task(
 )
 \`\`\`
 
+**search-first 替代模板**（当你不确定 workflow 名时）：
+\`\`\`text
+delegate_task(
+  subagent_type="workflow-runner",
+  prompt="按 search-first 流程执行：先 \`workflow_tag_list\` + \`workflow_search --keyword <key>\` + \`workflow_list\` 找到匹配 workflow，再 \`workflow_get <name>\` 验证 schema，最后 \`workflow_run <name>\` 执行。"
+)
+\`\`\`
+
 > \uD83D\uDCA1 **什么时候该用 workflow？**
 > - ✅ 你的任务与现有 workflow 的 tag 或描述高度匹配时 → 委托 \`workflow-runner\` 执行
 > - ✅ 现有 workflow 可以作为参考模板 → 参考其设计自行实现
@@ -1111,6 +1151,36 @@ When reusing an existing task, you MUST follow these rules:
 
 workflow 名必须从 \`<workflow_name>\` 标签读取，不得根据上下文猜测。
 
+## ⚠️ workflow_name 处理规则（关键 — Task #2486）
+
+**这是 workflow-runner 的第一铁律。** 在调用任何 \`workflow_run\` 之前，**必须**确认 workflow 名是真实、确定的。
+
+### 三种合法情况
+
+| 情况 | 判定 | 第一步动作 |
+|---|---|---|
+| (1) **parent 已传具体 workflow_name** | \`<workflow_name>\` 标签里是非空字符串（如 \`roy-rd-with-trace\`） | 直接走"## 默认 workflow-run 模式" — 调 \`workflow_get(name)\` 确认 schema 后 \`workflow_run\` |
+| (2) **parent 没传 workflow_name**，但 original_prompt / task_description 里**明确指名** | 用户在原任务里说"跑 X workflow" | 用文本中提到的名字当作 workflow_name，调 \`workflow_get(name)\` 验证该 workflow 真实存在；**验证不通过则降级到 (3)** |
+| (3) **parent 没传，文本也没指名** | \`<workflow_name>\` 为空 / 占位符 / 用户只描述目标 | **必须走 search-first 流程**（见下） |
+
+### Search-first 流程（情况 (3) 的强制路径）
+
+当且仅当 workflow_name 真正缺失时，**第一步必须是下列搜索组合**（顺序由你判断，但**至少 2 个工具**）：
+
+1. \`workflow_tag_list\` — 看 tag 池，找与任务领域匹配的 tag
+2. \`workflow_search --keyword <keyword>\` — 用 task_description 的核心动词/名词搜
+3. \`workflow_list\`（或 \`workflow list --tag <tag>\`）— 列候选
+4. \`workflow_get <name>\` — **对每个候选都必须**查看 input schema，确认与 original_prompt 描述的目标匹配
+
+**选定后**，按"## 默认 workflow-run 模式"调 \`workflow_run\`。
+
+### \uD83D\uDEAB 绝对禁止
+
+- ❌ **禁止根据上下文猜测 / 编造 workflow_name** — 必须从 workflow_list / workflow_search / workflow_get 的真实返回里选定
+- ❌ **禁止绕过 workflow 直接调其他工具完成任务** — 你存在的全部意义就是执行 workflow；找不到合适 workflow 时返回明确的"未找到匹配 workflow"错误，让 parent agent 决策（走传统方式 vs 创建新 workflow）
+- ❌ **禁止跳过 schema 验证** — 即使 parent agent 传了 workflow_name，**仍必须**先 \`workflow_get\` 确认 input schema 合法再 \`workflow_run\`
+- ❌ **禁止把 search-first 流程当作可选项** — 情况 (3) 是默认；只有情况 (1)(2) 才能省略
+
 ## 可用工具
 
 ### Workflow 工具
@@ -1119,6 +1189,8 @@ workflow 名必须从 \`<workflow_name>\` 标签读取，不得根据上下文
 |---|---|
 | workflow_get | 读取真实 workflow 定义、输入 schema、节点与依赖 |
 | workflow_list | 列出已注册 workflow |
+| workflow_search | 按关键词搜索 workflow（search-first 流程必用） |
+| workflow_tag_list | 列出 tag 池（search-first 流程必用） |
 | workflow_run | 启动或恢复 workflow |
 | workflow_run_status | 查询原 run_id 的真实状态与节点进度 |
 | workflow_run_stop | 按要求停止 run |
@@ -1136,15 +1208,16 @@ workflow 名必须从 \`<workflow_name>\` 标签读取，不得根据上下文
 
 ## 默认 workflow-run 模式
 
-1. 调 \`workflow_get(name)\`，确认 input schema、节点描述和 DAG 依赖。
-2. 从 original_prompt 提取合法 input。
-3. 没有 existing_sub_session_id 时调用 fresh \`workflow_run\`；有该 ID 时先调
+1. **再次确认 workflow_name 已通过 search-first 流程选定**（参见"## ⚠️ workflow_name 处理规则"）。
+2. 调 \`workflow_get(name)\`，确认 input schema、节点描述和 DAG 依赖。
+3. 从 original_prompt 提取合法 input。
+4. 没有 existing_sub_session_id 时调用 fresh \`workflow_run\`；有该 ID 时先调
    \`workflow_run_status(run_id)\`，再以同一 ID 作为 session 恢复。runId == sessionId。
 
    Copy-paste CLI 示例：
    \`roy-agent workflow run roy-rd-with-trace -s workflow_run_1783407282099_1_ah8pho\`
-4. 对 \`completed\` / \`paused\` 返回真实 output；对 \`running\` / \`stopped\` 按真实状态报告。
-5. 对每次 \`failed\` / \`timeout\`，扫描你自己最近的 workflow_run tool results，推理连续失败次数。
+5. 对 \`completed\` / \`paused\` 返回真实 output；对 \`running\` / \`stopped\` 按真实状态报告。
+6. 对每次 \`failed\` / \`timeout\`，扫描你自己最近的 workflow_run tool results，推理连续失败次数。
 
 ## 连续 2 次失败阈值（由 LLM 自行推理）
 

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

@@ -32,10 +32,24 @@ function generateMessageId() {
 }
 
 class MemorySessionStore extends BaseSessionStore {
+  maxMessagesPerSession;
+  maxCheckpointsPerSession;
+  defaultKeepAllMessagesUntilCompaction;
   sessions = new Map;
   messages = new Map;
   checkpoints = new Map;
   messageConverter = new SessionMessageConverter;
+  constructor(options = {}) {
+    super();
+    this.maxMessagesPerSession = options.maxMessagesPerSession ?? 1e4;
+    this.maxCheckpointsPerSession = options.maxCheckpointsPerSession ?? 1000;
+    this.defaultKeepAllMessagesUntilCompaction = options.keepAllMessagesUntilCompaction ?? true;
+  }
+  trimMessages(messages) {
+    if (messages.length > this.maxMessagesPerSession) {
+      messages.splice(0, messages.length - this.maxMessagesPerSession);
+    }
+  }
   async create(options) {
     const now = Date.now();
     const rawParent = options.parentSessionId !== undefined ? options.parentSessionId : options.parentID ?? null;
@@ -126,6 +140,7 @@ class MemorySessionStore extends BaseSessionStore {
     if (deleted) {
       this.messages.delete(id);
       this.checkpoints.delete(id);
+      this.messageTruncOffsets.delete(id);
     }
     return deleted;
   }
@@ -149,6 +164,7 @@ class MemorySessionStore extends BaseSessionStore {
     msg.timestamp = Date.now();
     const sessionMessages = this.messages.get(sessionId) ?? [];
     sessionMessages.push(msg);
+    this.trimMessages(sessionMessages);
     this.messages.set(sessionId, sessionMessages);
     session.messageCount = sessionMessages.filter((m) => !m.isArchived).length;
     session.metadata = {
@@ -183,6 +199,7 @@ class MemorySessionStore extends BaseSessionStore {
       sessionMessages.push(msg);
       ids.push(msg.id);
     }
+    this.trimMessages(sessionMessages);
     this.messages.set(sessionId, sessionMessages);
     session.messageCount = sessionMessages.filter((m) => !m.isArchived).length;
     session.metadata = {
@@ -262,6 +279,13 @@ class MemorySessionStore extends BaseSessionStore {
     }
     const cps = this.checkpoints.get(sessionId) ?? [];
     cps.push(checkpoint);
+    let droppedCheckpoints = [];
+    if (cps.length > this.maxCheckpointsPerSession) {
+      droppedCheckpoints = cps.splice(0, cps.length - this.maxCheckpointsPerSession);
+    }
+    if (!this.defaultKeepAllMessagesUntilCompaction && cps.length > 1) {
+      droppedCheckpoints = droppedCheckpoints.concat(cps.splice(0, cps.length - 1));
+    }
     this.checkpoints.set(sessionId, cps);
     const meta = session.metadata || {};
     const checkpointsMeta = meta.checkpoints || { checkpoints: [] };
@@ -272,13 +296,115 @@ class MemorySessionStore extends BaseSessionStore {
       createdAt: checkpoint.createdAt,
       type: checkpoint.type
     });
-    checkpointsMeta.latestCheckpointId = checkpoint.id;
+    if (droppedCheckpoints.length > 0) {
+      const droppedIds = new Set(droppedCheckpoints.map((c) => c.id));
+      checkpointsMeta.checkpoints = checkpointsMeta.checkpoints.filter((c) => !droppedIds.has(c.id));
+      if (meta.checkpointDetails) {
+        for (const id of droppedIds) {
+          delete meta.checkpointDetails[id];
+        }
+      }
+    }
+    checkpointsMeta.latestCheckpointId = cps[cps.length - 1]?.id ?? checkpoint.id;
     meta.checkpoints = checkpointsMeta;
     if (!meta.checkpointDetails) {
       meta.checkpointDetails = {};
     }
     meta.checkpointDetails[checkpoint.id] = checkpoint;
     session.metadata = meta;
+    if (!this.defaultKeepAllMessagesUntilCompaction && cps.length > 0) {
+      const latest = cps[cps.length - 1];
+      this.truncateMessagesBeforeIndex(sessionId, latest.messageIndex);
+      const sessionMessages = this.messages.get(sessionId) ?? [];
+      session.messageCount = sessionMessages.filter((m) => !m.isArchived).length;
+      session.metadata = {
+        ...session.metadata,
+        messageCount: session.messageCount
+      };
+    }
+    session.updatedAt = Date.now();
+  }
+  messageTruncOffsets = new Map;
+  truncateMessagesBeforeIndex(sessionId, originalBeforeIndex) {
+    const sessionMessages = this.messages.get(sessionId);
+    if (!sessionMessages || sessionMessages.length === 0)
+      return;
+    const offset = this.messageTruncOffsets.get(sessionId) ?? 0;
+    const adjustedIndex = originalBeforeIndex - offset;
+    if (adjustedIndex <= 0) {
+      return;
+    }
+    if (adjustedIndex >= sessionMessages.length) {
+      return;
+    }
+    sessionMessages.splice(0, adjustedIndex);
+    this.messageTruncOffsets.set(sessionId, offset + adjustedIndex);
+    this.messages.set(sessionId, sessionMessages);
+    const cps = this.checkpoints.get(sessionId);
+    if (cps) {
+      for (const cp of cps) {
+        cp.messageIndex = Math.max(0, cp.messageIndex - adjustedIndex);
+      }
+    }
+    const session = this.sessions.get(sessionId);
+    if (session) {
+      const meta = session.metadata;
+      if (meta) {
+        const checkpointsMeta = meta.checkpoints;
+        if (checkpointsMeta?.checkpoints) {
+          for (const cm of checkpointsMeta.checkpoints) {
+            cm.messageIndex = Math.max(0, cm.messageIndex - adjustedIndex);
+          }
+        }
+        if (meta.checkpointDetails) {
+          const details = meta.checkpointDetails;
+          for (const id in details) {
+            details[id].messageIndex = Math.max(0, details[id].messageIndex - adjustedIndex);
+          }
+        }
+      }
+    }
+  }
+  async endSessionCleanup(sessionId, opts = {}) {
+    const session = this.sessions.get(sessionId);
+    if (!session) {
+      return;
+    }
+    const keepAllMessages = opts.keepAllMessagesUntilCompaction ?? this.defaultKeepAllMessagesUntilCompaction;
+    const keepLatest = Math.max(0, opts.keepLatestCheckpoints ?? 1);
+    const cps = this.checkpoints.get(sessionId) ?? [];
+    let droppedCheckpoints = [];
+    const targetCheckpointCap = keepAllMessages ? this.maxCheckpointsPerSession : keepLatest;
+    if (cps.length > targetCheckpointCap) {
+      droppedCheckpoints = cps.splice(0, cps.length - targetCheckpointCap);
+    }
+    this.checkpoints.set(sessionId, cps);
+    if (droppedCheckpoints.length > 0) {
+      const meta = session.metadata;
+      const droppedIds = new Set(droppedCheckpoints.map((c) => c.id));
+      const checkpointsMeta = meta.checkpoints ?? {
+        checkpoints: []
+      };
+      checkpointsMeta.checkpoints = checkpointsMeta.checkpoints.filter((c) => !droppedIds.has(c.id));
+      checkpointsMeta.latestCheckpointId = cps[cps.length - 1]?.id;
+      meta.checkpoints = checkpointsMeta;
+      if (meta.checkpointDetails) {
+        for (const id of droppedIds) {
+          delete meta.checkpointDetails[id];
+        }
+      }
+      session.metadata = meta;
+    }
+    if (!keepAllMessages && cps.length > 0) {
+      const latest = cps[cps.length - 1];
+      this.truncateMessagesBeforeIndex(sessionId, latest.messageIndex);
+      const sessionMessages = this.messages.get(sessionId) ?? [];
+      session.messageCount = sessionMessages.filter((m) => !m.isArchived).length;
+      session.metadata = {
+        ...session.metadata,
+        messageCount: session.messageCount
+      };
+    }
     session.updatedAt = Date.now();
   }
   async getCheckpoints(sessionId) {
@@ -420,6 +546,7 @@ class MemorySessionStore extends BaseSessionStore {
     this.sessions.clear();
     this.messages.clear();
     this.checkpoints.clear();
+    this.messageTruncOffsets.clear();
   }
 }
 // src/env/session/storage/sqlite.ts

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

@@ -10,7 +10,7 @@ import {
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-tycbpm17.js";
+} from "./roy-agent-core-fntxq0gf.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";

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

@@ -4,13 +4,13 @@ import {
 } from "./roy-agent-core-44g3synv.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-4djnmd86.js";
+} from "./roy-agent-core-skqt40yy.js";
 import {
   runWithBgTaskIdAsync
 } from "./roy-agent-core-c1v263jn.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-tycbpm17.js";
+} from "./roy-agent-core-fntxq0gf.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
@@ -896,7 +896,10 @@ var PROGRESS_INTERVAL = 1200000;
 
 class BackgroundTaskManager {
   env;
+  maxProcessRegistries = 1000;
+  maxTerminalTasks = 1000;
   tasks = new Map;
+  terminalTasks = new Map;
   abortControllers = new Map;
   progressTimers = new Map;
   processRegistries = new Map;
@@ -964,6 +967,52 @@ class BackgroundTaskManager {
     set.clear();
     return { runIds, stopResults };
   }
+  finalizeTask(taskId, reason) {
+    if (!taskId)
+      return;
+    this.stopProgressReporter(taskId);
+    this.progressTimers.delete(taskId);
+    const task = this.tasks.get(taskId);
+    if (task) {
+      this.tasks.delete(taskId);
+      if (this.terminalTasks.size >= this.maxTerminalTasks) {
+        const oldestKey = this.terminalTasks.keys().next().value;
+        if (oldestKey !== undefined) {
+          this.terminalTasks.delete(oldestKey);
+        }
+      }
+      this.terminalTasks.set(taskId, task);
+    }
+    const abortCtl = this.abortControllers.get(taskId);
+    if (abortCtl) {
+      try {
+        abortCtl.abort();
+      } catch {}
+    }
+    this.abortControllers.delete(taskId);
+    this.workflowRunRegistries.delete(taskId);
+    const registry = this.processRegistries.get(taskId);
+    if (registry && registry.size() > 0) {
+      logger3.debug(`[BackgroundTaskManager] finalizeTask保留 processRegistry ${taskId} (residualPIDs=${registry.size()}, reason=${reason})`);
+    }
+    logger3.debug(`[BackgroundTaskManager] finalizeTask taskId=${taskId} reason=${reason}`);
+  }
+  getProcessRegistrySize() {
+    return this.processRegistries.size;
+  }
+  getMaxProcessRegistries() {
+    return this.maxProcessRegistries;
+  }
+  cleanupEmptyProcessRegistries() {
+    let cleaned = 0;
+    for (const [taskId, registry] of this.processRegistries) {
+      if (registry.size() === 0) {
+        this.processRegistries.delete(taskId);
+        cleaned++;
+      }
+    }
+    return cleaned;
+  }
   static DEFAULT_WORKFLOW_ENTRY_AGENT = "workflow-runner";
   resolveEntryAgent(subagentType) {
     try {
@@ -1074,6 +1123,12 @@ class BackgroundTaskManager {
       }
     }
     const abortController = new AbortController;
+    if (this.processRegistries.size >= this.maxProcessRegistries) {
+      this.cleanupEmptyProcessRegistries();
+      if (this.processRegistries.size >= this.maxProcessRegistries) {
+        throw new Error(`BackgroundTaskManager.processRegistries 达到上限 ${this.maxProcessRegistries}（含残留 PID），拒绝创建新 task（taskId=${taskIdGen}）。请清理 / 重启 / 调高 maxProcessRegistries。`);
+      }
+    }
     const processRegistry = new ProcessRegistry;
     this.processRegistries.set(taskIdGen, processRegistry);
     const createdAt = Date.now();
@@ -1214,7 +1269,15 @@ class BackgroundTaskManager {
         error: errorMessage
       });
     } finally {
-      this.stopProgressReporter(taskId);
+      this.finalizeTask(taskId, task.status);
+      const sessionComp = this.getSessionComponent();
+      if (sessionComp?.endSessionCleanup && task?.subSessionId) {
+        try {
+          await sessionComp.endSessionCleanup(task.subSessionId);
+        } catch (err) {
+          logger3.warn(`[BackgroundTaskManager] endSessionCleanup failed for ${task.subSessionId}`, { error: err instanceof Error ? err.message : String(err) });
+        }
+      }
     }
   }
   startProgressReporter(taskId, parentSessionId) {
@@ -1426,10 +1489,17 @@ ${reuseSection.markdown}`;
     });
   }
   async stopTask(taskId) {
-    const task = this.tasks.get(taskId);
+    const task = this.tasks.get(taskId) ?? this.terminalTasks.get(taskId);
     if (!task) {
       return { success: false, message: "Task not found" };
     }
+    if (this.terminalTasks.has(taskId)) {
+      return {
+        success: false,
+        task,
+        message: `Cannot stop task with status: ${task.status}`
+      };
+    }
     if (task.status === "completed" || task.status === "failed" || task.status === "stopped" || task.status === "timeout") {
       return {
         success: false,
@@ -1462,6 +1532,7 @@ ${reuseSection.markdown}`;
       associatedTaskId: task.associatedTaskId
     };
     this.publishBackgroundEvent(BackgroundTaskEventTypes.STOPPED, stoppedPayload, task.parentSessionId);
+    this.finalizeTask(taskId, "stopped");
     return {
       success: true,
       task,
@@ -1471,10 +1542,10 @@ ${reuseSection.markdown}`;
     };
   }
   getTask(taskId) {
-    return this.tasks.get(taskId);
+    return this.tasks.get(taskId) ?? this.terminalTasks.get(taskId);
   }
   listTasks() {
-    return Array.from(this.tasks.values());
+    return Array.from(this.tasks.values()).concat(Array.from(this.terminalTasks.values()));
   }
   hasActiveTaskForParent(parentSessionId) {
     if (!parentSessionId)
@@ -1506,7 +1577,18 @@ ${reuseSection.markdown}`;
     return { stoppedTaskIds };
   }
   async forceStopAllAcrossParents() {
-    for (const [taskId, task] of this.tasks) {
+    const seen = new Set;
+    const allTaskIds = new Set([
+      ...this.tasks.keys(),
+      ...this.terminalTasks.keys(),
+      ...this.processRegistries.keys()
+    ]);
+    for (const taskId of allTaskIds) {
+      if (seen.has(taskId))
+        continue;
+      seen.add(taskId);
+      const task = this.tasks.get(taskId) ?? this.terminalTasks.get(taskId);
+      const taskSafe = task;
       try {
         await this.processRegistries.get(taskId)?.killAll();
       } catch (err) {
@@ -1518,29 +1600,29 @@ ${reuseSection.markdown}`;
         logger3.warn(`[BackgroundTaskManager] forceStopAllAcrossParents propagateStopToWorkflowRuns failed for ${taskId}: ${err instanceof Error ? err.message : String(err)}`);
       }
       let justMarkedStopped = false;
-      if (task.status === "running" || task.status === "pending") {
+      if (taskSafe && (taskSafe.status === "running" || taskSafe.status === "pending")) {
         try {
-          task.status = "stopped";
-          task.completedAt = Date.now();
-          task.lastUpdatedAt = task.completedAt;
-          task.abortController?.abort();
+          taskSafe.status = "stopped";
+          taskSafe.completedAt = Date.now();
+          taskSafe.lastUpdatedAt = taskSafe.completedAt;
+          taskSafe.abortController?.abort();
           justMarkedStopped = true;
         } catch (err) {
           logger3.warn(`[BackgroundTaskManager] forceStopAllAcrossParents mark stopped failed for ${taskId}: ${err instanceof Error ? err.message : String(err)}`);
         }
       }
-      if (justMarkedStopped) {
+      if (justMarkedStopped && taskSafe) {
         const stoppedPayload = {
-          backgroundTaskId: task.id,
-          subSessionId: task.subSessionId,
-          parentSessionId: task.parentSessionId,
+          backgroundTaskId: taskSafe.id,
+          subSessionId: taskSafe.subSessionId,
+          parentSessionId: taskSafe.parentSessionId,
           status: "stopped",
-          description: task.description,
+          description: taskSafe.description,
           error: "force stop all",
-          executionTimeMs: task.startedAt && task.completedAt ? task.completedAt - task.startedAt : 0,
-          associatedTaskId: task.associatedTaskId
+          executionTimeMs: taskSafe.startedAt && taskSafe.completedAt ? taskSafe.completedAt - taskSafe.startedAt : 0,
+          associatedTaskId: taskSafe.associatedTaskId
         };
-        this.publishBackgroundEvent(BackgroundTaskEventTypes.STOPPED, stoppedPayload, task.parentSessionId);
+        this.publishBackgroundEvent(BackgroundTaskEventTypes.STOPPED, stoppedPayload, taskSafe.parentSessionId);
       }
     }
   }
@@ -1548,9 +1630,16 @@ ${reuseSection.markdown}`;
     return this.forceStopAllAcrossParents();
   }
   async dispose() {
-    for (const [taskId, controller] of this.abortControllers) {
-      controller.abort();
-      logger3.debug(`[BackgroundTaskManager] Aborted task: ${taskId}`);
+    for (const [, timer] of this.progressTimers) {
+      try {
+        clearInterval(timer);
+      } catch {}
+    }
+    this.progressTimers.clear();
+    for (const [, controller] of this.abortControllers) {
+      try {
+        controller.abort();
+      } catch {}
     }
     this.abortControllers.clear();
     for (const [, registry] of this.processRegistries) {
@@ -1599,6 +1688,9 @@ __legacyDecorateClassTS([
     log: true
   })
 ], BackgroundTaskManager.prototype, "propagateStopToWorkflowRuns", null);
+__legacyDecorateClassTS([
+  TracedAs("task.background.finalizeTask", { recordParams: true, recordResult: false, log: true })
+], BackgroundTaskManager.prototype, "finalizeTask", null);
 __legacyDecorateClassTS([
   TracedAs("task.background.resolveEntryAgent", { recordParams: true, recordResult: true })
 ], BackgroundTaskManager.prototype, "resolveEntryAgent", null);

package/package.json

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