niceeval 0.12.1 → 0.12.2-canary.31

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

@@ -0,0 +1,42 @@
+"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.bubRequirement = bubRequirement;
+exports.normalizeBubPackages = normalizeBubPackages;
+exports.bubInstallSpec = bubInstallSpec;
+exports.bubInstallHash = bubInstallHash;
+const node_crypto_1 = require("node:crypto");
+const coding_cli_versions_ts_1 = require("./coding-cli-versions.cjs");
+/**
+ * Bub 的 OTel tape store 插件——时间轨的来源。插件不发 PyPI，git 依赖是唯一安装方式。
+ *
+ * 插件与 Bub 的 tape 协议同代:这个 pin(bub-contrib#53 之后)从 `bub.tape` 取类型，
+ * 要求 Bub ≥ 0.3.10;更早的 pin 按 republic 的类型校验，配 Bub ≤ 0.3.9。配错代不会安装失败，
+ * 而是 span 全被拒、时间轨静默为空(台账见 memory/bub-tapestore-otel-tapeentry-drift.md)。
+ */
+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);
+exports.BUB_CHECKPOINT_SUBDIRS = [".local"];
+exports.BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-hash";
+/**
+ * PyPI requirement for a pinned Bub version.
+ *
+ * 这行同时是安装用的 uv override:OTel 插件所在 workspace 把 `bub` 声明成 git 依赖，
+ * 不覆盖的话每次安装都会去拉 Bub 主干,版本失控。
+ */
+function bubRequirement(version) {
+    return `bub==${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) {
+    const normalized = normalizeBubPackages(packages);
+    const plugins = normalized.length ? ` --with ${normalized.join(" --with ")}` : "";
+    return `${requirement} --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);
+}
+//# sourceMappingURL=bub-install-spec.cjs.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,22 @@
+/**
+ * Bub 的 OTel tape store 插件——时间轨的来源。插件不发 PyPI，git 依赖是唯一安装方式。
+ *
+ * 插件与 Bub 的 tape 协议同代:这个 pin(bub-contrib#53 之后)从 `bub.tape` 取类型，
+ * 要求 Bub ≥ 0.3.10;更早的 pin 按 republic 的类型校验，配 Bub ≤ 0.3.9。配错代不会安装失败，
+ * 而是 span 全被拒、时间轨静默为空(台账见 memory/bub-tapestore-otel-tapeentry-drift.md)。
+ */
+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;
+export declare const BUB_CHECKPOINT_SUBDIRS: readonly [".local"];
+export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-hash";
+/**
+ * PyPI requirement for a pinned Bub version.
+ *
+ * 这行同时是安装用的 uv override:OTel 插件所在 workspace 把 `bub` 声明成 git 依赖，
+ * 不覆盖的话每次安装都会去拉 Bub 主干,版本失控。
+ */
+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;

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

@@ -0,0 +1,22 @@
+/**
+ * Bub 的 OTel tape store 插件——时间轨的来源。插件不发 PyPI，git 依赖是唯一安装方式。
+ *
+ * 插件与 Bub 的 tape 协议同代:这个 pin(bub-contrib#53 之后)从 `bub.tape` 取类型，
+ * 要求 Bub ≥ 0.3.10;更早的 pin 按 republic 的类型校验，配 Bub ≤ 0.3.9。配错代不会安装失败，
+ * 而是 span 全被拒、时间轨静默为空(台账见 memory/bub-tapestore-otel-tapeentry-drift.md)。
+ */
+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;
+export declare const BUB_CHECKPOINT_SUBDIRS: readonly [".local"];
+export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-hash";
+/**
+ * PyPI requirement for a pinned Bub version.
+ *
+ * 这行同时是安装用的 uv override:OTel 插件所在 workspace 把 `bub` 声明成 git 依赖，
+ * 不覆盖的话每次安装都会去拉 Bub 主干,版本失控。
+ */
+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;

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

@@ -0,0 +1,22 @@
+/**
+ * Bub 的 OTel tape store 插件——时间轨的来源。插件不发 PyPI，git 依赖是唯一安装方式。
+ *
+ * 插件与 Bub 的 tape 协议同代:这个 pin(bub-contrib#53 之后)从 `bub.tape` 取类型，
+ * 要求 Bub ≥ 0.3.10;更早的 pin 按 republic 的类型校验，配 Bub ≤ 0.3.9。配错代不会安装失败，
+ * 而是 span 全被拒、时间轨静默为空(台账见 memory/bub-tapestore-otel-tapeentry-drift.md)。
+ */
+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;
+export declare const BUB_CHECKPOINT_SUBDIRS: readonly [".local"];
+export declare const BUB_INSTALL_MARKER = ".local/share/niceeval/bub-install-hash";
+/**
+ * PyPI requirement for a pinned Bub version.
+ *
+ * 这行同时是安装用的 uv override:OTel 插件所在 workspace 把 `bub` 声明成 git 依赖，
+ * 不覆盖的话每次安装都会去拉 Bub 主干,版本失控。
+ */
+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;

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

@@ -0,0 +1,20 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./bub-install-spec.cjs");
+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 };
+//# sourceMappingURL=bub-install-spec.js.map

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

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

package/dist/agents/bub.cjs

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bubAgent = bubAgent;
+const coverage_ts_1 = require("../assertions/coverage.cjs");
+const define_ts_1 = require("../define.cjs");
+const util_ts_1 = require("../util.cjs");
+const shared_ts_1 = require("./shared.cjs");
+const skills_ts_1 = require("./skills.cjs");
+const bub_ts_1 = require("../o11y/otlp/mappers/bub.cjs");
+const command_projection_ts_1 = require("../o11y/command-projection.cjs");
+const post_setup_ts_1 = require("./post-setup.cjs");
+const node_crypto_1 = require("node:crypto");
+const index_ts_1 = require("../i18n/index.cjs");
+const bub_install_spec_ts_1 = require("./bub-install-spec.cjs");
+const send_failures_ts_1 = require("../context/send-failures.cjs");
+const commands_ts_1 = require("../sandbox/commands.cjs");
+const shell_ts_1 = require("../sandbox/shell.cjs");
+const coding_cli_versions_ts_1 = require("./coding-cli-versions.cjs");
+const UV = "$HOME/.local/bin/uv";
+/** bub 的 skill 目录(`skills` 生态的「通用」目录);bub 不原生扫描它,靠 AGENTS.md 的发现指引。 */
+const SKILL_DIR = ".agents/skills";
+// bub 与 OTel 插件的 pin 都从 config 来(缺省用源码里的默认 pin)——不设环境变量后门:
+// 装哪个包是配置,配置的家是代码(边界见 docs/architecture.md「配置从代码来,凭据从环境来」)。
+//
+// override 文件不是历史包袱:插件所在 workspace 把 `bub` 声明成 git 依赖,不覆盖的话每次
+// 安装都会去拉 Bub 主干,版本失控。所以安装前总是先把 `bub==<version>` 写进这个文件。
+const BUB_OVERRIDE_FILE = "/tmp/bub-override.txt";
+function resolvePin(config) {
+    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 的预制配方与运行时安装都写到 $HOME/.local；显式使用该路径，避免 PATH 上
+// 另一个未知版本的 bub 抢先命中。
+const BUB = "$HOME/.local/bin/bub";
+/** 规范化 python plugin:去空白、丢空串、去重 —— 安装命令与 checkpoint key 用同一份列表。 */
+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);
+}
+function tapePath(workspace, sessionId, bubHome) {
+    const w = (0, node_crypto_1.createHash)("md5").update(workspace).digest("hex").slice(0, 16);
+    const s = (0, node_crypto_1.createHash)("md5").update(sessionId).digest("hex").slice(0, 16);
+    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 packages = normalizePackages(config?.pythonPlugins);
+    const pin = resolvePin(config);
+    const identity = {
+        agent: "bub",
+        version: config?.version ?? coding_cli_versions_ts_1.DEFAULT_BUB_VERSION,
+        revision: installHashOf(packages, pin),
+    };
+    const marker = `$HOME/${bub_install_spec_ts_1.BUB_INSTALL_MARKER}`;
+    const probe = (0, commands_ts_1.defineSandboxCommand)({ id: "niceeval.agent.probe.bub", revision: identity.revision, inputs: identity }, async (sandbox) => {
+        await sandbox.runShellOrThrow(`test -x ${BUB} && test "$(cat ${marker} 2>/dev/null)" = ${(0, shell_ts_1.shellQuote)(identity.revision)}`);
+    });
+    // sandboxId → { home, workspace }; persists values detected in setup() so send() can use them.
+    const sessionInfo = new Map();
+    return (0, post_setup_ts_1.registerAgentLifecycleHookCommands)((0, define_ts_1.defineSandboxAgent)({
+        name: "bub",
+        ensure: { identity, probe },
+        installers: [{
+                identity,
+                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`);
+                    const withPlugins = packages.map((pkg) => `--with ${(0, shell_ts_1.shellQuote)(pkg)}`).join(" ");
+                    let last = "";
+                    for (let attempt = 1; attempt <= 3; attempt += 1) {
+                        const result = await sandbox.runShell(`${UV} tool install --reinstall --python 3.12 --prerelease allow 'bub' --overrides ${BUB_OVERRIDE_FILE} --with ${(0, shell_ts_1.shellQuote)(pin.otelPlugin)}${withPlugins ? ` ${withPlugins}` : ""}`);
+                        if (result.exitCode === 0) {
+                            await sandbox.runShellOrThrow(`mkdir -p "$(dirname ${marker})" && printf '%s' ${(0, shell_ts_1.shellQuote)(identity.revision)} > ${marker}`);
+                            return;
+                        }
+                        last = (result.stdout + result.stderr).split("\n").slice(-15).join("\n");
+                    }
+                    throw new Error((0, index_ts_1.t)("bub.installFailed", { attempts: 3, tail: last }));
+                },
+            }],
+        // 官方 adapter:transcript 经生命周期 fixture 验证,全通道 complete。
+        evidenceCoverage: coverage_ts_1.completeEvidenceCoverage,
+        spanMapper: bub_ts_1.mapBubSpans,
+        tracing: {
+            protocol: "http/protobuf",
+            env: (endpoint) => ({
+                BUB_TAPESTORE_OTEL_ENABLED: "true",
+                OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: endpoint,
+                OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: "http/protobuf",
+            }),
+        },
+        async setup(sb, ctx) {
+            // home 必须来自运行时探测:各 sandbox provider 不同(/home/node、/home/vercel-sandbox…),
+            // 兜一个 provider 专属常量会静默走错路径(tape 读不到 → 空事件流 → 负断言假通过)。
+            const home = (await sb.runShell("printf '%s' $HOME")).stdout.trim();
+            if (!home)
+                throw new Error((0, index_ts_1.t)("bub.homeDetectFailed"));
+            const workspace = sb.workdir;
+            sessionInfo.set(sb.sandboxId, { home, workspace });
+            // Agent CLI 已由 runner 的 agent.ensure 循环完成安装与复检。
+            // adapter setup 只写本 Attempt 的 runtime config。
+            if (!(await sb.pathExists(`${workspace}/AGENTS.md`))) {
+                await shared_ts_1.shared.writeFile(sb, `${workspace}/AGENTS.md`, [
+                    `You are a coding agent working in a Next.js project at ${workspace}.`,
+                    ``,
+                    `Implement the requested feature by writing files directly to disk with the available tools:`,
+                    `- fs_write(path, content): create or overwrite a file`,
+                    `- fs_edit(path, old, new): edit an existing file`,
+                    `- bash(cmd): run shell commands`,
+                    ``,
+                    `Do NOT respond with only a text explanation — write the actual code files.`,
+                    `After writing, verify with bash("cd ${workspace} && npm run build").`,
+                ].join("\n"));
+            }
+            const manifest = { skills: [] };
+            if (config?.skills?.length) {
+                manifest.skills = await (0, skills_ts_1.installSkills)(sb, config.skills, { dir: SKILL_DIR });
+                // bub 没有原生 Skill 加载机制:装进目录不等于会被读到,发现指引跟着一起写。
+                await (0, skills_ts_1.appendProjectInstruction)(sb, (0, skills_ts_1.skillDiscoveryInstruction)(SKILL_DIR, (0, skills_ts_1.installedSkillNames)(manifest.skills)));
+            }
+            if (packages.length)
+                manifest.pythonPlugins = packages.map((pkg) => ({ package: pkg }));
+            if (manifest.skills.length || manifest.pythonPlugins?.length) {
+                ctx.reportSetup(manifest);
+            }
+            // 安装后钩子(postSetup):排在 manifest 之后——manifest 审计 Adapter 自身的安装事实,
+            // 钩子失败不该丢掉这份证据。
+            await (0, post_setup_ts_1.runPostSetupHooks)(sb, ctx, "bub", config?.postSetup);
+        },
+        async teardown(sb, ctx) {
+            // preTeardown 与 postSetup 成对:LIFO 镜像,先于 agent 自己的收尾步骤执行。
+            // bub 目前没有其它收尾步骤,这段就是整个 teardown。
+            await (0, post_setup_ts_1.runPreTeardownHooks)(sb, ctx, "bub", config?.preTeardown);
+        },
+        async send(input, ctx) {
+            const sb = ctx.sandbox;
+            const info = sessionInfo.get(sb.sandboxId);
+            if (!info)
+                throw new Error((0, index_ts_1.t)("bub.setupNotRun"));
+            const { home, workspace } = info;
+            const bubHome = `${home}/.bub`;
+            // 会话契约:ctx.session.id 未记录时开新 tape(新 sessionId),否则 resume 传入的 id。
+            // tape 路径由 md5(workspace)+md5(sessionId) 决定,同沙箱多会话靠 sessionId 区分。
+            const sessionId = ctx.session.id ?? `fe-${sb.sandboxId}-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+            ctx.session.capture(sessionId);
+            const apiKey = getApiKey();
+            const env = {
+                BUB_API_KEY: apiKey,
+                BUB_API_BASE: getApiBase(),
+                BUB_HOME: bubHome,
+                ...ctx.telemetry?.env,
+            };
+            // model 归属:实验决定(ctx.model),省略时交给 bub 原生默认 / 用户环境,不硬编码。
+            if (ctx.model)
+                env.BUB_MODEL = `openai:${ctx.model}`;
+            const res = await sb.runShell(`${BUB} --workspace ${workspace} run ${shared_ts_1.shared.shellQuote(input.text)} --session-id ${sessionId}`, { env, sensitiveValues: [apiKey], stream: true });
+            const raw = await sb.readText(tapePath(workspace, sessionId, bubHome)).catch(() => undefined);
+            const parsed = shared_ts_1.shared.parseBub(raw);
+            const events = [...parsed.events];
+            let turnEvidenceCoverage;
+            if (!raw?.trim()) {
+                const reason = "Bub tape was unavailable; tool trajectory was not observed.";
+                turnEvidenceCoverage = {
+                    events: { status: "unavailable", reason },
+                    actions: { status: "unavailable", reason },
+                    usage: { status: "unavailable", reason },
+                };
+            }
+            else if (!parsed.parseSuccess) {
+                const reason = "Some Bub tape lines could not be parsed.";
+                turnEvidenceCoverage = {
+                    events: { status: "partial", reason },
+                    actions: { status: "partial", reason },
+                };
+            }
+            else {
+                turnEvidenceCoverage = (0, command_projection_ts_1.unclassifiedToolActionsCoverage)(events);
+            }
+            if (res.exitCode !== 0) {
+                throw (0, send_failures_ts_1.makeSendFailure)({
+                    acceptance: (0, send_failures_ts_1.sendAcceptanceFromEvents)(events),
+                    message: shared_ts_1.shared.diagnoseFailure(res, parsed.events, raw),
+                    events,
+                    usage: parsed.usage,
+                    process: res,
+                });
+            }
+            return {
+                events,
+                usage: parsed.usage,
+                status: "completed",
+                ...(turnEvidenceCoverage === undefined ? {} : { evidenceCoverage: turnEvidenceCoverage }),
+            };
+        },
+    }), config?.postSetup, config?.preTeardown);
+}
+exports.default = bubAgent();
+//# sourceMappingURL=bub.cjs.map

package/dist/agents/bub.cjs.map

@@ -0,0 +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"]}

package/dist/agents/bub.d.cts

@@ -0,0 +1,57 @@
+import type { Agent, SkillSpec } from "../types.cjs";
+import type { SandboxCommand } from "../sandbox/commands.cjs";
+/**
+ * Bub 的扩展单元 —— **只属于 Bub**:Bub 的插件是运行环境里的 Python Package,
+ * 与 Claude Code / Codex 的 native plugin 没有共同的安装协议,不共用类型。
+ */
+export interface PythonPluginSpec {
+    /** PyPI Package、Version Specifier 或 Git URL(如 `bub-plugin-memory==1.3.0`、`git+https://…@8f3c1a2`)。 */
+    package: string;
+}
+export interface BubConfig {
+    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */
+    apiKey?: string;
+    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */
+    apiBase?: string;
+    /**
+     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。
+     * 落在 `.agents/skills/<name>/`,并写一段发现指引进 AGENTS.md(bub 没有原生 Skill 加载机制)。
+     */
+    skills?: SkillSpec[];
+    /**
+     * 装哪一版 Bub(PyPI 版本号,如 `"0.4.0"`)。省略时用 NiceEval 钉的默认版本;
+     * 永远是确定版本,不装 latest —— 被测对象的版本要能从实验配置读出来。
+     */
+    version?: string;
+    /**
+     * OTel tape store 插件的 git 依赖(时间轨的来源)。省略时用 NiceEval 钉的默认 pin。
+     *
+     * 插件与 Bub 的 tape 协议同代:默认 pin 从 `bub.tape` 取类型,要求 Bub ≥ 0.3.10;更早的
+     * 插件 commit 按 republic 的类型校验,配 Bub ≤ 0.3.9。配错代不会安装失败,而是 span 全被拒、
+     * 时间轨静默为空 —— 所以往回钉 `version` 时必须同批钉配套的插件 commit。
+     */
+    otelPlugin?: string;
+    /**
+     * 额外装进 bub tool 环境的 Python Package,每个 Sandbox setup 时进 `uv tool install … --with <pkg>`。
+     * 规范化后的 package 列表进安装 checkpoint key:plugin 集合不同的两个 agent 变体不会复用同一个
+     * 安装 checkpoint(否则第二个变体会静默拿到第一个变体的环境)。
+     */
+    pythonPlugins?: PythonPluginSpec[];
+    /**
+     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在装 bub、装 Skills /
+     * Python package、写 manifest 全部完成后执行。抛错按基础设施错误计(attempt errored)。
+     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
+     */
+    postSetup?: SandboxCommand[];
+    /**
+     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤
+     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾
+     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段
+     * 按 teardown-failed 诊断收束。
+     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
+     */
+    preTeardown?: SandboxCommand[];
+}
+export declare function bubAgent(config?: BubConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/bub.d.mts

@@ -0,0 +1,57 @@
+import type { Agent, SkillSpec } from "../types.mjs";
+import type { SandboxCommand } from "../sandbox/commands.mjs";
+/**
+ * Bub 的扩展单元 —— **只属于 Bub**:Bub 的插件是运行环境里的 Python Package,
+ * 与 Claude Code / Codex 的 native plugin 没有共同的安装协议,不共用类型。
+ */
+export interface PythonPluginSpec {
+    /** PyPI Package、Version Specifier 或 Git URL(如 `bub-plugin-memory==1.3.0`、`git+https://…@8f3c1a2`)。 */
+    package: string;
+}
+export interface BubConfig {
+    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */
+    apiKey?: string;
+    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */
+    apiBase?: string;
+    /**
+     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。
+     * 落在 `.agents/skills/<name>/`,并写一段发现指引进 AGENTS.md(bub 没有原生 Skill 加载机制)。
+     */
+    skills?: SkillSpec[];
+    /**
+     * 装哪一版 Bub(PyPI 版本号,如 `"0.4.0"`)。省略时用 NiceEval 钉的默认版本;
+     * 永远是确定版本,不装 latest —— 被测对象的版本要能从实验配置读出来。
+     */
+    version?: string;
+    /**
+     * OTel tape store 插件的 git 依赖(时间轨的来源)。省略时用 NiceEval 钉的默认 pin。
+     *
+     * 插件与 Bub 的 tape 协议同代:默认 pin 从 `bub.tape` 取类型,要求 Bub ≥ 0.3.10;更早的
+     * 插件 commit 按 republic 的类型校验,配 Bub ≤ 0.3.9。配错代不会安装失败,而是 span 全被拒、
+     * 时间轨静默为空 —— 所以往回钉 `version` 时必须同批钉配套的插件 commit。
+     */
+    otelPlugin?: string;
+    /**
+     * 额外装进 bub tool 环境的 Python Package,每个 Sandbox setup 时进 `uv tool install … --with <pkg>`。
+     * 规范化后的 package 列表进安装 checkpoint key:plugin 集合不同的两个 agent 变体不会复用同一个
+     * 安装 checkpoint(否则第二个变体会静默拿到第一个变体的环境)。
+     */
+    pythonPlugins?: PythonPluginSpec[];
+    /**
+     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在装 bub、装 Skills /
+     * Python package、写 manifest 全部完成后执行。抛错按基础设施错误计(attempt errored)。
+     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
+     */
+    postSetup?: SandboxCommand[];
+    /**
+     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤
+     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾
+     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段
+     * 按 teardown-failed 诊断收束。
+     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
+     */
+    preTeardown?: SandboxCommand[];
+}
+export declare function bubAgent(config?: BubConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/bub.d.ts

@@ -0,0 +1,57 @@
+import type { Agent, SkillSpec } from "../types.js";
+import type { SandboxCommand } from "../sandbox/commands.js";
+/**
+ * Bub 的扩展单元 —— **只属于 Bub**:Bub 的插件是运行环境里的 Python Package,
+ * 与 Claude Code / Codex 的 native plugin 没有共同的安装协议,不共用类型。
+ */
+export interface PythonPluginSpec {
+    /** PyPI Package、Version Specifier 或 Git URL(如 `bub-plugin-memory==1.3.0`、`git+https://…@8f3c1a2`)。 */
+    package: string;
+}
+export interface BubConfig {
+    /** OpenAI 兼容代理的 API key。省略时读 BUB_API_KEY env。 */
+    apiKey?: string;
+    /** OpenAI 兼容代理的 base URL。省略时读 BUB_API_BASE env。 */
+    apiBase?: string;
+    /**
+     * 装进 Sandbox 的 Skill(本地目录/文件,或 repo + 可钉 ref + 可选启用集)。
+     * 落在 `.agents/skills/<name>/`,并写一段发现指引进 AGENTS.md(bub 没有原生 Skill 加载机制)。
+     */
+    skills?: SkillSpec[];
+    /**
+     * 装哪一版 Bub(PyPI 版本号,如 `"0.4.0"`)。省略时用 NiceEval 钉的默认版本;
+     * 永远是确定版本,不装 latest —— 被测对象的版本要能从实验配置读出来。
+     */
+    version?: string;
+    /**
+     * OTel tape store 插件的 git 依赖(时间轨的来源)。省略时用 NiceEval 钉的默认 pin。
+     *
+     * 插件与 Bub 的 tape 协议同代:默认 pin 从 `bub.tape` 取类型,要求 Bub ≥ 0.3.10;更早的
+     * 插件 commit 按 republic 的类型校验,配 Bub ≤ 0.3.9。配错代不会安装失败,而是 span 全被拒、
+     * 时间轨静默为空 —— 所以往回钉 `version` 时必须同批钉配套的插件 commit。
+     */
+    otelPlugin?: string;
+    /**
+     * 额外装进 bub tool 环境的 Python Package,每个 Sandbox setup 时进 `uv tool install … --with <pkg>`。
+     * 规范化后的 package 列表进安装 checkpoint key:plugin 集合不同的两个 agent 变体不会复用同一个
+     * 安装 checkpoint(否则第二个变体会静默拿到第一个变体的环境)。
+     */
+    pythonPlugins?: PythonPluginSpec[];
+    /**
+     * 安装后按数组顺序运行的用户 Hook(复用 SandboxCommand 的窄上下文):在装 bub、装 Skills /
+     * Python package、写 manifest 全部完成后执行。抛错按基础设施错误计(attempt errored)。
+     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
+     */
+    postSetup?: SandboxCommand[];
+    /**
+     * 与 `postSetup` 成对的收尾 Hook:按 `postSetup` 的逆序语义,在 agent 自己的 teardown 步骤
+     * 之前执行(LIFO 镜像 —— `postSetup` 跑在 agent 安装之后,`preTeardown` 就跑在 agent 收尾
+     * 之前),当且仅当 `postSetup` 的时点走到过才触发。抛错按基础设施错误计,由 teardown 段
+     * 按 teardown-failed 诊断收束。
+     * 见 docs/feature/adapters/library/coding-agent-extensions.md「安装后运行脚本」。
+     */
+    preTeardown?: SandboxCommand[];
+}
+export declare function bubAgent(config?: BubConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/bub.js

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

package/dist/agents/bub.js.map

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

package/dist/agents/builtin.cjs

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_AGENTS = void 0;
+const claude_code_ts_1 = __importDefault(require("./claude-code.cjs"));
+const codex_ts_1 = __importDefault(require("./codex.cjs"));
+const bub_ts_1 = __importDefault(require("./bub.cjs"));
+const opencode_ts_1 = __importDefault(require("./opencode.cjs"));
+const hermes_ts_1 = __importDefault(require("./hermes.cjs"));
+const openclaw_ts_1 = __importDefault(require("./openclaw.cjs"));
+exports.BUILTIN_AGENTS = [
+    claude_code_ts_1.default,
+    codex_ts_1.default,
+    bub_ts_1.default,
+    opencode_ts_1.default,
+    hermes_ts_1.default,
+    openclaw_ts_1.default,
+];
+//# sourceMappingURL=builtin.cjs.map

package/dist/agents/builtin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.js","sourceRoot":"","sources":["builtin.ts"],"names":[],"mappings":";;;;;;AAAA,sEAAiD;AACjD,0DAAsC;AACtC,sDAAkC;AAClC,gEAA4C;AAC5C,4DAAwC;AACxC,gEAA4C;AAE/B,QAAA,cAAc,GAAqB;IAC5C,wBAAiB;IACjB,kBAAY;IACZ,gBAAU;IACV,qBAAe;IACf,mBAAa;IACb,qBAAe;CAClB,CAAC","sourcesContent":["import claudeCodeDefault from \"./claude-code.ts\";\nimport codexDefault from \"./codex.ts\";\nimport bubDefault from \"./bub.ts\";\nimport openCodeDefault from \"./opencode.ts\";\nimport hermesDefault from \"./hermes.ts\";\nimport openClawDefault from \"./openclaw.ts\";\nimport type { Agent } from \"../types.ts\";\nexport const BUILTIN_AGENTS: readonly Agent[] = [\n    claudeCodeDefault,\n    codexDefault,\n    bubDefault,\n    openCodeDefault,\n    hermesDefault,\n    openClawDefault,\n];\n"]}

package/dist/agents/builtin.d.cts

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

package/dist/agents/builtin.d.mts

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