aws-runtime-bridge 1.9.92 → 1.9.93

package/dist/services/auto-register.d.ts

@@ -1,116 +1,56 @@
-/**
- * Bridge 实例自动注册服务
- *
- * 实现 Bridge 实例启动后自动向调度中心注册的功能
- *
- * 配置来源（优先级从高到低）：
- * 1. 环境变量
- * 2. 用户目录下的 .aws-bridge/config.json 文件
- */
-/**
- * 自动注册配置
- */
+
+
 interface AutoRegisterConfig {
-    /** 是否启用自动注册 */
+    
     enabled: boolean;
-    /** 要主动注册到的调度中心地址 */
+    
     serverUrl?: string;
-    /** 租户 ID（可选，如果提供 userKey 则可自动推导） */
+    
     tenantId?: string;
-    /** 用户 API Key（必填，用于验证身份和自动推导租户） */
+    
     userKey: string;
-    /** 连接 Bridge 机器实例需要的密钥 */
+    
     connectionKey?: string;
-    /** 实例名称（默认使用主机名） */
+    
     instanceName?: string;
-    /** 实例 ID（可选，预声明时发送给 server 作为实例标识；注册成功后自动回填） */
+    
     instanceId?: string;
-    /** 项目名称 */
+    
     projectName?: string;
-    /** 角色名称 */
+    
     roleName?: string;
-    /** 工作空间路径 */
+    
     workspacePath?: string;
-    /**
-     * 注册地址（推荐）
-     * - 支持 `host:port`、纯 `host`（自动补 AWS_RUNTIME_BRIDGE_PORT）、完整 URL（`http://...` / `https://...`，原样使用）
-     * - 优先级高于 registerIp / virtualIp
-     */
+    
     registerAddr?: string;
-    /**
-     * 注册 IP（已废弃，仅做向后兼容回退）
-     * - 仅接受纯 IP/host，端口由 AWS_RUNTIME_BRIDGE_PORT 决定
-     * - 推荐迁移到 registerAddr
-     */
+    
     registerIp?: string;
-    /** 虚拟 IP（EasyTier，兼容旧配置） */
+    
     virtualIp?: string;
-    /**
-     * 是否启用隧道模式（三态）：
-     * - true：显式启用隧道模式，bridge 经 WebSocket 反向连出到 server，
-     *   server 经 /tunnel/{instanceId}/ 虚拟路径反向调用 bridge。
-     * - false：显式禁用隧道模式，即使未填 registerAddr 也走直连（用于 loopback 场景）。
-     * - undefined（默认）：未填 registerAddr/registerIp/virtualIp 时自动判定为隧道模式（向后兼容）。
-     */
+    
     tunnel?: boolean;
-    /** 是否优先选择与 serverUrl 同局域网的本机 IP */
+    
     preferSameLanIp?: boolean;
-    /** 注册重试次数 */
+    
     maxRetries?: number;
-    /** 注册重试间隔（毫秒） */
+    
     retryInterval?: number;
 }
 export declare function getConfiguredConnectionKeys(): string[];
-/** 停止所有后台注册重试（优雅关闭/测试清理用） */
+
 export declare function cancelBackgroundRegisterRetries(): void;
-/**
- * 配置文件路径
- *
- * 默认使用 os.homedir()，但 Windows 服务以 LocalSystem 身份运行时 homedir() 是
- * System32\systemprofile，找不到用户配置 → 不注册 → 不建隧道。
- * 因此优先读 AWS_RUNTIME_HOME_DIR 环境变量（与 getRuntimeHomeDir 一致），
- * 让 `awsb service install` 把当前用户主目录注入到服务环境变量中。
- */
+
 export declare function getAutoRegisterConfigFilePath(): string;
-/**
- * 加载自动注册配置
- *
- * 优先级：环境变量 > 配置文件 > 默认值
- *
- * 如果没有配置文件且没有环境变量，则不启用自动注册
- */
+
 export declare function loadConfig(): AutoRegisterConfig;
 export declare function loadConfigs(): AutoRegisterConfig[];
 export declare function isTunnelConfig(config?: AutoRegisterConfig): boolean;
 export declare function loadPrimaryLifecycleConfig(): AutoRegisterConfig;
-/**
- * 通过入站 runtime token 反查其所属调度中心地址。
- *
- * 场景：调度中心发起 /runtime/start 时，请求头 X-Runtime-Token 携带的是该 server
- * 签发给本 bridge 的实例 token（RuntimeBridgeService.resolveRuntimeBridgeAuthToken）。
- * bridge 本地 scoped token store（runtime-tokens.properties）按 serverUrl 存储这些
- * 实例 token，因此匹配命中即可确定来源 server，避免多 autoRegisterTargets 时回退到
- * DEFAULT_SCHEDULER_BASE_URL（localhost:8080）导致回调打错服务器。
- *
- * 候选来源：所有 autoRegisterTargets 的 serverUrl + binding.json 的 schedulerBaseUrl。
- * 仅在 launch body 未显式携带 schedulerBaseUrl 时作为兜底使用。
- */
+
 export declare function resolveSchedulerBaseUrlFromToken(token: unknown): string | undefined;
-/**
- * 自动注册主函数
- *
- * 带重试机制的注册逻辑
- *
- * 配置来源（优先级从高到低）：
- * 1. 传入的 customConfig
- * 2. 环境变量
- * 3. ~/.aws-bridge/config.json 配置文件
- * 4. 默认值
- */
+
 export declare function autoRegister(customConfig?: Partial<AutoRegisterConfig>): Promise<boolean>;
-/**
- * 注销实例
- */
+
 export declare function requestRuntimeAccessTokenRefresh(): Promise<{
     success: boolean;
     runtimeAccessToken?: string;
@@ -124,9 +64,7 @@ export declare function requestRuntimeAccessTokenRefreshForServer(serverBaseUrl:
     error?: string;
 }>;
 export declare function unregister(): Promise<boolean>;
-/**
- * 获取注册状态
- */
+
 export declare function getRegistrationState(): {
     registered: boolean;
     instanceId?: string;
@@ -134,26 +72,11 @@ export declare function getRegistrationState(): {
     lastAttempt?: Date;
     error?: string;
 };
-/**
- * 检查是否已注册
- */
+
 export declare function isRegistered(): boolean;
-/**
- * 获取实例 ID
- */
+
 export declare function getInstanceId(): string | undefined;
-/**
- * ★★★ Bridge 重启清理
- *
- * 当 aws-runtime-bridge 重启时调用，通知调度中心将该 bridge 关联的所有 Agent 设置为离线。
- *
- * 清理逻辑：
- * 1. 调用调度中心的 /api/instances/bridge-restart-cleanup 接口
- * 2. 传入 instanceId 或 runtimeBridgeBaseUrl
- * 3. 调度中心会将关联的 Agent 设置为 is_online=false, runtime_status='stopped'
- *
- * @returns 清理结果
- */
+
 export declare function bridgeRestartCleanup(): Promise<{
     success: boolean;
     agentCount?: number;

package/dist/services/bridge-package-publish-hooks.d.ts

@@ -1,9 +1,4 @@
-/**
- * Bridge 包发布后通知服务
- *
- * 主干流程：读取 GitHub Actions 注入的 webhook URL 与密钥；两者均配置时，
- * 读取当前包名/版本并发送带 HMAC 签名的 JSON 通知；任一配置缺失时安全跳过。
- */
+
 import axios from "axios";
 import { type Logger } from "../utils/logger.js";
 export interface BridgePackageInfo {
@@ -27,21 +22,12 @@ interface NotifyOptions {
     now?: () => Date;
     post?: typeof axios.post;
 }
-/**
- * 具体功能实现：读取 package.json 中用于通知服务识别包版本的最小信息。
- */
+
 export declare function readBridgePackageInfo(): Promise<BridgePackageInfo>;
-/**
- * 具体功能实现：构造稳定的发布通知负载，附带 GitHub Actions 上下文便于服务端审计。
- */
+
 export declare function createBridgePackagePublishPayload(packageInfo: BridgePackageInfo, env?: NodeJS.ProcessEnv, now?: () => Date): BridgePackagePublishPayload;
-/**
- * 具体功能实现：对实际发送的 JSON 字符串签名，保证服务端验签与请求体完全一致。
- */
+
 export declare function createBridgePublishSignature(body: string, secret: string): string;
-/**
- * 主逻辑：根据环境变量决定跳过或发送发布通知；已配置 webhook 时失败会抛出，
- * 让 GitHub Actions 明确暴露“包已发布但通知失败”的状态。
- */
+
 export declare function notifyBridgePackagePublished(options?: NotifyOptions): Promise<boolean>;
 export {};

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

@@ -1,9 +1,4 @@
-/**
- * CC-Switch SDK 包装层
- *
- * 负责创建 SDK 实例并注入 adapters。
- * adapters 实现在 src/adapters/cc-switch/ 中。
- */
+
 import { AiConfigService, CcSwitchSdk, type AppFlags } from '@cc-switch/sdk';
 import type { CcSwitchAppPaths, AdapterResult, SdkApps } from '../types.js';
 import { InstanceService } from './instance-service.js';

package/dist/services/cli-commands.d.ts

@@ -15,55 +15,34 @@ export interface CliCommandOptions {
     stderr?: (message: string) => void;
     runCommand?: (command: string, args: string[]) => CommandRunResult;
     configure?: () => Promise<StartupConfigWizardResult>;
-    /** awsb config example：打印最小配置示例并把占位符模板写入配置文件。 */
+    
     configureExample?: () => Promise<StartupConfigWizardResult>;
     platform?: NodeJS.Platform;
     serviceUnitPath?: string;
     executablePath?: string;
-    /** Windows 服务日志文件路径（默认 ~/.aws-bridge/log/awsb.out.log），供 install 重定向与 log 读取。 */
+    
     windowsServiceLogPath?: string;
-    /** Windows 服务管理器（基于 node-windows），用于 install 操作；测试时可注入 mock。 */
+    
     windowsServiceManager?: WindowsServiceManager;
-    /** macOS launchd plist 文件路径（默认 ~/Library/LaunchAgents/com.agentsworkstudio.awsb.plist）。 */
+    
     launchdPlistPath?: string;
-    /** macOS launchd 日志文件路径（默认 ~/.aws-bridge/log/awsb.out.log），供 install 写入 plist 与 log 读取。 */
+    
     launchdLogPath?: string;
-    /**
-     * macOS launchd 域目标（默认 `gui/${process.getuid()}`）。
-     * service-target = `${domainTarget}/${LAUNCHD_LABEL}`，测试时可注入固定值避免依赖 getuid。
-     */
+    
     launchdDomainTarget?: string;
-    /** 检测正在运行的 bridge 进程 PID 列表（默认按平台用 pgrep / powershell）。 */
+    
     findRunningBridgeProcesses?: (platform: NodeJS.Platform) => number[];
-    /** 关闭指定 PID 的进程（默认按平台用 kill -9 / taskkill）。 */
+    
     killBridgeProcess?: (pid: number, platform: NodeJS.Platform) => void;
-    /** 交互式询问，返回用户输入（默认从 stdin 读取一行）。 */
+    
     prompt?: (question: string) => Promise<string>;
-    /**
-     * 解析全局 node_modules 路径（默认执行 `npm root -g`）。
-     * 用于 update 前清理旧版残留目录，避免 macOS 专用 fsevents 在 Windows 上
-     * 触发 node-gyp 编译失败。
-     */
+    
     globalModulePath?: () => string | null;
 }
 export declare function readPackageVersion(packageRoot?: string): string;
-/**
- * 生成 systemd unit 内容，主流程是用当前 Node 可执行文件启动当前 CLI 入口。
- */
+
 export declare function createSystemdUnitContent(executablePath: string): string;
-/**
- * 生成 macOS launchd plist 内容。
- *
- * - Label：launchd 注册的服务标识，必须与 plist 文件名匹配；
- * - ProgramArguments：用当前 Node 可执行文件启动 CLI 入口；
- * - RunAtLoad=true：bootstrap 时立即启动；
- * - KeepAlive=true：进程退出后自动拉起（对应 systemd Restart=always 语义；
- *   systemd 用 on-failure，launchd 没有细粒度条件时用 true 最稳）；
- * - StandardOutPath/StandardErrorPath：与 Windows 服务日志统一放在 ~/.aws-bridge/log/；
- * - AWS_RUNTIME_HOME_DIR：注入当前用户主目录，避免 LaunchAgent 在某些上下文下
- *   解析到错误 home 导致读不到 ~/.aws-bridge/config.json（与 Windows LocalSystem
- *   场景同源，统一注入更稳）。
- */
+
 export declare function createLaunchdPlistContent(executablePath: string, options?: {
     userHomeDir?: string;
     logPath?: string;

package/dist/services/event-delta-pusher.d.ts

@@ -1,9 +1,4 @@
-/**
- * 事件差量推送调度器
- *
- * 将 agent 事件缓冲区中的新事件差量推送到调度中心。
- * 提供全局心跳调度和推送统计查询。
- */
+
 import { type BridgeEventPayload } from "./agent-event-store.js";
 import { type RingBufferEntry } from "./ring-buffer.js";
 export interface RuntimeCallbackAuthOptions {
@@ -19,21 +14,11 @@ export interface PushStatEntry {
     lastLatencyMs?: number;
     lastError?: string;
 }
-/**
- * 调度一次差量推送：将 agent 的新事件推送到调度中心。
- * 暂以单次 push 模式实现，后续可按需改为批量/定时 flush。
- */
+
 export declare function scheduleEventPush(agentId: string, _entry: RingBufferEntry<BridgeEventPayload>, authOptions?: RuntimeCallbackAuthOptions): Promise<void>;
-/**
- * 启动全局心跳调度器。
- * 每 30s 向调度中心发送空包，检测连接存活。
- */
+
 export declare function startHeartbeatScheduler(): void;
-/**
- * 停止全局心跳调度器。
- */
+
 export declare function stopHeartbeatScheduler(): void;
-/**
- * 返回所有 agent 的推送统计。
- */
+
 export declare function getAllPushStats(): PushStatEntry[];

package/dist/services/fileSnapshotStore.d.ts

@@ -1,13 +1,6 @@
-/**
- * 文件快照存储服务
- *
- * 借鉴 Claude Code fileHistory 的确定性整文件覆盖方案，替代 git stash 实现稳定快照。
- * - 快照 = 工作区那一刻所有文件的内容哈希副本 + index.json 映射
- * - 还原 = "先清后写"整文件覆盖，零冲突，幂等
- * - 内容哈希去重：相同文件内容跨快照共享一份物理副本
- */
+
 export interface SnapshotIndexEntry {
-    /** 备份文件名（= sha256(content).slice(0,16)）；null 表示快照时该文件不存在（占位） */
+    
     backupName: string;
     size: number;
     mtime: number;
@@ -50,46 +43,25 @@ export interface SnapshotListItem {
     fileCount: number;
     totalBytes: number;
 }
-/**
- * 创建工作区文件快照。
- *
- * 算法（借鉴 Claude Code fileHistoryMakeSnapshot）：
- * 1. 遍历工作区收集所有文件
- * 2. 对每个文件计算内容哈希，拷贝到快照目录（去重）
- * 3. 写入 index.json 和 meta.json
- */
+
 export declare function createSnapshot(params: {
     workspacePath: string;
     snapshotId?: string;
     snapshotName?: string;
     triggerType?: string;
 }): Promise<CreateSnapshotResult>;
-/**
- * 还原工作区到快照状态。
- *
- * 算法（借鉴 Claude Code applySnapshot）：
- * 1. 可选：还原前自动创建安全网快照（preRestoreBackup）
- * 2. 读取目标快照 index.json
- * 3. 删除工作区中"快照后新增"的文件
- * 4. 从备份逐文件覆盖，内容相同则跳过
- */
+
 export declare function restoreSnapshot(params: {
     workspacePath: string;
     snapshotKey: string;
     preRestoreBackup?: boolean;
 }): Promise<RestoreSnapshotResult>;
-/**
- * 列出指定工作区的所有快照
- */
+
 export declare function listSnapshots(workspacePath: string): Promise<SnapshotListItem[]>;
-/**
- * 删除指定快照
- */
+
 export declare function deleteSnapshot(snapshotKey: string): Promise<{
     ok: boolean;
     error?: string;
 }>;
-/**
- * 获取快照根目录（供诊断/调试使用）
- */
+
 export declare function getSnapshotRootPath(): string;

package/dist/services/instance-ai-config-service.d.ts

@@ -1,10 +1,4 @@
-/**
- * AI 配置服务
- *
- * 管理 ACode 实例的 AI provider 配置（model/baseURL/apiKey）。
- * 支持三层来源（api > env > file）仲裁，deep-merge 后写入
- * per-instance acode.json 供 ACode runtime 加载。
- */
+
 export interface AdapterInstanceAiConfig {
     model?: string;
     baseURL?: string;
@@ -12,7 +6,7 @@ export interface AdapterInstanceAiConfig {
     effort?: string;
 }
 interface PrepareOptions {
-    /** 来自请求体 instanceAiConfig 的覆盖（api > env > file 中的 "api" 层） */
+    
     apiOverrides?: AdapterInstanceAiConfig;
     agentId: string;
     sessionId?: string;
@@ -30,19 +24,8 @@ interface PrepareResult {
     };
     perInstanceConfigPath: string;
 }
-/**
- * 脱敏日志中的敏感字段（apiKey / secret / token / password）。
- * 返回新对象，不修改原对象。
- */
+
 export declare function redactForLog(obj: Record<string, unknown>): Record<string, unknown>;
-/**
- * 准备 ACode 实例配置。
- *
- * 主流程：
- * 1. 从 apiOverrides（请求体）、env（环境变量）、file（acode.json）三层收集配置
- * 2. 按 api > env > file 优先级仲裁每个字段
- * 3. 将仲裁结果 deep-merge 写入 per-instance acode.json
- * 4. 返回合并后的 config 和 per-instance 文件路径
- */
+
 export declare function prepareAcodeInstanceConfig(options: PrepareOptions): Promise<PrepareResult>;
 export {};

package/dist/services/instance-service.d.ts

@@ -1,13 +1,4 @@
-/**
- * InstanceService - Agent 实例初始化服务
- *
- * 负责 Agent 实例的生命周期管理：
- * - 实例根目录、workspace 路径管理
- * - 实例状态持久化
- * - Skill/MCP 包安装流程
- *
- * 注意：此服务属于 Agent 运行时层，不属于 cc-switch-sdk 配置管理层
- */
+
 import type { AppId, InstalledSkill, McpServer } from '@cc-switch/sdk';
 import { CcSwitchSdk } from '@cc-switch/sdk';
 export interface SkillPackage {

package/dist/services/instance-state.d.ts

@@ -1,35 +1,10 @@
-/**
- * 实例状态持久化服务
- *
- * 管理 Agent 实例的初始化状态持久化
- */
+
 import type { InstanceState } from '../types.js';
-/**
- * 获取实例状态文件路径
- *
- * @param agentId - Agent ID
- * @returns 状态文件路径
- */
+
 export declare function getInstanceStateFile(agentId: string): string;
-/**
- * 加载实例状态
- *
- * @param agentId - Agent ID
- * @returns 实例状态
- */
+
 export declare function loadInstanceState(agentId: string): Promise<InstanceState>;
-/**
- * 保存实例状态
- *
- * @param agentId - Agent ID
- * @param state - 部分实例状态
- * @returns 完整的实例状态
- */
+
 export declare function saveInstanceState(agentId: string, state: Partial<InstanceState>): Promise<InstanceState>;
-/**
- * 获取 Agent 初始化根目录
- *
- * @param agentId - Agent ID
- * @returns 初始化根目录路径
- */
+
 export declare function getAgentInitRoot(agentId: string): string;

package/dist/services/legacy-path-migration.d.ts

@@ -1,2 +1,2 @@
-/** 启动时调用：迁移所有旧路径配置 */
+
 export declare function migrateOldPathsOnStartup(): void;

package/dist/services/lifecycle-state.d.ts

@@ -22,8 +22,5 @@ export declare function createBridgeLifecycleOperation(input: {
 }): BridgeLifecycleOperation;
 export declare function upsertBridgeLifecycleOperation(operation: BridgeLifecycleOperation): Promise<void>;
 export declare function removeBridgeLifecycleOperation(operationId: string): Promise<void>;
-/**
- * 投递 Bridge 生命周期通知。
- * 主流程：把已完成操作回调调度中心；已接收的操作从本地状态移除，失败则保留待下次启动重试。
- */
+
 export declare function deliverPendingBridgeLifecycleNotifications(): Promise<void>;

package/dist/services/mcp-launch-binding-queue.d.ts

@@ -31,16 +31,10 @@ export interface McpLaunchBindingClaimRequest {
 export declare function enqueueMcpLaunchBinding(input: McpLaunchBindingInput): McpLaunchBinding | null;
 export declare function claimMcpLaunchBinding(request: McpLaunchBindingClaimRequest): ClaimedMcpLaunchBinding | null;
 export declare function getMcpLaunchQueueSize(workspacePath: unknown): number;
-/**
- * 主流程：按启动绑定 ID 移除尚未被 MCP node 认领的绑定。
- * 具体逻辑：启动流程失败时调用；若绑定已被认领或 ID 不存在则返回 false，保持幂等。
- */
+
 export declare function removeMcpLaunchBinding(bindingId: string): boolean;
 export declare function clearMcpLaunchBindingQueues(): void;
-/**
- * 获取指定 agent 的最新 MCP session token。
- * 供 MCP node 在 401 后向 bridge 查询最新 token 使用。
- */
+
 export declare function getLatestAgentToken(agentId: string): {
     runtimeAccessToken: string;
 } | null;

package/dist/services/orphan-monitor.d.ts

@@ -1,15 +1,7 @@
-/**
- * 孤儿进程监控服务
- *
- * 定期扫描和检测孤儿进程，支持自动清理和告警
- */
-/**
- * 孤儿进程事件类型
- */
+
+
 export type OrphanEventType = 'orphan_detected' | 'orphan_cleaned' | 'process_unresponsive' | 'process_high_cpu' | 'process_high_memory' | 'health_check';
-/**
- * 孤儿进程事件
- */
+
 export interface OrphanEvent {
     type: OrphanEventType;
     agentId: string;
@@ -18,81 +10,46 @@ export interface OrphanEvent {
     timestamp: Date;
     details?: Record<string, unknown>;
 }
-/**
- * 孤儿进程监控器
- */
+
 export declare class OrphanMonitor {
     private intervalId;
     private lastScanTime;
     private eventListeners;
     private stopped;
-    /**
-     * 启动监控器
-     */
+    
     start(): Promise<void>;
-    /**
-     * 停止监控器
-     */
+    
     stop(): void;
-    /**
-     * 执行一次扫描
-     */
+    
     scan(): Promise<void>;
-    /**
-     * 处理检测到的孤儿进程
-     */
+    
     private handleOrphanDetected;
-    /**
-     * 处理健康异常
-     */
+    
     private handleHealthIssue;
-    /**
-     * 自动清理孤儿进程
-     */
+    
     private autoCleanOrphan;
-    /**
-     * 清理已死亡的会话记录
-     */
+    
     private cleanupDeadSessions;
-    /**
-     * 向 server 查询 agent 是否仍然存在。
-     * 返回 true=存在, false=已删除, null=无法确认（网络错误/认证失败等）。
-     */
+    
     private checkAgentExistsOnServer;
-    /**
-     * 上报事件到调度中心
-     */
+    
     private reportToScheduler;
-    /**
-     * 注册事件监听器
-     */
+    
     onEvent(listener: (event: OrphanEvent) => void): void;
-    /**
-     * 移除事件监听器
-     */
+    
     offEvent(listener: (event: OrphanEvent) => void): void;
-    /**
-     * 触发事件
-     */
+    
     private emit;
-    /**
-     * 获取监控状态
-     */
+    
     getStatus(): {
         running: boolean;
         lastScanTime: Date | null;
         mode: string;
     };
 }
-/**
- * 获取孤儿进程监控器实例
- */
+
 export declare function getOrphanMonitor(): OrphanMonitor;
-/**
- * 启动孤儿进程监控
- */
+
 export declare function startOrphanMonitor(): Promise<void>;
-/**
- * 停止孤儿进程监控
- */
+
 export declare function stopOrphanMonitor(): void;