clay-server 5.2.1-beta.2 → 5.3.0-beta.2

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

@@ -1,3 +1,5 @@
+import { showCreatedWorkerPresentation } from './worker-created-presentation.js';
+import { handleWorkerRemovalResult } from './split-view-worker-removal.js';
 import { handleStudioDocumentMessage } from './clay-studio-document.js';
 import { saveSessionRichDraft, restoreSessionRichDraft } from './session-rich-drafts.js';
 import { refreshPaneActivation, primePaneSession } from './pane-activation.js';
@@ -48,11 +50,13 @@ import { handleDefaultVendorMessage } from './default-vendor.js';
 import { handleContextViewMessage } from './context-view-preference.js';
 import { handleHomeMateMemoryState, handleHomeMateKnowledgeState, syncHomeMateSettingsTarget, handleHomeMateAvatarError } from './home-mate-settings.js';
 import { renderKnowledgeList, handleKnowledgeContent, handleKnowledgeMutation } from './mate-knowledge.js';
-import { handleKnowledgeWorkbenchMessage } from './mate-knowledge-workbench.js';
+import { handleKnowledgeWorkbenchMessage } from './knowledge-workbench-entry.js';
 import { renderMemoryList } from './mate-memory.js';
 import { handlePaletteSessionSwitch, handlePaletteHistoryDone, handlePaletteHistoryPrepended, setPaletteVersion } from './command-palette.js';
 import { handleFindInSessionResults } from './session-search.js';
 import { syncPaneTitles, maybeRestoreSplitGroup, openGroup } from './split-view.js';
+import { handleProjectSplitViews, handleProjectSplitViewResult, requestProjectSplitViews } from './split-view-presentations.js';
+import { handleSplitWorkerConversation, handleWorkerSessionActivity, handleWorkerConversationChanged } from './split-view-workers.js';
 import { showPairDialog, handlePairCreated, handleSplitDelegation, showWorkerDelegationNotice, hideWorkerDelegationNotice } from './split-pair-ui.js';
 import { handleSessionActionMessage } from './session-actions.js';
 import { renderWorkerProposal, updateWorkerProposal } from './worker-proposal.js';
@@ -95,7 +99,7 @@ import { clearPairResultStatus, handlePairResultStatus } from './pair-result-sta
 import { scrollToBottom, addToMessages, addUserMessage, addSystemMessage, removeMatePreThinking, resetStreamBuffer, appendDelta, flushStreamBuffer, finalizeAssistantBlock, addConflictMessage, addContextOverflowMessage, showSuggestionChips, armStickyBottom, VENDOR_AVATARS, VENDOR_NAMES } from './app-rendering.js';
 import { setActivity, startUrgentBlink, stopUrgentBlink, blinkSessionDot, updateCrossProjectBlink } from './app-favicon.js';
 import { setStatus } from './app-connection.js';
-import { resolvePaneSession, resolveSwitchedVendor } from './pane-session.js';
+import { resolveSwitchedVendor } from './pane-session.js';
 import { markProjectSessionListHydrated, applyProjectSplitGroups, clearProjectSplitState } from './split-session-boundary.js';
 import { selectDefaultVendorForBlankSession } from './vendor-selection.js';
 import { getModelInfoUpdate, modelEntryValue, modelEntryMatches, handleModelSelectionResult, requestVendorModels } from './model-picker.js';
@@ -440,6 +444,7 @@ export function processMessage(msg) {
         if (msg.projectOwnerId !== undefined) store.set({ currentProjectOwnerId: msg.projectOwnerId });
         if (msg.ownerLocked !== undefined) store.set({ ownerLocked: !!msg.ownerLocked });
         if (msg.osUsers !== undefined) store.set({ isOsUsers: !!msg.osUsers });
+        store.set({ paneOsIdentity: msg.paneOsIdentity || null });
         if (msg.lanHost) window.__lanHost = msg.lanHost;
         store.set({ skipPermsEnabled: msg.dangerouslySkipPermissions === true });
         var spBanner = document.getElementById("skip-perms-pill");
@@ -785,19 +790,31 @@ export function processMessage(msg) {
         renderMateSessionList(msg.sessions || []);
         renderSessionList(msg.sessions || []);
         store.set({ paneBindingSessions: msg.sessions || [] });
+        requestProjectSplitViews();
         refreshPaneActivation();
         syncGithubSessions(msg.sessions || []);
         syncPaneTitles();
-        var panePin = resolvePaneSession(store.get('paneMode') && !primePaneSession(), store.get('panePinPending'), store.get('paneSessionId'), msg.sessions);
-        if (panePin.consumed) {
-          store.set({ panePinPending: false });
-          if (panePin.sessionId && getWs() && getWs().readyState === 1) {
-            getWs().send(JSON.stringify({ type: "switch_session", id: panePin.sessionId }));
-          }
+        if (store.get('paneMode')) {
+          // A pane pin must use the authenticated activation binding. Sending
+          // this startup URL's session as a plain switch can race a parent
+          // retarget and restore the iframe's stale initial session.
+          primePaneSession();
         }
         handlePaletteSessionSwitch();
         maybeRestoreSplitGroup();
         break;
+      case "project_split_views":
+        handleProjectSplitViews(msg);
+        break;
+      case "project_split_view_result":
+        handleProjectSplitViewResult(msg);
+        break;
+      case "split_worker_conversation_changed":
+        handleWorkerConversationChanged(msg);
+        break;
+      case "split_worker_conversation":
+        handleSplitWorkerConversation(msg);
+        break;
       case "session_github_status":
         applyGithubPersonalReviewStatus(msg);
         break;
@@ -813,6 +830,10 @@ export function processMessage(msg) {
         if (!msg.ok && msg.error) showToast(msg.error, "error");
         break;
 
+      case "split_worker_remove_result":
+        handleWorkerRemovalResult(msg);
+        break;
+
       case "split_worker_close_result":
         if (!msg.ok && msg.error) showToast(msg.error, "error");
         break;
@@ -823,7 +844,7 @@ export function processMessage(msg) {
 
       case "pair_session_created":
         var createdPairGroup = handlePairCreated(msg);
-        if (createdPairGroup) openGroup(createdPairGroup);
+        if (createdPairGroup) showCreatedWorkerPresentation(createdPairGroup);
         break;
 
       case "session_handoff_result":
@@ -898,6 +919,7 @@ export function processMessage(msg) {
 
       case "session_io":
         blinkSessionDot(msg.id);
+        handleWorkerSessionActivity(msg);
         break;
 
       case "session_unread":

package/lib/public/modules/chat-render-runtime.js

@@ -60,6 +60,32 @@ var stickyBottomCeilingMs = 8000;
 var stickyBottomResizeObs = null;
 var stickyBottomInputBound = false;
 
+function layoutScrollLock() { return store.get('paneLayoutScrollLock'); }
+
+export function beginPaneLayoutScrollLock(token, scrollTop) {
+  var messagesEl = getMessagesEl();
+  if (!messagesEl || !token) return false;
+  disarmStickyBottom();
+  var userPosition = store.get('paneLastUserScrollTop');
+  var position = Number.isFinite(userPosition) ? userPosition : Number.isFinite(scrollTop) ? Math.max(0, scrollTop) : messagesEl.scrollTop;
+  store.set({ paneLayoutScrollLock: { token: token, scrollTop: position } });
+  messagesEl.scrollTop = position;
+  return true;
+}
+
+export function endPaneLayoutScrollLock(token) {
+  var state = layoutScrollLock(), messagesEl = getMessagesEl();
+  if (!state || state.token !== token || !messagesEl) return false;
+  requestAnimationFrame(function () {
+    var current = layoutScrollLock();
+    if (!current || current.token !== token || !messagesEl.isConnected) return;
+    disarmStickyBottom();
+    messagesEl.scrollTop = current.scrollTop;
+    store.set({ paneLayoutScrollLock: null });
+  });
+  return true;
+}
+
 export function getStickyBottom() { return stickyBottom; }
 
 function pinToBottomNow() {
@@ -95,6 +121,7 @@ function ensureStickyInfrastructure() {
 }
 
 export function armStickyBottom(durationMs) {
+  if (layoutScrollLock()) return;
   if (prependAnchor) return;
   ensureStickyInfrastructure();
   stickyBottom = true;
@@ -128,6 +155,22 @@ export function disarmStickyBottom() {
 }
 
 export function initRendering() {
+  var messagesEl = getMessagesEl();
+  if (messagesEl && !messagesEl.__paneLayoutScrollLockListener) {
+    messagesEl.__paneLayoutScrollLockListener = true;
+    messagesEl.addEventListener('wheel', function () {
+      var revision = (store.get('paneUserScrollRevision') || 0) + 1;
+      store.set({ paneUserScrollRevision: revision, paneUserScrollIntent: revision });
+      requestAnimationFrame(function () {
+        if (store.get('paneUserScrollIntent') === revision) store.set({ paneUserScrollIntent: null });
+      });
+    }, { passive: true });
+    messagesEl.addEventListener('scroll', function () {
+      var state = layoutScrollLock();
+      if (state) store.set({ paneLayoutScrollLock: Object.assign({}, state, { scrollTop: messagesEl.scrollTop }) });
+      if (store.get('paneUserScrollIntent') != null) store.set({ paneLastUserScrollTop: messagesEl.scrollTop, paneUserScrollIntent: null });
+    }, { passive: true });
+  }
   var lastAssistantPlaceholder = '';
   function updateInputPlaceholder(state) {
     var inputEl = document.getElementById("input");
@@ -162,6 +205,7 @@ export function addToMessages(element) {
   if (prependAnchor) messagesEl.insertBefore(element, prependAnchor);
   else messagesEl.appendChild(element);
   keepActiveThinkingAtTail();
+  if (stickyBottomResizeObs && stickyBottom) stickyBottomResizeObs.observe(element);
 }
 
 export function addHistoryIndex(element, historyIndex) {
@@ -200,9 +244,15 @@ export function keepActiveThinkingAtTail() {
 }
 
 export function scrollToBottom() {
+  if (layoutScrollLock()) return;
   if (prependAnchor || store.get('replayingHistory')) return;
   var messagesEl = getMessagesEl();
   if (!messagesEl) return;
+  if (stickyBottom) {
+    pinToBottomNow();
+    requestAnimationFrame(function () { if (stickyBottom && !layoutScrollLock()) pinToBottomNow(); });
+    return;
+  }
   var distFromBottom = messagesEl.scrollHeight - messagesEl.scrollTop - messagesEl.clientHeight;
   if (distFromBottom > 150 || isUserScrolledUp) {
     if (distFromBottom > 150) isUserScrolledUp = true;
@@ -214,6 +264,7 @@ export function scrollToBottom() {
     return;
   }
   requestAnimationFrame(function () {
+    if (layoutScrollLock()) return;
     var dist = messagesEl.scrollHeight - messagesEl.scrollTop - messagesEl.clientHeight;
     if (dist > 150) {
       isUserScrolledUp = true;
@@ -225,7 +276,10 @@ export function scrollToBottom() {
 
 export function forceScrollToBottom() {
   if (prependAnchor || store.get('replayingHistory')) return;
+  // An explicit new turn supersedes a layout-only scroll receipt.
+  if (layoutScrollLock()) store.set({ paneLayoutScrollLock: null });
   armStickyBottom(750);
+  requestAnimationFrame(function () { if (stickyBottom && !layoutScrollLock()) pinToBottomNow(); });
 }
 
 export function getMsgTime() {

package/lib/public/modules/clay-control-copy.js

@@ -8,6 +8,7 @@ var actions = {
   runtime: 'return this conversation to GUI chat', queue_add: 'queue the reviewed message for the Driver',
   queue_edit: 'update the reviewed queued message', queue_cancel: 'cancel the reviewed queued message',
   queue_reorder: 'reorder the reviewed message queue', navigate: 'open the reviewed conversation so we can continue there',
+  split_view: 'change the reviewed Split view',
   dismiss_notifications: 'dismiss the reviewed notifications', profile: 'update the reviewed Mate profile',
   send: 'deliver the reviewed message to this Mate', assign: 'prepare the requested Driver work for your review', follow_up: 'prepare a follow-up for the existing Driver', document: 'open the requested document for editing', sketch: 'present the requested sketch', browser: 'operate the requested shared browser tab'
 };
@@ -20,6 +21,8 @@ export function activityCopy(msg) {
     rendered: 'The reviewed conversation is visibly open in the selected window.',
     cancelled: 'I left the change unapplied.', failed: 'I could not finish this change. Please check the result before trying again.',
     partial: 'Part of this change took effect, but the operation failed. Please check the result.', unknown: 'I cannot confirm the outcome. Please check before trying again.' };
+  if (msg.domain === 'screen' && msg.action === 'split_view' && msg.phase === 'acknowledged') return 'I started opening the reviewed Split view. Its visible result is still unconfirmed.';
+  if (msg.domain === 'screen' && msg.action === 'split_view' && msg.phase === 'rendered') return 'The reviewed Split view and ready panes are visibly open in the selected window.';
   if (msg.domain === 'assignment') { var work = { review: 'I prepared the Driver work. Please review its proposal before it starts.', queued: 'I submitted the approved Driver work for dispatch.', running: 'The Driver is working on the approved request.', completed: 'The Driver finished this request.', cancelled: 'I left this Driver request unapplied.', unknown: 'I cannot confirm the Driver outcome. Please inspect the work before retrying.' }; return work[msg.phase] || endings[msg.phase] || null; }
   if (msg.domain === 'studio' && msg.phase === 'rendered') return 'The requested workbench content is visibly rendered in this window.';
   if (msg.domain === 'studio' && msg.phase === 'render_unknown') return 'The service returned, but I could not confirm that the workbench content is visible.';

package/lib/public/modules/clay-navigation-render.js

@@ -1,7 +1,7 @@
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 
-function visible(element) {
+export function visible(element) {
   if (!element || !element.isConnected || element.closest('[hidden], [inert], [aria-hidden="true"]')) return false;
   var box = element.getBoundingClientRect(), style = getComputedStyle(element);
   if (style.visibility !== 'visible' || Number(style.opacity) === 0 || box.width <= 0 || box.height <= 0) return false;

package/lib/public/modules/clay-owner-navigation.js

@@ -1,26 +1,34 @@
+import { handleSplitViewProbe, splitViewScreenSnapshot, applySplitViewNavigation, observeSplitViewRendering } from './clay-split-view-screen.js';
 import { observeNavigationRendering } from './clay-navigation-render.js';
 import { showClayNavigationActivity, clearClayControlActivity } from './clay-control-activity.js';
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { navigateToSession } from './command-palette.js';
+var offerSocket = null;
 function context() {
-  return JSON.stringify([store.get('currentSlug'), store.get('activeSessionId'), store.get('dmMode'), store.get('homeShellVisible'), store.get('homeChatMateId'), store.get('homeChatSessionId'), store.get('homeSubSurface'), (store.get('contextualClay') || {}).mode]);
+  return JSON.stringify([store.get('currentSlug'), store.get('activeSessionId'), store.get('dmMode'), store.get('homeShellVisible'), store.get('homeChatMateId'), store.get('homeChatSessionId'), store.get('homeSubSurface'), (store.get('contextualClay') || {}).mode, splitViewScreenSnapshot()]);
 }
 export function handleOwnerNavigation(msg) {
+  if (handleSplitViewProbe(msg)) return true;
   if (msg.type !== 'clay_navigation_offer' && msg.type !== 'clay_navigation_apply') return false;
   var ws = getWs();
   if (!ws || ws.readyState !== 1) return true;
   if (msg.type === 'clay_navigation_offer') {
     if (document.hidden || store.get('paneMode')) return true;
-    store.set({ clayNavigationOffer: { id: msg.deliveryId, context: context(), socket: ws } });
+    offerSocket = ws;
+    store.set({ clayNavigationOffer: { id: msg.deliveryId, context: context() } });
     ws.send(JSON.stringify({ type: 'clay_navigation_claim', deliveryId: msg.deliveryId }));
     return true;
   }
   var offer = store.get('clayNavigationOffer');
   store.set({ clayNavigationOffer: null });
-  var accepted = offer && offer.id === msg.deliveryId && offer.socket === ws && offer.context === context() && !document.hidden && !store.get('paneMode');
+  var accepted = offer && offer.id === msg.deliveryId && offerSocket === ws && offer.context === context() && !document.hidden && !store.get('paneMode');
+  offerSocket = null;
   var status = 'refused';
-  if (accepted && msg.target && typeof msg.target.projectSlug === 'string' && Number.isSafeInteger(msg.target.sessionId)) {
+  if (accepted && msg.target && msg.target.surface === 'split_view') {
+    try { status = applySplitViewNavigation(msg.target) ? 'accepted' : 'refused'; } catch (error) { status = 'failed'; }
+  }
+  if (accepted && msg.target && msg.target.surface !== 'split_view' && typeof msg.target.projectSlug === 'string' && Number.isSafeInteger(msg.target.sessionId)) {
     try {
       showClayNavigationActivity(msg.target, false); navigateToSession(msg.target, null, msg.target.entryIndex); status = 'accepted';
     } catch (error) { showClayNavigationActivity(msg.target, true); status = 'failed'; }
@@ -28,6 +36,8 @@ export function handleOwnerNavigation(msg) {
   if (status === 'refused') clearClayControlActivity();
   // This acknowledges navigator invocation only. Rendering may finish after reconnect.
   if (ws.readyState === 1) ws.send(JSON.stringify({ type: 'clay_navigation_ack', deliveryId: msg.deliveryId, status: status }));
-  if (status === 'accepted') observeNavigationRendering(msg, ws);
+  if (status === 'accepted') {
+    if (msg.target.surface === 'split_view') observeSplitViewRendering(msg, ws); else observeNavigationRendering(msg, ws);
+  }
   return true;
 }

package/lib/public/modules/clay-split-view-screen.js

@@ -0,0 +1,74 @@
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { livePaneBinding } from './pane-binding.js';
+import { applyReviewedSplitView } from './split-view-presentations.js';
+import { visible } from './clay-navigation-render.js';
+
+var attempts = new Map();
+export function splitViewScreenSnapshot() {
+  var state = store.snap();
+  var view = (state.projectSplitViews || []).find(function (item) { return item.id === state.projectSplitViewActiveId; });
+  var hidden = !!(document.hidden || state.paneMode || !state.connected || state.dmMode || state.homeShellVisible);
+  return { projectSlug: state.currentSlug || null, ownerId: state.myUserId || null, hidden: hidden,
+    viewId: view ? view.id : null, revision: view ? view.revision : 0, tree: view ? view.tree : null,
+    focusOrigin: state.projectSplitViewFocusedOrigin || null, singletonOrigin: state.projectSplitViewSingletonOrigin || null,
+    activeSessionId: state.activeSessionId || null,
+    panes: Array.from(document.querySelectorAll('.split-pane-frame')).slice(0, 32).map(function (frame) {
+      var live = frame.clayPane && frame.clayPane.identity(), binding = live && live.binding;
+      var ready = !!livePaneBinding(frame), cached = !!frame.closest('.split-pane-cached');
+      return { origin: frame.dataset.sessionOriginId || '', sessionId: Number(frame.dataset.sessionId) || 0,
+        visible: !hidden && !cached && visible(frame), cached: cached, ready: ready,
+        binding: ready && binding ? { requestId: binding.requestId, generation: binding.generation, sessionId: binding.sessionId, sessionOriginId: binding.sessionOriginId } : null };
+    }) };
+}
+function stableObservation(key, socket, deadline, complete, ready) {
+  if (attempts.has(key)) return;
+  if (attempts.size >= 32) return;
+  var animation, timer, previous, stable = 0, owner = store.get('myUserId'), slug = store.get('currentSlug'), ended = false;
+  function finish(snapshot) {
+    if (ended) return;
+    ended = true; clearTimeout(timer); cancelAnimationFrame(animation); attempts.delete(key);
+    document.removeEventListener('click', stop, true); document.removeEventListener('visibilitychange', hidden);
+    if (getWs() === socket && socket.readyState === 1) complete(snapshot);
+  }
+  function stop(event) { if (event.target.closest('#generation-stop, #autonomous-run-stop, #send-btn.stop')) finish(null); }
+  function hidden() { if (document.hidden) finish(null); }
+  document.addEventListener('click', stop, true); document.addEventListener('visibilitychange', hidden);
+  attempts.set(key, finish);
+  timer = setTimeout(function () { finish(null); }, Math.max(0, Math.min(5000, deadline - Date.now())));
+  function inspect() {
+    if (ended) return;
+    if (getWs() !== socket || !store.get('connected') || store.get('myUserId') !== owner || store.get('currentSlug') !== slug) { finish(null); return; }
+    var snapshot = splitViewScreenSnapshot(), serialized = JSON.stringify(snapshot);
+    stable = previous === serialized ? stable + 1 : 1; previous = serialized;
+    if (stable >= 2 && (!ready || ready(snapshot))) finish(snapshot); else animation = requestAnimationFrame(inspect);
+  }
+  animation = requestAnimationFrame(inspect);
+}
+export function handleSplitViewProbe(msg) {
+  if (msg.type !== 'clay_view_probe') return false;
+  var socket = getWs();
+  if (!socket || socket.readyState !== 1 || store.get('paneMode')) return true;
+  stableObservation(msg.probeId, socket, Date.now() + 4500, function (snapshot) {
+    socket.send(JSON.stringify({ type: 'clay_view_observed', probeId: msg.probeId, snapshot: snapshot }));
+  });
+  return true;
+}
+export function applySplitViewNavigation(target) {
+  if (JSON.stringify(splitViewScreenSnapshot()) !== JSON.stringify(target.expectedScreen)) return false;
+  return applyReviewedSplitView(target);
+}
+function renderedTarget(snapshot, target) {
+  var exact = snapshot && !snapshot.hidden && snapshot.viewId === target.view.id && snapshot.revision === target.view.revision &&
+    snapshot.focusOrigin === target.focusOrigin && JSON.stringify(snapshot.tree) === JSON.stringify(target.view.tree);
+  var expected = target.view.sessions.filter(function (session) { return !target.focusOrigin || session.sessionOriginId === target.focusOrigin; });
+  var shown = snapshot ? snapshot.panes.filter(function (pane) { return pane.visible; }) : [];
+  return !!(exact && shown.length === expected.length && expected.every(function (session) { return shown.some(function (pane) { return pane.origin === session.sessionOriginId && pane.sessionId === session.id && pane.ready && !pane.cached; }); }));
+}
+export function observeSplitViewRendering(msg, socket) {
+  var target = msg.target;
+  stableObservation(msg.deliveryId, socket, msg.renderDeadline, function (snapshot) {
+    socket.send(JSON.stringify({ type: 'clay_navigation_rendered', deliveryId: msg.deliveryId, renderToken: msg.renderToken,
+      surface: 'split_view', visible: renderedTarget(snapshot, target), snapshot: snapshot || splitViewScreenSnapshot() }));
+  }, function (snapshot) { return renderedTarget(snapshot, target); });
+}

package/lib/public/modules/clay-tool-activity.js

@@ -17,6 +17,11 @@ export function syncToolGroupDisclosure(el) {
   var expanded = !el.classList.contains('collapsed');
   el.querySelector('.tool-group-header').setAttribute('aria-expanded', String(expanded));
   var items = el.querySelector('.tool-group-items');
+  if (el.classList.contains('popup-chat-activity') && typeof document !== 'undefined' && document.body && document.body.classList.contains('popup-chat-rendering')) {
+    items.inert = false;
+    items.setAttribute('aria-hidden', 'false');
+    return;
+  }
   items.inert = !expanded;
   items.setAttribute('aria-hidden', String(!expanded));
 }

package/lib/public/modules/command-palette.js

@@ -1,3 +1,4 @@
+import { formatRelativeDate, paletteSelectionIndex } from './palette-render-helpers.js';
 import { forwardContextualSessionCitation, validContextualCitation, contextualCitationLink } from './contextual-session-citations.js';
 import { mateAvatarUrl } from './avatar.js';
 import { escapeHtml } from './utils.js';
@@ -7,23 +8,10 @@ import { startSearchClayChat, retrySearchClayAsk } from './search-clay-chat.js';
 import { getWs } from './ws-ref.js';
 import { openProjectLog } from './project-logs.js';
 import { store } from './store.js';
+import { initSearchHints, setSearchHintsPaletteOpen } from './search-hints.js';
+import { openPaletteClayConversation } from './palette-clay-conversation.js';
 import { disarmStickyBottom } from './chat-render-runtime.js';
 
-function formatRelativeDate(ts) {
-  if (!ts) return "";
-  var diff = Math.max(0, Date.now() - ts);
-  var min = Math.floor(diff / 60000);
-  if (min < 1) return "just now";
-  if (min < 60) return min + "m ago";
-  var hr = Math.floor(min / 60);
-  if (hr < 24) return hr + "h ago";
-  var days = Math.floor(hr / 24);
-  if (days < 7) return days + "d ago";
-  if (days < 30) return Math.floor(days / 7) + "w ago";
-  var d = new Date(ts);
-  var months = ["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];
-  return months[d.getMonth()] + " " + d.getDate() + ", " + d.getFullYear();
-}
 
 var ctx;
 var paletteEl = null, inputEl = null, resultsEl = null, footerEl = null;
@@ -34,12 +22,14 @@ var searchResults = [], searchQuery = "", searchPending = false;
 
 export function initCommandPalette(value) {
   ctx = value;
+  if (paletteEl) return;
   buildDOM();
   // The palette dialog stops bubbling so backdrop clicks cannot close it.
   // Capture session controls before that boundary; the same handler also
   // serves links rendered in the full Home transcript.
   document.addEventListener("click", handleClaySessionLinkClick, true);
   var trigger = document.getElementById("cmd-palette-btn");
+  initSearchHints(trigger, inputEl);
   if (trigger) {
     var isMac = navigator.platform.indexOf("Mac") !== -1;
     var kbd = trigger.querySelector(".cmd-palette-searchbar-kbd");
@@ -154,6 +144,7 @@ export function isCommandPaletteOpen() { return paletteEl && !paletteEl.classLis
 export function openCommandPalette() {
   if (!paletteEl) return;
   paletteEl.classList.remove("hidden");
+  setSearchHintsPaletteOpen(true);
   var trigger = document.getElementById("cmd-palette-btn");
   if (trigger) trigger.style.visibility = "hidden";
   updateFooter();
@@ -162,8 +153,10 @@ export function openCommandPalette() {
 }
 
 export function closeCommandPalette() {
+  if ((store.get('paletteClayConversation') || {}).phase === 'resolving') store.set({ paletteClayConversation: null });
   if (!paletteEl) return;
   paletteEl.classList.add("hidden");
+  setSearchHintsPaletteOpen(false);
   var trigger = document.getElementById("cmd-palette-btn");
   if (trigger) trigger.style.visibility = "";
   if (debounceTimer) { clearTimeout(debounceTimer); debounceTimer = null; }
@@ -297,7 +290,7 @@ function buildDOM() {
       '<div class="cmd-palette-input-row">' +
         '<img class="cmd-palette-input-brand" src="/clay-studio-symbol.png" width="22" height="22" alt="">' +
         '<i data-lucide="search" aria-hidden="true"></i>' +
-        '<input class="cmd-palette-input" type="text" placeholder="Search conversations, or ask Clay…" autocomplete="off" spellcheck="false" />' +
+        '<input class="cmd-palette-input" type="text" aria-label="Search or ask Clay" placeholder="Search or ask Clay, like “What was I working on recently?”" autocomplete="off" spellcheck="false" />' +
         '<button type="button" class="cmd-palette-kbd" id="cmd-palette-close" aria-label="Close search"><i data-lucide="x"></i></button>' +
       '</div>' +
       '<div class="cmd-palette-results"></div>' +
@@ -313,11 +306,13 @@ function buildDOM() {
   inputEl.addEventListener("input", function () {
     var query = inputEl.value.trim();
     searchQuery = query;
+    if (abortCtrl) { abortCtrl.abort(); abortCtrl = null; }
     searchResults = [];
     searchPending = !!query;
     renderSearch();
     if (debounceTimer) clearTimeout(debounceTimer);
     if (query) debounceTimer = setTimeout(function () { fetchHomeSearchResults(query); }, 250);
+    else fetchHomeData();
   });
   inputEl.addEventListener("keydown", function (event) {
     if (event.key === "Escape") { event.preventDefault(); closeCommandPalette(); return; }
@@ -347,13 +342,15 @@ function updateFooter() {
 function fetchHomeData() {
   if (cachedHomeData.length) { renderSearch(); return; }
   if (abortCtrl) abortCtrl.abort();
-  abortCtrl = new AbortController();
+  var request = abortCtrl = new AbortController();
   fetch("/api/palette/search", { signal: abortCtrl.signal }).then(function (res) { return res.json(); }).then(function (data) {
+    if (abortCtrl !== request) return;
     abortCtrl = null;
     cachedHomeData = data.results || [];
     renderSearch();
   }).catch(function (error) {
     if (error.name === "AbortError") return;
+    if (abortCtrl !== request) return;
     abortCtrl = null;
     cachedHomeData = [];
     renderSearch();
@@ -362,8 +359,9 @@ function fetchHomeData() {
 
 function fetchHomeSearchResults(query) {
   if (abortCtrl) abortCtrl.abort();
-  abortCtrl = new AbortController();
+  var request = abortCtrl = new AbortController();
   fetch("/api/palette/search?q=" + encodeURIComponent(query), { signal: abortCtrl.signal }).then(function (res) { return res.json(); }).then(function (data) {
+    if (abortCtrl !== request) return;
     abortCtrl = null;
     if (searchQuery !== query) return;
     searchResults = data.results || [];
@@ -371,6 +369,7 @@ function fetchHomeSearchResults(query) {
     renderSearch();
   }).catch(function (error) {
     if (error.name === "AbortError") return;
+    if (abortCtrl !== request) return;
     abortCtrl = null;
     if (searchQuery !== query) return;
     searchPending = false;
@@ -396,6 +395,7 @@ function sessionIcon(session) {
 }
 
 function renderSearch() {
+  var previous = items[activeIndex];
   var query = searchQuery.toLowerCase();
   var sessions = query ? cachedHomeData.filter(function (item) {
     return (item.sessionTitle || "").toLowerCase().indexOf(query) !== -1 || (item.projectTitle || "").toLowerCase().indexOf(query) !== -1;
@@ -410,6 +410,11 @@ function renderSearch() {
     items.push({ type: 'retry-clay-ask' });
     html += renderItem(index++, '<img src="/clay-studio-symbol.png" width="22" height="22" alt="">', 'Retry previous question', escapeHtml(pendingAsk.text), null, null, ' is-retry-clay-ask');
   }
+  if (query) {
+    items.push({ type: "ask-clay", query: searchQuery });
+    html += '<div class="cmd-palette-group-label">Ask Clay</div>';
+    html += renderItem(index++, '<img src="/clay-studio-symbol.png" width="22" height="22" alt="">', 'Ask Clay about “' + escapeHtml(searchQuery) + '”', "Start a new Clay conversation", null, null, " is-ask-clay");
+  }
   if (sessions.length) {
     html += '<div class="cmd-palette-group-label">' + (query ? "Conversations" : "Recent conversations") + '</div>';
     for (var s = 0; s < sessions.length; s++) {
@@ -420,17 +425,13 @@ function renderSearch() {
       html += renderItem(index++, sessionIcon(session), escapeHtml(session.sessionTitle || "New Chat"), project, snippet, session.lastActivity, "");
     }
   }
-  if (query) {
-    items.push({ type: "ask-clay", query: searchQuery });
-    if (!sessions.length && !searchPending) html += '<div class="cmd-palette-exact-empty">No exact matches. Clay can search by meaning.</div>';
-    html += '<div class="cmd-palette-group-label">Ask Clay</div>';
-    html += renderItem(index, '<img src="/clay-studio-symbol.png" width="22" height="22" alt="">', 'Ask Clay about “' + escapeHtml(searchQuery) + '”', "Start a new Clay conversation", null, null, " is-ask-clay");
-  }
+  if (query && !sessions.length && !searchPending) html += '<div class="cmd-palette-exact-empty">No exact matches. Clay can search by meaning.</div>';
   if (!html) html = '<div class="cmd-palette-empty">No conversations yet.</div>';
   resultsEl.innerHTML = html;
-  activeIndex = -1;
+  activeIndex = paletteSelectionIndex(previous, items, query);
   refreshIcons();
   bindItemEvents();
+  if (activeIndex >= 0) setActive(activeIndex, true);
 }
 
 function renderItem(index, icon, title, desc, snippet, timestamp, extraClass) {
@@ -455,16 +456,17 @@ function setActive(index, skipScroll) {
   for (var i = 0; i < elements.length; i++) elements[i].classList.toggle("active", i === index);
   if (!skipScroll && elements[index]) elements[index].scrollIntoView({ block: "nearest" });
 }
-
 function beginClayChat(query) {
   if (!isCommandPaletteOpen()) return;
   if (startSearchClayChat(query)) closeCommandPalette();
 }
-
 function activateItem(entry) {
   if (entry.type === 'retry-clay-ask') { if (retrySearchClayAsk()) closeCommandPalette(); return; }
   if (entry.type === "ask-clay") { beginClayChat(entry.query); return; }
-  if (entry.type === "mate-session" || entry.type === "session") navigateToSession(entry.data, entry.query);
+  if (entry.type === "mate-session" || entry.type === "session") {
+    if (!store.get('paneMode') && (entry.data.isMate || /^mate-/.test(entry.data.projectSlug)) && openPaletteClayConversation(entry.data, entry.query, entry.data.entryIndex)) return;
+    navigateToSession(entry.data, entry.query, entry.data.entryIndex);
+  }
 }
 
 export function navigateToSession(item, query, entryIndex) {

package/lib/public/modules/contextual-clay-session.js

@@ -1,16 +1,28 @@
 // Session identity remains pinned across transport recovery and presentation.
+import { navigateToSession } from './command-palette.js';
 import { autoResize, takeComposerDraft, restoreComposerDraft } from './input.js';
 import { store } from './store.js';
 import { withdrawPaneControlActivity } from './clay-control-activity.js';
 import { initContextualComposer } from './contextual-composer.js';
 import { submitContextualAsk, pauseContextualAsk, stopContextualAsk } from './contextual-ask-session.js';
+import { resolveProjectAssistantIdentity } from './project-chat-identity.js';
+import { setPopupChatRendering, popupChatContextIsReady } from './popup-chat-rendering.js';
+import { syncPopupChatToolGroups } from './tools.js';
 
 // Session replay and authenticated account bootstrap complete independently.
 function submissionReady() { var expected = window.frameElement && window.frameElement.dataset.expectedSessionOrigin; return (!expected || expected === store.get('sessionOriginId')) && !!(store.get('contextualSessionReady') && store.get('connected') && store.get('myUserId') && store.get('sessionOriginId') && store.get('activeSessionId') === store.get('paneSessionId')); }
 function enabled() { return store.get('paneMode') && new URLSearchParams(location.search).get('contextual') === '1'; }
-function renderSessionAvailability() {
+function renderSessionAvailability(notifyReady) {
   var input = document.getElementById('input');
   var frame = window.frameElement;
+  var state = store.snap();
+  var identity = resolveProjectAssistantIdentity();
+  if (state.contextualSessionReady && frame && !frame.hidden) frame.dataset.sessionId = String(state.paneSessionId);
+  var popupSurface = null;
+  try { popupSurface = window.parent.document.getElementById('contextual-clay'); } catch (error) { /* Popup rendering stays native outside its authenticated parent surface. */ }
+  var popupReady = popupChatContextIsReady(document.body, state, frame, identity, popupSurface);
+  setPopupChatRendering(popupReady);
+  syncPopupChatToolGroups(popupReady);
   var mate = frame && (store.get('cachedMatesList') || []).find(function (item) { return item.id === frame.dataset.mateId; });
   var name = mate && ((mate.profile || {}).displayName || mate.displayName || mate.name);
   if (input && name) { input.setAttribute('aria-label', 'Message ' + name); if (name.length > 32) input.placeholder = 'Message this Mate…'; }
@@ -24,7 +36,7 @@ function renderSessionAvailability() {
       if (surface.dataset.mode === 'popover' && window.parent.document.activeElement === anchor) document.getElementById('input').focus({ preventScroll: true });
     }
   } catch (error) { /* Cross-origin authentication owns focus. */ }
-  if (store.get('contextualSessionReady') && window.frameElement && !window.frameElement.hidden) {
+  if (notifyReady !== false && store.get('contextualSessionReady') && window.frameElement && !window.frameElement.hidden) {
     window.frameElement.dataset.sessionId = String(store.get('paneSessionId'));
     var parentSurface = window.parent.document.getElementById('contextual-clay');
     if (parentSurface) parentSurface.dispatchEvent(new window.parent.CustomEvent('contextual-clay-ready'));
@@ -67,8 +79,20 @@ export function initContextualSession() {
     } catch (error) { /* Authentication navigation owns its document. */ }
   });
   var surfaceBridge = window.parent.document.getElementById('contextual-clay');
+  if (window.frameElement && surfaceBridge && typeof MutationObserver !== 'undefined') {
+    // Visibility changes update presentation and focus, never session readiness.
+    // A ready notification renders the parent, which can mutate these attributes.
+    var popupVisibilityObserver = new MutationObserver(function () { renderSessionAvailability(false); });
+    popupVisibilityObserver.observe(window.frameElement, { attributes: true, attributeFilter: ['hidden', 'inert'] });
+    popupVisibilityObserver.observe(surfaceBridge, { attributes: true, attributeFilter: ['data-mode'] });
+  }
   if (surfaceBridge && window.frameElement && surfaceBridge.contains(window.frameElement)) window.frameElement.conversation = {
     source: window, document: document,
+    navigateEntry: function (target) {
+      if (!submissionReady() || target.ownerId !== store.get('myUserId') || target.mateId !== store.get('activeProjectMateId') || target.sessionId !== store.get('paneSessionId') || target.sessionOriginId !== store.get('sessionOriginId')) return false;
+      navigateToSession({ projectSlug: store.get('currentSlug'), sessionId: target.sessionId }, target.query, target.entryIndex);
+      return true;
+    },
     submitAsk: submitContextualAsk,
     pauseAsk: pauseContextualAsk,
     stopAsk: stopContextualAsk,

package/lib/public/modules/contextual-clay.js

@@ -61,7 +61,7 @@ function render() {
   renderContextualWorkspaceBack();
   if (!surface) return;
   surface.hidden = mode === 'closed' || mode === 'workspace';
-  surface.dataset.mode = mode;
+  if (surface.dataset.mode !== mode) surface.dataset.mode = mode;
   positionContextualClay();
   surface.querySelector('[data-clay-expand]').hidden = mode !== 'popover';
   surface.querySelector('[data-clay-close]').hidden = mode !== 'popover' && mode !== 'opening';
@@ -100,7 +100,10 @@ function render() {
   var selectedFrame = contextualFrame();
   var connection = selectedFrame && selectedFrame.conversation;
   surface.querySelector('[data-clay-loading]').hidden = !!(connection && connection.identity().ready) || surface.dataset.askPending === 'true';
-  surface.querySelectorAll('iframe').forEach(function (frame) { frame.hidden = frame !== selectedFrame; });
+  surface.querySelectorAll('iframe').forEach(function (frame) {
+    var hidden = frame !== selectedFrame;
+    if (frame.hidden !== hidden) frame.hidden = hidden;
+  });
 }
 
 function createFrame(mate, sessionId) {