@ai-matrx/meet 0.7.78 → 0.7.79

package/dist/index.d.cts

@@ -2938,6 +2938,21 @@ interface MeetingRecordBundle {
  * therefore make the same distinction as decisions and action items.
  */
 declare function activeWrapUpSummary(notes: readonly MeetingNote[]): MeetingNote | null;
+/**
+ * The four durable reads behind a record, as the database returned them, plus
+ * what the reader could not see. `assembleMeetingRecord` turns them into the
+ * bundle; a cache that keeps them can apply a realtime row to one part and
+ * assemble again, without reading the other three (0.7.79).
+ */
+interface MeetingRecordParts {
+    readonly attendees: readonly MeetingAttendee[];
+    /** Every note row (all kinds, superseded included), oldest first. */
+    readonly notes: readonly MeetingNote[];
+    readonly transcript: readonly TranscriptSegment[];
+    /** Newest first; archived recordings are not here. */
+    readonly recordings: readonly RecordingRecord[];
+    readonly restrictions: readonly MeetingRecordRestriction[];
+}
 /**
  * Load the record parts the reader may request; state all restrictions.
  *
@@ -2946,6 +2961,10 @@ declare function activeWrapUpSummary(notes: readonly MeetingNote[]): MeetingNote
  * fail for exactly the reader who most needs the page to work.
  */
 declare function loadMeetingRecord(repository: MeetRepository, meetingId: MeetingId, meeting: MeetingRecord, reader?: Pick<MeetIdentity, "userId">): Promise<MeetingRecordBundle>;
+/** The four reads, each with its own verdict (see `loadMeetingRecord`). */
+declare function loadMeetingRecordParts(repository: MeetRepository, meetingId: MeetingId, reader?: Pick<MeetIdentity, "userId">): Promise<MeetingRecordParts>;
+/** The bundle a reader sees, from the parts. Grouping and ordering only (rule 3). */
+declare function assembleMeetingRecord(meeting: MeetingRecord, parts: MeetingRecordParts): MeetingRecordBundle;
 /**
  * 🚨 **A READ THAT WAS REFUSED IS NOT AN EMPTY RESULT (MRI-A16).**
  *
@@ -3594,4 +3613,104 @@ interface InRoomClientOptions {
 }
 declare function createInRoomClient(options: InRoomClientOptions): InRoomClient;
 
-export { ATTENDANCE_CSV_HEADER, type AccessTokenSource, type AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AttendanceKind, type AttendanceRow, type AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CAPTION_LANGUAGES, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, type CallId, type CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, type CallMode, type CallState, type CallablePerson, type CollabAction, type CollabPanel, type CollabRequest, type CollabResult, type CollabSnapshot, 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, EMPTY_COLLAB, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, FILE_SESSION_PATH, type FollowUpDraft, type FollowUpRecipient, type FollowUpSendResult, 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 LibraryRecording, 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 MeetBreakoutBroadcast, type MeetBreakoutPlan, type MeetBreakoutRoom, type MeetCollabSettings, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetFileMedia, type MeetGrants, type MeetIdentity, type MeetParticipant, type MeetPoll, type MeetPollOption, type MeetPollState, type MeetQuestion, type MeetQuestionState, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, type MeetStroke, type MeetingActivities, type MeetingAttendee, type MeetingChanges, type MeetingChatHistory, type MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, type MeetingInvitee, type MeetingKind, type MeetingNote, type MeetingNoteKind, type MeetingOccurrence, type MeetingRecord, type MeetingRecordBundle, type MeetingRecordRestriction, type MeetingRecordRestrictionNotice, type MeetingSearchHit, type MeetingSearchSource, 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 TranscriptFormat, type TranscriptMatch, type TranscriptSegment, type TranscriptSource, type UpcomingOccurrence, type UserId, type VideoEffect, type WrapUpAnnouncement, type WrapUpStatus, absenceSentence, activeWrapUpSummary, announceMeeting, applyCollabPacket, applyRoomEvent, asCallId, asMeetingId, asOrganizationId, asParticipantIdentity, asRoomName, asUserId, assignedRoom, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoAssign, breakoutRemainingMs, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, clockPosition, collabFromState, computeStage, countLabel, createCallCenter, createCallInviteHandler, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetApi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingSession, createMemoryDeviceStorage, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebRoomTokenStorage, defaultCaptionLanguage, displayNameFor, fileDownloadPath, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, invalidResponse, isGuest, isGuestIdentity, isHostRole, isListenOnly, isNoteTaker, isRealName, isRoomEventTopic, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingActivities, loadMeetingChat, loadMeetingRecord, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeRecord, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, orderParticipants, parseRoomToken, participantSummary, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, recordingLabel, recordingNotice, recordingOffsetMs, roleOf, roomTopic, searchTranscript, sendFollowUp, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, summarizeMeetingRecordRestrictions, transcriptDocument, unavailableFrom, uniqueAttendees, userTopic, wasRefused, withItem, wrapUpStatus };
+/**
+ * ONE MEETING RECORD PER READER PER TAB — read once, kept current by one
+ * ref-counted channel (0.7.79).
+ *
+ * 🚨 THE DEFECT THIS CLOSES. `useMeetingRecord` held the bundle in its own
+ * component state and read all four parts (`meet_participants`, `meet_notes`,
+ * `meet_transcript_segments`, `meet_recordings`) in a mount effect. A host that
+ * hides a view without unmounting its data — a board tile asleep under React
+ * `<Activity>`, which tears every effect down and runs it again on wake — read
+ * the whole record again on every wake, on a Remove + Undo, and once more for
+ * every second view of the same meeting (the record tab, the meeting's agent
+ * surface, five "meeting notes" tiles). The view owned the data.
+ *
+ * THE SHAPE. One entry per (reader, meeting). The first view reads; every later
+ * view — the same view after a wake or a remount included — renders the entry
+ * and reads nothing. A read already in flight is joined. A forced read (Retry,
+ * a reconnect) supersedes it, and an answer that lands after a newer read was
+ * asked is DROPPED (the late-answer guard), so an old answer can never paint
+ * over a newer one.
+ *
+ * LIVE WHILE HELD. A member's entry (a direct read, kept as its four parts) is
+ * patched row by row from the database's change feed for the four tables, then
+ * assembled again — one row, never four reads. The channel opens on the first
+ * holder and closes `MEETING_RECORD_GRACE_MS` after the last one lets go, so a
+ * wake or an Undo inside the grace costs nothing. Past the grace nothing
+ * watched the meeting, so the entry is marked stale and the next view reads it
+ * once. A guest's record arrives through the server as a finished bundle; it
+ * has no change feed and is kept as it is.
+ *
+ * Framework-free on purpose: `react/hooks.ts` is one reader of it.
+ */
+
+/** How long a meeting's channel and kept record outlive the last view of it. */
+declare const MEETING_RECORD_GRACE_MS = 60000;
+interface MeetingRecordFailure {
+    readonly message: string;
+    readonly remedy: string;
+}
+interface MeetingRecordState {
+    readonly loading: boolean;
+    readonly record: MeetingRecordBundle | null;
+    /** A failure that stopped the WHOLE record loading (never kept as an answer). */
+    readonly failure: MeetingRecordFailure | null;
+}
+/** What a read produced: the four parts (patchable), or a finished bundle (a guest's). */
+type MeetingRecordAnswer = {
+    readonly kind: "parts";
+    readonly meeting: MeetingRecord;
+    readonly parts: MeetingRecordParts;
+} | {
+    readonly kind: "bundle";
+    readonly bundle: MeetingRecordBundle;
+};
+/** One changed row, already projected by the repository. `null` + `removedId` = gone. */
+type MeetingRecordChange = {
+    readonly part: "transcript";
+    readonly row: MeetingRecordParts["transcript"][number] | null;
+    readonly removedId?: string | undefined;
+} | {
+    readonly part: "notes";
+    readonly row: MeetingRecordParts["notes"][number] | null;
+    readonly removedId?: string | undefined;
+} | {
+    readonly part: "attendance";
+    readonly row: MeetingRecordParts["attendees"][number] | null;
+    readonly removedId?: string | undefined;
+} | {
+    readonly part: "recording";
+    readonly row: MeetingRecordParts["recordings"][number] | null;
+    readonly removedId?: string | undefined;
+};
+interface MeetingRecordCache {
+    /** The kept state for `key` (stable until it changes). */
+    state(key: string | null): MeetingRecordState;
+    subscribe(listener: () => void): () => void;
+    /**
+     * Read unless the entry is kept and current (or a read is in flight — joined).
+     * `force` reads anyway and supersedes a read in flight. Never rejects: a
+     * failure is in the state.
+     */
+    ensure(key: string, read: () => Promise<MeetingRecordAnswer>, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /** The meeting row moved (a rename, it ended): assemble again — no read. */
+    setMeeting(key: string, meeting: MeetingRecord): void;
+    /** Apply one changed row from the change feed — no read. */
+    apply(key: string, change: MeetingRecordChange): void;
+    /**
+     * Hold the live half: `open` on the first holder, its close a grace after the
+     * last. `owner` is what the channel runs on (the realtime manager): a new
+     * owner means the old one's channels are gone, so it opens again.
+     */
+    hold(key: string, open: () => () => void, owner?: unknown): () => void;
+    /** Tests only. */
+    reset(): void;
+}
+declare function createMeetingRecordCache(options?: {
+    graceMs?: number;
+}): MeetingRecordCache;
+
+export { ATTENDANCE_CSV_HEADER, type AccessTokenSource, type AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AttendanceKind, type AttendanceRow, type AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CAPTION_LANGUAGES, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, type CallId, type CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, type CallMode, type CallState, type CallablePerson, type CollabAction, type CollabPanel, type CollabRequest, type CollabResult, type CollabSnapshot, 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, EMPTY_COLLAB, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, FILE_SESSION_PATH, type FollowUpDraft, type FollowUpRecipient, type FollowUpSendResult, 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 LibraryRecording, type LiveKitDriverOptions, type LobbyEntry, type LocalMediaState, type LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEETING_RECORD_GRACE_MS, 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 MeetBreakoutBroadcast, type MeetBreakoutPlan, type MeetBreakoutRoom, type MeetCollabSettings, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetFileMedia, type MeetGrants, type MeetIdentity, type MeetParticipant, type MeetPoll, type MeetPollOption, type MeetPollState, type MeetQuestion, type MeetQuestionState, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, type MeetStroke, type MeetingActivities, type MeetingAttendee, type MeetingChanges, type MeetingChatHistory, type MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, type MeetingInvitee, type MeetingKind, type MeetingNote, type MeetingNoteKind, type MeetingOccurrence, type MeetingRecord, type MeetingRecordAnswer, type MeetingRecordBundle, type MeetingRecordCache, type MeetingRecordChange, type MeetingRecordFailure, type MeetingRecordParts, type MeetingRecordRestriction, type MeetingRecordRestrictionNotice, type MeetingRecordState, type MeetingSearchHit, type MeetingSearchSource, 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 TranscriptFormat, type TranscriptMatch, type TranscriptSegment, type TranscriptSource, type UpcomingOccurrence, type UserId, type VideoEffect, type WrapUpAnnouncement, type WrapUpStatus, absenceSentence, activeWrapUpSummary, announceMeeting, applyCollabPacket, applyRoomEvent, asCallId, asMeetingId, asOrganizationId, asParticipantIdentity, asRoomName, asUserId, assembleMeetingRecord, assignedRoom, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoAssign, breakoutRemainingMs, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, clockPosition, collabFromState, computeStage, countLabel, createCallCenter, createCallInviteHandler, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetApi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingRecordCache, createMeetingSession, createMemoryDeviceStorage, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebRoomTokenStorage, defaultCaptionLanguage, displayNameFor, fileDownloadPath, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, invalidResponse, isGuest, isGuestIdentity, isHostRole, isListenOnly, isNoteTaker, isRealName, isRoomEventTopic, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingActivities, loadMeetingChat, loadMeetingRecord, loadMeetingRecordParts, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeRecord, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, orderParticipants, parseRoomToken, participantSummary, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, recordingLabel, recordingNotice, recordingOffsetMs, roleOf, roomTopic, searchTranscript, sendFollowUp, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, summarizeMeetingRecordRestrictions, transcriptDocument, unavailableFrom, uniqueAttendees, userTopic, wasRefused, withItem, wrapUpStatus };

package/dist/index.d.ts

@@ -2938,6 +2938,21 @@ interface MeetingRecordBundle {
  * therefore make the same distinction as decisions and action items.
  */
 declare function activeWrapUpSummary(notes: readonly MeetingNote[]): MeetingNote | null;
+/**
+ * The four durable reads behind a record, as the database returned them, plus
+ * what the reader could not see. `assembleMeetingRecord` turns them into the
+ * bundle; a cache that keeps them can apply a realtime row to one part and
+ * assemble again, without reading the other three (0.7.79).
+ */
+interface MeetingRecordParts {
+    readonly attendees: readonly MeetingAttendee[];
+    /** Every note row (all kinds, superseded included), oldest first. */
+    readonly notes: readonly MeetingNote[];
+    readonly transcript: readonly TranscriptSegment[];
+    /** Newest first; archived recordings are not here. */
+    readonly recordings: readonly RecordingRecord[];
+    readonly restrictions: readonly MeetingRecordRestriction[];
+}
 /**
  * Load the record parts the reader may request; state all restrictions.
  *
@@ -2946,6 +2961,10 @@ declare function activeWrapUpSummary(notes: readonly MeetingNote[]): MeetingNote
  * fail for exactly the reader who most needs the page to work.
  */
 declare function loadMeetingRecord(repository: MeetRepository, meetingId: MeetingId, meeting: MeetingRecord, reader?: Pick<MeetIdentity, "userId">): Promise<MeetingRecordBundle>;
+/** The four reads, each with its own verdict (see `loadMeetingRecord`). */
+declare function loadMeetingRecordParts(repository: MeetRepository, meetingId: MeetingId, reader?: Pick<MeetIdentity, "userId">): Promise<MeetingRecordParts>;
+/** The bundle a reader sees, from the parts. Grouping and ordering only (rule 3). */
+declare function assembleMeetingRecord(meeting: MeetingRecord, parts: MeetingRecordParts): MeetingRecordBundle;
 /**
  * 🚨 **A READ THAT WAS REFUSED IS NOT AN EMPTY RESULT (MRI-A16).**
  *
@@ -3594,4 +3613,104 @@ interface InRoomClientOptions {
 }
 declare function createInRoomClient(options: InRoomClientOptions): InRoomClient;
 
-export { ATTENDANCE_CSV_HEADER, type AccessTokenSource, type AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AttendanceKind, type AttendanceRow, type AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CAPTION_LANGUAGES, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, type CallId, type CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, type CallMode, type CallState, type CallablePerson, type CollabAction, type CollabPanel, type CollabRequest, type CollabResult, type CollabSnapshot, 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, EMPTY_COLLAB, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, FILE_SESSION_PATH, type FollowUpDraft, type FollowUpRecipient, type FollowUpSendResult, 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 LibraryRecording, 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 MeetBreakoutBroadcast, type MeetBreakoutPlan, type MeetBreakoutRoom, type MeetCollabSettings, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetFileMedia, type MeetGrants, type MeetIdentity, type MeetParticipant, type MeetPoll, type MeetPollOption, type MeetPollState, type MeetQuestion, type MeetQuestionState, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, type MeetStroke, type MeetingActivities, type MeetingAttendee, type MeetingChanges, type MeetingChatHistory, type MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, type MeetingInvitee, type MeetingKind, type MeetingNote, type MeetingNoteKind, type MeetingOccurrence, type MeetingRecord, type MeetingRecordBundle, type MeetingRecordRestriction, type MeetingRecordRestrictionNotice, type MeetingSearchHit, type MeetingSearchSource, 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 TranscriptFormat, type TranscriptMatch, type TranscriptSegment, type TranscriptSource, type UpcomingOccurrence, type UserId, type VideoEffect, type WrapUpAnnouncement, type WrapUpStatus, absenceSentence, activeWrapUpSummary, announceMeeting, applyCollabPacket, applyRoomEvent, asCallId, asMeetingId, asOrganizationId, asParticipantIdentity, asRoomName, asUserId, assignedRoom, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoAssign, breakoutRemainingMs, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, clockPosition, collabFromState, computeStage, countLabel, createCallCenter, createCallInviteHandler, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetApi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingSession, createMemoryDeviceStorage, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebRoomTokenStorage, defaultCaptionLanguage, displayNameFor, fileDownloadPath, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, invalidResponse, isGuest, isGuestIdentity, isHostRole, isListenOnly, isNoteTaker, isRealName, isRoomEventTopic, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingActivities, loadMeetingChat, loadMeetingRecord, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeRecord, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, orderParticipants, parseRoomToken, participantSummary, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, recordingLabel, recordingNotice, recordingOffsetMs, roleOf, roomTopic, searchTranscript, sendFollowUp, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, summarizeMeetingRecordRestrictions, transcriptDocument, unavailableFrom, uniqueAttendees, userTopic, wasRefused, withItem, wrapUpStatus };
+/**
+ * ONE MEETING RECORD PER READER PER TAB — read once, kept current by one
+ * ref-counted channel (0.7.79).
+ *
+ * 🚨 THE DEFECT THIS CLOSES. `useMeetingRecord` held the bundle in its own
+ * component state and read all four parts (`meet_participants`, `meet_notes`,
+ * `meet_transcript_segments`, `meet_recordings`) in a mount effect. A host that
+ * hides a view without unmounting its data — a board tile asleep under React
+ * `<Activity>`, which tears every effect down and runs it again on wake — read
+ * the whole record again on every wake, on a Remove + Undo, and once more for
+ * every second view of the same meeting (the record tab, the meeting's agent
+ * surface, five "meeting notes" tiles). The view owned the data.
+ *
+ * THE SHAPE. One entry per (reader, meeting). The first view reads; every later
+ * view — the same view after a wake or a remount included — renders the entry
+ * and reads nothing. A read already in flight is joined. A forced read (Retry,
+ * a reconnect) supersedes it, and an answer that lands after a newer read was
+ * asked is DROPPED (the late-answer guard), so an old answer can never paint
+ * over a newer one.
+ *
+ * LIVE WHILE HELD. A member's entry (a direct read, kept as its four parts) is
+ * patched row by row from the database's change feed for the four tables, then
+ * assembled again — one row, never four reads. The channel opens on the first
+ * holder and closes `MEETING_RECORD_GRACE_MS` after the last one lets go, so a
+ * wake or an Undo inside the grace costs nothing. Past the grace nothing
+ * watched the meeting, so the entry is marked stale and the next view reads it
+ * once. A guest's record arrives through the server as a finished bundle; it
+ * has no change feed and is kept as it is.
+ *
+ * Framework-free on purpose: `react/hooks.ts` is one reader of it.
+ */
+
+/** How long a meeting's channel and kept record outlive the last view of it. */
+declare const MEETING_RECORD_GRACE_MS = 60000;
+interface MeetingRecordFailure {
+    readonly message: string;
+    readonly remedy: string;
+}
+interface MeetingRecordState {
+    readonly loading: boolean;
+    readonly record: MeetingRecordBundle | null;
+    /** A failure that stopped the WHOLE record loading (never kept as an answer). */
+    readonly failure: MeetingRecordFailure | null;
+}
+/** What a read produced: the four parts (patchable), or a finished bundle (a guest's). */
+type MeetingRecordAnswer = {
+    readonly kind: "parts";
+    readonly meeting: MeetingRecord;
+    readonly parts: MeetingRecordParts;
+} | {
+    readonly kind: "bundle";
+    readonly bundle: MeetingRecordBundle;
+};
+/** One changed row, already projected by the repository. `null` + `removedId` = gone. */
+type MeetingRecordChange = {
+    readonly part: "transcript";
+    readonly row: MeetingRecordParts["transcript"][number] | null;
+    readonly removedId?: string | undefined;
+} | {
+    readonly part: "notes";
+    readonly row: MeetingRecordParts["notes"][number] | null;
+    readonly removedId?: string | undefined;
+} | {
+    readonly part: "attendance";
+    readonly row: MeetingRecordParts["attendees"][number] | null;
+    readonly removedId?: string | undefined;
+} | {
+    readonly part: "recording";
+    readonly row: MeetingRecordParts["recordings"][number] | null;
+    readonly removedId?: string | undefined;
+};
+interface MeetingRecordCache {
+    /** The kept state for `key` (stable until it changes). */
+    state(key: string | null): MeetingRecordState;
+    subscribe(listener: () => void): () => void;
+    /**
+     * Read unless the entry is kept and current (or a read is in flight — joined).
+     * `force` reads anyway and supersedes a read in flight. Never rejects: a
+     * failure is in the state.
+     */
+    ensure(key: string, read: () => Promise<MeetingRecordAnswer>, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /** The meeting row moved (a rename, it ended): assemble again — no read. */
+    setMeeting(key: string, meeting: MeetingRecord): void;
+    /** Apply one changed row from the change feed — no read. */
+    apply(key: string, change: MeetingRecordChange): void;
+    /**
+     * Hold the live half: `open` on the first holder, its close a grace after the
+     * last. `owner` is what the channel runs on (the realtime manager): a new
+     * owner means the old one's channels are gone, so it opens again.
+     */
+    hold(key: string, open: () => () => void, owner?: unknown): () => void;
+    /** Tests only. */
+    reset(): void;
+}
+declare function createMeetingRecordCache(options?: {
+    graceMs?: number;
+}): MeetingRecordCache;
+
+export { ATTENDANCE_CSV_HEADER, type AccessTokenSource, type AdmissionState, type AnnounceResult, type ApplyRoomEventArgs, type AskArgs, type AttendanceKind, type AttendanceRow, type AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CAPTION_LANGUAGES, CONSENT_NOTICE_ATTRIBUTE, type CallCenter, type CallCenterOptions, type CallId, type CallInvite, type CallInviteHandlerOptions, type CallInvitePayload, type CallMode, type CallState, type CallablePerson, type CollabAction, type CollabPanel, type CollabRequest, type CollabResult, type CollabSnapshot, 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, EMPTY_COLLAB, END_MEETING_NOT_SERVED, type EffectsStorage, type EndMeetingResult, FILE_SESSION_PATH, type FollowUpDraft, type FollowUpRecipient, type FollowUpSendResult, 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 LibraryRecording, type LiveKitDriverOptions, type LobbyEntry, type LocalMediaState, type LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEETING_RECORD_GRACE_MS, 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 MeetBreakoutBroadcast, type MeetBreakoutPlan, type MeetBreakoutRoom, type MeetCollabSettings, type MeetDevice, MeetError, type MeetErrorCode, type MeetEvent, type MeetFileMedia, type MeetGrants, type MeetIdentity, type MeetParticipant, type MeetPoll, type MeetPollOption, type MeetPollState, type MeetQuestion, type MeetQuestionState, type MeetRepository, type MeetRoomDriver, type MeetSnapshot, type MeetStore, type MeetStroke, type MeetingActivities, type MeetingAttendee, type MeetingChanges, type MeetingChatHistory, type MeetingId, type MeetingInviteHandlerOptions, type MeetingInvitePayload, type MeetingInvitee, type MeetingKind, type MeetingNote, type MeetingNoteKind, type MeetingOccurrence, type MeetingRecord, type MeetingRecordAnswer, type MeetingRecordBundle, type MeetingRecordCache, type MeetingRecordChange, type MeetingRecordFailure, type MeetingRecordParts, type MeetingRecordRestriction, type MeetingRecordRestrictionNotice, type MeetingRecordState, type MeetingSearchHit, type MeetingSearchSource, 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 TranscriptFormat, type TranscriptMatch, type TranscriptSegment, type TranscriptSource, type UpcomingOccurrence, type UserId, type VideoEffect, type WrapUpAnnouncement, type WrapUpStatus, absenceSentence, activeWrapUpSummary, announceMeeting, applyCollabPacket, applyRoomEvent, asCallId, asMeetingId, asOrganizationId, asParticipantIdentity, asRoomName, asUserId, assembleMeetingRecord, assignedRoom, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoAssign, breakoutRemainingMs, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, clockPosition, collabFromState, computeStage, countLabel, createCallCenter, createCallInviteHandler, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetApi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingRecordCache, createMeetingSession, createMemoryDeviceStorage, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebRoomTokenStorage, defaultCaptionLanguage, displayNameFor, fileDownloadPath, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, invalidResponse, isGuest, isGuestIdentity, isHostRole, isListenOnly, isNoteTaker, isRealName, isRoomEventTopic, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingActivities, loadMeetingChat, loadMeetingRecord, loadMeetingRecordParts, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeRecord, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, orderParticipants, parseRoomToken, participantSummary, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, recordingLabel, recordingNotice, recordingOffsetMs, roleOf, roomTopic, searchTranscript, sendFollowUp, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, summarizeMeetingRecordRestrictions, transcriptDocument, unavailableFrom, uniqueAttendees, userTopic, wasRefused, withItem, wrapUpStatus };

package/dist/index.js

@@ -826,13 +826,13 @@ function mergeCaption(list, caption) {
   return list.map((entry, position) => position === index ? caption : entry);
 }
 function mergeRecord(list, record) {
-  const byId = list.findIndex((entry) => entry.source === "record" && entry.id === record.id);
-  if (byId !== -1) {
-    const existing = list[byId];
+  const byId2 = list.findIndex((entry) => entry.source === "record" && entry.id === record.id);
+  if (byId2 !== -1) {
+    const existing = list[byId2];
     if (existing !== void 0 && existing.text === record.text && existing.final === record.final) {
       return list;
     }
-    return list.map((entry, position) => position === byId ? record : entry);
+    return list.map((entry, position) => position === byId2 ? record : entry);
   }
   const captionIndex = list.findIndex((entry) => supersedes(record, entry));
   if (captionIndex === -1) return [...list, record];
@@ -5662,6 +5662,9 @@ function restrictionFor(part, error) {
   };
 }
 async function loadMeetingRecord(repository, meetingId, meeting, reader = { userId: null }) {
+  return assembleMeetingRecord(meeting, await loadMeetingRecordParts(repository, meetingId, reader));
+}
+async function loadMeetingRecordParts(repository, meetingId, reader = { userId: null }) {
   const restrictions = [];
   async function attempt(part, run, empty) {
     if (reader.userId === null) {
@@ -5689,6 +5692,10 @@ async function loadMeetingRecord(repository, meetingId, meeting, reader = { user
       []
     )
   ]);
+  return { attendees, notes, transcript, recordings, restrictions };
+}
+function assembleMeetingRecord(meeting, parts) {
+  const { attendees, notes, transcript, recordings, restrictions } = parts;
   return {
     meeting,
     attendees,
@@ -6033,6 +6040,210 @@ async function setGuestRecordAccess(args) {
   };
 }
 var GUEST_RECORD_NOT_SHARED = NOT_SHARED;
+
+// src/core/record-cache.ts
+var MEETING_RECORD_GRACE_MS = 6e4;
+var INITIAL = { loading: true, record: null, failure: null };
+function upsert2(rows, row, removedId, order) {
+  const id = row?.id ?? removedId;
+  if (id === void 0) return rows;
+  const rest = rows.filter((existing) => existing.id !== id);
+  return row === null ? rest : [...rest, row].sort(order);
+}
+var byId = (a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+var ascending = (a, b) => a === b ? 0 : a === null ? 1 : b === null ? -1 : a < b ? -1 : 1;
+function createMeetingRecordCache(options = {}) {
+  const graceMs = options.graceMs ?? MEETING_RECORD_GRACE_MS;
+  const entries = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  const notify = () => {
+    for (const listener of listeners) listener();
+  };
+  const entryOf = (key) => {
+    let entry = entries.get(key);
+    if (!entry) {
+      entry = {
+        state: INITIAL,
+        meeting: null,
+        parts: null,
+        fresh: false,
+        seq: 0,
+        inflight: null,
+        holders: 0,
+        close: null,
+        owner: null,
+        grace: null
+      };
+      entries.set(key, entry);
+    }
+    return entry;
+  };
+  const assemble = (entry) => {
+    if (entry.meeting === null || entry.parts === null) return;
+    entry.state = { loading: false, failure: null, record: assembleMeetingRecord(entry.meeting, entry.parts) };
+    notify();
+  };
+  return {
+    state: (key) => key === null ? INITIAL : entries.get(key)?.state ?? INITIAL,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    ensure(key, read, { force = false } = {}) {
+      const entry = entryOf(key);
+      if (!force) {
+        if (entry.inflight !== null) return entry.inflight;
+        if (entry.fresh) return Promise.resolve();
+      }
+      const seq = ++entry.seq;
+      if (entry.state.failure !== null) {
+        entry.state = { ...entry.state, loading: true, failure: null };
+        notify();
+      }
+      const request = read().then(
+        (answer) => {
+          if (seq !== entry.seq) return;
+          entry.fresh = true;
+          if (answer.kind === "parts") {
+            entry.meeting = answer.meeting;
+            entry.parts = answer.parts;
+            assemble(entry);
+          } else {
+            entry.meeting = answer.bundle.meeting;
+            entry.parts = null;
+            entry.state = { loading: false, failure: null, record: answer.bundle };
+            notify();
+          }
+        },
+        (thrown) => {
+          if (seq !== entry.seq) return;
+          entry.fresh = false;
+          entry.state = {
+            loading: false,
+            record: entry.state.record,
+            failure: {
+              message: thrown?.message ?? String(thrown),
+              remedy: thrown?.remedy ?? "The meeting record could not be read. Reload the page; nothing was changed."
+            }
+          };
+          notify();
+        }
+      );
+      const tracked = request.finally(() => {
+        if (entry.inflight === tracked) entry.inflight = null;
+      });
+      entry.inflight = tracked;
+      return tracked;
+    },
+    setMeeting(key, meeting) {
+      const entry = entries.get(key);
+      if (!entry || entry.meeting === meeting) return;
+      if (entry.parts !== null) {
+        entry.meeting = meeting;
+        assemble(entry);
+      } else if (entry.state.record !== null) {
+        entry.meeting = meeting;
+        entry.state = { ...entry.state, record: { ...entry.state.record, meeting } };
+        notify();
+      }
+    },
+    apply(key, change) {
+      const entry = entries.get(key);
+      const parts = entry?.parts;
+      if (!entry || !parts) return;
+      const refused = parts.restrictions.some((r) => r.part === change.part);
+      if (refused) return;
+      switch (change.part) {
+        case "transcript":
+          entry.parts = {
+            ...parts,
+            transcript: upsert2(
+              parts.transcript,
+              change.row,
+              change.removedId,
+              (a, b) => ascending(a.startedAt, b.startedAt) || byId(a, b)
+            )
+          };
+          break;
+        case "notes":
+          entry.parts = {
+            ...parts,
+            notes: upsert2(
+              parts.notes,
+              change.row,
+              change.removedId,
+              (a, b) => ascending(a.createdAt, b.createdAt) || byId(a, b)
+            )
+          };
+          break;
+        case "attendance":
+          entry.parts = {
+            ...parts,
+            attendees: upsert2(
+              parts.attendees,
+              change.row,
+              change.removedId,
+              (a, b) => ascending(a.joinedAt, b.joinedAt) || byId(a, b)
+            )
+          };
+          break;
+        case "recording":
+          entry.parts = {
+            ...parts,
+            // Newest first, as the read orders them.
+            recordings: upsert2(
+              parts.recordings,
+              change.row,
+              change.removedId,
+              (a, b) => ascending(b.startedAt, a.startedAt) || byId(a, b)
+            )
+          };
+          break;
+      }
+      assemble(entry);
+    },
+    hold(key, open, owner = null) {
+      const entry = entryOf(key);
+      if (entry.grace !== null) {
+        clearTimeout(entry.grace);
+        entry.grace = null;
+      }
+      if (entry.close !== null && entry.owner !== owner) {
+        entry.close();
+        entry.close = null;
+      }
+      if (entry.close === null) {
+        entry.close = open();
+        entry.owner = owner;
+      }
+      entry.holders += 1;
+      let released = false;
+      return () => {
+        if (released) return;
+        released = true;
+        entry.holders -= 1;
+        if (entry.holders > 0) return;
+        entry.grace = setTimeout(() => {
+          entry.grace = null;
+          if (entry.holders > 0) return;
+          entry.close?.();
+          entry.close = null;
+          entry.fresh = false;
+        }, graceMs);
+      };
+    },
+    reset() {
+      for (const entry of entries.values()) {
+        if (entry.grace !== null) clearTimeout(entry.grace);
+        entry.close?.();
+      }
+      entries.clear();
+      notify();
+    }
+  };
+}
 export {
   ATTENDANCE_CSV_HEADER,
   CALL_INVITE_KIND,
@@ -6054,6 +6265,7 @@ export {
   LISTEN_ONLY_NOTICE,
   MEETING_INVITE_KIND,
   MEETING_INVITE_VERSION,
+  MEETING_RECORD_GRACE_MS,
   MEET_ANSWER_CONTEXT_EVENT,
   MEET_ANSWER_EVENTS,
   MEET_EVENTS,
@@ -6088,6 +6300,7 @@ export {
   asParticipantIdentity,
   asRoomName,
   asUserId,
+  assembleMeetingRecord,
   assignedRoom,
   attendanceCsv,
   attendanceReport,
@@ -6117,6 +6330,7 @@ export {
   createMeetRepository,
   createMeetStore,
   createMeetingInviteHandler,
+  createMeetingRecordCache,
   createMeetingSession,
   createMemoryDeviceStorage,
   createRecordingController,
@@ -6151,6 +6365,7 @@ export {
   loadMeetingActivities,
   loadMeetingChat,
   loadMeetingRecord,
+  loadMeetingRecordParts,
   mapConnectionState,
   mapQuality,
   meetingInviteAction,