@vibexnpm/talkx 8.2.0 → 8.5.0

package/README.md

@@ -78,6 +78,7 @@ await client.connect(jwtToken, { enablePush: true });
 | [push.md](docs/push.md) | **웹 푸시 알림.** 권한 lifecycle, 활성화 패턴 (자동 vs 사용자 액션), 디바이스 토글, 알림 클릭 라우팅 |
 | [webrtc.md](docs/webrtc.md) | 1:1 / 그룹 통화, 미디어 제어, 디바이스 관리, TURN 서버 |
 | [vote.md](docs/vote.md) | **투표.** 생성(멱등키 필수) · 투표/재투표 · 결과 마스킹 · 이미지 선택지 · 채팅 카드 렌더링 |
+| [video-analysis.md](docs/video-analysis.md) | **영상 분석.** 사용 가능 여부·한도 · 업로드 · 접수(멱등키 필수) · 방 게시 · 상태 조회 · 취소 · 에러 코드 |
 | [events.md](docs/events.md) | 모든 이벤트 레퍼런스. 채팅 이벤트 처리 패턴 (`eventType` 분기 vs 상태 필드 렌더) |
 | [errors.md](docs/errors.md) | 에러 분류 (`PushErrorReason`, `ErrorTypes`), HTTP 상태 코드, 입력 제약 |
 
@@ -209,6 +210,8 @@ renderTranslatedText(translated.translatedText); // 요청자 전용 응답, 방
 
 요약/번역은 동기 호출이라 LLM 처리(수 초) 후 반환됩니다. 요약은 생성된 어시스턴트 메시지가 일반 `chatMessage` 이벤트로도 도착하고, 번역은 요청자 전용 응답으로만 반환됩니다.
 
+영상 분석(`analyzeVideoWithAssistant` · `analyzeVideo`)은 비동기 작업입니다 — 접수하면 `jobId` 가 돌아오고 결과는 조회하거나 방 메시지로 받습니다. [docs/video-analysis.md](docs/video-analysis.md) 를 따릅니다.
+
 ---
 
 ## CDN 사용

package/dist/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; }