@ai-matrx/meet 0.11.42 → 0.11.43

package/dist/core.d.cts

@@ -1,5 +1,5 @@
-import { P as ParticipantIdentity, e as ParticipantRole, k as AdmissionState, a1 as NoteTakerState, a as MeetParticipant, M as MeetingRecord, R as RoomName, d as CallInvite, a6 as ParticipantStanding, a3 as ObserversVisibleTo, S as StageLayout, L as LobbyEntry, aa as RecordingState, U as UserId, aE as RecordingSource, ae as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, j as CollabSnapshot, p as ConnectionQuality, h as MeetingId, b as MeetApi, f as CallMode, O as OrganizationId, m as CallId, n as CallState, Z as MeetingKind, a8 as RecordingPolicy, V as MeetingAttendee, a9 as RecordingRecord, a0 as MeetingSettings, X as MeetingChanges, a4 as OccurrenceOverride, $ as MeetingOccurrence, af as UpcomingOccurrence, Y as MeetingInvitee, I as InviteeInput, q as InviteeRole, ab as RsvpAnswer, ac as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-Bf5evcLO.cjs';
-export { A as AccessTokenSource, l as CAPTION_LANGUAGES, o as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, r as JsonValue, s as MeetApiOptions, t as MeetApiRequest, u as MeetAppFocus, v as MeetBreakoutBroadcast, w as MeetBreakoutPlan, x as MeetBreakoutRoom, y as MeetCollabSettings, z as MeetFileMedia, B as MeetPoll, D as MeetPollOption, G as MeetPollState, H as MeetQuestion, K as MeetQuestionState, N as MeetStroke, Q as MeetingActivities, i as MeetingAppPanel, _ as MeetingNoteKind, a2 as ORGANIZATION_HEADER, a5 as OccurrenceState, a7 as ROLE_RANK, ad as RsvpState, T as TranscriptSource, ag as appPanelOf, ah as applyCollabPacket, ai as asCallId, aj as asMeetingId, ak as asOrganizationId, al as asParticipantIdentity, am as asRoomName, an as asUserId, ao as assignedRoom, ap as autoAssign, aq as breakoutRemainingMs, ar as captureHeldOf, as as collabFromState, at as createMeetApi, au as defaultCaptionLanguage, av as fileDownloadPath, aw as focusFromRow, ax as isGuest, ay as isHostRole, az as isLinkFollower, aA as isObserverRole, aB as loadMeetingActivities, aC as scheduleSettingsPatch, aD as withItem } from './collab-Bf5evcLO.cjs';
+import { P as ParticipantIdentity, e as ParticipantRole, k as AdmissionState, a1 as NoteTakerState, a as MeetParticipant, M as MeetingRecord, R as RoomName, d as CallInvite, a6 as ParticipantStanding, a3 as ObserversVisibleTo, S as StageLayout, L as LobbyEntry, aa as RecordingState, U as UserId, aF as RecordingSource, ae as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, j as CollabSnapshot, p as ConnectionQuality, h as MeetingId, b as MeetApi, f as CallMode, O as OrganizationId, m as CallId, n as CallState, Z as MeetingKind, a8 as RecordingPolicy, V as MeetingAttendee, a9 as RecordingRecord, a0 as MeetingSettings, X as MeetingChanges, a4 as OccurrenceOverride, $ as MeetingOccurrence, af as UpcomingOccurrence, Y as MeetingInvitee, I as InviteeInput, q as InviteeRole, ab as RsvpAnswer, ac as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-BNJNgXFB.cjs';
+export { A as AccessTokenSource, l as CAPTION_LANGUAGES, o as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, r as JsonValue, s as MeetApiOptions, t as MeetApiRequest, u as MeetAppFocus, v as MeetBreakoutBroadcast, w as MeetBreakoutPlan, x as MeetBreakoutRoom, y as MeetCollabSettings, z as MeetFileMedia, B as MeetPoll, D as MeetPollOption, G as MeetPollState, H as MeetQuestion, K as MeetQuestionState, N as MeetStroke, Q as MeetingActivities, i as MeetingAppPanel, _ as MeetingNoteKind, a2 as ORGANIZATION_HEADER, a5 as OccurrenceState, a7 as ROLE_RANK, ad as RsvpState, T as TranscriptSource, ag as appPanelOf, ah as applyCollabPacket, ai as asCallId, aj as asMeetingId, ak as asOrganizationId, al as asParticipantIdentity, am as asRoomName, an as asUserId, ao as assignedRoom, ap as autoAssign, aq as breakoutClosingMs, ar as breakoutRemainingMs, as as captureHeldOf, at as collabFromState, au as createMeetApi, av as defaultCaptionLanguage, aw as fileDownloadPath, ax as focusFromRow, ay as isGuest, az as isHostRole, aA as isLinkFollower, aB as isObserverRole, aC as loadMeetingActivities, aD as scheduleSettingsPatch, aE as withItem } from './collab-BNJNgXFB.cjs';
 import { RealtimeManager } from '@ai-matrx/realtime';
 import { MessagingSupabaseClient, ActionHandler } from '@ai-matrx/messaging';
 import { RoomOptions, ConnectionQuality as ConnectionQuality$1, Participant } from 'livekit-client';
@@ -158,6 +158,29 @@ declare function leaveChoices(args: {
     readonly othersPresent: boolean;
 }): readonly LeaveChoice[];
 
+/**
+ * THE RULES A SCREEN REDRAWS FROM WHILE THE CALL IS RUNNING (P1: chat-restrictions,
+ * mod-attendee-av-disabled, time-limit-warning, rec-consent-gate).
+ *
+ * The host can change a meeting's rules mid-call through the meeting's own rules door, which
+ * never talks to the room. The server's state read answers the live values (`live_policy`), and
+ * the room reads it on a short timer while the person is in the call — so a rule changed at
+ * second 40 is on every screen within one poll. Pure functions here; the timer lives in
+ * `meetings.ts`.
+ */
+
+type ChatMode = "everyone" | "hosts_only" | "off";
+type AvLock = "off" | "mic" | "camera" | "both";
+type RecordingConsent = "notice" | "ok_or_leave" | "view_only_until_agree";
+interface LivePolicy {
+    readonly chatMode: ChatMode;
+    readonly avLock: AvLock;
+    /** 0 = no limit. */
+    readonly timeLimitMinutes: number;
+    readonly timeLimitWarningMinutes: number;
+    readonly recordingConsent: RecordingConsent;
+}
+
 /**
  * LISTEN-ONLY ATTENDANCE — being IN the room is never contingent on a device.
  *
@@ -593,7 +616,7 @@ interface RoomChatMessage {
  * packet, addressed to this participant. Rendered once, dismissible, in words.
  */
 interface ModerationNotice {
-    readonly kind: "muted" | "ask-unmute" | "removed" | "role";
+    readonly kind: "muted" | "ask-unmute" | "removed" | "role" | "locked" | "capability";
     readonly text: string;
     readonly at: number;
 }
@@ -760,6 +783,16 @@ interface MeetSnapshot {
     readonly waitingCount: number;
     /** S8: what the host's Leave offers in this meeting (from the token's `leave_policy`). */
     readonly leavePolicy: LeavePolicy;
+    /** The meeting's rules as they are RIGHT NOW (chat mode, attendee lock, time limit), read live while in the call. */
+    readonly livePolicy: LivePolicy;
+    /** host-reclaim: this person is the meeting's owner and may take the host powers back (Zoom rules). */
+    readonly canReclaim: boolean;
+    /** rec-consent-gate: this person agreed to the recording that is running. */
+    readonly recordingConsentGiven: boolean;
+    /** When this run started (epoch ms), so every screen counts a time limit down together. */
+    readonly sessionStartedAt: number | null;
+    /** True from the moment a host muted THIS microphone until the person turns it on themselves. */
+    readonly mutedByHost: boolean;
     /** The last thing a host did to THIS participant, in words. Dismissible. */
     readonly moderationNotice: ModerationNotice | null;
     /**
@@ -821,6 +854,10 @@ interface MeetSnapshot {
      * last device change and an offered new device. Written only by `media-supervisor.ts`.
      */
     readonly mediaRegion: MediaRegionState;
+    /** `captions-toggle`: THIS viewer wants captions. Local to the viewer; never sent to the room. */
+    readonly captionsOn: boolean;
+    /** Why asking for captions failed, in the server's words (`captions-unavailable`). */
+    readonly captionsRefusal: NoteTakerRefusal | null;
     /** The last failure, with its remedy. Never null-and-hoping. */
     readonly failure: {
         readonly message: string;
@@ -976,6 +1013,14 @@ interface MeetAi {
         meetingId: MeetingId;
         roomName: RoomName;
     }): Promise<NoteTakerDispatch>;
+    /**
+     * Make sure the note-taker (the speech-to-text) is in the room because THIS viewer turned
+     * captions on. Open to everyone in the meeting, guests included. Never throws: a refusal
+     * is stored as `captionsRefusal` in the server's own words.
+     */
+    requestCaptions(args: {
+        meetingId: MeetingId;
+    }): Promise<void>;
     /** Dismiss it. Nothing automatic brings a dismissed note-taker back (D9). */
     stopNoteTaker(args: {
         meetingId: MeetingId;
@@ -2876,6 +2921,8 @@ interface RoomToken {
     readonly connectionPolicy?: ConnectionPolicy | undefined;
     /** S8: what the host's Leave offers for this meeting (`host_leave_prompt`, `end_confirm`). */
     readonly leavePolicy?: LeavePolicy | undefined;
+    /** host-reclaim (`host_reclaim = prompt`): the returning owner may take the host powers back. */
+    readonly canReclaim?: boolean | undefined;
 }
 
 interface TokenClientOptions {
@@ -2976,6 +3023,8 @@ declare const MEET_ROUTES: {
     readonly noteTakerStop: "/api/v1/meet/agent/stop";
     /** In-meeting Q&A. Streams NDJSON; body is `{meeting_id, question}` only. */
     readonly intelligenceAsk: "/api/v1/meet/intelligence/ask";
+    /** Anyone in the meeting (guests with the room pass included) asks for captions for themselves. */
+    readonly noteTakerCaptions: "/api/v1/meet/agent/captions";
     /** A host ends the meeting for everyone. Served by MRI-A6. */
     readonly meetingEnd: "/api/v1/meet/end";
     /**
@@ -3589,12 +3638,13 @@ declare function createWebEffectsStorage(key?: string): EffectsStorage;
  */
 
 /** Every host power the server performs. One vocabulary with `services/meet/moderation.py`. */
-type ModerationAction = "mute" | "stop_video" | "stop_screen" | "mute_all" | "ask_unmute" | "ask_all_unmute" | "spotlight" | "sync_presenter" | "raise_hand" | "lower_hand" | "lower_all_hands" | "make_cohost" | "revoke_cohost" | "transfer_host" | "rename" | "remove" | "report";
+type ModerationAction = "mute" | "stop_video" | "stop_screen" | "mute_all" | "ask_unmute" | "ask_all_unmute" | "spotlight" | "sync_presenter" | "raise_hand" | "lower_hand" | "lower_all_hands" | "make_cohost" | "make_presenter" | "revoke_presenter" | "set_av_lock" | "revoke_cohost" | "transfer_host" | "reclaim_host" | "rename" | "remove" | "report";
 declare const MODERATION_ACTIONS: readonly ModerationAction[];
 interface ModerationRequest {
     readonly action: ModerationAction;
     readonly identity?: ParticipantIdentity | null | undefined;
     readonly name?: string | undefined;
+    readonly value?: string | undefined;
     readonly reason?: string | undefined;
 }
 interface ModerationResult {
@@ -3869,7 +3919,7 @@ declare function takeMoveRequest(store: CollabStoreLike): {
  * a link follower whose role is `participant` renders `guest` (CORE-DESIGN §2.1); `presenter` /
  * `viewer` render `participant` until the contract adopts them (§3.7 C3).
  */
-type ObservedRole = "host" | "cohost" | "participant" | "guest";
+type ObservedRole = "host" | "cohost" | "presenter" | "participant" | "guest";
 /** `data-meet-phase` — the core's phase IS the contract value (S6a: no translation layer). */
 type ObservedPhase = MeetPhase;
 type ObservedConnection = ConnectionRegion;
@@ -3898,7 +3948,7 @@ interface ObserveInput {
  * 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;
+declare function observedDevice(track: LocalTrackState, permission?: PermissionReading, held?: "locked" | "muted_by_host" | null): 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

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { P as ParticipantIdentity, e as ParticipantRole, k as AdmissionState, a1 as NoteTakerState, a as MeetParticipant, M as MeetingRecord, R as RoomName, d as CallInvite, a6 as ParticipantStanding, a3 as ObserversVisibleTo, S as StageLayout, L as LobbyEntry, aa as RecordingState, U as UserId, aE as RecordingSource, ae as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, j as CollabSnapshot, p as ConnectionQuality, h as MeetingId, b as MeetApi, f as CallMode, O as OrganizationId, m as CallId, n as CallState, Z as MeetingKind, a8 as RecordingPolicy, V as MeetingAttendee, a9 as RecordingRecord, a0 as MeetingSettings, X as MeetingChanges, a4 as OccurrenceOverride, $ as MeetingOccurrence, af as UpcomingOccurrence, Y as MeetingInvitee, I as InviteeInput, q as InviteeRole, ab as RsvpAnswer, ac as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-Bf5evcLO.js';
-export { A as AccessTokenSource, l as CAPTION_LANGUAGES, o as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, r as JsonValue, s as MeetApiOptions, t as MeetApiRequest, u as MeetAppFocus, v as MeetBreakoutBroadcast, w as MeetBreakoutPlan, x as MeetBreakoutRoom, y as MeetCollabSettings, z as MeetFileMedia, B as MeetPoll, D as MeetPollOption, G as MeetPollState, H as MeetQuestion, K as MeetQuestionState, N as MeetStroke, Q as MeetingActivities, i as MeetingAppPanel, _ as MeetingNoteKind, a2 as ORGANIZATION_HEADER, a5 as OccurrenceState, a7 as ROLE_RANK, ad as RsvpState, T as TranscriptSource, ag as appPanelOf, ah as applyCollabPacket, ai as asCallId, aj as asMeetingId, ak as asOrganizationId, al as asParticipantIdentity, am as asRoomName, an as asUserId, ao as assignedRoom, ap as autoAssign, aq as breakoutRemainingMs, ar as captureHeldOf, as as collabFromState, at as createMeetApi, au as defaultCaptionLanguage, av as fileDownloadPath, aw as focusFromRow, ax as isGuest, ay as isHostRole, az as isLinkFollower, aA as isObserverRole, aB as loadMeetingActivities, aC as scheduleSettingsPatch, aD as withItem } from './collab-Bf5evcLO.js';
+import { P as ParticipantIdentity, e as ParticipantRole, k as AdmissionState, a1 as NoteTakerState, a as MeetParticipant, M as MeetingRecord, R as RoomName, d as CallInvite, a6 as ParticipantStanding, a3 as ObserversVisibleTo, S as StageLayout, L as LobbyEntry, aa as RecordingState, U as UserId, aF as RecordingSource, ae as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, j as CollabSnapshot, p as ConnectionQuality, h as MeetingId, b as MeetApi, f as CallMode, O as OrganizationId, m as CallId, n as CallState, Z as MeetingKind, a8 as RecordingPolicy, V as MeetingAttendee, a9 as RecordingRecord, a0 as MeetingSettings, X as MeetingChanges, a4 as OccurrenceOverride, $ as MeetingOccurrence, af as UpcomingOccurrence, Y as MeetingInvitee, I as InviteeInput, q as InviteeRole, ab as RsvpAnswer, ac as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-BNJNgXFB.js';
+export { A as AccessTokenSource, l as CAPTION_LANGUAGES, o as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, r as JsonValue, s as MeetApiOptions, t as MeetApiRequest, u as MeetAppFocus, v as MeetBreakoutBroadcast, w as MeetBreakoutPlan, x as MeetBreakoutRoom, y as MeetCollabSettings, z as MeetFileMedia, B as MeetPoll, D as MeetPollOption, G as MeetPollState, H as MeetQuestion, K as MeetQuestionState, N as MeetStroke, Q as MeetingActivities, i as MeetingAppPanel, _ as MeetingNoteKind, a2 as ORGANIZATION_HEADER, a5 as OccurrenceState, a7 as ROLE_RANK, ad as RsvpState, T as TranscriptSource, ag as appPanelOf, ah as applyCollabPacket, ai as asCallId, aj as asMeetingId, ak as asOrganizationId, al as asParticipantIdentity, am as asRoomName, an as asUserId, ao as assignedRoom, ap as autoAssign, aq as breakoutClosingMs, ar as breakoutRemainingMs, as as captureHeldOf, at as collabFromState, au as createMeetApi, av as defaultCaptionLanguage, aw as fileDownloadPath, ax as focusFromRow, ay as isGuest, az as isHostRole, aA as isLinkFollower, aB as isObserverRole, aC as loadMeetingActivities, aD as scheduleSettingsPatch, aE as withItem } from './collab-BNJNgXFB.js';
 import { RealtimeManager } from '@ai-matrx/realtime';
 import { MessagingSupabaseClient, ActionHandler } from '@ai-matrx/messaging';
 import { RoomOptions, ConnectionQuality as ConnectionQuality$1, Participant } from 'livekit-client';
@@ -158,6 +158,29 @@ declare function leaveChoices(args: {
     readonly othersPresent: boolean;
 }): readonly LeaveChoice[];
 
+/**
+ * THE RULES A SCREEN REDRAWS FROM WHILE THE CALL IS RUNNING (P1: chat-restrictions,
+ * mod-attendee-av-disabled, time-limit-warning, rec-consent-gate).
+ *
+ * The host can change a meeting's rules mid-call through the meeting's own rules door, which
+ * never talks to the room. The server's state read answers the live values (`live_policy`), and
+ * the room reads it on a short timer while the person is in the call — so a rule changed at
+ * second 40 is on every screen within one poll. Pure functions here; the timer lives in
+ * `meetings.ts`.
+ */
+
+type ChatMode = "everyone" | "hosts_only" | "off";
+type AvLock = "off" | "mic" | "camera" | "both";
+type RecordingConsent = "notice" | "ok_or_leave" | "view_only_until_agree";
+interface LivePolicy {
+    readonly chatMode: ChatMode;
+    readonly avLock: AvLock;
+    /** 0 = no limit. */
+    readonly timeLimitMinutes: number;
+    readonly timeLimitWarningMinutes: number;
+    readonly recordingConsent: RecordingConsent;
+}
+
 /**
  * LISTEN-ONLY ATTENDANCE — being IN the room is never contingent on a device.
  *
@@ -593,7 +616,7 @@ interface RoomChatMessage {
  * packet, addressed to this participant. Rendered once, dismissible, in words.
  */
 interface ModerationNotice {
-    readonly kind: "muted" | "ask-unmute" | "removed" | "role";
+    readonly kind: "muted" | "ask-unmute" | "removed" | "role" | "locked" | "capability";
     readonly text: string;
     readonly at: number;
 }
@@ -760,6 +783,16 @@ interface MeetSnapshot {
     readonly waitingCount: number;
     /** S8: what the host's Leave offers in this meeting (from the token's `leave_policy`). */
     readonly leavePolicy: LeavePolicy;
+    /** The meeting's rules as they are RIGHT NOW (chat mode, attendee lock, time limit), read live while in the call. */
+    readonly livePolicy: LivePolicy;
+    /** host-reclaim: this person is the meeting's owner and may take the host powers back (Zoom rules). */
+    readonly canReclaim: boolean;
+    /** rec-consent-gate: this person agreed to the recording that is running. */
+    readonly recordingConsentGiven: boolean;
+    /** When this run started (epoch ms), so every screen counts a time limit down together. */
+    readonly sessionStartedAt: number | null;
+    /** True from the moment a host muted THIS microphone until the person turns it on themselves. */
+    readonly mutedByHost: boolean;
     /** The last thing a host did to THIS participant, in words. Dismissible. */
     readonly moderationNotice: ModerationNotice | null;
     /**
@@ -821,6 +854,10 @@ interface MeetSnapshot {
      * last device change and an offered new device. Written only by `media-supervisor.ts`.
      */
     readonly mediaRegion: MediaRegionState;
+    /** `captions-toggle`: THIS viewer wants captions. Local to the viewer; never sent to the room. */
+    readonly captionsOn: boolean;
+    /** Why asking for captions failed, in the server's words (`captions-unavailable`). */
+    readonly captionsRefusal: NoteTakerRefusal | null;
     /** The last failure, with its remedy. Never null-and-hoping. */
     readonly failure: {
         readonly message: string;
@@ -976,6 +1013,14 @@ interface MeetAi {
         meetingId: MeetingId;
         roomName: RoomName;
     }): Promise<NoteTakerDispatch>;
+    /**
+     * Make sure the note-taker (the speech-to-text) is in the room because THIS viewer turned
+     * captions on. Open to everyone in the meeting, guests included. Never throws: a refusal
+     * is stored as `captionsRefusal` in the server's own words.
+     */
+    requestCaptions(args: {
+        meetingId: MeetingId;
+    }): Promise<void>;
     /** Dismiss it. Nothing automatic brings a dismissed note-taker back (D9). */
     stopNoteTaker(args: {
         meetingId: MeetingId;
@@ -2876,6 +2921,8 @@ interface RoomToken {
     readonly connectionPolicy?: ConnectionPolicy | undefined;
     /** S8: what the host's Leave offers for this meeting (`host_leave_prompt`, `end_confirm`). */
     readonly leavePolicy?: LeavePolicy | undefined;
+    /** host-reclaim (`host_reclaim = prompt`): the returning owner may take the host powers back. */
+    readonly canReclaim?: boolean | undefined;
 }
 
 interface TokenClientOptions {
@@ -2976,6 +3023,8 @@ declare const MEET_ROUTES: {
     readonly noteTakerStop: "/api/v1/meet/agent/stop";
     /** In-meeting Q&A. Streams NDJSON; body is `{meeting_id, question}` only. */
     readonly intelligenceAsk: "/api/v1/meet/intelligence/ask";
+    /** Anyone in the meeting (guests with the room pass included) asks for captions for themselves. */
+    readonly noteTakerCaptions: "/api/v1/meet/agent/captions";
     /** A host ends the meeting for everyone. Served by MRI-A6. */
     readonly meetingEnd: "/api/v1/meet/end";
     /**
@@ -3589,12 +3638,13 @@ declare function createWebEffectsStorage(key?: string): EffectsStorage;
  */
 
 /** Every host power the server performs. One vocabulary with `services/meet/moderation.py`. */
-type ModerationAction = "mute" | "stop_video" | "stop_screen" | "mute_all" | "ask_unmute" | "ask_all_unmute" | "spotlight" | "sync_presenter" | "raise_hand" | "lower_hand" | "lower_all_hands" | "make_cohost" | "revoke_cohost" | "transfer_host" | "rename" | "remove" | "report";
+type ModerationAction = "mute" | "stop_video" | "stop_screen" | "mute_all" | "ask_unmute" | "ask_all_unmute" | "spotlight" | "sync_presenter" | "raise_hand" | "lower_hand" | "lower_all_hands" | "make_cohost" | "make_presenter" | "revoke_presenter" | "set_av_lock" | "revoke_cohost" | "transfer_host" | "reclaim_host" | "rename" | "remove" | "report";
 declare const MODERATION_ACTIONS: readonly ModerationAction[];
 interface ModerationRequest {
     readonly action: ModerationAction;
     readonly identity?: ParticipantIdentity | null | undefined;
     readonly name?: string | undefined;
+    readonly value?: string | undefined;
     readonly reason?: string | undefined;
 }
 interface ModerationResult {
@@ -3869,7 +3919,7 @@ declare function takeMoveRequest(store: CollabStoreLike): {
  * a link follower whose role is `participant` renders `guest` (CORE-DESIGN §2.1); `presenter` /
  * `viewer` render `participant` until the contract adopts them (§3.7 C3).
  */
-type ObservedRole = "host" | "cohost" | "participant" | "guest";
+type ObservedRole = "host" | "cohost" | "presenter" | "participant" | "guest";
 /** `data-meet-phase` — the core's phase IS the contract value (S6a: no translation layer). */
 type ObservedPhase = MeetPhase;
 type ObservedConnection = ConnectionRegion;
@@ -3898,7 +3948,7 @@ interface ObserveInput {
  * 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;
+declare function observedDevice(track: LocalTrackState, permission?: PermissionReading, held?: "locked" | "muted_by_host" | null): 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

package/dist/core.js

@@ -632,6 +632,8 @@ var MEET_ROUTES = {
   noteTakerStop: "/api/v1/meet/agent/stop",
   /** In-meeting Q&A. Streams NDJSON; body is `{meeting_id, question}` only. */
   intelligenceAsk: "/api/v1/meet/intelligence/ask",
+  /** Anyone in the meeting (guests with the room pass included) asks for captions for themselves. */
+  noteTakerCaptions: "/api/v1/meet/agent/captions",
   /** A host ends the meeting for everyone. Served by MRI-A6. */
   meetingEnd: "/api/v1/meet/end",
   /**
@@ -778,7 +780,8 @@ function parseRoomToken(body, roomName) {
     breakoutRoomId: readString(payload, "breakout_room_id") ?? null,
     observersVisibleTo: readString(payload, "observers_visible_to") === "hosts" ? "hosts" : "everyone",
     connectionPolicy: connectionPolicyFrom(payload["connection_policy"]),
-    leavePolicy: leavePolicyFrom(payload["leave_policy"])
+    leavePolicy: leavePolicyFrom(payload["leave_policy"]),
+    canReclaim: payload["can_reclaim"] === true
   };
 }
 function createTokenClient(options) {
@@ -1240,6 +1243,42 @@ function createMeetAi(options) {
       },
       "meet.ai.startNoteTaker"
     ),
+    requestCaptions: async ({ meetingId }) => {
+      const roomToken = options.resolveRoomToken?.() ?? null;
+      const operation = "meet.ai.requestCaptions";
+      try {
+        const response = await send({
+          path: MEET_ROUTES.noteTakerCaptions,
+          body: { meeting_id: meetingId },
+          operation,
+          requireAuth: roomToken === null,
+          ...roomToken !== null ? { headers: { [MEETING_PASS_HEADER]: roomToken } } : {}
+        });
+        if (!response.ok) {
+          options.store.patch({ captionsRefusal: await refusalFor(response, operation) });
+          return;
+        }
+        let payload = null;
+        try {
+          payload = await response.json();
+        } catch {
+          payload = null;
+        }
+        const row = typeof payload === "object" && payload !== null ? payload : {};
+        const detail = typeof row["detail"] === "string" ? row["detail"] : "";
+        options.store.patch({
+          captionsRefusal: row["dispatched"] === true ? null : { status: 200, reason: detail, remedy: "" }
+        });
+      } catch (error) {
+        options.store.patch({
+          captionsRefusal: {
+            status: 0,
+            reason: error.message,
+            remedy: error.remedy ?? ""
+          }
+        });
+      }
+    },
     stopNoteTaker: ({ meetingId }) => dispatch(
       MEET_ROUTES.noteTakerStop,
       { meeting_id: meetingId },
@@ -1278,7 +1317,7 @@ function exactNoteTakerParticipant(meeting, participants) {
 }
 function noteTakerStatus(args) {
   const present = exactNoteTakerParticipant(args.meeting, args.participants) !== null;
-  const raw = args.meeting?.metadata[NOTE_TAKER_METADATA_KEY];
+  const raw = args.meeting?.metadata?.[NOTE_TAKER_METADATA_KEY];
   const row = typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
   const recorded = readState(row["state"]);
   const detail = typeof row["reason"] === "string" && row["reason"].length > 0 ? row["reason"] : null;
@@ -3011,6 +3050,8 @@ function planFromRow(row) {
     minutes: num2(row["minutes"]) ?? 0,
     openedAt: str(row["opened_at"]),
     endsAt: str(row["ends_at"]),
+    closingAt: str(row["closing_at"]),
+    moveMode: row["move_mode"] === "auto" ? "auto" : "invite",
     closedAt: str(row["closed_at"]),
     broadcasts: (Array.isArray(row["broadcasts"]) ? row["broadcasts"] : []).map(broadcastFrom).filter((b) => b !== null)
   };
@@ -3162,9 +3203,17 @@ function autoAssign(identities, rooms, exclude = []) {
   return out;
 }
 function breakoutRemainingMs(plan, now) {
-  if (plan === null || plan.state !== "open" || plan.endsAt === null) return null;
-  const end = Date.parse(plan.endsAt);
-  return Number.isNaN(end) ? null : Math.max(0, end - now);
+  if (plan === null || plan.state !== "open") return null;
+  const ends = [plan.endsAt, plan.closingAt].map((stamp) => stamp === null ? Number.NaN : Date.parse(stamp)).filter((time) => !Number.isNaN(time));
+  if (ends.length === 0) return null;
+  return Math.max(0, Math.min(...ends) - now);
+}
+var BREAKOUT_COUNTDOWN_MS = 3e4;
+function breakoutClosingMs(plan, now) {
+  if (plan === null || plan.state !== "open") return null;
+  const remaining = breakoutRemainingMs(plan, now);
+  if (remaining === null) return null;
+  return plan.closingAt !== null || remaining <= BREAKOUT_COUNTDOWN_MS ? remaining : null;
 }
 function defaultCaptionLanguage(settings, viewerLanguage) {
   const configured = settings?.captionTranslationLanguage.trim() ?? "";
@@ -3411,6 +3460,47 @@ function recordingLabel(state) {
   }
 }
 
+// src/core/live-policy.ts
+var DEFAULT_LIVE_POLICY = {
+  chatMode: "everyone",
+  avLock: "off",
+  timeLimitMinutes: 0,
+  timeLimitWarningMinutes: 5,
+  recordingConsent: "notice"
+};
+function oneOf(value, allowed, fallback) {
+  return typeof value === "string" && allowed.includes(value) ? value : fallback;
+}
+function whole(value, fallback) {
+  const n = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : fallback;
+}
+function livePolicyFrom(raw) {
+  const o = typeof raw === "object" && raw !== null ? raw : {};
+  return {
+    chatMode: oneOf(o["chat_mode"], ["everyone", "hosts_only", "off"], DEFAULT_LIVE_POLICY.chatMode),
+    avLock: oneOf(o["attendee_av_lock"], ["off", "mic", "camera", "both"], DEFAULT_LIVE_POLICY.avLock),
+    timeLimitMinutes: whole(o["time_limit_minutes"], 0),
+    timeLimitWarningMinutes: whole(o["time_limit_warning_minutes"], DEFAULT_LIVE_POLICY.timeLimitWarningMinutes),
+    recordingConsent: oneOf(
+      o["recording_consent"],
+      ["notice", "ok_or_leave", "view_only_until_agree"],
+      DEFAULT_LIVE_POLICY.recordingConsent
+    )
+  };
+}
+function samePolicy(a, b) {
+  return a.chatMode === b.chatMode && a.avLock === b.avLock && a.timeLimitMinutes === b.timeLimitMinutes && a.timeLimitWarningMinutes === b.timeLimitWarningMinutes && a.recordingConsent === b.recordingConsent;
+}
+var MODERATORS = /* @__PURE__ */ new Set(["host", "cohost"]);
+function isLockedFor(policy, role, kind) {
+  if (MODERATORS.has(role)) return false;
+  return policy.avLock === "both" || (kind === "microphone" ? policy.avLock === "mic" : policy.avLock === "camera");
+}
+function consentPending(policy, role, recordingOn, given) {
+  return recordingOn && !given && policy.recordingConsent !== "notice" && !MODERATORS.has(role);
+}
+
 // src/core/attendance.ts
 var IDLE_MEDIA_REGION = {
   permission: { microphone: "unknown", camera: "unknown" },
@@ -3481,6 +3571,11 @@ var EMPTY = {
   presenter: null,
   waitingCount: 0,
   leavePolicy: DEFAULT_LEAVE_POLICY,
+  livePolicy: DEFAULT_LIVE_POLICY,
+  canReclaim: false,
+  recordingConsentGiven: false,
+  sessionStartedAt: null,
+  mutedByHost: false,
   moderationNotice: null,
   actionNotice: null,
   privateChatRequest: null,
@@ -3490,6 +3585,8 @@ var EMPTY = {
   names: {},
   wrapUp: null,
   noteTakerRefusal: null,
+  captionsOn: false,
+  captionsRefusal: null,
   media: IDLE_MEDIA,
   mediaRegion: IDLE_MEDIA_REGION,
   failure: null,
@@ -3694,7 +3791,12 @@ function createMeetStore(initial = {}) {
       if (current.enabled === next.enabled && current.unavailable?.code === next.unavailable?.code && current.unavailable?.reason === next.unavailable?.reason && current.unavailable?.message === next.unavailable?.message) {
         return;
       }
-      commit({ ...state, media: { ...state.media, [kind]: next } });
+      commit({
+        ...state,
+        media: { ...state.media, [kind]: next },
+        // The person turned their own microphone on again: the host's mute is over.
+        ...kind === "microphone" && next.enabled && state.mutedByHost ? { mutedByHost: false } : {}
+      });
     },
     reset() {
       const phase = nextPhase(state.phase, { type: "reset", teardown: true }) ?? EMPTY.phase;
@@ -3920,10 +4022,11 @@ function moderationText(kind, payload) {
   switch (kind) {
     case "muted": {
       const source = text2(payload["source"]) ?? "microphone";
-      return source === "microphone" ? `${by} muted you.` : source === "camera" ? `${by} turned off your camera.` : `${by} stopped your screen share.`;
+      const who = payload["by_role"] === "host" || payload["by_role"] === "cohost" ? "the host" : by;
+      return source === "microphone" ? `You've been muted by ${who}.` : source === "camera" ? `Your camera was turned off by ${who}.` : `Your screen share was stopped by ${who}.`;
     }
     case "ask-unmute":
-      return `${by} is asking you to unmute.`;
+      return `${by === "The host" ? "The host" : by} asked you to unmute.`;
     case "removed":
       return `${by} removed you from this meeting.`;
     default:
@@ -3949,7 +4052,7 @@ function applyModeration(store, payload, now) {
           grants: { ...snapshot.grants, role },
           moderationNotice: {
             kind: "role",
-            text: role === "host" ? "You are now the host." : role === "cohost" ? "You are now a co-host." : "You are no longer a co-host.",
+            text: role === "host" ? "You are now the host." : role === "cohost" ? "You're now a co-host." : role === "presenter" ? "You're now a presenter." : snapshot.grants.role === "presenter" ? "You're now a participant: you can no longer present." : "You're now a participant: you are no longer a co-host.",
             at: now()
           }
         });
@@ -3961,7 +4064,10 @@ function applyModeration(store, payload, now) {
     case "removed": {
       const sentence = moderationText(kind, payload);
       if (sentence === null) return ignored("a moderation event with no sentence");
-      store.patch({ moderationNotice: { kind, text: sentence, at: now() } });
+      store.patch({
+        moderationNotice: { kind, text: sentence, at: now() },
+        ...kind === "muted" && (text2(payload["source"]) ?? "microphone") === "microphone" ? { mutedByHost: true } : {}
+      });
       return HANDLED;
     }
     default:
@@ -4783,6 +4889,7 @@ function applyDoorRow(store, attendee) {
 function decidedState(state) {
   return WAITING_ADMISSION_STATES.includes(state) ? "expired" : state;
 }
+var LIVE_POLICY_POLL_MS = 3e3;
 function createMeetingSession(options) {
   const { manager, repository, store, identity } = options;
   let channel = null;
@@ -4924,6 +5031,46 @@ function createMeetingSession(options) {
       stopWaiting();
     }
   }
+  let policyTimer = null;
+  let policyReading = false;
+  async function readLivePolicy() {
+    const meeting = store.snapshot().meeting;
+    const pass = options.resolvePass?.() ?? null;
+    if (meeting === null || pass === null || policyReading) return;
+    policyReading = true;
+    try {
+      const response = await options.api.request({
+        path: `${MEET_ROUTES.state}?meeting_id=${encodeURIComponent(meeting.id)}`,
+        method: "GET",
+        requireAuth: false,
+        operation: "meet.state(policy)",
+        headers: { [MEETING_PASS_HEADER]: pass }
+      });
+      if (!response.ok) return;
+      const read = await response.json();
+      const next = livePolicyFrom(read.live_policy);
+      const started = read.session_started_at ? Date.parse(read.session_started_at) : NaN;
+      const snapshot = store.snapshot();
+      const startedAt = Number.isFinite(started) ? started : snapshot.sessionStartedAt;
+      if (!samePolicy(snapshot.livePolicy, next) || startedAt !== snapshot.sessionStartedAt) {
+        store.patch({ livePolicy: next, sessionStartedAt: startedAt });
+      }
+    } catch {
+    } finally {
+      policyReading = false;
+    }
+  }
+  function syncLivePolicyTimer() {
+    const inCall = store.snapshot().phase === "in_call";
+    if (inCall && policyTimer === null) {
+      void readLivePolicy();
+      policyTimer = setInterval(() => void readLivePolicy(), LIVE_POLICY_POLL_MS);
+    } else if (!inCall && policyTimer !== null) {
+      clearInterval(policyTimer);
+      policyTimer = null;
+    }
+  }
+  const unsubscribePolicy = store.subscribe(syncLivePolicyTimer);
   async function readState2() {
     if (reading !== null) return reading;
     const meeting = store.snapshot().meeting;
@@ -5310,6 +5457,9 @@ function createMeetingSession(options) {
     },
     dispose() {
       stopWaiting();
+      unsubscribePolicy();
+      if (policyTimer !== null) clearInterval(policyTimer);
+      policyTimer = null;
       channel?.close();
       channel = null;
       meetingChannel?.close();
@@ -6627,6 +6777,7 @@ function createRoomEngine(options) {
     lastServerUrl = token.serverUrl;
     connectionPolicy = token.connectionPolicy ?? DEFAULT_CONNECTION_POLICY;
     if (token.leavePolicy !== void 0) store.patch({ leavePolicy: token.leavePolicy });
+    store.patch({ canReclaim: token.canReclaim === true });
     store.patch({
       localIdentity: token.identity,
       breakoutRoomId: token.breakoutRoomId ?? null,
@@ -7126,8 +7277,12 @@ var MODERATION_ACTIONS = [
   "lower_hand",
   "lower_all_hands",
   "make_cohost",
+  "make_presenter",
+  "revoke_presenter",
+  "set_av_lock",
   "revoke_cohost",
   "transfer_host",
+  "reclaim_host",
   "rename",
   "remove",
   "report"
@@ -8057,11 +8212,13 @@ function takeMoveRequest(store) {
 
 // src/core/observation.ts
 function observedRole(role, standing) {
-  if (role === "host" || role === "cohost") return role;
+  if (role === "host" || role === "cohost" || role === "presenter") return role;
   return isLinkFollower(standing) ? "guest" : "participant";
 }
-function observedDevice(track, permission = "unknown") {
+function observedDevice(track, permission = "unknown", held = null) {
+  if (held === "locked") return "locked";
   if (track.enabled) return "on";
+  if (held === "muted_by_host") return "muted_by_host";
   const reason = deviceUnavailableReason(track, permission);
   return reason === null ? "muted_by_me" : `unavailable:${reason}`;
 }
@@ -8098,10 +8255,20 @@ function observe(input) {
     recording: snapshot?.recording === "recording" || snapshot?.recording === "stopping",
     // S6c: the autoplay region is known only inside the room (no remote audio exists elsewhere).
     audioBlocked: inCall && snapshot !== null ? snapshot.mediaRegion.audioOutput === "blocked" : null,
-    camera: deviceInPlay && snapshot !== null ? observedDevice(snapshot.media.camera, snapshot.mediaRegion.permission.camera) : null,
-    microphone: deviceInPlay && snapshot !== null ? observedDevice(snapshot.media.microphone, snapshot.mediaRegion.permission.microphone) : null
+    camera: deviceInPlay && snapshot !== null ? observedDevice(snapshot.media.camera, snapshot.mediaRegion.permission.camera, lockedFor(snapshot, "camera", inCall)) : null,
+    microphone: deviceInPlay && snapshot !== null ? observedDevice(snapshot.media.microphone, snapshot.mediaRegion.permission.microphone, lockedFor(snapshot, "microphone", inCall)) : null
   };
 }
+function lockedFor(snapshot, kind, inCall) {
+  if (!inCall) return null;
+  const role = effectiveRole(snapshot);
+  if (isLockedFor(snapshot.livePolicy, role, kind)) return "locked";
+  if (snapshot.livePolicy.recordingConsent === "view_only_until_agree" && consentPending(snapshot.livePolicy, role, snapshot.recording === "recording", snapshot.recordingConsentGiven)) {
+    return "locked";
+  }
+  if (kind === "microphone" && snapshot.mutedByHost) return "muted_by_host";
+  return null;
+}
 function staticObservation(phase, reason = null) {
   return {
     phase,
@@ -8250,6 +8417,7 @@ export {
   autoAssign,
   autoRejoinDelayMs,
   availableActivities,
+  breakoutClosingMs,
   breakoutRemainingMs,
   callInviteAction,
   callInviteText,