aws-runtime-bridge 1.3.9 → 1.5.0

package/README.md

@@ -2,6 +2,8 @@
 
 AgentsWorkStudio 机器实例运行时桥接服务，用于在实例上管理 Agent 运行时、终端、配置与回调通信。
 
+> `aws-runtime-bridge` 面向机器实例宿主机运行，需要访问本机工作区、终端、运行时配置和文件系统；不要将它作为 Docker/Compose 服务部署。Docker Compose 仅用于仓库根目录的 `aws-dashboard` 与 `aws-mcp-server` Web 服务。
+
 ## 全局安装
 
 从 npm 包安装时：
@@ -23,7 +25,7 @@ npm install -g .
 
 ## 启动
 
-首次运行 `awsb` / `aws-bridge` 时，如果不存在 `~/.aws-bridge/config.json`，CLI 会进入交互式配置引导；也可以在提示中选择跳过。跳过时仍会创建配置文件并自动生成随机 `connectionKey`，终端会输出该密钥，请保存后在 server/面板连接此 Bridge 时使用。非交互环境（如 systemd、CI、Docker 后台启动）不会阻塞等待输入，也会自动生成随机 `connectionKey` 并跳过引导。
+首次运行 `awsb` / `aws-bridge` 时，如果不存在 `~/.aws-bridge/config.json`，CLI 会进入交互式配置引导；也可以在提示中选择跳过。跳过时仍会创建配置文件并自动生成随机 `connectionKey`，终端会输出该密钥，请保存后在 server/面板连接此 Bridge 时使用。非交互环境（如 systemd、CI 后台启动）不会阻塞等待输入，也会自动生成随机 `connectionKey` 并跳过引导。
 
 引导会生成类似下面的配置：
 
@@ -45,11 +47,14 @@ npm install -g .
 
 ```bash
 AWS_RUNTIME_BRIDGE_PORT=18081 \
-AWS_RUNTIME_SCHEDULER_BASE_URL=http://your-server-host:7380 \
 AWS_RUNTIME_HOME_DIR=/opt/agentswork/runtime-home \
 aws-bridge
 ```
 
+当 `~/.aws-bridge/config.json` 只配置了一个 `autoRegisterTargets[].serverUrl` 时，bridge 会自动将该地址作为 `/runtime/ping` 回连调度中心的地址，无需重复配置 `AWS_RUNTIME_SCHEDULER_BASE_URL`。如需显式覆盖，或同一个 bridge 配置了多个自动注册目标，请设置 `AWS_RUNTIME_SCHEDULER_BASE_URL` 指定当前实例测试连接时应回连的调度中心。
+
+If an existing runtime binding still stores an old scheduler URL such as `http://127.0.0.1:8080`, re-run auto-register, refresh the runtime token, or re-pair after changing `serverUrl` / `AWS_RUNTIME_SCHEDULER_BASE_URL`; bridge will not reuse a token issued for the old scheduler URL against the new scheduler URL.
+
 `aws-runtime-bridge` 命令仍作为兼容别名保留。安装 `aws-runtime-bridge` 后，包内会随附
 `aws-client-agent-mcp` 的编译产物；bridge 启动时只负责准备该 MCP 产物，不再在 Agent 启动时默认动态注入 `aws-mcp`。
 
@@ -84,8 +89,8 @@ sudo awsb service uninstall
 | 变量名 | 说明 | 默认值 |
 | --- | --- | --- |
 | `AWS_RUNTIME_BRIDGE_PORT` | Bridge HTTP 端口 | `18081` |
-| `AWS_RUNTIME_SCHEDULER_BASE_URL` | aws-mcp-server 地址 | `http://localhost:8080` |
+| `AWS_RUNTIME_SCHEDULER_BASE_URL` | aws-mcp-server 地址；显式配置优先级最高，未配置且只有一个 `autoRegisterTargets[].serverUrl` 时自动使用该地址 | 单目标自动注册地址；否则 `http://localhost:8080` |
 | `AWS_RUNTIME_HOME_DIR` | Bridge 管理配置与状态的主目录 | 当前用户 Home |
 | `AWS_RUNTIME_CORS_ORIGINS` | 允许访问 bridge 的来源，逗号分隔 | 本地开发地址 |
 
-生产环境中，`AWS_RUNTIME_SCHEDULER_BASE_URL` 必须填写机器实例可访问的 `aws-mcp-server` 地址，不能使用容器内的 `localhost`。
+生产环境中，bridge 最终解析出的调度中心地址必须是机器实例可访问的 `aws-mcp-server` 地址，不能使用不可达的容器内 `localhost`。如果配置了多个 `autoRegisterTargets`，bridge 不会静默选择第一个目标，需通过 `AWS_RUNTIME_SCHEDULER_BASE_URL` 或后续多调度中心身份路由明确目标。

package/dist/adapter/OpencodeSdkAdapter.d.ts

@@ -11,7 +11,7 @@
  * 参考：spectrai-community/src/main/adapter/OpenCodeSdkAdapter.ts
  */
 import { EventEmitter } from 'node:events';
-import type { BaseProviderAdapter, AdapterSessionConfig, ConversationMessage, SessionStatus } from './types.js';
+import type { AdapterSessionConfig, BaseProviderAdapter, ConversationMessage, SessionStatus } from './types.js';
 export declare class OpencodeSdkAdapter extends EventEmitter implements BaseProviderAdapter {
     readonly providerId = "opencode";
     readonly displayName = "OpenCode";
@@ -39,6 +39,18 @@ export declare class OpencodeSdkAdapter extends EventEmitter implements BaseProv
      */
     private loadSdk;
     private waitForServer;
+    /**
+     * 记录 OpenCode serve 启动阶段输出，用于进程提前退出时返回可诊断错误。
+     */
+    private recordStartupOutput;
+    /**
+     * 将 OpenCode serve 提前退出信息转成前端可直接展示的错误文本。
+     */
+    private formatStartupExitMessage;
+    /**
+     * 异步投递启动提示，避免首轮 OpenCode 处理耗时导致 /runtime/start 被前端误判为启动失败。
+     */
+    private dispatchInitialPrompt;
     private startSseLoop;
     private runSseLoop;
     private handleOpenCodeEvent;

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;AASH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAGpB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAsGpB,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,mBAAmB;IACjF,QAAQ,CAAC,UAAU,cAAc;IACjC,QAAQ,CAAC,WAAW,cAAc;IAElC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,SAAS,CAAC,CAAoB;IAEhC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgI5E,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;IAaf;;;OAGG;YACW,OAAO;YA6BP,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"}
+{"version":3,"file":"OpencodeSdkAdapter.d.ts","sourceRoot":"","sources":["../../src/adapter/OpencodeSdkAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAc3C,OAAO,KAAK,EACV,oBAAoB,EAEpB,mBAAmB,EACnB,mBAAmB,EAEnB,aAAa,EACd,MAAM,YAAY,CAAC;AA4GpB,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,mBAAmB;IACjF,QAAQ,CAAC,UAAU,cAAc;IACjC,QAAQ,CAAC,WAAW,cAAc;IAElC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,SAAS,CAAC,CAAoB;IAEhC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+I5E,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;IAUnG,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;IAaf;;;OAGG;YACW,OAAO;YA6BP,aAAa;IAmB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B,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

@@ -132,11 +132,16 @@ export class OpencodeSdkAdapter extends EventEmitter {
                 shell: useShell,
             });
             session.serverProcess = proc;
+            session.startupOutput = [];
             proc.stdout?.on('data', (d) => {
-                console.debug(`[OpencodeSdkAdapter] serve stdout: ${d.toString().slice(0, 200)}`);
+                const text = d.toString();
+                this.recordStartupOutput(session, text);
+                console.debug(`[OpencodeSdkAdapter] serve stdout: ${text.slice(0, 200)}`);
             });
             proc.stderr?.on('data', (d) => {
-                console.debug(`[OpencodeSdkAdapter] serve stderr: ${d.toString().slice(0, 200)}`);
+                const text = d.toString();
+                this.recordStartupOutput(session, text);
+                console.debug(`[OpencodeSdkAdapter] serve stderr: ${text.slice(0, 200)}`);
             });
             proc.on('error', (err) => {
                 console.error(`[OpencodeSdkAdapter] Server process error:`, err);
@@ -155,6 +160,9 @@ export class OpencodeSdkAdapter extends EventEmitter {
                 console.log(`[OpencodeSdkAdapter] Server exited with code ${code}`);
                 session.sseActive = false;
             });
+            const exitDuringStartup = new Promise((resolve) => {
+                proc.once('exit', (code, signal) => resolve({ code, signal }));
+            });
             // 步骤 3：创建 SDK 客户端
             const sdk = await this.loadSdk();
             const client = sdk.createOpencodeClient({
@@ -162,7 +170,12 @@ export class OpencodeSdkAdapter extends EventEmitter {
             });
             session.client = client;
             // 步骤 4：等待服务器就绪
-            await this.waitForServer(client, config.workingDirectory, 10_000, port);
+            await Promise.race([
+                this.waitForServer(client, config.workingDirectory, 10_000, port),
+                exitDuringStartup.then((exitInfo) => {
+                    throw new Error(this.formatStartupExitMessage(exitInfo, session.startupOutput));
+                }),
+            ]);
             console.log(`[OpencodeSdkAdapter] ★★★ OpenCode server ready ★★★ port=${port}`);
             // 步骤 5：创建 OpenCode 会话
             const createResult = await client.session.create({
@@ -182,7 +195,7 @@ export class OpencodeSdkAdapter extends EventEmitter {
             this.emit('status-change', sessionId, 'waiting_input');
             // 步骤 7：发送初始 Prompt
             if (config.initialPrompt) {
-                await this.sendMessage(sessionId, config.initialPrompt);
+                this.dispatchInitialPrompt(sessionId, config.initialPrompt);
             }
         }
         catch (err) {
@@ -264,6 +277,9 @@ export class OpencodeSdkAdapter extends EventEmitter {
         const session = this.sessions.get(sessionId);
         if (session) {
             session.idleCommands = commands;
+            if (session.adapterSession.status === 'waiting_input' && (commands.idleInputCommand || commands.nonInputCommand)) {
+                this.startIdleDetection(sessionId);
+            }
         }
     }
     async abortCurrentTurn(sessionId) {
@@ -382,6 +398,42 @@ export class OpencodeSdkAdapter extends EventEmitter {
         }
         throw new Error(`OpenCode server (port ${port}) did not start within ${timeoutMs}ms`);
     }
+    /**
+     * 记录 OpenCode serve 启动阶段输出，用于进程提前退出时返回可诊断错误。
+     */
+    recordStartupOutput(session, text) {
+        const normalized = text.trim();
+        if (!normalized)
+            return;
+        session.startupOutput = [...(session.startupOutput ?? []), normalized].slice(-8);
+    }
+    /**
+     * 将 OpenCode serve 提前退出信息转成前端可直接展示的错误文本。
+     */
+    formatStartupExitMessage(exitInfo, startupOutput) {
+        const exitReason = exitInfo.signal
+            ? `signal ${exitInfo.signal}`
+            : `code ${exitInfo.code ?? 'unknown'}`;
+        const output = (startupOutput ?? []).join('\n').trim();
+        if (!output) {
+            return `OpenCode server exited during startup (${exitReason}). Please check whether opencode serve can run in this workspace.`;
+        }
+        return `OpenCode server exited during startup (${exitReason}): ${output}`;
+    }
+    /**
+     * 异步投递启动提示，避免首轮 OpenCode 处理耗时导致 /runtime/start 被前端误判为启动失败。
+     */
+    dispatchInitialPrompt(sessionId, initialPrompt) {
+        void this.sendMessage(sessionId, initialPrompt).catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.emitEvent({
+                type: 'error',
+                sessionId,
+                timestamp: new Date().toISOString(),
+                data: { text: `OpenCode initial prompt failed: ${msg}` },
+            });
+        });
+    }
     startSseLoop(sessionId, session) {
         session.sseActive = true;
         const ac = new AbortController();

package/dist/adapter/OpencodeSdkAdapter.test.js

@@ -1,5 +1,9 @@
-import { describe, expect, it } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
 import { OpencodeSdkAdapter } from './OpencodeSdkAdapter.js';
+afterEach(() => {
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+});
 describe('OpencodeSdkAdapter', () => {
     it('should expose opencode provider identity', () => {
         const adapter = new OpencodeSdkAdapter();
@@ -16,4 +20,56 @@ describe('OpencodeSdkAdapter', () => {
         const prompt = Reflect.get(adapter, 'toIdlePrompt').call(adapter, 'system: 醒来了吗？使用get_profile获取自己的信息，继续未完成的任务或使用poll_message阻塞获取消息');
         expect(prompt).toBe('请调用 poll_message 工具阻塞等待新消息；收到消息后再处理消息内容。');
     });
+    it('starts idle detection when commands are set after OpenCode is already waiting for input', async () => {
+        vi.useFakeTimers();
+        const adapter = new OpencodeSdkAdapter();
+        const sentMessages = [];
+        Reflect.set(adapter, 'sessions', new Map([
+            [
+                'session-1',
+                {
+                    adapterSession: {
+                        sessionId: 'session-1',
+                        status: 'waiting_input',
+                        messages: [],
+                        createdAt: new Date().toISOString(),
+                        totalUsage: { inputTokens: 0, outputTokens: 0 },
+                    },
+                    config: {
+                        command: 'opencode',
+                        workingDirectory: process.cwd(),
+                        autoAccept: true,
+                    },
+                    sseActive: false,
+                    pendingPermissions: new Map(),
+                    emittedToolStarts: new Set(),
+                    workingDirectory: process.cwd(),
+                    userMessageIds: new Set(),
+                    currentAssistantText: '',
+                    seenTextPartIds: new Set(),
+                },
+            ],
+        ]));
+        vi.spyOn(adapter, 'sendMessage').mockImplementation(async (_sessionId, message) => {
+            sentMessages.push(message);
+        });
+        adapter.setIdleCommands('session-1', {
+            idleInputCommand: 'system: 使用poll_message阻塞获取消息',
+            nonInputCommand: '',
+        });
+        await vi.advanceTimersByTimeAsync(500);
+        expect(sentMessages).toEqual(['请调用 poll_message 工具阻塞等待新消息；收到消息后再处理消息内容。']);
+    });
+    it('includes serve startup output when the OpenCode process exits early', () => {
+        const adapter = new OpencodeSdkAdapter();
+        const message = Reflect.get(adapter, 'formatStartupExitMessage').call(adapter, { code: 1, signal: null }, ['missing auth configuration']);
+        expect(message).toContain('OpenCode server exited during startup (code 1)');
+        expect(message).toContain('missing auth configuration');
+    });
+    it('dispatches the initial prompt asynchronously so launch can return after session creation', () => {
+        const adapter = new OpencodeSdkAdapter();
+        const sendMessage = vi.spyOn(adapter, 'sendMessage').mockResolvedValue(undefined);
+        Reflect.get(adapter, 'dispatchInitialPrompt').call(adapter, 'session-1', 'hello');
+        expect(sendMessage).toHaveBeenCalledWith('session-1', 'hello');
+    });
 });

package/dist/config.d.ts

@@ -5,7 +5,20 @@
  */
 /** 服务端口 */
 export declare const port: number;
-/** 调度器基础 URL */
+/** 默认调度器基础 URL */
+export declare const DEFAULT_SCHEDULER_BASE_URL = "http://localhost:8080";
+export type SchedulerBaseUrlSource = "env" | "single-auto-register-target" | "default" | "ambiguous-auto-register-targets";
+export interface SchedulerBaseUrlResolution {
+    url: string;
+    source: SchedulerBaseUrlSource;
+    ambiguousTargetUrls: string[];
+}
+/**
+ * 解析调度中心基础 URL。
+ * 主流程：显式环境变量优先；未配置时，单个自动注册目标可作为宿主机部署的零额外配置回退；多目标不静默取第一个。
+ */
+export declare function resolveSchedulerBaseUrl(): SchedulerBaseUrlResolution;
+/** 调度器基础 URL（兼容旧导入；请求处理应优先调用 resolveSchedulerBaseUrl 获取最新值） */
 export declare const schedulerBaseUrl: string;
 /** Node 环境 */
 export declare const nodeEnv: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,WAAW;AACX,eAAO,MAAM,IAAI,EAAE,MAElB,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,gBAAgB,EAAE,MACwC,CAAC;AAExE,cAAc;AACd,eAAO,MAAM,OAAO,EAAE,MAA8C,CAAC;AAErE,oCAAoC;AACpC,eAAO,MAAM,oBAAoB,EAAE,OACiB,CAAC;AAErD,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAMC,CAAC;AAEzC,gEAAgE;AAChE,wBAAgB,uBAAuB,IAAI,IAAI,CAAG;AAElD,eAAe;AACf,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,2BAA2B;AAC3B,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,0BAA0B;AAC1B,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,yBAAyB;AACzB,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED,sBAAsB;AACtB,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,yBAAyB;AACzB,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;GAEG;AAEH,yBAAyB;AACzB,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB,EACrB,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1C,eAAe;AACf,eAAO,MAAM,mBAAmB,SACiB,CAAC;AAElD,iCAAiC;AACjC,eAAO,MAAM,2BAA2B,QAEvC,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,uBAAuB,QAEnC,CAAC;AAEF;;GAEG;AAEH,eAAe;AACf,eAAO,MAAM,qBAAqB,SAA2C,CAAC;AAE9E,YAAY;AACZ,eAAO,MAAM,uBAAuB,QAAkC,CAAC;AAEvE,iBAAiB;AACjB,eAAO,MAAM,sBAAsB,QAAiC,CAAC;AAErE,oBAAoB;AACpB,eAAO,MAAM,2BAA2B,QAAsC,CAAC;AAE/E,WAAW;AACX,eAAO,MAAM,0BAA0B,QAAqC,CAAC;AAE7E,WAAW;AACX,eAAO,MAAM,uBAAuB,QAAkC,CAAC;AAEvE,aAAa;AACb,eAAO,MAAM,4BAA4B,QACH,CAAC;AAEvC,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,QAC4B,CAAC;AAElE,aAAa;AACb,eAAO,MAAM,yBAAyB,QAErC,CAAC;AAEF,iBAAiB;AACjB,eAAO,MAAM,4BAA4B,QAExC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,WAAW;AACX,eAAO,MAAM,IAAI,EAAE,MAElB,CAAC;AAEF,kBAAkB;AAClB,eAAO,MAAM,0BAA0B,0BAA0B,CAAC;AAElE,MAAM,MAAM,sBAAsB,GAC9B,KAAK,GACL,6BAA6B,GAC7B,SAAS,GACT,iCAAiC,CAAC;AAEtC,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,sBAAsB,CAAC;IAC/B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AA+ED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,0BAA0B,CAiCpE;AAED,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,EAAE,MAEH,CAAC;AAE7B,cAAc;AACd,eAAO,MAAM,OAAO,EAAE,MAA8C,CAAC;AAErE,oCAAoC;AACpC,eAAO,MAAM,oBAAoB,EAAE,OACiB,CAAC;AAErD,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAMC,CAAC;AAEzC,gEAAgE;AAChE,wBAAgB,uBAAuB,IAAI,IAAI,CAAG;AAElD,eAAe;AACf,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,2BAA2B;AAC3B,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,0BAA0B;AAC1B,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,yBAAyB;AACzB,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED,sBAAsB;AACtB,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,yBAAyB;AACzB,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;GAEG;AAEH,yBAAyB;AACzB,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB,EACrB,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1C,eAAe;AACf,eAAO,MAAM,mBAAmB,SACiB,CAAC;AAElD,iCAAiC;AACjC,eAAO,MAAM,2BAA2B,QAEvC,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,uBAAuB,QAEnC,CAAC;AAEF;;GAEG;AAEH,eAAe;AACf,eAAO,MAAM,qBAAqB,SAA2C,CAAC;AAE9E,YAAY;AACZ,eAAO,MAAM,uBAAuB,QAAkC,CAAC;AAEvE,iBAAiB;AACjB,eAAO,MAAM,sBAAsB,QAAiC,CAAC;AAErE,oBAAoB;AACpB,eAAO,MAAM,2BAA2B,QAAsC,CAAC;AAE/E,WAAW;AACX,eAAO,MAAM,0BAA0B,QAAqC,CAAC;AAE7E,WAAW;AACX,eAAO,MAAM,uBAAuB,QAAkC,CAAC;AAEvE,aAAa;AACb,eAAO,MAAM,4BAA4B,QACH,CAAC;AAEvC,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,QAC4B,CAAC;AAElE,aAAa;AACb,eAAO,MAAM,yBAAyB,QAErC,CAAC;AAEF,iBAAiB;AACjB,eAAO,MAAM,4BAA4B,QAExC,CAAC"}

package/dist/config.js

@@ -3,12 +3,111 @@
  *
  * 集中管理所有环境变量和配置常量
  */
-import os from "node:os";
+import { homedir } from "node:os";
 import path from "node:path";
+import fs from "node:fs";
 /** 服务端口 */
 export const port = Number(process.env.AWS_RUNTIME_BRIDGE_PORT || 18081);
-/** 调度器基础 URL */
-export const schedulerBaseUrl = process.env.AWS_RUNTIME_SCHEDULER_BASE_URL || "http://localhost:8080";
+/** 默认调度器基础 URL */
+export const DEFAULT_SCHEDULER_BASE_URL = "http://localhost:8080";
+function normalizeOptionalString(value) {
+    if (value == null) {
+        return undefined;
+    }
+    const normalized = String(value).trim();
+    return normalized || undefined;
+}
+function normalizeSchedulerHttpBaseUrl(value) {
+    const raw = normalizeOptionalString(value);
+    if (!raw) {
+        return undefined;
+    }
+    const repaired = raw.replace(/^((?:https?|wss?):\/\/(?:\[[^\]]+\]|[^/:?#]+):\d+):\d+(?=\/|$)/i, "$1");
+    try {
+        const url = new URL(repaired);
+        if (url.protocol === "ws:") {
+            url.protocol = "http:";
+        }
+        else if (url.protocol === "wss:") {
+            url.protocol = "https:";
+        }
+        else {
+            url.protocol = url.protocol.toLowerCase();
+        }
+        url.hostname = url.hostname.toLowerCase();
+        return url.origin;
+    }
+    catch {
+        return repaired.replace(/\/+$/, "");
+    }
+}
+function getAutoRegisterConfigFilePath() {
+    const testHomeDir = String(process.env.AWS_TEST_HOME || "").trim();
+    return path.join(testHomeDir || homedir(), ".aws-bridge", "config.json");
+}
+function readAutoRegisterTargetUrls() {
+    const configPath = getAutoRegisterConfigFilePath();
+    try {
+        if (!fs.existsSync(configPath)) {
+            return [];
+        }
+        const parsed = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        const rawTargets = Array.isArray(parsed.autoRegisterTargets)
+            ? parsed.autoRegisterTargets
+            : [];
+        const targetUrls = rawTargets
+            .filter((item) => Boolean(item && typeof item === "object" && !Array.isArray(item)))
+            .map((target) => normalizeSchedulerHttpBaseUrl(target.serverUrl) ||
+            normalizeSchedulerHttpBaseUrl(target.schedulerBaseUrl))
+            .filter((url) => Boolean(url));
+        if (targetUrls.length > 0) {
+            return Array.from(new Set(targetUrls));
+        }
+        const topLevelUrl = normalizeSchedulerHttpBaseUrl(parsed.serverUrl) ||
+            normalizeSchedulerHttpBaseUrl(parsed.schedulerBaseUrl);
+        return topLevelUrl ? [topLevelUrl] : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 解析调度中心基础 URL。
+ * 主流程：显式环境变量优先；未配置时，单个自动注册目标可作为宿主机部署的零额外配置回退；多目标不静默取第一个。
+ */
+export function resolveSchedulerBaseUrl() {
+    const envSchedulerBaseUrl = normalizeSchedulerHttpBaseUrl(process.env.AWS_RUNTIME_SCHEDULER_BASE_URL);
+    if (envSchedulerBaseUrl) {
+        return {
+            url: envSchedulerBaseUrl,
+            source: "env",
+            ambiguousTargetUrls: [],
+        };
+    }
+    const autoRegisterTargetUrls = readAutoRegisterTargetUrls();
+    if (autoRegisterTargetUrls.length === 1) {
+        return {
+            url: autoRegisterTargetUrls[0] || DEFAULT_SCHEDULER_BASE_URL,
+            source: "single-auto-register-target",
+            ambiguousTargetUrls: [],
+        };
+    }
+    if (autoRegisterTargetUrls.length > 1) {
+        return {
+            url: DEFAULT_SCHEDULER_BASE_URL,
+            source: "ambiguous-auto-register-targets",
+            ambiguousTargetUrls: autoRegisterTargetUrls,
+        };
+    }
+    return {
+        url: DEFAULT_SCHEDULER_BASE_URL,
+        source: "default",
+        ambiguousTargetUrls: [],
+    };
+}
+/** 调度器基础 URL（兼容旧导入；请求处理应优先调用 resolveSchedulerBaseUrl 获取最新值） */
+export const schedulerBaseUrl = normalizeSchedulerHttpBaseUrl(process.env.AWS_RUNTIME_SCHEDULER_BASE_URL) ||
+    DEFAULT_SCHEDULER_BASE_URL;
 /** Node 环境 */
 export const nodeEnv = process.env.NODE_ENV || "development";
 /** 是否允许浏览宿主机任意目录（默认关闭，仅建议本地排障启用） */
@@ -23,7 +122,7 @@ export const allowedCorsOrigins = String(process.env.AWS_RUNTIME_CORS_ORIGINS ||
 export function validateProductionToken() { }
 /** 获取运行时主目录 */
 export function getRuntimeHomeDir() {
-    return String(process.env.AWS_RUNTIME_HOME_DIR || "").trim() || os.homedir();
+    return String(process.env.AWS_RUNTIME_HOME_DIR || "").trim() || homedir();
 }
 /** 获取 Claude 配置文件路径（AI 配置写入 settings.json） */
 export function getClaudeConfigFile(runtimeHome) {

package/dist/config.test.d.ts

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

package/dist/config.test.d.ts.map

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

package/dist/config.test.js

@@ -0,0 +1,95 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+vi.mock("node:os", async () => {
+    const actual = await vi.importActual("node:os");
+    const mocked = {
+        ...actual,
+        homedir: () => process.env.AWS_TEST_HOME || actual.homedir(),
+    };
+    return {
+        ...mocked,
+        default: mocked,
+    };
+});
+const originalEnv = { ...process.env };
+const tempRoots = [];
+function createRuntimeHome() {
+    const root = mkdtempSync(path.join(os.tmpdir(), "aws-config-"));
+    tempRoots.push(root);
+    return root;
+}
+function useRuntimeHome(runtimeHome) {
+    process.env.AWS_TEST_HOME = runtimeHome;
+    process.env.HOME = runtimeHome;
+    process.env.USERPROFILE = runtimeHome;
+    process.env.AWS_RUNTIME_HOME_DIR = runtimeHome;
+    delete process.env.AWS_RUNTIME_SCHEDULER_BASE_URL;
+}
+function writeBridgeConfig(runtimeHome, autoRegisterTargets) {
+    const configPath = path.join(runtimeHome, ".aws-bridge", "config.json");
+    mkdirSync(path.dirname(configPath), { recursive: true });
+    writeFileSync(configPath, `${JSON.stringify({ connectionKey: "bridge-key", autoRegisterTargets }, null, 2)}\n`, "utf-8");
+}
+afterEach(() => {
+    process.env = { ...originalEnv };
+    vi.resetModules();
+    vi.clearAllMocks();
+    vi.restoreAllMocks();
+    for (const root of tempRoots.splice(0)) {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+describe("scheduler base URL resolution", () => {
+    it("keeps explicit AWS_RUNTIME_SCHEDULER_BASE_URL as the highest priority", async () => {
+        const runtimeHome = createRuntimeHome();
+        useRuntimeHome(runtimeHome);
+        process.env.AWS_RUNTIME_SCHEDULER_BASE_URL = "http://explicit.local:7380/path";
+        writeBridgeConfig(runtimeHome, [{ serverUrl: "http://target.local:7380" }]);
+        const { resolveSchedulerBaseUrl } = await import("./config.js");
+        expect(resolveSchedulerBaseUrl()).toEqual({
+            url: "http://explicit.local:7380",
+            source: "env",
+            ambiguousTargetUrls: [],
+        });
+    });
+    it("uses a single auto-register target serverUrl when scheduler env is absent", async () => {
+        const runtimeHome = createRuntimeHome();
+        useRuntimeHome(runtimeHome);
+        writeBridgeConfig(runtimeHome, [{ serverUrl: "http://127.0.0.1:7380" }]);
+        const { resolveSchedulerBaseUrl } = await import("./config.js");
+        expect(resolveSchedulerBaseUrl()).toEqual({
+            url: "http://127.0.0.1:7380",
+            source: "single-auto-register-target",
+            ambiguousTargetUrls: [],
+        });
+    });
+    it("does not silently select the first auto-register target when multiple URLs exist", async () => {
+        const runtimeHome = createRuntimeHome();
+        useRuntimeHome(runtimeHome);
+        writeBridgeConfig(runtimeHome, [
+            { serverUrl: "http://scheduler-a.local:7380" },
+            { serverUrl: "http://scheduler-b.local:7380" },
+        ]);
+        const { DEFAULT_SCHEDULER_BASE_URL, resolveSchedulerBaseUrl } = await import("./config.js");
+        expect(resolveSchedulerBaseUrl()).toEqual({
+            url: DEFAULT_SCHEDULER_BASE_URL,
+            source: "ambiguous-auto-register-targets",
+            ambiguousTargetUrls: [
+                "http://scheduler-a.local:7380",
+                "http://scheduler-b.local:7380",
+            ],
+        });
+    });
+    it("falls back to the legacy localhost default when no scheduler source exists", async () => {
+        const runtimeHome = createRuntimeHome();
+        useRuntimeHome(runtimeHome);
+        const { DEFAULT_SCHEDULER_BASE_URL, resolveSchedulerBaseUrl } = await import("./config.js");
+        expect(resolveSchedulerBaseUrl()).toEqual({
+            url: DEFAULT_SCHEDULER_BASE_URL,
+            source: "default",
+            ambiguousTargetUrls: [],
+        });
+    });
+});

package/dist/routes/file-browser.d.ts

@@ -3,5 +3,15 @@
  *
  * 提供文件系统浏览功能
  */
+import multer from 'multer';
 export declare const fileBrowserRouter: import("express-serve-static-core").Router;
+export declare const WORKSPACE_UPLOAD_FILE_LIMIT = 2000;
+export declare function createWorkspaceUploadLimitResponse(error: multer.MulterError): {
+    status: number;
+    body: {
+        error: string;
+        code: string;
+    };
+};
+export declare function parseWorkspaceUploadRelativePaths(body: Record<string, unknown>): string[];
 //# sourceMappingURL=file-browser.d.ts.map

package/dist/routes/file-browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-browser.d.ts","sourceRoot":"","sources":["../../src/routes/file-browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,eAAO,MAAM,iBAAiB,4CAAW,CAAC"}
+{"version":3,"file":"file-browser.d.ts","sourceRoot":"","sources":["../../src/routes/file-browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAsB5B,eAAO,MAAM,iBAAiB,4CAAW,CAAC;AAE1C,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAqChD,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAUvI;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAgBzF"}