aws-runtime-bridge 1.3.0 → 1.3.1

package/README.md

@@ -1,77 +1,77 @@
-# aws-runtime-bridge
-
-AgentsWorkStudio 机器实例运行时桥接服务，用于在实例上管理 Agent 运行时、终端、配置与回调通信。
-
-## 全局安装
-
-从 npm 包安装时：
-
-```bash
-npm install -g aws-runtime-bridge
-```
-
-安装脚本会在 macOS、Linux 与常见 Unix 平台自动为 CLI 入口补齐可执行权限；Windows 平台无需 chmod，会自动跳过该步骤。
-
-从当前仓库安装时：
-
-```bash
-cd aws-runtime-bridge
-npm install
-npm run build
-npm install -g .
-```
-
-## 启动
-
-首次运行 `awsb` / `aws-bridge` 时，如果不存在 `~/.aws-bridge/config.json`，CLI 会进入交互式配置引导；也可以在提示中选择跳过。跳过时仍会创建配置文件并自动生成随机 `connectionKey`，终端会输出该密钥，请保存后在 server/面板连接此 Bridge 时使用。非交互环境（如 systemd、CI、Docker 后台启动）不会阻塞等待输入，也会自动生成 `connectionKey` 并跳过引导。
-
-引导会生成类似下面的配置：
-
-```json
-{
-  "connectionKey": "gkmzjaznX55..",
-  "autoRegisterTargets": [
-    {
-      "serverUrl": "http://127.0.0.1:8080",
-      "instanceName": "至强主机",
-      "userKey": "aws_live_crh_g0GGrg5IntODg1sFwnas7qf4yGrcwoisDWPBtd8",
-      "registerIp": "127.0.0.1"
-    }
-  ]
-}
-```
-
-如需在交互式终端中也强制跳过引导，可设置 `AWS_BRIDGE_SKIP_SETUP=true`；此时仍会生成随机 `connectionKey`。
-
-```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 产物，不再在 Agent 启动时默认动态注入 `aws-mcp`。
-
-请在面板中为目标运行时安装/配置 MCP；这样 Claude Code、Codex、OpenCode、PTY 等不同启动模式都走一致的持久化 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`。
+# aws-runtime-bridge
+
+AgentsWorkStudio 机器实例运行时桥接服务，用于在实例上管理 Agent 运行时、终端、配置与回调通信。
+
+## 全局安装
+
+从 npm 包安装时：
+
+```bash
+npm install -g aws-runtime-bridge
+```
+
+安装脚本会在 macOS、Linux 与常见 Unix 平台自动为 CLI 入口补齐可执行权限；Windows 平台无需 chmod，会自动跳过该步骤。
+
+从当前仓库安装时：
+
+```bash
+cd aws-runtime-bridge
+npm install
+npm run build
+npm install -g .
+```
+
+## 启动
+
+首次运行 `awsb` / `aws-bridge` 时，如果不存在 `~/.aws-bridge/config.json`，CLI 会进入交互式配置引导；也可以在提示中选择跳过。跳过时仍会创建配置文件并自动生成随机 `connectionKey`，终端会输出该密钥，请保存后在 server/面板连接此 Bridge 时使用。非交互环境（如 systemd、CI、Docker 后台启动）不会阻塞等待输入，也会自动生成 `connectionKey` 并跳过引导。
+
+引导会生成类似下面的配置：
+
+```json
+{
+  "connectionKey": "gkmzjaznX55..",
+  "autoRegisterTargets": [
+    {
+      "serverUrl": "http://127.0.0.1:8080",
+      "instanceName": "至强主机",
+      "userKey": "aws_live_crh_g0GGrg5IntODg1sFwnas7qf4yGrcwoisDWPBtd8",
+      "registerIp": "127.0.0.1"
+    }
+  ]
+}
+```
+
+如需在交互式终端中也强制跳过引导，可设置 `AWS_BRIDGE_SKIP_SETUP=true`；此时仍会生成随机 `connectionKey`。
+
+```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 产物，不再在 Agent 启动时默认动态注入 `aws-mcp`。
+
+请在面板中为目标运行时安装/配置 MCP；这样 Claude Code、Codex、OpenCode、PTY 等不同启动模式都走一致的持久化 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/routes/properties.test.js

@@ -41,10 +41,10 @@ describe('properties file operations', () => {
             }
             return result;
         };
-        const props = parseProperties(`
-# Comment
-agent.role.name=Backend Developer
-project.workspace.path=/home/project
+        const props = parseProperties(`
+# Comment
+agent.role.name=Backend Developer
+project.workspace.path=/home/project
     `);
         expect(props['agent.role.name']).toBe('Backend Developer');
         expect(props['project.workspace.path']).toBe('/home/project');

package/dist/utils/yaml-utils.test.js

@@ -12,95 +12,95 @@ describe('yaml-utils', () => {
             expect(hasMatchingAgentPath('', 'test')).toBeNull();
         });
         it('should return null when no agent key exists', () => {
-            const yaml = `
-other:
-  - name: test
+            const yaml = `
+other:
+  - name: test
 `;
             expect(hasMatchingAgentPath(yaml, 'test')).toBeNull();
         });
         it('should return null when agent is not an array', () => {
-            const yaml = `
-agent:
-  name: single
+            const yaml = `
+agent:
+  name: single
 `;
             expect(hasMatchingAgentPath(yaml, 'test')).toBeNull();
         });
         it('should return null when agent has no path', () => {
-            const yaml = `
-agent:
-  - name: test
-    description: no path
+            const yaml = `
+agent:
+  - name: test
+    description: no path
 `;
             expect(hasMatchingAgentPath(yaml, 'test')).toBeNull();
         });
         it('should match exact path', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: src/modules
+            const yaml = `
+agent:
+  - name: test
+    path: src/modules
 `;
             expect(hasMatchingAgentPath(yaml, 'src/modules')).toBe('src/modules');
         });
         it('should match path with different separators (backslash)', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: src/modules
+            const yaml = `
+agent:
+  - name: test
+    path: src/modules
 `;
             expect(hasMatchingAgentPath(yaml, 'src\\modules')).toBe('src/modules');
         });
         it('should match path with forward slash when yaml has backslash', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: src\\modules
+            const yaml = `
+agent:
+  - name: test
+    path: src\\modules
 `;
             expect(hasMatchingAgentPath(yaml, 'src/modules')).toBe('src\\modules');
         });
         it('should match current directory "." path', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: .
+            const yaml = `
+agent:
+  - name: test
+    path: .
 `;
             expect(hasMatchingAgentPath(yaml, '.')).toBe('.');
         });
         it('should match empty path when target is "."', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: ''
+            const yaml = `
+agent:
+  - name: test
+    path: ''
 `;
             expect(hasMatchingAgentPath(yaml, '.')).toBe('');
         });
         it('should return null when no matching path found', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: other/path
+            const yaml = `
+agent:
+  - name: test
+    path: other/path
 `;
             expect(hasMatchingAgentPath(yaml, 'different/path')).toBeNull();
         });
         it('should return first matching path from multiple agents', () => {
-            const yaml = `
-agent:
-  - name: first
-    path: first/path
-  - name: second
-    path: second/path
+            const yaml = `
+agent:
+  - name: first
+    path: first/path
+  - name: second
+    path: second/path
 `;
             expect(hasMatchingAgentPath(yaml, 'first/path')).toBe('first/path');
             expect(hasMatchingAgentPath(yaml, 'second/path')).toBe('second/path');
         });
         it('should handle complex YAML with nested objects', () => {
-            const yaml = `
-agent:
-  - name: complex
-    path: complex/path
-    project: my-project
-    prompt: |
-      This is a multi-line
-      prompt
+            const yaml = `
+agent:
+  - name: complex
+    path: complex/path
+    project: my-project
+    prompt: |
+      This is a multi-line
+      prompt
 `;
             expect(hasMatchingAgentPath(yaml, 'complex/path')).toBe('complex/path');
         });
@@ -113,12 +113,12 @@ agent:
             expect(result.isTemplate).toBe(false);
         });
         it('should return matching agent config', () => {
-            const yaml = `
-agent:
-  - name: my-agent
-    path: src/modules
-    project: my-project
-    prompt: test prompt
+            const yaml = `
+agent:
+  - name: my-agent
+    path: src/modules
+    project: my-project
+    prompt: test prompt
 `;
             const result = extractAgentConfigOrTemplate(yaml, 'src/modules');
             expect(result.isTemplate).toBe(false);
@@ -127,11 +127,11 @@ agent:
             expect(result.content).toContain('my-project');
         });
         it('should generate template when no matching agent found', () => {
-            const yaml = `
-agent:
-  - name: other-agent
-    path: other/path
-    project: existing-project
+            const yaml = `
+agent:
+  - name: other-agent
+    path: other/path
+    project: existing-project
 `;
             const result = extractAgentConfigOrTemplate(yaml, 'new/path');
             expect(result.isTemplate).toBe(true);
@@ -139,10 +139,10 @@ agent:
             expect(result.content).toContain('new/path');
         });
         it('should generate template with empty project when no agents have project', () => {
-            const yaml = `
-agent:
-  - name: agent1
-    path: path1
+            const yaml = `
+agent:
+  - name: agent1
+    path: path1
 `;
             const result = extractAgentConfigOrTemplate(yaml, 'new/path');
             expect(result.isTemplate).toBe(true);
@@ -150,21 +150,21 @@ agent:
             expect(result.content).toContain('project: ""');
         });
         it('should match current directory "." path', () => {
-            const yaml = `
-agent:
-  - name: root-agent
-    path: .
-    project: root-project
+            const yaml = `
+agent:
+  - name: root-agent
+    path: .
+    project: root-project
 `;
             const result = extractAgentConfigOrTemplate(yaml, '.');
             expect(result.isTemplate).toBe(false);
             expect(result.content).toContain('root-agent');
         });
         it('should normalize path separators in output', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: src\\modules
+            const yaml = `
+agent:
+  - name: test
+    path: src\\modules
 `;
             const result = extractAgentConfigOrTemplate(yaml, 'src/modules');
             expect(result.isTemplate).toBe(false);
@@ -192,78 +192,78 @@ agent:
             expect(autoFillPathInYml(invalidYaml, 'test/path')).toBe(invalidYaml);
         });
         it('should return original content when no agent key', () => {
-            const yaml = `
-other:
-  - name: test
+            const yaml = `
+other:
+  - name: test
 `;
             expect(autoFillPathInYml(yaml, 'test/path')).toBe(yaml);
         });
         it('should fill empty path', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: ''
-    project: my-project
+            const yaml = `
+agent:
+  - name: test
+    path: ''
+    project: my-project
 `;
             const result = autoFillPathInYml(yaml, 'new/path');
             expect(result).toContain('new/path');
             expect(result).not.toContain("path: ''");
         });
         it('should fill undefined path', () => {
-            const yaml = `
-agent:
-  - name: test
-    project: my-project
+            const yaml = `
+agent:
+  - name: test
+    project: my-project
 `;
             const result = autoFillPathInYml(yaml, 'new/path');
             expect(result).toContain('new/path');
         });
         it('should fill null path', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: null
+            const yaml = `
+agent:
+  - name: test
+    path: null
 `;
             const result = autoFillPathInYml(yaml, 'new/path');
             expect(result).toContain('new/path');
         });
         it('should fill whitespace-only path', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: '   '
+            const yaml = `
+agent:
+  - name: test
+    path: '   '
 `;
             const result = autoFillPathInYml(yaml, 'new/path');
             expect(result).toContain('new/path');
         });
         it('should not modify existing non-empty path', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: existing/path
+            const yaml = `
+agent:
+  - name: test
+    path: existing/path
 `;
             const result = autoFillPathInYml(yaml, 'new/path');
             expect(result).toContain('existing/path');
             expect(result).not.toContain('new/path');
         });
         it('should handle multiple agents', () => {
-            const yaml = `
-agent:
-  - name: agent1
-    path: ''
-  - name: agent2
-    path: existing/path
-  - name: agent3
+            const yaml = `
+agent:
+  - name: agent1
+    path: ''
+  - name: agent2
+    path: existing/path
+  - name: agent3
 `;
             const result = autoFillPathInYml(yaml, 'new/path');
             // agent1 should have path filled
             expect(result).toContain('new/path');
         });
         it('should return original content when no modification needed', () => {
-            const yaml = `
-agent:
-  - name: test
-    path: existing/path
+            const yaml = `
+agent:
+  - name: test
+    path: existing/path
 `;
             const result = autoFillPathInYml(yaml, 'new/path');
             expect(result).toBe(yaml);
@@ -296,11 +296,11 @@ agent:
         it('should load config from workspace directory with matching path "."', async () => {
             const configPath = path.join(workspacePath, relativePath);
             await fs.mkdir(path.dirname(configPath), { recursive: true });
-            await fs.writeFile(configPath, `
-agent:
-  - name: local-agent
-    path: .
-    project: local-project
+            await fs.writeFile(configPath, `
+agent:
+  - name: local-agent
+    path: .
+    project: local-project
 `, 'utf-8');
             const result = await loadYmlWithUpwardSearch(workspacePath, relativePath);
             expect(result.content).not.toBeNull();
@@ -312,11 +312,11 @@ agent:
             // 在 project/module 目录创建配置，匹配 src 路径
             const parentConfigPath = path.join(tempRoot, 'project', 'module', relativePath);
             await fs.mkdir(path.dirname(parentConfigPath), { recursive: true });
-            await fs.writeFile(parentConfigPath, `
-agent:
-  - name: module-agent
-    path: src
-    project: module-project
+            await fs.writeFile(parentConfigPath, `
+agent:
+  - name: module-agent
+    path: src
+    project: module-project
 `, 'utf-8');
             const result = await loadYmlWithUpwardSearch(workspacePath, relativePath);
             expect(result.content).not.toBeNull();
@@ -328,10 +328,10 @@ agent:
             // 在 project/module 目录创建配置，但不匹配 src 路径
             const parentConfigPath = path.join(tempRoot, 'project', 'module', relativePath);
             await fs.mkdir(path.dirname(parentConfigPath), { recursive: true });
-            await fs.writeFile(parentConfigPath, `
-agent:
-  - name: other-agent
-    path: other/path
+            await fs.writeFile(parentConfigPath, `
+agent:
+  - name: other-agent
+    path: other/path
 `, 'utf-8');
             const result = await loadYmlWithUpwardSearch(workspacePath, relativePath);
             expect(result.content).not.toBeNull();
@@ -342,17 +342,17 @@ agent:
             // 在 workspace 目录创建匹配的配置
             const localConfigPath = path.join(workspacePath, relativePath);
             await fs.mkdir(path.dirname(localConfigPath), { recursive: true });
-            await fs.writeFile(localConfigPath, `
-agent:
-  - name: local-agent
-    path: .
+            await fs.writeFile(localConfigPath, `
+agent:
+  - name: local-agent
+    path: .
 `, 'utf-8');
             // 在 parent 目录也创建配置
             const parentConfigPath = path.join(tempRoot, 'project', 'module', relativePath);
-            await fs.writeFile(parentConfigPath, `
-agent:
-  - name: parent-agent
-    path: src
+            await fs.writeFile(parentConfigPath, `
+agent:
+  - name: parent-agent
+    path: src
 `, 'utf-8');
             const result = await loadYmlWithUpwardSearch(workspacePath, relativePath);
             // 应该使用 local 的配置，因为更近且匹配