@oar-sh/oar 0.9.9 → 0.9.11

package/server/public/app/bootstrap.js

@@ -1,4 +1,5 @@
 import {
+  BASE,
   CLIENT_ID,
   currentConvId,
   conversations,
@@ -24,7 +25,7 @@ import {
   showTransientRelayNotice,
   applyContextUsageBar,
   scrollBottom,
-  isMessagesAtBottom,
+  isMessagesNearBottom,
   setHistoryRefreshInFlight,
   isHistoryRefreshInFlight,
   setSummaryModalLoading,
@@ -46,13 +47,20 @@ import {
   resolveConversationUiState,
   summaryModalState,
   IS_SHARED_VIEW,
+  IS_SHARE_PREVIEW,
   SHARED_CONVERSATION_TOKEN,
   getConversationWatcherCount,
   generateId,
   imageEditTarget,
   hasPendingUserMessageForConversation,
 } from './store.js';
-import { createTranscriptResizeKeeper } from './transcript-viewport-anchor.mjs';
+import {
+  captureReadingBlock,
+  createTranscriptResizeKeeper,
+  restoreReadingBlock,
+} from './transcript-viewport-anchor.mjs';
+import { initTranscriptJumpToBottom, onTranscriptEndLeft } from './transcript-jump-bottom-view.mjs';
+import { syncScrollOnSendToggle, updateScrollOnSendSetting } from './transcript-jump-bottom.mjs';
 import {
   verifyExistingSession,
   verifyToken,
@@ -91,6 +99,8 @@ import {
   isArchivedConversationsView,
   refreshNewConversationCloudRepoList,
   openOriginConversation,
+  openConversationGroupPicker,
+  toggleConversationGroupFold,
 } from './journal-view.js';
 import {
   loadRelayQuestions,
@@ -103,6 +113,7 @@ import {
   renderMessages,
   appendMessage,
   compactCurrentConversation,
+  renderNoConversationState,
   sendMessage,
   handleKey,
   updateComposerSlashMenu,
@@ -124,13 +135,17 @@ import {
   conversationHasActiveTurn,
   focusConversationMessageById,
   syncRenderedPinState,
+  syncRenderedShareVisibility,
   isConversationWindowAtTail,
   getTranscriptJumpEpoch,
+  getTranscriptLiveRowEpoch,
 } from './conversation-view.js';
+import { loadKeepingLiveRows } from './transcript-reload-freshness.mjs';
 import { initPinnedMessagesView, setPinsConversation } from './pinned-messages-view.mjs';
+import { initHiddenMessagesView, setHiddenMessagesConversation } from './hidden-messages-view.mjs';
 import { bindChatSelectionGuard, chatSelectionGuard, isChatInteractionHeld } from './selection-guard.mjs';
 import { loadRepoBrowserTree, openRepoBrowser, closeRepoBrowser, setRepoBrowserSessionInfo, resetWorkspaceRepoBrowserForRootChange } from './attachments-view.js';
-import { handleAttachmentInput, retryAttachmentUpload, openAnnotateEditorForPending, openAnnotateEditorForPreview, handleComposerPaste, handleComposerDrop, refreshComposerAttachmentWarning, removeAttachment, clearAttachments, openUploadedAttachmentViewer, setFilePreviewMode, toggleFilePreviewHtml, copyFilePreviewImage, closeFilePreview, goBackFilePreview, openWorkspaceFilePreview, openWorkspaceFilePreviewFromRepo, setRepoBrowserRoot, setRepoBrowserViewMode, toggleRepoBrowserHidden, toggleRepoBrowserHeavy, refreshRepoBrowser, focusRepoTree, setRepoCurrentPath, confirmRepoBrowserCwdPick } from './attachments-view.js';
+import { handleAttachmentInput, retryAttachmentUpload, openAnnotateEditorForPending, openAnnotateEditorForPreview, handleComposerPaste, handleComposerDrop, refreshComposerAttachmentWarning, removeAttachment, clearAttachments, openUploadedAttachmentViewer, setFilePreviewMode, toggleFilePreviewHtml, copyFilePreviewImage, closeFilePreview, goBackFilePreview, openWorkspaceFilePreview, openWorkspaceFilePreviewFromRepo, setRepoBrowserRoot, setRepoBrowserViewMode, toggleRepoBrowserHidden, toggleRepoBrowserHeavy, refreshRepoBrowser, focusRepoTree, setRepoCurrentPath, confirmRepoBrowserCwdPick, startRepoNewFolder } from './attachments-view.js';
 import { initEmojiPicker, toggleEmojiPicker } from './emoji-view.js';
 import { initSlashAutocomplete } from './slash-autocomplete.mjs';
 import { initMentionAutocomplete } from './mention-autocomplete.mjs';
@@ -173,6 +188,8 @@ import {
   openMessageSearchModal,
   closeMessageSearchModal,
 } from './message-search-view.js';
+import { initSubagentViewer } from './subagent-viewer.mjs';
+import { watchPreviewMarks } from './share-preview-marks.mjs';
 import {
   initGitChangesView,
   openGitChangesModal,
@@ -274,6 +291,7 @@ import {
   updateTheme,
   openSettingsModal,
   closeSettingsModal,
+  isSuspendHostActionVisible,
   syncSuspendHostVisibility,
   updateShowSuspendHostSetting,
   syncDefaultSessionWorkspaceRootInput,
@@ -309,6 +327,7 @@ import {
   updateTurnCeilingSetting,
   previewBackgroundTaskTimeoutSetting,
   updateBackgroundTaskTimeoutSetting,
+  updateSubagentRecordRetentionSetting,
 } from './settings-modal.js';
 import {
   togglePushOnThisDevice,
@@ -356,14 +375,24 @@ import {
   subscribeClaudeCloudSettings,
   toggleClaudeCloudProvider,
 } from './claude-cloud-settings-ui.js';
-import { openCurrentCloudSession, syncClaudeCloudConversationUi } from './claude-cloud-conversation-ui.js';
+import { isCurrentConversationClaudeCloud, openCurrentCloudSession, syncClaudeCloudConversationUi } from './claude-cloud-conversation-ui.js';
+import {
+  CHAT_ACTIONS_MENU_ENTRY_IDS,
+  CHAT_ACTIONS_MENU_META_IDS,
+  resolveChatActionsMenuState,
+} from './chat-actions-menu-state.mjs';
+import { subscribeProviderReadiness, updateProviderReadinessInputs } from './provider-readiness.mjs';
+import { hasActiveShare, refreshShares, subscribeShares } from './share-state.js';
+import { openStopSharingConfirmation } from './shared-conversations-settings.js';
+import { showAbout, syncAboutMenuLabel } from './about-ui.js';
 import { syncConversationOriginHeader } from './conversation-origin-ui.js';
+import { loadRelayEventSubscriptions, onRelayEventSubscriptionsChanged, syncRelayEventHeader } from './relay-event-subscriptions-ui.js';
 import {
   previewAgentSessionsMaxWait,
   saveAgentSessionsMaxWait,
   toggleAgentSessions,
 } from './agent-sessions-settings-ui.js';
-import { CLAUDE_CLOUD_PROVIDER, claudeCloudComposerModelIds } from './claude-cloud-ui.mjs';
+import { CLAUDE_CLOUD_PROVIDER, buildCloudLineModel, claudeCloudComposerModelIds } from './claude-cloud-ui.mjs';
 import {
   confirmCliInstall,
   runCliInstall,
@@ -377,6 +406,7 @@ import {
   dismissAvailableUpdate,
   dismissUpdateOutcome,
 } from './update-ui.js';
+import { shouldAutofocusComposerOnLoad } from './composer-keyboard.mjs';
 
 const MODEL_STORAGE_KEY = 'copilot_selected_model';
 // The New Chat modal used to keep its own model key, so a selection made there
@@ -442,6 +472,8 @@ let liveConversationPollInFlight = false;
 let sharedViewerIdFallback = '';
 let sharedConversationRenderKey = '';
 let sharedConversationLastError = '';
+// The share was stopped or renewed while the page was open: the reader stops.
+let sharedConversationEnded = false;
 let networkLifecycleBound = false;
 let foregroundRecoveryTimer = null;
 let foregroundRecoveryInFlight = false;
@@ -860,14 +892,14 @@ function initNetworkLifecycleHandling() {
 }
 
 function syncThemeMenuLabel() {
-  const button = document.getElementById('chat-menu-shared-theme-toggle');
+  const button = document.getElementById('chat-menu-theme-toggle');
   if (!button) return;
   const isLight = document.documentElement.getAttribute('data-theme') === 'light';
   button.textContent = isLight ? '🌙 Night mode' : '☀️ Day mode';
 }
 
 function initThemeMenuToggle() {
-  const themeBtn = document.getElementById('chat-menu-shared-theme-toggle');
+  const themeBtn = document.getElementById('chat-menu-theme-toggle');
   if (!themeBtn) return;
   themeBtn.hidden = false;
   syncThemeMenuLabel();
@@ -924,7 +956,7 @@ function applySharedReaderUi() {
   const modeSelect = document.getElementById('mode-select');
   const chatMenuBtn = document.getElementById('chat-actions-menu-btn');
   const chatMenu = document.getElementById('chat-actions-menu');
-  const sharedThemeBtn = document.getElementById('chat-menu-shared-theme-toggle');
+  const themeBtn = document.getElementById('chat-menu-theme-toggle');
   const installBtn = document.getElementById('install-btn');
   const activeElement = document.activeElement;
   if (chatMenu && activeElement instanceof Element && chatMenu.contains(activeElement)) {
@@ -941,7 +973,7 @@ function applySharedReaderUi() {
   if (input) {
     input.readOnly = true;
     input.disabled = true;
-    input.placeholder = 'Shared conversation (read-only)';
+    input.placeholder = IS_SHARE_PREVIEW ? 'Preview as shared (read-only)' : 'Shared conversation (read-only)';
   }
   disableSharedControl(sendBtn);
   disableSharedControl(attachBtn);
@@ -953,19 +985,23 @@ function applySharedReaderUi() {
   if (modelSelect) modelSelect.hidden = true;
   if (effortSelect) effortSelect.hidden = true;
   if (modeSelect) modeSelect.hidden = true;
-  if (chatMenu && sharedThemeBtn) {
+  // One source for the menu: the resolver's shared branch (Day/Night only,
+  // trigger usable). The loop below stays as a guard for entries the resolver
+  // does not know.
+  applyChatActionsMenuState(resolveChatActionsMenuState({ sharedMode: true }));
+  if (chatMenu && themeBtn) {
     for (const child of Array.from(chatMenu.children)) {
-      if (child !== sharedThemeBtn) hideSharedMenuEntry(child);
+      if (child !== themeBtn) hideSharedMenuEntry(child);
     }
-    sharedThemeBtn.hidden = false;
-    sharedThemeBtn.removeAttribute('aria-hidden');
-    sharedThemeBtn.disabled = false;
-    sharedThemeBtn.tabIndex = 0;
+    themeBtn.hidden = false;
+    themeBtn.removeAttribute('aria-hidden');
+    themeBtn.disabled = false;
+    themeBtn.tabIndex = 0;
     syncThemeMenuLabel();
   } else if (chatMenuBtn) {
     chatMenuBtn.hidden = true;
   }
-  if (chatMenuBtn && !sharedThemeBtn) chatMenuBtn.hidden = true;
+  if (chatMenuBtn && !themeBtn) chatMenuBtn.hidden = true;
 }
 
 function syncChatTitleWatcherIndicator() {
@@ -1006,18 +1042,50 @@ function resolveStableScrollTopForLiveRefresh(messagesEl, capturedScrollTop) {
   return captured;
 }
 
-async function refreshSharedConversation() {
-  if (sharedConversationPollInFlight) return;
+// Whether a reload keeps the reader at the end: as it was when the reload was
+// asked for, unless they have moved while it was on its way (scrolled up, or
+// jumped back to the end); then as it is now.
+function resolveLiveRefreshAtBottom(messagesEl, capturedScrollTop, capturedAtBottom) {
+  const current = Number(messagesEl?.scrollTop);
+  if (!Number.isFinite(current) || Math.abs(current - Number(capturedScrollTop)) <= 2) return capturedAtBottom;
+  return isMessagesNearBottom();
+}
+
+// A stopped or renewed share answers 404. The page stops polling at once and
+// keeps nothing of the conversation on screen; one neutral line stays.
+function endSharedConversationReader() {
+  if (sharedConversationEnded) return;
+  sharedConversationEnded = true;
+  stopSharedModeTimers();
+  document.getElementById('messages')?.replaceChildren();
+  const titleEl = document.getElementById('chat-title');
+  if (titleEl) titleEl.textContent = 'Shared conversation';
+  sharedConversationLastError = '';
+  setModelBanner('This shared conversation is not available.');
+}
+
+async function refreshSharedConversation({ open = false } = {}) {
+  if (sharedConversationPollInFlight || sharedConversationEnded) return;
   const sharedToken = resolveSharedTokenFromLocation();
-  if (!sharedToken) return;
+  if (!sharedToken && !IS_SHARE_PREVIEW) return;
   sharedConversationPollInFlight = true;
   const requestSeq = ++sharedConversationRequestSeq;
   const messagesEl = document.getElementById('messages');
-  const preserveBottom = isMessagesAtBottom();
+  const wasAtBottom = isMessagesNearBottom();
   const savedScrollTop = messagesEl?.scrollTop || 0;
   try {
-    const response = await loadSharedConversation(sharedToken, { limit: 120 });
+    // The reader has no socket today, so nothing moves the count; the guard
+    // keeps a rebuild from dropping a live row should one ever arrive.
+    const { response, stale } = await loadKeepingLiveRows(
+      () => loadSharedConversation(sharedToken, { limit: 120, open }),
+      getTranscriptLiveRowEpoch,
+    );
+    if (response?.status === 404) {
+      endSharedConversationReader();
+      return;
+    }
     if (requestSeq < sharedConversationAppliedSeq) return;
+    if (stale) return;
     if (!response?.ok) {
       const message = String(response?.error || 'Could not load shared conversation.').trim();
       if (message && message !== sharedConversationLastError) {
@@ -1050,6 +1118,7 @@ async function refreshSharedConversation() {
       return;
     }
     sharedConversationRenderKey = renderKey;
+    const preserveBottom = resolveLiveRefreshAtBottom(messagesEl, savedScrollTop, wasAtBottom);
     const stableSavedScrollTop = resolveStableScrollTopForLiveRefresh(messagesEl, savedScrollTop);
     applyLoadedConversationState(convId, response, {
       restoreScroll: !preserveBottom,
@@ -1065,15 +1134,29 @@ async function refreshSharedConversation() {
 
 async function pulseSharedViewerPresence() {
   const sharedToken = resolveSharedTokenFromLocation();
-  if (!sharedToken) return;
+  if (!sharedToken || sharedConversationEnded) return;
   await reportSharedViewerPresence(sharedToken, sharedViewerId()).catch(() => {});
 }
 
+// "Preview as shared": the owner's own page, so it says what it is and what
+// the highlights mean; the marks come with the preview payload.
+function initSharePreviewUi() {
+  if (!IS_SHARE_PREVIEW) return;
+  document.body.classList.add('share-preview-mode');
+  const banner = document.getElementById('share-preview-banner');
+  if (banner) {
+    banner.textContent = 'Preview as shared: this is what a share link shows. Green marks what viewers get instead of a path; amber marks what still looks like one. Free text is filtered on a best-effort basis.';
+  }
+  watchPreviewMarks(document.body);
+}
+
 async function initSharedConversationReader() {
   applySharedReaderUi();
-  await refreshSharedConversation();
+  initSharePreviewUi();
+  await refreshSharedConversation({ open: true });
   await pulseSharedViewerPresence();
   stopSharedModeTimers();
+  if (sharedConversationEnded) return;
   sharedConversationPollTimer = setInterval(() => {
     if (!shouldRunForegroundNetworkWork()) return;
     void refreshSharedConversation();
@@ -1090,6 +1173,12 @@ function showAuthError(msg) {
 
 function resolveAuthErrorMessage(result = null) {
   if (result?.status === 401) return 'Invalid token';
+  if (result?.status === 429) {
+    const seconds = Number(result?.payload?.retryAfterSeconds);
+    return Number.isFinite(seconds) && seconds > 0
+      ? `Too many failed sign-in attempts. Try again in ${Math.ceil(seconds)} seconds.`
+      : 'Too many failed sign-in attempts. Try again in a minute.';
+  }
   if (result?.status === 403) return 'Access denied';
   if (result?.status > 0) return `Authentication failed (${result.status})`;
   return String(result?.error || 'Could not reach the relay').trim() || 'Could not reach the relay';
@@ -1382,6 +1471,8 @@ function syncComposerPlaceholder() {
   if (!input) return;
   if (isSharedReaderMode()) return;
   if (imageEditTarget) return;
+  // The composer is locked until a provider is ready; its text says why.
+  if (input.dataset.setupLocked === '1') return;
   const rawValue = String(document.getElementById('model-select')?.value || '');
   const { baseModelId } = splitModelVariantId(rawValue);
   input.placeholder = composerPlaceholderFor({
@@ -1616,6 +1707,8 @@ function updateModelCatalogState(payload) {
   // Shared readers never load the catalog, so this would only surface
   // "metadata unavailable" warnings for a picker they cannot see.
   if (isSharedReaderMode()) return;
+  // The catalog's `source` is the Copilot readiness signal (provider-readiness.mjs).
+  updateProviderReadinessInputs({ catalog: payload && typeof payload === 'object' ? payload : null });
   const select = document.getElementById('model-select');
   if (!select) return;
   const models = Array.isArray(payload?.models)
@@ -2180,6 +2273,8 @@ function initModeSelector() {
 function refreshModelCatalog(force = false) {
   return loadModelCatalog().then((r) => {
     if (!r) {
+      // A failed load leaves provider readiness unknown: no setup wall on a blip.
+      updateProviderReadinessInputs({ catalog: null });
       if (isModelMetadataHealthy(modelCatalogState) || isModelMetadataHealthy(lastHealthyModelCatalogState)) {
         setModelBanner('⚠️ Could not refresh model metadata; using last known good catalog.');
         syncModelMetadataBlocker();
@@ -3630,24 +3725,35 @@ async function pollAuthenticatedCurrentConversationLive() {
   liveConversationPollInFlight = true;
   try {
     const messagesEl = document.getElementById('messages');
-    const preserveBottom = isMessagesAtBottom();
+    const wasAtBottom = isMessagesNearBottom();
     const savedScrollTop = messagesEl?.scrollTop || 0;
     const savedLoadedCount = loadConversationLoadedMessageCount(currentId);
     const requestLimit = Math.max(20, getConversationLoadedMessageCount() || 0, savedLoadedCount || 0);
     const jumpEpoch = getTranscriptJumpEpoch();
-    const response = await loadConversation(currentId, { limit: requestLimit });
+    const { response, stale } = await loadKeepingLiveRows(
+      () => loadConversation(currentId, { limit: requestLimit }),
+      getTranscriptLiveRowEpoch,
+    );
     if (!response) return;
     if (String(currentConvId || '').trim() !== currentId) return;
     // The user jumped into the history while this request was on its way: the
     // answer is the end of the conversation as it was asked for before that,
     // and would overwrite the window they jumped to. The next round asks again.
     if (getTranscriptJumpEpoch() !== jumpEpoch) return;
+    // Rows kept arriving through every request: the page has them, the answer
+    // does not. The next round asks again.
+    if (stale) return;
+    const preserveBottom = resolveLiveRefreshAtBottom(messagesEl, savedScrollTop, wasAtBottom);
     const stableSavedScrollTop = resolveStableScrollTopForLiveRefresh(messagesEl, savedScrollTop);
+    // The rows are rebuilt: a reader who is not at the end keeps the text
+    // they read where it is, whatever the rows above it measure now.
+    const reading = preserveBottom ? null : captureReadingBlock(messagesEl);
     applyLoadedConversationState(currentId, response, {
       restoreScroll: !preserveBottom,
       savedScrollTop: preserveBottom ? null : stableSavedScrollTop,
       followLiveUpdates: preserveBottom,
     });
+    if (reading) restoreReadingBlock(messagesEl, reading);
   } finally {
     liveConversationPollInFlight = false;
   }
@@ -3664,6 +3770,7 @@ function startLiveConversationPolling() {
 const transcriptResizeKeeper = createTranscriptResizeKeeper({
   getElement: () => document.getElementById('messages'),
 });
+onTranscriptEndLeft(() => transcriptResizeKeeper.recordEndLeft());
 
 function setupViewportTracking() {
   syncViewportMetrics();
@@ -3793,6 +3900,19 @@ function initMessageScrollPersistence() {
   }, { passive: true });
 }
 
+// The jump-to-bottom button on a window in the middle of the history: the
+// end of the conversation replaces it, scrolled to the bottom.
+async function loadCurrentConversationEnd() {
+  const currentId = String(currentConvId || '').trim();
+  if (!currentId) return;
+  const jumpEpoch = getTranscriptJumpEpoch();
+  const response = await loadConversation(currentId, { limit: 20 });
+  if (!response || String(currentConvId || '').trim() !== currentId) return;
+  // A jump into the history while it was on its way wins.
+  if (getTranscriptJumpEpoch() !== jumpEpoch) return;
+  applyLoadedConversationState(currentId, response, { restoreScroll: false });
+}
+
 async function runConversationHistoryRefresh({ source = 'menu' } = {}) {
   const currentId = String(currentConvId || '').trim();
   if (!currentId) {
@@ -3851,9 +3971,8 @@ async function refreshCurrentView() {
   const capturedVersion = ++refreshViewVersion;
   const jumpEpoch = getTranscriptJumpEpoch();
   const messagesEl = document.getElementById('messages');
-  const preserveBottom = isMessagesAtBottom();
+  const wasAtBottom = isMessagesNearBottom();
   const scrollTop = messagesEl?.scrollTop || 0;
-  const stableSavedScrollTop = resolveStableScrollTopForLiveRefresh(messagesEl, scrollTop);
 
   await refreshConversations();
 
@@ -3869,13 +3988,22 @@ async function refreshCurrentView() {
 
   const savedLoadedCount = loadConversationLoadedMessageCount(currentId);
   const requestLimit = Math.max(20, getConversationLoadedMessageCount() || 0, savedLoadedCount || 0);
-  const r = await loadConversation(currentId, { limit: requestLimit });
+  const { response: r, stale } = await loadKeepingLiveRows(
+    () => loadConversation(currentId, { limit: requestLimit }),
+    getTranscriptLiveRowEpoch,
+  );
   if (capturedVersion < refreshViewVersion) return;
   if (String(currentConvId || '').trim() !== currentId) return;
   // The user jumped into the history, before this refresh or while it was on
   // its way: title, tasks, pins and the rest are refreshed, the transcript
-  // and its scroll position are left as they are.
-  const keepTranscript = getTranscriptJumpEpoch() !== jumpEpoch || transcriptIsInHistory(currentId);
+  // and its scroll position are left as they are. So too when rows kept
+  // arriving through every request: the page has rows the answer lacks.
+  const keepTranscript = getTranscriptJumpEpoch() !== jumpEpoch || transcriptIsInHistory(currentId) || stale;
+  const preserveBottom = resolveLiveRefreshAtBottom(messagesEl, scrollTop, wasAtBottom);
+  const stableSavedScrollTop = resolveStableScrollTopForLiveRefresh(messagesEl, scrollTop);
+  // As in the live poll: the text the reader is at stays where it is.
+  const reading = preserveBottom || keepTranscript ? null : captureReadingBlock(messagesEl);
+  let restoredAt = null;
   if (r) {
     applyLoadedConversationState(currentId, r, {
       restoreScroll: !preserveBottom,
@@ -3883,6 +4011,9 @@ async function refreshCurrentView() {
       followLiveUpdates: preserveBottom && !keepTranscript,
       keepTranscript,
     });
+    // At once, and again below once the cards are back on the page.
+    restoreReadingBlock(messagesEl, reading);
+    restoredAt = { scrollTop: messagesEl?.scrollTop };
   } else {
     setRepoBrowserSessionInfo('', '');
     restoreInFlightThinking(null);
@@ -3891,7 +4022,12 @@ async function refreshCurrentView() {
   await loadRelayBoards();
   scheduleContextUsageRefresh(currentId, 0);
   if (messagesEl && !keepTranscript && String(currentConvId || '').trim() === currentId) {
-    if (!preserveBottom && Number.isFinite(stableSavedScrollTop) && stableSavedScrollTop >= 0) {
+    // Two requests later: a reader who has scrolled, pressed the jump
+    // button or sent something meanwhile is where they want to be.
+    const readerMoved = !restoredAt
+      || Math.abs(Number(messagesEl.scrollTop) - Number(restoredAt.scrollTop)) > 2;
+    if (!preserveBottom && !readerMoved && !restoreReadingBlock(messagesEl, reading)
+      && Number.isFinite(stableSavedScrollTop) && stableSavedScrollTop >= 0) {
       messagesEl.scrollTop = stableSavedScrollTop;
     }
     saveConversationScrollTop(currentId, messagesEl.scrollTop);
@@ -3951,7 +4087,7 @@ function getChatTitleElements() {
   return {
     wrap: document.getElementById('chat-title-wrap'),
     title: document.getElementById('chat-title'),
-    editBtn: document.getElementById('chat-actions-menu-btn'),
+    menuBtn: document.getElementById('chat-actions-menu-btn'),
     editor: document.getElementById('chat-title-editor'),
     input: document.getElementById('chat-title-input'),
     saveBtn: document.getElementById('chat-title-save-btn'),
@@ -3968,12 +4104,68 @@ function closeChatActionsMenu() {
   if (backdrop && !window.__chatActionsMenuShieldTimer) backdrop.classList.remove('visible');
 }
 
+// Writes one resolver decision to the DOM, the way the shared view hides its
+// entries: `hidden` alone for the text chips, plus `disabled`, `aria-hidden`
+// and the tab order for the buttons.
+function applyChatActionsMenuState(state) {
+  const trigger = document.getElementById('chat-actions-menu-btn');
+  if (trigger && state?.trigger) {
+    trigger.hidden = !!state.trigger.hidden;
+    trigger.disabled = !!state.trigger.disabled;
+  }
+  const entries = state?.entries || {};
+  for (const id of CHAT_ACTIONS_MENU_ENTRY_IDS) {
+    const element = document.getElementById(id);
+    const decision = entries[id];
+    if (!element || !decision) continue;
+    element.hidden = !!decision.hidden;
+    if (CHAT_ACTIONS_MENU_META_IDS.includes(id)) continue;
+    if (decision.hidden) {
+      element.setAttribute('aria-hidden', 'true');
+      if ('disabled' in element) element.disabled = true;
+      if ('tabIndex' in element) element.tabIndex = -1;
+      continue;
+    }
+    element.removeAttribute('aria-hidden');
+    if ('disabled' in element) element.disabled = !!decision.disabled;
+    if ('tabIndex' in element) element.tabIndex = 0;
+  }
+}
+
+// The ⋯ menu as it should look right now: the trigger and every entry,
+// decided in chat-actions-menu-state.mjs from the conversation on screen.
+function syncChatActionsMenuState() {
+  const convId = String(currentConvId || '').trim();
+  const conversation = convId ? (conversations[convId] || null) : null;
+  const isCloud = !!convId && isCurrentConversationClaudeCloud();
+  const state = resolveChatActionsMenuState({
+    sharedMode: isSharedReaderMode(),
+    conversationId: convId,
+    conversation,
+    sdkSessionId: String(conversation?.sdkSessionId || '').trim(),
+    isCloud,
+    cloudSessionUrl: isCloud ? buildCloudLineModel(conversation?.cloud)?.sessionUrl || null : null,
+    editing: !!convId && chatTitleEditingConversationId === convId,
+    suspendVisible: isSuspendHostActionVisible(),
+    hasActiveShare: hasActiveShare(convId),
+  });
+  applyChatActionsMenuState(state);
+  return state;
+}
+
+// The menu follows the relay's share list (made, renewed, stopped anywhere).
+subscribeShares(() => syncChatActionsMenuState());
+
 function toggleChatActionsMenu() {
   const menu = document.getElementById('chat-actions-menu');
   const trigger = document.getElementById('chat-actions-menu-btn');
-  if (!menu || !trigger || trigger.hidden || trigger.disabled) return;
+  if (!menu || !trigger) return;
+  // The entries match the moment of the tap, as Refresh history already does.
+  syncChatActionsMenuState();
+  if (trigger.hidden || trigger.disabled) return;
   syncRefreshHistoryMenuState();
   syncThemeMenuLabel();
+  syncAboutMenuLabel();
   const willOpen = !!menu.hidden;
   menu.hidden = !willOpen;
   trigger.setAttribute('aria-expanded', willOpen ? 'true' : 'false');
@@ -4050,12 +4242,13 @@ function lockChatActionsMenuShield(ms = 300) {
 
 
 function syncChatTitleControls() {
-  const { title, editBtn, editor, input } = getChatTitleElements();
+  const { title, editor, input } = getChatTitleElements();
   const convId = String(currentConvId || '').trim();
-  // No conversation open (deleted, new chat): its 📍 button goes with it.
-  if (!convId) setPinsConversation(null);
-  const killBtn = document.getElementById('chat-menu-kill-session');
-  const sharedMode = isSharedReaderMode();
+  // No conversation open (deleted, new chat): its 📍 and 🙈 buttons go with it.
+  if (!convId) {
+    setPinsConversation(null);
+    setHiddenMessagesConversation(null);
+  }
   const conversation = convId ? (conversations[convId] || null) : null;
   const sdkSessionId = String(conversation?.sdkSessionId || '').trim();
   if (title) {
@@ -4079,17 +4272,11 @@ function syncChatTitleControls() {
   const editing = convId && chatTitleEditingConversationId === convId;
   document.body.classList.toggle('chat-title-editing', !!editing);
   if (title) title.hidden = editing;
-  if (editBtn) {
-    editBtn.hidden = !convId;
-    editBtn.disabled = !convId || editing;
-  }
-  if (killBtn) {
-    killBtn.disabled = sharedMode || !convId || !sdkSessionId;
-    killBtn.hidden = sharedMode || !convId;
-  }
+  // The ⋯ trigger and its entries: relay-wide ones stay with no conversation
+  // open, so Settings is always one tap away.
+  syncChatActionsMenuState();
   const archiveBtn = document.getElementById('chat-menu-archive');
   if (archiveBtn) {
-    archiveBtn.hidden = sharedMode || !convId;
     archiveBtn.textContent = conversation?.archived === true ? '📂 Unarchive conversation' : '🗄 Archive conversation';
   }
   if (editor) {
@@ -4112,19 +4299,21 @@ function syncChatTitleControls() {
   syncClaudeCloudConversationUi();
   // "via agent": the conversation an agent on this relay started this one from.
   syncConversationOriginHeader();
+  // Relay events: "watching N sessions" on a watcher, "watched" on a watched one.
+  syncRelayEventHeader();
   syncChatTitleWatcherIndicator();
 }
 
 function openChatTitleEditor() {
   const convId = String(currentConvId || '').trim();
   if (!convId) return;
-  const { title, editBtn, editor, input } = getChatTitleElements();
+  const { title, menuBtn, editor, input } = getChatTitleElements();
   closeChatActionsMenu();
   const currentTitle = String(conversations[convId]?.title || title?.textContent || convId).trim() || convId;
   chatTitleEditingConversationId = convId;
   document.body.classList.add('chat-title-editing');
   if (title) title.hidden = true;
-  if (editBtn) editBtn.disabled = true;
+  if (menuBtn) menuBtn.disabled = true;
   if (editor) editor.hidden = false;
   if (input) {
     input.maxLength = CHAT_TITLE_MAX_LENGTH;
@@ -4143,11 +4332,11 @@ function openChatTitleEditor() {
 function closeChatTitleEditor() {
   chatTitleEditingConversationId = null;
   document.body.classList.remove('chat-title-editing');
-  const { title, editBtn, editor, input } = getChatTitleElements();
+  const { title, editor, input } = getChatTitleElements();
   closeChatActionsMenu();
   if (editor) editor.hidden = true;
   if (title) title.hidden = !String(currentConvId || '').trim();
-  if (editBtn) editBtn.disabled = !String(currentConvId || '').trim();
+  // The trigger is decided by the syncChatTitleControls() call below.
   if (input) {
     const convId = String(currentConvId || '').trim();
     input.value = convId ? String(conversations[convId]?.title || title?.textContent || convId) : '';
@@ -4317,19 +4506,19 @@ async function initApp() {
   appSharedMode = sharedMode;
   initNetworkLifecycleHandling();
   setForegroundNetworkWorkEnabled(document.visibilityState === 'visible');
-  const sharedThemeBtn = document.getElementById('chat-menu-shared-theme-toggle');
   initTheme();
   initScrollbarHover();
   initThemeMenuToggle();
-  if (sharedThemeBtn && sharedMode) sharedThemeBtn.hidden = false;
   initFontScaling();
   if (!sharedMode) {
     clearLegacyKnownCwdHistoryStorage();
   }
   syncPwaVersionMenuEntry();
   syncQueueStatusMenuEntry();
+  if (!sharedMode) syncAboutMenuLabel();
   if (!sharedMode) {
     syncSuspendHostVisibility();
+    syncScrollOnSendToggle();
     initHostSuspendUi();
     initUsageLimitUi();
   }
@@ -4394,6 +4583,16 @@ async function initApp() {
         });
       });
     }
+    // "Session group…": the picker for the open conversation, reachable on
+    // the phone with the drawer closed.
+    bindMenuAction(document.getElementById('chat-menu-group'), (event) => {
+      event.preventDefault();
+      event.stopPropagation();
+      lockChatActionsMenuShield(350);
+      closeChatActionsMenu();
+      const convId = String(currentConvId || '').trim();
+      if (convId) openConversationGroupPicker(convId);
+    });
     const chatMenuArchiveBtn = document.getElementById('chat-menu-archive');
     bindMenuAction(chatMenuArchiveBtn, (event) => {
       event.preventDefault();
@@ -4424,10 +4623,35 @@ async function initApp() {
         }
         const copied = await copyTextToClipboard(shareUrl);
         showTransientRelayNotice(copied ? 'Share link copied to clipboard.' : shareUrl);
+        void refreshShares().catch(() => {});
       }).catch((error) => {
         showTransientRelayNotice(error?.message || 'Could not create share link.');
       });
     });
+    // "Stop sharing": only shown while the open conversation has a live link.
+    bindMenuAction(document.getElementById('chat-menu-stop-sharing'), (event) => {
+      event.preventDefault();
+      event.stopPropagation();
+      lockChatActionsMenuShield(350);
+      closeChatActionsMenu();
+      const convId = String(currentConvId || '').trim();
+      if (!convId) return;
+      openStopSharingConfirmation(convId, conversations[convId]?.title || '');
+    });
+    const chatMenuPreviewSharedBtn = document.getElementById('chat-menu-preview-shared');
+    bindMenuAction(chatMenuPreviewSharedBtn, (event) => {
+      event.preventDefault();
+      event.stopPropagation();
+      lockChatActionsMenuShield(350);
+      closeChatActionsMenu();
+      const convId = String(currentConvId || '').trim();
+      if (!convId) {
+        showTransientRelayNotice('Select a conversation first.');
+        return;
+      }
+      // Never creates a share link: the preview reads through the owner's route.
+      window.open(`${BASE}/share-preview/${encodeURIComponent(convId)}`, '_blank', 'noopener');
+    });
     const chatMenuRefreshHistoryBtn = document.getElementById('chat-menu-refresh-history');
     if (chatMenuRefreshHistoryBtn && !chatMenuRefreshHistoryBtn.hidden && !chatMenuRefreshHistoryBtn.disabled) {
       bindMenuAction(chatMenuRefreshHistoryBtn, (event) => {
@@ -4480,6 +4704,14 @@ async function initApp() {
       closeChatActionsMenu();
       openSettingsModal();
     });
+    const chatMenuAboutBtn = document.getElementById('chat-menu-about');
+    bindMenuAction(chatMenuAboutBtn, (event) => {
+      event.preventDefault();
+      event.stopPropagation();
+      lockChatActionsMenuShield(350);
+      closeChatActionsMenu();
+      void showAbout();
+    });
     const chatMenuRestartRelayBtn = document.getElementById('chat-menu-restart-relay');
     bindMenuAction(chatMenuRestartRelayBtn, (event) => {
       event.preventDefault();
@@ -4556,6 +4788,8 @@ async function initApp() {
     initConversationHistoryLazyLoading();
     initBubbleActionHandlers();
     initMessageScrollPersistence();
+    initTranscriptJumpToBottom();
+    initSubagentViewer();
     syncChatTitleControls();
     await initSharedConversationReader();
     return;
@@ -4578,14 +4812,25 @@ async function initApp() {
   const status = await refreshWorkspaceRootHints();
   syncQueueStatusMenuEntry(status);
   setSessionWorkerStatesFromStatusPayload(status?.sessionWorker || null);
-  await refreshOpenAISettingsState();
-  await refreshCursorSettingsState();
-  await refreshGrokSettingsState();
+  const openAISettings = await refreshOpenAISettingsState();
+  const cursorSettings = await refreshCursorSettingsState();
+  const grokSettings = await refreshGrokSettingsState();
+  // Loaded here for provider readiness: whether any provider can run a chat
+  // decides what the empty screen, New Chat and the composer offer.
+  const claudeSettings = await refreshClaudeSettingsState();
+  updateProviderReadinessInputs({
+    openai: openAISettings || null,
+    cursor: cursorSettings || null,
+    grok: grokSettings || null,
+    claude: claudeSettings || null,
+  });
   // Not awaited: only a Claude Cloud conversation needs it (its model list),
   // and the subscription below rebuilds that list when the answer arrives. A
   // relay without the provider answers nothing and nothing changes.
   subscribeClaudeCloudSettings(refreshClaudeCloudComposerModels);
-  void refreshClaudeCloudSettingsState();
+  void refreshClaudeCloudSettingsState().then((state) => {
+    updateProviderReadinessInputs({ claudeCloud: state || null });
+  });
   await refreshModelCatalog(true);
   initFullscreenButton();
   initInstallButton();
@@ -4599,15 +4844,25 @@ async function initApp() {
   initConversationHistoryLazyLoading();
   initBubbleActionHandlers();
   initMessageScrollPersistence();
+  initTranscriptJumpToBottom({ loadEnd: loadCurrentConversationEnd });
   initComposerAttachmentInput();
   initMessageSearchView({ openConversation });
+  initSubagentViewer();
   initPinnedMessagesView({
     openConversation,
     focusMessage: focusConversationMessageById,
     syncRenderedPinState,
   });
+  initHiddenMessagesView({ syncRenderedShareVisibility });
   initGitChangesView();
   syncChatTitleControls();
+  // A provider turned on or off (a Settings save, a catalog change) redraws
+  // the empty screen and the composer without a reload.
+  subscribeProviderReadiness(() => {
+    renderNoConversationState();
+    syncComposerButtonState();
+    syncComposerPlaceholder();
+  });
   connectSocket();
   startRelayConnectionWatchdog();
   startDeviceVisibilityHeartbeat();
@@ -4619,6 +4874,9 @@ async function initApp() {
   // Browsers without Background Sync replay the outbox from the page instead.
   void initOutboxFallbackReplay();
   await loadConversations();
+  // The sidebar's "watched" badges follow the subscriptions.
+  onRelayEventSubscriptionsChanged(() => renderConvList());
+  void loadRelayEventSubscriptions();
   const pushConversationId = consumePushConversationDeepLink();
   if (pushConversationId) {
     await openConversation(pushConversationId).catch(() => {});
@@ -4626,7 +4884,19 @@ async function initApp() {
   await loadRelayQuestions(currentConvId);
   await loadRelayBoards();
   updateCompactButton();
-  document.getElementById('msg-input').focus();
+  // Nothing opened (fresh client, fresh relay, a last conversation that is
+  // gone): the static markup gives way to the real empty screen.
+  renderNoConversationState();
+  syncComposerButtonState();
+  syncComposerPlaceholder();
+  // A phone shows no keyboard for this focus, but the next tap that keeps it
+  // (the transcript's ⌄) would raise one.
+  if (shouldAutofocusComposerOnLoad({
+    coarsePointer: !!window.matchMedia?.('(pointer: coarse)')?.matches,
+    phoneLayout: isMobileComposerViewport(),
+  })) {
+    document.getElementById('msg-input').focus();
+  }
 }
 
 async function doAuth() {
@@ -4647,7 +4917,9 @@ async function doAuth() {
 async function bootstrap() {
   if (ensureTrailingSlashPath()) return;
   const sharedMode = isSharedReaderMode();
-  if (sharedMode && navigator.serviceWorker?.getRegistrations) {
+  // The preview runs in the owner's own browser: their app's service worker
+  // (and its push subscription) stays.
+  if (sharedMode && !IS_SHARE_PREVIEW && navigator.serviceWorker?.getRegistrations) {
     navigator.serviceWorker.getRegistrations()
       .then((registrations) => Promise.all(registrations.map((registration) => registration.unregister().catch(() => false))))
       .catch(() => {});
@@ -4734,11 +5006,13 @@ window.saveGrokAllowanceSettings = saveGrokAllowanceSettings;
 window.resetGrokAllowanceAccounting = resetGrokAllowanceAccounting;
 window.toggleCursorProvider = toggleCursorProvider;
 window.updateShowSuspendHostSetting = updateShowSuspendHostSetting;
+window.updateScrollOnSendSetting = (enabled) => updateScrollOnSendSetting(enabled);
 window.updateWindowsAutostartMode = updateWindowsAutostartMode;
 window.previewTurnCeilingSetting = previewTurnCeilingSetting;
 window.updateTurnCeilingSetting = updateTurnCeilingSetting;
 window.previewBackgroundTaskTimeoutSetting = previewBackgroundTaskTimeoutSetting;
 window.updateBackgroundTaskTimeoutSetting = updateBackgroundTaskTimeoutSetting;
+window.updateSubagentRecordRetentionSetting = updateSubagentRecordRetentionSetting;
 window.togglePushOnThisDevice = togglePushOnThisDevice;
 window.updatePushPreferencesFromControls = updatePushPreferencesFromControls;
 window.openSettingsModal = openSettingsModal;
@@ -4787,6 +5061,8 @@ window.confirmNewConversationModel = confirmNewConversationModel;
 window.closeNewConversationModelModal = closeNewConversationModelModal;
 window.deleteConv = deleteConv;
 window.archiveConv = archiveConv;
+window.openConversationGroupPicker = openConversationGroupPicker;
+window.toggleConversationGroupFold = toggleConversationGroupFold;
 window.unarchiveConv = unarchiveConv;
 window.toggleArchivedConversations = toggleArchivedConversations;
 window.refreshNewConversationCloudRepoList = refreshNewConversationCloudRepoList;
@@ -4815,6 +5091,7 @@ window.toggleRepoBrowserHidden = toggleRepoBrowserHidden;
 window.toggleRepoBrowserHeavy = toggleRepoBrowserHeavy;
 window.focusRepoTree = focusRepoTree;
 window.setRepoCurrentPath = setRepoCurrentPath;
+window.startRepoNewFolder = startRepoNewFolder;
 window.confirmRepoBrowserCwdPick = confirmRepoBrowserCwdPick;
 window.toggleEmojiPicker = toggleEmojiPicker;
 window.submitRelayQuestionChoice = submitRelayQuestionChoice;