@ai-setting/roy-agent-core 1.4.13 → 1.4.14

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

@@ -0,0 +1,286 @@
+// packages/core/src/env/task/tools/task-types.ts
+import { z } from "zod";
+var CreateTaskToolSchema = z.object({
+  title: z.string().describe("Task title"),
+  description: z.string().optional().describe("Task description"),
+  priority: z.enum(["low", "medium", "high"]).optional().describe("Task priority"),
+  goals_and_expected_deliverables: z.string().optional().describe("Goals and expected deliverables"),
+  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)")
+});
+var GetTaskToolSchema = z.object({
+  task_id: z.number().describe("Task ID"),
+  include_operations: z.boolean().optional().default(false).describe("Include operation records")
+});
+var ListTasksToolSchema = z.object({
+  status: z.enum(["todo", "active", "completed", "paused", "cancelled"]).optional(),
+  priority: z.enum(["low", "medium", "high"]).optional(),
+  limit: z.number().optional().default(20),
+  offset: z.number().optional().default(0)
+});
+var UpdateTaskToolSchema = z.object({
+  task_id: z.number().describe("Task ID"),
+  title: z.string().optional(),
+  description: z.string().optional(),
+  status: z.enum(["todo", "active", "completed", "paused", "cancelled"]).optional(),
+  priority: z.enum(["low", "medium", "high"]).optional(),
+  progress: z.number().min(0).max(100).optional(),
+  current_status: z.string().optional(),
+  goals_and_expected_deliverables: z.string().optional(),
+  due_date: z.string().optional(),
+  tags: z.array(z.string()).optional()
+});
+var DeleteTaskToolSchema = z.object({
+  task_id: z.number().describe("Task ID")
+});
+
+// packages/core/src/env/task/tools/create-tool.ts
+function createTaskTool(taskComponent) {
+  return {
+    name: "task_create",
+    description: "Create a new task. The task will be associated with the current session.",
+    parameters: CreateTaskToolSchema,
+    execute: async (args, ctx) => {
+      const params = CreateTaskToolSchema.parse(args);
+      const sessionId = ctx.session_id || "unknown";
+      try {
+        const task = await taskComponent.createTask({
+          title: params.title,
+          description: params.description,
+          priority: params.priority,
+          goals_and_expected_deliverables: params.goals_and_expected_deliverables,
+          due_date: params.due_date,
+          tags: params.tags,
+          sessionId
+        });
+        return {
+          success: true,
+          output: `Task created successfully: #${task.id} - ${task.title}`,
+          metadata: {
+            execution_time_ms: 0,
+            task_id: task.id,
+            status: task.status,
+            createdAt: task.createdAt
+          }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+// packages/core/src/env/task/tools/get-tool.ts
+function getTaskTool(taskComponent) {
+  return {
+    name: "task_get",
+    description: "Get task details by ID. Optionally include operation records.",
+    parameters: GetTaskToolSchema,
+    execute: async (args, ctx) => {
+      const params = GetTaskToolSchema.parse(args);
+      try {
+        if (params.include_operations) {
+          const result = await taskComponent.getTaskWithOperations(params.task_id);
+          if (!result) {
+            return {
+              success: false,
+              output: "",
+              error: `Task not found: ${params.task_id}`,
+              metadata: { execution_time_ms: 0 }
+            };
+          }
+          return {
+            success: true,
+            output: JSON.stringify(result, null, 2),
+            metadata: { execution_time_ms: 0 }
+          };
+        } else {
+          const task = await taskComponent.getTask(params.task_id);
+          if (!task) {
+            return {
+              success: false,
+              output: "",
+              error: `Task not found: ${params.task_id}`,
+              metadata: { execution_time_ms: 0 }
+            };
+          }
+          return {
+            success: true,
+            output: JSON.stringify(task, 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 }
+        };
+      }
+    }
+  };
+}
+// packages/core/src/env/task/tools/list-tool.ts
+function listTasksTool(taskComponent) {
+  return {
+    name: "task_list",
+    description: "List tasks with optional filters for status and priority.",
+    parameters: ListTasksToolSchema,
+    execute: async (args, ctx) => {
+      const params = ListTasksToolSchema.parse(args);
+      try {
+        const tasks = await taskComponent.listTasks({
+          status: params.status,
+          priority: params.priority,
+          limit: params.limit,
+          offset: params.offset
+        });
+        return {
+          success: true,
+          output: JSON.stringify({ tasks, count: tasks.length }),
+          metadata: { execution_time_ms: 0 }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+// packages/core/src/env/task/tools/update-tool.ts
+function updateTaskTool(taskComponent) {
+  return {
+    name: "task_update",
+    description: "Update an existing task's properties. Status and progress changes will create operation records.",
+    parameters: UpdateTaskToolSchema,
+    execute: async (args, ctx) => {
+      const params = UpdateTaskToolSchema.parse(args);
+      const sessionId = ctx.session_id || "unknown";
+      try {
+        const task = await taskComponent.updateTask(params.task_id, {
+          title: params.title,
+          description: params.description,
+          status: params.status,
+          priority: params.priority,
+          progress: params.progress,
+          current_status: params.current_status,
+          goals_and_expected_deliverables: params.goals_and_expected_deliverables,
+          due_date: params.due_date,
+          tags: params.tags
+        });
+        if (!task) {
+          return {
+            success: false,
+            output: "",
+            error: `Task not found: ${params.task_id}`,
+            metadata: { execution_time_ms: 0 }
+          };
+        }
+        if (params.status || params.progress !== undefined || params.current_status) {
+          await taskComponent.createOperation({
+            taskId: params.task_id,
+            sessionId,
+            actionType: "progress",
+            actionTitle: params.current_status || `Updated: ${params.status || `${params.progress}%`}`,
+            actionDescription: JSON.stringify({
+              status: params.status,
+              progress: params.progress,
+              current_status: params.current_status
+            })
+          });
+        }
+        return {
+          success: true,
+          output: `Task updated: #${task.id} - ${task.title}`,
+          metadata: { execution_time_ms: 0, task }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+// packages/core/src/env/task/tools/delete-tool.ts
+function deleteTaskTool(taskComponent) {
+  return {
+    name: "task_delete",
+    description: "Delete a task and all its operation records.",
+    parameters: DeleteTaskToolSchema,
+    execute: async (args, ctx) => {
+      const params = DeleteTaskToolSchema.parse(args);
+      try {
+        const deleted = await taskComponent.deleteTask(params.task_id);
+        if (!deleted) {
+          return {
+            success: false,
+            output: "",
+            error: `Task not found: ${params.task_id}`,
+            metadata: { execution_time_ms: 0 }
+          };
+        }
+        return {
+          success: true,
+          output: `Task deleted: #${params.task_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 }
+        };
+      }
+    }
+  };
+}
+// packages/core/src/env/task/tools/complete-tool.ts
+function completeTaskTool(taskComponent) {
+  return {
+    name: "task_complete",
+    description: "Mark a task as completed (progress=100, status=completed). Creates an operation record.",
+    parameters: DeleteTaskToolSchema,
+    execute: async (args, ctx) => {
+      const params = DeleteTaskToolSchema.parse(args);
+      const sessionId = ctx.session_id || "unknown";
+      try {
+        const task = await taskComponent.completeTask(params.task_id, sessionId);
+        if (!task) {
+          return {
+            success: false,
+            output: "",
+            error: `Task not found: ${params.task_id}`,
+            metadata: { execution_time_ms: 0 }
+          };
+        }
+        return {
+          success: true,
+          output: `Task completed: #${task.id} - ${task.title}`,
+          metadata: { execution_time_ms: 0, task }
+        };
+      } catch (error) {
+        return {
+          success: false,
+          output: "",
+          error: error instanceof Error ? error.message : String(error),
+          metadata: { execution_time_ms: 0 }
+        };
+      }
+    }
+  };
+}
+export { createTaskTool, getTaskTool, listTasksTool, updateTaskTool, deleteTaskTool, completeTaskTool };

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

@@ -0,0 +1,393 @@
+import {
+  envKeyToConfigKey
+} from "./roy-agent-core-jv3b7v9w.js";
+import {
+  BaseComponent
+} from "./roy-agent-core-m2x48hw6.js";
+import {
+  createMemoryTools
+} from "./roy-agent-core-8mbmrwzs.js";
+import {
+  createLogger,
+  init_logger
+} from "./roy-agent-core-yn761yve.js";
+
+// packages/core/src/env/memory/types.ts
+import { z } from "zod";
+var RecordMemorySchema = z.object({
+  scope: z.enum(["project", "global"]).describe("作用域: project/global"),
+  mode: z.enum(["append", "prepend", "overwrite", "delete"]).describe("模式: append(追加)/prepend(插入)/overwrite(覆盖)/delete(删除)"),
+  content: z.string().optional().describe("记忆内容"),
+  title: z.string().optional().describe("章节标题")
+});
+var RecallMemorySchema = z.object({
+  scope: z.enum(["project", "global"]).optional().describe("作用域（可选，不传则读取所有）")
+});
+// packages/core/src/env/memory/memory-config.ts
+import path from "path";
+import os from "os";
+var DEFAULT_MEMORY_CONFIG = {
+  memoryPaths: [
+    {
+      type: "global",
+      path: path.join(os.homedir(), ".config", "roy-agent", "memory")
+    },
+    {
+      type: "project",
+      path: ".roy/memory"
+    }
+  ],
+  recursive: true,
+  cacheEnabled: true,
+  cacheTTL: 5 * 60 * 1000
+};
+var SOURCE_PRIORITY = {
+  global: 0,
+  project: 1
+};
+function getSourcePriority(source) {
+  return SOURCE_PRIORITY[source] ?? 0;
+}
+// packages/core/src/env/memory/memory-component.ts
+init_logger();
+
+// packages/core/src/env/memory/memory-config-registration.ts
+import path2 from "path";
+import os2 from "os";
+var MEMORY_DEFAULTS = {
+  "memory.recursive": true,
+  "memory.cacheEnabled": true,
+  "memory.cacheTTL": 300000,
+  "memory.memoryFile": "memory.md",
+  "memory.memoryPaths": [
+    { type: "global", path: path2.join(os2.homedir(), ".config", "roy-agent", "memory") },
+    { type: "project", path: ".roy/memory" }
+  ]
+};
+var MEMORY_CONFIG_REGISTRATION = {
+  name: "memory",
+  sources: [
+    { type: "env", envPrefix: "MEMORY", priority: 20, watch: false }
+  ],
+  keys: [
+    { key: "memory.recursive", sources: ["env", "file"] },
+    { key: "memory.cacheEnabled", sources: ["env", "file"] },
+    { key: "memory.cacheTTL", sources: ["env", "file"] },
+    { key: "memory.memoryPaths", sources: ["env", "file"] },
+    { key: "memory.memoryFile", sources: ["env", "file"] }
+  ]
+};
+
+// packages/core/src/env/memory/memory-component.ts
+import path3 from "path";
+import fs from "fs/promises";
+var logger = createLogger("memory");
+
+class MemoryComponent extends BaseComponent {
+  name = "memory";
+  version = "2.0.0";
+  config;
+  toolComponent;
+  configComponent;
+  cache = new Map;
+  configWatcher;
+  async init(config) {
+    await super.init(config);
+    const options = config?.options;
+    if (!options?.configComponent) {
+      throw new Error("ConfigComponent is required for MemoryComponent initialization");
+    }
+    this.configComponent = options.configComponent;
+    await this.registerConfig(options);
+    logger.info("[MemoryComponent] Initialized (simplified)");
+  }
+  async registerConfig(options) {
+    const configComponent = this.configComponent;
+    if (!configComponent)
+      return;
+    const { configPath, envPrefix, config } = options;
+    const prefix = envPrefix ?? "MEMORY";
+    configComponent.registerComponent(MEMORY_CONFIG_REGISTRATION);
+    if (configPath) {
+      configComponent.registerSource({
+        type: "file",
+        relativePath: configPath,
+        optional: true,
+        watch: false
+      });
+    }
+    configComponent.registerSource({
+      type: "env",
+      envPrefix: prefix,
+      priority: 20,
+      watch: false
+    });
+    await configComponent.load("memory");
+    for (const envKey of Object.keys(process.env)) {
+      const configKey = envKeyToConfigKey(envKey, prefix, "memory");
+      if (!configKey)
+        continue;
+      const value = process.env[envKey];
+      if (value !== undefined) {
+        await configComponent.set(configKey, value);
+      }
+    }
+    for (const [key, value] of Object.entries(MEMORY_DEFAULTS)) {
+      if (configComponent.get(key) === undefined) {
+        await configComponent.set(key, value);
+      }
+    }
+    if (config) {
+      const flatConfig = this.flattenConfig(config);
+      for (const [key, value] of Object.entries(flatConfig)) {
+        await configComponent.set(key, value);
+      }
+    }
+    this.registerConfigWatcher(configComponent);
+    this.buildConfig(configComponent);
+  }
+  buildConfig(configComponent) {
+    const recursive = configComponent.get("memory.recursive") ?? true;
+    const cacheEnabled = configComponent.get("memory.cacheEnabled") ?? true;
+    const cacheTTL = configComponent.get("memory.cacheTTL") ?? 300000;
+    const memoryFile = configComponent.get("memory.memoryFile") ?? "memory.md";
+    const memoryPathsConfig = configComponent.get("memory.memoryPaths");
+    let memoryPaths = [];
+    if (Array.isArray(memoryPathsConfig)) {
+      memoryPaths = memoryPathsConfig;
+    } else if (typeof memoryPathsConfig === "string") {
+      try {
+        memoryPaths = JSON.parse(memoryPathsConfig);
+      } catch {
+        memoryPaths = DEFAULT_MEMORY_CONFIG.memoryPaths;
+      }
+    }
+    if (memoryPaths.length === 0) {
+      memoryPaths = DEFAULT_MEMORY_CONFIG.memoryPaths;
+    }
+    this.config = {
+      memoryPaths,
+      recursive,
+      cacheEnabled,
+      cacheTTL,
+      memoryFile
+    };
+  }
+  flattenConfig(obj, prefix = "memory") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      const fullKey = `${prefix}.${key}`;
+      if (value && typeof value === "object" && !Array.isArray(value)) {
+        Object.assign(result, this.flattenConfig(value, fullKey));
+      } else {
+        result[fullKey] = value;
+      }
+    }
+    return result;
+  }
+  registerConfigWatcher(configComponent) {
+    if (typeof configComponent.watch !== "function") {
+      return;
+    }
+    this.configWatcher = configComponent.watch("memory.*", (event) => {
+      this.onConfigChange(event);
+    });
+  }
+  onConfigChange(event) {
+    logger.info(`[MemoryComponent] Config changed: ${event.key}`, {
+      oldValue: event.oldValue,
+      newValue: event.newValue
+    });
+    if (this.configComponent) {
+      this.buildConfig(this.configComponent);
+    }
+    this.cache.clear();
+  }
+  async start() {
+    await super.start();
+    this.toolComponent = this.env?.getComponent("tool");
+    if (!this.toolComponent) {
+      logger.warn("[MemoryComponent] ToolComponent not found, skipping tool registration");
+      return;
+    }
+    await this.registerTools();
+    this.setStatus("running");
+    logger.info(`[MemoryComponent] Started with ${this.toolComponent.getToolCount()} tools`);
+  }
+  async stop() {
+    if (this.configWatcher) {
+      this.configWatcher();
+      this.configWatcher = undefined;
+    }
+    if (this.toolComponent) {
+      this.toolComponent.unregister("record_memory");
+      this.toolComponent.unregister("recall_memory");
+    }
+    this.cache.clear();
+    await super.stop();
+    logger.info("[MemoryComponent] Stopped");
+  }
+  async registerTools() {
+    if (!this.toolComponent)
+      return;
+    const tools = createMemoryTools((args) => this.recordMemory(args), (scope) => this.recallMemory(scope), {
+      getMemoryPaths: () => this.getMemoryPaths(),
+      getMemoryFile: () => this.getMemoryFile()
+    });
+    for (const tool of tools) {
+      this.toolComponent.register(tool);
+    }
+    logger.info("[MemoryComponent] Registered memory tools");
+  }
+  getMemoryPaths() {
+    return this.config.memoryPaths;
+  }
+  updateMemoryPaths(paths) {
+    this.config.memoryPaths = paths;
+    this.clearCache();
+  }
+  getMemoryFile() {
+    return this.config.memoryFile ?? "memory.md";
+  }
+  async recordMemory(args) {
+    const { mode, content, title, filename, scope } = args;
+    const memoryFile = filename ?? this.getMemoryFile();
+    const paths = this.config.memoryPaths;
+    if (paths.length === 0) {
+      return null;
+    }
+    let basePath;
+    if (scope) {
+      const targetPath = paths.find((p) => p.type === scope);
+      if (!targetPath) {
+        logger.warn(`[recordMemory] No ${scope} path configured, using first available path`);
+        basePath = paths[0].path;
+      } else {
+        basePath = targetPath.path;
+      }
+    } else {
+      basePath = paths[0].path;
+    }
+    const filePath = path3.join(basePath, memoryFile);
+    try {
+      let existingContent = "";
+      let fileExists = false;
+      try {
+        existingContent = await fs.readFile(filePath, "utf-8");
+        fileExists = true;
+      } catch {}
+      let newContent;
+      let action;
+      switch (mode) {
+        case "delete":
+          if (fileExists) {
+            await fs.unlink(filePath);
+            this.clearCache();
+            return { path: filePath, action: "delete" };
+          }
+          return null;
+        case "overwrite":
+          if (title && content) {
+            newContent = `## ${title}
+
+${content}
+`;
+          } else {
+            newContent = content ?? "";
+          }
+          action = fileExists ? "overwrite" : "created";
+          break;
+        case "append":
+          if (!content) {
+            throw new Error("content is required for append mode");
+          }
+          if (title) {
+            newContent = existingContent + `
+## ${title}
+
+${content}
+`;
+          } else {
+            newContent = existingContent + `
+${content}
+`;
+          }
+          action = fileExists ? "append" : "created";
+          break;
+        case "prepend":
+          if (!content) {
+            throw new Error("content is required for prepend mode");
+          }
+          if (title) {
+            newContent = `## ${title}
+
+${content}
+
+---
+
+${existingContent}`;
+          } else {
+            newContent = `${content}
+
+---
+
+${existingContent}`;
+          }
+          action = fileExists ? "prepend" : "created";
+          break;
+        default:
+          throw new Error(`Unknown mode: ${mode}`);
+      }
+      await fs.mkdir(basePath, { recursive: true });
+      await fs.writeFile(filePath, newContent, "utf-8");
+      this.clearCache();
+      return { path: filePath, action };
+    } catch (error) {
+      logger.error(`[recordMemory] Failed: ${error}`);
+      throw error;
+    }
+  }
+  async recallMemory(scope) {
+    const memoryFile = this.getMemoryFile();
+    const paths = this.config.memoryPaths;
+    const results = [];
+    for (const memoryPath of paths) {
+      if (scope && memoryPath.type !== scope) {
+        continue;
+      }
+      const filePath = path3.join(memoryPath.path, memoryFile);
+      try {
+        const content = await fs.readFile(filePath, "utf-8");
+        if (content.trim()) {
+          results.push(`## [${memoryPath.type}] ${memoryFile}
+${content}`);
+        }
+      } catch {}
+    }
+    return results.join(`
+
+`);
+  }
+  clearCache() {
+    this.cache.clear();
+  }
+  getCache(key) {
+    if (!this.config.cacheEnabled)
+      return;
+    const entry = this.cache.get(key);
+    if (!entry)
+      return;
+    const age = Date.now() - entry.timestamp;
+    if (age > (this.config.cacheTTL ?? 300000)) {
+      this.cache.delete(key);
+      return;
+    }
+    return entry.data;
+  }
+  setCache(key, data) {
+    if (!this.config.cacheEnabled)
+      return;
+    this.cache.set(key, { data, timestamp: Date.now() });
+  }
+}
+export { DEFAULT_MEMORY_CONFIG, SOURCE_PRIORITY, getSourcePriority, MemoryComponent };