npm - dsh-plugin-message-edit - Versions diffs - 1.0.0 → 1.1.0 - Mend

dsh-plugin-message-edit 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/LICENSE CHANGED Viewed

@@ -1,24 +1,24 @@
-MIT License
-Copyright (c) 2026 SpookySandwich
-Portions of the host-side branching logic are derived from dsh-message-edit,
-Copyright (c) Moeblack, also released under the MIT License.
-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.
+MIT License
+Copyright (c) 2026 SpookySandwich
+Portions of the host-side branching logic are derived from dsh-message-edit,
+Copyright (c) Moeblack, also released under the MIT License.
+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.en.md CHANGED Viewed

@@ -2,8 +2,10 @@
 English | [简体中文](README.md)
+[![npm](https://img.shields.io/npm/v/dsh-plugin-message-edit?color=cb3837&logo=npm)](https://www.npmjs.com/package/dsh-plugin-message-edit)
+[![CI](https://github.com/SpookySandwich/dsh-plugin-message-edit/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/SpookySandwich/dsh-plugin-message-edit/actions/workflows/ci.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
-[![dsh](https://img.shields.io/badge/dsh-0.1.0--rc.7-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
+[![dsh](https://img.shields.io/badge/dsh-0.1.5--rc.2-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
 [![stars](https://img.shields.io/github/stars/SpookySandwich/dsh-plugin-message-edit?style=flat&label=stars)](https://github.com/SpookySandwich/dsh-plugin-message-edit/stargazers)
 Edit a message you already sent and the conversation **rewinds and branches** from that point, the way ChatGPT, Claude and DeepSeek all do it. The old version is not overwritten — a `‹ 2/4 ›` counter appears under the bubble, and a Versions tab draws the whole tree.
@@ -68,11 +70,24 @@ For technical details and developer guides, see:
 - [Tree Data Model & Algorithms](docs/TREE_DATA_MODEL.md): Turn-level message tree projection, sibling fan-out, ghost recovery, and active path calculation.
 - [Development & Testing Guide](docs/DEVELOPMENT.md): Build pipeline, automated test suite, and local installation instructions.
-## Compatibility
+## Compatibility
+Version `1.1.0`: Fix seeded edit/retry creation, clear inherited pending input before publication, identify version markers by session ownership, preserve reasoning effort, and read persisted branches through disposable session observations.
+The declared host range is `>=0.1.5-rc.2 <0.1.6-0`; the official `0.1.5-rc.2` runtime was verified. DSH `0.1.6` alpha is not claimed compatible. Keep the previous plugin release on older DSH. [Validation record](.github/reviews/dsh-0.1.5.md).
+Download the archive from the [GitHub Release](https://github.com/SpookySandwich/dsh-plugin-message-edit/releases/tag/v1.1.0), then run `dsh plugin --profile desktop add ./dsh-plugin-message-edit-1.1.0.tgz`.
+Version `1.1.0` has been verified in an isolated DSH `0.1.5-rc.2` Web environment:
+plugin loading, images, edit/retry, nested branches, and restored sessions. Model
+responses use a local test adapter; remote model services were not exercised.
+The compatibility layer retains the older `events` / `seedLength` interfaces,
+covered by automated tests. Later DSH releases need separate verification.
+Restart DSH after updating the plugin.
 Coexists with [dsh-plugin-smooth-stream](https://github.com/SpookySandwich/dsh-plugin-smooth-stream) and [dsh-plugin-rollout-scout](https://github.com/SpookySandwich/dsh-plugin-rollout-scout).
 ## License
 MIT © SpookySandwich. Portions of the host half derive from dsh-message-edit (MIT © Moeblack).

package/README.md CHANGED Viewed

@@ -2,8 +2,10 @@
 [English](README.en.md) | 简体中文
+[![npm](https://img.shields.io/npm/v/dsh-plugin-message-edit?color=cb3837&logo=npm)](https://www.npmjs.com/package/dsh-plugin-message-edit)
+[![CI](https://github.com/SpookySandwich/dsh-plugin-message-edit/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/SpookySandwich/dsh-plugin-message-edit/actions/workflows/ci.yml)
 [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
-[![dsh](https://img.shields.io/badge/dsh-0.1.0--rc.7-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
+[![dsh](https://img.shields.io/badge/dsh-0.1.5--rc.2-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
 [![stars](https://img.shields.io/github/stars/SpookySandwich/dsh-plugin-message-edit?style=flat&label=stars)](https://github.com/SpookySandwich/dsh-plugin-message-edit/stargazers)
 编辑一条已经发出的消息，对话会从那一刻 **真正回溯并分叉**——和 ChatGPT、Claude、DeepSeek 的做法一致。旧版本不会被覆盖：气泡下方出现 `‹ 2/4 ›` 计数，「版本」标签页则画出整棵树。
@@ -68,11 +70,20 @@ DSH 的会话是仅追加的事件日志，本身不支持会话内分支，因
 - [树数据模型与算法 (Tree Data Model)](docs/TREE_DATA_MODEL.md)：轮次级消息树构建、同级展开、删除会话（Ghost）桥接与高亮路径计算。
 - [开发与测试指南 (Development)](docs/DEVELOPMENT.md)：构建流程、单元测试与本地安装说明。
-## 兼容性
+## 兼容性
+版本 `1.1.0`：修复编辑/重试的 seed 边界，发布分支前清空继承的待发送输入，按会话身份识别版本标记，保留推理强度，并通过会话观察接口恢复持久分支。
+声明兼容范围为 `>=0.1.5-rc.2 <0.1.6-0`；已验证官方 `0.1.5-rc.2`，不声明兼容 `0.1.6` alpha。旧版 DSH 请保留上一插件版本。[验证记录](.github/reviews/dsh-0.1.5.md)。
+可从 [GitHub Release](https://github.com/SpookySandwich/dsh-plugin-message-edit/releases/tag/v1.1.0) 下载发布包，然后执行 `dsh plugin --profile desktop add ./dsh-plugin-message-edit-1.1.0.tgz`。
+`1.1.0` 已在 DSH `0.1.5-rc.2` 的隔离 Web 环境验证：插件加载、图片显示、编辑与重试、深层分支，以及持久会话的恢复读取。模型回复使用本地测试实现，未调用远程模型服务。
+兼容层保留了旧版 `events` / `seedLength` 接口支持，并由自动测试覆盖。DSH 仍在快速迭代，尚未验证的后续版本不在此保证范围内。更新插件后请重启 DSH。
 可与 [dsh-plugin-smooth-stream](https://github.com/SpookySandwich/dsh-plugin-smooth-stream)、[dsh-plugin-rollout-scout](https://github.com/SpookySandwich/dsh-plugin-rollout-scout) 共存。
 ## 许可
 MIT © SpookySandwich。宿主端部分逻辑源自 dsh-message-edit（MIT © Moeblack）。

package/cordis.patch.yml CHANGED Viewed

@@ -1,7 +1,7 @@
-# The loader entry id stays `message-tree` on purpose: Moeblack's
-# dsh-message-edit uses the id `message-edit`, and two entries sharing an id
-# collide when both plugins are installed. `name` is the package to import,
-# so it follows the package rename.
-- insert:
-    - id: message-tree
-      name: dsh-plugin-message-edit
+# The loader entry id stays `message-tree` on purpose: Moeblack's
+# dsh-message-edit uses the id `message-edit`, and two entries sharing an id
+# collide when both plugins are installed. `name` is the package to import,
+# so it follows the package rename.
+- insert:
+    - id: message-tree
+      name: dsh-plugin-message-edit

package/docs/ARCHITECTURE.md CHANGED Viewed

@@ -1,156 +1,168 @@
-# Architecture Overview
-`dsh-plugin-message-edit` provides ChatGPT/Claude-style conversation branching and message editing for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness).
-Because DSH session event logs are append-only without native in-session branching, this plugin splits responsibilities across a **Node.js Host Service** and a **Browser/Web Client**.
----
-## 1. System Components
-```
-┌─────────────────────────────────────────────────────────────┐
-│                      DSH Desktop / Web                      │
-│                                                             │
-│  ┌──────────────────────┐         ┌──────────────────────┐  │
-│  │     Client Half      │  HTTP   │      Host Half       │  │
-│  │  (plugin.client.js)  │<───────>│    (lib/index.js)    │  │
-│  └──────────┬───────────┘         └──────────┬───────────┘  │
-│             │                                │              │
-│    Shadow User Message              Cordis Services:        │
-│    Versions Tab (Graph)             - sessions              │
-│    Settings UI                      - agents                │
-│                                     - webServer             │
-│                                     - sessionPersistence    │
-└─────────────────────────────────────────────────────────────┘
-```
-### 1.1 Host Half (`lib/index.js`)
-- Runs in the Node.js backend process via Cordis lifecycle injection.
-- Registers the `/message-tree` HTTP route on `ctx.webServer`.
-- Owns branch creation transactions (`POST /message-tree`):
-  1. Truncates parent events up to the target turn.
-  2. Seeds a new DSH session with the prefix events.
-  3. Appends a durable `message-tree/version` marker with `ignorable: true`.
-  4. Submits the edited prompt into the new session.
-- Owns graph queries (`GET /message-tree?sessionId=...`):
-  - Traverses the session family DAG.
-  - Recovers deleted/ghost ancestors from surviving descendants' event logs.
-  - Extracts turn event boundaries for turn-level rendering.
-### 1.2 Client Half (`plugin.client.js`)
-- Runs in the browser / renderer process.
-- Injects a shadowed `user` message renderer at priority `-1` to add the edit/copy/retry toolbar and `‹ n/m ›` version ring without modifying agent responses, tool calls, or reasoning blocks.
-- Adds the **Versions** tab (`VIEW_ORDER: 16`) providing an interactive pan/zoom graph with spring physics.
-- Adds settings options in **Settings → Message Edit** with live layout switching (ChatGPT, DeepSeek, Claude styles).
----
-## 2. Durable Storage Model
-DSH sessions are immutable append-only logs. When branching:
-1. **Seed Inheritance**: A new session is initialized whose log begins with an exact clone of the parent's event log up to the start of the edited turn (`seedLength`).
-2. **Durable Marker**: The host appends a custom event:
-   ```json
-   {
-     "type": "message-tree/version",
-     "data": {
+# Architecture Overview
+`dsh-plugin-message-edit` provides ChatGPT/Claude-style conversation branching and message editing for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness).
+Because DSH session event logs are append-only without native in-session branching, this plugin splits responsibilities across a **Node.js Host Service** and a **Browser/Web Client**.
+---
+## 1. System Components
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      DSH Desktop / Web                      │
+│                                                             │
+│  ┌──────────────────────┐         ┌──────────────────────┐  │
+│  │     Client Half      │  HTTP   │      Host Half       │  │
+│  │  (plugin.client.js)  │<───────>│    (lib/index.js)    │  │
+│  └──────────┬───────────┘         └──────────┬───────────┘  │
+│             │                                │              │
+│    Shadow User Message              Cordis Services:        │
+│    Versions Tab (Graph)             - sessions              │
+│    Settings UI                      - agents                │
+│                                     - webServer             │
+│                                     - sessionPersistence    │
+└─────────────────────────────────────────────────────────────┘
+```
+### 1.1 Host Half (`lib/index.js`)
+- Runs in the Node.js backend process via Cordis lifecycle injection.
+- Normalizes DSH sessions through `lib/session-record.js`: current live sessions
+  expose `snapshotEvents()`, query snapshots carry their header in `session`,
+  and older records expose `events` / `header`. Invalid logs fail explicitly.
+- DSH 0.1.5 branches use `meta.isSeeded` plus `inheritedEventCount`, which must
+  equal the complete constructor seed length. New markers carry their owning
+  `sessionId`; old markers without that field use the legacy inherited cut.
+  Cold logs use `observeSession(..., { projectionMode: 'none' })` and release
+  the observation lease; this restores seeded sessions through the correct API.
+- Registers the `/message-tree` HTTP route on `ctx.webServer`.
+- Owns branch creation transactions (`POST /message-tree`):
+  1. Truncates parent events up to the target turn.
+  2. Adds an ignorable `message-tree/version` marker to the constructor seed.
+  3. Creates the agent and clears both inherited inbox queues in its setup,
+     before publication can schedule the rewound original input.
+  4. Flushes the branch and submits the edited prompt exactly once.
+- Owns graph queries (`GET /message-tree?sessionId=...`):
+  - Traverses the session family DAG.
+  - Recovers deleted/ghost ancestors from surviving descendants' event logs.
+  - Extracts turn event boundaries for turn-level rendering.
+### 1.2 Client Half (`plugin.client.js`)
+- Runs in the browser / renderer process.
+- Injects a shadowed `user` message renderer at priority `-1` to add the edit/copy/retry toolbar and `‹ n/m ›` version ring without modifying agent responses, tool calls, or reasoning blocks.
+- Adds the **Versions** tab (`VIEW_ORDER: 16`) providing an interactive pan/zoom graph with spring physics.
+- Adds settings options in **Settings → Message Edit** with live layout switching (ChatGPT, DeepSeek, Claude styles).
+---
+## 2. Durable Storage Model
+DSH sessions are immutable append-only logs. When branching:
+1. **Seed Inheritance**: Copy the parent prefix before the edited turn, then add the plugin marker. The full constructor seed is inherited on DSH 0.1.5; the kernel adds its own `session/end-seed` afterwards.
+2. **Durable Marker**: The seed carries a custom event with explicit child ownership:
+   ```json
+   {
+     "type": "message-tree/version",
+     "data": {
        "schemaVersion": 1,
-       "effect": {
-         "operation": "edit",
-         "targetTurn": 1,
-         "targetEventSeq": 5,
-         "before": "Original message text",
-         "after": "Edited message text"
-       },
-       "inverse": {
-         "kind": "restore-version",
-         "sessionId": "parent-session-id"
-       }
-     }
-   }
-   ```
-3. **`ignorable` Flag**: Custom plugin event types fall outside DSH's core schema. The event envelope must set `ignorable: true`; otherwise, DSH's built-in event reader will reject the entire session log.
----
-## 3. HTTP API
-### `GET /message-tree?sessionId={id}`
-Returns the entire conversation family surrounding the requested session.
-**Response Schema:**
-```json
-{
-  "sessionId": "current-session-id",
-  "versions": [
-    {
-      "sessionId": "session-a",
-      "createdAt": 1724334000000,
-      "depth": 0,
-      "current": false,
-      "onCurrentPath": true,
-      "turns": [
-        { "turn": 1, "text": "Hello", "time": 1724334001000 },
-        { "turn": 2, "text": "Tell me more", "time": 1724334005000 }
-      ]
-    },
-    {
-      "sessionId": "session-b",
-      "parentSessionId": "session-a",
-      "createdAt": 1724334020000,
-      "depth": 1,
-      "current": true,
-      "onCurrentPath": true,
-      "operation": "edit",
-      "targetTurn": 1,
-      "before": "Hello",
-      "after": "Hello world",
-      "turns": [
-        { "turn": 1, "text": "Hello world", "time": 1724334021000 },
-        { "turn": 2, "text": "What is next?", "time": 1724334025000 }
-      ]
-    }
-  ]
-}
-```
-### `POST /message-tree`
-Performs branch creation or reactivation.
-- **`edit`**: Rewinds to before the specified user turn, creates a new branched session, appends a durable `message-tree/version` marker, and submits the replacement prompt.
-- **`retry`**: Rewinds to before the target turn, creates a child session, and replays the original user prompt.
-- **`activate`**: Unarchives an archived version session via the host registry queue so the client can navigate to it.
----
-## 4. Performance & In-Memory Caching
-1. **Host-Side Parsed Session Cache (`sessionParsedCache`)**:
-   - Parses turn boundaries (`extractTurns`) and version headers once per immutable event sequence.
-   - Bounded to 500 session entries with key invalidation on live event count / disk mtime changes.
-   - Subsequent `tree()` queries across siblings in the family hit in-memory cache in sub-millisecond time.
-2. **Client-Side Family SWR Store (`treeStore`)**:
-   - Maps every non-deleted branch in a tree to the shared family structure upon fetch.
-   - Switching between sibling branches (`‹ n/m ›` or Versions view) is 100% synchronous (0ms lag, zero indicator flicker).
-   - Uses monotonic request timestamps to prevent race-condition overwrites from out-of-order responses.
-   - Optimistically seeds newly created edit/retry branches before navigation.
----
-## 5. Security and Error Resilience
-- **Ignorable Event Envelope**: `ignorable: true` ensures foreign event markers do not crash the core DSH log parser.
-- **Fail-Safe Mutation Recovery**: Transaction reversals (`child.dispose()`) on failures prevent dangling session artifacts.
-- **Memory Bounded Stores**: LRU bounds (500 sessions) prevent unbounded memory growth in long-running processes.
-## 6. Naming & Namespaces
-- **NPM Package**: `dsh-plugin-message-edit`
-- **Cordis Service Name**: `message-tree`
-- **HTTP Path**: `/message-tree`
-- **Durable Event Type**: `message-tree/version`
-> The package uses `dsh-plugin-message-edit` for discovery, but retains `message-tree` in routes, cordis IDs, and event types to prevent collisions with prior third-party plugins (such as `dsh-message-edit`) and ensure seamless side-by-side operation.
+       "sessionId": "child-session-id",
+       "effect": {
+         "operation": "edit",
+         "targetTurn": 1,
+         "targetEventSeq": 5,
+         "before": "Original message text",
+         "after": "Edited message text"
+       },
+       "inverse": {
+         "kind": "restore-version",
+         "sessionId": "parent-session-id"
+       }
+     }
+   }
+   ```
+3. **`ignorable` Flag**: Custom plugin event types fall outside DSH's core schema. The event envelope must set `ignorable: true`; otherwise, DSH's built-in event reader will reject the entire session log.
+---
+## 3. HTTP API
+### `GET /message-tree?sessionId={id}`
+Returns the entire conversation family surrounding the requested session.
+**Response Schema:**
+```json
+{
+  "sessionId": "current-session-id",
+  "versions": [
+    {
+      "sessionId": "session-a",
+      "createdAt": 1724334000000,
+      "depth": 0,
+      "current": false,
+      "onCurrentPath": true,
+      "turns": [
+        { "turn": 1, "text": "Hello", "time": 1724334001000 },
+        { "turn": 2, "text": "Tell me more", "time": 1724334005000 }
+      ]
+    },
+    {
+      "sessionId": "session-b",
+      "parentSessionId": "session-a",
+      "createdAt": 1724334020000,
+      "depth": 1,
+      "current": true,
+      "onCurrentPath": true,
+      "operation": "edit",
+      "targetTurn": 1,
+      "before": "Hello",
+      "after": "Hello world",
+      "turns": [
+        { "turn": 1, "text": "Hello world", "time": 1724334021000 },
+        { "turn": 2, "text": "What is next?", "time": 1724334025000 }
+      ]
+    }
+  ]
+}
+```
+### `POST /message-tree`
+Performs branch creation or reactivation.
+- **`edit`**: Rewinds to before the specified user turn, creates a new branched session, appends a durable `message-tree/version` marker, and submits the replacement prompt.
+- **`retry`**: Rewinds to before the target turn, creates a child session, and replays the original user prompt.
+- **`activate`**: Unarchives an archived version session via the host registry queue so the client can navigate to it.
+---
+## 4. Performance & In-Memory Caching
+1. **Host-Side Parsed Session Cache (`sessionParsedCache`)**:
+   - Parses turn boundaries (`extractTurns`) and version headers once per immutable event sequence.
+   - Bounded to 500 entries per plugin context. Live keys use session identity
+     and event count; unchanged modern logs do not need a new snapshot.
+   - Cold logs are read before comparing their event count. Creation timestamps
+     cannot invalidate append-only history and must not be used as revisions.
+2. **Client-Side Family SWR Store (`treeStore`)**:
+   - Maps every non-deleted branch in a tree to the shared family structure upon fetch.
+   - Switching between sibling branches (`‹ n/m ›` or Versions view) is 100% synchronous (0ms lag, zero indicator flicker).
+   - Uses monotonic request timestamps to prevent race-condition overwrites from out-of-order responses.
+   - Optimistically seeds newly created edit/retry branches before navigation.
+---
+## 5. Security and Error Resilience
+- **Ignorable Event Envelope**: `ignorable: true` ensures foreign event markers do not crash the core DSH log parser.
+- **Fail-Safe Mutation Recovery**: Transaction reversals (`child.dispose()`) on failures prevent dangling session artifacts.
+- **Memory Bounded Stores**: LRU bounds (500 sessions) prevent unbounded memory growth in long-running processes.
+## 6. Naming & Namespaces
+- **NPM Package**: `dsh-plugin-message-edit`
+- **Cordis Service Name**: `message-tree`
+- **HTTP Path**: `/message-tree`
+- **Durable Event Type**: `message-tree/version`
+> The package uses `dsh-plugin-message-edit` for discovery, but retains `message-tree` in routes, cordis IDs, and event types to prevent collisions with prior third-party plugins (such as `dsh-message-edit`) and ensure seamless side-by-side operation.