aws-runtime-bridge 1.9.91 → 1.9.93

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

@@ -1,9 +1,5 @@
-/**
- * Agent MCP Client 类型定义
- */
-/**
- * Token 用量明细
- */
+
+
 export interface TokenUsage {
     input: number;
     output: number;
@@ -13,60 +9,52 @@ export interface TokenUsage {
         write: number;
     };
 }
-/**
- * 模型信息
- */
+
 export interface ModelInfo {
     provider: string;
     model: string;
-    /** 模型上下文窗口上限（token 数） */
+    
     contextLimit: number;
-    /** 模型最大输出 token 数 */
+    
     maxOutput?: number;
-    /** 模型最大输入 token 数（部分模型 input/output 分开限制） */
+    
     maxInput?: number;
 }
-/**
- * 会话上下文统计
- */
+
 export interface ContextStats {
-    /** 当前会话已使用的 token 总数 */
+    
     totalUsed: number;
-    /** 输入 token 累计 */
+    
     totalInput: number;
-    /** 输出 token 累计 */
+    
     totalOutput: number;
-    /** 模型上下文窗口上限 */
+    
     contextLimit: number;
-    /** 剩余可用 token */
+    
     remaining: number;
-    /** 使用百分比 0-100 */
+    
     usagePercent: number;
-    /** 是否已触发溢出警告 */
+    
     overflowWarning: boolean;
-    /** 最后一次溢出检测时间 */
+    
     lastChecked?: string;
 }
-/**
- * 压缩策略
- */
+
 export type CompactionStrategy = "prune" | "summarize" | "auto";
-/**
- * 压缩结果
- */
+
 export interface CompactionResult {
     strategy: CompactionStrategy;
-    /** 释放的 token 数 */
+    
     freedTokens: number;
-    /** 保留的完整对话轮次 */
+    
     preservedTurns: number;
-    /** 被压缩的消息数 */
+    
     compactedMessages: number;
-    /** 压缩后剩余 token */
+    
     remainingTokens: number;
-    /** 压缩摘要（summarize 策略时） */
+    
     summary?: string;
-    /** 压缩时间 */
+    
     timestamp: string;
 }
 export interface AgentConfig {
@@ -76,12 +64,10 @@ export interface AgentConfig {
     workspacePath: string;
     prompt: string;
     describe: string;
-    /** Agent 绑定的模型信息，用于上下文窗口检测 */
+    
     modelInfo?: ModelInfo;
 }
-/**
- * YAML 角色配置（原 AgentRoleTemplate → AgentProfileTemplate）
- */
+
 export interface YmlAgentProfileTemplate {
     name: string;
     path: string;
@@ -99,62 +85,34 @@ export interface ServerConfig {
     heartbeatInterval: number;
     heartbeatTimeout?: number;
     reconnectInterval: number;
-    /** 指数退避最大间隔（毫秒），默认 30s */
+    
     reconnectMaxInterval?: number;
-    /** 指数退避随机抖动范围（毫秒），默认 1000 */
+    
     reconnectJitterMs?: number;
-    /**
-     * 最大重连次数。
-     * -1 表示无限重试。
-     */
+    
     maxReconnectAttempts: number;
-    /**
-     * 调度器下发给 runtime bridge 的访问令牌，MCP HTTP 调用会随请求携带。
-     */
+    
     runtimeAccessToken?: string;
     runtimeAccessTokenExpiresAt?: string;
-    /**
-     * 运行时令牌归属用户 ID，用于 bridge 按 userId + serverIp 读取本地令牌。
-     */
+    
     userId?: string;
-    /**
-     * 当前机器 runtime-bridge 地址；当 runtimeAccessToken 缺失时用于向 bridge 申请。
-     */
+    
     runtimeBridgeBaseUrl?: string;
-    /**
-     * 可选：MCP HTTP 调用地址。
-     * 支持完整地址（推荐），若仅提供主机地址会自动补全为 /mcp/call。
-     */
+    
     mcpHttpUrl?: string;
-    /**
-     * 后台 runtime token 主动刷新间隔，毫秒。用于在 24h 服务端 TTL 过期前稳定续期。
-     */
+    
     runtimeTokenRefreshIntervalMs?: number;
-    /**
-     * MCP HTTP 请求硬超时，毫秒。避免 fetch 半开或服务端卡住导致工具调用永久挂起。
-     */
+    
     mcpHttpRequestTimeoutMs?: number;
-    /**
-     * MCP HTTP 请求失败重试间隔，毫秒。默认 5000（5 秒）。
-     */
+    
     mcpRetryIntervalMs?: number;
-    /**
-     * MCP HTTP 请求失败累计最大重试时间，毫秒。默认 30000（30 秒）。
-     * 设置为 0 可禁用重试。
-     */
+    
     mcpRetryMaxAccumulatedMs?: number;
-    /**
-     * 最近一次已尝试强制刷新的被拒绝 runtime token。
-     */
+    
     lastForceRefreshAttemptedForToken?: string;
-    /**
-     * 当前共享 runtime token 刷新任务。
-     * 主流程：HTTP 与 WebSocket 共用该 promise，避免同一 MCP 进程内并发刷新轮换互相作废 token。
-     */
+    
     runtimeAccessTokenRefreshPromise?: Promise<void>;
-    /**
-     * 当前共享刷新任务是否为强制刷新。
-     */
+    
     runtimeAccessTokenRefreshForce?: boolean;
 }
 export interface RuntimeLaunchBinding {
@@ -217,13 +175,13 @@ export interface GroupMessage {
     roomId?: string;
     content: string;
     timestamp: string;
-    /** 上下文压缩：该消息的 token 用量 */
+    
     tokens?: TokenUsage;
-    /** 上下文压缩：发送方使用的模型信息 */
+    
     modelInfo?: ModelInfo;
-    /** 上下文压缩：是否已被压缩（内容为摘要） */
+    
     compacted?: boolean;
-    /** 上下文压缩：被压缩后的摘要（原文保留在服务端） */
+    
     compactionSummary?: string;
 }
 export interface GroupMessagesResponse {
@@ -231,15 +189,9 @@ export interface GroupMessagesResponse {
     currentReadPos: number;
     hasMore: boolean;
 }
-/**
- * 绑定文件的逐文件状态，用于 memory_file_change 自动委托时标注每个文件。
- * - no_change: MD5 与基线一致
- * - content_changed: 文件存在但 MD5 与基线不一致
- * - not_found: 文件读取不到（被删除/移动）
- * - no_baseline: 该文件无可用基线（新增绑定尚未建基线，或基线键不匹配），无法判定变更
- */
+
 export type BoundFileStatus = 'no_change' | 'content_changed' | 'not_found' | 'no_baseline';
-/** 单条绑定文件的路径与状态。 */
+
 export interface BoundFileStatusEntry {
     path: string;
     status: BoundFileStatus;
@@ -255,34 +207,29 @@ export interface DirectMessage {
     content: string;
     requireReply: boolean;
     prompt?: string;
-    /** 消息角色：system=系统指令，user=用户/其他Agent，assistant=本Agent
-     *  role=system 的消息应被 AI 客户端作为系统提示词（system message）处理，
-     *  而非普通对话消息。用于实现多条 system prompt 的分层注入。 */
+    
     role?: 'system' | 'user' | 'assistant';
     timestamp: string;
-    /** 上下文压缩：该消息的 token 用量 */
+    
     tokens?: TokenUsage;
-    /** 上下文压缩：发送方使用的模型信息 */
+    
     modelInfo?: ModelInfo;
-    /** 上下文压缩：是否已被压缩（内容为摘要） */
+    
     compacted?: boolean;
-    /** 上下文压缩：被压缩后的摘要（原文保留在服务端） */
+    
     compactionSummary?: string;
-    /** ACode 自动委托：当 ACodeRuntime 识别到此标记时，自动 spawn 子 agent 处理 memory 任务 */
+    
     _acodeAutoDelegate?: {
         type: 'memory_expiration' | 'memory_file_change' | 'memory_cleanup';
         uris: string[];
-        /**
-         * 仅 memory_file_change 类型使用：每个 URI 对应的绑定文件与变更文件详情。
-         * 让子 agent 无需先调用 read_memory 即可知晓每个 memory 绑定了哪些文件、本次哪个文件发生变更。
-         */
+        
         fileChanges?: Array<{
             uri: string;
-            /** 该 memory 当前绑定的全部文件路径（MemoryRecord.bound_files） */
+            
             boundFiles?: string[];
-            /** 本次检测到发生变更的文件路径列表（含状态注释，如 " (文件找不到)"、" (内容变更)"） */
+            
             changedFiles?: string[];
-            /** 每个绑定文件的逐文件状态（无变更/内容变更/文件找不到），供子 agent 提示词逐文件标注 */
+            
             fileStatuses?: BoundFileStatusEntry[];
         }>;
     };
@@ -322,10 +269,7 @@ export interface WebSocketMessage<T = unknown> {
     data: T;
     timestamp: string;
 }
-/**
- * PROFILE_INFO 消息类型
- * 用于在 Agent 连接时自动推送 profile 信息
- */
+
 export declare const TYPE_PROFILE_INFO = "PROFILE_INFO";
 export type MessageHandler = (message: DirectMessage | GroupMessage) => Promise<string | undefined>;
 export interface AgentState {
@@ -427,9 +371,9 @@ export interface HireBatchResult {
     summary: HireBatchSummary;
     results: HireBatchItemResult[];
 }
-/** MCP 工具名称枚举 */
+
 export type McpToolName = "get_colleague" | "get_group_rooms" | "get_profile" | "hire_colleague" | "hire_colleagues_batch" | "send_group" | "send_private" | "poll_message" | "get_message" | "get_dm_history" | "get_group_history" | "start_listening" | "stop_listening";
-/** send_private 工具参数 */
+
 export interface SendPrivateArgs {
     targetId: string;
     content: string;
@@ -437,43 +381,40 @@ export interface SendPrivateArgs {
     replyToCallId?: string;
     timeoutMs?: number;
 }
-/** send_group 工具参数 */
+
 export interface SendGroupArgs {
     content: string;
     projectName?: string;
     roomId?: string;
 }
-/** get_dm_history 工具参数 */
+
 export interface GetDmHistoryArgs {
     targetUserId?: string;
     limit?: number;
     since?: string;
 }
-/** get_group_history 工具参数 */
+
 export interface GetGroupHistoryArgs {
     roomId?: string;
     limit?: number;
     since?: string;
 }
-/** create_task_instance_comment 工具参数 */
+
 export interface TaskInstanceCommentArgs {
     taskInstanceId: string;
     content: string;
 }
-/** poll_message 返回结果 */
+
 export interface PollMessageResult {
-    /** 系统级消息（role=system），应作为系统提示词处理而非普通对话消息。
-     *  与 directMessages/groupMessages 不同，这些消息的 role='system'，
-     *  AI 客户端应将它们按 system message 注入到上下文中。
-     *  顺序：第一条为全局系统提示词，后续为启动记忆等。 */
+    
     systemMessages?: DirectMessage[];
     directMessages: DirectMessage[];
     groupMessages: GroupMessage[];
     fromBuffer: boolean;
 }
-/** Agent 动作类型 */
+
 export type AgentActionType = "skill" | "mcp" | "idle" | "edit_file" | "write_file" | "read_file" | "bash" | "search" | "web" | "thinking" | "tool_using";
-/** Agent 状态更新消息 */
+
 export interface AgentStatusUpdate {
     agentId: string;
     status: "running" | "starting" | "waiting_input" | "thinking" | "tool_using" | "stopped" | "error";

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

@@ -1,7 +1,4 @@
-/**
- * WebSocket 客户端模块
- * 负责与调度中心建立和维护 WebSocket 连接
- */
+
 import { EventEmitter } from 'node:events';
 import WebSocket from 'ws';
 import type { ServerConfig } from './types.js';
@@ -15,171 +12,79 @@ export declare class WebSocketClient extends EventEmitter {
     private reconnectTimer;
     private isManualClose;
     private websocketFactory;
-    /** 已尝试刷新过的 token，仅当真正拿到新 token 时记录，用于 hammer 保护 */
+    
     private lastRefreshedToken;
-    /** 1008 token 刷新连续失败次数，达到上限后终止重连 */
+    
     private consecutiveRefreshFailures;
     private logBatchQueue;
     private logBatchTimer;
     private logSequenceNumber;
     private pendingLogBatches;
     private isProcessingLogBatch;
-    /**
-     * 已处理的 reliable 消息 ID（msgId → 处理时间戳）。
-     * 用于对冲服务端 ACK 超时/丢失导致的消息重投，覆盖所有 reliable 事件类型，
-     * 而非仅靠下游 MessageBuffer 对私信/群聊的去重。
-     */
+    
     private processedMsgIds;
     constructor(config: ServerConfig, websocketFactory?: (url: string) => WebSocket);
-    /**
-       * 建立 WebSocket 连接
-       * 主流程：准备连接 -> 创建连接 -> 设置事件监听
-       */
+    
     connect(agentId: string): Promise<void>;
-    /**
-     * 准备连接前的状态清理
-     */
+    
     private prepareConnection;
-    /**
-     * 构建 WebSocket URL
-     */
+    
     private buildWebSocketUrl;
     private maskRuntimeTokenInUrl;
-    /**
-     * 创建一次性 resolve/reject 处理器
-     */
+    
     private createSettledHandlers;
-    /**
-     * 设置 WebSocket 事件监听器
-     */
+    
     private setupWebSocketEventHandlers;
-    /**
-     * 处理 WebSocket 打开事件
-     */
+    
     private handleWebSocketOpen;
-    /**
-     * 处理 WebSocket 消息
-     *
-     * 可靠消息去重：服务端 ReliableMessageDeliveryService 在 ACK 超时（5s）或丢失时会
-     * 重发同一 messageId 的消息（最多 3 次 + 用户上线重投）。接收方若不区分重投与
-     * 首次投递，会对同一事件（如 agentStatus、profileInfo 等）重复处理。
-     * 这里在 ACK 之前检查 messageId 是否已处理过：
-     *   - 重复消息：仍回 ACK（避免服务端继续重试堆积），但跳过 handleMessage；
-     *   - 新消息：记录 messageId，回 ACK，正常处理。
-     */
+    
     private handleWebSocketMessage;
-    /**
-     * 提取 reliable 消息的 messageId。
-     * 仅当 data 为对象、含非空 _msgId 且 _requireAck 为真时返回 messageId，否则返回 null。
-     */
+    
     private extractReliableMessageId;
-    /**
-     * 标记 messageId 为已处理。
-     * 返回 true 表示该 messageId 此前已被处理过（重复投递），false 表示首次处理。
-     * 超出上限时淘汰最旧记录，避免内存无界增长。
-     */
+    
     private markMsgIdProcessed;
     private acknowledgeReliableMessage;
-    /**
-     * 处理 WebSocket 关闭事件
-     */
+    
     private handleWebSocketClose;
-    /**
-     * WebSocket 1008（token 失效）时的反应式刷新。
-     * 修复死循环：旧实现在刷新失败时仍用旧 token 立即重连，导致被 1008 反复拒绝、
-     * 200ms 无限重连且 Agent 永远 offline。新实现：
-     *  - 仅当拿到【新】token 时才视为刷新成功并立即重连；
-     *  - 服务端返回 token 不变（unchanged）说明换 token 无法解决 1008，直接终止重连，避免死循环；
-     *  - 刷新失败（网络/超时/异常）计入连续失败次数，达到上限后终止重连并上报事件，
-     *    交由上层 supervisor 重启，而非用旧 token 无限重试。
-     */
+    
     private handleTokenExpiredAndReconnect;
-    /**
-     * 向 bridge 请求刷新 runtimeAccessToken（forceRefresh 模式）。
-     * 返回：
-     *  - 'refreshed'：成功拿到【新】token 并已更新 config；
-     *  - 'unchanged'：服务端返回 token 与当前一致（换 token 无法解决 1008）；
-     *  - 'failed'：刷新请求失败（网络/超时/非 2xx/异常）。
-     * 仅当真正获得新 token 时才记录 lastRefreshedToken（hammer 保护），
-     * 失败时不再把当前 token 标记为"已刷新"，从而允许后续在退避约束下重试。
-     */
+    
     private refreshRuntimeTokenOnPolicyRejection;
-    /**
-     * 处理 WebSocket 错误事件
-     */
+    
     private handleWebSocketError;
-    /**
-     * 断开 WebSocket 连接
-     */
+    
     disconnect(): void;
-    /**
-     * 发送消息
-     */
+    
     send(message: unknown): boolean;
-    /**
-     * 上报 MCP Node.js 进程启动后的运行日志（批处理模式）。
-     * 日志先入队，每 100ms 节流窗口内累积后批量发送，
-     * 等待 bridge 返回 LOG_ACK 确认后再发送下一批。
-     */
+    
     sendMcpNodeLog(data: {
         level: string;
         message: string;
         timestamp: string;
     }): boolean;
-    /**
-     * 刷新日志批次：取出队列中的日志，按序列号打包发送。
-     * 等待 bridge 返回 LOG_ACK 后方可发送下一批。
-     */
+    
     private flushLogBatch;
-    /**
-     * 发送日志批次（实际发送 + 重试逻辑）
-     */
+    
     private sendLogBatch;
-    /**
-     * 处理日志批次发送失败（重试或放弃）
-     */
+    
     private handleLogBatchSendFailure;
-    /**
-     * 处理 LOG_ACK 确认。
-     * 收到 bridge 对某序列号日志批次的确认后，标记该批次完成，继续发送下一批。
-     */
+    
     private handleLogAck;
-    /**
-     * 是否已连接
-     */
+    
     isConnected(): boolean;
-    /**
-     * 处理接收到的消息
-     */
+    
     private handleMessage;
-    /**
-     * 启动心跳
-     */
+    
     private startHeartbeat;
-    /**
-     * 停止心跳
-     */
+    
     private stopHeartbeat;
     private sendProtocolPing;
     private markHeartbeatReceived;
     private ensureHeartbeatTimeout;
     private clearHeartbeatTimeout;
     private resolveHeartbeatTimeout;
-    /**
-     * 安排重连（指数退避 + 随机抖动）
-     *
-     * 主流程：校验重连上限 -> 计算指数退避间隔（含抖动）-> 延迟后重连
-     *
-     * 退避公式：baseDelay = min(reconnectInterval * 2^(attempt-1), reconnectMaxInterval)
-     *          jitter    = random(0, reconnectJitterMs)
-     *          delay     = baseDelay + jitter
-     *
-     * 首次重连 (attempt=1)：baseDelay = reconnectInterval（200ms），与之前行为一致
-     * 后续重连指数递增，上限 30s + 1s 随机抖动，避免重连风暴
-     */
+    
     private scheduleReconnect;
-    /**
-     * 清除重连定时器
-     */
+    
     private clearReconnectTimer;
 }

package/package/cc-switch-sdk/dist/index.d.ts

@@ -1,9 +1,4 @@
-/**
- * @cc-switch/sdk - 纯配置管理 SDK
- *
- * 负责 MCP/Skill 的 CRUD 操作和状态管理。
- * 注意：adapters 需要外部注入，SDK 不提供默认实现。
- */
+
 import type { AppId, AppFlags, McpServer, McpServerSpec, InstalledSkill, SkillSyncMethod, SdkOptions, SdkPaths, SdkState, IMcpAdapter, ISkillAdapter, AdapterOverrides } from "./types.js";
 import { CcSwitchSdk } from "./sdk.js";
 import { AiConfigService, buildToolSpecificAiConfig, type AiConfigTemplate, type ClaudeCodeConfig, type CodexConfig, type OpenCodeConfig, type AiConfigPaths } from "./services/ai-config-service.js";

package/package/cc-switch-sdk/dist/sdk.d.ts

@@ -8,16 +8,7 @@ export declare class CcSwitchSdk {
     private readonly skillAdapters;
     private state;
     private operationQueue;
-    /**
-     * 创建 CcSwitchSdk 实例
-     *
-     * 注意：adapters 必须通过 options.adapters 注入，
-     * cc-switch-sdk 不再提供默认的 adapter 实现。
-     *
-     * @param options - SDK 配置选项
-     * @param options.adapters.mcp - MCP 适配器映射（必需）
-     * @param options.adapters.skill - Skill 适配器映射（必需）
-     */
+    
     constructor(options: SdkOptions);
     private executeExclusive;
     load(): Promise<void>;
@@ -37,22 +28,13 @@ export declare class CcSwitchSdk {
     deleteMcpServer(id: string): Promise<void>;
     toggleMcpApp(serverId: string, appId: AppId, enabled: boolean): Promise<McpServer>;
     importMcpFromApps(): Promise<number>;
-    /**
-     * 从单个应用导入 MCP 服务器
-     */
+    
     private importMcpFromApp;
-    /**
-     * 处理导入的 MCP 服务器（合并或创建）
-     * @returns 是否为新创建的 MCP
-     */
+    
     private processImportedMcp;
-    /**
-     * 根据名称查找 MCP 服务器
-     */
+    
     private findMcpServerByName;
-    /**
-     * 创建带有应用标记的 MCP 服务器
-     */
+    
     private createMcpWithAppFlag;
     getAllSkills(): InstalledSkill[];
     getSkillById(id: string): InstalledSkill | undefined;
@@ -61,30 +43,17 @@ export declare class CcSwitchSdk {
     uninstallSkill(id: string): Promise<void>;
     toggleSkillApp(skillId: string, appId: AppId, enabled: boolean): Promise<InstalledSkill>;
     importSkillsFromApps(): Promise<number>;
-    /**
-     * 从单个应用导入 Skills
-     */
+    
     private importSkillsFromApp;
-    /**
-     * 处理导入的 Skill（合并或创建）
-     * @returns 是否为新创建的 Skill
-     */
+    
     private processImportedSkill;
-    /**
-     * 根据名称查找 Skill
-     */
+    
     private findSkillByName;
-    /**
-     * 合并已存在的 Skill
-     */
+    
     private mergeExistingSkill;
-    /**
-     * 创建新导入的 Skill
-     */
+    
     private createNewImportedSkill;
-    /**
-     * 创建带有应用标记的 Skill
-     */
+    
     private createSkillWithAppFlag;
     getPaths(): SdkPaths;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aws-runtime-bridge",
-  "version": "1.9.91",
+  "version": "1.9.93",
   "description": "AgentsWorkStudio runtime bridge service for machine-level agent runtime integration",
   "type": "module",
   "main": "dist/index.js",