feat(v0.2.2): OpenAI provider에 custom Host/Base URL 설정 추가

[luke-n-alpha]

배경

현재 naia-shell의 OpenAI provider는 API key와 model은 설정할 수 있지만 Host/Base URL override 입력란이 없다. 따라서 OpenAI-compatible API를 제공하는 원격 vLLM, 사내 gateway, Tailscale GPU 서버를 OpenAI provider로 선택해 사용할 수 없다.

vLLM provider에는 vLLM Host가 이미 있지만, 사용자가 OpenAI provider semantics 또는 OpenAI-compatible endpoint로 설정하려는 경우에도 동일한 수준의 endpoint 설정이 필요하다.

목표 (v0.2.2)

OpenAI provider 설정 화면에 선택적 Host/Base URL 필드를 추가하고, 값이 있으면 provider 요청의 base URL로 전달한다. 비어 있으면 기존 OpenAI 기본 endpoint 동작을 그대로 유지한다.

수용 조건

• OpenAI provider 선택 시 Host/Base URL 입력란이 표시된다.
• 빈 값은 기존 OpenAI 공식 endpoint를 사용한다.
• custom URL은 설정 저장·재시작 후에도 유지된다.
• URL 끝의 슬래시와 /v1 중복을 안전하게 정규화한다.
• 모델 조회 및 chat completions가 동일한 custom base URL을 사용한다.
• API key는 기존 secret 저장 경로를 유지하고 일반 config/log에 노출되지 않는다.
• provider 전환 시 stale host가 다른 provider 요청에 적용되지 않는다.
• 기존 OpenAI 및 vLLM 설정에 대한 회귀 테스트를 추가한다.
• Tailscale 원격 OpenAI-compatible 서버 시나리오를 통합 테스트한다.

재현 사례

• 서버: OpenAI-compatible vLLM
• Base URL 예시: http://100.91.187.24:11435/v1
• Model: qwen3.8-27b
• 현재 결과: OpenAI provider에 Host 입력란이 없어 endpoint를 지정할 수 없음
• 기대 결과: custom Host 저장 후 모델 조회와 채팅이 해당 endpoint로 전달됨

참고

당장 위 서버는 기존 vLLM provider의 vLLM Host를 사용하면 연결할 수 있다. 이 이슈는 OpenAI provider 자체의 endpoint override 사용성을 추가하는 범위다.

[luke-n-alpha]

구현 PR: #485\n\nOpenAI-compatible provider에 custom base URL 설정, UI/설정 저장, 요청 경로 연결, 문서 및 테스트를 추가했습니다. 병합 전 PR 검토/CI가 남아 있어 이슈는 완료 처리하지 않습니다.

[luke-n-alpha]

v0.2.3 작업 중 이 문제를 실제로 겪어 확인한 사실을 남깁니다.

회귀는 아닙니다. registry.ts 의 openai 공급자는 셸 최초 편입(e41303d5)부터 지금까지 models 가 하드코딩이었고 fetchModels 를 가진 적이 없습니다. 바뀐 것은 목록 내용뿐입니다.

다만 한 번 고쳐졌다가 되돌아간 이력이 있습니다. c7167ddd (2026-05-24, refactor(llm): thin adapter — provider data from naia-agent, no hardcoded pricing) 가 공급자 카탈로그를 @nextain/agent-providers 에서 받아오게 만들어 하드코딩을 없앴습니다. 그 커밋은 현재 main 에 없고 backup/pre-jikime-rollback-2026-05-29 등 일부 브랜치에만 남아 있으며, packages/agent-providers 도 없습니다.

이 이슈를 구현할 때 그 접근(카탈로그를 에이전트에서 받기)을 되살릴지, 아니면 openai 공급자에 호스트 입력만 더할지 먼저 정하는 편이 좋겠습니다. 전자면 #533 도 함께 해소됩니다.

진단이 오래 걸린 원인 하나를 덧붙입니다. 호스트를 넣어도 목록이 비어 보이는데 오류가 안 뜹니다. 서버가 CORS 헤더를 주지 않으면 웹뷰에서 차단되고, fetchModels 가 예외를 삼켜 null 을 반환하기 때문입니다. curl 로는 되고 셸에서만 안 되는 상태가 되어 서버를 의심하기 어렵습니다. 연결 실패와 빈 목록을 구분해 보여주면 좋겠습니다.

🤖 Written with AI assistance. If anything looks off, please ping @luke-n-alpha or open a discussion.