aws-runtime-bridge 1.0.0

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

@@ -0,0 +1,94 @@
+/**
+ * Bridge 实例自动注册服务
+ *
+ * 实现 Bridge 实例启动后自动向调度中心注册的功能
+ *
+ * 配置来源（优先级从高到低）：
+ * 1. 环境变量
+ * 2. 用户目录下的 .aws-bridge/config.json 文件
+ */
+/**
+ * 自动注册配置
+ */
+interface AutoRegisterConfig {
+    /** 是否启用自动注册 */
+    enabled: boolean;
+    /** 租户 ID（可选，如果提供 userKey 则可自动推导） */
+    tenantId?: string;
+    /** 用户 API Key（必填，用于验证身份和自动推导租户） */
+    userKey: string;
+    /** 实例名称（默认使用主机名） */
+    instanceName?: string;
+    /** 项目名称 */
+    projectName?: string;
+    /** 角色名称 */
+    roleName?: string;
+    /** 工作空间路径 */
+    workspacePath?: string;
+    /** 虚拟 IP（EasyTier） */
+    virtualIp?: string;
+    /** 注册重试次数 */
+    maxRetries?: number;
+    /** 注册重试间隔（毫秒） */
+    retryInterval?: number;
+}
+/**
+ * 加载自动注册配置
+ *
+ * 优先级：环境变量 > 配置文件 > 默认值
+ *
+ * 如果没有配置文件且没有环境变量，则不启用自动注册
+ */
+export declare function loadConfig(): AutoRegisterConfig;
+/**
+ * 自动注册主函数
+ *
+ * 带重试机制的注册逻辑
+ *
+ * 配置来源（优先级从高到低）：
+ * 1. 传入的 customConfig
+ * 2. 环境变量
+ * 3. ~/.aws-bridge/config.json 配置文件
+ * 4. 默认值
+ */
+export declare function autoRegister(customConfig?: Partial<AutoRegisterConfig>): Promise<boolean>;
+/**
+ * 注销实例
+ */
+export declare function unregister(): Promise<boolean>;
+/**
+ * 获取注册状态
+ */
+export declare function getRegistrationState(): {
+    registered: boolean;
+    instanceId?: string;
+    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;
+    error?: string;
+}>;
+export {};
+//# sourceMappingURL=auto-register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-register.d.ts","sourceRoot":"","sources":["../../src/services/auto-register.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoCH;;GAEG;AACH,UAAU,kBAAkB;IAC1B,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwJD;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,kBAAkB,CAuC/C;AA2KD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyE/F;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAuBnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB;gBA5dtB,OAAO;iBACN,MAAM;kBACL,IAAI;YACV,MAAM;EA2df;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2D/G"}

package/dist/services/auto-register.js

@@ -0,0 +1,510 @@
+/**
+ * Bridge 实例自动注册服务
+ *
+ * 实现 Bridge 实例启动后自动向调度中心注册的功能
+ *
+ * 配置来源（优先级从高到低）：
+ * 1. 环境变量
+ * 2. 用户目录下的 .aws-bridge/config.json 文件
+ */
+import axios from 'axios';
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs';
+import { logger } from '../utils/logger.js';
+import { schedulerBaseUrl, runtimeToken } from '../config.js';
+// 默认配置
+const DEFAULT_CONFIG = {
+    enabled: false,
+    maxRetries: 5,
+    retryInterval: 5000,
+};
+let registrationState = {
+    registered: false,
+};
+/**
+ * 配置文件路径
+ */
+function getConfigFilePath() {
+    const homeDir = os.homedir();
+    return path.join(homeDir, '.aws-bridge', 'config.json');
+}
+/**
+ * 确保配置文件存在，如果不存在则创建空配置文件
+ */
+function ensureConfigFile() {
+    const configPath = getConfigFilePath();
+    const configDir = path.dirname(configPath);
+    try {
+        // 检查配置文件是否已存在
+        if (fs.existsSync(configPath)) {
+            return true;
+        }
+        // 创建配置目录
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        // 创建空配置文件
+        const emptyConfig = {};
+        fs.writeFileSync(configPath, JSON.stringify(emptyConfig, null, 2), 'utf-8');
+        logger.info(`[AutoRegister] 已创建配置文件: ${configPath}`);
+        logger.info(`[AutoRegister] 要启用自动注册，请编辑配置文件设置 tenantId 和 userKey`);
+        return true;
+    }
+    catch (error) {
+        const err = error;
+        logger.warn(`[AutoRegister] 创建配置文件失败: ${configPath}, error: ${err.message}`);
+        return false;
+    }
+}
+/**
+ * 从配置文件加载配置
+ *
+ * 配置文件位置：~/.aws-bridge/config.json
+ *
+ * 配置文件格式：
+ * {
+ *   "userKey": "aws_live_xxx",     // 必填，用户 API Key
+ *   "tenantId": "xxx",             // 可选，租户 ID（不填则自动推导）
+ *   "instanceName": "my-bridge",   // 可选，默认使用主机名
+ *   "projectName": "default",     // 可选
+ *   "roleName": "Bridge",          // 可选
+ *   "workspacePath": "/path/to/workspace",  // 可选
+ *   "virtualIp": "10.144.144.1", // 可选
+ *   "maxRetries": 5,              // 可选
+ *   "retryInterval": 5000          // 可选
+ * }
+ */
+function loadConfigFromFile() {
+    // 确保配置文件存在（如果不存在则创建模板）
+    ensureConfigFile();
+    const configPath = getConfigFilePath();
+    try {
+        if (!fs.existsSync(configPath)) {
+            logger.debug(`[AutoRegister] 配置文件不存在: ${configPath}`);
+            return null;
+        }
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        logger.info(`[AutoRegister] 从配置文件加载配置: ${configPath}`);
+        return {
+            tenantId: config.tenantId,
+            userKey: config.userKey,
+            instanceName: config.instanceName,
+            projectName: config.projectName,
+            roleName: config.roleName,
+            workspacePath: config.workspacePath,
+            virtualIp: config.virtualIp,
+            maxRetries: config.maxRetries,
+            retryInterval: config.retryInterval,
+        };
+    }
+    catch (error) {
+        const err = error;
+        logger.warn(`[AutoRegister] 读取配置文件失败: ${configPath}, error: ${err.message}`);
+        return null;
+    }
+}
+/**
+ * 从环境变量加载配置
+ */
+function loadConfigFromEnv() {
+    const envConfig = {};
+    if (process.env.AWS_AUTO_REGISTER === 'true') {
+        envConfig.enabled = true;
+    }
+    if (process.env.AWS_TENANT_ID) {
+        envConfig.tenantId = process.env.AWS_TENANT_ID;
+    }
+    if (process.env.AWS_USER_KEY) {
+        envConfig.userKey = process.env.AWS_USER_KEY;
+    }
+    if (process.env.AWS_INSTANCE_NAME) {
+        envConfig.instanceName = process.env.AWS_INSTANCE_NAME;
+    }
+    if (process.env.AWS_PROJECT_NAME) {
+        envConfig.projectName = process.env.AWS_PROJECT_NAME;
+    }
+    if (process.env.AWS_ROLE_NAME) {
+        envConfig.roleName = process.env.AWS_ROLE_NAME;
+    }
+    if (process.env.AWS_WORKSPACE_PATH) {
+        envConfig.workspacePath = process.env.AWS_WORKSPACE_PATH;
+    }
+    if (process.env.AWS_VIRTUAL_IP) {
+        envConfig.virtualIp = process.env.AWS_VIRTUAL_IP;
+    }
+    if (process.env.AWS_REGISTER_MAX_RETRIES) {
+        envConfig.maxRetries = parseInt(process.env.AWS_REGISTER_MAX_RETRIES, 10);
+    }
+    if (process.env.AWS_REGISTER_RETRY_INTERVAL) {
+        envConfig.retryInterval = parseInt(process.env.AWS_REGISTER_RETRY_INTERVAL, 10);
+    }
+    return envConfig;
+}
+/**
+ * 加载自动注册配置
+ *
+ * 优先级：环境变量 > 配置文件 > 默认值
+ *
+ * 如果没有配置文件且没有环境变量，则不启用自动注册
+ */
+export function loadConfig() {
+    // 1. 尝试从配置文件加载
+    const fileConfig = loadConfigFromFile();
+    // 2. 从环境变量加载（可覆盖配置文件）
+    const envConfig = loadConfigFromEnv();
+    // 3. 合并配置：环境变量优先级最高
+    const merged = {
+        ...DEFAULT_CONFIG,
+        ...(fileConfig || {}),
+        ...envConfig,
+    };
+    // 4. 设置默认实例名（如果未配置）
+    const instanceName = merged.instanceName || os.hostname();
+    // 5. 判断是否启用
+    // 如果环境变量明确设置了 AWS_AUTO_REGISTER，使用环境变量的值
+    // 否则，如果配置文件存在（无论是否有内容），则启用自动注册
+    let enabled = false;
+    if (process.env.AWS_AUTO_REGISTER !== undefined) {
+        enabled = process.env.AWS_AUTO_REGISTER === 'true';
+    }
+    else if (fileConfig) {
+        enabled = true;
+    }
+    return {
+        enabled,
+        tenantId: merged.tenantId || '', // 保持为空字符串，后续会通过userKey自动推导
+        userKey: merged.userKey || '',
+        instanceName,
+        projectName: merged.projectName,
+        roleName: merged.roleName,
+        workspacePath: merged.workspacePath,
+        virtualIp: merged.virtualIp,
+        maxRetries: merged.maxRetries,
+        retryInterval: merged.retryInterval,
+    };
+}
+/**
+ * 获取本机所有非内部 IPv4 地址
+ */
+function getAllLocalIpAddresses() {
+    const interfaces = os.networkInterfaces();
+    const addresses = [];
+    for (const name of Object.keys(interfaces)) {
+        const nets = interfaces[name];
+        if (!nets)
+            continue;
+        for (const net of nets) {
+            // 跳过内部和非 IPv4 地址
+            if (net.family === 'IPv4' && !net.internal) {
+                addresses.push({
+                    address: net.address,
+                    netmask: net.netmask,
+                    name: name,
+                });
+            }
+        }
+    }
+    return addresses;
+}
+/**
+ * 将 IP 地址转换为整数
+ */
+function ipToInt(ip) {
+    const parts = ip.split('.').map(Number);
+    return (parts[0] << 24) + (parts[1] << 16) + (parts[2] << 8) + parts[3];
+}
+/**
+ * 判断两个 IP 是否在同一子网
+ */
+function isSameSubnet(ip1, ip2, netmask) {
+    const ip1Int = ipToInt(ip1);
+    const ip2Int = ipToInt(ip2);
+    const maskInt = ipToInt(netmask);
+    return (ip1Int & maskInt) === (ip2Int & maskInt);
+}
+/**
+ * 从 URL 中提取 IP 地址
+ */
+function extractIpFromUrl(url) {
+    try {
+        const urlObj = new URL(url);
+        // 如果是主机名，尝试解析
+        if (urlObj.hostname === 'localhost' || urlObj.hostname === '127.0.0.1') {
+            return '127.0.0.1';
+        }
+        // 检查是否是有效的 IP 地址
+        const ipPattern = /^(\d{1,3}\.){3}\d{1,3}$/;
+        if (ipPattern.test(urlObj.hostname)) {
+            return urlObj.hostname;
+        }
+        // 对于主机名，返回 null（无法直接判断子网）
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取与调度中心同局域网的本机 IP 地址
+ *
+ * 策略：
+ * 1. 解析调度中心 URL 获取其 IP
+ * 2. 遍历本机网卡，找到与调度中心同子网的 IP
+ * 3. 如果找不到同子网 IP，返回第一个非内部 IP
+ * 4. 如果没有任何非内部 IP，返回 127.0.0.1
+ */
+function getPreferredIpAddress(schedulerUrl) {
+    const allIps = getAllLocalIpAddresses();
+    if (allIps.length === 0) {
+        logger.warn('[AutoRegister] 未找到任何非内部 IP 地址，使用 127.0.0.1');
+        return '127.0.0.1';
+    }
+    // 尝试从调度中心 URL 提取 IP
+    const schedulerIp = extractIpFromUrl(schedulerUrl);
+    if (schedulerIp) {
+        // 查找与调度中心同子网的 IP
+        for (const ipInfo of allIps) {
+            if (isSameSubnet(ipInfo.address, schedulerIp, ipInfo.netmask)) {
+                logger.info(`[AutoRegister] 找到与调度中心同子网的 IP: ${ipInfo.address} (网卡: ${ipInfo.name}, 子网掩码: ${ipInfo.netmask})`);
+                return ipInfo.address;
+            }
+        }
+        logger.warn(`[AutoRegister] 未找到与调度中心 (${schedulerIp}) 同子网的 IP，使用第一个可用 IP`);
+    }
+    else {
+        logger.info('[AutoRegister] 无法解析调度中心 IP，使用第一个可用 IP');
+    }
+    // 回退：返回第一个非内部 IP
+    return allIps[0].address;
+}
+/**
+ * 获取本机 IP 地址（兼容旧接口）
+ */
+function getLocalIpAddress() {
+    return getPreferredIpAddress(schedulerBaseUrl);
+}
+/**
+ * 执行注册请求
+ */
+async function doRegister(config) {
+    const instanceName = config.instanceName || os.hostname();
+    const localIp = getLocalIpAddress();
+    const port = process.env.AWS_RUNTIME_BRIDGE_PORT || 18081;
+    const request = {
+        tenantId: config.tenantId,
+        userKey: config.userKey,
+        instanceName,
+        hostname: os.hostname(),
+        virtualIp: config.virtualIp,
+        runtimeBridgeBaseUrl: `http://${config.virtualIp || localIp}:${port}`,
+        workspacePath: config.workspacePath,
+        projectName: config.projectName,
+        roleName: config.roleName,
+    };
+    logger.info(`[AutoRegister] 正在注册实例: ${instanceName}`);
+    logger.info(`[AutoRegister] 调度中心: ${schedulerBaseUrl}`);
+    logger.info(`[AutoRegister] 用户 Key: ${config.userKey ? '****' + config.userKey.slice(-4) : '(未设置)'}`);
+    logger.info(`[AutoRegister] 租户 ID: ${config.tenantId || '(自动推导)'}`);
+    const response = await axios.post(`${schedulerBaseUrl}/api/instances/register`, request, {
+        headers: {
+            'Content-Type': 'application/json',
+            'X-Runtime-Token': runtimeToken,
+        },
+        timeout: 10000,
+    });
+    return response.data;
+}
+/**
+ * 执行注销请求
+ */
+async function doUnregister(instanceId) {
+    const response = await axios.post(`${schedulerBaseUrl}/api/instances/unregister`, { instanceId }, {
+        headers: {
+            'Content-Type': 'application/json',
+            'X-Runtime-Token': runtimeToken,
+        },
+        timeout: 10000,
+    });
+    return response.data;
+}
+/**
+ * 自动注册主函数
+ *
+ * 带重试机制的注册逻辑
+ *
+ * 配置来源（优先级从高到低）：
+ * 1. 传入的 customConfig
+ * 2. 环境变量
+ * 3. ~/.aws-bridge/config.json 配置文件
+ * 4. 默认值
+ */
+export async function autoRegister(customConfig) {
+    // 加载并合并配置
+    const config = {
+        ...loadConfig(),
+        ...customConfig,
+    };
+    // 检查是否启用
+    if (!config.enabled) {
+        logger.info('[AutoRegister] 自动注册未启用');
+        logger.info('[AutoRegister] 要启用自动注册，请创建配置文件 ~/.aws-bridge/config.json 或设置环境变量 AWS_AUTO_REGISTER=true');
+        return false;
+    }
+    // 验证必填字段（userKey 为必填，tenantId 现在可选）
+    if (!config.userKey) {
+        logger.error('[AutoRegister] 缺少用户 Key（在配置文件中设置 userKey 或设置环境变量 AWS_USER_KEY）');
+        return false;
+    }
+    // tenantId 现在是可选的，如果没有提供，后端会根据 userKey 自动推导
+    const maxRetries = config.maxRetries || 5;
+    const retryInterval = config.retryInterval || 5000;
+    // 重试循环
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            registrationState.lastAttempt = new Date();
+            const response = await doRegister(config);
+            if (response.success) {
+                registrationState.registered = true;
+                registrationState.instanceId = response.instanceId;
+                registrationState.error = undefined;
+                logger.info(`[AutoRegister] ✓ 注册成功！`);
+                logger.info(`[AutoRegister]   实例 ID: ${response.instanceId}`);
+                logger.info(`[AutoRegister]   消息: ${response.message}`);
+                logger.info(`[AutoRegister]   更新: ${response.isUpdate ? '是' : '否'}`);
+                return true;
+            }
+            else {
+                logger.warn(`[AutoRegister] 注册失败: ${response.message}`);
+                registrationState.error = response.message;
+            }
+        }
+        catch (error) {
+            const err = error;
+            const message = err.response?.data ? JSON.stringify(err.response.data) : err.message;
+            logger.error(`[AutoRegister] 注册请求失败 (尝试 ${attempt}/${maxRetries}): ${message}`);
+            registrationState.error = message;
+        }
+        // 如果不是最后一次尝试，等待后重试
+        if (attempt < maxRetries) {
+            logger.info(`[AutoRegister] ${retryInterval / 1000} 秒后重试...`);
+            await new Promise(resolve => setTimeout(resolve, retryInterval));
+        }
+    }
+    logger.error(`[AutoRegister] ✗ 注册失败，已达最大重试次数`);
+    logger.error(`[AutoRegister] ========================================`);
+    logger.error(`[AutoRegister] 自动注册已启用但注册失败，实例无法正常工作`);
+    logger.error(`[AutoRegister] 请检查以下配置：`);
+    logger.error(`[AutoRegister]   - 用户 Key (userKey): ${config.userKey ? '****' + config.userKey.slice(-4) : '(未设置)'}`);
+    logger.error(`[AutoRegister]   - 租户 ID (tenantId): ${config.tenantId || '(可选，将自动推导)'}`);
+    logger.error(`[AutoRegister]   - 实例名 (instanceName): ${config.instanceName || '(使用主机名)'}`);
+    logger.error(`[AutoRegister]   - 调度中心地址: ${schedulerBaseUrl}`);
+    logger.error(`[AutoRegister]   - 最后错误: ${registrationState.error || '未知'}`);
+    logger.error(`[AutoRegister] ========================================`);
+    logger.error(`[AutoRegister] 配置来源：~/.aws-bridge/config.json 或环境变量`);
+    return false;
+}
+/**
+ * 注销实例
+ */
+export async function unregister() {
+    if (!registrationState.registered || !registrationState.instanceId) {
+        logger.info('[AutoRegister] 实例未注册，无需注销');
+        return true;
+    }
+    try {
+        const response = await doUnregister(registrationState.instanceId);
+        if (response.success) {
+            logger.info(`[AutoRegister] ✓ 注销成功: ${registrationState.instanceId}`);
+            registrationState.registered = false;
+            registrationState.instanceId = undefined;
+            return true;
+        }
+        else {
+            logger.warn(`[AutoRegister] 注销失败: ${response.message}`);
+            return false;
+        }
+    }
+    catch (error) {
+        const err = error;
+        logger.error(`[AutoRegister] 注销请求失败: ${err.message}`);
+        return false;
+    }
+}
+/**
+ * 获取注册状态
+ */
+export function getRegistrationState() {
+    return { ...registrationState };
+}
+/**
+ * 检查是否已注册
+ */
+export function isRegistered() {
+    return registrationState.registered;
+}
+/**
+ * 获取实例 ID
+ */
+export function getInstanceId() {
+    return registrationState.instanceId;
+}
+/**
+ * ★★★ 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 async function bridgeRestartCleanup() {
+    const config = loadConfig();
+    const instanceId = registrationState.instanceId;
+    // 构建清理请求
+    const requestBody = {};
+    if (instanceId) {
+        requestBody.instanceId = instanceId;
+    }
+    // 如果有配置，也传入 runtimeBridgeBaseUrl
+    if (config.enabled) {
+        const localIp = getLocalIpAddress();
+        const port = process.env.AWS_RUNTIME_BRIDGE_PORT || 18081;
+        requestBody.runtimeBridgeBaseUrl = `http://${config.virtualIp || localIp}:${port}`;
+    }
+    if (!requestBody.instanceId && !requestBody.runtimeBridgeBaseUrl) {
+        logger.info('[AutoRegister] Bridge 重启清理：没有 instanceId 或 runtimeBridgeBaseUrl，跳过清理');
+        return { success: true, agentCount: 0 };
+    }
+    try {
+        logger.info(`[AutoRegister] Bridge 重启清理：正在通知调度中心...`);
+        logger.info(`[AutoRegister]   instanceId: ${requestBody.instanceId || '(无)'}`);
+        logger.info(`[AutoRegister]   runtimeBridgeBaseUrl: ${requestBody.runtimeBridgeBaseUrl || '(无)'}`);
+        const response = await axios.post(`${schedulerBaseUrl}/api/instances/bridge-restart-cleanup`, requestBody, {
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Runtime-Token': runtimeToken,
+            },
+            timeout: 10000,
+        });
+        if (response.data.success) {
+            logger.info(`[AutoRegister] ✓ Bridge 重启清理成功：${response.data.message}`);
+            logger.info(`[AutoRegister]   清理了 ${response.data.agentCount || 0} 个 Agent`);
+            return { success: true, agentCount: response.data.agentCount || 0 };
+        }
+        else {
+            logger.warn(`[AutoRegister] Bridge 重启清理失败：${response.data.message}`);
+            return { success: false, error: response.data.message };
+        }
+    }
+    catch (error) {
+        const err = error;
+        const message = err.response?.data ? JSON.stringify(err.response.data) : err.message;
+        logger.warn(`[AutoRegister] Bridge 重启清理请求失败：${message}`);
+        return { success: false, error: message };
+    }
+}

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

@@ -0,0 +1,26 @@
+export declare const AWS_MCP_SERVER_NAME = "aws-mcp";
+export interface AwsMcpServerConfigInput {
+    agentId: string;
+    workspacePath: string;
+}
+export interface AwsMcpCommandSpec {
+    command: string;
+    args: string[];
+}
+export interface AwsMcpServerConfig extends AwsMcpCommandSpec {
+    env: Record<string, string>;
+}
+export interface ResolveAwsClientAgentMcpCommandOptions {
+    exists?: (filePath: string) => boolean;
+    release?: () => string | null;
+}
+export interface AwsMcpPreparedInfo extends AwsMcpCommandSpec {
+    source: 'override' | 'bundled' | 'global';
+}
+export declare function getReleasedMcpDistPath(): string;
+export declare function releaseBundledAwsClientAgentMcp(): string | null;
+export declare function resolveAwsClientAgentMcpCommand(options?: ResolveAwsClientAgentMcpCommandOptions): AwsMcpPreparedInfo;
+export declare function getAwsClientAgentMcpPreparedInfo(options?: ResolveAwsClientAgentMcpCommandOptions): AwsMcpPreparedInfo;
+export declare function buildAwsMcpServerConfig(input: AwsMcpServerConfigInput): AwsMcpServerConfig;
+export declare function ensureAwsClientAgentMcpReleased(): void;
+//# sourceMappingURL=aws-client-agent-mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aws-client-agent-mcp.d.ts","sourceRoot":"","sources":["../../src/services/aws-client-agent-mcp.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAqB7C,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,sCAAsC;IACrD,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC3C;AAeD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAMD,wBAAgB,+BAA+B,IAAI,MAAM,GAAG,IAAI,CAoB/D;AA6CD,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,sCAA2C,GAAG,kBAAkB,CAExH;AAED,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,sCAA2C,GAAG,kBAAkB,CAuBzH;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAe1F;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAUtD"}