@vibexnpm/talkx 7.0.0 → 7.1.0

package/dist/index.d.ts

@@ -1264,6 +1264,18 @@ export interface TypingEvent {
     senderType: 'USER' | 'ASSISTANT';
 }
 
+/** 문서 분석의 재입장 복원 가능한 실측 진행률. */
+export interface DocumentAnalysisProgress {
+    /** ANALYZING=페이지/텍스트 구간 처리, SUMMARIZING=확보한 근거 종합. */
+    stage: 'ANALYZING' | 'SUMMARIZING';
+    /** ANALYZING일 때 처리 완료 수. */
+    current: number | null;
+    /** ANALYZING일 때 전체 수. */
+    total: number | null;
+    /** 진행 단위. SUMMARIZING일 때 null. */
+    unit: 'DOCUMENT' | 'PAGE' | 'TEXT_CHUNK' | null;
+}
+
 /**
  * AI 진행 표시 이벤트 — `/topic/chat/{roomId}/assistant-stream` 의 PHASE/DONE.
  *
@@ -1281,6 +1293,7 @@ export interface TypingEvent {
  *
  * 현재는 PM_BACKSTAGE(방당 단일 PM) 만 phase 를 발행 — 멘션/버튼/14인 경로는 본 이벤트 없이 typing 만.
  */
+
 export interface AssistantProgressEvent {
     /** 채팅방 ID. */
     roomId: string;
@@ -1294,7 +1307,9 @@ export interface AssistantProgressEvent {
     /** 진행 주체 페르소나 ID. */
     personaId: string | null;
     /** 진행 단계 — `active:true` 일 때. 종료 시 null. */
-    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'WRITING' | null;
+    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'WRITING' | null;
+    /** DOCUMENT_ANALYSIS의 실측 진행률. 같은 phase heartbeat 사이와 재입장 후에도 보존된다. */
+    progress?: DocumentAnalysisProgress | null;
     /** phase 의 기본 표시 라벨(예: "생각 중…"). SDK 매핑 — 커스텀하려면 `phase` 사용. 종료 시 null. */
     label: string | null;
     /** true=진행중(PHASE/DELTA) / false=종료(DONE·TTL). */
@@ -1360,7 +1375,8 @@ export interface AssistantRoomProgressEvent {
     /** 표시 기준이 된 stream (가장 최근 갱신). 없으면 null. */
     streamId: string | null;
     personaId: string | null;
-    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'WRITING' | null;
+    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'WRITING' | null;
+    progress?: DocumentAnalysisProgress | null;
     label: string | null;
     /** 표시 기준 stream 의 누적 본문. `textAvailable:false` 거나 진행 중이 아니면 null. */
     text?: string | null;
@@ -1372,7 +1388,8 @@ export interface AssistantRoomProgressEvent {
 export interface AssistantProgressStreamSnapshot {
     streamId: string;
     personaId: string | null;
-    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'WRITING' | null;
+    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'WRITING' | null;
+    progress?: DocumentAnalysisProgress | null;
     label: string | null;
     text: string | null;
     textAvailable: boolean;