@ai-setting/roy-agent-core 1.5.87 → 1.5.88

package/dist/env/index.js

@@ -44,7 +44,7 @@ import"../shared/@ai-setting/roy-agent-core-r0m0at3x.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-r1adqgaa.js";
+} from "../shared/@ai-setting/roy-agent-core-4cdtdxqx.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
 import"../shared/@ai-setting/roy-agent-core-bgw4dq11.js";
 import"../shared/@ai-setting/roy-agent-core-pcdzfwdv.js";
@@ -54,7 +54,7 @@ import {
   getXDGPath,
   getXDGPaths
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../shared/@ai-setting/roy-agent-core-9vwyj29a.js";
+import"../shared/@ai-setting/roy-agent-core-h5867smx.js";
 import"../shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import"../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import {

package/dist/env/task/index.js

@@ -5,7 +5,7 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-r1adqgaa.js";
+} from "../../shared/@ai-setting/roy-agent-core-4cdtdxqx.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
@@ -16,7 +16,7 @@ import {
 } from "../../shared/@ai-setting/roy-agent-core-pcdzfwdv.js";
 import"../../shared/@ai-setting/roy-agent-core-7z4xtrmw.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-9vwyj29a.js";
+import"../../shared/@ai-setting/roy-agent-core-h5867smx.js";
 import"../../shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import"../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";

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

@@ -8,7 +8,7 @@ import {
   listTasksTool,
   searchTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-9vwyj29a.js";
+} from "../../../shared/@ai-setting/roy-agent-core-h5867smx.js";
 import"../../../shared/@ai-setting/roy-agent-core-y5d04fm3.js";
 import"../../../shared/@ai-setting/roy-agent-core-k05v31rc.js";
 import"../../../shared/@ai-setting/roy-agent-core-shme7set.js";

package/dist/index.js

@@ -132,7 +132,7 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-r1adqgaa.js";
+} from "./shared/@ai-setting/roy-agent-core-4cdtdxqx.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
 import"./shared/@ai-setting/roy-agent-core-bgw4dq11.js";
 import {
@@ -147,7 +147,7 @@ import {
   getXDGPath,
   getXDGPaths
 } from "./shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"./shared/@ai-setting/roy-agent-core-9vwyj29a.js";
+import"./shared/@ai-setting/roy-agent-core-h5867smx.js";
 import"./shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import {
   TaskHookPoints

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

@@ -20,7 +20,7 @@ import {
   listTasksTool,
   searchTasksTool,
   updateTaskTool
-} from "./roy-agent-core-9vwyj29a.js";
+} from "./roy-agent-core-h5867smx.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -358,12 +358,11 @@ class TaskComponent extends BaseComponent {
   }
   async createTask(options) {
     const sessionId = options.sessionId;
-    if (options.parent_task_id === undefined || options.parent_task_id === null) {
-      throw new Error("parent_task_id is required. All tasks must be attached to a parent task. " + "Use task_list(depth=0) to find root tasks, or create a parent task first.");
-    }
-    const parentTask = await this.store.getTask(options.parent_task_id);
-    if (!parentTask) {
-      throw new Error(`Parent task #${options.parent_task_id} not found. ` + "Please provide a valid parent_task_id. Use task_list(depth=0) to see all root tasks.");
+    if (options.parent_task_id !== undefined && options.parent_task_id !== null) {
+      const parentTask = await this.store.getTask(options.parent_task_id);
+      if (!parentTask) {
+        throw new Error(`Parent task #${options.parent_task_id} not found. ` + "Please provide a valid parent_task_id. Use task_list(depth=0) to see all root tasks.");
+      }
     }
     const createCtx = {
       options: { ...options },

package/dist/shared/@ai-setting/{roy-agent-core-9vwyj29a.js → roy-agent-core-h5867smx.js}

@@ -18,15 +18,13 @@ var CreateTaskToolSchema = z.object({
   due_date: z.string().optional().describe("Due date (ISO format)"),
   tags: z.array(z.string()).optional().describe("Task tags (for search, stored in task.tags JSON field)"),
   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.number().describe(`父任务 ID（必填）。所有新任务都必须挂载到某个父任务下，以维护良好的任务树结构。
-` + `为什么 parent_task_id 是必填的：
-` + `  1. 任务聚类：将相关任务聚合到同一父任务下，便于管理和追踪
-` + `  2. 维护任务树：保持根任务数量可控（≤10个），深度适中（≤5层）
+  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）。"),
   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({
@@ -124,32 +122,28 @@ function createTaskTool(taskComponent) {
         
         **DO NOT leave this as plain text** - it must be valid JSON!
       
-      ## ⚠️ parent_task_id is REQUIRED
+      ## parent_task_id is OPTIONAL
       
-      All new tasks MUST have a parent_task_id. This is critical for:
+      Creating a root task (top-level task) is allowed and common. To create a root task,
+      simply **omit** \`parent_task_id\` (or pass \`null\`).
       
-      1. **Task Tree Structure**: Every task must be attached to a parent,
-         maintaining a clean hierarchy (根任务 ≤10, 深度 ≤5).
-      
-      2. **Task Clustering**: Related tasks are grouped under the same parent,
-         making it easy to track progress and find related work.
-      
-      **How to choose a parent task:**
+      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 parent task first,
-         then create the child task with that parent_task_id.
+      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.
       
-      **Example:**
-      - First: task_list(depth=0) → find an appropriate root task for your project
-        (e.g. one whose title matches your project name). Use the returned root task's
-        id as \`parent_task_id\` — do NOT hardcode a specific id; the root task id varies
-        across deployments and resets.
-      - Then: task_create(title="New feature", parent_task_id=<root_task_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) => {

package/package.json

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