@vibexnpm/talkx 3.0.1 → 3.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vibexnpm/talkx",
-    "version": "3.0.1",
+    "version": "3.0.2",
     "type": "module",
     "description": "TalkFlow SDK - Chat & WebRTC unified client",
     "main": "dist/talkflow-sdk.umd.js",

package/src/chat/ChatClient.js

@@ -477,9 +477,9 @@ class ChatClient extends EventEmitter {
      * Rolling 누적 요약 갱신 트리거 (비동기).
      *
      * <p>방의 <b>누적 대화 요약</b>을 갱신한다 — {@link #summarizeWithAssistant}(페르소나가 최근 N개를 방에
-     * 어시스턴트 메시지로 발행)와 달리, 방당 1개의 통합 요약본(rollup)을 마지막 요약 지점 이후 <b>새 대화만
-     * 증분</b> 반영한다. 실제 요약은 서버 워커가 비동기로 수행하며, 완료/실패는 {@code summaryUpdate} 이벤트로
-     * 통지된다. 확정 내용은 {@link #getSummary} 로 조회한다(알림 payload 에는 내용이 없다).</p>
+     * 어시스턴트 메시지로 발행)와 달리, <b>포맷별</b> 통합 요약본(rollup)을 마지막 요약 지점 이후 <b>새 대화만
+     * 증분</b> 반영한다(같은 방을 여러 포맷으로 보관). 실제 요약은 서버 워커가 비동기로 수행하며, 완료/실패는
+     * {@code summaryUpdate} 이벤트로 통지된다. 확정 내용은 {@link #getSummary} 로 조회한다(알림 payload 에는 내용이 없다).</p>
      *
      * <p>전체 히스토리를 보는 방(예: TEAM) 대상 기능이며, AI capability {@code TOOL_SUMMARIZE} 가 필요하다.</p>
      *
@@ -512,23 +512,28 @@ class ChatClient extends EventEmitter {
      * transient(저장 안 됨)라 유실될 수 있으므로 GET 으로 동기화한다. 아직 한 번도 요약된 적 없으면 {@code rollup}
      * 이 {@code null} 이다. segment 는 {@code afterSeq}/{@code size} 로 페이지네이션한다({@code hasNext}/{@code nextSeq}).</p>
      *
+     * <p>같은 방을 여러 포맷으로 보관하므로 {@code options.format} 으로 골라 조회한다. 미지정 시 기본(SHORT 우선),
+     * 요청 포맷이 아직 없으면 {@code rollup=null}(이때 {@code availableFormats} 로 보유 포맷 확인 또는 refreshSummary
+     * 로 생성). {@code rollup.stale} 이 {@code true} 면 그 포맷이 최신 대화를 아직 반영 안 함(refresh 로 최신화).</p>
+     *
      * @param {string} roomId - 채팅방 ID
      * @param {Object} [options]
+     * @param {string} [options.format] - 조회할 포맷({@link SummarizeFormat}). 미지정 시 기본. 미보유 포맷이면 rollup=null.
      * @param {number} [options.afterSeq] - segment 페이지 커서(exclusive). 미지정 시 처음부터.
      * @param {number} [options.size=50] - segment 페이지 크기(서버 상한 50).
-     * @returns {Promise<RoomSummaryView>} { rollup: { content, format, status, ... } | null, segments: [...], hasNext, nextSeq }
+     * @returns {Promise<RoomSummaryView>} { rollup | null, availableFormats, segments, hasNext, nextSeq }
      *
      * @example
-     * const view = await chat.getSummary(roomId);
-     * if (!view.rollup) return renderEmpty();          // 아직 요약 없음
-     * renderRollup(view.rollup);                        // rollup.status: 'IDLE' | 'RUNNING' | 'FAILED'
-     * renderSegments(view.segments, view.hasNext, view.nextSeq);
+     * const view = await chat.getSummary(roomId, { format: 'timeline' });
+     * if (!view.rollup) return renderEmpty();          // 그 포맷 아직 없음 (availableFormats 로 탭 렌더)
+     * renderRollup(view.rollup, view.rollup.stale);     // stale 이면 "최신화" 유도
+     * renderTabs(view.availableFormats);                // 보유 포맷 탭
      */
     async getSummary(roomId, options = {}) {
-        const { afterSeq, size } = options;
+        const { format, afterSeq, size } = options;
         const response = await this.apiClient.get(
             `/api/v1/rooms/${roomId}/summary`,
-            { afterSeq, size }
+            { format, afterSeq, size }
         );
         return this._unwrapSuccessResponse(response);
     }

package/types/index.d.ts

@@ -307,6 +307,8 @@ export interface RefreshSummaryResult {
 
 /** {@link ChatClient.getSummary} 옵션. */
 export interface GetSummaryOptions {
+    /** 조회할 포맷({@link SummarizeFormat}). 미지정 시 기본(SHORT 우선). 미보유 포맷이면 rollup=null. */
+    format?: SummarizeFormatValue;
     /** segment 페이지 커서(exclusive). 미지정 시 처음부터. */
     afterSeq?: number;
     /** segment 페이지 크기(서버 상한 50). */
@@ -325,6 +327,8 @@ export interface RoomSummaryRollup {
     watermarkAt: string | null;
     /** 전체 segment 수(페이지 총량 힌트). */
     segmentCount: number;
+    /** 이 포맷이 최신 대화를 아직 반영 안 함(reducedSegmentCount < segmentCount) — refreshSummary 로 최신화 가능. */
+    stale: boolean;
     /** 진행 상태. {@code 'IDLE'}(완료/대기) | {@code 'RUNNING'}(요약 중) | {@code 'FAILED'}(실패). */
     status: 'IDLE' | 'RUNNING' | 'FAILED';
     /** 마지막 갱신 시각. */
@@ -352,9 +356,11 @@ export interface RoomSummarySegment {
  * 아직 한 번도 요약되지 않았으면 {@code rollup} 이 {@code null} 이고 {@code segments} 는 빈 배열이다.
  */
 export interface RoomSummaryView {
-    /** 통합 요약본. 최초 요약 전이면 null. */
+    /** 요청/기본 포맷의 통합 요약본. 그 포맷으로 아직 요약 안 됐으면 null(availableFormats 로 다른 포맷 확인). */
     rollup: RoomSummaryRollup | null;
-    /** 구간 부분요약 페이지. */
+    /** 이 방이 보유한 포맷 목록(short/timeline/… — 탭 렌더용). */
+    availableFormats: string[];
+    /** 구간 부분요약 페이지(포맷 무관 공유). */
     segments: RoomSummarySegment[];
     /** 다음 segment 페이지 존재 여부. */
     hasNext: boolean;