domain

type MetaUsageParams struct {
	// MetaKey/MetaValue select the events (required).
	MetaKey   string
	MetaValue string

	// GroupByMetaKey optionally splits rows by a second meta key
	// (e.g. "gentask_id"); empty groups everything under GroupValue "".
	GroupByMetaKey string

	// ProjectID optionally narrows to one project.
	ProjectID string
}

type MetaUsageRow struct {
	GroupValue   string
	Vendor       string
	Model        string
	TokensInput  int64
	TokensOutput int64
	TokensTotal  int64
	RequestCount int64
	CostNanoUSD  int64
	// Parts of TokensInput served from and written to the prompt cache.
	CacheReadTokens  int64
	CacheWriteTokens int64
}

type Status int

type SummaryParams struct {
	From time.Time
	To   time.Time

	// Filters
	ProjectID string
	UserID    string
	Vendor    string
	Model     string
	ActionID  string
	Status    Status

	// Group by dimensions (day is always included)
	GroupByProjectID bool
	GroupByUserID    bool
	GroupByVendor    bool
	GroupByModel     bool
	GroupByActionID  bool
	GroupByStatus    bool
}

type SummaryRow struct {
	Bucket time.Time

	// Dimension values (only populated if grouped by)
	ProjectID string
	UserID    string
	Vendor    string
	Model     string
	ActionID  string
	Status    Status

	// Aggregated values
	TokensInput   int64
	TokensOutput  int64
	TokensTotal   int64
	RequestCount  int64
	SumDurationMs int64
	CostNanoUSD   int64
	// Parts of TokensInput served from and written to the prompt cache.
	CacheReadTokens  int64
	CacheWriteTokens int64
}

type UsageEvent struct {
	EventID          uuid.UUID
	CreatedAt        time.Time
	OccurredAt       *time.Time
	UserID           string
	ProjectID        string
	ActionID         string
	Vendor           string
	Model            string
	Status           Status
	DurationMs       int64
	TokensInput      int64
	TokensOutput     int64
	TokensTotal      int64
	ErrorClass       string
	VendorHTTPStatus int32
	Meta             map[string]string
	CostNanoUSD      int64
	// Prompt-cache tokens, both part of TokensInput: read from the vendor's
	// cache, and written to it, each priced differently from plain input.
	CacheReadTokens  int64
	CacheWriteTokens int64
	// A tool call through an MCP gateway; empty and 0 for an LLM call.
	ToolServer    string
	ToolName      string
	ResponseBytes int64
}