@evandu/super-pi-server 0.0.0-stage → 0.1.259

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 (370) hide show
  1. package/README.md +248 -3
  2. package/agents/code-auditor.md +64 -0
  3. package/agents/code-designer.md +64 -0
  4. package/agents/coder.md +24 -0
  5. package/agents/critic.md +24 -0
  6. package/agents/document-organizer.md +48 -0
  7. package/agents/patcher.md +27 -0
  8. package/agents/planner.md +30 -0
  9. package/agents/project-leader.md +28 -0
  10. package/agents/reviewer.md +27 -0
  11. package/agents/scout.md +27 -0
  12. package/agents/solution-designer.md +62 -0
  13. package/agents/super-pi-documents/index.ts +92 -0
  14. package/agents/super-pi-feishu/index.ts +88 -0
  15. package/agents/super-pi-knowledge/index.ts +70 -0
  16. package/agents/super-pi-managed-model/index.ts +9 -0
  17. package/agents/super-pi-memory/index.ts +75 -0
  18. package/agents/super-pi-native-tools/index.ts +1 -0
  19. package/agents/super-pi-task/core.ts +2262 -0
  20. package/agents/super-pi-task/index.ts +814 -0
  21. package/agents/super-pi-task/workflow-schema.ts +34 -0
  22. package/agents/super-pi-web/index.ts +32 -0
  23. package/agents/verifier.md +25 -0
  24. package/assets/fonts/LICENSE +92 -0
  25. package/assets/fonts/NotoSansSC-Bold.otf +0 -0
  26. package/assets/fonts/NotoSansSC-Regular.otf +0 -0
  27. package/assets/knowledge-model/README.md +37 -0
  28. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/config.json +31 -0
  29. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/onnx/model_quantized.onnx +0 -0
  30. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/special_tokens_map.json +7 -0
  31. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/tokenizer.json +21278 -0
  32. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/tokenizer_config.json +15 -0
  33. package/assets/knowledge-model/Xenova/bge-small-zh-v1.5/vocab.txt +21128 -0
  34. package/bin/npm-prefix.d.ts +1 -0
  35. package/bin/npm-prefix.js +10 -0
  36. package/bin/super-pi.js +349 -0
  37. package/dist/client/.super-pi-client-sources.json +82 -0
  38. package/dist/client/assets/CodeMirrorEditor-mi9rGUce.js +2 -0
  39. package/dist/client/assets/GitDiffEditor-CpoDDQrA.css +1 -0
  40. package/dist/client/assets/GitDiffEditor-FQBfGxOY.js +29 -0
  41. package/dist/client/assets/diff-ChtP43wD.js +1 -0
  42. package/dist/client/assets/dist-AW5lyI3I.js +1 -0
  43. package/dist/client/assets/dist-B3-a6uF0.js +7 -0
  44. package/dist/client/assets/dist-BGxkyh6e.js +1 -0
  45. package/dist/client/assets/dist-BJxfd7yb.js +11 -0
  46. package/dist/client/assets/dist-BRVQKlcp.js +1 -0
  47. package/dist/client/assets/dist-BV64A9Ji.js +1 -0
  48. package/dist/client/assets/dist-BXAOrsjq.js +1 -0
  49. package/dist/client/assets/dist-CKF2Jksy.js +1 -0
  50. package/dist/client/assets/dist-CX_Hm4GS.js +1 -0
  51. package/dist/client/assets/dist-Cus6_oaF.js +2 -0
  52. package/dist/client/assets/dist-Cx00EZKR.js +23 -0
  53. package/dist/client/assets/dist-D71y2EI1.js +1 -0
  54. package/dist/client/assets/dist-D978o95T.js +5 -0
  55. package/dist/client/assets/dist-Dc1MBGAG.js +1 -0
  56. package/dist/client/assets/dist-Dds-qLxY.js +9 -0
  57. package/dist/client/assets/dist-DeD9copn.js +1 -0
  58. package/dist/client/assets/dist-DuvGReu-.js +6 -0
  59. package/dist/client/assets/dist-Dvb0SqcK.js +2 -0
  60. package/dist/client/assets/dist-J6XWqRpB.js +3 -0
  61. package/dist/client/assets/dist-QzbOCAU6.js +1 -0
  62. package/dist/client/assets/dist-moiMRpw_.js +1 -0
  63. package/dist/client/assets/dist-scBkrwv-.js +2 -0
  64. package/dist/client/assets/dockerfile-BDePf5PZ.js +1 -0
  65. package/dist/client/assets/index-Cn7hdrDw.js +350 -0
  66. package/dist/client/assets/index-UfzqdECL.css +1 -0
  67. package/dist/client/assets/powershell-D8WpQPaX.js +1 -0
  68. package/dist/client/assets/properties-C357ku5U.js +1 -0
  69. package/dist/client/assets/rolldown-runtime-XKyaHtl9.js +1 -0
  70. package/dist/client/assets/ruby-ChfNwlCY.js +1 -0
  71. package/dist/client/assets/shell-DwuoZtxw.js +1 -0
  72. package/dist/client/assets/swift-DKB6_1j6.js +1 -0
  73. package/dist/client/assets/toml-BPTmHmyx.js +1 -0
  74. package/dist/client/favicon.ico +0 -0
  75. package/dist/client/favicon.png +0 -0
  76. package/dist/client/favicon.svg +10 -0
  77. package/dist/client/index.html +18 -0
  78. package/dist/extension.d.ts +15 -0
  79. package/dist/extension.js +126 -0
  80. package/dist/server/active-memory.d.ts +247 -0
  81. package/dist/server/active-memory.js +669 -0
  82. package/dist/server/agents.d.ts +245 -0
  83. package/dist/server/agents.js +701 -0
  84. package/dist/server/application/catalog-service.d.ts +98 -0
  85. package/dist/server/application/catalog-service.js +245 -0
  86. package/dist/server/application/conversation-service.d.ts +245 -0
  87. package/dist/server/application/conversation-service.js +654 -0
  88. package/dist/server/application/document-service.d.ts +68 -0
  89. package/dist/server/application/document-service.js +120 -0
  90. package/dist/server/application/extension-ui-service.d.ts +44 -0
  91. package/dist/server/application/extension-ui-service.js +135 -0
  92. package/dist/server/application/feishu-service.d.ts +179 -0
  93. package/dist/server/application/feishu-service.js +358 -0
  94. package/dist/server/application/group-chat-service.d.ts +75 -0
  95. package/dist/server/application/group-chat-service.js +953 -0
  96. package/dist/server/application/group-execution.d.ts +15 -0
  97. package/dist/server/application/group-execution.js +77 -0
  98. package/dist/server/application/project-service.d.ts +464 -0
  99. package/dist/server/application/project-service.js +2523 -0
  100. package/dist/server/application/provider-service.d.ts +174 -0
  101. package/dist/server/application/provider-service.js +510 -0
  102. package/dist/server/application/run-service.d.ts +547 -0
  103. package/dist/server/application/run-service.js +2683 -0
  104. package/dist/server/application/scheduled-task-service.d.ts +184 -0
  105. package/dist/server/application/scheduled-task-service.js +391 -0
  106. package/dist/server/application/session-orchestrator-service.d.ts +388 -0
  107. package/dist/server/application/session-orchestrator-service.js +1146 -0
  108. package/dist/server/application/session-reminder-service.d.ts +59 -0
  109. package/dist/server/application/session-reminder-service.js +141 -0
  110. package/dist/server/application/session-watchdog.d.ts +171 -0
  111. package/dist/server/application/session-watchdog.js +284 -0
  112. package/dist/server/application/workspace-service.d.ts +52 -0
  113. package/dist/server/application/workspace-service.js +186 -0
  114. package/dist/server/application/worktree-service.d.ts +13 -0
  115. package/dist/server/application/worktree-service.js +76 -0
  116. package/dist/server/browser-access.d.ts +34 -0
  117. package/dist/server/browser-access.js +89 -0
  118. package/dist/server/capability.d.ts +105 -0
  119. package/dist/server/capability.js +170 -0
  120. package/dist/server/command-handler.d.ts +93 -0
  121. package/dist/server/command-handler.js +540 -0
  122. package/dist/server/content-search.d.ts +16 -0
  123. package/dist/server/content-search.js +235 -0
  124. package/dist/server/conversation-usage.d.ts +22 -0
  125. package/dist/server/conversation-usage.js +43 -0
  126. package/dist/server/documents.d.ts +152 -0
  127. package/dist/server/documents.js +998 -0
  128. package/dist/server/engineering-learning.d.ts +30 -0
  129. package/dist/server/engineering-learning.js +106 -0
  130. package/dist/server/exec-service.d.ts +45 -0
  131. package/dist/server/exec-service.js +167 -0
  132. package/dist/server/explicit-file-open.d.ts +34 -0
  133. package/dist/server/explicit-file-open.js +105 -0
  134. package/dist/server/failure-text.d.ts +18 -0
  135. package/dist/server/failure-text.js +44 -0
  136. package/dist/server/feishu-cli.d.ts +223 -0
  137. package/dist/server/feishu-cli.js +464 -0
  138. package/dist/server/file-changes.d.ts +119 -0
  139. package/dist/server/file-changes.js +280 -0
  140. package/dist/server/file-diff.d.ts +41 -0
  141. package/dist/server/file-diff.js +97 -0
  142. package/dist/server/file-index.d.ts +100 -0
  143. package/dist/server/file-index.js +296 -0
  144. package/dist/server/file-name-index.d.ts +160 -0
  145. package/dist/server/file-name-index.js +411 -0
  146. package/dist/server/files.d.ts +269 -0
  147. package/dist/server/files.js +748 -0
  148. package/dist/server/git.d.ts +245 -0
  149. package/dist/server/git.js +903 -0
  150. package/dist/server/http-server.d.ts +45 -0
  151. package/dist/server/http-server.js +3830 -0
  152. package/dist/server/index.d.ts +1 -0
  153. package/dist/server/index.js +485 -0
  154. package/dist/server/inline-thinking.d.ts +90 -0
  155. package/dist/server/inline-thinking.js +181 -0
  156. package/dist/server/json-comments.d.ts +14 -0
  157. package/dist/server/json-comments.js +71 -0
  158. package/dist/server/knowledge-embedding-worker.d.ts +1 -0
  159. package/dist/server/knowledge-embedding-worker.js +27 -0
  160. package/dist/server/knowledge-vectors.d.ts +150 -0
  161. package/dist/server/knowledge-vectors.js +385 -0
  162. package/dist/server/knowledge.d.ts +273 -0
  163. package/dist/server/knowledge.js +848 -0
  164. package/dist/server/length-continuation.d.ts +83 -0
  165. package/dist/server/length-continuation.js +118 -0
  166. package/dist/server/logging.d.ts +32 -0
  167. package/dist/server/logging.js +185 -0
  168. package/dist/server/managed-http-tunnel.d.ts +6 -0
  169. package/dist/server/managed-http-tunnel.js +85 -0
  170. package/dist/server/managed-http.d.ts +4 -0
  171. package/dist/server/managed-http.js +85 -0
  172. package/dist/server/managed-model-adapter.d.ts +17 -0
  173. package/dist/server/managed-model-adapter.js +75 -0
  174. package/dist/server/managed-model-gateway.d.ts +49 -0
  175. package/dist/server/managed-model-gateway.js +73 -0
  176. package/dist/server/managed-servers.d.ts +55 -0
  177. package/dist/server/managed-servers.js +392 -0
  178. package/dist/server/managed-ssh.d.ts +26 -0
  179. package/dist/server/managed-ssh.js +73 -0
  180. package/dist/server/manager-vault.d.ts +11 -0
  181. package/dist/server/manager-vault.js +67 -0
  182. package/dist/server/memory-recall.d.ts +25 -0
  183. package/dist/server/memory-recall.js +45 -0
  184. package/dist/server/memory.d.ts +67 -0
  185. package/dist/server/memory.js +216 -0
  186. package/dist/server/message-media.d.ts +7 -0
  187. package/dist/server/message-media.js +54 -0
  188. package/dist/server/model-context-window.d.ts +186 -0
  189. package/dist/server/model-context-window.js +444 -0
  190. package/dist/server/model-filter.d.ts +23 -0
  191. package/dist/server/model-filter.js +48 -0
  192. package/dist/server/models-store.d.ts +36 -0
  193. package/dist/server/models-store.js +132 -0
  194. package/dist/server/native-tool-settings.d.ts +25 -0
  195. package/dist/server/native-tool-settings.js +41 -0
  196. package/dist/server/native-tools-extension.d.ts +2 -0
  197. package/dist/server/native-tools-extension.js +39 -0
  198. package/dist/server/native-tools-service.d.ts +39 -0
  199. package/dist/server/native-tools-service.js +240 -0
  200. package/dist/server/persistence/app-state-repository.d.ts +65 -0
  201. package/dist/server/persistence/app-state-repository.js +1 -0
  202. package/dist/server/persistence/json-state-repository.d.ts +14 -0
  203. package/dist/server/persistence/json-state-repository.js +43 -0
  204. package/dist/server/persistence/open-state-store.d.ts +3 -0
  205. package/dist/server/persistence/open-state-store.js +35 -0
  206. package/dist/server/persistence/rename.d.ts +22 -0
  207. package/dist/server/persistence/rename.js +44 -0
  208. package/dist/server/persistence/sqlite-state-repository.d.ts +12 -0
  209. package/dist/server/persistence/sqlite-state-repository.js +264 -0
  210. package/dist/server/pi-command.d.ts +94 -0
  211. package/dist/server/pi-command.js +265 -0
  212. package/dist/server/pi-native.d.ts +12 -0
  213. package/dist/server/pi-native.js +16 -0
  214. package/dist/server/pi-session-events.d.ts +158 -0
  215. package/dist/server/pi-session-events.js +373 -0
  216. package/dist/server/pi-session-pool.d.ts +233 -0
  217. package/dist/server/pi-session-pool.js +382 -0
  218. package/dist/server/pi-session.d.ts +642 -0
  219. package/dist/server/pi-session.js +655 -0
  220. package/dist/server/presentations/schema.d.ts +120 -0
  221. package/dist/server/presentations/schema.js +128 -0
  222. package/dist/server/provider-network.d.ts +16 -0
  223. package/dist/server/provider-network.js +106 -0
  224. package/dist/server/provider-proxy.d.ts +18 -0
  225. package/dist/server/provider-proxy.js +200 -0
  226. package/dist/server/providers.d.ts +333 -0
  227. package/dist/server/providers.js +989 -0
  228. package/dist/server/remote-bootstrap.d.ts +17 -0
  229. package/dist/server/remote-bootstrap.js +119 -0
  230. package/dist/server/rpc-channel.d.ts +131 -0
  231. package/dist/server/rpc-channel.js +135 -0
  232. package/dist/server/runtime.d.ts +1393 -0
  233. package/dist/server/runtime.js +3286 -0
  234. package/dist/server/scheduled-tasks.d.ts +101 -0
  235. package/dist/server/scheduled-tasks.js +138 -0
  236. package/dist/server/server-context.d.ts +119 -0
  237. package/dist/server/server-context.js +1 -0
  238. package/dist/server/session-cwd.d.ts +19 -0
  239. package/dist/server/session-cwd.js +58 -0
  240. package/dist/server/session-ledger.d.ts +67 -0
  241. package/dist/server/session-ledger.js +76 -0
  242. package/dist/server/session-memory-scope.d.ts +4 -0
  243. package/dist/server/session-memory-scope.js +30 -0
  244. package/dist/server/session-repository.d.ts +100 -0
  245. package/dist/server/session-repository.js +246 -0
  246. package/dist/server/session-tree-scope.d.ts +125 -0
  247. package/dist/server/session-tree-scope.js +337 -0
  248. package/dist/server/skills.d.ts +23 -0
  249. package/dist/server/skills.js +190 -0
  250. package/dist/server/store.d.ts +1062 -0
  251. package/dist/server/store.js +3305 -0
  252. package/dist/server/subagent-runs.d.ts +185 -0
  253. package/dist/server/subagent-runs.js +383 -0
  254. package/dist/server/subagents.d.ts +200 -0
  255. package/dist/server/subagents.js +619 -0
  256. package/dist/server/task-tool.d.ts +282 -0
  257. package/dist/server/task-tool.js +507 -0
  258. package/dist/server/tavily.d.ts +32 -0
  259. package/dist/server/tavily.js +136 -0
  260. package/dist/server/team-context.d.ts +12 -0
  261. package/dist/server/team-context.js +180 -0
  262. package/dist/server/terminal.d.ts +163 -0
  263. package/dist/server/terminal.js +557 -0
  264. package/dist/server/thinking-level-discovery.d.ts +38 -0
  265. package/dist/server/thinking-level-discovery.js +183 -0
  266. package/dist/server/time-zone.d.ts +20 -0
  267. package/dist/server/time-zone.js +32 -0
  268. package/dist/server/tool-calls.d.ts +130 -0
  269. package/dist/server/tool-calls.js +341 -0
  270. package/dist/server/tool-llm.d.ts +72 -0
  271. package/dist/server/tool-llm.js +146 -0
  272. package/dist/server/tool-registry.d.ts +129 -0
  273. package/dist/server/tool-registry.js +249 -0
  274. package/dist/server/tool-runner.d.ts +112 -0
  275. package/dist/server/tool-runner.js +306 -0
  276. package/dist/server/turn-failure.d.ts +48 -0
  277. package/dist/server/turn-failure.js +148 -0
  278. package/dist/server/types.d.ts +2315 -0
  279. package/dist/server/types.js +11 -0
  280. package/dist/server/update-status.d.ts +14 -0
  281. package/dist/server/update-status.js +69 -0
  282. package/dist/server/update.d.ts +46 -0
  283. package/dist/server/update.js +104 -0
  284. package/dist/server/upload.d.ts +35 -0
  285. package/dist/server/upload.js +177 -0
  286. package/dist/server/version.d.ts +33 -0
  287. package/dist/server/version.js +111 -0
  288. package/dist/server/web.d.ts +27 -0
  289. package/dist/server/web.js +183 -0
  290. package/dist/server/workflow-engine.d.ts +47 -0
  291. package/dist/server/workflow-engine.js +255 -0
  292. package/dist/server/workflow.d.ts +329 -0
  293. package/dist/server/workflow.js +469 -0
  294. package/dist/server/workspace-file-indexes.d.ts +2 -0
  295. package/dist/server/workspace-file-indexes.js +61 -0
  296. package/dist/server/workspace-file-operations.d.ts +36 -0
  297. package/dist/server/workspace-file-operations.js +281 -0
  298. package/dist/server/workspace-file-response.d.ts +7 -0
  299. package/dist/server/workspace-file-response.js +79 -0
  300. package/dist/server/ws-server.d.ts +149 -0
  301. package/dist/server/ws-server.js +640 -0
  302. package/dist/shared/agent-order.d.ts +44 -0
  303. package/dist/shared/agent-order.js +50 -0
  304. package/dist/shared/archive-decisions.d.ts +44 -0
  305. package/dist/shared/archive-decisions.js +98 -0
  306. package/dist/shared/background-task.d.ts +25 -0
  307. package/dist/shared/background-task.js +183 -0
  308. package/dist/shared/child-session-lock.d.ts +37 -0
  309. package/dist/shared/child-session-lock.js +59 -0
  310. package/dist/shared/content-search.d.ts +22 -0
  311. package/dist/shared/content-search.js +1 -0
  312. package/dist/shared/conversation-title.d.ts +4 -0
  313. package/dist/shared/conversation-title.js +4 -0
  314. package/dist/shared/file-mentions.d.ts +17 -0
  315. package/dist/shared/file-mentions.js +91 -0
  316. package/dist/shared/git-commit.d.ts +11 -0
  317. package/dist/shared/git-commit.js +1 -0
  318. package/dist/shared/git-graph.d.ts +42 -0
  319. package/dist/shared/git-graph.js +30 -0
  320. package/dist/shared/group-chat.d.ts +132 -0
  321. package/dist/shared/group-chat.js +6 -0
  322. package/dist/shared/managed-servers.d.ts +36 -0
  323. package/dist/shared/managed-servers.js +1 -0
  324. package/dist/shared/message-media.d.ts +12 -0
  325. package/dist/shared/message-media.js +27 -0
  326. package/dist/shared/model-window-label.d.ts +39 -0
  327. package/dist/shared/model-window-label.js +55 -0
  328. package/dist/shared/native-tools.d.ts +43 -0
  329. package/dist/shared/native-tools.js +1 -0
  330. package/dist/shared/pi-cache-warming.d.ts +9 -0
  331. package/dist/shared/pi-cache-warming.js +4 -0
  332. package/dist/shared/project-overview.d.ts +107 -0
  333. package/dist/shared/project-overview.js +92 -0
  334. package/dist/shared/project-presentation.d.ts +55 -0
  335. package/dist/shared/project-presentation.js +111 -0
  336. package/dist/shared/provider-network.d.ts +30 -0
  337. package/dist/shared/provider-network.js +1 -0
  338. package/dist/shared/session-reporting.d.ts +40 -0
  339. package/dist/shared/session-reporting.js +97 -0
  340. package/dist/shared/session-search.d.ts +14 -0
  341. package/dist/shared/session-search.js +1 -0
  342. package/dist/shared/team-context-view.d.ts +33 -0
  343. package/dist/shared/team-context-view.js +49 -0
  344. package/dist/shared/team-context.d.ts +59 -0
  345. package/dist/shared/team-context.js +3 -0
  346. package/dist/shared/terminal-protocol.d.ts +71 -0
  347. package/dist/shared/terminal-protocol.js +1 -0
  348. package/dist/shared/thinking-levels.d.ts +53 -0
  349. package/dist/shared/thinking-levels.js +85 -0
  350. package/dist/shared/tool-glyph.d.ts +7 -0
  351. package/dist/shared/tool-glyph.js +19 -0
  352. package/dist/shared/transcript-order.d.ts +7 -0
  353. package/dist/shared/transcript-order.js +12 -0
  354. package/dist/shared/update-status.d.ts +28 -0
  355. package/dist/shared/update-status.js +1 -0
  356. package/dist/shared/workspace-file-preview.d.ts +4 -0
  357. package/dist/shared/workspace-file-preview.js +28 -0
  358. package/package.json +448 -4
  359. package/scripts/diagnose.mjs +603 -0
  360. package/scripts/patch-brace-expansion.mjs +260 -0
  361. package/scripts/restart-server.mjs +104 -0
  362. package/skills/presentation/SKILL.md +30 -0
  363. package/skills/presentation/references/data.md +10 -0
  364. package/skills/presentation/references/quality.md +12 -0
  365. package/skills/presentation/references/story.md +12 -0
  366. package/skills/presentation/references/templates-and-editing.md +11 -0
  367. package/skills/presentation/references/visual-system.md +10 -0
  368. package/skills/super-pi-agent-development/SKILL.md +25 -0
  369. package/skills/super-pi-development/SKILL.md +31 -0
  370. package/skills/super-pi-tool-development/SKILL.md +39 -0
@@ -0,0 +1,26 @@
1
+ import type { Client, ClientChannel, SFTPWrapper } from "ssh2";
2
+ export interface SshProfile {
3
+ host: string;
4
+ port: number;
5
+ username: string;
6
+ authentication: "agent" | "password" | "privateKey";
7
+ password?: string;
8
+ privateKey?: string;
9
+ identityFile?: string;
10
+ passphrase?: string;
11
+ fingerprint?: string;
12
+ }
13
+ export declare class HostTrustRequired extends Error {
14
+ readonly fingerprint: string;
15
+ readonly changed: boolean;
16
+ constructor(fingerprint: string, changed: boolean);
17
+ }
18
+ export declare const sh: (value: string) => string;
19
+ export declare function connectSsh(profile: SshProfile): Promise<Client>;
20
+ export declare function sshExec(client: Client, command: string, options?: {
21
+ timeout?: number;
22
+ onOutput?: (chunk: string) => void;
23
+ }): Promise<string>;
24
+ export declare const sshSftp: (client: Client) => Promise<SFTPWrapper>;
25
+ export declare function sshWrite(client: Client, path: string, data: string | Buffer, mode?: number): Promise<void>;
26
+ export declare const sshForward: (client: Client, port: number) => Promise<ClientChannel>;
@@ -0,0 +1,73 @@
1
+ import { createHash } from "node:crypto";
2
+ import { readFile } from "node:fs/promises";
3
+ export class HostTrustRequired extends Error {
4
+ fingerprint;
5
+ changed;
6
+ constructor(fingerprint, changed) {
7
+ super(changed ? "SSH 主机指纹发生变化,已拒绝连接" : "请确认 SSH 主机指纹后继续");
8
+ this.fingerprint = fingerprint;
9
+ this.changed = changed;
10
+ }
11
+ }
12
+ export const sh = (value) => `'${value.replaceAll("'", "'\\''")}'`;
13
+ export async function connectSsh(profile) {
14
+ const { Client } = await import("ssh2");
15
+ const client = new Client();
16
+ let observed = "";
17
+ let trusted = false;
18
+ const settings = {
19
+ host: profile.host, port: profile.port, username: profile.username,
20
+ readyTimeout: 20_000, keepaliveInterval: 15_000, keepaliveCountMax: 3,
21
+ hostVerifier: (key) => {
22
+ observed = `SHA256:${createHash("sha256").update(key).digest("base64").replace(/=+$/, "")}`;
23
+ trusted = profile.fingerprint === observed;
24
+ return trusted;
25
+ },
26
+ };
27
+ if (profile.authentication === "password")
28
+ settings.password = profile.password;
29
+ else if (profile.authentication === "privateKey") {
30
+ settings.privateKey = profile.privateKey || (profile.identityFile ? await readFile(profile.identityFile) : undefined);
31
+ settings.passphrase = profile.passphrase;
32
+ }
33
+ else
34
+ settings.agent = process.env.SSH_AUTH_SOCK || (process.platform === "win32" ? "\\\\.\\pipe\\openssh-ssh-agent" : undefined);
35
+ return new Promise((resolve, reject) => {
36
+ client.once("ready", () => { client.removeListener("error", failed); client.on("error", () => { }); resolve(client); });
37
+ const failed = (error) => { client.end(); reject(observed && !trusted ? new HostTrustRequired(observed, Boolean(profile.fingerprint)) : new Error(error.level === "client-authentication" ? "SSH 认证失败,请检查用户名和认证信息" : "SSH 连接失败,请检查地址、端口、网络和认证信息")); };
38
+ client.once("error", failed);
39
+ client.connect(settings);
40
+ });
41
+ }
42
+ export function sshExec(client, command, options = {}) {
43
+ return new Promise((resolve, reject) => {
44
+ let channel, output = "", error = "";
45
+ const timer = setTimeout(() => { channel?.close(); reject(new Error("远端命令超时,请检查部署进度后重试")); }, options.timeout ?? 30_000);
46
+ client.exec(command, (failure, stream) => {
47
+ if (failure) {
48
+ clearTimeout(timer);
49
+ reject(new Error("无法启动远端命令"));
50
+ return;
51
+ }
52
+ channel = stream;
53
+ stream.on("data", (chunk) => { output = (output + chunk.toString()).slice(-256_000); options.onOutput?.(chunk.toString()); });
54
+ stream.stderr.on("data", (chunk) => { error = (error + chunk.toString()).slice(-32_000); options.onOutput?.(chunk.toString()); });
55
+ stream.once("close", (code) => { clearTimeout(timer); if (code === 0)
56
+ resolve(output);
57
+ else
58
+ reject(new Error(`远端命令失败(exit ${code ?? "unknown"})${error ? ",请查看部署日志" : ""}`)); });
59
+ stream.once("error", () => { clearTimeout(timer); reject(new Error("SSH 命令通道中断")); });
60
+ });
61
+ });
62
+ }
63
+ export const sshSftp = (client) => new Promise((resolve, reject) => client.sftp((error, sftp) => error ? reject(new Error("无法打开 SFTP 通道")) : resolve(sftp)));
64
+ export async function sshWrite(client, path, data, mode = 0o600) {
65
+ const sftp = await sshSftp(client);
66
+ try {
67
+ await new Promise((resolve, reject) => sftp.writeFile(path, data, { mode }, error => error ? reject(new Error("无法写入远端托管文件")) : resolve()));
68
+ }
69
+ finally {
70
+ sftp.end();
71
+ }
72
+ }
73
+ export const sshForward = (client, port) => new Promise((resolve, reject) => client.forwardOut("127.0.0.1", 0, "127.0.0.1", port, (error, channel) => error ? reject(new Error("远端 Super Pi 端口不可达,请检查服务是否已启动")) : resolve(channel)));
@@ -0,0 +1,11 @@
1
+ /** Authentication material is kept outside public connection records and encrypted at rest. */
2
+ export declare class ManagerVault {
3
+ private readonly directory;
4
+ private key?;
5
+ private keyLoading?;
6
+ constructor(directory: string);
7
+ private encryptionKey;
8
+ private loadEncryptionKey;
9
+ read<T>(id: string): Promise<T | undefined>;
10
+ write(id: string, value: unknown): Promise<void>;
11
+ }
@@ -0,0 +1,67 @@
1
+ import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
2
+ import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
3
+ import { join } from "node:path";
4
+ /** Authentication material is kept outside public connection records and encrypted at rest. */
5
+ export class ManagerVault {
6
+ directory;
7
+ key;
8
+ keyLoading;
9
+ constructor(directory) {
10
+ this.directory = directory;
11
+ }
12
+ async encryptionKey() {
13
+ if (this.key)
14
+ return this.key;
15
+ this.keyLoading ??= this.loadEncryptionKey().catch(error => { this.keyLoading = undefined; throw error; });
16
+ return this.keyLoading;
17
+ }
18
+ async loadEncryptionKey() {
19
+ await mkdir(this.directory, { recursive: true, mode: 0o700 });
20
+ const path = join(this.directory, "manager.key");
21
+ try {
22
+ this.key = await readFile(path);
23
+ }
24
+ catch (error) {
25
+ if (error.code !== "ENOENT")
26
+ throw error;
27
+ const key = randomBytes(32);
28
+ try {
29
+ await writeFile(path, key, { mode: 0o600, flag: "wx" });
30
+ this.key = key;
31
+ }
32
+ catch (error) {
33
+ if (error.code !== "EEXIST")
34
+ throw error;
35
+ this.key = await readFile(path);
36
+ }
37
+ }
38
+ if (this.key.length !== 32)
39
+ throw new Error("本地认证存储损坏,请恢复管理服务的数据目录");
40
+ return this.key;
41
+ }
42
+ async read(id) {
43
+ if (!/^[a-zA-Z0-9-]+$/.test(id))
44
+ throw new Error("认证记录标识无效");
45
+ const key = await this.encryptionKey();
46
+ try {
47
+ const raw = JSON.parse(await readFile(join(this.directory, `${id}.secret`), "utf8"));
48
+ const decipher = createDecipheriv("aes-256-gcm", key, Buffer.from(raw.iv, "base64"));
49
+ decipher.setAuthTag(Buffer.from(raw.tag, "base64"));
50
+ return JSON.parse(Buffer.concat([decipher.update(Buffer.from(raw.data, "base64")), decipher.final()]).toString("utf8"));
51
+ }
52
+ catch (error) {
53
+ if (error.code === "ENOENT")
54
+ return;
55
+ throw new Error("无法解密本地 SSH 认证资料");
56
+ }
57
+ }
58
+ async write(id, value) {
59
+ if (!/^[a-zA-Z0-9-]+$/.test(id))
60
+ throw new Error("认证记录标识无效");
61
+ const key = await this.encryptionKey(), iv = randomBytes(12), cipher = createCipheriv("aes-256-gcm", key, iv);
62
+ const encrypted = Buffer.concat([cipher.update(JSON.stringify(value)), cipher.final()]);
63
+ const path = join(this.directory, `${id}.secret`), temp = `${path}.tmp`;
64
+ await writeFile(temp, JSON.stringify({ iv: iv.toString("base64"), tag: cipher.getAuthTag().toString("base64"), data: encrypted.toString("base64") }), { mode: 0o600 });
65
+ await rename(temp, path);
66
+ }
67
+ }
@@ -0,0 +1,25 @@
1
+ import { type MemoryEntry, type MemoryTarget } from "./memory.js";
2
+ /** UTF-8 bytes are a conservative upper bound for byte-fallback tokenizers, including Chinese. */
3
+ export declare const memoryTokenCost: (value: string) => number;
4
+ export declare const DEFAULT_MEMORY_BUDGET = 6000;
5
+ export declare const memoryTerms: (value: string) => string[];
6
+ export declare function experienceMode(value: string): "quick-fix" | "rigorous" | undefined;
7
+ export declare function recallMemory(groups: Partial<Record<MemoryTarget, MemoryEntry[]>>, query: string, budget: number, context?: {
8
+ workspaceId?: string;
9
+ mode?: ReturnType<typeof experienceMode>;
10
+ browse?: boolean;
11
+ }): {
12
+ notes: string;
13
+ selected: number;
14
+ entries: {
15
+ target: string;
16
+ id: string;
17
+ content: string;
18
+ revision: number;
19
+ sourceConversationId: string;
20
+ sourceMessageId?: string;
21
+ experience?: MemoryEntry["experience"];
22
+ pinned: boolean;
23
+ }[];
24
+ omitted: number;
25
+ };
@@ -0,0 +1,45 @@
1
+ import { MEMORY_GUIDANCE } from "./memory.js";
2
+ /** UTF-8 bytes are a conservative upper bound for byte-fallback tokenizers, including Chinese. */
3
+ export const memoryTokenCost = (value) => Buffer.byteLength(value, "utf8");
4
+ export const DEFAULT_MEMORY_BUDGET = 6000;
5
+ export const memoryTerms = (value) => {
6
+ const words = value.normalize("NFKC").toLocaleLowerCase().match(/[\p{L}\p{N}_-]{2,}/gu) ?? [];
7
+ // Chinese prose has no spaces: add bigrams so two related sentences can actually match.
8
+ const cjk = value.match(/[\p{Script=Han}]{2,}/gu) ?? [];
9
+ return [...new Set([...words, ...cjk.flatMap(word => Array.from({ length: word.length - 1 }, (_, i) => word.slice(i, i + 2)))])];
10
+ };
11
+ export function experienceMode(value) {
12
+ const fast = /\b(?:quick[ -]fix|hotfix|lightweight)\b|快速(?:修复|迭代)|轻量|快修|最小改动/iu.test(value);
13
+ const rigorous = /\b(?:long[ -](?:lived|term)|rigorous|large[ -]project)\b|长期维护|大型?项目|严谨|规范设计|单测维护/iu.test(value);
14
+ return fast === rigorous ? undefined : fast ? "quick-fix" : "rigorous";
15
+ }
16
+ export function recallMemory(groups, query, budget, context) {
17
+ const words = memoryTerms(query).slice(0, 128);
18
+ const mode = experienceMode(query) ?? context?.mode;
19
+ const ranked = Object.entries(groups).flatMap(([target, entries]) => (entries ?? []).filter(entry => !entry.archivedAt).map(entry => {
20
+ const source = entry.experience;
21
+ const text = [entry.content, source?.applicability, source?.projectName, source?.workspaceName].filter(Boolean).join(" ").normalize("NFKC").toLocaleLowerCase();
22
+ const relevance = words.reduce((sum, word) => sum + (text.includes(word) ? 1 : 0), 0);
23
+ const priority = target === "user" ? 5 : target === "tree" ? 4 : target === "session" ? 3 : target === "role" ? 2 : 1;
24
+ const sourceMode = source && (experienceMode(source.applicability) ?? experienceMode(entry.content));
25
+ const fit = relevance && mode && sourceMode ? (mode === sourceMode ? 160 : -160) : 0;
26
+ const local = Boolean(source && context?.workspaceId === source.workspaceId);
27
+ const pinned = Boolean(entry.pinned && (!source || ((relevance > 0 || local || source.applicability === "用户明确要求跨项目遵守") && fit >= 0)));
28
+ return { target, entry, score: relevance * 100 + priority + fit + (local ? 10 : 0), relevance, pinned, local };
29
+ })).sort((a, b) => Number(b.pinned) - Number(a.pinned)
30
+ || b.score - a.score || (b.entry.updatedAt ?? b.entry.createdAt).localeCompare(a.entry.updatedAt ?? a.entry.createdAt));
31
+ const selected = [];
32
+ const render = () => `${MEMORY_GUIDANCE}\n<persistent-memory-data>\n${JSON.stringify(selected)}\n</persistent-memory-data>`;
33
+ for (const { target, entry, relevance, pinned, local } of ranked) {
34
+ if (target === "experience" && !context?.browse && !local && !pinned && !relevance)
35
+ continue;
36
+ // Keep a small recent/core fallback; relevance determines access to the rest of the archive.
37
+ if (words.length && !relevance && !pinned && (context?.browse || selected.length >= 4))
38
+ continue;
39
+ const item = { target, id: entry.id, content: target === "skills" ? entry.content.split("\n")[0] : entry.content, revision: entry.revision ?? 1, sourceConversationId: entry.conversationId, sourceMessageId: entry.sourceMessageId, experience: entry.experience, pinned: !!entry.pinned };
40
+ selected.push(item);
41
+ if (memoryTokenCost(render()) > budget)
42
+ selected.pop();
43
+ }
44
+ return { notes: render(), selected: selected.length, entries: selected, omitted: ranked.length - selected.length };
45
+ }
@@ -0,0 +1,67 @@
1
+ export declare const MEMORY_LIMITS: {
2
+ user: number;
3
+ memory: number;
4
+ experience: number;
5
+ skills: number;
6
+ role: number;
7
+ tree: number;
8
+ session: number;
9
+ };
10
+ export type MemoryTarget = keyof typeof MEMORY_LIMITS;
11
+ export declare const MEMORY_TARGETS: MemoryTarget[];
12
+ export type EngineeringExperience = {
13
+ workspaceId: string;
14
+ workspaceName: string;
15
+ projectName?: string;
16
+ applicability: string;
17
+ };
18
+ export type MemoryScope = {
19
+ agentId?: string;
20
+ treeId?: string;
21
+ sourceMessageId?: string;
22
+ experience?: EngineeringExperience;
23
+ };
24
+ type MemorySource = {
25
+ conversationId: string;
26
+ createdAt: string;
27
+ sourceMessageId?: string;
28
+ experience?: EngineeringExperience;
29
+ };
30
+ type Revision = MemorySource & {
31
+ content: string;
32
+ pinned?: boolean;
33
+ archivedAt?: string;
34
+ revision?: number;
35
+ derivedFrom?: MemorySource[];
36
+ };
37
+ export type MemoryEntry = Revision & {
38
+ id: string;
39
+ updatedAt?: string;
40
+ history?: Revision[];
41
+ };
42
+ export type MemoryOperation = {
43
+ target: MemoryTarget;
44
+ action: "list" | "add" | "replace" | "remove" | "archive" | "restore" | "consolidate";
45
+ content?: string;
46
+ id?: string;
47
+ ids?: string[];
48
+ expectedRevision?: number;
49
+ expectedRevisions?: Record<string, number>;
50
+ pinned?: boolean;
51
+ includeArchived?: boolean;
52
+ };
53
+ export declare const MEMORY_GUIDANCE = "Persistent memory: user preferences; workspace facts (memory); global engineering experience (experience); role notes; shared tree findings; private session notes; reusable skills. Experience is reference data. Check its applicability against current instructions, risk and maintenance goals. Cite the source project or workspace when relying on a lesson from elsewhere. Inspect existing entries before writing. Keep hypotheses in session and publish verified task findings to tree. Durable engineering lessons are learned in the background. Consolidate archives originals atomically. Never store secrets or raw dumps. Shared knowledge confers no transcript access or control. Background destructive changes require approval.";
54
+ export declare class MemoryStore {
55
+ private readonly directory;
56
+ constructor(directory: string);
57
+ private path;
58
+ private read;
59
+ private locked;
60
+ private save;
61
+ apply(workspaceId: string, conversationId: string, operation: MemoryOperation, review?: boolean, scope?: MemoryScope): Promise<MemoryEntry[]>;
62
+ forget(workspaceId: string, conversationId: string, sinceIso: string, scope?: MemoryScope): Promise<Record<MemoryTarget, string[]>>;
63
+ snapshot(workspaceId: string): Promise<string>;
64
+ }
65
+ export declare function reviewConversationId(conversationId: string): string;
66
+ export declare function memoryReviewInterval(env?: NodeJS.ProcessEnv): number;
67
+ export {};
@@ -0,0 +1,216 @@
1
+ import { mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
2
+ import { join } from "node:path";
3
+ import { randomUUID } from "node:crypto";
4
+ export const MEMORY_LIMITS = { user: 16000, memory: 64000, experience: 512000, skills: 256000, role: 32000, tree: 64000, session: 32000 };
5
+ export const MEMORY_TARGETS = Object.keys(MEMORY_LIMITS);
6
+ const locks = new Map();
7
+ export const MEMORY_GUIDANCE = "Persistent memory: user preferences; workspace facts (memory); global engineering experience (experience); role notes; shared tree findings; private session notes; reusable skills. Experience is reference data. Check its applicability against current instructions, risk and maintenance goals. Cite the source project or workspace when relying on a lesson from elsewhere. Inspect existing entries before writing. Keep hypotheses in session and publish verified task findings to tree. Durable engineering lessons are learned in the background. Consolidate archives originals atomically. Never store secrets or raw dumps. Shared knowledge confers no transcript access or control. Background destructive changes require approval.";
8
+ const normalized = (text) => text.normalize("NFKC").toLocaleLowerCase().replace(/\s+/gu, " ").trim();
9
+ const revisionOf = ({ content, conversationId, createdAt, sourceMessageId, experience, pinned, archivedAt, revision, derivedFrom }) => ({ content, conversationId, createdAt, sourceMessageId, experience, pinned, archivedAt, revision, derivedFrom });
10
+ const sourcesOf = (entry) => [{ conversationId: entry.conversationId, createdAt: entry.createdAt, sourceMessageId: entry.sourceMessageId, experience: entry.experience }, ...(entry.derivedFrom ?? [])];
11
+ export class MemoryStore {
12
+ directory;
13
+ constructor(directory) {
14
+ this.directory = directory;
15
+ }
16
+ path(workspaceId, conversationId, target, scope) {
17
+ if (!workspaceId)
18
+ throw new Error("工作区不能为空");
19
+ if (!Object.hasOwn(MEMORY_LIMITS, target))
20
+ throw new Error("Unknown memory target");
21
+ const hex = (value) => Buffer.from(value).toString("hex");
22
+ if (target === "user")
23
+ return join(this.directory, "user.json");
24
+ if (target === "experience")
25
+ return join(this.directory, "engineering-experience.json");
26
+ let suffix = "";
27
+ if (target === "role") {
28
+ if (!scope.agentId)
29
+ throw new Error("当前会话未选择角色");
30
+ suffix = `-${hex(scope.agentId)}`;
31
+ }
32
+ if (target === "tree") {
33
+ if (!scope.treeId)
34
+ throw new Error("会话树身份缺失");
35
+ suffix = `-${hex(scope.treeId)}`;
36
+ }
37
+ if (target === "session") {
38
+ if (!conversationId)
39
+ throw new Error("会话身份缺失");
40
+ suffix = `-${hex(conversationId)}`;
41
+ }
42
+ return join(this.directory, `${hex(workspaceId)}-${target}${suffix}.json`);
43
+ }
44
+ async read(path) {
45
+ try {
46
+ return JSON.parse(await readFile(path, "utf8"));
47
+ }
48
+ catch (error) {
49
+ if (error.code === "ENOENT")
50
+ return [];
51
+ throw error;
52
+ }
53
+ }
54
+ async locked(path, work) {
55
+ const task = (locks.get(path) ?? Promise.resolve()).catch(() => { }).then(work);
56
+ locks.set(path, task);
57
+ try {
58
+ return await task;
59
+ }
60
+ finally {
61
+ if (locks.get(path) === task)
62
+ locks.delete(path);
63
+ }
64
+ }
65
+ async save(path, entries) {
66
+ await mkdir(this.directory, { recursive: true });
67
+ const temporary = `${path}.${randomUUID()}.tmp`;
68
+ await writeFile(temporary, JSON.stringify(entries, null, 2), { encoding: "utf8", mode: 0o600 });
69
+ await rename(temporary, path);
70
+ }
71
+ async apply(workspaceId, conversationId, operation, review = false, scope = {}) {
72
+ if (!operation || typeof operation !== "object" || (operation.content !== undefined && typeof operation.content !== "string"))
73
+ throw new Error("Invalid memory operation");
74
+ const path = this.path(workspaceId, conversationId, operation.target, scope);
75
+ return this.locked(path, async () => {
76
+ const entries = await this.read(path);
77
+ const visible = () => entries.filter(entry => operation.includeArchived || !entry.archivedAt);
78
+ if (operation.action === "list")
79
+ return visible();
80
+ if (!["add", "replace", "remove", "archive", "restore", "consolidate"].includes(operation.action))
81
+ throw new Error("Unknown memory action");
82
+ if (review && operation.action !== "add")
83
+ throw new Error("后台复盘只能新增记忆;请确认整理提案");
84
+ const content = operation.content?.trim();
85
+ if (["add", "replace", "consolidate"].includes(operation.action) && !content)
86
+ throw new Error("Memory content is required");
87
+ if (operation.pinned !== undefined && typeof operation.pinned !== "boolean")
88
+ throw new Error("Invalid pinned value");
89
+ const stamp = new Date().toISOString();
90
+ const experience = operation.target === "experience" ? scope.experience : undefined;
91
+ const fresh = () => ({ id: randomUUID(), content: content, conversationId, createdAt: stamp, sourceMessageId: scope.sourceMessageId, experience, revision: 1, ...(operation.pinned ? { pinned: true } : {}) });
92
+ if (operation.action === "add") {
93
+ if (entries.some(entry => !entry.archivedAt && normalized(entry.content) === normalized(content)
94
+ && entry.experience?.workspaceId === experience?.workspaceId && entry.experience?.projectName === experience?.projectName
95
+ && normalized(entry.experience?.applicability ?? "") === normalized(experience?.applicability ?? "")))
96
+ return visible();
97
+ entries.push(fresh());
98
+ }
99
+ else if (operation.action === "consolidate") {
100
+ if (!Array.isArray(operation.ids) || new Set(operation.ids).size < 2 || new Set(operation.ids).size !== operation.ids.length)
101
+ throw new Error("整理至少需要两个不同条目");
102
+ const originals = operation.ids.map(id => entries.find(entry => entry.id === id && !entry.archivedAt));
103
+ if (originals.some(entry => !entry))
104
+ throw new Error("原条目已变化,请重新整理");
105
+ if (operation.expectedRevisions && originals.some(entry => operation.expectedRevisions?.[entry.id] !== (entry.revision ?? 1)))
106
+ throw new Error("原条目已变化,请重新读取");
107
+ const sources = originals.flatMap(entry => sourcesOf(entry));
108
+ for (const entry of originals) {
109
+ entry.history = [...(entry.history ?? []), revisionOf(entry)];
110
+ entry.archivedAt = stamp;
111
+ entry.updatedAt = stamp;
112
+ entry.revision = (entry.revision ?? 1) + 1;
113
+ entry.derivedFrom = sources;
114
+ entry.conversationId = conversationId;
115
+ entry.createdAt = stamp;
116
+ entry.sourceMessageId = scope.sourceMessageId;
117
+ }
118
+ entries.push({ ...fresh(), derivedFrom: sources, pinned: operation.pinned ?? originals.some(entry => entry?.pinned) });
119
+ }
120
+ else {
121
+ const index = entries.findIndex(entry => entry.id === operation.id);
122
+ if (index < 0)
123
+ throw new Error("Memory entry no longer exists");
124
+ const entry = entries[index];
125
+ if (operation.expectedRevision !== undefined && operation.expectedRevision !== (entry.revision ?? 1))
126
+ throw new Error("原条目已变化,请重新读取");
127
+ if (operation.action === "remove")
128
+ entries.splice(index, 1);
129
+ else {
130
+ if (operation.action === "replace" && entry.archivedAt)
131
+ throw new Error("请先恢复归档条目");
132
+ entry.history = [...(entry.history ?? []), revisionOf(entry)];
133
+ entry.derivedFrom = sourcesOf(entry);
134
+ entry.revision = (entry.revision ?? 1) + 1;
135
+ entry.updatedAt = stamp;
136
+ entry.conversationId = conversationId;
137
+ entry.createdAt = stamp;
138
+ entry.sourceMessageId = scope.sourceMessageId;
139
+ if (operation.action === "replace") {
140
+ entry.content = content;
141
+ entry.conversationId = conversationId;
142
+ entry.createdAt = stamp;
143
+ entry.sourceMessageId = scope.sourceMessageId;
144
+ if (operation.pinned !== undefined)
145
+ entry.pinned = operation.pinned;
146
+ }
147
+ else if (operation.action === "archive")
148
+ entry.archivedAt = stamp;
149
+ else
150
+ delete entry.archivedAt;
151
+ }
152
+ }
153
+ const used = entries.filter(entry => !entry.archivedAt).reduce((sum, entry) => sum + entry.content.length, 0);
154
+ if (used > MEMORY_LIMITS[operation.target])
155
+ throw new Error(`记忆容量不足:${used}/${MEMORY_LIMITS[operation.target]} 字符;请整理或归档现有条目`);
156
+ await this.save(path, entries);
157
+ return visible();
158
+ });
159
+ }
160
+ async forget(workspaceId, conversationId, sinceIso, scope = {}) {
161
+ const dropped = Object.fromEntries(MEMORY_TARGETS.map(target => [target, []]));
162
+ const since = Date.parse(sinceIso);
163
+ if (!Number.isFinite(since))
164
+ throw new Error("记忆回滚需要一条可解析的时间戳");
165
+ const paths = [];
166
+ for (const target of MEMORY_TARGETS) {
167
+ if ((target === "role" && !scope.agentId) || (target === "tree" && !scope.treeId))
168
+ continue;
169
+ paths.push({ target, path: this.path(workspaceId, conversationId, target, scope) });
170
+ }
171
+ // A conversation can change roles. Revert must also withdraw writes made under an older role.
172
+ const rolePrefix = `${Buffer.from(workspaceId).toString("hex")}-role-`;
173
+ for (const name of await readdir(this.directory).catch(error => { if (error.code === "ENOENT")
174
+ return []; throw error; })) {
175
+ if (name.startsWith(rolePrefix) && name.endsWith(".json")) {
176
+ const path = join(this.directory, name);
177
+ if (!paths.some(item => item.path === path))
178
+ paths.push({ target: "role", path });
179
+ }
180
+ }
181
+ for (const { target, path } of paths) {
182
+ await this.locked(path, async () => {
183
+ const entries = await this.read(path), kept = [];
184
+ const withdrawnSource = (entry) => entry.conversationId === conversationId && Date.parse(entry.createdAt) >= since;
185
+ const withdrawn = (entry) => withdrawnSource(entry) || entry.derivedFrom?.some(withdrawnSource);
186
+ for (const entry of entries) {
187
+ if (!withdrawn(entry)) {
188
+ entry.history = entry.history?.filter(item => !withdrawn(item));
189
+ kept.push(entry);
190
+ continue;
191
+ }
192
+ const history = entry.history?.filter(item => !withdrawn(item)) ?? [];
193
+ const previous = history.pop();
194
+ if (previous)
195
+ kept.push({ ...previous, id: entry.id, history, revision: (entry.revision ?? 1) + 1 });
196
+ else
197
+ dropped[target].push(entry.id);
198
+ }
199
+ await this.save(path, kept);
200
+ });
201
+ }
202
+ return dropped;
203
+ }
204
+ async snapshot(workspaceId) {
205
+ const blocks = await Promise.all(["user", "memory", "skills"].map(async (target) => {
206
+ const entries = await this.apply(workspaceId, "", { target, action: "list" });
207
+ return `${target} (${entries.reduce((n, e) => n + e.content.length, 0)}/${MEMORY_LIMITS[target]} chars):\n${JSON.stringify(entries.map(({ id, content }) => ({ id, content })))}`;
208
+ }));
209
+ return `${MEMORY_GUIDANCE}\n<persistent-memory-data>\n${blocks.join("\n")}\n</persistent-memory-data>`;
210
+ }
211
+ }
212
+ export function reviewConversationId(conversationId) { return `memory-review-${conversationId}-${randomUUID()}`; }
213
+ export function memoryReviewInterval(env = process.env) {
214
+ const value = Number(env.SUPER_PI_MEMORY_REVIEW_INTERVAL ?? 10);
215
+ return Number.isInteger(value) && value >= 0 ? value : 10;
216
+ }
@@ -0,0 +1,7 @@
1
+ /** Resolve against the conversation cwd, including canonical containment for absolute paths and links. */
2
+ export declare function readMessageMedia(root: string, requested: string): Promise<{
3
+ kind: import("../shared/message-media.js").MessageMediaKind;
4
+ mime: string;
5
+ path: string;
6
+ bytes: Buffer<ArrayBuffer>;
7
+ }>;
@@ -0,0 +1,54 @@
1
+ import { open, realpath } from "node:fs/promises";
2
+ import { isAbsolute, relative } from "node:path";
3
+ import { FilesError, resolveInsideRoot } from "./files.js";
4
+ import { localMessageMedia, MAX_MESSAGE_MEDIA_BYTES, messageMediaType } from "../shared/message-media.js";
5
+ /** Resolve against the conversation cwd, including canonical containment for absolute paths and links. */
6
+ export async function readMessageMedia(root, requested) {
7
+ if (!localMessageMedia(requested))
8
+ throw new FilesError(415, "只支持本地图片或 HTML 文件", "unsupported_artifact");
9
+ try {
10
+ const canonicalRoot = await realpath(root);
11
+ const input = requested.replace(/\\/g, "/");
12
+ const candidate = isAbsolute(input) ? relative(canonicalRoot, await realpath(input)) : input;
13
+ const checked = await resolveInsideRoot(canonicalRoot, candidate);
14
+ const path = await realpath(checked);
15
+ await resolveInsideRoot(canonicalRoot, relative(canonicalRoot, path));
16
+ const type = messageMediaType(path);
17
+ if (!type || type.kind !== messageMediaType(requested)?.kind) {
18
+ throw new FilesError(415, "文件实际类型不支持预览", "unsupported_artifact");
19
+ }
20
+ const file = await open(path, "r");
21
+ try {
22
+ const info = await file.stat();
23
+ if (!info.isFile())
24
+ throw new FilesError(400, "预览路径不是文件", "not_a_file");
25
+ if (info.size > MAX_MESSAGE_MEDIA_BYTES)
26
+ throw new FilesError(413, "预览文件超过 20 MB", "too_large");
27
+ // Bound the read even if another process grows the file after stat.
28
+ const bytes = Buffer.alloc(info.size + 1);
29
+ let bytesRead = 0;
30
+ while (bytesRead < bytes.length) {
31
+ const chunk = await file.read(bytes, bytesRead, bytes.length - bytesRead, bytesRead);
32
+ if (!chunk.bytesRead)
33
+ break;
34
+ bytesRead += chunk.bytesRead;
35
+ }
36
+ if (bytesRead > info.size)
37
+ throw new FilesError(409, "文件正在变化,请重新加载", "artifact_changed");
38
+ return { ...type, path: relative(canonicalRoot, path).replace(/\\/g, "/"), bytes: bytes.subarray(0, bytesRead) };
39
+ }
40
+ finally {
41
+ await file.close();
42
+ }
43
+ }
44
+ catch (error) {
45
+ if (error instanceof FilesError)
46
+ throw error;
47
+ const code = error.code;
48
+ if (code === "ENOENT" || code === "ENOTDIR")
49
+ throw new FilesError(404, "预览文件不存在,可能尚未生成或已被移动", "not_found");
50
+ if (code === "EACCES" || code === "EPERM")
51
+ throw new FilesError(403, "没有权限读取预览文件", "denied");
52
+ throw error;
53
+ }
54
+ }