clay-server 5.0.0-beta.2 → 5.0.0-beta.4

package/lib/public/index.html

@@ -137,7 +137,16 @@
         </aside>
         <div id="home-workspace" class="home-workspace">
           <button id="home-sidebar-expand" class="home-sidebar-expand" type="button" title="Show sidebar" aria-label="Show Home sidebar" aria-describedby="home-sidebar-expand-brand-label"><i data-lucide="panel-left-open"></i><span id="home-sidebar-expand-brand-label" class="home-sidebar-brand-wordmark home-sidebar-expand-wordmark">Clay Studio</span></button>
-          <button id="home-close-control" class="home-close-control" type="button" title="Projects" aria-label="Projects"><i data-lucide="folder" aria-hidden="true"></i><span>Projects</span></button>
+          <button id="home-close-control" class="home-close-control" type="button" title="Return to project" aria-label="Return to project"><i data-lucide="folder" aria-hidden="true"></i><span>Project</span></button>
+          <section id="home-project-empty" class="home-project-empty" aria-labelledby="home-project-empty-title" hidden>
+            <div class="home-project-empty-content">
+              <span class="home-project-empty-icon" aria-hidden="true"><i data-lucide="folder-plus"></i></span>
+              <p class="home-project-empty-eyebrow">PROJECT WORKSPACE</p>
+              <h1 id="home-project-empty-title" tabindex="-1">Start a new project</h1>
+              <p id="home-project-empty-status" class="home-project-empty-status" role="status">Create an empty project, then continue in its workspace.</p>
+              <button id="home-project-empty-create" type="button">Start a new project</button>
+            </div>
+          </section>
           <div id="home-conversation-region" class="home-conversation-region">
             <div id="home-mate-chat" class="home-mate-chat">
               <div class="home-mate-chat-stage">
@@ -208,13 +217,7 @@
       </div>
       <div id="sidebar">
         <div id="sidebar-tools">
-          <div class="sidebar-tools-header">
-            <span class="sidebar-section-label">Tools</span>
-            <span class="sidebar-tools-hint" data-palette="session" title="Show keyboard hotkeys"></span>
-            <button type="button" class="tool-palette-edit-btn" data-palette="session" aria-label="Edit tool palette" title="Edit palette"><i data-lucide="pencil"></i></button>
-          </div>
-          <div id="session-actions"></div>
-          <div id="session-actions-hidden" class="tool-palette-hidden-section hidden"></div>
+          <div id="session-actions" role="group" aria-label="Tools"></div>
           <!-- Repository placard. Hidden until a real Git repository is
                confirmed, so non-Git projects and pending detection show
                nothing rather than an empty block. -->
@@ -228,13 +231,7 @@
         <div id="sidebar-sessions-header">
           <div id="sessions-header-content">
             <div class="sidebar-sessions-header-row">
-              <span class="sidebar-section-label">Sessions</span>
-              <span id="session-filter-count" class="session-filter-count hidden"></span>
-              <div id="session-header-search-inline" class="sidebar-sessions-search-inline hidden">
-                <input id="session-header-search-input" type="text" placeholder="Search sessions..." autocomplete="off" spellcheck="false" />
-                <button id="session-header-search-clear" type="button" aria-label="Clear search"><i data-lucide="x"></i></button>
-              </div>
-              <button id="session-header-search-btn" type="button" aria-label="Search sessions" title="Search sessions"><i data-lucide="search"></i></button>
+              <span class="sidebar-section-label sidebar-label-sr">Sessions</span>
             </div>
           </div>
           <div id="files-header-content" class="hidden"></div>
@@ -294,13 +291,7 @@
         <button id="mate-sidebar-toggle-btn" class="sidebar-collapse-btn" title="Collapse sidebar"><i data-lucide="panel-left-close"></i></button>
       </div>
       <div id="mate-sidebar-tools-wrap">
-        <div class="sidebar-tools-header">
-          <span class="sidebar-section-label">Tools</span>
-          <span class="sidebar-tools-hint" data-palette="mate" title="Show keyboard hotkeys"></span>
-          <button type="button" class="tool-palette-edit-btn" data-palette="mate" aria-label="Edit tool palette" title="Edit palette"><i data-lucide="pencil"></i></button>
-        </div>
-        <div id="mate-sidebar-tools"></div>
-        <div id="mate-sidebar-tools-hidden" class="tool-palette-hidden-section hidden"></div>
+        <div id="mate-sidebar-tools" role="group" aria-label="Tools"></div>
       </div>
       <div id="mate-sidebar-conversations">
         <div class="mate-sidebar-sessions-header">

package/lib/public/modules/app-favicon.js

@@ -137,12 +137,13 @@ export function blinkIO() {
 }
 
 export function blinkSessionDot(sessionId) {
-  var el = document.querySelector('.session-item[data-session-id="' + sessionId + '"] .session-processing');
-  if (!el) return;
-  el.classList.add("io");
+  // A favorite is on screen twice; blink every copy.
+  var els = document.querySelectorAll('.session-item[data-session-id="' + sessionId + '"] .session-processing');
+  if (!els.length) return;
+  for (var i = 0; i < els.length; i++) els[i].classList.add("io");
   clearTimeout(sessionIoTimers[sessionId]);
   sessionIoTimers[sessionId] = setTimeout(function () {
-    el.classList.remove("io");
+    for (var j = 0; j < els.length; j++) els[j].classList.remove("io");
     delete sessionIoTimers[sessionId];
   }, 80);
 }

package/lib/public/modules/app-home-hub.js

@@ -3,8 +3,8 @@
 import { showProjectsHub, hideProjectsHub } from './projects-hub.js';
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
-import { getCachedProjects, switchProject } from './app-projects.js';
-import { chooseProjectActivationTarget } from './project-activation.js';
+import { getCachedProjects, openAddProjectModal, switchProject } from './app-projects.js';
+import { chooseProjectActivationTarget, homeProjectCreationState } from './project-activation.js';
 import { mateAvatarUrl } from './avatar.js';
 import { exitDmMode } from './app-dm.js';
 import { closeHomeDock, initHomeDock, renderDock, requestHomeDockPreference } from './home-dock.js';
@@ -22,6 +22,7 @@ import { disposeHomeSessionActions } from './home-session-actions.js';
 import { initHomeDebatesArchive, restoreHomeDebatesArchive } from './home-debates-archive.js';
 import { isHomeDebatesSurface } from './home-sub-surface.js';
 import { HOME_CAPSULE_CREATION_EVENT } from './home-capsule-creation-intent.js';
+import { bindHomeProjectEmptyDismissal, setHomeProjectEmptyCoverage } from './home-project-empty-access.js';
 
 var homeHub = null;
 var homeHubVisible = false;
@@ -44,6 +45,13 @@ function syncHomeCloseControl() {
   var close = document.getElementById("home-close-control");
   if (!close) return;
   close.classList.remove("hidden");
+  var loaded = store.get('projectListLoaded') === true;
+  var slug = loaded ? getHomeReturnSlug() : null;
+  var label = close.querySelector("span");
+  close.disabled = !loaded;
+  close.title = !loaded ? "Loading projects" : (slug ? "Return to project" : "Project options");
+  close.setAttribute("aria-label", close.title);
+  if (label) label.textContent = loaded ? "Project" : "Loading…";
 }
 
 function getHomeReturnSlug() {
@@ -53,6 +61,34 @@ function getHomeReturnSlug() {
   );
 }
 
+function syncHomeProjectEmptyState() {
+  var empty = document.getElementById("home-project-empty");
+  if (!empty) return;
+  var requested = store.get('homeProjectEmptyVisible') === true;
+  var loaded = store.get('projectListLoaded') === true;
+  var returnSlug = loaded ? getHomeReturnSlug() : null;
+  var visible = homeHubVisible && requested && loaded && !returnSlug;
+  setHomeProjectEmptyCoverage(document, visible);
+  empty.hidden = !visible;
+  if (requested && loaded && returnSlug) store.set({ homeProjectEmptyVisible: false });
+  if (!visible) return;
+  var availability = homeProjectCreationState(store.snap());
+  var action = document.getElementById("home-project-empty-create");
+  var status = document.getElementById("home-project-empty-status");
+  action.disabled = !availability.enabled;
+  if (status) status.textContent = availability.message;
+}
+
+function dismissHomeProjectEmpty() {
+  if (store.get('homeProjectEmptyVisible')) store.set({ homeProjectEmptyVisible: false });
+}
+
+function openHomeProjectCreation() {
+  var availability = homeProjectCreationState(store.snap());
+  if (!availability.enabled || getHomeReturnSlug()) return;
+  openAddProjectModal("create");
+}
+
 function getVisibleMates() {
   var mates = (store.get('cachedMatesList') || []).filter(function (mate) {
     return !!mate && !mate.archived;
@@ -100,6 +136,7 @@ function isMateBusy(mate, projectStatus, mentionActive) {
 }
 
 function selectHomeMate(mateId) {
+  if (store.get('homeProjectEmptyVisible')) store.set({ homeProjectEmptyVisible: false });
   if (mateId !== store.get('homeChatMateId') || isHomeDebatesSurface()) openHomeChat(mateId);
   closeHomeSidebarAfterSelection();
 }
@@ -246,14 +283,20 @@ export function initHomeHub() {
   initHomeDock();
   initHomeDebatesArchive();
   document.getElementById("home-mate-list").addEventListener("keydown", handleMateListKeydown);
-  document.getElementById("home-close-control").addEventListener("click", function () { showProjectsHub(); });
+  bindHomeProjectEmptyDismissal(document.getElementById("home-sidebar"), dismissHomeProjectEmpty);
+  document.getElementById("home-close-control").addEventListener("click", minimizeHomeHub);
+  document.getElementById("home-project-empty-create").addEventListener("click", openHomeProjectCreation);
   document.getElementById("home-nav-projects").addEventListener("click", function () { showProjectsHub(); });
   window.addEventListener("clay:home-debate", function () { hideHomeHub(); });
   document.addEventListener("visibilitychange", syncHomePresentation);
 
   store.subscribe(function (state, prev) {
     if (state.connected !== prev.connected && state.connected && homeHubVisible) syncHomePresentation();
-    if (state.currentSlug !== prev.currentSlug) syncHomeCloseControl();
+    if (state.currentSlug !== prev.currentSlug || state.homeSurfaceProjectSlug !== prev.homeSurfaceProjectSlug ||
+        state.projectListLoaded !== prev.projectListLoaded || state.projectsHubList !== prev.projectsHubList) syncHomeCloseControl();
+    if (state.homeProjectEmptyVisible !== prev.homeProjectEmptyVisible || state.projectListLoaded !== prev.projectListLoaded ||
+        state.projectsHubList !== prev.projectsHubList || state.projectsAccessLoaded !== prev.projectsAccessLoaded ||
+        state.permissions !== prev.permissions || state.connected !== prev.connected) syncHomeProjectEmptyState();
     if (state.homeChatMateId !== prev.homeChatMateId || state.cachedMatesList !== prev.cachedMatesList) renderHomeMateSwitcher();
     if (state.homeSidebarCollapsed !== prev.homeSidebarCollapsed && !state.homeSidebarCollapsed) {
       requestAnimationFrame(renderHomeMateSwitcher);
@@ -352,7 +395,7 @@ export function updateHomeIconBadge() {
 
 export function showHomeHub(fromHistory) {
   hideProjectsHub();
-  store.set({ pendingHomeProjectSlug: null });
+  store.set({ pendingHomeProjectSlug: null, homeProjectEmptyVisible: false });
   if (store.get('dmMode')) exitDmMode();
   var activeMateId = store.get('homeChatMateId');
   var resume = homeHubSuspended || homeHubVisible;
@@ -363,6 +406,7 @@ export function showHomeHub(fromHistory) {
   rememberHomePrimarySurface("home");
   syncHomePresentation();
   syncHomeCloseControl();
+  syncHomeProjectEmptyState();
   renderHomeMateSwitcher();
   if (activeMateId && !resume && !isHomeDebatesSurface()) openHomeChat(activeMateId);
   if (isHomeDebatesSurface()) restoreHomeDebatesArchive();
@@ -392,6 +436,7 @@ export function hideHomeHub() {
   disposeHomeSessionActions();
   homeHubVisible = false;
   homeHubSuspended = true;
+  if (store.get('homeProjectEmptyVisible')) store.set({ homeProjectEmptyVisible: false });
   hideHomeShell();
   homeHub.classList.add("hidden");
   syncHomePresentation();
@@ -402,9 +447,17 @@ export function hideHomeHub() {
 }
 
 export function minimizeHomeHub() {
-  var slug = getHomeReturnSlug();
   if (!homeHubVisible) return;
-  if (!slug) { showProjectsHub(); return; }
+  if (store.get('projectListLoaded') !== true) return;
+  var slug = getHomeReturnSlug();
+  if (!slug) {
+    store.set({ homeProjectEmptyVisible: true });
+    syncHomeProjectEmptyState();
+    var title = document.getElementById("home-project-empty-title");
+    if (title) title.focus({ preventScroll: true });
+    return;
+  }
+  if (store.get('homeProjectEmptyVisible')) store.set({ homeProjectEmptyVisible: false });
   switchProject(slug);
   var projectInput = document.getElementById("input");
   if (projectInput && !projectInput.disabled) projectInput.focus({ preventScroll: true });

package/lib/public/modules/app-messages.js

@@ -17,6 +17,9 @@ import { showToast } from './utils.js';
 import { refreshIcons, iconHtml } from './icons.js';
 import { renderMarkdown, highlightCodeBlocks, renderMermaidBlocks } from './markdown.js';
 import { updatePageTitle } from './sidebar.js';
+import { handleSessionFoldersState } from './session-folders.js';
+import { handleFolderDeletePreview, handleFolderDeleteState } from './session-folder-delete.js';
+import { handleSessionCreateMessage, handleNewSessionResult } from './session-create.js';
 import { renderSessionList, updateSessionPresence, handleSearchResults, updateSessionBadge } from './sidebar-sessions.js';
 import { updateDmBadge, setMentionActive, renderUserStrip } from './sidebar-mates.js';
 import { renderSidebarPresence } from './sidebar-presence.js';
@@ -117,6 +120,8 @@ export function processMessage(msg) {
   if (handleAutonomousRunMessage(msg)) return;
   if (handleLoopInterviewMessage(msg)) return;
   if (handleScheduledTaskMessage(msg)) return;
+  if (handleSessionCreateMessage(msg)) return;
+  if (msg && msg.type === "new_session_result" && handleNewSessionResult(msg)) return;
   if (handleDefaultVendorMessage(msg)) return;
   if (handleContextViewMessage(msg)) return;
   if (msg && msg.type === "set_project_session_visibility_default_result") {
@@ -718,6 +723,14 @@ export function processMessage(msg) {
         if (!store.get('dmMode')) handleInputSync(msg.text);
         break;
 
+      case "session_folders_delete_preview_result":
+        handleFolderDeletePreview(msg);
+        break;
+      case "session_folders_state":
+        handleSessionFoldersState(msg);
+        handleFolderDeleteState(msg);
+        break;
+
       case "session_list":
         markProjectSessionListHydrated();
         renderMateSessionList(msg.sessions || []);

package/lib/public/modules/home-project-empty-access.js

@@ -0,0 +1,44 @@
+// Accessibility boundary for the Home no-project overlay.
+
+var coveredIds = ["home-conversation-region", "home-dock-backdrop", "home-dock-divider", "home-tool-workbench"];
+var priorStates = new WeakMap();
+
+function remember(element) {
+  if (priorStates.has(element)) return;
+  priorStates.set(element, {
+    inert: element.inert === true,
+    inertAttribute: element.hasAttribute("inert"),
+    ariaHidden: element.getAttribute("aria-hidden"),
+  });
+}
+
+function restore(element) {
+  var prior = priorStates.get(element);
+  if (!prior) return;
+  element.inert = prior.inert;
+  if (prior.inertAttribute) element.setAttribute("inert", "");
+  else element.removeAttribute("inert");
+  if (prior.ariaHidden === null) element.removeAttribute("aria-hidden");
+  else element.setAttribute("aria-hidden", prior.ariaHidden);
+  priorStates.delete(element);
+}
+
+export function setHomeProjectEmptyCoverage(doc, covered) {
+  for (var i = 0; i < coveredIds.length; i++) {
+    var element = doc.getElementById(coveredIds[i]);
+    if (!element) continue;
+    if (!covered) { restore(element); continue; }
+    remember(element);
+    element.inert = true;
+    element.setAttribute("inert", "");
+    element.setAttribute("aria-hidden", "true");
+  }
+}
+
+export function bindHomeProjectEmptyDismissal(sidebar, dismiss) {
+  sidebar.addEventListener("click", function (event) {
+    var control = event.target.closest("#home-sidebar-new, #home-sidebar-all, #home-sidebar-debate, #home-tools-btn, .home-mate-list-row, .home-sidebar-recent-list button");
+    if (!control || control.disabled) return;
+    dismiss();
+  }, true);
+}

package/lib/public/modules/input.js

@@ -1,4 +1,5 @@
 import { stopSTT } from './stt-controller.js';
+import { expectCreatedSession } from './session-create.js';
 import { hasRecordedSpeechFor, requestRecordedSend } from './stt-recording.js';
 import { iconHtml, refreshIcons } from './icons.js';
 import { setRewindMode, isRewindMode } from './rewind.js';
@@ -184,6 +185,8 @@ export function sendMessage() {
     autoResize();
     if (ctx.ws && ctx.connected) {
       ctx.ws.send(JSON.stringify({ type: "new_session" }));
+      // The fresh session lands in Unfiled; expand and reveal it there.
+      expectCreatedSession("unfiled");
     }
     return;
   }

package/lib/public/modules/project-activation.js

@@ -19,6 +19,17 @@ export function chooseProjectActivationTarget(projects, candidates) {
   return null;
 }
 
+export function homeProjectCreationState(state) {
+  var current = state || {};
+  if (current.projectListLoaded !== true) return { ready: false, enabled: false, message: "Loading projects…" };
+  if (current.projectsAccessLoaded !== true) return { ready: false, enabled: false, message: "Checking project access…" };
+  if (current.permissions && current.permissions.createProject !== true) {
+    return { ready: true, enabled: false, message: "Ask an administrator to create or share a project with you." };
+  }
+  if (current.connected !== true) return { ready: true, enabled: false, message: "Reconnect to start a project." };
+  return { ready: true, enabled: true, message: "Create an empty project, then continue in its workspace." };
+}
+
 export function isProjectActivationPending(state, slug, socket) {
   var target = projectWsPath(slug);
   return !!target

package/lib/public/modules/project-switcher.js

@@ -16,7 +16,7 @@
 import { store } from './store.js';
 import { refreshIcons } from './icons.js';
 import { getCachedProjects, switchProject } from './app-projects.js';
-import { showHomeHub } from './app-home-hub.js';
+import { showHomeHub, isHomeHubVisible } from './app-home-hub.js';
 import { openHomeChat } from './home-mate-chat.js';
 import { mateAvatarUrl } from './avatar.js';
 import { parseEmojis } from './markdown.js';
@@ -34,7 +34,7 @@ var _entries = [];
 
 export function openSwitcherForMode(mode) {
   if (mode !== 'project' && mode !== 'mate') return;
-  if (mode === 'mate' && store.get('projectMateDmsEnabled') === false) return;
+  if (mode === 'mate' && !isHomeHubVisible()) return;
   if (_open) closeSwitcher(false);
   openSwitcher(mode);
 }
@@ -95,7 +95,7 @@ export function initProjectSwitcher() {
   function refreshMateHintVisibility() {
     if (!mateHint) return;
     var mates = store.get('cachedMatesList') || [];
-    mateHint.classList.toggle('hidden', mates.length === 0 || store.get('projectMateDmsEnabled') === false);
+    mateHint.classList.toggle('hidden', mates.length === 0);
   }
   refreshMateHintVisibility();
   store.subscribe(function (state, prev) {
@@ -145,7 +145,7 @@ function handleKeyDown(e) {
   // same shortcut cycles.
   if (isMod && (k === 'e' || k === 'm')) {
     var requestedMode = k === 'e' ? 'project' : 'mate';
-    if (requestedMode === 'mate' && store.get('projectMateDmsEnabled') === false) return;
+    if (requestedMode === 'mate' && !isHomeHubVisible()) return;
     e.preventDefault();
     e.stopPropagation();
     if (!_open) {