Function buildModelChoices

src/setup/wizard.ts:443–485

(
  hw: HardwareProfile,
  detected: DetectedModel[],
  apiModels: ApiCatalogModel[] = [],
)

}

export function buildModelChoices(
  hw: HardwareProfile,
  detected: DetectedModel[],
  apiModels: ApiCatalogModel[] = [],
): Array<{ value: string; label: string; hint?: string }> {
  const choices: Array<{ value: string; label: string; hint?: string }> = [];
  const seen = new Set<string>();

  // 1. Detected — these are guaranteed working
  for (const m of detected) {
    if (seen.has(m.id)) continue;
    seen.add(m.id);
    const f = formatModel(m);
    choices.push({ value: m.id, label: f.label, hint: `installed · ${f.hint}` });
  }

  // 1b. Models from configured custom APIs (provider/id form so routing is unambiguous).
  for (const m of apiModels) {
    const value = `${m.provider}/${m.id}`;
    if (seen.has(value)) continue;
    seen.add(value);
    const ctx = m.contextWindow ? ` · ${Math.round(m.contextWindow / 1000)}k ctx` : '';
    choices.push({ value, label: value, hint: `API · ${m.provider}${ctx}` });
  }

  // 2. Hardware-tier recommendations — not yet installed, will need a pull
  for (const m of hw.recommendedModels) {
    if (seen.has(m)) continue;
    seen.add(m);
    const fitNote = isModelComfortableForHardware(m, hw) ? '✓ comfortable' : 'tight — may swap';
    choices.push({
      value: m,
      label: `${m}`,
      hint: `requires \`ollama pull\` · ${fitNote}`,
    });
  }

  // 3. Cloud options — always listed last
  choices.push({ value: 'claude-sonnet-4-6', label: 'claude-sonnet-4-6', hint: 'cloud, needs ANTHROPIC_API_KEY' });
  choices.push({ value: 'gpt-4o-mini', label: 'gpt-4o-mini', hint: 'cloud, needs OPENAI_API_KEY' });
  choices.push({ value: 'deepseek-coder', label: 'deepseek-coder', hint: 'cloud, needs DEEPSEEK_API_KEY' });
  return choices;
}

/** Whether a given model id is comfortable on this hardware. Heuristic. */
function isModelComfortableForHardware(modelId: string, hw: HardwareProfile): boolean {