@waq666/pneuma 0.0.0-stage → 0.7.1

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 (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,703 @@
1
+ /**
2
+ * 长期记忆存储:三格 Markdown 清单,写进磁盘,跨会话留下来。
3
+ *
4
+ * 布局(全部在 `~/.dsc/memory/` 下面):
5
+ * global/MEMORY.md 跨项目都成立的事实(2200 字上限)
6
+ * global/USER.md 用户本人的偏好与习惯(1375 字上限)
7
+ * workspaces/<键>/MEMORY.md 只属于这个仓库的事实(2200 字上限)
8
+ *
9
+ * 一格就是一个文件,里面用单独一行的 `§` 隔开条目。为什么不用 JSON:用户会直接用
10
+ * 编辑器改这些文件,纯文本改起来没有心智负担,模型也读得懂。
11
+ *
12
+ * 三条要紧的规矩(照 Hermes 的 `tools/memory_tool_store.py` 来,那套跑了很久):
13
+ * 1. 字数上限连分隔符一起算。超了就整次写入拒绝,并把当前条目回吐出去——不是悄悄截断。
14
+ * 截断会让模型以为写进去了,下次读出来又是另一份,越改越乱。
15
+ * 2. 一批 operations 要么全落盘要么全不落,额度只按最终状态算一次。
16
+ * 3. 磁盘上的文件被外面改过(不是我们上次写的那份)时,先把现状备份成
17
+ * `.bak.<秒级时间戳>` 再拒绝这次写入。用户的编辑永远优先,工具不许闷头盖。
18
+ *
19
+ * @module dsc/core/memory
20
+ */
21
+ import { createHash } from 'node:crypto';
22
+ import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
23
+ import { basename, dirname, join, resolve } from 'node:path';
24
+ import { dscPath } from './path-policy.js';
25
+ export const MEMORY_TARGETS = ['global', 'user', 'workspace'];
26
+ /** 分区中文名(错误信息与界面都用它,两处不会写岔)。 */
27
+ export const TARGET_LABELS = {
28
+ global: '全局事实',
29
+ user: '用户偏好',
30
+ workspace: '本工作区',
31
+ };
32
+ export const MEMORY_TYPES = ['fact', 'feedback', 'reference'];
33
+ /** 类型中文名(界面与错误信息共用)。 */
34
+ export const MEMORY_TYPE_LABELS = {
35
+ fact: '事实',
36
+ feedback: '反馈',
37
+ reference: '参考',
38
+ };
39
+ /** 条目开头的类型前缀;只认这三个已知词,`[BLOCKED: …]` 这类不会被误读成类型。 */
40
+ const ENTRY_TYPE_PREFIX = /^\[(fact|feedback|reference)\]\s*/i;
41
+ /** 读一条条目:拆出类型与正文(没有前缀 = `fact`)。 */
42
+ export function parseEntry(entry) {
43
+ const matched = ENTRY_TYPE_PREFIX.exec(entry);
44
+ if (matched === null)
45
+ return { type: 'fact', text: entry };
46
+ return { type: matched[1].toLowerCase(), text: entry.slice(matched[0].length) };
47
+ }
48
+ /** 一条条目的类型。 */
49
+ export function entryType(entry) {
50
+ return parseEntry(entry).type;
51
+ }
52
+ /** 一条条目的正文(去掉类型前缀)。 */
53
+ export function entryText(entry) {
54
+ return parseEntry(entry).text;
55
+ }
56
+ /** 把类型与正文拼成落盘形状:`fact` 不加前缀(老文件写法不变),其余加 `[类型] `。 */
57
+ export function formatEntry(type, text) {
58
+ const body = text.trim();
59
+ return type === 'fact' ? body : `[${type}] ${body}`;
60
+ }
61
+ /** 条目之间的分隔符:换行、`§`、换行。 */
62
+ export const ENTRY_DELIMITER = '\n§\n';
63
+ /** 各格的缺省字数上限(含分隔符),跟 Hermes 的默认值一致。 */
64
+ export const MEMORY_LIMIT_DEFAULTS = {
65
+ global: 2200,
66
+ user: 1375,
67
+ workspace: 2200,
68
+ };
69
+ export const DEFAULT_MEMORY_CONFIG = {
70
+ enabled: true,
71
+ userProfile: true,
72
+ workspace: true,
73
+ limits: { ...MEMORY_LIMIT_DEFAULTS },
74
+ writeApproval: false,
75
+ reviewEveryTurns: 10,
76
+ reviewEnabled: true,
77
+ pruneEnabled: true,
78
+ pruneAfterDays: 60,
79
+ maxIndexLines: 200,
80
+ maxIndexChars: 25_000,
81
+ };
82
+ /** 记忆目录根(`~/.dsc/memory`)。 */
83
+ export function memoryRoot() {
84
+ return dscPath('memory');
85
+ }
86
+ /** 把工作目录折成一个能当目录名的键:`D:\dsc` → `d-dsc`;过长的补一段哈希。 */
87
+ export function workspaceKey(cwd) {
88
+ const full = resolve(cwd);
89
+ const flat = full
90
+ .replace(/[:\\/_\s]+/g, '-')
91
+ .replace(/^-+|-+$/g, '')
92
+ .toLowerCase();
93
+ if (flat.length <= 48)
94
+ return flat === '' ? 'root' : flat;
95
+ return `${flat.slice(0, 48)}-${createHash('sha1').update(full.toLowerCase()).digest('hex').slice(0, 8)}`;
96
+ }
97
+ /** 某一格对应的文件路径。 */
98
+ export function memoryFileOf(target, cwd) {
99
+ if (target === 'user')
100
+ return join(memoryRoot(), 'global', 'USER.md');
101
+ if (target === 'global')
102
+ return join(memoryRoot(), 'global', 'MEMORY.md');
103
+ return join(memoryRoot(), 'workspaces', workspaceKey(cwd), 'MEMORY.md');
104
+ }
105
+ /** 把文件正文折成条目:按分隔符切、去空、去掉每条首尾空白。 */
106
+ export function splitEntries(text) {
107
+ return text
108
+ .split(/\n?§\n?/g)
109
+ .map((entry) => entry.trim())
110
+ .filter((entry) => entry !== '');
111
+ }
112
+ /** 把条目拼回文件正文(结尾留一个换行,编辑器里不难看)。 */
113
+ export function joinEntries(entries) {
114
+ if (entries.length === 0)
115
+ return '';
116
+ return entries.join(ENTRY_DELIMITER) + '\n';
117
+ }
118
+ /** 连分隔符一起算的字数。 */
119
+ export function usedChars(entries) {
120
+ if (entries.length === 0)
121
+ return 0;
122
+ return entries.reduce((sum, entry) => sum + entry.length, 0) + ENTRY_DELIMITER.length * (entries.length - 1);
123
+ }
124
+ /** 我们上次读过或写过的内容指纹,用来发现「外面改过了」。键是文件路径。 */
125
+ const lastKnown = new Map();
126
+ /** 文件不存在时的指纹,用来跟「存在但内容为空」区分开。 */
127
+ const MISSING = ' missing';
128
+ function fingerprint(text) {
129
+ return createHash('sha256').update(text).digest('hex');
130
+ }
131
+ /**
132
+ * 读一格。
133
+ *
134
+ * 外部改动在这里发现:磁盘指纹跟我们上次写进去(或上次读到)的不一样,就把现状复制一份
135
+ * 备份,并在 `problem` 里说清楚。本次读取照常返回,要不要写由于调用方决定。
136
+ *
137
+ * @param target - 哪一格。
138
+ * @param cwd - 当前会话的工作目录(决定 workspace 那一格)。
139
+ * @param limits - 各格上限(设置里可改)。
140
+ */
141
+ export function readCell(target, cwd, limits = MEMORY_LIMIT_DEFAULTS) {
142
+ const filePath = memoryFileOf(target, cwd);
143
+ const limit = Math.max(20, Math.floor(limits[target] ?? MEMORY_LIMIT_DEFAULTS[target]));
144
+ let text = '';
145
+ let missing = false;
146
+ try {
147
+ if (!existsSync(filePath))
148
+ missing = true;
149
+ else
150
+ text = readFileSync(filePath, 'utf8');
151
+ }
152
+ catch (error) {
153
+ return {
154
+ target,
155
+ filePath,
156
+ entries: [],
157
+ used: 0,
158
+ limit,
159
+ missing: true,
160
+ problem: `这份记忆文件读不出来:${error instanceof Error ? error.message : String(error)}`,
161
+ };
162
+ }
163
+ const disk = missing ? MISSING : fingerprint(text);
164
+ const known = lastKnown.get(filePath);
165
+ let problem = '';
166
+ if (known !== undefined && known !== disk) {
167
+ const backup = backupFile(filePath, text);
168
+ problem =
169
+ known === MISSING
170
+ ? `${TARGET_LABELS[target]}那格记忆文件被外面新建了${backup === '' ? '' : `,我们把它原样留了一份副本 ${backup}`},这一轮先只读不写`
171
+ : `${TARGET_LABELS[target]}那格记忆文件被外面改动过${backup === '' ? '' : `,改动后的内容留了一份副本 ${backup}`},这一轮先只读不写`;
172
+ // 外面这份内容我们现在认了:下一轮以它为基准,不然每次读都报一遍
173
+ lastKnown.set(filePath, disk);
174
+ }
175
+ else if (known === undefined) {
176
+ lastKnown.set(filePath, disk);
177
+ }
178
+ const entries = splitEntries(text);
179
+ return { target, filePath, entries, used: usedChars(entries), limit, missing, problem };
180
+ }
181
+ /** 读三格(快照与界面用)。`enabled` 决定哪几格参与。 */
182
+ export function readAllCells(cwd, limits = MEMORY_LIMIT_DEFAULTS, enabled = { global: true, user: true, workspace: true }) {
183
+ return MEMORY_TARGETS.filter((target) => enabled[target]).map((target) => readCell(target, cwd, limits));
184
+ }
185
+ /**
186
+ * 把磁盘现状复制一份,返回副本文件名。
187
+ *
188
+ * 只复制不搬走:用户正在编辑的那个文件必须留在原地,工具没有资格替他把文件挪掉。
189
+ *
190
+ * @param filePath - 要留副本的文件。
191
+ * @param text - 调用方已经读到的内容;文件读不出来时用它当副本内容。
192
+ */
193
+ function backupFile(filePath, text) {
194
+ const backup = `${filePath}.bak.${String(Math.floor(Date.now() / 1000))}`;
195
+ try {
196
+ mkdirSync(dirname(filePath), { recursive: true });
197
+ if (existsSync(filePath))
198
+ copyFileSync(filePath, backup);
199
+ else
200
+ writeFileSync(backup, text, 'utf8');
201
+ return basename(backup);
202
+ }
203
+ catch {
204
+ // 留不下副本也得继续往下走:副本是保险,不是这条规矩的全部
205
+ return '';
206
+ }
207
+ }
208
+ // ── 写入前的安检 ───────────────────────────────────────────────────────────────
209
+ /** 不可见字符(零宽空格、方向控制符、BOM 这类)。全用转义写:源码里不该出现看不见的内容。 */
210
+ const INVISIBLE = new RegExp('[\\u00AD\\u200B-\\u200F\\u2028\\u2029\\u2060-\\u2064\\uFEFF]', 'gu');
211
+ /**
212
+ * 写进长期记忆的内容,下次会话会被当成事实重新喂给模型,所以这里要拦的不是脏话,
213
+ * 而是「一条能让下一次的我去做不该做的事」的载体。对照 Hermes 的 `tools/threat_patterns.py`。
214
+ */
215
+ const THREAT_RULES = [
216
+ { label: '藏着不可见字符(零宽空格、方向控制符这类)', pattern: INVISIBLE },
217
+ {
218
+ label: '叫模型别把看到的东西告诉用户',
219
+ pattern: /(不要|别)(告诉|提醒|通知|提及)[^。\n]{0,8}(用户|使用者)|do\s+not\s+(?:tell|inform|mention)[\s,]+(?:the\s+)?user/iu,
220
+ },
221
+ {
222
+ label: '叫模型忽略它自己收到的指令',
223
+ pattern: /(忽略|无视|忘掉)[^。\n]{0,10}(指令|规则|约束|限制|系统提示)|ignore\s+(?:all\s+|the\s+)?(?:previous|prior|above|system)\s+(?:instruction|rule|prompt)/iu,
224
+ },
225
+ { label: '要批量删文件或整棵树', pattern: /rm\s+-[a-z]*rf|del\s+\/[sq]|Remove-Item[^\n]{0,40}-Recurse[^\n]{0,20}-Force/iu },
226
+ {
227
+ label: '把凭据往外送(命令行带着密钥变量往外发)',
228
+ pattern: /(curl|wget|Invoke-WebRequest)[^\n]{0,60}(?:-d\s+@|--data(?:-binary)?|-F\s)[^\n]{0,40}(KEY|TOKEN|SECRET|PASSWORD|凭据|密钥)/iu,
229
+ },
230
+ {
231
+ label: '把密钥原文记进了记忆(形如 sk-… 或 eyJ… 的长串)',
232
+ pattern: /\b(?:sk|pk|ghp|gho|xoxb|AKIA)[-_][A-Za-z0-9]{12,}\b|\beyJ[A-Za-z0-9_-]{20,}/u,
233
+ },
234
+ {
235
+ label: '要改掉记忆文件本身或这条安检',
236
+ pattern: /(?:MEMORY|USER)\.md[^。\n]{0,12}(编辑|改写|删|放开|改成|清空|覆盖|重置)|this\s+rule[s]?(?:\s+must|\s+may\s+not|\s+cannot)\s+be\s+(?:edited|removed)/iu,
237
+ },
238
+ { label: '冒充系统消息或新的系统提示', pattern: /new\s+system\s+prompt|\[SYSTEM\]|<\|?system\|?>|我是系统提示/iu },
239
+ { label: '一段编码后的载荷配着执行', pattern: /(base64|atob|fromCharCode)[^\n]{0,40}(?:eval|exec|spawn|powershell|bash)/iu },
240
+ ];
241
+ /**
242
+ * 一条记忆内容过不过安检。
243
+ *
244
+ * @param entry - 待写入(或待注入)的文本。
245
+ * @returns 拦下的原因;空串表示放行。
246
+ */
247
+ export function scanThreat(entry) {
248
+ // 先 NFKC 归一:全角、兼容字符换成一副正经面孔再想混进来,这里不给过
249
+ const normalized = entry.normalize('NFKC');
250
+ for (const rule of THREAT_RULES) {
251
+ rule.pattern.lastIndex = 0;
252
+ if (rule.pattern.test(normalized))
253
+ return rule.label;
254
+ }
255
+ return '';
256
+ }
257
+ /** 没过安检的条目在快照里的替身(只替不换磁盘)。 */
258
+ export function blockedEntryMarker(reason) {
259
+ return `[BLOCKED: 这条记忆没被注入,因为${reason}]`;
260
+ }
261
+ /** 合上的额度:各格至少留 20 字,免得 plugins.json 被手改成 1 字之后什么都写不进去。 */
262
+ function limitsOf(limits) {
263
+ const merged = { ...MEMORY_LIMIT_DEFAULTS, ...(limits ?? {}) };
264
+ for (const target of MEMORY_TARGETS)
265
+ merged[target] = Math.max(20, Math.floor(merged[target]));
266
+ return merged;
267
+ }
268
+ /** 把一批操作套在现有条目上得到最终状态;不对就带原因回来。 */
269
+ function planOperations(operations, cells, limits, options) {
270
+ const next = new Map();
271
+ for (const [target, cell] of cells)
272
+ next.set(target, [...cell.entries]);
273
+ const notes = [];
274
+ for (const op of operations) {
275
+ const cell = cells.get(op.target);
276
+ if (cell === undefined)
277
+ return { ok: false, error: `不认识的记忆分区:${String(op.target)}` };
278
+ if (options.addOnly === true && op.action !== 'add') {
279
+ return { ok: false, error: '自动复盘只能新增记忆,删和改要由用户或正常对话来做' };
280
+ }
281
+ const list = next.get(op.target) ?? [];
282
+ const content = (op.content ?? '').trim();
283
+ const oldText = (op.oldText ?? '').trim();
284
+ if (op.action === 'add') {
285
+ if (content === '')
286
+ return { ok: false, error: '新增记忆得给出内容' };
287
+ const reason = scanThreat(content);
288
+ if (reason !== '')
289
+ return { ok: false, error: `这条记忆没通过安检:${reason}` };
290
+ if (content.length > limits[op.target]) {
291
+ return {
292
+ ok: false,
293
+ error: `${TARGET_LABELS[op.target]}这一格总共只有 ${String(limits[op.target])} 字额度,这一条就占 ${String(content.length)} 字,先把它说短`,
294
+ };
295
+ }
296
+ const stored = formatEntry(op.type ?? 'fact', content);
297
+ if (list.includes(stored)) {
298
+ // 幂等:同一条内容重复记不报错,也不重复占额度
299
+ notes.push('这一条已经在了,没重复记');
300
+ continue;
301
+ }
302
+ list.push(stored);
303
+ notes.push('已记下');
304
+ continue;
305
+ }
306
+ if (oldText === '')
307
+ return { ok: false, error: `${op.action === 'replace' ? '替换' : '删除'}记忆要说清楚动的是哪一条(old_text)` };
308
+ const hits = list.filter((entry) => entry.includes(oldText));
309
+ if (hits.length === 0)
310
+ return { ok: false, error: `没有找到写着「${oldText.slice(0, 40)}」的记忆` };
311
+ if (hits.length > 1)
312
+ return { ok: false, error: `「${oldText.slice(0, 40)}」在 ${String(hits.length)} 条记忆里都出现了,说得更具体一点` };
313
+ const index = list.indexOf(hits[0]);
314
+ if (op.action === 'remove') {
315
+ list.splice(index, 1);
316
+ notes.push('已删掉');
317
+ continue;
318
+ }
319
+ if (content === '')
320
+ return { ok: false, error: '替换记忆得给出新内容' };
321
+ const reason = scanThreat(content);
322
+ if (reason !== '')
323
+ return { ok: false, error: `这条记忆没通过安检:${reason}` };
324
+ // 不填类型时沿用原条目的类型:改写正文不该顺手把「反馈」降级成「事实」。
325
+ list[index] = formatEntry(op.type ?? entryType(hits[0]), content);
326
+ notes.push('已改写');
327
+ }
328
+ for (const [target, list] of next) {
329
+ const before = cells.get(target);
330
+ if (before === undefined)
331
+ continue;
332
+ if (before.entries.length > 0 && list.length === 0) {
333
+ return { ok: false, error: `${TARGET_LABELS[target]}这一格不能一批清空,要清空请逐条删` };
334
+ }
335
+ const used = usedChars(list);
336
+ if (used > limits[target]) {
337
+ return {
338
+ ok: false,
339
+ error: `这样写完 ${TARGET_LABELS[target]}这一格要 ${String(used)} 字,超过 ${String(limits[target])} 字额度。先把旧条目合并或删掉几条,再来写`,
340
+ };
341
+ }
342
+ }
343
+ return { ok: true, notes, next };
344
+ }
345
+ /**
346
+ * 落一批记忆操作。
347
+ *
348
+ * 全成或全败:先算出最终状态,安检和额度都过了才动盘。任何一条不对,一个字节都不写,
349
+ * 并且把当前条目回吐出去——模型看到现状才会去合并,不然只能瞎猜。
350
+ *
351
+ * @param operations - 要执行的操作(只有一条也算一批)。
352
+ * @param cwd - 当前会话的工作目录。
353
+ * @param options - 上限与模式开关。
354
+ */
355
+ export function applyMemoryOperations(operations, cwd, options = {}) {
356
+ const limits = limitsOf(options.limits);
357
+ if (operations.length === 0)
358
+ return { ok: false, error: '没有要执行的记忆操作', notes: [], cells: [] };
359
+ const unknown = operations.find((op) => !MEMORY_TARGETS.includes(op.target));
360
+ if (unknown !== undefined) {
361
+ return { ok: false, error: `不认识的记忆分区「${String(unknown.target)}」,只有 memory、user、workspace 三格`, notes: [], cells: [] };
362
+ }
363
+ const targets = [...new Set(operations.map((op) => op.target))];
364
+ const cells = new Map();
365
+ for (const target of targets)
366
+ cells.set(target, readCell(target, cwd, limits));
367
+ const guardDrift = options.guardDrift !== false;
368
+ const problems = [...cells.values()].filter((cell) => cell.problem !== '').map((cell) => cell.problem);
369
+ if (guardDrift && problems.length > 0) {
370
+ return { ok: false, error: problems.join(';'), notes: [], cells: [...cells.values()] };
371
+ }
372
+ const planned = planOperations(operations, cells, limits, options);
373
+ if (!planned.ok)
374
+ return { ok: false, error: planned.error, notes: [], cells: [...cells.values()] };
375
+ try {
376
+ for (const [target, list] of planned.next) {
377
+ const cell = cells.get(target);
378
+ if (cell === undefined)
379
+ continue;
380
+ const text = joinEntries(list);
381
+ if (joinEntries(cell.entries) === text)
382
+ continue;
383
+ mkdirSync(dirname(cell.filePath), { recursive: true });
384
+ if (guardDrift) {
385
+ // 落盘之前再看一眼磁盘:读的时候没改,不代表写这一瞬也没改
386
+ const now = existsSync(cell.filePath) ? fingerprint(readFileSync(cell.filePath, 'utf8')) : MISSING;
387
+ if (now !== (lastKnown.get(cell.filePath) ?? MISSING)) {
388
+ const backup = backupFile(cell.filePath, text);
389
+ return {
390
+ ok: false,
391
+ error: `写之前发现这份文件又被外面改过了${backup === '' ? '' : `,现状留了副本 ${backup}`},这次没写`,
392
+ notes: [],
393
+ cells: targets.map((item) => readCell(item, cwd, limits)),
394
+ };
395
+ }
396
+ }
397
+ writeFileSync(cell.filePath, text, 'utf8');
398
+ lastKnown.set(cell.filePath, fingerprint(text));
399
+ }
400
+ }
401
+ catch (error) {
402
+ return { ok: false, error: `记忆没能写进磁盘:${error instanceof Error ? error.message : String(error)}`, notes: [], cells: [] };
403
+ }
404
+ return { ok: true, error: '', notes: planned.notes, cells: targets.map((target) => readCell(target, cwd, limits)) };
405
+ }
406
+ /** 逐条安检的分组:能注入的、只能换成 BLOCKED 标记的。 */
407
+ export function filterUnsafeEntries(entries) {
408
+ const safe = [];
409
+ const blocked = [];
410
+ for (const entry of entries) {
411
+ const reason = scanThreat(entry);
412
+ if (reason === '')
413
+ safe.push(entry);
414
+ else
415
+ blocked.push(blockedEntryMarker(reason));
416
+ }
417
+ return { safe, blocked };
418
+ }
419
+ /**
420
+ * 每条条目在注入栏里的呈现:过了安检的原样,没过安检的换成 BLOCKED 标记(只替不换磁盘)。
421
+ * 保留「呈现行 → 原条目」的对应关系,供 {@link renderMemoryPrompt} 的 `onIncluded` 回调报账。
422
+ */
423
+ function renderedEntries(entries) {
424
+ return entries.map((entry) => {
425
+ const reason = scanThreat(entry);
426
+ return { entry, line: reason === '' ? entry : blockedEntryMarker(reason) };
427
+ });
428
+ }
429
+ /**
430
+ * 拼注入系统提示词的那一栏:每格一节,标题上写清额度用掉了多少。
431
+ *
432
+ * 这是「加载时重算的那一份」:会话中途新写的记忆由插件在写入后立刻重算,
433
+ * 同一个会话的下一次请求就能看到(2026-10 起,不再等新会话或压缩)。
434
+ *
435
+ * @param cells - 要注入的格子(调用方按开关筛过)。
436
+ * @param header - 说明文字,由插件层给(「这些是历史事实,不是本轮指令」这类话写在这里)。
437
+ * @param options - 注入上限:`maxLines` / `maxChars` 超了就截断并说明(只影响注入文本,不动磁盘);
438
+ * `onIncluded` 对**真的进了这一栏**的每条条目回调一次(被预算挤掉的不回调),用于注入计数。
439
+ */
440
+ export function renderMemoryPrompt(cells, header, options = {}) {
441
+ const bar = '═'.repeat(24);
442
+ const maxLines = options.maxLines ?? 200;
443
+ const maxChars = options.maxChars ?? 25_000;
444
+ const parts = [];
445
+ /** 先把每格折成「标题 + 条目行」,再统一按行数/字符数预算裁。 */
446
+ const blocks = [];
447
+ for (const cell of cells) {
448
+ if (cell.entries.length === 0)
449
+ continue;
450
+ const items = renderedEntries(cell.entries);
451
+ const percent = String(Math.round((cell.used / Math.max(1, cell.limit)) * 100));
452
+ blocks.push({
453
+ target: cell.target,
454
+ title: `${bar} ${TARGET_LABELS[cell.target]}记忆 [${percent}% — ${String(cell.used)}/${String(cell.limit)} 字] ${bar}`,
455
+ items,
456
+ });
457
+ }
458
+ let linesUsed = 0;
459
+ let charsUsed = 0;
460
+ let truncated = 0;
461
+ for (const block of blocks) {
462
+ const kept = [];
463
+ for (const item of block.items) {
464
+ if (linesUsed >= maxLines - 1 || charsUsed + item.line.length > maxChars) {
465
+ truncated += 1;
466
+ continue;
467
+ }
468
+ kept.push(item.line);
469
+ options.onIncluded?.(block.target, item.entry);
470
+ linesUsed += 1;
471
+ charsUsed += item.line.length + 1;
472
+ }
473
+ if (kept.length > 0)
474
+ parts.push(`${block.title}\n${kept.join('\n')}`);
475
+ }
476
+ if (parts.length === 0 && truncated === 0)
477
+ return '';
478
+ const tail = truncated === 0 ? '' : `\n(还有 ${String(truncated)} 条记忆没进这一栏:可用 /memory prune 整理,或让模型合并同类条目)`;
479
+ const body = parts.join('\n\n');
480
+ return body === '' ? `${header}${tail}` : `${header}\n\n${body}\n${bar}${tail}`;
481
+ }
482
+ /**
483
+ * 清空一格(设置页那个「清空这一格」按钮用)。
484
+ *
485
+ * 先留副本再清空:这个按钮按下就是丢掉整格记忆,不给退路的话太像事故。
486
+ *
487
+ * @param target - 哪一格。
488
+ * @param cwd - 当前会话的工作目录。
489
+ * @param limits - 各格上限。
490
+ * @returns `backup` 是副本文件名,空串表示没留成(或本来就没内容)。
491
+ */
492
+ export function clearCell(target, cwd, limits) {
493
+ const cell = readCell(target, cwd, limitsOf(limits));
494
+ if (cell.problem !== '')
495
+ return { ok: false, error: cell.problem, backup: '' };
496
+ if (cell.entries.length === 0 || cell.missing)
497
+ return { ok: true, error: '', backup: '' };
498
+ const backup = backupFile(cell.filePath, joinEntries(cell.entries));
499
+ try {
500
+ writeFileSync(cell.filePath, '', 'utf8');
501
+ lastKnown.set(cell.filePath, fingerprint(''));
502
+ return { ok: true, error: '', backup };
503
+ }
504
+ catch (error) {
505
+ return { ok: false, error: error instanceof Error ? error.message : String(error), backup };
506
+ }
507
+ }
508
+ /** 条目在下拉清单里怎么显示:编号 + 类型(非事实才标)+ 开头一小截。 */
509
+ export function entryLabel(entry, index) {
510
+ const { type, text } = parseEntry(entry);
511
+ const tag = type === 'fact' ? '' : `[${MEMORY_TYPE_LABELS[type]}] `;
512
+ const head = `${tag}${text}`.replace(/\s+/g, ' ').slice(0, 46);
513
+ return `#${String(index + 1).padStart(2, '0')} ${head.length >= 46 ? `${head}…` : head}`;
514
+ }
515
+ /** 台账文件(与三格记忆同目录,点号文件不参与读取)。 */
516
+ export function usageFile() {
517
+ return join(memoryRoot(), '.usage.json');
518
+ }
519
+ /**
520
+ * 上一次评估的裸读数文件(与三格记忆同目录)。
521
+ *
522
+ * 存的是报表去掉 `lines` 之后的那份读数(形状见 `core/memory-eval.ts` 的
523
+ * `MemoryEvalReadings`),供下一次评估算增量(A-B 对比)。
524
+ */
525
+ export function evalFile() {
526
+ return join(memoryRoot(), '.eval.json');
527
+ }
528
+ /** 条目指纹:按「格子 + 正文」算,类型前缀变了也不丢使用记录。 */
529
+ export function entryUsageKey(target, entry) {
530
+ return createHash('sha1').update(`${target}\u0000${entryText(entry)}`).digest('hex').slice(0, 16);
531
+ }
532
+ /** 读台账(文件不在或读不出来就当空表,绝不因此挡住记忆本身)。 */
533
+ export function readUsage() {
534
+ try {
535
+ const file = usageFile();
536
+ if (!existsSync(file))
537
+ return {};
538
+ const parsed = JSON.parse(readFileSync(file, 'utf8'));
539
+ if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
540
+ return {};
541
+ const out = {};
542
+ for (const [key, value] of Object.entries(parsed)) {
543
+ if (value !== null && typeof value === 'object') {
544
+ const rec = value;
545
+ const count = Number(rec.count);
546
+ const last = Number(rec.last);
547
+ if (Number.isFinite(count) && Number.isFinite(last)) {
548
+ // injected 维是后加的:老记录缺它就记 0(向后兼容,不迁移文件)。
549
+ const injected = Number(rec.injected);
550
+ const lastInjected = Number(rec.lastInjected);
551
+ out[key] = {
552
+ count,
553
+ last,
554
+ injected: Number.isFinite(injected) ? injected : 0,
555
+ lastInjected: Number.isFinite(lastInjected) ? lastInjected : 0,
556
+ };
557
+ }
558
+ }
559
+ }
560
+ return out;
561
+ }
562
+ catch {
563
+ return {};
564
+ }
565
+ }
566
+ /** 落盘台账;写失败静默(台账落不下不该影响任何东西)。 */
567
+ function writeUsage(usage) {
568
+ try {
569
+ mkdirSync(memoryRoot(), { recursive: true });
570
+ writeFileSync(usageFile(), JSON.stringify(usage), 'utf8');
571
+ }
572
+ catch {
573
+ // 台账落不下不该影响任何东西:整理只是少了排序依据,记忆本身照旧
574
+ }
575
+ }
576
+ /** 记账(累加引用计数并刷新引用时刻)。返回写后的台账。 */
577
+ export function bumpUsage(keys, at = Date.now()) {
578
+ const usage = readUsage();
579
+ for (const key of keys) {
580
+ const current = usage[key];
581
+ // 只动引用维:注入维原样保留(重写整条时别把它抹掉)。
582
+ usage[key] = { count: (current?.count ?? 0) + 1, last: at, injected: current?.injected ?? 0, lastInjected: current?.lastInjected ?? 0 };
583
+ }
584
+ writeUsage(usage);
585
+ return usage;
586
+ }
587
+ /**
588
+ * 记一次注入(累加注入轮数并刷新注入时刻)。同一份账文件、同一把写盘路径。
589
+ *
590
+ * 与 {@link bumpUsage} 分开:注入不是引用。清理与排序只看引用维(对齐 codex——
591
+ * `usage_count` 只被 citation 推进),所以这里绝不碰 `count` / `last`。
592
+ */
593
+ export function bumpInjected(keys, at = Date.now()) {
594
+ const usage = readUsage();
595
+ for (const key of keys) {
596
+ const current = usage[key];
597
+ usage[key] = {
598
+ count: current?.count ?? 0,
599
+ last: current?.last ?? 0,
600
+ injected: (current?.injected ?? 0) + 1,
601
+ lastInjected: at,
602
+ };
603
+ }
604
+ writeUsage(usage);
605
+ return usage;
606
+ }
607
+ /** 读上一次的评估裸读数;文件不在或读不出来返回 null(下次就是首评,不给增量)。 */
608
+ export function readEval() {
609
+ try {
610
+ const file = evalFile();
611
+ if (!existsSync(file))
612
+ return null;
613
+ const parsed = JSON.parse(readFileSync(file, 'utf8'));
614
+ if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
615
+ return null;
616
+ return parsed;
617
+ }
618
+ catch {
619
+ return null;
620
+ }
621
+ }
622
+ /** 落本次评估的裸读数(供下次算增量);写失败静默,不许把宿主搞崩。 */
623
+ export function writeEval(readings) {
624
+ try {
625
+ mkdirSync(memoryRoot(), { recursive: true });
626
+ writeFileSync(evalFile(), JSON.stringify(readings), 'utf8');
627
+ }
628
+ catch {
629
+ // 评估是保养:读数落不下不该影响对话
630
+ }
631
+ }
632
+ // ── 保守整理(prune:只移进归档区,不删) ────────────────────────────────────────
633
+ /** 某一格的归档文件路径(与那一格同目录,`*.archive.md`)。 */
634
+ export function archiveFileOf(target, cwd) {
635
+ const file = memoryFileOf(target, cwd);
636
+ return file.endsWith('.md') ? `${file.slice(0, -3)}.archive.md` : `${file}.archive`;
637
+ }
638
+ /**
639
+ * 保守整理:把「从没被引用过、而且已经陈旧」的条目移进同目录的归档文件。
640
+ *
641
+ * 三条底线:
642
+ * 1. 只移不删——被移走的原样写进归档,用户随时能翻回来;
643
+ * 2. 不被任何安全闸门绕过——整理只搬已经过安检、本来就在盘上的条目,不引入新内容;
644
+ * 3. 文件被外面改过(`problem`)的格子整格跳过,绝不覆盖用户正在编辑的那份。
645
+ *
646
+ * @param cwd - 当前会话工作目录(决定 workspace 那一格)。
647
+ * @param limits - 各格上限。
648
+ * @param enabled - 哪几格参与。
649
+ * @param options - 陈旧阈值与台账(测试注入用)。
650
+ */
651
+ export function pruneCells(cwd, limits = MEMORY_LIMIT_DEFAULTS, enabled = { global: true, user: true, workspace: true }, options = {}) {
652
+ const now = options.now ?? Date.now();
653
+ const afterDays = Math.max(0, options.afterDays ?? 60);
654
+ const usage = options.usage ?? readUsage();
655
+ const moved = { global: [], user: [], workspace: [] };
656
+ const archivePaths = { global: '', user: '', workspace: '' };
657
+ const cells = readAllCells(cwd, limits, enabled);
658
+ for (const cell of cells) {
659
+ const target = cell.target;
660
+ if (cell.problem !== '' || cell.entries.length === 0)
661
+ continue;
662
+ // 没记录时用文件最后修改时刻兜底:老文件(我们没登记过的)才会被当成陈旧。
663
+ let fallback = 0;
664
+ try {
665
+ fallback = existsSync(cell.filePath) ? statSync(cell.filePath).mtimeMs : now;
666
+ }
667
+ catch {
668
+ fallback = now;
669
+ }
670
+ const stale = (entry) => {
671
+ const rec = usage[entryUsageKey(target, entry)];
672
+ if (rec !== undefined && rec.count > 0)
673
+ return false; // 被引用过:保留
674
+ const last = rec?.last ?? fallback;
675
+ return now - last >= afterDays * 24 * 60 * 60 * 1000;
676
+ };
677
+ const keep = cell.entries.filter((entry) => !stale(entry));
678
+ const gone = cell.entries.filter((entry) => stale(entry));
679
+ if (gone.length === 0)
680
+ continue;
681
+ const archive = archiveFileOf(target, cwd);
682
+ try {
683
+ mkdirSync(dirname(archive), { recursive: true });
684
+ const existing = existsSync(archive) ? splitEntries(readFileSync(archive, 'utf8')) : [];
685
+ writeFileSync(archive, joinEntries([...existing, ...gone]), 'utf8');
686
+ writeFileSync(cell.filePath, joinEntries(keep), 'utf8');
687
+ lastKnown.set(cell.filePath, fingerprint(joinEntries(keep)));
688
+ moved[target] = gone;
689
+ archivePaths[target] = archive;
690
+ }
691
+ catch {
692
+ // 单格移不动就跳过这一格,别的格照旧(整理是保养,不该变成事故)
693
+ }
694
+ }
695
+ return { moved, archivePaths, cells: readAllCells(cwd, limits, enabled) };
696
+ }
697
+ /** 磁盘现状(自检比对用)。 */
698
+ export function diskStateOf(target, cwd) {
699
+ const filePath = memoryFileOf(target, cwd);
700
+ if (!existsSync(filePath))
701
+ return { exists: false, size: 0 };
702
+ return { exists: true, size: statSync(filePath).size };
703
+ }