QMAI/src/lib/has-usable-llm.ts

import type { LlmConfig, ProviderConfigs } from "@/stores/wiki-store"

export type LlmProvider = LlmConfig["provider"]

/**
 * Maps LlmConfig.provider values to their corresponding LLM_PRESETS id,
 * for providers that are gated by a single well-known preset toggle.
 */
const PRESET_ID_BY_PROVIDER: Partial<Record<LlmProvider, string>> = {
  "claude-code": "claude-code-cli",
  "codex-cli": "codex-cli",
  "ollama": "ollama-local",
}

function isPresetEnabled(providerConfigs: ProviderConfigs, presetId: string): boolean {
  const entry = providerConfigs[presetId]
  return entry?.enabled === true
}

function hasEnabledCustomPreset(providerConfigs: ProviderConfigs): boolean {
  for (const key of Object.keys(providerConfigs)) {
    if (!key.startsWith("custom-")) continue
    if (isPresetEnabled(providerConfigs, key)) return true
  }
  return false
}

/**
 * Single source of truth for "is the user's LLM configuration good
 * enough to make calls?" Replaces ad-hoc `apiKey || provider ===
 * "ollama" || …` checks scattered across ingest, sweep, lint,
 * chat, and clip-watcher — every one of which had to be edited
 * by hand whenever a new no-key provider was added, and at least
 * three of which were silently out of date when the
 * Claude Code CLI provider shipped.
 *
 * Use this everywhere a guard like "do we have an LLM?" is
 * needed; the type-level union plus the exhaustiveness test in
 * `has-usable-llm.test.ts` ensures future provider additions
 * land in exactly one bucket and don't slip through.
 */
export function hasUsableLlm(
  cfg: Pick<LlmConfig, "provider" | "apiKey" | "model">,
  providerConfigs: ProviderConfigs = {},
): boolean {
  const hasKey = cfg.apiKey.trim().length > 0
  const hasModel = cfg.model.trim().length > 0

  if (cfg.provider === "claude-code" || cfg.provider === "codex-cli") {
    const presetId = PRESET_ID_BY_PROVIDER[cfg.provider]!
    return isPresetEnabled(providerConfigs, presetId)
  }

  if (cfg.provider === "ollama") {
    return isPresetEnabled(providerConfigs, "ollama-local") && hasModel
  }

  if (cfg.provider === "custom") {
    if (hasKey && hasModel) return true
    return hasEnabledCustomPreset(providerConfigs) && hasModel
  }

  return hasKey && hasModel
}