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

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 +250 -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 +396 -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 +450 -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,281 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { lstatSync, mkdirSync, renameSync, rmdirSync, unlinkSync, linkSync } from "node:fs";
3
+ import { lstat, mkdir, mkdtemp, readFile, readdir, realpath, rename, rm, rmdir, stat, writeFile } from "node:fs/promises";
4
+ import { basename, dirname, join } from "node:path";
5
+ import { contains, fileMeta, FilesError, isTextName, resolveInsideRoot, toRelative } from "./files.js";
6
+ const TRASH_DIRECTORY = ".super-pi/file-trash";
7
+ const MAX_INITIAL_CONTENT = 32 * 1024 * 1024;
8
+ const trashIdFormat = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/;
9
+ const writeQueues = new Map();
10
+ export async function serializeWorkspaceWrite(workspace, work) {
11
+ const key = await realpath(workspace);
12
+ const previous = writeQueues.get(key) ?? Promise.resolve();
13
+ const next = previous.catch(() => { }).then(work);
14
+ writeQueues.set(key, next);
15
+ try {
16
+ return await next;
17
+ }
18
+ finally {
19
+ if (writeQueues.get(key) === next)
20
+ writeQueues.delete(key);
21
+ }
22
+ }
23
+ function stringField(body, key) {
24
+ const value = body[key];
25
+ if (typeof value !== "string")
26
+ throw new FilesError(400, `需要 ${key}。`, "bad_request");
27
+ return value;
28
+ }
29
+ function isMissing(error) {
30
+ const code = error.code;
31
+ return code === "ENOENT" || code === "ENOTDIR";
32
+ }
33
+ export function explorerInternalPath(path) {
34
+ const normalized = path.toLowerCase();
35
+ return normalized === TRASH_DIRECTORY || normalized.startsWith(`${TRASH_DIRECTORY}/`);
36
+ }
37
+ function validateName(name) {
38
+ if (!name || name !== name.trim() || name.endsWith(".") || /[<>:"/\\|?*\u0000-\u001f]/.test(name)
39
+ || /^(con|prn|aux|nul|conin\$|conout\$|com[1-9¹²³]|lpt[1-9¹²³])(?:\.|$)/i.test(name)) {
40
+ throw new FilesError(400, "文件名包含不受支持的字符或保留名称。", "invalid_name");
41
+ }
42
+ }
43
+ export async function explorerPath(workspace, root, path, allowRoot = false) {
44
+ const target = await resolveInsideRoot(root, path);
45
+ const rel = toRelative(workspace, target);
46
+ if ((!allowRoot && root === target) || explorerInternalPath(rel)) {
47
+ throw new FilesError(403, "不能操作工作目录本身或应用的回收目录。", "protected_path");
48
+ }
49
+ const canonicalRoot = await realpath(workspace);
50
+ for (let ancestor = target; contains(workspace, ancestor); ancestor = dirname(ancestor)) {
51
+ const existing = await realpath(ancestor).catch((error) => { if (!isMissing(error))
52
+ throw error; });
53
+ if (!existing)
54
+ continue;
55
+ if (explorerInternalPath(toRelative(canonicalRoot, existing)))
56
+ throw new FilesError(403, "不能直接访问应用的回收目录。", "protected_path");
57
+ break;
58
+ }
59
+ return target;
60
+ }
61
+ async function targetAt(workspace, root, parent, name) {
62
+ validateName(name);
63
+ const directory = await explorerPath(workspace, root, parent, true);
64
+ if (!(await stat(directory).catch(() => undefined))?.isDirectory()) {
65
+ throw new FilesError(404, "目标文件夹已不存在。", "missing_directory");
66
+ }
67
+ return explorerPath(workspace, root, toRelative(root, join(directory, name)));
68
+ }
69
+ async function entryInfo(path) {
70
+ const info = await lstat(path).catch((error) => {
71
+ if (isMissing(error))
72
+ throw new FilesError(404, "文件或目录已不存在。", "missing");
73
+ throw error;
74
+ });
75
+ if (!info.isFile() && !info.isDirectory())
76
+ throw new FilesError(415, "此操作只支持普通文件和目录。", "unsupported_entry");
77
+ return info;
78
+ }
79
+ function moveWithoutReplacing(source, destination, directory) {
80
+ try {
81
+ lstatSync(destination);
82
+ throw new FilesError(409, "目标名称已存在。", "already_exists");
83
+ }
84
+ catch (error) {
85
+ if (!isMissing(error))
86
+ throw error;
87
+ }
88
+ if (directory) {
89
+ if (process.platform === "win32")
90
+ renameSync(source, destination);
91
+ else {
92
+ mkdirSync(destination);
93
+ try {
94
+ renameSync(source, destination);
95
+ }
96
+ catch (error) {
97
+ try {
98
+ rmdirSync(destination);
99
+ }
100
+ catch { /* The original error describes the failed move. */ }
101
+ throw error;
102
+ }
103
+ }
104
+ return;
105
+ }
106
+ linkSync(source, destination);
107
+ try {
108
+ unlinkSync(source);
109
+ }
110
+ catch (error) {
111
+ unlinkSync(destination);
112
+ throw error;
113
+ }
114
+ }
115
+ async function trashRoot(workspace, create) {
116
+ const path = await resolveInsideRoot(workspace, TRASH_DIRECTORY);
117
+ const parent = dirname(path);
118
+ if (create) {
119
+ await mkdir(parent).catch((error) => { if (error.code !== "EEXIST")
120
+ throw error; });
121
+ if (!(await lstat(parent)).isDirectory())
122
+ throw new FilesError(403, "无法使用回收目录。", "protected_path");
123
+ await mkdir(path).catch((error) => { if (error.code !== "EEXIST")
124
+ throw error; });
125
+ }
126
+ for (const entry of [parent, path]) {
127
+ const info = await lstat(entry).catch((error) => { if (!isMissing(error))
128
+ throw error; });
129
+ if (info && !info.isDirectory())
130
+ throw new FilesError(403, "无法使用回收目录。", "protected_path");
131
+ }
132
+ return path;
133
+ }
134
+ async function readTrashRecord(workspace, directory, id) {
135
+ if (!trashIdFormat.test(id))
136
+ throw new FilesError(400, "无效的回收项。", "bad_request");
137
+ const entry = join(directory, id);
138
+ const metadata = await resolveInsideRoot(workspace, toRelative(workspace, join(entry, "record.json")));
139
+ if (!(await lstat(entry)).isDirectory() || !(await lstat(metadata)).isFile()) {
140
+ throw new FilesError(404, "回收项已不存在。", "missing");
141
+ }
142
+ const record = JSON.parse(await readFile(metadata, "utf8"));
143
+ if (typeof record.path !== "string" || typeof record.deletedAt !== "string" || typeof record.directory !== "boolean") {
144
+ throw new FilesError(400, "回收记录无效。", "bad_request");
145
+ }
146
+ return record;
147
+ }
148
+ export async function listWorkspaceTrash(workspace, root) {
149
+ const directory = await trashRoot(workspace, false);
150
+ const ids = await readdir(directory).catch((error) => { if (isMissing(error))
151
+ return []; throw error; });
152
+ const records = await Promise.all(ids.filter(id => trashIdFormat.test(id)).map(async (id) => {
153
+ try {
154
+ const record = await readTrashRecord(workspace, directory, id);
155
+ const target = await resolveInsideRoot(workspace, record.path);
156
+ if (target === root || !contains(root, target))
157
+ return;
158
+ await entryInfo(join(directory, id, "item"));
159
+ return { id, ...record, path: toRelative(root, target) };
160
+ }
161
+ catch {
162
+ return;
163
+ }
164
+ }));
165
+ return records.filter(record => record !== undefined).sort((a, b) => b.deletedAt.localeCompare(a.deletedAt));
166
+ }
167
+ export async function mutateWorkspaceTree(workspace, root, body) {
168
+ if (body.action === "restore") {
169
+ const id = stringField(body, "id");
170
+ const directory = await trashRoot(workspace, false);
171
+ const record = await readTrashRecord(workspace, directory, id);
172
+ const rooted = await resolveInsideRoot(workspace, record.path);
173
+ if (!contains(root, rooted))
174
+ throw new FilesError(403, "回收项属于另一个目录。", "outside_workspace");
175
+ const path = await explorerPath(workspace, root, toRelative(root, rooted));
176
+ const source = join(directory, id, "item");
177
+ const info = await entryInfo(source);
178
+ moveWithoutReplacing(source, path, info.isDirectory());
179
+ await rm(join(directory, id, "record.json"), { force: true }).catch(() => { });
180
+ await rmdir(join(directory, id)).catch(() => { });
181
+ return { path: toRelative(root, path), directory: info.isDirectory() };
182
+ }
183
+ if (body.action === "create-file" || body.action === "create-directory") {
184
+ const path = await targetAt(workspace, root, stringField(body, "parent"), stringField(body, "name"));
185
+ const directory = body.action === "create-directory";
186
+ if (directory)
187
+ await mkdir(path);
188
+ else
189
+ await writeFile(path, "", { flag: "wx" });
190
+ return { path: toRelative(root, path), directory, ...(directory ? {} : { text: isTextName(path) }) };
191
+ }
192
+ if (body.action !== "move" && body.action !== "trash")
193
+ throw new FilesError(400, "未知的文件操作。", "bad_request");
194
+ const source = await explorerPath(workspace, root, stringField(body, "path"));
195
+ const info = await entryInfo(source);
196
+ const directory = info.isDirectory();
197
+ const previousPath = toRelative(root, source);
198
+ if (body.action === "trash") {
199
+ // Keep the item and its recovery metadata on the same filesystem.
200
+ if (contains(source, join(workspace, TRASH_DIRECTORY)))
201
+ throw new FilesError(403, "该目录包含回收空间。", "protected_path");
202
+ const trash = await trashRoot(workspace, true);
203
+ const id = randomUUID();
204
+ const entry = join(trash, id);
205
+ await mkdir(entry);
206
+ try {
207
+ const record = { path: toRelative(workspace, source), deletedAt: new Date().toISOString(), directory };
208
+ await writeFile(join(entry, "record.json"), JSON.stringify(record), { flag: "wx" });
209
+ await rename(source, join(entry, "item"));
210
+ }
211
+ catch (error) {
212
+ await rm(join(entry, "record.json"), { force: true }).catch(() => { });
213
+ await rmdir(entry).catch(() => { });
214
+ throw error;
215
+ }
216
+ return { path: previousPath, removed: true, directory, trashId: id };
217
+ }
218
+ const destination = await targetAt(workspace, root, stringField(body, "parent"), stringField(body, "name"));
219
+ if (source === destination)
220
+ return { path: previousPath, directory };
221
+ if (contains(source, join(workspace, TRASH_DIRECTORY)))
222
+ throw new FilesError(403, "该目录包含回收空间。", "protected_path");
223
+ if (process.platform === "win32" && source.toLowerCase() === destination.toLowerCase()) {
224
+ const stage = await mkdtemp(join(dirname(source), ".super-pi-rename-"));
225
+ const parked = join(stage, basename(source));
226
+ try {
227
+ renameSync(source, parked);
228
+ try {
229
+ moveWithoutReplacing(parked, destination, directory);
230
+ }
231
+ catch (error) {
232
+ moveWithoutReplacing(parked, source, directory);
233
+ throw error;
234
+ }
235
+ }
236
+ finally {
237
+ await rmdir(stage).catch(() => { });
238
+ }
239
+ }
240
+ else {
241
+ if (directory && contains(source, destination))
242
+ throw new FilesError(400, "不能把目录移到其子目录中。", "invalid_destination");
243
+ moveWithoutReplacing(source, destination, directory);
244
+ }
245
+ return { path: toRelative(root, destination), previousPath, directory, ...(directory ? {} : { text: isTextName(destination) }) };
246
+ }
247
+ export async function inspectWorkspaceUpload(workspace, root, parent, name) {
248
+ const path = await targetAt(workspace, root, parent, name);
249
+ const info = await lstat(path).catch((error) => { if (!isMissing(error))
250
+ throw error; });
251
+ if (!info)
252
+ return { exists: false };
253
+ if (!info.isFile())
254
+ return { exists: true, replaceable: false };
255
+ return { exists: true, replaceable: true, meta: await fileMeta(path) };
256
+ }
257
+ export async function uploadWorkspaceFile(workspace, root, parent, name, bytes, baseEtag) {
258
+ if (bytes.length > MAX_INITIAL_CONTENT)
259
+ throw new FilesError(413, "单个文件不能超过 32 MB。", "too_large");
260
+ const destination = await targetAt(workspace, root, parent, name);
261
+ const stage = await mkdtemp(join(dirname(destination), ".super-pi-upload-"));
262
+ const stagedFile = join(stage, "item");
263
+ try {
264
+ await writeFile(stagedFile, bytes, { flag: "wx" });
265
+ if (baseEtag) {
266
+ const current = await inspectWorkspaceUpload(workspace, root, parent, name);
267
+ if (!current.replaceable || current.meta?.etag !== baseEtag)
268
+ throw new FilesError(409, "目标文件在上传前已发生变化。", "stale");
269
+ renameSync(stagedFile, destination);
270
+ }
271
+ else {
272
+ moveWithoutReplacing(stagedFile, destination, false);
273
+ }
274
+ return { path: toRelative(root, destination) };
275
+ }
276
+ finally {
277
+ await rm(stagedFile, { force: true }).catch(() => { });
278
+ await rmdir(stage).catch(() => { });
279
+ }
280
+ }
281
+ export { MAX_INITIAL_CONTENT as MAX_WORKSPACE_UPLOAD_BYTES };
@@ -0,0 +1,7 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ type OpenOptions = {
3
+ noFollow?: boolean;
4
+ };
5
+ export declare function readWorkspaceDocumentPreview(path: string, options?: OpenOptions): Promise<import("./documents.js").ExtractResult>;
6
+ export declare function respondWithWorkspaceFile(request: IncomingMessage, response: ServerResponse, path: string, download: boolean, options?: OpenOptions): Promise<void>;
7
+ export {};
@@ -0,0 +1,79 @@
1
+ import { constants } from "node:fs";
2
+ import { open } from "node:fs/promises";
3
+ import { basename } from "node:path";
4
+ import { pipeline } from "node:stream/promises";
5
+ import { workspaceFileMime } from "../shared/workspace-file-preview.js";
6
+ import { FilesError } from "./files.js";
7
+ import { extractTextFromBytes } from "./documents.js";
8
+ const MAX_DOCUMENT_PREVIEW_BYTES = 16 * 1024 * 1024;
9
+ function openWorkspaceAsset(path, { noFollow } = {}) {
10
+ return open(path, constants.O_RDONLY | constants.O_NONBLOCK | (noFollow ? constants.O_NOFOLLOW ?? 0 : 0)).catch((error) => {
11
+ if (error.code === "ENOENT" || error.code === "ENOTDIR")
12
+ throw new FilesError(404, "文件已不存在。", "missing");
13
+ throw error;
14
+ });
15
+ }
16
+ export async function readWorkspaceDocumentPreview(path, options) {
17
+ if (!/\.docx$/i.test(path))
18
+ throw new FilesError(415, "该文件没有文字预览。", "unsupported_entry");
19
+ const handle = await openWorkspaceAsset(path, options);
20
+ try {
21
+ const info = await handle.stat();
22
+ if (!info.isFile())
23
+ throw new FilesError(400, "这个路径不是普通文件。", "not_a_file");
24
+ if (info.size > MAX_DOCUMENT_PREVIEW_BYTES)
25
+ throw new FilesError(413, "文件超过文字预览上限(16 MB)。", "too_large");
26
+ const { buffer, bytesRead } = await handle.read({ buffer: Buffer.alloc(info.size), length: info.size });
27
+ if (bytesRead !== info.size)
28
+ throw new FilesError(409, "文档已变化,请重试。", "stale");
29
+ return await extractTextFromBytes(buffer, "docx");
30
+ }
31
+ finally {
32
+ await handle.close();
33
+ }
34
+ }
35
+ function parseRange(header, size) {
36
+ const match = /^bytes=(\d*)-(\d*)$/.exec(header);
37
+ if (!match || (!match[1] && !match[2]) || size <= 0)
38
+ return;
39
+ const start = match[1] ? Number(match[1]) : Math.max(0, size - Number(match[2]));
40
+ const end = match[1] && match[2] ? Math.min(size - 1, Number(match[2])) : size - 1;
41
+ if (Number.isSafeInteger(start) && Number.isSafeInteger(end) && start <= end)
42
+ return { start, end };
43
+ }
44
+ export async function respondWithWorkspaceFile(request, response, path, download, options) {
45
+ const mime = workspaceFileMime(path);
46
+ if (!download && !mime)
47
+ throw new FilesError(415, "该文件可下载。", "unsupported_entry");
48
+ const handle = await openWorkspaceAsset(path, options);
49
+ try {
50
+ const info = await handle.stat();
51
+ if (!info.isFile())
52
+ throw new FilesError(400, "这个路径不是普通文件。", "not_a_file");
53
+ const range = request.headers.range ? parseRange(request.headers.range, info.size) : undefined;
54
+ const filename = encodeURIComponent(basename(path)).replace(/['()*]/g, character => `%${character.charCodeAt(0).toString(16)}`);
55
+ const headers = {
56
+ "content-type": download ? "application/octet-stream" : mime,
57
+ "content-disposition": `${download ? "attachment" : "inline"}; filename*=UTF-8''${filename}`,
58
+ "x-content-type-options": "nosniff",
59
+ "cross-origin-resource-policy": "same-origin",
60
+ "cache-control": "no-store",
61
+ "accept-ranges": "bytes",
62
+ };
63
+ if (request.headers.range && !range) {
64
+ response.writeHead(416, { ...headers, "content-range": `bytes */${info.size}` }).end();
65
+ return;
66
+ }
67
+ if (range)
68
+ headers["content-range"] = `bytes ${range.start}-${range.end}/${info.size}`;
69
+ headers["content-length"] = range ? range.end - range.start + 1 : info.size;
70
+ response.writeHead(range ? 206 : 200, headers);
71
+ if (request.method === "HEAD" || info.size === 0)
72
+ response.end();
73
+ else
74
+ await pipeline(handle.createReadStream(range ?? { start: 0, end: info.size - 1 }), response).catch(() => response.destroy());
75
+ }
76
+ finally {
77
+ await handle.close().catch(() => { });
78
+ }
79
+ }
@@ -0,0 +1,149 @@
1
+ import type { Server as NodeHttpServer } from "node:http";
2
+ import { WebSocket } from "ws";
3
+ import type { AppState, ServerEvent } from "./types.js";
4
+ import type { EventBroadcaster } from "./server-context.js";
5
+ import type { CommandHandler, SocketSender } from "./command-handler.js";
6
+ import type { CatalogService } from "./application/catalog-service.js";
7
+ import type { BrowserAccess } from "./browser-access.js";
8
+ /**
9
+ * A WebSocket is a live transport, not an unbounded queue. `ws.send()` only
10
+ * copies bytes into the socket's userland buffer; a browser that is frozen or
11
+ * a network peer that has disappeared can therefore make the buffer grow
12
+ * without throwing. Once this threshold is crossed we drop that connection
13
+ * and let the normal close path clean up its resources.
14
+ *
15
+ * AND YET DROPPING IT IS THE WRONG ANSWER FOR A BUSY SERVER. The threshold was
16
+ * written for a peer that has gone away - a frozen tab, a pulled cable. A server
17
+ * that is merely DELIVERING TOO MUCH hits the same number: a sub-agent that
18
+ * streams text emits one `subagent.event` per delta, each of which asks for a
19
+ * full state broadcast, and a browser that cannot parse frames as fast as they
20
+ * arrive lets the buffer grow past the threshold while it is perfectly alive.
21
+ * The browser then reports code 1006 and reconnects, only to be dropped again -
22
+ * "连接中 / 断连 / 连接中" forever - and the user's work is interrupted rather
23
+ * than slowed.
24
+ *
25
+ * So a frame that does not fit is DROPPED, not the connection: the next frame
26
+ * carries the same state, and a browser that is behind will catch up on the next
27
+ * one instead of being disconnected and losing its place. The connection is
28
+ * only terminated when the socket itself is gone (readyState is not OPEN).
29
+ */
30
+ export declare const MAX_WS_BUFFERED_BYTES: number;
31
+ /** Maximum size of one inbound WebSocket message. Attachments are uploaded
32
+ * over HTTP and commands contain references, so multi-megabyte WS frames are
33
+ * almost certainly malformed or abusive. */
34
+ export declare const MAX_WS_PAYLOAD_BYTES: number;
35
+ /**
36
+ * Send one frame without allowing a race with close/error to escape as an
37
+ * uncaught exception. The `ws` package can throw synchronously after the
38
+ * readyState check (for example when a close happens between the two calls),
39
+ * and an unhandled `error` event can otherwise terminate the Node process.
40
+ */
41
+ export declare function safeSend(socket: WebSocket, payload: string): boolean;
42
+ /**
43
+ * Concrete implementation of EventBroadcaster delivering server events
44
+ * across active WebSocket connections.
45
+ */
46
+ export declare class WsBroadcaster implements EventBroadcaster {
47
+ private readonly getState;
48
+ private readonly replay?;
49
+ private readonly sockets;
50
+ private readonly scopes;
51
+ private readonly fileIndexScopes;
52
+ private readonly coalescedSockets;
53
+ private readonly pendingStreams;
54
+ private readonly pendingRuntimeReplays;
55
+ /**
56
+ * DIAGNOSTIC ONLY - sends every requested state frame immediately instead of merging them.
57
+ *
58
+ * The legacy flood switch (`SUPER_PI_LEGACY_SUBAGENT_FLOOD=1`) restores the pre-fix WIRING: one
59
+ * full state broadcast per sub-agent event. But the 150ms merge window would still fold those
60
+ * broadcasts into one frame, so the "before" measurement would not actually be "before" - it
61
+ * would show a flood that the fixed server also survives, and the A/B comparison would prove
62
+ * nothing. This flag removes the window as well, so the probe can reproduce the real pre-fix
63
+ * wire shape: one frame per request, sent at once.
64
+ *
65
+ * Never set outside a probe or a regression test that is asserting the old behaviour.
66
+ */
67
+ private readonly sendStateImmediately;
68
+ constructor(getState: (scope?: {
69
+ conversationId?: string;
70
+ }) => AppState, replay?: ((state: AppState, scope?: {
71
+ conversationId?: string;
72
+ }) => ServerEvent[]) | undefined);
73
+ register(socket: WebSocket, scope?: {
74
+ conversationId?: string;
75
+ }): void;
76
+ unregister(socket: WebSocket): void;
77
+ subscribe(socket: WebSocket, conversationId?: string): void;
78
+ sendState(socket: WebSocket): void;
79
+ private scheduleRuntimeReplay;
80
+ private clearRuntimeReplay;
81
+ subscribeFileIndex(socket: WebSocket, workspaceId?: string, cwd?: string): void;
82
+ private receives;
83
+ configureStreaming(socket: WebSocket, coalesce: boolean): void;
84
+ private flushStreaming;
85
+ private enqueueStreaming;
86
+ getSockets(): Set<WebSocket>;
87
+ broadcast(event: ServerEvent): void;
88
+ /**
89
+ * BROADCAST STATES IN A TIME WINDOW, NOT IN A MICROTASK.
90
+ *
91
+ * The microtask flag this replaces merged only the calls that arrived within the
92
+ * SAME tick. A sub-agent that streams text emits one `subagent.event` per delta,
93
+ * each asking for a full state broadcast, and those deltas arrive across many
94
+ * ticks - so a single sub-agent run could ask for HUNDREDS of full state
95
+ * broadcasts. On a machine whose state is large, that is a flood the browser
96
+ * cannot drain: its parse queue falls behind, the socket buffer grows, and the
97
+ * connection is dropped (the browser reports 1006).
98
+ *
99
+ * A window turns a burst into a handful of frames. The state a browser receives
100
+ * is the LATEST state - the intermediate ones carried nothing the last one did
101
+ * not - so nothing is lost by sending fewer of them. The only thing that
102
+ * changes is how promptly the browser sees a change, and 150ms is below the
103
+ * threshold at which a person notices.
104
+ */
105
+ private stateFlushScheduled;
106
+ broadcastState(): void;
107
+ private flushState;
108
+ /**
109
+ * Releases the pending state window, so a shutting-down server does not hold the event loop
110
+ * open on a timer whose flush would send to sockets that are already closed.
111
+ */
112
+ dispose(): void;
113
+ getStateSnapshot(scope?: {
114
+ conversationId?: string;
115
+ }): AppState;
116
+ }
117
+ export interface WsServerOptions {
118
+ browserAccess?: BrowserAccess;
119
+ managedServers?: import("./managed-servers.js").ManagedServers;
120
+ httpServer: NodeHttpServer;
121
+ broadcaster: WsBroadcaster;
122
+ commandHandler: CommandHandler;
123
+ catalogService: CatalogService;
124
+ accessToken?: string;
125
+ rootDir?: string;
126
+ /** Release subscriptions owned by this connection. */
127
+ onSocketClose?: (sender: SocketSender) => void;
128
+ }
129
+ /**
130
+ * WebSocket transport manager handling upgrade, connection lifecycles, and command dispatch.
131
+ */
132
+ export declare class WsServer {
133
+ private readonly browserAccess?;
134
+ private readonly managedServers?;
135
+ private readonly websocketServer;
136
+ private readonly broadcaster;
137
+ private readonly commandHandler;
138
+ private readonly catalogService;
139
+ private readonly accessToken?;
140
+ private readonly rootDir?;
141
+ private readonly onSocketClose?;
142
+ constructor(options: WsServerOptions);
143
+ private setupUpgrade;
144
+ private setupConnectionHandling;
145
+ /**
146
+ * Gracefully closes all active WebSocket connections and terminates the server.
147
+ */
148
+ close(): void;
149
+ }