niceeval 0.17.1 → 0.19.0

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

@@ -1,6 +1,6 @@
 import type { ReadableAdapterUsageAttachment, AdapterUsageCall, AdapterCallPriceReceipt } from "../record/family/adapter-usage/schema.cjs";
 import type { NumericMaterial } from "../assertions/match.cjs";
-import type { ResolvedModelSlots } from "../model-slots.cjs";
+import type { ResolvedModelRoles } from "../model-roles.cjs";
 export interface EffectiveCallCost {
     readonly amount: string;
     readonly currency: string;
@@ -10,7 +10,9 @@ export interface EffectiveCallCost {
     };
     readonly state: "complete" | "partial";
 }
-export type EffectiveUsageCall = AdapterUsageCall & {
+export type EffectiveUsageCall = Omit<AdapterUsageCall, "modelSlot"> & {
+    readonly modelRole: string | null;
+} & {
     readonly effectiveCost: EffectiveCallCost | null;
 };
 export declare function effectiveUsageCalls(usage: ReadableAdapterUsageAttachment): readonly EffectiveUsageCall[];
@@ -29,16 +31,22 @@ export declare function effectiveCostTotals(calls: readonly {
     }>[];
     totalCalls: number;
 }>;
-export declare function adapterTokenMaterial(usage: ReadableAdapterUsageAttachment, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
-export declare function adapterInspectionTokenTotal(usage: ReadableAdapterUsageAttachment, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
+export declare function adapterTokenMaterial(usage: {
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly Omit<AdapterUsageCall, "modelSlot">[];
+}, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
+export declare function adapterInspectionTokenTotal(usage: {
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly Omit<AdapterUsageCall, "modelSlot">[];
+}, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
     state: "partial" | "available" | "unavailable";
     value: number | null;
     observationCount: number;
 }>;
 /** Tuple order is stable across hosts, with missing identities before strings. */
-export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">, right: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">): number;
+export declare function compareAdapterModelGroups(left: Pick<EffectiveUsageCall, "modelRole" | "provider" | "model">, right: Pick<EffectiveUsageCall, "modelRole" | "provider" | "model">): number;
 /** Configuration counts and grouped statistics both consume the complete sealed ledger. */
-export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelSlots | undefined, unavailable?: {
+export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelRoles | undefined, unavailable?: {
     readonly basis: "recorded-calls" | "reported-sends" | "unavailable";
     readonly reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
 }, producerCompletenessKnown?: boolean): Readonly<{
@@ -59,7 +67,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 roles: readonly {
             readonly rate: {
                 readonly state: "exact";
                 readonly value: number;
@@ -74,7 +82,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
         }[];
         readonly models: readonly {
             readonly rate: {
@@ -91,7 +99,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
             readonly provider: string | null;
             readonly model: string | null;
         }[];
@@ -104,7 +112,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             recordedCalls: number | null;
             model: string | null;
             reasoningEffort: string | null;
-            modelSlot: string;
+            modelRole: string;
         }>[];
     }>;
     modelGroups: Readonly<{
@@ -134,7 +142,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 roles: readonly {
             readonly rate: {
                 readonly state: "exact";
                 readonly value: number;
@@ -149,7 +157,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
         }[];
         readonly models: readonly {
             readonly rate: {
@@ -166,7 +174,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
             readonly provider: string | null;
             readonly model: string | null;
         }[];
@@ -179,14 +187,14 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             recordedCalls: number | null;
             model: string | null;
             reasoningEffort: string | null;
-            modelSlot: string;
+            modelRole: string;
         }>[];
     }>;
     modelGroups: Readonly<{
         state: "available";
         basis: "recorded-calls";
         groups: readonly Readonly<{
-            modelSlot: string | null;
+            modelRole: string | null;
             provider: string | null;
             model: string | null;
             recordedCalls: number;

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

@@ -1,6 +1,6 @@
 import type { ReadableAdapterUsageAttachment, AdapterUsageCall, AdapterCallPriceReceipt } from "../record/family/adapter-usage/schema.mjs";
 import type { NumericMaterial } from "../assertions/match.mjs";
-import type { ResolvedModelSlots } from "../model-slots.mjs";
+import type { ResolvedModelRoles } from "../model-roles.mjs";
 export interface EffectiveCallCost {
     readonly amount: string;
     readonly currency: string;
@@ -10,7 +10,9 @@ export interface EffectiveCallCost {
     };
     readonly state: "complete" | "partial";
 }
-export type EffectiveUsageCall = AdapterUsageCall & {
+export type EffectiveUsageCall = Omit<AdapterUsageCall, "modelSlot"> & {
+    readonly modelRole: string | null;
+} & {
     readonly effectiveCost: EffectiveCallCost | null;
 };
 export declare function effectiveUsageCalls(usage: ReadableAdapterUsageAttachment): readonly EffectiveUsageCall[];
@@ -29,16 +31,22 @@ export declare function effectiveCostTotals(calls: readonly {
     }>[];
     totalCalls: number;
 }>;
-export declare function adapterTokenMaterial(usage: ReadableAdapterUsageAttachment, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
-export declare function adapterInspectionTokenTotal(usage: ReadableAdapterUsageAttachment, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
+export declare function adapterTokenMaterial(usage: {
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly Omit<AdapterUsageCall, "modelSlot">[];
+}, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
+export declare function adapterInspectionTokenTotal(usage: {
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly Omit<AdapterUsageCall, "modelSlot">[];
+}, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
     state: "partial" | "available" | "unavailable";
     value: number | null;
     observationCount: number;
 }>;
 /** Tuple order is stable across hosts, with missing identities before strings. */
-export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">, right: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">): number;
+export declare function compareAdapterModelGroups(left: Pick<EffectiveUsageCall, "modelRole" | "provider" | "model">, right: Pick<EffectiveUsageCall, "modelRole" | "provider" | "model">): number;
 /** Configuration counts and grouped statistics both consume the complete sealed ledger. */
-export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelSlots | undefined, unavailable?: {
+export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelRoles | undefined, unavailable?: {
     readonly basis: "recorded-calls" | "reported-sends" | "unavailable";
     readonly reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
 }, producerCompletenessKnown?: boolean): Readonly<{
@@ -59,7 +67,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 roles: readonly {
             readonly rate: {
                 readonly state: "exact";
                 readonly value: number;
@@ -74,7 +82,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
         }[];
         readonly models: readonly {
             readonly rate: {
@@ -91,7 +99,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
             readonly provider: string | null;
             readonly model: string | null;
         }[];
@@ -104,7 +112,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             recordedCalls: number | null;
             model: string | null;
             reasoningEffort: string | null;
-            modelSlot: string;
+            modelRole: string;
         }>[];
     }>;
     modelGroups: Readonly<{
@@ -134,7 +142,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 roles: readonly {
             readonly rate: {
                 readonly state: "exact";
                 readonly value: number;
@@ -149,7 +157,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
         }[];
         readonly models: readonly {
             readonly rate: {
@@ -166,7 +174,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
             readonly provider: string | null;
             readonly model: string | null;
         }[];
@@ -179,14 +187,14 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             recordedCalls: number | null;
             model: string | null;
             reasoningEffort: string | null;
-            modelSlot: string;
+            modelRole: string;
         }>[];
     }>;
     modelGroups: Readonly<{
         state: "available";
         basis: "recorded-calls";
         groups: readonly Readonly<{
-            modelSlot: string | null;
+            modelRole: string | null;
             provider: string | null;
             model: string | null;
             recordedCalls: number;

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

@@ -1,6 +1,6 @@
 import type { ReadableAdapterUsageAttachment, AdapterUsageCall, AdapterCallPriceReceipt } from "../record/family/adapter-usage/schema.js";
 import type { NumericMaterial } from "../assertions/match.js";
-import type { ResolvedModelSlots } from "../model-slots.js";
+import type { ResolvedModelRoles } from "../model-roles.js";
 export interface EffectiveCallCost {
     readonly amount: string;
     readonly currency: string;
@@ -10,7 +10,9 @@ export interface EffectiveCallCost {
     };
     readonly state: "complete" | "partial";
 }
-export type EffectiveUsageCall = AdapterUsageCall & {
+export type EffectiveUsageCall = Omit<AdapterUsageCall, "modelSlot"> & {
+    readonly modelRole: string | null;
+} & {
     readonly effectiveCost: EffectiveCallCost | null;
 };
 export declare function effectiveUsageCalls(usage: ReadableAdapterUsageAttachment): readonly EffectiveUsageCall[];
@@ -29,16 +31,22 @@ export declare function effectiveCostTotals(calls: readonly {
     }>[];
     totalCalls: number;
 }>;
-export declare function adapterTokenMaterial(usage: ReadableAdapterUsageAttachment, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
-export declare function adapterInspectionTokenTotal(usage: ReadableAdapterUsageAttachment, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
+export declare function adapterTokenMaterial(usage: {
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly Omit<AdapterUsageCall, "modelSlot">[];
+}, metric: "inputTokens" | "inputTotalTokens" | "outputTokens" | "cacheReadTokens" | "cacheWriteTokens" | "totalTokens"): NumericMaterial;
+export declare function adapterInspectionTokenTotal(usage: {
+    readonly collection: ReadableAdapterUsageAttachment["collection"];
+    readonly calls: readonly Omit<AdapterUsageCall, "modelSlot">[];
+}, metric: "inputTotalTokens" | "outputTokens" | "totalTokens"): Readonly<{
     state: "partial" | "available" | "unavailable";
     value: number | null;
     observationCount: number;
 }>;
 /** Tuple order is stable across hosts, with missing identities before strings. */
-export declare function compareAdapterModelGroups(left: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">, right: Pick<AdapterUsageCall, "modelSlot" | "provider" | "model">): number;
+export declare function compareAdapterModelGroups(left: Pick<EffectiveUsageCall, "modelRole" | "provider" | "model">, right: Pick<EffectiveUsageCall, "modelRole" | "provider" | "model">): number;
 /** Configuration counts and grouped statistics both consume the complete sealed ledger. */
-export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelSlots | undefined, unavailable?: {
+export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAttachment | null, models: ResolvedModelRoles | undefined, unavailable?: {
     readonly basis: "recorded-calls" | "reported-sends" | "unavailable";
     readonly reason: "source-invalid" | "usage-not-recorded" | "physical-call-identity-not-recorded";
 }, producerCompletenessKnown?: boolean): Readonly<{
@@ -59,7 +67,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 roles: readonly {
             readonly rate: {
                 readonly state: "exact";
                 readonly value: number;
@@ -74,7 +82,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
         }[];
         readonly models: readonly {
             readonly rate: {
@@ -91,7 +99,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
             readonly provider: string | null;
             readonly model: string | null;
         }[];
@@ -104,7 +112,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             recordedCalls: number | null;
             model: string | null;
             reasoningEffort: string | null;
-            modelSlot: string;
+            modelRole: string;
         }>[];
     }>;
     modelGroups: Readonly<{
@@ -134,7 +142,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 roles: readonly {
             readonly rate: {
                 readonly state: "exact";
                 readonly value: number;
@@ -149,7 +157,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
         }[];
         readonly models: readonly {
             readonly rate: {
@@ -166,7 +174,7 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             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 modelRole: string | null;
             readonly provider: string | null;
             readonly model: string | null;
         }[];
@@ -179,14 +187,14 @@ export declare function projectAdapterModelUsage(usage: ReadableAdapterUsageAtta
             recordedCalls: number | null;
             model: string | null;
             reasoningEffort: string | null;
-            modelSlot: string;
+            modelRole: string;
         }>[];
     }>;
     modelGroups: Readonly<{
         state: "available";
         basis: "recorded-calls";
         groups: readonly Readonly<{
-            modelSlot: string | null;
+            modelRole: string | null;
             provider: string | null;
             model: string | null;
             recordedCalls: number;

package/dist/o11y/cache-read.cjs

@@ -36,9 +36,9 @@ const SummaryShape = effect_1.Schema.Struct(fields);
 const Summary = SummaryShape.check(effect_1.Schema.makeFilter(consistent));
 exports.CacheReadReportSchema = effect_1.Schema.Struct({
     total: Summary,
-    modelSlots: effect_1.Schema.Array(effect_1.Schema.Struct({ modelSlot: effect_1.Schema.NullOr(effect_1.Schema.String), ...fields }).check(effect_1.Schema.makeFilter(consistent))),
-    models: effect_1.Schema.Array(effect_1.Schema.Struct({ modelSlot: effect_1.Schema.NullOr(effect_1.Schema.String), provider: effect_1.Schema.NullOr(effect_1.Schema.String), model: effect_1.Schema.NullOr(effect_1.Schema.String), ...fields }).check(effect_1.Schema.makeFilter(consistent))),
-}).check(effect_1.Schema.makeFilter((value) => value.modelSlots.length <= 65 && value.models.length <= 4000));
+    roles: effect_1.Schema.Array(effect_1.Schema.Struct({ modelRole: effect_1.Schema.NullOr(effect_1.Schema.String), ...fields }).check(effect_1.Schema.makeFilter(consistent))),
+    models: effect_1.Schema.Array(effect_1.Schema.Struct({ modelRole: effect_1.Schema.NullOr(effect_1.Schema.String), provider: effect_1.Schema.NullOr(effect_1.Schema.String), model: effect_1.Schema.NullOr(effect_1.Schema.String), ...fields }).check(effect_1.Schema.makeFilter(consistent))),
+}).check(effect_1.Schema.makeFilter((value) => value.roles.length <= 65 && value.models.length <= 4000));
 function summary(calls, collectionComplete, absent) {
     let numerator = 0;
     let denominator = 0;
@@ -82,18 +82,18 @@ function summary(calls, collectionComplete, absent) {
 }
 const compare = (a, b) => a === b ? 0 : a === null ? -1 : b === null ? 1 : a < b ? -1 : 1;
 /** A historical collection marked complete is not proof of an explicit producer seal. */
-function projectCacheRead(usage, slots, producerCompletenessKnown, absent = "usage-not-recorded") {
+function projectCacheRead(usage, roles, producerCompletenessKnown, absent = "usage-not-recorded") {
     if (usage === null)
-        return Object.freeze({ total: summary([], false, absent), modelSlots: Object.freeze([]), models: Object.freeze([]) });
+        return Object.freeze({ total: summary([], false, absent), roles: Object.freeze([]), models: Object.freeze([]) });
     const complete = producerCompletenessKnown && usage.collection.state === "complete";
-    const bySlot = new Map(Object.keys(slots ?? {}).map((slot) => [slot, []]));
+    const byRole = new Map(Object.keys(roles ?? {}).map((role) => [role, []]));
     const byModel = new Map();
     for (const call of usage.calls) {
-        const slot = bySlot.get(call.modelSlot);
-        if (slot === undefined)
-            bySlot.set(call.modelSlot, [call]);
+        const role = byRole.get(call.modelSlot);
+        if (role === undefined)
+            byRole.set(call.modelSlot, [call]);
         else
-            slot.push(call);
+            role.push(call);
         const key = JSON.stringify([call.modelSlot, call.provider, call.model]);
         const model = byModel.get(key);
         if (model === undefined)
@@ -102,11 +102,11 @@ function projectCacheRead(usage, slots, producerCompletenessKnown, absent = "usa
             model.push(call);
     }
     const models = [...byModel.values()].map((calls) => {
-        const { modelSlot, provider, model } = calls[0];
-        return Object.freeze({ modelSlot, provider, model, ...summary(calls, complete) });
-    }).sort((a, b) => compare(a.modelSlot, b.modelSlot) || compare(a.provider, b.provider) || compare(a.model, b.model));
+        const { modelSlot: modelRole, provider, model } = calls[0];
+        return Object.freeze({ modelRole, provider, model, ...summary(calls, complete) });
+    }).sort((a, b) => compare(a.modelRole, b.modelRole) || compare(a.provider, b.provider) || compare(a.model, b.model));
     return Object.freeze({ total: summary(usage.calls, complete),
-        modelSlots: Object.freeze([...bySlot].sort(([a], [b]) => compare(a, b)).map(([modelSlot, calls]) => Object.freeze({ modelSlot, ...summary(calls, complete) }))),
+        roles: Object.freeze([...byRole].sort(([a], [b]) => compare(a, b)).map(([modelRole, calls]) => Object.freeze({ modelRole, ...summary(calls, complete) }))),
         models: Object.freeze(models),
     });
 }

package/dist/o11y/cache-read.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cache-read.js","sourceRoot":"","sources":["cache-read.ts"],"names":[],"mappings":";;;AAuFA,4CA2BC;AAlHD,mCAAgC;AAGhC,0DAA0E;AAC1E,MAAM,MAAM,GAAG,eAAM,CAAC,QAAQ,CAAC;IAC3B,oBAAoB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,uBAAuB;IACzF,qBAAqB,EAAE,UAAU,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB;CAC3H,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,eAAM,CAAC,KAAK,CAAC;IACtB,eAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,eAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,eAAM,CAAC,MAAM,CAAC,KAAK,CAAC,eAAM,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/J,eAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,eAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;CAC1E,CAAC,CAAC;AACH,MAAM,MAAM,GAAG;IACX,IAAI,EAAE,IAAI;IACV,aAAa,EAAE,wCAA4B;IAC3C,YAAY,EAAE,wCAA4B;IAC1C,qBAAqB,EAAE,wCAA4B;IACnD,sBAAsB,EAAE,wCAA4B;IACpD,kBAAkB,EAAE,wCAA4B;IAChD,kBAAkB,EAAE,eAAM,CAAC,OAAO;IAClC,OAAO,EAAE,eAAM,CAAC,KAAK,CAAC,MAAM,CAAC;CAChC,CAAC;AACF,MAAM,UAAU,GAAG,CAAC,KAA+B,EAAW,EAAE;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC;IAClC,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,IAAI,KAAK,CAAC,kBAAkB,IAAI,KAAK;QACpF,KAAK,CAAC,qBAAqB,IAAI,KAAK,IAAI,KAAK,CAAC,sBAAsB,IAAI,KAAK;QAC7E,KAAK,CAAC,YAAY,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,sBAAsB,CAAC;QACjG,KAAK,CAAC,YAAY,IAAI,KAAK,GAAG,KAAK,CAAC,qBAAqB,GAAG,KAAK,CAAC,sBAAsB;QACxF,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM;QACpD,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,kBAAkB,IAAI,KAAK,GAAG,CAAC;YAC/F,KAAK,CAAC,YAAY,KAAK,KAAK,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACrH,CAAC,CAAC;AACF,MAAM,YAAY,GAAG,eAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,eAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;AAGrD,QAAA,qBAAqB,GAAG,eAAM,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,eAAM,CAAC,KAAK,CAAC,eAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,eAAM,CAAC,MAAM,CAAC,eAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,eAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACpI,MAAM,EAAE,eAAM,CAAC,KAAK,CAAC,eAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,eAAM,CAAC,MAAM,CAAC,eAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,eAAM,CAAC,MAAM,CAAC,eAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,eAAM,CAAC,MAAM,CAAC,eAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,eAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;CAChN,CAAC,CAAC,KAAK,CAAC,eAAM,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;AAGrG,SAAS,OAAO,CAAC,KAAkC,EAAE,kBAA2B,EAAE,MAAe;IAC7F,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,qBAAqB,GAAG,CAAC,CAAC;IAC9B,IAAI,sBAAsB,GAAG,CAAC,CAAC;IAC/B,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI;YAChI,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YACzB,kBAAkB,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI;YAC7B,qBAAqB,EAAE,CAAC;;YAExB,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI;YACd,sBAAsB,EAAE,CAAC;;YAEzB,WAAW,IAAI,KAAK,CAAC;QACzB,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI;YAC/C,YAAY,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC;YAC1H,MAAM,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,MAAM,OAAO,GAAa,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC;QAC7C,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,uBAAgC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,qBAA8B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,oBAA6B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,qBAA8B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,sBAAsB,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,kBAA2B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/G,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,oBAA6B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACb,MAAM,IAAI,GAA6B,OAAO,CAAC,MAAM,KAAK,CAAC;QACvD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,EAAE,CAAC;QACnE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,qBAAqB,EAAE,sBAAsB;QACjH,kBAAkB,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AACD,MAAM,OAAO,GAAG,CAAC,CAAgB,EAAE,CAAgB,EAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChI,yFAAyF;AACzF,SAAgB,gBAAgB,CAAC,KAA4C,EAAE,KAAqC,EAAE,yBAAkC,EAAE,SAA6E,oBAAoB;IACvP,IAAI,KAAK,KAAK,IAAI;QACd,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1H,MAAM,QAAQ,GAAG,yBAAyB,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC;IACpF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAoC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9G,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS;YAClB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;;YAEnC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS;YACnB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;;YAEzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACjD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACrH,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC;QACxD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/J,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;KAChC,CAAC,CAAC;AACP,CAAC","sourcesContent":["import { Schema } from \"effect\";\nimport type { ResolvedModelSlots } from \"../model-slots.ts\";\nimport type { AdapterUsageCall, ReadableAdapterUsageAttachment } from \"../record/family/adapter-usage/schema.ts\";\nimport { NonNegativeSafeIntegerSchema } from \"../record/family/common.ts\";\nconst Reason = Schema.Literals([\n    \"usage-not-recorded\", \"source-invalid\", \"adapter-usage-required\", \"collection-incomplete\",\n    \"call-status-unknown\", \"no-calls\", \"cache-read-missing\", \"input-total-missing\", \"zero-input-total\", \"unsafe-token-total\",\n]);\ntype Reason = typeof Reason.Type;\nconst Rate = Schema.Union([\n    Schema.Struct({ state: Schema.Literal(\"exact\"), value: Schema.Number.check(Schema.makeFilter((value) => Number.isFinite(value) && value >= 0 && value <= 1)) }),\n    Schema.Struct({ state: Schema.Literal(\"unavailable\"), reason: Reason }),\n]);\nconst fields = {\n    rate: Rate,\n    recordedCalls: NonNegativeSafeIntegerSchema,\n    coveredCalls: NonNegativeSafeIntegerSchema,\n    missingCacheReadCalls: NonNegativeSafeIntegerSchema,\n    missingInputTotalCalls: NonNegativeSafeIntegerSchema,\n    unknownStatusCalls: NonNegativeSafeIntegerSchema,\n    collectionComplete: Schema.Boolean,\n    reasons: Schema.Array(Reason),\n};\nconst consistent = (value: typeof SummaryShape.Type): boolean => {\n    const count = value.recordedCalls;\n    return count <= 4000 && value.coveredCalls <= count && value.unknownStatusCalls <= count &&\n        value.missingCacheReadCalls <= count && value.missingInputTotalCalls <= count &&\n        value.coveredCalls <= count - Math.max(value.missingCacheReadCalls, value.missingInputTotalCalls) &&\n        value.coveredCalls >= count - value.missingCacheReadCalls - value.missingInputTotalCalls &&\n        new Set(value.reasons).size === value.reasons.length &&\n        (value.rate.state === \"exact\" ? value.reasons.length === 0 && value.collectionComplete && count > 0 &&\n            value.coveredCalls === count && value.unknownStatusCalls === 0 : value.rate.reason === value.reasons[0]);\n};\nconst SummaryShape = Schema.Struct(fields);\nconst Summary = SummaryShape.check(Schema.makeFilter(consistent));\n/** Token-weighted cache reading, with explicit input coverage and collection completeness. */\nexport type CacheReadSummary = typeof Summary.Type;\nexport const CacheReadReportSchema = Schema.Struct({\n    total: Summary,\n    modelSlots: Schema.Array(Schema.Struct({ modelSlot: Schema.NullOr(Schema.String), ...fields }).check(Schema.makeFilter(consistent))),\n    models: Schema.Array(Schema.Struct({ modelSlot: Schema.NullOr(Schema.String), provider: Schema.NullOr(Schema.String), model: Schema.NullOr(Schema.String), ...fields }).check(Schema.makeFilter(consistent))),\n}).check(Schema.makeFilter((value) => value.modelSlots.length <= 65 && value.models.length <= 4000));\n/** Complete per-Attempt report; unknown model identities remain null. */\nexport type CacheReadReport = typeof CacheReadReportSchema.Type;\nfunction summary(calls: readonly AdapterUsageCall[], collectionComplete: boolean, absent?: Reason): CacheReadSummary {\n    let numerator = 0;\n    let denominator = 0;\n    let coveredCalls = 0;\n    let missingCacheReadCalls = 0;\n    let missingInputTotalCalls = 0;\n    let unknownStatusCalls = 0;\n    let unsafe = false;\n    for (const call of calls) {\n        const total = call.inputTotalTokens ?? (call.inputTokens !== null && call.cacheReadTokens !== null && call.cacheWriteTokens !== null\n            ? call.inputTokens + call.cacheReadTokens + call.cacheWriteTokens : null);\n        if (call.status === \"unknown\")\n            unknownStatusCalls++;\n        if (call.cacheReadTokens === null)\n            missingCacheReadCalls++;\n        else\n            numerator += call.cacheReadTokens;\n        if (total === null)\n            missingInputTotalCalls++;\n        else\n            denominator += total;\n        if (total !== null && call.cacheReadTokens !== null)\n            coveredCalls++;\n        if ((total !== null && !Number.isSafeInteger(total)) || !Number.isSafeInteger(numerator) || !Number.isSafeInteger(denominator))\n            unsafe = true;\n    }\n    const reasons: Reason[] = absent === undefined ? [\n        ...(!collectionComplete ? [\"collection-incomplete\" as const] : []),\n        ...(unknownStatusCalls > 0 ? [\"call-status-unknown\" as const] : []),\n        ...(calls.length === 0 ? [\"no-calls\" as const] : []),\n        ...(missingCacheReadCalls > 0 ? [\"cache-read-missing\" as const] : []),\n        ...(missingInputTotalCalls > 0 ? [\"input-total-missing\" as const] : []),\n        ...(calls.length > 0 && missingInputTotalCalls === 0 && denominator === 0 ? [\"zero-input-total\" as const] : []),\n        ...(unsafe ? [\"unsafe-token-total\" as const] : []),\n    ] : [absent];\n    const rate: CacheReadSummary[\"rate\"] = reasons.length === 0\n        ? Object.freeze({ state: \"exact\", value: numerator / denominator })\n        : Object.freeze({ state: \"unavailable\", reason: reasons[0]! });\n    return Object.freeze({ rate, recordedCalls: calls.length, coveredCalls, missingCacheReadCalls, missingInputTotalCalls,\n        unknownStatusCalls, collectionComplete, reasons: Object.freeze(reasons) });\n}\nconst compare = (a: string | null, b: string | null): number => a === b ? 0 : a === null ? -1 : b === null ? 1 : a < b ? -1 : 1;\n/** A historical collection marked complete is not proof of an explicit producer seal. */\nexport function projectCacheRead(usage: ReadableAdapterUsageAttachment | null, slots: ResolvedModelSlots | undefined, producerCompletenessKnown: boolean, absent: \"usage-not-recorded\" | \"source-invalid\" | \"adapter-usage-required\" = \"usage-not-recorded\"): CacheReadReport {\n    if (usage === null)\n        return Object.freeze({ total: summary([], false, absent), modelSlots: Object.freeze([]), models: Object.freeze([]) });\n    const complete = producerCompletenessKnown && usage.collection.state === \"complete\";\n    const bySlot = new Map<string | null, AdapterUsageCall[]>(Object.keys(slots ?? {}).map((slot) => [slot, []]));\n    const byModel = new Map<string, AdapterUsageCall[]>();\n    for (const call of usage.calls) {\n        const slot = bySlot.get(call.modelSlot);\n        if (slot === undefined)\n            bySlot.set(call.modelSlot, [call]);\n        else\n            slot.push(call);\n        const key = JSON.stringify([call.modelSlot, call.provider, call.model]);\n        const model = byModel.get(key);\n        if (model === undefined)\n            byModel.set(key, [call]);\n        else\n            model.push(call);\n    }\n    const models = [...byModel.values()].map((calls) => {\n        const { modelSlot, provider, model } = calls[0]!;\n        return Object.freeze({ modelSlot, provider, model, ...summary(calls, complete) });\n    }).sort((a, b) => compare(a.modelSlot, b.modelSlot) || compare(a.provider, b.provider) || compare(a.model, b.model));\n    return Object.freeze({ total: summary(usage.calls, complete),\n        modelSlots: Object.freeze([...bySlot].sort(([a], [b]) => compare(a, b)).map(([modelSlot, calls]) => Object.freeze({ modelSlot, ...summary(calls, complete) }))),\n        models: Object.freeze(models),\n    });\n}\n"]}
+{"version":3,"file":"cache-read.js","sourceRoot":"","sources":["cache-read.ts"],"names":[],"mappings":"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","sourcesContent":["import { Schema } from \"effect\";\nimport type { ResolvedModelRoles } from \"../model-roles.ts\";\nimport type { AdapterUsageCall, ReadableAdapterUsageAttachment } from \"../record/family/adapter-usage/schema.ts\";\nimport { NonNegativeSafeIntegerSchema } from \"../record/family/common.ts\";\nconst Reason = Schema.Literals([\n    \"usage-not-recorded\", \"source-invalid\", \"adapter-usage-required\", \"collection-incomplete\",\n    \"call-status-unknown\", \"no-calls\", \"cache-read-missing\", \"input-total-missing\", \"zero-input-total\", \"unsafe-token-total\",\n]);\ntype Reason = typeof Reason.Type;\nconst Rate = Schema.Union([\n    Schema.Struct({ state: Schema.Literal(\"exact\"), value: Schema.Number.check(Schema.makeFilter((value) => Number.isFinite(value) && value >= 0 && value <= 1)) }),\n    Schema.Struct({ state: Schema.Literal(\"unavailable\"), reason: Reason }),\n]);\nconst fields = {\n    rate: Rate,\n    recordedCalls: NonNegativeSafeIntegerSchema,\n    coveredCalls: NonNegativeSafeIntegerSchema,\n    missingCacheReadCalls: NonNegativeSafeIntegerSchema,\n    missingInputTotalCalls: NonNegativeSafeIntegerSchema,\n    unknownStatusCalls: NonNegativeSafeIntegerSchema,\n    collectionComplete: Schema.Boolean,\n    reasons: Schema.Array(Reason),\n};\nconst consistent = (value: typeof SummaryShape.Type): boolean => {\n    const count = value.recordedCalls;\n    return count <= 4000 && value.coveredCalls <= count && value.unknownStatusCalls <= count &&\n        value.missingCacheReadCalls <= count && value.missingInputTotalCalls <= count &&\n        value.coveredCalls <= count - Math.max(value.missingCacheReadCalls, value.missingInputTotalCalls) &&\n        value.coveredCalls >= count - value.missingCacheReadCalls - value.missingInputTotalCalls &&\n        new Set(value.reasons).size === value.reasons.length &&\n        (value.rate.state === \"exact\" ? value.reasons.length === 0 && value.collectionComplete && count > 0 &&\n            value.coveredCalls === count && value.unknownStatusCalls === 0 : value.rate.reason === value.reasons[0]);\n};\nconst SummaryShape = Schema.Struct(fields);\nconst Summary = SummaryShape.check(Schema.makeFilter(consistent));\n/** Token-weighted cache reading, with explicit input coverage and collection completeness. */\nexport type CacheReadSummary = typeof Summary.Type;\nexport const CacheReadReportSchema = Schema.Struct({\n    total: Summary,\n    roles: Schema.Array(Schema.Struct({ modelRole: Schema.NullOr(Schema.String), ...fields }).check(Schema.makeFilter(consistent))),\n    models: Schema.Array(Schema.Struct({ modelRole: Schema.NullOr(Schema.String), provider: Schema.NullOr(Schema.String), model: Schema.NullOr(Schema.String), ...fields }).check(Schema.makeFilter(consistent))),\n}).check(Schema.makeFilter((value) => value.roles.length <= 65 && value.models.length <= 4000));\n/** Complete per-Attempt report; unknown model identities remain null. */\nexport type CacheReadReport = typeof CacheReadReportSchema.Type;\nfunction summary(calls: readonly AdapterUsageCall[], collectionComplete: boolean, absent?: Reason): CacheReadSummary {\n    let numerator = 0;\n    let denominator = 0;\n    let coveredCalls = 0;\n    let missingCacheReadCalls = 0;\n    let missingInputTotalCalls = 0;\n    let unknownStatusCalls = 0;\n    let unsafe = false;\n    for (const call of calls) {\n        const total = call.inputTotalTokens ?? (call.inputTokens !== null && call.cacheReadTokens !== null && call.cacheWriteTokens !== null\n            ? call.inputTokens + call.cacheReadTokens + call.cacheWriteTokens : null);\n        if (call.status === \"unknown\")\n            unknownStatusCalls++;\n        if (call.cacheReadTokens === null)\n            missingCacheReadCalls++;\n        else\n            numerator += call.cacheReadTokens;\n        if (total === null)\n            missingInputTotalCalls++;\n        else\n            denominator += total;\n        if (total !== null && call.cacheReadTokens !== null)\n            coveredCalls++;\n        if ((total !== null && !Number.isSafeInteger(total)) || !Number.isSafeInteger(numerator) || !Number.isSafeInteger(denominator))\n            unsafe = true;\n    }\n    const reasons: Reason[] = absent === undefined ? [\n        ...(!collectionComplete ? [\"collection-incomplete\" as const] : []),\n        ...(unknownStatusCalls > 0 ? [\"call-status-unknown\" as const] : []),\n        ...(calls.length === 0 ? [\"no-calls\" as const] : []),\n        ...(missingCacheReadCalls > 0 ? [\"cache-read-missing\" as const] : []),\n        ...(missingInputTotalCalls > 0 ? [\"input-total-missing\" as const] : []),\n        ...(calls.length > 0 && missingInputTotalCalls === 0 && denominator === 0 ? [\"zero-input-total\" as const] : []),\n        ...(unsafe ? [\"unsafe-token-total\" as const] : []),\n    ] : [absent];\n    const rate: CacheReadSummary[\"rate\"] = reasons.length === 0\n        ? Object.freeze({ state: \"exact\", value: numerator / denominator })\n        : Object.freeze({ state: \"unavailable\", reason: reasons[0]! });\n    return Object.freeze({ rate, recordedCalls: calls.length, coveredCalls, missingCacheReadCalls, missingInputTotalCalls,\n        unknownStatusCalls, collectionComplete, reasons: Object.freeze(reasons) });\n}\nconst compare = (a: string | null, b: string | null): number => a === b ? 0 : a === null ? -1 : b === null ? 1 : a < b ? -1 : 1;\n/** A historical collection marked complete is not proof of an explicit producer seal. */\nexport function projectCacheRead(usage: ReadableAdapterUsageAttachment | null, roles: ResolvedModelRoles | undefined, producerCompletenessKnown: boolean, absent: \"usage-not-recorded\" | \"source-invalid\" | \"adapter-usage-required\" = \"usage-not-recorded\"): CacheReadReport {\n    if (usage === null)\n        return Object.freeze({ total: summary([], false, absent), roles: Object.freeze([]), models: Object.freeze([]) });\n    const complete = producerCompletenessKnown && usage.collection.state === \"complete\";\n    const byRole = new Map<string | null, AdapterUsageCall[]>(Object.keys(roles ?? {}).map((role) => [role, []]));\n    const byModel = new Map<string, AdapterUsageCall[]>();\n    for (const call of usage.calls) {\n        const role = byRole.get(call.modelSlot);\n        if (role === undefined)\n            byRole.set(call.modelSlot, [call]);\n        else\n            role.push(call);\n        const key = JSON.stringify([call.modelSlot, call.provider, call.model]);\n        const model = byModel.get(key);\n        if (model === undefined)\n            byModel.set(key, [call]);\n        else\n            model.push(call);\n    }\n    const models = [...byModel.values()].map((calls) => {\n        const { modelSlot: modelRole, provider, model } = calls[0]!;\n        return Object.freeze({ modelRole, provider, model, ...summary(calls, complete) });\n    }).sort((a, b) => compare(a.modelRole, b.modelRole) || compare(a.provider, b.provider) || compare(a.model, b.model));\n    return Object.freeze({ total: summary(usage.calls, complete),\n        roles: Object.freeze([...byRole].sort(([a], [b]) => compare(a, b)).map(([modelRole, calls]) => Object.freeze({ modelRole, ...summary(calls, complete) }))),\n        models: Object.freeze(models),\n    });\n}\n"]}

package/dist/o11y/cache-read.d.cts

@@ -1,5 +1,5 @@
 import { Schema } from "effect";
-import type { ResolvedModelSlots } from "../model-slots.cjs";
+import type { ResolvedModelRoles } from "../model-roles.cjs";
 import type { ReadableAdapterUsageAttachment } from "../record/family/adapter-usage/schema.cjs";
 declare const Summary: Schema.Struct<{
     rate: Schema.Union<readonly [Schema.Struct<{
@@ -36,7 +36,7 @@ export declare const CacheReadReportSchema: Schema.Struct<{
         collectionComplete: Schema.Boolean;
         reasons: Schema.$Array<Schema.Literals<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: Schema.$Array<Schema.Struct<{
+    readonly roles: Schema.$Array<Schema.Struct<{
         readonly rate: Schema.Union<readonly [Schema.Struct<{
             readonly state: Schema.Literal<"exact">;
             readonly value: Schema.Number;
@@ -51,7 +51,7 @@ export declare const CacheReadReportSchema: Schema.Struct<{
         readonly unknownStatusCalls: Schema.Number;
         readonly collectionComplete: Schema.Boolean;
         readonly reasons: Schema.$Array<Schema.Literals<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: Schema.NullOr<Schema.String>;
+        readonly modelRole: Schema.NullOr<Schema.String>;
     }>>;
     readonly models: Schema.$Array<Schema.Struct<{
         readonly rate: Schema.Union<readonly [Schema.Struct<{
@@ -68,7 +68,7 @@ export declare const CacheReadReportSchema: Schema.Struct<{
         readonly unknownStatusCalls: Schema.Number;
         readonly collectionComplete: Schema.Boolean;
         readonly reasons: Schema.$Array<Schema.Literals<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: Schema.NullOr<Schema.String>;
+        readonly modelRole: Schema.NullOr<Schema.String>;
         readonly provider: Schema.NullOr<Schema.String>;
         readonly model: Schema.NullOr<Schema.String>;
     }>>;
@@ -76,5 +76,5 @@ export declare const CacheReadReportSchema: Schema.Struct<{
 /** Complete per-Attempt report; unknown model identities remain null. */
 export type CacheReadReport = typeof CacheReadReportSchema.Type;
 /** A historical collection marked complete is not proof of an explicit producer seal. */
-export declare function projectCacheRead(usage: ReadableAdapterUsageAttachment | null, slots: ResolvedModelSlots | undefined, producerCompletenessKnown: boolean, absent?: "usage-not-recorded" | "source-invalid" | "adapter-usage-required"): CacheReadReport;
+export declare function projectCacheRead(usage: ReadableAdapterUsageAttachment | null, roles: ResolvedModelRoles | undefined, producerCompletenessKnown: boolean, absent?: "usage-not-recorded" | "source-invalid" | "adapter-usage-required"): CacheReadReport;
 export {};

package/dist/o11y/cache-read.d.mts

@@ -1,5 +1,5 @@
 import { Schema } from "effect";
-import type { ResolvedModelSlots } from "../model-slots.mjs";
+import type { ResolvedModelRoles } from "../model-roles.mjs";
 import type { ReadableAdapterUsageAttachment } from "../record/family/adapter-usage/schema.mjs";
 declare const Summary: Schema.Struct<{
     rate: Schema.Union<readonly [Schema.Struct<{
@@ -36,7 +36,7 @@ export declare const CacheReadReportSchema: Schema.Struct<{
         collectionComplete: Schema.Boolean;
         reasons: Schema.$Array<Schema.Literals<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: Schema.$Array<Schema.Struct<{
+    readonly roles: Schema.$Array<Schema.Struct<{
         readonly rate: Schema.Union<readonly [Schema.Struct<{
             readonly state: Schema.Literal<"exact">;
             readonly value: Schema.Number;
@@ -51,7 +51,7 @@ export declare const CacheReadReportSchema: Schema.Struct<{
         readonly unknownStatusCalls: Schema.Number;
         readonly collectionComplete: Schema.Boolean;
         readonly reasons: Schema.$Array<Schema.Literals<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: Schema.NullOr<Schema.String>;
+        readonly modelRole: Schema.NullOr<Schema.String>;
     }>>;
     readonly models: Schema.$Array<Schema.Struct<{
         readonly rate: Schema.Union<readonly [Schema.Struct<{
@@ -68,7 +68,7 @@ export declare const CacheReadReportSchema: Schema.Struct<{
         readonly unknownStatusCalls: Schema.Number;
         readonly collectionComplete: Schema.Boolean;
         readonly reasons: Schema.$Array<Schema.Literals<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: Schema.NullOr<Schema.String>;
+        readonly modelRole: Schema.NullOr<Schema.String>;
         readonly provider: Schema.NullOr<Schema.String>;
         readonly model: Schema.NullOr<Schema.String>;
     }>>;
@@ -76,5 +76,5 @@ export declare const CacheReadReportSchema: Schema.Struct<{
 /** Complete per-Attempt report; unknown model identities remain null. */
 export type CacheReadReport = typeof CacheReadReportSchema.Type;
 /** A historical collection marked complete is not proof of an explicit producer seal. */
-export declare function projectCacheRead(usage: ReadableAdapterUsageAttachment | null, slots: ResolvedModelSlots | undefined, producerCompletenessKnown: boolean, absent?: "usage-not-recorded" | "source-invalid" | "adapter-usage-required"): CacheReadReport;
+export declare function projectCacheRead(usage: ReadableAdapterUsageAttachment | null, roles: ResolvedModelRoles | undefined, producerCompletenessKnown: boolean, absent?: "usage-not-recorded" | "source-invalid" | "adapter-usage-required"): CacheReadReport;
 export {};