@ai-matrx/meet 0.7.3 → 0.7.6

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(src_exports, {
   CALL_INVITE_VERSION: () => CALL_INVITE_VERSION,
   CONSENT_NOTICE_ATTRIBUTE: () => CONSENT_NOTICE_ATTRIBUTE,
   DATA_TOPICS: () => DATA_TOPICS,
+  DEFAULT_EFFECTS: () => DEFAULT_EFFECTS,
   DEFAULT_PAGE_SIZE: () => DEFAULT_PAGE_SIZE,
   END_MEETING_NOT_SERVED: () => END_MEETING_NOT_SERVED,
   FILE_SESSION_PATH: () => FILE_SESSION_PATH,
@@ -51,6 +52,7 @@ __export(src_exports, {
   MEET_EVENTS: () => MEET_EVENTS,
   MEET_ROUTES: () => MEET_ROUTES,
   MEET_SCHEMA: () => MEET_SCHEMA,
+  MODERATION_ACTIONS: () => MODERATION_ACTIONS,
   MeetError: () => MeetError,
   NOTE_TAKER_IDENTITY_PREFIX: () => NOTE_TAKER_IDENTITY_PREFIX,
   NOTE_TAKER_METADATA_KEY: () => NOTE_TAKER_METADATA_KEY,
@@ -90,6 +92,7 @@ __export(src_exports, {
   createCallCenter: () => createCallCenter,
   createCallInviteHandler: () => createCallInviteHandler,
   createDeviceManager: () => createDeviceManager,
+  createInRoomClient: () => createInRoomClient,
   createLiveKitDriver: () => createLiveKitDriver,
   createMeetAi: () => createMeetAi,
   createMeetApi: () => createMeetApi,
@@ -102,6 +105,7 @@ __export(src_exports, {
   createRoomEngine: () => createRoomEngine,
   createTokenClient: () => createTokenClient,
   createWebDeviceStorage: () => createWebDeviceStorage,
+  createWebEffectsStorage: () => createWebEffectsStorage,
   createWebRoomTokenStorage: () => createWebRoomTokenStorage,
   displayNameFor: () => displayNameFor,
   fileDownloadPath: () => fileDownloadPath,
@@ -363,7 +367,16 @@ var MEET_ROUTES = {
    */
   meetingAnnounce: "/api/v1/meet/meetings/{meeting_id}/announce",
   /** Put a one-off meeting on the caller's own Google Calendar (gated by the server). */
-  meetingGoogleCalendar: "/api/v1/meet/meetings/{meeting_id}/google-calendar"
+  meetingGoogleCalendar: "/api/v1/meet/meetings/{meeting_id}/google-calendar",
+  /**
+   * Meet wave 2: EVERY in-meeting host power (mute, stop video, mute all, ask to
+   * unmute, spotlight, lower hands, co-host, hand over, rename, remove, report).
+   * Decided by the server from the meeting itself; a guest's pass rides
+   * `x-meet-room-token`.
+   */
+  moderate: "/api/v1/meet/moderate",
+  /** Meet wave 2: the SAVED chat — `POST` sends to everyone, `GET ?meeting_id=` reads history. */
+  chat: "/api/v1/meet/chat"
 };
 function meetingPath(template, meetingId) {
   return template.replace("{meeting_id}", encodeURIComponent(meetingId));
@@ -2081,7 +2094,19 @@ var ROOM_EVENTS = {
    * production 2026-09-09 the guest lane showed no indicator at all while the
    * host recorded (MRI-C8).
    */
-  recording: "matrx.meet.recording"
+  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 } }`.
+   */
+  chat: "matrx.meet.chat",
+  /**
+   * 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.
+   */
+  moderation: "matrx.meet.moderation"
 };
 function isRoomEventTopic(topic) {
   return topic.startsWith(ROOM_EVENT_PREFIX);
@@ -2117,6 +2142,10 @@ function applyRoomEvent(args) {
       return applyEnded(store, payload);
     case ROOM_EVENTS.recording:
       return applyRecording(store, payload);
+    case ROOM_EVENTS.chat:
+      return applyChat(store, payload);
+    case ROOM_EVENTS.moderation:
+      return applyModeration(store, payload, now);
     default:
       return ignored(`${topic} is not known to this version of @ai-matrx/meet`);
   }
@@ -2208,6 +2237,101 @@ function applyEnded(store, payload) {
   store.patch({ meeting: { ...meeting, endedAt } });
   return HANDLED;
 }
+function chatFromRow(row) {
+  const id = text2(row["id"]);
+  const identity = text2(row["sender_identity"]);
+  const body = text2(row["body"]);
+  if (id === null || identity === null || body === null) return null;
+  return {
+    id,
+    identity: asParticipantIdentity(identity),
+    displayName: text2(row["sender_name"]) ?? "Participant",
+    text: body,
+    at: text2(row["created_at"]) ?? (/* @__PURE__ */ new Date()).toISOString(),
+    // `false` only from a server whose chat table has not landed: the room heard
+    // it, nobody will see it later — and the line says so.
+    saved: row["saved"] !== false
+  };
+}
+function applyChat(store, payload) {
+  const row = object(payload["message"]);
+  if (row === null) return ignored("a chat event with no `message` row");
+  const meeting = store.snapshot().meeting;
+  if (meeting !== null && text2(row["meeting_id"]) !== null && row["meeting_id"] !== meeting.id) {
+    return ignored("a chat message for a different meeting");
+  }
+  const message = chatFromRow(row);
+  if (message === null) return ignored("a chat row with no id, sender or body");
+  store.addChat(message);
+  return HANDLED;
+}
+function moderationText(kind, payload) {
+  const by = text2(payload["by"]) ?? "The host";
+  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.`;
+    }
+    case "ask-unmute":
+      return `${by} is asking you to unmute.`;
+    case "removed":
+      return `${by} removed you from this meeting.`;
+    default:
+      return null;
+  }
+}
+function applyModeration(store, payload, now) {
+  const snapshot = store.snapshot();
+  const meetingId = text2(payload["meeting_id"]);
+  if (snapshot.meeting !== null && meetingId !== null && meetingId !== snapshot.meeting.id) {
+    return ignored("a moderation event for a different meeting");
+  }
+  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"]);
+      if (identity === null || role === null || !ROLES.includes(role)) {
+        return ignored("a role event with no identity or an unknown role");
+      }
+      if (identity === snapshot.localIdentity) {
+        store.patch({
+          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.",
+            at: now()
+          }
+        });
+      }
+      return HANDLED;
+    }
+    case "muted":
+    case "ask-unmute":
+    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() } });
+      return HANDLED;
+    }
+    default:
+      return ignored(`a moderation kind this version does not know: ${String(kind)}`);
+  }
+}
+var ROLES = ["host", "cohost", "participant", "guest"];
 
 // src/core/devices.ts
 var KINDS = ["audioinput", "videoinput", "audiooutput"];
@@ -2540,7 +2664,8 @@ function computeStage(args) {
   const ordered = orderParticipants(args.participants, args.activeSpeakers);
   const sharer = ordered.find((participant) => participant.screenSharing) ?? null;
   const pinnedParticipant = args.pinned === null ? null : ordered.find((participant) => participant.identity === args.pinned) ?? null;
-  const feature = sharer !== null ? sharer : args.layout === "grid" ? null : pinnedParticipant ?? ordered[0] ?? null;
+  const spotlit = args.spotlight == null ? null : ordered.find((participant) => participant.identity === args.spotlight) ?? null;
+  const feature = sharer !== null ? sharer : pinnedParticipant !== null && args.layout !== "grid" ? pinnedParticipant : spotlit !== null ? spotlit : args.layout === "grid" ? null : ordered[0] ?? null;
   const rest = feature === null ? ordered : ordered.filter((participant) => participant.identity !== feature.identity);
   const pageCount = Math.max(1, Math.ceil(rest.length / pageSize));
   const page = Math.min(Math.max(0, args.page ?? 0), pageCount - 1);
@@ -2566,8 +2691,7 @@ function gridColumns(count2) {
 var DATA_TOPICS = {
   hand: "mx.hand",
   reaction: "mx.reaction",
-  chat: "mx.chat",
-  hostAction: "mx.host"
+  chat: "mx.chat"
 };
 var TRANSCRIPTION_TOPIC = "lk.transcription";
 var TRANSCRIPTION_ATTRIBUTES = {
@@ -2628,11 +2752,48 @@ function snapshotParticipant(participant, isLocal) {
     screenSharing: participant.isScreenShareEnabled
   };
 }
+var DEFAULT_AUDIO_PROCESSING = {
+  noiseSuppression: true,
+  echoCancellation: true,
+  autoGainControl: true
+};
+function videoEffectsSupported() {
+  const scope = globalThis;
+  if (typeof scope.OffscreenCanvas === "undefined" || scope.document === void 0) return false;
+  try {
+    return scope.document.createElement("canvas").getContext("webgl2") !== null;
+  } catch {
+    return false;
+  }
+}
+async function applyVideoEffect(target, effect) {
+  const { Track } = await import("livekit-client");
+  const track = target.localParticipant.getTrackPublication(Track.Source.Camera)?.track;
+  if (track === void 0) return;
+  try {
+    if (effect.kind === "none") {
+      await track.stopProcessor();
+      return;
+    }
+    const processors = await import("@livekit/track-processors");
+    const processor = effect.kind === "blur" ? processors.BackgroundBlur(effect.radius ?? 12) : processors.VirtualBackground(effect.imageUrl);
+    await track.setProcessor(processor);
+  } catch (error) {
+    throw new MeetError(
+      "media-unsupported",
+      "The background effect could not start on this camera",
+      "Background effects need a browser with WebGL2 (current Chrome, Edge, Firefox or Safari). Your video continues without the effect.",
+      error
+    );
+  }
+}
 var encoder = new TextEncoder();
 var decoder = new TextDecoder();
 function createLiveKitDriver(handlers, options = {}) {
   let room = null;
   let projectRoster = null;
+  let audioCapture = DEFAULT_AUDIO_PROCESSING;
+  let videoEffect = { kind: "none" };
   async function load() {
     if (room !== null) return room;
     let module2;
@@ -2661,7 +2822,9 @@ function createLiveKitDriver(handlers, options = {}) {
       handlers.participants([local, ...remotes]);
     };
     projectRoster = roster;
-    created.on(RoomEvent.ParticipantConnected, roster).on(RoomEvent.ParticipantDisconnected, roster).on(RoomEvent.TrackSubscribed, roster).on(RoomEvent.TrackUnsubscribed, roster).on(RoomEvent.TrackMuted, roster).on(RoomEvent.TrackUnmuted, roster).on(RoomEvent.LocalTrackPublished, roster).on(RoomEvent.LocalTrackUnpublished, roster).on(RoomEvent.ActiveSpeakersChanged, (speakers) => {
+    created.on(RoomEvent.ParticipantConnected, roster).on(RoomEvent.ParticipantDisconnected, roster).on(RoomEvent.TrackSubscribed, roster).on(RoomEvent.TrackUnsubscribed, roster).on(RoomEvent.TrackMuted, roster).on(RoomEvent.TrackUnmuted, roster).on(RoomEvent.LocalTrackPublished, roster).on(RoomEvent.LocalTrackUnpublished, roster).on(RoomEvent.ParticipantNameChanged, roster).on(RoomEvent.ParticipantAttributesChanged, roster).on(RoomEvent.ParticipantMetadataChanged, roster).on(RoomEvent.RoomMetadataChanged, (metadata) => {
+      handlers.roomMetadata?.(metadata ?? "");
+    }).on(RoomEvent.ActiveSpeakersChanged, (speakers) => {
       handlers.activeSpeakers(speakers.map((speaker) => speaker.identity));
     }).on(RoomEvent.ConnectionQualityChanged, (quality, participant) => {
       handlers.quality(participant.identity, mapQuality(quality));
@@ -2738,6 +2901,7 @@ function createLiveKitDriver(handlers, options = {}) {
         throw normalizeDeviceError(error, "meet.connect");
       }
       projectRoster?.();
+      handlers.roomMetadata?.(target.metadata ?? "");
     },
     async disconnect() {
       if (room === null) return;
@@ -2752,14 +2916,19 @@ function createLiveKitDriver(handlers, options = {}) {
     },
     async setMicrophoneEnabled(enabled) {
       try {
-        await requireRoom("setMicrophoneEnabled").localParticipant.setMicrophoneEnabled(enabled);
+        await requireRoom("setMicrophoneEnabled").localParticipant.setMicrophoneEnabled(
+          enabled,
+          audioCapture
+        );
       } catch (error) {
         throw normalizeDeviceError(error, "meet.setMicrophoneEnabled");
       }
     },
     async setCameraEnabled(enabled) {
       try {
-        await requireRoom("setCameraEnabled").localParticipant.setCameraEnabled(enabled);
+        const target = requireRoom("setCameraEnabled");
+        await target.localParticipant.setCameraEnabled(enabled);
+        if (enabled && videoEffect.kind !== "none") await applyVideoEffect(target, videoEffect);
       } catch (error) {
         throw normalizeDeviceError(error, "meet.setCameraEnabled");
       }
@@ -2771,14 +2940,40 @@ function createLiveKitDriver(handlers, options = {}) {
         throw normalizeDeviceError(error, "meet.setScreenShareEnabled");
       }
     },
-    async publishData(topic, payload) {
+    async publishData(topic, payload, to) {
       await requireRoom("publishData").localParticipant.publishData(
         // `reliable` is not optional for a control plane: a dropped
         // "hand lowered" leaves a hand up on every other screen forever.
         encoder.encode(payload),
-        { reliable: true, topic }
+        to === void 0 || to.length === 0 ? { reliable: true, topic } : { reliable: true, topic, destinationIdentities: [...to] }
       );
     },
+    async setAudioProcessing(processing) {
+      audioCapture = { ...audioCapture, ...processing };
+      const target = room;
+      if (target === null) return;
+      const { Track } = await import("livekit-client");
+      const publication = target.localParticipant.getTrackPublication(Track.Source.Microphone);
+      const track = publication?.track;
+      if (track === void 0 || publication?.isMuted === true) return;
+      try {
+        await track.restartTrack({
+          ...audioCapture,
+          ...target.getActiveDevice("audioinput") !== void 0 ? { deviceId: target.getActiveDevice("audioinput") } : {}
+        });
+      } catch (error) {
+        throw normalizeDeviceError(error, "meet.setAudioProcessing");
+      }
+    },
+    async setVideoEffect(effect) {
+      videoEffect = effect;
+      const target = room;
+      if (target === null) return;
+      await applyVideoEffect(target, effect);
+    },
+    supportsVideoEffects() {
+      return videoEffectsSupported();
+    },
     attach(identity, kind, element) {
       const target = requireRoom("attach");
       const source = sources?.[kind];
@@ -3001,6 +3196,11 @@ function listenOnlyNotice(media) {
 }
 
 // src/core/store.ts
+var DEFAULT_EFFECTS = {
+  noiseSuppression: true,
+  background: "none",
+  backgroundImage: null
+};
 var NO_GRANTS = {
   role: "participant",
   canRecord: false,
@@ -3023,7 +3223,13 @@ var EMPTY = {
   recordingSource: "local",
   recordingId: null,
   chat: [],
+  chatLoaded: false,
+  chatHistoryError: null,
   reactions: [],
+  spotlight: null,
+  moderationNotice: null,
+  actionNotice: null,
+  effects: DEFAULT_EFFECTS,
   transcript: [],
   notes: [],
   names: {},
@@ -3062,6 +3268,7 @@ 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,
@@ -3075,6 +3282,7 @@ function createMeetStore(initial = {}) {
           // 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
         }))
       });
@@ -3097,11 +3305,17 @@ function createMeetStore(initial = {}) {
         )
       });
     },
-    setHand(identity, raised) {
+    setHand(identity, raised, at) {
       commit({
         ...state,
         participants: state.participants.map(
-          (participant) => participant.identity === identity ? { ...participant, handRaised: raised } : participant
+          (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
         )
       });
     },
@@ -3111,6 +3325,31 @@ function createMeetStore(initial = {}) {
       const names = learnName(state.names, message.identity, message.displayName);
       commit({ ...state, chat: chat.slice(-CHAT_LIMIT), names });
     },
+    loadChat(messages) {
+      const known = new Set(state.chat.map((message) => message.id));
+      const merged = [...messages.filter((message) => !known.has(message.id)), ...state.chat].sort(
+        (a, b) => a.at < b.at ? -1 : a.at > b.at ? 1 : 0
+      );
+      const names = learnNames(
+        state.names,
+        messages.map((message) => ({ identity: message.identity, displayName: message.displayName }))
+      );
+      commit({ ...state, chat: merged.slice(-CHAT_LIMIT), chatLoaded: true, chatHistoryError: null, names });
+    },
+    settleChat(localId, next) {
+      const index = state.chat.findIndex((message) => message.id === localId);
+      if (index === -1) return;
+      const current = state.chat[index];
+      let replacement;
+      if ("failed" in next && typeof next.failed === "string" && !("id" in next)) {
+        replacement = { ...current, failed: next.failed };
+      } else {
+        replacement = next;
+      }
+      const duplicate = replacement.id !== localId && state.chat.some((message) => message.id === replacement.id);
+      const chat = duplicate ? state.chat.filter((message) => message.id !== localId) : state.chat.map((message, position) => position === index ? replacement : message);
+      commit({ ...state, chat });
+    },
     addReaction(reaction) {
       commit({ ...state, reactions: [...state.reactions, reaction] });
     },
@@ -3201,7 +3440,7 @@ function createMeetStore(initial = {}) {
       commit({ ...state, media: { ...state.media, [kind]: next } });
     },
     reset() {
-      commit({ ...EMPTY });
+      commit({ ...EMPTY, effects: state.effects });
     }
   };
 }
@@ -3833,7 +4072,37 @@ function createRoomEngine(options) {
   const handlers = {
     participants(list) {
       const joinedAt = new Date(now()).toISOString();
+      const before = new Set(store.snapshot().participants.map((p) => p.identity));
       store.setParticipants(list.map((entry) => projectParticipant(entry, 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
+        );
+      }
+    },
+    roomMetadata(metadata) {
+      let spotlight = null;
+      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);
+          }
+        } 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."
+          );
+        }
+      }
+      if (store.snapshot().spotlight !== spotlight) store.patch({ spotlight });
     },
     activeSpeakers(identities) {
       store.setSpeaking(identities.map(asParticipantIdentity));
@@ -3937,7 +4206,11 @@ function createRoomEngine(options) {
       const sender = asParticipantIdentity(from ?? "");
       switch (topic) {
         case DATA_TOPICS.hand:
-          store.setHand(sender, envelope.raised === true);
+          store.setHand(
+            sender,
+            envelope.raised === true,
+            typeof envelope.raisedAt === "number" ? envelope.raisedAt : now()
+          );
           return;
         case DATA_TOPICS.reaction:
           if (typeof envelope.emoji === "string") {
@@ -3951,12 +4224,14 @@ function createRoomEngine(options) {
           return;
         case DATA_TOPICS.chat:
           if (typeof envelope.text === "string") {
+            const local = store.snapshot().localIdentity;
             store.addChat({
               id: envelope.id ?? `${sender}-${now()}`,
               identity: sender,
               displayName: envelope.name ?? sender,
               text: envelope.text,
-              at: envelope.at ?? new Date(now()).toISOString()
+              at: envelope.at ?? new Date(now()).toISOString(),
+              ...typeof envelope.to === "string" && local !== null ? { to: local } : {}
             });
           }
           return;
@@ -4002,6 +4277,24 @@ function createRoomEngine(options) {
     store.patch({ phase: "connected", failure: null });
     store.setLocalTrack("microphone", IDLE_TRACK);
     store.setLocalTrack("camera", IDLE_TRACK);
+    const effects = options.effectsStorage?.load() ?? store.snapshot().effects;
+    store.patch({ effects });
+    if (!effects.noiseSuppression || effects.background !== "none") {
+      try {
+        await applyEffects(created, effects);
+      } catch {
+      }
+    }
+    for (const kind of ["audioinput", "videoinput", "audiooutput"]) {
+      const chosen = options.resolveDevice?.(kind) ?? null;
+      if (chosen === null || chosen === "default") continue;
+      try {
+        await created.switchDevice(kind, chosen);
+      } catch (error) {
+        const normalized = normalizeDeviceError(error, `meet.switchDevice(${kind})`);
+        report("warn", normalized.message, normalized.remedy);
+      }
+    }
     if (request.mode === "video") {
       await enableTrack(created, "camera", true);
     }
@@ -4024,9 +4317,30 @@ function createRoomEngine(options) {
       return state;
     }
   }
-  async function publish(topic, body) {
+  async function publish(topic, body, to) {
     if (driver === null) return;
-    await driver.publishData(topic, JSON.stringify(body));
+    await driver.publishData(topic, JSON.stringify(body), to);
+  }
+  async function applyEffects(target, effects) {
+    try {
+      await target.setAudioProcessing?.({
+        noiseSuppression: effects.noiseSuppression,
+        echoCancellation: true,
+        autoGainControl: true
+      });
+    } catch (error) {
+      report("warn", `meet: noise suppression could not be applied: ${String(error)}`, "The microphone keeps working without it.");
+    }
+    if (target.setVideoEffect === void 0) return;
+    const effect = effects.background === "blur" ? { kind: "blur" } : effects.background === "image" && effects.backgroundImage !== null ? { kind: "image", imageUrl: effects.backgroundImage } : { kind: "none" };
+    if (effect.kind !== "none" && target.supportsVideoEffects?.() === false) return;
+    try {
+      await target.setVideoEffect(effect);
+    } catch (error) {
+      const normalized = normalizeMeetError(error, "meet.setVideoEffect");
+      report("warn", normalized.message, normalized.remedy);
+      throw normalized;
+    }
   }
   return {
     join(request) {
@@ -4082,7 +4396,7 @@ function createRoomEngine(options) {
     async raiseHand(raised) {
       const local = store.snapshot().localIdentity;
       if (local !== null) store.setHand(local, raised);
-      await publish(DATA_TOPICS.hand, { raised });
+      await publish(DATA_TOPICS.hand, { raised, raisedAt: now() });
     },
     async react(emoji) {
       const local = store.snapshot().localIdentity;
@@ -4092,32 +4406,41 @@ function createRoomEngine(options) {
       }
       await publish(DATA_TOPICS.reaction, { id, emoji });
     },
-    async sendChat(text3) {
+    async sendPrivateChat(to, text3) {
       const trimmed = text3.trim();
       if (trimmed.length === 0) return;
       const local = store.snapshot().localIdentity;
       const id = `${local ?? "local"}-${now()}`;
       const at = new Date(now()).toISOString();
       if (local !== null) {
-        store.addChat({
-          id,
-          identity: local,
-          displayName: identity.displayName,
-          text: trimmed,
-          at
-        });
+        store.addChat({ id, identity: local, displayName: identity.displayName, text: trimmed, at, to });
       }
-      await publish(DATA_TOPICS.chat, { id, text: trimmed, at, name: identity.displayName });
+      await publish(
+        DATA_TOPICS.chat,
+        { id, text: trimmed, at, name: identity.displayName, to },
+        [to]
+      );
     },
-    async publishHostAction(action) {
-      if (!isHostRole(effectiveRole(store.snapshot()))) {
-        throw new MeetError(
-          "forbidden",
-          `meet.hostAction(${action.kind}): this participant is not a host`,
-          "Host powers come from the server-minted token metadata. Hide the control instead of rendering a dead button (no dead ends)."
-        );
+    async setEffects(next) {
+      const previous = store.snapshot().effects;
+      const merged = { ...previous, ...next };
+      store.patch({ effects: merged });
+      options.effectsStorage?.save(merged);
+      if (driver === null) return;
+      try {
+        await applyEffects(driver, merged);
+      } catch {
+        const reverted = { ...merged, background: previous.background, backgroundImage: previous.backgroundImage };
+        store.patch({ effects: reverted });
+        options.effectsStorage?.save(reverted);
       }
-      await publish(DATA_TOPICS.hostAction, { ...action });
+    },
+    supportsVideoEffects() {
+      return driver?.supportsVideoEffects?.() ?? false;
+    },
+    async switchDevice(kind, deviceId) {
+      if (driver === null) return;
+      await driver.switchDevice(kind, deviceId);
     },
     pin(who) {
       store.patch({ pinned: who, layout: who === null ? "grid" : "speaker" });
@@ -4148,6 +4471,192 @@ function hostUserIds(participants) {
   return participants.filter((participant) => participant.role === "host" && participant.userId !== null).map((participant) => participant.userId);
 }
 
+// src/core/effects.ts
+function coerce(value) {
+  if (typeof value !== "object" || value === null) return DEFAULT_EFFECTS;
+  const row = value;
+  const background = row["background"] === "blur" || row["background"] === "image" ? row["background"] : "none";
+  const backgroundImage = typeof row["backgroundImage"] === "string" ? row["backgroundImage"] : null;
+  return {
+    noiseSuppression: row["noiseSuppression"] !== false,
+    background: background === "image" && backgroundImage === null ? "none" : background,
+    backgroundImage
+  };
+}
+function createWebEffectsStorage(key = "mx.meet.effects") {
+  let memory = DEFAULT_EFFECTS;
+  const storage = globalThis.localStorage;
+  return {
+    load() {
+      if (storage === void 0) return memory;
+      try {
+        const raw = storage.getItem(key);
+        return raw === null ? memory : coerce(JSON.parse(raw));
+      } catch {
+        return memory;
+      }
+    },
+    save(effects) {
+      memory = effects;
+      try {
+        storage?.setItem(key, JSON.stringify(effects));
+      } catch {
+      }
+    }
+  };
+}
+
+// src/core/in-room.ts
+var MODERATION_ACTIONS = [
+  "mute",
+  "stop_video",
+  "stop_screen",
+  "mute_all",
+  "ask_unmute",
+  "ask_all_unmute",
+  "spotlight",
+  "lower_hand",
+  "lower_all_hands",
+  "make_cohost",
+  "revoke_cohost",
+  "transfer_host",
+  "rename",
+  "remove",
+  "report"
+];
+function createInRoomClient(options) {
+  const { api, store } = options;
+  const now = options.now ?? (() => Date.now());
+  function meetingId(operation) {
+    const meeting = store.snapshot().meeting;
+    if (meeting === null) {
+      throw new MeetError(
+        "not-found",
+        `${operation}: this room has no meeting record`,
+        "Moderation and saved chat belong to a meeting. An ad-hoc call has neither."
+      );
+    }
+    return meeting.id;
+  }
+  function headers() {
+    const token = options.resolveRoomToken();
+    return token === null ? void 0 : { [ROOM_TOKEN_HEADER]: token };
+  }
+  async function refusal2(response, operation, remedy) {
+    let body = null;
+    try {
+      body = await response.json();
+    } catch {
+      body = null;
+    }
+    const said = readServerRefusal(body);
+    return new MeetError(
+      response.status === 403 || response.status === 401 ? "forbidden" : response.status === 404 ? "not-found" : response.status === 409 ? "conflict" : "transport",
+      said?.reason ?? `${operation}: the server answered ${response.status}`,
+      said?.remedy !== void 0 && said.remedy.length > 0 ? said.remedy : remedy
+    );
+  }
+  return {
+    async moderate(request) {
+      const operation = `meet.moderate(${request.action})`;
+      const hdrs = headers();
+      const response = await api.request({
+        path: MEET_ROUTES.moderate,
+        method: "POST",
+        operation,
+        body: {
+          meeting_id: meetingId(operation),
+          action: request.action,
+          ...request.identity != null ? { identity: request.identity } : {},
+          ...request.name !== void 0 ? { name: request.name } : {},
+          ...request.reason !== void 0 ? { reason: request.reason } : {}
+        },
+        ...hdrs !== void 0 ? { headers: hdrs } : {}
+      });
+      if (!response.ok) {
+        throw await refusal2(
+          response,
+          operation,
+          "Nothing was changed. The server decides host powers from the meeting itself."
+        );
+      }
+      const payload = await response.json();
+      return {
+        action: request.action,
+        affected: Array.isArray(payload["affected"]) ? payload["affected"].filter((value) => typeof value === "string") : [],
+        message: typeof payload["message"] === "string" ? payload["message"] : "Done."
+      };
+    },
+    async sendChat(text3) {
+      const body = text3.trim();
+      if (body.length === 0) return;
+      const operation = "meet.sendChat";
+      const id = meetingId(operation);
+      const snapshot = store.snapshot();
+      const me = snapshot.participants.find((p) => p.identity === snapshot.localIdentity);
+      const localId = `pending-${now()}`;
+      const pending = {
+        id: localId,
+        identity: snapshot.localIdentity ?? "local",
+        displayName: me?.displayName ?? "You",
+        text: body,
+        at: new Date(now()).toISOString(),
+        saved: false
+      };
+      store.addChat(pending);
+      const hdrs = headers();
+      let response;
+      try {
+        response = await api.request({
+          path: MEET_ROUTES.chat,
+          method: "POST",
+          operation,
+          body: { meeting_id: id, body },
+          ...hdrs !== void 0 ? { headers: hdrs } : {}
+        });
+      } catch (error) {
+        store.settleChat(localId, { failed: "Not sent \u2014 the server could not be reached." });
+        throw error;
+      }
+      if (!response.ok) {
+        const error = await refusal2(response, operation, "Your message was not sent.");
+        store.settleChat(localId, { failed: error.message });
+        throw error;
+      }
+      const saved = chatFromRow(await response.json());
+      if (saved === null) {
+        store.settleChat(localId, { failed: "The server's answer could not be read." });
+        return;
+      }
+      store.settleChat(localId, saved);
+    },
+    async loadChat() {
+      const operation = "meet.loadChat";
+      const id = meetingId(operation);
+      const hdrs = headers();
+      const response = await api.request({
+        path: `${MEET_ROUTES.chat}?meeting_id=${encodeURIComponent(id)}`,
+        method: "GET",
+        operation,
+        ...hdrs !== void 0 ? { headers: hdrs } : {}
+      });
+      if (!response.ok) {
+        throw await refusal2(
+          response,
+          operation,
+          "Messages sent before you joined could not be read. New messages still arrive."
+        );
+      }
+      const payload = await response.json();
+      const rows = Array.isArray(payload.messages) ? payload.messages : [];
+      const messages = rows.map(
+        (row) => typeof row === "object" && row !== null ? chatFromRow(row) : null
+      ).filter((message) => message !== null);
+      store.loadChat(messages);
+    }
+  };
+}
+
 // src/core/record.ts
 var import_format = require("@ai-matrx/kit/format");
 function activeWrapUpSummary(notes) {