aws-runtime-bridge 1.9.92 → 1.9.93

package/package/acode/dist/types.d.ts

@@ -48,13 +48,10 @@ export interface ACodeSkillMetadata {
     name: string;
     description?: string;
     directory: string;
-    /** SKILL.md body 内容（frontmatter 之后的完整 markdown 文本），供 SkillTool 加载 */
+    
     content: string;
 }
-/**
- * 单个 skills 目录的加载结果：包含目录路径、是否存在、以及该目录下的 skills 列表。
- * 即使目录不存在也会返回（exists=false, skills=[]），供前端展示空节点。
- */
+
 export interface ACodeSkillGroup {
     dir: string;
     exists: boolean;
@@ -107,69 +104,51 @@ export interface ACodeRuntimeConfig {
     skillsDir?: string;
     initialPrompt?: string;
     model?: string;
-    /** 模型推理强度（minimal|low|medium|high|xhigh），由 bridge 通过 instanceAiConfig 注入 */
+    
     effort?: string;
     systemPrompt?: string;
-    /** 全局提示词（System 1） */
+    
     globalPrompt?: string;
-    /** 角色提示词（System 2） */
+    
     rolePrompt?: string;
-    /** 记忆内容（System 3） */
+    
     memory?: string;
     env?: Record<string, string>;
     commandDirs?: string[];
     hooks?: ACodeHookHandler[];
     permissions?: ACodePermissionConfig;
-    /** 可选：sub-agent 管理器句柄，注入后启用 sub-agent 工具集（sub_agent/list_sub_agents/get_sub_agent_status/await_sub_agents/abort_sub_agent） */
+    
     subAgentManager?: SubAgentManager;
-    /**
-     * 可选：共享的 MCP 连接（由父 agent 注入）。
-     * 设置后子 agent 跳过 connectMcpServers，直接复用父 agent 的 MCP 连接，
-     * 避免子 agent 启动新的 MCP server 进程后因 launch binding 已被消费而 401。
-     * stop() 时不会关闭共享连接（由创建者管理生命周期）。
-     */
+    
     sharedMcpConnections?: ACodeMcpConnection[];
-    /** Sub Agent 模型覆盖（空值=继承主 Agent 模型） */
+    
     subAgentModel?: string;
-    /** Sub Agent 思考强度覆盖（空值=继承主 Agent 强度） */
+    
     subAgentEffort?: string;
-    /**
-     * Sub Agent 类型（general | explore）。
-     * - general：完整工具权限（可读写工作区文件）
-     * - explore：只读模式，过滤掉会修改工作区文件的内建工具
-     *   （write_file/edit_file/delete_file/Bash），仅保留 read_file/grep/symbols
-     *   等只读工具 + memory MCP 工具。MCP 工具白名单由
-     *   SUB_AGENT_ALLOWED_MCP_TOOLS 独立施加，此处不重复。
-     *   未设置时视为 general（向后兼容）。
-     */
+    
     subagentType?: SubAgentType;
-    /**
-     * 可选：Agent 文件操作变更回调。
-     * 当 Agent 调用 write_file/edit_file/delete_file 工具时，
-     * 执行前后会调用此回调上报精确变更记录（供 bridge 差异回滚使用）。
-     */
+    
     onFileChange?: import("./built-in-file-tools.js").OnAgentFileChange;
 }
 export interface ACodeResolvedProviderConfig {
     model: string;
     baseURL?: string;
     apiKey?: string;
-    /** 模型推理强度（minimal|low|medium|high|xhigh），写入 API 请求体的 reasoning_effort 字段 */
+    
     effort?: string;
     systemPrompt?: string;
     stream: boolean;
     requestTimeoutMs: number;
-    /** 单次 provider 请求的总时长上限（毫秒）。0 表示不设总时长上限，仅靠 requestTimeoutMs 的分段/空闲超时保护。 */
+    
     requestTotalTimeoutMs: number;
     requestRetryCount: number;
     mcpToolTimeoutMs: number;
     mcpPollingToolTimeoutMs: number;
     supportsImageInput: boolean;
-    /** 上下文窗口大小（token），优先于硬编码查找表 */
+    
     contextLimit?: number;
-    /** 输入 token 上限（部分 Provider 的 input+output 总额 ≠ context 上限）。
-     *  设置后压缩阈值基于 inputLimit 计算，更精确。未配置时降级到 contextLimit。 */
+    
     inputLimit?: number;
-    /** 最大输出 token 数，优先于硬编码查找表 */
+    
     maxOutput?: number;
 }

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

@@ -1,7 +1,4 @@
-/**
- * Agent 客户端核心模块
- * 负责与调度中心通信，管理消息循环
- */
+
 import type { MemoryStats } from "./memory-store.js";
 import { StatusReporter } from "./status-reporter.js";
 import type { AgentConfig, DirectMessage, DmHistoryResponse, FetchUnreadMessagesOptions, FinishTaskRollbackArgs, GroupHistoryResponse, GroupRoomsResponse, HireBatchResult, HireColleagueArgs, HireColleaguesBatchArgs, HiredColleagueResult, MessageHandler, OnlineListResponse, ProfileInfo, RegisterResult, SendDmResult, SendMessageResult, StartTaskRollbackArgs, TaskInstanceCommentArgs, UnreadMessagesResult } from "./types.js";
@@ -21,181 +18,89 @@ export declare class AgentClient {
     private pollTimer;
     private statusReporter;
     private newCharacterHandler;
-    /** runtime token 主动续期定时器（补全已配置但未接线的 12h 刷新） */
+    
     private runtimeTokenRefreshTimer;
-    /**
-     * Profile 缓存
-     * 用于处理 PROFILE_INFO 消息在 profileHandler 设置之前到达的情况
-     */
+    
     private cachedProfile;
     constructor();
     initialize(): Promise<void>;
     private setupWebSocketListeners;
-    /**
-     * 注册 Agent 上线
-     */
+    
     register(): Promise<RegisterResult>;
     private hasPresetAgentId;
-    /**
-     * 使用预设 AgentID 注册（绑定已有实例）
-     */
+    
     private registerWithExistingAgentId;
-    /**
-     * 作为新 Agent 注册
-     */
+    
     private registerAsNewAgent;
-    /**
-     * 注销 Agent 下线
-     */
+    
     unregister(): Promise<void>;
-    /**
-     * 获取当前 Agent 可见的同事列表（包含离线 Agent）。
-     */
+    
     discoverColleagues(): Promise<OnlineListResponse>;
-    /**
-     * 获取当前 Agent 在关系图中可发现的群组列表。
-     */
+    
     discoverGroupRooms(): Promise<GroupRoomsResponse>;
-    /**
-     * 招聘同事并创建新的 Agent 实例。
-     * 主流程：校验当前实例已注册 -> 透传创建角色参数到服务端 MCP tool -> 返回新实例信息。
-     */
+    
     hireColleague(args: HireColleagueArgs): Promise<HiredColleagueResult>;
-    /**
-     * 批量发起招聘审批请求。
-     * 主流程：校验当前实例已注册 -> 透传批量招聘参数到服务端 MCP tool -> 返回整批审批与创建结果。
-     */
+    
     hireColleaguesBatch(args: HireColleaguesBatchArgs): Promise<HireBatchResult>;
-    /**
-     * 调用需要当前 Agent 实例身份的 server MCP tool。
-     * 主流程：确认已注册 -> 自动附加 agentId -> 复用带 runtime token 的 HTTP 通道。
-     */
+    
     callAgentScopedTool<T = unknown>(toolName: string, args: Record<string, unknown>): Promise<T>;
-    /**
-     * 上报当前 MCP 本地合并后的记忆统计。
-     * 主流程：自动附加 agentId -> 交给 server 广播给 Dashboard，避免前端只看到 server 实例级统计。
-     */
+    
     reportMemoryStats(memoryStats: MemoryStats): Promise<void>;
-    /**
-     * 发送群消息
-     * @param content 消息内容
-     * @param projectName 目标项目名，不传则使用 Agent 所属项目（由服务端决定）
-     * @param roomId 目标群房间 ID，小组群场景下优先使用以避免误发到项目公共群
-     */
+    
     sendGroupMessage(content: string, projectName?: string, roomId?: string): Promise<SendMessageResult>;
-    /**
-     * 发送私信
-     *
-     * waitReply=true（调用式）时使用 callToolOnce 替代 callTool，原因：
-     * - callTool 的全局 HTTP 超时固定为 120s（DEFAULT_MCP_HTTP_REQUEST_TIMEOUT_MS），
-     *   无法匹配服务端 sendCallAndWaitReply 的较长等待时间
-     * - callTool 的重试循环（累计最多重试 30s）在服务端排队 503 时还可能额外拖累
-     * - callToolOnce 无自动重试、支持自定义超时，与服务端阻塞等待语义一致
-     */
+    
     sendDirectMessage(targetId: string, content: string, waitReply?: boolean, replyToCallId?: string, timeoutMs?: number): Promise<SendDmResult>;
-    /**
-     * 发送私信并等待回复（阻塞式）
-     */
+    
     sendCallAndWaitReply(targetId: string, content: string, timeoutMs?: number): Promise<DirectMessage>;
-    /**
-     * 回复调用式消息
-     */
+    
     replyToCall(callId: string, targetId: string, content: string): Promise<SendDmResult>;
-    /**
-     * 获取私信历史消息
-     */
+    
     getDmHistory(targetUserId?: string, limit?: number, since?: string): Promise<DmHistoryResponse>;
-    /**
-     * 获取群消息历史记录
-     */
+    
     getGroupHistory(limit?: number, roomId?: string, since?: string): Promise<GroupHistoryResponse>;
-    /**
-     * 拉取当前 Agent 尚未消费的未读消息。
-     * 主流程：校验注册状态 -> 获取未读私信 -> 获取未读群消息 -> 合并返回。
-     * @param since 可选的起始时间（ISO 8601），早于该时间的消息将被过滤
-     */
+    
     fetchUnreadMessages(options?: FetchUnreadMessagesOptions): Promise<UnreadMessagesResult>;
-    /**
-     * 拉取服务端私信并对 poll_message 长轮询做容错处理。
-     * 主流程：针对 poll_message 使用 callToolOnce（单次长阻塞，无重试干扰）；
-     *         非 poll_message 工具走 callTool（标准带重试逻辑）。
-     *         callToolOnce 超时后转为空结果，让 hydrateUnreadMessagesUntilAvailable 继续等待。
-     */
+    
     private fetchDirectMessagesWithRecovery;
-    /**
-     * 判断是否为 poll_message 长轮询的可恢复失败。
-     * 主流程：只匹配明确的 HTTP 503 或客户端硬超时，避免吞掉业务工具错误或认证错误。
-     */
+    
     private isRecoverableLongPollError;
-    /**
-     * 规范化服务端群消息响应。
-     * 主流程：只接受数组中的完整群消息对象，忽略 401/空响应/异常元素，避免补拉消息时崩溃。
-     */
+    
     private normalizeGroupMessages;
-    /**
-     * 收集当前项目下 Agent 可访问的群房间 ID，避免离线补拉和历史查询遗漏小组群。
-     */
+    
     private collectRoomIds;
-    /**
-     * 获取当前 Agent 的个人信息
-     */
+    
     getProfile(): Promise<ProfileInfo>;
     private getProfileByAgentId;
-    /**
-     * 获取当前 Agent 被分配的流程线任务列表
-     */
+    
     getMyTasks(): Promise<unknown[]>;
-    /**
-     * 创建流程线实例级留言。
-     * 主流程：确认已注册 -> 自动附加 agentId -> 服务端校验当前 Agent 正在处理该实例节点。
-     */
+    
     createTaskInstanceComment(args: TaskInstanceCommentArgs): Promise<unknown>;
-    /**
-     * 提交流程线任务结果
-     * @param changeLog 可选。本次任务处理期间产生的文件/内容变更日志，服务端会在节点翻转状态前持久化，供 AI 回退使用。
-     */
+    
     submitTaskResult(nodeId: string, outputPayload: string, changeLog?: unknown[]): Promise<unknown>;
-    /**
-     * 将分配给当前 Agent 的 AI 回退任务标记为回退中。
-     */
+    
     startTaskRollback(args: StartTaskRollbackArgs): Promise<unknown>;
-    /**
-     * 将分配给当前 Agent 的 AI 回退任务标记为已回退，并写入结果说明。
-     */
+    
     finishTaskRollback(args: FinishTaskRollbackArgs): Promise<unknown>;
-    /**
-     * 拒绝流程线任务
-     */
+    
     rejectTask(nodeId: string, reason: string): Promise<unknown>;
-    /**
-     * 终止流程线任务（终止后不再流转）
-     */
+    
     terminateTask(taskInstanceId: string, reason: string): Promise<unknown>;
-    /**
-     * 启动消息监听
-     */
+    
     start(handler: MessageHandler, options?: {
         pollMode?: boolean;
         profileHandler?: ProfileHandler;
     }): void;
-    /**
-     * 停止消息监听
-     */
+    
     stop(): void;
     private messageLoop;
     private handleIncomingDm;
     private handleIncomingGroup;
-    /**
-     * 处理收到的 Profile 信息
-     * 由服务端在 Agent 连接时自动推送
-     */
+    
     private handleProfileInfo;
     private processMessage;
     private ensureRegistered;
     private delay;
-    /**
-     * 注册新角色回调：当 registerAsNewAgent 返回 isExisting === false 时触发。
-     */
+    
     onNewCharacter(handler: () => void): void;
     getState(): {
         agentId: string | null;
@@ -206,43 +111,21 @@ export declare class AgentClient {
     };
     getAgentConfig(): AgentConfig;
     reloadConfig(): void;
-    /**
-     * 进入降级模式
-     * 当注册失败时，Agent 可以降级运行，等待后续重试注册
-     */
+    
     enterDegradedMode(): void;
-    /**
-     * 退出降级模式
-     * 当重连成功时，退出降级模式
-     */
+    
     exitDegradedMode(): void;
-    /**
-     * 是否处于降级模式
-     */
+    
     isInDegradedMode(): boolean;
-    /**
-     * 降级模式下重试注册
-     * 在后台持续尝试重新注册到调度中心
-     */
+    
     retryRegistrationInBackground(retryIntervalMs: number, maxRetries: number): Promise<void>;
-    /**
-     * 初始化状态报告器
-     */
+    
     private initializeStatusReporter;
-    /**
-     * 启动 runtimeAccessToken 主动续期定时器。
-     * 主流程：消费 serverConfig.runtimeTokenRefreshIntervalMs（默认 12h），在服务端 24h TTL 过期前
-     * 通过 bridge refresh-token 端点续期，避免 token 过期后 WebSocket 重连被拒（1008）导致 zombie。
-     */
+    
     private startRuntimeTokenRefresh;
     private stopRuntimeTokenRefresh;
-    /**
-     * 上报 MCP Node.js 进程自身日志。
-     * 主流程：logger 写入 stderr/file -> sink 回调 -> WebSocket 转发给调度中心和面板。
-     */
+    
     private reportMcpNodeLog;
-    /**
-     * 获取状态报告器（供 MCP Server 使用）
-     */
+    
     getStatusReporter(): StatusReporter | null;
 }

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

@@ -1,29 +1,15 @@
-/**
- * 配置管理模块
- * 负责读取环境变量配置
- *
- * 注意：Agent 角色配置（roleName, prompt 等）由后端从 runtime-bridge 获取
- * MCP 客户端只需要传递 workspacePath
- */
+
 import type { AgentConfig, RuntimeLaunchBinding, ServerConfig } from "./types.js";
 export declare class ConfigManager {
     private agentConfig;
     private serverConfig;
-    /**
-     * 加载配置
-     * MCP 客户端只提供 workspacePath，角色配置由后端从 runtime-bridge 获取
-     */
+    
     loadConfig(): void;
     applyRuntimeLaunchBinding(binding: RuntimeLaunchBinding): void;
     private parseRuntimeTokenRefreshInterval;
-    /**
-     * 解析正整数环境变量。
-     * 主流程：读取字符串 -> 转为整数 -> 非法值回退默认值并记录警告。
-     */
+    
     private parsePositiveIntegerEnv;
-    /**
-     * 仅更新 runtimeAccessToken，供 401 恢复时调用。
-     */
+    
     updateRuntimeAccessToken(newToken: string): boolean;
     getAgentConfig(): AgentConfig;
     getServerConfig(): ServerConfig;

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

@@ -1,6 +1,4 @@
-/**
- * 常量定义
- */
+
 export declare const DEFAULT_SERVER_URL = "ws://localhost:8080/ws/agent";
 export declare const DEFAULT_HEARTBEAT_INTERVAL = 15000;
 export declare const DEFAULT_RECONNECT_INTERVAL = 200;

package/package/aws-client-agent-mcp/dist/context-manager.d.ts

@@ -1,138 +1,68 @@
-/**
- * 上下文管理器 — 会话级 Token 追踪、溢出检测与压缩
- *
- * 核心职责：
- * 1. 追踪每轮会话的累计 token 消耗
- * 2. 根据模型上下文窗口判断是否溢出
- * 3. 提供 prune（裁剪旧工具输出）/ summarize（摘要化）两种压缩策略
- * 4. 通过 MemoryStore(session_context) 持久化压缩后的摘要
- *
- * 设计思路（参考 OpenCode compaction.ts）：
- * - 保持 20K token 作为缓冲区，避免溢出前措手不及
- * - Prune 从最旧消息开始累计工具输出，超过保护线后标记 compacted
- * - Summarize 将早期对话结构化为摘要存入 session_context memory
- *
- * 关于模型上下文窗口大小：
- * - 当前版本通过模型名查找表获取（见 MODEL_CONTEXT_LIMITS）
- * - 查找不到时默认使用 128K（保守值）
- * - 后续可通过服务端 AiSourceTemplate 扩展 contextLimit/maxOutput 字段
- */
+
 import type { MemoryStorePort } from "./memory-store.js";
 import type { TokenUsage, ModelInfo, ContextStats, CompactionStrategy, CompactionResult, DirectMessage, GroupMessage } from "./types.js";
-/** 上下文管理器的持久化存储结构，对应 session_context 类型 memory 的 content JSON */
+
 export interface SessionContextRecord {
-    /** 会话标识 */
+    
     sessionId: string;
-    /** 累计 token 消耗 */
+    
     tokens: {
         totalInput: number;
         totalOutput: number;
         totalReasoning: number;
     };
-    /** 模型信息快照 */
+    
     modelInfo?: ModelInfo;
-    /** 最后活动时间 */
+    
     lastActivity: string;
-    /** 压缩历史 */
+    
     compactions: {
         timestamp: string;
         strategy: CompactionStrategy;
         freedTokens: number;
         messageCount: number;
     }[];
-    /** 当前会话是否已触发溢出警告 */
+    
     overflowWarned: boolean;
-    /** 当前会话的消息数量 */
+    
     messageCount: number;
 }
 export declare class ContextManager {
-    /** 内存态会话上下文记录，避免每次查询都读磁盘 */
+    
     private sessions;
     private memoryStore;
     constructor(memoryStore: MemoryStorePort);
-    /**
-     * 根据模型名查找上下文窗口大小。
-     * 公开方法，供外部（如 mcp-server）使用。
-     */
+    
     lookupModelLimits(modelName: string): {
         contextLimit: number;
         maxOutput: number;
     };
-    /**
-     * 粗略估算文本的 token 数。
-     * 不使用真实 tokenizer（太慢），基于字符数乘经验系数。
-     * 对纯 ASCII 约 4 字符/token，对中文约 1.5 字符/token。
-     *
-     * x1.15 安全填充确保本地估算始终偏大（安全侧），
-     * 与 compaction.ts 的 estimateTokens 策略保持一致。
-     */
+    
     estimateTokens(text: string): number;
-    /**
-     * 从 TokenUsage 估算总 token 数。
-     */
+    
     estimateTotalUsage(tokens: TokenUsage): number;
-    /**
-     * 获取或创建会话上下文记录。
-     */
+    
     private getOrCreateSession;
-    /**
-     * 记录一次 token 消耗。
-     */
+    
     recordUsage(sessionId: string, tokens: TokenUsage, modelInfo?: ModelInfo): Promise<void>;
-    /**
-     * 判断当前会话是否上下文溢出。
-     * 逻辑参考 OpenCode SessionCompaction.isOverflow：
-     * - 已用 token >= (contextLimit - maxOutput - COMPACTION_BUFFER)
-     */
+    
     isOverflow(sessionId: string, modelInfo?: ModelInfo): Promise<boolean>;
-    /**
-     * 获取当前会话的上下文统计。
-     */
+    
     getStats(sessionId: string, modelInfo?: ModelInfo): Promise<ContextStats>;
-    /**
-     * Prune：从消息列表中裁剪旧工具的输出内容。
-     *
-     * 算法（参考 OpenCode compaction.ts:50-99）：
-     * 1. 从最新消息往旧遍历
-     * 2. 跳过前 keepLastTurns 轮对话
-     * 3. 遇到已有 summary 标记的助手消息就停止
-     * 4. 累计已完成工具调用的输出 token
-     * 5. 超过 PRUNE_PROTECT 保护线的标记为 compacted
-     * 6. 只有收益超过 PRUNE_MINIMUM 才真正执行
-     *
-     * @param messages 消息列表（从旧到新）
-     * @param keepLastTurns 保留最近的完整轮次
-     * @returns 修剪结果
-     */
+    
     prune(messages: (DirectMessage | GroupMessage)[], keepLastTurns?: number): CompactionResult;
-    /**
-     * 判断消息是否为"用户消息"（用于轮次计数）。
-     * 在 ACode 的上下文中，DirectMessage 我们都是"用户发给 Agent"或"Agent 间"的消息。
-     * 简单启发：判断是否有 requireReply 或消息较短（工具输出通常很长）。
-     */
+    
     private isUserMessage;
-    /**
-     * 获取最后一次压缩的摘要（如有）。
-     */
+    
     getCompactionSummary(sessionId: string): Promise<string | null>;
-    /**
-     * 将会话上下文记录持久化到 MemoryStore。
-     */
+    
     saveToMemory(session: SessionContextRecord): Promise<void>;
-    /**
-     * 从 MemoryStore 加载会话上下文记录。
-     */
+    
     loadFromMemory(sessionId: string): Promise<SessionContextRecord | null>;
-    /**
-     * 保存压缩结果到 MemoryStore。
-     */
+    
     saveCompactionResult(sessionId: string, result: CompactionResult): Promise<void>;
-    /**
-     * 重置溢出警告状态。
-     */
+    
     resetOverflowWarning(sessionId: string): Promise<void>;
-    /**
-     * 清空内存态记录（进程退出或会话切换时调用）。
-     */
+    
     clearSession(sessionId?: string): void;
 }

package/package/aws-client-agent-mcp/dist/context-manager.test.d.ts

@@ -1,5 +1,2 @@
-/**
- * 上下文管理器单元测试
- * 验证 token 估算、溢出检测、prune 策略的核心逻辑
- */
+
 export {};