aws-runtime-bridge 1.0.0

package/README.md

@@ -0,0 +1,56 @@
+# aws-runtime-bridge
+
+AgentsWorkStudio 机器实例运行时桥接服务，用于在实例上管理 Agent 运行时、终端、配置与回调通信。
+
+## 全局安装
+
+从 npm 包安装时：
+
+```bash
+npm install -g aws-runtime-bridge
+```
+
+从当前仓库安装时：
+
+```bash
+cd aws-runtime-bridge
+npm install
+npm run build
+npm install -g .
+```
+
+## 启动
+
+```bash
+AWS_RUNTIME_BRIDGE_PORT=18081 \
+AWS_RUNTIME_SCHEDULER_BASE_URL=http://your-server-host:7380 \
+AWS_RUNTIME_CALLBACK_TOKEN=replace-with-a-long-random-runtime-callback-token \
+AWS_RUNTIME_HOME_DIR=/opt/agentswork/runtime-home \
+aws-bridge
+```
+
+`aws-runtime-bridge` 命令仍作为兼容别名保留。安装 `aws-runtime-bridge` 后，包内会随附
+`aws-client-agent-mcp` 的编译产物；bridge 启动时会自动准备该 MCP，并在 **Claude Code SDK 模式**
+启动 Agent 时默认注入名为 `aws-mcp` 的 MCP Server。
+
+> 当前 `Codex` SDK 不支持和 Claude Code 相同的动态 `extraMcpServers` 注入；如果使用 Codex，需走其原生 MCP 配置持久化链路。
+
+如需使用自定义 MCP 可执行文件，可设置：
+
+```bash
+AWS_CLIENT_AGENT_MCP_COMMAND=/absolute/path/to/aws-client-agent-mcp \
+AWS_CLIENT_AGENT_MCP_ARGS='[]' \
+aws-bridge
+```
+
+## 关键环境变量
+
+| 变量名 | 说明 | 默认值 |
+| --- | --- | --- |
+| `AWS_RUNTIME_BRIDGE_PORT` | Bridge HTTP 端口 | `18081` |
+| `AWS_RUNTIME_SCHEDULER_BASE_URL` | aws-mcp-server 地址 | `http://localhost:8080` |
+| `AWS_RUNTIME_CALLBACK_TOKEN` | 后端调用 bridge 的回调 Token | 无，生产必须显式设置 |
+| `AWS_RUNTIME_HOME_DIR` | Bridge 管理配置与状态的主目录 | 当前用户 Home |
+| `AWS_RUNTIME_CORS_ORIGINS` | 允许访问 bridge 的来源，逗号分隔 | 本地开发地址 |
+
+生产环境中，`AWS_RUNTIME_SCHEDULER_BASE_URL` 必须填写机器实例可访问的 `aws-mcp-server` 地址，不能使用容器内的 `localhost`。

package/dist/adapter/AdapterRegistry.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Adapter 注册表 —— 管理 Provider ID → Adapter 实例的映射
+ */
+import type { BaseProviderAdapter } from './types.js';
+export type AdapterType = 'claude-sdk' | 'codex-sdk' | 'opencode-sdk' | 'pty';
+/**
+ * Adapter 注册表
+ * 管理所有 Provider Adapter 实例的生命周期
+ */
+export declare class AdapterRegistry {
+    private adapters;
+    /**
+     * 注册 Adapter 实例
+     * @param adapter Adapter 实例（providerId 作为 key）
+     * @throws 如果该 providerId 已注册
+     */
+    register(adapter: BaseProviderAdapter): void;
+    /**
+     * 按 Provider ID 获取 Adapter
+     * @param providerId Provider 标识（如 'claude-code', 'opencode'）
+     * @throws 如果该 providerId 未注册
+     */
+    get(providerId: string): BaseProviderAdapter;
+    /**
+     * 按 AdapterType 获取 Adapter
+     * @param adapterType 适配器类型
+     * @throws 如果该类型未注册
+     */
+    getByType(adapterType: AdapterType): BaseProviderAdapter;
+    /**
+     * 检查是否已注册
+     * @param providerId Provider 标识
+     */
+    has(providerId: string): boolean;
+    /**
+     * 获取所有已注册的 Provider ID
+     */
+    getRegisteredIds(): string[];
+    /**
+     * 获取所有已注册 Adapter。
+     */
+    getAll(): BaseProviderAdapter[];
+    /**
+     * 清理所有 Adapter 资源
+     */
+    cleanup(): void;
+    /**
+     * Provider ID → AdapterType 匹配
+     */
+    private matchType;
+}
+export declare const adapterRegistry: AdapterRegistry;
+//# sourceMappingURL=AdapterRegistry.d.ts.map

package/dist/adapter/AdapterRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterRegistry.d.ts","sourceRoot":"","sources":["../../src/adapter/AdapterRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,KAAK,CAAC;AAE9E;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA+C;IAE/D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAO5C;;;;OAIG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB;IAU5C;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,mBAAmB;IASxD;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,MAAM,IAAI,mBAAmB,EAAE;IAI/B;;OAEG;IACH,OAAO,IAAI,IAAI;IAWf;;OAEG;IACH,OAAO,CAAC,SAAS;CAclB;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/adapter/AdapterRegistry.js

@@ -0,0 +1,100 @@
+/**
+ * Adapter 注册表 —— 管理 Provider ID → Adapter 实例的映射
+ */
+/**
+ * Adapter 注册表
+ * 管理所有 Provider Adapter 实例的生命周期
+ */
+export class AdapterRegistry {
+    constructor() {
+        this.adapters = new Map();
+    }
+    /**
+     * 注册 Adapter 实例
+     * @param adapter Adapter 实例（providerId 作为 key）
+     * @throws 如果该 providerId 已注册
+     */
+    register(adapter) {
+        if (this.adapters.has(adapter.providerId)) {
+            throw new Error(`Adapter already registered for provider: ${adapter.providerId}`);
+        }
+        this.adapters.set(adapter.providerId, adapter);
+    }
+    /**
+     * 按 Provider ID 获取 Adapter
+     * @param providerId Provider 标识（如 'claude-code', 'opencode'）
+     * @throws 如果该 providerId 未注册
+     */
+    get(providerId) {
+        const adapter = this.adapters.get(providerId);
+        if (!adapter) {
+            throw new Error(`No adapter registered for provider: ${providerId}. Available: ${[...this.adapters.keys()].join(', ')}`);
+        }
+        return adapter;
+    }
+    /**
+     * 按 AdapterType 获取 Adapter
+     * @param adapterType 适配器类型
+     * @throws 如果该类型未注册
+     */
+    getByType(adapterType) {
+        for (const adapter of this.adapters.values()) {
+            if (this.matchType(adapter.providerId, adapterType)) {
+                return adapter;
+            }
+        }
+        throw new Error(`No adapter registered for type: ${adapterType}`);
+    }
+    /**
+     * 检查是否已注册
+     * @param providerId Provider 标识
+     */
+    has(providerId) {
+        return this.adapters.has(providerId);
+    }
+    /**
+     * 获取所有已注册的 Provider ID
+     */
+    getRegisteredIds() {
+        return [...this.adapters.keys()];
+    }
+    /**
+     * 获取所有已注册 Adapter。
+     */
+    getAll() {
+        return [...this.adapters.values()];
+    }
+    /**
+     * 清理所有 Adapter 资源
+     */
+    cleanup() {
+        for (const adapter of this.adapters.values()) {
+            try {
+                adapter.cleanup();
+            }
+            catch (err) {
+                console.error(`[AdapterRegistry] Error cleaning up ${adapter.providerId}:`, err);
+            }
+        }
+        this.adapters.clear();
+    }
+    /**
+     * Provider ID → AdapterType 匹配
+     */
+    matchType(providerId, adapterType) {
+        switch (adapterType) {
+            case 'claude-sdk':
+                return providerId === 'claude-code';
+            case 'codex-sdk':
+                return providerId === 'codex';
+            case 'opencode-sdk':
+                return providerId === 'opencode';
+            case 'pty':
+                return providerId === 'pty';
+            default:
+                return false;
+        }
+    }
+}
+// 单例实例
+export const adapterRegistry = new AdapterRegistry();

package/dist/adapter/AdapterRegistry.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * AdapterRegistry 测试
+ */
+export {};
+//# sourceMappingURL=AdapterRegistry.test.d.ts.map

package/dist/adapter/AdapterRegistry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterRegistry.test.d.ts","sourceRoot":"","sources":["../../src/adapter/AdapterRegistry.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/adapter/AdapterRegistry.test.js

@@ -0,0 +1,109 @@
+/**
+ * AdapterRegistry 测试
+ */
+import { EventEmitter } from 'node:events';
+import { beforeEach, describe, expect, it } from 'vitest';
+import { AdapterRegistry } from '../adapter/AdapterRegistry.js';
+import { registerSdkProviders } from '../adapter/SdkProviderSpi.js';
+import { CodexSdkAdapter } from './CodexSdkAdapter.js';
+// 创建测试用的 Mock Adapter
+class MockAdapter extends EventEmitter {
+    constructor() {
+        super(...arguments);
+        this.providerId = 'mock-provider';
+        this.displayName = 'Mock Provider';
+    }
+    async startSession(sessionId, _config) {
+        this.emit('status-change', sessionId, 'running');
+    }
+    async sendMessage(_sessionId, _message) { }
+    async sendConfirmation(_sessionId, _accept) { }
+    async abortCurrentTurn(_sessionId) { }
+    async terminateSession(_sessionId) { }
+    async resumeSession(_sessionId, _providerSessionId, _config) { }
+    getConversation(_sessionId) {
+        return [];
+    }
+    hasSession(_sessionId) {
+        return false;
+    }
+    getProviderSessionId(_sessionId) {
+        return undefined;
+    }
+    getSessionStatus(_sessionId) {
+        return undefined;
+    }
+    cleanup() { }
+}
+describe('AdapterRegistry', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new AdapterRegistry();
+    });
+    describe('register', () => {
+        it('should register an adapter', () => {
+            const adapter = new MockAdapter();
+            registry.register(adapter);
+            expect(registry.has('mock-provider')).toBe(true);
+        });
+        it('should throw error when registering duplicate providerId', () => {
+            const adapter1 = new MockAdapter();
+            const adapter2 = new MockAdapter();
+            registry.register(adapter1);
+            expect(() => registry.register(adapter2)).toThrow('Adapter already registered');
+        });
+    });
+    describe('get', () => {
+        it('should return registered adapter', () => {
+            const adapter = new MockAdapter();
+            registry.register(adapter);
+            const result = registry.get('mock-provider');
+            expect(result).toBe(adapter);
+        });
+        it('should throw error when adapter not found', () => {
+            expect(() => registry.get('non-existent')).toThrow('No adapter registered');
+        });
+        it('should return registered codex adapter', () => {
+            const adapter = new CodexSdkAdapter();
+            registry.register(adapter);
+            const result = registry.get('codex');
+            expect(result).toBe(adapter);
+            expect(registry.has('codex')).toBe(true);
+        });
+    });
+    describe('has', () => {
+        it('should return true for registered adapter', () => {
+            const adapter = new MockAdapter();
+            registry.register(adapter);
+            expect(registry.has('mock-provider')).toBe(true);
+        });
+        it('should return false for non-existent adapter', () => {
+            expect(registry.has('non-existent')).toBe(false);
+        });
+    });
+    describe('getRegisteredIds', () => {
+        it('should return all registered provider IDs', () => {
+            const adapter = new MockAdapter();
+            registry.register(adapter);
+            expect(registry.getRegisteredIds()).toContain('mock-provider');
+        });
+        it('should return empty array when no adapters registered', () => {
+            expect(registry.getRegisteredIds()).toEqual([]);
+        });
+    });
+    describe('SDK provider SPI', () => {
+        it('registers built-in SDK providers through one extension point', () => {
+            registerSdkProviders(registry, () => { });
+            expect(registry.getRegisteredIds().sort()).toEqual(['claude-code', 'codex', 'opencode']);
+            expect(registry.get('codex').providerId).toBe('codex');
+        });
+    });
+    describe('cleanup', () => {
+        it('should clear all adapters', () => {
+            const adapter = new MockAdapter();
+            registry.register(adapter);
+            registry.cleanup();
+            expect(registry.getRegisteredIds()).toEqual([]);
+        });
+    });
+});

package/dist/adapter/ClaudeSdkAdapter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Claude Code Agent SDK Adapter
+ *
+ * 通过 @anthropic-ai/claude-agent-sdk 的 query() API
+ * 实现与 Claude Code 的结构化交互。
+ *
+ * 核心特性：
+ * - 支持 autoAccept 模式自动确认所有权限
+ * - 支持 AskUserQuestion 拦截并转发到聊天面板
+ * - 支持 turn_complete 事件精确判断 AI 就绪状态
+ */
+import { EventEmitter } from 'events';
+import type { BaseProviderAdapter, AdapterSessionConfig, ConversationMessage, SessionStatus } from './types.js';
+/**
+ * Claude Code Agent SDK Adapter
+ */
+export declare class ClaudeSdkAdapter extends EventEmitter implements BaseProviderAdapter {
+    readonly providerId = "claude-code";
+    readonly displayName = "Claude Code";
+    private sessions;
+    private sdkQueries;
+    private inputStreams;
+    private abortControllers;
+    private sdkModule;
+    private pendingPermissions;
+    private pendingQuestions;
+    private activeToolUseIds;
+    private recentToolNames;
+    private toolInputBuffers;
+    startSession(sessionId: string, config: AdapterSessionConfig): Promise<void>;
+    sendMessage(sessionId: string, message: string): Promise<void>;
+    /**
+     * 解析消息内容，提取图片和文本
+     * 支持 [图片: url] 标记格式
+     */
+    private parseMessageContent;
+    sendConfirmation(sessionId: string, accept: boolean): Promise<void>;
+    sendQuestionAnswer(sessionId: string, answers: Record<string, string>): Promise<void>;
+    abortCurrentTurn(sessionId: string): Promise<void>;
+    terminateSession(sessionId: string): Promise<void>;
+    getConversation(sessionId: string): ConversationMessage[];
+    hasSession(sessionId: string): boolean;
+    getProviderSessionId(sessionId: string): string | undefined;
+    getSessionStatus(sessionId: string): SessionStatus | undefined;
+    getSessionPid(sessionId: string): number | undefined;
+    cleanup(): void;
+    private idleCommands;
+    private idleTimers;
+    private lastActivityAt;
+    /**
+     * 设置空闲命令配置
+     */
+    setIdleCommands(sessionId: string, commands: {
+        idleInputCommand: string;
+        nonInputCommand: string;
+    }): void;
+    /**
+     * 启动空闲检测定时器
+     */
+    private startIdleDetection;
+    /**
+     * 停止空闲检测定时器
+     */
+    private stopIdleDetection;
+    /**
+     * 检测空闲状态并执行命令
+     */
+    private checkIdleState;
+    /**
+     * 发送空闲提示到 SDK
+     */
+    private sendIdlePrompt;
+    private isTaskPollingIdleCommand;
+    private isMessagePollingIdleCommand;
+    /**
+     * 执行空闲命令（支持 [enter], [wait:n] 等 token）
+     */
+    private executeIdleCommand;
+    /**
+     * 更新活动时间（在收到输出或状态变化时调用）
+     */
+    private updateActivity;
+    /**
+     * 恢复之前的会话
+     * 注意：SDK 的 resume 功能需要 providerSessionId
+     */
+    resumeSession(sessionId: string, providerSessionId: string, config: AdapterSessionConfig): Promise<void>;
+    private loadSdk;
+    /**
+     * 查找 Claude Code 可执行文件路径
+     * 支持 Windows / macOS / Linux
+     */
+    private findClaudeExecutable;
+    /**
+     * 从 wrapper 脚本解析 cli.js 路径
+     */
+    private resolveCliJsFromWrapper;
+    private buildQueryOptions;
+    private createPermissionHandler;
+    private consumeStream;
+    private handleSdkMessage;
+    private handleToolUse;
+    /**
+     * 处理 SDK 流式事件
+     * 用于检测工具调用开始、增量更新和结束
+     *
+     * 注意：此方法只更新状态，不发送时间线事件
+     * 时间线事件由 handleToolUse 发送，这样能获取完整的工具参数
+     */
+    private handleStreamEvent;
+    /**
+     * 提取工具名后缀
+     * 用于匹配不同格式的工具名
+     * 例如：aws-mcp__get_profile -> get_profile
+     */
+    private extractToolNameSuffix;
+    private emitEvent;
+    private cleanupSession;
+}
+//# sourceMappingURL=ClaudeSdkAdapter.d.ts.map

package/dist/adapter/ClaudeSdkAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeSdkAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/ClaudeSdkAdapter.ts"],"names":[],"mappings":"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"}