niceeval 0.15.1-canary.76 → 0.16.1

package/dist/o11y/eval-usage.d.cts

@@ -0,0 +1,46 @@
+import type { NumericMaterial } from "../assertions/match.cjs";
+import type { ResolvedEvidenceCoverage } from "../assertions/coverage.cjs";
+import type { PriceOverride, Usage } from "../types.cjs";
+import type { ReadableAdapterUsageAttachment } from "../record/family/adapter-usage/schema.cjs";
+/** Internal source-owned shape; package-root exposure belongs to the author facade. */
+export interface EvalUsage {
+    readonly source: "agent" | "adapter" | "unavailable";
+    readonly scope: "turn" | "session" | "attempt";
+    readonly basis: "reported-sends" | "recorded-calls" | "unbound";
+    readonly cut: "call-time";
+    readonly inputTokens: NumericMaterial;
+    readonly inputTotalTokens: NumericMaterial;
+    readonly outputTokens: NumericMaterial;
+    readonly cacheReadTokens: NumericMaterial;
+    readonly cacheWriteTokens: NumericMaterial;
+    readonly totalTokens: NumericMaterial;
+    readonly costs: {
+        readonly state: "complete" | "partial" | "unavailable";
+        readonly values: readonly {
+            readonly currency: string;
+            readonly value: string;
+            readonly source: "reported" | "estimated" | "mixed";
+            readonly coveredContributions: number;
+            readonly reportedContributions: number;
+            readonly estimatedContributions: number;
+        }[];
+        readonly totalContributions: number;
+    };
+}
+export interface AgentUsageContribution {
+    readonly sessionScopeId: string;
+    readonly turnId: string;
+    readonly sendAttempt: number;
+    readonly state: "pending" | "terminal";
+    readonly outcome: "completed" | "failed" | "interrupted" | null;
+    readonly model: string | null;
+    readonly usage: Readonly<Usage> | null;
+    readonly coverage: ResolvedEvidenceCoverage["usage"];
+}
+export declare function projectAdapterEvalUsage(usage: ReadableAdapterUsageAttachment): EvalUsage;
+/** The receiver selects scope membership before calling this pure projection. */
+export declare function projectAgentEvalUsage(input: {
+    contributions: readonly AgentUsageContribution[];
+    scope: "turn" | "session" | "attempt";
+    pricing?: Record<string, PriceOverride>;
+}): EvalUsage;

package/dist/o11y/eval-usage.d.mts

@@ -0,0 +1,46 @@
+import type { NumericMaterial } from "../assertions/match.mjs";
+import type { ResolvedEvidenceCoverage } from "../assertions/coverage.mjs";
+import type { PriceOverride, Usage } from "../types.mjs";
+import type { ReadableAdapterUsageAttachment } from "../record/family/adapter-usage/schema.mjs";
+/** Internal source-owned shape; package-root exposure belongs to the author facade. */
+export interface EvalUsage {
+    readonly source: "agent" | "adapter" | "unavailable";
+    readonly scope: "turn" | "session" | "attempt";
+    readonly basis: "reported-sends" | "recorded-calls" | "unbound";
+    readonly cut: "call-time";
+    readonly inputTokens: NumericMaterial;
+    readonly inputTotalTokens: NumericMaterial;
+    readonly outputTokens: NumericMaterial;
+    readonly cacheReadTokens: NumericMaterial;
+    readonly cacheWriteTokens: NumericMaterial;
+    readonly totalTokens: NumericMaterial;
+    readonly costs: {
+        readonly state: "complete" | "partial" | "unavailable";
+        readonly values: readonly {
+            readonly currency: string;
+            readonly value: string;
+            readonly source: "reported" | "estimated" | "mixed";
+            readonly coveredContributions: number;
+            readonly reportedContributions: number;
+            readonly estimatedContributions: number;
+        }[];
+        readonly totalContributions: number;
+    };
+}
+export interface AgentUsageContribution {
+    readonly sessionScopeId: string;
+    readonly turnId: string;
+    readonly sendAttempt: number;
+    readonly state: "pending" | "terminal";
+    readonly outcome: "completed" | "failed" | "interrupted" | null;
+    readonly model: string | null;
+    readonly usage: Readonly<Usage> | null;
+    readonly coverage: ResolvedEvidenceCoverage["usage"];
+}
+export declare function projectAdapterEvalUsage(usage: ReadableAdapterUsageAttachment): EvalUsage;
+/** The receiver selects scope membership before calling this pure projection. */
+export declare function projectAgentEvalUsage(input: {
+    contributions: readonly AgentUsageContribution[];
+    scope: "turn" | "session" | "attempt";
+    pricing?: Record<string, PriceOverride>;
+}): EvalUsage;

package/dist/o11y/eval-usage.d.ts

@@ -0,0 +1,46 @@
+import type { NumericMaterial } from "../assertions/match.js";
+import type { ResolvedEvidenceCoverage } from "../assertions/coverage.js";
+import type { PriceOverride, Usage } from "../types.js";
+import type { ReadableAdapterUsageAttachment } from "../record/family/adapter-usage/schema.js";
+/** Internal source-owned shape; package-root exposure belongs to the author facade. */
+export interface EvalUsage {
+    readonly source: "agent" | "adapter" | "unavailable";
+    readonly scope: "turn" | "session" | "attempt";
+    readonly basis: "reported-sends" | "recorded-calls" | "unbound";
+    readonly cut: "call-time";
+    readonly inputTokens: NumericMaterial;
+    readonly inputTotalTokens: NumericMaterial;
+    readonly outputTokens: NumericMaterial;
+    readonly cacheReadTokens: NumericMaterial;
+    readonly cacheWriteTokens: NumericMaterial;
+    readonly totalTokens: NumericMaterial;
+    readonly costs: {
+        readonly state: "complete" | "partial" | "unavailable";
+        readonly values: readonly {
+            readonly currency: string;
+            readonly value: string;
+            readonly source: "reported" | "estimated" | "mixed";
+            readonly coveredContributions: number;
+            readonly reportedContributions: number;
+            readonly estimatedContributions: number;
+        }[];
+        readonly totalContributions: number;
+    };
+}
+export interface AgentUsageContribution {
+    readonly sessionScopeId: string;
+    readonly turnId: string;
+    readonly sendAttempt: number;
+    readonly state: "pending" | "terminal";
+    readonly outcome: "completed" | "failed" | "interrupted" | null;
+    readonly model: string | null;
+    readonly usage: Readonly<Usage> | null;
+    readonly coverage: ResolvedEvidenceCoverage["usage"];
+}
+export declare function projectAdapterEvalUsage(usage: ReadableAdapterUsageAttachment): EvalUsage;
+/** The receiver selects scope membership before calling this pure projection. */
+export declare function projectAgentEvalUsage(input: {
+    contributions: readonly AgentUsageContribution[];
+    scope: "turn" | "session" | "attempt";
+    pricing?: Record<string, PriceOverride>;
+}): EvalUsage;

package/dist/o11y/eval-usage.js

@@ -0,0 +1,8 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./eval-usage.cjs");
+const __niceevalExport0 = __niceevalCanonical["projectAdapterEvalUsage"];
+export { __niceevalExport0 as projectAdapterEvalUsage };
+const __niceevalExport1 = __niceevalCanonical["projectAgentEvalUsage"];
+export { __niceevalExport1 as projectAgentEvalUsage };
+//# sourceMappingURL=eval-usage.js.map

package/dist/o11y/eval-usage.js.map

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

package/dist/o11y/judge-call-price.cjs

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJudgeCallPriceReceipts = createJudgeCallPriceReceipts;
+const effect_1 = require("effect");
+const core_ts_1 = require("../record/codec/core.cjs");
+const schema_ts_1 = require("../record/family/judge-usage/schema.cjs");
+const pricing_ts_1 = require("../record/family/adapter-usage/pricing.cjs");
+const adapter_call_price_ts_1 = require("./adapter-call-price.cjs");
+function tokensFor(call, bucket) {
+    switch (bucket) {
+        case "input": return call.inputTokens;
+        case "output": return call.outputTokens;
+        case "cache-read": return call.cacheReadTokens;
+        case "cache-write": return call.cacheWriteTokens;
+    }
+}
+function createJudgeCallPriceReceipts(calls, pricing) {
+    return Object.freeze(calls.flatMap((call) => {
+        // A reported zero is a complete reported observation, not a missing price.
+        if (call.cost !== null)
+            return [];
+        const selected = (0, adapter_call_price_ts_1.configuredProfile)(call.requestModel, pricing);
+        if (selected === undefined)
+            return [];
+        const digestInput = {
+            basis: selected.basis, currency: selected.currency, source: selected.source,
+            requestModel: selected.requestModel, selector: selected.selector,
+            match: selected.match, ratesPerMTok: selected.ratesPerMTok,
+        };
+        const charges = [];
+        const missing = [];
+        for (const bucket of pricing_ts_1.AdapterCallPriceBuckets) {
+            const tokens = tokensFor(call, bucket);
+            const rate = (0, adapter_call_price_ts_1.rateFor)(selected, bucket);
+            if (tokens === null)
+                missing.push({ bucket, reason: "tokens-unknown" });
+            else if (tokens === 0)
+                charges.push({ bucket, tokens, ratePerMTok: rate, amount: "0" });
+            else if (rate === null)
+                missing.push({ bucket, reason: "rate-unknown" });
+            else
+                charges.push({ bucket, tokens, ratePerMTok: rate, amount: (0, pricing_ts_1.multiplyCanonicalDecimalPerMillion)(rate, tokens) });
+        }
+        if (charges.length === 0)
+            return [];
+        const decoded = effect_1.Schema.decodeUnknownResult(schema_ts_1.JudgePriceReceiptSchema, core_ts_1.RecordExactParseOptions)({
+            kind: "judge-call-price-estimate", callId: call.callId,
+            state: missing.length === 0 ? "complete" : "partial",
+            amount: (0, pricing_ts_1.addCanonicalDecimals)(charges.map((charge) => String(charge.amount))),
+            currency: "USD", source: { kind: "estimated", id: selected.source.id },
+            pricing: {
+                ...digestInput,
+                source: { ...selected.source, profileDigest: (0, pricing_ts_1.adapterCallPricingProfileDigest)(digestInput) },
+            },
+            charges, missing,
+        });
+        if (effect_1.Result.isFailure(decoded))
+            throw new Error("Generated Judge call price receipt is invalid");
+        return [Object.freeze(decoded.success)];
+    }));
+}
+//# sourceMappingURL=judge-call-price.cjs.map

package/dist/o11y/judge-call-price.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-call-price.js","sourceRoot":"","sources":["judge-call-price.ts"],"names":[],"mappings":";;AAcA,oEA4CC;AA1DD,mCAAwC;AAExC,qDAAkE;AAClE,sEAA8H;AAC9H,0EAAgL;AAChL,mEAAqE;AACrE,SAAS,SAAS,CAAC,IAAoB,EAAE,MAAgD;IACrF,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC;QACtC,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC;QACxC,KAAK,YAAY,CAAC,CAAC,OAAO,IAAI,CAAC,eAAe,CAAC;QAC/C,KAAK,aAAa,CAAC,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACrD,CAAC;AACL,CAAC;AACD,SAAgB,4BAA4B,CAAC,KAAgC,EAAE,OAA4D;IACvI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAgC,EAAE;QACtE,2EAA2E;QAC3E,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAClB,OAAO,EAAE,CAAC;QACd,MAAM,QAAQ,GAAG,IAAA,yCAAiB,EAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,QAAQ,KAAK,SAAS;YACtB,OAAO,EAAE,CAAC;QACd,MAAM,WAAW,GAAG;YAChB,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM;YAC3E,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAChE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY;SAC7D,CAAC;QACF,MAAM,OAAO,GAAmC,EAAE,CAAC;QACnD,MAAM,OAAO,GAAmC,EAAE,CAAC;QACnD,KAAK,MAAM,MAAM,IAAI,oCAAuB,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,IAAA,+BAAO,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI;gBACf,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;iBAClD,IAAI,MAAM,KAAK,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;iBAChE,IAAI,IAAI,KAAK,IAAI;gBAClB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;;gBAEjD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAA,+CAAkC,EAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACtH,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YACpB,OAAO,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,eAAM,CAAC,mBAAmB,CAAC,mCAAuB,EAAE,iCAAuB,CAAC,CAAC;YACzF,IAAI,EAAE,2BAA2B,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM;YACtD,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YACpD,MAAM,EAAE,IAAA,iCAAoB,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5E,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE;YACtE,OAAO,EAAE;gBACL,GAAG,WAAW;gBACd,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAA,4CAA+B,EAAC,WAAW,CAAC,EAAE;aAC9F;YACD,OAAO,EAAE,OAAO;SACnB,CAAC,CAAC;QACH,IAAI,eAAM,CAAC,SAAS,CAAC,OAAO,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACrE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC,CAAC;AACR,CAAC","sourcesContent":["import { Result, Schema } from \"effect\";\nimport type { PriceOverride } from \"../runner/types.ts\";\nimport { RecordExactParseOptions } from \"../record/codec/core.ts\";\nimport { JudgePriceReceiptSchema, type JudgePriceReceipt, type JudgeUsageCall } from \"../record/family/judge-usage/schema.ts\";\nimport { AdapterCallPriceBuckets, adapterCallPricingProfileDigest, addCanonicalDecimals, multiplyCanonicalDecimalPerMillion, } from \"../record/family/adapter-usage/pricing.ts\";\nimport { configuredProfile, rateFor } from \"./adapter-call-price.ts\";\nfunction tokensFor(call: JudgeUsageCall, bucket: (typeof AdapterCallPriceBuckets)[number]): number | null {\n    switch (bucket) {\n        case \"input\": return call.inputTokens;\n        case \"output\": return call.outputTokens;\n        case \"cache-read\": return call.cacheReadTokens;\n        case \"cache-write\": return call.cacheWriteTokens;\n    }\n}\nexport function createJudgeCallPriceReceipts(calls: readonly JudgeUsageCall[], pricing: Readonly<Record<string, PriceOverride>> | undefined): readonly JudgePriceReceipt[] {\n    return Object.freeze(calls.flatMap((call): readonly JudgePriceReceipt[] => {\n        // A reported zero is a complete reported observation, not a missing price.\n        if (call.cost !== null)\n            return [];\n        const selected = configuredProfile(call.requestModel, pricing);\n        if (selected === undefined)\n            return [];\n        const digestInput = {\n            basis: selected.basis, currency: selected.currency, source: selected.source,\n            requestModel: selected.requestModel, selector: selected.selector,\n            match: selected.match, ratesPerMTok: selected.ratesPerMTok,\n        };\n        const charges: Array<Record<string, unknown>> = [];\n        const missing: Array<Record<string, unknown>> = [];\n        for (const bucket of AdapterCallPriceBuckets) {\n            const tokens = tokensFor(call, bucket);\n            const rate = rateFor(selected, bucket);\n            if (tokens === null)\n                missing.push({ bucket, reason: \"tokens-unknown\" });\n            else if (tokens === 0)\n                charges.push({ bucket, tokens, ratePerMTok: rate, amount: \"0\" });\n            else if (rate === null)\n                missing.push({ bucket, reason: \"rate-unknown\" });\n            else\n                charges.push({ bucket, tokens, ratePerMTok: rate, amount: multiplyCanonicalDecimalPerMillion(rate, tokens) });\n        }\n        if (charges.length === 0)\n            return [];\n        const decoded = Schema.decodeUnknownResult(JudgePriceReceiptSchema, RecordExactParseOptions)({\n            kind: \"judge-call-price-estimate\", callId: call.callId,\n            state: missing.length === 0 ? \"complete\" : \"partial\",\n            amount: addCanonicalDecimals(charges.map((charge) => String(charge.amount))),\n            currency: \"USD\", source: { kind: \"estimated\", id: selected.source.id },\n            pricing: {\n                ...digestInput,\n                source: { ...selected.source, profileDigest: adapterCallPricingProfileDigest(digestInput) },\n            },\n            charges, missing,\n        });\n        if (Result.isFailure(decoded))\n            throw new Error(\"Generated Judge call price receipt is invalid\");\n        return [Object.freeze(decoded.success)];\n    }));\n}\n"]}

package/dist/o11y/judge-call-price.d.cts

@@ -0,0 +1,3 @@
+import type { PriceOverride } from "../runner/types.cjs";
+import { type JudgePriceReceipt, type JudgeUsageCall } from "../record/family/judge-usage/schema.cjs";
+export declare function createJudgeCallPriceReceipts(calls: readonly JudgeUsageCall[], pricing: Readonly<Record<string, PriceOverride>> | undefined): readonly JudgePriceReceipt[];

package/dist/o11y/judge-call-price.d.mts

@@ -0,0 +1,3 @@
+import type { PriceOverride } from "../runner/types.mjs";
+import { type JudgePriceReceipt, type JudgeUsageCall } from "../record/family/judge-usage/schema.mjs";
+export declare function createJudgeCallPriceReceipts(calls: readonly JudgeUsageCall[], pricing: Readonly<Record<string, PriceOverride>> | undefined): readonly JudgePriceReceipt[];

package/dist/o11y/judge-call-price.d.ts

@@ -0,0 +1,3 @@
+import type { PriceOverride } from "../runner/types.js";
+import { type JudgePriceReceipt, type JudgeUsageCall } from "../record/family/judge-usage/schema.js";
+export declare function createJudgeCallPriceReceipts(calls: readonly JudgeUsageCall[], pricing: Readonly<Record<string, PriceOverride>> | undefined): readonly JudgePriceReceipt[];

package/dist/o11y/judge-call-price.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./judge-call-price.cjs");
+const __niceevalExport0 = __niceevalCanonical["createJudgeCallPriceReceipts"];
+export { __niceevalExport0 as createJudgeCallPriceReceipts };
+//# sourceMappingURL=judge-call-price.js.map

package/dist/o11y/judge-call-price.js.map

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

package/dist/o11y/judge-usage-projection.cjs

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JUDGE_USAGE_PREVIEW_BYTE_LIMIT = exports.JUDGE_USAGE_PREVIEW_CALL_LIMIT = void 0;
+exports.compareJudgeUsageCalls = compareJudgeUsageCalls;
+exports.projectJudgeUsage = projectJudgeUsage;
+exports.takeJudgeUsagePreview = takeJudgeUsagePreview;
+exports.summarizeJudgeUsage = summarizeJudgeUsage;
+exports.projectTotalUsageCosts = projectTotalUsageCosts;
+exports.combineTotalUsageCosts = combineTotalUsageCosts;
+const pricing_ts_1 = require("../record/family/adapter-usage/pricing.cjs");
+const adapter_usage_projection_ts_1 = require("./adapter-usage-projection.cjs");
+const bytes_ts_1 = require("../inspection/bytes.cjs");
+exports.JUDGE_USAGE_PREVIEW_CALL_LIMIT = 128;
+exports.JUDGE_USAGE_PREVIEW_BYTE_LIMIT = 128 * 1024;
+function compareJudgeUsageCalls(left, right) {
+    return left.entryIndex - right.entryIndex || left.logicalOrdinal - right.logicalOrdinal ||
+        left.transmissionOrdinal - right.transmissionOrdinal;
+}
+/** The ledger is already validated; independent metrics retain their own coverage. */
+function projectJudgeUsage(ledger) {
+    const receipts = new Map(ledger.priceReceipts.map((receipt) => [receipt.callId, receipt]));
+    const costCalls = ledger.calls.map((call) => {
+        const receipt = receipts.get(call.callId);
+        return { effectiveCost: call.cost !== null ? { ...call.cost, state: "complete" }
+                : receipt === undefined ? null
+                    : { amount: receipt.amount, currency: receipt.currency, source: receipt.source, state: receipt.state } };
+    });
+    const costs = (0, adapter_usage_projection_ts_1.effectiveCostTotals)(costCalls, ledger.collection.state);
+    const numeric = (metric) => {
+        let value = 0;
+        let observationCount = 0;
+        let complete = ledger.collection.state === "complete";
+        for (const call of ledger.calls) {
+            const inputBuckets = [call.inputTokens, call.cacheReadTokens, call.cacheWriteTokens];
+            const knownInputs = inputBuckets.filter((bucket) => bucket !== null);
+            const input = call.inputTotalTokens ?? (knownInputs.length === 0 ? null
+                : knownInputs.reduce((sum, bucket) => sum + bucket, 0));
+            const buckets = metric === "inputTotalTokens" ? [input]
+                : metric === "outputTokens" ? [call.outputTokens] : [input, call.outputTokens];
+            if (buckets.some((bucket) => bucket !== null))
+                observationCount++;
+            for (const bucket of buckets) {
+                if (bucket === null)
+                    complete = false;
+                else
+                    value += bucket;
+            }
+            if (metric !== "outputTokens" && call.inputTotalTokens === null && knownInputs.length !== 3)
+                complete = false;
+        }
+        if (!Number.isSafeInteger(value) || observationCount === 0 && ledger.calls.length > 0 ||
+            ledger.calls.length === 0 && !complete) {
+            return Object.freeze({ state: "unavailable", value: null, observationCount });
+        }
+        return Object.freeze({ state: complete ? "available" : "partial", value, observationCount });
+    };
+    const all = Object.freeze({
+        state: ledger.collection.state,
+        coverage: "physical-transmissions",
+        collection: ledger.collection,
+        calls: Object.freeze([...ledger.calls].sort(compareJudgeUsageCalls)),
+        callsTruncated: false,
+        omittedCallCount: 0,
+        totals: Object.freeze({
+            requests: Object.freeze({ state: ledger.collection.state === "complete" ? "available" : "partial",
+                value: ledger.calls.length, observationCount: ledger.calls.length }),
+            inputTotalTokens: numeric("inputTotalTokens"), outputTokens: numeric("outputTokens"), totalTokens: numeric("totalTokens"),
+            costs: ledger.collection.state === "complete" && ledger.calls.length === 0
+                ? Object.freeze({ ...costs, state: "complete" }) : costs,
+        }),
+        priceReceipts: ledger.priceReceipts,
+    });
+    let preview = takeJudgeUsagePreview(all, exports.JUDGE_USAGE_PREVIEW_CALL_LIMIT);
+    while ((0, bytes_ts_1.utf8ByteLength)(JSON.stringify({ calls: preview.calls, priceReceipts: preview.priceReceipts })) >
+        exports.JUDGE_USAGE_PREVIEW_BYTE_LIMIT && preview.calls.length > 0) {
+        preview = takeJudgeUsagePreview(preview, preview.calls.length - 1);
+    }
+    return preview;
+}
+/** Shrinking details never changes totals and retains only the corresponding price proofs. */
+function takeJudgeUsagePreview(usage, maximumCalls) {
+    const calls = Object.freeze(usage.calls.slice(0, maximumCalls));
+    const receipts = new Map(usage.priceReceipts.map((receipt) => [receipt.callId, receipt]));
+    const priceReceipts = Object.freeze(calls.flatMap((call) => {
+        const receipt = receipts.get(call.callId);
+        return receipt === undefined ? [] : [receipt];
+    }));
+    const omittedCallCount = usage.omittedCallCount + usage.calls.length - calls.length;
+    return Object.freeze({ ...usage, calls, priceReceipts, callsTruncated: omittedCallCount > 0, omittedCallCount });
+}
+function summarizeJudgeUsage(usage) {
+    if (usage.state === "unavailable" || usage.state === "invalid")
+        return usage;
+    return Object.freeze({ state: usage.state, coverage: usage.coverage, collection: usage.collection, totals: usage.totals });
+}
+/** Currency-preserving known subtotals; no exchange rate or fabricated zero currency. */
+function projectTotalUsageCosts(application, judge, applicationEmptyComplete = false, applicationCollectionProven = true) {
+    const applicationValues = application.costs !== undefined ? application.costs.values
+        : (application.providerCosts?.values ?? []).map(({ currency, value }) => ({ currency, value, source: "reported" }));
+    const judgeCosts = judge.state === "complete" || judge.state === "partial" ? judge.totals.costs : undefined;
+    const completeApplication = applicationCollectionProven && (applicationEmptyComplete || application.costs?.state === "complete" ||
+        application.costs === undefined && application.providerCosts?.state === "available");
+    const missingSources = [];
+    if (!completeApplication)
+        missingSources.push("application");
+    if (judgeCosts?.state !== "complete")
+        missingSources.push("judge");
+    const values = sumCostValues([...applicationValues, ...(judgeCosts?.values ?? [])]);
+    return Object.freeze({ state: missingSources.length === 0 ? "complete" : values.length === 0 ? "unavailable" : "partial",
+        values, missingSources: Object.freeze(missingSources) });
+}
+/** Inputs are unique origin Attempts, never preview rows or verdict-filtered members. */
+function combineTotalUsageCosts(totals, unresolved = false) {
+    const missingSources = ["application", "judge"].filter((source) => unresolved || totals.some((total) => total.missingSources.includes(source)));
+    const values = sumCostValues(totals.flatMap((total) => total.values));
+    return Object.freeze({ state: missingSources.length === 0 ? "complete" : values.length === 0 ? "unavailable" : "partial",
+        values, missingSources: Object.freeze(missingSources) });
+}
+function sumCostValues(entries) {
+    const grouped = new Map();
+    for (const entry of entries) {
+        const group = grouped.get(entry.currency);
+        if (group === undefined)
+            grouped.set(entry.currency, [entry]);
+        else
+            group.push(entry);
+    }
+    return Object.freeze([...grouped.entries()].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)
+        .map(([currency, entries]) => Object.freeze({
+        currency, value: (0, pricing_ts_1.addCanonicalDecimals)(entries.map((entry) => entry.value)),
+        source: entries.every((entry) => entry.source === entries[0].source) ? entries[0].source : "mixed",
+    })));
+}
+//# sourceMappingURL=judge-usage-projection.cjs.map

package/dist/o11y/judge-usage-projection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-usage-projection.js","sourceRoot":"","sources":["judge-usage-projection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JudgeUsageAttachment, JudgeUsageCall } from \"../record/family/judge-usage/schema.ts\";\nimport { addCanonicalDecimals } from \"../record/family/adapter-usage/pricing.ts\";\nimport { effectiveCostTotals, type EffectiveCallCost } from \"./adapter-usage-projection.ts\";\nimport type { InspectionAttemptUsageResult, JudgeUsage, JudgeUsageSummary, TotalUsageCosts, } from \"../inspection/results.ts\";\nimport { utf8ByteLength } from \"../inspection/bytes.ts\";\nexport const JUDGE_USAGE_PREVIEW_CALL_LIMIT = 128;\nexport const JUDGE_USAGE_PREVIEW_BYTE_LIMIT = 128 * 1024;\nexport function compareJudgeUsageCalls(left: JudgeUsageCall, right: JudgeUsageCall): number {\n    return left.entryIndex - right.entryIndex || left.logicalOrdinal - right.logicalOrdinal ||\n        left.transmissionOrdinal - right.transmissionOrdinal;\n}\n/** The ledger is already validated; independent metrics retain their own coverage. */\nexport function projectJudgeUsage(ledger: JudgeUsageAttachment): JudgeUsage {\n    const receipts = new Map(ledger.priceReceipts.map((receipt) => [receipt.callId, receipt]));\n    const costCalls = ledger.calls.map((call): {\n        readonly effectiveCost: EffectiveCallCost | null;\n    } => {\n        const receipt = receipts.get(call.callId);\n        return { effectiveCost: call.cost !== null ? { ...call.cost, state: \"complete\" }\n                : receipt === undefined ? null\n                    : { amount: receipt.amount, currency: receipt.currency, source: receipt.source, state: receipt.state } };\n    });\n    const costs = effectiveCostTotals(costCalls, ledger.collection.state);\n    const numeric = (metric: \"inputTotalTokens\" | \"outputTokens\" | \"totalTokens\") => {\n        let value = 0;\n        let observationCount = 0;\n        let complete = ledger.collection.state === \"complete\";\n        for (const call of ledger.calls) {\n            const inputBuckets = [call.inputTokens, call.cacheReadTokens, call.cacheWriteTokens];\n            const knownInputs = inputBuckets.filter((bucket): bucket is number => bucket !== null);\n            const input = call.inputTotalTokens ?? (knownInputs.length === 0 ? null\n                : knownInputs.reduce((sum, bucket) => sum + bucket, 0));\n            const buckets = metric === \"inputTotalTokens\" ? [input]\n                : metric === \"outputTokens\" ? [call.outputTokens] : [input, call.outputTokens];\n            if (buckets.some((bucket) => bucket !== null))\n                observationCount++;\n            for (const bucket of buckets) {\n                if (bucket === null)\n                    complete = false;\n                else\n                    value += bucket;\n            }\n            if (metric !== \"outputTokens\" && call.inputTotalTokens === null && knownInputs.length !== 3)\n                complete = false;\n        }\n        if (!Number.isSafeInteger(value) || observationCount === 0 && ledger.calls.length > 0 ||\n            ledger.calls.length === 0 && !complete) {\n            return Object.freeze({ state: \"unavailable\" as const, value: null, observationCount });\n        }\n        return Object.freeze({ state: complete ? \"available\" as const : \"partial\" as const, value, observationCount });\n    };\n    const all: Extract<JudgeUsage, {\n        readonly state: \"complete\" | \"partial\";\n    }> = Object.freeze({\n        state: ledger.collection.state,\n        coverage: \"physical-transmissions\",\n        collection: ledger.collection,\n        calls: Object.freeze([...ledger.calls].sort(compareJudgeUsageCalls)),\n        callsTruncated: false,\n        omittedCallCount: 0,\n        totals: Object.freeze({\n            requests: Object.freeze({ state: ledger.collection.state === \"complete\" ? \"available\" : \"partial\",\n                value: ledger.calls.length, observationCount: ledger.calls.length }),\n            inputTotalTokens: numeric(\"inputTotalTokens\"), outputTokens: numeric(\"outputTokens\"), totalTokens: numeric(\"totalTokens\"),\n            costs: ledger.collection.state === \"complete\" && ledger.calls.length === 0\n                ? Object.freeze({ ...costs, state: \"complete\" }) : costs,\n        }),\n        priceReceipts: ledger.priceReceipts,\n    });\n    let preview = takeJudgeUsagePreview(all, JUDGE_USAGE_PREVIEW_CALL_LIMIT);\n    while (utf8ByteLength(JSON.stringify({ calls: preview.calls, priceReceipts: preview.priceReceipts })) >\n        JUDGE_USAGE_PREVIEW_BYTE_LIMIT && preview.calls.length > 0) {\n        preview = takeJudgeUsagePreview(preview, preview.calls.length - 1);\n    }\n    return preview;\n}\n/** Shrinking details never changes totals and retains only the corresponding price proofs. */\nexport function takeJudgeUsagePreview(usage: Extract<JudgeUsage, {\n    readonly state: \"complete\" | \"partial\";\n}>, maximumCalls: number): Extract<JudgeUsage, {\n    readonly state: \"complete\" | \"partial\";\n}> {\n    const calls = Object.freeze(usage.calls.slice(0, maximumCalls));\n    const receipts = new Map(usage.priceReceipts.map((receipt) => [receipt.callId, receipt]));\n    const priceReceipts = Object.freeze(calls.flatMap((call) => {\n        const receipt = receipts.get(call.callId);\n        return receipt === undefined ? [] : [receipt];\n    }));\n    const omittedCallCount = usage.omittedCallCount + usage.calls.length - calls.length;\n    return Object.freeze({ ...usage, calls, priceReceipts, callsTruncated: omittedCallCount > 0, omittedCallCount });\n}\nexport function summarizeJudgeUsage(usage: JudgeUsage): JudgeUsageSummary {\n    if (usage.state === \"unavailable\" || usage.state === \"invalid\")\n        return usage;\n    return Object.freeze({ state: usage.state, coverage: usage.coverage, collection: usage.collection, totals: usage.totals });\n}\n/** Currency-preserving known subtotals; no exchange rate or fabricated zero currency. */\nexport function projectTotalUsageCosts(application: InspectionAttemptUsageResult[\"totals\"], judge: JudgeUsageSummary, applicationEmptyComplete = false, applicationCollectionProven = true): TotalUsageCosts {\n    const applicationValues = application.costs !== undefined ? application.costs.values\n        : (application.providerCosts?.values ?? []).map(({ currency, value }) => ({ currency, value, source: \"reported\" as const }));\n    const judgeCosts = judge.state === \"complete\" || judge.state === \"partial\" ? judge.totals.costs : undefined;\n    const completeApplication = applicationCollectionProven && (applicationEmptyComplete || application.costs?.state === \"complete\" ||\n        application.costs === undefined && application.providerCosts?.state === \"available\");\n    const missingSources: (\"application\" | \"judge\")[] = [];\n    if (!completeApplication)\n        missingSources.push(\"application\");\n    if (judgeCosts?.state !== \"complete\")\n        missingSources.push(\"judge\");\n    const values = sumCostValues([...applicationValues, ...(judgeCosts?.values ?? [])]);\n    return Object.freeze({ state: missingSources.length === 0 ? \"complete\" : values.length === 0 ? \"unavailable\" : \"partial\",\n        values, missingSources: Object.freeze(missingSources) });\n}\n/** Inputs are unique origin Attempts, never preview rows or verdict-filtered members. */\nexport function combineTotalUsageCosts(totals: readonly TotalUsageCosts[], unresolved = false): TotalUsageCosts {\n    const missingSources = ([\"application\", \"judge\"] as const).filter((source) => unresolved || totals.some((total) => total.missingSources.includes(source)));\n    const values = sumCostValues(totals.flatMap((total) => total.values));\n    return Object.freeze({ state: missingSources.length === 0 ? \"complete\" : values.length === 0 ? \"unavailable\" : \"partial\",\n        values, missingSources: Object.freeze(missingSources) });\n}\nfunction sumCostValues(entries: TotalUsageCosts[\"values\"]): TotalUsageCosts[\"values\"] {\n    const grouped = new Map<string, {\n        readonly value: string;\n        readonly source: \"reported\" | \"estimated\" | \"mixed\";\n    }[]>();\n    for (const entry of entries) {\n        const group = grouped.get(entry.currency);\n        if (group === undefined)\n            grouped.set(entry.currency, [entry]);\n        else\n            group.push(entry);\n    }\n    return Object.freeze([...grouped.entries()].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)\n        .map(([currency, entries]) => Object.freeze({\n        currency, value: addCanonicalDecimals(entries.map((entry) => entry.value)),\n        source: entries.every((entry) => entry.source === entries[0]!.source) ? entries[0]!.source : \"mixed\" as const,\n    })));\n}\n"]}

package/dist/o11y/judge-usage-projection.d.cts

@@ -0,0 +1,18 @@
+import type { JudgeUsageAttachment, JudgeUsageCall } from "../record/family/judge-usage/schema.cjs";
+import type { InspectionAttemptUsageResult, JudgeUsage, JudgeUsageSummary, TotalUsageCosts } from "../inspection/results.cjs";
+export declare const JUDGE_USAGE_PREVIEW_CALL_LIMIT = 128;
+export declare const JUDGE_USAGE_PREVIEW_BYTE_LIMIT: number;
+export declare function compareJudgeUsageCalls(left: JudgeUsageCall, right: JudgeUsageCall): number;
+/** The ledger is already validated; independent metrics retain their own coverage. */
+export declare function projectJudgeUsage(ledger: JudgeUsageAttachment): JudgeUsage;
+/** Shrinking details never changes totals and retains only the corresponding price proofs. */
+export declare function takeJudgeUsagePreview(usage: Extract<JudgeUsage, {
+    readonly state: "complete" | "partial";
+}>, maximumCalls: number): Extract<JudgeUsage, {
+    readonly state: "complete" | "partial";
+}>;
+export declare function summarizeJudgeUsage(usage: JudgeUsage): JudgeUsageSummary;
+/** Currency-preserving known subtotals; no exchange rate or fabricated zero currency. */
+export declare function projectTotalUsageCosts(application: InspectionAttemptUsageResult["totals"], judge: JudgeUsageSummary, applicationEmptyComplete?: boolean, applicationCollectionProven?: boolean): TotalUsageCosts;
+/** Inputs are unique origin Attempts, never preview rows or verdict-filtered members. */
+export declare function combineTotalUsageCosts(totals: readonly TotalUsageCosts[], unresolved?: boolean): TotalUsageCosts;

package/dist/o11y/judge-usage-projection.d.mts

@@ -0,0 +1,18 @@
+import type { JudgeUsageAttachment, JudgeUsageCall } from "../record/family/judge-usage/schema.mjs";
+import type { InspectionAttemptUsageResult, JudgeUsage, JudgeUsageSummary, TotalUsageCosts } from "../inspection/results.mjs";
+export declare const JUDGE_USAGE_PREVIEW_CALL_LIMIT = 128;
+export declare const JUDGE_USAGE_PREVIEW_BYTE_LIMIT: number;
+export declare function compareJudgeUsageCalls(left: JudgeUsageCall, right: JudgeUsageCall): number;
+/** The ledger is already validated; independent metrics retain their own coverage. */
+export declare function projectJudgeUsage(ledger: JudgeUsageAttachment): JudgeUsage;
+/** Shrinking details never changes totals and retains only the corresponding price proofs. */
+export declare function takeJudgeUsagePreview(usage: Extract<JudgeUsage, {
+    readonly state: "complete" | "partial";
+}>, maximumCalls: number): Extract<JudgeUsage, {
+    readonly state: "complete" | "partial";
+}>;
+export declare function summarizeJudgeUsage(usage: JudgeUsage): JudgeUsageSummary;
+/** Currency-preserving known subtotals; no exchange rate or fabricated zero currency. */
+export declare function projectTotalUsageCosts(application: InspectionAttemptUsageResult["totals"], judge: JudgeUsageSummary, applicationEmptyComplete?: boolean, applicationCollectionProven?: boolean): TotalUsageCosts;
+/** Inputs are unique origin Attempts, never preview rows or verdict-filtered members. */
+export declare function combineTotalUsageCosts(totals: readonly TotalUsageCosts[], unresolved?: boolean): TotalUsageCosts;

package/dist/o11y/judge-usage-projection.d.ts

@@ -0,0 +1,18 @@
+import type { JudgeUsageAttachment, JudgeUsageCall } from "../record/family/judge-usage/schema.js";
+import type { InspectionAttemptUsageResult, JudgeUsage, JudgeUsageSummary, TotalUsageCosts } from "../inspection/results.js";
+export declare const JUDGE_USAGE_PREVIEW_CALL_LIMIT = 128;
+export declare const JUDGE_USAGE_PREVIEW_BYTE_LIMIT: number;
+export declare function compareJudgeUsageCalls(left: JudgeUsageCall, right: JudgeUsageCall): number;
+/** The ledger is already validated; independent metrics retain their own coverage. */
+export declare function projectJudgeUsage(ledger: JudgeUsageAttachment): JudgeUsage;
+/** Shrinking details never changes totals and retains only the corresponding price proofs. */
+export declare function takeJudgeUsagePreview(usage: Extract<JudgeUsage, {
+    readonly state: "complete" | "partial";
+}>, maximumCalls: number): Extract<JudgeUsage, {
+    readonly state: "complete" | "partial";
+}>;
+export declare function summarizeJudgeUsage(usage: JudgeUsage): JudgeUsageSummary;
+/** Currency-preserving known subtotals; no exchange rate or fabricated zero currency. */
+export declare function projectTotalUsageCosts(application: InspectionAttemptUsageResult["totals"], judge: JudgeUsageSummary, applicationEmptyComplete?: boolean, applicationCollectionProven?: boolean): TotalUsageCosts;
+/** Inputs are unique origin Attempts, never preview rows or verdict-filtered members. */
+export declare function combineTotalUsageCosts(totals: readonly TotalUsageCosts[], unresolved?: boolean): TotalUsageCosts;

package/dist/o11y/judge-usage-projection.js

@@ -0,0 +1,20 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./judge-usage-projection.cjs");
+const __niceevalExport0 = __niceevalCanonical["JUDGE_USAGE_PREVIEW_BYTE_LIMIT"];
+export { __niceevalExport0 as JUDGE_USAGE_PREVIEW_BYTE_LIMIT };
+const __niceevalExport1 = __niceevalCanonical["JUDGE_USAGE_PREVIEW_CALL_LIMIT"];
+export { __niceevalExport1 as JUDGE_USAGE_PREVIEW_CALL_LIMIT };
+const __niceevalExport2 = __niceevalCanonical["combineTotalUsageCosts"];
+export { __niceevalExport2 as combineTotalUsageCosts };
+const __niceevalExport3 = __niceevalCanonical["compareJudgeUsageCalls"];
+export { __niceevalExport3 as compareJudgeUsageCalls };
+const __niceevalExport4 = __niceevalCanonical["projectJudgeUsage"];
+export { __niceevalExport4 as projectJudgeUsage };
+const __niceevalExport5 = __niceevalCanonical["projectTotalUsageCosts"];
+export { __niceevalExport5 as projectTotalUsageCosts };
+const __niceevalExport6 = __niceevalCanonical["summarizeJudgeUsage"];
+export { __niceevalExport6 as summarizeJudgeUsage };
+const __niceevalExport7 = __niceevalCanonical["takeJudgeUsagePreview"];
+export { __niceevalExport7 as takeJudgeUsagePreview };
+//# sourceMappingURL=judge-usage-projection.js.map

package/dist/o11y/judge-usage-projection.js.map

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