niceeval 0.16.2 → 0.17.0

package/dist/load-config.cjs

@@ -6,22 +6,28 @@ exports.rebuildConfigModule = rebuildConfigModule;
 // 让当前配置模块图重新求值。
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const effect_1 = require("effect");
 const fresh_import_ts_1 = require("./fresh-import.cjs");
-async function loadConfigModule(cwd, rebuild) {
-    const path = (0, node_path_1.join)(cwd, "niceeval.config.ts");
-    if (!(0, node_fs_1.existsSync)(path)) {
-        throw new Error(`Could not find niceeval.config.ts.
+function loadConfigModule(cwd, rebuild) {
+    return effect_1.Effect.gen(function* () {
+        const path = (0, node_path_1.join)(cwd, "niceeval.config.ts");
+        yield* effect_1.Effect.try({ try: () => {
+                if (!(0, node_fs_1.existsSync)(path))
+                    throw new Error(`Could not find niceeval.config.ts.
 Ways to fix:
   - [init] Run \`npx niceeval init\` to scaffold niceeval.config.ts and evals/
   - [cd] Run from the project root that contains niceeval.config.ts
   Docs: node_modules/niceeval/docs-site/zh/tutorials/quickstart.mdx`);
-    }
-    const mod = rebuild
-        ? (await (0, fresh_import_ts_1.freshImportModule)(path))
-        : (await (0, fresh_import_ts_1.importProjectModule)(path));
-    if (!mod.default)
-        throw new Error(`niceeval.config.ts must default export defineConfig(...).`);
-    return mod.default;
+            }, catch: (cause) => cause });
+        const mod = yield* (rebuild
+            ? (0, fresh_import_ts_1.freshImportModule)(path)
+            : effect_1.Effect.tryPromise({ try: () => (0, fresh_import_ts_1.importProjectModule)(path), catch: (cause) => cause }));
+        return yield* effect_1.Effect.try({ try: () => {
+                if (!mod.default)
+                    throw new Error(`niceeval.config.ts must default export defineConfig(...).`);
+                return mod.default;
+            }, catch: (cause) => cause });
+    });
 }
 /** Canonical trusted module load; callers that need fresh evaluation use rebuild. */
 function loadConfigModuleOnce(cwd) {

package/dist/load-config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"load-config.js","sourceRoot":"","sources":["load-config.ts"],"names":[],"mappings":";;AA2BA,oDAEC;AAED,kDAEC;AAjCD,qEAAqE;AACrE,gBAAgB;AAChB,qCAAqC;AACrC,yCAAiC;AACjC,uDAA2E;AAE3E,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAgB;IACzD,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC;;;;oEAI4C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,GAAG,GAAG,OAAO;QACf,CAAC,CAAE,CAAC,MAAM,IAAA,mCAAiB,EAAC,IAAI,CAAC,CAE/B;QACF,CAAC,CAAE,CAAC,MAAM,IAAA,qCAAmB,EAAC,IAAI,CAAC,CAEjC,CAAC;IACP,IAAI,CAAC,GAAG,CAAC,OAAO;QACZ,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACjF,OAAO,GAAG,CAAC,OAAO,CAAC;AACvB,CAAC;AACD,qFAAqF;AACrF,SAAgB,oBAAoB,CAAC,GAAW;IAC5C,OAAO,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AACD,yFAAyF;AACzF,SAAgB,mBAAmB,CAAC,GAAW;IAC3C,OAAO,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC","sourcesContent":["// niceeval.config.ts 装载:CLI 与 view 共用。view 本地模式每次重建都使用 fresh import,\n// 让当前配置模块图重新求值。\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { freshImportModule, importProjectModule } from \"./fresh-import.ts\";\nimport type { Config } from \"./runner/types.ts\";\nasync function loadConfigModule(cwd: string, rebuild: boolean): Promise<Config> {\n    const path = join(cwd, \"niceeval.config.ts\");\n    if (!existsSync(path)) {\n        throw new Error(`Could not find niceeval.config.ts.\nWays to fix:\n  - [init] Run \\`npx niceeval init\\` to scaffold niceeval.config.ts and evals/\n  - [cd] Run from the project root that contains niceeval.config.ts\n  Docs: node_modules/niceeval/docs-site/zh/tutorials/quickstart.mdx`);\n    }\n    const mod = rebuild\n        ? ((await freshImportModule(path)) as {\n            default?: Config;\n        })\n        : ((await importProjectModule(path)) as {\n            default?: Config;\n        });\n    if (!mod.default)\n        throw new Error(`niceeval.config.ts must default export defineConfig(...).`);\n    return mod.default;\n}\n/** Canonical trusted module load; callers that need fresh evaluation use rebuild. */\nexport function loadConfigModuleOnce(cwd: string): Promise<Config> {\n    return loadConfigModule(cwd, false);\n}\n/** Serial callers deliberately request a new module graph rather than a boolean mode. */\nexport function rebuildConfigModule(cwd: string): Promise<Config> {\n    return loadConfigModule(cwd, true);\n}\n"]}
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["load-config.ts"],"names":[],"mappings":";;AA6BA,oDAEC;AAED,kDAEC;AAnCD,qEAAqE;AACrE,gBAAgB;AAChB,qCAAqC;AACrC,yCAAiC;AACjC,mCAAgC;AAChC,uDAA2E;AAE3E,SAAS,gBAAgB,CAAC,GAAW,EAAE,OAAgB;IACnD,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvB,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAC7C,KAAK,CAAC,CAAC,eAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;gBACtB,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;oBACjB,MAAM,IAAI,KAAK,CAAC;;;;oEAIgC,CAAC,CAAC;YAC1D,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO;YACvB,CAAC,CAAC,IAAA,mCAAiB,EAAC,IAAI,CAAC;YACzB,CAAC,CAAC,eAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAA,qCAAmB,EAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5F,OAAO,KAAK,CAAC,CAAC,eAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;gBAC7B,IAAI,CAAC,GAAG,CAAC,OAAO;oBACZ,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;gBACjF,OAAO,GAAG,CAAC,OAAiB,CAAC;YACjC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC;AACD,qFAAqF;AACrF,SAAgB,oBAAoB,CAAC,GAAW;IAC5C,OAAO,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AACD,yFAAyF;AACzF,SAAgB,mBAAmB,CAAC,GAAW;IAC3C,OAAO,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC","sourcesContent":["// niceeval.config.ts 装载:CLI 与 view 共用。view 本地模式每次重建都使用 fresh import,\n// 让当前配置模块图重新求值。\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { Effect } from \"effect\";\nimport { freshImportModule, importProjectModule } from \"./fresh-import.ts\";\nimport type { Config } from \"./runner/types.ts\";\nfunction loadConfigModule(cwd: string, rebuild: boolean): Effect.Effect<Config, unknown> {\n    return Effect.gen(function* () {\n        const path = join(cwd, \"niceeval.config.ts\");\n        yield* Effect.try({ try: () => {\n                if (!existsSync(path))\n                    throw new Error(`Could not find niceeval.config.ts.\nWays to fix:\n  - [init] Run \\`npx niceeval init\\` to scaffold niceeval.config.ts and evals/\n  - [cd] Run from the project root that contains niceeval.config.ts\n  Docs: node_modules/niceeval/docs-site/zh/tutorials/quickstart.mdx`);\n            }, catch: (cause) => cause });\n        const mod = yield* (rebuild\n            ? freshImportModule(path)\n            : Effect.tryPromise({ try: () => importProjectModule(path), catch: (cause) => cause }));\n        return yield* Effect.try({ try: () => {\n                if (!mod.default)\n                    throw new Error(`niceeval.config.ts must default export defineConfig(...).`);\n                return mod.default as Config;\n            }, catch: (cause) => cause });\n    });\n}\n/** Canonical trusted module load; callers that need fresh evaluation use rebuild. */\nexport function loadConfigModuleOnce(cwd: string): Effect.Effect<Config, unknown> {\n    return loadConfigModule(cwd, false);\n}\n/** Serial callers deliberately request a new module graph rather than a boolean mode. */\nexport function rebuildConfigModule(cwd: string): Effect.Effect<Config, unknown> {\n    return loadConfigModule(cwd, true);\n}\n"]}

package/dist/load-config.d.cts

@@ -1,5 +1,6 @@
+import { Effect } from "effect";
 import type { Config } from "./runner/types.cjs";
 /** Canonical trusted module load; callers that need fresh evaluation use rebuild. */
-export declare function loadConfigModuleOnce(cwd: string): Promise<Config>;
+export declare function loadConfigModuleOnce(cwd: string): Effect.Effect<Config, unknown>;
 /** Serial callers deliberately request a new module graph rather than a boolean mode. */
-export declare function rebuildConfigModule(cwd: string): Promise<Config>;
+export declare function rebuildConfigModule(cwd: string): Effect.Effect<Config, unknown>;

package/dist/load-config.d.mts

@@ -1,5 +1,6 @@
+import { Effect } from "effect";
 import type { Config } from "./runner/types.mjs";
 /** Canonical trusted module load; callers that need fresh evaluation use rebuild. */
-export declare function loadConfigModuleOnce(cwd: string): Promise<Config>;
+export declare function loadConfigModuleOnce(cwd: string): Effect.Effect<Config, unknown>;
 /** Serial callers deliberately request a new module graph rather than a boolean mode. */
-export declare function rebuildConfigModule(cwd: string): Promise<Config>;
+export declare function rebuildConfigModule(cwd: string): Effect.Effect<Config, unknown>;

package/dist/load-config.d.ts

@@ -1,5 +1,6 @@
+import { Effect } from "effect";
 import type { Config } from "./runner/types.js";
 /** Canonical trusted module load; callers that need fresh evaluation use rebuild. */
-export declare function loadConfigModuleOnce(cwd: string): Promise<Config>;
+export declare function loadConfigModuleOnce(cwd: string): Effect.Effect<Config, unknown>;
 /** Serial callers deliberately request a new module graph rather than a boolean mode. */
-export declare function rebuildConfigModule(cwd: string): Promise<Config>;
+export declare function rebuildConfigModule(cwd: string): Effect.Effect<Config, unknown>;

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

@@ -8,6 +8,7 @@ exports.compareAdapterModelGroups = compareAdapterModelGroups;
 exports.projectAdapterModelUsage = projectAdapterModelUsage;
 exports.projectAdapterUsageSnapshot = projectAdapterUsageSnapshot;
 exports.compareCanonicalDecimal = compareCanonicalDecimal;
+const cache_read_ts_1 = require("./cache-read.cjs");
 const pricing_ts_1 = require("../record/family/adapter-usage/pricing.cjs");
 function effectiveUsageCalls(usage) {
     const receipts = new Map((usage.priceReceipts ?? []).map((receipt) => [receipt.callId, receipt]));
@@ -86,7 +87,8 @@ function compareAdapterModelGroups(left, right) {
     return 0;
 }
 /** Configuration counts and grouped statistics both consume the complete sealed ledger. */
-function projectAdapterModelUsage(usage, models, unavailable = { basis: "unavailable", reason: "usage-not-recorded" }) {
+function projectAdapterModelUsage(usage, models, unavailable = { basis: "unavailable", reason: "usage-not-recorded" }, producerCompletenessKnown = true) {
+    const cacheRead = (0, cache_read_ts_1.projectCacheRead)(usage, models, producerCompletenessKnown, unavailable.reason === "physical-call-identity-not-recorded" ? "adapter-usage-required" : unavailable.reason);
     const counts = new Map();
     for (const call of usage?.calls ?? []) {
         if (call.modelSlot !== null)
@@ -103,6 +105,7 @@ function projectAdapterModelUsage(usage, models, unavailable = { basis: "unavail
         });
     if (usage === null)
         return Object.freeze({
+            cacheRead,
             configuredModels,
             modelGroups: Object.freeze({
                 state: "unavailable", ...unavailable,
@@ -134,6 +137,7 @@ function projectAdapterModelUsage(usage, models, unavailable = { basis: "unavail
         });
     });
     return Object.freeze({
+        cacheRead,
         configuredModels,
         modelGroups: Object.freeze({
             state: "available", basis: "recorded-calls",

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

@@ -1 +1 @@
-{"version":3,"file":"adapter-usage-projection.js","sourceRoot":"","sources":["adapter-usage-projection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReadableAdapterUsageAttachment, AdapterUsageCall, AdapterCallPriceReceipt } from \"../record/family/adapter-usage/schema.ts\";\nimport { addCanonicalDecimals } from \"../record/family/adapter-usage/pricing.ts\";\nimport type { NumericMaterial } from \"../assertions/match.ts\";\nimport type { ResolvedModelSlots } from \"../model-slots.ts\";\nexport interface EffectiveCallCost {\n    readonly amount: string;\n    readonly currency: string;\n    readonly source: {\n        readonly kind: \"reported\" | \"estimated\";\n        readonly id: string;\n    };\n    readonly state: \"complete\" | \"partial\";\n}\nexport type EffectiveUsageCall = AdapterUsageCall & {\n    readonly effectiveCost: EffectiveCallCost | null;\n};\nexport function effectiveUsageCalls(usage: ReadableAdapterUsageAttachment): readonly EffectiveUsageCall[] {\n    const receipts = new Map((usage.priceReceipts ?? []).map((receipt) => [receipt.callId, receipt]));\n    return Object.freeze(usage.calls.map((call) => {\n        const receipt = receipts.get(call.callId);\n        return Object.freeze({ ...call, effectiveCost: call.cost !== null ? Object.freeze({ ...call.cost, state: \"complete\" as const }) : receipt === undefined ? null : Object.freeze({ amount: receipt.amount, currency: receipt.currency, source: receipt.source, state: receipt.state }) });\n    }));\n}\nexport function effectiveCostTotals(calls: readonly {\n    readonly effectiveCost: EffectiveCallCost | null;\n}[], collectionState: \"complete\" | \"partial\") {\n    const known = calls.flatMap((call) => call.effectiveCost === null ? [] : [call.effectiveCost]);\n    const kind = (values: readonly EffectiveCallCost[]) => { const sources = new Set(values.map((value) => value.source.kind)); return sources.size === 0 ? null : sources.size === 1 ? [...sources][0]! : \"mixed\" as const; };\n    const grouped = new Map<string, EffectiveCallCost[]>();\n    for (const cost of known)\n        grouped.set(cost.currency, [...(grouped.get(cost.currency) ?? []), cost]);\n    const complete = collectionState === \"complete\" && known.length === calls.length && known.every((cost) => cost.state === \"complete\");\n    return Object.freeze({ state: known.length === 0 ? \"unavailable\" as const : complete ? \"complete\" as const : \"partial\" as const, source: kind(known), values: Object.freeze([...grouped.entries()].sort(([left], [right]) => left.localeCompare(right)).map(([currency, values]) => Object.freeze({ currency, value: addCanonicalDecimals(values.map((value) => value.amount)), source: kind(values)!, coveredCalls: values.filter((value) => value.state === \"complete\").length, reportedCalls: values.filter((value) => value.source.kind === \"reported\").length, estimatedCalls: values.filter((value) => value.source.kind === \"estimated\").length }))), totalCalls: calls.length });\n}\nfunction inputTotal(call: AdapterUsageCall): {\n    value: number | null;\n    complete: boolean;\n} {\n    const known = [call.inputTokens, call.cacheReadTokens, call.cacheWriteTokens].filter((value): value is number => value !== null);\n    return { value: call.inputTotalTokens ?? (known.length === 0 ? null : known.reduce((sum, value) => sum + value, 0)), complete: call.inputTotalTokens !== null || known.length === 3 };\n}\nexport function adapterTokenMaterial(usage: ReadableAdapterUsageAttachment, metric: \"inputTokens\" | \"inputTotalTokens\" | \"outputTokens\" | \"cacheReadTokens\" | \"cacheWriteTokens\" | \"totalTokens\"): NumericMaterial {\n    const provenance = Object.freeze({ source: \"adapter\", scope: \"recorded-calls\", unit: \"tokens\", cut: \"call-time\" });\n    let value = 0;\n    let observations = 0;\n    let complete = usage.collection.state === \"complete\" && usage.calls.length > 0;\n    for (const call of usage.calls) {\n        if (call.status === \"unknown\")\n            complete = false;\n        const input = inputTotal(call);\n        const buckets = metric === \"totalTokens\" ? [input.value, call.outputTokens] : metric === \"inputTotalTokens\" ? [input.value] : [call[metric]];\n        const observedBuckets = metric === \"totalTokens\" || metric === \"inputTotalTokens\"\n            ? [...(call.inputTotalTokens === null ? [call.inputTokens, call.cacheReadTokens, call.cacheWriteTokens] : [call.inputTotalTokens]), ...(metric === \"totalTokens\" ? [call.outputTokens] : [])]\n            : buckets;\n        if (observedBuckets.some((bucket) => bucket !== null && (!Number.isSafeInteger(bucket) || bucket < 0))) {\n            return Object.freeze({ state: \"unavailable\", reason: \"usage-invalid-token-value\", provenance });\n        }\n        for (const bucket of buckets) {\n            if (bucket === null)\n                complete = false;\n            else {\n                value += bucket;\n                observations += 1;\n            }\n        }\n        if ((metric === \"totalTokens\" || metric === \"inputTotalTokens\") && !input.complete)\n            complete = false;\n    }\n    return Object.freeze(!Number.isSafeInteger(value) ? { state: \"unavailable\", reason: \"usage-exceeds-safe-integer\", provenance } : observations === 0 ? { state: \"unavailable\", reason: \"usage-not-recorded\", provenance } : { state: complete ? \"exact\" : \"lower-bound\", value, provenance });\n}\nexport function adapterInspectionTokenTotal(usage: ReadableAdapterUsageAttachment, metric: \"inputTotalTokens\" | \"outputTokens\" | \"totalTokens\") {\n    const material = adapterTokenMaterial(usage, metric);\n    const observationCount = usage.calls.filter((call) => metric === \"outputTokens\"\n        ? call.outputTokens !== null\n        : inputTotal(call).value !== null || (metric === \"totalTokens\" && call.outputTokens !== null)).length;\n    return Object.freeze({\n        state: material.state === \"exact\" ? \"available\" as const\n            : material.state === \"lower-bound\" ? \"partial\" as const : \"unavailable\" as const,\n        value: material.state === \"unavailable\" ? null : material.value,\n        observationCount,\n    });\n}\n/** Tuple order is stable across hosts, with missing identities before strings. */\nexport function compareAdapterModelGroups(left: Pick<AdapterUsageCall, \"modelSlot\" | \"provider\" | \"model\">, right: Pick<AdapterUsageCall, \"modelSlot\" | \"provider\" | \"model\">): number {\n    for (const key of [\"modelSlot\", \"provider\", \"model\"] as const) {\n        const a = left[key];\n        const b = right[key];\n        if (a === b)\n            continue;\n        if (a === null)\n            return -1;\n        if (b === null)\n            return 1;\n        return a < b ? -1 : 1;\n    }\n    return 0;\n}\n/** Configuration counts and grouped statistics both consume the complete sealed ledger. */\nexport function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelSlots | undefined, unavailable: {\n    readonly basis: \"recorded-calls\" | \"reported-sends\" | \"unavailable\";\n    readonly reason: \"source-invalid\" | \"usage-not-recorded\" | \"physical-call-identity-not-recorded\";\n} = { basis: \"unavailable\", reason: \"usage-not-recorded\" }) {\n    const counts = new Map<string, number>();\n    for (const call of usage?.calls ?? []) {\n        if (call.modelSlot !== null)\n            counts.set(call.modelSlot, (counts.get(call.modelSlot) ?? 0) + 1);\n    }\n    const configuredModels = models === undefined\n        ? Object.freeze({ state: \"not-recorded\" as const })\n        : Object.freeze({\n            state: \"available\" as const,\n            bindings: Object.freeze(Object.keys(models).sort().map((modelSlot) => Object.freeze({\n                modelSlot, ...models[modelSlot]!,\n                recordedCalls: usage === null ? null : counts.get(modelSlot) ?? 0,\n            }))),\n        });\n    if (usage === null)\n        return Object.freeze({\n            configuredModels,\n            modelGroups: Object.freeze({\n                state: \"unavailable\" as const, ...unavailable,\n                groups: Object.freeze([]) as readonly [\n                ], totalGroupCount: null,\n                groupsTruncated: false as const, omittedGroupCount: 0 as const,\n            }),\n        });\n    const grouped = new Map<string, EffectiveUsageCall[]>();\n    for (const call of effectiveUsageCalls(usage)) {\n        const identity = JSON.stringify([call.modelSlot, call.provider, call.model]);\n        const group = grouped.get(identity);\n        if (group === undefined)\n            grouped.set(identity, [call]);\n        else\n            group.push(call);\n    }\n    const allGroups = [...grouped.values()].sort((left, right) => compareAdapterModelGroups(left[0]!, right[0]!));\n    const groups = allGroups.slice(0, 64).map((calls) => {\n        const { modelSlot, provider, model } = calls[0]!;\n        const groupUsage = { ...usage, calls };\n        return Object.freeze({\n            modelSlot, provider, model, recordedCalls: calls.length,\n            tokens: Object.freeze({\n                inputTotalTokens: adapterInspectionTokenTotal(groupUsage, \"inputTotalTokens\"),\n                outputTokens: adapterInspectionTokenTotal(groupUsage, \"outputTokens\"),\n                totalTokens: adapterInspectionTokenTotal(groupUsage, \"totalTokens\"),\n            }),\n            costs: effectiveCostTotals(calls, usage.collection.state),\n        });\n    });\n    return Object.freeze({\n        configuredModels,\n        modelGroups: Object.freeze({\n            state: \"available\" as const, basis: \"recorded-calls\" as const,\n            groups: Object.freeze(groups), totalGroupCount: allGroups.length,\n            groupsTruncated: allGroups.length > groups.length,\n            omittedGroupCount: allGroups.length - groups.length,\n        }),\n    });\n}\nexport interface AdapterAttemptUsageSnapshot {\n    readonly source: \"adapter\";\n    readonly scope: \"recorded-calls\";\n    readonly cut: \"call-time\";\n    readonly collection: ReadableAdapterUsageAttachment[\"collection\"];\n    readonly calls: readonly EffectiveUsageCall[];\n    readonly priceReceipts: readonly AdapterCallPriceReceipt[];\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: ReturnType<typeof effectiveCostTotals>;\n}\nexport type AttemptUsageSnapshot = AdapterAttemptUsageSnapshot | {\n    readonly source: \"unavailable\";\n    readonly reason: \"usage-owner-not-bound\";\n};\nexport function projectAdapterUsageSnapshot(usage: ReadableAdapterUsageAttachment): AdapterAttemptUsageSnapshot {\n    const calls = effectiveUsageCalls(usage);\n    return Object.freeze({ source: \"adapter\", scope: \"recorded-calls\", cut: \"call-time\", collection: usage.collection, calls, priceReceipts: usage.priceReceipts ?? [], inputTokens: adapterTokenMaterial(usage, \"inputTokens\"), inputTotalTokens: adapterTokenMaterial(usage, \"inputTotalTokens\"), outputTokens: adapterTokenMaterial(usage, \"outputTokens\"), cacheReadTokens: adapterTokenMaterial(usage, \"cacheReadTokens\"), cacheWriteTokens: adapterTokenMaterial(usage, \"cacheWriteTokens\"), totalTokens: adapterTokenMaterial(usage, \"totalTokens\"), costs: effectiveCostTotals(calls, usage.collection.state) });\n}\nexport function compareCanonicalDecimal(left: string, right: string): -1 | 0 | 1 {\n    const [li, lf = \"\"] = left.split(\".\");\n    const [ri, rf = \"\"] = right.split(\".\");\n    const width = Math.max(lf.length, rf.length);\n    const l = BigInt(li! + lf.padEnd(width, \"0\"));\n    const r = BigInt(ri! + rf.padEnd(width, \"0\"));\n    return l < r ? -1 : l > r ? 1 : 0;\n}\n"]}
+{"version":3,"file":"adapter-usage-projection.js","sourceRoot":"","sources":["adapter-usage-projection.ts"],"names":[],"mappings":"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","sourcesContent":["import { projectCacheRead } from \"./cache-read.ts\";\nimport type { ReadableAdapterUsageAttachment, AdapterUsageCall, AdapterCallPriceReceipt } from \"../record/family/adapter-usage/schema.ts\";\nimport { addCanonicalDecimals } from \"../record/family/adapter-usage/pricing.ts\";\nimport type { NumericMaterial } from \"../assertions/match.ts\";\nimport type { ResolvedModelSlots } from \"../model-slots.ts\";\nexport interface EffectiveCallCost {\n    readonly amount: string;\n    readonly currency: string;\n    readonly source: {\n        readonly kind: \"reported\" | \"estimated\";\n        readonly id: string;\n    };\n    readonly state: \"complete\" | \"partial\";\n}\nexport type EffectiveUsageCall = AdapterUsageCall & {\n    readonly effectiveCost: EffectiveCallCost | null;\n};\nexport function effectiveUsageCalls(usage: ReadableAdapterUsageAttachment): readonly EffectiveUsageCall[] {\n    const receipts = new Map((usage.priceReceipts ?? []).map((receipt) => [receipt.callId, receipt]));\n    return Object.freeze(usage.calls.map((call) => {\n        const receipt = receipts.get(call.callId);\n        return Object.freeze({ ...call, effectiveCost: call.cost !== null ? Object.freeze({ ...call.cost, state: \"complete\" as const }) : receipt === undefined ? null : Object.freeze({ amount: receipt.amount, currency: receipt.currency, source: receipt.source, state: receipt.state }) });\n    }));\n}\nexport function effectiveCostTotals(calls: readonly {\n    readonly effectiveCost: EffectiveCallCost | null;\n}[], collectionState: \"complete\" | \"partial\") {\n    const known = calls.flatMap((call) => call.effectiveCost === null ? [] : [call.effectiveCost]);\n    const kind = (values: readonly EffectiveCallCost[]) => { const sources = new Set(values.map((value) => value.source.kind)); return sources.size === 0 ? null : sources.size === 1 ? [...sources][0]! : \"mixed\" as const; };\n    const grouped = new Map<string, EffectiveCallCost[]>();\n    for (const cost of known)\n        grouped.set(cost.currency, [...(grouped.get(cost.currency) ?? []), cost]);\n    const complete = collectionState === \"complete\" && known.length === calls.length && known.every((cost) => cost.state === \"complete\");\n    return Object.freeze({ state: known.length === 0 ? \"unavailable\" as const : complete ? \"complete\" as const : \"partial\" as const, source: kind(known), values: Object.freeze([...grouped.entries()].sort(([left], [right]) => left.localeCompare(right)).map(([currency, values]) => Object.freeze({ currency, value: addCanonicalDecimals(values.map((value) => value.amount)), source: kind(values)!, coveredCalls: values.filter((value) => value.state === \"complete\").length, reportedCalls: values.filter((value) => value.source.kind === \"reported\").length, estimatedCalls: values.filter((value) => value.source.kind === \"estimated\").length }))), totalCalls: calls.length });\n}\nfunction inputTotal(call: AdapterUsageCall): {\n    value: number | null;\n    complete: boolean;\n} {\n    const known = [call.inputTokens, call.cacheReadTokens, call.cacheWriteTokens].filter((value): value is number => value !== null);\n    return { value: call.inputTotalTokens ?? (known.length === 0 ? null : known.reduce((sum, value) => sum + value, 0)), complete: call.inputTotalTokens !== null || known.length === 3 };\n}\nexport function adapterTokenMaterial(usage: ReadableAdapterUsageAttachment, metric: \"inputTokens\" | \"inputTotalTokens\" | \"outputTokens\" | \"cacheReadTokens\" | \"cacheWriteTokens\" | \"totalTokens\"): NumericMaterial {\n    const provenance = Object.freeze({ source: \"adapter\", scope: \"recorded-calls\", unit: \"tokens\", cut: \"call-time\" });\n    let value = 0;\n    let observations = 0;\n    let complete = usage.collection.state === \"complete\" && usage.calls.length > 0;\n    for (const call of usage.calls) {\n        if (call.status === \"unknown\")\n            complete = false;\n        const input = inputTotal(call);\n        const buckets = metric === \"totalTokens\" ? [input.value, call.outputTokens] : metric === \"inputTotalTokens\" ? [input.value] : [call[metric]];\n        const observedBuckets = metric === \"totalTokens\" || metric === \"inputTotalTokens\"\n            ? [...(call.inputTotalTokens === null ? [call.inputTokens, call.cacheReadTokens, call.cacheWriteTokens] : [call.inputTotalTokens]), ...(metric === \"totalTokens\" ? [call.outputTokens] : [])]\n            : buckets;\n        if (observedBuckets.some((bucket) => bucket !== null && (!Number.isSafeInteger(bucket) || bucket < 0))) {\n            return Object.freeze({ state: \"unavailable\", reason: \"usage-invalid-token-value\", provenance });\n        }\n        for (const bucket of buckets) {\n            if (bucket === null)\n                complete = false;\n            else {\n                value += bucket;\n                observations += 1;\n            }\n        }\n        if ((metric === \"totalTokens\" || metric === \"inputTotalTokens\") && !input.complete)\n            complete = false;\n    }\n    return Object.freeze(!Number.isSafeInteger(value) ? { state: \"unavailable\", reason: \"usage-exceeds-safe-integer\", provenance } : observations === 0 ? { state: \"unavailable\", reason: \"usage-not-recorded\", provenance } : { state: complete ? \"exact\" : \"lower-bound\", value, provenance });\n}\nexport function adapterInspectionTokenTotal(usage: ReadableAdapterUsageAttachment, metric: \"inputTotalTokens\" | \"outputTokens\" | \"totalTokens\") {\n    const material = adapterTokenMaterial(usage, metric);\n    const observationCount = usage.calls.filter((call) => metric === \"outputTokens\"\n        ? call.outputTokens !== null\n        : inputTotal(call).value !== null || (metric === \"totalTokens\" && call.outputTokens !== null)).length;\n    return Object.freeze({\n        state: material.state === \"exact\" ? \"available\" as const\n            : material.state === \"lower-bound\" ? \"partial\" as const : \"unavailable\" as const,\n        value: material.state === \"unavailable\" ? null : material.value,\n        observationCount,\n    });\n}\n/** Tuple order is stable across hosts, with missing identities before strings. */\nexport function compareAdapterModelGroups(left: Pick<AdapterUsageCall, \"modelSlot\" | \"provider\" | \"model\">, right: Pick<AdapterUsageCall, \"modelSlot\" | \"provider\" | \"model\">): number {\n    for (const key of [\"modelSlot\", \"provider\", \"model\"] as const) {\n        const a = left[key];\n        const b = right[key];\n        if (a === b)\n            continue;\n        if (a === null)\n            return -1;\n        if (b === null)\n            return 1;\n        return a < b ? -1 : 1;\n    }\n    return 0;\n}\n/** Configuration counts and grouped statistics both consume the complete sealed ledger. */\nexport function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelSlots | undefined, unavailable: {\n    readonly basis: \"recorded-calls\" | \"reported-sends\" | \"unavailable\";\n    readonly reason: \"source-invalid\" | \"usage-not-recorded\" | \"physical-call-identity-not-recorded\";\n} = { basis: \"unavailable\", reason: \"usage-not-recorded\" }, producerCompletenessKnown = true) {\n    const cacheRead = projectCacheRead(usage, models, producerCompletenessKnown, unavailable.reason === \"physical-call-identity-not-recorded\" ? \"adapter-usage-required\" : unavailable.reason);\n    const counts = new Map<string, number>();\n    for (const call of usage?.calls ?? []) {\n        if (call.modelSlot !== null)\n            counts.set(call.modelSlot, (counts.get(call.modelSlot) ?? 0) + 1);\n    }\n    const configuredModels = models === undefined\n        ? Object.freeze({ state: \"not-recorded\" as const })\n        : Object.freeze({\n            state: \"available\" as const,\n            bindings: Object.freeze(Object.keys(models).sort().map((modelSlot) => Object.freeze({\n                modelSlot, ...models[modelSlot]!,\n                recordedCalls: usage === null ? null : counts.get(modelSlot) ?? 0,\n            }))),\n        });\n    if (usage === null)\n        return Object.freeze({\n            cacheRead,\n            configuredModels,\n            modelGroups: Object.freeze({\n                state: \"unavailable\" as const, ...unavailable,\n                groups: Object.freeze([]) as readonly [\n                ], totalGroupCount: null,\n                groupsTruncated: false as const, omittedGroupCount: 0 as const,\n            }),\n        });\n    const grouped = new Map<string, EffectiveUsageCall[]>();\n    for (const call of effectiveUsageCalls(usage)) {\n        const identity = JSON.stringify([call.modelSlot, call.provider, call.model]);\n        const group = grouped.get(identity);\n        if (group === undefined)\n            grouped.set(identity, [call]);\n        else\n            group.push(call);\n    }\n    const allGroups = [...grouped.values()].sort((left, right) => compareAdapterModelGroups(left[0]!, right[0]!));\n    const groups = allGroups.slice(0, 64).map((calls) => {\n        const { modelSlot, provider, model } = calls[0]!;\n        const groupUsage = { ...usage, calls };\n        return Object.freeze({\n            modelSlot, provider, model, recordedCalls: calls.length,\n            tokens: Object.freeze({\n                inputTotalTokens: adapterInspectionTokenTotal(groupUsage, \"inputTotalTokens\"),\n                outputTokens: adapterInspectionTokenTotal(groupUsage, \"outputTokens\"),\n                totalTokens: adapterInspectionTokenTotal(groupUsage, \"totalTokens\"),\n            }),\n            costs: effectiveCostTotals(calls, usage.collection.state),\n        });\n    });\n    return Object.freeze({\n        cacheRead,\n        configuredModels,\n        modelGroups: Object.freeze({\n            state: \"available\" as const, basis: \"recorded-calls\" as const,\n            groups: Object.freeze(groups), totalGroupCount: allGroups.length,\n            groupsTruncated: allGroups.length > groups.length,\n            omittedGroupCount: allGroups.length - groups.length,\n        }),\n    });\n}\nexport interface AdapterAttemptUsageSnapshot {\n    readonly source: \"adapter\";\n    readonly scope: \"recorded-calls\";\n    readonly cut: \"call-time\";\n    readonly collection: ReadableAdapterUsageAttachment[\"collection\"];\n    readonly calls: readonly EffectiveUsageCall[];\n    readonly priceReceipts: readonly AdapterCallPriceReceipt[];\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: ReturnType<typeof effectiveCostTotals>;\n}\nexport type AttemptUsageSnapshot = AdapterAttemptUsageSnapshot | {\n    readonly source: \"unavailable\";\n    readonly reason: \"usage-owner-not-bound\";\n};\nexport function projectAdapterUsageSnapshot(usage: ReadableAdapterUsageAttachment): AdapterAttemptUsageSnapshot {\n    const calls = effectiveUsageCalls(usage);\n    return Object.freeze({ source: \"adapter\", scope: \"recorded-calls\", cut: \"call-time\", collection: usage.collection, calls, priceReceipts: usage.priceReceipts ?? [], inputTokens: adapterTokenMaterial(usage, \"inputTokens\"), inputTotalTokens: adapterTokenMaterial(usage, \"inputTotalTokens\"), outputTokens: adapterTokenMaterial(usage, \"outputTokens\"), cacheReadTokens: adapterTokenMaterial(usage, \"cacheReadTokens\"), cacheWriteTokens: adapterTokenMaterial(usage, \"cacheWriteTokens\"), totalTokens: adapterTokenMaterial(usage, \"totalTokens\"), costs: effectiveCostTotals(calls, usage.collection.state) });\n}\nexport function compareCanonicalDecimal(left: string, right: string): -1 | 0 | 1 {\n    const [li, lf = \"\"] = left.split(\".\");\n    const [ri, rf = \"\"] = right.split(\".\");\n    const width = Math.max(lf.length, rf.length);\n    const l = BigInt(li! + lf.padEnd(width, \"0\"));\n    const r = BigInt(ri! + rf.padEnd(width, \"0\"));\n    return l < r ? -1 : l > r ? 1 : 0;\n}\n"]}

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

@@ -41,7 +41,61 @@ export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "
 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<{
+}, producerCompletenessKnown?: boolean): Readonly<{
+    cacheRead: {
+        readonly total: {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+        };
+        readonly modelSlots: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+        }[];
+        readonly models: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+            readonly provider: string | null;
+            readonly model: string | null;
+        }[];
+    };
     configuredModels: Readonly<{
         state: "not-recorded";
     }> | Readonly<{
@@ -63,6 +117,60 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
         state: "unavailable";
     }>;
 }> | Readonly<{
+    cacheRead: {
+        readonly total: {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+        };
+        readonly modelSlots: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+        }[];
+        readonly models: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+            readonly provider: string | null;
+            readonly model: string | null;
+        }[];
+    };
     configuredModels: Readonly<{
         state: "not-recorded";
     }> | Readonly<{

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

@@ -41,7 +41,61 @@ export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "
 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<{
+}, producerCompletenessKnown?: boolean): Readonly<{
+    cacheRead: {
+        readonly total: {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+        };
+        readonly modelSlots: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+        }[];
+        readonly models: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+            readonly provider: string | null;
+            readonly model: string | null;
+        }[];
+    };
     configuredModels: Readonly<{
         state: "not-recorded";
     }> | Readonly<{
@@ -63,6 +117,60 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
         state: "unavailable";
     }>;
 }> | Readonly<{
+    cacheRead: {
+        readonly total: {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+        };
+        readonly modelSlots: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+        }[];
+        readonly models: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+            readonly provider: string | null;
+            readonly model: string | null;
+        }[];
+    };
     configuredModels: Readonly<{
         state: "not-recorded";
     }> | Readonly<{

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

@@ -41,7 +41,61 @@ export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "
 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<{
+}, producerCompletenessKnown?: boolean): Readonly<{
+    cacheRead: {
+        readonly total: {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+        };
+        readonly modelSlots: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+        }[];
+        readonly models: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+            readonly provider: string | null;
+            readonly model: string | null;
+        }[];
+    };
     configuredModels: Readonly<{
         state: "not-recorded";
     }> | Readonly<{
@@ -63,6 +117,60 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
         state: "unavailable";
     }>;
 }> | Readonly<{
+    cacheRead: {
+        readonly total: {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+        };
+        readonly modelSlots: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+        }[];
+        readonly models: readonly {
+            readonly rate: {
+                readonly state: "exact";
+                readonly value: number;
+            } | {
+                readonly state: "unavailable";
+                readonly reason: "usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total";
+            };
+            readonly recordedCalls: number;
+            readonly coveredCalls: number;
+            readonly missingCacheReadCalls: number;
+            readonly missingInputTotalCalls: number;
+            readonly unknownStatusCalls: number;
+            readonly collectionComplete: boolean;
+            readonly reasons: readonly ("usage-not-recorded" | "source-invalid" | "adapter-usage-required" | "collection-incomplete" | "call-status-unknown" | "no-calls" | "cache-read-missing" | "input-total-missing" | "zero-input-total" | "unsafe-token-total")[];
+            readonly modelSlot: string | null;
+            readonly provider: string | null;
+            readonly model: string | null;
+        }[];
+    };
     configuredModels: Readonly<{
         state: "not-recorded";
     }> | Readonly<{