agent-gear 2.4.0 → 2.5.0

package/dist/harness/env.test.js.map

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

package/dist/harness/opencode-cli.d.ts

@@ -0,0 +1,24 @@
+/** 一次外部命令执行结果（stdout/stderr 均为完整文本）。 */
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+}
+/** 可注入的命令执行器（测试使用；生产走 `execFile`）。 */
+export type CommandRunner = (command: string, args: string[]) => Promise<CommandResult>;
+/** `opencode --version` 硬校验失败。 */
+export declare class OpencodeCliError extends Error {
+    constructor(message: string);
+}
+/** 从版本输出中取第一行非空文本（去掉前后空白与可能的 `v` 前缀）。 */
+export declare function extractVersion(stdout: string, stderr?: string): string | undefined;
+/**
+ * `opencode --version` 硬校验（`opencode -v` 仅作旧版 CLI 的兼容探测）。
+ *
+ * `expectedVersion` 非空时要求实际版本严格一致（去掉 `v` 前缀后比较），不一致立即失败，
+ * 用于 init 脚本已固定安装版本的二次校验（C-5）。
+ *
+ * 失败时抛 {@link OpencodeCliError}，消息包含「版本校验」提示与命令级错误摘要
+ * （不包含任何 env/secret）。调用方（init 脚本 / `harness prepare`）必须以非零退出。
+ */
+export declare function verifyOpencodeCli(runner?: CommandRunner, expectedVersion?: string): Promise<string>;
+//# sourceMappingURL=opencode-cli.d.ts.map

package/dist/harness/opencode-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-cli.d.ts","sourceRoot":"","sources":["../../src/harness/opencode-cli.ts"],"names":[],"mappings":"AAEA,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAExF,kCAAkC;AAClC,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAoBD,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,GAAG,SAAS,CAO9E;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,GAAE,aAA6B,EACrC,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAuCjB"}

package/dist/harness/opencode-cli.js

@@ -0,0 +1,74 @@
+import { execFile } from 'node:child_process';
+/** `opencode --version` 硬校验失败。 */
+export class OpencodeCliError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OpencodeCliError';
+    }
+}
+const DEFAULT_TIMEOUT_MS = 15_000;
+const defaultRunner = (command, args) => new Promise((resolve, reject) => {
+    execFile(command, args, { timeout: DEFAULT_TIMEOUT_MS, maxBuffer: 1024 * 1024, encoding: 'utf8' }, (error, stdout, stderr) => {
+        if (error) {
+            reject(error);
+            return;
+        }
+        resolve({ stdout: stdout ?? '', stderr: stderr ?? '' });
+    });
+});
+/** 从版本输出中取第一行非空文本（去掉前后空白与可能的 `v` 前缀）。 */
+export function extractVersion(stdout, stderr = '') {
+    const line = `${stdout}\n${stderr}`
+        .split(/\r?\n/)
+        .map((value) => value.trim())
+        .find((value) => value.length > 0);
+    if (!line)
+        return undefined;
+    return line.replace(/^v/i, '');
+}
+/**
+ * `opencode --version` 硬校验（`opencode -v` 仅作旧版 CLI 的兼容探测）。
+ *
+ * `expectedVersion` 非空时要求实际版本严格一致（去掉 `v` 前缀后比较），不一致立即失败，
+ * 用于 init 脚本已固定安装版本的二次校验（C-5）。
+ *
+ * 失败时抛 {@link OpencodeCliError}，消息包含「版本校验」提示与命令级错误摘要
+ * （不包含任何 env/secret）。调用方（init 脚本 / `harness prepare`）必须以非零退出。
+ */
+export async function verifyOpencodeCli(runner = defaultRunner, expectedVersion) {
+    const failures = [];
+    const normalizeVersion = (version) => (version.trim().split(/\s+/).pop() ?? '').replace(/^v/i, '');
+    const ensureExpected = (version) => {
+        if (expectedVersion && normalizeVersion(version) !== normalizeVersion(expectedVersion)) {
+            throw new OpencodeCliError(`OpenCode CLI version mismatch: expected ${expectedVersion}, got ${version}`);
+        }
+        return version;
+    };
+    try {
+        const result = await runner('opencode', ['--version']);
+        const version = extractVersion(result.stdout, result.stderr);
+        if (version)
+            return ensureExpected(version);
+        failures.push('`opencode --version` returned no version output');
+    }
+    catch (error) {
+        if (error instanceof OpencodeCliError)
+            throw error;
+        failures.push(`\`opencode --version\` failed: ${error.message}`);
+    }
+    // 兼容旧版 CLI：仅当 `--version` 不可用时探测 `-v`。
+    try {
+        const result = await runner('opencode', ['-v']);
+        const version = extractVersion(result.stdout, result.stderr);
+        if (version)
+            return ensureExpected(version);
+        failures.push('`opencode -v` returned no version output');
+    }
+    catch (error) {
+        if (error instanceof OpencodeCliError)
+            throw error;
+        failures.push(`\`opencode -v\` failed: ${error.message}`);
+    }
+    throw new OpencodeCliError(`OpenCode CLI version check failed; OpenCode is required by the harness workload (${failures.join('; ')})`);
+}
+//# sourceMappingURL=opencode-cli.js.map

package/dist/harness/opencode-cli.js.map

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

package/dist/harness/opencode-cli.test.d.ts

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

package/dist/harness/opencode-cli.test.d.ts.map

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

package/dist/harness/opencode-cli.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect, vi } from 'vitest';
+import { OpencodeCliError, extractVersion, verifyOpencodeCli, } from './opencode-cli.js';
+describe('verifyOpencodeCli (T-AG8)', () => {
+    it('runs `opencode --version` and returns the version', async () => {
+        const runner = vi.fn(async () => ({ stdout: '1.2.3\n', stderr: '' }));
+        await expect(verifyOpencodeCli(runner)).resolves.toBe('1.2.3');
+        expect(runner).toHaveBeenCalledWith('opencode', ['--version']);
+        expect(runner).toHaveBeenCalledTimes(1);
+    });
+    it('falls back to `opencode -v` for legacy CLIs', async () => {
+        const runner = vi.fn(async (_command, args) => {
+            if (args[0] === '--version')
+                throw new Error('unknown option');
+            return { stdout: 'v0.9.1\n', stderr: '' };
+        });
+        await expect(verifyOpencodeCli(runner)).resolves.toBe('0.9.1');
+        expect(runner).toHaveBeenNthCalledWith(1, 'opencode', ['--version']);
+        expect(runner).toHaveBeenNthCalledWith(2, 'opencode', ['-v']);
+    });
+    it('falls back to `-v` when `--version` prints no version', async () => {
+        const runner = vi.fn(async (_command, args) => args[0] === '--version'
+            ? { stdout: '   \n', stderr: '' }
+            : { stdout: '2.0.0\n', stderr: '' });
+        await expect(verifyOpencodeCli(runner)).resolves.toBe('2.0.0');
+    });
+    it('throws a version-check error when both commands fail', async () => {
+        const runner = vi.fn(async () => {
+            throw new Error('spawn opencode ENOENT');
+        });
+        let error;
+        try {
+            await verifyOpencodeCli(runner);
+        }
+        catch (caught) {
+            error = caught;
+        }
+        expect(error).toBeInstanceOf(OpencodeCliError);
+        const message = error.message;
+        expect(message).toContain('version check failed');
+        expect(message).toContain('opencode --version');
+        expect(message).toContain('opencode -v');
+        expect(message).toContain('ENOENT');
+    });
+    it('C-5: validates the expected pinned version (tolerates v prefix and command output prefix)', async () => {
+        const runner = vi.fn(async () => ({ stdout: 'v2.1.1\n', stderr: '' }));
+        await expect(verifyOpencodeCli(runner, '2.1.1')).resolves.toBe('2.1.1');
+        const prefixed = vi.fn(async () => ({ stdout: 'opencode 2.1.1\n', stderr: '' }));
+        await expect(verifyOpencodeCli(prefixed, '2.1.1')).resolves.toBe('opencode 2.1.1');
+    });
+    it('C-5: throws immediately on a pinned version mismatch', async () => {
+        const runner = vi.fn(async () => ({ stdout: '2.0.0\n', stderr: '' }));
+        await expect(verifyOpencodeCli(runner, '2.1.1')).rejects.toThrow(/version mismatch: expected 2\.1\.1, got 2\.0\.0/);
+        // 不匹配即失败，不再退回 `-v`
+        expect(runner).toHaveBeenCalledTimes(1);
+    });
+    it('reads the version from stderr when stdout is empty', () => {
+        expect(extractVersion('', 'opencode 1.0.0\n')).toBe('opencode 1.0.0');
+        expect(extractVersion('\n\n3.2.1\n')).toBe('3.2.1');
+        expect(extractVersion('   ')).toBeUndefined();
+    });
+});
+//# sourceMappingURL=opencode-cli.test.js.map

package/dist/harness/opencode-cli.test.js.map

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

package/dist/harness/opencode-config.atomic-failure.test.d.ts

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

package/dist/harness/opencode-config.atomic-failure.test.d.ts.map

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

package/dist/harness/opencode-config.atomic-failure.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+const fs = vi.hoisted(() => ({
+    chmod: vi.fn(),
+    mkdir: vi.fn(),
+    readFile: vi.fn(),
+    rename: vi.fn(),
+    rm: vi.fn(),
+    stat: vi.fn(),
+    writeFile: vi.fn(),
+}));
+vi.mock('node:fs/promises', () => fs);
+import { OpencodeConfigError, writeOpencodeConfig } from './opencode-config.js';
+const ENV = {
+    modelBaseUrl: 'http://admin-api:8002/v1',
+    modelApiKey: 'zag_sk_super_secret',
+    modelIds: ['model-a'],
+};
+describe('R2-16 opencode config atomic write failure cleanup', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        fs.mkdir.mockResolvedValue(undefined);
+        fs.chmod.mockResolvedValue(undefined);
+        fs.writeFile.mockResolvedValue(undefined);
+        fs.rm.mockResolvedValue(undefined);
+        // 目标文件不存在 → 走新建分支
+        fs.stat.mockRejectedValue(new Error('ENOENT'));
+    });
+    it('removes the temp file when rename fails and preserves the original error surface', async () => {
+        fs.rename.mockRejectedValue(new Error('rename failed'));
+        await expect(writeOpencodeConfig({ env: ENV, configDir: '/tmp/opencode-r2-16' })).rejects.toBeInstanceOf(OpencodeConfigError);
+        expect(fs.writeFile).toHaveBeenCalledWith(expect.stringMatching(/\/tmp\/opencode-r2-16\/\.opencode-config\..*\.tmp$/), expect.any(String), { encoding: 'utf-8', mode: 0o600 });
+        expect(fs.rm).toHaveBeenCalledWith(expect.stringMatching(/\/tmp\/opencode-r2-16\/\.opencode-config\..*\.tmp$/), { force: true });
+    });
+});
+//# sourceMappingURL=opencode-config.atomic-failure.test.js.map

package/dist/harness/opencode-config.atomic-failure.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-config.atomic-failure.test.js","sourceRoot":"","sources":["../../src/harness/opencode-config.atomic-failure.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3B,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;IACd,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;IACd,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;IACjB,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;IACf,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;IACX,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;IACb,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;CACnB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,GAAG,GAAG;IACV,YAAY,EAAE,0BAA0B;IACxC,WAAW,EAAE,qBAAqB;IAClC,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC;AAEF,QAAQ,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAClE,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACtC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACtC,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC1C,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACnC,kBAAkB;QAClB,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;QAChG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QAExD,MAAM,MAAM,CACV,mBAAmB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC,CACpE,CAAC,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;QAE9C,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACvC,MAAM,CAAC,cAAc,CAAC,oDAAoD,CAAC,EAC3E,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAClB,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CACnC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAChC,MAAM,CAAC,cAAc,CAAC,oDAAoD,CAAC,EAC3E,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/harness/opencode-config.d.ts

@@ -0,0 +1,54 @@
+import type { HarnessEnv } from './env.js';
+/** OpenCode 配置中 `provider.zag` 的结构（OpenAI-compatible 自定义 provider）。 */
+export interface ZagProviderConfig {
+    npm: string;
+    name: string;
+    options: {
+        baseURL: string;
+        apiKey: string;
+    };
+    models: Record<string, {
+        name: string;
+    }>;
+}
+/** 写入 OpenCode 配置失败（消息只含路径/变量名，不含 key 等 secret）。 */
+export declare class OpencodeConfigError extends Error {
+    constructor(message: string);
+}
+/** `provider.zag` 固定使用 OpenAI compatible provider 包。 */
+export declare const ZAG_PROVIDER_NPM = "@ai-sdk/openai-compatible";
+/** 由 harness env 构造 `provider.zag`（模型列表为空时 `models: {}`）。 */
+export declare function buildZagProvider(env: Pick<HarnessEnv, 'modelBaseUrl' | 'modelApiKey' | 'modelIds'>): ZagProviderConfig;
+/** 默认配置目录：`~/.config/opencode`。 */
+export declare function defaultConfigDir(): string;
+/**
+ * 选择配置目标文件（A13）：
+ *
+ * 1. 同目录存在 `opencode.jsonc` → 用它；
+ * 2. 否则同目录只存在 `opencode.json` → 合并该文件（不另建 `.jsonc`）；
+ * 3. 都不存在 → 新建 `opencode.jsonc`。
+ */
+export declare function resolveOpencodeConfigPath(configDir?: string): Promise<string>;
+export interface WriteOpencodeConfigOptions {
+    env: Pick<HarnessEnv, 'modelBaseUrl' | 'modelApiKey' | 'modelIds'>;
+    /** 覆盖配置目录（测试/定制场景；缺省 `~/.config/opencode`）。 */
+    configDir?: string;
+}
+export interface WriteOpencodeConfigResult {
+    /** 实际写入的配置文件路径。 */
+    path: string;
+    /** 是否为新建文件。 */
+    created: boolean;
+    /** 写入的模型数量。 */
+    modelCount: number;
+}
+/**
+ * 写入/合并 OpenCode 配置：
+ *
+ * - 用 `jsonc-parser` 的 `modify` 仅替换 `provider.zag`，保留注释与既有 provider；
+ * - 文件权限固定 `0600`（含已存在文件），目录权限收紧为 `0700`（含已存在目录）；
+ * - 同目录临时文件 + `rename` 原子替换（避免半写文件，C-7）；
+ * - 非法 JSONC 直接报错（不覆盖用户配置，避免静默丢数据）。
+ */
+export declare function writeOpencodeConfig(options: WriteOpencodeConfigOptions): Promise<WriteOpencodeConfigResult>;
+//# sourceMappingURL=opencode-config.d.ts.map

package/dist/harness/opencode-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-config.d.ts","sourceRoot":"","sources":["../../src/harness/opencode-config.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1C;AAED,oDAAoD;AACpD,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAE5D,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,aAAa,GAAG,UAAU,CAAC,GACjE,iBAAiB,CAenB;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAWD;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,SAAS,SAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/F;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC;IACnE,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAiEpC"}

package/dist/harness/opencode-config.js

@@ -0,0 +1,130 @@
+import { randomUUID } from 'node:crypto';
+import { chmod, mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { applyEdits, modify, parse, printParseErrorCode, } from 'jsonc-parser';
+/** 写入 OpenCode 配置失败（消息只含路径/变量名，不含 key 等 secret）。 */
+export class OpencodeConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OpencodeConfigError';
+    }
+}
+/** `provider.zag` 固定使用 OpenAI compatible provider 包。 */
+export const ZAG_PROVIDER_NPM = '@ai-sdk/openai-compatible';
+/** 由 harness env 构造 `provider.zag`（模型列表为空时 `models: {}`）。 */
+export function buildZagProvider(env) {
+    const models = {};
+    for (const id of env.modelIds) {
+        if (!id)
+            continue;
+        models[id] = { name: id };
+    }
+    return {
+        npm: ZAG_PROVIDER_NPM,
+        name: 'ZAG',
+        options: {
+            baseURL: env.modelBaseUrl,
+            apiKey: env.modelApiKey,
+        },
+        models,
+    };
+}
+/** 默认配置目录：`~/.config/opencode`。 */
+export function defaultConfigDir() {
+    return join(homedir(), '.config', 'opencode');
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 选择配置目标文件（A13）：
+ *
+ * 1. 同目录存在 `opencode.jsonc` → 用它；
+ * 2. 否则同目录只存在 `opencode.json` → 合并该文件（不另建 `.jsonc`）；
+ * 3. 都不存在 → 新建 `opencode.jsonc`。
+ */
+export async function resolveOpencodeConfigPath(configDir = defaultConfigDir()) {
+    const jsoncPath = join(configDir, 'opencode.jsonc');
+    if (await exists(jsoncPath))
+        return jsoncPath;
+    const jsonPath = join(configDir, 'opencode.json');
+    if (await exists(jsonPath))
+        return jsonPath;
+    return jsoncPath;
+}
+/**
+ * 写入/合并 OpenCode 配置：
+ *
+ * - 用 `jsonc-parser` 的 `modify` 仅替换 `provider.zag`，保留注释与既有 provider；
+ * - 文件权限固定 `0600`（含已存在文件），目录权限收紧为 `0700`（含已存在目录）；
+ * - 同目录临时文件 + `rename` 原子替换（避免半写文件，C-7）；
+ * - 非法 JSONC 直接报错（不覆盖用户配置，避免静默丢数据）。
+ */
+export async function writeOpencodeConfig(options) {
+    const dir = options.configDir ?? defaultConfigDir();
+    await mkdir(dir, { recursive: true, mode: 0o700 });
+    // `mkdir` 的 mode 只对新建目录生效：已存在目录显式收紧到 0700（可能含模型 Key）。
+    try {
+        await chmod(dir, 0o700);
+    }
+    catch (error) {
+        throw new OpencodeConfigError(`cannot set permissions on OpenCode config directory ${dir}: ${error.message}`);
+    }
+    const target = await resolveOpencodeConfigPath(dir);
+    const created = !(await exists(target));
+    let text = '';
+    if (!created) {
+        try {
+            text = await readFile(target, 'utf-8');
+        }
+        catch (error) {
+            throw new OpencodeConfigError(`cannot read OpenCode config at ${target}: ${error.message}`);
+        }
+    }
+    if (text.trim().length === 0) {
+        text = '{}\n';
+    }
+    const parseErrors = [];
+    const parsed = parse(text, parseErrors, { allowTrailingComma: true });
+    if (parseErrors.length > 0) {
+        const first = parseErrors[0];
+        throw new OpencodeConfigError(`cannot parse OpenCode config at ${target}: ${printParseErrorCode(first.error)} at offset ${first.offset}`);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new OpencodeConfigError(`invalid OpenCode config at ${target}: expected a JSON object`);
+    }
+    const formattingOptions = {
+        insertSpaces: true,
+        tabSize: 2,
+        eol: text.includes('\r\n') ? '\r\n' : '\n',
+    };
+    const provider = buildZagProvider(options.env);
+    const edits = modify(text, ['provider', 'zag'], provider, { formattingOptions });
+    let content = applyEdits(text, edits);
+    if (!content.endsWith('\n'))
+        content += '\n';
+    const tempPath = join(dir, `.opencode-config.${process.pid}.${randomUUID()}.tmp`);
+    try {
+        // 先写同目录临时文件（0600）再 rename：失败时原配置保持完整，不产生半写文件。
+        await writeFile(tempPath, content, { encoding: 'utf-8', mode: 0o600 });
+        await chmod(tempPath, 0o600);
+        await rename(tempPath, target);
+    }
+    catch (error) {
+        await rm(tempPath, { force: true }).catch(() => { });
+        throw new OpencodeConfigError(`cannot write OpenCode config at ${target}: ${error.message}`);
+    }
+    return {
+        path: target,
+        created,
+        modelCount: Object.keys(provider.models).length,
+    };
+}
+//# sourceMappingURL=opencode-config.js.map

package/dist/harness/opencode-config.js.map

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

package/dist/harness/opencode-config.test.d.ts

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

package/dist/harness/opencode-config.test.d.ts.map

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

package/dist/harness/opencode-config.test.js

@@ -0,0 +1,183 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { chmod, mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse } from 'jsonc-parser';
+import { OpencodeConfigError, ZAG_PROVIDER_NPM, buildZagProvider, resolveOpencodeConfigPath, writeOpencodeConfig, } from './opencode-config.js';
+const TMP_BASE = '/tmp/opencode';
+const ENV = {
+    modelBaseUrl: 'http://admin-api:8002/v1',
+    modelApiKey: 'zag_sk_super_secret',
+    modelIds: ['model-a', 'model-b'],
+};
+async function makeDir() {
+    await mkdir(TMP_BASE, { recursive: true });
+    return mkdtemp(join(TMP_BASE, 'opencode-config-'));
+}
+async function fileMode(path) {
+    return (await stat(path)).mode & 0o777;
+}
+describe('buildZagProvider (T-AG9/T-AG11)', () => {
+    it('builds an OpenAI-compatible provider with baseURL/apiKey/models', () => {
+        expect(buildZagProvider(ENV)).toEqual({
+            npm: '@ai-sdk/openai-compatible',
+            name: 'ZAG',
+            options: {
+                baseURL: 'http://admin-api:8002/v1',
+                apiKey: 'zag_sk_super_secret',
+            },
+            models: {
+                'model-a': { name: 'model-a' },
+                'model-b': { name: 'model-b' },
+            },
+        });
+        expect(ZAG_PROVIDER_NPM).toBe('@ai-sdk/openai-compatible');
+    });
+    it('writes models:{} for an empty model list', () => {
+        expect(buildZagProvider({ ...ENV, modelIds: [] }).models).toEqual({});
+    });
+});
+describe('writeOpencodeConfig (T-AG9..T-AG12)', () => {
+    const dirs = [];
+    afterEach(async () => {
+        await Promise.all(dirs.splice(0).map((dir) => rm(dir, { recursive: true, force: true })));
+    });
+    it('T-AG9: creates opencode.jsonc with provider.zag and 0600 permissions', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        const result = await writeOpencodeConfig({ env: ENV, configDir: dir });
+        expect(result.path).toBe(join(dir, 'opencode.jsonc'));
+        expect(result.created).toBe(true);
+        expect(result.modelCount).toBe(2);
+        expect(await fileMode(result.path)).toBe(0o600);
+        const config = parse(await readFile(result.path, 'utf-8'));
+        expect(config.provider.zag.options.baseURL).toBe('http://admin-api:8002/v1');
+        expect(config.provider.zag.options.apiKey).toBe('zag_sk_super_secret');
+        expect(config.provider.zag.models).toEqual({
+            'model-a': { name: 'model-a' },
+            'model-b': { name: 'model-b' },
+        });
+    });
+    it('T-AG10: merges an existing config, preserving comments and other providers and replacing provider.zag', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        const target = join(dir, 'opencode.jsonc');
+        await writeFile(target, `{
+  // keep this comment
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    // existing provider must survive
+    "other": {
+      "npm": "@example/other",
+      "name": "Other",
+      "options": { "baseURL": "http://other" },
+      "models": { "x": { "name": "x" } }
+    },
+    "zag": {
+      "npm": "old-npm",
+      "name": "Old ZAG",
+      "options": { "baseURL": "http://old", "apiKey": "old-key" },
+      "models": {}
+    }
+  }
+}
+`, 'utf-8');
+        await writeOpencodeConfig({ env: ENV, configDir: dir });
+        const text = await readFile(target, 'utf-8');
+        expect(text).toContain('// keep this comment');
+        expect(text).toContain('// existing provider must survive');
+        const config = parse(text);
+        expect(config.$schema).toBe('https://opencode.ai/config.json');
+        expect(config.provider.other).toMatchObject({ npm: '@example/other', name: 'Other' });
+        expect(config.provider.zag).toMatchObject({
+            npm: ZAG_PROVIDER_NPM,
+            name: 'ZAG',
+            options: { baseURL: 'http://admin-api:8002/v1', apiKey: 'zag_sk_super_secret' },
+        });
+        // 旧 apiKey/baseURL 已被替换
+        expect(text).not.toContain('old-key');
+        expect(text).not.toContain('http://old');
+    });
+    it('T-AG11: writes models:{} when ZAG_MODEL_IDS is an empty array', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        await writeOpencodeConfig({ env: { ...ENV, modelIds: [] }, configDir: dir });
+        const config = parse(await readFile(join(dir, 'opencode.jsonc'), 'utf-8'));
+        expect(config.provider.zag.models).toEqual({});
+    });
+    it('T-AG12: merges an existing opencode.json instead of creating a new .jsonc', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        const jsonPath = join(dir, 'opencode.json');
+        await writeFile(jsonPath, '{\n  "theme": "dark"\n}\n', 'utf-8');
+        const result = await writeOpencodeConfig({ env: ENV, configDir: dir });
+        expect(result.path).toBe(jsonPath);
+        expect(result.created).toBe(false);
+        expect(await fileMode(jsonPath)).toBe(0o600);
+        const config = parse(await readFile(jsonPath, 'utf-8'));
+        expect(config.theme).toBe('dark');
+        expect(config.provider.zag.name).toBe('ZAG');
+        // 不创建并存的 .jsonc
+        await expect(stat(join(dir, 'opencode.jsonc'))).rejects.toThrow();
+    });
+    it('T-AG9b: tightens permissions of an existing config to 0600', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        const target = join(dir, 'opencode.jsonc');
+        await writeFile(target, '{}\n', 'utf-8');
+        await chmod(target, 0o644);
+        await writeOpencodeConfig({ env: ENV, configDir: dir });
+        expect(await fileMode(target)).toBe(0o600);
+    });
+    it('C-7: tightens an existing config directory to 0700', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        await chmod(dir, 0o755);
+        await writeOpencodeConfig({ env: ENV, configDir: dir });
+        expect(await fileMode(dir)).toBe(0o700);
+    });
+    it('C-7: writes atomically via a temp file and leaves no partial/temp files', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        const target = join(dir, 'opencode.jsonc');
+        await writeFile(target, '{\n  "theme": "dark"\n}\n', 'utf-8');
+        await writeOpencodeConfig({ env: ENV, configDir: dir });
+        // 同目录只应有目标文件（临时文件已 rename 掉）
+        expect(await readdir(dir)).toEqual(['opencode.jsonc']);
+        expect(await fileMode(target)).toBe(0o600);
+        const config = parse(await readFile(target, 'utf-8'));
+        expect(config.theme).toBe('dark');
+        expect(config.provider.zag.name).toBe('ZAG');
+    });
+    it('C-7: keeps the original file intact when the write path fails', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        const target = join(dir, 'opencode.jsonc');
+        const original = '{\n  "theme": "dark"\n}\n';
+        await writeFile(target, original, 'utf-8');
+        // 目标文件不可读（解析阶段失败）：不得产生临时文件，原文件保持原样。
+        await chmod(target, 0o200);
+        await expect(writeOpencodeConfig({ env: ENV, configDir: dir })).rejects.toBeInstanceOf(OpencodeConfigError);
+        expect(await readdir(dir)).toEqual(['opencode.jsonc']);
+        await chmod(target, 0o600);
+        expect(await readFile(target, 'utf-8')).toBe(original);
+    });
+    it('rejects invalid JSONC and leaves the file untouched', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        const target = join(dir, 'opencode.jsonc');
+        const original = '{ "provider": ';
+        await writeFile(target, original, 'utf-8');
+        await expect(writeOpencodeConfig({ env: ENV, configDir: dir })).rejects.toBeInstanceOf(OpencodeConfigError);
+        expect(await readFile(target, 'utf-8')).toBe(original);
+    });
+    it('T-AG12b: resolves the target file by precedence', async () => {
+        const dir = await makeDir();
+        dirs.push(dir);
+        expect(await resolveOpencodeConfigPath(dir)).toBe(join(dir, 'opencode.jsonc'));
+        await writeFile(join(dir, 'opencode.json'), '{}\n', 'utf-8');
+        expect(await resolveOpencodeConfigPath(dir)).toBe(join(dir, 'opencode.json'));
+        await writeFile(join(dir, 'opencode.jsonc'), '{}\n', 'utf-8');
+        expect(await resolveOpencodeConfigPath(dir)).toBe(join(dir, 'opencode.jsonc'));
+    });
+});
+//# sourceMappingURL=opencode-config.test.js.map