@ai-matrx/meet 0.11.35 → 0.11.37

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog — `@ai-matrx/meet`
 
+## 0.11.37
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/meet/v0.11.36..npm/meet/v0.11.37 -- apps/shared/meet`).
+No source changes intended and no consumer action required.
+
+## 0.11.36
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/meet/v0.11.35..npm/meet/v0.11.36 -- apps/shared/meet`).
+No source changes intended and no consumer action required.
+
 ## 0.11.35
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/core.cjs

@@ -38,6 +38,7 @@ __export(core_exports, {
   DATA_TOPICS: () => DATA_TOPICS,
   DEFAULT_CONNECTION_POLICY: () => DEFAULT_CONNECTION_POLICY,
   DEFAULT_EFFECTS: () => DEFAULT_EFFECTS,
+  DEFAULT_LEAVE_POLICY: () => DEFAULT_LEAVE_POLICY,
   DEFAULT_PAGE_SIZE: () => DEFAULT_PAGE_SIZE,
   EMPTY_COLLAB: () => EMPTY_COLLAB,
   END_MEETING_NOT_SERVED: () => END_MEETING_NOT_SERVED,
@@ -72,6 +73,7 @@ __export(core_exports, {
   NO_SHARE: () => NO_SHARE,
   ORGANIZATION_HEADER: () => ORGANIZATION_HEADER,
   PARTICIPANT_CAN_RECORD_ATTRIBUTE: () => PARTICIPANT_CAN_RECORD_ATTRIBUTE,
+  PARTICIPANT_HAND_ATTRIBUTE: () => PARTICIPANT_HAND_ATTRIBUTE,
   PARTICIPANT_ROLE_ATTRIBUTE: () => PARTICIPANT_ROLE_ATTRIBUTE,
   PARTICIPANT_STANDING_ATTRIBUTE: () => PARTICIPANT_STANDING_ATTRIBUTE,
   REACTION_TTL_MS: () => REACTION_TTL_MS,
@@ -184,6 +186,8 @@ __export(core_exports, {
   isWaitingPhase: () => isWaitingPhase,
   learnName: () => learnName,
   learnNames: () => learnNames,
+  leaveChoices: () => leaveChoices,
+  leavePolicyFrom: () => leavePolicyFrom,
   listenOnlyNotice: () => listenOnlyNotice,
   loadFollowUpDraft: () => loadFollowUpDraft,
   loadGuestMeetingRecord: () => loadGuestMeetingRecord,
@@ -831,6 +835,30 @@ function mergeGhosts(live, ghosts, at) {
   return { roster: [...live, ...extra], kept };
 }
 
+// src/core/leave.ts
+var DEFAULT_LEAVE_POLICY = { hostLeavePrompt: "leave_or_end", endConfirm: false };
+var PROMPTS = ["leave_or_end", "must_assign_or_end", "leave_only"];
+function leavePolicyFrom(raw) {
+  if (typeof raw !== "object" || raw === null) return DEFAULT_LEAVE_POLICY;
+  const value = raw;
+  const prompt = value["host_leave_prompt"];
+  const confirm = value["end_confirm"];
+  return {
+    hostLeavePrompt: PROMPTS.includes(prompt) ? prompt : DEFAULT_LEAVE_POLICY.hostLeavePrompt,
+    endConfirm: typeof confirm === "boolean" ? confirm : DEFAULT_LEAVE_POLICY.endConfirm
+  };
+}
+function leaveChoices(args) {
+  if (args.role !== "host") return ["leave"];
+  switch (args.policy.hostLeavePrompt) {
+    case "must_assign_or_end":
+      return args.othersPresent ? ["assign_and_leave", "end_for_all"] : ["leave", "end_for_all"];
+    case "leave_only":
+    case "leave_or_end":
+      return ["leave", "end_for_all"];
+  }
+}
+
 // src/core/tokens.ts
 function createWebRoomTokenStorage(onDiagnostic) {
   const store = globalThis.localStorage;
@@ -1022,7 +1050,8 @@ function parseRoomToken(body, roomName) {
     pollSeconds: typeof payload["poll_seconds"] === "number" ? payload["poll_seconds"] : void 0,
     breakoutRoomId: readString(payload, "breakout_room_id") ?? null,
     observersVisibleTo: readString(payload, "observers_visible_to") === "hosts" ? "hosts" : "everyone",
-    connectionPolicy: connectionPolicyFrom(payload["connection_policy"])
+    connectionPolicy: connectionPolicyFrom(payload["connection_policy"]),
+    leavePolicy: leavePolicyFrom(payload["leave_policy"])
   };
 }
 function createTokenClient(options) {
@@ -3721,6 +3750,10 @@ var EMPTY = {
   chatHistoryError: null,
   reactions: [],
   spotlight: null,
+  actingHost: null,
+  presenter: null,
+  waitingCount: 0,
+  leavePolicy: DEFAULT_LEAVE_POLICY,
   moderationNotice: null,
   actionNotice: null,
   privateChatRequest: null,
@@ -3782,8 +3815,6 @@ function createMeetStore(initial = {}) {
     },
     setParticipants(participants) {
       const names = learnNames(state.names, participants);
-      const hands = new Map(state.participants.map((p) => [p.identity, p.handRaised]));
-      const handTimes = new Map(state.participants.map((p) => [p.identity, p.handRaisedAt ?? null]));
       const quality = new Map(state.participants.map((p) => [p.identity, p.quality]));
       commit({
         ...state,
@@ -3796,8 +3827,6 @@ function createMeetStore(initial = {}) {
           // identity could reach a screen, and it is the place that asks the
           // name book. `roster-names.test.ts` fails if a token ever gets past it.
           displayName: displayNameFor(names, participant.identity, participant.displayName),
-          handRaised: hands.get(participant.identity) ?? participant.handRaised,
-          handRaisedAt: handTimes.get(participant.identity) ?? participant.handRaisedAt ?? null,
           quality: participant.quality === "unknown" ? quality.get(participant.identity) ?? "unknown" : participant.quality
         }))
       });
@@ -3820,20 +3849,6 @@ function createMeetStore(initial = {}) {
         )
       });
     },
-    setHand(identity, raised, at) {
-      commit({
-        ...state,
-        participants: state.participants.map(
-          (participant) => participant.identity === identity ? {
-            ...participant,
-            handRaised: raised,
-            // A hand that is ALREADY up keeps its place in the queue when
-            // it is re-announced (to a late joiner): the first time wins.
-            handRaisedAt: raised ? participant.handRaised && participant.handRaisedAt != null ? participant.handRaisedAt : at ?? Date.now() : null
-          } : participant
-        )
-      });
-    },
     addChat(message) {
       if (state.chat.some((existing) => existing.id === message.id)) return;
       const chat = [...state.chat, message];
@@ -3982,18 +3997,6 @@ var ROOM_EVENTS = {
   wrapUp: "matrx.meet.wrap_up",
   /** The meeting ended for everyone. Payload `{ meeting_id, ended_at, trigger }`. */
   ended: "matrx.meet.ended",
-  /**
-   * A `meet_recordings` row changed state. Payload
-   * `{ meeting_id, recording: { id, state, started_by } }`.
-   *
-   * 🚨 THIS IS THE ONLY WAY A GUEST LEARNS A RECORDING IS RUNNING. PreJoin
-   * promises every joiner an indicator, and `anon` holds no SELECT grant on
-   * `meet_recordings` (MRI-A10 settled that widening it is forbidden), so
-   * without this packet the promise was a sentence with nothing behind it: on
-   * production 2026-09-09 the guest lane showed no indicator at all while the
-   * host recorded (MRI-C8).
-   */
-  recording: "matrx.meet.recording",
   /**
    * A chat message to everyone was SAVED (Meet wave 2). Payload
    * `{ message: { id, meeting_id, sender_identity, sender_name, body, created_at } }`.
@@ -4046,8 +4049,6 @@ function applyRoomEvent(args) {
       return applyWrapUp(store, payload, now);
     case ROOM_EVENTS.ended:
       return applyEnded(store, payload);
-    case ROOM_EVENTS.recording:
-      return applyRecording(store, payload);
     case ROOM_EVENTS.chat:
       return applyChat(store, payload);
     case ROOM_EVENTS.moderation:
@@ -4127,9 +4128,9 @@ function applyWrapUp(store, payload, now) {
   store.announceWrapUp(announcement);
   return HANDLED;
 }
-function applyRecording(store, payload) {
+function applyRecordingState(store, payload) {
   const row = object(payload["recording"]);
-  if (row === null) return ignored("a recording event with no `recording` row");
+  if (row === null) return ignored("room state carries no recording");
   const meetingId = text2(payload["meeting_id"]);
   const meeting = store.snapshot().meeting;
   if (meeting !== null && meetingId !== null && meetingId !== meeting.id) {
@@ -4211,19 +4212,6 @@ function applyModeration(store, payload, now) {
   }
   const kind = text2(payload["kind"]);
   switch (kind) {
-    case "lower-hands": {
-      const raw = payload["identities"];
-      const everyone = raw === "*";
-      const named = new Set(
-        Array.isArray(raw) ? raw.filter((value) => typeof value === "string") : []
-      );
-      for (const participant of snapshot.participants) {
-        if (participant.handRaised && (everyone || named.has(participant.identity))) {
-          store.setHand(participant.identity, false);
-        }
-      }
-      return HANDLED;
-    }
     case "role": {
       const identity = text2(payload["identity"]);
       const role = text2(payload["role"]);
@@ -4615,7 +4603,6 @@ function gridColumns(count2) {
 
 // src/core/room-driver.ts
 var DATA_TOPICS = {
-  hand: "mx.hand",
   reaction: "mx.reaction",
   chat: "mx.chat"
 };
@@ -4757,6 +4744,7 @@ function createLiveKitDriver(handlers, options = {}) {
     projectRoster = roster;
     created.on(RoomEvent.TrackSubscribed, (track) => {
       if (track.kind !== Track.Kind.Audio || typeof document === "undefined") return;
+      if (!remoteAudioPlayback) return;
       const element = track.attach();
       element.setAttribute("data-mx-meet-audio", "");
       audioSink().appendChild(element);
@@ -4841,6 +4829,7 @@ function createLiveKitDriver(handlers, options = {}) {
   let sources = null;
   let trackEvents = null;
   let audioContainer = null;
+  let remoteAudioPlayback = true;
   function audioSink() {
     if (audioContainer !== null && audioContainer.isConnected) return audioContainer;
     const container = document.createElement("div");
@@ -4999,6 +4988,14 @@ function createLiveKitDriver(handlers, options = {}) {
         throw normalizeDeviceError(error, "meet.switchDevice");
       }
     },
+    setRemoteAudioPlayback(enabled) {
+      remoteAudioPlayback = enabled;
+      if (enabled || audioContainer === null) return;
+      for (const element of Array.from(audioContainer.querySelectorAll("[data-mx-meet-audio]"))) {
+        if (element instanceof HTMLMediaElement) element.srcObject = null;
+        element.remove();
+      }
+    },
     async startAudio() {
       const target = room;
       if (target === null) return;
@@ -5239,7 +5236,7 @@ function createMeetingSession(options) {
     })();
     return reading;
   }
-  async function postLeave(intent) {
+  async function postLeave(intent, extra = {}) {
     const meeting = requireMeeting(`meet.${intent}`);
     const pass = options.resolvePass?.() ?? null;
     const response = await options.api.request({
@@ -5247,7 +5244,7 @@ function createMeetingSession(options) {
       method: "POST",
       requireAuth: false,
       operation: `meet.${intent}`,
-      body: { meeting_id: meeting.id, intent },
+      body: { meeting_id: meeting.id, intent, ...extra },
       ...pass !== null ? { headers: { [MEETING_PASS_HEADER]: pass } } : {}
     });
     if (!response.ok) {
@@ -5261,7 +5258,7 @@ function createMeetingSession(options) {
       throw new MeetError(
         "transport",
         refusal2?.reason ?? `meet.${intent}: the server answered ${response.status}`,
-        refusal2?.remedy ?? "You are still in the waiting room. Try again."
+        refusal2?.remedy ?? (intent === "withdraw" ? "You are still in the waiting room. Try again." : "Nothing was changed. Try again.")
       );
     }
   }
@@ -5485,6 +5482,10 @@ function createMeetingSession(options) {
       store.dispatch({ type: "admission", admission: "withdrawn" });
       hint();
     },
+    async hostLeave(intent) {
+      if (intent === "end_for_all") await postLeave("end_for_all");
+      else await postLeave("assign_and_leave", { assign_to: intent.assignTo });
+    },
     async askAgain() {
       await options.rejoin?.();
     },
@@ -6446,6 +6447,11 @@ function SCREEN_SHARE_BLOCKED_REMEDY_FOR(remedy) {
   return /administrator|policy/i.test(remedy) ? remedy : SCREEN_SHARE_BLOCKED_REMEDY;
 }
 var PARTICIPANT_ROLE_ATTRIBUTE = "matrx.participant.role";
+var PARTICIPANT_HAND_ATTRIBUTE = "matrx.hand";
+function handFrom(value) {
+  const at = value === void 0 || value.length === 0 ? Number.NaN : Number(value);
+  return Number.isFinite(at) ? { handRaised: true, handRaisedAt: at } : { handRaised: false, handRaisedAt: null };
+}
 var PARTICIPANT_CAN_RECORD_ATTRIBUTE = "matrx.participant.can_record";
 var CONNECTION_KIND_ATTRIBUTE = "matrx.participant.connection_kind";
 var PARTICIPANT_STANDING_ATTRIBUTE = "matrx.participant.standing";
@@ -6499,7 +6505,10 @@ function projectParticipant(driver, joinedAt) {
     cameraEnabled: driver.cameraEnabled,
     screenSharing: driver.screenSharing,
     speaking: false,
-    handRaised: false,
+    // S8: a hand is the SERVER's (`hand_raised_at` on the person row, `/moderate raise_hand`),
+    // replicated as the `matrx.hand` attribute: epoch ms of the raise, "" when down. It is
+    // therefore delivered to late joiners and survives refresh and reconnect.
+    ...handFrom(driver.attributes[PARTICIPANT_HAND_ATTRIBUTE]),
     quality: "unknown",
     joinedAt
   };
@@ -6629,40 +6638,38 @@ function createRoomEngine(options) {
     },
     participants(list) {
       const joinedAt = new Date(now()).toISOString();
-      const before = new Set(store.snapshot().participants.map((p) => p.identity));
       projectRoster(list, joinedAt);
-      const snapshot = store.snapshot();
-      const newcomer = snapshot.participants.some(
-        (participant) => !participant.isLocal && !before.has(participant.identity)
-      );
-      const me = snapshot.participants.find((p) => p.identity === snapshot.localIdentity);
-      if (newcomer && before.size > 0 && me?.handRaised === true) {
-        void publish(DATA_TOPICS.hand, { raised: true, raisedAt: me.handRaisedAt ?? now() }).catch(
-          () => void 0
-        );
-      }
     },
     participantLeft(who, reason) {
       departures.set(who, reason);
     },
     roomMetadata(metadata) {
-      let spotlight = null;
+      let parsed = {};
       if (metadata.length > 0) {
         try {
-          const parsed = JSON.parse(metadata);
-          if (typeof parsed === "object" && parsed !== null) {
-            const value = parsed.spotlight;
-            if (typeof value === "string" && value.length > 0) spotlight = asParticipantIdentity(value);
-          }
+          const value = JSON.parse(metadata);
+          if (typeof value === "object" && value !== null) parsed = value;
         } catch {
           report(
             "warn",
-            "meet: the room's metadata is not JSON, so no spotlight was read from it",
-            "Only aidream writes room metadata; check services/meet/moderation.py."
+            "meet: the room's metadata is not JSON, so the room state was not read from it",
+            "Only aidream writes room metadata; check services/meet/room_state.py."
           );
         }
       }
-      if (store.snapshot().spotlight !== spotlight) store.patch({ spotlight });
+      const key = (name) => {
+        const value = parsed[name];
+        return typeof value === "string" && value.length > 0 ? asParticipantIdentity(personOf(value)) : null;
+      };
+      const waiting = typeof parsed["waiting_count"] === "number" ? parsed["waiting_count"] : 0;
+      const before = store.snapshot();
+      const next = { spotlight: key("spotlight"), actingHost: key("acting_host"), presenter: key("presenter"), waitingCount: waiting };
+      if (before.spotlight !== next.spotlight || before.actingHost !== next.actingHost || before.presenter !== next.presenter || before.waitingCount !== next.waitingCount) {
+        store.patch(next);
+      }
+      if (parsed["recording"] !== void 0 && parsed["recording"] !== null) {
+        applyRecordingState(store, { meeting_id: parsed["meeting_id"], recording: parsed["recording"] });
+      }
     },
     activeSpeakers(identities) {
       store.setSpeaking([...new Set(identities.map((who) => personOf(who)))]);
@@ -6764,13 +6771,6 @@ function createRoomEngine(options) {
       }
       const sender = personOf(from ?? "");
       switch (topic) {
-        case DATA_TOPICS.hand:
-          store.setHand(
-            sender,
-            envelope.raised === true,
-            typeof envelope.raisedAt === "number" ? envelope.raisedAt : now()
-          );
-          return;
         case DATA_TOPICS.reaction:
           if (typeof envelope.emoji === "string") {
             store.addReaction({
@@ -6869,6 +6869,7 @@ function createRoomEngine(options) {
     current = token;
     lastServerUrl = token.serverUrl;
     connectionPolicy = token.connectionPolicy ?? DEFAULT_CONNECTION_POLICY;
+    if (token.leavePolicy !== void 0) store.patch({ leavePolicy: token.leavePolicy });
     store.patch({
       localIdentity: token.identity,
       breakoutRoomId: token.breakoutRoomId ?? null,
@@ -6903,6 +6904,7 @@ function createRoomEngine(options) {
       return;
     }
     driver = created;
+    if (token.connectionKind === "companion") created.setRemoteAudioPlayback?.(false);
     await created.connect(token.serverUrl, token.token);
     store.patch({ failure: null, connection: "stable" });
     store.dispatch({ type: "connected" });
@@ -7164,6 +7166,19 @@ function createRoomEngine(options) {
       }
     },
     leave: leaveRoom,
+    async checkElsewhere(roomName) {
+      const claim = options.tabClaim;
+      const userId = identity.userId;
+      if (claim === void 0 || userId === null) return false;
+      const before = store.snapshot();
+      if (before.phase !== "prejoin" || before.secondDevice !== null) return false;
+      if (!await claim.presentElsewhere(String(roomName), `user:${String(userId)}`)) return false;
+      const now2 = store.snapshot();
+      if (now2.phase !== "prejoin" || now2.secondDevice !== null) return false;
+      store.patch({ secondDevice: { rule: "ask_switch_or_join" } });
+      report("info", "meet: this browser already has you in this meeting \u2014 offering the choice before Join");
+      return true;
+    },
     backToPrejoin() {
       store.dispatch({ type: "back_to_prejoin", click: true });
     },
@@ -7221,11 +7236,6 @@ function createRoomEngine(options) {
     dismissShareNotice() {
       if (store.snapshot().share.state === "refused") store.patch({ share: NO_SHARE });
     },
-    async raiseHand(raised) {
-      const local = store.snapshot().localIdentity;
-      if (local !== null) store.setHand(local, raised);
-      await publish(DATA_TOPICS.hand, { raised, raisedAt: now() });
-    },
     async react(emoji) {
       const local = store.snapshot().localIdentity;
       const id = `${local ?? "local"}-${now()}`;
@@ -7354,6 +7364,8 @@ var MODERATION_ACTIONS = [
   "ask_unmute",
   "ask_all_unmute",
   "spotlight",
+  "present",
+  "raise_hand",
   "lower_hand",
   "lower_all_hands",
   "make_cohost",
@@ -7397,7 +7409,8 @@ 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.reason !== void 0 ? { reason: request.reason } : {},
+          ...request.on !== void 0 ? { on: request.on } : {}
         },
         ...hdrs !== void 0 ? { headers: hdrs } : {}
       });