@ai-matrx/meet 0.11.49 → 0.11.51

package/dist/core.d.cts

@@ -246,6 +246,8 @@ interface DeviceNotice {
     readonly outcome: "switched" | "lost";
     /** The device that went away, by label (empty when the browser hid labels). */
     readonly from: string;
+    /** The device that went away, by id, so Undo can go back to it if it is plugged in again. */
+    readonly fromId?: string | undefined;
     /** The device now in use (`switched` only). */
     readonly to: string | null;
 }
@@ -888,6 +890,8 @@ interface MeetSnapshot {
     readonly captionsOn: boolean;
     /** Why asking for captions failed, in the server's words (`captions-unavailable`). */
     readonly captionsRefusal: NoteTakerRefusal | null;
+    /** `captions_start_timeout_seconds` from the token's knobs; the "Starting captions" ceiling. */
+    readonly captionsStartTimeoutSeconds: number;
     /**
      * What the LOCAL participant is actually publishing, and why not when it is
      * not. Attendance never depends on it (see `attendance.ts`): a refused
@@ -2369,6 +2373,8 @@ interface MeetingSession {
     readState(): Promise<void>;
     /** One read of the meeting's rules now (chat mode, attendee lock, time limit); resolves once they are on the store. */
     readLivePolicy(): Promise<void>;
+    /** rec-consent-gate: tell the SERVER this person agreed to being recorded (a row fact; it gives publish back). */
+    acknowledgeConsent(): Promise<void>;
     /**
      * §3.4 ER: what the server recorded for THIS connection's exit, and the run's phase. null =
      * the read failed (offline / unreachable); undefined = no meeting or no pass to ask with.
@@ -2574,6 +2580,8 @@ interface MediaSupervisor {
     acceptOffer(): Promise<void>;
     dismissOffer(): void;
     dismissNotice(): void;
+    /** Undo on a "switched" notice: go back to the device that went away, when it is available again. */
+    undoNotice(): Promise<void>;
 }
 declare function createMediaSupervisor(options: MediaSupervisorOptions): MediaSupervisor;
 
@@ -2766,6 +2774,7 @@ interface RoomEngine {
     acceptDeviceOffer(): Promise<void>;
     dismissDeviceOffer(): void;
     dismissDeviceNotice(): void;
+    undoDeviceNotice(): Promise<void>;
     /** Choose the speaker (audio output) for this meeting. */
     switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
     pin(identity: ParticipantIdentity | null): void;
@@ -2856,6 +2865,11 @@ interface ConnectionPolicy {
      * camera so their audio survives (`net-video-auto-off`); 0 = never.
      */
     readonly videoAutoOffAfterPoorSeconds: number;
+    /**
+     * `captions_start_timeout_seconds`: how long "Starting captions" may last before the person is
+     * told, honestly, that captions are unavailable (and offered Try again).
+     */
+    readonly captionsStartTimeoutSeconds: 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

@@ -246,6 +246,8 @@ interface DeviceNotice {
     readonly outcome: "switched" | "lost";
     /** The device that went away, by label (empty when the browser hid labels). */
     readonly from: string;
+    /** The device that went away, by id, so Undo can go back to it if it is plugged in again. */
+    readonly fromId?: string | undefined;
     /** The device now in use (`switched` only). */
     readonly to: string | null;
 }
@@ -888,6 +890,8 @@ interface MeetSnapshot {
     readonly captionsOn: boolean;
     /** Why asking for captions failed, in the server's words (`captions-unavailable`). */
     readonly captionsRefusal: NoteTakerRefusal | null;
+    /** `captions_start_timeout_seconds` from the token's knobs; the "Starting captions" ceiling. */
+    readonly captionsStartTimeoutSeconds: number;
     /**
      * What the LOCAL participant is actually publishing, and why not when it is
      * not. Attendance never depends on it (see `attendance.ts`): a refused
@@ -2369,6 +2373,8 @@ interface MeetingSession {
     readState(): Promise<void>;
     /** One read of the meeting's rules now (chat mode, attendee lock, time limit); resolves once they are on the store. */
     readLivePolicy(): Promise<void>;
+    /** rec-consent-gate: tell the SERVER this person agreed to being recorded (a row fact; it gives publish back). */
+    acknowledgeConsent(): Promise<void>;
     /**
      * §3.4 ER: what the server recorded for THIS connection's exit, and the run's phase. null =
      * the read failed (offline / unreachable); undefined = no meeting or no pass to ask with.
@@ -2574,6 +2580,8 @@ interface MediaSupervisor {
     acceptOffer(): Promise<void>;
     dismissOffer(): void;
     dismissNotice(): void;
+    /** Undo on a "switched" notice: go back to the device that went away, when it is available again. */
+    undoNotice(): Promise<void>;
 }
 declare function createMediaSupervisor(options: MediaSupervisorOptions): MediaSupervisor;
 
@@ -2766,6 +2774,7 @@ interface RoomEngine {
     acceptDeviceOffer(): Promise<void>;
     dismissDeviceOffer(): void;
     dismissDeviceNotice(): void;
+    undoDeviceNotice(): Promise<void>;
     /** Choose the speaker (audio output) for this meeting. */
     switchDevice(kind: "audioinput" | "videoinput" | "audiooutput", deviceId: string): Promise<void>;
     pin(identity: ParticipantIdentity | null): void;
@@ -2856,6 +2865,11 @@ interface ConnectionPolicy {
      * camera so their audio survives (`net-video-auto-off`); 0 = never.
      */
     readonly videoAutoOffAfterPoorSeconds: number;
+    /**
+     * `captions_start_timeout_seconds`: how long "Starting captions" may last before the person is
+     * told, honestly, that captions are unavailable (and offered Try again).
+     */
+    readonly captionsStartTimeoutSeconds: number;
 }
 /** The knob defaults (§4.3) — what an older server that sends nothing gets. */
 declare const DEFAULT_CONNECTION_POLICY: ConnectionPolicy;

package/dist/core.js

@@ -216,7 +216,8 @@ var DEFAULT_CONNECTION_POLICY = {
   autoRejoin: true,
   autoRejoinMaxAttempts: 5,
   reconnectGraceSeconds: 30,
-  videoAutoOffAfterPoorSeconds: 20
+  videoAutoOffAfterPoorSeconds: 20,
+  captionsStartTimeoutSeconds: 20
 };
 function clampInt(value, min, max, fallback) {
   if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
@@ -231,7 +232,8 @@ function connectionPolicyFrom(raw) {
     autoRejoin: typeof row["auto_rejoin"] === "boolean" ? row["auto_rejoin"] : d.autoRejoin,
     autoRejoinMaxAttempts: clampInt(row["auto_rejoin_max_attempts"], 0, 20, d.autoRejoinMaxAttempts),
     reconnectGraceSeconds: clampInt(row["reconnect_grace_seconds"], 0, 600, d.reconnectGraceSeconds),
-    videoAutoOffAfterPoorSeconds: clampInt(row["video_auto_off_after_poor_seconds"], 0, 600, d.videoAutoOffAfterPoorSeconds)
+    videoAutoOffAfterPoorSeconds: clampInt(row["video_auto_off_after_poor_seconds"], 0, 600, d.videoAutoOffAfterPoorSeconds),
+    captionsStartTimeoutSeconds: clampInt(row["captions_start_timeout_seconds"], 1, 600, d.captionsStartTimeoutSeconds)
   };
 }
 var LIVEKIT_BASE_DELAYS_MS = [0, 300, 1200, 2700, 4800, 7e3];
@@ -3643,6 +3645,7 @@ var EMPTY = {
   noteTakerRefusal: null,
   captionsOn: false,
   captionsRefusal: null,
+  captionsStartTimeoutSeconds: 20,
   media: IDLE_MEDIA,
   mediaRegion: IDLE_MEDIA_REGION,
   failure: null,
@@ -4078,11 +4081,10 @@ function moderationText(kind, payload) {
   switch (kind) {
     case "muted": {
       const source = text2(payload["source"]) ?? "microphone";
-      const who = payload["by_role"] === "host" || payload["by_role"] === "cohost" ? "the host" : by;
-      return source === "microphone" ? `You've been muted by ${who}.` : source === "camera" ? `Your camera was turned off by ${who}.` : `Your screen share was stopped by ${who}.`;
+      return source === "microphone" ? `${by} muted you.` : source === "camera" ? `${by} turned off your camera.` : `${by} stopped your screen share.`;
     }
     case "ask-unmute":
-      return `${by === "The host" ? "The host" : by} asked you to unmute.`;
+      return `${by} is asking you to unmute.`;
     case "removed":
       return `${by} removed you from this meeting.`;
     default:
@@ -4108,7 +4110,7 @@ function applyModeration(store, payload, now) {
           grants: { ...snapshot.grants, role },
           moderationNotice: {
             kind: "role",
-            text: role === "host" ? "You are now the host." : role === "cohost" ? "You're now a co-host." : role === "presenter" ? "You're now a presenter." : snapshot.grants.role === "presenter" ? "You're now a participant: you can no longer present." : "You're now a participant: you are no longer a co-host.",
+            text: role === "host" ? "You are now the host." : role === "cohost" ? "You are now a co-host." : role === "presenter" ? "You are now a presenter." : snapshot.grants.role === "presenter" ? "You are now a participant: you can no longer present." : "You are no longer a co-host.",
             at: now()
           }
         });
@@ -5368,7 +5370,10 @@ function createMeetingSession(options) {
     const meeting = store.snapshot().meeting;
     const pass = options.resolvePass?.() ?? null;
     if (meeting === null || pass === null) return;
-    if (policyReading) return policyInFlight ?? void 0;
+    if (policyReading) {
+      await (policyInFlight ?? void 0);
+      return readLivePolicy();
+    }
     policyReading = true;
     let done = () => void 0;
     policyInFlight = new Promise((resolve) => done = resolve);
@@ -5389,6 +5394,9 @@ function createMeetingSession(options) {
       if (!samePolicy(snapshot.livePolicy, next) || startedAt !== snapshot.sessionStartedAt) {
         store.patch({ livePolicy: next, sessionStartedAt: startedAt });
       }
+      if (read.consent_given === true && !store.snapshot().recordingConsentGiven) {
+        store.patch({ recordingConsentGiven: true });
+      }
     } catch {
     } finally {
       policyReading = false;
@@ -5693,6 +5701,21 @@ function createMeetingSession(options) {
     stopWaiting,
     readState: readState2,
     readLivePolicy,
+    async acknowledgeConsent() {
+      const meeting = requireMeeting("meet.consent");
+      const pass = options.resolvePass?.() ?? null;
+      const response = await options.api.request({
+        path: MEET_ROUTES.consent,
+        method: "POST",
+        requireAuth: false,
+        operation: "meet.consent",
+        body: { meeting_id: meeting.id },
+        ...pass !== null ? { headers: { [MEETING_PASS_HEADER]: pass } } : {}
+      });
+      if (!response.ok) {
+        throw new MeetError("transport", `meet.consent: the server answered ${response.status}`, "Your agreement was not saved. Try again.");
+      }
+    },
     async readExit(connection, held) {
       const meeting = store.snapshot().meeting;
       const pass = held ?? options.resolvePass?.() ?? null;
@@ -6564,7 +6587,9 @@ function createMediaSupervisor(options) {
       const deviceKind = INPUT_KIND[kind];
       const previous = inUse[deviceKind];
       const track = store.snapshot().media[kind];
-      const gone = previous !== null && !isAlias(previous) && before[deviceKind].has(previous) && !now[deviceKind].has(previous);
+      const aliasLabel = previous !== null && isAlias(previous) ? before[deviceKind].get(previous) : void 0;
+      const aliasGone = previous !== null && aliasLabel !== void 0 && aliasLabel !== "" && (!now[deviceKind].has(previous) || now[deviceKind].get(previous) !== aliasLabel);
+      const gone = aliasGone || previous !== null && !isAlias(previous) && before[deviceKind].has(previous) && !now[deviceKind].has(previous);
       if (gone) {
         const from = before[deviceKind].get(previous) ?? "";
         const remaining = [...now[deviceKind].entries()].filter(([id]) => !isAlias(id));
@@ -6589,7 +6614,7 @@ function createMediaSupervisor(options) {
               await driver.setCameraEnabled(true);
               store.setLocalTrack("camera", { enabled: true, unavailable: null });
             }
-            setRegion({ notice: { id: ++noticeId, kind, outcome: "switched", from, to: nextLabel } });
+            setRegion({ notice: { id: ++noticeId, kind, outcome: "switched", from, fromId: previous, to: nextLabel } });
           } catch (error) {
             const refused = await unavailable(error, "camera", "meet.camera(fallback)");
             store.setLocalTrack("camera", { enabled: false, unavailable: refused });
@@ -6597,8 +6622,24 @@ function createMediaSupervisor(options) {
           }
         } else {
           const active = driver.activeDevices().audioinput;
-          const to = (active !== null ? now.audioinput.get(active) : void 0) ?? now.audioinput.get("default") ?? remaining[0][1];
-          setRegion({ notice: { id: ++noticeId, kind, outcome: "switched", from, to } });
+          let to = (active !== null && !aliasGone ? now.audioinput.get(active) : void 0) ?? now.audioinput.get("default");
+          if (to === void 0 || aliasGone) {
+            const [nextId, nextLabel] = remaining[0];
+            try {
+              await driver.switchDevice("audioinput", nextId);
+              if (track.enabled || track.unavailable !== null) {
+                await driver.setMicrophoneEnabled(true);
+                store.setLocalTrack("microphone", { enabled: true, unavailable: null });
+              }
+              to = nextLabel;
+            } catch (error) {
+              const refused = await unavailable(error, "microphone", "meet.microphone(fallback)");
+              store.setLocalTrack("microphone", { enabled: false, unavailable: refused });
+              setRegion({ notice: { id: ++noticeId, kind, outcome: "lost", from, to: null } });
+              continue;
+            }
+          }
+          setRegion({ notice: { id: ++noticeId, kind, outcome: "switched", from, fromId: previous, to } });
         }
         continue;
       }
@@ -6703,6 +6744,21 @@ function createMediaSupervisor(options) {
     },
     dismissNotice() {
       setRegion({ notice: null });
+    },
+    async undoNotice() {
+      const notice = region().notice;
+      setRegion({ notice: null });
+      const driver = options.driver();
+      if (notice === null || notice.outcome !== "switched" || notice.fromId === void 0 || driver === null) return;
+      const list = await snapshotDevices();
+      if (!list[INPUT_KIND[notice.kind]].has(notice.fromId)) return;
+      try {
+        await driver.switchDevice(INPUT_KIND[notice.kind], notice.fromId);
+        readInUse();
+      } catch (error) {
+        const refused = await unavailable(error, notice.kind, "meet.undoDeviceSwitch");
+        store.setLocalTrack(notice.kind, { enabled: false, unavailable: refused });
+      }
     }
   };
   return api;
@@ -6917,7 +6973,14 @@ function createRoomEngine(options) {
       const latest = store.snapshot().meeting;
       if (latest === null) return;
       store.patch({ meeting: { ...latest, endedAt: verified.endedAt } });
-      store.dispatch({ type: "ended" }, { reason: "ended" });
+      const connection = current?.connectionIdentity ?? current?.identity ?? store.snapshot().localIdentity ?? null;
+      let why;
+      try {
+        why = options.readExit !== void 0 && connection !== null ? await options.readExit(connection, current?.meetingPass ?? null) : void 0;
+      } catch {
+        why = null;
+      }
+      store.dispatch({ type: "ended" }, { reason: why?.exitReason === "time_limit" ? "time_limit" : "ended" });
       await dropRoom();
       options.onLeft?.("ended");
     } catch (error) {
@@ -7245,6 +7308,7 @@ function createRoomEngine(options) {
     current = token;
     lastServerUrl = token.serverUrl;
     connectionPolicy = token.connectionPolicy ?? DEFAULT_CONNECTION_POLICY;
+    store.patch({ captionsStartTimeoutSeconds: connectionPolicy.captionsStartTimeoutSeconds });
     if (token.leavePolicy !== void 0) store.patch({ leavePolicy: token.leavePolicy });
     store.patch({ canReclaim: token.canReclaim === true });
     store.patch({
@@ -7689,6 +7753,7 @@ function createRoomEngine(options) {
     acceptDeviceOffer: () => media.acceptOffer(),
     dismissDeviceOffer: () => media.dismissOffer(),
     dismissDeviceNotice: () => media.dismissNotice(),
+    undoDeviceNotice: () => media.undoNotice(),
     pin(who) {
       store.patch({ pinned: who, layout: who === null ? "grid" : "speaker" });
     },