@ai-setting/roy-agent-core 1.6.10 → 1.6.12

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

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-8wd3qwx5.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-trdpar9f.js";
+} from "./roy-agent-core-ms5dp89r.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
@@ -495,7 +495,7 @@ class LarkCliTaskNotifyHook {
     await this.sendNotify({
       type: "operation_created" /* OPERATION_CREATED */,
       title: this.getNotifyTitle("operation_created" /* OPERATION_CREATED */),
-      content: this.formatOperationCreated(operation),
+      content: await this.formatOperationCreated(operation),
       _hookContext: ctx
     });
   }
@@ -588,6 +588,16 @@ ${content}`;
       });
     });
   }
+  truncate(text, maxLen) {
+    if (text.length <= maxLen)
+      return text;
+    return text.substring(0, maxLen) + "...";
+  }
+  appendProjectPathLine(lines, task) {
+    if (task?.project_path) {
+      lines.push(`- **项目路径**: \`${task.project_path}\``);
+    }
+  }
   shouldNotify(type) {
     const { notifyTypes } = this.config;
     if (notifyTypes && notifyTypes.length === 0)
@@ -621,12 +631,12 @@ ${content}`;
       lines.push(`- **标题**: ${task.title}`);
     }
     if (task.description) {
-      const desc = task.description.substring(0, 100) + (task.description.length > 100 ? "..." : "");
-      lines.push(`- **描述**: ${desc}`);
+      lines.push(`- **描述**: ${this.truncate(task.description, 100)}`);
     }
     if (task.priority) {
       lines.push(`- **优先级**: ${task.priority}`);
     }
+    this.appendProjectPathLine(lines, task);
     return lines.join(`
 `);
   }
@@ -645,6 +655,7 @@ ${content}`;
     if (changes?.current_status) {
       lines.push(`- **当前状态**: ${changes.current_status}`);
     }
+    this.appendProjectPathLine(lines, task);
     const changeKeys = Object.keys(changes || {}).filter((k) => !["status", "progress", "current_status"].includes(k));
     if (changeKeys.length > 0) {
       lines.push(`- **变更**: ${changeKeys.join(", ")}`);
@@ -667,28 +678,49 @@ ${content}`;
     this.lastNotifyTimestamps.set(key, now);
     return false;
   }
-  formatOperationCreated(operation) {
+  async formatOperationCreated(operation, task) {
+    const resolvedTask = task ?? await this.resolveTaskForOperation(operation);
     const lines = [];
+    if (resolvedTask?.title) {
+      lines.push(`- **任务**: ${resolvedTask.title}`);
+    }
     if (operation.taskId !== undefined && operation.taskId !== null) {
       lines.push(`- **任务 ID**: #${operation.taskId}`);
     }
-    if (operation.actionType) {
-      lines.push(`- **操作类型**: ${operation.actionType}`);
+    if (operation.milestoneType) {
+      lines.push(`- **里程碑类型**: ${operation.milestoneType}`);
     }
-    if (operation.actionTitle) {
-      lines.push(`- **标题**: ${operation.actionTitle}`);
+    if (operation.milestoneTitle) {
+      lines.push(`- **标题**: ${operation.milestoneTitle}`);
     }
-    if (operation.actionDescription) {
-      const desc = String(operation.actionDescription);
-      const truncated = desc.substring(0, 200) + (desc.length > 200 ? "..." : "");
-      lines.push(`- **描述**: ${truncated}`);
+    if (operation.milestoneDescription) {
+      lines.push(`- **里程碑描述**: ${this.truncate(String(operation.milestoneDescription), 200)}`);
     }
+    if (operation.processDescription) {
+      lines.push(`- **过程概要**: ${this.truncate(String(operation.processDescription), 200)}`);
+    }
+    this.appendProjectPathLine(lines, resolvedTask);
     if (operation.sessionId) {
       lines.push(`- **Session**: \`${operation.sessionId}\``);
     }
     return lines.join(`
 `);
   }
+  async resolveTaskForOperation(operation) {
+    if (operation.taskId === undefined || operation.taskId === null) {
+      return;
+    }
+    const fetch = this.config.fetchTaskById;
+    if (!fetch) {
+      return;
+    }
+    try {
+      return await fetch(operation.taskId);
+    } catch (error) {
+      logger3.warn(`fetchTaskById failed for task #${operation.taskId}: ${error}`);
+      return;
+    }
+  }
 }
 __legacyDecorateClassTS([
   TracedAs("lark-cli-task-notify.execute")

package/dist/shared/@ai-setting/roy-agent-core-rn57psp0.js

@@ -0,0 +1,396 @@
+// src/env/task/tools/operation/create-tool.ts
+import { ZodError } from "zod";
+
+// src/env/task/tools/operation/operation-types.ts
+import { z } from "zod";
+var ActionTypeEnum = z.enum([
+  "create",
+  "progress",
+  "milestone",
+  "problem",
+  "solution",
+  "decision",
+  "review",
+  "completed",
+  "workflow_extracted"
+]);
+var PROCESS_DESCRIPTION_MIN_LENGTH = 100;
+var PROCESS_DESCRIPTION_MAX_LENGTH = 150;
+var MILESTONE_DESCRIPTION_MAX_LENGTH = 5000;
+var MILESTONE_TITLE_MIN_LENGTH = 1;
+var MILESTONE_TITLE_MAX_LENGTH = 200;
+var ProcessDescriptionSchema = z.string().min(PROCESS_DESCRIPTION_MIN_LENGTH, {
+  message: `process_description 太短（少于 ${PROCESS_DESCRIPTION_MIN_LENGTH} 字符），无法表达过程概要；如无过程信息请省略该字段，细节请回查 sessionId。`
+}).max(PROCESS_DESCRIPTION_MAX_LENGTH, {
+  message: `process_description 太长（超过 ${PROCESS_DESCRIPTION_MAX_LENGTH} 字符），会退化为日志细节；操作记录只承担 milestone 概要，完整细节请通过 sessionId 回查 session。`
+}).describe("过程概要（process_description）：采取的策略 + 工具步骤概要；" + `严格控制 ${PROCESS_DESCRIPTION_MIN_LENGTH}-${PROCESS_DESCRIPTION_MAX_LENGTH} 字符。` + "操作记录是节点阶段 milestone 摘要，完整过程通过 sessionId 回查 session；" + "milestone_description 才是达成的状态/结果描述。");
+var MilestoneTitleSchema = z.string().min(MILESTONE_TITLE_MIN_LENGTH, { message: "milestone_title 不能为空" }).max(MILESTONE_TITLE_MAX_LENGTH, {
+  message: `milestone_title 超过 ${MILESTONE_TITLE_MAX_LENGTH} 字符，建议精简（一行标题即可）。`
+}).describe("里程碑标题（milestone_title）：达成的里程碑/状态的一句话标题；" + "必填，1-200 字符。");
+var MilestoneDescriptionSchema = z.string().max(MILESTONE_DESCRIPTION_MAX_LENGTH, {
+  message: `milestone_description 超过 ${MILESTONE_DESCRIPTION_MAX_LENGTH} 字符；如需更详细的过程，请改用 process_description。`
+}).optional().describe("状态/结果描述（milestone_description）：达成的状态或结果描述；" + "可长可短；过程概要应放在 process_description，不要与本字段重复。");
+var CreateOperationInputSchema = z.object({
+  task_id: z.number().describe("Task ID"),
+  milestone_type: ActionTypeEnum.optional(),
+  milestone_title: MilestoneTitleSchema.optional(),
+  milestone_description: MilestoneDescriptionSchema,
+  process_description: ProcessDescriptionSchema.optional(),
+  action_type: ActionTypeEnum.optional(),
+  action_title: z.string().min(1).max(MILESTONE_TITLE_MAX_LENGTH).optional(),
+  action_description: z.string().max(MILESTONE_DESCRIPTION_MAX_LENGTH).optional(),
+  md_path: z.string().optional().describe("Path to detailed markdown documentation")
+});
+var CreateOperationToolSchema = CreateOperationInputSchema.transform((input) => {
+  const deprecatedFields = [];
+  let milestoneType = input.milestone_type;
+  let milestoneTitle = input.milestone_title;
+  let milestoneDescription = input.milestone_description;
+  if (!milestoneType && input.action_type) {
+    milestoneType = input.action_type;
+    deprecatedFields.push("action_type");
+  }
+  if (!milestoneTitle && input.action_title) {
+    milestoneTitle = input.action_title;
+    deprecatedFields.push("action_title");
+  }
+  if (milestoneDescription === undefined && input.action_description !== undefined) {
+    milestoneDescription = input.action_description;
+    deprecatedFields.push("action_description");
+  }
+  return {
+    task_id: input.task_id,
+    milestone_type: milestoneType,
+    milestone_title: milestoneTitle,
+    milestone_description: milestoneDescription,
+    process_description: input.process_description,
+    md_path: input.md_path,
+    _deprecated_fields_used: deprecatedFields
+  };
+});
+var GetOperationToolSchema = z.object({
+  operation_id: z.number().describe("Operation ID")
+});
+var ListOperationsToolSchema = z.object({
+  task_id: z.number().describe("Task ID"),
+  milestone_type: ActionTypeEnum.optional(),
+  action_type: ActionTypeEnum.optional(),
+  limit: z.number().optional().default(20),
+  offset: z.number().optional().default(0)
+}).transform((input) => {
+  const deprecatedFields = [];
+  let milestoneType = input.milestone_type;
+  if (!milestoneType && input.action_type) {
+    milestoneType = input.action_type;
+    deprecatedFields.push("action_type");
+  }
+  return {
+    task_id: input.task_id,
+    milestone_type: milestoneType,
+    limit: input.limit,
+    offset: input.offset,
+    _deprecated_fields_used: deprecatedFields
+  };
+});
+var UpdateOperationInputSchema = z.object({
+  operation_id: z.number().describe("Operation ID"),
+  milestone_title: MilestoneTitleSchema.optional(),
+  milestone_description: MilestoneDescriptionSchema,
+  process_description: ProcessDescriptionSchema.optional(),
+  action_title: z.string().min(1).max(MILESTONE_TITLE_MAX_LENGTH).optional(),
+  action_description: z.string().max(MILESTONE_DESCRIPTION_MAX_LENGTH).optional()
+});
+var UpdateOperationToolSchema = UpdateOperationInputSchema.transform((input) => {
+  const deprecatedFields = [];
+  let milestoneTitle = input.milestone_title;
+  let milestoneDescription = input.milestone_description;
+  if (!milestoneTitle && input.action_title) {
+    milestoneTitle = input.action_title;
+    deprecatedFields.push("action_title");
+  }
+  if (milestoneDescription === undefined && input.action_description !== undefined) {
+    milestoneDescription = input.action_description;
+    deprecatedFields.push("action_description");
+  }
+  return {
+    operation_id: input.operation_id,
+    milestone_title: milestoneTitle,
+    milestone_description: milestoneDescription,
+    process_description: input.process_description,
+    _deprecated_fields_used: deprecatedFields
+  };
+});
+var DeleteOperationToolSchema = z.object({
+  operation_id: z.number().describe("Operation ID")
+});
+
+// src/env/task/tools/operation/create-tool.ts
+function formatZodError(err) {
+  const parts = err.issues.map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`);
+  return `Invalid parameters: ${parts.join("; ")}`;
+}
+function ensureRequiredMilestoneFields(params) {
+  if (!params.milestone_type) {
+    return {
+      ok: false,
+      error: "milestone_type is required (or action_type for backward compatibility). " + "Use one of: create, progress, milestone, problem, solution, decision, review, completed, workflow_extracted."
+    };
+  }
+  if (!params.milestone_title) {
+    return {
+      ok: false,
+      error: "milestone_title is required (or action_title for backward compatibility)."
+    };
+  }
+  return { ok: true, milestoneType: params.milestone_type, milestoneTitle: params.milestone_title };
+}
+function createOperationTool(taskComponent) {
+  return {
+    name: "task_operation_create",
+    description: "Create an operation record for a task. Tracks milestones (state/result) and process (strategy + tool steps). " + "Dual-dimension schema: milestone_type/title/description captures WHAT milestone was reached; " + "process_description (100-150 chars) captures HOW. " + "Legacy action_* fields are accepted as deprecated aliases.",
+    parameters: CreateOperationToolSchema,
+    execute: async (args, ctx) => {
+      let params;
+      try {
+        const parsed = CreateOperationToolSchema.parse(args);
+        params = parsed;
+      } catch (e) {
+        if (e instanceof ZodError) {
+          return {
+            success: false,
+            output: "",
+            error: formatZodError(e),
+            metadata: { execution_time_ms: 0 }
+          };
+        }
+        throw e;
+      }
+      const check = ensureRequiredMilestoneFields(params);
+      if (!check.ok) {
+        return {
+          success: false,
+          output: "",
+          error: check.error,
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+      const sessionId = ctx.session_id || "unknown";
+      try {
+        const operation = await taskComponent.createOperation({
+          taskId: params.task_id,
+          sessionId,
+          milestoneType: check.milestoneType,
+          milestoneTitle: check.milestoneTitle,
+          milestoneDescription: params.milestone_description,
+          processDescription: params.process_description,
+          mdPath: params.md_path
+        });
+        let output = `Operation created: #${operation.id} for task #${operation.taskId} ` + `[milestone=${operation.milestoneType}] ${operation.milestoneTitle}`;
+        const deprecationWarnings = [];
+        if (params._deprecated_fields_used.length > 0) {
+          deprecationWarnings.push(`⚠️  DEPRECATION NOTICE: 你使用了旧的 action_* 字段 (${params._deprecated_fields_used.join(", ")})，已自动映射到 milestone_* 字段。` + "请尽快迁移到 milestone_type / milestone_title / milestone_description 主字段。");
+        }
+        if (deprecationWarnings.length > 0) {
+          output += `
+
+` + deprecationWarnings.join(`
+`);
+        }
+        return {
+          success: true,
+          output,
+          metadata: {
+            execution_time_ms: 0,
+            operation_id: operation.id,
+            task_id: operation.taskId,
+            session_id: operation.sessionId,
+            deprecated_fields_used: params._deprecated_fields_used
+          }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+// src/env/task/tools/operation/get-tool.ts
+function getOperationTool(taskComponent) {
+  return {
+    name: "task_operation_get",
+    description: "Get a single operation record by ID.",
+    parameters: GetOperationToolSchema,
+    execute: async (args, ctx) => {
+      const params = GetOperationToolSchema.parse(args);
+      try {
+        const operation = await taskComponent.getOperation(params.operation_id);
+        if (!operation) {
+          return {
+            success: false,
+            output: "",
+            error: `Operation not found: ${params.operation_id}`,
+            metadata: { execution_time_ms: 0 }
+          };
+        }
+        return {
+          success: true,
+          output: JSON.stringify(operation, null, 2),
+          metadata: { execution_time_ms: 0 }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+// src/env/task/tools/operation/list-tool.ts
+function listOperationsTool(taskComponent) {
+  return {
+    name: "task_operation_list",
+    description: "List operation records for a task with optional filters. " + "Use milestone_type (canonical) or action_type (deprecated, auto-mapped).",
+    parameters: ListOperationsToolSchema,
+    execute: async (args, ctx) => {
+      const parsed = ListOperationsToolSchema.parse(args);
+      try {
+        const operations = await taskComponent.listOperations({
+          taskId: parsed.task_id,
+          milestoneType: parsed.milestone_type,
+          limit: parsed.limit,
+          offset: parsed.offset
+        });
+        let output = JSON.stringify({ operations, count: operations.length });
+        if (parsed._deprecated_fields_used.length > 0) {
+          output = `⚠️  DEPRECATION NOTICE: 你使用了旧的 action_type 字段，已自动映射到 milestone_type。
+
+` + output;
+        }
+        return {
+          success: true,
+          output,
+          metadata: {
+            execution_time_ms: 0,
+            deprecated_fields_used: parsed._deprecated_fields_used
+          }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+// src/env/task/tools/operation/update-tool.ts
+import { ZodError as ZodError2 } from "zod";
+function formatZodError2(err) {
+  const parts = err.issues.map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`);
+  return `Invalid parameters: ${parts.join("; ")}`;
+}
+function updateOperationTool(taskComponent) {
+  return {
+    name: "task_operation_update",
+    description: "Update an operation record. Use milestone_title / milestone_description (canonical) " + "or action_title / action_description (deprecated, auto-mapped). " + "process_description captures the process (100-150 chars).",
+    parameters: UpdateOperationToolSchema,
+    execute: async (args, ctx) => {
+      let params;
+      try {
+        const parsed = UpdateOperationToolSchema.parse(args);
+        params = parsed;
+      } catch (e) {
+        if (e instanceof ZodError2) {
+          return {
+            success: false,
+            output: "",
+            error: formatZodError2(e),
+            metadata: { execution_time_ms: 0 }
+          };
+        }
+        throw e;
+      }
+      try {
+        const operation = await taskComponent.updateOperation(params.operation_id, {
+          milestoneTitle: params.milestone_title,
+          milestoneDescription: params.milestone_description,
+          processDescription: params.process_description
+        });
+        if (!operation) {
+          return {
+            success: false,
+            output: "",
+            error: `Operation not found: ${params.operation_id}`,
+            metadata: { execution_time_ms: 0 }
+          };
+        }
+        let output = `Operation updated: #${operation.id}`;
+        if (params._deprecated_fields_used.length > 0) {
+          output += `
+
+⚠️  DEPRECATION NOTICE: 你使用了旧的 action_* 字段 (${params._deprecated_fields_used.join(", ")})，已自动映射到 milestone_* 字段。` + "请尽快迁移到 milestone_* 字段。";
+        }
+        return {
+          success: true,
+          output,
+          metadata: {
+            execution_time_ms: 0,
+            operation,
+            deprecated_fields_used: params._deprecated_fields_used
+          }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+// src/env/task/tools/operation/delete-tool.ts
+function deleteOperationTool(taskComponent) {
+  return {
+    name: "task_operation_delete",
+    description: "Delete an operation record.",
+    parameters: DeleteOperationToolSchema,
+    execute: async (args, ctx) => {
+      const params = DeleteOperationToolSchema.parse(args);
+      try {
+        const deleted = await taskComponent.deleteOperation(params.operation_id);
+        if (!deleted) {
+          return {
+            success: false,
+            output: "",
+            error: `Operation not found: ${params.operation_id}`,
+            metadata: { execution_time_ms: 0 }
+          };
+        }
+        return {
+          success: true,
+          output: `Operation deleted: #${params.operation_id}`,
+          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 { createOperationTool, getOperationTool, listOperationsTool, updateOperationTool, deleteOperationTool };

package/package.json

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