@vibexnpm/talkx 3.0.1 → 3.0.2

package/dist/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;