agent-gear 2.4.0 → 2.5.0

package/dist/cloud-host/supervisor.test.js

@@ -0,0 +1,296 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { mkdtemp, mkdir, rm, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { CLOUD_HOST_MODE_KEYS, DEFAULT_HARNESS_INIT_WAIT_MS, DEFAULT_WORKSPACE, CloudHostEnvError, isCloudHostMode, parseInitWaitMs, readCloudHostEnv, resolveShutdownExitCode, startCloudHostSupervisor, } from './supervisor.js';
+const TMP_BASE = '/tmp/opencode';
+const BASE_ENV = {
+    ZAG_HOST_ENDPOINT: 'wss://controller.example.com',
+    ZAG_HOST_KEY: 'zag_k_1_host_key_secret',
+    ZAG_CONTROLLER_KEY: 'controller-token-secret',
+    ZAG_SERVER_ENDPOINT: 'wss://cloud-controller.example.com/worker',
+    ZAG_HOST_NAME: 'my-cloud-host',
+    ZAG_DEFAULT_WORKSPACE: '/root/workspace',
+};
+function fakeSocket() {
+    return { disconnect: vi.fn(), emit: vi.fn() };
+}
+function setup(overrides = {}) {
+    const worker = fakeSocket();
+    const controller = fakeSocket();
+    const connect = vi.fn((endpoint, key, options) => {
+        void endpoint;
+        void key;
+        void options;
+        return (connect.mock.calls.length === 1 ? worker : controller);
+    });
+    const exit = vi.fn();
+    const logs = [];
+    return {
+        worker,
+        controller,
+        connect,
+        exit,
+        logs,
+        deps: {
+            env: overrides.env ?? { ...BASE_ENV },
+            connect: connect,
+            makeDir: overrides.makeDir ?? (async () => { }),
+            exit,
+            log: (message) => logs.push(message),
+            installSignalHandlers: false,
+        },
+    };
+}
+describe('cloud host mode detection (T-AG2)', () => {
+    it('requires all three cloud-host env variables to be non-empty', () => {
+        expect(isCloudHostMode(BASE_ENV)).toBe(true);
+        for (const key of CLOUD_HOST_MODE_KEYS) {
+            expect(isCloudHostMode({ ...BASE_ENV, [key]: '' })).toBe(false);
+            expect(isCloudHostMode({ ...BASE_ENV, [key]: '   ' })).toBe(false);
+            expect(isCloudHostMode({ ...BASE_ENV, [key]: undefined })).toBe(false);
+        }
+        // 本地控制器单连接（无 ZAG_HOST_*）不进入云电脑模式
+        expect(isCloudHostMode({
+            ZAG_SERVER_ENDPOINT: 'http://localhost:4001',
+            ZAG_CONTROLLER_KEY: 'zag_k_1_local',
+        })).toBe(false);
+    });
+    it('parses HARNESS_INIT_WAIT_MS with the 10 minute default', () => {
+        expect(parseInitWaitMs(undefined)).toBe(DEFAULT_HARNESS_INIT_WAIT_MS);
+        expect(DEFAULT_HARNESS_INIT_WAIT_MS).toBe(600_000);
+        expect(parseInitWaitMs('1500')).toBe(1500);
+        expect(parseInitWaitMs('0')).toBe(DEFAULT_HARNESS_INIT_WAIT_MS);
+        expect(parseInitWaitMs('-1')).toBe(DEFAULT_HARNESS_INIT_WAIT_MS);
+        expect(parseInitWaitMs('abc')).toBe(DEFAULT_HARNESS_INIT_WAIT_MS);
+    });
+});
+describe('readCloudHostEnv (T-AG7)', () => {
+    it('reads required values and applies defaults', () => {
+        const env = readCloudHostEnv({
+            ZAG_HOST_ENDPOINT: ' wss://controller.example.com ',
+            ZAG_HOST_KEY: 'host-key',
+            ZAG_CONTROLLER_KEY: 'worker-token',
+            ZAG_SERVER_ENDPOINT: 'wss://cc.example.com/worker',
+        });
+        expect(env).toMatchObject({
+            hostEndpoint: 'wss://controller.example.com',
+            hostKey: 'host-key',
+            controllerKey: 'worker-token',
+            serverEndpoint: 'wss://cc.example.com/worker',
+            workspace: DEFAULT_WORKSPACE,
+            initWaitMs: DEFAULT_HARNESS_INIT_WAIT_MS,
+        });
+        expect(env.hostName.length).toBeGreaterThan(0);
+    });
+    it('lists every missing variable by name without leaking values of present ones', () => {
+        let error;
+        try {
+            readCloudHostEnv({
+                ZAG_HOST_ENDPOINT: 'wss://controller.example.com',
+                ZAG_HOST_KEY: 'super-secret-host-key',
+            });
+        }
+        catch (caught) {
+            error = caught;
+        }
+        expect(error).toBeInstanceOf(CloudHostEnvError);
+        const message = error.message;
+        expect(message).toContain('ZAG_CONTROLLER_KEY');
+        expect(message).toContain('ZAG_SERVER_ENDPOINT');
+        expect(message).not.toContain('super-secret-host-key');
+        expect(message).not.toContain('wss://controller.example.com');
+    });
+});
+describe('startCloudHostSupervisor', () => {
+    const dirs = [];
+    afterEach(async () => {
+        await Promise.all(dirs.splice(0).map((dir) => rm(dir, { recursive: true, force: true })));
+    });
+    it('T-AG6: creates the default workspace idempotently before connecting', async () => {
+        await mkdir(TMP_BASE, { recursive: true });
+        const dir = await mkdtemp(join(TMP_BASE, 'supervisor-'));
+        dirs.push(dir);
+        const workspace = join(dir, 'workspace', 'nested');
+        const context = setup({
+            env: { ...BASE_ENV, ZAG_DEFAULT_WORKSPACE: workspace },
+            makeDir: async (path) => {
+                await mkdir(path, { recursive: true });
+            },
+        });
+        const handle = await startCloudHostSupervisor(context.deps);
+        await startCloudHostSupervisor(context.deps);
+        expect((await stat(workspace)).isDirectory()).toBe(true);
+        expect(handle.workspace).toBe(workspace);
+        // makeDir 在连接之前完成（connect 的调用发生在其后）
+        expect(context.connect).toHaveBeenCalledTimes(2);
+    });
+    it('T-AG3: connects /worker first with the one-time token and no local MCP server', async () => {
+        const context = setup();
+        const handle = await startCloudHostSupervisor(context.deps);
+        expect(context.connect).toHaveBeenCalledTimes(1);
+        const [endpoint, key, options] = context.connect.mock.calls[0];
+        expect(endpoint).toBe(BASE_ENV.ZAG_SERVER_ENDPOINT);
+        expect(key).toBe(BASE_ENV.ZAG_CONTROLLER_KEY);
+        expect(options).toMatchObject({
+            serverName: 'my-cloud-host',
+            handshakeToken: BASE_ENV.ZAG_CONTROLLER_KEY,
+            skipLocalMcpStart: true,
+            handleWorkload: true,
+            persistConfig: false,
+        });
+        expect(handle.controllerSocket).toBeNull();
+    });
+    it('T-AG3b: connects controller-api immediately when initializing is false/absent', async () => {
+        const context = setup();
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: false });
+        expect(context.connect).toHaveBeenCalledTimes(2);
+        const [endpoint, key, options] = context.connect.mock.calls[1];
+        expect(endpoint).toBe(BASE_ENV.ZAG_HOST_ENDPOINT);
+        expect(key).toBe(BASE_ENV.ZAG_HOST_KEY);
+        expect(options).toMatchObject({
+            handshakeToken: BASE_ENV.ZAG_HOST_KEY,
+            skipLocalMcpStart: false,
+            handleWorkload: false,
+            persistConfig: false,
+        });
+        // 重复 registered（重连）不应重复建连
+        workerOptions.onRegistered?.({ controllerId: 'container-1' });
+        expect(context.connect).toHaveBeenCalledTimes(2);
+    });
+    it('T-AG4: waits for the first init workload batch when initializing=true', async () => {
+        const context = setup();
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: true });
+        expect(context.connect).toHaveBeenCalledTimes(1);
+        // post 批次不触发标准连接
+        workerOptions.onWorkloadBatchComplete?.({ phase: 'post', itemCount: 1, status: 'completed' });
+        expect(context.connect).toHaveBeenCalledTimes(1);
+        workerOptions.onWorkloadBatchComplete?.({ phase: 'init', itemCount: 2, status: 'completed' });
+        expect(context.connect).toHaveBeenCalledTimes(2);
+    });
+    it('T-AG4b: connects after a failed init batch too', async () => {
+        const context = setup();
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: true });
+        workerOptions.onWorkloadBatchComplete?.({ phase: 'init', itemCount: 1, status: 'failed', error: 'boom' });
+        expect(context.connect).toHaveBeenCalledTimes(2);
+    });
+    it('T-AG4e: does not treat an interrupted (cancelled) init batch as complete', async () => {
+        const context = setup();
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: true });
+        workerOptions.onWorkloadBatchComplete?.({
+            phase: 'init',
+            itemCount: 1,
+            status: 'cancelled',
+            cancelled: true,
+            failedCount: 0,
+        });
+        expect(context.connect).toHaveBeenCalledTimes(1);
+        // 重连重放后的真实 init 完成才建立标准连接
+        workerOptions.onWorkloadBatchComplete?.({
+            phase: 'init',
+            itemCount: 1,
+            status: 'completed',
+            cancelled: false,
+            failedCount: 0,
+        });
+        expect(context.connect).toHaveBeenCalledTimes(2);
+    });
+    it('T-AG4c: connects after the init wait timeout', async () => {
+        const context = setup({ env: { ...BASE_ENV, HARNESS_INIT_WAIT_MS: '20' } });
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: true });
+        expect(context.connect).toHaveBeenCalledTimes(1);
+        await vi.waitFor(() => {
+            expect(context.connect).toHaveBeenCalledTimes(2);
+        });
+        // 超时后迟到的 initializing registered 不得再次进入等待（不产生幽灵定时器/重复连接）
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: true });
+        expect(context.connect).toHaveBeenCalledTimes(2);
+        expect(context.logs.join('\n')).toContain('timed out');
+    });
+    it('T-AG4d: connects immediately when the init batch finished before registered', async () => {
+        const context = setup();
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onWorkloadBatchComplete?.({ phase: 'init', itemCount: 1, status: 'completed' });
+        expect(context.connect).toHaveBeenCalledTimes(1);
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: true });
+        expect(context.connect).toHaveBeenCalledTimes(2);
+    });
+    it('T-AG17: shutdown from either side closes both sockets and exits 0 without unregister', async () => {
+        const context = setup();
+        const handle = await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: false });
+        const controllerOptions = context.connect.mock.calls[1][2];
+        workerOptions.onShutdown?.({ reason: 'server requested shutdown' });
+        expect(context.worker.disconnect).toHaveBeenCalled();
+        expect(context.controller.disconnect).toHaveBeenCalled();
+        expect(context.exit).toHaveBeenCalledWith(0);
+        expect(context.worker.emit).not.toHaveBeenCalledWith('unregister', expect.anything());
+        expect(context.controller.emit).not.toHaveBeenCalledWith('unregister', expect.anything());
+        // 另一端 shutdown / 重复 shutdown 幂等
+        controllerOptions.onShutdown?.({ reason: 'duplicate' });
+        handle.shutdown('SIGTERM');
+        expect(context.exit).toHaveBeenCalledTimes(1);
+    });
+    it('T-AG17b: worker shutdown before the controller connection only closes the worker', async () => {
+        const context = setup();
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onShutdown?.({ reason: 'server requested shutdown' });
+        expect(context.worker.disconnect).toHaveBeenCalled();
+        expect(context.controller.disconnect).not.toHaveBeenCalled();
+        expect(context.exit).toHaveBeenCalledWith(0);
+    });
+    it('C-2: failure/version-mismatch shutdown exits non-zero (entrypoint self-heal path)', async () => {
+        // socketio-client 的错误事件 reason 前缀
+        expect(resolveShutdownExitCode('version_mismatch: agent-gear 版本不兼容')).toBe(1);
+        expect(resolveShutdownExitCode('error: REGISTER_FAILED')).toBe(1);
+        // 必须工作负载初始化失败（worker shutdown 包装后仍须识别）
+        expect(resolveShutdownExitCode('worker shutdown: 必须工作负载「OpenCode（Harness）」初始化失败')).toBe(1);
+        expect(resolveShutdownExitCode('required init failed')).toBe(1);
+        // 正常路径
+        expect(resolveShutdownExitCode('controller-api shutdown: server requested')).toBe(0);
+        expect(resolveShutdownExitCode('SIGINT')).toBe(0);
+        expect(resolveShutdownExitCode('unregistered')).toBe(0);
+    });
+    it('C-2: required init failure closes both sockets and exits 1', async () => {
+        const context = setup();
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onRegistered?.({ controllerId: 'container-1', initializing: false });
+        workerOptions.onShutdown?.({ reason: 'worker shutdown: 必须工作负载初始化失败' });
+        expect(context.worker.disconnect).toHaveBeenCalled();
+        expect(context.controller.disconnect).toHaveBeenCalled();
+        expect(context.exit).toHaveBeenCalledWith(1);
+        expect(context.worker.emit).not.toHaveBeenCalledWith('unregister', expect.anything());
+        // 显式 code 优先（调用方可覆盖）
+        const explicit = setup();
+        const explicitHandle = await startCloudHostSupervisor(explicit.deps);
+        explicitHandle.shutdown('server requested shutdown', 1);
+        expect(explicit.exit).toHaveBeenCalledWith(1);
+    });
+    it('C-2: version_mismatch reason exits 1', async () => {
+        const context = setup();
+        await startCloudHostSupervisor(context.deps);
+        const workerOptions = context.connect.mock.calls[0][2];
+        workerOptions.onShutdown?.({ reason: 'version_mismatch: agent-gear 版本不兼容' });
+        expect(context.exit).toHaveBeenCalledWith(1);
+    });
+    it('T-AG7b: rejects with a clear error instead of connecting when cloud-host env is incomplete', async () => {
+        const context = setup({ env: { ...BASE_ENV, ZAG_HOST_KEY: '' } });
+        await expect(startCloudHostSupervisor(context.deps)).rejects.toBeInstanceOf(CloudHostEnvError);
+        expect(context.connect).not.toHaveBeenCalled();
+        expect(context.exit).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=supervisor.test.js.map

package/dist/cloud-host/supervisor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.test.js","sourceRoot":"","sources":["../../src/cloud-host/supervisor.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/harness.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from 'commander';
+import { prepareHarness, type PrepareHarnessOptions } from '../harness/prepare.js';
+export interface RegisterHarnessCommandsDeps {
+    prepare?: (options?: PrepareHarnessOptions) => Promise<Awaited<ReturnType<typeof prepareHarness>>>;
+}
+/**
+ * 注册 `agent-gear harness` 命令组。
+ *
+ * ```
+ * agent-gear harness prepare   # 校验 env → opencode --version → 写 opencode.jsonc
+ * ```
+ *
+ * 失败以退出码 1 结束（供 harness 工作负载 `required=true` 触发容器强制注销）；
+ * 输出/错误均对 `ZAG_MODEL_API_KEY` 等 secret 脱敏。
+ */
+export declare function registerHarnessCommands(program: Command, deps?: RegisterHarnessCommandsDeps): Command;
+//# sourceMappingURL=harness.d.ts.map

package/dist/commands/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/commands/harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAwB,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEzG,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;CACpG;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,2BAAgC,GACrC,OAAO,CAsBT"}

package/dist/commands/harness.js

@@ -0,0 +1,35 @@
+import { collectSecretValues, redactSecrets } from '../workload-executor.js';
+import { formatPrepareSummary, prepareHarness } from '../harness/prepare.js';
+/**
+ * 注册 `agent-gear harness` 命令组。
+ *
+ * ```
+ * agent-gear harness prepare   # 校验 env → opencode --version → 写 opencode.jsonc
+ * ```
+ *
+ * 失败以退出码 1 结束（供 harness 工作负载 `required=true` 触发容器强制注销）；
+ * 输出/错误均对 `ZAG_MODEL_API_KEY` 等 secret 脱敏。
+ */
+export function registerHarnessCommands(program, deps = {}) {
+    const harness = program
+        .command('harness')
+        .description('Prepare harness runtime (OpenCode) for cloud-host containers');
+    harness
+        .command('prepare')
+        .description('Validate harness env, verify OpenCode CLI and write provider.zag into opencode.jsonc')
+        .action(async () => {
+        try {
+            const result = await (deps.prepare ?? prepareHarness)();
+            console.log(formatPrepareSummary(result));
+        }
+        catch (error) {
+            const secrets = collectSecretValues(process.env);
+            const message = redactSecrets(error.message, secrets);
+            console.error(`harness prepare failed: ${message}`);
+            // 非零退出：不直接 process.exit，便于测试断言 exitCode 与已刷新的日志。
+            process.exitCode = 1;
+        }
+    });
+    return harness;
+}
+//# sourceMappingURL=harness.js.map

package/dist/commands/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../src/commands/harness.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAA8B,MAAM,uBAAuB,CAAC;AAMzG;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,OAAoC,EAAE;IAEtC,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,8DAA8D,CAAC,CAAC;IAE/E,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,sFAAsF,CAAC;SACnG,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,aAAa,CAAE,KAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;YACpD,iDAAiD;YACjD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC;AAED,wBAAgB,UAAU,IAAI,UAAU,CAMvC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAKlD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAGrD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAG1D;AAED,wBAAgB,2BAA2B,IAAI,MAAM,GAAG,SAAS,CAGhE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK9D;AAED,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKxE;AAED,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,SAAS,CAG7D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC;AAED,wBAAgB,UAAU,IAAI,UAAU,CAMvC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAWlD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAGrD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAG1D;AAED,wBAAgB,2BAA2B,IAAI,MAAM,GAAG,SAAS,CAGhE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK9D;AAED,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKxE;AAED,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,SAAS,CAG7D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}

package/dist/config.js

@@ -1,4 +1,4 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 import { parse, stringify } from 'smol-toml';
@@ -13,9 +13,16 @@ export function readConfig() {
 }
 export function writeConfig(data) {
     if (!existsSync(CONFIG_DIR)) {
-        mkdirSync(CONFIG_DIR, { recursive: true });
+        mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+    // 配置含 Key/resumeToken：仅属主可读写（避免 world-readable 凭据落盘）。
+    writeFileSync(CONFIG_FILE, stringify(data), { encoding: 'utf-8', mode: 0o600 });
+    try {
+        chmodSync(CONFIG_FILE, 0o600);
+    }
+    catch {
+        // 某些平台/文件系统不支持 chmod：不阻断配置写入（已在 Windows 等平台降级）
     }
-    writeFileSync(CONFIG_FILE, stringify(data), 'utf-8');
 }
 export function clearConfigKey() {
     const config = readConfig();

package/dist/config.js.map

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

package/dist/harness/env.d.ts

@@ -0,0 +1,36 @@
+/**
+ * harness（OpenCode 云电脑）初始化环境校验。
+ *
+ * 只读取 `harness prepare` 需要的变量；缺失/非法时一次性列出**变量名**，
+ * 绝不回显其它 env 的值（尤其 `ZAG_MODEL_API_KEY` 等 secret）。
+ */
+/** harness prepare 需要的环境（已归一）。 */
+export interface HarnessEnv {
+    /** 模型网关地址（`ZAG_MODEL_BASE_URL`）。 */
+    modelBaseUrl: string;
+    /** 运行专用模型 Key（`ZAG_MODEL_API_KEY`，禁止打印）。 */
+    modelApiKey: string;
+    /** 可用模型 ID 列表（`ZAG_MODEL_IDS`，JSON 数组字符串，去空去重）。 */
+    modelIds: string[];
+    /** 默认工作区（`ZAG_DEFAULT_WORKSPACE`）。 */
+    defaultWorkspace: string;
+}
+/** env 校验失败（消息不含任何变量值）。 */
+export declare class HarnessEnvError extends Error {
+    constructor(message: string);
+}
+/**
+ * 解析 `ZAG_MODEL_IDS`：必须是字符串 JSON 数组；元素 trim 后去空、去重（保持原顺序）。
+ *
+ * - `[]` 合法（T-AG11：空数组仍写 `models:{}`）；
+ * - 非数组/非法 JSON/含非字符串元素 → 明确报错（不输出原始值）。
+ */
+export declare function parseModelIds(raw: string): string[];
+/**
+ * 读取并校验 harness env。
+ *
+ * 必需：`ZAG_MODEL_BASE_URL` / `ZAG_MODEL_API_KEY` / `ZAG_MODEL_IDS` / `ZAG_DEFAULT_WORKSPACE`
+ * （云电脑 Job env 与 `workload:run.env` 均由 agent-api 注入，缺失说明编排不正确）。
+ */
+export declare function readHarnessEnv(env?: NodeJS.ProcessEnv): HarnessEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/harness/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/harness/env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,2BAA2B;AAC3B,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,UAAU,CAqB/E"}

package/dist/harness/env.js

@@ -0,0 +1,78 @@
+/**
+ * harness（OpenCode 云电脑）初始化环境校验。
+ *
+ * 只读取 `harness prepare` 需要的变量；缺失/非法时一次性列出**变量名**，
+ * 绝不回显其它 env 的值（尤其 `ZAG_MODEL_API_KEY` 等 secret）。
+ */
+/** env 校验失败（消息不含任何变量值）。 */
+export class HarnessEnvError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HarnessEnvError';
+    }
+}
+function nonEmpty(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/**
+ * 解析 `ZAG_MODEL_IDS`：必须是字符串 JSON 数组；元素 trim 后去空、去重（保持原顺序）。
+ *
+ * - `[]` 合法（T-AG11：空数组仍写 `models:{}`）；
+ * - 非数组/非法 JSON/含非字符串元素 → 明确报错（不输出原始值）。
+ */
+export function parseModelIds(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new HarnessEnvError('ZAG_MODEL_IDS must be a JSON array of strings (invalid JSON)');
+    }
+    if (!Array.isArray(parsed)) {
+        throw new HarnessEnvError('ZAG_MODEL_IDS must be a JSON array of strings');
+    }
+    if (!parsed.every((item) => typeof item === 'string')) {
+        throw new HarnessEnvError('ZAG_MODEL_IDS must be a JSON array of strings (non-string element)');
+    }
+    const unique = [];
+    const seen = new Set();
+    for (const item of parsed) {
+        const value = item.trim();
+        if (!value || seen.has(value))
+            continue;
+        seen.add(value);
+        unique.push(value);
+    }
+    return unique;
+}
+/**
+ * 读取并校验 harness env。
+ *
+ * 必需：`ZAG_MODEL_BASE_URL` / `ZAG_MODEL_API_KEY` / `ZAG_MODEL_IDS` / `ZAG_DEFAULT_WORKSPACE`
+ * （云电脑 Job env 与 `workload:run.env` 均由 agent-api 注入，缺失说明编排不正确）。
+ */
+export function readHarnessEnv(env = process.env) {
+    const missing = [];
+    const modelBaseUrl = nonEmpty(env.ZAG_MODEL_BASE_URL);
+    if (!modelBaseUrl)
+        missing.push('ZAG_MODEL_BASE_URL');
+    const modelApiKey = nonEmpty(env.ZAG_MODEL_API_KEY);
+    if (!modelApiKey)
+        missing.push('ZAG_MODEL_API_KEY');
+    const rawModelIds = nonEmpty(env.ZAG_MODEL_IDS);
+    if (!rawModelIds)
+        missing.push('ZAG_MODEL_IDS');
+    const defaultWorkspace = nonEmpty(env.ZAG_DEFAULT_WORKSPACE);
+    if (!defaultWorkspace)
+        missing.push('ZAG_DEFAULT_WORKSPACE');
+    if (missing.length > 0) {
+        throw new HarnessEnvError(`missing required environment variable(s): ${missing.join(', ')}`);
+    }
+    return {
+        modelBaseUrl,
+        modelApiKey,
+        modelIds: parseModelIds(rawModelIds),
+        defaultWorkspace,
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/harness/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/harness/env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,2BAA2B;AAC3B,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,eAAe,CAAC,8DAA8D,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,eAAe,CAAC,+CAA+C,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,eAAe,CAAC,oEAAoE,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAkB,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACxC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACtD,IAAI,CAAC,YAAY;QAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW;QAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAChD,IAAI,CAAC,WAAW;QAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC7D,IAAI,CAAC,gBAAgB;QAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAE7D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,eAAe,CAAC,6CAA6C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO;QACL,YAAY;QACZ,WAAW;QACX,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC;QACpC,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/harness/env.test.d.ts

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

package/dist/harness/env.test.d.ts.map

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

package/dist/harness/env.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect } from 'vitest';
+import { HarnessEnvError, parseModelIds, readHarnessEnv } from './env.js';
+const VALID_ENV = {
+    ZAG_MODEL_BASE_URL: 'http://admin-api:8002/v1',
+    ZAG_MODEL_API_KEY: 'zag_sk_super_secret',
+    ZAG_MODEL_IDS: '["model-a","model-b"]',
+    ZAG_DEFAULT_WORKSPACE: '/root/workspace',
+};
+describe('readHarnessEnv (T-AG7/T-AG11)', () => {
+    it('reads a valid harness env', () => {
+        expect(readHarnessEnv(VALID_ENV)).toEqual({
+            modelBaseUrl: 'http://admin-api:8002/v1',
+            modelApiKey: 'zag_sk_super_secret',
+            modelIds: ['model-a', 'model-b'],
+            defaultWorkspace: '/root/workspace',
+        });
+    });
+    it('lists all missing variables by name and never leaks secret values', () => {
+        let error;
+        try {
+            readHarnessEnv({ ZAG_MODEL_API_KEY: 'zag_sk_super_secret' });
+        }
+        catch (caught) {
+            error = caught;
+        }
+        expect(error).toBeInstanceOf(HarnessEnvError);
+        const message = error.message;
+        expect(message).toContain('ZAG_MODEL_BASE_URL');
+        expect(message).toContain('ZAG_MODEL_IDS');
+        expect(message).toContain('ZAG_DEFAULT_WORKSPACE');
+        expect(message).not.toContain('ZAG_MODEL_API_KEY');
+        expect(message).not.toContain('zag_sk_super_secret');
+    });
+    it('trims values', () => {
+        const env = readHarnessEnv({
+            ...VALID_ENV,
+            ZAG_MODEL_BASE_URL: '  http://admin-api:8002/v1  ',
+        });
+        expect(env.modelBaseUrl).toBe('http://admin-api:8002/v1');
+    });
+    it('rejects a missing default workspace', () => {
+        expect(() => readHarnessEnv({ ...VALID_ENV, ZAG_DEFAULT_WORKSPACE: '' })).toThrowError(/ZAG_DEFAULT_WORKSPACE/);
+    });
+});
+describe('parseModelIds (T-AG11)', () => {
+    it('dedupes and drops empty/whitespace entries while preserving order', () => {
+        expect(parseModelIds('["b"," a ","b","","   ","c","a"]')).toEqual(['b', 'a', 'c']);
+    });
+    it('accepts an empty array', () => {
+        expect(parseModelIds('[]')).toEqual([]);
+    });
+    it('rejects invalid JSON without echoing the raw value', () => {
+        let error;
+        try {
+            parseModelIds('not-json');
+        }
+        catch (caught) {
+            error = caught;
+        }
+        expect(error).toBeInstanceOf(HarnessEnvError);
+        expect(error.message).toContain('ZAG_MODEL_IDS');
+        expect(error.message).not.toContain('not-json');
+    });
+    it('rejects non-array and non-string elements', () => {
+        expect(() => parseModelIds('{"a":1}')).toThrowError(/JSON array of strings/);
+        expect(() => parseModelIds('["a",1]')).toThrowError(/non-string element/);
+        expect(() => parseModelIds('null')).toThrowError(/JSON array of strings/);
+    });
+});
+//# sourceMappingURL=env.test.js.map