@xrn1997/dsh-session-delete 0.6.0 → 0.7.0

package/lib/types/client/ui/MenuItemButton.d.ts

@@ -2,7 +2,7 @@
  * `MenuItemButton`（**照抄** `@deepseek-ai/dsh-client-ui-primitives@0.2.0-rc.2` 的同名组件，出处与三条
  * 改写规则见 `ui.css` 头注）：菜单里的一行，宿主菜单容器渲染它、键盘巡游也认它。
  *
- * **形状必须与宿主自己那四行（pin/rename/fork/archive）逐字同构**：`<div class=itemWrap>` 里先是可选
+ * **形状必须与宿主自己的官方菜单行（pin/rename/fork/archive/session-id）逐字同构**：`<div class=itemWrap>` 里先是可选
  * 的发丝线（`role="separator"`），再是 `<button type="button" role="menuitem">`，按钮内是
  * 图标位 + 标签位（+ 官方的快捷键位）。少一层、换个标签，这一行就会在键盘顺序、hover 底色或
  * `.itemLabel` 的省略号上跟邻行错开。

package/lib/types/client/ui/Toast.d.ts

@@ -13,6 +13,7 @@
  * **砍掉的**：`anchor`（把横幅对齐到某个元素的水平中心——本插件的撤销提示就是窗口居中）、
  * `actions[].prefix`（动作文案前的连接词，本插件只用「撤销」两个字）。**没砍 `text`/`icon`/`tone`/
  * `holdMs`/`actions`/`onDone`**：唯一的调用点这几样都在用。
+ * **本插件加的**：`paused`（撤销在飞时冻结停留与淡出，失败原文要落回同一条横幅；官方没有这个开关）。
  */
 import { type ReactElement, type ReactNode } from 'react';
 import './styles.js';
@@ -32,7 +33,9 @@ export interface ToastProps {
     holdMs?: number;
     /** 句尾的行内动作（照着句子的顺序排）。 */
     actions?: readonly ToastAction[] | undefined;
+    /** 暂停自动熄灭：这一趟还有下文（撤销在飞），先把横幅留着——失败原文要靠它上屏。 */
+    paused?: boolean | undefined;
     /** 淡出完成时调用一次：在这里卸载。 */
     onDone: () => void;
 }
-export declare function Toast({ text, icon, tone, holdMs, actions, onDone }: ToastProps): ReactElement;
+export declare function Toast({ text, icon, tone, holdMs, actions, paused, onDone }: ToastProps): ReactElement;

package/lib/types/client/ui/icons.d.ts

@@ -1,9 +1,15 @@
 /**
- * 本插件 UI 层要用的图标（逐条抄自 `@deepseek-ai/dsh-client-ui-primitives` 的明文产物；
- * 出处与改写规则见 `ui.css` 头注）。
+ * 本插件 UI 层要用的图标。除**恢复箭头**外逐条抄自 `@deepseek-ai/dsh-client-ui-primitives`
+ * 的明文产物（出处与改写规则见 `ui.css` 头注）。
  *
- * 只留本插件用到的：垃圾桶、警示、打开的项目文件夹、关闭叉、圆圈对勾、对勾、下折/右折 chevron。
- * **几何、`viewBox`、`strokeWidth` 逐字不动**——它们是官方图标集的形状，改了就不再与宿主同屏同形。
+ * 只留本插件用到的：垃圾桶、警示、文件夹（开盖填充 / 闭盒描边）、**实心三角**（分组头悬停时的
+ * 折叠指示）、关闭叉、圆圈对勾、对勾、下折/右折 chevron、恢复（本插件自绘的回退箭头）、
+ * 子会话分支（branch）。
+ * **官方字形几何、`viewBox`、`strokeWidth` 逐字不动**——改了就不再与宿主同屏同形。
+ *
+ * **唯一的自绘字形是 `IconRestoreOutlineRegular`**：官方集里 `unarchive-outline`（箱子）与归档动作太像、
+ * `refresh-outline`（顺时针圆箭头）读起来是"刷新"，都没有"把这条会话放回去"的意思。自绘的 ↩ 沿用宿主
+ * 16×16 / 1px 描边的一族几何，不伪装成官方图标。
  *
  * 两条与官方实现的差异（都是减法，不是改写）：
  * - 只暴露 `size`：调用处只传 `size`，不摊开官方整个图标 API。
@@ -16,13 +22,23 @@ export interface IconProps {
 }
 export declare function IconTrashOutlineRegular({ size }: IconProps): ReactElement;
 export declare function IconWarningOutlineRegular({ size }: IconProps): ReactElement;
-export declare function IconFolderOpenOutlineRegular({ size }: IconProps): ReactElement;
 export declare function IconCloseOutlineRegular({ size }: IconProps): ReactElement;
 /** 撤销提示 success 档的前导 glyph（官方 `Toast` 在 `tone="success"` 时自带的那一枚）。 */
 export declare function IconCheckCircleOutlineRegular({ size }: IconProps): ReactElement;
 /** 行尾兜底勾选开关那枚对勾（状态点/归档行；官方几何逐字）。 */
 export declare function IconCheckOutlineRegular({ size }: IconProps): ReactElement;
-/** 分组头「展开中」那一枚（官方 `IconChevronDownOutlineRegular`，`viewBox`/`d` 逐字）。 */
+/** 分组头：展开时（官方 `IconFolderOpenRegular`，16×16；开盖那一片带 0.16 透明度）。 */
+export declare function IconFolderOpenRegular({ size }: IconProps): ReactElement;
+/** 分组头：收起时（官方 `IconFolderCloseRegular`，16×16）。 */
+export declare function IconFolderCloseRegular({ size }: IconProps): ReactElement;
+/** 分组头悬停时替换文件夹的折叠指示（官方 `IconTriangleRightFillRegular`）；展开时旋转 90°。 */
+export declare function IconTriangleRightFillRegular({ size }: IconProps): ReactElement;
+/** 折叠头与标准档「工作步骤」组「展开中」那一枚（官方 `IconChevronDownOutlineRegular`，`viewBox`/`d` 逐字）。 */
 export declare function IconChevronDownOutlineRegular({ size }: IconProps): ReactElement;
-/** 分组头「已折叠」那一枚（官方 `IconChevronRightOutlineRegular`）。 */
+/** 折叠头与子会话导航行「已折叠 / 前进」那一枚（官方 `IconChevronRightOutlineRegular`）。 */
 export declare function IconChevronRightOutlineRegular({ size }: IconProps): ReactElement;
+/** 行内「恢复」：**本插件自绘**的回退箭头（↩，16×16 / 1px，与宿主图标同一族几何）。
+ *  官方集里的 `unarchive` 与归档动作的"箱子"轮廓太近、`refresh` 读作"刷新"，都不合适。 */
+export declare function IconRestoreOutlineRegular({ size }: IconProps): ReactElement;
+/** 子会话行的前导：官方 `IconBranchOutlineRegular`（16×16）。 */
+export declare function IconBranchOutlineRegular({ size }: IconProps): ReactElement;

package/lib/types/client/ui/recipe.d.ts

@@ -9,3 +9,5 @@ export declare const QUIET_DANGER: {
 };
 /** 单行截断。宽档那一列与可拖的分栏天然会挤文字，逐处手写这三行就会各写各的。 */
 export declare const ELLIPSIS: CSSProperties;
+/** 数字等宽：清单行、信息表与计量行共用一处，读数横着扫时才不抖。 */
+export declare const TABULAR_NUMS: CSSProperties;

package/lib/types/client/ui/styles.d.ts

@@ -1,2 +1,4 @@
+/** 装上两个捕获阶段的监听器，返回摘除函数。重复调用会装两套，所以调用点只该是 `apply` 的一个 effect。 */
+export declare function installPointerModality(): () => void;
 /** 最近一次输入是否来自指针（仅本插件自用）。 */
 export declare function isPointerModality(): boolean;

package/lib/types/client/use-detail-pager.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 详情分页的读侧编排：手动「加载更早」、简洁档自动连翻、prepend 后的滚动锚点。
+ * 组件只画；分页的两笔账（连翻预算与滚动位置）都住这里。
+ */
+import { type RefObject } from 'react';
+import type { TrashDetailBlockWire } from '../shared/wire.js';
+/**
+ * 「加载更早」跟工作步骤档位联动时，一次点击最多自动连翻多少页。
+ *
+ * 服务端按**块**翻页；简洁档把过程块整段藏起来，一页可能全是过程块 ⇒ 点一下什么都不出现，
+ * 看着像没反应。所以简洁档下自动继续往前翻，直到这一批里出现对话块、翻完、或到上限。
+ * 切进简洁档时当前页若全是过程块，也按同一份预算自动连翻——否则用户看到的仍是一页空白。
+ * 上限防的是"一条几乎全是工具调用的巨型会话"把一次点击变成几十个串行请求。
+ */
+export declare const AUTO_OLDER_PAGE_LIMIT = 10;
+interface DetailPagerOptions {
+    blocks: readonly TrashDetailBlockWire[];
+    olderCursor: number | null;
+    loadingOlder: boolean;
+    /** 更早一页读失败的原文；正文本身仍是 ready。 */
+    olderFailure: string | null;
+    /** 简洁档才自动连翻；标准及以上每页至少有一行可见内容（过程组头）。 */
+    compact: boolean;
+    onLoadOlder: () => void;
+    /** 详情栏的滚动容器；prepend 更早一页后按高度差补偿滚动位置。 */
+    scrollRef?: RefObject<HTMLDivElement | null> | undefined;
+}
+export interface DetailPagerHandle {
+    /** 手动「加载更早」与切进简洁档时那一次自动翻页共用的入口：记下这一批的起点与预算，再交给上层取数。 */
+    loadOlder: () => void;
+}
+export declare function useDetailPager({ blocks, olderCursor, loadingOlder, olderFailure, compact, onLoadOlder, scrollRef, }: DetailPagerOptions): DetailPagerHandle;
+export {};

package/lib/types/config.d.ts

@@ -3,21 +3,20 @@
  *
  * 为什么不用 `@deepseek-ai/schemastery` 写 schema：那是宿主包，值 import 会破本仓「跨插件一律
  * `import type`」的硬约束；Cordis 的 Config 接受 Standard Schema（`@standard-schema/spec`），
- * 手写这一小段即可，不需要把宿主 schema 库搬进插件。代价是宿主配置页拿不到字段级 JSON Schema
- * ——配置以 profile 的 `cordis.patch.yml` 为准（README「可调项」有示例）。
+ * 手写这一小段即可，不需要把宿主 schema 库搬进插件。代价是宿主只为 native Schemastery schema 投影
+ * 字段表单，这枚手写的 Standard Schema 不在其列——字段表单由插件设置页的「可调项」卡提供
+ * （ADR-0043），profile 的 `cordis.patch.yml` 仍是默认值与覆盖的家。
  *
  * 这里只做**默认值、归一与 schema**，不持有运行期现场：`apply` 归一一次，结果作为
  * `CoreDeps.config` 注入；读方从自己的 deps 读，不 import 模块级单例。
  * 客户端 6 秒撤销时长不在这里：它是浏览器半的产品决定，不跨半传。
  */
-export interface SessionDeleteConfig {
-    /** 设置页维护卡「孤儿附件」预览清单最多列多少条（数量与字节仍按全量报告）。 */
-    readonly orphanPreviewLimit: number;
-    /** `GET /attachment` 单次响应字节上限（服务路径与直接 fs fallback 共用）。 */
-    readonly maxAttachmentBytes: number;
-    /** 附件引用扫描里单个 JSON 引用源的字节上限；超过就按「读不出」fail closed。 */
-    readonly maxJsonRefBytes: number;
-}
+import { type SessionDeleteConfigWire } from './shared/wire.js';
+/** 三只可调项。字段名是线上契约（`shared/wire.ts` 的 `SessionDeleteConfigWire`），这里只是别名；
+ *  Node 半读到的是归一后的只读快照，所以 `readonly` 保留。默认值、归一与 Standard Schema 住本文件，
+ *  接受范围住在 `shared/wire.ts` 的 `CONFIG_LIMITS`：表单与归一必须是同一格，不然会「表单说能存、
+ *  激活时报越界」。 */
+export type SessionDeleteConfig = Readonly<SessionDeleteConfigWire>;
 export declare const DEFAULT_CONFIG: SessionDeleteConfig;
 /**
  * 把 patch 里的 `config` 归一成完整配置：缺省取默认值，未知键 / 非整数 / 越界都抛。
@@ -33,7 +32,7 @@ export declare const Config: {
         readonly version: 1;
         readonly vendor: "dsh-session-delete";
         readonly validate: (value: unknown) => {
-            value: SessionDeleteConfig;
+            value: Readonly<SessionDeleteConfigWire>;
             issues?: never;
         } | {
             issues: {

package/lib/types/deps.d.ts

@@ -23,8 +23,16 @@ export type DeleteSessionDeps = CoreDeps & {
 export type RemovalDeps = CoreDeps & {
     fs: CoreFsPort & Pick<FsPort, 'removeDir' | 'removeFile'>;
 };
+/** 宿主 `configEditor` 的窄面：`edit(entry, change)` 把完整 raw config 落盘并让 Loader 重启这一行。
+ *  `entry` 是 `ctx.fiber.entry`（Loader 挂在 fiber 上，Cordis 类型不声明它，组合根按窄镜像取）。 */
+export interface ConfigEditorLike {
+    edit(entry: unknown, change: (current: Record<string, unknown>) => Record<string, unknown>): Promise<void>;
+}
 /** 组合根装出的全量面：`/apply` 的分发同时够到删除的时钟与永久删除的 `removeDir` / `removeFile`
- *  （后者也供孤儿附件清理段使用）。`attachments` 只给 `attachment` 读段（ADR-0035）；动词不拿它。 */
+ *  （后者也供孤儿附件清理段使用）。`attachments` 只给 `attachment` 读段（ADR-0035）；动词不拿它。
+ *  `configEditor` / `entry` 只给 `/config` 的写支；宿主没有这套面时写支回 `io`，读支照常。 */
 export type DeleteDeps = DeleteSessionDeps & RemovalDeps & {
     readonly attachments: AttachmentsPort;
+    readonly configEditor?: ConfigEditorLike;
+    readonly entry?: unknown;
 };

package/lib/types/index.d.ts

@@ -1,3 +1,5 @@
+/** 只用于类型面：`@deepseek-ai/cordis` 留在 devDependencies 供本仓与 `lib/types` 解析，
+ *  不是 peer、也不在运行期加载；纯类型消费者在宿主外使用本包时需要自备它。 */
 import type { Context } from '@deepseek-ai/cordis';
 import { Config } from './config.js';
 export declare const name = "@xrn1997/dsh-session-delete";
@@ -10,14 +12,15 @@ export { Config };
  * 三项都是在隔离数据根上实测注入成功、且本插件真正用到的宿主服务。**不进 inject 的**：
  * - `remote`：那是**浏览器半**的服务（asar `dsh-api-gateway/lib/client.js`：`super(ctx, "remote")`），
  *   Node 半挂的是 `ctx.typertGateway`。把它写进 Node 半的 inject 会让插件永远 pending（同 `slots` 那次的形状）。
- * - `sessions` / `sessionProjectionCache`：两者都按 `ctx.get(...)` **可选读**——`sessions` 只给 `evictLive`
- *   用（活跃判据走 waterfall，见 src/ports/host-port.ts；服务缺席回 `unknown`），`sessionProjectionCache` 是标题的尽力读面。
- *   inject 一个可能没挂的服务 = 整个插件 pending。
- *   它取不到时 `titleOf` 返回空串，正是契约允许的降级。
+ * - `sessions` / `sessionProjectionCache` / `sessionPersistence`：都按 `ctx.get(...)` **可选读**——
+ *   `sessions` 给 `evictLive` 和 live header 用（活跃判据走 waterfall，见 src/ports/host-port.ts；
+ *   服务缺席回 `unknown`），`sessionProjectionCache` 是标题的投影读面，`sessionPersistence` 是
+ *   `projectDirOf` / `titleOf` 的公开 header 读面（workspaceRegistry 硬注入它，标准组合必有）。
+ *   inject 一个可能没挂的服务 = 整个插件 pending；标题取不到时 `titleOf` 返回空串，正是契约允许的降级。
  * - `agents`：只给 handle 捕获用（`ctx.get('agents')`；缺席时 `ctx.inject(['agents'])` 等服务就绪再装）。
  *   它同样可能晚于本插件激活，写进插件 inject 只会让整个插件 pending。
  *
- * `connection` 是浏览器半取数通道的唯一承载者：九段注册到 `connection.fetch.register` 的
+ * `connection` 是浏览器半取数通道的唯一承载者：十段注册到 `connection.fetch.register` 的
  * `/api/dsh-session-delete-api/*`，Host/Origin/浏览器认证由宿主 `/api` bridge 完成（ADR-0033）。
  * 支持面是 web UI 与桌面端，二者的标准组合都装 `client-connection`；服务缺席时插件停在 pending
  * ——可见的激活失败，而不是静默地没有入口。`webServer` 不再直接使用：exact route 仍由宿主的

package/lib/types/ports/agent-handles.d.ts

@@ -1,10 +1,12 @@
-/** 捕获所需的 ctx 窄面：可选服务读法（`get`）与按依赖注入的子上下文（`inject`，晚挂载的 `agents` 靠它补装）。
- *  有些 ctx / 假件没有 `inject`——那就只在 apply 时 `get` 一次。 */
+/** 捕获所需的 ctx 窄面：可选服务读法（`get`）、按依赖注入的子上下文（`inject`，晚挂载的 `agents` 靠它补装）
+ *  与卸载钩子（`effect`，wrapper 的恢复挂在这里）。有些 ctx / 假件没有后两者——那就只在 apply 时 `get` 一次，
+ *  且不注册恢复。 */
 export interface AgentCtxLike {
     get(name: string): unknown;
     inject?(names: readonly string[], callback: (child: {
         get(name: string): unknown;
     }) => void): void;
+    effect?(execute: () => () => unknown, label?: string): unknown;
 }
 /** 一次捕获交回的句柄表：按会话 id `dispose`。没捕到 / 已经 dispose 过都是 no-op；
  *  dispose 本身的失败**原样抛出**（调用方 `evictLive` 把它折成 `unknown`，不通告）。 */
@@ -19,6 +21,12 @@ export interface AgentHandleStore {
  *  **安装时机**：先 `get('agents')`，没装成再 `inject(['agents'])`（两者只装一次，符号表兜住）。
  *  **symbol 表**：句柄表挂在服务实例的 {@link CAPTURED_AGENT_HANDLES} 上；同一个 agents 服务上的第二次
  *  安装（`get` 与 `inject` 各一次，或第二个 `createHostPort`）看见它就直接共用，不把 wrapper 套第二层。
+ *  **安装者拥有 wrapper**：包装记录先在闭包里留一份（`ownWrappers`，建立于 symbol 写入之前），同时挂到
+ *  {@link CAPTURED_AGENT_WRAPPERS}；第一次成功安装时经 `ctx.effect` 注册一条卸载恢复——按 own property
+ *  descriptor 的身份把 `resume` / `create` 写回目标自有的原函数（`restoreTo`；代理读回的影子不写回，
+ *  别人后装的 wrapper 不动），并摘掉仍归本闭包的 symbol 表。恢复是总的：一条写回失败不跳过其余记录。
+ *  恢复一次即锁死：晚到的安装与晚到的 handle 落地都被 `restored` 挡住。没有 `ctx.effect`（假件 / 旧 ctx）
+ *  时包装照装，只是没有恢复。
  *  **读回判据**：cordis 的 traceable 服务代理每次读函数都会新包一层（`get` 里的 `createShadowMethod`），
  *  所以只能看 own property descriptor 的身份；拿 `service[name]` 读回比身份是必然的假警报。
  */

package/lib/types/ports/fs-port.d.ts

@@ -1,7 +1,17 @@
+/**
+ * **缺席**只认 ENOENT 与 ENOTDIR（"路径中间有一截不是目录"与"不存在"是同一种回答）。
+ *
+ * EACCES / EIO / ELOOP / 断挂载**不是缺席**：这些读数说明"我们看不见"，不是"那里没有"。
+ * 破坏性动作（删目录、删附件对象、按"没有引用"清共享图）据此做决定，把读不出折成没有
+ * 就是数据消失；ADR-0039 是这条判据的裁决。
+ */
+export declare function isAbsentPath(error: unknown): boolean;
 export interface FsPort {
     /** 全部成员写成属性声明：端口方法会被**解构出来单独调**（`const { sizeOfDir } = port`，见下方
      *  模块级递归的注释），实现体一律不读 `this`。方法简写的隐式 `this: FsPort` 会让
      *  `unbound-method` 把这种正常用法报成可疑；契约（返回的 Promise 形状）一字未动。 */
+    /** 路径在不在。**只有 ENOENT / ENOTDIR 回 `false`**；权限、盘挂、I/O 等读错误照抛——
+     *  调用方拿它当"缺席"判据时，读不出必须是失败，不是"没有"（ADR-0039）。 */
     exists: (p: string) => Promise<boolean>;
     /** 建目录（含中间层）。首删时 `~/.dsh/session-trash/` 还不存在，而 `rename` 不建父目录。 */
     ensureDir: (p: string) => Promise<void>;

package/lib/types/ports/host-port.d.ts

@@ -9,10 +9,12 @@ export interface HostIdentityPort {
      *  宿主的「删除工作区」只删注册、保留目录与日志；恢复这类会话时跳过 attach，归入「未分组」。 */
     workspaceExists(workspaceId: string): Promise<boolean>;
     /** 会话落盘的**项目目录名**（`<sessions>/<projectKey(cwd)>`）；账本里没有这个会话 ⇒ `undefined`。
-     *  与 `workspaceOf` 同一口径：**未命中是正常的 no-op，不是故障**（存储真故障照抛）。 */
+     *  header 走公开 live/持久化读面；与 `workspaceOf` 同一口径：**未命中是正常的 no-op，不是故障**
+     *  （存储真故障照抛）。 */
     projectDirOf(sessionId: string): Promise<string | undefined>;
     /** 删除时**尽力**取的会话标题；取不到返回空串，绝不因此让删除失败。
-     *  标题只存在于宿主自己的账本/缓存里（`FsPort` 不直读文件）⇒ 取数面归宿主端口，接官方投影缓存 API。 */
+     *  标题只存在于宿主自己的账本/缓存里（`FsPort` 不直读文件）⇒ 取数面归宿主端口，接官方投影缓存 API；
+     *  header 与 `projectDirOf` 走同一个公开读面。 */
     titleOf(sessionId: string): Promise<string>;
     isLive(sessionId: string): Promise<boolean>;
     isArchived(sessionId: string): Promise<boolean>;

package/lib/types/shared/wire.d.ts

@@ -1,12 +1,12 @@
 /**
- * 跨半 wire 契约：前缀、九个端点、请求/响应形状与失败码。
+ * 跨半 wire 契约：前缀、十个端点、请求/响应形状与失败码。
  * Node 半（src/api/dispatch.ts）与浏览器半（src/client/remote.ts）共用这一份，不各写字面量。
  *
  * 构建约束：本文件零运行时依赖、无 import；浏览器半把整个文件 inline 进 bundle。
  * 信封 {ok:true,value} / {ok:false,error:{code,message,details?}} 也是两半的共同契约。
  */
 /**
- * 插件专属前缀（九段相对它命名）。
+ * 插件专属前缀（十段相对它命名）。
  *
  * 为什么必须带插件名：宿主 `connection.fetch.register` 对**重复的精确路径**直接抛错
  * （`connection: exact Fetch route "…" is already registered`），撞了就是整棵插件树 boot 失败——
@@ -14,11 +14,11 @@
  */
 export declare const SESSION_DELETE_API_PREFIX = "/dsh-session-delete-api";
 /**
- * 唯一的取数基础路径：宿主 `/api` + 插件前缀。九段 exact Fetch 路由、客户端探测与附件 URL
+ * 唯一的取数基础路径：宿主 `/api` + 插件前缀。十段 exact Fetch 路由、客户端探测与附件 URL
  * 都从它起；`SESSION_DELETE_API_PREFIX` 只作为段名的相对前缀与错误原文。
  */
 export declare const OFFICIAL_SESSION_DELETE_API_PREFIX = "/api/dsh-session-delete-api";
-/** 九个段名（相对前缀）。**每项 `{ path, method }` 两键**：某段用什么方法也是线上形状的一部分
+/** 十段段名（相对前缀）。**每项 `{ path, method }` 两键**：某段用什么方法也是线上形状的一部分
  *  （ADR-0003），家就在这一张表——路由记录（`src/api/route-table.ts`）逐行投影（`ROUTES.x.method`），
  *  浏览器半的 GET 段同样投影、写段把 `ROUTES.x.method` 交给 `src/client/remote.ts` 的 `post()`，
  *  两半都不逐段手写一份。
@@ -33,7 +33,8 @@ export declare const OFFICIAL_SESSION_DELETE_API_PREFIX = "/api/dsh-session-dele
  *    这一段只负责"有多少、在哪、多大"。
  *  - `attachment`：附件原始字节（全仓唯一的二进制响应段；失败仍回 JSON 信封）。
  *  - `attachmentOrphans`：无引用图片对象的扫描报告（纯读；数量/字节 + 供预览的对象清单）。
- *  - `attachmentClean`：清掉报告那一刻无引用的图片对象（聚合回执 `AttachmentCleanupWire`）。 */
+ *  - `attachmentClean`：清掉报告那一刻无引用的图片对象（聚合回执 `AttachmentCleanupWire`）。
+ *  - `config`：三只可调项的读/写共用一段——空体读当前值，带字段写回 profile 的 patch 层。 */
 export declare const ROUTES: {
     readonly list: {
         readonly path: "/list";
@@ -44,6 +45,11 @@ export declare const ROUTES: {
         readonly path: "/ping";
         readonly method: "GET";
     };
+    /** 可调项：空体读（与 `/detail` 同法，用 POST 表达一个读）；带字段写，写必须进到达序链。 */
+    readonly config: {
+        readonly path: "/config";
+        readonly method: "POST";
+    };
     /** 单条详情（读回收站目录里那条会话自己的日志）。 */
     readonly detail: {
         readonly path: "/detail";
@@ -83,6 +89,32 @@ export declare const ROUTES: {
 /** 段名 → 那一段的路径。从结构化段名表派生：加一段只在上面加一项，`Record<RouteName, …>` 类型闸
  *  （`src/api/route-table.ts`）与运行期键集比对（`tests/route-table.test.ts`）都跟着这一格走。 */
 export type RouteName = (typeof ROUTES)[keyof typeof ROUTES]['path'];
+/** 三只可调项的线上形状。Node 半的 `SessionDeleteConfig`（`src/config.ts`）是它的别名：
+ *  这一格固定线上字段名与接受范围（{@link CONFIG_LIMITS}），默认值与归一在 `src/config.ts`。 */
+export interface SessionDeleteConfigWire {
+    /** 设置页「孤儿附件」预览清单最多列多少条（数量与字节仍按全量报告）。 */
+    orphanPreviewLimit: number;
+    /** `GET /attachment` 单次响应字节上限（服务路径与直接 fs fallback 共用）。 */
+    maxAttachmentBytes: number;
+    /** 附件引用扫描里单个 JSON 引用源的字节上限；超过就按「读不出」fail closed。 */
+    maxJsonRefBytes: number;
+}
+/** 三只可调项的接受范围（闭区间整数）。Node 半的归一与浏览器半的表单共用这一格：
+ *  两处各写一份范围就会「表单说能存、宿主激活时说越界」。 */
+export declare const CONFIG_LIMITS: {
+    readonly orphanPreviewLimit: {
+        readonly min: 1;
+        readonly max: 10000;
+    };
+    readonly maxAttachmentBytes: {
+        readonly min: 1;
+        readonly max: number;
+    };
+    readonly maxJsonRefBytes: {
+        readonly min: 1;
+        readonly max: number;
+    };
+};
 /** `/apply` 的五个动作。id 的含义随动作走：`delete`/`count`/`orphan-clean` 是**宿主会话 id**
  *  （前两个还没进回收站，第三个压根没有回收站行），`restore`/`purge` 是**回收站条目 id**。
  *  两域都是 string（线上形状）；这里不引入品牌类型——错域不靠类型拦，交给各动词在运行期按自己的

package/lib/types/trash/attachments.d.ts

@@ -1,3 +1,4 @@
+import { isAbsentPath } from '../ports/fs-port.js';
 import type { FsPort } from '../ports/fs-port.js';
 import type { SessionDeleteConfig } from '../config.js';
 import { type AttachmentCleanupWire } from '../shared/wire.js';
@@ -22,8 +23,10 @@ export type AttachmentRef = ImageRef | FileRef;
  *  假支若按「是 string」取反会被 TS 收成 `never`（参数本来就是 string），插值就成了 never 读数。
  *  这里判的仍是同一条正则，谓词只是把「形状」写进类型面。 */
 export declare function isAttachmentId(value: unknown): value is `sha256:${string}`;
-/** `statFile` / `readFile` / `sizeOfDir` 里只有 ENOENT 能当"不在"；权限、盘挂、I/O 错误都必须露成读不出。 */
-export declare function isMissing(error: unknown): boolean;
+/** 路径缺席的判据只有一处：`src/ports/fs-port.ts` 的 `isAbsentPath`（ENOENT / ENOTDIR）。
+ *  `statFile` / `readFile` / `sizeOfDir` 的读错误里，"不在"只认这两枚；权限、盘挂、I/O 错误
+ *  都必须露成读不出（ADR-0039），别在这里另写一份只有 ENOENT 的抄本。 */
+export declare const isMissing: typeof isAbsentPath;
 /** 合法附件 ID → 宿主附件库里的绝对路径。`name` 不参与拼接。 */
 export declare function attachmentPathOf(home: string, kind: 'image' | 'file', id: string): string;
 /** 一条消息的 `content[]` 里的附件块；畸形 id / 非附件段一律跳过。 */
@@ -67,6 +70,16 @@ export interface ImageRemovalPlan {
  * 剩余引用源读不出 ⇒ 整体跳过；候选日志读不出 / 附件对象 stat 失败 ⇒ 只跳过那一部分，其余照常。
  */
 export declare function planImageAttachmentRemoval(deps: AttachmentReadDeps, removedDirs: readonly string[]): Promise<ImageRemovalPlan>;
+/**
+ * 执行期复核：计划与真删对象之间隔着一整趟目录删除（秒级），这期间别的会话可能把同一张图
+ * （内容寻址 ⇒ 同一个 sha256 id）再引用一次，或派生存储新写一条引用。计划是数据、会过期；
+ * 删对象之前用同一套剩余引用扫描再判一次，**只删这一刻仍无引用的那些**（ADR-0041）。
+ *
+ * 调用时机：会话 / 回收站目录已经删掉之后、`executeImageAttachmentRemoval` 之前——那时被删的
+ * 引用源已经不在了，扫到的就是真正的"剩余"。读不出照旧 fail closed：回空计划 + `skipped`，
+ * 宁可留下孤儿也不删共享。空计划直接返回（不为零删付一次全 home 扫描）。
+ */
+export declare function recheckImageRemovalExclusivity(deps: AttachmentReadDeps, plan: ImageRemovalPlan): Promise<ImageRemovalPlan>;
 /**
  * 逐文件删；ENOENT 由端口的 `force` 吞掉；其他错误计数并继续。
  *

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

@@ -0,0 +1,25 @@
+/**
+ * `/config` 的读/写动词：三只可调项的当前值与写回。
+ *
+ * 读是免费快照（`apply` 归一后的那一份），写才碰宿主：
+ * - 先按 `src/config.ts` 的 `normalizeConfig` 校验（未知键 / 非整数 / 越界回 400，不拿半套值写盘）；
+ * - 再走宿主 `configEditor.edit(entry, change)`：完整 raw config 落进 profile 的 patch 层，
+ *   由编辑器串行化、校验并让这一行重启（字段不是 volatile，重启是它给的语义）。
+ * - `configEditor` / `entry` 缺席（老宿主、嵌套上下文）回 `io` 并在原文里说清替代路径——
+ *   不静默假装保存成功。
+ *
+ * `entry` 由组合根从 `ctx.fiber.entry` 取（见 `src/index.ts`）；本文件不碰 ctx。
+ */
+import { type SessionDeleteConfig } from '../config.js';
+import type { ConfigEditorLike } from '../deps.js';
+/** `/config` 的写支需要的三件；读支只要 `config`。 */
+export interface ConfigRouteDeps {
+    readonly config: SessionDeleteConfig;
+    readonly configEditor?: ConfigEditorLike;
+    readonly entry?: unknown;
+}
+/** `/config` 的请求体：`null` 或 `{}` 是读；只要带一个键就当写（未知键由 {@link normalizeConfig} 400 拒掉）。
+ *  路由表按同一句话定纯度，所以别在别处再写一遍这个判据。 */
+export declare function configPatchOf(body: Record<string, unknown> | null): Record<string, unknown> | undefined;
+/** 空体 = 读当前值；带字段 = 写。请求体已经由适配器解析成对象或 null。 */
+export declare function readOrSaveConfig(deps: ConfigRouteDeps, body: Record<string, unknown> | null): SessionDeleteConfig | Promise<SessionDeleteConfig>;

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

@@ -21,5 +21,7 @@ export declare function routeError(code: RouteCode, httpStatus: number, message:
 export declare function rollbackReason(label: string, error: unknown): string;
 /** 原错误保留，回滚失败作为 `details.rollbackFailures` 上线；码仍按原错误的动词码，
  *  没有可继承的就落 io。**内层的回滚失败要并进来**：一个成员自己退失败、兄弟也退失败时，
- *  两份失败都得在 details 里，消息也不能出现第二个「回滚未完成」。 */
+ *  两份失败都得在 details 里，消息也不能出现第二个「回滚未完成」。
+ *  **原错误 details 的其余键原样保留**：孤儿清理的部分回执（`removed` / `freedBytes` /
+ *  `failedSessionId`）就挂在它上面，整份替换会把已经发生的删除报成 0。 */
 export declare function withRollbackFailures(error: unknown, failures: readonly string[]): VerbError;

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

@@ -130,15 +130,20 @@ export declare function planOrphanRemoval(deps: CoreDeps, members: readonly {
  *
  * 顺序：整批摘归档集 → 摘有账本的成员的账本 → 逐条回收站行
  * （在才删目录 → 摘清册行 → 通告成员离场）→ 逐条盘上成员（删目录 → 通告成员离场）→ 逐条附件对象。
- * 目录删掉就没有"退回去"这回事，中途失败**不回滚**；已经删掉的由下面的计数器如实交回。
- *
- * 附件清理排在**所有会话目录删完之后**：对象只在会话真的没了之后才动；单文件失败只进
- * `attachments.failed`，不影响（也不回滚）会话删除的回执。
+ * 目录删掉就没有"退回去"这回事，中途失败**不回滚目录**；已经删掉的由下面的计数器如实交回。
+ * **归档态回滚**：`unarchive` 排在所有删除之前（免得留下"会话没了、归档集还挂着"的幽灵 id），
+ * 所以中途失败时目录还在、归档位却已经摘了。失败出口把**目录还在**的那些（这一趟没删掉、也不是计划时
+ * 就缺席）按删除前的读数重新归档（`isArchived` 先读过一次，不是按 `wasArchived` 猜）；目录不在的跳过
+ * ——那时恢复归档只会造幽灵 id。
+ * 回滚自己的失败走 `details.rollbackFailures`，不让它把原错误吞掉（ADR-0040）。
+ * **附件计划在执行期复核**：计划到删对象之间的窗口里新增的引用会让计划过期；删对象前用同一套
+ * 剩余引用扫描重判一次，只删这一刻仍无引用的对象（ADR-0041）。
  *
  * 失败形状：
  * - `kind:'orphan'`（orphan-clean）⇒ `io` + `{removed, freedBytes, failedSessionId}`，不伪装成整组没动；
  * - `kind:'trash'`（purge）⇒ 同一个标签、不带 details；
- * - orphan-clean 的 unarchive / detach 原样抛出。
+ * - orphan-clean 的归档实况预读 / unarchive / detach 原样抛出；
+ * - 归档态回滚不干净时，原错误带 `details.rollbackFailures`（码仍按原错误的动词码）。
  *
  * 通告只经 `member-presence`（摘活体三态 + `api-session/removed`），不在这里另写一份。
  */

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "Session Delete",
+    "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,6 +1,6 @@
 {
   "name": "@xrn1997/dsh-session-delete",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "在 DeepSeek Harness 里删除会话：删除=移入回收站（可恢复），另设显式彻底删除",
   "type": "module",
   "packageManager": "pnpm@11.25.0",
@@ -27,7 +27,9 @@
     "icon.svg",
     "cordis.patch.yml",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "docs/screenshots"
   ],
   "engines": {
     "node": ">=24",
@@ -44,8 +46,16 @@
     "gates": "pnpm typecheck && pnpm lint && pnpm test && pnpm build && pnpm run pack:dry"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.4",
-    "react": "^18.3.1"
+    "react": "^18.3.1",
+    "react-dom": "18.3.1"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
@@ -63,6 +73,8 @@
     "jsdom": "^26.1.0",
     "react": "^18.3.1",
     "react-dom": "18.3.1",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
     "semver": "^7.8.5",
     "tsdown": "0.23.0",
     "typescript": "5.9.3",
@@ -70,23 +82,26 @@
     "vitest": "3.2.7"
   },
   "dsh": {
+    "manifestVersion": 1,
     "bundle": {
       "patch": "./cordis.patch.yml"
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-locale"
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-context-menu"
       ],
       "platform": "web"
-    },
-    "compatibility": {
-      "dshReleases": {
-        "0.2.0-rc.2": "compatible",
-        "0.2.1-rc.1": "compatible",
-        "0.2.1-rc.2": "compatible",
-        "0.2.1-rc.3": "compatible",
-        "0.2.1-rc.5": "compatible"
-      }
+    }
+  },
+  "xrn1997": {
+    "dshReleases": {
+      "0.2.0-rc.2": "compatible",
+      "0.2.1-rc.1": "compatible",
+      "0.2.1-rc.2": "compatible",
+      "0.2.1-rc.3": "compatible",
+      "0.2.1-rc.5": "compatible",
+      "0.2.2-rc.1": "compatible"
     }
   },
   "publishConfig": {
@@ -109,9 +124,5 @@
     "delete"
   ],
   "author": "xrn1997",
-  "license": "Apache-2.0",
-  "dependencies": {
-    "react-markdown": "^10.1.0",
-    "remark-gfm": "^4.0.1"
-  }
+  "license": "Apache-2.0"
 }