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

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

@@ -10,7 +10,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-45tvcwwz.js";
+} from "../../shared/@ai-setting/roy-agent-core-bferdaw6.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -21,7 +21,7 @@ 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-6ve6tsm5.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";

package/dist/env/index.js

@@ -1,11 +1,11 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-anhvbnrc.js";
+} from "../shared/@ai-setting/roy-agent-core-hd5xrr2q.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-45tvcwwz.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-6ve6tsm5.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-8mqahsj5.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-78m47x1d.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";
@@ -48,7 +48,7 @@ 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-pr7f94gn.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-7afcdb2m.js";
@@ -61,7 +61,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"../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import {

package/dist/env/task/index.js

@@ -5,7 +5,7 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-pr7f94gn.js";
+} from "../../shared/@ai-setting/roy-agent-core-tyqzn10b.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import {
   TaskEntityEventTypes
@@ -19,7 +19,7 @@ import {
 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,7 +8,7 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-6ve6tsm5.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";

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-78m47x1d.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-8mqahsj5.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-78m47x1d.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

@@ -62,7 +62,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-anhvbnrc.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-45tvcwwz.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-6ve6tsm5.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-8mqahsj5.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-78m47x1d.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";
@@ -148,7 +148,7 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-pr7f94gn.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-7afcdb2m.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-8mqahsj5.js → roy-agent-core-2xpstxhz.js}

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

package/dist/shared/@ai-setting/{roy-agent-core-6ve6tsm5.js → roy-agent-core-aa0tdfb2.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-45tvcwwz.js → roy-agent-core-bferdaw6.js}

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

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

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

package/dist/shared/@ai-setting/{roy-agent-core-78m47x1d.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,

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-pr7f94gn.js → roy-agent-core-tyqzn10b.js}

@@ -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/package.json

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