@ai-setting/roy-agent-core 1.7.52 → 1.7.53

package/dist/env/mcp/mcp-config-registration.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview MCP Component 配置注册
+ *
+ * 使用 ConfigComponent.registerComponent() 机制统一管理配置
+ */
+import type { ComponentRegistration } from "../../config/config-component";
+/**
+ * MCP Component 默认配置值
+ *
+ * 注意：这些默认值需要在 McpComponent.registerConfig() 中
+ * 通过 configComponent.set() 设置到 ConfigComponent
+ */
+export declare const MCP_DEFAULTS: Record<string, unknown>;
+/**
+ * MCP Component 配置注册常量
+ *
+ * 定义了所有 MCP 相关的配置项和来源
+ */
+export declare const MCP_CONFIG_REGISTRATION: ComponentRegistration;

package/dist/env/mcp/npm-prefix/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared npm prefix resolution for MCP and LSP tooling.
+ *
+ * Cursor remote environments often set npm prefix to a path without lib/.
+ */
+export declare function getFallbackNpmPrefixPath(): string;
+/** Prefix is usable when either lib/ or bin/ exists (some installs only have bin). */
+export declare function isUsableNpmPrefix(prefix: string): boolean;
+export declare function ensureNpmPrefixDirs(prefix: string): void;
+export declare function ensureFallbackNpmPrefix(): string;
+export declare function readNpmConfigPrefix(): string | undefined;
+/**
+ * Return a writable npm prefix, creating the roy-agent fallback when needed.
+ */
+export declare function resolveNpmPrefix(): string;
+export declare function resolveGlobalNodeModulesPath(): string;
+export declare function resolveGlobalBinPath(): string;

package/dist/env/mcp/scanner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview MCP 服务器路径扫描器
+ *
+ * 扫描 mcpPaths 目录，发现所有 MCP 服务器
+ * 每个子目录视为一个 MCP 服务器
+ */
+import type { McpPath } from "./config";
+import type { DiscoveredMcpServer } from "./types";
+/**
+ * MCP 服务器扫描器
+ *
+ * 扫描多个路径下的 MCP 服务器子目录
+ */
+export declare class McpScanner {
+    private mcpPaths;
+    private serversMap;
+    constructor(mcpPaths: McpPath[]);
+    /**
+     * 扫描所有 mcpPaths
+     */
+    scan(): Promise<Map<string, DiscoveredMcpServer>>;
+    /**
+     * 扫描单个路径
+     */
+    private scanPath;
+    /**
+     * 发现单个 MCP 服务器
+     */
+    private discoverServer;
+    /**
+     * 查找入口脚本
+     */
+    private findEntryScript;
+    /**
+     * 获取扫描结果
+     */
+    getServers(): Map<string, DiscoveredMcpServer>;
+}

package/dist/env/mcp/tool/adapter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview MCP Tool 适配器
+ *
+ * 将 MCP 工具转换为 Environment Tool
+ * 完整保留参数描述等信息，供 LLM 正确调用
+ */
+import { z } from "zod";
+import type { Tool as McpTool } from "@modelcontextprotocol/sdk/types.js";
+import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { ToolInfo } from "../../tool/types";
+/**
+ * 将 MCP 工具转换为 Environment Tool
+ *
+ * 命名策略: mcp_{serverName}_{toolName}
+ */
+export declare function adaptMcpTool(mcpTool: McpTool, mcpClient: Client, serverName: string): ToolInfo;
+/**
+ * 转换 MCP inputSchema 为 Zod schema
+ *
+ * 关键：保留参数描述，让 LLM 知道每个参数的用途
+ */
+export declare function convertInputSchemaToZod(inputSchema: McpTool["inputSchema"]): z.ZodType<unknown>;
+/**
+ * 创建 MCP 工具描述
+ */
+export declare function createMcpToolsDescription(tools: ToolInfo[]): string;
+/**
+ * 获取工具的完整参数描述（供 LLM 使用）
+ *
+ * 从 Zod schema 中提取参数描述
+ */
+export declare function getToolParamDescriptions(tool: ToolInfo): Record<string, string>;

package/dist/env/mcp/tool/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @fileoverview MCP Tool 适配器导出
+ */
+export { adaptMcpTool, convertInputSchemaToZod, createMcpToolsDescription } from "./adapter";

package/dist/env/mcp/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * @fileoverview MCP 类型定义
+ */
+import { z } from "zod";
+/**
+ * Local MCP Server 配置（stdio 传输）
+ */
+export declare const McpServerLocalConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"local">;
+    command: z.ZodArray<z.ZodString, "many">;
+    /** Working directory for the MCP server process */
+    cwd: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "local";
+    enabled: boolean;
+    command: string[];
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    environment?: Record<string, string> | undefined;
+}, {
+    type: "local";
+    command: string[];
+    enabled?: boolean | undefined;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    environment?: Record<string, string> | undefined;
+}>;
+export type McpServerLocalConfig = z.infer<typeof McpServerLocalConfigSchema>;
+/**
+ * Remote MCP Server 配置（HTTP 传输）
+ */
+export declare const McpServerRemoteConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"remote">;
+    url: z.ZodString;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "remote";
+    enabled: boolean;
+    url: string;
+    timeout?: number | undefined;
+    headers?: Record<string, string> | undefined;
+}, {
+    type: "remote";
+    url: string;
+    enabled?: boolean | undefined;
+    timeout?: number | undefined;
+    headers?: Record<string, string> | undefined;
+}>;
+export type McpServerRemoteConfig = z.infer<typeof McpServerRemoteConfigSchema>;
+/**
+ * MCP Server 配置（联合类型）
+ */
+export declare const McpServerConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"local">;
+    command: z.ZodArray<z.ZodString, "many">;
+    /** Working directory for the MCP server process */
+    cwd: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "local";
+    enabled: boolean;
+    command: string[];
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    environment?: Record<string, string> | undefined;
+}, {
+    type: "local";
+    command: string[];
+    enabled?: boolean | undefined;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    environment?: Record<string, string> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"remote">;
+    url: z.ZodString;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "remote";
+    enabled: boolean;
+    url: string;
+    timeout?: number | undefined;
+    headers?: Record<string, string> | undefined;
+}, {
+    type: "remote";
+    url: string;
+    enabled?: boolean | undefined;
+    timeout?: number | undefined;
+    headers?: Record<string, string> | undefined;
+}>]>;
+export type McpServerConfig = z.infer<typeof McpServerConfigSchema>;
+/**
+ * 扫描发现的 MCP 服务器信息
+ */
+export interface DiscoveredMcpServer {
+    /** 服务器名称（目录名） */
+    name: string;
+    /** MCP 服务器根目录 */
+    serverDir?: string;
+    /** 入口脚本路径 */
+    entryPath?: string;
+    /** 配置文件路径 */
+    configPath?: string;
+    /** package.json 路径 */
+    packagePath?: string;
+    /** 目录中的配置 */
+    directoryConfig?: Record<string, unknown>;
+    /** 解析后的默认命令（兼容不同路径） */
+    defaultCommand?: string[];
+}
+/**
+ * MCP 服务器状态
+ */
+export interface McpServerStatus {
+    /** 服务器名称 */
+    name: string;
+    /** 连接状态 */
+    status: "connecting" | "connected" | "disconnected" | "error";
+    /** 错误信息 */
+    error?: string;
+    /** 工具数量 */
+    toolsCount?: number;
+}

package/dist/env/memory/built-in/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Memory Built-in Tools Index
+ *
+ * 简化的记忆工具导出
+ *
+ * 只暴露两个工具：
+ * - record_memory: 统一的记忆写入工具
+ * - recall_memory: 统一的记忆读取工具
+ */
+import type { Tool } from "../../tool/types";
+import type { MemoryPath, RecordMemoryResult } from "../types";
+/**
+ * record_memory 工具操作接口
+ */
+export interface RecordMemoryOperations {
+    (args: {
+        scope: "project" | "global";
+        mode: "append" | "prepend" | "overwrite" | "delete";
+        content?: string;
+        title?: string;
+    }): Promise<RecordMemoryResult | null>;
+}
+/**
+ * recall_memory 工具操作接口
+ */
+export interface RecallMemoryOperations {
+    (scope?: "project" | "global"): Promise<string>;
+}
+/**
+ * MemoryToolConfig
+ */
+export interface MemoryToolConfig {
+    getMemoryPaths: () => MemoryPath[];
+    getMemoryFile: () => string;
+}
+/**
+ * 创建所有记忆工具
+ */
+export declare function createMemoryTools(recordMemory: RecordMemoryOperations, recallMemory: RecallMemoryOperations, config: MemoryToolConfig): Tool[];
+export { RecordMemorySchema, type RecordMemoryParams } from "./record-memory";
+export { RecallMemorySchema, type RecallMemoryParams } from "./recall-memory";

package/dist/env/memory/built-in/recall-memory.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview recall_memory Tool
+ *
+ * 统一的记忆读取工具
+ */
+import type { Tool } from "../../tool/types";
+import { z } from "zod";
+import type { MemoryPath } from "../types";
+/**
+ * recall_memory 工具参数
+ */
+export declare const RecallMemorySchema: z.ZodObject<{
+    /** 作用域 (可选，不传则读取所有 scope) */
+    scope: z.ZodOptional<z.ZodEnum<["project", "global"]>>;
+}, "strip", z.ZodTypeAny, {
+    scope?: "project" | "global" | undefined;
+}, {
+    scope?: "project" | "global" | undefined;
+}>;
+export type RecallMemoryParams = z.infer<typeof RecallMemorySchema>;
+export interface RecallMemoryOptions {
+    scope?: "project" | "global";
+}
+/**
+ * 创建 recall_memory 工具
+ */
+export declare function createRecallMemoryTool(recallMemory: (scope?: "project" | "global") => Promise<string>, getMemoryPaths: () => MemoryPath[], getMemoryFile: () => string): Tool;
+export { RecallMemorySchema as UnifiedRecallMemorySchema };
+export type { RecallMemoryParams as UnifiedRecallMemoryParams };

package/dist/env/memory/built-in/record-memory.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview record_memory Tool
+ *
+ * 统一的记忆记录工具
+ */
+import type { Tool } from "../../tool/types";
+import { z } from "zod";
+import type { MemoryPath, RecordMemoryResult } from "../types";
+/**
+ * record_memory 工具参数
+ */
+export declare const RecordMemorySchema: z.ZodObject<{
+    /** 作用域 (必填) */
+    scope: z.ZodEnum<["project", "global"]>;
+    /** 操作模式 */
+    mode: z.ZodEnum<["append", "prepend", "overwrite", "delete"]>;
+    /** 记忆内容 (delete 模式不需要) */
+    content: z.ZodOptional<z.ZodString>;
+    /** 章节标题 (可选，用于生成 ## title 章节) */
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: "project" | "global";
+    mode: "append" | "prepend" | "overwrite" | "delete";
+    title?: string | undefined;
+    content?: string | undefined;
+}, {
+    scope: "project" | "global";
+    mode: "append" | "prepend" | "overwrite" | "delete";
+    title?: string | undefined;
+    content?: string | undefined;
+}>;
+export type RecordMemoryParams = z.infer<typeof RecordMemorySchema>;
+export interface RecordMemoryOptions {
+    scope: "project" | "global";
+    mode: "append" | "prepend" | "overwrite" | "delete";
+    content?: string;
+    title?: string;
+}
+/**
+ * 创建 record_memory 工具
+ */
+export declare function createRecordMemoryTool(recordMemory: (args: RecordMemoryOptions) => Promise<RecordMemoryResult | null>, getMemoryPaths: () => MemoryPath[], getMemoryFile: () => string): Tool;
+export { RecordMemorySchema as UnifiedRecordMemorySchema };
+export type { RecordMemoryParams as UnifiedRecordMemoryParams };

package/dist/env/memory/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Memory Component Index
+ *
+ * 导出 Memory 组件及相关类型
+ */
+export * from "./types";
+export { DEFAULT_MEMORY_CONFIG, SOURCE_PRIORITY, getSourcePriority } from "./memory-config";
+export { MemoryComponent, type MemoryComponentOptions } from "./memory-component";
+export { RecordMemorySchema, RecallMemorySchema } from "./built-in";
+export * from "./plugin";

package/dist/env/memory/memory-component.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview MemoryComponent - Simplified
+ *
+ * 记忆管理核心组件
+ *
+ * 简化设计：
+ * - 移除 DraftManager、MemoryOrganizer、AccessLog 依赖
+ * - 只保留核心的 memory 文件操作
+ * - 提供 recallMemory(scope) 方法支持 project/global scope
+ */
+import { BaseComponent, type ComponentConfig } from "../component";
+import type { MemoryConfig, MemoryPath, RecordMemoryMode, RecordMemoryResult } from "./types";
+import type { ConfigComponent } from "../../config/config-component";
+/**
+ * MemoryComponent 配置选项（通过 options 传递）
+ */
+export interface MemoryComponentOptions {
+    /** ConfigComponent 实例（必填） */
+    configComponent: ConfigComponent;
+    /** 配置文件相对路径（可选，基于 XDG_DATA_HOME） */
+    configPath?: string;
+    /** 环境变量前缀（可选，默认 "MEMORY"） */
+    envPrefix?: string;
+    /** 直接传入的配置对象（可选，优先级最高） */
+    config?: Partial<MemoryConfig>;
+}
+/**
+ * MemoryComponent - Simplified
+ *
+ * 简化的记忆管理组件，只负责：
+ * - 管理本地文件系统记忆存储
+ * - 注册记忆操作工具
+ * - 提供目录扫描和缓存
+ *
+ * 复杂功能已移除：
+ * - DraftManager（草稿管理）
+ * - MemoryOrganizer（记忆整理）
+ * - AccessLog（访问日志）
+ */
+export declare class MemoryComponent extends BaseComponent {
+    name: string;
+    version: string;
+    private config;
+    private toolComponent?;
+    private configComponent?;
+    private cache;
+    /** 配置变更 watcher 清理函数 */
+    private configWatcher?;
+    init(config?: ComponentConfig): Promise<void>;
+    /**
+     * 注册配置到 ConfigComponent
+     */
+    private registerConfig;
+    /**
+     * 构建最终配置对象
+     */
+    private buildConfig;
+    /**
+     * 将配置对象展平为点号路径
+     */
+    private flattenConfig;
+    /**
+     * 注册配置热更新监听
+     */
+    private registerConfigWatcher;
+    /**
+     * 处理配置变更
+     */
+    protected onConfigChange(event: {
+        key: string;
+        oldValue?: unknown;
+        newValue?: unknown;
+    }): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private registerTools;
+    /**
+     * 获取所有配置的 memory 路径
+     */
+    getMemoryPaths(): MemoryPath[];
+    /**
+     * 更新 memory paths
+     */
+    updateMemoryPaths(paths: MemoryPath[]): void;
+    /**
+     * 获取记忆文件名
+     */
+    getMemoryFile(): string;
+    /**
+     * 记录记忆
+     *
+     * @param args.mode 操作模式
+     * @param args.content 记忆内容
+     * @param args.title 标题
+     * @param args.filename 文件名
+     * @param args.scope 作用域 (project/global)，用于选择正确的 memory path
+     */
+    recordMemory(args: {
+        mode: RecordMemoryMode;
+        content?: string;
+        title?: string;
+        filename?: string;
+        scope?: "project" | "global";
+    }): Promise<RecordMemoryResult | null>;
+    /**
+     * 回忆记忆 - 读取所有记忆文件内容
+     *
+     * @param scope 可选：project 或 global，默认读取所有
+     */
+    recallMemory(scope?: "project" | "global"): Promise<string>;
+    private clearCache;
+    private getCache;
+    private setCache;
+}

package/dist/env/memory/memory-config-registration.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Memory Component 配置注册
+ *
+ * 使用 ConfigComponent.registerComponent() 机制统一管理配置
+ */
+import type { ComponentRegistration } from "../../config/config-component";
+/**
+ * Memory Component 默认配置值
+ *
+ * 注意：键使用完整格式（带 "memory." 前缀），在 registerConfig 中手动设置
+ */
+export declare const MEMORY_DEFAULTS: Record<string, unknown>;
+/**
+ * Memory Component 配置注册常量
+ *
+ * 定义了所有 Memory 相关的配置项和来源
+ */
+export declare const MEMORY_CONFIG_REGISTRATION: ComponentRegistration;

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

@@ -0,0 +1,18 @@
+/**
+ * @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;

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

@@ -0,0 +1,16 @@
+/**
+ * @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";

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

@@ -0,0 +1,126 @@
+/**
+ * @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;