aws-runtime-bridge 1.9.92 → 1.9.93

package/dist/services/panel-auth.d.ts

@@ -1,48 +1,32 @@
-/**
- * Bridge 面板登录认证服务
- *
- * 管理面板登录凭据与会话，凭据读取自 ~/.aws-bridge/config.json，
- * panelUsername/panelPassword 字段均不配置时默认 root/root。
- *
- * 会话使用服务端内存存储 + HttpOnly Cookie 实现，无需外部依赖。
- */
-/** 生成一个新会话并返回会话 token */
+
+
 export declare function createSession(): string;
-/** 校验会话 token 是否有效；通过后更新最后使用时间 */
+
 export declare function validateSession(token: string | undefined | null): boolean;
-/** 销毁指定会话（登出） */
+
 export declare function destroySession(token: string): void;
-/** 列出所有活跃会话（用于管理面板） */
+
 export declare function getAllSessions(): Array<{
     token: string;
     createdAt: number;
     lastUsedAt: number;
 }>;
-/** 获取当前活跃会话数 */
+
 export declare function getActiveSessionCount(): number;
 interface PanelCredentials {
     username: string;
     password: string;
 }
-/** 获取面板登录凭据，未配置时返回默认值 root/root */
+
 export declare function getPanelCredentials(): PanelCredentials;
-/** 校验用户名密码 */
+
 export declare function validateCredentials(username: string, password: string): boolean;
-/** 清除凭据缓存（配置文件变更后调用） */
+
 export declare function clearCredentialsCache(): void;
-/**
- * 检查 config.json 中是否已配置过面板凭据（panelUsername/panelPassword）。
- * 用于首次登录引导：如果未配置过（文件不存在或缺少字段），应引导用户设置。
- * 已配置过的场景（包括值正好为 root/root）不再重复引导。
- */
+
 export declare function hasConfiguredCredentials(): boolean;
-/**
- * 判断当前凭据是否为默认值 root/root。
- */
+
 export declare function isDefaultCredentials(): boolean;
-/**
- * 写入新的面板凭据到 config.json，并更新缓存。
- * 主流程：读取现有配置 → 合并新字段 → 写回文件 → 清缓存。
- */
+
 export declare function setPanelCredentials(username: string, password: string): void;
 export {};

package/dist/services/process-detector.d.ts

@@ -1,25 +1,9 @@
-/**
- * 进程检测服务
- *
- * 用于检测孤儿进程（当 runtime-bridge 异常关闭后仍在运行的 Agent 进程）
- */
-/**
- * 异步检测进程是否存活（防止阻塞事件循环）
- *
- * @param pid 进程 ID
- * @returns 是否存活
- */
+
+
 export declare function isProcessRunningAsync(pid: number): Promise<boolean>;
-/**
- * 检测进程是否存活
- *
- * @param pid 进程 ID
- * @returns 是否存活
- */
+
 export declare function isProcessRunning(pid: number): boolean;
-/**
- * 进程信息
- */
+
 export interface ProcessInfo {
     pid: number;
     command: string;
@@ -27,78 +11,22 @@ export interface ProcessInfo {
     agentId?: string;
     startedAt?: string;
 }
-/**
- * 查找 Agent 相关的进程（Claude Code、OpenCode 等）
- *
- * @returns 匹配的进程列表
- */
+
 export declare function findClaudeCodeProcesses(): Promise<ProcessInfo[]>;
-/**
- * 根据 agentId 查找孤儿进程
- *
- * 检测策略（按优先级）：
- * 1. 通过命令行中的 agentId 直接匹配
- * 2. Windows: 通过 PowerShell 在命令行中模糊搜索 agentId
- * 3. Windows: 通过进程树搜索，覆盖 agentId 仅存在于祖先进程环境变量中的场景
- *
- * @param agentId Agent ID
- * @returns 进程信息或 undefined
- */
+
 export declare function findOrphanProcessByAgentId(agentId: string): Promise<ProcessInfo | undefined>;
-/**
- * 通过工作目录路径查找孤儿进程
- *
- * 当 agentId 无法匹配到进程时，通过工作目录路径做宽泛搜索。
- * 适用于以下场景：
- * - runtime-bridge 重启后持久化会话丢失
- * - agentId 可能仅在祖先进程环境变量中，命令行搜索不到
- * - 进程树断链，无法通过祖先链匹配
- *
- * @param workspacePath 工作目录路径
- * @returns 匹配的进程信息或 undefined
- */
+
 export declare function findOrphanProcessByWorkspace(workspacePath: string): Promise<ProcessInfo | undefined>;
-/**
- * 根据 PID 终止进程
- *
- * @param pid 进程 ID
- * @returns 是否成功
- */
+
 export declare function terminateProcess(pid: number): boolean;
-/**
- * 终止进程树（包括所有子进程）
- *
- * 跨平台实现：
- * - Windows: 使用 taskkill /T 终止整个进程树
- * - Unix: 递归获取所有子进程并逐个终止
- *
- * @param pid 进程 ID
- * @returns { terminated: 成功终止的进程数，failed: 失败的进程数 }
- */
+
 export declare function terminateProcessTree(pid: number): Promise<{
     terminated: number;
     failed: number;
 }>;
-/**
- * 等待进程完全终止（轮询检测）
- *
- * @param pid 进程 ID
- * @param timeoutMs 超时时间（毫秒）
- * @returns 是否成功终止
- */
+
 export declare function waitForProcessExit(pid: number, timeoutMs?: number): Promise<boolean>;
-/**
- * 检测并收集所有孤儿进程信息
- * 用于 runtime-bridge 启动时恢复控制
- *
- * 改进策略：
- * 1. 检查持久化会话中的 PID 是否仍在运行（使用可靠的 isProcessRunning）
- * 2. PID 存活时，优先从进程列表匹配详细信息，匹配不到则用持久化信息构造
- * 3. 对于没有 PID 的会话，通过 agentId 搜索进程（包括环境变量搜索）
- *
- * @param persistedSessions 持久化的会话列表（包含 PID 信息）
- * @returns 孤儿进程列表
- */
+
 export declare function detectOrphanProcesses(persistedSessions: Array<{
     agentId: string;
     pid?: number;
@@ -112,9 +40,7 @@ export declare function detectOrphanProcesses(persistedSessions: Array<{
         command?: string;
     };
 }>>;
-/**
- * 进程健康状态
- */
+
 export interface ProcessHealthStatus {
     pid: number;
     agentId: string;
@@ -124,55 +50,25 @@ export interface ProcessHealthStatus {
     status: 'healthy' | 'unresponsive' | 'high_cpu' | 'high_memory' | 'dead';
     lastUpdate: Date;
 }
-/**
- * 检测进程健康状态
- *
- * @param pid 进程 ID
- * @param agentId Agent ID
- * @returns 健康状态
- */
+
 export declare function checkProcessHealth(pid: number, agentId: string): Promise<ProcessHealthStatus>;
-/**
- * 批量检测会话健康状态
- *
- * @param sessions 持久化会话列表
- * @returns 健康状态列表
- */
+
 export declare function checkAllSessionsHealth(sessions: Array<{
     agentId: string;
     pid?: number;
 }>): Promise<Map<string, ProcessHealthStatus>>;
-/**
- * 发现进程管理状态
- */
+
 export type ProcessManagementStatus = 'managed' | 'orphan' | 'unknown';
-/**
- * 发现的进程信息（含管理状态）
- */
+
 export interface DiscoveredProcessInfo extends ProcessInfo {
     managementStatus: ProcessManagementStatus;
     sessionId?: string;
     isRunning: boolean;
     lastSeen?: string;
 }
-/**
- * 全局发现：扫描机器上所有 Agent 进程，并标注管理状态
- *
- * 返回三类进程：
- * - managed: 在注册表中且进程存活
- * - orphan: 进程存在但不在注册表中（脱离控制）
- * - unknown: 在注册表中但进程已死亡
- *
- * @param managedPids 已知被管理的 PID 集合（来自 ProcessRegistry）
- * @returns 发现的进程列表
- */
+
 export declare function discoverAllProcesses(managedPids?: Set<number>, managedAgentIds?: Set<string>): Promise<DiscoveredProcessInfo[]>;
-/**
- * 批量发现：扫描所有进程并补充注册表中缺失的进程状态
- *
- * @param registryExport 注册表导出的进程记录（含 agentId, pid）
- * @returns 完整的发现结果
- */
+
 export declare function discoverAllProcessesFull(registryExport: Array<{
     agentId: string;
     pid: number;

package/dist/services/process-registry.d.ts

@@ -1,23 +1,13 @@
-/**
- * 进程注册表服务
- *
- * 集中管理 Agent 进程生命周期状态，支持进程注册、追踪、状态管理和持久化
- */
-/**
- * 进程状态类型
- */
+
+
 export type ProcessState = 'creating' | 'running' | 'stopping' | 'orphaned' | 'terminated' | 'unknown';
-/**
- * 进程健康状态
- */
+
 export interface HealthStatus {
     cpu: number;
     memoryMB: number;
     status: string;
 }
-/**
- * 进程记录接口
- */
+
 export interface ProcessRecord {
     agentId: string;
     sessionId: string;
@@ -32,9 +22,7 @@ export interface ProcessRecord {
     orphanedAt?: string;
     metadata?: Record<string, unknown>;
 }
-/**
- * 持久化会话输入（用于重建注册表）
- */
+
 export interface PersistedSessionInput {
     agentId: string;
     sessionId: string;
@@ -43,166 +31,58 @@ export interface PersistedSessionInput {
     command?: string;
     mode?: 'sdk';
 }
-/**
- * 获取持久化注册表文件路径
- *
- * @returns 注册表文件路径
- */
+
 export declare function getProcessRegistryFile(): string;
-/**
- * 进程注册表类
- *
- * 管理所有 Agent 进程的生命周期状态，提供注册、查询、更新和持久化功能
- */
+
 export declare class ProcessRegistry {
     private static instance;
     private readonly records;
     private readonly pidToAgentId;
-    /**
-     * 私有构造函数，强制使用单例模式
-     */
+    
     private constructor();
-    /**
-     * 获取 ProcessRegistry 单例实例
-     *
-     * @returns ProcessRegistry 实例
-     */
+    
     static getInstance(): ProcessRegistry;
-    /**
-     * 持久化注册表状态到文件
-     */
+    
     private persist;
     private mutate;
-    /**
-     * 注册新进程
-     *
-     * @param record - 进程记录（不包含 createdAt）
-     * @returns 是否注册成功
-     */
+    
     register(record: Omit<ProcessRecord, 'createdAt'>): Promise<void>;
-    /**
-     * 更新进程记录
-     *
-     * @param agentId - Agent ID
-     * @param updates - 要更新的字段
-     * @returns 是否更新成功
-     */
+    
     update(agentId: string, updates: Partial<ProcessRecord>): Promise<boolean>;
-    /**
-     * 通过 agentId 获取进程记录
-     *
-     * @param agentId - Agent ID
-     * @returns 进程记录或 undefined
-     */
+    
     get(agentId: string): ProcessRecord | undefined;
-    /**
-     * 通过 PID 获取进程记录
-     *
-     * @param pid - 进程 ID
-     * @returns 进程记录或 undefined
-     */
+    
     getByPid(pid: number): ProcessRecord | undefined;
-    /**
-     * 获取所有进程记录
-     *
-     * @returns 所有进程记录的数组
-     */
+    
     getAll(): ProcessRecord[];
-    /**
-     * 通过状态过滤进程记录
-     *
-     * @param state - 进程状态
-     * @returns 符合状态的进程记录数组
-     */
+    
     getByState(state: ProcessState): ProcessRecord[];
-    /**
-     * 检查进程是否被管理
-     *
-     * @param agentId - Agent ID
-     * @returns 是否被管理
-     */
+    
     isManaged(agentId: string): boolean;
-    /**
-     * 检查 PID 是否被管理
-     *
-     * @param pid - 进程 ID
-     * @returns 是否被管理
-     */
+    
     isManagedByPid(pid: number): boolean;
-    /**
-     * 标记进程为孤儿状态
-     *
-     * @param agentId - Agent ID
-     * @returns 是否标记成功
-     */
+    
     markOrphaned(agentId: string): Promise<boolean>;
-    /**
-     * 标记进程为终止状态
-     *
-     * @param agentId - Agent ID
-     * @returns 是否标记成功
-     */
+    
     markTerminated(agentId: string): Promise<boolean>;
-    /**
-     * 移除进程记录
-     *
-     * @param agentId - Agent ID
-     * @returns 是否移除成功
-     */
+    
     remove(agentId: string): Promise<boolean>;
-    /**
-     * 更新进程心跳时间
-     *
-     * @param agentId - Agent ID
-     * @returns 是否更新成功
-     */
+    
     updateHeartbeat(agentId: string): Promise<boolean>;
-    /**
-     * 更新进程健康状态
-     *
-     * @param agentId - Agent ID
-     * @param health - 健康状态
-     * @returns 是否更新成功
-     */
+    
     updateHealth(agentId: string, health: HealthStatus): Promise<boolean>;
-    /**
-     * 从持久化会话重建注册表
-     *
-     * @param sessions - 持久化会话数组
-     */
+    
     rebuildFromPersisted(sessions: PersistedSessionInput[]): Promise<void>;
-    /**
-     * 导出所有进程记录用于持久化
-     *
-     * @returns 所有进程记录的数组
-     */
+    
     exportState(): ProcessRecord[];
-    /**
-     * 获取进程数量统计
-     *
-     * @returns 各状态的进程数量
-     */
+    
     getStats(): Record<ProcessState | 'total', number>;
-    /**
-     * 清空所有进程记录
-     */
+    
     clear(): Promise<void>;
 }
-/**
- * 获取 ProcessRegistry 单例实例的便捷函数
- *
- * @returns ProcessRegistry 实例
- */
+
 export declare function getProcessRegistry(): ProcessRegistry;
-/**
- * 加载持久化的进程注册表
- *
- * @returns 进程记录数组
- */
+
 export declare function loadPersistedProcessRegistry(): Promise<ProcessRecord[]>;
-/**
- * 保存进程注册表到持久化文件
- *
- * @param records - 进程记录数组
- */
+
 export declare function savePersistedProcessRegistry(records: ProcessRecord[]): Promise<void>;

package/dist/services/ring-buffer.d.ts

@@ -1,66 +1,33 @@
-/**
- * 环状缓冲区
- *
- * 提供固定容量的泛型环状缓冲区，支持追加和按条件合并。
- * 当缓冲区满时自动覆盖最旧的元素。
- */
+
 export interface RingBufferEntry<T> {
     data: T;
     readonly timestamp: number;
     readonly index: number;
 }
 export type RingBufferSlice<T> = readonly RingBufferEntry<T>[];
-/**
- * 泛型环状缓冲区。
- * 容量固定，写入超过容量后自动覆盖最旧条目。
- * 每个 entry 携带单调递增 index，支持增量查询。
- */
+
 export declare class RingBuffer<T> {
     private readonly entries;
     private readonly capacity;
     private nextIndex;
     private totalAppended;
     constructor(capacity: number);
-    /**
-     * 追加一条记录到缓冲区尾部。
-     * 缓冲区满时自动覆盖最旧的记录。
-     * @returns 新创建的条目
-     */
+    
     append(item: T): RingBufferEntry<T>;
-    /**
-     * 按条件追加或合并到最后一条记录。
-     * 如果缓冲区非空且 condition 返回 true，将 item 合并到最后一条记录中；
-     * 否则直接追加新记录。
-     *
-     * @param item 待追加的数据
-     * @param condition 判断是否与最后一条合并，接收最后一条条目
-     * @param merge 合并函数，接收已有数据和新增数据，返回合并结果
-     * @returns 被合并或新创建的条目
-     */
+    
     appendOrMerge(item: T, condition: (lastEntry: RingBufferEntry<T>) => boolean, merge: (last: T, next: T) => T): RingBufferEntry<T>;
-    /**
-     * 返回当前所有条目的快照。
-     */
+    
     slice(): RingBufferSlice<T>;
-    /**
-     * 返回当前条目数。
-     */
+    
     get size(): number;
-    /**
-     * 返回最近 N 条记录。
-     */
+    
     getLastN(n: number): RingBufferSlice<T>;
-    /**
-     * 返回自指定 index（不含）之后的记录。
-     * @returns 包含 entries、nextIndex（下一个待分配 index）、oldestIndex（最老条目的 index）
-     */
+    
     getSinceIndex(index: number): {
         entries: RingBufferSlice<T>;
         nextIndex: number;
         oldestIndex: number;
     };
-    /**
-     * 清空缓冲区。
-     */
+    
     clear(): void;
 }

package/dist/services/runtime-binding.d.ts

@@ -3,11 +3,7 @@ export type RuntimeBindingState = {
     instanceId?: string;
     userId?: string;
     schedulerBaseUrl?: string;
-    /**
-     * Plain runtime access token issued by the scheduler.
-     * Stored locally with 0600 permissions so child MCP processes can authenticate
-     * scheduler calls without exposing the token in public status APIs.
-     */
+    
     accessToken?: string;
     tokenHash?: string;
     createdAt?: string;
@@ -40,8 +36,5 @@ export declare function saveRuntimeBinding(input: {
     schedulerBaseUrl?: string;
 }): RuntimeBindingState;
 export declare function clearRuntimeBinding(): void;
-/**
- * 将旧路径 ~/.agentswork/runtime-bridge/ 下的配置文件迁移到新路径 ~/.aws-bridge/。
- * 仅在旧路径存在且新路径不存在时执行，避免覆盖已有配置。
- */
+
 export declare function migrateOldBindingDir(): void;

package/dist/services/runtime-lifecycle-policy.d.ts

@@ -6,21 +6,9 @@ export interface GracefulShutdownPlan {
     clearPersistedSessions: boolean;
     stopTunnelClient: boolean;
 }
-/**
- * Build shutdown side-effect policy from the requested restart mode.
- * Main flow: explicit bridge shutdown cleans resources; scheduler restart keeps
- * SDK/PTY processes and persisted metadata so the scheduler can restore state.
- */
+
 export declare function buildGracefulShutdownPlan(preserveSessions: boolean): GracefulShutdownPlan;
-/**
- * Decide whether startup may destructively clean persisted runtime sessions.
- * Main flow: default bridge restart is non-destructive; operators can opt into
- * legacy cleanup with AWS_BRIDGE_CLEAN_ORPHANS_ON_STARTUP=true.
- */
+
 export declare function shouldCleanupPersistedSessionsOnStartup(preserveSessions: boolean, env?: NodeJS.ProcessEnv): boolean;
-/**
- * Decide whether background orphan monitoring may terminate persisted sessions.
- * Main flow: process termination is an explicit cleanup action, not a default
- * monitoring behavior, so restart recovery cannot be undone by auto-clean mode.
- */
+
 export declare function shouldAutoCleanOrphanProcesses(env?: NodeJS.ProcessEnv): boolean;