Files
steipete--codexbar/Sources/CodexBarCLI/CLICostCommand.swift
T
2026-07-13 12:22:33 +08:00

511 lines
19 KiB
Swift

import CodexBarCore
import Commander
import Foundation
extension CodexBarCLI {
private static let costSupportedProviders: Set<UsageProvider> = [.claude, .codex]
static func runCost(_ values: ParsedValues) async {
let output = CLIOutputPreferences.from(values: values)
let config = CodexBarCLI.loadConfig(output: output)
let selection = CodexBarCLI.decodeProvider(from: values, config: config)
let providers = Self.costProviders(from: selection)
let unsupported = selection.asList.filter { !Self.costSupportedProviders.contains($0) }
if !unsupported.isEmpty {
let names = unsupported
.map { ProviderDescriptorRegistry.descriptor(for: $0).metadata.displayName }
.sorted()
.joined(separator: ", ")
if !output.jsonOnly {
Self.writeStderr("Skipping providers without local cost usage: \(names)\n")
}
}
guard !providers.isEmpty else {
Self.exit(
code: .failure,
message: "Error: cost is only supported for Claude and Codex.",
output: output,
kind: .args)
}
let format = output.format
let forceRefresh = values.flags.contains("refresh")
let useColor = Self.shouldUseColor(noColor: values.flags.contains("noColor"), format: format)
let historyDays = Self.decodeCostHistoryDays(from: values)
let groupBy = Self.decodeCostGroupBy(from: values)
if groupBy == .project {
let unsupportedProjectProviders = providers.filter { $0 != .codex }
if !unsupportedProjectProviders.isEmpty, !output.jsonOnly {
let names = unsupportedProjectProviders
.map { ProviderDescriptorRegistry.descriptor(for: $0).metadata.displayName }
.sorted()
.joined(separator: ", ")
Self.writeStderr("Skipping project grouping for providers without Codex project data: \(names)\n")
}
}
let fetcher = CostUsageFetcher()
var sections: [String] = []
var payload: [CostPayload] = []
var exitCode: ExitCode = .success
for provider in providers where groupBy != .project || provider == .codex || format == .json {
do {
// Cost usage is local-only; it does not require web/CLI provider fetches.
let snapshot = try await fetcher.loadTokenSnapshot(
provider: provider,
forceRefresh: forceRefresh,
historyDays: historyDays,
refreshPricingInBackground: false)
switch format {
case .text:
sections.append(Self.renderCostText(
provider: provider,
snapshot: snapshot,
groupBy: groupBy,
useColor: useColor))
case .json:
payload.append(Self.makeCostPayload(provider: provider, snapshot: snapshot, error: nil))
}
} catch {
exitCode = Self.mapError(error)
if format == .json {
payload.append(Self.makeCostPayload(provider: provider, snapshot: nil, error: error))
} else if !output.jsonOnly {
Self.writeStderr("Error: \(error.localizedDescription)\n")
}
}
}
switch format {
case .text:
if !sections.isEmpty {
print(sections.joined(separator: "\n\n"))
}
case .json:
if !payload.isEmpty {
Self.printJSON(payload, pretty: output.pretty)
}
}
Self.exit(code: exitCode, output: output, kind: exitCode == .success ? .runtime : .provider)
}
enum CostGroupBy: String {
case none
case project
}
static func renderCostText(
provider: UsageProvider,
snapshot: CostUsageTokenSnapshot,
groupBy: CostGroupBy = .none,
useColor: Bool) -> String
{
let name = ProviderDescriptorRegistry.descriptor(for: provider).metadata.displayName
let header = Self.costHeaderLine("\(name) Cost (API-rate estimate)", useColor: useColor)
if groupBy == .project, provider == .codex {
return Self.renderProjectCostText(header: header, snapshot: snapshot)
}
let todayCost = snapshot.sessionCostUSD
.map { UsageFormatter.currencyString($0, currencyCode: snapshot.currencyCode) } ?? "—"
let todayTokens = snapshot.sessionTokens.map { UsageFormatter.tokenCountString($0) }
let todayLine = todayTokens.map { "Today: \(todayCost) · \($0) tokens" } ?? "Today: \(todayCost)"
let monthCost = snapshot.last30DaysCostUSD
.map { UsageFormatter.currencyString($0, currencyCode: snapshot.currencyCode) } ?? "—"
let monthTokens = snapshot.last30DaysTokens.map { UsageFormatter.tokenCountString($0) }
let historyLabel = snapshot.historyLabel
?? (snapshot.historyDays == 1 ? "Today" : "Last \(snapshot.historyDays) days")
let monthLine = monthTokens.map {
"\(historyLabel): \(monthCost) · \($0) tokens"
} ?? "\(historyLabel): \(monthCost)"
let hintLine = UsageFormatter.costEstimateHint(provider: provider)
return [header, todayLine, monthLine, hintLine].joined(separator: "\n")
}
private static func renderProjectCostText(header: String, snapshot: CostUsageTokenSnapshot) -> String {
let historyLabel = snapshot.historyLabel
?? (snapshot.historyDays == 1 ? "Today" : "Last \(snapshot.historyDays) days")
var lines = [header, "Projects (\(historyLabel)):"]
guard !snapshot.projects.isEmpty else {
lines.append("—")
lines.append(UsageFormatter.costEstimateHint(provider: .codex))
return lines.joined(separator: "\n")
}
for project in snapshot.projects {
let cost = project.totalCostUSD
.map { UsageFormatter.currencyString($0, currencyCode: snapshot.currencyCode) } ?? "—"
let tokens = project.totalTokens.map { UsageFormatter.tokenCountString($0) }
let summary = tokens.map { "\(cost) · \($0) tokens" } ?? cost
lines.append("\(project.name): \(summary)")
if let path = project.path {
lines.append(" \(path)")
}
for source in project.sources {
let sourceCost = source.totalCostUSD
.map { UsageFormatter.currencyString($0, currencyCode: snapshot.currencyCode) } ?? "—"
let sourceTokens = source.totalTokens.map { UsageFormatter.tokenCountString($0) }
let sourceSummary = sourceTokens.map { "\(sourceCost) · \($0) tokens" } ?? sourceCost
lines.append(" - \(source.name): \(sourceSummary)")
if let path = source.path {
lines.append(" \(path)")
}
}
}
lines.append(UsageFormatter.costEstimateHint(provider: .codex))
return lines.joined(separator: "\n")
}
private static func costHeaderLine(_ header: String, useColor: Bool) -> String {
guard useColor else { return header }
return "\u{001B}[1;36m\(header)\u{001B}[0m"
}
static func costProviders(from selection: ProviderSelection) -> [UsageProvider] {
selection.asList.filter { Self.costSupportedProviders.contains($0) }
}
static func makeCostPayload(
provider: UsageProvider,
snapshot: CostUsageTokenSnapshot?,
error: Error?) -> CostPayload
{
let daily = snapshot?.daily.map(Self.costDailyPayload(from:)) ?? []
let projects = provider == .codex
? snapshot?.projects.map { project in
CostProjectPayload(
name: project.name,
path: project.path,
totalTokens: project.totalTokens,
totalCostUSD: project.totalCostUSD,
daily: project.daily.map(Self.costDailyPayload(from:)),
modelBreakdowns: project.modelBreakdowns?.map(Self.costModelBreakdownPayload(from:)),
sources: project.sources.map { source in
CostProjectSourcePayload(
name: source.name,
path: source.path,
totalTokens: source.totalTokens,
totalCostUSD: source.totalCostUSD,
daily: source.daily.map(Self.costDailyPayload(from:)),
modelBreakdowns: source.modelBreakdowns?.map(Self.costModelBreakdownPayload(from:)))
})
} ?? []
: []
return CostPayload(
provider: provider.rawValue,
source: "local",
updatedAt: snapshot?.updatedAt ?? (error == nil ? nil : Date()),
currencyCode: snapshot?.currencyCode,
sessionTokens: snapshot?.sessionTokens,
sessionCostUSD: snapshot?.sessionCostUSD,
historyDays: snapshot?.historyDays,
last30DaysTokens: snapshot?.last30DaysTokens,
last30DaysCostUSD: snapshot?.last30DaysCostUSD,
daily: daily,
projects: projects,
totals: snapshot.flatMap(Self.costTotals(from:)),
error: error.map { Self.makeErrorPayload($0) })
}
private static func costDailyPayload(from entry: CostUsageDailyReport.Entry) -> CostDailyEntryPayload {
CostDailyEntryPayload(
date: entry.date,
inputTokens: entry.inputTokens,
outputTokens: entry.outputTokens,
cacheReadTokens: entry.cacheReadTokens,
cacheCreationTokens: entry.cacheCreationTokens,
totalTokens: entry.totalTokens,
costUSD: entry.costUSD,
modelsUsed: entry.modelsUsed,
modelBreakdowns: entry.modelBreakdowns?.map(self.costModelBreakdownPayload(from:)))
}
private static func costModelBreakdownPayload(
from breakdown: CostUsageDailyReport.ModelBreakdown) -> CostModelBreakdownPayload
{
CostModelBreakdownPayload(
modelName: breakdown.modelName,
costUSD: breakdown.costUSD,
totalTokens: breakdown.totalTokens)
}
private static func costTotals(from snapshot: CostUsageTokenSnapshot) -> CostTotalsPayload? {
let entries = snapshot.daily
guard !entries.isEmpty else {
guard snapshot.last30DaysTokens != nil || snapshot.last30DaysCostUSD != nil else { return nil }
return CostTotalsPayload(
totalInputTokens: nil,
totalOutputTokens: nil,
cacheReadTokens: nil,
cacheCreationTokens: nil,
totalTokens: snapshot.last30DaysTokens,
totalCostUSD: snapshot.last30DaysCostUSD)
}
var totalInput = 0
var totalOutput = 0
var totalCacheRead = 0
var totalCacheCreation = 0
var totalTokens = 0
var totalCost = 0.0
var sawInput = false
var sawOutput = false
var sawCacheRead = false
var sawCacheCreation = false
var sawTokens = false
var sawCost = false
for entry in entries {
if let input = entry.inputTokens {
totalInput += input
sawInput = true
}
if let output = entry.outputTokens {
totalOutput += output
sawOutput = true
}
if let cacheRead = entry.cacheReadTokens {
totalCacheRead += cacheRead
sawCacheRead = true
}
if let cacheCreation = entry.cacheCreationTokens {
totalCacheCreation += cacheCreation
sawCacheCreation = true
}
if let tokens = entry.totalTokens {
totalTokens += tokens
sawTokens = true
}
if let cost = entry.costUSD {
totalCost += cost
sawCost = true
}
}
// Prefer totals derived from daily rows; fall back to snapshot aggregates when rows omit fields.
return CostTotalsPayload(
totalInputTokens: sawInput ? totalInput : nil,
totalOutputTokens: sawOutput ? totalOutput : nil,
cacheReadTokens: sawCacheRead ? totalCacheRead : nil,
cacheCreationTokens: sawCacheCreation ? totalCacheCreation : nil,
totalTokens: sawTokens ? totalTokens : snapshot.last30DaysTokens,
totalCostUSD: sawCost ? totalCost : snapshot.last30DaysCostUSD)
}
private static func decodeCostHistoryDays(from values: ParsedValues) -> Int {
guard let raw = values.options["days"]?.last,
let parsed = Int(raw)
else { return 30 }
return max(1, min(365, parsed))
}
private static func decodeCostGroupBy(from values: ParsedValues) -> CostGroupBy {
guard let raw = values.options["groupBy"]?.last?.trimmingCharacters(in: .whitespacesAndNewlines),
!raw.isEmpty
else { return .none }
return CostGroupBy(rawValue: raw.lowercased()) ?? .none
}
}
struct CostOptions: CommanderParsable {
@Flag(names: [.short("v"), .long("verbose")], help: "Enable verbose logging")
var verbose: Bool = false
@Flag(name: .long("json-output"), help: "Emit machine-readable logs")
var jsonOutput: Bool = false
@Option(name: .long("log-level"), help: "Set log level (trace|verbose|debug|info|warning|error|critical)")
var logLevel: String?
@Option(
name: .long("provider"),
help: ProviderHelp.optionHelp)
var provider: ProviderSelection?
@Option(name: .long("format"), help: "Output format: text | json")
var format: OutputFormat?
@Flag(name: .long("json"), help: "")
var jsonShortcut: Bool = false
@Flag(name: .long("json-only"), help: "Emit JSON only (suppress non-JSON output)")
var jsonOnly: Bool = false
@Flag(name: .long("pretty"), help: "Pretty-print JSON output")
var pretty: Bool = false
@Flag(name: .long("no-color"), help: "Disable ANSI colors in text output")
var noColor: Bool = false
@Flag(name: .long("refresh"), help: "Force refresh by ignoring cached scans")
var refresh: Bool = false
@Option(name: .long("days"), help: "Cost history window in days (1...365)")
var days: Int?
@Option(name: .long("group-by"), help: "Group text output by: project")
var groupBy: String?
}
struct CostPayload: Encodable, Sendable {
let provider: String
let source: String
let updatedAt: Date?
let currencyCode: String?
let sessionTokens: Int?
let sessionCostUSD: Double?
let historyDays: Int?
let last30DaysTokens: Int?
let last30DaysCostUSD: Double?
let daily: [CostDailyEntryPayload]
let projects: [CostProjectPayload]
let totals: CostTotalsPayload?
let error: ProviderErrorPayload?
init(
provider: String,
source: String,
updatedAt: Date?,
currencyCode: String? = nil,
sessionTokens: Int?,
sessionCostUSD: Double?,
historyDays: Int?,
last30DaysTokens: Int?,
last30DaysCostUSD: Double?,
daily: [CostDailyEntryPayload],
projects: [CostProjectPayload] = [],
totals: CostTotalsPayload?,
error: ProviderErrorPayload?)
{
self.provider = provider
self.source = source
self.updatedAt = updatedAt
self.currencyCode = currencyCode
self.sessionTokens = sessionTokens
self.sessionCostUSD = sessionCostUSD
self.historyDays = historyDays
self.last30DaysTokens = last30DaysTokens
self.last30DaysCostUSD = last30DaysCostUSD
self.daily = daily
self.projects = projects
self.totals = totals
self.error = error
}
}
struct CostDailyEntryPayload: Encodable, Sendable {
let date: String
let inputTokens: Int?
let outputTokens: Int?
let cacheReadTokens: Int?
let cacheCreationTokens: Int?
let totalTokens: Int?
let costUSD: Double?
let modelsUsed: [String]?
let modelBreakdowns: [CostModelBreakdownPayload]?
private enum CodingKeys: String, CodingKey {
case date
case inputTokens
case outputTokens
case cacheReadTokens
case cacheCreationTokens
case totalTokens
case costUSD = "totalCost"
case modelsUsed
case modelBreakdowns
}
}
struct CostModelBreakdownPayload: Encodable, Sendable {
let modelName: String
let costUSD: Double?
let totalTokens: Int?
private enum CodingKeys: String, CodingKey {
case modelName
case costUSD = "cost"
case totalTokens
}
}
struct CostProjectPayload: Encodable, Sendable {
let name: String
let path: String?
let totalTokens: Int?
let totalCostUSD: Double?
let daily: [CostDailyEntryPayload]
let modelBreakdowns: [CostModelBreakdownPayload]?
let sources: [CostProjectSourcePayload]
private enum CodingKeys: String, CodingKey {
case name
case path
case totalTokens
case totalCostUSD = "totalCost"
case daily
case modelBreakdowns
case sources
}
init(
name: String,
path: String?,
totalTokens: Int?,
totalCostUSD: Double?,
daily: [CostDailyEntryPayload],
modelBreakdowns: [CostModelBreakdownPayload]?,
sources: [CostProjectSourcePayload] = [])
{
self.name = name
self.path = path
self.totalTokens = totalTokens
self.totalCostUSD = totalCostUSD
self.daily = daily
self.modelBreakdowns = modelBreakdowns
self.sources = sources
}
}
struct CostProjectSourcePayload: Encodable, Sendable {
let name: String
let path: String?
let totalTokens: Int?
let totalCostUSD: Double?
let daily: [CostDailyEntryPayload]
let modelBreakdowns: [CostModelBreakdownPayload]?
private enum CodingKeys: String, CodingKey {
case name
case path
case totalTokens
case totalCostUSD = "totalCost"
case daily
case modelBreakdowns
}
}
struct CostTotalsPayload: Encodable, Sendable {
let totalInputTokens: Int?
let totalOutputTokens: Int?
let cacheReadTokens: Int?
let cacheCreationTokens: Int?
let totalTokens: Int?
let totalCostUSD: Double?
private enum CodingKeys: String, CodingKey {
case totalInputTokens = "inputTokens"
case totalOutputTokens = "outputTokens"
case cacheReadTokens
case cacheCreationTokens
case totalTokens
case totalCostUSD = "totalCost"
}
}
// Intentionally empty.