@vibexnpm/talkx 6.1.0 → 7.1.0

package/dist/index.d.ts

@@ -1038,6 +1038,15 @@ export interface MyProfile {
     orgNodeId?: string | null;
     orgName?: string | null;
     preferredLanguage?: string | null;
+    /**
+     * 확장 메타데이터 — 내 값을 볼 수 있는 **유일한** 곳이다.
+     *
+     * 고치는 문은 `updateMyProfile({ metadata })` 하나뿐이고 **전체 교체**다 —
+     * 서버는 병합하지 않는다. 부분 수정하려면 이 값을 먼저 읽어 병합한 뒤 통째로 보내라.
+     */
+    metadata?: Record<string, unknown> | null;
+    /** IANA zone id — 어시가 대화 시각을 이 기준으로 렌더한다. 읽을 수 없으면 설정 화면이 현재 값을 못 보여준다. */
+    timeZone?: string | null;
     projectId: string;
     joinedAt?: string | null;
     /**
@@ -1255,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.
  *
@@ -1272,6 +1293,7 @@ export interface TypingEvent {
  *
  * 현재는 PM_BACKSTAGE(방당 단일 PM) 만 phase 를 발행 — 멘션/버튼/14인 경로는 본 이벤트 없이 typing 만.
  */
+
 export interface AssistantProgressEvent {
     /** 채팅방 ID. */
     roomId: string;
@@ -1285,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). */
@@ -1351,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;
@@ -1363,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;
@@ -2358,7 +2384,17 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     getMyProfile(): Promise<MyProfile>;
 
     /** 내 정보 수정 — 응답의 새 토큰을 자동 채택한다(name/profileUrl 이 토큰 claim). */
-    updateMyProfile(profile: { name?: string; phone?: string; profileUrl?: string }): Promise<MyProfile>;
+    updateMyProfile(profile: {
+        name?: string;
+        phone?: string;
+        profileUrl?: string;
+        /** **전체 교체** — 부분 수정은 `getMyProfile()` 로 읽어 병합한 뒤 통째로 보낸다. */
+        metadata?: Record<string, unknown> | null;
+        /** BCP-47 코드 / 'OFF'(원문) / null */
+        preferredLanguage?: string | null;
+        /** IANA zone id — `Intl.DateTimeFormat().resolvedOptions().timeZone` */
+        timeZone?: string;
+    }): Promise<MyProfile>;
 
     /** 비밀번호 변경 — 현재 비밀번호 재확인. 토큰은 그대로 유효해 재로그인이 필요 없다. */
     changeMyPassword(params: { currentPassword: string; newPassword: string }): Promise<unknown>;