@vibexnpm/talkx 7.0.0 → 7.2.0

package/README.md

@@ -72,7 +72,7 @@ await client.connect(jwtToken, { enablePush: true });
 |---|---|
 | [getting-started.md](docs/getting-started.md) | **처음 사용한다면 여기부터.** 설치, API Key, 빠른 시작, 프로덕션 인증 플로우 |
 | [connection.md](docs/connection.md) | 연결 관리, 설정 옵션, 재연결 정책, JWT 토큰 lifecycle, 환경 설정, 상태 확인 |
-| [chat.md](docs/chat.md) | 채팅방 관리, 메시지 전송, 파일 업로드, 답글, 리액션, 핀, 타이핑, 채팅방 리스트 실시간 갱신, **AI 어시스턴트 페르소나 (멘션 응답)** |
+| [chat.md](docs/chat.md) | 채팅방 관리, 메시지 전송, 파일 업로드, 답글, 리액션, 핀, 타이핑, 채팅방 리스트 실시간 갱신, **AI 어시스턴트 페르소나 (멘션 응답)**, **일정 제안 카드 (`scheduleCard`)** |
 | [push.md](docs/push.md) | **웹 푸시 알림.** 권한 lifecycle, 활성화 패턴 (자동 vs 사용자 액션), 디바이스 토글, 알림 클릭 라우팅 |
 | [webrtc.md](docs/webrtc.md) | 1:1 / 그룹 통화, 미디어 제어, 디바이스 관리, TURN 서버 |
 | [vote.md](docs/vote.md) | **투표.** 생성(멱등키 필수) · 투표/재투표 · 결과 마스킹 · 이미지 선택지 · 채팅 카드 렌더링 |

package/dist/index.d.ts

@@ -772,6 +772,58 @@ export interface ChatMessage {
      * 마스킹이 호출자마다 다르게 계산되기 때문이다.</p>
      */
     voteCard?: VoteCard | null;
+    /**
+     * 일정 제안 카드 — PM 이 대화에서 일정을 «제안» 했거나 그 결과를 알리는 메시지의 payload.
+     *
+     * <p><b>모르면 그냥 텍스트로 그려라 — 그게 정상 동작이다.</b> {@code content} 에 같은 내용과 공개 범위 고지가
+     * 사람이 읽는 형태로 들어 있다. 반대로 카드를 그린다면 {@code content} 를 다시 그리지 마라.</p>
+     *
+     * <p>결과(등록됨·거절·확인 불가·취소·만료)는 원래 카드를 고치지 않고 {@code kind} 가 다른 <b>새 메시지</b>로 온다.
+     * 지금 승인할 수 있는지는 카드가 아니라 {@code GET /api/v1/calendar/proposals/{proposalId}} 의
+     * {@code approvable} 이 말한다(SDK 메서드 없음 — 다른 캘린더 API 처럼 REST 로 직접 부른다).</p>
+     */
+    scheduleCard?: ScheduleCard | null;
+}
+
+/**
+ * 일정 제안 카드 payload — 제안 하나에 «승인할까요?» 카드 한 장, 결과 카드는 최대 한 장이다.
+ *
+ * <p>값은 발행 시점 <b>스냅샷</b>이다. 결과는 원래 카드를 고치지 않고 {@code kind} 가 다른 새 메시지로 온다.</p>
+ */
+export interface ScheduleCard {
+    /** 조회·승인·취소의 키. */
+    proposalId: string;
+    /**
+     * {@code 'PROPOSED'}(승인 대기) | {@code 'CREATED'} | {@code 'REJECTED'} | {@code 'UNKNOWN'} |
+     * {@code 'CANCELLED'} | {@code 'EXPIRED'}.
+     *
+     * <p>🔴 {@code 'PROPOSED'} 는 «등록됨» 이 아니다. 🔴 {@code 'UNKNOWN'} 은 «실패» 가 아니라 «등록됐는지 모른다» 다 —
+     * 재시도·다시 요청 버튼을 두지 않는다(만들어졌을 수 있어 다시 만들면 일정이 둘 된다).</p>
+     *
+     * <p>🔴 <b>모르는 값이 올 수 있다</b> — switch 의 default 는 텍스트({@code content}) 폴백으로 둔다.</p>
+     */
+    kind: 'PROPOSED' | 'CREATED' | 'REJECTED' | 'UNKNOWN' | 'CANCELLED' | 'EXPIRED' | (string & {});
+    /** 제목 스냅샷. 비어 있을 수 있다. */
+    title?: string | null;
+    /** 사람이 읽는 시각 — 서버가 <b>제안 당시 해석 타임존</b>으로 만든 문자열(끝에 존 ID). 다시 계산하지 않는다. */
+    whenText?: string | null;
+    /** 장소 스냅샷. 비어 있을 수 있다. */
+    location?: string | null;
+    /** 초대 대상 표시 이름. 비어 있어도 공개 범위는 방 전체다({@link ScheduleCard.visibilityNotice}). */
+    participantNames?: string[] | null;
+    /**
+     * 🔴 공개 범위 고지 — <b>참가자 수와 관계없이 항상</b> 온다. 카드를 그린다면 반드시 표시한다.
+     * 초대한 사람이 없어도 이 방 구성원 전원에게 보이는 일정이다.
+     */
+    visibilityNotice: string;
+    /**
+     * 거절 사유 <b>코드</b> — 🔴 {@code kind === 'REJECTED'} 일 때만 오고, 그때도 없을 수 있다.
+     *
+     * <p>문구 변환은 화면이 한다. 코드가 없거나 모르는 코드면 <b>일반 거절 문구</b>
+     * («일정을 등록하지 못했습니다») 를 보여주고 «다시 요청해 주세요» 를 붙인다. 상류 원문 메시지는 오지 않는다.
+     * 수동 입력 폼의 오류 안내(필드별 표시 등)를 쓰지 않는다 — 제안에는 고칠 폼이 없다.</p>
+     */
+    failureCode?: string;
 }
 
 /**
@@ -1264,6 +1316,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 +1345,7 @@ export interface TypingEvent {
  *
  * 현재는 PM_BACKSTAGE(방당 단일 PM) 만 phase 를 발행 — 멘션/버튼/14인 경로는 본 이벤트 없이 typing 만.
  */
+
 export interface AssistantProgressEvent {
     /** 채팅방 ID. */
     roomId: string;
@@ -1294,7 +1359,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 +1427,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 +1440,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;