connectbase-client 5.6.1 → 5.6.3

package/CHANGELOG.md

@@ -3,6 +3,47 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [5.6.3] - 2026-08-01
+
+### Changed — `cb.ai.chat` 이 스트리밍 전송 위에서 동작한다 (겉보기 API 동일)
+
+`options.timeout` 을 300초까지 열어도 **외부에서 부르면 ~100초에 524** 로 끊겼다. 응답이 다
+만들어질 때까지 한 바이트도 흐르지 않는 요청은, 중간의 어떤 계층이든 "첫 바이트까지 N초"
+제한을 두면 그 자리에서 끊기기 때문이다 — CDN, 리버스 프록시, 로드밸런서, 캐리어 NAT 가 전부
+그렇다. 서버 타임아웃을 올려도 이 성질은 남으므로, 상한을 올리는 게 아니라 **바이트가 계속
+흐르게** 하는 것이 유일한 근본 해결이다(긴 생성에 스트리밍을 쓰는 것은 LLM API 의 표준 관행).
+
+- `chat()` 이 내부적으로 `/v1/public/ai/chat/stream` 을 소비하고 결과를 합쳐 돌려준다.
+  **호출자가 볼 수 있는 차이는 없다** — `content`/`reasoning`/`toolCalls`/`sources`/
+  `finishReason`/`usage`/`provider`/`model` 모두 그대로 채워진다.
+- 에러 계약도 그대로다. HTTP 레벨 실패는 기존과 **완전히 같은** `ApiError`(파싱 로직을 공유),
+  mid-stream 에러는 코드에서 상태를 되살려 `statusCode`+`code` 로 던진다.
+  `err.statusCode === 504` 같은 기존 분기가 그대로 산다.
+- 예산 초과는 조용한 빈 응답이 아니라 `ApiError(504, provider_timeout)` 이다.
+
+### Added — 스트리밍 응답에 `usage` / `provider` / `model`
+
+서버는 예전부터 이 값들로 과금·budget 을 기록했지만 SSE 와이어에는 싣지 않아, **스트리밍
+호출자는 사용량과 실제 응답 모델을 알 수 없었다**(문서가 "사용량이 필요하면 동기 chat 을 쓰라"
+고 안내하던 이유). 긴 생성은 스트리밍이 사실상 필수인데 그쪽만 못 받는 비대칭이었다.
+이제 종료 청크(`AIStreamChunk`)에 함께 실린다. 서버 2026-08-01+ 필요.
+
+## [5.6.2] - 2026-08-01
+
+### Docs — `options.timeout` 의 실질 상한을 호출 위치별로 정정
+
+**동작 변경 없음** (JSDoc 문구만). 5.6.1 은 "터널 모델도 300초를 다 쓴다" 고만 적었는데,
+실측해 보니 제약의 위치가 달랐다. ConnectBase→터널 구간은 내부 직결이 되어 CDN 을 안 타지만,
+**외부에서 공개 API 를 부르는 구간**은 여전히 CDN 을 지난다. 비스트리밍 생성은 끝날 때까지
+한 바이트도 흐르지 않아 CDN 의 "첫 바이트까지 ~100초" 타이머에 걸린다.
+
+| 호출 위치 | 실질 상한 |
+|---|---|
+| 서버리스 함수 안 (`ctx.cb`) | 300초 전부 (197초 생성 200 OK) |
+| 외부 → 공개 API | ~100초 (200초 예산 요청이 126초에 524) |
+
+100초를 넘길 수 있는 생성은 `chatStream` 을 쓴다.
+
 ## [5.6.1] - 2026-08-01
 
 ### Docs — `endpoint://` 터널 모델의 실질 상한 정정