clay-server 4.0.0-beta.8 → 4.0.0

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

@@ -0,0 +1,39 @@
+// home-chat-empty-state.js - The Home mate chat's empty conversation stage.
+
+import { getHomeMateShortBio } from './home-mate-selection.js';
+
+export function renderHomeChatEmptyState(messagesEl, suggestionsEl, mate, mateName, onSuggestion) {
+  var empty = document.createElement("div");
+  empty.className = "home-mate-chat-empty";
+  var brand = document.createElement("div");
+  brand.className = "home-mate-chat-brand";
+  var symbol = document.createElement("img");
+  symbol.src = "/clay-studio-symbol.png";
+  symbol.alt = "";
+  brand.appendChild(symbol);
+  var wordmark = document.createElement("span");
+  wordmark.className = "home-sidebar-brand-wordmark home-mate-chat-brand-wordmark";
+  wordmark.textContent = "Clay Studio";
+  brand.appendChild(wordmark);
+  empty.appendChild(brand);
+  var greeting = document.createElement("h2");
+  greeting.textContent = mate ? "What should we work on, " + mateName + "?" : "Getting Home ready...";
+  empty.appendChild(greeting);
+  var detail = document.createElement("p");
+  detail.textContent = mate ? getHomeMateShortBio(mate) : "Loading your Mate and recent conversation.";
+  empty.appendChild(detail);
+  messagesEl.appendChild(empty);
+  suggestionsEl.innerHTML = "";
+  if (!mate) return;
+  var suggestions = ["Make me a small tool"];
+  for (var i = 0; i < suggestions.length; i++) {
+    (function (suggestion) {
+      var chip = document.createElement("button");
+      chip.type = "button";
+      chip.className = "home-mate-chat-suggestion";
+      chip.textContent = suggestion;
+      chip.addEventListener("click", function () { onSuggestion(suggestion); });
+      suggestionsEl.appendChild(chip);
+    })(suggestions[i]);
+  }
+}

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

@@ -33,3 +33,12 @@ export function createHomeOrdinaryTyping(mate, mateName) {
   }
   return row;
 }
+
+// A Capsule engagement note: a quiet centered system line, not a speech
+// bubble, because no one typed it.
+export function createCapsuleTurnNote(message) {
+  var note = document.createElement("div");
+  note.className = "home-capsule-turn-note";
+  note.textContent = (message && message.text) || "";
+  return note;
+}

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

@@ -3,12 +3,14 @@
 import { store } from './store.js';
 import { iconHtml, refreshIcons } from './icons.js';
 import { getHomeSessionConversations, createHomeSessionActionsTrigger, disposeHomeSessionActionsMenu } from './home-session-actions.js';
+import { buildSessionHierarchy } from './session-hierarchy.js';
 
 var overlay = null;
 var searchInput = null;
 var listEl = null;
 var sheetOpener = null;
 var selectConversation = null;
+var hierarchyExpansion = new Map();
 
 function closeSheet(restoreFocus) {
   if (!overlay) return;
@@ -54,66 +56,118 @@ function handleKeydown(event) {
   }
 }
 
+function conversationMatches(conversation, query) {
+  if (!query) return true;
+  return conversation.title.toLowerCase().indexOf(query) !== -1 || conversation.mateName.toLowerCase().indexOf(query) !== -1;
+}
+
+function createSheetItem(conversation, worker) {
+  var item = document.createElement("div");
+  item.className = "home-conversations-sheet-item" + (worker ? " home-conversations-worker-item" : "");
+  var row = document.createElement("button");
+  row.type = "button";
+  row.className = "home-conversations-sheet-row";
+  var copy = document.createElement("span");
+  copy.className = "home-conversations-sheet-copy";
+  var title = document.createElement("span");
+  title.className = "home-conversations-sheet-row-title";
+  title.textContent = conversation.title;
+  copy.appendChild(title);
+  var mate = document.createElement("span");
+  mate.className = "home-conversations-sheet-row-mate";
+  mate.textContent = worker && conversation.workerGeneration ? conversation.mateName + " · Worker generation " + conversation.workerGeneration : conversation.mateName;
+  copy.appendChild(mate);
+  row.appendChild(copy);
+  if (conversation.isProcessing) {
+    var activity = document.createElement("span");
+    activity.className = "home-sidebar-processing";
+    activity.setAttribute("aria-label", "Processing");
+    row.appendChild(activity);
+  }
+  row.addEventListener("click", function () {
+    var onSelect = selectConversation;
+    closeSheet();
+    if (onSelect) onSelect(conversation.mateId, conversation.sessionId);
+  });
+  var active = conversation.mateId === store.get('homeChatMateId') && conversation.sessionId === store.get('homeChatSessionId');
+  if (active) {
+    item.classList.add("is-active");
+    row.setAttribute("aria-current", "page");
+  }
+  var detailsReturn = sheetOpener;
+  var actions = createHomeSessionActionsTrigger(conversation, {
+    detailsOpener: detailsReturn,
+    beforeOpenDetails: function () { closeSheet(false); },
+  });
+  item.appendChild(row);
+  item.appendChild(actions);
+  return item;
+}
+
+function createSheetHierarchy(root, query) {
+  if (!root.workers.length) return createSheetItem(root.driver, false);
+  var key = root.driver.hierarchyId;
+  var expanded = hierarchyExpansion.has(key) ? hierarchyExpansion.get(key) : !!query;
+  for (var ai = 0; ai < root.workers.length; ai++) {
+    if (root.workers[ai].mateId === store.get('homeChatMateId') && root.workers[ai].sessionId === store.get('homeChatSessionId')) expanded = true;
+  }
+  var wrapper = document.createElement("div");
+  wrapper.className = "home-conversations-driver-hierarchy";
+  var header = document.createElement("div");
+  header.className = "home-conversations-driver-header";
+  var toggle = document.createElement("button");
+  toggle.type = "button";
+  toggle.className = "home-conversations-driver-toggle";
+  var childrenId = "home-sheet-workers-" + String(key).replace(/[^a-zA-Z0-9_-]/g, "-");
+  toggle.setAttribute("aria-expanded", String(expanded));
+  toggle.setAttribute("aria-controls", childrenId);
+  toggle.setAttribute("aria-label", (expanded ? "Collapse" : "Expand") + " Workers for " + (root.driver.title || "Unavailable Driver"));
+  toggle.innerHTML = iconHtml("chevron-right");
+  if (!root.driver.sessionId) toggle.insertAdjacentHTML("beforeend", "<span>Unavailable Driver</span><span>" + root.workers.length + "</span>");
+  toggle.addEventListener("click", function () {
+    hierarchyExpansion.set(key, !expanded);
+    renderRows();
+  });
+  header.appendChild(toggle);
+  if (root.driver.sessionId) header.appendChild(createSheetItem(root.driver, false));
+  wrapper.appendChild(header);
+  var children = document.createElement("div");
+  children.id = childrenId;
+  children.className = "home-conversations-worker-children";
+  children.setAttribute("role", "group");
+  children.setAttribute("aria-label", "Workers for " + (root.driver.title || "Unavailable Driver"));
+  children.hidden = !expanded;
+  var driverMatched = root.driver.sessionId && conversationMatches(root.driver, query);
+  for (var i = 0; i < root.workers.length; i++) {
+    if (!query || driverMatched || conversationMatches(root.workers[i], query)) children.appendChild(createSheetItem(root.workers[i], true));
+  }
+  wrapper.appendChild(children);
+  return wrapper;
+}
+
 function renderRows() {
   if (!listEl) return;
   var query = searchInput ? searchInput.value.trim().toLowerCase() : "";
-  var all = getHomeSessionConversations().filter(function (conversation) {
-    if (!query) return true;
-    return conversation.title.toLowerCase().indexOf(query) !== -1 || conversation.mateName.toLowerCase().indexOf(query) !== -1;
+  var hierarchy = buildSessionHierarchy(getHomeSessionConversations());
+  var roots = hierarchy.roots.filter(function (root) {
+    if (conversationMatches(root.driver, query)) return true;
+    for (var i = 0; i < root.workers.length; i++) if (conversationMatches(root.workers[i], query)) return true;
+    return false;
   });
+  var orphans = hierarchy.orphans.filter(function (worker) { return conversationMatches(worker, query); });
   disposeHomeSessionActionsMenu();
   listEl.innerHTML = "";
-  if (!all.length) {
+  if (!roots.length && !orphans.length) {
     var empty = document.createElement("div");
     empty.className = "home-conversations-sheet-empty";
     empty.textContent = query ? "No chats match your search." : "No chats yet.";
     listEl.appendChild(empty);
     return;
   }
-  for (var i = 0; i < all.length; i++) {
-    (function (conversation) {
-      var item = document.createElement("div");
-      item.className = "home-conversations-sheet-item";
-      var row = document.createElement("button");
-      row.type = "button";
-      row.className = "home-conversations-sheet-row";
-      var copy = document.createElement("span");
-      copy.className = "home-conversations-sheet-copy";
-      var title = document.createElement("span");
-      title.className = "home-conversations-sheet-row-title";
-      title.textContent = conversation.title;
-      copy.appendChild(title);
-      var mate = document.createElement("span");
-      mate.className = "home-conversations-sheet-row-mate";
-      mate.textContent = conversation.mateName;
-      copy.appendChild(mate);
-      row.appendChild(copy);
-      if (conversation.isProcessing) {
-        var activity = document.createElement("span");
-        activity.className = "home-sidebar-processing";
-        activity.setAttribute("aria-label", "Processing");
-        row.appendChild(activity);
-      }
-      row.addEventListener("click", function () {
-        var onSelect = selectConversation;
-        closeSheet();
-        if (onSelect) onSelect(conversation.mateId, conversation.sessionId);
-      });
-      var active = conversation.mateId === store.get('homeChatMateId') && conversation.sessionId === store.get('homeChatSessionId');
-      if (active) {
-        item.classList.add("is-active");
-        row.setAttribute("aria-current", "page");
-      }
-      var detailsReturn = sheetOpener;
-      var actions = createHomeSessionActionsTrigger(conversation, {
-        detailsOpener: detailsReturn,
-        beforeOpenDetails: function () { closeSheet(false); },
-      });
-      item.appendChild(row);
-      item.appendChild(actions);
-      listEl.appendChild(item);
-    })(all[i]);
-  }
+  roots.sort(function (a, b) { return b.lastActivity - a.lastActivity; });
+  for (var i = 0; i < roots.length; i++) listEl.appendChild(createSheetHierarchy(roots[i], query));
+  if (orphans.length) listEl.appendChild(createSheetHierarchy({ driver: { hierarchyId: "orphan-sheet", title: "Unavailable Driver" }, workers: orphans }, query));
+  refreshIcons();
 }
 
 export function openHomeConversationsSheet(onSelect, opener) {

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

@@ -2,7 +2,7 @@
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { renderAssistantBubbleText, finalizeAssistantBubble, disposeChatBubbleTree } from './chat-bubble-renderer.js';
-import { createHomeOrdinaryBubble, createHomeOrdinaryTyping } from './home-chat-identity.js';
+import { createHomeOrdinaryBubble, createHomeOrdinaryTyping, createCapsuleTurnNote } from './home-chat-identity.js';
 import { openHomeMateSettings, closeHomeMateSettings } from './home-mate-settings.js';
 import { forgetHomeSession, rememberHomeMate, rememberHomeSession } from './home-surface.js';
 import { isOwnedHomeSessionMessage, resolveHomeSessionIdentity, appendHomeStreamText, finalizeHomeAssistant } from './home-chat-stream-state.js';
@@ -16,7 +16,8 @@ import { setHomeSubSurface } from './home-sub-surface.js';
 import { createWorkspaceAssignmentCard, applyHomeWorkspaceAssignment } from './workspace-assignment-card.js';
 import { markHomeChatActivity, followHomeChatNextRender, captureHomeChatScroll, restoreHomeChatScroll } from './home-chat-scroll.js';
 import { createHomeMateProposalCard, createHomeMateProposalResponder, applyHomeMateProposal, resolveHomeMateProposal, restoreHomeMateProposalFocus } from './home-mate-creation.js';
-import { findHomeMate, getHomeMateName, getHomeMateShortBio } from './home-mate-selection.js';
+import { findHomeMate, getHomeMateName } from './home-mate-selection.js';
+import { renderHomeChatEmptyState } from './home-chat-empty-state.js';
 var messages = [], streamingText = "", streaming = false, bound = false, animateSwitch = false;
 var chatEl = null, stageEl = null, messagesEl = null, suggestionsEl = null, inputEl = null, sendBtn = null;
 var sessionModelEl = null, sessionModelValueEl = null, sessionModelChooseEl = null, sessionRequestSequence = 0, activeSessionRequestId = null, mateCreationActive = false;
@@ -167,6 +168,7 @@ function ensureDom() {
 }
 function formatTime(timestamp) { var date = timestamp ? new Date(timestamp) : null; return date ? date.getHours().toString().padStart(2, "0") + ":" + date.getMinutes().toString().padStart(2, "0") : ""; }
 function appendMessage(message, mate, mateName, finalize) {
+  if (message.role === "capsule_turn") return createCapsuleTurnNote(message);
   if (message.role === "assignment") return createWorkspaceAssignmentCard(message.assignment, { home: true, context: { mateId: store.get('homeChatMateId'), sessionId: store.get('homeChatSessionId'), requestId: activeSessionRequestId } });
   if (message.role === "mate_proposal") return createHomeMateProposalCard(message, respondToMateProposal, function (created) { openHomeChat(created.mateId); });
   if (message.role === "proposal" || message.role === "question") return createHomeDebateTranscriptCard(message, respondToDebateTranscript);
@@ -182,39 +184,7 @@ function appendMessage(message, mate, mateName, finalize) {
   return row;
 }
 function renderEmptyState(mate, mateName) {
-  var empty = document.createElement("div");
-  empty.className = "home-mate-chat-empty";
-  var brand = document.createElement("div");
-  brand.className = "home-mate-chat-brand";
-  var symbol = document.createElement("img");
-  symbol.src = "/clay-studio-symbol.png";
-  symbol.alt = "";
-  brand.appendChild(symbol);
-  var wordmark = document.createElement("span");
-  wordmark.className = "home-sidebar-brand-wordmark home-mate-chat-brand-wordmark";
-  wordmark.textContent = "Clay Studio";
-  brand.appendChild(wordmark);
-  empty.appendChild(brand);
-  var greeting = document.createElement("h2");
-  greeting.textContent = mate ? "What should we work on, " + mateName + "?" : "Getting Home ready...";
-  empty.appendChild(greeting);
-  var detail = document.createElement("p");
-  detail.textContent = mate ? getHomeMateShortBio(mate) : "Loading your Mate and recent conversation.";
-  empty.appendChild(detail);
-  messagesEl.appendChild(empty);
-  suggestionsEl.innerHTML = "";
-  if (!mate) return;
-  var suggestions = ["Make me a small tool"];
-  for (var i = 0; i < suggestions.length; i++) {
-    (function (suggestion) {
-      var chip = document.createElement("button");
-      chip.type = "button";
-      chip.className = "home-mate-chat-suggestion";
-      chip.textContent = suggestion;
-      chip.addEventListener("click", function () { submitSuggestion(suggestion); });
-      suggestionsEl.appendChild(chip);
-    })(suggestions[i]);
-  }
+  renderHomeChatEmptyState(messagesEl, suggestionsEl, mate, mateName, submitSuggestion);
 }
 export function renderHomeChat() {
   if (!ensureDom()) return;
@@ -396,6 +366,16 @@ export function handleHomeWorkspaceAssignment(msg) {
   messages = applyHomeWorkspaceAssignment(messages, msg);
   renderHomeChat();
 }
+// A tool call ended the mate's spoken burst: seal what has streamed so far
+// into its own bubble; later deltas start a fresh one. Streaming stays on;
+// the turn is not over.
+export function handleHomeMateSegment(msg) {
+  if (!isCurrentSessionMessage(msg) || !streamingText) return;
+  messages.push({ role: "assistant", text: streamingText, ts: Date.now() });
+  streamingText = "";
+  renderHomeChat();
+}
+
 export function handleHomeMateDone(msg) {
   if (!isCurrentSessionMessage(msg)) return;
   markHomeChatActivity();

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

@@ -53,6 +53,12 @@ export function getHomeSessionConversations() {
         createdAt: typeof sessions[j].createdAt === "number" ? sessions[j].createdAt : 0,
         lastActivity: typeof sessions[j].lastActivity === "number" ? sessions[j].lastActivity : 0,
         isProcessing: sessions[j].isProcessing === true,
+        sessionRole: sessions[j].sessionRole === "worker" ? "worker" : "driver",
+        parentSessionId: safeText(sessions[j].parentSessionId, null),
+        parentAvailable: sessions[j].parentAvailable === true,
+        workerGeneration: typeof sessions[j].workerGeneration === "number" ? sessions[j].workerGeneration : null,
+        hierarchyId: mateIds[i] + ":" + sessions[j].id,
+        parentHierarchyId: sessions[j].parentSessionId ? mateIds[i] + ":" + sessions[j].parentSessionId : null,
       });
     }
   }

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

@@ -1,7 +1,98 @@
-// Complete, globally sorted Home chat archive rendered in the sidebar.
+// Complete Home chat archive rendered as provenance-preserving session trees.
 
 import { store } from './store.js';
+import { iconHtml, refreshIcons } from './icons.js';
 import { getHomeSessionConversations, createHomeSessionActionsTrigger, disposeHomeSessionActionsMenu } from './home-session-actions.js';
+import { buildSessionHierarchy } from './session-hierarchy.js';
+
+var expansion = new Map();
+
+function isExpanded(key, workers) {
+  if (expansion.has(key)) return expansion.get(key);
+  for (var i = 0; i < workers.length; i++) {
+    if (workers[i].mateId === store.get('homeChatMateId') && workers[i].sessionId === store.get('homeChatSessionId')) return true;
+  }
+  return false;
+}
+
+function createChatItem(chat, openConversation, worker) {
+  var item = document.createElement("div");
+  item.className = "home-sidebar-recent-item" + (worker ? " home-sidebar-worker-item" : "");
+  var row = document.createElement("button");
+  row.type = "button";
+  row.className = "home-sidebar-recent-row";
+  row.setAttribute("aria-label", chat.title + ", with " + chat.mateName);
+  if (chat.mateId === store.get('homeChatMateId') && chat.sessionId === store.get('homeChatSessionId')) {
+    item.classList.add("is-active");
+    row.setAttribute("aria-current", "page");
+  }
+  var copy = document.createElement("span");
+  copy.className = "home-sidebar-recent-copy";
+  var title = document.createElement("span");
+  title.className = "home-sidebar-recent-title";
+  title.textContent = chat.title;
+  var mate = document.createElement("span");
+  mate.className = "home-sidebar-recent-mate";
+  mate.textContent = worker && chat.workerGeneration ? chat.mateName + " · Worker generation " + chat.workerGeneration : chat.mateName;
+  copy.appendChild(title);
+  copy.appendChild(mate);
+  row.appendChild(copy);
+  if (chat.isProcessing) {
+    var activity = document.createElement("span");
+    activity.className = "home-sidebar-processing";
+    activity.setAttribute("aria-label", "Processing");
+    row.appendChild(activity);
+  }
+  row.addEventListener("click", function () {
+    if (typeof openConversation === "function") openConversation(chat.mateId, chat.sessionId);
+  });
+  item.appendChild(row);
+  item.appendChild(createHomeSessionActionsTrigger(chat));
+  return item;
+}
+
+function createHierarchy(root, openConversation) {
+  if (!root.workers.length) return createChatItem(root.driver, openConversation, false);
+  var wrapper = document.createElement("div");
+  wrapper.className = "home-sidebar-driver-hierarchy";
+  var key = root.driver.hierarchyId;
+  var expanded = isExpanded(key, root.workers);
+  var childrenId = "home-sidebar-workers-" + String(key).replace(/[^a-zA-Z0-9_-]/g, "-");
+  var header = document.createElement("div");
+  header.className = "home-sidebar-driver-header";
+  var toggle = document.createElement("button");
+  toggle.type = "button";
+  toggle.className = "home-sidebar-driver-toggle";
+  toggle.setAttribute("aria-expanded", String(expanded));
+  toggle.setAttribute("aria-controls", childrenId);
+  toggle.setAttribute("aria-label", (expanded ? "Collapse" : "Expand") + " Workers for " + (root.driver.title || "Unavailable Driver"));
+  toggle.innerHTML = iconHtml("chevron-right");
+  toggle.addEventListener("click", function () {
+    expansion.set(key, !expanded);
+    renderHomeSidebarChats(openConversation);
+  });
+  header.appendChild(toggle);
+  if (root.driver.sessionId) header.appendChild(createChatItem(root.driver, openConversation, false));
+  wrapper.appendChild(header);
+  var children = document.createElement("div");
+  children.id = childrenId;
+  children.className = "home-sidebar-worker-children";
+  children.setAttribute("role", "group");
+  children.setAttribute("aria-label", "Workers for " + (root.driver.title || "Unavailable Driver"));
+  children.hidden = !expanded;
+  for (var i = 0; i < root.workers.length; i++) children.appendChild(createChatItem(root.workers[i], openConversation, true));
+  wrapper.appendChild(children);
+  return wrapper;
+}
+
+function createOrphans(workers, openConversation) {
+  var wrapper = createHierarchy({ driver: { hierarchyId: "orphan-home", title: "Unavailable Driver" }, workers: workers }, openConversation);
+  var toggle = wrapper.querySelector(".home-sidebar-driver-toggle");
+  toggle.classList.add("home-sidebar-orphan-toggle");
+  toggle.setAttribute("aria-label", "Toggle Workers whose Driver is unavailable");
+  toggle.insertAdjacentHTML("beforeend", "<span>Unavailable Driver</span><span>" + workers.length + "</span>");
+  return wrapper;
+}
 
 export function renderHomeSidebarChats(openConversation) {
   var list = document.getElementById("home-sidebar-recent-list");
@@ -11,9 +102,7 @@ export function renderHomeSidebarChats(openConversation) {
   var chats = getHomeSessionConversations();
   var scope = store.get('homeChatScope') === "current" ? "current" : "all";
   var activeMateId = store.get('homeChatMateId');
-  if (scope === "current") {
-    chats = chats.filter(function (chat) { return chat.mateId === activeMateId; });
-  }
+  if (scope === "current") chats = chats.filter(function (chat) { return chat.mateId === activeMateId; });
   if (!chats.length) {
     var empty = document.createElement("div");
     empty.className = "home-sidebar-recent-empty";
@@ -21,43 +110,14 @@ export function renderHomeSidebarChats(openConversation) {
     list.appendChild(empty);
     return 0;
   }
-  var activeSessionId = store.get('homeChatSessionId');
-  for (var i = 0; i < chats.length; i++) {
-    (function (chat) {
-      var item = document.createElement("div");
-      item.className = "home-sidebar-recent-item";
-      var row = document.createElement("button");
-      row.type = "button";
-      row.className = "home-sidebar-recent-row";
-      row.setAttribute("aria-label", chat.title + ", with " + chat.mateName);
-      if (chat.mateId === activeMateId && chat.sessionId === activeSessionId) {
-        item.classList.add("is-active");
-        row.setAttribute("aria-current", "page");
-      }
-      var copy = document.createElement("span");
-      copy.className = "home-sidebar-recent-copy";
-      var title = document.createElement("span");
-      title.className = "home-sidebar-recent-title";
-      title.textContent = chat.title;
-      var mate = document.createElement("span");
-      mate.className = "home-sidebar-recent-mate";
-      mate.textContent = chat.mateName;
-      copy.appendChild(title);
-      copy.appendChild(mate);
-      row.appendChild(copy);
-      if (chat.isProcessing) {
-        var activity = document.createElement("span");
-        activity.className = "home-sidebar-processing";
-        activity.setAttribute("aria-label", "Processing");
-        row.appendChild(activity);
-      }
-      row.addEventListener("click", function () {
-        if (typeof openConversation === "function") openConversation(chat.mateId, chat.sessionId);
-      });
-      item.appendChild(row);
-      item.appendChild(createHomeSessionActionsTrigger(chat));
-      list.appendChild(item);
-    })(chats[i]);
+  var hierarchy = buildSessionHierarchy(chats);
+  var hasHierarchy = hierarchy.orphans.length > 0;
+  hierarchy.roots.sort(function (a, b) { return b.lastActivity - a.lastActivity; });
+  for (var i = 0; i < hierarchy.roots.length; i++) {
+    if (hierarchy.roots[i].workers.length) hasHierarchy = true;
+    list.appendChild(createHierarchy(hierarchy.roots[i], openConversation));
   }
+  if (hierarchy.orphans.length) list.appendChild(createOrphans(hierarchy.orphans, openConversation));
+  if (hasHierarchy) refreshIcons();
   return chats.length;
 }

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

@@ -10,6 +10,7 @@ import { openHomeConversationsSheet, refreshHomeConversationsSheet } from './hom
 import { renderHomeSidebarChats } from './home-sidebar-chat-list.js';
 import { syncHomeSessionDetails } from './home-session-actions.js';
 import { toggleHomeCapsules } from './home-dock.js';
+import { openHomeScheduler } from './scheduler.js';
 
 var initialized = false;
 var requestedMateIds = {};
@@ -119,6 +120,11 @@ function toggleCapsulesFromSidebar() {
   closeNarrowDrawer(!opening);
 }
 
+function openScheduledTasksFromSidebar() {
+  openHomeScheduler();
+  closeNarrowDrawer(false);
+}
+
 function handleSidebarKeydown(event) {
   if (event.key !== "Escape" || event.defaultPrevented) return;
   if (!document.body.classList.contains("home-active")) return;
@@ -137,6 +143,7 @@ export function initHomeSidebar() {
   document.getElementById("home-sidebar-new").addEventListener("click", startConversationFromSidebar);
   document.getElementById("home-sidebar-all").addEventListener("click", openAllConversations);
   document.getElementById("home-sidebar-debate").addEventListener("click", openDebatesFromSidebar);
+  document.getElementById("home-scheduler-btn").addEventListener("click", openScheduledTasksFromSidebar);
   document.getElementById("home-tools-btn").addEventListener("click", toggleCapsulesFromSidebar);
   var scopeButtons = document.querySelectorAll("[data-home-chat-scope]");
   for (var i = 0; i < scopeButtons.length; i++) scopeButtons[i].addEventListener("click", setChatScope);

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

@@ -1,4 +1,4 @@
-// One-shot boot routing after durable Home preferences become available.
+// One-shot routing for a server-selected project or the no-project Home fallback.
 import { store } from './store.js';
 import { rememberHomePrimarySurface } from './home-surface.js';
 
@@ -10,9 +10,13 @@ function explicitProjectPath(pathname) {
 }
 
 export function resolveHomeBootDestination(options) {
-  if (!options || options.surfaceLoaded !== true) return "wait";
+  if (!options) return "wait";
   if (options.paneMode || explicitProjectPath(options.pathname)) return "project";
-  if (options.surface === "project" && options.currentSlug) return "project";
+  // The server-selected project embedded in the root shell is authoritative.
+  // Home is entered only through an explicit in-app action; reloading `/`
+  // returns to the project workspace even if Home was the last open surface.
+  if (options.currentSlug) return "project";
+  if (options.surfaceLoaded !== true) return "wait";
   if (options.dockLoaded !== true) return "wait";
   return "home";
 }