clay-server 5.1.0-beta.1 → 5.1.0-beta.3

package/lib/public/modules/profile.js

@@ -1,3 +1,4 @@
+import { setChatLayout } from './theme.js';
 // User profile module — profile popovers for people and Mates
 // Stores profile server-side in ~/.clay/profile.json
 // Generated identities use deterministic local pixel identicons.
@@ -7,7 +8,6 @@ import { avatarUrl, mateAvatarUrl, mateMarkUrl, userAvatarSeed } from './avatar.
 import { store } from './store.js';
 import { applyTerminalFont } from './terminal-prefs.js';
 
-var ctx;
 var profile = { name: '', lang: 'en-US', avatarStyle: 'imprint', avatarSeed: '', avatarColor: '#5857fc', avatarCustom: '' };
 var profileUsername = '';
 var popoverEl = null;
@@ -84,6 +84,54 @@ export function applyToIsland() {
       ctaEl.classList.add('hidden');
     }
   }
+  document.dispatchEvent(new CustomEvent('clay:profile-updated'));
+}
+
+export async function saveProfileUpdates(updates) {
+  var next = Object.assign({}, profile, updates);
+  var response = await fetch('/api/profile', {method:'PUT',headers:{'Content-Type':'application/json'},body:JSON.stringify(next)});
+  var result = await response.json();
+  if (!response.ok || result.error) throw new Error(result.error || 'Could not save your profile. Your draft is retained.');
+  profile = next;
+  applyToIsland();
+  return result;
+}
+
+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 +176,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 +289,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 +328,7 @@ export function showAvatarPositioner(img, objectUrl, onDone) {
 }
 
 // --- Popover ---
-function showPopover() {
+export function openProfileEditor() {
   if (popoverEl) {
     hidePopover();
     return;
@@ -286,7 +345,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)
@@ -479,28 +538,11 @@ function escapeAttr(str) {
 }
 
 // --- Init ---
-export function initProfile(_ctx) {
-  ctx = _ctx;
+export function initProfile() {
 
   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;
@@ -523,13 +565,13 @@ export function initProfile(_ctx) {
     // when the user opened the Settings modal (user-settings.js's
     // populateAccount), so a hard refresh would drop persisted picks back
     // to defaults until the modal was visited.
+    if(data.chatLayout)setChatLayout(data.chatLayout);
     if (data.terminalFont && typeof data.terminalFont === "object") {
       applyTerminalFont(data.terminalFont.family, data.terminalFont.size);
     }
 
-    // Apply the project-only Mate DM shortcut preference at boot. Home and
-    // the rest of the Mate capability surface remain available.
-    var matesOn = data.matesEnabled === true;
+    // Keep project Mate DM shortcuts available for legacy profiles too.
+    var matesOn = true;
     store.set({ projectMateDmsEnabled: matesOn });
     if (document.body) document.body.classList.toggle('project-mate-dms-disabled', !matesOn);
   }).catch(function(err) {

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();
+  });
+}

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

@@ -0,0 +1,185 @@
+// Adapt project events to the shared Home debate presentation.
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { getMessagesEl } from './dom-refs.js';
+import { addToMessages, scrollToBottom } from './chat-render-runtime.js';
+import { isMateWorkspace } from './project-mate-navigation.js';
+import { applyHomeDebateEvent, createHomeDebateLiveCard } from './home-debate-live.js';
+import { createHomeDebateProposalCard, applyHomeDebateProposal, resolveHomeDebateProposal } from './home-debate-planning.js';
+import { createDebateControls } from './debate-controls.js';
+import { renderAssistantBubbleText, finalizeAssistantBubble, disposeChatBubbleTree } from './chat-bubble-renderer.js';
+
+var transcriptEl = null;
+var prependEl = null;
+var controls = createDebateControls({
+  slotId: 'project-debate-controls',
+  composerId: 'input-area',
+  send: function (action, data, sessionId) {
+    var ws = getWs();
+    if (!ws || ws.readyState !== 1 || String(store.get('activeSessionId')) !== sessionId) return false;
+    ws.send(JSON.stringify({ type: 'project_debate_control', sessionId: store.get('activeSessionId'), action: action, text: data.text || '', response: data.response || null }));
+    return true;
+  }
+});
+
+function stateKey() {
+  return store.get('projectDebatePrepending') ? 'projectDebatePrependMessages' : 'projectDebateMessages';
+}
+
+function ensureTranscript() {
+  var prepending = store.get('projectDebatePrepending');
+  var root = prepending ? prependEl : transcriptEl;
+  if (!root || !root.isConnected) {
+    root = document.createElement('section');
+    root.className = 'project-debate-transcript home-mate-chat-transcript home-chat-bubble-layout';
+    root.setAttribute('aria-label', 'Debate transcript');
+    addToMessages(root);
+    if (prepending) prependEl = root;
+    else transcriptEl = root;
+  }
+  return root;
+}
+
+function renderControls() {
+  var slot = document.getElementById('project-debate-controls');
+  var composer = document.getElementById('input-area');
+  if (!slot && composer) {
+    slot = document.createElement('div');
+    slot.id = 'project-debate-controls';
+    slot.className = 'home-debate-controls-slot project-debate-controls';
+    slot.hidden = true;
+    composer.parentNode.insertBefore(slot, composer);
+  }
+  controls.render(store.get('projectDebateMessages') || [], String(store.get('activeSessionId') || ''));
+}
+
+function respondToProposal(message, action, opener, answers, modelOverrides) {
+  var ws = getWs();
+  if (!ws || ws.readyState !== 1 || message.status === 'submitting') return;
+  ws.send(JSON.stringify({ type: 'debate_proposal_response', proposalId: message.proposal.proposalId, sessionId: store.get('activeSessionId'), action: action, modelOverrides: modelOverrides || [] }));
+  var messages = (store.get('projectDebateMessages') || []).map(function (item) {
+    return item === message ? Object.assign({}, item, { status: 'submitting' }) : item;
+  });
+  store.set({ projectDebateMessages: messages });
+  renderMessages(messages);
+}
+
+function renderMessages(messages) {
+  var root = ensureTranscript();
+  messages.forEach(function (message, index) {
+    var existing = root.children[index];
+    if (existing && existing._debateMessage === message) return;
+    if (existing && message.role === 'debate_turn' && existing.classList.contains('home-debate-live-turn')) {
+      var activity = existing.querySelector('.home-debate-live-activity');
+      if (message.status === 'done') {
+        if (activity) activity.remove();
+        finalizeAssistantBubble(existing, message.text || '', !store.get('replayingHistory'));
+      } else {
+        if (activity) {
+          var label = message.activity || (message.text ? 'Speaking' : 'Preparing');
+          activity.firstChild.textContent = label;
+          activity.setAttribute('aria-label', (message.mateName || 'Mate') + ' is ' + label.toLowerCase());
+        }
+        renderAssistantBubbleText(existing, message.text || '', false);
+      }
+      existing._debateMessage = message;
+      return;
+    }
+    var card = message.role === 'proposal'
+      ? createHomeDebateProposalCard(message, respondToProposal)
+      : createHomeDebateLiveCard(message, message.status === 'done');
+    card._debateMessage = message;
+    if (existing) { disposeChatBubbleTree(existing); existing.replaceWith(card); }
+    else root.appendChild(card);
+  });
+}
+
+export function resetProjectDebateWorkspace() {
+  store.set({ projectDebateMessages: [], projectDebatePrependMessages: [], projectDebatePrepending: false });
+  transcriptEl = null;
+  prependEl = null;
+  controls.render([], null);
+}
+
+export function beginProjectDebatePrepend() {
+  prependEl = null;
+  store.set({ projectDebatePrepending: true, projectDebatePrependMessages: [] });
+}
+
+export function endProjectDebatePrepend() {
+  prependEl = null;
+  store.set({ projectDebatePrepending: false, projectDebatePrependMessages: [] });
+}
+
+export function handleProjectDebateMessage(msg) {
+  if (!isMateWorkspace(store.snap())) return false;
+  if (msg.type === 'project_debate_control_result') {
+    if (String(msg.sessionId) !== String(store.get('activeSessionId'))) return true;
+    if (!msg.ok) {
+      controls.render([], null);
+      renderControls();
+      var slot = document.getElementById('project-debate-controls');
+      var error = document.createElement('p');
+      error.className = 'project-debate-error';
+      error.setAttribute('role', 'alert');
+      error.textContent = msg.error || 'The debate action could not be completed.';
+      if (slot) slot.appendChild(error);
+    }
+    return true;
+  }
+  if (msg.type === 'history_done') {
+    renderControls();
+    var ws = getWs();
+    if (ws && ws.readyState === 1 && (store.get('projectDebateMessages') || []).length) {
+      ws.send(JSON.stringify({ type: 'project_debate_state', sessionId: store.get('activeSessionId') }));
+    }
+    return false;
+  }
+  if (msg.type === 'project_debate_state') {
+    if (String(msg.sessionId) !== String(store.get('activeSessionId')) || !msg.header) return true;
+    var restored = (store.get('projectDebateMessages') || []).slice();
+    var headerIndex = -1;
+    restored.forEach(function (item, index) { if (item.role === 'debate_header') headerIndex = index; });
+    if (headerIndex === -1) restored.unshift(msg.header);
+    else restored[headerIndex] = msg.header;
+    if (msg.header.phase !== 'live') restored = restored.map(function (item) {
+      return item.role === 'debate_turn' && item.status === 'active' ? Object.assign({}, item, { status: 'done', activity: '' }) : item;
+    });
+    store.set({ projectDebateMessages: restored });
+    renderMessages(restored);
+    renderControls();
+    return true;
+  }
+  if (msg.type === 'debate_preparing') {
+    var root = ensureTranscript();
+    var preparation = document.createElement('p');
+    preparation.className = 'debate-preparing-indicator home-debate-live-status';
+    preparation.setAttribute('role', 'status');
+    preparation.textContent = (msg.moderatorName || 'The moderator') + ' is preparing the debate…';
+    root.appendChild(preparation);
+    return true;
+  }
+  if (msg.type === 'tool_executing' && msg.name && msg.name.indexOf('propose_debate') !== -1) return true;
+  var types = ['debate_started', 'debate_turn', 'debate_activity', 'debate_stream', 'debate_turn_done', 'debate_tool_decision', 'debate_stop_requested', 'debate_stop_cancelled', 'debate_hand_raised', 'debate_conclude_confirm', 'debate_user_floor', 'debate_user_floor_done', 'debate_comment_injected', 'debate_user_resume', 'debate_resumed', 'debate_ended', 'debate_proposal', 'debate_proposal_resolved'];
+  if (types.indexOf(msg.type) === -1) return false;
+  var key = stateKey();
+  var messages = store.get(key) || [];
+  if (msg.type === 'debate_tool_decision') messages = messages.map(function (item) {
+    return item.role === 'debate_tool_decision' ? Object.assign({}, item, { entries: (item.entries || []).slice() }) : item;
+  });
+  if (msg.type === 'debate_proposal') messages = applyHomeDebateProposal(messages, msg);
+  else if (msg.type === 'debate_proposal_resolved') messages = resolveHomeDebateProposal(messages, msg);
+  else messages = applyHomeDebateEvent(messages, Object.assign({}, msg, { eventType: msg.type, speakerMateId: msg.mateId }));
+  if (msg.type === 'debate_ended') messages = messages.map(function (item) {
+    return item.role === 'debate_turn' && item.status === 'active' ? Object.assign({}, item, { status: 'done', activity: '' }) : item;
+  });
+  var patch = {};
+  patch[key] = messages;
+  store.set(patch);
+  var preparation = getMessagesEl().querySelector('.debate-preparing-indicator');
+  if (preparation) preparation.remove();
+  renderMessages(messages);
+  if (!store.get('projectDebatePrepending') && !store.get('replayingHistory')) renderControls();
+  scrollToBottom();
+  return true;
+}