Interface MetadataEvent

HF/api/lib/metadata.ts:27–84

// ── Types ────────────────────────────────────────────────────────────

export interface MetadataEvent {
  id: string
  timestamp: number

  // Request shape
  endpoint: string
  mode: 'standard' | 'ultraplinian'
  tier?: string // fast | standard | full (ultraplinian only)
  stream: boolean

  // Pipeline config (what was enabled, not what it produced)
  pipeline: {
    godmode: boolean
    autotune: boolean
    parseltongue: boolean
    stm_modules: string[]
    strategy?: string
  }

  // AutoTune metadata (context detection only, no content)
  autotune?: {
    detected_context: string
    confidence: number
  }

  // Model metadata
  model?: string // single-model mode
  models_queried?: number // ultraplinian
  models_succeeded?: number

  // Per-model results (no content, just numbers)
  model_results?: Array<{
    model: string
    score: number
    duration_ms: number
    success: boolean
    content_length: number
    error_type?: string // categorized: 'timeout' | 'rate_limit' | 'auth' | 'model_error' | 'empty' | 'unknown'
  }>

  // Winner metadata
  winner?: {
    model: string
    score: number
    duration_ms: number
    content_length: number
  }

  // Response metadata
  total_duration_ms: number
  response_length: number

  // Liquid Response metadata (streaming upgrades)
  liquid?: {
    upgrades: number // how many leader changes happened
    first_response_ms: number // time to first leader
  }
}