clay-server 3.8.1 → 4.0.0-beta.2

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

@@ -0,0 +1,335 @@
+// Safe native Home transcript presentation for a session-bound debate brief.
+
+import { store } from './store.js';
+import { refreshIcons } from './icons.js';
+import { appendDebateModelSelectors, collectDebateModelOverrides } from './home-debate-models.js';
+import { createHomeDebateActivityRow, resetHomeDebateActivityAnnouncement } from './home-debate-activity.js';
+var pendingComposerOpener = null;
+var planningPending = false;
+
+export function clearHomeDebatePlanningPending() { planningPending = false; resetHomeDebateActivityAnnouncement("home-debate-activity-next"); }
+export function isHomeDebatePlanningPending() { return planningPending; }
+export function syncHomeDebatePlanningPending(msg) {
+  var wasPending = planningPending;
+  planningPending = false;
+  if (!msg || (msg.debatePhase !== "planning" && msg.mateCreation !== true)) return;
+  var history = Array.isArray(msg.messages) ? msg.messages : [];
+  for (var i = history.length - 1; i >= 0; i--) {
+    if (history[i] && history[i].role === "question") {
+      planningPending = history[i].status === "answered" && (wasPending || msg.isProcessing === true);
+      if (planningPending && !wasPending) resetHomeDebateActivityAnnouncement("home-debate-activity-next");
+      return;
+    }
+  }
+}
+
+export function createHomeDebatePlanningPendingRow() {
+  return createHomeDebateActivityRow("Preparing the next question", "Clay is preparing the next question", "home-debate-activity-next");
+}
+
+export function requestHomeDebateComposerFocus() {
+  pendingComposerOpener = document.activeElement || document.body;
+}
+
+export function restoreHomeDebateComposerFocus(input) {
+  if (!pendingComposerOpener) return;
+  var opener = pendingComposerOpener;
+  if (!document.body || !document.body.classList.contains("home-active")) { pendingComposerOpener = null; return; }
+  if (!input || input.disabled) return;
+  pendingComposerOpener = null;
+  var active = document.activeElement;
+  if (active && active !== document.body && active !== opener && active.id !== "home-sidebar-expand") return;
+  input.focus({ preventScroll: true });
+}
+
+function mateName(mateId) {
+  var mates = store.get('cachedMatesList') || [];
+  for (var i = 0; i < mates.length; i++) {
+    if (!mates[i] || mates[i].id !== mateId) continue;
+    var profile = mates[i].profile || {};
+    return profile.displayName || mates[i].displayName || mates[i].name || "Mate";
+  }
+  return "Mate";
+}
+
+function textElement(tag, className, text) {
+  var element = document.createElement(tag);
+  element.className = className;
+  element.textContent = text || "";
+  return element;
+}
+
+export function createHomeDebateProposalCard(message, respond) {
+  var proposal = message.proposal || {};
+  var card = document.createElement("section");
+  card.className = "debate-brief-card home-debate-proposal";
+  card.dataset.proposalId = proposal.proposalId || "";
+  card.setAttribute("aria-label", "Debate proposal: " + (proposal.topic || "Untitled debate"));
+  var header = textElement("div", "debate-brief-card-header", "Debate proposal");
+  card.appendChild(header);
+  var body = document.createElement("div");
+  body.className = "debate-brief-card-body";
+  body.appendChild(textElement("h3", "debate-brief-topic", proposal.topic || "Untitled debate"));
+  if (proposal.context) body.appendChild(textElement("p", "debate-brief-context", proposal.context));
+  var panelists = Array.isArray(proposal.panelists) ? proposal.panelists : [];
+  if (panelists.length) {
+    body.appendChild(textElement("div", "debate-brief-panelists-label", "Panel"));
+    var list = document.createElement("div");
+    list.className = "debate-brief-panelists";
+    for (var i = 0; i < panelists.length; i++) {
+      var name = mateName(panelists[i].mateId);
+      var detail = panelists[i].role ? name + " — " + panelists[i].role : name;
+      list.appendChild(textElement("div", "debate-brief-panelist", detail));
+    }
+    body.appendChild(list);
+  }
+  appendDebateModelSelectors(body, proposal, message.status === "submitting" || message.status === "started" || message.status === "cancelled");
+  card.appendChild(body);
+  if (message.error) {
+    var error = textElement("p", "home-debate-proposal-error", message.error);
+    error.setAttribute("role", "alert");
+    card.appendChild(error);
+  }
+  var actions = document.createElement("div");
+  actions.className = "debate-brief-actions";
+  if (message.status === "started" || message.status === "cancelled") {
+    var label = message.status === "started" ? "Debate started" : "Proposal cancelled";
+    var resolved = textElement("span", "debate-brief-resolved-label", label);
+    resolved.setAttribute("role", "status");
+    actions.appendChild(resolved);
+  } else {
+    var start = textElement("button", "debate-brief-start-btn", message.status === "submitting" ? "Starting…" : "Start debate");
+    start.type = "button";
+    start.disabled = message.status === "submitting";
+    start.setAttribute("aria-label", "Approve and start this debate");
+    start.addEventListener("click", function () {
+      var overrides = collectDebateModelOverrides(card);
+      if (overrides.length) respond(message, "start", start, null, overrides);
+      else respond(message, "start", start);
+    });
+    var cancel = textElement("button", "debate-brief-cancel-btn", "Cancel");
+    cancel.type = "button";
+    cancel.disabled = message.status === "submitting";
+    cancel.setAttribute("aria-label", "Cancel this debate proposal");
+    cancel.addEventListener("click", function () { respond(message, "cancel", cancel); });
+    actions.appendChild(start);
+    actions.appendChild(cancel);
+  }
+  card.appendChild(actions);
+  refreshIcons();
+  return card;
+}
+
+export function createHomeDebateQuestionCard(message, respond) {
+  var question = Array.isArray(message.questions) && message.questions.length ? message.questions[0] : {};
+  var card = document.createElement("section");
+  card.className = "home-debate-question";
+  card.dataset.toolId = message.toolId || "";
+  card.setAttribute("aria-busy", message.status === "submitting" ? "true" : "false");
+  var isMateCreation = message.flow === "mate_creation";
+  card.setAttribute("aria-label", (isMateCreation ? "Mate creation interview question: " : "Debate planning question: ") + (question.question || "Question"));
+  if (question.header) card.appendChild(textElement("div", "home-debate-question-header", question.header));
+  card.appendChild(textElement("h3", "home-debate-question-text", question.question || "Clay has a question."));
+  var form = document.createElement("div");
+  form.className = "home-debate-question-form";
+  var options = Array.isArray(question.options) ? question.options.slice(0, 6) : [];
+  var freeform = options.length === 0;
+  var selected = "";
+  var buttons = [];
+  for (var i = 0; i < options.length; i++) {
+    (function (option) {
+      var button = document.createElement("button");
+      button.type = "button";
+      button.className = "home-debate-question-option";
+      button.setAttribute("aria-pressed", "false");
+      button.appendChild(textElement("span", "home-debate-question-option-label", option.label || "Option"));
+      if (option.description) button.appendChild(textElement("span", "home-debate-question-option-description", option.description));
+      button.addEventListener("click", function () {
+        if (message.status !== "pending") return;
+        selected = option.label || "";
+        answerControl.value = "";
+        for (var j = 0; j < buttons.length; j++) buttons[j].setAttribute("aria-pressed", buttons[j] === button ? "true" : "false");
+        submit.disabled = !selected;
+      });
+      buttons.push(button);
+      form.appendChild(button);
+    })(options[i]);
+  }
+  var answerLabel = textElement("label", freeform ? "home-debate-question-freeform-label" : "home-debate-question-other-label", freeform ? "Your answer" : "Other");
+  var answerControl = document.createElement(freeform ? "textarea" : "input");
+  if (!freeform) answerControl.type = "text";
+  if (freeform) answerControl.rows = 3;
+  answerControl.className = freeform ? "home-debate-question-freeform" : "home-debate-question-other";
+  answerControl.placeholder = freeform ? (isMateCreation ? "Describe what you want in your own words" : "Describe the topic in your own words") : "Type another answer";
+  answerLabel.appendChild(answerControl);
+  form.appendChild(answerLabel);
+  var submit = textElement("button", "home-debate-question-submit", message.status === "submitting" ? "Submitting…" : "Submit answer");
+  submit.type = "button";
+  submit.disabled = message.status !== "pending" || !selected;
+  function submitAnswer() {
+    var answer = answerControl.value.trim() || selected;
+    if (!answer || message.status !== "pending") return;
+    respond(message, "answer", submit, { 0: answer });
+  }
+  answerControl.addEventListener("input", function () {
+    selected = answerControl.value.trim();
+    for (var j = 0; j < buttons.length; j++) buttons[j].setAttribute("aria-pressed", "false");
+    submit.disabled = !selected;
+  });
+  answerControl.addEventListener("keydown", function (event) {
+    var submitKey = freeform ? (event.key === "Enter" && (event.ctrlKey || event.metaKey)) : (event.key === "Enter" && !event.shiftKey);
+    if (submitKey) { event.preventDefault(); submitAnswer(); }
+  });
+  submit.addEventListener("click", submitAnswer);
+  form.appendChild(submit);
+  if (message.error && message.status !== "expired") {
+    var retryError = textElement("p", "home-debate-question-error", message.error);
+    retryError.setAttribute("role", "alert");
+    retryError.tabIndex = -1;
+    form.appendChild(retryError);
+  }
+  if (message.status === "answered") {
+    form.textContent = "";
+    var answer = message.answers && message.answers[0] ? String(message.answers[0]) : "Answered";
+    var status = textElement("p", "home-debate-question-status", "Answered: " + answer);
+    status.setAttribute("role", "status");
+    status.tabIndex = -1;
+    form.appendChild(status);
+  } else if (message.status === "expired") {
+    form.textContent = "";
+    var expired = textElement("p", "home-debate-question-error", message.error || "This question expired. Ask Clay to repeat it.");
+    expired.setAttribute("role", "alert");
+    expired.tabIndex = -1;
+    form.appendChild(expired);
+  }
+  card.appendChild(form);
+  return card;
+}
+
+export function createHomeDebateTranscriptCard(message, respond) {
+  return message.role === "question" ? createHomeDebateQuestionCard(message, respond) : createHomeDebateProposalCard(message, respond);
+}
+
+export function markHomeDebateProposalSubmitting(message, opener) {
+  message.status = "submitting";
+  var card = opener;
+  while (card && (" " + card.className + " ").indexOf(" home-debate-proposal ") === -1) card = card.parentNode;
+  function disableControls(node) {
+    if (!node) return;
+    if (node.tagName === "BUTTON" || node.tagName === "SELECT") node.disabled = true;
+    var children = node.children || [];
+    for (var i = 0; i < children.length; i++) disableControls(children[i]);
+  }
+  disableControls(card);
+  if (opener && opener.textContent === "Start debate") opener.textContent = "Starting…";
+}
+
+export function restoreHomeDebateProposalFocus(proposalId) {
+  if (!proposalId || !document.querySelectorAll) return;
+  var cards = document.querySelectorAll(".home-debate-proposal");
+  for (var i = 0; i < cards.length; i++) {
+    if (!cards[i].dataset || cards[i].dataset.proposalId !== proposalId) continue;
+    var target = cards[i].querySelector('[role="status"]') || cards[i].querySelector(".debate-brief-start-btn");
+    if (!target) return;
+    target.tabIndex = -1;
+    target.focus({ preventScroll: true });
+    return;
+  }
+}
+
+export function normalizeHomeTranscript(raw) {
+  return (raw || []).filter(function (message) {
+    return message && ((message.role === "assignment" && message.assignment) || ((message.role === "proposal" || message.role === "mate_proposal") && message.proposal) || (message.role === "question" && message.toolId) || ["debate_header", "debate_turn", "debate_user", "debate_tool_decision"].indexOf(message.role) !== -1 || ((message.role === "user" || message.role === "assistant") && typeof message.text === "string"));
+  }).map(function (message) {
+    if (message.role === "assignment") return { role: "assignment", assignment: message.assignment, requestId: message.requestId || null };
+    if (message.role === "proposal") return { role: "proposal", proposal: message.proposal, status: message.status || "pending", error: message.error || "" };
+    if (message.role === "mate_proposal") return { role: "mate_proposal", proposal: message.proposal, status: message.status || "pending", mateId: message.mateId || null, error: message.error || "" };
+    if (message.role === "question") return { role: "question", flow: message.flow || "debate", toolId: message.toolId, questions: message.questions || [], status: message.status || "pending", answers: message.answers || null, error: message.error || "" };
+    if (["debate_header", "debate_turn", "debate_user", "debate_tool_decision"].indexOf(message.role) !== -1) return Object.assign({}, message);
+    return { role: message.role, text: message.text, ts: message.ts || 0 };
+  });
+}
+
+export function applyHomeDebateQuestion(messages, msg) {
+  if (!msg || !msg.toolId) return messages;
+  for (var i = 0; i < messages.length; i++) if (messages[i].role === "question" && messages[i].toolId === msg.toolId) return messages;
+  return messages.concat([{ role: "question", flow: msg.type === "home_mate_creation_question" ? "mate_creation" : "debate", toolId: msg.toolId, questions: msg.questions || [], status: "pending", error: "" }]);
+}
+
+export function resolveHomeDebateQuestion(messages, msg) {
+  for (var i = 0; i < messages.length; i++) {
+    if (messages[i].role !== "question" || messages[i].toolId !== msg.toolId) continue;
+    messages[i] = Object.assign({}, messages[i], { status: msg.status === "answered" ? "answered" : "expired", answers: msg.answers || null, error: msg.error || "" });
+  }
+  return messages;
+}
+
+export function failHomeDebateQuestion(messages, msg) {
+  for (var i = messages.length - 1; i >= 0; i--) {
+    if (messages[i].role !== "question" || (messages[i].status !== "pending" && messages[i].status !== "submitting")) continue;
+    messages[i] = Object.assign({}, messages[i], { status: "pending", error: msg.text || "The answer could not be submitted. Try again." });
+    break;
+  }
+  return messages;
+}
+
+export function hasPendingHomeDebateQuestion(messages) {
+  for (var i = 0; i < messages.length; i++) if (messages[i].role === "question" && (messages[i].status === "pending" || messages[i].status === "submitting")) return true;
+  return false;
+}
+
+export function markHomeDebateQuestionSubmitting(message, opener) {
+  message.status = "submitting";
+  if (!planningPending) resetHomeDebateActivityAnnouncement("home-debate-activity-next");
+  planningPending = true;
+  var form = opener && opener.parentNode;
+  function disableControls(node) {
+    if (!node) return;
+    if (node.tagName === "BUTTON" || node.tagName === "INPUT" || node.tagName === "TEXTAREA") node.disabled = true;
+    var children = node.children || [];
+    for (var i = 0; i < children.length; i++) disableControls(children[i]);
+  }
+  disableControls(form);
+  if (opener) opener.textContent = "Submitting…";
+}
+
+export function createHomeDebateResponder(sendMessage, getContext, onChange) {
+  return function respond(message, action, opener, answers, modelOverrides) {
+    if (!message || message.status === "submitting") return;
+    var payload = message.role === "question" ? { type: message.flow === "mate_creation" ? "home_mate_creation_question_response" : "home_debate_question_response", toolId: message.toolId, answers: answers || {} } : { type: "home_debate_proposal_response", proposalId: message.proposal.proposalId, action: action, modelOverrides: Array.isArray(modelOverrides) ? modelOverrides : [] };
+    Object.assign(payload, getContext());
+    if (!sendMessage(payload)) return;
+    if (message.role === "question") markHomeDebateQuestionSubmitting(message, opener);
+    else markHomeDebateProposalSubmitting(message, opener);
+    if (typeof onChange === "function") onChange(message);
+  };
+}
+
+export function restoreHomeDebateQuestionFocus(toolId) {
+  if (!toolId || !document.querySelectorAll) return;
+  var cards = document.querySelectorAll(".home-debate-question");
+  for (var i = 0; i < cards.length; i++) {
+    if (!cards[i].dataset || cards[i].dataset.toolId !== toolId) continue;
+    var target = cards[i].querySelector('[role="status"]') || cards[i].querySelector('[role="alert"]') || cards[i];
+    target.tabIndex = -1;
+    target.focus({ preventScroll: true });
+    return;
+  }
+}
+
+export function applyHomeDebateProposal(messages, msg) {
+  var id = msg && msg.proposal && msg.proposal.proposalId;
+  if (!id) return messages;
+  for (var i = 0; i < messages.length; i++) {
+    if (messages[i].role === "proposal" && messages[i].proposal.proposalId === id) return messages;
+  }
+  return messages.concat([{ role: "proposal", proposal: msg.proposal, status: "pending" }]);
+}
+
+export function resolveHomeDebateProposal(messages, msg) {
+  for (var i = 0; i < messages.length; i++) {
+    if (messages[i].role !== "proposal" || messages[i].proposal.proposalId !== msg.proposalId) continue;
+    messages[i] = Object.assign({}, messages[i], { status: msg.action === "start" ? "started" : (msg.action === "cancel" ? "cancelled" : "pending"), error: msg.action === "error" ? (msg.error || "The debate could not be started.") : "" });
+  }
+  return messages;
+}

package/lib/public/modules/home-debates-archive.js

@@ -0,0 +1,279 @@
+// Full-stage Home archive for durable debate planning and live sessions.
+
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { refreshIcons } from './icons.js';
+import { openHomeConversation, openHomeMateAction } from './home-mate-chat.js';
+import { setHomeSubSurface, isHomeDebatesSurface } from './home-sub-surface.js';
+
+var initialized = false;
+var requestSequence = 0;
+var topicSubmitting = false;
+
+function element(id) {
+  return document.getElementById(id);
+}
+
+function focusHeading() {
+  var heading = element("home-debates-title");
+  if (!heading || heading.getClientRects && !heading.getClientRects().length) return;
+  heading.focus({ preventScroll: true });
+}
+
+function queueHeadingFocus() {
+  if (typeof requestAnimationFrame !== "function") {
+    focusHeading();
+    return;
+  }
+  requestAnimationFrame(function () { requestAnimationFrame(focusHeading); });
+}
+
+function phaseLabel(phase) {
+  if (phase === "live") return "Live";
+  if (phase === "ended") return "Ended";
+  if (phase === "interrupted") return "Interrupted";
+  return "Planning";
+}
+
+function formatLabel(format) {
+  if (!format) return "";
+  return format.replace(/[_-]+/g, " ").replace(/\b\w/g, function (letter) { return letter.toUpperCase(); });
+}
+
+function dateLabel(value) {
+  if (typeof value !== "number" || !isFinite(value) || value <= 0) return "Date unavailable";
+  try { return new Intl.DateTimeFormat(undefined, { dateStyle: "medium" }).format(new Date(value)); }
+  catch (error) { return new Date(value).toLocaleDateString(); }
+}
+
+function participantsLabel(participants) {
+  var source = Array.isArray(participants) ? participants : [];
+  var names = [];
+  for (var i = 0; i < source.length; i++) if (source[i] && source[i].name) names.push(source[i].name);
+  return names.length ? names.join(", ") : "Panel not selected";
+}
+
+function setArchiveOwnership(open) {
+  var archive = element("home-debates-archive");
+  var chat = element("home-mate-chat");
+  var messages = element("home-mate-chat-messages");
+  var composer = document.querySelector(".home-mate-chat-composer-frame");
+  var suggestions = element("home-mate-chat-suggestions");
+  var debateButton = element("home-sidebar-debate");
+  if (archive) archive.hidden = !open;
+  if (chat) chat.classList.toggle("home-debates-open", open);
+  if (messages) messages.hidden = open;
+  if (composer) composer.hidden = open;
+  if (suggestions) suggestions.hidden = open;
+  if (debateButton) {
+    debateButton.setAttribute("aria-pressed", String(open));
+    if (open) debateButton.setAttribute("aria-current", "page");
+    else debateButton.removeAttribute("aria-current");
+  }
+}
+
+function emptyState(title, detail, retry) {
+  var wrap = document.createElement("div");
+  wrap.className = "home-debates-empty";
+  var icon = document.createElement("i");
+  icon.dataset.lucide = retry ? "circle-alert" : "messages-square";
+  icon.setAttribute("aria-hidden", "true");
+  var heading = document.createElement("h2");
+  heading.textContent = title;
+  var copy = document.createElement("p");
+  copy.textContent = detail;
+  wrap.appendChild(icon);
+  wrap.appendChild(heading);
+  wrap.appendChild(copy);
+  if (retry) {
+    var button = document.createElement("button");
+    button.type = "button";
+    button.className = "home-debates-retry";
+    button.textContent = "Retry";
+    button.addEventListener("click", requestHomeDebates);
+    wrap.appendChild(button);
+  }
+  return wrap;
+}
+
+function createDebateRow(debate) {
+  var row = document.createElement("button");
+  row.type = "button";
+  row.className = "home-debates-row";
+  var phase = phaseLabel(debate.phase);
+  var date = dateLabel(debate.lastActivity);
+  var participants = participantsLabel(debate.participants);
+  row.setAttribute("aria-label", (debate.topic || debate.title || "Debate") + ", " + phase + ", " + participants + ", " + date);
+
+  var body = document.createElement("span");
+  body.className = "home-debates-row-body";
+  var title = document.createElement("span");
+  title.className = "home-debates-row-title";
+  title.textContent = debate.topic || debate.title || "Debate planning";
+  var panel = document.createElement("span");
+  panel.className = "home-debates-row-panel";
+  panel.textContent = participants;
+  body.appendChild(title);
+  body.appendChild(panel);
+
+  var meta = document.createElement("span");
+  meta.className = "home-debates-row-meta";
+  var state = document.createElement("span");
+  state.className = "home-debates-phase is-" + debate.phase;
+  state.textContent = phase;
+  var details = document.createElement("span");
+  var detailParts = [];
+  if (debate.format) detailParts.push(formatLabel(debate.format));
+  if (debate.round) detailParts.push("Round " + debate.round);
+  detailParts.push(date);
+  details.textContent = detailParts.join(" · ");
+  meta.appendChild(state);
+  meta.appendChild(details);
+
+  var arrow = document.createElement("i");
+  arrow.dataset.lucide = "chevron-right";
+  arrow.setAttribute("aria-hidden", "true");
+  row.appendChild(body);
+  row.appendChild(meta);
+  row.appendChild(arrow);
+  row.addEventListener("click", function () {
+    setHomeSubSurface("chat");
+    openHomeConversation(debate.mateId, debate.sessionId);
+  });
+  return row;
+}
+
+export function renderHomeDebatesArchive() {
+  var open = isHomeDebatesSurface();
+  setArchiveOwnership(open);
+  if (!open) return;
+  var list = element("home-debates-list");
+  var summary = element("home-debates-summary");
+  var topicForm = element("home-debates-topic-form");
+  if (topicForm) topicForm.hidden = !store.get('homeDebateTopicFormOpen');
+  if (!list || !summary) return;
+  list.innerHTML = "";
+  var status = store.get('homeDebatesStatus') || "idle";
+  var debates = store.get('homeDebates') || [];
+  if (status === "loading" || status === "idle") {
+    summary.textContent = "Loading debates…";
+    list.appendChild(emptyState("Gathering your debates", "Planning sessions and completed debates will appear here.", false));
+  } else if (status === "error") {
+    summary.textContent = "Debates could not be loaded.";
+    list.appendChild(emptyState("Could not load debates", store.get('homeDebatesError') || "Try again when the connection is available.", true));
+  } else if (!debates.length) {
+    summary.textContent = "No debates yet";
+    list.appendChild(emptyState("Your debate archive is empty", "Start a debate when you want Clay to assemble a panel.", false));
+  } else {
+    summary.textContent = debates.length + (debates.length === 1 ? " debate" : " debates");
+    for (var i = 0; i < debates.length; i++) list.appendChild(createDebateRow(debates[i]));
+  }
+  refreshIcons();
+}
+
+export function requestHomeDebates() {
+  var ws = getWs();
+  requestSequence += 1;
+  var requestId = "home-debates:" + requestSequence;
+  if (!ws || ws.readyState !== 1) {
+    store.set({ homeDebatesStatus: "error", homeDebatesRequestId: requestId, homeDebatesError: "Reconnect to load your debates." });
+    renderHomeDebatesArchive();
+    return false;
+  }
+  store.set({ homeDebatesStatus: "loading", homeDebatesRequestId: requestId, homeDebatesError: "" });
+  renderHomeDebatesArchive();
+  ws.send(JSON.stringify({ type: "home_debates_list", requestId: requestId }));
+  return true;
+}
+
+export function openHomeDebatesArchive() {
+  setHomeSubSurface("debates");
+  renderHomeDebatesArchive();
+  requestHomeDebates();
+  queueHeadingFocus();
+}
+
+export function restoreHomeDebatesArchive() {
+  if (!isHomeDebatesSurface()) return false;
+  renderHomeDebatesArchive();
+  requestHomeDebates();
+  return true;
+}
+
+export function handleHomeDebatesState(msg) {
+  if (!msg) return;
+  var activeRequestId = store.get('homeDebatesRequestId');
+  if (msg.requestId && activeRequestId && msg.requestId !== activeRequestId) return;
+  var debates = Array.isArray(msg.debates) ? msg.debates : [];
+  store.set({
+    homeDebatesStatus: msg.status === "error" || msg.error ? "error" : "ready",
+    homeDebates: debates,
+    homeDebatesError: msg.error || "",
+  });
+  renderHomeDebatesArchive();
+}
+
+function focusTopic() {
+  var input = element("home-debates-topic");
+  if (input) input.focus({ preventScroll: true });
+}
+
+function startNewDebate() {
+  var status = element("home-debates-topic-status");
+  if (status) status.textContent = "Press Ctrl or Command + Enter to start.";
+  store.set({ homeDebateTopicFormOpen: true });
+  renderHomeDebatesArchive();
+  if (typeof requestAnimationFrame === "function") requestAnimationFrame(focusTopic);
+  else focusTopic();
+}
+
+function cancelNewDebate() {
+  if (topicSubmitting) return;
+  store.set({ homeDebateTopicFormOpen: false });
+  renderHomeDebatesArchive();
+  var button = element("home-debates-new");
+  if (button) button.focus({ preventScroll: true });
+}
+
+function submitNewDebate(event) {
+  if (event && typeof event.preventDefault === "function") event.preventDefault();
+  if (topicSubmitting) return;
+  var input = element("home-debates-topic");
+  var status = element("home-debates-topic-status");
+  var topic = input && typeof input.value === "string" ? input.value.trim() : "";
+  if (!topic) {
+    if (status) status.textContent = "Enter a topic to start the debate.";
+    if (input) input.focus({ preventScroll: true });
+    return;
+  }
+  topicSubmitting = true;
+  if (status) status.textContent = "Starting debate…";
+  var started = openHomeMateAction("debate", topic.slice(0, 1000));
+  topicSubmitting = false;
+  if (!started) {
+    if (status) status.textContent = "Clay is not available right now. Try again.";
+    return;
+  }
+  if (input) input.value = "";
+  store.set({ homeDebateTopicFormOpen: false });
+}
+
+function handleTopicKeydown(event) {
+  if (!event || event.isComposing || event.keyCode === 229) return;
+  if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) submitNewDebate(event);
+}
+
+export function initHomeDebatesArchive() {
+  if (initialized) return;
+  initialized = true;
+  element("home-debates-new").addEventListener("click", startNewDebate);
+  element("home-debates-topic-form").addEventListener("submit", submitNewDebate);
+  element("home-debates-topic-cancel").addEventListener("click", cancelNewDebate);
+  element("home-debates-topic").addEventListener("keydown", handleTopicKeydown);
+  store.subscribe(function (state, previous) {
+    if (state.homeSubSurface !== previous.homeSubSurface) renderHomeDebatesArchive();
+    if (state.homeDebateTopicFormOpen !== previous.homeDebateTopicFormOpen) renderHomeDebatesArchive();
+    if (state.connected !== previous.connected && state.connected && state.homeSubSurface === "debates") requestHomeDebates();
+  });
+  renderHomeDebatesArchive();
+}