Function computeTokenUsageDiff

pkg/cli/audit_diff.go:841–915

computeTokenUsageDiff computes a detailed diff of token usage between two runs using the firewall proxy token-usage.jsonl data (TokenUsageSummary). Returns nil when both summaries are nil.

(tu1, tu2 *TokenUsageSummary)

// the firewall proxy token-usage.jsonl data (TokenUsageSummary). Returns nil when both
// summaries are nil.
func computeTokenUsageDiff(tu1, tu2 *TokenUsageSummary) *TokenUsageDiff {
	if tu1 == nil && tu2 == nil {
		return nil
	}

	var (
		run1Input, run2Input           int
		run1Output, run2Output         int
		run1CacheRead, run2CacheRead   int
		run1CacheWrite, run2CacheWrite int
		run1AIC, run2AIC               float64
		run1Requests, run2Requests     int
		run1CacheEff, run2CacheEff     float64
	)

	if tu1 != nil {
		run1Input = tu1.TotalInputTokens
		run1Output = tu1.TotalOutputTokens
		run1CacheRead = tu1.TotalCacheReadTokens
		run1CacheWrite = tu1.TotalCacheWriteTokens
		run1AIC = tu1.TotalAIC
		run1Requests = tu1.TotalRequests
		run1CacheEff = tu1.CacheEfficiency
	}
	if tu2 != nil {
		run2Input = tu2.TotalInputTokens
		run2Output = tu2.TotalOutputTokens
		run2CacheRead = tu2.TotalCacheReadTokens
		run2CacheWrite = tu2.TotalCacheWriteTokens
		run2AIC = tu2.TotalAIC
		run2Requests = tu2.TotalRequests
		run2CacheEff = tu2.CacheEfficiency
	}

	diff := &TokenUsageDiff{
		Run1InputTokens:      run1Input,
		Run2InputTokens:      run2Input,
		Run1OutputTokens:     run1Output,
		Run2OutputTokens:     run2Output,
		Run1CacheReadTokens:  run1CacheRead,
		Run2CacheReadTokens:  run2CacheRead,
		Run1CacheWriteTokens: run1CacheWrite,
		Run2CacheWriteTokens: run2CacheWrite,
		Run1AIC:              run1AIC,
		Run2AIC:              run2AIC,
		Run1TotalRequests:    run1Requests,
		Run2TotalRequests:    run2Requests,
		Run1CacheEfficiency:  run1CacheEff,
		Run2CacheEfficiency:  run2CacheEff,
	}

	if run1Input > 0 || run2Input > 0 {
		diff.InputTokensChange = formatVolumeChange(run1Input, run2Input)
	}
	if run1Output > 0 || run2Output > 0 {
		diff.OutputTokensChange = formatVolumeChange(run1Output, run2Output)
	}
	if run1CacheRead > 0 || run2CacheRead > 0 {