niceeval 0.17.1 → 0.19.0

package/INDEX.md

@@ -57,14 +57,14 @@
 - `docs-site/zh/tutorials/docker-in-docker.mdx` — 让 Sandbox 使用 Docker:根据任务信任边界选择 Docker socket、raw privileged DinD 或受管 rootless DinD，并为 Agent 准备 Docker CLI 与 daemon。
 - `docs-site/zh/tutorials/eval-groups.mdx` — 用评估组让相关评估共用 Sandbox:几组评估各自需要一套很重的工具链时，用 defineEvalGroup 把它们分组：同组共用一台 Sandbox 依次执行，不同组照常并行。
 - `docs-site/zh/tutorials/evaluation-kinds.mdx` — 按完成度给分：通过制与计分制:任务只有做到和没做到两种结果时用 defineEval 读通过率；有部分进展时用 defineScoreEval 按完成的步骤累计分数。
-- `docs-site/zh/tutorials/experiment-services.mdx` — 启动实验共享服务:用 Experiment 的 setup / teardown 启停整个实验共用的隧道、mock server 或租约，把运行时地址交给 Agent 和 Sandbox，又不让它作废已有结果。
+- `docs-site/zh/tutorials/experiment-services.mdx` — 启动实验共享服务:用 Experiment 的 before / after 启停整个实验共用的隧道、mock server 或租约，把运行时地址交给 Agent 和 Sandbox，又不让它作废已有结果。
 - `docs-site/zh/tutorials/fixtures.mdx` — 给 Coding Agent 准备任务：工作区、提示和验收:在评估用例里把一个真实项目放进 Sandbox，给 Coding Agent 发任务，再用文件内容、命令结果、diff 和 Judge 检查它做得对不对。
 - `docs-site/zh/tutorials/handle-execution-failures.mdx` — 凭据失效或服务挂掉时，及时止损:了解 NiceEval 会自动重试哪些失败；发现凭据失效、共享服务断开这类注定失败的故障时，停止剩下的 Attempt，修好后只补跑没完成的部分。
 - `docs-site/zh/tutorials/install-custom-sandbox-agent.mdx` — 为自定义 Sandbox Agent 安装 CLI:用 ensure 和 installer 检查、安装并复检自定义 coding-agent CLI 的精确版本。
 - `docs-site/zh/tutorials/niceeval-taste-application.mdx` — 自定义应用的评估判据：业务事实、领域 Match 与普通计算:被测应用提供客服记录、游戏状态这类业务事实时，让 Adapter 交付事实，用领域 Match 组合小条件，在正文里写普通计算，并保留未知状态。
 - `docs-site/zh/tutorials/niceeval-taste.mdx` — NiceEval Taste：写出一眼能看懂判据的评估:让同事只读评估用例正文，就能说出它测什么、什么算通过、证据为什么够。用已有事实、简单条件和普通算术写判据，少造新概念。
 - `docs-site/zh/tutorials/nixos-managed-dind.mdx` — 在 NixOS 上配置 Managed DinD:使用 NiceEval 的 NixOS module 部署 managed rootless Docker profile，并通过 doctor 验证宿主环境。
-- `docs-site/zh/tutorials/plugins.mdx` — 用 Plugin 复用一整套运行条件:同一套“先在宿主机起服务、再在 Sandbox 里准备环境”的条件要在多个 Experiment、评估组或评估用例里用时，用 definePlugin 写一次，到处挂载。
+- `docs-site/zh/tutorials/plugins.mdx` — 用 Plugin 复用运行条件:把 Agent 扩展、Sandbox 步骤与宿主生命周期装进一个可复用的实验条件。
 - `docs-site/zh/tutorials/prebuilt-sandbox.mdx` — 预制 Sandbox 环境：让每次评估更快开始:把系统包、Agent CLI 和大缓存做进 Docker 镜像、Vercel 快照或 E2B template，从官方基线派生；运行时缓存用 checkpoint 在 Attempt 之间延续。
 - `docs-site/zh/tutorials/quickstart.mdx` — 快速开始：跑通第一条评估用例:安装 NiceEval，写一个 Adapter、一个 Experiment 和一条评估用例，十分钟左右对你自己的应用跑通第一条评估，并在终端和浏览器里看到结果。
 - `docs-site/zh/tutorials/reporters.mdx` — 把运行结果上报给 Braintrust 等外部系统:团队已经在用 Braintrust 或自己的看板时，用 Reporter 在运行过程中把结果发过去；CI 平台用 JUnit；后续脚本用 receipt 里的 Run ID 读取结果。
@@ -73,6 +73,9 @@
 - `docs-site/zh/tutorials/sandbox-providers.mdx` — 选择并配置 Sandbox：Docker、Vercel 或 E2B:给 Coding Agent 选一个隔离运行环境：本地 Docker、Vercel 或 E2B。按顺序准备环境，并用预制镜像和缓存让每次评估更快开始。
 - `docs-site/zh/tutorials/sandbox-reuse.mdx` — 在一批评估中复用 Sandbox:每条 Attempt 都新建 Sandbox 太慢时，用 sandboxReuse 让一批 Attempt 依次共用同一个 Sandbox。说明它省了什么、留下了什么，以及准备代码要怎么写才能安全重放。
 - `docs-site/zh/tutorials/select-and-preview.mdx` — 运行前确认跑哪些、跑几次:列出有哪些 Experiment，用 ID 前缀和 tag 缩小范围，再用 --dry 看清这次会跑哪些评估用例、多少次，确认无误再花钱。
+- `docs-site/zh/tutorials/upgrade-0-18.mdx` — 升级到 0.18:共享模型用途、原生数值材料与公开入口调整
+- `docs-site/zh/tutorials/upgrade-0-19.mdx` — 升级到 0.19:替换模型用途名称，迁移撤销的作者配置。
+- `docs-site/zh/tutorials/upgrade-0-20.mdx` — 升级到 0.20:更新配置与固定版本协议。
 - `docs-site/zh/tutorials/verify-judge.mdx` — 配置 Judge，并确认它真的能打分:给裁判模型 Judge 选好 Provider、模型和 API Key，再用一条最小评估跑一次真实判分，确认配置无误后再大批使用。
 - `docs-site/zh/tutorials/viewing-results.mdx` — 查看运行结果：从总览找到失败原因:跑完评估后，用 niceeval show 在终端从总览逐层找到失败的那次运行，查看对话、耗时、用量和文件改动；在浏览器用 view 翻看；脚本和 CI 用 query 读 JSON。
 - `docs-site/zh/tutorials/write-experiment.mdx` — 编写实验：比较模型、prompt 和 Agent:用 defineExperiment 固定被测 Agent、模型、flags 和运行次数。同一批评估用例写两份只差一个变量的 Experiment，就能比较两个模型或两版 prompt。

package/dist/adapter-usage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-usage.js","sourceRoot":"","sources":["adapter-usage.ts"],"names":[],"mappings":"","sourcesContent":["/** Producer declaration after all obtainable final request snapshots have been recorded. */\nexport type AdapterUsageSeal = {\n    readonly state: \"complete\";\n} | {\n    readonly state: \"partial\";\n    readonly reason: string;\n};\n/** Final observation of one physical external request, scoped to an Adapter Attempt. */\nexport interface AdapterUsageInput {\n    readonly callId: string;\n    readonly retryOf?: string;\n    /** Frozen application model purpose; omission records an unknown purpose. */\n    readonly modelSlot?: string | null;\n    /** Upstream-proven serving provider. Transport and protocol identities belong in route. */\n    readonly provider: string | null;\n    readonly model: string | null;\n    readonly route?: {\n        readonly transportProvider: string | null;\n        /** Stable, non-secret endpoint identity. Never include URLs, account identifiers, or credentials. */\n        readonly endpointId: string | null;\n    };\n    readonly status: \"succeeded\" | \"failed\" | \"cancelled\" | \"unknown\";\n    /** Input tokens excluding the cache read and cache write buckets. */\n    readonly inputTokens: number | null;\n    /** Independently observed input total including cache buckets; never added to those buckets. */\n    readonly inputTotalTokens?: number | null;\n    readonly outputTokens: number | null;\n    readonly cacheReadTokens?: number | null;\n    readonly cacheWriteTokens?: number | null;\n    /** One provider-reported effective cost. A reported zero remains preferred to estimates. */\n    readonly cost?: {\n        readonly amount: string;\n        readonly currency: string;\n        readonly source: {\n            readonly kind: \"reported\";\n            readonly id: string;\n        };\n    };\n}\n"]}
+{"version":3,"file":"adapter-usage.js","sourceRoot":"","sources":["adapter-usage.ts"],"names":[],"mappings":"","sourcesContent":["/** Producer declaration after all obtainable final request snapshots have been recorded. */\nexport type AdapterUsageSeal = {\n    readonly state: \"complete\";\n} | {\n    readonly state: \"partial\";\n    readonly reason: string;\n};\n/** Final observation of one physical external request, scoped to an Adapter Attempt. */\nexport interface AdapterUsageInput {\n    readonly callId: string;\n    readonly retryOf?: string;\n    /** Frozen application model purpose; omission records an unknown purpose. */\n    readonly modelRole?: string | null;\n    /** Upstream-proven serving provider. Transport and protocol identities belong in route. */\n    readonly provider: string | null;\n    readonly model: string | null;\n    readonly route?: {\n        readonly transportProvider: string | null;\n        /** Stable, non-secret endpoint identity. Never include URLs, account identifiers, or credentials. */\n        readonly endpointId: string | null;\n    };\n    readonly status: \"succeeded\" | \"failed\" | \"cancelled\" | \"unknown\";\n    /** Input tokens excluding the cache read and cache write buckets. */\n    readonly inputTokens: number | null;\n    /** Independently observed input total including cache buckets; never added to those buckets. */\n    readonly inputTotalTokens?: number | null;\n    readonly outputTokens: number | null;\n    readonly cacheReadTokens?: number | null;\n    readonly cacheWriteTokens?: number | null;\n    /** One provider-reported effective cost. A reported zero remains preferred to estimates. */\n    readonly cost?: {\n        readonly amount: string;\n        readonly currency: string;\n        readonly source: {\n            readonly kind: \"reported\";\n            readonly id: string;\n        };\n    };\n}\n"]}

package/dist/adapter-usage.d.cts

@@ -10,7 +10,7 @@ export interface AdapterUsageInput {
     readonly callId: string;
     readonly retryOf?: string;
     /** Frozen application model purpose; omission records an unknown purpose. */
-    readonly modelSlot?: string | null;
+    readonly modelRole?: string | null;
     /** Upstream-proven serving provider. Transport and protocol identities belong in route. */
     readonly provider: string | null;
     readonly model: string | null;

package/dist/adapter-usage.d.mts

@@ -10,7 +10,7 @@ export interface AdapterUsageInput {
     readonly callId: string;
     readonly retryOf?: string;
     /** Frozen application model purpose; omission records an unknown purpose. */
-    readonly modelSlot?: string | null;
+    readonly modelRole?: string | null;
     /** Upstream-proven serving provider. Transport and protocol identities belong in route. */
     readonly provider: string | null;
     readonly model: string | null;

package/dist/adapter-usage.d.ts

@@ -10,7 +10,7 @@ export interface AdapterUsageInput {
     readonly callId: string;
     readonly retryOf?: string;
     /** Frozen application model purpose; omission records an unknown purpose. */
-    readonly modelSlot?: string | null;
+    readonly modelRole?: string | null;
     /** Upstream-proven serving provider. Transport and protocol identities belong in route. */
     readonly provider: string | null;
     readonly model: string | null;

package/dist/adapter.cjs

@@ -6,6 +6,7 @@ exports.adapterIdentity = adapterIdentity;
 exports.adapterAcceptsEval = adapterAcceptsEval;
 exports.adapterContractRequiredByEval = adapterContractRequiredByEval;
 exports.bindAdapterEvalContext = bindAdapterEvalContext;
+const model_roles_ts_1 = require("./model-roles.cjs");
 const adapter_cleanup_ts_1 = require("./shared/adapter-cleanup.cjs");
 const runtime_ts_1 = require("./assertions/runtime.cjs");
 const adapter_flags_ts_1 = require("./adapter-flags.cjs");
@@ -28,6 +29,7 @@ const RESERVED_ADAPTER_CONTEXT_KEYS = [
     "maxCost",
     "score",
     "group",
+    "note",
     "skip",
     "signal",
     "model",
@@ -79,12 +81,14 @@ function boundEvalFactories(token) {
             assertAdapterEvalInput(input, "defineEval");
             return (0, define_ts_1.defineEvalForContext)("pass", input, {
                 [EVAL_ADAPTER_CONTRACT_TOKEN]: token,
+                requiredModelRoles: (0, model_roles_ts_1.normalizeModelRequirements)(input.requires),
             });
         },
         defineScoreEval(input) {
             assertAdapterEvalInput(input, "defineScoreEval");
             return (0, define_ts_1.defineEvalForContext)("score", input, {
                 [EVAL_ADAPTER_CONTRACT_TOKEN]: token,
+                requiredModelRoles: (0, model_roles_ts_1.normalizeModelRequirements)(input.requires),
             });
         },
     };
@@ -113,6 +117,7 @@ function implementAdapter(token, input, factory) {
     };
     return Object.freeze({
         kind: "custom",
+        requiredModelRoles: (0, model_roles_ts_1.normalizeModelRequirements)(input.requires),
         parseFlags: token.parseFlags,
         name: input.name,
         contract: token.name,
@@ -123,7 +128,7 @@ function implementAdapter(token, input, factory) {
         ...boundEvalFactories(token),
     });
 }
-// @concord-code ne-adapter-define-adapter
+// @concord-code
 // @concord-implements docs/feature/adapters/README.md
 // @concord-implements docs/feature/adapters/library/writing-an-adapter.md
 function defineAdapter(input) {
@@ -136,7 +141,7 @@ function defineAdapter(input) {
     return implementAdapter(contractToken(input.name, assertions, input.parseFlags), input, "defineAdapter");
 }
 /** Defines a reusable contract whose implementations and Evals share one runtime-only token. */
-// @concord-code ne-adapter-define-contract
+// @concord-code
 // @concord-implements docs/feature/adapters/README.md
 // @concord-implements docs/feature/adapters/architecture/agent-contract.md
 function defineAdapterContract(input) {
@@ -349,7 +354,7 @@ function bindAdapterAssertions(core, context, factory, assertAuthorOpen) {
     return Object.freeze({ app, assertions: Object.freeze(assertions) });
 }
 /** @internal Builds the frozen single-t facade after create settles. */
-// @concord-code ne-adapter-bind-eval-context
+// @concord-code
 // @concord-implements docs/feature/adapters/architecture/agent-contract.md
 function bindAdapterEvalContext(core, context, adapter, assertAuthorOpen) {
     assertPlainAdapterContext(context);

package/dist/adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ResolvedModelSlots } from \"./model-slots.ts\";\nimport { resolveAdapterCleanupTimeoutMs } from \"./shared/adapter-cleanup.ts\";\nimport type { AttemptSignal } from \"./shared/attempt-lifecycle.ts\";\nexport type { AttemptCancellation, AttemptSignal } from \"./shared/attempt-lifecycle.ts\";\nimport { bindAssertionContext } from \"./assertions/runtime.ts\";\nimport type { MatchContext } from \"./assertions/context-match.ts\";\nimport type { EvalUsage } from \"./o11y/eval-usage.ts\";\nimport type { ExperimentFlags } from \"./shared/types.ts\";\nimport { assertAdapterFlagsParser, type AdapterFlagsParser, type AdapterFlagsOutput, type AdapterFlagsParserValidation, type AdapterFlagsParserValidationArgs, } from \"./adapter-flags.ts\";\nimport type { AssertionCheck, AssertionSubject, AssertionsRuntime, BooleanAssertionHandle, MeasurementAssertionHandle, PolymorphicBooleanAssertionHandle, PolymorphicMeasurementAssertionHandle, } from \"./assertions/api.ts\";\nimport type { ScoreMatch } from \"./assertions/match.ts\";\nimport { defineEvalForContext } from \"./define.ts\";\nimport type { EvalDefinition, EvalInput, ScoreEvalInput } from \"./runner/types.ts\";\nimport type { EvaluationKind } from \"./shared/evaluation.ts\";\nimport type { JudgePresetMethods } from \"./context/assert-first.ts\";\nimport type { DiagnosticInput, ProgressUpdate } from \"./shared/types.ts\";\nimport type { AdapterIdentity } from \"./record/model/run-context.ts\";\nexport type { AdapterIdentity } from \"./record/model/run-context.ts\";\nconst ADAPTER_CONTRACT_TOKEN: unique symbol = Symbol(\"niceeval.adapterContractToken\");\nconst EVAL_ADAPTER_CONTRACT_TOKEN: unique symbol = Symbol(\"niceeval.evalAdapterContractToken\");\n/**\n * Synchronously assembles Attempt-local Assertion methods from the guarded app\n * facade and the shared check registrar. The returned object must contain only\n * ordinary, synchronously returning methods. Generic and overloaded Assertion\n * sugar is intentionally not callable after binding; use ordinary named\n * parameters so argument and native handle types remain exact.\n */\nexport type AdapterAssertionsFactory<Context extends object, Assertions extends object = object> = (context: AdapterAssertionsFactoryContext<Context>) => Assertions;\n/**\n * Definition inputs for Adapter Assertion sugar. `app` becomes callable after\n * assembly, and `check` may only be called by a returned Assertion method.\n */\nexport interface AdapterAssertionsFactoryContext<Context extends object> {\n    readonly app: MatchContext<Context>;\n    readonly check: AssertionCheck<\"polymorphic\", Context>;\n}\ntype BoundAdapterAssertionResult<Kind extends EvaluationKind, Result> = Result extends PolymorphicBooleanAssertionHandle<infer Refined, infer HasGate> ? BooleanAssertionHandle<Kind, Refined, HasGate> : Result extends PolymorphicMeasurementAssertionHandle<infer HasCondition> ? MeasurementAssertionHandle<Kind, HasCondition> : never;\ntype BoundAdapterAssertionMethod<Kind extends EvaluationKind, Method> = Method extends (...args: infer Args) => infer Result ? ((...args: Args) => Result) extends Method ? (...args: Args) => BoundAdapterAssertionResult<Kind, Result> : never : never;\ntype AdapterAssertionsFor<Assertions extends object | undefined, Kind extends EvaluationKind> = Assertions extends object ? {\n    readonly [Key in keyof Assertions]: BoundAdapterAssertionMethod<Kind, Assertions[Key]>;\n} : {};\n/** Keys owned by the neutral Eval runtime or unsafe on a merged object root. */\nconst RESERVED_ADAPTER_CONTEXT_KEYS = [\n    \"evaluationKind\",\n    \"check\",\n    \"judge\",\n    \"factuality\",\n    \"faithfulness\",\n    \"instructionFollowing\",\n    \"pairwisePreference\",\n    \"closeQA\",\n    \"usage\",\n    \"elapsedMs\",\n    \"maxTokens\",\n    \"maxCost\",\n    \"score\",\n    \"group\",\n    \"skip\",\n    \"signal\",\n    \"model\",\n    \"reasoningEffort\",\n    \"flags\",\n    \"progress\",\n    \"diagnostic\",\n    \"log\",\n    \"then\",\n    \"Object\",\n    \"constructor\",\n    \"__defineGetter__\",\n    \"__defineSetter__\",\n    \"hasOwnProperty\",\n    \"__lookupGetter__\",\n    \"__lookupSetter__\",\n    \"isPrototypeOf\",\n    \"propertyIsEnumerable\",\n    \"toString\",\n    \"valueOf\",\n    \"__proto__\",\n    \"toLocaleString\",\n] as const;\nexport type ReservedAdapterContextKey = typeof RESERVED_ADAPTER_CONTEXT_KEYS[number];\ntype InvalidContextBranch<Context> = Context extends unknown ? Context extends object ? Context extends readonly unknown[] ? Context : Context extends (...args: readonly never[]) => unknown ? Context : string extends keyof Context ? Context : Extract<keyof Context, ReservedAdapterContextKey> extends never ? never : Context : Context : never;\ntype AdapterContextValidation<Context> = unknown extends Context ? unknown : [\n    InvalidContextBranch<Context>\n] extends [\n    never\n] ? unknown : {\n    readonly invalidAdapterContext: InvalidContextBranch<Context>;\n};\ntype InvalidAssertionMethodKey<Context extends object, Assertions> = Assertions extends object ? {\n    [Key in keyof Assertions]: Key extends string ? Key extends ReservedAdapterContextKey | keyof Context ? Key : Assertions[Key] extends (...args: readonly never[]) => infer Result ? Result extends PolymorphicBooleanAssertionHandle<unknown, boolean> | PolymorphicMeasurementAssertionHandle<boolean> ? never : Key : Key : Key;\n}[keyof Assertions] : \"assertions\";\ntype InvalidAdapterAssertions<Context extends object, Assertions extends object> = InvalidAssertionMethodKey<Context, Assertions>;\ntype AdapterAssertionsValidation<Context extends object, Assertions extends object> = [\n    InvalidAdapterAssertions<Context, Assertions>\n] extends [\n    never\n] ? unknown : {\n    readonly invalidAdapterAssertions: InvalidAdapterAssertions<Context, Assertions>;\n};\ntype AdapterAssertionsValidationArgs<Context extends object, Assertions extends object> = [\n    InvalidAdapterAssertions<Context, Assertions>\n] extends [\n    never\n] ? [\n] : [\n    error: {\n        readonly invalidAdapterAssertions: InvalidAdapterAssertions<Context, Assertions>;\n    }\n];\ntype AdapterFactory<Context extends object, Flags extends AdapterFlagsParser = undefined> = (context: AdapterCreateContext<AdapterFlagsOutput<Flags>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;\nexport interface AdapterCleanupContext {\n    /** 整个清理窗口的固定毫秒预算，不为每个回调续期。 */\n    readonly timeoutMs: number;\n    /** 清理窗口实际开始时确定的 Unix 毫秒截止时间。 */\n    readonly deadlineAt: number;\n    /** 独立于执行信号；整个 Adapter 清理窗口截止时中止。 */\n    readonly signal: AbortSignal;\n}\nexport interface AdapterCreateContext<Flags = ExperimentFlags> {\n    /** Frozen application model selections for this Attempt. */\n    readonly models: ResolvedModelSlots;\n    recordUsage(input: import(\"./adapter-usage.ts\").AdapterUsageInput): void;\n    /** Close application usage admission and declare whether the recorded collection is complete. */\n    sealUsage(input: import(\"./adapter-usage.ts\").AdapterUsageSeal): void;\n    attach(input: import(\"./adapter-attachments.ts\").AdapterAttachmentInput): Promise<import(\"./adapter-attachments.ts\").AdapterAttachmentReceipt>;\n    recordTrace<Event extends import(\"./adapter-execution-trace.ts\").ExecutionTraceEvent>(input: import(\"./adapter-execution-trace.ts\").ExecutionTraceInput<Event>): Promise<import(\"./adapter-execution-trace.ts\").ExecutionTraceReceipt>;\n    /** 当前 Eval 的公开 ID。 */\n    readonly evalId: string;\n    /** 当前 Experiment 的公开 ID。 */\n    readonly experimentId: string;\n    /** 当前 Attempt 的零起始序号。 */\n    readonly attempt: number;\n    /** Attempt 执行信号；reason 区分 timeout 与 cancelled，不用于 cleanup 窗口。 */\n    readonly signal: AttemptSignal;\n    /** Experiment 选择的模型。 */\n    readonly model?: string;\n    /** Experiment 选择的推理强度。 */\n    readonly reasoningEffort?: string;\n    /** Experiment 传给 Adapter 的只读 flags。 */\n    readonly flags: Flags;\n    /** 更新当前 Attempt 的人读进度。 */\n    progress(update: ProgressUpdate): void;\n    /** 为当前 Attempt 追加结构化诊断。 */\n    diagnostic(input: DiagnosticInput): void;\n    /** 为当前 Attempt 追加日志。 */\n    log(message: string): void;\n    /**\n     * 登记 Attempt-local 资源释放。回调按全局 LIFO 执行；一项失败不会跳过其余项。\n     * 零参数回调仍可直接传入。传入的 context 已冻结，同一 cleanup 窗口的回调共享一个 signal。\n     */\n    onCleanup(cleanup: (context: AdapterCleanupContext) => void | Promise<void>): void;\n}\ntype EvalContextBase<Kind extends EvaluationKind, Flags, Context> = JudgePresetMethods<Kind, Context> & {\n    readonly usage: EvalUsage;\n    readonly elapsedMs: import(\"./assertions/match.ts\").NumericMaterial;\n    maxTokens(max: number): BooleanAssertionHandle<Kind, number>;\n    maxCost(usd: number | string): BooleanAssertionHandle<Kind, string>;\n    readonly evaluationKind: Kind;\n    readonly signal: AbortSignal;\n    readonly model?: string;\n    readonly reasoningEffort?: string;\n    readonly flags: Flags;\n    progress(update: ProgressUpdate): void;\n    diagnostic(input: DiagnosticInput): void;\n    log(message: string): void;\n    skip(reason: string): never;\n    group<Value>(title: string, body: () => Value | PromiseLike<Value>): Promise<Awaited<Value>>;\n    readonly check: AssertionCheck<Kind, Context>;\n    readonly judge: <Value>(value: AssertionSubject<Value>, definition: ScoreMatch<NoInfer<Value>>) => MeasurementAssertionHandle<Kind>;\n};\n/** Agent-neutral author context shared by every Adapter Eval. */\nexport type EvalContext<Kind extends EvaluationKind = \"pass\", Flags = ExperimentFlags, Context = unknown> = EvalContextBase<Kind, Flags, Context> & (Kind extends \"score\" ? {\n    readonly score: AssertionsRuntime<\"score\">[\"t\"][\"score\"];\n} : {});\ntype AdapterEvalFields = Omit<EvalInput<undefined>, \"test\" | \"sandbox\" | \"diff\"> & {\n    readonly sandbox?: never;\n    readonly diff?: never;\n};\ntype AdapterScoreEvalFields = Omit<ScoreEvalInput<undefined>, \"test\" | \"sandbox\" | \"diff\"> & {\n    readonly sandbox?: never;\n    readonly diff?: never;\n};\nexport type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterEvalFields & {\n    test(t: EvalContext<\"pass\", AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, \"pass\">): void | Promise<void>;\n};\nexport type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterScoreEvalFields & {\n    test(t: EvalContext<\"score\", AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, \"score\">): void | Promise<void>;\n};\ninterface AdapterContractToken<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser = undefined> {\n    readonly name: string;\n    readonly assertions: AdapterAssertionsFactory<Context> | undefined;\n    readonly parseFlags: Flags;\n    /** Keeps the Assertion method shape invariant without exposing a constructible brand. */\n    readonly assertionTypes: (value: Assertions) => Assertions;\n    /** Keeps the context parameter invariant without exposing a constructible brand. */\n    readonly context: (value: Context) => Context;\n}\nexport interface AdapterEvalDefinition<Kind extends EvaluationKind, Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends EvalDefinition<Kind, EvalContext<Kind, AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, Kind>, undefined> {\n    readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions, Flags>;\n}\n/** @internal Existential discovery view; concrete bound factories retain their exact Context. */\nexport interface AdapterRuntimeEvalDefinition<Kind extends EvaluationKind> extends EvalDefinition<Kind, never, undefined> {\n    readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: object;\n}\n/** Common public surface for an Adapter definition with bound Eval factories. */\nexport interface AdapterDefinition<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> {\n    readonly name: string;\n    readonly parseFlags: Flags;\n    defineEval(input: AdapterEvalInput<Context, Assertions, Flags>): AdapterEvalDefinition<\"pass\", Context, Assertions, Flags>;\n    defineScoreEval(input: AdapterScoreEvalInput<Context, Assertions, Flags>): AdapterEvalDefinition<\"score\", Context, Assertions, Flags>;\n}\n/** Existential runtime view used by Experiment without erasing a concrete context to `any`. */\nexport interface AdapterRuntimeDefinition {\n    readonly parseFlags?: Exclude<AdapterFlagsParser, undefined>;\n    readonly kind: \"custom\";\n    readonly name: string;\n    readonly contract: string;\n    readonly behaviorRevision: string | null;\n    readonly cleanupTimeoutMs: number;\n    readonly [ADAPTER_CONTRACT_TOKEN]: object;\n    readonly defineEval: (...args: never[]) => unknown;\n    readonly defineScoreEval: (...args: never[]) => unknown;\n    create(context: AdapterCreateContext<unknown>): object | Promise<object>;\n}\nexport interface AdapterImplementation<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends AdapterDefinition<Context, Assertions, Flags> {\n    readonly kind: \"custom\";\n    readonly contract: string;\n    readonly behaviorRevision: string | null;\n    readonly cleanupTimeoutMs: number;\n    readonly [ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions, Flags>;\n    create(context: AdapterCreateContext<AdapterFlagsOutput<Flags>>): Context | Promise<Context>;\n}\nexport type AdapterImplementationInput<Context extends object, ImplementationContext extends Context = Context, Flags extends AdapterFlagsParser = undefined> = {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: AdapterFactory<ImplementationContext, Flags>;\n} & AdapterContextValidation<NoInfer<ImplementationContext>>;\nexport interface AdapterContract<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends AdapterDefinition<Context, Assertions, Flags> {\n    readonly name: string;\n    implement<ImplementationContext extends Context>(input: AdapterImplementationInput<Context, ImplementationContext, Flags>): AdapterImplementation<Context, Assertions, Flags>;\n    /**\n     * Returns a contract whose Eval factories and implementations share one flags parser.\n     */\n    withParseFlags<NextFlags extends Exclude<AdapterFlagsParser, undefined>>(parseFlags: NextFlags, ...validation: AdapterFlagsParserValidationArgs<NoInfer<NextFlags>>): AdapterContract<Context, Assertions, NextFlags>;\n    /** Returns a contract whose implementations share this exact Assertion factory. */\n    withAssertions<NextAssertions extends object>(factory: AdapterAssertionsFactory<Context, NextAssertions>, ...validation: AdapterAssertionsValidationArgs<Context, NoInfer<NextAssertions>>): AdapterContract<Context, NextAssertions, Flags>;\n}\nexport type Adapter = import(\"./agents/types.ts\").Agent | AdapterRuntimeDefinition;\nfunction assertNonEmptyString(value: unknown, field: string, factory: string): asserts value is string {\n    if (typeof value !== \"string\" || value.trim() === \"\") {\n        throw new TypeError(`${factory} requires a non-empty ${field}.`);\n    }\n}\nfunction contractToken<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser>(name: string, assertions: AdapterAssertionsFactory<Context> | undefined, parseFlags: Flags): AdapterContractToken<Context, Assertions, Flags> {\n    return Object.freeze({\n        name,\n        assertions,\n        parseFlags,\n        assertionTypes: (value: Assertions) => value,\n        context: (value: Context) => value,\n    });\n}\nfunction assertAdapterEvalInput(value: {\n    readonly sandbox?: unknown;\n    readonly diff?: unknown;\n}, factory: \"defineEval\" | \"defineScoreEval\"): void {\n    if (Object.hasOwn(value, \"sandbox\")) {\n        throw new TypeError(`${factory} for an Adapter does not support sandbox.`);\n    }\n    if (Object.hasOwn(value, \"diff\")) {\n        throw new TypeError(`${factory} for an Adapter does not support Agent workspace diff configuration.`);\n    }\n}\nfunction boundEvalFactories<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser>(token: AdapterContractToken<Context, Assertions, Flags>): Pick<AdapterDefinition<Context, Assertions, Flags>, \"defineEval\" | \"defineScoreEval\"> {\n    return {\n        defineEval(input) {\n            assertAdapterEvalInput(input, \"defineEval\");\n            return defineEvalForContext(\"pass\", input, {\n                [EVAL_ADAPTER_CONTRACT_TOKEN]: token,\n            }) as AdapterEvalDefinition<\"pass\", Context, Assertions, Flags>;\n        },\n        defineScoreEval(input) {\n            assertAdapterEvalInput(input, \"defineScoreEval\");\n            return defineEvalForContext(\"score\", input, {\n                [EVAL_ADAPTER_CONTRACT_TOKEN]: token,\n            }) as AdapterEvalDefinition<\"score\", Context, Assertions, Flags>;\n        },\n    };\n}\nfunction implementAdapter<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser>(token: AdapterContractToken<Context, Assertions, Flags>, input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: AdapterFactory<Context, Flags>;\n}, factory: \"defineAdapter\" | \"AdapterContract.implement\"): AdapterImplementation<Context, Assertions, Flags> {\n    assertNonEmptyString(input.name, \"name\", factory);\n    if (input.behaviorRevision !== undefined) {\n        assertNonEmptyString(input.behaviorRevision, \"behaviorRevision\", factory);\n    }\n    if (typeof input.create !== \"function\") {\n        throw new TypeError(`${factory} requires create(context).`);\n    }\n    const cleanupTimeoutMs = resolveAdapterCleanupTimeoutMs(input.cleanupTimeoutMs);\n    const authorCreate = input.create;\n    const create = (context: AdapterCreateContext<AdapterFlagsOutput<Flags>>): Context | Promise<Context> => {\n        const created = authorCreate(context);\n        if (created instanceof Promise) {\n            return created.then((value) => {\n                assertPlainAdapterContext(value);\n                return value;\n            });\n        }\n        // Validate before a caller can pass a synchronous thenable to Promise adaptation.\n        assertPlainAdapterContext(created);\n        return created;\n    };\n    return Object.freeze({\n        kind: \"custom\" as const,\n        parseFlags: token.parseFlags,\n        name: input.name,\n        contract: token.name,\n        behaviorRevision: input.behaviorRevision ?? null,\n        cleanupTimeoutMs,\n        create,\n        [ADAPTER_CONTRACT_TOKEN]: token,\n        ...boundEvalFactories(token),\n    }) as AdapterImplementation<Context, Assertions, Flags>;\n}\n/** Defines one Adapter implementation with an automatically private contract. */\nexport function defineAdapter<Context extends object, Flags extends AdapterFlagsParser = undefined>(input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: AdapterFactory<Context, Flags>;\n    readonly parseFlags?: Flags;\n    readonly assertions?: undefined;\n} & AdapterContextValidation<NoInfer<Context>> & AdapterFlagsParserValidation<NoInfer<Flags>>): AdapterImplementation<Context, undefined, Flags>;\nexport function defineAdapter<Context extends object, Assertions extends object, Flags extends AdapterFlagsParser = undefined>(input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: AdapterFactory<Context, Flags>;\n    readonly parseFlags?: Flags;\n    /** Attempt-local Assertion sugar, assembled once after create() succeeds. */\n    readonly assertions: AdapterAssertionsFactory<Context, Assertions>;\n} & AdapterContextValidation<NoInfer<Context>> & AdapterFlagsParserValidation<NoInfer<Flags>> & AdapterAssertionsValidation<Context, NoInfer<Assertions>>): AdapterImplementation<Context, Assertions, Flags>;\n// @concord-code ne-adapter-define-adapter\n// @concord-implements docs/feature/adapters/README.md\n// @concord-implements docs/feature/adapters/library/writing-an-adapter.md\nexport function defineAdapter(input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: AdapterFactory<object, AdapterFlagsParser>;\n    readonly parseFlags?: Exclude<AdapterFlagsParser, undefined>;\n    readonly assertions?: AdapterAssertionsFactory<object>;\n}): AdapterRuntimeDefinition {\n    if (input.parseFlags !== undefined)\n        assertAdapterFlagsParser(input.parseFlags);\n    const assertions = input.assertions;\n    if (assertions !== undefined && typeof assertions !== \"function\") {\n        throw new TypeError(\"defineAdapter assertions must be a function.\");\n    }\n    return implementAdapter(contractToken<object, object | undefined, AdapterFlagsParser>(input.name, assertions, input.parseFlags), input, \"defineAdapter\");\n}\n/** Defines a reusable contract whose implementations and Evals share one runtime-only token. */\n// @concord-code ne-adapter-define-contract\n// @concord-implements docs/feature/adapters/README.md\n// @concord-implements docs/feature/adapters/architecture/agent-contract.md\nexport function defineAdapterContract<Context extends object>(input: {\n    readonly name: string;\n} & AdapterContextValidation<NoInfer<Context>>): AdapterContract<Context> {\n    assertNonEmptyString(input.name, \"name\", \"defineAdapterContract\");\n    return makeAdapterContract(contractToken<Context, undefined, undefined>(input.name, undefined, undefined));\n}\nfunction makeAdapterContract<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser>(token: AdapterContractToken<Context, Assertions, Flags>): AdapterContract<Context, Assertions, Flags> {\n    const factories = boundEvalFactories(token);\n    return Object.freeze({\n        name: token.name,\n        parseFlags: token.parseFlags,\n        ...factories,\n        implement<ImplementationContext extends Context>(implementation: AdapterImplementationInput<Context, ImplementationContext, Flags>) {\n            return implementAdapter(token, implementation, \"AdapterContract.implement\");\n        },\n        withParseFlags<NextFlags extends Exclude<AdapterFlagsParser, undefined>>(parseFlags: NextFlags, ..._validation: AdapterFlagsParserValidationArgs<NoInfer<NextFlags>>) {\n            assertAdapterFlagsParser(parseFlags);\n            return makeAdapterContract(contractToken<Context, Assertions, NextFlags>(token.name, token.assertions, parseFlags));\n        },\n        withAssertions<NextAssertions extends object>(factory: AdapterAssertionsFactory<Context, NextAssertions>, ..._validation: AdapterAssertionsValidationArgs<Context, NoInfer<NextAssertions>>) {\n            if (typeof factory !== \"function\") {\n                throw new TypeError(\"AdapterContract.withAssertions requires a function.\");\n            }\n            return makeAdapterContract(contractToken<Context, NextAssertions, Flags>(token.name, factory, token.parseFlags));\n        },\n    });\n}\n/** The single credential-free persistence projection for an Adapter. */\nexport function adapterIdentity(adapter: Adapter): AdapterIdentity {\n    return adapter.kind === \"custom\"\n        ? Object.freeze({\n            name: adapter.name,\n            contract: adapter.contract,\n            behaviorRevision: adapter.behaviorRevision,\n            cleanupTimeoutMs: adapter.cleanupTimeoutMs,\n        })\n        : Object.freeze({\n            name: adapter.name,\n            contract: \"niceeval.agent/v1\",\n            behaviorRevision: null,\n        });\n}\n/** @internal Runtime contract pairing; the token itself never enters persistence. */\nexport function adapterAcceptsEval(adapter: Adapter, definition: object): boolean {\n    const required = (definition as {\n        readonly [EVAL_ADAPTER_CONTRACT_TOKEN]?: unknown;\n    })[EVAL_ADAPTER_CONTRACT_TOKEN];\n    if (adapter.kind === \"custom\") {\n        const provided = adapter[ADAPTER_CONTRACT_TOKEN];\n        return required !== undefined && provided !== undefined && required === provided;\n    }\n    return required === undefined;\n}\n/** @internal Returns the readable contract name without revealing the pairing token. */\nexport function adapterContractRequiredByEval(definition: object): string | undefined {\n    return (definition as {\n        readonly [EVAL_ADAPTER_CONTRACT_TOKEN]?: {\n            readonly name: string;\n        };\n    })[EVAL_ADAPTER_CONTRACT_TOKEN]?.name;\n}\nconst RESERVED_ADAPTER_CONTEXT_KEY_SET: ReadonlySet<string> = new Set(RESERVED_ADAPTER_CONTEXT_KEYS);\nfunction assertPlainAdapterContext(value: unknown): asserts value is object {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n        throw new TypeError(\"Adapter create(context) must return a plain object.\");\n    }\n    const prototype = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) {\n        throw new TypeError(\"Adapter create(context) must return an explicit plain object.\");\n    }\n    for (const key of Reflect.ownKeys(value)) {\n        if (typeof key === \"string\" && RESERVED_ADAPTER_CONTEXT_KEY_SET.has(key)) {\n            throw new TypeError(`Adapter context key ${JSON.stringify(key)} is reserved.`);\n        }\n    }\n}\nfunction forwardProperties(target: object, source: object, guardAccess: boolean, assertAuthorOpen: () => void): void {\n    for (const key of Reflect.ownKeys(source)) {\n        const descriptor = Object.getOwnPropertyDescriptor(source, key);\n        if (descriptor === undefined)\n            continue;\n        if (\"value\" in descriptor && typeof descriptor.value === \"function\") {\n            const method = guardAccess\n                ? function (this: unknown, ...args: readonly unknown[]) {\n                    assertAuthorOpen();\n                    return Reflect.apply(descriptor.value, source, args);\n                }\n                : descriptor.value.bind(source);\n            Object.defineProperty(target, key, {\n                enumerable: true,\n                configurable: false,\n                writable: false,\n                value: method,\n            });\n        }\n        else {\n            Object.defineProperty(target, key, {\n                enumerable: true,\n                configurable: false,\n                get: () => {\n                    if (guardAccess)\n                        assertAuthorOpen();\n                    const value = Reflect.get(source, key, source);\n                    if (typeof value !== \"function\")\n                        return value;\n                    return guardAccess\n                        ? (...args: readonly unknown[]) => {\n                            assertAuthorOpen();\n                            return Reflect.apply(value, source, args);\n                        }\n                        : value.bind(source);\n                },\n            });\n        }\n    }\n}\n/** Observes only branded native Promises without reading an arbitrary `.then` property. */\nfunction observeNativePromiseRejection(value: unknown): boolean {\n    if ((typeof value !== \"object\" && typeof value !== \"function\") || value === null)\n        return false;\n    try {\n        void Reflect.apply(Promise.prototype.then, value, [\n            undefined,\n            () => undefined,\n        ]);\n        return true;\n    }\n    catch {\n        return false;\n    }\n}\nfunction assertPlainAdapterAssertions(value: unknown, context: object): asserts value is object {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n        throw new TypeError(\"Adapter assertions factory must return a plain object of methods.\");\n    }\n    const prototype = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) {\n        observeNativePromiseRejection(value);\n        throw new TypeError(\"Adapter assertions factory must return an explicit plain object.\");\n    }\n    const contextKeys = new Set(Reflect.ownKeys(context));\n    for (const key of Reflect.ownKeys(value)) {\n        if (typeof key !== \"string\") {\n            throw new TypeError(\"Adapter assertion method names must be strings.\");\n        }\n        if (RESERVED_ADAPTER_CONTEXT_KEY_SET.has(key)) {\n            throw new TypeError(`Adapter assertion method name ${JSON.stringify(key)} is reserved.`);\n        }\n        if (contextKeys.has(key)) {\n            throw new TypeError(`Adapter assertion method name ${JSON.stringify(key)} conflicts with an app member.`);\n        }\n        const descriptor = Object.getOwnPropertyDescriptor(value, key);\n        if (descriptor === undefined || !(\"value\" in descriptor) || typeof descriptor.value !== \"function\") {\n            throw new TypeError(`Adapter assertion ${JSON.stringify(key)} must be an own data method.`);\n        }\n    }\n}\nfunction bindAdapterAppContext<Context>(context: Context, assertAppOpen: () => void): Readonly<Context> {\n    const target = Object.create(null) as object;\n    forwardProperties(target, context as object, true, assertAppOpen);\n    return Object.freeze(target) as Readonly<Context>;\n}\nfunction bindAdapterAssertions<Kind extends EvaluationKind, Context extends object>(core: EvalContext<Kind>, context: Context, factory: AdapterAssertionsFactory<Context>, assertAuthorOpen: () => void): {\n    readonly app: Readonly<Context>;\n    readonly assertions: object;\n} {\n    let assembled = false;\n    const assertAppOpen = (): void => {\n        assertAuthorOpen();\n        if (!assembled) {\n            throw new TypeError(\"Adapter assertions factory may only assemble methods; app access starts afterward.\");\n        }\n    };\n    const app = bindAdapterAppContext(context, assertAppOpen);\n    const handleFrames: Array<WeakSet<object>> = [];\n    const check = (...args: readonly unknown[]): unknown => {\n        assertAuthorOpen();\n        const frame = handleFrames.at(-1);\n        if (frame === undefined) {\n            throw new TypeError(\"Adapter assertions factory may call check only from an assertion method.\");\n        }\n        const handle = Reflect.apply(core.check, undefined, args);\n        if ((typeof handle !== \"object\" && typeof handle !== \"function\") || handle === null) {\n            throw new TypeError(\"Adapter assertion check did not return an AssertionHandle.\");\n        }\n        frame.add(handle);\n        return handle;\n    };\n    const authored = factory({ app: app as MatchContext<Context>, check: check as AssertionCheck<\"polymorphic\", Context> });\n    assertPlainAdapterAssertions(authored, context);\n    Object.freeze(authored);\n    assembled = true;\n    const assertions = Object.create(null) as object;\n    for (const key of Reflect.ownKeys(authored)) {\n        const descriptor = Object.getOwnPropertyDescriptor(authored, key)!;\n        const method = descriptor.value as (...args: readonly unknown[]) => unknown;\n        Object.defineProperty(assertions, key, {\n            enumerable: true,\n            configurable: false,\n            writable: false,\n            value: (...args: readonly unknown[]) => {\n                assertAuthorOpen();\n                const frame = new WeakSet<object>();\n                handleFrames.push(frame);\n                try {\n                    const handle = Reflect.apply(method, authored, args);\n                    if ((typeof handle !== \"object\" && typeof handle !== \"function\") || handle === null || !frame.has(handle)) {\n                        observeNativePromiseRejection(handle);\n                        throw new TypeError(`Adapter assertion ${JSON.stringify(key)} must synchronously return its own check() handle.`);\n                    }\n                    return handle;\n                }\n                finally {\n                    handleFrames.pop();\n                }\n            },\n        });\n    }\n    return Object.freeze({ app, assertions: Object.freeze(assertions) });\n}\n/** @internal Builds the frozen single-t facade after create settles. */\n// @concord-code ne-adapter-bind-eval-context\n// @concord-implements docs/feature/adapters/architecture/agent-contract.md\nexport function bindAdapterEvalContext<Kind extends EvaluationKind, Context>(core: EvalContext<Kind>, context: Context, adapter: AdapterRuntimeDefinition, assertAuthorOpen: () => void): EvalContext<Kind> & Readonly<Context> {\n    assertPlainAdapterContext(context);\n    const token = adapter[ADAPTER_CONTRACT_TOKEN] as AdapterContractToken<Context & object, object | undefined>;\n    let app: Readonly<Context>;\n    let assertions: object | undefined;\n    if (token.assertions === undefined) {\n        app = bindAdapterAppContext(context, assertAuthorOpen);\n    }\n    else {\n        const bound = bindAdapterAssertions(core, context, token.assertions, assertAuthorOpen);\n        app = bound.app;\n        assertions = bound.assertions;\n    }\n    bindAssertionContext(core.check, () => app);\n    const target = Object.create(null) as object;\n    forwardProperties(target, core, false, assertAuthorOpen);\n    forwardProperties(target, app, false, assertAuthorOpen);\n    if (assertions !== undefined)\n        forwardProperties(target, assertions, false, assertAuthorOpen);\n    return Object.freeze(target) as EvalContext<Kind> & Readonly<Context>;\n}\n"]}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import { normalizeModelRequirements, type ModelRequirements, type ResolvedModelRole, type ResolvedModelRoles } from \"./model-roles.ts\";\nimport { resolveAdapterCleanupTimeoutMs } from \"./shared/adapter-cleanup.ts\";\nimport type { AttemptSignal } from \"./shared/attempt-lifecycle.ts\";\nexport type { AttemptCancellation, AttemptSignal } from \"./shared/attempt-lifecycle.ts\";\nimport { bindAssertionContext } from \"./assertions/runtime.ts\";\nimport type { MatchContext } from \"./assertions/context-match.ts\";\nimport type { EvalUsage } from \"./o11y/eval-usage.ts\";\nimport type { ExperimentFlags } from \"./shared/types.ts\";\nimport { assertAdapterFlagsParser, type AdapterFlagsParser, type AdapterFlagsOutput, type AdapterFlagsParserValidation, type AdapterFlagsParserValidationArgs, } from \"./adapter-flags.ts\";\nimport type { AssertionCheck, AssertionSubject, AssertionsRuntime, BooleanAssertionHandle, MeasurementAssertionHandle, PolymorphicBooleanAssertionHandle, PolymorphicMeasurementAssertionHandle, } from \"./assertions/api.ts\";\nimport type { ScoreMatch } from \"./assertions/match.ts\";\nimport { defineEvalForContext } from \"./define.ts\";\nimport type { EvalDefinition, EvalInput, ScoreEvalInput } from \"./runner/types.ts\";\nimport type { EvaluationKind } from \"./shared/evaluation.ts\";\nimport type { JudgePresetMethods } from \"./context/assert-first.ts\";\nimport type { DiagnosticInput, ProgressUpdate } from \"./shared/types.ts\";\nimport type { AdapterIdentity } from \"./record/model/run-context.ts\";\nexport type { AdapterIdentity } from \"./record/model/run-context.ts\";\nconst ADAPTER_CONTRACT_TOKEN: unique symbol = Symbol(\"niceeval.adapterContractToken\");\nconst EVAL_ADAPTER_CONTRACT_TOKEN: unique symbol = Symbol(\"niceeval.evalAdapterContractToken\");\n/**\n * Synchronously assembles Attempt-local Assertion methods from the guarded app\n * facade and the shared check registrar. The returned object must contain only\n * ordinary, synchronously returning methods. Generic and overloaded Assertion\n * sugar is intentionally not callable after binding; use ordinary named\n * parameters so argument and native handle types remain exact.\n */\nexport type AdapterAssertionsFactory<Context extends object, Assertions extends object = object> = (context: AdapterAssertionsFactoryContext<Context>) => Assertions;\n/**\n * Definition inputs for Adapter Assertion sugar. `app` becomes callable after\n * assembly, and `check` may only be called by a returned Assertion method.\n */\nexport interface AdapterAssertionsFactoryContext<Context extends object> {\n    readonly app: MatchContext<Context>;\n    readonly check: AssertionCheck<\"polymorphic\", Context>;\n}\ntype BoundAdapterAssertionResult<Kind extends EvaluationKind, Result> = Result extends PolymorphicBooleanAssertionHandle<infer Refined, infer HasGate> ? BooleanAssertionHandle<Kind, Refined, HasGate> : Result extends PolymorphicMeasurementAssertionHandle<infer HasCondition> ? MeasurementAssertionHandle<Kind, HasCondition> : never;\ntype BoundAdapterAssertionMethod<Kind extends EvaluationKind, Method> = Method extends (...args: infer Args) => infer Result ? ((...args: Args) => Result) extends Method ? (...args: Args) => BoundAdapterAssertionResult<Kind, Result> : never : never;\ntype AdapterAssertionsFor<Assertions extends object | undefined, Kind extends EvaluationKind> = Assertions extends object ? {\n    readonly [Key in keyof Assertions]: BoundAdapterAssertionMethod<Kind, Assertions[Key]>;\n} : {};\n/** Keys owned by the neutral Eval runtime or unsafe on a merged object root. */\nconst RESERVED_ADAPTER_CONTEXT_KEYS = [\n    \"evaluationKind\",\n    \"check\",\n    \"judge\",\n    \"factuality\",\n    \"faithfulness\",\n    \"instructionFollowing\",\n    \"pairwisePreference\",\n    \"closeQA\",\n    \"usage\",\n    \"elapsedMs\",\n    \"maxTokens\",\n    \"maxCost\",\n    \"score\",\n    \"group\",\n    \"note\",\n    \"skip\",\n    \"signal\",\n    \"model\",\n    \"reasoningEffort\",\n    \"flags\",\n    \"progress\",\n    \"diagnostic\",\n    \"log\",\n    \"then\",\n    \"Object\",\n    \"constructor\",\n    \"__defineGetter__\",\n    \"__defineSetter__\",\n    \"hasOwnProperty\",\n    \"__lookupGetter__\",\n    \"__lookupSetter__\",\n    \"isPrototypeOf\",\n    \"propertyIsEnumerable\",\n    \"toString\",\n    \"valueOf\",\n    \"__proto__\",\n    \"toLocaleString\",\n] as const;\nexport type ReservedAdapterContextKey = typeof RESERVED_ADAPTER_CONTEXT_KEYS[number];\ntype InvalidContextBranch<Context> = Context extends unknown ? Context extends object ? Context extends readonly unknown[] ? Context : Context extends (...args: readonly never[]) => unknown ? Context : string extends keyof Context ? Context : Extract<keyof Context, ReservedAdapterContextKey> extends never ? never : Context : Context : never;\ntype AdapterContextValidation<Context> = unknown extends Context ? unknown : [\n    InvalidContextBranch<Context>\n] extends [\n    never\n] ? unknown : {\n    readonly invalidAdapterContext: InvalidContextBranch<Context>;\n};\ntype InvalidAssertionMethodKey<Context extends object, Assertions> = Assertions extends object ? {\n    [Key in keyof Assertions]: Key extends string ? Key extends ReservedAdapterContextKey | keyof Context ? Key : Assertions[Key] extends (...args: readonly never[]) => infer Result ? Result extends PolymorphicBooleanAssertionHandle<unknown, boolean> | PolymorphicMeasurementAssertionHandle<boolean> ? never : Key : Key : Key;\n}[keyof Assertions] : \"assertions\";\ntype InvalidAdapterAssertions<Context extends object, Assertions extends object> = InvalidAssertionMethodKey<Context, Assertions>;\ntype AdapterAssertionsValidation<Context extends object, Assertions extends object> = [\n    InvalidAdapterAssertions<Context, Assertions>\n] extends [\n    never\n] ? unknown : {\n    readonly invalidAdapterAssertions: InvalidAdapterAssertions<Context, Assertions>;\n};\ntype AdapterAssertionsValidationArgs<Context extends object, Assertions extends object> = [\n    InvalidAdapterAssertions<Context, Assertions>\n] extends [\n    never\n] ? [\n] : [\n    error: {\n        readonly invalidAdapterAssertions: InvalidAdapterAssertions<Context, Assertions>;\n    }\n];\ntype AdapterFactory<Context extends object, Flags extends AdapterFlagsParser = undefined> = (context: AdapterCreateContext<AdapterFlagsOutput<Flags>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;\nexport interface AdapterCleanupContext {\n    /** 整个清理窗口的固定毫秒预算，不为每个回调续期。 */\n    readonly timeoutMs: number;\n    /** 清理窗口实际开始时确定的 Unix 毫秒截止时间。 */\n    readonly deadlineAt: number;\n    /** 独立于执行信号；整个 Adapter 清理窗口截止时中止。 */\n    readonly signal: AbortSignal;\n}\nexport interface AdapterCreateContext<Flags = ExperimentFlags, Roles extends string = string> {\n    /** Frozen application model selections for this Attempt. */\n    readonly models: Readonly<Record<Roles, ResolvedModelRole>>;\n    recordUsage(input: Omit<import(\"./adapter-usage.ts\").AdapterUsageInput, \"modelRole\"> & {\n        readonly modelRole?: Roles | null;\n    }): void;\n    /** Close application usage admission and declare whether the recorded collection is complete. */\n    sealUsage(input: import(\"./adapter-usage.ts\").AdapterUsageSeal): void;\n    attach(input: import(\"./adapter-attachments.ts\").AdapterAttachmentInput): Promise<import(\"./adapter-attachments.ts\").AdapterAttachmentReceipt>;\n    recordTrace<Event extends import(\"./adapter-execution-trace.ts\").ExecutionTraceEvent>(input: import(\"./adapter-execution-trace.ts\").ExecutionTraceInput<Event>): Promise<import(\"./adapter-execution-trace.ts\").ExecutionTraceReceipt>;\n    /** 当前 Eval 的公开 ID。 */\n    readonly evalId: string;\n    /** 当前 Experiment 的公开 ID。 */\n    readonly experimentId: string;\n    /** 当前 Attempt 的零起始序号。 */\n    readonly attempt: number;\n    /** Attempt 执行信号；reason 区分 timeout 与 cancelled，不用于 cleanup 窗口。 */\n    readonly signal: AttemptSignal;\n    /** Experiment 选择的模型。 */\n    readonly model?: string;\n    /** Experiment 选择的推理强度。 */\n    readonly reasoningEffort?: string;\n    /** Experiment 传给 Adapter 的只读 flags。 */\n    readonly flags: Flags;\n    /** 更新当前 Attempt 的人读进度。 */\n    progress(update: ProgressUpdate): void;\n    /** 为当前 Attempt 追加结构化诊断。 */\n    diagnostic(input: DiagnosticInput): void;\n    /** 为当前 Attempt 追加日志。 */\n    log(message: string): void;\n    /**\n     * 登记 Attempt-local 资源释放。回调按全局 LIFO 执行；一项失败不会跳过其余项。\n     * 零参数回调仍可直接传入。传入的 context 已冻结，同一 cleanup 窗口的回调共享一个 signal。\n     */\n    onCleanup(cleanup: (context: AdapterCleanupContext) => void | Promise<void>): void;\n}\ntype EvalContextBase<Kind extends EvaluationKind, Flags, Context> = JudgePresetMethods<Kind, Context> & {\n    readonly usage: EvalUsage;\n    readonly elapsedMs: import(\"./assertions/match.ts\").NumericMaterial;\n    maxTokens(max: number): BooleanAssertionHandle<Kind, number>;\n    maxCost(usd: number | string): BooleanAssertionHandle<Kind, string>;\n    readonly evaluationKind: Kind;\n    readonly signal: AbortSignal;\n    readonly model?: string;\n    readonly reasoningEffort?: string;\n    readonly flags: Flags;\n    progress(update: ProgressUpdate): void;\n    diagnostic(input: DiagnosticInput): void;\n    log(message: string): void;\n    skip(reason: string): never;\n    group<Value>(title: string, body: () => Value | PromiseLike<Value>): Promise<Awaited<Value>>;\n    readonly check: AssertionCheck<Kind, Context>;\n    readonly judge: <Value>(value: AssertionSubject<Value>, definition: ScoreMatch<NoInfer<Value>>) => MeasurementAssertionHandle<Kind>;\n};\n/** Agent-neutral author context shared by every Adapter Eval. */\nexport type EvalContext<Kind extends EvaluationKind = \"pass\", Flags = ExperimentFlags, Context = unknown> = EvalContextBase<Kind, Flags, Context> & (Kind extends \"score\" ? {\n    readonly score: AssertionsRuntime<\"score\">[\"t\"][\"score\"];\n} : {});\ntype AdapterEvalFields = Omit<EvalInput<undefined>, \"test\" | \"sandbox\" | \"diff\"> & {\n    readonly sandbox?: never;\n    readonly diff?: never;\n};\ntype AdapterScoreEvalFields = Omit<ScoreEvalInput<undefined>, \"test\" | \"sandbox\" | \"diff\"> & {\n    readonly sandbox?: never;\n    readonly diff?: never;\n};\nexport type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined, Roles extends string = string> = AdapterEvalFields & {\n    readonly requires?: ModelRequirements<Roles>;\n    test(t: Omit<EvalContext<\"pass\", AdapterFlagsOutput<Flags>, Context>, \"usage\"> & {\n        readonly usage: EvalUsage<NoInfer<Roles>>;\n    } & Readonly<Context> & AdapterAssertionsFor<Assertions, \"pass\">): void | Promise<void>;\n};\nexport type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined, Roles extends string = string> = AdapterScoreEvalFields & {\n    readonly requires?: ModelRequirements<Roles>;\n    test(t: Omit<EvalContext<\"score\", AdapterFlagsOutput<Flags>, Context>, \"usage\"> & {\n        readonly usage: EvalUsage<NoInfer<Roles>>;\n    } & Readonly<Context> & AdapterAssertionsFor<Assertions, \"score\">): void | Promise<void>;\n};\ninterface AdapterContractToken<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser = undefined> {\n    readonly name: string;\n    readonly assertions: AdapterAssertionsFactory<Context> | undefined;\n    readonly parseFlags: Flags;\n    /** Keeps the Assertion method shape invariant without exposing a constructible brand. */\n    readonly assertionTypes: (value: Assertions) => Assertions;\n    /** Keeps the context parameter invariant without exposing a constructible brand. */\n    readonly context: (value: Context) => Context;\n}\nexport interface AdapterEvalDefinition<Kind extends EvaluationKind, Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends EvalDefinition<Kind, EvalContext<Kind, AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, Kind>, undefined> {\n    readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions, Flags>;\n}\n/** @internal Existential discovery view; concrete bound factories retain their exact Context. */\nexport interface AdapterRuntimeEvalDefinition<Kind extends EvaluationKind> extends EvalDefinition<Kind, never, undefined> {\n    readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: object;\n}\n/** Common public surface for an Adapter definition with bound Eval factories. */\nexport interface AdapterDefinition<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> {\n    readonly name: string;\n    readonly parseFlags: Flags;\n    defineEval<const Roles extends string = string>(input: AdapterEvalInput<Context, Assertions, Flags, Roles>): AdapterEvalDefinition<\"pass\", Context, Assertions, Flags>;\n    defineScoreEval<const Roles extends string = string>(input: AdapterScoreEvalInput<Context, Assertions, Flags, Roles>): AdapterEvalDefinition<\"score\", Context, Assertions, Flags>;\n}\n/** Existential runtime view used by Experiment without erasing a concrete context to `any`. */\nexport interface AdapterRuntimeDefinition {\n    readonly parseFlags?: Exclude<AdapterFlagsParser, undefined>;\n    readonly kind: \"custom\";\n    readonly requiredModelRoles?: readonly string[];\n    readonly name: string;\n    readonly contract: string;\n    readonly behaviorRevision: string | null;\n    readonly cleanupTimeoutMs: number;\n    readonly [ADAPTER_CONTRACT_TOKEN]: object;\n    readonly defineEval: (...args: never[]) => unknown;\n    readonly defineScoreEval: (...args: never[]) => unknown;\n    create(context: AdapterCreateContext<unknown>): object | Promise<object>;\n}\nexport interface AdapterImplementation<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends AdapterDefinition<Context, Assertions, Flags> {\n    readonly kind: \"custom\";\n    readonly contract: string;\n    readonly behaviorRevision: string | null;\n    readonly cleanupTimeoutMs: number;\n    readonly [ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions, Flags>;\n    create(context: AdapterCreateContext<AdapterFlagsOutput<Flags>>): Context | Promise<Context>;\n}\nexport type AdapterImplementationInput<Context extends object, ImplementationContext extends Context = Context, Flags extends AdapterFlagsParser = undefined> = {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: AdapterFactory<ImplementationContext, Flags>;\n} & AdapterContextValidation<NoInfer<ImplementationContext>>;\nexport interface AdapterContract<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends AdapterDefinition<Context, Assertions, Flags> {\n    readonly name: string;\n    implement<ImplementationContext extends Context>(input: AdapterImplementationInput<Context, ImplementationContext, Flags>): AdapterImplementation<Context, Assertions, Flags>;\n    /**\n     * Returns a contract whose Eval factories and implementations share one flags parser.\n     */\n    withParseFlags<NextFlags extends Exclude<AdapterFlagsParser, undefined>>(parseFlags: NextFlags, ...validation: AdapterFlagsParserValidationArgs<NoInfer<NextFlags>>): AdapterContract<Context, Assertions, NextFlags>;\n    /** Returns a contract whose implementations share this exact Assertion factory. */\n    withAssertions<NextAssertions extends object>(factory: AdapterAssertionsFactory<Context, NextAssertions>, ...validation: AdapterAssertionsValidationArgs<Context, NoInfer<NextAssertions>>): AdapterContract<Context, NextAssertions, Flags>;\n}\nexport type Adapter = import(\"./agents/types.ts\").Agent | AdapterRuntimeDefinition;\nfunction assertNonEmptyString(value: unknown, field: string, factory: string): asserts value is string {\n    if (typeof value !== \"string\" || value.trim() === \"\") {\n        throw new TypeError(`${factory} requires a non-empty ${field}.`);\n    }\n}\nfunction contractToken<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser>(name: string, assertions: AdapterAssertionsFactory<Context> | undefined, parseFlags: Flags): AdapterContractToken<Context, Assertions, Flags> {\n    return Object.freeze({\n        name,\n        assertions,\n        parseFlags,\n        assertionTypes: (value: Assertions) => value,\n        context: (value: Context) => value,\n    });\n}\nfunction assertAdapterEvalInput(value: {\n    readonly sandbox?: unknown;\n    readonly diff?: unknown;\n}, factory: \"defineEval\" | \"defineScoreEval\"): void {\n    if (Object.hasOwn(value, \"sandbox\")) {\n        throw new TypeError(`${factory} for an Adapter does not support sandbox.`);\n    }\n    if (Object.hasOwn(value, \"diff\")) {\n        throw new TypeError(`${factory} for an Adapter does not support Agent workspace diff configuration.`);\n    }\n}\nfunction boundEvalFactories<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser>(token: AdapterContractToken<Context, Assertions, Flags>): Pick<AdapterDefinition<Context, Assertions, Flags>, \"defineEval\" | \"defineScoreEval\"> {\n    return {\n        defineEval(input) {\n            assertAdapterEvalInput(input, \"defineEval\");\n            return defineEvalForContext(\"pass\", input, {\n                [EVAL_ADAPTER_CONTRACT_TOKEN]: token,\n                requiredModelRoles: normalizeModelRequirements(input.requires),\n            }) as AdapterEvalDefinition<\"pass\", Context, Assertions, Flags>;\n        },\n        defineScoreEval(input) {\n            assertAdapterEvalInput(input, \"defineScoreEval\");\n            return defineEvalForContext(\"score\", input, {\n                [EVAL_ADAPTER_CONTRACT_TOKEN]: token,\n                requiredModelRoles: normalizeModelRequirements(input.requires),\n            }) as AdapterEvalDefinition<\"score\", Context, Assertions, Flags>;\n        },\n    };\n}\nfunction implementAdapter<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser>(token: AdapterContractToken<Context, Assertions, Flags>, input: {\n    readonly name: string;\n    readonly requires?: ModelRequirements;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: AdapterFactory<Context, Flags>;\n}, factory: \"defineAdapter\" | \"AdapterContract.implement\"): AdapterImplementation<Context, Assertions, Flags> {\n    assertNonEmptyString(input.name, \"name\", factory);\n    if (input.behaviorRevision !== undefined) {\n        assertNonEmptyString(input.behaviorRevision, \"behaviorRevision\", factory);\n    }\n    if (typeof input.create !== \"function\") {\n        throw new TypeError(`${factory} requires create(context).`);\n    }\n    const cleanupTimeoutMs = resolveAdapterCleanupTimeoutMs(input.cleanupTimeoutMs);\n    const authorCreate = input.create;\n    const create = (context: AdapterCreateContext<AdapterFlagsOutput<Flags>>): Context | Promise<Context> => {\n        const created = authorCreate(context);\n        if (created instanceof Promise) {\n            return created.then((value) => {\n                assertPlainAdapterContext(value);\n                return value;\n            });\n        }\n        // Validate before a caller can pass a synchronous thenable to Promise adaptation.\n        assertPlainAdapterContext(created);\n        return created;\n    };\n    return Object.freeze({\n        kind: \"custom\" as const,\n        requiredModelRoles: normalizeModelRequirements(input.requires),\n        parseFlags: token.parseFlags,\n        name: input.name,\n        contract: token.name,\n        behaviorRevision: input.behaviorRevision ?? null,\n        cleanupTimeoutMs,\n        create,\n        [ADAPTER_CONTRACT_TOKEN]: token,\n        ...boundEvalFactories(token),\n    }) as AdapterImplementation<Context, Assertions, Flags>;\n}\n/** Defines one Adapter implementation with an automatically private contract. */\nexport function defineAdapter<Context extends object, Flags extends AdapterFlagsParser = undefined, const Roles extends string = string>(input: {\n    readonly name: string;\n    readonly requires?: ModelRequirements<Roles>;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: (context: AdapterCreateContext<AdapterFlagsOutput<Flags>, NoInfer<Roles>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;\n    readonly parseFlags?: Flags;\n    readonly assertions?: undefined;\n} & AdapterContextValidation<NoInfer<Context>> & AdapterFlagsParserValidation<NoInfer<Flags>>): AdapterImplementation<Context, undefined, Flags>;\nexport function defineAdapter<Context extends object, Assertions extends object, Flags extends AdapterFlagsParser = undefined, const Roles extends string = string>(input: {\n    readonly name: string;\n    readonly requires?: ModelRequirements<Roles>;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: (context: AdapterCreateContext<AdapterFlagsOutput<Flags>, NoInfer<Roles>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;\n    readonly parseFlags?: Flags;\n    /** Attempt-local Assertion sugar, assembled once after create() succeeds. */\n    readonly assertions: AdapterAssertionsFactory<Context, Assertions>;\n} & AdapterContextValidation<NoInfer<Context>> & AdapterFlagsParserValidation<NoInfer<Flags>> & AdapterAssertionsValidation<Context, NoInfer<Assertions>>): AdapterImplementation<Context, Assertions, Flags>;\n// @concord-code\n// @concord-implements docs/feature/adapters/README.md\n// @concord-implements docs/feature/adapters/library/writing-an-adapter.md\nexport function defineAdapter(input: {\n    readonly name: string;\n    readonly requires?: ModelRequirements;\n    readonly behaviorRevision?: string;\n    /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */\n    readonly cleanupTimeoutMs?: number;\n    readonly create: AdapterFactory<object, AdapterFlagsParser>;\n    readonly parseFlags?: Exclude<AdapterFlagsParser, undefined>;\n    readonly assertions?: AdapterAssertionsFactory<object>;\n}): AdapterRuntimeDefinition {\n    if (input.parseFlags !== undefined)\n        assertAdapterFlagsParser(input.parseFlags);\n    const assertions = input.assertions;\n    if (assertions !== undefined && typeof assertions !== \"function\") {\n        throw new TypeError(\"defineAdapter assertions must be a function.\");\n    }\n    return implementAdapter(contractToken<object, object | undefined, AdapterFlagsParser>(input.name, assertions, input.parseFlags), input, \"defineAdapter\");\n}\n/** Defines a reusable contract whose implementations and Evals share one runtime-only token. */\n// @concord-code\n// @concord-implements docs/feature/adapters/README.md\n// @concord-implements docs/feature/adapters/architecture/agent-contract.md\nexport function defineAdapterContract<Context extends object>(input: {\n    readonly name: string;\n} & AdapterContextValidation<NoInfer<Context>>): AdapterContract<Context> {\n    assertNonEmptyString(input.name, \"name\", \"defineAdapterContract\");\n    return makeAdapterContract(contractToken<Context, undefined, undefined>(input.name, undefined, undefined));\n}\nfunction makeAdapterContract<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser>(token: AdapterContractToken<Context, Assertions, Flags>): AdapterContract<Context, Assertions, Flags> {\n    const factories = boundEvalFactories(token);\n    return Object.freeze({\n        name: token.name,\n        parseFlags: token.parseFlags,\n        ...factories,\n        implement<ImplementationContext extends Context>(implementation: AdapterImplementationInput<Context, ImplementationContext, Flags>) {\n            return implementAdapter(token, implementation, \"AdapterContract.implement\");\n        },\n        withParseFlags<NextFlags extends Exclude<AdapterFlagsParser, undefined>>(parseFlags: NextFlags, ..._validation: AdapterFlagsParserValidationArgs<NoInfer<NextFlags>>) {\n            assertAdapterFlagsParser(parseFlags);\n            return makeAdapterContract(contractToken<Context, Assertions, NextFlags>(token.name, token.assertions, parseFlags));\n        },\n        withAssertions<NextAssertions extends object>(factory: AdapterAssertionsFactory<Context, NextAssertions>, ..._validation: AdapterAssertionsValidationArgs<Context, NoInfer<NextAssertions>>) {\n            if (typeof factory !== \"function\") {\n                throw new TypeError(\"AdapterContract.withAssertions requires a function.\");\n            }\n            return makeAdapterContract(contractToken<Context, NextAssertions, Flags>(token.name, factory, token.parseFlags));\n        },\n    });\n}\n/** The single credential-free persistence projection for an Adapter. */\nexport function adapterIdentity(adapter: Adapter): AdapterIdentity {\n    return adapter.kind === \"custom\"\n        ? Object.freeze({\n            name: adapter.name,\n            contract: adapter.contract,\n            behaviorRevision: adapter.behaviorRevision,\n            cleanupTimeoutMs: adapter.cleanupTimeoutMs,\n        })\n        : Object.freeze({\n            name: adapter.name,\n            contract: \"niceeval.agent/v1\",\n            behaviorRevision: null,\n        });\n}\n/** @internal Runtime contract pairing; the token itself never enters persistence. */\nexport function adapterAcceptsEval(adapter: Adapter, definition: object): boolean {\n    const required = (definition as {\n        readonly [EVAL_ADAPTER_CONTRACT_TOKEN]?: unknown;\n    })[EVAL_ADAPTER_CONTRACT_TOKEN];\n    if (adapter.kind === \"custom\") {\n        const provided = adapter[ADAPTER_CONTRACT_TOKEN];\n        return required !== undefined && provided !== undefined && required === provided;\n    }\n    return required === undefined;\n}\n/** @internal Returns the readable contract name without revealing the pairing token. */\nexport function adapterContractRequiredByEval(definition: object): string | undefined {\n    return (definition as {\n        readonly [EVAL_ADAPTER_CONTRACT_TOKEN]?: {\n            readonly name: string;\n        };\n    })[EVAL_ADAPTER_CONTRACT_TOKEN]?.name;\n}\nconst RESERVED_ADAPTER_CONTEXT_KEY_SET: ReadonlySet<string> = new Set(RESERVED_ADAPTER_CONTEXT_KEYS);\nfunction assertPlainAdapterContext(value: unknown): asserts value is object {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n        throw new TypeError(\"Adapter create(context) must return a plain object.\");\n    }\n    const prototype = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) {\n        throw new TypeError(\"Adapter create(context) must return an explicit plain object.\");\n    }\n    for (const key of Reflect.ownKeys(value)) {\n        if (typeof key === \"string\" && RESERVED_ADAPTER_CONTEXT_KEY_SET.has(key)) {\n            throw new TypeError(`Adapter context key ${JSON.stringify(key)} is reserved.`);\n        }\n    }\n}\nfunction forwardProperties(target: object, source: object, guardAccess: boolean, assertAuthorOpen: () => void): void {\n    for (const key of Reflect.ownKeys(source)) {\n        const descriptor = Object.getOwnPropertyDescriptor(source, key);\n        if (descriptor === undefined)\n            continue;\n        if (\"value\" in descriptor && typeof descriptor.value === \"function\") {\n            const method = guardAccess\n                ? function (this: unknown, ...args: readonly unknown[]) {\n                    assertAuthorOpen();\n                    return Reflect.apply(descriptor.value, source, args);\n                }\n                : descriptor.value.bind(source);\n            Object.defineProperty(target, key, {\n                enumerable: true,\n                configurable: false,\n                writable: false,\n                value: method,\n            });\n        }\n        else {\n            Object.defineProperty(target, key, {\n                enumerable: true,\n                configurable: false,\n                get: () => {\n                    if (guardAccess)\n                        assertAuthorOpen();\n                    const value = Reflect.get(source, key, source);\n                    if (typeof value !== \"function\")\n                        return value;\n                    return guardAccess\n                        ? (...args: readonly unknown[]) => {\n                            assertAuthorOpen();\n                            return Reflect.apply(value, source, args);\n                        }\n                        : value.bind(source);\n                },\n            });\n        }\n    }\n}\n/** Observes only branded native Promises without reading an arbitrary `.then` property. */\nfunction observeNativePromiseRejection(value: unknown): boolean {\n    if ((typeof value !== \"object\" && typeof value !== \"function\") || value === null)\n        return false;\n    try {\n        void Reflect.apply(Promise.prototype.then, value, [\n            undefined,\n            () => undefined,\n        ]);\n        return true;\n    }\n    catch {\n        return false;\n    }\n}\nfunction assertPlainAdapterAssertions(value: unknown, context: object): asserts value is object {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n        throw new TypeError(\"Adapter assertions factory must return a plain object of methods.\");\n    }\n    const prototype = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) {\n        observeNativePromiseRejection(value);\n        throw new TypeError(\"Adapter assertions factory must return an explicit plain object.\");\n    }\n    const contextKeys = new Set(Reflect.ownKeys(context));\n    for (const key of Reflect.ownKeys(value)) {\n        if (typeof key !== \"string\") {\n            throw new TypeError(\"Adapter assertion method names must be strings.\");\n        }\n        if (RESERVED_ADAPTER_CONTEXT_KEY_SET.has(key)) {\n            throw new TypeError(`Adapter assertion method name ${JSON.stringify(key)} is reserved.`);\n        }\n        if (contextKeys.has(key)) {\n            throw new TypeError(`Adapter assertion method name ${JSON.stringify(key)} conflicts with an app member.`);\n        }\n        const descriptor = Object.getOwnPropertyDescriptor(value, key);\n        if (descriptor === undefined || !(\"value\" in descriptor) || typeof descriptor.value !== \"function\") {\n            throw new TypeError(`Adapter assertion ${JSON.stringify(key)} must be an own data method.`);\n        }\n    }\n}\nfunction bindAdapterAppContext<Context>(context: Context, assertAppOpen: () => void): Readonly<Context> {\n    const target = Object.create(null) as object;\n    forwardProperties(target, context as object, true, assertAppOpen);\n    return Object.freeze(target) as Readonly<Context>;\n}\nfunction bindAdapterAssertions<Kind extends EvaluationKind, Context extends object>(core: EvalContext<Kind>, context: Context, factory: AdapterAssertionsFactory<Context>, assertAuthorOpen: () => void): {\n    readonly app: Readonly<Context>;\n    readonly assertions: object;\n} {\n    let assembled = false;\n    const assertAppOpen = (): void => {\n        assertAuthorOpen();\n        if (!assembled) {\n            throw new TypeError(\"Adapter assertions factory may only assemble methods; app access starts afterward.\");\n        }\n    };\n    const app = bindAdapterAppContext(context, assertAppOpen);\n    const handleFrames: Array<WeakSet<object>> = [];\n    const check = (...args: readonly unknown[]): unknown => {\n        assertAuthorOpen();\n        const frame = handleFrames.at(-1);\n        if (frame === undefined) {\n            throw new TypeError(\"Adapter assertions factory may call check only from an assertion method.\");\n        }\n        const handle = Reflect.apply(core.check, undefined, args);\n        if ((typeof handle !== \"object\" && typeof handle !== \"function\") || handle === null) {\n            throw new TypeError(\"Adapter assertion check did not return an AssertionHandle.\");\n        }\n        frame.add(handle);\n        return handle;\n    };\n    const authored = factory({ app: app as MatchContext<Context>, check: check as AssertionCheck<\"polymorphic\", Context> });\n    assertPlainAdapterAssertions(authored, context);\n    Object.freeze(authored);\n    assembled = true;\n    const assertions = Object.create(null) as object;\n    for (const key of Reflect.ownKeys(authored)) {\n        const descriptor = Object.getOwnPropertyDescriptor(authored, key)!;\n        const method = descriptor.value as (...args: readonly unknown[]) => unknown;\n        Object.defineProperty(assertions, key, {\n            enumerable: true,\n            configurable: false,\n            writable: false,\n            value: (...args: readonly unknown[]) => {\n                assertAuthorOpen();\n                const frame = new WeakSet<object>();\n                handleFrames.push(frame);\n                try {\n                    const handle = Reflect.apply(method, authored, args);\n                    if ((typeof handle !== \"object\" && typeof handle !== \"function\") || handle === null || !frame.has(handle)) {\n                        observeNativePromiseRejection(handle);\n                        throw new TypeError(`Adapter assertion ${JSON.stringify(key)} must synchronously return its own check() handle.`);\n                    }\n                    return handle;\n                }\n                finally {\n                    handleFrames.pop();\n                }\n            },\n        });\n    }\n    return Object.freeze({ app, assertions: Object.freeze(assertions) });\n}\n/** @internal Builds the frozen single-t facade after create settles. */\n// @concord-code\n// @concord-implements docs/feature/adapters/architecture/agent-contract.md\nexport function bindAdapterEvalContext<Kind extends EvaluationKind, Context>(core: EvalContext<Kind>, context: Context, adapter: AdapterRuntimeDefinition, assertAuthorOpen: () => void): EvalContext<Kind> & Readonly<Context> {\n    assertPlainAdapterContext(context);\n    const token = adapter[ADAPTER_CONTRACT_TOKEN] as AdapterContractToken<Context & object, object | undefined>;\n    let app: Readonly<Context>;\n    let assertions: object | undefined;\n    if (token.assertions === undefined) {\n        app = bindAdapterAppContext(context, assertAuthorOpen);\n    }\n    else {\n        const bound = bindAdapterAssertions(core, context, token.assertions, assertAuthorOpen);\n        app = bound.app;\n        assertions = bound.assertions;\n    }\n    bindAssertionContext(core.check, () => app);\n    const target = Object.create(null) as object;\n    forwardProperties(target, core, false, assertAuthorOpen);\n    forwardProperties(target, app, false, assertAuthorOpen);\n    if (assertions !== undefined)\n        forwardProperties(target, assertions, false, assertAuthorOpen);\n    return Object.freeze(target) as EvalContext<Kind> & Readonly<Context>;\n}\n"]}

package/dist/adapter.d.cts

@@ -1,4 +1,4 @@
-import type { ResolvedModelSlots } from "./model-slots.cjs";
+import { type ModelRequirements, type ResolvedModelRole } from "./model-roles.cjs";
 import type { AttemptSignal } from "./shared/attempt-lifecycle.cjs";
 export type { AttemptCancellation, AttemptSignal } from "./shared/attempt-lifecycle.cjs";
 import type { MatchContext } from "./assertions/context-match.cjs";
@@ -37,7 +37,7 @@ type AdapterAssertionsFor<Assertions extends object | undefined, Kind extends Ev
     readonly [Key in keyof Assertions]: BoundAdapterAssertionMethod<Kind, Assertions[Key]>;
 } : {};
 /** Keys owned by the neutral Eval runtime or unsafe on a merged object root. */
-declare const RESERVED_ADAPTER_CONTEXT_KEYS: readonly ["evaluationKind", "check", "judge", "factuality", "faithfulness", "instructionFollowing", "pairwisePreference", "closeQA", "usage", "elapsedMs", "maxTokens", "maxCost", "score", "group", "skip", "signal", "model", "reasoningEffort", "flags", "progress", "diagnostic", "log", "then", "Object", "constructor", "__defineGetter__", "__defineSetter__", "hasOwnProperty", "__lookupGetter__", "__lookupSetter__", "isPrototypeOf", "propertyIsEnumerable", "toString", "valueOf", "__proto__", "toLocaleString"];
+declare const RESERVED_ADAPTER_CONTEXT_KEYS: readonly ["evaluationKind", "check", "judge", "factuality", "faithfulness", "instructionFollowing", "pairwisePreference", "closeQA", "usage", "elapsedMs", "maxTokens", "maxCost", "score", "group", "note", "skip", "signal", "model", "reasoningEffort", "flags", "progress", "diagnostic", "log", "then", "Object", "constructor", "__defineGetter__", "__defineSetter__", "hasOwnProperty", "__lookupGetter__", "__lookupSetter__", "isPrototypeOf", "propertyIsEnumerable", "toString", "valueOf", "__proto__", "toLocaleString"];
 export type ReservedAdapterContextKey = typeof RESERVED_ADAPTER_CONTEXT_KEYS[number];
 type InvalidContextBranch<Context> = Context extends unknown ? Context extends object ? Context extends readonly unknown[] ? Context : Context extends (...args: readonly never[]) => unknown ? Context : string extends keyof Context ? Context : Extract<keyof Context, ReservedAdapterContextKey> extends never ? never : Context : Context : never;
 type AdapterContextValidation<Context> = unknown extends Context ? unknown : [InvalidContextBranch<Context>] extends [never] ? unknown : {
@@ -62,10 +62,12 @@ export interface AdapterCleanupContext {
     /** 独立于执行信号；整个 Adapter 清理窗口截止时中止。 */
     readonly signal: AbortSignal;
 }
-export interface AdapterCreateContext<Flags = ExperimentFlags> {
+export interface AdapterCreateContext<Flags = ExperimentFlags, Roles extends string = string> {
     /** Frozen application model selections for this Attempt. */
-    readonly models: ResolvedModelSlots;
-    recordUsage(input: import("./adapter-usage.cjs").AdapterUsageInput): void;
+    readonly models: Readonly<Record<Roles, ResolvedModelRole>>;
+    recordUsage(input: Omit<import("./adapter-usage.cjs").AdapterUsageInput, "modelRole"> & {
+        readonly modelRole?: Roles | null;
+    }): void;
     /** Close application usage admission and declare whether the recorded collection is complete. */
     sealUsage(input: import("./adapter-usage.cjs").AdapterUsageSeal): void;
     attach(input: import("./adapter-attachments.cjs").AdapterAttachmentInput): Promise<import("./adapter-attachments.cjs").AdapterAttachmentReceipt>;
@@ -126,11 +128,17 @@ type AdapterScoreEvalFields = Omit<ScoreEvalInput<undefined>, "test" | "sandbox"
     readonly sandbox?: never;
     readonly diff?: never;
 };
-export type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterEvalFields & {
-    test(t: EvalContext<"pass", AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, "pass">): void | Promise<void>;
+export type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined, Roles extends string = string> = AdapterEvalFields & {
+    readonly requires?: ModelRequirements<Roles>;
+    test(t: Omit<EvalContext<"pass", AdapterFlagsOutput<Flags>, Context>, "usage"> & {
+        readonly usage: EvalUsage<NoInfer<Roles>>;
+    } & Readonly<Context> & AdapterAssertionsFor<Assertions, "pass">): void | Promise<void>;
 };
-export type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterScoreEvalFields & {
-    test(t: EvalContext<"score", AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, "score">): void | Promise<void>;
+export type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined, Roles extends string = string> = AdapterScoreEvalFields & {
+    readonly requires?: ModelRequirements<Roles>;
+    test(t: Omit<EvalContext<"score", AdapterFlagsOutput<Flags>, Context>, "usage"> & {
+        readonly usage: EvalUsage<NoInfer<Roles>>;
+    } & Readonly<Context> & AdapterAssertionsFor<Assertions, "score">): void | Promise<void>;
 };
 interface AdapterContractToken<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser = undefined> {
     readonly name: string;
@@ -152,13 +160,14 @@ export interface AdapterRuntimeEvalDefinition<Kind extends EvaluationKind> exten
 export interface AdapterDefinition<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> {
     readonly name: string;
     readonly parseFlags: Flags;
-    defineEval(input: AdapterEvalInput<Context, Assertions, Flags>): AdapterEvalDefinition<"pass", Context, Assertions, Flags>;
-    defineScoreEval(input: AdapterScoreEvalInput<Context, Assertions, Flags>): AdapterEvalDefinition<"score", Context, Assertions, Flags>;
+    defineEval<const Roles extends string = string>(input: AdapterEvalInput<Context, Assertions, Flags, Roles>): AdapterEvalDefinition<"pass", Context, Assertions, Flags>;
+    defineScoreEval<const Roles extends string = string>(input: AdapterScoreEvalInput<Context, Assertions, Flags, Roles>): AdapterEvalDefinition<"score", Context, Assertions, Flags>;
 }
 /** Existential runtime view used by Experiment without erasing a concrete context to `any`. */
 export interface AdapterRuntimeDefinition {
     readonly parseFlags?: Exclude<AdapterFlagsParser, undefined>;
     readonly kind: "custom";
+    readonly requiredModelRoles?: readonly string[];
     readonly name: string;
     readonly contract: string;
     readonly behaviorRevision: string | null;
@@ -195,21 +204,23 @@ export interface AdapterContract<Context extends object, Assertions extends obje
 }
 export type Adapter = import("./agents/types.cjs").Agent | AdapterRuntimeDefinition;
 /** Defines one Adapter implementation with an automatically private contract. */
-export declare function defineAdapter<Context extends object, Flags extends AdapterFlagsParser = undefined>(input: {
+export declare function defineAdapter<Context extends object, Flags extends AdapterFlagsParser = undefined, const Roles extends string = string>(input: {
     readonly name: string;
+    readonly requires?: ModelRequirements<Roles>;
     readonly behaviorRevision?: string;
     /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */
     readonly cleanupTimeoutMs?: number;
-    readonly create: AdapterFactory<Context, Flags>;
+    readonly create: (context: AdapterCreateContext<AdapterFlagsOutput<Flags>, NoInfer<Roles>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;
     readonly parseFlags?: Flags;
     readonly assertions?: undefined;
 } & AdapterContextValidation<NoInfer<Context>> & AdapterFlagsParserValidation<NoInfer<Flags>>): AdapterImplementation<Context, undefined, Flags>;
-export declare function defineAdapter<Context extends object, Assertions extends object, Flags extends AdapterFlagsParser = undefined>(input: {
+export declare function defineAdapter<Context extends object, Assertions extends object, Flags extends AdapterFlagsParser = undefined, const Roles extends string = string>(input: {
     readonly name: string;
+    readonly requires?: ModelRequirements<Roles>;
     readonly behaviorRevision?: string;
     /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */
     readonly cleanupTimeoutMs?: number;
-    readonly create: AdapterFactory<Context, Flags>;
+    readonly create: (context: AdapterCreateContext<AdapterFlagsOutput<Flags>, NoInfer<Roles>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;
     readonly parseFlags?: Flags;
     /** Attempt-local Assertion sugar, assembled once after create() succeeds. */
     readonly assertions: AdapterAssertionsFactory<Context, Assertions>;

package/dist/adapter.d.mts

@@ -1,4 +1,4 @@
-import type { ResolvedModelSlots } from "./model-slots.mjs";
+import { type ModelRequirements, type ResolvedModelRole } from "./model-roles.mjs";
 import type { AttemptSignal } from "./shared/attempt-lifecycle.mjs";
 export type { AttemptCancellation, AttemptSignal } from "./shared/attempt-lifecycle.mjs";
 import type { MatchContext } from "./assertions/context-match.mjs";
@@ -37,7 +37,7 @@ type AdapterAssertionsFor<Assertions extends object | undefined, Kind extends Ev
     readonly [Key in keyof Assertions]: BoundAdapterAssertionMethod<Kind, Assertions[Key]>;
 } : {};
 /** Keys owned by the neutral Eval runtime or unsafe on a merged object root. */
-declare const RESERVED_ADAPTER_CONTEXT_KEYS: readonly ["evaluationKind", "check", "judge", "factuality", "faithfulness", "instructionFollowing", "pairwisePreference", "closeQA", "usage", "elapsedMs", "maxTokens", "maxCost", "score", "group", "skip", "signal", "model", "reasoningEffort", "flags", "progress", "diagnostic", "log", "then", "Object", "constructor", "__defineGetter__", "__defineSetter__", "hasOwnProperty", "__lookupGetter__", "__lookupSetter__", "isPrototypeOf", "propertyIsEnumerable", "toString", "valueOf", "__proto__", "toLocaleString"];
+declare const RESERVED_ADAPTER_CONTEXT_KEYS: readonly ["evaluationKind", "check", "judge", "factuality", "faithfulness", "instructionFollowing", "pairwisePreference", "closeQA", "usage", "elapsedMs", "maxTokens", "maxCost", "score", "group", "note", "skip", "signal", "model", "reasoningEffort", "flags", "progress", "diagnostic", "log", "then", "Object", "constructor", "__defineGetter__", "__defineSetter__", "hasOwnProperty", "__lookupGetter__", "__lookupSetter__", "isPrototypeOf", "propertyIsEnumerable", "toString", "valueOf", "__proto__", "toLocaleString"];
 export type ReservedAdapterContextKey = typeof RESERVED_ADAPTER_CONTEXT_KEYS[number];
 type InvalidContextBranch<Context> = Context extends unknown ? Context extends object ? Context extends readonly unknown[] ? Context : Context extends (...args: readonly never[]) => unknown ? Context : string extends keyof Context ? Context : Extract<keyof Context, ReservedAdapterContextKey> extends never ? never : Context : Context : never;
 type AdapterContextValidation<Context> = unknown extends Context ? unknown : [InvalidContextBranch<Context>] extends [never] ? unknown : {
@@ -62,10 +62,12 @@ export interface AdapterCleanupContext {
     /** 独立于执行信号；整个 Adapter 清理窗口截止时中止。 */
     readonly signal: AbortSignal;
 }
-export interface AdapterCreateContext<Flags = ExperimentFlags> {
+export interface AdapterCreateContext<Flags = ExperimentFlags, Roles extends string = string> {
     /** Frozen application model selections for this Attempt. */
-    readonly models: ResolvedModelSlots;
-    recordUsage(input: import("./adapter-usage.mjs").AdapterUsageInput): void;
+    readonly models: Readonly<Record<Roles, ResolvedModelRole>>;
+    recordUsage(input: Omit<import("./adapter-usage.mjs").AdapterUsageInput, "modelRole"> & {
+        readonly modelRole?: Roles | null;
+    }): void;
     /** Close application usage admission and declare whether the recorded collection is complete. */
     sealUsage(input: import("./adapter-usage.mjs").AdapterUsageSeal): void;
     attach(input: import("./adapter-attachments.mjs").AdapterAttachmentInput): Promise<import("./adapter-attachments.mjs").AdapterAttachmentReceipt>;
@@ -126,11 +128,17 @@ type AdapterScoreEvalFields = Omit<ScoreEvalInput<undefined>, "test" | "sandbox"
     readonly sandbox?: never;
     readonly diff?: never;
 };
-export type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterEvalFields & {
-    test(t: EvalContext<"pass", AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, "pass">): void | Promise<void>;
+export type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined, Roles extends string = string> = AdapterEvalFields & {
+    readonly requires?: ModelRequirements<Roles>;
+    test(t: Omit<EvalContext<"pass", AdapterFlagsOutput<Flags>, Context>, "usage"> & {
+        readonly usage: EvalUsage<NoInfer<Roles>>;
+    } & Readonly<Context> & AdapterAssertionsFor<Assertions, "pass">): void | Promise<void>;
 };
-export type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterScoreEvalFields & {
-    test(t: EvalContext<"score", AdapterFlagsOutput<Flags>, Context> & Readonly<Context> & AdapterAssertionsFor<Assertions, "score">): void | Promise<void>;
+export type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined, Roles extends string = string> = AdapterScoreEvalFields & {
+    readonly requires?: ModelRequirements<Roles>;
+    test(t: Omit<EvalContext<"score", AdapterFlagsOutput<Flags>, Context>, "usage"> & {
+        readonly usage: EvalUsage<NoInfer<Roles>>;
+    } & Readonly<Context> & AdapterAssertionsFor<Assertions, "score">): void | Promise<void>;
 };
 interface AdapterContractToken<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser = undefined> {
     readonly name: string;
@@ -152,13 +160,14 @@ export interface AdapterRuntimeEvalDefinition<Kind extends EvaluationKind> exten
 export interface AdapterDefinition<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> {
     readonly name: string;
     readonly parseFlags: Flags;
-    defineEval(input: AdapterEvalInput<Context, Assertions, Flags>): AdapterEvalDefinition<"pass", Context, Assertions, Flags>;
-    defineScoreEval(input: AdapterScoreEvalInput<Context, Assertions, Flags>): AdapterEvalDefinition<"score", Context, Assertions, Flags>;
+    defineEval<const Roles extends string = string>(input: AdapterEvalInput<Context, Assertions, Flags, Roles>): AdapterEvalDefinition<"pass", Context, Assertions, Flags>;
+    defineScoreEval<const Roles extends string = string>(input: AdapterScoreEvalInput<Context, Assertions, Flags, Roles>): AdapterEvalDefinition<"score", Context, Assertions, Flags>;
 }
 /** Existential runtime view used by Experiment without erasing a concrete context to `any`. */
 export interface AdapterRuntimeDefinition {
     readonly parseFlags?: Exclude<AdapterFlagsParser, undefined>;
     readonly kind: "custom";
+    readonly requiredModelRoles?: readonly string[];
     readonly name: string;
     readonly contract: string;
     readonly behaviorRevision: string | null;
@@ -195,21 +204,23 @@ export interface AdapterContract<Context extends object, Assertions extends obje
 }
 export type Adapter = import("./agents/types.mjs").Agent | AdapterRuntimeDefinition;
 /** Defines one Adapter implementation with an automatically private contract. */
-export declare function defineAdapter<Context extends object, Flags extends AdapterFlagsParser = undefined>(input: {
+export declare function defineAdapter<Context extends object, Flags extends AdapterFlagsParser = undefined, const Roles extends string = string>(input: {
     readonly name: string;
+    readonly requires?: ModelRequirements<Roles>;
     readonly behaviorRevision?: string;
     /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */
     readonly cleanupTimeoutMs?: number;
-    readonly create: AdapterFactory<Context, Flags>;
+    readonly create: (context: AdapterCreateContext<AdapterFlagsOutput<Flags>, NoInfer<Roles>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;
     readonly parseFlags?: Flags;
     readonly assertions?: undefined;
 } & AdapterContextValidation<NoInfer<Context>> & AdapterFlagsParserValidation<NoInfer<Flags>>): AdapterImplementation<Context, undefined, Flags>;
-export declare function defineAdapter<Context extends object, Assertions extends object, Flags extends AdapterFlagsParser = undefined>(input: {
+export declare function defineAdapter<Context extends object, Assertions extends object, Flags extends AdapterFlagsParser = undefined, const Roles extends string = string>(input: {
     readonly name: string;
+    readonly requires?: ModelRequirements<Roles>;
     readonly behaviorRevision?: string;
     /** Adapter 总清理预算，默认 30000 ms；允许整数 1–300000。 */
     readonly cleanupTimeoutMs?: number;
-    readonly create: AdapterFactory<Context, Flags>;
+    readonly create: (context: AdapterCreateContext<AdapterFlagsOutput<Flags>, NoInfer<Roles>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;
     readonly parseFlags?: Flags;
     /** Attempt-local Assertion sugar, assembled once after create() succeeds. */
     readonly assertions: AdapterAssertionsFactory<Context, Assertions>;