niceeval 0.13.1 → 0.13.2

package/dist/analysis/bindings.d.ts

@@ -29,7 +29,7 @@ export type InputProjection<Value> = {
     readonly state: "value";
     readonly value: Value;
 } | {
-    readonly state: "missing" | "unsupported" | "failed";
+    readonly state: "missing" | "migration-required" | "unsupported" | "failed";
     readonly message: string;
 };
 /** One semantic input owns an immutable owner/family requirement and projector. */
@@ -413,15 +413,23 @@ export declare const attemptObservabilityFamily: FixedFamilyBinding<"attempt", {
                 readonly commandId: string;
             })[]];
         };
-        readonly intervals: readonly {
+        readonly intervals: readonly ({
             readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
             readonly label: string;
-            readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+            readonly phase: "agent.send";
             readonly startOffsetMs: number;
             readonly durationMs: number;
             readonly intervalId: string;
             readonly parentIntervalId: string | null;
-        }[];
+        } | {
+            readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+            readonly label: string;
+            readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+            readonly startOffsetMs: number;
+            readonly durationMs: number;
+            readonly intervalId: string;
+            readonly parentIntervalId: string | null;
+        })[];
     };
     readonly diagnostics: {
         readonly collection: {
@@ -862,15 +870,23 @@ export declare const attemptObservabilityFamily: FixedFamilyBinding<"attempt", {
                 readonly commandId: string;
             })[]];
         };
-        readonly intervals: readonly {
+        readonly intervals: readonly ({
             readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
             readonly label: string;
-            readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+            readonly phase: "agent.send";
             readonly startOffsetMs: number;
             readonly durationMs: number;
             readonly intervalId: string;
             readonly parentIntervalId: string | null;
-        }[];
+        } | {
+            readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+            readonly label: string;
+            readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+            readonly startOffsetMs: number;
+            readonly durationMs: number;
+            readonly intervalId: string;
+            readonly parentIntervalId: string | null;
+        })[];
     };
     readonly diagnostics: {
         readonly collection: {
@@ -1417,15 +1433,23 @@ export declare const publishedAnalysisInputBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -1866,15 +1890,23 @@ export declare const publishedAnalysisInputBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -2330,15 +2362,23 @@ export declare const publishedAnalysisInputBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -2779,15 +2819,23 @@ export declare const publishedAnalysisInputBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -3237,15 +3285,23 @@ export declare const publishedAnalysisInputBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -3686,15 +3742,23 @@ export declare const publishedAnalysisInputBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -4248,15 +4312,23 @@ export declare const attemptObservabilityDomainBinding: Readonly<{
                     readonly commandId: string;
                 })[]];
             };
-            readonly intervals: readonly {
+            readonly intervals: readonly ({
                 readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                 readonly label: string;
-                readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                readonly phase: "agent.send";
                 readonly startOffsetMs: number;
                 readonly durationMs: number;
                 readonly intervalId: string;
                 readonly parentIntervalId: string | null;
-            }[];
+            } | {
+                readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                readonly label: string;
+                readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                readonly startOffsetMs: number;
+                readonly durationMs: number;
+                readonly intervalId: string;
+                readonly parentIntervalId: string | null;
+            })[];
         };
         readonly diagnostics: {
             readonly collection: {
@@ -4697,15 +4769,23 @@ export declare const attemptObservabilityDomainBinding: Readonly<{
                     readonly commandId: string;
                 })[]];
             };
-            readonly intervals: readonly {
+            readonly intervals: readonly ({
                 readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                 readonly label: string;
-                readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                readonly phase: "agent.send";
                 readonly startOffsetMs: number;
                 readonly durationMs: number;
                 readonly intervalId: string;
                 readonly parentIntervalId: string | null;
-            }[];
+            } | {
+                readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                readonly label: string;
+                readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                readonly startOffsetMs: number;
+                readonly durationMs: number;
+                readonly intervalId: string;
+                readonly parentIntervalId: string | null;
+            })[];
         };
         readonly diagnostics: {
             readonly collection: {
@@ -5498,15 +5578,23 @@ export declare const sandboxHistoryDomainBinding: Readonly<{
                     readonly commandId: string;
                 })[]];
             };
-            readonly intervals: readonly {
+            readonly intervals: readonly ({
                 readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                 readonly label: string;
-                readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                readonly phase: "agent.send";
                 readonly startOffsetMs: number;
                 readonly durationMs: number;
                 readonly intervalId: string;
                 readonly parentIntervalId: string | null;
-            }[];
+            } | {
+                readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                readonly label: string;
+                readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                readonly startOffsetMs: number;
+                readonly durationMs: number;
+                readonly intervalId: string;
+                readonly parentIntervalId: string | null;
+            })[];
         };
         readonly diagnostics: {
             readonly collection: {
@@ -5947,15 +6035,23 @@ export declare const sandboxHistoryDomainBinding: Readonly<{
                     readonly commandId: string;
                 })[]];
             };
-            readonly intervals: readonly {
+            readonly intervals: readonly ({
                 readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                 readonly label: string;
-                readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                readonly phase: "agent.send";
                 readonly startOffsetMs: number;
                 readonly durationMs: number;
                 readonly intervalId: string;
                 readonly parentIntervalId: string | null;
-            }[];
+            } | {
+                readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                readonly label: string;
+                readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                readonly startOffsetMs: number;
+                readonly durationMs: number;
+                readonly intervalId: string;
+                readonly parentIntervalId: string | null;
+            })[];
         };
         readonly diagnostics: {
             readonly collection: {
@@ -6508,15 +6604,23 @@ export declare const builtinDomainViewBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -6957,15 +7061,23 @@ export declare const builtinDomainViewBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -7758,15 +7870,23 @@ export declare const builtinDomainViewBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {
@@ -8207,15 +8327,23 @@ export declare const builtinDomainViewBindings: Readonly<{
                         readonly commandId: string;
                     })[]];
                 };
-                readonly intervals: readonly {
+                readonly intervals: readonly ({
                     readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
                     readonly label: string;
-                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "agent.send" | "assertion.evaluate" | "verdict.fold";
+                    readonly phase: "agent.send";
                     readonly startOffsetMs: number;
                     readonly durationMs: number;
                     readonly intervalId: string;
                     readonly parentIntervalId: string | null;
-                }[];
+                } | {
+                    readonly outcome: "completed" | "cancelled" | "interrupted" | "failed" | "unknown";
+                    readonly label: string;
+                    readonly phase: "agent.ensure" | "sandbox.prepare" | "eval.run" | "sandbox.command" | "attempt.setup" | "attempt.teardown" | "assertion.evaluate" | "verdict.fold";
+                    readonly startOffsetMs: number;
+                    readonly durationMs: number;
+                    readonly intervalId: string;
+                    readonly parentIntervalId: string | null;
+                })[];
             };
             readonly diagnostics: {
                 readonly collection: {

package/dist/analysis/contracts.cjs

@@ -5,6 +5,7 @@ exports.makeClosedRows = makeClosedRows;
 exports.isClosedRows = isClosedRows;
 exports.closedRowsMetadata = closedRowsMetadata;
 exports.sampleCapabilityTypeId = Symbol("niceeval.analysis.Sample");
+const experimentComparisonScopeTypeId = Symbol("niceeval.analysis.ExperimentComparisonScope");
 const closedRowsTypeId = Symbol("niceeval.analysis.ClosedRows");
 const closedRowsBrands = new WeakSet();
 const closedRowsMetadataByValue = new WeakMap();

package/dist/analysis/contracts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["contracts.ts"],"names":[],"mappings":";;;AA+QA,wCAqBC;AAED,oCAIC;AAED,gDAEC;AAjIY,QAAA,sBAAsB,GAAkB,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAiFxF,MAAM,gBAAgB,GAAkB,MAAM,CAAC,8BAA8B,CAAC,CAAC;AAO/E,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAU,CAAC;AAC/C,MAAM,yBAAyB,GAAG,IAAI,OAAO,EAA8B,CAAC;AAQ5E,sEAAsE;AACtE,SAAgB,cAAc,CAAM,KAKnC;IACG,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAA+B,CAAC;IAC3D,MAAM,QAAQ,GAAuB,MAAM,CAAC,MAAM,CAAC;QAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAC7E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;KACvC,CAAC,CAAC;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC1B,CAAC,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;QACtD,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;QACxD,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;QACpD,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;KACnD,CAAC,CAAC;IACH,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,yBAAyB,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AACD,+EAA+E;AAC/E,SAAgB,YAAY,CAAC,KAAc;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;WACpB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC;WAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,IAAI,CAAC;AACzD,CAAC;AACD,8EAA8E;AAC9E,SAAgB,kBAAkB,CAAC,KAAc;IAC7C,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC","sourcesContent":["import type { MembershipAction } from \"../record/model/core.ts\";\nimport type { AttemptId, EvalId, ExecutionIdentityDigest, ExperimentId, RunId, SlotId, UtcMillis, } from \"../record/model/identifiers.ts\";\nimport type { AttemptLocator } from \"../attempt-locator.ts\";\nexport type { AttemptId, EvalId, ExecutionIdentityDigest, ExperimentId, RunId, SlotId, UtcMillis, };\n/** JSON is the only wire shape accepted by the Sample snapshot codec. */\nexport type JsonValue = null | boolean | number | string | readonly JsonValue[] | {\n    readonly [key: string]: JsonValue;\n};\n/** Stable identity for one Sample capability and its portable snapshot. */\nexport interface SampleIdentity {\n    readonly kind: \"analysis-sample\";\n    readonly id: string;\n}\n/**\n * A public identity for evidence from one immutable Attempt.  It deliberately\n * carries a locator rather than Record's nominal selected-reference capability\n * or an AttemptId that could be used as an ad-hoc storage lookup.\n */\nexport interface AttemptEvidenceIdentity {\n    readonly kind: \"attempt\";\n    readonly locator: AttemptLocator;\n    readonly originRunId: RunId;\n}\nexport type AnalysisSelectionProblem = {\n    readonly code: \"incomplete-run\";\n    readonly runId: RunId;\n} | {\n    readonly code: \"record-core-invalid\";\n    readonly runId: RunId;\n} | {\n    readonly code: \"selection-run-missing\";\n    readonly runId: RunId;\n} | {\n    readonly code: \"selection-run-unreadable\";\n    readonly runId: RunId;\n};\n/**\n * One current target Slot identity. `project-current` keeps only Sample\n * members whose experiment/eval/attempt ordinal aligns, then whose digest\n * still narrows that aligned identity.\n */\nexport interface AnalysisCurrentSlotIdentity {\n    readonly experimentId: ExperimentId;\n    readonly evalId: EvalId;\n    /** Logical attempt identity; never inferred from expectedSlots array order. */\n    readonly attemptOrdinal: number;\n    /** Narrows an already aligned logical identity; it is not the alignment key. */\n    readonly executionIdentityDigest: ExecutionIdentityDigest;\n}\n/** Exact occurrence retained after project-current logical alignment. */\nexport interface AnalysisSlotOccurrenceIdentity {\n    readonly runId: RunId;\n    readonly slotId: SlotId;\n}\n/** Host-issued selection used by Application, CLI, and Report from-record. */\nexport type AnalysisSelectionRequest = {\n    readonly policy: \"explicit-runs\";\n    readonly runIds: readonly RunId[];\n} | {\n    readonly policy: \"project-current\";\n    readonly experimentIds?: readonly ExperimentId[];\n    readonly currentSlots: readonly AnalysisCurrentSlotIdentity[];\n};\n/**\n * The exact selection audit retained by a closed SampleSnapshot. `runIds` are\n * the explicit request; `selectedRunIds` are recomputed from the current,\n * non-excluded Sample frame after every monotonic narrowing.\n */\nexport type AnalysisSelectionSummary = {\n    readonly policy: \"explicit-runs\";\n    readonly runIds: readonly RunId[];\n    readonly selectedRunIds: readonly RunId[];\n    readonly problems: readonly AnalysisSelectionProblem[];\n} | {\n    readonly policy: \"project-current\";\n    readonly experimentIds: readonly ExperimentId[] | \"all\";\n    readonly selectedRunIds: readonly RunId[];\n    readonly problems: readonly AnalysisSelectionProblem[];\n};\nexport interface AnalysisRun {\n    readonly runId: RunId;\n    readonly experimentId: ExperimentId;\n    /**\n     * The safe, immutable portion of the selected Run's Core context. A later\n     * Core read can be unavailable after selection, in which case no context is\n     * invented for that Run.\n     */\n    readonly context: AnalysisRunContext | null;\n    readonly startedAt: UtcMillis;\n    readonly completedAt: UtcMillis;\n    readonly expectedSlots: readonly SlotId[];\n}\n/**\n * Display- and grouping-safe Run configuration retained by a Sample. It has\n * no Record capability and is recursively JSON-only.\n */\nexport interface AnalysisRunContext {\n    readonly execution: AnalysisRunExecution;\n    readonly labels: Readonly<Record<string, string>>;\n}\nexport interface AnalysisRunExecution {\n    readonly agentId: string;\n    readonly model: string | null;\n    readonly reasoningEffort: string | null;\n    readonly flags: Readonly<Record<string, JsonValue>>;\n}\nexport interface AnalysisSlotRef {\n    /** Occurrence identity is always the exact selected Run/Slot pair. */\n    readonly runId: RunId;\n    readonly slotId: SlotId;\n    /** Derived from the associated selected AnalysisRun, never a Record Slot field. */\n    readonly experimentId: ExperimentId;\n    /** Logical alignment is experiment + eval + durable attempt ordinal. */\n    readonly evalId: EvalId;\n    readonly attemptOrdinal: number;\n    /** This remains an identity-narrowing value, never a logical alignment key. */\n    readonly executionIdentityDigest: ExecutionIdentityDigest;\n}\n/** A Member with an exact origin Attempt. */\nexport interface IncludedAnalysisSlot extends AnalysisSlotRef {\n    readonly state: \"included\";\n    /** Core provenance is not inferred from whether the Attempt is local. */\n    readonly action: \"executed\" | \"carried\" | \"accepted\";\n    readonly relation: \"origin\" | \"reference\";\n    readonly attempt: AttemptEvidenceIdentity;\n}\n/**\n * An expected Slot without an Attempt. `null` means no Member document was\n * recorded; the two actions retain a recorded null Member without suggesting\n * that it is pending work.\n */\nexport interface NotRecordedAnalysisSlot extends AnalysisSlotRef {\n    readonly state: \"not-recorded\";\n    readonly action: \"not-dispatched\" | \"interrupted\" | null;\n    readonly attempt: null;\n}\n/** Core could be read far enough to identify the frame but not its member. */\nexport interface CoreInvalidAnalysisSlot extends AnalysisSlotRef {\n    readonly state: \"core-invalid\";\n    readonly action: MembershipAction | null;\n    readonly attempt: null;\n    readonly issues: readonly AnalysisIssue[];\n}\nexport type ActiveAnalysisSlot = IncludedAnalysisSlot | NotRecordedAnalysisSlot | CoreInvalidAnalysisSlot;\n/** A monotonic Sample narrowing preserves the previous, non-nested state. */\nexport interface ExcludedAnalysisSlot extends AnalysisSlotRef {\n    readonly state: \"excluded\";\n    readonly base: ActiveAnalysisSlot;\n    /** Present when `project-current` dropped this Slot for identity mismatch. */\n    readonly reason?: \"identity-mismatch\";\n}\nexport type AnalysisSlot = ActiveAnalysisSlot | ExcludedAnalysisSlot;\nexport interface SampleCoverage {\n    readonly frameTotal: number;\n    readonly selected: number;\n    readonly included: number;\n    readonly notRecorded: number;\n    readonly coreInvalid: number;\n    readonly excluded: number;\n}\n/**\n * The closed, portable representation of a Record selection. It contains\n * only selection identity, Core-derived Run/Slot denominator facts, and\n * selection problems. Decoding it can never reopen a Record.\n */\nexport interface SampleSnapshot {\n    readonly version: 1;\n    readonly identity: SampleIdentity;\n    readonly selection: AnalysisSelectionSummary;\n    readonly runs: readonly AnalysisRun[];\n    readonly slots: readonly AnalysisSlot[];\n    readonly coverage: SampleCoverage;\n}\nexport const sampleCapabilityTypeId: unique symbol = Symbol(\"niceeval.analysis.Sample\");\n/** A Host-issued, Scope-bound lazy Record-reading capability. */\nexport interface Sample {\n    readonly kind: \"analysis-sample\";\n    readonly snapshot: SampleSnapshot;\n    readonly [sampleCapabilityTypeId]: true;\n}\nexport interface SampleSelector {\n    readonly runIds?: readonly RunId[];\n    readonly slotIds?: readonly SlotId[];\n}\nexport interface SampleClosedError {\n    readonly code: \"analysis-sample-closed\";\n    readonly sample: SampleIdentity;\n}\nexport interface SampleSnapshotCodecError {\n    readonly code: \"sample-snapshot-invalid\";\n    readonly path: readonly string[];\n    readonly reason: string;\n}\nexport interface AnalysisRequestError {\n    readonly code: \"analysis-request-invalid\";\n    readonly reason: string;\n}\nexport type AnalysisInputIssueCode = \"missing\" | \"unsupported\" | \"producer-incompatible\" | \"input-invalid\" | \"reduction-failed\" | \"relation-unmatched\";\nexport interface EvidenceIdentity {\n    readonly kind: \"attempt\";\n    readonly locator: AttemptLocator;\n}\nexport interface EvidenceRef {\n    readonly identity: EvidenceIdentity;\n}\nexport interface AnalysisIssue {\n    readonly code: AnalysisInputIssueCode;\n    readonly message: string;\n    readonly refs: readonly EvidenceRef[];\n}\nexport interface ProducerIdentity {\n    readonly id: string;\n}\n/** Internal result of a published AnalysisInput read. It never reaches Report. */\nexport type SampleInputObservation<Value> = {\n    readonly state: \"value\";\n    readonly value: Value;\n    readonly refs: readonly EvidenceRef[];\n    readonly producer?: ProducerIdentity;\n} | {\n    readonly state: \"missing\" | \"unsupported\" | \"failed\";\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n    readonly producer?: ProducerIdentity;\n};\nexport type MetricState = \"available\" | \"partial\"\n/** A specialized closed metric may have no reportable value at all. */\n | \"unavailable\" | \"empty\" | \"unsupported\" | \"failed\";\nexport type MetricBasis = \"attempt\" | \"eval\" | \"run\" | \"pair\" | \"slot\";\nexport type MeasureFormat = string | {\n    readonly kind: string;\n    readonly options?: JsonValue;\n};\n/** A closed Measure cell: never a selected Record handle or reader callback. */\nexport interface MetricValue<Value = number> {\n    readonly value: Value | null;\n    readonly state: MetricState;\n    readonly samples: number;\n    readonly total: number;\n    readonly basis: MetricBasis;\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n    readonly unit?: string;\n    readonly format?: MeasureFormat;\n    readonly better?: \"higher\" | \"lower\" | \"neutral\";\n    readonly bounds?: {\n        readonly min?: number;\n        readonly max?: number;\n    };\n}\nexport interface ClosedRowsIdentity {\n    readonly kind: \"closed-rows\";\n    readonly id: string;\n}\nconst closedRowsTypeId: unique symbol = Symbol(\"niceeval.analysis.ClosedRows\");\n/** @internal Metadata is retained out-of-band so an ordinary array cannot forge it. */\nexport interface ClosedRowsMetadata {\n    readonly identity: ClosedRowsIdentity;\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}\nconst closedRowsBrands = new WeakSet<object>();\nconst closedRowsMetadataByValue = new WeakMap<object, ClosedRowsMetadata>();\n/** A branded, frozen array produced only by Analysis query execution. */\nexport interface ClosedRows<Row> extends ReadonlyArray<Readonly<Row>> {\n    readonly [closedRowsTypeId]: true;\n    readonly identity: ClosedRowsIdentity;\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}\n/** @internal Keeps the brand unforgeable to normal public callers. */\nexport function makeClosedRows<Row>(input: {\n    readonly rows: readonly Readonly<Row>[];\n    readonly identity: ClosedRowsIdentity;\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}): ClosedRows<Row> {\n    const rows = [...input.rows] as unknown as ClosedRows<Row>;\n    const metadata: ClosedRowsMetadata = Object.freeze({\n        identity: Object.freeze({ kind: input.identity.kind, id: input.identity.id }),\n        issues: Object.freeze([...input.issues]),\n        refs: Object.freeze([...input.refs]),\n    });\n    Object.defineProperties(rows, {\n        [closedRowsTypeId]: { value: true, enumerable: false },\n        identity: { value: metadata.identity, enumerable: true },\n        issues: { value: metadata.issues, enumerable: true },\n        refs: { value: metadata.refs, enumerable: true },\n    });\n    closedRowsBrands.add(rows);\n    closedRowsMetadataByValue.set(rows, metadata);\n    return Object.freeze(rows);\n}\n/** @internal Checks actual Analysis issuance, rather than structural shape. */\nexport function isClosedRows(value: unknown): value is ClosedRows<unknown> {\n    return Array.isArray(value)\n        && closedRowsBrands.has(value)\n        && Reflect.get(value, closedRowsTypeId) === true;\n}\n/** @internal Returns immutable metadata registered at Analysis close time. */\nexport function closedRowsMetadata(value: unknown): ClosedRowsMetadata | undefined {\n    return isClosedRows(value) ? closedRowsMetadataByValue.get(value) : undefined;\n}\nexport interface PopulationIdentity {\n    readonly kind: \"population\";\n    readonly id: string;\n}\n/** The common, entirely closed base of every published DomainView. */\nexport interface DomainView {\n    readonly kind: \"domain-view\";\n    readonly identity: {\n        readonly kind: \"domain-view\";\n        readonly id: string;\n    };\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}\n"]}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["contracts.ts"],"names":[],"mappings":";;;AAuTA,wCAqBC;AAED,oCAIC;AAED,gDAEC;AAzKY,QAAA,sBAAsB,GAAkB,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAoCxF,MAAM,+BAA+B,GAAkB,MAAM,CAAC,6CAA6C,CAAC,CAAC;AAqF7G,MAAM,gBAAgB,GAAkB,MAAM,CAAC,8BAA8B,CAAC,CAAC;AAO/E,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAU,CAAC;AAC/C,MAAM,yBAAyB,GAAG,IAAI,OAAO,EAA8B,CAAC;AAQ5E,sEAAsE;AACtE,SAAgB,cAAc,CAAM,KAKnC;IACG,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAA+B,CAAC;IAC3D,MAAM,QAAQ,GAAuB,MAAM,CAAC,MAAM,CAAC;QAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAC7E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;KACvC,CAAC,CAAC;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC1B,CAAC,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE;QACtD,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;QACxD,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;QACpD,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;KACnD,CAAC,CAAC;IACH,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,yBAAyB,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AACD,+EAA+E;AAC/E,SAAgB,YAAY,CAAC,KAAc;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;WACpB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC;WAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,IAAI,CAAC;AACzD,CAAC;AACD,8EAA8E;AAC9E,SAAgB,kBAAkB,CAAC,KAAc;IAC7C,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC","sourcesContent":["import type { MembershipAction } from \"../record/model/core.ts\";\nimport type { AttemptId, EvalId, ExecutionIdentityDigest, ExperimentId, RunId, SlotId, UtcMillis, } from \"../record/model/identifiers.ts\";\nimport type { AttemptLocator } from \"../attempt-locator.ts\";\nexport type { AttemptId, EvalId, ExecutionIdentityDigest, ExperimentId, RunId, SlotId, UtcMillis, };\n/** JSON is the only wire shape accepted by the Sample snapshot codec. */\nexport type JsonValue = null | boolean | number | string | readonly JsonValue[] | {\n    readonly [key: string]: JsonValue;\n};\n/** Stable identity for one Sample capability and its portable snapshot. */\nexport interface SampleIdentity {\n    readonly kind: \"analysis-sample\";\n    readonly id: string;\n}\n/**\n * A public identity for evidence from one immutable Attempt.  It deliberately\n * carries a locator rather than Record's nominal selected-reference capability\n * or an AttemptId that could be used as an ad-hoc storage lookup.\n */\nexport interface AttemptEvidenceIdentity {\n    readonly kind: \"attempt\";\n    readonly locator: AttemptLocator;\n    readonly originRunId: RunId;\n}\nexport type AnalysisSelectionProblem = {\n    readonly code: \"incomplete-run\";\n    readonly runId: RunId;\n} | {\n    readonly code: \"record-core-invalid\";\n    readonly runId: RunId;\n} | {\n    readonly code: \"selection-run-missing\";\n    readonly runId: RunId;\n} | {\n    readonly code: \"selection-run-unreadable\";\n    readonly runId: RunId;\n};\n/**\n * One current target Slot identity. `project-current` keeps only Sample\n * members whose experiment/eval/attempt ordinal aligns, then whose digest\n * still narrows that aligned identity.\n */\nexport interface AnalysisCurrentSlotIdentity {\n    readonly experimentId: ExperimentId;\n    readonly evalId: EvalId;\n    /** Logical attempt identity; never inferred from expectedSlots array order. */\n    readonly attemptOrdinal: number;\n    /** Narrows an already aligned logical identity; it is not the alignment key. */\n    readonly executionIdentityDigest: ExecutionIdentityDigest;\n}\n/** Exact occurrence retained after project-current logical alignment. */\nexport interface AnalysisSlotOccurrenceIdentity {\n    readonly runId: RunId;\n    readonly slotId: SlotId;\n}\n/** Host-issued selection used by Application, CLI, and Report from-record. */\nexport type AnalysisSelectionRequest = {\n    readonly policy: \"explicit-runs\";\n    readonly runIds: readonly RunId[];\n} | {\n    readonly policy: \"project-current\";\n    readonly experimentIds?: readonly ExperimentId[];\n    readonly currentSlots: readonly AnalysisCurrentSlotIdentity[];\n};\n/**\n * The exact selection audit retained by a closed SampleSnapshot. `runIds` are\n * the explicit request; `selectedRunIds` are recomputed from the current,\n * non-excluded Sample frame after every monotonic narrowing.\n */\nexport type AnalysisSelectionSummary = {\n    readonly policy: \"explicit-runs\";\n    readonly runIds: readonly RunId[];\n    readonly selectedRunIds: readonly RunId[];\n    readonly problems: readonly AnalysisSelectionProblem[];\n} | {\n    readonly policy: \"project-current\";\n    readonly experimentIds: readonly ExperimentId[] | \"all\";\n    readonly selectedRunIds: readonly RunId[];\n    readonly problems: readonly AnalysisSelectionProblem[];\n};\nexport interface AnalysisRun {\n    readonly runId: RunId;\n    readonly experimentId: ExperimentId;\n    /**\n     * The safe, immutable portion of the selected Run's Core context. A later\n     * Core read can be unavailable after selection, in which case no context is\n     * invented for that Run.\n     */\n    readonly context: AnalysisRunContext | null;\n    readonly startedAt: UtcMillis;\n    readonly completedAt: UtcMillis;\n    readonly expectedSlots: readonly SlotId[];\n}\n/**\n * Display- and grouping-safe Run configuration retained by a Sample. It has\n * no Record capability and is recursively JSON-only.\n */\nexport interface AnalysisRunContext {\n    readonly execution: AnalysisRunExecution;\n    readonly labels: Readonly<Record<string, string>>;\n}\nexport interface AnalysisRunExecution {\n    readonly agentId: string;\n    readonly model: string | null;\n    readonly reasoningEffort: string | null;\n    readonly flags: Readonly<Record<string, JsonValue>>;\n}\nexport interface AnalysisSlotRef {\n    /** Occurrence identity is always the exact selected Run/Slot pair. */\n    readonly runId: RunId;\n    readonly slotId: SlotId;\n    /** Derived from the associated selected AnalysisRun, never a Record Slot field. */\n    readonly experimentId: ExperimentId;\n    /** Logical alignment is experiment + eval + durable attempt ordinal. */\n    readonly evalId: EvalId;\n    readonly attemptOrdinal: number;\n    /** This remains an identity-narrowing value, never a logical alignment key. */\n    readonly executionIdentityDigest: ExecutionIdentityDigest;\n}\n/** A Member with an exact origin Attempt. */\nexport interface IncludedAnalysisSlot extends AnalysisSlotRef {\n    readonly state: \"included\";\n    /** Core provenance is not inferred from whether the Attempt is local. */\n    readonly action: \"executed\" | \"carried\" | \"accepted\";\n    readonly relation: \"origin\" | \"reference\";\n    readonly attempt: AttemptEvidenceIdentity;\n}\n/**\n * An expected Slot without an Attempt. `null` means no Member document was\n * recorded; the two actions retain a recorded null Member without suggesting\n * that it is pending work.\n */\nexport interface NotRecordedAnalysisSlot extends AnalysisSlotRef {\n    readonly state: \"not-recorded\";\n    readonly action: \"not-dispatched\" | \"interrupted\" | null;\n    readonly attempt: null;\n}\n/** Core could be read far enough to identify the frame but not its member. */\nexport interface CoreInvalidAnalysisSlot extends AnalysisSlotRef {\n    readonly state: \"core-invalid\";\n    readonly action: MembershipAction | null;\n    readonly attempt: null;\n    readonly issues: readonly AnalysisIssue[];\n}\nexport type ActiveAnalysisSlot = IncludedAnalysisSlot | NotRecordedAnalysisSlot | CoreInvalidAnalysisSlot;\n/** A monotonic Sample narrowing preserves the previous, non-nested state. */\nexport interface ExcludedAnalysisSlot extends AnalysisSlotRef {\n    readonly state: \"excluded\";\n    readonly base: ActiveAnalysisSlot;\n    /** Present when `project-current` dropped this Slot for identity mismatch. */\n    readonly reason?: \"identity-mismatch\";\n}\nexport type AnalysisSlot = ActiveAnalysisSlot | ExcludedAnalysisSlot;\nexport interface SampleCoverage {\n    readonly frameTotal: number;\n    readonly selected: number;\n    readonly included: number;\n    readonly notRecorded: number;\n    readonly coreInvalid: number;\n    readonly excluded: number;\n}\n/**\n * The closed, portable representation of a Record selection. It contains\n * only selection identity, Core-derived Run/Slot denominator facts, and\n * selection problems. Decoding it can never reopen a Record.\n */\nexport interface SampleSnapshot {\n    readonly version: 1;\n    readonly identity: SampleIdentity;\n    readonly selection: AnalysisSelectionSummary;\n    readonly runs: readonly AnalysisRun[];\n    readonly slots: readonly AnalysisSlot[];\n    readonly coverage: SampleCoverage;\n}\nexport const sampleCapabilityTypeId: unique symbol = Symbol(\"niceeval.analysis.Sample\");\n/** A Host-issued, Scope-bound lazy Record-reading capability. */\nexport interface Sample {\n    readonly kind: \"analysis-sample\";\n    readonly snapshot: SampleSnapshot;\n    readonly [sampleCapabilityTypeId]: true;\n}\nexport type ExperimentGroupIdentity = {\n    readonly kind: \"named\";\n    readonly groupId: string;\n    readonly key: `named/${string}`;\n} | {\n    readonly kind: \"singleton\";\n    readonly experimentId: ExperimentId;\n    readonly key: `singleton/${string}`;\n};\nexport type NonComparableReason = \"eval-population-mismatch\";\nexport interface NonComparableIssue {\n    readonly reason: NonComparableReason;\n    readonly members: readonly ExperimentId[];\n    readonly actual: readonly {\n        readonly member: ExperimentId;\n        readonly population: JsonValue | null;\n        readonly basis: JsonValue | null;\n    }[];\n    readonly refs: readonly EvidenceRef[];\n    readonly params: Readonly<Record<string, JsonValue>>;\n}\nexport type ExperimentComparisonState = {\n    readonly state: \"comparable\";\n    readonly members: readonly ExperimentId[];\n} | {\n    readonly state: \"non-comparable\";\n    readonly members: readonly ExperimentId[];\n    readonly issues: readonly NonComparableIssue[];\n};\nconst experimentComparisonScopeTypeId: unique symbol = Symbol(\"niceeval.analysis.ExperimentComparisonScope\");\n/** Analysis-issued comparison capability; the backing Sample remains private. */\nexport interface ExperimentComparisonScope {\n    readonly group: ExperimentGroupIdentity;\n    readonly comparison: ExperimentComparisonState;\n    readonly [experimentComparisonScopeTypeId]: true;\n}\nexport interface AnalysisComparisonGroupMismatchError {\n    readonly code: \"analysis-comparison-group-mismatch\";\n    readonly groups: readonly ExperimentGroupIdentity[];\n}\nexport interface SampleSelector {\n    readonly runIds?: readonly RunId[];\n    readonly slotIds?: readonly SlotId[];\n}\nexport interface SampleClosedError {\n    readonly code: \"analysis-sample-closed\";\n    readonly sample: SampleIdentity;\n}\nexport interface SampleSnapshotCodecError {\n    readonly code: \"sample-snapshot-invalid\";\n    readonly path: readonly string[];\n    readonly reason: string;\n}\nexport interface AnalysisRequestError {\n    readonly code: \"analysis-request-invalid\";\n    readonly reason: string;\n}\nexport type AnalysisInputIssueCode = \"missing\" | \"migration-required\" | \"unsupported\" | \"producer-incompatible\" | \"input-invalid\" | \"reduction-failed\" | \"relation-unmatched\";\nexport interface EvidenceIdentity {\n    readonly kind: \"attempt\";\n    readonly locator: AttemptLocator;\n}\nexport interface EvidenceRef {\n    readonly identity: EvidenceIdentity;\n}\nexport interface AnalysisIssue {\n    readonly code: AnalysisInputIssueCode;\n    readonly message: string;\n    readonly refs: readonly EvidenceRef[];\n}\nexport interface ProducerIdentity {\n    readonly id: string;\n}\n/** Internal result of a published AnalysisInput read. It never reaches Report. */\nexport type SampleInputObservation<Value> = {\n    readonly state: \"value\";\n    readonly value: Value;\n    readonly refs: readonly EvidenceRef[];\n    readonly producer?: ProducerIdentity;\n} | {\n    readonly state: \"missing\" | \"migration-required\" | \"unsupported\" | \"failed\";\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n    readonly producer?: ProducerIdentity;\n};\nexport type MetricState = \"available\" | \"partial\"\n/** A specialized closed metric may have no reportable value at all. */\n | \"unavailable\" | \"empty\" | \"migration-required\" | \"unsupported\" | \"failed\";\nexport type MetricBasis = \"attempt\" | \"eval\" | \"run\" | \"pair\" | \"slot\";\nexport type MeasureFormat = string | {\n    readonly kind: string;\n    readonly options?: JsonValue;\n};\n/** A closed Measure cell: never a selected Record handle or reader callback. */\nexport interface MetricValue<Value = number> {\n    readonly value: Value | null;\n    readonly state: MetricState;\n    readonly samples: number;\n    readonly total: number;\n    readonly basis: MetricBasis;\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n    readonly unit?: string;\n    readonly format?: MeasureFormat;\n    readonly better?: \"higher\" | \"lower\" | \"neutral\";\n    readonly bounds?: {\n        readonly min?: number;\n        readonly max?: number;\n    };\n}\nexport interface ClosedRowsIdentity {\n    readonly kind: \"closed-rows\";\n    readonly id: string;\n}\nconst closedRowsTypeId: unique symbol = Symbol(\"niceeval.analysis.ClosedRows\");\n/** @internal Metadata is retained out-of-band so an ordinary array cannot forge it. */\nexport interface ClosedRowsMetadata {\n    readonly identity: ClosedRowsIdentity;\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}\nconst closedRowsBrands = new WeakSet<object>();\nconst closedRowsMetadataByValue = new WeakMap<object, ClosedRowsMetadata>();\n/** A branded, frozen array produced only by Analysis query execution. */\nexport interface ClosedRows<Row> extends ReadonlyArray<Readonly<Row>> {\n    readonly [closedRowsTypeId]: true;\n    readonly identity: ClosedRowsIdentity;\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}\n/** @internal Keeps the brand unforgeable to normal public callers. */\nexport function makeClosedRows<Row>(input: {\n    readonly rows: readonly Readonly<Row>[];\n    readonly identity: ClosedRowsIdentity;\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}): ClosedRows<Row> {\n    const rows = [...input.rows] as unknown as ClosedRows<Row>;\n    const metadata: ClosedRowsMetadata = Object.freeze({\n        identity: Object.freeze({ kind: input.identity.kind, id: input.identity.id }),\n        issues: Object.freeze([...input.issues]),\n        refs: Object.freeze([...input.refs]),\n    });\n    Object.defineProperties(rows, {\n        [closedRowsTypeId]: { value: true, enumerable: false },\n        identity: { value: metadata.identity, enumerable: true },\n        issues: { value: metadata.issues, enumerable: true },\n        refs: { value: metadata.refs, enumerable: true },\n    });\n    closedRowsBrands.add(rows);\n    closedRowsMetadataByValue.set(rows, metadata);\n    return Object.freeze(rows);\n}\n/** @internal Checks actual Analysis issuance, rather than structural shape. */\nexport function isClosedRows(value: unknown): value is ClosedRows<unknown> {\n    return Array.isArray(value)\n        && closedRowsBrands.has(value)\n        && Reflect.get(value, closedRowsTypeId) === true;\n}\n/** @internal Returns immutable metadata registered at Analysis close time. */\nexport function closedRowsMetadata(value: unknown): ClosedRowsMetadata | undefined {\n    return isClosedRows(value) ? closedRowsMetadataByValue.get(value) : undefined;\n}\nexport interface PopulationIdentity {\n    readonly kind: \"population\";\n    readonly id: string;\n}\n/** The common, entirely closed base of every published DomainView. */\nexport interface DomainView {\n    readonly kind: \"domain-view\";\n    readonly identity: {\n        readonly kind: \"domain-view\";\n        readonly id: string;\n    };\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}\n"]}

package/dist/analysis/contracts.d.cts

@@ -178,6 +178,46 @@ export interface Sample {
     readonly snapshot: SampleSnapshot;
     readonly [sampleCapabilityTypeId]: true;
 }
+export type ExperimentGroupIdentity = {
+    readonly kind: "named";
+    readonly groupId: string;
+    readonly key: `named/${string}`;
+} | {
+    readonly kind: "singleton";
+    readonly experimentId: ExperimentId;
+    readonly key: `singleton/${string}`;
+};
+export type NonComparableReason = "eval-population-mismatch";
+export interface NonComparableIssue {
+    readonly reason: NonComparableReason;
+    readonly members: readonly ExperimentId[];
+    readonly actual: readonly {
+        readonly member: ExperimentId;
+        readonly population: JsonValue | null;
+        readonly basis: JsonValue | null;
+    }[];
+    readonly refs: readonly EvidenceRef[];
+    readonly params: Readonly<Record<string, JsonValue>>;
+}
+export type ExperimentComparisonState = {
+    readonly state: "comparable";
+    readonly members: readonly ExperimentId[];
+} | {
+    readonly state: "non-comparable";
+    readonly members: readonly ExperimentId[];
+    readonly issues: readonly NonComparableIssue[];
+};
+declare const experimentComparisonScopeTypeId: unique symbol;
+/** Analysis-issued comparison capability; the backing Sample remains private. */
+export interface ExperimentComparisonScope {
+    readonly group: ExperimentGroupIdentity;
+    readonly comparison: ExperimentComparisonState;
+    readonly [experimentComparisonScopeTypeId]: true;
+}
+export interface AnalysisComparisonGroupMismatchError {
+    readonly code: "analysis-comparison-group-mismatch";
+    readonly groups: readonly ExperimentGroupIdentity[];
+}
 export interface SampleSelector {
     readonly runIds?: readonly RunId[];
     readonly slotIds?: readonly SlotId[];
@@ -195,7 +235,7 @@ export interface AnalysisRequestError {
     readonly code: "analysis-request-invalid";
     readonly reason: string;
 }
-export type AnalysisInputIssueCode = "missing" | "unsupported" | "producer-incompatible" | "input-invalid" | "reduction-failed" | "relation-unmatched";
+export type AnalysisInputIssueCode = "missing" | "migration-required" | "unsupported" | "producer-incompatible" | "input-invalid" | "reduction-failed" | "relation-unmatched";
 export interface EvidenceIdentity {
     readonly kind: "attempt";
     readonly locator: AttemptLocator;
@@ -218,14 +258,14 @@ export type SampleInputObservation<Value> = {
     readonly refs: readonly EvidenceRef[];
     readonly producer?: ProducerIdentity;
 } | {
-    readonly state: "missing" | "unsupported" | "failed";
+    readonly state: "missing" | "migration-required" | "unsupported" | "failed";
     readonly issues: readonly AnalysisIssue[];
     readonly refs: readonly EvidenceRef[];
     readonly producer?: ProducerIdentity;
 };
 export type MetricState = "available" | "partial"
 /** A specialized closed metric may have no reportable value at all. */
- | "unavailable" | "empty" | "unsupported" | "failed";
+ | "unavailable" | "empty" | "migration-required" | "unsupported" | "failed";
 export type MetricBasis = "attempt" | "eval" | "run" | "pair" | "slot";
 export type MeasureFormat = string | {
     readonly kind: string;