Interface MetadataStats

HF/api/lib/metadata.ts:154–217

// ── Query: Aggregated Stats ──────────────────────────────────────────

export interface MetadataStats {
  total_requests: number
  since: number | null // oldest event timestamp
  uptime_ms: number

  // Breakdown by mode
  by_mode: Record<string, number>
  by_tier: Record<string, number>
  by_endpoint: Record<string, number>

  // Model usage
  models: {
    total_queries: number // sum of all individual model calls
    unique_models: number
    by_model: Record<string, {
      queries: number
      wins: number
      avg_score: number
      avg_duration_ms: number
      success_rate: number
    }>
  }

  // Pipeline usage
  pipeline: {
    godmode_rate: number // % of requests with godmode enabled
    autotune_rate: number
    parseltongue_rate: number
    stm_usage: Record<string, number> // module -> count
    strategy_usage: Record<string, number>
  }

  // Context detection (from autotune)
  contexts: Record<string, number>

  // Latency
  latency: {
    avg_ms: number
    p50_ms: number
    p95_ms: number
    p99_ms: number
  }

  // Response sizes
  response_lengths: {
    avg: number
    p50: number
    p95: number
  }

  // Streaming
  streaming: {
    stream_rate: number // % of requests that used streaming
    avg_upgrades: number // avg leader changes per stream
    avg_first_response_ms: number // avg time to first leader
  }

  // Errors