@gezi-wen/dsh-mem 0.5.5

package/lib/typert.host.js

@@ -0,0 +1,137 @@
+/**
+ * dsh-mem — 手写 strict typert host manifest（对齐官方生成文件格式）。
+ * typert-loader 在插件挂载时读 package.json 的 exports["./typert"]，
+ * import 本文件并把 TYPERT 注册进 ctx.typert.local（strict 定义）。
+ * schema 必须是 zod v4 实例（typert-loader 校验 "_zod" in schema）。
+ */
+import { z } from 'zod'
+
+// 文件名：与 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(),
+	'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(),
+	'description': z.string().readonly(),
+	'size': z.number().readonly(),
+}).readonly()
+
+const listResultSchema = z.array(fileSchema)
+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 = {
+	package: '@gezi-wen/dsh-mem',
+	face: 'host',
+	schemas: [],
+	invocations: [
+		{
+			id: '@gezi-wen/dsh-mem#memory/listFiles',
+			service: 'memory',
+			namespace: 'memory',
+			method: 'listFiles',
+			invocation: { kind: 'direct' },
+			parameters: [],
+			result: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#FileList', schema: listResultSchema, create: () => listResultSchema },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: '@gezi-wen/dsh-mem#memory/readFile',
+			service: 'memory',
+			namespace: 'memory',
+			method: 'readFile',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
+			],
+			result: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#FileContent', schema: readResultSchema, create: () => readResultSchema },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: '@gezi-wen/dsh-mem#memory/writeFile',
+			service: 'memory',
+			namespace: 'memory',
+			method: 'writeFile',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
+				{ name: 'content', wire: 'content', source: 'json', codec: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#FileContent', schema: fileContentSchema, create: () => fileContentSchema } },
+			],
+			result: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#WriteResult', schema: writeResultSchema, create: () => writeResultSchema },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: '@gezi-wen/dsh-mem#memory/deleteFile',
+			service: 'memory',
+			namespace: 'memory',
+			method: 'deleteFile',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
+			],
+			result: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#DeleteResult', schema: deleteResultSchema, create: () => deleteResultSchema },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: '@gezi-wen/dsh-mem#starmap/listStars',
+			service: 'starmap',
+			namespace: 'starmap',
+			method: 'listStars',
+			invocation: { kind: 'direct' },
+			parameters: [],
+			result: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#StarmapList', schema: starmapListSchema, create: () => starmapListSchema },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
+		},
+		{
+			id: '@gezi-wen/dsh-mem#starmap/readFile',
+			service: 'starmap',
+			namespace: 'starmap',
+			method: 'readFile',
+			invocation: { kind: 'direct' },
+			parameters: [
+				{ name: 'name', wire: 'name', source: 'json', codec: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#FileName', schema: fileNameSchema, create: () => fileNameSchema } },
+			],
+			result: { mode: 'strict', typeSymbol: '@gezi-wen/dsh-mem/types#StarmapRead', schema: starmapReadSchema, create: () => starmapReadSchema },
+			sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
+		},
+	],
+	model: {
+		"services": [],
+		"events": [],
+		"objects": [],
+	},
+}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@gezi-wen/dsh-mem",
+  "description": "Cross-session memory plugin for DeepSeek Harness (dsh) — transparent markdown memory files with question-based recall and a memory star-map view in the web UI",
+  "version": "0.5.5",
+  "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",
+        "0.1.7-rc.1": "compatible",
+        "0.1.7-rc.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/dsh-mem.git"
+  },
+  "homepage": "https://github.com/gezi-wen/dsh-mem#readme",
+  "bugs": {
+    "url": "https://github.com/gezi-wen/dsh-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",
+    "claude-code"
+  ]
+}