niceeval 0.13.3 → 0.13.4-canary.39

package/dist/cli/program.d.ts

@@ -1,352 +1,31 @@
-import { Cause, Effect } from "effect";
-import { BrowserLauncher, CliArguments, CliInvocationFacts, CliOutput, CliPath, CliReportPlatform, CliTerminal, PackageMetadata, ProjectInitializer } from "./application.js";
-import { ProjectConfiguration } from "./project-configuration.js";
-import type { ExperimentRenamePlan, ExperimentRenameRejected, RenamedExperiment } from "../runner/rename-experiment.js";
-import { ExperimentRenameError } from "../runner/rename-experiment.js";
-import type { InvocationSummary } from "../types.js";
-declare const CliUsageError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
+import { Effect } from "effect";
+import { CliArguments, CliInvocationFacts, CliOutput, PackageMetadata } from "./application.js";
+import { CliFeatureError, type CliCommandContribution } from "./contribution.js";
+declare const CliUsageError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "CliUsageError";
 } & Readonly<A>;
-/** A recoverable command-line usage error. Defects deliberately do not enter this channel. */
+/** A recoverable root-command usage error. */
 export declare class CliUsageError extends CliUsageError_base<{
     readonly message: string;
     readonly exitCode: number;
 }> {
 }
-declare const CliOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
+declare const CliOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "CliOperationError";
 } & Readonly<A>;
-/** A recoverable failure from a concrete CLI-owned boundary (file, process, or dynamic module). */
+/** A recoverable failure from a root-owned terminal or process boundary. */
 export declare class CliOperationError extends CliOperationError_base<{
     readonly operation: string;
     readonly cause: unknown;
     readonly exitCode: number;
 }> {
 }
-export type CliFailure = CliUsageError | CliOperationError;
-/**
- * Bootstrap owns process signals until an Eval has reached actual dispatch.
- * The CLI claims the Invocation signal synchronously immediately before
- * Experiment Host dispatch; it never infers this from argv outside the command
- * dispatcher.
- */
-export interface CliInterruptionOwnership {
-    readonly invocationSignal: AbortSignal;
-    /** False means bootstrap already accepted a root-owned first signal. */
-    readonly enterGracefulDispatch: () => boolean;
-    readonly requestInterrupt: () => void;
-}
+export type CliFailure = CliUsageError | CliOperationError | CliFeatureError;
 /** Bootstrap owns presentation of typed failures; defects and interruption stay in Cause. */
 export declare function renderCliFailure(failure: CliFailure): string;
-export interface Flags {
-    agent?: string;
-    model?: string;
-    attempts?: number;
-    maxConcurrency?: number;
-    maxBuildConcurrency?: number;
-    timeout?: number;
-    earlyExit?: boolean;
-    dry: boolean;
-    force: boolean;
-    rerun?: "failed" | "all";
-    budget?: number;
-    tag?: string;
-    junit?: string;
-    /** `exp` 命令专用:机器面(NDJSON 事件流)。省略即人读文本(见 `resolveOutputForm`)。 */
-    json: boolean;
-    /** `docker profile doctor` 专用：运行一次真实嵌套 Docker 冒烟。 */
-    smoke: boolean;
-    open?: boolean;
-    out?: string;
-    port?: number;
-    host?: string;
-    help: boolean;
-    version: boolean;
-    /** `clean` / `migrate` 专用：确认删除未完成 Run 或在 clean Git restore point 下执行 migration。 */
-    yes: boolean;
-    source?: true | string;
-    execution: boolean;
-    diff: boolean;
-    /** --diff=<路径>(必须 = 连写;空格形式会把路径当 eval id 前缀,按文档如此)。 */
-    diffPath?: string;
-    /** `show @<AttemptId> --execution` 专用：JS 正则，只显示命中的 transcript / tool / command evidence。 */
-    grep?: string;
-    timing?: "summary" | "full";
-    keepSandbox?: "failed" | "all";
-    all: boolean;
-    window?: string;
-    sandboxPath?: string;
-    leaveRunning: boolean;
-    history: boolean;
-    usage: boolean;
-    stats: boolean;
-    /** `show` / `view` 命令专用：默认读取当前项目结果时，按完整 ExperimentId 收窄目标。 */
-    experiment?: string[];
-    /** `show` / `view` / `accept` / `sandbox enter|list|stop` 共用:记录根目录(`.niceeval` 之外的另一个根,如 `publish` 产出的发布根)。 */
-    record?: string;
-    /** `show` / `view` 命令专用：`--run` 可重复；按完整 RunId 去重。 */
-    run?: string[];
-    report?: string;
-    page?: string;
-    theme?: string;
-    /** `sandbox list` 专用:核对强杀路径留下的无主实例。 */
-    orphans: boolean;
-    /** `exp` 命令专用:只对选中实验各执行一次实验级 teardown,不派发 attempt、不跑 setup。 */
-    teardown: boolean;
-    /** `exp --teardown` 专用:请求显式恢复的 sharedState key。 */
-    recoverSharedState?: string;
-    /** `exp --teardown --recover-shared-state` 专用:不可变 lease owner token。 */
-    ownerToken?: string;
-    /** 明确确认记录的 owner 已终止；没有它恢复拒绝执行。 */
-    confirmOwnerTerminated: boolean;
-    /** 明确确认远端外部状态已静止；没有它恢复拒绝执行。 */
-    confirmRemoteQuiesced: boolean;
-}
-export declare const FLAG_OPTIONS: {
-    /** experiment 运行不支持该 flag。要换 agent,请在 `experiments/` 下新增或复制一个配置文件。 */
-    readonly agent: {
-        readonly type: "string";
-    };
-    /** experiment 运行不支持该 flag。要换模型,请新增或复制一个 experiment 文件并修改 `model`。 */
-    readonly model: {
-        readonly type: "string";
-    };
-    /** 每个 eval 运行多少次,常用于 pass@N。 */
-    readonly attempts: {
-        readonly type: "string";
-    };
-    /** 设置同时运行的 eval 数量。 */
-    readonly "max-concurrency": {
-        readonly type: "string";
-    };
-    /** 设置同时进行的 Sandbox 镜像 lookup/build 数量；与 eval 并发独立，默认 2。 */
-    readonly "max-build-concurrency": {
-        readonly type: "string";
-    };
-    /** 单个 attempt 的超时时间,单位毫秒。解析链:`--timeout` > experiment > eval(`defineEval({ timeoutMs })`)> `niceeval.config.ts`,默认无上限(四层都没声明就不设 deadline);config 是缺省底而不是覆盖层,写了 config 不会让 eval 自己声明的上限失效。 */
-    readonly timeout: {
-        readonly type: "string";
-    };
-    /** 整次运行的预算上限(美元)。 */
-    readonly budget: {
-        readonly type: "string";
-    };
-    /** `exp` 命令专用:跑完留下 failed/errored attempt 的 Sandbox 现场(= `--keep-sandbox=failed`);`--keep-sandbox=all` 连 passed 也留。事后用 `niceeval sandbox list/enter/stop` 查看与销毁。 */
-    readonly "keep-sandbox": {
-        readonly type: "boolean";
-    };
-    /** `sandbox stop` 专用:销毁全部留存 Sandbox。 */
-    readonly all: {
-        readonly type: "boolean";
-    };
-    /** `sandbox diff` 专用:只看某个 send 窗口(如 `--window turn2` 或 `--window session2/turn1`);省略输出全部窗口的串联视图。 */
-    readonly window: {
-        readonly type: "string";
-    };
-    /** `sandbox diff` 专用:只看某个文件的 patch;省略输出该窗口的全部文件。 */
-    readonly path: {
-        readonly type: "string";
-    };
-    /** `sandbox enter` 专用:shell 退出后让现场保持运行,不送回休眠。 */
-    readonly "leave-running": {
-        readonly type: "boolean";
-    };
-    /** `sandbox list` 专用:核对强杀(`SIGKILL` / 断电)路径留下的无主沙箱实例(docker + e2b;vercel 无按元数据检索实例的通道,不参与)。只读,不清理;销毁走 `niceeval sandbox prune`。 */
-    readonly orphans: {
-        readonly type: "boolean";
-    };
-    /** 只运行带有该 tag 的 eval(见 `defineEval` 的 `tags`)。 */
-    readonly tag: {
-        readonly type: "string";
-    };
-    /** 额外写一份 JUnit XML 报告到指定路径,供 CI 消费。 */
-    readonly junit: {
-        readonly type: "string";
-    };
-    /** `exp` 运行在 stdout 输出单一有序的 NDJSON 事件流；`exp --dry` 与 `debug` 输出各自的单个 JSON 计划文档。`show` 输出 Host 拥有的内建或自定义单目标机器文档，不形成完整站点或打开第二条取数路径。 */
-    readonly json: {
-        readonly type: "boolean";
-    };
-    /** `docker profile doctor` 专用：启动受限 DinD 容器并运行内层容器。 */
-    readonly smoke: {
-        readonly type: "boolean";
-    };
-    /** `view` 命令专用:把结果查看器静态导出到指定目录。 */
-    readonly out: {
-        readonly type: "string";
-    };
-    /** `view` 命令专用:指定本地服务器监听端口。 */
-    readonly port: {
-        readonly type: "string";
-    };
-    /** `view` 命令专用:指定监听地址；省略时为 127.0.0.1，只写 `--host` 时为 0.0.0.0。非 loopback 监听无认证或 TLS，会向所有可达客户端暴露报告数据。 */
-    readonly host: {
-        readonly type: "string";
-    };
-    /** `show` 专用：按一个 exact Attempt locator 展示已记录的 source snapshot。 */
-    readonly source: {
-        readonly type: "boolean";
-    };
-    /** `show @<AttemptLocator> --execution`：从公开 Record projection 呈现该 Attempt 的 transcript、tool 与 command evidence。 */
-    readonly execution: {
-        readonly type: "boolean";
-    };
-    /** `show @<AttemptLocator> --timing[=summary|full]` 专用：从内建 timing Report 读取该 Attempt 的 runner 阶段树。 */
-    readonly timing: {
-        readonly type: "boolean";
-    };
-    /** `show @<AttemptId> --execution` 专用：JS 正则过滤 retained transcript、tool 与 command evidence。 */
-    readonly grep: {
-        readonly type: "string";
-    };
-    /** 实现收敛占位；目标公开 CLI 通过 Report page 读取 diff 通道。 */
-    readonly diff: {
-        readonly type: "boolean";
-    };
-    /** 实现收敛占位；目标公开 CLI 不提供跨 Run history。 */
-    readonly history: {
-        readonly type: "boolean";
-    };
-    /** 实现收敛占位；目标公开 CLI 通过 Report Calculation 呈现用量。 */
-    readonly usage: {
-        readonly type: "boolean";
-    };
-    /** 实现收敛占位；目标公开 CLI 不提供隐式跨 Run 统计。 */
-    readonly stats: {
-        readonly type: "boolean";
-    };
-    /** `show` / `view` 命令专用：按完整 ExperimentId 收窄当前项目结果；可重复，不接受前缀或逗号列表。 */
-    readonly experiment: {
-        readonly type: "string";
-        readonly multiple: true;
-    };
-    /** `show` / `view` / `accept` / `sandbox enter|list|stop` 共用:指定实际 Record root;CLI 不补接 `.niceeval/record` 或其它后缀。 */
-    readonly record: {
-        readonly type: "string";
-    };
-    /** `show` / `view` 可重复传入 `--run`;每次按完整 RunId 增加一个显式 Run,重复 identity 去重。 */
-    readonly run: {
-        readonly type: "string";
-        readonly multiple: true;
-    };
-    /** `show` / `view` 命令专用：内建 `standard` 或受信任的 Report module 路径。 */
-    readonly report: {
-        readonly type: "string";
-    };
-    /** `show` / `view` 命令专用：内建 Theme 或受信任的闭合 Theme module 路径。 */
-    readonly theme: {
-        readonly type: "string";
-    };
-    /** `show` / `view` 命令专用:选择报告的初始页;`show` 渲染该页并在尾部附其余页索引,`view` 以它作初始路由。未命中的页 id 按用法错误退出并列出可用页 id。 */
-    readonly page: {
-        readonly type: "string";
-    };
-    /** `exp` 命令专用:补齐被强杀打断的实验级 teardown——只对选中的实验各执行一次 teardown(新进程语义),不派发 attempt、不跑 setup;没有遗留登记也照常执行。与 eval 前缀位置参数组合是用法错误。 */
-    readonly teardown: {
-        readonly type: "boolean";
-    };
-    /** `exp --teardown` 专用:显式恢复一个永不自动接管的 sharedState lease；必须同时提供 --owner-token、--confirm-owner-terminated 和 --confirm-remote-quiesced。 */
-    readonly "recover-shared-state": {
-        readonly type: "string";
-    };
-    /** `--recover-shared-state` 专用:要恢复的不可变 owner token；错误或过期 token 不会修改 lease。 */
-    readonly "owner-token": {
-        readonly type: "string";
-    };
-    /** `--recover-shared-state` 专用:确认原 owner 已终止。 */
-    readonly "confirm-owner-terminated": {
-        readonly type: "boolean";
-    };
-    /** `--recover-shared-state` 专用:确认远端外部状态已静止。 */
-    readonly "confirm-remote-quiesced": {
-        readonly type: "boolean";
-    };
-    /** 只打印本次会匹配到的 eval × 运行配置,不实际执行(人读文本或 `--json` 单文档,见「机器怎么读:--json」)。 */
-    readonly dry: {
-        readonly type: "boolean";
-    };
-    /** `sandbox prune` 专用:除 orphan 外也销毁 unverified 实例;`exp` 明确拒绝此 flag,重跑失败项或全部项请用 `--rerun` / `--rerun all`。 */
-    readonly force: {
-        readonly type: "boolean";
-    };
-    /** `exp` 命令专用:重新运行失败项(裸写/failed)或全部项(all),不改变长期指纹。 */
-    readonly rerun: {
-        readonly type: "boolean";
-    };
-    /** 某个 eval 的一次 attempt 通过后,停止该 eval 剩余的 attempts;省略默认关(`attempts` 默认跑满、测完整通过率)。 */
-    readonly "early-exit": {
-        readonly type: "boolean";
-    };
-    /** 强制关闭首过即停,即使实验文件里写了 `earlyExit: true`。 */
-    readonly "no-early-exit": {
-        readonly type: "boolean";
-    };
-    /** `view` 命令专用:启动后自动打开浏览器(默认行为)。 */
-    readonly open: {
-        readonly type: "boolean";
-    };
-    readonly "no-open": {
-        readonly type: "boolean";
-    };
-    /** `clean` / `migrate` 专用：确认不可逆 maintenance 动作或在 clean Git restore point 下执行 migration。 */
-    readonly yes: {
-        readonly type: "boolean";
-    };
-    /** 打印用法说明并退出。 */
-    readonly help: {
-        readonly type: "boolean";
-        readonly short: "h";
-    };
-    /** 打印 niceeval 的版本号并退出。 */
-    readonly version: {
-        readonly type: "boolean";
-        readonly short: "v";
-    };
-};
-/**
- * Fold the invocation's real fresh results and current Record readbacks at the
- * same eval identity. This intentionally projects only identity + terminal
- * verdict; a reused readback is never recreated as an EvalResult.
- */
-export declare function foldInvocationEvalStats(summary: Pick<InvocationSummary, "results" | "reusedAttempts">): import("../shared/verdict.js").EvalLevelStats;
-export declare const EXPERIMENT_RENAME_FORMAT: "niceeval.experimentRename";
-export declare const EXPERIMENT_RENAME_SCHEMA_VERSION: 1;
-/**
- * exp rename 的机器文档:单份 JSON,按 status 判别。
- * - `plan`(核心计划,可含 `blocked` 阻断原因);
- * - `rejected`(核心 `renameExperiment` 抛 `ExperimentRenameError` 时的整批拒绝);
- * - `done`(核心 `RenamedExperiment` = 成功文档)。
- */
-export type ExperimentRenameJsonDocument = ExperimentRenamePlan | ExperimentRenameRejected | RenamedExperiment;
-/**
- * 解析 exp rename 的位置参数:必须恰好两个(一个旧 id、一个新 id)。
- * 纯函数,CLI 与测试共用。
- */
-export declare function parseExperimentRenamePositionals(args: readonly string[]): {
-    ok: true;
-    oldId: string;
-    newId: string;
-} | {
-    ok: false;
-    kind: "usage";
-};
 /**
- * exp rename 只允许 --dry / --json;返回第一个被误用的 flag,没有误用返回 undefined。
- * 与 accept 同一套纪律:node:util parseArgs 已经报未知 flag,这里拒绝那些全局已知、
- * 但会改变运行/查看语义的 flag。
+ * Route one immutable contribution. The aggregate parse discovers the indexed
+ * root token only; the selected command performs its own authoritative parse.
  */
-export declare function firstExperimentRenameUnsupportedFlag(flags: Flags): string | undefined;
-/** 人读面:核心计划 → 预览文本。逐条列出迁移与排除;有 `blocked` 时点名阻断原因。 */
-export declare function renderExperimentRenamePlanHuman(plan: ExperimentRenamePlan): string;
-/** 拒绝的人读面:先给 reason 专属文案(点名旧 id、新 id、受影响 eval 与下一步),再补冲突清单。 */
-export declare function renderExperimentRenameRejectedHuman(rejected: ExperimentRenameRejected): string;
-/** 成功的人读面:新 snapshot 路径 + 逐条新 locator。 */
-export declare function renderExperimentRenameDoneHuman(done: RenamedExperiment): string;
-/** 机器面:单份 JSON 文档,不混入人读文本(见 rename.md「命令」)。 */
-export declare function renderExperimentRenameJson(document: ExperimentRenameJsonDocument): string;
-/** 把 renameExperiment 抛出的资格错误投影成 rejected 文档(JSON 与拒绝人读共用)。 */
-export declare function experimentRenameRejectedFromError(error: ExperimentRenameError): ExperimentRenameRejected;
-/** 退出码:可迁移预览与成功执行为 0;blocked 预览 / rejected 整批零写入按失败退出。 */
-export declare function experimentRenameExitCode(document: ExperimentRenameJsonDocument): number;
-export declare const cliProgram: (interruption?: CliInterruptionOwnership) => Effect.Effect<number, CliFailure, import("effect/Scope").Scope | import("../record/platform/services.js").RecordEntropy | import("../record/platform/services.js").RecordGit | ProjectConfiguration | CliArguments | CliInvocationFacts | CliOutput | ProjectInitializer | PackageMetadata | BrowserLauncher | CliPath | CliTerminal | CliReportPlatform | import("../report/host/static.js").ReportFileSystem | import("../report/host/from-record.js").ExecuteReportFromRecordRequirements>;
+export declare const cliProgram: <R>(commands: readonly CliCommandContribution<R, CliFeatureError>[]) => Effect.Effect<number, CliFeatureError | CliUsageError | CliOperationError, CliArguments | CliInvocationFacts | CliOutput | PackageMetadata | R>;
 export {};

package/dist/cli/program.js

@@ -5,32 +5,8 @@ const __niceevalExport0 = __niceevalCanonical["CliOperationError"];
 export { __niceevalExport0 as CliOperationError };
 const __niceevalExport1 = __niceevalCanonical["CliUsageError"];
 export { __niceevalExport1 as CliUsageError };
-const __niceevalExport2 = __niceevalCanonical["EXPERIMENT_RENAME_FORMAT"];
-export { __niceevalExport2 as EXPERIMENT_RENAME_FORMAT };
-const __niceevalExport3 = __niceevalCanonical["EXPERIMENT_RENAME_SCHEMA_VERSION"];
-export { __niceevalExport3 as EXPERIMENT_RENAME_SCHEMA_VERSION };
-const __niceevalExport4 = __niceevalCanonical["FLAG_OPTIONS"];
-export { __niceevalExport4 as FLAG_OPTIONS };
-const __niceevalExport5 = __niceevalCanonical["cliProgram"];
-export { __niceevalExport5 as cliProgram };
-const __niceevalExport6 = __niceevalCanonical["experimentRenameExitCode"];
-export { __niceevalExport6 as experimentRenameExitCode };
-const __niceevalExport7 = __niceevalCanonical["experimentRenameRejectedFromError"];
-export { __niceevalExport7 as experimentRenameRejectedFromError };
-const __niceevalExport8 = __niceevalCanonical["firstExperimentRenameUnsupportedFlag"];
-export { __niceevalExport8 as firstExperimentRenameUnsupportedFlag };
-const __niceevalExport9 = __niceevalCanonical["foldInvocationEvalStats"];
-export { __niceevalExport9 as foldInvocationEvalStats };
-const __niceevalExport10 = __niceevalCanonical["parseExperimentRenamePositionals"];
-export { __niceevalExport10 as parseExperimentRenamePositionals };
-const __niceevalExport11 = __niceevalCanonical["renderCliFailure"];
-export { __niceevalExport11 as renderCliFailure };
-const __niceevalExport12 = __niceevalCanonical["renderExperimentRenameDoneHuman"];
-export { __niceevalExport12 as renderExperimentRenameDoneHuman };
-const __niceevalExport13 = __niceevalCanonical["renderExperimentRenameJson"];
-export { __niceevalExport13 as renderExperimentRenameJson };
-const __niceevalExport14 = __niceevalCanonical["renderExperimentRenamePlanHuman"];
-export { __niceevalExport14 as renderExperimentRenamePlanHuman };
-const __niceevalExport15 = __niceevalCanonical["renderExperimentRenameRejectedHuman"];
-export { __niceevalExport15 as renderExperimentRenameRejectedHuman };
+const __niceevalExport2 = __niceevalCanonical["cliProgram"];
+export { __niceevalExport2 as cliProgram };
+const __niceevalExport3 = __niceevalCanonical["renderCliFailure"];
+export { __niceevalExport3 as renderCliFailure };
 //# sourceMappingURL=program.js.map

package/dist/cli.cjs

@@ -14,9 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FLAG_OPTIONS = void 0;
 // The CLI surface deliberately contains no Node boundary.
 __exportStar(require("./cli/application.cjs"), exports);
-var program_ts_1 = require("./cli/program.cjs");
-Object.defineProperty(exports, "FLAG_OPTIONS", { enumerable: true, get: function () { return program_ts_1.FLAG_OPTIONS; } });
 //# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0DAA0D;AAC1D,uDAAqC;AACrC,+CAAgD;AAAvC,0GAAA,YAAY,OAAA","sourcesContent":["// The CLI surface deliberately contains no Node boundary.\nexport * from \"./cli/application.ts\";\nexport { FLAG_OPTIONS } from \"./cli/program.ts\";\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAA0D;AAC1D,uDAAqC","sourcesContent":["// The CLI surface deliberately contains no Node boundary.\nexport * from \"./cli/application.ts\";\n"]}

package/dist/cli.d.cts

@@ -1,2 +1 @@
 export * from "./cli/application.cjs";
-export { FLAG_OPTIONS } from "./cli/program.cjs";

package/dist/cli.d.mts

@@ -1,2 +1 @@
 export * from "./cli/application.mjs";
-export { FLAG_OPTIONS } from "./cli/program.mjs";

package/dist/cli.d.ts

@@ -1,2 +1 @@
 export * from "./cli/application.js";
-export { FLAG_OPTIONS } from "./cli/program.js";

package/dist/cli.js

@@ -1,10 +1,10 @@
 import { createRequire as __niceevalCreateRequire } from "node:module";
 const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
 const __niceevalCanonical = __niceevalRequire("./cli.cjs");
-const __niceevalExport0 = __niceevalCanonical["BrowserLauncher"];
-export { __niceevalExport0 as BrowserLauncher };
-const __niceevalExport1 = __niceevalCanonical["CliArguments"];
-export { __niceevalExport1 as CliArguments };
+const __niceevalExport0 = __niceevalCanonical["CliArguments"];
+export { __niceevalExport0 as CliArguments };
+const __niceevalExport1 = __niceevalCanonical["CliInterruption"];
+export { __niceevalExport1 as CliInterruption };
 const __niceevalExport2 = __niceevalCanonical["CliInvocationError"];
 export { __niceevalExport2 as CliInvocationError };
 const __niceevalExport3 = __niceevalCanonical["CliInvocationFacts"];
@@ -13,14 +13,6 @@ const __niceevalExport4 = __niceevalCanonical["CliOutput"];
 export { __niceevalExport4 as CliOutput };
 const __niceevalExport5 = __niceevalCanonical["CliPath"];
 export { __niceevalExport5 as CliPath };
-const __niceevalExport6 = __niceevalCanonical["CliReportPlatform"];
-export { __niceevalExport6 as CliReportPlatform };
-const __niceevalExport7 = __niceevalCanonical["CliTerminal"];
-export { __niceevalExport7 as CliTerminal };
-const __niceevalExport8 = __niceevalCanonical["FLAG_OPTIONS"];
-export { __niceevalExport8 as FLAG_OPTIONS };
-const __niceevalExport9 = __niceevalCanonical["PackageMetadata"];
-export { __niceevalExport9 as PackageMetadata };
-const __niceevalExport10 = __niceevalCanonical["ProjectInitializer"];
-export { __niceevalExport10 as ProjectInitializer };
+const __niceevalExport6 = __niceevalCanonical["PackageMetadata"];
+export { __niceevalExport6 as PackageMetadata };
 //# sourceMappingURL=cli.js.map

package/dist/define.cjs

@@ -253,7 +253,7 @@ function decodeJsonRecord(value, label) {
  */
 function assertSandboxLayer(value, factory) {
     if (value !== undefined && !(0, layer_ts_1.isSandboxLayer)(value)) {
-        throw new TypeError(`${factory} sandbox must be a SandboxLayer created by a niceeval/sandbox factory (for example dockerImage(), dockerCompose(), e2bTemplate(), or localSandbox()).`);
+        throw new TypeError(`${factory} sandbox must be a SandboxLayer created by a niceeval/sandbox factory (for example dockerSandbox(), dockerComposeSandbox(), e2bSandbox(), or vercelSandbox()).`);
     }
 }
 /** 项目级配置。 */

package/dist/define.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["define.ts"],"names":[],"mappings":"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","sourcesContent":["// 定义入口:把用户对象规格化成核心认得的形状。路径即身份 —— 这里禁止手写 id,\n// 由发现阶段从文件路径推导(见 runner/discover.ts)。\nimport type { DirectAgent, DirectAgentDef, Config, EvalInput, EvalGroupDefinition, EvalGroupInput, EvalDefinition, EvalDefinitionFields, ExperimentDefinition, ExperimentInput, SharedStateConfig, SandboxAgent, SandboxAgentDef, ScoreEvalInput, ScoreTestContext, TestContext, JsonValue, } from \"./types.ts\";\nimport { brandEvalDefinition, brandEvalGroupDefinition, brandExperimentDefinition, isEvalDefinition, } from \"./types.ts\";\nimport { t } from \"./i18n/index.ts\";\nimport { customProviderSandbox, isSandboxLayer, type CustomProviderSandboxOptions, type SandboxLayer, } from \"./sandbox/layer.ts\";\nimport { Either, Schema } from \"effect\";\nimport { assertEvidenceCoverage } from \"./assertions/coverage.ts\";\nimport { isPluginInstance, pluginInstanceDataOf, type PluginInstance, type PluginOwner } from \"./plugin/contracts.ts\";\n// 发现期必须区分 defineScoreEval 的真正产物与运行时手写 `{ evaluationKind: \"score\" }` 的裸对象。\n// WeakSet 是模块私有来源证明；Definition 本身另有 types.ts 的私有 symbol 品牌供类型层使用。\nconst definedScoreEvals = new WeakSet<object>();\n/** Define a closed set of real Eval definitions sharing one physical Sandbox. */\nexport function defineEvalGroup<const Sandbox extends SandboxLayer | undefined>(input: EvalGroupInput<Sandbox>): EvalGroupDefinition {\n    if (!Array.isArray(input.evals) || input.evals.length === 0) {\n        throw new TypeError(\"defineEvalGroup evals must be a non-empty array of defineEval()/defineScoreEval() definitions.\");\n    }\n    input.evals.forEach((member, index) => {\n        if (!isEvalDefinition(member)) {\n            throw new TypeError(`defineEvalGroup evals[${index}] must be the object returned by defineEval() or defineScoreEval().`);\n        }\n    });\n    assertSandboxLayer(input.sandbox, \"defineEvalGroup\");\n    if (input.onUnavailable !== \"stop-group\" && input.onUnavailable !== \"replace-sandbox\") {\n        throw new TypeError(\"defineEvalGroup onUnavailable must be \\\"stop-group\\\" or \\\"replace-sandbox\\\".\");\n    }\n    const [first, ...rest] = input.evals;\n    return brandEvalGroupDefinition({\n        evals: Object.freeze([first, ...rest]),\n        onUnavailable: input.onUnavailable,\n        ...(input.sandbox ? { sandbox: input.sandbox } : {}),\n        ...(input.plugins === undefined ? {} : { plugins: normalizePlugins(input.plugins, \"defineEvalGroup plugins\", \"group\") }),\n    });\n}\n/** @internal 仅供 discoverEvals 验证 score 题型来源。 */\nexport function isDefinedScoreEval(value: object): boolean {\n    return definedScoreEvals.has(value);\n}\n/** 沙箱型 agent:在沙箱里 spawn 一个 coding agent 的 CLI,跑完读回 transcript。 */\nexport function defineSandboxAgent(def: SandboxAgentDef): SandboxAgent {\n    if (!def.name)\n        throw new Error(t(\"define.sandboxAgentNameRequired\"));\n    assertEvidenceCoverage(def.evidenceCoverage, \"defineSandboxAgent\");\n    if (def.ensure === undefined)\n        throw new Error(t(\"define.sandboxAgentEnsureRequired\"));\n    const ensure = Array.isArray(def.ensure) ? def.ensure : [def.ensure];\n    if (ensure.length === 0)\n        throw new Error(t(\"define.sandboxAgentEnsureRequired\"));\n    return {\n        name: def.name,\n        kind: \"sandbox\",\n        evidenceCoverage: def.evidenceCoverage,\n        ensure,\n        installers: def.installers ?? [],\n        setup: def.setup,\n        tracing: def.tracing,\n        spanMapper: def.spanMapper,\n        send: def.send,\n        classifySendFailure: def.classifySendFailure,\n        teardown: def.teardown,\n    };\n}\n/** Direct Agent:在 send 里直接驱动函数、SDK 或服务端点。 */\nexport function defineAgent(def: DirectAgentDef): DirectAgent {\n    if (!def.name)\n        throw new Error(t(\"define.agentNameRequired\"));\n    assertEvidenceCoverage(def.evidenceCoverage, \"defineAgent\");\n    return {\n        name: def.name,\n        kind: \"direct\",\n        evidenceCoverage: def.evidenceCoverage,\n        setup: def.setup,\n        tracing: def.tracing,\n        spanMapper: def.spanMapper,\n        send: def.send,\n        classifySendFailure: def.classifySendFailure,\n        teardown: def.teardown,\n    };\n}\n/** 会话型 eval(通过制:一个 eval 折叠成一分)。禁止提供 id —— 从路径推导。 */\nexport function defineEval<const Sandbox extends SandboxLayer | undefined = undefined>(def: EvalInput<Sandbox>): EvalDefinition<\"pass\", TestContext, Sandbox> {\n    if (Object.hasOwn(def, \"id\")) {\n        throw new Error(t(\"define.evalIdRejected\"));\n    }\n    if (Object.hasOwn(def, \"evaluationKind\")) {\n        throw new Error(t(\"define.evalEvaluationKindRejected\"));\n    }\n    if (Object.hasOwn(def, \"configHash\")) {\n        throw new Error(t(\"define.evalConfigHashRejected\"));\n    }\n    if (typeof def.test !== \"function\") {\n        throw new Error(t(\"define.evalTestRequired\"));\n    }\n    assertSandboxLayer(def.sandbox, \"defineEval\");\n    return brandEvalDefinition({ ...normalizeEvalFields(def), evaluationKind: \"pass\", test: def.test });\n}\n/**\n * 计分制 eval:Fact verdict uses 与 Fact score uses 可以读取同一份证据；正常返回由 Runner\n * 自动关闭计分收集器。字段与 `defineEval` 同形，禁止提供 id，由发现期推导。\n */\nexport function defineScoreEval<const Sandbox extends SandboxLayer | undefined = undefined>(def: ScoreEvalInput<Sandbox>): EvalDefinition<\"score\", ScoreTestContext, Sandbox> {\n    if (Object.hasOwn(def, \"id\")) {\n        throw new Error(t(\"define.scoreEvalIdRejected\"));\n    }\n    if (Object.hasOwn(def, \"evaluationKind\")) {\n        throw new Error(t(\"define.scoreEvalEvaluationKindRejected\"));\n    }\n    if (Object.hasOwn(def, \"configHash\")) {\n        throw new Error(t(\"define.scoreEvalConfigHashRejected\"));\n    }\n    if (typeof def.test !== \"function\") {\n        throw new Error(t(\"define.scoreEvalTestRequired\"));\n    }\n    assertSandboxLayer(def.sandbox, \"defineScoreEval\");\n    const result = brandEvalDefinition({ ...normalizeEvalFields(def), evaluationKind: \"score\", test: def.test });\n    definedScoreEvals.add(result);\n    return result;\n}\n/** 实验:可签入的运行配置(怎么跑这批 eval)。 */\nexport function defineExperiment(def: ExperimentInput): ExperimentDefinition {\n    if (Object.hasOwn(def, \"id\")) {\n        throw new Error(t(\"define.experimentIdRejected\"));\n    }\n    if (!def.agent)\n        throw new Error(t(\"define.experimentAgentRequired\"));\n    assertSandboxLayer(def.sandbox, \"defineExperiment\");\n    // setup 是实验级生命周期钩子(整场一次,宿主机侧,见 runner/types.ts 的 ExperimentDef.setup);\n    // 传成非函数(如误把 sandbox 钩子对象塞进来)在解析时就报,不等到调度才炸。\n    if (def.setup !== undefined && typeof def.setup !== \"function\") {\n        throw new Error(t(\"define.experimentSetupNotFunction\"));\n    }\n    // teardown 与 setup 是同一个 Experiment lifecycle 边界。非函数值绝不能\n    // 伪装成已声明的 cleanup，否则 explicit sharedState recovery 可能在没有\n    // 执行补偿的情况下释放 immutable owner generation。\n    if (def.teardown !== undefined && typeof def.teardown !== \"function\") {\n        throw new Error(t(\"define.experimentTeardownNotFunction\"));\n    }\n    // classifyFailure 是失败分类链上的实验通道(见 runner/types.ts 的 ExperimentDef.classifyFailure):\n    // 传成非函数在解析时就报,不等到某条 attempt 撞死才发现这一路声明白写。\n    if (def.classifyFailure !== undefined && typeof def.classifyFailure !== \"function\") {\n        throw new Error(t(\"define.experimentClassifyFailureNotFunction\"));\n    }\n    // labels 是报告归类坐标(进 ExperimentRunInfo.labels,不透传 ctx/t):值域 string | number,\n    // 解析时即校验,布尔 / 对象 / NaN 直接报错,不等到落盘或报告分组才炸。\n    if (def.labels !== undefined) {\n        for (const [key, value] of Object.entries(def.labels)) {\n            const ok = typeof value === \"string\" || (typeof value === \"number\" && Number.isFinite(value));\n            if (!ok)\n                throw new Error(t(\"define.experimentLabelInvalid\", { key }));\n        }\n    }\n    const sharedState = normalizeSharedState(def.sharedState);\n    const { id: _derivedId, sharedState: _sharedState, ...author } = def;\n    return brandExperimentDefinition({\n        ...author,\n        flags: decodeJsonRecord(def.flags ?? {}, \"defineExperiment flags\"),\n        labels: Object.freeze({ ...(def.labels ?? {}) }),\n        attempts: def.attempts ?? 1,\n        earlyExit: def.earlyExit ?? false,\n        evals: Array.isArray(def.evals) ? Object.freeze([...def.evals]) : (def.evals ?? \"*\"),\n        sandboxReuse: def.sandboxReuse === true,\n        ...(sharedState === undefined ? {} : { sharedState }),\n        plugins: normalizePlugins(def.plugins ?? [], \"defineExperiment plugins\", \"experiment\"),\n    });\n}\nconst SharedStateKeyPattern = /^[a-z0-9][a-z0-9._/-]{0,127}$/u;\nfunction normalizeSharedState(value: unknown): SharedStateConfig | undefined {\n    if (value === undefined)\n        return undefined;\n    const candidate = value as {\n        key?: unknown;\n    };\n    if (typeof value !== \"object\" ||\n        value === null ||\n        Array.isArray(value) ||\n        !Object.hasOwn(value, \"key\") ||\n        Object.keys(value).length !== 1 ||\n        typeof candidate.key !== \"string\" ||\n        !SharedStateKeyPattern.test(candidate.key)) {\n        throw new TypeError(t(\"define.experimentSharedStateInvalid\"));\n    }\n    return Object.freeze({ key: candidate.key });\n}\nfunction normalizeEvalFields<const Sandbox extends SandboxLayer | undefined>(def: EvalInput<Sandbox> | ScoreEvalInput<Sandbox>): EvalDefinitionFields<Sandbox> {\n    return {\n        ...(def.description !== undefined ? { description: def.description } : {}),\n        tags: Object.freeze([...(def.tags ?? [])]),\n        ...(def.sandbox !== undefined ? { sandbox: def.sandbox } : {}),\n        plugins: normalizePlugins(def.plugins ?? [], \"defineEval plugins\", \"eval\"),\n        ...(def.judge !== undefined ? { judge: def.judge } : {}),\n        reporters: Object.freeze([...(def.reporters ?? [])]),\n        ...(def.timeoutMs !== undefined ? { timeoutMs: def.timeoutMs } : {}),\n        metadata: decodeJsonRecord(def.metadata ?? {}, \"Eval metadata\"),\n        diff: Object.freeze({\n            include: Object.freeze([...(def.diff?.include ?? [])]),\n            ignore: Object.freeze([...(def.diff?.ignore ?? [])]),\n        }),\n    };\n}\nfunction normalizePlugins<Owner extends PluginOwner>(value: readonly PluginInstance<Owner>[], label: string, owner: Owner): readonly PluginInstance<Owner>[] {\n    if (!Array.isArray(value))\n        throw new TypeError(`${label} must be an array.`);\n    return Object.freeze(value.map((plugin, index) => {\n        if (!isPluginInstance(plugin))\n            throw new TypeError(`${label}[${index}] must be created by definePlugin().`);\n        if (pluginInstanceDataOf(plugin)[owner] === undefined) {\n            throw new TypeError(`${label}[${index}] does not support ${owner} attachment.`);\n        }\n        return plugin;\n    }));\n}\nfunction isJsonValue(value: unknown): value is JsonValue {\n    if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\n        return true;\n    if (typeof value === \"number\")\n        return Number.isFinite(value);\n    if (Array.isArray(value))\n        return value.every(isJsonValue);\n    if (typeof value !== \"object\")\n        return false;\n    return Object.values(value).every(isJsonValue);\n}\nconst JsonValueSchema = Schema.declare<JsonValue>(isJsonValue);\nconst JsonRecordSchema = Schema.Record({ key: Schema.String, value: JsonValueSchema });\nfunction deepFreezeJson(value: JsonValue): JsonValue {\n    if (Array.isArray(value)) {\n        const items: JsonValue[] = value.map(deepFreezeJson);\n        Object.freeze(items);\n        return items;\n    }\n    if (value !== null && typeof value === \"object\") {\n        const record: globalThis.Record<string, JsonValue> = Object.fromEntries(Object.entries(value).map(([key, child]) => [key, deepFreezeJson(child)]));\n        Object.freeze(record);\n        return record;\n    }\n    return value;\n}\nfunction decodeJsonRecord(value: Readonly<globalThis.Record<string, JsonValue>>, label: string): Readonly<globalThis.Record<string, JsonValue>> {\n    const decoded = Schema.decodeUnknownEither(JsonRecordSchema, { errors: \"all\" })(value);\n    if (Either.isLeft(decoded))\n        throw new TypeError(`${label} must be JSON-compatible: ${String(decoded.left)}`);\n    return Object.freeze(Object.fromEntries(Object.entries(decoded.right).map(([key, child]) => [key, deepFreezeJson(child)])));\n}\n/**\n * `SandboxLayer` 的品牌只由 `niceeval/sandbox` 工厂写入。动态 TSX/JS 调用绕过静态类型时，\n * 不接受看似相同的裸对象，以免在 linker 阶段才得到难以定位的错误。\n */\nfunction assertSandboxLayer(value: unknown, factory: string): void {\n    if (value !== undefined && !isSandboxLayer(value)) {\n        throw new TypeError(`${factory} sandbox must be a SandboxLayer created by a niceeval/sandbox factory (for example dockerImage(), dockerCompose(), e2bTemplate(), or localSandbox()).`);\n    }\n}\n/** 项目级配置。 */\nexport function defineConfig(config: Config): Config {\n    return config;\n}\n/**\n * 自定义沙箱 provider:`create` 直接返回一个实现 `Sandbox` 接口的实例,不需要 niceeval 内置支持\n * 这个 provider 名字。用于接入 docker/vercel/e2b 之外的运行环境(自建 VM、Modal、Fly 等)。\n */\nexport function defineSandbox(def: CustomProviderSandboxOptions): SandboxLayer<\"template-bearing\", \"prepare-only\"> {\n    return customProviderSandbox(def);\n}\n"]}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["define.ts"],"names":[],"mappings":"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","sourcesContent":["// 定义入口:把用户对象规格化成核心认得的形状。路径即身份 —— 这里禁止手写 id,\n// 由发现阶段从文件路径推导(见 runner/discover.ts)。\nimport type { DirectAgent, DirectAgentDef, Config, EvalInput, EvalGroupDefinition, EvalGroupInput, EvalDefinition, EvalDefinitionFields, ExperimentDefinition, ExperimentInput, SharedStateConfig, SandboxAgent, SandboxAgentDef, ScoreEvalInput, ScoreTestContext, TestContext, JsonValue, } from \"./types.ts\";\nimport { brandEvalDefinition, brandEvalGroupDefinition, brandExperimentDefinition, isEvalDefinition, } from \"./types.ts\";\nimport { t } from \"./i18n/index.ts\";\nimport { customProviderSandbox, isSandboxLayer, type CustomProviderSandboxOptions, type SandboxLayer, } from \"./sandbox/layer.ts\";\nimport { Either, Schema } from \"effect\";\nimport { assertEvidenceCoverage } from \"./assertions/coverage.ts\";\nimport { isPluginInstance, pluginInstanceDataOf, type PluginInstance, type PluginOwner } from \"./plugin/contracts.ts\";\n// 发现期必须区分 defineScoreEval 的真正产物与运行时手写 `{ evaluationKind: \"score\" }` 的裸对象。\n// WeakSet 是模块私有来源证明；Definition 本身另有 types.ts 的私有 symbol 品牌供类型层使用。\nconst definedScoreEvals = new WeakSet<object>();\n/** Define a closed set of real Eval definitions sharing one physical Sandbox. */\nexport function defineEvalGroup<const Sandbox extends SandboxLayer | undefined>(input: EvalGroupInput<Sandbox>): EvalGroupDefinition {\n    if (!Array.isArray(input.evals) || input.evals.length === 0) {\n        throw new TypeError(\"defineEvalGroup evals must be a non-empty array of defineEval()/defineScoreEval() definitions.\");\n    }\n    input.evals.forEach((member, index) => {\n        if (!isEvalDefinition(member)) {\n            throw new TypeError(`defineEvalGroup evals[${index}] must be the object returned by defineEval() or defineScoreEval().`);\n        }\n    });\n    assertSandboxLayer(input.sandbox, \"defineEvalGroup\");\n    if (input.onUnavailable !== \"stop-group\" && input.onUnavailable !== \"replace-sandbox\") {\n        throw new TypeError(\"defineEvalGroup onUnavailable must be \\\"stop-group\\\" or \\\"replace-sandbox\\\".\");\n    }\n    const [first, ...rest] = input.evals;\n    return brandEvalGroupDefinition({\n        evals: Object.freeze([first, ...rest]),\n        onUnavailable: input.onUnavailable,\n        ...(input.sandbox ? { sandbox: input.sandbox } : {}),\n        ...(input.plugins === undefined ? {} : { plugins: normalizePlugins(input.plugins, \"defineEvalGroup plugins\", \"group\") }),\n    });\n}\n/** @internal 仅供 discoverEvals 验证 score 题型来源。 */\nexport function isDefinedScoreEval(value: object): boolean {\n    return definedScoreEvals.has(value);\n}\n/** 沙箱型 agent:在沙箱里 spawn 一个 coding agent 的 CLI,跑完读回 transcript。 */\nexport function defineSandboxAgent(def: SandboxAgentDef): SandboxAgent {\n    if (!def.name)\n        throw new Error(t(\"define.sandboxAgentNameRequired\"));\n    assertEvidenceCoverage(def.evidenceCoverage, \"defineSandboxAgent\");\n    if (def.ensure === undefined)\n        throw new Error(t(\"define.sandboxAgentEnsureRequired\"));\n    const ensure = Array.isArray(def.ensure) ? def.ensure : [def.ensure];\n    if (ensure.length === 0)\n        throw new Error(t(\"define.sandboxAgentEnsureRequired\"));\n    return {\n        name: def.name,\n        kind: \"sandbox\",\n        evidenceCoverage: def.evidenceCoverage,\n        ensure,\n        installers: def.installers ?? [],\n        setup: def.setup,\n        tracing: def.tracing,\n        spanMapper: def.spanMapper,\n        send: def.send,\n        classifySendFailure: def.classifySendFailure,\n        teardown: def.teardown,\n    };\n}\n/** Direct Agent:在 send 里直接驱动函数、SDK 或服务端点。 */\nexport function defineAgent(def: DirectAgentDef): DirectAgent {\n    if (!def.name)\n        throw new Error(t(\"define.agentNameRequired\"));\n    assertEvidenceCoverage(def.evidenceCoverage, \"defineAgent\");\n    return {\n        name: def.name,\n        kind: \"direct\",\n        evidenceCoverage: def.evidenceCoverage,\n        setup: def.setup,\n        tracing: def.tracing,\n        spanMapper: def.spanMapper,\n        send: def.send,\n        classifySendFailure: def.classifySendFailure,\n        teardown: def.teardown,\n    };\n}\n/** 会话型 eval(通过制:一个 eval 折叠成一分)。禁止提供 id —— 从路径推导。 */\nexport function defineEval<const Sandbox extends SandboxLayer | undefined = undefined>(def: EvalInput<Sandbox>): EvalDefinition<\"pass\", TestContext, Sandbox> {\n    if (Object.hasOwn(def, \"id\")) {\n        throw new Error(t(\"define.evalIdRejected\"));\n    }\n    if (Object.hasOwn(def, \"evaluationKind\")) {\n        throw new Error(t(\"define.evalEvaluationKindRejected\"));\n    }\n    if (Object.hasOwn(def, \"configHash\")) {\n        throw new Error(t(\"define.evalConfigHashRejected\"));\n    }\n    if (typeof def.test !== \"function\") {\n        throw new Error(t(\"define.evalTestRequired\"));\n    }\n    assertSandboxLayer(def.sandbox, \"defineEval\");\n    return brandEvalDefinition({ ...normalizeEvalFields(def), evaluationKind: \"pass\", test: def.test });\n}\n/**\n * 计分制 eval:Fact verdict uses 与 Fact score uses 可以读取同一份证据；正常返回由 Runner\n * 自动关闭计分收集器。字段与 `defineEval` 同形，禁止提供 id，由发现期推导。\n */\nexport function defineScoreEval<const Sandbox extends SandboxLayer | undefined = undefined>(def: ScoreEvalInput<Sandbox>): EvalDefinition<\"score\", ScoreTestContext, Sandbox> {\n    if (Object.hasOwn(def, \"id\")) {\n        throw new Error(t(\"define.scoreEvalIdRejected\"));\n    }\n    if (Object.hasOwn(def, \"evaluationKind\")) {\n        throw new Error(t(\"define.scoreEvalEvaluationKindRejected\"));\n    }\n    if (Object.hasOwn(def, \"configHash\")) {\n        throw new Error(t(\"define.scoreEvalConfigHashRejected\"));\n    }\n    if (typeof def.test !== \"function\") {\n        throw new Error(t(\"define.scoreEvalTestRequired\"));\n    }\n    assertSandboxLayer(def.sandbox, \"defineScoreEval\");\n    const result = brandEvalDefinition({ ...normalizeEvalFields(def), evaluationKind: \"score\", test: def.test });\n    definedScoreEvals.add(result);\n    return result;\n}\n/** 实验:可签入的运行配置(怎么跑这批 eval)。 */\nexport function defineExperiment(def: ExperimentInput): ExperimentDefinition {\n    if (Object.hasOwn(def, \"id\")) {\n        throw new Error(t(\"define.experimentIdRejected\"));\n    }\n    if (!def.agent)\n        throw new Error(t(\"define.experimentAgentRequired\"));\n    assertSandboxLayer(def.sandbox, \"defineExperiment\");\n    // setup 是实验级生命周期钩子(整场一次,宿主机侧,见 runner/types.ts 的 ExperimentDef.setup);\n    // 传成非函数(如误把 sandbox 钩子对象塞进来)在解析时就报,不等到调度才炸。\n    if (def.setup !== undefined && typeof def.setup !== \"function\") {\n        throw new Error(t(\"define.experimentSetupNotFunction\"));\n    }\n    // teardown 与 setup 是同一个 Experiment lifecycle 边界。非函数值绝不能\n    // 伪装成已声明的 cleanup，否则 explicit sharedState recovery 可能在没有\n    // 执行补偿的情况下释放 immutable owner generation。\n    if (def.teardown !== undefined && typeof def.teardown !== \"function\") {\n        throw new Error(t(\"define.experimentTeardownNotFunction\"));\n    }\n    // classifyFailure 是失败分类链上的实验通道(见 runner/types.ts 的 ExperimentDef.classifyFailure):\n    // 传成非函数在解析时就报,不等到某条 attempt 撞死才发现这一路声明白写。\n    if (def.classifyFailure !== undefined && typeof def.classifyFailure !== \"function\") {\n        throw new Error(t(\"define.experimentClassifyFailureNotFunction\"));\n    }\n    // labels 是报告归类坐标(进 ExperimentRunInfo.labels,不透传 ctx/t):值域 string | number,\n    // 解析时即校验,布尔 / 对象 / NaN 直接报错,不等到落盘或报告分组才炸。\n    if (def.labels !== undefined) {\n        for (const [key, value] of Object.entries(def.labels)) {\n            const ok = typeof value === \"string\" || (typeof value === \"number\" && Number.isFinite(value));\n            if (!ok)\n                throw new Error(t(\"define.experimentLabelInvalid\", { key }));\n        }\n    }\n    const sharedState = normalizeSharedState(def.sharedState);\n    const { id: _derivedId, sharedState: _sharedState, ...author } = def;\n    return brandExperimentDefinition({\n        ...author,\n        flags: decodeJsonRecord(def.flags ?? {}, \"defineExperiment flags\"),\n        labels: Object.freeze({ ...(def.labels ?? {}) }),\n        attempts: def.attempts ?? 1,\n        earlyExit: def.earlyExit ?? false,\n        evals: Array.isArray(def.evals) ? Object.freeze([...def.evals]) : (def.evals ?? \"*\"),\n        sandboxReuse: def.sandboxReuse === true,\n        ...(sharedState === undefined ? {} : { sharedState }),\n        plugins: normalizePlugins(def.plugins ?? [], \"defineExperiment plugins\", \"experiment\"),\n    });\n}\nconst SharedStateKeyPattern = /^[a-z0-9][a-z0-9._/-]{0,127}$/u;\nfunction normalizeSharedState(value: unknown): SharedStateConfig | undefined {\n    if (value === undefined)\n        return undefined;\n    const candidate = value as {\n        key?: unknown;\n    };\n    if (typeof value !== \"object\" ||\n        value === null ||\n        Array.isArray(value) ||\n        !Object.hasOwn(value, \"key\") ||\n        Object.keys(value).length !== 1 ||\n        typeof candidate.key !== \"string\" ||\n        !SharedStateKeyPattern.test(candidate.key)) {\n        throw new TypeError(t(\"define.experimentSharedStateInvalid\"));\n    }\n    return Object.freeze({ key: candidate.key });\n}\nfunction normalizeEvalFields<const Sandbox extends SandboxLayer | undefined>(def: EvalInput<Sandbox> | ScoreEvalInput<Sandbox>): EvalDefinitionFields<Sandbox> {\n    return {\n        ...(def.description !== undefined ? { description: def.description } : {}),\n        tags: Object.freeze([...(def.tags ?? [])]),\n        ...(def.sandbox !== undefined ? { sandbox: def.sandbox } : {}),\n        plugins: normalizePlugins(def.plugins ?? [], \"defineEval plugins\", \"eval\"),\n        ...(def.judge !== undefined ? { judge: def.judge } : {}),\n        reporters: Object.freeze([...(def.reporters ?? [])]),\n        ...(def.timeoutMs !== undefined ? { timeoutMs: def.timeoutMs } : {}),\n        metadata: decodeJsonRecord(def.metadata ?? {}, \"Eval metadata\"),\n        diff: Object.freeze({\n            include: Object.freeze([...(def.diff?.include ?? [])]),\n            ignore: Object.freeze([...(def.diff?.ignore ?? [])]),\n        }),\n    };\n}\nfunction normalizePlugins<Owner extends PluginOwner>(value: readonly PluginInstance<Owner>[], label: string, owner: Owner): readonly PluginInstance<Owner>[] {\n    if (!Array.isArray(value))\n        throw new TypeError(`${label} must be an array.`);\n    return Object.freeze(value.map((plugin, index) => {\n        if (!isPluginInstance(plugin))\n            throw new TypeError(`${label}[${index}] must be created by definePlugin().`);\n        if (pluginInstanceDataOf(plugin)[owner] === undefined) {\n            throw new TypeError(`${label}[${index}] does not support ${owner} attachment.`);\n        }\n        return plugin;\n    }));\n}\nfunction isJsonValue(value: unknown): value is JsonValue {\n    if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\n        return true;\n    if (typeof value === \"number\")\n        return Number.isFinite(value);\n    if (Array.isArray(value))\n        return value.every(isJsonValue);\n    if (typeof value !== \"object\")\n        return false;\n    return Object.values(value).every(isJsonValue);\n}\nconst JsonValueSchema = Schema.declare<JsonValue>(isJsonValue);\nconst JsonRecordSchema = Schema.Record({ key: Schema.String, value: JsonValueSchema });\nfunction deepFreezeJson(value: JsonValue): JsonValue {\n    if (Array.isArray(value)) {\n        const items: JsonValue[] = value.map(deepFreezeJson);\n        Object.freeze(items);\n        return items;\n    }\n    if (value !== null && typeof value === \"object\") {\n        const record: globalThis.Record<string, JsonValue> = Object.fromEntries(Object.entries(value).map(([key, child]) => [key, deepFreezeJson(child)]));\n        Object.freeze(record);\n        return record;\n    }\n    return value;\n}\nfunction decodeJsonRecord(value: Readonly<globalThis.Record<string, JsonValue>>, label: string): Readonly<globalThis.Record<string, JsonValue>> {\n    const decoded = Schema.decodeUnknownEither(JsonRecordSchema, { errors: \"all\" })(value);\n    if (Either.isLeft(decoded))\n        throw new TypeError(`${label} must be JSON-compatible: ${String(decoded.left)}`);\n    return Object.freeze(Object.fromEntries(Object.entries(decoded.right).map(([key, child]) => [key, deepFreezeJson(child)])));\n}\n/**\n * `SandboxLayer` 的品牌只由 `niceeval/sandbox` 工厂写入。动态 TSX/JS 调用绕过静态类型时，\n * 不接受看似相同的裸对象，以免在 linker 阶段才得到难以定位的错误。\n */\nfunction assertSandboxLayer(value: unknown, factory: string): void {\n    if (value !== undefined && !isSandboxLayer(value)) {\n        throw new TypeError(`${factory} sandbox must be a SandboxLayer created by a niceeval/sandbox factory (for example dockerSandbox(), dockerComposeSandbox(), e2bSandbox(), or vercelSandbox()).`);\n    }\n}\n/** 项目级配置。 */\nexport function defineConfig(config: Config): Config {\n    return config;\n}\n/**\n * 自定义沙箱 provider:`create` 直接返回一个实现 `Sandbox` 接口的实例,不需要 niceeval 内置支持\n * 这个 provider 名字。用于接入 docker/vercel/e2b 之外的运行环境(自建 VM、Modal、Fly 等)。\n */\nexport function defineSandbox(def: CustomProviderSandboxOptions): SandboxLayer<\"template-bearing\", \"prepare-only\"> {\n    return customProviderSandbox(def);\n}\n"]}

package/dist/docker/cache-administration.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DockerCacheAdministration = void 0;
+const effect_1 = require("effect");
+class DockerCacheAdministration extends effect_1.Context.Tag("niceeval/docker/DockerCacheAdministration")() {
+}
+exports.DockerCacheAdministration = DockerCacheAdministration;
+//# sourceMappingURL=cache-administration.cjs.map

package/dist/docker/cache-administration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-administration.js","sourceRoot":"","sources":["cache-administration.ts"],"names":[],"mappings":";;;AAAA,mCAAyC;AA6BzC,MAAa,yBAA0B,SAAQ,gBAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,EAA+D;CACrK;AADD,8DACC","sourcesContent":["import { Context, Effect } from \"effect\";\nexport interface DockerCacheDomainDescriptor {\n    readonly providerFamily: \"docker\";\n    readonly adminProtocolVersion: number;\n    readonly domainId: string;\n    readonly backendKind: string;\n    readonly state: \"verified-managed\" | \"verified-read-only\" | \"unverified\" | \"unavailable\";\n}\nexport interface DockerCapacityObservation {\n    readonly scope: \"provider\";\n    readonly providerFamily: \"docker\";\n    readonly backendKind: string;\n    readonly state: \"unverified\";\n    readonly observedAt: string;\n    readonly totalBytes: number | null;\n    readonly reclaimableEstimateBytes: number | null;\n    readonly reason: string;\n}\nexport interface DockerCacheDomainAdministration {\n    readonly descriptor: DockerCacheDomainDescriptor;\n    inventory(): Effect.Effect<unknown, Error>;\n    planGc(): Effect.Effect<unknown, Error>;\n    applyGc(planId: string): Effect.Effect<unknown, Error>;\n}\nexport interface DockerCacheAdministrationService {\n    listDomains(): Effect.Effect<readonly DockerCacheDomainDescriptor[], Error>;\n    observeBuildKitCapacity(): Effect.Effect<readonly DockerCapacityObservation[], Error>;\n    openDomain(descriptor: DockerCacheDomainDescriptor): Effect.Effect<DockerCacheDomainAdministration, Error>;\n}\nexport class DockerCacheAdministration extends Context.Tag(\"niceeval/docker/DockerCacheAdministration\")<DockerCacheAdministration, DockerCacheAdministrationService>() {\n}\n"]}