@ai-setting/roy-agent-core 1.5.66 → 1.5.68

package/dist/env/agent/index.js

@@ -1,7 +1,7 @@
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-marga2es.js";
+} from "../../shared/@ai-setting/roy-agent-core-08q02yz2.js";
 import"../../shared/@ai-setting/roy-agent-core-ecth1zak.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";

package/dist/env/index.js

@@ -1,6 +1,6 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-v61w8cmf.js";
+} from "../shared/@ai-setting/roy-agent-core-zm86k3rg.js";
 import {
   EventSourceComponent,
   builtInHandlers,
@@ -39,22 +39,22 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-marga2es.js";
+} from "../shared/@ai-setting/roy-agent-core-08q02yz2.js";
 import"../shared/@ai-setting/roy-agent-core-ecth1zak.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-z2fxjh6k.js";
+} from "../shared/@ai-setting/roy-agent-core-84vtpbw6.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
 import"../shared/@ai-setting/roy-agent-core-eq52jra7.js";
-import"../shared/@ai-setting/roy-agent-core-cgq7btak.js";
+import"../shared/@ai-setting/roy-agent-core-r9y8ct0w.js";
 import"../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
 import {
   XDG_PATHS,
   getXDGPath,
   getXDGPaths
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../shared/@ai-setting/roy-agent-core-3s9va046.js";
+import"../shared/@ai-setting/roy-agent-core-7t0jen73.js";
 import"../shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import"../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import {

package/dist/env/session/index.js

@@ -1,6 +1,6 @@
 import {
   SessionComponent
-} from "../../shared/@ai-setting/roy-agent-core-hkeegfq0.js";
+} from "../../shared/@ai-setting/roy-agent-core-jkzgmd1v.js";
 import"../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
 import {
   MemorySessionStore

package/dist/env/task/index.js

@@ -5,7 +5,7 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-z2fxjh6k.js";
+} from "../../shared/@ai-setting/roy-agent-core-84vtpbw6.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
@@ -13,10 +13,10 @@ import"../../shared/@ai-setting/roy-agent-core-eq52jra7.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "../../shared/@ai-setting/roy-agent-core-cgq7btak.js";
+} from "../../shared/@ai-setting/roy-agent-core-r9y8ct0w.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-3s9va046.js";
+import"../../shared/@ai-setting/roy-agent-core-7t0jen73.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/storage/index.js

@@ -2,7 +2,7 @@ import {
   SQLiteTaskStore,
   getDefaultDataDir,
   getDefaultTaskDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-cgq7btak.js";
+} from "../../../shared/@ai-setting/roy-agent-core-r9y8ct0w.js";
 import"../../../shared/@ai-setting/roy-agent-core-shme7set.js";
 import"../../../shared/@ai-setting/roy-agent-core-7z9b1fm8.js";
 import"../../../shared/@ai-setting/roy-agent-core-c6592r3c.js";

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

@@ -8,7 +8,7 @@ import {
   listTasksTool,
   searchTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-3s9va046.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7t0jen73.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

@@ -57,7 +57,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-v61w8cmf.js";
+} from "./shared/@ai-setting/roy-agent-core-zm86k3rg.js";
 import {
   EventSourceComponent,
   builtInHandlers,
@@ -116,7 +116,7 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-marga2es.js";
+} from "./shared/@ai-setting/roy-agent-core-08q02yz2.js";
 import {
   createInvokeConfig,
   invoke,
@@ -129,13 +129,13 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-z2fxjh6k.js";
+} from "./shared/@ai-setting/roy-agent-core-84vtpbw6.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
 import"./shared/@ai-setting/roy-agent-core-eq52jra7.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "./shared/@ai-setting/roy-agent-core-cgq7btak.js";
+} from "./shared/@ai-setting/roy-agent-core-r9y8ct0w.js";
 import {
   AgentRegistry
 } from "./shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
@@ -144,7 +144,7 @@ import {
   getXDGPath,
   getXDGPaths
 } from "./shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"./shared/@ai-setting/roy-agent-core-3s9va046.js";
+import"./shared/@ai-setting/roy-agent-core-7t0jen73.js";
 import"./shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import {
   TaskHookPoints
@@ -171,7 +171,7 @@ import"./shared/@ai-setting/roy-agent-core-fnv3ev18.js";
 import"./shared/@ai-setting/roy-agent-core-djtkntar.js";
 import {
   SessionComponent
-} from "./shared/@ai-setting/roy-agent-core-hkeegfq0.js";
+} from "./shared/@ai-setting/roy-agent-core-jkzgmd1v.js";
 import"./shared/@ai-setting/roy-agent-core-rvxg1wps.js";
 import {
   MemorySessionStore

package/dist/shared/@ai-setting/{roy-agent-core-marga2es.js → roy-agent-core-08q02yz2.js}

@@ -794,7 +794,7 @@ class AgentComponent extends BaseComponent {
         } catch (error) {
           logger.error(`Iteration ${iteration} error`, { error });
           hookCtx.error = error instanceof Error ? error : new Error(String(error));
-          if (error instanceof Error && error instanceof ContextError && error.llmOutput) {
+          if (error instanceof ContextError && error.llmOutput) {
             const llmOutput = error.llmOutput;
             if (llmOutput.toolCalls?.length) {
               const assistantParts = [];
@@ -877,6 +877,9 @@ class AgentComponent extends BaseComponent {
               result.error = `__ASK_USER_ERROR__:${JSON.stringify(errorInfo)}`;
             } else {
               result.error = hookCtx.error.message;
+              if (error instanceof Error) {
+                result.originalError = error;
+              }
               if (error?.name === "AbortError") {
                 hookCtx._stopReason = hookCtx._stopReason || "aborted";
               } else {

package/dist/shared/@ai-setting/{roy-agent-core-3s9va046.js → roy-agent-core-7t0jen73.js}

@@ -18,7 +18,15 @@ 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().optional().describe("父任务 ID（可选，用于构建任务树）"),
+  parent_task_id: z.number().describe(`父任务 ID（必填）。所有新任务都必须挂载到某个父任务下，以维护良好的任务树结构。
+` + `为什么 parent_task_id 是必填的：
+` + `  1. 任务聚类：将相关任务聚合到同一父任务下，便于管理和追踪
+` + `  2. 维护任务树：保持根任务数量可控（≤10个），深度适中（≤5层）
+` + `如何选择合适的父任务：
+` + `  1. 使用 task_list(depth=0) 查看当前所有根任务
+` + `  2. 使用 task_search 搜索与当前任务相关的父任务
+` + `  3. 按主题归类：将相似主题的任务挂载到同一个父任务下
+` + "如果确实找不到合适的父任务，可以先创建一个合适的父任务，再创建子任务。"),
   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({
@@ -114,6 +122,29 @@ function createTaskTool(taskComponent) {
         {"type": "unknown"}
         
         **DO NOT leave this as plain text** - it must be valid JSON!
+      
+      ## ⚠️ parent_task_id is REQUIRED
+      
+      All new tasks MUST have a parent_task_id. This is critical for:
+      
+      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:**
+      
+      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.
+      
+      **Example:**
+      - First: task_list(depth=0) → find root task #619 "roy-agent"
+      - Then: task_create(title="New feature", parent_task_id=619, ...)
     `,
     parameters: CreateTaskToolSchema,
     execute: async (args, ctx) => {

package/dist/shared/@ai-setting/{roy-agent-core-z2fxjh6k.js → roy-agent-core-84vtpbw6.js}

@@ -9,7 +9,7 @@ import {
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "./roy-agent-core-cgq7btak.js";
+} from "./roy-agent-core-r9y8ct0w.js";
 import {
   batchArchiveTaskTool,
   batchDeleteTaskTool,
@@ -20,7 +20,7 @@ import {
   listTasksTool,
   searchTasksTool,
   updateTaskTool
-} from "./roy-agent-core-3s9va046.js";
+} from "./roy-agent-core-7t0jen73.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -358,6 +358,13 @@ 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.");
+    }
     const createCtx = {
       options: { ...options },
       sessionId,

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

@@ -450,12 +450,19 @@ class SessionComponent extends BaseComponent {
     const recentMessages = this.extractRecentMessages(messages, 2);
     this.ensureSummaryAgent();
     await this.executeBeforeHooks("compact", { session, options });
-    const summaryResult = await this.summaryAgent.run({
-      messages: messages.map((m) => ({ role: m.role, content: m.content })),
-      userContext: options?.summary,
-      outputFormat: "json",
-      scenarioHint: options?.scenarioHint
-    });
+    let summaryResult;
+    try {
+      summaryResult = await this.summaryAgent.run({
+        messages: messages.map((m) => ({ role: m.role, content: m.content })),
+        userContext: options?.summary,
+        outputFormat: "json",
+        scenarioHint: options?.scenarioHint
+      });
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logger.error(`[SessionComponent] SummaryAgent.run failed: ${errorMessage}`);
+      throw new Error(`Session compaction failed: SummaryAgent error - ${errorMessage}`);
+    }
     const checkpointId = `cp_${Date.now().toString(36)}_${Math.random().toString(36).substring(2, 8)}`;
     const checkpoint = {
       id: checkpointId,
@@ -476,9 +483,9 @@ class SessionComponent extends BaseComponent {
       recentMessages
     };
     await this.store.saveCheckpoint(sessionId, checkpoint);
-    await this.store.archiveMessages(sessionId, checkpointId, messages.length);
     const checkpointMessage = this.createCheckpointMessage(checkpoint);
     await this.store.addMessage(sessionId, checkpointMessage);
+    await this.store.archiveMessages(sessionId, checkpointId, messages.length);
     const updatedSession = await this.get(sessionId);
     const remainingMessageCount = updatedSession?.messageCount ?? 0;
     const checkpointCount = updatedSession?.metadata?.checkpoints?.checkpoints?.length ?? 0;

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

@@ -940,6 +940,8 @@ class SQLiteTaskStore {
       this.db = null;
       this.initialized = false;
     }
+    this.tasksCache.clear();
+    this.operationsCache.clear();
   }
 }
 var logger;

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

@@ -225,6 +225,9 @@ class BaseEnvironment extends BaseComponent {
     }
     const result = await agentComponent.run(agent.name, query, context);
     if (result.error) {
+      if (result.originalError instanceof ContextError) {
+        throw result.originalError;
+      }
       const errorMsg = result.error.toLowerCase();
       if (errorMsg.includes("context") || errorMsg.includes("threshold") || errorMsg.includes("token") || result.error.includes("CTX_001")) {
         const usageMatch = result.error.match(/(\d+)\/(\d+)\s*\(([\d.]+)%\)/);

package/package.json

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