dsh-macro-memory 0.0.0-stage → 0.3.0

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 (130) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +457 -2
  3. package/cordis.patch.yml +6 -0
  4. package/lib/client.js +3623 -0
  5. package/lib/index.js +469 -0
  6. package/lib/macro/brand.js +82 -0
  7. package/lib/macro/bridge.js +158 -0
  8. package/lib/macro/chain.js +206 -0
  9. package/lib/macro/contract.js +471 -0
  10. package/lib/macro/cost.js +164 -0
  11. package/lib/macro/defs/admin.js +439 -0
  12. package/lib/macro/defs/dream.js +24 -0
  13. package/lib/macro/defs/link.js +257 -0
  14. package/lib/macro/defs/project.js +25 -0
  15. package/lib/macro/defs/read.js +145 -0
  16. package/lib/macro/defs/remember.js +213 -0
  17. package/lib/macro/defs/search.js +661 -0
  18. package/lib/macro/defs/update.js +161 -0
  19. package/lib/macro/dreamledger.js +1398 -0
  20. package/lib/macro/facade.js +135 -0
  21. package/lib/macro/fusion.js +182 -0
  22. package/lib/macro/linkflow.js +391 -0
  23. package/lib/macro/links.js +448 -0
  24. package/lib/macro/neighbor.js +209 -0
  25. package/lib/macro/panel.js +96 -0
  26. package/lib/macro/prompt.js +139 -0
  27. package/lib/macro/provenance.js +148 -0
  28. package/lib/macro/render.js +35 -0
  29. package/lib/macro/revisions.js +253 -0
  30. package/lib/macro/shared.js +113 -0
  31. package/lib/macro/store.js +103 -0
  32. package/lib/macro/tokencost.js +90 -0
  33. package/lib/macro/tools.js +67 -0
  34. package/package.json +54 -4
  35. package/vendor/VENDOR.json +23 -0
  36. package/vendor/dsh-memory-nebula/CONTRIBUTING.md +48 -0
  37. package/vendor/dsh-memory-nebula/LICENSE +21 -0
  38. package/vendor/dsh-memory-nebula/README.en.md +203 -0
  39. package/vendor/dsh-memory-nebula/README.md +253 -0
  40. package/vendor/dsh-memory-nebula/SECURITY.md +43 -0
  41. package/vendor/dsh-memory-nebula/SUPPORT.md +33 -0
  42. package/vendor/dsh-memory-nebula/cordis.patch.yml +4 -0
  43. package/vendor/dsh-memory-nebula/lib/client.js +105 -0
  44. package/vendor/dsh-memory-nebula/lib/host/adapters/index.js +279 -0
  45. package/vendor/dsh-memory-nebula/lib/host/adapters/ingest.js +230 -0
  46. package/vendor/dsh-memory-nebula/lib/host/adapters/meow.js +317 -0
  47. package/vendor/dsh-memory-nebula/lib/host/adapters/notes.js +305 -0
  48. package/vendor/dsh-memory-nebula/lib/host/adapters/sqlite.js +287 -0
  49. package/vendor/dsh-memory-nebula/lib/host/adapters/util.js +231 -0
  50. package/vendor/dsh-memory-nebula/lib/host/bridge.js +351 -0
  51. package/vendor/dsh-memory-nebula/lib/host/compress.js +97 -0
  52. package/vendor/dsh-memory-nebula/lib/host/demo.js +357 -0
  53. package/vendor/dsh-memory-nebula/lib/host/diagnostics.js +125 -0
  54. package/vendor/dsh-memory-nebula/lib/host/doctor.js +270 -0
  55. package/vendor/dsh-memory-nebula/lib/host/graph.js +1663 -0
  56. package/vendor/dsh-memory-nebula/lib/host/graphcache.js +282 -0
  57. package/vendor/dsh-memory-nebula/lib/host/http.js +993 -0
  58. package/vendor/dsh-memory-nebula/lib/host/injectcfg.js +95 -0
  59. package/vendor/dsh-memory-nebula/lib/host/ledger.js +175 -0
  60. package/vendor/dsh-memory-nebula/lib/host/live.js +204 -0
  61. package/vendor/dsh-memory-nebula/lib/host/nebula.js +2105 -0
  62. package/vendor/dsh-memory-nebula/lib/host/page.js +75 -0
  63. package/vendor/dsh-memory-nebula/lib/host/path.js +83 -0
  64. package/vendor/dsh-memory-nebula/lib/host/recall.js +451 -0
  65. package/vendor/dsh-memory-nebula/lib/host/share.js +633 -0
  66. package/vendor/dsh-memory-nebula/lib/host/sources.js +266 -0
  67. package/vendor/dsh-memory-nebula/lib/host/store.js +333 -0
  68. package/vendor/dsh-memory-nebula/lib/host/text.js +410 -0
  69. package/vendor/dsh-memory-nebula/lib/host/transcripts.js +396 -0
  70. package/vendor/dsh-memory-nebula/lib/index.js +759 -0
  71. package/vendor/dsh-memory-nebula/lib/standalone.mjs +315 -0
  72. package/vendor/dsh-memory-nebula/lib/web/api.js +426 -0
  73. package/vendor/dsh-memory-nebula/lib/web/app.js +4159 -0
  74. package/vendor/dsh-memory-nebula/lib/web/i18n.js +580 -0
  75. package/vendor/dsh-memory-nebula/lib/web/index.html +174 -0
  76. package/vendor/dsh-memory-nebula/lib/web/nav.js +132 -0
  77. package/vendor/dsh-memory-nebula/lib/web/render.js +1890 -0
  78. package/vendor/dsh-memory-nebula/lib/web/space3d.js +1883 -0
  79. package/vendor/dsh-memory-nebula/lib/web/style.css +1402 -0
  80. package/vendor/dsh-memory-nebula/locale/en.json +7 -0
  81. package/vendor/dsh-memory-nebula/locale/zh.json +7 -0
  82. package/vendor/dsh-memory-nebula/market/assets/icon-180.png +0 -0
  83. package/vendor/dsh-memory-nebula/market/assets/icon.svg +40 -0
  84. package/vendor/dsh-memory-nebula/market/index.json +101 -0
  85. package/vendor/dsh-memory-nebula/package.json +87 -0
  86. package/vendor/dsh-memory-nebula/sidecar.ps1 +119 -0
  87. package/vendor/meow-memory/LICENSE +21 -0
  88. package/vendor/meow-memory/README.en.md +192 -0
  89. package/vendor/meow-memory/README.md +174 -0
  90. package/vendor/meow-memory/README.pt-br.md +180 -0
  91. package/vendor/meow-memory/cordis.patch.yml +7 -0
  92. package/vendor/meow-memory/lib/client.js +3344 -0
  93. package/vendor/meow-memory/lib/client.js.map +7 -0
  94. package/vendor/meow-memory/lib/index.js +9567 -0
  95. package/vendor/meow-memory/lib/index.js.map +7 -0
  96. package/vendor/meow-memory/lib/prompts/README.md +65 -0
  97. package/vendor/meow-memory/lib/prompts/en/dream-atomic.md +36 -0
  98. package/vendor/meow-memory/lib/prompts/en/dream-header.md +9 -0
  99. package/vendor/meow-memory/lib/prompts/en/dream-project-summary.md +12 -0
  100. package/vendor/meow-memory/lib/prompts/en/dream-topic.md +27 -0
  101. package/vendor/meow-memory/lib/prompts/en/external-memory-notice.md +8 -0
  102. package/vendor/meow-memory/lib/prompts/en/first-create-notice.md +8 -0
  103. package/vendor/meow-memory/lib/prompts/en/labels.md +98 -0
  104. package/vendor/meow-memory/lib/prompts/en/reflect.md +31 -0
  105. package/vendor/meow-memory/lib/prompts/en/system-guide.md +121 -0
  106. package/vendor/meow-memory/lib/prompts/en/tools.md +83 -0
  107. package/vendor/meow-memory/lib/prompts/en/welcome-guide.md +12 -0
  108. package/vendor/meow-memory/lib/prompts/pt-br/dream-atomic.md +36 -0
  109. package/vendor/meow-memory/lib/prompts/pt-br/dream-header.md +9 -0
  110. package/vendor/meow-memory/lib/prompts/pt-br/dream-project-summary.md +12 -0
  111. package/vendor/meow-memory/lib/prompts/pt-br/dream-topic.md +27 -0
  112. package/vendor/meow-memory/lib/prompts/pt-br/external-memory-notice.md +8 -0
  113. package/vendor/meow-memory/lib/prompts/pt-br/first-create-notice.md +8 -0
  114. package/vendor/meow-memory/lib/prompts/pt-br/labels.md +98 -0
  115. package/vendor/meow-memory/lib/prompts/pt-br/reflect.md +31 -0
  116. package/vendor/meow-memory/lib/prompts/pt-br/system-guide.md +121 -0
  117. package/vendor/meow-memory/lib/prompts/pt-br/tools.md +83 -0
  118. package/vendor/meow-memory/lib/prompts/pt-br/welcome-guide.md +12 -0
  119. package/vendor/meow-memory/lib/prompts/zh/dream-atomic.md +36 -0
  120. package/vendor/meow-memory/lib/prompts/zh/dream-header.md +9 -0
  121. package/vendor/meow-memory/lib/prompts/zh/dream-project-summary.md +19 -0
  122. package/vendor/meow-memory/lib/prompts/zh/dream-topic.md +27 -0
  123. package/vendor/meow-memory/lib/prompts/zh/external-memory-notice.md +8 -0
  124. package/vendor/meow-memory/lib/prompts/zh/first-create-notice.md +8 -0
  125. package/vendor/meow-memory/lib/prompts/zh/labels.md +98 -0
  126. package/vendor/meow-memory/lib/prompts/zh/reflect.md +30 -0
  127. package/vendor/meow-memory/lib/prompts/zh/system-guide.md +119 -0
  128. package/vendor/meow-memory/lib/prompts/zh/tools.md +83 -0
  129. package/vendor/meow-memory/lib/prompts/zh/welcome-guide.md +12 -0
  130. package/vendor/meow-memory/package.json +64 -0
@@ -0,0 +1,257 @@
1
+ import { TEXT_OUT } from '../shared.js'
2
+ import { pathAnswerKind } from '../contract.js'
3
+ import { cardTitle } from '../panel.js'
4
+ import {
5
+ LINK_CALL_MS,
6
+ PENDING_REASONS,
7
+ describeMs,
8
+ dropPending,
9
+ isLinkedText,
10
+ isNotReady,
11
+ isSelfPairText,
12
+ isTimedOut,
13
+ queuePending,
14
+ saysMissingNodes,
15
+ withBudget,
16
+ } from '../links.js'
17
+
18
+ /**
19
+ * [macro-fusion 0.2.59] 动作名和两端 id 都是「必填的枚举 / 必填的字段」,原来却是流水线自己往下走。
20
+ *
21
+ * `const action = String(args.action)` 只在**不认识**时抛错,`args.a` / `args.b` 干脆不校验:
22
+ * `resolveIdDetail(undefined)` 回 `{ kind: 'missing', id: '' }`,而下面那句
23
+ * `[ra === null ? args.a : null].filter(Boolean)` 会把 `undefined` 过滤掉——于是「缺参数」
24
+ * 假装成「两端都查到了」,payload 变成 `{ a: null, b: null }`,星图回一句「连线未完成」,
25
+ * 我们再把它读成「星图还没建到 / 暂时没落图」→ **排一条永远连不上的欠账**,还告诉用户
26
+ * 「已排队,读记忆时自动补」。缺参数是最常见的调用错误,却拿到了最像环境问题的那句话。
27
+ */
28
+ const LINK_ACTIONS = ['link', 'unlink', 'mute', 'unmute', 'path']
29
+
30
+ /**
31
+ * [macro-fusion 0.2.60] 卡片上的中文名:动作键不是名字。
32
+ * 0.2.25 在 memory_admin 里已经修过一次同样的毛病(`记忆运维:stats` 没人看得懂),
33
+ * 这里漏了——`星图连线:path` 既不知道在做什么,还把只读的 path 标成了写操作。
34
+ */
35
+ const LINK_ACTION_LABELS = {
36
+ link: '连一条手工线',
37
+ unlink: '断开手工线',
38
+ mute: '屏蔽自动关联',
39
+ unmute: '撤销屏蔽',
40
+ path: '看证据链',
41
+ }
42
+
43
+ /** 动作名归一:trim + 小写,空值=没给。不认识就一句都不动(和 0.2.58 的 mode 同一套规矩)。 */
44
+ function linkActionOf(args) {
45
+ const raw = args.action
46
+ if (typeof raw !== 'string' || raw.trim() === '') {
47
+ return { name: '', bad: true, missing: true, raw: raw === undefined ? '' : String(raw) }
48
+ }
49
+ const name = raw.trim().toLowerCase()
50
+ return { name, bad: !LINK_ACTIONS.includes(name), missing: false, raw: String(raw) }
51
+ }
52
+
53
+ function badActionText(act) {
54
+ const list = 'link / unlink / mute / unmute / path'
55
+ if (act.missing) {
56
+ return (
57
+ `memory_link 这次一条都没动:没给 action。\n` +
58
+ `要做的动作得写明:${list}(连一条手工线用 link,断开用 unlink,屏蔽推断错的自动关联用 mute,撤销屏蔽用 unmute,解释证据链用 path)。\n` +
59
+ '星图和记忆都没动——这不代表「连不上」,只是这一步还没开始。'
60
+ )
61
+ }
62
+ return (
63
+ `memory_link 这次一条都没动:action 给的是「${act.raw}」,这里只认 ${list}(大小写不敏感,前后空格会去掉)。\n` +
64
+ '这不代表「连不上」——是动作名没对上,星图和记忆都没动。\n' +
65
+ '对应关系:连一条手工线用 link;断开手工线用 unlink;屏蔽推断错的自动关联用 mute;撤销屏蔽用 unmute;解释两条记忆之间的证据链用 path(配 maxHops)。'
66
+ )
67
+ }
68
+
69
+ const LINK_END_FIELDS = [
70
+ ['a', '起点记忆的 id'],
71
+ ['b', '终点记忆的 id(path 的终点)'],
72
+ ]
73
+
74
+ /** 缺哪端就说哪端。空串 / 纯空格也算没给——`String(undefined)` 曾经让这一支直接消失。 */
75
+ function missingEnds(args) {
76
+ const out = []
77
+ for (const [key, hint] of LINK_END_FIELDS) {
78
+ const v = args[key]
79
+ if (typeof v !== 'string' || v.trim() === '') out.push({ key, hint })
80
+ }
81
+ return out
82
+ }
83
+
84
+ function missingEndsText(act, ends) {
85
+ const which = ends.map((e) => `缺 ${e.key}(${e.hint})`).join(';')
86
+ return (
87
+ `memory_link(${act.name}) 这次一条都没动:${which}。\n` +
88
+ 'id 从 memory_search / memory_read 的回执里抄,8 位短 id 也认。\n' +
89
+ '两端 id 没齐之前不会去动星图,也不会先排一条连不上的欠账——补上再调一次就行。'
90
+ )
91
+ }
92
+
93
+ /** 参数给错了动作:一样要说「这次没用上」,不能当没看见(0.2.57 / 0.2.58 的同一套口径)。 */
94
+ function linkNotes(action, args) {
95
+ const notes = []
96
+ if (args.maxHops !== undefined && action !== 'path') {
97
+ notes.push(`maxHops 只在 path 这个动作生效(这次是 ${action}),没用上。`)
98
+ }
99
+ if (typeof args.note === 'string' && args.note.trim() !== '' && action !== 'link' && action !== 'mute') {
100
+ notes.push(`note 只有 link / mute 会存下来(这次是 ${action}),这句理由没地方记。`)
101
+ }
102
+ return notes
103
+ }
104
+
105
+ export function createLink({ flow }) {
106
+ return {
107
+ name: 'memory_link',
108
+ description:
109
+ '管理星图(宏记忆 · 星图)里的连线:link 固化一条手工连线、unlink 断开手工线、mute 屏蔽推断错的自动关联(重建也不会再连)、unmute 撤销屏蔽、path 解释两条记忆之间的最短证据链。a/b 支持 8 位短 id。',
110
+ parameters: {
111
+ type: 'object',
112
+ additionalProperties: false,
113
+ properties: {
114
+ action: { type: 'string', enum: ['link', 'unlink', 'mute', 'unmute', 'path'], description: '要做的动作。' },
115
+ a: { type: 'string', description: '记忆 A 的 id(8 位短 id 也行)。' },
116
+ b: { type: 'string', description: '记忆 B 的 id(path 的终点,8 位短 id 也行)。' },
117
+ note: { type: 'string', description: '理由,方便以后回看为什么连/为什么屏蔽。' },
118
+ maxHops: { type: 'integer', description: 'path 最多几跳,默认 6。' },
119
+ },
120
+ required: ['action', 'a', 'b'],
121
+ },
122
+ output: TEXT_OUT,
123
+ async execute(args, exec) {
124
+ const act = linkActionOf(args)
125
+ if (act.bad) return badActionText(act)
126
+ const ends = missingEnds(args)
127
+ if (ends.length > 0) return missingEndsText(act, ends)
128
+ const text = await runLink(flow, act.name, args, exec)
129
+ const notes = linkNotes(act.name, args)
130
+ return notes.length > 0 ? `${text}\n\n${notes.join('\n')}` : text
131
+ },
132
+ presentCall(args) {
133
+ // [macro-fusion 0.2.60] 卡片标题也是口径:动作键(link/path)不是名字,
134
+ // 只读的 path 也不该被标成写操作。中文名与 kind 都从这里定,标题走 cardTitle()。
135
+ const act = linkActionOf(args)
136
+ if (act.bad) return { card: 'generic', title: cardTitle('星图连线', '动作名没对上'), kind: 'read' }
137
+ const ends = [args.a, args.b].filter((v) => typeof v === 'string' && v.trim() !== '').map((v) => v.trim())
138
+ const detail = ends.length > 0 ? `${LINK_ACTION_LABELS[act.name]} ${ends.join(' ↔ ')}` : LINK_ACTION_LABELS[act.name]
139
+ return { card: 'generic', title: cardTitle('星图连线', detail), kind: act.name === 'path' ? 'read' : 'write' }
140
+ },
141
+ }
142
+ }
143
+
144
+ /**
145
+ * 动作名与两端 id 都已校验过。[macro-fusion 0.2.59] 主体从 execute 搬到模块级函数:
146
+ * 对象方法里裸调模块级函数会解析到外层作用域(0.2.58 踩过),所以 flow 显式传进来。
147
+ */
148
+ async function runLink(flow, action, args, exec) {
149
+ // 短 id → 完整 id:meow 输出只给 8 位前缀,星图节点 id 是完整 id。
150
+ // 0.2.54:归不出来有三种,各说各的——撞车(记忆在、前缀不够)/ 没查成(不知道有没有)/
151
+ // 真没有。原来一律报「找不到(id 写错了,或它已经被合并/删除)」,撞车和超时都被说成「它没了」。
152
+ const da = await flow.resolveIdDetail(args.a, exec)
153
+ const db = await flow.resolveIdDetail(args.b, exec)
154
+ const AMB = '星图连线这次没做:'
155
+ if (da.kind === 'ambiguous' || db.kind === 'ambiguous') {
156
+ const notes = [da, db]
157
+ .filter((d) => d.kind === 'ambiguous')
158
+ .map((d) => `「${d.id}」${d.note || 'id 给短了,落不到唯一一条'}`)
159
+ return (
160
+ `${AMB}${notes.join(';')}\n` +
161
+ `连错一条比没连上更难发现,所以这次一条都没连:把 id 给够位数(至少 8 位,最好整条)再试一次。`
162
+ )
163
+ }
164
+ if (da.kind === 'unavailable' || db.kind === 'unavailable') {
165
+ const notes = [da, db].filter((d) => d.kind === 'unavailable').map((d) => `「${d.id}」${d.note || '没查到'}`)
166
+ return (
167
+ `${AMB}这次没查成:${notes.join(';')}\n` +
168
+ `这不是「这条记忆不存在」——读记忆的工具这次没接上,等它就绪再试一次;连线一条都没动。`
169
+ )
170
+ }
171
+ const ra = da.kind === 'ok' ? da.id : null
172
+ const rb = db.kind === 'ok' ? db.id : null
173
+ const missing = [ra === null ? args.a : null, rb === null ? args.b : null].filter(Boolean)
174
+ if (missing.length > 0) {
175
+ return `这个工作区里没有这条记忆:${missing.join('、')}——id 可能写错了一位,或者它已经被合并/删除(合并会把旧 id 指到新条目上,旧的那条就查不到了)。用 memory_search 反查一下 id 再连。`
176
+ }
177
+ const payload = { action, a: ra, b: rb }
178
+ if (args.note !== undefined) payload.note = args.note
179
+ if (args.maxHops !== undefined) payload.maxHops = args.maxHops
180
+
181
+ if (action === 'link') {
182
+ await flow.flushLinks(exec)
183
+ const callMs = flow.linkCallMs ?? LINK_CALL_MS
184
+ const raw = await withBudget(flow.tryCall('nebula_link', payload, exec, '星图连线'), callMs)
185
+ if (isTimedOut(raw)) {
186
+ // 掐断不是失败(0.2.31):星图多半正在建图,`addLink` 幂等,排队重试不会写脏数据。
187
+ queuePending(ra, rb, typeof args.note === 'string' ? args.note : '', PENDING_REASONS.slow)
188
+ return (
189
+ `星图 ${describeMs(callMs)}内没回应(多半在建图),连线已排队,读记忆时会自动补;` +
190
+ `也可以稍后重试 memory_link(action="link", a="${ra}", b="${rb}")。`
191
+ )
192
+ }
193
+ const r = raw
194
+ if (r.entry) {
195
+ if (isLinkedText(r.text)) dropPending(ra, rb)
196
+ return r.text
197
+ }
198
+ const why = r.text.replace(/^星图连线未完成:/, '')
199
+ // 自己连自己:星图明确拒绝,排队也没用,别制造一条永远连不上的欠账
200
+ if (isSelfPairText(why)) return why.slice(0, 200)
201
+ // 其余都要排队(0.2.30 起含「找不到这两条记忆」):那句话可能是「节点还没建进图」,
202
+ // 不是「记忆不存在」——把它当永久失败,用户这次连线就白写了。
203
+ const notBuilt = saysMissingNodes(why)
204
+ const retry = `也可以稍后重试 memory_link(action="link", a="${ra}", b="${rb}")。`
205
+ queuePending(ra, rb, typeof args.note === 'string' ? args.note : '', notBuilt ? PENDING_REASONS.notBuilt : PENDING_REASONS.failed)
206
+ // 环境问题(星图没装配/没起)不转述内部错误:成功路径上出现「这项能力还没就绪」会让模型以为工具面坏了
207
+ if (isNotReady(why)) {
208
+ return `星图这次没接上,连线已排队,读记忆时会自动补;${retry}`
209
+ }
210
+ if (notBuilt) {
211
+ return `星图还没建到这两条记忆(约 12s 一轮巡检),连线已排队,读记忆时会自动补;${retry}`
212
+ }
213
+ return `连线暂时没落图(${why.slice(0, 120)}),已排队,之后读记忆时自动补连;${retry}`
214
+ }
215
+ const verb = { unlink: '断开连线', mute: '屏蔽自动关联', unmute: '撤销屏蔽', path: '解释证据链' }[action] || action
216
+ const callMs2 = flow.linkCallMs ?? LINK_CALL_MS
217
+ const raw2 = await withBudget(
218
+ flow.tryCall(
219
+ action === 'path' ? 'nebula_path' : 'nebula_link',
220
+ payload,
221
+ exec,
222
+ action === 'path' ? '星图路径' : '星图连线',
223
+ ),
224
+ callMs2,
225
+ )
226
+ if (isTimedOut(raw2)) {
227
+ return (
228
+ `星图 ${describeMs(callMs2)}内没回应(多半在建图),${verb}这次没做成——` +
229
+ '等它建完再试一次就行,记忆本身没受影响。'
230
+ )
231
+ }
232
+ const r2 = raw2
233
+ if (r2.entry) {
234
+ // path 是唯一一个「星图的原话本身就是答案」的动作,但它的四句话里有两句
235
+ // 字面上像「没关系」、实际是「还没算」(0.2.37)。这一步只做翻译,不改星图的结论:
236
+ // 真没关系照原样转述(那是诚实),没算出来就说清「这不是答案」。
237
+ if (action !== 'path') return r2.text
238
+ const kind = pathAnswerKind(r2.text)
239
+ if (kind === 'missing') {
240
+ return (
241
+ '星图还没建到这两条记忆(约 12s 一轮巡检),所以现在看不出它们有没有关系——' +
242
+ '这不是「没关系」的答案,等它建完再问一次就行;记忆本身没受影响。'
243
+ )
244
+ }
245
+ if (kind === 'engineStale') {
246
+ return '星图这次的引擎还没带上路径搜索——要等宿主重启后才有,记忆和连线都没受影响。'
247
+ }
248
+ if (kind === 'emptyGraph') {
249
+ // 图还空着(0.2.45):这句话本身就是结论——「这次没算」,不是「没关系」,
250
+ // 星图的原文已经写清了,原样转述。
251
+ return r2.text
252
+ }
253
+ return r2.text
254
+ }
255
+ // 这几个动作改的是星图自己,落不了盘也没法先记账;说清楚「记忆没受影响」比报内部错误有用
256
+ return `星图这次没接上,${verb}没做成——这一步改的是星图自己,等它就绪再试一次就行,记忆本身没受影响。`
257
+ }
@@ -0,0 +1,25 @@
1
+ import { TEXT_OUT } from '../shared.js'
2
+ import { cardTitle } from '../panel.js'
3
+
4
+ export function createProject({ flow }) {
5
+ return {
6
+ name: 'memory_project',
7
+ description: '看某个项目的全景记忆:overview/structure/decisions/quotes/ops/todo 分组全给(已完结的 todo 单独列)。',
8
+ parameters: {
9
+ type: 'object',
10
+ additionalProperties: false,
11
+ properties: {
12
+ project: { type: 'string', description: '项目名。' },
13
+ },
14
+ required: ['project'],
15
+ },
16
+ output: TEXT_OUT,
17
+ async execute(args, exec) {
18
+ const r = await flow.call('memory_project', { project: args.project }, exec)
19
+ return r.text
20
+ },
21
+ presentCall(args) {
22
+ return { card: 'generic', title: cardTitle('项目全景', args.project), kind: 'read' }
23
+ },
24
+ }
25
+ }
@@ -0,0 +1,145 @@
1
+ import { TEXT_OUT, countParam, neighborSection, neighborGapNote } from '../shared.js'
2
+ import { cardTitle } from '../panel.js'
3
+ // [macro-fusion 0.2.138] 读到一条退位的记忆时,把「该去读哪一条」一起给出来。
4
+ import { workspaceOfExec } from '../dreamledger.js'
5
+ import { successionNote } from '../chain.js'
6
+ // [macro-fusion 0.2.156] 谱系的另一半:这条从哪来、为什么在库里、还有没有人用过。
7
+ import { provenanceNote } from '../provenance.js'
8
+ // [macro-fusion 0.2.109] 读一条连带邻居,是单次调用里最容易超预算的一支;够大就报成本。
9
+ // [macro-fusion 0.2.112] 这一支也吃 budget:正文一个字都不截,只能砍邻居——砍到底还放不下就只给骨架。
10
+ import { readCostTail, budgetOf, estTokens, fmtTokens } from '../tokencost.js'
11
+
12
+ /** 骨架只留正文第一行的前这么多字:够认出是哪条,又不会把半截正文卖成全貌。 */
13
+ const SKELETON_HEAD = 120
14
+
15
+ /** 砍邻居的阶梯:先照 caller 要的条数给,再 6 / 3 / 1 / 0,最多实测三次(每次都真取一次)。 */
16
+ const NEIGHBOR_LADDER = [6, 3, 1, 0]
17
+ const LADDER_TRIES = 3
18
+
19
+ export function createRead({ flow, meowDir = () => '.dsh-meow' }) {
20
+ return {
21
+ name: 'memory_read',
22
+ description:
23
+ '读一条记忆的全文与元数据,并把星图里与它相连的记忆一起带出来(neighbors=0 可关掉邻域)。给 budget 就按预算收紧:只砍邻居,正文从不截断,砍到底还放不下就只给骨架。',
24
+ parameters: {
25
+ type: 'object',
26
+ additionalProperties: false,
27
+ properties: {
28
+ id: { type: 'string', description: '记忆 id。' },
29
+ neighbors: { type: 'integer', description: '带出多少条邻居,默认 12;0=不带。' },
30
+ budget: {
31
+ type: 'integer',
32
+ description: '这一读最多花多少 token(估算)。不给=不限额;给了就先砍邻居条数,正文不截断。',
33
+ },
34
+ },
35
+ required: ['id'],
36
+ },
37
+ output: TEXT_OUT,
38
+ async execute(args, exec) {
39
+ const main = await flow.call('memory_read', { id: args.id }, exec)
40
+ // [macro-fusion 0.2.52] 上游一个字都不给时,空字符串会被读成「这条记忆是空的」。
41
+ let said = String(main.text ?? '').trim()
42
+ if (said.length === 0) {
43
+ return '读取这次没有任何回执(既没有正文,也没说为什么没有)——这不是「这条记忆是空的」:先用 memory_search 或 memory_project 确认 id,再读一次。'
44
+ }
45
+ if (main.value?.found === false) return said
46
+ await flow.flushLinks(exec)
47
+ // [macro-fusion 0.2.138] 链上那两行并进正文:它属于「这条记忆现在是什么样」,
48
+ // 不是附加说明——预算按含链的长度算,砍邻居时也不会把它砍掉。
49
+ const chain = successionNote({
50
+ workspace: workspaceOfExec(exec),
51
+ dir: typeof meowDir === 'function' ? meowDir() : '.dsh-meow',
52
+ id: args.id,
53
+ })
54
+ // [macro-fusion 0.2.156] 来源一行同理并进正文:正文回答「它说了什么」,这一行回答
55
+ // 「凭什么信它、它从哪来」。同样按含它的长度算预算,砍邻居时不会被砍掉。
56
+ const prov = provenanceNote({
57
+ workspace: workspaceOfExec(exec),
58
+ dir: typeof meowDir === 'function' ? meowDir() : '.dsh-meow',
59
+ id: args.id,
60
+ })
61
+ const extras = [prov, chain].filter(Boolean).join('\n')
62
+ if (extras.length > 0) said = `${said}\n\n${extras}`
63
+ // [macro-fusion 0.2.62] 以前这里先把 neighbors 塞进 Number(),再拿「不是有限数、或者
64
+ // 小于等于 0」做一句提前返回:非数字、负数、你自己要 0 三种情况压成同一个结果——
65
+ // 没有邻居段。读的人只会得到「这条记忆没有邻居」这个错结论(DESIGN §72)。
66
+ const nb = countParam('neighbors', args.neighbors, { min: 0, max: 40, def: 12 })
67
+ const budget = budgetOf(args.budget)
68
+
69
+ /** 按条数真取一次邻居段;0 条不打扰星图(问它要 0 条本来也问不出东西)。 */
70
+ const withNeighbors = async (count) => {
71
+ if (count <= 0) return { text: said, section: '' }
72
+ const inspect = await flow.tryCall('nebula_inspect', { id: args.id, neighbors: count }, exec, '星图邻居')
73
+ const section = neighborSection(inspect.text)
74
+ // [macro-fusion 0.2.77] 没拿到邻居段时以前一声不吭(那句失败说明被拼掉的),
75
+ // 读者会把「没带到」读成「这条记忆没有邻居」。三种情况三种话,见 neighborGapNote。
76
+ const gap = neighborGapNote(section, inspect.def !== undefined, inspect.text)
77
+ return { text: [said, section, gap].filter(Boolean).join('\n\n'), section }
78
+ }
79
+
80
+ // 没给预算:老样子,够大就报成本(省 token 的工具自己也要能报账)。
81
+ // budget 给的「不是数字 / 太小」也走这条路——那种 note 必须带出来,不然等于悄悄忽略了他给的数。
82
+ if (budget.value === null) {
83
+ if (nb.value <= 0) return [said, nb.note, budget.note].filter(Boolean).join('\n\n')
84
+ const got = await withNeighbors(nb.value)
85
+ return readCostTail([got.text, nb.note, budget.note].filter(Boolean).join('\n\n'))
86
+ }
87
+
88
+ const bodyEst = estTokens(said)
89
+ // 正文是 caller 要的东西,一个字都不能裁:裁一半他会当全文用。装不下就只给骨架。
90
+ if (bodyEst > budget.value) {
91
+ return skeletonOf(said, { budget: budget.value, bodyEst, budgetNote: budget.note, nbNote: nb.note })
92
+ }
93
+
94
+ // 正文装得下:从 caller 要的条数往下试,第一次装下就停——每一档都是一次真取、一次实测。
95
+ const ladder = [nb.value, ...NEIGHBOR_LADDER]
96
+ .filter((n, i, arr) => n <= nb.value && arr.indexOf(n) === i)
97
+ .slice(0, LADDER_TRIES)
98
+ let picked = null
99
+ for (const count of ladder) {
100
+ const got = await withNeighbors(count)
101
+ const text = [got.text, nb.note].filter(Boolean).join('\n\n')
102
+ if (estTokens(text) <= budget.value) {
103
+ picked = { count, text, est: estTokens(text) }
104
+ break
105
+ }
106
+ }
107
+ // nb=0 时阶梯只有 [0],正文已经过了预算,所以这里只是兜底:绝不返回半截正文。
108
+ if (picked === null) picked = { count: 0, text: said, est: bodyEst }
109
+
110
+ const cutNote = picked.count === nb.value ? '' : `邻居 ${nb.value}→${picked.count} 条才装下`
111
+ const costNote = `≈${fmtTokens(picked.est)} token/预算 ${budget.value}`
112
+ const withTail = `${picked.text}\n\n(${costNote}${cutNote ? `;${cutNote}` : ',装下了'})`
113
+ // 砍了邻居就必须说(改过就要交代);没砍时这句账要装得进预算才加——
114
+ // 正文已经装下,别为一句说明把它挤出去。
115
+ if (cutNote) return withTail
116
+ return estTokens(withTail) <= budget.value ? withTail : picked.text
117
+ },
118
+ presentCall(args) {
119
+ return { card: 'generic', title: cardTitle('读取记忆', args.id), kind: 'read' }
120
+ },
121
+ }
122
+ }
123
+
124
+ /**
125
+ * [macro-fusion 0.2.112] 预算连正文都装不下时的形态:一行标题 + 一句为什么没给全文。
126
+ *
127
+ * 为什么不像别的工具那样「缩到最小再给」:读的正文就是 caller 要的东西,缩了等于给假货——
128
+ * 半截记忆会被当成完整记忆用,这比不给更坏。所以这里给的是**指路**:正文多长、缺口多少、
129
+ * 怎么看到全文(抬预算 / 先搜摘要)。
130
+ */
131
+ function skeletonOf(said, { budget, bodyEst, budgetNote, nbNote }) {
132
+ const first = said.split('\n').map((line) => line.trim()).find((line) => line.length > 0) ?? ''
133
+ const head = first.length > SKELETON_HEAD ? `${first.slice(0, SKELETON_HEAD)}…` : first
134
+ const over = estTokens(head) > budget
135
+ return [
136
+ head,
137
+ '',
138
+ `正文共 ${said.length} 字(≈${fmtTokens(bodyEst)} token),比你给的预算 ${budget} token 大——这次一个字都没裁给你:截一半你会把它当成全文。要看全文就把 budget 提到 ≥${bodyEst},或者先用 memory_search 看摘要挑一条。`,
139
+ over ? '连上面那一行标题都超过你给的预算了;但不写这句,你就会把骨架当成全文。' : '',
140
+ budgetNote,
141
+ nbNote,
142
+ ]
143
+ .filter(Boolean)
144
+ .join('\n')
145
+ }
@@ -0,0 +1,213 @@
1
+ import { LEVELS, PROJECT_SUBCATEGORIES, TEXT_OUT, pick } from '../shared.js'
2
+ import { LINKS_SCHEMA } from '../linkflow.js'
3
+ import { cardTitle } from '../panel.js'
4
+
5
+ // [macro-fusion 0.2.117] 取代关系:写新的同时,把被它顶掉的旧的标成 stale 并在正文留一句
6
+ // 「(已被取代:<新 id>「<新内容开头>」,<日期>)」。
7
+ //
8
+ // 为什么要有这个口子:dream 的冲突块从 0.2.114 起每轮都在说「取新的、旧的标『(已被取代:…)』或设
9
+ // stale」,但工具面里根本没有一步能同时做到——只能先 remember 再逐条 update,中间忘一步就变成两条并排
10
+ // 活着。主人对「遗忘」的态度也很明确:不删,只矫正。所以这里做的是**改写 + 降格**,不是删除:
11
+ // 旧条目仍在库里、仍可 memory_read、正文里指得到新的那条。
12
+ const SUPERSEDE_MAX = 5
13
+ const SUPERSEDE_MARK = '(已被取代:'
14
+ const SUPERSEDE_HEAD = 24
15
+
16
+ /** 把 caller 给的 supersedes 归一:去空、去重、限条数,并把「超出的条数」原样报回去(不许静默截断)。 */
17
+ function supersedeAskedOf(raw) {
18
+ if (raw === undefined || raw === null) return { ids: [], extra: [] }
19
+ const list = Array.isArray(raw) ? raw : [raw]
20
+ const asked = []
21
+ for (const one of list) {
22
+ if (typeof one !== 'string') continue
23
+ const id = one.trim()
24
+ if (id.length === 0) continue
25
+ if (!asked.includes(id)) asked.push(id)
26
+ }
27
+ return { ids: asked.slice(0, SUPERSEDE_MAX), extra: asked.slice(SUPERSEDE_MAX) }
28
+ }
29
+
30
+ function dayStamp(now = new Date()) {
31
+ const p = (n) => String(n).padStart(2, '0')
32
+ return `${now.getFullYear()}-${p(now.getMonth() + 1)}-${p(now.getDate())}`
33
+ }
34
+
35
+ /** 那半句取代话:只写「谁顶掉的、什么时候」,不写判决——正文归 caller,我们只加一句事实。 */
36
+ function supersedeLineOf({ newId, newHead, at }) {
37
+ const head = String(newHead ?? '').replace(/\s+/g, ' ').trim().slice(0, SUPERSEDE_HEAD)
38
+ const who = String(newId).slice(0, 8)
39
+ return `${SUPERSEDE_MARK}${who}${head ? `「${head}」` : ''},${dayStamp(at)})`
40
+ }
41
+
42
+ function shortId(id) {
43
+ return String(id ?? '').slice(0, 8)
44
+ }
45
+
46
+ // [macro-fusion 0.2.117] 短 id 的尴尬:meow 的 id 形如 `0mwowj2h2-<32 hex>`,前缀是时间编码——
47
+ // **同一秒里先后写下的两条,前 8 位会一模一样**。于是「拿刚记住的那条 id 前 8 位去取代它的前一条」
48
+ // 这个最自然的用法,恰好会把新条目自己也命中。memory_read 这时回 ambiguous,候选 id 就在它的
49
+ // candidates 文字里:把新条目排除掉之后如果只剩一条,那不是「替你挑」,是**排除法**。
50
+ const CANDIDATE_ID = /0m[0-9a-z]+-[0-9a-f]{32}/g
51
+
52
+ function candidateIdsOf(v) {
53
+ const out = []
54
+ for (const one of String(v?.candidates ?? '').match(CANDIDATE_ID) ?? []) if (!out.includes(one)) out.push(one)
55
+ return out
56
+ }
57
+
58
+ /** 歧义回执里到底命中几条:优先数候选 id,捞不到 id 时退回它自己那句「命中了 N 条」。 */
59
+ function ambiguousCountOf(v, ids) {
60
+ if (ids.length > 0) return ids.length
61
+ const m = /(\d+)\s*条/.exec(String(v?.note ?? ''))
62
+ return m ? Number(m[1]) : 0
63
+ }
64
+
65
+ /**
66
+ * 逐条把旧条目改写成「已被取代」。
67
+ *
68
+ * 每一种失败都必须单独说一句——尤其「没找到」和「没动它」:这两件事在回执里长得像是成功,
69
+ * 而它们恰恰是「旧条目还活着、还占着召回位」的那种状态。
70
+ */
71
+ async function markSuperseded({ flow, exec, ids, extra, newId, newHead }) {
72
+ const lines = []
73
+ for (const asked of ids) {
74
+ // 「这条是不是就是刚写的那条」不能靠字符串前缀先判——同一秒写下的两条 id 前 8 位一模一样,
75
+ // 先判就会把真正要处置的旧条目也当自己跳过(0.2.117 探针就是这么红的)。先读,读出来再判。
76
+ const got = await flow.tryCall('memory_read', { id: asked }, exec, '读被取代的旧条目')
77
+ let v = got.value
78
+ let via = ''
79
+ if (v && v.ambiguous === true) {
80
+ const ids = candidateIdsOf(v)
81
+ const others = ids.filter((one) => one !== newId)
82
+ const n = ambiguousCountOf(v, ids)
83
+ if (ids.length > 0 && others.length === 1) {
84
+ const again = await flow.tryCall('memory_read', { id: others[0] }, exec, '读被取代的旧条目')
85
+ if (again.value?.id === others[0]) {
86
+ v = again.value
87
+ via = `短 id ${asked} 先把刚写的 ${shortId(newId)} 也命中了(一共 ${n} 条),把它排除后只剩 ${shortId(others[0])}——按这条办的`
88
+ }
89
+ }
90
+ if (!via) {
91
+ lines.push(`- ${asked} 短 id 命中 ${n} 条,没替你挑一条——换成完整 id 再来一次,这 ${n} 条都还没动`)
92
+ continue
93
+ }
94
+ }
95
+ if (v && v.id === newId) {
96
+ lines.push(`- ${shortId(newId)} 就是这次刚写的那一条,跳过了(一条记忆不能取代自己)`)
97
+ continue
98
+ }
99
+ if (!v || v.found === false || !v.id) {
100
+ lines.push(`- ${asked} 没找到(可能已归档或删除)——它没有被改`)
101
+ continue
102
+ }
103
+ const id8 = shortId(v.id)
104
+ const status = String(v.status ?? 'active')
105
+ if (status === 'archived') {
106
+ lines.push(`- ${id8}(${String(v.level ?? '')})已经是 archived(作废),没动它`)
107
+ continue
108
+ }
109
+ const oldText = String(v.content ?? '')
110
+ if (oldText.includes(SUPERSEDE_MARK)) {
111
+ lines.push(`- ${id8}(${String(v.level ?? '')})正文里已经有一句「已被取代」,没重复追加`)
112
+ continue
113
+ }
114
+ const next = `${oldText}${oldText.endsWith('\n') || oldText.length === 0 ? '' : ' '}${supersedeLineOf({ newId, newHead, at: new Date() })}`
115
+ const patched = await flow.tryCall('memory_update', { id: v.id, content: next, status: 'stale' }, exec, '标为已被取代')
116
+ const ok = patched.value?.ok === true
117
+ if (!ok) {
118
+ const why = String(patched.text ?? '').trim()
119
+ lines.push(`- ${id8}(${String(v.level ?? '')})找到了但没写进库${why ? `:${why.split('\n')[0]}` : ''}——它还是原样,别当成已经处置`)
120
+ continue
121
+ }
122
+ lines.push(
123
+ status === 'stale'
124
+ ? `- ${id8}(${String(v.level ?? '')})本来就是 stale,只补了一句「已被取代」`
125
+ : `- ${id8}(${String(v.level ?? '')})已标 stale,正文末尾补了一句「已被取代」`,
126
+ )
127
+ // 是靠排除法认出来的时候,必须把「为什么是这条」写出来——否则回执读起来像我替你挑了一条。
128
+ if (via) lines.push(` · ${via}`)
129
+ }
130
+ const head = [`取代(新写的 ${shortId(newId)} 接管这些条目的位置;旧条目一条都没删,只是不再算「在用」):`]
131
+ const tail = []
132
+ if (extra.length > 0) {
133
+ tail.push(`超出 ${SUPERSEDE_MAX} 条上限的 ${extra.length} 条这次没有处理:${extra.join('、')}——要一起处置就分两次调。`)
134
+ }
135
+ tail.push('反悔办法:旧条目都还在库里,memory_update 把 status 改回 active、再删掉那句取代话就恢复原样。')
136
+ return [...head, ...lines, ...tail].join('\n')
137
+ }
138
+
139
+ export function createRemember({ flow }) {
140
+ return {
141
+ name: 'memory_remember',
142
+ description:
143
+ '把一条记忆写进宏记忆库(7 层 level + project 六子类)。与已有条目高度重复会自动合并;可用 links 顺手把关联固化进星图;被这次写入顶掉的旧条目用 supersedes 列出来,会标 stale 并在正文留下取代句(不删除)。',
144
+ parameters: {
145
+ type: 'object',
146
+ additionalProperties: false,
147
+ properties: {
148
+ content: { type: 'string', description: '要记住的内容。fact/lesson 一句话(≤60 字),topic ≤300 字;涉及用户原话必须保留措辞。' },
149
+ project: { type: 'string', description: "归属:'全局' 或项目名;同时属于多个项目用英文逗号分隔。" },
150
+ keywords: { type: 'array', items: { type: 'string' }, description: '8–13 个检索关键词,按「用户提到哪些词时该召回它」反向想。' },
151
+ importance: { type: 'integer', description: '4=红线致命 3=主人强调/全局适用 2=抽象决策 1=琐碎' },
152
+ level: { type: 'string', enum: LEVELS, description: '记忆层级,默认 fact。' },
153
+ subcategory: { type: 'string', enum: PROJECT_SUBCATEGORIES, description: 'level=project 专用子类。' },
154
+ goal: { type: 'string', description: 'topic 的目标句(这个窗口要把什么事做成)。' },
155
+ corrected: { type: 'boolean', description: '是否来自主人纠正(level=lesson 用)。' },
156
+ // [macro-fusion 0.2.87] 合并以前是「拿这次的参数把旧条目整条盖掉」:关键词被换掉、归属被搬走、
157
+ // 更短的内容把旧细节吃掉。现在合并只做加法(关键词并集 / 归属不动 / 变短默认不换),
158
+ // 这个开关是「我确实要压缩」的逃生口——不给这个口子,保护就变成了不能更新。
159
+ overwrite: {
160
+ type: 'boolean',
161
+ description: '合并时是否允许用这次的内容覆盖旧内容(默认 false)。默认只在「新内容更短且不是逐字同一句」时拒换;确实要压缩就传 true。',
162
+ },
163
+ // [macro-fusion 0.2.117] 取代不是删除:旧条目留着,只是降格成 stale 并在正文里指向新的那条。
164
+ supersedes: {
165
+ type: 'array',
166
+ items: { type: 'string' },
167
+ description: '这次写入顶掉的旧条目 id(最多 5 条,短 id 前 8 位也行)。被列出的条目会标 stale 并在正文末尾加一句「(已被取代:<新 id>「<新内容开头>」,<日期>)」——不删除、可 memory_read、可反悔。',
168
+ },
169
+ links: LINKS_SCHEMA,
170
+ },
171
+ required: ['content', 'project', 'keywords', 'importance'],
172
+ },
173
+ output: TEXT_OUT,
174
+ async execute(args, exec) {
175
+ const payload = pick(args, ['content', 'level', 'project', 'subcategory', 'goal', 'importance', 'corrected', 'keywords', 'overwrite'])
176
+ const main = await flow.call('memory_remember', payload, exec)
177
+ // [macro-fusion 0.2.50] 上游回执空掉时不能把「没写进去」当成功:这里先看一眼有没有字。
178
+ const said = String(main.text ?? '').trim()
179
+ const sup = supersedeAskedOf(args.supersedes)
180
+ if (said.length === 0) {
181
+ const skip =
182
+ sup.ids.length > 0 || sup.extra.length > 0
183
+ ? '\n\n取代这次一条都没做:新条目连 id 都没拿到,不能把旧的指向一个不存在的新条目。'
184
+ : ''
185
+ return `写入这次没有任何回执(既没说写进了哪一层,也没说为什么没写)——这不是「已经记住了」:先 memory_search 查一眼这条内容在不在库里,再决定要不要重试。${skip}`
186
+ }
187
+ const newId = main.value?.id
188
+ const out = [said]
189
+ if (sup.ids.length > 0 || sup.extra.length > 0) {
190
+ if (!newId) {
191
+ out.push('取代这次一条都没做:新条目没拿到 id(上游只回了文字),没有「新 id」可写进取代句。先用 memory_search 找到这条的新 id,再逐条 memory_update。')
192
+ } else {
193
+ out.push(
194
+ await markSuperseded({
195
+ flow,
196
+ exec,
197
+ ids: sup.ids,
198
+ extra: sup.extra,
199
+ newId,
200
+ newHead: typeof args.content === 'string' ? args.content : '',
201
+ }),
202
+ )
203
+ }
204
+ }
205
+ const linked = await flow.applyLinks(newId, args.links, exec, 'remember')
206
+ if (linked) out.push(linked)
207
+ return out.join('\n\n')
208
+ },
209
+ presentCall(args) {
210
+ return { card: 'generic', title: cardTitle('写入记忆', args.project), kind: 'write' }
211
+ },
212
+ }
213
+ }