clay-server 3.8.1 → 4.0.0-beta.10

package/lib/public/modules/home-chat-scroll.js

@@ -0,0 +1,77 @@
+// User-intent-aware scroll following for the rebuilt Home transcript DOM.
+
+var messagesEl = null;
+var activityButton = null;
+var bound = false;
+var adjusting = false;
+var userScrolledUp = false;
+var activityVersion = 0;
+var seenActivityVersion = 0;
+var followNext = false;
+var BOTTOM_THRESHOLD = 150;
+
+function resolveDom() {
+  if (!messagesEl) messagesEl = document.getElementById("home-mate-chat-messages");
+  if (!activityButton) activityButton = document.getElementById("home-chat-new-activity");
+  if (bound || !messagesEl || !activityButton) return;
+  bound = true;
+  messagesEl.addEventListener("scroll", function () {
+    if (adjusting) return;
+    var distance = messagesEl.scrollHeight - messagesEl.scrollTop - messagesEl.clientHeight;
+    userScrolledUp = distance > BOTTOM_THRESHOLD;
+    if (!userScrolledUp) {
+      seenActivityVersion = activityVersion;
+      activityButton.hidden = true;
+    }
+  }, { passive: true });
+  activityButton.addEventListener("click", function () {
+    userScrolledUp = false;
+    followNext = true;
+    activityButton.hidden = true;
+    adjusting = true;
+    messagesEl.scrollTop = messagesEl.scrollHeight;
+    requestAnimationFrame(function () { adjusting = false; });
+  });
+}
+
+export function markHomeChatActivity() {
+  activityVersion += 1;
+}
+
+export function followHomeChatNextRender() {
+  followNext = true;
+  userScrolledUp = false;
+}
+
+export function captureHomeChatScroll(force) {
+  resolveDom();
+  if (!messagesEl) return null;
+  var distance = messagesEl.scrollHeight - messagesEl.scrollTop - messagesEl.clientHeight;
+  var nearBottom = !isFinite(distance) || distance <= BOTTOM_THRESHOLD;
+  return {
+    follow: force === true || followNext || (!userScrolledUp && nearBottom),
+    scrollTop: messagesEl.scrollTop || 0,
+    hasActivity: activityVersion > seenActivityVersion,
+  };
+}
+
+export function restoreHomeChatScroll(snapshot) {
+  resolveDom();
+  if (!messagesEl || !snapshot) return;
+  followNext = false;
+  adjusting = true;
+  if (snapshot.follow) {
+    userScrolledUp = false;
+    seenActivityVersion = activityVersion;
+    if (activityButton) activityButton.hidden = true;
+    requestAnimationFrame(function () {
+      messagesEl.scrollTop = messagesEl.scrollHeight;
+      adjusting = false;
+    });
+    return;
+  }
+  messagesEl.scrollTop = snapshot.scrollTop;
+  userScrolledUp = true;
+  if (activityButton && snapshot.hasActivity) activityButton.hidden = false;
+  requestAnimationFrame(function () { adjusting = false; });
+}

package/lib/public/modules/home-chat-stream-state.js

@@ -0,0 +1,34 @@
+// Pure correlation and transcript helpers for the Home conversation stream.
+
+export function isOwnedHomeSessionMessage(active, msg) {
+  if (!msg || msg.mateId !== active.mateId) return false;
+  if (msg.requestId && msg.requestId !== active.requestId) return false;
+  if (active.sessionId && msg.sessionId && msg.sessionId !== active.sessionId) return false;
+  return true;
+}
+
+export function resolveHomeSessionIdentity(active, msg) {
+  if (!msg || msg.mateId !== active.mateId) return null;
+  if (msg.requestId && msg.requestId !== active.requestId) return null;
+  if (!msg.previousSessionId || !msg.sessionId) return null;
+  if (active.sessionId !== msg.previousSessionId) return null;
+  return msg.sessionId;
+}
+
+export function appendHomeStreamText(current, incoming) {
+  return current + (typeof incoming === "string" ? incoming : "");
+}
+
+export function finalizeHomeAssistant(messages, streamingText, finalText, timestamp) {
+  var text = typeof finalText === "string" && finalText ? finalText : streamingText;
+  if (!text) return messages;
+  var last = messages.length ? messages[messages.length - 1] : null;
+  if (last && last.role === "assistant" && last.text === text) return messages;
+  var next = messages.slice();
+  if (last && last.role === "assistant" && text.indexOf(last.text) === 0) {
+    next[next.length - 1] = { role: "assistant", text: text, ts: timestamp };
+    return next;
+  }
+  next.push({ role: "assistant", text: text, ts: timestamp });
+  return next;
+}

package/lib/public/modules/home-composer-focus.js

@@ -0,0 +1,25 @@
+// Home composer submission bindings and one-shot focus restoration.
+
+export function focusHomeComposerAfterSubmit(input) {
+  if (!input || input.disabled || input.isConnected === false) return false;
+  var home = typeof input.closest === "function" ? input.closest("#home-hub") : null;
+  if (!home || (home.classList && home.classList.contains("hidden"))) return false;
+  var ownerDocument = input.ownerDocument || document;
+  if (ownerDocument.hidden) return false;
+  if (ownerDocument.activeElement === input) return true;
+  input.focus({ preventScroll: true });
+  return true;
+}
+
+export function bindHomeComposerSubmission(input, sendButton, submit) {
+  function submitAndRestoreFocus() {
+    if (submit() !== true) return false;
+    return focusHomeComposerAfterSubmit(input);
+  }
+  input.addEventListener("keydown", function (event) {
+    if (event.key !== "Enter" || event.shiftKey || event.isComposing) return;
+    event.preventDefault();
+    submitAndRestoreFocus();
+  });
+  sendButton.addEventListener("click", submitAndRestoreFocus);
+}

package/lib/public/modules/home-conversations-sheet.js

@@ -0,0 +1,179 @@
+// Searchable projection of every user-owned Mate conversation loaded by Home.
+
+import { store } from './store.js';
+import { iconHtml, refreshIcons } from './icons.js';
+import { getHomeSessionConversations, createHomeSessionActionsTrigger, disposeHomeSessionActionsMenu } from './home-session-actions.js';
+
+var overlay = null;
+var searchInput = null;
+var listEl = null;
+var sheetOpener = null;
+var selectConversation = null;
+
+function closeSheet(restoreFocus) {
+  if (!overlay) return;
+  var opener = sheetOpener;
+  disposeHomeSessionActionsMenu();
+  overlay.remove();
+  overlay = null;
+  searchInput = null;
+  listEl = null;
+  sheetOpener = null;
+  selectConversation = null;
+  document.removeEventListener("keydown", handleKeydown, true);
+  if (restoreFocus !== false && opener && document.contains(opener) && typeof opener.focus === "function") opener.focus();
+}
+
+function focusableElements() {
+  if (!overlay) return [];
+  return Array.prototype.slice.call(overlay.querySelectorAll('button:not([disabled]):not([tabindex="-1"]), input:not([disabled]), [href], [tabindex]:not([tabindex="-1"])'));
+}
+
+function handleKeydown(event) {
+  if (event.key === "Escape") {
+    event.preventDefault();
+    event.stopPropagation();
+    closeSheet();
+    return;
+  }
+  if (event.key !== "Tab") return;
+  var focusable = focusableElements();
+  if (!focusable.length) {
+    event.preventDefault();
+    return;
+  }
+  var first = focusable[0];
+  var last = focusable[focusable.length - 1];
+  var active = document.activeElement;
+  if (event.shiftKey && (active === first || !overlay.contains(active))) {
+    event.preventDefault();
+    last.focus();
+  } else if (!event.shiftKey && (active === last || !overlay.contains(active))) {
+    event.preventDefault();
+    first.focus();
+  }
+}
+
+function renderRows() {
+  if (!listEl) return;
+  var query = searchInput ? searchInput.value.trim().toLowerCase() : "";
+  var all = getHomeSessionConversations().filter(function (conversation) {
+    if (!query) return true;
+    return conversation.title.toLowerCase().indexOf(query) !== -1 || conversation.mateName.toLowerCase().indexOf(query) !== -1;
+  });
+  disposeHomeSessionActionsMenu();
+  listEl.innerHTML = "";
+  if (!all.length) {
+    var empty = document.createElement("div");
+    empty.className = "home-conversations-sheet-empty";
+    empty.textContent = query ? "No chats match your search." : "No chats yet.";
+    listEl.appendChild(empty);
+    return;
+  }
+  for (var i = 0; i < all.length; i++) {
+    (function (conversation) {
+      var item = document.createElement("div");
+      item.className = "home-conversations-sheet-item";
+      var row = document.createElement("button");
+      row.type = "button";
+      row.className = "home-conversations-sheet-row";
+      var copy = document.createElement("span");
+      copy.className = "home-conversations-sheet-copy";
+      var title = document.createElement("span");
+      title.className = "home-conversations-sheet-row-title";
+      title.textContent = conversation.title;
+      copy.appendChild(title);
+      var mate = document.createElement("span");
+      mate.className = "home-conversations-sheet-row-mate";
+      mate.textContent = conversation.mateName;
+      copy.appendChild(mate);
+      row.appendChild(copy);
+      if (conversation.isProcessing) {
+        var activity = document.createElement("span");
+        activity.className = "home-sidebar-processing";
+        activity.setAttribute("aria-label", "Processing");
+        row.appendChild(activity);
+      }
+      row.addEventListener("click", function () {
+        var onSelect = selectConversation;
+        closeSheet();
+        if (onSelect) onSelect(conversation.mateId, conversation.sessionId);
+      });
+      var active = conversation.mateId === store.get('homeChatMateId') && conversation.sessionId === store.get('homeChatSessionId');
+      if (active) {
+        item.classList.add("is-active");
+        row.setAttribute("aria-current", "page");
+      }
+      var detailsReturn = sheetOpener;
+      var actions = createHomeSessionActionsTrigger(conversation, {
+        detailsOpener: detailsReturn,
+        beforeOpenDetails: function () { closeSheet(false); },
+      });
+      item.appendChild(row);
+      item.appendChild(actions);
+      listEl.appendChild(item);
+    })(all[i]);
+  }
+}
+
+export function openHomeConversationsSheet(onSelect, opener) {
+  closeSheet();
+  sheetOpener = opener || document.activeElement;
+  selectConversation = onSelect;
+  overlay = document.createElement("div");
+  overlay.className = "home-conversations-sheet";
+  overlay.setAttribute("role", "dialog");
+  overlay.setAttribute("aria-modal", "true");
+  overlay.setAttribute("aria-labelledby", "home-conversations-sheet-title");
+
+  var backdrop = document.createElement("button");
+  backdrop.type = "button";
+  backdrop.className = "home-conversations-sheet-backdrop";
+  backdrop.setAttribute("aria-label", "Close chats");
+  backdrop.tabIndex = -1;
+  backdrop.addEventListener("click", closeSheet);
+  overlay.appendChild(backdrop);
+
+  var panel = document.createElement("section");
+  panel.className = "home-conversations-sheet-panel";
+  var header = document.createElement("header");
+  header.className = "home-conversations-sheet-header";
+  var title = document.createElement("div");
+  title.id = "home-conversations-sheet-title";
+  title.className = "home-conversations-sheet-title";
+  title.textContent = "All chats";
+  header.appendChild(title);
+  var close = document.createElement("button");
+  close.type = "button";
+  close.className = "home-sidebar-icon-btn";
+  close.setAttribute("aria-label", "Close chats");
+  close.innerHTML = iconHtml("x");
+  close.addEventListener("click", closeSheet);
+  header.appendChild(close);
+  panel.appendChild(header);
+
+  var search = document.createElement("label");
+  search.className = "home-conversations-sheet-search";
+  search.innerHTML = iconHtml("search");
+  searchInput = document.createElement("input");
+  searchInput.type = "search";
+  searchInput.placeholder = "Search chats";
+  searchInput.setAttribute("aria-label", "Search chats");
+  searchInput.addEventListener("input", renderRows);
+  search.appendChild(searchInput);
+  panel.appendChild(search);
+
+  listEl = document.createElement("div");
+  listEl.className = "home-conversations-sheet-list";
+  panel.appendChild(listEl);
+  overlay.appendChild(panel);
+  document.body.appendChild(overlay);
+  document.addEventListener("keydown", handleKeydown, true);
+  renderRows();
+  refreshIcons();
+  searchInput.focus();
+}
+
+export function refreshHomeConversationsSheet() {
+  if (overlay) renderRows();
+}

package/lib/public/modules/home-debate-activity.js

@@ -0,0 +1,48 @@
+// Shared ephemeral activity row for Home debate planning.
+
+var announced = {};
+
+export function resetHomeDebateActivityAnnouncement(modifier) {
+  if (modifier) delete announced[modifier];
+}
+
+function textElement(tag, className, text) {
+  var element = document.createElement(tag);
+  element.className = className;
+  element.textContent = text;
+  return element;
+}
+
+export function createHomeDebateActivityRow(statusText, accessibleText, modifier) {
+  var announcementKey = modifier || "home-debate-activity";
+  var row = document.createElement("div");
+  row.className = "home-debate-activity " + announcementKey;
+  row.setAttribute("role", "status");
+  row.setAttribute("aria-live", announced[announcementKey] ? "off" : "polite");
+  row.setAttribute("aria-atomic", "true");
+  row.setAttribute("aria-label", accessibleText);
+  announced[announcementKey] = true;
+
+  var avatar = document.createElement("img");
+  avatar.className = "home-debate-activity-avatar";
+  avatar.src = "/clay-studio-symbol.png";
+  avatar.alt = "";
+  avatar.width = 28;
+  avatar.height = 28;
+  row.appendChild(avatar);
+
+  var content = document.createElement("div");
+  content.className = "home-debate-activity-content";
+  content.appendChild(textElement("span", "home-debate-activity-name", "Clay"));
+  var status = document.createElement("div");
+  status.className = "home-debate-activity-status";
+  status.appendChild(textElement("span", "home-debate-activity-label", statusText));
+  var dots = document.createElement("span");
+  dots.className = "home-debate-activity-dots";
+  dots.setAttribute("aria-hidden", "true");
+  for (var i = 0; i < 3; i++) dots.appendChild(document.createElement("i"));
+  status.appendChild(dots);
+  content.appendChild(status);
+  row.appendChild(content);
+  return row;
+}

package/lib/public/modules/home-debate-controls.js

@@ -0,0 +1,295 @@
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+
+var slotEl = null;
+var normalComposerEl = null;
+var modelEl = null;
+var controlEl = null;
+var controlMode = null;
+var controlStateKey = null;
+var currentState = null;
+var currentRequestId = null;
+var startNewDebate = null;
+var inputEl = null;
+var primaryEl = null;
+var secondaryEl = null;
+var activityEl = null;
+var handEl = null;
+var stopEl = null;
+var composing = false;
+
+function textElement(tag, className, text) {
+  var element = document.createElement(tag);
+  element.className = className;
+  element.textContent = text || "";
+  return element;
+}
+
+function findHeader(messages) {
+  for (var i = (messages || []).length - 1; i >= 0; i--) if (messages[i] && messages[i].role === "debate_header") return messages[i];
+  return null;
+}
+
+function findActiveTurn(messages) {
+  for (var i = (messages || []).length - 1; i >= 0; i--) {
+    if (messages[i] && messages[i].role === "debate_turn" && messages[i].status === "active") return messages[i];
+  }
+  return null;
+}
+
+export function homeDebateControlState(messages) {
+  var header = findHeader(messages);
+  if (!header || ["live", "ended", "interrupted"].indexOf(header.phase) === -1) return null;
+  var mode = header.phase === "live" ? (header.interaction || "default") : "terminal";
+  return { mode: mode, header: header, turn: findActiveTurn(messages), phase: header.phase };
+}
+
+function ensureElements() {
+  var nextSlot = document.getElementById("home-debate-controls-slot");
+  if (slotEl === nextSlot) return !!slotEl;
+  slotEl = nextSlot;
+  normalComposerEl = document.getElementById("home-mate-chat-composer");
+  modelEl = document.getElementById("home-mate-chat-session-model");
+  controlEl = null;
+  controlMode = null;
+  controlStateKey = null;
+  return !!slotEl;
+}
+
+function clearControls() {
+  if (slotEl) slotEl.innerHTML = "";
+  controlEl = null;
+  controlMode = null;
+  controlStateKey = null;
+  currentState = null;
+  inputEl = null;
+  primaryEl = null;
+  secondaryEl = null;
+  activityEl = null;
+  handEl = null;
+  stopEl = null;
+  composing = false;
+}
+
+function setSpecialMode(active) {
+  if (normalComposerEl) normalComposerEl.hidden = active;
+  if (modelEl) modelEl.hidden = active;
+  if (slotEl) slotEl.hidden = !active;
+}
+
+function sendControl(action, data) {
+  var ws = getWs();
+  if (!ws || ws.readyState !== 1 || !currentState) return false;
+  ws.send(JSON.stringify({
+    type: "home_debate_control",
+    action: action,
+    mateId: store.get('homeChatMateId'),
+    sessionId: store.get('homeChatSessionId'),
+    requestId: currentRequestId,
+    text: data && data.text ? data.text : "",
+    response: data && data.response ? data.response : null,
+  }));
+  return true;
+}
+
+function button(label, className) {
+  var element = textElement("button", className, label);
+  element.type = "button";
+  return element;
+}
+
+function dots() {
+  var group = document.createElement("span");
+  group.className = "home-debate-control-dots";
+  group.setAttribute("aria-hidden", "true");
+  for (var i = 0; i < 3; i++) group.appendChild(document.createElement("i"));
+  return group;
+}
+
+function activityLabel(state) {
+  if (state.header.stopping) return state.turn ? "Stopping after " + (state.turn.mateName || "the current speaker") + " finishes" : "Stopping debate";
+  if (!state.turn) return state.header.handRaised ? "Your hand is raised" : "Debate is live";
+  var name = state.turn.mateName || "Mate";
+  var activity = state.turn.activity || (state.turn.text ? "speaking" : "preparing");
+  return name + " is " + activity.toLowerCase();
+}
+
+function lockSubmission(label) {
+  if (inputEl) inputEl.disabled = true;
+  if (primaryEl) { primaryEl.disabled = true; primaryEl.textContent = label; }
+  if (secondaryEl) secondaryEl.disabled = true;
+}
+
+function submitInput(action, response) {
+  var text = inputEl ? inputEl.value.trim() : "";
+  if (action === "user_floor" && !text) return false;
+  if (!sendControl(action, { text: text, response: response })) return false;
+  lockSubmission(action === "user_floor" ? "Sending…" : "Continuing…");
+  return true;
+}
+
+function bindInput(submit) {
+  inputEl.addEventListener("compositionstart", function () { composing = true; });
+  inputEl.addEventListener("compositionend", function () { composing = false; });
+  inputEl.addEventListener("input", function () {
+    if (controlMode === "user_floor" && primaryEl) primaryEl.disabled = !inputEl.value.trim();
+  });
+  inputEl.addEventListener("keydown", function (event) {
+    if (event.key !== "Enter" || event.shiftKey || event.isComposing || composing || event.keyCode === 229) return;
+    event.preventDefault();
+    submit();
+  });
+}
+
+function focusInputOnce() {
+  var target = inputEl;
+  if (!target) return;
+  var focus = function () {
+    if (target === inputEl && !target.disabled && target.isConnected !== false) target.focus({ preventScroll: true });
+  };
+  if (typeof requestAnimationFrame === "function") requestAnimationFrame(focus);
+  else focus();
+}
+
+function buildDefault(state) {
+  var context = document.createElement("div");
+  context.className = "home-debate-control-context";
+  context.appendChild(dots());
+  activityEl = textElement("span", "home-debate-control-activity", activityLabel(state));
+  activityEl.setAttribute("role", "status");
+  activityEl.setAttribute("aria-live", "polite");
+  context.appendChild(activityEl);
+  controlEl.appendChild(context);
+  var actions = document.createElement("div");
+  actions.className = "home-debate-control-actions";
+  handEl = button(state.header.handRaised ? "Hand raised" : "Raise hand", "home-debate-control-secondary");
+  handEl.setAttribute("aria-pressed", state.header.handRaised ? "true" : "false");
+  handEl.disabled = state.header.handRaised === true;
+  handEl.addEventListener("click", function () {
+    if (!sendControl("hand_raise")) return;
+    handEl.disabled = true;
+    handEl.textContent = "Raising hand…";
+  });
+  stopEl = button(state.header.stopping ? "Cancel stop" : "Stop debate", state.header.stopping ? "home-debate-control-secondary" : "home-debate-control-stop");
+  stopEl.addEventListener("click", function () {
+    var cancelling = currentState && currentState.header && currentState.header.stopping === true;
+    if (!sendControl(cancelling ? "cancel_stop" : "stop")) return;
+    stopEl.disabled = true;
+    stopEl.textContent = cancelling ? "Cancelling…" : "Stopping…";
+  });
+  actions.appendChild(handEl);
+  actions.appendChild(stopEl);
+  controlEl.appendChild(actions);
+}
+
+function buildInputMode(state) {
+  var isFloor = state.mode === "user_floor";
+  var heading = textElement("div", "home-debate-control-heading", isFloor ? "You have the floor" : "The moderator is ready to conclude");
+  heading.id = "home-debate-control-heading";
+  controlEl.appendChild(heading);
+  inputEl = document.createElement("textarea");
+  inputEl.rows = 2;
+  inputEl.placeholder = isFloor ? "Share your thoughts with the panel" : "Add an optional direction to continue";
+  inputEl.setAttribute("aria-labelledby", heading.id);
+  controlEl.appendChild(inputEl);
+  var actions = document.createElement("div");
+  actions.className = "home-debate-control-actions";
+  if (isFloor) {
+    primaryEl = button("Send", "home-debate-control-primary");
+    primaryEl.disabled = true;
+    primaryEl.addEventListener("click", function () { submitInput("user_floor"); });
+    secondaryEl = button("Pass", "home-debate-control-secondary");
+    secondaryEl.addEventListener("click", function () {
+      if (!sendControl("user_floor", { text: "(The user passed without speaking)" })) return;
+      lockSubmission("Sending…");
+    });
+  } else {
+    primaryEl = button("Continue", "home-debate-control-primary");
+    primaryEl.addEventListener("click", function () { submitInput("conclude", "continue"); });
+    secondaryEl = button("End debate", "home-debate-control-stop");
+    secondaryEl.addEventListener("click", function () {
+      if (!sendControl("conclude", { response: "end" })) return;
+      lockSubmission("Ending…");
+    });
+  }
+  actions.appendChild(primaryEl);
+  actions.appendChild(secondaryEl);
+  controlEl.appendChild(actions);
+  bindInput(function () { submitInput(isFloor ? "user_floor" : "conclude", isFloor ? null : "continue"); });
+  focusInputOnce();
+}
+
+function terminalLabel(state) {
+  if (state.phase === "interrupted") return "Debate interrupted when Clay restarted";
+  if (state.header.reason === "error") return "The debate stopped after an error";
+  if (state.header.reason === "stopped" || state.header.reason === "user_stopped") return "Debate stopped";
+  return "Debate ended";
+}
+
+function buildTerminal(state) {
+  var status = textElement("div", "home-debate-control-terminal-status", terminalLabel(state));
+  status.setAttribute("role", "status");
+  controlEl.appendChild(status);
+  var actions = document.createElement("div");
+  actions.className = "home-debate-control-actions";
+  primaryEl = button("Resume debate", "home-debate-control-primary");
+  primaryEl.addEventListener("click", function () {
+    if (!sendControl("resume")) return;
+    lockSubmission("Resuming…");
+  });
+  actions.appendChild(primaryEl);
+  if (typeof startNewDebate === "function") {
+    secondaryEl = button("New debate", "home-debate-control-secondary");
+    secondaryEl.addEventListener("click", function () { startNewDebate(); });
+    actions.appendChild(secondaryEl);
+  }
+  controlEl.appendChild(actions);
+}
+
+function buildControls(state) {
+  slotEl.innerHTML = "";
+  controlEl = document.createElement("section");
+  controlEl.className = "home-debate-control-surface home-debate-control-" + state.mode;
+  controlEl.setAttribute("role", state.mode === "default" ? "toolbar" : "region");
+  controlEl.setAttribute("aria-label", state.mode === "terminal" ? "Debate status" : "Live debate controls");
+  slotEl.appendChild(controlEl);
+  if (state.mode === "default") buildDefault(state);
+  else if (state.mode === "user_floor" || state.mode === "conclude") buildInputMode(state);
+  else buildTerminal(state);
+  controlMode = state.mode;
+  controlStateKey = state.mode + ":" + state.phase + ":" + (state.header.reason || "");
+}
+
+function updateControls(state) {
+  if (state.mode !== "default") return;
+  var label = activityLabel(state);
+  if (activityEl && activityEl.textContent !== label) activityEl.textContent = label;
+  if (state.header.handRaised && handEl) {
+    handEl.textContent = "Hand raised";
+    handEl.disabled = true;
+    handEl.setAttribute("aria-pressed", "true");
+  }
+  if (stopEl) {
+    stopEl.disabled = false;
+    stopEl.textContent = state.header.stopping ? "Cancel stop" : "Stop debate";
+    stopEl.className = state.header.stopping ? "home-debate-control-secondary" : "home-debate-control-stop";
+  }
+}
+
+export function renderHomeDebateControls(messages, requestId, onStartNewDebate) {
+  if (!ensureElements()) return false;
+  var state = homeDebateControlState(messages);
+  currentRequestId = requestId || null;
+  startNewDebate = onStartNewDebate || null;
+  if (!state) {
+    setSpecialMode(false);
+    clearControls();
+    return false;
+  }
+  currentState = state;
+  setSpecialMode(true);
+  var nextStateKey = state.mode + ":" + state.phase + ":" + (state.header.reason || "");
+  if (!controlEl || controlMode !== state.mode || controlStateKey !== nextStateKey) buildControls(state);
+  else updateControls(state);
+  return true;
+}