niceeval 0.12.1 → 0.12.2-canary.31

package/dist/agents/opencode.cjs

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openCodeAgent = openCodeAgent;
+const define_ts_1 = require("../define.cjs");
+const effect_1 = require("effect");
+const util_ts_1 = require("../util.cjs");
+const shared_ts_1 = require("./shared.cjs");
+const skills_ts_1 = require("./skills.cjs");
+const canonical_ts_1 = require("../o11y/otlp/canonical.cjs");
+const command_projection_ts_1 = require("../o11y/command-projection.cjs");
+const shell_ts_1 = require("../sandbox/shell.cjs");
+const coverage_ts_1 = require("../assertions/coverage.cjs");
+const opencode_ts_1 = require("../o11y/parsers/opencode.cjs");
+const coding_cli_versions_ts_1 = require("./coding-cli-versions.cjs");
+const npm_staged_ts_1 = require("./npm-staged.cjs");
+const send_failures_ts_1 = require("../context/send-failures.cjs");
+// OpenCode sandbox adapter。驱动:`opencode run --format json --auto`;
+// 行为轨优先 stdout JSONL,不足时 `opencode export <sessionID>`。
+// 契约见 docs/feature/adapters/sdk/opencode/README.md。
+const SKILL_DIR = ".agents/skills";
+/** 自定义 OpenAI 兼容网关在 opencode.json 里的 provider id。 */
+const COMPAT_PROVIDER = "compat";
+/**
+ * OpenCode 的 native skill registry 需要 YAML frontmatter 才会把 SKILL.md 广播给
+ * `skill` 工具。共享 SkillSpec 同时服务不要求 frontmatter 的 coding agents，所以只在
+ * OpenCode 沙箱内为缺失的元数据补一个由安装名派生的最小头；作者已有的 native header
+ * 原样保留，仍由 OpenCode 自己校验。
+ */
+async function addOpenCodeSkillFrontmatter(sb, names) {
+    for (const name of names) {
+        const path = `${SKILL_DIR}/${name}/SKILL.md`;
+        const quotedPath = (0, shell_ts_1.shellQuote)(path);
+        const header = [
+            "---",
+            `name: ${JSON.stringify(name)}`,
+            `description: ${JSON.stringify(`NiceEval-installed skill ${name}`)}`,
+            "---",
+            "",
+        ].join("\n");
+        const result = await sb.runShell([
+            `if [ \"$(sed -n '1p' ${quotedPath})\" != \"---\" ]; then`,
+            "  tmp=$(mktemp) || exit 1",
+            "  cat > \"$tmp\" <<'NICEEVAL_OPENCODE_SKILL_HEADER'",
+            header,
+            "NICEEVAL_OPENCODE_SKILL_HEADER",
+            `  cat ${quotedPath} >> \"$tmp\" && mv \"$tmp\" ${quotedPath} || { rm -f \"$tmp\"; exit 1; }`,
+            "fi",
+        ].join("\n"));
+        if (result.exitCode !== 0) {
+            throw new Error(`OpenCode skill ${JSON.stringify(name)} could not receive native frontmatter.`);
+        }
+    }
+}
+function resolveApiKey(config) {
+    return config?.apiKey ?? (0, util_ts_1.getEnv)("OPENCODE_API_KEY") ?? (0, util_ts_1.requireEnv)("ANTHROPIC_API_KEY");
+}
+function resolveBaseUrl(config) {
+    return config?.baseUrl ?? (0, util_ts_1.getEnv)("OPENCODE_BASE_URL");
+}
+/** experiment.model → `--model`。裸模型名在自定义网关下补成 `compat/<model>`。 */
+function resolveModelFlag(model, hasCompatBase) {
+    if (!model)
+        return undefined;
+    if (model.includes("/"))
+        return model;
+    return hasCompatBase ? `${COMPAT_PROVIDER}/${model}` : model;
+}
+/**
+ * OpenCode 的内置 sandbox Agent 工厂。
+ */
+function openCodeAgent(config) {
+    const version = config?.version ?? coding_cli_versions_ts_1.DEFAULT_OPENCODE_CLI_VERSION;
+    const { ensure, installer } = (0, npm_staged_ts_1.createNpmCliInstaller)({
+        identity: {
+            agent: "opencode",
+            version,
+            revision: String(coding_cli_versions_ts_1.AGENT_BASELINE_RECIPE_REVISION.opencode),
+        },
+        packageName: "opencode-ai",
+        bin: "opencode",
+    });
+    return (0, define_ts_1.defineSandboxAgent)({
+        name: "opencode",
+        evidenceCoverage: coverage_ts_1.completeEvidenceCoverage,
+        spanMapper: canonical_ts_1.mapGenericSpans,
+        ensure,
+        installers: [installer],
+        tracing: {
+            protocol: "http/protobuf",
+            env: (endpoint) => ({
+                OTEL_TRACES_EXPORTER: "otlp",
+                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,
+                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: "http/protobuf",
+            }),
+        },
+        async setup(sb, ctx) {
+            const baseUrl = resolveBaseUrl(config);
+            const provider = {};
+            if (baseUrl) {
+                // OpenAI 兼容网关必须走 openai-compatible npm 包 + 显式 models 表,
+                // 否则 OpenCode 不会把自定义 baseURL 接到请求上。
+                provider[COMPAT_PROVIDER] = {
+                    npm: "@ai-sdk/openai-compatible",
+                    name: "OpenAI-compatible",
+                    options: {
+                        apiKey: "{env:OPENCODE_API_KEY}",
+                        baseURL: baseUrl,
+                    },
+                    models: {
+                        // 允许任意 experiment.model;具体 id 由 --model compat/<id> 选择。
+                        "gpt-5.6-luna": { name: "gpt-5.6-luna" },
+                        "gpt-5.4-mini": { name: "gpt-5.4-mini" },
+                        "gpt-5.4": { name: "gpt-5.4" },
+                        "gpt-4.1-mini": { name: "gpt-4.1-mini" },
+                        "gpt-4o-mini": { name: "gpt-4o-mini" },
+                    },
+                };
+            }
+            const opencodeConfig = {
+                $schema: "https://opencode.ai/config.json",
+                ...(Object.keys(provider).length ? { provider } : {}),
+                permission: {
+                    write: "allow",
+                    edit: "allow",
+                    bash: "allow",
+                    read: "allow",
+                },
+            };
+            await shared_ts_1.shared.writeFile(sb, "opencode.json", JSON.stringify(opencodeConfig, null, 2));
+            const manifest = { skills: [] };
+            if (config?.skills?.length) {
+                manifest.skills = await (0, skills_ts_1.installSkills)(sb, config.skills, { dir: SKILL_DIR });
+                await addOpenCodeSkillFrontmatter(sb, (0, skills_ts_1.installedSkillNames)(manifest.skills));
+                await (0, skills_ts_1.appendProjectInstruction)(sb, (0, skills_ts_1.skillDiscoveryInstruction)(SKILL_DIR, (0, skills_ts_1.installedSkillNames)(manifest.skills)));
+            }
+            if (manifest.skills.length) {
+                ctx.reportSetup(manifest);
+            }
+        },
+        send: (input, ctx) => effect_1.Effect.runPromise(effect_1.Effect.scoped(effect_1.Effect.gen(function* () {
+            const sb = ctx.sandbox;
+            const opencodeBin = yield* (0, npm_staged_ts_1.resolveAgentBinEffect)(sb, "opencode");
+            return yield* effect_1.Effect.tryPromise({
+                try: async (signal) => {
+                    const baseUrl = resolveBaseUrl(config);
+                    const args = ["run", input.text, "--format", "json", "--auto"];
+                    const model = resolveModelFlag(ctx.model, Boolean(baseUrl));
+                    if (model)
+                        args.push("--model", model);
+                    if (ctx.session.id)
+                        args.push("--session", ctx.session.id);
+                    const apiKey = resolveApiKey(config);
+                    const env = {
+                        OPENCODE_API_KEY: apiKey,
+                        OPENAI_API_KEY: apiKey,
+                        ANTHROPIC_API_KEY: apiKey,
+                        ...ctx.telemetry?.env,
+                    };
+                    if (baseUrl) {
+                        env.OPENCODE_BASE_URL = baseUrl;
+                        env.OPENAI_BASE_URL = baseUrl;
+                    }
+                    const sensitiveValues = [apiKey];
+                    const res = await sb.runCommand(opencodeBin, args, { env, sensitiveValues, stream: true, signal });
+                    let raw = (0, opencode_ts_1.extractOpenCodeJsonl)(res.stdout) ?? (0, opencode_ts_1.extractOpenCodeJsonl)(`${res.stdout}\n${res.stderr}`);
+                    let sessionId = (0, opencode_ts_1.sessionIdFromOpenCodeTranscript)(raw) ?? (0, opencode_ts_1.sessionIdFromOpenCodeTranscript)(res.stdout);
+                    if (sessionId)
+                        ctx.session.capture(sessionId);
+                    let parsed = (0, opencode_ts_1.parseOpenCodeTranscript)(raw);
+                    // 仅当 stdout 既没有工具也没有助手文本时才 export 补读——纯对话轮
+                    // (session/recall) 的 text 事件已在 JSONL 里,再 export 会冲掉已解析事件。
+                    const hasActions = parsed.events.some((e) => e.type === "operation.started" && e.operation.kind === "tool");
+                    const hasMessages = parsed.events.some((e) => e.type === "message");
+                    if (!hasActions && !hasMessages && (sessionId ?? ctx.session.id)) {
+                        const sid = sessionId ?? ctx.session.id;
+                        const exported = await sb.runCommand(opencodeBin, ["export", sid], { env, sensitiveValues, signal });
+                        if (exported.exitCode === 0 && exported.stdout.trim()) {
+                            raw = exported.stdout;
+                            parsed = (0, opencode_ts_1.parseOpenCodeTranscript)(raw);
+                            sessionId = (0, opencode_ts_1.sessionIdFromOpenCodeTranscript)(raw) ?? sessionId;
+                            if (sessionId)
+                                ctx.session.capture(sessionId);
+                        }
+                    }
+                    const events = [...parsed.events];
+                    const hasErrorEvent = events.some((e) => e.type === "error");
+                    let turnEvidenceCoverage;
+                    if (!raw?.trim()) {
+                        const reason = "OpenCode transcript/export was unavailable; tool trajectory was not observed.";
+                        turnEvidenceCoverage = {
+                            events: { status: "unavailable", reason },
+                            actions: { status: "unavailable", reason },
+                            usage: { status: "unavailable", reason },
+                        };
+                    }
+                    else if (!parsed.parseSuccess) {
+                        const reason = "Some OpenCode transcript lines could not be parsed.";
+                        turnEvidenceCoverage = {
+                            events: { status: "partial", reason },
+                            actions: { status: "partial", reason },
+                        };
+                    }
+                    else {
+                        turnEvidenceCoverage = (0, command_projection_ts_1.unclassifiedToolActionsCoverage)(events);
+                    }
+                    if (res.exitCode !== 0) {
+                        throw (0, send_failures_ts_1.makeSendFailure)({
+                            acceptance: (0, send_failures_ts_1.sendAcceptanceFromEvents)(events),
+                            message: shared_ts_1.shared.diagnoseFailure(res, parsed.events, raw),
+                            events,
+                            usage: parsed.usage,
+                            process: res,
+                        });
+                    }
+                    return {
+                        events,
+                        usage: parsed.usage,
+                        status: hasErrorEvent ? "failed" : "completed",
+                        ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),
+                    };
+                },
+                catch: (cause) => cause,
+            });
+        })), { signal: ctx.signal }),
+    });
+}
+exports.default = openCodeAgent();
+//# sourceMappingURL=opencode.cjs.map

package/dist/agents/opencode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["opencode.ts"],"names":[],"mappings":"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","sourcesContent":["import { defineSandboxAgent } from \"../define.ts\";\nimport { Effect } from \"effect\";\nimport { requireEnv, getEnv } from \"../util.ts\";\nimport { shared } from \"./shared.ts\";\nimport { appendProjectInstruction, installSkills, installedSkillNames, skillDiscoveryInstruction, } from \"./skills.ts\";\nimport { mapGenericSpans } from \"../o11y/otlp/canonical.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\nimport { shellQuote } from \"../sandbox/shell.ts\";\nimport { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport { parseOpenCodeTranscript, sessionIdFromOpenCodeTranscript, extractOpenCodeJsonl, } from \"../o11y/parsers/opencode.ts\";\nimport { DEFAULT_OPENCODE_CLI_VERSION, AGENT_BASELINE_RECIPE_REVISION } from \"./coding-cli-versions.ts\";\nimport { createNpmCliInstaller, resolveAgentBinEffect } from \"./npm-staged.ts\";\nimport type { Agent, AgentSetupManifest, Sandbox, SkillSpec, StreamEvent, TurnEvidenceCoverage, } from \"../types.ts\";\nimport { makeSendFailure, sendAcceptanceFromEvents } from \"../context/send-failures.ts\";\n// OpenCode sandbox adapter。驱动:`opencode run --format json --auto`;\n// 行为轨优先 stdout JSONL,不足时 `opencode export <sessionID>`。\n// 契约见 docs/feature/adapters/sdk/opencode/README.md。\nconst SKILL_DIR = \".agents/skills\";\n/** 自定义 OpenAI 兼容网关在 opencode.json 里的 provider id。 */\nconst COMPAT_PROVIDER = \"compat\";\n/**\n * OpenCode 的 native skill registry 需要 YAML frontmatter 才会把 SKILL.md 广播给\n * `skill` 工具。共享 SkillSpec 同时服务不要求 frontmatter 的 coding agents，所以只在\n * OpenCode 沙箱内为缺失的元数据补一个由安装名派生的最小头；作者已有的 native header\n * 原样保留，仍由 OpenCode 自己校验。\n */\nasync function addOpenCodeSkillFrontmatter(sb: Sandbox, names: readonly string[]): Promise<void> {\n    for (const name of names) {\n        const path = `${SKILL_DIR}/${name}/SKILL.md`;\n        const quotedPath = shellQuote(path);\n        const header = [\n            \"---\",\n            `name: ${JSON.stringify(name)}`,\n            `description: ${JSON.stringify(`NiceEval-installed skill ${name}`)}`,\n            \"---\",\n            \"\",\n        ].join(\"\\n\");\n        const result = await sb.runShell([\n            `if [ \\\"$(sed -n '1p' ${quotedPath})\\\" != \\\"---\\\" ]; then`,\n            \"  tmp=$(mktemp) || exit 1\",\n            \"  cat > \\\"$tmp\\\" <<'NICEEVAL_OPENCODE_SKILL_HEADER'\",\n            header,\n            \"NICEEVAL_OPENCODE_SKILL_HEADER\",\n            `  cat ${quotedPath} >> \\\"$tmp\\\" && mv \\\"$tmp\\\" ${quotedPath} || { rm -f \\\"$tmp\\\"; exit 1; }`,\n            \"fi\",\n        ].join(\"\\n\"));\n        if (result.exitCode !== 0) {\n            throw new Error(`OpenCode skill ${JSON.stringify(name)} could not receive native frontmatter.`);\n        }\n    }\n}\nexport interface OpenCodeConfig {\n    /** 模型 API key。省略时读 OPENCODE_API_KEY,再回落 ANTHROPIC_API_KEY。 */\n    apiKey?: string;\n    /** OpenAI 兼容端点。省略时读 OPENCODE_BASE_URL。 */\n    baseUrl?: string;\n    /** 钉 npm `opencode-ai` 版本;省略时用 NiceEval 默认 pin。 */\n    version?: string;\n    /** 装进沙箱的 Skill,落在 `.agents/skills/<name>/`。 */\n    skills?: SkillSpec[];\n}\nfunction resolveApiKey(config?: OpenCodeConfig): string {\n    return config?.apiKey ?? getEnv(\"OPENCODE_API_KEY\") ?? requireEnv(\"ANTHROPIC_API_KEY\");\n}\nfunction resolveBaseUrl(config?: OpenCodeConfig): string | undefined {\n    return config?.baseUrl ?? getEnv(\"OPENCODE_BASE_URL\");\n}\n/** experiment.model → `--model`。裸模型名在自定义网关下补成 `compat/<model>`。 */\nfunction resolveModelFlag(model: string | undefined, hasCompatBase: boolean): string | undefined {\n    if (!model)\n        return undefined;\n    if (model.includes(\"/\"))\n        return model;\n    return hasCompatBase ? `${COMPAT_PROVIDER}/${model}` : model;\n}\n/**\n * OpenCode 的内置 sandbox Agent 工厂。\n */\nexport function openCodeAgent(config?: OpenCodeConfig): Agent {\n    const version = config?.version ?? DEFAULT_OPENCODE_CLI_VERSION;\n    const { ensure, installer } = createNpmCliInstaller({\n        identity: {\n            agent: \"opencode\",\n            version,\n            revision: String(AGENT_BASELINE_RECIPE_REVISION.opencode),\n        },\n        packageName: \"opencode-ai\",\n        bin: \"opencode\",\n    });\n    return defineSandboxAgent({\n        name: \"opencode\",\n        evidenceCoverage: completeEvidenceCoverage,\n        spanMapper: mapGenericSpans,\n        ensure,\n        installers: [installer],\n        tracing: {\n            protocol: \"http/protobuf\",\n            env: (endpoint) => ({\n                OTEL_TRACES_EXPORTER: \"otlp\",\n                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,\n                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: \"http/protobuf\",\n            }),\n        },\n        async setup(sb, ctx) {\n            const baseUrl = resolveBaseUrl(config);\n            const provider: globalThis.Record<string, unknown> = {};\n            if (baseUrl) {\n                // OpenAI 兼容网关必须走 openai-compatible npm 包 + 显式 models 表,\n                // 否则 OpenCode 不会把自定义 baseURL 接到请求上。\n                provider[COMPAT_PROVIDER] = {\n                    npm: \"@ai-sdk/openai-compatible\",\n                    name: \"OpenAI-compatible\",\n                    options: {\n                        apiKey: \"{env:OPENCODE_API_KEY}\",\n                        baseURL: baseUrl,\n                    },\n                    models: {\n                        // 允许任意 experiment.model;具体 id 由 --model compat/<id> 选择。\n                        \"gpt-5.6-luna\": { name: \"gpt-5.6-luna\" },\n                        \"gpt-5.4-mini\": { name: \"gpt-5.4-mini\" },\n                        \"gpt-5.4\": { name: \"gpt-5.4\" },\n                        \"gpt-4.1-mini\": { name: \"gpt-4.1-mini\" },\n                        \"gpt-4o-mini\": { name: \"gpt-4o-mini\" },\n                    },\n                };\n            }\n            const opencodeConfig = {\n                $schema: \"https://opencode.ai/config.json\",\n                ...(Object.keys(provider).length ? { provider } : {}),\n                permission: {\n                    write: \"allow\",\n                    edit: \"allow\",\n                    bash: \"allow\",\n                    read: \"allow\",\n                },\n            };\n            await shared.writeFile(sb, \"opencode.json\", JSON.stringify(opencodeConfig, null, 2));\n            const manifest: AgentSetupManifest = { skills: [] };\n            if (config?.skills?.length) {\n                manifest.skills = await installSkills(sb, config.skills, { dir: SKILL_DIR });\n                await addOpenCodeSkillFrontmatter(sb, installedSkillNames(manifest.skills));\n                await appendProjectInstruction(sb, skillDiscoveryInstruction(SKILL_DIR, installedSkillNames(manifest.skills)));\n            }\n            if (manifest.skills.length) {\n                ctx.reportSetup(manifest);\n            }\n        },\n        send: (input, ctx) => Effect.runPromise(Effect.scoped(Effect.gen(function* () {\n            const sb = ctx.sandbox;\n            const opencodeBin = yield* resolveAgentBinEffect(sb, \"opencode\");\n            return yield* Effect.tryPromise({\n                try: async (signal) => {\n                    const baseUrl = resolveBaseUrl(config);\n                    const args = [\"run\", input.text, \"--format\", \"json\", \"--auto\"];\n                    const model = resolveModelFlag(ctx.model, Boolean(baseUrl));\n                    if (model)\n                        args.push(\"--model\", model);\n                    if (ctx.session.id)\n                        args.push(\"--session\", ctx.session.id);\n                    const apiKey = resolveApiKey(config);\n                    const env: globalThis.Record<string, string> = {\n                        OPENCODE_API_KEY: apiKey,\n                        OPENAI_API_KEY: apiKey,\n                        ANTHROPIC_API_KEY: apiKey,\n                        ...ctx.telemetry?.env,\n                    };\n                    if (baseUrl) {\n                        env.OPENCODE_BASE_URL = baseUrl;\n                        env.OPENAI_BASE_URL = baseUrl;\n                    }\n                    const sensitiveValues = [apiKey];\n                    const res = await sb.runCommand(opencodeBin, args, { env, sensitiveValues, stream: true, signal });\n                    let raw = extractOpenCodeJsonl(res.stdout) ?? extractOpenCodeJsonl(`${res.stdout}\\n${res.stderr}`);\n                    let sessionId = sessionIdFromOpenCodeTranscript(raw) ?? sessionIdFromOpenCodeTranscript(res.stdout);\n                    if (sessionId)\n                        ctx.session.capture(sessionId);\n                    let parsed = parseOpenCodeTranscript(raw);\n                    // 仅当 stdout 既没有工具也没有助手文本时才 export 补读——纯对话轮\n                    // (session/recall) 的 text 事件已在 JSONL 里,再 export 会冲掉已解析事件。\n                    const hasActions = parsed.events.some((e) => e.type === \"operation.started\" && e.operation.kind === \"tool\");\n                    const hasMessages = parsed.events.some((e) => e.type === \"message\");\n                    if (!hasActions && !hasMessages && (sessionId ?? ctx.session.id)) {\n                        const sid = sessionId ?? ctx.session.id!;\n                        const exported = await sb.runCommand(opencodeBin, [\"export\", sid], { env, sensitiveValues, signal });\n                        if (exported.exitCode === 0 && exported.stdout.trim()) {\n                            raw = exported.stdout;\n                            parsed = parseOpenCodeTranscript(raw);\n                            sessionId = sessionIdFromOpenCodeTranscript(raw) ?? sessionId;\n                            if (sessionId)\n                                ctx.session.capture(sessionId);\n                        }\n                    }\n                    const events: StreamEvent[] = [...parsed.events];\n                    const hasErrorEvent = events.some((e) => e.type === \"error\");\n                    let turnEvidenceCoverage: TurnEvidenceCoverage | undefined;\n                    if (!raw?.trim()) {\n                        const reason = \"OpenCode transcript/export was unavailable; tool trajectory was not observed.\";\n                        turnEvidenceCoverage = {\n                            events: { status: \"unavailable\", reason },\n                            actions: { status: \"unavailable\", reason },\n                            usage: { status: \"unavailable\", reason },\n                        };\n                    }\n                    else if (!parsed.parseSuccess) {\n                        const reason = \"Some OpenCode transcript lines could not be parsed.\";\n                        turnEvidenceCoverage = {\n                            events: { status: \"partial\", reason },\n                            actions: { status: \"partial\", reason },\n                        };\n                    }\n                    else {\n                        turnEvidenceCoverage = unclassifiedToolActionsCoverage(events);\n                    }\n                    if (res.exitCode !== 0) {\n                        throw makeSendFailure({\n                            acceptance: sendAcceptanceFromEvents(events),\n                            message: shared.diagnoseFailure(res, parsed.events, raw),\n                            events,\n                            usage: parsed.usage,\n                            process: res,\n                        });\n                    }\n                    return {\n                        events,\n                        usage: parsed.usage,\n                        status: hasErrorEvent ? \"failed\" as const : \"completed\" as const,\n                        ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),\n                    };\n                },\n                catch: (cause) => cause,\n            });\n        })), { signal: ctx.signal }),\n    });\n}\nexport default openCodeAgent();\n"]}

package/dist/agents/opencode.d.cts

@@ -0,0 +1,17 @@
+import type { Agent, SkillSpec } from "../types.cjs";
+export interface OpenCodeConfig {
+    /** 模型 API key。省略时读 OPENCODE_API_KEY,再回落 ANTHROPIC_API_KEY。 */
+    apiKey?: string;
+    /** OpenAI 兼容端点。省略时读 OPENCODE_BASE_URL。 */
+    baseUrl?: string;
+    /** 钉 npm `opencode-ai` 版本;省略时用 NiceEval 默认 pin。 */
+    version?: string;
+    /** 装进沙箱的 Skill,落在 `.agents/skills/<name>/`。 */
+    skills?: SkillSpec[];
+}
+/**
+ * OpenCode 的内置 sandbox Agent 工厂。
+ */
+export declare function openCodeAgent(config?: OpenCodeConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/opencode.d.mts

@@ -0,0 +1,17 @@
+import type { Agent, SkillSpec } from "../types.mjs";
+export interface OpenCodeConfig {
+    /** 模型 API key。省略时读 OPENCODE_API_KEY,再回落 ANTHROPIC_API_KEY。 */
+    apiKey?: string;
+    /** OpenAI 兼容端点。省略时读 OPENCODE_BASE_URL。 */
+    baseUrl?: string;
+    /** 钉 npm `opencode-ai` 版本;省略时用 NiceEval 默认 pin。 */
+    version?: string;
+    /** 装进沙箱的 Skill,落在 `.agents/skills/<name>/`。 */
+    skills?: SkillSpec[];
+}
+/**
+ * OpenCode 的内置 sandbox Agent 工厂。
+ */
+export declare function openCodeAgent(config?: OpenCodeConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/opencode.d.ts

@@ -0,0 +1,17 @@
+import type { Agent, SkillSpec } from "../types.js";
+export interface OpenCodeConfig {
+    /** 模型 API key。省略时读 OPENCODE_API_KEY,再回落 ANTHROPIC_API_KEY。 */
+    apiKey?: string;
+    /** OpenAI 兼容端点。省略时读 OPENCODE_BASE_URL。 */
+    baseUrl?: string;
+    /** 钉 npm `opencode-ai` 版本;省略时用 NiceEval 默认 pin。 */
+    version?: string;
+    /** 装进沙箱的 Skill,落在 `.agents/skills/<name>/`。 */
+    skills?: SkillSpec[];
+}
+/**
+ * OpenCode 的内置 sandbox Agent 工厂。
+ */
+export declare function openCodeAgent(config?: OpenCodeConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/opencode.js

@@ -0,0 +1,7 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./opencode.cjs");
+export default __niceevalCanonical.default;
+const __niceevalExport0 = __niceevalCanonical["openCodeAgent"];
+export { __niceevalExport0 as openCodeAgent };
+//# sourceMappingURL=opencode.js.map

package/dist/agents/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sources":[],"names":[],"mappings":""}

package/dist/agents/post-setup.cjs

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentLifecycleHookCommands = registerAgentLifecycleHookCommands;
+exports.agentLifecycleHookCommandsOf = agentLifecycleHookCommandsOf;
+exports.runPostSetupHooks = runPostSetupHooks;
+exports.runPreTeardownHooks = runPreTeardownHooks;
+// factory 的 postSetup / preTeardown 钩子执行器 —— Claude Code / Codex / Bub 共用。
+// 契约见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」:
+// postSetup 在 adapter 全部安装步骤(含 manifest)之后按数组顺序执行;preTeardown 与它成对,
+// 按逆序、先于 agent 自己的 teardown 步骤执行(LIFO 镜像 —— postSetup 跑在 agent 安装之后,
+// preTeardown 跑在 agent 收尾之前)。两者复用 SandboxCommand 的窄上下文,不消费钩子返回值。
+// 钩子抛错直接传播:postSetup 处于 setup 阶段(attempt errored);preTeardown 处于 teardown
+// 阶段,由 runner 的 teardown 段按 teardown-failed 诊断收束。
+const operations_ts_1 = require("../sandbox/operations.cjs");
+// Adapter factory 构造时就能知道的用户 hook 声明。用 WeakMap 挂在实际 Agent
+// 实例上，不把这份纯预览元数据扩成第二个公开 Agent 执行协议。
+const lifecycleHookCommands = new WeakMap();
+/** @internal 为内置 Adapter 登记与实际执行共用的 hook 数组。 */
+function registerAgentLifecycleHookCommands(agent, postSetup, preTeardown) {
+    lifecycleHookCommands.set(agent, {
+        postSetup: Object.freeze([...(postSetup ?? [])]),
+        preTeardown: Object.freeze([...(preTeardown ?? [])]),
+    });
+    return agent;
+}
+/** @internal `niceeval debug` 只读取已登记的声明，不执行 hook。 */
+function agentLifecycleHookCommandsOf(agent) {
+    return lifecycleHookCommands.get(agent);
+}
+const registeredCleanups = new WeakMap();
+/** Throwable 边界立即收窄；收尾队列不长期保存 `unknown`。 */
+function teardownError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+/** 窄上下文与 layer command 同款:不把 session / model / telemetry 借给过程钩子。 */
+function commandContext(ctx, agentName, phase, onCleanup) {
+    return {
+        phase,
+        ...(ctx.evalGroup === undefined ? {} : { evalGroup: ctx.evalGroup }),
+        owner: { kind: "agent", id: agentName },
+        attempt: ctx.attempt ?? { id: ctx.evalId ?? "unknown", index: 0 },
+        signal: ctx.signal,
+        progress: (update) => ctx.progress(update),
+        diagnostic: (input) => ctx.diagnostic(input),
+        facts: (key, value) => ctx.fact(key, value),
+        onCleanup,
+    };
+}
+/**
+ * postSetup 时点已走到的沙箱集合——preTeardown 的触发条件(成对触发规则:当且仅当同层 setup
+ * 时点走到过)。按 sandbox 实例作键:并发 attempt 共享同一 factory 配置,沙箱是天然的
+ * per-attempt 键;WeakSet 随沙箱对象回收,不泄漏。
+ */
+const postSetupPointReached = new WeakSet();
+/** 按数组顺序执行 postSetup 钩子。调用方在 adapter 全部安装步骤(含 manifest)之后调用一次;
+ *  即使数组为空也要调——它同时标记「postSetup 时点走到过」(preTeardown 的触发条件)。 */
+async function runPostSetupHooks(sb, ctx, agentName, hooks) {
+    postSetupPointReached.add(sb);
+    if (!hooks?.length)
+        return;
+    const cleanups = registeredCleanups.get(sb) ?? [];
+    registeredCleanups.set(sb, cleanups);
+    const hookCtx = commandContext(ctx, agentName, "agent.post-setup", (cleanup) => cleanups.push(cleanup));
+    const target = (0, operations_ts_1.createSandboxCommandTarget)(sb);
+    for (const hook of hooks)
+        await hook(target, hookCtx);
+}
+/**
+ * 按逆序执行 preTeardown 钩子(LIFO 镜像 postSetup)。调用方在各自 `teardown` 方法的最前面
+ * 调用一次,先于 agent 自己的收尾步骤。当且仅当本沙箱的 postSetup 时点走到过才执行——
+ * adapter setup 在安装步骤中途抛错时,preTeardown 的成对前提不存在,静默跳过。
+ */
+async function runPreTeardownHooks(sb, ctx, agentName, hooks) {
+    if (!postSetupPointReached.has(sb))
+        return;
+    const target = (0, operations_ts_1.createSandboxCommandTarget)(sb);
+    const nestedCleanups = [];
+    const hookCtx = commandContext(ctx, agentName, "agent.pre-teardown", (cleanup) => nestedCleanups.push(cleanup));
+    const cleanupContext = {
+        phase: "agent.pre-teardown",
+        ...(hookCtx.evalGroup === undefined ? {} : { evalGroup: hookCtx.evalGroup }),
+        owner: { kind: "agent", id: agentName },
+        attempt: hookCtx.attempt,
+        signal: hookCtx.signal,
+        progress: hookCtx.progress,
+        diagnostic: hookCtx.diagnostic,
+        facts: hookCtx.facts,
+    };
+    const failures = [];
+    try {
+        // 收尾链里的单点失败不能剥夺其余 hook 与已登记 cleanup 的执行机会。顺序仍然是
+        // preTeardown 声明的逆序，随后是截至当时所有 onCleanup 的全局逆序。
+        for (const hook of [...(hooks ?? [])].reverse()) {
+            try {
+                await hook(target, hookCtx);
+            }
+            catch (error) {
+                failures.push(teardownError(error));
+            }
+        }
+        for (const cleanup of [...(registeredCleanups.get(sb) ?? []), ...nestedCleanups].reverse()) {
+            try {
+                await cleanup(target, cleanupContext);
+            }
+            catch (error) {
+                failures.push(teardownError(error));
+            }
+        }
+    }
+    finally {
+        registeredCleanups.delete(sb);
+        postSetupPointReached.delete(sb);
+    }
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length > 1)
+        throw new AggregateError(failures, `${agentName} preTeardown failed`);
+}
+//# sourceMappingURL=post-setup.cjs.map

package/dist/agents/post-setup.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-setup.js","sourceRoot":"","sources":["post-setup.ts"],"names":[],"mappings":"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","sourcesContent":["// factory 的 postSetup / preTeardown 钩子执行器 —— Claude Code / Codex / Bub 共用。\n// 契约见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」:\n// postSetup 在 adapter 全部安装步骤(含 manifest)之后按数组顺序执行;preTeardown 与它成对,\n// 按逆序、先于 agent 自己的 teardown 步骤执行(LIFO 镜像 —— postSetup 跑在 agent 安装之后,\n// preTeardown 跑在 agent 收尾之前)。两者复用 SandboxCommand 的窄上下文,不消费钩子返回值。\n// 钩子抛错直接传播:postSetup 处于 setup 阶段(attempt errored);preTeardown 处于 teardown\n// 阶段,由 runner 的 teardown 段按 teardown-failed 诊断收束。\nimport { createSandboxCommandTarget } from \"../sandbox/operations.ts\";\nimport type { SandboxCleanupCommand, SandboxCommand, SandboxCommandContext, } from \"../sandbox/commands.ts\";\nimport type { Sandbox } from \"../sandbox/types.ts\";\nimport type { AgentContext, SandboxAgent } from \"./types.ts\";\nexport interface AgentLifecycleHookCommands {\n    readonly postSetup: readonly SandboxCommand[];\n    readonly preTeardown: readonly SandboxCommand[];\n}\n// Adapter factory 构造时就能知道的用户 hook 声明。用 WeakMap 挂在实际 Agent\n// 实例上，不把这份纯预览元数据扩成第二个公开 Agent 执行协议。\nconst lifecycleHookCommands = new WeakMap<SandboxAgent, AgentLifecycleHookCommands>();\n/** @internal 为内置 Adapter 登记与实际执行共用的 hook 数组。 */\nexport function registerAgentLifecycleHookCommands<T extends SandboxAgent>(agent: T, postSetup: readonly SandboxCommand[] | undefined, preTeardown: readonly SandboxCommand[] | undefined): T {\n    lifecycleHookCommands.set(agent, {\n        postSetup: Object.freeze([...(postSetup ?? [])]),\n        preTeardown: Object.freeze([...(preTeardown ?? [])]),\n    });\n    return agent;\n}\n/** @internal `niceeval debug` 只读取已登记的声明，不执行 hook。 */\nexport function agentLifecycleHookCommandsOf(agent: SandboxAgent): AgentLifecycleHookCommands | undefined {\n    return lifecycleHookCommands.get(agent);\n}\nconst registeredCleanups = new WeakMap<Sandbox, SandboxCleanupCommand[]>();\n/** Throwable 边界立即收窄；收尾队列不长期保存 `unknown`。 */\nfunction teardownError(value: unknown): Error {\n    return value instanceof Error ? value : new Error(String(value));\n}\n/** 窄上下文与 layer command 同款:不把 session / model / telemetry 借给过程钩子。 */\nfunction commandContext(ctx: AgentContext, agentName: string, phase: \"agent.post-setup\" | \"agent.pre-teardown\", onCleanup: SandboxCommandContext[\"onCleanup\"]): SandboxCommandContext {\n    return {\n        phase,\n        ...(ctx.evalGroup === undefined ? {} : { evalGroup: ctx.evalGroup }),\n        owner: { kind: \"agent\", id: agentName },\n        attempt: ctx.attempt ?? { id: ctx.evalId ?? \"unknown\", index: 0 },\n        signal: ctx.signal,\n        progress: (update) => ctx.progress(update),\n        diagnostic: (input) => ctx.diagnostic(input),\n        facts: (key, value) => ctx.fact(key, value),\n        onCleanup,\n    };\n}\n/**\n * postSetup 时点已走到的沙箱集合——preTeardown 的触发条件(成对触发规则:当且仅当同层 setup\n * 时点走到过)。按 sandbox 实例作键:并发 attempt 共享同一 factory 配置,沙箱是天然的\n * per-attempt 键;WeakSet 随沙箱对象回收,不泄漏。\n */\nconst postSetupPointReached = new WeakSet<Sandbox>();\n/** 按数组顺序执行 postSetup 钩子。调用方在 adapter 全部安装步骤(含 manifest)之后调用一次;\n *  即使数组为空也要调——它同时标记「postSetup 时点走到过」(preTeardown 的触发条件)。 */\nexport async function runPostSetupHooks(sb: Sandbox, ctx: AgentContext, agentName: string, hooks: readonly SandboxCommand[] | undefined): Promise<void> {\n    postSetupPointReached.add(sb);\n    if (!hooks?.length)\n        return;\n    const cleanups = registeredCleanups.get(sb) ?? [];\n    registeredCleanups.set(sb, cleanups);\n    const hookCtx = commandContext(ctx, agentName, \"agent.post-setup\", (cleanup) => cleanups.push(cleanup));\n    const target = createSandboxCommandTarget(sb);\n    for (const hook of hooks)\n        await hook(target, hookCtx);\n}\n/**\n * 按逆序执行 preTeardown 钩子(LIFO 镜像 postSetup)。调用方在各自 `teardown` 方法的最前面\n * 调用一次,先于 agent 自己的收尾步骤。当且仅当本沙箱的 postSetup 时点走到过才执行——\n * adapter setup 在安装步骤中途抛错时,preTeardown 的成对前提不存在,静默跳过。\n */\nexport async function runPreTeardownHooks(sb: Sandbox, ctx: AgentContext, agentName: string, hooks: readonly SandboxCommand[] | undefined): Promise<void> {\n    if (!postSetupPointReached.has(sb))\n        return;\n    const target = createSandboxCommandTarget(sb);\n    const nestedCleanups: SandboxCleanupCommand[] = [];\n    const hookCtx = commandContext(ctx, agentName, \"agent.pre-teardown\", (cleanup) => nestedCleanups.push(cleanup));\n    const cleanupContext: Omit<SandboxCommandContext, \"onCleanup\"> = {\n        phase: \"agent.pre-teardown\",\n        ...(hookCtx.evalGroup === undefined ? {} : { evalGroup: hookCtx.evalGroup }),\n        owner: { kind: \"agent\", id: agentName },\n        attempt: hookCtx.attempt,\n        signal: hookCtx.signal,\n        progress: hookCtx.progress,\n        diagnostic: hookCtx.diagnostic,\n        facts: hookCtx.facts,\n    };\n    const failures: Error[] = [];\n    try {\n        // 收尾链里的单点失败不能剥夺其余 hook 与已登记 cleanup 的执行机会。顺序仍然是\n        // preTeardown 声明的逆序，随后是截至当时所有 onCleanup 的全局逆序。\n        for (const hook of [...(hooks ?? [])].reverse()) {\n            try {\n                await hook(target, hookCtx);\n            }\n            catch (error) {\n                failures.push(teardownError(error));\n            }\n        }\n        for (const cleanup of [...(registeredCleanups.get(sb) ?? []), ...nestedCleanups].reverse()) {\n            try {\n                await cleanup(target, cleanupContext);\n            }\n            catch (error) {\n                failures.push(teardownError(error));\n            }\n        }\n    }\n    finally {\n        registeredCleanups.delete(sb);\n        postSetupPointReached.delete(sb);\n    }\n    if (failures.length === 1)\n        throw failures[0];\n    if (failures.length > 1)\n        throw new AggregateError(failures, `${agentName} preTeardown failed`);\n}\n"]}

package/dist/agents/post-setup.d.cts

@@ -0,0 +1,20 @@
+import type { SandboxCommand } from "../sandbox/commands.cjs";
+import type { Sandbox } from "../sandbox/types.cjs";
+import type { AgentContext, SandboxAgent } from "./types.cjs";
+export interface AgentLifecycleHookCommands {
+    readonly postSetup: readonly SandboxCommand[];
+    readonly preTeardown: readonly SandboxCommand[];
+}
+/** @internal 为内置 Adapter 登记与实际执行共用的 hook 数组。 */
+export declare function registerAgentLifecycleHookCommands<T extends SandboxAgent>(agent: T, postSetup: readonly SandboxCommand[] | undefined, preTeardown: readonly SandboxCommand[] | undefined): T;
+/** @internal `niceeval debug` 只读取已登记的声明，不执行 hook。 */
+export declare function agentLifecycleHookCommandsOf(agent: SandboxAgent): AgentLifecycleHookCommands | undefined;
+/** 按数组顺序执行 postSetup 钩子。调用方在 adapter 全部安装步骤(含 manifest)之后调用一次;
+ *  即使数组为空也要调——它同时标记「postSetup 时点走到过」(preTeardown 的触发条件)。 */
+export declare function runPostSetupHooks(sb: Sandbox, ctx: AgentContext, agentName: string, hooks: readonly SandboxCommand[] | undefined): Promise<void>;
+/**
+ * 按逆序执行 preTeardown 钩子(LIFO 镜像 postSetup)。调用方在各自 `teardown` 方法的最前面
+ * 调用一次,先于 agent 自己的收尾步骤。当且仅当本沙箱的 postSetup 时点走到过才执行——
+ * adapter setup 在安装步骤中途抛错时,preTeardown 的成对前提不存在,静默跳过。
+ */
+export declare function runPreTeardownHooks(sb: Sandbox, ctx: AgentContext, agentName: string, hooks: readonly SandboxCommand[] | undefined): Promise<void>;

package/dist/agents/post-setup.d.mts

@@ -0,0 +1,20 @@
+import type { SandboxCommand } from "../sandbox/commands.mjs";
+import type { Sandbox } from "../sandbox/types.mjs";
+import type { AgentContext, SandboxAgent } from "./types.mjs";
+export interface AgentLifecycleHookCommands {
+    readonly postSetup: readonly SandboxCommand[];
+    readonly preTeardown: readonly SandboxCommand[];
+}
+/** @internal 为内置 Adapter 登记与实际执行共用的 hook 数组。 */
+export declare function registerAgentLifecycleHookCommands<T extends SandboxAgent>(agent: T, postSetup: readonly SandboxCommand[] | undefined, preTeardown: readonly SandboxCommand[] | undefined): T;
+/** @internal `niceeval debug` 只读取已登记的声明，不执行 hook。 */
+export declare function agentLifecycleHookCommandsOf(agent: SandboxAgent): AgentLifecycleHookCommands | undefined;
+/** 按数组顺序执行 postSetup 钩子。调用方在 adapter 全部安装步骤(含 manifest)之后调用一次;
+ *  即使数组为空也要调——它同时标记「postSetup 时点走到过」(preTeardown 的触发条件)。 */
+export declare function runPostSetupHooks(sb: Sandbox, ctx: AgentContext, agentName: string, hooks: readonly SandboxCommand[] | undefined): Promise<void>;
+/**
+ * 按逆序执行 preTeardown 钩子(LIFO 镜像 postSetup)。调用方在各自 `teardown` 方法的最前面
+ * 调用一次,先于 agent 自己的收尾步骤。当且仅当本沙箱的 postSetup 时点走到过才执行——
+ * adapter setup 在安装步骤中途抛错时,preTeardown 的成对前提不存在,静默跳过。
+ */
+export declare function runPreTeardownHooks(sb: Sandbox, ctx: AgentContext, agentName: string, hooks: readonly SandboxCommand[] | undefined): Promise<void>;

package/dist/agents/post-setup.d.ts

@@ -0,0 +1,20 @@
+import type { SandboxCommand } from "../sandbox/commands.js";
+import type { Sandbox } from "../sandbox/types.js";
+import type { AgentContext, SandboxAgent } from "./types.js";
+export interface AgentLifecycleHookCommands {
+    readonly postSetup: readonly SandboxCommand[];
+    readonly preTeardown: readonly SandboxCommand[];
+}
+/** @internal 为内置 Adapter 登记与实际执行共用的 hook 数组。 */
+export declare function registerAgentLifecycleHookCommands<T extends SandboxAgent>(agent: T, postSetup: readonly SandboxCommand[] | undefined, preTeardown: readonly SandboxCommand[] | undefined): T;
+/** @internal `niceeval debug` 只读取已登记的声明，不执行 hook。 */
+export declare function agentLifecycleHookCommandsOf(agent: SandboxAgent): AgentLifecycleHookCommands | undefined;
+/** 按数组顺序执行 postSetup 钩子。调用方在 adapter 全部安装步骤(含 manifest)之后调用一次;
+ *  即使数组为空也要调——它同时标记「postSetup 时点走到过」(preTeardown 的触发条件)。 */
+export declare function runPostSetupHooks(sb: Sandbox, ctx: AgentContext, agentName: string, hooks: readonly SandboxCommand[] | undefined): Promise<void>;
+/**
+ * 按逆序执行 preTeardown 钩子(LIFO 镜像 postSetup)。调用方在各自 `teardown` 方法的最前面
+ * 调用一次,先于 agent 自己的收尾步骤。当且仅当本沙箱的 postSetup 时点走到过才执行——
+ * adapter setup 在安装步骤中途抛错时,preTeardown 的成对前提不存在,静默跳过。
+ */
+export declare function runPreTeardownHooks(sb: Sandbox, ctx: AgentContext, agentName: string, hooks: readonly SandboxCommand[] | undefined): Promise<void>;

package/dist/agents/post-setup.js

@@ -0,0 +1,12 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./post-setup.cjs");
+const __niceevalExport0 = __niceevalCanonical["agentLifecycleHookCommandsOf"];
+export { __niceevalExport0 as agentLifecycleHookCommandsOf };
+const __niceevalExport1 = __niceevalCanonical["registerAgentLifecycleHookCommands"];
+export { __niceevalExport1 as registerAgentLifecycleHookCommands };
+const __niceevalExport2 = __niceevalCanonical["runPostSetupHooks"];
+export { __niceevalExport2 as runPostSetupHooks };
+const __niceevalExport3 = __niceevalCanonical["runPreTeardownHooks"];
+export { __niceevalExport3 as runPreTeardownHooks };
+//# sourceMappingURL=post-setup.js.map

package/dist/agents/post-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-setup.js","sources":[],"names":[],"mappings":""}