Graphorin API reference v0.15.1
Graphorin API reference / @graphorin/observability / / CostSnapshot
Interface: CostSnapshot
Defined in: packages/observability/src/cost/types.ts:49
Stable
Snapshot returned by CostTracker.usage.
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
byModel | readonly | readonly { cachedReadTokens: number; cacheWriteTokens: number; callCount: number; completionTokens: number; cost: Cost | null; mixedCurrency: boolean; model: string; promptTokens: number; reasoningTokens: number; }[] | - | packages/observability/src/cost/types.ts:71 |
cachedReadTokens | readonly | number | Aggregated prompt-cache READ tokens (0 when never recorded). | packages/observability/src/cost/types.ts:55 |
cacheWriteTokens | readonly | number | Aggregated prompt-cache WRITE tokens (0 when never recorded). | packages/observability/src/cost/types.ts:57 |
callCount | readonly | number | - | packages/observability/src/cost/types.ts:58 |
completionTokens | readonly | number | - | packages/observability/src/cost/types.ts:52 |
cost | readonly | Cost | null | Aggregated cost in WHOLE currency units (for USD - dollars, fractional values expected). Same convention as core Cost.amount and @graphorin/pricing.calculateCost - never minor units. | packages/observability/src/cost/types.ts:64 |
mixedCurrency | readonly | boolean | true when records carrying differing currencies were aggregated into this snapshot. cost.amount is then a sum across currencies and must not be treated as a single clean figure. | packages/observability/src/cost/types.ts:70 |
promptTokens | readonly | number | - | packages/observability/src/cost/types.ts:51 |
reasoningTokens | readonly | number | - | packages/observability/src/cost/types.ts:53 |
totalTokens | readonly | number | - | packages/observability/src/cost/types.ts:50 |