sage-mem 0.5.4 → 0.6.0

package/lib/index.js

@@ -17,8 +17,15 @@ import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol'
 import { homedir } from 'node:os'
 import { readFile, readdir, writeFile, rename, unlink, stat } from 'node:fs/promises'
 import { join, basename } from 'node:path'
+import { DreamEngine } from './dream.js'
 
 const MEMORY_DIR = process.env.SAGE_MEM_DIR || join(homedir(), '.sage-mem', 'memory')
+/**
+ * DSH 会话记录根目录。dream 的门控靠它数「上次整理之后有几个会话更新」，
+ * `memory+sessions` 输入源下也会在里面做定向搜索。取不到就是空串，
+ * 门控会退化成「会话数 0 → 不触发」，而不是报错。
+ */
+const SESSIONS_ROOT = process.env.DSH_HOME ? join(process.env.DSH_HOME, 'sessions') : ''
 const MAX_RESULTS = 5
 const MAX_CHARS_PER_FILE = 1500
 const MAX_BASELINE = 5
@@ -168,6 +175,33 @@ function selectRelevant(query, files) {
     .slice(0, MAX_RESULTS)
 }
 
+/**
+ * 解析 frontmatter 的 `tags`（自定义标签，用于列表页筛选）。
+ *
+ * 三种写法都收 —— 手写记忆时这三种都会自然出现，只认一种就等于「标签时灵时不灵」：
+ *   tags: [a, b]           （YAML flow）
+ *   tags:\n  - a\n  - b    （YAML block）
+ *   tags: a, b             （松散的逗号串）
+ *
+ * 上限 20 个、每个 40 字符：标签是给人点着筛的，超过这个量级已经不是标签，
+ * 而是一句话被塞进了 tags 字段。
+ */
+function parseTags(body) {
+  const clean = (arr) =>
+    arr
+      .map((s) => String(s).trim().replace(/^["']|["']$/g, '').trim())
+      .filter(Boolean)
+      .slice(0, 20)
+      .map((s) => s.slice(0, 40))
+  const flow = body.match(/^tags:[ \t]*\[([^\]]*)\]/m)
+  if (flow) return clean(flow[1].split(','))
+  const block = body.match(/^tags:[ \t]*\r?\n((?:[ \t]+-[^\r\n]*\r?\n?)+)/m)
+  if (block) return clean(block[1].split(/\r?\n/).map((l) => l.replace(/^[ \t]*-[ \t]*/, '')))
+  const inline = body.match(/^tags:[ \t]*(.+?)[ \t\r]*$/m)
+  if (inline && inline[1].trim()) return clean(inline[1].split(','))
+  return []
+}
+
 /** 解析 frontmatter 的 name/description/type（兼容顶层与 metadata 嵌套两种 type）。 */
 function parseFrontmatter(content) {
   // 换行必须容忍 CRLF：任何用 Windows 编辑器碰过一次的文件都会被换成 \r\n，
@@ -175,7 +209,7 @@ function parseFrontmatter(content) {
   // 「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: '' }
+  if (!m) return { name: '', description: '', type: '', tags: [] }
   const body = m[1]
   const grab = (key) => {
     // [ \t] / [ \t\r] 而不是 \s：\s 会连 CRLF 的 \r 一起吃进捕获组，值尾留一个 \r
@@ -189,7 +223,7 @@ function parseFrontmatter(content) {
     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 }
+  return { name: grab('name'), description: grab('description'), type, tags: parseTags(body) }
 }
 
 /** 解析 frontmatter 的 `baseline` 标记：会话第一回合无条件注入。 */
@@ -290,6 +324,24 @@ export class MemoryGateway extends TypertRemoteService {
     // 一并挂载星图 remote（同一记忆目录，纯只读）—— starmap.* 服务
     new StarmapGateway(ctx)
 
+    // dream（夜间记忆整理）：引擎 + remote 面 + 自动触发的定时器。
+    //
+    // 整个包在 try 里：dream 起不来（比如 timer 服务缺失、状态目录没权限）
+    // 不该把 sage-mem 最核心的那件事——「记忆按问题注入」——一起拖死。
+    // 这是本插件唯一一处「降级而不是失败」的设计，理由就在这里。
+    try {
+      const engine = new DreamEngine(ctx, { memoryDir: MEMORY_DIR, sessionsRoot: SESSIONS_ROOT })
+      new DreamGateway(ctx, engine)
+      engine.start()
+      // 卸载时把定时器与锁收干净。effect 拿不到就交给 unref 兜底（不阻止进程退出）。
+      if (typeof ctx.effect === 'function') ctx.effect(() => () => engine.dispose())
+    } catch (err) {
+      warnLog(ctx, `dream 初始化失败（记忆本体不受影响）：${err?.message ?? err}`)
+      // 异常路径额外打一行到 stderr：warnLog 走 ctx.logger，某些启动阶段它还没接上，
+      // 而「dream 静默不工作」正是最难查的那种故障（2026-09-27 为此绕了一大圈）。
+      console.error('[sage-mem] dream init failed:', err && err.stack ? err.stack : err)
+    }
+
     // 同一轮对话里问题不变、注入内容也不变，但 DSH 每一步都会往 session 追加
     // 一条 context 消息——不去重的话同一份记忆会被反复追加，撑爆上下文。
     const recallCache = new Map()
@@ -416,7 +468,7 @@ export class MemoryGateway extends TypertRemoteService {
     })
   }
 
-  /** 列出 memory 目录全部记忆文件（文件名 + 类型 + 描述 + 大小）。 */
+  /** 列出 memory 目录全部记忆文件（文件名 + 类型 + 描述 + 大小 + 自定义标签）。 */
   async listFiles() {
     const files = await scanMemoryFiles(this.ctx, '')
     return files.map(f => {
@@ -426,6 +478,7 @@ export class MemoryGateway extends TypertRemoteService {
         type: meta.type || 'reference',
         description: meta.description || '',
         size: f.content.length,
+        tags: meta.tags,
       }
     })
   }
@@ -555,4 +608,71 @@ export class StarmapGateway extends TypertRemoteService {
 markRemote(StarmapGateway, 'listStars', 'listStars')
 markRemote(StarmapGateway, 'readFile', 'readFile')
 
+/**
+ * dream 的 remote 面：设置页「梦境」标签页唯一的数据通道。
+ *
+ * 这一层刻意很薄——全部判断（门控、模式、白名单）都在 DreamEngine 里，
+ * 这里只负责把 ctx 里的引擎接到 typert 的调用表上。想看行为就读 dream.js。
+ */
+export class DreamGateway extends TypertRemoteService {
+  constructor(ctx, engine) {
+    super(ctx, 'dream')
+    this.engine = engine
+  }
+
+  /** 配置 + 状态 + 路径 + 默认值（设置面板一次拿全）。 */
+  async getConfig() {
+    return this.engine.getConfig()
+  }
+
+  /** 改配置（补丁式）。 */
+  async setConfig(patch) {
+    return this.engine.setConfig(patch)
+  }
+
+  /** 轮询用：是否在跑、跑到哪一步、上次结果。 */
+  async status() {
+    return this.engine.status()
+  }
+
+  /**
+   * 手动跑一趟。设置页的「立即整理」走这里。
+   *
+   * force 默认为 true —— 人点了按钮，就不该再被「还没到 24 小时」挡回来。
+   *
+   * **故意不 await**：一趟 dream 可能跑几分钟（多轮模型调用 + 工具），
+   * remote 调用挂在那儿等会直接撞上前端超时，界面上表现为「点了没反应」。
+   * 所以这里只负责点火，进度与结果都从 status() 轮询 —— run() 自己会把
+   * lastResult 落盘，界面刷新几次就能看到。
+   */
+  async runNow(force) {
+    if (this.engine.running) return { ok: false, error: '已有一趟 dream 在跑' }
+    this.engine.run({ reason: '设置页手动触发', force: force !== false }).catch(() => {})
+    return { ok: true }
+  }
+
+  /** 历史报告列表。 */
+  async listReports() {
+    return this.engine.listReports()
+  }
+
+  /** 读一份报告全文。 */
+  async readReport(name) {
+    return this.engine.readReport(name)
+  }
+
+  /** 已有快照（面板显示「可回退到哪一份」）。 */
+  async listSnapshots() {
+    return this.engine.listSnapshots()
+  }
+}
+
+markRemote(DreamGateway, 'getConfig', 'getConfig')
+markRemote(DreamGateway, 'setConfig', 'setConfig')
+markRemote(DreamGateway, 'status', 'status')
+markRemote(DreamGateway, 'runNow', 'runNow')
+markRemote(DreamGateway, 'listReports', 'listReports')
+markRemote(DreamGateway, 'readReport', 'readReport')
+markRemote(DreamGateway, 'listSnapshots', 'listSnapshots')
+
 export default MemoryGateway

package/lib/typert.host.js

@@ -35,6 +35,10 @@ const fileSchema = z.object({
 	'type': z.string().readonly(),
 	'description': z.string().readonly(),
 	'size': z.number().readonly(),
+	// 自定义标签：来自 frontmatter 的 tags（flow / block / 逗号三种写法都收）。
+	// strict 模式下 host 多返回的字段会被剥掉，所以「列表页要能按标签筛」这件事
+	// 必须在这里显式声明，否则前端永远拿到 undefined。
+	'tags': z.array(z.string()).readonly(),
 }).readonly()
 
 const listResultSchema = z.array(fileSchema)
@@ -54,6 +58,117 @@ const deleteResultSchema = z.object({
 	'error': z.string().readonly().optional(),
 }).readonly()
 
+// ── dream（夜间记忆整理）───────────────────────────────────────────────
+// 配置的每一项都可写；lastResult 是一个「成功/失败两条分支共用」的结构，
+// 所以除了三个必有字段外全是 optional —— 用 strict 校验两种形态的并集，
+// 比给成功与失败各来一套 schema 少一半维护面。
+const dreamConfigSchema = z.object({
+	'enabled': z.boolean().readonly(),
+	'trigger': z.string().readonly(),
+	'apply': z.boolean().readonly(),
+	'source': z.string().readonly(),
+	'minHours': z.number().readonly(),
+	'minSessions': z.number().readonly(),
+	'provider': z.string().readonly(),
+	'model': z.string().readonly(),
+	'maxSteps': z.number().readonly(),
+	'maxSnapshotKeep': z.number().readonly(),
+}).readonly()
+
+const dreamPathsSchema = z.object({
+	'memoryDir': z.string().readonly(),
+	'configPath': z.string().readonly(),
+	'stateRoot': z.string().readonly(),
+}).readonly()
+
+const dreamRouteSchema = z.object({
+	'provider': z.string().readonly(),
+	'model': z.string().readonly(),
+	'fromDefault': z.boolean().readonly(),
+}).readonly()
+
+const dreamLastResultSchema = z.object({
+	'at': z.number().readonly(),
+	'atHuman': z.string().readonly(),
+	'ok': z.boolean().readonly(),
+	'apply': z.boolean().readonly().optional(),
+	'error': z.string().readonly().optional(),
+	'touched': z.array(z.string()).readonly().optional(),
+	'problemsBefore': z.number().readonly().optional(),
+	'problemsAfter': z.number().readonly().optional(),
+	'tokensIn': z.number().readonly().optional(),
+	'tokensOut': z.number().readonly().optional(),
+	'report': z.string().readonly().optional(),
+}).readonly()
+
+const dreamConfigResultSchema = z.object({
+	'config': dreamConfigSchema,
+	'route': dreamRouteSchema.nullable(),
+	'lastRunAt': z.number().readonly(),
+	'lastResult': dreamLastResultSchema.nullable(),
+	'paths': dreamPathsSchema,
+	'defaults': dreamConfigSchema,
+}).readonly()
+
+const dreamStepSchema = z.object({
+	'step': z.number().readonly(),
+	'tools': z.array(z.string()).readonly(),
+	'chars': z.number().readonly(),
+	'at': z.number().readonly(),
+}).readonly()
+
+const dreamStatusSchema = z.object({
+	'running': z.boolean().readonly(),
+	'phase': z.string().readonly(),
+	'startedAt': z.number().readonly(),
+	'steps': z.array(dreamStepSchema).readonly(),
+	'config': dreamConfigSchema,
+	'route': dreamRouteSchema.nullable(),
+	'lastRunAt': z.number().readonly(),
+	'hoursSince': z.number().readonly().nullable(),
+	'lastResult': dreamLastResultSchema.nullable(),
+	'retryAfter': z.number().readonly(),
+	'gate': z.object({ 'minHours': z.number().readonly(), 'minSessions': z.number().readonly() }).readonly().nullable(),
+	'paths': dreamPathsSchema,
+}).readonly()
+
+const dreamRunResultSchema = z.object({
+	'ok': z.boolean().readonly(),
+	'error': z.string().readonly().optional(),
+	'report': z.string().readonly().optional(),
+	'touched': z.array(z.string()).readonly().optional(),
+}).readonly()
+
+// setConfig 的补丁：全部 optional —— 设置面板每次只改动一项，传整个对象反而
+// 容易把没碰过的字段用旧值覆盖回去。
+const dreamPatchSchema = z.object({
+	'enabled': z.boolean().optional(),
+	'trigger': z.string().optional(),
+	'apply': z.boolean().optional(),
+	'source': z.string().optional(),
+	'minHours': z.number().optional(),
+	'minSessions': z.number().optional(),
+	'provider': z.string().optional(),
+	'model': z.string().optional(),
+	'maxSteps': z.number().optional(),
+	'maxSnapshotKeep': z.number().optional(),
+}).readonly()
+
+const reportListSchema = z.array(z.object({
+	'name': z.string().readonly(),
+	'bytes': z.number().readonly(),
+	'at': z.number().readonly(),
+	'atHuman': z.string().readonly(),
+}).readonly()).readonly()
+
+const snapshotListSchema = z.array(z.object({
+	'name': z.string().readonly(),
+	'at': z.number().readonly(),
+	'atHuman': z.string().readonly(),
+	'files': z.number().readonly(),
+	'path': z.string().readonly(),
+}).readonly()).readonly()
+
 export const TYPERT = {
 	package: 'sage-mem',
 	face: 'host',
@@ -128,6 +243,87 @@ export const TYPERT = {
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapRead', schema: starmapReadSchema, create: () => starmapReadSchema },
 			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 		},
+		// ── dream 的七个方法 ──
+		// 全部挂在 package `sage-mem` 下（和 memory 同一份 manifest），
+		// 所以前端直接 ctx.get('remote.dream') 就能用，不需要像 starmap 那样
+		// 在 client 侧再 $mount 一次 —— 那个 mount 是因为 starmap 当年是独立包
+		// （package: 'sage-starmap'），合并进 sage-mem 后一直没改回来。
+		{
+			id: 'sage-mem#dream/getConfig',
+			service: 'dream',
+			namespace: 'dream',
+			method: 'getConfig',
+			invocation: { kind: 'direct' },
+			parameters: [],
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DreamConfigResult', schema: dreamConfigResultSchema, create: () => dreamConfigResultSchema },
+			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: 'sage-mem#dream/setConfig',
+			service: 'dream',
+			namespace: 'dream',
+			method: 'setConfig',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ name: 'patch', wire: 'patch', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#DreamPatch', schema: dreamPatchSchema, create: () => dreamPatchSchema } },
+			],
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DreamConfigResult', schema: dreamConfigResultSchema, create: () => dreamConfigResultSchema },
+			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: 'sage-mem#dream/status',
+			service: 'dream',
+			namespace: 'dream',
+			method: 'status',
+			invocation: { kind: 'direct' },
+			parameters: [],
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DreamStatus', schema: dreamStatusSchema, create: () => dreamStatusSchema },
+			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: 'sage-mem#dream/runNow',
+			service: 'dream',
+			namespace: 'dream',
+			method: 'runNow',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ name: 'force', wire: 'force', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#Boolean', schema: z.boolean(), create: () => z.boolean() } },
+			],
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DreamRunResult', schema: dreamRunResultSchema, create: () => dreamRunResultSchema },
+			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: 'sage-mem#dream/listReports',
+			service: 'dream',
+			namespace: 'dream',
+			method: 'listReports',
+			invocation: { kind: 'direct' },
+			parameters: [],
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DreamReportList', schema: reportListSchema, create: () => reportListSchema },
+			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: 'sage-mem#dream/readReport',
+			service: 'dream',
+			namespace: 'dream',
+			method: 'readReport',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ 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, create: () => readResultSchema },
+			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: 'sage-mem#dream/listSnapshots',
+			service: 'dream',
+			namespace: 'dream',
+			method: 'listSnapshots',
+			invocation: { kind: 'direct' },
+			parameters: [],
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DreamSnapshotList', schema: snapshotListSchema, create: () => snapshotListSchema },
+			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+		},
 	],
 	model: {
 		"services": [],

package/package.json

@@ -1,7 +1,7 @@
 {
   "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.4",
+  "description": "File-based memory plugin for DeepSeek Harness (DSH) — cross-session memory in transparent markdown files, with a memory star-map view, type/tag filtering, and an optional nightly dream pass that consolidates memories",
+  "version": "0.6.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -11,9 +11,7 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "lib/index.js",
-    "lib/client.js",
-    "lib/typert.host.js",
+    "lib/",
     "cordis.patch.yml",
     "NOTICE"
   ],
@@ -48,6 +46,9 @@
   "dependencies": {
     "zod": "^4.4.3"
   },
+  "devDependencies": {
+    "react": "^18.0.0"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
     "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
@@ -58,13 +59,25 @@
     "type": "git",
     "url": "git+https://github.com/gezi-wen/sage-mem.git"
   },
+  "homepage": "https://github.com/gezi-wen/sage-mem#readme",
+  "bugs": {
+    "url": "https://github.com/gezi-wen/sage-mem/issues"
+  },
   "keywords": [
     "memory",
     "ai-memory",
+    "agent-memory",
     "long-term-memory",
+    "cross-session-memory",
+    "context-management",
+    "knowledge-management",
     "markdown",
     "dsh",
+    "dsh-plugin",
+    "deepseek",
     "deepseek-harness",
+    "cordis",
+    "typert",
     "plugin",
     "ai-agent",
     "agent",