niceeval 0.12.1 → 0.12.2-canary.31

package/dist/agents/coding-cli-versions.d.mts

@@ -0,0 +1,40 @@
+/** Coding-agent CLI versions used by runtime fallback installs and official sandbox recipes. */
+export declare const DEFAULT_CODEX_CLI_VERSION = "0.144.1";
+export declare const DEFAULT_CLAUDE_CODE_CLI_VERSION = "2.1.207";
+/**
+ * Bub release installed from PyPI by runtime fallback installs and official sandbox recipes.
+ *
+ * 换版本时同批核对 `bub-install-spec.ts` 的 OTel 插件 pin：插件与 Bub 的 tape 协议同代，
+ * 配错代不会安装失败，而是时间轨静默为空。
+ */
+export declare const DEFAULT_BUB_VERSION = "0.4.0";
+/** OpenCode CLI（npm `opencode-ai`）默认钉的版本。 */
+export declare const DEFAULT_OPENCODE_CLI_VERSION = "1.18.5";
+/** Hermes Agent（PyPI `hermes-agent`）默认钉的版本。 */
+export declare const DEFAULT_HERMES_CLI_VERSION = "0.19.0";
+/** OpenClaw CLI（npm `openclaw`）默认钉的版本。 */
+export declare const DEFAULT_OPENCLAW_CLI_VERSION = "2026.7.1-2";
+/**
+ * 有官方公共基线制品的内置 coding agent。
+ *
+ * Docker 侧六家齐全；E2B 侧目前只发布 Claude Code / Codex / Bub
+ *（见 `E2BCodingAgent`），其余 Agent 的 E2B 模板尚未进台账。
+ */
+export type CodingAgentBaseline = "claude-code" | "codex" | "bub" | "opencode" | "hermes" | "openclaw";
+/** 每个官方基线制品里装的那个 Agent 的版本——制品版本号的版本位。 */
+export declare const AGENT_BASELINE_VERSION: globalThis.Record<CodingAgentBaseline, string>;
+/**
+ * NiceEval 基线配方自身的修订号——制品版本号的 `-r` 位。
+ *
+ * Agent 版本没变、配方变了（Node 工具契约、PATH 规范化、换 pin 的 commit、插件集合）就 +1；
+ * Agent 版本一变归 1。已发布的 tag 不可原地覆盖，配方变更必须在版本里有位置表达。
+ * 一个 Agent 的 E2B 与 Docker 制品共用这个号：一个版本号 = 一套基线配方，两侧同步重建。
+ */
+export declare const AGENT_BASELINE_RECIPE_REVISION: globalThis.Record<CodingAgentBaseline, number>;
+/**
+ * 官方基线制品的版本 tag：`<Agent 版本>-r<配方修订>`，如 `0.144.1-r2`。
+ *
+ * niceeval 自身的版本不参与命名——库与制品内容无关，发版不该连带重建没变的制品，
+ * 换 Agent 版本也不该等库发版。
+ */
+export declare function agentBaselineVersionTag(agent: CodingAgentBaseline): string;

package/dist/agents/coding-cli-versions.d.ts

@@ -0,0 +1,40 @@
+/** Coding-agent CLI versions used by runtime fallback installs and official sandbox recipes. */
+export declare const DEFAULT_CODEX_CLI_VERSION = "0.144.1";
+export declare const DEFAULT_CLAUDE_CODE_CLI_VERSION = "2.1.207";
+/**
+ * Bub release installed from PyPI by runtime fallback installs and official sandbox recipes.
+ *
+ * 换版本时同批核对 `bub-install-spec.ts` 的 OTel 插件 pin：插件与 Bub 的 tape 协议同代，
+ * 配错代不会安装失败，而是时间轨静默为空。
+ */
+export declare const DEFAULT_BUB_VERSION = "0.4.0";
+/** OpenCode CLI（npm `opencode-ai`）默认钉的版本。 */
+export declare const DEFAULT_OPENCODE_CLI_VERSION = "1.18.5";
+/** Hermes Agent（PyPI `hermes-agent`）默认钉的版本。 */
+export declare const DEFAULT_HERMES_CLI_VERSION = "0.19.0";
+/** OpenClaw CLI（npm `openclaw`）默认钉的版本。 */
+export declare const DEFAULT_OPENCLAW_CLI_VERSION = "2026.7.1-2";
+/**
+ * 有官方公共基线制品的内置 coding agent。
+ *
+ * Docker 侧六家齐全；E2B 侧目前只发布 Claude Code / Codex / Bub
+ *（见 `E2BCodingAgent`），其余 Agent 的 E2B 模板尚未进台账。
+ */
+export type CodingAgentBaseline = "claude-code" | "codex" | "bub" | "opencode" | "hermes" | "openclaw";
+/** 每个官方基线制品里装的那个 Agent 的版本——制品版本号的版本位。 */
+export declare const AGENT_BASELINE_VERSION: globalThis.Record<CodingAgentBaseline, string>;
+/**
+ * NiceEval 基线配方自身的修订号——制品版本号的 `-r` 位。
+ *
+ * Agent 版本没变、配方变了（Node 工具契约、PATH 规范化、换 pin 的 commit、插件集合）就 +1；
+ * Agent 版本一变归 1。已发布的 tag 不可原地覆盖，配方变更必须在版本里有位置表达。
+ * 一个 Agent 的 E2B 与 Docker 制品共用这个号：一个版本号 = 一套基线配方，两侧同步重建。
+ */
+export declare const AGENT_BASELINE_RECIPE_REVISION: globalThis.Record<CodingAgentBaseline, number>;
+/**
+ * 官方基线制品的版本 tag：`<Agent 版本>-r<配方修订>`，如 `0.144.1-r2`。
+ *
+ * niceeval 自身的版本不参与命名——库与制品内容无关，发版不该连带重建没变的制品，
+ * 换 Agent 版本也不该等库发版。
+ */
+export declare function agentBaselineVersionTag(agent: CodingAgentBaseline): string;

package/dist/agents/coding-cli-versions.js

@@ -0,0 +1,22 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./coding-cli-versions.cjs");
+const __niceevalExport0 = __niceevalCanonical["AGENT_BASELINE_RECIPE_REVISION"];
+export { __niceevalExport0 as AGENT_BASELINE_RECIPE_REVISION };
+const __niceevalExport1 = __niceevalCanonical["AGENT_BASELINE_VERSION"];
+export { __niceevalExport1 as AGENT_BASELINE_VERSION };
+const __niceevalExport2 = __niceevalCanonical["DEFAULT_BUB_VERSION"];
+export { __niceevalExport2 as DEFAULT_BUB_VERSION };
+const __niceevalExport3 = __niceevalCanonical["DEFAULT_CLAUDE_CODE_CLI_VERSION"];
+export { __niceevalExport3 as DEFAULT_CLAUDE_CODE_CLI_VERSION };
+const __niceevalExport4 = __niceevalCanonical["DEFAULT_CODEX_CLI_VERSION"];
+export { __niceevalExport4 as DEFAULT_CODEX_CLI_VERSION };
+const __niceevalExport5 = __niceevalCanonical["DEFAULT_HERMES_CLI_VERSION"];
+export { __niceevalExport5 as DEFAULT_HERMES_CLI_VERSION };
+const __niceevalExport6 = __niceevalCanonical["DEFAULT_OPENCLAW_CLI_VERSION"];
+export { __niceevalExport6 as DEFAULT_OPENCLAW_CLI_VERSION };
+const __niceevalExport7 = __niceevalCanonical["DEFAULT_OPENCODE_CLI_VERSION"];
+export { __niceevalExport7 as DEFAULT_OPENCODE_CLI_VERSION };
+const __niceevalExport8 = __niceevalCanonical["agentBaselineVersionTag"];
+export { __niceevalExport8 as agentBaselineVersionTag };
+//# sourceMappingURL=coding-cli-versions.js.map

package/dist/agents/coding-cli-versions.js.map

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

package/dist/agents/hermes.cjs

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hermesAgent = hermesAgent;
+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 canonical_ts_1 = require("../o11y/otlp/canonical.cjs");
+const command_projection_ts_1 = require("../o11y/command-projection.cjs");
+const coverage_ts_1 = require("../assertions/coverage.cjs");
+const hermes_ts_1 = require("../o11y/parsers/hermes.cjs");
+const coding_cli_versions_ts_1 = require("./coding-cli-versions.cjs");
+const shell_ts_1 = require("../sandbox/shell.cjs");
+const send_failures_ts_1 = require("../context/send-failures.cjs");
+const commands_ts_1 = require("../sandbox/commands.cjs");
+// Hermes Agent sandbox adapter。驱动:`hermes chat -q … --yolo`;
+// 行为轨优先 `hermes sessions export`,不足时 sqlite 读 messages。
+// 契约见 docs/feature/adapters/sdk/hermes/README.md。
+//
+// Docker 沙箱会覆盖 PATH(不含 $HOME/.local/bin),所以安装与调用一律走
+// `$HOME/.local/bin/hermes`(同 bub 裁决),不依赖 command -v。
+const UV = "$HOME/.local/bin/uv";
+const HERMES = "$HOME/.local/bin/hermes";
+function resolveApiKey(config) {
+    return (config?.apiKey ??
+        (0, util_ts_1.getEnv)("HERMES_API_KEY") ??
+        (0, util_ts_1.getEnv)("OPENROUTER_API_KEY") ??
+        (0, util_ts_1.requireEnv)("ANTHROPIC_API_KEY"));
+}
+function resolveBaseUrl(config) {
+    return config?.baseUrl ?? (0, util_ts_1.getEnv)("HERMES_API_BASE");
+}
+async function hermesShell(sb, args, env, opts) {
+    // HERMES 变量本身不要 quote,以便 shell 展开 $HOME。
+    const script = `${HERMES} ${args.map(shell_ts_1.shellQuote).join(" ")}`;
+    return sb.runShell(script, {
+        env,
+        sensitiveValues: opts?.sensitiveValues,
+        stream: opts?.stream,
+    });
+}
+async function exportSession(sb, sessionId, env, sensitiveValues) {
+    const outPath = `/tmp/niceeval-hermes-${sessionId}.jsonl`;
+    const res = await hermesShell(sb, ["sessions", "export", outPath, "--session-id", sessionId], env, { sensitiveValues });
+    if (res.exitCode !== 0)
+        return undefined;
+    try {
+        return await sb.readText(outPath);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function dumpMessagesFromDb(sb, sessionId) {
+    // 不引入宿主 sqlite3 依赖:在沙箱里用 python 读 state.db(Hermes 自带 Python 运行时)。
+    const script = `
+import json, sqlite3, os, sys
+db = os.path.expanduser("~/.hermes/state.db")
+if not os.path.exists(db):
+    sys.exit(0)
+con = sqlite3.connect(db)
+con.row_factory = sqlite3.Row
+sid = sys.argv[1]
+sess = con.execute("SELECT * FROM sessions WHERE id = ?", (sid,)).fetchone()
+if sess:
+    print(json.dumps(dict(sess), default=str))
+rows = con.execute(
+    "SELECT role, content, tool_call_id, tool_calls, tool_name, reasoning, reasoning_content FROM messages WHERE session_id = ? ORDER BY timestamp, id",
+    (sid,),
+).fetchall()
+for r in rows:
+    print(json.dumps(dict(r), default=str))
+`;
+    const res = await sb.runShell(`python3 -c ${(0, shell_ts_1.shellQuote)(script)} ${(0, shell_ts_1.shellQuote)(sessionId)}`);
+    if (res.exitCode !== 0 || !res.stdout.trim())
+        return undefined;
+    return res.stdout;
+}
+/** Hermes 只扫描其 profile home 下的 skills，不扫描 attempt 工作目录。 */
+async function hermesSkillDir(sb) {
+    const home = await sb.runShell('test -n "$HOME" && printf "%s" "$HOME"');
+    const path = home.stdout.trim();
+    if (home.exitCode !== 0 || !path.startsWith("/")) {
+        throw new Error("Hermes skill installation requires an absolute sandbox HOME directory");
+    }
+    return `${path}/.hermes/skills`;
+}
+/**
+ * Hermes Agent 的内置 sandbox Agent 工厂。
+ */
+function hermesAgent(config) {
+    const version = config?.version ?? coding_cli_versions_ts_1.DEFAULT_HERMES_CLI_VERSION;
+    const identity = { agent: "hermes", version, revision: "1" };
+    const probe = (0, commands_ts_1.defineSandboxCommand)({ id: "niceeval.agent.probe.hermes", revision: identity.revision, inputs: identity }, async (sandbox) => {
+        await sandbox.runShellOrThrow(`test -x ${HERMES} && ${HERMES} --version 2>&1 | grep -F -- ${(0, shell_ts_1.shellQuote)(version)}`);
+    });
+    return (0, define_ts_1.defineSandboxAgent)({
+        name: "hermes",
+        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.runShellOrThrow(`${UV} tool install hermes-agent==${version}`);
+                },
+            }],
+        evidenceCoverage: coverage_ts_1.completeEvidenceCoverage,
+        spanMapper: canonical_ts_1.mapGenericSpans,
+        async setup(sb, ctx) {
+            const baseUrl = resolveBaseUrl(config);
+            if (baseUrl) {
+                // OpenAI 兼容网关:写 custom provider + model.base_url;
+                // secret 进 ~/.hermes/.env,不进 git 可见配置。
+                const apiKey = resolveApiKey(config);
+                const hermesConfig = [
+                    "model:",
+                    "  provider: custom",
+                    `  base_url: ${baseUrl}`,
+                    "custom_providers:",
+                    "  - name: compat",
+                    `    base_url: ${baseUrl}`,
+                    `    api_key: ${apiKey}`,
+                    "",
+                ].join("\n");
+                const hermesEnv = [
+                    `OPENAI_API_KEY=${apiKey}`,
+                    `OPENAI_BASE_URL=${baseUrl}`,
+                    "",
+                ].join("\n");
+                await shared_ts_1.shared.writeFile(sb, "~/.hermes/config.yaml", hermesConfig, { sensitiveValues: [apiKey] });
+                await shared_ts_1.shared.writeFile(sb, "~/.hermes/.env", hermesEnv, { sensitiveValues: [apiKey] });
+            }
+            const manifest = { skills: [] };
+            if (config?.skills?.length) {
+                const skillDir = await hermesSkillDir(sb);
+                manifest.skills = await (0, skills_ts_1.installSkills)(sb, config.skills, { dir: skillDir });
+                await (0, skills_ts_1.appendProjectInstruction)(sb, (0, skills_ts_1.skillDiscoveryInstruction)(skillDir, (0, skills_ts_1.installedSkillNames)(manifest.skills)));
+            }
+            if (manifest.skills.length) {
+                ctx.reportSetup(manifest);
+            }
+        },
+        async send(input, ctx) {
+            const sb = ctx.sandbox;
+            const baseUrl = resolveBaseUrl(config);
+            const args = ["chat", "-q", input.text, "--yolo", "-Q"];
+            if (ctx.model)
+                args.push("--model", ctx.model);
+            if (baseUrl)
+                args.push("--provider", "custom");
+            if (ctx.session.id)
+                args.push("--resume", ctx.session.id);
+            const apiKey = resolveApiKey(config);
+            const env = {
+                HERMES_API_KEY: apiKey,
+                ANTHROPIC_API_KEY: apiKey,
+                OPENROUTER_API_KEY: apiKey,
+                OPENAI_API_KEY: apiKey,
+                HERMES_YOLO_MODE: "1",
+                ...ctx.telemetry?.env,
+            };
+            if (baseUrl) {
+                env.HERMES_API_BASE = baseUrl;
+                env.OPENAI_BASE_URL = baseUrl;
+                env.ANTHROPIC_BASE_URL = baseUrl;
+            }
+            const sensitiveValues = [apiKey];
+            const res = await hermesShell(sb, args, env, { stream: true, sensitiveValues });
+            let sessionId = (0, hermes_ts_1.sessionIdFromHermesOutput)(res.stdout) ??
+                (0, hermes_ts_1.sessionIdFromHermesOutput)(res.stderr) ??
+                ctx.session.id;
+            // 没从输出抠到 id 时,取 state.db 里最新 cli session
+            if (!sessionId) {
+                const latest = await sb.runShell(`python3 -c 'import sqlite3,os;db=os.path.expanduser("~/.hermes/state.db");
+import sys
+if not os.path.exists(db): sys.exit(0)
+c=sqlite3.connect(db)
+r=c.execute("select id from sessions where source=\\"cli\\" order by started_at desc limit 1").fetchone()
+print(r[0] if r else "")'`);
+                const id = latest.stdout.trim();
+                if (id)
+                    sessionId = id;
+            }
+            if (sessionId)
+                ctx.session.capture(sessionId);
+            let raw;
+            if (sessionId) {
+                raw = await exportSession(sb, sessionId, env, sensitiveValues);
+                if (!raw)
+                    raw = await dumpMessagesFromDb(sb, sessionId);
+            }
+            const parsed = (0, hermes_ts_1.parseHermesTranscript)(raw);
+            const events = [...parsed.events];
+            let turnEvidenceCoverage;
+            if (!raw || parsed.events.length === 0) {
+                const reason = "hermes session export/state.db unavailable; tool trajectory missing";
+                turnEvidenceCoverage = {
+                    events: { status: "unavailable", reason },
+                    actions: { status: "unavailable", reason },
+                    usage: { status: "unavailable", reason },
+                };
+                ctx.log("hermes transcript unavailable: negative assertions are unreliable");
+                const text = res.stdout.trim().split("\n").filter((l) => !l.startsWith("{")).slice(-8).join("\n");
+                if (text)
+                    events.push({ type: "message", role: "assistant", text });
+            }
+            else if (!parsed.parseSuccess) {
+                const reason = "some Hermes transcript lines could not be parsed";
+                turnEvidenceCoverage = {
+                    events: { status: "partial", reason },
+                    actions: { status: "partial", reason },
+                };
+            }
+            else {
+                turnEvidenceCoverage = (0, command_projection_ts_1.unclassifiedToolActionsCoverage)(events);
+            }
+            if (res.exitCode !== 0) {
+                throw (0, send_failures_ts_1.makeSendFailure)({
+                    acceptance: (0, send_failures_ts_1.sendAcceptanceFromEvents)(events),
+                    message: shared_ts_1.shared.diagnoseFailure(res, parsed.events, raw),
+                    events,
+                    usage: parsed.usage,
+                    process: res,
+                });
+            }
+            return {
+                events,
+                usage: parsed.usage,
+                status: "completed",
+                ...(turnEvidenceCoverage ? { evidenceCoverage: turnEvidenceCoverage } : {}),
+            };
+        },
+    });
+}
+exports.default = hermesAgent();
+//# sourceMappingURL=hermes.cjs.map

package/dist/agents/hermes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.js","sourceRoot":"","sources":["hermes.ts"],"names":[],"mappings":"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","sourcesContent":["import { defineSandboxAgent } from \"../define.ts\";\nimport { requireEnv, getEnv } from \"../util.ts\";\nimport { shared } from \"./shared.ts\";\nimport { appendProjectInstruction, installSkills, installedSkillNames, skillDiscoveryInstruction, } from \"./skills.ts\";\nimport { mapGenericSpans } from \"../o11y/otlp/canonical.ts\";\nimport { unclassifiedToolActionsCoverage } from \"../o11y/command-projection.ts\";\nimport { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport { parseHermesTranscript, sessionIdFromHermesOutput } from \"../o11y/parsers/hermes.ts\";\nimport { DEFAULT_HERMES_CLI_VERSION } from \"./coding-cli-versions.ts\";\nimport { shellQuote } from \"../sandbox/shell.ts\";\nimport type { Agent, AgentSetupManifest, Sandbox, SkillSpec, StreamEvent, TurnEvidenceCoverage } from \"../types.ts\";\nimport { makeSendFailure, sendAcceptanceFromEvents } from \"../context/send-failures.ts\";\nimport { defineSandboxCommand } from \"../sandbox/commands.ts\";\n// Hermes Agent sandbox adapter。驱动:`hermes chat -q … --yolo`;\n// 行为轨优先 `hermes sessions export`,不足时 sqlite 读 messages。\n// 契约见 docs/feature/adapters/sdk/hermes/README.md。\n//\n// Docker 沙箱会覆盖 PATH(不含 $HOME/.local/bin),所以安装与调用一律走\n// `$HOME/.local/bin/hermes`(同 bub 裁决),不依赖 command -v。\nconst UV = \"$HOME/.local/bin/uv\";\nconst HERMES = \"$HOME/.local/bin/hermes\";\nexport interface HermesConfig {\n    /** 模型 API key。省略时读 HERMES_API_KEY → OPENROUTER_API_KEY → ANTHROPIC_API_KEY。 */\n    apiKey?: string;\n    /** OpenAI 兼容端点。省略时读 HERMES_API_BASE。 */\n    baseUrl?: string;\n    /** 钉 PyPI `hermes-agent` 版本;省略时用 NiceEval 默认 pin。 */\n    version?: string;\n    /** 装进沙箱的 Skill,落在 `~/.hermes/skills/<name>/`。 */\n    skills?: SkillSpec[];\n}\nfunction resolveApiKey(config?: HermesConfig): string {\n    return (config?.apiKey ??\n        getEnv(\"HERMES_API_KEY\") ??\n        getEnv(\"OPENROUTER_API_KEY\") ??\n        requireEnv(\"ANTHROPIC_API_KEY\"));\n}\nfunction resolveBaseUrl(config?: HermesConfig): string | undefined {\n    return config?.baseUrl ?? getEnv(\"HERMES_API_BASE\");\n}\nasync function hermesShell(sb: Sandbox, args: string[], env: globalThis.Record<string, string>, opts?: {\n    stream?: boolean;\n    sensitiveValues?: readonly string[];\n}): Promise<{\n    exitCode: number;\n    stdout: string;\n    stderr: string;\n}> {\n    // HERMES 变量本身不要 quote,以便 shell 展开 $HOME。\n    const script = `${HERMES} ${args.map(shellQuote).join(\" \")}`;\n    return sb.runShell(script, {\n        env,\n        sensitiveValues: opts?.sensitiveValues,\n        stream: opts?.stream,\n    });\n}\nasync function exportSession(sb: Sandbox, sessionId: string, env: globalThis.Record<string, string>, sensitiveValues: readonly string[]): Promise<string | undefined> {\n    const outPath = `/tmp/niceeval-hermes-${sessionId}.jsonl`;\n    const res = await hermesShell(sb, [\"sessions\", \"export\", outPath, \"--session-id\", sessionId], env, { sensitiveValues });\n    if (res.exitCode !== 0)\n        return undefined;\n    try {\n        return await sb.readText(outPath);\n    }\n    catch {\n        return undefined;\n    }\n}\nasync function dumpMessagesFromDb(sb: Sandbox, sessionId: string): Promise<string | undefined> {\n    // 不引入宿主 sqlite3 依赖:在沙箱里用 python 读 state.db(Hermes 自带 Python 运行时)。\n    const script = `\nimport json, sqlite3, os, sys\ndb = os.path.expanduser(\"~/.hermes/state.db\")\nif not os.path.exists(db):\n    sys.exit(0)\ncon = sqlite3.connect(db)\ncon.row_factory = sqlite3.Row\nsid = sys.argv[1]\nsess = con.execute(\"SELECT * FROM sessions WHERE id = ?\", (sid,)).fetchone()\nif sess:\n    print(json.dumps(dict(sess), default=str))\nrows = con.execute(\n    \"SELECT role, content, tool_call_id, tool_calls, tool_name, reasoning, reasoning_content FROM messages WHERE session_id = ? ORDER BY timestamp, id\",\n    (sid,),\n).fetchall()\nfor r in rows:\n    print(json.dumps(dict(r), default=str))\n`;\n    const res = await sb.runShell(`python3 -c ${shellQuote(script)} ${shellQuote(sessionId)}`);\n    if (res.exitCode !== 0 || !res.stdout.trim())\n        return undefined;\n    return res.stdout;\n}\n/** Hermes 只扫描其 profile home 下的 skills，不扫描 attempt 工作目录。 */\nasync function hermesSkillDir(sb: Sandbox): Promise<string> {\n    const home = await sb.runShell('test -n \"$HOME\" && printf \"%s\" \"$HOME\"');\n    const path = home.stdout.trim();\n    if (home.exitCode !== 0 || !path.startsWith(\"/\")) {\n        throw new Error(\"Hermes skill installation requires an absolute sandbox HOME directory\");\n    }\n    return `${path}/.hermes/skills`;\n}\n/**\n * Hermes Agent 的内置 sandbox Agent 工厂。\n */\nexport function hermesAgent(config?: HermesConfig): Agent {\n    const version = config?.version ?? DEFAULT_HERMES_CLI_VERSION;\n    const identity = { agent: \"hermes\", version, revision: \"1\" } as const;\n    const probe = defineSandboxCommand({ id: \"niceeval.agent.probe.hermes\", revision: identity.revision, inputs: identity }, async (sandbox) => {\n        await sandbox.runShellOrThrow(`test -x ${HERMES} && ${HERMES} --version 2>&1 | grep -F -- ${shellQuote(version)}`);\n    });\n    return defineSandboxAgent({\n        name: \"hermes\",\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.runShellOrThrow(`${UV} tool install hermes-agent==${version}`);\n                },\n            }],\n        evidenceCoverage: completeEvidenceCoverage,\n        spanMapper: mapGenericSpans,\n        async setup(sb, ctx) {\n            const baseUrl = resolveBaseUrl(config);\n            if (baseUrl) {\n                // OpenAI 兼容网关:写 custom provider + model.base_url;\n                // secret 进 ~/.hermes/.env,不进 git 可见配置。\n                const apiKey = resolveApiKey(config);\n                const hermesConfig = [\n                    \"model:\",\n                    \"  provider: custom\",\n                    `  base_url: ${baseUrl}`,\n                    \"custom_providers:\",\n                    \"  - name: compat\",\n                    `    base_url: ${baseUrl}`,\n                    `    api_key: ${apiKey}`,\n                    \"\",\n                ].join(\"\\n\");\n                const hermesEnv = [\n                    `OPENAI_API_KEY=${apiKey}`,\n                    `OPENAI_BASE_URL=${baseUrl}`,\n                    \"\",\n                ].join(\"\\n\");\n                await shared.writeFile(sb, \"~/.hermes/config.yaml\", hermesConfig, { sensitiveValues: [apiKey] });\n                await shared.writeFile(sb, \"~/.hermes/.env\", hermesEnv, { sensitiveValues: [apiKey] });\n            }\n            const manifest: AgentSetupManifest = { skills: [] };\n            if (config?.skills?.length) {\n                const skillDir = await hermesSkillDir(sb);\n                manifest.skills = await installSkills(sb, config.skills, { dir: skillDir });\n                await appendProjectInstruction(sb, skillDiscoveryInstruction(skillDir, installedSkillNames(manifest.skills)));\n            }\n            if (manifest.skills.length) {\n                ctx.reportSetup(manifest);\n            }\n        },\n        async send(input, ctx) {\n            const sb = ctx.sandbox;\n            const baseUrl = resolveBaseUrl(config);\n            const args = [\"chat\", \"-q\", input.text, \"--yolo\", \"-Q\"];\n            if (ctx.model)\n                args.push(\"--model\", ctx.model);\n            if (baseUrl)\n                args.push(\"--provider\", \"custom\");\n            if (ctx.session.id)\n                args.push(\"--resume\", ctx.session.id);\n            const apiKey = resolveApiKey(config);\n            const env: globalThis.Record<string, string> = {\n                HERMES_API_KEY: apiKey,\n                ANTHROPIC_API_KEY: apiKey,\n                OPENROUTER_API_KEY: apiKey,\n                OPENAI_API_KEY: apiKey,\n                HERMES_YOLO_MODE: \"1\",\n                ...ctx.telemetry?.env,\n            };\n            if (baseUrl) {\n                env.HERMES_API_BASE = baseUrl;\n                env.OPENAI_BASE_URL = baseUrl;\n                env.ANTHROPIC_BASE_URL = baseUrl;\n            }\n            const sensitiveValues = [apiKey];\n            const res = await hermesShell(sb, args, env, { stream: true, sensitiveValues });\n            let sessionId = sessionIdFromHermesOutput(res.stdout) ??\n                sessionIdFromHermesOutput(res.stderr) ??\n                ctx.session.id;\n            // 没从输出抠到 id 时,取 state.db 里最新 cli session\n            if (!sessionId) {\n                const latest = await sb.runShell(`python3 -c 'import sqlite3,os;db=os.path.expanduser(\"~/.hermes/state.db\");\nimport sys\nif not os.path.exists(db): sys.exit(0)\nc=sqlite3.connect(db)\nr=c.execute(\"select id from sessions where source=\\\\\"cli\\\\\" order by started_at desc limit 1\").fetchone()\nprint(r[0] if r else \"\")'`);\n                const id = latest.stdout.trim();\n                if (id)\n                    sessionId = id;\n            }\n            if (sessionId)\n                ctx.session.capture(sessionId);\n            let raw: string | undefined;\n            if (sessionId) {\n                raw = await exportSession(sb, sessionId, env, sensitiveValues);\n                if (!raw)\n                    raw = await dumpMessagesFromDb(sb, sessionId);\n            }\n            const parsed = parseHermesTranscript(raw);\n            const events: StreamEvent[] = [...parsed.events];\n            let turnEvidenceCoverage: TurnEvidenceCoverage | undefined;\n            if (!raw || parsed.events.length === 0) {\n                const reason = \"hermes session export/state.db unavailable; tool trajectory missing\";\n                turnEvidenceCoverage = {\n                    events: { status: \"unavailable\", reason },\n                    actions: { status: \"unavailable\", reason },\n                    usage: { status: \"unavailable\", reason },\n                };\n                ctx.log(\"hermes transcript unavailable: negative assertions are unreliable\");\n                const text = res.stdout.trim().split(\"\\n\").filter((l) => !l.startsWith(\"{\")).slice(-8).join(\"\\n\");\n                if (text)\n                    events.push({ type: \"message\", role: \"assistant\", text });\n            }\n            else if (!parsed.parseSuccess) {\n                const reason = \"some Hermes transcript lines could not be parsed\";\n                turnEvidenceCoverage = {\n                    events: { status: \"partial\", reason },\n                    actions: { status: \"partial\", reason },\n                };\n            }\n            else {\n                turnEvidenceCoverage = unclassifiedToolActionsCoverage(events);\n            }\n            if (res.exitCode !== 0) {\n                throw makeSendFailure({\n                    acceptance: sendAcceptanceFromEvents(events),\n                    message: shared.diagnoseFailure(res, parsed.events, raw),\n                    events,\n                    usage: parsed.usage,\n                    process: res,\n                });\n            }\n            return {\n                events,\n                usage: parsed.usage,\n                status: \"completed\",\n                ...(turnEvidenceCoverage ? { evidenceCoverage: turnEvidenceCoverage } : {}),\n            };\n        },\n    });\n}\nexport default hermesAgent();\n"]}

package/dist/agents/hermes.d.cts

@@ -0,0 +1,17 @@
+import type { Agent, SkillSpec } from "../types.cjs";
+export interface HermesConfig {
+    /** 模型 API key。省略时读 HERMES_API_KEY → OPENROUTER_API_KEY → ANTHROPIC_API_KEY。 */
+    apiKey?: string;
+    /** OpenAI 兼容端点。省略时读 HERMES_API_BASE。 */
+    baseUrl?: string;
+    /** 钉 PyPI `hermes-agent` 版本;省略时用 NiceEval 默认 pin。 */
+    version?: string;
+    /** 装进沙箱的 Skill,落在 `~/.hermes/skills/<name>/`。 */
+    skills?: SkillSpec[];
+}
+/**
+ * Hermes Agent 的内置 sandbox Agent 工厂。
+ */
+export declare function hermesAgent(config?: HermesConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/hermes.d.mts

@@ -0,0 +1,17 @@
+import type { Agent, SkillSpec } from "../types.mjs";
+export interface HermesConfig {
+    /** 模型 API key。省略时读 HERMES_API_KEY → OPENROUTER_API_KEY → ANTHROPIC_API_KEY。 */
+    apiKey?: string;
+    /** OpenAI 兼容端点。省略时读 HERMES_API_BASE。 */
+    baseUrl?: string;
+    /** 钉 PyPI `hermes-agent` 版本;省略时用 NiceEval 默认 pin。 */
+    version?: string;
+    /** 装进沙箱的 Skill,落在 `~/.hermes/skills/<name>/`。 */
+    skills?: SkillSpec[];
+}
+/**
+ * Hermes Agent 的内置 sandbox Agent 工厂。
+ */
+export declare function hermesAgent(config?: HermesConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/hermes.d.ts

@@ -0,0 +1,17 @@
+import type { Agent, SkillSpec } from "../types.js";
+export interface HermesConfig {
+    /** 模型 API key。省略时读 HERMES_API_KEY → OPENROUTER_API_KEY → ANTHROPIC_API_KEY。 */
+    apiKey?: string;
+    /** OpenAI 兼容端点。省略时读 HERMES_API_BASE。 */
+    baseUrl?: string;
+    /** 钉 PyPI `hermes-agent` 版本;省略时用 NiceEval 默认 pin。 */
+    version?: string;
+    /** 装进沙箱的 Skill,落在 `~/.hermes/skills/<name>/`。 */
+    skills?: SkillSpec[];
+}
+/**
+ * Hermes Agent 的内置 sandbox Agent 工厂。
+ */
+export declare function hermesAgent(config?: HermesConfig): Agent;
+declare const _default: Agent;
+export default _default;

package/dist/agents/hermes.js

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

package/dist/agents/hermes.js.map

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

package/dist/agents/index.cjs

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openClawAgent = exports.hermesAgent = exports.openCodeAgent = exports.bubAgent = exports.codexAgent = exports.claudeCodeAgent = exports.BUILTIN_AGENTS = exports.aiSdkAgent = exports.turnFromAiSdk = exports.deltaStream = exports.driveFrameStream = exports.createLangGraphEventStream = exports.createCodexThreadEventStream = exports.createPiAgentEventStream = exports.createClaudeSdkEventStream = exports.sseJsonFrames = exports.turnFromResponses = exports.turnFromChatCompletion = exports.responsesEvidenceCoverage = exports.chatCompletionEvidenceCoverage = exports.uiMessageStreamAgent = exports.mapCodexSpans = exports.heuristicTag = exports.tagSpan = exports.normalizeExternalCause = exports.externalCauseText = exports.externalCauseMessageChain = exports.sendFailureText = exports.makeSendFailure = exports.opaqueCommandProjection = exports.notCommandProjection = exports.normalizeLogicalCommand = exports.commandProjection = exports.LOGICAL_COMMAND_NORMALIZER = exports.completeEvidenceCoverage = exports.agentBin = exports.createNpmCliInstaller = exports.shared = exports.createSessionSlot = exports.defineSandboxAgent = exports.defineAgent = void 0;
+// niceeval/adapter 公开导出:「连到哪个 AI」相关的类型 + 内置 adapter + 自定义 adapter 的入口。
+var define_ts_1 = require("../define.cjs");
+Object.defineProperty(exports, "defineAgent", { enumerable: true, get: function () { return define_ts_1.defineAgent; } });
+Object.defineProperty(exports, "defineSandboxAgent", { enumerable: true, get: function () { return define_ts_1.defineSandboxAgent; } });
+var session_slot_ts_1 = require("./session-slot.cjs");
+Object.defineProperty(exports, "createSessionSlot", { enumerable: true, get: function () { return session_slot_ts_1.createSessionSlot; } });
+var shared_ts_1 = require("./shared.cjs");
+Object.defineProperty(exports, "shared", { enumerable: true, get: function () { return shared_ts_1.shared; } });
+var npm_staged_ts_1 = require("./npm-staged.cjs");
+Object.defineProperty(exports, "createNpmCliInstaller", { enumerable: true, get: function () { return npm_staged_ts_1.createNpmCliInstaller; } });
+Object.defineProperty(exports, "agentBin", { enumerable: true, get: function () { return npm_staged_ts_1.agentBin; } });
+// 证据覆盖声明:官方 SDK 适配器声明全通道 complete 用 completeEvidenceCoverage;
+// 手写映射按实际情况声明(见 docs/feature/adapters/architecture/evidence.md)。
+var coverage_ts_1 = require("../assertions/coverage.cjs");
+Object.defineProperty(exports, "completeEvidenceCoverage", { enumerable: true, get: function () { return coverage_ts_1.completeEvidenceCoverage; } });
+// tool operation 的 command 分类只能由 Adapter 根据原生协议事实产生。
+// structured argv 走 commandProjection() 与同一 logical-command/v1 normalizer；
+// 无法安全取得 argv 时显式 opaque，确认不是 command 时显式 not-command。
+var command_projection_ts_1 = require("../o11y/command-projection.cjs");
+Object.defineProperty(exports, "LOGICAL_COMMAND_NORMALIZER", { enumerable: true, get: function () { return command_projection_ts_1.LOGICAL_COMMAND_NORMALIZER; } });
+Object.defineProperty(exports, "commandProjection", { enumerable: true, get: function () { return command_projection_ts_1.commandProjection; } });
+Object.defineProperty(exports, "normalizeLogicalCommand", { enumerable: true, get: function () { return command_projection_ts_1.normalizeLogicalCommand; } });
+Object.defineProperty(exports, "notCommandProjection", { enumerable: true, get: function () { return command_projection_ts_1.notCommandProjection; } });
+Object.defineProperty(exports, "opaqueCommandProjection", { enumerable: true, get: function () { return command_projection_ts_1.opaqueCommandProjection; } });
+// 执行失败分类:`Agent.classifySendFailure` 认的结构化 envelope 与同源摘要。两轴词表
+// (FailureClass / FailureScope)与包根导出的是同一个形状——adapter
+// 作者与 eval 作者各自的入口拿到同一份类型。判据、分类链与重试执行体见
+// docs/feature/error-classification/architecture.md。
+var send_failures_ts_1 = require("../context/send-failures.cjs");
+Object.defineProperty(exports, "makeSendFailure", { enumerable: true, get: function () { return send_failures_ts_1.makeSendFailure; } });
+Object.defineProperty(exports, "sendFailureText", { enumerable: true, get: function () { return send_failures_ts_1.sendFailureText; } });
+var external_cause_ts_1 = require("../shared/external-cause.cjs");
+Object.defineProperty(exports, "externalCauseMessageChain", { enumerable: true, get: function () { return external_cause_ts_1.externalCauseMessageChain; } });
+Object.defineProperty(exports, "externalCauseText", { enumerable: true, get: function () { return external_cause_ts_1.externalCauseText; } });
+Object.defineProperty(exports, "normalizeExternalCause", { enumerable: true, get: function () { return external_cause_ts_1.normalizeExternalCause; } });
+// span → canonical GenAI 归一(只服务瀑布图,不喂断言)。私有埋点写自己的 spanMapper 时用:
+// tagSpan 把判定写回 span(原属性只增不改),heuristicTag 是通用兜底判定;mapCodexSpans 是
+// 现成的参考实现(无侵入接 codex 后端时直接声明 `spanMapper: mapCodexSpans`)。
+// 映射目标(什么属性亮起瀑布图的什么)见 docs-site/zh/tutorials/connect-otel.mdx「瀑布图画得准不准」。
+var canonical_ts_1 = require("../o11y/otlp/canonical.cjs");
+Object.defineProperty(exports, "tagSpan", { enumerable: true, get: function () { return canonical_ts_1.tagSpan; } });
+Object.defineProperty(exports, "heuristicTag", { enumerable: true, get: function () { return canonical_ts_1.heuristicTag; } });
+var codex_ts_1 = require("../o11y/otlp/mappers/codex.cjs");
+Object.defineProperty(exports, "mapCodexSpans", { enumerable: true, get: function () { return codex_ts_1.mapCodexSpans; } });
+var ui_message_stream_ts_1 = require("./ui-message-stream.cjs");
+Object.defineProperty(exports, "uiMessageStreamAgent", { enumerable: true, get: function () { return ui_message_stream_ts_1.uiMessageStreamAgent; } });
+// 两种 OpenAI 响应形状(不限于 OpenAI 官方,任何声明兼容这两种协议形状的服务都能用)的
+// 官方转换器:整段响应 → Turn,零映射。
+var openai_compat_ts_1 = require("./openai-compat.cjs");
+Object.defineProperty(exports, "chatCompletionEvidenceCoverage", { enumerable: true, get: function () { return openai_compat_ts_1.chatCompletionEvidenceCoverage; } });
+Object.defineProperty(exports, "responsesEvidenceCoverage", { enumerable: true, get: function () { return openai_compat_ts_1.responsesEvidenceCoverage; } });
+Object.defineProperty(exports, "turnFromChatCompletion", { enumerable: true, get: function () { return openai_compat_ts_1.turnFromChatCompletion; } });
+Object.defineProperty(exports, "turnFromResponses", { enumerable: true, get: function () { return openai_compat_ts_1.turnFromResponses; } });
+// SDK 原生事件流 → 标准事件的官方转换器(无侵入 adapter 只剩传输粘合)+ 通用 SSE 读帧器。
+var sdk_streams_ts_1 = require("./sdk-streams.cjs");
+Object.defineProperty(exports, "sseJsonFrames", { enumerable: true, get: function () { return sdk_streams_ts_1.sseJsonFrames; } });
+Object.defineProperty(exports, "createClaudeSdkEventStream", { enumerable: true, get: function () { return sdk_streams_ts_1.createClaudeSdkEventStream; } });
+Object.defineProperty(exports, "createPiAgentEventStream", { enumerable: true, get: function () { return sdk_streams_ts_1.createPiAgentEventStream; } });
+Object.defineProperty(exports, "createCodexThreadEventStream", { enumerable: true, get: function () { return sdk_streams_ts_1.createCodexThreadEventStream; } });
+// LangGraph 官方事件流转换器(不绑定 transport,不提供 langGraphAgent 工厂)。
+var langgraph_ts_1 = require("./langgraph.cjs");
+Object.defineProperty(exports, "createLangGraphEventStream", { enumerable: true, get: function () { return langgraph_ts_1.createLangGraphEventStream; } });
+// 通用「拼装方式」件:逐帧驱动循环、逐 token/参数增量累加器。见 docs-site/zh/tutorials/write-send.mdx——
+// 这些和任何具体协议无关,自己写 adapter 时优先拿这些拼,只有 transport(怎么发)与
+// 「帧类型 → 操作」这张映射表才是真正要手写的。会话续接与 HITL 停轮现场不再是可选件,
+// 而是 ctx.session(AgentSession)本身的 typed slot 与 id/capture 存取器。
+var streaming_ts_1 = require("./streaming.cjs");
+Object.defineProperty(exports, "driveFrameStream", { enumerable: true, get: function () { return streaming_ts_1.driveFrameStream; } });
+Object.defineProperty(exports, "deltaStream", { enumerable: true, get: function () { return streaming_ts_1.deltaStream; } });
+// tracing 管线的内置实现 aiSdkOtel() 在 `niceeval/adapter/otel`(独立子路径,不从这里
+// re-export):OTel 三件套是可选 peer 依赖,只有 import 那个入口的项目才需要安装。
+var ai_sdk_ts_1 = require("./ai-sdk.cjs");
+Object.defineProperty(exports, "turnFromAiSdk", { enumerable: true, get: function () { return ai_sdk_ts_1.turnFromAiSdk; } });
+Object.defineProperty(exports, "aiSdkAgent", { enumerable: true, get: function () { return ai_sdk_ts_1.aiSdkAgent; } });
+var builtin_ts_1 = require("./builtin.cjs");
+Object.defineProperty(exports, "BUILTIN_AGENTS", { enumerable: true, get: function () { return builtin_ts_1.BUILTIN_AGENTS; } });
+var claude_code_ts_1 = require("./claude-code.cjs");
+Object.defineProperty(exports, "claudeCodeAgent", { enumerable: true, get: function () { return claude_code_ts_1.claudeCodeAgent; } });
+var codex_ts_2 = require("./codex.cjs");
+Object.defineProperty(exports, "codexAgent", { enumerable: true, get: function () { return codex_ts_2.codexAgent; } });
+var bub_ts_1 = require("./bub.cjs");
+Object.defineProperty(exports, "bubAgent", { enumerable: true, get: function () { return bub_ts_1.bubAgent; } });
+var opencode_ts_1 = require("./opencode.cjs");
+Object.defineProperty(exports, "openCodeAgent", { enumerable: true, get: function () { return opencode_ts_1.openCodeAgent; } });
+var hermes_ts_1 = require("./hermes.cjs");
+Object.defineProperty(exports, "hermesAgent", { enumerable: true, get: function () { return hermes_ts_1.hermesAgent; } });
+var openclaw_ts_1 = require("./openclaw.cjs");
+Object.defineProperty(exports, "openClawAgent", { enumerable: true, get: function () { return openclaw_ts_1.openClawAgent; } });
+//# sourceMappingURL=index.cjs.map

package/dist/agents/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AAAA,uEAAuE;AACvE,0CAA+D;AAAtD,wGAAA,WAAW,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AACxC,qDAAsD;AAA7C,oHAAA,iBAAiB,OAAA;AAC1B,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AAEf,iDAAkE;AAAzD,sHAAA,qBAAqB,OAAA;AAAE,yGAAA,QAAQ,OAAA;AAExC,8DAA8D;AAC9D,iEAAiE;AACjE,yDAAqE;AAA5D,uHAAA,wBAAwB,OAAA;AAEjC,qDAAqD;AACrD,2EAA2E;AAC3E,uDAAuD;AACvD,uEAAuK;AAA9J,mIAAA,0BAA0B,OAAA;AAAE,0HAAA,iBAAiB,OAAA;AAAE,gIAAA,uBAAuB,OAAA;AAAE,6HAAA,oBAAoB,OAAA;AAAE,gIAAA,uBAAuB,OAAA;AAE9H,+DAA+D;AAC/D,qDAAqD;AACrD,wCAAwC;AACxC,qDAAqD;AACrD,gEAA+E;AAAtE,mHAAA,eAAe,OAAA;AAAE,mHAAA,eAAe,OAAA;AAGzC,iEAAmH;AAA1G,8HAAA,yBAAyB,OAAA;AAAE,sHAAA,iBAAiB,OAAA;AAAE,2HAAA,sBAAsB,OAAA;AAE7E,iEAAiE;AACjE,mEAAmE;AACnE,2DAA2D;AAC3D,yEAAyE;AACzE,0DAAkE;AAAzD,uGAAA,OAAO,OAAA;AAAE,4GAAA,YAAY,OAAA;AAE9B,0DAA8D;AAArD,yGAAA,aAAa,OAAA;AACtB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,qDAAqD;AACrD,yBAAyB;AACzB,uDAA2I;AAAlI,kIAAA,8BAA8B,OAAA;AAAE,6HAAA,yBAAyB,OAAA;AAAE,0HAAA,sBAAsB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAE7G,0DAA0D;AAC1D,mDAAqI;AAA5H,+GAAA,aAAa,OAAA;AAAE,4HAAA,0BAA0B,OAAA;AAAE,0HAAA,wBAAwB,OAAA;AAAE,8HAAA,4BAA4B,OAAA;AAE1G,2DAA2D;AAC3D,+CAA4D;AAAnD,0HAAA,0BAA0B,OAAA;AAEnC,6EAA6E;AAC7E,qDAAqD;AACrD,iDAAiD;AACjD,+DAA+D;AAC/D,+CAA+D;AAAtD,gHAAA,gBAAgB,OAAA;AAAE,2GAAA,WAAW,OAAA;AAEtC,mEAAmE;AACnE,yDAAyD;AACzD,yCAAwD;AAA/C,0GAAA,aAAa,OAAA;AAAE,uGAAA,UAAU,OAAA;AAElC,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AACvB,mDAAmD;AAA1C,iHAAA,eAAe,OAAA;AACxB,uCAAwC;AAA/B,sGAAA,UAAU,OAAA;AACnB,mCAAoC;AAA3B,kGAAA,QAAQ,OAAA;AACjB,6CAA8C;AAArC,4GAAA,aAAa,OAAA;AACtB,yCAA0C;AAAjC,wGAAA,WAAW,OAAA;AACpB,6CAA8C;AAArC,4GAAA,aAAa,OAAA","sourcesContent":["// niceeval/adapter 公开导出:「连到哪个 AI」相关的类型 + 内置 adapter + 自定义 adapter 的入口。\nexport { defineAgent, defineSandboxAgent } from \"../define.ts\";\nexport { createSessionSlot } from \"./session-slot.ts\";\nexport { shared } from \"./shared.ts\";\nexport type { Shared } from \"./shared.ts\";\nexport { createNpmCliInstaller, agentBin } from \"./npm-staged.ts\";\nexport type { NpmCliInstallerOptions } from \"./npm-staged.ts\";\n// 证据覆盖声明:官方 SDK 适配器声明全通道 complete 用 completeEvidenceCoverage;\n// 手写映射按实际情况声明(见 docs/feature/adapters/architecture/evidence.md)。\nexport { completeEvidenceCoverage } from \"../assertions/coverage.ts\";\nexport type { EvidenceCoverageStatus, EvidenceCoverageEntry, EvidenceCoverage, TurnEvidenceCoverage, } from \"../types.ts\";\n// tool operation 的 command 分类只能由 Adapter 根据原生协议事实产生。\n// structured argv 走 commandProjection() 与同一 logical-command/v1 normalizer；\n// 无法安全取得 argv 时显式 opaque，确认不是 command 时显式 not-command。\nexport { LOGICAL_COMMAND_NORMALIZER, commandProjection, normalizeLogicalCommand, notCommandProjection, opaqueCommandProjection, } from \"../o11y/command-projection.ts\";\nexport type { CommandProjection, LogicalCommandInvocation, LogicalCommandNormalizer, OriginalCommandInvocation, OriginalCommandOpaqueReason, } from \"../o11y/types.ts\";\n// 执行失败分类:`Agent.classifySendFailure` 认的结构化 envelope 与同源摘要。两轴词表\n// (FailureClass / FailureScope)与包根导出的是同一个形状——adapter\n// 作者与 eval 作者各自的入口拿到同一份类型。判据、分类链与重试执行体见\n// docs/feature/error-classification/architecture.md。\nexport { makeSendFailure, sendFailureText } from \"../context/send-failures.ts\";\nexport type { SendFailure, SendFailureClassifier } from \"../context/send-failures.ts\";\nexport type { FailureClass, FailureScope } from \"../shared/failure-class.ts\";\nexport { externalCauseMessageChain, externalCauseText, normalizeExternalCause } from \"../shared/external-cause.ts\";\nexport type { ExternalCause, ExternalCauseFact, ExternalCauseLink } from \"../shared/external-cause.ts\";\n// span → canonical GenAI 归一(只服务瀑布图,不喂断言)。私有埋点写自己的 spanMapper 时用:\n// tagSpan 把判定写回 span(原属性只增不改),heuristicTag 是通用兜底判定;mapCodexSpans 是\n// 现成的参考实现(无侵入接 codex 后端时直接声明 `spanMapper: mapCodexSpans`)。\n// 映射目标(什么属性亮起瀑布图的什么)见 docs-site/zh/tutorials/connect-otel.mdx「瀑布图画得准不准」。\nexport { tagSpan, heuristicTag } from \"../o11y/otlp/canonical.ts\";\nexport type { SpanTag } from \"../o11y/otlp/canonical.ts\";\nexport { mapCodexSpans } from \"../o11y/otlp/mappers/codex.ts\";\nexport { uiMessageStreamAgent } from \"./ui-message-stream.ts\";\nexport type { UiMessageStreamAgentOptions, UIMessageLike, UIMessagePartLike } from \"./ui-message-stream.ts\";\n// 两种 OpenAI 响应形状(不限于 OpenAI 官方,任何声明兼容这两种协议形状的服务都能用)的\n// 官方转换器:整段响应 → Turn,零映射。\nexport { chatCompletionEvidenceCoverage, responsesEvidenceCoverage, turnFromChatCompletion, turnFromResponses, } from \"./openai-compat.ts\";\nexport type { ChatCompletionLike, ChatCompletionCustomToolCallLike, ChatCompletionFunctionToolCallLike, ChatCompletionMessageLike, ChatCompletionToolCallLike, ChatCompletionUnknownToolCallLike, ChatCompletionUsageLike, ResponseFunctionCallItemLike, ResponseLike, ResponseMessageItemLike, ResponseOutputItemLike, ResponseOutputTextLike, ResponseUsageLike, } from \"./openai-compat.ts\";\n// SDK 原生事件流 → 标准事件的官方转换器(无侵入 adapter 只剩传输粘合)+ 通用 SSE 读帧器。\nexport { sseJsonFrames, createClaudeSdkEventStream, createPiAgentEventStream, createCodexThreadEventStream } from \"./sdk-streams.ts\";\nexport type { SseFrameCursor, ClaudeSdkMessageLike, ClaudeSdkStream, PiAgentEventLike, PiAgentStream, CodexThreadEventLike, CodexThreadStream, } from \"./sdk-streams.ts\";\n// LangGraph 官方事件流转换器(不绑定 transport,不提供 langGraphAgent 工厂)。\nexport { createLangGraphEventStream } from \"./langgraph.ts\";\nexport type { LangGraphEventLike, LangGraphContentBlockLike, LangGraphStream } from \"./langgraph.ts\";\n// 通用「拼装方式」件:逐帧驱动循环、逐 token/参数增量累加器。见 docs-site/zh/tutorials/write-send.mdx——\n// 这些和任何具体协议无关,自己写 adapter 时优先拿这些拼,只有 transport(怎么发)与\n// 「帧类型 → 操作」这张映射表才是真正要手写的。会话续接与 HITL 停轮现场不再是可选件,\n// 而是 ctx.session(AgentSession)本身的 typed slot 与 id/capture 存取器。\nexport { driveFrameStream, deltaStream } from \"./streaming.ts\";\nexport type { FrameReducer, FrameHook, DeltaOp, DeltaStreamSpec } from \"./streaming.ts\";\n// tracing 管线的内置实现 aiSdkOtel() 在 `niceeval/adapter/otel`(独立子路径,不从这里\n// re-export):OTel 三件套是可选 peer 依赖,只有 import 那个入口的项目才需要安装。\nexport { turnFromAiSdk, aiSdkAgent } from \"./ai-sdk.ts\";\nexport type { AiSdkAgentOptions, AiSdkGenerateContext, AiSdkResultLike, AiSdkStepLike, AiSdkTelemetrySettings, AiSdkToolCallLike, AiSdkToolResultLike, AiSdkTracing, AiSdkTurn, AiSdkTurnTelemetry, AiSdkUsageLike, } from \"./ai-sdk.ts\";\nexport { BUILTIN_AGENTS } from \"./builtin.ts\";\nexport { claudeCodeAgent } from \"./claude-code.ts\";\nexport { codexAgent } from \"./codex.ts\";\nexport { bubAgent } from \"./bub.ts\";\nexport { openCodeAgent } from \"./opencode.ts\";\nexport { hermesAgent } from \"./hermes.ts\";\nexport { openClawAgent } from \"./openclaw.ts\";\nexport type { ClaudeCodeConfig, ClaudeCodePluginSpec } from \"./claude-code.ts\";\nexport type { CodexConfig, CodexPluginSpec } from \"./codex.ts\";\nexport type { BubConfig, PythonPluginSpec } from \"./bub.ts\";\nexport type { OpenCodeConfig } from \"./opencode.ts\";\nexport type { HermesConfig } from \"./hermes.ts\";\nexport type { OpenClawConfig } from \"./openclaw.ts\";\nexport type { Agent, AgentContext, AgentIdentity, AgentInstallMode, AgentArtifactPlatform, AgentStagedArtifact, AgentEnsureOutcome, AgentEnsure, AgentInstaller, AgentArtifactContext, AgentInstallContext, StagedAgentInstallContext, DirectAgent, DirectAgentDef, DirectAgentSetup, DirectAgentTeardown, AgentSession, SessionSlot, AgentSetup, AgentSetupManifest, AgentSetupSkill, AgentTeardown, AgentTracing, SpanMapper, Telemetry, SandboxAgentDef, SandboxAgent, SandboxAgentContext, SandboxAgentSetupContext, McpServer, SkillSpec, } from \"../types.ts\";\n"]}

package/dist/agents/index.d.cts

@@ -0,0 +1,44 @@
+export { defineAgent, defineSandboxAgent } from "../define.cjs";
+export { createSessionSlot } from "./session-slot.cjs";
+export { shared } from "./shared.cjs";
+export type { Shared } from "./shared.cjs";
+export { createNpmCliInstaller, agentBin } from "./npm-staged.cjs";
+export type { NpmCliInstallerOptions } from "./npm-staged.cjs";
+export { completeEvidenceCoverage } from "../assertions/coverage.cjs";
+export type { EvidenceCoverageStatus, EvidenceCoverageEntry, EvidenceCoverage, TurnEvidenceCoverage, } from "../types.cjs";
+export { LOGICAL_COMMAND_NORMALIZER, commandProjection, normalizeLogicalCommand, notCommandProjection, opaqueCommandProjection, } from "../o11y/command-projection.cjs";
+export type { CommandProjection, LogicalCommandInvocation, LogicalCommandNormalizer, OriginalCommandInvocation, OriginalCommandOpaqueReason, } from "../o11y/types.cjs";
+export { makeSendFailure, sendFailureText } from "../context/send-failures.cjs";
+export type { SendFailure, SendFailureClassifier } from "../context/send-failures.cjs";
+export type { FailureClass, FailureScope } from "../shared/failure-class.cjs";
+export { externalCauseMessageChain, externalCauseText, normalizeExternalCause } from "../shared/external-cause.cjs";
+export type { ExternalCause, ExternalCauseFact, ExternalCauseLink } from "../shared/external-cause.cjs";
+export { tagSpan, heuristicTag } from "../o11y/otlp/canonical.cjs";
+export type { SpanTag } from "../o11y/otlp/canonical.cjs";
+export { mapCodexSpans } from "../o11y/otlp/mappers/codex.cjs";
+export { uiMessageStreamAgent } from "./ui-message-stream.cjs";
+export type { UiMessageStreamAgentOptions, UIMessageLike, UIMessagePartLike } from "./ui-message-stream.cjs";
+export { chatCompletionEvidenceCoverage, responsesEvidenceCoverage, turnFromChatCompletion, turnFromResponses, } from "./openai-compat.cjs";
+export type { ChatCompletionLike, ChatCompletionCustomToolCallLike, ChatCompletionFunctionToolCallLike, ChatCompletionMessageLike, ChatCompletionToolCallLike, ChatCompletionUnknownToolCallLike, ChatCompletionUsageLike, ResponseFunctionCallItemLike, ResponseLike, ResponseMessageItemLike, ResponseOutputItemLike, ResponseOutputTextLike, ResponseUsageLike, } from "./openai-compat.cjs";
+export { sseJsonFrames, createClaudeSdkEventStream, createPiAgentEventStream, createCodexThreadEventStream } from "./sdk-streams.cjs";
+export type { SseFrameCursor, ClaudeSdkMessageLike, ClaudeSdkStream, PiAgentEventLike, PiAgentStream, CodexThreadEventLike, CodexThreadStream, } from "./sdk-streams.cjs";
+export { createLangGraphEventStream } from "./langgraph.cjs";
+export type { LangGraphEventLike, LangGraphContentBlockLike, LangGraphStream } from "./langgraph.cjs";
+export { driveFrameStream, deltaStream } from "./streaming.cjs";
+export type { FrameReducer, FrameHook, DeltaOp, DeltaStreamSpec } from "./streaming.cjs";
+export { turnFromAiSdk, aiSdkAgent } from "./ai-sdk.cjs";
+export type { AiSdkAgentOptions, AiSdkGenerateContext, AiSdkResultLike, AiSdkStepLike, AiSdkTelemetrySettings, AiSdkToolCallLike, AiSdkToolResultLike, AiSdkTracing, AiSdkTurn, AiSdkTurnTelemetry, AiSdkUsageLike, } from "./ai-sdk.cjs";
+export { BUILTIN_AGENTS } from "./builtin.cjs";
+export { claudeCodeAgent } from "./claude-code.cjs";
+export { codexAgent } from "./codex.cjs";
+export { bubAgent } from "./bub.cjs";
+export { openCodeAgent } from "./opencode.cjs";
+export { hermesAgent } from "./hermes.cjs";
+export { openClawAgent } from "./openclaw.cjs";
+export type { ClaudeCodeConfig, ClaudeCodePluginSpec } from "./claude-code.cjs";
+export type { CodexConfig, CodexPluginSpec } from "./codex.cjs";
+export type { BubConfig, PythonPluginSpec } from "./bub.cjs";
+export type { OpenCodeConfig } from "./opencode.cjs";
+export type { HermesConfig } from "./hermes.cjs";
+export type { OpenClawConfig } from "./openclaw.cjs";
+export type { Agent, AgentContext, AgentIdentity, AgentInstallMode, AgentArtifactPlatform, AgentStagedArtifact, AgentEnsureOutcome, AgentEnsure, AgentInstaller, AgentArtifactContext, AgentInstallContext, StagedAgentInstallContext, DirectAgent, DirectAgentDef, DirectAgentSetup, DirectAgentTeardown, AgentSession, SessionSlot, AgentSetup, AgentSetupManifest, AgentSetupSkill, AgentTeardown, AgentTracing, SpanMapper, Telemetry, SandboxAgentDef, SandboxAgent, SandboxAgentContext, SandboxAgentSetupContext, McpServer, SkillSpec, } from "../types.cjs";