dsh-pause-session 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -2,40 +2,71 @@
 
 All notable changes to this project are documented here.
 
-The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project uses [Semantic Versioning](https://semver.org/).
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project uses [Semantic Versioning](https://semver.org/).
+
+## [0.2.1] - 2026-11-11
+
+### Changed
+
+- Adapt to DeepSeek Harness `0.2.2-rc.2`. Subagent children now resume through `ctx.subagents.prompt`, so the runtime owns their activation, composition, and tree membership; the plugin no longer loads them as independent Agents.
+- Release ordering reads `listDescendants` depth and reuses the tree walk, so a tree release no longer reads the catalogs twice.
+- The composition seam resolves a root Session's preset only; a child's composition is restored by the subagent runtime.
+
+### Removed
+
+- The `parentAgent` resume option, `listChildren` catalog reads, and the child-composition branch this plugin used to assemble itself.
+
+## [0.2.0] - 2026-11-08
+
+### Changed
+
+- Both controls now use a native DSH Remote namespace and stream. The plugin registers no slash commands, so a status refresh never appends `command/run`/`command/done` records to a Session.
+- Pause, resume, goal, and decision-list actions travel through the same native namespace on Web and Desktop.
+
+### Added
+
+- Global progress names every draining session and its running tools, and the in-progress action is **Cancel this pause**.
+- The Remote namespace is owner-only.
+- The client bundle uses a build-time codec-builder shim instead of bundling the full Zod runtime.
+- One snapshot is shared by every connected Remote observer, and the snapshot projection shares its tree walks.
+- The park episode machine, snapshot projection, release ordering, and resume copy now live in separate modules; `control.ts` is composition only.
+- State-changing Remote actions are recorded with a structured host log entry and the caller principal.
+
+### Fixed
+
+- A park reaches `safe` only when the session-level flush actually ran; an unreadable record and a partially unread tree are reported instead of being counted clean.
+- A restart-adopted park is no longer cancelled by the per-session button; it stays on the decision path.
+- Stream and triage failures render as unavailable instead of stale rows, and triage decisions that the host refuses show the refusal.
+
+### Removed
+
+- The `/pause`, `/pause-resume`, `/pause-state`, `/pause-goal`, and `/pause-triage*` command surface.
+- The command-era `ReadBurst`/JSON-status-route client machinery and the `@deepseek-ai/dsh-commands` dependency.
 
 ## [0.1.0] - 2026-11-02
 
 ### Added
 
-- Pause every running DSH session and its subagents at the next model-request
-  boundary, after the tool already running finishes.
-- Session-header and whole-app controls, with `Pausing`, `Paused`, and
-  `All Paused` states.
+- Pause every running DSH session and its subagents at the next model-request boundary, after the tool already running finishes.
+- Session-header and whole-app controls, with `Pausing`, `Paused`, and `All Paused` states.
 - Durable pause registry that re-holds parked sessions after a DSH restart.
-- Clean resume that restores the recorded Agent preset composition, including
-  subagent delegation context and tool restrictions.
+- Clean resume that restores the recorded Agent preset composition, including subagent delegation context and tool restrictions.
 - Goal re-arm toggle for cleanly paused sessions.
-- Decision list for sessions that did not pause cleanly, with continue,
-  continue-with-note, review-only, leave, and goal actions.
-- Localized English and Chinese UI copy, plugin-manager metadata, and a
-  user-facing README screenshot.
-- `/pause`, `/pause-resume`, `/pause-all`, `/pause-state`, `/pause-goal`, and
-  `/pause-triage*` command surface.
+- Decision list for sessions that did not pause cleanly, with continue, continue-with-note, review-only, leave, and goal actions.
+- Localized English and Chinese UI copy, plugin-manager metadata, and a user-facing README screenshot.
+- `/pause`, `/pause-resume`, `/pause-all`, `/pause-state`, `/pause-goal`, and `/pause-triage*` command surface.
 
 ### Changed
 
-- The package is published as `dsh-pause-session`; the slash-command namespace
-  remains `/pause*`.
-- One-shot and external subagent routes are reported as unresumable and are not
-  registered as local pause records.
+- The package is published as `dsh-pause-session`; the slash-command namespace remains `/pause*`.
+- One-shot and external subagent routes are reported as unresumable and are not registered as local pause records.
 
 ### Known Limitations
 
 - Background jobs and shell tasks outside the agent loop are not stopped.
-- A paused session still appears `running` to parts of DSH's session lifecycle;
-  exit, archive, compaction, and `wait_agent` can behave differently while held.
+- A paused session still appears `running` to parts of DSH's session lifecycle; exit, archive, compaction, and `wait_agent` can behave differently while held.
 - External one-shot subagent routes cannot be cold-resumed.
 
+[0.2.1]: https://github.com/timho1047/dsh-pause-session/releases/tag/v0.2.1
+[0.2.0]: https://github.com/timho1047/dsh-pause-session/releases/tag/v0.2.0
 [0.1.0]: https://github.com/timho1047/dsh-pause-session/releases/tag/v0.1.0

package/DEVELOPMENT.md

@@ -5,8 +5,11 @@ official DSH source tree; it is only the author's local layout.
 
 ## Layout
 
-- `src/` — host-half TypeScript: pause gate, park registry, resume path,
-  triage, and host services.
+- `src/` — host-half TypeScript: pause gate, park registry, park-state
+  machine, snapshot projection, resume path, triage, and host services.
+  `control.ts` is the composition root; `park-state.ts`, `snapshot.ts`,
+  `resume.ts`, `resume-text.ts`, and `release-order.ts` own their respective
+  change reasons.
 - `src/client/` — Web client TypeScript/React: the session control, global
   control, state mapping, and locale dictionaries.
 - `lib/` — committed build output. Run `pnpm run build` to refresh it before a
@@ -27,6 +30,26 @@ the build. A fresh clone can run `pnpm pack` (the release path does not install
 dependencies), but cannot run the full verification suite without the harness
 checkout.
 
+## Native Remote transport
+
+`src/remote.ts` is the generated Remote surface. Its `observe` stream carries
+status snapshots and its `act` / `triage` / `decide` methods carry every button
+action. The Client mounts the generated contribution (`dsh-pause-session/remote`)
+and consumes the namespace through a child injection; the same Gateway path is
+used on Web and Desktop. No slash command is registered anywhere.
+
+The client build aliases the generated contribution's `zod` import to
+`src/client/zod-lite.ts`: the Gateway validates browser-to-host arguments, and
+host results are produced by this plugin, so the browser keeps only the codec
+builder shape. The client bundle stays around 20 KB gzip instead of pulling the
+full codec runtime.
+
+`scripts/generate-typert.mjs` builds a temporary Typert workspace containing
+this Remote service and the Harness protocol source, then commits the generated
+`lib/typert.*` artifacts beside the other build output. The release workflow
+never needs a Harness checkout. The tests drive the same native namespace via
+`tests/native-driver.ts`; no command-shaped test compatibility surface remains.
+
 ## Build and test
 
 ```sh

package/README.md

@@ -4,6 +4,8 @@ English | [中文](README.zh.md)
 
 <p align="center"><img src="icon.svg" width="64" height="64" alt="dsh-pause-session icon"></p>
 
+[npm: dsh-pause-session](https://www.npmjs.com/package/dsh-pause-session)
+
 Pause every running DSH session and its subagents before you leave, then resume
 them later.
 
@@ -15,27 +17,46 @@ included, and the pause survives a DSH restart.
 > tracked in [REHEARSAL.md](REHEARSAL.md).
 
 <p align="center">
-  <img src="docs/images/pause-controls.webp" alt="dsh-pause-session controls showing a paused session and All Paused for the whole app" width="100%">
+  <img src="docs/images/pause-controls.webp" alt="dsh-pause-session controls showing a paused session and Paused for the whole app" width="100%">
 </p>
 
-*The session is paused; the global pill shows All Paused (1/1).*
+*The session is paused; the global pill shows Paused (1/1).*
 
 ## Quick start
 
-1. Open the **Plugins** page in the DSH Web sidebar and install this directory
-   as a bundle. The repository ships the built `lib/` tree; if you changed the
-   source, run `pnpm run build` first. From a session in that profile,
-   `plugin_manager` can do the same with `install_bundle` and the directory's
-   absolute path. The local development layout is in
-   [DEVELOPMENT.md](DEVELOPMENT.md).
+1. Install the plugin for your target:
+
+   **Desktop** — open the **Plugins** page in the Desktop sidebar and install
+   `dsh-pause-session` there.
+
+   **Web profile, from npm:**
+
+   ```sh
+   dsh plugin --profile web add dsh-pause-session
+   ```
+
+   **Web profile, from source:**
+
+   ```sh
+   git clone https://github.com/timho1047/dsh-pause-session.git
+   dsh plugin --profile web add "$PWD/dsh-pause-session"
+   ```
+
+   For either Web installation, restart the DSH Web process once so the running
+   process loads the new client bundle. The checkout ships the built `lib/`
+   tree, so no separate build is needed; only changed sources require a rebuild.
+   The local development layout is in [DEVELOPMENT.md](DEVELOPMENT.md).
 2. Open the session you want to pause. Press the pause button beside its title
    to pause that session and its subagents, or press the pill on the right side
    of the header to pause every running session tree.
 3. The control shows **Pausing** until the running tools finish and the next
-   model requests are held. When the global pill shows **All Paused**, every
-   registered session is stopped.
-4. Next time, press **All Paused** to resume every cleanly paused session, or
-   press the session button to resume that session and its subagents.
+   model requests are held. When the global pill shows **Paused**, every
+   registered session is stopped and its pending input is durable.
+4. Next time, press **Paused** to resume every cleanly paused session, or
+   press the session button to resume that session and its subagents. While a
+   park is still in progress, the pill names the draining sessions and tools and
+   offers **Cancel this pause**. Drag the pill to move it; its position is
+   remembered, and the panel offers a reset.
 
 ## The two controls
 
@@ -58,6 +79,9 @@ session state is saved.
   again on the next mount.
 - The composer stays usable; the pause is released by the same control, not by
   sending a message.
+- Both controls use a native Remote stream on Web and Desktop. No slash command
+  is registered, so background status refreshes never append command rows to a
+  Session.
 
 ## What is not stopped
 
@@ -83,25 +107,11 @@ control opens a decision list where each row can be continued, continued with a
 note that the tool result is unknown, opened for review without running, or
 left paused.
 
-## Commands
-
-The buttons drive these commands; they are useful for scripts and for
-keyboard-first use:
-
-| Command | Purpose |
-|---|---|
-| `/pause` | Pause the current session and its subagents. |
-| `/pause-resume` | Resume the current paused session tree. |
-| `/pause-resume-all` | Resume every paused session that stopped cleanly. |
-| `/pause-all` | Pause every running session tree. |
-| `/pause-state` | Report the current session tree's pause state. |
-| `/pause-state-all` | Report the whole-app pause state. |
-| `/pause-goal` | Toggle the current session's goal re-arm on resume. |
-| `/pause-triage` | Read the decision list for sessions that did not pause cleanly. |
-| `/pause-triage-continue`, `note`, `review`, `leave`, `goal` | Take one decision on a listed session. |
-
-Status reads are commands too, so they appear as command rows in the session
-transcript.
+## Controls only
+
+The plugin registers no slash commands. Pause, resume, the goal switch, and the
+decision list are driven entirely by the header controls. The controls use the
+same native Remote namespace on Web and Desktop.
 
 ## Requirements
 

package/README.zh.md

@@ -4,6 +4,8 @@
 
 <p align="center"><img src="icon.svg" width="64" height="64" alt="dsh-pause-session 图标"></p>
 
+[npm: dsh-pause-session](https://www.npmjs.com/package/dsh-pause-session)
+
 在离开前暂停所有运行中的 DSH 会话及其子代理，之后再恢复。
 
 dsh-pause-session 会把每个会话停在同一个点：当前已经运行的工具先跑完，然后拦住下一条模型请求。子代理树也会一起暂停，暂停状态可以跨 DSH 重启保留。
@@ -11,17 +13,38 @@ dsh-pause-session 会把每个会话停在同一个点：当前已经运行的
 > 状态：beta。已针对 DSH `0.2.2-alpha.2` 验证；完整的实机演练见 [REHEARSAL.md](REHEARSAL.md)。
 
 <p align="center">
-  <img src="docs/images/pause-controls.webp" alt="dsh-pause-session 控件：会话已暂停，全局显示全部已暂停" width="100%">
+  <img src="docs/images/pause-controls.webp" alt="dsh-pause-session 控件：会话已暂停，全局显示已暂停" width="100%">
 </p>
 
-*会话已暂停；全局控件显示“全部已暂停”（1/1）。*
+*会话已暂停；全局控件显示“已暂停”（1/1）。*
 
 ## 快速开始
 
-1. 打开 DSH Web 侧边栏的 **Plugins** 页面，把本目录作为 bundle 安装。仓库里已经提交了构建好的 `lib/`；如果改过源码，先执行 `pnpm run build`。也可以在该 profile 的会话里用 `plugin_manager` 的 `install_bundle`，传入本目录的绝对路径。本地开发布局见 [DEVELOPMENT.md](DEVELOPMENT.md)。
+1. 按目标选择安装方式：
+
+   **Desktop**：打开 Desktop 侧边栏的 **Plugins** 页面，在那里安装
+   `dsh-pause-session`。
+
+   **Web profile，从 npm 安装：**
+
+   ```sh
+   dsh plugin --profile web add dsh-pause-session
+   ```
+
+   **Web profile，从源码安装：**
+
+   ```sh
+   git clone https://github.com/timho1047/dsh-pause-session.git
+   dsh plugin --profile web add "$PWD/dsh-pause-session"
+   ```
+
+   两种 Web 安装方式完成后，都重启一次 DSH Web 进程，让运行中的进程加载
+   新的 client bundle。仓库里已经提交了构建好的 `lib/`，不需要额外构建；
+   只有改过源码时才需要重新构建。本地开发布局见
+   [DEVELOPMENT.md](DEVELOPMENT.md)。
 2. 打开要暂停的会话。按标题旁的暂停按钮，会暂停这个会话及其子代理；按头部右侧的胶囊，会暂停所有运行中的会话树。
-3. 控件会先显示 **正在暂停**（Pausing），等运行中的工具结束、下一条模型请求被拦住后，才会变成 **已暂停**（Paused）。全局胶囊变成 **全部已暂停**（All Paused）时，所有已登记的会话都已停住。
-4. 下次按 **全部已暂停** 可以恢复所有干净暂停的会话；按会话旁的控制可以只恢复这一个会话及其子代理。
+3. 控件会先显示 **正在暂停**（Pausing），等运行中的工具结束、下一条模型请求被拦住后，才会变成 **已暂停**（Paused）。全局胶囊变成 **已暂停**（Paused）时，所有已登记的会话都已停住，待处理输入也已落盘。
+4. 下次按 **已暂停** 可以恢复所有干净暂停的会话；按会话旁的控制可以只恢复这一个会话及其子代理。暂停尚未完成时，胶囊会点名正在排空的会话和工具，并提供 **取消这次暂停**。
 
 ## 两个控件
 
@@ -39,6 +62,7 @@ dsh-pause-session 会把每个会话停在同一个点：当前已经运行的
 - 已经登记在暂停树里的子代理会按同样规则停下。
 - 暂停状态是持久化的。DSH 退出或重启后，下次挂载会重新拦住这些会话。
 - 输入框保持可用；暂停要通过同一个控件释放，而不是靠再发一条消息。
+- 两个控件在 Web 和 Desktop 上都使用原生 Remote 流。插件不注册任何斜杠命令，后台状态刷新不会向会话追加命令记录。
 
 ## 哪些东西不会被停住
 
@@ -52,23 +76,9 @@ dsh-pause-session 会把每个会话停在同一个点：当前已经运行的
 
 没有干净暂停的会话不会被静默恢复。全局控件会打开决策清单，每一行可以继续、带说明继续（说明工具结果未知）、只看不运行，或保持暂停。
 
-## 命令
-
-按钮驱动的就是这些命令；脚本和键盘操作用得上：
-
-| 命令 | 作用 |
-|---|---|
-| `/pause` | 暂停当前会话及其子代理。 |
-| `/pause-resume` | 恢复当前暂停的会话树。 |
-| `/pause-resume-all` | 恢复所有干净暂停的会话。 |
-| `/pause-all` | 暂停所有运行中的会话树。 |
-| `/pause-state` | 读取当前会话树的暂停状态。 |
-| `/pause-state-all` | 读取整体暂停状态。 |
-| `/pause-goal` | 切换当前会话恢复时是否重新打开目标。 |
-| `/pause-triage` | 读取未干净暂停会话的决策清单。 |
-| `/pause-triage-continue`、`note`、`review`、`leave`、`goal` | 对清单中的一个会话执行对应决策。 |
+## 只用控件
 
-状态读取本身也是命令，所以会在会话转录里留下命令行。
+插件不注册任何斜杠命令。暂停、恢复、goal 开关和决策清单全部由会话头部控件驱动；Web 和 Desktop 使用同一个原生 Remote 命名空间。
 
 ## 要求
 

package/REHEARSAL.md

@@ -49,16 +49,16 @@
 
 1. 让它跑一个会占住工具的动作，例如 `sleep 60`。
 2. 找到会话头部右侧的胶囊并按下。
-   - **期望**：胶囊显示"正在暂停"并**点名正在跑的工具**；此刻它还不会说全部已暂停。
-3. 等它变成"全部已暂停"。
+   - **期望**：胶囊显示"正在暂停"，点名正在排空的会话和工具，并提供一个"取消这次暂停"的动作；此刻它还不会说安全。
+3. 等它变成"已暂停"。
    - **期望**：只有在工具返回、请求停住、并且会话状态已保存之后才变色。
-   - **反例**：工具还在跑就显示“全部已暂停” → 失败。
+   - **反例**：工具还在跑或 flush 未完成就显示“已暂停” → 失败。
 4. 确认会话**停在下一条请求之前**：它不应再出现新的模型输出；界面显示已暂停。
 5. 如果这个会话带着目标：在它的标题栏控件上把**目标开关关掉**（"恢复这个会话时不会自己重新启动它的目标"）。
    - **期望**：开关状态来自宿主，按一下之后会被重新读取，而不是本地翻转。
 6. 直接退出 DSH（或强杀），重启。
-   - **期望**：重启后该会话仍是暂停状态；`/pause-state-all` 仍能读到它。
-7. 按恢复（胶囊或 `/pause-resume-all`）。
+   - **期望**：重启后该会话仍是暂停状态，头部胶囊仍显示全局暂停状态。
+7. 按恢复（头部胶囊）。
    - **期望**：会话从停下的那点继续，模型回应的是暂停时那条待发输入；**上下文里没有"你被打断过"之类的新内容**。
    - **期望（目标）**：第 5 步关掉开关的那些会话，恢复后**目标保持不启动**、不产生新的轮次；没关的照常推进。
    - **前提**：早上的组合必须提供与昨天相同的工具集，否则 DSH 自己会补工具增减的系统消息，"线上零新增"的肉眼结论会失真。
@@ -77,7 +77,7 @@
 ## 六、已知代价与限制（不是 bug）
 
 - 暂停中的会话在核心看来仍是 running：退出 DSH 会约 5 秒后被强退（所以停止前必须 flush）；归档会报错或不等结算；压缩会以"已有工作"报错；等待该会话的 RPC 会挂住客户端；`wait_agent` 会白等到上限。
-- 暂停中的会话会在斜杠命令菜单里多出 `/pause-resume`、`/pause-state`、`/pause-goal`（以及全局的 `/pause-all`、`/pause-state-all`、`/pause-triage*`）——状态通道的形状就是这么来的。**每次读状态都是一次命令执行，因此会在对话里留下一行**（harness 无条件记录并渲染每一次命令执行，没有"不记录"的开关）。读取已改成事件驱动：一次暂停周期个位数次，停稳后不再读；但被暂停会话自己的转录里仍会剩下那么几行，无关会话不会再出现。
+- 插件不注册斜杠命令。暂停、恢复、goal 和决策清单都由头部控件通过原生 Remote 触发；状态读取走 Remote 流，不写入 `command/run`/`command/done`。
 - 对一个已经暂停的会话再按一次暂停**不会**产生新的停稳判定；要新判定必须先恢复、跑出新的工作周期、再停一次。
 - 时间上下文冻结在暂停时刻（"仿佛没中断"的字面含义）。
 - 一次性子代理路由（`subagent_codex` / `subagent_claude_code` 之类桥接）的工作跨重启无法续跑，只会被点名。