dsh-ui-tweaks 0.3.1 → 0.4.0

package/README.en.md

@@ -1,96 +1,102 @@
-# dsh-ui-tweaks
-
-A [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) (DSH) web plugin that live-tunes the conversation UI from the Settings panel.
-
-## Preview
-
-| | |
-|---|---|
-| ![Conversation timeline](assets/timeline.png) | ![Claude Desktop table style](assets/table.png) |
-| **Conversation timeline**: right-side rail — hover to preview messages, click to jump, scroll-highlighting, auto-dodges a right sidebar | **Table style**: the Claude Desktop look (light-gray rounded cards) |
-| ![Dialog width](assets/dialog_box.png) | ![Settings panel](assets/settings.png) |
-| **Dialog width**: message column, composer and stats line widen together | **Settings panel**: font size / table style / dialog width / timeline |
-
-## Features
-
-- **Message font size (px)** — type any value (10–32); applies to message text, headings, tables and code.
-- **Table style** — choose `Default` or the **Claude Desktop** look (light-gray rounded cell cards with small gaps, no borders; cells share the inline-code background; header not bold).
-- **Dialog width (px)** — type any value (600–1600); the message column, the composer input and the stats line below it widen together.
-- **Conversation timeline (toggleable, off by default)** — a thin navigation rail at the right of the message area: one indicator line per user message, hover to expand a preview panel, scroll-highlighting of the current position, click to smooth-scroll to that message (loading older history on demand). Works in **light and dark mode**, and **always hugs the message area's right edge** — even with a right sidebar installed and expanded (e.g. dsh-better-sidebar), the rail dodges it instead of overlapping. Auto-hidden while a session has fewer than two user messages.
-
-All changes apply **live** — no reload needed. The same values can be hand-edited in the settings document:
-
-```yaml
-ui-tweaks:
-  fontSize: 16
-  tableStyle: claude
-  dialogWidth: 880
-  timelineEnabled: true   # defaults to false (off); set true to enable
-```
-
-Settings entry: **Settings → UI Tweaks**.
-
-## Install
-
-```bash
-# from npm (recommended, prebuilt)
-npx -y @deepseek-ai/dsh plugin --profile web add dsh-ui-tweaks
-
-# from GitHub (source; runs the self-contained prepare build)
-npx -y @deepseek-ai/dsh plugin --profile web add github:wlj521/dsh-ui-tweaks
-```
-
-For GitHub installs, pnpm may ask you to approve the package's build script —
-add the exact key it prints to the profile's `pnpm-workspace.yaml`:
-
-```yaml
-allowBuilds:
-  dsh-ui-tweaks: true
-```
-
-…then run `add` again. Restart DSH web once after installing (bundle plugins
-are scanned at process start).
-
-> If pnpm reports symlink/hoist errors, set `nodeLinker: hoisted` in the
-> profile's `pnpm-workspace.yaml`.
-
-## Development
-
-```bash
-pnpm install
-pnpm build          # tsc (server) + tsc (client) + bundle lib/client.js
-pnpm typecheck
-```
-
-Load against a running DSH with an overlay, or install as a bundle:
-
-```bash
-npx -y @deepseek-ai/dsh web --patch ./cordis.patch.yml   # dev overlay
-npx -y @deepseek-ai/dsh plugin --profile web add .        # bundle install from this checkout
-```
-
-## How it works
-
-- **Server** (`src/index.ts`) registers the `ui-tweaks` settings namespace and
-  mounts a same-origin route (`/_dsh/ui-tweaks/settings`) — the Web settings
-  RPC only exposes a fixed allowlist of namespaces in rc.6, so a custom route
-  is how a plugin owns a configuration page. `src/timeline.ts` also registers
-  the `dshChatTimeline` session projection that durably enumerates user
-  messages.
-- **Browser** (`src/client/index.tsx`) reads/writes that route, renders the
-  Settings section, and applies the values live via a runtime `<style>` element
-  that overrides stable DSH anchors (`[data-chat-flow]`,
-  `[data-composer-card]`, `body` markdown font tokens, markdown tables inside
-  `[data-slot="conversation.chat.node"]`).
-- **Timeline** (`src/client/timeline.tsx`) mounts in the
-  `conversation.input.dock` slot and portals to `body`. Data sources, fastest
-  first: session projection → loaded chat nodes → background `loadOlder`. Its
-  position is anchored by measuring the right edge and vertical center of
-  `[data-conversation-scroll]` (the message area), so it follows both the DSH
-  column grid and any right-sidebar layout push (`#root` margin-right);
-  colors ride DSH theme tokens (`--dsw-alias-*`) for correct light/dark
-  rendering.
-
-## License
-
-MIT
+# dsh-ui-tweaks
+
+A [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/) (DSH) web plugin that live-tunes the conversation UI from the Settings panel.
+
+## Preview
+
+| | |
+|---|---|
+| ![Conversation timeline](assets/timeline.png) | ![Claude Desktop table style](assets/table.png) |
+| **Conversation timeline**: right-side rail — hover to preview messages, click to jump, scroll-highlighting, auto-dodges a right sidebar | **Table style**: the Claude Desktop look (light-gray rounded cards) |
+| ![Dialog width](assets/dialog_box.png) | ![Settings panel](assets/settings.png) |
+| **Dialog width**: message column, composer and stats line widen together | **Settings panel**: font size / table style / dialog width / timeline |
+
+## Features
+
+- **Message font size (px)** — type any value (10–32); applies to message text, headings, tables and code.
+- **Table style** — choose `Default` or the **Claude Desktop** look (light-gray rounded cell cards with small gaps, no borders; cells share the inline-code background; header not bold).
+- **Dialog width (px)** — type any value (600–1600); the message column, the composer input and the stats line below it widen together.
+- **Conversation timeline (toggleable, off by default)** — a thin navigation rail at the right of the message area: one indicator line per user message, hover to expand a preview panel, scroll-highlighting of the current position, click to smooth-scroll to that message (loading older history on demand). Works in **light and dark mode**, and **always hugs the message area's right edge** — even with a right sidebar installed and expanded (e.g. dsh-better-sidebar), the rail dodges it instead of overlapping. Auto-hidden while a session has fewer than two user messages.
+- **Archive manager (toggleable, off by default)** — an **Archive** page in the Settings dialog listing archived sessions (title / workspace / relative time) with per-row **Restore** and **Delete** actions plus batch **Restore all** / **Delete all** buttons.
+  - **Restore** removes a session from the archive set (its log and workspace slot are kept, so the conversation returns to the normal sidebar list).
+  - **Delete** PERMANENTLY deletes the session — the server removes its JSONL log from disk, detaches it from workspace accounting and the archive set, and clears its projection cache (irreversible). Only genuinely **running** sessions are refused; opened-but-idle sessions are also removed from the in-memory store, so the row disappears live.
+  - The list refreshes live via the `host/archived-sessions-changed` event and a session-list re-pull, with no page reload.
+- **MCP manager (toggleable, off by default)** — an **MCP** page in the Settings dialog listing every configured MCP server (`@deepseek-ai/dsh-mcp-client` loader entries) with its live status, command/url, env vars and registered tools, plus full management: **Add / Edit** (a structured form — instance id, name, stdio or HTTP type, timeout ms, command, args, env — OR raw YAML, both validated), **Enable / Disable / Delete**, and **Restart** (runtime-only). Changes persist to the profile's `cordis.patch.yml` and DSH's built-in patch watcher hot-reloads just that server.
+
+All changes apply **live** — no reload needed. The same values can be hand-edited in the settings document:
+
+```yaml
+ui-tweaks:
+  fontSize: 16
+  tableStyle: claude
+  dialogWidth: 880
+  timelineEnabled: true   # defaults to false (off); set true to enable
+  archiveManagerEnabled: true   # defaults to false (off); set true to show the Archive page
+```
+
+Settings entry: **Settings → UI Tweaks**.
+
+## Install
+
+```bash
+# from npm (recommended, prebuilt)
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-ui-tweaks
+
+# from GitHub (source; runs the self-contained prepare build)
+npx -y @deepseek-ai/dsh plugin --profile web add github:wlj521/dsh-ui-tweaks
+```
+
+For GitHub installs, pnpm may ask you to approve the package's build script —
+add the exact key it prints to the profile's `pnpm-workspace.yaml`:
+
+```yaml
+allowBuilds:
+  dsh-ui-tweaks: true
+```
+
+…then run `add` again. Restart DSH web once after installing (bundle plugins
+are scanned at process start).
+
+> If pnpm reports symlink/hoist errors, set `nodeLinker: hoisted` in the
+> profile's `pnpm-workspace.yaml`.
+
+## Development
+
+```bash
+pnpm install
+pnpm build          # tsc (server) + tsc (client) + bundle lib/client.js
+pnpm typecheck
+```
+
+Load against a running DSH with an overlay, or install as a bundle:
+
+```bash
+npx -y @deepseek-ai/dsh web --patch ./cordis.patch.yml   # dev overlay
+npx -y @deepseek-ai/dsh plugin --profile web add .        # bundle install from this checkout
+```
+
+## How it works
+
+- **Server** (`src/index.ts`) registers the `ui-tweaks` settings namespace and
+  mounts a same-origin route (`/_dsh/ui-tweaks/settings`) — the Web settings
+  RPC only exposes a fixed allowlist of namespaces since rc.6, so a custom route
+  is how a plugin owns a configuration page. `src/timeline.ts` also registers
+  the `dshChatTimeline` session projection that durably enumerates user
+  messages.
+- **Browser** (`src/client/index.tsx`) reads/writes that route, renders the
+  Settings section, and applies the values live via a runtime `<style>` element
+  that overrides stable DSH anchors (`[data-chat-flow]`,
+  `[data-composer-card]`, `body` markdown font tokens, markdown tables inside
+  `[data-slot="conversation.chat.node"]`).
+- **Timeline** (`src/client/timeline.tsx`) mounts in the
+  `conversation.input.dock` slot and portals to `body`. Data sources, fastest
+  first: session projection → loaded chat nodes → background `loadOlder`. Its
+  position is anchored by measuring the right edge and vertical center of
+  `[data-conversation-scroll]` (the message area), so it follows both the DSH
+  column grid and any right-sidebar layout push (`#root` margin-right);
+  colors ride DSH theme tokens (`--dsw-alias-*`) for correct light/dark
+  rendering.
+
+## License
+
+MIT

package/README.md

@@ -1,6 +1,6 @@
 # dsh-ui-tweaks
 
-[DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/)（DSH）Web UI 插件：在设置面板中实时调整对话界面——字体大小、表格样式、对话框宽度、可开关的对话时间线，以及输入框上方的 **GitBar**（git 状态胶囊：分支 / 差异 / 提交）。
+[DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/)（DSH）Web UI 插件：在设置面板中实时调整对话界面——字体大小、表格样式、对话框宽度、可开关的对话时间线、输入框上方的 **GitBar**（git 状态胶囊：分支 / 差异 / 提交），以及可开关的**归档管理**（设置中的「归档」页面：查看、恢复或彻底删除已归档会话）。
 
 ## 预览
 
@@ -19,11 +19,19 @@
 - **表格样式**：可选 `默认` 或 **Claude Desktop** 风格（浅灰圆角单元格卡片、单元格间有间隙、无边框、单元格与行内代码同底色、表头不加粗）。
 - **对话框宽度（px）**：直接输入数字（600–1600）；消息列、输入框、输入框下方的统计栏（轮数/步数/耗时/tok/s）**三者同步变宽**。
 - **对话时间线（可开关，默认关闭）**：在消息区右侧显示细竖导航轨——每条用户消息一根指示线，悬停展开面板预览消息、随滚动高亮当前位置、点击平滑跳转到对应消息（自动加载更早历史）。**浅色/深色模式都正常显示**，且**始终贴在消息区右侧**：即使安装了右侧边栏（如 dsh-better-sidebar）并展开，时间线也会自动避让、不会与侧边栏重叠。会话中用户消息少于 2 条时自动隐藏。
-- **GitBar（默认开启，可在设置中关闭）**：当会话的工作目录是一个 git 仓库时，在输入框上方显示三颗 DSH 原生风格的紧凑胶囊（与输入框同宽、随“对话框宽度”设置联动）：
+- **GitBar（默认关闭，可在设置中开启）**：当会话的工作目录是一个 git 仓库时，在输入框上方显示三颗 DSH 原生风格的紧凑胶囊（与输入框同宽、随“对话框宽度”设置联动）：
   - **分支胶囊（左）**：当前分支名（有未提交改动时带橙色圆点）；点击**向上**弹出分支面板——本地 / 远程分支列表（点击即 `git switch`），底部可**新建分支**（`git switch -c` 并自动切换）。
   - **差异胶囊（右）**：`+N −M · K 个文件`；点击从右侧滑出**差异面板**：文件列表 + 逐文件 diff（默认**只显示有差异的 hunk**，右上可切“完整文件”视图）。面板**支持拖动拉伸宽度**，展开时**自动把对话区往左挤**（不影响右侧时间线），底部可直接**提交 / 提交并推送**。面板内三段（文件列表 / diff 内容 / 提交区）之间的分隔线**可上下拖动调整高度**（双击复位；提交说明框随提交区高度拉伸，可写多行，Shift+Enter 换行）。
   - **commit message 胶囊（右）**：点击弹出提交对话框——输入说明（**留空点提交会自动生成**，LLM 优先、失败回退启发式规则）、待提交文件清单（只显示文件与 ±行数，**点击文件即打开差异面板定位到该文件**），按钮：取消 / ✨ 生成 / 提交 / 提交并推送（新分支自动 `-u` 设上游）。
   - 非 git 仓库或无会话 cwd 时整行自动隐藏；所有操作走服务端 `execFile('git', …)`（无 shell、带超时）。
+- **归档管理（可开关，默认关闭）**：设置面板中的「归档」页面，列出所有已归档会话（标题 / 所在工作区 / 相对时间），支持**恢复**与**彻底删除**：
+  - **恢复**：把会话移出归档——日志与工作区槽位原样保留，会话回到侧边栏列表。
+  - **删除**：**彻底删除**该会话——服务端将其 JSONL 日志从磁盘移除、从工作区记账与归档集合中清除、并清理投影缓存，会话永久消失（不可恢复）。只有**正在运行**（有任务在跑）的会话会被拒绝；已打开但空闲的会话也会从内存中移除，删除后实时从列表消失。
+  - 顶部另有**全部恢复 / 全部删除**批量操作（删除类操作需二次确认）。列表随 `host/archived-sessions-changed` 事件与客户端会话列表刷新实时更新，无需刷新页面。
+- **MCP 管理（可开关，默认关闭）**：设置面板中的「MCP 管理」页面，展示 profile 里配置的所有 MCP 服务器（`@deepseek-ai/dsh-mcp-client` 实例）及其状态（运行中 / 错误 / 加载中 / 未运行 / 已停用）、命令、环境变量、已注册工具，并支持完整管理：
+  - **添加 / 编辑**：编辑器支持**表单**（实例 ID / 名称 / 类型 stdio 或 HTTP / 超时时间 ms / 命令 / 参数 / 环境变量 / URL / 请求头）或直接**粘贴 YAML** 两种方式，保存前会做格式校验（名称与 ID 字符集、超时正整数、URL 协议、命令非空、未知 YAML 字段等）。
+  - **启用 / 停用 / 删除 / 重启**：改动直接写入 profile 的 `cordis.patch.yml`（保持注释与结构），DSH 内置补丁监视器热重载加载器——被改动的那个服务器**实时**启动/停止/重启，不影响其它服务器；重启单独运行时生效、不改配置。环境变量值仅在本机浏览器可见，用于编辑。
+  - 新增后请确认服务器能成功连接（状态为「运行中」并注册了工具）；启动失败的实例会显示「错误」并可重启重试。
 
 所有修改**即时生效**，无需刷新。同一份配置也可以直接在设置文档里手改：
 
@@ -33,7 +41,8 @@ ui-tweaks:
   tableStyle: claude
   dialogWidth: 880
   timelineEnabled: true   # 默认 false（关闭），设为 true 开启
-  gitBarEnabled: false    # 默认 true（开启），设为 false 关闭 GitBar
+  gitBarEnabled: true     # 默认 false（关闭），设为 true 开启 GitBar
+  archiveManagerEnabled: true   # 默认 false（关闭），设为 true 开启「归档」页面
   # suggestModel: 'provider:model'   # 可选：指定生成提交说明的模型
 ```
 
@@ -77,11 +86,13 @@ npx -y @deepseek-ai/dsh plugin --profile web add .        # 从本目录作为 b
 
 ## 工作原理
 
-- **服务端**（`src/index.ts`）：注册 `ui-tweaks` 设置命名空间，并挂载同源路由 `/_dsh/ui-tweaks/settings`——rc.6 的 Web 设置 RPC 只暴露固定白名单命名空间，因此自定义路由是插件拥有配置页的方式。另在 `src/timeline.ts` 注册 `dshChatTimeline` 会话投影单元，持久化枚举用户消息。
+- **服务端**（`src/index.ts`）：注册 `ui-tweaks` 设置命名空间，并挂载同源路由 `/_dsh/ui-tweaks/settings`——自 rc.6 起，Web 设置 RPC 只暴露固定白名单命名空间，因此自定义路由是插件拥有配置页的方式。另在 `src/timeline.ts` 注册 `dshChatTimeline` 会话投影单元，持久化枚举用户消息。
 - **Git 后端**（`src/git.ts` + `src/git-web.ts`）：通过 `ctx.get('sessions')`（可选服务）解析会话 header 的 `cwd` 作为“当前项目”，用 `child_process.execFile('git', …)`（无 shell、cwd 固定、超时 + 中止传播）执行只读/写操作；同源路由 `/_dsh/ui-tweaks/git/*` 提供 status / branches / diff（hunk 或完整文件，含绝对行号）/ suggest / commit / push / checkout / create。提交说明生成优先走 `ctx.get('llm')`（可选服务，收集 `text-delta` 流），不可用时回退到启发式规则（按文件类型推断 conventional commit 类型与 scope）。
 - **浏览器端**（`src/client/index.tsx`）：读写该路由、渲染设置页，并通过运行时 `<style>` 元素实时应用样式，覆盖稳定的 DSH 锚点（`[data-chat-flow]`、`[data-composer-card]`、`body` 上的 markdown 字体 token、`[data-slot="conversation.chat.node"]` 内的 markdown 表格）。
 - **时间线**（`src/client/timeline.tsx`）：挂在 `conversation.input.dock` 插槽、portal 到 `body`。数据按速度优先：会话投影 → 已加载聊天节点 → 后台 `loadOlder`。位置通过测量 `[data-conversation-scroll]`（消息区）右缘与垂直中线动态锚定，因此 DSH 原生列布局与右侧边栏（`#root` 的 margin-right 布局推挤）变化时都会自动跟随；颜色全部使用 DSH 主题变量（`--dsw-alias-*`），浅色/深色模式均正常。
 - **GitBar**（`src/client/gitbar.tsx`）：挂在同一个 `conversation.input.dock` 插槽。胶囊行以 `width:100%` + `max-width` 与 composer 卡片同宽（buildRuntimeCss 在“对话框宽度”变化时同步覆盖该宽度，实现联动），胶囊行自身背景透明、只有胶囊可见；差异面板展开时通过 `#root { margin-right }` 把对话区往左挤，时间线 rail（锚定消息区右缘）因此不被遮挡。面板内的高度分配采用「只给被拖的那一段显式高度、diff 段 `flex:1` 吃掉余量」的方式，配合 45% 上限，拖动永远不会撑破面板。
+- **归档管理**（服务端 `src/archive.ts` + 浏览器端 `src/client/archive.tsx`）：作为 `settings.section` 插槽（设置面板中的「归档」页面）。列表数据直接来自框架标准 hook `useSessions` + `useWorkspaces`（`archivedSessionIds`），无需额外查询；操作走同源路由 `/_dsh/ui-tweaks/archive`。**恢复**把会话 id 从工作区存储域的 `archivedSessionIds` 全局单例中移除（DSH 只暴露单向 `archiveSession`，无公开的取消归档 API，故直接写活体存储域句柄并同步工作区注册表的内存缓存）。**彻底删除**依次：拒绝正在运行的会话（agent `status === 'running'` 才拒绝，空闲会话先 `cancel` + `whenIdle`）→ 用持久化后端自身的 `findLog` 定位并 `rm` 会话日志目录 → 调用公开的 `WorkspaceEntity.detachSession` 摘除工作区记账 → 从归档集合移除并同步注册表内存缓存与 header 索引 → 清理 `session_projcache` → 从内存 SessionStore 摘除该会话（触发 `host/session-removed` 实时消失）。
+- **MCP 管理**（服务端 `src/mcp.ts` + 浏览器端 `src/client/mcp.tsx`）：同源路由 `/_dsh/ui-tweaks/mcp`。**列表**枚举 `ctx.loader.entries()` 中 `@deepseek-ai/dsh-mcp-client` 实例（id / config / fiber 状态：active=2、failed=3 等）并按 `mcp__<serverName>__` 前缀从工具注册表统计工具。**重启**调用 `entry.fiber.restart()`（仅运行时）。**添加 / 编辑 / 删除 / 启用停用**通过 `yaml`（eemeli）的 Document API 直接编辑 profile 的 `cordis.patch.yml`（保留注释与未知补丁结构，原子写 tmp+rename），随后由 DSH 内置的 `watchUserPatches` 热重载监视器重新应用补丁——`cordis-plugin-include` 对根组做**增量** `root.update`，因此只有被改动的 MCP 实例会重启，其它不受影响；环境变量值返回给同源浏览器（本机配置编辑需要），YAML 模式在服务端用 `yaml.parse` + 白名单校验。
 
 ## 协议
 

package/lib/archive.js

@@ -0,0 +1,242 @@
+/**
+ * dsh-ui-tweaks — archive manager (host half).
+ *
+ * The browser Archive manager (the "归档" settings section, shown when the
+ * archiveManagerEnabled setting is on) lists archived sessions and offers
+ * two per-session actions plus batch actions through this same-origin route:
+ *
+ * - **restore** / **restore-all**: move a session out of the archive set. The
+ *   session log and its workspace accounting slot are kept untouched, so the
+ *   conversation reappears in the normal sidebar list.
+ * - **delete** / **delete-all**: PERMANENTLY delete a session — its durable
+ *   JSONL log is removed from disk, it is detached from every workspace's
+ *   accounting, removed from the archive set, dropped from the workspace
+ *   registry's in-memory header index, and best-effort-cleaned from the
+ *   session projection cache. Only a genuinely RUNNING agent is refused;
+ *   opened-but-idle sessions are also removed from the in-memory SessionStore
+ *   so they vanish from the live list immediately (the host relays
+ *   `session/disposed` as `host/session-removed`).
+ *
+ * DSH has no public API for either operation. The archive set lives in the
+ * `workspace` storage domain's global singleton (the same record
+ * `WorkspaceRegistry` keeps in memory), so this backend writes the filtered
+ * set through the live domain handle (`ctx.storageDomain.get('workspace')`)
+ * and keeps the registry's in-memory cache coherent in the same write, so the
+ * registry's next mutation cannot resurrect a restored id. Session-log
+ * deletion uses the persistence backend's own locator (`findLog`) so only the
+ * exact encoded session directory is removed; workspace accounting removal
+ * uses the registry's public `WorkspaceEntity.detachSession`.
+ * @module dsh-ui-tweaks/archive
+ */
+import { rm } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { workspaceDomainState } from '@deepseek-ai/dsh-workspace';
+import { isRecord, json, messageOf, readJson, requestError, sameOriginPost } from "./web.js";
+/** Exact route used by the browser Archive panel. */
+export const ARCHIVE_ROUTE = '/_dsh/ui-tweaks/archive';
+/** A live session was targeted by a permanent delete. */
+export class SessionLiveError extends Error {
+    code = 'session-live';
+    constructor() {
+        super('cannot permanently delete a live session: close it first');
+        this.name = 'SessionLiveError';
+    }
+}
+function parseRequest(value) {
+    if (!isRecord(value))
+        throw new TypeError('request body must be an object');
+    if (value.action === 'restore' || value.action === 'delete') {
+        const sessionId = value.sessionId;
+        if (typeof sessionId !== 'string' || sessionId.length === 0)
+            throw new TypeError('sessionId must be a non-empty string');
+        return { action: value.action, sessionId };
+    }
+    if (value.action === 'restore-all' || value.action === 'delete-all')
+        return { action: value.action };
+    throw new TypeError('action must be "restore", "delete", "restore-all" or "delete-all"');
+}
+/** Same-origin Archive read/write handler. */
+export class ArchiveBackend {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    registry() {
+        return this.ctx.get('workspaceRegistry');
+    }
+    storageDomain() {
+        return this.ctx.get('storageDomain');
+    }
+    snapshot() {
+        const archivedSessionIds = [...(this.registry()?.archivedSessionIds ?? [])];
+        return { archivedSessionIds };
+    }
+    /** Remove one (or all) ids from the durable archive set, syncing the
+     * registry's in-memory cache in the same write. */
+    async writeArchiveSet(registry, keep) {
+        const global = this.storageDomain()?.get('workspace')?.global;
+        if (global === undefined)
+            throw new Error('workspace storage domain is unavailable');
+        const state = workspaceDomainState.parse(global.get());
+        const next = {
+            ...state,
+            archivedSessionIds: state.archivedSessionIds.filter(keep),
+        };
+        if (next.archivedSessionIds.length === state.archivedSessionIds.length)
+            return;
+        await global.set(next);
+        // Keep the registry's in-memory cache coherent so its next write (e.g.
+        // another archive, a workspace create) does not resurrect the ids.
+        registry.state = next;
+    }
+    /** Restore one session: remove it from the durable archive set. */
+    async restore(sessionId) {
+        const registry = this.registry();
+        if (registry === undefined)
+            throw new Error('workspace registry is unavailable');
+        if (!registry.archivedSessionIds.includes(sessionId))
+            return;
+        await this.writeArchiveSet(registry, id => id !== sessionId);
+    }
+    /** Restore every archived session at once. */
+    async restoreAll() {
+        const registry = this.registry();
+        if (registry === undefined)
+            throw new Error('workspace registry is unavailable');
+        if (registry.archivedSessionIds.length === 0)
+            return;
+        await this.writeArchiveSet(registry, () => false);
+    }
+    /** Permanently delete one session: log, accounting, archive set, and caches. */
+    async deleteSession(sessionId) {
+        // Refuse only a genuinely RUNNING agent. Sessions that were merely opened
+        // (and archived) stay attached to the in-memory SessionStore while idle —
+        // refusing every attached session would make most archived sessions
+        // undeletable.
+        const agents = this.ctx.get('agents');
+        const agent = agents?.get(sessionId);
+        if (agent !== undefined && agent.status === 'running')
+            throw new SessionLiveError();
+        if (agent !== undefined) {
+            // Clear any queued work and let the (idle) agent settle before the log
+            // is removed.
+            agent.cancel({ kind: 'user' });
+            await agent.whenIdle();
+        }
+        // 1. Remove the durable session log (its parent directory) from disk.
+        const persistence = this.ctx.get('sessionPersistence');
+        if (persistence?.findLog !== undefined) {
+            const logPath = await persistence.findLog(sessionId);
+            if (logPath !== undefined)
+                await rm(dirname(logPath), { recursive: true, force: true });
+        }
+        // 2. Detach from every workspace's accounting (public entity API), then
+        //    remove from the archive set, then forget it in the registry's
+        //    in-memory header index so membership checks drop it without restart.
+        const registry = this.registry();
+        if (registry !== undefined) {
+            for (const workspace of registry.list()) {
+                if (workspace.sessionIds.includes(sessionId))
+                    await workspace.detachSession(sessionId);
+            }
+            await this.writeArchiveSet(registry, id => id !== sessionId);
+            registry.headers?.delete(sessionId);
+            registry.sessionPaths?.delete(sessionId);
+        }
+        // 3. Best-effort: drop the session's projection-cache checkpoint.
+        const table = this.storageDomain()?.get('session_projcache')?.table?.('sessions');
+        if (table?.delete !== undefined)
+            await table.delete(sessionId);
+        // 4. Drop the (idle) session from the in-memory SessionStore so it
+        //    vanishes from the live list immediately: the store's entry detach
+        //    fires `session/disposed`, which the host relays as
+        //    `host/session-removed` and the browser forgets the session. The
+        //    agent's own lifecycle stays registered until process end — it is
+        //    idle, unreachable, and cleared by the next restart.
+        const sessions = this.ctx.get('sessions');
+        sessions?.store?.get(sessionId)?.detach?.();
+    }
+    /** Permanently delete every archived session (live ones are skipped). */
+    async deleteAll() {
+        const registry = this.registry();
+        if (registry === undefined)
+            throw new Error('workspace registry is unavailable');
+        const archived = [...registry.archivedSessionIds];
+        let deleted = 0;
+        let skipped = 0;
+        for (const id of archived) {
+            try {
+                await this.deleteSession(id);
+                deleted += 1;
+            }
+            catch (error) {
+                skipped += 1;
+                this.ctx.logger.warn('dsh-ui-tweaks archive delete skipped %s: %s', id, messageOf(error));
+            }
+        }
+        return { deleted, skipped };
+    }
+    /** Handle the exact Archive route. */
+    async handle(req, res) {
+        if (req.method === 'GET') {
+            try {
+                json(res, 200, { ok: true, value: this.snapshot() });
+            }
+            catch (error) {
+                this.ctx.logger.warn('dsh-ui-tweaks Archive snapshot failed: %s', messageOf(error));
+                requestError(res, 503, 'archive-unavailable', 'UI Tweaks archive is unavailable');
+            }
+            return;
+        }
+        if (req.method !== 'POST') {
+            res.setHeader('Allow', 'GET, POST');
+            requestError(res, 405, 'method-not-allowed', 'Use GET or POST');
+            return;
+        }
+        if (!sameOriginPost(req)) {
+            requestError(res, 403, 'origin-rejected', 'The request must originate from this DSH Web application');
+            return;
+        }
+        let request;
+        try {
+            request = parseRequest(await readJson(req));
+        }
+        catch (error) {
+            requestError(res, 400, 'invalid-request', messageOf(error));
+            return;
+        }
+        try {
+            if (request.action === 'restore')
+                await this.restore(request.sessionId);
+            else if (request.action === 'restore-all')
+                await this.restoreAll();
+            else if (request.action === 'delete')
+                await this.deleteSession(request.sessionId);
+            else
+                await this.deleteAll();
+            json(res, 200, { ok: true, value: this.snapshot() });
+        }
+        catch (error) {
+            const live = error instanceof SessionLiveError;
+            this.ctx.logger.warn('dsh-ui-tweaks Archive mutation failed: %s', messageOf(error));
+            requestError(res, live ? 409 : 400, live ? 'session-live' : 'archive-rejected', messageOf(error));
+        }
+    }
+}
+/**
+ * Attach the Archive route whenever a webServer service is present.
+ * @param ctx - plugin context owning route effects.
+ * @param backend - Archive handler.
+ */
+export function installArchiveWeb(ctx, backend) {
+    ctx.inject(['webServer'], (webCtx) => {
+        webCtx.effect(() => {
+            return webCtx.webServer.register({
+                kind: 'exact',
+                path: ARCHIVE_ROUTE,
+                handler: (req, res) => backend.handle(req, res),
+            });
+        }, 'dsh-ui-tweaks: Archive routes');
+    });
+}
+//# sourceMappingURL=archive.js.map

package/lib/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../src/archive.ts"],"names":[],"mappings":"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"}