@ai-setting/roy-agent-core 1.7.1 → 1.7.2

package/dist/env/index.js

@@ -48,7 +48,7 @@ import"../shared/@ai-setting/roy-agent-core-t3yqzgse.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-8s7qyr5y.js";
+} from "../shared/@ai-setting/roy-agent-core-y9q3jdcx.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-50jdqb7r.js";
@@ -62,7 +62,7 @@ import {
   getXDGPaths
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../shared/@ai-setting/roy-agent-core-hks28tys.js";
+import"../shared/@ai-setting/roy-agent-core-k4byknt1.js";
 import"../shared/@ai-setting/roy-agent-core-rn57psp0.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-8s7qyr5y.js";
+} from "../../shared/@ai-setting/roy-agent-core-y9q3jdcx.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
 import {
   TaskEntityEventTypes
@@ -20,7 +20,7 @@ import"../../shared/@ai-setting/roy-agent-core-skqt40yy.js";
 import"../../shared/@ai-setting/roy-agent-core-x0yztmm6.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../shared/@ai-setting/roy-agent-core-hks28tys.js";
+import"../../shared/@ai-setting/roy-agent-core-k4byknt1.js";
 import"../../shared/@ai-setting/roy-agent-core-rn57psp0.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";

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

@@ -9,7 +9,7 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-hks28tys.js";
+} from "../../../shared/@ai-setting/roy-agent-core-k4byknt1.js";
 import"../../../shared/@ai-setting/roy-agent-core-xrr7t0qc.js";
 import"../../../shared/@ai-setting/roy-agent-core-gb7pm9c0.js";
 import"../../../shared/@ai-setting/roy-agent-core-kaq037np.js";

package/dist/index.js

@@ -145,7 +145,7 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-8s7qyr5y.js";
+} from "./shared/@ai-setting/roy-agent-core-y9q3jdcx.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-50jdqb7r.js";
@@ -167,7 +167,7 @@ import {
   getXDGPaths
 } from "./shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"./shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"./shared/@ai-setting/roy-agent-core-hks28tys.js";
+import"./shared/@ai-setting/roy-agent-core-k4byknt1.js";
 import"./shared/@ai-setting/roy-agent-core-rn57psp0.js";
 import {
   TaskHookPoints

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

@@ -72,6 +72,10 @@ var UpdateTaskToolSchema = z.object({
 var DeleteTaskToolSchema = z.object({
   task_id: z.number().describe("Task ID")
 });
+var CompleteTaskToolSchema = z.object({
+  task_id: z.number().describe("Task ID"),
+  deliverable_storage_path: z.string().optional().describe("交付物的寻址地址（路径 / URL / 分支名等）。" + "调用本工具前，请先读取任务的 goal（description）和 delivery（goals_and_expected_deliverables）栏位，" + "建议验证目标和交付物是否符合预期，然后将实际交付物的寻址地址填入此参数。")
+});
 var BatchArchiveToolSchema = z.object({
   task_ids: z.array(z.number()).describe("要归档的任务 ID 列表"),
   reason: z.string().optional().describe("归档原因（可选，会写入每个任务的 operation 记录）")
@@ -817,13 +821,38 @@ function deleteTaskTool(taskComponent) {
 init_env_context();
 init_logger();
 var logger4 = createLogger("task:tools:complete");
+var TASK_COMPLETE_DESCRIPTION = `
+Mark a task as completed (progress=100, status=completed). Creates an operation record.
+
+**Before calling this tool**, you MUST:
+
+1. Read the task's \`goal\` (description) and \`delivery\` (goals_and_expected_deliverables) fields.
+   - Use \`task_get(task_id=<id>)\` to fetch the full task record.
+2. **Validate** whether the goal and delivery match what you actually delivered.
+   - If mismatch, either: (a) extend the task via \`task_update\`, or (b) honestly note the discrepancy in your final report.
+3. **Provide \`deliverable_storage_path\`** parameter with the deliverable's address:
+   - Feishu doc URL (e.g., https://my.feishu.cn/docx/abc)
+   - Local file path (e.g., /tmp/report.md)
+   - Git branch or worktree path (e.g., feature/my-feature)
+   - GitHub commit URL or PR URL
+   - Cloud drive URL (e.g., https://my.feishu.cn/file/abc)
+   - Or any other locator that points to where the work product lives
+
+The \`deliverable_storage_path\` will be persisted to the task's \`context.deliverable_storage_path\` for future reference and traceability.
+
+**Restrictions**:
+- Cannot complete cycle-type tasks (they are periodic). Use \`task_update\` to reset progress instead.
+- Marks the task as 100% complete; use \`task_update\` to record partial progress first if needed.
+
+**Backward compatibility**: \`deliverable_storage_path\` is optional. Existing callers that omit it continue to work as before.
+`.trim();
 function completeTaskTool(taskComponent) {
   return {
     name: "task_complete",
-    description: "Mark a task as completed (progress=100, status=completed). Creates an operation record.",
-    parameters: DeleteTaskToolSchema,
+    description: TASK_COMPLETE_DESCRIPTION,
+    parameters: CompleteTaskToolSchema,
     execute: async (args, ctx) => {
-      const params = DeleteTaskToolSchema.parse(args);
+      const params = CompleteTaskToolSchema.parse(args);
       const sessionId = ctx.session_id || "unknown";
       try {
         const currentTask = await taskComponent.getTask(params.task_id);
@@ -843,7 +872,7 @@ function completeTaskTool(taskComponent) {
             metadata: { execution_time_ms: 0 }
           };
         }
-        const task = await taskComponent.completeTask(params.task_id, sessionId);
+        const task = await taskComponent.completeTask(params.task_id, sessionId, params.deliverable_storage_path);
         if (!task) {
           return {
             success: false,
@@ -853,10 +882,12 @@ function completeTaskTool(taskComponent) {
           };
         }
         setCurrentTaskId(undefined);
-        logger4.info(`[completeTask] Trace: Task #${params.task_id} completed, currentTaskId cleared from EnvContext`);
+        logger4.info(`[completeTask] Trace: Task #${params.task_id} completed, deliverable=${params.deliverable_storage_path || "(none)"}, currentTaskId cleared from EnvContext`);
         return {
           success: true,
-          output: `Task completed: #${task.id} - ${task.title}`,
+          output: params.deliverable_storage_path ? `Task completed: #${task.id} - ${task.title}
+Deliverable (context + operation): ${params.deliverable_storage_path}` : `Task completed: #${task.id} - ${task.title}
+Deliverable: (no path provided)`,
           metadata: { execution_time_ms: 0, task }
         };
       } catch (error) {

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

@@ -24,7 +24,7 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "./roy-agent-core-hks28tys.js";
+} from "./roy-agent-core-k4byknt1.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -182,6 +182,12 @@ class DefaultTagService {
 // src/env/task/task-component.ts
 init_decorator();
 var logger2 = createLogger("task");
+var DELIVERABLE_OPERATION_PREFIX = "Deliverable: ";
+function formatDeliverableForOperation(deliverableStoragePath) {
+  if (!deliverableStoragePath)
+    return;
+  return `${DELIVERABLE_OPERATION_PREFIX}${deliverableStoragePath}`;
+}
 
 class TaskComponent extends BaseComponent {
   name = "task";
@@ -489,24 +495,41 @@ class TaskComponent extends BaseComponent {
   async getChildTasks(taskId, options) {
     return this.store.getChildTasks(taskId, options);
   }
-  async completeTask(id, sessionId) {
+  async completeTask(id, sessionId, deliverableStoragePath) {
     const existing = await this.store.getTask(id);
     if (existing && existing.type === "cycle") {
       throw new Error(`Cannot complete cycle task: #${id} - ${existing.title}. Cycle tasks are not meant to be completed.`);
     }
-    const task = await this.updateTask(id, {
+    const updateOptions = {
       status: "completed",
       progress: 100
-    });
+    };
+    if (deliverableStoragePath) {
+      let existingContext = {};
+      if (existing?.context) {
+        try {
+          const parsed = JSON.parse(existing.context);
+          if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            existingContext = parsed;
+          }
+        } catch {
+          logger2.warn(`[TaskComponent] Task #${id} context is not valid JSON, ignoring when merging deliverable`);
+        }
+      }
+      existingContext.deliverable_storage_path = deliverableStoragePath;
+      updateOptions.context = JSON.stringify(existingContext);
+    }
+    const task = await this.updateTask(id, updateOptions);
     if (task) {
       await this.createOperation({
         taskId: id,
         sessionId,
         milestoneType: "completed",
-        milestoneTitle: "Task completed"
+        milestoneTitle: "Task completed",
+        milestoneDescription: formatDeliverableForOperation(deliverableStoragePath)
       });
       this.publishEvent(TaskEntityEventTypes.COMPLETED, { task, sessionId }, sessionId);
-      logger2.info(`[TaskComponent] Task completed: ${id}`);
+      logger2.info(`[TaskComponent] Task completed: ${id}, deliverable=${deliverableStoragePath || "(none)"}`);
     }
     return task;
   }

package/package.json

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