@xrn1997/dsh-session-delete 0.2.1 → 0.3.0

package/lib/types/verbs/errors.d.ts

@@ -1,11 +1,14 @@
-/** 五个码（设计稿 §6 的表）。**唯一定义处**：`remote/map-error.ts` 从这份数组反推它的 `Code`，
- *  免得"加了一个码只在一边加"让两张表各自漂移（漂移的后果是那个码静默降级成 `io`）。 */
+/** 五个码 / 三个路由自检码的**家都在 `shared/wire.ts`**（ADR-0003）：浏览器半也要认它们（比如
+ *  `not-found` 在界面上是中性提示而不是失败），所以它们属于两半共同的契约，不属于 Node 半。
+ *  这里只转出旧名，免得调用点全改一遍。 */
+import { type RouteCode, type VerbCode } from '../shared/wire.js';
 export declare const VERB_CODES: readonly ["live", "not-found", "trash-empty", "project-missing", "io"];
-export type VerbCode = (typeof VERB_CODES)[number];
-/** 路由层的自检（不是五个动词码之一）：**请求本身不对**——方法、路径、body 形状。
- *  它上的是 HTTP 状态那条口（404/405），信封里也带着它，好让只看信封的调用方拿到同一句原文。 */
 export declare const ROUTE_CODES: readonly ["bad-method", "not-found-route", "bad-request"];
-export type RouteCode = (typeof ROUTE_CODES)[number];
+export type { RouteCode, VerbCode };
+/** `error.code` 是不是本仓的动词码（`sessiondelete/<码>`）。**唯一判据**：`journalFailure` 与永久删除
+ *  执行器要"已经是动词码就原样抛"时都问这一句。同文件的 `withRollbackFailures` 还要码的后缀，所以它
+ *  就地 `slice` 一次——前缀仍只住 `VERB_CODE_PREFIX` 这一处，别在调用点另写一份字面量。 */
+export declare function isVerbCodeError(error: unknown): boolean;
 /** 一次失败的**结构**：码、上屏原文、可选 cause（`map-error` 沿 cause 链认宿主类型化错误）、
  *  可选的结构化附带物（对齐官方 `rpcErrorSchema` 的第三件 `details`）。 */
 export interface VerbError extends Error {
@@ -18,3 +21,11 @@ export declare function verbError(code: VerbCode, message: string, cause?: unkno
 export declare function routeError(code: RouteCode, httpStatus: number, message: string): VerbError & {
     httpStatus: number;
 };
+/** 一条回滚步骤失败的**标签句**：label 说的是"这一步在退什么"，原文带出**那一步抛的东西**
+ *  （`Error` 取 message，其余一律 `String()`；对象带 `message` 的差异归 `map-error.messageOf` 管）。
+ *  调用方不许另抄这份格式——那样 details 里的句子会随各处 catch 变形，界面上就变成"同一个失败三个说法"。 */
+export declare function rollbackReason(label: string, error: unknown): string;
+/** 原错误保留，回滚失败作为 `details.rollbackFailures` 上线；码仍按原错误的动词码，
+ *  没有可继承的就落 io。**内层的回滚失败要并进来**：一个成员自己退失败、兄弟也退失败时，
+ *  两份失败都得在 details 里，消息也不能出现第二个「回滚未完成」。 */
+export declare function withRollbackFailures(error: unknown, failures: readonly string[]): VerbError;

package/lib/types/verbs/member-journal.d.ts

@@ -0,0 +1,27 @@
+export interface JournalStep {
+    /** 这一步在做什么。失败原文按「`<label>：<原错误>`」拼——与迁移前那 22 处 `rollbackReason` 的措辞同形。 */
+    readonly label: string;
+    /** 做这一步。抛什么都由 journal 折成 `sessiondelete/io`（除非它自己已经是一个动词码）。 */
+    run(): Promise<void>;
+    /** 反向动作。**`run` 成功之后**才会被登记；返回**这一步自己**没能退干净的原因列表（空 = 完全退回）。 */
+    undo?(): Promise<readonly string[]>;
+    /** 这一步**自己**失败时也跑 `undo`：给"可能已经半做完"的非原子步骤用（取消归档是唯一的例子）。 */
+    readonly undoOnFailure?: boolean;
+}
+export interface Journal {
+    /** 按顺序跑完。中途失败 ⇒ 已做成的按相反顺序退回，然后把原错误（带 `rollbackFailures`）抛出去。 */
+    run(): Promise<void>;
+    /** 把**已经做成**的步骤按相反顺序退回去（整组回滚用：组里后面那个成员搬不动时叫这一句）。 */
+    undo(): Promise<readonly string[]>;
+}
+/** 已经把某个前缀做成了的 journal——`undo()` 就退那一个前缀。 */
+export declare function createJournal(steps: readonly JournalStep[]): Journal;
+/** 跑一步反向动作并把它自己的失败收成一条原因（不抛：这些失败由调用方汇总成 `rollbackFailures`）。 */
+export declare function attempt(label: string, run: () => Promise<unknown>): Promise<readonly string[]>;
+/**
+ * **组级回滚**：把已经做成的成员按相反顺序退回；某一步退不干净时把失败并进原错误的
+ * `details.rollbackFailures`，绝不让原错误独走（2026-10-19 `f2a7757`；那些失败句子的合并与措辞住
+ * `src/verbs/errors.ts`，这里只是唯一的调用方）。删除与恢复两个按组走的动词共用这一处，
+ * "相反顺序 + 失败合并"不再各写一遍。
+ */
+export declare function rollbackJournals(journals: readonly Journal[], error: unknown): Promise<never>;

package/lib/types/verbs/member-presence.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 成员离场 / 归位的通告协议：摘活体、三态判断、成对事件只在这里做。
+ *
+ * 为什么要有它：delete（成功与回滚）/ restore 回滚 / purge（两个分支）/ orphan-clean
+ * 六处调用曾经各写一遍
+ * `evictLive → !== 'unknown' → announceRemoved`；删除回滚还要自己拼
+ * `movedBack && workspaceBack` 才发 `announceRestored`。
+ * 这条协议说错一次就是客户端留着假行、或删掉真行，所以只留一个家。
+ *
+ * 边界：
+ * - 批量恢复的 `announceRestoredBatch` 不进来：一次预取、一批一次通告归 `verbs/batch.ts`（ADR-0002）。
+ * - 不读 journal 的失败串：调用方交事实（目录 / 账本是否回去），真值表住这里。
+ * - 本模块用到的三条（`evictLive` / `announceRemoved` / `announceRestored`）按契约不抛（evictLive 三态、
+ *   announce* 内部吞异常），这里不再叠 catch。
+ */
+import type { HostPresencePort } from '../ports/host-port.js';
+/** 本模块实际用到的三条宿主能力。取窄面而不是整个 `HostPresencePort`：那条协议里还有批量通告与
+ *  摘要预取，它们各有自己的家（`verbs/batch.ts`），这里不该因为共用同一颗 adapter 就声明依赖。 */
+export type MemberPresenceHost = Pick<HostPresencePort, 'evictLive' | 'announceRemoved' | 'announceRestored'>;
+export interface MemberBackFacts {
+    /** 目录搬回原处了吗。 */
+    readonly diskBack: boolean;
+    /** 账本挂回去了吗（本来没有账目时算 true）。 */
+    readonly workspaceBack: boolean;
+}
+export interface MemberPresence {
+    /** 成员已经不在宿主可见列表：摘活体；三态不是 unknown 时发 removed。
+     *  `backInTrash: false` 表示目录没退回回收站（恢复回滚失败），此时什么都不做。 */
+    memberGone(sessionId: string, facts?: {
+        readonly backInTrash?: boolean;
+    }): Promise<void>;
+    /** 成员已经回到原来的可见状态：目录与账本两件写都回去才发 added。 */
+    memberBack(sessionId: string, facts: MemberBackFacts): Promise<void>;
+}
+export declare function createMemberPresence(host: MemberPresenceHost): MemberPresence;

package/lib/types/verbs/orphan-subagents.d.ts

@@ -0,0 +1,58 @@
+import { type SessionIdentity } from '../ports/host-port.js';
+import type { OrphanCleanStatsWire, OrphanReportWire } from '../shared/wire.js';
+import type { CoreDeps } from '../deps.js';
+/** 组里一个人的盘上身份（字节是**扫描那一刻**量的，清理时按目录重量一次，不拿这份快照冒充准数）。 */
+export interface OrphanMember {
+    readonly sessionId: string;
+    readonly projectDir: string;
+    readonly bytes: number;
+}
+/** 一组无主子会话：根是那"父没了"的 subagent，`members` 是它的**传递闭包**（含根自己）。 */
+export interface OrphanGroup {
+    readonly root: OrphanMember;
+    readonly parentSessionId: string;
+    readonly members: readonly OrphanMember[];
+}
+/** {@link orphanGroupsOf} 的中间形状：还没量字节的那一组（纯函数不碰盘）。 */
+interface RawGroup {
+    readonly root: SessionIdentity;
+    readonly parentSessionId: string;
+    readonly members: readonly SessionIdentity[];
+}
+/**
+ * 无主子会话 = `origin:"subagent"`、父**既不在当前语料（live ∪ persisted）也不在回收站清册里**的会话。
+ *
+ * 为什么清册里的父不算孤儿：那种是 **stranded**——父还在回收站里等着，孩子本该跟着父一起恢复或一起
+ * 彻底删除（组语义见 `src/trash/groups.ts`），把它的根当孤儿删掉就是**替用户做了一个没人点过的决定**。孤儿只
+ * 有一种来路：父被彻底删掉了（或被手工从盘上清掉了），清册里再也没有这一行。
+ *
+ * 根按**传递闭包**收全部后代（与 `HostCorpusPort.subagentMembersOf` 同一口径：孩子与孙代都算，深度不设上限），
+ * 同一条记录只归一组（`claimed`）——数据里真出现环时结果是"少数一条"，不是把一个会话删两遍。
+ * 归堆与去重**两边都去 `session-` 前缀**：同一个父在两代宿主里写法不同（见 `bareSessionId` 的来历）。
+ */
+export declare function orphanGroupsOf(corpus: readonly SessionIdentity[], trashSessionIds: readonly string[]): RawGroup[];
+/** 纯读：调用方应先走一次 `/list` 对账（面板的 refresh 就是这样）；本函数不写清单。
+ *  写动作 `orphan-clean` 会自己先 reconcile，避免拿一份过期清册判"父没了"。
+ *
+ *  `listSessions()` 回 `{ available: false }` 时**必须抛**：那是宿主的会话语料服务没挂，不是"这个家没有孤儿"。
+ *  拿缺席当空语料 ⇒ 报告说"零条孤儿"、界面上一句"没有要清理的"，而盘上真有几百 MB——那是假话，
+ *  所以这里按 `io` 响亮失败（AGENTS.md：`available: false` 意味着服务缺席，扫描方不许冒充读数）。 */
+export declare function loadOrphanGroups(deps: CoreDeps): Promise<readonly OrphanGroup[]>;
+/** 把一组组收成那份报告：根清单 + 闭包总数/总字节 + 失踪父的**去重计数** + 按项目目录的分摊。
+ *  `groups` 按字节从多到少排（界面上"哪家还剩得最多"要看第一行）。 */
+export declare function reportOrphans(groups: readonly OrphanGroup[]): OrphanReportWire;
+/**
+ * 清一组：`planOrphanRemoval`（只读计划，整组 live 准入在一切写之前）→ `executeRemoval`（只写）。
+ * 量目录、摘归档集与账本、删目录与成员通告的顺序和失败形状都住 `verbs/permanent-removal.ts`；
+ * 这里只把这一组接上去，别在这再长出一段手写步骤（purge 走的是同一条路）。
+ *
+ * 顺序与删除那一半是**对偶**的，但不是照抄：
+ * - 删除那一半不再用归档藏会话（ADR-0008）：它摘账本、搬目录，最后才摘活体。这里目录是**删掉**
+ *   不是搬走，藏不藏都不影响可见性 ⇒ 归档集反而**在写之前整批摘掉**：失败时目录还在，下一次还能重试，
+ *   不会留下"会话没了但还在归档集里挂着"的幽灵 id。
+ * - `unarchive` 对未归档的会话是官方幂等 no-op（`registry.unarchiveSession`），所以这里不需要那次
+ *   `wasArchived` 读——这里没有"还原到删除前"的义务。
+ * - 摘账本只在账本真记着它时做（`workspaceOf` 未命中 = 本来就是「未分组」，不是故障）。
+ */
+export declare function cleanOrphanGroup(deps: CoreDeps, group: OrphanGroup): Promise<OrphanCleanStatsWire>;
+export {};

package/lib/types/verbs/permanent-removal.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 永久删除的**测量、计划与执行**：一次永久删除（`/list` 的只读读数或 purge / orphan-clean 的删除计划）
+ * 之前要记下的事实（目录、字节、账本归属），以及拿到计划之后按它动盘的那一步。计划函数**只读**——
+ * 写不写由执行器决定，但活体准入在这里就做掉，调用方拿到计划才允许动盘。
+ */
+import { type TrashEntry } from '../trash/entry.js';
+import type { TrashGroupView } from '../trash/groups.js';
+import type { CoreDeps } from '../deps.js';
+export interface MeasuredMemberDir {
+    readonly dir: string;
+    readonly bytes: number;
+}
+/** 一条成员被删之前要记下的三件：目录、字节、账本归属（缺席 = 未分组）。`/list` 的只读计划与
+ *  purge / orphan-clean 的删除计划共用这一份形状。 */
+export interface PlannedMemberRemoval {
+    readonly sessionId: string;
+    readonly dir: string;
+    readonly bytes: number;
+    readonly workspaceId?: string;
+}
+/** 成员的盘上目录与字节（扫描、清单装配与 purge 共用这一条路径/存在性/度量口径；
+ *  目录缺席回 `undefined`，不拿一份"记录还在、盘上已经没了"的旧读数冒充盘上残留）。 */
+export declare function measureMemberDir(deps: CoreDeps, member: {
+    readonly sessionId: string;
+    readonly projectDir: string;
+}): Promise<MeasuredMemberDir | undefined>;
+/** 把一组成员折成"删之前要记下的计划"；目录不在的成员跳过（记录与盘不一致是那条成员自己的事）。
+ *  `purge` 的盘上后代、`orphan-clean` 的整组与 `/list` 的盘上残留都走这一处，别再各写一遍
+ *  measure + workspaceOf。 */
+export declare function planMemberRemovals(deps: CoreDeps, members: readonly {
+    readonly sessionId: string;
+    readonly projectDir: string;
+}[]): Promise<PlannedMemberRemoval[]>;
+/** 回收站里的一条要删的行：目录、在不在、实测字节（缺席 = 0）。purge 与 `/list` 都由它量。 */
+export interface PlannedTrashRow {
+    readonly entry: TrashEntry;
+    readonly dir: string;
+    readonly present: boolean;
+    readonly bytes: number;
+}
+/** `/list` 的一行（一组）所需的只读数：`releaseBytes` 是这一组**实测**会释放的字节。 */
+export interface VisibleTrashGroup extends TrashGroupView {
+    readonly trash: readonly PlannedTrashRow[];
+    readonly members: readonly PlannedMemberRemoval[];
+    readonly releaseBytes: number;
+    readonly subagentBytes: number;
+    readonly strandedBytes: number;
+    readonly strandedCount: number;
+}
+/**
+ * `/list` 的只读计划：一行 = 一组。释放量与 purge 用同一条口径——回收站目录与成员目录**现测**，
+ * 不用清册里记的 `sizeBytes`（那是删除那一刻的事实，盘上早就变了）。
+ *
+ * 盘上后代经 `selectStrandedMembers` 选出（排除全部清册 id、bare id 全局只算一次）；目录不在的成员
+ * 不进 `members`（与 `planMemberRemovals` 同口径）。
+ */
+export declare function planVisibleTrash(deps: CoreDeps, rows: readonly TrashEntry[], groups: readonly TrashGroupView[]): Promise<VisibleTrashGroup[]>;
+/** 一次永久删除的只读计划：哪些目录要删、各自实测多少字节、哪些会话要先摘归档集。
+ *  `kind` 同时决定执行器在**删目录阶段**失败时交不交部分回执：`trash`（purge）不带、`orphan`
+ *  （orphan-clean）带 `{removed, freedBytes, failedSessionId}`——回执与 `kind` 在生产里 1:1，
+ *  所以由 `kind` 派生，不另存一份会跟它漂移的字段；更早的 `unarchive` / `detach` 一步不套回执。 */
+export interface RemovalPlan {
+    readonly kind: 'trash' | 'orphan';
+    readonly trash: readonly PlannedTrashRow[];
+    readonly members: readonly PlannedMemberRemoval[];
+    readonly unarchive: readonly string[];
+    readonly bytes: number;
+}
+/**
+ * purge 的删除计划：`targets` 由调用方按组语义（`trash/groups.ts`）选好，这里只量、只筛、只查活体。
+ *
+ * - `trash` 按 targets 原序逐个实测（目录缺席的行 `present:false` / 0 字节，但清册行仍要摘）。
+ * - 盘上后代经 `selectStrandedMembers` 选出（一次问全部 targets、排除全部清册 id、bare id 全局只计划一次）。
+ * - `members` 只收盘上还有目录的成员（目录缺席没有可删的字节）；`unarchive` = targets + 这些成员：
+ *   只摘这一次真要碰的 id。
+ * - `admission:'live'` 在量目录与任何写之前逐个查 targets 与**全部枚举到的**盘上后代；
+ *   任一在跑就整条拒绝，零副作用。
+ * - `sessionQuery` 缺席时端口回 `{ available: false }` ⇒ members 为空、不抛（盘上残留留给 `GET /orphans` 兜底）。
+ */
+export declare function planTrashRemoval(deps: CoreDeps, rows: readonly TrashEntry[], targets: readonly TrashEntry[], options: {
+    readonly admission: 'none' | 'live';
+}): Promise<RemovalPlan>;
+/**
+ * orphan-clean 的删除计划：成员是调用方扫出来的传递闭包（`orphanGroupsOf`）。
+ *
+ * - `members` 只收盘上还有目录的成员（目录缺席没有可删的字节），`bytes` 只算这些实测值。
+ * - `unarchive` 覆盖**全部传入成员**（含目录缺席）：orphan-clean 在删目录之前整批摘归档集，
+ *   目录缺席的 id 也可能还挂在归档集里；重试时不会再长出一条幽灵 id。
+ * - live 准入覆盖**全部传入成员**（含目录缺席）：它们都在这一组的可见面里，任一在跑就整组拒绝。
+ * - 回执由 `kind:'orphan'` 派生：删目录阶段失败时执行器要交回 `{removed, freedBytes, failedSessionId}`。
+ */
+export declare function planOrphanRemoval(deps: CoreDeps, members: readonly {
+    readonly sessionId: string;
+    readonly projectDir: string;
+}[]): Promise<RemovalPlan>;
+/**
+ * 按计划执行一次永久删除：只写、不再量、不再判活体（计划就是执行前的闸）。
+ *
+ * 顺序（与迁移前的 purge / orphan-clean 一致）：整批摘归档集 → 摘有账本的成员的账本 → 逐条回收站行
+ * （在才删目录 → 摘清册行 → 通告成员离场）→ 逐条盘上成员（删目录 → 通告成员离场）。目录删掉就没有
+ * "退回去"这回事，中途失败**不回滚**；已经删掉的由下面的计数器如实交回。
+ *
+ * 失败形状沿用调用方原来的措辞与结构：
+ * - `kind:'orphan'`（orphan-clean）⇒ `io` + `{removed, freedBytes, failedSessionId}`，不伪装成整组没动；
+ * - `kind:'trash'`（purge）⇒ 同一个标签、不带 details。
+ * - orphan-clean 的 unarchive / detach 在旧实现里不包装，这里原样抛出（不改变现有错误形状）。
+ *
+ * 通告只经 `member-presence`（摘活体三态 + `api-session/removed`），不在这里另写一份。
+ */
+export declare function executeRemoval(deps: CoreDeps, plan: RemovalPlan): Promise<{
+    removed: number;
+    freedBytes: number;
+}>;

package/lib/types/verbs/purge-trash.d.ts

@@ -1,6 +1,22 @@
-import { type TrashEntry } from '../trash/entry.js';
-import type { DeleteDeps } from './delete-session.js';
-export declare function purgeTrash(deps: DeleteDeps): (entryId?: string, snapshot?: TrashEntry[]) => Promise<{
+import type { TrashEntry } from '../trash/entry.js';
+import type { CoreDeps } from '../deps.js';
+/**
+ * 彻底删除：从回收站里**真的**抹掉一条（或整组、或整站），并连带那些"还留在盘上、没被带走"的后代。
+ *
+ * 与另外两个动词的关系（ADR-0002）：它的 interface 只有"一个条目 id（或缺席 = 清空）"，
+ * 批量的快照与"已被同批前一条带走"的判据不在这里（归 `verbs/batch.ts`）。
+ *
+ * **这条动词只做两件事：选目标、拿计划交给执行器**。量目录、筛盘上后代、活体准入与"先退归档集、
+ * 再摘账本、最后删目录"的顺序都住 `verbs/permanent-removal.ts`——计划只读，执行器只写，计划就是
+ * 执行前的闸（别在这里再长出一段手写步骤）。
+ *
+ * **这条动词不做回滚**：目录删掉就没有"退回去"这回事（2026-10-19 `f2a7757`：删到一半失败时已删目录不回滚；
+ * 带部分计数的 `details` 回执只属于 `orphan-clean`，purge 的 `removed` / `freedBytes` 仍只在成功回执里给）。
+ * 对应地，`kind:'trash'` 的计划失败时执行器只抛那一步的 `io` 与原文、不带 details。
+ */
+export declare function purgeTrash(deps: CoreDeps): (entryId?: string, 
+/** **只读**清册快照：批量层已经读过一次就递下来（ADR-0002）；收缩归批量层，动词不碰它。 */
+snapshot?: readonly TrashEntry[]) => Promise<{
     removed: number;
     freedBytes: number;
 }>;

package/lib/types/verbs/restore-session.d.ts

@@ -1,6 +1,6 @@
 import { type TrashEntry } from '../trash/entry.js';
-import { type HostPort } from '../ports/host-port.js';
-import type { DeleteDeps } from './delete-session.js';
+import { type HostIdentityPort } from '../ports/host-port.js';
+import type { CoreDeps } from '../deps.js';
 /**
  * 恢复 = 把删除那次**按原路退回**，而且按组走：当年是按组一起搬进来的（父 + 它在盘上的孩子），
  * 只回父就会在回收站里留下一堆点不到的孩子行——清单只列父行，那些行既看不见也清不掉。
@@ -11,15 +11,17 @@ import type { DeleteDeps } from './delete-session.js';
  *    预检在写之前，是为了不让"父已经回到 `sessions/`、孩子因为项目目录没了而回不去"这种半组留在外面。
  *    **工作区账本不在这条硬前提里**：宿主的「删除工作区」只删注册、保留日志，记下的工作区没了就按
  *    「未分组」收（判据在 {@link attachableWorkspaceId}），照旧回盘——恢复是加法，不该因为一个可选的账目而失败。
- * ② **逐个恢复**，顺序与删除相反：文件先回来 → 挂账本 → 还原可见性 → 摘清册行 → 通告回来。
- * ③ 中途失败把这个成员自己退回回收站（就地回滚），并把**已经恢复完的**兄弟按相反顺序一起退回，失败照抛。
+ * ② **逐个恢复**，顺序与删除相反：文件先回来 → 挂账本 →（旧清单迁移）取消归档 → 摘清册行。
+ * ③ 中途失败时 journal 把这个成员自己退回回收站；**已经恢复完的**兄弟由整组 catch 按相反顺序一起退回。
+ *
+ * **通告不在这里**：一次批量只该拉一遍宿主会话表、只发一次 `api-session/added`（2026-10-17 那次
+ * "恢复很慢"就是逐条发）。通告归 `verbs/batch.ts`（ADR-0002），所以这个动词的 interface 只有
+ * "一个条目 id 进、回收站那一行出"，没有批量专用的开关。
  */
-export declare function restoreSession(deps: DeleteDeps): (entryId: string, options?: {
-    readonly snapshot?: TrashEntry[];
-    /** 批量（`verbs/apply.ts`）**自己收尾一次发**时传 `suppressAnnounce`：动词不再逐条通告——
-     *  单条一份摘要 = 一条一次宿主全表扫，那是 2026-10-17 "恢复很慢"的头号来源。 */
-    readonly suppressAnnounce?: boolean;
-}) => Promise<TrashEntry>;
+export declare function restoreSession(deps: CoreDeps): (entryId: string, 
+/** **只读**清册快照：批量层已经读过一次就递下来，整批因此只读一次（ADR-0002）。
+ *  动词**不收缩**它——收缩与"已被同批前一条带走"的判据都归 `verbs/batch.ts`。 */
+snapshot?: readonly TrashEntry[]) => Promise<TrashEntry>;
 /**
  * 这一次恢复**到底挂不挂账本**：交出能挂的那个 `workspaceId`，挂不了就 `undefined`。
  *
@@ -27,11 +29,11 @@ export declare function restoreSession(deps: DeleteDeps): (entryId: string, opti
  * 宿主的「删除工作区」只删注册、保留目录与每一份日志，那些会话之后本来就在「未分组」下。
  * 恢复不该为了挂一个不存在的账本把整条退回回收站。
  *
- * 判据**只有这一处**：`restoreOne` 拿它决定挂不挂，`GET /list` 拿它决定行上那句「原工作区已不存在，
+ * 判据**只有这一处**：`memberRestore` 拿它决定挂不挂，`GET /list` 拿它决定行上那句「原工作区已不存在，
  * 恢复后归入未分组」说不说。两边各问一遍就会有一天一个说、一个不挂。
  */
-export declare function attachableWorkspaceId(host: Pick<HostPort, 'workspaceExists'>, entry: TrashEntry): Promise<string | undefined>;
+export declare function attachableWorkspaceId(host: Pick<HostIdentityPort, 'workspaceExists'>, entry: TrashEntry): Promise<string | undefined>;
 /** 这一条记着的工作区**是不是已经没了**（区别于"删除时它就没有账目"的空串）——清单行据此决定
  *  要不要在点之前说那句「原工作区已不存在，恢复后归入未分组」。由 {@link attachableWorkspaceId}
  *  派生，不另起一份判据：那样会有一天一个说、一个不挂。 */
-export declare function isWorkspaceMissing(host: Pick<HostPort, 'workspaceExists'>, entry: TrashEntry): Promise<boolean>;
+export declare function isWorkspaceMissing(host: Pick<HostIdentityPort, 'workspaceExists'>, entry: TrashEntry): Promise<boolean>;

package/locale/en.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "Session Delete",
-    "description": "Delete sessions: delete moves them to a recoverable trash, with an explicit permanent delete."
-  }
-}
+{
+  "meta": {
+    "title": "Session Delete",
+    "description": "Delete sessions: delete moves them to a recoverable trash, with an explicit permanent delete."
+  }
+}

package/locale/zh.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "会话删除",
-    "description": "删除会话：删除 = 移入回收站（可恢复），另设显式的彻底删除。"
-  }
-}
+{
+  "meta": {
+    "title": "会话删除",
+    "description": "删除会话：删除 = 移入回收站（可恢复），另设显式的彻底删除。"
+  }
+}

package/package.json

@@ -1,105 +1,105 @@
-{
-  "name": "@xrn1997/dsh-session-delete",
-  "version": "0.2.1",
-  "description": "在 DeepSeek Harness 里删除会话：删除=移入回收站（可恢复），另设显式彻底删除",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": {
-      "types": "./lib/types/client/index.d.ts",
-      "default": "./lib/client.js"
-    },
-    "./locale/*.json": "./locale/*.json",
-    "./package.json": "./package.json"
-  },
-  "icon": "./icon.svg",
-  "files": [
-    "lib/index.js",
-    "lib/client.js",
-    "lib/types/**/*.d.ts",
-    "locale",
-    "icon.svg",
-    "cordis.patch.yml",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=24",
-    "dsh": ">=0.1.7-rc.2 <0.3.0-0"
-  },
-  "scripts": {
-    "build": "tsdown && tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "prepack": "npm run build"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.4",
-    "react": "^18.3.1"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.4",
-    "@testing-library/dom": "^10.4.2",
-    "@testing-library/jest-dom": "^6.10.0",
-    "@testing-library/react": "^16.3.3",
-    "@types/node": "24.19.0",
-    "@types/react": "18.3.31",
-    "@types/react-dom": "18.3.5",
-    "@types/semver": "^7.8.0",
-    "jsdom": "^26.1.0",
-    "react": "^18.3.1",
-    "react-dom": "18.3.1",
-    "semver": "^7.8.5",
-    "tsdown": "0.23.0",
-    "typescript": "5.9.3",
-    "vitest": "3.2.7"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-locale"
-      ],
-      "platform": "web"
-    },
-    "compatibility": {
-      "dshReleases": {
-        "0.2.0-rc.2": "compatible",
-        "0.2.1-rc.1": "compatible",
-        "0.2.1-rc.2": "compatible"
-      }
-    }
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrn1997/dsh-session-delete.git"
-  },
-  "homepage": "https://github.com/xrn1997/dsh-session-delete#readme",
-  "bugs": {
-    "url": "https://github.com/xrn1997/dsh-session-delete/issues"
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "session",
-    "trash",
-    "delete"
-  ],
-  "author": "xrn1997",
-  "license": "Apache-2.0",
-  "dependencies": {
-    "react-markdown": "^10.1.0",
-    "remark-gfm": "^4.0.1"
-  }
-}
+{
+  "name": "@xrn1997/dsh-session-delete",
+  "version": "0.3.0",
+  "description": "在 DeepSeek Harness 里删除会话：删除=移入回收站（可恢复），另设显式彻底删除",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./locale/*.json": "./locale/*.json",
+    "./package.json": "./package.json"
+  },
+  "icon": "./icon.svg",
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "locale",
+    "icon.svg",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=24",
+    "dsh": ">=0.1.7-rc.2 <0.3.0-0"
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/jest-dom": "^6.10.0",
+    "@testing-library/react": "^16.3.3",
+    "@types/node": "24.19.0",
+    "@types/react": "18.3.31",
+    "@types/react-dom": "18.3.5",
+    "@types/semver": "^7.8.0",
+    "jsdom": "^26.1.0",
+    "react": "^18.3.1",
+    "react-dom": "18.3.1",
+    "semver": "^7.8.5",
+    "tsdown": "0.23.0",
+    "typescript": "5.9.3",
+    "vitest": "3.2.7"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.2.0-rc.2": "compatible",
+        "0.2.1-rc.1": "compatible",
+        "0.2.1-rc.2": "compatible"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrn1997/dsh-session-delete.git"
+  },
+  "homepage": "https://github.com/xrn1997/dsh-session-delete#readme",
+  "bugs": {
+    "url": "https://github.com/xrn1997/dsh-session-delete/issues"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "session",
+    "trash",
+    "delete"
+  ],
+  "author": "xrn1997",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1"
+  }
+}