aws-runtime-bridge 1.9.92 → 1.9.93

package/dist/adapter/types.d.ts

@@ -1,72 +1,44 @@
-/**
- * Provider Adapter 抽象层类型定义
- * SDK 架构核心 —— 统一事件流接口
- *
- * 参考自 SpectrAI 项目的 adapter 设计，用于支持多种 AI Provider
- */
+
 import { EventEmitter } from "node:events";
 export type SessionStatus = "starting" | "thinking" | "tool_using" | "waiting_input" | "completed" | "terminated" | "error" | "compacting";
 export type ProviderEventType = "ai_request" | "text_delta" | "thinking" | "command_output" | "tool_use_start" | "tool_use_end" | "permission_request" | "ask_user_question" | "exit_plan_mode" | "turn_complete" | "session_complete" | "error" | "context_compaction" | "runtime_capabilities";
-/**
- * Agent 工具动作类型分类
- * 用于细粒度显示 agent 当前正在执行的具体动作
- */
+
 export type ToolActionType = "skill" | "mcp" | "idle" | "edit_file" | "write_file" | "read_file" | "bash" | "search" | "web" | "ai_request" | "lsp" | "notebook" | "other" | "context_compaction" | "runtime_capabilities";
-/**
- * 工具动作信息
- */
+
 export interface ToolActionInfo {
-    /** 动作类型分类 */
+    
     actionType: ToolActionType;
-    /** 动作显示标签（中文） */
+    
     actionLabel: string;
-    /** 具体描述（如文件名、命令等） */
+    
     actionDetail?: string;
 }
-/**
- * MCP 元数据（从 SDK tool state.metadata 中提取）
- */
+
 export interface ToolMetadata {
-    /** MCP server 名称（如 "aws-mcp"） */
+    
     mcpServer?: string;
-    /** 其他元数据 */
+    
     [key: string]: unknown;
 }
-/**
- * 脱敏终端剪贴板生成的临时 paste 文件路径。
- * 主流程：匹配 Windows/POSIX/裸目录形式 -> 替换为稳定占位符，避免临时文件路径进入日志与状态详情。
- */
+
 export declare function redactTransientClipboardPastePaths(text: string): string;
-/**
- * 判断输入是否只是终端剪贴板生成的临时 paste 文件路径。
- * 主流程：剥离包裹引号 -> 要求整串匹配，避免误拦截显式读取该文件的正常命令。
- */
+
 export declare function isTransientClipboardPasteFilePath(text: string): boolean;
-/**
- * 递归脱敏工具展示参数，保留真实执行输入不变，仅用于日志/状态/时间线展示。
- */
+
 export declare function redactTransientClipboardPastePathsInValue(value: unknown): unknown;
 export declare function getCanonicalMcpDetail(rawToolName: string): string;
-/**
- * 根据工具名称获取动作类型信息
- * @param toolName 工具名称
- * @param toolInput 工具输入参数
- * @param metadata SDK 提供的元数据（可能包含 MCP server 信息）
- */
+
 export declare function getToolActionInfo(toolName: string | undefined, toolInput?: Record<string, unknown>, metadata?: ToolMetadata): ToolActionInfo;
 export interface RuntimeTokenUsage {
     inputTokens: number;
     outputTokens: number;
-    /** Model context window token limit used for the used/limit display. */
+    
     contextLimit?: number;
-    /** Model max output token limit, used to compute the compaction point. */
+    
     maxOutput?: number;
-    /** Provider 显式输入上限（部分 Provider 的 input+output 总额 ≠ context 上限）。
-     *  来自 runtime resolveProviderConfig，前端用于精确显示压缩点。 */
+    
     inputLimit?: number;
-    /** 后端实际触发压缩的阈值（= min(contextLimit×动态比例, hardLimit - min(buffer, maxOutput))）。
-     *  动态比例按窗口大小分级（<32K=0.70, 32K-128K=0.75, 128K-512K=0.80, >=512K=0.85）。
-     *  前端 AgentContextPanel 优先用此值显示竖线，消除前端自算公式的脱节。 */
+    
     compactionThreshold?: number;
 }
 export type CommandOutputStream = "stdout" | "stderr" | "mixed";
@@ -74,11 +46,11 @@ export interface RuntimeStatusActionInfo {
     actionType?: ToolActionType;
     actionLabel?: string;
     actionDetail?: string;
-    /** 工具调用输入参数的 JSON 序列化字符串，用于在时间线上展示 */
+    
     actionInput?: string;
     actionResult?: string;
     actionId?: string;
-    /** 父事件 ID，用于事件父子层级（如压缩子事件关联到父压缩事件） */
+    
     parentId?: string;
     usage?: RuntimeTokenUsage;
 }
@@ -87,49 +59,49 @@ export interface ProviderEvent {
     sessionId: string;
     timestamp: string;
     data: {
-        /** 文本内容（text_delta / thinking / error） */
+        
         text?: string;
-        /** AI 请求模型名称（ai_request） */
+        
         model?: string;
-        /** AI 请求 endpoint 摘要（ai_request，不含密钥） */
+        
         endpoint?: string;
-        /** AI 请求方法（ai_request） */
+        
         requestMethod?: string;
-        /** AI 请求完整 URL（ai_request，不含密钥） */
+        
         requestUrl?: string;
-        /** AI 请求头（ai_request，敏感值已脱敏） */
+        
         requestHeaders?: Record<string, string>;
-        /** AI 请求是否流式返回（ai_request）或命令输出流名（command_output） */
+        
         stream?: boolean | CommandOutputStream;
-        /** AI 请求上下文消息数量（ai_request） */
+        
         messageCount?: number;
-        /** AI 请求可用工具数量（ai_request） */
+        
         toolCount?: number;
-        /** AI 请求最后一条用户消息预览（ai_request） */
+        
         lastUserMessagePreview?: string;
-        /** AI 请求体完整 JSON（ai_request，不含 header/API key） */
+        
         requestBody?: string;
-        /** 工具名称（tool_use_start / tool_use_end） */
+        
         toolName?: string;
-        /** 工具输入参数（tool_use_start / ask_user_question / exit_plan_mode） */
+        
         toolInput?: Record<string, unknown>;
-        /** 工具执行结果（tool_use_end） */
+        
         toolResult?: string;
-        /** 工具调用是否出错（tool_use_end） */
+        
         isError?: boolean;
-        /** Token 用量（turn_complete） */
+        
         usage?: RuntimeTokenUsage;
-        /** AI 响应体完整 JSON（turn_complete，不含请求 header/API key） */
+        
         responseBody?: string;
-        /** AI 响应结束原因（turn_complete） */
+        
         finishReason?: string;
-        /** 退出码（session_complete） */
+        
         exitCode?: number;
-        /** 权限请求描述（permission_request） */
+        
         permissionPrompt?: string;
-        /** 工具调用 ID（关联 start/end） */
+        
         toolUseId?: string;
-        /** AskUserQuestion 的问题列表 */
+        
         questions?: Array<{
             question: string;
             header?: string;
@@ -139,40 +111,37 @@ export interface ProviderEvent {
             }>;
             multiple?: boolean;
         }>;
-        /** 工具动作类型（tool_use_start） */
+        
         actionType?: ToolActionType;
-        /** 工具动作显示标签（tool_use_start） */
+        
         actionLabel?: string;
-        /** 工具动作详情（tool_use_start） */
+        
         actionDetail?: string;
-        /** 工具调用关联 ID（tool_use_start / tool_use_end） */
+        
         actionId?: string;
-        /** 父事件 ID，用于事件父子层级（如压缩子事件关联到父压缩事件） */
+        
         parentId?: string;
-        /** 工具返回数据（tool_use_end） */
+        
         actionResult?: string;
-        /** 命令输出批次序号（command_output） */
+        
         sequence?: number;
-        /** 命令执行目录（command_output） */
+        
         cwd?: string;
-        /** 超长命令落盘路径（command_output） */
+        
         commandFilePath?: string;
-        /** 命令行数（command_output） */
+        
         commandLineCount?: number;
-        /** 运行时能力清单（runtime_capabilities） */
+        
         capabilities?: RuntimeCapabilities;
     };
 }
-/**
- * 运行时能力清单
- * 描述 ACode 会话启动时加载的 MCP 工具与 Skill 列表，供前端调试面板展示。
- */
+
 export interface RuntimeSkillGroup {
-    /** 目录完整路径 */
+    
     dir: string;
-    /** 目录是否存在 */
+    
     exists: boolean;
-    /** 该目录下的 skills 列表 */
+    
     skills: Array<{
         name: string;
         description?: string;
@@ -180,117 +149,107 @@ export interface RuntimeSkillGroup {
     }>;
 }
 export interface RuntimeCapabilities {
-    /** 能力类型：mcp / skill / combined（合并的完整能力清单） */
+    
     kind: "mcp" | "skill" | "combined";
-    /** MCP 服务器名列表 */
+    
     mcpServers?: string[];
-    /** MCP 工具列表 */
+    
     mcpTools?: Array<{
         name: string;
         source: string;
         description?: string;
     }>;
-    /** Skill 列表（所有目录合并，向后兼容） */
+    
     skills?: Array<{
         name: string;
         description?: string;
         directory?: string;
     }>;
-    /** Skill 目录路径（全局，向后兼容） */
+    
     skillsDir?: string;
-    /** 按目录分组的 Skill 列表，供前端按目录展示（含空目录节点） */
+    
     skillGroups?: RuntimeSkillGroup[];
 }
-/**
- * 实例自配置 AI provider 覆盖（仅 ACode 适配器消费）。
- *
- * 优先级：API 请求体（per-launch）> 环境变量 > bridge 下的 instance-acode-config.json 文件。
- * 实例配置优先于 acode.json 全局 provider.default 配置；AcodeSdkAdapter 内部按
- * "instance > global > default" 三层逐字段仲裁 model / baseURL / apiKey。
- */
+
 export interface AdapterInstanceAiConfig {
     model?: string;
     baseURL?: string;
     apiKey?: string;
-    /** Per-instance model reasoning effort (minimal|low|medium|high|xhigh) */
+    
     effort?: string;
-    /** Sub Agent 专用模型覆盖（空值=继承主 Agent 模型，仅 ACode 消费） */
+    
     subAgentModel?: string;
-    /** Sub Agent 专用思考强度覆盖（空值=继承主 Agent 强度，仅 ACode 消费） */
+    
     subAgentEffort?: string;
 }
 export interface AdapterSessionConfig {
-    /** CLI 命令（支持绝对路径） */
+    
     command: string;
-    /** 工作目录 */
+    
     workingDirectory: string;
-    /** Agent ID（用于 spillover 文件路径隔离） */
+    
     agentId?: string;
-    /** 初始 prompt（创建会话后自动发送） */
+    
     initialPrompt?: string;
-    /** 初始 prompt 是否显示为用户消息 */
+    
     initialPromptVisibility?: "visible" | "hidden";
-    /** 是否自动确认所有工具调用 */
+    
     autoAccept: boolean;
-    /** 系统提示注入 */
+    
     systemPrompt?: string | {
         type: string;
         preset: string;
         append: string;
     };
-    /** 全局提示词（ACode 使用，作为 System 1） */
+    
     globalPrompt?: string;
-    /** 角色提示词（ACode 使用，作为 System 2） */
+    
     rolePrompt?: string;
-    /** 记忆内容（ACode 使用，作为 System 3） */
+    
     memory?: string;
-    /** 模型名称覆盖（per-session 粒度，优先级最高） */
+    
     model?: string;
-    /** 最大对话轮次（0=无限） */
+    
     maxTurns?: number;
-    /** 允许的工具列表（空=全部） */
+    
     allowedTools?: string[];
-    /** MCP 配置路径；如为 per-instance 文件则由 instance-ai-config-service 写入 */
+    
     mcpConfigPath?: string;
-    /**
-     * 实例自配置 AI provider 覆盖（仅 ACode 消费）。AcodeSdkAdapter 内部会按
-     * "instance > global > default" 优先级仲裁，并将 baseURL/apiKey 写入
-     * per-instance acode.json 后作为 configPath 使用。
-     */
+    
     instanceAiConfig?: AdapterInstanceAiConfig;
-    /** Sub Agent 模型覆盖（仅 ACode 消费，空值=继承主 Agent 模型） */
+    
     subAgentModel?: string;
-    /** Sub Agent 思考强度覆盖（仅 ACode 消费，空值=继承主 Agent 强度） */
+    
     subAgentEffort?: string;
-    /** Provider 特定参数 */
+    
     providerArgs?: string[];
-    /** 环境变量覆盖 */
+    
     envOverrides?: Record<string, string>;
-    /** 额外 MCP 服务器 */
+    
     extraMcpServers?: Record<string, unknown>;
-    /** Node.js 版本 */
+    
     nodeVersion?: string;
-    /** Claude Code 可执行文件路径 */
+    
     executablePath?: string;
-    /** git-bash 路径（仅 Windows） */
+    
     gitBashPath?: string;
-    /** 工作区内额外目录 */
+    
     additionalDirectories?: string[];
 }
 export interface AdapterSession {
-    /** 内部会话 ID */
+    
     sessionId: string;
-    /** Provider 端的会话 ID（用于恢复） */
+    
     providerSessionId?: string;
-    /** 当前状态 */
+    
     status: SessionStatus;
-    /** 对话消息历史 */
+    
     messages: ConversationMessage[];
-    /** 创建时间 */
+    
     createdAt: string;
-    /** Token 用量快照（input=当前上下文大小，output=当前轮输出，均为覆盖式赋值） */
+    
     totalUsage: RuntimeTokenUsage;
-    /** SDK 进程 PID（用于检测进程是否存活） */
+    
     pid?: number;
 }
 export interface ConversationMessage {
@@ -299,15 +258,15 @@ export interface ConversationMessage {
     role: "user" | "assistant" | "tool_use" | "tool_result";
     content: string;
     timestamp: string;
-    /** 工具名称（tool_use / tool_result） */
+    
     toolName?: string;
-    /** 工具输入参数（tool_use） */
+    
     toolInput?: Record<string, unknown>;
-    /** 工具结果（tool_result） */
+    
     toolResult?: string;
-    /** 是否出错（tool_result） */
+    
     isError?: boolean;
-    /** 工具调用 ID */
+    
     toolUseId?: string;
 }
 export interface PermissionRequest {
@@ -318,7 +277,7 @@ export interface PermissionRequest {
 }
 export interface AskUserQuestionRequest {
     sessionId: string;
-    /** 提问实例的唯一标识（toolCallId），用于前端精确去重，区分同一会话内连续多次提问 */
+    
     toolCallId?: string;
     questions: Array<{
         question: string;
@@ -330,129 +289,52 @@ export interface AskUserQuestionRequest {
         multiple?: boolean;
     }>;
 }
-/**
- * Provider Adapter 基类
- *
- * 每个 AI CLI 工具对应一个 Adapter 实现，负责：
- * 1. 管理 CLI 进程/SDK 客户端的生命周期
- * 2. 将 Provider 特定的消息格式转换为统一的 ProviderEvent
- * 3. 维护对话消息历史
- *
- * 事件:
- * - 'event'(ProviderEvent) — 统一事件流
- * - 'status-change'(sessionId, SessionStatus) — 会话状态变更
- * - 'permission-request'(PermissionRequest) — 权限确认请求
- * - 'ask-user-question'(AskUserQuestionRequest) — 用户问答请求
- */
+
 export declare abstract class BaseProviderAdapter extends EventEmitter {
-    /** Provider 唯一标识（如 'claude-code', 'opencode'） */
+    
     abstract readonly providerId: string;
-    /** 友好名称（如 'Claude Code', 'OpenCode'） */
+    
     abstract readonly displayName: string;
-    /**
-     * 启动新会话
-     * @param sessionId 内部会话 ID
-     * @param config 会话配置
-     */
+    
     abstract startSession(sessionId: string, config: AdapterSessionConfig): Promise<void>;
-    /**
-     * 发送用户消息（触发新一轮对话）
-     * @param sessionId 会话 ID
-     * @param message 用户消息文本
-     */
+    
     abstract sendMessage(sessionId: string, message: string): Promise<void>;
-    /**
-     * 回应权限确认请求
-     * @param sessionId 会话 ID
-     * @param accept true=允许, false=拒绝
-     */
+    
     abstract sendConfirmation(sessionId: string, accept: boolean): Promise<void>;
-    /**
-     * 回答 AskUserQuestion
-     * @param sessionId 会话 ID
-     * @param answers 答案映射
-     */
+    
     abstract sendQuestionAnswer?(sessionId: string, answers: Record<string, string>): Promise<void>;
-    /**
-     * 设置空闲命令配置（用于SDK模式）
-     * 当 AI 进入 waiting_input 状态时，自动执行这些命令
-     * @param sessionId 会话 ID
-     * @param commands 空闲命令配置
-     */
+    
     abstract setIdleCommands?(sessionId: string, commands: {
         idleInputCommand: string;
         nonInputCommand: string;
     }): void;
-    /**
-     * 发送快捷键 token 序列（如 [enter]、[ctrl+c]），复用 SDK 输入流但不创建普通用户消息。
-     * @param sessionId 会话 ID
-     * @param command 快捷 token 文本
-     */
+    
     abstract sendShortcutInput?(sessionId: string, command: string): Promise<void>;
-    /**
-     * 中止当前正在执行的轮次（软中断）
-     * 会话保持活跃，用户可继续发送新消息。
-     * @param sessionId 会话 ID
-     */
+    
     abstract abortCurrentTurn(sessionId: string): Promise<void>;
-    /**
-     * 重置当前会话上下文但保留 SDK 会话本身。
-     */
+    
     abstract resetContext?(sessionId: string): Promise<void>;
-    /**
-     * 终止会话
-     * @param sessionId 会话 ID
-     */
+    
     abstract terminateSession(sessionId: string): Promise<void>;
-    /**
-     * 恢复之前的会话
-     * @param sessionId 内部会话 ID
-     * @param providerSessionId Provider 端的会话 ID
-     * @param config 会话配置
-     */
+    
     abstract resumeSession?(sessionId: string, providerSessionId: string, config: AdapterSessionConfig): Promise<void>;
-    /**
-     * 获取指定会话的对话历史
-     * @param sessionId 会话 ID
-     */
+    
     abstract getConversation(sessionId: string): ConversationMessage[];
-    /**
-     * 检查会话是否存在且活跃
-     * @param sessionId 会话 ID
-     */
+    
     abstract hasSession(sessionId: string): boolean;
-    /**
-     * 获取会话的 Provider 端会话 ID（用于恢复）
-     */
+    
     abstract getProviderSessionId(sessionId: string): string | undefined;
-    /**
-     * 获取会话状态
-     */
+    
     abstract getSessionStatus(sessionId: string): SessionStatus | undefined;
-    /**
-     * 获取会话的 SDK 进程 PID（用于孤儿进程检测）
-     */
+    
     abstract getSessionPid?(sessionId: string): number | undefined;
-    /**
-     * 主动查询会话的运行时能力清单（MCP 工具 + skills）。
-     * 只读 adapter 内存缓存，不触发 runtime 重新探测。
-     * 仅 AcodeSdkAdapter 实现此方法（其他 adapter 返回 undefined）。
-     * @returns 缓存的能力清单，若尚未收到任何 runtime_capabilities 事件则返回 undefined
-     */
+    
     abstract getCapabilities?(sessionId: string): RuntimeCapabilities | undefined;
-    /**
-     * 主动查询会话当前挂起的 ask_user_question（agent 提问）。
-     * 只读 adapter 内存缓存，不触发 runtime 重新探测。
-     * 仅 AcodeSdkAdapter 实现此方法（其他 adapter 返回 undefined）。
-     * 由 bridge GET /runtime/sdk/pending-questions 端点调用，用于前端刷新后重建提问 UI。
-     * @returns 挂起提问的 toolCallId 与 questions 数组；undefined 表示当前无挂起提问
-     */
+    
     abstract getPendingQuestion?(sessionId: string): {
         toolCallId: string;
         questions: unknown[];
     } | undefined;
-    /**
-     * 清理所有资源（应用退出时调用）
-     */
+    
     abstract cleanup(): void;
 }

package/dist/adapters/cc-switch/common.d.ts

@@ -1,8 +1,4 @@
-/**
- * CC-Switch Adapters 共享类型和工具函数
- *
- * 从 cc-switch-sdk 包导入接口定义，在此实现具体适配器
- */
+
 import type { AppId, McpServer, McpServerSpec } from '@cc-switch/sdk';
 export type JsonRecord = Record<string, unknown>;
 export interface ClaudeConfig {
@@ -35,17 +31,11 @@ export interface ClaudecodeConfig {
     mcpServers?: Record<string, ClaudecodeServer>;
     [key: string]: unknown;
 }
-/**
- * 将 OpenCode/Claudecode server 格式转换为 MCP spec
- */
+
 export declare function toMcpSpecFromOpenCode(input: OpenCodeServer): McpServerSpec;
-/**
- * 将 MCP spec 转换为 OpenCode/Claudecode server 格式
- */
+
 export declare function toOpenCodeServer(input: McpServerSpec): OpenCodeServer;
-/**
- * 导入时合并 App 标记
- */
+
 export declare function mergeAppFlagOnImport(server: McpServer, appId: AppId): McpServer;
 export declare const toMcpSpecFromClaudecode: typeof toMcpSpecFromOpenCode;
 export declare const toClaudecodeServer: typeof toOpenCodeServer;

package/dist/adapters/cc-switch/index.d.ts

@@ -1,8 +1,4 @@
-/**
- * CC-Switch Adapters 入口
- *
- * 提供工厂函数创建所有 MCP 和 Skill 适配器实例
- */
+
 import type { AppId, IMcpAdapter, ISkillAdapter, SdkPaths } from '@cc-switch/sdk';
 export { AcodeMcpAdapter } from './mcp-acode.js';
 export { ClaudeMcpAdapter } from './mcp-claude.js';
@@ -17,11 +13,7 @@ export { CodexSkillAdapter } from './skill-codex.js';
 export { OpenCodeSkillAdapter } from './skill-opencode.js';
 export { PlaceholderSkillAdapter } from './skill-placeholder.js';
 export * from './common.js';
-/**
- * 创建所有 MCP 适配器实例
- */
+
 export declare function createMcpAdapters(paths: SdkPaths): Record<AppId, IMcpAdapter>;
-/**
- * 创建所有 Skill 适配器实例
- */
+
 export declare function createSkillAdapters(paths: SdkPaths): Record<AppId, ISkillAdapter>;

package/dist/adapters/cc-switch/mcp-acode.d.ts

@@ -1,10 +1,4 @@
-/**
- * ACode MCP Adapter
- *
- * 主流程：读取内置 ACode 的 JSON 配置 -> 将 mcpServers 映射导入 SDK ->
- * 按 SDK 状态增删 ACode 配置中的 MCP server。ACode 内置在 runtime-bridge 中，
- * 因此不需要外部 CLI 安装步骤。
- */
+
 import type { IMcpAdapter, McpServer } from '@cc-switch/sdk';
 export declare class AcodeMcpAdapter implements IMcpAdapter {
     private readonly configPath;

package/dist/adapters/cc-switch/mcp-claude.d.ts

@@ -1,8 +1,4 @@
-/**
- * Claude MCP Adapter
- *
- * 实现 IMcpAdapter 接口，负责 Claude Desktop 的 MCP 配置读写
- */
+
 import type { IMcpAdapter, McpServer } from '@cc-switch/sdk';
 export declare class ClaudeMcpAdapter implements IMcpAdapter {
     private readonly configPath;

package/dist/adapters/cc-switch/mcp-claudecode.d.ts

@@ -1,8 +1,4 @@
-/**
- * ClaudeCode MCP Adapter
- *
- * 实现 IMcpAdapter 接口，负责 ClaudeCode 的 MCP 配置读写
- */
+
 import type { IMcpAdapter, McpServer } from '@cc-switch/sdk';
 export declare class ClaudecodeMcpAdapter implements IMcpAdapter {
     private readonly configPath;

package/dist/adapters/cc-switch/mcp-codex.d.ts

@@ -1,10 +1,4 @@
-/**
- * Codex MCP Adapter
- *
- * Codex does not receive per-session MCP servers from the current SDK surface.
- * This adapter persists MCP servers into Codex's config.toml while preserving
- * unrelated user-owned config text.
- */
+
 import type { IMcpAdapter, McpServer } from '@cc-switch/sdk';
 export declare class CodexMcpAdapter implements IMcpAdapter {
     private readonly configPath;