@wangxiaocuo/dsh-session-trash 0.6.3 → 0.6.4

package/lib/members.js

@@ -8,7 +8,7 @@
  */
 
 /**
- * @param {unknown} entry index entry (v1 or v2 shape).
+ * @param {any} entry index entry (v1 or v2 shape).
  * @returns {object|null} the parent member, or null when the entry has no directory data.
  */
 export function parentMember(entry) {
@@ -28,8 +28,8 @@ export function parentMember(entry) {
 }
 
 /**
- * @param {unknown} entry index entry (v1 or v2 shape).
- * @returns {object[]} every owned directory, parent first.
+ * @param {any} entry index entry (v1 or v2 shape).
+ * @returns {any[]} every owned directory, parent first.
  */
 export function memberList(entry) {
   if (entry !== null && typeof entry === 'object' && Array.isArray(entry.members) && entry.members.length > 0) {
@@ -40,7 +40,7 @@ export function memberList(entry) {
 }
 
 /**
- * @param {readonly object[]} members member list.
+ * @param {readonly any[]} members member list.
  * @returns {{ sizeBytes: number, fileCount: number }} summed measurable totals.
  */
 export function aggregateMetrics(members) {
@@ -57,7 +57,7 @@ export function aggregateMetrics(members) {
  * Shape-level validation shared by the durable index and object sidecars.
  * Path strictness belongs to the sidecar validator.
  *
- * @param {unknown} member candidate member.
+ * @param {any} member candidate member.
  * @returns {boolean} whether the member carries the required v2 identity.
  */
 export function isValidMemberShape(member) {
@@ -79,7 +79,7 @@ export function isValidMemberShape(member) {
 /**
  * Whether the v2 member list is internally consistent with its parent entry.
  *
- * @param {unknown} entry index entry carrying `members`.
+ * @param {any} entry index entry carrying `members`.
  * @returns {boolean} whether the list is acceptable.
  */
 export function isValidMemberList(entry) {

package/lib/state.js

@@ -10,6 +10,7 @@ const PROBE_CONCURRENCY = 3
  * stays an English diagnostic for logs and tooltips; the code is what the
  * Client localizes.
  */
+/** @type {[RegExp, string][]} */
 const LAST_ERROR_KINDS = [
   [/^The trash copy of this session is missing\./, 'TRASH_COPY_MISSING'],
   [/^The trash copy is missing these member sessions:/, 'TRASH_COPY_MISSING_MEMBERS'],
@@ -22,7 +23,7 @@ const LAST_ERROR_KINDS = [
 ]
 
 /**
- * @param {unknown} message raw `lastError` text.
+ * @param {any} message raw `lastError` text.
  * @returns {string | null} a stable failure family, or null when none was recorded.
  */
 export function lastErrorCode(message) {
@@ -55,9 +56,10 @@ async function directoryExists(directory) {
  *   config: { retentionDays: number, sweepIntervalHours: number, enableAutoCleanup: boolean },
  *   trashRootDisplay: string,
  *   nextSweepAt?: () => number | null,
- *   cleanup?: () => object,
+ *   cleanup?: () => any,
+ *   directoryExists?: (directory?: any) => Promise<boolean>,
  * }} deps state inputs.
- * @returns {{ snapshot: () => Promise<object>, describe: (entry: object) => Promise<object> }} the state service.
+ * @returns {{ snapshot: () => Promise<any>, describe: (entry: any) => Promise<any> }} the state service.
  */
 export function createStateService({
   store,
@@ -68,7 +70,7 @@ export function createStateService({
   directoryExists: probeDirectory = directoryExists,
 }) {
   /**
-   * @returns {object} cleanup diagnostics, or a neutral fallback.
+   * @returns {any} cleanup diagnostics, or a neutral fallback.
    */
   function cleanupDiagnostics() {
     if (typeof cleanup === 'function') {
@@ -92,10 +94,10 @@ export function createStateService({
   }
 
   /**
-   * @param {object} entry committed index entry.
+   * @param {any} entry committed index entry.
    * @param {Map<string, Promise<boolean>>} [probeCache] workspace probes already
    *   started for this snapshot, so entries sharing a cwd probe it once.
-   * @returns {Promise<object>} the wire entry.
+   * @returns {Promise<any>} the wire entry.
    */
   async function describeEntry(entry, probeCache = new Map()) {
     const cwd = typeof entry.originalCwd === 'string' && entry.originalCwd !== '' ? entry.originalCwd : null
@@ -138,12 +140,12 @@ export function createStateService({
 
   return {
     /**
-     * @param {object} entry committed index entry.
-     * @returns {Promise<object>} the wire entry.
+     * @param {any} entry committed index entry.
+     * @returns {Promise<any>} the wire entry.
      */
     describe: describeEntry,
     /**
-     * @returns {Promise<object>} the complete `/state` response body.
+     * @returns {Promise<any>} the complete `/state` response body.
      */
     async snapshot() {
       const probeCache = new Map()

package/lib/store.js

@@ -16,7 +16,7 @@ export const LOCK_REFRESH_MS = 60 * 1000
 
 /**
  * @param {number} [now] timestamp for the new index.
- * @returns {{ version: number, updatedAt: number, entries: never[] }} an empty index document.
+ * @returns {{ version: number, updatedAt: number, entries: any[] }} an empty index document.
  */
 export function emptyIndex(now = Date.now()) {
   return { version: INDEX_VERSION, updatedAt: now, entries: [] }
@@ -26,8 +26,8 @@ export function emptyIndex(now = Date.now()) {
  * Coerce one durable entry to the v2 shape. A v1 entry names a single
  * directory, which becomes the parent member of a one-member tree.
  *
- * @param {object} entry entry from either durable shape.
- * @returns {object} the v2 entry.
+ * @param {any} entry entry from either durable shape.
+ * @returns {any} the v2 entry.
  */
 function normalizeEntry(entry) {
   if (entry === null || typeof entry !== 'object') return entry
@@ -40,7 +40,7 @@ function normalizeEntry(entry) {
  * Validate the persisted index shape strictly enough that a truncated or
  * hand-edited file enters protection mode instead of silently vanishing.
  *
- * @param {unknown} value parsed JSON document.
+ * @param {any} value parsed JSON document.
  * @returns {boolean} whether the document is a supported index.
  */
 export function isValidIndex(value) {
@@ -141,7 +141,7 @@ export class TrashStore {
   }
 
   /**
-   * @returns {readonly object[]} the committed entries.
+   * @returns {readonly any[]} the committed entries.
    */
   entries() {
     return this.index.entries
@@ -149,7 +149,7 @@ export class TrashStore {
 
   /**
    * @param {string} sessionId session to look up.
-   * @returns {object | undefined} the index entry for this session.
+   * @returns {any | undefined} the index entry for this session.
    */
   findEntry(sessionId) {
     return this.index.entries.find((entry) => entry.sessionId === sessionId)
@@ -235,7 +235,7 @@ export class TrashStore {
 
   /**
    * @param {string} trashId object identity.
-   * @returns {Promise<object | undefined>} the parsed sidecar metadata, when present.
+   * @returns {Promise<any | undefined>} the parsed sidecar metadata, when present.
    */
   async readMeta(trashId) {
     try {
@@ -279,7 +279,7 @@ export class TrashStore {
    * Atomically write one object sidecar. Metadata is written before the session
    * directory moves, so a damaged index can rebuild from it later.
    *
-   * @param {object} entry index-shaped entry carrying `trashId`.
+   * @param {any} entry index-shaped entry carrying `trashId`.
    * @returns {Promise<void>} resolution once the sidecar is durable.
    */
   async writeMeta(entry) {
@@ -331,7 +331,7 @@ export class TrashStore {
   /**
    * Commit a complete entry list and refresh the in-memory projection.
    *
-   * @param {readonly object[]} entries complete new entry list.
+   * @param {readonly any[]} entries complete new entry list.
    * @returns {Promise<void>} resolution once committed.
    */
   async commit(entries) {
@@ -346,7 +346,7 @@ export class TrashStore {
 
   /**
    * @param {string} file index file to read.
-   * @returns {Promise<unknown>} parsed JSON.
+   * @returns {Promise<any>} parsed JSON.
    */
   async readJson(file) {
     return JSON.parse(await fs.readFile(file, 'utf8'))
@@ -392,8 +392,8 @@ export class TrashStore {
   }
 
   /**
-   * @param {{ version: number, updatedAt: number, entries: readonly object[] }} data parsed index document.
-   * @returns {{ version: number, updatedAt: number, entries: object[] }} the v2 document.
+   * @param {{ version: number, updatedAt: number, entries: readonly any[] }} data parsed index document.
+   * @returns {{ version: number, updatedAt: number, entries: any[] }} the v2 document.
    */
   normalizeIndex(data) {
     if (data.version !== INDEX_VERSION) this.needsUpgrade = true
@@ -408,8 +408,8 @@ export class TrashStore {
    * Atomically commit the index: write a temporary file, preserve the previous
    * commit as `.bak`, then rename over the live index.
    *
-   * @param {readonly object[]} entries the complete entry list to persist.
-   * @returns {Promise<{ version: number, updatedAt: number, entries: readonly object[] }>} the committed document.
+   * @param {readonly any[]} entries the complete entry list to persist.
+   * @returns {Promise<{ version: number, updatedAt: number, entries: readonly any[] }>} the committed document.
    */
   async writeIndex(entries) {
     const normalized = entries.map((entry) => normalizeEntry(entry))
@@ -582,7 +582,10 @@ export class TrashStore {
           await removePathWithRetry(this.lockPath, { recursive: false, force: true, attempts: 5, delayMs: 20 })
         } catch (removeError) {
           throw new TrashError('LOCKED', 'A stale trash lock could not be removed. Try again in a moment.', {
-            code: removeError instanceof Error && typeof removeError.code === 'string' ? removeError.code : null,
+            code:
+              removeError instanceof Error && typeof /** @type {any} */ (removeError).code === 'string'
+                ? /** @type {any} */ (removeError).code
+                : null,
           })
         }
       }

package/lib/trash-service.js

@@ -45,7 +45,7 @@ function errorText(message) {
 }
 
 /**
- * @param {unknown} error arbitrary failure.
+ * @param {any} error arbitrary failure.
  * @returns {string} a user-facing error message.
  */
 function messageOf(error) {
@@ -53,9 +53,9 @@ function messageOf(error) {
 }
 
 /**
- * @param {readonly object[]} entries current index entries.
- * @param {object} next replacement entry.
- * @returns {object[]} a new list with the entry replaced or appended.
+ * @param {readonly any[]} entries current index entries.
+ * @param {any} next replacement entry.
+ * @returns {any[]} a new list with the entry replaced or appended.
  */
 function upsertEntry(entries, next) {
   const copy = [...entries]
@@ -66,9 +66,9 @@ function upsertEntry(entries, next) {
 }
 
 /**
- * @param {readonly object[]} entries current index entries.
+ * @param {readonly any[]} entries current index entries.
  * @param {string} sessionId session to drop.
- * @returns {object[]} a new list without that session.
+ * @returns {any[]} a new list without that session.
  */
 function dropEntry(entries, sessionId) {
   return entries.filter((entry) => entry.sessionId !== sessionId)
@@ -81,23 +81,23 @@ function dropEntry(entries, sessionId) {
  * @param {{
  *   ctx: import('@deepseek-ai/cordis').Context,
  *   store: import('./store.js').TrashStore,
- *   eligibility: { evaluate: (sessionId: string) => Promise<object>, invalidate: (sessionId?: string) => void },
+ *   eligibility: { evaluate: (sessionId: string) => Promise<any>, invalidate: (sessionId?: string) => void },
  *   config: { retentionDays: number, sweepIntervalHours: number, enableAutoCleanup: boolean },
  *   logger: { info: Function, warn: Function, error: Function, debug: Function },
  *   paths: { root: string, display: string },
  * }} deps host services and resolved paths.
- * @returns {object} the operation surface.
+ * @returns {any} the operation surface.
  */
 export function createTrashService({ ctx, store, eligibility, config, logger, paths }) {
   /**
-   * @returns {object | undefined} the optional title service.
+   * @returns {any | undefined} the optional title service.
    */
   function sessionQuery() {
     return ctx.get('sessionQuery')
   }
 
   /**
-   * @returns {object | undefined} the optional workspace registry.
+   * @returns {any | undefined} the optional workspace registry.
    */
   function workspaceRegistry() {
     return ctx.get('workspaceRegistry')
@@ -105,7 +105,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
 
   /**
    * @param {string} sessionId session whose storage snapshot to read.
-   * @returns {Promise<object | undefined>} the persistence snapshot.
+   * @returns {Promise<any | undefined>} the persistence snapshot.
    */
   async function stat(sessionId) {
     return ctx.sessionPersistence.stat(sessionId)
@@ -113,7 +113,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
 
   /**
    * @param {string} sessionId session to check.
-   * @returns {Promise<boolean>} whether the session is live in this process.
+   * @returns {boolean} whether the session is live in this process.
    */
   function isLive(sessionId) {
     const liveSession = typeof ctx.sessions?.get === 'function' ? ctx.sessions.get(sessionId) : undefined
@@ -122,7 +122,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} snapshot persistence snapshot.
+   * @param {any} snapshot persistence snapshot.
    * @returns {string} the session header's cwd, or an empty string when absent.
    */
   function cwdOf(snapshot) {
@@ -134,7 +134,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * query service.
    *
    * @param {string} sessionId session whose title to read.
-   * @param {object} header persistence header.
+   * @param {any} header persistence header.
    * @returns {Promise<string>} the title, then cwd basename, then session id.
    */
   async function resolveTitle(sessionId, header) {
@@ -158,7 +158,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * Find the Workspace that currently accounts for a session.
    *
    * @param {string} sessionId session to locate.
-   * @returns {{ workspace: object, nextSessionId: string | null } | undefined} owning workspace and following sibling.
+   * @returns {{ workspace: any, nextSessionId: string | null } | undefined} owning workspace and following sibling.
    */
   function findOwningWorkspace(sessionId) {
     const registry = workspaceRegistry()
@@ -177,7 +177,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {unknown} target path to probe.
+   * @param {any} target path to probe.
    * @returns {Promise<string>} the entry kind, treating an absent path as missing.
    */
   async function kindOf(target) {
@@ -185,15 +185,15 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
-   * @returns {object[]} every owned directory, parent first.
+   * @param {any} entry index entry.
+   * @returns {any[]} every owned directory, parent first.
    */
   function membersOf(entry) {
     return memberList(entry)
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @param {number} index member position.
    * @returns {string} this member's directory inside the trash object.
    */
@@ -202,7 +202,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry trash index entry.
+   * @param {any} entry trash index entry.
    * @returns {Promise<void>} resolution once every member path stays inside `objects/`.
    */
   async function assertSafeObject(entry) {
@@ -226,8 +226,8 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * Probe every member directory in parallel: where the source copy and the
    * trash copy currently live.
    *
-   * @param {object} entry index entry.
-   * @returns {Promise<{ index: number, member: object, source: boolean, trash: boolean }[]>} member positions.
+   * @param {any} entry index entry.
+   * @returns {Promise<{ index: number, member: any, source: boolean, trash: boolean }[]>} member positions.
    */
   async function memberRows(entry) {
     const members = membersOf(entry)
@@ -251,8 +251,8 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * Probe only the original session directories of every member, in parallel.
    * Used by recovery after the trash copies were already proven present.
    *
-   * @param {object} entry index entry.
-   * @returns {Promise<{ index: number, member: object, source: boolean }[]>} member source positions.
+   * @param {any} entry index entry.
+   * @returns {Promise<{ index: number, member: any, source: boolean }[]>} member source positions.
    */
   async function sourceRows(entry) {
     const members = membersOf(entry)
@@ -266,7 +266,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @param {number} index member position.
    * @returns {Promise<void>} resolution once the member directory moved into its object.
    */
@@ -276,7 +276,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @param {number} index member position.
    * @returns {Promise<void>} resolution once the member directory moved back to its original location.
    */
@@ -286,7 +286,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @param {readonly { index: number }[]} rows members to move into the object.
    * @returns {Promise<{ index: number, error: unknown }[]>} per-member failures.
    */
@@ -303,7 +303,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @param {readonly { index: number }[]} rows members to move back to their original locations.
    * @returns {Promise<{ index: number, error: unknown }[]>} per-member failures.
    */
@@ -323,7 +323,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * Move every member directory into the trash object, children first and the
    * visible parent last so the sidebar keeps the row until the move settles.
    *
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @returns {Promise<void>} resolution once every member directory moved.
    */
   async function moveMembersToTrash(entry) {
@@ -337,7 +337,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @param {number} index member position.
    * @returns {Promise<void>} resolution once the unusable trash copy is gone.
    */
@@ -351,7 +351,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} member planned member whose restored copy failed verification.
+   * @param {any} member planned member whose restored copy failed verification.
    * @returns {Promise<void>} resolution once the unusable restored copy is gone.
    */
   async function removeRestoredMember(member) {
@@ -363,7 +363,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @returns {Promise<{ ok: boolean, index?: number, message?: string }>} whether every member landed with its recorded metrics.
    */
   async function verifyTrashedMembers(entry) {
@@ -386,7 +386,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @returns {Promise<{ ok: boolean, index?: number, message?: string }>} whether every member returned with its recorded metrics.
    */
   async function verifyRestoredMembers(entry) {
@@ -406,7 +406,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @returns {Promise<{ hidden: boolean, sessionId?: string }>} whether session storage stopped reporting every member.
    */
   async function waitForMembersHidden(entry) {
@@ -421,7 +421,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @returns {Promise<{ visible: boolean, sessionId?: string }>} whether session storage reports every member again.
    */
   async function waitForMembersVisible(entry) {
@@ -440,7 +440,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
 
   /**
    * @param {string} sessionId session to probe.
-   * @param {(snapshot: object | undefined) => boolean} predicate expected visibility state.
+   * @param {(snapshot: any | undefined) => boolean} predicate expected visibility state.
    * @returns {Promise<boolean>} whether the persistence backend agreed within the retry budget.
    */
   async function waitForVisibility(sessionId, predicate) {
@@ -479,8 +479,8 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    *
    * @param {string} sessionId restored session identity.
    * @param {string} title restored display title.
-   * @param {object | undefined} snapshot persistence snapshot.
-   * @returns {object} a `SessionSummary`.
+   * @param {any | undefined} snapshot persistence snapshot.
+   * @returns {any} a `SessionSummary`.
    */
   function buildSummary(sessionId, title, snapshot) {
     const header = snapshot?.header ?? {}
@@ -501,9 +501,9 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   /**
    * Record a failure summary on one entry and commit it, best effort.
    *
-   * @param {object} entry entry to annotate.
+   * @param {any} entry entry to annotate.
    * @param {string} message failure summary.
-   * @returns {Promise<object>} the annotated entry.
+   * @returns {Promise<any>} the annotated entry.
    */
   async function markFailure(entry, message) {
     const next = { ...entry, lastError: errorText(message) }
@@ -521,7 +521,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   /**
    * Restore the workspace accounting after a normal restore.
    *
-   * @param {object} entry restored index entry.
+   * @param {any} entry restored index entry.
    * @returns {Promise<{ reattached: boolean, warning?: string }>} reattachment outcome.
    */
   async function reattachWorkspace(entry) {
@@ -584,7 +584,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * Remove a session from every workspace that still accounts for it. Used by
    * orphan restore so the restored log appears under “Ungrouped”.
    *
-   * @param {object} entry restored index entry.
+   * @param {any} entry restored index entry.
    * @returns {Promise<{ detached: boolean, warning?: string }>} detach outcome.
    */
   async function detachWorkspace(entry) {
@@ -625,7 +625,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    *
    * @param {string} from current path.
    * @param {string} to previous path.
-   * @param {object | null | undefined} expected metrics for a cross-device copy.
+   * @param {any | null | undefined} expected metrics for a cross-device copy.
    * @returns {Promise<boolean>} whether the directory now lives at `to`.
    */
   async function moveBack(from, to, expected) {
@@ -669,7 +669,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * object or its original location. Never writes the index: the caller owns
    * the commit so startup recovery can accumulate one write.
    *
-   * @param {object} entry `trashing` index entry.
+   * @param {any} entry `trashing` index entry.
    * @returns {Promise<{ kind: 'ready' } | { kind: 'rolledBack' } | { kind: 'missing', entry: object }>} the settled position.
    */
   async function resolveTrashing(entry) {
@@ -725,7 +725,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * location, or back into the trash object when the restore cannot complete.
    * Never writes the index: the caller owns the commit.
    *
-   * @param {object} entry `restoring` index entry.
+   * @param {any} entry `restoring` index entry.
    * @returns {Promise<{ kind: 'ready' } | { kind: 'trashed', entry: object } | { kind: 'missing', entry: object }>} the settled position.
    */
   async function resolveRestoring(entry) {
@@ -752,6 +752,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
         row.source = false
       }
     }
+    /** @returns {{ kind: 'trashed', entry: any }} */
     const rolledBack = () => ({
       kind: 'trashed',
       entry: {
@@ -787,9 +788,9 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry settled `trashing` entry.
+   * @param {any} entry settled `trashing` entry.
    * @param {{ emitRemoval?: boolean }} [options] whether to announce the removal to clients.
-   * @returns {Promise<object>} the committed `trashed` entry.
+   * @returns {Promise<any>} the committed `trashed` entry.
    */
   async function commitTrashed(entry, options = {}) {
     const next = { ...entry, state: 'trashed', trashedAt: Date.now(), lastError: null }
@@ -811,9 +812,9 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * Finish a settled restore: wait for visibility, restore workspace
    * accounting, drop the entry, and optionally announce the session.
    *
-   * @param {object} entry settled `restoring` entry.
+   * @param {any} entry settled `restoring` entry.
    * @param {{ mode?: 'normal' | 'orphan', emitAdded?: boolean, reattach?: boolean }} [options] finishing policy.
-   * @returns {Promise<object>} the workspace attachment outcome.
+   * @returns {Promise<any>} the workspace attachment outcome.
    */
   async function completeRestore(entry, options = {}) {
     const mode = options.mode ?? 'normal'
@@ -847,7 +848,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
   }
 
   /**
-   * @param {object} entry index entry.
+   * @param {any} entry index entry.
    * @param {number} now current timestamp.
    * @returns {boolean} whether the retention window has elapsed.
    */
@@ -864,8 +865,8 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * recovery; successes are dropped and failures annotated in one final write.
    * The caller owns the trash lock.
    *
-   * @param {readonly object[]} targets `trashed` entries to purge.
-   * @returns {Promise<{ purged: number, failures: { entry: object, error: unknown, phase: string }[] }>} per-entry outcome.
+   * @param {readonly any[]} targets `trashed` entries to purge.
+   * @returns {Promise<{ purged: number, failures: { entry: any, error: unknown, phase: string }[] }>} per-entry outcome.
    */
   async function purgeManyInsideLock(targets) {
     const failures = []
@@ -954,7 +955,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * Permanently remove one object directory and its index entry. The caller
    * owns the trash lock.
    *
-   * @param {object} entry `trashed` index entry to purge.
+   * @param {any} entry `trashed` index entry to purge.
    * @returns {Promise<void>} resolution once the object and entry are gone.
    */
   async function purgeInsideLock(entry) {
@@ -967,7 +968,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * their plugin-owned remnants. No session file is deleted. The caller owns
    * the trash lock.
    *
-   * @param {readonly object[]} entries `missing` index entries to forget.
+   * @param {readonly any[]} entries `missing` index entries to forget.
    * @returns {Promise<number>} how many entries were removed from the index.
    */
   async function forgetManyInsideLock(entries) {
@@ -993,7 +994,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * Drop one `missing` entry from the index and remove its plugin-owned
    * remnants. No session file is deleted. The caller owns the trash lock.
    *
-   * @param {object} entry `missing` index entry to forget.
+   * @param {any} entry `missing` index entry to forget.
    * @returns {Promise<{ sessionId: string, title: string }>} the removed identity.
    */
   async function forgetInsideLock(entry) {
@@ -1006,7 +1007,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * `origin: 'subagent'` descendants moves together with them.
    *
    * @param {string} sessionId session to trash.
-   * @returns {Promise<object>} the committed `trashed` entry.
+   * @returns {Promise<any>} the committed `trashed` entry.
    */
   async function trash(sessionId) {
     const startedAt = Date.now()
@@ -1206,7 +1207,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    *
    * @param {string} sessionId session to restore.
    * @param {'normal' | 'orphan'} [mode] restore mode; orphan restores the log and detaches the Workspace.
-   * @returns {Promise<object>} the restore result.
+   * @returns {Promise<any>} the restore result.
    */
   async function restore(sessionId, mode = 'normal') {
     if (mode !== 'normal' && mode !== 'orphan') {
@@ -1471,7 +1472,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * object directory vanished. The caller must hold the trash lock.
    *
    * @param {number} now current timestamp.
-   * @returns {Promise<object>} reconcile summary.
+   * @returns {Promise<any>} reconcile summary.
    */
   async function reconcileInsideLock(now) {
     try {
@@ -1493,7 +1494,7 @@ export function createTrashService({ ctx, store, eligibility, config, logger, pa
    * entries. Used by startup recovery, the scheduled sweep, and manual cleanup.
    *
    * @param {{ allowPurge?: boolean, now?: number, reason?: string }} [options] sweep policy.
-   * @returns {Promise<object>} the sweep summary.
+   * @returns {Promise<any>} the sweep summary.
    */
   async function sweep({ allowPurge = true, now = Date.now(), reason = 'scheduled' } = {}) {
     return store.withLock(async () => {