niceeval 0.15.0 → 0.15.1-canary.69

package/dist/adapter.cjs

@@ -6,6 +6,7 @@ exports.adapterIdentity = adapterIdentity;
 exports.adapterAcceptsEval = adapterAcceptsEval;
 exports.adapterContractRequiredByEval = adapterContractRequiredByEval;
 exports.bindAdapterEvalContext = bindAdapterEvalContext;
+const adapter_flags_ts_1 = require("./adapter-flags.cjs");
 const define_ts_1 = require("./define.cjs");
 const ADAPTER_CONTRACT_TOKEN = Symbol("niceeval.adapterContractToken");
 const EVAL_ADAPTER_CONTRACT_TOKEN = Symbol("niceeval.evalAdapterContractToken");
@@ -49,10 +50,11 @@ function assertNonEmptyString(value, field, factory) {
         throw new TypeError(`${factory} requires a non-empty ${field}.`);
     }
 }
-function contractToken(name, assertions) {
+function contractToken(name, assertions, parseFlags) {
     return Object.freeze({
         name,
         assertions,
+        parseFlags,
         assertionTypes: (value) => value,
         context: (value) => value,
     });
@@ -104,6 +106,7 @@ function implementAdapter(token, input, factory) {
     };
     return Object.freeze({
         kind: "custom",
+        parseFlags: token.parseFlags,
         name: input.name,
         contract: token.name,
         behaviorRevision: input.behaviorRevision ?? null,
@@ -113,30 +116,37 @@ function implementAdapter(token, input, factory) {
     });
 }
 function defineAdapter(input) {
+    if (input.parseFlags !== undefined)
+        (0, adapter_flags_ts_1.assertAdapterFlagsParser)(input.parseFlags);
     const assertions = input.assertions;
     if (assertions !== undefined && typeof assertions !== "function") {
         throw new TypeError("defineAdapter assertions must be a function.");
     }
-    return implementAdapter(contractToken(input.name, assertions), input, "defineAdapter");
+    return implementAdapter(contractToken(input.name, assertions, input.parseFlags), input, "defineAdapter");
 }
 /** Defines a reusable contract whose implementations and Evals share one runtime-only token. */
 function defineAdapterContract(input) {
     assertNonEmptyString(input.name, "name", "defineAdapterContract");
-    return makeAdapterContract(contractToken(input.name, undefined));
+    return makeAdapterContract(contractToken(input.name, undefined, undefined));
 }
 function makeAdapterContract(token) {
     const factories = boundEvalFactories(token);
     return Object.freeze({
         name: token.name,
+        parseFlags: token.parseFlags,
         ...factories,
         implement(implementation) {
             return implementAdapter(token, implementation, "AdapterContract.implement");
         },
+        withParseFlags(parseFlags, ..._validation) {
+            (0, adapter_flags_ts_1.assertAdapterFlagsParser)(parseFlags);
+            return makeAdapterContract(contractToken(token.name, token.assertions, parseFlags));
+        },
         withAssertions(factory, ..._validation) {
             if (typeof factory !== "function") {
                 throw new TypeError("AdapterContract.withAssertions requires a function.");
             }
-            return makeAdapterContract(contractToken(token.name, factory));
+            return makeAdapterContract(contractToken(token.name, factory, token.parseFlags));
         },
     });
 }

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 { 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, JsonValue, 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: Readonly<Context>;\n    readonly check: AssertionCheck<\"polymorphic\">;\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    \"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> = (context: AdapterCreateContext) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;\nexport interface AdapterCleanupContext {\n    /** 当前 Adapter cleanup 总窗口的取消信号。它独立于 Attempt signal，并在 30 秒总预算结束时取消。 */\n    readonly signal: AbortSignal;\n}\nexport interface AdapterCreateContext {\n    /** 当前 Eval 的公开 ID。 */\n    readonly evalId: string;\n    /** 当前 Experiment 的公开 ID。 */\n    readonly experimentId: string;\n    /** 当前 Attempt 的零起始序号。 */\n    readonly attempt: number;\n    /** Attempt 执行信号；取消或超时后会中止，不用于 cleanup 窗口。 */\n    readonly signal: AbortSignal;\n    /** Experiment 选择的模型。 */\n    readonly model?: string;\n    /** Experiment 选择的推理强度。 */\n    readonly reasoningEffort?: string;\n    /** Experiment 传给 Adapter 的只读 flags。 */\n    readonly flags: Readonly<Record<string, JsonValue>>;\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> = JudgePresetMethods<Kind> & {\n    readonly evaluationKind: Kind;\n    readonly signal: AbortSignal;\n    readonly model?: string;\n    readonly reasoningEffort?: string;\n    readonly flags: Readonly<Record<string, JsonValue>>;\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: AssertionsRuntime<Kind>[\"t\"][\"check\"];\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\"> = EvalContextBase<Kind> & (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> = AdapterEvalFields & {\n    test(t: EvalContext<\"pass\"> & Readonly<Context> & AdapterAssertionsFor<Assertions, \"pass\">): void | Promise<void>;\n};\nexport type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined> = AdapterScoreEvalFields & {\n    test(t: EvalContext<\"score\"> & Readonly<Context> & AdapterAssertionsFor<Assertions, \"score\">): void | Promise<void>;\n};\ninterface AdapterContractToken<Context extends object, Assertions extends object | undefined> {\n    readonly name: string;\n    readonly assertions: AdapterAssertionsFactory<Context> | undefined;\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> extends EvalDefinition<Kind, EvalContext<Kind> & Readonly<Context> & AdapterAssertionsFor<Assertions, Kind>, undefined> {\n    readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions>;\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> {\n    readonly name: string;\n    defineEval(input: AdapterEvalInput<Context, Assertions>): AdapterEvalDefinition<\"pass\", Context, Assertions>;\n    defineScoreEval(input: AdapterScoreEvalInput<Context, Assertions>): AdapterEvalDefinition<\"score\", Context, Assertions>;\n}\n/** Existential runtime view used by Experiment without erasing a concrete context to `any`. */\nexport interface AdapterRuntimeDefinition {\n    readonly kind: \"custom\";\n    readonly name: string;\n    readonly contract: string;\n    readonly behaviorRevision: string | null;\n    readonly [ADAPTER_CONTRACT_TOKEN]: object;\n    readonly defineEval: (...args: never[]) => unknown;\n    readonly defineScoreEval: (...args: never[]) => unknown;\n    create(context: AdapterCreateContext): object | Promise<object>;\n}\nexport interface AdapterImplementation<Context extends object, Assertions extends object | undefined = undefined> extends AdapterDefinition<Context, Assertions> {\n    readonly kind: \"custom\";\n    readonly contract: string;\n    readonly behaviorRevision: string | null;\n    readonly [ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions>;\n    create(context: AdapterCreateContext): Context | Promise<Context>;\n}\nexport type AdapterImplementationInput<Context extends object, ImplementationContext extends Context = Context> = {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    readonly create: AdapterFactory<ImplementationContext>;\n} & AdapterContextValidation<NoInfer<ImplementationContext>>;\nexport interface AdapterContract<Context extends object, Assertions extends object | undefined = undefined> extends AdapterDefinition<Context, Assertions> {\n    readonly name: string;\n    implement<ImplementationContext extends Context>(input: AdapterImplementationInput<Context, ImplementationContext>): AdapterImplementation<Context, Assertions>;\n    /**\n     * Returns a contract whose Eval factories and every implementation share\n     * this exact Assertion factory. Implementations cannot replace it.\n     */\n    withAssertions<NextAssertions extends object>(factory: AdapterAssertionsFactory<Context, NextAssertions>, ...validation: AdapterAssertionsValidationArgs<Context, NoInfer<NextAssertions>>): AdapterContract<Context, NextAssertions>;\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>(name: string, assertions: AdapterAssertionsFactory<Context> | undefined): AdapterContractToken<Context, Assertions> {\n    return Object.freeze({\n        name,\n        assertions,\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>(token: AdapterContractToken<Context, Assertions>): Pick<AdapterDefinition<Context, Assertions>, \"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>;\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>;\n        },\n    };\n}\nfunction implementAdapter<Context extends object, Assertions extends object | undefined>(token: AdapterContractToken<Context, Assertions>, input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    readonly create: AdapterFactory<Context>;\n}, factory: \"defineAdapter\" | \"AdapterContract.implement\"): AdapterImplementation<Context, Assertions> {\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 authorCreate = input.create;\n    const create = (context: AdapterCreateContext): 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        name: input.name,\n        contract: token.name,\n        behaviorRevision: input.behaviorRevision ?? null,\n        create,\n        [ADAPTER_CONTRACT_TOKEN]: token,\n        ...boundEvalFactories(token),\n    }) as AdapterImplementation<Context, Assertions>;\n}\n/** Defines one Adapter implementation with an automatically private contract. */\nexport function defineAdapter<Context extends object>(input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    readonly create: AdapterFactory<Context>;\n    readonly assertions?: undefined;\n} & AdapterContextValidation<NoInfer<Context>>): AdapterImplementation<Context>;\nexport function defineAdapter<Context extends object, Assertions extends object>(input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    readonly create: AdapterFactory<Context>;\n    /** Attempt-local Assertion sugar, assembled once after create() succeeds. */\n    readonly assertions: AdapterAssertionsFactory<Context, Assertions>;\n} & AdapterContextValidation<NoInfer<Context>> & AdapterAssertionsValidation<Context, NoInfer<Assertions>>): AdapterImplementation<Context, Assertions>;\nexport function defineAdapter(input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\n    readonly create: AdapterFactory<object>;\n    readonly assertions?: AdapterAssertionsFactory<object>;\n}): AdapterRuntimeDefinition {\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>(input.name, assertions), input, \"defineAdapter\");\n}\n/** Defines a reusable contract whose implementations and Evals share one runtime-only token. */\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>(input.name, undefined));\n}\nfunction makeAdapterContract<Context extends object, Assertions extends object | undefined>(token: AdapterContractToken<Context, Assertions>): AdapterContract<Context, Assertions> {\n    const factories = boundEvalFactories(token);\n    return Object.freeze({\n        name: token.name,\n        ...factories,\n        implement<ImplementationContext extends Context>(implementation: AdapterImplementationInput<Context, ImplementationContext>) {\n            return implementAdapter(token, implementation, \"AdapterContract.implement\");\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>(token.name, factory));\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        })\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({\n        app,\n        check: check as AssertionCheck<\"polymorphic\">,\n    });\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. */\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    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":";;AA6TA,sCAcC;AAED,sDAKC;AAuBD,0CAYC;AAED,gDASC;AAED,sEAMC;AAoKD,wDAmBC;AA9jBD,yDAA2L;AAG3L,2CAAmD;AAOnD,MAAM,sBAAsB,GAAkB,MAAM,CAAC,+BAA+B,CAAC,CAAC;AACtF,MAAM,2BAA2B,GAAkB,MAAM,CAAC,mCAAmC,CAAC,CAAC;AAsB/F,gFAAgF;AAChF,MAAM,6BAA6B,GAAG;IAClC,gBAAgB;IAChB,OAAO;IACP,OAAO;IACP,YAAY;IACZ,cAAc;IACd,sBAAsB;IACtB,oBAAoB;IACpB,SAAS;IACT,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;IACR,OAAO;IACP,iBAAiB;IACjB,OAAO;IACP,UAAU;IACV,YAAY;IACZ,KAAK;IACL,MAAM;IACN,QAAQ;IACR,aAAa;IACb,kBAAkB;IAClB,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,sBAAsB;IACtB,UAAU;IACV,SAAS;IACT,WAAW;IACX,gBAAgB;CACV,CAAC;AA4JX,SAAS,oBAAoB,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,SAAS,CAAC,GAAG,OAAO,yBAAyB,KAAK,GAAG,CAAC,CAAC;IACrE,CAAC;AACL,CAAC;AACD,SAAS,aAAa,CAAkG,IAAY,EAAE,UAAyD,EAAE,UAAiB;IAC9M,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI;QACJ,UAAU;QACV,UAAU;QACV,cAAc,EAAE,CAAC,KAAiB,EAAE,EAAE,CAAC,KAAK;QAC5C,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK;KACrC,CAAC,CAAC;AACP,CAAC;AACD,SAAS,sBAAsB,CAAC,KAG/B,EAAE,OAAyC;IACxC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CAAC,GAAG,OAAO,2CAA2C,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CAAC,GAAG,OAAO,sEAAsE,CAAC,CAAC;IAC1G,CAAC;AACL,CAAC;AACD,SAAS,kBAAkB,CAAkG,KAAuD;IAChL,OAAO;QACH,UAAU,CAAC,KAAK;YACZ,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YAC5C,OAAO,IAAA,gCAAoB,EAAC,MAAM,EAAE,KAAK,EAAE;gBACvC,CAAC,2BAA2B,CAAC,EAAE,KAAK;aACvC,CAA8D,CAAC;QACpE,CAAC;QACD,eAAe,CAAC,KAAK;YACjB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;YACjD,OAAO,IAAA,gCAAoB,EAAC,OAAO,EAAE,KAAK,EAAE;gBACxC,CAAC,2BAA2B,CAAC,EAAE,KAAK;aACvC,CAA+D,CAAC;QACrE,CAAC;KACJ,CAAC;AACN,CAAC;AACD,SAAS,gBAAgB,CAAkG,KAAuD,EAAE,KAInL,EAAE,OAAsD;IACrD,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACvC,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACrC,MAAM,IAAI,SAAS,CAAC,GAAG,OAAO,4BAA4B,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,OAAwD,EAA8B,EAAE;QACpG,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC1B,yBAAyB,CAAC,KAAK,CAAC,CAAC;gBACjC,OAAO,KAAK,CAAC;YACjB,CAAC,CAAC,CAAC;QACP,CAAC;QACD,kFAAkF;QAClF,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IACnB,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,IAAI;QACpB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,IAAI;QAChD,MAAM;QACN,CAAC,sBAAsB,CAAC,EAAE,KAAK;QAC/B,GAAG,kBAAkB,CAAC,KAAK,CAAC;KAC/B,CAAsD,CAAC;AAC5D,CAAC;AAiBD,SAAgB,aAAa,CAAC,KAM7B;IACG,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAC9B,IAAA,2CAAwB,EAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACpC,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;QAC/D,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,gBAAgB,CAAC,aAAa,CAAiD,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;AAC7J,CAAC;AACD,gGAAgG;AAChG,SAAgB,qBAAqB,CAAyB,KAEhB;IAC1C,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAClE,OAAO,mBAAmB,CAAC,aAAa,CAAgC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC/G,CAAC;AACD,SAAS,mBAAmB,CAAkG,KAAuD;IACjL,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,GAAG,SAAS;QACZ,SAAS,CAAwC,cAAiF;YAC9H,OAAO,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,2BAA2B,CAAC,CAAC;QAChF,CAAC;QACD,cAAc,CAA2D,UAAqB,EAAE,GAAG,WAAiE;YAChK,IAAA,2CAAwB,EAAC,UAAU,CAAC,CAAC;YACrC,OAAO,mBAAmB,CAAC,aAAa,CAAiC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;QACxH,CAAC;QACD,cAAc,CAAgC,OAA0D,EAAE,GAAG,WAA8E;YACvL,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAChC,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,mBAAmB,CAAC,aAAa,CAAiC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACrH,CAAC;KACJ,CAAC,CAAC;AACP,CAAC;AACD,wEAAwE;AACxE,SAAgB,eAAe,CAAC,OAAgB;IAC5C,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC7C,CAAC;QACF,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,mBAAmB;YAC7B,gBAAgB,EAAE,IAAI;SACzB,CAAC,CAAC;AACX,CAAC;AACD,qFAAqF;AACrF,SAAgB,kBAAkB,CAAC,OAAgB,EAAE,UAAkB;IACnE,MAAM,QAAQ,GAAI,UAEhB,CAAC,2BAA2B,CAAC,CAAC;IAChC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACjD,OAAO,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,CAAC;IACrF,CAAC;IACD,OAAO,QAAQ,KAAK,SAAS,CAAC;AAClC,CAAC;AACD,wFAAwF;AACxF,SAAgB,6BAA6B,CAAC,UAAkB;IAC5D,OAAQ,UAIN,CAAC,2BAA2B,CAAC,EAAE,IAAI,CAAC;AAC1C,CAAC;AACD,MAAM,gCAAgC,GAAwB,IAAI,GAAG,CAAC,6BAA6B,CAAC,CAAC;AACrG,SAAS,yBAAyB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACzF,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,gCAAgC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,SAAS,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnF,CAAC;IACL,CAAC;AACL,CAAC;AACD,SAAS,iBAAiB,CAAC,MAAc,EAAE,MAAc,EAAE,WAAoB,EAAE,gBAA4B;IACzG,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChE,IAAI,UAAU,KAAK,SAAS;YACxB,SAAS;QACb,IAAI,OAAO,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAClE,MAAM,MAAM,GAAG,WAAW;gBACtB,CAAC,CAAC,UAAyB,GAAG,IAAwB;oBAClD,gBAAgB,EAAE,CAAC;oBACnB,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;gBACzD,CAAC;gBACD,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,KAAK;gBACnB,QAAQ,EAAE,KAAK;gBACf,KAAK,EAAE,MAAM;aAChB,CAAC,CAAC;QACP,CAAC;aACI,CAAC;YACF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,KAAK;gBACnB,GAAG,EAAE,GAAG,EAAE;oBACN,IAAI,WAAW;wBACX,gBAAgB,EAAE,CAAC;oBACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;oBAC/C,IAAI,OAAO,KAAK,KAAK,UAAU;wBAC3B,OAAO,KAAK,CAAC;oBACjB,OAAO,WAAW;wBACd,CAAC,CAAC,CAAC,GAAG,IAAwB,EAAE,EAAE;4BAC9B,gBAAgB,EAAE,CAAC;4BACnB,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;wBAC9C,CAAC;wBACD,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC;aACJ,CAAC,CAAC;QACP,CAAC;IACL,CAAC;AACL,CAAC;AACD,2FAA2F;AAC3F,SAAS,6BAA6B,CAAC,KAAc;IACjD,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,IAAI,KAAK,KAAK,IAAI;QAC5E,OAAO,KAAK,CAAC;IACjB,IAAI,CAAC;QACD,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE;YAC9C,SAAS;YACT,GAAG,EAAE,CAAC,SAAS;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,CAAC;QACH,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AACD,SAAS,4BAA4B,CAAC,KAAc,EAAE,OAAe;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CAAC,mEAAmE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvD,6BAA6B,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,IAAI,SAAS,CAAC,kEAAkE,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,gCAAgC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,SAAS,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9G,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACjG,MAAM,IAAI,SAAS,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAChG,CAAC;IACL,CAAC;AACL,CAAC;AACD,SAAS,qBAAqB,CAAU,OAAgB,EAAE,aAAyB;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAW,CAAC;IAC7C,iBAAiB,CAAC,MAAM,EAAE,OAAiB,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAsB,CAAC;AACtD,CAAC;AACD,SAAS,qBAAqB,CAAsD,IAAuB,EAAE,OAAgB,EAAE,OAA0C,EAAE,gBAA4B;IAInM,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,aAAa,GAAG,GAAS,EAAE;QAC7B,gBAAgB,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,SAAS,CAAC,oFAAoF,CAAC,CAAC;QAC9G,CAAC;IACL,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,qBAAqB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC1D,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAwB,EAAW,EAAE;QACnD,gBAAgB,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,0EAA0E,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClF,MAAM,IAAI,SAAS,CAAC,4DAA4D,CAAC,CAAC;QACtF,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC;QACrB,GAAG;QACH,KAAK,EAAE,KAAsC;KAChD,CAAC,CAAC;IACH,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxB,SAAS,GAAG,IAAI,CAAC;IACjB,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAW,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAE,CAAC;QACnE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAiD,CAAC;QAC5E,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE;YACnC,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,KAAK;YACnB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,CAAC,GAAG,IAAwB,EAAE,EAAE;gBACnC,gBAAgB,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,IAAI,OAAO,EAAU,CAAC;gBACpC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzB,IAAI,CAAC;oBACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;oBACrD,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;wBACxG,6BAA6B,CAAC,MAAM,CAAC,CAAC;wBACtC,MAAM,IAAI,SAAS,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;oBACtH,CAAC;oBACD,OAAO,MAAM,CAAC;gBAClB,CAAC;wBACO,CAAC;oBACL,YAAY,CAAC,GAAG,EAAE,CAAC;gBACvB,CAAC;YACL,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AACzE,CAAC;AACD,wEAAwE;AACxE,SAAgB,sBAAsB,CAAuC,IAAuB,EAAE,OAAgB,EAAE,OAAiC,EAAE,gBAA4B;IACnL,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,sBAAsB,CAA+D,CAAC;IAC5G,IAAI,GAAsB,CAAC;IAC3B,IAAI,UAA8B,CAAC;IACnC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACjC,GAAG,GAAG,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAC3D,CAAC;SACI,CAAC;QACF,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACvF,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAChB,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAW,CAAC;IAC7C,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACzD,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACxD,IAAI,UAAU,KAAK,SAAS;QACxB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAA0C,CAAC;AAC1E,CAAC","sourcesContent":["import 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: Readonly<Context>;\n    readonly check: AssertionCheck<\"polymorphic\">;\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    \"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    /** 当前 Adapter cleanup 总窗口的取消信号。它独立于 Attempt signal，并在 30 秒总预算结束时取消。 */\n    readonly signal: AbortSignal;\n}\nexport interface AdapterCreateContext<Flags = ExperimentFlags> {\n    recordUsage(input: import(\"./adapter-usage.ts\").AdapterUsageInput): 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 执行信号；取消或超时后会中止，不用于 cleanup 窗口。 */\n    readonly signal: AbortSignal;\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> = JudgePresetMethods<Kind> & {\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: AssertionsRuntime<Kind>[\"t\"][\"check\"];\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> = EvalContextBase<Kind, Flags> & (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>> & 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>> & 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>> & 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 [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 [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    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    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 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        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    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    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>;\nexport function defineAdapter(input: {\n    readonly name: string;\n    readonly behaviorRevision?: string;\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. */\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        })\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({\n        app,\n        check: check as AssertionCheck<\"polymorphic\">,\n    });\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. */\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    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,9 +1,11 @@
+import type { ExperimentFlags } from "./shared/types.cjs";
+import { type AdapterFlagsParser, type AdapterFlagsOutput, type AdapterFlagsParserValidation, type AdapterFlagsParserValidationArgs } from "./adapter-flags.cjs";
 import type { AssertionCheck, AssertionSubject, AssertionsRuntime, BooleanAssertionHandle, MeasurementAssertionHandle, PolymorphicBooleanAssertionHandle, PolymorphicMeasurementAssertionHandle } from "./assertions/api.cjs";
 import type { ScoreMatch } from "./assertions/match.cjs";
 import type { EvalDefinition, EvalInput, ScoreEvalInput } from "./runner/types.cjs";
 import type { EvaluationKind } from "./shared/evaluation.cjs";
 import type { JudgePresetMethods } from "./context/assert-first.cjs";
-import type { DiagnosticInput, JsonValue, ProgressUpdate } from "./shared/types.cjs";
+import type { DiagnosticInput, ProgressUpdate } from "./shared/types.cjs";
 import type { AdapterIdentity } from "./record/model/run-context.cjs";
 export type { AdapterIdentity } from "./record/model/run-context.cjs";
 declare const ADAPTER_CONTRACT_TOKEN: unique symbol;
@@ -46,12 +48,15 @@ type AdapterAssertionsValidation<Context extends object, Assertions extends obje
 type AdapterAssertionsValidationArgs<Context extends object, Assertions extends object> = [InvalidAdapterAssertions<Context, Assertions>] extends [never] ? [] : [error: {
     readonly invalidAdapterAssertions: InvalidAdapterAssertions<Context, Assertions>;
 }];
-type AdapterFactory<Context extends object> = (context: AdapterCreateContext) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;
+type AdapterFactory<Context extends object, Flags extends AdapterFlagsParser = undefined> = (context: AdapterCreateContext<AdapterFlagsOutput<Flags>>) => (Context & ThisType<Context>) | Promise<Context & ThisType<Context>>;
 export interface AdapterCleanupContext {
     /** 当前 Adapter cleanup 总窗口的取消信号。它独立于 Attempt signal，并在 30 秒总预算结束时取消。 */
     readonly signal: AbortSignal;
 }
-export interface AdapterCreateContext {
+export interface AdapterCreateContext<Flags = ExperimentFlags> {
+    recordUsage(input: import("./adapter-usage.cjs").AdapterUsageInput): void;
+    attach(input: import("./adapter-attachments.cjs").AdapterAttachmentInput): Promise<import("./adapter-attachments.cjs").AdapterAttachmentReceipt>;
+    recordTrace<Event extends import("./adapter-execution-trace.cjs").ExecutionTraceEvent>(input: import("./adapter-execution-trace.cjs").ExecutionTraceInput<Event>): Promise<import("./adapter-execution-trace.cjs").ExecutionTraceReceipt>;
     /** 当前 Eval 的公开 ID。 */
     readonly evalId: string;
     /** 当前 Experiment 的公开 ID。 */
@@ -65,7 +70,7 @@ export interface AdapterCreateContext {
     /** Experiment 选择的推理强度。 */
     readonly reasoningEffort?: string;
     /** Experiment 传给 Adapter 的只读 flags。 */
-    readonly flags: Readonly<Record<string, JsonValue>>;
+    readonly flags: Flags;
     /** 更新当前 Attempt 的人读进度。 */
     progress(update: ProgressUpdate): void;
     /** 为当前 Attempt 追加结构化诊断。 */
@@ -78,12 +83,12 @@ export interface AdapterCreateContext {
      */
     onCleanup(cleanup: (context: AdapterCleanupContext) => void | Promise<void>): void;
 }
-type EvalContextBase<Kind extends EvaluationKind> = JudgePresetMethods<Kind> & {
+type EvalContextBase<Kind extends EvaluationKind, Flags> = JudgePresetMethods<Kind> & {
     readonly evaluationKind: Kind;
     readonly signal: AbortSignal;
     readonly model?: string;
     readonly reasoningEffort?: string;
-    readonly flags: Readonly<Record<string, JsonValue>>;
+    readonly flags: Flags;
     progress(update: ProgressUpdate): void;
     diagnostic(input: DiagnosticInput): void;
     log(message: string): void;
@@ -93,7 +98,7 @@ type EvalContextBase<Kind extends EvaluationKind> = JudgePresetMethods<Kind> & {
     readonly judge: <Value>(value: AssertionSubject<Value>, definition: ScoreMatch<NoInfer<Value>>) => MeasurementAssertionHandle<Kind>;
 };
 /** Agent-neutral author context shared by every Adapter Eval. */
-export type EvalContext<Kind extends EvaluationKind = "pass"> = EvalContextBase<Kind> & (Kind extends "score" ? {
+export type EvalContext<Kind extends EvaluationKind = "pass", Flags = ExperimentFlags> = EvalContextBase<Kind, Flags> & (Kind extends "score" ? {
     readonly score: AssertionsRuntime<"score">["t"]["score"];
 } : {});
 type AdapterEvalFields = Omit<EvalInput<undefined>, "test" | "sandbox" | "diff"> & {
@@ -104,35 +109,38 @@ type AdapterScoreEvalFields = Omit<ScoreEvalInput<undefined>, "test" | "sandbox"
     readonly sandbox?: never;
     readonly diff?: never;
 };
-export type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined> = AdapterEvalFields & {
-    test(t: EvalContext<"pass"> & Readonly<Context> & AdapterAssertionsFor<Assertions, "pass">): void | Promise<void>;
+export type AdapterEvalInput<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> = AdapterEvalFields & {
+    test(t: EvalContext<"pass", AdapterFlagsOutput<Flags>> & Readonly<Context> & AdapterAssertionsFor<Assertions, "pass">): void | Promise<void>;
 };
-export type AdapterScoreEvalInput<Context extends object, Assertions extends object | undefined = undefined> = AdapterScoreEvalFields & {
-    test(t: EvalContext<"score"> & Readonly<Context> & AdapterAssertionsFor<Assertions, "score">): 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>> & Readonly<Context> & AdapterAssertionsFor<Assertions, "score">): void | Promise<void>;
 };
-interface AdapterContractToken<Context extends object, Assertions extends object | undefined> {
+interface AdapterContractToken<Context extends object, Assertions extends object | undefined, Flags extends AdapterFlagsParser = undefined> {
     readonly name: string;
     readonly assertions: AdapterAssertionsFactory<Context> | undefined;
+    readonly parseFlags: Flags;
     /** Keeps the Assertion method shape invariant without exposing a constructible brand. */
     readonly assertionTypes: (value: Assertions) => Assertions;
     /** Keeps the context parameter invariant without exposing a constructible brand. */
     readonly context: (value: Context) => Context;
 }
-export interface AdapterEvalDefinition<Kind extends EvaluationKind, Context extends object, Assertions extends object | undefined = undefined> extends EvalDefinition<Kind, EvalContext<Kind> & Readonly<Context> & AdapterAssertionsFor<Assertions, Kind>, undefined> {
-    readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions>;
+export interface AdapterEvalDefinition<Kind extends EvaluationKind, Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends EvalDefinition<Kind, EvalContext<Kind, AdapterFlagsOutput<Flags>> & Readonly<Context> & AdapterAssertionsFor<Assertions, Kind>, undefined> {
+    readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions, Flags>;
 }
 /** @internal Existential discovery view; concrete bound factories retain their exact Context. */
 export interface AdapterRuntimeEvalDefinition<Kind extends EvaluationKind> extends EvalDefinition<Kind, never, undefined> {
     readonly [EVAL_ADAPTER_CONTRACT_TOKEN]: object;
 }
 /** Common public surface for an Adapter definition with bound Eval factories. */
-export interface AdapterDefinition<Context extends object, Assertions extends object | undefined = undefined> {
+export interface AdapterDefinition<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> {
     readonly name: string;
-    defineEval(input: AdapterEvalInput<Context, Assertions>): AdapterEvalDefinition<"pass", Context, Assertions>;
-    defineScoreEval(input: AdapterScoreEvalInput<Context, Assertions>): AdapterEvalDefinition<"score", Context, Assertions>;
+    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>;
 }
 /** 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 name: string;
     readonly contract: string;
@@ -140,44 +148,47 @@ export interface AdapterRuntimeDefinition {
     readonly [ADAPTER_CONTRACT_TOKEN]: object;
     readonly defineEval: (...args: never[]) => unknown;
     readonly defineScoreEval: (...args: never[]) => unknown;
-    create(context: AdapterCreateContext): object | Promise<object>;
+    create(context: AdapterCreateContext<unknown>): object | Promise<object>;
 }
-export interface AdapterImplementation<Context extends object, Assertions extends object | undefined = undefined> extends AdapterDefinition<Context, Assertions> {
+export interface AdapterImplementation<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends AdapterDefinition<Context, Assertions, Flags> {
     readonly kind: "custom";
     readonly contract: string;
     readonly behaviorRevision: string | null;
-    readonly [ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions>;
-    create(context: AdapterCreateContext): Context | Promise<Context>;
+    readonly [ADAPTER_CONTRACT_TOKEN]: AdapterContractToken<Context, Assertions, Flags>;
+    create(context: AdapterCreateContext<AdapterFlagsOutput<Flags>>): Context | Promise<Context>;
 }
-export type AdapterImplementationInput<Context extends object, ImplementationContext extends Context = Context> = {
+export type AdapterImplementationInput<Context extends object, ImplementationContext extends Context = Context, Flags extends AdapterFlagsParser = undefined> = {
     readonly name: string;
     readonly behaviorRevision?: string;
-    readonly create: AdapterFactory<ImplementationContext>;
+    readonly create: AdapterFactory<ImplementationContext, Flags>;
 } & AdapterContextValidation<NoInfer<ImplementationContext>>;
-export interface AdapterContract<Context extends object, Assertions extends object | undefined = undefined> extends AdapterDefinition<Context, Assertions> {
+export interface AdapterContract<Context extends object, Assertions extends object | undefined = undefined, Flags extends AdapterFlagsParser = undefined> extends AdapterDefinition<Context, Assertions, Flags> {
     readonly name: string;
-    implement<ImplementationContext extends Context>(input: AdapterImplementationInput<Context, ImplementationContext>): AdapterImplementation<Context, Assertions>;
+    implement<ImplementationContext extends Context>(input: AdapterImplementationInput<Context, ImplementationContext, Flags>): AdapterImplementation<Context, Assertions, Flags>;
     /**
-     * Returns a contract whose Eval factories and every implementation share
-     * this exact Assertion factory. Implementations cannot replace it.
+     * Returns a contract whose Eval factories and implementations share one flags parser.
      */
-    withAssertions<NextAssertions extends object>(factory: AdapterAssertionsFactory<Context, NextAssertions>, ...validation: AdapterAssertionsValidationArgs<Context, NoInfer<NextAssertions>>): AdapterContract<Context, NextAssertions>;
+    withParseFlags<NextFlags extends Exclude<AdapterFlagsParser, undefined>>(parseFlags: NextFlags, ...validation: AdapterFlagsParserValidationArgs<NoInfer<NextFlags>>): AdapterContract<Context, Assertions, NextFlags>;
+    /** Returns a contract whose implementations share this exact Assertion factory. */
+    withAssertions<NextAssertions extends object>(factory: AdapterAssertionsFactory<Context, NextAssertions>, ...validation: AdapterAssertionsValidationArgs<Context, NoInfer<NextAssertions>>): AdapterContract<Context, NextAssertions, Flags>;
 }
 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>(input: {
+export declare function defineAdapter<Context extends object, Flags extends AdapterFlagsParser = undefined>(input: {
     readonly name: string;
     readonly behaviorRevision?: string;
-    readonly create: AdapterFactory<Context>;
+    readonly create: AdapterFactory<Context, Flags>;
+    readonly parseFlags?: Flags;
     readonly assertions?: undefined;
-} & AdapterContextValidation<NoInfer<Context>>): AdapterImplementation<Context>;
-export declare function defineAdapter<Context extends object, Assertions extends object>(input: {
+} & 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: {
     readonly name: string;
     readonly behaviorRevision?: string;
-    readonly create: AdapterFactory<Context>;
+    readonly create: AdapterFactory<Context, Flags>;
+    readonly parseFlags?: Flags;
     /** Attempt-local Assertion sugar, assembled once after create() succeeds. */
     readonly assertions: AdapterAssertionsFactory<Context, Assertions>;
-} & AdapterContextValidation<NoInfer<Context>> & AdapterAssertionsValidation<Context, NoInfer<Assertions>>): AdapterImplementation<Context, Assertions>;
+} & AdapterContextValidation<NoInfer<Context>> & AdapterFlagsParserValidation<NoInfer<Flags>> & AdapterAssertionsValidation<Context, NoInfer<Assertions>>): AdapterImplementation<Context, Assertions, Flags>;
 /** Defines a reusable contract whose implementations and Evals share one runtime-only token. */
 export declare function defineAdapterContract<Context extends object>(input: {
     readonly name: string;