aws-runtime-bridge 1.2.1 → 1.3.0

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/adapter/ClaudeSdkAdapter.d.ts

@@ -72,6 +72,7 @@ export declare class ClaudeSdkAdapter extends EventEmitter implements BaseProvid
     private sendIdlePrompt;
     private isTaskPollingIdleCommand;
     private isMessagePollingIdleCommand;
+    private buildMessagePollingIdlePrompt;
     /**
      * 执行空闲命令（支持 [enter], [wait:n] 等 token）
      */

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

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

package/dist/adapter/ClaudeSdkAdapter.js

@@ -413,9 +413,9 @@ export class ClaudeSdkAdapter extends EventEmitter {
         if (commands.idleInputCommand) {
             // 解析空闲命令，提取实际要执行的指令
             const command = commands.idleInputCommand;
-            // 如果空闲命令包含 poll_message，发送一个提示让 AI 执行
+            // 如果空闲命令包含 poll_message/get_message，引导 AI 进入阻塞式消息轮询。
             if (this.isMessagePollingIdleCommand(command)) {
-                this.sendIdlePrompt(sessionId, '请使用 poll_message 工具检查是否有新消息，如果有的话处理它们。');
+                this.sendIdlePrompt(sessionId, this.buildMessagePollingIdlePrompt());
             }
             else {
                 // 其他命令，直接作为消息发送给 AI
@@ -457,7 +457,11 @@ export class ClaudeSdkAdapter extends EventEmitter {
         if (!normalized) {
             return false;
         }
-        return normalized.toLowerCase().includes('poll_message') || normalized.includes('取消息');
+        const lower = normalized.toLowerCase();
+        return lower.includes('poll_message') || lower.includes('get_message') || normalized.includes('取消息');
+    }
+    buildMessagePollingIdlePrompt() {
+        return '请调用 poll_message 工具阻塞等待新消息；收到消息后再处理消息内容。';
     }
     /**
      * 执行空闲命令（支持 [enter], [wait:n] 等 token）

package/dist/adapter/ClaudeSdkAdapter.test.js

@@ -34,7 +34,7 @@ describe('ClaudeSdkAdapter', () => {
         expect(sentPrompts).toHaveLength(0);
         expect(sendIdlePrompt).not.toHaveBeenCalled();
     });
-    it('still auto-wakes Claude for poll_message-style idle commands', async () => {
+    it('starts a blocking poll turn for poll_message-style idle commands', async () => {
         vi.useFakeTimers();
         const adapter = new ClaudeSdkAdapter();
         const sentPrompts = [];
@@ -61,7 +61,7 @@ describe('ClaudeSdkAdapter', () => {
         await vi.advanceTimersByTimeAsync(1000);
         expect(sentPrompts).toHaveLength(0);
         await vi.advanceTimersByTimeAsync(600);
-        expect(sentPrompts).toEqual(['请使用 poll_message 工具检查是否有新消息，如果有的话处理它们。']);
+        expect(sentPrompts).toEqual(['请调用 poll_message 工具阻塞等待新消息；收到消息后再处理消息内容。']);
     });
     it('still auto-wakes Claude for regular idle commands', async () => {
         vi.useFakeTimers();

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

@@ -1 +1 @@
-{"version":3,"file":"CodexSdkAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/CodexSdkAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiB3C,OAAO,KAAK,EAEV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EAEnB,aAAa,EAEd,MAAM,YAAY,CAAC;AAgRpB,qBAAa,eAAgB,SAAQ,YAAa,YAAW,mBAAmB;IAC9E,QAAQ,CAAC,UAAU,WAAW;IAC9B,QAAQ,CAAC,WAAW,WAAW;IAE/B,OAAO,CAAC,QAAQ,CAAwC;IAElD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkE5E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC9D,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAanG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlD,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA2BhB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIzD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9D,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrD,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,kBAAkB;YAqCZ,OAAO;IAiCrB,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,gBAAgB;IA+ExB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,kBAAkB;IAuD1B,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,cAAc;YAcR,cAAc;IAuB5B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,2BAA2B;CAMpC"}
+{"version":3,"file":"CodexSdkAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/CodexSdkAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiB3C,OAAO,KAAK,EAEV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EAEnB,aAAa,EAEd,MAAM,YAAY,CAAC;AAgRpB,qBAAa,eAAgB,SAAQ,YAAa,YAAW,mBAAmB;IAC9E,QAAQ,CAAC,UAAU,WAAW;IAC9B,QAAQ,CAAC,WAAW,WAAW;IAE/B,OAAO,CAAC,QAAQ,CAAwC;IAElD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkE5E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC9D,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAanG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlD,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA2BhB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIzD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9D,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrD,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,kBAAkB;YAqCZ,OAAO;IAiCrB,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,gBAAgB;IA+ExB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,kBAAkB;IAuD1B,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,cAAc;YAcR,cAAc;IAuB5B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,2BAA2B;CAOpC"}

package/dist/adapter/CodexSdkAdapter.js

@@ -687,8 +687,6 @@ export class CodexSdkAdapter extends EventEmitter {
         const session = this.sessions.get(sessionId);
         if (!session?.idleCommands?.idleInputCommand)
             return;
-        if (this.isMessagePollingIdleCommand(session.idleCommands.idleInputCommand))
-            return;
         session.lastActivityAt = Date.now();
         const timer = setInterval(() => {
             this.checkIdleState(sessionId);
@@ -739,12 +737,17 @@ export class CodexSdkAdapter extends EventEmitter {
         }
     }
     toIdlePrompt(command) {
-        return command.trim();
+        const trimmed = command.trim();
+        if (this.isMessagePollingIdleCommand(trimmed)) {
+            return '请调用 poll_message 工具阻塞等待新消息；收到消息后再处理消息内容。';
+        }
+        return trimmed;
     }
     isMessagePollingIdleCommand(command) {
         const normalized = command.trim();
         if (!normalized)
             return false;
-        return normalized.toLowerCase().includes('poll_message') || normalized.includes('取消息');
+        const lower = normalized.toLowerCase();
+        return lower.includes('poll_message') || lower.includes('get_message') || normalized.includes('取消息');
     }
 }

package/dist/adapter/CodexSdkAdapter.test.js

@@ -177,7 +177,7 @@ describe('CodexSdkAdapter', () => {
         expect(runMessages).toContain('continue');
         expect(adapter.getConversation('session-1').some((message) => message.content === 'continue')).toBe(false);
     });
-    it('does not auto-wake Codex for poll_message-style idle commands', async () => {
+    it('starts a blocking poll turn for poll_message-style idle commands', async () => {
         vi.useFakeTimers();
         const adapter = new CodexSdkAdapter();
         await adapter.startSession('session-1', {
@@ -202,8 +202,10 @@ describe('CodexSdkAdapter', () => {
             idleInputCommand: 'system: 醒来了吗？使用get_profile获取自己的信息，继续未完成的任务或使用poll_message阻塞获取消息',
             nonInputCommand: '',
         });
-        await vi.advanceTimersByTimeAsync(3000);
+        await vi.advanceTimersByTimeAsync(1000);
         expect(runMessages).toHaveLength(0);
+        await vi.advanceTimersByTimeAsync(600);
+        expect(runMessages).toEqual(['请调用 poll_message 工具阻塞等待新消息；收到消息后再处理消息内容。']);
         const userMessages = adapter.getConversation('session-1').filter((message) => message.role === 'user');
         expect(userMessages).toHaveLength(0);
     });

package/dist/adapter/OpencodeSdkAdapter.d.ts

@@ -41,5 +41,7 @@ export declare class OpencodeSdkAdapter extends EventEmitter implements BaseProv
     private startIdleDetection;
     private stopIdleDetection;
     private checkIdleState;
+    private toIdlePrompt;
+    private isMessagePollingIdleCommand;
 }
 //# sourceMappingURL=OpencodeSdkAdapter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"OpencodeSdkAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/OpencodeSdkAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa3C,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAGpB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AA4FpB,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,mBAAmB;IACjF,QAAQ,CAAC,UAAU,cAAc;IACjC,QAAQ,CAAC,WAAW,cAAc;IAElC,OAAO,CAAC,QAAQ,CAA2C;IAErD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+H5E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC9D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAOnG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAclD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIzD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOpD,OAAO,IAAI,IAAI;YAaD,aAAa;IAmB3B,OAAO,CAAC,YAAY;YAYN,UAAU;IAuBxB,OAAO,CAAC,mBAAmB;IA6H3B,OAAO,CAAC,gBAAgB;IA6GxB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,cAAc;CAQvB"}
+{"version":3,"file":"OpencodeSdkAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/OpencodeSdkAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa3C,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAGpB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AA4FpB,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,mBAAmB;IACjF,QAAQ,CAAC,UAAU,cAAc;IACjC,QAAQ,CAAC,WAAW,cAAc;IAElC,OAAO,CAAC,QAAQ,CAA2C;IAErD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+H5E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC9D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAOnG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAclD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIzD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOpD,OAAO,IAAI,IAAI;YAaD,aAAa;IAmB3B,OAAO,CAAC,YAAY;YAYN,UAAU;IAuBxB,OAAO,CAAC,mBAAmB;IA6H3B,OAAO,CAAC,gBAAgB;IA6GxB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,2BAA2B;CAOpC"}

package/dist/adapter/OpencodeSdkAdapter.js

@@ -616,7 +616,21 @@ export class OpencodeSdkAdapter extends EventEmitter {
             return;
         if (!session.idleCommands?.idleInputCommand)
             return;
-        void this.sendMessage(sessionId, session.idleCommands.idleInputCommand);
+        void this.sendMessage(sessionId, this.toIdlePrompt(session.idleCommands.idleInputCommand));
         this.stopIdleDetection(sessionId);
     }
+    toIdlePrompt(command) {
+        const trimmed = command.trim();
+        if (this.isMessagePollingIdleCommand(trimmed)) {
+            return '请调用 poll_message 工具阻塞等待新消息；收到消息后再处理消息内容。';
+        }
+        return trimmed;
+    }
+    isMessagePollingIdleCommand(command) {
+        const normalized = command.trim();
+        if (!normalized)
+            return false;
+        const lower = normalized.toLowerCase();
+        return lower.includes('poll_message') || lower.includes('get_message') || normalized.includes('取消息');
+    }
 }

package/dist/adapter/OpencodeSdkAdapter.test.js

@@ -11,4 +11,9 @@ describe('OpencodeSdkAdapter', () => {
         expect(adapter.hasSession('missing-session')).toBe(false);
         expect(adapter.getSessionStatus('missing-session')).toBeUndefined();
     });
+    it('normalizes poll_message-style idle commands into a blocking poll prompt', () => {
+        const adapter = new OpencodeSdkAdapter();
+        const prompt = Reflect.get(adapter, 'toIdlePrompt').call(adapter, 'system: 醒来了吗？使用get_profile获取自己的信息，继续未完成的任务或使用poll_message阻塞获取消息');
+        expect(prompt).toBe('请调用 poll_message 工具阻塞等待新消息；收到消息后再处理消息内容。');
+    });
 });

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/routes/runtime-binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-binding.d.ts","sourceRoot":"","sources":["../../src/routes/runtime-binding.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,oBAAoB,4CAAW,CAAC;AAqO7C,wBAAgB,6BAA6B,IAAI,IAAI,CAapD"}
+{"version":3,"file":"runtime-binding.d.ts","sourceRoot":"","sources":["../../src/routes/runtime-binding.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,oBAAoB,4CAAW,CAAC;AAgO7C,wBAAgB,6BAA6B,IAAI,IAAI,CAapD"}

package/dist/routes/runtime-binding.js

@@ -2,7 +2,7 @@ import { Router } from "express";
 import { clearRuntimeBinding, getRuntimeAccessToken, getRuntimeBindingPublicState, getRuntimePairingCode, hasRuntimeBinding, saveRuntimeBinding, validateRuntimeBindingToken, validateRuntimePairingCode, } from "../services/runtime-binding.js";
 import { validateToken } from "../middleware/auth.js";
 import { runtimeToken } from "../config.js";
-import { requestRuntimeAccessTokenRefresh } from "../services/auto-register.js";
+import { requestRuntimeAccessTokenRefresh, requestRuntimeAccessTokenRefreshForServer } from "../services/auto-register.js";
 import { claimMcpLaunchBinding, getMcpLaunchQueueSize } from "../services/mcp-launch-binding-queue.js";
 import { createLogger } from "../utils/logger.js";
 const log = createLogger("runtime-binding-route");
@@ -84,7 +84,10 @@ runtimeBindingRouter.post("/binding/request-token", async (req, res) => {
         });
         return;
     }
-    const result = await requestRuntimeAccessTokenRefresh();
+    const requestedServerUrl = serverUrl || schedulerBaseUrl;
+    const result = requestedServerUrl
+        ? await requestRuntimeAccessTokenRefreshForServer(String(requestedServerUrl))
+        : await requestRuntimeAccessTokenRefresh();
     if (!result.success || !result.runtimeAccessToken) {
         res.status(400).json({
             ok: false,
@@ -103,15 +106,7 @@ runtimeBindingRouter.post("/binding/claim-agent", (req, res) => {
         res.status(403).json({ ok: false, error: "loopback request required" });
         return;
     }
-    const { agentId, bindingId, workspacePath, serverUrl } = req.body || {};
-    if (!agentId || !String(agentId).trim()) {
-        res.status(400).json({ ok: false, error: "agentId is required" });
-        return;
-    }
-    if (!bindingId || !String(bindingId).trim()) {
-        res.status(400).json({ ok: false, error: "bindingId is required" });
-        return;
-    }
+    const { workspacePath, serverUrl } = req.body || {};
     if (!workspacePath || !String(workspacePath).trim()) {
         res.status(400).json({ ok: false, error: "workspacePath is required" });
         return;
@@ -120,11 +115,11 @@ runtimeBindingRouter.post("/binding/claim-agent", (req, res) => {
         res.status(400).json({ ok: false, error: "serverUrl is required" });
         return;
     }
-    const claimed = claimMcpLaunchBinding({ agentId, bindingId, workspacePath, serverUrl });
+    const claimed = claimMcpLaunchBinding({ workspacePath, serverUrl });
     if (!claimed) {
         res.status(404).json({
             ok: false,
-            error: "launch binding not found",
+            error: "launch binding not found for workspacePath and serverUrl",
             queueSize: getMcpLaunchQueueSize(workspacePath),
         });
         return;

package/dist/routes/runtime-mcp-proxy.d.ts

@@ -0,0 +1,3 @@
+export declare const runtimeMcpProxyRouter: import("express-serve-static-core").Router;
+export declare function toRuntimeMcpProxyUrl(bridgeBaseUrl?: string): string;
+//# sourceMappingURL=runtime-mcp-proxy.d.ts.map

package/dist/routes/runtime-mcp-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mcp-proxy.d.ts","sourceRoot":"","sources":["../../src/routes/runtime-mcp-proxy.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,qBAAqB,4CAAW,CAAC;AAwI9C,wBAAgB,oBAAoB,CAClC,aAAa,SAA6B,GACzC,MAAM,CAER"}

package/dist/routes/runtime-mcp-proxy.js

@@ -0,0 +1,102 @@
+import axios from "axios";
+import { Router } from "express";
+import { port, schedulerBaseUrl } from "../config.js";
+import { requestRuntimeAccessTokenRefresh } from "../services/auto-register.js";
+import { getRuntimeAccessToken, loadRuntimeBinding, } from "../services/runtime-binding.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("runtime-mcp-proxy");
+export const runtimeMcpProxyRouter = Router();
+function isLoopbackRequest(req) {
+    const ip = req.ip || req.socket.remoteAddress || "";
+    return ip === "127.0.0.1" || ip === "::1" || ip === "::ffff:127.0.0.1";
+}
+function normalizeSchedulerBaseUrl(value) {
+    const candidate = String(value || "").trim() || schedulerBaseUrl;
+    return candidate.replace(/\/+$/, "");
+}
+function normalizeMcpCallBody(rawBody) {
+    const tool = String(rawBody?.tool || "").trim();
+    if (!/^[a-zA-Z0-9_.:-]{1,128}$/.test(tool)) {
+        return null;
+    }
+    const args = rawBody?.arguments;
+    if (args == null) {
+        return { tool, arguments: {} };
+    }
+    if (typeof args !== "object" || Array.isArray(args)) {
+        return null;
+    }
+    return { tool, arguments: args };
+}
+async function forwardMcpCall(options) {
+    const url = new URL("/mcp/call", options.schedulerBaseUrl).toString();
+    const response = await axios.post(url, options.body, {
+        headers: {
+            "Content-Type": "application/json",
+            "X-Runtime-Token": options.runtimeAccessToken,
+            Authorization: `Bearer ${options.runtimeAccessToken}`,
+        },
+        timeout: 15000,
+        validateStatus: () => true,
+    });
+    return { status: response.status, data: response.data };
+}
+function resolveRuntimeCredential(req) {
+    const binding = loadRuntimeBinding();
+    const requestedSchedulerBaseUrl = normalizeSchedulerBaseUrl(req.body?.schedulerBaseUrl || req.body?.serverUrl || binding.schedulerBaseUrl);
+    const runtimeAccessToken = getRuntimeAccessToken(req.body?.userId || binding.userId, requestedSchedulerBaseUrl);
+    return { runtimeAccessToken, schedulerBaseUrl: requestedSchedulerBaseUrl };
+}
+runtimeMcpProxyRouter.post("/mcp/call", async (req, res) => {
+    if (!isLoopbackRequest(req)) {
+        res.status(403).json({ ok: false, error: "loopback request required" });
+        return;
+    }
+    const body = normalizeMcpCallBody(req.body || {});
+    if (!body) {
+        res.status(400).json({ ok: false, error: "invalid MCP call payload" });
+        return;
+    }
+    let credential = resolveRuntimeCredential(req);
+    if (!credential.runtimeAccessToken) {
+        const refresh = await requestRuntimeAccessTokenRefresh();
+        if (!refresh.success || !refresh.runtimeAccessToken) {
+            res.status(401).json({
+                ok: false,
+                error: refresh.error || "runtime access token is not available",
+            });
+            return;
+        }
+        credential = {
+            runtimeAccessToken: refresh.runtimeAccessToken,
+            schedulerBaseUrl: credential.schedulerBaseUrl,
+        };
+    }
+    const runtimeAccessToken = String(credential.runtimeAccessToken || "");
+    try {
+        let forwarded = await forwardMcpCall({
+            runtimeAccessToken,
+            schedulerBaseUrl: credential.schedulerBaseUrl,
+            body,
+        });
+        if (forwarded.status === 401) {
+            const refresh = await requestRuntimeAccessTokenRefresh();
+            if (refresh.success && refresh.runtimeAccessToken) {
+                forwarded = await forwardMcpCall({
+                    runtimeAccessToken: refresh.runtimeAccessToken,
+                    schedulerBaseUrl: credential.schedulerBaseUrl,
+                    body,
+                });
+            }
+        }
+        res.status(forwarded.status).json(forwarded.data);
+    }
+    catch (error) {
+        const err = error;
+        log.warn(`[runtime-bridge] MCP proxy call failed: ${err.message}`);
+        res.status(502).json({ ok: false, error: "scheduler MCP call failed" });
+    }
+});
+export function toRuntimeMcpProxyUrl(bridgeBaseUrl = `http://127.0.0.1:${port}`) {
+    return new URL("/runtime/mcp/call", bridgeBaseUrl).toString();
+}

package/dist/routes/runtime-mcp-proxy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-mcp-proxy.test.d.ts.map

package/dist/routes/runtime-mcp-proxy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-mcp-proxy.test.d.ts","sourceRoot":"","sources":["../../src/routes/runtime-mcp-proxy.test.ts"],"names":[],"mappings":""}

package/dist/routes/runtime-mcp-proxy.test.js

@@ -0,0 +1,111 @@
+import express from "express";
+import { afterEach, describe, expect, it, vi } from "vitest";
+const postMock = vi.hoisted(() => vi.fn());
+const getRuntimeAccessTokenMock = vi.hoisted(() => vi.fn());
+const loadRuntimeBindingMock = vi.hoisted(() => vi.fn());
+const refreshMock = vi.hoisted(() => vi.fn());
+vi.mock("axios", () => ({
+    default: {
+        post: postMock,
+    },
+}));
+vi.mock("../services/runtime-binding.js", () => ({
+    getRuntimeAccessToken: getRuntimeAccessTokenMock,
+    loadRuntimeBinding: loadRuntimeBindingMock,
+}));
+vi.mock("../services/auto-register.js", () => ({
+    requestRuntimeAccessTokenRefresh: refreshMock,
+}));
+async function createServer() {
+    const { runtimeMcpProxyRouter } = await import("./runtime-mcp-proxy.js");
+    const app = express();
+    app.use(express.json());
+    app.use("/runtime", runtimeMcpProxyRouter);
+    return new Promise((resolve) => {
+        const server = app.listen(0, "127.0.0.1", () => {
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                throw new Error("expected TCP server address");
+            }
+            resolve({ server, baseUrl: `http://127.0.0.1:${address.port}` });
+        });
+    });
+}
+async function postJson(baseUrl, body) {
+    const response = await fetch(`${baseUrl}/runtime/mcp/call`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    return { status: response.status, body: await response.json() };
+}
+describe("runtime MCP proxy", () => {
+    afterEach(() => {
+        vi.resetModules();
+        vi.clearAllMocks();
+    });
+    it("forwards loopback MCP calls with the Bridge-held runtime token", async () => {
+        loadRuntimeBindingMock.mockReturnValue({
+            status: "paired",
+            userId: "user-1",
+            schedulerBaseUrl: "http://scheduler:7380",
+        });
+        getRuntimeAccessTokenMock.mockReturnValue("aws_rt_token_1234567890");
+        postMock.mockResolvedValue({ status: 200, data: { ok: true } });
+        const { server, baseUrl } = await createServer();
+        try {
+            const result = await postJson(baseUrl, {
+                tool: "discover_colleague",
+                arguments: { agentId: "agent-1" },
+            });
+            expect(result).toEqual({ status: 200, body: { ok: true } });
+            expect(postMock).toHaveBeenCalledWith("http://scheduler:7380/mcp/call", { tool: "discover_colleague", arguments: { agentId: "agent-1" } }, expect.objectContaining({
+                headers: expect.objectContaining({
+                    "X-Runtime-Token": "aws_rt_token_1234567890",
+                }),
+            }));
+        }
+        finally {
+            server.close();
+        }
+    });
+    it("rejects malformed MCP payloads before forwarding", async () => {
+        const { server, baseUrl } = await createServer();
+        try {
+            const result = await postJson(baseUrl, {
+                tool: "bad tool name",
+                arguments: [],
+            });
+            expect(result.status).toBe(400);
+            expect(postMock).not.toHaveBeenCalled();
+        }
+        finally {
+            server.close();
+        }
+    });
+    it("refreshes runtime token once after scheduler 401", async () => {
+        loadRuntimeBindingMock.mockReturnValue({
+            status: "paired",
+            userId: "user-1",
+            schedulerBaseUrl: "http://scheduler:7380",
+        });
+        getRuntimeAccessTokenMock.mockReturnValue("expired-token-1234567890");
+        refreshMock.mockResolvedValue({
+            success: true,
+            runtimeAccessToken: "fresh-token-1234567890",
+        });
+        postMock
+            .mockResolvedValueOnce({ status: 401, data: { error: "unauthorized" } })
+            .mockResolvedValueOnce({ status: 200, data: { ok: true } });
+        const { server, baseUrl } = await createServer();
+        try {
+            const result = await postJson(baseUrl, { tool: "discover_colleague" });
+            expect(result).toEqual({ status: 200, body: { ok: true } });
+            expect(postMock).toHaveBeenCalledTimes(2);
+            expect(postMock.mock.calls[1][2].headers["X-Runtime-Token"]).toBe("fresh-token-1234567890");
+        }
+        finally {
+            server.close();
+        }
+    });
+});