@modusensus/dsh-mneme 0.8.2 → 0.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +718 -633
  3. package/bin/cli.mjs +0 -0
  4. package/bin/dsh-mneme-mcp.mjs +502 -0
  5. package/cordis.patch.yml +21 -21
  6. package/lib/api-standalone.js +495 -316
  7. package/lib/api.js +1382 -1316
  8. package/lib/bootstrap.js +211 -0
  9. package/lib/client.js +4475 -4362
  10. package/lib/commands.js +95 -95
  11. package/lib/config.js +533 -500
  12. package/lib/dream/clustering.js +118 -118
  13. package/lib/dream/decisions.js +658 -658
  14. package/lib/dream/narratives.js +44 -0
  15. package/lib/dream/sleep.js +700 -700
  16. package/lib/dream.js +1319 -1216
  17. package/lib/embedding.js +177 -177
  18. package/lib/entities/extractor.js +249 -249
  19. package/lib/heat.js +142 -136
  20. package/lib/hot-memory.js +46 -46
  21. package/lib/index.js +515 -513
  22. package/lib/inject.js +299 -253
  23. package/lib/lang.js +202 -179
  24. package/lib/local-embedder.js +320 -308
  25. package/lib/mirror.js +198 -198
  26. package/lib/quality-filter.js +126 -126
  27. package/lib/recall-stats.js +103 -0
  28. package/lib/reranker.js +269 -260
  29. package/lib/runtime/adopt.js +176 -176
  30. package/lib/runtime/closure.js +172 -172
  31. package/lib/runtime/download.js +247 -247
  32. package/lib/runtime/layout.js +235 -235
  33. package/lib/runtime/loader.js +249 -249
  34. package/lib/runtime/model-fetch.js +361 -0
  35. package/lib/runtime/provision.js +237 -237
  36. package/lib/runtime/tarball.js +130 -130
  37. package/lib/runtime/verify.js +191 -191
  38. package/lib/scope.js +118 -118
  39. package/lib/search/adaptive.js +22 -22
  40. package/lib/search/bm25.js +96 -96
  41. package/lib/service.js +2171 -2071
  42. package/lib/settings.js +430 -419
  43. package/lib/store.js +2448 -2367
  44. package/lib/summarize.js +575 -449
  45. package/lib/tools.js +574 -574
  46. package/lib/vector-index.js +110 -110
  47. package/lib/version-check.js +122 -122
  48. package/package.json +109 -108
  49. package/runtime-manifest.json +596 -596
  50. package/scripts/benchmark-embed.js +201 -201
  51. package/scripts/benchmark-recall.js +199 -199
  52. package/scripts/benchmark-rerank.js +166 -166
  53. package/scripts/build-runtime-manifest.mjs +217 -217
  54. package/scripts/check-sync.js +42 -42
  55. package/scripts/e2e-dsh.js +220 -220
  56. package/scripts/mneme-runtime.mjs +277 -277
  57. package/scripts/stress-dsh.js +255 -255
  58. package/scripts/sync-lib.js +47 -47
  59. package/scripts/sync-test-badge.mjs +61 -61
  60. package/src/api-standalone.js +495 -316
  61. package/src/api.js +1382 -1316
  62. package/src/bootstrap.js +211 -0
  63. package/src/commands.js +95 -95
  64. package/src/config.js +533 -500
  65. package/src/dream/clustering.js +118 -118
  66. package/src/dream/decisions.js +658 -658
  67. package/src/dream/narratives.js +44 -0
  68. package/src/dream/sleep.js +700 -700
  69. package/src/dream.js +1319 -1216
  70. package/src/embedding.js +177 -177
  71. package/src/entities/extractor.js +249 -249
  72. package/src/heat.js +142 -136
  73. package/src/hot-memory.js +46 -46
  74. package/src/index.js +515 -513
  75. package/src/inject.js +299 -253
  76. package/src/lang.js +202 -179
  77. package/src/local-embedder.js +320 -308
  78. package/src/mirror.js +198 -198
  79. package/src/quality-filter.js +126 -126
  80. package/src/recall-stats.js +103 -0
  81. package/src/reranker.js +269 -260
  82. package/src/runtime/adopt.js +176 -176
  83. package/src/runtime/closure.js +172 -172
  84. package/src/runtime/download.js +247 -247
  85. package/src/runtime/layout.js +235 -235
  86. package/src/runtime/loader.js +249 -249
  87. package/src/runtime/model-fetch.js +361 -0
  88. package/src/runtime/provision.js +237 -237
  89. package/src/runtime/tarball.js +130 -130
  90. package/src/runtime/verify.js +191 -191
  91. package/src/scope.js +118 -118
  92. package/src/search/adaptive.js +22 -22
  93. package/src/search/bm25.js +96 -96
  94. package/src/service.js +2171 -2071
  95. package/src/settings.js +430 -419
  96. package/src/store.js +2448 -2367
  97. package/src/summarize.js +575 -449
  98. package/src/tools.js +574 -574
  99. package/src/vector-index.js +110 -110
  100. package/src/version-check.js +122 -122
  101. package/test/api-routes-gaps.test.js +218 -218
  102. package/test/api.test.js +1578 -1481
  103. package/test/audit.test.js +448 -448
  104. package/test/benchmark.test.js +94 -94
  105. package/test/bootstrap.test.js +220 -0
  106. package/test/client.test.js +799 -736
  107. package/test/clustering.test.js +100 -100
  108. package/test/commands.test.js +106 -106
  109. package/test/config.test.js +66 -66
  110. package/test/conflict-freeze.test.js +300 -300
  111. package/test/dream-archive-guardrail.test.js +116 -116
  112. package/test/dream-candidate-hybrid.test.js +281 -281
  113. package/test/dream-coverage-degrade.test.js +86 -86
  114. package/test/dream.test.js +1257 -1254
  115. package/test/embedding-ready.test.js +196 -196
  116. package/test/entities.test.js +547 -547
  117. package/test/entity-recall.test.js +179 -0
  118. package/test/epistemic.test.js +298 -298
  119. package/test/fnew-0112.test.js +311 -311
  120. package/test/fnew-03.test.js +422 -422
  121. package/test/graph-api.test.js +175 -175
  122. package/test/heat.test.js +175 -148
  123. package/test/helpers/dream-mock.js +82 -82
  124. package/test/helpers/peer-worker.mjs +25 -25
  125. package/test/helpers/runtime-source.js +60 -60
  126. package/test/helpers/tar-builder.js +80 -80
  127. package/test/hot-memory.test.js +145 -145
  128. package/test/inject-content-cap.test.js +89 -0
  129. package/test/inject-first-round-bm25.test.js +89 -89
  130. package/test/inject-heat.test.js +61 -0
  131. package/test/inject-rotation.test.js +161 -0
  132. package/test/inject.test.js +249 -249
  133. package/test/lang.test.js +87 -87
  134. package/test/lib-smoke.test.js +96 -96
  135. package/test/llm-audit.test.js +309 -309
  136. package/test/llm-message-source.test.js +177 -177
  137. package/test/local-embedder.test.js +249 -229
  138. package/test/mcp-stdio.test.js +385 -0
  139. package/test/mirror-dirty.test.js +424 -424
  140. package/test/mirror-edit-digest.test.js +187 -187
  141. package/test/mirror-generation.test.js +499 -499
  142. package/test/mirror.test.js +249 -249
  143. package/test/narrative-bars.test.js +162 -0
  144. package/test/peer-blockers.test.js +193 -193
  145. package/test/policy-epoch.test.js +259 -259
  146. package/test/quality-filter.test.js +186 -186
  147. package/test/reasoning-effort.test.js +746 -746
  148. package/test/recall-evals.test.js +235 -235
  149. package/test/recall-layer.test.js +326 -326
  150. package/test/recall-stats.test.js +117 -0
  151. package/test/receipt-chain.test.js +451 -451
  152. package/test/reflection.test.js +226 -226
  153. package/test/reindex-backfill.test.js +62 -62
  154. package/test/reranker-single-logit.test.js +73 -73
  155. package/test/reranker.test.js +197 -197
  156. package/test/resident-status.test.js +83 -0
  157. package/test/runtime-adopt.test.js +206 -206
  158. package/test/runtime-cli.test.js +89 -89
  159. package/test/runtime-closure.test.js +193 -193
  160. package/test/runtime-download.test.js +302 -302
  161. package/test/runtime-layout.test.js +163 -163
  162. package/test/runtime-loader.test.js +237 -237
  163. package/test/runtime-manifest.test.js +158 -158
  164. package/test/runtime-model-fetch.test.js +348 -0
  165. package/test/runtime-provision.test.js +101 -101
  166. package/test/runtime-tarball.test.js +81 -81
  167. package/test/runtime-verify.test.js +214 -214
  168. package/test/scope-candidates.test.js +239 -239
  169. package/test/scope-explicit.test.js +452 -452
  170. package/test/scope-retrieval.test.js +197 -197
  171. package/test/scope-storage.test.js +255 -255
  172. package/test/scope-strict.test.js +231 -231
  173. package/test/search-fusion.test.js +90 -90
  174. package/test/semantic.test.js +124 -124
  175. package/test/service-search.test.js +174 -174
  176. package/test/service.test.js +405 -405
  177. package/test/settings.test.js +261 -261
  178. package/test/skip-invalid-restore.test.js +262 -262
  179. package/test/sleep-action-set.test.js +422 -422
  180. package/test/sleep-heat.test.js +126 -125
  181. package/test/sleep-scheduler-rearm.test.js +89 -89
  182. package/test/sleep.test.js +373 -373
  183. package/test/standalone-api.test.js +544 -359
  184. package/test/store-vector-cache.test.js +98 -98
  185. package/test/store.test.js +383 -383
  186. package/test/stress.test.js +209 -209
  187. package/test/summarize.test.js +884 -575
  188. package/test/tools-memory-get-schema.test.js +65 -65
  189. package/test/tools.test.js +341 -341
  190. package/test/updated-at-semantics.test.js +113 -113
  191. package/test/vector-index.test.js +221 -221
  192. package/test/version-check.test.js +152 -152
  193. package/test/webServer-optional.test.js +82 -82
package/bin/cli.mjs CHANGED
File without changes
@@ -0,0 +1,502 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * dsh-mneme-mcp —— @modusensus/dsh-mneme stdio MCP server (v1, issue #181)
4
+ *
5
+ * 零依赖 ESM(Node >= 20,全局 fetch)。任何 MCP 客户端(Claude Code / Cursor /
6
+ * 任意支持 Model Context Protocol 的 host)以 stdio 挂载本进程,即可获得与 DSH
7
+ * 内一致的记忆工具六件套:memory_save / memory_search / memory_list /
8
+ * memory_get / memory_update / memory_delete。
9
+ *
10
+ * 数据面走 standalone API(8790,Bearer)而非直连 memory.db——写入并发由 DSH
11
+ * 单点负责,最稳。工具名、参数、输出渲染与 src/tools.js 逐字对齐(test/mcp-stdio.test.js
12
+ * 有平价回归锁漂移);scope 语义差异仅一处:standalone API 无会话上下文,
13
+ * save 不做自动标注、只认显式 agent_scope / workspace_scope 声明。
14
+ *
15
+ * 配置优先级(沿用 CLI 约定):
16
+ * 环境变量 DSH_MNEME_URL / DSH_MNEME_TOKEN > ~/.dsh-mneme/cli.json({"url","token"})
17
+ * > 默认 http://127.0.0.1:8790
18
+ *
19
+ * Claude Code 挂载示例(.mcp.json):
20
+ * { "mcpServers": { "dsh-mneme": {
21
+ * "command": "dsh-mneme-mcp",
22
+ * "env": { "DSH_MNEME_TOKEN": "<面板「设置 → 外部访问 API」中的 token>" } } } }
23
+ *
24
+ * 日志只进 stderr;stdout 仅承载 JSON-RPC 帧(每行一条)。
25
+ */
26
+
27
+ import fs from "node:fs";
28
+ import os from "node:os";
29
+ import path from "node:path";
30
+ import process from "node:process";
31
+ import { fileURLToPath, pathToFileURL } from "node:url";
32
+
33
+ const DEFAULT_URL = "http://127.0.0.1:8790";
34
+ const CONFIG_PATH = path.join(os.homedir(), ".dsh-mneme", "cli.json");
35
+ const REQUEST_TIMEOUT_MS = 10_000;
36
+ const SUPPORTED_PROTOCOL_VERSIONS = ["2024-11-05", "2025-03-26", "2025-06-18"];
37
+ const LATEST_PROTOCOL_VERSION = "2025-06-18";
38
+ const SERVER_NAME = "dsh-mneme";
39
+
40
+ const UNAUTHORIZED_HINT =
41
+ "unauthorized: the dsh-mneme standalone API rejected the token. Set DSH_MNEME_TOKEN " +
42
+ "(or `dsh-mneme config set <url> <token>`); the token is shown in the DSH panel " +
43
+ "under Settings -> External API.";
44
+
45
+ function readPkgVersion() {
46
+ try {
47
+ const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json");
48
+ return JSON.parse(fs.readFileSync(pkgPath, "utf8")).version ?? "?";
49
+ } catch {
50
+ return "?";
51
+ }
52
+ }
53
+ const PKG_VERSION = readPkgVersion();
54
+
55
+ // --- 配置解析(env > cli.json > 默认)---------------------------------------
56
+
57
+ function readConfigFile(configPath = CONFIG_PATH) {
58
+ try {
59
+ const parsed = JSON.parse(fs.readFileSync(configPath, "utf8"));
60
+ return parsed && typeof parsed === "object" ? parsed : {};
61
+ } catch {
62
+ return {};
63
+ }
64
+ }
65
+
66
+ function firstNonEmpty(...values) {
67
+ for (const value of values) {
68
+ if (typeof value === "string" && value.trim()) return value.trim();
69
+ }
70
+ return undefined;
71
+ }
72
+
73
+ export function resolveMcpConfig(env = process.env, configPath = CONFIG_PATH) {
74
+ const file = readConfigFile(configPath);
75
+ const url = firstNonEmpty(env.DSH_MNEME_URL, file.url) ?? DEFAULT_URL;
76
+ const token = firstNonEmpty(env.DSH_MNEME_TOKEN, file.token) ?? "";
77
+ return { url: url.replace(/\/+$/, ""), token };
78
+ }
79
+
80
+ // --- HTTP 客户端(超时 + 状态码归一)----------------------------------------
81
+
82
+ async function apiRequest(config, pathname, { method = "GET", body, query } = {}) {
83
+ const search = query ? `?${new URLSearchParams(query)}` : "";
84
+ const controller = new AbortController();
85
+ const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
86
+ let res;
87
+ let text;
88
+ try {
89
+ // res.text() 必须留在本块内:超时信号要覆盖到响应正文读完——只拿到响应头
90
+ // 不算完成,正文停摆同样要被 abort(CodeRabbit 评审项)。
91
+ res = await fetch(`${config.url}${pathname}${search}`, {
92
+ method,
93
+ headers: {
94
+ ...(config.token ? { authorization: `Bearer ${config.token}` } : {}),
95
+ ...(body !== undefined ? { "content-type": "application/json" } : {})
96
+ },
97
+ ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
98
+ signal: controller.signal
99
+ });
100
+ text = await res.text();
101
+ } catch (error) {
102
+ const reason = error?.cause?.code ?? error?.name ?? String(error);
103
+ throw new Error(`dsh-mneme API unreachable at ${config.url}: ${reason}`);
104
+ } finally {
105
+ clearTimeout(timer);
106
+ }
107
+ let json = null;
108
+ try {
109
+ json = text ? JSON.parse(text) : null;
110
+ } catch {
111
+ json = null;
112
+ }
113
+ if (res.status === 401) throw new Error(UNAUTHORIZED_HINT);
114
+ return { status: res.status, json };
115
+ }
116
+
117
+ /** 非 401 的失败统一成带状态码的消息(400 时尽量带上 API 的错误码)。 */
118
+ function assertOk({ status, json }, okStatuses) {
119
+ if (okStatuses.includes(status)) return;
120
+ throw new Error(
121
+ status === 400
122
+ ? `invalid request: ${json?.error ?? "unknown"}`
123
+ : `dsh-mneme API error (HTTP ${status})`
124
+ );
125
+ }
126
+
127
+ // --- 渲染(与 src/tools.js 的 output.render 逐字对齐)-----------------------
128
+
129
+ const MEMORY_PROVENANCE = (m) => {
130
+ const parts = [];
131
+ if (m.occurred_at) parts.push(`occurred: ${m.occurred_at}`);
132
+ if (m.agent_scope || m.workspace_scope) {
133
+ parts.push(`scope: ${m.agent_scope ?? "global"} / ${m.workspace_scope ?? "global"}`);
134
+ }
135
+ if (m.sensitivity) parts.push(`sensitivity: ${m.sensitivity}`);
136
+ return parts.length ? ` | ${parts.join(" | ")}` : "";
137
+ };
138
+
139
+ const previewOf = (content) => {
140
+ const preview = (content ?? "").replace(/\s+/g, " ").trim();
141
+ return preview.length > 200 ? `${preview.slice(0, 200)}…` : preview;
142
+ };
143
+
144
+ // --- 工具定义(六件套;描述与参数同 src/tools.js,平价测试逐字校验)----------
145
+
146
+ const MEMORY_TYPE_ENUM = ["preference", "project", "decision", "history", "rejected_solution", "pitfall", "constraint"];
147
+
148
+ const TOOL_SAVE_DESCRIPTION =
149
+ "Persist one memory entry for future sessions (user preferences, project state, decisions). " +
150
+ "Call this when the user states a durable preference, a project decision is made, or a lesson is learned. " +
151
+ "Merges into an existing entry of the same type when the title matches.";
152
+ const TOOL_SEARCH_DESCRIPTION =
153
+ "Search the cross-session memory store. Use when you need past context: how a problem was solved, user preferences, project decisions. Substring-matches title/content/tags, and augments results with semantic (vector) recall + optional rerank when an embeddings provider is configured. Returns matching entries with source and timestamps.";
154
+ const TOOL_LIST_DESCRIPTION =
155
+ "List memory entries by type, high-importance first, then newest, paginated. Set include_archived=true to also list archived (hidden) entries so they can be located and restored.";
156
+ const TOOL_GET_DESCRIPTION =
157
+ "Fetch one memory entry by ID and return its full content as text. Use after memory_list to read a specific entry.";
158
+ const TOOL_UPDATE_DESCRIPTION =
159
+ "Modify an existing memory entry (title, content, type, tags, importance).";
160
+ const TOOL_DELETE_DESCRIPTION =
161
+ "Permanently delete a memory entry.";
162
+
163
+ const SCOPE_SAVE_NOTE_AGENT =
164
+ "Optional explicit agent-scope declaration (issue #170): 'global' or '*' makes this memory visible to every agent; any other value narrows it to that label. Overrides the automatic carrier label for this write; honored even when automatic scope labeling is disabled.";
165
+ const SCOPE_SAVE_NOTE_WORKSPACE =
166
+ "Optional explicit workspace-scope declaration: 'global' or '*' makes this memory visible in every workspace; any other value narrows it to that label. Overrides the automatic carrier label for this write; honored even when automatic scope labeling is disabled.";
167
+ const SCOPE_UPDATE_NOTE_AGENT =
168
+ "Optional explicit agent-scope correction (issue #170): 'global' or '*' widens visibility to every agent; any other value narrows it to that label. Omit to keep the current agent scope. Recorded as an explicit scope decision (audited).";
169
+ const SCOPE_UPDATE_NOTE_WORKSPACE =
170
+ "Optional explicit workspace-scope correction: 'global' or '*' widens visibility to every workspace; any other value narrows it to that label. Omit to keep the current workspace scope. Recorded as an explicit scope decision (audited).";
171
+ const OCCURRED_FROM_NOTE =
172
+ "Optional ISO date/timestamp lower bound on when the remembered event happened (occurred_at, falling back to created_at). Date-only values are inclusive from that day's 00:00Z.";
173
+ const OCCURRED_TO_NOTE =
174
+ "Optional ISO date/timestamp upper bound on occurred_at. Date-only values are inclusive through that day's 23:59:59.999Z.";
175
+
176
+ async function runSave(config, args) {
177
+ const body = {
178
+ type: args.type,
179
+ title: args.title,
180
+ content: args.content,
181
+ ...(args.tags !== undefined ? { tags: args.tags } : {}),
182
+ ...(args.importance !== undefined ? { importance: args.importance } : {}),
183
+ ...(args.source !== undefined ? { source: args.source } : {}),
184
+ ...(args.sensitivity !== undefined ? { sensitivity: args.sensitivity } : {}),
185
+ ...(args.occurred_at !== undefined ? { occurred_at: args.occurred_at } : {}),
186
+ ...(args.agent_scope !== undefined ? { agent_scope: args.agent_scope } : {}),
187
+ ...(args.workspace_scope !== undefined ? { workspace_scope: args.workspace_scope } : {})
188
+ };
189
+ const res = await apiRequest(config, "/memories", { method: "POST", body });
190
+ assertOk(res, [200, 201]);
191
+ return `memory ${res.json?.action ?? "created"}: ${res.json?.id}`;
192
+ }
193
+
194
+ async function runSearch(config, args) {
195
+ const mode = args.semantic === true && !args.mode ? "vector" : args.mode;
196
+ const query = {
197
+ q: String(args.query ?? ""),
198
+ ...(args.limit !== undefined ? { topK: String(args.limit) } : {}),
199
+ ...(mode !== undefined ? { mode: String(mode) } : {}),
200
+ ...(args.rerank !== undefined ? { rerank: String(args.rerank) } : {}),
201
+ ...(args.occurred_from !== undefined ? { occurred_from: String(args.occurred_from) } : {}),
202
+ ...(args.occurred_to !== undefined ? { occurred_to: String(args.occurred_to) } : {})
203
+ };
204
+ const res = await apiRequest(config, "/search", { query });
205
+ assertOk(res, [200]);
206
+ const items = res.json?.items ?? [];
207
+ if (items.length === 0) return "No memory entries found.";
208
+ const body = items
209
+ .map((m, i) => {
210
+ return `[${i + 1}] ${m.title}\n ID: ${m.id} | type: ${m.type} | importance: ${m.importance} | updated: ${m.updated_at}${MEMORY_PROVENANCE(m)}\n ${previewOf(m.content)}`;
211
+ })
212
+ .join("\n\n");
213
+ return `Found ${items.length} memory entr${items.length === 1 ? "y" : "ies"}:\n\n${body}`;
214
+ }
215
+
216
+ async function runList(config, args) {
217
+ const query = {
218
+ ...(args.type !== undefined ? { type: String(args.type) } : {}),
219
+ ...(args.limit !== undefined ? { limit: String(args.limit) } : {}),
220
+ ...(args.offset !== undefined ? { offset: String(args.offset) } : {}),
221
+ ...(args.include_archived !== undefined ? { include_archived: String(args.include_archived) } : {}),
222
+ ...(args.occurred_from !== undefined ? { occurred_from: String(args.occurred_from) } : {}),
223
+ ...(args.occurred_to !== undefined ? { occurred_to: String(args.occurred_to) } : {})
224
+ };
225
+ const res = await apiRequest(config, "/memories", { query });
226
+ assertOk(res, [200]);
227
+ const items = res.json?.items ?? [];
228
+ const total = res.json?.total ?? 0;
229
+ if (items.length === 0) return `0 memory entries (of ${total}).`;
230
+ const body = items
231
+ .map((m, i) => `[${i + 1}] ${m.title} (type=${m.type}, importance=${m.importance})\n ID: ${m.id} | updated: ${m.updated_at}${MEMORY_PROVENANCE(m)}`)
232
+ .join("\n\n");
233
+ return `${items.length} memory entries (of ${total}):\n\n${body}`;
234
+ }
235
+
236
+ async function runGet(config, args) {
237
+ const res = await apiRequest(config, `/memories/${encodeURIComponent(String(args.id ?? ""))}`);
238
+ // 404 → 与 DSH 内 memory_get 同语义的抛错(isError 渲染 "memory not found")。
239
+ if (res.status === 404) throw new Error("memory not found");
240
+ assertOk(res, [200]);
241
+ const m = res.json;
242
+ if (!m || !m.id) throw new Error("memory not found");
243
+ return `${m.title}\nID: ${m.id} | type: ${m.type} | importance: ${m.importance}${MEMORY_PROVENANCE(m)}\n\n${m.content}`;
244
+ }
245
+
246
+ async function runUpdate(config, args) {
247
+ const body = {
248
+ ...(args.title !== undefined ? { title: args.title } : {}),
249
+ ...(args.content !== undefined ? { content: args.content } : {}),
250
+ ...(args.type !== undefined ? { type: args.type } : {}),
251
+ ...(args.tags !== undefined ? { tags: args.tags } : {}),
252
+ ...(args.importance !== undefined ? { importance: args.importance } : {}),
253
+ ...(args.reason !== undefined ? { reason: args.reason } : {}),
254
+ ...(args.agent_scope !== undefined ? { agent_scope: args.agent_scope } : {}),
255
+ ...(args.workspace_scope !== undefined ? { workspace_scope: args.workspace_scope } : {})
256
+ };
257
+ const res = await apiRequest(config, `/memories/${encodeURIComponent(String(args.id ?? ""))}`, { method: "PUT", body });
258
+ if (res.status === 404) throw new Error("memory not found");
259
+ assertOk(res, [200]);
260
+ const m = res.json?.memory;
261
+ if (!m || !m.id) throw new Error("memory not found");
262
+ return `Updated memory ${m.id}: ${m.title}`;
263
+ }
264
+
265
+ async function runDelete(config, args) {
266
+ const res = await apiRequest(config, `/memories/${encodeURIComponent(String(args.id ?? ""))}`, { method: "DELETE" });
267
+ assertOk(res, [200, 404]);
268
+ return res.status === 200 ? "Memory deleted." : "Memory not found.";
269
+ }
270
+
271
+ const stringSchema = (description) => ({ type: "string", description });
272
+ const intSchema = (description) => ({ type: "integer", description });
273
+ const boolSchema = (description) => ({ type: "boolean", description });
274
+ const tagsSchema = { type: "array", items: { type: "string" }, description: "Optional tags" };
275
+ const tagsUpdateSchema = { type: "array", items: { type: "string" } };
276
+ const typeEnumSchema = (description) => ({ type: "string", enum: MEMORY_TYPE_ENUM, description });
277
+ const importanceSaveSchema = intSchema("1-5; >= threshold auto-injects into future sessions");
278
+
279
+ export const MCP_TOOLS = [
280
+ {
281
+ name: "memory_save",
282
+ description: TOOL_SAVE_DESCRIPTION,
283
+ inputSchema: {
284
+ type: "object",
285
+ properties: {
286
+ type: { ...typeEnumSchema("preference=user profile; project=project knowledge/state; decision=key decision; history=conversation summary; rejected_solution=rejected/abandoned implementation approach; pitfall=debugging lesson (symptom+root cause+fix); constraint=engineering constraint") },
287
+ title: stringSchema("Short unique title"),
288
+ content: stringSchema("Memory body"),
289
+ tags: tagsSchema,
290
+ importance: importanceSaveSchema,
291
+ source: stringSchema("Optional provenance"),
292
+ sensitivity: stringSchema("Optional sensitivity label (free-form, e.g. personal). Same-title entries with different sensitivity stay separate instead of merging."),
293
+ occurred_at: stringSchema("Optional ISO-8601 instant the remembered event happened (differs from write time). Invalid values are ignored."),
294
+ agent_scope: stringSchema(SCOPE_SAVE_NOTE_AGENT),
295
+ workspace_scope: stringSchema(SCOPE_SAVE_NOTE_WORKSPACE)
296
+ },
297
+ required: ["type", "title", "content"]
298
+ }
299
+ },
300
+ {
301
+ name: "memory_search",
302
+ description: TOOL_SEARCH_DESCRIPTION,
303
+ inputSchema: {
304
+ type: "object",
305
+ properties: {
306
+ query: stringSchema("Search text; substring match over title/content/tags"),
307
+ limit: intSchema("Max results (default 20)"),
308
+ mode: { type: "string", enum: ["auto", "keyword", "vector", "hybrid"], description: "auto (default) = keyword hits first + vector fill when enabled; keyword = text only; vector = semantic recall first (falls back to keyword); hybrid = vector leads, keyword fills remaining slots" },
309
+ semantic: boolSchema("Shorthand: enable semantic (vector) recall (same as mode=vector when true)"),
310
+ rerank: boolSchema("Run cross-encoder rerank over candidates when a local reranker is configured (default true)"),
311
+ occurred_from: stringSchema(OCCURRED_FROM_NOTE),
312
+ occurred_to: stringSchema(OCCURRED_TO_NOTE)
313
+ },
314
+ required: ["query"]
315
+ }
316
+ },
317
+ {
318
+ name: "memory_list",
319
+ description: TOOL_LIST_DESCRIPTION,
320
+ inputSchema: {
321
+ type: "object",
322
+ properties: {
323
+ type: typeEnumSchema("Filter by type; omit for all"),
324
+ limit: intSchema("Page size (default 50)"),
325
+ offset: intSchema("Page offset (default 0)"),
326
+ include_archived: boolSchema("Include archived (hidden) entries so they can be found and restored (default false)"),
327
+ occurred_from: stringSchema(OCCURRED_FROM_NOTE),
328
+ occurred_to: stringSchema(OCCURRED_TO_NOTE)
329
+ },
330
+ required: []
331
+ }
332
+ },
333
+ {
334
+ name: "memory_get",
335
+ description: TOOL_GET_DESCRIPTION,
336
+ inputSchema: {
337
+ type: "object",
338
+ properties: { id: stringSchema("Memory id") },
339
+ required: ["id"]
340
+ }
341
+ },
342
+ {
343
+ name: "memory_update",
344
+ description: TOOL_UPDATE_DESCRIPTION,
345
+ inputSchema: {
346
+ type: "object",
347
+ properties: {
348
+ id: stringSchema("Memory id"),
349
+ title: stringSchema("New title"),
350
+ content: stringSchema("New content"),
351
+ type: typeEnumSchema("New type"),
352
+ tags: tagsUpdateSchema,
353
+ importance: intSchema("1-5"),
354
+ reason: stringSchema("Optional context for the correction (what the user actually said/wanted), recorded for reflection"),
355
+ agent_scope: stringSchema(SCOPE_UPDATE_NOTE_AGENT),
356
+ workspace_scope: stringSchema(SCOPE_UPDATE_NOTE_WORKSPACE)
357
+ },
358
+ required: ["id"]
359
+ }
360
+ },
361
+ {
362
+ name: "memory_delete",
363
+ description: TOOL_DELETE_DESCRIPTION,
364
+ inputSchema: {
365
+ type: "object",
366
+ properties: { id: stringSchema("Memory id") },
367
+ required: ["id"]
368
+ }
369
+ }
370
+ ];
371
+
372
+ const TOOL_RUNNERS = new Map([
373
+ ["memory_save", runSave],
374
+ ["memory_search", runSearch],
375
+ ["memory_list", runList],
376
+ ["memory_get", runGet],
377
+ ["memory_update", runUpdate],
378
+ ["memory_delete", runDelete]
379
+ ]);
380
+
381
+ // --- JSON-RPC over stdio(MCP:每行一条消息)---------------------------------
382
+
383
+ const rpcError = (code, message) => ({ code, message });
384
+
385
+ async function dispatch(config, msg) {
386
+ switch (msg.method) {
387
+ case "initialize": {
388
+ const requested = typeof msg.params?.protocolVersion === "string" ? msg.params.protocolVersion : LATEST_PROTOCOL_VERSION;
389
+ return {
390
+ protocolVersion: SUPPORTED_PROTOCOL_VERSIONS.includes(requested) ? requested : LATEST_PROTOCOL_VERSION,
391
+ capabilities: { tools: { listChanged: false } },
392
+ serverInfo: { name: SERVER_NAME, version: PKG_VERSION },
393
+ instructions:
394
+ "dsh-mneme cross-session memory (six tools mirroring the in-DSH memory tools). " +
395
+ "Data plane: the plugin's standalone API. Configure DSH_MNEME_URL / DSH_MNEME_TOKEN or ~/.dsh-mneme/cli.json."
396
+ };
397
+ }
398
+ case "ping":
399
+ return {};
400
+ case "tools/list":
401
+ return { tools: MCP_TOOLS };
402
+ case "tools/call": {
403
+ const name = msg.params?.name;
404
+ const runner = TOOL_RUNNERS.get(name);
405
+ if (!runner) throw rpcError(-32602, `Unknown tool: ${name === undefined ? "(missing)" : String(name)}`);
406
+ try {
407
+ const text = await runner(config, msg.params?.arguments ?? {});
408
+ return { content: [{ type: "text", text }] };
409
+ } catch (error) {
410
+ return { content: [{ type: "text", text: String(error?.message ?? error) }], isError: true };
411
+ }
412
+ }
413
+ default:
414
+ throw rpcError(-32601, `method not found: ${String(msg.method)}`);
415
+ }
416
+ }
417
+
418
+ function createMcpServer(config) {
419
+ let buffer = "";
420
+ const write = (message) => {
421
+ process.stdout.write(`${JSON.stringify(message)}\n`);
422
+ };
423
+ const handleLine = (line) => {
424
+ const trimmed = line.trim();
425
+ if (!trimmed) return;
426
+ let msg;
427
+ try {
428
+ msg = JSON.parse(trimmed);
429
+ } catch {
430
+ write({ jsonrpc: "2.0", id: null, error: rpcError(-32700, "Parse error") });
431
+ return;
432
+ }
433
+ if (!msg || typeof msg !== "object" || typeof msg.method !== "string") {
434
+ // 合法 JSON 但不是有效请求/通知({}、数组等):按 JSON-RPC 回 -32600,
435
+ // 提取得到 id 就带上、取不到用 null——客户端不该分不清「无效」和「无响应」。
436
+ write({
437
+ jsonrpc: "2.0",
438
+ id: msg && typeof msg === "object" && msg.id !== undefined ? msg.id : null,
439
+ error: rpcError(-32600, "Invalid Request")
440
+ });
441
+ return;
442
+ }
443
+ // 通知(无 id):不回复。initialized/cancelled 等一律静默。
444
+ if (msg.id === undefined) return;
445
+ dispatch(config, msg).then(
446
+ (result) => write({ jsonrpc: "2.0", id: msg.id, result }),
447
+ (error) => write({ jsonrpc: "2.0", id: msg.id, error: error?.code !== undefined && error?.message !== undefined ? error : rpcError(-32603, `internal error: ${String(error?.message ?? error)}`) })
448
+ );
449
+ };
450
+ return {
451
+ handleLine,
452
+ start() {
453
+ process.stdin.setEncoding("utf8");
454
+ process.stdin.on("data", (chunk) => {
455
+ buffer += chunk;
456
+ let idx;
457
+ while ((idx = buffer.indexOf("\n")) >= 0) {
458
+ const line = buffer.slice(0, idx);
459
+ buffer = buffer.slice(idx + 1);
460
+ handleLine(line.endsWith("\r") ? line.slice(0, -1) : line);
461
+ }
462
+ });
463
+ process.stdin.on("end", () => process.exit(0));
464
+ process.stdin.on("error", () => process.exit(1));
465
+ const shutdown = () => process.exit(0);
466
+ process.on("SIGINT", shutdown);
467
+ process.on("SIGTERM", shutdown);
468
+ // token 缺失只 warn 不退出——health/open 路由仍可用,且提示比静默 401 友好。
469
+ if (!config.token) {
470
+ process.stderr.write("[dsh-mneme-mcp] warning: no token configured (DSH_MNEME_TOKEN / ~/.dsh-mneme/cli.json); authenticated calls will fail.\n");
471
+ }
472
+ }
473
+ };
474
+ }
475
+
476
+ function runningAsMain() {
477
+ const arg = process.argv[1];
478
+ if (!arg) return false;
479
+ try {
480
+ const entry = pathToFileURL(path.resolve(arg)).href;
481
+ return entry === import.meta.url || entry.toLowerCase() === import.meta.url.toLowerCase();
482
+ } catch {
483
+ return false;
484
+ }
485
+ }
486
+
487
+ export function main() {
488
+ const config = resolveMcpConfig();
489
+ // 非回环 HTTP 明文传输会把 Bearer token 暴露给链路——与 CLI 同款取舍,但
490
+ // 至少要喊一声,不让操作者无感地越过「默认仅本机」的安全模型。
491
+ try {
492
+ const url = new URL(config.url);
493
+ const host = url.hostname;
494
+ const loopback = host === "127.0.0.1" || host === "localhost" || host === "::1" || host === "[::1]";
495
+ if (url.protocol === "http:" && !loopback) {
496
+ process.stderr.write(`[dsh-mneme-mcp] warning: ${config.url} is plain HTTP on a non-loopback host — the Bearer token travels unencrypted. Prefer SSH tunneling or a loopback address.\n`);
497
+ }
498
+ } catch { /* 非法 URL 交给请求路径报错 */ }
499
+ createMcpServer(config).start();
500
+ }
501
+
502
+ if (runningAsMain()) main();
package/cordis.patch.yml CHANGED
@@ -1,21 +1,21 @@
1
- # dsh-mneme bundle patch — the layer applied when a profile lists this bundle.
2
- # Installed via: dsh plugin --profile <name> add @modusensus/dsh-mneme
3
- - insert:
4
- - id: dsh-mneme
5
- name: '@modusensus/dsh-mneme'
6
- config:
7
- memoryDir: ~/.dsh/memory
8
- autoInject: true
9
- autoSummarize: true
10
- maxInjectedItems: 5
11
- importanceThreshold: 3
12
- autoDream: true
13
- dreamThresholdCount: 10
14
- dreamThresholdChars: 5000
15
- dreamDelayMs: 2000
16
- # 巩固默认压低推理:思考型模型(如方舟 v4 系)会把 dreamMaxTokens
17
- # 预算花在推理上、正文空体 → "no json array in llm output"。low 让
18
- # provider 封顶推理;拒绝 effort 字段的 provider 由 runAuditedLlm
19
- # 自动去掉重试,行为安全(v0.7.16 机制)。
20
- dreamReasoningEffort: low
21
- entityExtractionEnabled: true
1
+ # dsh-mneme bundle patch — the layer applied when a profile lists this bundle.
2
+ # Installed via: dsh plugin --profile <name> add @modusensus/dsh-mneme
3
+ - insert:
4
+ - id: dsh-mneme
5
+ name: '@modusensus/dsh-mneme'
6
+ config:
7
+ memoryDir: ~/.dsh/memory
8
+ autoInject: true
9
+ autoSummarize: true
10
+ maxInjectedItems: 5
11
+ importanceThreshold: 3
12
+ autoDream: true
13
+ dreamThresholdCount: 10
14
+ dreamThresholdChars: 5000
15
+ dreamDelayMs: 2000
16
+ # 巩固默认压低推理:思考型模型(如方舟 v4 系)会把 dreamMaxTokens
17
+ # 预算花在推理上、正文空体 → "no json array in llm output"。low 让
18
+ # provider 封顶推理;拒绝 effort 字段的 provider 由 runAuditedLlm
19
+ # 自动去掉重试,行为安全(v0.7.16 机制)。
20
+ dreamReasoningEffort: low
21
+ entityExtractionEnabled: true