niceeval 0.13.2-canary.35 → 0.13.2

package/INDEX.md

@@ -10,23 +10,43 @@
 
 随包文档目前只有中文。不要为了找英文版而去抓官网或 GitHub——那里的页面可能对应另一个版本，「另一个版本的英文页」比「当前版本的中文页」更危险。中文页读起来没有障碍就直接读；与用户交流仍用用户的语言。
 
+## 帮用户跑通实验
+
+1. **先确认目标和边界。** 读用户项目的 README、依赖、被测入口和现有 NiceEval 文件，确认要评什么真实用例、被测应用怎样启动、使用哪个 Agent / Sandbox / Judge，以及允许的时间和费用。不要用「你好」式占位题代替真实用例；付费模型、全量 benchmark 或批量重跑先征得用户同意。
+2. **只读完成当前步骤需要的文档。** 从下面的树进入 `agent-onboarding` 或 `quickstart`，再按被测对象选择一页接入教程；需要精确字段或命令时补读一页 Reference。不要一次加载整站，也不要凭记忆发明 API。
+3. **先建立最小闭环。** Adapter 连接真实被测入口，Experiment 明确选择评估用例与运行条件，评估用例覆盖一个有代表性的真实任务。先运行 `niceeval exp list`，再用 `niceeval exp <experiment> <eval> --dry` 核对选择、模型、Attempt 数和结果沿用；生命周期或 Sandbox 不明确时用 `niceeval debug <experiment> <eval>` 查看静态计划。
+4. **小范围真实运行。** 先跑一条评估用例、一个 Experiment 和足够证明链路的最小 Attempt 数；需要时给预算与并发加保护。保留完成反馈中的 `runIds`，用 `niceeval show --run <run-id>` 验证结果、分母和诊断，而不是只看进程退出码。
+5. **交付可复现结果。** 告诉用户新增或修改了哪些文件、实际运行了什么命令、Run ID、通过/失败/不可用状态和下一步。没有真实运行就明确说明，不把 `--dry`、typecheck 或配置发现说成实验已经跑通。
+
+## 发现并解决问题
+
+1. **从公开入口收集证据。** 选择问题对应的固定 Run；先用 `show --run` 看覆盖、Verdict 和 diagnostics，再从页面给出的 Attempt locator 用 `show @<locator>` 下钻 Assertion、Judge、工具调用、用量、时间和文件变化。不要直接读取或修改 `.niceeval/` 私有文件。
+2. **先分类，再修改。** 选择或发现错误查 `exp list` 与 `--dry`；Plugin、Sandbox、Agent、Fixture 顺序查 `debug`；基础设施和保留现场查 Troubleshooting；Judge 不可用先验证模型、密钥和端点；`failed` 才表示断言未满足，`errored`、`skipped`、`not-dispatched` 与 `unavailable` 不能当成零分或普通失败。
+3. **修产生错误的那一层。** 被测应用行为错就修应用；事件或用量映射错就修 Adapter；题意或判据错就修评估用例；Provider、凭据或生命周期错就修运行配置。不要通过放松断言、伪造事件或改历史 Record 让结果变绿。
+4. **只复验受影响范围。** 修改后重复同一条精确选择命令。默认结果沿用会跳过身份仍匹配的结果；需要重验失败项用 `--rerun`，需要重验全部选中位置才用 `--rerun all`。只有在身份变化但历史证据经人工核对仍然有效时，才用 `niceeval accept` 明确发布新的采用 Run。
+5. **闭环验证。** 用新 Run ID 再次查看固定分母，确认原 diagnostic 消失且没有新增错误；需要比较修复前后时，把两个明确 Run ID 一起交给 `show` 或 `view`，不要用「最新」代替实验边界。
+
 <!-- GENERATED:BEGIN bundled-docs-tree -->
 
 <!-- 本文件是构建产物(pnpm run build:index),勿手改:树区文案改对应页面的 frontmatter title/description,导语改 INDEX.template.md(生成逻辑见 scripts/generate-reference.ts) -->
 
 ## `docs-site/zh/tutorials/`
 
+- `docs-site/zh/tutorials/accept-results.mdx` — 审阅并采用历史 Attempt:从 --dry 取得候选 locator，核对不可变 Attempt，再用 niceeval accept 原子采用明确结果，并用新 Run ID 验证分母与来源。
 - `docs-site/zh/tutorials/agent-feedback-loop.mdx` — 让 Coding Agent 根据结果迭代:让 Coding Agent 读取 receipt 的 runIds，再用 show 或 view 查看已发布 Record 中的结果。
-- `docs-site/zh/tutorials/agent-onboarding.mdx` — Coding Agent 从零接入项目:给 Coding Agent 的完整接入流程：探索项目、与用户确认路径、配置 Judge、写出 Adapter / Experiment / 评估用例并跑通第一个实验。
+- `docs-site/zh/tutorials/agent-onboarding.mdx` — Coding Agent 从零接入项目:给 Coding Agent 的完整接入流程：探索项目、与用户确认路径、配置 Judge、写出 Adapter、Experiment 与评估用例，并跑通第一个实验。
 - `docs-site/zh/tutorials/authoring.mdx` — 编写评估用例: 单轮、多轮和测试集模式:用 defineEval 编写评估用例，包括单轮对话、多轮对话、数据驱动测试、Sandbox Workspace 和评估的生命周期与 Fixture。
 - `docs-site/zh/tutorials/ci-integration.mdx` — 在 CI 中运行 NiceEval:让 CI 使用退出状态判定门禁，保留最后的 receipt，并向平台提供 JUnit 文件。
+- `docs-site/zh/tutorials/compare-runs.mdx` — 比较多个固定 Run:用明确 Run ID 固定比较分母，核对结果覆盖，再比较通过率、得分、成本与时长，而不让新结果改变已打开的比较。
 - `docs-site/zh/tutorials/concurrency.mdx` — 调好并发：吞吐、共享状态与固定执行顺序:全局并发位和实验自己的 maxConcurrency 是两级并发限制。这一页说明各自管什么、共享状态怎么串行、执行顺序怎么固定，以及多开一个终端为什么能加速。
 - `docs-site/zh/tutorials/configuration.mdx` — 把配置和密钥各放到该放的地方:跑几次、超时、并发、judge 这些值写进代码的哪一层，API key 和 provider token 用哪些环境变量。
 - `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/control-run-cost.mdx` — 控制一次运行的成本:用 attempts、首过即停、budget、并发和结果沿用分别控制统计样本、停止派发、花费保护与资源占用。
 - `docs-site/zh/tutorials/criteria-files.mdx` — 隐藏测试判分：让判据文件进缓存 fingerprint:用 loadText 在模块顶层读入隐藏测试、跑测脚本等判据文件，文件内容进入 fingerprint：改一字节自动重跑，不靠人工 --rerun。
 - `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/debug-lifecycle-plan.mdx` — 运行前检查生命周期计划:用 niceeval debug 查看一个 Experiment 与评估用例配对的 Plugin、Sandbox、Agent、Fixture 和 teardown 顺序，而不创建任何运行资源。
 - `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。
@@ -44,7 +64,9 @@
 - `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/select-and-preview.mdx` — 选择并预览运行范围:先列出 Experiment，再用路径、评估用例前缀和 tag 收窄范围，最后用 --dry 确认计划后再花费模型与 Sandbox 成本。
 - `docs-site/zh/tutorials/theming.mdx` — 报告外观与安全边界:用 Report theme token 调整外观，同时保留唯一的产品 CSS、离线阅读与 View shell 边界。
+- `docs-site/zh/tutorials/verify-judge.mdx` — 配置并验证 Judge:连接 OpenAI 兼容 Judge 网关，用一条最小评估真实预检和判分，再从结果区分配置缺失、网络失败与低质量输出。
 - `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。
@@ -81,7 +103,7 @@
 
 - `docs-site/zh/troubleshooting/debug-sandbox.mdx` — 保留 Sandbox 现场排查问题:用 --keep-sandbox 把失败 Attempt 的 Sandbox 保留成可随时唤醒的现场，用 niceeval sandbox enter 进去手动排查，用 sandbox list / stop 查看和清理。
 - `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/troubleshooting/recover-after-kill.mdx` — 运行被强杀后恢复:进程被 kill -9、CI 超时或断电杀掉后，从已发布结果重跑、收回遗留 Sandbox、补齐实验收尾，并显式恢复共享状态租约。
 
 ## `docs-site/zh/examples/`
 

package/dist/agents/bub-install-spec.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BUB_INSTALL_MARKER = exports.BUB_CHECKPOINT_SUBDIRS = exports.DEFAULT_BUB_REQUIREMENT = exports.DEFAULT_BUB_OTEL_PLUGIN = void 0;
+exports.BUB_INSTALL_MARKER = exports.BUB_CHECKPOINT_SUBDIRS = exports.DEFAULT_BUB_DEPENDENCY_OVERRIDES = exports.DEFAULT_BUB_REQUIREMENT = exports.DEFAULT_BUB_OTEL_PLUGIN = void 0;
 exports.bubRequirement = bubRequirement;
 exports.normalizeBubPackages = normalizeBubPackages;
 exports.bubInstallSpec = bubInstallSpec;
@@ -17,6 +17,16 @@ const coding_cli_versions_ts_1 = require("./coding-cli-versions.cjs");
 exports.DEFAULT_BUB_OTEL_PLUGIN = "git+https://github.com/bubbuild/bub-contrib.git@34715077877041b21472dcca39d91529296a1a9e#subdirectory=packages/bub-tapestore-otel";
 /** 装哪一版 Bub：`uv tool install` 的 requirement，版本单源在 `coding-cli-versions.ts`。 */
 exports.DEFAULT_BUB_REQUIREMENT = bubRequirement(coding_cli_versions_ts_1.DEFAULT_BUB_VERSION);
+/**
+ * Bub 0.4.0 的上游 lockfile 所验证的模型客户端闭包。
+ *
+ * Bub 自己的 PyPI metadata 没有限定这两个传递依赖；若只钉 `bub==0.4.0`，每次安装仍会
+ * 解析当天最新的客户端，使同一实验在没有配置变更时改变请求协议。
+ */
+exports.DEFAULT_BUB_DEPENDENCY_OVERRIDES = [
+    "any-llm-sdk==1.17.0",
+    "openai==2.31.0",
+];
 exports.BUB_CHECKPOINT_SUBDIRS = [".local"];
 exports.BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-hash";
 /**
@@ -31,12 +41,16 @@ function bubRequirement(version) {
 function normalizeBubPackages(packages) {
     return [...new Set(packages.map((value) => value.trim()).filter(Boolean))].sort();
 }
-function bubInstallSpec(packages, requirement = exports.DEFAULT_BUB_REQUIREMENT, otelPlugin = exports.DEFAULT_BUB_OTEL_PLUGIN) {
+function bubInstallSpec(packages, requirement = exports.DEFAULT_BUB_REQUIREMENT, otelPlugin = exports.DEFAULT_BUB_OTEL_PLUGIN, dependencyOverrides = []) {
     const normalized = normalizeBubPackages(packages);
     const plugins = normalized.length ? ` --with ${normalized.join(" --with ")}` : "";
-    return `${requirement} --with ${otelPlugin}${plugins} --checkpoint(${exports.BUB_CHECKPOINT_SUBDIRS.join(",")})`;
+    const overrides = dependencyOverrides.length ? ` --overrides ${dependencyOverrides.join(" ")}` : "";
+    return `${requirement}${overrides} --with ${otelPlugin}${plugins} --checkpoint(${exports.BUB_CHECKPOINT_SUBDIRS.join(",")})`;
 }
-function bubInstallHash(packages, requirement = exports.DEFAULT_BUB_REQUIREMENT, otelPlugin = exports.DEFAULT_BUB_OTEL_PLUGIN) {
-    return (0, node_crypto_1.createHash)("md5").update(bubInstallSpec(packages, requirement, otelPlugin)).digest("hex").slice(0, 12);
+function bubInstallHash(packages, requirement = exports.DEFAULT_BUB_REQUIREMENT, otelPlugin = exports.DEFAULT_BUB_OTEL_PLUGIN, dependencyOverrides = []) {
+    return (0, node_crypto_1.createHash)("md5")
+        .update(bubInstallSpec(packages, requirement, otelPlugin, dependencyOverrides))
+        .digest("hex")
+        .slice(0, 12);
 }
 //# sourceMappingURL=bub-install-spec.cjs.map

package/dist/agents/bub-install-spec.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bub-install-spec.js","sourceRoot":"","sources":["bub-install-spec.ts"],"names":[],"mappings":";;;AAoBA,wCAEC;AACD,oDAEC;AACD,wCAIC;AACD,wCAEC;AAjCD,6CAAyC;AACzC,qEAA+D;AAC/D;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,mIAAmI,CAAC;AAC3K,+EAA+E;AAClE,QAAA,uBAAuB,GAAG,cAAc,CAAC,4CAAmB,CAAC,CAAC;AAC9D,QAAA,sBAAsB,GAAG,CAAC,QAAQ,CAAU,CAAC;AAC7C,QAAA,kBAAkB,GAAG,wCAAwC,CAAC;AAC3E;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC1C,OAAO,QAAQ,OAAO,EAAE,CAAC;AAC7B,CAAC;AACD,SAAgB,oBAAoB,CAAC,QAA2B;IAC5D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtF,CAAC;AACD,SAAgB,cAAc,CAAC,QAA2B,EAAE,WAAW,GAAG,+BAAuB,EAAE,UAAU,GAAG,+BAAuB;IACnI,MAAM,UAAU,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,OAAO,GAAG,WAAW,WAAW,UAAU,GAAG,OAAO,iBAAiB,8BAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAC7G,CAAC;AACD,SAAgB,cAAc,CAAC,QAA2B,EAAE,WAAW,GAAG,+BAAuB,EAAE,UAAU,GAAG,+BAAuB;IACnI,OAAO,IAAA,wBAAU,EAAC,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClH,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { DEFAULT_BUB_VERSION } from \"./coding-cli-versions.ts\";\n/**\n * Bub 的 OTel tape store 插件——时间轨的来源。插件不发 PyPI，git 依赖是唯一安装方式。\n *\n * 插件与 Bub 的 tape 协议同代:这个 pin(bub-contrib#53 之后)从 `bub.tape` 取类型，\n * 要求 Bub ≥ 0.3.10;更早的 pin 按 republic 的类型校验，配 Bub ≤ 0.3.9。配错代不会安装失败，\n * 而是 span 全被拒、时间轨静默为空(台账见 memory/bub-tapestore-otel-tapeentry-drift.md)。\n */\nexport const DEFAULT_BUB_OTEL_PLUGIN = \"git+https://github.com/bubbuild/bub-contrib.git@34715077877041b21472dcca39d91529296a1a9e#subdirectory=packages/bub-tapestore-otel\";\n/** 装哪一版 Bub：`uv tool install` 的 requirement，版本单源在 `coding-cli-versions.ts`。 */\nexport const DEFAULT_BUB_REQUIREMENT = bubRequirement(DEFAULT_BUB_VERSION);\nexport const BUB_CHECKPOINT_SUBDIRS = [\".local\"] as const;\nexport const BUB_INSTALL_MARKER = \".local/share/niceeval/bub-install-hash\";\n/**\n * PyPI requirement for a pinned Bub version.\n *\n * 这行同时是安装用的 uv override:OTel 插件所在 workspace 把 `bub` 声明成 git 依赖，\n * 不覆盖的话每次安装都会去拉 Bub 主干,版本失控。\n */\nexport function bubRequirement(version: string): string {\n    return `bub==${version}`;\n}\nexport function normalizeBubPackages(packages: readonly string[]): string[] {\n    return [...new Set(packages.map((value) => value.trim()).filter(Boolean))].sort();\n}\nexport function bubInstallSpec(packages: readonly string[], requirement = DEFAULT_BUB_REQUIREMENT, otelPlugin = DEFAULT_BUB_OTEL_PLUGIN): string {\n    const normalized = normalizeBubPackages(packages);\n    const plugins = normalized.length ? ` --with ${normalized.join(\" --with \")}` : \"\";\n    return `${requirement} --with ${otelPlugin}${plugins} --checkpoint(${BUB_CHECKPOINT_SUBDIRS.join(\",\")})`;\n}\nexport function bubInstallHash(packages: readonly string[], requirement = DEFAULT_BUB_REQUIREMENT, otelPlugin = DEFAULT_BUB_OTEL_PLUGIN): string {\n    return createHash(\"md5\").update(bubInstallSpec(packages, requirement, otelPlugin)).digest(\"hex\").slice(0, 12);\n}\n"]}
+{"version":3,"file":"bub-install-spec.js","sourceRoot":"","sources":["bub-install-spec.ts"],"names":[],"mappings":";;;AA8BA,wCAEC;AACD,oDAEC;AACD,wCAKC;AACD,wCAKC;AA/CD,6CAAyC;AACzC,qEAA+D;AAC/D;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,mIAAmI,CAAC;AAC3K,+EAA+E;AAClE,QAAA,uBAAuB,GAAG,cAAc,CAAC,4CAAmB,CAAC,CAAC;AAC3E;;;;;GAKG;AACU,QAAA,gCAAgC,GAAG;IAC5C,qBAAqB;IACrB,gBAAgB;CACV,CAAC;AACE,QAAA,sBAAsB,GAAG,CAAC,QAAQ,CAAU,CAAC;AAC7C,QAAA,kBAAkB,GAAG,wCAAwC,CAAC;AAC3E;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC1C,OAAO,QAAQ,OAAO,EAAE,CAAC;AAC7B,CAAC;AACD,SAAgB,oBAAoB,CAAC,QAA2B;IAC5D,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtF,CAAC;AACD,SAAgB,cAAc,CAAC,QAA2B,EAAE,WAAW,GAAG,+BAAuB,EAAE,UAAU,GAAG,+BAAuB,EAAE,sBAAyC,EAAE;IAChL,MAAM,UAAU,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpG,OAAO,GAAG,WAAW,GAAG,SAAS,WAAW,UAAU,GAAG,OAAO,iBAAiB,8BAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACzH,CAAC;AACD,SAAgB,cAAc,CAAC,QAA2B,EAAE,WAAW,GAAG,+BAAuB,EAAE,UAAU,GAAG,+BAAuB,EAAE,sBAAyC,EAAE;IAChL,OAAO,IAAA,wBAAU,EAAC,KAAK,CAAC;SACnB,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC;SAC9E,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { DEFAULT_BUB_VERSION } from \"./coding-cli-versions.ts\";\n/**\n * Bub 的 OTel tape store 插件——时间轨的来源。插件不发 PyPI，git 依赖是唯一安装方式。\n *\n * 插件与 Bub 的 tape 协议同代:这个 pin(bub-contrib#53 之后)从 `bub.tape` 取类型，\n * 要求 Bub ≥ 0.3.10;更早的 pin 按 republic 的类型校验，配 Bub ≤ 0.3.9。配错代不会安装失败，\n * 而是 span 全被拒、时间轨静默为空(台账见 memory/bub-tapestore-otel-tapeentry-drift.md)。\n */\nexport const DEFAULT_BUB_OTEL_PLUGIN = \"git+https://github.com/bubbuild/bub-contrib.git@34715077877041b21472dcca39d91529296a1a9e#subdirectory=packages/bub-tapestore-otel\";\n/** 装哪一版 Bub：`uv tool install` 的 requirement，版本单源在 `coding-cli-versions.ts`。 */\nexport const DEFAULT_BUB_REQUIREMENT = bubRequirement(DEFAULT_BUB_VERSION);\n/**\n * Bub 0.4.0 的上游 lockfile 所验证的模型客户端闭包。\n *\n * Bub 自己的 PyPI metadata 没有限定这两个传递依赖；若只钉 `bub==0.4.0`，每次安装仍会\n * 解析当天最新的客户端，使同一实验在没有配置变更时改变请求协议。\n */\nexport const DEFAULT_BUB_DEPENDENCY_OVERRIDES = [\n    \"any-llm-sdk==1.17.0\",\n    \"openai==2.31.0\",\n] as const;\nexport const BUB_CHECKPOINT_SUBDIRS = [\".local\"] as const;\nexport const BUB_INSTALL_MARKER = \".local/share/niceeval/bub-install-hash\";\n/**\n * PyPI requirement for a pinned Bub version.\n *\n * 这行同时是安装用的 uv override:OTel 插件所在 workspace 把 `bub` 声明成 git 依赖，\n * 不覆盖的话每次安装都会去拉 Bub 主干,版本失控。\n */\nexport function bubRequirement(version: string): string {\n    return `bub==${version}`;\n}\nexport function normalizeBubPackages(packages: readonly string[]): string[] {\n    return [...new Set(packages.map((value) => value.trim()).filter(Boolean))].sort();\n}\nexport function bubInstallSpec(packages: readonly string[], requirement = DEFAULT_BUB_REQUIREMENT, otelPlugin = DEFAULT_BUB_OTEL_PLUGIN, dependencyOverrides: readonly string[] = []): string {\n    const normalized = normalizeBubPackages(packages);\n    const plugins = normalized.length ? ` --with ${normalized.join(\" --with \")}` : \"\";\n    const overrides = dependencyOverrides.length ? ` --overrides ${dependencyOverrides.join(\" \")}` : \"\";\n    return `${requirement}${overrides} --with ${otelPlugin}${plugins} --checkpoint(${BUB_CHECKPOINT_SUBDIRS.join(\",\")})`;\n}\nexport function bubInstallHash(packages: readonly string[], requirement = DEFAULT_BUB_REQUIREMENT, otelPlugin = DEFAULT_BUB_OTEL_PLUGIN, dependencyOverrides: readonly string[] = []): string {\n    return createHash(\"md5\")\n        .update(bubInstallSpec(packages, requirement, otelPlugin, dependencyOverrides))\n        .digest(\"hex\")\n        .slice(0, 12);\n}\n"]}

package/dist/agents/bub-install-spec.d.cts

@@ -8,6 +8,13 @@
 export declare const DEFAULT_BUB_OTEL_PLUGIN = "git+https://github.com/bubbuild/bub-contrib.git@34715077877041b21472dcca39d91529296a1a9e#subdirectory=packages/bub-tapestore-otel";
 /** 装哪一版 Bub：`uv tool install` 的 requirement，版本单源在 `coding-cli-versions.ts`。 */
 export declare const DEFAULT_BUB_REQUIREMENT: string;
+/**
+ * Bub 0.4.0 的上游 lockfile 所验证的模型客户端闭包。
+ *
+ * Bub 自己的 PyPI metadata 没有限定这两个传递依赖；若只钉 `bub==0.4.0`，每次安装仍会
+ * 解析当天最新的客户端，使同一实验在没有配置变更时改变请求协议。
+ */
+export declare const DEFAULT_BUB_DEPENDENCY_OVERRIDES: readonly ["any-llm-sdk==1.17.0", "openai==2.31.0"];
 export declare const BUB_CHECKPOINT_SUBDIRS: readonly [".local"];
 export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-hash";
 /**
@@ -18,5 +25,5 @@ export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-has
  */
 export declare function bubRequirement(version: string): string;
 export declare function normalizeBubPackages(packages: readonly string[]): string[];
-export declare function bubInstallSpec(packages: readonly string[], requirement?: string, otelPlugin?: string): string;
-export declare function bubInstallHash(packages: readonly string[], requirement?: string, otelPlugin?: string): string;
+export declare function bubInstallSpec(packages: readonly string[], requirement?: string, otelPlugin?: string, dependencyOverrides?: readonly string[]): string;
+export declare function bubInstallHash(packages: readonly string[], requirement?: string, otelPlugin?: string, dependencyOverrides?: readonly string[]): string;

package/dist/agents/bub-install-spec.d.mts

@@ -8,6 +8,13 @@
 export declare const DEFAULT_BUB_OTEL_PLUGIN = "git+https://github.com/bubbuild/bub-contrib.git@34715077877041b21472dcca39d91529296a1a9e#subdirectory=packages/bub-tapestore-otel";
 /** 装哪一版 Bub：`uv tool install` 的 requirement，版本单源在 `coding-cli-versions.ts`。 */
 export declare const DEFAULT_BUB_REQUIREMENT: string;
+/**
+ * Bub 0.4.0 的上游 lockfile 所验证的模型客户端闭包。
+ *
+ * Bub 自己的 PyPI metadata 没有限定这两个传递依赖；若只钉 `bub==0.4.0`，每次安装仍会
+ * 解析当天最新的客户端，使同一实验在没有配置变更时改变请求协议。
+ */
+export declare const DEFAULT_BUB_DEPENDENCY_OVERRIDES: readonly ["any-llm-sdk==1.17.0", "openai==2.31.0"];
 export declare const BUB_CHECKPOINT_SUBDIRS: readonly [".local"];
 export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-hash";
 /**
@@ -18,5 +25,5 @@ export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-has
  */
 export declare function bubRequirement(version: string): string;
 export declare function normalizeBubPackages(packages: readonly string[]): string[];
-export declare function bubInstallSpec(packages: readonly string[], requirement?: string, otelPlugin?: string): string;
-export declare function bubInstallHash(packages: readonly string[], requirement?: string, otelPlugin?: string): string;
+export declare function bubInstallSpec(packages: readonly string[], requirement?: string, otelPlugin?: string, dependencyOverrides?: readonly string[]): string;
+export declare function bubInstallHash(packages: readonly string[], requirement?: string, otelPlugin?: string, dependencyOverrides?: readonly string[]): string;

package/dist/agents/bub-install-spec.d.ts

@@ -8,6 +8,13 @@
 export declare const DEFAULT_BUB_OTEL_PLUGIN = "git+https://github.com/bubbuild/bub-contrib.git@34715077877041b21472dcca39d91529296a1a9e#subdirectory=packages/bub-tapestore-otel";
 /** 装哪一版 Bub：`uv tool install` 的 requirement，版本单源在 `coding-cli-versions.ts`。 */
 export declare const DEFAULT_BUB_REQUIREMENT: string;
+/**
+ * Bub 0.4.0 的上游 lockfile 所验证的模型客户端闭包。
+ *
+ * Bub 自己的 PyPI metadata 没有限定这两个传递依赖；若只钉 `bub==0.4.0`，每次安装仍会
+ * 解析当天最新的客户端，使同一实验在没有配置变更时改变请求协议。
+ */
+export declare const DEFAULT_BUB_DEPENDENCY_OVERRIDES: readonly ["any-llm-sdk==1.17.0", "openai==2.31.0"];
 export declare const BUB_CHECKPOINT_SUBDIRS: readonly [".local"];
 export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-hash";
 /**
@@ -18,5 +25,5 @@ export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-has
  */
 export declare function bubRequirement(version: string): string;
 export declare function normalizeBubPackages(packages: readonly string[]): string[];
-export declare function bubInstallSpec(packages: readonly string[], requirement?: string, otelPlugin?: string): string;
-export declare function bubInstallHash(packages: readonly string[], requirement?: string, otelPlugin?: string): string;
+export declare function bubInstallSpec(packages: readonly string[], requirement?: string, otelPlugin?: string, dependencyOverrides?: readonly string[]): string;
+export declare function bubInstallHash(packages: readonly string[], requirement?: string, otelPlugin?: string, dependencyOverrides?: readonly string[]): string;

package/dist/agents/bub-install-spec.js

@@ -5,16 +5,18 @@ const __niceevalExport0 = __niceevalCanonical["BUB_CHECKPOINT_SUBDIRS"];
 export { __niceevalExport0 as BUB_CHECKPOINT_SUBDIRS };
 const __niceevalExport1 = __niceevalCanonical["BUB_INSTALL_MARKER"];
 export { __niceevalExport1 as BUB_INSTALL_MARKER };
-const __niceevalExport2 = __niceevalCanonical["DEFAULT_BUB_OTEL_PLUGIN"];
-export { __niceevalExport2 as DEFAULT_BUB_OTEL_PLUGIN };
-const __niceevalExport3 = __niceevalCanonical["DEFAULT_BUB_REQUIREMENT"];
-export { __niceevalExport3 as DEFAULT_BUB_REQUIREMENT };
-const __niceevalExport4 = __niceevalCanonical["bubInstallHash"];
-export { __niceevalExport4 as bubInstallHash };
-const __niceevalExport5 = __niceevalCanonical["bubInstallSpec"];
-export { __niceevalExport5 as bubInstallSpec };
-const __niceevalExport6 = __niceevalCanonical["bubRequirement"];
-export { __niceevalExport6 as bubRequirement };
-const __niceevalExport7 = __niceevalCanonical["normalizeBubPackages"];
-export { __niceevalExport7 as normalizeBubPackages };
+const __niceevalExport2 = __niceevalCanonical["DEFAULT_BUB_DEPENDENCY_OVERRIDES"];
+export { __niceevalExport2 as DEFAULT_BUB_DEPENDENCY_OVERRIDES };
+const __niceevalExport3 = __niceevalCanonical["DEFAULT_BUB_OTEL_PLUGIN"];
+export { __niceevalExport3 as DEFAULT_BUB_OTEL_PLUGIN };
+const __niceevalExport4 = __niceevalCanonical["DEFAULT_BUB_REQUIREMENT"];
+export { __niceevalExport4 as DEFAULT_BUB_REQUIREMENT };
+const __niceevalExport5 = __niceevalCanonical["bubInstallHash"];
+export { __niceevalExport5 as bubInstallHash };
+const __niceevalExport6 = __niceevalCanonical["bubInstallSpec"];
+export { __niceevalExport6 as bubInstallSpec };
+const __niceevalExport7 = __niceevalCanonical["bubRequirement"];
+export { __niceevalExport7 as bubRequirement };
+const __niceevalExport8 = __niceevalCanonical["normalizeBubPackages"];
+export { __niceevalExport8 as normalizeBubPackages };
 //# sourceMappingURL=bub-install-spec.js.map

package/dist/agents/bub.cjs

@@ -26,9 +26,13 @@ const SKILL_DIR = ".agents/skills";
 // 安装都会去拉 Bub 主干,版本失控。所以安装前总是先把 `bub==<version>` 写进这个文件。
 const BUB_OVERRIDE_FILE = "/tmp/bub-override.txt";
 function resolvePin(config) {
+    const version = config?.version ?? coding_cli_versions_ts_1.DEFAULT_BUB_VERSION;
     return {
         requirement: config?.version ? (0, bub_install_spec_ts_1.bubRequirement)(config.version) : bub_install_spec_ts_1.DEFAULT_BUB_REQUIREMENT,
         otelPlugin: config?.otelPlugin ?? bub_install_spec_ts_1.DEFAULT_BUB_OTEL_PLUGIN,
+        // NiceEval can reproduce the default release's upstream lock exactly. A caller-selected
+        // historical Bub version owns a different closure, so do not silently apply 0.4.0's pins.
+        dependencyOverrides: version === coding_cli_versions_ts_1.DEFAULT_BUB_VERSION ? bub_install_spec_ts_1.DEFAULT_BUB_DEPENDENCY_OVERRIDES : [],
     };
 }
 // NiceEval 的预制配方与运行时安装都写到 $HOME/.local；显式使用该路径，避免 PATH 上
@@ -39,7 +43,7 @@ function normalizePackages(plugins) {
     return (0, bub_install_spec_ts_1.normalizeBubPackages)((plugins ?? []).map((plugin) => plugin.package));
 }
 function installHashOf(packages, pin) {
-    return (0, bub_install_spec_ts_1.bubInstallHash)(packages, pin.requirement, pin.otelPlugin);
+    return (0, bub_install_spec_ts_1.bubInstallHash)(packages, pin.requirement, pin.otelPlugin, pin.dependencyOverrides);
 }
 function tapePath(workspace, sessionId, bubHome) {
     const w = (0, node_crypto_1.createHash)("md5").update(workspace).digest("hex").slice(0, 16);
@@ -47,8 +51,8 @@ function tapePath(workspace, sessionId, bubHome) {
     return `${bubHome}/tapes/${w}__${s}.jsonl`;
 }
 function bubAgent(config) {
-    const getApiKey = () => config?.apiKey ?? (0, util_ts_1.requireEnv)("BUB_API_KEY");
-    const getApiBase = () => config?.apiBase ?? (0, util_ts_1.requireEnv)("BUB_API_BASE");
+    const getApiKey = () => config?.apiKey ?? (0, util_ts_1.requireEnv)("OPENAI_API_KEY");
+    const getApiBase = () => config?.apiBase ?? (0, util_ts_1.requireEnv)("OPENAI_BASE_URL");
     const packages = normalizePackages(config?.pythonPlugins);
     const pin = resolvePin(config);
     const identity = {
@@ -70,7 +74,7 @@ function bubAgent(config) {
                 installMode: "sandbox-network",
                 install: async (sandbox) => {
                     await sandbox.runShellOrThrow(`test -x ${UV} || (curl -LsSf https://astral.sh/uv/install.sh | sh)`);
-                    await sandbox.writeText(BUB_OVERRIDE_FILE, `${pin.requirement}\n`);
+                    await sandbox.writeText(BUB_OVERRIDE_FILE, `${[pin.requirement, ...pin.dependencyOverrides].join("\n")}\n`);
                     const withPlugins = packages.map((pkg) => `--with ${(0, shell_ts_1.shellQuote)(pkg)}`).join(" ");
                     let last = "";
                     for (let attempt = 1; attempt <= 3; attempt += 1) {
@@ -151,8 +155,8 @@ function bubAgent(config) {
             ctx.session.capture(sessionId);
             const apiKey = getApiKey();
             const env = {
-                BUB_API_KEY: apiKey,
-                BUB_API_BASE: getApiBase(),
+                OPENAI_API_KEY: apiKey,
+                OPENAI_BASE_URL: getApiBase(),
                 BUB_HOME: bubHome,
                 ...ctx.telemetry?.env,
             };

package/dist/agents/bub.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bub.js","sourceRoot":"","sources":["bub.ts"],"names":[],"mappings":"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","sourcesContent":["import { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport { defineSandboxAgent } from \"../define.ts\";\nimport { requireEnv } from \"../util.ts\";\nimport { shared } from \"./shared.ts\";\nimport { appendProjectInstruction, installSkills, installedSkillNames, skillDiscoveryInstruction, } from \"./skills.ts\";\nimport { mapBubSpans } from \"../o11y/otlp/mappers/bub.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\nimport { registerAgentLifecycleHookCommands, runPostSetupHooks, runPreTeardownHooks, } from \"./post-setup.ts\";\nimport type { Agent, AgentSetupManifest, SkillSpec, TurnEvidenceCoverage } from \"../types.ts\";\nimport type { SandboxCommand } from \"../sandbox/commands.ts\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { t } from \"../i18n/index.ts\";\nimport { BUB_INSTALL_MARKER, DEFAULT_BUB_OTEL_PLUGIN, DEFAULT_BUB_REQUIREMENT, bubInstallHash, bubRequirement, normalizeBubPackages, } from \"./bub-install-spec.ts\";\nimport { makeSendFailure, sendAcceptanceFromEvents } from \"../context/send-failures.ts\";\nimport { defineSandboxCommand } from \"../sandbox/commands.ts\";\nimport { shellQuote } from \"../sandbox/shell.ts\";\nimport { DEFAULT_BUB_VERSION } from \"./coding-cli-versions.ts\";\n// ───────────────────────────────────────────────────────────────────────────\n// bub 的 agent adapter(沙箱型)。\n//\n// ⚠️ 现实校正:bub 是 PyPI 上的 `bub`(alpha,Python 3.12),不是 npm 包。\n//    · 安装:uv tool install bub(uv 自带 python 3.12,免 root)。\n//    · 调用:bub run \"<prompt>\" --session-id <id> --workspace <path>\n//    · 模型 + 代理:BUB_MODEL=openai:<model>、BUB_API_BASE、BUB_API_KEY。\n//    · 记忆:tape(总是开),落盘在 ~/.bub/tapes/<md5(ws)[:16]>__<md5(sess)[:16]>.jsonl。\n// ───────────────────────────────────────────────────────────────────────────\n/**\n * Bub 的扩展单元 —— **只属于 Bub**:Bub 的插件是运行环境里的 Python Package,\n * 与 Claude Code / Codex 的 native plugin 没有共同的安装协议,不共用类型。\n */\nexport interface PythonPluginSpec {\n    /** PyPI Package、Version Specifier 或 Git URL(如 `bub-plugin-memory==1.3.0`、`git+https://…@8f3c1a2`)。 */\n    package: string;\n}\nexport interface BubConfig {\n    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */\n    apiKey?: string;\n    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */\n    apiBase?: string;\n    /**\n     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。\n     * 落在 `.agents/skills/<name>/`,并写一段发现指引进 AGENTS.md(bub 没有原生 Skill 加载机制)。\n     */\n    skills?: SkillSpec[];\n    /**\n     * 装哪一版 Bub(PyPI 版本号,如 `\"0.4.0\"`)。省略时用 NiceEval 钉的默认版本;\n     * 永远是确定版本,不装 latest —— 被测对象的版本要能从实验配置读出来。\n     */\n    version?: string;\n    /**\n     * OTel tape store 插件的 git 依赖(时间轨的来源)。省略时用 NiceEval 钉的默认 pin。\n     *\n     * 插件与 Bub 的 tape 协议同代:默认 pin 从 `bub.tape` 取类型,要求 Bub ≥ 0.3.10;更早的\n     * 插件 commit 按 republic 的类型校验,配 Bub ≤ 0.3.9。配错代不会安装失败,而是 span 全被拒、\n     * 时间轨静默为空 —— 所以往回钉 `version` 时必须同批钉配套的插件 commit。\n     */\n    otelPlugin?: string;\n    /**\n     * 额外装进 bub tool 环境的 Python Package,每个 Sandbox setup 时进 `uv tool install … --with <pkg>`。\n     * 规范化后的 package 列表进安装 checkpoint key:plugin 集合不同的两个 agent 变体不会复用同一个\n     * 安装 checkpoint(否则第二个变体会静默拿到第一个变体的环境)。\n     */\n    pythonPlugins?: PythonPluginSpec[];\n    /**\n     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在装 bub、装 Skills /\n     * Python package、写 manifest 全部完成后执行。抛错按基础设施错误计(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}\nconst UV = \"$HOME/.local/bin/uv\";\n/** bub 的 skill 目录(`skills` 生态的「通用」目录);bub 不原生扫描它,靠 AGENTS.md 的发现指引。 */\nconst SKILL_DIR = \".agents/skills\";\n// bub 与 OTel 插件的 pin 都从 config 来(缺省用源码里的默认 pin)——不设环境变量后门:\n// 装哪个包是配置,配置的家是代码(边界见 docs/architecture.md「配置从代码来,凭据从环境来」)。\n//\n// override 文件不是历史包袱:插件所在 workspace 把 `bub` 声明成 git 依赖,不覆盖的话每次\n// 安装都会去拉 Bub 主干,版本失控。所以安装前总是先把 `bub==<version>` 写进这个文件。\nconst BUB_OVERRIDE_FILE = \"/tmp/bub-override.txt\";\n/** 一个 agent 变体装的那套 bub:requirement + OTel 插件,两者都进安装指纹。 */\ninterface BubInstallPin {\n    requirement: string;\n    otelPlugin: string;\n}\nfunction resolvePin(config?: BubConfig): BubInstallPin {\n    return {\n        requirement: config?.version ? bubRequirement(config.version) : DEFAULT_BUB_REQUIREMENT,\n        otelPlugin: config?.otelPlugin ?? DEFAULT_BUB_OTEL_PLUGIN,\n    };\n}\n// NiceEval 的预制配方与运行时安装都写到 $HOME/.local；显式使用该路径，避免 PATH 上\n// 另一个未知版本的 bub 抢先命中。\nconst BUB = \"$HOME/.local/bin/bub\";\n/** 规范化 python plugin:去空白、丢空串、去重 —— 安装命令与 checkpoint key 用同一份列表。 */\nfunction normalizePackages(plugins?: readonly PythonPluginSpec[]): string[] {\n    return normalizeBubPackages((plugins ?? []).map((plugin) => plugin.package));\n}\nfunction installHashOf(packages: readonly string[], pin: BubInstallPin): string {\n    return bubInstallHash(packages, pin.requirement, pin.otelPlugin);\n}\nfunction tapePath(workspace: string, sessionId: string, bubHome: string): string {\n    const w = createHash(\"md5\").update(workspace).digest(\"hex\").slice(0, 16);\n    const s = createHash(\"md5\").update(sessionId).digest(\"hex\").slice(0, 16);\n    return `${bubHome}/tapes/${w}__${s}.jsonl`;\n}\nexport function bubAgent(config?: BubConfig): Agent {\n    const getApiKey = () => config?.apiKey ?? requireEnv(\"BUB_API_KEY\");\n    const getApiBase = () => config?.apiBase ?? requireEnv(\"BUB_API_BASE\");\n    const packages = normalizePackages(config?.pythonPlugins);\n    const pin = resolvePin(config);\n    const identity = {\n        agent: \"bub\",\n        version: config?.version ?? DEFAULT_BUB_VERSION,\n        revision: installHashOf(packages, pin),\n    } as const;\n    const marker = `$HOME/${BUB_INSTALL_MARKER}`;\n    const probe = defineSandboxCommand({ id: \"niceeval.agent.probe.bub\", revision: identity.revision, inputs: identity }, async (sandbox) => {\n        await sandbox.runShellOrThrow(`test -x ${BUB} && test \"$(cat ${marker} 2>/dev/null)\" = ${shellQuote(identity.revision)}`);\n    });\n    // sandboxId → { home, workspace }; persists values detected in setup() so send() can use them.\n    const sessionInfo = new Map<string, {\n        home: string;\n        workspace: string;\n    }>();\n    return registerAgentLifecycleHookCommands(defineSandboxAgent({\n        name: \"bub\",\n        ensure: { identity, probe },\n        installers: [{\n                identity,\n                installMode: \"sandbox-network\",\n                install: async (sandbox) => {\n                    await sandbox.runShellOrThrow(`test -x ${UV} || (curl -LsSf https://astral.sh/uv/install.sh | sh)`);\n                    await sandbox.writeText(BUB_OVERRIDE_FILE, `${pin.requirement}\\n`);\n                    const withPlugins = packages.map((pkg) => `--with ${shellQuote(pkg)}`).join(\" \");\n                    let last = \"\";\n                    for (let attempt = 1; attempt <= 3; attempt += 1) {\n                        const result = await sandbox.runShell(`${UV} tool install --reinstall --python 3.12 --prerelease allow 'bub' --overrides ${BUB_OVERRIDE_FILE} --with ${shellQuote(pin.otelPlugin)}${withPlugins ? ` ${withPlugins}` : \"\"}`);\n                        if (result.exitCode === 0) {\n                            await sandbox.runShellOrThrow(`mkdir -p \"$(dirname ${marker})\" && printf '%s' ${shellQuote(identity.revision)} > ${marker}`);\n                            return;\n                        }\n                        last = (result.stdout + result.stderr).split(\"\\n\").slice(-15).join(\"\\n\");\n                    }\n                    throw new Error(t(\"bub.installFailed\", { attempts: 3, tail: last }));\n                },\n            }],\n        // 官方 adapter:transcript 经生命周期 fixture 验证,全通道 complete。\n        evidenceCoverage: completeEvidenceCoverage,\n        spanMapper: mapBubSpans,\n        tracing: {\n            protocol: \"http/protobuf\",\n            env: (endpoint) => ({\n                BUB_TAPESTORE_OTEL_ENABLED: \"true\",\n                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,\n                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: \"http/protobuf\",\n            }),\n        },\n        async setup(sb, ctx) {\n            // home 必须来自运行时探测:各 sandbox provider 不同(/home/node、/home/vercel-sandbox…),\n            // 兜一个 provider 专属常量会静默走错路径(tape 读不到 → 空事件流 → 负断言假通过)。\n            const home = (await sb.runShell(\"printf '%s' $HOME\")).stdout.trim();\n            if (!home)\n                throw new Error(t(\"bub.homeDetectFailed\"));\n            const workspace = sb.workdir;\n            sessionInfo.set(sb.sandboxId, { home, workspace });\n            // Agent CLI 已由 runner 的 agent.ensure 循环完成安装与复检。\n            // adapter setup 只写本 Attempt 的 runtime config。\n            if (!(await sb.pathExists(`${workspace}/AGENTS.md`))) {\n                await shared.writeFile(sb, `${workspace}/AGENTS.md`, [\n                    `You are a coding agent working in a Next.js project at ${workspace}.`,\n                    ``,\n                    `Implement the requested feature by writing files directly to disk with the available tools:`,\n                    `- fs_write(path, content): create or overwrite a file`,\n                    `- fs_edit(path, old, new): edit an existing file`,\n                    `- bash(cmd): run shell commands`,\n                    ``,\n                    `Do NOT respond with only a text explanation — write the actual code files.`,\n                    `After writing, verify with bash(\"cd ${workspace} && npm run build\").`,\n                ].join(\"\\n\"));\n            }\n            const manifest: AgentSetupManifest = { skills: [] };\n            if (config?.skills?.length) {\n                manifest.skills = await installSkills(sb, config.skills, { dir: SKILL_DIR });\n                // bub 没有原生 Skill 加载机制:装进目录不等于会被读到,发现指引跟着一起写。\n                await appendProjectInstruction(sb, skillDiscoveryInstruction(SKILL_DIR, installedSkillNames(manifest.skills)));\n            }\n            if (packages.length)\n                manifest.pythonPlugins = packages.map((pkg) => ({ package: pkg }));\n            if (manifest.skills.length || manifest.pythonPlugins?.length) {\n                ctx.reportSetup(manifest);\n            }\n            // 安装后钩子(postSetup):排在 manifest 之后——manifest 审计 Adapter 自身的安装事实,\n            // 钩子失败不该丢掉这份证据。\n            await runPostSetupHooks(sb, ctx, \"bub\", config?.postSetup);\n        },\n        async teardown(sb, ctx) {\n            // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。\n            // bub 目前没有其它收尾步骤,这段就是整个 teardown。\n            await runPreTeardownHooks(sb, ctx, \"bub\", config?.preTeardown);\n        },\n        async send(input, ctx) {\n            const sb = ctx.sandbox;\n            const info = sessionInfo.get(sb.sandboxId);\n            if (!info)\n                throw new Error(t(\"bub.setupNotRun\"));\n            const { home, workspace } = info;\n            const bubHome = `${home}/.bub`;\n            // 会话契约:ctx.session.id 未记录时开新 tape(新 sessionId),否则 resume 传入的 id。\n            // tape 路径由 md5(workspace)+md5(sessionId) 决定,同沙箱多会话靠 sessionId 区分。\n            const sessionId = ctx.session.id ?? `fe-${sb.sandboxId}-${randomUUID().slice(0, 8)}`;\n            ctx.session.capture(sessionId);\n            const apiKey = getApiKey();\n            const env: globalThis.Record<string, string> = {\n                BUB_API_KEY: apiKey,\n                BUB_API_BASE: getApiBase(),\n                BUB_HOME: bubHome,\n                ...ctx.telemetry?.env,\n            };\n            // model 归属:实验决定(ctx.model),省略时交给 bub 原生默认 / 用户环境,不硬编码。\n            if (ctx.model)\n                env.BUB_MODEL = `openai:${ctx.model}`;\n            const res = await sb.runShell(`${BUB} --workspace ${workspace} run ${shared.shellQuote(input.text)} --session-id ${sessionId}`, { env, sensitiveValues: [apiKey], stream: true });\n            const raw = await sb.readText(tapePath(workspace, sessionId, bubHome)).catch(() => undefined);\n            const parsed = shared.parseBub(raw);\n            const events = [...parsed.events];\n            let turnEvidenceCoverage: TurnEvidenceCoverage | undefined;\n            if (!raw?.trim()) {\n                const reason = \"Bub tape 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 Bub tape 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\",\n                ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),\n            };\n        },\n    }), config?.postSetup, config?.preTeardown);\n}\nexport default bubAgent();\n"]}
+{"version":3,"file":"bub.js","sourceRoot":"","sources":["bub.ts"],"names":[],"mappings":"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","sourcesContent":["import { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport { defineSandboxAgent } from \"../define.ts\";\nimport { requireEnv } from \"../util.ts\";\nimport { shared } from \"./shared.ts\";\nimport { appendProjectInstruction, installSkills, installedSkillNames, skillDiscoveryInstruction, } from \"./skills.ts\";\nimport { mapBubSpans } from \"../o11y/otlp/mappers/bub.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\nimport { registerAgentLifecycleHookCommands, runPostSetupHooks, runPreTeardownHooks, } from \"./post-setup.ts\";\nimport type { Agent, AgentSetupManifest, SkillSpec, TurnEvidenceCoverage } from \"../types.ts\";\nimport type { SandboxCommand } from \"../sandbox/commands.ts\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { t } from \"../i18n/index.ts\";\nimport { BUB_INSTALL_MARKER, DEFAULT_BUB_DEPENDENCY_OVERRIDES, DEFAULT_BUB_OTEL_PLUGIN, DEFAULT_BUB_REQUIREMENT, bubInstallHash, bubRequirement, normalizeBubPackages, } from \"./bub-install-spec.ts\";\nimport { makeSendFailure, sendAcceptanceFromEvents } from \"../context/send-failures.ts\";\nimport { defineSandboxCommand } from \"../sandbox/commands.ts\";\nimport { shellQuote } from \"../sandbox/shell.ts\";\nimport { DEFAULT_BUB_VERSION } from \"./coding-cli-versions.ts\";\n// ───────────────────────────────────────────────────────────────────────────\n// bub 的 agent adapter(沙箱型)。\n//\n// ⚠️ 现实校正:bub 是 PyPI 上的 `bub`(alpha,Python 3.12),不是 npm 包。\n//    · 安装:uv tool install bub(uv 自带 python 3.12,免 root)。\n//    · 调用:bub run \"<prompt>\" --session-id <id> --workspace <path>\n//    · 模型 + 代理:BUB_MODEL=openai:<model>、OPENAI_BASE_URL、OPENAI_API_KEY。\n//    · 记忆:tape(总是开),落盘在 ~/.bub/tapes/<md5(ws)[:16]>__<md5(sess)[:16]>.jsonl。\n// ───────────────────────────────────────────────────────────────────────────\n/**\n * Bub 的扩展单元 —— **只属于 Bub**:Bub 的插件是运行环境里的 Python Package,\n * 与 Claude Code / Codex 的 native plugin 没有共同的安装协议,不共用类型。\n */\nexport interface PythonPluginSpec {\n    /** PyPI Package、Version Specifier 或 Git URL(如 `bub-plugin-memory==1.3.0`、`git+https://…@8f3c1a2`)。 */\n    package: string;\n}\nexport interface BubConfig {\n    /** OpenAI 兼容代理的 API key。省略时读 OPENAI_API_KEY env。 */\n    apiKey?: string;\n    /** OpenAI 兼容代理的 base URL。省略时读 OPENAI_BASE_URL env。 */\n    apiBase?: string;\n    /**\n     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。\n     * 落在 `.agents/skills/<name>/`,并写一段发现指引进 AGENTS.md(bub 没有原生 Skill 加载机制)。\n     */\n    skills?: SkillSpec[];\n    /**\n     * 装哪一版 Bub(PyPI 版本号,如 `\"0.4.0\"`)。省略时用 NiceEval 钉的默认版本;\n     * 永远是确定版本,不装 latest —— 被测对象的版本要能从实验配置读出来。\n     */\n    version?: string;\n    /**\n     * OTel tape store 插件的 git 依赖(时间轨的来源)。省略时用 NiceEval 钉的默认 pin。\n     *\n     * 插件与 Bub 的 tape 协议同代:默认 pin 从 `bub.tape` 取类型,要求 Bub ≥ 0.3.10;更早的\n     * 插件 commit 按 republic 的类型校验,配 Bub ≤ 0.3.9。配错代不会安装失败,而是 span 全被拒、\n     * 时间轨静默为空 —— 所以往回钉 `version` 时必须同批钉配套的插件 commit。\n     */\n    otelPlugin?: string;\n    /**\n     * 额外装进 bub tool 环境的 Python Package,每个 Sandbox setup 时进 `uv tool install … --with <pkg>`。\n     * 规范化后的 package 列表进安装 checkpoint key:plugin 集合不同的两个 agent 变体不会复用同一个\n     * 安装 checkpoint(否则第二个变体会静默拿到第一个变体的环境)。\n     */\n    pythonPlugins?: PythonPluginSpec[];\n    /**\n     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在装 bub、装 Skills /\n     * Python package、写 manifest 全部完成后执行。抛错按基础设施错误计(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}\nconst UV = \"$HOME/.local/bin/uv\";\n/** bub 的 skill 目录(`skills` 生态的「通用」目录);bub 不原生扫描它,靠 AGENTS.md 的发现指引。 */\nconst SKILL_DIR = \".agents/skills\";\n// bub 与 OTel 插件的 pin 都从 config 来(缺省用源码里的默认 pin)——不设环境变量后门:\n// 装哪个包是配置,配置的家是代码(边界见 docs/architecture.md「配置从代码来,凭据从环境来」)。\n//\n// override 文件不是历史包袱:插件所在 workspace 把 `bub` 声明成 git 依赖,不覆盖的话每次\n// 安装都会去拉 Bub 主干,版本失控。所以安装前总是先把 `bub==<version>` 写进这个文件。\nconst BUB_OVERRIDE_FILE = \"/tmp/bub-override.txt\";\n/** 一个 agent 变体装的那套 bub:requirement + OTel 插件,两者都进安装指纹。 */\ninterface BubInstallPin {\n    requirement: string;\n    otelPlugin: string;\n    dependencyOverrides: readonly string[];\n}\nfunction resolvePin(config?: BubConfig): BubInstallPin {\n    const version = config?.version ?? DEFAULT_BUB_VERSION;\n    return {\n        requirement: config?.version ? bubRequirement(config.version) : DEFAULT_BUB_REQUIREMENT,\n        otelPlugin: config?.otelPlugin ?? DEFAULT_BUB_OTEL_PLUGIN,\n        // NiceEval can reproduce the default release's upstream lock exactly. A caller-selected\n        // historical Bub version owns a different closure, so do not silently apply 0.4.0's pins.\n        dependencyOverrides: version === DEFAULT_BUB_VERSION ? DEFAULT_BUB_DEPENDENCY_OVERRIDES : [],\n    };\n}\n// NiceEval 的预制配方与运行时安装都写到 $HOME/.local；显式使用该路径，避免 PATH 上\n// 另一个未知版本的 bub 抢先命中。\nconst BUB = \"$HOME/.local/bin/bub\";\n/** 规范化 python plugin:去空白、丢空串、去重 —— 安装命令与 checkpoint key 用同一份列表。 */\nfunction normalizePackages(plugins?: readonly PythonPluginSpec[]): string[] {\n    return normalizeBubPackages((plugins ?? []).map((plugin) => plugin.package));\n}\nfunction installHashOf(packages: readonly string[], pin: BubInstallPin): string {\n    return bubInstallHash(packages, pin.requirement, pin.otelPlugin, pin.dependencyOverrides);\n}\nfunction tapePath(workspace: string, sessionId: string, bubHome: string): string {\n    const w = createHash(\"md5\").update(workspace).digest(\"hex\").slice(0, 16);\n    const s = createHash(\"md5\").update(sessionId).digest(\"hex\").slice(0, 16);\n    return `${bubHome}/tapes/${w}__${s}.jsonl`;\n}\nexport function bubAgent(config?: BubConfig): Agent {\n    const getApiKey = () => config?.apiKey ?? requireEnv(\"OPENAI_API_KEY\");\n    const getApiBase = () => config?.apiBase ?? requireEnv(\"OPENAI_BASE_URL\");\n    const packages = normalizePackages(config?.pythonPlugins);\n    const pin = resolvePin(config);\n    const identity = {\n        agent: \"bub\",\n        version: config?.version ?? DEFAULT_BUB_VERSION,\n        revision: installHashOf(packages, pin),\n    } as const;\n    const marker = `$HOME/${BUB_INSTALL_MARKER}`;\n    const probe = defineSandboxCommand({ id: \"niceeval.agent.probe.bub\", revision: identity.revision, inputs: identity }, async (sandbox) => {\n        await sandbox.runShellOrThrow(`test -x ${BUB} && test \"$(cat ${marker} 2>/dev/null)\" = ${shellQuote(identity.revision)}`);\n    });\n    // sandboxId → { home, workspace }; persists values detected in setup() so send() can use them.\n    const sessionInfo = new Map<string, {\n        home: string;\n        workspace: string;\n    }>();\n    return registerAgentLifecycleHookCommands(defineSandboxAgent({\n        name: \"bub\",\n        ensure: { identity, probe },\n        installers: [{\n                identity,\n                installMode: \"sandbox-network\",\n                install: async (sandbox) => {\n                    await sandbox.runShellOrThrow(`test -x ${UV} || (curl -LsSf https://astral.sh/uv/install.sh | sh)`);\n                    await sandbox.writeText(BUB_OVERRIDE_FILE, `${[pin.requirement, ...pin.dependencyOverrides].join(\"\\n\")}\\n`);\n                    const withPlugins = packages.map((pkg) => `--with ${shellQuote(pkg)}`).join(\" \");\n                    let last = \"\";\n                    for (let attempt = 1; attempt <= 3; attempt += 1) {\n                        const result = await sandbox.runShell(`${UV} tool install --reinstall --python 3.12 --prerelease allow 'bub' --overrides ${BUB_OVERRIDE_FILE} --with ${shellQuote(pin.otelPlugin)}${withPlugins ? ` ${withPlugins}` : \"\"}`);\n                        if (result.exitCode === 0) {\n                            await sandbox.runShellOrThrow(`mkdir -p \"$(dirname ${marker})\" && printf '%s' ${shellQuote(identity.revision)} > ${marker}`);\n                            return;\n                        }\n                        last = (result.stdout + result.stderr).split(\"\\n\").slice(-15).join(\"\\n\");\n                    }\n                    throw new Error(t(\"bub.installFailed\", { attempts: 3, tail: last }));\n                },\n            }],\n        // 官方 adapter:transcript 经生命周期 fixture 验证,全通道 complete。\n        evidenceCoverage: completeEvidenceCoverage,\n        spanMapper: mapBubSpans,\n        tracing: {\n            protocol: \"http/protobuf\",\n            env: (endpoint) => ({\n                BUB_TAPESTORE_OTEL_ENABLED: \"true\",\n                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,\n                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: \"http/protobuf\",\n            }),\n        },\n        async setup(sb, ctx) {\n            // home 必须来自运行时探测:各 sandbox provider 不同(/home/node、/home/vercel-sandbox…),\n            // 兜一个 provider 专属常量会静默走错路径(tape 读不到 → 空事件流 → 负断言假通过)。\n            const home = (await sb.runShell(\"printf '%s' $HOME\")).stdout.trim();\n            if (!home)\n                throw new Error(t(\"bub.homeDetectFailed\"));\n            const workspace = sb.workdir;\n            sessionInfo.set(sb.sandboxId, { home, workspace });\n            // Agent CLI 已由 runner 的 agent.ensure 循环完成安装与复检。\n            // adapter setup 只写本 Attempt 的 runtime config。\n            if (!(await sb.pathExists(`${workspace}/AGENTS.md`))) {\n                await shared.writeFile(sb, `${workspace}/AGENTS.md`, [\n                    `You are a coding agent working in a Next.js project at ${workspace}.`,\n                    ``,\n                    `Implement the requested feature by writing files directly to disk with the available tools:`,\n                    `- fs_write(path, content): create or overwrite a file`,\n                    `- fs_edit(path, old, new): edit an existing file`,\n                    `- bash(cmd): run shell commands`,\n                    ``,\n                    `Do NOT respond with only a text explanation — write the actual code files.`,\n                    `After writing, verify with bash(\"cd ${workspace} && npm run build\").`,\n                ].join(\"\\n\"));\n            }\n            const manifest: AgentSetupManifest = { skills: [] };\n            if (config?.skills?.length) {\n                manifest.skills = await installSkills(sb, config.skills, { dir: SKILL_DIR });\n                // bub 没有原生 Skill 加载机制:装进目录不等于会被读到,发现指引跟着一起写。\n                await appendProjectInstruction(sb, skillDiscoveryInstruction(SKILL_DIR, installedSkillNames(manifest.skills)));\n            }\n            if (packages.length)\n                manifest.pythonPlugins = packages.map((pkg) => ({ package: pkg }));\n            if (manifest.skills.length || manifest.pythonPlugins?.length) {\n                ctx.reportSetup(manifest);\n            }\n            // 安装后钩子(postSetup):排在 manifest 之后——manifest 审计 Adapter 自身的安装事实,\n            // 钩子失败不该丢掉这份证据。\n            await runPostSetupHooks(sb, ctx, \"bub\", config?.postSetup);\n        },\n        async teardown(sb, ctx) {\n            // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。\n            // bub 目前没有其它收尾步骤,这段就是整个 teardown。\n            await runPreTeardownHooks(sb, ctx, \"bub\", config?.preTeardown);\n        },\n        async send(input, ctx) {\n            const sb = ctx.sandbox;\n            const info = sessionInfo.get(sb.sandboxId);\n            if (!info)\n                throw new Error(t(\"bub.setupNotRun\"));\n            const { home, workspace } = info;\n            const bubHome = `${home}/.bub`;\n            // 会话契约:ctx.session.id 未记录时开新 tape(新 sessionId),否则 resume 传入的 id。\n            // tape 路径由 md5(workspace)+md5(sessionId) 决定,同沙箱多会话靠 sessionId 区分。\n            const sessionId = ctx.session.id ?? `fe-${sb.sandboxId}-${randomUUID().slice(0, 8)}`;\n            ctx.session.capture(sessionId);\n            const apiKey = getApiKey();\n            const env: globalThis.Record<string, string> = {\n                OPENAI_API_KEY: apiKey,\n                OPENAI_BASE_URL: getApiBase(),\n                BUB_HOME: bubHome,\n                ...ctx.telemetry?.env,\n            };\n            // model 归属:实验决定(ctx.model),省略时交给 bub 原生默认 / 用户环境,不硬编码。\n            if (ctx.model)\n                env.BUB_MODEL = `openai:${ctx.model}`;\n            const res = await sb.runShell(`${BUB} --workspace ${workspace} run ${shared.shellQuote(input.text)} --session-id ${sessionId}`, { env, sensitiveValues: [apiKey], stream: true });\n            const raw = await sb.readText(tapePath(workspace, sessionId, bubHome)).catch(() => undefined);\n            const parsed = shared.parseBub(raw);\n            const events = [...parsed.events];\n            let turnEvidenceCoverage: TurnEvidenceCoverage | undefined;\n            if (!raw?.trim()) {\n                const reason = \"Bub tape 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 Bub tape 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\",\n                ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),\n            };\n        },\n    }), config?.postSetup, config?.preTeardown);\n}\nexport default bubAgent();\n"]}

package/dist/agents/bub.d.cts

@@ -9,9 +9,9 @@ export interface PythonPluginSpec {
     package: string;
 }
 export interface BubConfig {
-    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */
+    /** OpenAI 兼容代理的 API key。省略时读 OPENAI_API_KEY env。 */
     apiKey?: string;
-    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */
+    /** OpenAI 兼容代理的 base URL。省略时读 OPENAI_BASE_URL env。 */
     apiBase?: string;
     /**
      * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。

package/dist/agents/bub.d.mts

@@ -9,9 +9,9 @@ export interface PythonPluginSpec {
     package: string;
 }
 export interface BubConfig {
-    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */
+    /** OpenAI 兼容代理的 API key。省略时读 OPENAI_API_KEY env。 */
     apiKey?: string;
-    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */
+    /** OpenAI 兼容代理的 base URL。省略时读 OPENAI_BASE_URL env。 */
     apiBase?: string;
     /**
      * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。

package/dist/agents/bub.d.ts

@@ -9,9 +9,9 @@ export interface PythonPluginSpec {
     package: string;
 }
 export interface BubConfig {
-    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */
+    /** OpenAI 兼容代理的 API key。省略时读 OPENAI_API_KEY env。 */
     apiKey?: string;
-    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */
+    /** OpenAI 兼容代理的 base URL。省略时读 OPENAI_BASE_URL env。 */
     apiBase?: string;
     /**
      * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。