@modusensus/dsh-mneme 0.7.7 → 0.7.8

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 (11) hide show
  1. package/CHANGELOG.md +1 -1
  2. package/CONTRIBUTING.md +32 -0
  3. package/README.md +6 -3
  4. package/dsh-mneme/CHANGELOG.md +15 -6
  5. package/dsh-mneme/README.md +8 -6
  6. package/dsh-mneme/package.json +1 -1
  7. package/dsh-mneme/src/inject.js +2 -2
  8. package/dsh-mneme/src/summarize.js +3 -1
  9. package/dsh-mneme/test/inject.test.js +18 -0
  10. package/dsh-mneme/test/summarize.test.js +15 -0
  11. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Changelog
2
2
 
3
- > **完整版本历史见 [dsh-mneme/CHANGELOG.md](dsh-mneme/CHANGELOG.md)**（正式版本正源，0.3.8 → 0.7.7）。以下为仓库早期开发记录（0.1.0–0.2.x，2026-08-13~14，已归档）。
3
+ > **完整版本历史见 [dsh-mneme/CHANGELOG.md](dsh-mneme/CHANGELOG.md)**（正式版本正源，0.3.8 → 0.7.8）。以下为仓库早期开发记录（0.1.0–0.2.x，2026-08-13~14，已归档）。
4
4
 
5
5
  All notable changes to dsh-mneme are documented here.
6
6
 
package/CONTRIBUTING.md CHANGED
@@ -102,6 +102,22 @@ Common scripts (all run under `dsh-mneme/`):
102
102
 
103
103
  ---
104
104
 
105
+ ## Scope: Platform Adaptation & Wrapper PRs
106
+
107
+ DSH upstream is still in developer preview — APIs and service interfaces change frequently. Until DSH reaches a stable release (RC or GA), **PRs that adapt dsh-mneme to secondary platforms or wrap it into other hosts are not a priority** and are reviewed with extra caution:
108
+
109
+ - Desktop shells (e.g. a Tauri/Electron wrapper around `dsh web`)
110
+ - Standalone CLI packaging
111
+ - Ports/wrappers of dsh-mneme into other plugin ecosystems
112
+
113
+ These tend to bind against unstable upstream APIs: a single upstream change can break them, and the maintenance burden falls back on this project. The currently supported platform is the **Web Profile** (`dsh web`).
114
+
115
+ Exceptions: if a contributor is willing to **own long-term maintenance** (track upstream changes and fix breakage), open a Discussion first to scope the work — maintainers will evaluate and review the PR.
116
+
117
+ Bug-fix PRs for existing desktop compatibility issues are still welcome.
118
+
119
+ ---
120
+
105
121
  ## Release Process (Maintainers)
106
122
 
107
123
  Versioning follows semantic versioning (`MAJOR.MINOR.PATCH`). Full flow:
@@ -226,6 +242,22 @@ npm run test:coverage # c8 覆盖率
226
242
 
227
243
  ---
228
244
 
245
+ ## 范围：平台适配与封装 PR
246
+
247
+ DSH 上游仍处于 developer preview 阶段，API 与服务接口变动频繁。在 DSH 稳定（RC 或正式版）之前，以下方向的 PR **不作为优先项**，且会以额外谨慎的态度审查：
248
+
249
+ - 桌面端适配（例如基于 `dsh web` 的 Tauri/Electron 桌面壳）
250
+ - 独立 CLI 封装
251
+ - 把 dsh-mneme 移植/封装到其他插件体系
252
+
253
+ 这类 PR 往往绑定不稳定的上游接口——上游一次变动就可能使其失效，而维护责任会落到本项目头上。当前唯一受支持的平台是 **Web Profile**（`dsh web`）。
254
+
255
+ 例外：如果贡献者愿意**承担长期维护**（跟进上游变更并修复 break），请先开 Discussion 沟通范围，维护者会评估并 review 该 PR。
256
+
257
+ 针对现有 desktop 兼容问题的 **bug 修复 PR 依然欢迎**。
258
+
259
+ ---
260
+
229
261
  ## 发布流程（维护者）
230
262
 
231
263
  版本号遵循语义化版本（`MAJOR.MINOR.PATCH`）。完整流程：
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-3E63DD?style=flat-square" alt="license"></a>
11
11
  <a href="https://github.com/modusensus/dsh-mneme/actions"><img src="https://img.shields.io/github/actions/workflow/status/modusensus/dsh-mneme/test.yml?style=flat-square&label=CI" alt="CI"></a>
12
12
  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-24%2B-3E63DD?style=flat-square&logo=nodedotjs&logoColor=white" alt="node"></a>
13
- <a href="https://github.com/modusensus/dsh-mneme"><img src="https://img.shields.io/badge/tests-810%20passed-3E63DD?style=flat-square" alt="tests"></a>
13
+ <a href="https://github.com/modusensus/dsh-mneme"><img src="https://img.shields.io/badge/tests-812%20passed-3E63DD?style=flat-square" alt="tests"></a>
14
14
  <a href="https://codecov.io/gh/modusensus/dsh-mneme"><img src="https://img.shields.io/codecov/c/github/modusensus/dsh-mneme/main?style=flat-square" alt="coverage"></a>
15
15
  <a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="Awesome"></a>
16
16
  </p>
@@ -110,6 +110,7 @@ dsh web
110
110
  | **v0.7.5** | 分层记忆类型 user/fact + Web 总览视图 + stats 端点 | ✅ |
111
111
  | **v0.7.6** | issue #48 修复：截断/前缀 id 也能精确操作（统一 resolveMemoryId）+ client.js 改 src 正源 | ✅ |
112
112
  | **v0.7.7** | issue #23 图谱回填：sleep 批量实体抽取 phase + node:sqlite 兼容修复 | ✅ |
113
+ | **v0.7.8** | issues #58 #59 修复：DSH 0.1.2-rc.1 兼容——Session.events 改为 snapshotEvents() 垫片，autoSummarize 与 hot-context 注入恢复 | ✅ |
113
114
  | **v0.8.0** | 图谱增强：兴趣漂移可视化 + scope 隔离（issue #17）+ 跨 workspace 共享 | 🚧 计划中（9 月末） |
114
115
 
115
116
  ## 🧪 本地开发
@@ -117,7 +118,7 @@ dsh web
117
118
  ```bash
118
119
  cd dsh-mneme
119
120
  npm install
120
- npm test # 810 个测试
121
+ npm test # 812 个测试
121
122
  npm run stress # 三轴线压测
122
123
  npm run sync # src → lib 同步
123
124
  ```
@@ -217,6 +218,8 @@ Works out of the box. Enable these as needed:
217
218
  | **v0.7.4** | Issue #40 prompt-brace escaping + Issue #41 overlay close-button overlap fix | ✅ |
218
219
  | **v0.7.5** | Layered memory types (user/fact) + Overview view + stats endpoint | ✅ |
219
220
  | **v0.7.6** | Issue #48 fix: truncated/prefix ids resolve for exact ops (unified resolveMemoryId) + client.js now src-authored | ✅ |
221
+ | **v0.7.7** | Issue #23 graph backfill: sleep batch entity extraction phase + node:sqlite compat fix | ✅ |
222
+ | **v0.7.8** | Issues #58 #59 fix: DSH 0.1.2-rc.1 compat — Session.events moved to snapshotEvents() shim; autoSummarize & hot-context injection restored | ✅ |
220
223
  | **v0.8.0** | Graph enhancement: interest-drift visualization + scope isolation (issue #17) + cross-workspace sharing | 🚧 Planned (late Sep) |
221
224
 
222
225
  ## 🧪 Local Development
@@ -224,7 +227,7 @@ Works out of the box. Enable these as needed:
224
227
  ```bash
225
228
  cd dsh-mneme
226
229
  npm install
227
- npm test # 810 tests
230
+ npm test # 812 tests
228
231
  npm run stress # three-axis stress test
229
232
  npm run sync # src → lib sync
230
233
  ```
package/dsh-mneme/CHANGELOG.md CHANGED
@@ -1,17 +1,26 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.7.8] - 2026-09-06
4
+
5
+ ### 🐛 修复：DSH 0.1.2-rc.1 兼容（issues #58 #59）
6
+
7
+ - **现象**：DSH 0.1.2-rc.1 起官方移除 `Session.events` 属性、改为 `snapshotEvents()` 方法。autoSummarize（会话摘要）与 hot-context（短期上下文）注入都依赖 `session.events` 读取会话事件，升级后取到 undefined 而**静默失效**——会话摘要不再落库、短期上下文块不再渲染。
8
+ - **修复**：`src/summarize.js` 与 `src/inject.js` 两处取事件统一改为兼容垫片 `session.snapshotEvents?.() ?? session.events`——0.1.2-rc.1 及以后走新方法，更早 0.1.x 仍走 `.events`，**新旧 DSH 通吃**。
9
+ - **说明**：兼容垫片，老版本 DSH（0.1.x 早期）行为完全不受影响，无需任何配置改动。
10
+ - 新增 2 个回归用例（会话只提供 `snapshotEvents()` 时 hot-context 渲染与会话摘要均恢复），全套 **812 通过**。
11
+
3
12
  ## [0.7.7] - 2026-09-05
4
13
 
5
14
  ### 🆕 issue #23：sleep 批量实体抽取回填实体图谱
6
15
 
7
16
  - **背景**：写路径抽取（index.js）只有 `entityExtractionEnabled` 开启才触发——每次写入一次 LLM 调用，是刻意的成本取舍——所以默认安装下记忆从不累积实体，这正是 issue #23 报的"实体图谱面板一片空白"（用户明明有很多记忆）。
8
17
  - **新增 sleep 批量抽取 phase**：默认关 `sleepEntityExtractionEnabled`，开睡循环时按**最老优先**把没有实体属性的记忆逐条过 `extractEntities`（每轮上限 `sleepEntityExtractionMaxPerRun` 默认 20）。
9
- - **下沉为有界 SQL 查询**（kimi 复验意见 #2）：新增 `store.listForEntityExtraction({limit, offset})`，`WHERE` 只留行级条件（未归档/未遗忘/非 summary/内容非空/`metadata.entity_extracted_at` 为空），`ORDER BY created_at LIMIT ? OFFSET ?` 分页取最老候选；实体是否已存在是跨表检查（`getAttrsByMemory`），由 JS 在每页上过滤。不再 `service.all()` 全表加载。
10
- - **幂等防重**（kimi 意见 #3）：抽取前先 stamp `metadata.pending_extracted_at`，成功后替换为 `entity_extracted_at`，失败清除 pending——一条记忆不会被并发/崩溃重复抽取，失败的下轮重试。
11
- - **metadata 合并不覆盖**（kimi 意见 #4）：`store.setMemoryMetadata` 改为 merge 语义，打实体时间戳不会抹掉其他路径刚写入的 metadata 字段。
12
- - **失败不阻断**（kimi 意见 #5）：单条抽取失败只跳过该条、记入 `failed` 计数，整轮状态由 `deriveStatus` 正确折叠 `failed`——一次 LLM 抖动不会 abort 整个 sleep 周期。
13
- - **node:sqlite 兼容修复**（复验时抓到的实现 bug）：wxbot 初版用 better-sqlite3 的 `.pluck()`（node:sqlite 不存在），改为 `.all().map(row => getById(row.id))`；`listForEntityExtraction` 的 `forgotten IS NULL` 条件与 `save` 硬编码写入的 `forgotten=0` 永不匹配导致查询恒空，修正为 `(forgotten = 0 OR forgotten IS NULL)`（与 archived 同构）。
14
- - 新增 9 个用例（禁用/跳过、stamp 不重复、无实体也 stamp、backfill、失败重试、metadata merge #4、pending 清除 #3、failed 状态折叠 #5、分页最老优先 #2），全套 **810 通过**。
18
+ - **下沉为有界 SQL 查询**：新增 `store.listForEntityExtraction({limit, offset})`，`WHERE` 只留行级条件（未归档/未遗忘/非 summary/内容非空/`metadata.entity_extracted_at` 为空），`ORDER BY created_at LIMIT ? OFFSET ?` 分页取最老候选；实体是否已存在是跨表检查（`getAttrsByMemory`），由 JS 在每页上过滤。不再 `service.all()` 全表加载。
19
+ - **幂等防重**：抽取前先 stamp `metadata.pending_extracted_at`，成功后替换为 `entity_extracted_at`，失败清除 pending——一条记忆不会被并发/崩溃重复抽取，失败的下轮重试。
20
+ - **metadata 合并不覆盖**：`store.setMemoryMetadata` 改为 merge 语义，打实体时间戳不会抹掉其他路径刚写入的 metadata 字段。
21
+ - **失败不阻断**：单条抽取失败只跳过该条、记入 `failed` 计数，整轮状态由 `deriveStatus` 正确折叠 `failed`——一次 LLM 抖动不会 abort 整个 sleep 周期。
22
+ - **node:sqlite 兼容修复**：初版实现用 better-sqlite3 的 `.pluck()`（node:sqlite 不存在），改为 `.all().map(row => getById(row.id))`；`listForEntityExtraction` 的 `forgotten IS NULL` 条件与 `save` 硬编码写入的 `forgotten=0` 永不匹配导致查询恒空，修正为 `(forgotten = 0 OR forgotten IS NULL)`（与 archived 同构）。
23
+ - 新增 9 个用例（禁用/跳过、stamp 不重复、无实体也 stamp、backfill、失败重试、metadata merge、pending 清除、failed 状态折叠、分页最老优先），全套 **810 通过**。
15
24
 
16
25
  ## [0.7.6] - 2026-09-02
17
26
 
package/dsh-mneme/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  [![npm version](https://img.shields.io/npm/v/@modusensus/dsh-mneme?color=blue&label=npm)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
6
6
  [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
7
7
  [![Awesome](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
8
- [![tests](https://img.shields.io/badge/tests-810%20passed-success)](https://github.com/modusensus/dsh-mneme)
8
+ [![tests](https://img.shields.io/badge/tests-812%20passed-success)](https://github.com/modusensus/dsh-mneme)
9
9
  [![CI](https://img.shields.io/github/actions/workflow/status/modusensus/dsh-mneme/test.yml)](https://github.com/modusensus/dsh-mneme/actions)
10
10
  [![node](https://img.shields.io/badge/node-24%2B-blue)](https://nodejs.org)
11
11
  [![npm downloads](https://img.shields.io/npm/dm/@modusensus/dsh-mneme?color=blue&label=downloads)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
@@ -241,7 +241,8 @@ v0.3.0 起新增**记忆基因**层：从记忆里抽取**命名实体**、**带
241
241
 
242
242
  | 版本 | 亮点 |
243
243
  |------|------|
244
- | **v0.7.7** | issue #23 实体图谱回填：sleep 批量实体抽取 phase（`sleepEntityExtractionEnabled` 默认关；最老优先、SQL LIMIT/OFFSET 分页下沉为有界查询不整表扫描；`pending_extracted_at` 幂等防重、成功/失败清除；metadata 合并不覆盖其他路径写入）；kimi-k2.7-code 复验 + node:sqlite 兼容修复（pluck→all+map、`forgotten=0` 查询条件）；810 测试全绿 |
244
+ | **v0.7.8** | DSH 0.1.2-rc.1 兼容（issues #58 #59）：官方移除 `Session.events` 属性改为 `snapshotEvents()` 方法，autoSummarize 与 hot-context（短期上下文）注入取不到事件而失效；改用兼容垫片 `session.snapshotEvents?.() ?? session.events`，新旧 DSH 通吃，老版本行为不受影响；新增 2 个回归用例；812 测试全绿 |
245
+ | **v0.7.7** | issue #23 实体图谱回填：sleep 批量实体抽取 phase（`sleepEntityExtractionEnabled` 默认关；最老优先、SQL LIMIT/OFFSET 分页下沉为有界查询不整表扫描；`pending_extracted_at` 幂等防重、成功/失败清除；metadata 合并不覆盖其他路径写入）；node:sqlite 兼容修复（pluck→all+map、`forgotten=0` 查询条件）；810 测试全绿 |
245
246
  | **v0.7.6** | issue #48 修复：`memory_update`/`memory_delete`/`memory_forget`/`memory_archive` 支持截断/前缀短 id（新增 `service.resolveMemoryId`：精确命中优先 + 唯一前缀解析 + 多命中拒绝列出候选 + `memory_delete` 未命中幂等补 `logger.warn`；纯通配符/空白兜底）；Web bundle `client.js` 改 src 正源；801 测试全绿 |
246
247
  | **v0.7.5** | 分层记忆类型：新增 `user`（用户画像）/`fact`（原子事实）轻量记忆类型（单表 `type` 扩展，不动 schema）+ Web 面板「总览」视图（记忆分层卡片 + 用户画像卡 + 类型分布 + 近 7 天趋势）+ `/api/dsh-mneme/stats` 统计端点；kimi-k2.7-code 复验（days 整数化等）；790 测试全绿 |
247
248
  | **v0.7.4** | issue #40 修复：记忆内容含 `{{...}}` 模板语法时整轮崩溃（注入边界 run-based 花括号转义 `{{a}}`→`{\{a\}\}`，奇数连续如 `{{{a}}}` 也不残留字面 `{{`；新增 `escapePromptVariables` 配置默认开）；issue #41 修复：记忆窗口关闭按钮与宿主窗口控制按钮重叠无法点击（顶栏左对齐，关闭按钮离开右上角宿主控制区）；782 测试全绿 |
@@ -297,7 +298,8 @@ v0.3.0 起新增**记忆基因**层：从记忆里抽取**命名实体**、**带
297
298
  | **v0.7.3** | ✅ 完成 | issue #38 新功能 | 左下角入口按钮可选开关 `showSidebarTrigger`（默认开，settings-over-config）；Web 面板设置一键关闭，与 dsh-cost-meter 等 footer 插件冲突可隐藏按钮、记忆库标签不受影响；776 测试全绿 |
298
299
  | **v0.7.4** | ✅ 完成 | issue #40 + #41 修复 | 注入边界 run-based 花括号转义（`{{a}}`→`{\{a\}\}`、奇数连续如 `{{{a}}}` 不残留字面，`escapePromptVariables` 默认开）+ 记忆窗口顶栏左对齐、关闭按钮避开宿主窗口控制按钮区；782 测试全绿 |
299
300
  | **v0.7.5** | ✅ 完成 | 分层记忆类型 + 总览视图 | 借鉴 meow-memory 分层概念、贴合单表架构：新增 `user`（用户画像）/`fact`（原子事实）类型，注入/镜像/梦境/质量过滤全链路打通；Web 面板「总览」视图（分层卡片 + 用户画像卡 + 类型分布 + 近 7 天趋势）；`/api/dsh-mneme/stats` 端点；kimi-k2.7-code 复验；790 测试全绿 |
300
- | **v0.7.7** | ✅ 完成 | issue #23 图谱回填 | sleep 批量实体抽取 phase：默认关 `sleepEntityExtractionEnabled`，按最老优先、SQL LIMIT/OFFSET 分页（下沉为有界查询，不再整表扫描）批量抽取未打标记忆的实体（修复 issue #23 实体图谱空白）；`pending_extracted_at` 幂等防重、成功/失败清除，metadata 合并不覆盖；kimi-k2.7-code 复验 + node:sqlite 兼容修复（pluck→all+map、`forgotten=0` 查询条件）；810 测试全绿 |
301
+ | **v0.7.7** | ✅ 完成 | issue #23 图谱回填 | sleep 批量实体抽取 phase：默认关 `sleepEntityExtractionEnabled`，按最老优先、SQL LIMIT/OFFSET 分页（下沉为有界查询，不再整表扫描）批量抽取未打标记忆的实体（修复 issue #23 实体图谱空白）；`pending_extracted_at` 幂等防重、成功/失败清除，metadata 合并不覆盖；node:sqlite 兼容修复（pluck→all+map、`forgotten=0` 查询条件）；810 测试全绿 |
302
+ | **v0.7.8** | ✅ 完成 | DSH 0.1.2-rc.1 兼容（issues #58 #59） | 官方移除 `Session.events` 属性、改用 `snapshotEvents()` 方法后 autoSummarize 与 hot-context 注入失效；改为兼容垫片 `session.snapshotEvents?.() ?? session.events`，新旧 DSH 通吃，老版本不受影响；新增 2 个回归用例；812 测试全绿 |
301
303
  | **v0.7.6** | ✅ 完成 | issue #48 修复 | 四工具统一 `service.resolveMemoryId`：截断/前缀短 id 也能精确操作（精确命中优先、唯一前缀解析、多命中拒绝并列出候选、`memory_delete` 未命中幂等返回 + `logger.warn` 留痕）；Web bundle `client.js` 改 src 正源；801 测试全绿 |
302
304
  | **v0.8.0** | 🚧 计划中（9 月末） | 图谱增强 | 兴趣漂移可视化 + scope 隔离（issue #17）+ 跨 workspace 记忆共享 + 更多 heat 信号 |
303
305
 
@@ -307,7 +309,7 @@ v0.3.0 起新增**记忆基因**层：从记忆里抽取**命名实体**、**带
307
309
 
308
310
  ### 前置条件
309
311
 
310
- - [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）
312
+ - [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）— 兼容 DSH 0.1.x，已验证 0.1.2-rc.1（`Session.events` → `snapshotEvents()` 变更已由插件垫片兼容，新旧版本通吃）
311
313
  - Node 24+（`node:sqlite`）
312
314
 
313
315
  ### 安装步骤
@@ -464,7 +466,7 @@ src/
464
466
  ├── client.js # Web 面板 bundle（ModuleLoader 自注册；v0.7.6 起 src 正源）
465
467
  └── index.js # 插件接线
466
468
  lib/ # src 的同步分发产物（npm run sync，prepack 自动执行；无手写例外）
467
- test/ # 810 个 node:test 测试（含审计与三轴线压测不变量）
469
+ test/ # 812 个 node:test 测试（含审计与三轴线压测不变量）
468
470
  scripts/ # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压测 · sync-lib.js 同步 · benchmark-recall.js 召回基准
469
471
  ```
470
472
 
@@ -473,7 +475,7 @@ scripts/ # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压
473
475
  ```bash
474
476
  cd dsh-mneme
475
477
  npm install # 安装 peer 依赖（以 devDependencies 形式，用于本地测试）
476
- npm test # 运行 810 个测试
478
+ npm test # 运行 812 个测试
477
479
  npm run stress # 三轴线压测：长会话检索 / 冲突仲裁 / 多 Agent 并发（离线 mock LLM）
478
480
  npm run sync # 把 src/ 同步到 lib/（发布时由 prepack 钩子自动执行）
479
481
  ```
package/dsh-mneme/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@modusensus/dsh-mneme",
3
3
  "description": "Cross-session memory plugin for DeepSeek Harness with autoDream consolidation: SQLite store, Markdown mirrors, 7 model tools, automatic injection, session summarization, user profile/rules, custom slash commands, vector (semantic) search, and a Web GUI panel",
4
- "version": "0.7.7",
4
+ "version": "0.7.8",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
package/dsh-mneme/src/inject.js CHANGED
@@ -8,7 +8,7 @@ import { createHotMemory } from "./hot-memory.js";
8
8
  // falls back to the legacy rule-based pick, never breaking the render.
9
9
  function lastUserQuery(ctx) {
10
10
  try {
11
- const events = ctx?.agent?.session?.events;
11
+ const events = ctx?.agent?.session?.snapshotEvents?.() ?? ctx?.agent?.session?.events;
12
12
  if (!Array.isArray(events) || events.length === 0) return "";
13
13
  for (let i = events.length - 1; i >= 0; i--) {
14
14
  const event = events[i];
@@ -34,7 +34,7 @@ function lastUserQuery(ctx) {
34
34
  // returns [] on any failure, and the hot block simply does not render.
35
35
  function extractRounds(ctx, maxRounds) {
36
36
  try {
37
- const events = ctx?.agent?.session?.events;
37
+ const events = ctx?.agent?.session?.snapshotEvents?.() ?? ctx?.agent?.session?.events;
38
38
  if (!Array.isArray(events) || events.length === 0) return [];
39
39
  const rounds = [];
40
40
  let pendingQuery = null;
package/dsh-mneme/src/summarize.js CHANGED
@@ -78,7 +78,9 @@ function toProtocolChunk(chunk) {
78
78
  // check below.
79
79
  function collectMessages(session) {
80
80
  const messages = [];
81
- for (const event of session.events ?? []) {
81
+ // DSH 0.1.2-rc.1 起 Session 改用 snapshotEvents()，兼容旧版 .events
82
+ const events = session.snapshotEvents?.() ?? session.events ?? [];
83
+ for (const event of events) {
82
84
  const kind = event.data?.source?.kind;
83
85
  if (event.type !== "user/message") continue;
84
86
  if (kind !== undefined && kind !== "user") continue;
package/dsh-mneme/test/inject.test.js CHANGED
@@ -179,6 +179,24 @@ test("issue #40: hot-context rounds with {{...}} are escaped", () => {
179
179
  assert.ok(!text.includes("}}"), "no raw }} in hot context");
180
180
  });
181
181
 
182
+ test("session with only snapshotEvents() (DSH 0.1.2-rc.1) still renders hot context", () => {
183
+ const { contexts } = setup();
184
+ const text = contexts[0].text({
185
+ agent: {
186
+ session: {
187
+ id: "s1",
188
+ snapshotEvents: () => [
189
+ { type: "user/message", data: { source: { kind: "user" }, content: ["用快照接口提问"] } },
190
+ { type: "assistant/message", data: { source: { kind: "assistant" }, content: ["快照返回的答复"] } }
191
+ ]
192
+ }
193
+ }
194
+ });
195
+ assert.ok(text.includes("[短期上下文]"), "hot context rendered");
196
+ assert.ok(text.includes("用快照接口提问"), "user query picked up from snapshotEvents");
197
+ assert.ok(text.includes("快照返回的答复"), "assistant reply picked up from snapshotEvents");
198
+ });
199
+
182
200
  test("issue #40: escapePromptVariables=false passes {{...}} through verbatim", () => {
183
201
  const { contexts, service } = setup({ escapePromptVariables: false });
184
202
  service.saveWithDedupe({ type: "preference", title: "模板", content: "{{挖空}} 与 {{hl|term}}", importance: 5 });
package/dsh-mneme/test/summarize.test.js CHANGED
@@ -85,6 +85,21 @@ test("turn/end event triggers summarization and stores entries", async () => {
85
85
  assert.ok(all.some((m) => m.type === "preference"));
86
86
  });
87
87
 
88
+ test("session with only snapshotEvents() (DSH 0.1.2-rc.1) still summarizes", async () => {
89
+ const { events, store } = setup();
90
+ const handler = events.find((e) => e.name === "session/event").fn;
91
+ const session = {
92
+ id: "s6",
93
+ requestHeader: () => ({ config: { provider: "deepseek", model: "deepseek-chat" } }),
94
+ snapshotEvents: () => [userMessage("用快照接口提问"), { seq: 2, type: "turn/end" }]
95
+ };
96
+ await handler(session, { seq: 2, type: "turn/end" });
97
+ assert.equal(store.count(), 2);
98
+ const all = store.all();
99
+ assert.ok(all.some((m) => m.type === "decision"));
100
+ assert.ok(all.some((m) => m.type === "preference"));
101
+ });
102
+
88
103
  test("skips summarization for events other than turn/end", async () => {
89
104
  const { events, store, calls } = setup();
90
105
  const handler = events.find((e) => e.name === "session/event").fn;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@modusensus/dsh-mneme",
3
- "version": "0.7.7",
3
+ "version": "0.7.8",
4
4
  "description": "Structured memory engine for DeepSeek Harness. Offline semantic search, entity-attribute-timeline, autoDream self-consolidation, and human-editable Markdown storage.",
5
5
  "license": "MIT",
6
6
  "repository": {