aws-runtime-bridge 1.9.22 → 1.9.31

package/package/aws-client-agent-mcp/dist/mcp-server.d.ts

@@ -11,6 +11,8 @@ export declare class McpServer {
     private sessionContextMemoryStore;
     private memoryStoresShareFile;
     private initialRoleName;
+    /** 是否有真实的角色名（非 env 空值 fallback "default-role"） */
+    private hasRoleName;
     /** 上下文管理器 (v1.8.0) */
     private contextManager;
     /**
@@ -28,6 +30,13 @@ export declare class McpServer {
     private listableMd5Cache;
     /** 后台 Memory 文件变更检测定时器 (v1.9.0) */
     private memoryFileCheckInterval;
+    /**
+     * Memory 通知 null 结果缓存：key → expiresAt 时间戳。
+     * 仅缓存 null（无通知）结果，避免 while(true) 每 30s 重复读盘。
+     * 有通知时立即投递并清除缓存，不缓存非 null 结果。
+     */
+    private memoryNotificationNullCache;
+    private static readonly MEMORY_NOTIFICATION_NULL_TTL_MS;
     /**
      * 收到 Profile 后同步角色存储路径。
      * 当服务端返回的 roleName 与进程初始化时不一致时，重建 roleMemoryStore 指向正确的目录。
@@ -107,6 +116,12 @@ export declare class McpServer {
      * 按记忆生命周期选择存储作用域。
      * 主流程：长期 memory 走角色级 store；task_list/recently_memory 走当前 Agent 实例级 store。
      */
+    /**
+     * 按记忆生命周期选择存储作用域。
+     * 主流程：永久记忆(memory)仅在 hasRoleName 为 true 时走角色级 store，
+     *         否则回退到实例级 server store（避免空角色名下所有实例共享 default-role 目录导致跨角色污染）。
+     * task_list/recently_memory/session_context 始终走实例级 store。
+     */
     private getMemoryStoreForType;
     /**
      * 在未显式指定类型时按两个作用域读取。
@@ -133,6 +148,14 @@ export declare class McpServer {
      * 主流程：读取本地 roleMemoryStore 中所有 memory 类型记录 -> 逐条写入服务端 memoryStore -> 已存在的记录静默跳过。
      */
     private syncLocalPermanentMemoryToServer;
+    /**
+     * 系统提示词由 runtime adapter 在会话创建时注入，MCP 层面不再负责返回。
+     * 详见 startListeningInternal -> profileHandler 中的合并注入逻辑。
+     *
+     * @deprecated 启动记忆不再通过 MCP 的 systemMessages 返回。
+     *   三方 runtime（OpenCode/Claude）在 adapter 层将三层提示词合并为一条 system prompt；
+     *   ACode 则直接注入为前三条 system role 消息。
+     */
     /**
      * 生成安全的工具状态上报参数。
      * 主流程：memory 工具只上报元数据，避免 content/query/old_string/new_string/append 离开本地记忆边界。
@@ -184,11 +207,6 @@ export declare class McpServer {
      * 主流程：读取 MemoryStore 统计结果，供 Agent 在创建前判断 listable/type 容量。
      */
     private handleGetMemoryStats;
-    /**
-     * 移除任务清单记忆。
-     * 主流程：按 uri 读取并校验 task_list 类型后删除，避免误删长期记忆。
-     */
-    private handleRemoveTaskListMemory;
     /**
      * 归档近期记忆。
      * 主流程：将 recently_memory 原地转换为长期 memory，并递增版本号。
@@ -214,6 +232,18 @@ export declare class McpServer {
      * Memory 增强功能 (v1.6.0)
      */
     private handleAbandonMemoryUpdate;
+    /**
+     * 处理 memory_recurrence 工具调用。
+     * 主流程：调用服务端 list_expired_memories 拉取已过期 recently_memory ->
+     * 按过期时间排序（最早优先）-> 取前 limit 条 ->
+     * 仅标记这 limit 条为「回忆中」状态 -> 返回这些记忆及剩余数量。
+     */
+    private handleMemoryRecurrence;
+    /**
+     * 处理 memory_recurrence_complete 工具调用。
+     * 主流程：调用服务端 clear_recalling_expired_memories 删除所有「recalling + 已过期」记录。
+     */
+    private handleMemoryRecurrenceComplete;
     /**
      * 获取当前会话的上下文统计。
      * 主流程：从 profile 获取模型名称 -> 通过模型名查找上下文窗口 -> 调用 ContextManager 获取统计 -> 返回。
@@ -244,8 +274,25 @@ export declare class McpServer {
     private handleHireColleaguesBatch;
     private handleSendPrivate;
     private handleCreateTaskInstanceComment;
+    /**
+     * 构建内存通知并前置到消息列表。
+     * @returns 若生成了通知并已前置，返回 true；否则返回 false。
+     */
+    private prependMemoryNotification;
+    /**
+     * 带 null 结果缓存的 Memory 通知构建。
+     * 主流程：查缓存 → 命中且未过期则返回 null → 未命中则调 buildFn →
+     *   结果为 null 则写入缓存（TTL 60s）→ 结果非 null 则清除缓存并返回。
+     * 目的：while(true) 每 30s 轮询时避免重复读盘，有通知时立即投递不受缓存影响。
+     */
+    private getCachedMemoryNotification;
     private handlePollMessage;
-    private waitForMessagesWithPoll;
+    /**
+     * 后检 Memory 通知并注入到待返回的消息中。按优先级从高到低注入：
+     * 文件变更（始终注入）→ 近期记忆过期回忆（触发即返回）→ TODO（触发即返回）→ 容量整理（始终注入）
+     */
+    private finalizeWithMemoryNotifications;
+    private buildPollResult;
     private resolvePollMessageBlockWaitMs;
     /**
      * 解析正整数环境变量。
@@ -258,6 +305,17 @@ export declare class McpServer {
      * 主流程：读取容量统计 -> 找出超过软限制的 listable 类型 -> 注入一条非持久化系统私信提醒 Agent 整理。
      */
     private buildMemoryCleanupNotification;
+    /**
+     * 构建近期记忆过期回忆通知（有即将遗忘的记忆需要整理）。
+     * Memory 近期记忆过期 (v1.11.0) / v1.13.0 改用服务端 memory_status 字段
+     *
+     * 通知策略（基于服务端 memory_status）：
+     * 1. 有过期 recently_memory 且 memory_status='recalling'（回忆中但未完成疏理）：
+     *    通知 "存在待疏理的即将遗忘记忆，请通过 memory_recurrence 获取进行整理"
+     * 2. 有过期 recently_memory 且 memory_status='normal'（尚未开始回忆）：
+     *    通知 "有即将遗忘记忆得整理，请通过 memory_recurrence 进行回忆"
+     */
+    private buildMemoryRecurrenceNotification;
     /**
      * 构建 Memory 文件变更检测通知。
      * Memory 增强功能 (v1.6.0)
@@ -344,6 +402,12 @@ export declare class McpServer {
      * 后台定时器启用后，poll_message 不再重复检查，避免重复推送通知。
      */
     private startMemoryFileWatcher;
+    /**
+     * 构建短期记忆 TODO 通知。
+     * 主流程：调用服务端 list_by_todo_status({ todo_status: 'pending' }) 获取 pending 待办 -> 注入提醒。
+     * v1.13.0: 由服务端 memory_status 字段管理 todo 状态，TS 侧不再维护本地缓存。
+     */
+    private buildMemoryTodoNotification;
     /**
      * 停止后台 Memory 文件变更检测定时器。
      */

package/package/aws-client-agent-mcp/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}