aws-runtime-bridge 1.9.91 → 1.9.93

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;

package/dist/services/session-output.d.ts

@@ -1,22 +1,10 @@
-/**
- * 会话输出缓冲服务
- *
- * 管理终端会话的输出缓冲和刷新机制
- */
+
 import { type AxiosResponse } from "axios";
 import type { Session } from "../types.js";
 import { RingBuffer, type RingBufferEntry, type RingBufferSlice } from "./ring-buffer.js";
-/**
- * 桥接侧本地事件的 category 分类。
- * status — 状态变更事件；output — 输出增量事件；question — 询问事件；file_changed — 文件变更事件。
- */
+
 export type BridgeEventCategory = "status" | "output" | "question" | "file_changed";
-/**
- * 桥接侧 ring buffer 中存储的事件负载。
- *
- * 记录从 sendStatus / sendOutput / sendQuestionRequest / sendFileChanged
- * 产生的非关键时间线数据，供本地增量查询和调试面板使用。
- */
+
 export interface BridgeEventPayload {
     readonly category: BridgeEventCategory;
     readonly agentId: string;
@@ -43,14 +31,9 @@ export interface BridgeEventPayload {
     readonly size?: number;
     readonly toolCallId?: string;
 }
-/** RingBufferEntry 的便捷导出 */
+
 export type { RingBufferEntry, RingBufferSlice };
-/**
- * 全局桥接侧事件环状缓冲区。
- *
- * 容量 2000 条，适用于记录非关键状态/输出事件。
- * 通过 sendStatus/sendOutput 自动写入，同时保留原有的 server 回调路径。
- */
+
 export declare const bridgeEventBuffer: RingBuffer<BridgeEventPayload>;
 interface RuntimeStatusActionInfo {
     actionType?: string;
@@ -59,7 +42,7 @@ interface RuntimeStatusActionInfo {
     actionInput?: string;
     actionResult?: string;
     actionId?: string;
-    /** 父事件 ID，用于事件父子层级（如压缩子事件关联到父压缩事件） */
+    
     parentId?: string;
 }
 export interface RuntimeCallbackAuthOptions {
@@ -77,16 +60,9 @@ export interface RuntimeOutputMetadata {
     commandFilePath?: string;
     commandLineCount?: number;
 }
-/** 活跃会话存储 */
+
 export declare const sessions: Map<string, Session>;
-/**
- * 发送状态更新到调度器
- *
- * @param agentId - Agent ID
- * @param sessionId - 会话 ID
- * @param status - 状态
- * @param actionInfo - 可选的动作详情
- */
+
 export declare function sendStatus(agentId: string, sessionId: string | null, status: string, actionInfo?: RuntimeStatusActionInfo, usage?: {
     inputTokens: number;
     outputTokens: number;
@@ -95,24 +71,9 @@ export declare function sendStatus(agentId: string, sessionId: string | null, st
     inputLimit?: number;
     compactionThreshold?: number;
 }, authOptions?: RuntimeCallbackAuthOptions, timestamp?: number, sourceEventType?: string): Promise<AxiosResponse<unknown> | undefined>;
-/**
- * 发送输出到调度器
- *
- * @param agentId - Agent ID
- * @param output - 输出内容
- * @param sessionId - 会话 ID
- * @param seq - 序列号
- */
+
 export declare function sendOutput(agentId: string, output: string, sessionId: string, seq: number, metadata?: RuntimeOutputMetadata, authOptions?: RuntimeCallbackAuthOptions, signal?: AbortSignal): Promise<void>;
-/**
- * 发送 AskUserQuestion 事件到调度器。
- *
- * @param agentId - Agent ID
- * @param sessionId - SDK 会话 ID
- * @param questions - 结构化问题列表
- * @param authOptions - 运行时鉴权选项
- * @param toolCallId - 提问实例的唯一标识，用于前端区分同一会话内连续多次提问
- */
+
 export declare function sendQuestionRequest(agentId: string, sessionId: string, questions: unknown[], authOptions?: RuntimeCallbackAuthOptions, toolCallId?: string): Promise<void>;
 export interface RuntimeFileChangedPayload {
     bridgeBaseUrl?: string;
@@ -122,25 +83,11 @@ export interface RuntimeFileChangedPayload {
     size?: number;
     mtimeMs?: number;
 }
-/**
- * 发送工作区文件变更事件到调度器，由调度器通过 WebSocket 通知前端刷新预览。
- */
+
 export declare function sendFileChanged(payload: RuntimeFileChangedPayload): Promise<void>;
-/**
- * 追加会话输出到有界缓冲区。
- *
- * 主流程：拼接新输出 -> 超过上限时丢弃最旧终端噪声并保留截断提示 -> 等待 flush pump 批量发送。
- */
+
 export declare function appendSessionOutput(sessionId: string, data: string): void;
-/**
- * 调度输出刷新
- *
- * @param sessionId - 会话 ID
- */
+
 export declare function scheduleOutputFlush(sessionId: string): void;
-/**
- * 刷新会话输出
- *
- * @param sessionId - 会话 ID
- */
+
 export declare function flushSessionOutput(sessionId: string): Promise<void>;

package/dist/services/startup-config-wizard.d.ts

@@ -10,13 +10,9 @@ interface StartupConfigFile {
     autoRegisterTargets?: AutoRegisterTargetConfig[];
     [key: string]: unknown;
 }
-/**
- * 最小配置示例模板（占位符，不含任何真实密钥）。
- * `awsb config example` 与向导中的「最小配置」选项都会基于它生成示例。
- * 注意：模板内的 value 均为 <占位符>，切勿写入真实凭据——真实值应由用户手填。
- */
+
 export declare const MINIMAL_CONFIG_TEMPLATE: StartupConfigFile;
-/** 将最小配置模板格式化为可读的示例文本（占位符版）。 */
+
 export declare function formatConfigExample(template?: object): string;
 interface PromptIO {
     question(prompt: string): Promise<string>;
@@ -32,9 +28,6 @@ interface EnsureStartupConfigOptions {
 export type StartupConfigWizardResult = "exists" | "created" | "configured" | "skipped" | "non-interactive" | "failed";
 export declare function ensureStartupConfig(options?: EnsureStartupConfigOptions): Promise<StartupConfigWizardResult>;
 export declare function configureStartupConfig(options?: EnsureStartupConfigOptions): Promise<StartupConfigWizardResult>;
-/**
- * `awsb config example`：直接打印最小配置示例（占位符版），
- * 并把模板写入 config.json 供用户稍后手动填值。非交互环境也能用。
- */
+
 export declare function printConfigExampleCommand(options?: EnsureStartupConfigOptions): Promise<StartupConfigWizardResult>;
 export {};

package/dist/services/system-metrics.d.ts

@@ -32,8 +32,5 @@ export interface SystemMetricsSnapshot {
     storage: SystemStorageMetrics;
     network: SystemNetworkMetrics;
 }
-/**
- * 汇总机器关键指标快照。
- * 主流程：并行采集内存/存储/网络，CPU 做短采样后合并为前端可展示结构。
- */
+
 export declare function collectSystemMetrics(): Promise<SystemMetricsSnapshot>;

package/dist/services/terminal-persistence.d.ts

@@ -1,71 +1,28 @@
-/**
- * 终端会话持久化服务
- *
- * 管理终端会话元数据的持久化存储
- */
+
 import type { PersistedSession } from '../types.js';
-/**
- * 获取持久化会话文件路径
- *
- * @returns 会话文件路径
- */
+
 export declare function getPersistedSessionsFile(): string;
-/**
- * 加载持久化的终端会话列表
- *
- * @returns 持久化会话列表
- */
+
 export declare function loadPersistedSessions(): Promise<PersistedSession[]>;
-/**
- * 保存持久化的终端会话列表
- *
- * @param sessions - 会话列表
- */
+
 export declare function savePersistedSessions(sessions: PersistedSession[]): Promise<void>;
-/**
- * 添加或更新持久化会话
- *
- * @param session - 会话数据
- */
+
 export declare function upsertPersistedSession(session: PersistedSession): Promise<void>;
-/**
- * 更新指定 Agent 的持久化自动命令配置。
- *
- * 主流程：加载 running 会话 -> 命中 agentId 时只替换自动命令字段，保留原 command/workspace/pid。
- */
+
 export declare function updatePersistedSessionAutoCommands(agentId: string, commands: {
     idleInputAutoCommand: string;
     nonInputAutoCommand: string;
 }): Promise<boolean>;
-/**
- * 更新指定 SDK 会话的细粒度运行状态。
- *
- * 主流程：命中 sessionId 后仅替换 runtimeStatus/runtimeAction* 字段，保留会话 PID、命令和工作目录，
- * 让 scheduler/server 重启后可以从 /runtime/sessions 恢复 Agent 卡片上的具体状态标签。
- */
+
 export declare function updatePersistedSessionRuntimeState(sessionId: string, runtimeState: {
     runtimeStatus: string;
     runtimeActionType?: string;
     runtimeActionLabel?: string;
     runtimeActionDetail?: string;
 }): Promise<boolean>;
-/**
- * 移除持久化会话（从完整文件中删除，包括 stopped 状态的）
- *
- * @param sessionId - 会话 ID
- */
+
 export declare function removePersistedSession(sessionId: string): Promise<void>;
-/**
- * 根据 agentId 查找持久化会话
- *
- * @param agentId - Agent ID
- * @returns 持久化会话，未找到返回 undefined
- */
+
 export declare function findPersistedSessionByAgentId(agentId: string): Promise<PersistedSession | undefined>;
-/**
- * 根据 agentId 移除持久化会话
- * 用于确保停止时能删除正确的持久化会话
- *
- * @param agentId - Agent ID
- */
+
 export declare function removePersistedSessionByAgentId(agentId: string): Promise<void>;

package/dist/services/tool-installer.d.ts

@@ -10,13 +10,9 @@ type ToolCommand = {
 };
 export declare const SUPPORTED_INSTALLABLE_TOOLS: readonly string[];
 export declare const SUPPORTED_UNINSTALLABLE_TOOLS: readonly string[];
-/**
- * 返回工具对应的全局卸载命令副本，用于诊断与测试卸载覆盖范围。
- */
+
 export declare function getToolUninstallCommands(tool: string): string[];
-/**
- * 返回工具对应的安装/卸载执行参数副本，用于验证 Windows 下不会把路径引号传给 npm。
- */
+
 export declare function getToolCommandSpecs(tool: string, phase: "install" | "uninstall"): Array<{
     command: string;
     args: string[];
@@ -32,20 +28,12 @@ export declare function buildSdkCliInstallStatus(tool: string, sdkResult: {
     executable: string | null;
     error: string | null;
 }, requiresCli: boolean): ToolInstallStatus;
-/**
- * 检查单个工具的 CLI 可执行状态，供实例状态展示与初始化前判断使用。
- */
+
 export declare function detectToolInstallStatus(tool: string): Promise<ToolInstallStatus>;
-/**
- * 批量检查工具安装状态，统一返回给前端面板和实例状态持久化。
- */
+
 export declare function detectToolStatuses(tools: string[]): Promise<Record<string, ToolInstallStatus>>;
-/**
- * 根据勾选工具自动安装缺失 CLI，安装后重新检测状态并返回。
- */
+
 export declare function ensureToolsInstalled(tools: string[]): Promise<Record<string, ToolInstallStatus>>;
-/**
- * 按工具定义执行全局卸载命令，随后重新检测并返回最新安装状态。
- */
+
 export declare function uninstallTools(tools: string[]): Promise<Record<string, ToolInstallStatus>>;
 export {};

package/dist/services/tunnel-client.d.ts

@@ -1,20 +1,5 @@
-/**
- * Bridge 反向隧道客户端
- *
- * 当 bridge 位于 NAT/内网（无公网），server 有公网时：bridge 注册虚拟隧道地址
- *（形如 http(s)://server/tunnel/{instanceId}），注册成功后通过本客户端主动连出到
- * server 的 /ws/bridge-tunnel，server 对 bridge 的 HTTP/WebSocket 调用均经此隧道转发。
- *
- * 多 server 支持：autoRegisterTargets 配置多个 server 时，每个 server 注册成功后
- * 各自建立一条独立隧道，按归一化 serverUrl 为 key 并存于 tunnels Map，互不干扰；
- * 同一 server 重复注册（重试/token 轮换）时先拆旧隧道再以最新 instanceId 重建。
- *
- * 协议帧格式见 BridgeTunnelService（server 端）。
- */
-/**
- * 启动（或重启）到指定 server 的隧道。
- * 同一 serverUrl 已存在隧道时先拆旧重建，不同 serverUrl 的隧道并存。
- */
+
+
 export declare function startTunnelClient(serverUrl: string, instanceId: string): void;
-/** 停止全部隧道（graceful shutdown 用） */
+
 export declare function stopTunnelClient(): void;

package/dist/services/windows-service-manager.d.ts

@@ -1,16 +1,4 @@
-/**
- * node-windows 封装模块。
- *
- * node-windows 内部使用 WinSW（.NET 服务包装器）实现 SCM 协议适配，
- * 用户 `npm install -g aws-runtime-bridge` 时自动获得，无需额外安装 nssm。
- *
- * 关键行为：
- * - install 时在 `path.dirname(script)/daemon/` 下创建 winsw.exe + XML 配置；
- * - `logpath` 配置项控制日志输出目录（WinSW 生成 `<id>.out.log` / `<id>.err.log`）；
- * - node-windows 1.0.0-beta.8 硬编码把 `id: this._exe`（即 `name + '.exe'`）写入 WinSW XML 的
- *   `<id>`，因此注册到 SCM 的服务名是 `awsb.exe`，不是 `awsb`。调用方做 sc.exe 操作时
- *   必须用 `awsb.exe`，否则会报 1060（服务未安装）。
- */
+
 export interface WindowsServiceConfig {
     name: string;
     description: string;

package/dist/services/workspace-files.d.ts

@@ -1,7 +1,4 @@
-/**
- * 工作区文件服务
- * 负责在工作区范围内安全地浏览、读取与保存文件。
- */
+
 export interface WorkspaceFileItem {
     name: string;
     path: string;
@@ -161,58 +158,37 @@ export interface ChmodWorkspaceEntryResult {
     recursive: boolean;
     changedCount: number;
 }
-/**
- * 列出工作区目录内容。
- */
+
 export declare function listWorkspaceDirectory(params: WorkspacePathParams): Promise<ListWorkspaceDirectoryResult>;
-/**
- * 读取工作区中的文本文件。
- */
+
 export declare function readWorkspaceFile(params: WorkspaceFileParams): Promise<ReadWorkspaceFileResult>;
-/**
- * 读取工作区条目的属性信息。
- * 主流程：解析安全路径 -> 读取 stat/lstat -> 文件额外尝试解析图片尺寸。
- * 对于目录，stat.size 只是目录项元数据大小，需要递归统计子文件总和。
- */
+
 export declare function getWorkspaceEntryProperties(params: DeleteWorkspaceEntryParams): Promise<WorkspaceEntryPropertiesResult>;
-/**
- * 修改工作区条目权限。
- * 主流程：校验八进制权限 -> 解析安全路径 -> 非递归只改目标，递归目录先收集所有非符号链接子项后逐一 chmod。
- */
+
 export declare function chmodWorkspaceEntry(params: ChmodWorkspaceEntryParams): Promise<ChmodWorkspaceEntryResult>;
-/**
- * 返回工作区内 Word 文档的预览元数据；docx 由前端下载原文件后渲染，旧版 doc 明确提示不支持。
- */
+
 export declare function previewWorkspaceDocument(params: WorkspaceFileParams): Promise<WorkspaceDocumentPreviewResult>;
-/**
- * 将文本内容保存到工作区文件中。
- */
+
 export declare function writeWorkspaceFile(params: WriteWorkspaceFileParams): Promise<{
     ok: true;
     workspacePath: string;
     filePath: string;
 }>;
-/**
- * 在指定工作区目录下创建文件或目录。
- */
+
 export declare function createWorkspaceEntry(params: CreateWorkspaceEntryParams): Promise<{
     ok: true;
     workspacePath: string;
     targetPath: string;
     isDirectory: boolean;
 }>;
-/**
- * 在工作区内重命名文件或目录，保持目标仍位于原父目录中。
- */
+
 export declare function renameWorkspaceEntry(params: RenameWorkspaceEntryParams): Promise<{
     ok: true;
     workspacePath: string;
     sourcePath: string;
     targetPath: string;
 }>;
-/**
- * 将工作区内文件或目录移动到另一个工作区目录，保持原文件名不变。
- */
+
 export declare function moveWorkspaceEntry(params: MoveWorkspaceEntryParams): Promise<{
     ok: true;
     workspacePath: string;
@@ -220,17 +196,13 @@ export declare function moveWorkspaceEntry(params: MoveWorkspaceEntryParams): Pr
     targetPath: string;
     destinationPath: string;
 }>;
-/**
- * 删除工作区内的文件或目录，并阻止误删工作区根目录。
- */
+
 export declare function deleteWorkspaceEntry(params: DeleteWorkspaceEntryParams): Promise<{
     ok: true;
     workspacePath: string;
     targetPath: string;
 }>;
-/**
- * 上传文件到工作区指定目录，并可在上传后自动解压常见归档。
- */
+
 export declare function uploadWorkspaceFiles(params: UploadWorkspaceFilesParams): Promise<{
     ok: true;
     workspacePath: string;
@@ -242,26 +214,14 @@ export declare function uploadWorkspaceFiles(params: UploadWorkspaceFilesParams)
         extracted?: WorkspaceArchiveExtractResult;
     }>;
 }>;
-/**
- * 解析工作区下载目标；目录由路由层打包为 zip，文件直接流式下载。
- */
+
 export declare function resolveWorkspaceDownloadTarget(params: DownloadWorkspaceEntryParams): Promise<WorkspaceDownloadTarget>;
-/**
- * 将目录内容以 zip 格式写入输出流，避免在磁盘生成临时包。
- */
+
 export declare function streamWorkspaceDirectoryZip(directoryPath: string, output: NodeJS.WritableStream): Promise<void>;
-/**
- * 解压工作区中的归档文件到指定目录，支持 zip、tar、tar.gz/tgz 与单文件 gz。
- */
+
 export declare function extractWorkspaceArchive(params: ExtractWorkspaceArchiveParams): Promise<WorkspaceArchiveExtractResult>;
-/**
- * 在工作区范围内搜索文件内容。
- * 主流程：安全解析工作区根 -> 递归遍历目录 -> 按文件掩码过滤 -> 逐行匹配关键词 -> 返回匹配列表。
- */
+
 export declare function searchWorkspaceFiles(params: SearchWorkspaceFilesParams): Promise<SearchWorkspaceFilesResult>;
-/**
- * 在工作区范围内批量替换文件内容。
- * 可指定 filePath 只替换单个文件；未指定时递归替换所有匹配掩码的文件。
- */
+
 export declare function replaceWorkspaceFiles(params: ReplaceWorkspaceFilesParams): Promise<ReplaceWorkspaceFilesResult>;
 export {};

package/dist/services/workspace-watch.d.ts

@@ -2,17 +2,13 @@ interface WorkspaceFileWatchParams {
     workspacePath: string;
     filePath: string;
 }
-/**
- * 开始监听工作区内单个文件，重复监听同一文件会复用已有 watcher。
- */
+
 export declare function watchWorkspaceFile(params: WorkspaceFileWatchParams): Promise<{
     ok: true;
     workspacePath: string;
     filePath: string;
 }>;
-/**
- * 停止监听工作区内单个文件；未监听时保持幂等。
- */
+
 export declare function unwatchWorkspaceFile(params: WorkspaceFileWatchParams): Promise<{
     ok: true;
 }>;

package/dist/services/workspaceTaskChangeWatcher.d.ts

@@ -1,14 +1,4 @@
-/**
- * 工作区文件变更精确记录服务
- *
- * **仅通过 Agent 文件操作工具拦截记录变更**（write_file/edit_file/delete_file），
- * 不再使用 fs.watch 全量监听（无法区分 Agent 修改与用户手动修改）。
- *
- * - recordAgentFileChange() 由工具 execute 成功后直接调用
- * - 变更内容（diff/beforeContent）持久化到 bridge 本地 .agentswork/change-cache
- * - 变更元数据 + cacheKey 通过 HTTP 上报到 mcp-server
- * - 差异回滚时从数据库读取记录、从 bridge 缓存读取 diff
- */
+
 export interface TaskContext {
     agentId: string;
     taskInstanceId: string;
@@ -27,57 +17,29 @@ export interface FileChangeRecord {
     afterHash: string | null;
     timestamp: string;
 }
-/**
- * 设置当前活跃任务上下文。
- * 调用时机：Agent 通过 startTaskNode 开始处理任务节点时，由 server 回调通知。
- */
+
 export declare function setTaskContext(ctx: TaskContext): void;
-/**
- * 清除当前任务上下文。
- * 调用时机：Agent 提交任务结果后，或任务被中断/取消时。
- */
+
 export declare function clearTaskContext(): void;
-/**
- * 获取当前活跃任务上下文。
- */
+
 export declare function getTaskContext(): TaskContext | null;
-/**
- * 检查是否有活跃任务上下文。
- */
+
 export declare function hasActiveTask(): boolean;
-/**
- * 设置工作区路径（不再启动 fs.watch，仅记录路径供工具拦截上报使用）。
- * 如果已有活跃的 watcher 则会先关闭。
- */
+
 export declare function startWatching(targetWorkspacePath: string): Promise<void>;
-/**
- * 停止工作区监听（清理状态）。
- */
+
 export declare function stopWatching(): Promise<void>;
-/**
- * 从 bridge 本地缓存读取变更前的文件内容（供 DELETE 回滚使用）。
- */
+
 export declare function readBeforeContentFromCache(workspacePath: string, cacheKey: string): Promise<string | null>;
-/**
- * 从 bridge 本地缓存读取 diff patch（供 UPDATE 精确回滚使用）。
- */
+
 export declare function readDiffFromCache(workspacePath: string, cacheKey: string): Promise<string | null>;
-/**
- * 获取正在监控的文件变更数量（用于测试）。
- */
+
 export declare function getPendingChangeCountForTest(): number;
-/**
- * 判断工作区是否正在被监听。
- */
+
 export declare function isWatching(): boolean;
-/**
- * 获取当前工作区路径。
- */
+
 export declare function getWorkspaceRoot(): string;
-/**
- * 由 Agent 文件操作工具直接调用，精确记录变更并上报。
- * 仅在工具 execute 成功后调用，确保记录的都是实际发生的变更。
- */
+
 export declare function recordAgentFileChange(record: {
     filePath: string;
     operation: 'CREATE' | 'UPDATE' | 'DELETE';

package/dist/types.d.ts

@@ -1,20 +1,14 @@
 import type { AppFlags } from '@cc-switch/sdk';
 import type { Request, Response, NextFunction } from 'express';
 export type { McpServerSpec, AppFlags } from '@cc-switch/sdk';
-/**
- * MCP 服务器创建输入类型
- * 用于 createMcpServer 方法的参数
- */
+
 export interface CreateMcpServerInput {
     name: string;
     server: import('@cc-switch/sdk').McpServerSpec;
     description?: string;
     apps?: Partial<AppFlags>;
 }
-/**
- * MCP 服务器更新输入类型
- * 用于 updateMcpServer 方法的参数
- */
+
 export interface UpdateMcpServerInput {
     name?: string;
     server?: import('@cc-switch/sdk').McpServerSpec;

package/dist/utils/instance-ai-config-debug-logger.d.ts

@@ -1,9 +1,4 @@
-/**
- * Instance AI 配置调试日志记录器
- *
- * 将 AI 配置解析/应用过程写入固定日志文件，
- * 供 bridge + 后端共享调试。
- */
+
 export interface DebugLogEntry {
     level: "info" | "warn" | "error";
     category: string;
@@ -13,24 +8,14 @@ export interface DebugLogEntry {
     agentId?: string;
     details?: Record<string, unknown>;
 }
-/**
- * 调试日志记录器。
- * 所有日志异步追加到固定文件，不阻塞主流程。
- */
+
 export declare class InstanceAiConfigDebugLogger {
     private readonly logPath;
     constructor(logPath?: string);
-    /**
-     * 写入一条调试日志。
-     * 格式：ISO时间 | level | 消息
-     */
+    
     log(entry: DebugLogEntry): Promise<void>;
-    /**
-     * 刷新日志（当前实现为无操作，追加写入天然实时落盘）。
-     */
+    
     flush(): Promise<void>;
 }
-/**
- * 获取全局单例的调试日志记录器。
- */
+
 export declare function getInstanceAiConfigDebugLogger(): InstanceAiConfigDebugLogger;