@vibexnpm/talkx 3.0.1 → 3.0.3

package/dist/index.d.ts

@@ -288,6 +288,8 @@ export interface TranslateToolRequest {
 export interface RefreshSummaryOptions {
     /** 요약 포맷 ({@link SummarizeFormat}). 미지정/알 수 없는 값이면 서버가 {@code SHORT} 적용. */
     format?: SummarizeFormatValue;
+    /** 출력 언어(BCP-47 예 {@code 'ko'}/{@code 'en'}, 또는 {@code 'OFF'}=원문). 미지정 시 서버가 요청자 언어로 해소. */
+    lang?: string;
 }
 
 /**
@@ -298,15 +300,24 @@ export interface RefreshSummaryResult {
     /**
      * <ul>
      *   <li>{@code 'STARTED'} — 요약 워커 시작됨({@code summaryUpdate} 대기).</li>
-     *   <li>{@code 'ALREADY_RUNNING'} — 이미 진행 중(중복 트리거 — 재요청하지 말 것).</li>
+     *   <li>{@code 'ALREADY_RUNNING'} — 방에서 요약이 진행 중(<b>다른</b> 포맷·언어일 수 있음). {@code format}/{@code language}
+     *       로 내 키인지 확인하고, {@code summaryUpdate} 가 내 키가 아니면 그때 다시 요청한다(무조건 재요청 금지 아님).</li>
      *   <li>{@code 'NO_CHANGE'} — 새 대화 없음(알림 발생 안 함; 직전 실패가 있었다면 자동 복구됨).</li>
      * </ul>
      */
     status: 'STARTED' | 'ALREADY_RUNNING' | 'NO_CHANGE';
+    /** 이번 요청이 해소한 포맷({@link SummarizeFormat} 소문자). 방 단위 경합 식별용. */
+    format?: string;
+    /** 이번 요청이 해소한 언어(소문자 BCP-47 / {@code 'OFF'}=원문). 방 단위 경합 식별용. */
+    language?: string;
 }
 
 /** {@link ChatClient.getSummary} 옵션. */
 export interface GetSummaryOptions {
+    /** 조회할 포맷({@link SummarizeFormat}). 미지정 시 그 언어의 기본(SHORT 우선). 미보유 포맷이면 rollup=null. */
+    format?: SummarizeFormatValue;
+    /** 조회할 언어(BCP-47 예 {@code 'ko'}, 또는 {@code 'OFF'}=원문). 미지정 시 요청자 언어로 해소(응답 {@code language}). */
+    lang?: string;
     /** segment 페이지 커서(exclusive). 미지정 시 처음부터. */
     afterSeq?: number;
     /** segment 페이지 크기(서버 상한 50). */
@@ -315,18 +326,20 @@ export interface GetSummaryOptions {
 
 /** Rolling 누적 요약 통합본 — {@link RoomSummaryView.rollup}. */
 export interface RoomSummaryRollup {
-    /** 요약 본문 ({@code format} 적용됨). */
+    /** 요약 본문 ({@code format} 적용 + {@code language} 로 통합됨). */
     content: string;
     /** 적용된 포맷 ({@link SummarizeFormat} 소문자). */
     format: string;
+    /** 이 rollup 의 언어(소문자 BCP-47 / {@code 'OFF'}=원문). {@link RoomSummaryView.language} 와 동일. */
+    language: string;
     /** rollup 이 커버하는 가장 오래된 지점. */
     coverStartAt: string | null;
     /** 마지막으로 요약된 지점. */
     watermarkAt: string | null;
     /** 전체 segment 수(페이지 총량 힌트). */
     segmentCount: number;
-    /** 진행 상태. {@code 'IDLE'}(완료/대기) | {@code 'RUNNING'}(요약 중) | {@code 'FAILED'}(실패). */
-    status: 'IDLE' | 'RUNNING' | 'FAILED';
+    /** 이 키(포맷×언어)가 최신 대화를 아직 반영 안 함(reducedSegmentCount < segmentCount) — refreshSummary 로 최신화 가능. */
+    stale: boolean;
     /** 마지막 갱신 시각. */
     updatedAt: string;
 }
@@ -352,9 +365,23 @@ export interface RoomSummarySegment {
  * 아직 한 번도 요약되지 않았으면 {@code rollup} 이 {@code null} 이고 {@code segments} 는 빈 배열이다.
  */
 export interface RoomSummaryView {
-    /** 통합 요약본. 최초 요약 전이면 null. */
+    /**
+     * 이 응답의 기준 언어(소문자 BCP-47 / {@code 'OFF'}=원문). {@code lang} 미지정 조회면 서버가 해소한 값이다 —
+     * {@code rollup}·{@code availableFormats} 가 이 언어 기준이다. 요약 이력이 없어도 서버가 요청자 언어로 해소해
+     * <b>항상</b> 채운다(never null).
+     */
+    language: string;
+    /**
+     * 방 전체 요약 프로세스 상태 — {@code 'IDLE'}(대기) | {@code 'RUNNING'}(요약 중) | {@code 'FAILED'}(실패).
+     * <b>방 단위(키별 아님)</b>: 방은 한 번에 한 키만 요약하므로, 지금 다른 포맷·언어를 요약 중이어도 {@code 'RUNNING'} 이다.
+     * 특정 rollup 의 최신 여부는 {@code rollup.stale} 로 판단한다(rollup 자체는 완료된 데이터). 요약 이력이 없으면 null.
+     */
+    roomStatus: 'IDLE' | 'RUNNING' | 'FAILED' | null;
+    /** 요청/기본 포맷의 통합 요약본. 그 포맷×언어로 아직 요약 안 됐으면 null(availableFormats 로 같은 언어의 다른 포맷 확인). */
     rollup: RoomSummaryRollup | null;
-    /** 구간 부분요약 페이지. */
+    /** 이 방이 <b>이 언어로</b> 보유한 포맷 목록(short/timeline/… — 탭 렌더용). 타 언어는 포함하지 않는다. */
+    availableFormats: string[];
+    /** 구간 부분요약 페이지(포맷 무관 공유). */
     segments: RoomSummarySegment[];
     /** 다음 segment 페이지 존재 여부. */
     hasNext: boolean;
@@ -370,8 +397,10 @@ export interface SummaryUpdateEvent {
     roomId: string;
     /** {@code 'READY'}(갱신됨 → getSummary) | {@code 'FAILED'}(실패 → 재시도 가능) | {@code 'NO_CHANGE'}(변경 없음). */
     status: 'READY' | 'NO_CHANGE' | 'FAILED';
-    /** 적용된 포맷. {@code READY} 만 포함, 그 외 null. */
+    /** 완료/실패한 포맷. {@code READY}·{@code FAILED} 포함, {@code NO_CHANGE} 는 null. */
     format: string | null;
+    /** 완료/실패한 언어(소문자 BCP-47 / {@code 'OFF'}). {@code READY}·{@code FAILED} 포함, {@code NO_CHANGE} 는 null — format 과 함께 키 식별. */
+    language: string | null;
     /** 갱신 시각. {@code READY} 만 포함, 그 외 null. */
     updatedAt: string | null;
 }