@ash-qw/dsh-theme-prts 1.4.0 → 1.4.2

package/src/client/sidebar-control-adapter.js

@@ -20,6 +20,7 @@ const OWNED_ATTRIBUTES = [
   'data-prts-session-time',
   'data-prts-session-index',
   'data-prts-session-state',
+  'data-prts-selection-target',
   'data-prts-session-summary-header',
   'data-prts-session-summary-label',
   'data-prts-facility-face',
@@ -190,8 +191,23 @@ function ensureFacilitySpine(document, row, kind, next) {
 }
 
 
-export function createSidebarControlAdapter({ document, window, sessions, workspaces, getSessionStatus, getUiWorkspace, getUiConversation, getSessions }) {
+function createRunningMarker(document) {
+  const svgNode = name => document.createElementNS('http://www.w3.org/2000/svg', name)
+  const marker = svgNode('g')
+  marker.setAttribute('data-prts-running-marker', '')
+  const letter = svgNode('text')
+  letter.setAttribute('x', '12')
+  letter.setAttribute('y', '16')
+  letter.textContent = 'A'
+  const ring = svgNode('circle')
+  for (const [key, value] of Object.entries({cx:12, cy:12, r:10, 'stroke-dasharray':'4.5 11.208'})) ring.setAttribute(key, value)
+  marker.append(letter, ring)
+  return marker
+}
+
+export function createSidebarControlAdapter({ document, window, sessions, workspaces, getSessionStatus, getUiWorkspace, getUiConversation, getSessions, getWorkspaces }) {
   let previewPreferences = {}
+  let adapterActive = false, sourceRetryTimer
   let observer
   let resizeObserver
   let resizeFrame
@@ -203,15 +219,124 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
   let statusSourcesStarted = false
   let summaryRoot
   let summarySignature = ''
-  const preview = createSessionSummaryPreview({ document, window, sessions, getUiConversation, getSessions, getSessionStatus, openSession, getPreviewPreferences: () => previewPreferences })
-  let stopTitles = []
-  function clearSummaryEffects() { preview.stop(false); for (const stop of stopTitles) stop(); stopTitles = [] }
+  let heldPreviewState
+  let hoveredSummary, summaryLeaveTimer
+  let summaryDismissed = false, pointerLeftSummary = false
+  function resumeSummaryHover(event) {
+    if (!summaryDismissed) return
+    const trigger = event.target.closest?.('[data-prts-session-summary-trigger]')
+    if (!trigger || !summaryRoot?.contains(trigger)) { pointerLeftSummary = true; return }
+    if (!pointerLeftSummary) return
+    summaryDismissed = false
+    summaryRoot.removeAttribute('data-prts-summary-dismissed')
+    document.removeEventListener('pointermove', resumeSummaryHover)
+    keepSummaryHover(trigger.closest('[data-prts-session-summary-group]'))
+  }
+  function closeNavigationPreview() {
+    heldPreviewState = undefined
+    preview.stop()
+    clearSummaryHover()
+    summaryDismissed = true
+    pointerLeftSummary = false
+    summaryRoot?.setAttribute('data-prts-summary-dismissed', '')
+    for (const group of summaryRoot?.querySelectorAll('[data-prts-session-summary-group]') ?? []) group.removeAttribute('data-prts-preview-open')
+    document.addEventListener('pointermove', resumeSummaryHover)
+  }
+  function clearSummaryHover() {
+    window.clearTimeout(summaryLeaveTimer)
+    hoveredSummary?.removeAttribute('data-prts-summary-hover-open')
+    hoveredSummary?.removeAttribute('data-prts-summary-instant')
+    hoveredSummary = undefined
+  }
+  function keepSummaryHover(group) {
+    if (summaryDismissed) return
+    window.clearTimeout(summaryLeaveTimer)
+    if (!hoveredSummary) group.removeAttribute('data-prts-summary-instant')
+    if (hoveredSummary && hoveredSummary !== group) {
+      hoveredSummary.setAttribute('data-prts-summary-instant', '')
+      hoveredSummary.removeAttribute('data-prts-summary-hover-open')
+      group.setAttribute('data-prts-summary-instant', '')
+    }
+    hoveredSummary = group
+    group.setAttribute('data-prts-summary-hover-open', '')
+  }
+  function dismissHeldPreview(event) {
+    if (!heldPreviewState || (event?.type === 'keydown' && event.key !== 'Escape')) return
+    if (event?.type === 'pointerdown' && (summaryRoot?.contains(event.target) || event.target.closest?.('[data-prts-summary-reply]'))) return
+    heldPreviewState = undefined
+    queueScan()
+  }
+  function enterPreviewState(state) {
+    if (heldPreviewState && heldPreviewState !== state) { heldPreviewState = undefined; queueScan() }
+    preview.enterState(state)
+  }
+  const preview = createSessionSummaryPreview({ document, window, sessions, getUiConversation, getSessions, getSessionStatus, openSession, getPreviewPreferences: () => previewPreferences, onPreviewClosed: () => { if (statusSourcesStarted) queueScan() }, onAnswerSubmitted: state => { heldPreviewState = state; queueScan() } })
+  const stopTitles = new Map()
+  const summaryGroups = new Map()
+  function clearSummaryEffects() { clearSummaryHover(); preview.stop(false); for (const entry of summaryGroups.values()) entry.dispose(); for (const stop of stopTitles.values()) stop(); stopTitles.clear(); summaryGroups.clear() }
   let owned = new Set()
   let vectorOwners = new Set()
   const dirtyVectors = new Map()
   const vectorSizes = new WeakMap()
   const lifelineAnimator = createSessionLifelineAnimator({ document, window })
 
+  let subscribedSessions, subscribedWorkspaces
+  function disconnectSummarySources() {
+    statusSourcesStarted = false
+    window.clearTimeout(sourceRetryTimer)
+    sourceRetryTimer = undefined
+    stopSessionList()
+    stopWorkspaceList()
+    stopSessionStatus()
+    stopSessionList = stopWorkspaceList = stopSessionStatus = () => {}
+    subscribedSessions = subscribedWorkspaces = sessionStatus = undefined
+    if (getSessions) sessions = undefined
+    if (getWorkspaces) workspaces = undefined
+    cancelReveal()
+    cancelPendingNavigation()
+    clearSelectionTarget()
+    heldPreviewState = undefined
+    summaryDismissed = false
+    document?.removeEventListener('pointermove', resumeSummaryHover)
+    document?.removeEventListener('pointerdown', dismissHeldPreview)
+    document?.removeEventListener('keydown', dismissHeldPreview)
+    preview.stop()
+  }
+  function syncSummarySources() {
+    if (previewPreferences.sessionPreview === false) {
+      if (statusSourcesStarted) disconnectSummarySources()
+      return
+    }
+    if (!statusSourcesStarted) {
+      statusSourcesStarted = true
+      document.addEventListener('pointerdown', dismissHeldPreview)
+      document.addEventListener('keydown', dismissHeldPreview)
+    }
+    connectSummarySources()
+    connectSessionStatus()
+    const waiting = (getSessions && !subscribedSessions) || (getWorkspaces && !subscribedWorkspaces)
+      || (getSessionStatus && !sessionStatus)
+    if (waiting && sourceRetryTimer === undefined) {
+      sourceRetryTimer = window.setTimeout(() => { sourceRetryTimer = undefined; queueScan() }, 250)
+    } else if (!waiting) {
+      window.clearTimeout(sourceRetryTimer)
+      sourceRetryTimer = undefined
+    }
+  }
+  function connectSummarySources() {
+    if (getSessions) sessions = getSessions()
+    if (getWorkspaces) workspaces = getWorkspaces()
+    if (subscribedSessions !== sessions?.list) {
+      stopSessionList()
+      subscribedSessions = sessions?.list
+      stopSessionList = subscribedSessions?.subscribe?.(queueScan) ?? (() => {})
+    }
+    if (subscribedWorkspaces !== workspaces?.list) {
+      stopWorkspaceList()
+      subscribedWorkspaces = workspaces?.list
+      stopWorkspaceList = subscribedWorkspaces?.subscribe?.(queueScan) ?? (() => {})
+    }
+  }
   function connectSessionStatus() {
     const source = getSessionStatus?.()
     if (source === sessionStatus) return
@@ -220,28 +345,139 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
     stopSessionStatus = source?.subscribe?.(queueScan) ?? (() => {})
   }
 
-  function openSession(sessionId) {
-    try {
-      const uiWorkspace = getUiWorkspace?.()
-      if (typeof uiWorkspace?.openSession === 'function') {
-        uiWorkspace.openSession(sessionId)
-        return
-      }
-      if (typeof sessions?.open === 'function') {
-        sessions.open(sessionId)
-        return
+  let selectionTarget, selectionTargetTimer
+  function clearSelectionTarget() {
+    selectionTarget = undefined
+    window.clearTimeout(selectionTargetTimer)
+    document?.removeEventListener('pointerdown', interruptSelectionTarget, true)
+    queueScan()
+  }
+  function interruptSelectionTarget(event) {
+    if (event.target.closest?.('[data-prts-session-row]')) clearSelectionTarget()
+  }
+  function setSelectionTarget(id) {
+    clearSelectionTarget()
+    selectionTarget = id
+    selectionTargetTimer = window.setTimeout(clearSelectionTarget, 4000)
+    document.addEventListener('pointerdown', interruptSelectionTarget, true)
+  }
+
+  let pendingReveal, revealTimer, revealFrame, revealSettleTimer
+  let navigationFrame, navigationGeneration = 0
+  function cancelPendingNavigation() {
+    navigationGeneration++
+    window.cancelAnimationFrame?.(navigationFrame)
+  }
+  function cancelReveal() {
+    pendingReveal = undefined
+    window.clearTimeout(revealTimer)
+    window.clearTimeout(revealSettleTimer)
+    window.cancelAnimationFrame?.(revealFrame)
+  }
+  function revealSessionCard(sessionId) {
+    cancelReveal()
+    pendingReveal = {sessionId, attempts: 0}
+    revealTimer = window.setTimeout(cancelReveal, 4000)
+    const root = document?.querySelector?.('[data-prts-region="sessions"] [data-slot="sidebar.workspaces"]')
+    syncSessionReveal(root)
+    queueScan()
+    return Boolean(pendingReveal?.expanding)
+  }
+  function syncSessionReveal(root) {
+    if (!pendingReveal || !root) return
+    const {sessionId} = pendingReveal
+    const rows = Array.from(root.querySelectorAll('[data-row-key], [data-session-id]'))
+    const row = rows.find(el => el.getAttribute('data-row-key') === `session:${sessionId}`
+      || el.getAttribute('data-session-id') === sessionId)
+    if (row) {
+      if (pendingReveal.scrolling) return
+      const request = pendingReveal
+      request.scrolling = true
+      // Let React finish mounting and let the host's row glide settle before scrolling.
+      revealFrame = window.requestAnimationFrame(async () => {
+        const reduced = window.matchMedia?.('(prefers-reduced-motion: reduce)').matches
+        const animations = []
+        if (!reduced) for (let node = row; node && node !== root; node = node.parentElement) {
+          for (const animation of node.getAnimations?.() ?? []) {
+            const timing = animation.effect?.getComputedTiming?.()
+            if (animation.playState === 'running' && Number.isFinite(timing?.endTime)) animations.push(animation.finished)
+          }
+        }
+        if (animations.length) await Promise.race([
+          Promise.allSettled(animations),
+          new Promise(resolve => { revealSettleTimer = window.setTimeout(resolve, 300) }),
+        ])
+        if (pendingReveal !== request || !row.isConnected) return
+        row.scrollIntoView?.({block:'nearest', inline:'nearest', behavior:reduced ? 'instant' : 'smooth'})
+        cancelReveal()
+      })
+      return
+    }
+    if (++pendingReveal.attempts > 40) { cancelReveal(); return }
+    const items = snapshotOf(workspaces?.list)?.items ?? []
+    const owner = items.find(item => item.sessionIds?.includes(sessionId))
+    const key = owner?.workspaceId ?? ''
+    const keyed = key => rows.find(el => el.getAttribute('data-row-key') === key)
+    const group = keyed(`workspace:${key}`)
+    if (group?.getAttribute('aria-expanded') === 'false') { pendingReveal.expanding = true; group.click(); return }
+    if (!group && owner?.path) {
+      // Nested workspaces may not mount until their visible ancestor is expanded.
+      const path = value => value?.replace(/\\/g, '/').replace(/\/$/, '')
+      const target = path(owner.path)
+      const ancestors = items.filter(item => item !== owner && item.path && target.startsWith(path(item.path) + '/'))
+        .sort((a,b) => b.path.length - a.path.length)
+      for (const ancestor of ancestors) {
+        const parent = keyed(`workspace:${ancestor.workspaceId}`)
+        if (parent?.getAttribute('aria-expanded') === 'false') { pendingReveal.expanding = true; parent.click(); return }
       }
-    } catch {}
-    const row = Array.from(document.querySelectorAll('[data-prts-session-row]')).find(candidate => (
-      candidate.getAttribute('data-row-key') === `session:${sessionId}`
-      || candidate.getAttribute('data-session-id') === sessionId
-      || candidate.querySelector('[data-prts-row-title]')?.textContent.trim() === sessionId
-    ))
-    row?.click?.()
+    }
+    const overflow = keyed(`overflow:${key}`)
+    if (overflow?.getAttribute('aria-expanded') === 'false') { pendingReveal.expanding = true; overflow.click() }
+  }
+
+  function openSession(sessionId) {
+    closeNavigationPreview()
+    cancelPendingNavigation()
+    setSelectionTarget(sessionId)
+    revealSessionCard(sessionId)
+    const generation = navigationGeneration
+    const navigate = () => {
+      if (generation !== navigationGeneration || !adapterActive) return
+      try {
+        const uiWorkspace = getUiWorkspace?.()
+        if (typeof uiWorkspace?.openSession === 'function') {
+          uiWorkspace.openSession(sessionId)
+          return
+        }
+        if (typeof sessions?.open === 'function') {
+          sessions.open(sessionId)
+          return
+        }
+      } catch {}
+      const row = Array.from(document.querySelectorAll('[data-prts-session-row]')).find(candidate => (
+        candidate.getAttribute('data-row-key') === `session:${sessionId}`
+        || candidate.getAttribute('data-session-id') === sessionId
+        || candidate.querySelector('[data-prts-row-title]')?.textContent.trim() === sessionId
+      ))
+      if (row) row.click?.()
+      else clearSelectionTarget()
+    }
+    // Paint selection and expansion before the host synchronously mounts another conversation.
+    // Already-expanded workspaces need this too: queueScan has not applied selection yet.
+    navigationFrame = window.requestAnimationFrame(() => {
+      if (generation !== navigationGeneration) return
+      navigationFrame = window.requestAnimationFrame(navigate)
+    })
   }
 
   function statusSignal(document, state) {
-    const signal = document.createElement('span')
+    const signal = state === 'ongoing'
+      ? document.createElementNS('http://www.w3.org/2000/svg', 'svg')
+      : document.createElement('span')
+    if (state === 'ongoing') {
+      signal.setAttribute('viewBox', '0 0 24 24')
+      signal.append(createRunningMarker(document))
+    }
     signal.setAttribute('data-prts-session-summary-signal', state)
     signal.setAttribute('aria-hidden', 'true')
     return signal
@@ -250,6 +486,11 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
   function buildSummaryGroup(state, label, items) {
     const group = document.createElement('span')
     group.setAttribute('data-prts-session-summary-group', state)
+    group.addEventListener('pointerenter', () => keepSummaryHover(group))
+    group.addEventListener('pointerleave', () => {
+      window.clearTimeout(summaryLeaveTimer)
+      summaryLeaveTimer = window.setTimeout(() => { if (hoveredSummary === group) clearSummaryHover() }, 180)
+    })
 
     const trigger = document.createElement('button')
     trigger.type = 'button'
@@ -261,10 +502,20 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
     count.setAttribute('data-prts-session-summary-count', '')
     count.textContent = String(items.length)
     trigger.append(count)
+    trigger.addEventListener('pointerenter', () => enterPreviewState(state))
+    trigger.addEventListener('focus', () => {
+      if (trigger.matches(':focus-visible')) {
+        summaryDismissed = false
+        summaryRoot?.removeAttribute('data-prts-summary-dismissed')
+        document.removeEventListener('pointermove', resumeSummaryHover)
+      }
+      enterPreviewState(state)
+    })
 
     const popover = document.createElement('span')
     popover.setAttribute('data-prts-session-summary-popover', state)
     popover.setAttribute('role', 'menu')
+    popover.setAttribute('popover', 'manual')
     popover.setAttribute('aria-label', label)
     const heading = document.createElement('span')
     heading.setAttribute('data-prts-session-summary-heading', '')
@@ -287,7 +538,92 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
     const list = document.createElement('span')
     list.setAttribute('data-prts-summary-list', '')
     popover.append(list)
-    for (const item of items) {
+    const spaceNotice = document.createElement('div')
+    spaceNotice.setAttribute('data-prts-summary-space-notice', '')
+    spaceNotice.textContent = '空间不足，无法显示会话预览。建议扩大窗口，或在辅助功能中关闭预览。'
+    popover.append(spaceNotice)
+    let boundsFrame
+    const checkBounds = () => {
+      window.cancelAnimationFrame(boundsFrame)
+      boundsFrame = undefined
+      if (!group.isConnected) return
+      // Escape the host sidebar's clipped region without changing its layout.
+      if (typeof popover.showPopover === 'function' && !popover.matches(':popover-open')) popover.showPopover()
+      const header = group.closest('[data-prts-session-summary-header]')?.getBoundingClientRect()
+      if (!header) return
+      Object.assign(popover.style, {position:'fixed', boxSizing:'border-box', margin:'0', left:header.left+'px',
+        width:header.width+'px', right:'auto', bottom:'auto'})
+      popover.removeAttribute('data-prts-summary-no-space')
+      popover.removeAttribute('data-prts-summary-no-room')
+      const viewport = window.visualViewport
+      const left = viewport?.offsetLeft ?? 0, top = viewport?.offsetTop ?? 0
+      const right = left + (viewport?.width ?? window.innerWidth) - 8
+      const bottom = top + (viewport?.height ?? window.innerHeight) - 8
+      const fits = rect => rect.left >= left + 8 && rect.top >= top + 8 && rect.right <= right && rect.bottom <= bottom
+      // Measure the final layout, independent of the opening transform animation.
+      const place = () => {
+        popover.removeAttribute('data-prts-summary-above')
+        const parent = header
+        const rect = popover.getBoundingClientRect()
+        const height = popover.offsetHeight
+        const below = parent.bottom + 6
+        const above = parent.top - 6 - height
+        const candidate = y => ({left: rect.left, right: rect.right, top: y, bottom: y + height})
+        popover.style.top = below + 'px'
+        if (fits(candidate(below))) return true
+        popover.setAttribute('data-prts-summary-above', '')
+        if (fits(candidate(above))) { popover.style.top = above + 'px'; return true }
+        popover.removeAttribute('data-prts-summary-above')
+        return false
+      }
+      if (place()) { trigger.removeAttribute('title'); return }
+      popover.setAttribute('data-prts-summary-no-space', '')
+      trigger.title = spaceNotice.textContent
+      if (!place()) popover.setAttribute('data-prts-summary-no-room', '')
+    }
+    const scheduleBounds = () => {
+      if (boundsFrame === undefined) boundsFrame = window.requestAnimationFrame(checkBounds)
+    }
+    const boundsObserver = window.ResizeObserver ? new window.ResizeObserver(scheduleBounds) : undefined
+    boundsObserver?.observe(popover)
+    // Re-entering the trigger need not re-enter its group (the list is a descendant).
+    // Run after enterPreviewState so measurement sees the current status list.
+    trigger.addEventListener('pointerenter', checkBounds)
+    trigger.addEventListener('focus', checkBounds)
+    window.addEventListener('resize', scheduleBounds)
+    document.addEventListener('scroll', scheduleBounds, true)
+    window.visualViewport?.addEventListener('resize', scheduleBounds)
+    window.visualViewport?.addEventListener('scroll', scheduleBounds)
+    const entries = new Map()
+    const update = items => {
+      scheduleBounds()
+      count.textContent = String(items.length)
+      trigger.setAttribute('aria-label', `${label} ${items.length}`)
+      const ids = new Set(items.map(item => item.id))
+      for (const [id, entry] of entries) {
+        if (ids.has(id)) continue
+        stopTitles.get(entry.button)?.()
+        stopTitles.delete(entry.button)
+        entry.button.remove()
+        entries.delete(id)
+      }
+      for (const [index, incoming] of items.entries()) {
+        const existing = entries.get(incoming.id)
+        if (existing) {
+          if (existing.item.title !== incoming.title) {
+            stopTitles.get(existing.button)?.()
+            existing.button.querySelector('[data-prts-summary-title] > span').textContent = incoming.title
+          }
+          Object.assign(existing.item, incoming)
+          let detail = existing.button.querySelector('[data-prts-session-summary-item-status]')
+          if (incoming.statusLabel && !detail) { detail = document.createElement('small'); detail.setAttribute('data-prts-session-summary-item-status',''); existing.button.append(detail) }
+          if (incoming.statusLabel) detail.textContent = incoming.statusLabel
+          else detail?.remove()
+          existing.button.setAttribute('aria-label', incoming.statusLabel ? `${incoming.title}，${incoming.statusLabel}` : incoming.title)
+          if (list.children[index] !== existing.button) list.insertBefore(existing.button, list.children[index] ?? null)
+          continue
+        }
+        const item = {...incoming}
       const button = document.createElement('button')
       button.type = 'button'
       button.setAttribute('role', 'menuitem')
@@ -299,14 +635,19 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
       text.textContent = item.title
       title.append(text)
       button.append(title)
+      const viewing = document.createElement('em')
+      viewing.setAttribute('data-prts-preview-marker', '')
+      viewing.textContent = '预览中'
+      button.append(viewing)
       button.setAttribute('aria-label', item.title)
-      stopTitles.push(scrollSummaryTitle(button, title, text, window))
+      stopTitles.set(button, scrollSummaryTitle(button, title, text, window))
       const showReply = () => {
+        if (summaryDismissed) return
         const key = {ongoing:'previewOngoing',warning:'previewWarning',done:'previewDone'}[state]
         if (previewPreferences[key] === false) { preview.stop(); return }
         preview.show(item.id, reply, item.title, button)
       }
-      button.addEventListener('pointerenter', showReply)
+      button.addEventListener('pointermove', showReply)
       button.addEventListener('pointerleave', () => preview.leave())
       button.addEventListener('focus', showReply)
       if (item.statusLabel) {
@@ -321,8 +662,22 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
         preview.stop()
         openSession(item.id)
       })
-      list.append(button)
+      list.insertBefore(button, list.children[index] ?? null)
+      entries.set(item.id, {item, button})
+      }
     }
+    update(items)
+    summaryGroups.set(state, {group, update, dispose: () => {
+      boundsObserver?.disconnect()
+      window.cancelAnimationFrame(boundsFrame)
+      window.removeEventListener('resize', scheduleBounds)
+      document.removeEventListener('scroll', scheduleBounds, true)
+      window.visualViewport?.removeEventListener('resize', scheduleBounds)
+      window.visualViewport?.removeEventListener('scroll', scheduleBounds)
+      for (const {button} of entries.values()) { stopTitles.get(button)?.(); stopTitles.delete(button) }
+      if (hoveredSummary === group) clearSummaryHover()
+      group.remove()
+    }})
     popover.append(reply)
     group.append(trigger, popover)
     return group
@@ -331,6 +686,7 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
   function syncSummary(root, next) {
     const { header, label } = resolveSectionHeader(root)
     if (previewPreferences.sessionPreview === false || !header || !label) {
+      heldPreviewState = undefined
       preview.stop()
       clearSummaryEffects()
       summaryRoot?.remove()
@@ -361,10 +717,31 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
         rows[index] = { ...rows[index], state: nativeRow.state }
       }
     }
-    const warning = rows.filter(item => item.state === 'warning')
-    const ongoing = rows.filter(item => item.state === 'ongoing')
-    const done = rows.filter(item => item.state === 'done')
+    // Do not move the row/menu to another status behind a frozen preview.
+    const pinned = preview.pinnedState()
+    if (pinned?.state) {
+      const item = rows.find(item => item.id === pinned.id)
+      if (item) { item.state = pinned.state; item.statusLabel = undefined }
+    }
+    // While reading a preview, preserve surviving rows' positions and append
+    // newcomers. No persistent ordering: the next idle sync uses host order.
+    const orderedState = state => {
+      const items = rows.filter(item => item.state === state)
+      if (!preview.isOpen() || !summaryRoot) return items
+      const remaining = new Map(items.map(item => [item.id, item]))
+      const stable = []
+      for (const row of summaryRoot.querySelectorAll(`[data-prts-session-summary-group="${state}"] [data-prts-session-summary-item]`)) {
+        const id = row.getAttribute('data-prts-session-summary-item')
+        if (remaining.has(id)) { stable.push(remaining.get(id)); remaining.delete(id) }
+      }
+      return [...stable, ...remaining.values()]
+    }
+    const warning = orderedState('warning')
+    const ongoing = orderedState('ongoing')
+    const done = orderedState('done')
+    if (heldPreviewState && !rows.some(item => item.state === heldPreviewState)) heldPreviewState = undefined
     const signature = JSON.stringify({
+      heldPreviewState,
       warning: warning.map(item => [item.id, item.title, item.statusLabel]),
       ongoing: ongoing.map(item => [item.id, item.title]),
       done: done.map(item => [item.id, item.title]),
@@ -381,15 +758,24 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
     }
     const labelHidden = Array.from(label.classList).some(name => /hidden/i.test(name))
     summaryRoot.toggleAttribute('data-prts-summary-search-hidden', labelHidden)
+    summaryRoot.toggleAttribute('data-prts-summary-dismissed', summaryDismissed)
     summaryRoot.hidden = warning.length === 0 && ongoing.length === 0 && done.length === 0
     if (signature === summarySignature) return
     summarySignature = signature
-    clearSummaryEffects()
-    summaryRoot.replaceChildren()
-    if (warning.length) summaryRoot.append(buildSummaryGroup('warning', '等待处理的会话', warning))
-    if (ongoing.length) summaryRoot.append(buildSummaryGroup('ongoing', '运行中的会话', ongoing))
-    if (done.length) summaryRoot.append(buildSummaryGroup('done', '完成未查看', done))
+    for (const [state, title, items] of [['warning','等待处理的会话',warning],['ongoing','运行中的会话',ongoing],['done','完成未查看',done]]) {
+      const existing = summaryGroups.get(state)
+      if (!items.length) { existing?.dispose(); summaryGroups.delete(state); continue }
+      if (existing) existing.update(items)
+      else summaryRoot.append(buildSummaryGroup(state, title, items))
+    }
+    let position = 0
+    for (const state of ['warning','ongoing','done']) {
+      const group = summaryGroups.get(state)?.group
+      if (group && summaryRoot.children[position++] !== group) summaryRoot.insertBefore(group, summaryRoot.children[position - 1] ?? null)
+      group?.removeAttribute('data-prts-preview-open')
+    }
     preview.reanchor(summaryRoot)
+    if (heldPreviewState) summaryRoot.querySelector(`[data-prts-session-summary-group="${heldPreviewState}"]`)?.setAttribute('data-prts-preview-open', '')
   }
 
   function scheduleVectors() {
@@ -451,7 +837,7 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
 
 
   function queueScan() {
-    if (scanFrame !== undefined) return
+    if (!adapterActive || scanFrame !== undefined) return
     const requestFrame = window?.requestAnimationFrame?.bind(window) ?? (callback => window?.setTimeout?.(callback, 0))
     scanFrame = requestFrame(() => {
       scanFrame = undefined
@@ -460,7 +846,8 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
   }
 
   function scan() {
-    connectSessionStatus()
+    if (!adapterActive) return
+    syncSummarySources()
     const root = document?.querySelector?.('[data-prts-region="sessions"] [data-slot="sidebar.workspaces"]')
     const next = new Set()
     const nextVectorOwners = new Set()
@@ -489,16 +876,31 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
         registerVector(controls.menu, { kind: 'button' }, next, nextVectorOwners)
         registerVector(controls.create, { kind: 'button' }, next, nextVectorOwners)
       }
+      const rowSessionId = row => row.getAttribute('data-session-id') || row.getAttribute('data-row-key')?.replace(/^session:/, '')
+      if (selectionTarget && Array.from(root.querySelectorAll('[role="treeitem"][aria-selected="true"]')).some(row => rowSessionId(row) === selectionTarget)) clearSelectionTarget()
       let sessionOrdinal = 0
       for (const row of root.querySelectorAll('div[role="treeitem"][aria-selected]')) {
         const sessionIndex = String(++sessionOrdinal).padStart(2, '0')
         const controls = resolveRowControls(row, 'session')
         const state = nativeSessionState(row)
+        const spinner = state === 'ongoing' ? row.querySelector('svg[data-state="ongoing"]') : undefined
+        if (spinner) {
+          let marker = spinner.querySelector('[data-prts-running-marker]')
+          if (!marker) {
+            marker = createRunningMarker(document)
+            spinner.append(marker)
+          }
+          next.add(marker)
+        }
+
         const face = ensureFacilityFace(document, row, 'session', next)
         const spine = ensureFacilitySpine(document, row, 'session', next)
         registerVector(face, { kind: 'face', topNotch: true, sessionNotch: true, texture: 'pickup' }, next, nextVectorOwners)
         registerVector(spine, { kind: 'spine' }, next, nextVectorOwners)
-        if (!activeLifelineRow && row.getAttribute('aria-selected') === 'true') {
+        const selected = selectionTarget ? rowSessionId(row) === selectionTarget : row.getAttribute('aria-selected') === 'true'
+        if (selectionTarget) row.setAttribute('data-prts-selection-target', String(selected))
+        else row.removeAttribute('data-prts-selection-target')
+        if (!activeLifelineRow && selected) {
           activeLifelineRow = row
           activeLifeline = face.querySelector('[data-prts-session-lifeline]')
         }
@@ -533,7 +935,8 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
     lifelineAnimator.setTarget(activeLifelineRow, activeLifeline)
     for (const node of owned) {
       if (next.has(node)) continue
-      if (node.hasAttribute?.('data-prts-owned-projection')
+      if (node.hasAttribute?.('data-prts-running-marker')
+        || node.hasAttribute?.('data-prts-owned-projection')
         || node.hasAttribute?.('data-prts-owned-facility')
         || node.hasAttribute?.('data-prts-owned-facility-spine')
         || node.hasAttribute?.('data-prts-owned-facility-vector')) {
@@ -544,13 +947,14 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
     }
     syncVectorOwners(nextVectorOwners)
     owned = next
+    syncSessionReveal(root)
   }
 
   function clear() {
     preview.stop()
     clearSummaryEffects()
     lifelineAnimator.setTarget(undefined, undefined)
-    for (const node of document?.querySelectorAll?.('[data-prts-owned-projection], [data-prts-owned-facility], [data-prts-owned-facility-spine], [data-prts-owned-facility-vector], [data-prts-owned-facility-defs]') ?? []) node.remove()
+    for (const node of document?.querySelectorAll?.('[data-prts-running-marker], [data-prts-owned-projection], [data-prts-owned-facility], [data-prts-owned-facility-spine], [data-prts-owned-facility-vector], [data-prts-owned-facility-defs]') ?? []) node.remove()
     for (const node of owned) {
       for (const attribute of OWNED_ATTRIBUTES) node.removeAttribute?.(attribute)
     }
@@ -567,10 +971,11 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
 
   return {
     start(preferences = {}) {
-      const keys = ['sessionPreview','previewOngoing','previewWarning','previewDone','previewDoubleClick']
+      const keys = ['sessionPreview','previewOngoing','previewWarning','previewDone','previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning', 'previewReplyLimit']
       if (keys.some(key => previewPreferences[key] !== preferences[key])) preview.stop()
       previewPreferences = Object.fromEntries(keys.map(key => [key, preferences[key]]))
       if (!document) return
+      adapterActive = true
       lifelineAnimator.start()
       ensureFacilityTextureDefs(document)
       const ResizeObserver = window?.ResizeObserver
@@ -586,16 +991,22 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
         })
       }
       scan()
-      if (!statusSourcesStarted) {
-        statusSourcesStarted = true
-        stopSessionList = sessions?.list?.subscribe?.(queueScan) ?? (() => {})
-        stopWorkspaceList = workspaces?.list?.subscribe?.(queueScan) ?? (() => {})
-      }
       if (observer || !window?.MutationObserver) return
       const observationRoot = document.querySelector('[data-prts-region="sessions"]')
       if (!observationRoot) return
       observer = new window.MutationObserver(mutations => {
-        if (mutations.some(mutation => !mutation.target.closest?.('[data-prts-owned-session-summary]'))) queueScan()
+        const relevant = mutations.filter(mutation => !mutation.target.closest?.('[data-prts-owned-session-summary]'))
+        const freshRow = 'div[role="treeitem"]:not([data-prts-session-row]):not([data-prts-workspace-row])'
+        const mountsRows = relevant.some(mutation => mutation.type === 'childList'
+          && Array.from(mutation.addedNodes).some(node => node.nodeType === 1
+            && (node.matches(freshRow) || node.querySelector(freshRow))))
+        if (mountsRows) {
+          // React has mounted expanded rows. Finish theme geometry before their first paint.
+          window.cancelAnimationFrame?.(scanFrame)
+          scanFrame = undefined
+          scan()
+          flushVectors()
+        } else if (relevant.length) queueScan()
       })
       observer.observe(observationRoot, {
         subtree: true,
@@ -605,16 +1016,16 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
       })
     },
     dispose() {
+      adapterActive = false
+      disconnectSummarySources()
+      cancelReveal()
+      document.removeEventListener('pointermove', resumeSummaryHover)
+      summaryDismissed = false
+      heldPreviewState = undefined
+      document?.removeEventListener('pointerdown', dismissHeldPreview)
+      document?.removeEventListener('keydown', dismissHeldPreview)
       observer?.disconnect()
       observer = undefined
-      stopSessionList()
-      stopSessionList = () => {}
-      stopWorkspaceList()
-      stopWorkspaceList = () => {}
-      stopSessionStatus()
-      stopSessionStatus = () => {}
-      sessionStatus = undefined
-      statusSourcesStarted = false
       if (scanFrame !== undefined) {
         if (window?.cancelAnimationFrame) window.cancelAnimationFrame(scanFrame)
         else window?.clearTimeout?.(scanFrame)