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

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.11",
+  "version": "1.6.12",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",