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

package/lib/public/modules/contextual-mate-sessions.js

@@ -1,4 +1,5 @@
 // Saved conversations are independent of which compact renderers are mounted.
+import { handlePaletteClayConversation } from './palette-clay-conversation.js';
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { contextualMate, contextualMateStamp, contextualFrame } from './contextual-mate-identity.js';
@@ -111,6 +112,7 @@ export function attachContextualConversations(surface) {
   refreshIcons(); render();
 }
 export function handleContextualConversations(msg) {
+  if (handlePaletteClayConversation(msg)) return true;
   if (msg.type !== 'contextual_mate_sessions_result') return false;
   var kind = requestState('list') && requestState('list').requestId === msg.requestId ? 'list' : 'action';
   var request = requestState(kind);

package/lib/public/modules/filebrowser.js

@@ -16,6 +16,7 @@ import { initFileBrowserContextMenu, downloadProjectFile } from './filebrowser-c
 import { registerClayFileLinkOpener } from './clay-file-links.js';
 import { isPlantUmlFile, renderPlantUmlPreview, cancelPlantUmlPreview } from './plantuml-preview.js';
 import { isHtmlFile, renderHtmlPreview } from './html-preview.js';
+import { initialMarkdownRendered, rememberMarkdownViewMode, resetMarkdownViewModes } from './markdown-view-mode.js';
 
 var ctx;
 var showDropHint = function () {};
@@ -48,7 +49,7 @@ export function initFileBrowser(_ctx) {
       ctx.fileViewerEl.classList.remove("hidden");
       if (path !== currentFilePath || (store.get("fileViewerIsHtml") && isRendered && !document.querySelector(".file-viewer-html-preview"))) requestFileContent(path);
     },
-    onEmpty: function() { teardownFileViewer(); },
+    onEmpty: function() { resetMarkdownViewModes(); teardownFileViewer(); },
   });
   registerRightWorkbench("file-viewer", teardownFileViewer);
 
@@ -204,6 +205,7 @@ export function initFileBrowser(_ctx) {
   document.getElementById("file-viewer-render").addEventListener("click", function () {
     if (currentContent == null || (!currentIsMarkdown && !currentIsSvg && !store.get("fileViewerIsPlantUml") && !store.get("fileViewerIsHtml"))) return;
     isRendered = !isRendered;
+    if (currentIsMarkdown) rememberMarkdownViewMode((store.get('clayControlFileView') || {}).projectSlug, currentFilePath, isRendered);
     if (store.get("fileViewerIsHtml")) {
       renderHtmlBody();
       return;
@@ -534,6 +536,7 @@ export function setFileViewerFullscreen(enabled) {
 export function resetFileBrowser() {
   releaseRightWorkbench("file-viewer");
   clearFileViewerTabs();
+  resetMarkdownViewModes();
   teardownFileViewer();
   // Clear all cached state
   treeData = {};
@@ -1217,6 +1220,7 @@ function showFileContent(msg, expectedRevision) {
     store.set({ fileViewerIsHtml: !lightweightPreview && isHtmlFile(msg.path) });
     store.set({ fileViewerIsPlantUml: !lightweightPreview && isPlantUmlFile(msg.path) });
     if (lightweightPreview) isRendered = false;
+    if (currentIsMarkdown && !keepRenderState) isRendered = initialMarkdownRendered((store.get('clayControlFileView') || {}).projectSlug, msg.path, store.get('pendingFileNavigation'), pendingOpenMode);
     if (pendingRenderedOpen && currentIsMarkdown) isRendered = true;
 
     if (currentIsMarkdown || currentIsSvg || store.get("fileViewerIsPlantUml") || store.get("fileViewerIsHtml")) {
@@ -1227,7 +1231,7 @@ function showFileContent(msg, expectedRevision) {
       copyBtn.title = "Copy contents";
     }
 
-    // Markdown starts as source; HTML, SVG and diagrams start as previews.
+    // Markdown, HTML, SVG and diagrams start as previews; a line target or diff starts as source.
     if (lightweightPreview) {
       renderLargeTextFile(bodyEl, msg.content, msg.size);
     } else if (currentIsMarkdown) {

package/lib/public/modules/generation-stop.js

@@ -5,7 +5,13 @@ import { isDriverOperatedView } from './worker-pane-lock.js';
 export function stopGeneration() {
   var ws = getWs();
   if (!store.get('processing') || !store.get('connected') || !ws || ws.readyState !== 1) return false;
-  ws.send(JSON.stringify({ type: 'stop' }));
+  var message = { type: 'stop' };
+  if (store.get('paneMode')) {
+    var binding = store.get('paneCommittedBinding');
+    if (!store.get('paneReady') || !binding || binding.sessionId !== store.get('activeSessionId') || binding.sessionOriginId !== store.get('sessionOriginId')) return false;
+    message.paneBinding = binding;
+  }
+  ws.send(JSON.stringify(message));
   return true;
 }
 

package/lib/public/modules/knowledge-workbench-entry.js

@@ -0,0 +1,43 @@
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { refreshIcons } from './icons.js';
+import { showToast } from './utils.js';
+import { ensurePaneFeatureAssets } from './pane-feature-assets.js';
+
+var knowledgeWorkbenchModule = null;
+
+export function ensureKnowledgeButton() {
+  var button = document.getElementById('knowledge-workbench-btn'); if (button) return button;
+  var tools = document.getElementById('session-actions'); if (!tools) return null;
+  button = document.createElement('button'); button.id = 'knowledge-workbench-btn'; button.type = 'button'; button.className = 'palette-tile'; button.title = 'Knowledge'; button.setAttribute('aria-label', 'Knowledge'); button.innerHTML = '<i data-lucide="book-open"></i><span class="tool-btn-label">Knowledge</span>';
+  var fixed = tools.querySelector('[data-fixed="true"]');
+  tools.insertBefore(button, fixed ? fixed.nextSibling : tools.firstChild); refreshIcons(button); return button;
+}
+function sameContext(receipt) {
+  var state = store.snap();
+  return receipt.owner === state.myUserId && receipt.slug === state.currentSlug && receipt.socket === getWs() &&
+    receipt.generation === state.projectSplitViewSocketGeneration && receipt.binding === state.paneCommittedBinding && state.connected;
+}
+export function initMateKnowledgeWorkbench() {
+  var button = ensureKnowledgeButton(); if (!button || store.get('knowledgeWorkbenchEntryInitialized')) return;
+  store.set({ knowledgeWorkbenchEntryInitialized: true });
+  button.addEventListener('click', open);
+  function open(event) {
+    event.stopImmediatePropagation();
+    if (button.disabled) return;
+    var state = store.snap(), receipt = { owner: state.myUserId, slug: state.currentSlug, socket: getWs(), generation: state.projectSplitViewSocketGeneration, binding: state.paneCommittedBinding };
+    button.disabled = true;
+    Promise.all([import('./mate-knowledge-workbench.js'), ensurePaneFeatureAssets('editor')]).then(function (loaded) {
+      var module = loaded[0];
+      if (!knowledgeWorkbenchModule) {
+        module.initMateKnowledgeWorkbench(); knowledgeWorkbenchModule = module;
+        button.removeEventListener('click', open);
+      }
+      if (sameContext(receipt)) module.openKnowledgeWorkbench();
+    }).catch(function (error) { if (sameContext(receipt)) showToast(error.message, 'error'); }).finally(function () { button.disabled = false; });
+  }
+}
+export function handleKnowledgeWorkbenchMessage(message) {
+  var module = knowledgeWorkbenchModule;
+  return module ? module.handleKnowledgeWorkbenchMessage(message) : false;
+}

package/lib/public/modules/markdown-view-mode.js

@@ -0,0 +1,34 @@
+// Initial Markdown view for the file viewer. Rendered is the default; an
+// explicit line target or diff needs source rows, and a toggle made by the
+// user for a path in this tab session is respected on later focus/reopen.
+// Choices are scoped to the source project that owns the file.
+
+import { store } from './store.js';
+
+function modeKey(projectSlug, path) {
+  return JSON.stringify([projectSlug || null, path]);
+}
+
+function chosenMode(projectSlug, path) {
+  var modes = store.get('fileViewerMarkdownModes') || {};
+  var key = modeKey(projectSlug, path);
+  return Object.prototype.hasOwnProperty.call(modes, key) ? modes[key] : null;
+}
+
+export function initialMarkdownRendered(projectSlug, path, pendingNavigation, pendingMode) {
+  if (pendingNavigation && pendingNavigation.line && pendingNavigation.path === path) return false;
+  if (pendingMode && pendingMode.type === 'diff') return false;
+  var chosen = chosenMode(projectSlug, path);
+  return chosen ? chosen === 'rendered' : true;
+}
+
+export function rememberMarkdownViewMode(projectSlug, path, rendered) {
+  if (!path) return;
+  var next = Object.assign({}, store.get('fileViewerMarkdownModes') || {});
+  next[modeKey(projectSlug, path)] = rendered ? 'rendered' : 'source';
+  store.set({ fileViewerMarkdownModes: next });
+}
+
+export function resetMarkdownViewModes() {
+  store.set({ fileViewerMarkdownModes: {} });
+}

package/lib/public/modules/markdown.js

@@ -1,3 +1,4 @@
+import { ensurePaneFeatureAssets } from './pane-feature-assets.js';
 import { enhanceSessionCitations } from './clay-session-links.js';
 import { renderBrowserLink, enhanceBrowserLinks } from './clay-browser-links.js';
 import { renderWireframeBlocks } from './wireframe-chat.js';
@@ -41,6 +42,7 @@ marked.use({
 var mermaidInitialized = false;
 
 export function updateMermaidTheme(vars) {
+  if (typeof mermaid === "undefined") return;
   mermaidInitialized = true;
   mermaid.initialize({
     startOnLoad: false,
@@ -140,6 +142,15 @@ export function renderMermaidBlocks(el) {
   if (store.get('replayingHistory')) return;
   renderWireframeBlocks(el);
   var blocks = el.querySelectorAll("pre code.language-mermaid");
+  if (blocks.length && typeof mermaid === 'undefined') {
+    var binding = store.get('panePendingBinding') || store.get('paneCommittedBinding'), origin = store.get('sessionOriginId');
+    var owner = store.get('myUserId'), slug = store.get('currentSlug'), generation = store.get('projectSplitViewSocketGeneration');
+    ensurePaneFeatureAssets('mermaid').then(function () {
+      if (el.isConnected && binding === (store.get('panePendingBinding') || store.get('paneCommittedBinding')) && origin === store.get('sessionOriginId') &&
+          owner === store.get('myUserId') && slug === store.get('currentSlug') && generation === store.get('projectSplitViewSocketGeneration')) renderMermaidBlocks(el);
+    }).catch(function () { /* Preserve readable source when diagram assets fail. */ });
+    return;
+  }
   blocks.forEach(function (codeEl) {
     var pre = codeEl.parentElement;
     if (!pre || pre.dataset.mermaidProcessed) return;

package/lib/public/modules/mate-knowledge-workbench.js

@@ -1,3 +1,4 @@
+import { ensureKnowledgeButton as ensureButton } from './knowledge-workbench-entry.js';
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { iconHtml, refreshIcons } from './icons.js';
@@ -93,13 +94,7 @@ function ensurePanel() {
   var newButton = panel.querySelector('[data-knowledge-new]'); newButton.insertAdjacentHTML('beforebegin', '<button type="button" data-knowledge-back title="Back" aria-label="Previous document">' + iconHtml('arrow-left') + '</button><button type="button" data-knowledge-forward title="Forward" aria-label="Next document">' + iconHtml('arrow-right') + '</button>');
   host.appendChild(panel); bindPanel(); refreshIcons(panel);
 }
-function ensureButton() {
-  var button = document.getElementById('knowledge-workbench-btn'); if (button) return button;
-  var tools = document.getElementById('session-actions'); if (!tools) return null;
-  button = document.createElement('button'); button.id = 'knowledge-workbench-btn'; button.type = 'button'; button.className = 'palette-tile'; button.title = 'Knowledge'; button.setAttribute('aria-label', 'Knowledge'); button.innerHTML = '<i data-lucide="book-open"></i><span class="tool-btn-label">Knowledge</span>';
-  var fixed = tools.querySelector('[data-fixed="true"]');
-  tools.insertBefore(button, fixed ? fixed.nextSibling : tools.firstChild); refreshIcons(button); return button;
-}
+
 function bindPanel() {
   panel.querySelector('[data-knowledge-close]').addEventListener('click', closeKnowledgeWorkbench);
   panel.querySelector('[data-knowledge-new]').addEventListener('click', function () { showKnowledgeCreateMenu(panel); });

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

@@ -406,7 +406,7 @@ function appendMateSessionTitleLine(el, textSpan) {
 
 export function renderMateSessionList(sessions) {
   if (sessions) cachedSessions = sessions;
-  if (!listEl) return;
+  if (!listEl || (store.get('paneMode') && !store.get('activeProjectMateId') && !store.get('dmMode') && !store.get('paneActivationUnsupported') && window.frameElement && window.frameElement.clayPane && !new URLSearchParams(location.search).has('contextual'))) return;
   listEl.innerHTML = "";
 
   if (cachedSessions.length === 0) {

package/lib/public/modules/palette-clay-conversation.js

@@ -0,0 +1,87 @@
+// Palette selection resolves one existing private conversation before presentation.
+import { store } from './store.js';
+import { getWs } from './ws-ref.js';
+import { contextualMate, contextualMateStamp, contextualFrame, contextualTrigger } from './contextual-mate-identity.js';
+import { selectContextualConversation, enterComposer } from './contextual-clay.js';
+import { pauseContextualSearchForSelection } from './contextual-search.js';
+import { closeCommandPalette } from './command-palette.js';
+import { showToast } from './utils.js';
+
+var socket = null, timer = null, surface = null;
+function current() { return store.get('paletteClayConversation'); }
+function parentView() { return JSON.stringify([store.get('currentSlug'), store.get('activeSessionId'), store.get('projectSplitViewActiveId')]); }
+function selection() { return JSON.stringify(store.get('contextualClay') || null); }
+function warn(message) { showToast(message || 'This conversation is unavailable. Refresh search and try again.', 'warn'); }
+function clear() {
+  clearTimeout(timer); timer = null; socket = null;
+  if (surface) { surface.removeEventListener('contextual-clay-ready', ready); surface.removeEventListener('contextual-ask-stopped', stopped); }
+  surface = null; store.set({ paletteClayConversation: null });
+}
+function stopped() { if (current()) { clear(); warn('Opening was stopped. Select the conversation again to resume.'); } }
+function live(request) {
+  var mate = contextualMate(request.mateId);
+  return store.get('connected') && socket === getWs() && socket && socket.readyState === 1 && request.ownerId === store.get('myUserId') && mate && !mate.lifecycleDeletion && mate.builtinKey === 'clay' && mate.createdBy === request.ownerId && contextualMateStamp(mate) === request.stamp && parentView() === request.view;
+}
+function guard() {
+  var action = store.get('contextualConversationRequest'), popup = store.get('contextualClay') || {};
+  if (action && action.status === 'loading' || popup.startingAsk || popup.mode === 'opening') { warn('Wait for the current conversation request to finish.'); return false; }
+  try { var frame = contextualFrame(); if (frame && frame.conversation) frame.conversation.checkDraft(); return true; }
+  catch (error) { warn(error.message); return false; }
+}
+export function openPaletteClayConversation(item, query, entryIndex) {
+  var mateId = item.mateId || String(item.projectSlug || '').slice(5);
+  var mate = contextualMate(mateId), owner = store.get('myUserId');
+  if (!mate || mate.lifecycleDeletion || item.projectSlug !== 'mate-' + mateId) { warn(); return true; }
+  if (mate.builtinKey !== 'clay') return false;
+  if (!owner || mate.createdBy !== owner || !Number.isSafeInteger(item.sessionId) || item.sessionId <= 0 || typeof item.sessionOriginId !== 'string' || !item.sessionOriginId) { warn(); return true; }
+  if (current()) { warn('Wait for the current conversation request to finish.'); return true; }
+  if (!guard()) return true;
+  socket = getWs();
+  if (!store.get('connected') || !socket || socket.readyState !== 1) { socket = null; warn('Reconnect before opening this conversation.'); return true; }
+  var request = { requestId: 'mate-conversations-' + crypto.randomUUID(), phase: 'resolving', mateId: mate.id, stamp: contextualMateStamp(mate), ownerId: owner,
+    sessionId: item.sessionId, sessionOriginId: item.sessionOriginId, view: parentView(), selection: selection(), query: query || null,
+    entryIndex: entryIndex != null && Number.isSafeInteger(Number(entryIndex)) && Number(entryIndex) >= 0 ? Number(entryIndex) : null };
+  store.set({ paletteClayConversation: request });
+  surface = document.getElementById('contextual-clay');
+  if (surface) surface.addEventListener('contextual-ask-stopped', stopped);
+  timer = setTimeout(function () { if (current() && current().requestId === request.requestId) { clear(); warn('The conversation did not become ready. Select it again to retry.'); } }, 15000);
+  try { socket.send(JSON.stringify({ type: 'home_mate_session_open', presentation: 'contextual', requestId: request.requestId, mateId: request.mateId, mateStamp: request.stamp, sessionId: 'local:' + request.sessionId, sessionOriginId: request.sessionOriginId })); }
+  catch (error) { clear(); warn('The connection changed. Select the conversation again after reconnecting.'); }
+  return true;
+}
+export function handlePaletteClayConversation(msg) {
+  var request = current();
+  if (msg.type !== 'contextual_mate_sessions_result' || !request || msg.requestId !== request.requestId) return false;
+  if (request.phase !== 'resolving') return true;
+  if (!live(request) || request.selection !== selection() || msg.mateId !== request.mateId || msg.mateStamp !== request.stamp || !msg.ok || msg.sessionId !== request.sessionId || msg.sessionOriginId !== request.sessionOriginId) { clear(); warn(); return true; }
+  if (!guard()) { clear(); return true; }
+  pauseContextualSearchForSelection();
+  store.set({ paletteClayConversation: Object.assign({}, request, { phase: 'selecting' }) });
+  var selected = false;
+  try { selected = selectContextualConversation(contextualMate(request.mateId), request.sessionId, request.sessionOriginId); } catch (error) { /* An unavailable child must not fall back to native navigation. */ }
+  if (!selected || !current() || !live(request)) { clear(); warn('This conversation could not be opened. Your draft is retained.'); return true; }
+  store.set({ paletteClayConversation: Object.assign({}, request, { phase: 'opening', selection: selection() }) });
+  closeCommandPalette();
+  if (surface) surface.removeEventListener('contextual-ask-stopped', stopped);
+  surface = document.getElementById('contextual-clay');
+  if (surface) { var trigger = contextualTrigger(request.mateId); if (trigger) { surface.dataset.focusEntry = 'true'; trigger.focus({ preventScroll: true }); enterComposer(); } surface.addEventListener('contextual-clay-ready', ready); surface.addEventListener('contextual-ask-stopped', stopped); }
+  ready();
+  return true;
+}
+function ready() {
+  var request = current();
+  if (!request || request.phase !== 'opening') return;
+  if (!live(request) || request.selection !== selection()) { clear(); warn('Your view changed. Select the conversation again.'); return; }
+  var frame = contextualFrame(request.mateId, request.sessionId), controller = frame && frame.conversation;
+  if (!controller || controller.source !== frame.contentWindow || frame.hidden || frame.inert) return;
+  var identity = controller.identity();
+  if (!identity.ready) return;
+  if (identity.ownerId !== request.ownerId || identity.mateId !== request.mateId || identity.sessionId !== request.sessionId || identity.sessionOriginId !== request.sessionOriginId || !identity.connected || identity.available === false) { clear(); warn(); return; }
+  if ((request.query || request.entryIndex !== null) && (!controller.navigateEntry || !controller.navigateEntry(request))) { clear(); warn('The conversation opened, but the requested passage could not be located.'); return; }
+  clear();
+}
+store.subscribe(function () {
+  var request = current();
+  if (!request && socket) { clear(); return; }
+  if (request && (!live(request) || request.phase !== 'selecting' && request.selection !== selection())) { clear(); warn('Your view or connection changed. Select the conversation again.'); }
+});

package/lib/public/modules/palette-render-helpers.js

@@ -0,0 +1,25 @@
+export 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();
+}
+
+
+export function paletteSelectionIndex(previous, items, query) {
+  var index = previous ? items.findIndex(function (item) {
+    if (item.type !== previous.type || item.query !== previous.query) return false;
+    if (!item.data || !previous.data) return !item.data && !previous.data;
+    return item.data.projectSlug === previous.data.projectSlug && item.data.sessionId === previous.data.sessionId && item.data.sessionOriginId === previous.data.sessionOriginId;
+  }) : -1;
+  return index >= 0 ? index : query ? 0 : -1;
+}

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

@@ -1,3 +1,4 @@
+import { disarmStickyBottom } from './chat-render-runtime.js';
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { getCachedSessions } from './sidebar-sessions.js';
@@ -15,34 +16,58 @@ function block(value) {
   document.documentElement.dataset.paneReady = value ? 'false' : 'true';
 }
 function draftKey() { return String(store.get('myUserId')) + ':' + store.get('sessionOriginId'); }
+function rememberPanePosition() {
+  var messages = document.getElementById('messages'), key = draftKey();
+  if (!messages || !store.get('sessionOriginId') || store.get('panePendingBinding')) return;
+  var positions = Object.assign({}, store.get('paneRetainedPositions') || {});
+  delete positions[key];
+  positions[key] = { top: messages.scrollTop, height: messages.scrollHeight, viewport: messages.clientHeight };
+  var keys = Object.keys(positions);
+  while (keys.length > 8) delete positions[keys.shift()];
+  store.set({ paneRetainedPositions: positions });
+}
+function suspendPane() {
+  if (!store.get('paneSuspended')) rememberPanePosition();
+  clearDeadline();
+  store.set({ paneSuspended: true, paneReady: false, panePendingBinding: null });
+  block(true);
+}
 function clearDeadline() {
   if (store.get('paneActivationTimer')) clearTimeout(store.get('paneActivationTimer'));
   store.set({ paneActivationTimer: null });
 }
-function failed(requestId) {
+function failed(requestId, reason) {
   var pending = store.get('panePendingBinding');
   if (!pending || requestId !== pending.requestId) return;
   clearDeadline();
   store.set({ paneReady: false, panePendingBinding: null });
   block(true);
   var frame = window.frameElement;
-  if (frame) frame.dispatchEvent(new window.parent.CustomEvent('clay-pane-activation-failed'));
+  if (frame) {
+    if (reason) frame.dataset.paneActivationFailure = reason;
+    frame.dispatchEvent(new window.parent.CustomEvent('clay-pane-activation-failed'));
+  }
 }
 
 // Claim ordinary initial pins before the legacy session-list handler runs.
 // Authentication, list and group metadata can arrive in either order; the
 // subscription retries when those authoritative prerequisites become ready.
 export function primePaneSession() {
-  if (!enabled() || !window.frameElement || !window.frameElement.clayPane) return false;
-  var id = store.get('paneSessionId');
+  if (store.get('paneSuspended') || !enabled() || !window.frameElement || !window.frameElement.clayPane) return false;
+  var frame = window.frameElement;
+  var id = Number(frame.dataset.requestedSessionId || frame.dataset.sessionId || store.get('paneSessionId'));
+  if (!Number.isSafeInteger(id) || id < 1) return false;
   var session = (getCachedSessions() || []).find(function (item) { return item.id === id; });
   if (!session || session.isMate || (session.runtimeMode || session.mode || 'gui') !== 'gui' || session.tuiSuspended) return false;
-  activatePaneSession(id);
+  var target = paneTarget(store.snap(), getCachedSessions(), id);
+  var existing = store.get('panePendingBinding') || store.get('paneCommittedBinding');
+  activatePaneSession(id, store.get('paneSessionId') !== id || !samePaneTarget(existing, target), target);
   return true;
 }
 
 export function activatePaneSession(id, force, expectedTarget) {
   var state = store.snap(), ws = getWs();
+  if (window.frameElement && window.frameElement.closest && window.frameElement.closest('.split-pane-cached')) return false;
   if (state.authIdentityLoaded === false) return false;
   if (state.isMultiUserMode && !state.myUserId) return false;
   if (!enabled() || !state.connected || !ws || ws.readyState !== 1 || state.splitGroupsProjectSlug !== state.currentSlug) return false;
@@ -54,6 +79,7 @@ export function activatePaneSession(id, force, expectedTarget) {
   var old = state.paneCommittedBinding, pending = state.panePendingBinding;
   if (!force && !state.paneSuspended && samePaneTarget(pending || old, target)) return true;
   if (!pending && state.sessionOriginId) {
+    if (!state.paneSuspended) rememberPanePosition();
     var draft;
     try { draft = takeComposerDraft(); } catch (error) { return false; }
     var drafts = Object.assign({}, state.paneRichDrafts || {});
@@ -67,9 +93,11 @@ export function activatePaneSession(id, force, expectedTarget) {
   var path = new URL(store.get('wsPath'), location.origin);
   path.searchParams.set('session', String(id));
   store.set({ paneActivationGeneration: generation, panePendingBinding: target, paneReady: false, paneSuspended: false,
+    paneLayoutScrollLock: null, paneLastUserScrollTop: null, paneUserScrollIntent: null, paneUserScrollRevision: 0,
     paneSessionId: id, panePinPending: false, wsPath: path.pathname + path.search });
   block(true);
   store.set({ paneActivationTimer: setTimeout(function () { failed(target.requestId); }, 12000) });
+  if (typeof performance !== 'undefined' && performance.mark) { performance.clearMarks('clay:activation-request'); performance.mark('clay:activation-request'); }
   ws.send(JSON.stringify({ type: 'switch_session', id: id, paneActivation: target }));
   return true;
 }
@@ -87,6 +115,7 @@ export function filterPaneActivation(message) {
   if (message.type === 'pane_activation_started') return true;
   if (message.type === 'pane_activation_snapshot_done') {
     if (!pending) return true;
+    if (typeof performance !== 'undefined' && performance.mark) { performance.clearMarks('clay:snapshot-received'); performance.mark('clay:snapshot-received'); }
     var draft = (store.get('paneRichDrafts') || {})[String(store.get('myUserId')) + ':' + expected.sessionOriginId];
     restoreComposerDraft(draft || { text: '', start: 0, end: 0 });
     function paint() {
@@ -95,10 +124,20 @@ export function filterPaneActivation(message) {
       var messages = document.getElementById('messages');
       if (!samePaneTarget(current, expected) ||
         store.get('activeSessionId') !== expected.sessionId || store.get('sessionOriginId') !== expected.sessionOriginId || store.get('replayingHistory') ||
-        !messages || messages.dataset.controlSessionId !== String(expected.sessionId) || messages.dataset.controlSessionOrigin !== expected.sessionOriginId) { failed(expected.requestId); return; }
+        !messages || messages.dataset.controlSessionId !== String(expected.sessionId) || messages.dataset.controlSessionOrigin !== expected.sessionOriginId) {
+        failed(expected.requestId, 'snapshot-state-mismatch: active=' + store.get('activeSessionId') + ', origin=' + store.get('sessionOriginId') + ', messages=' + (messages && messages.dataset.controlSessionId) + ', messageOrigin=' + (messages && messages.dataset.controlSessionOrigin));
+        return;
+      }
+      var position = (store.get('paneRetainedPositions') || {})[String(store.get('myUserId')) + ':' + expected.sessionOriginId];
+      if (position && Number.isFinite(position.top)) {
+        disarmStickyBottom();
+        messages.scrollTop = position.top;
+        store.set({ paneLastUserScrollTop: position.top });
+      }
       clearDeadline();
       store.set({ paneCommittedBinding: expected, panePendingBinding: null, paneReady: true });
       block(false);
+      if (typeof performance !== 'undefined' && performance.mark) { performance.clearMarks('clay:pane-ready'); performance.mark('clay:pane-ready'); }
       var frame = window.frameElement;
       if (frame) frame.dispatchEvent(new window.parent.CustomEvent('clay-pane-ready'));
       updateContextPanel();
@@ -167,7 +206,7 @@ export function initPaneActivation() {
     },
     activate: activatePaneSession,
     checkDraft: function () { if (!store.get('panePendingBinding')) { var draft = takeComposerDraft(); restoreComposerDraft(draft); } },
-    suspend: function () { store.set({ paneSuspended: true, paneReady: false }); block(true); },
+    suspend: suspendPane,
   };
   // A pointer that began on the previous conversation cannot become a Stop or
   // approval click on the replacement conversation after hydration.

package/lib/public/modules/pane-binding.js

@@ -56,14 +56,23 @@ export function paneTarget(state, sessions, id) {
 // Ordinary reusable panes have a live document binding; legacy/canonical frames
 // retain their existing URL and receipt checks in their own bridge paths.
 export function livePaneBinding(frame, message) {
-  if (!frame || !frame.clayPane) return false;
+  if (!frame || !frame.clayPane || frame.closest && frame.closest('.split-pane-cached')) return false;
   var api = frame.clayPane, live = api.identity();
   var state = store.snap(), split = state.splitPanes;
+  if (!state.connected) return false;
   var target = live && paneTarget(state, state.paneBindingSessions || [], live.sessionId);
+  var inLegacySplit = !!(live && split && split.panes.some(function (pane) { return pane.slug === live.projectSlug && pane.sessionId === live.sessionId; }));
+  var activePresentation = (state.projectSplitViews || []).find(function (view) { return view.id === state.projectSplitViewActiveId; });
+  var inPresentation = !!(live && live.binding && !split && activePresentation && activePresentation.sessions.some(function (session) {
+    return session.id === live.sessionId && session.sessionOriginId === live.binding.sessionOriginId;
+  }));
+  var inSingletonPresentation = !!(live && live.binding && !split && !activePresentation &&
+    state.projectSplitViewSingletonOrigin === live.binding.sessionOriginId &&
+    live.sessionId === Number(frame.dataset.sessionId) && live.binding.sessionOriginId === frame.dataset.sessionOriginId);
   return api.source === frame.contentWindow && api.document === frame.contentDocument && live && live.ready &&
     samePaneTarget(target, live.binding) &&
     live.ownerId === (state.myUserId || null) && live.projectSlug === state.currentSlug &&
-    split && split.panes.some(function (pane) { return pane.slug === live.projectSlug && pane.sessionId === live.sessionId; }) &&
+    (inLegacySplit || inPresentation || inSingletonPresentation) &&
     (!message || samePaneBinding(live.binding, message.paneBinding));
 }
 
@@ -77,6 +86,7 @@ export function currentPaneReview(container) {
 }
 
 export function paneCallbackCurrent(binding) {
+  if (store.get('paneSuspended')) return false;
   var current = store.get('panePendingBinding') || store.get('paneCommittedBinding');
   return current ? samePaneBinding(current, binding) : !binding;
 }

package/lib/public/modules/pane-bridge.js

@@ -5,9 +5,11 @@ import { forwardStudioPresentation } from './clay-studio-render.js';
 // Same-origin messages only, both directions.
 
 import { store } from './store.js';
+import { beginPaneLayoutScrollLock, endPaneLayoutScrollLock } from './chat-render-runtime.js';
 import { paneMessageBinding, samePaneBinding } from './pane-binding.js';
 import { getEffectiveContextView } from './context-view-preference.js';
 import { forceExternalLinkToNewTab } from './pane-links.js';
+import { toggleSearch, controlPaneSearch } from './session-search.js';
 
 export function reportPaneContext(data) {
   if (!store.get('paneMode') || window.parent === window) return;
@@ -71,8 +73,15 @@ export function initPaneBridge() {
   window.addEventListener("message", function (event) {
     if (event.origin !== window.location.origin) return;
     var msg = event.data;
-    if (!msg || msg.type !== "clay-pane-toggle-context") return;
-    if (event.source !== window.parent || store.get('paneCommittedBinding') && !samePaneBinding(paneMessageBinding(), msg.paneBinding)) return;
-    togglePaneContextPanel();
+    if (!msg || (msg.type !== "clay-pane-toggle-context" && msg.type !== "clay-pane-toggle-search" && msg.type !== "clay-pane-search-command" && msg.type !== "clay-pane-layout-resize")) return;
+    var committed = store.get('paneCommittedBinding');
+    if (event.source !== window.parent || !committed || !paneMessageBinding() ||
+        !samePaneBinding(committed, msg.paneBinding) || !samePaneBinding(paneMessageBinding(), msg.paneBinding)) return;
+    if (msg.type === "clay-pane-layout-resize") {
+      if (msg.phase === 'begin') beginPaneLayoutScrollLock(msg.token, msg.scrollTop);
+      else if (msg.phase === 'end') endPaneLayoutScrollLock(msg.token);
+    } else if (msg.type === "clay-pane-toggle-context") togglePaneContextPanel();
+    else if (msg.type === "clay-pane-toggle-search") toggleSearch();
+    else controlPaneSearch(msg.action, msg.query);
   });
 }

package/lib/public/modules/pane-deferred-bootstrap.js

@@ -0,0 +1,32 @@
+import { store } from './store.js';
+
+// Executable initializers belong to this module; the store holds only IDs.
+var initializers = [];
+
+// Parent-owned workbench chrome is unnecessary for a pane's first transcript.
+// Keep the same initializers, but run them one task at a time after its exact
+// authenticated activation has made the conversation interactive.
+function drain() {
+  var state = store.snap(), boot = state.paneDeferredBootstrap;
+  if (!boot || boot.scheduled || !boot.jobs.length || !state.connected || !state.paneReady || state.paneSuspended) return;
+  store.set({ paneDeferredBootstrap: Object.assign({}, boot, { scheduled: true }) });
+  setTimeout(function () {
+    var latest = store.snap(), pending = latest.paneDeferredBootstrap;
+    if (!pending) return;
+    var jobs = pending.jobs.slice(), job = latest.connected && latest.paneReady && !latest.paneSuspended ? jobs.shift() : null;
+    store.set({ paneDeferredBootstrap: Object.assign({}, pending, { scheduled: false, jobs: jobs }) });
+    try { if (job !== null && initializers[job]) { var initialize = initializers[job]; initializers[job] = null; initialize(); } } finally { drain(); }
+  }, 0);
+}
+export function initializeAfterPaneReady(jobs) {
+  if (!store.get('paneMode')) { jobs.forEach(function (job) { job(); }); return; }
+  var boot = store.get('paneDeferredBootstrap');
+  if (!boot) {
+    boot = { jobs: [], scheduled: false };
+    store.subscribe(function (next, previous) {
+      if (next.paneReady !== previous.paneReady || next.connected !== previous.connected || next.paneSuspended !== previous.paneSuspended) drain();
+    });
+  }
+  store.set({ paneDeferredBootstrap: Object.assign({}, boot, { jobs: boot.jobs.concat(jobs.map(function (job) { var id = initializers.length; initializers.push(job); return id; })) }) });
+  drain();
+}

package/lib/public/modules/pane-feature-assets.js

@@ -0,0 +1,35 @@
+// In-flight promises are module-owned resources, never store data.
+var featureRequests = {};
+
+// Only server-authored, inert feature tags are eligible. Parent documents retain
+// their normal vendor loading; pane documents load these groups on first use.
+export function ensurePaneFeatureAssets(group) {
+  if (['editor', 'mermaid', 'qr'].indexOf(group) === -1) return Promise.reject(new Error('Unknown feature assets'));
+  var existing = featureRequests[group];
+  if (existing) return existing;
+  var tags = Array.from(document.querySelectorAll('script[data-pane-asset-group="' + group + '"]'));
+  var promise = tags.reduce(function (previous, tag) {
+    return previous.then(function () {
+      if (tag.dataset.loaded === 'true') return;
+      return new Promise(function (resolve, reject) {
+        var script = document.createElement('script'), timer;
+        function failed() {
+          clearTimeout(timer); script.onload = null; script.onerror = null; script.remove();
+          reject(new Error('Could not load ' + group + ' assets. Try again.'));
+        }
+        script.src = tag.dataset.src; script.async = false;
+        script.onload = function () { clearTimeout(timer); tag.dataset.loaded = 'true'; resolve(); };
+        script.onerror = failed; timer = setTimeout(failed, 15000);
+        tag.after(script);
+      });
+    });
+  }, Promise.resolve());
+  promise = promise.then(function () {
+    var value = group === 'editor' ? window.CodeMirror : group === 'mermaid' ? window.mermaid : window.qrcode;
+    if (!value) throw new Error('Could not load ' + group + ' assets. Try again.');
+  }).catch(function (error) {
+    delete featureRequests[group]; throw error;
+  });
+  featureRequests[group] = promise;
+  return promise;
+}

package/lib/public/modules/pane-file-bridge.js

@@ -59,9 +59,14 @@ export function handlePaneFileMessage(event, host, openFile, openFiles) {
   if (!msg || msg.type !== "clay-pane-open-file") return false;
   var frame = paneFrame(host, event.source);
   var state = store.snap();
-  var pane = matchingPane(frame, state.splitPanes);
-  if (frame && frame.clayPane && !livePaneBinding(frame, msg)) return true;
-  if (!pane || !hasLivePaneSource(frame, pane) || String(pane.slug) !== String(state.currentSlug) || msg.projectSlug !== frame.dataset.projectSlug || String(msg.sessionId) !== String(frame.dataset.sessionId) || !validLocation(msg.line) || !validLocation(msg.column)) return true;
+  // A live reusable pane is authorized by its document binding, which covers
+  // legacy splits, saved views and single-session views. Other frames keep the
+  // legacy split membership and URL checks.
+  var live = frame && frame.clayPane;
+  var pane = live ? { slug: frame.dataset.projectSlug, sessionId: frame.dataset.sessionId } : matchingPane(frame, state.splitPanes);
+  if (live && !livePaneBinding(frame, msg)) return true;
+  if (live && Number(msg.sessionId) !== live.identity().sessionId) return true;
+  if (!pane || (!live && !hasLivePaneSource(frame, pane)) || String(pane.slug) !== String(state.currentSlug) || msg.projectSlug !== frame.dataset.projectSlug || String(msg.sessionId) !== String(frame.dataset.sessionId) || !validLocation(msg.line) || !validLocation(msg.column)) return true;
   if (typeof msg.path !== "string" || !msg.path) return true;
   if (!state.connected || typeof openFile !== "function") return true;
   // The frame/session association was validated above. The host browser owns

package/lib/public/modules/pane-search-receipt.js

@@ -0,0 +1,12 @@
+import { samePaneBinding } from './pane-binding.js';
+
+function acceptsPaneSearchResults(state, msg) {
+  var binding = state.paneCommittedBinding;
+  var receipt = state.paneSearchReceipt;
+  return !!(state.paneReady && !state.panePendingBinding && !state.paneSuspended && binding && receipt &&
+    receipt.epoch === state.paneSearchEpoch && samePaneBinding(receipt.binding, binding) &&
+    Number(binding.sessionId) === Number(msg.sessionId) && Number(binding.sessionId) === Number(state.activeSessionId) &&
+    receipt.query === msg.query);
+}
+
+export { acceptsPaneSearchResults };