dsh-sessions-manager 3.4.2 → 3.5.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-sessions-manager",
   "description": "DSH 设置面板会话管理器：归档 / 恢复 / 彻底删除 / 移动到其他工作区，带工作区标签与会话日期；统一「会话管理」面板。Session manager for the DeepSeek Harness settings panel — archive / restore / permanently delete / move sessions across workspaces, with workspace tags & session dates in one unified panel.",
-  "version": "3.4.2",
+  "version": "3.5.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {

package/src/client/index.jsx

@@ -219,6 +219,7 @@ function installSettingsNavIcons(ctx) {
 function SessionPanel({ workspacesSvc }) {
   const [sessions, setSessions] = useState(null)
   const [workspaces, setWorkspaces] = useState([])
+  const [capabilities, setCapabilities] = useState(null)
   const initialPrefs = useRef(loadPanelPrefs()).current
   // 注意：'storage' 已从可持久化取值中移除（它不再是视图），旧版残留的
   // filter='storage' 会自动回落到 'all'，避免落到一个已不存在的界面。
@@ -276,14 +277,16 @@ function SessionPanel({ workspacesSvc }) {
     Promise.all([
       postJSON('/archived-sessions/sessions', {}),
       postJSON('/archived-sessions/workspaces', {}),
+      postJSON('/archived-sessions/capabilities', {}),
     ])
-      .then(([s, works]) => {
+      .then(([s, works, caps]) => {
         // Permanently-purged sessions must never re-appear here, even if DSH's
         // in-memory session index still lists them after the file was unlinked.
         const purged = dsmLoadPurged()
         const visible = (s.items || []).filter((x) => !purged.has(String(x.sessionId)))
         setSessions(visible)
         setWorkspaces(works.items || [])
+        setCapabilities(caps || null)
         setSelected({})
         setDelTarget(null)
         setConfirmBatch(false)
@@ -393,6 +396,9 @@ function SessionPanel({ workspacesSvc }) {
     const w = workspaces.find((x) => x.workspaceId === id)
     return w ? w.path : ''
   }
+  const actionCapability = (name) => (capabilities && capabilities.actions && capabilities.actions[name]) || { available: false, reason: '正在检查当前 DSH 的兼容能力…' }
+  const canPurge = actionCapability('purge')
+  const canMove = actionCapability('move')
 
   const archivedList = sessions ? sessions.filter((x) => x.archived) : []
   const activeList = sessions ? sessions.filter((x) => !x.archived) : []
@@ -473,7 +479,12 @@ function SessionPanel({ workspacesSvc }) {
   const verifyTrash = () => {
     setTrashBusy('__verify')
     postJSON('/archived-sessions/trash/verify', {})
-      .then((r) => { setTrashBusy(null); setTrashCheck(r); showToast(r.missing ? `发现 ${r.missing} 条日志缺失` : '回收站校验通过') })
+      .then((r) => {
+        setTrashBusy(null); setTrashCheck(r)
+        if (r.missing) showToast(`发现 ${r.missing} 条日志缺失`)
+        else if (r.unverified) showToast(`${r.unverified} 条日志位置由当前 Runtime 管理，无法直接核验`)
+        else showToast('回收站校验通过')
+      })
       .catch((e) => { setTrashBusy(null); setError(String((e && e.message) || e)) })
   }
 
@@ -554,6 +565,7 @@ function SessionPanel({ workspacesSvc }) {
   }
 
   const doMove = (it) => {
+    if (!canMove.available) { setError(canMove.reason || '当前环境不支持跨工作区移动'); return }
     const targetPath = moveMode === 'new' ? newPath.trim() : wsPath(targetWs)
     if (!targetPath) { setError('请选择已有工作区或输入新的目标目录路径'); return }
     setBusy(it.sessionId)
@@ -591,6 +603,7 @@ function SessionPanel({ workspacesSvc }) {
   }
 
   const openMoveFor = (it) => {
+    if (!canMove.available) { setError(canMove.reason || '当前环境不支持跨工作区移动'); return }
     if (openMove === it.sessionId) { setOpenMove(null); return }
     setTargetWs(workspaces.length ? (targetWs || workspaces[0].workspaceId) : '')
     setMoveMode('existing')
@@ -663,15 +676,20 @@ function SessionPanel({ workspacesSvc }) {
         >⋯</button>
         {openMenu === it.sessionId && (
           <div className="more-menu" role="menu">
-            {items.map(([id, label]) => (
+            {items.map(([id, label]) => {
+              const blocked = id === 'move' && !canMove.available
+              return (
               <button
                 key={id}
                 type="button"
                 role="menuitem"
                 className={'more-item' + (id === 'delete' ? ' more-item-danger' : '')}
+                disabled={blocked}
+                title={blocked ? canMove.reason : undefined}
                 onClick={() => runMenu(id, it)}
               >{label}</button>
-            ))}
+              )
+            })}
           </div>
         )}
       </div>
@@ -1034,9 +1052,10 @@ function SessionPanel({ workspacesSvc }) {
             </select>
           </div>
           <div className="sess-field"><label>数据检查</label><button type="button" className="archv-btn" disabled={trashBusy !== null} onClick={verifyTrash}>{trashBusy === '__verify' ? '校验中…' : '校验日志完整性'}</button></div>
-          <div className="sess-field"><label>永久清理</label><button type="button" className="archv-btn archv-del" disabled={trashBusy !== null || !trash.length} onClick={() => setPurgeTarget('__all')}>清空回收站</button></div>
+          <div className="sess-field"><label>永久清理</label><button type="button" className="archv-btn archv-del" disabled={trashBusy !== null || !trash.length || !canPurge.available} title={!canPurge.available ? canPurge.reason : undefined} onClick={() => setPurgeTarget('__all')}>清空回收站</button></div>
         </div>
-        {trashCheck && <div className={trashCheck.missing ? 'archv-err' : 'archv-empty'} role="status">校验完成：{trashCheck.healthy} 条正常，{trashCheck.missing} 条日志缺失。</div>}
+        {!canPurge.available && <div className="archv-empty" role="status">{canPurge.reason}</div>}
+        {trashCheck && <div className={trashCheck.missing ? 'archv-err' : 'archv-empty'} role="status">校验完成：{trashCheck.healthy} 条正常，{trashCheck.missing} 条日志缺失，{trashCheck.unverified || 0} 条无法直接核验。</div>}
         {trash.length === 0 ? (
           <div className="dsm-trash-empty">回收站为空。删除的会话会先进入这里，可恢复或彻底删除。</div>
         ) : (
@@ -1047,7 +1066,7 @@ function SessionPanel({ workspacesSvc }) {
                 <span className="dsm-trash-date">{fmtDate(t.deletedAt)}</span>
                 <span className="dsm-trash-actions">
                   <button type="button" className="archv-btn" disabled={trashBusy !== null} onClick={() => restoreTrash(t.sessionId)}>恢复</button>
-                  <button type="button" className="archv-btn archv-del" disabled={trashBusy !== null} onClick={() => setPurgeTarget(t.sessionId)}>彻底删除</button>
+                  <button type="button" className="archv-btn archv-del" disabled={trashBusy !== null || !canPurge.available} title={!canPurge.available ? canPurge.reason : undefined} onClick={() => setPurgeTarget(t.sessionId)}>彻底删除</button>
                 </span>
               </div>
             ))}
@@ -1169,6 +1188,14 @@ let dsmTrashIds = null
 let dsmServerPurgedIds = new Set()
 let dsmAuthoritativeTitles = new Map()
 let dsmTrashTick = 0
+let dsmCapabilities = null
+async function dsmLoadCapabilities() {
+  try { dsmCapabilities = await postJSON('/archived-sessions/capabilities', {}) } catch (e) { /* unknown stays safely unavailable */ }
+  return dsmCapabilities
+}
+function dsmActionCapability(name) {
+  return dsmCapabilities && dsmCapabilities.actions && dsmCapabilities.actions[name]
+}
 async function dsmLoadTrashIds() {
   try {
     const r = await postJSON('/archived-sessions/sidebar-state', {})
@@ -1385,6 +1412,11 @@ function installSidebarSessionMenuAug() {
     const move = mk('移动会话', ICON_MOVE, false)
     const del = mk('删除会话', ICON_DEL, true)
     const mark = mk(dsmLoadManual().has(info.id) ? '标记已读' : '标记未读', ICON_UNREAD, false)
+    const moveCapability = dsmActionCapability('move')
+    if (!moveCapability || !moveCapability.available) {
+      move.btn.disabled = true
+      move.btn.title = (moveCapability && moveCapability.reason) || '正在检查当前版本的移动能力'
+    }
     if (mark.btn.firstChild) mark.btn.firstChild.style.color = 'var(--dsw-alias-state-business-primary)'
     const chev = document.createElement('span')
     chev.style.cssText = 'margin-left:auto;flex:none;color:var(--dsw-alias-label-tertiary);font-size:14px;line-height:1'
@@ -1647,6 +1679,8 @@ function installSidebarWorkspaceDrag() {
   }, true)
 
   document.addEventListener('dragstart', (event) => {
+    const moveCapability = dsmActionCapability('move')
+    if (!moveCapability || !moveCapability.available) return
     const row = eventRow(event)
     const item = row && sessionForRow(row)
     if (!item || moving) return
@@ -1729,6 +1763,7 @@ function installSidebarWorkspaceDrag() {
 }
 
 export function apply(ctx) {
+  dsmLoadCapabilities()
   installSettingsNavIcons(ctx)
   installSidebarSessionMenuAug()
   installSidebarStatusDots()

package/src/compat/capabilities.js

@@ -0,0 +1,34 @@
+function action(available, reason = null) {
+  return { available: !!available, reason: available ? null : reason }
+}
+
+export function detectCapabilities({ persistence, workspaceRegistry }) {
+  const handleApi = !!(persistence && typeof persistence.open === 'function')
+  const legacyRead = !!(persistence && typeof persistence.readFrom === 'function')
+  const legacyLocate = !!(persistence && (typeof persistence.locate === 'function'
+    || (persistence.backend && typeof persistence.backend.locate === 'function')))
+  const workspaceInternals = !!(workspaceRegistry
+    && workspaceRegistry.headers && workspaceRegistry.sessionPaths
+    && typeof workspaceRegistry.replaceHeaderIndex === 'function')
+
+  return {
+    persistence: handleApi ? 'session-handle' : 'legacy',
+    actions: {
+      read: action(legacyRead || handleApi, '当前 DSH 未提供可识别的会话读取接口'),
+      archive: action(!!(workspaceRegistry && typeof workspaceRegistry.archiveSession === 'function'), '当前 DSH 未提供归档接口'),
+      trash: action(legacyRead || handleApi, '当前 DSH 无法读取会话，不能安全移入回收站'),
+      restoreTrash: action(true),
+      purge: action(!handleApi && legacyLocate, '当前 DSH 版本尚未提供经过验证的安全永久删除能力'),
+      move: action(!handleApi && legacyRead && legacyLocate && workspaceInternals, '当前 DSH 版本尚未提供经过验证的跨工作区迁移能力'),
+    },
+  }
+}
+
+export function requireCapability(capabilities, name) {
+  const value = capabilities && capabilities.actions && capabilities.actions[name]
+  if (value && value.available) return
+  const error = new Error((value && value.reason) || `当前环境不支持 ${name}`)
+  error.status = 409
+  error.code = 'DSM_CAPABILITY_UNAVAILABLE'
+  throw error
+}

package/src/compat/persistence.js

@@ -0,0 +1,72 @@
+// Compatibility boundary for the two DSH persistence generations supported by
+// dsh-sessions-manager. Business code consumes normalized headers and complete
+// inspections; it never needs to know whether DSH returned a legacy header or
+// a handle-era SessionPersistenceSnapshot.
+
+function asHeader(value) {
+  if (!value || typeof value !== 'object') return null
+  const candidate = value.header && typeof value.header === 'object' ? value.header : value
+  return candidate.id == null ? null : candidate
+}
+
+export function normalizePersistenceEntry(value) {
+  const header = asHeader(value)
+  if (!header) return null
+  const snapshot = value && value.header === header ? value : null
+  return {
+    header,
+    snapshot,
+    id: String(header.id),
+    sizeBytes: snapshot && Number.isFinite(snapshot.sizeBytes) ? Number(snapshot.sizeBytes) : null,
+    eventCount: snapshot && Number.isSafeInteger(snapshot.eventCount) ? snapshot.eventCount : null,
+    revision: snapshot ? snapshot.revision : null,
+  }
+}
+
+export function normalizePersistenceList(values) {
+  if (!Array.isArray(values)) return []
+  return values.map(normalizePersistenceEntry).filter(Boolean)
+}
+
+export function createPersistenceAdapter(service) {
+  if (!service || typeof service.list !== 'function') throw new TypeError('sessionPersistence.list is required')
+
+  async function listEntries(options) {
+    return normalizePersistenceList(await service.list(options))
+  }
+
+  async function readSession(id, offset = 0) {
+    if (typeof service.readFrom === 'function') {
+      const result = await service.readFrom(id, offset)
+      return {
+        meta: result && result.meta ? result.meta : null,
+        inheritedEventCount: result && Number.isSafeInteger(result.inheritedEventCount) ? result.inheritedEventCount : 0,
+        events: result && Array.isArray(result.events) ? result.events : [],
+      }
+    }
+    if (typeof service.open !== 'function') throw new Error('当前 DSH 持久化服务不支持读取会话')
+    const handle = await service.open(id, 'read')
+    if (!handle || typeof handle.read !== 'function' || typeof handle.close !== 'function') {
+      try { if (handle && typeof handle.close === 'function') await handle.close() } catch {}
+      throw new Error('DSH 返回了无效的 SessionHandle')
+    }
+    try {
+      const events = await handle.read(offset)
+      return {
+        meta: handle.header || handle.meta || null,
+        inheritedEventCount: Number.isSafeInteger(handle.inheritedEventCount) ? handle.inheritedEventCount : 0,
+        events: Array.isArray(events) ? events : [...(events || [])],
+      }
+    } finally {
+      await handle.close()
+    }
+  }
+
+  function locate(header) {
+    if (typeof service.locate === 'function') return service.locate(header)
+    return null
+  }
+
+  const kind = typeof service.open === 'function' ? 'session-handle' : 'legacy'
+  return { kind, listEntries, readSession, locate }
+}

package/src/index.js

@@ -18,6 +18,8 @@ import { aggregateStorage } from './storage-stats.js'
 import { createAutoArchiveStore, pickInactiveCandidates } from './auto-archive.js'
 import { createSessionMetaCache, fingerprintOf } from './session-meta-cache.js'
 import { createTitleIndexStore } from './title-persist-index.js'
+import { createPersistenceAdapter } from './compat/persistence.js'
+import { detectCapabilities, requireCapability } from './compat/capabilities.js'
 
 
 export const name = 'dsh-sessions-manager'
@@ -122,6 +124,8 @@ function foldTitle(events) {
 export function apply(ctx) {
   const w = ctx.workspaceRegistry
   const sp = ctx.sessionPersistence
+  const persistence = createPersistenceAdapter(sp)
+  const capabilities = detectCapabilities({ persistence: sp, workspaceRegistry: w })
   const sq = ctx.sessionQuery
   const dom = () => ctx.storageDomain.get('workspace')
   const authorityTitleCache = new Map()
@@ -269,7 +273,7 @@ export function apply(ctx) {
     // 且结果同样会进缓存，下一次列表就不会再走一遍）。
     if (!meta.title || !meta.cwd) {
       try {
-        const r = await sp.readFrom(id, 0)
+        const r = await persistence.readSession(id, 0)
         if (r.meta) {
           if (!meta.cwd) meta.cwd = r.meta.cwd || null
           if (!meta.createdAt) meta.createdAt = r.meta.createdAt || null
@@ -295,17 +299,19 @@ export function apply(ctx) {
   async function collectUsage(preloadedHeaders) {
     const sizeById = new Map()
     const mtimeById = new Map()
-    let headers = null
-    if (Array.isArray(preloadedHeaders)) headers = preloadedHeaders
-    else { try { headers = await sp.list() } catch (e) { headers = [] } }
-    if (!Array.isArray(headers)) headers = []
+    let entries = null
+    if (Array.isArray(preloadedHeaders)) entries = preloadedHeaders
+    else { try { entries = await persistence.listEntries() } catch (e) { entries = [] } }
+    if (!Array.isArray(entries)) entries = []
     const CHUNK = 8
-    for (let i = 0; i < headers.length; i += CHUNK) {
-      await Promise.all(headers.slice(i, i + CHUNK).map(async (header) => {
-        const id = header && header.id != null ? String(header.id) : null
+    for (let i = 0; i < entries.length; i += CHUNK) {
+      await Promise.all(entries.slice(i, i + CHUNK).map(async (entry) => {
+        const header = entry && entry.header ? entry.header : entry
+        const id = entry && entry.id != null ? String(entry.id) : (header && header.id != null ? String(header.id) : null)
         if (!id) return
+        if (entry && Number.isFinite(entry.sizeBytes)) sizeById.set(id, Number(entry.sizeBytes))
         try {
-          const loc = sp.locate(header)
+          const loc = persistence.locate(header)
           if (!loc || typeof loc.path !== 'string' || !loc.path) return
           const st = await stat(loc.path)
           if (!st) return
@@ -393,17 +399,20 @@ export function apply(ctx) {
     let cwd = null
     let title = null
     let removedPath = null
+    let persistenceEntry = null
     try {
-      const headers = await sp.list()
-      header = headers.find((h) => String(h.id) === sid) || null
+      const entries = await persistence.listEntries()
+      const found = entries.find((entry) => entry.id === sid) || null
+      persistenceEntry = found
+      header = found ? found.header : null
       if (header) {
-        const loc = sp.locate(header)
+        const loc = persistence.locate(header)
         if (loc && typeof loc.path === 'string') removedPath = loc.path
         cwd = header.cwd || null
         title = header.title || (header.meta && header.meta.title) || null
       }
       if (!title) {
-        const r = await sp.readFrom(sid, 0)
+        const r = await persistence.readSession(sid, 0)
         if (r && r.meta) { if (!cwd) cwd = r.meta.cwd; title = foldTitle(r.events) }
       }
     } catch (e) { /* best-effort */ }
@@ -418,7 +427,7 @@ export function apply(ctx) {
       const entry = {
         sessionId: sid, title: title || cwd || sid, cwd: cwd || null,
         header: header || null, originalPath: removedPath || null,
-        sizeBytes: header && typeof header.size === 'number' ? header.size : null,
+        sizeBytes: persistenceEntry && Number.isFinite(persistenceEntry.sizeBytes) ? persistenceEntry.sizeBytes : null,
         wasArchived: archived, deletedAt: Date.now(),
       }
       const at = store.items.findIndex((t) => String(t.sessionId) === sid)
@@ -451,18 +460,24 @@ export function apply(ctx) {
   // the original workspace dir) and detach it from any workspace so DSH drops it.
   async function purgeFromTrash(sid) {
     requireSessionId(sid)
+    requireCapability(capabilities, 'purge')
     let purged = false
     await mutateTrash(async (store) => {
       const entry = store.items.find((t) => String(t.sessionId) === sid)
       if (!entry) { const error = new Error('回收站中找不到该会话'); error.status = 404; throw error }
       let target = null
       try {
-        const headers = await sp.list()
-        const current = headers.find((h) => String(h.id) === sid)
-        const located = current && sp.locate(current)
+        const entries = await persistence.listEntries()
+        const current = entries.find((entry) => entry.id === sid)
+        const located = current && persistence.locate(current.header)
         if (located && typeof located.path === 'string') target = located.path
       } catch (e) {}
       if (!target && typeof entry.originalPath === 'string') target = entry.originalPath
+      if (!target) {
+        const error = new Error('无法确认该会话的物理日志位置，已停止永久删除')
+        error.status = 409
+        throw error
+      }
       // JSONL persistence stores logs as
       //   .../<sessionId>/session.jsonl.zstd
       // Older backends may instead include the id in the filename itself.
@@ -532,6 +547,7 @@ export function apply(ctx) {
   }
 
   async function cleanupExpiredTrash() {
+    if (!capabilities.actions.purge.available) return 0
     const store = await readTrashStore()
     const days = store.settings.retentionDays
     if (!days) return 0
@@ -567,6 +583,7 @@ export function apply(ctx) {
   }
 
   async function moveOne(sid, targetPath) {
+    requireCapability(capabilities, 'move')
     // Only block the *active* conversation. ctx.sessions keeps instantiated
     // sessions alive after you switch away, so the old check (sessions.get(sid))
     // wrongly rejected every opened session — you could never move one you'd
@@ -577,7 +594,7 @@ export function apply(ctx) {
     if (activeId != null && String(activeId) === String(sid)) {
       throw new Error('该会话当前处于打开状态，请先切换到别的会话再移动。')
     }
-    const r = await sp.readFrom(sid, 0)
+    const r = await persistence.readSession(sid, 0)
     if (!r || !r.meta) throw new Error('无法读取该会话的日志')
     const meta = r.meta
     const events = r.events
@@ -661,7 +678,7 @@ export function apply(ctx) {
       // disk, and WorkspaceEntity.sessionIds filters by that exact cwd. A bare
       // rename would leave frame0 pointing at the old workspace, so reindex /
       // restart would keep attributing the session to the wrong workspace.
-      await relocateLog(meta, newHeader)
+      if (!await relocateLog(meta, newHeader)) throw new Error('移动失败：无法确认会话日志已迁移到目标工作区')
       // Redirect the persistence state's cwd so future appends land in newPath.
       try {
         const st = sp.states && sp.states.get && sp.states.get(sid)
@@ -683,7 +700,7 @@ export function apply(ctx) {
 
       if (typeof sp.create !== 'function' || typeof sp.append !== 'function') {
         // No create primitive: must relocate the existing log directly.
-        await relocateLog(meta, newHeader)
+        if (!await relocateLog(meta, newHeader)) throw new Error('移动失败：无法确认会话日志已迁移到目标工作区')
       } else {
         const backupPath = oldPath ? `${oldPath}.move-backup-${Date.now()}` : null
         if (backupPath) { try { await rename(oldPath, backupPath) } catch (e) { if (e && e.code !== 'ENOENT') throw new Error('移动失败：无法备份旧的会话日志') } }
@@ -691,7 +708,7 @@ export function apply(ctx) {
         try {
           await sp.create(newHeader)
           await sp.append(sid, events)
-          const check = await sp.readFrom(sid, 0)
+          const check = await persistence.readSession(sid, 0)
           if (!check || !check.meta || check.meta.cwd !== canonical) {
             throw new Error('移动后校验失败：会话工作目录未正确更新')
           }
@@ -701,7 +718,7 @@ export function apply(ctx) {
             // Collision: the session is already materialized in states (archived
             // or previously opened). Fall back to physically relocating the log.
             await restore()
-            await relocateLog(meta, newHeader)
+            if (!await relocateLog(meta, newHeader)) throw new Error('移动失败：无法确认会话日志已迁移到目标工作区')
           } else {
             await restore()
             throw new Error('移动会话日志失败：' + String((e && e.message) || e))
@@ -763,10 +780,10 @@ export function apply(ctx) {
   async function reindexRegistry() {
     const reg = w
     if (!reg || typeof reg.replaceHeaderIndex !== 'function') return false
-    let headers = null
-    try { headers = await sp.list() } catch (e) { headers = null }
-    if (!headers || !Array.isArray(headers)) return false
-    await reg.replaceHeaderIndex(headers)
+    let entries = null
+    try { entries = await persistence.listEntries() } catch (e) { entries = null }
+    if (!entries || !Array.isArray(entries)) return false
+    await reg.replaceHeaderIndex(entries.map((entry) => entry.header))
     if (typeof reg.rebuildEntities === 'function') reg.rebuildEntities()
     return true
   }
@@ -820,15 +837,15 @@ export function apply(ctx) {
   //      是元数据缓存能否跳过整本解码的前提，收益远大于成本
   //   3. 未命中缓存的会话走**一次**批量投影（sq.readTitleSnapshots），而不是逐条
   async function allSessionItems(opts = {}) {
-    let headers = []
+    let entries = []
     let headersOk = false
     try {
-      headers = await sp.list()
-      headersOk = Array.isArray(headers)
-      if (!headersOk) headers = []
-    } catch (e) { headers = [] }
+      entries = await persistence.listEntries()
+      headersOk = Array.isArray(entries)
+      if (!headersOk) entries = []
+    } catch (e) { entries = [] }
     let live = ctx.get('sessions')
-    const ids = headers.map((h) => String(h.id))
+    const ids = entries.map((entry) => entry.id)
     if (live) { try { live.list().forEach((s) => { const sid = String(s.id); if (!ids.includes(sid)) ids.push(sid) }) } catch (e) { /* ignore */ } }
     // Exclude sessions already moved to the recycle bin (软删除): they live in
     // 回收站, not in 会话管理, so the panel won't re-list them after a delete.
@@ -842,7 +859,7 @@ export function apply(ctx) {
     try { for (const ent of w.list()) wsByPath[ent.path] = ent } catch (e) { wsByPath = {} }
     const currentArchived = new Set((await archivedState().catch(() => ({ archivedSessionIds: [] }))).archivedSessionIds || [])
     const items = []
-    const usage = await collectUsage(headers)
+    const usage = await collectUsage(entries)
     // 先按指纹把「缓存命中」与「需要解码」分开，只对后者做批量投影。
     const statsById = new Map(visibleIds.map((id) => [id, { mtimeMs: usage.mtimeById.get(id), size: usage.sizeById.get(id) }]))
     const { cached, missing } = metaCache.partition(visibleIds, statsById)
@@ -927,15 +944,15 @@ export function apply(ctx) {
   // 既不会陈旧也不会回到「每次全量解码」。
   async function sidebarAuthority() {
     const ids = []
-    let headers = []
-    try { headers = await sp.list() } catch (e) { headers = [] }
-    if (!Array.isArray(headers)) headers = []
-    for (const header of headers) ids.push(String(header.id))
+    let entries = []
+    try { entries = await persistence.listEntries() } catch (e) { entries = [] }
+    if (!Array.isArray(entries)) entries = []
+    for (const entry of entries) ids.push(entry.id)
     const sessions = ctx.get('sessions')
     try { if (sessions) sessions.list().forEach((session) => { const sid = String(session.id); if (!ids.includes(sid)) ids.push(sid) }) } catch (e) {}
     const store = await readTrashStore()
     if (ids.length) {
-      const usage = await collectUsage(headers)
+      const usage = await collectUsage(entries)
       const statsById = new Map(ids.map((id) => [id, { mtimeMs: usage.mtimeById.get(id), size: usage.sizeById.get(id) }]))
       const { cached, missing } = metaCache.partition(ids, statsById)
       // P4：与列表构建共用持久标题索引，冷启动零解码。
@@ -980,7 +997,7 @@ export function apply(ctx) {
       meta = (live && live.header) || null
       try { events = Array.isArray(live.events) ? [...live.events] : [] } catch (e) { events = [] }
     } else {
-      const r = await sp.readFrom(sid, 0)
+      const r = await persistence.readSession(sid, 0)
       if (!r || !r.meta) throw new Error('找不到该会话的记录（会话不存在）')
       meta = r.meta
       events = Array.isArray(r.events) ? r.events : []
@@ -989,7 +1006,7 @@ export function apply(ctx) {
     try {
       // rc.8 的 sessionPersistence 后端没有 artifactInfo；用 locate(meta) 拿日志
       // 文件真实路径后 stat 出字节数（磁盘占用）。
-      const loc = sp.locate(meta)
+      const loc = persistence.locate(meta)
       if (loc && typeof loc.path === 'string' && loc.path) {
         const st = await stat(loc.path)
         if (st && typeof st.size === 'number') sizeBytes = st.size
@@ -1062,7 +1079,8 @@ export function apply(ctx) {
     const subagentSet = new Set()
     try {
       if (typeof sp.list === 'function') {
-        for (const h of await sp.list()) {
+        for (const entry of await persistence.listEntries()) {
+          const h = entry.header
           if (String(h.parentSession) !== String(sid)) continue
           if (h.origin === 'subagent') subagentSet.add(h.id); else childrenSet.add(h.id)
         }
@@ -1098,6 +1116,12 @@ export function apply(ctx) {
       }
     }))
 
+    disposers.push(ctx.webServer.register({
+      kind: 'exact',
+      path: '/archived-sessions/capabilities',
+      handler: async (req, res) => json(res, capabilities),
+    }))
+
     disposers.push(ctx.webServer.register({
       kind: 'exact',
       path: '/archived-sessions/list',
@@ -1110,8 +1134,8 @@ export function apply(ctx) {
           let materialized = new Set()
           let live = ctx.get('sessions')
           try {
-            const headers = await sp.list()
-            materialized = new Set(headers.map((h) => String(h.id)))
+            const entries = await persistence.listEntries()
+            materialized = new Set(entries.map((entry) => entry.id))
           } catch (e) { /* best-effort */ }
           const trashStore = await readTrashStore()
           const hidden = new Set([...trashStore.items.map((item) => String(item.sessionId)), ...trashStore.purgedSessionIds.map(String)])
@@ -1157,11 +1181,11 @@ export function apply(ctx) {
           const results = []
           for (const sid of ids) {
             try { results.push({ sessionId: sid, ok: true, ...(await restoreOne(sid)) }) }
-            catch (e) { results.push({ sessionId: sid, ok: false, error: String((e && e.message) || e) }) }
+            catch (e) { results.push({ sessionId: sid, ok: false, code: e && e.code, error: String((e && e.message) || e) }) }
           }
           json(res, { ok: true, restored: results.filter((r) => r.ok).length, results })
         } catch (e) {
-          json(res, { ok: false, error: String((e && e.message) || e) }, 500)
+          json(res, { ok: false, code: e && e.code, error: String((e && e.message) || e) }, errorStatus(e))
         }
       },
     }))
@@ -1200,7 +1224,7 @@ export function apply(ctx) {
           }
           json(res, { ok: true, deleted: results.filter((r) => r.ok).length, results })
         } catch (e) {
-          json(res, { ok: false, error: String((e && e.message) || e) }, 500)
+          json(res, { ok: false, code: e && e.code, error: String((e && e.message) || e) }, errorStatus(e))
         }
       },
     }))
@@ -1245,11 +1269,19 @@ export function apply(ctx) {
         try {
           const items = await readTrash()
           const results = await Promise.all(items.map(async (item) => {
-            let exists = false
-            if (typeof item.originalPath === 'string') exists = await stat(item.originalPath).then(() => true).catch(() => false)
-            return { sessionId: item.sessionId, status: exists ? 'ok' : 'missing', originalPath: item.originalPath || null }
+            if (typeof item.originalPath !== 'string' || !item.originalPath) {
+              return { sessionId: item.sessionId, status: 'unverified', originalPath: null }
+            }
+            const exists = await stat(item.originalPath).then(() => true).catch(() => false)
+            return { sessionId: item.sessionId, status: exists ? 'ok' : 'missing', originalPath: item.originalPath }
           }))
-          json(res, { ok: true, healthy: results.filter((r) => r.status === 'ok').length, missing: results.filter((r) => r.status === 'missing').length, results })
+          json(res, {
+            ok: true,
+            healthy: results.filter((r) => r.status === 'ok').length,
+            missing: results.filter((r) => r.status === 'missing').length,
+            unverified: results.filter((r) => r.status === 'unverified').length,
+            results,
+          })
         } catch (e) {
           json(res, { ok: false, error: String((e && e.message) || e) }, errorStatus(e))
         }
@@ -1268,7 +1300,7 @@ export function apply(ctx) {
           metaCache.invalidate(sid)
           json(res, out)
         } catch (e) {
-          json(res, { ok: false, error: String((e && e.message) || e) }, 500)
+          json(res, { ok: false, code: e && e.code, error: String((e && e.message) || e) }, errorStatus(e))
         }
       },
     }))
@@ -1287,7 +1319,7 @@ export function apply(ctx) {
           titleIndex.remove([sid]).catch(() => {})
           json(res, out)
         } catch (e) {
-          json(res, { ok: false, error: String((e && e.message) || e) }, 500)
+          json(res, { ok: false, code: e && e.code, error: String((e && e.message) || e) }, errorStatus(e))
         }
       },
     }))
@@ -1307,7 +1339,7 @@ export function apply(ctx) {
           }
           json(res, { ok: true, purged: results.filter((r) => r.ok).length, results })
         } catch (e) {
-          json(res, { ok: false, error: String((e && e.message) || e) }, 500)
+          json(res, { ok: false, code: e && e.code, error: String((e && e.message) || e) }, errorStatus(e))
         }
       },
     }))
@@ -1357,7 +1389,7 @@ export function apply(ctx) {
           const url = new URL(req.url, 'http://localhost')
           const sid = url.searchParams.get('sessionId')
           requireSessionId(sid)
-          const r = await sp.readFrom(sid, 0)
+          const r = await persistence.readSession(sid, 0)
           if (!r || !r.meta) {
             const error = new Error('无法读取该会话的日志')
             error.status = 404
@@ -1424,7 +1456,7 @@ export function apply(ctx) {
           try { await reindexRegistry() } catch (e) { /* best-effort */ }
           json(res, { sessionId: sid, ...moved })
         } catch (e) {
-          json(res, { ok: false, error: String((e && e.message) || e) }, 500)
+          json(res, { ok: false, code: e && e.code, error: String((e && e.message) || e) }, errorStatus(e))
         }
       },
     }))