@vibexnpm/talkx 8.13.0 → 9.1.0

package/types/index.d.ts

@@ -39,37 +39,48 @@ export const ErrorTypes: {
     readonly CHAT_SUBSCRIPTION_FAILED: 'CHAT_SUBSCRIPTION_FAILED';
     readonly MEDIA_ACCESS_DENIED: 'MEDIA_ACCESS_DENIED';
     readonly SCREEN_SHARE_DENIED: 'SCREEN_SHARE_DENIED';
-    readonly PEER_CONNECTION_FAILED: 'PEER_CONNECTION_FAILED';
-    readonly ICE_CONNECTION_FAILED: 'ICE_CONNECTION_FAILED';
-    readonly SIGNALING_FAILED: 'SIGNALING_FAILED';
+    readonly MEDIA_CONNECTION_FAILED: 'MEDIA_CONNECTION_FAILED';
     readonly DEVICE_SWITCH_FAILED: 'DEVICE_SWITCH_FAILED';
     readonly ENUMERATE_DEVICES_FAILED: 'ENUMERATE_DEVICES_FAILED';
     readonly CALL_ROOM_NOT_FOUND: 'CALL_ROOM_NOT_FOUND';
+    readonly CALL_ALREADY_ACTIVE: 'CALL_ALREADY_ACTIVE';
+    readonly NO_ACTIVE_CALL: 'NO_ACTIVE_CALL';
     readonly INVALID_STATE: 'INVALID_STATE';
     readonly UNKNOWN_ERROR: 'UNKNOWN_ERROR';
 };
 export type ErrorTypeValue = typeof ErrorTypes[keyof typeof ErrorTypes];
 
-export const SignalTypes: {
-    readonly CALL_OFFER: 'call_offer';
-    readonly CALL_ANSWER: 'call_answer';
-    readonly ICE_CANDIDATE: 'ice_candidate';
-    readonly JOIN_ROOM: 'join_room';
-    readonly LEAVE_ROOM: 'leave_room';
-    readonly PEER_JOINED: 'peer_joined';
-    readonly PEER_LEFT: 'peer_left';
-    readonly VIDEO_STATE_CHANGED: 'video_state_changed';
-    readonly AUDIO_STATE_CHANGED: 'audio_state_changed';
-    readonly SCREEN_SHARE_STARTED: 'screen_share_started';
-    readonly SCREEN_SHARE_ENDED: 'screen_share_ended';
-    readonly CALL_REQUEST: 'call_request';
-    readonly CALL_ACCEPT: 'call_accept';
-    readonly CALL_REJECT: 'call_reject';
-    readonly CALL_CANCEL: 'call_cancel';
-    readonly CALL_END: 'call_end';
-    readonly CALL_INVITATION: 'call_invitation';
-    readonly CALL_BUSY: 'call_busy';
+/**
+ * 서버 → 클라이언트 통화 이벤트 종류(서버 WebRTCMessageType). 클라이언트는 통화 신호를 보내지 않는다 — 통화 제어는 REST, 미디어는
+ * LiveKit(v9.0.0).
+ */
+export const CallEventTypes: {
+    readonly INVITATION: 'call_invitation';
+    readonly ANSWERED: 'call_answered';
+    readonly REJECT: 'call_reject';
+    readonly CANCEL: 'call_cancel';
+    readonly END: 'call_end';
+};
+
+/** 통화 종류. */
+export const CallKind: {
+    readonly DIRECT: 'DIRECT';
+    readonly GROUP: 'GROUP';
+};
+export type CallKindValue = typeof CallKind[keyof typeof CallKind];
+
+/**
+ * 통화 상태 — ringing(받는 쪽 울림)·connecting(입장·미디어 접속 중)·connected·reconnecting(LiveKit 재접속 또는 «제거됨» 뒤 다시
+ * 입장 중)·ended.
+ */
+export const CallState: {
+    readonly RINGING: 'ringing';
+    readonly CONNECTING: 'connecting';
+    readonly CONNECTED: 'connected';
+    readonly RECONNECTING: 'reconnecting';
+    readonly ENDED: 'ended';
 };
+export type CallStateValue = typeof CallState[keyof typeof CallState];
 
 /**
  * SDK 가 런타임에 export 하는 ChatMessageType 상수.
@@ -573,7 +584,6 @@ export const WebSocketPaths: {
     readonly CHAT_SEND: string;
     readonly CHAT_READ: string;
     readonly CHAT_TYPING: string;
-    readonly WEBRTC_SIGNAL: string;
 };
 
 export const DefaultConfig: {
@@ -584,7 +594,8 @@ export const DefaultConfig: {
     readonly heartbeatIncoming: number;
     readonly heartbeatOutgoing: number;
     readonly apiTimeout: number;
-    readonly iceServers: RTCIceServer[];
+    /** 받는 쪽 울림을 스스로 끄는 시각(ms) — 서버 울림 상한 60초 + 여유. */
+    readonly callRingTimeoutMs: number;
     readonly logLevel: LogLevelValue;
 };
 
@@ -1399,6 +1410,219 @@ export interface PmReportDetail extends PmReport {
     contentLength: number;
 }
 
+// ── 예약 보고 (getScheduledReports / createScheduledReport / updateScheduledReport ...) ──
+
+/** 예약 작업 종류 — 자료조사({@code RESEARCH}) · 방 정리({@code ROOM_DIGEST}). 만든 뒤 못 바꾼다. */
+export type ScheduledTaskKind = 'RESEARCH' | 'ROOM_DIGEST';
+
+/** 방 정리 기간 — 예정 시각에서 거슬러 올라가는 길이. */
+export type ScheduledReportPeriod = 'LAST_24_HOURS' | 'LAST_7_DAYS';
+
+/** 자료조사 작업 칸 — 지시문으로 웹 조사를 맡기고, PM 이 결과를 전용 방에 보고한다. */
+export interface ResearchReportSpec {
+    kind: 'RESEARCH';
+    /** 지시문 (1~2,000자). */
+    instruction: string;
+}
+
+/** 방 정리 작업 칸 — 원천 방의 지난 기간 대화를 정리해 전용 방에 올린다. */
+export interface RoomDigestReportSpec {
+    kind: 'ROOM_DIGEST';
+    /** 원천 방 — {@link ChatClient.getScheduledReportSourceRooms} 에서 고른다. 만든 뒤 못 바꾼다. */
+    sourceRoomId: string;
+    period: ScheduledReportPeriod;
+    format: SummarizeFormatValue;
+    /** 특히 볼 내용 (0~500자, 선택). */
+    focus?: string;
+}
+
+/** 작업 칸 — {@code kind} 로 가른다. 요청과 응답이 같은 모양이다. */
+export type ScheduledReportSpec = ResearchReportSpec | RoomDigestReportSpec;
+
+/** 요일 — 대문자 영어 이름 그대로. */
+export type ScheduledReportDay = 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY';
+
+/** 매일({@code DAILY}) · 평일({@code WEEKDAYS}, 월~금 · 공휴일을 빼지 않는다) — 요일을 받지 않는다. */
+export interface ScheduledReportDailyCadence {
+    type: 'DAILY' | 'WEEKDAYS';
+    /** 보내지 않아도 된다. 요일을 넣으면 400 {@code SCHEDULED_REPORT_CADENCE_INVALID}. */
+    days?: [];
+    /** 시각 {@code HH:mm} — {@code zoneId} 기준. */
+    time: string;
+    /** IANA 시간대({@code Asia/Seoul}). 비우면 만들기는 내 프로필 시간대, 고치기는 지금 시간대. */
+    zoneId?: string;
+}
+
+/** 고른 요일마다({@code WEEKLY}). */
+export interface ScheduledReportWeeklyCadence {
+    type: 'WEEKLY';
+    /** 요일 1~7개, 중복 불가. */
+    days: ScheduledReportDay[];
+    /** 시각 {@code HH:mm} — {@code zoneId} 기준. */
+    time: string;
+    /** IANA 시간대({@code Asia/Seoul}). 비우면 만들기는 내 프로필 시간대, 고치기는 지금 시간대. */
+    zoneId?: string;
+}
+
+/** 요청의 주기 — {@code type} 으로 가른다. */
+export type ScheduledReportCadence = ScheduledReportDailyCadence | ScheduledReportWeeklyCadence;
+
+/** 응답의 주기 — 요일은 늘 배열이고(매일·평일은 빈 배열, 주간은 월요일부터) 시간대는 늘 있다. 그대로 다시 보낼 수 있다. */
+export type ScheduledReportCadenceResponse =
+    | (ScheduledReportDailyCadence & { days: []; zoneId: string })
+    | (ScheduledReportWeeklyCadence & { zoneId: string });
+
+/** 예약 상태 — {@code PAUSED} 면 회차를 만들지 않는다. */
+export type ScheduledReportStatus = 'ACTIVE' | 'PAUSED';
+
+/** 예약이 멈춘 사유 — 만든 사람이 멈췄거나({@code USER}), 회차가 더 돌릴 수 없다고 봤다. */
+export type ScheduledReportPauseReason =
+    | 'USER'
+    | 'OWNER_INACTIVE'
+    | 'OWNER_NOT_IN_ROOM'
+    | 'ROOM_UNAVAILABLE'
+    | 'PM_UNAVAILABLE'
+    | 'SOURCE_UNAVAILABLE'
+    | 'INVALID';
+
+/** 예약 한 건 — 시각은 UTC ISO-8601 문자열({@code 2026-10-30T00:30:00Z})이다. */
+export interface ScheduledReport {
+    id: string;
+    title: string;
+    spec: ScheduledReportSpec;
+    cadence: ScheduledReportCadenceResponse;
+    deliveryRoomIds: string[];
+    /** 결과가 올라가는 전용 방 — 방 목록·초대는 이 id 로 기존 방 API 를 쓴다. */
+    homeRoomId: string;
+    status: ScheduledReportStatus;
+    /** 멈췄을 때만 있다. */
+    pauseReason?: ScheduledReportPauseReason;
+    /** 다음 예정 시각. */
+    nextRunAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/** 회차 상태 — {@code PENDING}·{@code CLAIMED}·{@code STARTED}·{@code DELIVERING} 은 진행 중, 나머지는 끝난 상태다. */
+export type ScheduledReportRunState =
+    | 'PENDING'
+    | 'CLAIMED'
+    | 'STARTED'
+    | 'DELIVERING'
+    | 'DONE'
+    | 'SKIPPED'
+    | 'MISSED'
+    | 'EXPIRED'
+    | 'FAILED';
+
+/** 회차가 {@code SKIPPED}·{@code FAILED} 로 끝난 사유. */
+export type ScheduledReportRunEndReason =
+    | 'REPORT_DELETED'
+    | 'REPORT_PAUSED'
+    | 'OWNER_INACTIVE'
+    | 'OWNER_NOT_IN_ROOM'
+    | 'ROOM_UNAVAILABLE'
+    | 'PM_UNAVAILABLE'
+    | 'SOURCE_UNAVAILABLE'
+    | 'NOT_SUBSCRIBED'
+    | 'NO_CREDIT'
+    | 'SOURCE_CHANGED'
+    | 'PUBLISH_EXPIRED'
+    | 'TASK_FAILED'
+    | 'TASK_TIMEOUT'
+    | 'START_FAILED';
+
+/** 방 정리의 결과 종류 — 보고 · 새 대화 없음 · 실패 안내. */
+export type ScheduledReportResultKind = 'REPORT' | 'NO_DATA' | 'FAILURE';
+
+/** 보낼 방 복사 상태. */
+export type ScheduledReportDeliveryState = 'PENDING' | 'DELIVERED' | 'SKIPPED' | 'EXPIRED';
+
+/** 보낼 방 하나를 건너뛴 사유. */
+export type ScheduledReportDeliverySkipReason = 'ROOM_NOT_ELIGIBLE' | 'SOURCE_CHANGED' | 'REMOVED_FROM_REPORT' | 'REPORT_DELETED';
+
+/** 보낼 방 복사 하나. */
+export interface ScheduledReportRunDelivery {
+    roomId: string;
+    state: ScheduledReportDeliveryState;
+    /** 복사한 글 — 끝났을 때만 있다. */
+    messageId?: string;
+    /** 건너뛰었을 때만 있다. */
+    skipReason?: ScheduledReportDeliverySkipReason;
+}
+
+/** 회차 하나 — 언제 돌았고 어떻게 끝났나. */
+export interface ScheduledReportRun {
+    id: string;
+    /** 예정 시각 (UTC ISO-8601). */
+    scheduledAt: string;
+    state: ScheduledReportRunState;
+    /** {@code SKIPPED}·{@code FAILED} 일 때만 있다. */
+    endReason?: ScheduledReportRunEndReason;
+    /** 방 정리의 확정 결과 — 자료조사이거나 확정 전이면 없다. */
+    resultKind?: ScheduledReportResultKind;
+    /** 결과 글 — 없으면 아직 안 올렸다. */
+    resultMessageId?: string;
+    deliveries: ScheduledReportRunDelivery[];
+}
+
+/** {@link ChatClient.getScheduledReport} 응답 — 예약과 최근 회차(예정 늦은 순, 최대 10개). */
+export interface ScheduledReportDetail {
+    report: ScheduledReport;
+    recentRuns: ScheduledReportRun[];
+}
+
+/** 예약 화면의 방 고르기 목록의 방 하나. */
+export interface ScheduledReportRoomOption {
+    roomId: string;
+    /** 화면 이름 — 1:1 은 상대 이름이고, 상대를 못 찾으면 없다. */
+    name?: string;
+    roomType?: ChatRoomTypeValue;
+}
+
+/**
+ * {@link ChatClient.getScheduledReportDeliveryRooms} 파라미터 — 고치기 화면은 {@code reportId}, 만들기 화면은 {@code kind}.
+ * 방 정리는 원천 방으로만 보내므로 {@code sourceRoomId} 가 필요하다.
+ */
+export type ScheduledReportDeliveryRoomParams =
+    | { reportId: string }
+    | { kind: 'RESEARCH' }
+    | { kind: 'ROOM_DIGEST'; sourceRoomId: string };
+
+/** {@link ChatClient.createScheduledReport} 폼. */
+export interface CreateScheduledReportData {
+    /** 제목 (앞뒤 공백을 뺀 1~50자). 전용 방 이름으로도 쓴다. */
+    title: string;
+    spec: ScheduledReportSpec;
+    cadence: ScheduledReportCadence;
+    /** 결과를 복사할 방 (0~3개) — {@link ChatClient.getScheduledReportDeliveryRooms} 에서 고른다. 비우면 보내지 않는다. */
+    deliveryRoomIds?: string[];
+}
+
+/** {@link ChatClient.createScheduledReport} 옵션. */
+export interface CreateScheduledReportOptions {
+    /**
+     * 🔴 <b>필수.</b> SDK 가 대신 만들지 않는다 — 만들면 그 값이 호출자에게 남지 않아 응답만 유실된
+     * 타임아웃에서 같은 키로 다시 보낼 수 없다(새 키는 예약과 방을 하나 더 만든다).
+     *
+     * <p>폼마다 한 번 만들어 보관하고, 재시도에는 <b>같은 값</b>을 넘긴다. 공백 없는 인쇄 가능 ASCII 1~200자.</p>
+     */
+    idempotencyKey: string;
+}
+
+/**
+ * {@link ChatClient.updateScheduledReport} 칸 — 고칠 칸만 보낸다. {@code spec} 은 보내면 칸 전체이고 작업 종류·원천 방은
+ * 지금 값과 같아야 한다. {@code cadence} 는 보내면 주기 전체다. {@code deliveryRoomIds} 는 보내면 목록 전체다(빈 배열 = 보내지 않음).
+ */
+export interface UpdateScheduledReportData {
+    title?: string;
+    spec?: ScheduledReportSpec;
+    cadence?: ScheduledReportCadence;
+    deliveryRoomIds?: string[];
+    /** {@code PAUSED} = 멈추기 · {@code ACTIVE} = 다시 켜기. */
+    status?: ScheduledReportStatus;
+}
+
 // ============================================================================
 // Event payloads
 // ============================================================================
@@ -1820,8 +2044,8 @@ export interface TalkFlowClientOptions {
     maxSyncPages?: number;
     /** 갭 복구 페이지 크기. 기본 100. */
     syncPageSize?: number;
-    /** WebRTC ICE 서버. */
-    iceServers?: RTCIceServer[];
+    /** 받는 쪽 울림을 스스로 끄는 시각(ms). 기본 65000 — 서버 «응답함»·«취소» 가 먼저 오면 그때 끈다. */
+    callRingTimeoutMs?: number;
     /** connect() 시 채팅방 리스트 자동 구독. 기본 true. */
     autoSubscribeRoomList?: boolean;
     /** 로그 레벨. 기본 WARN. */
@@ -2149,7 +2373,7 @@ export interface RetentionCleanupPayload {
  * <p><b>Connection 관련</b>: stateChange, connected, disconnected, reconnecting, reconnected, resumed, subscriptionRequired, connectionError, tokenSet, loggedOut</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, aiUnavailable, 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>
+ * <p><b>화상통화 관련(WebRTCClient 이벤트를 같은 이름으로 re-emit)</b>: incomingCall, ringStopped, callStateChanged, callEnded, callRejected, participantJoined, participantLeft, trackSubscribed, trackUnsubscribed, localTrackPublished, localTrackUnpublished, participantMediaChanged, callRecoveryFailed, callError</p>
  */
 export interface TalkFlowClientEvents {
     // Connection
@@ -2275,34 +2499,22 @@ export interface TalkFlowClientEvents {
     /** Gmail 묶음 푸시(4통 이상) — 포그라운드. */
     newMailSummary: NewMailSummaryEvent;
 
-    // WebRTC (re-emit from WebRTCClient)
-    localStreamStarted: unknown;
-    localStreamStopped: unknown;
-    remoteTrack: unknown;
-    screenShareStarted: unknown;
-    screenShareEnded: unknown;
-    deviceChange: unknown;
-    mediaStateChanged: unknown;
-    callStarted: unknown;
-    callEnded: unknown;
-    /** 그룹 통화 재참가가 불가능해 로컬 통화를 종료한 경우. */
-    callRecoveryFailed: { roomId: string; error: unknown };
-    callRequested: unknown;
-    callAccepted: unknown;
-    callRejected: unknown;
-    callCancelled: unknown;
-    callInvitation: unknown;
-    callBusy: unknown;
-    incomingCall: unknown;
-    incomingCallWhileBusy: unknown;
-    userJoined: unknown;
-    userLeft: unknown;
-    participantLeft: unknown;
-    participantMediaState: unknown;
-    peerConnected: unknown;
-    peerDisconnected: unknown;
-    peerClosed: unknown;
-    webrtcError: unknown;
+    // 화상통화 (re-emit from WebRTCClient)
+    incomingCall: IncomingCallEvent;
+    ringStopped: RingStoppedEvent;
+    callStateChanged: CallStateChangedEvent;
+    callEnded: CallEndedEvent;
+    callRejected: CallRejectedEvent;
+    participantJoined: CallParticipantEvent;
+    participantLeft: CallParticipantEvent;
+    trackSubscribed: CallTrackEvent;
+    trackUnsubscribed: CallTrackEvent;
+    localTrackPublished: CallLocalTrackEvent;
+    localTrackUnpublished: CallLocalTrackEvent;
+    participantMediaChanged: CallParticipantMediaChangedEvent;
+    /** LiveKit 재접속 실패 — 통화는 이 기기에서 끝난다(나가기는 보내지 않았다, 끊김 유예 안에 joinCall 로 돌아올 수 있다). */
+    callRecoveryFailed: CallRecoveryFailedEvent;
+    callError: CallErrorEvent;
 }
 
 /**
@@ -2368,36 +2580,24 @@ export interface ChatClientEvents {
 }
 
 /**
- * WebRTCClient 가 직접 emit 하는 이벤트 맵.
+ * WebRTCClient 가 직접 emit 하는 이벤트 맵(v9.0.0, LiveKit SFU).
  */
 export interface WebRTCClientEvents {
-    localStreamStarted: unknown;
-    localStreamStopped: unknown;
-    screenShareStarted: unknown;
-    screenShareEnded: unknown;
-    remoteTrack: unknown;
-    peerConnected: unknown;
-    peerDisconnected: unknown;
-    peerClosed: unknown;
-    error: unknown;
-    callStarted: unknown;
-    callEnded: unknown;
-    /** 그룹 통화 재참가가 불가능해 로컬 통화를 종료한 경우. */
-    callRecoveryFailed: { roomId: string; error: unknown };
-    callRequested: unknown;
-    callAccepted: unknown;
-    callRejected: unknown;
-    callCancelled: unknown;
-    callInvitation: unknown;
-    callBusy: unknown;
-    incomingCall: unknown;
-    incomingCallWhileBusy: unknown;
-    userJoined: unknown;
-    userLeft: unknown;
-    participantLeft: unknown;
-    participantMediaState: unknown;
-    mediaStateChanged: unknown;
-    deviceChange: unknown;
+    incomingCall: IncomingCallEvent;
+    ringStopped: RingStoppedEvent;
+    callStateChanged: CallStateChangedEvent;
+    callEnded: CallEndedEvent;
+    callRejected: CallRejectedEvent;
+    participantJoined: CallParticipantEvent;
+    participantLeft: CallParticipantEvent;
+    trackSubscribed: CallTrackEvent;
+    trackUnsubscribed: CallTrackEvent;
+    localTrackPublished: CallLocalTrackEvent;
+    localTrackUnpublished: CallLocalTrackEvent;
+    participantMediaChanged: CallParticipantMediaChangedEvent;
+    /** LiveKit 재접속 실패 — 통화는 이 기기에서 끝난다(나가기는 보내지 않았다, 끊김 유예 안에 joinCall 로 돌아올 수 있다). */
+    callRecoveryFailed: CallRecoveryFailedEvent;
+    callError: CallErrorEvent;
 }
 
 // ============================================================================
@@ -2526,6 +2726,31 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
 
     /** PM 보고서 상세 — 목록 한 줄 + 본문({@code content}). 없거나 볼 수 없으면 404. 반환은 envelope 째. */
     getPmReport(reportId: string): Promise<ApiEnvelope<PmReportDetail>>;
+
+    /** 내가 만든 예약 목록(만든 순). */
+    getScheduledReports(): Promise<ScheduledReport[]>;
+
+    /** 예약 하나와 최근 회차(예정 늦은 순, 최대 10개). 없거나 남의 예약이면 404. */
+    getScheduledReport(reportId: string): Promise<ScheduledReportDetail>;
+
+    /** 지금 새로 만들 수 있는 작업 종류. 키에 PM 권한이 없거나 일시정지 중인 종류는 빠진다 — 빈 배열이면 만들기를 막는다. */
+    getScheduledReportKinds(): Promise<ScheduledTaskKind[]>;
+
+    /** 방 정리의 원천 방 고르기 — 내가 지금 참여 중이고 메시지 보관 기간이 없는 방. */
+    getScheduledReportSourceRooms(): Promise<ScheduledReportRoomOption[]>;
+
+    /** 보낼 방 고르기 — 만들기·고치기와 같은 판정으로 거른 방. */
+    getScheduledReportDeliveryRooms(params: ScheduledReportDeliveryRoomParams): Promise<ScheduledReportRoomOption[]>;
+
+    /** 예약 만들기 — 전용 방을 만들고 예약을 저장한다. {@code idempotencyKey} 필수 — 재시도에 같은 값을 넘겨야 예약과 방이 두 개 안 생긴다. */
+    createScheduledReport(report: CreateScheduledReportData, options: CreateScheduledReportOptions): Promise<ScheduledReport>;
+
+    /** 예약 고치기·멈추기·다시 켜기 — 고칠 칸만 보낸다. 바꾼 예약을 돌려준다. */
+    updateScheduledReport(reportId: string, changes: UpdateScheduledReportData): Promise<ScheduledReport>;
+
+    /** 예약 지우기 — 예약만 지우고 전용 방은 남긴다. */
+    deleteScheduledReport(reportId: string): Promise<void>;
+
     fetchLinkPreview(url: string): Promise<FetchLinkPreviewResponse | null>;
     sendMessage(roomId: string, data: SendMessageData): Promise<SendMessageResult>;
     /** Optimistic UI 버전 — 응답 전 base/예측 messageIds 동기 반환. */
@@ -2610,13 +2835,190 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
     resumeAssistantStreams(reason?: string): Promise<void>;
 }
 
-/** POST /api/v1/webrtc/rooms 요청. 생략한 값은 서버 기본값을 사용합니다. */
-export interface CreateCallRoomRequest {
-    invitedUsers?: string[];
+/** 미디어 선택 — 생략하면 카메라·마이크 둘 다 켠다. */
+export interface CallMediaOptions {
+    video?: boolean;
+    audio?: boolean;
+}
+
+/** 그룹 통화 열기. 생략한 값은 서버 기본값을 쓴다. */
+export interface CreateGroupCallOptions extends CallMediaOptions {
+    invitedUsers: string[];
     title?: string;
     maxParticipants?: number;
 }
 
+/**
+ * 통화가 끝난 사유 — 서버 사유(ended_by_host·cancelled·declined·busy·no_answer·participant_left·connection_lost·media_room_closed·
+ * empty·expired), 이 기기의 사유(left 나감·replaced 같은 사용자가 다른 기기로 들어옴·removed·room_deleted·room_closed·failed),
+ * 또는 받지 않고 끝난 울림의 사유({@link RingStopReason} 중 accepted 를 뺀 것).
+ */
+export type CallEndReason =
+    | 'ended_by_host' | 'cancelled' | 'declined' | 'busy' | 'no_answer' | 'participant_left' | 'connection_lost'
+    | 'media_room_closed' | 'empty' | 'expired'
+    | 'left' | 'replaced' | 'removed' | 'room_deleted' | 'room_closed' | 'failed'
+    | 'rejected' | 'answered_elsewhere' | 'timeout' | 'stale' | 'ended'
+    | (string & {});
+
+/**
+ * 울림이 멈춘 사유 — accepted(이 기기에서 받음)·rejected(이 기기에서 거절)·answered_elsewhere(같은 사용자의 다른 기기가 받았거나
+ * 그룹 통화를 거절함)·timeout(울림 상한)·stale(다시 물으니 더는 울리지 않음)·ended(통화가 없어졌거나 이 기기의 로그인 신원이 끝남)
+ * 또는 서버 사유(취소·종료).
+ * accepted 가 아니면 같은 사유로 callStateChanged(ended)·callEnded 도 온다.
+ */
+export type RingStopReason =
+    | 'accepted' | 'rejected' | 'answered_elsewhere' | 'timeout' | 'stale' | 'ended'
+    | 'cancelled' | 'no_answer' | 'declined' | 'busy' | 'ended_by_host' | 'empty' | 'expired' | 'media_room_closed'
+    | (string & {});
+
+/** 트랙 출처. */
+export type CallTrackSource = 'camera' | 'microphone' | 'screen' | 'screen_audio' | 'unknown';
+
+/** 울림 시작. 이 리스너 안에서 바로 거절·받으면 그 통화의 `callStateChanged`(ringing) 은 오지 않는다. */
+export interface IncomingCallEvent {
+    callRoomId: string;
+    kind: CallKindValue | null;
+    callerId: string | null;
+    callerName: string | null;
+    callerProfileUrl: string | null;
+    title: string | null;
+}
+
+export interface RingStoppedEvent {
+    callRoomId: string;
+    reason: RingStopReason;
+}
+
+export interface CallStateChangedEvent {
+    callRoomId: string;
+    state: CallStateValue;
+    /** ended 이면 끝난 사유, reconnecting 이면 removed(서버가 연결을 뺐다)일 수 있다. */
+    reason?: CallEndReason;
+}
+
+export interface CallEndedEvent {
+    callRoomId: string;
+    reason: CallEndReason;
+}
+
+/** 방장에게 — 초대 대상의 거절(declined·busy)·무응답(no_answer). 1:1 이면 통화도 끝난다(callEnded). */
+export interface CallRejectedEvent {
+    callRoomId: string;
+    userId: string | null;
+    reason: string | null;
+}
+
+export interface CallParticipantEvent {
+    callRoomId: string;
+    userId: string;
+}
+
+/**
+ * 화면에 붙이는 미디어 트랙 — livekit-client 의 Track 가운데 SDK 가 약속하는 부분이다(실제 값은 RemoteTrack·LocalTrack). livekit-client
+ * 타입을 그대로 내보내지 않는다 — 그 판에 묶이지 않게.
+ */
+export interface CallMediaTrack {
+    /** 'audio' · 'video' */
+    readonly kind: string;
+    readonly mediaStreamTrack: MediaStreamTrack;
+    /** 새 &lt;video&gt;/&lt;audio&gt; 요소를 만들어 붙이고 돌려준다. */
+    attach(): HTMLMediaElement;
+    /** 주어진 요소에 붙인다. */
+    attach(element: HTMLMediaElement): HTMLMediaElement;
+    /** 붙인 요소 전부에서 떼고 그 요소들을 돌려준다. */
+    detach(): HTMLMediaElement[];
+    /** 주어진 요소에서 뗀다. */
+    detach(element: HTMLMediaElement): HTMLMediaElement;
+}
+
+export interface CallTrackEvent {
+    callRoomId: string;
+    userId: string;
+    source: CallTrackSource;
+    /** 상대의 트랙 — {@code track.attach()} 로 화면에 붙인다. */
+    track: CallMediaTrack;
+}
+
+/**
+ * 내 트랙 게시·내림 — 카메라·마이크의 게시는 그 장치의 지금 트랙만 온다(재접속 중 다시 켜 새 트랙이 생기면 늦게 다시 게시되는 옛
+ * 트랙은 오지 않는다). 게시가 온 트랙은 내려질 때(그 사이 새 트랙으로 바뀌었어도) 짝으로 내림이 온다.
+ */
+export interface CallLocalTrackEvent {
+    callRoomId: string;
+    source: CallTrackSource;
+    /** 내 트랙 — 미리보기용. */
+    track: CallMediaTrack;
+}
+
+/** 참가자 미디어 상태 — 내 것이면 userId 는 null. */
+export interface CallParticipantMedia {
+    userId: string | null;
+    camera: boolean;
+    microphone: boolean;
+    screen: boolean;
+}
+
+export interface CallParticipantMediaChangedEvent extends CallParticipantMedia {
+    callRoomId: string;
+}
+
+export interface CallRecoveryFailedEvent {
+    callRoomId: string;
+    reason: string;
+}
+
+export interface CallErrorEvent {
+    callRoomId: string;
+    code: ErrorTypeValue | string;
+    message: string;
+    error?: unknown;
+}
+
+export interface CurrentCall {
+    /** 방을 만드는 중(callUser·createGroupCall 이 서버 응답을 기다리는 동안)이면 null. */
+    callRoomId: string | null;
+    kind: CallKindValue | null;
+    state: CallStateValue | null;
+    participants: CallParticipantMedia[];
+    localMedia: { camera: boolean; microphone: boolean; screen: boolean };
+}
+
+export interface RingingCall {
+    callRoomId: string;
+    kind: CallKindValue | null;
+    callerId: string | null;
+    title: string | null;
+}
+
+/** GET /api/v1/webrtc/rooms/{id}/participation */
+export interface CallParticipation {
+    callRoomId: string;
+    participating: boolean;
+    /** 초대 대상의 울림 상태. 방장·초대 밖이면 null. */
+    ring: 'RINGING' | 'ANSWERED' | 'DECLINED' | 'BUSY' | 'NO_ANSWER' | (string & {}) | null;
+}
+
+/** GET /api/v1/webrtc/rooms/{id} */
+export interface CallRoomInfo {
+    callRoomId: string;
+    kind: CallKindValue;
+    status: 'CREATED' | 'ACTIVE' | 'ENDED' | 'EXPIRED' | (string & {});
+    version: number;
+    hostUserId: string;
+    invitedUsers: string[];
+    title: string | null;
+    /** ISO-8601 */
+    createdAt: string;
+    /** ISO-8601 */
+    expiresAt: string;
+    maxParticipants: number | null;
+    projectId: string;
+}
+
+/**
+ * 화상통화 클라이언트(v9.0.0) — 통화 제어는 서버 REST, 미디어는 LiveKit(SFU), 서버 알림은 STOMP. 클라이언트는 통화 신호를 보내지
+ * 않는다. 한 번에 한 통화만 미디어에 붙는다.
+ */
 export class WebRTCClient implements SdkEventEmitter<WebRTCClientEvents> {
     on<K extends keyof WebRTCClientEvents>(event: K, listener: (payload: WebRTCClientEvents[K]) => void): () => void;
     once<K extends keyof WebRTCClientEvents>(event: K, listener: (payload: WebRTCClientEvents[K]) => void): () => void;
@@ -2625,44 +3027,102 @@ export class WebRTCClient implements SdkEventEmitter<WebRTCClientEvents> {
     removeAllListeners(event?: keyof WebRTCClientEvents): void;
     listenerCount(event: keyof WebRTCClientEvents): number;
 
-    initializeIceServers(): Promise<RTCIceServer[]>;
-    getTurnCredentials(): Promise<{ iceServers: RTCIceServer[] }>;
-
-    createCallRoom(data: CreateCallRoomRequest): Promise<unknown>;
-    getCallRoom(roomId: string): Promise<unknown>;
-    joinCallRoomApi(roomId: string): Promise<unknown>;
-    leaveCallRoomApi(roomId: string): Promise<unknown>;
-
-    /** 수신 call 구독 활성화 — 내부 WebSocket subscribe 가 async. */
+    /** 통화 알림 수신(개인 큐 구독) — connect() 가 부른다. */
     enableIncomingCalls(): Promise<void>;
     disableIncomingCalls(): void;
     isIncomingCallsEnabled(): boolean;
 
-    startCall(options: { targetUserId?: string; roomId?: string; mediaConstraints?: MediaStreamConstraints }): Promise<void>;
-    callUser(targetUserId: string, mediaConstraints?: MediaStreamConstraints): Promise<void>;
-    acceptCall(callerId: string, mediaConstraints?: MediaStreamConstraints): Promise<void>;
-    rejectCall(callerId: string): void;
-    cancelCall(): void;
-    endCall(): void;
-
-    toggleVideo(): boolean;
-    toggleAudio(): boolean;
-    setVideoEnabled(enabled: boolean): void;
-    setAudioEnabled(enabled: boolean): void;
-    startScreenShare(): Promise<MediaStream>;
-    stopScreenShare(): void;
-    getLocalStream(): MediaStream | null;
-
-    getDevices(): Promise<{ videoInputs: MediaDeviceInfo[]; audioInputs: MediaDeviceInfo[]; audioOutputs: MediaDeviceInfo[] }>;
-    switchDevice(deviceId: string, kind: 'video' | 'audio' | 'audiooutput'): Promise<void>;
-    startDeviceChangeDetection(): void;
-    stopDeviceChangeDetection(): void;
-    applyVideoConstraints(constraints: MediaTrackConstraints): Promise<void>;
-    getVideoSettings(): MediaTrackSettings | null;
-    getAudioSettings(): MediaTrackSettings | null;
-
+    /**
+     * 1:1 통화를 건다 — 방 만들기 → 입장 → 미디어 접속. 반환: callRoomId. 방을 만드는 중에 이 기기의 로그인 신원이 끝나거나(로그아웃·
+     * 전환) destroy 되면 `NO_ACTIVE_CALL` 로 끝난다. destroy 뒤에는 `INVALID_STATE`.
+     */
+    callUser(targetUserId: string, media?: CallMediaOptions): Promise<string>;
+    /** 그룹 통화를 연다. 반환: callRoomId. 끝나는 경우는 callUser 와 같다. */
+    createGroupCall(options: CreateGroupCallOptions): Promise<string>;
+    /**
+     * 울리는 통화를 받는다 — 이 기기 울림을 끄고 입장한다. 입장 중에 통화가 끝나면(상대 취소 등) 던지지 않고 callEnded 로 알린다.
+     */
+    acceptCall(callRoomId: string, media?: CallMediaOptions): Promise<string>;
+    /** 그룹 통화에 들어가거나 다시 들어간다 — 나간 뒤·재접속 실패 뒤에도 통화가 이어지면 다시 들어갈 수 있다. */
+    joinCall(callRoomId: string, media?: CallMediaOptions): Promise<string>;
+    /** 울리는 통화를 거절한다. 기본 DECLINED. callRoomId 가 없으면 요청 없이 던진다. */
+    rejectCall(callRoomId: string, options?: { reason?: 'DECLINED' | 'BUSY' }): Promise<void>;
+    /** 건 통화를 취소한다(방장, 상대 입장 전). 생략하면 지금 통화. 방을 만드는 중이면 만든 뒤 취소한다. */
+    cancelCall(callRoomId?: string): Promise<void>;
+    /**
+     * 지금 통화에서 나간다 — 이 기기의 미디어 끊기를 시작하고 같은 틱에 서버에 나가기를 보낸다(끊기를 기다리지 않는다 — 누른 순간의
+     * 신원으로 나간다). 서버 요청이 실패하면 던지지만 통화는 이미 끝났다(callEnded left). 방을 만드는 중이면 만든 뒤 끝내고 취소를
+     * 보낸다 — 나가기·취소·모두 끝내기 중 처음 누른 것이 정한다. 울리던 초대를 받고 입장 전에 나가면 서버 초대를 거절(DECLINED)로
+     * 정리한다. 로그인 신원이 바뀌어 재시도를 멈추면 `INVALID_STATE`.
+     */
+    leaveCall(): Promise<void>;
+    /** 모두의 통화를 끝낸다(방장). */
+    endCallForAll(): Promise<void>;
+
+    /**
+     * 카메라를 켜고 끈다 — 통화가 있으면 언제든. 미디어가 붙기 전(방을 만드는 중·입장 중·미디어 서버 접속 중)에 부르면 의도만
+     * 기록하고 바로 끝나며, 붙으면 그 의도로 켜고 끈다. 붙은 뒤에는 장치가 그 상태가 되면 끝난다(켜기는 권한 응답 뒤) — 그 사이 다시
+     * 부르면 마지막 의도로 맞추고 앞선 호출은 그대로 끝난다. 끄기·한 번 켠 장치 다시 켜기(음소거 풀기)는 다른 장치의 권한 창을 기다리지
+     * 않는다(처음 켜기만 권한 창을 하나씩 띄우려 줄에 서고, 줄에서 기다리는 사이 끄면 바로 끝난다). 그 의도가 실패하면(권한
+     * 거부) `MEDIA_ACCESS_DENIED` — 통화가 기억하는 켜짐·꺼짐은 실제 상태로 돌아가고(앞선 누름도 실패했으면 그것이 아니라) 다시
+     * 부르면 다시 시도한다. 통화가 끝나면 기다리던 호출도 끝난다. 통화가 없으면 `NO_ACTIVE_CALL`. 켜 둔 장치가 빠져 LiveKit 이 다시
+     * 열지 못하면(스스로 음소거하거나 재접속 뒤 다시 올리지 못하면) 그 장치를 끈 것으로 보고 `callError`(`MEDIA_ACCESS_DENIED`)로 알린다
+     * — 통화도 꺼짐으로 기억해 다시 입장해도 저절로 켜지지 않는다. 꺼진 카메라는 장치를 쥐지 않고, 게시 없이 열린 채 남은 트랙(재접속
+     * 뒤 다시 열고 게시만 못 함)은 끄면(늦게 다시 열려도) 멈추고 다시 켜면 새 트랙으로 바뀐다. 재접속의 다시 게시가 옛 트랙을 다시 여는
+     * 사이 다시 켜 새 트랙이 생기면 옛 트랙은 늦게 열리거나 게시돼도 멈추고 내린다(장치마다 게시는 하나, 꺼짐이면 보내는 트랙 없음).
+     * 통화가 끝나면 그 연결이 연 카메라·마이크를 모두 그 자리에서 멈춘다(게시를 기다리는 중이어도, 권한 응답이 통화가 끝난 뒤에 와도).
+     */
+    setCameraEnabled(enabled: boolean): Promise<void>;
+    /** 마이크를 켜고 끈다 — `setCameraEnabled` 와 같은 규칙. 장치가 빠져 끝난 마이크는 켤 때 다시 연다(못 열면 그 켜기가 실패한다). */
+    setMicrophoneEnabled(enabled: boolean): Promise<void>;
+    /**
+     * 화면 공유 — 미디어 접속이 끝난 뒤에만(공유 창은 사용자 조작 안에서만 열려 미룰 수 없다). 그 전이면 `INVALID_STATE`, 거부는
+     * `SCREEN_SHARE_DENIED`. 마지막 누름대로 맞춘다 — 켜져 있으면 마지막에 고른 화면 하나만 게시된다. 공유 중이 아니면 공유 창을 바로
+     * 열고 고른 화면(함께 고른 소리까지)이 게시되면 끝나며, 공유 창이 떠 있는 동안 다시 부르면 그 창의 결과를 같이 기다린다(창은 하나, 공유 중이면 새 창을
+     * 열지 않는다). 공유 창을 취소하거나 게시가 실패하면 그 사이 대체된 누름은 그대로 끝나고 마지막 누름만 거부된다(게시를 시도한 쪽이
+     * 앞선 누름·재접속 뒤 정리여도 — 기다리는 누름이 없으면 `callError`, 이미 게시된 영상·소리도 내린다 — 끈 화면의 늦은 실패는 알리지 않는다). 재접속 중에는 SDK 가
+     * 게시하지 않는다 — 공유 중이던 화면이면 바로 끝나고, 새로 고른 화면은 다시 붙은 뒤(LiveKit 의 다시 게시가 끝난 뒤) 게시하고
+     * 끝난다(다른 트랙의 다시 게시 실패는 화면 공유를 끄지 않는다). 재접속 중에 다시
+     * 고르면 다시 게시된 옛 화면은 내린다. 통화가 끝나면 기다리지 않고 `INVALID_STATE` 로 끝난다(화면 공유는 다시 입장한 연결로 넘어가지
+     * 않는다).
+     */
+    startScreenShare(): Promise<void>;
+    /**
+     * 화면 공유를 멈춘다 — `startScreenShare` 와 같은 규칙. 고른 화면을 그 자리에서 멈추고(공유 표시가 바로 꺼진다) 게시를 내린 뒤
+     * 끝난다. 공유 창이 떠 있어도 바로 끝나고 그 뒤 고른 화면은 게시하지 않는다. 재접속 중에 멈춰도 다시 게시된 화면까지 내리고, LiveKit
+     * 이 다시 게시하는 중이어도, 게시가 아직 끝나지 않았어도(협상·재접속 대기) 기다리지 않는다 — 늦게 붙은 화면은 바로 내린다.
+     */
+    stopScreenShare(): Promise<void>;
+    /** 장치 목록 — 통화 전에도 부를 수 있다. */
+    getDevices(kind?: MediaDeviceKind): Promise<MediaDeviceInfo[]>;
+    /**
+     * 장치를 바꾼다 — 통화가 있으면 언제든. 미디어가 붙기 전이면 기억했다가 붙을 때 그 장치로, 다시 입장해도 그 장치로 붙는다. 카메라·
+     * 마이크는 그 장치의 켜고 끄기·앞선 바꾸기와 부른 순서대로 하나씩 옮긴다 — 켜는 중(권한 창·획득)이면 켜기가 끝난 뒤 옮기고 끝나며,
+     * 켜는 중에 끄고 고르면 끈 뒤 옮기며, 옮기는 중에 끈 카메라는 옮긴 뒤 꺼진다(마이크 음소거는 기다리지 않는다). 켜져 있는 장치를 못
+     * 바꾸면(같은 장치를 다시 골라도 다시 연다) `DEVICE_SWITCH_FAILED`(또는 false) — 쓰던 장치로 한 번 다시 열고 기억도 지금 쓰는 장치가
+     * 된다(앞선 선택도 실패했으면 그것이 아니라 — 쓰던 장치로도 못 돌아가거나 쓰던 장치를 모르면 그 장치를 끈 뒤 `callError` 로 알린다 — 바로 다시 켜면 다시 연다, 끄는 사이
+     * 다시 켜거나 끄면 그 누름이 이기고 알리지 않는다). 꺼진
+     * 카메라·음소거한 마이크는 바꿀 때 열지 않고 켤 때 연다 — 그때 못 열면 그 켜기가 `MEDIA_ACCESS_DENIED`(`cause` 에 원래 오류)로
+     * 실패한다. 스피커도 부른 순서대로 하나씩 바꾼다 — 상대 소리 요소마다 바꾸고 모두 끝난 뒤 판정해, 일부만 바뀌면 바뀐 요소를 쓰던
+     * 출력으로 되돌린 뒤 실패한다(되돌리지도 못하면 그 `DEVICE_SWITCH_FAILED` 에 `outputMismatch: true` — 일부 소리가 고른 출력에 남았고
+     * 기억은 쓰던 출력이다, 다시 고르면 모두 맞춘다). 전체 재접속 중(다시 붙었어도 LiveKit 이 다시 게시하는 중이면 그 끝까지)에 고른
+     * 카메라·마이크는 그 끝을 기다려 옮기고 그때 끝난다(그동안 옮기면 다시 게시가 옛 장치로 열려 기억과 실제가 어긋난다 — 기다리는 동안
+     * 그 장치의 켜고 끄기는 막지 않고, 기다리는 사이 다시 고르면 마지막에 고른 장치로만 옮기며, 스피커는 기다리지 않는다). 장치를 여는 중·다시 맞추기를 기다리는 중에 통화가 끝나면 기다리지 않고
+     * true 로 끝난다(고른 장치는 기억한다). LiveKit 이 스스로 장치를 옮기면(빠진 장치 대신 다른 장치로 다시 열기·기기 변화로 입력·출력
+     * 전환, 꺼진 카메라·음소거한 마이크에 적어 둔 다음 켜기 장치 — 꺼진 채 바꾼 장치는 재접속 뒤에도 그 장치) 고른 장치 기억도 따라간다 — 다시 입장해도 없는 장치로 붙지 않는다(바꾸는 중이면 그
+     * 바꾸기의 결과가 기억이다, 고른 장치가 없으면 기본 장치 그대로).
+     */
+    switchDevice(kind: MediaDeviceKind, deviceId: string): Promise<boolean>;
+
+    getCallRoom(callRoomId: string): Promise<CallRoomInfo>;
+    /** 내 참가 상태 — ring 이 RINGING 이면 아직 울리는 중. */
+    getParticipation(callRoomId: string): Promise<CallParticipation>;
     isInCall(): boolean;
-    getCurrentRoom(): string | null;
+    getCurrentCall(): CurrentCall | null;
+    getRingingCalls(): RingingCall[];
+
+    setLogLevel(level: LogLevelValue): void;
+    destroy(): void;
 }
 
 /** 푸시 디바이스 응답 (내 디바이스 목록). deviceToken 은 보안상 미포함. */
@@ -3030,6 +3490,31 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
 
     /** PM 보고서 상세 — 목록 한 줄 + 본문({@code content}). 없거나 볼 수 없으면 404. 반환은 envelope 째. */
     getPmReport(reportId: string): Promise<ApiEnvelope<PmReportDetail>>;
+
+    /** 내가 만든 예약 목록(만든 순). */
+    getScheduledReports(): Promise<ScheduledReport[]>;
+
+    /** 예약 하나와 최근 회차(예정 늦은 순, 최대 10개). 없거나 남의 예약이면 404. */
+    getScheduledReport(reportId: string): Promise<ScheduledReportDetail>;
+
+    /** 지금 새로 만들 수 있는 작업 종류. 키에 PM 권한이 없거나 일시정지 중인 종류는 빠진다 — 빈 배열이면 만들기를 막는다. */
+    getScheduledReportKinds(): Promise<ScheduledTaskKind[]>;
+
+    /** 방 정리의 원천 방 고르기 — 내가 지금 참여 중이고 메시지 보관 기간이 없는 방. */
+    getScheduledReportSourceRooms(): Promise<ScheduledReportRoomOption[]>;
+
+    /** 보낼 방 고르기 — 만들기·고치기와 같은 판정으로 거른 방. */
+    getScheduledReportDeliveryRooms(params: ScheduledReportDeliveryRoomParams): Promise<ScheduledReportRoomOption[]>;
+
+    /** 예약 만들기 — 전용 방을 만들고 예약을 저장한다. {@code idempotencyKey} 필수 — 재시도에 같은 값을 넘겨야 예약과 방이 두 개 안 생긴다. */
+    createScheduledReport(report: CreateScheduledReportData, options: CreateScheduledReportOptions): Promise<ScheduledReport>;
+
+    /** 예약 고치기·멈추기·다시 켜기 — 고칠 칸만 보낸다. 바꾼 예약을 돌려준다. */
+    updateScheduledReport(reportId: string, changes: UpdateScheduledReportData): Promise<ScheduledReport>;
+
+    /** 예약 지우기 — 예약만 지우고 전용 방은 남긴다. */
+    deleteScheduledReport(reportId: string): Promise<void>;
+
     fetchLinkPreview(url: string): Promise<FetchLinkPreviewResponse | null>;
     sendMessage(roomId: string, data: SendMessageData): Promise<SendMessageResult>;
     /** Optimistic UI 버전 — 응답 전 base/예측 messageIds 동기 반환. */
@@ -3109,45 +3594,100 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
      */
     resumeAssistantStreams(reason?: string): Promise<void>;
 
-    // WebRTC delegations
-    initializeIceServers(): Promise<RTCIceServer[]>;
-    getTurnCredentials(): Promise<{ iceServers: RTCIceServer[] }>;
-
-    createCallRoom(data: CreateCallRoomRequest): Promise<unknown>;
-    getCallRoom(roomId: string): Promise<unknown>;
-    joinCallRoomApi(roomId: string): Promise<unknown>;
-    leaveCallRoomApi(roomId: string): Promise<unknown>;
-
-    /** 수신 call 구독 활성화 — 내부 WebSocket subscribe 가 async. */
+    // 화상통화 delegations (→ client.webrtc)
+    /** 통화 알림 수신(개인 큐 구독) — connect() 가 부른다. */
     enableIncomingCalls(): Promise<void>;
     disableIncomingCalls(): void;
     isIncomingCallsEnabled(): boolean;
 
-    startCall(options: { targetUserId?: string; roomId?: string; mediaConstraints?: MediaStreamConstraints }): Promise<void>;
-    callUser(targetUserId: string, mediaConstraints?: MediaStreamConstraints): Promise<void>;
-    acceptCall(callerId: string, mediaConstraints?: MediaStreamConstraints): Promise<void>;
-    rejectCall(callerId: string): void;
-    cancelCall(): void;
-    endCall(): void;
-
-    toggleVideo(): boolean;
-    toggleAudio(): boolean;
-    setVideoEnabled(enabled: boolean): void;
-    setAudioEnabled(enabled: boolean): void;
-    startScreenShare(): Promise<MediaStream>;
-    stopScreenShare(): void;
-    getLocalStream(): MediaStream | null;
-
-    getDevices(): Promise<{ videoInputs: MediaDeviceInfo[]; audioInputs: MediaDeviceInfo[]; audioOutputs: MediaDeviceInfo[] }>;
-    switchDevice(deviceId: string, kind: 'video' | 'audio' | 'audiooutput'): Promise<void>;
-    startDeviceChangeDetection(): void;
-    stopDeviceChangeDetection(): void;
-    applyVideoConstraints(constraints: MediaTrackConstraints): Promise<void>;
-    getVideoSettings(): MediaTrackSettings | null;
-    getAudioSettings(): MediaTrackSettings | null;
-
+    /**
+     * 1:1 통화를 건다 — 방 만들기 → 입장 → 미디어 접속. 반환: callRoomId. 방을 만드는 중에 이 기기의 로그인 신원이 끝나거나(로그아웃·
+     * 전환) destroy 되면 `NO_ACTIVE_CALL` 로 끝난다. destroy 뒤에는 `INVALID_STATE`.
+     */
+    callUser(targetUserId: string, media?: CallMediaOptions): Promise<string>;
+    /** 그룹 통화를 연다. 반환: callRoomId. 끝나는 경우는 callUser 와 같다. */
+    createGroupCall(options: CreateGroupCallOptions): Promise<string>;
+    /**
+     * 울리는 통화를 받는다 — 이 기기 울림을 끄고 입장한다. 입장 중에 통화가 끝나면(상대 취소 등) 던지지 않고 callEnded 로 알린다.
+     */
+    acceptCall(callRoomId: string, media?: CallMediaOptions): Promise<string>;
+    /** 그룹 통화에 들어가거나 다시 들어간다 — 나간 뒤·재접속 실패 뒤에도 통화가 이어지면 다시 들어갈 수 있다. */
+    joinCall(callRoomId: string, media?: CallMediaOptions): Promise<string>;
+    /** 울리는 통화를 거절한다. 기본 DECLINED. callRoomId 가 없으면 요청 없이 던진다. */
+    rejectCall(callRoomId: string, options?: { reason?: 'DECLINED' | 'BUSY' }): Promise<void>;
+    /** 건 통화를 취소한다(방장, 상대 입장 전). 생략하면 지금 통화. 방을 만드는 중이면 만든 뒤 취소한다. */
+    cancelCall(callRoomId?: string): Promise<void>;
+    /**
+     * 지금 통화에서 나간다 — 이 기기의 미디어 끊기를 시작하고 같은 틱에 서버에 나가기를 보낸다(끊기를 기다리지 않는다 — 누른 순간의
+     * 신원으로 나간다). 서버 요청이 실패하면 던지지만 통화는 이미 끝났다(callEnded left). 방을 만드는 중이면 만든 뒤 끝내고 취소를
+     * 보낸다 — 나가기·취소·모두 끝내기 중 처음 누른 것이 정한다. 울리던 초대를 받고 입장 전에 나가면 서버 초대를 거절(DECLINED)로
+     * 정리한다. 로그인 신원이 바뀌어 재시도를 멈추면 `INVALID_STATE`.
+     */
+    leaveCall(): Promise<void>;
+    /** 모두의 통화를 끝낸다(방장). */
+    endCallForAll(): Promise<void>;
+
+    /**
+     * 카메라를 켜고 끈다 — 통화가 있으면 언제든. 미디어가 붙기 전(방을 만드는 중·입장 중·미디어 서버 접속 중)에 부르면 의도만
+     * 기록하고 바로 끝나며, 붙으면 그 의도로 켜고 끈다. 붙은 뒤에는 장치가 그 상태가 되면 끝난다(켜기는 권한 응답 뒤) — 그 사이 다시
+     * 부르면 마지막 의도로 맞추고 앞선 호출은 그대로 끝난다. 끄기·한 번 켠 장치 다시 켜기(음소거 풀기)는 다른 장치의 권한 창을 기다리지
+     * 않는다(처음 켜기만 권한 창을 하나씩 띄우려 줄에 서고, 줄에서 기다리는 사이 끄면 바로 끝난다). 그 의도가 실패하면(권한
+     * 거부) `MEDIA_ACCESS_DENIED` — 통화가 기억하는 켜짐·꺼짐은 실제 상태로 돌아가고(앞선 누름도 실패했으면 그것이 아니라) 다시
+     * 부르면 다시 시도한다. 통화가 끝나면 기다리던 호출도 끝난다. 통화가 없으면 `NO_ACTIVE_CALL`. 켜 둔 장치가 빠져 LiveKit 이 다시
+     * 열지 못하면(스스로 음소거하거나 재접속 뒤 다시 올리지 못하면) 그 장치를 끈 것으로 보고 `callError`(`MEDIA_ACCESS_DENIED`)로 알린다
+     * — 통화도 꺼짐으로 기억해 다시 입장해도 저절로 켜지지 않는다. 꺼진 카메라는 장치를 쥐지 않고, 게시 없이 열린 채 남은 트랙(재접속
+     * 뒤 다시 열고 게시만 못 함)은 끄면(늦게 다시 열려도) 멈추고 다시 켜면 새 트랙으로 바뀐다. 재접속의 다시 게시가 옛 트랙을 다시 여는
+     * 사이 다시 켜 새 트랙이 생기면 옛 트랙은 늦게 열리거나 게시돼도 멈추고 내린다(장치마다 게시는 하나, 꺼짐이면 보내는 트랙 없음).
+     * 통화가 끝나면 그 연결이 연 카메라·마이크를 모두 그 자리에서 멈춘다(게시를 기다리는 중이어도, 권한 응답이 통화가 끝난 뒤에 와도).
+     */
+    setCameraEnabled(enabled: boolean): Promise<void>;
+    /** 마이크를 켜고 끈다 — `setCameraEnabled` 와 같은 규칙. 장치가 빠져 끝난 마이크는 켤 때 다시 연다(못 열면 그 켜기가 실패한다). */
+    setMicrophoneEnabled(enabled: boolean): Promise<void>;
+    /**
+     * 화면 공유 — 미디어 접속이 끝난 뒤에만(공유 창은 사용자 조작 안에서만 열려 미룰 수 없다). 그 전이면 `INVALID_STATE`, 거부는
+     * `SCREEN_SHARE_DENIED`. 마지막 누름대로 맞춘다 — 켜져 있으면 마지막에 고른 화면 하나만 게시된다. 공유 중이 아니면 공유 창을 바로
+     * 열고 고른 화면(함께 고른 소리까지)이 게시되면 끝나며, 공유 창이 떠 있는 동안 다시 부르면 그 창의 결과를 같이 기다린다(창은 하나, 공유 중이면 새 창을
+     * 열지 않는다). 공유 창을 취소하거나 게시가 실패하면 그 사이 대체된 누름은 그대로 끝나고 마지막 누름만 거부된다(게시를 시도한 쪽이
+     * 앞선 누름·재접속 뒤 정리여도 — 기다리는 누름이 없으면 `callError`, 이미 게시된 영상·소리도 내린다 — 끈 화면의 늦은 실패는 알리지 않는다). 재접속 중에는 SDK 가
+     * 게시하지 않는다 — 공유 중이던 화면이면 바로 끝나고, 새로 고른 화면은 다시 붙은 뒤(LiveKit 의 다시 게시가 끝난 뒤) 게시하고
+     * 끝난다(다른 트랙의 다시 게시 실패는 화면 공유를 끄지 않는다). 재접속 중에 다시
+     * 고르면 다시 게시된 옛 화면은 내린다. 통화가 끝나면 기다리지 않고 `INVALID_STATE` 로 끝난다(화면 공유는 다시 입장한 연결로 넘어가지
+     * 않는다).
+     */
+    startScreenShare(): Promise<void>;
+    /**
+     * 화면 공유를 멈춘다 — `startScreenShare` 와 같은 규칙. 고른 화면을 그 자리에서 멈추고(공유 표시가 바로 꺼진다) 게시를 내린 뒤
+     * 끝난다. 공유 창이 떠 있어도 바로 끝나고 그 뒤 고른 화면은 게시하지 않는다. 재접속 중에 멈춰도 다시 게시된 화면까지 내리고, LiveKit
+     * 이 다시 게시하는 중이어도, 게시가 아직 끝나지 않았어도(협상·재접속 대기) 기다리지 않는다 — 늦게 붙은 화면은 바로 내린다.
+     */
+    stopScreenShare(): Promise<void>;
+    /** 장치 목록 — 통화 전에도 부를 수 있다. */
+    getDevices(kind?: MediaDeviceKind): Promise<MediaDeviceInfo[]>;
+    /**
+     * 장치를 바꾼다 — 통화가 있으면 언제든. 미디어가 붙기 전이면 기억했다가 붙을 때 그 장치로, 다시 입장해도 그 장치로 붙는다. 카메라·
+     * 마이크는 그 장치의 켜고 끄기·앞선 바꾸기와 부른 순서대로 하나씩 옮긴다 — 켜는 중(권한 창·획득)이면 켜기가 끝난 뒤 옮기고 끝나며,
+     * 켜는 중에 끄고 고르면 끈 뒤 옮기며, 옮기는 중에 끈 카메라는 옮긴 뒤 꺼진다(마이크 음소거는 기다리지 않는다). 켜져 있는 장치를 못
+     * 바꾸면(같은 장치를 다시 골라도 다시 연다) `DEVICE_SWITCH_FAILED`(또는 false) — 쓰던 장치로 한 번 다시 열고 기억도 지금 쓰는 장치가
+     * 된다(앞선 선택도 실패했으면 그것이 아니라 — 쓰던 장치로도 못 돌아가거나 쓰던 장치를 모르면 그 장치를 끈 뒤 `callError` 로 알린다 — 바로 다시 켜면 다시 연다, 끄는 사이
+     * 다시 켜거나 끄면 그 누름이 이기고 알리지 않는다). 꺼진
+     * 카메라·음소거한 마이크는 바꿀 때 열지 않고 켤 때 연다 — 그때 못 열면 그 켜기가 `MEDIA_ACCESS_DENIED`(`cause` 에 원래 오류)로
+     * 실패한다. 스피커도 부른 순서대로 하나씩 바꾼다 — 상대 소리 요소마다 바꾸고 모두 끝난 뒤 판정해, 일부만 바뀌면 바뀐 요소를 쓰던
+     * 출력으로 되돌린 뒤 실패한다(되돌리지도 못하면 그 `DEVICE_SWITCH_FAILED` 에 `outputMismatch: true` — 일부 소리가 고른 출력에 남았고
+     * 기억은 쓰던 출력이다, 다시 고르면 모두 맞춘다). 전체 재접속 중(다시 붙었어도 LiveKit 이 다시 게시하는 중이면 그 끝까지)에 고른
+     * 카메라·마이크는 그 끝을 기다려 옮기고 그때 끝난다(그동안 옮기면 다시 게시가 옛 장치로 열려 기억과 실제가 어긋난다 — 기다리는 동안
+     * 그 장치의 켜고 끄기는 막지 않고, 기다리는 사이 다시 고르면 마지막에 고른 장치로만 옮기며, 스피커는 기다리지 않는다). 장치를 여는 중·다시 맞추기를 기다리는 중에 통화가 끝나면 기다리지 않고
+     * true 로 끝난다(고른 장치는 기억한다). LiveKit 이 스스로 장치를 옮기면(빠진 장치 대신 다른 장치로 다시 열기·기기 변화로 입력·출력
+     * 전환, 꺼진 카메라·음소거한 마이크에 적어 둔 다음 켜기 장치 — 꺼진 채 바꾼 장치는 재접속 뒤에도 그 장치) 고른 장치 기억도 따라간다 — 다시 입장해도 없는 장치로 붙지 않는다(바꾸는 중이면 그
+     * 바꾸기의 결과가 기억이다, 고른 장치가 없으면 기본 장치 그대로).
+     */
+    switchDevice(kind: MediaDeviceKind, deviceId: string): Promise<boolean>;
+
+    getCallRoom(callRoomId: string): Promise<CallRoomInfo>;
+    /** 내 참가 상태 — ring 이 RINGING 이면 아직 울리는 중. */
+    getParticipation(callRoomId: string): Promise<CallParticipation>;
     isInCall(): boolean;
-    getCurrentRoom(): string | null;
+    getCurrentCall(): CurrentCall | null;
+    getRingingCalls(): RingingCall[];
 
     // Cleanup
     destroy(): Promise<void>;
@@ -3189,8 +3729,6 @@ export class Logger {
 }
 
 export class ConnectionManager {}
-export class MediaStreamManager {}
-export class PeerConnectionManager {}
 
 /**
  * 방 미독 카운트 계산기 (READ_SYNC_DESIGN §6).