@ai-setting/roy-agent-core 1.5.62 → 1.5.64

package/dist/env/index.js

@@ -43,9 +43,9 @@ import"../shared/@ai-setting/roy-agent-core-ecaptews.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-wqzkxab9.js";
+} from "../shared/@ai-setting/roy-agent-core-z2fxjh6k.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-dkevkmas.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-nx3c3ce2.js";
 import {

package/dist/env/prompt/index.js

@@ -3,7 +3,7 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-8am1xdvb.js";
+} from "../../shared/@ai-setting/roy-agent-core-hfc3hzcj.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
 import"../../shared/@ai-setting/roy-agent-core-rgckng3p.js";

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

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

package/dist/env/task/index.js

@@ -5,11 +5,11 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-wqzkxab9.js";
+} from "../../shared/@ai-setting/roy-agent-core-z2fxjh6k.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-dkevkmas.js";
+import"../../shared/@ai-setting/roy-agent-core-eq52jra7.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   PromptStore,
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-8am1xdvb.js";
+} from "./shared/@ai-setting/roy-agent-core-hfc3hzcj.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -128,9 +128,9 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-wqzkxab9.js";
+} from "./shared/@ai-setting/roy-agent-core-z2fxjh6k.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-dkevkmas.js";
+import"./shared/@ai-setting/roy-agent-core-eq52jra7.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

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

@@ -208,7 +208,8 @@ var DelegateToolParameters = z.object({
   prompt: z.string().describe("The task for the agent to perform"),
   subagent_type: z.string().describe("The type of specialized agent to use for this task").default("general"),
   timeout: z.number().describe("Task timeout in milliseconds. Default: 1800000 (30 minutes). If set, task will be terminated after timeout.").optional(),
-  reason: z.string().describe("Brief reason for calling this tool (max 30 chars, e.g., 'Delegate refactor task')").optional()
+  reason: z.string().describe("Brief reason for calling this tool (max 30 chars, e.g., 'Delegate refactor task')").optional(),
+  similar_task_ids: z.array(z.number()).max(3).describe("Similar task IDs (max 3) to reference for improving task execution. Search for similar tasks before calling this tool.")
 });
 var DEFAULT_TIMEOUT = 1800000;
 var PROGRESS_INTERVAL = 120000;
@@ -238,7 +239,7 @@ class BackgroundTaskManager {
     }
   }
   async createTask(options) {
-    const { parentSessionId, description, prompt, subagentType, timeout } = options;
+    const { parentSessionId, description, prompt, subagentType, timeout, similarTaskIds } = options;
     const taskIdGen = `process_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
     const sessionComponent = this.getSessionComponent();
     if (!sessionComponent) {
@@ -269,7 +270,8 @@ class BackgroundTaskManager {
       subagentType,
       status: "pending",
       createdAt: Date.now(),
-      abortController
+      abortController,
+      similarTaskIds
     };
     this.tasks.set(taskIdGen, task);
     this.abortControllers.set(taskIdGen, abortController);
@@ -306,7 +308,7 @@ class BackgroundTaskManager {
       if (!subSession) {
         throw new Error(`Sub session not found: ${task.subSessionId}`);
       }
-      const result = await this.executeWithAbort(subSession, prompt, timeoutMs, abortController?.signal);
+      const result = await this.executeWithAbort(subSession, prompt, timeoutMs, abortController?.signal, task.similarTaskIds);
       if (abortController?.signal.aborted) {
         logger.info(`[BackgroundTaskManager] Task was aborted`, { taskId });
         return;
@@ -427,7 +429,7 @@ class BackgroundTaskManager {
       this.progressTimers.delete(taskId);
     }
   }
-  async executeWithAbort(subSession, prompt, timeoutMs, signal) {
+  async executeWithAbort(subSession, prompt, timeoutMs, signal, similarTaskIds) {
     const metadata = subSession.info?.metadata || {};
     const taskId = metadata.task_id;
     const taskDescription = metadata.task_description || "";
@@ -461,6 +463,67 @@ ${prompt}
 - 返回清晰的任务执行结果摘要
 - 适时调用 task_operation_create 记录进展
 - 如果你通过 task_create 创建了任务，请在最终响应中明确报告 task_id（例如：Task #627）`;
+    if (similarTaskIds && similarTaskIds.length > 0) {
+      try {
+        const taskComponent = this.env?.getComponent?.("task");
+        if (taskComponent) {
+          const similarTasksSections = [];
+          for (const similarId of similarTaskIds) {
+            try {
+              const similarTask = await taskComponent.getTask(similarId);
+              if (!similarTask) {
+                logger.warn(`[delegate] Similar task #${similarId} not found, skipping`);
+                continue;
+              }
+              const operations = await taskComponent.listOperations({ taskId: similarId, limit: 10 });
+              let section = `### Task #${similarTask.id}: ${similarTask.title}
+`;
+              section += `- Status: ${similarTask.status}
+`;
+              if (similarTask.description) {
+                section += `- Description: ${similarTask.description}
+`;
+              }
+              if (similarTask.goals_and_expected_deliverables) {
+                section += `- Goals: ${similarTask.goals_and_expected_deliverables}
+`;
+              }
+              if (operations && operations.length > 0) {
+                section += `- Recent Operations:
+`;
+                for (const op of operations) {
+                  section += `  - [${op.actionType}] ${op.actionTitle}: ${op.actionDescription || ""}
+`;
+                }
+              }
+              similarTasksSections.push(section);
+            } catch (err) {
+              logger.warn(`[delegate] Failed to fetch similar task #${similarId}`, { error: err instanceof Error ? err.message : String(err) });
+            }
+          }
+          if (similarTasksSections.length > 0) {
+            fullPrompt += `
+
+---
+
+## Similar Tasks Reference
+
+The following similar tasks and their operation records can serve as reference:
+
+`;
+            fullPrompt += similarTasksSections.join(`
+`);
+            fullPrompt += `
+
+---
+
+Use these as guidance to improve task execution efficiency.`;
+          }
+        }
+      } catch (err) {
+        logger.warn(`[delegate] Failed to inject similar tasks reference`, { error: err instanceof Error ? err.message : String(err) });
+      }
+    }
     if (!agentComponent) {
       throw new Error("AgentComponent not found");
     }
@@ -609,12 +672,13 @@ No need to poll — just wait for the notification and use \`task_get\` with the
 - **prompt**: The task for the agent to perform
 - **subagent_type**: The type of specialized agent to use (e.g., "general", "explore")
 - **timeout**: Task timeout in milliseconds (optional, default 30 minutes)
-- **reason**: Brief reason for calling this tool (optional)`,
+- **reason**: Brief reason for calling this tool (optional)
+- **similar_task_ids**: Similar task IDs (max 3) to reference for improving sub-agent execution efficiency. Search for similar tasks using \`task_search\` or \`task_list\` before calling this tool.`,
     parameters: DelegateToolParameters,
     execute: async (args, ctx) => {
       const startTime = Date.now();
       const params = DelegateToolParameters.parse(args);
-      const { description, prompt, subagent_type = "general", timeout, reason } = params;
+      const { description, prompt, subagent_type = "general", timeout, reason, similar_task_ids } = params;
       const parentSessionId = ctx.session_id || "default";
       logger.info(`[delegate_task] Called: description=${description}, subagent_type=${subagent_type}`);
       const registry2 = getAgentRegistry(taskComponent);
@@ -644,12 +708,12 @@ No need to poll — just wait for the notification and use \`task_get\` with the
       };
       await globalHookManager.execute(TaskHookPoints.DELEGATE_BEFORE, delegateCtx, { sessionId: parentSessionId });
       promptWithTaskInfo = delegateCtx.prompt;
-      return await handleBackgroundTask(backgroundTaskManager, parentSessionId, description, promptWithTaskInfo, delegateCtx.subagentType, delegateCtx.timeout);
+      return await handleBackgroundTask(backgroundTaskManager, parentSessionId, description, promptWithTaskInfo, delegateCtx.subagentType, delegateCtx.timeout, similar_task_ids);
     }
   };
   return tool;
 }
-async function handleBackgroundTask(backgroundTaskManager, parentSessionId, description, prompt, subagentType, timeout) {
+async function handleBackgroundTask(backgroundTaskManager, parentSessionId, description, prompt, subagentType, timeout, similarTaskIds) {
   const startTime = Date.now();
   try {
     const { taskId: bgProcessId, subSessionId } = await backgroundTaskManager.createTask({
@@ -657,7 +721,8 @@ async function handleBackgroundTask(backgroundTaskManager, parentSessionId, desc
       description,
       prompt,
       subagentType,
-      timeout
+      timeout,
+      similarTaskIds
     });
     const output = [
       `✅ Background task accepted`,

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

@@ -130,6 +130,8 @@ var builtInPrompts = {
 
 **\`delegate_task\`** — 这是你的**主要执行工具**。用于一切复杂、多步骤、需要读文件、运行命令、代码分析、搜索、实现功能等场景。**当不确定用哪个时，选 \`delegate_task\`。**
 
+> **similar_task_ids 是必填参数**：每次调用 \`delegate_task\` 前，必须先使用 \`task_search\` 搜索与当前任务相似的历史任务，将找到的相似任务 ID 填入 \`similar_task_ids\` 参数（最多 3 个）。如果没有找到相似任务，传入空数组 \`similar_task_ids=[]\`。
+
 **\`bash\`** — **仅限**以下**一次性简单操作**：
 - 调用一行 \`roy-agent\` 命令（如 \`bun packages/cli/dist/bin/roy-agent.js tasks list\`）
 - 执行一个简单的 shell 命令（如 \`ls\`、\`echo hello\`）
@@ -184,7 +186,8 @@ delegate_task(
   prompt="详细说明。
 
 重要：遵循任务作为一等公民原则 — 使用 \`task_create\` 创建任务，使用 \`task_update\` 跟踪进度，使用 \`task_operation_create\` 记录里程碑，并使用 \`task_complete\` 完成任务。",
-  subagent_type="roy"
+  subagent_type="roy",
+  similar_task_ids=[]  // 必填：先使用 task_search 搜索相似任务，将找到的 ID 填入此处（最多 3 个）
 )
 \`\`\`
 
@@ -206,7 +209,8 @@ delegate_task(
   prompt="详细说明。
 
 重要：遵循任务作为一等公民原则 — 使用 \`task_create\` 创建任务，使用 \`task_update\` 跟踪进度，使用 \`task_operation_create\` 记录里程碑，并使用 \`task_complete\` 完成任务。",
-  subagent_type="strict-task-agent"
+  subagent_type="strict-task-agent",
+  similar_task_ids=[]  // 必填：先使用 task_search 搜索相似任务，将找到的 ID 填入此处（最多 3 个）
 )
 \`\`\`
 
@@ -215,7 +219,7 @@ delegate_task(
 1. **理解** — 用户到底想要什么？
 2. **分类** — 如果需要任何超出简单对话的操作 → 委托。如果是问候/一次性回答 → 直接回复。
 3. **选择智能体** — \`roy\`（默认）或 \`strict-task-agent\`（需要严格验证时）
-4. **委托时包含任务生命周期** — 在给子智能体的提示词中，始终包含简要指令，要求将工作视为任务一等公民：创建任务（\`task_create\`）、跟踪进度并完成。
+4. **搜索相似任务并委托** — 在委托前，先使用 \`task_search\` 搜索与当前请求相关的历史任务，将找到的相似任务 ID 填入 \`similar_task_ids\` 参数。在给子智能体的提示词中，始终包含简要指令，要求将工作视为任务一等公民：创建任务（\`task_create\`）、跟踪进度并完成。
 5. **汇报结果** — 向用户总结结果
 
 ## 行为规则

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

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

package/package.json

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