Function missingWebKeysGuidance

src/setup/key-guidance.ts:60–70

(env: Record<string, string | undefined>)

 * the keyless engine) while content-grade backends sit unused for lack of a key. PURE.
 */
export function missingWebKeysGuidance(env: Record<string, string | undefined>): string | null {
  const { set, missing } = webKeyStatus(env);
  if (set.length > 0 || missing.length === 0) return null;   // at least one content-grade backend works
  const lines = [
    'Web search/extract is limited right now: no search API key is set, so only the keyless fallback is available.',
    'To unlock a content-grade backend (pick ONE — all have free tiers):',
    ...missing.map(k => `  • ${k.service}: ${k.url}  → ${k.env}  (${k.unlocks})`),
    'You can paste a key here in chat and I will store it safely (~/.qodex/.env) and retry — or add it to ~/.qodex/.env yourself.',
  ];
  return lines.join('\n');
}