@oar-sh/oar 0.9.2 → 0.9.4

package/server/public/app/emoji-view.js

@@ -43,6 +43,8 @@ function insertEmojiAtCaret(emoji) {
   input.selectionEnd = nextCaret;
   autoResize(input);
   input.focus();
+  // Runs the composer's input pipeline, which saves the draft.
+  input.dispatchEvent(new Event('input', { bubbles: true }));
 }
 
 function handleEmojiChoice(emoji) {

package/server/public/app/font-scaling.js

@@ -1,3 +1,5 @@
+import { captureTranscriptAnchor, restoreTranscriptAnchor } from './transcript-viewport-anchor.mjs';
+
 const FONT_SCALE_STORAGE_KEY = 'copilot_font_scale';
 const FONT_SCALE_MIN = 0.5;
 const FONT_SCALE_MAX = 1.5;
@@ -53,41 +55,6 @@ function normalizeFontScaleSelectValue(raw = '') {
   return clampFontScale(numeric);
 }
 
-function getMessageViewportAnchor() {
-  const container = document.getElementById('messages');
-  if (!container) return null;
-  const containerRect = container.getBoundingClientRect();
-  const messages = Array.from(container.querySelectorAll('.msg[data-message-id]'));
-  for (const message of messages) {
-    const rect = message.getBoundingClientRect();
-    if (rect.bottom <= containerRect.top || rect.top >= containerRect.bottom) continue;
-    const messageId = String(message.dataset.messageId || '').trim();
-    if (!messageId) continue;
-    return {
-      messageId,
-      offsetTop: rect.top - containerRect.top,
-    };
-  }
-  return null;
-}
-
-function restoreMessageViewportAnchor(anchor) {
-  if (!anchor?.messageId) return;
-  const container = document.getElementById('messages');
-  if (!container) return;
-  const messageId = String(anchor.messageId || '').trim();
-  if (!messageId) return;
-  const message = Array.from(container.querySelectorAll('.msg[data-message-id]'))
-    .find((node) => String(node?.dataset?.messageId || '').trim() === messageId);
-  if (!message) return;
-  const containerRect = container.getBoundingClientRect();
-  const rect = message.getBoundingClientRect();
-  const delta = rect.top - containerRect.top - Number(anchor.offsetTop || 0);
-  if (Math.abs(delta) > 0.5) {
-    container.scrollTop += delta;
-  }
-}
-
 export function syncFontScaleSelect() {
   const select = document.getElementById('font-scale-select');
   if (!select) return;
@@ -117,7 +84,7 @@ export function setFontScale(nextScale, { persist = true, preserveMessageAnchor
     syncFontScaleSelect();
     return normalized;
   }
-  const anchor = preserveMessageAnchor ? getMessageViewportAnchor() : null;
+  const anchor = preserveMessageAnchor ? captureTranscriptAnchor(document.getElementById('messages')) : null;
   fontScaleValue = normalized;
   document.documentElement.style.setProperty('--font-scale', normalized.toFixed(4));
   document.documentElement.style.setProperty('--font-scale-percent', `${Math.round(normalized * 100)}%`);
@@ -125,7 +92,7 @@ export function setFontScale(nextScale, { persist = true, preserveMessageAnchor
   syncFontScaleSelect();
   if (anchor) {
     requestAnimationFrame(() => {
-      restoreMessageViewportAnchor(anchor);
+      restoreTranscriptAnchor(document.getElementById('messages'), anchor);
     });
   }
   return normalized;

package/server/public/app/host-suspend-ui.js

@@ -0,0 +1,272 @@
+// Pending host suspend / relay restart, as every device sees it: an app-wide
+// banner with a countdown and Cancel, plus the chat-actions menu labels.
+// State arrives over the socket (`host_suspend_state`, `relay_shutdown_state`)
+// and is also re-read from GET /api/status polls, so a client that missed an
+// event still catches up. The banner ignores the per-device "Show Suspend
+// host action" setting on purpose: a device with the action hidden must still
+// be able to see and cancel a queued suspend.
+
+import { escHtml, showTransientRelayNotice } from './store.js';
+import { cancelHostSuspend, cancelRelayRestart } from './api-client.js';
+
+const BANNER_ID = 'pending-action-banner';
+const SUSPEND_MENU_ID = 'chat-menu-suspend-host';
+const RESTART_MENU_ID = 'chat-menu-restart-relay';
+const SUSPEND_MENU_LABEL = '💤 Suspend host';
+const SUSPEND_MENU_PENDING_LABEL = '💤 Suspend pending…';
+const RESTART_MENU_LABEL = '🌄 Restart web relay';
+const RESTART_MENU_PENDING_LABEL = '🌄 Restart pending…';
+
+let hostSuspendState = null;
+let relayShutdownState = null;
+let countdownTimer = null;
+let cancelInFlight = false;
+
+export function getHostSuspendState() {
+  return hostSuspendState;
+}
+
+export function getRelayShutdownState() {
+  return relayShutdownState;
+}
+
+export function isHostSuspendPending(state = hostSuspendState) {
+  const status = String(state?.status || '').trim();
+  return status === 'queued' || status === 'countdown' || status === 'suspending';
+}
+
+export function isRelayShutdownPending(state = relayShutdownState) {
+  const status = String(state?.status || '').trim();
+  return status === 'queued' || status === 'shutting_down';
+}
+
+/** "0:27" style remaining time from a fireAt ISO string; null when not counting. */
+export function formatCountdown(fireAt, nowMs = Date.now()) {
+  const target = Date.parse(String(fireAt || ''));
+  if (!Number.isFinite(target)) return null;
+  const remaining = Math.max(0, Math.ceil((target - nowMs) / 1000));
+  const minutes = Math.floor(remaining / 60);
+  const seconds = remaining % 60;
+  return `${minutes}:${String(seconds).padStart(2, '0')}`;
+}
+
+/** One human line per blocker, e.g. "sidebar polish — 2 background agents: …". */
+export function describeHostSuspendBlocker(blocker) {
+  if (!blocker || typeof blocker !== 'object') return '';
+  const title = String(blocker.title || '').trim();
+  const detail = String(blocker.detail || '').trim();
+  switch (String(blocker.kind || '')) {
+    case 'turn':
+      return `${title || 'a session'} — ${detail || 'turn running'}`;
+    case 'background':
+      return `${title || 'a session'} — ${detail || 'background agents running'}`;
+    case 'ci':
+      return `CI ${title ? `in ${title}` : ''} — ${detail || 'runs open'}`.replace(/\s+—/, ' —');
+    case 'ci-unknown':
+      return detail || `CI state of ${title || 'a repository'} unknown`;
+    case 'ci-checking':
+      return detail || 'Checking CI state';
+    case 'error':
+      return detail || 'Activity check failed';
+    default:
+      return [title, detail].filter(Boolean).join(' — ');
+  }
+}
+
+/** Short banner summary: first two blockers, "+N more". */
+export function summarizeHostSuspendBlockers(blockers) {
+  const list = (Array.isArray(blockers) ? blockers : []).map(describeHostSuspendBlocker).filter(Boolean);
+  if (!list.length) return '';
+  const shown = list.slice(0, 2);
+  const rest = list.length - shown.length;
+  return shown.join('; ') + (rest > 0 ? `; +${rest} more` : '');
+}
+
+export function hostSuspendBannerText(state, nowMs = Date.now()) {
+  if (!isHostSuspendPending(state)) return '';
+  const status = String(state.status || '');
+  if (status === 'suspending') return '💤 Suspending host now…';
+  if (status === 'countdown') {
+    const countdown = formatCountdown(state.fireAt, nowMs);
+    return countdown ? `💤 Everything is idle — suspending host in ${countdown}` : '💤 Everything is idle — suspending host shortly';
+  }
+  const summary = summarizeHostSuspendBlockers(state.blockers);
+  return summary
+    ? `💤 Suspend queued — waiting for: ${summary}`
+    : '💤 Suspend queued — waiting for running agents to finish';
+}
+
+export function relayShutdownBannerText(state) {
+  if (!isRelayShutdownPending(state)) return '';
+  const action = state.action === 'restart' || state.restart ? 'restart' : 'shutdown';
+  const icon = action === 'restart' ? '🌄' : '⏻';
+  if (String(state.status || '') === 'shutting_down') {
+    return `${icon} Relay ${action === 'restart' ? 'restarting' : 'shutting down'} now…`;
+  }
+  const queue = state.queue || {};
+  const turns = Number(queue.pendingCount || 0) + Number(queue.processingCount || 0) + Number(queue.parkedCount || 0);
+  const waiting = turns > 0 ? `waiting for ${turns} turn${turns === 1 ? '' : 's'} to finish` : 'queue is idle, going down now';
+  return `${icon} Relay ${action} queued — ${waiting}`;
+}
+
+function ensureBanner() {
+  let banner = document.getElementById(BANNER_ID);
+  if (banner) return banner;
+  banner = document.createElement('div');
+  banner.id = BANNER_ID;
+  banner.setAttribute('role', 'status');
+  banner.setAttribute('aria-live', 'polite');
+  document.body?.appendChild(banner);
+  return banner;
+}
+
+function bannerRow({ text, cancelLabel, onCancel, key }) {
+  const row = document.createElement('div');
+  row.className = 'pending-action-row';
+  row.dataset.pending = key;
+  const label = document.createElement('span');
+  label.className = 'pending-action-text';
+  label.textContent = text;
+  row.appendChild(label);
+  if (cancelLabel && typeof onCancel === 'function') {
+    const btn = document.createElement('button');
+    btn.type = 'button';
+    btn.className = 'relay-toast-action pending-action-cancel';
+    btn.textContent = cancelLabel;
+    btn.disabled = cancelInFlight;
+    btn.addEventListener('click', (event) => {
+      event.preventDefault();
+      event.stopPropagation();
+      void onCancel();
+    });
+    row.appendChild(btn);
+  }
+  return row;
+}
+
+async function runCancelHostSuspend() {
+  if (cancelInFlight) return;
+  cancelInFlight = true;
+  renderPendingActionBanner();
+  try {
+    const result = await cancelHostSuspend();
+    if (!result?.ok) {
+      showTransientRelayNotice('Failed to cancel the queued suspend.', 5000);
+      return;
+    }
+    if (result.state) applyHostSuspendState(result.state);
+    showTransientRelayNotice(result.cancelled ? 'Queued host suspend cancelled.' : 'No host suspend was pending.', 4000);
+  } finally {
+    cancelInFlight = false;
+    renderPendingActionBanner();
+  }
+}
+
+async function runCancelRelayShutdown() {
+  if (cancelInFlight) return;
+  cancelInFlight = true;
+  renderPendingActionBanner();
+  try {
+    const result = await cancelRelayRestart();
+    if (!result?.ok) {
+      showTransientRelayNotice('Failed to cancel the queued relay restart.', 5000);
+      return;
+    }
+    applyRelayShutdownState(result);
+    showTransientRelayNotice(result.cancelled ? 'Queued relay restart cancelled.' : 'No relay restart was pending.', 4000);
+  } finally {
+    cancelInFlight = false;
+    renderPendingActionBanner();
+  }
+}
+
+function syncCountdownTimer() {
+  const needsTicker = isHostSuspendPending() && String(hostSuspendState?.status || '') === 'countdown' && hostSuspendState?.fireAt;
+  if (needsTicker && !countdownTimer) {
+    countdownTimer = setInterval(() => renderPendingActionBanner(), 1000);
+  } else if (!needsTicker && countdownTimer) {
+    clearInterval(countdownTimer);
+    countdownTimer = null;
+  }
+}
+
+export function renderPendingActionBanner() {
+  if (typeof document === 'undefined') return;
+  const rows = [];
+  if (isHostSuspendPending()) {
+    rows.push(bannerRow({
+      key: 'host-suspend',
+      text: hostSuspendBannerText(hostSuspendState),
+      cancelLabel: String(hostSuspendState?.status || '') === 'suspending' ? '' : 'Cancel',
+      onCancel: runCancelHostSuspend,
+    }));
+  }
+  if (isRelayShutdownPending()) {
+    const restarting = String(relayShutdownState?.status || '') === 'shutting_down';
+    rows.push(bannerRow({
+      key: 'relay-shutdown',
+      text: relayShutdownBannerText(relayShutdownState),
+      cancelLabel: restarting ? '' : 'Cancel',
+      onCancel: runCancelRelayShutdown,
+    }));
+  }
+  const banner = document.getElementById(BANNER_ID) || (rows.length ? ensureBanner() : null);
+  if (!banner) return;
+  banner.replaceChildren(...rows);
+  banner.classList.toggle('visible', rows.length > 0);
+  banner.hidden = rows.length === 0;
+  syncMenuLabels();
+  syncCountdownTimer();
+}
+
+function syncMenuLabels() {
+  const suspendBtn = document.getElementById(SUSPEND_MENU_ID);
+  if (suspendBtn) suspendBtn.textContent = isHostSuspendPending() ? SUSPEND_MENU_PENDING_LABEL : SUSPEND_MENU_LABEL;
+  const restartBtn = document.getElementById(RESTART_MENU_ID);
+  if (restartBtn) restartBtn.textContent = isRelayShutdownPending() ? RESTART_MENU_PENDING_LABEL : RESTART_MENU_LABEL;
+}
+
+export function applyHostSuspendState(state) {
+  const previous = hostSuspendState;
+  hostSuspendState = state && typeof state === 'object' ? state : null;
+  if (isHostSuspendPending(previous) && !isHostSuspendPending(hostSuspendState) && hostSuspendState?.lastError) {
+    showTransientRelayNotice(`Host suspend failed: ${hostSuspendState.lastError}`, 8000);
+  }
+  renderPendingActionBanner();
+}
+
+export function applyRelayShutdownState(state) {
+  relayShutdownState = state && typeof state === 'object' ? state : null;
+  renderPendingActionBanner();
+}
+
+/** GET /api/status carries both states; the poll keeps late clients honest. */
+export function applyPendingActionsFromStatus(status) {
+  if (!status || typeof status !== 'object') return;
+  if ('hostSuspend' in status) hostSuspendState = status.hostSuspend || null;
+  if ('relayShutdown' in status) {
+    const next = status.relayShutdown ? { ...status.relayShutdown } : null;
+    if (next && !next.queue) {
+      next.queue = {
+        pendingCount: Number(status.pendingCount || 0),
+        processingCount: Number(status.processingCount || 0),
+        parkedCount: Number(status.parkedCount || 0),
+      };
+    }
+    relayShutdownState = next;
+  }
+  renderPendingActionBanner();
+}
+
+export function initHostSuspendUi() {
+  renderPendingActionBanner();
+}
+
+export function __resetHostSuspendUiForTests() {
+  hostSuspendState = null;
+  relayShutdownState = null;
+  cancelInFlight = false;
+  if (countdownTimer) { clearInterval(countdownTimer); countdownTimer = null; }
+  document.getElementById(BANNER_ID)?.remove();
+  syncMenuLabels();
+}

package/server/public/app/journal-view.js

@@ -36,7 +36,7 @@ import {
   loadGrokSettings,
   loadOpenAISettings,
 } from './api-client.js';
-import { renderMessages, restoreInFlightThinking, focusConversationMessageById, flushConversationDraft, hydrateConversationDraft } from './conversation-view.js';
+import { renderMessages, restoreInFlightThinking, focusConversationMessageById, flushConversationDraft, hydrateConversationDraft, beginConversationDraftSwitch } from './conversation-view.js';
 import { setBackgroundTasksConversation, setConversationBackgroundTasks } from './background-tasks-view.mjs';
 import { mergeConversationPreviews } from './preview-cards.mjs';
 import { loadRelayQuestions, getPendingQuestionCountsByConversation } from './ask-user-view.js';
@@ -58,6 +58,13 @@ import {
   conversationProviderIndicatorLabel,
 } from './conversation-provider-indicator.mjs';
 import { leaveStatusView } from './status-view.mjs';
+import { renderConversationOriginMarkerHtml } from './remote-relay-origin-view.mjs';
+import {
+  normalizeConversationFilter,
+  filterConversations,
+  drainRemainingPages,
+  describeFilterMatchCount,
+} from './conversation-list-filter.mjs';
 
 const PROCESSING_DOT_FRAMES = ['   ', '.  ', '.. ', '...'];
 const PROCESSING_DOT_INTERVAL_MS = 1000;
@@ -74,9 +81,13 @@ const CLAUDE_LONG_CONTEXT_PATTERN = /\[1m\]$/i;
 const OPENAI_IMAGE_SIZE_STORAGE_KEY = 'copilot_openai_image_size';
 const NEW_CHAT_CWD_STORAGE_KEY = 'copilot_new_chat_cwd';
 const NEW_CHAT_CUSTOM_CWD_VALUE = '__custom__';
+const CONV_FILTER_DEBOUNCE_MS = 220;
 let processingDotFrame = 0;
 let processingDotTimer = null;
 let lastConvListHtml = '';
+let conversationListFilterText = '';
+let conversationFilterDrainActive = false;
+let conversationFilterGeneration = 0;
 let openConversationVersion = 0;
 let newConversationInFlight = false;
 
@@ -273,6 +284,11 @@ export async function refreshConversations(options = {}) {
   });
   renderConvList();
   updateCompactButton();
+  // A reset bumps the loader version, which aborts any in-flight filter drain;
+  // restart it so an active filter keeps covering the unloaded pages.
+  if (normalizeConversationFilter(conversationListFilterText)) {
+    void drainConversationListForFilter();
+  }
 }
 
 export function renderConvList() {
@@ -282,9 +298,19 @@ export function renderConvList() {
     if (updatedAtDelta !== 0) return updatedAtDelta;
     return String(b?.id || '').trim().localeCompare(String(a?.id || '').trim());
   });
+  const activeFilter = normalizeConversationFilter(conversationListFilterText);
+  const visible = activeFilter ? filterConversations(sorted, activeFilter) : sorted;
   const pendingByConversation = getPendingQuestionCountsByConversation();
   let hasProcessingConversation = false;
   const footerHtml = (() => {
+    if (activeFilter) {
+      // While a filter is active the drain loads older pages by itself; a
+      // "scroll for more" hint would point at a gesture that does nothing, and
+      // "Searching…" must only show while something is actually loading.
+      return (conversationFilterDrainActive || conversationListPaginationState.isLoading)
+        ? '<div class="conv-list-footer">Searching older conversations…</div>'
+        : '';
+    }
     if (conversationListPaginationState.isLoading) {
       return '<div class="conv-list-footer">Loading older conversations…</div>';
     }
@@ -293,10 +319,14 @@ export function renderConvList() {
     }
     return '';
   })();
-  if (sorted.length === 0) {
+  if (visible.length === 0) {
     ensureProcessingDotTimer(false);
-    list.innerHTML = '<div style="padding:12px;color:var(--muted);font-size:0.85rem;text-align:center">No conversations yet</div>';
+    const emptyText = activeFilter && sorted.length > 0
+      ? 'No conversations match your filter'
+      : 'No conversations yet';
+    list.innerHTML = `<div style="padding:12px;color:var(--muted);font-size:0.85rem;text-align:center">${emptyText}</div>${footerHtml}`;
     lastConvListHtml = '';
+    scheduleConversationListBoundaryCheck();
     return;
   }
   const conversationView = (conversation) => {
@@ -312,7 +342,7 @@ export function renderConvList() {
     if (processing) hasProcessingConversation = true;
     return { visualState, processing };
   };
-  const listHtml = `${sorted.map((c) => {
+  const listHtml = `${visible.map((c) => {
     const view = conversationView(c);
     const processingDots = view.processing ? PROCESSING_DOT_FRAMES[processingDotFrame] : '';
     const providerIndicatorLabel = conversationProviderIndicatorLabel(c);
@@ -320,10 +350,12 @@ export function renderConvList() {
     const providerIndicatorHtml = providerIndicatorLabel
       ? `<span class="conv-provider-indicator"${providerIndicatorKey ? ` data-provider="${providerIndicatorKey}"` : ''}>${providerIndicatorLabel}</span>`
       : '';
+    // "↗ win-test": another relay's agent created this conversation.
+    const originMarkerHtml = renderConversationOriginMarkerHtml(c);
     return `
     <div class="conv-item worker-ui-${view.visualState}${c.id === currentConvId ? ' active' : ''}" onclick="openConversation('${c.id}')">
       <div class="conv-title">${escHtml(c.title)}${processingDots ? `<span class="conv-processing-dots">${escHtml(` ${processingDots}`)}</span>` : ''}${c.archived ? ' <span style="font-size:0.68rem;color:var(--muted)">(archived)</span>' : ''}${pendingByConversation[c.id] ? ` <span class="conv-open-questions">${pendingByConversation[c.id]} open</span>` : ''}</div>
-      <div class="conv-meta"><span class="conv-meta-primary">${fmtDate(c.updatedAt)} · ${c.messageCount} msg${c.messageCount !== 1 ? 's' : ''}</span>${providerIndicatorHtml}</div>
+      <div class="conv-meta"><span class="conv-meta-primary">${fmtDate(c.updatedAt)} · ${c.messageCount} msg${c.messageCount !== 1 ? 's' : ''}</span>${originMarkerHtml}${providerIndicatorHtml}</div>
       <button class="conv-delete" onclick="deleteConv(event,'${c.id}')" title="Delete">🗑</button>
     </div>`;
   }).join('')}${footerHtml}`;
@@ -427,6 +459,7 @@ export async function openConversation(id, options = {}) {
     await flushConversationDraft(previousConversationId);
     window.clearImageEditTarget?.();
   }
+  const switchingConversation = !!nextConversationId && previousConversationId !== nextConversationId;
   const capturedVersion = ++openConversationVersion;
   setCurrentConv(id);
   if (repoBrowserState.activeRoot === 'workspace') {
@@ -440,7 +473,13 @@ export async function openConversation(id, options = {}) {
     repoBrowserState.error = '';
   }
   closeSidebar();
-  clearAttachments();
+  // Reopening the conversation on screen (session bind, clicking it again, a
+  // push or search jump) must leave its composer alone: emptied attachments
+  // would read as a user edit and be saved, dropping them from the draft.
+  if (switchingConversation) {
+    clearAttachments();
+    beginConversationDraftSwitch(nextConversationId);
+  }
   document.getElementById('chat-title').textContent = conversations[id]?.title || id;
   if (didLeaveStatusView) {
     restoreInFlightThinking(null);
@@ -1145,11 +1184,115 @@ export function initConversationListLazyLoading() {
   scheduleConversationListBoundaryCheck();
 }
 
+// A title filter has to search conversations that only exist on unloaded pages,
+// so an active filter drains the remaining pages in the background. Each page
+// re-renders via applyPage, so matches appear as they load.
+// A filter change aborts the running drain and starts a fresh one, so the new
+// filter gets a full retry budget.
+async function drainConversationListForFilter() {
+  if (conversationFilterDrainActive) return;
+  conversationFilterDrainActive = true;
+  const generation = conversationFilterGeneration;
+  renderConvList();
+  try {
+    await drainRemainingPages(
+      conversationListLoader,
+      () => generation === conversationFilterGeneration
+        && !!normalizeConversationFilter(conversationListFilterText),
+    );
+  } finally {
+    conversationFilterDrainActive = false;
+    const filterActive = !!normalizeConversationFilter(conversationListFilterText);
+    if (filterActive && generation !== conversationFilterGeneration) {
+      void drainConversationListForFilter();
+    } else {
+      // The "Searching older conversations…" footer keys off the drain flag.
+      renderConvList();
+      if (filterActive) announceConversationFilterResults();
+    }
+  }
+}
+
+// Announced only when the (debounced) filter applies and when its drain ends,
+// not on every page render, so screen readers are not flooded while typing.
+// Unchanged text is not rewritten: refresh-triggered drains (session bind,
+// reconnect) must not re-announce without a user action.
+function announceConversationFilterResults() {
+  const status = document.getElementById('conv-filter-status');
+  if (!status) return;
+  const activeFilter = normalizeConversationFilter(conversationListFilterText);
+  let text = '';
+  if (activeFilter) {
+    const count = filterConversations(Object.values(conversations), activeFilter).length;
+    if (!conversationListLoader.getState().hasMore) {
+      text = describeFilterMatchCount(count);
+    } else if (conversationFilterDrainActive) {
+      text = `${describeFilterMatchCount(count)} so far, searching older conversations`;
+    } else {
+      // The drain gave up with pages left, so the search is not complete.
+      text = describeFilterMatchCount(count, { loadedOnly: true });
+    }
+  }
+  if (status.textContent !== text) status.textContent = text;
+}
+
+function setConversationListFilter(text) {
+  const next = String(text ?? '');
+  if (next === conversationListFilterText) return;
+  conversationListFilterText = next;
+  conversationFilterGeneration += 1;
+  const list = getConversationListElement();
+  if (list) list.scrollTop = 0;
+  renderConvList();
+  if (normalizeConversationFilter(next)) void drainConversationListForFilter();
+  announceConversationFilterResults();
+}
+
+export function initConversationFilter() {
+  const input = document.getElementById('conv-filter-input');
+  const clearButton = document.getElementById('conv-filter-clear');
+  if (!input || input.dataset.filterBound === '1') return;
+  input.dataset.filterBound = '1';
+  let debounceTimer = null;
+  const syncClearButton = () => {
+    if (clearButton) clearButton.hidden = input.value === '';
+  };
+  const applyFilterNow = () => {
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+      debounceTimer = null;
+    }
+    syncClearButton();
+    setConversationListFilter(input.value);
+  };
+  input.addEventListener('input', () => {
+    syncClearButton();
+    if (debounceTimer) clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(applyFilterNow, CONV_FILTER_DEBOUNCE_MS);
+  });
+  input.addEventListener('keydown', (event) => {
+    if (event.key !== 'Escape' || input.value === '') return;
+    event.stopPropagation();
+    input.value = '';
+    applyFilterNow();
+  });
+  clearButton?.addEventListener('click', () => {
+    input.value = '';
+    applyFilterNow();
+    input.focus();
+  });
+  syncClearButton();
+}
+
 export async function deleteConv(e, id) {
   e.stopPropagation();
   if (!confirm('Delete this conversation?')) return;
   const result = await deleteConversationApi(id);
   if (!result) return;
+  if (result.ok === false) {
+    showTransientRelayNotice(String(result.message || '').trim() || 'This conversation could not be deleted.', 6000);
+    return;
+  }
   delete conversations[id];
   renderConvList();
   if (currentConvId === id) {