sage-mem 0.5.0 → 0.5.2

package/README.md

@@ -88,6 +88,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 },
 				},
 			],
@@ -1641,7 +1641,9 @@ const StarmapRuntime = (function (require, _react) {
 				const safeName = name.endsWith(".md") ? name : name + ".md";
 				const content = buildFrontmatter(type, formDesc.trim()) + formBody;
 				remote.writeFile(safeName, content)
-					.then(function () {
+					.then(function (r) {
+						// host 侧对保留名 / 非字符串内容 / 超限一律返回 { ok: false, error }，不再抛异常。
+						if (r && r.ok === false) { setError(r.error || "写入被拒绝"); return; }
 						closeForm();
 						setNotice(editingFile ? "已更新 " + safeName : "已保存 " + safeName);
 						load();
@@ -1653,7 +1655,8 @@ const StarmapRuntime = (function (require, _react) {
 			function confirmDelete(file) {
 				setBusy(true); setError(null); setNotice("");
 				remote.deleteFile(file)
-					.then(function () {
+					.then(function (r) {
+						if (r && r.ok === false) { setError(r.error || "删除被拒绝"); return; }
 						setDeleting(null);
 						setNotice("已删除 " + file);
 						load();

package/lib/index.js

@@ -15,7 +15,7 @@
 
 import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol'
 import { homedir } from 'node:os'
-import { readFile, readdir, writeFile, unlink, stat } from 'node:fs/promises'
+import { readFile, readdir, writeFile, rename, unlink, stat } from 'node:fs/promises'
 import { join, basename } from 'node:path'
 
 const MEMORY_DIR = process.env.SAGE_MEM_DIR || join(homedir(), '.sage-mem', 'memory')
@@ -23,6 +23,53 @@ const MAX_RESULTS = 5
 const MAX_CHARS_PER_FILE = 1500
 const MAX_BASELINE = 5
 
+/**
+ * 保留名：设置页的写/删方法一律不得触碰。
+ *
+ * 列进来的两类文件：
+ *   1. MEMORY.md / session-log.md —— 不是记忆条目：不进检索、不进星图、不出现在
+ *      设置页列表里，它们是索引与追加型流水（session-log.md 已 130+ KB）。
+ *      「+ 添加记忆」表单里手打这两个名字就能整份覆盖，而这个表单是照
+ *      buildFrontmatter() 重建 frontmatter 的，原有内容一个字都留不下。
+ *   2. project_heartscape.md / project_self-cognition.md —— 人格连续性的手写载体
+ *      （AGENTS.md 指定的落盘目标），单副本、纯人工维护；表单写还会把
+ *      frontmatter 里的 originSessionId / birthday 等字段一并抹掉。
+ *
+ * 判定依据是「丢了能不能从别处重建」：memory 目录**不在任何版本控制下**
+ * （在 E:\shengdian 下 `git rev-parse` 直接报 not a git repository），
+ * deleteFile 是 unlink、没有回收站，所以宁严勿松。
+ * 这几个文件要改，用文件工具直接编辑。
+ */
+const RESERVED_FILES = new Set([
+  'MEMORY.md',
+  'session-log.md',
+  'project_heartscape.md',
+  'project_self-cognition.md',
+])
+
+/**
+ * 单文件体积上限（字节）。定 512 KB 的理由：
+ *   - 当前 memory 目录最大的一条正文 19 KB（project_guikit.md），索引与流水都排除在外，
+ *     512 KB 是它的 26 倍，任何正常记忆都够用；
+ *   - 记忆是要塞进 system prompt 的，一条 512 KB 的记忆本身就等于把上下文撑爆——
+ *     到这个量级基本可以判定是写错了目标（比如把日志、代码贴进来）。
+ * 与 lib/typert.host.js 的 fileContentSchema.max(512 * 1024) 保持一致。
+ */
+const MAX_FILE_BYTES = 512 * 1024
+
+/**
+ * 统一告警出口。所有非 ENOENT 的失败都必须落到日志，绝不静默
+ * （历史坑见 assemble 监听器里那段注释：表现是「插件在、记忆不再注入」，日志一字没有）。
+ * @param ctx — 插件上下文，取 ctx.logger.warn
+ * @param msg — 消息正文，调用方负责带上文件名 / 目录名
+ * @param sessionId — 可选 session id，有就带
+ */
+function warnLog(ctx, msg, sessionId) {
+  const line = `sage-mem: ${msg}${sessionId ? ` (session ${sessionId})` : ''}`
+  if (ctx?.logger?.warn) ctx.logger.warn(line)
+  else console.warn(line)
+}
+
 /** 提取消息文本，兼容 content 为字符串或 text-block 数组两种形态。 */
 function extractText(content) {
   if (typeof content === 'string') return content.trim()
@@ -53,7 +100,7 @@ function score(query, text) {
 }
 
 /** 扫 memory 目录，读回全部记忆文件（跳过索引与子目录），并解析 frontmatter 摘要。 */
-async function scanMemoryFiles() {
+async function scanMemoryFiles(ctx, sessionId) {
   try {
     const entries = await readdir(MEMORY_DIR, { withFileTypes: true })
     const names = entries
@@ -69,12 +116,16 @@ async function scanMemoryFiles() {
           description: meta.description || '',
           baseline: parseBaseline(content),
         }
-      } catch {
+      } catch (err) {
+        // 只有 ENOENT 是正常状态（扫到读之间被删）。其余——权限错、编码坏、盘掉线——
+        // 一律出声：这里的静默化就是把「记忆不再注入」变成无声事故的那一手。
+        if (err?.code !== 'ENOENT') warnLog(ctx, `cannot read ${name}: ${err?.message ?? err}`, sessionId)
         return null
       }
     }))
     return loaded.filter(Boolean)
-  } catch {
+  } catch (err) {
+    if (err?.code !== 'ENOENT') warnLog(ctx, `cannot scan ${MEMORY_DIR}: ${err?.message ?? err}`, sessionId)
     return []
   }
 }
@@ -102,17 +153,23 @@ function selectRelevant(query, files) {
 
 /** 解析 frontmatter 的 name/description/type（兼容顶层与 metadata 嵌套两种 type）。 */
 function parseFrontmatter(content) {
-  const m = content.match(/^---\n([\s\S]*?)\n---/)
+  // 换行必须容忍 CRLF：任何用 Windows 编辑器碰过一次的文件都会被换成 \r\n，
+  // 而旧版这里写的是 /^---\n/ —— 匹配失败 → description/type 全空 →
+  // 「baseline 走 parseBaseline 那条带 \r?\n 的正则照旧命中，但这条记忆永远检索不到」，
+  // 症状极具欺骗性。:123 的 parseBaseline 与 :277 的 extractTitle 早已是 \r?\n。
+  const m = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)
   if (!m) return { name: '', description: '', type: '' }
   const body = m[1]
   const grab = (key) => {
-    const hit = body.match(new RegExp(`^${key}:\\s*(.+)$`, 'm'))
+    // [ \t] / [ \t\r] 而不是 \s：\s 会连 CRLF 的 \r 一起吃进捕获组，值尾留一个 \r
+    // 会让下面的引号剥离（["']$）失配，description 尾巴上挂一个残引号。
+    const hit = body.match(new RegExp(`^${key}:[ \\t]*(.+?)[ \\t\\r]*$`, 'm'))
     if (!hit) return ''
     return hit[1].replace(/^["']|["']$/g, '').trim()
   }
   let type = grab('type')
   if (!type) {
-    const nested = body.match(/^metadata:\s*\n(?:\s+[^\n]+\n)*?\s+type:\s*(\S+)/m)
+    const nested = body.match(/^metadata:\s*\r?\n(?:\s+[^\r\n]+\r?\n)*?\s+type:\s*(\S+)/m)
     if (nested) type = nested[1]
   }
   return { name: grab('name'), description: grab('description'), type }
@@ -127,6 +184,25 @@ function parseBaseline(content) {
   return /^(true|yes|1)$/i.test(hit[1].replace(/^["']|["']$/g, '').trim())
 }
 
+/**
+ * 原子写：先写同目录临时文件，再 rename 覆盖目标。
+ *
+ * 直写的风险是崩在中途（断电、进程被杀、磁盘满）留下半截文件 —— frontmatter
+ * 缺半边，这条记忆从此解析不出来、检索不到，而文件看上去还在。
+ * 同卷 rename 是原子的：读方要么看到旧全文、要么看到新全文，不存在中间态。
+ * 任何一步失败都不碰目标文件，临时文件收尾清掉。
+ */
+async function writeFileAtomic(target, content) {
+  const tmp = `${target}.${process.pid}.tmp`
+  try {
+    await writeFile(tmp, content, 'utf8')
+    await rename(tmp, target)
+  } finally {
+    // rename 成功后 tmp 已不存在（ENOENT），失败时把它清掉不留垃圾。
+    await unlink(tmp).catch(() => {})
+  }
+}
+
 /** 防路径穿越：只取 basename，且必须在 memory 目录内（.md，排除索引）。 */
 function safeName(raw) {
   const name = basename(String(raw || ''))
@@ -165,6 +241,8 @@ export class MemoryGateway extends TypertRemoteService {
     // 文件，读全文作为动态 context 段注入——让 agent 第一轮就「想起」。
     ctx.on('system-prompt/assemble', async (assembly, context, next) => {
       const assembled = await next()
+      // session id 在 try 外先取好：catch 里也要能带上它（拿到什么带什么）。
+      const sessionId = context?.agent?.session?.id ?? ''
       try {
         const agent = context?.agent
         const session = agent?.session
@@ -178,7 +256,7 @@ export class MemoryGateway extends TypertRemoteService {
         const userMessages = messages.filter(m => m?.role === 'user' && m?.source?.kind === 'user')
         const text = extractText(userMessages[userMessages.length - 1]?.content)
 
-        const files = await scanMemoryFiles()
+        const files = await scanMemoryFiles(ctx, sessionId)
         const picked = []
         const seen = new Set()
         const take = (f) => {
@@ -222,7 +300,11 @@ export class MemoryGateway extends TypertRemoteService {
             text: `以下是与你当前问题相关的历史记忆（文件式，来自 ${MEMORY_DIR}）：\n\n${parts.join('\n\n')}`,
           }],
         }
-      } catch {
+      } catch (err) {
+        // 这是整条注入链的外壳。裸吞的代价就是 :174-193 记的那个坑：权限错、编码坏、
+        // frontmatter 正则哪天不匹配，表现都是「插件在、但记忆不再注入」，日志一字没有。
+        // 现在只降级（返回未注入的 assembly），但一定留痕。
+        warnLog(ctx, `recall injection failed: ${err?.message ?? err}`, sessionId)
         return assembled
       }
     })
@@ -230,7 +312,7 @@ export class MemoryGateway extends TypertRemoteService {
 
   /** 列出 memory 目录全部记忆文件（文件名 + 类型 + 描述 + 大小）。 */
   async listFiles() {
-    const files = await scanMemoryFiles()
+    const files = await scanMemoryFiles(this.ctx, '')
     return files.map(f => {
       const meta = parseFrontmatter(f.content)
       return {
@@ -250,18 +332,38 @@ export class MemoryGateway extends TypertRemoteService {
     return { name: safe, content }
   }
 
-  /** 写（新增或覆盖）单个记忆文件。 */
+  /**
+   * 写（新增或覆盖）单个记忆文件。
+   *
+   * 三道闸：保留名不可写、内容必须是字符串、体积有上限；落盘走原子写。
+   * 拒绝一律返回 { ok: false, error }（不是抛异常）——设置页的调用方按 ok 判定。
+   */
   async writeFile(name, content) {
     const safe = safeName(name)
     if (!safe) throw new Error('sage-mem: invalid file name')
-    await writeFile(join(MEMORY_DIR, safe), String(content ?? ''), 'utf8')
+    if (RESERVED_FILES.has(safe)) {
+      return { ok: false, file: safe, error: `sage-mem: reserved file, edit it with the file tools: ${safe}` }
+    }
+    // 不加这一层，传个对象进来会被 String() 写成 "[object Object]" 还回 { ok: true }，
+    // 原文件就此被一行垃圾顶掉，且没有任何错误信号。
+    if (typeof content !== 'string') {
+      return { ok: false, file: safe, error: `sage-mem: content must be a string, got ${typeof content}` }
+    }
+    const bytes = Buffer.byteLength(content, 'utf8')
+    if (bytes > MAX_FILE_BYTES) {
+      return { ok: false, file: safe, error: `sage-mem: content too large (${bytes} bytes > ${MAX_FILE_BYTES})` }
+    }
+    await writeFileAtomic(join(MEMORY_DIR, safe), content)
     return { ok: true, file: safe }
   }
 
-  /** 删除单个记忆文件。 */
+  /** 删除单个记忆文件：保留名一律拒绝（unlink 不可逆）。 */
   async deleteFile(name) {
     const safe = safeName(name)
     if (!safe) throw new Error('sage-mem: invalid file name')
+    if (RESERVED_FILES.has(safe)) {
+      return { ok: false, error: `sage-mem: reserved file, refusing to delete: ${safe}` }
+    }
     await unlink(join(MEMORY_DIR, safe))
     return { ok: true }
   }
@@ -281,9 +383,14 @@ function extractTitle(content) {
 }
 
 /** 扫记忆目录，读全部 .md（跳过索引与 session-log），带体积与修改时间。 */
-async function scanStars() {
+async function scanStars(ctx) {
   let entries
-  try { entries = await readdir(MEMORY_DIR, { withFileTypes: true }) } catch { return [] }
+  try {
+    entries = await readdir(MEMORY_DIR, { withFileTypes: true })
+  } catch (err) {
+    if (err?.code !== 'ENOENT') warnLog(ctx, `cannot scan ${MEMORY_DIR}: ${err?.message ?? err}`)
+    return []
+  }
   const names = entries
     .filter(e => e.isFile() && e.name.endsWith('.md') && e.name !== 'MEMORY.md' && e.name !== 'session-log.md')
     .map(e => e.name)
@@ -292,7 +399,10 @@ async function scanStars() {
       const full = join(MEMORY_DIR, name)
       const [content, info] = await Promise.all([readFile(full, 'utf8'), stat(full)])
       return { name, content, bytes: info.size, mtimeMs: info.mtimeMs }
-    } catch { return null }
+    } catch (err) {
+      if (err?.code !== 'ENOENT') warnLog(ctx, `cannot read ${name}: ${err?.message ?? err}`)
+      return null
+    }
   }))
   return loaded.filter(Boolean)
 }
@@ -307,7 +417,7 @@ export class StarmapGateway extends TypertRemoteService {
   constructor(ctx) { super(ctx, 'starmap') }
 
   async listStars() {
-    const files = await scanStars()
+    const files = await scanStars(this.ctx)
     const stars = files.map(f => {
       const meta = parseFrontmatter(f.content)
       const title = extractTitle(f.content)

package/lib/typert.host.js

@@ -6,8 +6,12 @@
  */
 import { z } from 'zod'
 
-const fileNameSchema = z.string()
-const fileContentSchema = z.string()
+// 文件名：与 host 侧 safeName 同一套底线 —— 非空、无路径分隔符与 Windows 非法字符、
+// 以 .md 结尾、长度有界。（真正的目录逃逸防护仍在 host 侧 safeName。）
+const fileNameSchema = z.string().min(1).max(255).regex(/^[^\\/:*?"<>|\u0000-\u001f]+\.md$/)
+// 正文：512 KB 上限。理由是「记忆要塞进 system prompt」——现行 memory 目录最大一条 19 KB，
+// 到半兆量级基本是写错了目标（贴了日志/代码进来）。与 lib/index.js 的 MAX_FILE_BYTES 一致。
+const fileContentSchema = z.string().max(512 * 1024)
 
 const starmapStarSchema = z.object({
 	'file': z.string().readonly(),
@@ -38,12 +42,16 @@ const readResultSchema = z.object({
 	'name': z.string().readonly(),
 	'content': z.string().readonly(),
 }).readonly()
+// 写/删失败不再抛异常，走 { ok: false, error } 分支：error 必须声明，否则 strict
+// 校验会把它当未知字段剥掉，设置页只能看到一个没有原因的 ok:false。
 const writeResultSchema = z.object({
 	'ok': z.boolean().readonly(),
 	'file': z.string().readonly(),
+	'error': z.string().readonly().optional(),
 }).readonly()
 const deleteResultSchema = z.object({
 	'ok': z.boolean().readonly(),
+	'error': z.string().readonly().optional(),
 }).readonly()
 
 export const TYPERT = {
@@ -58,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 },
 		},
 		{
@@ -68,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 },
 		},
 		{
@@ -80,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 },
 		},
 		{
@@ -93,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 },
 		},
 		{
@@ -105,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 },
 		},
 		{
@@ -115,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.0",
-  "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.2",
+  "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"
+  ]
+}