@vibexnpm/talkx 2.3.1 → 2.5.0

package/dist/index.d.ts

@@ -378,6 +378,7 @@ export const WebSocketPaths: {
     getChatDestination(roomId: string): string;
     getChatReadDestination(roomId: string): string;
     getChatTypingDestination(roomId: string): string;
+    getChatAssistantStreamDestination(roomId: string): string;
     readonly ROOM_LIST_USER_DESTINATION: string;
     getWebRTCDestination(roomId: string): string;
     getWebRTCUserDestination(): string;
@@ -735,6 +736,42 @@ export interface TypingEvent {
     senderType: 'USER' | 'ASSISTANT';
 }
 
+/**
+ * AI 진행 표시 이벤트 — `/topic/chat/{roomId}/assistant-stream` 의 PHASE/DONE.
+ *
+ * typing 과 별개의 가산 UX 레이어(설계 ASSISTANT_PROGRESS_STREAMING_DESIGN.md). 서버가 typing 도 이중발행하므로
+ * 구버전 SDK 는 본 이벤트를 못 받아도 기존 typing 으로 정상 동작한다. UI 는 `active:true` 면 `label`(또는 `phase`)
+ * 로 단계를 표시하고, `active:false`(DONE·어시 메시지 도착·TTL 만료) 면 해제한다.
+ *
+ * 현재는 PM_BACKSTAGE(방당 단일 PM) 만 phase 를 발행 — 멘션/버튼/14인 경로는 본 이벤트 없이 typing 만.
+ */
+export interface AssistantProgressEvent {
+    /** 채팅방 ID. */
+    roomId: string;
+    /** 어시 응답 1회분 식별(멀티 응답/중복 dedup). 일부 종료 emit 에선 null. */
+    streamId: string | null;
+    /** 진행 주체 페르소나 ID. */
+    personaId: string | null;
+    /** 진행 단계 — `active:true` 일 때. 종료 시 null. */
+    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'WRITING' | null;
+    /** phase 의 기본 표시 라벨(예: "생각 중…"). SDK 매핑 — 커스텀하려면 `phase` 사용. 종료 시 null. */
+    label: string | null;
+    /** true=진행중(PHASE/DELTA) / false=종료(DONE·메시지 도착·TTL). */
+    active: boolean;
+    /** 토큰 스트림 누적 텍스트(B) — DELTA 수신 시 지금까지 모인 전체. 버블에 그대로 렌더. PHASE-only/종료 시 null. */
+    text?: string | null;
+    /** 이번 토큰 청크(B) — append 렌더를 선호할 때. DELTA 수신 시만. */
+    delta?: string | null;
+    /** 토큰 청크 순서/누락 감지(B) — DELTA 수신 시만. */
+    seq?: number | null;
+    /** 종료(DONE) 결과 — DONE 수신 시만. */
+    status?: 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | null;
+    /** 종료(DONE, SUCCEEDED) 시 영속된 최종 메시지 ID. */
+    messageId?: string | null;
+    /** 종료 사유 — 'message'(어시 메시지 도착) / 'timeout'(TTL). DONE 수신 해제엔 없음. */
+    reason?: 'message' | 'timeout' | null;
+}
+
 // ============================================================================
 // Options — constructor & method
 // ============================================================================
@@ -1056,7 +1093,7 @@ export interface RetentionCleanupPayload {
  * TalkFlowClient 이벤트 맵 — 런타임 {@code TalkFlowClient.js} 의 {@code this.emit(...)} 호출 기반.
  *
  * <p><b>Connection 관련</b>: stateChange, connected, disconnected, reconnecting, connectionError, tokenSet, loggedOut</p>
- * <p><b>Chat 관련 (ChatClient 이벤트를 이 이름으로 re-emit)</b>: chatMessage, newChatMessage, messageUpdated, messageDeleted, reactionChanged, linkPreviewAttached, messageRead, typing, memberJoined, memberLeft, roomSubscribed, roomUnsubscribed, roomListSubscribed, roomListUnsubscribed, roomListUpdate, roomListMessage, roomListCreated, roomListJoined, roomListLeft, roomListSelfLeft, roomListRoomUpdated, retentionCleanup</p>
+ * <p><b>Chat 관련 (ChatClient 이벤트를 이 이름으로 re-emit)</b>: chatMessage, newChatMessage, messageUpdated, messageDeleted, reactionChanged, linkPreviewAttached, messageRead, typing, assistantProgress, memberJoined, memberLeft, roomSubscribed, roomUnsubscribed, roomListSubscribed, roomListUnsubscribed, roomListUpdate, roomListMessage, roomListCreated, roomListJoined, roomListLeft, roomListSelfLeft, roomListRoomUpdated, retentionCleanup</p>
  * <p><b>Push 관련</b>: pushEnabled, pushFailed, pushNotification</p>
  * <p><b>WebRTC 관련</b>: localStreamStarted, localStreamStopped, remoteTrack, screenShareStarted, screenShareEnded, deviceChange, mediaStateChanged, callStarted, callEnded, callRequested, callAccepted, callRejected, callCancelled, callInvitation, callBusy, incomingCall, incomingCallWhileBusy, userJoined, userLeft, participantLeft, participantMediaState, peerConnected, peerDisconnected, peerClosed, webrtcError</p>
  */
@@ -1085,6 +1122,7 @@ export interface TalkFlowClientEvents {
     messageTranslated: ChatMessageReceivedPayload;
     messageRead: MessageReadEventPayload;
     typing: TypingEvent;
+    assistantProgress: AssistantProgressEvent;
     memberJoined: MemberChangePayload;
     memberLeft: MemberChangePayload;
     roomSubscribed: { roomId: string };
@@ -1198,6 +1236,7 @@ export interface ChatClientEvents {
     retentionCleanup: RetentionCleanupPayload;
     messageRead: MessageReadEventPayload;
     typing: TypingEvent;
+    assistantProgress: AssistantProgressEvent;
 }
 
 /**