clay-server 5.0.2-beta.1 → 5.1.0-beta.2

package/lib/public/modules/mate-management.js

@@ -2,7 +2,8 @@
 
 import { getWs } from './ws-ref.js';
 import { showMateProfilePopover } from './profile.js';
-import { showConfirm } from './app-misc.js';
+import { showToast } from './utils.js';
+import { showConfirm, hideConfirm } from './app-misc.js';
 import { iconHtml, refreshIcons } from './icons.js';
 
 var mateMenu = null;
@@ -21,15 +22,58 @@ export function editMateProfile(anchorEl, mate) {
 
 export function confirmMateRemoval(anchorEl, mate, onRemoved) {
   if (!anchorEl || !mate || mate.primary) return;
-  showConfirm(
-    mate.builtinKey ? "Remove this mate? You can restore it from the home switcher." : "Delete this mate permanently?",
-    function () {
-      if (onRemoved) onRemoved();
-      send({ type: "mate_delete", mateId: mate.id });
-    },
-    mate.builtinKey ? "Remove" : "Delete",
-    true
-  );
+  var name = (mate.profile || {}).displayName || mate.name || "this Mate";
+  var modal = document.getElementById("confirm-modal");
+  var panel = modal.querySelector(".confirm-dialog");
+  var ok = document.getElementById("confirm-ok");
+  var cancel = document.getElementById("confirm-cancel");
+  var input;
+  function cleanup() {
+    modal.classList.remove("mate-delete-confirm");
+    panel.removeAttribute("role"); panel.removeAttribute("aria-modal");
+    panel.removeAttribute("aria-labelledby"); panel.removeAttribute("aria-describedby");
+    var field = modal.querySelector(".mate-delete-challenge"); if (field) field.remove();
+    ok.disabled = false;
+    document.removeEventListener("keydown", onKey, true);
+    if (anchorEl.isConnected) anchorEl.focus({preventScroll:true});
+  }
+  function onKey(event) {
+    if (event.key === "Escape") { event.preventDefault(); event.stopImmediatePropagation(); hideConfirm(); return; }
+    if (event.key !== "Tab") return;
+    var controls = ok.disabled ? [input,cancel] : [input,cancel,ok];
+    var index = controls.indexOf(document.activeElement);
+    event.preventDefault(); event.stopImmediatePropagation();
+    controls[(index + (event.shiftKey ? controls.length - 1 : 1)) % controls.length].focus();
+  }
+  showConfirm("", function () {
+    if (input.value !== "understand") { cleanup(); return; }
+    var ws = getWs();
+    if (!ws || ws.readyState !== 1) { cleanup(); showToast("Clay is offline. The Mate was not deleted.", "error"); return; }
+    try { ws.send(JSON.stringify({type:"mate_delete",mateId:mate.id})); }
+    catch (error) { cleanup(); showToast("Could not send the deletion request. Try again.", "error"); return; }
+    cleanup();
+    if (onRemoved) onRemoved(true);
+  }, mate.builtinKey ? "Remove permanently" : "Delete permanently", true, cleanup);
+  modal.classList.add("mate-delete-confirm");
+  panel.setAttribute("role","alertdialog"); panel.setAttribute("aria-modal","true");
+  panel.setAttribute("aria-labelledby","mate-delete-title"); panel.setAttribute("aria-describedby","mate-delete-warning");
+  var text = document.getElementById("confirm-text");
+  var title = document.createElement("h3"); title.id = "mate-delete-title"; title.textContent = "Delete " + name + "?";
+  var warning = document.createElement("p"); warning.id = "mate-delete-warning";
+  warning.textContent = "This permanently deletes the Mate and the data stored in its workspace, including its prompt and files. This cannot be undone.";
+  text.appendChild(title); text.appendChild(warning);
+  if (mate.builtinKey) {
+    var note = document.createElement("p"); note.textContent = "You can add this built-in Mate again, but its deleted data will not be restored."; text.appendChild(note);
+  }
+  var field = document.createElement("label"); field.className = "mate-delete-challenge";
+  field.textContent = 'Type understand to confirm permanent deletion.';
+  input = document.createElement("input"); input.type = "text"; input.autocomplete = "off"; input.spellcheck = false;
+  input.setAttribute("autocapitalize","none"); input.setAttribute("aria-label","Type understand to confirm permanent deletion");
+  field.appendChild(input); text.after(field);
+  ok.disabled = true;
+  input.addEventListener("input",function () { ok.disabled = input.value !== "understand"; });
+  document.addEventListener("keydown",onKey,true);
+  input.focus();
 }
 
 export function closeMateManagementMenu() {

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

@@ -394,6 +394,16 @@ export function handleMateSearchResults(msg) {
 
 var expandedDebateGroups = new Set();
 
+function appendMateSessionTitleLine(el, textSpan) {
+  var processingDot = textSpan.querySelector('.session-processing');
+  if (processingDot) processingDot.remove();
+  var titleLine = document.createElement('span');
+  titleLine.className = 'mate-session-title-line';
+  titleLine.appendChild(textSpan);
+  if (processingDot) titleLine.appendChild(processingDot);
+  el.appendChild(titleLine);
+}
+
 export function renderMateSessionList(sessions) {
   if (sessions) cachedSessions = sessions;
   if (!listEl) return;
@@ -529,7 +539,7 @@ function renderDebateGroup(children, groupKey) {
   textHtml += '<span class="mate-debate-name">' + escapeHtml(debateName) + '</span>';
   textHtml += '<span class="mate-debate-count">' + children.length + '</span>';
   textSpan.innerHTML = textHtml;
-  el.appendChild(textSpan);
+  appendMateSessionTitleLine(el, textSpan);
 
   // Click row -> switch to latest session
   el.addEventListener("click", (function (id) {

package/lib/public/modules/mate-workspace-color.js

@@ -0,0 +1,33 @@
+// Theme-specific surfaces keep user color choices separate from text and actions.
+export var MATE_WORKSPACE_COLORS = [
+  { id: 'mint', label: 'Mint', pigment: '#07e5a3' },
+  { id: 'rose', label: 'Rose', pigment: '#ec82ac' },
+  { id: 'plum', label: 'Plum', pigment: '#b780b3' },
+  { id: 'coral', label: 'Coral', pigment: '#ff7479' },
+  { id: 'peach', label: 'Peach', pigment: '#ed986b' },
+  { id: 'gold', label: 'Gold', pigment: '#e0b45b' },
+  { id: 'sky', label: 'Sky', pigment: '#69b6d4' },
+  { id: 'indigo', label: 'Indigo', pigment: '#8582df' },
+  { id: 'stone', label: 'Stone', pigment: '#a5a59e' }
+];
+function mix(pigment, base, amount) {
+  var channels = [1, 3, 5].map(function (offset) {
+    var a = parseInt(pigment.slice(offset, offset + 2), 16);
+    var b = parseInt(base.slice(offset, offset + 2), 16);
+    return Math.round(a * amount + b * (1 - amount)).toString(16).padStart(2, '0');
+  });
+  return '#' + channels.join('');
+}
+export function workspaceColor(mate) {
+  var id = mate && mate.builtinKey !== 'clay' && !mate.primary ? mate.workspaceColor : 'mint';
+  var color = MATE_WORKSPACE_COLORS.find(function (item) { return item.id === id; }) || MATE_WORKSPACE_COLORS[0];
+  return Object.assign({}, color, {
+    light: mix(color.pigment, '#f2f2ef', color.id === 'mint' ? 0.03 : 0.08),
+    dark: mix(color.pigment, '#232322', color.id === 'mint' ? 0.02 : 0.10)
+  });
+}
+export function applyWorkspaceColor(mate) {
+  var color = workspaceColor(mate);
+  document.body.style.setProperty('--mate-surround-light', color.light);
+  document.body.style.setProperty('--mate-surround-dark', color.dark);
+}

package/lib/public/modules/mention.js

@@ -3,6 +3,7 @@ import { renderMarkdown, highlightCodeBlocks } from './markdown.js';
 import { escapeHtml, copyToClipboard } from './utils.js';
 import { iconHtml, refreshIcons } from './icons.js';
 import { store } from './store.js';
+import { getProjectAssistantPlaceholder } from './project-chat-identity.js';
 
 var ctx;
 
@@ -311,10 +312,6 @@ function color_mix_lighten(r, g, b, amount) {
     .map(function (v) { return v.toString(16).padStart(2, "0"); }).join("");
 }
 
-// Saved textarea placeholder so we can restore it when the chip is removed.
-// Set on first chip show, cleared on chip removal.
-var savedInputPlaceholder = null;
-
 function showInputMentionChip(name, color, avatarSrc) {
   removeInputMentionChip();
   var textColor = ensureChipContrast(color);
@@ -333,13 +330,9 @@ function showInputMentionChip(name, color, avatarSrc) {
     inputRow.insertBefore(chip, textareaWrap);
   }
 
-  // Swap the textarea placeholder so the user sees "Ask @{name}..." instead of
-  // the session-vendor placeholder ("Message Claude Code...") while a mention
-  // is queued. Save the original once so re-shows don't clobber it.
+  // Swap the textarea placeholder so the user sees "Ask @{name}..." while a
+  // mention is queued. Restoration is handled only while this prompt owns it.
   if (ctx && ctx.inputEl) {
-    if (savedInputPlaceholder === null) {
-      savedInputPlaceholder = ctx.inputEl.placeholder || "";
-    }
     ctx.inputEl.placeholder = "Ask @" + name + "...";
   }
 
@@ -353,9 +346,8 @@ function showInputMentionChip(name, color, avatarSrc) {
 function removeInputMentionChip() {
   var existing = document.getElementById("input-mention-chip");
   if (existing) existing.remove();
-  if (ctx && ctx.inputEl && savedInputPlaceholder !== null) {
-    ctx.inputEl.placeholder = savedInputPlaceholder;
-    savedInputPlaceholder = null;
+  if (existing && ctx && ctx.inputEl && !ctx.inputEl.disabled && /^Ask @/.test(ctx.inputEl.placeholder || "")) {
+    ctx.inputEl.placeholder = getProjectAssistantPlaceholder(store.snap(), store.get('currentVendor'));
   }
 }
 

package/lib/public/modules/profile.js

@@ -84,6 +84,44 @@ export function applyToIsland() {
       ctaEl.classList.add('hidden');
     }
   }
+  document.dispatchEvent(new CustomEvent('clay:profile-updated'));
+}
+
+export function updateProfileName(name) {
+  profile.name = String(name || '').trim();
+  applyToIsland();
+  debouncedSave();
+}
+
+export function usePixelAvatar() {
+  profile.avatarCustom = '';
+  applyToIsland();
+  debouncedSave();
+}
+
+export function regenerateProfileAvatar() {
+  profile.avatarCustom = '';
+  profile.avatarSeed = 'clay-' + Date.now();
+  applyToIsland();
+  debouncedSave();
+}
+
+export function uploadAvatarBlob(blob) {
+  if (!blob) return Promise.reject(new Error('Missing avatar image.'));
+  return blob.arrayBuffer().then(function(ab) {
+    var buf = new Uint8Array(ab);
+    return fetch('/api/avatar', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/octet-stream' },
+      body: buf,
+    });
+  }).then(function(r) { return r.json(); }).then(function(data) {
+    if (!data.ok || !data.avatar) throw new Error(data.error || 'Avatar upload failed.');
+    profile.avatarCustom = data.avatar;
+    applyToIsland();
+    debouncedSave();
+    return data;
+  });
 }
 
 // --- Avatar position picker ---
@@ -128,6 +166,8 @@ export function showAvatarPositioner(img, objectUrl, onDone) {
 
   var closeBtn = document.createElement('button');
   closeBtn.className = 'avatar-positioner-close';
+  closeBtn.type = 'button';
+  closeBtn.setAttribute('aria-label', 'Close avatar crop editor');
   closeBtn.innerHTML = '×';
   container.appendChild(closeBtn);
 
@@ -239,12 +279,21 @@ export function showAvatarPositioner(img, objectUrl, onDone) {
   }, { passive: false });
 
   function cleanup(revoke) {
+    document.removeEventListener('keydown', onOverlayKeydown);
     overlay.remove();
     if (revoke) URL.revokeObjectURL(objectUrl);
   }
 
+  function onOverlayKeydown(event) {
+    if (event.key !== 'Escape') return;
+    event.preventDefault();
+    event.stopPropagation();
+    cleanup(true);
+  }
+
   closeBtn.addEventListener('click', function() { cleanup(true); });
   cancelBtn.addEventListener('click', function() { cleanup(true); });
+  document.addEventListener('keydown', onOverlayKeydown);
 
   doneBtn.addEventListener('click', function() {
     // Render cropped area to canvas
@@ -269,7 +318,7 @@ export function showAvatarPositioner(img, objectUrl, onDone) {
 }
 
 // --- Popover ---
-function showPopover() {
+export function openProfileEditor() {
   if (popoverEl) {
     hidePopover();
     return;
@@ -286,7 +335,7 @@ function showPopover() {
 
   // Banner + close
   html += '<div class="profile-banner">';
-  html += '<button class="profile-close-btn">&times;</button>';
+  html += '<button class="profile-close-btn" type="button" aria-label="Close profile editor">&times;</button>';
   html += '</div>';
 
   // Avatar row (overlapping banner)
@@ -485,22 +534,6 @@ export function initProfile(_ctx) {
   var island = document.getElementById('user-island');
   if (!island) return;
 
-  var profileArea = island.querySelector('.user-island-profile');
-  if (profileArea) {
-    profileArea.addEventListener('click', function(e) {
-      e.stopPropagation();
-      showPopover();
-    });
-  }
-
-  var ctaEl = island.querySelector('.user-island-cta');
-  if (ctaEl) {
-    ctaEl.addEventListener('click', function(e) {
-      e.stopPropagation();
-      showPopover();
-    });
-  }
-
   fetchProfile().then(function(data) {
     if (data.name !== undefined) profile.name = data.name;
     if (data.lang) profile.lang = data.lang;

package/lib/public/modules/project-chat-identity.js

@@ -0,0 +1,79 @@
+// Session-bound assistant identity for ordinary project and Mate transcripts.
+
+import { store } from './store.js';
+import { mateAvatarUrl } from './avatar.js';
+import { VENDOR_AVATARS, VENDOR_NAMES } from './chat-render-runtime.js';
+
+function mateById(state, mateId) {
+  var mates = state.cachedMatesList || [];
+  for (var i = 0; i < mates.length; i++) {
+    if (mates[i] && mates[i].id === mateId) return mates[i];
+  }
+  return null;
+}
+
+function mateName(mate, fallback) {
+  var profile = mate && mate.profile ? mate.profile : {};
+  return profile.displayName || (mate && (mate.displayName || mate.name)) || fallback || 'Mate';
+}
+
+export function resolveProjectAssistantIdentity(state, vendor) {
+  state = state || store.snap();
+  var dmTarget = state.dmMode && state.dmTargetUser && state.dmTargetUser.isMate ? state.dmTargetUser : null;
+  var mateId = dmTarget ? dmTarget.id : state.activeSessionMateId;
+  if (mateId) {
+    var mate = mateById(state, mateId) || dmTarget;
+    var fallbackName = dmTarget && dmTarget.displayName || state.activeSessionMateName || 'Mate';
+    var avatarMate = mate || { id: mateId, name: fallbackName, profile: { displayName: fallbackName } };
+    return {
+      kind: 'mate',
+      mateId: mateId,
+      name: mateName(mate, fallbackName),
+      avatarUrl: mateAvatarUrl(avatarMate, 34),
+    };
+  }
+  var vendorId = vendor || state.currentVendor || 'claude';
+  return {
+    kind: 'provider',
+    mateId: '',
+    name: VENDOR_NAMES[vendorId] || VENDOR_NAMES.claude,
+    avatarUrl: VENDOR_AVATARS[vendorId] || VENDOR_AVATARS.claude,
+  };
+}
+
+export function getProjectAssistantPlaceholder(state, vendor) {
+  return 'Message ' + resolveProjectAssistantIdentity(state, vendor).name + '...';
+}
+
+export function applyProjectAssistantIdentity(element, identity) {
+  if (!element || !identity) return element;
+  var avatar = element.querySelector('.dm-bubble-avatar');
+  var name = element.querySelector('.dm-bubble-name');
+  if (avatar) avatar.src = identity.avatarUrl;
+  if (name) name.textContent = identity.name;
+  if (identity.kind === 'mate') {
+    element.dataset.sessionMateId = identity.mateId;
+    element.dataset.sessionMateName = identity.name;
+  } else {
+    delete element.dataset.sessionMateId;
+    delete element.dataset.sessionMateName;
+  }
+  return element;
+}
+
+export function refreshProjectAssistantIdentities(root) {
+  var target = root || document;
+  var elements = target.querySelectorAll('[data-session-mate-id]');
+  var state = store.snap();
+  for (var i = 0; i < elements.length; i++) {
+    var mateId = elements[i].dataset.sessionMateId;
+    var mate = mateById(state, mateId);
+    if (!mate) continue;
+    applyProjectAssistantIdentity(elements[i], {
+      kind: 'mate',
+      mateId: mateId,
+      name: mateName(mate, elements[i].dataset.sessionMateName || 'Mate'),
+      avatarUrl: mateAvatarUrl(mate, 34),
+    });
+  }
+}

package/lib/public/modules/project-debate-planning-workspace.js

@@ -0,0 +1,250 @@
+// Project-chat adapter for Clay's existing server-owned debate setup flow.
+
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { addToMessages, scrollToBottom } from './chat-render-runtime.js';
+import { openMateWorkspace } from './project-mate-navigation.js';
+import { createHomeDebateQuestionCard, createHomeDebateProposalCard, normalizeHomeTranscript, applyHomeDebateProposal, resolveHomeDebateProposal, failHomeDebateQuestion } from './home-debate-planning.js';
+import { refreshIcons, iconHtml } from './icons.js';
+
+var root = null;
+var sequence = 0;
+var liveReplaySessionId = null;
+var suppressLiveSetupReplay = false;
+
+function send(message) {
+  var ws = getWs();
+  if (!ws || ws.readyState !== 1) return false;
+  ws.send(JSON.stringify(message));
+  return true;
+}
+
+function clayMate() {
+  var mates = store.get('cachedMatesList') || [];
+  for (var i = 0; i < mates.length; i++) if (mates[i] && mates[i].builtinKey === 'clay') return mates[i];
+  return null;
+}
+
+function requestId() { sequence += 1; return 'project-debate-planning-' + Date.now() + '-' + sequence; }
+function same(left, right) { return left != null && right != null && String(left) === String(right); }
+
+function context() {
+  return { mateId: store.get('projectDebatePlanningMateId'), sessionId: store.get('projectDebatePlanningSessionId'), requestId: store.get('projectDebatePlanningRequestId') };
+}
+
+function messages() { return store.get('projectDebatePlanningMessages') || []; }
+function setMessages(value) { store.set({ projectDebatePlanningMessages: value }); }
+
+function retryPlanning() {
+  var state = store.snap();
+  store.set({ projectDebatePlanningError: '', projectDebatePlanningRetryable: false });
+  if (!state.projectDebatePlanningSessionId) {
+    store.set({ projectDebatePlanningPendingStart: true });
+    maybeStart();
+    return;
+  }
+  var id = requestId();
+  if (!send({ type: 'home_mate_debate_plan', mateId: state.projectDebatePlanningMateId, sessionId: state.projectDebatePlanningSessionId, topic: state.projectDebatePlanningTopic, requestId: id })) {
+    store.set({ projectDebatePlanningError: 'Reconnect to retry debate setup.', projectDebatePlanningRetryable: true });
+    render();
+    return;
+  }
+  store.set({ projectDebatePlanningRequestId: id, projectDebatePlanningAwaitingHistory: true });
+}
+
+function ensureRoot() {
+  if (root && root.isConnected) return root;
+  root = document.createElement('section');
+  root.className = 'project-debate-planning-transcript home-mate-chat-transcript home-chat-bubble-layout';
+  root.setAttribute('aria-label', 'Debate setup');
+  addToMessages(root);
+  return root;
+}
+
+function respondToQuestion(message, action, opener, answers) {
+  if (!message || message.status === 'submitting') return;
+  if (!send(Object.assign({ type: 'home_debate_question_response', toolId: message.toolId, answers: answers || {} }, context()))) return;
+  setMessages(messages().map(function (item) { return item === message ? Object.assign({}, item, { status: 'submitting' }) : item; }));
+  render();
+}
+
+function respondToProposal(message, action, opener, answers, modelOverrides) {
+  if (!message || message.status === 'submitting') return;
+  if (!send(Object.assign({ type: 'home_debate_proposal_response', proposalId: message.proposal.proposalId, action: action === 'start' ? 'start' : 'cancel', modelOverrides: modelOverrides || [] }, context()))) return;
+  setMessages(messages().map(function (item) { return item === message ? Object.assign({}, item, { status: 'submitting' }) : item; }));
+  render();
+}
+
+function render() {
+  var container = ensureRoot();
+  container.innerHTML = '';
+  var intro = document.createElement('header');
+  intro.className = 'project-mate-creation-intro';
+  intro.innerHTML = iconHtml('messages-square') + '<span>Plan a debate with Clay</span>';
+  container.appendChild(intro);
+  var list = messages();
+  for (var i = 0; i < list.length; i++) {
+    if (list[i].role === 'question') container.appendChild(createHomeDebateQuestionCard(list[i], respondToQuestion));
+    if (list[i].role === 'proposal') container.appendChild(createHomeDebateProposalCard(list[i], respondToProposal));
+  }
+  var errorText = store.get('projectDebatePlanningError');
+  if (errorText) {
+    var error = document.createElement('section');
+    error.className = 'project-debate-planning-error';
+    error.setAttribute('role', 'alert');
+    var copy = document.createElement('p');
+    copy.textContent = errorText;
+    error.appendChild(copy);
+    if (store.get('projectDebatePlanningRetryable')) {
+      var retry = document.createElement('button');
+      retry.type = 'button';
+      retry.textContent = 'Retry debate setup';
+      retry.addEventListener('click', retryPlanning);
+      error.appendChild(retry);
+    }
+    container.appendChild(error);
+  }
+  scrollToBottom();
+  refreshIcons();
+}
+
+function clear() {
+  root = null;
+  store.set({ projectDebatePlanningActive: false, projectDebatePlanningMateId: null, projectDebatePlanningSessionId: null, projectDebatePlanningLocalId: null, projectDebatePlanningRequestId: null, projectDebatePlanningPendingStart: false, projectDebatePlanningAwaitingHistory: false, projectDebatePlanningAwaitingMateList: false, projectDebatePlanningHistoryReady: false, projectDebatePlanningTopic: '', projectDebatePlanningMessages: [], projectDebatePlanningError: '', projectDebatePlanningRetryable: false });
+}
+
+function maybeStart() {
+  var state = store.snap();
+  if (!state.projectDebatePlanningPendingStart || !state.connected || state.activeProjectSlug !== 'mate-' + state.projectDebatePlanningMateId) return;
+  var id = requestId();
+  if (!send({ type: 'home_mate_debate_plan', mateId: state.projectDebatePlanningMateId, topic: state.projectDebatePlanningTopic, requestId: id })) return;
+  store.set({ projectDebatePlanningPendingStart: false, projectDebatePlanningAwaitingHistory: true, projectDebatePlanningRequestId: id });
+}
+
+export function startProjectDebatePlanning(topic) {
+  var clay = clayMate();
+  if (!clay) {
+    store.set({ projectDebatePlanningError: 'Clay is unavailable. Refresh and try again.', projectDebatePlanningRetryable: false });
+    return false;
+  }
+  root = null;
+  store.set({ projectDebatePlanningActive: true, projectDebatePlanningMateId: clay.id, projectDebatePlanningSessionId: null, projectDebatePlanningLocalId: null, projectDebatePlanningRequestId: null, projectDebatePlanningPendingStart: true, projectDebatePlanningAwaitingHistory: false, projectDebatePlanningAwaitingMateList: false, projectDebatePlanningHistoryReady: false, projectDebatePlanningTopic: typeof topic === 'string' ? topic.trim().slice(0, 1000) : '', projectDebatePlanningMessages: [], projectDebatePlanningError: '', projectDebatePlanningRetryable: false });
+  openMateWorkspace(clay.id);
+  maybeStart();
+  return true;
+}
+
+function exact(msg, allowUnbound) {
+  var state = store.snap();
+  if (!state.projectDebatePlanningActive || !same(msg.mateId, state.projectDebatePlanningMateId) || !same(msg.requestId, state.projectDebatePlanningRequestId)) return false;
+  if (!state.projectDebatePlanningSessionId) return allowUnbound === true;
+  return same(msg.sessionId, state.projectDebatePlanningSessionId);
+}
+
+function openHistory(msg) {
+  if (!exact(msg, store.get('projectDebatePlanningAwaitingHistory') && !store.get('projectDebatePlanningSessionId'))) return false;
+  store.set({ projectDebatePlanningSessionId: msg.sessionId, projectDebatePlanningLocalId: typeof msg.localId === 'number' ? msg.localId : store.get('projectDebatePlanningLocalId'), projectDebatePlanningAwaitingHistory: false });
+  if (typeof msg.localId === 'number' && String(store.get('activeSessionId')) !== String(msg.localId)) {
+    send({ type: 'switch_session', id: msg.localId });
+    return true;
+  }
+  setMessages(normalizeHomeTranscript(msg.messages || []).filter(function (message) { return message.role === 'question' || message.role === 'proposal'; }));
+  render();
+  return true;
+}
+
+function resume() {
+  var state = store.snap();
+  if (!state.projectDebatePlanningActive || !state.projectDebatePlanningMateId || !state.projectDebatePlanningSessionId) return;
+  var id = requestId();
+  if (!send({ type: 'home_mate_session_open', mateId: state.projectDebatePlanningMateId, sessionId: state.projectDebatePlanningSessionId, requestId: id })) return;
+  store.set({ projectDebatePlanningRequestId: id, projectDebatePlanningAwaitingHistory: true });
+}
+
+function activateRestored(msg, clay) {
+  root = null;
+  store.set({ projectDebatePlanningActive: true, projectDebatePlanningMateId: clay.id, projectDebatePlanningSessionId: msg.cliSessionId || 'local:' + msg.id, projectDebatePlanningLocalId: msg.id, projectDebatePlanningRequestId: requestId(), projectDebatePlanningPendingStart: false, projectDebatePlanningAwaitingHistory: false, projectDebatePlanningAwaitingMateList: false, projectDebatePlanningHistoryReady: false, projectDebatePlanningTopic: '', projectDebatePlanningMessages: [] });
+}
+
+function restoreAfterMateList() {
+  var state = store.snap();
+  if (!state.projectDebatePlanningAwaitingMateList) return;
+  var clay = clayMate();
+  if (!clay || state.currentSlug !== 'mate-' + clay.id || state.projectDebatePlanningLocalId == null) return;
+  var historyReady = state.projectDebatePlanningHistoryReady;
+  activateRestored({ id: state.projectDebatePlanningLocalId, cliSessionId: state.projectDebatePlanningSessionId && state.projectDebatePlanningSessionId.indexOf('local:') !== 0 ? state.projectDebatePlanningSessionId : null }, clay);
+  if (historyReady) resume();
+}
+
+export function handleProjectDebatePlanningMessage(msg) {
+  if (msg.type === 'session_switched') {
+    if (msg.debatePlanning === true && msg.debatePhase === 'live') {
+      clear();
+      liveReplaySessionId = msg.id;
+      suppressLiveSetupReplay = true;
+      return false;
+    }
+    liveReplaySessionId = null;
+    suppressLiveSetupReplay = false;
+    var clay = clayMate();
+    var state = store.snap();
+    var starting = msg.debatePlanning === true && state.projectDebatePlanningActive && state.projectDebatePlanningAwaitingHistory && !state.projectDebatePlanningSessionId && state.currentSlug === 'mate-' + state.projectDebatePlanningMateId;
+    if (starting) store.set({ projectDebatePlanningSessionId: msg.cliSessionId || 'local:' + msg.id, projectDebatePlanningLocalId: msg.id, projectDebatePlanningMessages: [] });
+    else if (msg.debatePlanning === true && clay && state.currentSlug === 'mate-' + clay.id) activateRestored(msg, clay);
+    else if (msg.debatePlanning === true && !clay && /^mate-/.test(state.currentSlug || '')) store.set({ projectDebatePlanningActive: false, projectDebatePlanningAwaitingMateList: true, projectDebatePlanningHistoryReady: false, projectDebatePlanningLocalId: msg.id, projectDebatePlanningSessionId: msg.cliSessionId || 'local:' + msg.id, projectDebatePlanningMessages: [] });
+    else if (!(state.projectDebatePlanningActive && (state.projectDebatePlanningPendingStart || state.projectDebatePlanningAwaitingHistory) && state.currentSlug === 'mate-' + state.projectDebatePlanningMateId && !state.projectDebatePlanningSessionId)) clear();
+    return false;
+  }
+  if (msg.type === 'home_mate_session_identity') {
+    var identityState = store.snap();
+    if (!identityState.projectDebatePlanningActive || !same(msg.mateId, identityState.projectDebatePlanningMateId) || !same(msg.requestId, identityState.projectDebatePlanningRequestId) || !same(msg.previousSessionId, identityState.projectDebatePlanningSessionId) || !msg.sessionId) return false;
+    store.set({ projectDebatePlanningSessionId: msg.sessionId });
+    return true;
+  }
+  if (msg.type === 'home_debate_event' && msg.eventType === 'debate_started') {
+    suppressLiveSetupReplay = false;
+    if (store.get('projectDebatePlanningActive')) clear();
+    return false;
+  }
+  if (msg.type === 'debate_started' && suppressLiveSetupReplay && same(store.get('activeSessionId'), liveReplaySessionId)) {
+    suppressLiveSetupReplay = false;
+    return false;
+  }
+  if (suppressLiveSetupReplay && same(store.get('activeSessionId'), liveReplaySessionId)
+      && ((msg.type === 'tool_executing' && msg.name === 'AskUserQuestion') || msg.type === 'ask_user_answered'
+        || msg.type === 'debate_proposal' || msg.type === 'debate_proposal_resolved' || msg.type === 'delta'
+        || msg.type === 'result' || msg.type === 'done' || msg.type === 'error')) return true;
+  if (msg.type === 'history_done') {
+    if (store.get('projectDebatePlanningAwaitingMateList')) store.set({ projectDebatePlanningHistoryReady: true });
+    else if (!store.get('projectDebatePlanningAwaitingHistory')) resume();
+    return false;
+  }
+  var raw = (msg.type === 'tool_executing' && msg.name === 'AskUserQuestion') || msg.type === 'debate_proposal' || msg.type === 'debate_proposal_resolved' || msg.type === 'ask_user_answered' || msg.type === 'delta' || msg.type === 'result' || msg.type === 'done' || msg.type === 'error' || msg.type === 'home_mate_delta' || msg.type === 'home_mate_done';
+  if (raw && store.get('projectDebatePlanningAwaitingMateList')) return same(store.get('activeSessionId'), store.get('projectDebatePlanningLocalId'));
+  if (!store.get('projectDebatePlanningActive')) return false;
+  if (msg.type === 'home_mate_history' && msg.debatePlanning === true) return openHistory(msg);
+  if (raw) return same(store.get('activeSessionId'), store.get('projectDebatePlanningLocalId'));
+  if (!exact(msg, msg.type === 'home_mate_error' && store.get('projectDebatePlanningAwaitingHistory'))) return false;
+  if (msg.type === 'home_debate_question') {
+    setMessages(messages().concat([{ role: 'question', flow: 'debate', toolId: msg.toolId, questions: msg.questions || [], status: 'pending', error: '' }])); render(); return true;
+  }
+  if (msg.type === 'home_debate_question_resolved') {
+    setMessages(messages().map(function (item) { return item.role === 'question' && item.toolId === msg.toolId ? Object.assign({}, item, { status: msg.status === 'answered' ? 'answered' : 'expired', answers: msg.answers || null, error: msg.error || '' }) : item; })); render(); return true;
+  }
+  if (msg.type === 'home_debate_proposal') { setMessages(applyHomeDebateProposal(messages(), msg)); render(); return true; }
+  if (msg.type === 'home_debate_proposal_resolved') { setMessages(resolveHomeDebateProposal(messages(), msg)); render(); return true; }
+  if (msg.type === 'home_mate_error') {
+    if (/^question_/.test(msg.code || '')) setMessages(failHomeDebateQuestion(messages(), msg));
+    else store.set({ projectDebatePlanningError: msg.text || 'Debate setup could not continue.', projectDebatePlanningRetryable: true, projectDebatePlanningAwaitingHistory: false });
+    render();
+    return true;
+  }
+  return false;
+}
+
+export function initProjectDebatePlanningWorkspace() {
+  store.subscribe(function (state, previous) {
+    if (state.projectDebatePlanningPendingStart !== previous.projectDebatePlanningPendingStart || state.connected !== previous.connected || state.activeProjectSlug !== previous.activeProjectSlug) maybeStart();
+    if (state.cachedMatesList !== previous.cachedMatesList) restoreAfterMateList();
+  });
+}