sage-mem 0.4.2 → 0.4.3

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 } from 'node:fs/promises'
+import { readFile, readdir, writeFile, 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')
@@ -125,6 +125,8 @@ function markRemote(cls, method, exportName) {
 export class MemoryGateway extends TypertRemoteService {
   constructor(ctx) {
     super(ctx, 'memory')
+    // 一并挂载星图 remote（同一记忆目录，纯只读）—— starmap.* 服务
+    new StarmapGateway(ctx)
 
     // 按问题检索注入：system-prompt/assemble 是异步 waterfall，监听器可 await。
     // 从 agent.session 拿当前 user message，扫 memory 目录按双字匹配选相关
@@ -209,4 +211,69 @@ markRemote(MemoryGateway, 'readFile', 'readFile')
 markRemote(MemoryGateway, 'writeFile', 'writeFile')
 markRemote(MemoryGateway, 'deleteFile', 'deleteFile')
 
+/** 提取正文第一个 `# ` 标题作为展示标题。 */
+function extractTitle(content) {
+  const m = content.match(/^---\r?\n[\s\S]*?\r?\n---/)
+  const body = m ? content.slice(m[0].length) : content
+  const h1 = body.match(/^#\s+(.+)$/m)
+  return h1 ? h1[1].trim() : ''
+}
+
+/** 扫记忆目录，读全部 .md（跳过索引与 session-log），带体积与修改时间。 */
+async function scanStars() {
+  let entries
+  try { entries = await readdir(MEMORY_DIR, { withFileTypes: true }) } catch { 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)
+  const loaded = await Promise.all(names.map(async (name) => {
+    try {
+      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 }
+  }))
+  return loaded.filter(Boolean)
+}
+
+/**
+ * 记忆星图（host 半）—— 只读扫描记忆目录，把每条记忆解析成一颗「星」。
+ * 通过 TypertRemoteService 暴露两个 remote 方法给浏览器半：
+ *   - starmap.listStars()  全部星（元数据，不含正文）
+ *   - starmap.readFile(n)  单条记忆全文（文件名白名单校验）
+ */
+export class StarmapGateway extends TypertRemoteService {
+  constructor(ctx) { super(ctx, 'starmap') }
+
+  async listStars() {
+    const files = await scanStars()
+    const stars = files.map(f => {
+      const meta = parseFrontmatter(f.content)
+      const title = extractTitle(f.content)
+      return {
+        file: f.name,
+        kind: meta.type || 'special',
+        title: title || meta.name || (meta.description ? meta.description.slice(0, 24) : f.name.replace(/\.md$/, '')),
+        desc: meta.description || '',
+        bytes: f.bytes,
+        mtimeMs: f.mtimeMs,
+      }
+    })
+    return { count: stars.length, stars }
+  }
+
+  async readFile(name) {
+    const raw = String(name || '')
+    const safe = basename(raw)
+    if (!safe || safe !== raw || !safe.endsWith('.md') || safe === 'MEMORY.md') {
+      throw new Error('sage-starmap: invalid file name')
+    }
+    const content = await readFile(join(MEMORY_DIR, safe), 'utf8')
+    return { name: safe, content }
+  }
+}
+
+markRemote(StarmapGateway, 'listStars', 'listStars')
+markRemote(StarmapGateway, 'readFile', 'readFile')
+
 export default MemoryGateway

package/lib/typert.host.js

@@ -9,6 +9,23 @@ import { z } from 'zod'
 const fileNameSchema = z.string()
 const fileContentSchema = z.string()
 
+const starmapStarSchema = z.object({
+	'file': z.string().readonly(),
+	'kind': z.string().readonly(),
+	'title': z.string().readonly(),
+	'desc': z.string().readonly(),
+	'bytes': z.number().readonly(),
+	'mtimeMs': z.number().readonly(),
+}).readonly()
+const starmapListSchema = z.object({
+	'count': z.number().readonly(),
+	'stars': z.array(starmapStarSchema).readonly(),
+}).readonly()
+const starmapReadSchema = z.object({
+	'name': z.string().readonly(),
+	'content': z.string().readonly(),
+}).readonly()
+
 const fileSchema = z.object({
 	'file': z.string().readonly(),
 	'type': z.string().readonly(),
@@ -81,6 +98,28 @@ export const TYPERT = {
 			result: { mode: 'strict', typeSymbol: 'sage-mem/types#DeleteResult', schema: deleteResultSchema },
 			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 		},
+		{
+			id: 'sage-mem#starmap/listStars',
+			service: 'starmap',
+			namespace: 'starmap',
+			method: 'listStars',
+			invocation: { kind: 'direct' },
+			parameters: [],
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapList', schema: starmapListSchema },
+			sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: 'sage-mem#starmap/readFile',
+			service: 'starmap',
+			namespace: 'starmap',
+			method: 'readFile',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: 'sage-mem/types#FileName', schema: fileNameSchema } },
+			],
+			result: { mode: 'strict', typeSymbol: 'sage-mem/types#StarmapRead', schema: starmapReadSchema },
+			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",
-  "version": "0.4.2",
+  "description": "File-based memory plugin for DeepSeek Harness (DSH) — cross-session memory in transparent markdown files, with a memory star-map view",
+  "version": "0.4.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {