@ai-matrx/meet 0.11.41 → 0.11.43

package/dist/index.cjs

@@ -110,6 +110,7 @@ __export(src_exports, {
   autoAssign: () => autoAssign,
   autoRejoinDelayMs: () => autoRejoinDelayMs,
   availableActivities: () => availableActivities,
+  breakoutClosingMs: () => breakoutClosingMs,
   breakoutRemainingMs: () => breakoutRemainingMs,
   callInviteAction: () => callInviteAction,
   callInviteText: () => callInviteText,
@@ -911,6 +912,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",
   /**
@@ -1057,7 +1060,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) {
@@ -1519,6 +1523,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 },
@@ -1557,7 +1597,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;
@@ -3290,6 +3330,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)
   };
@@ -3441,9 +3483,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() ?? "";
@@ -3690,6 +3740,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" },
@@ -3760,6 +3851,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,
@@ -3769,6 +3865,8 @@ var EMPTY = {
   names: {},
   wrapUp: null,
   noteTakerRefusal: null,
+  captionsOn: false,
+  captionsRefusal: null,
   media: IDLE_MEDIA,
   mediaRegion: IDLE_MEDIA_REGION,
   failure: null,
@@ -3973,7 +4071,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;
@@ -4011,8 +4114,7 @@ var ROOM_EVENTS = {
   /**
    * A host or co-host acted (Meet wave 2). Payload `{ meeting_id, kind, … }`:
    * `muted {source, by}` · `ask-unmute {by}` · `removed {by}` — addressed to the
-   * person concerned; `lower-hands {identities: [...] | "*"}` · `role {identity,
-   * role}` — to everyone.
+   * person concerned; `role {identity, role}` — to everyone.
    */
   moderation: "matrx.meet.moderation",
   /**
@@ -4200,10 +4302,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:
@@ -4229,7 +4332,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()
           }
         });
@@ -4241,7 +4344,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:
@@ -5063,6 +5169,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;
@@ -5204,6 +5311,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;
@@ -5590,6 +5737,9 @@ function createMeetingSession(options) {
     },
     dispose() {
       stopWaiting();
+      unsubscribePolicy();
+      if (policyTimer !== null) clearInterval(policyTimer);
+      policyTimer = null;
       channel?.close();
       channel = null;
       meetingChannel?.close();
@@ -6907,6 +7057,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,
@@ -7401,13 +7552,17 @@ var MODERATION_ACTIONS = [
   "ask_unmute",
   "ask_all_unmute",
   "spotlight",
-  "present",
+  "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"
@@ -7433,18 +7588,17 @@ function createInRoomClient(options) {
   function refusal2(response, operation, remedy) {
     return refusalFromResponse(response, operation, remedy);
   }
-  let toldPresenting = false;
+  let toldSharing = false;
   let tellChain = Promise.resolve();
   store.subscribe(() => {
     const local = store.snapshot().participants.find((p) => p.isLocal);
     const sharing = local?.screenSharing === true;
-    if (sharing === toldPresenting || local === void 0) return;
-    toldPresenting = sharing;
-    const on = sharing;
-    tellChain = tellChain.then(() => client.moderate({ action: "present", on })).then(
+    if (sharing === toldSharing || local === void 0) return;
+    toldSharing = sharing;
+    tellChain = tellChain.then(() => client.moderate({ action: "sync_presenter" })).then(
       () => void 0,
       (error) => {
-        console.warn(`[meet] the server did not take presenter=${String(on)}: ${String(error)}`);
+        console.warn(`[meet] the server did not take the screen-share change: ${String(error)}`);
       }
     );
   });
@@ -7461,8 +7615,7 @@ function createInRoomClient(options) {
           action: request.action,
           ...request.identity != null ? { identity: request.identity } : {},
           ...request.name !== void 0 ? { name: request.name } : {},
-          ...request.reason !== void 0 ? { reason: request.reason } : {},
-          ...request.on !== void 0 ? { on: request.on } : {}
+          ...request.reason !== void 0 ? { reason: request.reason } : {}
         },
         ...hdrs !== void 0 ? { headers: hdrs } : {}
       });
@@ -8339,11 +8492,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}`;
 }
@@ -8380,10 +8535,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,