@ai-matrx/meet 0.11.47 → 0.11.49

package/dist/core.d.cts

@@ -1,5 +1,5 @@
-import { P as ParticipantIdentity, e as ParticipantRole, k as AdmissionState, a1 as NoteTakerState, a as MeetParticipant, M as MeetingRecord, R as RoomName, d as CallInvite, a6 as ParticipantStanding, a3 as ObserversVisibleTo, S as StageLayout, L as LobbyEntry, aa as RecordingState, U as UserId, aF as RecordingSource, ae as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, j as CollabSnapshot, p as ConnectionQuality, h as MeetingId, b as MeetApi, f as CallMode, O as OrganizationId, m as CallId, n as CallState, Z as MeetingKind, a8 as RecordingPolicy, V as MeetingAttendee, a9 as RecordingRecord, a0 as MeetingSettings, X as MeetingChanges, a4 as OccurrenceOverride, $ as MeetingOccurrence, af as UpcomingOccurrence, Y as MeetingInvitee, I as InviteeInput, q as InviteeRole, ab as RsvpAnswer, ac as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-D1TX5uf9.cjs';
-export { A as AccessTokenSource, l as CAPTION_LANGUAGES, o as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, r as JsonValue, s as MeetApiOptions, t as MeetApiRequest, u as MeetAppFocus, v as MeetBreakoutBroadcast, w as MeetBreakoutPlan, x as MeetBreakoutRoom, y as MeetCollabSettings, z as MeetFileMedia, B as MeetPoll, D as MeetPollOption, G as MeetPollState, H as MeetQuestion, K as MeetQuestionState, N as MeetStroke, Q as MeetingActivities, i as MeetingAppPanel, _ as MeetingNoteKind, a2 as ORGANIZATION_HEADER, a5 as OccurrenceState, a7 as ROLE_RANK, ad as RsvpState, T as TranscriptSource, ag as appPanelOf, ah as applyCollabPacket, ai as asCallId, aj as asMeetingId, ak as asOrganizationId, al as asParticipantIdentity, am as asRoomName, an as asUserId, ao as assignedRoom, ap as autoAssign, aq as breakoutClosingMs, ar as breakoutRemainingMs, as as captureHeldOf, at as collabFromState, au as createMeetApi, av as defaultCaptionLanguage, aw as fileDownloadPath, ax as focusFromRow, ay as isGuest, az as isHostRole, aA as isLinkFollower, aB as isObserverRole, aC as loadMeetingActivities, aD as scheduleSettingsPatch, aE as withItem } from './collab-D1TX5uf9.cjs';
+import { P as ParticipantIdentity, e as ParticipantRole, k as AdmissionState, a1 as NoteTakerState, a as MeetParticipant, M as MeetingRecord, R as RoomName, d as CallInvite, a6 as ParticipantStanding, a3 as ObserversVisibleTo, S as StageLayout, L as LobbyEntry, aa as RecordingState, U as UserId, aF as RecordingSource, ae as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, j as CollabSnapshot, p as ConnectionQuality, h as MeetingId, b as MeetApi, f as CallMode, O as OrganizationId, m as CallId, n as CallState, Z as MeetingKind, a8 as RecordingPolicy, V as MeetingAttendee, a9 as RecordingRecord, a0 as MeetingSettings, X as MeetingChanges, a4 as OccurrenceOverride, $ as MeetingOccurrence, af as UpcomingOccurrence, Y as MeetingInvitee, I as InviteeInput, q as InviteeRole, ab as RsvpAnswer, ac as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-Dk3r37MW.cjs';
+export { A as AccessTokenSource, l as CAPTION_LANGUAGES, o as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, r as JsonValue, s as MeetApiOptions, t as MeetApiRequest, u as MeetAppFocus, v as MeetBreakoutBroadcast, w as MeetBreakoutPlan, x as MeetBreakoutRoom, y as MeetCollabSettings, z as MeetFileMedia, B as MeetPoll, D as MeetPollOption, G as MeetPollState, H as MeetQuestion, K as MeetQuestionState, N as MeetStroke, Q as MeetingActivities, i as MeetingAppPanel, _ as MeetingNoteKind, a2 as ORGANIZATION_HEADER, a5 as OccurrenceState, a7 as ROLE_RANK, ad as RsvpState, T as TranscriptSource, ag as appPanelOf, ah as applyCollabPacket, ai as asCallId, aj as asMeetingId, ak as asOrganizationId, al as asParticipantIdentity, am as asRoomName, an as asUserId, ao as assignedRoom, ap as autoAssign, aq as breakoutClosingMs, ar as breakoutRemainingMs, as as captureHeldOf, at as collabFromState, au as createMeetApi, av as defaultCaptionLanguage, aw as fileDownloadPath, ax as focusFromRow, ay as isGuest, az as isHostRole, aA as isLinkFollower, aB as isObserverRole, aC as loadMeetingActivities, aD as scheduleSettingsPatch, aE as withItem } from './collab-Dk3r37MW.cjs';
 import { RealtimeManager } from '@ai-matrx/realtime';
 import { MessagingSupabaseClient, ActionHandler } from '@ai-matrx/messaging';
 import { RoomOptions, ConnectionQuality as ConnectionQuality$1, Participant } from 'livekit-client';
@@ -172,13 +172,21 @@ declare function leaveChoices(args: {
 type ChatMode = "everyone" | "hosts_only" | "off";
 type AvLock = "off" | "mic" | "camera" | "both";
 type RecordingConsent = "notice" | "ok_or_leave" | "view_only_until_agree";
+/** Who may share a screen (`share_who_can`) and how many may at once (`share_concurrency`). */
+type ShareWhoCan = "everyone" | "host_only" | "org" | "presenters";
+type ShareConcurrency = "one_takeover" | "one_replace" | "multiple";
+/** What remains when no host or co-host is in the room (`headless_powers`, CORE-DESIGN §4.2). */
+type HeadlessPowers = "members_admit" | "none" | "cohosts_only";
 interface LivePolicy {
+    readonly headlessPowers: HeadlessPowers;
     readonly chatMode: ChatMode;
     readonly avLock: AvLock;
     /** 0 = no limit. */
     readonly timeLimitMinutes: number;
     readonly timeLimitWarningMinutes: number;
     readonly recordingConsent: RecordingConsent;
+    readonly shareWhoCan: ShareWhoCan;
+    readonly shareConcurrency: ShareConcurrency;
 }
 
 /**
@@ -689,15 +697,25 @@ interface MeetWaiting {
     readonly liveVersion: number;
 }
 /** The core's `connection` region (CORE-DESIGN §3.2) — never a phase. */
+interface LocalNetwork {
+    readonly path: "direct" | "restricted" | "unknown";
+    readonly quality: "good" | "poor" | "unknown";
+    readonly videoPaused: boolean;
+}
 type ConnectionRegion = "stable" | "signal_reconnecting" | "reconnecting" | "offline" | "server_unreachable";
 /**
  * The core's `share` region (CORE-DESIGN §3.2/§3.3 SA). A refused share is a situation the person
  * is in — a notice (`share-unavailable`), never a phase.
  */
 interface ShareRegion {
-    readonly state: "none" | "picking" | "presenting" | "refused";
-    /** Why a share was refused: this browser cannot share, the system blocks it, or it failed. */
-    readonly reason: "unsupported" | "blocked" | "failed" | null;
+    readonly state: "none" | "picking" | "presenting" | "refused" | "ended";
+    /**
+     * Why a share was refused (this browser cannot share, the system blocks it, or it failed) or, for
+     * `ended`, why the server took it down: someone else presented instead, or the host's rule no longer lets this person share.
+     */
+    readonly reason: "unsupported" | "blocked" | "failed" | "replaced" | "not_allowed" | null;
+    /** `ended` / `replaced`: who presents now. */
+    readonly by?: string;
     /** The fix, in the core's words (system setting, administrator policy, …), or null. */
     readonly remedy: string | null;
     readonly at: number;
@@ -725,6 +743,13 @@ interface MeetSnapshot {
      * drop outlasts `reconnect_banner_delay_ms` (the connection supervisor sets it, §3.3 CS).
      */
     readonly connectionBanner: boolean;
+    /**
+     * P1 connection-network — THIS tab's own path, as the core judged it from its WebRTC stats
+     * (`network-health.ts`): `restricted` = relayed or TCP-only (`net-udp-blocked`), `quality` =
+     * the self-assessment (`net-quality-self`), `videoPaused` = the camera was paused by the
+     * network to keep the audio (`net-video-auto-off`). The room engine is the one writer.
+     */
+    readonly localNetwork: LocalNetwork;
     /** The `share` region. */
     readonly share: ShareRegion;
     /**
@@ -1960,6 +1985,44 @@ declare function computeStage(args: StageArgs): Stage;
 /** Column count for a grid of N tiles — the shape that keeps tiles squarest. */
 declare function gridColumns(count: number): number;
 
+/**
+ * NETWORK HEALTH (CORE-DESIGN §3.3 CS, P1 connection-network) — the pure rules behind what each
+ * person sees when a network degrades. No socket, no timer, no browser global: the driver hands
+ * in readings, the engine hands in the clock, and every rule here is provable in a node test.
+ *
+ * Why the core judges quality itself and does not only repeat LiveKit's `ConnectionQuality`:
+ * LiveKit scores a TCP/TURN path with 800 ms of round trip as "good" (no packets are lost on
+ * TCP — they are just late), and it keeps a participant whose cable was pulled "good" for 25 s
+ * and more. Google Meet documents media quality degrading at RTT ≥ 300 ms; that is the bar here.
+ *
+ * Four rules:
+ * 1. **Self-assessment** (`createSelfAssessor`): this tab's own path, from its WebRTC stats —
+ *    round trip, loss — with hysteresis so the reading does not flap.
+ * 2. **The path** (`pathOf`): media relayed over TURN or carried over TCP is a restricted network
+ *    (`net-udp-blocked`): the call works, quality may be reduced.
+ * 3. **Liveness** (`createLivenessTracker`): every client says "alive" on a light data heartbeat
+ *    that carries its own reading and whether its video is paused. A person who goes silent past
+ *    `staleAfterMs` is shown `reconnecting` to everyone else (`net-others-see-drop`) — long before
+ *    the media server gives up on them. A client that never sent a heartbeat (an agent, an older
+ *    client) is never judged by it.
+ * 4. **Video auto-off** (`createVideoAutoOff`): a poor reading that lasts
+ *    `video_auto_off_after_poor_seconds` pauses this person's camera so their audio survives
+ *    (`net-video-auto-off`); a person who turns it back on is not paused again until the path has
+ *    recovered once.
+ */
+
+/** One sample of this tab's WebRTC path, as the driver read it from `getStats()`. */
+interface NetworkReading {
+    /** Selected candidate pair's current round trip (ms), or null when not known. */
+    readonly rttMs: number | null;
+    /** Fraction of packets lost since the previous sample (0..1), or null. */
+    readonly lossRatio: number | null;
+    /** The selected local candidate is a TURN relay. */
+    readonly relayed: boolean | null;
+    /** The selected local candidate carries media over TCP. */
+    readonly tcp: boolean | null;
+}
+
 /**
  * THE MEDIA SEAM — the ONE interface the room engine talks to.
  *
@@ -2062,6 +2125,12 @@ interface RoomDriverHandlers {
     devicesChanged?(): void;
     /** S6c — the SDK could not acquire or keep a local device. `kind` when the SDK knows it. */
     mediaDeviceError?(error: unknown, kind: "audioinput" | "videoinput" | null): void;
+    /**
+     * P1 connection-network — one sample of THIS tab's WebRTC path (round trip, loss, relay/TCP),
+     * read from the peer connections' stats every couple of seconds while connected. The rules
+     * that turn samples into what people see are `network-health.ts`. Optional for older drivers.
+     */
+    networkReading?(reading: NetworkReading): void;
 }
 /** A camera background effect. `image` replaces the background with `imageUrl`. */
 type VideoEffect = {
@@ -2782,6 +2851,11 @@ interface ConnectionPolicy {
     readonly autoRejoinMaxAttempts: number;
     /** `reconnect_grace_seconds`: how long others keep a dropped person's `reconnecting` tile. */
     readonly reconnectGraceSeconds: number;
+    /**
+     * `video_auto_off_after_poor_seconds`: a poor path that lasts this long pauses the person's
+     * camera so their audio survives (`net-video-auto-off`); 0 = never.
+     */
+    readonly videoAutoOffAfterPoorSeconds: number;
 }
 /** The knob defaults (§4.3) — what an older server that sends nothing gets. */
 declare const DEFAULT_CONNECTION_POLICY: ConnectionPolicy;

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { P as ParticipantIdentity, e as ParticipantRole, k as AdmissionState, a1 as NoteTakerState, a as MeetParticipant, M as MeetingRecord, R as RoomName, d as CallInvite, a6 as ParticipantStanding, a3 as ObserversVisibleTo, S as StageLayout, L as LobbyEntry, aa as RecordingState, U as UserId, aF as RecordingSource, ae as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, j as CollabSnapshot, p as ConnectionQuality, h as MeetingId, b as MeetApi, f as CallMode, O as OrganizationId, m as CallId, n as CallState, Z as MeetingKind, a8 as RecordingPolicy, V as MeetingAttendee, a9 as RecordingRecord, a0 as MeetingSettings, X as MeetingChanges, a4 as OccurrenceOverride, $ as MeetingOccurrence, af as UpcomingOccurrence, Y as MeetingInvitee, I as InviteeInput, q as InviteeRole, ab as RsvpAnswer, ac as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-D1TX5uf9.js';
-export { A as AccessTokenSource, l as CAPTION_LANGUAGES, o as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, r as JsonValue, s as MeetApiOptions, t as MeetApiRequest, u as MeetAppFocus, v as MeetBreakoutBroadcast, w as MeetBreakoutPlan, x as MeetBreakoutRoom, y as MeetCollabSettings, z as MeetFileMedia, B as MeetPoll, D as MeetPollOption, G as MeetPollState, H as MeetQuestion, K as MeetQuestionState, N as MeetStroke, Q as MeetingActivities, i as MeetingAppPanel, _ as MeetingNoteKind, a2 as ORGANIZATION_HEADER, a5 as OccurrenceState, a7 as ROLE_RANK, ad as RsvpState, T as TranscriptSource, ag as appPanelOf, ah as applyCollabPacket, ai as asCallId, aj as asMeetingId, ak as asOrganizationId, al as asParticipantIdentity, am as asRoomName, an as asUserId, ao as assignedRoom, ap as autoAssign, aq as breakoutClosingMs, ar as breakoutRemainingMs, as as captureHeldOf, at as collabFromState, au as createMeetApi, av as defaultCaptionLanguage, aw as fileDownloadPath, ax as focusFromRow, ay as isGuest, az as isHostRole, aA as isLinkFollower, aB as isObserverRole, aC as loadMeetingActivities, aD as scheduleSettingsPatch, aE as withItem } from './collab-D1TX5uf9.js';
+import { P as ParticipantIdentity, e as ParticipantRole, k as AdmissionState, a1 as NoteTakerState, a as MeetParticipant, M as MeetingRecord, R as RoomName, d as CallInvite, a6 as ParticipantStanding, a3 as ObserversVisibleTo, S as StageLayout, L as LobbyEntry, aa as RecordingState, U as UserId, aF as RecordingSource, ae as TranscriptSegment, g as MeetingNote, W as WrapUpAnnouncement, j as CollabSnapshot, p as ConnectionQuality, h as MeetingId, b as MeetApi, f as CallMode, O as OrganizationId, m as CallId, n as CallState, Z as MeetingKind, a8 as RecordingPolicy, V as MeetingAttendee, a9 as RecordingRecord, a0 as MeetingSettings, X as MeetingChanges, a4 as OccurrenceOverride, $ as MeetingOccurrence, af as UpcomingOccurrence, Y as MeetingInvitee, I as InviteeInput, q as InviteeRole, ab as RsvpAnswer, ac as RsvpInvitation, c as MeetIdentity, C as CollabPanel } from './collab-Dk3r37MW.js';
+export { A as AccessTokenSource, l as CAPTION_LANGUAGES, o as CallablePerson, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, J as JsonObject, r as JsonValue, s as MeetApiOptions, t as MeetApiRequest, u as MeetAppFocus, v as MeetBreakoutBroadcast, w as MeetBreakoutPlan, x as MeetBreakoutRoom, y as MeetCollabSettings, z as MeetFileMedia, B as MeetPoll, D as MeetPollOption, G as MeetPollState, H as MeetQuestion, K as MeetQuestionState, N as MeetStroke, Q as MeetingActivities, i as MeetingAppPanel, _ as MeetingNoteKind, a2 as ORGANIZATION_HEADER, a5 as OccurrenceState, a7 as ROLE_RANK, ad as RsvpState, T as TranscriptSource, ag as appPanelOf, ah as applyCollabPacket, ai as asCallId, aj as asMeetingId, ak as asOrganizationId, al as asParticipantIdentity, am as asRoomName, an as asUserId, ao as assignedRoom, ap as autoAssign, aq as breakoutClosingMs, ar as breakoutRemainingMs, as as captureHeldOf, at as collabFromState, au as createMeetApi, av as defaultCaptionLanguage, aw as fileDownloadPath, ax as focusFromRow, ay as isGuest, az as isHostRole, aA as isLinkFollower, aB as isObserverRole, aC as loadMeetingActivities, aD as scheduleSettingsPatch, aE as withItem } from './collab-Dk3r37MW.js';
 import { RealtimeManager } from '@ai-matrx/realtime';
 import { MessagingSupabaseClient, ActionHandler } from '@ai-matrx/messaging';
 import { RoomOptions, ConnectionQuality as ConnectionQuality$1, Participant } from 'livekit-client';
@@ -172,13 +172,21 @@ declare function leaveChoices(args: {
 type ChatMode = "everyone" | "hosts_only" | "off";
 type AvLock = "off" | "mic" | "camera" | "both";
 type RecordingConsent = "notice" | "ok_or_leave" | "view_only_until_agree";
+/** Who may share a screen (`share_who_can`) and how many may at once (`share_concurrency`). */
+type ShareWhoCan = "everyone" | "host_only" | "org" | "presenters";
+type ShareConcurrency = "one_takeover" | "one_replace" | "multiple";
+/** What remains when no host or co-host is in the room (`headless_powers`, CORE-DESIGN §4.2). */
+type HeadlessPowers = "members_admit" | "none" | "cohosts_only";
 interface LivePolicy {
+    readonly headlessPowers: HeadlessPowers;
     readonly chatMode: ChatMode;
     readonly avLock: AvLock;
     /** 0 = no limit. */
     readonly timeLimitMinutes: number;
     readonly timeLimitWarningMinutes: number;
     readonly recordingConsent: RecordingConsent;
+    readonly shareWhoCan: ShareWhoCan;
+    readonly shareConcurrency: ShareConcurrency;
 }
 
 /**
@@ -689,15 +697,25 @@ interface MeetWaiting {
     readonly liveVersion: number;
 }
 /** The core's `connection` region (CORE-DESIGN §3.2) — never a phase. */
+interface LocalNetwork {
+    readonly path: "direct" | "restricted" | "unknown";
+    readonly quality: "good" | "poor" | "unknown";
+    readonly videoPaused: boolean;
+}
 type ConnectionRegion = "stable" | "signal_reconnecting" | "reconnecting" | "offline" | "server_unreachable";
 /**
  * The core's `share` region (CORE-DESIGN §3.2/§3.3 SA). A refused share is a situation the person
  * is in — a notice (`share-unavailable`), never a phase.
  */
 interface ShareRegion {
-    readonly state: "none" | "picking" | "presenting" | "refused";
-    /** Why a share was refused: this browser cannot share, the system blocks it, or it failed. */
-    readonly reason: "unsupported" | "blocked" | "failed" | null;
+    readonly state: "none" | "picking" | "presenting" | "refused" | "ended";
+    /**
+     * Why a share was refused (this browser cannot share, the system blocks it, or it failed) or, for
+     * `ended`, why the server took it down: someone else presented instead, or the host's rule no longer lets this person share.
+     */
+    readonly reason: "unsupported" | "blocked" | "failed" | "replaced" | "not_allowed" | null;
+    /** `ended` / `replaced`: who presents now. */
+    readonly by?: string;
     /** The fix, in the core's words (system setting, administrator policy, …), or null. */
     readonly remedy: string | null;
     readonly at: number;
@@ -725,6 +743,13 @@ interface MeetSnapshot {
      * drop outlasts `reconnect_banner_delay_ms` (the connection supervisor sets it, §3.3 CS).
      */
     readonly connectionBanner: boolean;
+    /**
+     * P1 connection-network — THIS tab's own path, as the core judged it from its WebRTC stats
+     * (`network-health.ts`): `restricted` = relayed or TCP-only (`net-udp-blocked`), `quality` =
+     * the self-assessment (`net-quality-self`), `videoPaused` = the camera was paused by the
+     * network to keep the audio (`net-video-auto-off`). The room engine is the one writer.
+     */
+    readonly localNetwork: LocalNetwork;
     /** The `share` region. */
     readonly share: ShareRegion;
     /**
@@ -1960,6 +1985,44 @@ declare function computeStage(args: StageArgs): Stage;
 /** Column count for a grid of N tiles — the shape that keeps tiles squarest. */
 declare function gridColumns(count: number): number;
 
+/**
+ * NETWORK HEALTH (CORE-DESIGN §3.3 CS, P1 connection-network) — the pure rules behind what each
+ * person sees when a network degrades. No socket, no timer, no browser global: the driver hands
+ * in readings, the engine hands in the clock, and every rule here is provable in a node test.
+ *
+ * Why the core judges quality itself and does not only repeat LiveKit's `ConnectionQuality`:
+ * LiveKit scores a TCP/TURN path with 800 ms of round trip as "good" (no packets are lost on
+ * TCP — they are just late), and it keeps a participant whose cable was pulled "good" for 25 s
+ * and more. Google Meet documents media quality degrading at RTT ≥ 300 ms; that is the bar here.
+ *
+ * Four rules:
+ * 1. **Self-assessment** (`createSelfAssessor`): this tab's own path, from its WebRTC stats —
+ *    round trip, loss — with hysteresis so the reading does not flap.
+ * 2. **The path** (`pathOf`): media relayed over TURN or carried over TCP is a restricted network
+ *    (`net-udp-blocked`): the call works, quality may be reduced.
+ * 3. **Liveness** (`createLivenessTracker`): every client says "alive" on a light data heartbeat
+ *    that carries its own reading and whether its video is paused. A person who goes silent past
+ *    `staleAfterMs` is shown `reconnecting` to everyone else (`net-others-see-drop`) — long before
+ *    the media server gives up on them. A client that never sent a heartbeat (an agent, an older
+ *    client) is never judged by it.
+ * 4. **Video auto-off** (`createVideoAutoOff`): a poor reading that lasts
+ *    `video_auto_off_after_poor_seconds` pauses this person's camera so their audio survives
+ *    (`net-video-auto-off`); a person who turns it back on is not paused again until the path has
+ *    recovered once.
+ */
+
+/** One sample of this tab's WebRTC path, as the driver read it from `getStats()`. */
+interface NetworkReading {
+    /** Selected candidate pair's current round trip (ms), or null when not known. */
+    readonly rttMs: number | null;
+    /** Fraction of packets lost since the previous sample (0..1), or null. */
+    readonly lossRatio: number | null;
+    /** The selected local candidate is a TURN relay. */
+    readonly relayed: boolean | null;
+    /** The selected local candidate carries media over TCP. */
+    readonly tcp: boolean | null;
+}
+
 /**
  * THE MEDIA SEAM — the ONE interface the room engine talks to.
  *
@@ -2062,6 +2125,12 @@ interface RoomDriverHandlers {
     devicesChanged?(): void;
     /** S6c — the SDK could not acquire or keep a local device. `kind` when the SDK knows it. */
     mediaDeviceError?(error: unknown, kind: "audioinput" | "videoinput" | null): void;
+    /**
+     * P1 connection-network — one sample of THIS tab's WebRTC path (round trip, loss, relay/TCP),
+     * read from the peer connections' stats every couple of seconds while connected. The rules
+     * that turn samples into what people see are `network-health.ts`. Optional for older drivers.
+     */
+    networkReading?(reading: NetworkReading): void;
 }
 /** A camera background effect. `image` replaces the background with `imageUrl`. */
 type VideoEffect = {
@@ -2782,6 +2851,11 @@ interface ConnectionPolicy {
     readonly autoRejoinMaxAttempts: number;
     /** `reconnect_grace_seconds`: how long others keep a dropped person's `reconnecting` tile. */
     readonly reconnectGraceSeconds: number;
+    /**
+     * `video_auto_off_after_poor_seconds`: a poor path that lasts this long pauses the person's
+     * camera so their audio survives (`net-video-auto-off`); 0 = never.
+     */
+    readonly videoAutoOffAfterPoorSeconds: number;
 }
 /** The knob defaults (§4.3) — what an older server that sends nothing gets. */
 declare const DEFAULT_CONNECTION_POLICY: ConnectionPolicy;