niceeval 0.12.2-canary.31 → 0.13.0

package/dist/analysis/cost-projection.cjs

@@ -0,0 +1,430 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unavailableCostSlot = unavailableCostSlot;
+exports.projectCostUsage = projectCostUsage;
+exports.aggregateCostProjection = aggregateCostProjection;
+const model_ts_1 = require("../o11y/record/model.cjs");
+const cost_decimal_ts_1 = require("./cost-decimal.cjs");
+const cost_ts_1 = require("./cost.cjs");
+/** @internal Builds a missing denominator Slot without inventing a provider. */
+function unavailableCostSlot(member, code, refs = []) {
+    const slot = closeSlot(member);
+    const reason = costReason(slot, null, code);
+    return Object.freeze({
+        slot,
+        complete: false,
+        observed: Object.freeze([]),
+        estimated: Object.freeze([]),
+        reasons: Object.freeze([reason]),
+        ledger: Object.freeze([
+            Object.freeze({
+                slot,
+                provider: null,
+                branch: "unavailable",
+                components: Object.freeze([]),
+                estimated: null,
+            }),
+        ]),
+        refs: freezeRefs(refs),
+    });
+}
+/** @internal Closes one available Usage family with origin-only profile matching. */
+function projectCostUsage(input) {
+    const slot = closeSlot(input.member);
+    const byProvider = new Map();
+    for (const observation of input.usage.observations) {
+        const provider = requiredSafeIdentifier(observation.provider, "Usage provider");
+        const entries = byProvider.get(provider);
+        if (entries === undefined)
+            byProvider.set(provider, [observation]);
+        else
+            entries.push(observation);
+    }
+    const observed = [];
+    const estimated = [];
+    const reasons = [];
+    const ledger = [];
+    let complete = input.usage.collection.state === "complete";
+    if (!complete)
+        reasons.push(costReason(slot, null, "usage-collection-partial"));
+    for (const [provider, observations] of [...byProvider.entries()].sort(compareProviderEntry)) {
+        const providerCosts = observations.filter((observation) => observation.kind === "provider-cost");
+        if (providerCosts.length > 0) {
+            const components = Object.freeze(providerCosts
+                .map((observation) => Object.freeze({
+                kind: "provider-cost",
+                provider,
+                currency: requiredCurrencyCode(observation.currency, "Usage provider-cost currency"),
+                amount: requiredCanonicalDecimal(observation.amount, "Usage provider-cost amount"),
+            }))
+                .sort(compareComponent));
+            observed.push(...components.map((component) => Object.freeze({
+                provider: component.provider,
+                currency: component.currency,
+                amount: component.amount,
+            })));
+            if (components.some((entry) => entry.currency !== input.profile.currency)) {
+                complete = false;
+                reasons.push(costReason(slot, provider, "observed-cost-other-currency"));
+            }
+            ledger.push(Object.freeze({
+                slot,
+                provider,
+                branch: "observed",
+                components,
+                estimated: null,
+            }));
+            continue;
+        }
+        if (input.core.origin.execution.model === null) {
+            complete = false;
+            reasons.push(costReason(slot, provider, "execution-model-not-recorded"));
+            ledger.push(unavailableLedger(slot, provider));
+            continue;
+        }
+        const coverage = matchingCoverage(input.profile, provider, input.core);
+        if (coverage === undefined) {
+            complete = false;
+            reasons.push(costReason(slot, provider, "pricing-coverage-not-found"));
+            ledger.push(unavailableLedger(slot, provider));
+            continue;
+        }
+        if (coverage.state === "unpriced") {
+            complete = false;
+            reasons.push(costReason(slot, provider, "pricing-coverage-unpriced"));
+            ledger.push(unavailableLedger(slot, provider));
+            continue;
+        }
+        const priced = estimateProvider(slot, provider, observations, coverage, reasons);
+        if (!priced.complete || priced.components.length === 0) {
+            complete = false;
+            if (priced.components.length === 0 && !reasons.some((reason) => reason.slot === slot && reason.provider === provider && reason.code === "pricing-charge-not-found")) {
+                reasons.push(costReason(slot, provider, "pricing-charge-not-found"));
+            }
+            ledger.push(unavailableLedger(slot, provider));
+            continue;
+        }
+        estimated.push(priced.amount);
+        ledger.push(Object.freeze({
+            slot,
+            provider,
+            branch: "estimated",
+            components: priced.components,
+            estimated: projectedMoneyFromDecimal(input.profile, (0, cost_decimal_ts_1.parseCanonicalDecimal)(priced.amount)),
+        }));
+    }
+    if (byProvider.size === 0) {
+        complete = false;
+        reasons.push(costReason(slot, null, "usage-unavailable"));
+        ledger.push(unavailableLedger(slot, null));
+    }
+    return Object.freeze({
+        slot,
+        complete,
+        observed: Object.freeze([...observed].sort(compareObserved)),
+        estimated: Object.freeze([...estimated]),
+        reasons: freezeReasons(reasons),
+        ledger: Object.freeze([...ledger].sort(compareLedger)),
+        refs: freezeRefs(input.refs),
+    });
+}
+/** @internal Exactly reduces closed raw Slot data for one requested cost Measure. */
+function aggregateCostProjection(profile, slots, mode) {
+    // A provider-cost coordinate is only a known USD subtotal when every
+    // observed component in that locked coordinate is USD.  Keeping a USD
+    // fragment beside an unconvertible currency would fabricate a partial
+    // provider invoice rather than close the observed branch faithfully.
+    const observedQuote = slots.flatMap((slot) => slot.ledger.flatMap((entry) => entry.branch !== "observed" || entry.components.some((component) => component.currency !== profile.currency)
+        ? []
+        : entry.components.map((component) => component.amount)));
+    const estimatedQuote = slots.flatMap((slot) => slot.estimated);
+    const contributingSlots = slots.filter((slot) => slotHasQuoteAmount(slot, profile.currency));
+    const observedTotal = exactSum(observedQuote);
+    const estimatedTotal = exactSum(estimatedQuote);
+    const combinedTotal = exactSum([...observedQuote, ...estimatedQuote]);
+    const observed = observedTotal === undefined
+        ? null
+        : projectedMoneyFromDecimal(profile, observedTotal, mode, contributingSlots.length);
+    const estimated = estimatedTotal === undefined
+        ? null
+        : projectedMoneyFromDecimal(profile, estimatedTotal, mode, contributingSlots.length);
+    const combined = combinedTotal === undefined
+        ? null
+        : projectedMoneyFromDecimal(profile, combinedTotal, mode, contributingSlots.length);
+    const basis = costBasis(observed, estimated);
+    const complete = slots.length > 0 && slots.every((slot) => slot.complete && slotHasQuoteAmount(slot, profile.currency));
+    const common = Object.freeze({
+        profile: (0, cost_ts_1.closeCostProjectionProfile)(profile),
+        aggregate: combinedTotal === undefined
+            ? mode === "mean"
+                ? Object.freeze({ kind: "mean", numerator: "0", denominator: 0 })
+                : Object.freeze({ kind: "total", total: "0" })
+            : mode === "mean"
+                ? Object.freeze({
+                    kind: "mean",
+                    numerator: (0, cost_decimal_ts_1.normalizeCanonicalDecimal)(combinedTotal),
+                    denominator: contributingSlots.length,
+                })
+                : Object.freeze({ kind: "total", total: (0, cost_decimal_ts_1.normalizeCanonicalDecimal)(combinedTotal) }),
+        observedOtherCurrencies: Object.freeze(slots.flatMap((slot) => slot.observed)
+            .filter((entry) => entry.currency !== profile.currency)
+            .sort(compareObserved)),
+        reasons: freezeReasons(slots.flatMap((slot) => slot.reasons)),
+        ledger: Object.freeze(slots.flatMap((slot) => slot.ledger).sort(compareLedger)),
+    });
+    const projection = combined === null
+        ? Object.freeze({
+            state: "unavailable",
+            basis: "unavailable",
+            observed: null,
+            estimated: null,
+            combined: null,
+            ...common,
+        })
+        : Object.freeze({
+            state: complete ? "available" : "partial",
+            basis,
+            observed,
+            estimated,
+            combined,
+            ...common,
+        });
+    const numeric = combined === null ? null : Number(combined.amount);
+    return Object.freeze({
+        projection,
+        samples: contributingSlots.length,
+        total: slots.length,
+        refs: freezeRefs(slots.flatMap((slot) => slot.refs)),
+        value: numeric !== null && Number.isFinite(numeric) ? numeric : null,
+    });
+}
+function matchingCoverage(profile, provider, core) {
+    const matches = profile.coverage.filter((coverage) => (0, cost_ts_1.pricingCoverageMatches)(coverage, {
+        provider,
+        origin: core.origin,
+    }));
+    if (matches.length > 1) {
+        throw new Error("PricingProfile validation allowed multiple matching coverage entries");
+    }
+    if (matches[0] !== undefined)
+        return matches[0];
+    const model = core.origin.execution.model;
+    return profile.contentIdentity === cost_ts_1.builtInPricingProfile.contentIdentity && model !== null
+        ? (0, cost_ts_1.builtInPricingCoverage)(model)
+        : undefined;
+}
+function estimateProvider(slot, provider, observations, coverage, reasons) {
+    const charges = new Map();
+    for (const charge of coverage.charges) {
+        charges.set(charge.kind === "token" ? `token:${charge.bucket}` : `request:${charge.requestKind}`, charge);
+    }
+    const amounts = [];
+    const components = [];
+    let complete = true;
+    const hasReasoning = observations.some((observation) => observation.kind === "token-bucket" && observation.bucket === "reasoning");
+    const hasOutput = observations.some((observation) => observation.kind === "token-bucket" && observation.bucket === "output");
+    // Reasoning is a detail inside the provider's output total, not an
+    // independently billable bucket. If only that detail was recorded, the
+    // output subtotal is unknown; silently dropping it would understate cost.
+    if (hasReasoning && !hasOutput) {
+        complete = false;
+        reasons.push(costReason(slot, provider, "pricing-charge-not-found"));
+    }
+    for (const observation of observations) {
+        if (observation.kind === "provider-cost")
+            continue;
+        if (observation.kind === "token-bucket") {
+            // reasoning is an output subset and cannot be independently priced.
+            if (observation.bucket === "reasoning")
+                continue;
+            // `other` has no v1 independent-price coordinate and is not covered by
+            // any of the billable token buckets. It therefore makes this provider
+            // closure incomplete even when input/output were priced successfully.
+            if (observation.bucket === "other") {
+                complete = false;
+                reasons.push(costReason(slot, provider, "pricing-charge-not-found"));
+                continue;
+            }
+            const charge = charges.get(`token:${observation.bucket}`);
+            if (charge === undefined || charge.kind !== "token") {
+                complete = false;
+                reasons.push(costReason(slot, provider, "pricing-charge-not-found"));
+            }
+            else {
+                const tokens = requiredNonNegativeSafeInteger(observation.tokens, "Usage token count");
+                const amount = (0, cost_decimal_ts_1.costForPerMillionTokens)(charge.perMillionTokens, tokens);
+                amounts.push(amount);
+                components.push(Object.freeze({
+                    kind: "token",
+                    provider,
+                    bucket: charge.bucket,
+                    tokens,
+                    ratePerMillionTokens: charge.perMillionTokens,
+                    amount,
+                }));
+            }
+            continue;
+        }
+        if (observation.kind === "request") {
+            const charge = charges.get(`request:${observation.requestKind}`);
+            if (charge === undefined || charge.kind !== "request") {
+                complete = false;
+                reasons.push(costReason(slot, provider, "pricing-charge-not-found"));
+            }
+            else {
+                const amount = (0, cost_decimal_ts_1.multiplyCanonicalDecimalByInteger)(charge.ratePerRequest, 1);
+                amounts.push(amount);
+                components.push(Object.freeze({
+                    kind: "request",
+                    provider,
+                    requestKind: charge.requestKind,
+                    ratePerRequest: charge.ratePerRequest,
+                    amount,
+                }));
+            }
+        }
+    }
+    return Object.freeze({
+        amount: exactCanonicalSum(amounts),
+        complete,
+        components: Object.freeze([...components].sort(compareComponent)),
+    });
+}
+function exactSum(values) {
+    return values.length === 0 ? undefined : (0, cost_decimal_ts_1.addDecimalCoefficients)(values.map(cost_decimal_ts_1.parseCanonicalDecimal));
+}
+function exactCanonicalSum(values) {
+    return (0, cost_decimal_ts_1.normalizeCanonicalDecimal)((0, cost_decimal_ts_1.addDecimalCoefficients)(values.map(cost_decimal_ts_1.parseCanonicalDecimal)));
+}
+function projectedMoneyFromDecimal(profile, value, mode, contributingSlots) {
+    if (mode === "mean" && (contributingSlots === undefined || contributingSlots <= 0)) {
+        throw new Error("Cost mean cannot round without a quote-currency denominator");
+    }
+    const rational = mode === "mean"
+        ? (0, cost_decimal_ts_1.divideDecimalCoefficient)(value, contributingSlots)
+        : (0, cost_decimal_ts_1.rationalFromDecimal)(value);
+    return Object.freeze({
+        amount: (0, cost_decimal_ts_1.roundDecimalRationalHalfAway)(rational, profile.display.decimalPlaces),
+        currency: profile.currency,
+        decimalPlaces: profile.display.decimalPlaces,
+    });
+}
+function slotHasQuoteAmount(slot, currency) {
+    return slot.ledger.some((entry) => entry.branch === "estimated" ||
+        (entry.branch === "observed" && entry.components.every((component) => component.currency === currency)));
+}
+function costBasis(observed, estimated) {
+    if (observed !== null && estimated !== null)
+        return "mixed";
+    return observed !== null ? "observed" : "estimated";
+}
+function closeSlot(member) {
+    return Object.freeze({
+        runId: member.runId,
+        slotId: member.slotId,
+        experimentId: member.experimentId,
+        evalId: member.evalId,
+        attemptOrdinal: member.attemptOrdinal,
+        executionIdentityDigest: member.executionIdentityDigest,
+    });
+}
+function costReason(slot, provider, code) {
+    return Object.freeze({ slot, provider, code });
+}
+function unavailableLedger(slot, provider) {
+    return Object.freeze({
+        slot,
+        provider,
+        branch: "unavailable",
+        components: Object.freeze([]),
+        estimated: null,
+    });
+}
+function freezeReasons(values) {
+    const byIdentity = new Map();
+    for (const value of values) {
+        const key = `${slotIdentity(value.slot)}\u0000${value.provider ?? ""}\u0000${value.code}`;
+        if (!byIdentity.has(key))
+            byIdentity.set(key, value);
+    }
+    return Object.freeze([...byIdentity.entries()].sort(([left], [right]) => compareUtf8(left, right)).map(([, value]) => value));
+}
+function freezeRefs(values) {
+    const byIdentity = new Map();
+    for (const value of values) {
+        const key = `${value.identity.kind}\u0000${value.identity.locator}`;
+        if (!byIdentity.has(key)) {
+            byIdentity.set(key, Object.freeze({ identity: Object.freeze({ ...value.identity }) }));
+        }
+    }
+    return Object.freeze([...byIdentity.entries()].sort(([left], [right]) => compareUtf8(left, right)).map(([, value]) => value));
+}
+function compareProviderEntry([left], [right]) {
+    return compareUtf8(left, right);
+}
+function compareObserved(left, right) {
+    const leftKey = `${left.provider}\u0000${left.currency}\u0000${left.amount}`;
+    const rightKey = `${right.provider}\u0000${right.currency}\u0000${right.amount}`;
+    return compareUtf8(leftKey, rightKey);
+}
+function compareLedger(left, right) {
+    const leftKey = `${slotIdentity(left.slot)}\u0000${left.provider ?? ""}\u0000${left.branch}`;
+    const rightKey = `${slotIdentity(right.slot)}\u0000${right.provider ?? ""}\u0000${right.branch}`;
+    return compareUtf8(leftKey, rightKey);
+}
+function slotIdentity(slot) {
+    return `${slot.runId}\u0000${slot.slotId}`;
+}
+function compareComponent(left, right) {
+    const leftKey = componentKey(left);
+    const rightKey = componentKey(right);
+    return compareUtf8(leftKey, rightKey);
+}
+function componentKey(value) {
+    switch (value.kind) {
+        case "provider-cost":
+            return `provider-cost\u0000${value.provider}\u0000${value.currency}\u0000${value.amount}`;
+        case "token":
+            return `token\u0000${value.provider}\u0000${value.bucket}\u0000${value.tokens}\u0000${value.amount}`;
+        case "request":
+            return `request\u0000${value.provider}\u0000${value.requestKind}\u0000${value.amount}`;
+    }
+}
+function compareUtf8(left, right) {
+    if (left === right)
+        return 0;
+    const first = new TextEncoder().encode(left);
+    const second = new TextEncoder().encode(right);
+    const length = Math.min(first.length, second.length);
+    for (let index = 0; index < length; index += 1) {
+        const difference = first[index] - second[index];
+        if (difference !== 0)
+            return difference;
+    }
+    return first.length - second.length;
+}
+function requiredSafeIdentifier(value, name) {
+    const identifier = (0, model_ts_1.makeSafeIdentifier)(value);
+    if (identifier === undefined)
+        throw new Error(`${name} is not a SafeIdentifier`);
+    return identifier;
+}
+function requiredCurrencyCode(value, name) {
+    const currency = (0, model_ts_1.makeCurrencyCode)(value);
+    if (currency === undefined)
+        throw new Error(`${name} is not a CurrencyCode`);
+    return currency;
+}
+function requiredCanonicalDecimal(value, name) {
+    const decimal = (0, model_ts_1.makeCanonicalDecimal)(value);
+    if (decimal === undefined)
+        throw new Error(`${name} is not a canonical decimal`);
+    return decimal;
+}
+function requiredNonNegativeSafeInteger(value, name) {
+    const integer = (0, model_ts_1.makeNonNegativeSafeInteger)(value);
+    if (integer === undefined)
+        throw new Error(`${name} is not a non-negative safe integer`);
+    return integer;
+}
+//# sourceMappingURL=cost-projection.cjs.map

package/dist/analysis/cost-projection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-projection.js","sourceRoot":"","sources":["cost-projection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AttemptObservabilityAttachment } from \"../record/family/observability.ts\";\nimport type { RecordAttachmentPayloadSnapshot } from \"../record/attachment/types.ts\";\nimport type { CanonicalDecimal, CurrencyCode, NonNegativeSafeInteger, SafeIdentifier, } from \"../o11y/record/model.ts\";\nimport { makeCanonicalDecimal, makeCurrencyCode, makeNonNegativeSafeInteger, makeSafeIdentifier, } from \"../o11y/record/model.ts\";\nimport type { ClosedAttemptCore } from \"./domain-view.ts\";\nimport type { LogicalSlot } from \"./definitions.ts\";\nimport type { AnalysisSlotRef, EvidenceRef } from \"./contracts.ts\";\nimport { addDecimalCoefficients, costForPerMillionTokens, divideDecimalCoefficient, multiplyCanonicalDecimalByInteger, normalizeCanonicalDecimal, parseCanonicalDecimal, rationalFromDecimal, roundDecimalRationalHalfAway, type DecimalCoefficient, } from \"./cost-decimal.ts\";\nimport { builtInPricingCoverage, builtInPricingProfile, closeCostProjectionProfile, pricingCoverageMatches, type CostBasis, type CostCoverageReason, type CostLedgerEntry, type CostProjectionValue, type CostComponent, type EstimatedRequestCostComponent, type EstimatedTokenCostComponent, type ObservedCostComponent, type ObservedOtherCurrency, type PricingCharge, type PricingCoverage, type PricingProfile, type ProjectedMoney, } from \"./cost.ts\";\n/** @internal One raw, Sample-local Slot closure before group aggregation. */\nexport interface CostSlotProjection {\n    readonly slot: AnalysisSlotRef;\n    readonly complete: boolean;\n    readonly observed: readonly ObservedOtherCurrency[];\n    readonly estimated: readonly CanonicalDecimal[];\n    readonly reasons: readonly CostCoverageReason[];\n    readonly ledger: readonly CostLedgerEntry[];\n    readonly refs: readonly EvidenceRef[];\n}\ntype UsageSnapshot = RecordAttachmentPayloadSnapshot<AttemptObservabilityAttachment>[\"usage\"];\n/** @internal Builds a missing denominator Slot without inventing a provider. */\nexport function unavailableCostSlot(member: LogicalSlot, code: Extract<CostCoverageReason[\"code\"], \"member-not-recorded\" | \"core-invalid\" | \"origin-run-unavailable\" | \"usage-not-recorded\" | \"usage-unavailable\" | \"usage-unsupported\" | \"usage-invalid\">, refs: readonly EvidenceRef[] = []): CostSlotProjection {\n    const slot = closeSlot(member);\n    const reason = costReason(slot, null, code);\n    return Object.freeze({\n        slot,\n        complete: false,\n        observed: Object.freeze([]),\n        estimated: Object.freeze([]),\n        reasons: Object.freeze([reason]),\n        ledger: Object.freeze([\n            Object.freeze({\n                slot,\n                provider: null,\n                branch: \"unavailable\" as const,\n                components: Object.freeze([]) as readonly [\n                ],\n                estimated: null,\n            }),\n        ]),\n        refs: freezeRefs(refs),\n    });\n}\n/** @internal Closes one available Usage family with origin-only profile matching. */\nexport function projectCostUsage(input: {\n    readonly member: LogicalSlot;\n    readonly core: ClosedAttemptCore;\n    readonly usage: UsageSnapshot;\n    readonly profile: PricingProfile;\n    readonly refs: readonly EvidenceRef[];\n}): CostSlotProjection {\n    const slot = closeSlot(input.member);\n    type UsageObservation = UsageSnapshot[\"observations\"][number];\n    const byProvider = new Map<SafeIdentifier, UsageObservation[]>();\n    for (const observation of input.usage.observations) {\n        const provider = requiredSafeIdentifier(observation.provider, \"Usage provider\");\n        const entries = byProvider.get(provider);\n        if (entries === undefined)\n            byProvider.set(provider, [observation]);\n        else\n            entries.push(observation);\n    }\n    const observed: ObservedOtherCurrency[] = [];\n    const estimated: CanonicalDecimal[] = [];\n    const reasons: CostCoverageReason[] = [];\n    const ledger: CostLedgerEntry[] = [];\n    let complete = input.usage.collection.state === \"complete\";\n    if (!complete)\n        reasons.push(costReason(slot, null, \"usage-collection-partial\"));\n    for (const [provider, observations] of [...byProvider.entries()].sort(compareProviderEntry)) {\n        const providerCosts = observations.filter((observation) => observation.kind === \"provider-cost\");\n        if (providerCosts.length > 0) {\n            const components = Object.freeze(providerCosts\n                .map((observation) => Object.freeze({\n                kind: \"provider-cost\" as const,\n                provider,\n                currency: requiredCurrencyCode(observation.currency, \"Usage provider-cost currency\"),\n                amount: requiredCanonicalDecimal(observation.amount, \"Usage provider-cost amount\"),\n            }))\n                .sort(compareComponent)) as readonly [\n                ObservedCostComponent,\n                ...ObservedCostComponent[]\n            ];\n            observed.push(...components.map((component) => Object.freeze({\n                provider: component.provider,\n                currency: component.currency,\n                amount: component.amount,\n            })));\n            if (components.some((entry) => entry.currency !== input.profile.currency)) {\n                complete = false;\n                reasons.push(costReason(slot, provider, \"observed-cost-other-currency\"));\n            }\n            ledger.push(Object.freeze({\n                slot,\n                provider,\n                branch: \"observed\" as const,\n                components,\n                estimated: null,\n            }));\n            continue;\n        }\n        if (input.core.origin.execution.model === null) {\n            complete = false;\n            reasons.push(costReason(slot, provider, \"execution-model-not-recorded\"));\n            ledger.push(unavailableLedger(slot, provider));\n            continue;\n        }\n        const coverage = matchingCoverage(input.profile, provider, input.core);\n        if (coverage === undefined) {\n            complete = false;\n            reasons.push(costReason(slot, provider, \"pricing-coverage-not-found\"));\n            ledger.push(unavailableLedger(slot, provider));\n            continue;\n        }\n        if (coverage.state === \"unpriced\") {\n            complete = false;\n            reasons.push(costReason(slot, provider, \"pricing-coverage-unpriced\"));\n            ledger.push(unavailableLedger(slot, provider));\n            continue;\n        }\n        const priced = estimateProvider(slot, provider, observations, coverage, reasons);\n        if (!priced.complete || priced.components.length === 0) {\n            complete = false;\n            if (priced.components.length === 0 && !reasons.some((reason) => reason.slot === slot && reason.provider === provider && reason.code === \"pricing-charge-not-found\")) {\n                reasons.push(costReason(slot, provider, \"pricing-charge-not-found\"));\n            }\n            ledger.push(unavailableLedger(slot, provider));\n            continue;\n        }\n        estimated.push(priced.amount);\n        ledger.push(Object.freeze({\n            slot,\n            provider,\n            branch: \"estimated\" as const,\n            components: priced.components,\n            estimated: projectedMoneyFromDecimal(input.profile, parseCanonicalDecimal(priced.amount)),\n        }));\n    }\n    if (byProvider.size === 0) {\n        complete = false;\n        reasons.push(costReason(slot, null, \"usage-unavailable\"));\n        ledger.push(unavailableLedger(slot, null));\n    }\n    return Object.freeze({\n        slot,\n        complete,\n        observed: Object.freeze([...observed].sort(compareObserved)),\n        estimated: Object.freeze([...estimated]),\n        reasons: freezeReasons(reasons),\n        ledger: Object.freeze([...ledger].sort(compareLedger)),\n        refs: freezeRefs(input.refs),\n    });\n}\n/** @internal Exactly reduces closed raw Slot data for one requested cost Measure. */\nexport function aggregateCostProjection(profile: PricingProfile, slots: readonly CostSlotProjection[], mode: \"mean\" | \"total\"): {\n    readonly projection: CostProjectionValue;\n    readonly samples: number;\n    readonly total: number;\n    readonly refs: readonly EvidenceRef[];\n    readonly value: number | null;\n} {\n    // A provider-cost coordinate is only a known USD subtotal when every\n    // observed component in that locked coordinate is USD.  Keeping a USD\n    // fragment beside an unconvertible currency would fabricate a partial\n    // provider invoice rather than close the observed branch faithfully.\n    const observedQuote = slots.flatMap((slot) => slot.ledger.flatMap((entry) => entry.branch !== \"observed\" || entry.components.some((component) => component.currency !== profile.currency)\n        ? []\n        : entry.components.map((component) => component.amount)));\n    const estimatedQuote = slots.flatMap((slot) => slot.estimated);\n    const contributingSlots = slots.filter((slot) => slotHasQuoteAmount(slot, profile.currency));\n    const observedTotal = exactSum(observedQuote);\n    const estimatedTotal = exactSum(estimatedQuote);\n    const combinedTotal = exactSum([...observedQuote, ...estimatedQuote]);\n    const observed = observedTotal === undefined\n        ? null\n        : projectedMoneyFromDecimal(profile, observedTotal, mode, contributingSlots.length);\n    const estimated = estimatedTotal === undefined\n        ? null\n        : projectedMoneyFromDecimal(profile, estimatedTotal, mode, contributingSlots.length);\n    const combined = combinedTotal === undefined\n        ? null\n        : projectedMoneyFromDecimal(profile, combinedTotal, mode, contributingSlots.length);\n    const basis = costBasis(observed, estimated);\n    const complete = slots.length > 0 && slots.every((slot) => slot.complete && slotHasQuoteAmount(slot, profile.currency));\n    const common = Object.freeze({\n        profile: closeCostProjectionProfile(profile),\n        aggregate: combinedTotal === undefined\n            ? mode === \"mean\"\n                ? Object.freeze({ kind: \"mean\" as const, numerator: \"0\" as CanonicalDecimal, denominator: 0 })\n                : Object.freeze({ kind: \"total\" as const, total: \"0\" as CanonicalDecimal })\n            : mode === \"mean\"\n                ? Object.freeze({\n                    kind: \"mean\" as const,\n                    numerator: normalizeCanonicalDecimal(combinedTotal),\n                    denominator: contributingSlots.length,\n                })\n                : Object.freeze({ kind: \"total\" as const, total: normalizeCanonicalDecimal(combinedTotal) }),\n        observedOtherCurrencies: Object.freeze(slots.flatMap((slot) => slot.observed)\n            .filter((entry) => entry.currency !== profile.currency)\n            .sort(compareObserved)),\n        reasons: freezeReasons(slots.flatMap((slot) => slot.reasons)),\n        ledger: Object.freeze(slots.flatMap((slot) => slot.ledger).sort(compareLedger)),\n    });\n    const projection: CostProjectionValue = combined === null\n        ? Object.freeze({\n            state: \"unavailable\" as const,\n            basis: \"unavailable\" as const,\n            observed: null,\n            estimated: null,\n            combined: null,\n            ...common,\n        })\n        : Object.freeze({\n            state: complete ? \"available\" as const : \"partial\" as const,\n            basis,\n            observed,\n            estimated,\n            combined,\n            ...common,\n        });\n    const numeric = combined === null ? null : Number(combined.amount);\n    return Object.freeze({\n        projection,\n        samples: contributingSlots.length,\n        total: slots.length,\n        refs: freezeRefs(slots.flatMap((slot) => slot.refs)),\n        value: numeric !== null && Number.isFinite(numeric) ? numeric : null,\n    });\n}\nfunction matchingCoverage(profile: PricingProfile, provider: SafeIdentifier, core: ClosedAttemptCore): PricingCoverage | undefined {\n    const matches = profile.coverage.filter((coverage) => pricingCoverageMatches(coverage, {\n        provider,\n        origin: core.origin,\n    }));\n    if (matches.length > 1) {\n        throw new Error(\"PricingProfile validation allowed multiple matching coverage entries\");\n    }\n    if (matches[0] !== undefined)\n        return matches[0];\n    const model = core.origin.execution.model;\n    return profile.contentIdentity === builtInPricingProfile.contentIdentity && model !== null\n        ? builtInPricingCoverage(model)\n        : undefined;\n}\nfunction estimateProvider(slot: AnalysisSlotRef, provider: SafeIdentifier, observations: UsageSnapshot[\"observations\"], coverage: Extract<PricingCoverage, {\n    readonly state: \"priced\";\n}>, reasons: CostCoverageReason[]): {\n    readonly amount: CanonicalDecimal;\n    readonly complete: boolean;\n    readonly components: readonly (EstimatedTokenCostComponent | EstimatedRequestCostComponent)[];\n} {\n    const charges = new Map<string, PricingCharge>();\n    for (const charge of coverage.charges) {\n        charges.set(charge.kind === \"token\" ? `token:${charge.bucket}` : `request:${charge.requestKind}`, charge);\n    }\n    const amounts: CanonicalDecimal[] = [];\n    const components: (EstimatedTokenCostComponent | EstimatedRequestCostComponent)[] = [];\n    let complete = true;\n    const hasReasoning = observations.some((observation) => observation.kind === \"token-bucket\" && observation.bucket === \"reasoning\");\n    const hasOutput = observations.some((observation) => observation.kind === \"token-bucket\" && observation.bucket === \"output\");\n    // Reasoning is a detail inside the provider's output total, not an\n    // independently billable bucket. If only that detail was recorded, the\n    // output subtotal is unknown; silently dropping it would understate cost.\n    if (hasReasoning && !hasOutput) {\n        complete = false;\n        reasons.push(costReason(slot, provider, \"pricing-charge-not-found\"));\n    }\n    for (const observation of observations) {\n        if (observation.kind === \"provider-cost\")\n            continue;\n        if (observation.kind === \"token-bucket\") {\n            // reasoning is an output subset and cannot be independently priced.\n            if (observation.bucket === \"reasoning\")\n                continue;\n            // `other` has no v1 independent-price coordinate and is not covered by\n            // any of the billable token buckets. It therefore makes this provider\n            // closure incomplete even when input/output were priced successfully.\n            if (observation.bucket === \"other\") {\n                complete = false;\n                reasons.push(costReason(slot, provider, \"pricing-charge-not-found\"));\n                continue;\n            }\n            const charge = charges.get(`token:${observation.bucket}`);\n            if (charge === undefined || charge.kind !== \"token\") {\n                complete = false;\n                reasons.push(costReason(slot, provider, \"pricing-charge-not-found\"));\n            }\n            else {\n                const tokens = requiredNonNegativeSafeInteger(observation.tokens, \"Usage token count\");\n                const amount = costForPerMillionTokens(charge.perMillionTokens, tokens);\n                amounts.push(amount);\n                components.push(Object.freeze({\n                    kind: \"token\" as const,\n                    provider,\n                    bucket: charge.bucket,\n                    tokens,\n                    ratePerMillionTokens: charge.perMillionTokens,\n                    amount,\n                }));\n            }\n            continue;\n        }\n        if (observation.kind === \"request\") {\n            const charge = charges.get(`request:${observation.requestKind}`);\n            if (charge === undefined || charge.kind !== \"request\") {\n                complete = false;\n                reasons.push(costReason(slot, provider, \"pricing-charge-not-found\"));\n            }\n            else {\n                const amount = multiplyCanonicalDecimalByInteger(charge.ratePerRequest, 1 as NonNegativeSafeInteger);\n                amounts.push(amount);\n                components.push(Object.freeze({\n                    kind: \"request\" as const,\n                    provider,\n                    requestKind: charge.requestKind,\n                    ratePerRequest: charge.ratePerRequest,\n                    amount,\n                }));\n            }\n        }\n    }\n    return Object.freeze({\n        amount: exactCanonicalSum(amounts),\n        complete,\n        components: Object.freeze([...components].sort(compareComponent)),\n    });\n}\nfunction exactSum(values: readonly CanonicalDecimal[]): DecimalCoefficient | undefined {\n    return values.length === 0 ? undefined : addDecimalCoefficients(values.map(parseCanonicalDecimal));\n}\nfunction exactCanonicalSum(values: readonly CanonicalDecimal[]): CanonicalDecimal {\n    return normalizeCanonicalDecimal(addDecimalCoefficients(values.map(parseCanonicalDecimal)));\n}\nfunction projectedMoneyFromDecimal(profile: PricingProfile, value: DecimalCoefficient, mode?: \"mean\" | \"total\", contributingSlots?: number): ProjectedMoney {\n    if (mode === \"mean\" && (contributingSlots === undefined || contributingSlots <= 0)) {\n        throw new Error(\"Cost mean cannot round without a quote-currency denominator\");\n    }\n    const rational = mode === \"mean\"\n        ? divideDecimalCoefficient(value, contributingSlots!)\n        : rationalFromDecimal(value);\n    return Object.freeze({\n        amount: roundDecimalRationalHalfAway(rational, profile.display.decimalPlaces),\n        currency: profile.currency as CurrencyCode,\n        decimalPlaces: profile.display.decimalPlaces,\n    });\n}\nfunction slotHasQuoteAmount(slot: CostSlotProjection, currency: string): boolean {\n    return slot.ledger.some((entry) => entry.branch === \"estimated\" ||\n        (entry.branch === \"observed\" && entry.components.every((component) => component.currency === currency)));\n}\nfunction costBasis(observed: ProjectedMoney | null, estimated: ProjectedMoney | null): Exclude<CostBasis, \"unavailable\"> {\n    if (observed !== null && estimated !== null)\n        return \"mixed\";\n    return observed !== null ? \"observed\" : \"estimated\";\n}\nfunction closeSlot(member: LogicalSlot): AnalysisSlotRef {\n    return Object.freeze({\n        runId: member.runId,\n        slotId: member.slotId,\n        experimentId: member.experimentId,\n        evalId: member.evalId,\n        attemptOrdinal: member.attemptOrdinal,\n        executionIdentityDigest: member.executionIdentityDigest,\n    });\n}\nfunction costReason(slot: AnalysisSlotRef, provider: SafeIdentifier | null, code: CostCoverageReason[\"code\"]): CostCoverageReason {\n    return Object.freeze({ slot, provider, code });\n}\nfunction unavailableLedger(slot: AnalysisSlotRef, provider: SafeIdentifier | null): CostLedgerEntry {\n    return Object.freeze({\n        slot,\n        provider,\n        branch: \"unavailable\" as const,\n        components: Object.freeze([]) as readonly [\n        ],\n        estimated: null,\n    });\n}\nfunction freezeReasons(values: readonly CostCoverageReason[]): readonly CostCoverageReason[] {\n    const byIdentity = new Map<string, CostCoverageReason>();\n    for (const value of values) {\n        const key = `${slotIdentity(value.slot)}\\u0000${value.provider ?? \"\"}\\u0000${value.code}`;\n        if (!byIdentity.has(key))\n            byIdentity.set(key, value);\n    }\n    return Object.freeze([...byIdentity.entries()].sort(([left], [right]) => compareUtf8(left, right)).map(([, value]) => value));\n}\nfunction freezeRefs(values: readonly EvidenceRef[]): readonly EvidenceRef[] {\n    const byIdentity = new Map<string, EvidenceRef>();\n    for (const value of values) {\n        const key = `${value.identity.kind}\\u0000${value.identity.locator}`;\n        if (!byIdentity.has(key)) {\n            byIdentity.set(key, Object.freeze({ identity: Object.freeze({ ...value.identity }) }));\n        }\n    }\n    return Object.freeze([...byIdentity.entries()].sort(([left], [right]) => compareUtf8(left, right)).map(([, value]) => value));\n}\nfunction compareProviderEntry([left]: readonly [\n    SafeIdentifier,\n    UsageSnapshot[\"observations\"][number][]\n], [right]: readonly [\n    SafeIdentifier,\n    UsageSnapshot[\"observations\"][number][]\n]): number {\n    return compareUtf8(left, right);\n}\nfunction compareObserved(left: ObservedOtherCurrency, right: ObservedOtherCurrency): number {\n    const leftKey = `${left.provider}\\u0000${left.currency}\\u0000${left.amount}`;\n    const rightKey = `${right.provider}\\u0000${right.currency}\\u0000${right.amount}`;\n    return compareUtf8(leftKey, rightKey);\n}\nfunction compareLedger(left: CostLedgerEntry, right: CostLedgerEntry): number {\n    const leftKey = `${slotIdentity(left.slot)}\\u0000${left.provider ?? \"\"}\\u0000${left.branch}`;\n    const rightKey = `${slotIdentity(right.slot)}\\u0000${right.provider ?? \"\"}\\u0000${right.branch}`;\n    return compareUtf8(leftKey, rightKey);\n}\nfunction slotIdentity(slot: AnalysisSlotRef): string {\n    return `${slot.runId}\\u0000${slot.slotId}`;\n}\nfunction compareComponent(left: CostComponent, right: CostComponent): number {\n    const leftKey = componentKey(left);\n    const rightKey = componentKey(right);\n    return compareUtf8(leftKey, rightKey);\n}\nfunction componentKey(value: CostComponent): string {\n    switch (value.kind) {\n        case \"provider-cost\":\n            return `provider-cost\\u0000${value.provider}\\u0000${value.currency}\\u0000${value.amount}`;\n        case \"token\":\n            return `token\\u0000${value.provider}\\u0000${value.bucket}\\u0000${value.tokens}\\u0000${value.amount}`;\n        case \"request\":\n            return `request\\u0000${value.provider}\\u0000${value.requestKind}\\u0000${value.amount}`;\n    }\n}\nfunction compareUtf8(left: string, right: string): number {\n    if (left === right)\n        return 0;\n    const first = new TextEncoder().encode(left);\n    const second = new TextEncoder().encode(right);\n    const length = Math.min(first.length, second.length);\n    for (let index = 0; index < length; index += 1) {\n        const difference = first[index]! - second[index]!;\n        if (difference !== 0)\n            return difference;\n    }\n    return first.length - second.length;\n}\nfunction requiredSafeIdentifier(value: string, name: string): SafeIdentifier {\n    const identifier = makeSafeIdentifier(value);\n    if (identifier === undefined)\n        throw new Error(`${name} is not a SafeIdentifier`);\n    return identifier;\n}\nfunction requiredCurrencyCode(value: string, name: string): CurrencyCode {\n    const currency = makeCurrencyCode(value);\n    if (currency === undefined)\n        throw new Error(`${name} is not a CurrencyCode`);\n    return currency;\n}\nfunction requiredCanonicalDecimal(value: string, name: string): CanonicalDecimal {\n    const decimal = makeCanonicalDecimal(value);\n    if (decimal === undefined)\n        throw new Error(`${name} is not a canonical decimal`);\n    return decimal;\n}\nfunction requiredNonNegativeSafeInteger(value: number, name: string): NonNegativeSafeInteger {\n    const integer = makeNonNegativeSafeInteger(value);\n    if (integer === undefined)\n        throw new Error(`${name} is not a non-negative safe integer`);\n    return integer;\n}\n"]}

package/dist/analysis/cost-projection.d.cts

@@ -0,0 +1,37 @@
+import type { AttemptObservabilityAttachment } from "../record/family/observability.cjs";
+import type { RecordAttachmentPayloadSnapshot } from "../record/attachment/types.cjs";
+import type { CanonicalDecimal } from "../o11y/record/model.cjs";
+import type { ClosedAttemptCore } from "./domain-view.cjs";
+import type { LogicalSlot } from "./definitions.cjs";
+import type { AnalysisSlotRef, EvidenceRef } from "./contracts.cjs";
+import { type CostCoverageReason, type CostLedgerEntry, type CostProjectionValue, type ObservedOtherCurrency, type PricingProfile } from "./cost.cjs";
+/** @internal One raw, Sample-local Slot closure before group aggregation. */
+export interface CostSlotProjection {
+    readonly slot: AnalysisSlotRef;
+    readonly complete: boolean;
+    readonly observed: readonly ObservedOtherCurrency[];
+    readonly estimated: readonly CanonicalDecimal[];
+    readonly reasons: readonly CostCoverageReason[];
+    readonly ledger: readonly CostLedgerEntry[];
+    readonly refs: readonly EvidenceRef[];
+}
+type UsageSnapshot = RecordAttachmentPayloadSnapshot<AttemptObservabilityAttachment>["usage"];
+/** @internal Builds a missing denominator Slot without inventing a provider. */
+export declare function unavailableCostSlot(member: LogicalSlot, code: Extract<CostCoverageReason["code"], "member-not-recorded" | "core-invalid" | "origin-run-unavailable" | "usage-not-recorded" | "usage-unavailable" | "usage-unsupported" | "usage-invalid">, refs?: readonly EvidenceRef[]): CostSlotProjection;
+/** @internal Closes one available Usage family with origin-only profile matching. */
+export declare function projectCostUsage(input: {
+    readonly member: LogicalSlot;
+    readonly core: ClosedAttemptCore;
+    readonly usage: UsageSnapshot;
+    readonly profile: PricingProfile;
+    readonly refs: readonly EvidenceRef[];
+}): CostSlotProjection;
+/** @internal Exactly reduces closed raw Slot data for one requested cost Measure. */
+export declare function aggregateCostProjection(profile: PricingProfile, slots: readonly CostSlotProjection[], mode: "mean" | "total"): {
+    readonly projection: CostProjectionValue;
+    readonly samples: number;
+    readonly total: number;
+    readonly refs: readonly EvidenceRef[];
+    readonly value: number | null;
+};
+export {};

package/dist/analysis/cost-projection.d.mts

@@ -0,0 +1,37 @@
+import type { AttemptObservabilityAttachment } from "../record/family/observability.mjs";
+import type { RecordAttachmentPayloadSnapshot } from "../record/attachment/types.mjs";
+import type { CanonicalDecimal } from "../o11y/record/model.mjs";
+import type { ClosedAttemptCore } from "./domain-view.mjs";
+import type { LogicalSlot } from "./definitions.mjs";
+import type { AnalysisSlotRef, EvidenceRef } from "./contracts.mjs";
+import { type CostCoverageReason, type CostLedgerEntry, type CostProjectionValue, type ObservedOtherCurrency, type PricingProfile } from "./cost.mjs";
+/** @internal One raw, Sample-local Slot closure before group aggregation. */
+export interface CostSlotProjection {
+    readonly slot: AnalysisSlotRef;
+    readonly complete: boolean;
+    readonly observed: readonly ObservedOtherCurrency[];
+    readonly estimated: readonly CanonicalDecimal[];
+    readonly reasons: readonly CostCoverageReason[];
+    readonly ledger: readonly CostLedgerEntry[];
+    readonly refs: readonly EvidenceRef[];
+}
+type UsageSnapshot = RecordAttachmentPayloadSnapshot<AttemptObservabilityAttachment>["usage"];
+/** @internal Builds a missing denominator Slot without inventing a provider. */
+export declare function unavailableCostSlot(member: LogicalSlot, code: Extract<CostCoverageReason["code"], "member-not-recorded" | "core-invalid" | "origin-run-unavailable" | "usage-not-recorded" | "usage-unavailable" | "usage-unsupported" | "usage-invalid">, refs?: readonly EvidenceRef[]): CostSlotProjection;
+/** @internal Closes one available Usage family with origin-only profile matching. */
+export declare function projectCostUsage(input: {
+    readonly member: LogicalSlot;
+    readonly core: ClosedAttemptCore;
+    readonly usage: UsageSnapshot;
+    readonly profile: PricingProfile;
+    readonly refs: readonly EvidenceRef[];
+}): CostSlotProjection;
+/** @internal Exactly reduces closed raw Slot data for one requested cost Measure. */
+export declare function aggregateCostProjection(profile: PricingProfile, slots: readonly CostSlotProjection[], mode: "mean" | "total"): {
+    readonly projection: CostProjectionValue;
+    readonly samples: number;
+    readonly total: number;
+    readonly refs: readonly EvidenceRef[];
+    readonly value: number | null;
+};
+export {};

package/dist/analysis/cost-projection.d.ts

@@ -0,0 +1,37 @@
+import type { AttemptObservabilityAttachment } from "../record/family/observability.js";
+import type { RecordAttachmentPayloadSnapshot } from "../record/attachment/types.js";
+import type { CanonicalDecimal } from "../o11y/record/model.js";
+import type { ClosedAttemptCore } from "./domain-view.js";
+import type { LogicalSlot } from "./definitions.js";
+import type { AnalysisSlotRef, EvidenceRef } from "./contracts.js";
+import { type CostCoverageReason, type CostLedgerEntry, type CostProjectionValue, type ObservedOtherCurrency, type PricingProfile } from "./cost.js";
+/** @internal One raw, Sample-local Slot closure before group aggregation. */
+export interface CostSlotProjection {
+    readonly slot: AnalysisSlotRef;
+    readonly complete: boolean;
+    readonly observed: readonly ObservedOtherCurrency[];
+    readonly estimated: readonly CanonicalDecimal[];
+    readonly reasons: readonly CostCoverageReason[];
+    readonly ledger: readonly CostLedgerEntry[];
+    readonly refs: readonly EvidenceRef[];
+}
+type UsageSnapshot = RecordAttachmentPayloadSnapshot<AttemptObservabilityAttachment>["usage"];
+/** @internal Builds a missing denominator Slot without inventing a provider. */
+export declare function unavailableCostSlot(member: LogicalSlot, code: Extract<CostCoverageReason["code"], "member-not-recorded" | "core-invalid" | "origin-run-unavailable" | "usage-not-recorded" | "usage-unavailable" | "usage-unsupported" | "usage-invalid">, refs?: readonly EvidenceRef[]): CostSlotProjection;
+/** @internal Closes one available Usage family with origin-only profile matching. */
+export declare function projectCostUsage(input: {
+    readonly member: LogicalSlot;
+    readonly core: ClosedAttemptCore;
+    readonly usage: UsageSnapshot;
+    readonly profile: PricingProfile;
+    readonly refs: readonly EvidenceRef[];
+}): CostSlotProjection;
+/** @internal Exactly reduces closed raw Slot data for one requested cost Measure. */
+export declare function aggregateCostProjection(profile: PricingProfile, slots: readonly CostSlotProjection[], mode: "mean" | "total"): {
+    readonly projection: CostProjectionValue;
+    readonly samples: number;
+    readonly total: number;
+    readonly refs: readonly EvidenceRef[];
+    readonly value: number | null;
+};
+export {};

package/dist/analysis/cost-projection.js

@@ -0,0 +1,10 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./cost-projection.cjs");
+const __niceevalExport0 = __niceevalCanonical["aggregateCostProjection"];
+export { __niceevalExport0 as aggregateCostProjection };
+const __niceevalExport1 = __niceevalCanonical["projectCostUsage"];
+export { __niceevalExport1 as projectCostUsage };
+const __niceevalExport2 = __niceevalCanonical["unavailableCostSlot"];
+export { __niceevalExport2 as unavailableCostSlot };
+//# sourceMappingURL=cost-projection.js.map

package/dist/analysis/cost-projection.js.map

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