@ai-setting/roy-agent-core 1.5.14-test → 1.5.15-test

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

@@ -1,1799 +0,0 @@
-/**
-* @fileoverview Hook 系统统一类型定义
-* 
-* 提供所有 Component 使用的统一 Hook 接口
-*/
-/**
-* Hook 执行阶段
-*/
-type HookPhase = "before" | "after" | "error";
-/**
-* Hook 元信息
-*/
-interface HookMeta {
-	/** Hook 唯一名称 */
-	name: string;
-	/** 执行优先级，默认 0，数值越小越先执行 */
-	priority?: number;
-	/** 描述 */
-	description?: string;
-}
-/**
-* 统一 Hook 上下文
-* 
-* 泛型参数 T 表示该 Component 的上下文数据类型
-*/
-interface HookContext<T = unknown> {
-	/** 当前组件信息 */
-	component: {
-		/** 组件名称 */
-		name: string;
-		/** 组件版本 */
-		version: string;
-	};
-	/** 上下文数据（Component 特定） */
-	data: T;
-	/** 元数据（可用于传递额外信息） */
-	metadata: Record<string, unknown>;
-	/** 执行阶段 */
-	phase: HookPhase;
-	/** 关联的 hook 点名称 */
-	hookPoint: string;
-}
-/**
-* 统一 Hook 接口
-* 
-* 所有 Component 的 Hook 都应实现此接口
-*/
-interface Hook<T = unknown> extends HookMeta {
-	/** 执行 Hook
-	* @param ctx 上下文
-	*/
-	execute(ctx: HookContext<T>): void | Promise<void>;
-}
-/**
-* Hook 函数类型（便捷别名）
-*/
-type HookFn<T = unknown> = (ctx: HookContext<T>) => void | Promise<void>;
-/**
-* Hook 干预动作类型
-*/
-type HookActionType = "stop" | "retry" | "compress" | "extract_memory" | "inject_message" | "skip_tool" | "custom";
-/**
-* Hook 干预动作
-*/
-interface HookAction {
-	/** 动作类型 */
-	type: HookActionType;
-	/** 动作参数 */
-	params?: Record<string, unknown>;
-	/** 动作描述 */
-	description?: string;
-}
-/**
-* Hook 执行结果
-*/
-interface HookResult {
-	/** 是否被停止 */
-	stopped?: boolean;
-	/** 干预动作（如果有） */
-	action?: HookAction;
-	/** 执行结果数据 */
-	results?: unknown[];
-}
-/**
-* HookManager 配置
-*/
-interface HookManagerOptions {
-	/** 组件名称（用于上下文） */
-	componentName?: string;
-	/** 组件版本（用于上下文） */
-	componentVersion?: string;
-	/** 默认优先级 */
-	defaultPriority?: number;
-}
-/**
-* HookManager
-* 
-* 统一管理 Component 的 Hook
-* 
-* @example
-* ```typescript
-* const manager = new HookManager<MyContext>();
-* 
-* // 注册 Hook
-* manager.register("before-action", {
-*   name: "my-hook",
-*   priority: 10,
-*   execute: async (ctx) => { /* ... *\/ }
-* });
-* 
-* // 执行 Hooks
-* await manager.execute("before-action", data);
-* ```
-*/
-declare class HookManager<T = unknown> {
-	private _hooks;
-	private componentName;
-	private componentVersion;
-	private defaultPriority;
-	constructor(options?: HookManagerOptions);
-	/**
-	* 注册 Hook 到指定 hook 点
-	*/
-	register(hookPoint: string, hook: Hook<T>): void;
-	/**
-	* 注册多个 Hook
-	*/
-	registerMany(hookPoint: string, hooks: Hook<T>[]): void;
-	/**
-	* 按名称取消注册 Hook
-	* @returns 是否成功取消注册
-	*/
-	unregister(hookPoint: string, name: string): boolean;
-	/**
-	* 取消注册所有指定 hook 点的 Hook
-	*/
-	unregisterAll(hookPoint: string): void;
-	/**
-	* 执行指定 hook 点的所有 Hook
-	*/
-	execute(hookPoint: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
-	/**
-	* 执行指定 hook 点的所有 Hook 并收集返回值
-	*/
-	executeAndCollect<R>(hookPoint: string, data: T, metadata?: Record<string, unknown>): Promise<R[]>;
-	/**
-	* 获取指定 hook 点的 Hook 数量
-	*/
-	count(hookPoint: string): number;
-	/**
-	* 清空所有 Hook
-	*/
-	clear(): void;
-	/**
-	* 获取所有已注册的 hook 点
-	*/
-	getHookPoints(): string[];
-	/**
-	* 检查 hook 点是否有任何 Hook
-	*/
-	hasHooks(hookPoint: string): boolean;
-	/**
-	* 设置组件信息
-	*/
-	setComponentInfo(name: string, version: string): void;
-	/**
-	* 获取所有注册的 hooks（只读副本）
-	*/
-	get hooks(): ReadonlyMap<string, Hook<T>[]>;
-	/**
-	* 执行 Hook 并支持干预机制
-	* 
-	* 如果任何一个 Hook 返回 { stop: true }，执行会停止
-	* Hook 可以通过返回 HookResult 来执行干预动作
-	* 
-	* @param hookPoint Hook 点
-	* @param data 数据
-	* @param metadata 元数据
-	* @returns 执行结果
-	*/
-	executeWithIntervention(hookPoint: string, data: T, metadata?: Record<string, unknown>): Promise<HookResult>;
-	/**
-	* 获取或创建 hook 列表
-	*/
-	private getOrCreateHooks;
-	/**
-	* 按优先级排序 Hook
-	* 
-	* 优先级相同时保持原顺序（稳定排序）
-	*/
-	private sortHooks;
-	/**
-	* 创建 Hook 上下文
-	*/
-	private createContext;
-	/**
-	* 安全执行 Hook（错误隔离）
-	*/
-	private safeExecute;
-	/**
-	* 安全执行 Hook 并返回结果
-	*/
-	private safeExecuteAndReturn;
-}
-import { z, ZodType, ZodError } from "zod";
-/**
-* 沙箱配置
-*/
-interface SandboxConfig {
-	/** 是否启用沙箱 */
-	enabled: boolean;
-	/** 沙箱类型 */
-	type: "native" | "docker";
-	/** 动作过滤 */
-	actionFilter?: {
-		/** 包含的动作 */
-		include?: string[];
-		/** 排除的动作 */
-		exclude?: string[];
-	};
-	/** 文件系统限制 */
-	filesystem?: {
-		/** 允许读取 */
-		allowRead?: string[];
-		/** 禁止读取 */
-		denyRead?: string[];
-		/** 允许写入 */
-		allowWrite?: string[];
-		/** 禁止写入 */
-		denyWrite?: string[];
-	};
-	/** 网络限制 */
-	network?: {
-		/** 允许的域名 */
-		allowedDomains?: string[];
-		/** 禁止的域名 */
-		deniedDomains?: string[];
-	};
-	/** Docker 配置 */
-	docker?: {
-		/** 镜像 */
-		image?: string;
-		/** 网络模式 */
-		networkMode?: "bridge" | "host" | "none";
-		/** 卷挂载 */
-		volumes?: Record<string, string>;
-	};
-}
-/**
-* 工具执行上下文
-*/
-interface ToolContext {
-	/** 工作目录 */
-	workdir?: string;
-	/** 用户 ID */
-	user_id?: string;
-	/** 会话 ID */
-	session_id?: string;
-	/** 消息 ID */
-	message_id?: string;
-	/** 中断信号 */
-	abort?: AbortSignal;
-	/** 额外元数据 */
-	metadata?: Record<string, unknown>;
-	/** 沙箱配置 */
-	sandbox?: SandboxConfig;
-	/** 沙箱 Provider */
-	sandboxProvider?: unknown | null;
-}
-/**
-* 工具结果元数据
-*/
-interface ToolResultMetadata {
-	/** 执行时间（毫秒） */
-	execution_time_ms: number;
-	/** 输出大小（字节） */
-	output_size?: number;
-	/** 标准输出 */
-	stdout?: string;
-	/** 标准错误 */
-	stderr?: string;
-	/** 退出码 */
-	exit_code?: number;
-	/** Token 使用量 */
-	usage?: {
-		inputTokens: number;
-		outputTokens: number;
-		totalTokens?: number;
-	};
-	/** 额外元数据 */
-	[key: string]: unknown;
-}
-/**
-* 工具执行结果
-*/
-interface ToolResult {
-	/** 是否成功 */
-	success: boolean;
-	/** 输出内容 */
-	output: string | Record<string, unknown>;
-	/** 错误信息 */
-	error?: string;
-	/** 结果元数据 */
-	metadata?: ToolResultMetadata;
-}
-/**
-* 工具元数据
-*/
-interface ToolMetadata {
-	/** 分类 */
-	category?: string;
-	/** 标签 */
-	tags?: string[];
-	/** 版本 */
-	version?: string;
-	/** 作者 */
-	author?: string;
-	/** 是否实验性 */
-	experimental?: boolean;
-	/** MCP 工具信息（MCP adapter 使用） */
-	mcpTool?: {
-		originalName: string;
-		originalDescription: string;
-		inputSchema?: unknown;
-	};
-}
-/**
-* 工具沙箱配置
-*/
-interface ToolSandboxConfig {
-	/** 是否启用沙箱 */
-	enabled: boolean;
-	/** 沙箱配置 */
-	config?: Partial<SandboxConfig>;
-}
-/**
-* 工具权限配置
-*/
-interface ToolPermissionConfig {
-	/** 是否需要用户确认 */
-	requireConfirmation?: boolean;
-	/** 权限级别 */
-	level?: "safe" | "dangerous" | "critical";
-}
-/**
-* 工具信息
-*/
-interface ToolInfo<Parameters extends ZodType = ZodType> {
-	/** 工具名称 */
-	name: string;
-	/** 工具描述 */
-	description: string;
-	/** 参数 Schema */
-	parameters: Parameters;
-	/** 初始化函数（可选） */
-	init?: (ctx?: ToolContext) => Promise<void>;
-	/** 执行函数 */
-	execute: (args: z.infer<Parameters>, ctx: ToolContext) => Promise<ToolResult>;
-	/** 参数验证错误格式化（可选） */
-	formatValidationError?: (error: ZodError) => string;
-	/** 沙箱配置 */
-	sandbox?: ToolSandboxConfig;
-	/** 权限配置 */
-	permission?: ToolPermissionConfig;
-	/** 工具元数据 */
-	metadata?: ToolMetadata;
-}
-/**
-* 工具类型别名
-*/
-type Tool = ToolInfo;
-import { z as z2 } from "zod";
-/**
-* Memory 来源类型
-* - project: 项目级记忆
-* - global: 全局记忆
-*/
-type MemorySource = "project" | "global";
-/**
-* Memory 路径配置
-*/
-interface MemoryPath {
-	/** 来源类型 */
-	type: MemorySource;
-	/** 绝对路径 */
-	path: string;
-}
-/**
-* MemoryComponent 配置
-*/
-interface MemoryConfig {
-	/** 多路径配置 */
-	memoryPaths: MemoryPath[];
-	/** 是否递归扫描子目录 */
-	recursive: boolean;
-	/** 是否启用缓存 */
-	cacheEnabled: boolean;
-	/** 缓存有效期（毫秒） */
-	cacheTTL?: number;
-	/** 记忆文件名 */
-	memoryFile?: string;
-}
-/**
-* record_memory 操作模式
-*/
-type RecordMemoryMode = "append" | "prepend" | "overwrite" | "delete";
-/**
-* record_memory 操作结果
-*/
-interface RecordMemoryResult {
-	/** 文件路径 */
-	path: string;
-	/** 操作类型 */
-	action: "created" | "append" | "prepend" | "overwrite" | "delete";
-}
-/**
-* record_memory 工具参数
-*/
-declare const RecordMemorySchema: unknown;
-type RecordMemoryParams = z2.infer<typeof RecordMemorySchema>;
-/**
-* recall_memory 工具参数
-*/
-declare const RecallMemorySchema: unknown;
-type RecallMemoryParams = z2.infer<typeof RecallMemorySchema>;
-/**
-* record_memory 工具参数
-*/
-declare const RecordMemorySchema2: unknown;
-/**
-* recall_memory 工具参数
-*/
-declare const RecallMemorySchema2: unknown;
-import { ModelMessage } from "ai";
-/**
-* MemoryPlugin configuration
-*/
-interface MemoryPluginConfig {
-	/** Enable memory plugin */
-	enabled?: boolean;
-}
-/**
-* Memory task types
-*/
-type MemoryTaskType = "extract_memory";
-/**
-* Memory task
-*/
-interface MemoryTask {
-	id: string;
-	type: MemoryTaskType;
-	payload: unknown;
-	timestamp: number;
-	priority: number;
-}
-/**
-* Extract memory payload
-*/
-interface ExtractMemoryPayload {
-	messages: ModelMessage[];
-	sessionId?: string;
-	/** Hook context for Memory Agent */
-	ctx?: MemoryHookContext;
-}
-/**
-* SessionMessage 接口
-*/
-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 context data for agent:after.react
-*/
-interface MemoryHookContext {
-	/** Current messages for memory extraction */
-	messages: ModelMessage[];
-	/** Current session ID */
-	sessionId?: string;
-	/** Project summaries (populated by project agent) */
-	projectSummaries?: unknown[];
-}
-/**
-* MemoryManager 配置
-*/
-interface MemoryManagerConfig {
-	/** 回调：当需要提取记忆时调用 */
-	onExtractMemory?: (payload: ExtractMemoryPayload) => Promise<void>;
-}
-/**
-* MemoryManager V3 - Simplified
-* 
-* 简化的后台异步内存处理，只负责任务队列
-*/
-declare class MemoryManager {
-	/** 队列最大容量，防止内存溢出 */
-	private static readonly MAX_QUEUE_SIZE;
-	private queue;
-	private processing;
-	private shuttingDown;
-	private config;
-	private processingPromise;
-	private resolveProcessing;
-	constructor(config?: MemoryManagerConfig);
-	/**
-	* 更新配置
-	*/
-	updateConfig(config: Partial<MemoryManagerConfig>): void;
-	/**
-	* 入队（非阻塞）
-	*/
-	enqueue(task: Omit<MemoryTask, "id">): void;
-	/**
-	* 启动处理循环
-	*/
-	private startProcessingLoop;
-	/**
-	* 检查是否有待处理任务
-	*/
-	hasPendingTasks(): boolean;
-	/**
-	* 等待处理完成
-	*/
-	waitForCompletion(): Promise<void>;
-	/**
-	* 准备关闭
-	*/
-	prepareShutdown(): void;
-	/**
-	* 释放资源
-	*/
-	dispose(): Promise<void>;
-	/**
-	* 处理单个任务
-	*/
-	private processTask;
-	/**
-	* 处理记忆提取
-	*/
-	private handleExtractMemory;
-}
-import { ModelMessage as ModelMessage2 } from "ai";
-type AbortSignalType = AbortSignal;
-interface ProjectSummary {
-	projectPath: string;
-	projectName: string;
-	lastUpdated: number;
-	summary: string;
-	shortSummary: string;
-	draftCount: number;
-	memoryMdPath: string;
-	draftsDir: string;
-	detailsDir: string;
-}
-/**
-* Agent 执行上下文
-*/
-interface AgentContext {
-	/** 会话 ID */
-	sessionId?: string;
-	/** 消息 ID */
-	messageId?: string;
-	/** 中断信号 */
-	abort?: AbortSignalType;
-	/** 额外的上下文信息（会添加到 system prompt） */
-	additionInfo?: string;
-	/** 元数据 */
-	metadata?: Record<string, unknown>;
-	/** Agent 类型（用于选择 Behavior Spec） */
-	agentType?: string;
-	/** 使用的模型 */
-	model?: string;
-	/** 允许的工具列表（上下文级别，会覆盖 agent 配置） */
-	allowedTools?: string[];
-	/** 拒绝的工具列表（上下文级别，会覆盖 agent 配置） */
-	deniedTools?: string[];
-	/** 是否过滤 history 中的 tool 消息（上下文级别，会覆盖 agent 配置） */
-	filterHistory?: boolean;
-}
-/**
-* 工具调用（内部使用）
-*/
-interface ToolCall2 {
-	/** 调用 ID */
-	id: string;
-	/** 工具名称 */
-	name: string;
-	/** 调用参数 */
-	arguments: Record<string, unknown>;
-}
-/**
-* 工具调用结果
-*/
-interface ToolCallResult {
-	/** 调用 ID */
-	id: string;
-	/** 工具名称 */
-	name: string;
-	/** 调用结果 */
-	result: ToolResult;
-	/** 是否成功 */
-	success: boolean;
-}
-/**
-* Hook 点枚举（带 component 前缀）
-*/
-type HookPoint = "agent:before.start" | "agent:before.llm" | "agent:after.llm" | "agent:before.tool" | "agent:after.tool" | "agent:on.iteration" | "agent:on.threshold" | "agent:after.complete" | "agent:on.error" | "agent:after.react" | "on.error";
-/**
-* Hook 上下文（Agent 特有版本）
-* 
-* 注意：这是 AgentComponent 使用的 HookContext 扩展版本
-* 包含 iteration, maxIterations, messages 等 Agent 特有字段
-*/
-interface HookContext2 {
-	/** 当前 LLM 输出（after.llm hook 可用） */
-	llmOutput?: AgentLLMOutput;
-	/** 当前工具调用（before.tool/after.tool hook 可用） */
-	currentToolCall?: ToolCall2;
-	/** 工具执行结果（after.tool hook 可用） */
-	toolResult?: ToolCallResult;
-	/** 阈值信息（on.threshold hook 可用） */
-	threshold?: {
-		type: "tokens" | "turns" | "iterations" | "custom";
-		value: number;
-		limit?: number;
-	};
-	/** 当前错误（on.error hook 可用） */
-	error?: Error;
-	/** 当前 Agent 实例 */
-	agent: AgentInstance;
-	/** 当前迭代次数（可修改） */
-	iteration: number;
-	/** 最大迭代次数限制（before.llm hook 可用） */
-	maxIterations: number;
-	/** 消息列表（可直接修改） */
-	messages: ModelMessage2[];
-	/** 可用工具列表（可直接修改） */
-	tools: Tool[];
-	/** 当前 system prompt（可直接修改） */
-	systemPrompt: string;
-	/** 额外的上下文信息（可直接修改） */
-	additionInfo?: string;
-	/** 执行上下文（可直接修改属性） */
-	context: AgentContext;
-	/** 是否已停止 */
-	_stopped?: boolean;
-	/** 停止原因 */
-	_stopReason?: string;
-	/** 待执行的干预动作 */
-	_pendingAction?: {
-		type: HookActionType2;
-		payload?: unknown;
-	};
-	/** 错误列表 */
-	_errors?: Array<{
-		plugin: string;
-		error: string;
-	}>;
-	/** Project Memory Agent 生成的摘要列表（由 Project Agent 写入，Global Agent 读取） */
-	projectSummaries?: ProjectSummary[];
-}
-/**
-* Hook 干预动作
-*/
-type HookActionType2 = "stop" | "retry" | "compress" | "extract_memory" | "inject_message" | "skip_tool";
-/**
-* Hook 返回结果
-*/
-interface HookResult2 {
-	/** 是否继续执行（false = 停止 Agent） */
-	continue: boolean;
-	/** 干预动作（可选） */
-	action?: {
-		type: HookActionType2;
-		payload?: unknown;
-	};
-}
-/**
-* Plugin 定义
-*/
-interface Plugin {
-	/** Plugin 唯一名称 */
-	name: string;
-	/** Plugin 版本 */
-	version: string;
-	/** Plugin 描述 */
-	description?: string;
-	/** 订阅的 Hook 点及优先级 */
-	hooks: Array<{
-		point: HookPoint;
-		/** 优先级，默认 0，数字越大越先执行 */
-		priority?: number;
-	}>;
-	/** 执行函数 */
-	execute: (ctx: HookContext2) => HookResult2 | Promise<HookResult2>;
-}
-/**
-* Agent 类型
-*/
-type AgentType = "primary" | "sub" | "summary";
-/**
-* Agent 状态
-*/
-type AgentStatus = "idle" | "running" | "paused" | "stopped" | "error";
-/**
-* Agent 实例配置
-*/
-interface AgentInstanceConfig {
-	/** Agent 类型 */
-	type: AgentType;
-	/** Agent 名称 */
-	name?: string;
-	/** System Prompt */
-	systemPrompt?: string;
-	/** Behavior Spec ID */
-	behaviorSpecId?: string;
-	/** 使用的模型 */
-	model?: string;
-	/** 最大迭代次数 */
-	maxIterations?: number;
-	/** 最大错误重试次数 */
-	maxErrorRetries?: number;
-	/** 死循环检测阈值 */
-	doomLoopThreshold?: number;
-	/** 允许的工具列表 */
-	allowedTools?: string[];
-	/** 拒绝的工具列表 */
-	deniedTools?: string[];
-	/** 工具超时（毫秒） */
-	toolTimeout?: number;
-	/** 工具重试次数 */
-	toolRetries?: number;
-	/** 是否过滤 history 中的 tool 消息（默认过滤，避免上下文过长） */
-	filterHistory?: boolean;
-}
-/**
-* Agent 实例
-*/
-interface AgentInstance {
-	/** Agent 名称 */
-	name: string;
-	/** Agent 配置 */
-	config: Required<AgentInstanceConfig>;
-	/** 当前状态 */
-	status: AgentStatus;
-	/** 注册的 Plugins */
-	plugins: Map<string, Plugin>;
-}
-/**
-* Agent 内部使用的 LLM 输出
-* 独立定义以避免与 LLMOutput 的类型冲突
-*/
-interface AgentLLMOutput {
-	/** 生成的内容 */
-	content: string;
-	/** 完成原因 */
-	finishReason: "stop" | "length" | "content-filter" | "tool-calls" | "function-call";
-	/** 工具调用（兼容格式） */
-	toolCalls?: Array<{
-		id: string;
-		function?: {
-			name: string;
-			arguments: string;
-		};
-		name?: string;
-		arguments?: string;
-	}>;
-	/** Usage 信息 */
-	usage?: {
-		promptTokens: number;
-		completionTokens: number;
-		totalTokens: number;
-	};
-	/** 生成模型 */
-	model?: string;
-	/** 推理内容（思考过程） */
-	reasoning?: string;
-}
-/**
-* MemoryPlugin - Simplified
-* 
-* 简化的记忆插件，不再自动处理。
-* 
-* 用户应该使用 `roy memory recall --extract` 命令来手动触发记忆提取。
-* 
-* 保留此插件是为了：
-* 1. 保持 API 兼容性
-* 2. 未来可以扩展为可选的自动触发
-*/
-declare class MemoryPlugin {
-	private config;
-	private disposed;
-	private initialized;
-	/** 项目 memory 基础目录 */
-	private projectBaseDir;
-	/** 全局 memory 基础目录 */
-	private globalBaseDir;
-	/** 当前工作目录（用于推断项目路径） */
-	private workDir;
-	/** AgentComponent 引用（延迟获取） */
-	private agentComponent;
-	constructor(baseDir: string, config?: MemoryPluginConfig);
-	/**
-	* Plugin 名称
-	*/
-	get name(): string;
-	/**
-	* 订阅的 Hook 点
-	*/
-	get hookPoint(): "agent:after.react";
-	/**
-	* 优先级
-	*/
-	get priority(): number;
-	/**
-	* 描述
-	*/
-	get description(): string;
-	/**
-	* 获取 Hook 定义
-	*/
-	get hooks(): unknown;
-	/**
-	* 初始化
-	*/
-	initialize(): Promise<void>;
-	/**
-	* 执行 Hook
-	* 
-	* 简化为空操作。用户应该使用 `roy memory recall --extract` 命令。
-	*/
-	execute(ctx: HookContext2): Promise<void>;
-	/**
-	* 准备关闭
-	*/
-	prepareShutdown(): void;
-	/**
-	* 检查是否有待处理任务
-	*/
-	hasPendingTasks(): boolean;
-	/**
-	* 等待处理完成
-	*/
-	waitForCompletion(): Promise<void>;
-	/**
-	* 释放资源
-	*/
-	dispose(): Promise<void>;
-	/**
-	* 获取项目 base dir
-	*/
-	getProjectBaseDir(): string;
-	/**
-	* 获取全局 base dir
-	*/
-	getGlobalBaseDir(): string;
-}
-/**
-* 创建 MemoryPlugin 实例
-*/
-declare function createMemoryPlugin(baseDir: string, config?: MemoryPluginConfig): MemoryPlugin;
-/**
-* 读取记忆文件
-* 
-* @param memoryPaths - 记忆路径列表
-* @returns 记忆内容
-*/
-declare function recallMemory2(memoryPaths: MemoryPath[]): Promise<string>;
-import { ModelMessage as ModelMessage3 } from "ai";
-/**
-* Memory 作用域类型
-*/
-type MemoryScope = "project" | "global";
-/**
-* 项目摘要信息
-*/
-interface ProjectSummary2 {
-	/** 项目根目录路径 */
-	projectPath: string;
-	/** 项目名称 */
-	projectName: string;
-	/** 最后更新时间戳 */
-	lastUpdated: number;
-	/** 项目 memory.md 摘要（一段话） */
-	summary: string;
-	/** 简短摘要（几个词） */
-	shortSummary: string;
-	/** 项目 memory.md 路径 */
-	memoryMdPath: string;
-}
-/**
-* Memory Agent 输入
-*/
-interface MemoryAgentInput {
-	/** 作用域 */
-	scope: MemoryScope;
-	/** 基础目录（project: .roy/memory, global: ~/.config/roy-agent/memory） */
-	baseDir: string;
-	/** 当前 memory.md 内容 */
-	currentMemoryMd: string;
-	/** 当前对话消息 */
-	messages: ModelMessage3[];
-	/** 项目摘要列表（仅 global scope 使用） */
-	projectSummaries?: ProjectSummary2[];
-}
-/**
-* Memory Agent 输出结果
-*/
-interface MemoryAgentResult {
-	/** 作用域 */
-	scope: MemoryScope;
-	/** 新的 memory.md 内容（全文） */
-	memoryMdContent: string;
-	/** 项目摘要（仅 project scope 输出） */
-	projectSummary?: ProjectSummary2;
-	/** 是否有更新 */
-	hasUpdates: boolean;
-}
-/**
-* Memory Agent 配置
-*/
-interface MemoryAgentConfig {
-	/** Agent 名称 */
-	name: string;
-	/** System prompt */
-	systemPrompt: string;
-	/** 最大迭代次数 */
-	maxIterations: number;
-}
-/**
-* Project Memory Agent System Prompt
-*/
-declare const PROJECT_MEMORY_AGENT_PROMPT = "你是项目级 Memory Agent，负责整理和更新当前项目的记忆。\n\n## 你的职责\n\n1. **信息收集**：在提取记忆前，先收集项目上下文信息\n2. **从对话中提取记忆**：分析 messages，提取与项目相关的知识、决策、解决方案\n3. **生成 memory.md**：更新项目记忆索引\n\n## 信息收集步骤（重要！）\n\n在提取记忆之前，请先使用可用工具收集项目上下文：\n\n1. **阅读项目 README**：了解项目概述、功能、使用方法\n   - 路径示例：README.md, README.zh-CN.md, docs/README.md\n\n2. **检查设计文档**：了解项目架构和设计决策\n   - 路径示例：docs/design.md, docs/ARCHITECTURE.md, docs/superpowers/specs/*.md\n\n3. **查看代码实现**：了解关键模块和实现细节\n   - 路径示例：src/**/*.ts, packages/*/src/**/*.ts\n\n4. **回顾现有 memory**：了解已有的项目记忆\n   - 路径：当前目录下的 .roy/memory/memory.md\n\n## 输入信息\n\n- 当前项目的 memory.md 内容\n- 当前对话消息\n\n## 输出要求\n\n请以 JSON 格式输出结果，包含以下字段：\n- memoryMdContent: 新的 memory.md 内容\n- projectSummary: 项目摘要（包含 summary, shortSummary 等）\n- hasUpdates: 是否有更新\n\n## 记忆组织原则\n\n- 优先记录具体、可操作的记忆（代码位置、配置项、命令）\n- 避免过于抽象或通用的描述\n- 记录设计决策及其理由";
-/**
-* Global Memory Agent System Prompt
-*/
-declare const GLOBAL_MEMORY_AGENT_PROMPT = "你是全局 Memory Agent，负责整理跨项目的通用记忆。\n\n## 你的职责\n\n1. **聚合项目摘要**：分析 projectSummaries，提取共性知识\n2. **维护全局记忆**：更新全局 memory.md\n3. **维护项目索引**：在 memory.md 中维护项目列表\n4. **提取共性经验**：将项目经验提炼为通用最佳实践\n\n## 输入信息\n\n- 全局 memory.md 内容\n- 当前对话消息\n- 项目摘要列表（projectSummaries）\n\n## 输出要求\n\n请以 JSON 格式输出结果，包含以下字段：\n- memoryMdContent: 新的 memory.md 内容\n- hasUpdates: 是否有更新\n\n## 记忆组织原则\n\n- 关注跨项目共性（工作流、规范、偏好）\n- 项目索引只记录摘要和路径，不复制内容\n- 用户个人偏好（饮食、工作习惯）优先记录";
-/**
-* 创建 Memory Agent 配置
-*/
-declare function createMemoryAgent(scope: MemoryScope): MemoryAgentConfig;
-/**
-* 格式化 Memory Agent 输入为字符串
-*/
-declare function formatMemoryInput(input: MemoryAgentInput): string;
-/**
-* 解析 Memory Agent 输出
-*/
-declare function parseMemoryAgentOutput(output: string, scope: MemoryScope): MemoryAgentResult;
-/**
-* 创建默认的 MemoryAgentResult
-*/
-declare function createEmptyResult(scope: MemoryScope): MemoryAgentResult;
-/**
-* 构建 Project Memory Agent 输入
-*/
-declare function buildProjectInput(params: {
-	projectPath: string;
-	currentMemoryMd: string;
-	messages: ModelMessage3[];
-}): Promise<MemoryAgentInput>;
-/**
-* 构建 Global Memory Agent 输入
-*/
-declare function buildGlobalInput(params: {
-	baseDir: string;
-	currentMemoryMd: string;
-	messages: ModelMessage3[];
-	projectSummaries?: ProjectSummary2[];
-}): MemoryAgentInput;
-/**
-* 应用 Memory Agent 结果到文件系统
-*
-* @param result MemoryAgent 结果
-* @param baseDir 基础目录
-*/
-declare function applyMemoryResult(result: MemoryAgentResult, baseDir: string): Promise<void>;
-/**
-* 生成项目摘要
-*/
-declare function generateProjectSummary(params: {
-	projectPath: string;
-	projectName: string;
-	memoryMdContent: string;
-	memoryMdPath: string;
-}): ProjectSummary2;
-/**
-* 默认配置
-*/
-declare const DEFAULT_MEMORY_CONFIG: MemoryConfig;
-/**
-* 优先级映射（后面的优先级更高）
-*/
-declare const SOURCE_PRIORITY: Record<string, number>;
-/**
-* 获取来源优先级
-*/
-declare function getSourcePriority(source: string): number;
-import { ZodType as ZodType3, ZodTypeDef as ZodTypeDef2 } from "zod";
-/**
-* @fileoverview Environment types and interfaces
-* 
-* 定义 Environment 的核心类型，包括：
-* - Environment 配置
-* - EnvEvent 事件类型
-*/
-/**
-* Environment Config
-*/
-interface EnvironmentConfig {
-	/** 环境名称 */
-	name: string;
-	/** 环境版本 */
-	version: string;
-	/** 是否启用 */
-	enabled: boolean;
-}
-/**
-* EnvEvent 元信息
-*/
-interface EnvEventMetadata {
-	/** 触发事件的 session ID */
-	trigger_session_id?: string;
-	/** 触发事件的 agent ID */
-	trigger_agent_id?: string;
-	/** Agent 名称 */
-	trigger_agent_name?: string;
-	/** 环境名称 */
-	env_name?: string;
-	/** 事件来源 */
-	source?: string;
-	/** 其他元数据 */
-	[key: string]: unknown;
-}
-/**
-* EnvEvent
-* 
-* 统一的事件机制，用于：
-* - Stream 事件（stream.start, stream.text, stream.completed 等）
-* - 工具调用事件（tool.call, tool.result 等）
-* - 会话事件（session.created, session.updated 等）
-* - Agent 事件（agent.thinking, agent.acting 等）
-*/
-interface EnvEvent<T = unknown> {
-	/** 事件 ID */
-	id: string;
-	/** 事件类型 */
-	type: string;
-	/** 时间戳 */
-	timestamp: number;
-	/** 元信息 */
-	metadata: EnvEventMetadata;
-	/** 事件负载 */
-	payload: T;
-}
-/**
-* EnvEvent Handler
-*/
-type EnvEventHandler = (event: EnvEvent) => void | Promise<void>;
-/**
-* EnvEvent 创建参数（部分属性，可选）
-* 
-* 用于 pushEnvEvent 方法，允许传入部分属性，自动补全必填字段
-*/
-interface EnvEventInput {
-	/** 事件类型（必填） */
-	type: string;
-	/** 事件 ID（可选，自动生成） */
-	id?: string;
-	/** 时间戳（可选，自动生成） */
-	timestamp?: number;
-	/** 元信息（可选，自动创建） */
-	metadata?: EnvEventMetadata;
-	/** 事件负载（可选） */
-	payload?: unknown;
-}
-/**
-* Action 类型
-*/
-interface Action {
-	/** Action 类型 */
-	type: string;
-	/** Action 参数 */
-	params?: Record<string, unknown>;
-}
-/**
-* Tool Result
-*/
-interface ToolResult3 {
-	/** 是否成功 */
-	success: boolean;
-	/** 输出内容 */
-	output: string | Record<string, unknown>;
-	/** 错误信息 */
-	error?: string;
-}
-/**
-* Context
-*/
-interface Context {
-	/** 会话 ID */
-	sessionId?: string;
-	/** 用户 ID */
-	userId?: string;
-	/** 工作目录 */
-	workdir?: string;
-	/** 中断信号 */
-	abort?: AbortSignal;
-	/** 元数据 */
-	metadata?: Record<string, unknown>;
-}
-import { ZodType as ZodType2, ZodTypeDef } from "zod";
-/**
-* ConfigSource 类型
-*/
-type ConfigSourceType = "memory" | "file" | "env" | "remote";
-/**
-* SourceRegistration - Source 注册配置
-*/
-interface SourceRegistration {
-	/** Source 类型 */
-	type: ConfigSourceType;
-	/** 相对路径（file 类型使用，基于 XDG_DATA_HOME） */
-	relativePath?: string;
-	/** 环境变量前缀（env 类型使用） */
-	envPrefix?: string;
-	/** 优先级，默认值：memory=0, file=10, env=20 */
-	priority?: number;
-	/** 是否可选（file 类型使用，文件不存在时不报错） */
-	optional?: boolean;
-	/** 是否启用文件监听（file 类型使用，默认 true） */
-	watch?: boolean;
-}
-/**
-* KeyRegistration - 配置 Key 注册
-*/
-interface KeyRegistration {
-	/** 配置 Key（支持点号嵌套，如 "llm.provider"） */
-	key: string;
-	/** 优先使用的 Source 列表（按优先级从低到高） */
-	sources: ConfigSourceType[];
-	/** 自定义优先级（覆盖默认优先级） */
-	priority?: number;
-	/** 默认值 */
-	default?: unknown;
-}
-/**
-* ComponentRegistration - Component 注册配置
-*/
-interface ComponentRegistration {
-	/** Component 名称 */
-	name: string;
-	/** 声明需要的 Source */
-	sources: SourceRegistration[];
-	/** 声明需要的配置 Key */
-	keys: KeyRegistration[];
-	/** 配置 Schema（用于验证，可选） */
-	schema?: ZodType2<unknown, ZodTypeDef, unknown>;
-	/** 默认值 */
-	defaults?: Record<string, unknown>;
-}
-/**
-* ConfigSource 接口
-*/
-interface ConfigSource {
-	readonly name: ConfigSourceType;
-	readonly priority: number;
-	read(key: string): unknown | undefined;
-	write?(key: string, value: unknown): boolean;
-	delete?(key: string): boolean;
-	list(): Array<{
-		key: string;
-		value: unknown;
-	}>;
-	watch?(callback: (event: ConfigChangeEvent) => void): () => void;
-}
-/**
-* Config 变更事件
-*/
-interface ConfigChangeEvent {
-	type: "change" | "add" | "delete";
-	key: string;
-	oldValue: unknown;
-	newValue: unknown;
-	source: ConfigSourceType;
-	timestamp: number;
-}
-/**
-* ConfigComponent 配置
-*/
-interface ConfigComponentOptions {
-	/** 持久化文件路径 */
-	persistFile?: string;
-	/** 防抖延迟（ms） */
-	debounceMs?: number;
-	/** 最大批量大小 */
-	maxBatchSize?: number;
-}
-/**
-* ConfigComponent
-*/
-declare class ConfigComponent extends BaseComponent {
-	readonly name = "config";
-	readonly version = "1.0.0";
-	private memorySource;
-	private sources;
-	private componentSchemas;
-	private componentPaths;
-	private watchers;
-	/** Source watch unsubscribe 函数 */
-	private sourceUnwatchFns;
-	private persistQueue;
-	private persistFile?;
-	/** Key 注册表：key -> KeyRegistration */
-	private keyRegistry;
-	/** Component 注册表：name -> ComponentRegistration */
-	private componentRegistrations;
-	/** 协议解析器 */
-	private protocolResolver?;
-	/** XDG_DATA_HOME 缓存（用于测试注入） */
-	private __xdgDataHome?;
-	/** Source 注册配置（延迟创建） */
-	private pendingSources;
-	/** Source 唯一标识缓存：type:relativePath -> true */
-	private sourceKeys;
-	/**
-	* 获取 XDG_DATA_HOME（动态获取，支持运行时覆盖）
-	*/
-	getXdgDataHome(): string;
-	/**
-	* 设置 XDG_DATA_HOME（用于测试）
-	*/
-	setXdgDataHome(path: string): void;
-	constructor(options?: ConfigComponentOptions);
-	/**
-	* 注册 Component Schema
-	*/
-	register(schema: ComponentSchema): void;
-	/**
-	* 注销 Component
-	*/
-	unregister(name: string): boolean;
-	/**
-	* 检查是否已注册
-	*/
-	isRegistered(name: string): boolean;
-	/**
-	* 列出所有注册的 Component
-	*/
-	listComponents(): string[];
-	/**
-	* 获取配置值（支持 xxx.yyy.zzz 嵌套访问）
-	* 支持两种模式：
-	* 1. 完整 key：直接查找，如 "component.key" -> 读取 "component.key"
-	* 2. 嵌套对象：查找 component 对象后从中获取属性，如 "component.nested.deep" 
-	*    -> 先找 "component.nested"，再获取其 "deep" 属性
-	*/
-	get(key: string): unknown;
-	/**
-	* 批量获取
-	*/
-	getMany(keys: string[]): Record<string, unknown>;
-	/**
-	* 设置配置值（内存级别 + 异步持久化）
-	*/
-	set(key: string, value: unknown): Promise<void>;
-	/**
-	* 批量设置
-	*/
-	setMany(config: Record<string, unknown>): Promise<void>;
-	/**
-	* 获取 Component 的路径
-	*/
-	getPath(component: string, subPath?: string): string;
-	/**
-	* 手动持久化
-	*/
-	save(key?: string): Promise<void>;
-	/**
-	* 重置到默认值
-	*/
-	reset(key: string): Promise<void>;
-	/**
-	* 监听配置变更
-	*/
-	watch(pattern: string, callback: ComponentWatchCallback): () => void;
-	/**
-	* 添加配置源
-	*/
-	addSource(source: ConfigSource): void;
-	/**
-	* 获取 Source 唯一标识
-	*/
-	private getSourceKey;
-	/**
-	* 移除配置源
-	*/
-	removeSource(name: ConfigSourceType): boolean;
-	/**
-	* 关闭所有配置源的 watcher（用于优雅退出）
-	*/
-	unwatchAll(): void;
-	/**
-	* 获取配置源列表
-	*/
-	getSources(): ConfigSource[];
-	private getNestedValue;
-	private notifyWatchers;
-	private persistToFile;
-	/**
-	* 注册配置 Source
-	* 
-	* Source 会在首次 load() 时被创建
-	* 
-	* @example
-	* config.registerSource({ type: "file", relativePath: "llm-config.jsonc" });
-	* config.registerSource({ type: "env", envPrefix: "LLM" });
-	*/
-	registerSource(registration: SourceRegistration): void;
-	/**
-	* 创建 Source 实例
-	*/
-	private createSource;
-	/**
-	* 确保所有待创建的 Source 已被创建
-	*/
-	private ensureSourcesCreated;
-	/**
-	* 注册配置 Key
-	* 
-	* @example
-	* config.registerKeys([
-	*   { key: "llm.provider", sources: ["file", "memory"], default: "openai" },
-	*   { key: "llm.model", sources: ["file"] },
-	* ]);
-	*/
-	registerKeys(keys: KeyRegistration[]): void;
-	/**
-	* 注册 Component（一次性注册 Source 和 Keys）
-	* 
-	* @example
-	* config.registerComponent({
-	*   name: "llm",
-	*   sources: [
-	*     { type: "file", relativePath: "llm-config.jsonc" },
-	*     { type: "env", envPrefix: "LLM" },
-	*   ],
-	*   keys: [
-	*     { key: "llm.provider", sources: ["file", "env", "memory"] },
-	*   ],
-	* });
-	*/
-	registerComponent(registration: ComponentRegistration): void;
-	/**
-	* 按需加载配置
-	* 
-	* 从注册的 Source 加载已注册 Keys 的配置值到内存中
-	* 
-	* @param componentName - 可选，指定要加载的 Component 名称
-	* 
-	* @example
-	* // 加载所有已注册的 Keys
-	* await config.load();
-	* 
-	* // 只加载指定 Component 的 Keys
-	* await config.load("llm");
-	*/
-	load(componentName?: string): Promise<void>;
-	/**
-	* 获取已注册的 Source 列表
-	*/
-	getRegisteredSources(): ConfigSource[];
-}
-/**
-* 服务配置接口
-*/
-interface ServiceConfig {
-	/** 环境配置 */
-	environment?: {
-		name?: string;
-		version?: string;
-	};
-	/** 组件配置映射 */
-	components?: Record<string, ComponentConfigEntry>;
-}
-/**
-* 组件配置项
-*/
-interface ComponentConfigEntry {
-	/** 配置文件路径（可选） */
-	configPath?: string;
-	/** 环境变量前缀（可选） */
-	envPrefix?: string;
-	/** 直接配置对象（可选） */
-	config?: Record<string, unknown>;
-	/** 是否启用（可选，默认 true） */
-	enabled?: boolean;
-}
-/**
-* 组件初始化选项（由 generateComponentOptions 生成）
-*/
-interface GeneratedComponentOptions {
-	/** ConfigComponent 实例 */
-	configComponent: ConfigComponent;
-	/** 配置文件路径 */
-	configPath?: string;
-	/** 环境变量前缀 */
-	envPrefix?: string;
-	/** 直接配置对象 */
-	config?: Record<string, unknown>;
-	/** 允许的其他属性 */
-	[key: string]: unknown;
-}
-/**
-* Environment 接口
-* 
-* 定义 Agent 运行时的核心能力接口。
-*/
-interface Environment {
-	/** 环境名称 */
-	readonly name: string;
-	/** 环境版本 */
-	readonly version: string;
-	/** 获取环境配置 */
-	getConfig(): EnvironmentConfig;
-	/**
-	* 注册组件
-	*/
-	registerComponent(component: Component): void;
-	/**
-	* 注销组件
-	*/
-	unregisterComponent(name: string): void;
-	/**
-	* 获取组件
-	*/
-	getComponent<T extends Component>(name: string): T | undefined;
-	/**
-	* 列出所有组件
-	*/
-	listComponents(): Component[];
-	/**
-	* 处理自然语言查询（核心入口）
-	* 
-	* @param query 用户查询文本
-	* @param context 执行上下文（可选）
-	* @returns 完整的文本响应
-	*/
-	handle_query(query: string, context?: AgentContext): Promise<string>;
-	/**
-	* 处理动作
-	*/
-	handle_action(action: Action, context: Context): Promise<ToolResult3>;
-	/**
-	* 订阅 EnvEvent（返回取消订阅函数）
-	*/
-	subscribe(handler: EnvEventHandler): () => void;
-	/**
-	* 订阅指定类型事件
-	*/
-	subscribeTo(eventType: string | string[], handler: EnvEventHandler): () => void;
-	/**
-	* 订阅所有事件（通配符）
-	*/
-	subscribeAll(handler: EnvEventHandler): () => void;
-	/**
-	* 推送事件
-	* 
-	* @param event EnvEvent 或 EnvEventInput（部分属性）
-	*/
-	pushEnvEvent(event: EnvEvent | EnvEventInput): void;
-	/**
-	* 从配置文件加载服务配置
-	* 
-	* @param configPath 配置文件路径（基于 XDG_DATA_HOME）
-	* @returns 解析后的服务配置对象
-	*/
-	loadServiceConfig(configPath: string): Promise<ServiceConfig>;
-	/**
-	* 生成组件初始化选项
-	* 
-	* 根据组件配置项生成可用于初始化的选项对象。
-	* 
-	* @param componentName 组件名称
-	* @param configEntry 组件配置项
-	* @returns 生成的组件初始化选项
-	*/
-	generateComponentOptions(componentName: string, configEntry: ComponentConfigEntry): GeneratedComponentOptions;
-	/**
-	* 注册组件并用配置初始化
-	* 
-	* 便捷方法：注册组件并通过 ConfigComponent 初始化。
-	* 
-	* @param component 要注册的组件实例
-	* @param configEntry 组件配置项
-	*/
-	registerComponentWithConfig(component: Component, configEntry: ComponentConfigEntry): Promise<void>;
-	/**
-	* 从配置文件初始化整个环境
-	* 
-	* 加载服务配置，注册并初始化所有配置的组件。
-	* 
-	* @param configPath 配置文件路径（基于 XDG_DATA_HOME）
-	*/
-	initFromConfig(configPath: string): Promise<void>;
-}
-/**
-* Component 状态
-*/
-type ComponentStatus = "created" | "initializing" | "running" | "stopping" | "stopped" | "error";
-/**
-* Component 配置
-*/
-interface ComponentConfig {
-	name: string;
-	version: string;
-	enabled: boolean;
-	options?: Record<string, unknown>;
-	/**
-	* Environment 实例（可选）
-	* 
-	* 推荐在 init 时接收 env 实例，以便：
-	* - 通过 env.getComponent() 获取其他组件
-	* - 通过 env.pushEnvEvent() 发布事件
-	* - 通过 env.handle_query() 处理查询
-	* 
-	* 如果未提供，部分 Component 仍可正常工作（如测试场景）
-	* 
-	* @example
-	* ```typescript
-	* async onInit(): Promise<void> {
-	*   if (this.env) {
-	*     const configComp = this.env.getComponent("config");
-	*   }
-	* }
-	* ```
-	*/
-	env?: Environment;
-}
-/**
-* Component 路径声明
-*/
-interface ComponentPaths {
-	base: "config" | "state" | "data" | "cache";
-	subPath: string;
-	isDirectory: boolean;
-}
-/**
-* Component Schema（注册配置）
-*/
-interface ComponentSchema {
-	/** Component 名称 */
-	name: string;
-	/** 配置 Schema（Zod） */
-	schema: ZodType3<unknown, ZodTypeDef2, unknown>;
-	/** 默认值（从 Schema 提取） */
-	defaults: Record<string, unknown>;
-	/** 路径声明 */
-	paths?: Record<string, ComponentPaths>;
-	/** 元信息 */
-	metadata?: {
-		description?: string;
-		version?: string;
-		author?: string;
-	};
-}
-/**
-* Component 配置变更事件
-*/
-interface ComponentConfigChangeEvent {
-	/** Component 名称 */
-	component: string;
-	/** 变更的配置键 */
-	key: string;
-	/** 旧值 */
-	oldValue: unknown;
-	/** 新值 */
-	newValue: unknown;
-	/** 是否持久化 */
-	persisted: boolean;
-	/** 时间戳 */
-	timestamp: number;
-}
-/**
-* Component 配置监听回调
-*/
-type ComponentWatchCallback = (event: ComponentConfigChangeEvent) => void | Promise<void>;
-/**
-* Component 基类接口
-*/
-interface Component {
-	/** Component 名称 */
-	readonly name: string;
-	/** Component 版本 */
-	readonly version: string;
-	/** 获取状态 */
-	getStatus(): ComponentStatus;
-	/** 获取配置 */
-	getConfig(): ComponentConfig;
-	/** 初始化 */
-	init(config: ComponentConfig): Promise<void>;
-	/** 启动 */
-	start(): Promise<void>;
-	/** 停止 */
-	stop(): Promise<void>;
-}
-/**
-* Component 基类实现
-*/
-declare abstract class BaseComponent implements Component {
-	abstract readonly name: string;
-	abstract readonly version: string;
-	protected _status: ComponentStatus;
-	protected _enabled: boolean;
-	protected env: Environment;
-	/** Hook 管理器 - 子类初始化时由构造函数设置 */
-	readonly hookManager: HookManager;
-	constructor();
-	getStatus(): ComponentStatus;
-	getConfig(): ComponentConfig;
-	/**
-	* 检查 Environment 是否已初始化
-	*/
-	protected isEnvInitialized(): boolean;
-	protected setStatus(status: ComponentStatus): void;
-	/**
-	* 获取 Environment 实例
-	*/
-	protected getEnv(): Environment;
-	init(config?: ComponentConfig): Promise<void>;
-	start(): Promise<void>;
-	stop(): Promise<void>;
-	/**
-	* 子类可覆盖的钩子方法
-	*/
-	protected onInit(): Promise<void>;
-	protected onStart(): Promise<void>;
-	protected onStop(): Promise<void>;
-	/**
-	* 注册 Hook
-	* 
-	* @param hookPoint Hook 点名称
-	* @param hook Hook 实例
-	*/
-	protected registerHook<T = unknown>(hookPoint: string, hook: Hook<T>): void;
-	/**
-	* 便捷方法：快速注册 Hook
-	*/
-	protected addHook<T = unknown>(hookPoint: string, name: string, fn: HookFn<T>, priority?: number): void;
-	/**
-	* 便捷方法：按名称取消注册 Hook
-	*/
-	protected removeHook(hookPoint: string, name: string): boolean;
-	/**
-	* 执行 Hook
-	*/
-	protected executeHooks<T = unknown>(hookPoint: string, data: T, metadata?: Record<string, unknown>): Promise<void>;
-	/**
-	* 获取 ConfigComponent 实例
-	* 
-	* 子类可使用此方法获取配置组件，支持热更新
-	*/
-	protected getConfigComponent(): {
-		get(key: string): unknown;
-	} | undefined;
-	/**
-	* 动态获取运行时配置值
-	* 
-	* 优先从 ConfigComponent 获取（支持热更新），否则返回默认值
-	* 适用于运行时可能变化的配置（如 API Keys、模型参数）
-	* 
-	* @param key 配置键（支持点号分隔的路径，如 "llm.temperature"）
-	* @param defaultValue 默认值
-	* @returns 配置值或默认值
-	* 
-	* @example
-	* ```typescript
-	* // 获取 LLM 温度配置（可能支持热更新）
-	* const temperature = this.getRuntimeConfig("llm.temperature", 0.7);
-	* 
-	* // 获取 API Key
-	* const apiKey = this.getRuntimeConfig<string>("llm.providers.openai.apiKey");
-	* ```
-	*/
-	protected getRuntimeConfig<T>(key: string, defaultValue: T): T;
-}
-/**
-* MemoryComponent 配置选项（通过 options 传递）
-*/
-interface MemoryComponentOptions {
-	/** ConfigComponent 实例（必填） */
-	configComponent: ConfigComponent;
-	/** 配置文件相对路径（可选，基于 XDG_DATA_HOME） */
-	configPath?: string;
-	/** 环境变量前缀（可选，默认 "MEMORY"） */
-	envPrefix?: string;
-	/** 直接传入的配置对象（可选，优先级最高） */
-	config?: Partial<MemoryConfig>;
-}
-/**
-* MemoryComponent - Simplified
-* 
-* 简化的记忆管理组件，只负责：
-* - 管理本地文件系统记忆存储
-* - 注册记忆操作工具
-* - 提供目录扫描和缓存
-* 
-* 复杂功能已移除：
-* - DraftManager（草稿管理）
-* - MemoryOrganizer（记忆整理）
-* - AccessLog（访问日志）
-*/
-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;
-}
-export { recallMemory2 as recallMemory, parseMemoryAgentOutput, getSourcePriority, generateProjectSummary, formatMemoryInput, createMemoryPlugin, createMemoryAgent, createEmptyResult, buildProjectInput, buildGlobalInput, applyMemoryResult, SessionMessage, SOURCE_PRIORITY, RecordMemorySchema2 as RecordMemorySchema, RecordMemoryResult, RecordMemoryParams, RecordMemoryMode, RecallMemorySchema2 as RecallMemorySchema, RecallMemoryParams, ProjectSummary2 as ProjectSummary, PROJECT_MEMORY_AGENT_PROMPT, MemoryTaskType, MemoryTask, MemorySource, MemoryScope, MemoryPluginConfig, MemoryPlugin, MemoryPath, MemoryManager, MemoryHookContext, MemoryConfig, MemoryComponentOptions, MemoryComponent, MemoryAgentResult, MemoryAgentInput, MemoryAgentConfig, GLOBAL_MEMORY_AGENT_PROMPT, ExtractMemoryPayload, DEFAULT_MEMORY_CONFIG };