aws-runtime-bridge 1.9.91 → 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/cli-commands.js

@@ -1,7 +1,7 @@
-import{spawnSync as P}from"node:child_process";import{createInterface as q}from"node:readline/promises";import{existsSync as l,mkdirSync as p,readFileSync as Y,rmSync as J,unlinkSync as M,writeFileSync as N}from"node:fs";import o from"node:path";import S from"node:os";import{fileURLToPath as O}from"node:url";import{configureStartupConfig as z,printConfigExampleCommand as Q}from"./startup-config-wizard.js";import{createWindowsServiceManager as X,isNodeWindowsAvailable as Z}from"./windows-service-manager.js";const m="awsb.service",j=`/etc/systemd/system/${m}`,H="awsb",x=`${H}.exe`,F=o.join(S.homedir(),".aws-bridge","log"),B=o.join(F,"awsb.out.log"),T="com.agentsworkstudio.awsb",_=o.join(S.homedir(),"Library","LaunchAgents",`${T}.plist`),ee=o.join(S.homedir(),".aws-bridge","log"),W=o.join(ee,"awsb.out.log");function re(){const e=O(import.meta.url);return o.resolve(o.dirname(e),"..","..")}function te(e=re()){const r=o.join(e,"package.json");return JSON.parse(Y(r,"utf-8")).version||"unknown"}function I(e,r){const n=P(e,r,{shell:process.platform==="win32",stdio:"inherit"});return{status:n.status,error:n.error}}function ne(){try{const e=P("npm",["root","-g"],{shell:process.platform==="win32",encoding:"utf-8",stdio:["ignore","pipe","ignore"]});if(e.status===0&&e.stdout){const r=e.stdout.trim();if(r)return r}}catch{}return null}function ae(e){process.stdout.write(`${e}
-`)}function se(e){process.stderr.write(`${e}
-`)}function ie(e){return e==="-v"||e==="--version"||e==="version"}function ue(e){return`"${e.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`}function de(){return process.argv[1]?o.resolve(process.argv[1]):O(import.meta.url)}function oe(e){return["[Unit]","Description=AgentsWorkStudio Runtime Bridge","After=network-online.target","Wants=network-online.target","","[Service]","Type=simple","Environment=AWS_BRIDGE_SKIP_SETUP=true",`ExecStart=${[process.execPath,e].map(n=>ue(n)).join(" ")}`,"Restart=on-failure","RestartSec=5s","","[Install]","WantedBy=multi-user.target",""].join(`
-`)}function v(e){return e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function ce(e,r={}){const n=r.userHomeDir??S.homedir(),s=r.logPath??W,a=s.replace(/\.out\.log$/,".err.log");return['<?xml version="1.0" encoding="UTF-8"?>','<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">','<plist version="1.0">',"<dict>","  <key>Label</key>",`  <string>${v(T)}</string>`,"  <key>ProgramArguments</key>","  <array>",`    <string>${v(process.execPath)}</string>`,`    <string>${v(e)}</string>`,"  </array>","  <key>EnvironmentVariables</key>","  <dict>","    <key>AWS_BRIDGE_SKIP_SETUP</key>","    <string>true</string>","    <key>AWS_RUNTIME_HOME_DIR</key>",`    <string>${v(n)}</string>`,"  </dict>","  <key>RunAtLoad</key>","  <true/>","  <key>KeepAlive</key>","  <true/>","  <key>StandardOutPath</key>",`  <string>${v(s)}</string>`,"  <key>StandardErrorPath</key>",`  <string>${v(a)}</string>`,"</dict>","</plist>",""].join(`
-`)}function f(e,r){return e("systemctl",r)}function g(e,r){return r.error?`[runtime-bridge] ${e}\u5931\u8D25: ${r.error.message}`:`[runtime-bridge] ${e}\u5931\u8D25\uFF0Csystemctl \u9000\u51FA\u7801: ${r.status??"unknown"}`}function d(e){return!e.error&&e.status===0}function E(e,r){return e==="linux"?!0:(r("[runtime-bridge] service \u547D\u4EE4\u4EC5\u652F\u6301 Linux systemd \u73AF\u5883\u3002"),!1)}function k(e,r){return e==="darwin"?!0:(r("[runtime-bridge] service \u547D\u4EE4\u4EC5\u652F\u6301 macOS launchd \u73AF\u5883\u3002"),!1)}function G(e){e("Usage: awsb service <install|uninstall|start|stop|restart>")}function le(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=oe(e.executablePath);try{p(o.dirname(e.serviceUnitPath),{recursive:!0}),N(e.serviceUnitPath,r,{encoding:"utf-8",mode:420})}catch(t){const i=t instanceof Error?t:new Error(String(t));return e.stderr(`[runtime-bridge] \u5199\u5165 systemd unit \u5931\u8D25: ${i.message}`),{handled:!0,exitCode:1}}const n=f(e.runCommand,["daemon-reload"]);if(!d(n))return e.stderr(g("\u91CD\u8F7D systemd",n)),{handled:!0,exitCode:n.status??1};const s=f(e.runCommand,["enable",m]);if(!d(s))return e.stderr(g("\u542F\u7528 awsb \u5F00\u673A\u81EA\u542F",s)),{handled:!0,exitCode:s.status??1};const a=f(e.runCommand,["is-active","--quiet",m]);if(a.error)return e.stderr(g("\u68C0\u67E5 awsb \u670D\u52A1\u72B6\u6001",a)),{handled:!0,exitCode:1};if(a.status!==0){const t=f(e.runCommand,["start",m]);return d(t)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u5B89\u88C5\u3001\u5DF2\u542F\u7528\u5F00\u673A\u81EA\u542F\u5E76\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0}):(e.stderr(g("\u542F\u52A8 awsb \u670D\u52A1",t)),{handled:!0,exitCode:t.status??1})}return e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u5B89\u88C5\u5E76\u5DF2\u542F\u7528\u5F00\u673A\u81EA\u542F\uFF1B\u670D\u52A1\u5DF2\u5728\u8FD0\u884C\u3002"),{handled:!0,exitCode:0}}function me(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=l(e.serviceUnitPath),n=f(e.runCommand,["is-active","--quiet",m]);if(n.error)return e.stderr(g("\u68C0\u67E5 awsb \u670D\u52A1\u72B6\u6001",n)),{handled:!0,exitCode:1};if(n.status===0){const t=f(e.runCommand,["stop",m]);if(!d(t))return e.stderr(g("\u505C\u6B62 awsb \u670D\u52A1",t)),{handled:!0,exitCode:t.status??1}}const s=f(e.runCommand,["disable",m]);if(s.error||s.status!==0&&r)return e.stderr(g("\u7981\u7528 awsb \u5F00\u673A\u81EA\u542F",s)),{handled:!0,exitCode:s.status??1};if(r)try{M(e.serviceUnitPath)}catch(t){const i=t instanceof Error?t:new Error(String(t));return e.stderr(`[runtime-bridge] \u5220\u9664 systemd unit \u5931\u8D25: ${i.message}`),{handled:!0,exitCode:1}}else e.stdout("[runtime-bridge] awsb systemd unit \u4E0D\u5B58\u5728\uFF0C\u8DF3\u8FC7\u5220\u9664\u3002");const a=f(e.runCommand,["daemon-reload"]);return d(a)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u5378\u8F7D\u3002"),{handled:!0,exitCode:0}):(e.stderr(g("\u91CD\u8F7D systemd",a)),{handled:!0,exitCode:a.status??1})}function fe(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};if(!l(e.serviceUnitPath))return e.stderr("[runtime-bridge] awsb systemd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const r=f(e.runCommand,["restart",m]);return d(r)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u91CD\u542F\u3002"),{handled:!0,exitCode:0}):(e.stderr(g("\u91CD\u542F awsb \u670D\u52A1",r)),{handled:!0,exitCode:r.status??1})}function ge(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};if(!l(e.serviceUnitPath))return e.stderr("[runtime-bridge] awsb systemd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const r=f(e.runCommand,["start",m]);return d(r)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0}):(e.stderr(g("\u542F\u52A8 awsb \u670D\u52A1",r)),{handled:!0,exitCode:r.status??1})}function he(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};if(!l(e.serviceUnitPath))return e.stderr("[runtime-bridge] awsb systemd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const r=f(e.runCommand,["stop",m]);return d(r)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u505C\u6B62\u3002"),{handled:!0,exitCode:0}):(e.stderr(g("\u505C\u6B62 awsb \u670D\u52A1",r)),{handled:!0,exitCode:r.status??1})}function be(e){return e(`[runtime-bridge] \u672A\u68C0\u6D4B\u5230 node-windows \u6A21\u5757\u3002\u8BF7\u91CD\u65B0\u5B89\u88C5 aws-runtime-bridge\uFF1A
-    npm install -g aws-runtime-bridge`),{handled:!0,exitCode:1}}async function we(e){const r=e.windowsServiceManager;if(!r&&!Z())return be(e.stderr);const n=e.windowsServiceLogPath||B,s=o.dirname(e.executablePath),a=S.homedir();try{await(r||X()).install({name:H,description:"awsb runtime bridge",script:e.executablePath,workingDirectory:s,env:[{name:"AWS_BRIDGE_SKIP_SETUP",value:"true"},{name:"AWS_RUNTIME_HOME_DIR",value:a}],logpath:F})}catch(i){const h=i instanceof Error?i:new Error(String(i));return e.stderr(`[runtime-bridge] \u5B89\u88C5 Windows \u670D\u52A1\u5931\u8D25: ${h.message}`),{handled:!0,exitCode:1}}const t=e.runCommand("sc.exe",["start",x]);return d(t)?(e.stdout(`[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u5B89\u88C5\u5E76\u5DF2\u542F\u52A8\uFF08\u65E5\u5FD7: ${n}\uFF09\u3002`),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u542F\u52A8 Windows \u670D\u52A1\u5931\u8D25: ${t.error?.message??`\u9000\u51FA\u7801 ${t.status??"unknown"}`}`),{handled:!0,exitCode:t.status??1})}function Ce(e){const r=s=>e.runCommand("sc.exe",s);r(["stop",x]);const n=r(["delete",x]);return d(n)?(e.stdout("[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u5378\u8F7D\u3002"),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u5378\u8F7D Windows \u670D\u52A1\u5931\u8D25: ${n.error?.message??`\u9000\u51FA\u7801 ${n.status??"unknown"}`}`),{handled:!0,exitCode:n.status??1})}function xe(e){const r=s=>e.runCommand("sc.exe",s);r(["stop",x]);const n=r(["start",x]);return d(n)?(e.stdout("[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u91CD\u542F\u3002"),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u91CD\u542F Windows \u670D\u52A1\u5931\u8D25: ${n.error?.message??`\u9000\u51FA\u7801 ${n.status??"unknown"}`}`),{handled:!0,exitCode:n.status??1})}function Pe(e){const r=e.runCommand("sc.exe",["start",x]);return d(r)?(e.stdout("[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u542F\u52A8 Windows \u670D\u52A1\u5931\u8D25: ${r.error?.message??`\u9000\u51FA\u7801 ${r.status??"unknown"}`}`),{handled:!0,exitCode:r.status??1})}function Se(e){const r=e.runCommand("sc.exe",["stop",x]);return d(r)?(e.stdout("[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u505C\u6B62\u3002"),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u505C\u6B62 Windows \u670D\u52A1\u5931\u8D25: ${r.error?.message??`\u9000\u51FA\u7801 ${r.status??"unknown"}`}`),{handled:!0,exitCode:r.status??1})}function ve(){return`gui/${process.getuid?.()??0}`}function R(e){return e.launchdDomainTarget||ve()}function L(e){return`${e}/${T}`}function D(e,r){return r.error?`[runtime-bridge] ${e}\u5931\u8D25: ${r.error.message}`:`[runtime-bridge] ${e}\u5931\u8D25\uFF0Claunchctl \u9000\u51FA\u7801: ${r.status??"unknown"}`}function ye(e){if(!k(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=e.launchdPlistPath||_,n=e.launchdLogPath||W,s=ce(e.executablePath,{userHomeDir:S.homedir(),logPath:n});try{p(o.dirname(r),{recursive:!0}),p(o.dirname(n),{recursive:!0}),N(r,s,{encoding:"utf-8",mode:420})}catch(i){const h=i instanceof Error?i:new Error(String(i));return e.stderr(`[runtime-bridge] \u5199\u5165 launchd plist \u5931\u8D25: ${h.message}`),{handled:!0,exitCode:1}}const a=R(e);e.runCommand("launchctl",["bootout",L(a)]);const t=e.runCommand("launchctl",["bootstrap",a,r]);return d(t)?(e.stdout(`[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u5B89\u88C5\u5E76\u5DF2\u542F\u52A8\uFF08\u65E5\u5FD7: ${n}\uFF09\u3002`),{handled:!0,exitCode:0}):(e.stderr(D("\u5B89\u88C5 awsb \u670D\u52A1",t)),{handled:!0,exitCode:t.status??1})}function $e(e){if(!k(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=e.launchdPlistPath||_,n=R(e),s=L(n),a=e.runCommand("launchctl",["bootout",s]);if(a.error)return e.stderr(D("\u5378\u8F7D awsb \u670D\u52A1",a)),{handled:!0,exitCode:1};if(l(r))try{M(r)}catch(t){const i=t instanceof Error?t:new Error(String(t));return e.stderr(`[runtime-bridge] \u5220\u9664 launchd plist \u5931\u8D25: ${i.message}`),{handled:!0,exitCode:1}}else e.stdout("[runtime-bridge] awsb launchd plist \u4E0D\u5B58\u5728\uFF0C\u8DF3\u8FC7\u5220\u9664\u3002");return e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u5378\u8F7D\u3002"),{handled:!0,exitCode:0}}function Ee(e){if(!k(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=e.launchdPlistPath||_;if(!l(r))return e.stderr("[runtime-bridge] awsb launchd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const n=R(e),s=L(n),a=e.runCommand("launchctl",["kickstart",s]);if(d(a))return e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0};const t=e.runCommand("launchctl",["bootstrap",n,r]);return d(t)?(e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0}):(e.stderr(D("\u542F\u52A8 awsb \u670D\u52A1",t)),{handled:!0,exitCode:t.status??1})}function ke(e){if(!k(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=R(e),n=e.runCommand("launchctl",["bootout",L(r)]);return d(n)?(e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u505C\u6B62\u3002"),{handled:!0,exitCode:0}):(e.stderr(D("\u505C\u6B62 awsb \u670D\u52A1",n)),{handled:!0,exitCode:n.status??1})}function Re(e){if(!k(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=e.launchdPlistPath||_;if(!l(r))return e.stderr("[runtime-bridge] awsb launchd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const n=R(e);e.runCommand("launchctl",["bootout",L(n)]);const s=e.runCommand("launchctl",["bootstrap",n,r]);return d(s)?(e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u91CD\u542F\u3002"),{handled:!0,exitCode:0}):(e.stderr(D("\u91CD\u542F awsb \u670D\u52A1",s)),{handled:!0,exitCode:s.status??1})}async function Le(e,r,n,s){const a=e[1];if(!a||a==="-h"||a==="--help"||a==="help")return G(n),{handled:!0,exitCode:a?0:1};const t={stdout:n,stderr:s,runCommand:r.runCommand||I,platform:r.platform||process.platform,serviceUnitPath:r.serviceUnitPath||j,executablePath:r.executablePath||de(),windowsServiceManager:r.windowsServiceManager,launchdPlistPath:r.launchdPlistPath,launchdLogPath:r.launchdLogPath,launchdDomainTarget:r.launchdDomainTarget};return t.platform!=="linux"&&t.platform!=="win32"&&t.platform!=="darwin"?(s("[runtime-bridge] service \u547D\u4EE4\u4EC5\u652F\u6301 Linux systemd\u3001Windows \u670D\u52A1\u4E0E macOS launchd \u73AF\u5883\u3002"),{handled:!0,exitCode:1}):a==="install"?t.platform==="win32"?await we(t):t.platform==="darwin"?ye(t):le(t):a==="uninstall"?t.platform==="win32"?Ce(t):t.platform==="darwin"?$e(t):me(t):a==="restart"?t.platform==="win32"?xe(t):t.platform==="darwin"?Re(t):fe(t):a==="start"?t.platform==="win32"?Pe(t):t.platform==="darwin"?Ee(t):ge(t):a==="stop"?t.platform==="win32"?Se(t):t.platform==="darwin"?ke(t):he(t):(s(`[runtime-bridge] \u672A\u77E5 service \u5B50\u547D\u4EE4: ${a}`),G(n),{handled:!0,exitCode:1})}function V(e){return e?e.split(/\r?\n/).map(r=>r.trim()).filter(r=>/^\d+$/.test(r)).map(Number):[]}function De(e){try{if(e==="win32"){const n=P("powershell",["-NoProfile","-Command",`Get-CimInstance Win32_Process -Filter "Name='node.exe'" | Where-Object { $_.CommandLine -like '*aws-runtime-bridge*' -and $_.ProcessId -ne ${process.pid} } | ForEach-Object { $_.ProcessId }`],{encoding:"utf-8"});return V(n.stdout)}const r=P("pgrep",["-f","aws-runtime-bridge"],{encoding:"utf-8"});return V(r.stdout).filter(n=>n!==process.pid)}catch{return[]}}function _e(e,r){if(r==="win32"){P("taskkill",["/PID",String(e),"/F","/T"],{stdio:"ignore"});return}P("kill",["-9",String(e)],{stdio:"ignore"})}function pe(e){if(!process.stdin.isTTY)return Promise.resolve("n");const r=q({input:process.stdin,output:process.stdout});return r.question(e).finally(()=>r.close())}async function Te(e,r,n){const s=e.runCommand||I,a=e.platform||process.platform,t=e.findRunningBridgeProcesses||De,i=e.prompt||pe,h=e.killBridgeProcess||_e,u=e.globalModulePath||ne;r("[runtime-bridge] \u6B63\u5728\u66F4\u65B0 aws-runtime-bridge \u5230\u6700\u65B0\u7248\u672C...");const c=t(a).filter(w=>w!==process.pid);let b=!1;if(c.length>0){r(`[runtime-bridge] \u68C0\u6D4B\u5230 aws-runtime-bridge \u6B63\u5728\u8FD0\u884C (PID: ${c.join(", ")})\uFF0C\u66F4\u65B0\u65F6\u8FD9\u4E9B\u8FDB\u7A0B\u53EF\u80FD\u5360\u7528\u6587\u4EF6\u5BFC\u81F4\u8986\u76D6\u5931\u8D25\u3002`);const w=(await i("\u662F\u5426\u5173\u95ED\u4E0A\u8FF0\u8FDB\u7A0B\u4EE5\u7EE7\u7EED\u66F4\u65B0? (y/N) ")).trim().toLowerCase();if(w==="y"||w==="yes")for(const C of c)try{h(C,a),r(`[runtime-bridge] \u5DF2\u5173\u95ED\u8FDB\u7A0B PID: ${C}`)}catch($){const K=$ instanceof Error?$:new Error(String($));n(`[runtime-bridge] \u5173\u95ED\u8FDB\u7A0B PID ${C} \u5931\u8D25: ${K.message}`)}else b=!0,r("[runtime-bridge] \u5DF2\u9009\u62E9\u4E0D\u5173\u95ED\u8FDB\u7A0B\uFF0C\u5C06\u4EE5 --force \u65B9\u5F0F\u5F3A\u5236\u5B89\u88C5\uFF08\u82E5\u6587\u4EF6\u4ECD\u88AB\u5360\u7528\u53EF\u80FD\u4F1A\u6709\u8B66\u544A\uFF09\u3002")}const U=u();if(U){const w=o.join(U,"aws-runtime-bridge");if(l(w)){r("[runtime-bridge] \u6E05\u7406\u65E7\u7248\u672C\u6B8B\u7559\u76EE\u5F55...");try{J(w,{recursive:!0,force:!0})}catch(C){const $=C instanceof Error?C:new Error(String(C));n(`[runtime-bridge] \u6E05\u7406\u6B8B\u7559\u76EE\u5F55\u5931\u8D25\uFF08\u5C06\u5C1D\u8BD5\u7EE7\u7EED\u5B89\u88C5\uFF09: ${$.message}`)}}}const A=["install","-g","aws-runtime-bridge@latest","--omit=optional"];b&&A.push("--force");const y=s("npm",A);return y.error?(n(`[runtime-bridge] \u66F4\u65B0\u5931\u8D25: ${y.error.message}`),{handled:!0,exitCode:1}):y.status!==0?(n(`[runtime-bridge] \u66F4\u65B0\u5931\u8D25\uFF0Cnpm \u9000\u51FA\u7801: ${y.status??"unknown"}`),{handled:!0,exitCode:y.status??1}):(r("[runtime-bridge] \u66F4\u65B0\u5B8C\u6210\u3002\u8BF7\u91CD\u65B0\u8FD0\u884C awsb -v \u67E5\u770B\u5F53\u524D\u7248\u672C\u3002"),{handled:!0,exitCode:0})}function We(e,r,n){const a=(e.argv||process.argv.slice(2)).slice(1).some(u=>u==="--follow"||u==="-f"),t=e.platform||process.platform,i=e.runCommand||I,h=e.serviceUnitPath||j;if(t==="linux"){if(!l(h))return n("[runtime-bridge] awsb \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF08awsb service install\uFF09\uFF0C\u65E0\u65E5\u5FD7\u53EF\u67E5\u770B\u3002"),{handled:!0,exitCode:1};const u=["-u",m];a?u.push("-f"):u.push("-n","200","--no-pager");const c=i("journalctl",u);return c.error?(n(`[runtime-bridge] \u8BFB\u53D6\u65E5\u5FD7\u5931\u8D25: ${c.error.message}`),{handled:!0,exitCode:1}):{handled:!0,exitCode:c.status??0}}if(t==="win32"){const u=e.windowsServiceLogPath||B;if(!l(u))return n(`[runtime-bridge] \u5C1A\u672A\u751F\u6210\u65E5\u5FD7\u6587\u4EF6: ${u}\u3002\u8BF7\u5148\u6267\u884C \`awsb service install\` \u5E76\u8FD0\u884C\u670D\u52A1\u3002`),{handled:!0,exitCode:1};const c=`Get-Content -Encoding UTF8 -Tail 200 "${u}"`+(a?" -Wait":""),b=i("powershell",["-NoProfile","-Command",c]);return b.error?(n(`[runtime-bridge] \u8BFB\u53D6\u65E5\u5FD7\u5931\u8D25: ${b.error.message}`),{handled:!0,exitCode:1}):{handled:!0,exitCode:b.status??0}}if(t==="darwin"){const u=e.launchdLogPath||W;if(!l(u))return n(`[runtime-bridge] \u5C1A\u672A\u751F\u6210\u65E5\u5FD7\u6587\u4EF6: ${u}\u3002\u8BF7\u5148\u6267\u884C \`awsb service install\` \u5E76\u8FD0\u884C\u670D\u52A1\u3002`),{handled:!0,exitCode:1};const b=i("tail",a?["-f",u]:["-n","200",u]);return b.error?(n(`[runtime-bridge] \u8BFB\u53D6\u65E5\u5FD7\u5931\u8D25: ${b.error.message}`),{handled:!0,exitCode:1}):{handled:!0,exitCode:b.status??0}}return n("[runtime-bridge] awsb log \u4EC5\u652F\u6301 Linux systemd\u3001Windows \u670D\u52A1\u4E0E macOS launchd \u73AF\u5883\u3002"),{handled:!0,exitCode:1}}async function Fe(e={}){const r=e.argv||process.argv.slice(2),n=r[0],s=e.stdout||ae,a=e.stderr||se;if(ie(n))return s(`aws-runtime-bridge ${te(e.packageRoot)}`),{handled:!0,exitCode:0};if(n==="update")return await Te(e,s,a);if(n==="config"){const t=r[1];if(t==="example"||t==="minimal"||t==="--minimal"||t==="-m")return{handled:!0,exitCode:await(e.configureExample||Q)()==="created"?0:1};const h=await(e.configure||z)();return{handled:!0,exitCode:h==="configured"||h==="created"?0:1}}return n==="service"?await Le(r,e,s,a):n==="log"?We(e,s,a):{handled:!1,exitCode:0}}export{ce as createLaunchdPlistContent,oe as createSystemdUnitContent,Fe as handleCliCommand,te as readPackageVersion};
+import{spawnSync as v}from"node:child_process";import{createInterface as J}from"node:readline/promises";import{existsSync as m,mkdirSync as p,readFileSync as z,rmSync as Q,unlinkSync as N,writeFileSync as O}from"node:fs";import c from"node:path";import P from"node:os";import{fileURLToPath as j}from"node:url";import{configureStartupConfig as X,printConfigExampleCommand as Z}from"./startup-config-wizard.js";import{createWindowsServiceManager as ee,isNodeWindowsAvailable as re}from"./windows-service-manager.js";const f="awsb.service",T=`/etc/systemd/system/${f}`,H="awsb",C=`${H}.exe`,F=c.join(P.homedir(),".aws-bridge","log"),B=c.join(F,"awsb.out.log"),I="com.agentsworkstudio.awsb",D=c.join(P.homedir(),"Library","LaunchAgents",`${I}.plist`),te=c.join(P.homedir(),".aws-bridge","log"),U=c.join(te,"awsb.out.log");function ne(){const e=j(import.meta.url);return c.resolve(c.dirname(e),"..","..")}function ae(e=ne()){const r=c.join(e,"package.json");return JSON.parse(z(r,"utf-8")).version||"unknown"}function _(e,r){const t=v(e,r,{shell:process.platform==="win32",stdio:"inherit"});return{status:t.status,error:t.error}}function ie(){try{const e=v("npm",["root","-g"],{shell:process.platform==="win32",encoding:"utf-8",stdio:["ignore","pipe","ignore"]});if(e.status===0&&e.stdout){const r=e.stdout.trim();if(r)return r}}catch{}return null}function se(e){process.stdout.write(`${e}
+`)}function ue(e){process.stderr.write(`${e}
+`)}function de(e){return e==="-v"||e==="--version"||e==="version"}function oe(e){return`"${e.replace(/\\/g,"\\\\").replace(/"/g,'\\"')}"`}function G(){return process.argv[1]?c.resolve(process.argv[1]):j(import.meta.url)}function ce(e){return["[Unit]","Description=AgentsWorkStudio Runtime Bridge","After=network-online.target","Wants=network-online.target","","[Service]","Type=simple","Environment=AWS_BRIDGE_SKIP_SETUP=true",`ExecStart=${[process.execPath,e].map(t=>oe(t)).join(" ")}`,"Restart=on-failure","RestartSec=5s","","[Install]","WantedBy=multi-user.target",""].join(`
+`)}function S(e){return e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function le(e,r={}){const t=r.userHomeDir??P.homedir(),i=r.logPath??U,a=i.replace(/\.out\.log$/,".err.log");return['<?xml version="1.0" encoding="UTF-8"?>','<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">','<plist version="1.0">',"<dict>","  <key>Label</key>",`  <string>${S(I)}</string>`,"  <key>ProgramArguments</key>","  <array>",`    <string>${S(process.execPath)}</string>`,`    <string>${S(e)}</string>`,"  </array>","  <key>EnvironmentVariables</key>","  <dict>","    <key>AWS_BRIDGE_SKIP_SETUP</key>","    <string>true</string>","    <key>AWS_RUNTIME_HOME_DIR</key>",`    <string>${S(t)}</string>`,"  </dict>","  <key>RunAtLoad</key>","  <true/>","  <key>KeepAlive</key>","  <true/>","  <key>StandardOutPath</key>",`  <string>${S(i)}</string>`,"  <key>StandardErrorPath</key>",`  <string>${S(a)}</string>`,"</dict>","</plist>",""].join(`
+`)}function g(e,r){return e("systemctl",r)}function h(e,r){return r.error?`[runtime-bridge] ${e}\u5931\u8D25: ${r.error.message}`:`[runtime-bridge] ${e}\u5931\u8D25\uFF0Csystemctl \u9000\u51FA\u7801: ${r.status??"unknown"}`}function d(e){return!e.error&&e.status===0}function E(e,r){return e==="linux"?!0:(r("[runtime-bridge] service \u547D\u4EE4\u4EC5\u652F\u6301 Linux systemd \u73AF\u5883\u3002"),!1)}function R(e,r){return e==="darwin"?!0:(r("[runtime-bridge] service \u547D\u4EE4\u4EC5\u652F\u6301 macOS launchd \u73AF\u5883\u3002"),!1)}function V(e){e("Usage: awsb service <install|uninstall|start|stop|restart>")}function me(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=ce(e.executablePath);try{p(c.dirname(e.serviceUnitPath),{recursive:!0}),O(e.serviceUnitPath,r,{encoding:"utf-8",mode:420})}catch(n){const s=n instanceof Error?n:new Error(String(n));return e.stderr(`[runtime-bridge] \u5199\u5165 systemd unit \u5931\u8D25: ${s.message}`),{handled:!0,exitCode:1}}const t=g(e.runCommand,["daemon-reload"]);if(!d(t))return e.stderr(h("\u91CD\u8F7D systemd",t)),{handled:!0,exitCode:t.status??1};const i=g(e.runCommand,["enable",f]);if(!d(i))return e.stderr(h("\u542F\u7528 awsb \u5F00\u673A\u81EA\u542F",i)),{handled:!0,exitCode:i.status??1};const a=g(e.runCommand,["is-active","--quiet",f]);if(a.error)return e.stderr(h("\u68C0\u67E5 awsb \u670D\u52A1\u72B6\u6001",a)),{handled:!0,exitCode:1};if(a.status!==0){const n=g(e.runCommand,["start",f]);return d(n)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u5B89\u88C5\u3001\u5DF2\u542F\u7528\u5F00\u673A\u81EA\u542F\u5E76\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0}):(e.stderr(h("\u542F\u52A8 awsb \u670D\u52A1",n)),{handled:!0,exitCode:n.status??1})}return e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u5B89\u88C5\u5E76\u5DF2\u542F\u7528\u5F00\u673A\u81EA\u542F\uFF1B\u670D\u52A1\u5DF2\u5728\u8FD0\u884C\u3002"),{handled:!0,exitCode:0}}function fe(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=m(e.serviceUnitPath),t=g(e.runCommand,["is-active","--quiet",f]);if(t.error)return e.stderr(h("\u68C0\u67E5 awsb \u670D\u52A1\u72B6\u6001",t)),{handled:!0,exitCode:1};if(t.status===0){const n=g(e.runCommand,["stop",f]);if(!d(n))return e.stderr(h("\u505C\u6B62 awsb \u670D\u52A1",n)),{handled:!0,exitCode:n.status??1}}const i=g(e.runCommand,["disable",f]);if(i.error||i.status!==0&&r)return e.stderr(h("\u7981\u7528 awsb \u5F00\u673A\u81EA\u542F",i)),{handled:!0,exitCode:i.status??1};if(r)try{N(e.serviceUnitPath)}catch(n){const s=n instanceof Error?n:new Error(String(n));return e.stderr(`[runtime-bridge] \u5220\u9664 systemd unit \u5931\u8D25: ${s.message}`),{handled:!0,exitCode:1}}else e.stdout("[runtime-bridge] awsb systemd unit \u4E0D\u5B58\u5728\uFF0C\u8DF3\u8FC7\u5220\u9664\u3002");const a=g(e.runCommand,["daemon-reload"]);return d(a)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u5378\u8F7D\u3002"),{handled:!0,exitCode:0}):(e.stderr(h("\u91CD\u8F7D systemd",a)),{handled:!0,exitCode:a.status??1})}function ge(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};if(!m(e.serviceUnitPath))return e.stderr("[runtime-bridge] awsb systemd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const r=g(e.runCommand,["restart",f]);return d(r)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u91CD\u542F\u3002"),{handled:!0,exitCode:0}):(e.stderr(h("\u91CD\u542F awsb \u670D\u52A1",r)),{handled:!0,exitCode:r.status??1})}function he(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};if(!m(e.serviceUnitPath))return e.stderr("[runtime-bridge] awsb systemd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const r=g(e.runCommand,["start",f]);return d(r)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0}):(e.stderr(h("\u542F\u52A8 awsb \u670D\u52A1",r)),{handled:!0,exitCode:r.status??1})}function we(e){if(!E(e.platform,e.stderr))return{handled:!0,exitCode:1};if(!m(e.serviceUnitPath))return e.stderr("[runtime-bridge] awsb systemd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const r=g(e.runCommand,["stop",f]);return d(r)?(e.stdout("[runtime-bridge] awsb systemd \u670D\u52A1\u5DF2\u505C\u6B62\u3002"),{handled:!0,exitCode:0}):(e.stderr(h("\u505C\u6B62 awsb \u670D\u52A1",r)),{handled:!0,exitCode:r.status??1})}function be(e){return e(`[runtime-bridge] \u672A\u68C0\u6D4B\u5230 node-windows \u6A21\u5757\u3002\u8BF7\u91CD\u65B0\u5B89\u88C5 aws-runtime-bridge\uFF1A
+    npm install -g aws-runtime-bridge`),{handled:!0,exitCode:1}}async function q(e){const r=e.windowsServiceManager;if(!r&&!re())return be(e.stderr);const t=e.windowsServiceLogPath||B,i=c.dirname(e.executablePath),a=P.homedir();try{await(r||ee()).install({name:H,description:"awsb runtime bridge",script:e.executablePath,workingDirectory:i,env:[{name:"AWS_BRIDGE_SKIP_SETUP",value:"true"},{name:"AWS_RUNTIME_HOME_DIR",value:a}],logpath:F})}catch(s){const o=s instanceof Error?s:new Error(String(s));return e.stderr(`[runtime-bridge] \u5B89\u88C5 Windows \u670D\u52A1\u5931\u8D25: ${o.message}`),{handled:!0,exitCode:1}}const n=e.runCommand("sc.exe",["start",C]);return d(n)?(e.stdout(`[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u5B89\u88C5\u5E76\u5DF2\u542F\u52A8\uFF08\u65E5\u5FD7: ${t}\uFF09\u3002`),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u542F\u52A8 Windows \u670D\u52A1\u5931\u8D25: ${n.error?.message??`\u9000\u51FA\u7801 ${n.status??"unknown"}`}`),{handled:!0,exitCode:n.status??1})}function Ce(e){const r=i=>e.runCommand("sc.exe",i);r(["stop",C]);const t=r(["delete",C]);return d(t)?(e.stdout("[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u5378\u8F7D\u3002"),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u5378\u8F7D Windows \u670D\u52A1\u5931\u8D25: ${t.error?.message??`\u9000\u51FA\u7801 ${t.status??"unknown"}`}`),{handled:!0,exitCode:t.status??1})}function xe(e){const r=i=>e.runCommand("sc.exe",i);r(["stop",C]);const t=r(["start",C]);return d(t)?(e.stdout("[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u91CD\u542F\u3002"),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u91CD\u542F Windows \u670D\u52A1\u5931\u8D25: ${t.error?.message??`\u9000\u51FA\u7801 ${t.status??"unknown"}`}`),{handled:!0,exitCode:t.status??1})}function ve(e){const r=e.runCommand("sc.exe",["start",C]);return d(r)?(e.stdout("[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u542F\u52A8 Windows \u670D\u52A1\u5931\u8D25: ${r.error?.message??`\u9000\u51FA\u7801 ${r.status??"unknown"}`}`),{handled:!0,exitCode:r.status??1})}function Pe(e){const r=e.runCommand("sc.exe",["stop",C]);return d(r)?(e.stdout("[runtime-bridge] awsb Windows \u670D\u52A1\u5DF2\u505C\u6B62\u3002"),{handled:!0,exitCode:0}):(e.stderr(`[runtime-bridge] \u505C\u6B62 Windows \u670D\u52A1\u5931\u8D25: ${r.error?.message??`\u9000\u51FA\u7801 ${r.status??"unknown"}`}`),{handled:!0,exitCode:r.status??1})}function Se(){return`gui/${process.getuid?.()??0}`}function k(e){return e.launchdDomainTarget||Se()}function W(e){return`${e}/${I}`}function L(e,r){return r.error?`[runtime-bridge] ${e}\u5931\u8D25: ${r.error.message}`:`[runtime-bridge] ${e}\u5931\u8D25\uFF0Claunchctl \u9000\u51FA\u7801: ${r.status??"unknown"}`}function ye(e){if(!R(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=e.launchdPlistPath||D,t=e.launchdLogPath||U,i=le(e.executablePath,{userHomeDir:P.homedir(),logPath:t});try{p(c.dirname(r),{recursive:!0}),p(c.dirname(t),{recursive:!0}),O(r,i,{encoding:"utf-8",mode:420})}catch(s){const o=s instanceof Error?s:new Error(String(s));return e.stderr(`[runtime-bridge] \u5199\u5165 launchd plist \u5931\u8D25: ${o.message}`),{handled:!0,exitCode:1}}const a=k(e);e.runCommand("launchctl",["bootout",W(a)]);const n=e.runCommand("launchctl",["bootstrap",a,r]);return d(n)?(e.stdout(`[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u5B89\u88C5\u5E76\u5DF2\u542F\u52A8\uFF08\u65E5\u5FD7: ${t}\uFF09\u3002`),{handled:!0,exitCode:0}):(e.stderr(L("\u5B89\u88C5 awsb \u670D\u52A1",n)),{handled:!0,exitCode:n.status??1})}function $e(e){if(!R(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=e.launchdPlistPath||D,t=k(e),i=W(t),a=e.runCommand("launchctl",["bootout",i]);if(a.error)return e.stderr(L("\u5378\u8F7D awsb \u670D\u52A1",a)),{handled:!0,exitCode:1};if(m(r))try{N(r)}catch(n){const s=n instanceof Error?n:new Error(String(n));return e.stderr(`[runtime-bridge] \u5220\u9664 launchd plist \u5931\u8D25: ${s.message}`),{handled:!0,exitCode:1}}else e.stdout("[runtime-bridge] awsb launchd plist \u4E0D\u5B58\u5728\uFF0C\u8DF3\u8FC7\u5220\u9664\u3002");return e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u5378\u8F7D\u3002"),{handled:!0,exitCode:0}}function Ee(e){if(!R(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=e.launchdPlistPath||D;if(!m(r))return e.stderr("[runtime-bridge] awsb launchd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const t=k(e),i=W(t),a=e.runCommand("launchctl",["kickstart",i]);if(d(a))return e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0};const n=e.runCommand("launchctl",["bootstrap",t,r]);return d(n)?(e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u542F\u52A8\u3002"),{handled:!0,exitCode:0}):(e.stderr(L("\u542F\u52A8 awsb \u670D\u52A1",n)),{handled:!0,exitCode:n.status??1})}function Re(e){if(!R(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=k(e),t=e.runCommand("launchctl",["bootout",W(r)]);return d(t)?(e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u505C\u6B62\u3002"),{handled:!0,exitCode:0}):(e.stderr(L("\u505C\u6B62 awsb \u670D\u52A1",t)),{handled:!0,exitCode:t.status??1})}function ke(e){if(!R(e.platform,e.stderr))return{handled:!0,exitCode:1};const r=e.launchdPlistPath||D;if(!m(r))return e.stderr("[runtime-bridge] awsb launchd \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u6267\u884C `awsb service install`\u3002"),{handled:!0,exitCode:1};const t=k(e);e.runCommand("launchctl",["bootout",W(t)]);const i=e.runCommand("launchctl",["bootstrap",t,r]);return d(i)?(e.stdout("[runtime-bridge] awsb launchd \u670D\u52A1\u5DF2\u91CD\u542F\u3002"),{handled:!0,exitCode:0}):(e.stderr(L("\u91CD\u542F awsb \u670D\u52A1",i)),{handled:!0,exitCode:i.status??1})}async function We(e,r,t,i){const a=e[1];if(!a||a==="-h"||a==="--help"||a==="help")return V(t),{handled:!0,exitCode:a?0:1};const n={stdout:t,stderr:i,runCommand:r.runCommand||_,platform:r.platform||process.platform,serviceUnitPath:r.serviceUnitPath||T,executablePath:r.executablePath||G(),windowsServiceManager:r.windowsServiceManager,launchdPlistPath:r.launchdPlistPath,launchdLogPath:r.launchdLogPath,launchdDomainTarget:r.launchdDomainTarget};return n.platform!=="linux"&&n.platform!=="win32"&&n.platform!=="darwin"?(i("[runtime-bridge] service \u547D\u4EE4\u4EC5\u652F\u6301 Linux systemd\u3001Windows \u670D\u52A1\u4E0E macOS launchd \u73AF\u5883\u3002"),{handled:!0,exitCode:1}):a==="install"?n.platform==="win32"?await q(n):n.platform==="darwin"?ye(n):me(n):a==="uninstall"?n.platform==="win32"?Ce(n):n.platform==="darwin"?$e(n):fe(n):a==="restart"?n.platform==="win32"?xe(n):n.platform==="darwin"?ke(n):ge(n):a==="start"?n.platform==="win32"?ve(n):n.platform==="darwin"?Ee(n):he(n):a==="stop"?n.platform==="win32"?Pe(n):n.platform==="darwin"?Re(n):we(n):(i(`[runtime-bridge] \u672A\u77E5 service \u5B50\u547D\u4EE4: ${a}`),V(t),{handled:!0,exitCode:1})}function K(e){return e?e.split(/\r?\n/).map(r=>r.trim()).filter(r=>/^\d+$/.test(r)).map(Number):[]}function Le(e){try{if(e==="win32"){const t=v("powershell",["-NoProfile","-Command",`Get-CimInstance Win32_Process -Filter "Name='node.exe'" | Where-Object { $_.CommandLine -like '*aws-runtime-bridge*' -and $_.ProcessId -ne ${process.pid} } | ForEach-Object { $_.ProcessId }`],{encoding:"utf-8"});return K(t.stdout)}const r=v("pgrep",["-f","aws-runtime-bridge"],{encoding:"utf-8"});return K(r.stdout).filter(t=>t!==process.pid)}catch{return[]}}function De(e,r){if(r==="win32"){v("taskkill",["/PID",String(e),"/F","/T"],{stdio:"ignore"});return}v("kill",["-9",String(e)],{stdio:"ignore"})}function _e(e){if(!process.stdin.isTTY)return Promise.resolve("n");const r=J({input:process.stdin,output:process.stdout});return r.question(e).finally(()=>r.close())}async function pe(e,r,t){const i=e.runCommand||_,a=e.platform||process.platform,n=e.findRunningBridgeProcesses||Le,s=e.prompt||_e,o=e.killBridgeProcess||De,u=e.globalModulePath||ie;r("[runtime-bridge] \u6B63\u5728\u66F4\u65B0 aws-runtime-bridge \u5230\u6700\u65B0\u7248\u672C...");const l=n(a).filter(b=>b!==process.pid);let w=!1;if(l.length>0){r(`[runtime-bridge] \u68C0\u6D4B\u5230 aws-runtime-bridge \u6B63\u5728\u8FD0\u884C (PID: ${l.join(", ")})\uFF0C\u66F4\u65B0\u65F6\u8FD9\u4E9B\u8FDB\u7A0B\u53EF\u80FD\u5360\u7528\u6587\u4EF6\u5BFC\u81F4\u8986\u76D6\u5931\u8D25\u3002`);const b=(await s("\u662F\u5426\u5173\u95ED\u4E0A\u8FF0\u8FDB\u7A0B\u4EE5\u7EE7\u7EED\u66F4\u65B0? (y/N) ")).trim().toLowerCase();if(b==="y"||b==="yes")for(const x of l)try{o(x,a),r(`[runtime-bridge] \u5DF2\u5173\u95ED\u8FDB\u7A0B PID: ${x}`)}catch($){const Y=$ instanceof Error?$:new Error(String($));t(`[runtime-bridge] \u5173\u95ED\u8FDB\u7A0B PID ${x} \u5931\u8D25: ${Y.message}`)}else w=!0,r("[runtime-bridge] \u5DF2\u9009\u62E9\u4E0D\u5173\u95ED\u8FDB\u7A0B\uFF0C\u5C06\u4EE5 --force \u65B9\u5F0F\u5F3A\u5236\u5B89\u88C5\uFF08\u82E5\u6587\u4EF6\u4ECD\u88AB\u5360\u7528\u53EF\u80FD\u4F1A\u6709\u8B66\u544A\uFF09\u3002")}const A=u();if(A){const b=c.join(A,"aws-runtime-bridge");if(m(b)){r("[runtime-bridge] \u6E05\u7406\u65E7\u7248\u672C\u6B8B\u7559\u76EE\u5F55...");try{Q(b,{recursive:!0,force:!0})}catch(x){const $=x instanceof Error?x:new Error(String(x));t(`[runtime-bridge] \u6E05\u7406\u6B8B\u7559\u76EE\u5F55\u5931\u8D25\uFF08\u5C06\u5C1D\u8BD5\u7EE7\u7EED\u5B89\u88C5\uFF09: ${$.message}`)}}}const M=["install","-g","aws-runtime-bridge@latest","--omit=optional"];w&&M.push("--force");const y=i("npm",M);if(y.error)return t(`[runtime-bridge] \u66F4\u65B0\u5931\u8D25: ${y.error.message}`),{handled:!0,exitCode:1};if(y.status!==0)return t(`[runtime-bridge] \u66F4\u65B0\u5931\u8D25\uFF0Cnpm \u9000\u51FA\u7801: ${y.status??"unknown"}`),{handled:!0,exitCode:y.status??1};if(a==="win32"){const b=await Te(e,r,t);if(b.exitCode!==0)return b}return r("[runtime-bridge] \u66F4\u65B0\u5B8C\u6210\u3002\u8BF7\u91CD\u65B0\u8FD0\u884C awsb -v \u67E5\u770B\u5F53\u524D\u7248\u672C\u3002"),{handled:!0,exitCode:0}}async function Te(e,r,t){const i=e.runCommand||_,a=i("sc.exe",["query",C]);if(!d(a))return{handled:!0,exitCode:0};r("[runtime-bridge] \u68C0\u6D4B\u5230 Windows \u670D\u52A1\u5DF2\u6CE8\u518C\uFF0C\u6B63\u5728\u91CD\u5EFA\u670D\u52A1\u6587\u4EF6\uFF08daemon/winsw.exe\uFF09..."),i("sc.exe",["stop",C]);const n=i("sc.exe",["delete",C]);d(n)||t(`[runtime-bridge] \u5220\u9664\u65E7 SCM \u8BB0\u5F55\u5931\u8D25: ${n.error?.message??`\u9000\u51FA\u7801 ${n.status??"unknown"}`}\uFF08\u5C1D\u8BD5\u7EE7\u7EED\u5B89\u88C5\uFF09`);const s={stdout:r,stderr:t,runCommand:i,platform:"win32",serviceUnitPath:e.serviceUnitPath||T,executablePath:e.executablePath||G(),windowsServiceManager:e.windowsServiceManager};try{return(await q(s)).exitCode!==0?(t("[runtime-bridge] \u91CD\u5EFA Windows \u670D\u52A1\u6587\u4EF6\u5931\u8D25\u3002\u5305\u5DF2\u66F4\u65B0\uFF0C\u8BF7\u624B\u52A8\u6267\u884C `awsb service uninstall && awsb service install` \u4FEE\u590D\u670D\u52A1\u3002"),{handled:!0,exitCode:0}):(r("[runtime-bridge] Windows \u670D\u52A1\u6587\u4EF6\u5DF2\u91CD\u5EFA\u3002"),{handled:!0,exitCode:0})}catch(o){const u=o instanceof Error?o:new Error(String(o));return t(`[runtime-bridge] \u91CD\u5EFA Windows \u670D\u52A1\u6587\u4EF6\u5F02\u5E38: ${u.message}\u3002\u5305\u5DF2\u66F4\u65B0\uFF0C\u8BF7\u624B\u52A8\u6267\u884C \`awsb service uninstall && awsb service install\` \u4FEE\u590D\u670D\u52A1\u3002`),{handled:!0,exitCode:0}}}function Ie(e,r,t){const a=(e.argv||process.argv.slice(2)).slice(1).some(u=>u==="--follow"||u==="-f"),n=e.platform||process.platform,s=e.runCommand||_,o=e.serviceUnitPath||T;if(n==="linux"){if(!m(o))return t("[runtime-bridge] awsb \u670D\u52A1\u5C1A\u672A\u5B89\u88C5\uFF08awsb service install\uFF09\uFF0C\u65E0\u65E5\u5FD7\u53EF\u67E5\u770B\u3002"),{handled:!0,exitCode:1};const u=["-u",f];a?u.push("-f"):u.push("-n","200","--no-pager");const l=s("journalctl",u);return l.error?(t(`[runtime-bridge] \u8BFB\u53D6\u65E5\u5FD7\u5931\u8D25: ${l.error.message}`),{handled:!0,exitCode:1}):{handled:!0,exitCode:l.status??0}}if(n==="win32"){const u=e.windowsServiceLogPath||B;if(!m(u))return t(`[runtime-bridge] \u5C1A\u672A\u751F\u6210\u65E5\u5FD7\u6587\u4EF6: ${u}\u3002\u8BF7\u5148\u6267\u884C \`awsb service install\` \u5E76\u8FD0\u884C\u670D\u52A1\u3002`),{handled:!0,exitCode:1};const l=`Get-Content -Encoding UTF8 -Tail 200 "${u}"`+(a?" -Wait":""),w=s("powershell",["-NoProfile","-Command",l]);return w.error?(t(`[runtime-bridge] \u8BFB\u53D6\u65E5\u5FD7\u5931\u8D25: ${w.error.message}`),{handled:!0,exitCode:1}):{handled:!0,exitCode:w.status??0}}if(n==="darwin"){const u=e.launchdLogPath||U;if(!m(u))return t(`[runtime-bridge] \u5C1A\u672A\u751F\u6210\u65E5\u5FD7\u6587\u4EF6: ${u}\u3002\u8BF7\u5148\u6267\u884C \`awsb service install\` \u5E76\u8FD0\u884C\u670D\u52A1\u3002`),{handled:!0,exitCode:1};const w=s("tail",a?["-f",u]:["-n","200",u]);return w.error?(t(`[runtime-bridge] \u8BFB\u53D6\u65E5\u5FD7\u5931\u8D25: ${w.error.message}`),{handled:!0,exitCode:1}):{handled:!0,exitCode:w.status??0}}return t("[runtime-bridge] awsb log \u4EC5\u652F\u6301 Linux systemd\u3001Windows \u670D\u52A1\u4E0E macOS launchd \u73AF\u5883\u3002"),{handled:!0,exitCode:1}}async function Be(e={}){const r=e.argv||process.argv.slice(2),t=r[0],i=e.stdout||se,a=e.stderr||ue;if(de(t))return i(`aws-runtime-bridge ${ae(e.packageRoot)}`),{handled:!0,exitCode:0};if(t==="update")return await pe(e,i,a);if(t==="config"){const n=r[1];if(n==="example"||n==="minimal"||n==="--minimal"||n==="-m")return{handled:!0,exitCode:await(e.configureExample||Z)()==="created"?0:1};const o=await(e.configure||X)();return{handled:!0,exitCode:o==="configured"||o==="created"?0:1}}return t==="service"?await We(r,e,i,a):t==="log"?Ie(e,i,a):{handled:!1,exitCode:0}}export{le as createLaunchdPlistContent,ce as createSystemdUnitContent,Be as handleCliCommand,ae as readPackageVersion};
 

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>;