AI configuration

ai: {
  text: {
    provider: 'openai-compatible',
    baseURL: 'http://my-server:11434/v1', // e.g. Ollama
    model: 'gemma3',
    // apiKey optional — self-hosted endpoints often run keyless
  },
}

ai: {
  packageName: 'Systhema AI Pro',
  text: {
    models: [
      { provider: 'openai', model: 'gpt-5.5', apiKey: process.env.OPENAI_API_KEY, label: 'GPT-5.5' },
      { provider: 'openai', model: 'gpt-5-mini', apiKey: process.env.OPENAI_API_KEY, label: 'GPT-5 mini' },
      // A showcase teaser — shown disabled with the hint, never usable:
      { provider: 'anthropic', model: 'claude-opus-4-8', label: 'Claude Opus 4.8', locked: true, upgradeHint: 'Upgrade to Max' },
    ],
  },
  image: {
    models: [
      { provider: 'openai', model: 'gpt-image-2' }, // reuses the OpenAI text key
      { provider: 'google', model: 'gemini-3-pro-image', label: 'Nano Banana Pro', locked: true, upgradeHint: 'Upgrade to Max' },
    ],
  },
  quota: { credits: 5000 },
}

ai?: false | {
  enabled?: boolean
  packageName?: string       // optional plan label (e.g. "Systhema AI Pro"); shown on the usage widget + in the "limit reached" message
  text?: {
    provider?: 'openai' | 'anthropic' | 'google' | 'groq' | 'openai-compatible'
    model?: string           // default: per-provider; required for 'openai-compatible'
    apiKey?: string          // forward from your env; required except for 'openai-compatible'
    baseURL?: string         // required for 'openai-compatible' (setting it implies the provider)
    reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' // OpenAI-only; default: the model's own default
    models?: Array<{         // multi-model: when set, the flat fields above are ignored
      provider?: 'openai' | 'anthropic' | 'google' | 'groq' | 'openai-compatible'
      model?: string
      apiKey?: string
      baseURL?: string
      label?: string         // picker label; default: the model id
      locked?: boolean       // showcase-only upgrade teaser (disabled, no key needed)
      upgradeHint?: string   // hint shown beside a locked entry, e.g. 'Upgrade to Pro'
      reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' // OpenAI-only, per-model
    }>
  }
  image?: false | {
    provider?: 'openai' | 'google'
    model?: string           // default: 'gpt-image-1' / 'imagen-4.0-fast-generate-001'
    apiKey?: string          // default: reuses text.apiKey when text runs on the same provider
    models?: Array<{         // multi-model image models (same shape, no baseURL)
      provider?: 'openai' | 'google'
      model?: string
      apiKey?: string
      label?: string
      locked?: boolean
      upgradeHint?: string
    }>
  }
  compose?: {
    collections?: string[]   // allowlist; default: all eligible collections
    excludeFields?: string[] // extra field names to skip
  }
  languages?: string[]       // translate targets; default: common European languages
  quota?: {
    text?: number | 'unlimited'   // text generations per period; 0 = not included; default unlimited
    image?: number | 'unlimited'  // image generations per period
    credits?: number | 'unlimited' // pooled credit budget per period; set this to switch to credit mode (supersedes text/image counts)
    creditValue?: number          // USD per credit (hidden); default 0.001 ⇒ a $5 budget is 5,000 credits
    period?: {
      interval?: 'month' | 'year' // default 'month'
      every?: number              // bill every N intervals (2 = bimonthly); default 1
      startDay?: number           // day of month the period starts (1–28); default 1
      start?: string              // ISO anchor date for multi-month/yearly cycles
    }
  }
  pricing?: {                // cost-estimation overrides (merged over built-in list prices)
    text?: Record<string, { input: number; output: number }>  // USD per 1M tokens
    image?: Record<string, number>                            // USD per image
  }
}