@waq666/pneuma 0.0.0-stage → 0.7.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 (687) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +144 -2
  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 +13 -0
  16. package/lib/app/App.js +1498 -0
  17. package/lib/app/ApprovalCard.d.ts +12 -0
  18. package/lib/app/ApprovalCard.js +76 -0
  19. package/lib/app/AskCard.d.ts +20 -0
  20. package/lib/app/AskCard.js +45 -0
  21. package/lib/app/ChatView.d.ts +32 -0
  22. package/lib/app/ChatView.js +198 -0
  23. package/lib/app/Composer.d.ts +50 -0
  24. package/lib/app/Composer.js +282 -0
  25. package/lib/app/DiffBlock.d.ts +6 -0
  26. package/lib/app/DiffBlock.js +37 -0
  27. package/lib/app/MarkdownView.d.ts +6 -0
  28. package/lib/app/MarkdownView.js +99 -0
  29. package/lib/app/ModelPicker.d.ts +7 -0
  30. package/lib/app/ModelPicker.js +18 -0
  31. package/lib/app/PlanReviewCard.d.ts +13 -0
  32. package/lib/app/PlanReviewCard.js +54 -0
  33. package/lib/app/PresetPicker.d.ts +11 -0
  34. package/lib/app/PresetPicker.js +19 -0
  35. package/lib/app/PreviewOverlay.d.ts +14 -0
  36. package/lib/app/PreviewOverlay.js +22 -0
  37. package/lib/app/SessionPicker.d.ts +43 -0
  38. package/lib/app/SessionPicker.js +56 -0
  39. package/lib/app/SettingsOverlay.d.ts +32 -0
  40. package/lib/app/SettingsOverlay.js +157 -0
  41. package/lib/app/SkillsPicker.d.ts +7 -0
  42. package/lib/app/SkillsPicker.js +19 -0
  43. package/lib/app/StatusBar.d.ts +22 -0
  44. package/lib/app/StatusBar.js +272 -0
  45. package/lib/app/TaskStrips.d.ts +13 -0
  46. package/lib/app/TaskStrips.js +40 -0
  47. package/lib/app/ToolCard.d.ts +5 -0
  48. package/lib/app/ToolCard.js +40 -0
  49. package/lib/app/TranscriptOverlay.d.ts +12 -0
  50. package/lib/app/TranscriptOverlay.js +17 -0
  51. package/lib/app/Welcome.d.ts +6 -0
  52. package/lib/app/Welcome.js +66 -0
  53. package/lib/app/attach.d.ts +16 -0
  54. package/lib/app/attach.js +58 -0
  55. package/lib/app/click.d.ts +27 -0
  56. package/lib/app/click.js +89 -0
  57. package/lib/app/clipboard-image.d.ts +11 -0
  58. package/lib/app/clipboard-image.js +66 -0
  59. package/lib/app/cursor.d.ts +4 -0
  60. package/lib/app/cursor.js +24 -0
  61. package/lib/app/hello.d.ts +11 -0
  62. package/lib/app/hello.js +8 -0
  63. package/lib/app/history-store.d.ts +4 -0
  64. package/lib/app/history-store.js +41 -0
  65. package/lib/app/image-blocks.d.ts +12 -0
  66. package/lib/app/image-blocks.js +125 -0
  67. package/lib/app/markdown.d.ts +54 -0
  68. package/lib/app/markdown.js +189 -0
  69. package/lib/app/settings-model.d.ts +69 -0
  70. package/lib/app/settings-model.js +114 -0
  71. package/lib/app/theme.d.ts +166 -0
  72. package/lib/app/theme.js +141 -0
  73. package/lib/boot.d.ts +1 -0
  74. package/lib/boot.js +34 -0
  75. package/lib/commands.d.ts +49 -0
  76. package/lib/commands.js +115 -0
  77. package/lib/contract.d.ts +1973 -0
  78. package/lib/contract.js +36 -0
  79. package/lib/core/agent-roles.d.ts +52 -0
  80. package/lib/core/agent-roles.js +274 -0
  81. package/lib/core/approval-floor.d.ts +183 -0
  82. package/lib/core/approval-floor.js +679 -0
  83. package/lib/core/approval.d.ts +42 -0
  84. package/lib/core/approval.js +8 -0
  85. package/lib/core/audit.d.ts +61 -0
  86. package/lib/core/audit.js +59 -0
  87. package/lib/core/boot-notices.d.ts +6 -0
  88. package/lib/core/boot-notices.js +61 -0
  89. package/lib/core/cdp/actions.d.ts +182 -0
  90. package/lib/core/cdp/actions.js +649 -0
  91. package/lib/core/cdp/launch.d.ts +192 -0
  92. package/lib/core/cdp/launch.js +491 -0
  93. package/lib/core/cdp/snapshot.d.ts +139 -0
  94. package/lib/core/cdp/snapshot.js +316 -0
  95. package/lib/core/cdp/transport.d.ts +160 -0
  96. package/lib/core/cdp/transport.js +359 -0
  97. package/lib/core/command-policy.d.ts +108 -0
  98. package/lib/core/command-policy.js +580 -0
  99. package/lib/core/commands-completion.d.ts +78 -0
  100. package/lib/core/commands-completion.js +167 -0
  101. package/lib/core/compact-anchors.d.ts +76 -0
  102. package/lib/core/compact-anchors.js +284 -0
  103. package/lib/core/compact.d.ts +110 -0
  104. package/lib/core/compact.js +210 -0
  105. package/lib/core/config-store.d.ts +38 -0
  106. package/lib/core/config-store.js +307 -0
  107. package/lib/core/config.d.ts +36 -0
  108. package/lib/core/config.js +124 -0
  109. package/lib/core/connection-test.d.ts +60 -0
  110. package/lib/core/connection-test.js +84 -0
  111. package/lib/core/desktop-control.d.ts +298 -0
  112. package/lib/core/desktop-control.js +1311 -0
  113. package/lib/core/diff-text.d.ts +74 -0
  114. package/lib/core/diff-text.js +257 -0
  115. package/lib/core/dock-browser.d.ts +137 -0
  116. package/lib/core/dock-browser.js +146 -0
  117. package/lib/core/dock-ops.d.ts +59 -0
  118. package/lib/core/dock-ops.js +104 -0
  119. package/lib/core/dock-session.d.ts +39 -0
  120. package/lib/core/dock-session.js +28 -0
  121. package/lib/core/dsh-compat/hook.d.ts +18 -0
  122. package/lib/core/dsh-compat/hook.js +52 -0
  123. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  124. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  125. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  126. package/lib/core/dsh-compat/tools-facade.js +108 -0
  127. package/lib/core/err-text.d.ts +13 -0
  128. package/lib/core/err-text.js +15 -0
  129. package/lib/core/events.d.ts +149 -0
  130. package/lib/core/events.js +1 -0
  131. package/lib/core/git-exec.d.ts +23 -0
  132. package/lib/core/git-exec.js +72 -0
  133. package/lib/core/git-info.d.ts +47 -0
  134. package/lib/core/git-info.js +157 -0
  135. package/lib/core/goal.d.ts +89 -0
  136. package/lib/core/goal.js +189 -0
  137. package/lib/core/hooks.d.ts +272 -0
  138. package/lib/core/hooks.js +818 -0
  139. package/lib/core/host-browser-link.d.ts +59 -0
  140. package/lib/core/host-browser-link.js +9 -0
  141. package/lib/core/host-methods.d.ts +25 -0
  142. package/lib/core/host-methods.js +103 -0
  143. package/lib/core/image-diet.d.ts +77 -0
  144. package/lib/core/image-diet.js +127 -0
  145. package/lib/core/learnings/ledger.d.ts +73 -0
  146. package/lib/core/learnings/ledger.js +273 -0
  147. package/lib/core/learnings/skill-write.d.ts +250 -0
  148. package/lib/core/learnings/skill-write.js +854 -0
  149. package/lib/core/learnings/store.d.ts +102 -0
  150. package/lib/core/learnings/store.js +266 -0
  151. package/lib/core/lifecycle-hooks.d.ts +189 -0
  152. package/lib/core/lifecycle-hooks.js +576 -0
  153. package/lib/core/llm.d.ts +272 -0
  154. package/lib/core/llm.js +548 -0
  155. package/lib/core/lockfile.d.ts +17 -0
  156. package/lib/core/lockfile.js +110 -0
  157. package/lib/core/loop.d.ts +185 -0
  158. package/lib/core/loop.js +587 -0
  159. package/lib/core/lsp/client.d.ts +189 -0
  160. package/lib/core/lsp/client.js +690 -0
  161. package/lib/core/lsp/framing.d.ts +84 -0
  162. package/lib/core/lsp/framing.js +181 -0
  163. package/lib/core/lsp/line-shift.d.ts +28 -0
  164. package/lib/core/lsp/line-shift.js +127 -0
  165. package/lib/core/lsp/manager.d.ts +93 -0
  166. package/lib/core/lsp/manager.js +418 -0
  167. package/lib/core/lsp/normalize.d.ts +32 -0
  168. package/lib/core/lsp/normalize.js +139 -0
  169. package/lib/core/lsp/servers.d.ts +106 -0
  170. package/lib/core/lsp/servers.js +352 -0
  171. package/lib/core/lsp/uri.d.ts +76 -0
  172. package/lib/core/lsp/uri.js +179 -0
  173. package/lib/core/market.d.ts +51 -0
  174. package/lib/core/market.js +358 -0
  175. package/lib/core/mcp.d.ts +201 -0
  176. package/lib/core/mcp.js +836 -0
  177. package/lib/core/memory-eval.d.ts +158 -0
  178. package/lib/core/memory-eval.js +215 -0
  179. package/lib/core/memory.d.ts +266 -0
  180. package/lib/core/memory.js +703 -0
  181. package/lib/core/mention.d.ts +57 -0
  182. package/lib/core/mention.js +129 -0
  183. package/lib/core/microcompact.d.ts +48 -0
  184. package/lib/core/microcompact.js +79 -0
  185. package/lib/core/migrate.d.ts +56 -0
  186. package/lib/core/migrate.js +134 -0
  187. package/lib/core/model-caps.d.ts +83 -0
  188. package/lib/core/model-caps.js +150 -0
  189. package/lib/core/model-discovery.d.ts +19 -0
  190. package/lib/core/model-discovery.js +69 -0
  191. package/lib/core/modes.d.ts +72 -0
  192. package/lib/core/modes.js +152 -0
  193. package/lib/core/native-bridge.d.ts +135 -0
  194. package/lib/core/native-bridge.js +563 -0
  195. package/lib/core/path-policy.d.ts +32 -0
  196. package/lib/core/path-policy.js +248 -0
  197. package/lib/core/permission-presets.d.ts +67 -0
  198. package/lib/core/permission-presets.js +75 -0
  199. package/lib/core/plugin-loader.d.ts +36 -0
  200. package/lib/core/plugin-loader.js +294 -0
  201. package/lib/core/plugin-registry.d.ts +113 -0
  202. package/lib/core/plugin-registry.js +256 -0
  203. package/lib/core/prefs.d.ts +82 -0
  204. package/lib/core/prefs.js +372 -0
  205. package/lib/core/presets.d.ts +80 -0
  206. package/lib/core/presets.js +373 -0
  207. package/lib/core/pricing.d.ts +90 -0
  208. package/lib/core/pricing.js +126 -0
  209. package/lib/core/prompt.d.ts +92 -0
  210. package/lib/core/prompt.js +339 -0
  211. package/lib/core/ptc.d.ts +66 -0
  212. package/lib/core/ptc.js +70 -0
  213. package/lib/core/remote/frames.d.ts +91 -0
  214. package/lib/core/remote/frames.js +174 -0
  215. package/lib/core/remote/notify.d.ts +54 -0
  216. package/lib/core/remote/notify.js +77 -0
  217. package/lib/core/remote/owner.d.ts +32 -0
  218. package/lib/core/remote/owner.js +75 -0
  219. package/lib/core/remote/pairing.d.ts +104 -0
  220. package/lib/core/remote/pairing.js +261 -0
  221. package/lib/core/remote/push.d.ts +80 -0
  222. package/lib/core/remote/push.js +222 -0
  223. package/lib/core/remote/store.d.ts +18 -0
  224. package/lib/core/remote/store.js +59 -0
  225. package/lib/core/remote/tickets.d.ts +20 -0
  226. package/lib/core/remote/tickets.js +49 -0
  227. package/lib/core/remote/uploads.d.ts +63 -0
  228. package/lib/core/remote/uploads.js +161 -0
  229. package/lib/core/request-attribution.d.ts +26 -0
  230. package/lib/core/request-attribution.js +86 -0
  231. package/lib/core/request-invariant.d.ts +61 -0
  232. package/lib/core/request-invariant.js +199 -0
  233. package/lib/core/sandbox/backends.d.ts +64 -0
  234. package/lib/core/sandbox/backends.js +194 -0
  235. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  236. package/lib/core/sandbox/execpolicy.js +452 -0
  237. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  238. package/lib/core/sandbox/net-proxy.js +162 -0
  239. package/lib/core/sandbox/policy.d.ts +211 -0
  240. package/lib/core/sandbox/policy.js +559 -0
  241. package/lib/core/sandbox/win/abi.d.ts +161 -0
  242. package/lib/core/sandbox/win/abi.js +169 -0
  243. package/lib/core/sandbox/win/account.d.ts +71 -0
  244. package/lib/core/sandbox/win/account.js +206 -0
  245. package/lib/core/sandbox/win/acl.d.ts +54 -0
  246. package/lib/core/sandbox/win/acl.js +339 -0
  247. package/lib/core/sandbox/win/backend.d.ts +61 -0
  248. package/lib/core/sandbox/win/backend.js +249 -0
  249. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  250. package/lib/core/sandbox/win/doctor.js +272 -0
  251. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  252. package/lib/core/sandbox/win/ffi.js +166 -0
  253. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  254. package/lib/core/sandbox/win/net-abi.js +316 -0
  255. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  256. package/lib/core/sandbox/win/runner-entry.js +391 -0
  257. package/lib/core/sandbox/win/setup.d.ts +60 -0
  258. package/lib/core/sandbox/win/setup.js +986 -0
  259. package/lib/core/sandbox/win/token.d.ts +35 -0
  260. package/lib/core/sandbox/win/token.js +238 -0
  261. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  262. package/lib/core/sandbox/win/wfp.js +200 -0
  263. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  264. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  265. package/lib/core/schedule/rule.d.ts +184 -0
  266. package/lib/core/schedule/rule.js +745 -0
  267. package/lib/core/schedule/runner.d.ts +185 -0
  268. package/lib/core/schedule/runner.js +678 -0
  269. package/lib/core/schedule/store.d.ts +182 -0
  270. package/lib/core/schedule/store.js +455 -0
  271. package/lib/core/secrets.d.ts +41 -0
  272. package/lib/core/secrets.js +150 -0
  273. package/lib/core/session-export.d.ts +18 -0
  274. package/lib/core/session-export.js +73 -0
  275. package/lib/core/session-index.d.ts +159 -0
  276. package/lib/core/session-index.js +683 -0
  277. package/lib/core/session-meta.d.ts +41 -0
  278. package/lib/core/session-meta.js +97 -0
  279. package/lib/core/session.d.ts +356 -0
  280. package/lib/core/session.js +998 -0
  281. package/lib/core/skills.d.ts +60 -0
  282. package/lib/core/skills.js +171 -0
  283. package/lib/core/spill.d.ts +159 -0
  284. package/lib/core/spill.js +329 -0
  285. package/lib/core/surface-registry.d.ts +45 -0
  286. package/lib/core/surface-registry.js +67 -0
  287. package/lib/core/team-board.d.ts +95 -0
  288. package/lib/core/team-board.js +316 -0
  289. package/lib/core/throughput.d.ts +46 -0
  290. package/lib/core/throughput.js +40 -0
  291. package/lib/core/todo-reminder.d.ts +44 -0
  292. package/lib/core/todo-reminder.js +55 -0
  293. package/lib/core/todo.d.ts +81 -0
  294. package/lib/core/todo.js +222 -0
  295. package/lib/core/token-estimate.d.ts +55 -0
  296. package/lib/core/token-estimate.js +82 -0
  297. package/lib/core/tool-guards.d.ts +103 -0
  298. package/lib/core/tool-guards.js +77 -0
  299. package/lib/core/tool-search.d.ts +152 -0
  300. package/lib/core/tool-search.js +311 -0
  301. package/lib/core/tools/bash.d.ts +281 -0
  302. package/lib/core/tools/bash.js +871 -0
  303. package/lib/core/tools/command-runner.d.ts +84 -0
  304. package/lib/core/tools/command-runner.js +68 -0
  305. package/lib/core/tools/fs-tools.d.ts +23 -0
  306. package/lib/core/tools/fs-tools.js +247 -0
  307. package/lib/core/tools/index.d.ts +8 -0
  308. package/lib/core/tools/index.js +4 -0
  309. package/lib/core/tools/sandbox-args.d.ts +51 -0
  310. package/lib/core/tools/sandbox-args.js +90 -0
  311. package/lib/core/tools/search-tools.d.ts +3 -0
  312. package/lib/core/tools/search-tools.js +153 -0
  313. package/lib/core/tools.d.ts +96 -0
  314. package/lib/core/tools.js +53 -0
  315. package/lib/core/ui-boot-source.d.ts +71 -0
  316. package/lib/core/ui-boot-source.js +121 -0
  317. package/lib/core/ui-bundles.d.ts +249 -0
  318. package/lib/core/ui-bundles.js +830 -0
  319. package/lib/core/ui-combo.d.ts +49 -0
  320. package/lib/core/ui-combo.js +55 -0
  321. package/lib/core/ui-events.d.ts +81 -0
  322. package/lib/core/ui-events.js +364 -0
  323. package/lib/core/ui-hmr.d.ts +36 -0
  324. package/lib/core/ui-hmr.js +128 -0
  325. package/lib/core/ui-methods.d.ts +69 -0
  326. package/lib/core/ui-methods.js +341 -0
  327. package/lib/core/ui-route.d.ts +69 -0
  328. package/lib/core/ui-route.js +122 -0
  329. package/lib/core/ui-server.d.ts +75 -0
  330. package/lib/core/ui-server.js +369 -0
  331. package/lib/core/ui-trust.d.ts +47 -0
  332. package/lib/core/ui-trust.js +164 -0
  333. package/lib/core/untrusted.d.ts +30 -0
  334. package/lib/core/untrusted.js +48 -0
  335. package/lib/core/update-check.d.ts +81 -0
  336. package/lib/core/update-check.js +177 -0
  337. package/lib/core/usage-log.d.ts +82 -0
  338. package/lib/core/usage-log.js +306 -0
  339. package/lib/core/version.d.ts +1 -0
  340. package/lib/core/version.js +37 -0
  341. package/lib/core/web-http.d.ts +57 -0
  342. package/lib/core/web-http.js +137 -0
  343. package/lib/core/web-static.d.ts +31 -0
  344. package/lib/core/web-static.js +75 -0
  345. package/lib/headless.d.ts +1 -0
  346. package/lib/headless.js +31 -0
  347. package/lib/host/kernel.d.ts +33 -0
  348. package/lib/host/kernel.js +451 -0
  349. package/lib/index.d.ts +41 -0
  350. package/lib/index.js +35 -0
  351. package/lib/plugins/agent.d.ts +2 -0
  352. package/lib/plugins/agent.js +274 -0
  353. package/lib/plugins/approval-floor.d.ts +2 -0
  354. package/lib/plugins/approval-floor.js +223 -0
  355. package/lib/plugins/approval.d.ts +16 -0
  356. package/lib/plugins/approval.js +674 -0
  357. package/lib/plugins/ask.d.ts +2 -0
  358. package/lib/plugins/ask.js +245 -0
  359. package/lib/plugins/browser.d.ts +68 -0
  360. package/lib/plugins/browser.js +1341 -0
  361. package/lib/plugins/commands.d.ts +23 -0
  362. package/lib/plugins/commands.js +498 -0
  363. package/lib/plugins/compact.d.ts +21 -0
  364. package/lib/plugins/compact.js +274 -0
  365. package/lib/plugins/computer-use.d.ts +47 -0
  366. package/lib/plugins/computer-use.js +539 -0
  367. package/lib/plugins/desktop-dock.d.ts +2 -0
  368. package/lib/plugins/desktop-dock.js +626 -0
  369. package/lib/plugins/dock-browser.d.ts +34 -0
  370. package/lib/plugins/dock-browser.js +765 -0
  371. package/lib/plugins/dsh-compat.d.ts +25 -0
  372. package/lib/plugins/dsh-compat.js +37 -0
  373. package/lib/plugins/file-review.d.ts +108 -0
  374. package/lib/plugins/file-review.js +393 -0
  375. package/lib/plugins/git.d.ts +26 -0
  376. package/lib/plugins/git.js +132 -0
  377. package/lib/plugins/goal.d.ts +20 -0
  378. package/lib/plugins/goal.js +245 -0
  379. package/lib/plugins/guards.d.ts +14 -0
  380. package/lib/plugins/guards.js +18 -0
  381. package/lib/plugins/hooks.d.ts +19 -0
  382. package/lib/plugins/hooks.js +583 -0
  383. package/lib/plugins/host-stdio.d.ts +88 -0
  384. package/lib/plugins/host-stdio.js +317 -0
  385. package/lib/plugins/image-diet.d.ts +17 -0
  386. package/lib/plugins/image-diet.js +85 -0
  387. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  388. package/lib/plugins/lifecycle-hooks.js +338 -0
  389. package/lib/plugins/llm.d.ts +13 -0
  390. package/lib/plugins/llm.js +215 -0
  391. package/lib/plugins/lsp.d.ts +54 -0
  392. package/lib/plugins/lsp.js +608 -0
  393. package/lib/plugins/mcp.d.ts +16 -0
  394. package/lib/plugins/mcp.js +673 -0
  395. package/lib/plugins/memory.d.ts +17 -0
  396. package/lib/plugins/memory.js +858 -0
  397. package/lib/plugins/microcompact.d.ts +18 -0
  398. package/lib/plugins/microcompact.js +119 -0
  399. package/lib/plugins/mode.d.ts +18 -0
  400. package/lib/plugins/mode.js +115 -0
  401. package/lib/plugins/permission-presets.d.ts +18 -0
  402. package/lib/plugins/permission-presets.js +135 -0
  403. package/lib/plugins/plan.d.ts +2 -0
  404. package/lib/plugins/plan.js +192 -0
  405. package/lib/plugins/plugin-manager.d.ts +2 -0
  406. package/lib/plugins/plugin-manager.js +165 -0
  407. package/lib/plugins/presets.d.ts +2 -0
  408. package/lib/plugins/presets.js +182 -0
  409. package/lib/plugins/prompt.d.ts +2 -0
  410. package/lib/plugins/prompt.js +264 -0
  411. package/lib/plugins/ptc.d.ts +2 -0
  412. package/lib/plugins/ptc.js +272 -0
  413. package/lib/plugins/remote/http.d.ts +11 -0
  414. package/lib/plugins/remote/http.js +11 -0
  415. package/lib/plugins/remote/routes.d.ts +24 -0
  416. package/lib/plugins/remote/routes.js +384 -0
  417. package/lib/plugins/remote/types.d.ts +135 -0
  418. package/lib/plugins/remote/types.js +87 -0
  419. package/lib/plugins/remote.d.ts +17 -0
  420. package/lib/plugins/remote.js +1028 -0
  421. package/lib/plugins/runtime-api.d.ts +16 -0
  422. package/lib/plugins/runtime-api.js +99 -0
  423. package/lib/plugins/runtime.d.ts +10 -0
  424. package/lib/plugins/runtime.js +451 -0
  425. package/lib/plugins/sandbox.d.ts +2 -0
  426. package/lib/plugins/sandbox.js +761 -0
  427. package/lib/plugins/schedule.d.ts +26 -0
  428. package/lib/plugins/schedule.js +538 -0
  429. package/lib/plugins/self-improve.d.ts +61 -0
  430. package/lib/plugins/self-improve.js +953 -0
  431. package/lib/plugins/session-search.d.ts +16 -0
  432. package/lib/plugins/session-search.js +308 -0
  433. package/lib/plugins/session-title.d.ts +19 -0
  434. package/lib/plugins/session-title.js +109 -0
  435. package/lib/plugins/session.d.ts +7 -0
  436. package/lib/plugins/session.js +296 -0
  437. package/lib/plugins/settings.d.ts +3 -0
  438. package/lib/plugins/settings.js +705 -0
  439. package/lib/plugins/skills.d.ts +2 -0
  440. package/lib/plugins/skills.js +360 -0
  441. package/lib/plugins/spill.d.ts +16 -0
  442. package/lib/plugins/spill.js +200 -0
  443. package/lib/plugins/subagent.d.ts +2 -0
  444. package/lib/plugins/subagent.js +862 -0
  445. package/lib/plugins/surfaces.d.ts +11 -0
  446. package/lib/plugins/surfaces.js +20 -0
  447. package/lib/plugins/team.d.ts +16 -0
  448. package/lib/plugins/team.js +149 -0
  449. package/lib/plugins/todo.d.ts +19 -0
  450. package/lib/plugins/todo.js +188 -0
  451. package/lib/plugins/tool-search.d.ts +2 -0
  452. package/lib/plugins/tool-search.js +425 -0
  453. package/lib/plugins/tools-default.d.ts +12 -0
  454. package/lib/plugins/tools-default.js +275 -0
  455. package/lib/plugins/tools.d.ts +16 -0
  456. package/lib/plugins/tools.js +62 -0
  457. package/lib/plugins/transcript.d.ts +15 -0
  458. package/lib/plugins/transcript.js +311 -0
  459. package/lib/plugins/tui.d.ts +2 -0
  460. package/lib/plugins/tui.js +98 -0
  461. package/lib/plugins/waiting.d.ts +12 -0
  462. package/lib/plugins/waiting.js +34 -0
  463. package/lib/plugins/web-search.d.ts +14 -0
  464. package/lib/plugins/web-search.js +263 -0
  465. package/lib/plugins/webserver.d.ts +48 -0
  466. package/lib/plugins/webserver.js +228 -0
  467. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  468. package/lib/remote/assets/icon-192.png +0 -0
  469. package/lib/remote/assets/icon-512.png +0 -0
  470. package/lib/remote/assets/index.html +34 -0
  471. package/lib/remote/assets/manifest.json +27 -0
  472. package/lib/remote/assets/style-DIB6729x.css +1 -0
  473. package/lib/remote/assets/sw.js +66 -0
  474. package/lib/services/types.d.ts +1228 -0
  475. package/lib/services/types.js +1 -0
  476. package/lib/tools/config-cli.d.ts +1 -0
  477. package/lib/tools/config-cli.js +89 -0
  478. package/lib/ui/arrival.d.ts +72 -0
  479. package/lib/ui/arrival.js +105 -0
  480. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  481. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  482. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  483. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  484. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  485. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  486. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  487. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  488. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  489. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  490. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  491. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  492. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  493. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  494. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  495. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  496. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  497. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  498. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  499. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  500. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  501. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  502. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  503. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  504. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  505. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  506. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  507. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  508. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  509. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  510. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  511. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  512. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  513. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  514. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  515. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  516. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  517. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  518. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  519. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  520. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  521. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  522. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  523. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  524. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  525. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  526. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  527. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  528. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  529. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  530. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  531. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  532. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  533. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  534. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  535. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  536. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  537. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  538. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  539. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  540. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  541. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  542. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  543. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  544. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  545. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  546. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  547. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  548. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  549. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  550. package/lib/ui/assets/icon.png +0 -0
  551. package/lib/ui/assets/index.html +14 -0
  552. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  553. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  554. package/lib/ui/frames.d.ts +67 -0
  555. package/lib/ui/frames.js +146 -0
  556. package/lib/ui/index.d.ts +59 -0
  557. package/lib/ui/index.js +50 -0
  558. package/lib/ui/manifest.d.ts +172 -0
  559. package/lib/ui/manifest.js +158 -0
  560. package/lib/ui/plugin.d.ts +161 -0
  561. package/lib/ui/plugin.js +7 -0
  562. package/lib/ui/plugins/browser/client.js +290 -0
  563. package/lib/ui/plugins/browser/icon.png +0 -0
  564. package/lib/ui/plugins/composer/client.js +1843 -0
  565. package/lib/ui/plugins/composer/icon.png +0 -0
  566. package/lib/ui/plugins/files/client.js +646 -0
  567. package/lib/ui/plugins/files/icon.png +0 -0
  568. package/lib/ui/plugins/manifest.json +107 -0
  569. package/lib/ui/plugins/plugins/client.js +682 -0
  570. package/lib/ui/plugins/plugins/icon.png +0 -0
  571. package/lib/ui/plugins/preview/client.js +197 -0
  572. package/lib/ui/plugins/preview/icon.png +0 -0
  573. package/lib/ui/plugins/prompt/client.js +653 -0
  574. package/lib/ui/plugins/prompt/icon.png +0 -0
  575. package/lib/ui/plugins/sessions/client.js +1577 -0
  576. package/lib/ui/plugins/sessions/icon.png +0 -0
  577. package/lib/ui/plugins/settings/client.js +5470 -0
  578. package/lib/ui/plugins/settings/icon.png +0 -0
  579. package/lib/ui/plugins/skills/client.js +485 -0
  580. package/lib/ui/plugins/skills/icon.png +0 -0
  581. package/lib/ui/plugins/status/client.js +1420 -0
  582. package/lib/ui/plugins/status/icon.png +0 -0
  583. package/lib/ui/plugins/statusbar/client.js +504 -0
  584. package/lib/ui/plugins/statusbar/icon.png +0 -0
  585. package/lib/ui/plugins/tasks/client.js +52 -0
  586. package/lib/ui/plugins/tasks/icon.png +0 -0
  587. package/lib/ui/plugins/team/client.js +527 -0
  588. package/lib/ui/plugins/team/icon.png +0 -0
  589. package/lib/ui/plugins/terminal/client.js +232 -0
  590. package/lib/ui/plugins/terminal/icon.png +0 -0
  591. package/lib/ui/plugins/trace/client.js +1376 -0
  592. package/lib/ui/plugins/trace/icon.png +0 -0
  593. package/lib/ui/plugins/transcript/client.js +2661 -0
  594. package/lib/ui/plugins/transcript/icon.png +0 -0
  595. package/lib/ui/scoped-slots.d.ts +20 -0
  596. package/lib/ui/scoped-slots.js +21 -0
  597. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  598. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  599. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  600. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  601. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  602. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  603. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  604. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  605. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  606. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  607. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  608. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  609. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  610. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  611. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  612. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  613. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  614. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  615. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  616. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  617. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  618. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  619. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  620. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  621. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  622. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  623. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  624. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  625. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  626. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  627. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  629. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  630. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  631. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  632. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  633. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  634. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  635. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  636. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  637. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  638. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  639. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  640. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  641. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  642. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  643. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  644. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  645. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  646. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  647. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  648. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  649. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  650. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  651. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  652. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  653. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  663. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  664. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  665. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  666. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  667. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  668. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  669. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  670. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  671. package/lib/ui/services-react.d.ts +27 -0
  672. package/lib/ui/services-react.js +32 -0
  673. package/lib/ui/services.d.ts +63 -0
  674. package/lib/ui/services.js +121 -0
  675. package/lib/ui/slots-ink.d.ts +26 -0
  676. package/lib/ui/slots-ink.js +78 -0
  677. package/lib/ui/slots-react.d.ts +28 -0
  678. package/lib/ui/slots-react.js +88 -0
  679. package/lib/ui/slots.d.ts +481 -0
  680. package/lib/ui/slots.js +550 -0
  681. package/lib/ui/store.d.ts +89 -0
  682. package/lib/ui/store.js +62 -0
  683. package/lib/ui/tui-plugin-api.d.ts +23 -0
  684. package/lib/ui/tui-plugin-api.js +23 -0
  685. package/lib/ui/tui-plugins.d.ts +47 -0
  686. package/lib/ui/tui-plugins.js +220 -0
  687. package/package.json +58 -6
@@ -0,0 +1,158 @@
1
+ /**
2
+ * 长期记忆的评估口径(对齐 codex 的「记忆使用账」,不做语义召回)。
3
+ *
4
+ * 本模块是**纯读数**:只吃一份已经算好的账(每条记忆被注入过几轮、被引用过几次),
5
+ * 吐出一份人话报表与几个机器读数。它不读盘、不写盘、不认识文件系统——所以**零运行期
6
+ * 依赖**(连 `import` 都没有),可以被探针按 Node 类型擦除直读。
7
+ *
8
+ * ## 与 codex 的对应关系
9
+ *
10
+ * codex 的记忆读路径是「注入 MEMORY.md + 在回话里引用」,它的账记在两处:
11
+ * - `codex-rs/state/src/runtime/memories.rs`:每条被引用(citation)的 thread
12
+ * 让 `usage_count + 1`、`last_usage = now`;清理按
13
+ * `COALESCE(last_usage, source_updated_at) < max_unused_days`;选择排序按
14
+ * `usage_count DESC → COALESCE(last_usage, source_updated_at) DESC → source_updated_at DESC`。
15
+ * - `codex-rs/memories/read/src/citations.rs`:模型回话里 `<memory_citation>` 的
16
+ * `MEMORY.md:1-2|note=[x]` 是「这条记忆真被用上了」的唯一证据来源。
17
+ *
18
+ * dsc 的落点(一一对得上):
19
+ * - codex 的 `usage_count` / `last_usage` → dsc `.usage.json` 里的 `count` / `last`
20
+ * (隐式引用计数,判据见 `plugins/memory.ts` 的 `recordTurnUsage`:条目前 12 字原文
21
+ * 片段出现在最后一条 assistant 回话里);
22
+ * - codex 的「读用遥测分类」`MemoriesUsageKind`(memory_md / memory_summary /
23
+ * raw_memories / rollout_summaries / skills)→ dsc 的三格 `target`
24
+ * (global / user / workspace),本模块的 `byTarget` 就是这层分类;
25
+ * - codex 的 `codex.memory.storage_bytes`(唯一在看的体量指标)→ `storageBytes`;
26
+ * - codex 的 phase-2 选择排序 → 本模块的 `ranking`(`citedCount DESC → lastCitedAt
27
+ * DESC → injectedTurns DESC → key`,把 codex 的 `source_updated_at` 这一档换成
28
+ * dsc 侧能观测的 `injectedTurns`)。
29
+ *
30
+ * `injectedTurns` 是 dsc 多出来的一维:条目**真的写进过提示词**的轮数(被行数/字符预算
31
+ * 挤掉的不算)。codex 那边 MEMORY.md 是常量注入,没有这一维;dsc 有预算上限,需要它才能
32
+ * 分清「模型见过但没引用」(死重)与「压根没进去过」(被预算挤掉,或刚写进来还没轮到注入)。
33
+ *
34
+ * ## 取舍:不做语义召回
35
+ *
36
+ * 对齐 codex:codex 没有语义召回,读路径就是「注入 + 回话引用」。所以本模块**不做**
37
+ * embedding / 相似度召回——那是 ZCode 的 Selector,在 dsc 里未接线,本任务不搬。
38
+ *
39
+ * ## 显式阈值(文档化口径,改这里就是改口径)
40
+ *
41
+ * - `deadWeight`(死重):`injectedTurns >= 3` 且 `citedCount === 0`。这就是 codex
42
+ * `usage_count = 0` 那批,正是清理的首选。
43
+ * - `coverage`(覆盖率):健康线 `0.80`,及格线 `0.50`。
44
+ * - `citationRate`(引用率):健康线 `0.50`,及格线 `0.20`。
45
+ * - `budgetRatio`(预算占用):健康线 `0.90`;到这条线就压到 `watch`,注入栏快挤满了。
46
+ * - `grade`:
47
+ * `poor` —— 任一及格线没到(`coverage < 0.50` 或 `citationRate < 0.20`);
48
+ * `watch` —— 没到任一健康线(`coverage < 0.80` 或 `citationRate < 0.50`),
49
+ * 或存在死重条目,或 `budgetRatio >= 0.90`;
50
+ * `healthy` —— 其余。
51
+ * 空库(`entries === 0`)时 `coverage` / `citationRate` 记 1、无死重、无预算占用,
52
+ * 结果就是 `healthy`——没有东西可评,不该报偏差。
53
+ *
54
+ * @module dsc/core/memory-eval
55
+ */
56
+ /** 评估等级。三档,语义见文件头阈值表。 */
57
+ export type MemoryEvalGrade = 'healthy' | 'watch' | 'poor';
58
+ /** 一条记忆在本模块眼里的一行账。 */
59
+ export interface MemoryEvalEntry {
60
+ /** 条目标识(dsc 里是 `.usage.json` 用的那枚指纹)。 */
61
+ key: string;
62
+ /** 哪一格(对齐 codex 的 `MemoriesUsageKind` 分类)。 */
63
+ target: string;
64
+ /** 条目正文(去类型前缀后的文本,UTF-8 字节数按它算)。 */
65
+ text: string;
66
+ /** 被真的写进提示词的轮数(预算挤掉的不算)。 */
67
+ injectedTurns: number;
68
+ /** 被引用的次数(对齐 codex 的 `usage_count`)。 */
69
+ citedCount: number;
70
+ /** 最后一次被引用的时刻(毫秒;从没被引用过为 null,对齐 `last_usage`)。 */
71
+ lastCitedAt: number | null;
72
+ }
73
+ /** 一次评估吃进去的全部输入。 */
74
+ export interface MemoryEvalInput {
75
+ /** 当前所有参与的记忆条目。 */
76
+ entries: readonly MemoryEvalEntry[];
77
+ /** 已经发生过的轮数(`uninjected` 只在它 > 0 时才有意义)。 */
78
+ turns: number;
79
+ /** 注入栏已用字数(各格之和)。 */
80
+ usedChars: number;
81
+ /** 注入栏字数上限(各格之和)。 */
82
+ limitChars: number;
83
+ /** 多久没被引用算陈旧(天)——报表里只作为口径提示,不参与分档。 */
84
+ pruneAfterDays: number;
85
+ /** 现在时刻(毫秒)。 */
86
+ now: number;
87
+ }
88
+ /** 单格(target)的读数。 */
89
+ export interface MemoryEvalPerTarget {
90
+ target: string;
91
+ entries: number;
92
+ injectedEntries: number;
93
+ citedEntries: number;
94
+ /** 这一格里的死重条目 key(按 key 排序,便于比对)。 */
95
+ deadWeight: string[];
96
+ /** 这一格从没进过提示词的条目 key(`turns > 0` 时才有意义)。 */
97
+ uninjected: string[];
98
+ storageBytes: number;
99
+ }
100
+ /** 一份完整的评估报表。 */
101
+ export interface MemoryEvalReport {
102
+ /** 条目总数。 */
103
+ entries: number;
104
+ /** 被注入过的条目数(`injectedTurns > 0`)。 */
105
+ injectedEntries: number;
106
+ /** 被引用过的条目数(`citedCount > 0`)。 */
107
+ citedEntries: number;
108
+ /** `injectedEntries / entries`;没有条目时按 1 记。 */
109
+ coverage: number;
110
+ /** `citedEntries / injectedEntries`;注入数为 0(含空库)时按 1 记。 */
111
+ citationRate: number;
112
+ /** 注入过 >= 3 轮、一次也没被引用的条目 key(清理首选)。 */
113
+ deadWeight: string[];
114
+ /** `turns > 0` 但从没进过提示词的条目 key(被预算挤掉,或刚写进来还没轮到注入)。 */
115
+ uninjected: string[];
116
+ /** `usedChars / limitChars`(夹在 0..1)。 */
117
+ budgetRatio: number;
118
+ /** 条目正文 UTF-8 字节数合计(对齐 codex 的 `storage_bytes`)。 */
119
+ storageBytes: number;
120
+ /** 分档结果。 */
121
+ grade: MemoryEvalGrade;
122
+ /** 本次评估看到的轮数。 */
123
+ turns: number;
124
+ /** 本次评估的时刻(毫秒)。 */
125
+ now: number;
126
+ /** 该留 / 该先注入的排序(对齐 codex phase-2 选择的 ORDER BY)。 */
127
+ ranking: string[];
128
+ /** 每格读数(对齐 `MemoriesUsageKind` 的分类)。 */
129
+ byTarget: MemoryEvalPerTarget[];
130
+ /** 中文人话报表,每行一个读数。 */
131
+ lines: string[];
132
+ }
133
+ /** 报表去掉 `lines` 之后的裸读数——落 `.eval.json` 用,下次算增量。 */
134
+ export type MemoryEvalReadings = Omit<MemoryEvalReport, 'lines'>;
135
+ /** 文档化的阈值(与文件头注释同源)。 */
136
+ export declare const MEMORY_EVAL_THRESHOLDS: {
137
+ readonly deadWeightMinTurns: 3;
138
+ readonly coverageHealthy: 0.8;
139
+ readonly coveragePoor: 0.5;
140
+ readonly citationHealthy: 0.5;
141
+ readonly citationPoor: 0.2;
142
+ readonly budgetWatch: 0.9;
143
+ };
144
+ /**
145
+ * 评一次长期记忆。
146
+ *
147
+ * @param input - 账与额度现状(见 {@link MemoryEvalInput})。
148
+ */
149
+ export declare function evaluateMemory(input: MemoryEvalInput): MemoryEvalReport;
150
+ /** 抽出报表里可落盘的裸读数(去掉 `lines`)。 */
151
+ export declare function readingsOf(report: MemoryEvalReport): MemoryEvalReadings;
152
+ /**
153
+ * 把报表折成给用户看的多行文本。
154
+ *
155
+ * @param report - 本次报表。
156
+ * @param previous - 上一次的裸读数;给了就在末尾逐项列增量(这就是「A-B / 两次评估对比」的口径)。
157
+ */
158
+ export declare function formatMemoryReport(report: MemoryEvalReport, previous?: MemoryEvalReadings): string;
@@ -0,0 +1,215 @@
1
+ /**
2
+ * 长期记忆的评估口径(对齐 codex 的「记忆使用账」,不做语义召回)。
3
+ *
4
+ * 本模块是**纯读数**:只吃一份已经算好的账(每条记忆被注入过几轮、被引用过几次),
5
+ * 吐出一份人话报表与几个机器读数。它不读盘、不写盘、不认识文件系统——所以**零运行期
6
+ * 依赖**(连 `import` 都没有),可以被探针按 Node 类型擦除直读。
7
+ *
8
+ * ## 与 codex 的对应关系
9
+ *
10
+ * codex 的记忆读路径是「注入 MEMORY.md + 在回话里引用」,它的账记在两处:
11
+ * - `codex-rs/state/src/runtime/memories.rs`:每条被引用(citation)的 thread
12
+ * 让 `usage_count + 1`、`last_usage = now`;清理按
13
+ * `COALESCE(last_usage, source_updated_at) < max_unused_days`;选择排序按
14
+ * `usage_count DESC → COALESCE(last_usage, source_updated_at) DESC → source_updated_at DESC`。
15
+ * - `codex-rs/memories/read/src/citations.rs`:模型回话里 `<memory_citation>` 的
16
+ * `MEMORY.md:1-2|note=[x]` 是「这条记忆真被用上了」的唯一证据来源。
17
+ *
18
+ * dsc 的落点(一一对得上):
19
+ * - codex 的 `usage_count` / `last_usage` → dsc `.usage.json` 里的 `count` / `last`
20
+ * (隐式引用计数,判据见 `plugins/memory.ts` 的 `recordTurnUsage`:条目前 12 字原文
21
+ * 片段出现在最后一条 assistant 回话里);
22
+ * - codex 的「读用遥测分类」`MemoriesUsageKind`(memory_md / memory_summary /
23
+ * raw_memories / rollout_summaries / skills)→ dsc 的三格 `target`
24
+ * (global / user / workspace),本模块的 `byTarget` 就是这层分类;
25
+ * - codex 的 `codex.memory.storage_bytes`(唯一在看的体量指标)→ `storageBytes`;
26
+ * - codex 的 phase-2 选择排序 → 本模块的 `ranking`(`citedCount DESC → lastCitedAt
27
+ * DESC → injectedTurns DESC → key`,把 codex 的 `source_updated_at` 这一档换成
28
+ * dsc 侧能观测的 `injectedTurns`)。
29
+ *
30
+ * `injectedTurns` 是 dsc 多出来的一维:条目**真的写进过提示词**的轮数(被行数/字符预算
31
+ * 挤掉的不算)。codex 那边 MEMORY.md 是常量注入,没有这一维;dsc 有预算上限,需要它才能
32
+ * 分清「模型见过但没引用」(死重)与「压根没进去过」(被预算挤掉,或刚写进来还没轮到注入)。
33
+ *
34
+ * ## 取舍:不做语义召回
35
+ *
36
+ * 对齐 codex:codex 没有语义召回,读路径就是「注入 + 回话引用」。所以本模块**不做**
37
+ * embedding / 相似度召回——那是 ZCode 的 Selector,在 dsc 里未接线,本任务不搬。
38
+ *
39
+ * ## 显式阈值(文档化口径,改这里就是改口径)
40
+ *
41
+ * - `deadWeight`(死重):`injectedTurns >= 3` 且 `citedCount === 0`。这就是 codex
42
+ * `usage_count = 0` 那批,正是清理的首选。
43
+ * - `coverage`(覆盖率):健康线 `0.80`,及格线 `0.50`。
44
+ * - `citationRate`(引用率):健康线 `0.50`,及格线 `0.20`。
45
+ * - `budgetRatio`(预算占用):健康线 `0.90`;到这条线就压到 `watch`,注入栏快挤满了。
46
+ * - `grade`:
47
+ * `poor` —— 任一及格线没到(`coverage < 0.50` 或 `citationRate < 0.20`);
48
+ * `watch` —— 没到任一健康线(`coverage < 0.80` 或 `citationRate < 0.50`),
49
+ * 或存在死重条目,或 `budgetRatio >= 0.90`;
50
+ * `healthy` —— 其余。
51
+ * 空库(`entries === 0`)时 `coverage` / `citationRate` 记 1、无死重、无预算占用,
52
+ * 结果就是 `healthy`——没有东西可评,不该报偏差。
53
+ *
54
+ * @module dsc/core/memory-eval
55
+ */
56
+ /** 文档化的阈值(与文件头注释同源)。 */
57
+ export const MEMORY_EVAL_THRESHOLDS = {
58
+ deadWeightMinTurns: 3,
59
+ coverageHealthy: 0.8,
60
+ coveragePoor: 0.5,
61
+ citationHealthy: 0.5,
62
+ citationPoor: 0.2,
63
+ budgetWatch: 0.9,
64
+ };
65
+ const GRADE_LABELS = {
66
+ healthy: '健康',
67
+ watch: '留意',
68
+ poor: '偏差',
69
+ };
70
+ /** target 的中文名(本模块零依赖,不 import core/memory 的 TARGET_LABELS,自带一份)。 */
71
+ const TARGET_LABELS = {
72
+ global: '全局事实',
73
+ user: '用户偏好',
74
+ workspace: '本工作区',
75
+ };
76
+ /** 正文的 UTF-8 字节数。 */
77
+ function utf8Bytes(text) {
78
+ return Buffer.byteLength(text, 'utf8');
79
+ }
80
+ /** 小数折成整数百分比。 */
81
+ function pct(value) {
82
+ return `${String(Math.round(value * 100))}%`;
83
+ }
84
+ /** 分档:先判及格线(poor),再判健康线(watch),否则 healthy。 */
85
+ function gradeOf(coverage, citationRate, deadWeightCount, budgetRatio) {
86
+ if (coverage < MEMORY_EVAL_THRESHOLDS.coveragePoor || citationRate < MEMORY_EVAL_THRESHOLDS.citationPoor)
87
+ return 'poor';
88
+ if (coverage < MEMORY_EVAL_THRESHOLDS.coverageHealthy ||
89
+ citationRate < MEMORY_EVAL_THRESHOLDS.citationHealthy ||
90
+ deadWeightCount > 0 ||
91
+ budgetRatio >= MEMORY_EVAL_THRESHOLDS.budgetWatch) {
92
+ return 'watch';
93
+ }
94
+ return 'healthy';
95
+ }
96
+ /** 排序:对齐 codex phase-2 选择(count 优先,再看时间)。 */
97
+ function rankOf(entries) {
98
+ return [...entries]
99
+ .sort((a, b) => b.citedCount - a.citedCount ||
100
+ (b.lastCitedAt ?? 0) - (a.lastCitedAt ?? 0) ||
101
+ b.injectedTurns - a.injectedTurns ||
102
+ a.key.localeCompare(b.key))
103
+ .map((entry) => entry.key);
104
+ }
105
+ /** 一条条目算不算死重。 */
106
+ function isDeadWeight(entry) {
107
+ return entry.injectedTurns >= MEMORY_EVAL_THRESHOLDS.deadWeightMinTurns && entry.citedCount === 0;
108
+ }
109
+ /**
110
+ * 评一次长期记忆。
111
+ *
112
+ * @param input - 账与额度现状(见 {@link MemoryEvalInput})。
113
+ */
114
+ export function evaluateMemory(input) {
115
+ const entries = [...input.entries];
116
+ const total = entries.length;
117
+ const injected = entries.filter((entry) => entry.injectedTurns > 0);
118
+ const cited = entries.filter((entry) => entry.citedCount > 0);
119
+ const coverage = total === 0 ? 1 : injected.length / total;
120
+ const citationRate = injected.length === 0 ? 1 : cited.length / injected.length;
121
+ const deadWeight = entries.filter(isDeadWeight).map((entry) => entry.key).sort();
122
+ const uninjected = input.turns > 0 ? entries.filter((entry) => entry.injectedTurns === 0).map((entry) => entry.key).sort() : [];
123
+ const budgetRatio = input.limitChars <= 0 ? 0 : Math.min(1, Math.max(0, input.usedChars / input.limitChars));
124
+ const storageBytes = entries.reduce((sum, entry) => sum + utf8Bytes(entry.text), 0);
125
+ const grade = gradeOf(coverage, citationRate, deadWeight.length, budgetRatio);
126
+ const targets = [];
127
+ for (const entry of entries)
128
+ if (!targets.includes(entry.target))
129
+ targets.push(entry.target);
130
+ const byTarget = targets.map((target) => {
131
+ const subset = entries.filter((entry) => entry.target === target);
132
+ return {
133
+ target,
134
+ entries: subset.length,
135
+ injectedEntries: subset.filter((entry) => entry.injectedTurns > 0).length,
136
+ citedEntries: subset.filter((entry) => entry.citedCount > 0).length,
137
+ deadWeight: subset.filter(isDeadWeight).map((entry) => entry.key).sort(),
138
+ uninjected: input.turns > 0 ? subset.filter((entry) => entry.injectedTurns === 0).map((entry) => entry.key).sort() : [],
139
+ storageBytes: subset.reduce((sum, entry) => sum + utf8Bytes(entry.text), 0),
140
+ };
141
+ });
142
+ const lines = [
143
+ `条目 ${String(total)} 条`,
144
+ `注入 ${String(injected.length)} 条`,
145
+ `引用 ${String(cited.length)} 条`,
146
+ `覆盖率 ${pct(coverage)}`,
147
+ `引用率 ${pct(citationRate)}`,
148
+ `死重 ${String(deadWeight.length)} 条${deadWeight.length === 0 ? '' : `:${deadWeight.join(' ')}`}`,
149
+ `未注入 ${String(uninjected.length)} 条${uninjected.length === 0 ? '' : `:${uninjected.join(' ')}`}`,
150
+ `预算占用 ${pct(budgetRatio)}`,
151
+ `体量 ${String(storageBytes)} 字节`,
152
+ `等级 ${GRADE_LABELS[grade]}`,
153
+ ];
154
+ for (const cell of byTarget) {
155
+ lines.push(`${TARGET_LABELS[cell.target] ?? cell.target}:${String(cell.entries)} 条 / 注入 ${String(cell.injectedEntries)} / 引用 ${String(cell.citedEntries)}`);
156
+ }
157
+ return {
158
+ entries: total,
159
+ injectedEntries: injected.length,
160
+ citedEntries: cited.length,
161
+ coverage,
162
+ citationRate,
163
+ deadWeight,
164
+ uninjected,
165
+ budgetRatio,
166
+ storageBytes,
167
+ grade,
168
+ turns: input.turns,
169
+ now: input.now,
170
+ ranking: rankOf(entries),
171
+ byTarget,
172
+ lines,
173
+ };
174
+ }
175
+ /** 抽出报表里可落盘的裸读数(去掉 `lines`)。 */
176
+ export function readingsOf(report) {
177
+ const { lines: _lines, ...rest } = report;
178
+ return rest;
179
+ }
180
+ /** 带符号的整数增量。 */
181
+ function signed(value) {
182
+ return value >= 0 ? `+${String(value)}` : String(value);
183
+ }
184
+ /** 带符号的百分比点增量。 */
185
+ function signedPct(value) {
186
+ return `${value >= 0 ? '+' : '-'}${pct(Math.abs(value))}`;
187
+ }
188
+ /**
189
+ * 把报表折成给用户看的多行文本。
190
+ *
191
+ * @param report - 本次报表。
192
+ * @param previous - 上一次的裸读数;给了就在末尾逐项列增量(这就是「A-B / 两次评估对比」的口径)。
193
+ */
194
+ export function formatMemoryReport(report, previous) {
195
+ const head = `记忆评估:${GRADE_LABELS[report.grade]}(${report.grade})`;
196
+ const body = [head, ...report.lines].join('\n');
197
+ if (previous === undefined)
198
+ return body;
199
+ const gradeLine = report.grade === previous.grade
200
+ ? `等级 ${GRADE_LABELS[report.grade]}(不变)`
201
+ : `等级 ${GRADE_LABELS[report.grade]}(上次 ${GRADE_LABELS[previous.grade]})`;
202
+ const delta = [
203
+ `条目 ${String(report.entries)}(${signed(report.entries - previous.entries)})`,
204
+ `注入 ${String(report.injectedEntries)}(${signed(report.injectedEntries - previous.injectedEntries)})`,
205
+ `引用 ${String(report.citedEntries)}(${signed(report.citedEntries - previous.citedEntries)})`,
206
+ `覆盖率 ${pct(report.coverage)}(${signedPct(report.coverage - previous.coverage)})`,
207
+ `引用率 ${pct(report.citationRate)}(${signedPct(report.citationRate - previous.citationRate)})`,
208
+ `死重 ${String(report.deadWeight.length)}(${signed(report.deadWeight.length - previous.deadWeight.length)})`,
209
+ `未注入 ${String(report.uninjected.length)}(${signed(report.uninjected.length - previous.uninjected.length)})`,
210
+ `预算占用 ${pct(report.budgetRatio)}(${signedPct(report.budgetRatio - previous.budgetRatio)})`,
211
+ `体量 ${String(report.storageBytes)} 字节(${signed(report.storageBytes - previous.storageBytes)})`,
212
+ gradeLine,
213
+ ];
214
+ return `${body}\n\n与上次相比:\n${delta.map((line) => ` ${line}`).join('\n')}`;
215
+ }
@@ -0,0 +1,266 @@
1
+ /** 记忆分格。`global` 是跨项目的事实,`user` 是用户本人,`workspace` 只属于当前仓库。 */
2
+ export type MemoryTarget = 'global' | 'user' | 'workspace';
3
+ export declare const MEMORY_TARGETS: readonly MemoryTarget[];
4
+ /** 分区中文名(错误信息与界面都用它,两处不会写岔)。 */
5
+ export declare const TARGET_LABELS: Record<MemoryTarget, string>;
6
+ /**
7
+ * 记忆条目的类型(照 ZCode 的类型枚举收成三档):
8
+ * - `fact`:默认档,客观事实(构建命令、仓库布局这类);
9
+ * - `feedback`:用户纠正 / 确认过的做法,正文建议带 Why 与 How to apply;
10
+ * - `reference`:外部资料 / 出处指针,本身不是结论。
11
+ *
12
+ * 存储形状向后兼容:只有非默认类型才在条目前加 `[feedback] ` / `[reference] ` 前缀,
13
+ * 老的纯文本条目(没有前缀)一律读成 `fact`,文件不必迁移。
14
+ */
15
+ export type MemoryType = 'fact' | 'feedback' | 'reference';
16
+ export declare const MEMORY_TYPES: readonly MemoryType[];
17
+ /** 类型中文名(界面与错误信息共用)。 */
18
+ export declare const MEMORY_TYPE_LABELS: Record<MemoryType, string>;
19
+ /** 读一条条目:拆出类型与正文(没有前缀 = `fact`)。 */
20
+ export declare function parseEntry(entry: string): {
21
+ type: MemoryType;
22
+ text: string;
23
+ };
24
+ /** 一条条目的类型。 */
25
+ export declare function entryType(entry: string): MemoryType;
26
+ /** 一条条目的正文(去掉类型前缀)。 */
27
+ export declare function entryText(entry: string): string;
28
+ /** 把类型与正文拼成落盘形状:`fact` 不加前缀(老文件写法不变),其余加 `[类型] `。 */
29
+ export declare function formatEntry(type: MemoryType, text: string): string;
30
+ /** 条目之间的分隔符:换行、`§`、换行。 */
31
+ export declare const ENTRY_DELIMITER = "\n\u00A7\n";
32
+ /** 各格的缺省字数上限(含分隔符),跟 Hermes 的默认值一致。 */
33
+ export declare const MEMORY_LIMIT_DEFAULTS: Record<MemoryTarget, number>;
34
+ /** 一条写入操作。`replace` 与 `remove` 靠 `oldText` 定位条目。 */
35
+ export interface MemoryOperation {
36
+ action: 'add' | 'replace' | 'remove';
37
+ target: MemoryTarget;
38
+ /** `add` / `replace` 的新内容。 */
39
+ content?: string;
40
+ /** `replace` / `remove` 要动的条目里的片段(只允许唯一匹配)。 */
41
+ oldText?: string;
42
+ /** 条目类型;不填按 `fact`(`replace` 不填时沿用原条目的类型)。 */
43
+ type?: MemoryType;
44
+ }
45
+ /** 一格现在的样子。 */
46
+ export interface MemoryCell {
47
+ target: MemoryTarget;
48
+ filePath: string;
49
+ /** 磁盘上已有的条目(原样,没过安检)。 */
50
+ entries: string[];
51
+ /** 已用字数(连分隔符一起算)。 */
52
+ used: number;
53
+ /** 这一格的字数上限。 */
54
+ limit: number;
55
+ /** 文件还不存在(第一次写入时才创建)。 */
56
+ missing: boolean;
57
+ /** 读这份文件时发现的毛病(比如被外面改过,已备份)。 */
58
+ problem: string;
59
+ }
60
+ /** 长期记忆的全部可调值(插件配置 `memory` 那一节读出来的形状)。 */
61
+ export interface MemoryConfig {
62
+ /** 总开关:关掉之后既不注入也不许写,文件原样留在盘上。 */
63
+ enabled: boolean;
64
+ /** `user` 这一格参不参与(关掉等于不认识用户偏好)。 */
65
+ userProfile: boolean;
66
+ /** `workspace` 这一格参不参与。 */
67
+ workspace: boolean;
68
+ /** 三格各自的中文字数上限(含 `§` 分隔符)。 */
69
+ limits: Record<MemoryTarget, number>;
70
+ /** 每次写入都要用户点头(默认关:点头点到模型懒得记,记忆就废了)。 */
71
+ writeApproval: boolean;
72
+ /** 每隔多少轮用户发言做一次无人值守复盘。0 = 不做。 */
73
+ reviewEveryTurns: number;
74
+ /** 复盘开关。 */
75
+ reviewEnabled: boolean;
76
+ /** 会话打开时自动做一次保守整理(只移不删)。 */
77
+ pruneEnabled: boolean;
78
+ /** 多久没被引用(也没被用过)算陈旧,整理时移进归档区。0 = 只要没被引用就移。 */
79
+ pruneAfterDays: number;
80
+ /** 注入时记忆栏的行数上限(超了截断并说明,不动磁盘)。 */
81
+ maxIndexLines: number;
82
+ /** 注入时记忆栏的字符数上限。 */
83
+ maxIndexChars: number;
84
+ }
85
+ export declare const DEFAULT_MEMORY_CONFIG: MemoryConfig;
86
+ /** 一批操作的结果。 */ export interface MemoryWriteResult {
87
+ ok: boolean;
88
+ /** 失败原因(给人看的话)。 */
89
+ error: string;
90
+ /** 每条操作各自的结果说明,长度与入参一致;失败时是空数组。 */
91
+ notes: string[];
92
+ /** 涉及的格子现在的样子(失败时也回吐,让模型当场看到该合并什么)。 */
93
+ cells: MemoryCell[];
94
+ }
95
+ /** 记忆目录根(`~/.dsc/memory`)。 */
96
+ export declare function memoryRoot(): string;
97
+ /** 把工作目录折成一个能当目录名的键:`D:\dsc` → `d-dsc`;过长的补一段哈希。 */
98
+ export declare function workspaceKey(cwd: string): string;
99
+ /** 某一格对应的文件路径。 */
100
+ export declare function memoryFileOf(target: MemoryTarget, cwd: string): string;
101
+ /** 把文件正文折成条目:按分隔符切、去空、去掉每条首尾空白。 */
102
+ export declare function splitEntries(text: string): string[];
103
+ /** 把条目拼回文件正文(结尾留一个换行,编辑器里不难看)。 */
104
+ export declare function joinEntries(entries: readonly string[]): string;
105
+ /** 连分隔符一起算的字数。 */
106
+ export declare function usedChars(entries: readonly string[]): number;
107
+ /**
108
+ * 读一格。
109
+ *
110
+ * 外部改动在这里发现:磁盘指纹跟我们上次写进去(或上次读到)的不一样,就把现状复制一份
111
+ * 备份,并在 `problem` 里说清楚。本次读取照常返回,要不要写由于调用方决定。
112
+ *
113
+ * @param target - 哪一格。
114
+ * @param cwd - 当前会话的工作目录(决定 workspace 那一格)。
115
+ * @param limits - 各格上限(设置里可改)。
116
+ */
117
+ export declare function readCell(target: MemoryTarget, cwd: string, limits?: Record<MemoryTarget, number>): MemoryCell;
118
+ /** 读三格(快照与界面用)。`enabled` 决定哪几格参与。 */
119
+ export declare function readAllCells(cwd: string, limits?: Record<MemoryTarget, number>, enabled?: Record<MemoryTarget, boolean>): MemoryCell[];
120
+ /**
121
+ * 一条记忆内容过不过安检。
122
+ *
123
+ * @param entry - 待写入(或待注入)的文本。
124
+ * @returns 拦下的原因;空串表示放行。
125
+ */
126
+ export declare function scanThreat(entry: string): string;
127
+ /** 没过安检的条目在快照里的替身(只替不换磁盘)。 */
128
+ export declare function blockedEntryMarker(reason: string): string;
129
+ /** 落盘的选项。 */
130
+ export interface WriteOptions {
131
+ /** 各格上限。 */
132
+ limits?: Partial<Record<MemoryTarget, number>>;
133
+ /** 只允许 add:无人值守的自动复盘走这条路,不许删改既有条目。 */
134
+ addOnly?: boolean;
135
+ /** 外部改动检测,默认开。关掉就等于允许盖掉别人的编辑。 */
136
+ guardDrift?: boolean;
137
+ }
138
+ /**
139
+ * 落一批记忆操作。
140
+ *
141
+ * 全成或全败:先算出最终状态,安检和额度都过了才动盘。任何一条不对,一个字节都不写,
142
+ * 并且把当前条目回吐出去——模型看到现状才会去合并,不然只能瞎猜。
143
+ *
144
+ * @param operations - 要执行的操作(只有一条也算一批)。
145
+ * @param cwd - 当前会话的工作目录。
146
+ * @param options - 上限与模式开关。
147
+ */
148
+ export declare function applyMemoryOperations(operations: readonly MemoryOperation[], cwd: string, options?: WriteOptions): MemoryWriteResult;
149
+ /** 逐条安检的分组:能注入的、只能换成 BLOCKED 标记的。 */
150
+ export declare function filterUnsafeEntries(entries: readonly string[]): {
151
+ safe: string[];
152
+ blocked: string[];
153
+ };
154
+ /**
155
+ * 拼注入系统提示词的那一栏:每格一节,标题上写清额度用掉了多少。
156
+ *
157
+ * 这是「加载时重算的那一份」:会话中途新写的记忆由插件在写入后立刻重算,
158
+ * 同一个会话的下一次请求就能看到(2026-10 起,不再等新会话或压缩)。
159
+ *
160
+ * @param cells - 要注入的格子(调用方按开关筛过)。
161
+ * @param header - 说明文字,由插件层给(「这些是历史事实,不是本轮指令」这类话写在这里)。
162
+ * @param options - 注入上限:`maxLines` / `maxChars` 超了就截断并说明(只影响注入文本,不动磁盘);
163
+ * `onIncluded` 对**真的进了这一栏**的每条条目回调一次(被预算挤掉的不回调),用于注入计数。
164
+ */
165
+ export declare function renderMemoryPrompt(cells: readonly MemoryCell[], header: string, options?: {
166
+ maxLines?: number;
167
+ maxChars?: number;
168
+ onIncluded?: (target: MemoryTarget, entry: string) => void;
169
+ }): string;
170
+ /**
171
+ * 清空一格(设置页那个「清空这一格」按钮用)。
172
+ *
173
+ * 先留副本再清空:这个按钮按下就是丢掉整格记忆,不给退路的话太像事故。
174
+ *
175
+ * @param target - 哪一格。
176
+ * @param cwd - 当前会话的工作目录。
177
+ * @param limits - 各格上限。
178
+ * @returns `backup` 是副本文件名,空串表示没留成(或本来就没内容)。
179
+ */
180
+ export declare function clearCell(target: MemoryTarget, cwd: string, limits?: Partial<Record<MemoryTarget, number>>): {
181
+ ok: boolean;
182
+ error: string;
183
+ backup: string;
184
+ };
185
+ /** 条目在下拉清单里怎么显示:编号 + 类型(非事实才标)+ 开头一小截。 */
186
+ export declare function entryLabel(entry: string, index: number): string;
187
+ /**
188
+ * 一条记忆条目的使用记录:被引用次数 + 最后一次被引用的时刻(毫秒)。
189
+ *
190
+ * `injected` / `lastInjected`(2026-10 起)是关于「注入」的另一维账:条目**真的被写进
191
+ * 提示词**的轮数与最后一次注入的时刻。它不影响引用的 `count` / `last`(清理与排序仍只看
192
+ * 引用),只喂评估报表(见 `core/memory-eval.ts`)。老 `.usage.json` 没有这两个字段,
193
+ * 读成 0,无需迁移。
194
+ */
195
+ export interface MemoryUsageRecord {
196
+ count: number;
197
+ last: number;
198
+ injected?: number;
199
+ lastInjected?: number;
200
+ }
201
+ /** 使用台账:条目指纹 → 记录。 */
202
+ export type MemoryUsage = Record<string, MemoryUsageRecord>;
203
+ /** 台账文件(与三格记忆同目录,点号文件不参与读取)。 */
204
+ export declare function usageFile(): string;
205
+ /**
206
+ * 上一次评估的裸读数文件(与三格记忆同目录)。
207
+ *
208
+ * 存的是报表去掉 `lines` 之后的那份读数(形状见 `core/memory-eval.ts` 的
209
+ * `MemoryEvalReadings`),供下一次评估算增量(A-B 对比)。
210
+ */
211
+ export declare function evalFile(): string;
212
+ /** 条目指纹:按「格子 + 正文」算,类型前缀变了也不丢使用记录。 */
213
+ export declare function entryUsageKey(target: MemoryTarget, entry: string): string;
214
+ /** 读台账(文件不在或读不出来就当空表,绝不因此挡住记忆本身)。 */
215
+ export declare function readUsage(): MemoryUsage;
216
+ /** 记账(累加引用计数并刷新引用时刻)。返回写后的台账。 */
217
+ export declare function bumpUsage(keys: readonly string[], at?: number): MemoryUsage;
218
+ /**
219
+ * 记一次注入(累加注入轮数并刷新注入时刻)。同一份账文件、同一把写盘路径。
220
+ *
221
+ * 与 {@link bumpUsage} 分开:注入不是引用。清理与排序只看引用维(对齐 codex——
222
+ * `usage_count` 只被 citation 推进),所以这里绝不碰 `count` / `last`。
223
+ */
224
+ export declare function bumpInjected(keys: readonly string[], at?: number): MemoryUsage;
225
+ /** 读上一次的评估裸读数;文件不在或读不出来返回 null(下次就是首评,不给增量)。 */
226
+ export declare function readEval(): Record<string, unknown> | null;
227
+ /** 落本次评估的裸读数(供下次算增量);写失败静默,不许把宿主搞崩。 */
228
+ export declare function writeEval(readings: object): void;
229
+ /** 某一格的归档文件路径(与那一格同目录,`*.archive.md`)。 */
230
+ export declare function archiveFileOf(target: MemoryTarget, cwd: string): string;
231
+ /** 整理结果。 */
232
+ export interface PruneResult {
233
+ /** 每格被移走的条目(原样,便于回看)。 */
234
+ moved: Record<MemoryTarget, string[]>;
235
+ /** 每格归档文件路径。 */
236
+ archivePaths: Record<MemoryTarget, string>;
237
+ /** 整理后各格的现状。 */
238
+ cells: MemoryCell[];
239
+ }
240
+ export interface PruneOptions {
241
+ /** 多久没被引用算陈旧(天)。0 = 只要没被引用过就移。 */
242
+ afterDays?: number;
243
+ /** 现在时刻(毫秒,测试注入用)。 */
244
+ now?: number;
245
+ /** 使用台账(缺省现读)。 */
246
+ usage?: MemoryUsage;
247
+ }
248
+ /**
249
+ * 保守整理:把「从没被引用过、而且已经陈旧」的条目移进同目录的归档文件。
250
+ *
251
+ * 三条底线:
252
+ * 1. 只移不删——被移走的原样写进归档,用户随时能翻回来;
253
+ * 2. 不被任何安全闸门绕过——整理只搬已经过安检、本来就在盘上的条目,不引入新内容;
254
+ * 3. 文件被外面改过(`problem`)的格子整格跳过,绝不覆盖用户正在编辑的那份。
255
+ *
256
+ * @param cwd - 当前会话工作目录(决定 workspace 那一格)。
257
+ * @param limits - 各格上限。
258
+ * @param enabled - 哪几格参与。
259
+ * @param options - 陈旧阈值与台账(测试注入用)。
260
+ */
261
+ export declare function pruneCells(cwd: string, limits?: Record<MemoryTarget, number>, enabled?: Record<MemoryTarget, boolean>, options?: PruneOptions): PruneResult;
262
+ /** 磁盘现状(自检比对用)。 */
263
+ export declare function diskStateOf(target: MemoryTarget, cwd: string): {
264
+ exists: boolean;
265
+ size: number;
266
+ };