@omdp/dsh-archived-sessions 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-archived-sessions contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# @omdp/dsh-archived-sessions
+
+> Archived-sessions manager for the DeepSeek Harness web UI — fork of [`@muwinds/dsh-archived-sessions`](https://github.com/MuWinds/dsh-archived-sessions) (0.2.0), adapted for DSH **0.1.5-rc.1**.
+
+DSH 归档会话管理：在 设置 → 归档会话 中查看、释放、删除已归档会话（支持按树删除子会话、清理孤儿会话）。
+
+[English](#english) · [中文](#中文)
+
+---
+
+## 中文
+
+### 这是什么
+
+DSH 的会话可以归档（移到「归档云店」），本插件在设置页提供归档会话的管理界面：
+
+- **列表**：标题、会话 ID、所属工作区、磁盘占用、创建时间、是否运行中；
+- **释放**：把会话从归档集合移回活动列表（不删数据）；
+- **删除**：从硬盘删除会话目录 + 从归档集合移除（两步确认）；
+- **按树删除**：删除主会话时，其下的 subagent 子会话（`parentSession` 链）一并删除，不再留孤儿（修复上游 issue #2）；
+- **孤儿清理**：一键扫描并清理「父会话已删除、自己还在盘上」的残留子会话目录；
+- **详情**：展开查看会话内容（前 100 条消息）。
+
+### 为什么有这个 fork
+
+上游 `@muwinds/dsh-archived-sessions` 0.2.0 与 DSH **0.1.5-rc.1 不兼容**（作者已一个月未维护）：
+
+| 症状 | 根因 |
+| --- | --- |
+| 归档列表全部显示「文件缺失」 | 0.1.5-rc.1 的 `sessionPersistence.list()` 返回 `SessionPersistenceSnapshot[]`（`{header, revision, eventCount?, sizeBytes?}`），不再是裸 `SessionHeader[]`；插件按旧形状取值，`header.id` 变 `undefined` |
+| 「删除」和「释放」行为相同（都只移除归档标记） | 0.1.5-rc.1 抽象服务移除了 `locate(meta)`；插件 `persistence.locate(header)` 返回 `undefined` → `.path` 抛 TypeError → 被 catch 吞掉 → 走 `no-artifact` 分支，跳过删目录 |
+
+本 fork 的修复：
+
+1. `list()` 改为识别快照形状，从 `snapshot.header` 取值；优先用快照自带的 `sizeBytes`；
+2. 不再依赖 `locate()`，改用 DSH JSONL 后端同款路径编码（`encodeSegment` / `projectKey`）自行解析会话目录，并经 `fs.resolve` 确认存在后才操作；
+3. 删除前校验目录名必须是会话目录（`session-<uuid>` 或裸 UUID），**拒绝删除任何非会话路径**，杜绝误删；
+4. 删除按 `parentSession` 递归收集整棵子树，连同子会话一起删 + 一起移出归档集合；
+5. 新增 `/dsh-archived/orphans` 与 `/dsh-archived/sweep`：扫描/清理孤儿子会话（父会话已不在 persistence 中）。
+
+### 安装
+
+```bash
+pnpm add @omdp/dsh-archived-sessions -w
+```
+
+> 若从 `@muwinds/dsh-archived-sessions` 迁移：先在 profile 的 package.json 中移除旧依赖（`github:MuWinds/dsh-archived-sessions`），再安装本包。旧包与新版 API 路由相同（`/dsh-archived/*`），安装后刷新页面即可。
+
+### 要求 / Requirements
+
+- DeepSeek Harness **0.1.5-rc.1**（实测版本）
+- `@deepseek-ai/cordis` ^4.0.1（peer）
+- `@deepseek-ai/dsh-session-persistence-jsonl`（可选，随 DSH 自带；缺失时回退到内置路径编码）
+
+### API
+
+| 方法 | 请求 | 响应 |
+| --- | --- | --- |
+| `POST /dsh-archived/list` | `{}` | `{ items, totalBytes }` |
+| `POST /dsh-archived/unarchive` | `{ sessionId }` | `{ ok, changed, archivedSessionIds }` |
+| `POST /dsh-archived/delete` | `{ sessionId }` | `{ ok, deleted, sessionId, alsoDeleted[], reason? }` |
+| `POST /dsh-archived/detail` | `{ sessionId }` | `{ id, createdAt, cwd, parentSession, totalEvents, messageCount, truncated, messages }` |
+| `POST /dsh-archived/orphans` | `{}` | `{ items, totalBytes }` |
+| `POST /dsh-archived/sweep` | `{}` | `{ removed, freedBytes, items }` |
+
+### 变更记录
+
+- **0.3.0**（2026-09-10）：fork 自 0.2.0；适配 DSH 0.1.5-rc.1（list 快照形状 + 路径自解析）；按树删除子会话；孤儿清理；删除路径安全校验。
+
+---
+
+## English
+
+### What is this
+
+DSH sessions can be archived; this plugin adds an archived-session manager under **Settings → 归档会话**:
+
+- **List**: title, session ID, workspace, disk usage, created time, running state;
+- **Release** (释放): move a session out of the archive set back to active (no data deleted);
+- **Delete** (删除): delete the session directory from disk + remove from the archive set (two-step confirm);
+- **Tree delete**: deleting a main session also deletes its subagent children (`parentSession` chain) — fixes upstream issue #2;
+- **Orphan sweep**: scan and clean leftover subagent dirs whose parent session is already gone;
+- **Detail**: expand to read the session content (first 100 messages).
+
+### Why this fork
+
+Upstream `@muwinds/dsh-archived-sessions` 0.2.0 is **incompatible with DSH 0.1.5-rc.1** (author unmaintained for a month):
+
+| Symptom | Root cause |
+| --- | --- |
+| All archived items show 文件缺失 (missing) | 0.1.5-rc.1 `sessionPersistence.list()` returns `SessionPersistenceSnapshot[]` (`{header, revision, eventCount?, sizeBytes?}`), not bare `SessionHeader[]`; the plugin read the old shape, so `header.id` was `undefined` |
+| Delete behaves like Release (both only prune the archive id) | 0.1.5-rc.1 removed `locate(meta)` from the abstract service; `persistence.locate(header)` returned `undefined` → `.path` threw TypeError → swallowed by catch → `no-artifact` branch skipped the disk deletion |
+
+Fixes in this fork:
+
+1. `list()` recognizes the snapshot shape and reads `snapshot.header`; prefers the snapshot's `sizeBytes`;
+2. No longer uses `locate()`; resolves the session directory with the same path encoding as the DSH JSONL backend (`encodeSegment` / `projectKey`), confirmed via `fs.resolve`;
+3. Refuses to delete anything whose directory name is not a session dir (`session-<uuid>` or bare UUID) — no accidental deletions;
+4. Delete collects the whole `parentSession` subtree recursively and removes children together (dirs + archive set);
+5. New `/dsh-archived/orphans` and `/dsh-archived/sweep` to scan/clean orphan subagent sessions (parent no longer in persistence).
+
+### Install
+
+```bash
+pnpm add @omdp/dsh-archived-sessions -w
+```
+
+> Migrating from `@muwinds/dsh-archived-sessions`: remove the old dependency (`github:MuWinds/dsh-archived-sessions`) from the profile package.json first, then install this package. Same API routes (`/dsh-archived/*`); refresh the page after installing.
+
+### Requirements
+
+- DeepSeek Harness **0.1.5-rc.1** (tested version)
+- `@deepseek-ai/cordis` ^4.0.1 (peer)
+- `@deepseek-ai/dsh-session-persistence-jsonl` (optional, ships with DSH; falls back to the built-in path encoding when absent)
+
+### API
+
+| Method | Request | Response |
+| --- | --- | --- |
+| `POST /dsh-archived/list` | `{}` | `{ items, totalBytes }` |
+| `POST /dsh-archived/unarchive` | `{ sessionId }` | `{ ok, changed, archivedSessionIds }` |
+| `POST /dsh-archived/delete` | `{ sessionId }` | `{ ok, deleted, sessionId, alsoDeleted[], reason? }` |
+| `POST /dsh-archived/detail` | `{ sessionId }` | `{ id, createdAt, cwd, parentSession, totalEvents, messageCount, truncated, messages }` |
+| `POST /dsh-archived/orphans` | `{}` | `{ items, totalBytes }` |
+| `POST /dsh-archived/sweep` | `{}` | `{ removed, freedBytes, items }` |
+
+### Changelog
+
+- **0.3.0** (2026-09-10): forked from 0.2.0; DSH 0.1.5-rc.1 support (snapshot list shape + self path resolution); tree delete; orphan sweep; deletion path safety check.
+
+## License
+
+MIT — original by MuWinds (upstream package), fork maintained by XJungit.

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh bundle patch: inserts this plugin into a profile's layer stack.
+# One row drives both halves: the host API (lib/index.js, injects webServer)
+# and the browser UI (lib/client.js, discovered through the dsh.client
+# declaration in package.json).
+- insert:
+    - id: archived-sessions
+      name: '@omdp/dsh-archived-sessions'

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@omdp/dsh-archived-sessions",
+  "version": "0.3.0",
+  "description": "Archived-sessions manager for the DeepSeek Harness web UI: list / unarchive / delete / detail from Settings. · DSH 归档会话管理：设置页查看、释放、删除已归档会话（含按树删除子会话与孤儿清理）。",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "archived-sessions",
+    "session-management"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XJungit/omdp.git",
+    "directory": "dsh-archived-sessions"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  }
+}