@wangxiaocuo/dsh-session-trash 0.6.1 → 0.6.3

package/client.js

@@ -10,6 +10,10 @@ window.__ModuleLoader__.load({
     const MENU_ID = 'session-trash.move'
     const SECTION_ID = 'session-trash'
     const PREFLIGHT_TIMEOUT_MS = 800
+    /** Hard budget for one trash write request. */
+    const MUTATION_TIMEOUT_MS = 30_000
+    /** Hard budget for one `/state` read. */
+    const STATE_TIMEOUT_MS = 15_000
     const DAY_MS = 86_400_000
     /** Rows per page in the trash list. */
     const PAGE_SIZE = 50
@@ -28,6 +32,19 @@ window.__ModuleLoader__.load({
      * Preflight refusals the user can act on themselves. Those keep a visible
      * menu entry that explains the refusal instead of hiding it.
      */
+    /** Host `lastErrorCode` values mapped to owner-facing messages. */
+    const LAST_ERROR_KEYS = {
+      TRASH_COPY_MISSING: 'lastErrorTrashCopyMissing',
+      TRASH_COPY_MISSING_MEMBERS: 'lastErrorTrashCopyMissingMembers',
+      TRASH_OBJECT_MISSING: 'lastErrorTrashObjectMissing',
+      PURGE_FAILED: 'lastErrorPurgeFailed',
+      RESTORE_INVISIBLE: 'lastErrorRestoreInvisible',
+      MOVE_UNSETTLED: 'lastErrorMoveUnsettled',
+      SOURCE_CONFLICT: 'lastErrorSourceConflict',
+      INDEX_WRITE_FAILED: 'lastErrorIndexWriteFailed',
+      IO_ERROR: 'lastErrorIo',
+    }
+
     const MOVE_BLOCKED_KEYS = {
       SESSION_LIVE: { label: 'moveBlockedLive', toast: 'blockedLiveToast' },
       SESSION_ACTIVE: { label: 'moveBlockedActive', toast: 'blockedActiveToast' },
@@ -73,7 +90,8 @@ window.__ModuleLoader__.load({
       retry: '重试',
       cleanupExpired: '清理已过期',
       cleaning: '正在清理…',
-      statsCount: '{count} 个会话',
+      statsCountOne: '{count} 个会话',
+      statsCountOther: '{count} 个会话',
       statsSize: '占用 {size}',
       searchLabel: '搜索回收站',
       searchPlaceholder: '搜索标题、Session ID 或原始工作区',
@@ -101,6 +119,7 @@ window.__ModuleLoader__.load({
       emptyBody: '在侧边栏右键会话，选择「移入回收站」。',
       loading: '正在加载…',
       errorNetwork: '无法连接到回收站服务。',
+      errorTimeout: '请求超时，请重试。',
       errorUnauthorized: '连接已失效，请刷新页面。',
       errorForbidden: '当前身份无权访问回收站。',
       errorGeneric: '回收站加载失败。',
@@ -122,7 +141,8 @@ window.__ModuleLoader__.load({
       badgeMigration: '需要迁移',
       badgeExpiring: '即将到期',
       badgeExpired: '已过期',
-      badgeSubagents: '含 {count} 个子会话',
+      badgeSubagentsOne: '含 {count} 个子会话',
+      badgeSubagentsOther: '含 {count} 个子会话',
       stateTrashing: '正在移入…',
       stateRestoring: '正在恢复…',
       statePurging: '正在删除…',
@@ -130,7 +150,7 @@ window.__ModuleLoader__.load({
       actionRestoreFor: '恢复「{title}」',
       actionMoreFor: '「{title}」的更多操作',
       actionRestoreOrphan: '恢复为孤儿会话',
-      actionReveal: '在 Finder 中显示',
+      actionReveal: '在文件管理器中显示',
       actionRevealDisabled: '原工作区已不存在',
       actionCopyId: '复制 Session ID',
       actionForget: '从索引移除',
@@ -147,23 +167,37 @@ window.__ModuleLoader__.load({
       purgeAllTitle: '永久删除回收站中的全部 {count} 个会话？',
       purgeAllBody: '此操作不可撤销。附件、图片和搜索索引等衍生物不会被删除。',
       purgeAllConfirm: '全部永久删除',
-      purgeAllDone: '已永久删除 {count} 个会话',
+      purgeAllDoneOne: '已永久删除 {count} 个会话',
+      purgeAllDoneOther: '已永久删除 {count} 个会话',
       purgeAllNone: '回收站中没有可删除的会话',
-      purgeAllPartial: '已永久删除 {removed} 个会话，{failed} 个未能删除',
+      purgeAllPartial: '批量删除完成：成功 {removed} 个，失败 {failed} 个。',
       forgetTitle: '从回收站列表移除这条缺失记录？',
       forgetBody: '不会删除任何文件；仅移除索引中的这条记录。',
       forgetConfirm: '从索引移除',
-      cleanupDone: '已清理 {count} 个过期会话',
+      cleanupDoneOne: '已清理 {count} 个过期会话',
+      cleanupDoneOther: '已清理 {count} 个过期会话',
       cleanupNone: '没有需要清理的过期会话',
-      cleanupFailedBanner: '上次自动清理有 {count} 个会话未能删除。',
-      cleanupErrorBanner: '上次自动清理失败：{message}',
+      cleanupFailedBannerOne: '上次自动清理有 {count} 个会话未能删除。',
+      cleanupFailedBannerOther: '上次自动清理有 {count} 个会话未能删除。',
+      cleanupErrorBanner: '上次自动清理失败，请稍后在本页重试。',
+      cleanupFailed: '清理失败：还有 {failed} 个过期会话没有删除。',
+      cleanupPartial: '已清理 {purged} 个过期会话，{failed} 个没有删除。',
       cleanupRetryAt: '将在 {time} 自动重试。',
       cleanupRetryNow: '立即重试',
       copySuccess: '已复制 Session ID',
       copyFailed: '无法复制 Session ID，请手动复制',
-      revealSuccess: '已在 Finder 中显示原工作区',
+      revealSuccess: '已在文件管理器中显示原工作区',
       revealFailed: '无法打开原工作区',
       lastErrorLabel: '上次错误：{message}',
+      lastErrorTrashCopyMissing: '回收站里的会话副本缺失。',
+      lastErrorTrashCopyMissingMembers: '回收站里的部分子会话副本缺失。',
+      lastErrorTrashObjectMissing: '回收站对象目录缺失。',
+      lastErrorPurgeFailed: '会话日志删除失败。',
+      lastErrorRestoreInvisible: '恢复后会话存储没有识别到该会话。',
+      lastErrorMoveUnsettled: '会话已移动，但会话存储仍报告它存在。',
+      lastErrorSourceConflict: '原会话目录与回收站副本同时存在，两者都已保留。',
+      lastErrorIndexWriteFailed: '回收站索引写入失败。',
+      lastErrorIo: '文件操作失败。',
       footnote: '回收站目录：{path}',
       move: '移入回收站',
       moveBlockedLive: '移入回收站（会话已打开）',
@@ -172,7 +206,8 @@ window.__ModuleLoader__.load({
       undo: '撤销',
       undoFailed: '撤销失败',
       trashSuccess: '已将「{title}」移入回收站',
-      trashSuccessTree: '「{title}」及其 {count} 个子会话已移入回收站',
+      trashSuccessTreeOne: '「{title}」及其 {count} 个子会话已移入回收站',
+      trashSuccessTreeOther: '「{title}」及其 {count} 个子会话已移入回收站',
       blockedLiveToast: '该会话已在本机打开。DSH 目前不会释放已打开的会话，请重启 DSH 后再移入回收站。',
       blockedActiveToast: '该会话还有正在运行的任务或子代理，等它停下来后再移入回收站。',
       blockedDescendantsToast: '该会话包含可见的子会话，只能使用 DSH 自带的「归档」整棵会话树。',
@@ -197,7 +232,7 @@ window.__ModuleLoader__.load({
       errorIndexCorrupt: '回收站索引损坏，已进入保护模式。',
       errorIndexOk: '回收站索引可正常读取，无需重建。',
       errorForgetNotAllowed: '只有文件缺失的记录可以从索引移除。',
-      errorRevealUnavailable: '当前环境无法打开 Finder。',
+      errorRevealUnavailable: '当前环境无法打开文件管理器。',
       errorRevealFailed: '无法打开原工作区。',
       errorIo: '文件操作失败，请稍后重试。',
     }
@@ -210,7 +245,8 @@ window.__ModuleLoader__.load({
       retry: 'Retry',
       cleanupExpired: 'Delete expired',
       cleaning: 'Cleaning…',
-      statsCount: '{count} sessions',
+      statsCountOne: '{count} session',
+      statsCountOther: '{count} sessions',
       statsSize: '{size} used',
       searchLabel: 'Search the trash',
       searchPlaceholder: 'Search title, Session ID, or original workspace',
@@ -238,6 +274,7 @@ window.__ModuleLoader__.load({
       emptyBody: 'Right-click a session in the sidebar and choose “Move to trash”.',
       loading: 'Loading…',
       errorNetwork: 'Could not reach the trash service.',
+      errorTimeout: 'The request timed out. Try again.',
       errorUnauthorized: 'Your connection expired. Reload the page.',
       errorForbidden: 'You do not have access to the trash.',
       errorGeneric: 'Could not load the trash.',
@@ -259,7 +296,8 @@ window.__ModuleLoader__.load({
       badgeMigration: 'Migration required',
       badgeExpiring: 'Expiring soon',
       badgeExpired: 'Expired',
-      badgeSubagents: '{count} sub-sessions',
+      badgeSubagentsOne: '{count} sub-session',
+      badgeSubagentsOther: '{count} sub-sessions',
       stateTrashing: 'Moving…',
       stateRestoring: 'Restoring…',
       statePurging: 'Deleting…',
@@ -267,7 +305,7 @@ window.__ModuleLoader__.load({
       actionRestoreFor: 'Restore “{title}”',
       actionMoreFor: 'More actions for “{title}”',
       actionRestoreOrphan: 'Restore as orphan',
-      actionReveal: 'Show in Finder',
+      actionReveal: 'Show in file manager',
       actionRevealDisabled: 'The original workspace no longer exists',
       actionCopyId: 'Copy Session ID',
       actionForget: 'Remove from index',
@@ -284,23 +322,37 @@ window.__ModuleLoader__.load({
       purgeAllTitle: 'Permanently delete all {count} sessions in the trash?',
       purgeAllBody: 'This cannot be undone. Attachments, images, and search index rows are not deleted.',
       purgeAllConfirm: 'Delete all permanently',
-      purgeAllDone: 'Permanently deleted {count} sessions',
+      purgeAllDoneOne: 'Permanently deleted {count} session',
+      purgeAllDoneOther: 'Permanently deleted {count} sessions',
       purgeAllNone: 'No sessions to delete',
-      purgeAllPartial: 'Permanently deleted {removed} sessions; {failed} could not be deleted',
+      purgeAllPartial: 'Bulk delete finished: {removed} removed, {failed} failed.',
       forgetTitle: 'Remove this missing record from the trash list?',
       forgetBody: 'No file is deleted; only this index record is removed.',
       forgetConfirm: 'Remove from index',
-      cleanupDone: 'Deleted {count} expired sessions',
+      cleanupDoneOne: 'Deleted {count} expired session',
+      cleanupDoneOther: 'Deleted {count} expired sessions',
       cleanupNone: 'No expired sessions to delete',
-      cleanupFailedBanner: 'The last automatic cleanup could not delete {count} session(s).',
-      cleanupErrorBanner: 'The last automatic cleanup failed: {message}',
+      cleanupFailedBannerOne: 'The last automatic cleanup could not delete {count} expired session.',
+      cleanupFailedBannerOther: 'The last automatic cleanup could not delete {count} expired sessions.',
+      cleanupErrorBanner: 'The last automatic cleanup failed. Retry from this page later.',
+      cleanupFailed: 'Cleanup could not delete {failed} of the expired sessions.',
+      cleanupPartial: 'Cleanup deleted {purged}; {failed} could not be deleted.',
       cleanupRetryAt: 'Next retry: {time}.',
       cleanupRetryNow: 'Retry now',
       copySuccess: 'Session ID copied',
       copyFailed: 'Could not copy the Session ID. Copy it manually.',
-      revealSuccess: 'Revealed the original workspace in Finder',
+      revealSuccess: 'Revealed the original workspace in the file manager',
       revealFailed: 'Could not open the original workspace',
       lastErrorLabel: 'Last error: {message}',
+      lastErrorTrashCopyMissing: 'The stored copy of this session is missing from the trash.',
+      lastErrorTrashCopyMissingMembers: 'Some sub-session copies are missing from the trash.',
+      lastErrorTrashObjectMissing: 'The trash object directory is missing.',
+      lastErrorPurgeFailed: 'The session log could not be deleted.',
+      lastErrorRestoreInvisible: 'Session storage did not report the restored session.',
+      lastErrorMoveUnsettled: 'The session was moved, but session storage still reports it.',
+      lastErrorSourceConflict: 'The original session directory and the trash copy both exist; both were kept.',
+      lastErrorIndexWriteFailed: 'The trash index could not be written.',
+      lastErrorIo: 'A file operation failed.',
       footnote: 'Trash directory: {path}',
       move: 'Move to trash',
       moveBlockedLive: 'Move to trash (session is open)',
@@ -309,7 +361,8 @@ window.__ModuleLoader__.load({
       undo: 'Undo',
       undoFailed: 'Could not undo',
       trashSuccess: 'Moved “{title}” to the trash',
-      trashSuccessTree: '“{title}” and its {count} sub-sessions were moved to the trash',
+      trashSuccessTreeOne: '“{title}” and its single sub-session were moved to the trash',
+      trashSuccessTreeOther: '“{title}” and its {count} sub-sessions were moved to the trash',
       blockedLiveToast: 'This session is open in DSH. DSH does not release opened sessions yet; restart DSH, then move it to the trash.',
       blockedActiveToast: 'This session still has running work; wait for it to stop, then move it to the trash.',
       blockedDescendantsToast: 'This session has visible child sessions; use the built-in Archive action for the whole tree instead.',
@@ -334,7 +387,7 @@ window.__ModuleLoader__.load({
       errorIndexCorrupt: 'The trash index is damaged, so protection mode is on.',
       errorIndexOk: 'The trash index is readable and does not need a rebuild.',
       errorForgetNotAllowed: 'Only records whose log is missing can be removed from the index.',
-      errorRevealUnavailable: 'This environment cannot open Finder.',
+      errorRevealUnavailable: 'This environment cannot open a file manager.',
       errorRevealFailed: 'Could not open the original workspace.',
       errorIo: 'A file operation failed. Try again.',
     }
@@ -353,11 +406,26 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * @param {number} bytes raw byte count.
-     * @returns {string} a compact human-readable size.
+     * Pick the grammatical singular/plural locale form for a count.
+     *
+     * @param {(key: string) => string} t bound translator.
+     * @param {string} key base locale key (without the One/Other suffix).
+     * @param {number} count item count.
+     * @param {Record<string, unknown>} [values] extra placeholders.
+     * @returns {string} the formatted text.
+     */
+    function countText(t, key, count, values = {}) {
+      const template = t(`${key}${count === 1 ? 'One' : 'Other'}`)
+      return format(template, { ...values, count })
+    }
+
+    /**
+     * @param {number | null | undefined} bytes raw byte count.
+     * @returns {string} a compact human-readable size, or an em dash when unknown.
      */
     function formatBytes(bytes) {
-      if (typeof bytes !== 'number' || !Number.isFinite(bytes) || bytes <= 0) return '0 B'
+      if (typeof bytes !== 'number' || !Number.isFinite(bytes)) return '—'
+      if (bytes <= 0) return '0 B'
       const units = ['B', 'KB', 'MB', 'GB', 'TB']
       let value = bytes
       let unit = 0
@@ -809,6 +877,12 @@ window.__ModuleLoader__.load({
       const buttonRef = React.useRef(null)
       const menuRef = React.useRef(null)
 
+      // A pending write disables the trigger; closing the open menu prevents a
+      // stale item from starting a second mutation.
+      React.useEffect(() => {
+        if (disabled === true) setOpen(false)
+      }, [disabled])
+
       React.useEffect(() => {
         if (!open) return undefined
         const onPointerDown = (event) => {
@@ -846,6 +920,7 @@ window.__ModuleLoader__.load({
        * @returns {void}
        */
       const toggleMenu = () => {
+        if (disabled === true) return
         if (open) {
           setOpen(false)
           return
@@ -1070,25 +1145,158 @@ window.__ModuleLoader__.load({
         useLocaleRevision(ctx.locale)
         const locale = activeLocale(ctx.locale)
         const [view, setView] = React.useState({ status: 'loading', data: null, error: null })
-        const [busyId, setBusyId] = React.useState(null)
+        const [pendingRows, setPendingRows] = React.useState(() => new Set())
         const [rowErrors, setRowErrors] = React.useState({})
         const [dialog, setDialog] = React.useState(null)
         const [cleaning, setCleaning] = React.useState(false)
         const [rebuilding, setRebuilding] = React.useState(false)
         const [purgingAll, setPurgingAll] = React.useState(false)
         const [announcement, setAnnouncement] = React.useState('')
+        const [clock, setClock] = React.useState(() => Date.now())
         const [query, setQuery] = React.useState('')
         const [filter, setFilter] = React.useState('all')
         const [page, setPage] = React.useState(1)
         const abortRef = React.useRef(null)
         const searchRef = React.useRef(null)
         const panelRef = React.useRef(null)
+        /** False once the section unmounts, so late responses stay silent. */
+        const aliveRef = React.useRef(true)
+        /** Number of writes in flight; the section allows only one at a time. */
+        const activeWritesRef = React.useRef(0)
+        /** Abort scopes of in-flight writes, all cancelled on unmount. */
+        const writeScopesRef = React.useRef(new Set())
         const closeDialog = React.useCallback(() => setDialog(null), [])
 
+        /**
+         * Claim the single write slot. A second click while one mutation is in
+         * flight is ignored, so two rows can never race the Host lock.
+         *
+         * @returns {boolean} whether the write may proceed.
+         */
+        function beginWrite() {
+          if (!aliveRef.current || activeWritesRef.current > 0) return false
+          activeWritesRef.current += 1
+          return true
+        }
+
+        /**
+         * @returns {void}
+         */
+        function endWrite() {
+          activeWritesRef.current = Math.max(0, activeWritesRef.current - 1)
+        }
+
+        /**
+         * @param {string} sessionId row whose write is now pending.
+         * @returns {void}
+         */
+        function markRowPending(sessionId) {
+          setPendingRows((previous) => {
+            if (previous.has(sessionId)) return previous
+            const next = new Set(previous)
+            next.add(sessionId)
+            return next
+          })
+        }
+
+        /**
+         * @param {string} sessionId row whose write settled.
+         * @returns {void}
+         */
+        function clearRowPending(sessionId) {
+          setPendingRows((previous) => {
+            if (!previous.has(sessionId)) return previous
+            const next = new Set(previous)
+            next.delete(sessionId)
+            return next
+          })
+        }
+
+        /**
+         * @param {string} sessionId row whose owner-facing error is resolved.
+         * @returns {void}
+         */
+        function clearRowError(sessionId) {
+          setRowErrors((previous) => {
+            if (!(sessionId in previous)) return previous
+            const next = { ...previous }
+            delete next[sessionId]
+            return next
+          })
+        }
+
+        /**
+         * Open an abort scope for one write. It is cancelled by a hard timeout
+         * and by the unmount cleanup, so a stuck request can never wedge the
+         * page or outlive the settings section.
+         *
+         * @returns {{ signal: AbortSignal, timedOut: () => boolean, aborted: () => boolean, cancel: () => void, close: () => void }} the scope.
+         */
+        function openWriteScope() {
+          const controller = new AbortController()
+          let timedOut = false
+          const timer = setTimeout(() => {
+            timedOut = true
+            controller.abort()
+          }, MUTATION_TIMEOUT_MS)
+          const scope = {
+            signal: controller.signal,
+            timedOut: () => timedOut,
+            aborted: () => controller.signal.aborted,
+            cancel: () => controller.abort(),
+            close: () => {
+              clearTimeout(timer)
+              writeScopesRef.current.delete(scope)
+            },
+          }
+          writeScopesRef.current.add(scope)
+          return scope
+        }
+
+        /**
+         * Send one write request, returning a discriminated transport outcome
+         * instead of throwing, so every caller localizes failures the same way.
+         *
+         * @param {string} pathname endpoint below the API prefix.
+         * @param {object} [body] JSON request body.
+         * @returns {Promise<
+         *   | { kind: 'response', status: number, ok: boolean, payload: any }
+         *   | { kind: 'timeout' }
+         *   | { kind: 'cancelled' }
+         *   | { kind: 'network' }
+         * >} the outcome.
+         */
+        async function sendMutation(pathname, body) {
+          const scope = openWriteScope()
+          try {
+            const { status, ok, payload } = await requestJson(pathname, { method: 'POST', body, signal: scope.signal })
+            return { kind: 'response', status, ok, payload }
+          } catch {
+            if (scope.timedOut()) return { kind: 'timeout' }
+            if (scope.aborted()) return { kind: 'cancelled' }
+            return { kind: 'network' }
+          } finally {
+            scope.close()
+          }
+        }
+
+        /**
+         * @param {'timeout' | 'network'} kind transport failure.
+         * @returns {string} the localized message to show.
+         */
+        function transportMessage(kind) {
+          return kind === 'timeout' ? t('errorTimeout') : t('errorNetwork')
+        }
+
         const load = React.useCallback(() => {
           if (abortRef.current !== null) abortRef.current.abort()
           const controller = new AbortController()
           abortRef.current = controller
+          let timedOut = false
+          const timer = setTimeout(() => {
+            timedOut = true
+            controller.abort()
+          }, STATE_TIMEOUT_MS)
           setView((previous) => ({
             status: previous.data === null ? 'loading' : 'refreshing',
             data: previous.data,
@@ -1109,9 +1317,15 @@ window.__ModuleLoader__.load({
               setRowErrors({})
             })
             .catch(() => {
-              if (controller.signal.aborted) return
+              if (controller.signal.aborted) {
+                if (timedOut) {
+                  setView((previous) => ({ status: 'error', data: previous.data, error: t('errorTimeout') }))
+                }
+                return
+              }
               setView((previous) => ({ status: 'error', data: previous.data, error: t('errorNetwork') }))
             })
+            .finally(() => clearTimeout(timer))
         }, [])
 
         React.useEffect(() => {
@@ -1123,6 +1337,15 @@ window.__ModuleLoader__.load({
 
         React.useEffect(() => subscribeRevision(load), [load])
 
+        React.useEffect(
+          () => () => {
+            aliveRef.current = false
+            for (const scope of [...writeScopesRef.current]) scope.cancel()
+            writeScopesRef.current.clear()
+          },
+          [],
+        )
+
         React.useEffect(() => {
           const refresh = () => load()
           const onVisibility = () => {
@@ -1136,6 +1359,15 @@ window.__ModuleLoader__.load({
           }
         }, [load])
 
+        // Keep relative expiry text honest on a page left open for a long time.
+        React.useEffect(() => {
+          if (typeof window === 'undefined' || typeof window.setInterval !== 'function') return undefined
+          const handle = window.setInterval(() => setClock(Date.now()), 60_000)
+          return () => {
+            if (typeof window.clearInterval === 'function') window.clearInterval(handle)
+          }
+        }, [])
+
         const data = view.data
         const entries = data !== null && Array.isArray(data.entries) ? [...data.entries] : []
         entries.sort((left, right) => (right.trashedAt ?? 0) - (left.trashedAt ?? 0))
@@ -1167,11 +1399,16 @@ window.__ModuleLoader__.load({
           cleanupInfo.lastRun.error !== ''
             ? cleanupInfo.lastRun.error
             : null
-        const busy = view.status === 'loading' || view.status === 'refreshing'
+        const loading = view.status === 'loading'
+        const refreshing = view.status === 'refreshing'
+        const readsBusy = loading || refreshing
+        const pendingCount = pendingRows.size + (cleaning ? 1 : 0) + (purgingAll ? 1 : 0) + (rebuilding ? 1 : 0)
+        /** Any write (row action or maintenance) is in flight. */
+        const mutationBusy = pendingCount > 0
         const corrupt = data !== null && data.index !== undefined && data.index.status === 'corrupt'
         const recovered = data !== null && data.index !== undefined && data.index.status === 'recovered'
         const unindexed = data !== null && data.index !== undefined && typeof data.index.unindexed === 'number' ? data.index.unindexed : 0
-        const now = Date.now()
+        const now = clock
         const normalizedQuery = query.trim().toLowerCase()
 
         /**
@@ -1204,6 +1441,9 @@ window.__ModuleLoader__.load({
         const filteredEntries = entries.filter((entry) => matchesQuery(entry) && matchesFilter(entry))
         const pageCount = Math.max(1, Math.ceil(filteredEntries.length / PAGE_SIZE))
         const currentPage = Math.min(Math.max(1, page), pageCount)
+        React.useEffect(() => {
+          if (page > pageCount) setPage(pageCount)
+        }, [page, pageCount])
         const pageStart = (currentPage - 1) * PAGE_SIZE
         const visibleEntries = filteredEntries.slice(pageStart, pageStart + PAGE_SIZE)
         const filtersActive = normalizedQuery !== '' || filter !== 'all'
@@ -1265,35 +1505,41 @@ window.__ModuleLoader__.load({
          * @returns {Promise<void>} completion of the operation.
          */
         async function performRestore(entry, mode) {
-          setBusyId(entry.sessionId)
+          if (!beginWrite()) return
+          markRowPending(entry.sessionId)
           try {
-            const { status, ok, payload } = await requestJson('restore', {
-              method: 'POST',
-              body: { sessionId: entry.sessionId, mode },
-            })
-            if (!ok) {
-              const code = payload !== null && payload !== undefined && payload.error !== undefined ? payload.error.code : undefined
+            const outcome = await sendMutation('restore', { sessionId: entry.sessionId, mode })
+            if (!aliveRef.current || outcome.kind === 'cancelled') return
+            if (outcome.kind !== 'response') {
+              fail(entry, transportMessage(outcome.kind))
+              return
+            }
+            if (!outcome.ok) {
+              const code =
+                outcome.payload !== null && outcome.payload !== undefined && outcome.payload.error !== undefined
+                  ? outcome.payload.error.code
+                  : undefined
               if (mode === 'normal' && code === 'WORKSPACE_MISSING') {
                 setDialog({ kind: 'orphan', entry })
                 return
               }
-              fail(entry, describeActionFailure(status, payload, t))
+              fail(entry, describeActionFailure(outcome.status, outcome.payload, t))
               return
             }
-            const session = payload !== null && payload !== undefined ? payload.session : undefined
+            const session = outcome.payload !== null && outcome.payload !== undefined ? outcome.payload.session : undefined
             const orphan = session !== null && session !== undefined ? session.orphan === true : mode === 'orphan'
             const title =
               session !== null && session !== undefined && typeof session.title === 'string' && session.title !== ''
                 ? session.title
                 : entry.title
+            clearRowError(entry.sessionId)
             const message = format(t(orphan ? 'restoreOrphanSuccess' : 'restoreSuccess'), { title })
             bumpRevision()
             ctx.contextMenus.notify(message, true)
             announce(message)
-          } catch {
-            fail(entry, t('errorNetwork'))
           } finally {
-            setBusyId(null)
+            endWrite()
+            if (aliveRef.current) clearRowPending(entry.sessionId)
           }
         }
 
@@ -1302,24 +1548,27 @@ window.__ModuleLoader__.load({
          * @returns {Promise<void>} completion of the operation.
          */
         async function performPurge(entry) {
-          setBusyId(entry.sessionId)
+          if (!beginWrite()) return
+          markRowPending(entry.sessionId)
           try {
-            const { status, ok, payload } = await requestJson('purge', {
-              method: 'POST',
-              body: { sessionId: entry.sessionId },
-            })
-            if (!ok) {
-              fail(entry, describeActionFailure(status, payload, t))
+            const outcome = await sendMutation('purge', { sessionId: entry.sessionId })
+            if (!aliveRef.current || outcome.kind === 'cancelled') return
+            if (outcome.kind !== 'response') {
+              fail(entry, transportMessage(outcome.kind))
+              return
+            }
+            if (!outcome.ok) {
+              fail(entry, describeActionFailure(outcome.status, outcome.payload, t))
               return
             }
+            clearRowError(entry.sessionId)
             const message = format(t('purgeSuccess'), { title: entry.title })
             bumpRevision()
             ctx.contextMenus.notify(message, true)
             announce(message)
-          } catch {
-            fail(entry, t('errorNetwork'))
           } finally {
-            setBusyId(null)
+            endWrite()
+            if (aliveRef.current) clearRowPending(entry.sessionId)
           }
         }
 
@@ -1328,23 +1577,26 @@ window.__ModuleLoader__.load({
          * @returns {Promise<void>} completion of the operation.
          */
         async function performForget(entry) {
-          setBusyId(entry.sessionId)
+          if (!beginWrite()) return
+          markRowPending(entry.sessionId)
           try {
-            const { status, ok, payload } = await requestJson('forget', {
-              method: 'POST',
-              body: { sessionId: entry.sessionId },
-            })
-            if (!ok) {
-              fail(entry, describeActionFailure(status, payload, t))
+            const outcome = await sendMutation('forget', { sessionId: entry.sessionId })
+            if (!aliveRef.current || outcome.kind === 'cancelled') return
+            if (outcome.kind !== 'response') {
+              fail(entry, transportMessage(outcome.kind))
               return
             }
+            if (!outcome.ok) {
+              fail(entry, describeActionFailure(outcome.status, outcome.payload, t))
+              return
+            }
+            clearRowError(entry.sessionId)
             bumpRevision()
             ctx.contextMenus.notify(t('forgetSuccess'), true)
             announce(t('forgetSuccess'))
-          } catch {
-            fail(entry, t('errorNetwork'))
           } finally {
-            setBusyId(null)
+            endWrite()
+            if (aliveRef.current) clearRowPending(entry.sessionId)
           }
         }
 
@@ -1353,23 +1605,25 @@ window.__ModuleLoader__.load({
          * @returns {Promise<void>} completion of the operation.
          */
         async function performReveal(entry) {
-          setBusyId(entry.sessionId)
+          if (!beginWrite()) return
+          markRowPending(entry.sessionId)
           try {
-            const { status, ok, payload } = await requestJson('reveal', {
-              method: 'POST',
-              body: { sessionId: entry.sessionId },
-            })
-            if (!ok) {
-              const message = describeActionFailure(status, payload, t) || t('revealFailed')
-              fail(entry, message)
+            const outcome = await sendMutation('reveal', { sessionId: entry.sessionId })
+            if (!aliveRef.current || outcome.kind === 'cancelled') return
+            if (outcome.kind !== 'response') {
+              fail(entry, transportMessage(outcome.kind))
+              return
+            }
+            if (!outcome.ok) {
+              fail(entry, describeActionFailure(outcome.status, outcome.payload, t))
               return
             }
+            clearRowError(entry.sessionId)
             ctx.contextMenus.notify(t('revealSuccess'), true)
             announce(t('revealSuccess'))
-          } catch {
-            fail(entry, t('errorNetwork'))
           } finally {
-            setBusyId(null)
+            endWrite()
+            if (aliveRef.current) clearRowPending(entry.sessionId)
           }
         }
 
@@ -1379,6 +1633,7 @@ window.__ModuleLoader__.load({
          */
         async function performCopy(entry) {
           const copied = await copyText(entry.sessionId)
+          if (!aliveRef.current) return
           ctx.contextMenus.notify(copied ? t('copySuccess') : t('copyFailed'), copied)
           announce(copied ? t('copySuccess') : t('copyFailed'))
         }
@@ -1387,22 +1642,32 @@ window.__ModuleLoader__.load({
          * @returns {Promise<void>} completion of the operation.
          */
         async function runCleanup() {
+          if (!beginWrite()) return
           setCleaning(true)
           try {
-            const { status, ok, payload } = await requestJson('cleanup', { method: 'POST' })
-            if (!ok) {
-              ctx.contextMenus.notify(describeActionFailure(status, payload, t), false)
+            const outcome = await sendMutation('cleanup')
+            if (!aliveRef.current || outcome.kind === 'cancelled') return
+            if (outcome.kind !== 'response') {
+              ctx.contextMenus.notify(transportMessage(outcome.kind), false)
               return
             }
+            if (!outcome.ok) {
+              ctx.contextMenus.notify(describeActionFailure(outcome.status, outcome.payload, t), false)
+              return
+            }
+            const payload = outcome.payload
             const purged = payload !== null && payload !== undefined && typeof payload.purged === 'number' ? payload.purged : 0
-            const message = purged > 0 ? format(t('cleanupDone'), { count: purged }) : t('cleanupNone')
+            const failed = payload !== null && payload !== undefined && typeof payload.failed === 'number' ? payload.failed : 0
+            let message
+            if (failed > 0 && purged > 0) message = format(t('cleanupPartial'), { purged, failed })
+            else if (failed > 0) message = format(t('cleanupFailed'), { failed })
+            else message = purged > 0 ? countText(t, 'cleanupDone', purged) : t('cleanupNone')
             bumpRevision()
-            ctx.contextMenus.notify(message, true)
+            ctx.contextMenus.notify(message, failed === 0)
             announce(message)
-          } catch {
-            ctx.contextMenus.notify(t('errorNetwork'), false)
           } finally {
-            setCleaning(false)
+            endWrite()
+            if (aliveRef.current) setCleaning(false)
           }
         }
 
@@ -1412,13 +1677,20 @@ window.__ModuleLoader__.load({
          * @returns {Promise<void>} completion of the operation.
          */
         async function performPurgeAll() {
+          if (!beginWrite()) return
           setPurgingAll(true)
           try {
-            const { status, ok, payload } = await requestJson('purge-all', { method: 'POST' })
-            if (!ok) {
-              ctx.contextMenus.notify(describeActionFailure(status, payload, t), false)
+            const outcome = await sendMutation('purge-all')
+            if (!aliveRef.current || outcome.kind === 'cancelled') return
+            if (outcome.kind !== 'response') {
+              ctx.contextMenus.notify(transportMessage(outcome.kind), false)
+              return
+            }
+            if (!outcome.ok) {
+              ctx.contextMenus.notify(describeActionFailure(outcome.status, outcome.payload, t), false)
               return
             }
+            const payload = outcome.payload
             const purged = payload !== null && payload !== undefined && typeof payload.purged === 'number' ? payload.purged : 0
             const forgotten =
               payload !== null && payload !== undefined && typeof payload.forgotten === 'number' ? payload.forgotten : 0
@@ -1428,15 +1700,14 @@ window.__ModuleLoader__.load({
               failed > 0
                 ? format(t('purgeAllPartial'), { removed, failed })
                 : removed > 0
-                  ? format(t('purgeAllDone'), { count: removed })
+                  ? countText(t, 'purgeAllDone', removed)
                   : t('purgeAllNone')
             bumpRevision()
             ctx.contextMenus.notify(message, failed === 0)
             announce(message)
-          } catch {
-            ctx.contextMenus.notify(t('errorNetwork'), false)
           } finally {
-            setPurgingAll(false)
+            endWrite()
+            if (aliveRef.current) setPurgingAll(false)
           }
         }
 
@@ -1444,13 +1715,20 @@ window.__ModuleLoader__.load({
          * @returns {Promise<void>} completion of the operation.
          */
         async function runRebuild() {
+          if (!beginWrite()) return
           setRebuilding(true)
           try {
-            const { status, ok, payload } = await requestJson('rebuild', { method: 'POST' })
-            if (!ok) {
-              ctx.contextMenus.notify(describeActionFailure(status, payload, t), false)
+            const outcome = await sendMutation('rebuild')
+            if (!aliveRef.current || outcome.kind === 'cancelled') return
+            if (outcome.kind !== 'response') {
+              ctx.contextMenus.notify(transportMessage(outcome.kind), false)
+              return
+            }
+            if (!outcome.ok) {
+              ctx.contextMenus.notify(describeActionFailure(outcome.status, outcome.payload, t), false)
               return
             }
+            const payload = outcome.payload
             const count = payload !== null && payload !== undefined && typeof payload.entries === 'number' ? payload.entries : 0
             const unindexedCount =
               payload !== null && payload !== undefined && typeof payload.unindexed === 'number' ? payload.unindexed : 0
@@ -1461,10 +1739,9 @@ window.__ModuleLoader__.load({
             bumpRevision()
             ctx.contextMenus.notify(message, true)
             announce(message)
-          } catch {
-            ctx.contextMenus.notify(t('errorNetwork'), false)
           } finally {
-            setRebuilding(false)
+            endWrite()
+            if (aliveRef.current) setRebuilding(false)
           }
         }
 
@@ -1558,7 +1835,7 @@ window.__ModuleLoader__.load({
           if (subagentCount > 0) {
             badges.push({
               key: 'subagents',
-              label: format(t('badgeSubagents'), { count: subagentCount }),
+              label: countText(t, 'badgeSubagents', subagentCount),
               tone: 'info',
             })
           }
@@ -1607,7 +1884,7 @@ window.__ModuleLoader__.load({
                   onClick: () => {
                     void runRebuild()
                   },
-                  disabled: rebuilding,
+                  disabled: loading || mutationBusy,
                 },
                 rebuilding ? t('rebuilding') : t('rebuild'),
               ),
@@ -1644,9 +1921,7 @@ window.__ModuleLoader__.load({
           const retryText =
             cleanupRetryAt !== null ? format(t('cleanupRetryAt'), { time: formatDate(cleanupRetryAt, locale, true) }) : ''
           const cleanupMessage =
-            cleanupFailed > 0
-              ? format(t('cleanupFailedBanner'), { count: cleanupFailed })
-              : format(t('cleanupErrorBanner'), { message: cleanupError })
+            cleanupFailed > 0 ? countText(t, 'cleanupFailedBanner', cleanupFailed) : t('cleanupErrorBanner')
           banners.push(
             h(
               'div',
@@ -1654,7 +1929,7 @@ window.__ModuleLoader__.load({
               h(TrashGlyph, { size: 16 }),
               h(
                 'span',
-                { className: 'dsh-trash__bannerText' },
+                { className: 'dsh-trash__bannerText', title: cleanupError ?? undefined },
                 cleanupMessage,
                 retryText === '' ? null : ` ${retryText}`,
               ),
@@ -1666,7 +1941,7 @@ window.__ModuleLoader__.load({
                   onClick: () => {
                     void runCleanup()
                   },
-                  disabled: busy || cleaning || corrupt,
+                  disabled: loading || mutationBusy || corrupt,
                 },
                 cleaning ? t('cleaning') : t('cleanupRetryNow'),
               ),
@@ -1699,7 +1974,7 @@ window.__ModuleLoader__.load({
                 h(
                   'span',
                   { className: 'dsh-trash__stats' },
-                  format(t('statsCount'), { count: entries.length }),
+                  countText(t, 'statsCount', entries.length),
                   h('span', { className: 'dsh-trash__dot', 'aria-hidden': true }, '·'),
                   format(t('statsSize'), { size: formatBytes(totalBytes) }),
                   h('span', { className: 'dsh-trash__dot', 'aria-hidden': true }, '·'),
@@ -1716,7 +1991,7 @@ window.__ModuleLoader__.load({
                       onClick: () => {
                         void runCleanup()
                       },
-                      disabled: busy || cleaning || corrupt,
+                      disabled: loading || mutationBusy || corrupt,
                     },
                     cleaning ? t('cleaning') : t('cleanupExpired'),
                   ),
@@ -1726,8 +2001,8 @@ window.__ModuleLoader__.load({
                       type: 'button',
                       className: 'dsh-trash__button',
                       onClick: load,
-                      disabled: busy,
-                      'aria-busy': busy ? 'true' : 'false',
+                      disabled: loading || refreshing,
+                      'aria-busy': refreshing ? 'true' : 'false',
                     },
                     t('refresh'),
                   ),
@@ -1737,7 +2012,7 @@ window.__ModuleLoader__.load({
                       type: 'button',
                       className: 'dsh-trash__button dsh-trash__button--danger',
                       onClick: () => setDialog({ kind: 'purgeAll', count: entries.length }),
-                      disabled: busy || cleaning || purgingAll || corrupt || entries.length === 0,
+                      disabled: loading || mutationBusy || corrupt || entries.length === 0,
                     },
                     purgingAll ? t('purgingAll') : t('purgeAll'),
                   ),
@@ -1863,8 +2138,15 @@ window.__ModuleLoader__.load({
             'ul',
             { className: 'dsh-trash__list', 'aria-label': t('listLabel') },
             visibleEntries.map((entry) => {
-              const rowBusy = busyId === entry.sessionId
-              const error = rowErrors[entry.sessionId] ?? entry.lastError
+              const rowBusy = pendingRows.has(entry.sessionId)
+              const rowError = rowErrors[entry.sessionId]
+              const lastErrorCode = typeof entry.lastErrorCode === 'string' ? entry.lastErrorCode : null
+              const lastErrorText =
+                typeof entry.lastError === 'string' && entry.lastError !== ''
+                  ? t(LAST_ERROR_KEYS[lastErrorCode] ?? 'lastErrorIo')
+                  : null
+              const error = rowError ?? lastErrorText
+              const errorTitle = rowError === undefined && typeof entry.lastError === 'string' ? entry.lastError : undefined
               const title = entry.title !== undefined && entry.title !== '' ? entry.title : entry.sessionId
               return h(
                 'li',
@@ -1904,7 +2186,11 @@ window.__ModuleLoader__.load({
                     h('span', null, formatBytes(entry.sizeBytes)),
                   ),
                   error !== null && error !== undefined && error !== ''
-                    ? h('div', { className: 'dsh-trash__rowError', role: 'status' }, format(t('lastErrorLabel'), { message: error }))
+                    ? h(
+                        'div',
+                        { className: 'dsh-trash__rowError', role: 'status', title: errorTitle },
+                        format(t('lastErrorLabel'), { message: error }),
+                      )
                     : null,
                 ),
                 h(
@@ -1917,7 +2203,7 @@ window.__ModuleLoader__.load({
                           type: 'button',
                           className: 'dsh-trash__button',
                           'aria-label': format(t('actionRestoreFor'), { title }),
-                          disabled: rowBusy || busy || purgingAll,
+                          disabled: rowBusy || mutationBusy || corrupt || loading,
                           onClick: () => {
                             if (entry.requiresOrphanRestore === true) setDialog({ kind: 'orphan', entry })
                             else void performRestore(entry, 'normal')
@@ -1929,7 +2215,7 @@ window.__ModuleLoader__.load({
                   h(ActionMenu, {
                     label: format(t('actionMoreFor'), { title }),
                     items: menuItemsFor(entry),
-                    disabled: rowBusy || busy || purgingAll,
+                    disabled: rowBusy || mutationBusy || corrupt || loading,
                   }),
                 ),
               )
@@ -1983,7 +2269,7 @@ window.__ModuleLoader__.load({
                   className: 'dsh-trash__panel',
                   key: 'panel',
                   ref: panelRef,
-                  'aria-busy': busy ? 'true' : 'false',
+                  'aria-busy': readsBusy ? 'true' : 'false',
                 },
                 panelBody,
                 pagination,
@@ -2069,7 +2355,7 @@ window.__ModuleLoader__.load({
                 : 0
             const message =
               subagentCount > 0
-                ? format(t('trashSuccessTree'), { title, count: subagentCount })
+                ? countText(t, 'trashSuccessTree', subagentCount, { title })
                 : format(t('trashSuccess'), { title })
             ctx.contextMenus.notify(message, true, {
               label: t('undo'),