sage-mem 0.5.1 → 0.5.3

package/README.md

@@ -4,6 +4,10 @@
 
 记忆存在**本地 markdown 文件**里（frontmatter + 正文），不是数据库。透明、可检查、防膨胀。
 
+> **DSH 版本兼容性（0.5.3 核对于 `0.1.7-rc.1`）**
+> `session.deriveMessages()`（仍是同步）、`system-prompt/assemble` 事件、以及 `context.agent.session` 这条链，在 0.1.6 → 0.1.7 之间**均未改变**，本插件在 0.1.7 上无需改动即可工作。
+> 0.5.3 另加了一层防御：`deriveMessages()` 若哪天被改成异步，或 `Session` 上的历史读取接口被改名（0.1.7 起 `snapshotEvents` / `eventAt` / `ownEvents` 已标记弃用），插件会在**日志里报警**，而不是像以前那样静默地不再注入记忆。0.1.6 上的行为与 0.5.2 完全一致。
+
 ## 从 Claude Code 无损迁移
 
 你已经在 Claude Code（CC）里养了一个 agent，舍不得它的记忆和人格？sage-mem 是「CC → DSH」迁移方案的一部分，**记忆与人格都能无损搬过来**：
@@ -88,6 +92,13 @@ sage-mem 是纯 DSH 插件，在 `package.json` 的 `dsh.compatibility.dshReleas
 | 0.1.3-alpha.1 | compatible |
 | 0.1.3-alpha.2 | compatible |
 | 0.1.5-rc.1 | compatible |
+| 0.1.6-alpha.1 | compatible |
+| 0.1.6-alpha.2 | compatible |
+
+自 DSH `0.1.6-alpha.2` 起，TypertCodec 契约从「读 `schema`」改为「读 `create()` 工厂」——
+仍只写 `schema:` 的插件会在注册阶段直接抛错，导致整棵插件树加载失败。自 0.5.2 起每个 codec
+同时带 `schema` 与 `create: () => schema`，因此**同一份构建同时兼容 alpha.1 及更早（读
+schema）与 alpha.2 及以后（读 create）**，升级 DSH 时不需要换插件版本。
 
 Node.js 要求 `>= 18`（见 `engines.node`）。
 

package/lib/client.js

@@ -63,7 +63,7 @@ const StarmapRuntime = (function (require, _react) {
 					method: "listStars",
 					invocation: { kind: "direct" },
 					parameters: [],
-					result: { mode: "strict", typeSymbol: "sage-starmap/types#StarList", schema: listSchema },
+					result: { mode: "strict", typeSymbol: "sage-starmap/types#StarList", schema: listSchema, create: () => listSchema },
 					sourceLocation: { "file": "workspace/sage-starmap/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
@@ -73,9 +73,9 @@ const StarmapRuntime = (function (require, _react) {
 					method: "readFile",
 					invocation: { kind: "direct" },
 					parameters: [
-						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-starmap/types#FileName", schema: strSchema } },
+						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-starmap/types#FileName", schema: strSchema, create: () => strSchema } },
 					],
-					result: { mode: "strict", typeSymbol: "sage-starmap/types#FileContent", schema: readSchema },
+					result: { mode: "strict", typeSymbol: "sage-starmap/types#FileContent", schema: readSchema, create: () => readSchema },
 					sourceLocation: { "file": "workspace/sage-starmap/lib/index.js", "line": 1, "column": 1 },
 				},
 			],
@@ -1357,7 +1357,7 @@ const StarmapRuntime = (function (require, _react) {
 					method: "listFiles",
 					invocation: { kind: "direct" },
 					parameters: [],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#FileList", schema: listSchema },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#FileList", schema: listSchema, create: () => listSchema },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
@@ -1367,9 +1367,9 @@ const StarmapRuntime = (function (require, _react) {
 					method: "readFile",
 					invocation: { kind: "direct" },
 					parameters: [
-						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema } },
+						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
 					],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#FileContent", schema: readSchema },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#FileContent", schema: readSchema, create: () => readSchema },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
@@ -1379,10 +1379,10 @@ const StarmapRuntime = (function (require, _react) {
 					method: "writeFile",
 					invocation: { kind: "direct" },
 					parameters: [
-						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema } },
-						{ name: "content", wire: "content", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileContent", schema: strSchema } },
+						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
+						{ name: "content", wire: "content", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileContent", schema: strSchema, create: () => strSchema } },
 					],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#WriteResult", schema: writeSchema },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#WriteResult", schema: writeSchema, create: () => writeSchema },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
@@ -1392,9 +1392,9 @@ const StarmapRuntime = (function (require, _react) {
 					method: "deleteFile",
 					invocation: { kind: "direct" },
 					parameters: [
-						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema } },
+						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
 					],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#DeleteResult", schema: deleteSchema },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#DeleteResult", schema: deleteSchema, create: () => deleteSchema },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
@@ -1404,7 +1404,7 @@ const StarmapRuntime = (function (require, _react) {
 					method: "listStars",
 					invocation: { kind: "direct" },
 					parameters: [],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#StarmapList", schema: starmapListSchema },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#StarmapList", schema: starmapListSchema, create: () => starmapListSchema },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 				{
@@ -1414,9 +1414,9 @@ const StarmapRuntime = (function (require, _react) {
 					method: "readFile",
 					invocation: { kind: "direct" },
 					parameters: [
-						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema } },
+						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
 					],
-					result: { mode: "strict", typeSymbol: "sage-mem/types#StarmapRead", schema: starmapReadSchema },
+					result: { mode: "strict", typeSymbol: "sage-mem/types#StarmapRead", schema: starmapReadSchema, create: () => starmapReadSchema },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
 			],

package/lib/index.js

@@ -36,7 +36,7 @@ const MAX_BASELINE = 5
  *      frontmatter 里的 originSessionId / birthday 等字段一并抹掉。
  *
  * 判定依据是「丢了能不能从别处重建」：memory 目录**不在任何版本控制下**
- * （在 E:\shengdian 下 `git rev-parse` 直接报 not a git repository），
+ * （该目录里没有 .git，`git rev-parse` 直接报 not a git repository），
  * deleteFile 是 unlink、没有回收站，所以宁严勿松。
  * 这几个文件要改，用文件工具直接编辑。
  */
@@ -246,8 +246,17 @@ export class MemoryGateway extends TypertRemoteService {
       try {
         const agent = context?.agent
         const session = agent?.session
-        if (!session || typeof session.deriveMessages !== 'function') return assembled
-        const messages = [...session.deriveMessages()]
+        if (!session) return assembled
+        // DSH 0.1.7 起 Session 的历史读取接口在陆续调整（snapshotEvents / eventAt /
+        // ownEvents 已弃用）。deriveMessages 在 0.1.7-rc.1 实测仍在且仍同步，但这三行
+        // 不是白写的：方法一旦被改名或改成异步，老写法要么静默不注入、要么把 Promise
+        // 当数组展开成空。宁可日志里响一声，也不要"记忆不注入但日志一字没有"。
+        if (typeof session.deriveMessages !== 'function') {
+          warnLog(ctx, 'session.deriveMessages() 不可用 —— 记忆召回已跳过（DSH session API 变了？）', sessionId)
+          return assembled
+        }
+        const derived = session.deriveMessages()
+        const messages = [...(derived && typeof derived.then === 'function' ? await derived : derived)]
 
         // 关键：DSH 0.1.5 把工具结果（source.kind === 'tool'）和注入内容
         // （source.kind === 'plugin'）也存成 role: 'user' 的消息。只按 role 取

package/lib/typert.host.js

@@ -66,7 +66,7 @@ export const TYPERT = {
 			method: 'listFiles',
 			invocation: { kind: 'direct' },
 			parameters: [],
-			result: { mode: 'strict', typeSymbol: 'sage-mem/types#FileList', schema: listResultSchema },
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#FileList', schema: listResultSchema, create: () => listResultSchema },
 			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 		},
 		{
@@ -76,9 +76,9 @@ export const TYPERT = {
 			method: 'readFile',
 			invocation: { kind: 'direct' },
 			parameters: [
-				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema } },
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
 			],
-			result: { mode: 'strict', typeSymbol: 'sage-mem/types#FileContent', schema: readResultSchema },
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#FileContent', schema: readResultSchema, create: () => readResultSchema },
 			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 		},
 		{
@@ -88,10 +88,10 @@ export const TYPERT = {
 			method: 'writeFile',
 			invocation: { kind: 'direct' },
 			parameters: [
-				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema } },
-				{ name: 'content', wire: 'content', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileContent', schema: fileContentSchema } },
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
+				{ name: 'content', wire: 'content', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileContent', schema: fileContentSchema, create: () => fileContentSchema } },
 			],
-			result: { mode: 'strict', typeSymbol: 'sage-mem/types#WriteResult', schema: writeResultSchema },
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#WriteResult', schema: writeResultSchema, create: () => writeResultSchema },
 			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 		},
 		{
@@ -101,9 +101,9 @@ export const TYPERT = {
 			method: 'deleteFile',
 			invocation: { kind: 'direct' },
 			parameters: [
-				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema } },
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
 			],
-			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DeleteResult', schema: deleteResultSchema },
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DeleteResult', schema: deleteResultSchema, create: () => deleteResultSchema },
 			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 		},
 		{
@@ -113,7 +113,7 @@ export const TYPERT = {
 			method: 'listStars',
 			invocation: { kind: 'direct' },
 			parameters: [],
-			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapList', schema: starmapListSchema },
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapList', schema: starmapListSchema, create: () => starmapListSchema },
 			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 		},
 		{
@@ -123,9 +123,9 @@ export const TYPERT = {
 			method: 'readFile',
 			invocation: { kind: 'direct' },
 			parameters: [
-				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema } },
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
 			],
-			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapRead', schema: starmapReadSchema },
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapRead', schema: starmapReadSchema, create: () => starmapReadSchema },
 			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 		},
 	],

package/package.json

@@ -1,69 +1,71 @@
-{
-  "name": "sage-mem",
-  "description": "File-based memory plugin for DeepSeek Harness (DSH) — cross-session memory in transparent markdown files, with a memory star-map view",
-  "version": "0.5.1",
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./client": "./lib/client.js",
-    "./typert": "./lib/typert.host.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib/index.js",
-    "lib/client.js",
-    "lib/typert.host.js",
-    "cordis.patch.yml",
-    "NOTICE"
-  ],
-  "license": "Apache-2.0",
-  "engines": {
-    "node": ">=18"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-locale"
-      ]
-    },
-    "compatibility": {
-      "dsh": ">=0.1.2-rc.1",
-      "dshReleases": {
-        "0.1.2-rc.1": "compatible",
-        "0.1.3-alpha.1": "compatible",
-        "0.1.3-alpha.2": "compatible",
-        "0.1.5-rc.1": "compatible"
-      }
-    }
-  },
-  "dependencies": {
-    "zod": "^4.4.3"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
-    "react": "^18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gezi-wen/sage-mem.git"
-  },
-  "keywords": [
-    "memory",
-    "ai-memory",
-    "long-term-memory",
-    "markdown",
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "ai-agent",
-    "agent",
-    "claude-code"
-  ]
-}
+{
+  "name": "sage-mem",
+  "description": "File-based memory plugin for DeepSeek Harness (DSH) — cross-session memory in transparent markdown files, with a memory star-map view",
+  "version": "0.5.3",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./typert": "./lib/typert.host.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/typert.host.js",
+    "cordis.patch.yml",
+    "NOTICE"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    },
+    "compatibility": {
+      "dsh": ">=0.1.2-rc.1",
+      "dshReleases": {
+        "0.1.2-rc.1": "compatible",
+        "0.1.3-alpha.1": "compatible",
+        "0.1.3-alpha.2": "compatible",
+        "0.1.5-rc.1": "compatible",
+        "0.1.6-alpha.1": "compatible",
+        "0.1.6-alpha.2": "compatible"
+      }
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "react": "^18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gezi-wen/sage-mem.git"
+  },
+  "keywords": [
+    "memory",
+    "ai-memory",
+    "long-term-memory",
+    "markdown",
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "ai-agent",
+    "agent",
+    "claude-code"
+  ]
+}