niceeval 0.12.2-canary.31 → 0.13.0

package/INDEX.md

@@ -25,9 +25,9 @@
 - `docs-site/zh/tutorials/connect-otel.mdx` — OTel 接入:把应用已有的 OTel span 发送给 NiceEval，在 niceeval view 中查看每轮调用瀑布图。评估用例断言仍以 Send 返回的事件和用量为准。
 - `docs-site/zh/tutorials/connect-your-agent.mdx` — 接入你的 Agent:写一个 Adapter、配置一个 Experiment，并运行第一条评估用例。再把配置和参数从 Experiment 传给 Adapter 与被测应用。
 - `docs-site/zh/tutorials/criteria-files.mdx` — 隐藏测试判分：让判据文件进缓存 fingerprint:用 loadText 在模块顶层读入隐藏测试、跑测脚本等判据文件，文件内容进入 fingerprint：改一字节自动重跑，不靠人工 --rerun。
-- `docs-site/zh/tutorials/custom-reports.mdx` — 编写自定义报告:声明 RecordProjection，把投影结果组织成 Calculation、页面和一次固定的 ReportExecution。
+- `docs-site/zh/tutorials/custom-reports.mdx` — 编写自定义报告:先定义 Analysis 统计口径，再用标准 React JSX 编写可在终端、网页和静态站阅读的 Report。
 - `docs-site/zh/tutorials/dataset-fanout.mdx` — 数据驱动测试（dataset fan-out）：用多份数据运行同一套评估用例:从 .eval.ts 文件导出数组或 keyed record，将一套评估逻辑展开为多个 case。用 loadYaml 或 loadJson 读取外部测试集，并获得稳定 ID。
-- `docs-site/zh/tutorials/deploy-report-site.mdx` — 部署静态报告站:将 view --out 生成的自包含目录部署到任意静态托管服务。
+- `docs-site/zh/tutorials/deploy-report-site.mdx` — 部署静态报告站:将 view --out 生成的完整自包含报告目录部署到任意静态托管服务。
 - `docs-site/zh/tutorials/docker-in-docker.mdx` — 让 Sandbox 使用 Docker:根据任务信任边界选择 Docker socket、raw privileged DinD 或受管 rootless DinD，并为 Agent 准备 Docker CLI 与 daemon。
 - `docs-site/zh/tutorials/eval-groups.mdx` — 用评估组复用 Sandbox:用 defineEvalGroup 显式声明兼容成员：同组按稳定 ID 串行复用一台 Sandbox，不同组继续并行，并把公共准备放到正确的 Sandbox Layer。
 - `docs-site/zh/tutorials/evaluation-kinds.mdx` — 通过制与计分制评估:用 defineEval 与 defineScoreEval 编写通过制和计分制评估，调用即登记 Assertion。
@@ -36,15 +36,15 @@
 - `docs-site/zh/tutorials/handle-execution-failures.mdx` — 在基础设施失败时停止无效运行:读懂自动重试，为确定性故障声明影响范围，修复后继续未完成的评估。
 - `docs-site/zh/tutorials/install-custom-sandbox-agent.mdx` — 为自定义 Sandbox Agent 安装 CLI:用 ensure 和 installer 检查、安装并复检自定义 coding-agent CLI 的精确版本。
 - `docs-site/zh/tutorials/plugins.mdx` — 用 Plugin 组合生命周期:用 definePlugin 为实验、评估组、Sandbox 和评估组合多个生命周期。
-- `docs-site/zh/tutorials/publish-report.mdx` — 发布静态报告:用 view --out 导出一个可离线打开、与源 Record 脱离的自包含报告站。
+- `docs-site/zh/tutorials/publish-report.mdx` — 发布静态报告:用 view --out 导出可离线打开、与源 Record 脱离且包含全部页面的自包含报告站。
 - `docs-site/zh/tutorials/quickstart.mdx` — 为你的 Agent 项目设置评估:安装 NiceEval，写三个文件，10 分钟内对你自己的应用跑通第一条评估用例。
 - `docs-site/zh/tutorials/reporters.mdx` — 将当前运行接入外部系统:使用 Reporter、JUnit 和 receipt 把当前 Invocation 的信息交给外部系统，同时保持 Record 的所有权边界。
 - `docs-site/zh/tutorials/rerun-and-cache.mdx` — 重跑与沿用结果:查看每个 slot 会执行、自动采用还是由操作者接受，并理解这些关系怎样进入 Record。
 - `docs-site/zh/tutorials/sandbox-agent.mdx` — Sandbox Agent：评估 Claude Code、Codex 和 bub:使用 NiceEval 内置 agents 或自定义 adapter，在 Docker 或云端 sandbox 中运行 coding-agent CLI。
 - `docs-site/zh/tutorials/sandbox-providers.mdx` — Sandbox:官方 Sandbox Docker、Vercel 或 E2B Provider。通过预制快照加速评估
 - `docs-site/zh/tutorials/sandbox-reuse.mdx` — 复用 Sandbox：一批评估共用环境，公共准备只付一次:在 Experiment 里声明 sandboxReuse 让多条 Attempt 共用 Sandbox：写对四层生命周期、配好 lifetimeMs。准备代码做不到幂等重放时改用并发，不要复用。
-- `docs-site/zh/tutorials/theming.mdx` — 报告外观与安全边界:理解当前报告宿主的固定样式，以及为什么 Report 不能注入主题文件、CSS 或浏览器代码。
-- `docs-site/zh/tutorials/viewing-results.mdx` — 查看 NiceEval 结果:用 show 或 view 从已发布的 Record 选择 Sample，并查看固定的 ReportExecution。
+- `docs-site/zh/tutorials/theming.mdx` — 报告外观与安全边界:用 Report theme token 调整外观，同时保留唯一的产品 CSS、离线阅读与 View shell 边界。
+- `docs-site/zh/tutorials/viewing-results.mdx` — 查看 NiceEval 结果:用 show 或 view 从已发布的 Record 选择固定 Sample，并读取一个页面或完整报告站。
 - `docs-site/zh/tutorials/write-experiment.mdx` — 实验与生命周期:如何写好实验。选择 Agent、传递 model 和 flags，设置 attempts、预算、并发与 Sandbox，并用 setup / teardown 起停实验级共享服务。
 - `docs-site/zh/tutorials/write-send.mdx` — 编写 Send:分七步编写 Adapter 的 send 函数：发送消息、续接会话、记录用量、映射工具事件、处理人工介入（HITL）、接入 OTel trace，并透传 Experiment flags。
 
@@ -57,8 +57,8 @@
 - `docs-site/zh/explanation/experiment.mdx` — 实验（Experiment）：评谁、怎么跑:Experiment 是可签入的运行配置：同一批评估用例对着哪个 agent、哪个模型、开哪些 flags、跑几次。评估用例与 experiment 分开的原因——晚绑定，让同一份评估用例换着对象跑。
 - `docs-site/zh/explanation/hitl.mdx` — 人工介入（HITL）：停轮、回答、继续:什么是 Human-in-the-loop，Claude Code / Codex / AI SDK 应用里它长什么样。NiceEval 如何把它变成可评的路径——waiting 停轮、input.requested 说明在等什么、t.respond 替人回答后同一轮继续。
 - `docs-site/zh/explanation/judge.mdx` — NiceEval 里的 Judge：评开放式输出:用 t.judge 和 turn.judge 直接登记 Judge Assertion，再在同一 handle 上配置阈值或分数。
-- `docs-site/zh/explanation/overview.mdx` — NiceEval 的评估与报告路径:理解 Experiment、Record、AnalysisSample 与 ReportExecution 如何组成一次可查看、可分享的评估。
-- `docs-site/zh/explanation/record.mdx` — Record：持久事实与报告输入:理解 Record Core、RecordAttachment、完成标识，以及从选择到 ReportExecution 的固定数据路径。
+- `docs-site/zh/explanation/overview.mdx` — NiceEval 的评估与报告路径:理解 Experiment、Record、Analysis 与 Report 如何组成一次可查看、可分享的评估。
+- `docs-site/zh/explanation/record.mdx` — Record：已发布结果:理解 Record 如何保存已发布的 Run，以及如何安全地选择、查看和分享结果。
 - `docs-site/zh/explanation/runner.mdx` — Runner 如何执行评估:了解 Runner 怎样建立 Run、选择执行或采用 Attempt，并返回可供后续读取的 receipt。
 - `docs-site/zh/explanation/tier.mdx` — 接入等级（Tier）：三级投入，三组能力:按「Adapter 接到哪里、额外拿到什么观测数据」接入分三级：Tier 1 只接 send，Tier 2 加 OTel，Tier 3 侵入改造暴露 experiment flags。每档买到什么、什么时候升级。
 
@@ -73,13 +73,13 @@
 - `docs-site/zh/reference/events.mdx` — 标准事件流参考:StreamEvent 的十种事件：每种的字段、什么时候吐、哪些断言消费它。adapter 的核心工作就是产出这条流。
 - `docs-site/zh/reference/expect.mdx` — niceeval/expect Match 参考:niceeval/expect 的纯 Match factory：组合文字、结构、条件，再交给 t.check 登记 Assertion。
 - `docs-site/zh/reference/official-adapters.mdx` — 官方适配器一览:NiceEval 内置的 Sandbox 和非 Sandbox 适配器分别是什么、怎么鉴权，Sandbox 型里怎么装 MCP server、Skill、插件，怎么使用 Agent 官方配置文件。
-- `docs-site/zh/reference/report-components.mdx` — 报告 API:RecordProjection、Calculation、Page、ReportExecution 与静态导出的公开边界。
-- `docs-site/zh/reference/results-data.mdx` — 在 Report 中读取结果数据:通过 niceeval/report 的 AnalysisSample 与官方 opaque projector 声明读取结果。
+- `docs-site/zh/reference/report-components.mdx` — 报告 API:用标准 React JSX、Page 与关闭的 Analysis 值编写终端、网页和静态报告。
+- `docs-site/zh/reference/results-data.mdx` — 在 Report 中读取结果数据:在 Page 或组合组件中用固定 Sample、aggregate() 和具名领域投影读取关闭的 Analysis 结果。
 
 ## `docs-site/zh/troubleshooting/`
 
 - `docs-site/zh/troubleshooting/debug-sandbox.mdx` — 保留 Sandbox 现场排查问题:用 --keep-sandbox 把失败 Attempt 的 Sandbox 保留成可随时唤醒的现场，用 niceeval sandbox enter 进去手动排查，用 sandbox list / stop 查看和清理。
-- `docs-site/zh/troubleshooting/debugging.mdx` — 排查 Record 与报告问题:根据可见错误、Sample 状态、Attachment 状态和 rebuild 反馈，定位查看、重跑与导出问题。
+- `docs-site/zh/troubleshooting/debugging.mdx` — 排查结果与报告问题:根据可见错误、Sample 状态和 rebuild 反馈，定位查看、重跑与导出问题。
 - `docs-site/zh/troubleshooting/recover-after-kill.mdx` — 运行被强杀后恢复:进程被 kill -9、CI 超时或断电杀掉后，重跑同一条命令续跑没跑完的部分，用 niceeval sandbox prune 收回没清理的容器，用 --teardown 补齐实验收尾。
 
 ## `docs-site/zh/examples/`

package/README.md

@@ -173,3 +173,5 @@ This project was inspired by — or had its code learned by AI from — the proj
 
 Thanks to the following communities
 - WIP
+
+We also thank Linux Do for their support and feedback during the project's early development.

package/README.zh.md

@@ -173,3 +173,5 @@ READ https://niceeval.com/INIT.md and set up niceeval for this repo: install it,
 
 感谢下列社区
 - WIP
+
+我们也感谢 Linux Do 在项目早期开发期间给予的支持与反馈。

package/bin/niceeval.js

@@ -14,5 +14,20 @@ const { register: registerEsm } = await import("tsx/esm/api");
 registerCjs();
 registerEsm();
 
+// The CLI is a production renderer even when the caller did not set NODE_ENV.
+// Preload React's production server/runtime branches before the Report graph is
+// imported, then restore the author's environment immediately. This avoids the
+// development JSX validators and element metadata for every static Report node
+// without making NODE_ENV="production" observable to config, report, or eval code.
+if (process.env.NODE_ENV === undefined) {
+  process.env.NODE_ENV = "production";
+  await Promise.all([
+    import("react"),
+    import("react/jsx-runtime"),
+    import("react-dom/server"),
+  ]);
+  delete process.env.NODE_ENV;
+}
+
 const cliUrl = new URL("../dist/cli/bootstrap.cjs", import.meta.url);
 await import(cliUrl.href);

package/dist/agents/claude-code.cjs

@@ -264,7 +264,15 @@ async function installPlugins(sb, plugins) {
             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)}`);
+            const addCommand = `${shared_ts_1.shared.agentBin("claude")} plugin marketplace add ${shared_ts_1.shared.shellQuote(source)}`;
+            let add = await sb.runShell(addCommand);
+            // The native CLI fetches remote marketplace metadata during add. A
+            // transient connection failure must not discard an otherwise reusable
+            // Sandbox, but every retry starts from the same declared empty state.
+            for (let attempt = 1; add.exitCode !== 0 && attempt < 3; attempt += 1) {
+                await dropRegisteredMarketplace(sb, marketplace.name);
+                add = await sb.runShell(addCommand);
+            }
             if (add.exitCode !== 0) {
                 throw new Error((0, index_ts_1.t)("plugin.marketplaceFailed", {
                     agent: "claude-code",

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

@@ -1 +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"]}
+{"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 addCommand = `${shared.agentBin(\"claude\")} plugin marketplace add ${shared.shellQuote(source)}`;\n            let add = await sb.runShell(addCommand);\n            // The native CLI fetches remote marketplace metadata during add. A\n            // transient connection failure must not discard an otherwise reusable\n            // Sandbox, but every retry starts from the same declared empty state.\n            for (let attempt = 1; add.exitCode !== 0 && attempt < 3; attempt += 1) {\n                await dropRegisteredMarketplace(sb, marketplace.name);\n                add = await sb.runShell(addCommand);\n            }\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/post-setup.cjs

@@ -42,7 +42,6 @@ function commandContext(ctx, agentName, phase, onCleanup) {
         signal: ctx.signal,
         progress: (update) => ctx.progress(update),
         diagnostic: (input) => ctx.diagnostic(input),
-        facts: (key, value) => ctx.fact(key, value),
         onCleanup,
     };
 }
@@ -84,7 +83,6 @@ async function runPreTeardownHooks(sb, ctx, agentName, hooks) {
         signal: hookCtx.signal,
         progress: hookCtx.progress,
         diagnostic: hookCtx.diagnostic,
-        facts: hookCtx.facts,
     };
     const failures = [];
     try {

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

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

package/dist/agents/provisioner.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArtifactPrepareCoordinator = exports.SandboxTargetVerificationError = exports.AgentEnsureError = exports.AGENT_ARTIFACT_PREPARE_ACTIVITY = exports.AGENT_VERSION_ACTUAL_FACT = exports.AGENT_ENSURE_FACT = void 0;
+exports.ArtifactPrepareCoordinator = exports.SandboxTargetVerificationError = exports.AgentEnsureError = exports.AGENT_ARTIFACT_PREPARE_ACTIVITY = void 0;
 exports.verifySandboxTargetPlatform = verifySandboxTargetPlatform;
 exports.assertStableAgentIdentity = assertStableAgentIdentity;
 exports.agentInstallIdentityInput = agentInstallIdentityInput;
@@ -20,9 +20,6 @@ const effect_1 = require("effect");
 const index_ts_1 = require("../i18n/index.cjs");
 const operations_ts_1 = require("../sandbox/operations.cjs");
 const content_ts_1 = require("../sandbox/content.cjs");
-/** attempt facts:`agent.ensure` / `agent.version.actual`。 */
-exports.AGENT_ENSURE_FACT = "agent.ensure";
-exports.AGENT_VERSION_ACTUAL_FACT = "agent.version.actual";
 /** Run 级开放 activity key;落盘形状由 Record timing 线拥有。 */
 exports.AGENT_ARTIFACT_PREPARE_ACTIVITY = "agent.artifact.prepare";
 /** Runner 的 agent.ensure 失败通道；attempt 层只消费这一种具名 ADT。 */
@@ -225,7 +222,7 @@ class ArtifactPrepareCoordinator {
     }
     prepareArtifact(installer, platform, signal, cacheKey) {
         const prepared = effect_1.Effect.tryPromise({
-            // Node >=22 的 AbortSignal.any 保留数组中第一个已中断 signal 的 reason。
+            // Node 24 的 AbortSignal.any 保留数组中第一个已中断 signal 的 reason。
             // 调用方 signal 排在前面，Effect runtime signal 则确保 fiber interruption 能取消 SDK Promise。
             try: (runtimeSignal) => Promise.resolve(installer.prepareArtifact({
                 targetPlatform: platform,
@@ -288,7 +285,6 @@ function runAgentEnsure(ensures, installers, sandbox, context) {
                 if (ensure.progress?.ready !== undefined) {
                     context.progress({ message: ensure.progress.ready });
                 }
-                reportFacts(context.fact, "hit");
                 results.push({ outcome: "hit", identity: ensure.identity });
                 continue;
             }
@@ -382,16 +378,10 @@ function runAgentEnsure(ensures, installers, sandbox, context) {
                     targetPlatform: platform,
                 });
             }
-            reportFacts(context.fact, "installed");
         }
         return results;
     });
 }
-function reportFacts(fact, outcome, actualVersion) {
-    fact(exports.AGENT_ENSURE_FACT, outcome);
-    if (actualVersion !== undefined)
-        fact(exports.AGENT_VERSION_ACTUAL_FACT, actualVersion);
-}
 function sameIdentity(a, b) {
     return a.agent === b.agent && a.version === b.version && a.revision === b.revision;
 }
@@ -404,7 +394,6 @@ function probeMatches(ensure, sandbox, context, phase) {
             signal: context.signal,
             progress: context.progress,
             diagnostic: () => { },
-            facts: () => { },
             onCleanup: () => { },
         })).then(() => true),
         catch: (cause) => cause,