npm - aws-runtime-bridge - Versions diffs - 1.3.2 → 1.3.6 - Mend

aws-runtime-bridge 1.3.2 → 1.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/README.md +17 -1
package/dist/adapter/CodexSdkAdapter.d.ts +6 -0
package/dist/adapter/CodexSdkAdapter.d.ts.map +1 -1
package/dist/adapter/CodexSdkAdapter.js +41 -3
package/dist/adapter/OpencodeSdkAdapter.d.ts +6 -0
package/dist/adapter/OpencodeSdkAdapter.d.ts.map +1 -1
package/dist/adapter/OpencodeSdkAdapter.js +44 -7
package/dist/services/cli-commands.d.ts +7 -0
package/dist/services/cli-commands.d.ts.map +1 -1
package/dist/services/cli-commands.js +214 -4
package/dist/services/cli-commands.test.js +140 -2
package/package.json +15 -3

package/README.md CHANGED Viewed

@@ -23,7 +23,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、Docker 后台启动）不会阻塞等待输入，也会自动生成随机 `connectionKey` 并跳过引导。
 引导会生成类似下面的配置：
@@ -63,6 +63,22 @@ AWS_CLIENT_AGENT_MCP_ARGS='[]' \
 aws-bridge
 ```
+## systemd 服务管理
+Linux systemd 环境中可使用 CLI 安装或卸载 `awsb.service`。安装命令会写入 systemd unit、执行 `systemctl daemon-reload`、启用开机自启，并在服务尚未运行时立即启动：
+```bash
+sudo awsb service install
+```
+卸载命令会在服务运行时先停止服务，禁用开机自启，删除 unit 文件，并重新执行 `systemctl daemon-reload`：
+```bash
+sudo awsb service uninstall
+```
+`service` 命令仅支持 Linux systemd；在其他平台会直接返回清晰错误。生成的 unit 会设置 `AWS_BRIDGE_SKIP_SETUP=true`，避免后台服务启动时阻塞在交互式配置引导。
 ## 关键环境变量
 | 变量名 | 说明 | 默认值 |

package/dist/adapter/CodexSdkAdapter.d.ts CHANGED Viewed

@@ -10,6 +10,7 @@ export declare class CodexSdkAdapter extends EventEmitter implements BaseProvide
     readonly providerId = "codex";
     readonly displayName = "Codex";
     private sessions;
+    private sdkModule?;
     startSession(sessionId: string, config: AdapterSessionConfig): Promise<void>;
     sendMessage(sessionId: string, message: string): Promise<void>;
     sendConfirmation(_sessionId: string, _accept: boolean): Promise<void>;
@@ -27,6 +28,11 @@ export declare class CodexSdkAdapter extends EventEmitter implements BaseProvide
     getSessionStatus(sessionId: string): SessionStatus | undefined;
     getSessionPid(_sessionId: string): number | undefined;
     cleanup(): void;
+    /**
+     * 按需加载 Codex SDK：只有启动 Codex provider 时才解析重依赖，
+     * 避免 bridge 基础安装默认拉取 @openai/codex 的多平台二进制包。
+     */
+    private loadSdk;
     private buildCodexOptions;
     private warnUnsupportedMcpConfig;
     private buildThreadOptions;

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

	@@ -1 +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;IAa1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,cAAc;YAcR,cAAc;IAuB5B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,2BAA2B;CAOpC"}
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;AAgB3C,OAAO,KAAK,EAEV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EAEnB,aAAa,EAEd,MAAM,YAAY,CAAC;AA0RpB,qBAAa,eAAgB,SAAQ,YAAa,YAAW,mBAAmB;IAC9E,QAAQ,CAAC,UAAU,WAAW;IAC9B,QAAQ,CAAC,WAAW,WAAW;IAE/B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,SAAS,CAAC,CAAiB;IAE7B,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmE5E,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;IA4BhB,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;;;OAGG;YACW,OAAO;IA6BrB,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 CHANGED Viewed

@@ -5,9 +5,14 @@
  * 将 Codex 事件流映射到 runtime-bridge 统一 ProviderEvent。
  */
 import { EventEmitter } from 'node:events';
-import { Codex, } from '@openai/codex-sdk';
 import { v4 as uuidv4 } from 'uuid';
 import { getToolActionInfo } from './types.js';
+function hasErrorCode(error) {
+    return error instanceof Error && 'code' in error && typeof error.code === 'string';
+}
+function isMissingPackageError(error, packageName) {
+    return hasErrorCode(error) && error.code === 'ERR_MODULE_NOT_FOUND' && error.message.includes(packageName);
+}
 const CODEX_IDLE_THRESHOLD_MS = 1500;
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -243,7 +248,8 @@ export class CodexSdkAdapter extends EventEmitter {
             totalUsage: { inputTokens: 0, outputTokens: 0 },
         };
         try {
-            const codex = new Codex(this.buildCodexOptions(config));
+            const sdk = await this.loadSdk();
+            const codex = new sdk.Codex(this.buildCodexOptions(config));
             this.warnUnsupportedMcpConfig(config);
             const thread = codex.startThread(this.buildThreadOptions(config));
             const entry = {
@@ -365,7 +371,8 @@ export class CodexSdkAdapter extends EventEmitter {
         this.sessions.delete(sessionId);
     }
     async resumeSession(sessionId, providerSessionId, config) {
-        const codex = new Codex(this.buildCodexOptions(config));
+        const sdk = await this.loadSdk();
+        const codex = new sdk.Codex(this.buildCodexOptions(config));
         this.warnUnsupportedMcpConfig(config);
         const thread = codex.resumeThread(providerSessionId, this.buildThreadOptions(config));
         const adapterSession = {
@@ -411,6 +418,37 @@ export class CodexSdkAdapter extends EventEmitter {
         }
         this.sessions.clear();
     }
+    /**
+     * 按需加载 Codex SDK：只有启动 Codex provider 时才解析重依赖，
+     * 避免 bridge 基础安装默认拉取 @openai/codex 的多平台二进制包。
+     */
+    async loadSdk() {
+        if (!this.sdkModule) {
+            try {
+                this.sdkModule = await import('@openai/codex-sdk');
+            }
+            catch (error) {
+                if (isMissingPackageError(error, '@openai/codex-sdk')) {
+                    throw new Error([
+                        'Codex SDK provider is not installed.',
+                        '',
+                        'aws-runtime-bridge keeps heavy provider SDKs optional to reduce global install size.',
+                        'To use SDK mode with command "codex", install:',
+                        '',
+                        '  npm install -g @openai/codex-sdk',
+                        '',
+                        'If aws-runtime-bridge is installed locally, install the SDK in the same project:',
+                        '',
+                        '  npm install @openai/codex-sdk',
+                        '',
+                        `Original error: ${error instanceof Error ? error.message : String(error)}`,
+                    ].join('\n'));
+                }
+                throw error;
+            }
+        }
+        return this.sdkModule;
+    }
     buildCodexOptions(config) {
         const env = toEnvRecord(process.env, config.envOverrides);
         const options = { env };

package/dist/adapter/OpencodeSdkAdapter.d.ts CHANGED Viewed

@@ -16,6 +16,7 @@ export declare class OpencodeSdkAdapter extends EventEmitter implements BaseProv
     readonly providerId = "opencode";
     readonly displayName = "OpenCode";
     private sessions;
+    private sdkModule?;
     startSession(sessionId: string, config: AdapterSessionConfig): Promise<void>;
     sendMessage(sessionId: string, message: string): Promise<void>;
     sendConfirmation(sessionId: string, accept: boolean): Promise<void>;
@@ -32,6 +33,11 @@ export declare class OpencodeSdkAdapter extends EventEmitter implements BaseProv
     getSessionStatus(sessionId: string): SessionStatus | undefined;
     getSessionPid(sessionId: string): number | undefined;
     cleanup(): void;
+    /**
+     * 按需加载 OpenCode SDK：只有启动 OpenCode provider 时才解析依赖，
+     * 避免 bridge 基础安装默认携带所有可选 runtime SDK。
+     */
+    private loadSdk;
     private waitForServer;
     private startSseLoop;
     private runSseLoop;

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

	@@ -1 +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;IAStB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,2BAA2B;CAOpC"}
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"}

package/dist/adapter/OpencodeSdkAdapter.js CHANGED Viewed

@@ -10,14 +10,13 @@
  *
  * 参考：spectrai-community/src/main/adapter/OpenCodeSdkAdapter.ts
  */
-import { spawn } from 'child_process';
+import { spawn } from 'node:child_process';
 import { EventEmitter } from 'node:events';
-import * as fs from 'fs';
-import * as net from 'net';
-import * as os from 'os';
-import * as path from 'path';
+import * as fs from 'node:fs';
+import * as net from 'node:net';
+import * as os from 'node:os';
+import * as path from 'node:path';
 import { v4 as uuidv4 } from 'uuid';
-import { createOpencodeClient, } from '@opencode-ai/sdk';
 import { getToolActionInfo } from './types.js';
 // ============ 可执行文件查找 ============
 /**
@@ -77,6 +76,12 @@ async function findAvailablePort(startPort = 14096) {
     }
     throw new Error(`No available port found in range ${startPort}–${startPort + 99}`);
 }
+function hasErrorCode(error) {
+    return error instanceof Error && 'code' in error && typeof error.code === 'string';
+}
+function isMissingPackageError(error, packageName) {
+    return hasErrorCode(error) && error.code === 'ERR_MODULE_NOT_FOUND' && error.message.includes(packageName);
+}
 // ============ Adapter ============
 export class OpencodeSdkAdapter extends EventEmitter {
     constructor() {
@@ -151,7 +156,8 @@ export class OpencodeSdkAdapter extends EventEmitter {
                 session.sseActive = false;
             });
             // 步骤 3：创建 SDK 客户端
-            const client = createOpencodeClient({
+            const sdk = await this.loadSdk();
+            const client = sdk.createOpencodeClient({
                 baseUrl: `http://127.0.0.1:${port}`,
             });
             session.client = client;
@@ -330,6 +336,37 @@ export class OpencodeSdkAdapter extends EventEmitter {
         this.sessions.clear();
     }
     // ============ 私有方法 ============
+    /**
+     * 按需加载 OpenCode SDK：只有启动 OpenCode provider 时才解析依赖，
+     * 避免 bridge 基础安装默认携带所有可选 runtime SDK。
+     */
+    async loadSdk() {
+        if (!this.sdkModule) {
+            try {
+                this.sdkModule = await import('@opencode-ai/sdk');
+            }
+            catch (error) {
+                if (isMissingPackageError(error, '@opencode-ai/sdk')) {
+                    throw new Error([
+                        'OpenCode SDK provider is not installed.',
+                        '',
+                        'aws-runtime-bridge keeps Codex/OpenCode provider SDKs optional to reduce default install size.',
+                        'To use SDK mode with command "opencode", install:',
+                        '',
+                        '  npm install -g @opencode-ai/sdk',
+                        '',
+                        'If aws-runtime-bridge is installed locally, install the SDK in the same project:',
+                        '',
+                        '  npm install @opencode-ai/sdk',
+                        '',
+                        `Original error: ${error instanceof Error ? error.message : String(error)}`,
+                    ].join('\n'));
+                }
+                throw error;
+            }
+        }
+        return this.sdkModule;
+    }
     async waitForServer(client, directory, timeoutMs, port) {
         const deadline = Date.now() + timeoutMs;
         while (Date.now() < deadline) {

package/dist/services/cli-commands.d.ts CHANGED Viewed

@@ -14,7 +14,14 @@ export interface CliCommandOptions {
     stderr?: (message: string) => void;
     runCommand?: (command: string, args: string[]) => CommandRunResult;
     configure?: () => Promise<StartupConfigWizardResult>;
+    platform?: NodeJS.Platform;
+    serviceUnitPath?: string;
+    executablePath?: string;
 }
 export declare function readPackageVersion(packageRoot?: string): string;
+/**
+ * 生成 systemd unit 内容，主流程是用当前 Node 可执行文件启动当前 CLI 入口。
+ */
+export declare function createSystemdUnitContent(executablePath: string): string;
 export declare function handleCliCommand(options?: CliCommandOptions): Promise<CliCommandResult>;
 //# sourceMappingURL=cli-commands.d.ts.map

package/dist/services/cli-commands.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli-commands.d.ts","sourceRoot":"","sources":["../../src/services/cli-commands.ts"],"names":[],"mappings":"~~AAIA~~,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;~~AAG5E~~,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,gBAAgB,CAAC;IACnE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;~~CACtD~~;AAYD,wBAAgB,kBAAkB,CAAC,WAAW,SAA0B,GAAG,MAAM,CAMhF;~~AAcD~~,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,~~CAqC3B~~"}
1	+ {"version":3,"file":"cli-commands.d.ts","sourceRoot":"","sources":["../../src/services/cli-commands.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAM5E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,gBAAgB,CAAC;IACnE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAYD,wBAAgB,kBAAkB,CAAC,WAAW,SAA0B,GAAG,MAAM,CAMhF;AAgCD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAsBvE;AAwOD,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA+C3B"}

package/dist/services/cli-commands.js CHANGED Viewed

@@ -1,8 +1,10 @@
 import { spawnSync } from "node:child_process";
-import { readFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { configureStartupConfig } from "./startup-config-wizard.js";
+const SYSTEMD_SERVICE_NAME = "awsb.service";
+const DEFAULT_SYSTEMD_UNIT_PATH = `/etc/systemd/system/${SYSTEMD_SERVICE_NAME}`;
 function getDefaultPackageRoot() {
     const currentFile = fileURLToPath(import.meta.url);
     return path.resolve(path.dirname(currentFile), "..", "..");
@@ -19,14 +21,215 @@ function defaultRunCommand(command, args) {
     });
     return { status: result.status, error: result.error };
 }
+function defaultStdout(message) {
+    process.stdout.write(`${message}\n`);
+}
+function defaultStderr(message) {
+    process.stderr.write(`${message}\n`);
+}
 function isVersionCommand(command) {
     return command === "-v" || command === "--version" || command === "version";
 }
+function quoteSystemdExecArg(value) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function getDefaultExecutablePath() {
+    return process.argv[1]
+        ? path.resolve(process.argv[1])
+        : fileURLToPath(import.meta.url);
+}
+/**
+ * 生成 systemd unit 内容，主流程是用当前 Node 可执行文件启动当前 CLI 入口。
+ */
+export function createSystemdUnitContent(executablePath) {
+    const execStart = [process.execPath, executablePath]
+        .map((part) => quoteSystemdExecArg(part))
+        .join(" ");
+    return [
+        "[Unit]",
+        "Description=AgentsWorkStudio Runtime Bridge",
+        "After=network-online.target",
+        "Wants=network-online.target",
+        "",
+        "[Service]",
+        "Type=simple",
+        "Environment=AWS_BRIDGE_SKIP_SETUP=true",
+        `ExecStart=${execStart}`,
+        "Restart=on-failure",
+        "RestartSec=5s",
+        "",
+        "[Install]",
+        "WantedBy=multi-user.target",
+        "",
+    ].join("\n");
+}
+function runSystemctl(runCommand, args) {
+    return runCommand("systemctl", args);
+}
+function systemctlFailureMessage(action, result) {
+    if (result.error) {
+        return `[runtime-bridge] ${action}失败: ${result.error.message}`;
+    }
+    return `[runtime-bridge] ${action}失败，systemctl 退出码: ${result.status ?? "unknown"}`;
+}
+function commandSucceeded(result) {
+    return !result.error && result.status === 0;
+}
+function ensureLinuxSystemd(platform, stderr) {
+    if (platform === "linux") {
+        return true;
+    }
+    stderr("[runtime-bridge] service 命令仅支持 Linux systemd 环境。");
+    return false;
+}
+function printServiceUsage(stdout) {
+    stdout("Usage: awsb service <install|uninstall>");
+}
+/**
+ * 安装 systemd 服务，主干流程是写入 unit、重载 systemd、启用开机自启，并在未运行时启动服务。
+ */
+function installSystemdService(options) {
+    if (!ensureLinuxSystemd(options.platform, options.stderr)) {
+        return { handled: true, exitCode: 1 };
+    }
+    const unitContent = createSystemdUnitContent(options.executablePath);
+    try {
+        mkdirSync(path.dirname(options.serviceUnitPath), { recursive: true });
+        writeFileSync(options.serviceUnitPath, unitContent, {
+            encoding: "utf-8",
+            mode: 0o644,
+        });
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        options.stderr(`[runtime-bridge] 写入 systemd unit 失败: ${err.message}`);
+        return { handled: true, exitCode: 1 };
+    }
+    const daemonReloadResult = runSystemctl(options.runCommand, ["daemon-reload"]);
+    if (!commandSucceeded(daemonReloadResult)) {
+        options.stderr(systemctlFailureMessage("重载 systemd", daemonReloadResult));
+        return { handled: true, exitCode: daemonReloadResult.status ?? 1 };
+    }
+    const enableResult = runSystemctl(options.runCommand, [
+        "enable",
+        SYSTEMD_SERVICE_NAME,
+    ]);
+    if (!commandSucceeded(enableResult)) {
+        options.stderr(systemctlFailureMessage("启用 awsb 开机自启", enableResult));
+        return { handled: true, exitCode: enableResult.status ?? 1 };
+    }
+    const activeResult = runSystemctl(options.runCommand, [
+        "is-active",
+        "--quiet",
+        SYSTEMD_SERVICE_NAME,
+    ]);
+    if (activeResult.error) {
+        options.stderr(systemctlFailureMessage("检查 awsb 服务状态", activeResult));
+        return { handled: true, exitCode: 1 };
+    }
+    if (activeResult.status !== 0) {
+        const startResult = runSystemctl(options.runCommand, [
+            "start",
+            SYSTEMD_SERVICE_NAME,
+        ]);
+        if (!commandSucceeded(startResult)) {
+            options.stderr(systemctlFailureMessage("启动 awsb 服务", startResult));
+            return { handled: true, exitCode: startResult.status ?? 1 };
+        }
+        options.stdout("[runtime-bridge] awsb systemd 服务已安装、已启用开机自启并已启动。");
+        return { handled: true, exitCode: 0 };
+    }
+    options.stdout("[runtime-bridge] awsb systemd 服务已安装并已启用开机自启；服务已在运行。");
+    return { handled: true, exitCode: 0 };
+}
+/**
+ * 卸载 systemd 服务，主干流程是按需停止、禁用自启、删除 unit，并重载 systemd。
+ */
+function uninstallSystemdService(options) {
+    if (!ensureLinuxSystemd(options.platform, options.stderr)) {
+        return { handled: true, exitCode: 1 };
+    }
+    const unitExists = existsSync(options.serviceUnitPath);
+    const activeResult = runSystemctl(options.runCommand, [
+        "is-active",
+        "--quiet",
+        SYSTEMD_SERVICE_NAME,
+    ]);
+    if (activeResult.error) {
+        options.stderr(systemctlFailureMessage("检查 awsb 服务状态", activeResult));
+        return { handled: true, exitCode: 1 };
+    }
+    if (activeResult.status === 0) {
+        const stopResult = runSystemctl(options.runCommand, [
+            "stop",
+            SYSTEMD_SERVICE_NAME,
+        ]);
+        if (!commandSucceeded(stopResult)) {
+            options.stderr(systemctlFailureMessage("停止 awsb 服务", stopResult));
+            return { handled: true, exitCode: stopResult.status ?? 1 };
+        }
+    }
+    const disableResult = runSystemctl(options.runCommand, [
+        "disable",
+        SYSTEMD_SERVICE_NAME,
+    ]);
+    if (disableResult.error || (disableResult.status !== 0 && unitExists)) {
+        options.stderr(systemctlFailureMessage("禁用 awsb 开机自启", disableResult));
+        return { handled: true, exitCode: disableResult.status ?? 1 };
+    }
+    if (unitExists) {
+        try {
+            unlinkSync(options.serviceUnitPath);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            options.stderr(`[runtime-bridge] 删除 systemd unit 失败: ${err.message}`);
+            return { handled: true, exitCode: 1 };
+        }
+    }
+    else {
+        options.stdout("[runtime-bridge] awsb systemd unit 不存在，跳过删除。");
+    }
+    const daemonReloadResult = runSystemctl(options.runCommand, ["daemon-reload"]);
+    if (!commandSucceeded(daemonReloadResult)) {
+        options.stderr(systemctlFailureMessage("重载 systemd", daemonReloadResult));
+        return { handled: true, exitCode: daemonReloadResult.status ?? 1 };
+    }
+    options.stdout("[runtime-bridge] awsb systemd 服务已卸载。");
+    return { handled: true, exitCode: 0 };
+}
+function handleServiceCommand(argv, options, stdout, stderr) {
+    const subcommand = argv[1];
+    if (!subcommand ||
+        subcommand === "-h" ||
+        subcommand === "--help" ||
+        subcommand === "help") {
+        printServiceUsage(stdout);
+        return { handled: true, exitCode: subcommand ? 0 : 1 };
+    }
+    const serviceOptions = {
+        stdout,
+        stderr,
+        runCommand: options.runCommand || defaultRunCommand,
+        platform: options.platform || process.platform,
+        serviceUnitPath: options.serviceUnitPath || DEFAULT_SYSTEMD_UNIT_PATH,
+        executablePath: options.executablePath || getDefaultExecutablePath(),
+    };
+    if (subcommand === "install") {
+        return installSystemdService(serviceOptions);
+    }
+    if (subcommand === "uninstall") {
+        return uninstallSystemdService(serviceOptions);
+    }
+    stderr(`[runtime-bridge] 未知 service 子命令: ${subcommand}`);
+    printServiceUsage(stdout);
+    return { handled: true, exitCode: 1 };
+}
 export async function handleCliCommand(options = {}) {
     const argv = options.argv || process.argv.slice(2);
     const command = argv[0];
-    const stdout = options.stdout || console.log;
-    const stderr = options.stderr || console.error;
+    const stdout = options.stdout || defaultStdout;
+    const stderr = options.stderr || defaultStderr;
     if (isVersionCommand(command)) {
         stdout(`aws-runtime-bridge ${readPackageVersion(options.packageRoot)}`);
         return { handled: true, exitCode: 0 };
@@ -34,7 +237,11 @@ export async function handleCliCommand(options = {}) {
     if (command === "update") {
         stdout("[runtime-bridge] 正在更新 aws-runtime-bridge 到最新版本...");
         const runCommand = options.runCommand || defaultRunCommand;
-        const result = runCommand("npm", ["install", "-g", "aws-runtime-bridge@latest"]);
+        const result = runCommand("npm", [
+            "install",
+            "-g",
+            "aws-runtime-bridge@latest",
+        ]);
         if (result.error) {
             stderr(`[runtime-bridge] 更新失败: ${result.error.message}`);
             return { handled: true, exitCode: 1 };
@@ -51,5 +258,8 @@ export async function handleCliCommand(options = {}) {
         const result = await configure();
         return { handled: true, exitCode: result === "configured" ? 0 : 1 };
     }
+    if (command === "service") {
+        return handleServiceCommand(argv, options, stdout, stderr);
+    }
     return { handled: false, exitCode: 0 };
 }

package/dist/services/cli-commands.test.js CHANGED Viewed

@@ -1,8 +1,8 @@
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { afterEach, describe, expect, it } from "vitest";
-import { handleCliCommand, readPackageVersion } from "./cli-commands.js";
+import { createSystemdUnitContent, handleCliCommand, readPackageVersion, } from "./cli-commands.js";
 const tempRoots = [];
 function createPackageRoot(version = "9.8.7") {
     const root = mkdtempSync(path.join(os.tmpdir(), "aws-bridge-cli-"));
@@ -11,6 +11,14 @@ function createPackageRoot(version = "9.8.7") {
     writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "aws-runtime-bridge", version }), "utf-8");
     return root;
 }
+function createServiceUnitPath() {
+    const root = mkdtempSync(path.join(os.tmpdir(), "aws-bridge-service-"));
+    tempRoots.push(root);
+    return path.join(root, "systemd", "awsb.service");
+}
+function quotedSystemdArg(value) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
 afterEach(() => {
     for (const root of tempRoots.splice(0)) {
         rmSync(root, { recursive: true, force: true });
@@ -85,6 +93,136 @@ describe("cli commands", () => {
         });
         expect(result).toEqual({ handled: true, exitCode: 1 });
     });
+    it("creates a systemd unit that starts the current executable with setup skipped", () => {
+        const executablePath = "/opt/aws-runtime-bridge/dist/index.js";
+        const unit = createSystemdUnitContent(executablePath);
+        expect(unit).toContain("Description=AgentsWorkStudio Runtime Bridge");
+        expect(unit).toContain("Environment=AWS_BRIDGE_SKIP_SETUP=true");
+        expect(unit).toContain(`ExecStart=${quotedSystemdArg(process.execPath)} ${quotedSystemdArg(executablePath)}`);
+        expect(unit).toContain("Restart=on-failure");
+        expect(unit).toContain("WantedBy=multi-user.target");
+    });
+    it("installs service, enables autostart, and starts when inactive", async () => {
+        const output = [];
+        const commands = [];
+        const serviceUnitPath = createServiceUnitPath();
+        const executablePath = "/usr/local/bin/awsb";
+        const result = await handleCliCommand({
+            argv: ["service", "install"],
+            platform: "linux",
+            serviceUnitPath,
+            executablePath,
+            stdout: (message) => output.push(message),
+            runCommand: (command, args) => {
+                commands.push({ command, args });
+                if (args[0] === "is-active") {
+                    return { status: 3 };
+                }
+                return { status: 0 };
+            },
+        });
+        expect(result).toEqual({ handled: true, exitCode: 0 });
+        expect(readFileSync(serviceUnitPath, "utf-8")).toContain(`ExecStart=${quotedSystemdArg(process.execPath)} ${quotedSystemdArg(executablePath)}`);
+        expect(commands).toEqual([
+            { command: "systemctl", args: ["daemon-reload"] },
+            { command: "systemctl", args: ["enable", "awsb.service"] },
+            { command: "systemctl", args: ["is-active", "--quiet", "awsb.service"] },
+            { command: "systemctl", args: ["start", "awsb.service"] },
+        ]);
+        expect(output.at(-1)).toBe("[runtime-bridge] awsb systemd 服务已安装、已启用开机自启并已启动。");
+    });
+    it("does not start service during install when it is already active", async () => {
+        const commands = [];
+        const serviceUnitPath = createServiceUnitPath();
+        const result = await handleCliCommand({
+            argv: ["service", "install"],
+            platform: "linux",
+            serviceUnitPath,
+            executablePath: "/usr/local/bin/awsb",
+            runCommand: (command, args) => {
+                commands.push({ command, args });
+                return { status: 0 };
+            },
+        });
+        expect(result).toEqual({ handled: true, exitCode: 0 });
+        expect(commands).toEqual([
+            { command: "systemctl", args: ["daemon-reload"] },
+            { command: "systemctl", args: ["enable", "awsb.service"] },
+            { command: "systemctl", args: ["is-active", "--quiet", "awsb.service"] },
+        ]);
+    });
+    it("uninstalls service by stopping, disabling, removing unit, and reloading systemd", async () => {
+        const output = [];
+        const commands = [];
+        const serviceUnitPath = createServiceUnitPath();
+        mkdirSync(path.dirname(serviceUnitPath), { recursive: true });
+        writeFileSync(serviceUnitPath, "unit", "utf-8");
+        const result = await handleCliCommand({
+            argv: ["service", "uninstall"],
+            platform: "linux",
+            serviceUnitPath,
+            stdout: (message) => output.push(message),
+            runCommand: (command, args) => {
+                commands.push({ command, args });
+                return { status: 0 };
+            },
+        });
+        expect(result).toEqual({ handled: true, exitCode: 0 });
+        expect(existsSync(serviceUnitPath)).toBe(false);
+        expect(commands).toEqual([
+            { command: "systemctl", args: ["is-active", "--quiet", "awsb.service"] },
+            { command: "systemctl", args: ["stop", "awsb.service"] },
+            { command: "systemctl", args: ["disable", "awsb.service"] },
+            { command: "systemctl", args: ["daemon-reload"] },
+        ]);
+        expect(output.at(-1)).toBe("[runtime-bridge] awsb systemd 服务已卸载。");
+    });
+    it("tolerates uninstall when service is inactive and unit is absent", async () => {
+        const output = [];
+        const commands = [];
+        const serviceUnitPath = createServiceUnitPath();
+        const result = await handleCliCommand({
+            argv: ["service", "uninstall"],
+            platform: "linux",
+            serviceUnitPath,
+            stdout: (message) => output.push(message),
+            runCommand: (command, args) => {
+                commands.push({ command, args });
+                if (args[0] === "is-active" || args[0] === "disable") {
+                    return { status: 1 };
+                }
+                return { status: 0 };
+            },
+        });
+        expect(result).toEqual({ handled: true, exitCode: 0 });
+        expect(commands).toEqual([
+            { command: "systemctl", args: ["is-active", "--quiet", "awsb.service"] },
+            { command: "systemctl", args: ["disable", "awsb.service"] },
+            { command: "systemctl", args: ["daemon-reload"] },
+        ]);
+        expect(output).toContain("[runtime-bridge] awsb systemd unit 不存在，跳过删除。");
+    });
+    it("fails service commands clearly on non-linux platforms", async () => {
+        const errors = [];
+        const result = await handleCliCommand({
+            argv: ["service", "install"],
+            platform: "win32",
+            stderr: (message) => errors.push(message),
+        });
+        expect(result).toEqual({ handled: true, exitCode: 1 });
+        expect(errors).toEqual([
+            "[runtime-bridge] service 命令仅支持 Linux systemd 环境。",
+        ]);
+    });
+    it("prints service help for missing subcommand", async () => {
+        const output = [];
+        const result = await handleCliCommand({
+            argv: ["service"],
+            stdout: (message) => output.push(message),
+        });
+        expect(result).toEqual({ handled: true, exitCode: 1 });
+        expect(output).toEqual(["Usage: awsb service <install|uninstall>"]);
+    });
     it("does not handle normal startup arguments", async () => {
         const result = await handleCliCommand({ argv: [] });
         expect(result).toEqual({ handled: false, exitCode: 0 });

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "aws-runtime-bridge",
-  "version": "1.3.2",
+  "version": "1.3.6",
   "description": "AgentsWorkStudio runtime bridge service for machine-level agent runtime integration",
   "type": "module",
   "main": "dist/index.js",
@@ -49,8 +49,6 @@
     "@anthropic-ai/claude-agent-sdk": "^0.2.87",
     "@cc-switch/sdk": "file:package/cc-switch-sdk",
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@openai/codex-sdk": "^0.125.0",
-    "@opencode-ai/sdk": "^1.3.13",
     "axios": "^1.7.9",
     "cors": "^2.8.5",
     "express": "^4.21.2",
@@ -60,8 +58,22 @@
     "ws": "^8.14.2",
     "yaml": "^2.3.4"
   },
+  "peerDependencies": {
+    "@openai/codex-sdk": "^0.125.0",
+    "@opencode-ai/sdk": "^1.3.13"
+  },
+  "peerDependenciesMeta": {
+    "@openai/codex-sdk": {
+      "optional": true
+    },
+    "@opencode-ai/sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@eslint/js": "^9.0.0",
+    "@openai/codex-sdk": "^0.125.0",
+    "@opencode-ai/sdk": "^1.3.13",
     "@types/cors": "^2.8.19",
     "@types/express": "^4.17.21",
     "@types/js-yaml": "^4.0.9",