@ai-matrx/meet 0.10.0 → 0.10.1

package/dist/core.cjs

@@ -80,6 +80,7 @@ __export(core_exports, {
   activeWrapUpSummary: () => activeWrapUpSummary,
   activityAttention: () => activityAttention,
   announceMeeting: () => announceMeeting,
+  appPanelOf: () => appPanelOf,
   applyCollabPacket: () => applyCollabPacket,
   applyRoomEvent: () => applyRoomEvent,
   asCallId: () => asCallId,
@@ -131,6 +132,7 @@ __export(core_exports, {
   defaultCaptionLanguage: () => defaultCaptionLanguage,
   displayNameFor: () => displayNameFor,
   fileDownloadPath: () => fileDownloadPath,
+  focusFromRow: () => focusFromRow,
   gridColumns: () => gridColumns,
   groupTranscript: () => groupTranscript,
   guestRecordAccessExplanation: () => guestRecordAccessExplanation,
@@ -145,6 +147,7 @@ __export(core_exports, {
   isLinkFollower: () => isLinkFollower,
   isListenOnly: () => isListenOnly,
   isNoteTaker: () => isNoteTaker,
+  isObserverRole: () => isObserverRole,
   isRealName: () => isRealName,
   isRoomEventTopic: () => isRoomEventTopic,
   learnName: () => learnName,
@@ -209,6 +212,7 @@ __export(core_exports, {
   roleOf: () => roleOf,
   roomTopic: () => roomTopic,
   rootAttributes: () => rootAttributes,
+  scheduleSettingsPatch: () => scheduleSettingsPatch,
   searchTranscript: () => searchTranscript,
   sendFollowUp: () => sendFollowUp,
   setCaptionLanguage: () => setCaptionLanguage,
@@ -620,7 +624,8 @@ function parseRoomToken(body, roomName) {
     lobby: readBoolean(payload, "lobby", false),
     admissionState: readString(payload, "admission_state") ?? void 0,
     pollSeconds: typeof payload["poll_seconds"] === "number" ? payload["poll_seconds"] : void 0,
-    breakoutRoomId: readString(payload, "breakout_room_id") ?? null
+    breakoutRoomId: readString(payload, "breakout_room_id") ?? null,
+    observersVisibleTo: readString(payload, "observers_visible_to") === "hosts" ? "hosts" : "everyone"
   };
 }
 function createTokenClient(options) {
@@ -669,6 +674,7 @@ function createTokenClient(options) {
           ...input.meetingId !== void 0 ? { meeting_id: input.meetingId } : {},
           ...input.slug !== void 0 ? { slug: input.slug } : {},
           ...input.breakoutRoomId != null ? { breakout_room_id: input.breakoutRoomId } : {},
+          ...input.observe === true ? { observe: true } : {},
           organization_id: input.identity.organizationId,
           display_name: input.identity.displayName,
           device_id: input.identity.deviceId,
@@ -740,7 +746,8 @@ function createTokenClient(options) {
   return {
     get(input) {
       const entry = cache.get(input.roomName);
-      const sameRoom = entry !== void 0 && (entry.token.breakoutRoomId ?? null) === (input.breakoutRoomId ?? null);
+      const sameRoom = entry !== void 0 && (entry.token.breakoutRoomId ?? null) === (input.breakoutRoomId ?? null) && // An observer's pass is not a participant's, and back (MD-16).
+      entry.token.role === "viewer" === (input.observe === true);
       if (entry !== void 0 && sameRoom) {
         if (entry.inFlight !== null) return entry.inFlight;
         if (!expired(entry)) return Promise.resolve(entry.token);
@@ -1266,6 +1273,9 @@ function isLinkFollower(standing) {
 function isHostRole(role) {
   return role === "host" || role === "cohost";
 }
+function isObserverRole(role) {
+  return role === "viewer";
+}
 var WAITING_ADMISSION_STATES = ["waiting_host", "knocking"];
 
 // src/core/calls.ts
@@ -1470,388 +1480,49 @@ function createCallCenter(options) {
       );
       return invite;
     },
-    async accept(id, mode) {
-      const held = incoming.get(id);
-      if (held !== void 0 && !canTransition(held.state, "connecting")) {
-        throw new MeetError(
-          "conflict",
-          `meet.calls.accept: this call is already ${held.state}`,
-          "A late accept must not resurrect a settled call. Close the ringing UI; the caller has already moved on."
-        );
-      }
-      const settled = await repository.settleCallInvite(id, "connecting", null);
-      settleLocal(settled);
-      channel?.send(MEET_EVENTS.settled, settled);
-      to(settled.callerUserId).send(MEET_EVENTS.settled, { ...settled, mode });
-      return settled;
-    },
-    async decline(id, message) {
-      const settled = await repository.settleCallInvite(id, "declined", message ?? null);
-      settleLocal(settled);
-      channel?.send(MEET_EVENTS.settled, settled);
-      to(settled.callerUserId).send(MEET_EVENTS.settled, settled);
-      return settled;
-    },
-    async cancel(id) {
-      const settled = await repository.settleCallInvite(id, "cancelled", null);
-      clearRing(id);
-      if (outgoing?.id === id) outgoing = settled;
-      for (const callee of settled.calleeUserIds) {
-        to(callee).send(MEET_EVENTS.cancel, settled);
-      }
-      return settled;
-    },
-    incoming: () => [...incoming.values()],
-    outgoing: () => outgoing,
-    ingest,
-    dispose() {
-      for (const id of [...timeouts.keys()]) clearRing(asCallId(id));
-      incoming.clear();
-      for (const handle of outbound.values()) handle.close();
-      outbound.clear();
-      channel?.close();
-      channel = null;
-    }
-  };
-}
-
-// src/core/collab.ts
-var EMPTY_COLLAB = {
-  loaded: false,
-  error: null,
-  settings: null,
-  polls: [],
-  questions: [],
-  strokes: [],
-  breakout: null,
-  broadcast: null,
-  moveRequest: null,
-  panelRequest: null,
-  captionLanguage: null,
-  captionTranslations: {},
-  captionTranslationError: null
-};
-function obj(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
-}
-function str(value) {
-  return typeof value === "string" ? value : null;
-}
-function num(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function strings(value) {
-  return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
-}
-function pollFromRow(row) {
-  const id = str(row["id"]);
-  if (id === null) return null;
-  const options = [];
-  for (const raw of Array.isArray(row["options"]) ? row["options"] : []) {
-    const option = obj(raw);
-    const optionId = option === null ? null : str(option["id"]);
-    if (option === null || optionId === null) continue;
-    const votes = num(option["votes"]);
-    options.push({
-      id: optionId,
-      text: str(option["text"]) ?? "",
-      ...votes !== null ? { votes } : {},
-      ...Array.isArray(option["voters"]) ? { voters: strings(option["voters"]) } : {}
-    });
-  }
-  const state = str(row["state"]);
-  return {
-    id,
-    question: str(row["question"]) ?? "",
-    options,
-    multiple: row["multiple"] === true,
-    anonymous: row["anonymous"] === true,
-    state: state === "live" || state === "closed" ? state : "draft",
-    resultsShared: row["results_shared"] === true,
-    voterCount: num(row["voter_count"]),
-    myVote: strings(row["my_vote"]),
-    createdByName: str(row["created_by_name"]) ?? "",
-    createdAt: str(row["created_at"])
-  };
-}
-function questionFromRow(row) {
-  const id = str(row["id"]);
-  if (id === null) return null;
-  const state = str(row["state"]);
-  return {
-    id,
-    text: str(row["text"]) ?? "",
-    askerName: str(row["asker_name"]) ?? "",
-    anonymous: row["anonymous"] === true,
-    state: state === "answered" || state === "dismissed" ? state : "open",
-    answer: str(row["answer"]),
-    answeredByName: str(row["answered_by_name"]),
-    upvotes: num(row["upvotes"]) ?? 0,
-    upvotedByMe: row["upvoted_by_me"] === true,
-    mine: row["mine"] === true,
-    createdAt: str(row["created_at"])
-  };
-}
-function strokeFromRow(row) {
-  const id = str(row["id"]);
-  if (id === null || !Array.isArray(row["points"])) return null;
-  const points = [];
-  for (const raw of row["points"]) {
-    if (Array.isArray(raw) && typeof raw[0] === "number" && typeof raw[1] === "number") {
-      points.push([raw[0], raw[1]]);
-    }
-  }
-  return {
-    id,
-    points,
-    color: str(row["color"]) ?? "#111827",
-    width: num(row["width"]) ?? 3,
-    tool: row["tool"] === "highlighter" ? "highlighter" : "pen",
-    by: str(row["by"]) ?? "",
-    byName: str(row["by_name"]) ?? ""
-  };
-}
-function broadcastFrom(value) {
-  const row = obj(value);
-  const text3 = row === null ? null : str(row["text"]);
-  if (row === null || text3 === null) return null;
-  return { text: text3, by: str(row["by"]) ?? "", at: str(row["at"]) ?? "" };
-}
-function planFromRow(row) {
-  const id = str(row["id"]);
-  if (id === null) return null;
-  const rooms = [];
-  for (const raw of Array.isArray(row["rooms"]) ? row["rooms"] : []) {
-    const room = obj(raw);
-    const roomId = room === null ? null : str(room["id"]);
-    if (room === null || roomId === null) continue;
-    rooms.push({ id: roomId, name: str(room["name"]) ?? roomId, identities: strings(room["identities"]) });
-  }
-  return {
-    id,
-    state: row["state"] === "open" ? "open" : "closed",
-    rooms,
-    allowChoose: row["allow_choose"] === true,
-    minutes: num(row["minutes"]) ?? 0,
-    openedAt: str(row["opened_at"]),
-    endsAt: str(row["ends_at"]),
-    closedAt: str(row["closed_at"]),
-    broadcasts: (Array.isArray(row["broadcasts"]) ? row["broadcasts"] : []).map(broadcastFrom).filter((b) => b !== null)
-  };
-}
-function settingsFromRow(row) {
-  if (row === null) return null;
-  return {
-    pollsEnabled: row["polls_enabled"] === true,
-    pollMaxOptions: num(row["poll_max_options"]) ?? 10,
-    qaEnabled: row["qa_enabled"] === true,
-    qaAnonymousAllowed: row["qa_anonymous_allowed"] === true,
-    whiteboardEnabled: row["whiteboard_enabled"] === true,
-    breakoutsEnabled: row["breakouts_enabled"] === true,
-    breakoutMaxRooms: num(row["breakout_max_rooms"]) ?? 20,
-    breakoutDefaultMinutes: num(row["breakout_default_minutes"]) ?? 15,
-    captionTranslationEnabled: row["caption_translation_enabled"] === true,
-    captionTranslationLanguage: str(row["caption_translation_language"]) ?? ""
-  };
-}
-function collabFromState(body, previous) {
-  const list = (key, parse) => (Array.isArray(body[key]) ? body[key] : []).map((raw) => {
-    const row = obj(raw);
-    return row === null ? null : parse(row);
-  }).filter((item) => item !== null);
-  const breakoutRow = obj(body["breakout"]);
-  return {
-    ...previous,
-    loaded: true,
-    error: null,
-    settings: settingsFromRow(obj(body["settings"])),
-    polls: list("polls", pollFromRow),
-    questions: list("questions", questionFromRow),
-    strokes: list("strokes", strokeFromRow),
-    breakout: breakoutRow === null ? null : planFromRow(breakoutRow)
-  };
-}
-function upsert(items, next) {
-  const index = items.findIndex((item) => item.id === next.id);
-  if (index === -1) return [...items, next];
-  const copy = items.slice();
-  copy[index] = next;
-  return copy;
-}
-function withItem(collab, row, fromRoom = false) {
-  const kind = str(row["kind"]);
-  if (kind === "poll") {
-    const poll = pollFromRow(row);
-    if (poll === null) return collab;
-    const known = collab.polls.find((p) => p.id === poll.id);
-    let merged = fromRoom && known !== void 0 ? { ...poll, myVote: known.myVote } : poll;
-    if (fromRoom && known !== void 0 && !poll.options.some((o) => o.votes !== void 0)) {
-      const counted = new Map(known.options.map((o) => [o.id, o]));
-      merged = {
-        ...merged,
-        voterCount: known.voterCount,
-        options: merged.options.map((o) => {
-          const had = counted.get(o.id);
-          return had === void 0 ? o : { ...o, votes: had.votes, voters: had.voters };
-        })
-      };
-    }
-    return { ...collab, polls: upsert(collab.polls, merged) };
-  }
-  if (kind === "question") {
-    const question = questionFromRow(row);
-    if (question === null) return collab;
-    const known = collab.questions.find((q) => q.id === question.id);
-    const merged = fromRoom && known !== void 0 ? { ...question, mine: known.mine, upvotedByMe: known.upvotedByMe } : question;
-    return { ...collab, questions: upsert(collab.questions, merged) };
-  }
-  if (kind === "stroke") {
-    const stroke = strokeFromRow(row);
-    if (stroke === null) return collab;
-    return { ...collab, strokes: upsert(collab.strokes, stroke) };
-  }
-  if (kind === "breakout") {
-    const plan = planFromRow(row);
-    if (plan === null) return collab;
-    return { ...collab, breakout: plan };
-  }
-  return collab;
-}
-function without(collab, ids) {
-  const gone = new Set(ids);
-  return {
-    ...collab,
-    polls: collab.polls.filter((p) => !gone.has(p.id)),
-    questions: collab.questions.filter((q) => !gone.has(q.id)),
-    strokes: collab.strokes.filter((s) => !gone.has(s.id))
-  };
-}
-function applyCollabPacket(collab, payload, context) {
-  const item = obj(payload["item"]);
-  if (item !== null) {
-    const kind = str(item["kind"]);
-    let next = withItem(collab, item, true);
-    if (kind === "poll" && str(item["state"]) === "live") {
-      const before = collab.polls.find((p) => p.id === str(item["id"]));
-      if (before === void 0 || before.state !== "live") {
-        next = { ...next, panelRequest: { panel: "polls", at: context.now } };
-      }
-    }
-    if (kind === "breakout") {
-      const plan = planFromRow(item);
-      if (plan !== null && plan.state === "closed") {
-        next = { ...next, moveRequest: { roomId: null, at: context.now } };
-      }
-    }
-    const move = obj(payload["move"]);
-    if (move !== null && str(move["identity"]) === context.localIdentity) {
-      next = { ...next, moveRequest: { roomId: str(move["room_id"]), at: context.now } };
-    }
-    return { next };
-  }
-  if (Array.isArray(payload["removed"])) {
-    return { next: without(collab, strings(payload["removed"])) };
-  }
-  if (Array.isArray(payload["hidden"])) {
-    return context.isHost ? { next: null, dropped: "hosts keep dismissed questions" } : { next: without(collab, strings(payload["hidden"])) };
-  }
-  if (payload["cleared"] === "whiteboard") {
-    return { next: { ...collab, strokes: [] } };
-  }
-  const broadcast = broadcastFrom(payload["broadcast"]);
-  if (broadcast !== null) {
-    return { next: { ...collab, broadcast } };
-  }
-  return { next: null, dropped: "a collab packet with nothing this version understands" };
-}
-function assignedRoom(plan, identity) {
-  if (plan === null || plan.state !== "open" || identity === null) return null;
-  return plan.rooms.find((room) => room.identities.includes(identity)) ?? null;
-}
-function autoAssign(identities, rooms, exclude = []) {
-  const count2 = Math.max(1, Math.floor(rooms));
-  const out = Array.from({ length: count2 }, () => []);
-  const skip = new Set(exclude);
-  let index = 0;
-  for (const identity of identities) {
-    if (skip.has(identity)) continue;
-    out[index % count2].push(identity);
-    index += 1;
-  }
-  return out;
-}
-function breakoutRemainingMs(plan, now) {
-  if (plan === null || plan.state !== "open" || plan.endsAt === null) return null;
-  const end = Date.parse(plan.endsAt);
-  return Number.isNaN(end) ? null : Math.max(0, end - now);
-}
-function defaultCaptionLanguage(settings, viewerLanguage) {
-  const configured = settings?.captionTranslationLanguage.trim() ?? "";
-  if (configured.length > 0) return configured;
-  const own = (viewerLanguage ?? "").trim();
-  return own.length > 0 ? own : "en";
-}
-var CAPTION_LANGUAGES = [
-  { tag: "en", name: "English" },
-  { tag: "es", name: "Spanish" },
-  { tag: "fr", name: "French" },
-  { tag: "de", name: "German" },
-  { tag: "it", name: "Italian" },
-  { tag: "pt", name: "Portuguese" },
-  { tag: "nl", name: "Dutch" },
-  { tag: "pl", name: "Polish" },
-  { tag: "ru", name: "Russian" },
-  { tag: "uk", name: "Ukrainian" },
-  { tag: "tr", name: "Turkish" },
-  { tag: "ar", name: "Arabic" },
-  { tag: "he", name: "Hebrew" },
-  { tag: "fa", name: "Persian" },
-  { tag: "hi", name: "Hindi" },
-  { tag: "bn", name: "Bengali" },
-  { tag: "zh", name: "Chinese" },
-  { tag: "ja", name: "Japanese" },
-  { tag: "ko", name: "Korean" },
-  { tag: "vi", name: "Vietnamese" },
-  { tag: "th", name: "Thai" },
-  { tag: "id", name: "Indonesian" },
-  { tag: "sv", name: "Swedish" }
-];
-async function loadMeetingActivities(api, meetingId, meetingPass = null) {
-  let response;
-  try {
-    response = await api.request({
-      path: `${MEET_ROUTES.collab}?meeting_id=${encodeURIComponent(meetingId)}`,
-      method: "GET",
-      operation: "meet.loadMeetingActivities",
-      requireAuth: meetingPass === null,
-      ...meetingPass !== null ? { headers: { [MEETING_PASS_HEADER]: meetingPass } } : {}
-    });
-  } catch (error) {
-    return {
-      collab: null,
-      refusal: {
-        message: `Polls, questions and the whiteboard could not be read (${error.message}).`,
-        remedy: error.remedy ?? "Reload the page."
+    async accept(id, mode) {
+      const held = incoming.get(id);
+      if (held !== void 0 && !canTransition(held.state, "connecting")) {
+        throw new MeetError(
+          "conflict",
+          `meet.calls.accept: this call is already ${held.state}`,
+          "A late accept must not resurrect a settled call. Close the ringing UI; the caller has already moved on."
+        );
       }
-    };
-  }
-  if (!response.ok) {
-    let body = null;
-    try {
-      body = await response.json();
-    } catch {
-      body = null;
-    }
-    const said = readServerRefusal(body);
-    return {
-      collab: null,
-      refusal: {
-        message: said?.reason ?? `Polls and questions could not be read (the server answered ${response.status}).`,
-        remedy: said?.remedy || "Reload the page."
+      const settled = await repository.settleCallInvite(id, "connecting", null);
+      settleLocal(settled);
+      channel?.send(MEET_EVENTS.settled, settled);
+      to(settled.callerUserId).send(MEET_EVENTS.settled, { ...settled, mode });
+      return settled;
+    },
+    async decline(id, message) {
+      const settled = await repository.settleCallInvite(id, "declined", message ?? null);
+      settleLocal(settled);
+      channel?.send(MEET_EVENTS.settled, settled);
+      to(settled.callerUserId).send(MEET_EVENTS.settled, settled);
+      return settled;
+    },
+    async cancel(id) {
+      const settled = await repository.settleCallInvite(id, "cancelled", null);
+      clearRing(id);
+      if (outgoing?.id === id) outgoing = settled;
+      for (const callee of settled.calleeUserIds) {
+        to(callee).send(MEET_EVENTS.cancel, settled);
       }
-    };
-  }
-  return { collab: collabFromState(await response.json(), EMPTY_COLLAB), refusal: null };
+      return settled;
+    },
+    incoming: () => [...incoming.values()],
+    outgoing: () => outgoing,
+    ingest,
+    dispose() {
+      for (const id of [...timeouts.keys()]) clearRing(asCallId(id));
+      incoming.clear();
+      for (const handle of outbound.values()) handle.close();
+      outbound.clear();
+      channel?.close();
+      channel = null;
+    }
+  };
 }
 
 // src/core/repository.ts
@@ -2046,7 +1717,7 @@ var OCCURRENCE_STATES = ["scheduled", "moved", "cancelled"];
 function rsvpState(value) {
   return RSVP_STATES.includes(value) ? value : "needs_action";
 }
-function num2(row, key) {
+function num(row, key) {
   const value = row[key];
   return typeof value === "number" ? value : null;
 }
@@ -2068,7 +1739,7 @@ function projectInvitee(row) {
     rsvpState: rsvpState(text(row, "rsvp_state")),
     respondedAt: when(row, "responded_at"),
     rsvpNote: text(row, "rsvp_note"),
-    lastSentSequence: num2(row, "last_sent_sequence"),
+    lastSentSequence: num(row, "last_sent_sequence"),
     lastSentAt: when(row, "last_sent_at")
   };
 }
@@ -2079,10 +1750,10 @@ function projectOccurrence(row) {
     meetingId: asMeetingId(requireText(row, "meeting_id", operation)),
     originalStart: when(row, "original_start") ?? requireText(row, "original_start", operation),
     occurrenceStart: when(row, "occurrence_start") ?? requireText(row, "occurrence_start", operation),
-    durationMinutes: num2(row, "duration_minutes"),
+    durationMinutes: num(row, "duration_minutes"),
     // An unknown state is shown as scheduled, never dropped: the row is real.
     state: OCCURRENCE_STATES.includes(state) ? state : "scheduled",
-    sequence: num2(row, "sequence") ?? 0
+    sequence: num(row, "sequence") ?? 0
   };
 }
 function projectUpcoming(row) {
@@ -2111,9 +1782,9 @@ function projectOverride(row) {
     originalStart: when(row, "original_start") ?? requireText(row, "original_start", operation),
     state: text(row, "state") === "moved" ? "moved" : "cancelled",
     newStart: when(row, "new_start"),
-    newDurationMinutes: num2(row, "new_duration_minutes"),
+    newDurationMinutes: num(row, "new_duration_minutes"),
     reason: text(row, "reason"),
-    calendarSequence: num2(row, "calendar_sequence") ?? 0,
+    calendarSequence: num(row, "calendar_sequence") ?? 0,
     deletedAt: when(row, "deleted_at")
   };
 }
@@ -2137,7 +1808,7 @@ function projectRsvpInvitation(body) {
       title: text(meeting, "title") ?? "Meeting",
       slug: requireText(meeting, "slug", operation),
       scheduledFor: when(meeting, "scheduled_for"),
-      durationMinutes: num2(meeting, "duration_minutes"),
+      durationMinutes: num(meeting, "duration_minutes"),
       timeZone: text(meeting, "time_zone") ?? "UTC",
       agenda: text(meeting, "agenda"),
       recurrenceRule: text(meeting, "recurrence_rule"),
@@ -2365,7 +2036,7 @@ function createMeetRepository(options) {
           p_duration_minutes: input.durationMinutes ?? null,
           p_agenda: input.agenda ?? null,
           p_recurrence_rule: input.recurrenceRule ?? null,
-          p_settings: settingsPatch(input.settings ?? {})
+          p_settings: scheduleSettingsPatch(input.settings ?? {}, input.appPanel, input.observers)
         })
       );
       return projectMeeting(row);
@@ -2700,74 +2371,447 @@ function createMeetRepository(options) {
     }
   };
 }
-var LIBRARY_STATES = [
-  "idle",
-  "starting",
-  "recording",
-  "stopping",
-  "processing",
-  "available",
-  "expired",
-  "failed"
-];
-function projectLibraryRecording(row) {
-  const operation = "meet.projectLibraryRecording";
-  const state = text(row, "state");
-  const role = text(row, "my_role");
+var LIBRARY_STATES = [
+  "idle",
+  "starting",
+  "recording",
+  "stopping",
+  "processing",
+  "available",
+  "expired",
+  "failed"
+];
+function projectLibraryRecording(row) {
+  const operation = "meet.projectLibraryRecording";
+  const state = text(row, "state");
+  const role = text(row, "my_role");
+  return {
+    id: requireText(row, "recording_id", operation),
+    meetingId: asMeetingId(requireText(row, "meeting_id", operation)),
+    meetingTitle: text(row, "meeting_title") ?? "Meeting",
+    meetingSlug: requireText(row, "meeting_slug", operation),
+    role: role === "host" || role === "cohost" || role === "invitee" ? role : "attendee",
+    state: LIBRARY_STATES.includes(state) ? state : "failed",
+    title: text(row, "recording_title"),
+    fileId: text(row, "file_id"),
+    startedAt: text(row, "started_at"),
+    endedAt: text(row, "ended_at"),
+    durationMs: num(row, "duration_ms"),
+    sizeBytes: num(row, "size_bytes"),
+    failureReason: text(row, "failure_reason"),
+    archivedAt: text(row, "deleted_at"),
+    organizationId: asOrganizationId(requireText(row, "organization_id", operation))
+  };
+}
+var SEARCH_SOURCES = [
+  "title",
+  "summary",
+  "decision",
+  "action_item",
+  "note",
+  "transcript"
+];
+function projectSearchHit(row) {
+  const operation = "meet.projectSearchHit";
+  const source = text(row, "source");
+  return {
+    meetingId: asMeetingId(requireText(row, "meeting_id", operation)),
+    meetingTitle: text(row, "meeting_title") ?? "Meeting",
+    meetingSlug: requireText(row, "meeting_slug", operation),
+    meetingAt: text(row, "meeting_at"),
+    source: SEARCH_SOURCES.includes(source) ? source : "note",
+    refId: requireText(row, "ref_id", operation),
+    speaker: text(row, "speaker"),
+    snippet: text(row, "snippet") ?? "",
+    at: text(row, "said_at"),
+    rank: num(row, "rank") ?? 0
+  };
+}
+function snippetRuns(snippet) {
+  const runs = [];
+  const pattern = /⟦([^⟧]*)⟧/g;
+  let last = 0;
+  for (const match of snippet.matchAll(pattern)) {
+    const start = match.index ?? 0;
+    if (start > last) runs.push({ text: snippet.slice(last, start), hit: false });
+    runs.push({ text: match[1] ?? "", hit: true });
+    last = start + match[0].length;
+  }
+  if (last < snippet.length) runs.push({ text: snippet.slice(last), hit: false });
+  return runs;
+}
+
+// src/core/app-panel.ts
+function appPanelOf(meeting) {
+  const raw = meeting?.metadata?.["app_panel"];
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return null;
+  const key = raw["key"];
+  const recordId = raw["record_id"];
+  if (typeof key !== "string" || key.length === 0) return null;
+  if (typeof recordId !== "string" || recordId.length === 0) return null;
+  return { key, recordId };
+}
+function scheduleSettingsPatch(settings, appPanel, observers) {
+  const patch = settingsPatch(settings);
+  if (appPanel !== void 0) patch["app_panel"] = { key: appPanel.key, record_id: appPanel.recordId };
+  if (observers !== void 0 && observers.length > 0) patch["observers"] = [...observers];
+  return patch;
+}
+function focusFromRow(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
+  const row = value;
+  if (typeof row["panel"] !== "string") return null;
+  return {
+    panel: row["panel"],
+    section: typeof row["section"] === "string" ? row["section"] : "",
+    byName: typeof row["by_name"] === "string" ? row["by_name"] : "",
+    at: typeof row["at"] === "string" ? row["at"] : ""
+  };
+}
+
+// src/core/collab.ts
+var EMPTY_COLLAB = {
+  loaded: false,
+  error: null,
+  settings: null,
+  polls: [],
+  questions: [],
+  strokes: [],
+  breakout: null,
+  broadcast: null,
+  moveRequest: null,
+  panelRequest: null,
+  captionLanguage: null,
+  captionTranslations: {},
+  captionTranslationError: null,
+  focus: null
+};
+function obj(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function str(value) {
+  return typeof value === "string" ? value : null;
+}
+function num2(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function strings(value) {
+  return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+}
+function pollFromRow(row) {
+  const id = str(row["id"]);
+  if (id === null) return null;
+  const options = [];
+  for (const raw of Array.isArray(row["options"]) ? row["options"] : []) {
+    const option = obj(raw);
+    const optionId = option === null ? null : str(option["id"]);
+    if (option === null || optionId === null) continue;
+    const votes = num2(option["votes"]);
+    options.push({
+      id: optionId,
+      text: str(option["text"]) ?? "",
+      ...votes !== null ? { votes } : {},
+      ...Array.isArray(option["voters"]) ? { voters: strings(option["voters"]) } : {}
+    });
+  }
+  const state = str(row["state"]);
+  return {
+    id,
+    question: str(row["question"]) ?? "",
+    options,
+    multiple: row["multiple"] === true,
+    anonymous: row["anonymous"] === true,
+    state: state === "live" || state === "closed" ? state : "draft",
+    resultsShared: row["results_shared"] === true,
+    voterCount: num2(row["voter_count"]),
+    myVote: strings(row["my_vote"]),
+    createdByName: str(row["created_by_name"]) ?? "",
+    createdAt: str(row["created_at"])
+  };
+}
+function questionFromRow(row) {
+  const id = str(row["id"]);
+  if (id === null) return null;
+  const state = str(row["state"]);
+  return {
+    id,
+    text: str(row["text"]) ?? "",
+    askerName: str(row["asker_name"]) ?? "",
+    anonymous: row["anonymous"] === true,
+    state: state === "answered" || state === "dismissed" ? state : "open",
+    answer: str(row["answer"]),
+    answeredByName: str(row["answered_by_name"]),
+    upvotes: num2(row["upvotes"]) ?? 0,
+    upvotedByMe: row["upvoted_by_me"] === true,
+    mine: row["mine"] === true,
+    createdAt: str(row["created_at"])
+  };
+}
+function strokeFromRow(row) {
+  const id = str(row["id"]);
+  if (id === null || !Array.isArray(row["points"])) return null;
+  const points = [];
+  for (const raw of row["points"]) {
+    if (Array.isArray(raw) && typeof raw[0] === "number" && typeof raw[1] === "number") {
+      points.push([raw[0], raw[1]]);
+    }
+  }
+  return {
+    id,
+    points,
+    color: str(row["color"]) ?? "#111827",
+    width: num2(row["width"]) ?? 3,
+    tool: row["tool"] === "highlighter" ? "highlighter" : "pen",
+    by: str(row["by"]) ?? "",
+    byName: str(row["by_name"]) ?? ""
+  };
+}
+function broadcastFrom(value) {
+  const row = obj(value);
+  const text3 = row === null ? null : str(row["text"]);
+  if (row === null || text3 === null) return null;
+  return { text: text3, by: str(row["by"]) ?? "", at: str(row["at"]) ?? "" };
+}
+function planFromRow(row) {
+  const id = str(row["id"]);
+  if (id === null) return null;
+  const rooms = [];
+  for (const raw of Array.isArray(row["rooms"]) ? row["rooms"] : []) {
+    const room = obj(raw);
+    const roomId = room === null ? null : str(room["id"]);
+    if (room === null || roomId === null) continue;
+    rooms.push({ id: roomId, name: str(room["name"]) ?? roomId, identities: strings(room["identities"]) });
+  }
+  return {
+    id,
+    state: row["state"] === "open" ? "open" : "closed",
+    rooms,
+    allowChoose: row["allow_choose"] === true,
+    minutes: num2(row["minutes"]) ?? 0,
+    openedAt: str(row["opened_at"]),
+    endsAt: str(row["ends_at"]),
+    closedAt: str(row["closed_at"]),
+    broadcasts: (Array.isArray(row["broadcasts"]) ? row["broadcasts"] : []).map(broadcastFrom).filter((b) => b !== null)
+  };
+}
+function settingsFromRow(row) {
+  if (row === null) return null;
+  return {
+    pollsEnabled: row["polls_enabled"] === true,
+    pollMaxOptions: num2(row["poll_max_options"]) ?? 10,
+    qaEnabled: row["qa_enabled"] === true,
+    qaAnonymousAllowed: row["qa_anonymous_allowed"] === true,
+    whiteboardEnabled: row["whiteboard_enabled"] === true,
+    breakoutsEnabled: row["breakouts_enabled"] === true,
+    breakoutMaxRooms: num2(row["breakout_max_rooms"]) ?? 20,
+    breakoutDefaultMinutes: num2(row["breakout_default_minutes"]) ?? 15,
+    captionTranslationEnabled: row["caption_translation_enabled"] === true,
+    captionTranslationLanguage: str(row["caption_translation_language"]) ?? ""
+  };
+}
+function collabFromState(body, previous) {
+  const list = (key, parse) => (Array.isArray(body[key]) ? body[key] : []).map((raw) => {
+    const row = obj(raw);
+    return row === null ? null : parse(row);
+  }).filter((item) => item !== null);
+  const breakoutRow = obj(body["breakout"]);
   return {
-    id: requireText(row, "recording_id", operation),
-    meetingId: asMeetingId(requireText(row, "meeting_id", operation)),
-    meetingTitle: text(row, "meeting_title") ?? "Meeting",
-    meetingSlug: requireText(row, "meeting_slug", operation),
-    role: role === "host" || role === "cohost" || role === "invitee" ? role : "attendee",
-    state: LIBRARY_STATES.includes(state) ? state : "failed",
-    title: text(row, "recording_title"),
-    fileId: text(row, "file_id"),
-    startedAt: text(row, "started_at"),
-    endedAt: text(row, "ended_at"),
-    durationMs: num2(row, "duration_ms"),
-    sizeBytes: num2(row, "size_bytes"),
-    failureReason: text(row, "failure_reason"),
-    archivedAt: text(row, "deleted_at"),
-    organizationId: asOrganizationId(requireText(row, "organization_id", operation))
+    ...previous,
+    loaded: true,
+    error: null,
+    settings: settingsFromRow(obj(body["settings"])),
+    polls: list("polls", pollFromRow),
+    questions: list("questions", questionFromRow),
+    strokes: list("strokes", strokeFromRow),
+    breakout: breakoutRow === null ? null : planFromRow(breakoutRow),
+    focus: focusFromRow(body["focus"])
   };
 }
-var SEARCH_SOURCES = [
-  "title",
-  "summary",
-  "decision",
-  "action_item",
-  "note",
-  "transcript"
-];
-function projectSearchHit(row) {
-  const operation = "meet.projectSearchHit";
-  const source = text(row, "source");
+function upsert(items, next) {
+  const index = items.findIndex((item) => item.id === next.id);
+  if (index === -1) return [...items, next];
+  const copy = items.slice();
+  copy[index] = next;
+  return copy;
+}
+function withItem(collab, row, fromRoom = false) {
+  const kind = str(row["kind"]);
+  if (kind === "poll") {
+    const poll = pollFromRow(row);
+    if (poll === null) return collab;
+    const known = collab.polls.find((p) => p.id === poll.id);
+    let merged = fromRoom && known !== void 0 ? { ...poll, myVote: known.myVote } : poll;
+    if (fromRoom && known !== void 0 && !poll.options.some((o) => o.votes !== void 0)) {
+      const counted = new Map(known.options.map((o) => [o.id, o]));
+      merged = {
+        ...merged,
+        voterCount: known.voterCount,
+        options: merged.options.map((o) => {
+          const had = counted.get(o.id);
+          return had === void 0 ? o : { ...o, votes: had.votes, voters: had.voters };
+        })
+      };
+    }
+    return { ...collab, polls: upsert(collab.polls, merged) };
+  }
+  if (kind === "question") {
+    const question = questionFromRow(row);
+    if (question === null) return collab;
+    const known = collab.questions.find((q) => q.id === question.id);
+    const merged = fromRoom && known !== void 0 ? { ...question, mine: known.mine, upvotedByMe: known.upvotedByMe } : question;
+    return { ...collab, questions: upsert(collab.questions, merged) };
+  }
+  if (kind === "stroke") {
+    const stroke = strokeFromRow(row);
+    if (stroke === null) return collab;
+    return { ...collab, strokes: upsert(collab.strokes, stroke) };
+  }
+  if (kind === "breakout") {
+    const plan = planFromRow(row);
+    if (plan === null) return collab;
+    return { ...collab, breakout: plan };
+  }
+  return collab;
+}
+function without(collab, ids) {
+  const gone = new Set(ids);
   return {
-    meetingId: asMeetingId(requireText(row, "meeting_id", operation)),
-    meetingTitle: text(row, "meeting_title") ?? "Meeting",
-    meetingSlug: requireText(row, "meeting_slug", operation),
-    meetingAt: text(row, "meeting_at"),
-    source: SEARCH_SOURCES.includes(source) ? source : "note",
-    refId: requireText(row, "ref_id", operation),
-    speaker: text(row, "speaker"),
-    snippet: text(row, "snippet") ?? "",
-    at: text(row, "said_at"),
-    rank: num2(row, "rank") ?? 0
+    ...collab,
+    polls: collab.polls.filter((p) => !gone.has(p.id)),
+    questions: collab.questions.filter((q) => !gone.has(q.id)),
+    strokes: collab.strokes.filter((s) => !gone.has(s.id))
   };
 }
-function snippetRuns(snippet) {
-  const runs = [];
-  const pattern = /⟦([^⟧]*)⟧/g;
-  let last = 0;
-  for (const match of snippet.matchAll(pattern)) {
-    const start = match.index ?? 0;
-    if (start > last) runs.push({ text: snippet.slice(last, start), hit: false });
-    runs.push({ text: match[1] ?? "", hit: true });
-    last = start + match[0].length;
+function applyCollabPacket(collab, payload, context) {
+  const item = obj(payload["item"]);
+  if (item !== null) {
+    const kind = str(item["kind"]);
+    let next = withItem(collab, item, true);
+    if (kind === "poll" && str(item["state"]) === "live") {
+      const before = collab.polls.find((p) => p.id === str(item["id"]));
+      if (before === void 0 || before.state !== "live") {
+        next = { ...next, panelRequest: { panel: "polls", at: context.now } };
+      }
+    }
+    if (kind === "breakout") {
+      const plan = planFromRow(item);
+      if (plan !== null && plan.state === "closed") {
+        next = { ...next, moveRequest: { roomId: null, at: context.now } };
+      }
+    }
+    const move = obj(payload["move"]);
+    if (move !== null && str(move["identity"]) === context.localIdentity) {
+      next = { ...next, moveRequest: { roomId: str(move["room_id"]), at: context.now } };
+    }
+    return { next };
   }
-  if (last < snippet.length) runs.push({ text: snippet.slice(last), hit: false });
-  return runs;
+  if (payload["focus"] !== void 0) {
+    const focus = focusFromRow(payload["focus"]);
+    return focus === null ? { next: null, dropped: "a focus packet without a panel" } : { next: { ...collab, focus } };
+  }
+  if (Array.isArray(payload["removed"])) {
+    return { next: without(collab, strings(payload["removed"])) };
+  }
+  if (Array.isArray(payload["hidden"])) {
+    return context.isHost ? { next: null, dropped: "hosts keep dismissed questions" } : { next: without(collab, strings(payload["hidden"])) };
+  }
+  if (payload["cleared"] === "whiteboard") {
+    return { next: { ...collab, strokes: [] } };
+  }
+  const broadcast = broadcastFrom(payload["broadcast"]);
+  if (broadcast !== null) {
+    return { next: { ...collab, broadcast } };
+  }
+  return { next: null, dropped: "a collab packet with nothing this version understands" };
+}
+function assignedRoom(plan, identity) {
+  if (plan === null || plan.state !== "open" || identity === null) return null;
+  return plan.rooms.find((room) => room.identities.includes(identity)) ?? null;
+}
+function autoAssign(identities, rooms, exclude = []) {
+  const count2 = Math.max(1, Math.floor(rooms));
+  const out = Array.from({ length: count2 }, () => []);
+  const skip = new Set(exclude);
+  let index = 0;
+  for (const identity of identities) {
+    if (skip.has(identity)) continue;
+    out[index % count2].push(identity);
+    index += 1;
+  }
+  return out;
+}
+function breakoutRemainingMs(plan, now) {
+  if (plan === null || plan.state !== "open" || plan.endsAt === null) return null;
+  const end = Date.parse(plan.endsAt);
+  return Number.isNaN(end) ? null : Math.max(0, end - now);
+}
+function defaultCaptionLanguage(settings, viewerLanguage) {
+  const configured = settings?.captionTranslationLanguage.trim() ?? "";
+  if (configured.length > 0) return configured;
+  const own = (viewerLanguage ?? "").trim();
+  return own.length > 0 ? own : "en";
+}
+var CAPTION_LANGUAGES = [
+  { tag: "en", name: "English" },
+  { tag: "es", name: "Spanish" },
+  { tag: "fr", name: "French" },
+  { tag: "de", name: "German" },
+  { tag: "it", name: "Italian" },
+  { tag: "pt", name: "Portuguese" },
+  { tag: "nl", name: "Dutch" },
+  { tag: "pl", name: "Polish" },
+  { tag: "ru", name: "Russian" },
+  { tag: "uk", name: "Ukrainian" },
+  { tag: "tr", name: "Turkish" },
+  { tag: "ar", name: "Arabic" },
+  { tag: "he", name: "Hebrew" },
+  { tag: "fa", name: "Persian" },
+  { tag: "hi", name: "Hindi" },
+  { tag: "bn", name: "Bengali" },
+  { tag: "zh", name: "Chinese" },
+  { tag: "ja", name: "Japanese" },
+  { tag: "ko", name: "Korean" },
+  { tag: "vi", name: "Vietnamese" },
+  { tag: "th", name: "Thai" },
+  { tag: "id", name: "Indonesian" },
+  { tag: "sv", name: "Swedish" }
+];
+async function loadMeetingActivities(api, meetingId, meetingPass = null) {
+  let response;
+  try {
+    response = await api.request({
+      path: `${MEET_ROUTES.collab}?meeting_id=${encodeURIComponent(meetingId)}`,
+      method: "GET",
+      operation: "meet.loadMeetingActivities",
+      requireAuth: meetingPass === null,
+      ...meetingPass !== null ? { headers: { [MEETING_PASS_HEADER]: meetingPass } } : {}
+    });
+  } catch (error) {
+    return {
+      collab: null,
+      refusal: {
+        message: `Polls, questions and the whiteboard could not be read (${error.message}).`,
+        remedy: error.remedy ?? "Reload the page."
+      }
+    };
+  }
+  if (!response.ok) {
+    let body = null;
+    try {
+      body = await response.json();
+    } catch {
+      body = null;
+    }
+    const said = readServerRefusal(body);
+    return {
+      collab: null,
+      refusal: {
+        message: said?.reason ?? `Polls and questions could not be read (the server answered ${response.status}).`,
+        remedy: said?.remedy || "Reload the page."
+      }
+    };
+  }
+  return { collab: collabFromState(await response.json(), EMPTY_COLLAB), refusal: null };
 }
 
 // src/core/names.ts
@@ -3840,7 +3884,10 @@ function orderParticipants(participants, activeSpeakers) {
 }
 function computeStage(args) {
   const pageSize = Math.max(1, args.pageSize ?? DEFAULT_PAGE_SIZE);
-  const ordered = orderParticipants(args.participants, args.activeSpeakers);
+  const ordered = orderParticipants(
+    args.participants.filter((participant) => !isObserverRole(participant.role)),
+    args.activeSpeakers
+  );
   const sharer = ordered.find((participant) => participant.screenSharing) ?? null;
   const pinnedParticipant = args.pinned === null ? null : ordered.find((participant) => participant.identity === args.pinned) ?? null;
   const spotlit = args.spotlight == null ? null : ordered.find((participant) => participant.identity === args.spotlight) ?? null;
@@ -5616,7 +5663,8 @@ function createRoomEngine(options) {
       identity,
       ...request.meetingId !== void 0 ? { meetingId: request.meetingId } : {},
       ...request.slug !== void 0 ? { slug: request.slug } : {},
-      ...request.breakoutRoomId != null ? { breakoutRoomId: request.breakoutRoomId } : {}
+      ...request.breakoutRoomId != null ? { breakoutRoomId: request.breakoutRoomId } : {},
+      ...request.observe === true ? { observe: true } : {}
     });
     current = token;
     store.patch({
@@ -5627,7 +5675,8 @@ function createRoomEngine(options) {
         standing: token.standing,
         canRecord: token.canRecord,
         canPublish: token.canPublish,
-        canSubscribe: token.canSubscribe
+        canSubscribe: token.canSubscribe,
+        observersVisibleTo: token.observersVisibleTo ?? "everyone"
       }
     });
     if (token.lobby || !token.canSubscribe) {
@@ -6127,7 +6176,9 @@ function createInRoomClient(options) {
           ...request.allowChoose !== void 0 ? { allow_choose: request.allowChoose } : {},
           ...request.minutes !== void 0 ? { minutes: request.minutes } : {},
           ...request.identity !== void 0 ? { identity: request.identity } : {},
-          ...request.roomId !== void 0 ? { room_id: request.roomId } : {}
+          ...request.roomId !== void 0 ? { room_id: request.roomId } : {},
+          ...request.panel !== void 0 ? { panel: request.panel } : {},
+          ...request.section !== void 0 ? { section: request.section } : {}
         },
         ...hdrs !== void 0 ? { headers: hdrs } : {}
       });