@ai-matrx/meet 0.7.2 → 0.7.5

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,
@@ -69,6 +71,7 @@ __export(src_exports, {
   TRANSCRIPTION_ATTRIBUTES: () => TRANSCRIPTION_ATTRIBUTES,
   TRANSCRIPTION_TOPIC: () => TRANSCRIPTION_TOPIC,
   absenceSentence: () => absenceSentence,
+  announceMeeting: () => announceMeeting,
   applyRoomEvent: () => applyRoomEvent,
   asCallId: () => asCallId,
   asMeetingId: () => asMeetingId,
@@ -83,11 +86,13 @@ __export(src_exports, {
   canModerateParticipant: () => canModerateParticipant,
   canTransition: () => canTransition,
   captionSegment: () => captionSegment,
+  changesPatch: () => changesPatch,
   computeStage: () => computeStage,
   countLabel: () => countLabel,
   createCallCenter: () => createCallCenter,
   createCallInviteHandler: () => createCallInviteHandler,
   createDeviceManager: () => createDeviceManager,
+  createInRoomClient: () => createInRoomClient,
   createLiveKitDriver: () => createLiveKitDriver,
   createMeetAi: () => createMeetAi,
   createMeetApi: () => createMeetApi,
@@ -100,6 +105,7 @@ __export(src_exports, {
   createRoomEngine: () => createRoomEngine,
   createTokenClient: () => createTokenClient,
   createWebDeviceStorage: () => createWebDeviceStorage,
+  createWebEffectsStorage: () => createWebEffectsStorage,
   createWebRoomTokenStorage: () => createWebRoomTokenStorage,
   displayNameFor: () => displayNameFor,
   fileDownloadPath: () => fileDownloadPath,
@@ -127,6 +133,7 @@ __export(src_exports, {
   mapQuality: () => mapQuality,
   meetingInviteAction: () => meetingInviteAction,
   meetingLink: () => meetingLink,
+  meetingPath: () => meetingPath,
   meetingSlug: () => meetingSlug,
   meetingTopic: () => meetingTopic,
   meetingWhen: () => meetingWhen,
@@ -143,9 +150,15 @@ __export(src_exports, {
   parseRoomToken: () => parseRoomToken,
   participantSummary: () => participantSummary,
   playableRecordingFileId: () => playableRecordingFileId,
+  projectInvitee: () => projectInvitee,
   projectNote: () => projectNote,
+  projectOccurrence: () => projectOccurrence,
+  projectOverride: () => projectOverride,
   projectParticipant: () => projectParticipant,
+  projectRsvpInvitation: () => projectRsvpInvitation,
   projectSegment: () => projectSegment,
+  projectUpcoming: () => projectUpcoming,
+  pushMeetingToGoogleCalendar: () => pushMeetingToGoogleCalendar,
   readServerRefusal: () => readServerRefusal,
   readableTranscript: () => readableTranscript,
   recordingLabel: () => recordingLabel,
@@ -153,6 +166,7 @@ __export(src_exports, {
   roleOf: () => roleOf,
   roomTopic: () => roomTopic,
   setGuestRecordAccess: () => setGuestRecordAccess,
+  settingsPatch: () => settingsPatch,
   snapshotParticipant: () => snapshotParticipant,
   unavailableFrom: () => unavailableFrom,
   userTopic: () => userTopic,
@@ -187,7 +201,7 @@ var MeetError = class extends Error {
 };
 var FORBIDDEN_CODES = /* @__PURE__ */ new Set(["42501", "PGRST301", "PGRST302"]);
 var NOT_FOUND_CODES = /* @__PURE__ */ new Set(["PGRST116", "PGRST205"]);
-var CONFLICT_CODES = /* @__PURE__ */ new Set(["23505"]);
+var CONFLICT_CODES = /* @__PURE__ */ new Set(["23505", "40001", "55000"]);
 var SESSION_MARKERS = [
   "auth session missing",
   "jwt expired",
@@ -345,8 +359,28 @@ var MEET_ROUTES = {
    */
   record: "/api/v1/meet/record",
   /** A host chooses what guests may read of ONE meeting (MRF-1). */
-  recordAccess: "/api/v1/meet/record/access"
+  recordAccess: "/api/v1/meet/record/access",
+  /**
+   * Meet wave 1 (0.8): bring every invitee up to date after a write — sends the
+   * invitation / update / cancellation emails with their `.ics` and re-queues
+   * reminders. Idempotent. `{meeting_id}` is substituted by `meetingPath`.
+   */
+  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",
+  /**
+   * 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));
+}
 var ROOM_TOKEN_HEADER = "x-meet-room-token";
 var REFRESH_RATIO = 0.8;
 function readString(source, key) {
@@ -476,6 +510,19 @@ function createTokenClient(options) {
         "The link is wrong or the meeting was deleted. Show the 'meeting not found' screen; a durable link that 404s is never a retry."
       );
     }
+    if (response.status === 410) {
+      let reason = "This meeting was cancelled.";
+      try {
+        const body = await response.json();
+        if (typeof body?.detail?.message === "string") reason = body.detail.message;
+      } catch {
+      }
+      throw new MeetError(
+        "cancelled",
+        reason,
+        "Nobody can join a cancelled meeting. Show the cancelled screen with this sentence; ask the host to schedule a new one."
+      );
+    }
     if (response.status === 423) {
       throw new MeetError(
         "room-locked",
@@ -677,12 +724,12 @@ function createMeetAi(options) {
   async function dispatch(route, body, operation) {
     const response = await send({ path: route, body, operation, requireAuth: true });
     if (!response.ok) {
-      const refusal = await refusalFor(response, operation);
-      options.store.patch({ noteTakerRefusal: refusal });
+      const refusal2 = await refusalFor(response, operation);
+      options.store.patch({ noteTakerRefusal: refusal2 });
       throw new MeetError(
         response.status === 403 ? "forbidden" : "transport",
-        refusal.reason,
-        refusal.remedy
+        refusal2.reason,
+        refusal2.remedy
       );
     }
     options.store.patch({ noteTakerRefusal: null });
@@ -720,11 +767,11 @@ function createMeetAi(options) {
         ...signal !== void 0 ? { signal } : {}
       });
       if (!response.ok) {
-        const refusal = await refusalFor(response, "meet.ai.ask");
+        const refusal2 = await refusalFor(response, "meet.ai.ask");
         throw new MeetError(
           response.status === 403 || response.status === 401 ? "forbidden" : response.status === 404 ? "not-found" : "transport",
-          refusal.reason,
-          refusal.remedy
+          refusal2.reason,
+          refusal2.remedy
         );
       }
       const body = response.body;
@@ -833,14 +880,14 @@ function noteTakerStatus(args) {
   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;
-  const refusal = args.refusal ?? null;
+  const refusal2 = args.refusal ?? null;
   if (recorded === null) {
-    return { state: "absent", detail, present, refusal };
+    return { state: "absent", detail, present, refusal: refusal2 };
   }
   if (recorded === "transcribing" && !present) {
-    return { state: "handoff_pending", detail, present, refusal };
+    return { state: "handoff_pending", detail, present, refusal: refusal2 };
   }
-  return { state: recorded, detail, present, refusal };
+  return { state: recorded, detail, present, refusal: refusal2 };
 }
 function noteTakerLabel(status) {
   switch (status.state) {
@@ -1253,7 +1300,11 @@ var TABLES = {
   invites: "meet_call_invites",
   recordings: "meet_recordings",
   transcripts: "meet_transcript_segments",
-  notes: "meet_notes"
+  notes: "meet_notes",
+  /** Wave 1 (0.8): who a meeting was sent to, and what they answered. */
+  invitees: "meet_invitees",
+  /** Wave 1 (0.8): one occurrence of a series cancelled or moved. */
+  occurrenceOverrides: "meet_occurrence_overrides"
 };
 var RPCS = {
   /** Atomic: create the invite row and stamp its expiry in one statement. */
@@ -1269,10 +1320,41 @@ var RPCS = {
   admit: "meet_admit_participant",
   setLock: "meet_set_lock",
   endMeeting: "meet_end_meeting",
-  recordConsent: "meet_record_consent"
+  recordConsent: "meet_record_consent",
+  /*
+   * ── MEET WAVE 1 — management (0.8). Every write is a SECURITY DEFINER door
+   * authorized by the meeting's host or a real iam grant (editor to change,
+   * admin = co-host to archive or name a co-host) — never an organization
+   * match. After any of these writes, call `announceMeeting` so the server
+   * sends invitations / updates / cancellations and re-queues reminders.
+   */
+  /** Schedule with every setting at create; unset settings come from the knobs. */
+  scheduleMeeting: "meet_schedule_meeting",
+  /** Edit / reschedule — a JSON patch with a version compare-and-swap. */
+  updateMeeting: "meet_update_meeting",
+  /** Cancel is a state (`cancelled_at`); the link keeps resolving. */
+  cancelMeeting: "meet_cancel_meeting",
+  /** Archive (soft delete) — the invitations and exceptions cascade. */
+  archiveMeeting: "meet_archive_meeting",
+  restoreMeeting: "meet_restore_meeting",
+  /** Cancel, move or restore ONE occurrence of a series by its original start. */
+  setOccurrence: "meet_set_occurrence",
+  addInvitees: "meet_add_invitees",
+  setInviteeRole: "meet_set_invitee_role",
+  removeInvitee: "meet_remove_invitee",
+  /** A signed-in invitee answers for themselves. */
+  respond: "meet_respond",
+  /** The emailed RSVP link (no account): read and answer. */
+  invitationByToken: "meet_invitation_by_token",
+  respondByToken: "meet_respond_by_token",
+  /** One meeting's occurrences between two instants (INVOKER — the reader's RLS). */
+  meetingOccurrences: "meet_meeting_occurrences",
+  /** Every occurrence the reader can see between two instants — the Upcoming list. */
+  occurrencesBetween: "meet_occurrences_between"
 };
 var VOID_RPCS = [RPCS.admit, RPCS.recordConsent];
-var MEETING_COLUMNS = "id,organization_id,room_name,slug,title,kind,host_user_id,scheduled_for,scheduled_duration_minutes,started_at,ended_at,locked,lobby_enabled,recording_policy,ai_enabled,metadata";
+var MEETING_COLUMNS = "id,organization_id,room_name,slug,title,kind,host_user_id,scheduled_for,scheduled_duration_minutes,started_at,ended_at,locked,lobby_enabled,recording_policy,ai_enabled,metadata,time_zone,agenda,recurrence_rule,join_before_host,cancelled_at,cancellation_reason,deleted_at,calendar_sequence,version";
+var INVITEE_COLUMNS = "id,meeting_id,invitee_user_id,email,display_name,role,rsvp_state,responded_at,rsvp_note,last_sent_sequence,last_sent_at";
 var RECORDING_COLUMNS = "id,meeting_id,state,started_at,ended_at,started_by,file_id,failure_reason";
 var SEGMENT_COLUMNS = "id,meeting_id,identity,speaker,text,started_at,is_final,metadata";
 var NOTE_COLUMNS = "id,meeting_id,text,kind,assignee_user_id,created_at,metadata";
@@ -1370,6 +1452,138 @@ function projectNote(row) {
     source: "record"
   };
 }
+var RSVP_STATES = ["needs_action", "accepted", "declined", "tentative"];
+var OCCURRENCE_STATES = ["scheduled", "moved", "cancelled"];
+function rsvpState(value) {
+  return RSVP_STATES.includes(value) ? value : "needs_action";
+}
+function num(row, key) {
+  const value = row[key];
+  return typeof value === "number" ? value : null;
+}
+function when(row, key) {
+  const value = row[key];
+  if (value instanceof Date) return value.toISOString();
+  return text(row, key);
+}
+function projectInvitee(row) {
+  const operation = "meet.projectInvitee";
+  const userId = text(row, "invitee_user_id");
+  return {
+    id: requireText(row, "id", operation),
+    meetingId: asMeetingId(requireText(row, "meeting_id", operation)),
+    userId: userId === null ? null : asUserId(userId),
+    email: text(row, "email"),
+    displayName: text(row, "display_name"),
+    role: text(row, "role") === "cohost" ? "cohost" : "invitee",
+    rsvpState: rsvpState(text(row, "rsvp_state")),
+    respondedAt: when(row, "responded_at"),
+    rsvpNote: text(row, "rsvp_note"),
+    lastSentSequence: num(row, "last_sent_sequence"),
+    lastSentAt: when(row, "last_sent_at")
+  };
+}
+function projectOccurrence(row) {
+  const operation = "meet.projectOccurrence";
+  const state = text(row, "state");
+  return {
+    meetingId: asMeetingId(requireText(row, "meeting_id", operation)),
+    originalStart: when(row, "original_start") ?? requireText(row, "original_start", operation),
+    occurrenceStart: when(row, "occurrence_start") ?? requireText(row, "occurrence_start", operation),
+    durationMinutes: num(row, "duration_minutes"),
+    // An unknown state is shown as scheduled, never dropped: the row is real.
+    state: OCCURRENCE_STATES.includes(state) ? state : "scheduled",
+    sequence: num(row, "sequence") ?? 0
+  };
+}
+function projectUpcoming(row) {
+  const operation = "meet.projectUpcoming";
+  const kind = text(row, "kind");
+  const myRole = text(row, "my_role");
+  const myRsvp = text(row, "my_rsvp");
+  return {
+    ...projectOccurrence(row),
+    organizationId: asOrganizationId(requireText(row, "organization_id", operation)),
+    title: text(row, "title") ?? "Meeting",
+    slug: requireText(row, "slug", operation),
+    kind: kind === "scheduled" || kind === "recurring" ? kind : "instant",
+    hostUserId: asUserId(requireText(row, "host_user_id", operation)),
+    timeZone: text(row, "time_zone") ?? "UTC",
+    meetingCancelled: bool(row, "meeting_cancelled", false),
+    myRsvp: myRsvp === null ? null : rsvpState(myRsvp),
+    myRole: myRole === "host" || myRole === "cohost" || myRole === "invitee" ? myRole : null
+  };
+}
+function projectOverride(row) {
+  const operation = "meet.projectOverride";
+  return {
+    id: requireText(row, "id", operation),
+    meetingId: asMeetingId(requireText(row, "meeting_id", operation)),
+    originalStart: when(row, "original_start") ?? requireText(row, "original_start", operation),
+    state: text(row, "state") === "moved" ? "moved" : "cancelled",
+    newStart: when(row, "new_start"),
+    newDurationMinutes: num(row, "new_duration_minutes"),
+    reason: text(row, "reason"),
+    calendarSequence: num(row, "calendar_sequence") ?? 0,
+    deletedAt: when(row, "deleted_at")
+  };
+}
+function projectRsvpInvitation(body) {
+  const operation = "meet.projectRsvpInvitation";
+  if (typeof body !== "object" || body === null) {
+    throw invalidResponse(operation, "the RSVP door returned no object");
+  }
+  const row = body;
+  if (row["ok"] !== true) {
+    return {
+      ok: false,
+      message: text(row, "message") ?? "This invitation link is no longer valid \u2014 ask the host to send it again."
+    };
+  }
+  const meeting = row["meeting"] ?? {};
+  const invitee = row["invitee"] ?? {};
+  return {
+    ok: true,
+    meeting: {
+      title: text(meeting, "title") ?? "Meeting",
+      slug: requireText(meeting, "slug", operation),
+      scheduledFor: when(meeting, "scheduled_for"),
+      durationMinutes: num(meeting, "duration_minutes"),
+      timeZone: text(meeting, "time_zone") ?? "UTC",
+      agenda: text(meeting, "agenda"),
+      recurrenceRule: text(meeting, "recurrence_rule"),
+      cancelledAt: when(meeting, "cancelled_at"),
+      cancellationReason: text(meeting, "cancellation_reason"),
+      endedAt: when(meeting, "ended_at")
+    },
+    invitee: {
+      displayName: text(invitee, "display_name"),
+      email: text(invitee, "email"),
+      rsvpState: rsvpState(text(invitee, "rsvp_state")),
+      respondedAt: when(invitee, "responded_at")
+    }
+  };
+}
+function settingsPatch(settings) {
+  const patch = {};
+  if (settings.lobbyEnabled !== void 0) patch["lobby_enabled"] = settings.lobbyEnabled;
+  if (settings.recordingPolicy !== void 0) patch["recording_policy"] = settings.recordingPolicy;
+  if (settings.aiEnabled !== void 0) patch["ai_enabled"] = settings.aiEnabled;
+  if (settings.joinBeforeHost !== void 0) patch["join_before_host"] = settings.joinBeforeHost;
+  return patch;
+}
+function changesPatch(changes) {
+  const patch = settingsPatch(changes);
+  if (changes.title !== void 0) patch["title"] = changes.title;
+  if (changes.agenda !== void 0) patch["agenda"] = changes.agenda;
+  if (changes.timeZone !== void 0) patch["time_zone"] = changes.timeZone;
+  if (changes.scheduledFor !== void 0) patch["scheduled_for"] = changes.scheduledFor;
+  if (changes.scheduledDurationMinutes !== void 0) {
+    patch["scheduled_duration_minutes"] = changes.scheduledDurationMinutes;
+  }
+  if (changes.recurrenceRule !== void 0) patch["recurrence_rule"] = changes.recurrenceRule;
+  return patch;
+}
 function createMeetRepository(options) {
   const db = options.client.schema(MEET_SCHEMA);
   async function guardVoid(operation, run) {
@@ -1439,7 +1653,16 @@ function createMeetRepository(options) {
       lobbyEnabled: bool(row, "lobby_enabled", true),
       recordingPolicy: policy === "disabled" || policy === "always-on" ? policy : "host-controlled",
       aiEnabled: bool(row, "ai_enabled", true),
-      metadata: typeof metadata === "object" && metadata !== null && !Array.isArray(metadata) ? metadata : {}
+      metadata: typeof metadata === "object" && metadata !== null && !Array.isArray(metadata) ? metadata : {},
+      timeZone: text(row, "time_zone") ?? "UTC",
+      agenda: text(row, "agenda"),
+      recurrenceRule: text(row, "recurrence_rule"),
+      joinBeforeHost: bool(row, "join_before_host", true),
+      cancelledAt: text(row, "cancelled_at"),
+      cancellationReason: text(row, "cancellation_reason"),
+      deletedAt: text(row, "deleted_at"),
+      calendarSequence: typeof row["calendar_sequence"] === "number" ? row["calendar_sequence"] : 0,
+      version: typeof row["version"] === "number" ? row["version"] : 1
     };
   }
   function projectRecording(row) {
@@ -1526,6 +1749,170 @@ function createMeetRepository(options) {
     projectNote,
     projectRecording,
     projectAttendee,
+    projectInvitee,
+    async scheduleMeeting(input) {
+      requireOrg(input.organizationId, "meet.scheduleMeeting");
+      const row = await guard(
+        "meet.scheduleMeeting",
+        () => db.rpc(RPCS.scheduleMeeting, {
+          p_organization_id: input.organizationId,
+          p_host_user_id: input.hostUserId,
+          p_title: input.title,
+          p_scheduled_for: input.scheduledFor,
+          p_time_zone: input.timeZone,
+          p_duration_minutes: input.durationMinutes ?? null,
+          p_agenda: input.agenda ?? null,
+          p_recurrence_rule: input.recurrenceRule ?? null,
+          p_settings: settingsPatch(input.settings ?? {})
+        })
+      );
+      return projectMeeting(row);
+    },
+    async updateMeeting(meetingId, changes, options2 = {}) {
+      const row = await guard(
+        "meet.updateMeeting",
+        () => db.rpc(RPCS.updateMeeting, {
+          p_meeting_id: meetingId,
+          p_changes: changesPatch(changes),
+          p_expected_version: options2.expectedVersion ?? null,
+          p_by_user_id: options2.byUserId ?? null
+        })
+      );
+      return projectMeeting(row);
+    },
+    async cancelMeeting(meetingId, reason, byUserId = null) {
+      const row = await guard(
+        "meet.cancelMeeting",
+        () => db.rpc(RPCS.cancelMeeting, {
+          p_meeting_id: meetingId,
+          p_reason: reason,
+          p_by_user_id: byUserId
+        })
+      );
+      return projectMeeting(row);
+    },
+    async archiveMeeting(meetingId, byUserId = null) {
+      const row = await guard(
+        "meet.archiveMeeting",
+        () => db.rpc(RPCS.archiveMeeting, { p_meeting_id: meetingId, p_by_user_id: byUserId })
+      );
+      return projectMeeting(row);
+    },
+    async restoreMeeting(meetingId, byUserId = null) {
+      const row = await guard(
+        "meet.restoreMeeting",
+        () => db.rpc(RPCS.restoreMeeting, { p_meeting_id: meetingId, p_by_user_id: byUserId })
+      );
+      return projectMeeting(row);
+    },
+    async setOccurrence(args) {
+      const row = await guard(
+        "meet.setOccurrence",
+        () => db.rpc(RPCS.setOccurrence, {
+          p_meeting_id: args.meetingId,
+          p_original_start: args.originalStart,
+          p_action: args.action,
+          p_new_start: args.newStart ?? null,
+          p_new_duration_minutes: args.newDurationMinutes ?? null,
+          p_reason: args.reason ?? null,
+          p_by_user_id: args.byUserId ?? null
+        })
+      );
+      return projectOverride(row);
+    },
+    async meetingOccurrences(meetingId, { from, to, limit = 200 }) {
+      const rows = await guard(
+        "meet.meetingOccurrences",
+        () => db.rpc(RPCS.meetingOccurrences, {
+          p_meeting_id: meetingId,
+          p_from: from,
+          p_to: to,
+          p_limit: limit
+        })
+      );
+      return rows.map(projectOccurrence);
+    },
+    async occurrencesBetween({ from, to, organizationId = null, limit = 500 }) {
+      const rows = await guard(
+        "meet.occurrencesBetween",
+        () => db.rpc(RPCS.occurrencesBetween, {
+          p_from: from,
+          p_to: to,
+          p_organization_id: organizationId,
+          p_limit: limit
+        })
+      );
+      return rows.map(projectUpcoming);
+    },
+    async invitees(meetingId) {
+      const response = await db.from(TABLES.invitees).select(INVITEE_COLUMNS).eq("meeting_id", meetingId).is("deleted_at", null).order("created_at", { ascending: true }).order("id", { ascending: true });
+      if (response.error !== null) throw normalizeMeetError(response.error, "meet.invitees");
+      return (response.data ?? []).map(projectInvitee);
+    },
+    async addInvitees(meetingId, people, byUserId = null) {
+      const rows = await guard(
+        "meet.addInvitees",
+        () => db.rpc(RPCS.addInvitees, {
+          p_meeting_id: meetingId,
+          p_invitees: people.map((person) => ({
+            ...person.userId !== void 0 ? { user_id: person.userId } : {},
+            ...person.email !== void 0 ? { email: person.email } : {},
+            ...person.displayName !== void 0 ? { display_name: person.displayName } : {},
+            ...person.role !== void 0 ? { role: person.role } : {}
+          })),
+          p_by_user_id: byUserId
+        })
+      );
+      return rows.map(projectInvitee);
+    },
+    async setInviteeRole(inviteeId, role, byUserId = null) {
+      const row = await guard(
+        "meet.setInviteeRole",
+        () => db.rpc(RPCS.setInviteeRole, {
+          p_invitee_id: inviteeId,
+          p_role: role,
+          p_by_user_id: byUserId
+        })
+      );
+      return projectInvitee(row);
+    },
+    async removeInvitee(inviteeId, byUserId = null) {
+      const row = await guard(
+        "meet.removeInvitee",
+        () => db.rpc(RPCS.removeInvitee, { p_invitee_id: inviteeId, p_by_user_id: byUserId })
+      );
+      return projectInvitee(row);
+    },
+    async respond(meetingId, answer, note = null) {
+      const row = await guard(
+        "meet.respond",
+        () => db.rpc(RPCS.respond, {
+          p_meeting_id: meetingId,
+          p_response: answer,
+          p_note: note,
+          p_by_user_id: null
+        })
+      );
+      return projectInvitee(row);
+    },
+    async invitationByToken(secret) {
+      const body = await guard(
+        "meet.invitationByToken",
+        () => db.rpc(RPCS.invitationByToken, { p_secret: secret })
+      );
+      return projectRsvpInvitation(body);
+    },
+    async respondByToken(secret, answer, note = null) {
+      const body = await guard(
+        "meet.respondByToken",
+        () => db.rpc(RPCS.respondByToken, {
+          p_secret: secret,
+          p_response: answer,
+          p_note: note
+        })
+      );
+      return projectRsvpInvitation(body);
+    },
     async attendees(meetingId) {
       const response = await db.from(TABLES.participants).select(ATTENDEE_COLUMNS).eq("meeting_id", meetingId).order("joined_at", { ascending: true }).order("id", { ascending: true });
       if (response.error !== null) throw normalizeMeetError(response.error, "meet.attendees");
@@ -1707,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);
@@ -1743,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`);
   }
@@ -1834,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"];
@@ -2035,8 +2533,8 @@ function callStateLabel(state, outgoing) {
       return "Call";
   }
 }
-function countLabel(count, singular, plural = `${singular}s`) {
-  return `${count} ${count === 1 ? singular : plural}`;
+function countLabel(count2, singular, plural = `${singular}s`) {
+  return `${count2} ${count2 === 1 ? singular : plural}`;
 }
 
 // src/core/invitations.ts
@@ -2166,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);
@@ -2180,11 +2679,11 @@ function computeStage(args) {
     presenting: sharer !== null
   };
 }
-function gridColumns(count) {
-  if (count <= 1) return 1;
-  if (count <= 4) return 2;
-  if (count <= 9) return 3;
-  if (count <= 16) return 4;
+function gridColumns(count2) {
+  if (count2 <= 1) return 1;
+  if (count2 <= 4) return 2;
+  if (count2 <= 9) return 3;
+  if (count2 <= 16) return 4;
   return 5;
 }
 
@@ -2192,8 +2691,7 @@ function gridColumns(count) {
 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 = {
@@ -2254,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;
@@ -2287,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));
@@ -2364,6 +2901,7 @@ function createLiveKitDriver(handlers, options = {}) {
         throw normalizeDeviceError(error, "meet.connect");
       }
       projectRoster?.();
+      handlers.roomMetadata?.(target.metadata ?? "");
     },
     async disconnect() {
       if (room === null) return;
@@ -2378,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");
       }
@@ -2397,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];
@@ -2627,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,
@@ -2649,7 +3223,12 @@ var EMPTY = {
   recordingSource: "local",
   recordingId: null,
   chat: [],
+  chatLoaded: false,
   reactions: [],
+  spotlight: null,
+  moderationNotice: null,
+  actionNotice: null,
+  effects: DEFAULT_EFFECTS,
   transcript: [],
   notes: [],
   names: {},
@@ -2688,6 +3267,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,
@@ -2701,6 +3281,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
         }))
       });
@@ -2723,11 +3304,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
         )
       });
     },
@@ -2737,6 +3324,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, 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] });
     },
@@ -2827,7 +3439,7 @@ function createMeetStore(initial = {}) {
       commit({ ...state, media: { ...state.media, [kind]: next } });
     },
     reset() {
-      commit({ ...EMPTY });
+      commit({ ...EMPTY, effects: state.effects });
     }
   };
 }
@@ -3157,11 +3769,11 @@ function createMeetingSession(options) {
         } catch {
           body = null;
         }
-        const refusal = readServerRefusal(body);
+        const refusal2 = readServerRefusal(body);
         throw new MeetError(
           response.status === 403 ? "forbidden" : "transport",
-          refusal?.reason ?? `meet.endForEveryone: the server answered ${response.status}`,
-          refusal?.remedy !== void 0 && refusal.remedy.length > 0 ? refusal.remedy : "The meeting is still running. Only a host may end it, and the server re-checks that \u2014 being a host on this screen is not the decision."
+          refusal2?.reason ?? `meet.endForEveryone: the server answered ${response.status}`,
+          refusal2?.remedy !== void 0 && refusal2.remedy.length > 0 ? refusal2.remedy : "The meeting is still running. Only a host may end it, and the server re-checks that \u2014 being a host on this screen is not the decision."
         );
       }
       let payload = null;
@@ -3289,6 +3901,57 @@ function fileDownloadPath(fileId) {
   return `/files/${encodeURIComponent(fileId)}/download?inline=1`;
 }
 
+// src/core/management.ts
+async function refusal(response, operation) {
+  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",
+    `${operation}: ${said?.reason ?? `the server answered ${response.status}`}`,
+    said?.remedy || "The meeting itself is saved \u2014 only the telling failed. Try again; the call is idempotent."
+  );
+}
+function count(body, key) {
+  const value = body[key];
+  return typeof value === "number" ? value : 0;
+}
+async function announceMeeting(api, meetingId) {
+  const operation = "meet.announceMeeting";
+  const response = await api.request({
+    path: meetingPath(MEET_ROUTES.meetingAnnounce, meetingId),
+    method: "POST",
+    requireAuth: true,
+    operation
+  });
+  if (!response.ok) throw await refusal(response, operation);
+  const body = await response.json();
+  return {
+    invitations: count(body, "invitations"),
+    updates: count(body, "updates"),
+    cancellations: count(body, "cancellations"),
+    alreadyCurrent: count(body, "already_current"),
+    remindersQueued: count(body, "reminders_queued"),
+    remindersCancelled: count(body, "reminders_cancelled")
+  };
+}
+async function pushMeetingToGoogleCalendar(api, meetingId, target) {
+  const operation = "meet.pushMeetingToGoogleCalendar";
+  const response = await api.request({
+    path: meetingPath(MEET_ROUTES.meetingGoogleCalendar, meetingId),
+    method: "POST",
+    requireAuth: true,
+    operation,
+    body: { connection_id: target.connectionId, calendar_id: target.calendarId ?? "primary" }
+  });
+  if (!response.ok) throw await refusal(response, operation);
+  return await response.json();
+}
+
 // src/core/room.ts
 var PARTICIPANT_ROLE_ATTRIBUTE = "matrx.participant.role";
 var PARTICIPANT_CAN_RECORD_ATTRIBUTE = "matrx.participant.can_record";
@@ -3408,7 +4071,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));
@@ -3512,7 +4205,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") {
@@ -3526,12 +4223,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;
@@ -3577,6 +4276,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);
     }
@@ -3599,9 +4316,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) {
@@ -3657,7 +4395,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;
@@ -3667,32 +4405,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" });
@@ -3723,6 +4470,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) {
@@ -3863,7 +4796,7 @@ function meetingWhen(meeting, locale) {
   if (start === null) return "Time not recorded";
   const startedAt = new Date(start);
   if (Number.isNaN(startedAt.getTime())) return "Time not recorded";
-  const when = startedAt.toLocaleString(locale, {
+  const when2 = startedAt.toLocaleString(locale, {
     weekday: "long",
     year: "numeric",
     month: "long",
@@ -3871,11 +4804,11 @@ function meetingWhen(meeting, locale) {
     hour: "numeric",
     minute: "2-digit"
   });
-  if (meeting.endedAt === null || meeting.startedAt === null) return when;
+  if (meeting.endedAt === null || meeting.startedAt === null) return when2;
   const endedAt = new Date(meeting.endedAt);
-  if (Number.isNaN(endedAt.getTime())) return when;
+  if (Number.isNaN(endedAt.getTime())) return when2;
   const elapsedMs = endedAt.getTime() - startedAt.getTime();
-  return `${when} \xB7 ${(0, import_format.formatDurationMs)(elapsedMs, { style: "long" })}`;
+  return `${when2} \xB7 ${(0, import_format.formatDurationMs)(elapsedMs, { style: "long" })}`;
 }
 var GUEST_RECORD_ACCESS_LEVELS = [
   "none",
@@ -3951,8 +4884,8 @@ async function loadGuestMeetingRecord(args) {
     );
   }
   if (!response.ok) {
-    const refusal = await readRefusal(response);
-    return refusedBundle(meeting, refusal.message, refusal.remedy);
+    const refusal2 = await readRefusal(response);
+    return refusedBundle(meeting, refusal2.message, refusal2.remedy);
   }
   const body = await response.json();
   const payload = typeof body["data"] === "object" && body["data"] !== null ? body["data"] : body;
@@ -4043,8 +4976,8 @@ async function setGuestRecordAccess(args) {
     }
   });
   if (!response.ok) {
-    const refusal = await readRefusal(response);
-    throw new MeetError("forbidden", refusal.message, refusal.remedy);
+    const refusal2 = await readRefusal(response);
+    throw new MeetError("forbidden", refusal2.message, refusal2.remedy);
   }
   const body = await response.json();
   const payload = typeof body["data"] === "object" && body["data"] !== null ? body["data"] : body;