export type ProviderId =
  | "offline"
  | "openai-codex"
  | "minimax"
  | "stepfun"
  | "opencode-go"
  | "command-code"
  | "openrouter";

export type UsageWindow = "today" | "thisWeek" | "lastWeek" | "allTime";

export interface ProviderBalance {
  label: string;
  remaining: number | null;
  unit: string;
}

export type LiveStatus = "live" | "cached" | "stale" | "local" | "unavailable";
export type LiveSourceKind = "live" | "cache" | "local" | "none";

export interface LiveUsageWindow {
  key: string;
  label: string;
  usedPercent: number;
  used?: number;
  limit?: number;
  unit?: string;
  resetAt?: number;
  windowDurationMins?: number;
  unavailableReason?: string;
}

export interface ProviderUsageSnapshot {
  providerId: ProviderId;
  providerLabel: string;
  available: boolean;
  diagnostic: string;
  fetchedAt: number;
  balances: ProviderBalance[];
  status: LiveStatus;
  sourceLabel: string;
  sourceKind: LiveSourceKind;
  expiresAt?: number;
  staleAgeMs?: number;
  windows: LiveUsageWindow[];
  diagnostics: string[];
  planName?: string;
}

export type ProviderFetchStrategy = "offline" | "api";

export interface ProviderFetchOutcome {
  snapshot: ProviderUsageSnapshot;
  shouldWriteCache: boolean;
  nextRetryAt?: number;
}

export interface UsageProviderAdapter {
  id: ProviderId;
  label: string;
  strategy: ProviderFetchStrategy;
  fetch(input?: {
    force?: boolean;
    signal?: AbortSignal;
  }): Promise<ProviderFetchOutcome>;
}

export interface AggregatedUsageRow {
  key: string;
  sessionCount: number;
  messageCount: number;
  input: number;
  output: number;
  cache: number;
  cacheRead: number;
  cacheWrite: number;
  tokens: number;
  cost: number;
}

export interface AggregatedUsagePeriod {
  key: UsageWindow;
  total: AggregatedUsageRow;
  providers: AggregatedUsageRow[];
  modelsByProvider: Record<string, AggregatedUsageRow[]>;
}

export interface OfflineUsageState {
  providerId: "offline";
  totals: ProviderBalance[];
  periods: AggregatedUsagePeriod[];
  scannedFiles: number;
  messageCount: number;
}

export interface RateWindow {
  label: string;
  usedPercent: number;
  resetDescription?: string;
}

export interface CurrentUsageCompatibility {
  provider: string;
  displayName: string;
  windows: RateWindow[];
}

export interface UsageInsight {
  category?: string;
  label: string;
  cost: number;
  detail: string;
}

export interface UsageCoreState {
  refreshRequested: boolean;
  generatedAt: number;
  loading: boolean;
  offline: OfflineUsageState;
  insights: UsageInsight[];
  currentProviderId: ProviderId | null;
  currentModelLabel?: string;
  currentProviderSnapshot: ProviderUsageSnapshot | null;
  providers: ProviderUsageSnapshot[];
  diagnostics: string[];
  provider?: string;
  usage?: CurrentUsageCompatibility;
  compatibility: {
    currentLiveProviderId: ProviderId | null;
    currentLiveProviderSnapshot: ProviderUsageSnapshot | null;
  };
}

export interface UsageDashboardState {
  title: string;
  state: UsageCoreState;
}

export interface UnavailableProviderState {
  providerId: ProviderId;
  diagnostic: string;
}

export interface UsageConfig {
  providers?: Partial<Record<ProviderId, { enabled?: boolean }>>;
}