connectbase-client 5.5.0 → 5.6.1

package/CHANGELOG.md

@@ -3,6 +3,48 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [5.6.1] - 2026-08-01
+
+### Docs — `endpoint://` 터널 모델의 실질 상한 정정
+
+**동작 변경 없음** (JSDoc 문구만). 5.6.0 은 `options.timeout` 상한을 300초로 안내하면서
+"`endpoint://` 로 연결한 자체 호스팅 모델은 앞단 CDN 때문에 ~100초가 실질 상한" 이라는
+단서를 달았다. 그 사이 백엔드가 ConnectBase→터널 구간을 클러스터 내부 직결로 바꿔
+(`TUNNEL_PROXY_UPSTREAM_URL`) CDN 을 아예 거치지 않게 됐다 — 이제 이 구성도 300초를 다 쓴다.
+낡은 단서를 그대로 두면 쓸 수 있는 예산을 스스로 낮춰 잡게 되므로 정정한다.
+
+## [5.6.0] - 2026-08-01
+
+### Added — `cb.ai.chat(request, options)` 의 생성 예산 (`options.timeout`)
+
+수천~1만 토큰짜리 긴 생성이 **완성된 뒤에 통째로 버려졌다** (platform-issue 019fbb42). SDK 공통
+기본 타임아웃 30초가 AI 호출에도 그대로 걸렸고, 서버리스 함수 안의 `ctx.cb` 는 그 값을 올릴
+자리조차 없었다 — 함수의 `timeout` 을 300초로 잡아도 막는 것은 함수 안의 AI 호출이었다. 설령
+클라이언트를 늘려도 서버가 90초에서 잘랐다. 실패가 조용해서(빈 응답·잘린 본문) 받는 쪽은
+"게이트웨이가 끊었다" 와 "모델이 형식을 어겼다" 를 구분할 수 없었다.
+
+- `chat(request, { timeout })` — 이 1회 생성의 **서버 예산**(ms). 상한 300초(서버리스 함수의
+  최대 `timeout` 과 같은 값), 넘기면 clamp.
+- 미지정 기본값을 30초 → **90초**(서버 기본값과 동일)로 올렸다. 클라이언트가 서버보다 먼저
+  끊으면 서버가 만든 `504 provider_timeout` 이 호출자에게 영영 도달하지 못한다.
+- 클라이언트 abort 는 서버 예산보다 10초 뒤 — 그래서 시간이 넘치면 **504 가 먼저 도착**한다.
+- `chat(request, { signal })` — 진행 중 요청 취소.
+- 우선순위: `options.timeout` → 생성 시 `requestTimeoutMs` → 90초.
+
+300초로도 부족한 생성은 `chatStream` 을 쓴다 — 스트리밍은 총량 상한이 없고 청크 간 idle 만 본다.
+
+### Fixed — 게이트웨이가 본문을 갈아치운 5xx 도 `code` 를 갖는다
+
+서버는 504 에 `{"error":"provider_timeout","provider":...,"model":...}` 를 실어 보내지만,
+**Cloudflare 는 오리진의 502/504 본문을 자기 에러 페이지로 통째로 교체한다** (실측: 서버가 만든
+JSON 이 클라이언트에는 `error code: 504` / `text/plain` 으로 도착). 그러면 `code` 가 통째로
+사라져, 호출자는 "게이트웨이가 끊었다" 와 "모델이 이상한 응답을 줬다" 를 코드로 가를 수 없었다.
+HTTP/2 에서는 `statusText` 도 빈 문자열이라 메시지마저 `"Unknown error"` 였다.
+
+- 본문에 코드가 하나도 없을 때만 상태 코드에서 코드를 복원한다 — 502 `bad_gateway`,
+  503 `service_unavailable`, 504 `gateway_timeout`. **서버가 준 코드는 절대 덮지 않는다.**
+- 같은 경우 메시지도 상태에 맞는 문장으로 채운다.
+
 ## [5.4.1] - 2026-07-31
 
 ### Docs — 함수 안에서 `postponeBilling()` 을 쓰는 방법 (`subscription:manage`)