clay-server 4.6.1-beta.1 → 4.7.0-beta.2

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

@@ -21,7 +21,7 @@ function normalizeSessions(value) {
 }
 
 function normalizePrimarySurface(value) {
-  return value === "home" || value === "project" ? value : null;
+  return value === "home" || value === "project" || value === "projects" ? value : null;
 }
 
 function normalizeProjectSlug(value) {
@@ -51,6 +51,7 @@ export function updateHomeSurfacePreference(patch) {
     matesCollapsed: state.homeMatesCollapsed === true,
     chatScope: normalizeChatScope(state.homeChatScope),
     subSurface: normalizeSubSurface(state.homeSubSurface),
+    onboardingStep: state.onboardingStep || "welcome",
   };
   if (patch && Object.prototype.hasOwnProperty.call(patch, "surface")) next.surface = normalizePrimarySurface(patch.surface);
   if (patch && Object.prototype.hasOwnProperty.call(patch, "projectSlug")) next.projectSlug = normalizeProjectSlug(patch.projectSlug);
@@ -60,7 +61,12 @@ export function updateHomeSurfacePreference(patch) {
   if (patch && Object.prototype.hasOwnProperty.call(patch, "matesCollapsed")) next.matesCollapsed = patch.matesCollapsed === true;
   if (patch && Object.prototype.hasOwnProperty.call(patch, "chatScope")) next.chatScope = normalizeChatScope(patch.chatScope);
   if (patch && Object.prototype.hasOwnProperty.call(patch, "subSurface")) next.subSurface = normalizeSubSurface(patch.subSurface);
+  if (patch && ["welcome", "project", "complete"].indexOf(patch.onboardingStep) !== -1) {
+    next.onboardingStep = patch.onboardingStep;
+    store.set({ onboardingIntent: patch.onboardingStep });
+  }
   store.set({
+    onboardingStep: next.onboardingStep,
     homePrimarySurface: next.surface,
     homeSurfaceProjectSlug: next.projectSlug,
     homeActiveSessionByMate: normalizeSessions(next.activeSessionByMate),
@@ -78,6 +84,7 @@ export function updateHomeSurfacePreference(patch) {
   if (patch && Object.prototype.hasOwnProperty.call(patch, "matesCollapsed")) outgoing.matesCollapsed = next.matesCollapsed;
   if (patch && Object.prototype.hasOwnProperty.call(patch, "chatScope")) outgoing.chatScope = next.chatScope;
   if (patch && Object.prototype.hasOwnProperty.call(patch, "subSurface")) outgoing.subSurface = next.subSurface;
+  if (patch && Object.prototype.hasOwnProperty.call(patch, "onboardingStep")) outgoing.onboardingStep = next.onboardingStep;
   return send({ type: "home_surface_set", preference: outgoing });
 }
 
@@ -127,7 +134,11 @@ export function handleHomeSurfaceState(msg) {
   var savedSurface = normalizePrimarySurface(preference.surface);
   var savedProject = normalizeProjectSlug(preference.projectSlug);
   var intentConfirmed = !!intent && intent === savedSurface && intendedProject === savedProject;
+  var onboardingIntent = store.get('onboardingIntent');
+  var savedStep = ["welcome", "project", "complete"].indexOf(preference.onboardingStep) !== -1 ? preference.onboardingStep : "welcome";
   var update = {
+    onboardingStep: onboardingIntent || savedStep,
+    onboardingIntent: onboardingIntent === savedStep ? null : onboardingIntent,
     homeSurfaceLoaded: true,
     homePrimarySurface: intent || savedSurface,
     homeSurfaceProjectSlug: intent ? intendedProject : savedProject,
@@ -142,5 +153,6 @@ export function handleHomeSurfaceState(msg) {
     update.homePreferredMateId = store.get('homePreferredMateId') || preference.activeMateId || store.get('homeChatMateId') || null;
   }
   store.set(update);
+  if (onboardingIntent && onboardingIntent !== savedStep) send({ type: "home_surface_set", preference: { onboardingStep: onboardingIntent } });
   if (intent && !intentConfirmed) send({ type: "home_surface_set", preference: { surface: intent, projectSlug: intendedProject } });
 }

package/lib/public/modules/projects-hub-view.js

@@ -0,0 +1,62 @@
+import { escapeHtml } from './utils.js';
+import { iconHtml } from './icons.js';
+
+export function ordinaryProjects(projects) {
+  return (Array.isArray(projects) ? projects : []).filter(function (project) {
+    return project && !project.isMate && project.slug;
+  });
+}
+
+function button(action, label, extra) {
+  return '<button type="button" class="projects-button ' + (extra || '') + '" data-projects-action="' + action + '">' + label + '</button>';
+}
+
+function setupAction(mode, icon, title, text, disabled) {
+  return '<button type="button" class="projects-setup-action" data-projects-mode="' + mode + '"' + (disabled ? ' disabled' : '') + '>' +
+    '<span class="projects-action-icon">' + iconHtml(icon) + '</span><span><strong>' + title + '</strong><span>' + text + '</span></span>' + iconHtml('arrow-up-right') + '</button>';
+}
+
+export function projectsHubContent(state) {
+  var projects = ordinaryProjects(state.projectsHubList);
+  var ready = state.projectListLoaded && state.homeSurfaceLoaded;
+  var welcome = ready && (state.projectsShowGuide || (!projects.length && (state.onboardingStep || 'welcome') === 'welcome'));
+  var allowed = state.projectsAccessLoaded && (!state.permissions || state.permissions.createProject === true);
+  var available = allowed && state.connected && !state.pendingHomeProjectSlug;
+  var html = '<header class="projects-header"><a class="projects-brand" href="/" data-projects-action="home"><img src="/clay-studio-symbol.png" alt="">Clay Studio</a>' +
+    '<nav aria-label="Workspace navigation">' + button('home', 'Home', 'projects-button-quiet') + button('settings', 'Settings', 'projects-button-quiet') + '</nav></header>';
+  html += '<main class="projects-main" aria-labelledby="projects-title">';
+  if (!ready) return html + '<div class="projects-loading" role="status"><h1 id="projects-title" tabindex="-1">Your projects</h1><p>Loading your workspace…</p></div></main>';
+  if (welcome) {
+    return html + '<section class="projects-welcome"><div class="projects-eyebrow">WELCOME TO CLAY</div>' +
+      '<h1 id="projects-title" tabindex="-1">A place for<br>your next idea.</h1>' +
+      '<p class="projects-lead">Bring a project. Describe what you want to build.<br>Your AI Driver helps you take it from there.</p>' +
+      '<div class="projects-intro-grid"><div><span>01 / PROJECTS</span><h2>Work on something real.</h2><p>Open a folder, start fresh, or clone a repository. Your conversations and tools stay with the project.</p></div>' +
+      '<div><span>02 / HOME</span><h2>Make room to think.</h2><p>Talk with Clay and your Mates, explore ideas, and return to your projects whenever you’re ready.</p></div></div>' +
+      '<div class="projects-welcome-actions">' + button('start', projects.length ? 'Explore your projects ' + iconHtml('arrow-right') : 'Set up your first project ' + iconHtml('arrow-right'), 'projects-button-primary') +
+      button('skip', 'Explore Home first', 'projects-button-quiet') + '</div>' +
+      '<p class="projects-footnote">You can revisit this guide from Projects at any time.</p></section></main>';
+  }
+  html += '<div class="projects-heading"><div><div class="projects-eyebrow">YOUR WORKSPACE</div><h1 id="projects-title" tabindex="-1">' + (projects.length ? 'Projects' : 'Start with a project.') + '</h1>' +
+    '<p class="projects-lead">' + (projects.length ? 'Pick up where you left off, or begin something new.' : 'Choose where your work will live. You can add more projects later.') + '</p></div>' + button('guide', 'Getting started', 'projects-button-quiet') + '</div>';
+  if (state.pendingHomeProjectSlug) html += '<p class="projects-status" role="status">Opening your project…</p>';
+  if (projects.length) {
+    html += '<div class="projects-list" aria-label="Your projects">';
+    projects.forEach(function (project) {
+      html += '<button type="button" class="projects-list-item" data-project-slug="' + escapeHtml(project.slug) + '"' + (!state.connected || state.pendingHomeProjectSlug ? ' disabled' : '') + '>' +
+        '<span class="projects-action-icon">' + iconHtml(project.isWorktree ? 'git-branch' : 'folder') + '</span><span><strong>' + escapeHtml(project.title || project.project || project.slug) + '</strong>' +
+        '<span>' + escapeHtml(project.branch || project.path || project.slug) + '</span></span>' + iconHtml('arrow-right') + '</button>';
+    });
+    html += '</div><h2 class="projects-section-title">Add a project</h2>';
+  }
+  if (!state.projectsAccessLoaded) html += '<p class="projects-status" role="status">Checking project access…</p>';
+  else if (!allowed) html += '<p class="projects-status">Ask an administrator to create or share a project with you.</p>';
+  else {
+    html += '<div class="projects-setup-actions">' +
+      setupAction('existing', 'folder-open', 'Open a folder', 'Use a directory on the machine running Clay.', !available) +
+      setupAction('create', 'plus', 'Create a project', 'Start in a new, empty project directory.', !available) +
+      setupAction('clone', 'git-branch', 'Clone a repository', 'Bring an existing Git repository into Clay.', !available) + '</div>';
+    if (!projects.length) html += '<p class="projects-next-step"><span>UP NEXT</span> Choose your AI in the workspace, then tell your Driver what you want to build or fix.</p>';
+  }
+  if (!state.connected) html += '<p class="projects-status" role="status">Reconnecting… Project actions will be available when the connection returns.</p>';
+  return html + '</main><footer class="projects-footer">Your projects, conversations, and tools. One workspace.</footer>';
+}

package/lib/public/modules/projects-hub.js

@@ -0,0 +1,105 @@
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { hideHomeHub, showHomeHub } from './app-home-hub.js';
+import { openAddProjectModal, switchProject } from './app-projects.js';
+import { openUserSettings } from './user-settings.js';
+import { rememberHomePrimarySurface, updateHomeSurfacePreference } from './home-surface.js';
+import { projectsHubContent } from './projects-hub-view.js';
+import { refreshIcons } from './icons.js';
+
+function root() { return document.getElementById('projects-hub'); }
+
+function render() {
+  var element = root();
+  if (!element || !store.get('projectsHubVisible')) return;
+  var html = projectsHubContent(store.snap());
+  if (store.get('projectsHubMarkup') === html) return;
+  store.set({ projectsHubMarkup: html });
+  var active = element.contains(document.activeElement) ? document.activeElement : null;
+  var action = active && (active.dataset.projectsAction || active.dataset.projectsMode || active.dataset.projectSlug);
+  element.innerHTML = html;
+  refreshIcons();
+  if (action) {
+    var buttons = element.querySelectorAll('button, a');
+    for (var i = 0; i < buttons.length; i++) {
+      if ((buttons[i].dataset.projectsAction || buttons[i].dataset.projectsMode || buttons[i].dataset.projectSlug) === action && !buttons[i].disabled) {
+        buttons[i].focus({ preventScroll: true });
+        break;
+      }
+    }
+  }
+}
+
+function focusHeading() {
+  if (root()) root().scrollTop = 0;
+  var title = document.getElementById('projects-title');
+  if (title) title.focus({ preventScroll: true });
+}
+
+export function showProjectsHub(fromHistory) {
+  hideHomeHub();
+  store.set({ projectsHubVisible: true, pendingHomeProjectSlug: null });
+  document.body.classList.add('projects-active');
+  root().classList.remove('hidden');
+  rememberHomePrimarySurface('projects');
+  if (!fromHistory && location.pathname !== '/projects') {
+    var method = document.documentElement.classList.contains('pwa-standalone') ? 'replaceState' : 'pushState';
+    history[method](null, '', '/projects');
+  }
+  render();
+  focusHeading();
+}
+
+export function hideProjectsHub() {
+  if (!store.get('projectsHubVisible')) return;
+  store.set({ projectsHubVisible: false, projectsShowGuide: false });
+  document.body.classList.remove('projects-active');
+  if (root()) root().classList.add('hidden');
+}
+
+export function completeProjectsOnboarding() {
+  if (store.get('onboardingStep') !== 'project') return;
+  updateHomeSurfacePreference({ onboardingStep: 'complete' });
+}
+
+function handleClick(event) {
+  var button = event.target.closest('[data-projects-action], [data-projects-mode], [data-project-slug]');
+  if (!button || button.disabled) return;
+  event.preventDefault();
+  var action = button.dataset.projectsAction;
+  if (action === 'home') { showHomeHub(); return; }
+  if (action === 'settings') { openUserSettings(); return; }
+  if (action === 'guide') { store.set({ projectsShowGuide: true }); render(); focusHeading(); return; }
+  if (action === 'start' || action === 'skip') {
+    store.set({ projectsShowGuide: false });
+    updateHomeSurfacePreference({ onboardingStep: 'project' });
+    if (action === 'skip') showHomeHub();
+    else { render(); focusHeading(); }
+    return;
+  }
+  var ws = getWs();
+  if (!ws || ws.readyState !== 1) return;
+  if (button.dataset.projectSlug) { switchProject(button.dataset.projectSlug); return; }
+  if (button.dataset.projectsMode) {
+    var permissions = store.get('permissions');
+    if (!store.get('projectsAccessLoaded') || (permissions && permissions.createProject !== true)) return;
+    openAddProjectModal(button.dataset.projectsMode);
+  }
+}
+
+export function initProjectsHub() {
+  root().addEventListener('click', handleClick);
+  store.subscribe(function (state, previous) {
+    if (state.projectsHubRestoreRequested && !previous.projectsHubRestoreRequested) {
+      showProjectsHub(true);
+      if (location.pathname === '/') history.replaceState(null, '', '/projects');
+      store.set({ projectsHubRestoreRequested: false });
+      return;
+    }
+    if (!state.projectsHubVisible) return;
+    if (state.projectsHubList !== previous.projectsHubList || state.projectListLoaded !== previous.projectListLoaded ||
+        state.homeSurfaceLoaded !== previous.homeSurfaceLoaded || state.onboardingStep !== previous.onboardingStep ||
+        state.projectsAccessLoaded !== previous.projectsAccessLoaded || state.permissions !== previous.permissions ||
+        state.connected !== previous.connected || state.pendingHomeProjectSlug !== previous.pendingHomeProjectSlug) render();
+  });
+}

package/lib/public/style.css

@@ -57,3 +57,5 @@
 @import url("css/tui-attention.css?v=20260829-terminal-canvas1");
 @import url("css/pwa-mobile.css?v=20260824f");
 @import url("css/avatar-imprints.css?v=20260829-imprints1");
+
+@import url("css/projects-hub.css");

package/lib/sdk-bridge.js

@@ -670,6 +670,7 @@ function createSDKBridge(opts) {
       close_partner: true,
       record_partner_evaluation: true,
       respond_to_worker_permission: true,
+      respond_to_worker_question: true,
     };
     var pairDynamicTools = {
       propose_worker: true,
@@ -689,6 +690,7 @@ function createSDKBridge(opts) {
       close_partner: true,
       record_partner_evaluation: true,
       respond_to_worker_permission: true,
+      respond_to_worker_question: true,
     };
     if (toolName.indexOf("mcp__") === 0) {
       if (toolName.indexOf(PAIR_MCP_PREFIX) === 0

package/lib/server.js

@@ -814,7 +814,7 @@ function createServer(opts) {
 
     // Root path — render the default project workspace while keeping Home
     // available as an explicit client-side surface.
-    if (fullUrl === "/" && req.method === "GET") {
+    if ((fullUrl === "/" || fullUrl === "/projects" || fullUrl === "/projects/") && req.method === "GET") {
       if (!isRequestAuthed(req)) {
         res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
         res.end(auth.getAuthPage());

package/lib/users-home-surface-preferences.js

@@ -31,8 +31,8 @@ function attachHomeSurfacePreferences(deps) {
       if (!validId(mateIds[i]) || !validSessionReference(sessions[mateIds[i]])) continue;
       normalizedSessions[mateIds[i]] = sessions[mateIds[i]];
     }
-    return {
-      surface: source.surface === "home" || source.surface === "project" ? source.surface : null,
+    var result = {
+      surface: source.surface === "home" || source.surface === "project" || source.surface === "projects" ? source.surface : null,
       projectSlug: validProjectSlug(source.projectSlug) ? source.projectSlug : null,
       activeMateId: validId(source.activeMateId) ? source.activeMateId : null,
       activeSessionByMate: normalizedSessions,
@@ -41,6 +41,8 @@ function attachHomeSurfacePreferences(deps) {
       chatScope: source.chatScope === "current" ? "current" : "all",
       subSurface: source.subSurface === "debates" ? "debates" : "chat",
     };
+    if (["welcome", "project", "complete"].indexOf(source.onboardingStep) !== -1) result.onboardingStep = source.onboardingStep;
+    return result;
   }
 
   function loadSingleUserPreference() {

package/lib/users-preferences.js

@@ -484,40 +484,6 @@ function attachPreferences(deps) {
     return { error: "User not found" };
   }
 
-  // --- What's New seen ids ---
-  //
-  // Per-user list of dismissed "What's New" entry ids. The whats-new
-  // service uses this to filter unseen entries on connect. Ids are stable
-  // strings authored in lib/whats-new-content.js.
-
-  function getWhatsNewSeenIds(userId) {
-    var data = loadUsers();
-    for (var i = 0; i < data.users.length; i++) {
-      if (data.users[i].id === userId) {
-        var ids = data.users[i].whatsNewSeenIds;
-        return Array.isArray(ids) ? ids.slice() : [];
-      }
-    }
-    return [];
-  }
-
-  function markWhatsNewSeen(userId, entryId) {
-    if (!entryId || typeof entryId !== "string") return { error: "bad_id" };
-    var data = loadUsers();
-    for (var i = 0; i < data.users.length; i++) {
-      if (data.users[i].id === userId) {
-        var ids = Array.isArray(data.users[i].whatsNewSeenIds) ? data.users[i].whatsNewSeenIds.slice() : [];
-        if (ids.indexOf(entryId) === -1) {
-          ids.push(entryId);
-          data.users[i].whatsNewSeenIds = ids;
-          saveUsers(data);
-        }
-        return { ok: true, seenIds: ids };
-      }
-    }
-    return { error: "User not found" };
-  }
-
   // --- Mate onboarding ---
 
   function setMateOnboarded(userId) {
@@ -556,8 +522,6 @@ function attachPreferences(deps) {
     setMatesEnabled: setMatesEnabled,
     getToolPalettes: getToolPalettes,
     setToolPalette: setToolPalette,
-    getWhatsNewSeenIds: getWhatsNewSeenIds,
-    markWhatsNewSeen: markWhatsNewSeen,
     getTerminalFont: getTerminalFont,
     setTerminalFont: setTerminalFont,
     setMateOnboarded: setMateOnboarded,

package/lib/users.js

@@ -453,8 +453,6 @@ var getMatesEnabled = preferences.getMatesEnabled;
 var setMatesEnabled = preferences.setMatesEnabled;
 var getToolPalettes = preferences.getToolPalettes;
 var setToolPalette = preferences.setToolPalette;
-var getWhatsNewSeenIds = preferences.getWhatsNewSeenIds;
-var markWhatsNewSeen = preferences.markWhatsNewSeen;
 var getTerminalFont = preferences.getTerminalFont;
 var setTerminalFont = preferences.setTerminalFont;
 var setMateOnboarded = preferences.setMateOnboarded;
@@ -541,8 +539,6 @@ module.exports = {
   setCapsulesEnabled: setCapsulesEnabled,
   getToolPalettes: getToolPalettes,
   setToolPalette: setToolPalette,
-  getWhatsNewSeenIds: getWhatsNewSeenIds,
-  markWhatsNewSeen: markWhatsNewSeen,
   getTerminalFont: getTerminalFont,
   setTerminalFont: setTerminalFont,
   getHomeDockPreference: getHomeDockPreference,

package/lib/ws-schema.js

@@ -332,9 +332,6 @@ var schema = {
   // -----------------------------------------------------------------------
   // What's New
   // -----------------------------------------------------------------------
-  "whats_new_state":          { direction: "s2c", handler: "lib/public/modules/whats-new.js", description: "Unseen What's New entries for the connecting user" },
-  "whats_new_seen":           { direction: "c2s", handler: "lib/project-sessions.js", description: "Mark a What's New entry as dismissed by the current user" },
-  "whats_new_seen_result":    { direction: "s2c", handler: "lib/public/modules/whats-new.js", description: "Result of marking a What's New entry seen" },
   "home_dock_get":            { direction: "c2s", handler: "lib/server-home-preferences.js", description: "Request the current user's home dock preference" },
   "home_dock_set":            { direction: "c2s", handler: "lib/server-home-preferences.js", description: "Persist the current user's home dock preference" },
   "home_dock_state":          { direction: "s2c", handler: "lib/public/modules/home-dock.js", description: "Current user home dock preference" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clay-server",
-  "version": "4.6.1-beta.1",
+  "version": "4.7.0-beta.2",
   "description": "Self-hosted team workspace for Claude Code and Codex. Multi-user, browser-based, with persistent AI mates.",
   "bin": {
     "clay-server": "./bin/cli.js"

package/lib/public/modules/whats-new-article.js

@@ -1,70 +0,0 @@
-// What's New article viewer.
-//
-// A full-screen blog-style reader for a single What's New entry. Opened
-// from either:
-//   - the carousel popup ("Read more" jumps straight here)
-//   - the home page list of titles (click on a title)
-//
-// Closing returns the user to whichever surface was visible underneath
-// (home or a session). The viewer is a fixed-position overlay so we
-// don't need to track or restore the previous view ourselves - hiding
-// this element simply reveals the layer below.
-
-import { getKnownEntries } from './whats-new.js';
-
-var rootEl = null;
-var dateEl = null;
-var titleEl = null;
-var bodyEl = null;
-var backBtn = null;
-var keyHandlerBound = false;
-var visible = false;
-
-export function initWhatsNewArticle() {
-  rootEl = document.getElementById("whats-new-article");
-  if (!rootEl) return;
-  dateEl = document.getElementById("wna-date");
-  titleEl = document.getElementById("wna-title");
-  bodyEl = document.getElementById("wna-body");
-  backBtn = document.getElementById("wna-back");
-
-  if (backBtn) backBtn.addEventListener("click", function () { closeArticle(); });
-  if (!keyHandlerBound) {
-    document.addEventListener("keydown", function (ev) {
-      if (visible && ev.key === "Escape") {
-        ev.stopPropagation();
-        closeArticle();
-      }
-    });
-    keyHandlerBound = true;
-  }
-}
-
-export function openArticle(entryId) {
-  if (!rootEl) return;
-  var entries = getKnownEntries();
-  var entry = null;
-  for (var i = 0; i < entries.length; i++) {
-    if (entries[i] && entries[i].id === entryId) { entry = entries[i]; break; }
-  }
-  if (!entry) return;
-
-  if (dateEl) dateEl.textContent = entry.publishedAt || "";
-  if (titleEl) titleEl.textContent = entry.title || "";
-  if (bodyEl) bodyEl.innerHTML = (typeof entry.body === "string") ? entry.body : "";
-
-  rootEl.classList.remove("hidden");
-  // Scroll to top in case a previous article was open.
-  try { rootEl.scrollTop = 0; } catch (e) {}
-  visible = true;
-}
-
-export function closeArticle() {
-  if (!rootEl) return;
-  rootEl.classList.add("hidden");
-  visible = false;
-}
-
-export function isArticleVisible() {
-  return visible;
-}