@ai-setting/roy-agent-core 1.0.0

package/src/env/memory/plugin/memory-plugin.ts

@@ -0,0 +1,210 @@
+/**
+ * @fileoverview MemoryPlugin - Simplified
+ * 
+ * Hook handler for agent:after.react
+ * 
+ * 简化设计（移除旧的复杂机制）：
+ * - 移除了 DraftManager（草稿管理已废弃）
+ * - 移除了 MemoryOrganizer（整理机制已废弃）
+ * - 移除了 AccessLog（访问日志已废弃）
+ * 
+ * 新的记忆管理方式：
+ * - 使用 `roy memory recall --extract` 命令手动触发
+ * - 使用 Memory Agent 自动分析会话历史
+ * - 直接更新 memory.md 文件
+ */
+
+import type { HookContext } from "../../agent/types";
+import type { AgentComponent } from "../../agent/agent-component";
+import type { SessionMessage } from "../../session/session-component";
+import type { SessionComponent } from "../../session/session-component";
+import type { MemoryPluginConfig } from "./types";
+import { DEFAULT_MEMORY_PLUGIN_CONFIG } from "./types";
+
+// Define interface types for plugin compatibility
+type IAgentComponent = AgentComponent;
+type ISessionComponent = SessionComponent;
+import { createLogger } from "../../log-trace/logger";
+import path from "path";
+import os from "os";
+import fs from "fs/promises";
+import type { ModelMessage } from "ai";
+
+// Memory Agent imports
+import type {
+  MemoryAgentInput,
+  MemoryAgentResult,
+  ProjectSummary,
+} from "./memory-agent";
+import {
+  buildProjectInput,
+  buildGlobalInput,
+  applyMemoryResult,
+  generateProjectSummary,
+  formatMemoryInput,
+  parseMemoryAgentOutput,
+  PROJECT_MEMORY_AGENT_PROMPT,
+  GLOBAL_MEMORY_AGENT_PROMPT,
+  createMemoryAgent,
+} from "./memory-agent";
+
+
+const logger = createLogger("MemoryPlugin");
+
+/**
+ * MemoryPlugin - Simplified
+ * 
+ * 简化的记忆插件，不再自动处理。
+ * 
+ * 用户应该使用 `roy memory recall --extract` 命令来手动触发记忆提取。
+ * 
+ * 保留此插件是为了：
+ * 1. 保持 API 兼容性
+ * 2. 未来可以扩展为可选的自动触发
+ */
+export class MemoryPlugin {
+  private config: MemoryPluginConfig;
+  private disposed: boolean = false;
+  private initialized: boolean = false;
+
+  /** 项目 memory 基础目录 */
+  private projectBaseDir: string = "";
+
+  /** 全局 memory 基础目录 */
+  private globalBaseDir: string = "";
+
+  /** 当前工作目录（用于推断项目路径） */
+  private workDir: string = "";
+
+  /** AgentComponent 引用（延迟获取） */
+  private agentComponent: IAgentComponent | null = null;
+
+  constructor(baseDir: string, config: MemoryPluginConfig = {}) {
+    this.config = { ...DEFAULT_MEMORY_PLUGIN_CONFIG, ...config };
+    this.workDir = baseDir;
+    this.projectBaseDir = path.join(baseDir, ".roy", "memory");
+    this.globalBaseDir = path.join(os.homedir(), ".config", "roy-agent", "memory");
+    logger.info("MemoryPlugin (simplified) created", { baseDir, config: this.config });
+  }
+
+  /**
+   * Plugin 名称
+   */
+  get name(): string {
+    return "MemoryPlugin";
+  }
+
+  /**
+   * 订阅的 Hook 点
+   */
+  get hookPoint(): "agent:after.react" {
+    return "agent:after.react";
+  }
+
+  /**
+   * 优先级
+   */
+  get priority(): number {
+    return 50;
+  }
+
+  /**
+   * 描述
+   */
+  get description(): string {
+    return "Memory management plugin. Use 'roy memory recall --extract' to extract memories.";
+  }
+
+  /**
+   * 获取 Hook 定义
+   */
+  get hooks() {
+    return [
+      {
+        point: this.hookPoint as "agent:after.react",
+        priority: this.priority,
+      },
+    ];
+  }
+
+  /**
+   * 初始化
+   */
+  async initialize(): Promise<void> {
+    if (this.initialized) {
+      return;
+    }
+    this.initialized = true;
+    logger.info("MemoryPlugin (simplified) initialized");
+  }
+
+  /**
+   * 执行 Hook
+   * 
+   * 简化为空操作。用户应该使用 `roy memory recall --extract` 命令。
+   */
+  async execute(ctx: HookContext): Promise<void> {
+    if (this.disposed || !this.config.enabled || !this.initialized) {
+      return;
+    }
+
+    // 不再自动处理。用户应该使用 `roy memory recall --extract`
+    logger.debug("MemoryPlugin hook executed. Use 'roy memory recall --extract' for memory extraction.");
+  }
+
+  /**
+   * 准备关闭
+   */
+  prepareShutdown(): void {
+    // 无需处理
+  }
+
+  /**
+   * 检查是否有待处理任务
+   */
+  hasPendingTasks(): boolean {
+    return false;
+  }
+
+  /**
+   * 等待处理完成
+   */
+  async waitForCompletion(): Promise<void> {
+    // 无需等待
+  }
+
+  /**
+   * 释放资源
+   */
+  async dispose(): Promise<void> {
+    if (this.disposed) {
+      return;
+    }
+    this.disposed = true;
+    logger.info("MemoryPlugin (simplified) disposed");
+  }
+
+  /**
+   * 获取项目 base dir
+   */
+  getProjectBaseDir(): string {
+    return this.projectBaseDir;
+  }
+
+  /**
+   * 获取全局 base dir
+   */
+  getGlobalBaseDir(): string {
+    return this.globalBaseDir;
+  }
+}
+
+/**
+ * 创建 MemoryPlugin 实例
+ */
+export function createMemoryPlugin(
+  baseDir: string,
+  config?: MemoryPluginConfig
+): MemoryPlugin {
+  return new MemoryPlugin(baseDir, config);
+}

package/src/env/memory/plugin/plugin-simplified.test.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Memory Plugin Simplified Tests (TDD)
+ * 
+ * 测试目标：验证简化后的 Memory Plugin 设计
+ * 
+ * 设计原则：
+ * - 移除 DraftManager（草稿管理已废弃）
+ * - 移除 MemoryOrganizer（整理机制已废弃）
+ * - 移除 AccessLog（访问日志已废弃）
+ * - 保留 MemoryManager（核心组件）
+ */
+
+import { describe, expect, test } from "bun:test";
+import * as pluginModule from "./index";
+
+describe("Memory Plugin - Simplified Design", () => {
+  describe("should NOT export deprecated components", () => {
+    test("DraftManager should be removed/not exported", () => {
+      // DraftManager 已被移除，不应该导出
+      expect(pluginModule).not.toHaveProperty("DraftManager");
+    });
+
+    test("MemoryOrganizer should be removed/not exported", () => {
+      expect(pluginModule).not.toHaveProperty("MemoryOrganizer");
+    });
+
+    test("AccessLog should be removed/not exported", () => {
+      expect(pluginModule).not.toHaveProperty("AccessLog");
+    });
+  });
+
+  describe("should keep core functionality", () => {
+    test("MemoryManager should still exist as core component", () => {
+      // MemoryManager 保留，作为核心组件
+      expect(pluginModule.MemoryManager).toBeDefined();
+    });
+
+    test("MemoryPlugin should still exist for backwards compatibility", () => {
+      // MemoryPlugin 保留，但简化内部实现
+      expect(pluginModule.MemoryPlugin).toBeDefined();
+    });
+
+    test("createMemoryPlugin should still exist", () => {
+      expect(pluginModule.createMemoryPlugin).toBeDefined();
+    });
+
+    test("recallMemory should still exist", () => {
+      expect(pluginModule.recallMemory).toBeDefined();
+    });
+  });
+});

package/src/env/memory/plugin/recall-memory.test.ts

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview Recall Memory Tests - Simplified
+ * 
+ * 测试简化后的 recall_memory 工具
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "bun:test";
+import fs from "fs/promises";
+import path from "path";
+import os from "os";
+import { recallMemory, type MemoryPath } from "./recall-memory";
+
+describe("RecallMemory - Simplified", () => {
+  let tmpDir: string;
+  let globalDir: string;
+  let projectDir: string;
+
+  const globalMemoryPath: MemoryPath = {
+    type: "global",
+    path: "",
+  };
+
+  const projectMemoryPath: MemoryPath = {
+    type: "project",
+    path: "",
+  };
+
+  beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "recall-memory-test-"));
+
+    // Create global memory directory
+    globalDir = path.join(tmpDir, "global-memory");
+    await fs.mkdir(globalDir, { recursive: true });
+    globalMemoryPath.path = globalDir;
+
+    // Create project memory directory
+    projectDir = path.join(tmpDir, "project-memory");
+    await fs.mkdir(projectDir, { recursive: true });
+    projectMemoryPath.path = projectDir;
+  });
+
+  afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+  });
+
+  describe("basic recall", () => {
+    it("should return empty when no memory files exist", async () => {
+      const result = await recallMemory([globalMemoryPath]);
+      expect(result).toBe("(No memory files found)");
+    });
+
+    it("should return memory.md content", async () => {
+      await fs.writeFile(path.join(globalDir, "memory.md"), "# Global Memory\n\nTest content.", "utf-8");
+
+      const result = await recallMemory([globalMemoryPath]);
+      expect(result).toContain("# Global Memory");
+      expect(result).toContain("Test content.");
+    });
+
+    it("should include scope prefix in output", async () => {
+      await fs.writeFile(path.join(globalDir, "memory.md"), "# Global Memory", "utf-8");
+
+      const result = await recallMemory([globalMemoryPath]);
+      expect(result).toContain("[global]");
+    });
+  });
+
+  describe("multiple memory paths", () => {
+    it("should recall from multiple scopes", async () => {
+      await fs.writeFile(path.join(globalDir, "memory.md"), "# Global", "utf-8");
+      await fs.writeFile(path.join(projectDir, "memory.md"), "# Project", "utf-8");
+
+      const result = await recallMemory([globalMemoryPath, projectMemoryPath]);
+
+      expect(result).toContain("[global]");
+      expect(result).toContain("# Global");
+      expect(result).toContain("[project]");
+      expect(result).toContain("# Project");
+    });
+  });
+
+  describe("error handling", () => {
+    it("should continue when one scope fails", async () => {
+      // Valid global scope
+      await fs.writeFile(path.join(globalDir, "memory.md"), "# Global", "utf-8");
+
+      // Invalid project path
+      const invalidPath: MemoryPath = { type: "project", path: "/nonexistent/path" };
+
+      // Should not throw, should still return global content
+      const result = await recallMemory([globalMemoryPath, invalidPath]);
+      expect(result).toContain("# Global");
+    });
+  });
+
+  describe("output format", () => {
+    it("should separate scopes with double newlines", async () => {
+      await fs.writeFile(path.join(globalDir, "memory.md"), "Global content", "utf-8");
+      await fs.writeFile(path.join(projectDir, "memory.md"), "Project content", "utf-8");
+
+      const result = await recallMemory([globalMemoryPath, projectMemoryPath]);
+      // Should have sections separated
+      expect(result.split("\n\n").length).toBeGreaterThanOrEqual(2);
+    });
+  });
+});

package/src/env/memory/plugin/recall-memory.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Recall Memory - Simplified
+ * 
+ * 简化设计：
+ * - 移除 AccessLog（访问日志已废弃）
+ * - 只读取 memory.md 文件
+ */
+
+import fs from "fs/promises";
+import path from "path";
+import type { MemoryPath } from "../types";
+
+/**
+ * 读取记忆文件
+ * 
+ * @param memoryPaths - 记忆路径列表
+ * @returns 记忆内容
+ */
+export async function recallMemory(
+  memoryPaths: MemoryPath[]
+): Promise<string> {
+  const results: string[] = [];
+
+  for (const memoryPath of memoryPaths) {
+    const scope = memoryPath.type; // "global" | "project"
+    const baseDir = memoryPath.path;
+
+    try {
+      // 读取 memory.md
+      const memoryFile = path.join(baseDir, "memory.md");
+      try {
+        const content = await fs.readFile(memoryFile, "utf-8");
+        if (content.trim()) {
+          results.push(`## [${scope}] memory.md\n${content}`);
+        }
+      } catch {
+        // 文件不存在，跳过
+      }
+    } catch (error) {
+      // 整个 scope 处理失败，跳过
+      console.error(`Error processing memory path ${baseDir}:`, error);
+    }
+  }
+
+  if (results.length === 0) {
+    return "(No memory files found)";
+  }
+
+  return results.join("\n\n");
+}
+
+// Re-export types for convenience
+export type { MemoryPath } from "../types";

package/src/env/memory/plugin/types.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview Memory Plugin Types (Simplified)
+ *
+ * MemoryPlugin 相关类型定义
+ *
+ * 简化设计：
+ * - 移除 Draft 相关的类型
+ * - 移除 AccessLog 相关的类型
+ */
+
+import type { HookContext } from "../../hook/types";
+import type { ModelMessage } from "ai";
+
+// ============================================================================
+// Config
+// ============================================================================
+
+/**
+ * MemoryPlugin configuration
+ */
+export interface MemoryPluginConfig {
+  /** Enable memory plugin */
+  enabled?: boolean;
+}
+
+/**
+ * Default MemoryPlugin configuration
+ */
+export const DEFAULT_MEMORY_PLUGIN_CONFIG: MemoryPluginConfig = {
+  enabled: true,
+};
+
+// ============================================================================
+// Tasks
+// ============================================================================
+
+/**
+ * Memory task types
+ */
+export type MemoryTaskType =
+  | "extract_memory";   // Extract from messages
+
+/**
+ * Memory task
+ */
+export interface MemoryTask {
+  id: string;
+  type: MemoryTaskType;
+  payload: unknown;
+  timestamp: number;
+  priority: number;
+}
+
+/**
+ * Extract memory payload
+ */
+export interface ExtractMemoryPayload {
+  messages: ModelMessage[];
+  sessionId?: string;
+  /** Hook context for Memory Agent */
+  ctx?: MemoryHookContext;
+}
+
+// ============================================================================
+// SessionMessage Interface
+// ============================================================================
+
+/**
+ * SessionMessage 接口
+ */
+export interface SessionMessage {
+  /** 消息角色 */
+  role: "user" | "assistant" | "system" | "tool";
+  /** 消息内容 */
+  content: string | Array<{ type: string; [key: string]: unknown }>;
+  /** 工具调用 ID（仅 tool 角色） */
+  toolCallId?: string;
+  /** 工具名称（仅 tool 角色） */
+  toolName?: string;
+  /** 时间戳 */
+  timestamp?: number;
+}
+
+// ============================================================================
+// Hook
+// ============================================================================
+
+/**
+ * Hook context data for agent:after.react
+ */
+export interface MemoryHookContext {
+  /** Current messages for memory extraction */
+  messages: ModelMessage[];
+  /** Current session ID */
+  sessionId?: string;
+  /** Project summaries (populated by project agent) */
+  projectSummaries?: unknown[];
+}
+
+// Re-export for convenience
+export type { HookContext };