@ai-matrx/meet 0.7.2 → 0.7.5

package/dist/index.d.ts

@@ -121,6 +121,12 @@ interface MeetParticipant {
     readonly screenSharing: boolean;
     readonly speaking: boolean;
     readonly handRaised: boolean;
+    /**
+     * When the hand went up (epoch ms), or null. The HAND QUEUE is ordered by it —
+     * first raised, first called on (Meet wave 2). Optional so a roster built by a
+     * host before 0.8 still type-checks.
+     */
+    readonly handRaisedAt?: number | null | undefined;
     readonly quality: ConnectionQuality;
     readonly joinedAt: string;
     /**
@@ -151,7 +157,135 @@ interface MeetingRecord {
     readonly recordingPolicy: RecordingPolicy;
     readonly aiEnabled: boolean;
     readonly metadata: JsonObject;
-}
+    /** IANA zone the meeting's wall-clock time is authored in (`America/Los_Angeles`). */
+    readonly timeZone?: string;
+    /** Description / agenda text. */
+    readonly agenda?: string | null;
+    /** RFC 5545 RRULE subset — one row and one durable link per series. */
+    readonly recurrenceRule?: string | null;
+    /** Signed-in members and invitees may enter before a host arrives. */
+    readonly joinBeforeHost?: boolean;
+    /** Cancel is a STATE: the link still resolves and says so; nobody can join. */
+    readonly cancelledAt?: string | null;
+    readonly cancellationReason?: string | null;
+    /** Archived (soft deleted). Restorable by the host or a co-host. */
+    readonly deletedAt?: string | null;
+    /** iCalendar SEQUENCE — bumped by the database on every reschedule and on cancel. */
+    readonly calendarSequence?: number;
+    /** Row version, for the compare-and-swap in `updateMeeting`. */
+    readonly version?: number;
+}
+/** An invitee's answer. `needs_action` = not answered yet (iCalendar NEEDS-ACTION). */
+type RsvpState = "needs_action" | "accepted" | "declined" | "tentative";
+/** The answers a person can give. */
+type RsvpAnswer = Exclude<RsvpState, "needs_action">;
+/** A co-host holds host moderation through a real `iam` admin grant on the meeting. */
+type InviteeRole = "invitee" | "cohost";
+/** One person a meeting was sent to (`communication.meet_invitees`). */
+interface MeetingInvitee {
+    readonly id: string;
+    readonly meetingId: MeetingId;
+    /** Set when the person has an account — they skip the waiting room and answer in-app. */
+    readonly userId: UserId | null;
+    readonly email: string | null;
+    readonly displayName: string | null;
+    readonly role: InviteeRole;
+    readonly rsvpState: RsvpState;
+    readonly respondedAt: string | null;
+    readonly rsvpNote: string | null;
+    /** The calendar_sequence of the last invitation they were sent; null = never told. */
+    readonly lastSentSequence: number | null;
+    readonly lastSentAt: string | null;
+}
+/** Who to invite: an account (`userId`) or an address (`email`), or both. */
+interface InviteeInput {
+    readonly userId?: UserId | undefined;
+    readonly email?: string | undefined;
+    readonly displayName?: string | undefined;
+    /** Omit to keep an existing invitee's role; `cohost` needs the host or a co-host. */
+    readonly role?: InviteeRole | undefined;
+}
+/** Where one occurrence of a meeting stands. */
+type OccurrenceState = "scheduled" | "moved" | "cancelled";
+/** One occurrence — for a one-off meeting, the meeting itself. */
+interface MeetingOccurrence {
+    readonly meetingId: MeetingId;
+    /** The start the rule generates (iCalendar RECURRENCE-ID). The key for exceptions. */
+    readonly originalStart: string;
+    /** When it actually happens (differs from `originalStart` only when `moved`). */
+    readonly occurrenceStart: string;
+    readonly durationMinutes: number | null;
+    readonly state: OccurrenceState;
+    readonly sequence: number;
+}
+/** One row of the Upcoming list — an occurrence plus what the list shows about its meeting. */
+interface UpcomingOccurrence extends MeetingOccurrence {
+    readonly organizationId: OrganizationId;
+    readonly title: string;
+    readonly slug: string;
+    readonly kind: MeetingKind;
+    readonly hostUserId: UserId;
+    readonly timeZone: string;
+    readonly meetingCancelled: boolean;
+    /** The signed-in reader's own answer, when they are an invitee. */
+    readonly myRsvp: RsvpState | null;
+    /** `host`, `cohost` or `invitee` — null when the reader simply can see it (org member). */
+    readonly myRole: "host" | InviteeRole | null;
+}
+/** An exception row (`communication.meet_occurrence_overrides`). */
+interface OccurrenceOverride {
+    readonly id: string;
+    readonly meetingId: MeetingId;
+    readonly originalStart: string;
+    readonly state: "cancelled" | "moved";
+    readonly newStart: string | null;
+    readonly newDurationMinutes: number | null;
+    readonly reason: string | null;
+    readonly calendarSequence: number;
+    /** Set when the exception was withdrawn (`restore`) and the occurrence is back on schedule. */
+    readonly deletedAt: string | null;
+}
+/** Settings a meeting carries; unset ones come from the person's / organization's knobs. */
+interface MeetingSettings {
+    readonly lobbyEnabled?: boolean | undefined;
+    readonly recordingPolicy?: RecordingPolicy | undefined;
+    readonly aiEnabled?: boolean | undefined;
+    readonly joinBeforeHost?: boolean | undefined;
+}
+/** A partial edit. `null` clears a clearable field (agenda, recurrence rule, time). */
+interface MeetingChanges extends MeetingSettings {
+    readonly title?: string | undefined;
+    readonly agenda?: string | null | undefined;
+    readonly timeZone?: string | undefined;
+    readonly scheduledFor?: string | null | undefined;
+    readonly scheduledDurationMinutes?: number | null | undefined;
+    readonly recurrenceRule?: string | null | undefined;
+}
+/** What the emailed RSVP link shows and answers (no account needed). */
+type RsvpInvitation = {
+    readonly ok: true;
+    readonly meeting: {
+        readonly title: string;
+        readonly slug: string;
+        readonly scheduledFor: string | null;
+        readonly durationMinutes: number | null;
+        readonly timeZone: string;
+        readonly agenda: string | null;
+        readonly recurrenceRule: string | null;
+        readonly cancelledAt: string | null;
+        readonly cancellationReason: string | null;
+        readonly endedAt: string | null;
+    };
+    readonly invitee: {
+        readonly displayName: string | null;
+        readonly email: string | null;
+        readonly rsvpState: RsvpState;
+        readonly respondedAt: string | null;
+    };
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
 /** Org-configurable, never hardcoded taste (Law 6 / "opinions become knobs"). */
 type RecordingPolicy = "disabled" | "host-controlled" | "always-on";
 type RecordingState = "idle" | "starting" | "recording" | "stopping" | "processing" | "available"
@@ -549,7 +683,9 @@ declare function displayNameFor(book: NameBook, identity: ParticipantIdentity |
  * "media-error" would make the UI say the wrong sentence three times out of
  * four.
  */
-type MeetErrorCode = "session-unavailable" | "forbidden" | "not-found" | "conflict" | "token" | "transport" | "invalid-response" | "misconfigured" | "permission-denied" | "device-not-found" | "device-in-use" | "insecure-context" | "media-unsupported" | "room-locked" | "lobby-denied" | "capacity" | "unknown";
+type MeetErrorCode = "session-unavailable" | "forbidden" | "not-found" | "conflict" | "token" | "transport" | "invalid-response" | "misconfigured" | "permission-denied" | "device-not-found" | "device-in-use" | "insecure-context" | "media-unsupported" | "room-locked" | "lobby-denied" | "capacity"
+/** Meet wave 1: the meeting was cancelled — its link resolves, its room never opens. */
+ | "cancelled" | "unknown";
 declare class MeetError extends Error {
     readonly code: MeetErrorCode;
     /** What to DO. Rendered to the user for the device codes. */
@@ -751,7 +887,33 @@ interface RoomChatMessage {
     readonly displayName: string;
     readonly text: string;
     readonly at: string;
+    /**
+     * Set for a PRIVATE message: the one identity it was addressed to (from the
+     * sender's side) or this participant (from the receiver's). Private messages
+     * travel the data plane only and are never saved (Meet wave 2).
+     */
+    readonly to?: ParticipantIdentity | null | undefined;
+    /** True once the server has SAVED it — a message everyone sees, late joiners too. */
+    readonly saved?: boolean | undefined;
+    /** A send the server refused, with its sentence. The message stays visible, marked. */
+    readonly failed?: string | undefined;
+}
+/**
+ * A HOST ACTED ON *ME* (Meet wave 2) — the server's own `matrx.meet.moderation`
+ * packet, addressed to this participant. Rendered once, dismissible, in words.
+ */
+interface ModerationNotice {
+    readonly kind: "muted" | "ask-unmute" | "removed" | "role";
+    readonly text: string;
+    readonly at: number;
+}
+/** What this participant chose for their own media. Remembered per browser. */
+interface MediaEffects {
+    readonly noiseSuppression: boolean;
+    readonly background: "none" | "blur" | "image";
+    readonly backgroundImage: string | null;
 }
+declare const DEFAULT_EFFECTS: MediaEffects;
 interface RoomReaction {
     readonly id: string;
     readonly identity: ParticipantIdentity;
@@ -811,7 +973,27 @@ interface MeetSnapshot {
      */
     readonly recordingId: string | null;
     readonly chat: readonly RoomChatMessage[];
+    /** Whether the SAVED chat has been read for this meeting (late joiners see history). */
+    readonly chatLoaded: boolean;
     readonly reactions: readonly RoomReaction[];
+    /**
+     * The participant a HOST spotlighted for everyone, from the room's metadata
+     * (server-set, delivered on join). A local pin outranks it on this screen only.
+     */
+    readonly spotlight: ParticipantIdentity | null;
+    /** The last thing a host did to THIS participant, in words. Dismissible. */
+    readonly moderationNotice: ModerationNotice | null;
+    /**
+     * The server's answer to the last host action THIS participant took ("Muted 3
+     * people", or the refusal). One place, so whichever surface acted — a tile's
+     * menu, the People panel, More options — the sentence survives the menu closing.
+     */
+    readonly actionNotice: {
+        readonly text: string;
+        readonly failed: boolean;
+        readonly at: number;
+    } | null;
+    readonly effects: MediaEffects;
     /**
      * Captions AND durable rows, reconciled into one list (D16). A record
      * replaces the caption it supersedes; a caption never overwrites a record.
@@ -859,8 +1041,18 @@ interface MeetStore {
     setParticipants(participants: readonly MeetParticipant[]): void;
     setSpeaking(identities: readonly ParticipantIdentity[]): void;
     setQuality(identity: ParticipantIdentity, quality: ConnectionQuality): void;
-    setHand(identity: ParticipantIdentity, raised: boolean): void;
+    /**
+     * Raise or lower a hand. `at` is WHEN it went up, which is the hand queue's
+     * order — first raised, first called on, the way Meet orders it.
+     */
+    setHand(identity: ParticipantIdentity, raised: boolean, at?: number): void;
     addChat(message: RoomChatMessage): void;
+    /** The saved chat, read once per join. Merged with anything that arrived live. */
+    loadChat(messages: readonly RoomChatMessage[]): void;
+    /** Replace a pending message (by id) with what the server saved, or mark it failed. */
+    settleChat(localId: string, next: RoomChatMessage | {
+        failed: string;
+    }): void;
     addReaction(reaction: RoomReaction): void;
     /** Drops reactions past their TTL. Called by the UI's animation frame. */
     expireReactions(now: number): void;
@@ -1105,6 +1297,10 @@ declare const TABLES: {
     readonly recordings: "meet_recordings";
     readonly transcripts: "meet_transcript_segments";
     readonly notes: "meet_notes";
+    /** Wave 1 (0.8): who a meeting was sent to, and what they answered. */
+    readonly invitees: "meet_invitees";
+    /** Wave 1 (0.8): one occurrence of a series cancelled or moved. */
+    readonly occurrenceOverrides: "meet_occurrence_overrides";
 };
 declare const RPCS: {
     /** Atomic: create the invite row and stamp its expiry in one statement. */
@@ -1121,6 +1317,29 @@ declare const RPCS: {
     readonly setLock: "meet_set_lock";
     readonly endMeeting: "meet_end_meeting";
     readonly recordConsent: "meet_record_consent";
+    /** Schedule with every setting at create; unset settings come from the knobs. */
+    readonly scheduleMeeting: "meet_schedule_meeting";
+    /** Edit / reschedule — a JSON patch with a version compare-and-swap. */
+    readonly updateMeeting: "meet_update_meeting";
+    /** Cancel is a state (`cancelled_at`); the link keeps resolving. */
+    readonly cancelMeeting: "meet_cancel_meeting";
+    /** Archive (soft delete) — the invitations and exceptions cascade. */
+    readonly archiveMeeting: "meet_archive_meeting";
+    readonly restoreMeeting: "meet_restore_meeting";
+    /** Cancel, move or restore ONE occurrence of a series by its original start. */
+    readonly setOccurrence: "meet_set_occurrence";
+    readonly addInvitees: "meet_add_invitees";
+    readonly setInviteeRole: "meet_set_invitee_role";
+    readonly removeInvitee: "meet_remove_invitee";
+    /** A signed-in invitee answers for themselves. */
+    readonly respond: "meet_respond";
+    /** The emailed RSVP link (no account): read and answer. */
+    readonly invitationByToken: "meet_invitation_by_token";
+    readonly respondByToken: "meet_respond_by_token";
+    /** One meeting's occurrences between two instants (INVOKER — the reader's RLS). */
+    readonly meetingOccurrences: "meet_meeting_occurrences";
+    /** Every occurrence the reader can see between two instants — the Upcoming list. */
+    readonly occurrencesBetween: "meet_occurrences_between";
 };
 type Row = Record<string, unknown>;
 interface CreateCallInviteInput {
@@ -1207,6 +1426,58 @@ interface MeetRepository {
         acknowledgedAt: string;
     }): Promise<void>;
     recordings(meetingId: MeetingId): Promise<readonly RecordingRecord[]>;
+    scheduleMeeting(input: ScheduleMeetingInput): Promise<MeetingRecord>;
+    /** `expectedVersion` from the row you edited; a stale one is a `conflict`. */
+    updateMeeting(meetingId: MeetingId, changes: MeetingChanges, options?: {
+        expectedVersion?: number | null;
+        byUserId?: UserId | null;
+    }): Promise<MeetingRecord>;
+    cancelMeeting(meetingId: MeetingId, reason: string | null, byUserId?: UserId | null): Promise<MeetingRecord>;
+    archiveMeeting(meetingId: MeetingId, byUserId?: UserId | null): Promise<MeetingRecord>;
+    restoreMeeting(meetingId: MeetingId, byUserId?: UserId | null): Promise<MeetingRecord>;
+    setOccurrence(args: {
+        meetingId: MeetingId;
+        originalStart: string;
+        action: "cancel" | "move" | "restore";
+        newStart?: string | null;
+        newDurationMinutes?: number | null;
+        reason?: string | null;
+        byUserId?: UserId | null;
+    }): Promise<OccurrenceOverride>;
+    meetingOccurrences(meetingId: MeetingId, range: {
+        from: string;
+        to: string;
+        limit?: number;
+    }): Promise<readonly MeetingOccurrence[]>;
+    /** The Upcoming list: every occurrence the reader may see. `organizationId` FILTERS; RLS decides. */
+    occurrencesBetween(range: {
+        from: string;
+        to: string;
+        organizationId?: OrganizationId | null;
+        limit?: number;
+    }): Promise<readonly UpcomingOccurrence[]>;
+    invitees(meetingId: MeetingId): Promise<readonly MeetingInvitee[]>;
+    addInvitees(meetingId: MeetingId, people: readonly InviteeInput[], byUserId?: UserId | null): Promise<readonly MeetingInvitee[]>;
+    setInviteeRole(inviteeId: string, role: InviteeRole, byUserId?: UserId | null): Promise<MeetingInvitee>;
+    removeInvitee(inviteeId: string, byUserId?: UserId | null): Promise<MeetingInvitee>;
+    respond(meetingId: MeetingId, answer: RsvpAnswer, note?: string | null): Promise<MeetingInvitee>;
+    invitationByToken(secret: string): Promise<RsvpInvitation>;
+    respondByToken(secret: string, answer: RsvpAnswer, note?: string | null): Promise<RsvpInvitation>;
+    projectInvitee(row: Row): MeetingInvitee;
+}
+interface ScheduleMeetingInput {
+    readonly organizationId: OrganizationId;
+    readonly hostUserId: UserId;
+    readonly title: string;
+    readonly scheduledFor: string | null;
+    /** IANA zone, e.g. `America/Los_Angeles`. The wall-clock time a series keeps across DST. */
+    readonly timeZone: string;
+    /** Omit to use the person's `meet.default_duration_minutes`. */
+    readonly durationMinutes?: number | null | undefined;
+    readonly agenda?: string | null | undefined;
+    /** RRULE subset: FREQ=DAILY|WEEKLY|MONTHLY, INTERVAL, BYDAY, BYMONTHDAY, COUNT, UNTIL. */
+    readonly recurrenceRule?: string | null | undefined;
+    readonly settings?: MeetingSettings | undefined;
 }
 interface RepositoryOptions {
     /**
@@ -1234,6 +1505,19 @@ interface RepositoryOptions {
  */
 declare function projectSegment(row: Row): TranscriptSegment;
 declare function projectNote(row: Row): MeetingNote;
+declare function projectInvitee(row: Row): MeetingInvitee;
+declare function projectOccurrence(row: Row): MeetingOccurrence;
+declare function projectUpcoming(row: Row): UpcomingOccurrence;
+declare function projectOverride(row: Row): OccurrenceOverride;
+/** The jsonb the RSVP doors return, typed. A body that is neither shape is refused loudly. */
+declare function projectRsvpInvitation(body: unknown): RsvpInvitation;
+/** Settings → the door's snake_case object, carrying ONLY what was set. */
+declare function settingsPatch(settings: MeetingSettings): Record<string, unknown>;
+/**
+ * A partial edit → the `meet_update_meeting` patch. `undefined` = leave alone,
+ * `null` = clear — the difference a JSON patch exists to carry.
+ */
+declare function changesPatch(changes: MeetingChanges): Record<string, unknown>;
 declare function createMeetRepository(options: RepositoryOptions): MeetRepository;
 
 /**
@@ -1426,6 +1710,18 @@ declare const ROOM_EVENTS: {
      * host recorded (MRI-C8).
      */
     readonly 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 } }`.
+     */
+    readonly 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.
+     */
+    readonly moderation: "matrx.meet.moderation";
 };
 type RoomEventTopic = (typeof ROOM_EVENTS)[keyof typeof ROOM_EVENTS];
 declare function isRoomEventTopic(topic: string): boolean;
@@ -1667,6 +1963,11 @@ interface StageArgs {
     readonly layout: StageLayout;
     readonly pinned: ParticipantIdentity | null;
     readonly activeSpeakers: readonly ParticipantIdentity[];
+    /**
+     * The participant a HOST spotlighted for everyone (Meet wave 2). A local pin
+     * outranks it on this screen; a screen share outranks both.
+     */
+    readonly spotlight?: ParticipantIdentity | null | undefined;
     /** How many tiles this viewport can honestly render. Default 12. */
     readonly pageSize?: number;
     readonly page?: number;
@@ -1767,6 +2068,29 @@ interface RoomDriverHandlers {
     transcription(event: DriverTranscription): void;
     /** The room ended for this client. `reason` is shown to the user verbatim. */
     disconnected(reason: string | null): void;
+    /**
+     * The ROOM's metadata — set only by the server (`UpdateRoomMetadata`), and
+     * delivered to every joiner ON JOIN, which is why the spotlight rides it: a
+     * data packet reaches only the people already in the room. Called once after
+     * connect and on every change. Optional so an older host driver still works.
+     */
+    roomMetadata?(metadata: string): void;
+}
+/** A camera background effect. `image` replaces the background with `imageUrl`. */
+type VideoEffect = {
+    readonly kind: "none";
+} | {
+    readonly kind: "blur";
+    readonly radius?: number;
+} | {
+    readonly kind: "image";
+    readonly imageUrl: string;
+};
+/** Microphone processing the browser applies before anything is sent. */
+interface AudioProcessing {
+    readonly noiseSuppression: boolean;
+    readonly echoCancellation: boolean;
+    readonly autoGainControl: boolean;
 }
 interface MeetRoomDriver {
     connect(serverUrl: string, token: string): Promise<void>;
@@ -1774,8 +2098,23 @@ interface MeetRoomDriver {
     setMicrophoneEnabled(enabled: boolean): Promise<void>;
     setCameraEnabled(enabled: boolean): Promise<void>;
     setScreenShareEnabled(enabled: boolean): Promise<void>;
-    /** Reliable, topic-addressed data. The in-room control plane. */
-    publishData(topic: string, payload: string): Promise<void>;
+    /**
+     * Reliable, topic-addressed data. The in-room control plane. `to` addresses
+     * named identities only (a private chat message); absent = everyone.
+     */
+    publishData(topic: string, payload: string, to?: readonly string[]): Promise<void>;
+    /**
+     * Apply microphone processing to the live track and to every future one.
+     * Optional: a driver without it makes the control ABSENT, never dead.
+     */
+    setAudioProcessing?(processing: AudioProcessing): Promise<void>;
+    /**
+     * Apply a background effect to the live camera and to every future one.
+     * Rejects with a sentence when this browser cannot run it.
+     */
+    setVideoEffect?(effect: VideoEffect): Promise<void>;
+    /** Whether this browser can run background effects at all. */
+    supportsVideoEffects?(): boolean;
     /**
      * Attach a participant's track to a media element. Returns the detach
      * function — returning it (rather than exposing `detach`) is what makes a
@@ -1793,7 +2132,6 @@ declare const DATA_TOPICS: {
     readonly hand: "mx.hand";
     readonly reaction: "mx.reaction";
     readonly chat: "mx.chat";
-    readonly hostAction: "mx.host";
 };
 /**
  * 🚨 `mx.ai.note` and `mx.ai.transcript` WERE declared here and emitted by
@@ -2017,6 +2355,39 @@ declare function createRecordingController(options: RecordingControllerOptions):
 /** The indicator's words. One definition, so no surface invents a softer one. */
 declare function recordingLabel(state: RecordingState): string | null;
 
+/**
+ * MEET WAVE 1 — the two server calls a management screen makes (0.8).
+ *
+ * Every WRITE (schedule, edit, reschedule, cancel, archive, occurrence change,
+ * invite, answer) goes straight to the database through `MeetRepository` — the
+ * database decides who may. What a browser cannot do is send an email with a
+ * calendar object in it, so after any of those writes a screen calls
+ * `announceMeeting`: the server tells each invitee exactly what they have not
+ * been told (invitation, update or cancellation, each with its `.ics`), and
+ * re-queues reminders. It is idempotent — call it after every save.
+ */
+
+interface AnnounceResult {
+    readonly invitations: number;
+    readonly updates: number;
+    readonly cancellations: number;
+    readonly alreadyCurrent: number;
+    readonly remindersQueued: number;
+    readonly remindersCancelled: number;
+}
+/** Bring every invitee's inbox and calendar up to date. The host, a co-host or an editor. */
+declare function announceMeeting(api: MeetApi, meetingId: MeetingId): Promise<AnnounceResult>;
+/**
+ * Put a one-off meeting on the caller's own connected Google Calendar. GATED by
+ * the server to Google's review accounts while the Calendar scope is in review —
+ * a refusal is a `forbidden` MeetError carrying the server's sentence. Everyone
+ * already gets the meeting into any calendar through the invitation's `.ics`.
+ */
+declare function pushMeetingToGoogleCalendar(api: MeetApi, meetingId: MeetingId, target: {
+    connectionId: string;
+    calendarId?: string;
+}): Promise<Record<string, unknown>>;
+
 /**
  * THE TOKEN FLOW — the ONLY authorization path into a room (R1).
  *
@@ -2165,7 +2536,26 @@ declare const MEET_ROUTES: {
     readonly record: "/api/v1/meet/record";
     /** A host chooses what guests may read of ONE meeting (MRF-1). */
     readonly 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`.
+     */
+    readonly meetingAnnounce: "/api/v1/meet/meetings/{meeting_id}/announce";
+    /** Put a one-off meeting on the caller's own Google Calendar (gated by the server). */
+    readonly 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`.
+     */
+    readonly moderate: "/api/v1/meet/moderate";
+    /** Meet wave 2: the SAVED chat — `POST` sends to everyone, `GET ?meeting_id=` reads history. */
+    readonly chat: "/api/v1/meet/chat";
 };
+/** A `MEET_ROUTES` template with its `{meeting_id}` filled in, URL-encoded. */
+declare function meetingPath(template: string, meetingId: string): string;
 /** The header the guest's pass rides on. Pinned on both sides. */
 declare const ROOM_TOKEN_HEADER = "x-meet-room-token";
 declare function parseRoomToken(body: unknown, roomName: RoomName): RoomToken;
@@ -2223,6 +2613,15 @@ interface RoomEngineOptions {
     /** Fired when the local participant leaves for any reason, including kicked. */
     onLeft?: ((reason: string | null) => void) | undefined;
     now?: (() => number) | undefined;
+    /** Remembered noise suppression / background choice (Meet wave 2). */
+    effectsStorage?: EffectsStorage | undefined;
+    /**
+     * The device the person PICKED for each kind (the pre-join pickers, the
+     * settings panel). Applied before any track is created — through 0.7.x the
+     * pickers stored a choice nothing ever read, so every join used the browser
+     * default whatever the screen said.
+     */
+    resolveDevice?: ((kind: "audioinput" | "videoinput" | "audiooutput") => string | null) | undefined;
 }
 interface RoomEngine {
     join(request: JoinRequest): Promise<void>;
@@ -2243,31 +2642,33 @@ interface RoomEngine {
     setScreenShareEnabled(enabled: boolean): Promise<void>;
     raiseHand(raised: boolean): Promise<void>;
     react(emoji: string): Promise<void>;
-    sendChat(text: string): Promise<void>;
-    /** Host-only in effect: the server ignores an unauthorized host action. */
-    publishHostAction(action: HostAction): Promise<void>;
+    /**
+     * A PRIVATE message to one person (Meet wave 2). Data plane only, addressed
+     * to that identity, NEVER saved — see `core/chat.ts` for the saved,
+     * everyone-chat, which goes through the server.
+     */
+    sendPrivateChat(to: ParticipantIdentity, text: string): Promise<void>;
+    /**
+     * Change this participant's own media processing — noise suppression and the
+     * camera background — on the live tracks, and remember it in this browser.
+     * A refused effect is a diagnostic and a revert, never a lost camera.
+     */
+    setEffects(next: Partial<MediaEffects>): Promise<void>;
+    /** Whether this browser can run a background effect at all (absent, never dead). */
+    supportsVideoEffects(): boolean;
+    /** Choose the speaker (audio output) for this meeting. */
+    switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
     pin(identity: ParticipantIdentity | null): void;
     setLayout(layout: StageLayout): void;
     attach(identity: ParticipantIdentity, kind: "camera" | "microphone" | "screen", element: HTMLMediaElement): () => void;
     token(): RoomToken | null;
     dispose(): Promise<void>;
 }
-type HostAction = {
-    readonly kind: "mute";
-    readonly identity: ParticipantIdentity;
-} | {
-    readonly kind: "request-unmute";
-    readonly identity: ParticipantIdentity;
-} | {
-    readonly kind: "remove";
-    readonly identity: ParticipantIdentity;
-} | {
-    readonly kind: "spotlight";
-    readonly identity: ParticipantIdentity | null;
-} | {
-    readonly kind: "lock";
-    readonly locked: boolean;
-};
+/** Where this browser keeps a participant's media choices. */
+interface EffectsStorage {
+    load(): MediaEffects;
+    save(effects: MediaEffects): void;
+}
 /**
  * 🚨 THE SERVER'S WORD, ON TWO CARRIERS (MRI-A11, feedback `7418ef78`).
  *
@@ -2295,6 +2696,63 @@ declare function createRoomEngine(options: RoomEngineOptions): RoomEngine;
 declare function canModerate(participant: MeetParticipant | undefined): boolean;
 declare function hostUserIds(participants: readonly MeetParticipant[]): readonly UserId[];
 
+/**
+ * A PARTICIPANT'S OWN MEDIA CHOICES, REMEMBERED (Meet wave 2).
+ *
+ * Noise suppression and the camera background are personal and per device —
+ * Zoom and Meet both remember them — so they live in this browser, never on a
+ * server. Blocked storage means the defaults (suppression on, no background),
+ * never a failed join.
+ */
+
+declare function createWebEffectsStorage(key?: string): EffectsStorage;
+
+/**
+ * THE IN-ROOM SERVER CALLS (Meet wave 2) — host moderation and the SAVED chat.
+ *
+ * 🚨 **Why these are server calls and not data packets.** Through 0.7.x a host's
+ * "Mute" and "Remove" were published on the room's data plane (`mx.host`) and
+ * nothing anywhere listened: the buttons did nothing. A client cannot be the
+ * authority on host power, and a guest cannot write the database. So both go to
+ * aidream (`POST /v1/meet/moderate`, `POST|GET /v1/meet/chat`), which decides the
+ * actor's role from the meeting itself, performs the act through LiveKit's server
+ * API, writes what is durable, and tells the room on its own `matrx.meet.*` topic.
+ *
+ * A guest proves who they are with the room pass this server signed for them, in
+ * `x-meet-room-token` — a header, never a URL.
+ */
+
+/** Every host power the server performs. One vocabulary with `services/meet/moderation.py`. */
+type ModerationAction = "mute" | "stop_video" | "stop_screen" | "mute_all" | "ask_unmute" | "ask_all_unmute" | "spotlight" | "lower_hand" | "lower_all_hands" | "make_cohost" | "revoke_cohost" | "transfer_host" | "rename" | "remove" | "report";
+declare const MODERATION_ACTIONS: readonly ModerationAction[];
+interface ModerationRequest {
+    readonly action: ModerationAction;
+    readonly identity?: ParticipantIdentity | null | undefined;
+    readonly name?: string | undefined;
+    readonly reason?: string | undefined;
+}
+interface ModerationResult {
+    readonly action: ModerationAction;
+    readonly affected: readonly string[];
+    /** The server's sentence for the actor. */
+    readonly message: string;
+}
+interface InRoomClient {
+    moderate(request: ModerationRequest): Promise<ModerationResult>;
+    /** Send a message to EVERYONE. Saved; shows at once as pending, then as saved. */
+    sendChat(text: string): Promise<void>;
+    /** Read the saved chat once per join, so a late joiner sees what was said. */
+    loadChat(): Promise<void>;
+}
+interface InRoomClientOptions {
+    api: MeetApi;
+    store: MeetStore;
+    /** The room pass for THIS meeting, or null (a signed-in member needs none). */
+    resolveRoomToken: () => string | null;
+    now?: (() => number) | undefined;
+}
+declare function createInRoomClient(options: InRoomClientOptions): InRoomClient;
+
 /**
  * THE MEETING RECORD — what a meeting IS once the room is gone (MRI-D2).
  *
@@ -2489,4 +2947,4 @@ declare function setGuestRecordAccess(args: {
 /** What a guest is told when the level shares nothing. Rendered, never hidden. */
 declare const GUEST_RECORD_NOT_SHARED: Readonly<Record<"recording" | "transcript" | "notes" | "attendance", string>>;
 
-export { type AccessTokenSource, type AdmissionState, type ApplyRoomEventArgs, type AskArgs, CALL_INVITE_KIND, CALL_INVITE_VERSION, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, type CallId, type CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, type CallMode, type CallState, type CallablePerson, type ConnectionQuality, type CreateCallInviteInput, type CreateMeetingInput, DATA_TOPICS, DEFAULT_PAGE_SIZE, type DataTopic, type DeviceKind, type DeviceManager, type DeviceManagerOptions, type DeviceSnapshot, type DeviceStorage, type DriverConnectionState, type DriverParticipant, type DriverTrackKind, type DriverTranscription, END_MEETING_NOT_SERVED, type EndMeetingResult, FILE_SESSION_PATH, GUEST_RECORD_ACCESS_CHOICES, GUEST_RECORD_ACCESS_LEVELS, GUEST_RECORD_ACCESS_METADATA_KEY, GUEST_RECORD_NOT_SHARED, type GuestRecordAccess, type GuestRecordAccessResolution, type GuestRecordAccessSetting, type HostAction, IDLE_MEDIA, IDLE_TRACK, type JoinRequest, type JsonObject, type JsonValue, LISTEN_ONLY_NOTICE, type LiveKitDriverOptions, type LobbyEntry, type LocalMediaState, type LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEET_ANSWER_CONTEXT_EVENT, MEET_ANSWER_EVENTS, MEET_EVENTS, MEET_ROUTES, MEET_SCHEMA, type MediaDevicesLike, type MediaUnavailable, type MeetAi, type MeetAiAnswer, type MeetAiOptions, type MeetAnswerCoverage, type MeetApi, type MeetApiOptions, type MeetApiRequest, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetFileMedia, type MeetGrants, type MeetIdentity, type MeetParticipant, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, type MeetingAttendee, type MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, type MeetingKind, type MeetingNote, type MeetingNoteKind, type MeetingRecord, type MeetingRecordBundle, type MeetingRecordRestriction, type MeetingSession, type MeetingSessionOptions, NOTE_TAKER_IDENTITY_PREFIX, NOTE_TAKER_METADATA_KEY, NO_GRANTS, type NameBook, type NoteTakerDispatch, type NoteTakerRefusal, type NoteTakerState, type NoteTakerStatus, ORGANIZATION_HEADER, type OrganizationId, PARTICIPANT_CAN_RECORD_ATTRIBUTE, PARTICIPANT_ROLE_ATTRIBUTE, type ParticipantIdentity, type ParticipantRole, REACTION_TTL_MS, REFUSED_ABSENCE, ROLE_RANK, ROOM_EVENTS, ROOM_EVENT_PREFIX, ROOM_TOKEN_HEADER, RPCS, type RecordingController, type RecordingControllerOptions, type RecordingPolicy, type RecordingRecord, type RecordingState, type RepositoryOptions, type RoomChatMessage, type RoomDriverFactory, type RoomDriverHandlers, type RoomEngine, type RoomEngineOptions, type RoomEventOutcome, type RoomEventTopic, type RoomName, type RoomPhase, type RoomReaction, type RoomToken, type RoomTokenStorage, type Stage, type StageArgs, type StageLayout, TABLES, TRANSCRIPTION_ATTRIBUTES, TRANSCRIPTION_TOPIC, type TokenClient, type TokenClientOptions, type TokenRequest, type TranscriptBlock, type TranscriptSegment, type TranscriptSource, type UserId, type WrapUpAnnouncement, absenceSentence, applyRoomEvent, asCallId, asMeetingId, asOrganizationId, asParticipantIdentity, asRoomName, asUserId, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, computeStage, countLabel, createCallCenter, createCallInviteHandler, createDeviceManager, createLiveKitDriver, createMeetAi, createMeetApi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingSession, createMemoryDeviceStorage, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebRoomTokenStorage, displayNameFor, fileDownloadPath, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, invalidResponse, isGuest, isGuestIdentity, isHostRole, isListenOnly, isNoteTaker, isRealName, isRoomEventTopic, learnName, learnNames, listenOnlyNotice, loadGuestMeetingRecord, loadMeetingRecord, mapConnectionState, mapQuality, meetingInviteAction, meetingLink, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeRecord, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, orderParticipants, parseRoomToken, participantSummary, playableRecordingFileId, projectNote, projectParticipant, projectSegment, readServerRefusal, readableTranscript, recordingLabel, recordingNotice, roleOf, roomTopic, setGuestRecordAccess, snapshotParticipant, unavailableFrom, userTopic, wasRefused };
+export { type AccessTokenSource, type AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, type CallId, type CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, type CallMode, type CallState, type CallablePerson, type ConnectionQuality, type CreateCallInviteInput, type CreateMeetingInput, DATA_TOPICS, DEFAULT_EFFECTS, DEFAULT_PAGE_SIZE, type DataTopic, type DeviceKind, type DeviceManager, type DeviceManagerOptions, type DeviceSnapshot, type DeviceStorage, type DriverConnectionState, type DriverParticipant, type DriverTrackKind, type DriverTranscription, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, FILE_SESSION_PATH, GUEST_RECORD_ACCESS_CHOICES, GUEST_RECORD_ACCESS_LEVELS, GUEST_RECORD_ACCESS_METADATA_KEY, GUEST_RECORD_NOT_SHARED, type GuestRecordAccess, type GuestRecordAccessResolution, type GuestRecordAccessSetting, IDLE_MEDIA, IDLE_TRACK, type InRoomClient, type InRoomClientOptions, type InviteeInput, type InviteeRole, type JoinRequest, type JsonObject, type JsonValue, LISTEN_ONLY_NOTICE, type LiveKitDriverOptions, type LobbyEntry, type LocalMediaState, type LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEET_ANSWER_CONTEXT_EVENT, MEET_ANSWER_EVENTS, MEET_EVENTS, MEET_ROUTES, MEET_SCHEMA, MODERATION_ACTIONS, type MediaDevicesLike, type MediaEffects, type MediaUnavailable, type MeetAi, type MeetAiAnswer, type MeetAiOptions, type MeetAnswerCoverage, type MeetApi, type MeetApiOptions, type MeetApiRequest, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetFileMedia, type MeetGrants, type MeetIdentity, type MeetParticipant, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, type MeetingAttendee, type MeetingChanges, type MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, type MeetingInvitee, type MeetingKind, type MeetingNote, type MeetingNoteKind, type MeetingOccurrence, type MeetingRecord, type MeetingRecordBundle, type MeetingRecordRestriction, type MeetingSession, type MeetingSessionOptions, type MeetingSettings, type ModerationAction, type ModerationNotice, type ModerationRequest, type ModerationResult, NOTE_TAKER_IDENTITY_PREFIX, NOTE_TAKER_METADATA_KEY, NO_GRANTS, type NameBook, type NoteTakerDispatch, type NoteTakerRefusal, type NoteTakerState, type NoteTakerStatus, ORGANIZATION_HEADER, type OccurrenceOverride, type OccurrenceState, type OrganizationId, PARTICIPANT_CAN_RECORD_ATTRIBUTE, PARTICIPANT_ROLE_ATTRIBUTE, type ParticipantIdentity, type ParticipantRole, REACTION_TTL_MS, REFUSED_ABSENCE, ROLE_RANK, ROOM_EVENTS, ROOM_EVENT_PREFIX, ROOM_TOKEN_HEADER, RPCS, type RecordingController, type RecordingControllerOptions, type RecordingPolicy, type RecordingRecord, type RecordingState, type RepositoryOptions, type RoomChatMessage, type RoomDriverFactory, type RoomDriverHandlers, type RoomEngine, type RoomEngineOptions, type RoomEventOutcome, type RoomEventTopic, type RoomName, type RoomPhase, type RoomReaction, type RoomToken, type RoomTokenStorage, type RsvpAnswer, type RsvpInvitation, type RsvpState, type ScheduleMeetingInput, type Stage, type StageArgs, type StageLayout, TABLES, TRANSCRIPTION_ATTRIBUTES, TRANSCRIPTION_TOPIC, type TokenClient, type TokenClientOptions, type TokenRequest, type TranscriptBlock, type TranscriptSegment, type TranscriptSource, type UpcomingOccurrence, type UserId, type VideoEffect, type WrapUpAnnouncement, absenceSentence, announceMeeting, applyRoomEvent, asCallId, asMeetingId, asOrganizationId, asParticipantIdentity, asRoomName, asUserId, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, computeStage, countLabel, createCallCenter, createCallInviteHandler, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetApi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingSession, createMemoryDeviceStorage, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebRoomTokenStorage, displayNameFor, fileDownloadPath, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, invalidResponse, isGuest, isGuestIdentity, isHostRole, isListenOnly, isNoteTaker, isRealName, isRoomEventTopic, learnName, learnNames, listenOnlyNotice, loadGuestMeetingRecord, loadMeetingRecord, mapConnectionState, mapQuality, meetingInviteAction, meetingLink, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeRecord, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, orderParticipants, parseRoomToken, participantSummary, playableRecordingFileId, projectInvitee, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, recordingLabel, recordingNotice, roleOf, roomTopic, setGuestRecordAccess, settingsPatch, snapshotParticipant, unavailableFrom, userTopic, wasRefused };