usage

Sep 10, 2026

Changes in this version

+ const CacheCreation1hTokensMetadataKey

+ const CacheCreationTokensMetadataKey

+ const TokenTypeCacheWrite

type DigestSavingsRecord

+ SubagentCacheCreation1hInputTokens int

+ SubagentCacheCreationInputTokens int

+ SubagentCachedInputTokens int

+ SubagentThoughtsTokens int

+ func (r DigestSavingsRecord) SubagentTurn() TurnUsage

type Pricing

+ CacheCreation1hInputPerMTok float64

+ CacheCreationInputPerMTok float64

+ func PriceForRefreshed(modelID string, fallback Pricing) Pricing

+ func (p Pricing) CostUSDForTurn(u TurnUsage) float64

+ func (p Pricing) CostUSDWithCacheTTLs(...) float64

+ func (p Pricing) CostUSDWithCacheWrites(uncachedInputTokens, cacheReadTokens, cacheWriteTokens, outputTokens int) float64

type Totals

+ CacheCreationInputTokens int

+ func (t Totals) UncachedInputTokens() int

type Turn

+ CacheCreationInputTokens int

+ func (t Turn) UncachedInputTokens() int

type TurnUsage

+ CacheCreation1hInputTokens int

+ CacheCreationInputTokens int

+ func TurnUsageFromMetadata(u *genai.GenerateContentResponseUsageMetadata, custom map[string]any) TurnUsage

+ func (u TurnUsage) Clamped() TurnUsage

+ func (u TurnUsage) UncachedInputTokens() int

Aug 7, 2026

Changes in this version

+ const AttrAppName

+ const AttrGenAIModel

+ const AttrGenAITokenType

+ const AttrPriced

+ const AttrSessionID

+ const AttrUserID

+ const MetricDigestSubagentCost

+ const MetricGenAITokenUsage

+ const MetricSessionCost

+ const MetricSessionDuration

+ const MetricSessionTurns

+ const TokenTypeCached

+ const TokenTypeInput

+ const TokenTypeOutput

+ const TokenTypeThought

+ const TokenTypeToolUse

+ func RegisterMetrics(mp metric.MeterProvider, tp TrackerProvider, opts ...RegisterOption) (metric.Registration, error)

type Pricing

+ Unpriced bool

+ type RegisterOption func(*registerOptions)

+ func WithoutSessionLabels() RegisterOption

+ type SingleTracker struct

+ AppName string

+ SessionID string

+ Tracker *Tracker

+ UserID string

+ func (s SingleTracker) Trackers() []TrackedSession

type Totals

+ UnpricedTurns int

+ type TrackedSession struct

+ AppName string

+ SessionID string

+ Tracker *Tracker

+ UserID string

+ type TrackerProvider interface

+ Trackers func() []TrackedSession

type Turn

+ Unpriced bool

Jul 20, 2026

Changes in this version

+ func ContextWindowSizeFor(model string) int

+ func KnownModelsCount() int

+ func RebuildTrackerFromEvents(ctx context.Context, t *Tracker, events iter.Seq2[*session.Event, error], ...) error

+ func SetCatalog(c *pricing.Catalog)

+ type DigestSavingsRecord struct

+ ParentTokensSaved int

+ Path string

+ SubagentCostUSD float64

+ SubagentInputTokens int

+ SubagentModel string

+ SubagentOutputTokens int

+ type DigestSavingsTotals struct

+ AgenticCalls int

+ AgenticSubagentCostUSD float64

+ AgenticSubagentInTokens int

+ AgenticSubagentOutTokens int

+ AgenticTokensSaved int

+ PassthroughCalls int

+ StructuralCalls int

+ StructuralTokensSaved int

+ type Pricing struct

+ CachedInputPerMTok float64

+ InputPerMTok float64

+ OutputPerMTok float64

+ UpdatedAt time.Time

+ func PriceFor(modelID string, cfg *config.Config) Pricing

+ func PriceForWithSource(modelID string, cfg *config.Config) (Pricing, string)

+ func (p Pricing) CostUSD(inputTokens, outputTokens int) float64

+ func (p Pricing) CostUSDWithCache(uncachedInputTokens, cachedInputTokens, outputTokens int) float64

+ func (p Pricing) IsZero() bool

+ type Totals struct

+ CachedInputTokens int

+ CostUSD float64

+ InputTokens int

+ OutputTokens int

+ ThoughtsTokens int

+ ToolUseTokens int

+ Turns int

+ type Tracker struct

+ func NewTracker() *Tracker

+ func (t *Tracker) All() []Turn

+ func (t *Tracker) Append(model string, inputTokens, outputTokens int, p Pricing) Turn

+ func (t *Tracker) AppendDigestSavings(rec DigestSavingsRecord)

+ func (t *Tracker) AppendUsage(model string, u TurnUsage, p Pricing) Turn

+ func (t *Tracker) ContextWindowSize() int

+ func (t *Tracker) ContextWindowUsed() int

+ func (t *Tracker) DigestSavings() DigestSavingsTotals

+ func (t *Tracker) Duration() time.Duration

+ func (t *Tracker) Last() (Turn, bool)

+ func (t *Tracker) SetOnAppend(f func())

+ func (t *Tracker) Totals() Totals

+ func (t *Tracker) TotalsByModel() map[string]Totals

+ type Turn struct

+ At time.Time

+ CachedInputTokens int

+ CostUSD float64

+ InputTokens int

+ Model string

+ OutputTokens int

+ ThoughtsTokens int

+ ToolUseTokens int

+ type TurnTap struct

+ func (t *TurnTap) Commit(ev *session.Event) (TurnUsage, bool)

+ func (t *TurnTap) Observe(ev *session.Event)

+ func (t *TurnTap) Peek() TurnUsage

+ type TurnUsage struct

+ CachedInputTokens int

+ InputTokens int

+ OutputTokens int

+ ThoughtsTokens int

+ ToolUseTokens int

+ func TurnUsageFromGenaiMetadata(u *genai.GenerateContentResponseUsageMetadata) TurnUsage