dsh-sessions-manager 3.4.1 → 3.5.0

package/lib/index.js

@@ -1,6 +1,6 @@
 // src/index.js
-import { mkdir as mkdir3, realpath, rename as rename3, stat, unlink, writeFile as writeFile3 } from "node:fs/promises";
-import { basename, dirname, isAbsolute, join as join3 } from "node:path";
+import { mkdir as mkdir4, realpath, rename as rename4, stat, unlink, writeFile as writeFile4 } from "node:fs/promises";
+import { basename, dirname as dirname2, isAbsolute, join as join4 } from "node:path";
 import { readFileSync as readFileSync4 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 
@@ -500,12 +500,211 @@ function createSessionMetaCache(opts = {}) {
   };
 }
 
+// src/title-persist-index.js
+import { mkdir as mkdir3, readFile, rename as rename3, writeFile as writeFile3 } from "node:fs/promises";
+import { dirname, join as join3 } from "node:path";
+var TITLE_INDEX_SCHEMA_VERSION = 1;
+var MAX_ENTRIES = 2e4;
+function normalizeEntry(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const title = typeof raw.title === "string" ? raw.title : null;
+  const cwd = typeof raw.cwd === "string" ? raw.cwd : null;
+  const createdAt = typeof raw.createdAt === "number" ? raw.createdAt : null;
+  const fingerprint = typeof raw.fingerprint === "string" && raw.fingerprint ? raw.fingerprint : null;
+  const updatedAt = typeof raw.updatedAt === "number" ? raw.updatedAt : 0;
+  if (!fingerprint || !title && !cwd) return null;
+  return { title, cwd, createdAt, fingerprint, updatedAt };
+}
+function normalizeTitleIndex(raw) {
+  const entries = {};
+  if (raw && typeof raw === "object" && raw.entries && typeof raw.entries === "object") {
+    for (const [id, entry] of Object.entries(raw.entries)) {
+      if (typeof id !== "string" || !id || id.length > 200) continue;
+      const normalized = normalizeEntry(entry);
+      if (normalized) entries[id] = normalized;
+    }
+  }
+  return { schemaVersion: TITLE_INDEX_SCHEMA_VERSION, entries };
+}
+function mergeEntries(left, right) {
+  const merged = { ...left };
+  for (const [id, entry] of Object.entries(right)) merged[id] = entry;
+  const ids = Object.keys(merged);
+  if (ids.length > MAX_ENTRIES) {
+    ids.sort((a, b) => (merged[a].updatedAt || 0) - (merged[b].updatedAt || 0));
+    for (const id of ids.slice(0, ids.length - MAX_ENTRIES)) delete merged[id];
+  }
+  return merged;
+}
+function createTitleIndexStore({ dir, file }) {
+  let cache = null;
+  let chain = Promise.resolve();
+  const path = file || join3(dir, "title-index.json");
+  async function readRaw() {
+    try {
+      return normalizeTitleIndex(JSON.parse(await readFile(path, "utf8")));
+    } catch (e) {
+      return normalizeTitleIndex(null);
+    }
+  }
+  function enqueue(mutator) {
+    const operation = chain.then(async () => {
+      const store = cache || (cache = (await readRaw()).entries);
+      await mutator(store);
+      return store;
+    });
+    chain = operation.catch(() => {
+    });
+    return operation;
+  }
+  return {
+    // 只读：内存优先，未加载过才落盘一次。绝不抛错。
+    async entries() {
+      if (cache) return cache;
+      cache = (await readRaw()).entries;
+      return cache;
+    },
+    // 批量合并写入（原子替换）。失败静默：索引只是加速器，坏了下次重解码。
+    async merge(batch) {
+      const right = {};
+      for (const [id, entry] of Object.entries(batch || {})) {
+        const normalized = normalizeEntry(entry);
+        if (normalized) right[String(id)] = normalized;
+      }
+      if (!Object.keys(right).length) return false;
+      await enqueue(async (store) => {
+        const next = mergeEntries(store, right);
+        await mkdir3(dirname(path), { recursive: true });
+        const tmp = join3(dirname(path), `.title-index-${process.pid}-${Date.now()}.tmp`);
+        await writeFile3(tmp, JSON.stringify({ schemaVersion: TITLE_INDEX_SCHEMA_VERSION, entries: next }), { encoding: "utf8", mode: 384 });
+        await rename3(tmp, path);
+        cache = next;
+      });
+      return true;
+    },
+    async remove(ids) {
+      const wanted = new Set((ids || []).map(String));
+      if (!wanted.size) return false;
+      await enqueue(async (store) => {
+        let changed = false;
+        for (const id of wanted) {
+          if (id in store) {
+            delete store[id];
+            changed = true;
+          }
+        }
+        if (!changed) return;
+        await mkdir3(dirname(path), { recursive: true });
+        const tmp = join3(dirname(path), `.title-index-${process.pid}-${Date.now()}.tmp`);
+        await writeFile3(tmp, JSON.stringify({ schemaVersion: TITLE_INDEX_SCHEMA_VERSION, entries: store }), { encoding: "utf8", mode: 384 });
+        await rename3(tmp, path);
+      });
+      return true;
+    }
+  };
+}
+
+// src/compat/persistence.js
+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;
+}
+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
+  };
+}
+function normalizePersistenceList(values) {
+  if (!Array.isArray(values)) return [];
+  return values.map(normalizePersistenceEntry).filter(Boolean);
+}
+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("\u5F53\u524D DSH \u6301\u4E45\u5316\u670D\u52A1\u4E0D\u652F\u6301\u8BFB\u53D6\u4F1A\u8BDD");
+    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 \u8FD4\u56DE\u4E86\u65E0\u6548\u7684 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 };
+}
+
+// src/compat/capabilities.js
+function action(available, reason = null) {
+  return { available: !!available, reason: available ? null : reason };
+}
+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, "\u5F53\u524D DSH \u672A\u63D0\u4F9B\u53EF\u8BC6\u522B\u7684\u4F1A\u8BDD\u8BFB\u53D6\u63A5\u53E3"),
+      archive: action(!!(workspaceRegistry && typeof workspaceRegistry.archiveSession === "function"), "\u5F53\u524D DSH \u672A\u63D0\u4F9B\u5F52\u6863\u63A5\u53E3"),
+      trash: action(legacyRead || handleApi, "\u5F53\u524D DSH \u65E0\u6CD5\u8BFB\u53D6\u4F1A\u8BDD\uFF0C\u4E0D\u80FD\u5B89\u5168\u79FB\u5165\u56DE\u6536\u7AD9"),
+      restoreTrash: action(true),
+      purge: action(!handleApi && legacyLocate, "\u5F53\u524D DSH \u7248\u672C\u5C1A\u672A\u63D0\u4F9B\u7ECF\u8FC7\u9A8C\u8BC1\u7684\u5B89\u5168\u6C38\u4E45\u5220\u9664\u80FD\u529B"),
+      move: action(!handleApi && legacyRead && legacyLocate && workspaceInternals, "\u5F53\u524D DSH \u7248\u672C\u5C1A\u672A\u63D0\u4F9B\u7ECF\u8FC7\u9A8C\u8BC1\u7684\u8DE8\u5DE5\u4F5C\u533A\u8FC1\u79FB\u80FD\u529B")
+    }
+  };
+}
+function requireCapability(capabilities, name2) {
+  const value = capabilities && capabilities.actions && capabilities.actions[name2];
+  if (value && value.available) return;
+  const error = new Error(value && value.reason || `\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301 ${name2}`);
+  error.status = 409;
+  error.code = "DSM_CAPABILITY_UNAVAILABLE";
+  throw error;
+}
+
 // src/index.js
 var name = "dsh-sessions-manager";
 var inject = ["webServer", "workspaceRegistry", "sessionPersistence", "sessionQuery", "storageDomain"];
 var MAX_TITLE = 80;
-var TRASH_DIR = process.env.DSH_SESSIONS_MANAGER_TRASH_DIR || join3(homedir3(), ".dsh", "sessions-manager-trash");
-var TRASH_INDEX = join3(TRASH_DIR, "index.json");
+var TRASH_DIR = process.env.DSH_SESSIONS_MANAGER_TRASH_DIR || join4(homedir3(), ".dsh", "sessions-manager-trash");
+var TRASH_INDEX = join4(TRASH_DIR, "index.json");
 var TRASH_SCHEMA_VERSION = 2;
 var DEFAULT_TRASH_SETTINGS = Object.freeze({ retentionDays: 0 });
 var FETCH_TOOL_RE = /search|fetch|download|browse/i;
@@ -586,10 +785,46 @@ function foldTitle(events) {
 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 = /* @__PURE__ */ new Map();
   const metaCache = createSessionMetaCache();
+  const titleIndex = createTitleIndexStore({ dir: TRASH_DIR, file: join4(TRASH_DIR, "title-index.json") });
+  async function hydrateFromPersist(ids, statsById) {
+    const hits = /* @__PURE__ */ new Map();
+    if (!ids || !ids.length) return hits;
+    let store;
+    try {
+      store = await titleIndex.entries();
+    } catch (e) {
+      return hits;
+    }
+    for (const id of ids) {
+      const stat2 = statsById.get(id);
+      const entry = store && store[id];
+      if (!stat2 || !entry) continue;
+      const fp = fingerprintOf(stat2);
+      if (fp && entry.fingerprint === fp) {
+        hits.set(id, { title: entry.title, cwd: entry.cwd, createdAt: entry.createdAt });
+      }
+    }
+    return hits;
+  }
+  function persistDecoded(decoded, statsById) {
+    if (!decoded || !decoded.size) return;
+    const batch = {};
+    const now = Date.now();
+    for (const [id, meta] of decoded) {
+      const fp = fingerprintOf(statsById.get(id));
+      if (!fp) continue;
+      batch[id] = { title: meta.title, cwd: meta.cwd, createdAt: meta.createdAt, fingerprint: fp, updatedAt: now };
+    }
+    if (!Object.keys(batch).length) return;
+    titleIndex.merge(batch).catch(() => {
+    });
+  }
   function metaFromSnapshot(o) {
     let title = null, createdAt = null, cwd = null;
     if (o) {
@@ -676,7 +911,7 @@ 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;
@@ -686,28 +921,31 @@ function apply(ctx) {
       }
     }
     metaCache.set(key, statInfo, meta);
+    if (opts.collectDecoded && statInfo) opts.collectDecoded(key, meta);
     return buildItem(key, meta, usage, opts.exposeUsage);
   }
   async function collectUsage(preloadedHeaders) {
     const sizeById = /* @__PURE__ */ new Map();
     const mtimeById = /* @__PURE__ */ new Map();
-    let headers = null;
-    if (Array.isArray(preloadedHeaders)) headers = preloadedHeaders;
+    let entries = null;
+    if (Array.isArray(preloadedHeaders)) entries = preloadedHeaders;
     else {
       try {
-        headers = await sp.list();
+        entries = await persistence.listEntries();
       } catch (e) {
-        headers = [];
+        entries = [];
       }
     }
-    if (!Array.isArray(headers)) headers = [];
+    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;
@@ -746,10 +984,10 @@ function apply(ctx) {
     return (await readTrashStore()).items;
   }
   async function writeTrashStore(store) {
-    await mkdir3(TRASH_DIR, { recursive: true });
-    const tmp = join3(TRASH_DIR, `.index-${process.pid}-${Date.now()}.tmp`);
-    await writeFile3(tmp, JSON.stringify(normalizeTrashStore(store), null, 2), { encoding: "utf8", mode: 384 });
-    await rename3(tmp, TRASH_INDEX);
+    await mkdir4(TRASH_DIR, { recursive: true });
+    const tmp = join4(TRASH_DIR, `.index-${process.pid}-${Date.now()}.tmp`);
+    await writeFile4(tmp, JSON.stringify(normalizeTrashStore(store), null, 2), { encoding: "utf8", mode: 384 });
+    await rename4(tmp, TRASH_INDEX);
   }
   function mutateTrash(mutator) {
     const operation = trashMutation.then(async () => {
@@ -779,17 +1017,20 @@ 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);
@@ -810,7 +1051,7 @@ function apply(ctx) {
         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()
       };
@@ -838,6 +1079,7 @@ function apply(ctx) {
   }
   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);
@@ -848,14 +1090,19 @@ function apply(ctx) {
       }
       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((entry2) => entry2.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;
-      const targetOwnsSession = target && (basename(dirname(target)) === sid || basename(target).includes(sid));
+      if (!target) {
+        const error = new Error("\u65E0\u6CD5\u786E\u8BA4\u8BE5\u4F1A\u8BDD\u7684\u7269\u7406\u65E5\u5FD7\u4F4D\u7F6E\uFF0C\u5DF2\u505C\u6B62\u6C38\u4E45\u5220\u9664");
+        error.status = 409;
+        throw error;
+      }
+      const targetOwnsSession = target && (basename(dirname2(target)) === sid || basename(target).includes(sid));
       if (target && !targetOwnsSession) {
         const error = new Error("\u65E5\u5FD7\u8DEF\u5F84\u4E0E\u4F1A\u8BDD ID \u4E0D\u5339\u914D\uFF0C\u5DF2\u505C\u6B62\u6C38\u4E45\u5220\u9664");
         error.status = 409;
@@ -930,6 +1177,7 @@ function apply(ctx) {
     return (await readTrashStore()).settings;
   }
   async function cleanupExpiredTrash() {
+    if (!capabilities.actions.purge.available) return 0;
     const store = await readTrashStore();
     const days = store.settings.retentionDays;
     if (!days) return 0;
@@ -948,8 +1196,8 @@ function apply(ctx) {
   async function moveTargetWorkspace(rawPath) {
     if (typeof rawPath !== "string" || !rawPath.trim()) throw new Error("\u7F3A\u5C11\u76EE\u6807\u5DE5\u4F5C\u533A\u8DEF\u5F84");
     let p = String(rawPath).trim();
-    if (p.startsWith("~/")) p = join3(homedir3(), p.slice(2));
-    if (!isAbsolute(p)) p = join3(homedir3(), p);
+    if (p.startsWith("~/")) p = join4(homedir3(), p.slice(2));
+    if (!isAbsolute(p)) p = join4(homedir3(), p);
     let canonical = null;
     try {
       canonical = await realpath(p);
@@ -957,17 +1205,18 @@ function apply(ctx) {
       canonical = null;
     }
     if (canonical === null) {
-      await mkdir3(p, { recursive: true });
+      await mkdir4(p, { recursive: true });
       canonical = await realpath(p);
     }
     return { canonical, entity: await w.create(canonical, basename(canonical) || "workspace") };
   }
   async function moveOne(sid, targetPath) {
+    requireCapability(capabilities, "move");
     const activeId = getActiveSessionId(ctx);
     if (activeId != null && String(activeId) === String(sid)) {
       throw new Error("\u8BE5\u4F1A\u8BDD\u5F53\u524D\u5904\u4E8E\u6253\u5F00\u72B6\u6001\uFF0C\u8BF7\u5148\u5207\u6362\u5230\u522B\u7684\u4F1A\u8BDD\u518D\u79FB\u52A8\u3002");
     }
-    const r = await sp.readFrom(sid, 0);
+    const r = await persistence.readSession(sid, 0);
     if (!r || !r.meta) throw new Error("\u65E0\u6CD5\u8BFB\u53D6\u8BE5\u4F1A\u8BDD\u7684\u65E5\u5FD7");
     const meta = r.meta;
     const events = r.events;
@@ -995,13 +1244,13 @@ function apply(ctx) {
       if (!oldPath || !newPath || oldPath === newPath) return false;
       const backupPath = `${oldPath}.move-backup-${Date.now()}`;
       try {
-        await mkdir3(dirname(newPath), { recursive: true });
-        await rename3(oldPath, backupPath);
+        await mkdir4(dirname2(newPath), { recursive: true });
+        await rename4(oldPath, backupPath);
         await rewriteFrame0Cwd(backupPath, canonical);
-        await rename3(backupPath, newPath);
+        await rename4(backupPath, newPath);
       } catch (e) {
         try {
-          await rename3(backupPath, oldPath);
+          await rename4(backupPath, oldPath);
         } catch (_) {
         }
         if (e && e.code !== "ENOENT") throw e;
@@ -1026,7 +1275,7 @@ function apply(ctx) {
       return null;
     };
     if (isOpen) {
-      await relocateLog(meta, newHeader);
+      if (!await relocateLog(meta, newHeader)) throw new Error("\u79FB\u52A8\u5931\u8D25\uFF1A\u65E0\u6CD5\u786E\u8BA4\u4F1A\u8BDD\u65E5\u5FD7\u5DF2\u8FC1\u79FB\u5230\u76EE\u6807\u5DE5\u4F5C\u533A");
       try {
         const st = sp.states && sp.states.get && sp.states.get(sid);
         if (st && st.meta) st.meta = Object.assign({}, st.meta, { cwd: canonical });
@@ -1042,12 +1291,12 @@ function apply(ctx) {
         oldPath = null;
       }
       if (typeof sp.create !== "function" || typeof sp.append !== "function") {
-        await relocateLog(meta, newHeader);
+        if (!await relocateLog(meta, newHeader)) throw new Error("\u79FB\u52A8\u5931\u8D25\uFF1A\u65E0\u6CD5\u786E\u8BA4\u4F1A\u8BDD\u65E5\u5FD7\u5DF2\u8FC1\u79FB\u5230\u76EE\u6807\u5DE5\u4F5C\u533A");
       } else {
         const backupPath = oldPath ? `${oldPath}.move-backup-${Date.now()}` : null;
         if (backupPath) {
           try {
-            await rename3(oldPath, backupPath);
+            await rename4(oldPath, backupPath);
           } catch (e) {
             if (e && e.code !== "ENOENT") throw new Error("\u79FB\u52A8\u5931\u8D25\uFF1A\u65E0\u6CD5\u5907\u4EFD\u65E7\u7684\u4F1A\u8BDD\u65E5\u5FD7");
           }
@@ -1055,7 +1304,7 @@ function apply(ctx) {
         const restore = async () => {
           if (backupPath) {
             try {
-              await rename3(backupPath, oldPath);
+              await rename4(backupPath, oldPath);
             } catch (_) {
             }
           }
@@ -1063,7 +1312,7 @@ 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("\u79FB\u52A8\u540E\u6821\u9A8C\u5931\u8D25\uFF1A\u4F1A\u8BDD\u5DE5\u4F5C\u76EE\u5F55\u672A\u6B63\u786E\u66F4\u65B0");
           }
@@ -1076,7 +1325,7 @@ function apply(ctx) {
         } catch (e) {
           if (ALREADY_EXISTS_RE.test(String(e && e.message || e))) {
             await restore();
-            await relocateLog(meta, newHeader);
+            if (!await relocateLog(meta, newHeader)) throw new Error("\u79FB\u52A8\u5931\u8D25\uFF1A\u65E0\u6CD5\u786E\u8BA4\u4F1A\u8BDD\u65E5\u5FD7\u5DF2\u8FC1\u79FB\u5230\u76EE\u6807\u5DE5\u4F5C\u533A");
           } else {
             await restore();
             throw new Error("\u79FB\u52A8\u4F1A\u8BDD\u65E5\u5FD7\u5931\u8D25\uFF1A" + String(e && e.message || e));
@@ -1122,14 +1371,14 @@ function apply(ctx) {
   async function reindexRegistry() {
     const reg = w;
     if (!reg || typeof reg.replaceHeaderIndex !== "function") return false;
-    let headers = null;
+    let entries = null;
     try {
-      headers = await sp.list();
+      entries = await persistence.listEntries();
     } catch (e) {
-      headers = null;
+      entries = null;
     }
-    if (!headers || !Array.isArray(headers)) return false;
-    await reg.replaceHeaderIndex(headers);
+    if (!entries || !Array.isArray(entries)) return false;
+    await reg.replaceHeaderIndex(entries.map((entry) => entry.header));
     if (typeof reg.rebuildEntities === "function") reg.rebuildEntities();
     return true;
   }
@@ -1165,17 +1414,17 @@ function apply(ctx) {
     return out;
   }
   async function allSessionItems(opts = {}) {
-    let headers = [];
+    let entries = [];
     let headersOk = false;
     try {
-      headers = await sp.list();
-      headersOk = Array.isArray(headers);
-      if (!headersOk) headers = [];
+      entries = await persistence.listEntries();
+      headersOk = Array.isArray(entries);
+      if (!headersOk) entries = [];
     } catch (e) {
-      headers = [];
+      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) => {
@@ -1200,18 +1449,27 @@ function apply(ctx) {
     }
     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);
-    const snapshotById = await projectTitles(missing);
+    const persisted = await hydrateFromPersist(missing, statsById);
+    for (const [id, meta] of persisted) metaCache.set(id, statsById.get(id), meta);
+    const stillMissing = missing.filter((id) => !persisted.has(id));
+    const snapshotById = await projectTitles(stillMissing);
+    const decoded = /* @__PURE__ */ new Map();
+    const collectDecoded = (id, meta) => {
+      decoded.set(id, meta);
+    };
     const CHUNK = 6;
     for (let i = 0; i < visibleIds.length; i += CHUNK) {
       const res2 = await Promise.all(visibleIds.slice(i, i + CHUNK).map((id) => resolveOne(id, usage, {
         exposeUsage: !!(opts && opts.usage),
-        preloaded: snapshotById.has(id) ? snapshotById.get(id) : void 0
+        preloaded: snapshotById.has(id) ? snapshotById.get(id) : void 0,
+        collectDecoded
       })));
       for (const it of res2) items.push({ ...it, archived: currentArchived.has(it.sessionId) });
     }
+    persistDecoded(decoded, statsById);
     let starredSet = /* @__PURE__ */ new Set();
     try {
       starredSet = new Set((await stars.read()).starredSessionIds);
@@ -1257,14 +1515,14 @@ function apply(ctx) {
   }
   async function sidebarAuthority() {
     const ids = [];
-    let headers = [];
+    let entries = [];
     try {
-      headers = await sp.list();
+      entries = await persistence.listEntries();
     } catch (e) {
-      headers = [];
+      entries = [];
     }
-    if (!Array.isArray(headers)) headers = [];
-    for (const header of headers) ids.push(String(header.id));
+    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) => {
@@ -1275,20 +1533,29 @@ function apply(ctx) {
     }
     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);
-      const snapshotById = await projectTitles(missing);
+      const persisted = await hydrateFromPersist(missing, statsById);
+      for (const [id, meta] of persisted) metaCache.set(id, statsById.get(id), meta);
+      const rest = missing.filter((id) => !persisted.has(id));
+      const snapshotById = await projectTitles(rest);
+      const decoded = /* @__PURE__ */ new Map();
+      const collectDecoded = (id, meta) => {
+        decoded.set(id, meta);
+      };
       for (const id of ids) {
-        let meta = cached.get(id) || null;
+        let meta = cached.get(id) || persisted.get(id) || null;
         if (!meta) {
           const snapshot = snapshotById.has(id) ? snapshotById.get(id) : typeof sq.readTitleSnapshot === "function" ? await sq.readTitleSnapshot(id).catch(() => null) : null;
           const next = metaFromSnapshot(snapshot);
           metaCache.set(id, statsById.get(id), next);
+          if (statsById.get(id)) collectDecoded(id, next);
           meta = next;
         }
         if (meta && meta.title) authorityTitleCache.set(id, String(meta.title));
       }
+      persistDecoded(decoded, statsById);
     }
     return {
       titles: Object.fromEntries(authorityTitleCache),
@@ -1309,14 +1576,14 @@ function apply(ctx) {
         events = [];
       }
     } else {
-      const r = await sp.readFrom(sid, 0);
+      const r = await persistence.readSession(sid, 0);
       if (!r || !r.meta) throw new Error("\u627E\u4E0D\u5230\u8BE5\u4F1A\u8BDD\u7684\u8BB0\u5F55\uFF08\u4F1A\u8BDD\u4E0D\u5B58\u5728\uFF09");
       meta = r.meta;
       events = Array.isArray(r.events) ? r.events : [];
     }
     let sizeBytes = null;
     try {
-      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;
@@ -1401,7 +1668,8 @@ function apply(ctx) {
     const subagentSet = /* @__PURE__ */ 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);
@@ -1438,6 +1706,11 @@ function apply(ctx) {
         authorityTitleCache.set(String(session.id), event.data.title);
       }
     }));
+    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",
@@ -1448,8 +1721,8 @@ function apply(ctx) {
           let materialized = /* @__PURE__ */ 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) {
           }
           const trashStore = await readTrashStore();
@@ -1500,12 +1773,12 @@ function apply(ctx) {
             try {
               results.push({ sessionId: sid, ok: true, ...await restoreOne(sid) });
             } catch (e) {
-              results.push({ sessionId: sid, ok: false, error: String(e && e.message || 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));
         }
       }
     }));
@@ -1544,7 +1817,7 @@ 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));
         }
       }
     }));
@@ -1583,11 +1856,19 @@ 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));
         }
@@ -1605,7 +1886,7 @@ 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));
         }
       }
     }));
@@ -1619,9 +1900,11 @@ function apply(ctx) {
           if (!sid) return json(res, { ok: false, error: "missing sessionId" }, 400);
           const out = await purgeFromTrash(sid);
           metaCache.invalidate(sid);
+          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));
         }
       }
     }));
@@ -1638,13 +1921,15 @@ function apply(ctx) {
             try {
               results.push({ sessionId: sid, ok: true, ...await purgeFromTrash(sid) });
               metaCache.invalidate(sid);
+              titleIndex.remove([sid]).catch(() => {
+              });
             } catch (e) {
               results.push({ sessionId: sid, ok: false, error: String(e && e.message || e) });
             }
           }
           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));
         }
       }
     }));
@@ -1686,7 +1971,7 @@ 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("\u65E0\u6CD5\u8BFB\u53D6\u8BE5\u4F1A\u8BDD\u7684\u65E5\u5FD7");
             error.status = 404;
@@ -1744,7 +2029,7 @@ function apply(ctx) {
           }
           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));
         }
       }
     }));
@@ -1819,8 +2104,16 @@ function apply(ctx) {
           const patch = {};
           if (body && Object.prototype.hasOwnProperty.call(body, "inactiveDays")) patch.inactiveDays = body.inactiveDays;
           if (body && Object.prototype.hasOwnProperty.call(body, "skipStarred")) patch.skipStarred = body.skipStarred;
-          const settings = Object.keys(patch).length ? await autoArchive.update(patch) : (await autoArchive.read()).settings;
-          const sweep = await autoArchiveSweep();
+          const isPatch = Object.keys(patch).length > 0;
+          const settings = isPatch ? await autoArchive.update(patch) : (await autoArchive.read()).settings;
+          let sweep;
+          if (isPatch) {
+            sweep = await autoArchiveSweep();
+          } else {
+            void autoArchiveSweep().catch(() => {
+            });
+            sweep = { triggered: true };
+          }
           const store = await autoArchive.read();
           json(res, {
             ok: true,