usage

type Detail struct {
	InputTokens         int64
	OutputTokens        int64
	ReasoningTokens     int64
	CachedTokens        int64
	CacheReadTokens     int64
	CacheCreationTokens int64
	TotalTokens         int64
}

type Failure struct {
	StatusCode int
	Body       string
}

type Manager struct {
	// contains filtered or unexported fields
}

type Plugin interface {
	HandleUsage(ctx context.Context, record Record)
}

type Record struct {
	Provider string
	// ExecutorType stores the concrete executor type that handled the request.
	// Plugin sinks use this to attribute traffic to a specific executor
	// implementation (e.g. "gemini-cli", "claude-cli", "codex-ws").
	ExecutorType string
	Model        string
	Alias        string
	APIKey       string
	AuthID       string
	AuthIndex    string
	// AuthType stores the credential type that backed the request (e.g.
	// "oauth", "api-key"). Empty means the value was not captured.
	AuthType string
	Source   string
	// ReasoningEffort stores the translated upstream thinking level for request event logs.
	ReasoningEffort string
	// ServiceTier stores the client-requested service tier for request event logs.
	ServiceTier string
	RequestedAt time.Time
	Latency     time.Duration
	// FirstByteLatency / APIFirstByteLatency preserve the fork's historical
	// TTFB measurements for the file-backed usage logger and are kept populated
	// alongside TTFT below for compatibility with both fork and upstream sinks.
	FirstByteLatency    time.Duration
	APIFirstByteLatency time.Duration
	// TTFT is the upstream-aligned time-to-first-token duration used by plugin
	// usage sinks. It mirrors FirstByteLatency semantically.
	TTFT time.Duration
	// Failed flags a terminal failure for the request. Both Failed and Fail
	// carry failure information: Failed is the boolean summary, Fail carries
	// structured HTTP status/body detail when available.
	Failed bool
	Fail   Failure
	// ChunkCount tracks the number of stream chunks observed for the request.
	ChunkCount int64
	// ResponseBytes / APIResponseBytes preserve the fork's byte counters.
	ResponseBytes    int64
	APIResponseBytes int64
	Detail           Detail
	// ResponseHeaders stores a snapshot of upstream response headers for usage sinks.
	ResponseHeaders http.Header
}