niceeval 0.12.2-canary.31 → 0.13.0

package/dist/eval/record/verdict.d.mts

@@ -1,60 +1,47 @@
 import { Schema } from "effect";
-import { type RecordAttachmentValue, type RecordAttachmentWrite } from "../../record/attachment/index.mjs";
-import { type RecordAttachmentProjector } from "../../projection/projector.mjs";
+import type { AssertionsAttachment } from "../../record/family/assertions.mjs";
+import type { AttemptOutcome } from "../../record/model/core.mjs";
 import type { Verdict } from "../../shared/types.mjs";
-import { type EvaluationAttemptFactsV1 } from "./sealed-assertion.mjs";
-export declare const VERDICT_ATTACHMENT_NAME_V1: "niceeval.verdict";
-export declare const VERDICT_ATTACHMENT_SCHEMA_ID_V1: "niceeval.verdict/v1";
-export declare const VerdictStateV1Schema: Schema.Literal<["passed", "failed", "errored", "skipped"]>;
-export type VerdictStateV1 = Schema.Schema.Type<typeof VerdictStateV1Schema>;
-/** The durable Verdict fact deliberately contains no Assertions, diagnostics, or score. */
-export declare const VerdictPayloadV1Schema: Schema.Struct<{
-    state: Schema.Literal<["passed", "failed", "errored", "skipped"]>;
-}>;
-export type VerdictPayloadV1 = Schema.Schema.Type<typeof VerdictPayloadV1Schema>;
-export type VerdictPayloadV1Encoded = Schema.Schema.Encoded<typeof VerdictPayloadV1Schema>;
-/** The built-in Attempt Attachment definition owns exact decode and closure. */
-export declare const verdictAttachmentDefinitionV1: import("../../record/attachment/types.mjs").JsonRecordAttachmentDefinition<"attempt", {
-    readonly state: "skipped" | "failed" | "errored" | "passed";
-}>;
-export declare const verdictAttachmentFamilyV1: import("../../record/attachment/types.mjs").RecordAttachmentFamily<"attempt", {
-    readonly state: "skipped" | "failed" | "errored" | "passed";
-}>;
-export declare function decodeVerdictPayloadV1(input: unknown): import("effect/Either").Either<{
-    readonly state: "skipped" | "failed" | "errored" | "passed";
-}, import("../../record/attachment/errors.mjs").RecordAttachmentPayloadInvalid>;
+import { type EvaluationAttemptFacts } from "./sealed-assertion.mjs";
 /**
- * The pure fold takes the shared sealed producer facts. It never receives a
- * Score payload, so score and Verdict cannot accidentally derive one another.
+ * A transient fold result. Verdict is derived from sealed Assertion facts and
+ * Attempt outcome; it is deliberately not a Record Attachment family.
  */
-export type VerdictFoldInputV1 = EvaluationAttemptFactsV1;
-export declare const VerdictFoldInputV1Schema: Schema.Struct<{
+export declare const VerdictStateSchema: Schema.Literal<["passed", "failed", "errored", "skipped"]>;
+export type VerdictState = Schema.Schema.Type<typeof VerdictStateSchema>;
+export declare const VerdictPayloadSchema: Schema.Struct<{
+    state: Schema.Literal<["passed", "failed", "errored", "skipped"]>;
+}>;
+export type VerdictPayload = Schema.Schema.Type<typeof VerdictPayloadSchema>;
+export type VerdictPayloadEncoded = Schema.Schema.Encoded<typeof VerdictPayloadSchema>;
+export type VerdictFoldInput = EvaluationAttemptFacts;
+export declare const VerdictFoldInputSchema: Schema.Struct<{
     execution: Schema.Literal<["completed", "errored"]>;
     explicitlySkipped: typeof Schema.Boolean;
     assertions: Schema.Array$<Schema.Struct<{
         required: typeof Schema.Boolean;
-        result: Schema.Schema<import("./sealed-assertion.mjs").SealedAssertionResultV1, import("./sealed-assertion.mjs").SealedAssertionResultV1, never>;
+        result: Schema.Schema<import("./sealed-assertion.mjs").SealedAssertionResult, import("./sealed-assertion.mjs").SealedAssertionResult, never>;
     }>>;
 }>;
-export declare function foldVerdictV1(input: VerdictFoldInputV1): VerdictStateV1;
-export declare function buildVerdictPayloadV1(input: VerdictFoldInputV1): VerdictPayloadV1;
-/** Wraps an already validated durable Verdict payload in its Attempt Attachment. */
-export declare function createVerdictAttachmentWriteV1(payload: VerdictPayloadV1): RecordAttachmentWrite<"attempt", never, never>;
-/** Builds the real Attempt-owned write without embedding Score or diagnostics. */
-export declare function buildVerdictAttachmentWriteV1(input: VerdictFoldInputV1): RecordAttachmentWrite<"attempt", never, never>;
-export type VerdictCoherenceIssueV1 = {
+export declare function foldVerdict(input: VerdictFoldInput): VerdictState;
+/**
+ * Folds the public Verdict from the immutable Attempt outcome and verified
+ * Assertions payload.  This is the one adapter from Record's terminal Core
+ * state into the verdict fold; consumers must not reproduce these rules.
+ */
+export declare function foldRecordedAttemptVerdict(input: {
+    readonly outcome: AttemptOutcome;
+    readonly assertions: AssertionsAttachment;
+}): VerdictState;
+export declare function buildVerdictPayload(input: VerdictFoldInput): VerdictPayload;
+export type VerdictCoherenceIssue = {
     readonly code: "verdict-fold-mismatch";
-    readonly expected: VerdictStateV1;
-    readonly actual: VerdictStateV1;
+    readonly expected: VerdictState;
+    readonly actual: VerdictState;
 };
-/** Confirms a producer persisted the Verdict demanded by sealed facts. */
-export declare function validateVerdictCoherenceV1(input: {
-    readonly payload: VerdictPayloadV1;
-    readonly fold: VerdictFoldInputV1;
-}): readonly VerdictCoherenceIssueV1[];
-/** A projector needs only the already-decoded exact Verdict state. */
-export declare function projectVerdictPayloadV1(payload: VerdictPayloadV1): Verdict;
-/** Internal current-family interpretation used by the Evaluation producer. */
-export declare function projectVerdictAttachmentV1(value: RecordAttachmentValue<VerdictPayloadV1>): Verdict;
-/** The public four-state Verdict view for an Attempt-owned Attachment. */
-export declare const verdictProjector: RecordAttachmentProjector<"attempt", Verdict>;
+export declare function validateVerdictCoherence(input: {
+    readonly payload: VerdictPayload;
+    readonly fold: VerdictFoldInput;
+}): readonly VerdictCoherenceIssue[];
+/** Plain domain projection for callers that need NiceEval's public verdict. */
+export declare function projectVerdictPayload(payload: VerdictPayload): Verdict;

package/dist/eval/record/verdict.d.ts

@@ -1,60 +1,47 @@
 import { Schema } from "effect";
-import { type RecordAttachmentValue, type RecordAttachmentWrite } from "../../record/attachment/index.js";
-import { type RecordAttachmentProjector } from "../../projection/projector.js";
+import type { AssertionsAttachment } from "../../record/family/assertions.js";
+import type { AttemptOutcome } from "../../record/model/core.js";
 import type { Verdict } from "../../shared/types.js";
-import { type EvaluationAttemptFactsV1 } from "./sealed-assertion.js";
-export declare const VERDICT_ATTACHMENT_NAME_V1: "niceeval.verdict";
-export declare const VERDICT_ATTACHMENT_SCHEMA_ID_V1: "niceeval.verdict/v1";
-export declare const VerdictStateV1Schema: Schema.Literal<["passed", "failed", "errored", "skipped"]>;
-export type VerdictStateV1 = Schema.Schema.Type<typeof VerdictStateV1Schema>;
-/** The durable Verdict fact deliberately contains no Assertions, diagnostics, or score. */
-export declare const VerdictPayloadV1Schema: Schema.Struct<{
-    state: Schema.Literal<["passed", "failed", "errored", "skipped"]>;
-}>;
-export type VerdictPayloadV1 = Schema.Schema.Type<typeof VerdictPayloadV1Schema>;
-export type VerdictPayloadV1Encoded = Schema.Schema.Encoded<typeof VerdictPayloadV1Schema>;
-/** The built-in Attempt Attachment definition owns exact decode and closure. */
-export declare const verdictAttachmentDefinitionV1: import("../../record/attachment/types.js").JsonRecordAttachmentDefinition<"attempt", {
-    readonly state: "skipped" | "failed" | "errored" | "passed";
-}>;
-export declare const verdictAttachmentFamilyV1: import("../../record/attachment/types.js").RecordAttachmentFamily<"attempt", {
-    readonly state: "skipped" | "failed" | "errored" | "passed";
-}>;
-export declare function decodeVerdictPayloadV1(input: unknown): import("effect/Either").Either<{
-    readonly state: "skipped" | "failed" | "errored" | "passed";
-}, import("../../record/attachment/errors.js").RecordAttachmentPayloadInvalid>;
+import { type EvaluationAttemptFacts } from "./sealed-assertion.js";
 /**
- * The pure fold takes the shared sealed producer facts. It never receives a
- * Score payload, so score and Verdict cannot accidentally derive one another.
+ * A transient fold result. Verdict is derived from sealed Assertion facts and
+ * Attempt outcome; it is deliberately not a Record Attachment family.
  */
-export type VerdictFoldInputV1 = EvaluationAttemptFactsV1;
-export declare const VerdictFoldInputV1Schema: Schema.Struct<{
+export declare const VerdictStateSchema: Schema.Literal<["passed", "failed", "errored", "skipped"]>;
+export type VerdictState = Schema.Schema.Type<typeof VerdictStateSchema>;
+export declare const VerdictPayloadSchema: Schema.Struct<{
+    state: Schema.Literal<["passed", "failed", "errored", "skipped"]>;
+}>;
+export type VerdictPayload = Schema.Schema.Type<typeof VerdictPayloadSchema>;
+export type VerdictPayloadEncoded = Schema.Schema.Encoded<typeof VerdictPayloadSchema>;
+export type VerdictFoldInput = EvaluationAttemptFacts;
+export declare const VerdictFoldInputSchema: Schema.Struct<{
     execution: Schema.Literal<["completed", "errored"]>;
     explicitlySkipped: typeof Schema.Boolean;
     assertions: Schema.Array$<Schema.Struct<{
         required: typeof Schema.Boolean;
-        result: Schema.Schema<import("./sealed-assertion.js").SealedAssertionResultV1, import("./sealed-assertion.js").SealedAssertionResultV1, never>;
+        result: Schema.Schema<import("./sealed-assertion.js").SealedAssertionResult, import("./sealed-assertion.js").SealedAssertionResult, never>;
     }>>;
 }>;
-export declare function foldVerdictV1(input: VerdictFoldInputV1): VerdictStateV1;
-export declare function buildVerdictPayloadV1(input: VerdictFoldInputV1): VerdictPayloadV1;
-/** Wraps an already validated durable Verdict payload in its Attempt Attachment. */
-export declare function createVerdictAttachmentWriteV1(payload: VerdictPayloadV1): RecordAttachmentWrite<"attempt", never, never>;
-/** Builds the real Attempt-owned write without embedding Score or diagnostics. */
-export declare function buildVerdictAttachmentWriteV1(input: VerdictFoldInputV1): RecordAttachmentWrite<"attempt", never, never>;
-export type VerdictCoherenceIssueV1 = {
+export declare function foldVerdict(input: VerdictFoldInput): VerdictState;
+/**
+ * Folds the public Verdict from the immutable Attempt outcome and verified
+ * Assertions payload.  This is the one adapter from Record's terminal Core
+ * state into the verdict fold; consumers must not reproduce these rules.
+ */
+export declare function foldRecordedAttemptVerdict(input: {
+    readonly outcome: AttemptOutcome;
+    readonly assertions: AssertionsAttachment;
+}): VerdictState;
+export declare function buildVerdictPayload(input: VerdictFoldInput): VerdictPayload;
+export type VerdictCoherenceIssue = {
     readonly code: "verdict-fold-mismatch";
-    readonly expected: VerdictStateV1;
-    readonly actual: VerdictStateV1;
+    readonly expected: VerdictState;
+    readonly actual: VerdictState;
 };
-/** Confirms a producer persisted the Verdict demanded by sealed facts. */
-export declare function validateVerdictCoherenceV1(input: {
-    readonly payload: VerdictPayloadV1;
-    readonly fold: VerdictFoldInputV1;
-}): readonly VerdictCoherenceIssueV1[];
-/** A projector needs only the already-decoded exact Verdict state. */
-export declare function projectVerdictPayloadV1(payload: VerdictPayloadV1): Verdict;
-/** Internal current-family interpretation used by the Evaluation producer. */
-export declare function projectVerdictAttachmentV1(value: RecordAttachmentValue<VerdictPayloadV1>): Verdict;
-/** The public four-state Verdict view for an Attempt-owned Attachment. */
-export declare const verdictProjector: RecordAttachmentProjector<"attempt", Verdict>;
+export declare function validateVerdictCoherence(input: {
+    readonly payload: VerdictPayload;
+    readonly fold: VerdictFoldInput;
+}): readonly VerdictCoherenceIssue[];
+/** Plain domain projection for callers that need NiceEval's public verdict. */
+export declare function projectVerdictPayload(payload: VerdictPayload): Verdict;

package/dist/eval/record/verdict.js

@@ -1,36 +1,20 @@
 import { createRequire as __niceevalCreateRequire } from "node:module";
 const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
 const __niceevalCanonical = __niceevalRequire("./verdict.cjs");
-const __niceevalExport0 = __niceevalCanonical["VERDICT_ATTACHMENT_NAME_V1"];
-export { __niceevalExport0 as VERDICT_ATTACHMENT_NAME_V1 };
-const __niceevalExport1 = __niceevalCanonical["VERDICT_ATTACHMENT_SCHEMA_ID_V1"];
-export { __niceevalExport1 as VERDICT_ATTACHMENT_SCHEMA_ID_V1 };
-const __niceevalExport2 = __niceevalCanonical["VerdictFoldInputV1Schema"];
-export { __niceevalExport2 as VerdictFoldInputV1Schema };
-const __niceevalExport3 = __niceevalCanonical["VerdictPayloadV1Schema"];
-export { __niceevalExport3 as VerdictPayloadV1Schema };
-const __niceevalExport4 = __niceevalCanonical["VerdictStateV1Schema"];
-export { __niceevalExport4 as VerdictStateV1Schema };
-const __niceevalExport5 = __niceevalCanonical["buildVerdictAttachmentWriteV1"];
-export { __niceevalExport5 as buildVerdictAttachmentWriteV1 };
-const __niceevalExport6 = __niceevalCanonical["buildVerdictPayloadV1"];
-export { __niceevalExport6 as buildVerdictPayloadV1 };
-const __niceevalExport7 = __niceevalCanonical["createVerdictAttachmentWriteV1"];
-export { __niceevalExport7 as createVerdictAttachmentWriteV1 };
-const __niceevalExport8 = __niceevalCanonical["decodeVerdictPayloadV1"];
-export { __niceevalExport8 as decodeVerdictPayloadV1 };
-const __niceevalExport9 = __niceevalCanonical["foldVerdictV1"];
-export { __niceevalExport9 as foldVerdictV1 };
-const __niceevalExport10 = __niceevalCanonical["projectVerdictAttachmentV1"];
-export { __niceevalExport10 as projectVerdictAttachmentV1 };
-const __niceevalExport11 = __niceevalCanonical["projectVerdictPayloadV1"];
-export { __niceevalExport11 as projectVerdictPayloadV1 };
-const __niceevalExport12 = __niceevalCanonical["validateVerdictCoherenceV1"];
-export { __niceevalExport12 as validateVerdictCoherenceV1 };
-const __niceevalExport13 = __niceevalCanonical["verdictAttachmentDefinitionV1"];
-export { __niceevalExport13 as verdictAttachmentDefinitionV1 };
-const __niceevalExport14 = __niceevalCanonical["verdictAttachmentFamilyV1"];
-export { __niceevalExport14 as verdictAttachmentFamilyV1 };
-const __niceevalExport15 = __niceevalCanonical["verdictProjector"];
-export { __niceevalExport15 as verdictProjector };
+const __niceevalExport0 = __niceevalCanonical["VerdictFoldInputSchema"];
+export { __niceevalExport0 as VerdictFoldInputSchema };
+const __niceevalExport1 = __niceevalCanonical["VerdictPayloadSchema"];
+export { __niceevalExport1 as VerdictPayloadSchema };
+const __niceevalExport2 = __niceevalCanonical["VerdictStateSchema"];
+export { __niceevalExport2 as VerdictStateSchema };
+const __niceevalExport3 = __niceevalCanonical["buildVerdictPayload"];
+export { __niceevalExport3 as buildVerdictPayload };
+const __niceevalExport4 = __niceevalCanonical["foldRecordedAttemptVerdict"];
+export { __niceevalExport4 as foldRecordedAttemptVerdict };
+const __niceevalExport5 = __niceevalCanonical["foldVerdict"];
+export { __niceevalExport5 as foldVerdict };
+const __niceevalExport6 = __niceevalCanonical["projectVerdictPayload"];
+export { __niceevalExport6 as projectVerdictPayload };
+const __niceevalExport7 = __niceevalCanonical["validateVerdictCoherence"];
+export { __niceevalExport7 as validateVerdictCoherence };
 //# sourceMappingURL=verdict.js.map

package/dist/experiment/host/index.cjs

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.experimentHost = void 0;
+const effect_1 = require("effect");
+const load_config_ts_1 = require("../../load-config.cjs");
+const command_plan_ts_1 = require("../../runner/command-plan.cjs");
+const discover_ts_1 = require("../../runner/discover.cjs");
+const fingerprint_ts_1 = require("../../runner/fingerprint.cjs");
+const eval_selection_ts_1 = require("../../runner/eval-selection.cjs");
+const record_ts_1 = require("../../runner/record.cjs");
+const reuse_readback_ts_1 = require("../../runner/reuse-readback.cjs");
+const accept_ts_1 = require("../../runner/accept.cjs");
+const run_ts_1 = require("../../runner/run.cjs");
+const timeout_ts_1 = require("../../runner/timeout.cjs");
+const aggregate_ts_1 = require("../../shared/aggregate.cjs");
+/**
+ * Discovery and selection are owned here so consumers cannot invoke an
+ * Experiment's predicate a second time while reconstructing an AgentRun.
+ */
+function list(input) {
+    return effect_1.Effect.gen(function* () {
+        const discoveredEvals = yield* (0, discover_ts_1.discoverEvals)(input.cwd);
+        const evals = input.tag === undefined
+            ? discoveredEvals
+            : discoveredEvals.filter((evalDefinition) => evalDefinition.tags?.includes(input.tag));
+        const experiments = yield* (0, discover_ts_1.discoverExperiments)(input.cwd);
+        const experimentIds = Object.freeze(experiments.map((experiment) => experiment.id));
+        const selectedIds = input.selector === undefined
+            ? undefined
+            : new Set((0, aggregate_ts_1.matchExperimentSelector)(experimentIds, input.selector));
+        const selections = experiments
+            .filter((experiment) => selectedIds === undefined || selectedIds.has(experiment.id))
+            .map((experiment) => {
+            const selected = (0, eval_selection_ts_1.resolveExperimentEvals)({
+                experimentId: experiment.id,
+                selector: experiment.evals,
+                cliPatterns: input.evalPatterns ?? [],
+                evals,
+            });
+            return Object.freeze({
+                experiment,
+                selectedEvalIds: Object.freeze([...selected.selectedEvalIds]),
+                selectorEvalIds: Object.freeze(selected.selectorEvals.map((evalDefinition) => evalDefinition.id)),
+            });
+        });
+        return Object.freeze({
+            evals: Object.freeze([...evals]),
+            experimentIds,
+            selections: Object.freeze(selections),
+        });
+    });
+}
+function uniqueExactOrPrefix(candidates, selector, id) {
+    const exact = candidates.find((candidate) => id(candidate) === selector);
+    return exact === undefined
+        ? candidates.filter((candidate) => id(candidate).startsWith(selector))
+        : [exact];
+}
+function debugAgentRun(experiment, evalId) {
+    return {
+        agent: experiment.agent,
+        model: experiment.model,
+        reasoningEffort: experiment.reasoningEffort,
+        flags: experiment.flags ?? {},
+        plugins: experiment.plugins,
+        attempts: experiment.attempts ?? 1,
+        earlyExit: experiment.earlyExit ?? false,
+        sandbox: experiment.sandbox,
+        sandboxReuse: experiment.sandboxReuse,
+        judge: experiment.judge,
+        ...(0, timeout_ts_1.resolveRunTimeout)(undefined, experiment.timeoutMs),
+        budget: experiment.budget,
+        selectedEvalIds: [evalId],
+        experimentId: experiment.id,
+        experimentBaseDir: experiment.baseDir,
+        experimentSourcePath: experiment.sourcePath,
+        description: experiment.description,
+        labels: experiment.labels,
+        maxConcurrency: experiment.maxConcurrency,
+        setup: experiment.setup,
+        teardown: experiment.teardown,
+        classifyFailure: experiment.classifyFailure,
+    };
+}
+/**
+ * Closes selector resolution, physical planning, and command-plan projection
+ * inside the Experiment Host. It deliberately does not construct a Record
+ * root, enter a lease, read history, or invoke an author callback.
+ */
+function debug(input) {
+    return effect_1.Effect.gen(function* () {
+        const config = yield* effect_1.Effect.tryPromise({
+            try: () => (0, load_config_ts_1.loadConfigFile)(input.cwd),
+            catch: (cause) => cause,
+        });
+        const listed = yield* list({ cwd: input.cwd });
+        const selectedExperiments = uniqueExactOrPrefix(listed.selections, input.experimentSelector, ({ experiment }) => experiment.id).slice().sort((left, right) => left.experiment.id.localeCompare(right.experiment.id));
+        if (selectedExperiments.length === 0) {
+            return Object.freeze({
+                status: "experiment-no-match",
+                selector: input.experimentSelector,
+                candidates: Object.freeze([...listed.experimentIds].sort()),
+            });
+        }
+        if (selectedExperiments.length > 1) {
+            return Object.freeze({
+                status: "experiment-ambiguous",
+                selector: input.experimentSelector,
+                candidates: Object.freeze(selectedExperiments.map(({ experiment }) => experiment.id)),
+            });
+        }
+        const selection = selectedExperiments[0];
+        const experiment = selection.experiment;
+        const selectorEvalIds = new Set(selection.selectorEvalIds);
+        const selectorEvals = listed.evals.filter((evalDef) => selectorEvalIds.has(evalDef.id));
+        const selectedEvals = uniqueExactOrPrefix(selectorEvals, input.evalSelector, (evalDef) => evalDef.id)
+            .slice().sort((left, right) => left.id.localeCompare(right.id));
+        if (selectedEvals.length === 0) {
+            return Object.freeze({
+                status: "eval-no-match",
+                selector: input.evalSelector,
+                experimentId: experiment.id,
+                candidates: Object.freeze(selectorEvals.map((evalDef) => evalDef.id).sort()),
+            });
+        }
+        if (selectedEvals.length > 1) {
+            return Object.freeze({
+                status: "eval-ambiguous",
+                selector: input.evalSelector,
+                experimentId: experiment.id,
+                candidates: Object.freeze(selectedEvals.map((evalDef) => evalDef.id)),
+            });
+        }
+        const evalDef = selectedEvals[0];
+        const run = debugAgentRun(experiment, evalDef.id);
+        const target = yield* (0, fingerprint_ts_1.planProjectTarget)(listed.evals, [run], config.timeoutMs, { configJudge: config.judge });
+        const commandPlan = (0, command_plan_ts_1.assembleCommandPlan)({
+            rows: [{
+                    experimentId: experiment.id,
+                    evalId: evalDef.id,
+                    ...(evalDef.evalGroup === undefined ? {} : { evalGroupId: evalDef.evalGroup.id }),
+                    attempts: run.attempts,
+                    dispatch: [{ attempts: Array.from({ length: run.attempts }, (_, attempt) => attempt) }],
+                }],
+            preparedPairsByKey: target.preparedPairsByKey,
+        });
+        return Object.freeze({
+            status: "planned",
+            experimentId: experiment.id,
+            evalId: evalDef.id,
+            commandPlan,
+        });
+    });
+}
+/**
+ * Reuses the production physical planner and frozen Record reuse planner.
+ * It never creates a Run; current history is read only when a dry preview was
+ * explicitly requested.
+ */
+function plan(input) {
+    return effect_1.Effect.gen(function* () {
+        const target = yield* (0, fingerprint_ts_1.planProjectTarget)(input.evals, input.agentRuns, input.config.timeoutMs, {
+            configJudge: input.config.judge,
+            ...(input.keepSandbox === undefined ? {} : { keepSandbox: input.keepSandbox }),
+        });
+        const reuse = yield* (0, record_ts_1.prepareRunnerRecordReuse)({
+            evals: input.evals,
+            runs: input.agentRuns,
+            config: { timeoutMs: input.config.timeoutMs },
+            plannedFingerprints: target.plannedFingerprints,
+            plannedConfigHashes: target.plannedConfigHashes,
+            ...(input.rerun === undefined ? {} : { rerun: input.rerun }),
+            ...(input.keepSandbox === undefined ? {} : { keepSandbox: input.keepSandbox }),
+        });
+        const current = input.previewStartedAt === undefined
+            ? undefined
+            : yield* (0, record_ts_1.withRunnerCurrentReusePreview)({
+                recordRoot: input.recordRoot,
+                startedAt: input.previewStartedAt,
+                evals: input.evals,
+                runs: input.agentRuns,
+                reuse,
+                use: ({ reusePlan, readReadbacks }) => readReadbacks().pipe(effect_1.Effect.map((readbacks) => Object.freeze({
+                    slots: Object.freeze([...reusePlan.slots]),
+                    readbacks: Object.freeze(readbacks.map(reuse_readback_ts_1.projectCurrentReuseReadback)),
+                }))),
+            });
+        return Object.freeze({
+            target,
+            ...(current === undefined ? {} : { current }),
+        });
+    });
+}
+/** The existing Runner remains the one execution implementation. */
+function run(input) {
+    return (0, run_ts_1.runEvals)(input);
+}
+/** The existing adoption flow remains the one acceptance implementation. */
+function accept(input) {
+    return (0, accept_ts_1.acceptLocators)(input);
+}
+/** The fixed public Host surface; discovery, Runner, and adoption internals stay private. */
+exports.experimentHost = Object.freeze({
+    list,
+    plan,
+    debug,
+    run,
+    accept,
+});
+//# sourceMappingURL=index.cjs.map

package/dist/experiment/host/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect } from \"effect\";\nimport { loadConfigFile } from \"../../load-config.ts\";\nimport { assembleCommandPlan, type CommandPlan } from \"../../runner/command-plan.ts\";\nimport { discoverEvals, discoverExperiments } from \"../../runner/discover.ts\";\nimport { planProjectTarget } from \"../../runner/fingerprint.ts\";\nimport { resolveExperimentEvals } from \"../../runner/eval-selection.ts\";\nimport { prepareRunnerRecordReuse, withRunnerCurrentReusePreview, } from \"../../runner/record.ts\";\nimport { projectCurrentReuseReadback, } from \"../../runner/reuse-readback.ts\";\nimport { acceptLocators } from \"../../runner/accept.ts\";\nimport { runEvals } from \"../../runner/run.ts\";\nimport type { AcceptLocatorsOptions, } from \"../../runner/accept.ts\";\nimport type { ProjectTargetPlan } from \"../../runner/fingerprint.ts\";\nimport type { CurrentReuseReadbackSnapshot } from \"../../runner/reuse-readback.ts\";\nimport type { ExecutionReusePlanSlot } from \"../../runner/reuse-plan.ts\";\nimport { resolveRunTimeout } from \"../../runner/timeout.ts\";\nimport type { AgentRun, Config, DiscoveredEval, DiscoveredExperiment, RunOptions, } from \"../../runner/types.ts\";\nimport type { RecordRoot } from \"../../record/platform/root.ts\";\nimport { matchExperimentSelector } from \"../../shared/aggregate.ts\";\n/**\n * Public, supported high-level Host composition SDK for the NiceEval CLI,\n * replacement CLI/Web hosts, and deep application integrations. Eval authors\n * use `defineExperiment`; this entry deliberately exposes no Runner internals.\n */\n/** One discovered Experiment after its author selector and CLI prefixes close. */\nexport interface ExperimentHostSelection {\n    readonly experiment: DiscoveredExperiment;\n    readonly selectedEvalIds: readonly string[];\n    /** The Experiment-owned set before CLI eval-prefix narrowing. */\n    readonly selectorEvalIds: readonly string[];\n}\n/** Discovery result used by both `exp list` and execution planning. */\nexport interface ExperimentHostListResult {\n    readonly evals: readonly DiscoveredEval[];\n    readonly experimentIds: readonly string[];\n    readonly selections: readonly ExperimentHostSelection[];\n}\n/**\n * Discovery and selection are owned here so consumers cannot invoke an\n * Experiment's predicate a second time while reconstructing an AgentRun.\n */\nfunction list(input: {\n    readonly cwd: string;\n    /** Keep the CLI's public `--tag` selection inside the Experiment boundary. */\n    readonly tag?: string;\n    readonly selector?: string;\n    readonly evalPatterns?: readonly string[];\n}): Effect.Effect<ExperimentHostListResult, unknown> {\n    return Effect.gen(function* () {\n        const discoveredEvals = yield* discoverEvals(input.cwd);\n        const evals = input.tag === undefined\n            ? discoveredEvals\n            : discoveredEvals.filter((evalDefinition) => evalDefinition.tags?.includes(input.tag!));\n        const experiments = yield* discoverExperiments(input.cwd);\n        const experimentIds = Object.freeze(experiments.map((experiment) => experiment.id));\n        const selectedIds = input.selector === undefined\n            ? undefined\n            : new Set(matchExperimentSelector(experimentIds, input.selector));\n        const selections = experiments\n            .filter((experiment) => selectedIds === undefined || selectedIds.has(experiment.id))\n            .map((experiment): ExperimentHostSelection => {\n            const selected = resolveExperimentEvals({\n                experimentId: experiment.id,\n                selector: experiment.evals,\n                cliPatterns: input.evalPatterns ?? [],\n                evals,\n            });\n            return Object.freeze({\n                experiment,\n                selectedEvalIds: Object.freeze([...selected.selectedEvalIds]),\n                selectorEvalIds: Object.freeze(selected.selectorEvals.map((evalDefinition) => evalDefinition.id)),\n            });\n        });\n        return Object.freeze({\n            evals: Object.freeze([...evals]),\n            experimentIds,\n            selections: Object.freeze(selections),\n        });\n    });\n}\nexport interface ExperimentHostDebugPlanRequest {\n    readonly cwd: string;\n    readonly experimentSelector: string;\n    readonly evalSelector: string;\n}\n/** A fully closed, read-only lifecycle plan for exactly one Experiment × Eval pair. */\nexport interface ExperimentHostDebugPlan {\n    readonly status: \"planned\";\n    readonly experimentId: string;\n    readonly evalId: string;\n    readonly commandPlan: CommandPlan;\n}\n/**\n * Selector outcomes are data, rather than CLI-owned selection logic or a\n * partially constructed plan. The caller can render them in its own surface.\n */\nexport type ExperimentHostDebugPlanResult = ExperimentHostDebugPlan | {\n    readonly status: \"experiment-no-match\";\n    readonly selector: string;\n    readonly candidates: readonly string[];\n} | {\n    readonly status: \"experiment-ambiguous\";\n    readonly selector: string;\n    readonly candidates: readonly string[];\n} | {\n    readonly status: \"eval-no-match\";\n    readonly selector: string;\n    readonly experimentId: string;\n    readonly candidates: readonly string[];\n} | {\n    readonly status: \"eval-ambiguous\";\n    readonly selector: string;\n    readonly experimentId: string;\n    readonly candidates: readonly string[];\n};\nfunction uniqueExactOrPrefix<T>(candidates: readonly T[], selector: string, id: (candidate: T) => string): readonly T[] {\n    const exact = candidates.find((candidate) => id(candidate) === selector);\n    return exact === undefined\n        ? candidates.filter((candidate) => id(candidate).startsWith(selector))\n        : [exact];\n}\nfunction debugAgentRun(experiment: DiscoveredExperiment, evalId: string): AgentRun {\n    return {\n        agent: experiment.agent,\n        model: experiment.model,\n        reasoningEffort: experiment.reasoningEffort,\n        flags: experiment.flags ?? {},\n        plugins: experiment.plugins,\n        attempts: experiment.attempts ?? 1,\n        earlyExit: experiment.earlyExit ?? false,\n        sandbox: experiment.sandbox,\n        sandboxReuse: experiment.sandboxReuse,\n        judge: experiment.judge,\n        ...resolveRunTimeout(undefined, experiment.timeoutMs),\n        budget: experiment.budget,\n        selectedEvalIds: [evalId],\n        experimentId: experiment.id,\n        experimentBaseDir: experiment.baseDir,\n        experimentSourcePath: experiment.sourcePath,\n        description: experiment.description,\n        labels: experiment.labels,\n        maxConcurrency: experiment.maxConcurrency,\n        setup: experiment.setup,\n        teardown: experiment.teardown,\n        classifyFailure: experiment.classifyFailure,\n    };\n}\n/**\n * Closes selector resolution, physical planning, and command-plan projection\n * inside the Experiment Host. It deliberately does not construct a Record\n * root, enter a lease, read history, or invoke an author callback.\n */\nfunction debug(input: ExperimentHostDebugPlanRequest): Effect.Effect<ExperimentHostDebugPlanResult, unknown> {\n    return Effect.gen(function* () {\n        const config = yield* Effect.tryPromise({\n            try: () => loadConfigFile(input.cwd),\n            catch: (cause) => cause,\n        });\n        const listed = yield* list({ cwd: input.cwd });\n        const selectedExperiments = uniqueExactOrPrefix(listed.selections, input.experimentSelector, ({ experiment }) => experiment.id).slice().sort((left, right) => left.experiment.id.localeCompare(right.experiment.id));\n        if (selectedExperiments.length === 0) {\n            return Object.freeze({\n                status: \"experiment-no-match\" as const,\n                selector: input.experimentSelector,\n                candidates: Object.freeze([...listed.experimentIds].sort()),\n            });\n        }\n        if (selectedExperiments.length > 1) {\n            return Object.freeze({\n                status: \"experiment-ambiguous\" as const,\n                selector: input.experimentSelector,\n                candidates: Object.freeze(selectedExperiments.map(({ experiment }) => experiment.id)),\n            });\n        }\n        const selection = selectedExperiments[0]!;\n        const experiment = selection.experiment;\n        const selectorEvalIds = new Set(selection.selectorEvalIds);\n        const selectorEvals = listed.evals.filter((evalDef) => selectorEvalIds.has(evalDef.id));\n        const selectedEvals = uniqueExactOrPrefix(selectorEvals, input.evalSelector, (evalDef) => evalDef.id)\n            .slice().sort((left, right) => left.id.localeCompare(right.id));\n        if (selectedEvals.length === 0) {\n            return Object.freeze({\n                status: \"eval-no-match\" as const,\n                selector: input.evalSelector,\n                experimentId: experiment.id,\n                candidates: Object.freeze(selectorEvals.map((evalDef) => evalDef.id).sort()),\n            });\n        }\n        if (selectedEvals.length > 1) {\n            return Object.freeze({\n                status: \"eval-ambiguous\" as const,\n                selector: input.evalSelector,\n                experimentId: experiment.id,\n                candidates: Object.freeze(selectedEvals.map((evalDef) => evalDef.id)),\n            });\n        }\n        const evalDef = selectedEvals[0]!;\n        const run = debugAgentRun(experiment, evalDef.id);\n        const target = yield* planProjectTarget(listed.evals, [run], config.timeoutMs, { configJudge: config.judge });\n        const commandPlan = assembleCommandPlan({\n            rows: [{\n                    experimentId: experiment.id,\n                    evalId: evalDef.id,\n                    ...(evalDef.evalGroup === undefined ? {} : { evalGroupId: evalDef.evalGroup.id }),\n                    attempts: run.attempts,\n                    dispatch: [{ attempts: Array.from({ length: run.attempts }, (_, attempt) => attempt) }],\n                }],\n            preparedPairsByKey: target.preparedPairsByKey,\n        });\n        return Object.freeze({\n            status: \"planned\" as const,\n            experimentId: experiment.id,\n            evalId: evalDef.id,\n            commandPlan,\n        });\n    });\n}\nexport interface ExperimentHostPlanRequest {\n    readonly evals: readonly DiscoveredEval[];\n    readonly agentRuns: readonly AgentRun[];\n    readonly config: Config;\n    readonly recordRoot: RecordRoot;\n    readonly rerun?: \"failed\" | \"all\";\n    readonly keepSandbox?: \"failed\" | \"all\";\n    /** Omit for a dispatch plan; include only for the read-only `exp --dry` path. */\n    readonly previewStartedAt?: number;\n}\nexport interface ExperimentHostCurrentPlan {\n    readonly slots: readonly ExecutionReusePlanSlot[];\n    readonly readbacks: readonly CurrentReuseReadbackSnapshot[];\n}\nexport interface ExperimentHostPlan {\n    readonly target: ProjectTargetPlan;\n    readonly current?: ExperimentHostCurrentPlan;\n}\n/**\n * Reuses the production physical planner and frozen Record reuse planner.\n * It never creates a Run; current history is read only when a dry preview was\n * explicitly requested.\n */\nfunction plan(input: ExperimentHostPlanRequest) {\n    return Effect.gen(function* () {\n        const target = yield* planProjectTarget(input.evals, input.agentRuns, input.config.timeoutMs, {\n            configJudge: input.config.judge,\n            ...(input.keepSandbox === undefined ? {} : { keepSandbox: input.keepSandbox }),\n        });\n        const reuse = yield* prepareRunnerRecordReuse({\n            evals: input.evals,\n            runs: input.agentRuns,\n            config: { timeoutMs: input.config.timeoutMs },\n            plannedFingerprints: target.plannedFingerprints,\n            plannedConfigHashes: target.plannedConfigHashes,\n            ...(input.rerun === undefined ? {} : { rerun: input.rerun }),\n            ...(input.keepSandbox === undefined ? {} : { keepSandbox: input.keepSandbox }),\n        });\n        const current = input.previewStartedAt === undefined\n            ? undefined\n            : yield* withRunnerCurrentReusePreview({\n                recordRoot: input.recordRoot,\n                startedAt: input.previewStartedAt,\n                evals: input.evals,\n                runs: input.agentRuns,\n                reuse,\n                use: ({ reusePlan, readReadbacks }) => readReadbacks().pipe(Effect.map((readbacks): ExperimentHostCurrentPlan => Object.freeze({\n                    slots: Object.freeze([...reusePlan.slots]),\n                    readbacks: Object.freeze(readbacks.map(projectCurrentReuseReadback)),\n                }))),\n            });\n        return Object.freeze({\n            target,\n            ...(current === undefined ? {} : { current }),\n        });\n    });\n}\n/** The existing Runner remains the one execution implementation. */\nfunction run<AttachmentError, AttachmentRequirements>(input: RunOptions<AttachmentError, AttachmentRequirements>) {\n    return runEvals(input);\n}\n/** The existing adoption flow remains the one acceptance implementation. */\nfunction accept(input: AcceptLocatorsOptions) {\n    return acceptLocators(input);\n}\nexport interface ExperimentHostSDK {\n    readonly list: typeof list;\n    readonly plan: typeof plan;\n    readonly debug: typeof debug;\n    readonly run: typeof run;\n    readonly accept: typeof accept;\n}\n/** The fixed public Host surface; discovery, Runner, and adoption internals stay private. */\nexport const experimentHost: ExperimentHostSDK = Object.freeze({\n    list,\n    plan,\n    debug,\n    run,\n    accept,\n});\n"]}