@ai-matrx/meet 0.11.29 → 0.11.30

package/dist/core.d.cts

@@ -152,12 +152,55 @@ declare function displayNameFor(book: NameBook, identity: ParticipantIdentity |
  *    there is no second wording to keep in sync.
  */
 
+/**
+ * WHY a device is unusable, in the contract's words (CORE-DESIGN §3.2, the `mic` / `camera`
+ * region's `unavailable:<reason>`). The media supervisor (`media-supervisor.ts`) decides it from
+ * the browser's error AND the Permissions API, because the error alone cannot tell a person's
+ * Block from an operating-system refusal or a stale device id.
+ */
+type DeviceUnavailableReason = "denied" | "blocked_site" | "blocked_os" | "none" | "busy" | "failed" | "revoked";
 /** Why a local track is not publishing, in the browser's terms plus a remedy. */
 interface MediaUnavailable {
     readonly code: string;
     readonly message: string;
     readonly remedy: string;
+    /** The region reason (S6c). Absent on states recorded before the supervisor classified them. */
+    readonly reason?: DeviceUnavailableReason | undefined;
+}
+/** What the browser's permission store says for one device kind. `unknown` = no Permissions API. */
+type PermissionReading = "granted" | "denied" | "prompt" | "unknown";
+/** A device change the person is told about (S6c): unplugged → switched, or nothing left. */
+interface DeviceNotice {
+    readonly id: number;
+    readonly kind: "microphone" | "camera";
+    /** `switched` = the meeting moved to another device; `lost` = none of this kind is left. */
+    readonly outcome: "switched" | "lost";
+    /** The device that went away, by label (empty when the browser hid labels). */
+    readonly from: string;
+    /** The device now in use (`switched` only). */
+    readonly to: string | null;
+}
+/** A device that just appeared — offered, never switched to silently (catalog `device-default-changed`). */
+interface DeviceOffer {
+    readonly kind: "microphone" | "camera";
+    readonly deviceId: string;
+    readonly label: string;
 }
+/**
+ * THE MEDIA REGIONS THE SUPERVISOR OWNS (CORE-DESIGN §3.2 `audio_output`, and the inputs the
+ * `mic` / `camera` regions are derived from). None of it can change the call phase.
+ */
+interface MediaRegionState {
+    readonly permission: {
+        readonly microphone: PermissionReading;
+        readonly camera: PermissionReading;
+    };
+    /** `blocked` = the browser's autoplay policy is holding remote audio until a gesture. */
+    readonly audioOutput: "ok" | "blocked";
+    readonly notice: DeviceNotice | null;
+    readonly offer: DeviceOffer | null;
+}
+declare const IDLE_MEDIA_REGION: MediaRegionState;
 interface LocalTrackState {
     /** True only when the track is actually published. Never optimistic. */
     readonly enabled: boolean;
@@ -174,7 +217,7 @@ interface LocalMediaState {
 }
 declare const IDLE_TRACK: LocalTrackState;
 declare const IDLE_MEDIA: LocalMediaState;
-declare function unavailableFrom(error: MeetError): MediaUnavailable;
+declare function unavailableFrom(error: MeetError, reason?: DeviceUnavailableReason): MediaUnavailable;
 /**
  * THE SENTENCE. One definition, so the room chrome, a host's own chrome and the
  * tests cannot say three different things about the same fact.
@@ -702,6 +745,11 @@ interface MeetSnapshot {
      * microphone is a state with a remedy, not a failed join.
      */
     readonly media: LocalMediaState;
+    /**
+     * S6c — the media supervisor's regions: permission per kind, autoplay (`audio_output`), the
+     * last device change and an offered new device. Written only by `media-supervisor.ts`.
+     */
+    readonly mediaRegion: MediaRegionState;
     /** The last failure, with its remedy. Never null-and-hoping. */
     readonly failure: {
         readonly message: string;
@@ -1873,6 +1921,15 @@ interface RoomDriverHandlers {
      * connect and on every change. Optional so an older host driver still works.
      */
     roomMetadata?(metadata: string): void;
+    /**
+     * S6c — MEDIA. Can remote audio play (`false` = the browser's autoplay policy is holding it
+     * until a gesture)? Fired on every change and once right after connect. Optional for older drivers.
+     */
+    audioPlayback?(canPlay: boolean): void;
+    /** S6c — the device list changed (plugged / unplugged), AFTER the SDK re-picked defaults. */
+    devicesChanged?(): void;
+    /** S6c — the SDK could not acquire or keep a local device. `kind` when the SDK knows it. */
+    mediaDeviceError?(error: unknown, kind: "audioinput" | "videoinput" | null): void;
 }
 /** A camera background effect. `image` replaces the background with `imageUrl`. */
 type VideoEffect = {
@@ -1925,6 +1982,11 @@ interface MeetRoomDriver {
     /** The device the driver actually selected, so the UI never lies about it. */
     activeDevices(): Readonly<Record<"audioinput" | "videoinput" | "audiooutput", string | null>>;
     switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
+    /**
+     * S6c — resume remote audio the autoplay policy blocked. MUST run inside the person's click
+     * (the gesture is what the browser checks). Optional: a driver without it never blocks.
+     */
+    startAudio?(): Promise<void>;
 }
 type RoomDriverFactory = (handlers: RoomDriverHandlers) => MeetRoomDriver | Promise<MeetRoomDriver>;
 /** Topics for the in-room control plane. One place, so senders cannot drift. */
@@ -2181,6 +2243,110 @@ declare function createRecordingController(options: RecordingControllerOptions):
 /** The indicator's words. One definition, so no surface invents a softer one. */
 declare function recordingLabel(state: RecordingState): string | null;
 
+/**
+ * MS — THE MEDIA SUPERVISOR (CORE-DESIGN §3.3, step S6c).
+ *
+ * Owns the media regions of §3.2 that are about THIS person's devices and speakers:
+ *
+ * - **Permission per kind.** The browser's error alone cannot tell a person's Block from an
+ *   operating-system refusal or a stale device id (`NotAllowedError` is all three in Chrome), so
+ *   every refusal is classified against the Permissions API: `denied` there is the person's (or
+ *   the site's) Block; a refusal while the browser says `granted` is the operating system. A kind
+ *   whose permission is `denied` reads `unavailable:denied` even when nothing tried to open it —
+ *   a camera the browser will not hand over is not "off by choice".
+ * - **Live device switching.** LiveKit falls back to the default for a lost MICROPHONE by itself
+ *   but MUTES a lost camera (client-sdk-js #2035). On every device change the supervisor checks
+ *   the devices in use against the devices present: a vanished camera moves to the next camera;
+ *   a vanished microphone is reported with the device LiveKit moved to; nothing left of a kind is
+ *   `unavailable:none`. Each is a notice — never a silent switch. A NEW device is offered, never
+ *   taken (a person mid-sentence does not want their mic to jump to a headset being charged).
+ * - **Autoplay.** `audio_output` = `blocked` while the browser holds remote audio until a gesture;
+ *   `enableAudio()` runs inside the person's click; the check is repeated when the tab comes back.
+ *
+ * 🚨 NOTHING HERE CHANGES THE CALL PHASE (§3.1 invariant). Every outcome is region state.
+ * 🚨 NO BROWSER GLOBAL IS TOUCHED HERE: the browser half is the `MediaPlatform` port (§3.5) —
+ * `webMediaPlatform()` below is the web adapter; a React Native host passes its own.
+ */
+
+type MediaKind = "microphone" | "camera";
+type BrowserFamily = "chrome" | "edge" | "firefox" | "safari" | "other";
+type OsFamily = "mac" | "windows" | "ios" | "android" | "linux" | "other";
+interface PlatformDevice {
+    readonly deviceId: string;
+    readonly kind: string;
+    readonly label: string;
+}
+/** The slice of §3.5's `MeetPlatform` the media supervisor needs. */
+interface MediaPlatform {
+    readonly browser: BrowserFamily;
+    readonly os: OsFamily;
+    /** The Permissions API reading, or `unknown` where the browser has none for this kind. */
+    queryPermission(kind: MediaKind): Promise<PermissionReading>;
+    /** Call `onChange` whenever the permission for `kind` changes. Returns the unsubscribe. */
+    watchPermission(kind: MediaKind, onChange: (reading: PermissionReading) => void): () => void;
+    listDevices(): Promise<readonly PlatformDevice[]>;
+    /** The tab became visible again (autoplay is re-checked then). Returns the unsubscribe. */
+    onVisible(callback: () => void): () => void;
+}
+/**
+ * The region reason for a refused device, from the error AND the permission store.
+ * Pure — the rules are the tests.
+ */
+declare function classifyDeviceFailure(error: {
+    readonly code: string;
+    readonly message: string;
+}, permission: PermissionReading): DeviceUnavailableReason;
+/** The contract notice code for an unusable device (HARNESS-CONTRACT §4). */
+declare function deviceNoticeCode(kind: MediaKind, reason: DeviceUnavailableReason): "mic-blocked" | "camera-blocked" | "device-lost";
+/**
+ * The region reason this track is in, or null when the device is usable (on, or off by choice).
+ * A kind the browser's permission store denies is `denied` even when nothing tried to open it.
+ */
+declare function deviceUnavailableReason(track: LocalTrackState, permission: PermissionReading): DeviceUnavailableReason | null;
+/** The short chip text — the skin's words may differ; the reason is the fact. */
+declare function deviceChipLabel(kind: MediaKind, reason: DeviceUnavailableReason): string;
+/**
+ * THE REAL REMEDY, per browser and operating system: the steps a person actually follows. Short
+ * lines (interface text is layout); the last step is always the Try again the screen offers.
+ */
+declare function deviceFixSteps(kind: MediaKind, reason: DeviceUnavailableReason, where: {
+    readonly browser: BrowserFamily;
+    readonly os: OsFamily;
+}): readonly string[];
+declare function detectBrowser(userAgent: string): BrowserFamily;
+declare function detectOs(userAgent: string, maxTouchPoints?: number): OsFamily;
+/** The browser adapter, or null outside a browser (SSR, a test, React Native without one). */
+declare function webMediaPlatform(): MediaPlatform | null;
+interface MediaSupervisorOptions {
+    readonly store: MeetStore;
+    readonly platform: MediaPlatform | null;
+    /** The live room's driver, or null between rooms. */
+    readonly driver: () => MeetRoomDriver | null;
+    readonly report: (level: "info" | "warn" | "error", message: string, remedy?: string) => void;
+}
+interface MediaSupervisor {
+    /** Begin watching permissions and visibility (idempotent). */
+    start(): void;
+    stop(): void;
+    /** The `MediaUnavailable` for a refused device: the browser's words + the region reason. */
+    unavailable(error: unknown, kind: MediaKind, operation: string): Promise<MediaUnavailable>;
+    /** Driver handlers (wired by the engine). */
+    onAudioPlayback(canPlay: boolean): void;
+    onDevicesChanged(): void;
+    onDeviceError(error: unknown, kind: "audioinput" | "videoinput" | null): void;
+    /** The engine connected a room: remember which devices are in use now. */
+    onConnected(): void;
+    /** The room is gone: autoplay and device notices belong to the room. */
+    onDisconnected(): void;
+    /** "Enable sound" — call from inside the person's click. */
+    enableAudio(): Promise<void>;
+    /** Use the offered new device. */
+    acceptOffer(): Promise<void>;
+    dismissOffer(): void;
+    dismissNotice(): void;
+}
+declare function createMediaSupervisor(options: MediaSupervisorOptions): MediaSupervisor;
+
 /**
  * THE ROOM ENGINE — the object a host mounts once and never reasons about.
  *
@@ -2259,6 +2425,11 @@ interface RoomEngineOptions {
      * (default: `navigator.onLine`); `probe` = do our API and the media server answer (default:
      * assume yes); `resume` = per-tab storage for the reload-after-offline marker (default: none).
      */
+    /**
+     * S6c — the media supervisor's platform port (permissions, device list, visibility). Default:
+     * the browser's (`webMediaPlatform()`); `null` turns the supervisor's browser reads off.
+     */
+    mediaPlatform?: MediaPlatform | null | undefined;
     connection?: {
         readonly network?: NetworkPort | undefined;
         readonly probe?: ((serverUrl: string | null) => Promise<boolean>) | undefined;
@@ -2322,6 +2493,12 @@ interface RoomEngine {
     supportsVideoEffects(): boolean;
     /** Whether this browser can share a screen at all — the control is ABSENT where it cannot. */
     supportsScreenShare(): boolean;
+    /** S6c: "Enable sound" — resume remote audio the autoplay policy holds. Call inside the click. */
+    enableAudio(): Promise<void>;
+    /** S6c: switch to the device the supervisor offered (a new one was plugged in). */
+    acceptDeviceOffer(): Promise<void>;
+    dismissDeviceOffer(): void;
+    dismissDeviceNotice(): void;
     /** Choose the speaker (audio output) for this meeting. */
     switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
     pin(identity: ParticipantIdentity | null): void;
@@ -3593,8 +3770,12 @@ interface ObserveInput {
     /** The row the consumer resolved, when the store has none yet (the guest lane). */
     readonly meeting?: MeetingRecord | null | undefined;
 }
-/** The store's device state → the contract's `camera` / `microphone` value. */
-declare function observedDevice(track: LocalTrackState): string;
+/**
+ * The store's device state → the contract's `camera` / `microphone` value (CORE-DESIGN §3.2).
+ * The reason comes from the media supervisor (S6c), which reads the browser's permission store: a
+ * kind the browser denies is `unavailable:denied` even when nothing tried to open it.
+ */
+declare function observedDevice(track: LocalTrackState, permission?: PermissionReading): string;
 /**
  * The phase the person is looking at: the store's phase, verbatim (CORE-DESIGN §3.1). The one
  * derivation left is the ended meeting: a row that says it is over renders `ended` for anyone not
@@ -3611,6 +3792,6 @@ declare function observedQuality(quality: ConnectionQuality): string | null;
 /** `[data-meet-participant]` attributes for one person's tile or roster row. */
 declare function participantAttributes(p: MeetParticipant): Record<string, string>;
 /** The listen-only notice's contract code, from why the microphone is off. */
-declare function microphoneNoticeCode(track: LocalTrackState): "mic-blocked" | "device-lost" | null;
+declare function microphoneNoticeCode(track: LocalTrackState, permission?: PermissionReading): "mic-blocked" | "device-lost" | null;
 
-export { ATTENDANCE_CSV_HEADER, AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AttendanceKind, type AttendanceRow, type AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, CallId, CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, CallMode, type CallOutcomePhase, CallState, type CollabAction, CollabPanel, type CollabRequest, type CollabResult, type CollabRuntime, CollabSnapshot, type CollabStoreLike, type ConnectionPolicy, ConnectionQuality, type ConnectionRegion, type ConnectionSupervisor, type ConnectionSupervisorOptions, type CreateCallInviteInput, type CreateMeetingInput, DATA_TOPICS, DEFAULT_CONNECTION_POLICY, DEFAULT_EFFECTS, DEFAULT_PAGE_SIZE, type DataTopic, type DeviceKind, type DeviceManager, type DeviceManagerOptions, type DeviceSnapshot, type DeviceStorage, type DriverConnectionState, type DriverParticipant, type DriverTrackKind, type DriverTranscription, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, type ExitInput, type ExitPhase, type ExitResolution, type ExitServerWord, type FollowUpDraft, type FollowUpRecipient, type FollowUpSendResult, GUEST_RECORD_ACCESS_CHOICES, GUEST_RECORD_ACCESS_LEVELS, GUEST_RECORD_ACCESS_METADATA_KEY, GUEST_RECORD_NOT_SHARED, type Ghost, type GuestRecordAccess, type GuestRecordAccessResolution, type GuestRecordAccessSetting, IDLE_MEDIA, IDLE_PHASES, IDLE_TRACK, type InRoomClient, type InRoomClientOptions, InviteeInput, InviteeRole, JOIN_REFUSAL_REASONS, type JoinRefusalReason, type JoinRequest, LISTEN_ONLY_NOTICE, LIVEKIT_BASE_DELAYS_MS, LIVE_PHASES, type LibraryRecording, type LiveKitDriverOptions, LobbyEntry, type LocalMediaState, type LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEETING_PASS_HEADER, MEETING_RECORD_GRACE_MS, MEET_ANSWER_CONTEXT_EVENT, MEET_ANSWER_EVENTS, MEET_EVENTS, MEET_REACTIONS, MEET_ROUTES, MEET_SCHEMA, MODERATION_ACTIONS, type MediaDevicesLike, type MediaEffects, type MediaUnavailable, type MeetAi, type MeetAiAnswer, type MeetAiOptions, type MeetAnswerCoverage, MeetApi, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetGrants, MeetIdentity, type MeetObservation, MeetParticipant, type MeetPatch, type MeetPhase, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, MeetingAttendee, MeetingChanges, type MeetingChatHistory, MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, MeetingInvitee, MeetingKind, MeetingNote, MeetingOccurrence, MeetingRecord, type MeetingRecordAnswer, type MeetingRecordBundle, type MeetingRecordCache, type MeetingRecordChange, type MeetingRecordFailure, type MeetingRecordParts, type MeetingRecordRestriction, type MeetingRecordRestrictionNotice, type MeetingRecordState, type MeetingSearchHit, type MeetingSearchSource, type MeetingSession, type MeetingSessionOptions, MeetingSettings, type ModerationAction, type ModerationNotice, type ModerationRequest, type ModerationResult, NOTE_TAKER_IDENTITY_PREFIX, NOTE_TAKER_METADATA_KEY, NO_GRANTS, NO_SHARE, type NameBook, type NetworkPort, type NoteTakerDispatch, type NoteTakerRefusal, NoteTakerState, type NoteTakerStatus, type ObserveInput, type ObservedConnection, type ObservedPhase, ObserversVisibleTo, OccurrenceOverride, OrganizationId, PARTICIPANT_CAN_RECORD_ATTRIBUTE, PARTICIPANT_ROLE_ATTRIBUTE, PARTICIPANT_STANDING_ATTRIBUTE, ParticipantIdentity, ParticipantRole, ParticipantStanding, type PhaseEvent, type PhaseEventType, REACTION_TTL_MS, REFUSED_ABSENCE, RESUME_WINDOW_MS, ROOM_EVENTS, ROOM_EVENT_PREFIX, RPCS, type ReconnectPolicyLike, type ReconnectPolicyOptions, type RecordingController, type RecordingControllerOptions, RecordingPolicy, RecordingRecord, RecordingState, type RepositoryOptions, type ResumeMarker, type ResumeStorage, type RoomChatMessage, type RoomDriverFactory, type RoomDriverHandlers, type RoomEngine, type RoomEngineOptions, type RoomEventOutcome, type RoomEventTopic, RoomName, type RoomReaction, type RoomToken, type RoomTokenStorage, RsvpAnswer, RsvpInvitation, type ScheduleMeetingInput, type ShareRegion, type Stage, type StageArgs, StageLayout, TABLES, TRANSCRIPTION_ATTRIBUTES, TRANSCRIPTION_TOPIC, type TokenClient, type TokenClientOptions, type TokenRequest, type TranscriptBlock, type TranscriptFormat, type TranscriptMatch, TranscriptSegment, UpcomingOccurrence, UserId, type VideoEffect, WAITING_PHASES, WrapUpAnnouncement, type WrapUpStatus, absenceSentence, activeWrapUpSummary, activityAttention, admissionPhase, announceMeeting, applyRoomEvent, assembleMeetingRecord, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoRejoinDelayMs, availableActivities, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, clockPosition, computeStage, connectionPolicyFrom, countLabel, createCallCenter, createCallInviteHandler, createConnectionSupervisor, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingRecordCache, createMeetingSession, createMemoryDeviceStorage, createReachabilityProbe, createReconnectPolicy, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebNetworkPort, createWebResumeStorage, createWebRoomTokenStorage, displayNameFor, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, httpUrlOf, invalidResponse, isGuestIdentity, isJoinRefusalReason, isListenOnly, isLivePhase, isNoteTaker, isRealName, isRefusedPhase, isRoomEventTopic, isUnannouncedDeparture, isWaitingPhase, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingChat, loadMeetingRecord, loadMeetingRecordParts, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPassHeaders, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeGhosts, mergeRecord, microphoneNoticeCode, moveToRoom, nextPhase, nextTranslationBatch, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, observe as observeMeeting, observedDevice, observedPhase, observedQuality, orderParticipants, parseRoomToken, participantAttributes, participantSummary, performCollab, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, reasonOf, recordingLabel, recordingNotice, recordingOffsetMs, refusalPhase, rememberedMeetingPass, resolveExit, roleOf, roomTopic, rootAttributes, searchTranscript, sendFollowUp, setCaptionLanguage, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, staticObservation, summarizeMeetingRecordRestrictions, takeMoveRequest, takePanelRequest, transcriptDocument, unavailableFrom, uniqueAttendees, untranslatedLines, userTopic, wasRefused, wrapUpStatus };
+export { ATTENDANCE_CSV_HEADER, AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AttendanceKind, type AttendanceRow, type AudioProcessing, type BrowserFamily, CALL_INVITE_KIND, CALL_INVITE_VERSION, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, CallId, CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, CallMode, type CallOutcomePhase, CallState, type CollabAction, CollabPanel, type CollabRequest, type CollabResult, type CollabRuntime, CollabSnapshot, type CollabStoreLike, type ConnectionPolicy, ConnectionQuality, type ConnectionRegion, type ConnectionSupervisor, type ConnectionSupervisorOptions, type CreateCallInviteInput, type CreateMeetingInput, DATA_TOPICS, DEFAULT_CONNECTION_POLICY, DEFAULT_EFFECTS, DEFAULT_PAGE_SIZE, type DataTopic, type DeviceKind, type DeviceManager, type DeviceManagerOptions, type DeviceNotice, type DeviceOffer, type DeviceSnapshot, type DeviceStorage, type DeviceUnavailableReason, type DriverConnectionState, type DriverParticipant, type DriverTrackKind, type DriverTranscription, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, type ExitInput, type ExitPhase, type ExitResolution, type ExitServerWord, type FollowUpDraft, type FollowUpRecipient, type FollowUpSendResult, GUEST_RECORD_ACCESS_CHOICES, GUEST_RECORD_ACCESS_LEVELS, GUEST_RECORD_ACCESS_METADATA_KEY, GUEST_RECORD_NOT_SHARED, type Ghost, type GuestRecordAccess, type GuestRecordAccessResolution, type GuestRecordAccessSetting, IDLE_MEDIA, IDLE_MEDIA_REGION, IDLE_PHASES, IDLE_TRACK, type InRoomClient, type InRoomClientOptions, InviteeInput, InviteeRole, JOIN_REFUSAL_REASONS, type JoinRefusalReason, type JoinRequest, LISTEN_ONLY_NOTICE, LIVEKIT_BASE_DELAYS_MS, LIVE_PHASES, type LibraryRecording, type LiveKitDriverOptions, LobbyEntry, type LocalMediaState, type LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEETING_PASS_HEADER, MEETING_RECORD_GRACE_MS, MEET_ANSWER_CONTEXT_EVENT, MEET_ANSWER_EVENTS, MEET_EVENTS, MEET_REACTIONS, MEET_ROUTES, MEET_SCHEMA, MODERATION_ACTIONS, type MediaDevicesLike, type MediaEffects, type MediaKind, type MediaPlatform, type MediaRegionState, type MediaSupervisor, type MediaSupervisorOptions, type MediaUnavailable, type MeetAi, type MeetAiAnswer, type MeetAiOptions, type MeetAnswerCoverage, MeetApi, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetGrants, MeetIdentity, type MeetObservation, MeetParticipant, type MeetPatch, type MeetPhase, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, MeetingAttendee, MeetingChanges, type MeetingChatHistory, MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, MeetingInvitee, MeetingKind, MeetingNote, MeetingOccurrence, MeetingRecord, type MeetingRecordAnswer, type MeetingRecordBundle, type MeetingRecordCache, type MeetingRecordChange, type MeetingRecordFailure, type MeetingRecordParts, type MeetingRecordRestriction, type MeetingRecordRestrictionNotice, type MeetingRecordState, type MeetingSearchHit, type MeetingSearchSource, type MeetingSession, type MeetingSessionOptions, MeetingSettings, type ModerationAction, type ModerationNotice, type ModerationRequest, type ModerationResult, NOTE_TAKER_IDENTITY_PREFIX, NOTE_TAKER_METADATA_KEY, NO_GRANTS, NO_SHARE, type NameBook, type NetworkPort, type NoteTakerDispatch, type NoteTakerRefusal, NoteTakerState, type NoteTakerStatus, type ObserveInput, type ObservedConnection, type ObservedPhase, ObserversVisibleTo, OccurrenceOverride, OrganizationId, type OsFamily, PARTICIPANT_CAN_RECORD_ATTRIBUTE, PARTICIPANT_ROLE_ATTRIBUTE, PARTICIPANT_STANDING_ATTRIBUTE, ParticipantIdentity, ParticipantRole, ParticipantStanding, type PermissionReading, type PhaseEvent, type PhaseEventType, type PlatformDevice, REACTION_TTL_MS, REFUSED_ABSENCE, RESUME_WINDOW_MS, ROOM_EVENTS, ROOM_EVENT_PREFIX, RPCS, type ReconnectPolicyLike, type ReconnectPolicyOptions, type RecordingController, type RecordingControllerOptions, RecordingPolicy, RecordingRecord, RecordingState, type RepositoryOptions, type ResumeMarker, type ResumeStorage, type RoomChatMessage, type RoomDriverFactory, type RoomDriverHandlers, type RoomEngine, type RoomEngineOptions, type RoomEventOutcome, type RoomEventTopic, RoomName, type RoomReaction, type RoomToken, type RoomTokenStorage, RsvpAnswer, RsvpInvitation, type ScheduleMeetingInput, type ShareRegion, type Stage, type StageArgs, StageLayout, TABLES, TRANSCRIPTION_ATTRIBUTES, TRANSCRIPTION_TOPIC, type TokenClient, type TokenClientOptions, type TokenRequest, type TranscriptBlock, type TranscriptFormat, type TranscriptMatch, TranscriptSegment, UpcomingOccurrence, UserId, type VideoEffect, WAITING_PHASES, WrapUpAnnouncement, type WrapUpStatus, absenceSentence, activeWrapUpSummary, activityAttention, admissionPhase, announceMeeting, applyRoomEvent, assembleMeetingRecord, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoRejoinDelayMs, availableActivities, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, classifyDeviceFailure, clockPosition, computeStage, connectionPolicyFrom, countLabel, createCallCenter, createCallInviteHandler, createConnectionSupervisor, createDeviceManager, createInRoomClient, createLiveKitDriver, createMediaSupervisor, createMeetAi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingRecordCache, createMeetingSession, createMemoryDeviceStorage, createReachabilityProbe, createReconnectPolicy, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebNetworkPort, createWebResumeStorage, createWebRoomTokenStorage, detectBrowser, detectOs, deviceChipLabel, deviceFixSteps, deviceNoticeCode, deviceUnavailableReason, displayNameFor, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, httpUrlOf, invalidResponse, isGuestIdentity, isJoinRefusalReason, isListenOnly, isLivePhase, isNoteTaker, isRealName, isRefusedPhase, isRoomEventTopic, isUnannouncedDeparture, isWaitingPhase, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingChat, loadMeetingRecord, loadMeetingRecordParts, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPassHeaders, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeGhosts, mergeRecord, microphoneNoticeCode, moveToRoom, nextPhase, nextTranslationBatch, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, observe as observeMeeting, observedDevice, observedPhase, observedQuality, orderParticipants, parseRoomToken, participantAttributes, participantSummary, performCollab, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, reasonOf, recordingLabel, recordingNotice, recordingOffsetMs, refusalPhase, rememberedMeetingPass, resolveExit, roleOf, roomTopic, rootAttributes, searchTranscript, sendFollowUp, setCaptionLanguage, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, staticObservation, summarizeMeetingRecordRestrictions, takeMoveRequest, takePanelRequest, transcriptDocument, unavailableFrom, uniqueAttendees, untranslatedLines, userTopic, wasRefused, webMediaPlatform, wrapUpStatus };

package/dist/core.d.ts

@@ -152,12 +152,55 @@ declare function displayNameFor(book: NameBook, identity: ParticipantIdentity |
  *    there is no second wording to keep in sync.
  */
 
+/**
+ * WHY a device is unusable, in the contract's words (CORE-DESIGN §3.2, the `mic` / `camera`
+ * region's `unavailable:<reason>`). The media supervisor (`media-supervisor.ts`) decides it from
+ * the browser's error AND the Permissions API, because the error alone cannot tell a person's
+ * Block from an operating-system refusal or a stale device id.
+ */
+type DeviceUnavailableReason = "denied" | "blocked_site" | "blocked_os" | "none" | "busy" | "failed" | "revoked";
 /** Why a local track is not publishing, in the browser's terms plus a remedy. */
 interface MediaUnavailable {
     readonly code: string;
     readonly message: string;
     readonly remedy: string;
+    /** The region reason (S6c). Absent on states recorded before the supervisor classified them. */
+    readonly reason?: DeviceUnavailableReason | undefined;
+}
+/** What the browser's permission store says for one device kind. `unknown` = no Permissions API. */
+type PermissionReading = "granted" | "denied" | "prompt" | "unknown";
+/** A device change the person is told about (S6c): unplugged → switched, or nothing left. */
+interface DeviceNotice {
+    readonly id: number;
+    readonly kind: "microphone" | "camera";
+    /** `switched` = the meeting moved to another device; `lost` = none of this kind is left. */
+    readonly outcome: "switched" | "lost";
+    /** The device that went away, by label (empty when the browser hid labels). */
+    readonly from: string;
+    /** The device now in use (`switched` only). */
+    readonly to: string | null;
+}
+/** A device that just appeared — offered, never switched to silently (catalog `device-default-changed`). */
+interface DeviceOffer {
+    readonly kind: "microphone" | "camera";
+    readonly deviceId: string;
+    readonly label: string;
 }
+/**
+ * THE MEDIA REGIONS THE SUPERVISOR OWNS (CORE-DESIGN §3.2 `audio_output`, and the inputs the
+ * `mic` / `camera` regions are derived from). None of it can change the call phase.
+ */
+interface MediaRegionState {
+    readonly permission: {
+        readonly microphone: PermissionReading;
+        readonly camera: PermissionReading;
+    };
+    /** `blocked` = the browser's autoplay policy is holding remote audio until a gesture. */
+    readonly audioOutput: "ok" | "blocked";
+    readonly notice: DeviceNotice | null;
+    readonly offer: DeviceOffer | null;
+}
+declare const IDLE_MEDIA_REGION: MediaRegionState;
 interface LocalTrackState {
     /** True only when the track is actually published. Never optimistic. */
     readonly enabled: boolean;
@@ -174,7 +217,7 @@ interface LocalMediaState {
 }
 declare const IDLE_TRACK: LocalTrackState;
 declare const IDLE_MEDIA: LocalMediaState;
-declare function unavailableFrom(error: MeetError): MediaUnavailable;
+declare function unavailableFrom(error: MeetError, reason?: DeviceUnavailableReason): MediaUnavailable;
 /**
  * THE SENTENCE. One definition, so the room chrome, a host's own chrome and the
  * tests cannot say three different things about the same fact.
@@ -702,6 +745,11 @@ interface MeetSnapshot {
      * microphone is a state with a remedy, not a failed join.
      */
     readonly media: LocalMediaState;
+    /**
+     * S6c — the media supervisor's regions: permission per kind, autoplay (`audio_output`), the
+     * last device change and an offered new device. Written only by `media-supervisor.ts`.
+     */
+    readonly mediaRegion: MediaRegionState;
     /** The last failure, with its remedy. Never null-and-hoping. */
     readonly failure: {
         readonly message: string;
@@ -1873,6 +1921,15 @@ interface RoomDriverHandlers {
      * connect and on every change. Optional so an older host driver still works.
      */
     roomMetadata?(metadata: string): void;
+    /**
+     * S6c — MEDIA. Can remote audio play (`false` = the browser's autoplay policy is holding it
+     * until a gesture)? Fired on every change and once right after connect. Optional for older drivers.
+     */
+    audioPlayback?(canPlay: boolean): void;
+    /** S6c — the device list changed (plugged / unplugged), AFTER the SDK re-picked defaults. */
+    devicesChanged?(): void;
+    /** S6c — the SDK could not acquire or keep a local device. `kind` when the SDK knows it. */
+    mediaDeviceError?(error: unknown, kind: "audioinput" | "videoinput" | null): void;
 }
 /** A camera background effect. `image` replaces the background with `imageUrl`. */
 type VideoEffect = {
@@ -1925,6 +1982,11 @@ interface MeetRoomDriver {
     /** The device the driver actually selected, so the UI never lies about it. */
     activeDevices(): Readonly<Record<"audioinput" | "videoinput" | "audiooutput", string | null>>;
     switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
+    /**
+     * S6c — resume remote audio the autoplay policy blocked. MUST run inside the person's click
+     * (the gesture is what the browser checks). Optional: a driver without it never blocks.
+     */
+    startAudio?(): Promise<void>;
 }
 type RoomDriverFactory = (handlers: RoomDriverHandlers) => MeetRoomDriver | Promise<MeetRoomDriver>;
 /** Topics for the in-room control plane. One place, so senders cannot drift. */
@@ -2181,6 +2243,110 @@ declare function createRecordingController(options: RecordingControllerOptions):
 /** The indicator's words. One definition, so no surface invents a softer one. */
 declare function recordingLabel(state: RecordingState): string | null;
 
+/**
+ * MS — THE MEDIA SUPERVISOR (CORE-DESIGN §3.3, step S6c).
+ *
+ * Owns the media regions of §3.2 that are about THIS person's devices and speakers:
+ *
+ * - **Permission per kind.** The browser's error alone cannot tell a person's Block from an
+ *   operating-system refusal or a stale device id (`NotAllowedError` is all three in Chrome), so
+ *   every refusal is classified against the Permissions API: `denied` there is the person's (or
+ *   the site's) Block; a refusal while the browser says `granted` is the operating system. A kind
+ *   whose permission is `denied` reads `unavailable:denied` even when nothing tried to open it —
+ *   a camera the browser will not hand over is not "off by choice".
+ * - **Live device switching.** LiveKit falls back to the default for a lost MICROPHONE by itself
+ *   but MUTES a lost camera (client-sdk-js #2035). On every device change the supervisor checks
+ *   the devices in use against the devices present: a vanished camera moves to the next camera;
+ *   a vanished microphone is reported with the device LiveKit moved to; nothing left of a kind is
+ *   `unavailable:none`. Each is a notice — never a silent switch. A NEW device is offered, never
+ *   taken (a person mid-sentence does not want their mic to jump to a headset being charged).
+ * - **Autoplay.** `audio_output` = `blocked` while the browser holds remote audio until a gesture;
+ *   `enableAudio()` runs inside the person's click; the check is repeated when the tab comes back.
+ *
+ * 🚨 NOTHING HERE CHANGES THE CALL PHASE (§3.1 invariant). Every outcome is region state.
+ * 🚨 NO BROWSER GLOBAL IS TOUCHED HERE: the browser half is the `MediaPlatform` port (§3.5) —
+ * `webMediaPlatform()` below is the web adapter; a React Native host passes its own.
+ */
+
+type MediaKind = "microphone" | "camera";
+type BrowserFamily = "chrome" | "edge" | "firefox" | "safari" | "other";
+type OsFamily = "mac" | "windows" | "ios" | "android" | "linux" | "other";
+interface PlatformDevice {
+    readonly deviceId: string;
+    readonly kind: string;
+    readonly label: string;
+}
+/** The slice of §3.5's `MeetPlatform` the media supervisor needs. */
+interface MediaPlatform {
+    readonly browser: BrowserFamily;
+    readonly os: OsFamily;
+    /** The Permissions API reading, or `unknown` where the browser has none for this kind. */
+    queryPermission(kind: MediaKind): Promise<PermissionReading>;
+    /** Call `onChange` whenever the permission for `kind` changes. Returns the unsubscribe. */
+    watchPermission(kind: MediaKind, onChange: (reading: PermissionReading) => void): () => void;
+    listDevices(): Promise<readonly PlatformDevice[]>;
+    /** The tab became visible again (autoplay is re-checked then). Returns the unsubscribe. */
+    onVisible(callback: () => void): () => void;
+}
+/**
+ * The region reason for a refused device, from the error AND the permission store.
+ * Pure — the rules are the tests.
+ */
+declare function classifyDeviceFailure(error: {
+    readonly code: string;
+    readonly message: string;
+}, permission: PermissionReading): DeviceUnavailableReason;
+/** The contract notice code for an unusable device (HARNESS-CONTRACT §4). */
+declare function deviceNoticeCode(kind: MediaKind, reason: DeviceUnavailableReason): "mic-blocked" | "camera-blocked" | "device-lost";
+/**
+ * The region reason this track is in, or null when the device is usable (on, or off by choice).
+ * A kind the browser's permission store denies is `denied` even when nothing tried to open it.
+ */
+declare function deviceUnavailableReason(track: LocalTrackState, permission: PermissionReading): DeviceUnavailableReason | null;
+/** The short chip text — the skin's words may differ; the reason is the fact. */
+declare function deviceChipLabel(kind: MediaKind, reason: DeviceUnavailableReason): string;
+/**
+ * THE REAL REMEDY, per browser and operating system: the steps a person actually follows. Short
+ * lines (interface text is layout); the last step is always the Try again the screen offers.
+ */
+declare function deviceFixSteps(kind: MediaKind, reason: DeviceUnavailableReason, where: {
+    readonly browser: BrowserFamily;
+    readonly os: OsFamily;
+}): readonly string[];
+declare function detectBrowser(userAgent: string): BrowserFamily;
+declare function detectOs(userAgent: string, maxTouchPoints?: number): OsFamily;
+/** The browser adapter, or null outside a browser (SSR, a test, React Native without one). */
+declare function webMediaPlatform(): MediaPlatform | null;
+interface MediaSupervisorOptions {
+    readonly store: MeetStore;
+    readonly platform: MediaPlatform | null;
+    /** The live room's driver, or null between rooms. */
+    readonly driver: () => MeetRoomDriver | null;
+    readonly report: (level: "info" | "warn" | "error", message: string, remedy?: string) => void;
+}
+interface MediaSupervisor {
+    /** Begin watching permissions and visibility (idempotent). */
+    start(): void;
+    stop(): void;
+    /** The `MediaUnavailable` for a refused device: the browser's words + the region reason. */
+    unavailable(error: unknown, kind: MediaKind, operation: string): Promise<MediaUnavailable>;
+    /** Driver handlers (wired by the engine). */
+    onAudioPlayback(canPlay: boolean): void;
+    onDevicesChanged(): void;
+    onDeviceError(error: unknown, kind: "audioinput" | "videoinput" | null): void;
+    /** The engine connected a room: remember which devices are in use now. */
+    onConnected(): void;
+    /** The room is gone: autoplay and device notices belong to the room. */
+    onDisconnected(): void;
+    /** "Enable sound" — call from inside the person's click. */
+    enableAudio(): Promise<void>;
+    /** Use the offered new device. */
+    acceptOffer(): Promise<void>;
+    dismissOffer(): void;
+    dismissNotice(): void;
+}
+declare function createMediaSupervisor(options: MediaSupervisorOptions): MediaSupervisor;
+
 /**
  * THE ROOM ENGINE — the object a host mounts once and never reasons about.
  *
@@ -2259,6 +2425,11 @@ interface RoomEngineOptions {
      * (default: `navigator.onLine`); `probe` = do our API and the media server answer (default:
      * assume yes); `resume` = per-tab storage for the reload-after-offline marker (default: none).
      */
+    /**
+     * S6c — the media supervisor's platform port (permissions, device list, visibility). Default:
+     * the browser's (`webMediaPlatform()`); `null` turns the supervisor's browser reads off.
+     */
+    mediaPlatform?: MediaPlatform | null | undefined;
     connection?: {
         readonly network?: NetworkPort | undefined;
         readonly probe?: ((serverUrl: string | null) => Promise<boolean>) | undefined;
@@ -2322,6 +2493,12 @@ interface RoomEngine {
     supportsVideoEffects(): boolean;
     /** Whether this browser can share a screen at all — the control is ABSENT where it cannot. */
     supportsScreenShare(): boolean;
+    /** S6c: "Enable sound" — resume remote audio the autoplay policy holds. Call inside the click. */
+    enableAudio(): Promise<void>;
+    /** S6c: switch to the device the supervisor offered (a new one was plugged in). */
+    acceptDeviceOffer(): Promise<void>;
+    dismissDeviceOffer(): void;
+    dismissDeviceNotice(): void;
     /** Choose the speaker (audio output) for this meeting. */
     switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
     pin(identity: ParticipantIdentity | null): void;
@@ -3593,8 +3770,12 @@ interface ObserveInput {
     /** The row the consumer resolved, when the store has none yet (the guest lane). */
     readonly meeting?: MeetingRecord | null | undefined;
 }
-/** The store's device state → the contract's `camera` / `microphone` value. */
-declare function observedDevice(track: LocalTrackState): string;
+/**
+ * The store's device state → the contract's `camera` / `microphone` value (CORE-DESIGN §3.2).
+ * The reason comes from the media supervisor (S6c), which reads the browser's permission store: a
+ * kind the browser denies is `unavailable:denied` even when nothing tried to open it.
+ */
+declare function observedDevice(track: LocalTrackState, permission?: PermissionReading): string;
 /**
  * The phase the person is looking at: the store's phase, verbatim (CORE-DESIGN §3.1). The one
  * derivation left is the ended meeting: a row that says it is over renders `ended` for anyone not
@@ -3611,6 +3792,6 @@ declare function observedQuality(quality: ConnectionQuality): string | null;
 /** `[data-meet-participant]` attributes for one person's tile or roster row. */
 declare function participantAttributes(p: MeetParticipant): Record<string, string>;
 /** The listen-only notice's contract code, from why the microphone is off. */
-declare function microphoneNoticeCode(track: LocalTrackState): "mic-blocked" | "device-lost" | null;
+declare function microphoneNoticeCode(track: LocalTrackState, permission?: PermissionReading): "mic-blocked" | "device-lost" | null;
 
-export { ATTENDANCE_CSV_HEADER, AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AttendanceKind, type AttendanceRow, type AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, CallId, CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, CallMode, type CallOutcomePhase, CallState, type CollabAction, CollabPanel, type CollabRequest, type CollabResult, type CollabRuntime, CollabSnapshot, type CollabStoreLike, type ConnectionPolicy, ConnectionQuality, type ConnectionRegion, type ConnectionSupervisor, type ConnectionSupervisorOptions, type CreateCallInviteInput, type CreateMeetingInput, DATA_TOPICS, DEFAULT_CONNECTION_POLICY, DEFAULT_EFFECTS, DEFAULT_PAGE_SIZE, type DataTopic, type DeviceKind, type DeviceManager, type DeviceManagerOptions, type DeviceSnapshot, type DeviceStorage, type DriverConnectionState, type DriverParticipant, type DriverTrackKind, type DriverTranscription, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, type ExitInput, type ExitPhase, type ExitResolution, type ExitServerWord, type FollowUpDraft, type FollowUpRecipient, type FollowUpSendResult, GUEST_RECORD_ACCESS_CHOICES, GUEST_RECORD_ACCESS_LEVELS, GUEST_RECORD_ACCESS_METADATA_KEY, GUEST_RECORD_NOT_SHARED, type Ghost, type GuestRecordAccess, type GuestRecordAccessResolution, type GuestRecordAccessSetting, IDLE_MEDIA, IDLE_PHASES, IDLE_TRACK, type InRoomClient, type InRoomClientOptions, InviteeInput, InviteeRole, JOIN_REFUSAL_REASONS, type JoinRefusalReason, type JoinRequest, LISTEN_ONLY_NOTICE, LIVEKIT_BASE_DELAYS_MS, LIVE_PHASES, type LibraryRecording, type LiveKitDriverOptions, LobbyEntry, type LocalMediaState, type LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEETING_PASS_HEADER, MEETING_RECORD_GRACE_MS, MEET_ANSWER_CONTEXT_EVENT, MEET_ANSWER_EVENTS, MEET_EVENTS, MEET_REACTIONS, MEET_ROUTES, MEET_SCHEMA, MODERATION_ACTIONS, type MediaDevicesLike, type MediaEffects, type MediaUnavailable, type MeetAi, type MeetAiAnswer, type MeetAiOptions, type MeetAnswerCoverage, MeetApi, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetGrants, MeetIdentity, type MeetObservation, MeetParticipant, type MeetPatch, type MeetPhase, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, MeetingAttendee, MeetingChanges, type MeetingChatHistory, MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, MeetingInvitee, MeetingKind, MeetingNote, MeetingOccurrence, MeetingRecord, type MeetingRecordAnswer, type MeetingRecordBundle, type MeetingRecordCache, type MeetingRecordChange, type MeetingRecordFailure, type MeetingRecordParts, type MeetingRecordRestriction, type MeetingRecordRestrictionNotice, type MeetingRecordState, type MeetingSearchHit, type MeetingSearchSource, type MeetingSession, type MeetingSessionOptions, MeetingSettings, type ModerationAction, type ModerationNotice, type ModerationRequest, type ModerationResult, NOTE_TAKER_IDENTITY_PREFIX, NOTE_TAKER_METADATA_KEY, NO_GRANTS, NO_SHARE, type NameBook, type NetworkPort, type NoteTakerDispatch, type NoteTakerRefusal, NoteTakerState, type NoteTakerStatus, type ObserveInput, type ObservedConnection, type ObservedPhase, ObserversVisibleTo, OccurrenceOverride, OrganizationId, PARTICIPANT_CAN_RECORD_ATTRIBUTE, PARTICIPANT_ROLE_ATTRIBUTE, PARTICIPANT_STANDING_ATTRIBUTE, ParticipantIdentity, ParticipantRole, ParticipantStanding, type PhaseEvent, type PhaseEventType, REACTION_TTL_MS, REFUSED_ABSENCE, RESUME_WINDOW_MS, ROOM_EVENTS, ROOM_EVENT_PREFIX, RPCS, type ReconnectPolicyLike, type ReconnectPolicyOptions, type RecordingController, type RecordingControllerOptions, RecordingPolicy, RecordingRecord, RecordingState, type RepositoryOptions, type ResumeMarker, type ResumeStorage, type RoomChatMessage, type RoomDriverFactory, type RoomDriverHandlers, type RoomEngine, type RoomEngineOptions, type RoomEventOutcome, type RoomEventTopic, RoomName, type RoomReaction, type RoomToken, type RoomTokenStorage, RsvpAnswer, RsvpInvitation, type ScheduleMeetingInput, type ShareRegion, type Stage, type StageArgs, StageLayout, TABLES, TRANSCRIPTION_ATTRIBUTES, TRANSCRIPTION_TOPIC, type TokenClient, type TokenClientOptions, type TokenRequest, type TranscriptBlock, type TranscriptFormat, type TranscriptMatch, TranscriptSegment, UpcomingOccurrence, UserId, type VideoEffect, WAITING_PHASES, WrapUpAnnouncement, type WrapUpStatus, absenceSentence, activeWrapUpSummary, activityAttention, admissionPhase, announceMeeting, applyRoomEvent, assembleMeetingRecord, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoRejoinDelayMs, availableActivities, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, clockPosition, computeStage, connectionPolicyFrom, countLabel, createCallCenter, createCallInviteHandler, createConnectionSupervisor, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingRecordCache, createMeetingSession, createMemoryDeviceStorage, createReachabilityProbe, createReconnectPolicy, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebNetworkPort, createWebResumeStorage, createWebRoomTokenStorage, displayNameFor, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, httpUrlOf, invalidResponse, isGuestIdentity, isJoinRefusalReason, isListenOnly, isLivePhase, isNoteTaker, isRealName, isRefusedPhase, isRoomEventTopic, isUnannouncedDeparture, isWaitingPhase, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingChat, loadMeetingRecord, loadMeetingRecordParts, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPassHeaders, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeGhosts, mergeRecord, microphoneNoticeCode, moveToRoom, nextPhase, nextTranslationBatch, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, observe as observeMeeting, observedDevice, observedPhase, observedQuality, orderParticipants, parseRoomToken, participantAttributes, participantSummary, performCollab, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, reasonOf, recordingLabel, recordingNotice, recordingOffsetMs, refusalPhase, rememberedMeetingPass, resolveExit, roleOf, roomTopic, rootAttributes, searchTranscript, sendFollowUp, setCaptionLanguage, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, staticObservation, summarizeMeetingRecordRestrictions, takeMoveRequest, takePanelRequest, transcriptDocument, unavailableFrom, uniqueAttendees, untranslatedLines, userTopic, wasRefused, wrapUpStatus };
+export { ATTENDANCE_CSV_HEADER, AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AttendanceKind, type AttendanceRow, type AudioProcessing, type BrowserFamily, CALL_INVITE_KIND, CALL_INVITE_VERSION, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, CallId, CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, CallMode, type CallOutcomePhase, CallState, type CollabAction, CollabPanel, type CollabRequest, type CollabResult, type CollabRuntime, CollabSnapshot, type CollabStoreLike, type ConnectionPolicy, ConnectionQuality, type ConnectionRegion, type ConnectionSupervisor, type ConnectionSupervisorOptions, type CreateCallInviteInput, type CreateMeetingInput, DATA_TOPICS, DEFAULT_CONNECTION_POLICY, DEFAULT_EFFECTS, DEFAULT_PAGE_SIZE, type DataTopic, type DeviceKind, type DeviceManager, type DeviceManagerOptions, type DeviceNotice, type DeviceOffer, type DeviceSnapshot, type DeviceStorage, type DeviceUnavailableReason, type DriverConnectionState, type DriverParticipant, type DriverTrackKind, type DriverTranscription, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, type ExitInput, type ExitPhase, type ExitResolution, type ExitServerWord, type FollowUpDraft, type FollowUpRecipient, type FollowUpSendResult, GUEST_RECORD_ACCESS_CHOICES, GUEST_RECORD_ACCESS_LEVELS, GUEST_RECORD_ACCESS_METADATA_KEY, GUEST_RECORD_NOT_SHARED, type Ghost, type GuestRecordAccess, type GuestRecordAccessResolution, type GuestRecordAccessSetting, IDLE_MEDIA, IDLE_MEDIA_REGION, IDLE_PHASES, IDLE_TRACK, type InRoomClient, type InRoomClientOptions, InviteeInput, InviteeRole, JOIN_REFUSAL_REASONS, type JoinRefusalReason, type JoinRequest, LISTEN_ONLY_NOTICE, LIVEKIT_BASE_DELAYS_MS, LIVE_PHASES, type LibraryRecording, type LiveKitDriverOptions, LobbyEntry, type LocalMediaState, type LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEETING_PASS_HEADER, MEETING_RECORD_GRACE_MS, MEET_ANSWER_CONTEXT_EVENT, MEET_ANSWER_EVENTS, MEET_EVENTS, MEET_REACTIONS, MEET_ROUTES, MEET_SCHEMA, MODERATION_ACTIONS, type MediaDevicesLike, type MediaEffects, type MediaKind, type MediaPlatform, type MediaRegionState, type MediaSupervisor, type MediaSupervisorOptions, type MediaUnavailable, type MeetAi, type MeetAiAnswer, type MeetAiOptions, type MeetAnswerCoverage, MeetApi, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetGrants, MeetIdentity, type MeetObservation, MeetParticipant, type MeetPatch, type MeetPhase, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, MeetingAttendee, MeetingChanges, type MeetingChatHistory, MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, MeetingInvitee, MeetingKind, MeetingNote, MeetingOccurrence, MeetingRecord, type MeetingRecordAnswer, type MeetingRecordBundle, type MeetingRecordCache, type MeetingRecordChange, type MeetingRecordFailure, type MeetingRecordParts, type MeetingRecordRestriction, type MeetingRecordRestrictionNotice, type MeetingRecordState, type MeetingSearchHit, type MeetingSearchSource, type MeetingSession, type MeetingSessionOptions, MeetingSettings, type ModerationAction, type ModerationNotice, type ModerationRequest, type ModerationResult, NOTE_TAKER_IDENTITY_PREFIX, NOTE_TAKER_METADATA_KEY, NO_GRANTS, NO_SHARE, type NameBook, type NetworkPort, type NoteTakerDispatch, type NoteTakerRefusal, NoteTakerState, type NoteTakerStatus, type ObserveInput, type ObservedConnection, type ObservedPhase, ObserversVisibleTo, OccurrenceOverride, OrganizationId, type OsFamily, PARTICIPANT_CAN_RECORD_ATTRIBUTE, PARTICIPANT_ROLE_ATTRIBUTE, PARTICIPANT_STANDING_ATTRIBUTE, ParticipantIdentity, ParticipantRole, ParticipantStanding, type PermissionReading, type PhaseEvent, type PhaseEventType, type PlatformDevice, REACTION_TTL_MS, REFUSED_ABSENCE, RESUME_WINDOW_MS, ROOM_EVENTS, ROOM_EVENT_PREFIX, RPCS, type ReconnectPolicyLike, type ReconnectPolicyOptions, type RecordingController, type RecordingControllerOptions, RecordingPolicy, RecordingRecord, RecordingState, type RepositoryOptions, type ResumeMarker, type ResumeStorage, type RoomChatMessage, type RoomDriverFactory, type RoomDriverHandlers, type RoomEngine, type RoomEngineOptions, type RoomEventOutcome, type RoomEventTopic, RoomName, type RoomReaction, type RoomToken, type RoomTokenStorage, RsvpAnswer, RsvpInvitation, type ScheduleMeetingInput, type ShareRegion, type Stage, type StageArgs, StageLayout, TABLES, TRANSCRIPTION_ATTRIBUTES, TRANSCRIPTION_TOPIC, type TokenClient, type TokenClientOptions, type TokenRequest, type TranscriptBlock, type TranscriptFormat, type TranscriptMatch, TranscriptSegment, UpcomingOccurrence, UserId, type VideoEffect, WAITING_PHASES, WrapUpAnnouncement, type WrapUpStatus, absenceSentence, activeWrapUpSummary, activityAttention, admissionPhase, announceMeeting, applyRoomEvent, assembleMeetingRecord, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoRejoinDelayMs, availableActivities, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, classifyDeviceFailure, clockPosition, computeStage, connectionPolicyFrom, countLabel, createCallCenter, createCallInviteHandler, createConnectionSupervisor, createDeviceManager, createInRoomClient, createLiveKitDriver, createMediaSupervisor, createMeetAi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingRecordCache, createMeetingSession, createMemoryDeviceStorage, createReachabilityProbe, createReconnectPolicy, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebNetworkPort, createWebResumeStorage, createWebRoomTokenStorage, detectBrowser, detectOs, deviceChipLabel, deviceFixSteps, deviceNoticeCode, deviceUnavailableReason, displayNameFor, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, httpUrlOf, invalidResponse, isGuestIdentity, isJoinRefusalReason, isListenOnly, isLivePhase, isNoteTaker, isRealName, isRefusedPhase, isRoomEventTopic, isUnannouncedDeparture, isWaitingPhase, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingChat, loadMeetingRecord, loadMeetingRecordParts, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPassHeaders, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeGhosts, mergeRecord, microphoneNoticeCode, moveToRoom, nextPhase, nextTranslationBatch, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, observe as observeMeeting, observedDevice, observedPhase, observedQuality, orderParticipants, parseRoomToken, participantAttributes, participantSummary, performCollab, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, reasonOf, recordingLabel, recordingNotice, recordingOffsetMs, refusalPhase, rememberedMeetingPass, resolveExit, roleOf, roomTopic, rootAttributes, searchTranscript, sendFollowUp, setCaptionLanguage, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, staticObservation, summarizeMeetingRecordRestrictions, takeMoveRequest, takePanelRequest, transcriptDocument, unavailableFrom, uniqueAttendees, untranslatedLines, userTopic, wasRefused, webMediaPlatform, wrapUpStatus };