dsh-session-mgr 0.6.8 → 0.6.9

package/CHANGELOG.md

@@ -4,6 +4,26 @@
 
 All notable changes to `dsh-session-mgr` are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.6.9] - 2026-11-14
+
+### 中文
+
+#### 修复
+- **移动「已打开但闲置」的会话后，它不再变成僵尸。** 以前只把会话从内存的 session store 逐出，它的 Agent 仍留在 agent registry 里，会拿着搬移前的 `cwd` 与旧事件继续「接收」后续提示——提示看似被接受，实际上既不回覆也不写入磁盘。现在会先注销 Agent 再逐出会话，下次打开会从改写后的磁盘 header 重新开始。感谢 [@deathbypain](https://github.com/deathbypain) 回报并修复（[#8](https://github.com/mienfong/dsh-session-mgr/issues/8) / [#7](https://github.com/mienfong/dsh-session-mgr/pull/7)）。
+- **DSH 0.2.2+ 上，会话标题栏的「移动」对话框不再被裁掉。** 0.2.2 起标题栏是自带 clipping 的容器，插件原本的 `position: fixed` 覆盖层被裁掉而看不见；现在改用应用提供的 portaled Modal 渲染。若较旧的 DSH 没有该模组，仍回退到原本的覆盖层（不会因此载入失败）。感谢 [@deathbypain](https://github.com/deathbypain) 回报并修复（[#10](https://github.com/mienfong/dsh-session-mgr/issues/10) / [#9](https://github.com/mienfong/dsh-session-mgr/pull/9)）。
+
+#### 变更
+- 安全说明补充「移动时会一并注销 Agent」；`detachLive` 现在导出并附回归测试（`scripts/test-move.mjs`）。
+
+### English
+
+#### Fixes
+- **A session moved while open-but-idle no longer turns into a zombie.** Previously only the session was evicted from the in-memory session store, while its Agent stayed in the agent registry and kept "accepting" later prompts against its pre-move `cwd` and stale event history — the prompts looked accepted but produced no reply and nothing was persisted. The Agent is now unregistered before the session is evicted, so the next open resumes from the rewritten on-disk header. Reported and fixed by [@deathbypain](https://github.com/deathbypain) ([#8](https://github.com/mienfong/dsh-session-mgr/issues/8) / [#7](https://github.com/mienfong/dsh-session-mgr/pull/7)).
+- **On DSH 0.2.2+ the move dialog in the conversation header is no longer clipped away.** Since 0.2.2 the header is its own clipped container, so the plugin's `position: fixed` overlay was invisible; it now renders through the app's portaled Modal primitive. Harness builds without that module fall back to the plugin's own overlay instead of failing to load. Reported and fixed by [@deathbypain](https://github.com/deathbypain) ([#10](https://github.com/mienfong/dsh-session-mgr/issues/10) / [#9](https://github.com/mienfong/dsh-session-mgr/pull/9)).
+
+#### Changed
+- Safety notes now say the Agent is unregistered on move; `detachLive` is exported and covered by a regression test (`scripts/test-move.mjs`).
+
 ## [0.6.8] - 2026-10-04
 
 ### 中文

package/README.EN.md

@@ -143,7 +143,7 @@ Archive/unarchive uses the registry-global archive set; an archived session keep
 ## Safety
 
 - **Running** sessions cannot be moved / archived / backed up / deleted (checked via the `agents` service).
-- Idle live sessions are evicted from memory before a move/delete so the next open reads the new header.
+- Idle live sessions are evicted from memory before a move/delete so the next open reads the new header. The session's Agent is also unregistered from the agent registry, so a move never leaves a stale in-memory Agent that would shadow later prompts for that session.
 - Existing files/folders with the same name at the destination are **refused** (no silent overwrite).
 - Cross-volume (EXDEV) moves fall back to copy + delete source.
 - Delete requires a **double confirmation** and is irreversible — a backup is recommended.

package/README.md

@@ -145,7 +145,7 @@ DSH 的「工作区」本质上是文件夹：会话通过 session header 的 `c
 ## 安全机制
 
 - **运行中**的会话不可移动／归档／备份／删除（通过 `agents` 服务判断）。
-- 已打开（live）但闲置的会话在移动／删除前会先从内存卸载，下次打开读取新 header。
+- 已打开（live）但闲置的会话在移动／删除前会先从内存卸载，下次打开读取新 header；其 Agent 同时会从 agent registry 注销，避免残留的内存 Agent 接管该会话后续的提示。
 - 目标位置已存在同名文件／文件夹时**拒绝**并报错（不会静默覆盖）。
 - 跨磁盘（EXDEV）移动时自动改为复制＋删除来源。
 - 删除需要**二次确认**且不可恢复——建议先备份。

package/lib/client.js

@@ -18,6 +18,17 @@ window.__ModuleLoader__.load({
     var exports = module.exports;
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     let react = require("react");
+    // The conversation header (DSH >= 0.2.2) owns a clipped region with its own
+    // compositor layer, so slot overlays have to render through the app's
+    // portaled Modal primitive to stay outside that clip. Older harness builds
+    // do not expose the primitives package at all: keep loading there and fall
+    // back to the plugin's own fixed overlay instead of failing the whole client.
+    let primitives;
+    try {
+      primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+    } catch {
+      primitives = undefined;
+    }
 
     // ---------- styles ----------
     var STYLE_ID = "dsh-session-mgr-style";
@@ -116,8 +127,8 @@ window.__ModuleLoader__.load({
         "page.deleteSel": "Delete selected ({n})…",
         "page.tipNoArchiveSel": "No selected session can be archived",
         "page.tipNoRestoreSel": "No selected session can be restored",
-        "page.ungrouped": "Ungrouped",
-        "group.unreadable": "{n} unreadable session folder(s)",
+        "page.ungrouped": "Ungrouped",
+        "group.unreadable": "{n} unreadable session folder(s)",
         "group.unreadableHint": "The harness cannot read these session logs, so they appear in no listing. Deleting one removes its folder and cannot be undone.",
         "page.noTitle": "(untitled)",
         "page.created": "created",
@@ -249,8 +260,8 @@ window.__ModuleLoader__.load({
         "page.deleteSel": "删除选中 ({n})…",
         "page.tipNoArchiveSel": "选中的会话没有可归档的",
         "page.tipNoRestoreSel": "选中的会话没有可恢复的",
-        "page.ungrouped": "未分组",
-        "group.unreadable": "{n} 个无法读取的会话文件夹",
+        "page.ungrouped": "未分组",
+        "group.unreadable": "{n} 个无法读取的会话文件夹",
         "group.unreadableHint": "harness 读不出这些会话日志，因此它们不会出现在任何列表中。删除会一并移除其文件夹，且不可复原。",
         "page.noTitle": "(无标题)",
         "page.created": "创建于",
@@ -382,8 +393,8 @@ window.__ModuleLoader__.load({
         "page.deleteSel": "刪除選中 ({n})…",
         "page.tipNoArchiveSel": "沒有可歸檔的已選會話",
         "page.tipNoRestoreSel": "沒有可恢復的已選會話",
-        "page.ungrouped": "未分組",
-        "group.unreadable": "{n} 個無法讀取的會話資料夾",
+        "page.ungrouped": "未分組",
+        "group.unreadable": "{n} 個無法讀取的會話資料夾",
         "group.unreadableHint": "harness 讀不出這些會話日誌，因此它們不會出現在任何列表中。刪除會一併移除其資料夾，且不可復原。",
         "page.noTitle": "(無標題)",
         "page.created": "建立於",
@@ -733,31 +744,45 @@ window.__ModuleLoader__.load({
         )
       );
 
-      return react.createElement("div", { className: "dsm-overlay", onClick: function (e) { if (e.target === e.currentTarget && !props.busy) props.onClose(); } },
-        react.createElement("div", { className: "dsm-modal" },
-          react.createElement("div", { className: "dsm-modal-title" }, props.title),
-          props.subtitle ? react.createElement("div", { className: "dsm-modal-sub" }, props.subtitle) : null,
-          react.createElement("div", null, t("moveModal.destLabel")),
-          (!props.workspaces || props.workspaces.length === 0)
-            ? react.createElement("div", { className: "dsm-hint" }, t("moveModal.noOther"))
-            : null,
-          react.createElement("div", { style: { display: "flex", flexDirection: "column", gap: "6px" } }, wsOptions, customOpt),
-          useCustom ? react.createElement("input", {
-            className: "dsm-input",
-            placeholder: "D:\\projects\\my-project",
-            value: customPath,
-            onChange: function (e) { setCustomPath(e.target.value); }
-          }) : null,
-          props.error ? react.createElement("div", { className: "dsm-error", style: { padding: 0, textAlign: "left" } }, String(props.error)) : null,
-          react.createElement("div", { className: "dsm-modal-actions" },
-            react.createElement("button", { className: "dsm-btn", disabled: props.busy, onClick: props.onClose }, t("moveModal.cancel")),
-            react.createElement("button", {
-              className: "dsm-btn dsm-btn-primary",
-              disabled: props.busy || !canConfirm,
-              onClick: function () { props.onConfirm(target); }
-            }, props.busy ? t("moveModal.busy") : t("moveModal.confirm"))
-          )
+      var modalBody = [
+        react.createElement("div", { className: "dsm-modal-title" }, props.title),
+        props.subtitle ? react.createElement("div", { className: "dsm-modal-sub" }, props.subtitle) : null,
+        react.createElement("div", null, t("moveModal.destLabel")),
+        (!props.workspaces || props.workspaces.length === 0)
+          ? react.createElement("div", { className: "dsm-hint" }, t("moveModal.noOther"))
+          : null,
+        react.createElement("div", { style: { display: "flex", flexDirection: "column", gap: "6px" } }, wsOptions, customOpt),
+        useCustom ? react.createElement("input", {
+          className: "dsm-input",
+          placeholder: "D:\\projects\\my-project",
+          value: customPath,
+          onChange: function (e) { setCustomPath(e.target.value); }
+        }) : null,
+        props.error ? react.createElement("div", { className: "dsm-error", style: { padding: 0, textAlign: "left" } }, String(props.error)) : null,
+        react.createElement("div", { className: "dsm-modal-actions" },
+          react.createElement("button", { className: "dsm-btn", disabled: props.busy, onClick: props.onClose }, t("moveModal.cancel")),
+          react.createElement("button", {
+            className: "dsm-btn dsm-btn-primary",
+            disabled: props.busy || !canConfirm,
+            onClick: function () { props.onConfirm(target); }
+          }, props.busy ? t("moveModal.busy") : t("moveModal.confirm"))
         )
+      ];
+
+      // Portal through the app's Modal where available (required inside the
+      // conversation header on DSH >= 0.2.2); otherwise keep the local overlay.
+      if (primitives && typeof primitives.Modal === "function") {
+        return react.createElement(primitives.Modal, {
+          open: true,
+          onClose: function () { if (!props.busy) props.onClose(); },
+          title: props.title,
+          className: "dsm-modal",
+          headless: true,
+          children: modalBody
+        });
+      }
+      return react.createElement("div", { className: "dsm-overlay", onClick: function (e) { if (e.target === e.currentTarget && !props.busy) props.onClose(); } },
+        react.createElement("div", { className: "dsm-modal" }, modalBody)
       );
     }
 

package/lib/host.js

@@ -282,8 +282,41 @@ function sessionRunning(ctx, sessionId) {
   return !!(agent && agent.status === "running");
 }
 
-/** Evict an idle live session from the in-memory store so the next open reads the rewritten header. */
-function detachLive(ctx, sessionId) {
+/**
+ * Evict an idle live session from the in-memory store so the next open reads
+ * the rewritten header.
+ *
+ * This must ALSO unregister the session's Agent from the agent registry. The
+ * session store and the agent registry are independent in-memory structures
+ * with no cross-coupling: detaching the session alone leaves a live Agent
+ * registered under the same id, whose `.session` still points at the stale
+ * in-memory header. That zombie Agent then shadows every subsequent prompt for
+ * the id (it is resolved ahead of a disk resume and appends to its orphaned
+ * in-memory session, never the moved artifact), so the moved session silently
+ * stops working. Unregistering the Agent first forces the next resolve to
+ * resume fresh from the rewritten on-disk header.
+ *
+ * The agent-store entry carries no `.detach()`; the service's
+ * `detachEntered()` is the removal primitive (it deletes the entry and emits
+ * `agent/disposed`). Note it unregisters only: the Agent's full lifecycle
+ * teardown (scope disposal) is owned by its creator fiber and runs at process
+ * exit, so each moved idle session retains one Agent scope until then. That is
+ * bounded and minor; a deeper `disposeAgent(id)` hook would belong upstream in
+ * DSH.
+ *
+ * Best effort: a missing or refusing agents service must not fail the move.
+ * @returns true when the session was evicted (the caller treats false as fatal).
+ */
+export function detachLive(ctx, sessionId) {
+  const agents = ctx.get("agents");
+  if (agents && typeof agents.detachEntered === "function") {
+    try {
+      const agentEntry = agents.store?.get?.(sessionId);
+      if (agentEntry !== undefined) agents.detachEntered(agentEntry);
+    } catch {
+      // ignore — session eviction below is what matters
+    }
+  }
   const sessions = ctx.get("sessions");
   if (!sessions) return false;
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-mgr",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "description": "Session manager for the DeepSeek Harness web UI: move, archive, restore, backup(portable archive) and import conversations across workspaces. Trilingual (English / 简体中文 / 繁體中文). · DSH Web 外掛「會話管理」：移動、歸檔、恢復、可攜式備份(壓縮檔)與匯入、刪除會話，支援中（簡/繁）英文介面。",
   "type": "module",
   "main": "lib/host.js",