clay-server 3.8.1 → 4.0.0-beta.2

package/lib/public/modules/home-session-actions.js

@@ -0,0 +1,373 @@
+// Home conversation row actions and server-authoritative details dialog.
+
+import { store } from './store.js';
+import { copyToClipboard } from './utils.js';
+
+var menu = null;
+var menuTrigger = null;
+var detailsOverlay = null;
+var detailsOpener = null;
+var detailsKey = null;
+var detailsConversation = null;
+var copyTimers = [];
+
+function mateNames() {
+  var result = {};
+  var mates = store.get('cachedMatesList') || [];
+  for (var i = 0; i < mates.length; i++) {
+    if (!mates[i] || mates[i].archived) continue;
+    var profile = mates[i].profile || {};
+    result[mates[i].id] = profile.displayName || mates[i].displayName || mates[i].name || "Mate";
+  }
+  return result;
+}
+
+function safeText(value, fallback) {
+  return typeof value === "string" && value ? value : fallback;
+}
+
+function conversationKey(conversation) {
+  var identity = conversation.localId != null ? "local:" + conversation.localId : conversation.sessionId;
+  return conversation.mateId + ":" + identity;
+}
+
+export function getHomeSessionConversations() {
+  var byMate = store.get('homeMateSessions') || {};
+  var names = mateNames();
+  var mateIds = Object.keys(byMate);
+  var result = [];
+  for (var i = 0; i < mateIds.length; i++) {
+    if (!names[mateIds[i]]) continue;
+    var sessions = Array.isArray(byMate[mateIds[i]]) ? byMate[mateIds[i]] : [];
+    for (var j = 0; j < sessions.length; j++) {
+      if (!sessions[j] || typeof sessions[j].id !== "string" || !sessions[j].id) continue;
+      result.push({
+        mateId: mateIds[i],
+        mateName: names[mateIds[i]],
+        sessionId: sessions[j].id,
+        cliSessionId: safeText(sessions[j].cliSessionId, null),
+        localId: sessions[j].localId != null ? sessions[j].localId : null,
+        title: safeText(sessions[j].title, "New conversation"),
+        vendor: safeText(sessions[j].vendor, null),
+        model: safeText(sessions[j].model, null),
+        createdAt: typeof sessions[j].createdAt === "number" ? sessions[j].createdAt : 0,
+        lastActivity: typeof sessions[j].lastActivity === "number" ? sessions[j].lastActivity : 0,
+        isProcessing: sessions[j].isProcessing === true,
+      });
+    }
+  }
+  result.sort(function (a, b) { return b.lastActivity - a.lastActivity; });
+  return result;
+}
+
+function findConversation(key) {
+  var conversations = getHomeSessionConversations();
+  for (var i = 0; i < conversations.length; i++) {
+    if (conversationKey(conversations[i]) === key) return conversations[i];
+  }
+  return null;
+}
+
+function menuItems() {
+  return menu ? menu.querySelectorAll('[role="menuitem"]') : [];
+}
+
+function positionMenu() {
+  if (!menu || !menuTrigger || !menuTrigger.isConnected) return;
+  var rect = menuTrigger.getBoundingClientRect();
+  var menuRect = menu.getBoundingClientRect();
+  var left = Math.min(window.innerWidth - menuRect.width - 8, Math.max(8, rect.right - menuRect.width));
+  var top = rect.bottom + 5;
+  if (top + menuRect.height > window.innerHeight - 8) top = Math.max(8, rect.top - menuRect.height - 5);
+  menu.style.left = left + "px";
+  menu.style.top = top + "px";
+}
+
+function closeMenu(returnFocus) {
+  var trigger = menuTrigger;
+  if (menu) menu.remove();
+  if (trigger) trigger.setAttribute("aria-expanded", "false");
+  menu = null;
+  menuTrigger = null;
+  document.removeEventListener("pointerdown", handleMenuOutside, true);
+  document.removeEventListener("keydown", handleMenuKeydown, true);
+  window.removeEventListener("resize", handleViewportChange);
+  window.removeEventListener("scroll", handleViewportChange, true);
+  if (returnFocus && trigger && trigger.isConnected) trigger.focus({ preventScroll: true });
+}
+
+function handleViewportChange() {
+  closeMenu(false);
+}
+
+function handleMenuOutside(event) {
+  if (menu && !menu.contains(event.target) && event.target !== menuTrigger) closeMenu(false);
+}
+
+function handleMenuKeydown(event) {
+  if (!menu) return;
+  var items = menuItems();
+  if (event.key === "Escape") {
+    event.preventDefault();
+    event.stopPropagation();
+    closeMenu(true);
+    return;
+  }
+  if (event.key !== "ArrowDown" && event.key !== "ArrowUp" && event.key !== "Home" && event.key !== "End") return;
+  event.preventDefault();
+  var current = Array.prototype.indexOf.call(items, document.activeElement);
+  var next = 0;
+  if (event.key === "End") next = items.length - 1;
+  else if (event.key === "ArrowUp") next = current <= 0 ? items.length - 1 : current - 1;
+  else if (event.key === "ArrowDown") next = current < 0 || current === items.length - 1 ? 0 : current + 1;
+  if (items[next]) items[next].focus({ preventScroll: true });
+}
+
+function openMenu(trigger, conversation, options) {
+  closeMenu(false);
+  menuTrigger = trigger;
+  trigger.setAttribute("aria-expanded", "true");
+  menu = document.createElement("div");
+  menu.className = "home-session-actions-menu";
+  menu.setAttribute("role", "menu");
+  menu.setAttribute("aria-label", "Actions for " + conversation.title);
+  var details = document.createElement("button");
+  details.type = "button";
+  details.className = "home-session-actions-menu-item";
+  details.setAttribute("role", "menuitem");
+  details.textContent = "View details";
+  details.addEventListener("click", function (event) {
+    event.preventDefault();
+    event.stopPropagation();
+    var opener = options && options.detailsOpener ? options.detailsOpener : trigger;
+    closeMenu(false);
+    if (options && options.beforeOpenDetails) options.beforeOpenDetails();
+    openHomeSessionDetails(conversation, opener);
+  });
+  menu.appendChild(details);
+  document.body.appendChild(menu);
+  requestAnimationFrame(function () {
+    positionMenu();
+    details.focus({ preventScroll: true });
+  });
+  document.addEventListener("pointerdown", handleMenuOutside, true);
+  document.addEventListener("keydown", handleMenuKeydown, true);
+  window.addEventListener("resize", handleViewportChange);
+  window.addEventListener("scroll", handleViewportChange, true);
+}
+
+export function createHomeSessionActionsTrigger(conversation, options) {
+  var trigger = document.createElement("button");
+  trigger.type = "button";
+  trigger.className = "home-session-actions-trigger";
+  trigger.setAttribute("aria-label", "Conversation actions for " + conversation.title);
+  trigger.setAttribute("title", "Conversation actions");
+  trigger.setAttribute("aria-haspopup", "menu");
+  trigger.setAttribute("aria-expanded", "false");
+  trigger.innerHTML = '<span class="home-session-actions-mark" aria-hidden="true">•••</span>';
+  trigger.addEventListener("click", function (event) {
+    event.preventDefault();
+    event.stopPropagation();
+    if (menu && menuTrigger === trigger) closeMenu(false);
+    else openMenu(trigger, conversation, options || {});
+  });
+  trigger.addEventListener("keydown", function (event) {
+    if (event.key !== "ArrowDown" && event.key !== "ArrowUp" && event.key !== "Home" && event.key !== "End") return;
+    event.preventDefault();
+    event.stopPropagation();
+    openMenu(trigger, conversation, options || {});
+    requestAnimationFrame(function () {
+      var items = menuItems();
+      if (!items.length) return;
+      items[event.key === "ArrowUp" || event.key === "End" ? items.length - 1 : 0].focus({ preventScroll: true });
+    });
+  });
+  return trigger;
+}
+
+export function disposeHomeSessionActionsMenu() {
+  closeMenu(false);
+}
+
+function formatTime(value) {
+  if (!value) return "Not available";
+  var date = new Date(value);
+  if (isNaN(date.getTime())) return "Not available";
+  return date.toLocaleString([], { dateStyle: "medium", timeStyle: "short" });
+}
+
+function clearCopyTimers() {
+  for (var i = 0; i < copyTimers.length; i++) clearTimeout(copyTimers[i]);
+  copyTimers = [];
+}
+
+function addDetailField(list, label, value, copyValue, copyKey) {
+  var row = document.createElement("div");
+  row.className = "home-session-details-field";
+  var term = document.createElement("dt");
+  term.textContent = label;
+  var description = document.createElement("dd");
+  var text = document.createElement("span");
+  text.textContent = value;
+  if (copyKey) text.className = "home-session-details-id";
+  description.appendChild(text);
+  if (copyValue) {
+    var copy = document.createElement("button");
+    copy.type = "button";
+    copy.className = "home-session-details-copy";
+    copy.dataset.homeSessionCopy = copyKey;
+    copy.setAttribute("aria-label", "Copy " + label);
+    copy.textContent = "Copy";
+    copy.addEventListener("click", function () {
+      copyToClipboard(copyValue).then(function () {
+        copy.textContent = "Copied";
+        var timer = setTimeout(function () { if (copy.isConnected) copy.textContent = "Copy"; }, 1200);
+        copyTimers.push(timer);
+      }).catch(function () {
+        copy.textContent = "Copy failed";
+      });
+    });
+    description.appendChild(copy);
+  }
+  row.appendChild(term);
+  row.appendChild(description);
+  list.appendChild(row);
+}
+
+function renderDetails() {
+  if (!detailsOverlay || !detailsConversation) return;
+  var body = detailsOverlay.querySelector(".home-session-details-body");
+  if (!body) return;
+  body.innerHTML = "";
+  var summary = document.createElement("div");
+  summary.className = "home-session-details-summary";
+  var title = document.createElement("h3");
+  title.textContent = detailsConversation.title;
+  var mate = document.createElement("p");
+  mate.textContent = "Conversation with " + detailsConversation.mateName;
+  summary.appendChild(title);
+  summary.appendChild(mate);
+  body.appendChild(summary);
+  var list = document.createElement("dl");
+  list.className = "home-session-details-list";
+  addDetailField(list, "Status", detailsConversation.isProcessing ? "Working" : "Ready");
+  addDetailField(list, "Provider", detailsConversation.vendor || "Not available");
+  addDetailField(list, "Model", detailsConversation.model || "Not available");
+  addDetailField(list, "Created", formatTime(detailsConversation.createdAt));
+  addDetailField(list, "Last activity", formatTime(detailsConversation.lastActivity));
+  addDetailField(list, "Session reference", detailsConversation.sessionId, detailsConversation.sessionId, "reference");
+  if (detailsConversation.cliSessionId) {
+    addDetailField(list, "Session ID", detailsConversation.cliSessionId, detailsConversation.cliSessionId, "session-id");
+  } else {
+    addDetailField(list, "Session ID", "Not assigned yet — this conversation is still local.");
+  }
+  var localId = detailsConversation.localId == null ? "Not available" : String(detailsConversation.localId);
+  addDetailField(list, "Local ID", localId, detailsConversation.localId == null ? null : localId, "local-id");
+  body.appendChild(list);
+}
+
+function focusableDetails() {
+  return detailsOverlay ? detailsOverlay.querySelectorAll('button:not([disabled]), [href], input:not([disabled]), [tabindex]:not([tabindex="-1"])') : [];
+}
+
+function handleDetailsKeydown(event) {
+  if (!detailsOverlay) return;
+  if (event.key === "Escape") {
+    event.preventDefault();
+    event.stopPropagation();
+    closeHomeSessionDetails();
+    return;
+  }
+  if (event.key !== "Tab") return;
+  var focusable = focusableDetails();
+  if (!focusable.length) return;
+  var first = focusable[0];
+  var last = focusable[focusable.length - 1];
+  if (event.shiftKey && (document.activeElement === first || !detailsOverlay.contains(document.activeElement))) {
+    event.preventDefault();
+    last.focus();
+  } else if (!event.shiftKey && (document.activeElement === last || !detailsOverlay.contains(document.activeElement))) {
+    event.preventDefault();
+    first.focus();
+  }
+}
+
+export function closeHomeSessionDetails() {
+  var opener = detailsOpener;
+  clearCopyTimers();
+  if (detailsOverlay) detailsOverlay.remove();
+  detailsOverlay = null;
+  detailsOpener = null;
+  detailsKey = null;
+  detailsConversation = null;
+  document.removeEventListener("keydown", handleDetailsKeydown, true);
+  document.body.classList.remove("home-session-details-open");
+  if (opener && opener.isConnected) opener.focus({ preventScroll: true });
+}
+
+export function openHomeSessionDetails(conversation, opener) {
+  if (!conversation || !conversation.mateId || !conversation.sessionId) return false;
+  closeHomeSessionDetails();
+  detailsConversation = conversation;
+  detailsKey = conversationKey(conversation);
+  detailsOpener = opener || document.activeElement;
+  var overlay = document.createElement("div");
+  overlay.className = "home-session-details-overlay";
+  var dialog = document.createElement("section");
+  dialog.className = "home-session-details-dialog";
+  dialog.setAttribute("role", "dialog");
+  dialog.setAttribute("aria-modal", "true");
+  dialog.setAttribute("aria-labelledby", "home-session-details-title");
+  var header = document.createElement("header");
+  header.className = "home-session-details-header";
+  var title = document.createElement("h2");
+  title.id = "home-session-details-title";
+  title.textContent = "Conversation details";
+  var close = document.createElement("button");
+  close.type = "button";
+  close.className = "home-session-details-close";
+  close.setAttribute("aria-label", "Close conversation details");
+  close.textContent = "×";
+  close.addEventListener("click", closeHomeSessionDetails);
+  header.appendChild(title);
+  header.appendChild(close);
+  var body = document.createElement("div");
+  body.className = "home-session-details-body";
+  dialog.appendChild(header);
+  dialog.appendChild(body);
+  overlay.appendChild(dialog);
+  overlay.addEventListener("click", function (event) { if (event.target === overlay) closeHomeSessionDetails(); });
+  document.body.appendChild(overlay);
+  detailsOverlay = overlay;
+  document.body.classList.add("home-session-details-open");
+  document.addEventListener("keydown", handleDetailsKeydown, true);
+  renderDetails();
+  requestAnimationFrame(function () { close.focus({ preventScroll: true }); });
+  return true;
+}
+
+export function syncHomeSessionDetails() {
+  if (!detailsOverlay || !detailsKey) return;
+  var next = findConversation(detailsKey);
+  if (!next) {
+    closeHomeSessionDetails();
+    return;
+  }
+  var previous = JSON.stringify(detailsConversation);
+  if (JSON.stringify(next) === previous) return;
+  var activeCopy = document.activeElement && document.activeElement.dataset ? document.activeElement.dataset.homeSessionCopy : null;
+  detailsConversation = next;
+  renderDetails();
+  if (!activeCopy || !detailsOverlay) return;
+  var copies = detailsOverlay.querySelectorAll("[data-home-session-copy]");
+  for (var i = 0; i < copies.length; i++) {
+    if (copies[i].dataset.homeSessionCopy !== activeCopy) continue;
+    copies[i].focus({ preventScroll: true });
+    break;
+  }
+}
+
+export function disposeHomeSessionActions() {
+  closeMenu(false);
+  closeHomeSessionDetails();
+}

package/lib/public/modules/home-session-model-confirmation.js

@@ -0,0 +1,13 @@
+// Correlate a confirmed draft-model update with the exact active Home session.
+
+export function confirmedHomeSessionModel(active, message) {
+  if (!active || !message || message.sessionApplied !== true) return null;
+  if (!active.mateId || message.mateId !== active.mateId) return null;
+  if (!active.sessionId || (message.sessionId !== active.sessionId && message.requestedSessionId !== active.sessionId)) return null;
+  if (!message.sessionId || !message.sessionModel || !message.sessionVendor) return null;
+  return {
+    sessionId: message.sessionId,
+    vendor: message.sessionVendor,
+    model: message.sessionModel,
+  };
+}

package/lib/public/modules/home-shell.js

@@ -0,0 +1,9 @@
+// Reversible project-chrome suppression for the home route.
+
+export function showHomeShell() {
+  document.body.classList.add("home-active");
+}
+
+export function hideHomeShell() {
+  document.body.classList.remove("home-active");
+}

package/lib/public/modules/home-sidebar-chat-list.js

@@ -0,0 +1,63 @@
+// Complete, globally sorted Home chat archive rendered in the sidebar.
+
+import { store } from './store.js';
+import { getHomeSessionConversations, createHomeSessionActionsTrigger, disposeHomeSessionActionsMenu } from './home-session-actions.js';
+
+export function renderHomeSidebarChats(openConversation) {
+  var list = document.getElementById("home-sidebar-recent-list");
+  if (!list) return 0;
+  disposeHomeSessionActionsMenu();
+  list.innerHTML = "";
+  var chats = getHomeSessionConversations();
+  var scope = store.get('homeChatScope') === "current" ? "current" : "all";
+  var activeMateId = store.get('homeChatMateId');
+  if (scope === "current") {
+    chats = chats.filter(function (chat) { return chat.mateId === activeMateId; });
+  }
+  if (!chats.length) {
+    var empty = document.createElement("div");
+    empty.className = "home-sidebar-recent-empty";
+    empty.textContent = scope === "current" ? "No chats with this Mate yet." : "Chats will appear here.";
+    list.appendChild(empty);
+    return 0;
+  }
+  var activeSessionId = store.get('homeChatSessionId');
+  for (var i = 0; i < chats.length; i++) {
+    (function (chat) {
+      var item = document.createElement("div");
+      item.className = "home-sidebar-recent-item";
+      var row = document.createElement("button");
+      row.type = "button";
+      row.className = "home-sidebar-recent-row";
+      row.setAttribute("aria-label", chat.title + ", with " + chat.mateName);
+      if (chat.mateId === activeMateId && chat.sessionId === activeSessionId) {
+        item.classList.add("is-active");
+        row.setAttribute("aria-current", "page");
+      }
+      var copy = document.createElement("span");
+      copy.className = "home-sidebar-recent-copy";
+      var title = document.createElement("span");
+      title.className = "home-sidebar-recent-title";
+      title.textContent = chat.title;
+      var mate = document.createElement("span");
+      mate.className = "home-sidebar-recent-mate";
+      mate.textContent = chat.mateName;
+      copy.appendChild(title);
+      copy.appendChild(mate);
+      row.appendChild(copy);
+      if (chat.isProcessing) {
+        var activity = document.createElement("span");
+        activity.className = "home-sidebar-processing";
+        activity.setAttribute("aria-label", "Processing");
+        row.appendChild(activity);
+      }
+      row.addEventListener("click", function () {
+        if (typeof openConversation === "function") openConversation(chat.mateId, chat.sessionId);
+      });
+      item.appendChild(row);
+      item.appendChild(createHomeSessionActionsTrigger(chat));
+      list.appendChild(item);
+    })(chats[i]);
+  }
+  return chats.length;
+}

package/lib/public/modules/home-sidebar.js

@@ -0,0 +1,158 @@
+// Minimal Home navigation through Mates and their conversation history.
+
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { refreshIcons } from './icons.js';
+import { updateHomeSurfacePreference } from './home-surface.js';
+import { openHomeConversation, startNewHomeConversation } from './home-mate-chat.js';
+import { openHomeDebatesArchive } from './home-debates-archive.js';
+import { openHomeConversationsSheet, refreshHomeConversationsSheet } from './home-conversations-sheet.js';
+import { renderHomeSidebarChats } from './home-sidebar-chat-list.js';
+import { syncHomeSessionDetails } from './home-session-actions.js';
+import { toggleHomeCapsules } from './home-dock.js';
+
+var initialized = false;
+var requestedMateIds = {};
+
+function visibleMates() {
+  return (store.get('cachedMatesList') || []).filter(function (mate) {
+    return !!mate && !mate.archived;
+  });
+}
+
+function requestConversationLists(force) {
+  var ws = getWs();
+  if (!ws || ws.readyState !== 1) return;
+  if (force) requestedMateIds = {};
+  var mates = visibleMates();
+  for (var i = 0; i < mates.length; i++) {
+    if (requestedMateIds[mates[i].id]) continue;
+    requestedMateIds[mates[i].id] = true;
+    ws.send(JSON.stringify({ type: "home_mate_sessions_list", mateId: mates[i].id }));
+  }
+}
+
+function renderRecentConversations() {
+  renderHomeSidebarChats(openConversationFromSidebar);
+}
+
+function renderChatScope() {
+  var scope = store.get('homeChatScope') === "current" ? "current" : "all";
+  var buttons = document.querySelectorAll("[data-home-chat-scope]");
+  for (var i = 0; i < buttons.length; i++) {
+    buttons[i].setAttribute("aria-pressed", String(buttons[i].dataset.homeChatScope === scope));
+  }
+}
+
+function renderSidebarState() {
+  var hub = document.getElementById("home-hub");
+  if (!hub) return;
+  var collapsed = store.get('homeSidebarCollapsed') === true;
+  hub.classList.toggle("home-sidebar-collapsed", collapsed);
+  var collapse = document.getElementById("home-sidebar-collapse");
+  var expand = document.getElementById("home-sidebar-expand");
+  if (collapse) collapse.setAttribute("aria-expanded", String(!collapsed));
+  if (expand) expand.setAttribute("aria-expanded", String(!collapsed));
+  renderChatScope();
+  renderRecentConversations();
+  refreshHomeConversationsSheet();
+  syncHomeSessionDetails();
+}
+
+function setCollapsed(collapsed) {
+  updateHomeSurfacePreference({ sidebarCollapsed: collapsed });
+}
+
+function setChatScope(event) {
+  var scope = event.currentTarget.dataset.homeChatScope;
+  if (scope !== "current" && scope !== "all") return;
+  if ((store.get('homeChatScope') || "all") === scope) return;
+  updateHomeSurfacePreference({ chatScope: scope });
+}
+
+function isNarrowDrawer() {
+  return !!window.matchMedia && window.matchMedia("(max-width: 768px)").matches;
+}
+
+function focusNarrowNavigationTarget() {
+  var composer = document.getElementById("home-mate-chat-input");
+  if (composer && !composer.disabled && composer.getClientRects().length) {
+    composer.focus();
+    return;
+  }
+  var expand = document.getElementById("home-sidebar-expand");
+  if (expand && expand.getClientRects().length) expand.focus();
+}
+
+function closeNarrowDrawer(focusConversation) {
+  if (!isNarrowDrawer()) return;
+  setCollapsed(true);
+  if (focusConversation) focusNarrowNavigationTarget();
+}
+
+export function closeHomeSidebarAfterSelection() {
+  closeNarrowDrawer(true);
+}
+
+function openConversationFromSidebar(mateId, sessionId) {
+  openHomeConversation(mateId, sessionId);
+  closeNarrowDrawer(true);
+}
+
+function startConversationFromSidebar() {
+  startNewHomeConversation();
+  closeNarrowDrawer(true);
+}
+
+function openAllConversations(event) {
+  openHomeConversationsSheet(openConversationFromSidebar, event.currentTarget);
+}
+
+function openDebatesFromSidebar() {
+  openHomeDebatesArchive();
+  closeNarrowDrawer(false);
+}
+
+function toggleCapsulesFromSidebar() {
+  var opening = store.get('dockOpen') !== true;
+  toggleHomeCapsules();
+  closeNarrowDrawer(!opening);
+}
+
+function handleSidebarKeydown(event) {
+  if (event.key !== "Escape" || event.defaultPrevented) return;
+  if (!document.body.classList.contains("home-active")) return;
+  if (document.querySelector(".home-conversations-sheet, .home-session-details-overlay")) return;
+  if (!isNarrowDrawer() || store.get('homeSidebarCollapsed') === true) return;
+  event.preventDefault();
+  closeNarrowDrawer(true);
+}
+
+export function initHomeSidebar() {
+  if (initialized) return;
+  initialized = true;
+  document.getElementById("home-sidebar-collapse").addEventListener("click", function () { setCollapsed(true); });
+  document.getElementById("home-sidebar-expand").addEventListener("click", function () { setCollapsed(false); });
+  document.getElementById("home-sidebar-backdrop").addEventListener("click", function () { setCollapsed(true); });
+  document.getElementById("home-sidebar-new").addEventListener("click", startConversationFromSidebar);
+  document.getElementById("home-sidebar-all").addEventListener("click", openAllConversations);
+  document.getElementById("home-sidebar-debate").addEventListener("click", openDebatesFromSidebar);
+  document.getElementById("home-tools-btn").addEventListener("click", toggleCapsulesFromSidebar);
+  var scopeButtons = document.querySelectorAll("[data-home-chat-scope]");
+  for (var i = 0; i < scopeButtons.length; i++) scopeButtons[i].addEventListener("click", setChatScope);
+  store.subscribe(function (state, prev) {
+    if (state.connected !== prev.connected && state.connected) requestConversationLists(true);
+    if (state.cachedMatesList !== prev.cachedMatesList) requestConversationLists(false);
+    if (state.homeMateSessions !== prev.homeMateSessions || state.homeChatMateId !== prev.homeChatMateId || state.homeChatSessionId !== prev.homeChatSessionId || state.homeSidebarCollapsed !== prev.homeSidebarCollapsed || state.homeChatScope !== prev.homeChatScope) {
+      renderSidebarState();
+    }
+  });
+  document.addEventListener("keydown", handleSidebarKeydown);
+  requestConversationLists(false);
+  renderSidebarState();
+  refreshIcons();
+}
+
+export function refreshHomeSidebarSessions() {
+  requestConversationLists(true);
+}

package/lib/public/modules/home-sub-surface.js

@@ -0,0 +1,19 @@
+// Durable Home main-stage selection shared by chat and debate archive controllers.
+
+import { store } from './store.js';
+import { updateHomeSurfacePreference } from './home-surface.js';
+
+export function setHomeSubSurface(surface, persist) {
+  var next = surface === "debates" ? "debates" : "chat";
+  if (store.get('homeSubSurface') === next) {
+    if (next === "chat" && store.get('homeDebateTopicFormOpen')) store.set({ homeDebateTopicFormOpen: false });
+    return false;
+  }
+  store.set({ homeSubSurface: next, homeDebateTopicFormOpen: next === "chat" ? false : store.get('homeDebateTopicFormOpen') });
+  if (persist !== false) updateHomeSurfacePreference({ subSurface: next });
+  return true;
+}
+
+export function isHomeDebatesSurface() {
+  return store.get('homeSubSurface') === "debates";
+}