budget

type CheckResult struct {
	// Stats is today's aggregated usage.
	Stats DailyStats

	// USDExceeded is true when DailyUSDLimit > 0 and today's USD spend >= limit.
	USDExceeded bool
	// TokensExceeded is true when DailyTokenLimit > 0 and today's tokens >= limit.
	TokensExceeded bool

	// USDRemaining is the remaining USD budget (negative when exceeded). 0 when no limit.
	USDRemaining float64
	// TokensRemaining is the remaining token budget (negative when exceeded). 0 when no limit.
	TokensRemaining int

	// ThresholdAlertUSD fires when USD spend crosses AlertThresholdPct but is not yet exceeded.
	ThresholdAlertUSD bool
	// ThresholdAlertTokens fires when token count crosses AlertThresholdPct but is not yet exceeded.
	ThresholdAlertTokens bool
}

type DailyStats struct {
	TotalTokens int
	TotalUSD    float64
	EntryCount  int
}

type Limits struct {
	// DailyUSD and DailyTokens are the project's daily caps, each the lower of
	// its own setting and its percentage of the global limit.
	DailyUSD    float64
	DailyTokens int
	// GlobalDailyUSD and GlobalDailyTokens are the host-wide caps, across
	// every project.
	GlobalDailyUSD    float64
	GlobalDailyTokens int
}