niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/library/details.cjs

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.experimentDetailParams = exports.attemptDetailParams = void 0;
+exports.attemptDetailTarget = attemptDetailTarget;
+exports.experimentDetailTarget = experimentDetailTarget;
+exports.libraryDetailRoute = libraryDetailRoute;
+exports.attemptDetailRoute = attemptDetailRoute;
+exports.experimentDetailRoute = experimentDetailRoute;
+const node_crypto_1 = require("node:crypto");
+const attempt_locator_ts_1 = require("../../attempt-locator.cjs");
+const ATTEMPT_DETAIL_PATH = "/attempt";
+const EXPERIMENT_DETAIL_PATH = "/experiment";
+const ATTEMPT_DETAIL_KEY_PATTERN = /^a1[0-9a-hjkmnp-tv-z]{12}$/;
+const EXPERIMENT_DETAIL_KEY_PATTERN = /^e1[a-f0-9]{24}$/;
+const CROCKFORD_BASE32 = "0123456789abcdefghjkmnpqrstvwxyz";
+const ATTEMPT_KEY_BITS = 60n;
+const ATTEMPT_KEY_MASK = (1n << ATTEMPT_KEY_BITS) - 1n;
+/*
+ * A parameter decoder receives only the route key, not a Sample.  Attempt
+ * pages therefore use a reversible address permutation: direct `show` can
+ * recover the locator for the Sample-bound evidence check, while the route
+ * never serializes the human-facing `@1…` locator itself.  This is address
+ * notation, not an authorization capability; the Page loader still proves
+ * Sample membership through its public data boundary.
+ */
+const ATTEMPT_KEY_OFFSET = 0x0d6e8f5a31c9b47n;
+/** Creates a canonical Attempt target before it is encoded into a route key. */
+function attemptDetailTarget(locator) {
+    const parsed = (0, attempt_locator_ts_1.parseAttemptLocator)(locator);
+    if (!parsed.valid)
+        throw new TypeError("Attempt detail targets require a canonical Attempt locator");
+    return Object.freeze({ kind: "attempt", locator: parsed.locator });
+}
+/** Creates an opaque Experiment target without retaining its durable identity. */
+function experimentDetailTarget(experimentId) {
+    return experimentTargetFromKey(experimentDetailKey(experimentId));
+}
+/** Returns the sole product route shape for either standard detail target. */
+function libraryDetailRoute(target) {
+    if (isDirectObject(target) && target.kind === "attempt") {
+        return `${ATTEMPT_DETAIL_PATH}/${attemptDetailKey(target)}`;
+    }
+    if (isDirectObject(target) && target.kind === "experiment") {
+        return `${EXPERIMENT_DETAIL_PATH}/${experimentDetailKeyFromTarget(target)}`;
+    }
+    throw new TypeError("Library detail routes require an Attempt or Experiment detail target");
+}
+/** Returns the route for one canonical Attempt locator without exposing it in the path. */
+function attemptDetailRoute(locator) {
+    return libraryDetailRoute(attemptDetailTarget(locator));
+}
+/** Returns the route for one Experiment without exposing its durable identity in the path. */
+function experimentDetailRoute(experimentId) {
+    return libraryDetailRoute(experimentDetailTarget(experimentId));
+}
+/** Codec for standard Attempt pages. Enumeration is derived only from the fixed Sample snapshot. */
+exports.attemptDetailParams = Object.freeze({
+    encode: attemptDetailKey,
+    decode: decodeAttemptDetailTarget,
+    enumerate: enumerateAttemptDetailTargets,
+});
+/** Codec for standard Experiment pages. Enumeration is derived only from the fixed Sample snapshot. */
+exports.experimentDetailParams = Object.freeze({
+    encode: experimentDetailKeyFromTarget,
+    decode: decodeExperimentDetailTarget,
+    enumerate: enumerateExperimentDetailTargets,
+});
+function attemptDetailKey(value) {
+    const target = attemptTargetFrom(value);
+    const locatorBits = decodeCrockford(target.locator.slice(2));
+    const routeBits = (locatorBits + ATTEMPT_KEY_OFFSET) & ATTEMPT_KEY_MASK;
+    return `a1${encodeCrockford(routeBits)}`;
+}
+function decodeAttemptDetailTarget(key) {
+    if (!ATTEMPT_DETAIL_KEY_PATTERN.test(key)) {
+        throw new TypeError("Attempt detail route key is not canonical");
+    }
+    const routeBits = decodeCrockford(key.slice(2));
+    const locatorBits = (routeBits - ATTEMPT_KEY_OFFSET) & ATTEMPT_KEY_MASK;
+    const parsed = (0, attempt_locator_ts_1.parseAttemptLocator)(`@1${encodeCrockford(locatorBits).toUpperCase()}`);
+    if (!parsed.valid)
+        throw new TypeError("Attempt detail route key cannot decode to a canonical locator");
+    return attemptDetailTarget(parsed.locator);
+}
+function enumerateAttemptDetailTargets(sample) {
+    const keys = new Set();
+    for (const slot of sample.snapshot.slots) {
+        if (slot.state === "included")
+            keys.add(attemptDetailKey(attemptDetailTarget(slot.attempt.locator)));
+    }
+    return Object.freeze([...keys]
+        .sort(compareText)
+        .map((key) => decodeAttemptDetailTarget(key)));
+}
+function experimentDetailKeyFromTarget(value) {
+    if (!isDirectObject(value) || value.kind !== "experiment" || typeof value.key !== "string" ||
+        !EXPERIMENT_DETAIL_KEY_PATTERN.test(value.key)) {
+        throw new TypeError("Experiment detail params must use a canonical opaque target");
+    }
+    return value.key;
+}
+function decodeExperimentDetailTarget(key) {
+    if (!EXPERIMENT_DETAIL_KEY_PATTERN.test(key)) {
+        throw new TypeError("Experiment detail route key is not canonical");
+    }
+    return experimentTargetFromKey(key);
+}
+function enumerateExperimentDetailTargets(sample) {
+    const identitiesByKey = new Map();
+    for (const slot of sample.snapshot.slots) {
+        if (slot.state === "excluded")
+            continue;
+        const key = experimentDetailKey(slot.experimentId);
+        const previous = identitiesByKey.get(key);
+        if (previous !== undefined && previous !== slot.experimentId) {
+            throw new TypeError("two Sample Experiments produced the same detail route key");
+        }
+        identitiesByKey.set(key, slot.experimentId);
+    }
+    return Object.freeze([...identitiesByKey.keys()]
+        .sort(compareText)
+        .map((key) => decodeExperimentDetailTarget(key)));
+}
+function experimentDetailKey(experimentId) {
+    const digest = (0, node_crypto_1.createHash)("sha256")
+        .update("niceeval.report.experiment-detail/v1\\0", "utf8")
+        .update(String(experimentId), "utf8")
+        .digest("hex");
+    return `e1${digest.slice(0, 24)}`;
+}
+function attemptTargetFrom(value) {
+    if (!isDirectObject(value) || value.kind !== "attempt" || typeof value.locator !== "string") {
+        throw new TypeError("Attempt detail params must use a canonical target");
+    }
+    return attemptDetailTarget(value.locator);
+}
+function experimentTargetFromKey(key) {
+    return Object.freeze({ kind: "experiment", key });
+}
+function decodeCrockford(value) {
+    let result = 0n;
+    for (const character of value) {
+        const digit = CROCKFORD_BASE32.indexOf(character.toLowerCase());
+        if (digit < 0)
+            throw new TypeError("Attempt detail route key is not canonical");
+        result = (result << 5n) | BigInt(digit);
+    }
+    return result;
+}
+function encodeCrockford(value) {
+    let remaining = value;
+    let result = "";
+    for (let index = 0; index < Number(ATTEMPT_KEY_BITS / 5n); index += 1) {
+        result = CROCKFORD_BASE32[Number(remaining & 31n)] + result;
+        remaining >>= 5n;
+    }
+    return result;
+}
+function isDirectObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) &&
+        (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=details.cjs.map

package/dist/report/library/details.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.js","sourceRoot":"","sources":["details.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { ExperimentId, JsonValue, Sample, } from \"../../analysis/index.ts\";\nimport { parseAttemptLocator, type AttemptLocator, } from \"../../attempt-locator.ts\";\nimport type { PageParams } from \"../definition/report.ts\";\nconst ATTEMPT_DETAIL_PATH = \"/attempt\";\nconst EXPERIMENT_DETAIL_PATH = \"/experiment\";\nconst ATTEMPT_DETAIL_KEY_PATTERN = /^a1[0-9a-hjkmnp-tv-z]{12}$/;\nconst EXPERIMENT_DETAIL_KEY_PATTERN = /^e1[a-f0-9]{24}$/;\nconst CROCKFORD_BASE32 = \"0123456789abcdefghjkmnpqrstvwxyz\";\nconst ATTEMPT_KEY_BITS = 60n;\nconst ATTEMPT_KEY_MASK = (1n << ATTEMPT_KEY_BITS) - 1n;\n/*\n * A parameter decoder receives only the route key, not a Sample.  Attempt\n * pages therefore use a reversible address permutation: direct `show` can\n * recover the locator for the Sample-bound evidence check, while the route\n * never serializes the human-facing `@1…` locator itself.  This is address\n * notation, not an authorization capability; the Page loader still proves\n * Sample membership through its public data boundary.\n */\nconst ATTEMPT_KEY_OFFSET = 0x0d6e8f5a31c9b47n;\n/** A closed Attempt identity accepted by the standard Attempt detail Page. */\nexport type AttemptDetailTarget = Readonly<Record<string, JsonValue>> & Readonly<{\n    readonly kind: \"attempt\";\n    readonly locator: AttemptLocator;\n}>;\n/** A route-safe Experiment identity; its durable ExperimentId never enters the target. */\nexport type ExperimentDetailTarget = Readonly<Record<string, JsonValue>> & Readonly<{\n    readonly kind: \"experiment\";\n    readonly key: string;\n}>;\n/** The only typed target accepted by the product detail-route helper. */\nexport type LibraryDetailTarget = AttemptDetailTarget | ExperimentDetailTarget;\n/** Creates a canonical Attempt target before it is encoded into a route key. */\nexport function attemptDetailTarget(locator: AttemptLocator): AttemptDetailTarget {\n    const parsed = parseAttemptLocator(locator);\n    if (!parsed.valid)\n        throw new TypeError(\"Attempt detail targets require a canonical Attempt locator\");\n    return Object.freeze({ kind: \"attempt\" as const, locator: parsed.locator });\n}\n/** Creates an opaque Experiment target without retaining its durable identity. */\nexport function experimentDetailTarget(experimentId: ExperimentId): ExperimentDetailTarget {\n    return experimentTargetFromKey(experimentDetailKey(experimentId));\n}\n/** Returns the sole product route shape for either standard detail target. */\nexport function libraryDetailRoute(target: LibraryDetailTarget): string {\n    if (isDirectObject(target) && target.kind === \"attempt\") {\n        return `${ATTEMPT_DETAIL_PATH}/${attemptDetailKey(target)}`;\n    }\n    if (isDirectObject(target) && target.kind === \"experiment\") {\n        return `${EXPERIMENT_DETAIL_PATH}/${experimentDetailKeyFromTarget(target)}`;\n    }\n    throw new TypeError(\"Library detail routes require an Attempt or Experiment detail target\");\n}\n/** Returns the route for one canonical Attempt locator without exposing it in the path. */\nexport function attemptDetailRoute(locator: AttemptLocator): string {\n    return libraryDetailRoute(attemptDetailTarget(locator));\n}\n/** Returns the route for one Experiment without exposing its durable identity in the path. */\nexport function experimentDetailRoute(experimentId: ExperimentId): string {\n    return libraryDetailRoute(experimentDetailTarget(experimentId));\n}\n/** Codec for standard Attempt pages. Enumeration is derived only from the fixed Sample snapshot. */\nexport const attemptDetailParams: PageParams<AttemptDetailTarget> = Object.freeze({\n    encode: attemptDetailKey,\n    decode: decodeAttemptDetailTarget,\n    enumerate: enumerateAttemptDetailTargets,\n});\n/** Codec for standard Experiment pages. Enumeration is derived only from the fixed Sample snapshot. */\nexport const experimentDetailParams: PageParams<ExperimentDetailTarget> = Object.freeze({\n    encode: experimentDetailKeyFromTarget,\n    decode: decodeExperimentDetailTarget,\n    enumerate: enumerateExperimentDetailTargets,\n});\nfunction attemptDetailKey(value: AttemptDetailTarget): string {\n    const target = attemptTargetFrom(value);\n    const locatorBits = decodeCrockford(target.locator.slice(2));\n    const routeBits = (locatorBits + ATTEMPT_KEY_OFFSET) & ATTEMPT_KEY_MASK;\n    return `a1${encodeCrockford(routeBits)}`;\n}\nfunction decodeAttemptDetailTarget(key: string): AttemptDetailTarget {\n    if (!ATTEMPT_DETAIL_KEY_PATTERN.test(key)) {\n        throw new TypeError(\"Attempt detail route key is not canonical\");\n    }\n    const routeBits = decodeCrockford(key.slice(2));\n    const locatorBits = (routeBits - ATTEMPT_KEY_OFFSET) & ATTEMPT_KEY_MASK;\n    const parsed = parseAttemptLocator(`@1${encodeCrockford(locatorBits).toUpperCase()}`);\n    if (!parsed.valid)\n        throw new TypeError(\"Attempt detail route key cannot decode to a canonical locator\");\n    return attemptDetailTarget(parsed.locator);\n}\nfunction enumerateAttemptDetailTargets(sample: Sample): readonly AttemptDetailTarget[] {\n    const keys = new Set<string>();\n    for (const slot of sample.snapshot.slots) {\n        if (slot.state === \"included\")\n            keys.add(attemptDetailKey(attemptDetailTarget(slot.attempt.locator)));\n    }\n    return Object.freeze([...keys]\n        .sort(compareText)\n        .map((key) => decodeAttemptDetailTarget(key)));\n}\nfunction experimentDetailKeyFromTarget(value: ExperimentDetailTarget): string {\n    if (!isDirectObject(value) || value.kind !== \"experiment\" || typeof value.key !== \"string\" ||\n        !EXPERIMENT_DETAIL_KEY_PATTERN.test(value.key)) {\n        throw new TypeError(\"Experiment detail params must use a canonical opaque target\");\n    }\n    return value.key;\n}\nfunction decodeExperimentDetailTarget(key: string): ExperimentDetailTarget {\n    if (!EXPERIMENT_DETAIL_KEY_PATTERN.test(key)) {\n        throw new TypeError(\"Experiment detail route key is not canonical\");\n    }\n    return experimentTargetFromKey(key);\n}\nfunction enumerateExperimentDetailTargets(sample: Sample): readonly ExperimentDetailTarget[] {\n    const identitiesByKey = new Map<string, ExperimentId>();\n    for (const slot of sample.snapshot.slots) {\n        if (slot.state === \"excluded\")\n            continue;\n        const key = experimentDetailKey(slot.experimentId);\n        const previous = identitiesByKey.get(key);\n        if (previous !== undefined && previous !== slot.experimentId) {\n            throw new TypeError(\"two Sample Experiments produced the same detail route key\");\n        }\n        identitiesByKey.set(key, slot.experimentId);\n    }\n    return Object.freeze([...identitiesByKey.keys()]\n        .sort(compareText)\n        .map((key) => decodeExperimentDetailTarget(key)));\n}\nfunction experimentDetailKey(experimentId: ExperimentId): string {\n    const digest = createHash(\"sha256\")\n        .update(\"niceeval.report.experiment-detail/v1\\\\0\", \"utf8\")\n        .update(String(experimentId), \"utf8\")\n        .digest(\"hex\");\n    return `e1${digest.slice(0, 24)}`;\n}\nfunction attemptTargetFrom(value: unknown): AttemptDetailTarget {\n    if (!isDirectObject(value) || value.kind !== \"attempt\" || typeof value.locator !== \"string\") {\n        throw new TypeError(\"Attempt detail params must use a canonical target\");\n    }\n    return attemptDetailTarget(value.locator as AttemptLocator);\n}\nfunction experimentTargetFromKey(key: string): ExperimentDetailTarget {\n    return Object.freeze({ kind: \"experiment\" as const, key });\n}\nfunction decodeCrockford(value: string): bigint {\n    let result = 0n;\n    for (const character of value) {\n        const digit = CROCKFORD_BASE32.indexOf(character.toLowerCase());\n        if (digit < 0)\n            throw new TypeError(\"Attempt detail route key is not canonical\");\n        result = (result << 5n) | BigInt(digit);\n    }\n    return result;\n}\nfunction encodeCrockford(value: bigint): string {\n    let remaining = value;\n    let result = \"\";\n    for (let index = 0; index < Number(ATTEMPT_KEY_BITS / 5n); index += 1) {\n        result = CROCKFORD_BASE32[Number(remaining & 31n)]! + result;\n        remaining >>= 5n;\n    }\n    return result;\n}\nfunction isDirectObject(value: unknown): value is Readonly<Record<string, unknown>> {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value) &&\n        (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);\n}\nfunction compareText(left: string, right: string): number {\n    return left < right ? -1 : left > right ? 1 : 0;\n}\n"]}

package/dist/report/library/details.d.cts

@@ -0,0 +1,29 @@
+import type { ExperimentId, JsonValue } from "../../analysis/index.cjs";
+import { type AttemptLocator } from "../../attempt-locator.cjs";
+import type { PageParams } from "../definition/report.cjs";
+/** A closed Attempt identity accepted by the standard Attempt detail Page. */
+export type AttemptDetailTarget = Readonly<Record<string, JsonValue>> & Readonly<{
+    readonly kind: "attempt";
+    readonly locator: AttemptLocator;
+}>;
+/** A route-safe Experiment identity; its durable ExperimentId never enters the target. */
+export type ExperimentDetailTarget = Readonly<Record<string, JsonValue>> & Readonly<{
+    readonly kind: "experiment";
+    readonly key: string;
+}>;
+/** The only typed target accepted by the product detail-route helper. */
+export type LibraryDetailTarget = AttemptDetailTarget | ExperimentDetailTarget;
+/** Creates a canonical Attempt target before it is encoded into a route key. */
+export declare function attemptDetailTarget(locator: AttemptLocator): AttemptDetailTarget;
+/** Creates an opaque Experiment target without retaining its durable identity. */
+export declare function experimentDetailTarget(experimentId: ExperimentId): ExperimentDetailTarget;
+/** Returns the sole product route shape for either standard detail target. */
+export declare function libraryDetailRoute(target: LibraryDetailTarget): string;
+/** Returns the route for one canonical Attempt locator without exposing it in the path. */
+export declare function attemptDetailRoute(locator: AttemptLocator): string;
+/** Returns the route for one Experiment without exposing its durable identity in the path. */
+export declare function experimentDetailRoute(experimentId: ExperimentId): string;
+/** Codec for standard Attempt pages. Enumeration is derived only from the fixed Sample snapshot. */
+export declare const attemptDetailParams: PageParams<AttemptDetailTarget>;
+/** Codec for standard Experiment pages. Enumeration is derived only from the fixed Sample snapshot. */
+export declare const experimentDetailParams: PageParams<ExperimentDetailTarget>;

package/dist/report/library/details.d.mts

@@ -0,0 +1,29 @@
+import type { ExperimentId, JsonValue } from "../../analysis/index.mjs";
+import { type AttemptLocator } from "../../attempt-locator.mjs";
+import type { PageParams } from "../definition/report.mjs";
+/** A closed Attempt identity accepted by the standard Attempt detail Page. */
+export type AttemptDetailTarget = Readonly<Record<string, JsonValue>> & Readonly<{
+    readonly kind: "attempt";
+    readonly locator: AttemptLocator;
+}>;
+/** A route-safe Experiment identity; its durable ExperimentId never enters the target. */
+export type ExperimentDetailTarget = Readonly<Record<string, JsonValue>> & Readonly<{
+    readonly kind: "experiment";
+    readonly key: string;
+}>;
+/** The only typed target accepted by the product detail-route helper. */
+export type LibraryDetailTarget = AttemptDetailTarget | ExperimentDetailTarget;
+/** Creates a canonical Attempt target before it is encoded into a route key. */
+export declare function attemptDetailTarget(locator: AttemptLocator): AttemptDetailTarget;
+/** Creates an opaque Experiment target without retaining its durable identity. */
+export declare function experimentDetailTarget(experimentId: ExperimentId): ExperimentDetailTarget;
+/** Returns the sole product route shape for either standard detail target. */
+export declare function libraryDetailRoute(target: LibraryDetailTarget): string;
+/** Returns the route for one canonical Attempt locator without exposing it in the path. */
+export declare function attemptDetailRoute(locator: AttemptLocator): string;
+/** Returns the route for one Experiment without exposing its durable identity in the path. */
+export declare function experimentDetailRoute(experimentId: ExperimentId): string;
+/** Codec for standard Attempt pages. Enumeration is derived only from the fixed Sample snapshot. */
+export declare const attemptDetailParams: PageParams<AttemptDetailTarget>;
+/** Codec for standard Experiment pages. Enumeration is derived only from the fixed Sample snapshot. */
+export declare const experimentDetailParams: PageParams<ExperimentDetailTarget>;

package/dist/report/library/details.d.ts

@@ -0,0 +1,29 @@
+import type { ExperimentId, JsonValue } from "../../analysis/index.js";
+import { type AttemptLocator } from "../../attempt-locator.js";
+import type { PageParams } from "../definition/report.js";
+/** A closed Attempt identity accepted by the standard Attempt detail Page. */
+export type AttemptDetailTarget = Readonly<Record<string, JsonValue>> & Readonly<{
+    readonly kind: "attempt";
+    readonly locator: AttemptLocator;
+}>;
+/** A route-safe Experiment identity; its durable ExperimentId never enters the target. */
+export type ExperimentDetailTarget = Readonly<Record<string, JsonValue>> & Readonly<{
+    readonly kind: "experiment";
+    readonly key: string;
+}>;
+/** The only typed target accepted by the product detail-route helper. */
+export type LibraryDetailTarget = AttemptDetailTarget | ExperimentDetailTarget;
+/** Creates a canonical Attempt target before it is encoded into a route key. */
+export declare function attemptDetailTarget(locator: AttemptLocator): AttemptDetailTarget;
+/** Creates an opaque Experiment target without retaining its durable identity. */
+export declare function experimentDetailTarget(experimentId: ExperimentId): ExperimentDetailTarget;
+/** Returns the sole product route shape for either standard detail target. */
+export declare function libraryDetailRoute(target: LibraryDetailTarget): string;
+/** Returns the route for one canonical Attempt locator without exposing it in the path. */
+export declare function attemptDetailRoute(locator: AttemptLocator): string;
+/** Returns the route for one Experiment without exposing its durable identity in the path. */
+export declare function experimentDetailRoute(experimentId: ExperimentId): string;
+/** Codec for standard Attempt pages. Enumeration is derived only from the fixed Sample snapshot. */
+export declare const attemptDetailParams: PageParams<AttemptDetailTarget>;
+/** Codec for standard Experiment pages. Enumeration is derived only from the fixed Sample snapshot. */
+export declare const experimentDetailParams: PageParams<ExperimentDetailTarget>;

package/dist/report/library/details.js

@@ -0,0 +1,18 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./details.cjs");
+const __niceevalExport0 = __niceevalCanonical["attemptDetailParams"];
+export { __niceevalExport0 as attemptDetailParams };
+const __niceevalExport1 = __niceevalCanonical["attemptDetailRoute"];
+export { __niceevalExport1 as attemptDetailRoute };
+const __niceevalExport2 = __niceevalCanonical["attemptDetailTarget"];
+export { __niceevalExport2 as attemptDetailTarget };
+const __niceevalExport3 = __niceevalCanonical["experimentDetailParams"];
+export { __niceevalExport3 as experimentDetailParams };
+const __niceevalExport4 = __niceevalCanonical["experimentDetailRoute"];
+export { __niceevalExport4 as experimentDetailRoute };
+const __niceevalExport5 = __niceevalCanonical["experimentDetailTarget"];
+export { __niceevalExport5 as experimentDetailTarget };
+const __niceevalExport6 = __niceevalCanonical["libraryDetailRoute"];
+export { __niceevalExport6 as libraryDetailRoute };
+//# sourceMappingURL=details.js.map

package/dist/report/library/details.js.map

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

package/dist/report/model/aggregate.cjs

@@ -0,0 +1,243 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reasoningEffort = exports.model = exports.agent = exports.attempt = exports.evalId = exports.experiment = exports.ReportGroupFunctionError = exports.ReportAggregateRequestError = void 0;
+exports.flag = flag;
+exports.label = label;
+exports.aggregate = aggregate;
+const index_ts_1 = require("../../analysis/index.cjs");
+/**
+ * Invalid Report facade input is a request error, not a manufactured
+ * MetricValue.  Errors thrown by an individual GroupFunction occur inside
+ * Analysis's Dimension evaluation and therefore become the usual
+ * `input-invalid` Analysis issue on its closed row.
+ */
+class ReportAggregateRequestError extends Error {
+    code = "report-aggregate-invalid";
+    constructor(reason) {
+        super(reason);
+        this.name = "ReportAggregateRequestError";
+    }
+}
+exports.ReportAggregateRequestError = ReportAggregateRequestError;
+/** A non-string custom group result is an honest Analysis input problem. */
+class ReportGroupFunctionError extends Error {
+    code = "report-group-function-invalid";
+    constructor(reason) {
+        super(reason);
+        this.name = "ReportGroupFunctionError";
+    }
+}
+exports.ReportGroupFunctionError = ReportGroupFunctionError;
+/** Safe built-in Dimension over a closed logical-Slot identity. */
+exports.experiment = (0, index_ts_1.defineDimension)({
+    id: "niceeval.report.experiment",
+    population: index_ts_1.logicalSlots,
+    value: (slot) => slot.experimentId,
+});
+/** Safe built-in Dimension over a closed logical-Slot identity. */
+exports.evalId = (0, index_ts_1.defineDimension)({
+    id: "niceeval.report.eval-id",
+    population: index_ts_1.logicalSlots,
+    value: (slot) => slot.evalId,
+});
+/** The selected Attempt locator, or null for an expected Slot without one. */
+exports.attempt = (0, index_ts_1.defineDimension)({
+    id: "niceeval.report.attempt",
+    population: index_ts_1.logicalSlots,
+    value: (slot) => slot.state === "included" && slot.attempt !== undefined ? slot.attempt.locator : null,
+});
+/** The selected Run's frozen declared agent configuration. */
+exports.agent = (0, index_ts_1.defineDimension)({
+    id: "niceeval.report.agent",
+    population: index_ts_1.logicalSlots,
+    value: (slot) => slot.run.context?.execution.agentId ?? null,
+});
+/** The selected Run's frozen declared model configuration. */
+exports.model = (0, index_ts_1.defineDimension)({
+    id: "niceeval.report.model",
+    population: index_ts_1.logicalSlots,
+    value: (slot) => slot.run.context?.execution.model ?? null,
+});
+/** The selected Run's frozen declared reasoning-effort configuration. */
+exports.reasoningEffort = (0, index_ts_1.defineDimension)({
+    id: "niceeval.report.reasoning-effort",
+    population: index_ts_1.logicalSlots,
+    value: (slot) => slot.run.context?.execution.reasoningEffort ?? null,
+});
+const flagDimensions = new Map();
+const labelDimensions = new Map();
+const groupDimensions = new WeakMap();
+const subjects = new WeakMap();
+let nextGroupDimensionId = 0;
+/**
+ * A scalar frozen Run flag is a first-class Report grouping Dimension.
+ * Arrays and objects have no faithful Dimension coordinate; callers can make
+ * their own explicit string projection with GroupFunction instead.
+ */
+function flag(name) {
+    assertRunContextFieldName(name, "flag");
+    const existing = flagDimensions.get(name);
+    if (existing !== undefined)
+        return existing;
+    const dimension = (0, index_ts_1.defineDimension)({
+        id: "niceeval.report.flag:" + JSON.stringify(name),
+        population: index_ts_1.logicalSlots,
+        value: (slot) => scalarFlagValue(slot.run.context?.execution.flags[name], name),
+    });
+    flagDimensions.set(name, dimension);
+    return dimension;
+}
+/** A frozen selected-Run label is a first-class Report grouping Dimension. */
+function label(name) {
+    assertRunContextFieldName(name, "label");
+    const existing = labelDimensions.get(name);
+    if (existing !== undefined)
+        return existing;
+    const dimension = (0, index_ts_1.defineDimension)({
+        id: "niceeval.report.label:" + JSON.stringify(name),
+        population: index_ts_1.logicalSlots,
+        value: (slot) => slot.run.context?.labels[name] ?? null,
+    });
+    labelDimensions.set(name, dimension);
+    return dimension;
+}
+function aggregate(sample, request) {
+    try {
+        assertAggregateRequest(request);
+        return (0, index_ts_1.aggregate)(sample, {
+            by: analysisDimensionsFor(request.by),
+            values: request.values,
+        });
+    }
+    catch (error) {
+        // Keep the public Promise boundary even when facade-only validation fails.
+        return Promise.reject(error);
+    }
+}
+function assertAggregateRequest(request) {
+    if (!isPlainRecord(request) || !isPlainRecord(request.by) || !isPlainRecord(request.values)) {
+        throw new ReportAggregateRequestError("aggregate requires plain by and values records");
+    }
+    const byNames = Object.keys(request.by);
+    const valueNames = Object.keys(request.values);
+    if (valueNames.length === 0) {
+        throw new ReportAggregateRequestError("aggregate requires at least one Analysis Measure");
+    }
+    for (const name of [...byNames, ...valueNames]) {
+        if (name === "key") {
+            throw new ReportAggregateRequestError('aggregate reserves the row identity field "key"');
+        }
+    }
+    for (const name of valueNames) {
+        if (Object.hasOwn(request.by, name)) {
+            throw new ReportAggregateRequestError("aggregate field " + JSON.stringify(name) + " appears in both by and values");
+        }
+    }
+}
+function analysisDimensionsFor(groups) {
+    const dimensions = Object.create(null);
+    for (const [name, group] of Object.entries(groups)) {
+        dimensions[name] = typeof group === "function" ? dimensionForGroupFunction(group) : group;
+    }
+    return Object.freeze(dimensions);
+}
+function dimensionForGroupFunction(group) {
+    const existing = groupDimensions.get(group);
+    if (existing !== undefined)
+        return existing;
+    const dimension = (0, index_ts_1.defineDimension)({
+        id: "niceeval.report.group-function." + nextGroupDimensionId++,
+        population: index_ts_1.logicalSlots,
+        value: (slot) => {
+            const value = group(aggregationSubject(slot));
+            if (typeof value !== "string") {
+                throw new ReportGroupFunctionError("GroupFunction must return a string");
+            }
+            return value;
+        },
+    });
+    groupDimensions.set(group, dimension);
+    return dimension;
+}
+function aggregationSubject(slot) {
+    const cached = subjects.get(slot);
+    if (cached !== undefined)
+        return cached;
+    const context = slot.run.context;
+    const experimentContext = context === null
+        ? undefined
+        : Object.freeze({
+            agent: context.execution.agentId,
+            ...(context.execution.model === null ? {} : { model: context.execution.model }),
+            ...(context.execution.reasoningEffort === null
+                ? {}
+                : { reasoningEffort: context.execution.reasoningEffort }),
+            flags: closeJsonRecord(context.execution.flags),
+            labels: closeStringRecord(context.labels),
+        });
+    const subject = Object.freeze({
+        experimentId: slot.experimentId,
+        evalId: slot.evalId,
+        run: Object.freeze(experimentContext === undefined ? {} : { experiment: experimentContext }),
+    });
+    subjects.set(slot, subject);
+    return subject;
+}
+function assertRunContextFieldName(name, helper) {
+    if (typeof name !== "string" || name.length === 0) {
+        throw new ReportAggregateRequestError(helper + " requires a non-empty RunContext field name");
+    }
+}
+function scalarFlagValue(value, name) {
+    if (value === undefined || value === null || typeof value === "string" || typeof value === "boolean") {
+        return value ?? null;
+    }
+    if (typeof value === "number") {
+        if (Number.isFinite(value))
+            return value;
+        throw new ReportGroupFunctionError("flag(" + JSON.stringify(name) + ") has a non-finite numeric RunContext value");
+    }
+    throw new ReportGroupFunctionError("flag(" + JSON.stringify(name) + ") requires a scalar RunContext value");
+}
+function closeJsonRecord(source) {
+    const closed = Object.create(null);
+    for (const [key, value] of Object.entries(source))
+        closed[key] = closeJson(value);
+    return Object.freeze(closed);
+}
+function closeStringRecord(source) {
+    const closed = Object.create(null);
+    for (const [key, value] of Object.entries(source)) {
+        if (typeof value !== "string") {
+            throw new ReportGroupFunctionError("RunContext labels must be strings");
+        }
+        closed[key] = value;
+    }
+    return Object.freeze(closed);
+}
+function closeJson(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new ReportGroupFunctionError("RunContext flags must contain finite JSON numbers");
+        }
+        return value;
+    }
+    if (Array.isArray(value))
+        return Object.freeze(value.map(closeJson));
+    if (!isPlainRecord(value)) {
+        throw new ReportGroupFunctionError("RunContext flags must be JSON-only values");
+    }
+    const closed = Object.create(null);
+    for (const [key, entry] of Object.entries(value))
+        closed[key] = closeJson(entry);
+    return Object.freeze(closed);
+}
+function isPlainRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=aggregate.cjs.map

package/dist/report/model/aggregate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["aggregate.ts"],"names":[],"mappings":";;;AAgHA,oBAYC;AAED,sBAYC;AAQD,8BAYC;AA9JD,sDAA6N;AA6C7N;;;;;GAKG;AACH,MAAa,2BAA4B,SAAQ,KAAK;IACzC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAY,MAAc;QACtB,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC9C,CAAC;CACJ;AAND,kEAMC;AACD,4EAA4E;AAC5E,MAAa,wBAAyB,SAAQ,KAAK;IACtC,IAAI,GAAG,+BAA+B,CAAC;IAChD,YAAY,MAAc;QACtB,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,CAAC;CACJ;AAND,4DAMC;AACD,mEAAmE;AACtD,QAAA,UAAU,GAAG,IAAA,0BAAe,EAAC;IACtC,EAAE,EAAE,4BAA4B;IAChC,UAAU,EAAE,uBAAY;IACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY;CAClD,CAAC,CAAC;AACH,mEAAmE;AACtD,QAAA,MAAM,GAAG,IAAA,0BAAe,EAAC;IAClC,EAAE,EAAE,yBAAyB;IAC7B,UAAU,EAAE,uBAAY;IACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM;CAC5C,CAAC,CAAC;AACH,8EAA8E;AACjE,QAAA,OAAO,GAAG,IAAA,0BAAe,EAAC;IACnC,EAAE,EAAE,yBAAyB;IAC7B,UAAU,EAAE,uBAAY;IACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;CACtH,CAAC,CAAC;AACH,8DAA8D;AACjD,QAAA,KAAK,GAAG,IAAA,0BAAe,EAAC;IACjC,EAAE,EAAE,uBAAuB;IAC3B,UAAU,EAAE,uBAAY;IACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,IAAI;CAC5E,CAAC,CAAC;AACH,8DAA8D;AACjD,QAAA,KAAK,GAAG,IAAA,0BAAe,EAAC;IACjC,EAAE,EAAE,uBAAuB;IAC3B,UAAU,EAAE,uBAAY;IACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,IAAI,IAAI;CAC1E,CAAC,CAAC;AACH,yEAAyE;AAC5D,QAAA,eAAe,GAAG,IAAA,0BAAe,EAAC;IAC3C,EAAE,EAAE,kCAAkC;IACtC,UAAU,EAAE,uBAAY;IACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,eAAe,IAAI,IAAI;CACpF,CAAC,CAAC;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,EAA2B,CAAC;AAC1D,MAAM,eAAe,GAAG,IAAI,GAAG,EAA0C,CAAC;AAC1E,MAAM,eAAe,GAAG,IAAI,OAAO,EAAiD,CAAC;AACrF,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAmC,CAAC;AAChE,IAAI,oBAAoB,GAAG,CAAC,CAAC;AAC7B;;;;GAIG;AACH,SAAgB,IAAI,CAAC,IAAY;IAC7B,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,QAAQ,KAAK,SAAS;QACtB,OAAO,QAAQ,CAAC;IACpB,MAAM,SAAS,GAAG,IAAA,0BAAe,EAAC;QAC9B,EAAE,EAAE,uBAAuB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAClD,UAAU,EAAE,uBAAY;QACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;KAC/F,CAAC,CAAC;IACH,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACpC,OAAO,SAAS,CAAC;AACrB,CAAC;AACD,8EAA8E;AAC9E,SAAgB,KAAK,CAAC,IAAY;IAC9B,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS;QACtB,OAAO,QAAQ,CAAC;IACpB,MAAM,SAAS,GAAG,IAAA,0BAAe,EAAC;QAC9B,EAAE,EAAE,wBAAwB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QACnD,UAAU,EAAE,uBAAY;QACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI;KACvE,CAAC,CAAC;IACH,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC;AACrB,CAAC;AAQD,SAAgB,SAAS,CAAC,MAAc,EAAE,OAAiE;IACvG,IAAI,CAAC;QACD,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAA,oBAAqB,EAAC,MAAM,EAAE;YACjC,EAAE,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,MAAM,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC,CAAC;IACP,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACX,2EAA2E;QAC3E,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACL,CAAC;AACD,SAAS,sBAAsB,CAAC,OAAiE;IAC7F,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,2BAA2B,CAAC,gDAAgD,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,2BAA2B,CAAC,kDAAkD,CAAC,CAAC;IAC9F,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QAC7C,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,2BAA2B,CAAC,iDAAiD,CAAC,CAAC;QAC7F,CAAC;IACL,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,2BAA2B,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,gCAAgC,CAAC,CAAC;QACxH,CAAC;IACL,CAAC;AACL,CAAC;AACD,SAAS,qBAAqB,CAAC,MAAsB;IACjD,MAAM,UAAU,GAAwC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC;AACD,SAAS,yBAAyB,CAAC,KAAoB;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,QAAQ,KAAK,SAAS;QACtB,OAAO,QAAQ,CAAC;IACpB,MAAM,SAAS,GAAG,IAAA,0BAAe,EAAC;QAC9B,EAAE,EAAE,iCAAiC,GAAG,oBAAoB,EAAE;QAC9D,UAAU,EAAE,uBAAY;QACxB,KAAK,EAAE,CAAC,IAAiB,EAAE,EAAE;YACzB,MAAM,KAAK,GAAG,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,IAAI,wBAAwB,CAAC,oCAAoC,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC;KACJ,CAAC,CAAC;IACH,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,SAAS,CAAC;AACrB,CAAC;AACD,SAAS,kBAAkB,CAAC,IAAiB;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,SAAS;QACpB,OAAO,MAAM,CAAC;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IACjC,MAAM,iBAAiB,GAAG,OAAO,KAAK,IAAI;QACtC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO;YAChC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YAC/E,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,KAAK,IAAI;gBAC1C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;YAC7D,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;YAC/C,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC;SAC5C,CAAC,CAAC;IACP,MAAM,OAAO,GAAuB,MAAM,CAAC,MAAM,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;KAC/F,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACnB,CAAC;AACD,SAAS,yBAAyB,CAAC,IAAY,EAAE,MAAwB;IACrE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,2BAA2B,CAAC,MAAM,GAAG,6CAA6C,CAAC,CAAC;IAClG,CAAC;AACL,CAAC;AACD,SAAS,eAAe,CAAC,KAA4B,EAAE,IAAY;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACnG,OAAO,KAAK,IAAI,IAAI,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACtB,OAAO,KAAK,CAAC;QACjB,MAAM,IAAI,wBAAwB,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,6CAA6C,CAAC,CAAC;IACvH,CAAC;IACD,MAAM,IAAI,wBAAwB,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,sCAAsC,CAAC,CAAC;AAChH,CAAC;AACD,SAAS,eAAe,CAAC,MAA2C;IAChE,MAAM,MAAM,GAA8B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AACD,SAAS,iBAAiB,CAAC,MAAwC;IAC/D,MAAM,MAAM,GAA2B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,wBAAwB,CAAC,mCAAmC,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AACD,SAAS,SAAS,CAAC,KAAgB;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QACzE,OAAO,KAAK,CAAC;IACjB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,wBAAwB,CAAC,mDAAmD,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,wBAAwB,CAAC,2CAA2C,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,MAAM,GAA8B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAkB,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AACD,SAAS,aAAa,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACnE,OAAO,KAAK,CAAC;IACjB,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAChE,CAAC","sourcesContent":["import { aggregate as aggregateFromAnalysis, defineDimension, logicalSlots, type ClosedRows, type Dimension, type JsonValue, type LogicalSlot, type Measure, type MetricValue, type Sample, } from \"../../analysis/index.ts\";\nimport type { ReportDimension, } from \"./types.ts\";\n/**\n * The only value visible to a Report grouping callback. It is a\n * defensive frozen projection of the selected Run context, never the Run\n * object itself.  In particular, it has no reader, path, Scope, attachment,\n * or AttemptHandle capability.\n */\nexport interface AggregationSubject {\n    readonly experimentId: LogicalSlot[\"experimentId\"];\n    readonly evalId: LogicalSlot[\"evalId\"];\n    readonly run: Readonly<{\n        readonly experiment?: Readonly<{\n            readonly agent: string;\n            readonly model?: string;\n            readonly reasoningEffort?: string;\n            readonly flags: Readonly<Record<string, JsonValue>>;\n            readonly labels: Readonly<Record<string, string>>;\n        }>;\n    }>;\n}\n/** Safe, closed Run-context grouping callback. */\nexport type GroupFunction = (subject: AggregationSubject) => string;\n/**\n * A native Analysis Dimension may appear beside GroupFunction.  The `any`\n * here only bridges Analysis's nominal descriptor brands at an object-record\n * boundary; the executor still validates Population agreement before I/O.\n */\nexport type ReportGroup = Dimension<any, any> | GroupFunction;\nexport type ReportGroupSet = Readonly<Record<string, ReportGroup>>;\nexport type ReportMeasureSet = Readonly<Record<string, Measure<any, any>>>;\ntype GroupOutput<Value> = Value extends Dimension<any, infer Output> ? Output : Value extends GroupFunction ? string : never;\ntype MeasureOutput<Value> = Value extends Measure<any, infer Output> ? Output : never;\n/** The same closed row shape Analysis returns, with GroupFunction inference. */\nexport type ReportAggregateRow<By extends ReportGroupSet, Values extends ReportMeasureSet> = Readonly<{\n    readonly key: string;\n} & {\n    readonly [Key in keyof By]: GroupOutput<By[Key]>;\n} & {\n    readonly [Key in keyof Values]: MetricValue<MeasureOutput<Values[Key]>>;\n}>;\nexport interface ReportAggregateRequest<By extends ReportGroupSet, Values extends ReportMeasureSet> {\n    readonly by: By;\n    readonly values: Values;\n}\n/**\n * Invalid Report facade input is a request error, not a manufactured\n * MetricValue.  Errors thrown by an individual GroupFunction occur inside\n * Analysis's Dimension evaluation and therefore become the usual\n * `input-invalid` Analysis issue on its closed row.\n */\nexport class ReportAggregateRequestError extends Error {\n    readonly code = \"report-aggregate-invalid\";\n    constructor(reason: string) {\n        super(reason);\n        this.name = \"ReportAggregateRequestError\";\n    }\n}\n/** A non-string custom group result is an honest Analysis input problem. */\nexport class ReportGroupFunctionError extends Error {\n    readonly code = \"report-group-function-invalid\";\n    constructor(reason: string) {\n        super(reason);\n        this.name = \"ReportGroupFunctionError\";\n    }\n}\n/** Safe built-in Dimension over a closed logical-Slot identity. */\nexport const experiment = defineDimension({\n    id: \"niceeval.report.experiment\",\n    population: logicalSlots,\n    value: (slot: LogicalSlot) => slot.experimentId,\n});\n/** Safe built-in Dimension over a closed logical-Slot identity. */\nexport const evalId = defineDimension({\n    id: \"niceeval.report.eval-id\",\n    population: logicalSlots,\n    value: (slot: LogicalSlot) => slot.evalId,\n});\n/** The selected Attempt locator, or null for an expected Slot without one. */\nexport const attempt = defineDimension({\n    id: \"niceeval.report.attempt\",\n    population: logicalSlots,\n    value: (slot: LogicalSlot) => slot.state === \"included\" && slot.attempt !== undefined ? slot.attempt.locator : null,\n});\n/** The selected Run's frozen declared agent configuration. */\nexport const agent = defineDimension({\n    id: \"niceeval.report.agent\",\n    population: logicalSlots,\n    value: (slot: LogicalSlot) => slot.run.context?.execution.agentId ?? null,\n});\n/** The selected Run's frozen declared model configuration. */\nexport const model = defineDimension({\n    id: \"niceeval.report.model\",\n    population: logicalSlots,\n    value: (slot: LogicalSlot) => slot.run.context?.execution.model ?? null,\n});\n/** The selected Run's frozen declared reasoning-effort configuration. */\nexport const reasoningEffort = defineDimension({\n    id: \"niceeval.report.reasoning-effort\",\n    population: logicalSlots,\n    value: (slot: LogicalSlot) => slot.run.context?.execution.reasoningEffort ?? null,\n});\nconst flagDimensions = new Map<string, ReportDimension>();\nconst labelDimensions = new Map<string, ReportDimension<string | null>>();\nconst groupDimensions = new WeakMap<GroupFunction, Dimension<LogicalSlot, string>>();\nconst subjects = new WeakMap<LogicalSlot, AggregationSubject>();\nlet nextGroupDimensionId = 0;\n/**\n * A scalar frozen Run flag is a first-class Report grouping Dimension.\n * Arrays and objects have no faithful Dimension coordinate; callers can make\n * their own explicit string projection with GroupFunction instead.\n */\nexport function flag(name: string): ReportDimension {\n    assertRunContextFieldName(name, \"flag\");\n    const existing = flagDimensions.get(name);\n    if (existing !== undefined)\n        return existing;\n    const dimension = defineDimension({\n        id: \"niceeval.report.flag:\" + JSON.stringify(name),\n        population: logicalSlots,\n        value: (slot: LogicalSlot) => scalarFlagValue(slot.run.context?.execution.flags[name], name),\n    });\n    flagDimensions.set(name, dimension);\n    return dimension;\n}\n/** A frozen selected-Run label is a first-class Report grouping Dimension. */\nexport function label(name: string): ReportDimension<string | null> {\n    assertRunContextFieldName(name, \"label\");\n    const existing = labelDimensions.get(name);\n    if (existing !== undefined)\n        return existing;\n    const dimension = defineDimension({\n        id: \"niceeval.report.label:\" + JSON.stringify(name),\n        population: logicalSlots,\n        value: (slot: LogicalSlot) => slot.run.context?.labels[name] ?? null,\n    });\n    labelDimensions.set(name, dimension);\n    return dimension;\n}\n/**\n * Report aggregation creates only safe\n * Dimensions for GroupFunction and returns Analysis's original ClosedRows\n * object unchanged, so row identity, denominator, state, Evidence, and\n * provenance remain Analysis-owned.\n */\nexport function aggregate<By extends ReportGroupSet, Values extends ReportMeasureSet>(sample: Sample, request: ReportAggregateRequest<By, Values>): Promise<ClosedRows<ReportAggregateRow<By, Values>>>;\nexport function aggregate(sample: Sample, request: ReportAggregateRequest<ReportGroupSet, ReportMeasureSet>): Promise<ClosedRows<object>> {\n    try {\n        assertAggregateRequest(request);\n        return aggregateFromAnalysis(sample, {\n            by: analysisDimensionsFor(request.by),\n            values: request.values,\n        });\n    }\n    catch (error) {\n        // Keep the public Promise boundary even when facade-only validation fails.\n        return Promise.reject(error);\n    }\n}\nfunction assertAggregateRequest(request: ReportAggregateRequest<ReportGroupSet, ReportMeasureSet>): void {\n    if (!isPlainRecord(request) || !isPlainRecord(request.by) || !isPlainRecord(request.values)) {\n        throw new ReportAggregateRequestError(\"aggregate requires plain by and values records\");\n    }\n    const byNames = Object.keys(request.by);\n    const valueNames = Object.keys(request.values);\n    if (valueNames.length === 0) {\n        throw new ReportAggregateRequestError(\"aggregate requires at least one Analysis Measure\");\n    }\n    for (const name of [...byNames, ...valueNames]) {\n        if (name === \"key\") {\n            throw new ReportAggregateRequestError('aggregate reserves the row identity field \"key\"');\n        }\n    }\n    for (const name of valueNames) {\n        if (Object.hasOwn(request.by, name)) {\n            throw new ReportAggregateRequestError(\"aggregate field \" + JSON.stringify(name) + \" appears in both by and values\");\n        }\n    }\n}\nfunction analysisDimensionsFor(groups: ReportGroupSet): Readonly<Record<string, Dimension<any, any>>> {\n    const dimensions: Record<string, Dimension<any, any>> = Object.create(null);\n    for (const [name, group] of Object.entries(groups)) {\n        dimensions[name] = typeof group === \"function\" ? dimensionForGroupFunction(group) : group;\n    }\n    return Object.freeze(dimensions);\n}\nfunction dimensionForGroupFunction(group: GroupFunction): Dimension<LogicalSlot, string> {\n    const existing = groupDimensions.get(group);\n    if (existing !== undefined)\n        return existing;\n    const dimension = defineDimension({\n        id: \"niceeval.report.group-function.\" + nextGroupDimensionId++,\n        population: logicalSlots,\n        value: (slot: LogicalSlot) => {\n            const value = group(aggregationSubject(slot));\n            if (typeof value !== \"string\") {\n                throw new ReportGroupFunctionError(\"GroupFunction must return a string\");\n            }\n            return value;\n        },\n    });\n    groupDimensions.set(group, dimension);\n    return dimension;\n}\nfunction aggregationSubject(slot: LogicalSlot): AggregationSubject {\n    const cached = subjects.get(slot);\n    if (cached !== undefined)\n        return cached;\n    const context = slot.run.context;\n    const experimentContext = context === null\n        ? undefined\n        : Object.freeze({\n            agent: context.execution.agentId,\n            ...(context.execution.model === null ? {} : { model: context.execution.model }),\n            ...(context.execution.reasoningEffort === null\n                ? {}\n                : { reasoningEffort: context.execution.reasoningEffort }),\n            flags: closeJsonRecord(context.execution.flags),\n            labels: closeStringRecord(context.labels),\n        });\n    const subject: AggregationSubject = Object.freeze({\n        experimentId: slot.experimentId,\n        evalId: slot.evalId,\n        run: Object.freeze(experimentContext === undefined ? {} : { experiment: experimentContext }),\n    });\n    subjects.set(slot, subject);\n    return subject;\n}\nfunction assertRunContextFieldName(name: string, helper: \"flag\" | \"label\"): void {\n    if (typeof name !== \"string\" || name.length === 0) {\n        throw new ReportAggregateRequestError(helper + \" requires a non-empty RunContext field name\");\n    }\n}\nfunction scalarFlagValue(value: JsonValue | undefined, name: string): string | number | boolean | null {\n    if (value === undefined || value === null || typeof value === \"string\" || typeof value === \"boolean\") {\n        return value ?? null;\n    }\n    if (typeof value === \"number\") {\n        if (Number.isFinite(value))\n            return value;\n        throw new ReportGroupFunctionError(\"flag(\" + JSON.stringify(name) + \") has a non-finite numeric RunContext value\");\n    }\n    throw new ReportGroupFunctionError(\"flag(\" + JSON.stringify(name) + \") requires a scalar RunContext value\");\n}\nfunction closeJsonRecord(source: Readonly<Record<string, JsonValue>>): Readonly<Record<string, JsonValue>> {\n    const closed: Record<string, JsonValue> = Object.create(null);\n    for (const [key, value] of Object.entries(source))\n        closed[key] = closeJson(value);\n    return Object.freeze(closed);\n}\nfunction closeStringRecord(source: Readonly<Record<string, string>>): Readonly<Record<string, string>> {\n    const closed: Record<string, string> = Object.create(null);\n    for (const [key, value] of Object.entries(source)) {\n        if (typeof value !== \"string\") {\n            throw new ReportGroupFunctionError(\"RunContext labels must be strings\");\n        }\n        closed[key] = value;\n    }\n    return Object.freeze(closed);\n}\nfunction closeJson(value: JsonValue): JsonValue {\n    if (value === null || typeof value === \"string\" || typeof value === \"boolean\")\n        return value;\n    if (typeof value === \"number\") {\n        if (!Number.isFinite(value)) {\n            throw new ReportGroupFunctionError(\"RunContext flags must contain finite JSON numbers\");\n        }\n        return value;\n    }\n    if (Array.isArray(value))\n        return Object.freeze(value.map(closeJson));\n    if (!isPlainRecord(value)) {\n        throw new ReportGroupFunctionError(\"RunContext flags must be JSON-only values\");\n    }\n    const closed: Record<string, JsonValue> = Object.create(null);\n    for (const [key, entry] of Object.entries(value))\n        closed[key] = closeJson(entry as JsonValue);\n    return Object.freeze(closed);\n}\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value))\n        return false;\n    const prototype = Object.getPrototypeOf(value);\n    return prototype === Object.prototype || prototype === null;\n}\n"]}