@xrn1997/dsh-session-delete 0.1.1 → 0.2.0

package/lib/types/api/dispatch.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `/dsh-session-delete-api` 前缀路由的**内部分发**（薄线的 Node 半）。
+ *
+ * 为什么是这一条路（裁决，不是偏好）：浏览器侧 `remote.<namespace>` 只能由**生成的 Typert 远程
+ * 描述符贡献**经 `ctx.remote.$mount(...)` 挂上，而盒内那份装配清单是**写死的 25 条官方包**、
+ * 全宿主没有任何"按包发现再挂载"的动态机制 ⇒ 第三方要那个命名空间，
+ * 只能自挂自（要生成物 + `zod` + 改包布局），代价与收益完全不成比例。改用宿主**自己的 web server**
+ * 开一条插件专属前缀路由：真相/账本/判据全在宿主那边，这一层只搬运。
+ *
+ * 四条口径：
+ *  ① **不依赖 Cordis**：`createApiHandler(deps)` 是纯构造器，返回一个 `(req, res) => Promise<void>`
+ *     ——所以它能用真 `node:http` server 直接单测（`tests/api.test.ts`），与宿主怎么挂它无关。
+ *  ② **信封就是浏览器半消费的那个形状**：`{ok:true,value}` / `{ok:false,error:{code,message,details?}}`。
+ *     `error.code` 走 `src/remote/map-error.ts` 的**同一张表**（设计稿 §6 的五个码），原文进
+ *     `error.message`，结构化附带物进可选的 `error.details`——浏览器半的 `unwrapRemoteResult` /
+ *     `failureOf` 因此一行都不用改。
+ *  ③ **HTTP 状态不是第二套语义**：**操作失败**时状态一律 200（含 `ok:false`）——我们与浏览器半之间的
+ *     契约是信封本身，判断成败只看 `ok`（同宿主网关"每次 unary 调用 resolve 成 RemoteResult、
+ *     不为载体问题 reject"的那条规矩）。**请求本身不对**才用 4xx（400 请求体 / 405 方法 / 404
+ *     未知路由），同源栅栏拒的是**请求**而不是操作，回 403；浏览器半先解信封再看状态。
+ *  ④ **同源栅栏**：本机回环上一条能删会话的写口不能被任意网页用 simple request CSRF 打——没有栅栏时
+ *     `content-type: text/plain` 的跨源 POST 不触发预检、直接生效。放行的形状见 {@link isTrustedRequest}：
+ *     同源（浏览器直接打开宿主那行 URL）、桌面壳自己的页面（`dsh-app://app`，真机那条路，见
+ *     {@link isDesktopShellUrl}）、或两者皆缺席（curl / 本机工具）。本机既有插件
+ *     （`dsh-novel` 的 `api/wire.ts`）只认前两条里的"同源"，本文件多的是桌面壳那一条——**它必须有**：
+ *     桌面版的请求被壳摘掉了 `Origin`，漏掉它等于真机上四个入口一个都不出现（而直连 http 的过门
+ *     读数看不出来）。
+ *  ⑤ **`list` 是"对账 + 读"，且它与写动作按到达序串行**（{@link createApiHandler} 里那条进程内链）：
+ *     对账（`reconcileTrash`）与删除/恢复/彻底删除都是"读清单 + 动文件 + 写清单"的多步，交错跑会互相踩
+ *     ——删除刚把目录搬进回收站、行还没写上时，对账抢先把这行按目录"重建"出来，再被真实行覆盖成降级
+ *     元数据。串行的代价只是排队（单进程单用户，毫秒级）；纯读（`detail`、`ping`、`apply/count`）
+ *     不占这条链。
+ *  ⑥ **一段 `POST /apply` 管所有写动作**（2026-10-17 批量重构）：旧形状是「一条一段、一次一发」，
+ *     批量只能由调用方循环拼出来——100 条 = 100 次往返 ×（一次全量清册读 + 每条一次宿主会话表）。
+ *     现在一组 id 一次进、逐条 `ApplyOutcome` 出；单条就是 N=1，仓里不留第二条执行路径。
+ *     清空是聚合回执（不按条回），所以单独一段 `POST /empty`。
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { TrashEntry } from '../trash/entry.js';
+import type { DeleteDeps } from '../verbs/delete-session.js';
+/** 清单交回浏览器的那一行：清册那一行 + 组视图的三个只读数。 */
+export interface TrashRow extends TrashEntry {
+    /** 跟着这条父会话一起进回收站的孩子数（来源：清册里 `parentEntryId` 指向它的行）。 */
+    readonly subagentCount?: number;
+    /** 那些孩子的字节合计（页脚的合计要算得上它们，不能只加父自己那一格）。 */
+    readonly subagentBytes?: number;
+    /** **盘上还留着、没被带走**的孩子数（来源：宿主 `sessionQuery`）。级联落地前删掉的那些存量才非零；
+     *  与 `subagentCount` 是两件事，界面上必须各说各的（不许用一个冒充另一个）。 */
+    readonly strandedSubagents?: number;
+}
+export declare function createApiHandler(deps: DeleteDeps): (req: IncomingMessage, res: ServerResponse) => Promise<void>;

package/lib/types/client/batch-bar.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 批量删除的浮条（第十三批①）：**多选模式内常驻**（0 条也渲染，既显示模式又给退出入口），
+ * 汇总「已选 N 条」+（读得到时）「含 K 个子会话」；「查看已选」展开限高可滚动的标题清单
+ * （逐条可移除），回答"到底选了哪些"——清单默认收起，不把底部输入区盖住。
+ * 模式内的整行点击守卫也挂在这棵常驻宿主上（见 `batch-select.tsx` 的 `useSelectionRowClickGuard`）。
+ *
+ * 为什么单独一个文件而不是并进 `batch-select.tsx`：那份是"选中集 + 行开关"（被确认框 import），
+ * 而浮条要点开确认框（要 import 它的现场）——两个方向合到一个文件上就是一圈。浮条住在
+ * `shell.overlay` 上，与单删的撤销提示/确认框同类（槽位原文："a toast stack or a status pill
+ * all belong here"）。
+ *
+ * 那个 K 是**勾选变化后防抖 300ms 的一次批量 count**（`/apply` 的 `action:'count'`，一组 id 一次），
+ * 并且带**序号守卫**：在飞的旧响应不许盖掉新名单的读数（与第十二批那条 `reloadSeq` 同一个道理）。
+ * 读不到就整句不说——K 是合计，缺一条就是假数（10-15 稿 §10「不许拿 0 冒充没有」）。
+ */
+import { type ReactElement } from 'react';
+import { type Translate } from './copy.js';
+import type { SessionDeleteRemote } from './remote.js';
+/** 浮条只需要那一个批量口（计数）；执行归确认框。 */
+export type BatchBarDeps = Pick<SessionDeleteRemote, 'applyOutcomes'>;
+export declare function BatchBar({ deps, t, }: {
+    deps: BatchBarDeps;
+    t?: Translate;
+}): ReactElement | null;

package/lib/types/client/batch-confirm.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 批量删除的确认框（第十三批②）——挂在 `shell.overlay` 上的宿主，加它读的那个模块级现场。
+ *
+ * 为什么又开一个文件而不是把 `delete-confirm.tsx` 撑大：单删那张框是**已交付的面**（设计稿 §7 状态 ②，
+ * 用例钉着），批量形与它只有三件不同——标题随条数、目标卡逐条列、执行是一次批量 `apply`。共用一个壳
+ * 意味着单删的 `busy` / 失败面要跟着学批量形，那是拿已交付的行为去换省一个文件。卡片样式（`TARGET_CARD`）
+ * 与 hint、子会话那两句**复用**单删的，一句不造第二个键。
+ *
+ * 现场是模块级的（同 `delete-confirm.tsx` / `undo-toast.tsx`）：请求从浮条那颗按钮发来，确认框住在
+ * `shell.overlay` 上——它必须活在行开关那棵子树之外（槽位行随宿主重排而卸载，见 `delete-confirm.tsx` 头注）。
+ */
+import { type ReactElement } from 'react';
+import { type PickItem } from './batch-select.js';
+import { type Translate } from './copy.js';
+import { type SessionDeleteRemote } from './remote.js';
+export interface BatchDeleteRequest {
+    /** 每次发布递增：换一批就重挂载，busy / 失败面不带着上一批的记忆。 */
+    seq: number;
+    items: readonly PickItem[];
+}
+/** 浮条那颗按钮调用：请求确认这一批（缺省 = 当前选中集）。空名单不发框。 */
+export declare function requestDeleteBatch(items?: readonly PickItem[]): void;
+export declare function clearDeleteBatchRequest(): void;
+/** 供浮条与装配面订阅。 */
+export declare function useDeleteBatchRequest(): BatchDeleteRequest | null;
+export type BatchConfirmDeps = Pick<SessionDeleteRemote, 'applyOutcomes'>;
+/** 常驻的批量确认框宿主。没有待确认的批量删除时什么都不渲染。 */
+export declare function BatchConfirmHost({ deps, t, }: {
+    deps: BatchConfirmDeps;
+    t?: Translate;
+}): ReactElement | null;

package/lib/types/client/batch-menu-item.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 会话「⋯」菜单里的「多选」入口（第十三批①改版）。
+ *
+ * 常驻勾选框被用户打回后，入口改成显式模式：按下这一行才进入多选态（再按一次退出），
+ * 模式内才渲染勾选框、才把整行点击变成"勾/取消"（守卫在 `batch-select.tsx`）。
+ * 菜单的开关归 owner（与 `delete-menu-item.tsx` 同一条契约）：按下后先切模式、再收菜单。
+ *
+ * 文案复用回收站工具栏那两句（`trash.toolbar.select` / `selectExit`）——同一个"多选/退出多选"
+ * 不造第二个键。
+ */
+import type { ReactElement } from 'react';
+import { type Translate } from './copy.js';
+export interface BatchSelectMenuItemProps {
+    /** 菜单 owner 交下来的「收起菜单」；缺省不动，方便单独测这一行。 */
+    dismissMenu?: () => void;
+    /** 文案（缺省 = 内置 zh，见 `copy.ts`）。 */
+    t?: Translate;
+}
+export declare function BatchSelectMenuItem({ dismissMenu, t, }: BatchSelectMenuItemProps): ReactElement;

package/lib/types/client/batch-select.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 宿主列表批量删除的选择面（第十三批①）：多选模式 + 选中集 + 行首勾选 + 行尾兜底 + 整行点击守卫。
+ *
+ * 入口在每行的「⋯」菜单里（`batch-menu-item.tsx`）：**按下才进入多选模式**，模式内才渲染勾选框、
+ * 才把整行点击变成"勾/取消"；退出模式清空名单。选中集是**模块级现场**（本仓既有的客户端模式，见
+ * `delete-confirm.tsx` / `undo-toast.tsx`）：主勾选框住在每行的 `sidebar.session.row.leading` 槽位里，
+ * 行尾兜底住在 `sidebar.workspaces.session.row.action`，浮条与批量确认框住在 `shell.overlay` 上——
+ * 四处隔着槽位边界，只有模块级 store 能让他们看见同一份名单。状态源用 React 自带的
+ * `useSyncExternalStore`，不为此引新的状态库。
+ *
+ * **为什么主勾选在行首**：宿主对行尾 `.rowActions` 是 `display:none`，只有 `row:hover` / 菜单打开
+ * 才出现（app.asar 0.2.0-rc.2 的 Rows 渲染）；行首 16px 格在无状态点时是空的，模式内可见。
+ * 宿主在「有状态点（运行中/待确认/未读完成）」与归档行不渲染行首格 ⇒ 这些行走行尾悬停兜底，
+ * 但模式内**点整行**也能选（`useSelectionRowClickGuard`），所以不依赖那颗小框。
+ * 两条勾选不会同时出现（`ui.css` 的 `:has` 兜底隐藏规则，靠宿主行的 `data-row-key`）。
+ *
+ * 名单只收槽位投影原样给的 `sessionId` / `displayTitle`（浏览器半不自己拼 id），**顺序 = 勾选顺序**：
+ * 宿主列表的 DOM 序不归我们读，`/apply` 那条「保持输入顺序」吃到的因此就是勾选序。
+ */
+import { type ReactElement } from 'react';
+import { type Translate } from './copy.js';
+import { type SessionDeleteRemote } from './remote.js';
+export interface PickItem {
+    /** 宿主槽位投影的会话 id，原样透给 `applyOutcomes('delete', …)`。 */
+    sessionId: string;
+    /** 删除那一刻的会话名（投影的 `displayTitle`）：只用于文案与确认框，不参与请求。 */
+    title: string;
+}
+export declare function getPicks(): readonly PickItem[];
+export declare function isSelecting(): boolean;
+/** 「⋯ → 多选」按下时进入；重复进入是幂等的。 */
+export declare function enterSelection(): void;
+/** 退出模式并清空名单：多选态和选中集是同一次交互的两半，退出后不该留下看不见的名单。 */
+export declare function exitSelection(): void;
+export declare function useSelecting(): boolean;
+/** 翻转一条：没选过就排队尾，选过就摘掉（列表里永远不会有重复 id）。 */
+export declare function togglePick(item: PickItem): void;
+export declare function clearPicks(): void;
+/** 全选：把当前可见可选行里还没选的按 DOM 序追加；原有选中保持在前。 */
+export declare function selectAllVisible(): void;
+/**
+ * 同一个切换口该显示「全选」还是「取消全选」：
+ * - 有选中、且当前可见可选行全都选中 ⇒ 取消全选；
+ * - 有选中、但当前没有可见可选行（全折叠/过滤掉）⇒ 只能清空，也显示取消全选；
+ * - 其余（含 0 条）⇒ 全选。
+ */
+export declare function allVisibleSelected(): boolean;
+/** 执行后收缩：只留失败名单（空数组 = 全清）。成功的随通告从侧栏消失，不该留在名单里。 */
+export declare function shrinkPicksToFailures(failedSessionIds: readonly string[]): void;
+export declare function usePicks(): readonly PickItem[];
+/**
+ * 多选态内的整行点击守卫（document 捕获阶段）。
+ *
+ * 为什么必须在这里拦：宿主的会话行自己带 `onClick = open(sessionId)`，第三方没有官方的
+ * "别切会话"开关；模式内点行要变成"勾/取消"，只能抢在 React 根监听之前把事件吃掉。
+ * 边界：行里的按钮 / 链接 / 输入 / 菜单项一律放行（否则 ⋯ 菜单、归档、置顶、单删都点不动）；
+ * 双击的第二下与 dblclick 不翻转（第一下已经选中，第二下不能又反掉，也不能打开宿主的重命名）。
+ * 认行靠 `data-row-key="session:…"`——宿主将来改掉这个属性，最差是模式内点行不生效，
+ * 勾选框本身仍在。
+ */
+export declare function useSelectionRowClickGuard(): void;
+/**
+ * 一组会话的子会话计数（`/apply` 的 `action:'count'`，纯读、不进串行链）。
+ *
+ * **一条读不到就整份返回 null** ——界面上那两个数（浮条的 K、确认框的 K 与逐条 M）都是合计，
+ * 缺一条就是假数；「不许拿 0 冒充没有」（10-15 稿 §10）。
+ */
+export declare function fetchCounts(deps: Pick<SessionDeleteRemote, 'applyOutcomes'>, ids: readonly string[]): Promise<Map<string, number> | null>;
+export interface BatchPickCheckboxProps {
+    sessionId: string;
+    /** 槽位只投 `sessionId`；标题由宿主侧的 root hook 读出来再传进来（见 `index.tsx` 的 `PickLeadingRow`）。 */
+    title: string;
+    /** 文案（缺省 = 内置 zh，见 `copy.ts`）。 */
+    t?: Translate;
+}
+/**
+ * 行首 16px 格里的主勾选框：**只在多选模式内渲染**（模式入口在「⋯ → 多选」，不常驻）。
+ *
+ * 用的是回收站多选同款原生 `Checkbox`：它自己会 `stopPropagation`，所以点框不会顺带打开会话
+ * （行首格在宿主行那条 `onClick` 里面）。宿主对「有状态点」和归档行不渲染这一格，
+ * 那些行走 `BatchPickButton` 兜底；两条不会同时出现（见 `ui.css` 的兜底隐藏规则）。
+ */
+export declare function BatchPickCheckbox({ sessionId, title, t, }: BatchPickCheckboxProps): ReactElement | null;
+export interface BatchPickButtonProps {
+    sessionId: string;
+    title: string;
+    /** 会话在跑：置灰 + 悬停原因（与单删菜单行同款——级联遇在跑成员整组拒绝，先说清再让人点不动）。 */
+    live?: boolean;
+    /** 文案（缺省 = 内置 zh，见 `copy.ts`：这不是"忘了传"，而是"这次没有 locale 服务"）。 */
+    t?: Translate;
+}
+/**
+ * 多选态里行尾悬停排的**兜底**勾选开关：只在宿主不渲染行首格的行上露头（状态点行 / 归档行）。
+ * 座位原文保证「排内点击不误开会话」（`rowActions` 那层自己挡住冒泡），所以这颗按钮不需要
+ * 自己 `stopPropagation`。行首那颗与这颗共用同一份选中集和同一句 aria 名字；模式内点整行也能选。
+ */
+export declare function BatchPickButton({ sessionId, title, live, t, }: BatchPickButtonProps): ReactElement | null;

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

@@ -0,0 +1,31 @@
+/**
+ * 宿主**浏览器侧** ctx 的本地窄镜像（AGENTS.md 的规矩：只声明用到的成员 + 一次强转；
+ * 不装宿主类型包、不做 `declare module` 增强）。
+ *
+ * 单独一个文件是因为它现在有两个使用者：入口 `index.tsx`（槽位注册）与 `copy.ts`（locale 服务），
+ * 放在入口里会绕出一个循环导入。
+ */
+/** 一个槽位注册项。`label` 允许是 thunk——宿主 `resolveSlotLabel` 的 JSDoc 原文即
+ *  "thunks follow the active locale"，面板行名要随语言走就得走这条（见 `copy.ts` 头注）。 */
+export interface SlotRegistration {
+    name: string;
+    /** list 座位的占用者 id。 */
+    id?: string;
+    /** keyed 座位（`main`）的键；与 `id` 二者按座位取一。 */
+    key?: string;
+    order?: number;
+    /** 宿主的行名字（`resolveSlotLabel(options.label)`；`sidebar.panellist` 用它画 `.panelTitle`）。 */
+    label?: string | (() => string);
+    inject?: () => unknown;
+}
+export interface SlotsLike {
+    inject(key: string, contribute: () => unknown): unknown;
+    register(options: SlotRegistration, component: unknown): unknown;
+}
+export interface ClientContextLike {
+    slots: SlotsLike;
+    /** 可选服务的读面（宿主自己的写法：`ctx.get('…')?.…`）。**缺省调用**：老宿主上没有这个方法。 */
+    get?(name: string): unknown;
+    /** 挂一个随本插件卸载而撤销的副作用（返回的清理函数由框架接管）。 */
+    effect(execute: () => unknown, label?: string): unknown;
+}

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

@@ -0,0 +1,167 @@
+/**
+ * 可见文案（**全部**住在这里）＋接上宿主 Client locale 服务的那一步。
+ *
+ * ## 为什么不是散在各组件里的中文字面量
+ *
+ * 官方给第三方 UI 插件的规则是「Route visible UI text through the Client locale service」
+ * （宿主技能 `cordis-plugin-development/references/ui-plugin.md`）。宿主自己那套就是这么做的：
+ * `ui-sidebar` 声明 `inject = ['slots','layout','uiWorkspace','locale','shortcuts']`，并在
+ * `ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'ui-sidebar: dictionaries')` 里注册字典
+ * （真产物原文）。所以本插件也把文案收成一份带**命名空间**的字典，`zh` 是完整真源、`en` 逐键镜像
+ * ——宿主 `register` 的**对象形式要求两套内置语言都齐**（缺一个键就是运行期报错）。
+ *
+ * ## 服务是**可选读**的，不进 `inject`
+ *
+ * `ctx.get('locale')` 而不是把 `locale` 写进 `inject`。理由是本仓那条硬约束的另一面：**客户端半的
+ * 条目激活失败 = 宿主进程死**（前端启动自检 `web boot: N entry did not activate` ⇒ 桌面壳
+ * `reportFatal('web-boot')`）。宿主自己的 `ui-sidebar` 敢硬注入 `locale`（它是宿主的一部分，知道
+ * 那一行一定在），而本插件要跨宿主代数活着 ⇒ 服务缺席时**降级到内置 zh 文案继续工作**，
+ * 好过整个进程死。这与宿主对可选服务的官方写法同形（`ctx.get('…')?.…`）。
+ *
+ * 取数面：[`dsh-client-locale`] 的 `LocaleRuntime.register(ns, { zh, en })` 返回一个 disposer
+ * （必须挂进 `ctx.effect`，否则卸载后字典留在注册表里，下次挂载会撞 "already has locale"），
+ * `bind(ns)` 交回一个**按命名空间记忆化**的 `t(key, params)`（官方明说它"retain stable identity …
+ * so they can ride inject surfaces without breaking memoization"——所以我们把它塞进槽位的
+ * `inject` 载荷是正当用法）。
+ *
+ * ## 面板行那一行字为什么要用 thunk
+ *
+ * `sidebar.panellist` 的行名字由宿主 `syncPanels` 逐字 `label: resolveSlotLabel(options.label) ?? id`
+ * 解析，而 `resolveSlotLabel` 的实现是 `typeof label === 'function' ? label() : label`，
+ * 其 JSDoc 原文即 "thunks follow the active locale"；宿主自己还挂了
+ * `ctx.effect(() => ctx.locale.subscribe(syncPanels), 'ui-sidebar: panel labels')` 在语言切换时重读。
+ * ⇒ 面板名传 `() => t('trash.title')` 就随语言走；**换成活计数就会 stale**（只在条目或语言变化时重读）。
+ */
+import { type RelativeTimeUnit } from './ui/format.js';
+import type { ClientContextLike } from './context.js';
+/** zh 是真源；`en` 必须逐键齐全（宿主的对象形式注册会整体校验）。 */
+declare const ZH: {
+    readonly 'common.untitled': "(无标题会话)";
+    readonly 'common.cancel': "取消";
+    readonly 'common.close': "关闭";
+    readonly 'common.justNow': "刚刚";
+    readonly 'common.ago': "{n}{unit}前";
+    readonly 'common.retry': "重试";
+    readonly 'trash.title': "回收站";
+    readonly 'trash.loading': "正在读回收站…";
+    readonly 'trash.readFailed': "回收站读不到";
+    readonly 'trash.empty.title': "回收站是空的";
+    readonly 'trash.empty.hint': "在会话条目的「…」菜单里选「删除」，会话会先进到这里，随时可以恢复。";
+    readonly 'trash.summary': "{count} 个会话 · 共 {size}";
+    readonly 'trash.group.count': "{count} 个会话";
+    readonly 'trash.project.unknown': "未记录项目";
+    readonly 'trash.row.deletedNow': "刚刚删除";
+    readonly 'trash.row.deletedAgo': "删除于 {n}{unit}前";
+    readonly 'trash.row.subagents': "含 {n} 个子会话";
+    readonly 'trash.row.strandedSubagents': "盘上还剩 {n} 个子会话";
+    readonly 'trash.unit.minutes': "分钟";
+    readonly 'trash.unit.hours': "小时";
+    readonly 'trash.unit.days': "天";
+    readonly 'trash.unit.months': "个月";
+    readonly 'trash.unit.years': "年";
+    readonly 'trash.row.restore': "恢复";
+    readonly 'trash.row.purge': "彻底删除…";
+    readonly 'trash.footer.note': "回收站本体在宿主数据根下的 {dir} 里，不自动过期；清空后不可恢复。";
+    readonly 'trash.emptyAll': "清空回收站…";
+    readonly 'trash.confirm.all': "清空回收站？";
+    readonly 'trash.confirm.one': "彻底删除 1 个会话？";
+    readonly 'trash.confirm.one.meta': "{project} · 删除于 {at} · {size}";
+    readonly 'trash.confirm.body': "这会从回收站移除文件，{strong}。";
+    readonly 'trash.confirm.body.strong': "之后没有任何副本可以恢复";
+    readonly 'trash.confirm.purge': "彻底删除";
+    readonly 'trash.toolbar.collapseAll': "全部折叠";
+    readonly 'trash.toolbar.expandAll': "全部展开";
+    readonly 'trash.divider.label': "调整左右分栏宽度";
+    readonly 'trash.select.group': "勾选「{project}」这 {count} 条会话";
+    readonly 'trash.toolbar.select': "多选";
+    readonly 'trash.toolbar.selectExit': "退出多选";
+    readonly 'trash.select.count': "已选 {count} 条";
+    readonly 'trash.select.purge': "彻底删除 {count} 条";
+    readonly 'trash.select.restore': "恢复 {count} 条";
+    readonly 'trash.select.needOne': "先勾选要处理的会话";
+    readonly 'trash.select.row': "勾选「{title}」";
+    readonly 'trash.confirm.bulk': "彻底删除 {count} 个会话？";
+    readonly 'trash.confirm.restore': "恢复 {count} 个会话？";
+    readonly 'trash.confirm.restore.body': "这一批会回到它们各自的原项目目录，恢复到会话列表里。";
+    readonly 'trash.confirm.restoreNow': "恢复";
+    readonly 'detail.notSelected': "选中一条会话，看它讲了什么";
+    readonly 'detail.loading': "正在读这条会话…";
+    readonly 'detail.readFailed': "这条会话的正文读不出来";
+    readonly 'detail.noBody': "这条会话没有可显示的文字";
+    readonly 'detail.field.created': "创建";
+    readonly 'detail.field.lastActivity': "最后活动";
+    readonly 'detail.field.deletedAt': "删除于";
+    readonly 'detail.field.span': "活跃跨度";
+    readonly 'detail.field.size': "大小";
+    readonly 'detail.field.turns': "轮数";
+    readonly 'detail.field.userMessages': "提问";
+    readonly 'detail.field.assistantMessages': "回复";
+    readonly 'detail.field.toolCalls': "工具调用";
+    readonly 'detail.field.models': "模型";
+    readonly 'detail.field.project': "项目";
+    readonly 'detail.field.sessionId': "会话 id";
+    readonly 'detail.field.trashDir': "回收站目录";
+    readonly 'detail.field.wasArchived': "原本归档";
+    readonly 'detail.value.yes': "是";
+    readonly 'detail.value.no': "否";
+    readonly 'detail.value.spanHours': "{n} 小时";
+    readonly 'detail.value.spanDays': "{n} 天";
+    readonly 'detail.messages.hidden': "另有 {count} 条宿主注入的上下文未显示";
+    readonly 'detail.messages.omitted': "还有 {count} 条未显示";
+    readonly 'detail.back': "← 返回清单";
+    readonly 'detail.list.label': "回收站清单";
+    readonly 'detail.role.user': "你";
+    readonly 'detail.role.assistant': "助手";
+    readonly 'menu.delete': "删除";
+    readonly 'menu.live': "会话正在运行，先停止再删除";
+    readonly 'dialog.title': "删除这个会话？";
+    readonly 'dialog.subagents': "含 {n} 个子会话，将一起移入回收站。";
+    readonly 'dialog.hint': "会话会移入回收站，之后可以随时恢复。彻底删除是回收站里的另一个动作。";
+    readonly 'dialog.confirm': "移入回收站";
+    readonly 'batch.row.pick': "勾选「{title}」以批量删除";
+    readonly 'batch.bar.count': "已选 {n} 条";
+    readonly 'batch.bar.pickHint': "点击会话行选择";
+    readonly 'batch.bar.kids': "含 {k} 个子会话，跟着整组走";
+    readonly 'batch.bar.review': "查看已选";
+    readonly 'batch.bar.reviewClose': "收起已选";
+    readonly 'batch.bar.remove': "取消勾选「{title}」";
+    readonly 'batch.bar.selectAll': "全选";
+    readonly 'batch.bar.selectNone': "取消全选";
+    readonly 'batch.run': "移入回收站 {n} 条";
+    readonly 'dialog.batch.title': "删除这些 {n} 个会话？";
+    readonly 'dialog.batch.retry': "重试这 {n} 条";
+    readonly 'undo.movedBatch': "{n} 条会话已移入回收站";
+    readonly 'undo.moved': "{title} 已移入回收站";
+    readonly 'undo.session': "会话";
+    readonly 'undo.undo': "撤销";
+};
+export type CopyKey = keyof typeof ZH;
+export type CopyParams = Readonly<Record<string, string | number>>;
+export type Translate = (key: CopyKey, params?: CopyParams) => string;
+/** 服务缺席时的缺省：字典里那套 zh。**也是组件 prop 的缺省值**——它表达的是"这次没有 locale 服务"，
+ *  与运行期 `createTranslate` 的降级分支是同一件事，不是"忘了传"。 */
+export declare const zhTranslate: Translate;
+/**
+ * 注册字典并交回本插件的 `t`。服务不在时返回 `zhTranslate`（不抛、不 pending）。
+ *
+ * 注册必须挂在 `ctx.effect` 上：`register` 返回的 disposer 是**官方契约**（卸载时要把字典摘掉），
+ * 而且同一命名空间的同一语言**只能注册一次**——effect 没挂，HMR 重挂就撞 "already has locale"。
+ */
+export declare function createTranslate(ctx: ClientContextLike): Translate;
+/**
+ * 把一句话里内嵌的那一段拆出来：`'…文件，之后没有任何副本可以恢复。'` 交给调用面用 `<b>` 包中间那段。
+ *
+ * 为什么不留成"前段 / 内嵌段 / 后段"三个键：那等于把英文和中文的语序各钉一次，两段翻译各自
+ * 成立、拼起来未必成立。整句一个键 + 一个占位符，语言自己决定那一段落在哪里。
+ */
+export declare function splitOn(sentence: string, inner: string): [string, string, string];
+/**
+ * 绝对时间那一句串。清单行的 `title`、确认框里的meta、详情的元信息三处要的是同一个写法，
+ * 各自 `new Date(...).toLocaleString()` 一遍迟早会漂成两种样子。
+ */
+export declare function absoluteText(at: number): string;
+/** 单位词本身（调用方把它填进各自语言的整句模板里，语序由各语言自己钉）。 */
+export declare function unitWord(unit: RelativeTimeUnit, t: Translate): string;
+/** 「7分钟前」这类**不带谓语**的相对短语；`now` 桶不套模板——"刚刚前"不是话。 */
+export declare function agoText(at: number, now: number, t: Translate): string;
+export {};

package/lib/types/client/delete-confirm.d.ts

@@ -0,0 +1,40 @@
+import { type Translate } from './copy.js';
+import { type DeleteConfirmDeps } from './remote.js';
+/**
+ * 被操作对象那张卡。`Modal`（`ui/Modal.tsx`，照官方抄的）的 `.sd-modal-body` 不设字号也不给层级 ⇒ 裸摆一行会话标题会和下面那句
+ * 提示**同字同色**，读不出"这才是要被删的东西"。配方与「彻底删除」框里那张摘要卡同一套（宿主设置面
+ * 的卡片 token：`bg-layer-2` + `border-l4` + `radius-lg`），两个对话框因此同形。
+ * 浅色下 `bg-layer-2` 与对话框自身同色，分隔全靠那根描边——宿主自己的卡片在浅色下也是这样。
+ */
+export declare const TARGET_CARD: {
+    readonly padding: "10px 12px";
+    readonly background: "var(--dsw-alias-bg-layer-2)";
+    readonly border: "0.5px solid var(--dsw-alias-border-l4)";
+    readonly borderRadius: "var(--dsw-radius-lg)";
+};
+/** 菜单行写进现场的一条删除请求（槽位投影原样带过来，浏览器半不自己拼 id）。 */
+export interface DeleteRequest {
+    /** 每次发布递增：换一个会话就重挂载确认框，busy / failure 不带着上一条请求的记忆。 */
+    seq: number;
+    /** 要删的会话 id——原样透给 `sessiondelete/delete`。 */
+    sessionId: string;
+    /** 删除那一刻的会话名（槽位投影的 `displayTitle`）：只用于确认框文案与撤销提示。 */
+    title: string;
+}
+/** 菜单行调用：请求删除这个会话（确认框由 overlay 上的宿主渲染）。 */
+export declare function requestDelete(input: {
+    sessionId: string;
+    title: string;
+}): void;
+/** 收起确认框（用户点「取消」/「关闭」、或删除成功后收工）。 */
+export declare function clearDeleteRequest(): void;
+/** 供宿主组件订阅。 */
+export declare function useDeleteRequest(): DeleteRequest | null;
+/**
+ * 常驻的确认框宿主。挂 `shell.overlay`（框架级浮层；槽位说明原文 "a toast stack or a status
+ * pill all belong here"）：没有待确认的删除时什么都不渲染。
+ */
+export declare function DeleteConfirmHost({ deps, t }: {
+    deps: DeleteConfirmDeps;
+    t?: Translate;
+}): import("react").JSX.Element | null;

package/lib/types/client/delete-menu-item.d.ts

@@ -0,0 +1,20 @@
+import { type Translate } from './copy.js';
+export interface DeleteMenuItemProps {
+    /** 宿主菜单槽投影的会话 id，原样透给 `sessiondelete/delete`（浏览器半不自己拼 id）。 */
+    sessionId: string;
+    /** 宿主菜单槽投影的 `displayTitle`：只用于确认框与提示文案，不参与任何请求。 */
+    title: string;
+    /** 会话在跑：这一行置灰，并把原因摆在行上。 */
+    live?: boolean;
+    /** 上方那条发丝线；缺省 true。多选入口排在删除前面时由它带线，删除行改成 false（`index.tsx`）。 */
+    separatorBefore?: boolean;
+    /**
+     * 菜单 owner 交下来的「收起菜单」——槽位注入的 `useMenuOpenState`（`index.tsx` 的 `DeleteRow` 接住）。
+     * 「关不关菜单是 owner 的决定」是官方对该槽位的契约；按下这一行时**先发请求、再收菜单**。
+     * 缺省不动，方便单独测这一行。
+     */
+    dismissMenu?: () => void;
+    /** 文案（缺省 = 内置 zh，见 `copy.ts`：这不是"忘了传"，而是"这次没有 locale 服务"）。 */
+    t?: Translate;
+}
+export declare function DeleteMenuItem({ sessionId, title, live, separatorBefore, dismissMenu, t, }: DeleteMenuItemProps): import("react").JSX.Element;

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

@@ -0,0 +1,19 @@
+export declare const name = "@xrn1997/dsh-session-delete/client";
+/**
+ * 只列**宿主公开面保证存在**的成员：`slots` 是浏览器侧槽位注册表
+ * （宿主外壳的冻结平台模块表里的静态键 `@deepseek-ai/dsh-client-ui-slots`），一定在。
+ * 取数通道不在这里——理由见文件头注（它不是 inject 能表达的事，写错了代价是进程死）。
+ * **`locale` 也不在这里**：宿主自己的 `ui-sidebar` 是硬注入它的，但那是"宿主知道自己那一代"的前提；
+ * 本插件要跨代活着 ⇒ 走 `ctx.get('locale')` 可选读，缺席时降级到内置 zh 文案（见 `copy.ts` 头注）。
+ * 写进 inject 就等于"这一代没有 locale 就不让整个客户端条目激活"，而那等于宿主进程死。
+ */
+export declare const inject: string[];
+/**
+ * 入口：**同步返回、绝不抛**（见文件头注）。
+ *
+ * 注册挂在探测的续拍上，两条理由：① 前端启动自检只看 entry 声明的 `inject` 服务齐不齐（`slots`
+ * 一定在），不看它注册了几行；② 槽位注册是注册表的一次 mutation，渲染层按微任务批量订阅
+ * （`SlotCore` 的变更传播契约），晚一拍注册照常上屏——宿主侧栏对 `sidebar.panellist` 正是
+ * `ctx.slots.subscribe("sidebar.panellist", syncPanels)`（asar @44795361）。
+ */
+export declare function apply(ctx: unknown): void;

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

@@ -0,0 +1,11 @@
+import './ui/styles.js';
+/**
+ * `memo` 是必需的而不是优化：`react-markdown@10.1.0` 里**一处 memoization 都没有**（读实
+ * `node_modules/react-markdown/lib/index.js:175-178`——`Markdown()` 每次调用都 `createProcessor(options)`
+ * 再 `runSync(parse(file))`，`MarkdownHooks` 那一支也一样），而面板任何一次重渲（悬停、↑↓、
+ * 「刚刚删除」那句要读 `Date.now()`）都会走到这里 ⇒ 不按住就是每条助手回复每拍重解析一遍。
+ * 按住的条件就只有 `text`：它是这里唯一的输入，样式挂在 `.sd-md` 上、不随渲染变。
+ */
+export declare const MarkdownBody: import("react").NamedExoticComponent<{
+    text: string;
+}>;