niceeval 0.18.0 → 0.19.0

package/dist/loaders/runtime.d.mts

@@ -0,0 +1,95 @@
+/**
+ * Internal discovery provenance. A shared helper is evaluated only once in a
+ * fresh module graph, so discovery uses its source module to copy these paths
+ * to every Eval entry that statically imports that helper.
+ */
+export interface LoaderCaptureOrigin {
+    readonly sourcePath: string;
+    readonly paths: readonly string[];
+    readonly criteriaPaths: readonly string[];
+    readonly privatePaths: readonly string[];
+}
+export interface LoaderCapturePaths {
+    readonly paths: readonly string[];
+    readonly criteriaPaths: readonly string[];
+    readonly privatePaths: readonly string[];
+}
+/**
+ * 发现期包住一个 eval 模块的求值，记录它经公开 loader 读取的数据文件（`paths`）、
+ * 经 `loadCriteria` 登记的判据树（`criteriaPaths`）、经 `loadPrivate` 登记的永不上传路径
+ * （`privatePaths`）。三格分开是因为指纹与泄题门口径不同:
+ * data 哈希已读进内存的内容;criteria / private 按内容流式哈希,且 private 另进泄题门。
+ */
+export declare function captureLoadedFiles<T>(load: () => Promise<T>): Promise<{
+    value: T;
+    paths: string[];
+    criteriaPaths: string[];
+    privatePaths: string[];
+    origins: readonly LoaderCaptureOrigin[];
+    unattributed: LoaderCapturePaths;
+}>;
+/**
+ * 读入一个 JSON 数据文件并解析。路径写项目根相对的字符串,或 eval 文件相对的
+ * `new URL(p, import.meta.url)`。内容哈希进读它的那条 eval 的指纹。`decode` 必须在
+ * 这个动态输入边界完成结构验证与归一；不提供「用泛型直接信任文件」的入口。
+ */
+type DecodedData<T> = unknown extends T ? never : T;
+/**
+ * 动态文件值到领域值的唯一出口。`unknown`（以及会把它吞掉的 `any`）不能成为解码结果；
+ * decoder 必须返回一个比动态输入更窄、可供 Eval 定义直接使用的领域类型。
+ */
+export type DataDecoder<T> = (value: unknown) => DecodedData<T> | Promise<DecodedData<T>>;
+export declare function loadJson<T>(path: string | URL, decode: DataDecoder<T>): Promise<T>;
+/**
+ * 按 utf-8 读入一个文件的原文。判据不是结构化数据时用它:隐藏测试脚本、参考实现、
+ * shell 模板都是判据文件。读入即宣告「它参与判定」——文件内容哈希进读它的那条 eval
+ * 的指纹,改一字节就重跑那条 eval。用 `fs` 自行读入的文件不进指纹。
+ * 路径写项目根相对的字符串,或 eval 文件相对的 `new URL(p, import.meta.url)`。
+ */
+export declare function loadText(path: string | URL): Promise<string>;
+/** eval 文件相对的 glob；pattern 与 URL 分开，避免 URL parser 改写 glob 字符。 */
+export interface RelativeCriteriaPattern {
+    readonly pattern: string;
+    readonly relativeTo: URL;
+}
+export type CriteriaPattern = string | RelativeCriteriaPattern;
+/**
+ * 登记一棵判据树进这条 eval 的指纹,不把内容读进内存。判分标准是一整棵树(隐藏测试目录、
+ * 参考实现、跑测脚本)、内容只经 `t.sandbox.uploadDirectory` 整体送进沙箱时用它:
+ * 发现期展开 glob、把每个匹配文件流式哈希进指纹,返回排序后的项目根相对路径清单。
+ * 树里改一字节、增一个文件、删一个文件,都作废引用这棵树的那条 eval;权限位与修改时间不进哈希,
+ * 重新 clone 一份工作树不作废。单个文件、且内容要写进沙箱时用 `loadText`。
+ *
+ * pattern 是项目根相对的 glob(`**` 跨层、`*` / `?` 段内、`[...]` 字符类、`{a,b}` 分支),
+ * `!` 前缀为排除;按声明顺序求值,后写的覆盖先写的。匹配集按文件系统枚举、不看 git:
+ * 新写的判据没 `git add` 也照样进指纹,代价是本地跑测冒出的生成物同样被盖到,用 `!` 排除。
+ *
+ * 只能在 eval 文件的模块顶层调用(发现期求值那一刻),`test(t)` 运行期调用直接报错——
+ * 携带决策发生在任何 attempt 执行之前,那时才登记已经来不及。
+ *
+ * 两种用法错误直接抛:某个 include pattern 一个文件都没匹配到(或命中的都被 `!` 排除了)——
+ * 多半是写错了或文件搬走了,别的 pattern 有命中也不放过,静默放过等于判据悄悄变窄;
+ * 以及匹配落到项目根外(符号链接穿出根)。`!` 排除 pattern 不受「必须有命中」这条约束。
+ *
+ * @param patterns 项目根相对 glob,或 `{ pattern, relativeTo: import.meta.url }`;`!` 排除只收字符串。
+ * @returns 匹配集的项目根相对路径,排序后(正斜杠分隔),不含内容。
+ */
+export declare function loadCriteria(...patterns: CriteriaPattern[]): Promise<string[]>;
+/**
+ * 登记永不上传的 private 路径进这条 eval 的判据指纹与泄题门,不把内容读进内存。
+ * solution、生成器、参考答案必须与 eval 共址时用它:发现期与全部 build context /
+ * bind mount 交叉检查,任何阶段都不得进入 Agent 可见面(见 docs/feature/sandbox/case.md「泄题门」)。
+ *
+ * pattern 语法、发现期约束、空匹配与穿出项目根的报错与 `loadCriteria` 同形。
+ *
+ * @param patterns 一个或多个项目根相对 glob,`!` 前缀为排除。
+ * @returns 匹配集的项目根相对路径,排序后(正斜杠分隔),不含内容。
+ */
+export declare function loadPrivate(...patterns: string[]): Promise<string[]>;
+/**
+ * 读入一个 YAML 数据文件并解析,需要项目里装了 `yaml`。路径写项目根相对的字符串,
+ * 或 eval 文件相对的 `new URL(p, import.meta.url)`。内容哈希进读它的那条 eval 的指纹。解析结果与
+ * JSON 一样必须立即经 `decode` 验证，不让未证明的动态值进入 Eval 定义。
+ */
+export declare function loadYaml<T>(path: string | URL, decode: DataDecoder<T>): Promise<T>;
+export {};

package/dist/loaders/runtime.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Internal discovery provenance. A shared helper is evaluated only once in a
+ * fresh module graph, so discovery uses its source module to copy these paths
+ * to every Eval entry that statically imports that helper.
+ */
+export interface LoaderCaptureOrigin {
+    readonly sourcePath: string;
+    readonly paths: readonly string[];
+    readonly criteriaPaths: readonly string[];
+    readonly privatePaths: readonly string[];
+}
+export interface LoaderCapturePaths {
+    readonly paths: readonly string[];
+    readonly criteriaPaths: readonly string[];
+    readonly privatePaths: readonly string[];
+}
+/**
+ * 发现期包住一个 eval 模块的求值，记录它经公开 loader 读取的数据文件（`paths`）、
+ * 经 `loadCriteria` 登记的判据树（`criteriaPaths`）、经 `loadPrivate` 登记的永不上传路径
+ * （`privatePaths`）。三格分开是因为指纹与泄题门口径不同:
+ * data 哈希已读进内存的内容;criteria / private 按内容流式哈希,且 private 另进泄题门。
+ */
+export declare function captureLoadedFiles<T>(load: () => Promise<T>): Promise<{
+    value: T;
+    paths: string[];
+    criteriaPaths: string[];
+    privatePaths: string[];
+    origins: readonly LoaderCaptureOrigin[];
+    unattributed: LoaderCapturePaths;
+}>;
+/**
+ * 读入一个 JSON 数据文件并解析。路径写项目根相对的字符串,或 eval 文件相对的
+ * `new URL(p, import.meta.url)`。内容哈希进读它的那条 eval 的指纹。`decode` 必须在
+ * 这个动态输入边界完成结构验证与归一；不提供「用泛型直接信任文件」的入口。
+ */
+type DecodedData<T> = unknown extends T ? never : T;
+/**
+ * 动态文件值到领域值的唯一出口。`unknown`（以及会把它吞掉的 `any`）不能成为解码结果；
+ * decoder 必须返回一个比动态输入更窄、可供 Eval 定义直接使用的领域类型。
+ */
+export type DataDecoder<T> = (value: unknown) => DecodedData<T> | Promise<DecodedData<T>>;
+export declare function loadJson<T>(path: string | URL, decode: DataDecoder<T>): Promise<T>;
+/**
+ * 按 utf-8 读入一个文件的原文。判据不是结构化数据时用它:隐藏测试脚本、参考实现、
+ * shell 模板都是判据文件。读入即宣告「它参与判定」——文件内容哈希进读它的那条 eval
+ * 的指纹,改一字节就重跑那条 eval。用 `fs` 自行读入的文件不进指纹。
+ * 路径写项目根相对的字符串,或 eval 文件相对的 `new URL(p, import.meta.url)`。
+ */
+export declare function loadText(path: string | URL): Promise<string>;
+/** eval 文件相对的 glob；pattern 与 URL 分开，避免 URL parser 改写 glob 字符。 */
+export interface RelativeCriteriaPattern {
+    readonly pattern: string;
+    readonly relativeTo: URL;
+}
+export type CriteriaPattern = string | RelativeCriteriaPattern;
+/**
+ * 登记一棵判据树进这条 eval 的指纹,不把内容读进内存。判分标准是一整棵树(隐藏测试目录、
+ * 参考实现、跑测脚本)、内容只经 `t.sandbox.uploadDirectory` 整体送进沙箱时用它:
+ * 发现期展开 glob、把每个匹配文件流式哈希进指纹,返回排序后的项目根相对路径清单。
+ * 树里改一字节、增一个文件、删一个文件,都作废引用这棵树的那条 eval;权限位与修改时间不进哈希,
+ * 重新 clone 一份工作树不作废。单个文件、且内容要写进沙箱时用 `loadText`。
+ *
+ * pattern 是项目根相对的 glob(`**` 跨层、`*` / `?` 段内、`[...]` 字符类、`{a,b}` 分支),
+ * `!` 前缀为排除;按声明顺序求值,后写的覆盖先写的。匹配集按文件系统枚举、不看 git:
+ * 新写的判据没 `git add` 也照样进指纹,代价是本地跑测冒出的生成物同样被盖到,用 `!` 排除。
+ *
+ * 只能在 eval 文件的模块顶层调用(发现期求值那一刻),`test(t)` 运行期调用直接报错——
+ * 携带决策发生在任何 attempt 执行之前,那时才登记已经来不及。
+ *
+ * 两种用法错误直接抛:某个 include pattern 一个文件都没匹配到(或命中的都被 `!` 排除了)——
+ * 多半是写错了或文件搬走了,别的 pattern 有命中也不放过,静默放过等于判据悄悄变窄;
+ * 以及匹配落到项目根外(符号链接穿出根)。`!` 排除 pattern 不受「必须有命中」这条约束。
+ *
+ * @param patterns 项目根相对 glob,或 `{ pattern, relativeTo: import.meta.url }`;`!` 排除只收字符串。
+ * @returns 匹配集的项目根相对路径,排序后(正斜杠分隔),不含内容。
+ */
+export declare function loadCriteria(...patterns: CriteriaPattern[]): Promise<string[]>;
+/**
+ * 登记永不上传的 private 路径进这条 eval 的判据指纹与泄题门,不把内容读进内存。
+ * solution、生成器、参考答案必须与 eval 共址时用它:发现期与全部 build context /
+ * bind mount 交叉检查,任何阶段都不得进入 Agent 可见面(见 docs/feature/sandbox/case.md「泄题门」)。
+ *
+ * pattern 语法、发现期约束、空匹配与穿出项目根的报错与 `loadCriteria` 同形。
+ *
+ * @param patterns 一个或多个项目根相对 glob,`!` 前缀为排除。
+ * @returns 匹配集的项目根相对路径,排序后(正斜杠分隔),不含内容。
+ */
+export declare function loadPrivate(...patterns: string[]): Promise<string[]>;
+/**
+ * 读入一个 YAML 数据文件并解析,需要项目里装了 `yaml`。路径写项目根相对的字符串,
+ * 或 eval 文件相对的 `new URL(p, import.meta.url)`。内容哈希进读它的那条 eval 的指纹。解析结果与
+ * JSON 一样必须立即经 `decode` 验证，不让未证明的动态值进入 Eval 定义。
+ */
+export declare function loadYaml<T>(path: string | URL, decode: DataDecoder<T>): Promise<T>;
+export {};

package/dist/loaders/runtime.js

@@ -0,0 +1,16 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./runtime.cjs");
+const __niceevalExport0 = __niceevalCanonical["captureLoadedFiles"];
+export { __niceevalExport0 as captureLoadedFiles };
+const __niceevalExport1 = __niceevalCanonical["loadCriteria"];
+export { __niceevalExport1 as loadCriteria };
+const __niceevalExport2 = __niceevalCanonical["loadJson"];
+export { __niceevalExport2 as loadJson };
+const __niceevalExport3 = __niceevalCanonical["loadPrivate"];
+export { __niceevalExport3 as loadPrivate };
+const __niceevalExport4 = __niceevalCanonical["loadText"];
+export { __niceevalExport4 as loadText };
+const __niceevalExport5 = __niceevalCanonical["loadYaml"];
+export { __niceevalExport5 as loadYaml };
+//# sourceMappingURL=runtime.js.map

package/dist/loaders/runtime.js.map

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

package/dist/migrations/judge-provider.md

@@ -20,7 +20,7 @@ shape can contain any of these legacy fields:
 ```
 
 Choose the provider that actually serves the model, construct it explicitly,
-and assign that value to `judgeRuntime`. This makes the service, protocol,
+and assign that value to `judgeProvider`. This makes the service, protocol,
 endpoint, credential source, and execution limits unambiguous.
 
 ## OpenAI and OpenAI-compatible endpoints
@@ -30,7 +30,7 @@ import { defineConfig } from "niceeval";
 import { OpenAIProvider } from "niceeval/judge";
 
 export default defineConfig({
-  judgeRuntime: OpenAIProvider({
+  judgeProvider: OpenAIProvider({
     model: "judge-model",
     // Keep this only for an OpenAI-compatible custom gateway:
     // baseUrl: "https://gateway.example.test/v1",
@@ -52,7 +52,7 @@ import { defineConfig } from "niceeval";
 import { VercelProvider } from "niceeval/judge";
 
 export default defineConfig({
-  judgeRuntime: VercelProvider({ model: "provider/model" }),
+  judgeProvider: VercelProvider({ model: "provider/model" }),
 });
 ```
 
@@ -65,7 +65,7 @@ import { defineConfig } from "niceeval";
 import { OpenRouterProvider } from "niceeval/judge";
 
 export default defineConfig({
-  judgeRuntime: OpenRouterProvider({ model: "provider/model" }),
+  judgeProvider: OpenRouterProvider({ model: "provider/model" }),
 });
 ```
 
@@ -78,7 +78,7 @@ import { defineConfig } from "niceeval";
 import { TypesafeProvider } from "niceeval/judge";
 
 export default defineConfig({
-  judgeRuntime: TypesafeProvider({ model: "jev-1.13.0" }),
+  judgeProvider: TypesafeProvider({ model: "jev-1.13.0" }),
 });
 ```
 
@@ -99,7 +99,7 @@ If an existing deployment must keep its current variable name temporarily,
 select it explicitly without copying the secret into source code:
 
 ```ts
-judgeRuntime: OpenAIProvider({
+judgeProvider: OpenAIProvider({
   model: "judge-model",
   apiKeyEnv: "NICEEVAL_JUDGE_KEY",
 })

package/dist/{model-slots.cjs → model-roles.cjs}

@@ -1,19 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResolvedModelSlotsSchema = void 0;
-exports.defineModelSlots = defineModelSlots;
+exports.ResolvedModelRolesSchema = void 0;
+exports.defineModelRoles = defineModelRoles;
 exports.normalizeModelRequirements = normalizeModelRequirements;
-exports.assertRequiredModelSlots = assertRequiredModelSlots;
-exports.normalizeModelSlots = normalizeModelSlots;
+exports.assertRequiredModelRoles = assertRequiredModelRoles;
+exports.normalizeModelRoles = normalizeModelRoles;
 const effect_1 = require("effect");
 const modelText = effect_1.Schema.String.check(effect_1.Schema.isPattern(/\S/u));
-const slotKey = effect_1.Schema.String.check(effect_1.Schema.isPattern(/^[A-Za-z][A-Za-z0-9_-]{0,63}$(?![\s\S])/u));
-const selections = effect_1.Schema.Record(slotKey, effect_1.Schema.Struct({
+const roleKey = effect_1.Schema.String.check(effect_1.Schema.isPattern(/^[A-Za-z][A-Za-z0-9_-]{0,63}$(?![\s\S])/u));
+const selections = effect_1.Schema.Record(roleKey, effect_1.Schema.Struct({
     model: modelText,
     reasoningEffort: effect_1.Schema.optionalKey(modelText),
 })).check(effect_1.Schema.makeFilter((value) => Object.keys(value).length > 0 && Object.keys(value).length <= 64));
 /** Share immutable model purposes without binding an Eval to one Experiment. */
-function defineModelSlots(input) {
+function defineModelRoles(input) {
     const decoded = effect_1.Schema.decodeUnknownSync(selections, { onExcessProperty: "error" })(input);
     return Object.freeze(Object.fromEntries(Object.keys(decoded).sort().map((key) => [key, Object.freeze({ ...decoded[key] })])));
 }
@@ -23,17 +23,17 @@ function normalizeModelRequirements(value) {
     const decoded = effect_1.Schema.decodeUnknownSync(effect_1.Schema.Struct({ models: selections }), { onExcessProperty: "error" })(value);
     return Object.freeze(Object.keys(decoded.models).sort());
 }
-function assertRequiredModelSlots(required, models, subject) {
+function assertRequiredModelRoles(required, models, subject) {
     const missing = required?.filter((key) => !Object.hasOwn(models ?? {}, key)) ?? [];
     if (missing.length > 0)
-        throw new TypeError(`${subject} requires undeclared model slots: ${missing.join(", ")}.`);
+        throw new TypeError(`${subject} requires undeclared model roles: ${missing.join(", ")}.`);
 }
-exports.ResolvedModelSlotsSchema = effect_1.Schema.Record(slotKey, effect_1.Schema.Struct({
+exports.ResolvedModelRolesSchema = effect_1.Schema.Record(roleKey, effect_1.Schema.Struct({
     model: effect_1.Schema.NullOr(modelText),
     reasoningEffort: effect_1.Schema.NullOr(modelText),
 })).check(effect_1.Schema.makeFilter((value) => Object.keys(value).length <= 64));
 /** Only the definition boundary interprets author syntax. Downstream owners pass this value through. */
-function normalizeModelSlots(input) {
+function normalizeModelRoles(input) {
     if (input.models !== undefined) {
         if (input.model !== undefined || input.reasoningEffort !== undefined) {
             throw new TypeError("Experiment models cannot be combined with model or reasoningEffort.");
@@ -51,4 +51,4 @@ function normalizeModelSlots(input) {
             reasoningEffort: input.reasoningEffort === undefined ? null : effect_1.Schema.decodeUnknownSync(modelText)(input.reasoningEffort),
         }) });
 }
-//# sourceMappingURL=model-slots.cjs.map
+//# sourceMappingURL=model-roles.cjs.map

package/dist/{model-slots.cjs.map → model-roles.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"model-slots.js","sourceRoot":"","sources":["model-slots.ts"],"names":[],"mappings":"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","sourcesContent":["import { Schema } from \"effect\";\n/** A model selected for one application-defined purpose. */\nexport interface ModelSlotSelection {\n    readonly model: string;\n    readonly reasoningEffort?: string;\n}\n/** Frozen selection; null preserves an unspecified native default. */\nexport interface ResolvedModelSlot {\n    readonly model: string | null;\n    readonly reasoningEffort: string | null;\n}\nexport type ResolvedModelSlots = Readonly<Record<string, ResolvedModelSlot>>;\nconst modelText = Schema.String.check(Schema.isPattern(/\\S/u));\nconst slotKey = Schema.String.check(Schema.isPattern(/^[A-Za-z][A-Za-z0-9_-]{0,63}$(?![\\s\\S])/u));\nconst selections = Schema.Record(slotKey, Schema.Struct({\n    model: modelText,\n    reasoningEffort: Schema.optionalKey(modelText),\n})).check(Schema.makeFilter((value) => Object.keys(value).length > 0 && Object.keys(value).length <= 64));\nexport interface ModelRequirements<Keys extends string = string> {\n    readonly models: Readonly<Record<Keys, ModelSlotSelection>>;\n}\n/** Share immutable model purposes without binding an Eval to one Experiment. */\nexport function defineModelSlots<const Keys extends string>(input: Readonly<Record<Keys, ModelSlotSelection>>): Readonly<Record<Keys, ModelSlotSelection>> {\n    const decoded = Schema.decodeUnknownSync(selections, { onExcessProperty: \"error\" })(input);\n    return Object.freeze(Object.fromEntries(Object.keys(decoded).sort().map((key) => [key, Object.freeze({ ...decoded[key]! })]))) as Readonly<Record<Keys, ModelSlotSelection>>;\n}\nexport function normalizeModelRequirements(value: unknown): readonly string[] | undefined {\n    if (value === undefined)\n        return undefined;\n    const decoded = Schema.decodeUnknownSync(Schema.Struct({ models: selections }), { onExcessProperty: \"error\" })(value);\n    return Object.freeze(Object.keys(decoded.models).sort());\n}\nexport function assertRequiredModelSlots(required: readonly string[] | undefined, models: ResolvedModelSlots | undefined, subject: string): void {\n    const missing = required?.filter((key) => !Object.hasOwn(models ?? {}, key)) ?? [];\n    if (missing.length > 0)\n        throw new TypeError(`${subject} requires undeclared model slots: ${missing.join(\", \")}.`);\n}\nexport const ResolvedModelSlotsSchema: Schema.Codec<ResolvedModelSlots> = Schema.Record(slotKey, Schema.Struct({\n    model: Schema.NullOr(modelText),\n    reasoningEffort: Schema.NullOr(modelText),\n})).check(Schema.makeFilter((value) => Object.keys(value).length <= 64));\n/** Only the definition boundary interprets author syntax. Downstream owners pass this value through. */\nexport function normalizeModelSlots(input: {\n    readonly model?: string;\n    readonly reasoningEffort?: string;\n    readonly models?: Readonly<Record<string, ModelSlotSelection>>;\n}): ResolvedModelSlots {\n    if (input.models !== undefined) {\n        if (input.model !== undefined || input.reasoningEffort !== undefined) {\n            throw new TypeError(\"Experiment models cannot be combined with model or reasoningEffort.\");\n        }\n        const decoded = Schema.decodeUnknownSync(selections, { onExcessProperty: \"error\" })(input.models);\n        return Object.freeze(Object.fromEntries(Object.keys(decoded).sort().map((key) => {\n            const value = decoded[key]!;\n            return [key, Object.freeze({ model: value.model, reasoningEffort: value.reasoningEffort ?? null })];\n        })));\n    }\n    if (input.model === undefined && input.reasoningEffort === undefined)\n        return Object.freeze({});\n    return Object.freeze({ default: Object.freeze({\n            model: input.model === undefined ? null : Schema.decodeUnknownSync(modelText)(input.model),\n            reasoningEffort: input.reasoningEffort === undefined ? null : Schema.decodeUnknownSync(modelText)(input.reasoningEffort),\n        }) });\n}\n"]}
+{"version":3,"file":"model-roles.js","sourceRoot":"","sources":["model-roles.ts"],"names":[],"mappings":"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","sourcesContent":["import { Schema } from \"effect\";\n/** A model selected for one application-defined purpose. */\nexport interface ModelRoleSelection {\n    readonly model: string;\n    readonly reasoningEffort?: string;\n}\n/** Frozen selection; null preserves an unspecified native default. */\nexport interface ResolvedModelRole {\n    readonly model: string | null;\n    readonly reasoningEffort: string | null;\n}\nexport type ResolvedModelRoles = Readonly<Record<string, ResolvedModelRole>>;\nconst modelText = Schema.String.check(Schema.isPattern(/\\S/u));\nconst roleKey = Schema.String.check(Schema.isPattern(/^[A-Za-z][A-Za-z0-9_-]{0,63}$(?![\\s\\S])/u));\nconst selections = Schema.Record(roleKey, Schema.Struct({\n    model: modelText,\n    reasoningEffort: Schema.optionalKey(modelText),\n})).check(Schema.makeFilter((value) => Object.keys(value).length > 0 && Object.keys(value).length <= 64));\nexport interface ModelRequirements<Keys extends string = string> {\n    readonly models: Readonly<Record<Keys, ModelRoleSelection>>;\n}\n/** Share immutable model purposes without binding an Eval to one Experiment. */\nexport function defineModelRoles<const Keys extends string>(input: Readonly<Record<Keys, ModelRoleSelection>>): Readonly<Record<Keys, ModelRoleSelection>> {\n    const decoded = Schema.decodeUnknownSync(selections, { onExcessProperty: \"error\" })(input);\n    return Object.freeze(Object.fromEntries(Object.keys(decoded).sort().map((key) => [key, Object.freeze({ ...decoded[key]! })]))) as Readonly<Record<Keys, ModelRoleSelection>>;\n}\nexport function normalizeModelRequirements(value: unknown): readonly string[] | undefined {\n    if (value === undefined)\n        return undefined;\n    const decoded = Schema.decodeUnknownSync(Schema.Struct({ models: selections }), { onExcessProperty: \"error\" })(value);\n    return Object.freeze(Object.keys(decoded.models).sort());\n}\nexport function assertRequiredModelRoles(required: readonly string[] | undefined, models: ResolvedModelRoles | undefined, subject: string): void {\n    const missing = required?.filter((key) => !Object.hasOwn(models ?? {}, key)) ?? [];\n    if (missing.length > 0)\n        throw new TypeError(`${subject} requires undeclared model roles: ${missing.join(\", \")}.`);\n}\nexport const ResolvedModelRolesSchema: Schema.Codec<ResolvedModelRoles> = Schema.Record(roleKey, Schema.Struct({\n    model: Schema.NullOr(modelText),\n    reasoningEffort: Schema.NullOr(modelText),\n})).check(Schema.makeFilter((value) => Object.keys(value).length <= 64));\n/** Only the definition boundary interprets author syntax. Downstream owners pass this value through. */\nexport function normalizeModelRoles(input: {\n    readonly model?: string;\n    readonly reasoningEffort?: string;\n    readonly models?: Readonly<Record<string, ModelRoleSelection>>;\n}): ResolvedModelRoles {\n    if (input.models !== undefined) {\n        if (input.model !== undefined || input.reasoningEffort !== undefined) {\n            throw new TypeError(\"Experiment models cannot be combined with model or reasoningEffort.\");\n        }\n        const decoded = Schema.decodeUnknownSync(selections, { onExcessProperty: \"error\" })(input.models);\n        return Object.freeze(Object.fromEntries(Object.keys(decoded).sort().map((key) => {\n            const value = decoded[key]!;\n            return [key, Object.freeze({ model: value.model, reasoningEffort: value.reasoningEffort ?? null })];\n        })));\n    }\n    if (input.model === undefined && input.reasoningEffort === undefined)\n        return Object.freeze({});\n    return Object.freeze({ default: Object.freeze({\n            model: input.model === undefined ? null : Schema.decodeUnknownSync(modelText)(input.model),\n            reasoningEffort: input.reasoningEffort === undefined ? null : Schema.decodeUnknownSync(modelText)(input.reasoningEffort),\n        }) });\n}\n"]}

package/dist/{model-slots.d.cts → model-roles.d.cts}

@@ -1,26 +1,26 @@
 import { Schema } from "effect";
 /** A model selected for one application-defined purpose. */
-export interface ModelSlotSelection {
+export interface ModelRoleSelection {
     readonly model: string;
     readonly reasoningEffort?: string;
 }
 /** Frozen selection; null preserves an unspecified native default. */
-export interface ResolvedModelSlot {
+export interface ResolvedModelRole {
     readonly model: string | null;
     readonly reasoningEffort: string | null;
 }
-export type ResolvedModelSlots = Readonly<Record<string, ResolvedModelSlot>>;
+export type ResolvedModelRoles = Readonly<Record<string, ResolvedModelRole>>;
 export interface ModelRequirements<Keys extends string = string> {
-    readonly models: Readonly<Record<Keys, ModelSlotSelection>>;
+    readonly models: Readonly<Record<Keys, ModelRoleSelection>>;
 }
 /** Share immutable model purposes without binding an Eval to one Experiment. */
-export declare function defineModelSlots<const Keys extends string>(input: Readonly<Record<Keys, ModelSlotSelection>>): Readonly<Record<Keys, ModelSlotSelection>>;
+export declare function defineModelRoles<const Keys extends string>(input: Readonly<Record<Keys, ModelRoleSelection>>): Readonly<Record<Keys, ModelRoleSelection>>;
 export declare function normalizeModelRequirements(value: unknown): readonly string[] | undefined;
-export declare function assertRequiredModelSlots(required: readonly string[] | undefined, models: ResolvedModelSlots | undefined, subject: string): void;
-export declare const ResolvedModelSlotsSchema: Schema.Codec<ResolvedModelSlots>;
+export declare function assertRequiredModelRoles(required: readonly string[] | undefined, models: ResolvedModelRoles | undefined, subject: string): void;
+export declare const ResolvedModelRolesSchema: Schema.Codec<ResolvedModelRoles>;
 /** Only the definition boundary interprets author syntax. Downstream owners pass this value through. */
-export declare function normalizeModelSlots(input: {
+export declare function normalizeModelRoles(input: {
     readonly model?: string;
     readonly reasoningEffort?: string;
-    readonly models?: Readonly<Record<string, ModelSlotSelection>>;
-}): ResolvedModelSlots;
+    readonly models?: Readonly<Record<string, ModelRoleSelection>>;
+}): ResolvedModelRoles;

package/dist/{model-slots.d.mts → model-roles.d.mts}

@@ -1,26 +1,26 @@
 import { Schema } from "effect";
 /** A model selected for one application-defined purpose. */
-export interface ModelSlotSelection {
+export interface ModelRoleSelection {
     readonly model: string;
     readonly reasoningEffort?: string;
 }
 /** Frozen selection; null preserves an unspecified native default. */
-export interface ResolvedModelSlot {
+export interface ResolvedModelRole {
     readonly model: string | null;
     readonly reasoningEffort: string | null;
 }
-export type ResolvedModelSlots = Readonly<Record<string, ResolvedModelSlot>>;
+export type ResolvedModelRoles = Readonly<Record<string, ResolvedModelRole>>;
 export interface ModelRequirements<Keys extends string = string> {
-    readonly models: Readonly<Record<Keys, ModelSlotSelection>>;
+    readonly models: Readonly<Record<Keys, ModelRoleSelection>>;
 }
 /** Share immutable model purposes without binding an Eval to one Experiment. */
-export declare function defineModelSlots<const Keys extends string>(input: Readonly<Record<Keys, ModelSlotSelection>>): Readonly<Record<Keys, ModelSlotSelection>>;
+export declare function defineModelRoles<const Keys extends string>(input: Readonly<Record<Keys, ModelRoleSelection>>): Readonly<Record<Keys, ModelRoleSelection>>;
 export declare function normalizeModelRequirements(value: unknown): readonly string[] | undefined;
-export declare function assertRequiredModelSlots(required: readonly string[] | undefined, models: ResolvedModelSlots | undefined, subject: string): void;
-export declare const ResolvedModelSlotsSchema: Schema.Codec<ResolvedModelSlots>;
+export declare function assertRequiredModelRoles(required: readonly string[] | undefined, models: ResolvedModelRoles | undefined, subject: string): void;
+export declare const ResolvedModelRolesSchema: Schema.Codec<ResolvedModelRoles>;
 /** Only the definition boundary interprets author syntax. Downstream owners pass this value through. */
-export declare function normalizeModelSlots(input: {
+export declare function normalizeModelRoles(input: {
     readonly model?: string;
     readonly reasoningEffort?: string;
-    readonly models?: Readonly<Record<string, ModelSlotSelection>>;
-}): ResolvedModelSlots;
+    readonly models?: Readonly<Record<string, ModelRoleSelection>>;
+}): ResolvedModelRoles;

package/dist/{model-slots.d.ts → model-roles.d.ts}

@@ -1,26 +1,26 @@
 import { Schema } from "effect";
 /** A model selected for one application-defined purpose. */
-export interface ModelSlotSelection {
+export interface ModelRoleSelection {
     readonly model: string;
     readonly reasoningEffort?: string;
 }
 /** Frozen selection; null preserves an unspecified native default. */
-export interface ResolvedModelSlot {
+export interface ResolvedModelRole {
     readonly model: string | null;
     readonly reasoningEffort: string | null;
 }
-export type ResolvedModelSlots = Readonly<Record<string, ResolvedModelSlot>>;
+export type ResolvedModelRoles = Readonly<Record<string, ResolvedModelRole>>;
 export interface ModelRequirements<Keys extends string = string> {
-    readonly models: Readonly<Record<Keys, ModelSlotSelection>>;
+    readonly models: Readonly<Record<Keys, ModelRoleSelection>>;
 }
 /** Share immutable model purposes without binding an Eval to one Experiment. */
-export declare function defineModelSlots<const Keys extends string>(input: Readonly<Record<Keys, ModelSlotSelection>>): Readonly<Record<Keys, ModelSlotSelection>>;
+export declare function defineModelRoles<const Keys extends string>(input: Readonly<Record<Keys, ModelRoleSelection>>): Readonly<Record<Keys, ModelRoleSelection>>;
 export declare function normalizeModelRequirements(value: unknown): readonly string[] | undefined;
-export declare function assertRequiredModelSlots(required: readonly string[] | undefined, models: ResolvedModelSlots | undefined, subject: string): void;
-export declare const ResolvedModelSlotsSchema: Schema.Codec<ResolvedModelSlots>;
+export declare function assertRequiredModelRoles(required: readonly string[] | undefined, models: ResolvedModelRoles | undefined, subject: string): void;
+export declare const ResolvedModelRolesSchema: Schema.Codec<ResolvedModelRoles>;
 /** Only the definition boundary interprets author syntax. Downstream owners pass this value through. */
-export declare function normalizeModelSlots(input: {
+export declare function normalizeModelRoles(input: {
     readonly model?: string;
     readonly reasoningEffort?: string;
-    readonly models?: Readonly<Record<string, ModelSlotSelection>>;
-}): ResolvedModelSlots;
+    readonly models?: Readonly<Record<string, ModelRoleSelection>>;
+}): ResolvedModelRoles;

package/dist/model-roles.js

@@ -0,0 +1,14 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./model-roles.cjs");
+const __niceevalExport0 = __niceevalCanonical["ResolvedModelRolesSchema"];
+export { __niceevalExport0 as ResolvedModelRolesSchema };
+const __niceevalExport1 = __niceevalCanonical["assertRequiredModelRoles"];
+export { __niceevalExport1 as assertRequiredModelRoles };
+const __niceevalExport2 = __niceevalCanonical["defineModelRoles"];
+export { __niceevalExport2 as defineModelRoles };
+const __niceevalExport3 = __niceevalCanonical["normalizeModelRequirements"];
+export { __niceevalExport3 as normalizeModelRequirements };
+const __niceevalExport4 = __niceevalCanonical["normalizeModelRoles"];
+export { __niceevalExport4 as normalizeModelRoles };
+//# sourceMappingURL=model-roles.js.map

package/dist/model-roles.js.map

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

package/dist/o11y/adapter-usage-projection.cjs

@@ -14,7 +14,8 @@ function effectiveUsageCalls(usage) {
     const receipts = new Map((usage.priceReceipts ?? []).map((receipt) => [receipt.callId, receipt]));
     return Object.freeze(usage.calls.map((call) => {
         const receipt = receipts.get(call.callId);
-        return Object.freeze({ ...call, effectiveCost: call.cost !== null ? Object.freeze({ ...call.cost, state: "complete" }) : receipt === undefined ? null : Object.freeze({ amount: receipt.amount, currency: receipt.currency, source: receipt.source, state: receipt.state }) });
+        const { modelSlot, ...fields } = call;
+        return Object.freeze({ ...fields, modelRole: modelSlot, effectiveCost: call.cost !== null ? Object.freeze({ ...call.cost, state: "complete" }) : receipt === undefined ? null : Object.freeze({ amount: receipt.amount, currency: receipt.currency, source: receipt.source, state: receipt.state }) });
     }));
 }
 function effectiveCostTotals(calls, collectionState) {
@@ -73,7 +74,7 @@ function adapterInspectionTokenTotal(usage, metric) {
 }
 /** Tuple order is stable across hosts, with missing identities before strings. */
 function compareAdapterModelGroups(left, right) {
-    for (const key of ["modelSlot", "provider", "model"]) {
+    for (const key of ["modelRole", "provider", "model"]) {
         const a = left[key];
         const b = right[key];
         if (a === b)
@@ -98,9 +99,9 @@ function projectAdapterModelUsage(usage, models, unavailable = { basis: "unavail
         ? Object.freeze({ state: "not-recorded" })
         : Object.freeze({
             state: "available",
-            bindings: Object.freeze(Object.keys(models).sort().map((modelSlot) => Object.freeze({
-                modelSlot, ...models[modelSlot],
-                recordedCalls: usage === null ? null : counts.get(modelSlot) ?? 0,
+            bindings: Object.freeze(Object.keys(models).sort().map((modelRole) => Object.freeze({
+                modelRole, ...models[modelRole],
+                recordedCalls: usage === null ? null : counts.get(modelRole) ?? 0,
             }))),
         });
     if (usage === null)
@@ -115,7 +116,7 @@ function projectAdapterModelUsage(usage, models, unavailable = { basis: "unavail
         });
     const grouped = new Map();
     for (const call of effectiveUsageCalls(usage)) {
-        const identity = JSON.stringify([call.modelSlot, call.provider, call.model]);
+        const identity = JSON.stringify([call.modelRole, call.provider, call.model]);
         const group = grouped.get(identity);
         if (group === undefined)
             grouped.set(identity, [call]);
@@ -124,10 +125,10 @@ function projectAdapterModelUsage(usage, models, unavailable = { basis: "unavail
     }
     const allGroups = [...grouped.values()].sort((left, right) => compareAdapterModelGroups(left[0], right[0]));
     const groups = allGroups.slice(0, 64).map((calls) => {
-        const { modelSlot, provider, model } = calls[0];
+        const { modelRole, provider, model } = calls[0];
         const groupUsage = { ...usage, calls };
         return Object.freeze({
-            modelSlot, provider, model, recordedCalls: calls.length,
+            modelRole, provider, model, recordedCalls: calls.length,
             tokens: Object.freeze({
                 inputTotalTokens: adapterInspectionTokenTotal(groupUsage, "inputTotalTokens"),
                 outputTokens: adapterInspectionTokenTotal(groupUsage, "outputTokens"),