@ai-setting/roy-agent-cli 1.3.15 → 1.3.17

package/dist/core/src/env/memory/memory-config-registration.test.js

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Memory Component 配置注册测试
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+import { ConfigComponent } from "../../config/config-component.js";
+import { MEMORY_CONFIG_REGISTRATION, MEMORY_DEFAULTS } from "./memory-config-registration.js";
+describe("Memory Config Registration", () => {
+    let configComponent;
+    beforeEach(() => {
+        configComponent = new ConfigComponent();
+    });
+    describe("MEMORY_CONFIG_REGISTRATION", () => {
+        it("应该包含正确的 name", () => {
+            expect(MEMORY_CONFIG_REGISTRATION.name).toBe("memory");
+        });
+        it("应该包含 env source 配置", () => {
+            const envSource = MEMORY_CONFIG_REGISTRATION.sources.find((s) => s.type === "env");
+            expect(envSource).toBeDefined();
+            expect(envSource?.envPrefix).toBe("MEMORY");
+            expect(envSource?.priority).toBe(20);
+        });
+        it("应该包含所有配置 keys", () => {
+            const keys = MEMORY_CONFIG_REGISTRATION.keys;
+            expect(keys).toContainEqual(expect.objectContaining({ key: "memory.recursive" }));
+            expect(keys).toContainEqual(expect.objectContaining({ key: "memory.cacheEnabled" }));
+            expect(keys).toContainEqual(expect.objectContaining({ key: "memory.cacheTTL" }));
+            expect(keys).toContainEqual(expect.objectContaining({ key: "memory.memoryPaths" }));
+        });
+    });
+    describe("MEMORY_DEFAULTS", () => {
+        it("应该包含 recursive 默认值（完整格式）", () => {
+            expect(MEMORY_DEFAULTS["memory.recursive"]).toBe(true);
+        });
+        it("应该包含 cacheEnabled 默认值（完整格式）", () => {
+            expect(MEMORY_DEFAULTS["memory.cacheEnabled"]).toBe(true);
+        });
+        it("应该包含 cacheTTL 默认值（完整格式）", () => {
+            expect(MEMORY_DEFAULTS["memory.cacheTTL"]).toBe(300000);
+        });
+    });
+    describe("配置注册到 ConfigComponent", () => {
+        it("应该能够注册 MEMORY_CONFIG_REGISTRATION", () => {
+            configComponent.registerComponent(MEMORY_CONFIG_REGISTRATION);
+            expect(() => configComponent.registerComponent(MEMORY_CONFIG_REGISTRATION)).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=memory-config-registration.test.js.map

package/dist/core/src/env/memory/memory-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Memory Component Configuration
+ *
+ * 定义 Memory 组件的默认配置
+ */
+import { type MemoryConfig } from "./types";
+/**
+ * 默认配置
+ */
+export declare const DEFAULT_MEMORY_CONFIG: MemoryConfig;
+/**
+ * 优先级映射（后面的优先级更高）
+ */
+export declare const SOURCE_PRIORITY: Record<string, number>;
+/**
+ * 获取来源优先级
+ */
+export declare function getSourcePriority(source: string): number;
+//# sourceMappingURL=memory-config.d.ts.map

package/dist/core/src/env/memory/memory-config.js

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Memory Component Configuration
+ *
+ * 定义 Memory 组件的默认配置
+ */
+import path from "path";
+import os from "os";
+/**
+ * 默认配置
+ */
+export const DEFAULT_MEMORY_CONFIG = {
+    memoryPaths: [
+        // 全局路径 (~/.config/roy-agent/memory/)
+        {
+            type: "global",
+            path: path.join(os.homedir(), ".config", "roy-agent", "memory"),
+        },
+        // 项目路径 (.roy/memory/)
+        {
+            type: "project",
+            path: ".roy/memory",
+        },
+    ],
+    recursive: true,
+    cacheEnabled: true,
+    cacheTTL: 5 * 60 * 1000, // 5 分钟
+};
+/**
+ * 优先级映射（后面的优先级更高）
+ */
+export const SOURCE_PRIORITY = {
+    "global": 0,
+    "project": 1,
+};
+/**
+ * 获取来源优先级
+ */
+export function getSourcePriority(source) {
+    return SOURCE_PRIORITY[source] ?? 0;
+}
+//# sourceMappingURL=memory-config.js.map

package/dist/core/src/env/memory/memory-file.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Memory File Tests - TDD
+ *
+ * Tests for recordMemory and recallMemory functionality
+ */
+export {};
+//# sourceMappingURL=memory-file.test.d.ts.map

package/dist/core/src/env/memory/memory-file.test.js

@@ -0,0 +1,222 @@
+/**
+ * @fileoverview Memory File Tests - TDD
+ *
+ * Tests for recordMemory and recallMemory functionality
+ */
+import { describe, it, expect, beforeEach, afterEach } from "bun:test";
+import path from "path";
+import fs from "fs/promises";
+import os from "os";
+import { MemoryComponent } from "./memory-component.js";
+import { ConfigComponent } from "../../config/config-component.js";
+describe("MemoryFile - recordMemory & recallMemory", () => {
+    let memoryComponent;
+    let configComponent;
+    let testDir;
+    beforeEach(async () => {
+        testDir = path.join(os.tmpdir(), `memory-file-test-${Date.now()}`);
+        await fs.mkdir(testDir, { recursive: true });
+        configComponent = new ConfigComponent();
+        memoryComponent = new MemoryComponent();
+        await memoryComponent.init({
+            options: {
+                configComponent,
+                config: {
+                    memoryPaths: [{ type: "user", path: testDir }],
+                    recursive: true,
+                    cacheEnabled: false,
+                },
+            },
+        });
+    });
+    afterEach(async () => {
+        try {
+            await memoryComponent.stop();
+            await fs.rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // ignore
+        }
+    });
+    describe("recordMemory", () => {
+        it("should overwrite file with new content", async () => {
+            // 首次写入
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# First memory\n\nInitial content",
+                title: "First Memory",
+            });
+            // 覆盖写入
+            const result = await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# Second memory\n\nOverwritten content",
+                title: "Second Memory",
+            });
+            expect(result).not.toBeNull();
+            expect(result.action).toBe("overwrite");
+            // 验证文件内容
+            const fileContent = await fs.readFile(path.join(testDir, "memory.md"), "utf-8");
+            expect(fileContent).toContain("Second memory");
+            expect(fileContent).not.toContain("First memory");
+        });
+        it("should append content to end of file", async () => {
+            // 首次写入
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# Initial\n\nFirst paragraph",
+            });
+            // 追加内容
+            const result = await memoryComponent.recordMemory({
+                mode: "append",
+                content: "## Second paragraph\n\nAppended content",
+            });
+            expect(result).not.toBeNull();
+            expect(result.action).toBe("append");
+            // 验证文件内容
+            const fileContent = await fs.readFile(path.join(testDir, "memory.md"), "utf-8");
+            expect(fileContent).toContain("First paragraph");
+            expect(fileContent).toContain("Appended content");
+        });
+        it("should prepend content to beginning of file", async () => {
+            // 首次写入
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# Existing\n\nOriginal content",
+            });
+            // 头部插入
+            const result = await memoryComponent.recordMemory({
+                mode: "prepend",
+                content: "# New Header\n\nPrepended content\n\n---\n",
+            });
+            expect(result).not.toBeNull();
+            expect(result.action).toBe("prepend");
+            // 验证文件内容
+            const fileContent = await fs.readFile(path.join(testDir, "memory.md"), "utf-8");
+            expect(fileContent).toContain("Prepended content");
+            expect(fileContent).toContain("Original content");
+            // 头部插入的内容应该在前面
+            expect(fileContent.indexOf("Prepended content")).toBeLessThan(fileContent.indexOf("Original content"));
+        });
+        it("should delete memory file", async () => {
+            // 先创建文件
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# To be deleted",
+            });
+            // 删除文件
+            const result = await memoryComponent.recordMemory({
+                mode: "delete",
+            });
+            expect(result).not.toBeNull();
+            expect(result.action).toBe("delete");
+            // 验证文件不存在
+            const exists = await fs.access(path.join(testDir, "memory.md")).then(() => true).catch(() => false);
+            expect(exists).toBe(false);
+        });
+        it("should create file if not exists for non-delete modes", async () => {
+            const result = await memoryComponent.recordMemory({
+                mode: "append",
+                content: "# New file content",
+            });
+            expect(result).not.toBeNull();
+            expect(result.action).toBe("created");
+            // 验证文件存在
+            const fileContent = await fs.readFile(path.join(testDir, "memory.md"), "utf-8");
+            expect(fileContent).toContain("New file content");
+        });
+        it("should use custom filename when provided", async () => {
+            const result = await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# Custom file",
+                filename: "custom-memory.md",
+            });
+            expect(result.path).toContain("custom-memory.md");
+            // 验证自定义文件名
+            const fileContent = await fs.readFile(path.join(testDir, "custom-memory.md"), "utf-8");
+            expect(fileContent).toContain("Custom file");
+        });
+        it("should include title as section header when provided", async () => {
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "## Important Info\n\nSome content here",
+                title: "Important Info",
+            });
+            const fileContent = await fs.readFile(path.join(testDir, "memory.md"), "utf-8");
+            expect(fileContent).toContain("## Important Info");
+        });
+    });
+    describe("recallMemory", () => {
+        it("should return empty string when no memory files exist", async () => {
+            const result = await memoryComponent.recallMemory();
+            expect(result).toBe("");
+        });
+        it("should recall memory.md content", async () => {
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# Test Memory\n\nThis is test content",
+            });
+            const result = await memoryComponent.recallMemory();
+            expect(result).toContain("Test Memory");
+            expect(result).toContain("This is test content");
+        });
+        it("should format output with filename as header", async () => {
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# Memory Content",
+                filename: "memory.md",
+            });
+            const result = await memoryComponent.recallMemory();
+            expect(result).toContain("## [user] memory.md");
+            expect(result).toContain("Memory Content");
+        });
+        it("should include all memory files from all paths", async () => {
+            // 创建第二个 memory path
+            const testDir2 = path.join(os.tmpdir(), `memory-file-test2-${Date.now()}`);
+            await fs.mkdir(testDir2, { recursive: true });
+            // 先在 testDir 写入 memory.md
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# User Memory",
+            });
+            // 更新配置添加第二个路径，project 放前面作为主要路径
+            await memoryComponent.updateMemoryPaths([
+                { type: "project", path: testDir2 },
+                { type: "user", path: testDir },
+            ]);
+            // 在 project 路径写入 memory.md
+            await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# Project Memory",
+                filename: "memory.md",
+            });
+            const result = await memoryComponent.recallMemory();
+            // 清理第二个目录
+            await fs.rm(testDir2, { recursive: true, force: true });
+            // 从所有路径读取，所以两个文件都应该存在
+            expect(result).toContain("## [project] memory.md");
+            expect(result).toContain("## [user] memory.md");
+            expect(result).toContain("User Memory");
+            expect(result).toContain("Project Memory");
+        });
+        it("should skip non-existent memory files gracefully", async () => {
+            // 只配置一个路径
+            const result = await memoryComponent.recallMemory();
+            expect(result).toBe("");
+        });
+    });
+    describe("integration with ConfigComponent", () => {
+        it("should use memory.memoryFile config for filename", async () => {
+            // 设置自定义 memoryFile 配置
+            await configComponent.set("memory.memoryFile", "my-memory.md");
+            const result = await memoryComponent.recordMemory({
+                mode: "overwrite",
+                content: "# Custom Config Memory",
+            });
+            expect(result.path).toContain("my-memory.md");
+            // 验证读取也使用该配置
+            const fileContent = await fs.readFile(path.join(testDir, "my-memory.md"), "utf-8");
+            expect(fileContent).toContain("Custom Config Memory");
+        });
+    });
+});
+//# sourceMappingURL=memory-file.test.js.map

package/dist/core/src/env/memory/plugin/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Memory Plugin Index - Simplified
+ *
+ * 简化后的导出 - 只保留核心组件
+ *
+ * 移除的组件（已被简化设计替代）：
+ * - DraftManager -> 使用 write_memory tool
+ * - MemoryOrganizer -> 使用 recall --extract 命令
+ * - AccessLog -> 不再需要
+ */
+export type { MemoryPluginConfig, MemoryTask, MemoryTaskType, ExtractMemoryPayload, SessionMessage, MemoryHookContext, } from "./types";
+export { MemoryManager } from "./memory-manager";
+export { MemoryPlugin, createMemoryPlugin } from "./memory-plugin";
+export { recallMemory } from "./recall-memory";
+export type { MemoryScope, ProjectSummary, MemoryAgentInput, MemoryAgentResult, MemoryAgentConfig, } from "./memory-agent";
+export { createMemoryAgent, formatMemoryInput, parseMemoryAgentOutput, createEmptyResult, buildProjectInput, buildGlobalInput, applyMemoryResult, generateProjectSummary, PROJECT_MEMORY_AGENT_PROMPT, GLOBAL_MEMORY_AGENT_PROMPT, } from "./memory-agent";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/src/env/memory/plugin/index.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Memory Plugin Index - Simplified
+ *
+ * 简化后的导出 - 只保留核心组件
+ *
+ * 移除的组件（已被简化设计替代）：
+ * - DraftManager -> 使用 write_memory tool
+ * - MemoryOrganizer -> 使用 recall --extract 命令
+ * - AccessLog -> 不再需要
+ */
+// Core Components - 只保留核心组件
+export { MemoryManager } from "./memory-manager.js";
+export { MemoryPlugin, createMemoryPlugin } from "./memory-plugin.js";
+// Re-export for compatibility
+export { recallMemory } from "./recall-memory.js";
+export { createMemoryAgent, formatMemoryInput, parseMemoryAgentOutput, createEmptyResult, buildProjectInput, buildGlobalInput, applyMemoryResult, generateProjectSummary, PROJECT_MEMORY_AGENT_PROMPT, GLOBAL_MEMORY_AGENT_PROMPT, } from "./memory-agent.js";
+//# sourceMappingURL=index.js.map

package/dist/core/src/env/memory/plugin/memory-agent.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Memory Agent 核心逻辑 (Simplified)
+ *
+ * 简化设计：
+ * - 移除 DraftManager（草稿管理已废弃）
+ * - 移除 AccessLog（访问日志已废弃）
+ * - 只保留核心的 Agent 类型和格式化逻辑
+ */
+import type { ModelMessage } from "ai";
+/**
+ * Memory 作用域类型
+ */
+export type MemoryScope = "project" | "global";
+/**
+ * 项目摘要信息
+ */
+export interface ProjectSummary {
+    /** 项目根目录路径 */
+    projectPath: string;
+    /** 项目名称 */
+    projectName: string;
+    /** 最后更新时间戳 */
+    lastUpdated: number;
+    /** 项目 memory.md 摘要（一段话） */
+    summary: string;
+    /** 简短摘要（几个词） */
+    shortSummary: string;
+    /** 项目 memory.md 路径 */
+    memoryMdPath: string;
+}
+/**
+ * Memory Agent 输入
+ */
+export interface MemoryAgentInput {
+    /** 作用域 */
+    scope: MemoryScope;
+    /** 基础目录（project: .roy/memory, global: ~/.config/roy-agent/memory） */
+    baseDir: string;
+    /** 当前 memory.md 内容 */
+    currentMemoryMd: string;
+    /** 当前对话消息 */
+    messages: ModelMessage[];
+    /** 项目摘要列表（仅 global scope 使用） */
+    projectSummaries?: ProjectSummary[];
+}
+/**
+ * Memory Agent 输出结果
+ */
+export interface MemoryAgentResult {
+    /** 作用域 */
+    scope: MemoryScope;
+    /** 新的 memory.md 内容（全文） */
+    memoryMdContent: string;
+    /** 项目摘要（仅 project scope 输出） */
+    projectSummary?: ProjectSummary;
+    /** 是否有更新 */
+    hasUpdates: boolean;
+}
+/**
+ * Memory Agent 配置
+ */
+export interface MemoryAgentConfig {
+    /** Agent 名称 */
+    name: string;
+    /** System prompt */
+    systemPrompt: string;
+    /** 最大迭代次数 */
+    maxIterations: number;
+}
+/**
+ * Project Memory Agent System Prompt
+ */
+export declare const PROJECT_MEMORY_AGENT_PROMPT = "\u4F60\u662F\u9879\u76EE\u7EA7 Memory Agent\uFF0C\u8D1F\u8D23\u6574\u7406\u548C\u66F4\u65B0\u5F53\u524D\u9879\u76EE\u7684\u8BB0\u5FC6\u3002\n\n## \u4F60\u7684\u804C\u8D23\n\n1. **\u4FE1\u606F\u6536\u96C6**\uFF1A\u5728\u63D0\u53D6\u8BB0\u5FC6\u524D\uFF0C\u5148\u6536\u96C6\u9879\u76EE\u4E0A\u4E0B\u6587\u4FE1\u606F\n2. **\u4ECE\u5BF9\u8BDD\u4E2D\u63D0\u53D6\u8BB0\u5FC6**\uFF1A\u5206\u6790 messages\uFF0C\u63D0\u53D6\u4E0E\u9879\u76EE\u76F8\u5173\u7684\u77E5\u8BC6\u3001\u51B3\u7B56\u3001\u89E3\u51B3\u65B9\u6848\n3. **\u751F\u6210 memory.md**\uFF1A\u66F4\u65B0\u9879\u76EE\u8BB0\u5FC6\u7D22\u5F15\n\n## \u4FE1\u606F\u6536\u96C6\u6B65\u9AA4\uFF08\u91CD\u8981\uFF01\uFF09\n\n\u5728\u63D0\u53D6\u8BB0\u5FC6\u4E4B\u524D\uFF0C\u8BF7\u5148\u4F7F\u7528\u53EF\u7528\u5DE5\u5177\u6536\u96C6\u9879\u76EE\u4E0A\u4E0B\u6587\uFF1A\n\n1. **\u9605\u8BFB\u9879\u76EE README**\uFF1A\u4E86\u89E3\u9879\u76EE\u6982\u8FF0\u3001\u529F\u80FD\u3001\u4F7F\u7528\u65B9\u6CD5\n   - \u8DEF\u5F84\u793A\u4F8B\uFF1AREADME.md, README.zh-CN.md, docs/README.md\n\n2. **\u68C0\u67E5\u8BBE\u8BA1\u6587\u6863**\uFF1A\u4E86\u89E3\u9879\u76EE\u67B6\u6784\u548C\u8BBE\u8BA1\u51B3\u7B56\n   - \u8DEF\u5F84\u793A\u4F8B\uFF1Adocs/design.md, docs/ARCHITECTURE.md, docs/superpowers/specs/*.md\n\n3. **\u67E5\u770B\u4EE3\u7801\u5B9E\u73B0**\uFF1A\u4E86\u89E3\u5173\u952E\u6A21\u5757\u548C\u5B9E\u73B0\u7EC6\u8282\n   - \u8DEF\u5F84\u793A\u4F8B\uFF1Asrc/**/*.ts, packages/*/src/**/*.ts\n\n4. **\u56DE\u987E\u73B0\u6709 memory**\uFF1A\u4E86\u89E3\u5DF2\u6709\u7684\u9879\u76EE\u8BB0\u5FC6\n   - \u8DEF\u5F84\uFF1A\u5F53\u524D\u76EE\u5F55\u4E0B\u7684 .roy/memory/memory.md\n\n## \u8F93\u5165\u4FE1\u606F\n\n- \u5F53\u524D\u9879\u76EE\u7684 memory.md \u5185\u5BB9\n- \u5F53\u524D\u5BF9\u8BDD\u6D88\u606F\n\n## \u8F93\u51FA\u8981\u6C42\n\n\u8BF7\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA\u7ED3\u679C\uFF0C\u5305\u542B\u4EE5\u4E0B\u5B57\u6BB5\uFF1A\n- memoryMdContent: \u65B0\u7684 memory.md \u5185\u5BB9\n- projectSummary: \u9879\u76EE\u6458\u8981\uFF08\u5305\u542B summary, shortSummary \u7B49\uFF09\n- hasUpdates: \u662F\u5426\u6709\u66F4\u65B0\n\n## \u8BB0\u5FC6\u7EC4\u7EC7\u539F\u5219\n\n- \u4F18\u5148\u8BB0\u5F55\u5177\u4F53\u3001\u53EF\u64CD\u4F5C\u7684\u8BB0\u5FC6\uFF08\u4EE3\u7801\u4F4D\u7F6E\u3001\u914D\u7F6E\u9879\u3001\u547D\u4EE4\uFF09\n- \u907F\u514D\u8FC7\u4E8E\u62BD\u8C61\u6216\u901A\u7528\u7684\u63CF\u8FF0\n- \u8BB0\u5F55\u8BBE\u8BA1\u51B3\u7B56\u53CA\u5176\u7406\u7531";
+/**
+ * Global Memory Agent System Prompt
+ */
+export declare const GLOBAL_MEMORY_AGENT_PROMPT = "\u4F60\u662F\u5168\u5C40 Memory Agent\uFF0C\u8D1F\u8D23\u6574\u7406\u8DE8\u9879\u76EE\u7684\u901A\u7528\u8BB0\u5FC6\u3002\n\n## \u4F60\u7684\u804C\u8D23\n\n1. **\u805A\u5408\u9879\u76EE\u6458\u8981**\uFF1A\u5206\u6790 projectSummaries\uFF0C\u63D0\u53D6\u5171\u6027\u77E5\u8BC6\n2. **\u7EF4\u62A4\u5168\u5C40\u8BB0\u5FC6**\uFF1A\u66F4\u65B0\u5168\u5C40 memory.md\n3. **\u7EF4\u62A4\u9879\u76EE\u7D22\u5F15**\uFF1A\u5728 memory.md \u4E2D\u7EF4\u62A4\u9879\u76EE\u5217\u8868\n4. **\u63D0\u53D6\u5171\u6027\u7ECF\u9A8C**\uFF1A\u5C06\u9879\u76EE\u7ECF\u9A8C\u63D0\u70BC\u4E3A\u901A\u7528\u6700\u4F73\u5B9E\u8DF5\n\n## \u8F93\u5165\u4FE1\u606F\n\n- \u5168\u5C40 memory.md \u5185\u5BB9\n- \u5F53\u524D\u5BF9\u8BDD\u6D88\u606F\n- \u9879\u76EE\u6458\u8981\u5217\u8868\uFF08projectSummaries\uFF09\n\n## \u8F93\u51FA\u8981\u6C42\n\n\u8BF7\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA\u7ED3\u679C\uFF0C\u5305\u542B\u4EE5\u4E0B\u5B57\u6BB5\uFF1A\n- memoryMdContent: \u65B0\u7684 memory.md \u5185\u5BB9\n- hasUpdates: \u662F\u5426\u6709\u66F4\u65B0\n\n## \u8BB0\u5FC6\u7EC4\u7EC7\u539F\u5219\n\n- \u5173\u6CE8\u8DE8\u9879\u76EE\u5171\u6027\uFF08\u5DE5\u4F5C\u6D41\u3001\u89C4\u8303\u3001\u504F\u597D\uFF09\n- \u9879\u76EE\u7D22\u5F15\u53EA\u8BB0\u5F55\u6458\u8981\u548C\u8DEF\u5F84\uFF0C\u4E0D\u590D\u5236\u5185\u5BB9\n- \u7528\u6237\u4E2A\u4EBA\u504F\u597D\uFF08\u996E\u98DF\u3001\u5DE5\u4F5C\u4E60\u60EF\uFF09\u4F18\u5148\u8BB0\u5F55";
+/**
+ * 创建 Memory Agent 配置
+ */
+export declare function createMemoryAgent(scope: MemoryScope): MemoryAgentConfig;
+/**
+ * 格式化 Memory Agent 输入为字符串
+ */
+export declare function formatMemoryInput(input: MemoryAgentInput): string;
+/**
+ * 解析 Memory Agent 输出
+ */
+export declare function parseMemoryAgentOutput(output: string, scope: MemoryScope): MemoryAgentResult;
+/**
+ * 创建默认的 MemoryAgentResult
+ */
+export declare function createEmptyResult(scope: MemoryScope): MemoryAgentResult;
+/**
+ * 构建 Project Memory Agent 输入
+ */
+export declare function buildProjectInput(params: {
+    projectPath: string;
+    currentMemoryMd: string;
+    messages: ModelMessage[];
+}): Promise<MemoryAgentInput>;
+/**
+ * 构建 Global Memory Agent 输入
+ */
+export declare function buildGlobalInput(params: {
+    baseDir: string;
+    currentMemoryMd: string;
+    messages: ModelMessage[];
+    projectSummaries?: ProjectSummary[];
+}): MemoryAgentInput;
+/**
+ * 应用 Memory Agent 结果到文件系统
+ *
+ * @param result MemoryAgent 结果
+ * @param baseDir 基础目录
+ */
+export declare function applyMemoryResult(result: MemoryAgentResult, baseDir: string): Promise<void>;
+/**
+ * 生成项目摘要
+ */
+export declare function generateProjectSummary(params: {
+    projectPath: string;
+    projectName: string;
+    memoryMdContent: string;
+    memoryMdPath: string;
+}): ProjectSummary;
+//# sourceMappingURL=memory-agent.d.ts.map