niceeval 0.12.1-canary.25 → 0.12.1

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

@@ -1 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-/** 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

@@ -1,5 +0,0 @@
-/** 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.map

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

package/dist/agents/claude-code.cjs

@@ -1,326 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.claudeCodeAgent = claudeCodeAgent;
-exports.installPlugins = installPlugins;
-const coverage_ts_1 = require("../assertions/coverage.cjs");
-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 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 { 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, 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",
-            }),
-        },
-        async setup(sb, ctx) {
-            // 原生配置文件最先落(安装顺序契约的第 1 步):本地读原始字节 → 验 JSON 语法与保留键
-            // → 原样替换沙箱里原本为空的用户级 settings.json。字节 SHA-256 进 manifest 与安装
-            // checkpoint key(见 native-config.ts 的 nativeConfigCheckpointItem)。
-            let settings;
-            if (config?.settingsFile !== undefined) {
-                settings = await (0, native_config_ts_1.loadNativeConfigFile)({
-                    agent: "claude-code",
-                    field: "settingsFile",
-                    path: config.settingsFile,
-                });
-                (0, native_config_ts_1.assertJsonNativeConfig)(settings, {
-                    agent: "claude-code",
-                    field: "settingsFile",
-                    reservedKeys: RESERVED_SETTINGS_KEYS,
-                });
-                await (0, native_config_ts_1.uploadNativeConfigFile)(sb, settings, SETTINGS_PATH);
-            }
-            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);
-        },
-        async teardown(sb, ctx) {
-            // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。
-            // claude-code 目前没有其它收尾步骤,这段就是整个 teardown。
-            await (0, post_setup_ts_1.runPreTeardownHooks)(sb, ctx, "claude-code", config?.preTeardown);
-        },
-        async send(input, ctx) {
-            const sb = ctx.sandbox;
-            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);
-            args.push(input.text);
-            const apiKey = getApiKey();
-            const env = {
-                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(await shared_ts_1.shared.resolveAgentBin(sb, "claude"), args, {
-                env,
-                sensitiveValues: [apiKey],
-                stream: true,
-            });
-            // 「最新 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];
-            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" };
-        },
-    });
-}
-/**
- * 先按 `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

@@ -1 +0,0 @@
-{"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 { 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, loadNativeConfigFile, uploadNativeConfigFile, type LoadedNativeConfig, } from \"./native-config.ts\";\nimport { mapClaudeCodeSpans } from \"../o11y/otlp/mappers/claude-code.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 { runPostSetupHooks, runPreTeardownHooks } from \"./post-setup.ts\";\nimport { createNpmCliInstaller } from \"./npm-staged.ts\";\nimport type { Agent, AgentSetupManifest, McpServer, Sandbox, SkillSpec } 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     * 最多跑几个 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?: McpServer[];\n    /**\n     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。\n     * 落在 project 级 `.claude/skills/<name>/`,claude CLI 原生发现。\n     */\n    skills?: SkillSpec[];\n    /** Claude Code 原生 Plugin(先连 Marketplace,再从中装指定 Plugin)。 */\n    plugins?: 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?: 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?: 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 { 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 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        async setup(sb, ctx) {\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 = await loadNativeConfigFile({\n                    agent: \"claude-code\",\n                    field: \"settingsFile\",\n                    path: config.settingsFile,\n                });\n                assertJsonNativeConfig(settings, {\n                    agent: \"claude-code\",\n                    field: \"settingsFile\",\n                    reservedKeys: RESERVED_SETTINGS_KEYS,\n                });\n                await uploadNativeConfigFile(sb, settings, SETTINGS_PATH);\n            }\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        async teardown(sb, ctx) {\n            // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。\n            // claude-code 目前没有其它收尾步骤,这段就是整个 teardown。\n            await runPreTeardownHooks(sb, ctx, \"claude-code\", config?.preTeardown);\n        },\n        async send(input, ctx) {\n            const sb = ctx.sandbox;\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            args.push(input.text);\n            const apiKey = getApiKey();\n            const env: globalThis.Record<string, string> = {\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(await shared.resolveAgentBin(sb, \"claude\"), args, {\n                env,\n                sensitiveValues: [apiKey],\n                stream: true,\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            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 { events, usage: parsed.usage, status: \"completed\" };\n        },\n    });\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

@@ -1,86 +0,0 @@
-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;
-    /**
-     * 最多跑几个 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?: McpServer[];
-    /**
-     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。
-     * 落在 project 级 `.claude/skills/<name>/`,claude CLI 原生发现。
-     */
-    skills?: SkillSpec[];
-    /** Claude Code 原生 Plugin(先连 Marketplace,再从中装指定 Plugin)。 */
-    plugins?: 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?: SandboxCommand[];
-    /**
-     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤
-     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾
-     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段
-     * 按 teardown-failed 诊断收束。
-     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
-     */
-    preTeardown?: 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;

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

@@ -1,86 +0,0 @@
-import type { Agent, AgentSetupManifest, McpServer, Sandbox, SkillSpec } from "../types.mjs";
-import type { SandboxCommand } from "../sandbox/commands.mjs";
-/**
- * Claude Code 的原生 Plugin —— **只属于 Claude Code**,不能传给 Codex(Codex 有自己的
- * {@link import("./codex.mjs").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;
-    /**
-     * 最多跑几个 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?: McpServer[];
-    /**
-     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。
-     * 落在 project 级 `.claude/skills/<name>/`,claude CLI 原生发现。
-     */
-    skills?: SkillSpec[];
-    /** Claude Code 原生 Plugin(先连 Marketplace,再从中装指定 Plugin)。 */
-    plugins?: 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?: SandboxCommand[];
-    /**
-     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤
-     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾
-     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段
-     * 按 teardown-failed 诊断收束。
-     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
-     */
-    preTeardown?: 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;