Function interactiveAddProvider

src/setup/provider-add-interactive.ts:36–153

(preselectId?: string)

 * the Groq key while still using the friendly key-prompt + auto-wire path.
 */
export async function interactiveAddProvider(preselectId?: string): Promise<InteractiveAddResult | null> {
  const opts: PromptOptions = { interactive: isInteractiveTTY() };
  if (!opts.interactive) {
    throw new Error('Interactive add needs a TTY. Use: qodex provider add <id> --base-url <url> --key-env <ENV> [--model <id>]');
  }

  // 1. Resolve the gateway — either preselected or chosen from the list.
  let spec: GatewaySpec | undefined;
  let customName = '';
  let customBaseUrl = '';
  let customKeyEnv = '';

  if (preselectId && findGateway(preselectId)) {
    spec = findGateway(preselectId);
  } else if (preselectId) {
    // A name we don't know — treat it as a custom provider. If the user passed a
    // URL (`provider add https://api.x.com/v1`), use it as the base URL and derive
    // a valid slug name from its host; otherwise slugify the given name.
    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(preselectId.trim())) {
      customBaseUrl = preselectId.trim();
    }
    customName = slugifyProviderName(preselectId);
  } else {
    const ids = listGatewayIds();
    const choices = [
      ...ids.map(id => {
        const g = KNOWN_GATEWAYS[id]!;
        return { value: id, label: g.title, hint: g.baseUrl };
      }),
      { value: CUSTOM_SENTINEL, label: 'Something else (custom OpenAI-compatible endpoint)', hint: 'enter base URL yourself' },
    ];
    const picked = await choose('\nWhich provider do you want to add?', choices, ids[0]!, opts);
    if (picked === CUSTOM_SENTINEL) {
      customName = slugifyProviderName(await text('  Provider name (one word, e.g. "myhost")', '', opts));
      if (!customName) { console.log('  ✗ Cancelled — no name given.'); return null; }
    } else {
      spec = findGateway(picked);
    }
  }

  // 2. For a custom provider, gather base URL + derive the env var name.
  if (!spec) {
    if (!customBaseUrl) {
      customBaseUrl = (await text('  OpenAI-compatible base URL (…/v1)', '', opts)).trim();
      if (!customBaseUrl) { console.log('  ✗ Cancelled — no base URL given.'); return null; }
    }
    customKeyEnv = `${customName.toUpperCase().replace(/[^A-Z0-9]/g, '_')}_API_KEY`;
  }

  const name = spec ? spec.name : customName;
  const apiKeyEnv = spec ? spec.apiKeyEnv : customKeyEnv;
  const title = spec ? spec.title : name;

  // If the provider came from the interactive menu (not a `provider add <id>` argument), confirm
  // the pick before doing anything. This catches the case where a stray Enter — e.g. from pasting
  // multiple lines into the terminal — lands on the default row and would otherwise silently
  // configure the wrong provider.
  if (!preselectId) {