niceeval 0.15.1-canary.76 → 0.16.1

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

@@ -0,0 +1,141 @@
+import type { ReadableAdapterUsageAttachment, AdapterUsageCall, AdapterCallPriceReceipt } from "../record/family/adapter-usage/schema.cjs";
+import type { NumericMaterial } from "../assertions/match.cjs";
+import type { ResolvedModelSlots } from "../model-slots.cjs";
+export interface EffectiveCallCost {
+    readonly amount: string;
+    readonly currency: string;
+    readonly source: {
+        readonly kind: "reported" | "estimated";
+        readonly id: string;
+    };
+    readonly state: "complete" | "partial";
+}
+export type EffectiveUsageCall = AdapterUsageCall & {
+    readonly effectiveCost: EffectiveCallCost | null;
+};
+export declare function effectiveUsageCalls(usage: ReadableAdapterUsageAttachment): readonly EffectiveUsageCall[];
+export declare function effectiveCostTotals(calls: readonly {
+    readonly effectiveCost: EffectiveCallCost | null;
+}[], collectionState: "complete" | "partial"): Readonly<{
+    state: "complete" | "partial" | "unavailable";
+    source: "reported" | "estimated" | "mixed" | null;
+    values: readonly Readonly<{
+        currency: string;
+        value: string;
+        source: "reported" | "estimated" | "mixed";
+        coveredCalls: number;
+        reportedCalls: number;
+        estimatedCalls: number;
+    }>[];
+    totalCalls: number;
+}>;
+export declare function adapterTokenMaterial(usage: ReadableAdapterUsageAttachment, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
+export declare function adapterInspectionTokenTotal(usage: ReadableAdapterUsageAttachment, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
+    state: "partial" | "available" | "unavailable";
+    value: number | null;
+    observationCount: number;
+}>;
+/** Tuple order is stable across hosts, with missing identities before strings. */
+export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">, right: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">): number;
+/** Configuration counts and grouped statistics both consume the complete sealed ledger. */
+export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelSlots | undefined, unavailable?: {
+    readonly basis: "recorded-calls" | "reported-sends" | "unavailable";
+    readonly reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
+}): Readonly<{
+    configuredModels: Readonly<{
+        state: "not-recorded";
+    }> | Readonly<{
+        state: "available";
+        bindings: readonly Readonly<{
+            recordedCalls: number | null;
+            model: string | null;
+            reasoningEffort: string | null;
+            modelSlot: string;
+        }>[];
+    }>;
+    modelGroups: Readonly<{
+        groups: readonly [];
+        totalGroupCount: null;
+        groupsTruncated: false;
+        omittedGroupCount: 0;
+        basis: "recorded-calls" | "reported-sends" | "unavailable";
+        reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
+        state: "unavailable";
+    }>;
+}> | Readonly<{
+    configuredModels: Readonly<{
+        state: "not-recorded";
+    }> | Readonly<{
+        state: "available";
+        bindings: readonly Readonly<{
+            recordedCalls: number | null;
+            model: string | null;
+            reasoningEffort: string | null;
+            modelSlot: string;
+        }>[];
+    }>;
+    modelGroups: Readonly<{
+        state: "available";
+        basis: "recorded-calls";
+        groups: readonly Readonly<{
+            modelSlot: string | null;
+            provider: string | null;
+            model: string | null;
+            recordedCalls: number;
+            tokens: Readonly<{
+                inputTotalTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+                outputTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+                totalTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+            }>;
+            costs: Readonly<{
+                state: "complete" | "partial" | "unavailable";
+                source: "reported" | "estimated" | "mixed" | null;
+                values: readonly Readonly<{
+                    currency: string;
+                    value: string;
+                    source: "reported" | "estimated" | "mixed";
+                    coveredCalls: number;
+                    reportedCalls: number;
+                    estimatedCalls: number;
+                }>[];
+                totalCalls: number;
+            }>;
+        }>[];
+        totalGroupCount: number;
+        groupsTruncated: boolean;
+        omittedGroupCount: number;
+    }>;
+}>;
+export interface AdapterAttemptUsageSnapshot {
+    readonly source: "adapter";
+    readonly scope: "recorded-calls";
+    readonly cut: "call-time";
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly EffectiveUsageCall[];
+    readonly priceReceipts: readonly AdapterCallPriceReceipt[];
+    readonly inputTokens: NumericMaterial;
+    readonly inputTotalTokens: NumericMaterial;
+    readonly outputTokens: NumericMaterial;
+    readonly cacheReadTokens: NumericMaterial;
+    readonly cacheWriteTokens: NumericMaterial;
+    readonly totalTokens: NumericMaterial;
+    readonly costs: ReturnType<typeof effectiveCostTotals>;
+}
+export type AttemptUsageSnapshot = AdapterAttemptUsageSnapshot | {
+    readonly source: "unavailable";
+    readonly reason: "usage-owner-not-bound";
+};
+export declare function projectAdapterUsageSnapshot(usage: ReadableAdapterUsageAttachment): AdapterAttemptUsageSnapshot;
+export declare function compareCanonicalDecimal(left: string, right: string): -1 | 0 | 1;

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

@@ -0,0 +1,141 @@
+import type { ReadableAdapterUsageAttachment, AdapterUsageCall, AdapterCallPriceReceipt } from "../record/family/adapter-usage/schema.mjs";
+import type { NumericMaterial } from "../assertions/match.mjs";
+import type { ResolvedModelSlots } from "../model-slots.mjs";
+export interface EffectiveCallCost {
+    readonly amount: string;
+    readonly currency: string;
+    readonly source: {
+        readonly kind: "reported" | "estimated";
+        readonly id: string;
+    };
+    readonly state: "complete" | "partial";
+}
+export type EffectiveUsageCall = AdapterUsageCall & {
+    readonly effectiveCost: EffectiveCallCost | null;
+};
+export declare function effectiveUsageCalls(usage: ReadableAdapterUsageAttachment): readonly EffectiveUsageCall[];
+export declare function effectiveCostTotals(calls: readonly {
+    readonly effectiveCost: EffectiveCallCost | null;
+}[], collectionState: "complete" | "partial"): Readonly<{
+    state: "complete" | "partial" | "unavailable";
+    source: "reported" | "estimated" | "mixed" | null;
+    values: readonly Readonly<{
+        currency: string;
+        value: string;
+        source: "reported" | "estimated" | "mixed";
+        coveredCalls: number;
+        reportedCalls: number;
+        estimatedCalls: number;
+    }>[];
+    totalCalls: number;
+}>;
+export declare function adapterTokenMaterial(usage: ReadableAdapterUsageAttachment, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
+export declare function adapterInspectionTokenTotal(usage: ReadableAdapterUsageAttachment, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
+    state: "partial" | "available" | "unavailable";
+    value: number | null;
+    observationCount: number;
+}>;
+/** Tuple order is stable across hosts, with missing identities before strings. */
+export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">, right: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">): number;
+/** Configuration counts and grouped statistics both consume the complete sealed ledger. */
+export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelSlots | undefined, unavailable?: {
+    readonly basis: "recorded-calls" | "reported-sends" | "unavailable";
+    readonly reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
+}): Readonly<{
+    configuredModels: Readonly<{
+        state: "not-recorded";
+    }> | Readonly<{
+        state: "available";
+        bindings: readonly Readonly<{
+            recordedCalls: number | null;
+            model: string | null;
+            reasoningEffort: string | null;
+            modelSlot: string;
+        }>[];
+    }>;
+    modelGroups: Readonly<{
+        groups: readonly [];
+        totalGroupCount: null;
+        groupsTruncated: false;
+        omittedGroupCount: 0;
+        basis: "recorded-calls" | "reported-sends" | "unavailable";
+        reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
+        state: "unavailable";
+    }>;
+}> | Readonly<{
+    configuredModels: Readonly<{
+        state: "not-recorded";
+    }> | Readonly<{
+        state: "available";
+        bindings: readonly Readonly<{
+            recordedCalls: number | null;
+            model: string | null;
+            reasoningEffort: string | null;
+            modelSlot: string;
+        }>[];
+    }>;
+    modelGroups: Readonly<{
+        state: "available";
+        basis: "recorded-calls";
+        groups: readonly Readonly<{
+            modelSlot: string | null;
+            provider: string | null;
+            model: string | null;
+            recordedCalls: number;
+            tokens: Readonly<{
+                inputTotalTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+                outputTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+                totalTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+            }>;
+            costs: Readonly<{
+                state: "complete" | "partial" | "unavailable";
+                source: "reported" | "estimated" | "mixed" | null;
+                values: readonly Readonly<{
+                    currency: string;
+                    value: string;
+                    source: "reported" | "estimated" | "mixed";
+                    coveredCalls: number;
+                    reportedCalls: number;
+                    estimatedCalls: number;
+                }>[];
+                totalCalls: number;
+            }>;
+        }>[];
+        totalGroupCount: number;
+        groupsTruncated: boolean;
+        omittedGroupCount: number;
+    }>;
+}>;
+export interface AdapterAttemptUsageSnapshot {
+    readonly source: "adapter";
+    readonly scope: "recorded-calls";
+    readonly cut: "call-time";
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly EffectiveUsageCall[];
+    readonly priceReceipts: readonly AdapterCallPriceReceipt[];
+    readonly inputTokens: NumericMaterial;
+    readonly inputTotalTokens: NumericMaterial;
+    readonly outputTokens: NumericMaterial;
+    readonly cacheReadTokens: NumericMaterial;
+    readonly cacheWriteTokens: NumericMaterial;
+    readonly totalTokens: NumericMaterial;
+    readonly costs: ReturnType<typeof effectiveCostTotals>;
+}
+export type AttemptUsageSnapshot = AdapterAttemptUsageSnapshot | {
+    readonly source: "unavailable";
+    readonly reason: "usage-owner-not-bound";
+};
+export declare function projectAdapterUsageSnapshot(usage: ReadableAdapterUsageAttachment): AdapterAttemptUsageSnapshot;
+export declare function compareCanonicalDecimal(left: string, right: string): -1 | 0 | 1;

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

@@ -0,0 +1,141 @@
+import type { ReadableAdapterUsageAttachment, AdapterUsageCall, AdapterCallPriceReceipt } from "../record/family/adapter-usage/schema.js";
+import type { NumericMaterial } from "../assertions/match.js";
+import type { ResolvedModelSlots } from "../model-slots.js";
+export interface EffectiveCallCost {
+    readonly amount: string;
+    readonly currency: string;
+    readonly source: {
+        readonly kind: "reported" | "estimated";
+        readonly id: string;
+    };
+    readonly state: "complete" | "partial";
+}
+export type EffectiveUsageCall = AdapterUsageCall & {
+    readonly effectiveCost: EffectiveCallCost | null;
+};
+export declare function effectiveUsageCalls(usage: ReadableAdapterUsageAttachment): readonly EffectiveUsageCall[];
+export declare function effectiveCostTotals(calls: readonly {
+    readonly effectiveCost: EffectiveCallCost | null;
+}[], collectionState: "complete" | "partial"): Readonly<{
+    state: "complete" | "partial" | "unavailable";
+    source: "reported" | "estimated" | "mixed" | null;
+    values: readonly Readonly<{
+        currency: string;
+        value: string;
+        source: "reported" | "estimated" | "mixed";
+        coveredCalls: number;
+        reportedCalls: number;
+        estimatedCalls: number;
+    }>[];
+    totalCalls: number;
+}>;
+export declare function adapterTokenMaterial(usage: ReadableAdapterUsageAttachment, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
+export declare function adapterInspectionTokenTotal(usage: ReadableAdapterUsageAttachment, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
+    state: "partial" | "available" | "unavailable";
+    value: number | null;
+    observationCount: number;
+}>;
+/** Tuple order is stable across hosts, with missing identities before strings. */
+export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">, right: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">): number;
+/** Configuration counts and grouped statistics both consume the complete sealed ledger. */
+export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelSlots | undefined, unavailable?: {
+    readonly basis: "recorded-calls" | "reported-sends" | "unavailable";
+    readonly reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
+}): Readonly<{
+    configuredModels: Readonly<{
+        state: "not-recorded";
+    }> | Readonly<{
+        state: "available";
+        bindings: readonly Readonly<{
+            recordedCalls: number | null;
+            model: string | null;
+            reasoningEffort: string | null;
+            modelSlot: string;
+        }>[];
+    }>;
+    modelGroups: Readonly<{
+        groups: readonly [];
+        totalGroupCount: null;
+        groupsTruncated: false;
+        omittedGroupCount: 0;
+        basis: "recorded-calls" | "reported-sends" | "unavailable";
+        reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
+        state: "unavailable";
+    }>;
+}> | Readonly<{
+    configuredModels: Readonly<{
+        state: "not-recorded";
+    }> | Readonly<{
+        state: "available";
+        bindings: readonly Readonly<{
+            recordedCalls: number | null;
+            model: string | null;
+            reasoningEffort: string | null;
+            modelSlot: string;
+        }>[];
+    }>;
+    modelGroups: Readonly<{
+        state: "available";
+        basis: "recorded-calls";
+        groups: readonly Readonly<{
+            modelSlot: string | null;
+            provider: string | null;
+            model: string | null;
+            recordedCalls: number;
+            tokens: Readonly<{
+                inputTotalTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+                outputTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+                totalTokens: Readonly<{
+                    state: "partial" | "available" | "unavailable";
+                    value: number | null;
+                    observationCount: number;
+                }>;
+            }>;
+            costs: Readonly<{
+                state: "complete" | "partial" | "unavailable";
+                source: "reported" | "estimated" | "mixed" | null;
+                values: readonly Readonly<{
+                    currency: string;
+                    value: string;
+                    source: "reported" | "estimated" | "mixed";
+                    coveredCalls: number;
+                    reportedCalls: number;
+                    estimatedCalls: number;
+                }>[];
+                totalCalls: number;
+            }>;
+        }>[];
+        totalGroupCount: number;
+        groupsTruncated: boolean;
+        omittedGroupCount: number;
+    }>;
+}>;
+export interface AdapterAttemptUsageSnapshot {
+    readonly source: "adapter";
+    readonly scope: "recorded-calls";
+    readonly cut: "call-time";
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly EffectiveUsageCall[];
+    readonly priceReceipts: readonly AdapterCallPriceReceipt[];
+    readonly inputTokens: NumericMaterial;
+    readonly inputTotalTokens: NumericMaterial;
+    readonly outputTokens: NumericMaterial;
+    readonly cacheReadTokens: NumericMaterial;
+    readonly cacheWriteTokens: NumericMaterial;
+    readonly totalTokens: NumericMaterial;
+    readonly costs: ReturnType<typeof effectiveCostTotals>;
+}
+export type AttemptUsageSnapshot = AdapterAttemptUsageSnapshot | {
+    readonly source: "unavailable";
+    readonly reason: "usage-owner-not-bound";
+};
+export declare function projectAdapterUsageSnapshot(usage: ReadableAdapterUsageAttachment): AdapterAttemptUsageSnapshot;
+export declare function compareCanonicalDecimal(left: string, right: string): -1 | 0 | 1;

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

@@ -0,0 +1,20 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./adapter-usage-projection.cjs");
+const __niceevalExport0 = __niceevalCanonical["adapterInspectionTokenTotal"];
+export { __niceevalExport0 as adapterInspectionTokenTotal };
+const __niceevalExport1 = __niceevalCanonical["adapterTokenMaterial"];
+export { __niceevalExport1 as adapterTokenMaterial };
+const __niceevalExport2 = __niceevalCanonical["compareAdapterModelGroups"];
+export { __niceevalExport2 as compareAdapterModelGroups };
+const __niceevalExport3 = __niceevalCanonical["compareCanonicalDecimal"];
+export { __niceevalExport3 as compareCanonicalDecimal };
+const __niceevalExport4 = __niceevalCanonical["effectiveCostTotals"];
+export { __niceevalExport4 as effectiveCostTotals };
+const __niceevalExport5 = __niceevalCanonical["effectiveUsageCalls"];
+export { __niceevalExport5 as effectiveUsageCalls };
+const __niceevalExport6 = __niceevalCanonical["projectAdapterModelUsage"];
+export { __niceevalExport6 as projectAdapterModelUsage };
+const __niceevalExport7 = __niceevalCanonical["projectAdapterUsageSnapshot"];
+export { __niceevalExport7 as projectAdapterUsageSnapshot };
+//# sourceMappingURL=adapter-usage-projection.js.map

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

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

package/dist/o11y/eval-usage.cjs

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectAdapterEvalUsage = projectAdapterEvalUsage;
+exports.projectAgentEvalUsage = projectAgentEvalUsage;
+const pricing_ts_1 = require("../record/family/adapter-usage/pricing.cjs");
+const adapter_usage_projection_ts_1 = require("./adapter-usage-projection.cjs");
+function contributionCosts(calls, complete) {
+    const totals = (0, adapter_usage_projection_ts_1.effectiveCostTotals)(calls, complete ? "complete" : "partial");
+    return Object.freeze({
+        state: totals.state,
+        values: Object.freeze(totals.values.map((value) => Object.freeze({
+            currency: value.currency,
+            value: value.value,
+            source: value.source,
+            coveredContributions: value.coveredCalls,
+            reportedContributions: value.reportedCalls,
+            estimatedContributions: value.estimatedCalls,
+        }))),
+        totalContributions: totals.totalCalls,
+    });
+}
+function projectAdapterEvalUsage(usage) {
+    return Object.freeze({
+        source: "adapter",
+        scope: "attempt",
+        basis: "recorded-calls",
+        cut: "call-time",
+        inputTokens: (0, adapter_usage_projection_ts_1.adapterTokenMaterial)(usage, "inputTokens"),
+        inputTotalTokens: (0, adapter_usage_projection_ts_1.adapterTokenMaterial)(usage, "inputTotalTokens"),
+        outputTokens: (0, adapter_usage_projection_ts_1.adapterTokenMaterial)(usage, "outputTokens"),
+        cacheReadTokens: (0, adapter_usage_projection_ts_1.adapterTokenMaterial)(usage, "cacheReadTokens"),
+        cacheWriteTokens: (0, adapter_usage_projection_ts_1.adapterTokenMaterial)(usage, "cacheWriteTokens"),
+        totalTokens: (0, adapter_usage_projection_ts_1.adapterTokenMaterial)(usage, "totalTokens"),
+        costs: contributionCosts((0, adapter_usage_projection_ts_1.effectiveUsageCalls)(usage), usage.collection.state === "complete"),
+    });
+}
+function tokenBuckets(contribution, metric) {
+    // Some producers have an independent total. Missing totals retain the mutually exclusive bucket fallback.
+    const usage = contribution.usage;
+    if (contribution.state === "pending" || usage === null)
+        return [undefined];
+    const input = usage.inputTotalTokens !== undefined
+        ? [usage.inputTotalTokens]
+        : [usage.inputTokens, usage.cacheReadTokens, usage.cacheCreationTokens];
+    switch (metric) {
+        case "inputTotalTokens": return input;
+        case "totalTokens": return [...input, usage.outputTokens];
+        case "cacheWriteTokens": return [usage.cacheCreationTokens];
+        default: return [usage[metric]];
+    }
+}
+function agentTokenMaterial(contributions, metric, scope) {
+    const provenance = Object.freeze({ source: "agent", scope, unit: "tokens", cut: "call-time" });
+    let value = 0;
+    let observed = false;
+    let complete = contributions.length > 0;
+    for (const contribution of contributions) {
+        if (contribution.state !== "terminal" || contribution.coverage.status !== "complete")
+            complete = false;
+        for (const bucket of tokenBuckets(contribution, metric)) {
+            if (bucket === undefined) {
+                complete = false;
+                continue;
+            }
+            if (!Number.isSafeInteger(bucket) || bucket < 0) {
+                return Object.freeze({ state: "unavailable", reason: "usage-invalid-token-value", provenance });
+            }
+            value += bucket;
+            observed = true;
+            if (!Number.isSafeInteger(value)) {
+                return Object.freeze({ state: "unavailable", reason: "usage-exceeds-safe-integer", provenance });
+            }
+        }
+    }
+    return Object.freeze(!observed
+        ? { state: "unavailable", reason: "usage-not-reported", provenance }
+        : { state: complete ? "exact" : "lower-bound", value, provenance });
+}
+function agentCost(contribution, pricing) {
+    const usage = contribution.usage;
+    if (contribution.state === "pending" || usage === null)
+        return null;
+    const coverageComplete = contribution.coverage.status === "complete";
+    if (usage.costUSD !== undefined) {
+        const amount = (0, pricing_ts_1.canonicalDecimalFromNumber)(usage.costUSD);
+        return amount === undefined ? null : Object.freeze({
+            amount, currency: "USD", source: Object.freeze({ kind: "reported", id: "agent-send" }),
+            state: coverageComplete ? "complete" : "partial",
+        });
+    }
+    const model = contribution.model;
+    if (model === null || pricing === undefined)
+        return null;
+    const wildcard = model.includes("/") ? `${model.slice(0, model.indexOf("/"))}/*` : undefined;
+    const profile = Object.hasOwn(pricing, model) ? pricing[model]
+        : wildcard !== undefined && Object.hasOwn(pricing, wildcard) ? pricing[wildcard] : undefined;
+    if (profile === undefined || profile.currency !== undefined && profile.currency !== "USD" ||
+        profile.basis !== undefined && profile.basis !== "catalog-reference")
+        return null;
+    const buckets = [
+        [usage.inputTokens, profile.inputPerMTok],
+        [usage.outputTokens, profile.outputPerMTok],
+        [usage.cacheReadTokens, profile.cacheReadPerMTok],
+        [usage.cacheCreationTokens, profile.cacheWritePerMTok],
+    ];
+    const charges = [];
+    let complete = coverageComplete;
+    for (const [tokens, price] of buckets) {
+        if (tokens === undefined || !Number.isSafeInteger(tokens) || tokens < 0) {
+            complete = false;
+            continue;
+        }
+        if (tokens === 0) {
+            charges.push("0");
+            continue;
+        }
+        const rate = price === undefined ? undefined : (0, pricing_ts_1.canonicalDecimalFromNumber)(price);
+        if (rate === undefined) {
+            complete = false;
+            continue;
+        }
+        charges.push((0, pricing_ts_1.multiplyCanonicalDecimalPerMillion)(rate, tokens));
+    }
+    return charges.length === 0 ? null : Object.freeze({
+        amount: (0, pricing_ts_1.addCanonicalDecimals)(charges),
+        currency: "USD",
+        source: Object.freeze({ kind: "estimated", id: profile.source?.id ?? "niceeval.config.pricing" }),
+        state: complete ? "complete" : "partial",
+    });
+}
+/** The receiver selects scope membership before calling this pure projection. */
+function projectAgentEvalUsage(input) {
+    return Object.freeze({
+        source: "agent",
+        scope: input.scope,
+        basis: "reported-sends",
+        cut: "call-time",
+        inputTokens: agentTokenMaterial(input.contributions, "inputTokens", input.scope),
+        inputTotalTokens: agentTokenMaterial(input.contributions, "inputTotalTokens", input.scope),
+        outputTokens: agentTokenMaterial(input.contributions, "outputTokens", input.scope),
+        cacheReadTokens: agentTokenMaterial(input.contributions, "cacheReadTokens", input.scope),
+        cacheWriteTokens: agentTokenMaterial(input.contributions, "cacheWriteTokens", input.scope),
+        totalTokens: agentTokenMaterial(input.contributions, "totalTokens", input.scope),
+        costs: contributionCosts(input.contributions.map((contribution) => ({
+            effectiveCost: agentCost(contribution, input.pricing),
+        })), input.contributions.every((contribution) => contribution.state === "terminal" && contribution.coverage.status === "complete")),
+    });
+}
+//# sourceMappingURL=eval-usage.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eval-usage.js","sourceRoot":"","sources":["eval-usage.ts"],"names":[],"mappings":"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","sourcesContent":["import type { NumericMaterial } from \"../assertions/match.ts\";\nimport type { ResolvedEvidenceCoverage } from \"../assertions/coverage.ts\";\nimport type { PriceOverride, Usage } from \"../types.ts\";\nimport type { ReadableAdapterUsageAttachment } from \"../record/family/adapter-usage/schema.ts\";\nimport { addCanonicalDecimals, canonicalDecimalFromNumber, multiplyCanonicalDecimalPerMillion, } from \"../record/family/adapter-usage/pricing.ts\";\nimport { adapterTokenMaterial, effectiveCostTotals, effectiveUsageCalls, type EffectiveCallCost, } from \"./adapter-usage-projection.ts\";\n/** Internal source-owned shape; package-root exposure belongs to the author facade. */\nexport interface EvalUsage {\n    readonly source: \"agent\" | \"adapter\" | \"unavailable\";\n    readonly scope: \"turn\" | \"session\" | \"attempt\";\n    readonly basis: \"reported-sends\" | \"recorded-calls\" | \"unbound\";\n    readonly cut: \"call-time\";\n    readonly inputTokens: NumericMaterial;\n    readonly inputTotalTokens: NumericMaterial;\n    readonly outputTokens: NumericMaterial;\n    readonly cacheReadTokens: NumericMaterial;\n    readonly cacheWriteTokens: NumericMaterial;\n    readonly totalTokens: NumericMaterial;\n    readonly costs: {\n        readonly state: \"complete\" | \"partial\" | \"unavailable\";\n        readonly values: readonly {\n            readonly currency: string;\n            readonly value: string;\n            readonly source: \"reported\" | \"estimated\" | \"mixed\";\n            readonly coveredContributions: number;\n            readonly reportedContributions: number;\n            readonly estimatedContributions: number;\n        }[];\n        readonly totalContributions: number;\n    };\n}\nexport interface AgentUsageContribution {\n    readonly sessionScopeId: string;\n    readonly turnId: string;\n    readonly sendAttempt: number;\n    readonly state: \"pending\" | \"terminal\";\n    readonly outcome: \"completed\" | \"failed\" | \"interrupted\" | null;\n    readonly model: string | null;\n    readonly usage: Readonly<Usage> | null;\n    readonly coverage: ResolvedEvidenceCoverage[\"usage\"];\n}\ntype TokenMetric = \"inputTokens\" | \"inputTotalTokens\" | \"outputTokens\" | \"cacheReadTokens\" | \"cacheWriteTokens\" | \"totalTokens\";\nfunction contributionCosts(calls: readonly {\n    readonly effectiveCost: EffectiveCallCost | null;\n}[], complete: boolean): EvalUsage[\"costs\"] {\n    const totals = effectiveCostTotals(calls, complete ? \"complete\" : \"partial\");\n    return Object.freeze({\n        state: totals.state,\n        values: Object.freeze(totals.values.map((value) => Object.freeze({\n            currency: value.currency,\n            value: value.value,\n            source: value.source,\n            coveredContributions: value.coveredCalls,\n            reportedContributions: value.reportedCalls,\n            estimatedContributions: value.estimatedCalls,\n        }))),\n        totalContributions: totals.totalCalls,\n    });\n}\nexport function projectAdapterEvalUsage(usage: ReadableAdapterUsageAttachment): EvalUsage {\n    return Object.freeze({\n        source: \"adapter\",\n        scope: \"attempt\",\n        basis: \"recorded-calls\",\n        cut: \"call-time\",\n        inputTokens: adapterTokenMaterial(usage, \"inputTokens\"),\n        inputTotalTokens: adapterTokenMaterial(usage, \"inputTotalTokens\"),\n        outputTokens: adapterTokenMaterial(usage, \"outputTokens\"),\n        cacheReadTokens: adapterTokenMaterial(usage, \"cacheReadTokens\"),\n        cacheWriteTokens: adapterTokenMaterial(usage, \"cacheWriteTokens\"),\n        totalTokens: adapterTokenMaterial(usage, \"totalTokens\"),\n        costs: contributionCosts(effectiveUsageCalls(usage), usage.collection.state === \"complete\"),\n    });\n}\nfunction tokenBuckets(contribution: AgentUsageContribution, metric: TokenMetric): readonly (number | undefined)[] {\n    // Some producers have an independent total. Missing totals retain the mutually exclusive bucket fallback.\n    const usage: (Readonly<Usage> & {\n        readonly inputTotalTokens?: number;\n    }) | null = contribution.usage;\n    if (contribution.state === \"pending\" || usage === null)\n        return [undefined];\n    const input = usage.inputTotalTokens !== undefined\n        ? [usage.inputTotalTokens]\n        : [usage.inputTokens, usage.cacheReadTokens, usage.cacheCreationTokens];\n    switch (metric) {\n        case \"inputTotalTokens\": return input;\n        case \"totalTokens\": return [...input, usage.outputTokens];\n        case \"cacheWriteTokens\": return [usage.cacheCreationTokens];\n        default: return [usage[metric]];\n    }\n}\nfunction agentTokenMaterial(contributions: readonly AgentUsageContribution[], metric: TokenMetric, scope: EvalUsage[\"scope\"]): NumericMaterial {\n    const provenance = Object.freeze({ source: \"agent\", scope, unit: \"tokens\", cut: \"call-time\" });\n    let value = 0;\n    let observed = false;\n    let complete = contributions.length > 0;\n    for (const contribution of contributions) {\n        if (contribution.state !== \"terminal\" || contribution.coverage.status !== \"complete\")\n            complete = false;\n        for (const bucket of tokenBuckets(contribution, metric)) {\n            if (bucket === undefined) {\n                complete = false;\n                continue;\n            }\n            if (!Number.isSafeInteger(bucket) || bucket < 0) {\n                return Object.freeze({ state: \"unavailable\", reason: \"usage-invalid-token-value\", provenance });\n            }\n            value += bucket;\n            observed = true;\n            if (!Number.isSafeInteger(value)) {\n                return Object.freeze({ state: \"unavailable\", reason: \"usage-exceeds-safe-integer\", provenance });\n            }\n        }\n    }\n    return Object.freeze(!observed\n        ? { state: \"unavailable\", reason: \"usage-not-reported\", provenance }\n        : { state: complete ? \"exact\" : \"lower-bound\", value, provenance });\n}\nfunction agentCost(contribution: AgentUsageContribution, pricing: Record<string, PriceOverride> | undefined): EffectiveCallCost | null {\n    const usage = contribution.usage;\n    if (contribution.state === \"pending\" || usage === null)\n        return null;\n    const coverageComplete = contribution.coverage.status === \"complete\";\n    if (usage.costUSD !== undefined) {\n        const amount = canonicalDecimalFromNumber(usage.costUSD);\n        return amount === undefined ? null : Object.freeze({\n            amount, currency: \"USD\", source: Object.freeze({ kind: \"reported\", id: \"agent-send\" }),\n            state: coverageComplete ? \"complete\" : \"partial\",\n        });\n    }\n    const model = contribution.model;\n    if (model === null || pricing === undefined)\n        return null;\n    const wildcard = model.includes(\"/\") ? `${model.slice(0, model.indexOf(\"/\"))}/*` : undefined;\n    const profile = Object.hasOwn(pricing, model) ? pricing[model]\n        : wildcard !== undefined && Object.hasOwn(pricing, wildcard) ? pricing[wildcard] : undefined;\n    if (profile === undefined || profile.currency !== undefined && profile.currency !== \"USD\" ||\n        profile.basis !== undefined && profile.basis !== \"catalog-reference\")\n        return null;\n    const buckets = [\n        [usage.inputTokens, profile.inputPerMTok],\n        [usage.outputTokens, profile.outputPerMTok],\n        [usage.cacheReadTokens, profile.cacheReadPerMTok],\n        [usage.cacheCreationTokens, profile.cacheWritePerMTok],\n    ] as const;\n    const charges: string[] = [];\n    let complete = coverageComplete;\n    for (const [tokens, price] of buckets) {\n        if (tokens === undefined || !Number.isSafeInteger(tokens) || tokens < 0) {\n            complete = false;\n            continue;\n        }\n        if (tokens === 0) {\n            charges.push(\"0\");\n            continue;\n        }\n        const rate = price === undefined ? undefined : canonicalDecimalFromNumber(price);\n        if (rate === undefined) {\n            complete = false;\n            continue;\n        }\n        charges.push(multiplyCanonicalDecimalPerMillion(rate, tokens));\n    }\n    return charges.length === 0 ? null : Object.freeze({\n        amount: addCanonicalDecimals(charges),\n        currency: \"USD\",\n        source: Object.freeze({ kind: \"estimated\", id: profile.source?.id ?? \"niceeval.config.pricing\" }),\n        state: complete ? \"complete\" : \"partial\",\n    });\n}\n/** The receiver selects scope membership before calling this pure projection. */\nexport function projectAgentEvalUsage(input: {\n    contributions: readonly AgentUsageContribution[];\n    scope: \"turn\" | \"session\" | \"attempt\";\n    pricing?: Record<string, PriceOverride>;\n}): EvalUsage {\n    return Object.freeze({\n        source: \"agent\",\n        scope: input.scope,\n        basis: \"reported-sends\",\n        cut: \"call-time\",\n        inputTokens: agentTokenMaterial(input.contributions, \"inputTokens\", input.scope),\n        inputTotalTokens: agentTokenMaterial(input.contributions, \"inputTotalTokens\", input.scope),\n        outputTokens: agentTokenMaterial(input.contributions, \"outputTokens\", input.scope),\n        cacheReadTokens: agentTokenMaterial(input.contributions, \"cacheReadTokens\", input.scope),\n        cacheWriteTokens: agentTokenMaterial(input.contributions, \"cacheWriteTokens\", input.scope),\n        totalTokens: agentTokenMaterial(input.contributions, \"totalTokens\", input.scope),\n        costs: contributionCosts(input.contributions.map((contribution) => ({\n            effectiveCost: agentCost(contribution, input.pricing),\n        })), input.contributions.every((contribution) => contribution.state === \"terminal\" && contribution.coverage.status === \"complete\")),\n    });\n}\n"]}