@xrn1997/dsh-session-delete 0.6.1 → 0.7.0

package/lib/types/client/detail-blocks.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 详情正文的**块视图词汇**：哪些块算过程内容、标准档怎么把连续过程块收成一组。
+ * 折叠状态与分页不在这里——这里只回答「这一页的块怎么读」。
+ */
+import type { TrashDetailBlockWire, TrashDetailInjectionBlockWire, TrashDetailTextBlockWire, TrashDetailToolBlockWire } from '../shared/wire.js';
+/** 除用户与助手之外的块：思考、工具、注入、系统消息、压缩摘要——详情按过程内容对待。
+ *  文本块是一个 `kind` 联合的接口，`Exclude` 摘不掉其中两个成员；这里按 `kind` 收窄后并上另两种块。 */
+export type DisclosureBlockWire = (TrashDetailTextBlockWire & {
+    kind: 'reasoning' | 'system' | 'compaction';
+}) | TrashDetailInjectionBlockWire | TrashDetailToolBlockWire;
+export declare function isDisclosureBlock(block: TrashDetailBlockWire): block is DisclosureBlockWire;
+/** 这一批块里有没有对话内容（用户或助手）；简洁档靠它决定还要不要继续往前翻。 */
+export declare function hasDialogue(blocks: readonly TrashDetailBlockWire[]): boolean;
+/** 标准档的线程单元：对话块照原位；**连续的**过程块收成一组。
+ *  组的 `id` 取它**后面那条对话块**的 id（没有对话块就 `after:end`）——prepend 更早一页只会
+ *  往组头添过程块，组的结束边界不变，已展开的组不会因为合并而收回。 */
+export type ThreadItem = {
+    readonly kind: 'block';
+    readonly block: TrashDetailBlockWire;
+} | {
+    readonly kind: 'process';
+    readonly id: string;
+    readonly blocks: readonly DisclosureBlockWire[];
+};
+export declare function threadItems(blocks: readonly TrashDetailBlockWire[]): ThreadItem[];

package/lib/types/client/index.d.ts

@@ -6,8 +6,9 @@ export declare const name = "@xrn1997/dsh-session-delete/client";
  * **`locale` 也不在这里**：宿主自己的 `ui-sidebar` 是硬注入它的，但那是"宿主知道自己那一代"的前提；
  * 本插件要跨代活着 ⇒ 走 `ctx.get('locale')` 可选读，缺席时降级到内置 zh 文案（见 `copy.ts` 头注）。
  * 写进 inject 就等于"这一代没有 locale 就不让整个客户端条目激活"，而那等于宿主进程死。
- * **`contextMenus` 同理**：0.2.2+ 用 `ctx.get('contextMenus')` 探测，包本身在 package.json 的
- * `dsh.client.inject` 里排到前面；旧宿主没有这个服务时回退 legacy 槽位。
+ * **`contextMenus` 同理**：0.2.2+ 用 `ctx.get('contextMenus')` 探测，服务比本条目晚到时按
+ * `ctx.inject(['contextMenus'])` 的 scoped 等待切过去；旧宿主没有这个服务时回调不来，legacy 槽位留着。
+ * 条目自己的 `inject` 仍然只有 `slots`——把可能迟到的服务写进去等于让整个客户端条目 pending。
  */
 export declare const inject: string[];
 /**

package/lib/types/client/maintenance-settings.d.ts

@@ -1,12 +1,12 @@
 /**
- * 插件设置页的「维护」卡（`plugins.bundle.config` 的占用者）。
+ * 插件设置页的「维护」卡（ADR-0021）：那张槽位上的两张卡里，本文件只拥有下面这一张。
  *
- * 两张段都是**手动**的：检查 → 预览 → 清理，没有挂载即扫、没有定时器。卡片的职责只有呈现：
+ * 两段都是**手动**的：检查 → 预览 → 清理，没有挂载即扫、没有定时器。卡片的职责只有呈现：
  * 状态那一行、检查按钮、以及各段自己的横幅 / 失败 / 提示 / 确认框；读数与动作全归
- * `src/client/use-maintenance.ts`。
+ * `src/client/use-maintenance.ts`。两张卡的先后与 `summary` 守卫在 `src/client/settings-cards.tsx`。
  *
  * 与回收站面板的区别：这里没有面板高度、没有清单与详情两栏、没有全局闸。控件只用
- * `CARD` / `Button` / `Modal` / `fileSizeText`，所以同一张卡放在插件详情页的任意宽度下都成立。
+ * `settingsCardShell` / `Button` / `Modal` / `fileSizeText`，所以同一张卡放在插件详情页的任意宽度下都成立。
  *
  * 孤儿会话段直接复用 `OrphanMaintenance`（警告条 / 失败 / 中性提示 / 预览确认的既有呈现）；
  * 孤儿附件段是本文件里的 `AttachmentMaintenance`（横幅 + 失败 + 回执 + 缩略图预览与清理确认）。
@@ -15,10 +15,9 @@ import type { ReactElement } from 'react';
 import { type Translate } from './copy.js';
 import { type MaintenanceDeps } from './use-maintenance.js';
 export interface MaintenanceSettingsProps {
+    /** 维护四件（读数与动作）；可调项两件由占用者另发给「可调项」卡。 */
     deps: MaintenanceDeps;
     /** 文案（缺省 = 内置 zh；宿主 locale 服务缺席时也是它，见 `copy.ts`）。 */
     t?: Translate;
-    /** 宿主 `plugins.bundle.config` 的视图：`summary` 是插件行的一行摘要，本卡只属于详情页。 */
-    view?: 'summary' | 'page';
 }
-export declare function MaintenanceSettings({ deps, t, view }: MaintenanceSettingsProps): ReactElement | null;
+export declare function MaintenanceSettings({ deps, t }: MaintenanceSettingsProps): ReactElement;

package/lib/types/client/remote.d.ts

@@ -2,10 +2,10 @@
  * 浏览器半的取数通道：同源 fetch 宿主 `connection.fetch` 的 exact Fetch 路由（`/api` + 插件前缀）。
  * 信封与失败原文在这一层收口。
  *
- * - 九段注册在宿主 `connection.fetch.register` 上，鉴权归宿主 `/api` bridge（ADR-0033）；
+ * - 十段注册在宿主 `connection.fetch.register` 上，鉴权归宿主 `/api` bridge（ADR-0033）；
  *   没有旧前缀 fallback——支持面是 web UI 与桌面端，二者的标准组合都装 `client-connection`。
  *   官方 remote.<namespace> 仍不可用（第三方拿不到 Typert 描述符的动态发现挂载点）。
- * - 九段的**段名与方法**住 `src/shared/wire.ts` 的结构化段名表（`ROUTES` 每项 `{ path, method }`），
+ * - 十段的**段名与方法**住 `src/shared/wire.ts` 的结构化段名表（`ROUTES` 每项 `{ path, method }`），
  *   本文件只投影段名与方法（GET 段直接取 `ROUTES.x.method`，写段把它交给 `post()`）——方法字面量
  *   不在本文件出现第二份；取数地址（官方 `/api` 前缀 + 文档挂载点）归 `src/client/api-base.ts`
  *   （根部署下与旧版逐字相同）。
@@ -17,7 +17,7 @@
  * - error 在线上是 {code,message,details?} 普通对象；判别依据 isDSHRemoteError 住在
  *   src/shared/wire.ts，这里不 import 任何宿主客户端包。
  */
-import { type ApplyAction, type ApplyOutcome, type ApplyValueByAction, type AttachmentCleanupWire, type AttachmentOrphanReportWire, type OrphanReportWire, type PurgeStatsWire, type RemoteFailure, type RemoteResult, type TrashDetailWire, type TrashRowWire } from '../shared/wire.js';
+import { type ApplyAction, type ApplyOutcome, type ApplyValueByAction, type AttachmentCleanupWire, type AttachmentOrphanReportWire, type OrphanReportWire, type PurgeStatsWire, type RemoteFailure, type RemoteResult, type SessionDeleteConfigWire, type TrashDetailWire, type TrashRowWire } from '../shared/wire.js';
 /**
  * 回收站条目（`/list` 那一行）。**形状的家在 `shared/wire.ts`**（ADR-0003）：这里只是别名，
  * 所以浏览器半不再自己抄一遍字段；下面几处"只读面"的镜像同理。
@@ -57,13 +57,18 @@ export type RemoteOutcome<T> = {
  */
 export declare function callRemote<T>(run: () => Promise<T>): Promise<RemoteOutcome<T>>;
 /** 本插件前缀路由那套**响应信封**的窄镜像（不是宿主服务 `ctx.remote.*`——那条 typert 通道为什么用不了，见 `AGENTS.md` 的 `remote.<namespace>` 那条）：
- *  每个方法 resolve 成 `RemoteResult<T>`。九个段名里这层走八个 JSON 段：`list` / `ping` / `orphans` / `detail` / `apply` / `empty` /
+ *  每个方法 resolve 成 `RemoteResult<T>`。十个段名里这层走九个 JSON 段：`list` / `ping` / `config` / `orphans` / `detail` / `apply` / `empty` /
  *  `attachment-orphans` / `attachment-clean`；写动作统一走 `apply`（一组 id 进、逐条结果出）；
  *  `/attachment` 是二进制段，由 `src/client/attachment-view.tsx` 直接拼地址。 */
 export interface RawSessionDeleteRemote {
     list(): Promise<RemoteResult<TrashEntryLike[]>>;
-    /** 通道的"在不在"：一次零成本的 GET（探测专用，见 `src/api/dispatch.ts` 的 `ping` 支）。 */
-    ping(): Promise<RemoteResult<string>>;
+    /** 通道的"在不在"：一次零成本的 GET（探测专用，见 `src/api/dispatch.ts` 的 `ping` 支）。
+     *  `signal` 由探测方给：半开连接不能把 `activate` 永远吊在这里。 */
+    ping(signal?: AbortSignal): Promise<RemoteResult<string>>;
+    /** 读三只可调项的当前值：空体 POST（与 `/detail` 的“POST 表达读”同法）。 */
+    config(): Promise<RemoteResult<SessionDeleteConfigWire>>;
+    /** 写回三只可调项：走宿主 `configEditor.edit`，这一行会重启；失败以 `io` 信封回来。 */
+    saveConfig(config: SessionDeleteConfigWire): Promise<RemoteResult<SessionDeleteConfigWire>>;
     /** 纯读：回收站之外的无主子会话扫描。它**不清理**——清理是 `apply` 的 `orphan-clean` 动作，
      *  这一段只交回"有多少、在哪、多大"（读不到语料时报 `io`，调用方不许把它折成"零条残留"）。 */
     orphans(): Promise<RemoteResult<OrphanReportWire>>;
@@ -86,14 +91,27 @@ export interface RawSessionDeleteRemote {
  * 成立（凭据是那次访问换来的 cookie，不是插件自己的秘密）。
  */
 export declare function createHttpRemote(): RawSessionDeleteRemote;
+/** 探测默认上限：5s。超时经 `AbortController` 打断 fetch，`activate` 不会永远吊在一条半开连接上。 */
+export declare const PROBE_TIMEOUT_MS = 5000;
+/**
+ * 探测的可选覆盖。**生产调用方不传**：注册路径只用 {@link PROBE_TIMEOUT_MS}。
+ * 这一格存在是为了让「超时算探测不过」这条支能在测试里真的跑到——不然它要等 5 秒墙上时间。
+ */
+export interface ProbeOptions {
+    /** 单次往返的上限；超时经 `AbortController` 打断 fetch。 */
+    readonly timeoutMs?: number;
+}
 /**
  * 探测唯一通道：一次 `GET /ping` 回成功信封（`pong`）才注册入口。
  *
  * - 401/403 是宿主 `/api` 的纯文本身份/归属失败：入口不出现，不装禁用态。
  * - 失败信封 / 404 / 非信封同样按不可用处理：`/api` 网关对未知路径也可能回错误形状，
  *   不能据此把入口摆出来让每个动作都失败。
+ * - **往返有 5s 上限**：半开连接或宿主没起来时 `activate` 不悬着；超时与网络失败同样是
+ *   「这一代不可用」，不自动重试（一次探测一个结论，刷新页面才会再探）。三种失败都在
+ *   console 留下原因——入口不出现是有意的，但"为什么没出现"不能只活在脑子里。
  */
-export declare function probeChannel(raw: RawSessionDeleteRemote): Promise<boolean>;
+export declare function probeChannel(raw: RawSessionDeleteRemote, options?: ProbeOptions): Promise<boolean>;
 /** `shared/wire.ts` 的 `ApplyOutcome`、扫描报告与附件回执从这里转出去——浏览器半只认 `remote.js` 这一扇门。 */
 export type { ApplyAction, ApplyOutcome, AttachmentCleanupWire, AttachmentOrphanReportWire, OrphanReportWire, } from '../shared/wire.js';
 /**
@@ -107,7 +125,7 @@ export type OneShotSuccess<A extends ApplyAction> = {
     readonly value: Exclude<ApplyValueByAction[A], null>;
 };
 /**
- * 注入面（`deps`）的 interface：**七个方法**（raw 层另有 `ping` 供探测；九段里的 `/attachment` 由
+ * 注入面（`deps`）的 interface：**九个方法**（raw 层另有 `ping` 供探测；十段里的 `/attachment` 由
  * `src/client/attachment-view.tsx` 直接拼地址，也不在这层）。
  *
  * **不再有 N=1 的便捷方法**：`delete` / `restore` / `countSubagents` 曾是同一段
@@ -117,6 +135,10 @@ export type OneShotSuccess<A extends ApplyAction> = {
  */
 export interface SessionDeleteRemote {
     list(): Promise<TrashEntryLike[]>;
+    /** 三只可调项的当前值（`apply` 归一后的那一份）。 */
+    config(): Promise<SessionDeleteConfigWire>;
+    /** 写回三只可调项：宿主 `configEditor.edit` 落盘并重启这一行；失败就是 throw。 */
+    saveConfig(config: SessionDeleteConfigWire): Promise<SessionDeleteConfigWire>;
     /** 回收站之外的无主子会话报告（纯读）。读不到就是 throw —— 界面上那是**一次失败的检查**，
      *  不是"零条残留"（把 `io` 折成空报告等于把"不知道"说成"没有"）。 */
     scanOrphans(): Promise<OrphanReportWire>;
@@ -130,6 +152,8 @@ export interface SessionDeleteRemote {
     /** 清空回收站（聚合回执）。 */
     emptyTrash(): Promise<PurgeResultLike>;
 }
+/** 插件设置页「可调项」卡只要这两件。 */
+export type ConfigDeps = Pick<SessionDeleteRemote, 'config' | 'saveConfig'>;
 /** 需要那一段 `/apply` 的组件只要这一段 deps（单条非写调用见 {@link applyOne}，写动作走 `./write.js` 的 `runWrite`）。 */
 export type OneShotDeps = Pick<SessionDeleteRemote, 'applyOutcomes'>;
 /**

package/lib/types/client/settings-cards.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `plugins.bundle.config` 的槽位占用者：上「可调项」、下「维护」（ADR-0043 决定 4）。
+ *
+ * 本文件只有两件事：按槽位契约守住视图（`summary` 不渲染，理由见 ADR-0021），以及排两张卡的先后。
+ * 各自的呈现、状态机与读数仍归 `config-settings.tsx` 与 `maintenance-settings.tsx`。
+ */
+import type { ReactElement } from 'react';
+import { type Translate } from './copy.js';
+import type { ConfigDeps } from './remote.js';
+import type { MaintenanceDeps } from './use-maintenance.js';
+export interface SettingsCardsProps {
+    /** 维护四件 + 可调项两件；只造维护四件的测试替身会让「可调项」卡整体缺席。 */
+    deps: MaintenanceDeps & Partial<ConfigDeps>;
+    /** 文案（缺省 = 内置 zh；宿主 locale 服务缺席时也是它，见 `copy.ts`）。 */
+    t?: Translate;
+    /** 宿主 `plugins.bundle.config` 的视图：`summary` 是插件行的一行摘要，两张卡都只属于详情页。 */
+    view?: 'summary' | 'page';
+}
+export declare function SettingsCards({ deps, t, view }: SettingsCardsProps): ReactElement | null;

package/lib/types/client/settings-view.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 插件设置页两张卡共用的**视图词汇**：卡片外壳配方。
+ *
+ * 与 `trash-view.ts` 同一个理由：两张卡共用宽度、内距与底色，只有内容节奏（`gap`）不同——各写一份
+ * 就会一张改了另一张没改。按内容高、铺满宿主给的宽度，不假设自己住在中央面板里（没有 `height:100%`）。
+ */
+import type { CSSProperties } from 'react';
+/** 设置页卡片外壳：`gap` 是这一张卡自己的内容节奏，其余两张贴一样。 */
+export declare const settingsCardShell: (gap: number) => CSSProperties;

package/lib/types/client/trash-detail.d.ts

@@ -6,7 +6,7 @@
  * - 标题优先用清册标题，空串才回落到日志的 session/title。
  * - 正文是**块**：用户/助手文字常显；思考、工具、注入、系统消息、压缩摘要默认折叠，折叠头给
  *   标签 + 首行摘要（工具另给状态）。注入也铺进正文——这是对宿主 Chat 的有意偏离（它隐藏普通注入，
- *   而这里的目标是「删之前看全」）；条数另进元信息表。
+ *   而这里的目标是「删之前看全」）；条数另进计量行。
  *
  * 助手正文与思考走 Markdown，用户提问保持原话；工具参数/结果走等宽纯文本（限高可滚）。
  * 附件随块位置渲染：用户气泡之上、助手正文之后、工具展开体末尾。

package/lib/types/client/trash-view.d.ts

@@ -1,19 +1,34 @@
 /**
- * 回收站界面共用的**视图词汇**：卡片配方、危险红、项目名的念法。
+ * 回收站界面共用的**视图词汇**：卡片配方、清单行、危险红、项目名与分组的念法。
  *
  * 它从 `trash-panel.tsx` 拆出来，因为清单面板与两个确认框（`trash-confirm.tsx`）都要用这几样——
  * 拆之前它们同住一个文件、只能靠"同一个文件里的常量"共享。拆之后两处读的是同一份，不是两份抄写。
  *
  * **配色与圆角一律走 token，字号是字面量 px**（宿主同类面也这么写）：卡片用宿主设置面的底层 token
- * （`bg-layer-2` + `border-l4` + `radius-lg`），选中态换宿主"选中"那一档（见 `trash-panel.tsx` 头注）。
+ * （`bg-layer-2` + `border-l4` + `radius-lg`），清单行不铺底不描边、选中态只换宿主"选中"那一档底色。
  */
 import type { CSSProperties } from 'react';
 import type { Translate } from './copy.js';
 import type { TrashEntryLike } from './remote.js';
 /** 卡片配方：宿主设置面的 fill/stroke 底层 token + 官方 `lg` 圆角。 */
 export declare const CARD: CSSProperties;
-/** 选中行：底色与描边都换成宿主"选中"那一档（`trash-panel.tsx` 头注里有这两枚 token 的实测取值）。 */
-export declare const CARD_SELECTED: CSSProperties;
+/**
+ * 清单条目行：与 `CARD` 同族但**不铺底、不描边**。
+ *
+ * 为什么和 `CARD` 分成两份而不改 `CARD`：`CARD` 还被读数失败块与附件回执块借用（`trash-panel.tsx`
+ * 的 `role="status"`、`attachment-view.tsx`），那一类是"要打断你视线的一块"，带底色和边框才对；
+ * 清单行是"一列可以扫的东西"，边框叠出来就是 2010 年代后台面板的长相。
+ *
+ * 悬停底色与动作列的低强调/提亮住在 `ui/layout.css`：inline style 表达不了 `:hover` /
+ * `:focus-within`，而 `ui.css` 是照宿主明文逐字抄的对照表，混进自造规则会把保真复核弄脏
+ * （同 `forms.css` 文件头给的理由）。
+ */
+export declare const ROW: CSSProperties;
+/**
+ * 选中行：底色用 inline style **故意压在** `layout.css` 的悬停底色之上——元素上的声明优先于
+ * 样式表里的 `:hover` 规则，选中与悬停同时成立时看到的是选中那一档，不会闪。
+ */
+export declare const ROW_SELECTED: CSSProperties;
 /**
  * **整页唯一那块实心红**的写法：`variant="primary"` + 在元素上覆盖 primary 那对填充 token。
  * 宿主插件管理页的 danger 按钮就是这个写法（asar @21658274），所以 hover 仍走 `.primary:hover` 类。
@@ -33,9 +48,20 @@ export declare function projectLabel(projectDir: string, t: Translate): string;
 export interface ProjectGroup {
     projectDir: string;
     label: string;
+    /** 组头悬停的全文：未分组组用组名，其余用有损的原始 `projectDir`。 */
+    title: string;
+    /** 「未分组」组：工作区已不在账本里的条目都归这里，永远沉底。 */
+    ungrouped: boolean;
     /** 组内最新一条的删除时间——组间排序的键。 */
     latest: number;
     entries: readonly TrashEntryLike[];
 }
-/** 按项目分组：组内按删除时间倒序，组间按各组最新一条倒序（刚删掉的那个项目排在最上面）。 */
+/**
+ * 「未分组」组的键：工作区已从宿主账本删掉（`workspaceMissing`）的条目都归这里。
+ * 哨兵值不与真实 `projectDir` 同形——空 cwd 已经由 `projectLabel` 念成「未记录项目」，
+ * 两者不是同一件事，不能撞键。
+ */
+export declare const UNGROUPED_PROJECT_DIR = "__dsh-session-delete__ungrouped";
+/** 按项目分组：组内按删除时间倒序，组间按各组最新一条倒序（刚删掉的那个项目排在最上面）。
+ *  工作区已不存在的条目统一进「未分组」组，且该组永远沉底——它不是一个可比较的项目。 */
 export declare function groupByProject(entries: readonly TrashEntryLike[], t: Translate): ProjectGroup[];

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";
@@ -18,7 +20,7 @@ export { Config };
  * - `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/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/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/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": "删除会话：删除 = 移入回收站（可恢复），另设显式的彻底删除。"
+  }
+}