Class ExpertUsageLedger

Colibri-compatible long-term expert frequency plus session-local heat and recency. The on-disk format is one layer expert count row per nonzero counter, matching Colibri's .coli_usage reader.

Index

Properties

expertsPerLayer layers path

Methods

decayHeat entry flush lfruCandidate rankedCounts recordRoutes snapshot open

Properties

`Readonly`expertsPerLayer

expertsPerLayer: number

`Readonly`layers

layers: readonly number[]

`Readonly`path

path: string

Methods

decayHeat

decayHeat(): void
Returns void
- Defined in packages/inference/src/artifacts/experts/usage.ts:275

entry

entry(layer: number, expertId: number): ExpertUsageEntry
Parameters
- layer: number
- expertId: number
Returns ExpertUsageEntry
- Defined in packages/inference/src/artifacts/experts/usage.ts:192

flush

flush(): void
Persist the current profile with same-directory temp + atomic rename.

Returns void
- Defined in packages/inference/src/artifacts/experts/usage.ts:282

lfruCandidate

lfruCandidate(
layer: number,
pinnedExpertIds: readonly number[],
): ExpertLfruCandidate | null
Parameters
- layer: number
- pinnedExpertIds: readonly number[]
Returns ExpertLfruCandidate | null
- Defined in packages/inference/src/artifacts/experts/usage.ts:234

rankedCounts

rankedCounts(): ExpertUsageCount[]
Returns ExpertUsageCount[]
- Defined in packages/inference/src/artifacts/experts/usage.ts:218

recordRoutes

recordRoutes(layer: number, routes: readonly ExpertUsageRoute[]): void
Count every selected route before the execution plan deduplicates it.
Parameters
- layer: number
- routes: readonly ExpertUsageRoute[]
Returns void
- Defined in packages/inference/src/artifacts/experts/usage.ts:161

snapshot

snapshot(): ExpertUsageSnapshot
Returns ExpertUsageSnapshot
- Defined in packages/inference/src/artifacts/experts/usage.ts:201

`Static`open

open(options: ExpertUsageLedgerOptions): ExpertUsageLedger
Parameters
- options: ExpertUsageLedgerOptions
Returns ExpertUsageLedger
- Defined in packages/inference/src/artifacts/experts/usage.ts:145