niceeval 0.12.1 → 0.12.2-canary.31

package/dist/agents/builtin.d.ts

@@ -0,0 +1,2 @@
+import type { Agent } from "../types.js";
+export declare const BUILTIN_AGENTS: readonly Agent[];

package/dist/agents/builtin.js

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

package/dist/agents/builtin.js.map

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

package/dist/agents/cache-marker.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_DOCKERFILE_CACHE_SAFE = void 0;
+/** Internal-only marker; this module is intentionally not re-exported by any package entrypoint. */
+exports.AGENT_DOCKERFILE_CACHE_SAFE = Symbol("niceeval.agent.dockerfile-cache-safe");
+//# sourceMappingURL=cache-marker.cjs.map

package/dist/agents/cache-marker.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-marker.js","sourceRoot":"","sources":["cache-marker.ts"],"names":[],"mappings":";;;AAAA,oGAAoG;AACvF,QAAA,2BAA2B,GAAkB,MAAM,CAAC,sCAAsC,CAAC,CAAC","sourcesContent":["/** Internal-only marker; this module is intentionally not re-exported by any package entrypoint. */\nexport const AGENT_DOCKERFILE_CACHE_SAFE: unique symbol = Symbol(\"niceeval.agent.dockerfile-cache-safe\");\nexport interface DockerfileAgentCacheSafeInstaller {\n    readonly [AGENT_DOCKERFILE_CACHE_SAFE]: true;\n}\n"]}

package/dist/agents/cache-marker.d.cts

@@ -0,0 +1,5 @@
+/** Internal-only marker; this module is intentionally not re-exported by any package entrypoint. */
+export declare const AGENT_DOCKERFILE_CACHE_SAFE: unique symbol;
+export interface DockerfileAgentCacheSafeInstaller {
+    readonly [AGENT_DOCKERFILE_CACHE_SAFE]: true;
+}

package/dist/agents/cache-marker.d.mts

@@ -0,0 +1,5 @@
+/** Internal-only marker; this module is intentionally not re-exported by any package entrypoint. */
+export declare const AGENT_DOCKERFILE_CACHE_SAFE: unique symbol;
+export interface DockerfileAgentCacheSafeInstaller {
+    readonly [AGENT_DOCKERFILE_CACHE_SAFE]: true;
+}

package/dist/agents/cache-marker.js

@@ -1,2 +1,6 @@
-/** Internal-only marker; this module is intentionally not re-exported by any package entrypoint. */
-export const AGENT_DOCKERFILE_CACHE_SAFE = Symbol("niceeval.agent.dockerfile-cache-safe");
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./cache-marker.cjs");
+const __niceevalExport0 = __niceevalCanonical["AGENT_DOCKERFILE_CACHE_SAFE"];
+export { __niceevalExport0 as AGENT_DOCKERFILE_CACHE_SAFE };
+//# sourceMappingURL=cache-marker.js.map

package/dist/agents/cache-marker.js.map

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

package/dist/agents/claude-code.cjs

@@ -0,0 +1,372 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeCodeAgent = claudeCodeAgent;
+exports.installPlugins = installPlugins;
+const coverage_ts_1 = require("../assertions/coverage.cjs");
+const effect_1 = require("effect");
+const define_ts_1 = require("../define.cjs");
+const util_ts_1 = require("../util.cjs");
+const shared_ts_1 = require("./shared.cjs");
+const skills_ts_1 = require("./skills.cjs");
+const marketplace_ts_1 = require("./marketplace.cjs");
+const native_config_ts_1 = require("./native-config.cjs");
+const claude_code_ts_1 = require("../o11y/otlp/mappers/claude-code.cjs");
+const command_projection_ts_1 = require("../o11y/command-projection.cjs");
+const index_ts_1 = require("../i18n/index.cjs");
+const coding_cli_versions_ts_1 = require("./coding-cli-versions.cjs");
+const mcp_ts_1 = require("./mcp.cjs");
+const post_setup_ts_1 = require("./post-setup.cjs");
+const npm_staged_ts_1 = require("./npm-staged.cjs");
+const send_failures_ts_1 = require("../context/send-failures.cjs");
+// ───────────────────────────────────────────────────────────────────────────
+// Claude Code 的 agent adapter(沙箱型)。
+//
+// 连接方式:在沙箱里 spawn `claude` CLI,跑完读回 transcript JSONL → 标准事件流。
+// 扩展(skill / plugin / MCP)全部是构造参数,setup 里翻译成 Claude Code 的原生形态,
+// 装完写一份 manifest(见 docs/feature/adapters/architecture/coding-agent-extensions.md)。
+// ───────────────────────────────────────────────────────────────────────────
+/** Claude Code 的 skill 目录(project 级):CLI 原生扫描它,不需要额外的发现指引。 */
+const SKILL_DIR = ".claude/skills";
+/** 沙箱里用户级 settings 的落点:`settingsFile` 的原始字节原样替换这份原本为空的用户层。 */
+const SETTINGS_PATH = "~/.claude/settings.json";
+/**
+ * `settingsFile` 的保留键:`model` 归 experiment(经 `--model` flag),`env` 归 Adapter
+ * (鉴权与 OTel 导出经进程环境变量注入)。清单定稿见 docs/feature/adapters/sdk/claude-code/README.md。
+ */
+const RESERVED_SETTINGS_KEYS = ["model", "env"];
+function claudeCodeAgent(config) {
+    const getApiKey = () => config?.apiKey ?? (0, util_ts_1.requireEnv)("ANTHROPIC_API_KEY");
+    const getBaseUrl = () => config?.baseUrl ?? (0, util_ts_1.getEnv)("ANTHROPIC_BASE_URL");
+    const agentEnv = Object.freeze({ ...(config?.env ?? {}) });
+    const agentEnvSensitiveValues = Object.freeze(Object.values(agentEnv));
+    const { ensure, installer } = (0, npm_staged_ts_1.createNpmCliInstaller)({
+        identity: {
+            agent: "claude-code",
+            version: coding_cli_versions_ts_1.DEFAULT_CLAUDE_CODE_CLI_VERSION,
+            revision: String(coding_cli_versions_ts_1.AGENT_BASELINE_RECIPE_REVISION["claude-code"]),
+        },
+        packageName: "@anthropic-ai/claude-code",
+        bin: "claude",
+    });
+    return (0, post_setup_ts_1.registerAgentLifecycleHookCommands)((0, define_ts_1.defineSandboxAgent)({
+        name: "claude-code",
+        // 官方 adapter:transcript 经生命周期 fixture 验证,全通道 complete。
+        evidenceCoverage: coverage_ts_1.completeEvidenceCoverage,
+        spanMapper: claude_code_ts_1.mapClaudeCodeSpans,
+        ensure,
+        installers: [installer],
+        // claude CLI 原生 OTLP trace spans(beta):interaction / llm_request / tool 层级,
+        // 需要 CLAUDE_CODE_ENHANCED_TELEMETRY_BETA 开关。
+        tracing: {
+            protocol: "http/protobuf",
+            env: (endpoint) => ({
+                CLAUDE_CODE_ENABLE_TELEMETRY: "1",
+                CLAUDE_CODE_ENHANCED_TELEMETRY_BETA: "1",
+                OTEL_TRACES_EXPORTER: "otlp",
+                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,
+                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: "http/protobuf",
+                // CLI 是短命进程:压短导出间隔,别让 span 死在退出前的批处理队列里。
+                OTEL_TRACES_EXPORT_INTERVAL: "1000",
+            }),
+        },
+        setup: (sb, ctx) => effect_1.Effect.runPromise(effect_1.Effect.scoped(effect_1.Effect.gen(function* () {
+            // 原生配置文件最先落(安装顺序契约的第 1 步):本地读原始字节 → 验 JSON 语法与保留键
+            // → 原样替换沙箱里原本为空的用户级 settings.json。字节 SHA-256 进 manifest 与安装
+            // checkpoint key(见 native-config.ts 的 nativeConfigCheckpointItem)。
+            let settings;
+            if (config?.settingsFile !== undefined) {
+                settings = yield* (0, native_config_ts_1.loadNativeConfigFileEffect)({
+                    agent: "claude-code",
+                    field: "settingsFile",
+                    path: config.settingsFile,
+                });
+                yield* effect_1.Effect.try({
+                    try: () => (0, native_config_ts_1.assertJsonNativeConfig)(settings, {
+                        agent: "claude-code",
+                        field: "settingsFile",
+                        reservedKeys: RESERVED_SETTINGS_KEYS,
+                    }),
+                    catch: (cause) => cause,
+                });
+                yield* (0, native_config_ts_1.uploadNativeConfigFileEffect)(sb, settings, SETTINGS_PATH);
+            }
+            yield* effect_1.Effect.tryPromise({
+                try: async () => {
+                    if (config?.mcpServers?.length) {
+                        (0, mcp_ts_1.assertMcpServers)(config.mcpServers);
+                        const servers = {};
+                        const sensitiveValues = [];
+                        for (const s of config.mcpServers) {
+                            if ((0, mcp_ts_1.isHttpMcp)(s)) {
+                                const headers = s.headers;
+                                if (headers)
+                                    sensitiveValues.push(...Object.values(headers));
+                                servers[s.name] = {
+                                    type: "http",
+                                    url: s.url,
+                                    ...(headers && Object.keys(headers).length && { headers }),
+                                };
+                            }
+                            else {
+                                const env = s.env;
+                                if (env)
+                                    sensitiveValues.push(...Object.values(env));
+                                servers[s.name] = {
+                                    command: s.command,
+                                    ...(s.args?.length && { args: s.args }),
+                                    ...(env && { env }),
+                                };
+                            }
+                        }
+                        // 用户级 MCP 配置在 ~/.claude.json(顶层 mcpServers 字段),不是 ~/.claude/claude.json
+                        // ——后者 claude CLI 根本不读,MCP 静默挂不上(本机 `claude mcp list` 可核对)。
+                        await shared_ts_1.shared.writeFile(sb, "~/.claude.json", JSON.stringify({ mcpServers: servers }, null, 2), { sensitiveValues });
+                    }
+                    const manifest = { skills: [] };
+                    if (config?.skills?.length) {
+                        manifest.skills = await (0, skills_ts_1.installSkills)(sb, config.skills, { dir: SKILL_DIR });
+                    }
+                    if (config?.plugins?.length) {
+                        manifest.nativePlugins = await installPlugins(sb, config.plugins);
+                    }
+                    if (config?.mcpServers?.length) {
+                        // manifest 里只记「挂了哪个 server、怎么连」;env / headers 里可能有 token,不落盘。
+                        manifest.mcpServers = (0, mcp_ts_1.mcpManifestEntries)(config.mcpServers);
+                    }
+                    if (settings) {
+                        // 只记来源路径与字节哈希,不落正文(任意官方配置都可能带敏感字符串)。
+                        manifest.nativeConfigFile = { agent: "claude-code", path: settings.path, sha256: settings.sha256 };
+                    }
+                    // 什么都没装就不写 manifest:空 artifact 不落文件(同 results 的落盘规则)。
+                    if (manifest.skills.length ||
+                        manifest.nativePlugins?.length ||
+                        manifest.mcpServers?.length ||
+                        manifest.nativeConfigFile) {
+                        ctx.reportSetup(manifest);
+                    }
+                    // 安装后钩子(postSetup):排在 manifest 之后——manifest 审计 Adapter 自身的安装事实,
+                    // 钩子失败不该丢掉这份证据。
+                    await (0, post_setup_ts_1.runPostSetupHooks)(sb, ctx, "claude-code", config?.postSetup);
+                },
+                catch: (cause) => cause,
+            });
+        })), { signal: ctx.signal }),
+        async teardown(sb, ctx) {
+            // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。
+            // claude-code 目前没有其它收尾步骤,这段就是整个 teardown。
+            await (0, post_setup_ts_1.runPreTeardownHooks)(sb, ctx, "claude-code", config?.preTeardown);
+        },
+        send: (input, ctx) => effect_1.Effect.runPromise(effect_1.Effect.scoped(effect_1.Effect.gen(function* () {
+            const sb = ctx.sandbox;
+            const claudeBin = yield* (0, npm_staged_ts_1.resolveAgentBinEffect)(sb, "claude");
+            return yield* effect_1.Effect.tryPromise({
+                try: async (signal) => {
+                    const args = ["--print", "--dangerously-skip-permissions"];
+                    if (ctx.model)
+                        args.push("--model", ctx.model);
+                    if (config?.maxTurns != null)
+                        args.push("--max-turns", String(config.maxTurns));
+                    if (ctx.flags.webResearch)
+                        args.push("--allowedTools", "WebSearch,WebFetch");
+                    if (ctx.session.id)
+                        args.push("--resume", ctx.session.id);
+                    // --allowedTools is variadic in Claude Code. Terminate option parsing so the
+                    // positional prompt cannot be consumed as one more allowed tool name.
+                    args.push("--", input.text);
+                    const apiKey = getApiKey();
+                    const env = {
+                        ...agentEnv,
+                        ANTHROPIC_API_KEY: apiKey,
+                        // Eval runs must not silently change CLI version after the sandbox artifact was built.
+                        DISABLE_AUTOUPDATER: "1",
+                        ...ctx.telemetry?.env,
+                    };
+                    const baseUrl = getBaseUrl();
+                    if (baseUrl)
+                        env["ANTHROPIC_BASE_URL"] = baseUrl;
+                    const res = await sb.runCommand(claudeBin, args, {
+                        env,
+                        sensitiveValues: [apiKey, ...agentEnvSensitiveValues],
+                        stream: true,
+                        signal,
+                    });
+                    // 「最新 jsonl」而非按 session id 精确定位:--resume 会 fork 新 session id 的新文件,
+                    // 精确匹配旧 id 会读到过期 transcript。send 串行,最新的一定是刚跑完的这次。
+                    const raw = await shared_ts_1.shared.captureLatestJsonl(sb, "~/.claude/projects");
+                    ctx.session.capture(shared_ts_1.shared.sessionIdFromClaudeTranscript(raw));
+                    const parsed = shared_ts_1.shared.parseClaudeCode(raw);
+                    const events = [...parsed.events];
+                    let turnEvidenceCoverage;
+                    if (!raw?.trim()) {
+                        const reason = "Claude Code transcript 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 Claude Code 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: "completed",
+                        ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),
+                    };
+                },
+                catch: (cause) => cause,
+            });
+        })), { signal: ctx.signal }),
+    }), config?.postSetup, config?.preTeardown);
+}
+/**
+ * 先按 `marketplace.name` 建立 Marketplace 连接(同名只连一次,add 后回读注册列表校验
+ * 名字真的注册上了),再从该连接装指定 Plugin。
+ * `claude plugin marketplace add` 没有钉 ref 的入口,所以要钉 ref 时先自己按 ref clone 下来,
+ * 再以本地路径连接(CLI 支持 path 形态的 marketplace 源)—— 「来源必须可复现」不因 CLI 少个
+ * flag 就打折。
+ *
+ * 注册类命令是追加式的,而 Sandbox 复用下沙箱带着上一条 attempt 的 `$HOME` 进场,所以每一步
+ * 先读沙箱真实状态、把它收敛到声明,再执行 add / install(契约见 docs/feature/adapters/
+ * architecture/coding-agent-extensions.md「安装收敛:不假设沙箱空白」)。空白沙箱读回为空,
+ * 走的是同一条代码路径。
+ */
+async function installPlugins(sb, plugins) {
+    const connected = new Set();
+    const out = [];
+    // 摘除顺序固定「先卸完全部同名插件、后摘 marketplace」:插件按 `<plugin>@<marketplace>` 定位,
+    // 注册先没了就定位不到残留的那份安装。整体先于安装循环执行,多个插件共用一个 marketplace
+    // 时第二个插件的残留才摘得到。
+    for (const plugin of plugins) {
+        await uninstallPlugins(sb, plugin.name);
+    }
+    for (const plugin of plugins) {
+        const { marketplace } = plugin;
+        if (!connected.has(marketplace.name)) {
+            await dropRegisteredMarketplace(sb, marketplace.name);
+            const source = marketplace.ref
+                ? await (0, skills_ts_1.cloneRepo)(sb, marketplace.source, marketplace.ref)
+                : marketplace.source;
+            const add = await sb.runShell(`${shared_ts_1.shared.agentBin("claude")} plugin marketplace add ${shared_ts_1.shared.shellQuote(source)}`);
+            if (add.exitCode !== 0) {
+                throw new Error((0, index_ts_1.t)("plugin.marketplaceFailed", {
+                    agent: "claude-code",
+                    name: marketplace.name,
+                    source: marketplace.source,
+                    ref: marketplace.ref ?? "(default)",
+                    tail: outputTail(add),
+                }));
+            }
+            // add 静默按目标仓库 manifest 的 name 注册,错名会拖到 plugin install 才炸;
+            // 回读注册列表立刻校验(契约与真机复现见 marketplace.ts 顶部说明)。
+            await (0, marketplace_ts_1.verifyMarketplaceName)(sb, {
+                agent: "claude-code",
+                listCommand: "claude plugin marketplace list --json",
+                marketplace,
+                knownNames: connected,
+            });
+            connected.add(marketplace.name);
+        }
+        const id = `${plugin.name}@${marketplace.name}`;
+        const install = await sb.runShell(`${shared_ts_1.shared.agentBin("claude")} plugin install ${shared_ts_1.shared.shellQuote(id)}`);
+        if (install.exitCode !== 0) {
+            throw new Error((0, index_ts_1.t)("plugin.installFailed", {
+                agent: "claude-code",
+                name: plugin.name,
+                marketplace: marketplace.name,
+                tail: outputTail(install),
+            }));
+        }
+        const resolvedVersion = await installedVersion(sb, id);
+        out.push({
+            agent: "claude-code",
+            marketplace: {
+                name: marketplace.name,
+                source: marketplace.source,
+                ...(marketplace.ref !== undefined ? { ref: marketplace.ref } : {}),
+            },
+            name: plugin.name,
+            ...(resolvedVersion !== undefined ? { resolvedVersion } : {}),
+        });
+    }
+    return out;
+}
+function claudeInstalledPlugins(stdout) {
+    let raw;
+    try {
+        raw = JSON.parse(stdout);
+    }
+    catch {
+        return undefined;
+    }
+    if (!Array.isArray(raw))
+        return undefined;
+    return raw.filter((item) => !!item && typeof item === "object");
+}
+/**
+ * 与声明同名的 Plugin 已安装就先卸载(不论它出自哪个 marketplace),让本条 attempt 的安装与
+ * manifest 里的解析版本同源。claude 对已装的 plugin 重装是空操作(`Plugin "…" is already
+ * installed`,真机 2.1.220),不先卸就等于把上一条 attempt 装出的内容记成本条的安装事实。
+ */
+async function uninstallPlugins(sb, name) {
+    const listCommand = "claude plugin list --json";
+    const res = await sb.runShell(`${shared_ts_1.shared.agentBin("claude")} plugin list --json`);
+    const list = res.exitCode === 0 ? claudeInstalledPlugins(res.stdout) : undefined;
+    if (list === undefined) {
+        throw new Error((0, index_ts_1.t)("plugin.listFailed", { agent: "claude-code", command: listCommand, tail: outputTail(res) }));
+    }
+    const targets = new Map();
+    for (const entry of list) {
+        const id = entry.id;
+        if (!id || id.split("@")[0] !== name)
+            continue;
+        targets.set(`${id} ${entry.scope ?? ""}`, { id, ...(entry.scope ? { scope: entry.scope } : {}) });
+    }
+    for (const target of targets.values()) {
+        const scopeFlag = target.scope ? ` --scope ${shared_ts_1.shared.shellQuote(target.scope)}` : "";
+        const remove = await sb.runShell(`${shared_ts_1.shared.agentBin("claude")} plugin uninstall ${shared_ts_1.shared.shellQuote(target.id)}${scopeFlag}`);
+        if (remove.exitCode !== 0) {
+            throw new Error((0, index_ts_1.t)("plugin.removeFailed", { agent: "claude-code", name: target.id, tail: outputTail(remove) }));
+        }
+    }
+}
+/**
+ * 按声明名字无条件摘除同名 marketplace 注册,再由调用方按声明的 source(必要时是按 ref clone
+ * 出的本地路径)重新 add。不比对来源等价性、也不以注册在回读列表里可见为前提(与 codex 侧
+ * 同一条收敛规则,机制见 codex.ts 的 dropRegisteredMarketplace 注释):claude 对已注册的名字
+ * 直接复用磁盘上那份(`Marketplace '…' already on disk`,真机 2.1.220),声明的来源根本不生效,
+ * 不先摘干净就是静默陈旧。「本就没有可摘的」(`not found`,exit 1)按已收敛处理;
+ * 摘除不带 `--scope`,按 CLI 默认摘掉所有 scope 里的声明。
+ */
+async function dropRegisteredMarketplace(sb, name) {
+    await sb.runShell(`${shared_ts_1.shared.agentBin("claude")} plugin marketplace remove ${shared_ts_1.shared.shellQuote(name)}`);
+}
+/** 装完回读版本;取不到不阻断安装(manifest 里 resolvedVersion 省略)。 */
+async function installedVersion(sb, id) {
+    const res = await sb.runShell(`${shared_ts_1.shared.agentBin("claude")} plugin list --json`);
+    if (res.exitCode !== 0)
+        return undefined;
+    return claudeInstalledPlugins(res.stdout)?.find((p) => p.id === id)?.version;
+}
+function outputTail(res, n = 12) {
+    return (res.stdout + res.stderr).trim().split("\n").slice(-n).join("\n");
+}
+exports.default = claudeCodeAgent();
+//# sourceMappingURL=claude-code.cjs.map

package/dist/agents/claude-code.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["claude-code.ts"],"names":[],"mappings":"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","sourcesContent":["import { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport { Effect } from \"effect\";\nimport { defineSandboxAgent } from \"../define.ts\";\nimport { requireEnv, getEnv } from \"../util.ts\";\nimport { shared } from \"./shared.ts\";\nimport { cloneRepo, installSkills } from \"./skills.ts\";\nimport { verifyMarketplaceName } from \"./marketplace.ts\";\nimport { assertJsonNativeConfig, loadNativeConfigFileEffect, uploadNativeConfigFileEffect, type LoadedNativeConfig, } from \"./native-config.ts\";\nimport { mapClaudeCodeSpans } from \"../o11y/otlp/mappers/claude-code.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\nimport { t } from \"../i18n/index.ts\";\nimport { DEFAULT_CLAUDE_CODE_CLI_VERSION, AGENT_BASELINE_RECIPE_REVISION } from \"./coding-cli-versions.ts\";\nimport { assertMcpServers, isHttpMcp, mcpManifestEntries } from \"./mcp.ts\";\nimport { registerAgentLifecycleHookCommands, runPostSetupHooks, runPreTeardownHooks, } from \"./post-setup.ts\";\nimport { createNpmCliInstaller, resolveAgentBinEffect } from \"./npm-staged.ts\";\nimport type { Agent, AgentSetupManifest, McpServer, Sandbox, SkillSpec, TurnEvidenceCoverage } from \"../types.ts\";\nimport type { SandboxCommand } from \"../sandbox/commands.ts\";\nimport { makeSendFailure, sendAcceptanceFromEvents } from \"../context/send-failures.ts\";\n// ───────────────────────────────────────────────────────────────────────────\n// Claude Code 的 agent adapter(沙箱型)。\n//\n// 连接方式:在沙箱里 spawn `claude` CLI,跑完读回 transcript JSONL → 标准事件流。\n// 扩展(skill / plugin / MCP)全部是构造参数,setup 里翻译成 Claude Code 的原生形态,\n// 装完写一份 manifest(见 docs/feature/adapters/architecture/coding-agent-extensions.md)。\n// ───────────────────────────────────────────────────────────────────────────\n/** Claude Code 的 skill 目录(project 级):CLI 原生扫描它,不需要额外的发现指引。 */\nconst SKILL_DIR = \".claude/skills\";\n/** 沙箱里用户级 settings 的落点:`settingsFile` 的原始字节原样替换这份原本为空的用户层。 */\nconst SETTINGS_PATH = \"~/.claude/settings.json\";\n/**\n * `settingsFile` 的保留键:`model` 归 experiment(经 `--model` flag),`env` 归 Adapter\n * (鉴权与 OTel 导出经进程环境变量注入)。清单定稿见 docs/feature/adapters/sdk/claude-code/README.md。\n */\nconst RESERVED_SETTINGS_KEYS = [\"model\", \"env\"] as const;\n/**\n * Claude Code 的原生 Plugin —— **只属于 Claude Code**,不能传给 Codex(Codex 有自己的\n * {@link import(\"./codex.ts\").CodexPluginSpec})。每一项同时声明 Marketplace 连接和其中的 Plugin 名:\n * 连上 Marketplace 不等于启用它的全部 Plugin。\n */\nexport interface ClaudeCodePluginSpec {\n    marketplace: {\n        /** 目标仓库 manifest 声明的真实 name；CLI 不支持由调用方另取连接别名。 */\n        name: string;\n        /** Marketplace 来源:GitHub `owner/repo`、Git URL 或路径。 */\n        source: string;\n        /** 固定 Marketplace 的 Tag、Commit 或 Branch;给了就先按 ref clone 下来再以本地路径连接。 */\n        ref?: string;\n    };\n    /** Marketplace 中的 Plugin 名。 */\n    name: string;\n}\nexport interface ClaudeCodeConfig {\n    /** Anthropic API key。省略时读 ANTHROPIC_API_KEY env。 */\n    apiKey?: string;\n    /**\n     * 自定义 API base URL(代理 / 内网端点)。省略时读 ANTHROPIC_BASE_URL env;\n     * 两者都没有则用 Anthropic 官方端点(claude CLI 默认行为)。\n     */\n    baseUrl?: string;\n    /**\n     * Extra process environment for Claude Code. Values stay private runtime data and do not enter carry identity.\n     * Mirror behavior-changing non-secret values into Experiment flags or the owning Plugin identity.\n     */\n    env?: Readonly<globalThis.Record<string, string>>;\n    /**\n     * 最多跑几个 tool-use 轮次(→ `--max-turns`)。\n     * 控制评估用例成本上限;省略时用 CLI 原生默认(无限制)。\n     */\n    maxTurns?: number;\n    /**\n     * 额外 MCP server(每个 Sandbox setup 时写进用户级 ~/.claude.json)。\n     * stdio 形态写 command(可带 args / env);Streamable HTTP 形态写 url(可带 headers,\n     * 逐字进请求头),落成 { \"type\": \"http\", \"url\": …, \"headers\": … } 条目。\n     */\n    mcpServers?: readonly McpServer[];\n    /**\n     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。\n     * 落在 project 级 `.claude/skills/<name>/`,claude CLI 原生发现。\n     */\n    skills?: readonly SkillSpec[];\n    /** Claude Code 原生 Plugin(先连 Marketplace,再从中装指定 Plugin)。 */\n    plugins?: readonly ClaudeCodePluginSpec[];\n    /**\n     * 一份完整的 Claude Code `settings.json`(官方格式)在本地项目里的路径 —— 相对运行\n     * niceeval 的项目根(含 `niceeval.config.ts` 的目录)解析,不是 Sandbox 内路径;只接受\n     * 项目根内的相对路径,包含 `..` 的路径、绝对路径、`~` 路径和解析后逃出项目根的符号链接\n     * 都在 setup 阶段报错。原始字节原样上传为 Sandbox 里原本为空的用户级 `~/.claude/settings.json`\n     * (不继承宿主机配置、不拼接、不重新序列化);保留键 `model` 与 `env` 出现在文件里\n     * setup 报错。manifest 只记项目相对路径与字节 SHA-256,不落正文。\n     */\n    settingsFile?: string;\n    /**\n     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在写 settings、挂 MCP、\n     * 装 Skills / Plugin、写 manifest 全部完成后执行,适合跑插件自带的 setup 脚本这类\n     * 「安装产物就位后才能跑」的过程动作。抛错按基础设施错误计(attempt errored)。\n     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。\n     */\n    postSetup?: readonly SandboxCommand[];\n    /**\n     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤\n     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾\n     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段\n     * 按 teardown-failed 诊断收束。\n     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。\n     */\n    preTeardown?: readonly SandboxCommand[];\n}\nexport function claudeCodeAgent(config?: ClaudeCodeConfig): Agent {\n    const getApiKey = () => config?.apiKey ?? requireEnv(\"ANTHROPIC_API_KEY\");\n    const getBaseUrl = () => config?.baseUrl ?? getEnv(\"ANTHROPIC_BASE_URL\");\n    const agentEnv = Object.freeze({ ...(config?.env ?? {}) });\n    const agentEnvSensitiveValues = Object.freeze(Object.values(agentEnv));\n    const { ensure, installer } = createNpmCliInstaller({\n        identity: {\n            agent: \"claude-code\",\n            version: DEFAULT_CLAUDE_CODE_CLI_VERSION,\n            revision: String(AGENT_BASELINE_RECIPE_REVISION[\"claude-code\"]),\n        },\n        packageName: \"@anthropic-ai/claude-code\",\n        bin: \"claude\",\n    });\n    return registerAgentLifecycleHookCommands(defineSandboxAgent({\n        name: \"claude-code\",\n        // 官方 adapter:transcript 经生命周期 fixture 验证,全通道 complete。\n        evidenceCoverage: completeEvidenceCoverage,\n        spanMapper: mapClaudeCodeSpans,\n        ensure,\n        installers: [installer],\n        // claude CLI 原生 OTLP trace spans(beta):interaction / llm_request / tool 层级,\n        // 需要 CLAUDE_CODE_ENHANCED_TELEMETRY_BETA 开关。\n        tracing: {\n            protocol: \"http/protobuf\",\n            env: (endpoint) => ({\n                CLAUDE_CODE_ENABLE_TELEMETRY: \"1\",\n                CLAUDE_CODE_ENHANCED_TELEMETRY_BETA: \"1\",\n                OTEL_TRACES_EXPORTER: \"otlp\",\n                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,\n                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: \"http/protobuf\",\n                // CLI 是短命进程:压短导出间隔,别让 span 死在退出前的批处理队列里。\n                OTEL_TRACES_EXPORT_INTERVAL: \"1000\",\n            }),\n        },\n        setup: (sb, ctx) => Effect.runPromise(Effect.scoped(Effect.gen(function* () {\n            // 原生配置文件最先落(安装顺序契约的第 1 步):本地读原始字节 → 验 JSON 语法与保留键\n            // → 原样替换沙箱里原本为空的用户级 settings.json。字节 SHA-256 进 manifest 与安装\n            // checkpoint key(见 native-config.ts 的 nativeConfigCheckpointItem)。\n            let settings: LoadedNativeConfig | undefined;\n            if (config?.settingsFile !== undefined) {\n                settings = yield* loadNativeConfigFileEffect({\n                    agent: \"claude-code\",\n                    field: \"settingsFile\",\n                    path: config.settingsFile,\n                });\n                yield* Effect.try({\n                    try: () => assertJsonNativeConfig(settings!, {\n                        agent: \"claude-code\",\n                        field: \"settingsFile\",\n                        reservedKeys: RESERVED_SETTINGS_KEYS,\n                    }),\n                    catch: (cause) => cause,\n                });\n                yield* uploadNativeConfigFileEffect(sb, settings, SETTINGS_PATH);\n            }\n            yield* Effect.tryPromise({\n                try: async () => {\n                    if (config?.mcpServers?.length) {\n                        assertMcpServers(config.mcpServers);\n                        const servers: globalThis.Record<string, object> = {};\n                        const sensitiveValues: string[] = [];\n                        for (const s of config.mcpServers) {\n                            if (isHttpMcp(s)) {\n                                const headers = s.headers;\n                                if (headers)\n                                    sensitiveValues.push(...Object.values(headers));\n                                servers[s.name] = {\n                                    type: \"http\",\n                                    url: s.url,\n                                    ...(headers && Object.keys(headers).length && { headers }),\n                                };\n                            }\n                            else {\n                                const env = s.env;\n                                if (env)\n                                    sensitiveValues.push(...Object.values(env));\n                                servers[s.name] = {\n                                    command: s.command,\n                                    ...(s.args?.length && { args: s.args }),\n                                    ...(env && { env }),\n                                };\n                            }\n                        }\n                        // 用户级 MCP 配置在 ~/.claude.json(顶层 mcpServers 字段),不是 ~/.claude/claude.json\n                        // ——后者 claude CLI 根本不读,MCP 静默挂不上(本机 `claude mcp list` 可核对)。\n                        await shared.writeFile(sb, \"~/.claude.json\", JSON.stringify({ mcpServers: servers }, null, 2), { sensitiveValues });\n                    }\n                    const manifest: AgentSetupManifest = { skills: [] };\n                    if (config?.skills?.length) {\n                        manifest.skills = await installSkills(sb, config.skills, { dir: SKILL_DIR });\n                    }\n                    if (config?.plugins?.length) {\n                        manifest.nativePlugins = await installPlugins(sb, config.plugins);\n                    }\n                    if (config?.mcpServers?.length) {\n                        // manifest 里只记「挂了哪个 server、怎么连」;env / headers 里可能有 token,不落盘。\n                        manifest.mcpServers = mcpManifestEntries(config.mcpServers);\n                    }\n                    if (settings) {\n                        // 只记来源路径与字节哈希,不落正文(任意官方配置都可能带敏感字符串)。\n                        manifest.nativeConfigFile = { agent: \"claude-code\", path: settings.path, sha256: settings.sha256 };\n                    }\n                    // 什么都没装就不写 manifest:空 artifact 不落文件(同 results 的落盘规则)。\n                    if (manifest.skills.length ||\n                        manifest.nativePlugins?.length ||\n                        manifest.mcpServers?.length ||\n                        manifest.nativeConfigFile) {\n                        ctx.reportSetup(manifest);\n                    }\n                    // 安装后钩子(postSetup):排在 manifest 之后——manifest 审计 Adapter 自身的安装事实,\n                    // 钩子失败不该丢掉这份证据。\n                    await runPostSetupHooks(sb, ctx, \"claude-code\", config?.postSetup);\n                },\n                catch: (cause) => cause,\n            });\n        })), { signal: ctx.signal }),\n        async teardown(sb, ctx) {\n            // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。\n            // claude-code 目前没有其它收尾步骤,这段就是整个 teardown。\n            await runPreTeardownHooks(sb, ctx, \"claude-code\", config?.preTeardown);\n        },\n        send: (input, ctx) => Effect.runPromise(Effect.scoped(Effect.gen(function* () {\n            const sb = ctx.sandbox;\n            const claudeBin = yield* resolveAgentBinEffect(sb, \"claude\");\n            return yield* Effect.tryPromise({\n                try: async (signal) => {\n                    const args = [\"--print\", \"--dangerously-skip-permissions\"];\n                    if (ctx.model)\n                        args.push(\"--model\", ctx.model);\n                    if (config?.maxTurns != null)\n                        args.push(\"--max-turns\", String(config.maxTurns));\n                    if (ctx.flags.webResearch)\n                        args.push(\"--allowedTools\", \"WebSearch,WebFetch\");\n                    if (ctx.session.id)\n                        args.push(\"--resume\", ctx.session.id);\n                    // --allowedTools is variadic in Claude Code. Terminate option parsing so the\n                    // positional prompt cannot be consumed as one more allowed tool name.\n                    args.push(\"--\", input.text);\n                    const apiKey = getApiKey();\n                    const env: globalThis.Record<string, string> = {\n                        ...agentEnv,\n                        ANTHROPIC_API_KEY: apiKey,\n                        // Eval runs must not silently change CLI version after the sandbox artifact was built.\n                        DISABLE_AUTOUPDATER: \"1\",\n                        ...ctx.telemetry?.env,\n                    };\n                    const baseUrl = getBaseUrl();\n                    if (baseUrl)\n                        env[\"ANTHROPIC_BASE_URL\"] = baseUrl;\n                    const res = await sb.runCommand(claudeBin, args, {\n                        env,\n                        sensitiveValues: [apiKey, ...agentEnvSensitiveValues],\n                        stream: true,\n                        signal,\n                    });\n                    // 「最新 jsonl」而非按 session id 精确定位:--resume 会 fork 新 session id 的新文件,\n                    // 精确匹配旧 id 会读到过期 transcript。send 串行,最新的一定是刚跑完的这次。\n                    const raw = await shared.captureLatestJsonl(sb, \"~/.claude/projects\");\n                    ctx.session.capture(shared.sessionIdFromClaudeTranscript(raw));\n                    const parsed = shared.parseClaudeCode(raw);\n                    const events = [...parsed.events];\n                    let turnEvidenceCoverage: TurnEvidenceCoverage | undefined;\n                    if (!raw?.trim()) {\n                        const reason = \"Claude Code transcript 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 Claude Code 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: \"completed\" as const,\n                        ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),\n                    };\n                },\n                catch: (cause) => cause,\n            });\n        })), { signal: ctx.signal }),\n    }), config?.postSetup, config?.preTeardown);\n}\n/**\n * 先按 `marketplace.name` 建立 Marketplace 连接(同名只连一次,add 后回读注册列表校验\n * 名字真的注册上了),再从该连接装指定 Plugin。\n * `claude plugin marketplace add` 没有钉 ref 的入口,所以要钉 ref 时先自己按 ref clone 下来,\n * 再以本地路径连接(CLI 支持 path 形态的 marketplace 源)—— 「来源必须可复现」不因 CLI 少个\n * flag 就打折。\n *\n * 注册类命令是追加式的,而 Sandbox 复用下沙箱带着上一条 attempt 的 `$HOME` 进场,所以每一步\n * 先读沙箱真实状态、把它收敛到声明,再执行 add / install(契约见 docs/feature/adapters/\n * architecture/coding-agent-extensions.md「安装收敛:不假设沙箱空白」)。空白沙箱读回为空,\n * 走的是同一条代码路径。\n */\nexport async function installPlugins(sb: Sandbox, plugins: readonly ClaudeCodePluginSpec[]): Promise<NonNullable<AgentSetupManifest[\"nativePlugins\"]>> {\n    const connected = new Set<string>();\n    const out: NonNullable<AgentSetupManifest[\"nativePlugins\"]> = [];\n    // 摘除顺序固定「先卸完全部同名插件、后摘 marketplace」:插件按 `<plugin>@<marketplace>` 定位,\n    // 注册先没了就定位不到残留的那份安装。整体先于安装循环执行,多个插件共用一个 marketplace\n    // 时第二个插件的残留才摘得到。\n    for (const plugin of plugins) {\n        await uninstallPlugins(sb, plugin.name);\n    }\n    for (const plugin of plugins) {\n        const { marketplace } = plugin;\n        if (!connected.has(marketplace.name)) {\n            await dropRegisteredMarketplace(sb, marketplace.name);\n            const source = marketplace.ref\n                ? await cloneRepo(sb, marketplace.source, marketplace.ref)\n                : marketplace.source;\n            const add = await sb.runShell(`${shared.agentBin(\"claude\")} plugin marketplace add ${shared.shellQuote(source)}`);\n            if (add.exitCode !== 0) {\n                throw new Error(t(\"plugin.marketplaceFailed\", {\n                    agent: \"claude-code\",\n                    name: marketplace.name,\n                    source: marketplace.source,\n                    ref: marketplace.ref ?? \"(default)\",\n                    tail: outputTail(add),\n                }));\n            }\n            // add 静默按目标仓库 manifest 的 name 注册,错名会拖到 plugin install 才炸;\n            // 回读注册列表立刻校验(契约与真机复现见 marketplace.ts 顶部说明)。\n            await verifyMarketplaceName(sb, {\n                agent: \"claude-code\",\n                listCommand: \"claude plugin marketplace list --json\",\n                marketplace,\n                knownNames: connected,\n            });\n            connected.add(marketplace.name);\n        }\n        const id = `${plugin.name}@${marketplace.name}`;\n        const install = await sb.runShell(`${shared.agentBin(\"claude\")} plugin install ${shared.shellQuote(id)}`);\n        if (install.exitCode !== 0) {\n            throw new Error(t(\"plugin.installFailed\", {\n                agent: \"claude-code\",\n                name: plugin.name,\n                marketplace: marketplace.name,\n                tail: outputTail(install),\n            }));\n        }\n        const resolvedVersion = await installedVersion(sb, id);\n        out.push({\n            agent: \"claude-code\",\n            marketplace: {\n                name: marketplace.name,\n                source: marketplace.source,\n                ...(marketplace.ref !== undefined ? { ref: marketplace.ref } : {}),\n            },\n            name: plugin.name,\n            ...(resolvedVersion !== undefined ? { resolvedVersion } : {}),\n        });\n    }\n    return out;\n}\n/**\n * `claude plugin list --json` 的已安装条目:`[{ id: \"<plugin>@<marketplace>\", version, scope, … }]`\n * (真机核对 claude 2.1.220)。同一个 plugin 可以在 user / project / local 多个 scope 各有一条,\n * 卸载要带上条目自己的 scope。抠不出(非 JSON / 未知形状)返回 undefined,由调用方决定放行还是抛错。\n */\ninterface ClaudeInstalledPlugin {\n    id?: string;\n    version?: string;\n    scope?: string;\n}\nfunction claudeInstalledPlugins(stdout: string): ClaudeInstalledPlugin[] | undefined {\n    let raw: unknown;\n    try {\n        raw = JSON.parse(stdout);\n    }\n    catch {\n        return undefined;\n    }\n    if (!Array.isArray(raw))\n        return undefined;\n    return raw.filter((item): item is ClaudeInstalledPlugin => !!item && typeof item === \"object\");\n}\n/**\n * 与声明同名的 Plugin 已安装就先卸载(不论它出自哪个 marketplace),让本条 attempt 的安装与\n * manifest 里的解析版本同源。claude 对已装的 plugin 重装是空操作(`Plugin \"…\" is already\n * installed`,真机 2.1.220),不先卸就等于把上一条 attempt 装出的内容记成本条的安装事实。\n */\nasync function uninstallPlugins(sb: Sandbox, name: string): Promise<void> {\n    const listCommand = \"claude plugin list --json\";\n    const res = await sb.runShell(`${shared.agentBin(\"claude\")} plugin list --json`);\n    const list = res.exitCode === 0 ? claudeInstalledPlugins(res.stdout) : undefined;\n    if (list === undefined) {\n        throw new Error(t(\"plugin.listFailed\", { agent: \"claude-code\", command: listCommand, tail: outputTail(res) }));\n    }\n    const targets = new Map<string, {\n        id: string;\n        scope?: string;\n    }>();\n    for (const entry of list) {\n        const id = entry.id;\n        if (!id || id.split(\"@\")[0] !== name)\n            continue;\n        targets.set(`${id} ${entry.scope ?? \"\"}`, { id, ...(entry.scope ? { scope: entry.scope } : {}) });\n    }\n    for (const target of targets.values()) {\n        const scopeFlag = target.scope ? ` --scope ${shared.shellQuote(target.scope)}` : \"\";\n        const remove = await sb.runShell(`${shared.agentBin(\"claude\")} plugin uninstall ${shared.shellQuote(target.id)}${scopeFlag}`);\n        if (remove.exitCode !== 0) {\n            throw new Error(t(\"plugin.removeFailed\", { agent: \"claude-code\", name: target.id, tail: outputTail(remove) }));\n        }\n    }\n}\n/**\n * 按声明名字无条件摘除同名 marketplace 注册,再由调用方按声明的 source(必要时是按 ref clone\n * 出的本地路径)重新 add。不比对来源等价性、也不以注册在回读列表里可见为前提(与 codex 侧\n * 同一条收敛规则,机制见 codex.ts 的 dropRegisteredMarketplace 注释):claude 对已注册的名字\n * 直接复用磁盘上那份(`Marketplace '…' already on disk`,真机 2.1.220),声明的来源根本不生效,\n * 不先摘干净就是静默陈旧。「本就没有可摘的」(`not found`,exit 1)按已收敛处理;\n * 摘除不带 `--scope`,按 CLI 默认摘掉所有 scope 里的声明。\n */\nasync function dropRegisteredMarketplace(sb: Sandbox, name: string): Promise<void> {\n    await sb.runShell(`${shared.agentBin(\"claude\")} plugin marketplace remove ${shared.shellQuote(name)}`);\n}\n/** 装完回读版本;取不到不阻断安装(manifest 里 resolvedVersion 省略)。 */\nasync function installedVersion(sb: Sandbox, id: string): Promise<string | undefined> {\n    const res = await sb.runShell(`${shared.agentBin(\"claude\")} plugin list --json`);\n    if (res.exitCode !== 0)\n        return undefined;\n    return claudeInstalledPlugins(res.stdout)?.find((p) => p.id === id)?.version;\n}\nfunction outputTail(res: {\n    stdout: string;\n    stderr: string;\n}, n = 12): string {\n    return (res.stdout + res.stderr).trim().split(\"\\n\").slice(-n).join(\"\\n\");\n}\nexport default claudeCodeAgent();\n"]}

package/dist/agents/claude-code.d.cts

@@ -0,0 +1,91 @@
+import type { Agent, AgentSetupManifest, McpServer, Sandbox, SkillSpec } from "../types.cjs";
+import type { SandboxCommand } from "../sandbox/commands.cjs";
+/**
+ * Claude Code 的原生 Plugin —— **只属于 Claude Code**,不能传给 Codex(Codex 有自己的
+ * {@link import("./codex.cjs").CodexPluginSpec})。每一项同时声明 Marketplace 连接和其中的 Plugin 名:
+ * 连上 Marketplace 不等于启用它的全部 Plugin。
+ */
+export interface ClaudeCodePluginSpec {
+    marketplace: {
+        /** 目标仓库 manifest 声明的真实 name；CLI 不支持由调用方另取连接别名。 */
+        name: string;
+        /** Marketplace 来源:GitHub `owner/repo`、Git URL 或路径。 */
+        source: string;
+        /** 固定 Marketplace 的 Tag、Commit 或 Branch;给了就先按 ref clone 下来再以本地路径连接。 */
+        ref?: string;
+    };
+    /** Marketplace 中的 Plugin 名。 */
+    name: string;
+}
+export interface ClaudeCodeConfig {
+    /** Anthropic API key。省略时读 ANTHROPIC_API_KEY env。 */
+    apiKey?: string;
+    /**
+     * 自定义 API base URL(代理 / 内网端点)。省略时读 ANTHROPIC_BASE_URL env;
+     * 两者都没有则用 Anthropic 官方端点(claude CLI 默认行为)。
+     */
+    baseUrl?: string;
+    /**
+     * Extra process environment for Claude Code. Values stay private runtime data and do not enter carry identity.
+     * Mirror behavior-changing non-secret values into Experiment flags or the owning Plugin identity.
+     */
+    env?: Readonly<globalThis.Record<string, string>>;
+    /**
+     * 最多跑几个 tool-use 轮次(→ `--max-turns`)。
+     * 控制评估用例成本上限;省略时用 CLI 原生默认(无限制)。
+     */
+    maxTurns?: number;
+    /**
+     * 额外 MCP server(每个 Sandbox setup 时写进用户级 ~/.claude.json)。
+     * stdio 形态写 command(可带 args / env);Streamable HTTP 形态写 url(可带 headers,
+     * 逐字进请求头),落成 { "type": "http", "url": …, "headers": … } 条目。
+     */
+    mcpServers?: readonly McpServer[];
+    /**
+     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。
+     * 落在 project 级 `.claude/skills/<name>/`,claude CLI 原生发现。
+     */
+    skills?: readonly SkillSpec[];
+    /** Claude Code 原生 Plugin(先连 Marketplace,再从中装指定 Plugin)。 */
+    plugins?: readonly ClaudeCodePluginSpec[];
+    /**
+     * 一份完整的 Claude Code `settings.json`(官方格式)在本地项目里的路径 —— 相对运行
+     * niceeval 的项目根(含 `niceeval.config.ts` 的目录)解析,不是 Sandbox 内路径;只接受
+     * 项目根内的相对路径,包含 `..` 的路径、绝对路径、`~` 路径和解析后逃出项目根的符号链接
+     * 都在 setup 阶段报错。原始字节原样上传为 Sandbox 里原本为空的用户级 `~/.claude/settings.json`
+     * (不继承宿主机配置、不拼接、不重新序列化);保留键 `model` 与 `env` 出现在文件里
+     * setup 报错。manifest 只记项目相对路径与字节 SHA-256,不落正文。
+     */
+    settingsFile?: string;
+    /**
+     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在写 settings、挂 MCP、
+     * 装 Skills / Plugin、写 manifest 全部完成后执行,适合跑插件自带的 setup 脚本这类
+     * 「安装产物就位后才能跑」的过程动作。抛错按基础设施错误计(attempt errored)。
+     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
+     */
+    postSetup?: readonly SandboxCommand[];
+    /**
+     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤
+     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾
+     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段
+     * 按 teardown-failed 诊断收束。
+     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
+     */
+    preTeardown?: readonly SandboxCommand[];
+}
+export declare function claudeCodeAgent(config?: ClaudeCodeConfig): Agent;
+/**
+ * 先按 `marketplace.name` 建立 Marketplace 连接(同名只连一次,add 后回读注册列表校验
+ * 名字真的注册上了),再从该连接装指定 Plugin。
+ * `claude plugin marketplace add` 没有钉 ref 的入口,所以要钉 ref 时先自己按 ref clone 下来,
+ * 再以本地路径连接(CLI 支持 path 形态的 marketplace 源)—— 「来源必须可复现」不因 CLI 少个
+ * flag 就打折。
+ *
+ * 注册类命令是追加式的,而 Sandbox 复用下沙箱带着上一条 attempt 的 `$HOME` 进场,所以每一步
+ * 先读沙箱真实状态、把它收敛到声明,再执行 add / install(契约见 docs/feature/adapters/
+ * architecture/coding-agent-extensions.md「安装收敛:不假设沙箱空白」)。空白沙箱读回为空,
+ * 走的是同一条代码路径。
+ */
+export declare function installPlugins(sb: Sandbox, plugins: readonly ClaudeCodePluginSpec[]): Promise<NonNullable<AgentSetupManifest["nativePlugins"]>>;
+declare const _default: Agent;
+export default _default;