@ai-matrx/meet 0.9.0 → 0.10.0

package/dist/core.d.cts

@@ -1,5 +1,5 @@
-import { P as ParticipantIdentity, $ as NoteTakerState, a as MeetParticipant, M as MeetingRecord, a8 as RoomPhase, e as ParticipantRole, a3 as ParticipantStanding, S as StageLayout, L as LobbyEntry, a7 as RecordingState, U as UserId, ax as RecordingSource, ac as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, i as CollabSnapshot, o as ConnectionQuality, j as AdmissionState, h as MeetingId, R as RoomName, b as MeetApi, d as CallInvite, f as CallMode, O as OrganizationId, l as CallId, m as CallState, X as MeetingKind, a5 as RecordingPolicy, a6 as RecordingRecord, N as MeetingAttendee, _ as MeetingSettings, Q as MeetingChanges, a1 as OccurrenceOverride, Z as MeetingOccurrence, ad as UpcomingOccurrence, V as MeetingInvitee, I as InviteeInput, p as InviteeRole, a9 as RsvpAnswer, aa as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-B6scmSST.cjs';
-export { A as AccessTokenSource, k as CAPTION_LANGUAGES, n as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, q as JsonValue, r as MeetApiOptions, s as MeetApiRequest, t as MeetBreakoutBroadcast, u as MeetBreakoutPlan, v as MeetBreakoutRoom, w as MeetCollabSettings, x as MeetFileMedia, y as MeetPoll, z as MeetPollOption, B as MeetPollState, D as MeetQuestion, G as MeetQuestionState, H as MeetStroke, K as MeetingActivities, Y as MeetingNoteKind, a0 as ORGANIZATION_HEADER, a2 as OccurrenceState, a4 as ROLE_RANK, ab as RsvpState, T as TranscriptSource, ae as applyCollabPacket, af as asCallId, ag as asMeetingId, ah as asOrganizationId, ai as asParticipantIdentity, aj as asRoomName, ak as asUserId, al as assignedRoom, am as autoAssign, an as breakoutRemainingMs, ao as collabFromState, ap as createMeetApi, aq as defaultCaptionLanguage, ar as fileDownloadPath, as as isGuest, at as isHostRole, au as isLinkFollower, av as loadMeetingActivities, aw as withItem } from './collab-B6scmSST.cjs';
+import { P as ParticipantIdentity, $ as NoteTakerState, a as MeetParticipant, M as MeetingRecord, a8 as RoomPhase, j as AdmissionState, e as ParticipantRole, a3 as ParticipantStanding, S as StageLayout, L as LobbyEntry, a7 as RecordingState, U as UserId, ax as RecordingSource, ac as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, i as CollabSnapshot, o as ConnectionQuality, h as MeetingId, R as RoomName, b as MeetApi, d as CallInvite, f as CallMode, O as OrganizationId, l as CallId, m as CallState, X as MeetingKind, a5 as RecordingPolicy, N as MeetingAttendee, a6 as RecordingRecord, _ as MeetingSettings, Q as MeetingChanges, a1 as OccurrenceOverride, Z as MeetingOccurrence, ad as UpcomingOccurrence, V as MeetingInvitee, I as InviteeInput, p as InviteeRole, a9 as RsvpAnswer, aa as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-C2R-kQnV.cjs';
+export { A as AccessTokenSource, k as CAPTION_LANGUAGES, n as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, q as JsonValue, r as MeetApiOptions, s as MeetApiRequest, t as MeetBreakoutBroadcast, u as MeetBreakoutPlan, v as MeetBreakoutRoom, w as MeetCollabSettings, x as MeetFileMedia, y as MeetPoll, z as MeetPollOption, B as MeetPollState, D as MeetQuestion, G as MeetQuestionState, H as MeetStroke, K as MeetingActivities, Y as MeetingNoteKind, a0 as ORGANIZATION_HEADER, a2 as OccurrenceState, a4 as ROLE_RANK, ab as RsvpState, T as TranscriptSource, ae as applyCollabPacket, af as asCallId, ag as asMeetingId, ah as asOrganizationId, ai as asParticipantIdentity, aj as asRoomName, ak as asUserId, al as assignedRoom, am as autoAssign, an as breakoutRemainingMs, ao as collabFromState, ap as createMeetApi, aq as defaultCaptionLanguage, ar as fileDownloadPath, as as isGuest, at as isHostRole, au as isLinkFollower, av as loadMeetingActivities, aw as withItem } from './collab-C2R-kQnV.cjs';
 import { RealtimeManager } from '@ai-matrx/realtime';
 import { MessagingSupabaseClient, ActionHandler } from '@ai-matrx/messaging';
 import { RoomOptions, ConnectionQuality as ConnectionQuality$1, Participant } from 'livekit-client';
@@ -344,8 +344,28 @@ interface MeetGrants {
 }
 /** No token yet grants nothing. Never "assume host until told otherwise". */
 declare const NO_GRANTS: MeetGrants;
+/**
+ * S4 — THIS PERSON'S WAIT, as the server's state read (`GET /v1/meet/state`) last said it
+ * (CORE-DESIGN §2.6). Set while `phase === "lobby"`; the waiting screens read it, never a
+ * broadcast. `admission` is the row's own word: `waiting_host` · `knocking` · `denied` ·
+ * `expired` · `withdrawn` · `ended` (`admitted` is never held here — it is a join).
+ */
+interface MeetWaiting {
+    readonly admission: AdmissionState;
+    /** Is anyone who may admit in the room? null until the first read. */
+    readonly admittersPresent: boolean | null;
+    /** May a denied person ask again (`reknock_after_deny`)? */
+    readonly reknockAllowed: boolean;
+    readonly knockExpiresAt: string | null;
+    /** How often the core reads while waiting (`waiting_poll_seconds`). */
+    readonly pollSeconds: number;
+    /** The run's `live_version` at the last read. */
+    readonly liveVersion: number;
+}
 interface MeetSnapshot {
     readonly phase: RoomPhase;
+    /** S4: this person's wait (see `MeetWaiting`); null outside the waiting room. */
+    readonly waiting: MeetWaiting | null;
     readonly meeting: MeetingRecord | null;
     readonly localIdentity: ParticipantIdentity | null;
     /** The server's word on what THIS joiner may do. See `MeetGrants`. */
@@ -743,7 +763,10 @@ declare const RPCS: {
     readonly getOrCreateMeeting: "meet_get_or_create_meeting";
     /** Resolve a durable public link, before/during/after its scheduled time. */
     readonly meetingBySlug: "meet_meeting_by_slug";
-    readonly admit: "meet_admit_participant";
+    readonly admit: "meet_admit";
+    readonly deny: "meet_deny";
+    readonly undeny: "meet_undeny";
+    readonly admitAll: "meet_admit_all";
     readonly setLock: "meet_set_lock";
     readonly recordConsent: "meet_record_consent";
     /** Schedule with every setting at create; unset settings come from the knobs. */
@@ -827,12 +850,15 @@ interface MeetRepository {
         readonly items: readonly MeetingRecord[];
         readonly hasMore: boolean;
     }>;
-    admit(args: {
+    /** S4: one decision on one waiting person; returns the row as it now stands. */
+    decideAdmission(args: {
         meetingId: MeetingId;
         identity: string;
-        admitted: boolean;
+        decision: "admit" | "deny" | "undeny";
         byUserId: UserId;
-    }): Promise<void>;
+    }): Promise<MeetingAttendee>;
+    /** S4: admit everyone still waiting (not expired); returns the admitted rows. */
+    admitAll(meetingId: MeetingId, byUserId: UserId): Promise<readonly MeetingAttendee[]>;
     setLock(meetingId: MeetingId, locked: boolean, byUserId: UserId): Promise<MeetingRecord>;
     projectSegment(row: Row): TranscriptSegment;
     projectNote(row: Row): MeetingNote;
@@ -1121,14 +1147,15 @@ declare const MEET_EVENTS: {
     readonly cancel: "mx.call.cancel";
     /** You answered (or declined) on another device. Stop ringing here. */
     readonly settled: "mx.call.settled";
-    /** Someone is in the lobby. Hosts render the knock. */
-    readonly knock: "mx.lobby.knock";
-    /** A host decided. The knocker learns it here — they have no DB read. */
-    readonly admission: "mx.lobby.admission";
-    /** The room was locked or unlocked. */
-    readonly lock: "mx.room.lock";
-    /** Recording started or stopped. EVERY participant renders the indicator. */
-    readonly recording: "mx.room.recording";
+    /**
+     * 🚨 S4 (CORE-DESIGN §2.6): the ONE room-channel event — payload-free "something changed,
+     * read again". Nothing a person must see rides it: a waiting person learns admitted /
+     * denied / expired / ended by READING their row (`GET /v1/meet/state`) on a timer and on
+     * every hint. The four payload broadcasts (`mx.lobby.knock`, `mx.lobby.admission`,
+     * `mx.room.lock`, `mx.room.recording`) are gone with their senders and receivers. The
+     * server publishes the same event on the same topic (aidream `admission.room_topic`).
+     */
+    readonly stateChanged: "mx.state.changed";
 };
 /**
  * 🚨 `mx.meeting.transcript` and `mx.meeting.note` WERE declared here and
@@ -1766,14 +1793,12 @@ interface MeetingSessionOptions {
      */
     onAdmitted?: (() => void) | undefined;
     /**
-     * 🚨 THE HOST DENIED *US*. Called once per denial verdict that names this
-     * knocker. Without it the waiting room kept promising "you will join
-     * automatically" to a person the host had already turned away (production
-     * 2026-09-27). The provider wires it to `engine.rejoin()`: the server then
-     * refuses the mint with its own sentence ("The host did not admit you…"),
-     * so the words on screen are the server's decision, never the client's guess.
+     * S4: the meeting pass this device holds (`x-meet-pass`) — what the state read and
+     * `/leave` are authorized by. Null when no pass is held yet.
      */
-    onDenied?: (() => void) | undefined;
+    resolvePass?: (() => string | null) | undefined;
+    /** S4: mint again (Ask to join again / Rejoin from the waiting screens). */
+    rejoin?: (() => Promise<void>) | undefined;
 }
 interface MeetingSession {
     /** Subscribe to the room's out-of-band plane. Hosts see knocks; guests see verdicts. */
@@ -1786,10 +1811,24 @@ interface MeetingSession {
      * permanently missing the minute nobody noticed.
      */
     watchMeeting(meetingId: MeetingId): void;
-    /** A guest (or a late arrival at a locked room) announces themselves. */
-    knock(roomName: RoomName): void;
     admit(entry: LobbyEntry, admitted: boolean): Promise<void>;
+    /** S4: lift a denial so the person may knock again (`meet_undeny`). */
+    undeny(entry: LobbyEntry): Promise<void>;
     admitAll(): Promise<void>;
+    /**
+     * 🚨 S4 — THE WAIT READS SERVER TRUTH (CORE-DESIGN §2.6). While this tab waits, the state
+     * read (`GET /v1/meet/state`) runs every `waiting_poll_seconds`, on every
+     * `mx.state.changed` hint, on `online` and on visibility return. Admitted → a fresh mint
+     * (`rejoin`); denied / expired / ended are what the row says, never a broadcast's guess.
+     */
+    startWaiting(): void;
+    stopWaiting(): void;
+    /** One state read now (idempotent while one is in flight). */
+    readState(): Promise<void>;
+    /** Stop waiting: the row becomes `withdrawn` (`POST /v1/meet/leave {intent: "withdraw"}`). */
+    withdraw(): Promise<void>;
+    /** Ask again after a denial or an expired knock (only offered when allowed). */
+    askAgain(): Promise<void>;
     setLock(locked: boolean): Promise<MeetingRecord>;
     /** End it for everyone, through the server (MRI-A6). */
     endForEveryone(): Promise<EndMeetingResult>;
@@ -1925,6 +1964,12 @@ interface RoomToken {
     readonly sessionId: string | null;
     /** True when the server put this joiner in the lobby (D6). */
     readonly lobby: boolean;
+    /**
+     * S4: what the mint wrote on the person row — `admitted` · `knocking` · `waiting_host`.
+     * A waiting person then reads `GET /v1/meet/state` every `pollSeconds`.
+     */
+    readonly admissionState?: AdmissionState | undefined;
+    readonly pollSeconds?: number | undefined;
     /**
      * Meet wave 5: the breakout room this pass is for, or null for the main room. The
      * pass is still keyed by the MEETING's room name — it is this person's pass for the
@@ -2070,6 +2115,16 @@ declare const MEET_ROUTES: {
     readonly collab: "/api/v1/meet/collab";
     /** Meet wave 5: translate finished caption lines into this viewer's language. */
     readonly captionsTranslate: "/api/v1/meet/captions/translate";
+    /**
+     * S4 — THE STATE READ (CORE-DESIGN §2.6): `GET ?meeting_id=` with `x-meet-pass`. This
+     * person's admission (lazy expiry applied), whether anyone who can admit is here, the run's
+     * phase. Read every `waiting_poll_seconds` while waiting and on every `mx.state.changed`.
+     */
+    readonly state: "/api/v1/meet/state";
+    /** S4: `withdraw` (stop waiting) or `leave` (close this tab); the pass may ride in the body. */
+    readonly leave: "/api/v1/meet/leave";
+    /** S4: a pass holder (guests included) saw the recording notice, for this run. */
+    readonly consent: "/api/v1/meet/consent";
 };
 /** A `MEET_ROUTES` template with its `{meeting_id}` filled in, URL-encoded. */
 declare function meetingPath(template: string, meetingId: string): string;
@@ -3039,7 +3094,7 @@ declare function takeMoveRequest(store: CollabStoreLike): {
  */
 type ObservedRole = "host" | "cohost" | "participant" | "guest";
 /** `data-meet-phase` values this release renders (a subset of the contract's §2). */
-type ObservedPhase = "resolving" | `refused:${string}` | "prejoin" | "joining" | "waiting:knocking" | "in_call" | "disconnected" | "ended";
+type ObservedPhase = "resolving" | `refused:${string}` | "prejoin" | "joining" | "waiting:knocking" | "waiting:host_not_started" | "denied" | "knock_expired" | "left" | "in_call" | "disconnected" | "ended";
 type ObservedConnection = "stable" | "reconnecting" | "server_unreachable";
 interface MeetObservation {
     readonly phase: ObservedPhase;

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { P as ParticipantIdentity, $ as NoteTakerState, a as MeetParticipant, M as MeetingRecord, a8 as RoomPhase, e as ParticipantRole, a3 as ParticipantStanding, S as StageLayout, L as LobbyEntry, a7 as RecordingState, U as UserId, ax as RecordingSource, ac as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, i as CollabSnapshot, o as ConnectionQuality, j as AdmissionState, h as MeetingId, R as RoomName, b as MeetApi, d as CallInvite, f as CallMode, O as OrganizationId, l as CallId, m as CallState, X as MeetingKind, a5 as RecordingPolicy, a6 as RecordingRecord, N as MeetingAttendee, _ as MeetingSettings, Q as MeetingChanges, a1 as OccurrenceOverride, Z as MeetingOccurrence, ad as UpcomingOccurrence, V as MeetingInvitee, I as InviteeInput, p as InviteeRole, a9 as RsvpAnswer, aa as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-B6scmSST.js';
-export { A as AccessTokenSource, k as CAPTION_LANGUAGES, n as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, q as JsonValue, r as MeetApiOptions, s as MeetApiRequest, t as MeetBreakoutBroadcast, u as MeetBreakoutPlan, v as MeetBreakoutRoom, w as MeetCollabSettings, x as MeetFileMedia, y as MeetPoll, z as MeetPollOption, B as MeetPollState, D as MeetQuestion, G as MeetQuestionState, H as MeetStroke, K as MeetingActivities, Y as MeetingNoteKind, a0 as ORGANIZATION_HEADER, a2 as OccurrenceState, a4 as ROLE_RANK, ab as RsvpState, T as TranscriptSource, ae as applyCollabPacket, af as asCallId, ag as asMeetingId, ah as asOrganizationId, ai as asParticipantIdentity, aj as asRoomName, ak as asUserId, al as assignedRoom, am as autoAssign, an as breakoutRemainingMs, ao as collabFromState, ap as createMeetApi, aq as defaultCaptionLanguage, ar as fileDownloadPath, as as isGuest, at as isHostRole, au as isLinkFollower, av as loadMeetingActivities, aw as withItem } from './collab-B6scmSST.js';
+import { P as ParticipantIdentity, $ as NoteTakerState, a as MeetParticipant, M as MeetingRecord, a8 as RoomPhase, j as AdmissionState, e as ParticipantRole, a3 as ParticipantStanding, S as StageLayout, L as LobbyEntry, a7 as RecordingState, U as UserId, ax as RecordingSource, ac as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, i as CollabSnapshot, o as ConnectionQuality, h as MeetingId, R as RoomName, b as MeetApi, d as CallInvite, f as CallMode, O as OrganizationId, l as CallId, m as CallState, X as MeetingKind, a5 as RecordingPolicy, N as MeetingAttendee, a6 as RecordingRecord, _ as MeetingSettings, Q as MeetingChanges, a1 as OccurrenceOverride, Z as MeetingOccurrence, ad as UpcomingOccurrence, V as MeetingInvitee, I as InviteeInput, p as InviteeRole, a9 as RsvpAnswer, aa as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-C2R-kQnV.js';
+export { A as AccessTokenSource, k as CAPTION_LANGUAGES, n as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, q as JsonValue, r as MeetApiOptions, s as MeetApiRequest, t as MeetBreakoutBroadcast, u as MeetBreakoutPlan, v as MeetBreakoutRoom, w as MeetCollabSettings, x as MeetFileMedia, y as MeetPoll, z as MeetPollOption, B as MeetPollState, D as MeetQuestion, G as MeetQuestionState, H as MeetStroke, K as MeetingActivities, Y as MeetingNoteKind, a0 as ORGANIZATION_HEADER, a2 as OccurrenceState, a4 as ROLE_RANK, ab as RsvpState, T as TranscriptSource, ae as applyCollabPacket, af as asCallId, ag as asMeetingId, ah as asOrganizationId, ai as asParticipantIdentity, aj as asRoomName, ak as asUserId, al as assignedRoom, am as autoAssign, an as breakoutRemainingMs, ao as collabFromState, ap as createMeetApi, aq as defaultCaptionLanguage, ar as fileDownloadPath, as as isGuest, at as isHostRole, au as isLinkFollower, av as loadMeetingActivities, aw as withItem } from './collab-C2R-kQnV.js';
 import { RealtimeManager } from '@ai-matrx/realtime';
 import { MessagingSupabaseClient, ActionHandler } from '@ai-matrx/messaging';
 import { RoomOptions, ConnectionQuality as ConnectionQuality$1, Participant } from 'livekit-client';
@@ -344,8 +344,28 @@ interface MeetGrants {
 }
 /** No token yet grants nothing. Never "assume host until told otherwise". */
 declare const NO_GRANTS: MeetGrants;
+/**
+ * S4 — THIS PERSON'S WAIT, as the server's state read (`GET /v1/meet/state`) last said it
+ * (CORE-DESIGN §2.6). Set while `phase === "lobby"`; the waiting screens read it, never a
+ * broadcast. `admission` is the row's own word: `waiting_host` · `knocking` · `denied` ·
+ * `expired` · `withdrawn` · `ended` (`admitted` is never held here — it is a join).
+ */
+interface MeetWaiting {
+    readonly admission: AdmissionState;
+    /** Is anyone who may admit in the room? null until the first read. */
+    readonly admittersPresent: boolean | null;
+    /** May a denied person ask again (`reknock_after_deny`)? */
+    readonly reknockAllowed: boolean;
+    readonly knockExpiresAt: string | null;
+    /** How often the core reads while waiting (`waiting_poll_seconds`). */
+    readonly pollSeconds: number;
+    /** The run's `live_version` at the last read. */
+    readonly liveVersion: number;
+}
 interface MeetSnapshot {
     readonly phase: RoomPhase;
+    /** S4: this person's wait (see `MeetWaiting`); null outside the waiting room. */
+    readonly waiting: MeetWaiting | null;
     readonly meeting: MeetingRecord | null;
     readonly localIdentity: ParticipantIdentity | null;
     /** The server's word on what THIS joiner may do. See `MeetGrants`. */
@@ -743,7 +763,10 @@ declare const RPCS: {
     readonly getOrCreateMeeting: "meet_get_or_create_meeting";
     /** Resolve a durable public link, before/during/after its scheduled time. */
     readonly meetingBySlug: "meet_meeting_by_slug";
-    readonly admit: "meet_admit_participant";
+    readonly admit: "meet_admit";
+    readonly deny: "meet_deny";
+    readonly undeny: "meet_undeny";
+    readonly admitAll: "meet_admit_all";
     readonly setLock: "meet_set_lock";
     readonly recordConsent: "meet_record_consent";
     /** Schedule with every setting at create; unset settings come from the knobs. */
@@ -827,12 +850,15 @@ interface MeetRepository {
         readonly items: readonly MeetingRecord[];
         readonly hasMore: boolean;
     }>;
-    admit(args: {
+    /** S4: one decision on one waiting person; returns the row as it now stands. */
+    decideAdmission(args: {
         meetingId: MeetingId;
         identity: string;
-        admitted: boolean;
+        decision: "admit" | "deny" | "undeny";
         byUserId: UserId;
-    }): Promise<void>;
+    }): Promise<MeetingAttendee>;
+    /** S4: admit everyone still waiting (not expired); returns the admitted rows. */
+    admitAll(meetingId: MeetingId, byUserId: UserId): Promise<readonly MeetingAttendee[]>;
     setLock(meetingId: MeetingId, locked: boolean, byUserId: UserId): Promise<MeetingRecord>;
     projectSegment(row: Row): TranscriptSegment;
     projectNote(row: Row): MeetingNote;
@@ -1121,14 +1147,15 @@ declare const MEET_EVENTS: {
     readonly cancel: "mx.call.cancel";
     /** You answered (or declined) on another device. Stop ringing here. */
     readonly settled: "mx.call.settled";
-    /** Someone is in the lobby. Hosts render the knock. */
-    readonly knock: "mx.lobby.knock";
-    /** A host decided. The knocker learns it here — they have no DB read. */
-    readonly admission: "mx.lobby.admission";
-    /** The room was locked or unlocked. */
-    readonly lock: "mx.room.lock";
-    /** Recording started or stopped. EVERY participant renders the indicator. */
-    readonly recording: "mx.room.recording";
+    /**
+     * 🚨 S4 (CORE-DESIGN §2.6): the ONE room-channel event — payload-free "something changed,
+     * read again". Nothing a person must see rides it: a waiting person learns admitted /
+     * denied / expired / ended by READING their row (`GET /v1/meet/state`) on a timer and on
+     * every hint. The four payload broadcasts (`mx.lobby.knock`, `mx.lobby.admission`,
+     * `mx.room.lock`, `mx.room.recording`) are gone with their senders and receivers. The
+     * server publishes the same event on the same topic (aidream `admission.room_topic`).
+     */
+    readonly stateChanged: "mx.state.changed";
 };
 /**
  * 🚨 `mx.meeting.transcript` and `mx.meeting.note` WERE declared here and
@@ -1766,14 +1793,12 @@ interface MeetingSessionOptions {
      */
     onAdmitted?: (() => void) | undefined;
     /**
-     * 🚨 THE HOST DENIED *US*. Called once per denial verdict that names this
-     * knocker. Without it the waiting room kept promising "you will join
-     * automatically" to a person the host had already turned away (production
-     * 2026-09-27). The provider wires it to `engine.rejoin()`: the server then
-     * refuses the mint with its own sentence ("The host did not admit you…"),
-     * so the words on screen are the server's decision, never the client's guess.
+     * S4: the meeting pass this device holds (`x-meet-pass`) — what the state read and
+     * `/leave` are authorized by. Null when no pass is held yet.
      */
-    onDenied?: (() => void) | undefined;
+    resolvePass?: (() => string | null) | undefined;
+    /** S4: mint again (Ask to join again / Rejoin from the waiting screens). */
+    rejoin?: (() => Promise<void>) | undefined;
 }
 interface MeetingSession {
     /** Subscribe to the room's out-of-band plane. Hosts see knocks; guests see verdicts. */
@@ -1786,10 +1811,24 @@ interface MeetingSession {
      * permanently missing the minute nobody noticed.
      */
     watchMeeting(meetingId: MeetingId): void;
-    /** A guest (or a late arrival at a locked room) announces themselves. */
-    knock(roomName: RoomName): void;
     admit(entry: LobbyEntry, admitted: boolean): Promise<void>;
+    /** S4: lift a denial so the person may knock again (`meet_undeny`). */
+    undeny(entry: LobbyEntry): Promise<void>;
     admitAll(): Promise<void>;
+    /**
+     * 🚨 S4 — THE WAIT READS SERVER TRUTH (CORE-DESIGN §2.6). While this tab waits, the state
+     * read (`GET /v1/meet/state`) runs every `waiting_poll_seconds`, on every
+     * `mx.state.changed` hint, on `online` and on visibility return. Admitted → a fresh mint
+     * (`rejoin`); denied / expired / ended are what the row says, never a broadcast's guess.
+     */
+    startWaiting(): void;
+    stopWaiting(): void;
+    /** One state read now (idempotent while one is in flight). */
+    readState(): Promise<void>;
+    /** Stop waiting: the row becomes `withdrawn` (`POST /v1/meet/leave {intent: "withdraw"}`). */
+    withdraw(): Promise<void>;
+    /** Ask again after a denial or an expired knock (only offered when allowed). */
+    askAgain(): Promise<void>;
     setLock(locked: boolean): Promise<MeetingRecord>;
     /** End it for everyone, through the server (MRI-A6). */
     endForEveryone(): Promise<EndMeetingResult>;
@@ -1925,6 +1964,12 @@ interface RoomToken {
     readonly sessionId: string | null;
     /** True when the server put this joiner in the lobby (D6). */
     readonly lobby: boolean;
+    /**
+     * S4: what the mint wrote on the person row — `admitted` · `knocking` · `waiting_host`.
+     * A waiting person then reads `GET /v1/meet/state` every `pollSeconds`.
+     */
+    readonly admissionState?: AdmissionState | undefined;
+    readonly pollSeconds?: number | undefined;
     /**
      * Meet wave 5: the breakout room this pass is for, or null for the main room. The
      * pass is still keyed by the MEETING's room name — it is this person's pass for the
@@ -2070,6 +2115,16 @@ declare const MEET_ROUTES: {
     readonly collab: "/api/v1/meet/collab";
     /** Meet wave 5: translate finished caption lines into this viewer's language. */
     readonly captionsTranslate: "/api/v1/meet/captions/translate";
+    /**
+     * S4 — THE STATE READ (CORE-DESIGN §2.6): `GET ?meeting_id=` with `x-meet-pass`. This
+     * person's admission (lazy expiry applied), whether anyone who can admit is here, the run's
+     * phase. Read every `waiting_poll_seconds` while waiting and on every `mx.state.changed`.
+     */
+    readonly state: "/api/v1/meet/state";
+    /** S4: `withdraw` (stop waiting) or `leave` (close this tab); the pass may ride in the body. */
+    readonly leave: "/api/v1/meet/leave";
+    /** S4: a pass holder (guests included) saw the recording notice, for this run. */
+    readonly consent: "/api/v1/meet/consent";
 };
 /** A `MEET_ROUTES` template with its `{meeting_id}` filled in, URL-encoded. */
 declare function meetingPath(template: string, meetingId: string): string;
@@ -3039,7 +3094,7 @@ declare function takeMoveRequest(store: CollabStoreLike): {
  */
 type ObservedRole = "host" | "cohost" | "participant" | "guest";
 /** `data-meet-phase` values this release renders (a subset of the contract's §2). */
-type ObservedPhase = "resolving" | `refused:${string}` | "prejoin" | "joining" | "waiting:knocking" | "in_call" | "disconnected" | "ended";
+type ObservedPhase = "resolving" | `refused:${string}` | "prejoin" | "joining" | "waiting:knocking" | "waiting:host_not_started" | "denied" | "knock_expired" | "left" | "in_call" | "disconnected" | "ended";
 type ObservedConnection = "stable" | "reconnecting" | "server_unreachable";
 interface MeetObservation {
     readonly phase: ObservedPhase;