connectbase-client 3.35.1 → 3.35.2

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.35.2] - 2026-06-22
+
+### Changed — 문서·타입 폴리시 (런타임 동작 변화 없음)
+
+SDK 감사에서 발견된 문서·타입 정합성 개선. 공개 API 의 런타임 동작은 동일하다.
+
+- **README AI Streaming 멀티프로바이더 정정** — "Gemini 전용" 프레이밍을 제거하고 실제 지원 프로바이더 6종(`gemini` / `openai` / `claude` / `ollama` / `lm_studio` / `openai_compatible`)을 반영. Stream Options 표의 `provider` 타입을 전체 union 으로 교체하고, `provider`/`model`/`temperature` 의 기본값은 SDK 가 강제하지 않고 서버측 앱 AI 설정에서 결정됨을 명시. 누락돼 있던 `mcpGroup` 옵션도 표에 추가.
+- **`endpoint.pollUntil` predicate 타입 강화 (타입 전용)** — predicate 파라미터를 `(body: any, ...)` → **`(body: unknown, ...)`** 로 변경. 공개 표면에 남아 있던 유일한 `any` 를 제거하고 호출자에게 응답 narrowing 을 강제한다. 런타임 동작은 동일하며, JSDoc 예제도 `unknown` narrowing 방식으로 갱신.
+- **JSDoc 정정** — `recent-calls.ts` 의 breadcrumb 저장 정책 주석이 "쿼리 키 선별 redact" 라 적혀 있었으나 실제 구현은 쿼리스트링을 통째로 strip(더 안전)하므로 주석을 구현에 맞게 정정. `http.ts` 의 stale 참조 `client.support.getRecentCalls()` → `client.support.getRecentApiCalls()` 정정.
+
 ## [3.35.1] - 2026-06-19
 
 ### Changed — 내부 하드닝 (공개 API 동작 변화 없음)

package/README.md

@@ -113,7 +113,7 @@ try {
 - **Push Notifications**: Cross-platform push notification support
 - **WebRTC**: Real-time audio/video communication
 - **Payments**: Subscription and one-time payment support
-- **AI Streaming**: Real-time AI text generation via WebSocket (Gemini)
+- **AI Streaming**: Real-time AI text generation via WebSocket (multi-provider: Gemini, OpenAI, Claude, Ollama, LM Studio, OpenAI-compatible)
 - **Knowledge Base (RAG)**: Document indexing + BM25 search with nori 한국어 형태소. PDF / DOCX / text file upload via `addDocumentFromFile`
 - **Endpoint**: Call your own GPU models on your own PC through one `cb_pk_*` key — ConnectBase forwards the payload as-is (dumb pipe)
 - **Support**: End-user feedback/issue reporting — users send issues to app operators, AI auto-classifies summary/urgency/category
@@ -959,7 +959,10 @@ const unsubTyping = await cb.realtime.onTypingChange('room-id', (typing) => {
 
 #### AI Streaming
 
-Real-time AI text generation using Gemini API through WebSocket.
+Real-time AI text generation through WebSocket. The provider and model are
+resolved from your app's AI config on the server; you can optionally override
+them per request (`provider` / `model`). Supported providers: Gemini, OpenAI,
+Claude, Ollama, LM Studio, and any OpenAI-compatible endpoint.
 
 ```typescript
 // Connect first
@@ -987,9 +990,11 @@ const session = await cb.realtime.stream(
     }
   },
   {
-    model: 'gemini-2.0-flash',  // Optional: default is gemini-2.0-flash
-    temperature: 0.7,           // Optional: 0.0-2.0, default 0.7
-    maxTokens: 1000             // Optional: max output tokens
+    // All fields optional. When omitted, the server uses your app's AI config.
+    provider: 'openai',  // Optional: override the app's configured provider
+    model: 'gpt-4o',     // Optional: override the app's configured model
+    temperature: 0.7,    // Optional: 0.0-2.0
+    maxTokens: 1000      // Optional: max output tokens
   }
 )
 
@@ -997,16 +1002,17 @@ const session = await cb.realtime.stream(
 await session.stop()
 ```
 
-**Stream Options:**
+**Stream Options:** (all optional — defaults are resolved server-side from your app's AI config, not by the SDK)
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `provider` | `'gemini'` | `'gemini'` | AI provider |
-| `model` | `string` | `'gemini-2.0-flash'` | Model name |
+| `provider` | `'gemini' \| 'openai' \| 'claude' \| 'ollama' \| 'lm_studio' \| 'openai_compatible'` | app config | Override the app's configured AI provider |
+| `model` | `string` | app config | Override the app's configured model |
 | `system` | `string` | - | System prompt |
-| `temperature` | `number` | `0.7` | Creativity (0.0-2.0) |
+| `temperature` | `number` | app config | Creativity (0.0-2.0) |
 | `maxTokens` | `number` | - | Max output tokens |
 | `sessionId` | `string` | auto | Session tracking ID |
 | `metadata` | `object` | - | Custom metadata |
+| `mcpGroup` | `string` | - | MCP group slug — enables AI Agent mode (registered MCP server tools) |
 
 **Stream Result (onDone):**
 | Field | Type | Description |

package/dist/index.d.mts

@@ -96,10 +96,10 @@ interface AbortOptions {
  * Recent API calls breadcrumb buffer — SDK 디버깅 / platform issue 발행 시 자동 첨부.
  *
  * **저장 정책 (PII 보호):**
- *   - method, path (query string strip), status, duration_ms, timestamp 만 저장
+ *   - method, path (query string 전체 strip), status, duration_ms, timestamp 만 저장
  *   - body / response body / 인증 토큰 미저장
- *   - URL 내 secret-like 패턴 (key=, token=, password=) 자동 redact
- *   - `/v1/auth/*`, `/v1/oauth/token` 등 민감 endpoint 는 path 만 (쿼리 strip)
+ *   - 쿼리스트링은 키 단위 redact 가 아니라 통째로 제거 (토큰/PII 누출 가능성 0)
+ *   - 따라서 `/v1/auth/*`, `/v1/oauth/token` 등 민감 endpoint 도 path 만 보존
  */
 interface RecentApiCall {
     method: string;
@@ -187,7 +187,7 @@ declare class HttpClient {
     private refreshLockedUntil;
     /**
      * 최근 API 호출 breadcrumb (PII strip 후 저장). platform_issue 발행 시 자동 첨부 가능.
-     * `client.support.getRecentCalls()` 로 외부 노출.
+     * `client.support.getRecentApiCalls()` 로 외부 노출.
      */
     private recentCalls;
     /**
@@ -7981,6 +7981,9 @@ declare class EndpointAPI {
      * predicate 는 같은 Response 를 한 번만 읽을 수 있으므로, 헬퍼 내부에서
      * `res.clone().json()` 형태로 안전하게 파싱한 뒤 호출자에게 전달.
      *
+     * predicate 의 `body` 는 `unknown` 으로 전달되므로, 호출자가 자신의 응답
+     * 스키마로 narrowing 한 뒤 사용한다 (런타임 검증 책임은 호출자에게 있음).
+     *
      * @example ComfyUI 결과 폴링
      * ```typescript
      * type Hist = Record<string, { outputs: Record<string, { images?: { filename: string }[] }> }>
@@ -7988,7 +7991,8 @@ declare class EndpointAPI {
      * const filename = await cb.endpoint.pollUntil<string>(
      *     "comfyui-main",
      *     { path: `/history/${promptId}` },
-     *     (data: Hist) => {
+     *     (body) => {
+     *         const data = body as Hist
      *         const entry = data[promptId]
      *         if (!entry) return undefined // 아직 큐에 있음
      *         for (const out of Object.values(entry.outputs)) {
@@ -8031,7 +8035,7 @@ declare class EndpointAPI {
      * ```
      */
     connectWebSocket(label: string, opts?: ConnectWebSocketOptions): Promise<WebSocket>;
-    pollUntil<T>(label: string, init: EndpointCallInit, predicate: (body: any, res: Response) => T | undefined | Promise<T | undefined>, opts?: PollUntilOptions): Promise<T>;
+    pollUntil<T>(label: string, init: EndpointCallInit, predicate: (body: unknown, res: Response) => T | undefined | Promise<T | undefined>, opts?: PollUntilOptions): Promise<T>;
 }
 /**
  * EndpointAPI.call 의 init 인자.

package/dist/index.d.ts

@@ -96,10 +96,10 @@ interface AbortOptions {
  * Recent API calls breadcrumb buffer — SDK 디버깅 / platform issue 발행 시 자동 첨부.
  *
  * **저장 정책 (PII 보호):**
- *   - method, path (query string strip), status, duration_ms, timestamp 만 저장
+ *   - method, path (query string 전체 strip), status, duration_ms, timestamp 만 저장
  *   - body / response body / 인증 토큰 미저장
- *   - URL 내 secret-like 패턴 (key=, token=, password=) 자동 redact
- *   - `/v1/auth/*`, `/v1/oauth/token` 등 민감 endpoint 는 path 만 (쿼리 strip)
+ *   - 쿼리스트링은 키 단위 redact 가 아니라 통째로 제거 (토큰/PII 누출 가능성 0)
+ *   - 따라서 `/v1/auth/*`, `/v1/oauth/token` 등 민감 endpoint 도 path 만 보존
  */
 interface RecentApiCall {
     method: string;
@@ -187,7 +187,7 @@ declare class HttpClient {
     private refreshLockedUntil;
     /**
      * 최근 API 호출 breadcrumb (PII strip 후 저장). platform_issue 발행 시 자동 첨부 가능.
-     * `client.support.getRecentCalls()` 로 외부 노출.
+     * `client.support.getRecentApiCalls()` 로 외부 노출.
      */
     private recentCalls;
     /**
@@ -7981,6 +7981,9 @@ declare class EndpointAPI {
      * predicate 는 같은 Response 를 한 번만 읽을 수 있으므로, 헬퍼 내부에서
      * `res.clone().json()` 형태로 안전하게 파싱한 뒤 호출자에게 전달.
      *
+     * predicate 의 `body` 는 `unknown` 으로 전달되므로, 호출자가 자신의 응답
+     * 스키마로 narrowing 한 뒤 사용한다 (런타임 검증 책임은 호출자에게 있음).
+     *
      * @example ComfyUI 결과 폴링
      * ```typescript
      * type Hist = Record<string, { outputs: Record<string, { images?: { filename: string }[] }> }>
@@ -7988,7 +7991,8 @@ declare class EndpointAPI {
      * const filename = await cb.endpoint.pollUntil<string>(
      *     "comfyui-main",
      *     { path: `/history/${promptId}` },
-     *     (data: Hist) => {
+     *     (body) => {
+     *         const data = body as Hist
      *         const entry = data[promptId]
      *         if (!entry) return undefined // 아직 큐에 있음
      *         for (const out of Object.values(entry.outputs)) {
@@ -8031,7 +8035,7 @@ declare class EndpointAPI {
      * ```
      */
     connectWebSocket(label: string, opts?: ConnectWebSocketOptions): Promise<WebSocket>;
-    pollUntil<T>(label: string, init: EndpointCallInit, predicate: (body: any, res: Response) => T | undefined | Promise<T | undefined>, opts?: PollUntilOptions): Promise<T>;
+    pollUntil<T>(label: string, init: EndpointCallInit, predicate: (body: unknown, res: Response) => T | undefined | Promise<T | undefined>, opts?: PollUntilOptions): Promise<T>;
 }
 /**
  * EndpointAPI.call 의 init 인자.

package/dist/index.js

@@ -184,7 +184,7 @@ var HttpClient = class {
     this.refreshLockedUntil = 0;
     /**
      * 최근 API 호출 breadcrumb (PII strip 후 저장). platform_issue 발행 시 자동 첨부 가능.
-     * `client.support.getRecentCalls()` 로 외부 노출.
+     * `client.support.getRecentApiCalls()` 로 외부 노출.
      */
     this.recentCalls = new RecentCallsBuffer();
     /**
@@ -9120,6 +9120,9 @@ var EndpointAPI = class {
    * predicate 는 같은 Response 를 한 번만 읽을 수 있으므로, 헬퍼 내부에서
    * `res.clone().json()` 형태로 안전하게 파싱한 뒤 호출자에게 전달.
    *
+   * predicate 의 `body` 는 `unknown` 으로 전달되므로, 호출자가 자신의 응답
+   * 스키마로 narrowing 한 뒤 사용한다 (런타임 검증 책임은 호출자에게 있음).
+   *
    * @example ComfyUI 결과 폴링
    * ```typescript
    * type Hist = Record<string, { outputs: Record<string, { images?: { filename: string }[] }> }>
@@ -9127,7 +9130,8 @@ var EndpointAPI = class {
    * const filename = await cb.endpoint.pollUntil<string>(
    *     "comfyui-main",
    *     { path: `/history/${promptId}` },
-   *     (data: Hist) => {
+   *     (body) => {
+   *         const data = body as Hist
    *         const entry = data[promptId]
    *         if (!entry) return undefined // 아직 큐에 있음
    *         for (const out of Object.values(entry.outputs)) {

package/dist/index.mjs

@@ -138,7 +138,7 @@ var HttpClient = class {
     this.refreshLockedUntil = 0;
     /**
      * 최근 API 호출 breadcrumb (PII strip 후 저장). platform_issue 발행 시 자동 첨부 가능.
-     * `client.support.getRecentCalls()` 로 외부 노출.
+     * `client.support.getRecentApiCalls()` 로 외부 노출.
      */
     this.recentCalls = new RecentCallsBuffer();
     /**
@@ -9074,6 +9074,9 @@ var EndpointAPI = class {
    * predicate 는 같은 Response 를 한 번만 읽을 수 있으므로, 헬퍼 내부에서
    * `res.clone().json()` 형태로 안전하게 파싱한 뒤 호출자에게 전달.
    *
+   * predicate 의 `body` 는 `unknown` 으로 전달되므로, 호출자가 자신의 응답
+   * 스키마로 narrowing 한 뒤 사용한다 (런타임 검증 책임은 호출자에게 있음).
+   *
    * @example ComfyUI 결과 폴링
    * ```typescript
    * type Hist = Record<string, { outputs: Record<string, { images?: { filename: string }[] }> }>
@@ -9081,7 +9084,8 @@ var EndpointAPI = class {
    * const filename = await cb.endpoint.pollUntil<string>(
    *     "comfyui-main",
    *     { path: `/history/${promptId}` },
-   *     (data: Hist) => {
+   *     (body) => {
+   *         const data = body as Hist
    *         const entry = data[promptId]
    *         if (!entry) return undefined // 아직 큐에 있음
    *         for (const out of Object.values(entry.outputs)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connectbase-client",
-  "version": "3.35.1",
+  "version": "3.35.2",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",