@vibexnpm/talkx 8.2.0 → 8.5.0

package/types/__typetests__/roomOwnership.types.ts

@@ -0,0 +1,51 @@
+/**
+ * 방장 위임 · 위임 후 나가기 · 방 삭제 타입 — docs/chat.md 의 예제가 <b>실제로 컴파일되는지</b>.
+ *
+ * <p>jest 는 `.d.ts` 를 보지 않는다. 최상위 client 와 chat 양쪽에 같은 모양이 선언됐는지,
+ * leaveRoom 의 두 번째 인자가 선택인지(일반 참가자 기존 호출 유지), 새 이벤트가 구독 가능한지를 tsc 로 고정한다.</p>
+ *
+ * <p>실행: {@code npm run typecheck}</p>
+ */
+import TalkFlowClient, { RoomListEventType } from '../index';
+import type { ChatClient, ChatRoomResponse, LeaveRoomOptions, RoomListUpdateEvent } from '../index';
+
+declare const talkflow: TalkFlowClient;
+/** {@code talkflow.chat} 은 연결 전 null 이라 선언이 nullable 이다 — 연결된 chat 을 직접 받는 모양으로 본다. */
+declare const chat: ChatClient;
+declare const roomId: string;
+
+async function ownerExit(): Promise<void> {
+    // 일반 참가자 — 기존 호출 그대로
+    await talkflow.leaveRoom(roomId);
+    // 방장 — 위임 후 나가기
+    const options: LeaveRoomOptions = { newOwnerId: 'u2' };
+    await talkflow.leaveRoom(roomId, options);
+    await chat.leaveRoom(roomId, { newOwnerId: 'u2' });
+    // 방장 — 방 삭제
+    await talkflow.deleteRoom(roomId);
+    await chat.deleteRoom(roomId);
+}
+
+async function transfer(): Promise<ChatRoomResponse> {
+    const fromRoot: ChatRoomResponse = await talkflow.transferOwnership(roomId, 'u2');
+    void fromRoot;
+    return chat.transferOwnership(roomId, 'u2');
+}
+
+talkflow.on('roomListOwnerChanged', (event: RoomListUpdateEvent) => {
+    const previousOwner: string | undefined = event.actorId;
+    // docs/chat.md 예제 — members[0] 이 새 방장
+    const newOwnerId: string | undefined = event.members?.[0]?.userId;
+    const nickname: string | null | undefined = event.members?.[0]?.nickname;
+    const count: number | undefined = event.activeParticipantCount;
+    void [previousOwner, newOwnerId, nickname, count];
+});
+talkflow.on('roomListDeleted', (event: RoomListUpdateEvent) => {
+    const deletedRoom: string = event.roomId;
+    void deletedRoom;
+});
+
+const ownerChanged: 'ROOM_OWNER_CHANGED' = RoomListEventType.ROOM_OWNER_CHANGED;
+const deleted: 'ROOM_DELETED' = RoomListEventType.ROOM_DELETED;
+
+void [ownerExit, transfer, ownerChanged, deleted];

package/types/__typetests__/videoAnalysis.types.ts

@@ -0,0 +1,131 @@
+/**
+ * 영상 분석 타입 — docs/video-analysis.md 의 예제가 <b>실제로 컴파일되는지</b>.
+ *
+ * <p>jest 는 `.d.ts` 를 보지 않는다. 문서가 약속한 모양(멱등키 필수 · 대상 두 종류 · 종료 판정은 status ·
+ * 시각은 문자열 · 취소 응답에는 결과가 없음 · 진행 단계 VIDEO_ANALYSIS)이 선언과 맞는지 여기서 tsc 로 고정한다.</p>
+ *
+ * <p>실행: {@code npm run typecheck}</p>
+ */
+import TalkFlowClient from '../index';
+import type {
+    AssistantProgressEvent,
+    ChatMessage,
+    VideoAnalysisCancellation,
+    VideoAnalysisCapabilities,
+    VideoAnalysisJob,
+    VideoAnalysisRequest,
+    VideoAnalysisSource,
+    VideoAsset,
+} from '../index';
+
+declare const talkflow: TalkFlowClient;
+declare const file: File;
+declare const roomId: string;
+declare const personaId: string;
+declare const message: ChatMessage;
+declare const idempotencyKey: string;
+
+// 1) 사용 가능 여부와 한도 — 화면은 이 응답의 숫자를 쓴다.
+async function gate(): Promise<boolean> {
+    const caps: VideoAnalysisCapabilities = await talkflow.getVideoAnalysisCapabilities();
+    const limits: number[] = [caps.maxSources, caps.maxBytesPerSource, caps.maxTotalDurationMs, caps.framesPerSecond];
+    const formats: string[] = caps.mimeTypes;
+    void [limits, formats, caps.model];
+    return caps.available && caps.standaloneUploadConfigured;
+}
+
+// 2) 업로드 — 진행률은 객체 하나, 만료 시각은 문자열(ISO-8601)이다.
+async function upload(controller: AbortController): Promise<VideoAsset> {
+    const asset = await talkflow.uploadVideoAsset(file, {
+        onProgress: ({ loaded, total, percent }) => { void [loaded, total, percent]; },
+        signal: controller.signal,
+    });
+    const expiresAt: string = asset.expiresAt;
+    const lengthMs: number = asset.durationMs;
+    void [expiresAt, lengthMs, asset.fileName, asset.mimeType, asset.sizeBytes];
+    return asset;
+}
+
+// 3) 대상은 두 종류다 — 업로드 자산과 채팅 첨부. 구간은 선택이다.
+const uploaded: VideoAnalysisSource = { type: 'UPLOADED_ASSET', assetId: 'asset-1' };
+const attachment: VideoAnalysisSource = {
+    type: 'CHAT_ATTACHMENT',
+    roomId,
+    messageId: message.messageId,
+    attachmentId: message.fileMetaDataList?.[0]?.fileId ?? '',
+    startMs: 10_000,
+    endMs: 30_000,
+};
+// @ts-expect-error 채팅 첨부는 방·메시지·첨부 ID 가 모두 있어야 한다
+const incompleteAttachment: VideoAnalysisSource = { type: 'CHAT_ATTACHMENT', roomId };
+// @ts-expect-error 외부 URL 은 대상이 될 수 없다
+const external: VideoAnalysisSource = { type: 'URL', url: 'https://example.com/video.mp4' };
+void [incompleteAttachment, external];
+
+// 4) 접수는 멱등키가 필수다 — 비공개 분석과 방 게시 분석 모두.
+const analysis: VideoAnalysisRequest = { instruction: '요약해 주세요.', locale: 'ko-KR', sources: [uploaded] };
+const privateJob: Promise<VideoAnalysisJob> = talkflow.analyzeVideo(analysis, { idempotencyKey });
+const roomJob: Promise<VideoAnalysisJob> = talkflow.analyzeVideoWithAssistant(roomId, {
+    personaId,
+    triggerMessageId: message.messageId,
+    analysis: { instruction: '이 구간의 발언을 요약해 주세요.', sources: [attachment] },
+}, { idempotencyKey });
+// @ts-expect-error 키 없이 접수할 수 없다
+talkflow.analyzeVideo(analysis);
+// @ts-expect-error 방 게시 분석도 키가 필수다
+talkflow.analyzeVideoWithAssistant(roomId, { personaId, triggerMessageId: message.messageId, analysis });
+void [privateJob, roomJob];
+
+// 5) 종료는 status 로 판정한다 — 값이 늘면 이 switch 가 컴파일되지 않는다.
+function isTerminal(job: VideoAnalysisJob): boolean {
+    switch (job.status) {
+        case 'QUEUED':
+        case 'RUNNING':
+            return false;
+        case 'SUCCEEDED':
+        case 'FAILED':
+        case 'CANCELLED':
+            return true;
+        default: {
+            const unreachable: never = job.status;
+            return unreachable;
+        }
+    }
+}
+
+// 6) 결과는 성공일 때만 있고, 근거 시각은 없을 수 있다(둘 다 null). 시각 필드는 숫자가 아니다.
+function render(job: VideoAnalysisJob): string[] {
+    const createdAt: string = job.createdAt;
+    const deadline: number = Date.parse(job.deadlineAt);
+    // @ts-expect-error createdAt 은 epoch millis 가 아니라 ISO-8601 문자열이다
+    const wrong: number = job.createdAt;
+    void [createdAt, deadline, wrong, job.detail, job.errorCode, job.resultMessageId, job.deliveryPending];
+    if (job.result === null) return [];
+    const known = new Set(job.sources.map((source) => source.sourceId));
+    return job.result.evidence
+        .filter((evidence) => known.has(evidence.sourceId))
+        .map((evidence) => {
+            const range = evidence.startMs === null || evidence.endMs === null
+                ? '(시각 미상)'
+                : `${evidence.startMs}–${evidence.endMs}`;
+            const modality: 'VISUAL' | 'AUDIO' | 'BOTH' = evidence.modality;
+            return `${evidence.sourceId} ${range} ${modality} ${evidence.observation}`;
+        });
+}
+
+// 7) 취소 응답에는 상태만 있다 — 결과는 getVideoAnalysis 로 읽는다.
+async function cancel(jobId: string): Promise<boolean> {
+    const cancelled: VideoAnalysisCancellation = await talkflow.cancelVideoAnalysis(jobId);
+    // @ts-expect-error 취소 응답은 결과를 담지 않는다
+    void cancelled.result;
+    const latest: VideoAnalysisJob = await talkflow.getVideoAnalysis(jobId);
+    void [cancelled.deliveryPending, latest];
+    return cancelled.status === 'CANCELLED';
+}
+
+// 8) 진행 단계에 VIDEO_ANALYSIS 가 있다 — phase 를 직접 분기하는 화면이 쓸 수 있어야 한다.
+function isVideoAnalysis(event: AssistantProgressEvent): boolean {
+    return event.active && event.phase === 'VIDEO_ANALYSIS';
+}
+
+void [gate, upload, isTerminal, render, cancel, isVideoAnalysis];

package/types/index.d.ts

@@ -501,6 +501,12 @@ export interface PmPromptPreviewResponse {
     composedPrompt: string;
 }
 
+/** {@code leaveRoom} 옵션 — 방장의 «위임 후 나가기». */
+export interface LeaveRoomOptions {
+    /** 방장을 넘겨받을 사람 userId. 방의 활성 사람 참가자이면서 활성 계정이어야 한다. 일반 참가자는 생략. */
+    newOwnerId?: string;
+}
+
 /**
  * {@link ChatClient.inviteToGroupRoom} 의 신규 형식 입력. 회원 / 어시스턴트 동시 초대 지원.
  * 둘 중 하나 이상 필수.
@@ -522,6 +528,8 @@ export const RoomListEventType: {
     readonly ROOM_UPDATED: 'ROOM_UPDATED';
     readonly ROOM_KICKED: 'ROOM_KICKED';
     readonly ROOM_BANNED: 'ROOM_BANNED';
+    readonly ROOM_OWNER_CHANGED: 'ROOM_OWNER_CHANGED';
+    readonly ROOM_DELETED: 'ROOM_DELETED';
     readonly MESSAGE_RETENTION_CLEANUP: 'MESSAGE_RETENTION_CLEANUP';
     readonly ROOM_UNREAD_UPDATED: 'ROOM_UNREAD_UPDATED';
 };
@@ -1266,10 +1274,24 @@ export interface RoomMeta {
 }
 
 /** 채팅방 리스트 실시간 업데이트 이벤트. */
+/** 방 목록 이벤트의 사용자 정보 — 서버 {@code RoomListEvent.MemberInfo}. */
+export interface RoomListMemberInfo {
+    userId: string;
+    nickname?: string | null;
+    profileUrl?: string | null;
+}
+
 export interface RoomListUpdateEvent {
     eventType: RoomListEventTypeValue;
     roomId: string;
     actorId?: string;
+    /**
+     * 입장·퇴장·추방·차단한 사용자, 또는 {@code ROOM_OWNER_CHANGED} 의 새 방장(1명). 서버 {@code RoomListEvent.MemberInfo}.
+     * {@code ROOM_JOINED}·{@code ROOM_LEFT}·{@code ROOM_KICKED}·{@code ROOM_BANNED}·{@code ROOM_OWNER_CHANGED} 에서만 채워진다.
+     */
+    members?: RoomListMemberInfo[];
+    /** 이벤트 직후 활성 참가자 수 — 입장·퇴장·추방·차단·위임 이벤트에서 채워지고, {@code ROOM_DELETED} 는 0. */
+    activeParticipantCount?: number;
     /** {@code MESSAGE_*} 이벤트의 방 마지막 메시지 시각(epoch millis). 그 외 이벤트에서는 undefined. */
     lastMessageAt?: number | null;
     /** 이벤트 발행 시각(epoch millis). */
@@ -1318,6 +1340,71 @@ export interface RoomUnreadUpdatedEvent {
     unreadVersion: number;
 }
 
+/** Gmail 새 메일 미리보기 — 서버 `MAIL_CHANGED.messages[]` 원소. 본문은 없다. */
+export interface MailPreview {
+    messageId: string;
+    threadId?: string | null;
+    from?: { name?: string | null; email: string } | null;
+    subject?: string | null;
+    /** ISO-8601 UTC. */
+    receivedAt?: string | null;
+}
+
+/**
+ * `mailChanged` 이벤트 — 서버 `/user/queue/mail` 그대로. 받으면 열려 있는 메일 목록·안읽은 수를 다시 읽는다.
+ * 읽음·보관 같은 변화면 `messages` 가 비어 있다(새 메일 알림을 띄우지 않는다).
+ */
+export interface MailChangedEvent {
+    eventType: 'MAIL_CHANGED';
+    connectionId: string;
+    /** 받은메일함 안읽은 수, 모르면 -1. */
+    inboxUnread: number;
+    newMessages: number;
+    /** true 면 놓친 변화가 있을 수 있다 — 목록을 첫 쪽부터 다시 읽는다. */
+    resync: boolean;
+    timestamp: string;
+    messages: MailPreview[];
+}
+
+/**
+ * `newMail` 이벤트 — 새 메일 한 통. 웹소켓 미리보기(`source: 'socket'`)와 포그라운드 FCM 메일 푸시(`source: 'push'`)를
+ * `(projectId, connectionId, messageId)` 로 합쳐 메일마다 한 번만 온다.
+ */
+export interface NewMailEvent {
+    projectId: string | null;
+    connectionId: string;
+    messageId: string;
+    threadId: string | null;
+    /** 보낸 사람 표시(이름, 없으면 주소). */
+    sender: string | null;
+    /** 웹소켓으로 왔을 때만. */
+    from: { name?: string | null; email: string } | null;
+    subject: string | null;
+    /** 웹소켓으로 왔을 때만(ISO-8601 UTC). */
+    receivedAt: string | null;
+    source: 'socket' | 'push';
+}
+
+/**
+ * `newMailSummary` 이벤트 — 한 번에 4통 이상 온 묶음 푸시(포그라운드). 받은메일함을 다시 읽는다.
+ * 묶은 메일 중 아직 `newMail` 로 알리지 않은 것만 센다 — 전부 알린 메일이면 오지 않는다.
+ */
+export interface NewMailSummaryEvent {
+    projectId: string | null;
+    connectionId: string;
+    /** 처음 알리는 메일 수(구버전 서버의 묶음이면 서버가 준 건수). */
+    count: number | null;
+    /** 처음 알리는 메일 ID(구버전 서버의 묶음이면 빈 배열). */
+    messageIds: string[];
+    source: 'push';
+}
+
+/** 알림 클릭으로 열린 앱이 꺼내는 메일 이동 — `messageId` 가 없으면(묶음 알림) 받은메일함으로. */
+export interface PendingMail {
+    connectionId: string;
+    messageId: string | null;
+}
+
 /** 포그라운드 푸시 알림 payload. */
 export interface PushNotificationPayload {
     title: string;
@@ -1373,6 +1460,8 @@ export interface DocumentAnalysisProgress {
  *   렌더가 그대로 동작한다.
  *
  * 현재는 PM_BACKSTAGE(방당 단일 PM) 만 phase 를 발행 — 멘션/버튼/14인 경로는 본 이벤트 없이 typing 만.
+ * 예외는 영상 분석 버튼({@code analyzeVideoWithAssistant})으로, 어시스턴트가 붙어 있는 방이면 방 종류와
+ * 무관하게 `VIDEO_ANALYSIS` 를 발행한다(docs/video-analysis.md).
  */
 
 export interface AssistantProgressEvent {
@@ -1388,7 +1477,7 @@ export interface AssistantProgressEvent {
     /** 진행 주체 페르소나 ID. */
     personaId: string | null;
     /** 진행 단계 — `active:true` 일 때. 종료 시 null. */
-    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'WRITING' | null;
+    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'VIDEO_ANALYSIS' | 'WRITING' | null;
     /** DOCUMENT_ANALYSIS의 실측 진행률. 같은 phase heartbeat 사이와 재입장 후에도 보존된다. */
     progress?: DocumentAnalysisProgress | null;
     /** phase 의 기본 표시 라벨(예: "생각 중…"). SDK 매핑 — 커스텀하려면 `phase` 사용. 종료 시 null. */
@@ -1416,7 +1505,10 @@ export interface AssistantProgressEvent {
     textAvailable?: boolean;
     /** 종료(DONE) 결과 — DONE 수신 시만. */
     status?: 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | null;
-    /** 종료(DONE, SUCCEEDED) 시 영속된 최종 메시지 ID. */
+    /**
+     * 종료(DONE) 시 방에 올라간 메시지 ID. 보통 `SUCCEEDED` 에만 있다.
+     * 영상 분석은 실패 안내 메시지의 ID 가 `FAILED`·`TIMEOUT` 에도 실린다 — 성공 여부는 `status` 로 판정한다.
+     */
     messageId?: string | null;
     /**
      * 종료 사유 — 'timeout'(TTL 만료). DONE 수신 해제엔 없음.
@@ -1456,7 +1548,7 @@ export interface AssistantRoomProgressEvent {
     /** 표시 기준이 된 stream (가장 최근 갱신). 없으면 null. */
     streamId: string | null;
     personaId: string | null;
-    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'WRITING' | null;
+    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'VIDEO_ANALYSIS' | 'WRITING' | null;
     progress?: DocumentAnalysisProgress | null;
     label: string | null;
     /** 표시 기준 stream 의 누적 본문. `textAvailable:false` 거나 진행 중이 아니면 null. */
@@ -1469,7 +1561,7 @@ export interface AssistantRoomProgressEvent {
 export interface AssistantProgressStreamSnapshot {
     streamId: string;
     personaId: string | null;
-    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'WRITING' | null;
+    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'DOCUMENT_ANALYSIS' | 'VIDEO_ANALYSIS' | 'WRITING' | null;
     progress?: DocumentAnalysisProgress | null;
     label: string | null;
     text: string | null;
@@ -1946,9 +2038,16 @@ export interface TalkFlowClientEvents {
     roomListBanned: RoomListUpdateEvent;
     /** 본인이 영구 차단당함. */
     roomListSelfBanned: RoomListUpdateEvent;
+    /** 방장 위임 (ROOM_OWNER_CHANGED) — actorId 는 이전 방장, members[0] 이 새 방장. */
+    roomListOwnerChanged: RoomListUpdateEvent;
+    /** 방장이 방을 삭제 (ROOM_DELETED) — 리스트에서 제거 + 열린 방 화면 닫기. actorId 는 삭제한 방장. */
+    roomListDeleted: RoomListUpdateEvent;
     roomListRoomUpdated: RoomListUpdateEvent;
     /** 내가 어느 기기에서 읽든 방별 미독 절대값(+version)을 통지 — 크로스-디바이스 badge 동기화. */
     roomListUnreadUpdated: RoomUnreadUpdatedEvent;
+    mailSubscribed: Record<string, unknown>;
+    mailUnsubscribed: Record<string, unknown>;
+    mailChanged: MailChangedEvent;
     retentionCleanup: RetentionCleanupPayload;
 
     // 갭 복구 — 복구된 메시지 자체는 일반 chatMessage 로 재생되므로 아래는 모두 선택 구독용.
@@ -1979,6 +2078,10 @@ export interface TalkFlowClientEvents {
      */
     pushFailed: PushFailedPayload;
     pushNotification: PushNotificationPayload;
+    /** Gmail 새 메일 한 통 — 웹소켓·포그라운드 푸시를 합쳐 메일마다 한 번. 메일 푸시는 pushNotification 으로 오지 않는다. */
+    newMail: NewMailEvent;
+    /** Gmail 묶음 푸시(4통 이상) — 포그라운드. */
+    newMailSummary: NewMailSummaryEvent;
 
     // WebRTC (re-emit from WebRTCClient)
     localStreamStarted: unknown;
@@ -2049,9 +2152,16 @@ export interface ChatClientEvents {
     roomListBanned: RoomListUpdateEvent;
     /** 본인이 영구 차단당함. */
     roomListSelfBanned: RoomListUpdateEvent;
+    /** 방장 위임 (ROOM_OWNER_CHANGED) — actorId 는 이전 방장, members[0] 이 새 방장. */
+    roomListOwnerChanged: RoomListUpdateEvent;
+    /** 방장이 방을 삭제 (ROOM_DELETED) — 리스트에서 제거 + 열린 방 화면 닫기. actorId 는 삭제한 방장. */
+    roomListDeleted: RoomListUpdateEvent;
     roomListRoomUpdated: RoomListUpdateEvent;
     /** 내가 어느 기기에서 읽든 방별 미독 절대값(+version)을 통지 — 크로스-디바이스 badge 동기화. */
     roomListUnreadUpdated: RoomUnreadUpdatedEvent;
+    mailSubscribed: Record<string, unknown>;
+    mailUnsubscribed: Record<string, unknown>;
+    mailChanged: MailChangedEvent;
     retentionCleanup: RetentionCleanupPayload;
     messageRead: MessageReadEventPayload;
     typing: TypingEvent;
@@ -2124,6 +2234,12 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
     summarizeWithAssistant(roomId: string, options: SummarizeToolRequest): Promise<AssistantToolResult>;
     /** 특정 메시지 온디맨드 번역 (버튼 진입점, 동기, 요청자 전용 응답). */
     translateWithAssistant(roomId: string, options: TranslateToolRequest): Promise<OnDemandTranslationResponse>;
+    uploadVideoAsset(file: File, options?: FileUploadOptions): Promise<VideoAsset>;
+    analyzeVideo(analysis: VideoAnalysisRequest, options: VideoAnalysisOptions): Promise<VideoAnalysisJob>;
+    analyzeVideoWithAssistant(roomId: string, request: RoomVideoAnalysisRequest, options: VideoAnalysisOptions): Promise<VideoAnalysisJob>;
+    getVideoAnalysis(jobId: string): Promise<VideoAnalysisJob>;
+    cancelVideoAnalysis(jobId: string): Promise<VideoAnalysisCancellation>;
+    getVideoAnalysisCapabilities(): Promise<VideoAnalysisCapabilities>;
     /** Rolling 누적 요약 갱신 트리거 (비동기). 완료는 {@code summaryUpdate} 이벤트 + {@link getSummary} 로 확인. */
     refreshSummary(roomId: string, options?: RefreshSummaryOptions): Promise<RefreshSummaryResult>;
     /** Rolling 누적 요약 조회 — rollup + segment 페이지. 저장된 요약의 단일 진실 소스. */
@@ -2161,7 +2277,15 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
     /** PM 프롬프트 합성 미리보기 (전역+회사+방) — 참여자 전체. */
     previewRoomPmPrompt(roomId: string): Promise<PmPromptPreviewResponse>;
     joinGroupRoom(roomId: string, password?: string): Promise<ChatRoomResponse>;
-    leaveRoom(roomId: string): Promise<void>;
+    /**
+     * 방 나가기. 방장은 {@code options.newOwnerId} 로 «위임 후 나가기» — 없으면 409 {@code ROOM_OWNER_CANNOT_LEAVE}.
+     * 방을 없애고 나가려면 {@link deleteRoom}.
+     */
+    leaveRoom(roomId: string, options?: LeaveRoomOptions): Promise<void>;
+    /** 방장 위임 — 방장은 방에 남고 MEMBER 가 된다. 방장(OWNER) 전용. 갱신된 방 상세(역할 반영)를 돌려준다. */
+    transferOwnership(roomId: string, newOwnerId: string): Promise<ChatRoomResponse>;
+    /** 방 삭제(소프트) — 방장(OWNER) 전용. 참가자 전원 퇴장, 이후 enterRoom·getRoomInfo 403·joinGroupRoom 404. 본인 구독 자동 해제. */
+    deleteRoom(roomId: string): Promise<void>;
     updateGroupRoom(roomId: string, data: UpdateGroupRoomData): Promise<ChatRoomResponse>;
     inviteToGroupRoom(roomId: string, userIds: string[]): Promise<ChatRoomResponse>;
     inviteToGroupRoom(roomId: string, data: InviteToRoomData): Promise<ChatRoomResponse>;
@@ -2248,6 +2372,10 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
     subscribeRoomList(): Promise<void>;
     unsubscribeRoomList(): void;
     isRoomListSubscribed(): boolean;
+    /** Gmail 메일함 변화 구독(`/user/queue/mail`) — 자동 구독하지 않는다. */
+    subscribeMail(): Promise<void>;
+    unsubscribeMail(): void;
+    isMailSubscribed(): boolean;
     getSubscribedRooms(): string[];
     isSubscribed(roomId: string): boolean;
 
@@ -2398,6 +2526,8 @@ export const PushErrorCode: {
 
 export class PushManager {
     consumePendingRoom(): Promise<string | null>;
+    /** 알림 클릭(cold start)으로 저장된 Gmail 메일 이동을 꺼내고 지운다 — 10분 안의 것만. */
+    consumePendingMail(): Promise<PendingMail | null>;
     reset(): void;
     getToken(): string | null;
     isEnabled(): boolean;
@@ -2408,6 +2538,7 @@ export class PushManager {
     /** 현재 디바이스의 푸시 수신 여부 토글. */
     setCurrentDeviceEnabled(enabled: boolean): Promise<void>;
     static consumePendingRoom(projectId?: string): Promise<string | null>;
+    static consumePendingMail(projectId?: string): Promise<PendingMail | null>;
     /**
      * 현재 브라우저의 푸시 권한 상태. 인스턴스 없이도 호출 가능.
      */
@@ -2539,6 +2670,8 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     /** 푸시 상태 초기화 — 로그아웃 또는 사용자 전환 시 호출. logout() 내부에서 자동 호출됨. */
     resetPush(): void;
     consumePendingRoom(): Promise<string | null>;
+    /** 알림 클릭(cold start)으로 저장된 Gmail 메일 이동을 꺼내고 지운다 — 앱 부팅 때 한 번. */
+    consumePendingMail(): Promise<PendingMail | null>;
     /** 현재 디바이스의 푸시 수신 여부 토글. enable 선행 안 됐으면 undefined 반환. */
     setCurrentDeviceEnabled(enabled: boolean): Promise<void> | undefined;
     /** 특정 디바이스 토글 (관리 UI 용). enable 선행 안 됐으면 undefined 반환. */
@@ -2567,6 +2700,12 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     summarizeWithAssistant(roomId: string, options: SummarizeToolRequest): Promise<AssistantToolResult>;
     /** 특정 메시지 온디맨드 번역 (버튼 진입점, 동기, 요청자 전용 응답). */
     translateWithAssistant(roomId: string, options: TranslateToolRequest): Promise<OnDemandTranslationResponse>;
+    uploadVideoAsset(file: File, options?: FileUploadOptions): Promise<VideoAsset>;
+    analyzeVideo(analysis: VideoAnalysisRequest, options: VideoAnalysisOptions): Promise<VideoAnalysisJob>;
+    analyzeVideoWithAssistant(roomId: string, request: RoomVideoAnalysisRequest, options: VideoAnalysisOptions): Promise<VideoAnalysisJob>;
+    getVideoAnalysis(jobId: string): Promise<VideoAnalysisJob>;
+    cancelVideoAnalysis(jobId: string): Promise<VideoAnalysisCancellation>;
+    getVideoAnalysisCapabilities(): Promise<VideoAnalysisCapabilities>;
     /** Rolling 누적 요약 갱신 트리거 (비동기). 완료는 {@code summaryUpdate} 이벤트 + {@link getSummary} 로 확인. */
     refreshSummary(roomId: string, options?: RefreshSummaryOptions): Promise<RefreshSummaryResult>;
     /** Rolling 누적 요약 조회 — rollup + segment 페이지. 저장된 요약의 단일 진실 소스. */
@@ -2604,7 +2743,15 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     /** PM 프롬프트 합성 미리보기 (전역+회사+방) — 참여자 전체. */
     previewRoomPmPrompt(roomId: string): Promise<PmPromptPreviewResponse>;
     joinGroupRoom(roomId: string, password?: string): Promise<ChatRoomResponse>;
-    leaveRoom(roomId: string): Promise<void>;
+    /**
+     * 방 나가기. 방장은 {@code options.newOwnerId} 로 «위임 후 나가기» — 없으면 409 {@code ROOM_OWNER_CANNOT_LEAVE}.
+     * 방을 없애고 나가려면 {@link deleteRoom}.
+     */
+    leaveRoom(roomId: string, options?: LeaveRoomOptions): Promise<void>;
+    /** 방장 위임 — 방장은 방에 남고 MEMBER 가 된다. 방장(OWNER) 전용. 갱신된 방 상세(역할 반영)를 돌려준다. */
+    transferOwnership(roomId: string, newOwnerId: string): Promise<ChatRoomResponse>;
+    /** 방 삭제(소프트) — 방장(OWNER) 전용. 참가자 전원 퇴장, 이후 enterRoom·getRoomInfo 403·joinGroupRoom 404. 본인 구독 자동 해제. */
+    deleteRoom(roomId: string): Promise<void>;
     updateGroupRoom(roomId: string, data: UpdateGroupRoomData): Promise<ChatRoomResponse>;
     inviteToGroupRoom(roomId: string, userIds: string[]): Promise<ChatRoomResponse>;
     inviteToGroupRoom(roomId: string, data: InviteToRoomData): Promise<ChatRoomResponse>;
@@ -2687,6 +2834,10 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     subscribeRoomList(): Promise<void>;
     unsubscribeRoomList(): void;
     isRoomListSubscribed(): boolean;
+    /** Gmail 메일함 변화 구독(`/user/queue/mail`) — 자동 구독하지 않는다. */
+    subscribeMail(): Promise<void>;
+    unsubscribeMail(): void;
+    isMailSubscribed(): boolean;
     getSubscribedRooms(): string[];
     isSubscribed(roomId: string): boolean;
 
@@ -2815,3 +2966,35 @@ export class RoomUnreadReconciler {
     /** 전체 초기화. */
     clear(): void;
 }
+
+
+/** Caller retains this key and reuses it after a lost response. */
+export interface VideoAnalysisOptions { idempotencyKey: string; }
+export type VideoAnalysisSource =
+    | { type: 'UPLOADED_ASSET'; assetId: string; startMs?: number; endMs?: number }
+    | { type: 'CHAT_ATTACHMENT'; roomId: string; messageId: string; attachmentId: string; startMs?: number; endMs?: number };
+export interface VideoAnalysisRequest { instruction: string; locale?: string; sources: VideoAnalysisSource[]; }
+export interface RoomVideoAnalysisRequest { personaId: string; triggerMessageId: string; analysis: VideoAnalysisRequest; }
+export interface VideoAsset { assetId: string; fileName: string; mimeType: string; sizeBytes: number; durationMs: number; expiresAt: string; }
+export interface VideoAnalysisResult {
+    answerMarkdown: string;
+    evidence: { sourceId: string; startMs: number | null; endMs: number | null; modality: 'VISUAL' | 'AUDIO' | 'BOTH'; observation: string }[];
+    limitations: string[];
+    /** Requested temporal coverage and sampling; not a guarantee every frame was inspected. */
+    coverage: { sourceId: string; startMs: number; endMs: number; framesPerSecond: number }[];
+    model: string; promptVersion: string;
+    usage: { uncachedInputTokens: number; cachedInputTokens: number; outputTokens: number; thinkingTokens: number };
+}
+export interface VideoAnalysisJob {
+    jobId: string; status: 'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED'; phase: string;
+    errorCode: string | null; detail: string | null;
+    sources: { sourceId: string; assetId: string | null; roomId: string | null; messageId: string | null; attachmentId: string | null; startMs: number | null; endMs: number | null }[];
+    result: VideoAnalysisResult | null; createdAt: string; deadlineAt: string;
+    roomId: string | null; streamId: string | null; resultMessageId: string | null; deliveryPending: boolean;
+}
+export interface VideoAnalysisCapabilities {
+    available: boolean; model: string; standaloneUploadConfigured: boolean; maxSources: number;
+    maxBytesPerSource: number; maxTotalDurationMs: number; framesPerSecond: number; mimeTypes: string[];
+}
+
+export interface VideoAnalysisCancellation { jobId: string; status: VideoAnalysisJob['status']; deliveryPending: boolean; }