기본 제공자 설정(핫 스왑)

PUT /v1/auth/preferred-provider

기본 제공자 재정의를 설정하거나 해제합니다. 저장하기 전에 선택한 자격 증명을 실시간으로 확인하며, 프로필은 구성됐지만 자격 증명이 오래된 경우 400 reauth_required를 반환합니다.

성공 시 프로세스 내 핫 스왑도 수행합니다. selectProvider + createLLMClient로 새 제공자의 LLM 클라이언트를 다시 만들고, 단일 기준인 LLMRouter를 원자적으로 갱신합니다. 장기 실행 소비자(Minara, ScenarioClassifier, ChartBuilder 등)는 라이브 Proxy를 받고 다음 createMessage에서 새 클라이언트를 사용합니다. Minara는 턴 시작 시 클라이언트 스냅샷을 보관하므로, 스왑 시점에 진행 중인 턴은 이전 제공자에서 마무리되어 대화가 분할되지 않습니다. 다음 턴부터 새 제공자를 사용합니다.

모델은 defaultModelForProvider(newKind)로 자동 선택됩니다. 모델 ID가 제공자별 범위를 가지기 때문입니다(grok-4는 xAI 전용, gpt-5는 OpenAI 전용). 새 모델은 새 제공자를 키로 하는 defaultModel 슬롯에 저장되므로 다음 게이트웨이 부팅도 같은 조합으로 시작합니다.

응답은 { ok, preferredProvider, activeModel, swapped, inflightOnOldProvider }입니다. swapped: false는 기본 설정은 저장됐지만 프로세스 내 재구성에 실패했음을 뜻합니다(예: 프로브와 재구성 사이에 자격 증명이 사라진 경우). 다음 게이트웨이 부팅에서는 저장된 기본 설정을 사용합니다.

요청 본문

{ "provider": ProviderKind | null }