@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,382 @@
1
+ /**
2
+ * THE SESSION POOL: one live Pi session per conversation, kept across turns.
3
+ *
4
+ * WHAT IT OWNS. A conversation's Pi session, its fingerprint, and the rule that decides when the live
5
+ * session has gone stale and must be thrown away. Everything that can make a session stale is a
6
+ * FINGERPRINT (see `pi-session.ts`): the agent's prompt, the tool allowlist, the mounted extensions,
7
+ * the workspace, the model. Pi decides all of those when a session is created and cannot change any of
8
+ * them afterwards, so a session whose fingerprint no longer matches the conversation's current
9
+ * requirements is not "slightly wrong" - it is the wrong session, and the only honest response is to
10
+ * replace it.
11
+ *
12
+ * WHY THE POOL IS EXPLICIT ABOUT EVICTING. A session holds a model client, a session file handle and a
13
+ * conversation context. Left alone, a server that has seen fifty conversations would hold fifty of
14
+ * them, and the ones nobody is using would be the ones costing the most memory. So an idle session is
15
+ * evicted after a while, and the conversation's context is not lost with it: Pi writes the transcript
16
+ * to disk, and the next session for that conversation is rebuilt from that file.
17
+ *
18
+ * THE REVERT CASE. `revert` truncates the transcript on disk. A live session's in-memory context does
19
+ * NOT change, and nothing in Pi would notice: the model would keep answering from history the user
20
+ * has withdrawn. So a revert must EVICT the session, and the next turn rebuilds from the truncated
21
+ * file. This is the one case where eviction is not an optimization but a correctness requirement.
22
+ */
23
+ import { existsSync } from "node:fs";
24
+ import { join } from "node:path";
25
+ import { createPiSession, sameFingerprint, superPiExtensionPaths, superPiSkillPaths, } from "./pi-session.js";
26
+ /** How long an idle session survives before it is evicted. */
27
+ const IDLE_EVICTION_MS = 10 * 60_000;
28
+ const MAX_LIVE_SESSIONS = Math.max(4, Number.parseInt(process.env.SUPER_PI_MAX_LIVE_SESSIONS ?? "32", 10) || 32);
29
+ /**
30
+ * The environment variable the session's credential travels in.
31
+ *
32
+ * THE SAME NAME THE EXTENSION READS, written out rather than imported: `agents/` is loaded by Pi's
33
+ * module loader and `src/` by tsc, so an import across the two would resolve differently under each.
34
+ * `scripts/task-tool.test.mjs` asserts that the two copies agree.
35
+ */
36
+ const CAPABILITY_ENV = "SUPER_PI_TASK_CAPABILITY";
37
+ const TOOLS_CAPABILITY_ENV = "SUPER_PI_TOOLS_CAPABILITY";
38
+ /**
39
+ * The pool.
40
+ *
41
+ * One instance per server. It is deliberately not a general-purpose pool: the sessions it holds differ
42
+ * from each other in their agent, their tools and their workspace, so there is nothing to share between
43
+ * them and no reason to try.
44
+ */
45
+ export class PiSessionPool {
46
+ sessionDir;
47
+ repositoryRoot;
48
+ agentDir;
49
+ onSessionDestroyed;
50
+ factory;
51
+ mintCapability;
52
+ modelEpoch;
53
+ mintExtensionTokens;
54
+ sessions = new Map();
55
+ constructor(
56
+ /** Where Pi keeps its session files. */
57
+ sessionDir,
58
+ /** The repository root, for locating Super Pi's own extensions. */
59
+ repositoryRoot,
60
+ /** Pi's global configuration directory, when it is not Pi's own default. */
61
+ agentDir,
62
+ /**
63
+ * Called when a session is destroyed, so the caller can release whatever the session was holding.
64
+ *
65
+ * A session holds a capability: the token its extension read out of the environment when it was
66
+ * loaded. When the session goes, that token must go with it - a credential whose holder no longer
67
+ * exists is exactly the shape the capability model exists to prevent. The pool does not know what a
68
+ * capability is, so it says WHEN and the caller says WHAT.
69
+ */
70
+ onSessionDestroyed,
71
+ /**
72
+ * How a session is built. Injectable so a test can drive a session without a real Pi behind it.
73
+ */
74
+ factory = createPiSession,
75
+ /**
76
+ * Mints the credential the session's extension will hold. Injected rather than imported so the pool
77
+ * does not have to know what a capability is - it needs to know WHEN one is needed, and the caller
78
+ * knows what one looks like.
79
+ */
80
+ mintCapability = () => "",
81
+ /**
82
+ * How many times the set of models Pi knows about has changed.
83
+ *
84
+ * Injected rather than imported for the same reason the capability minting is: the pool needs to
85
+ * know WHEN a session is stale, and the caller knows what changed. A provider added through the
86
+ * settings window makes every live session unable to reach the new model, and the next turn is
87
+ * where that gets fixed.
88
+ */
89
+ modelEpoch = () => 0,
90
+ /**
91
+ * Mints the OTHER per-session credentials the extensions need, at the moment the session is born.
92
+ *
93
+ * WHY A SECOND CALLBACK AND NOT PART OF THE CAPABILITY. The memory and knowledge extensions each
94
+ * need their own credential - the memory one even carries per-caller flags (read-only for a
95
+ * sub-agent) that a single session capability cannot express. The one-shot path has always minted
96
+ * them per turn; the SESSION path minted none, so those two extensions returned before registering
97
+ * a single tool or injecting a single line of prompt, and both features were absent in production -
98
+ * the SDK session path is the default backend, and only the test scripts use the one-shot path
99
+ * (ledger TEST-039).
100
+ *
101
+ * They are minted HERE, where the session is born, for the same reason the capability is: the
102
+ * extension reads its environment ONCE, when it is loaded, so a token minted per turn would be
103
+ * replaced before the second turn and the extension would still be holding the first turn's value.
104
+ */
105
+ mintExtensionTokens = () => ({})) {
106
+ this.sessionDir = sessionDir;
107
+ this.repositoryRoot = repositoryRoot;
108
+ this.agentDir = agentDir;
109
+ this.onSessionDestroyed = onSessionDestroyed;
110
+ this.factory = factory;
111
+ this.mintCapability = mintCapability;
112
+ this.modelEpoch = modelEpoch;
113
+ this.mintExtensionTokens = mintExtensionTokens;
114
+ }
115
+ /**
116
+ * The session for a conversation, built if there is none and REPLACED if the live one is stale.
117
+ *
118
+ * The fingerprint comparison is what makes a stale session impossible to use: it happens BEFORE the
119
+ * session is handed out, not after, so a caller can never accidentally run a turn on a session whose
120
+ * tool allowlist has changed.
121
+ */
122
+ async acquire(request) {
123
+ await this.evictOverflow(request.conversationId);
124
+ const fingerprint = this.fingerprintOf(request);
125
+ const existing = this.sessions.get(request.conversationId);
126
+ if (existing) {
127
+ if (sameFingerprint(existing.fingerprint, fingerprint)) {
128
+ if (process.env.SUPER_PI_TRACE_LATENCY === "1")
129
+ console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.reused`);
130
+ existing.lastUsedAt = Date.now();
131
+ // A session that is still being built is joined, not rebuilt: two sends arriving together must
132
+ // not produce two sessions, and the second one would be a duplicate model client talking to the
133
+ // same conversation.
134
+ if (existing.building)
135
+ return existing.building;
136
+ // THE MODEL AND THE LEVEL ARE APPLIED HERE, TO THE LIVE SESSION. They are not in the
137
+ // fingerprint because Pi can change them in place, and rebuilding the session to honour a
138
+ // change would replay the whole transcript - the single most expensive thing this runtime does.
139
+ // A person who picks a different model in the picker pays a few milliseconds here instead of
140
+ // waiting for their entire history to be re-read on the next message.
141
+ await this.applyModelAndLevel(existing.session, request);
142
+ return existing.session;
143
+ }
144
+ // STALE. The conversation's requirements changed underneath the live session, so it is thrown away
145
+ // BEFORE the new one is built, and not after - a session that is being disposed of while the new
146
+ // one starts would have two contexts for one conversation.
147
+ await this.evict(request.conversationId);
148
+ if (process.env.SUPER_PI_TRACE_LATENCY === "1")
149
+ console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.rebuild`);
150
+ }
151
+ // THE CREDENTIAL IS MINTED HERE, WHERE THE SESSION IS BORN. The capability travels in the
152
+ // extension's environment, and the extension reads its environment when it is LOADED - which happens
153
+ // once per session. A token minted per TURN would be replaced before the second turn of the
154
+ // conversation, and the extension would still be holding the first turn's value: the server would
155
+ // (correctly) refuse it, and delegation would break after the first message.
156
+ //
157
+ // So the token belongs to the SESSION, and it is minted exactly when the session is created. The
158
+ // server separately requires that a turn is RUNNING for the token to be usable, which is what keeps a
159
+ // longer-lived token from being a weaker credential than a per-turn one.
160
+ const capability = this.mintCapability(request.conversationId);
161
+ const extensionEnv = { ...request.extensionEnv, [CAPABILITY_ENV]: capability, [TOOLS_CAPABILITY_ENV]: capability, ...await this.mintExtensionTokens(request.conversationId) };
162
+ const building = this.build({ ...request, extensionEnv }, fingerprint);
163
+ if (process.env.SUPER_PI_TRACE_LATENCY === "1")
164
+ console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.build.begin`);
165
+ this.sessions.set(request.conversationId, { session: undefined, fingerprint, lastUsedAt: Date.now(), building });
166
+ try {
167
+ const session = await building;
168
+ if (process.env.SUPER_PI_TRACE_LATENCY === "1")
169
+ console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.build.end`);
170
+ const entry = this.sessions.get(request.conversationId);
171
+ if (entry) {
172
+ entry.session = session;
173
+ entry.building = undefined;
174
+ }
175
+ return session;
176
+ }
177
+ catch (error) {
178
+ // A failed build must not leave a broken entry behind: the next turn would find it and treat the
179
+ // failure as "the session exists", and every later turn would fail the same way with no reason.
180
+ this.sessions.delete(request.conversationId);
181
+ // And a failed build must not leave a CREDENTIAL behind either: the session it belonged to was
182
+ // never born, so the token is a credential with no owner.
183
+ this.onSessionDestroyed?.(request.conversationId);
184
+ throw error;
185
+ }
186
+ }
187
+ /** Keep an accidental session fan-out from retaining one full transcript context per conversation. */
188
+ async evictOverflow(exceptConversationId) {
189
+ if (this.sessions.size < MAX_LIVE_SESSIONS)
190
+ return;
191
+ const candidates = [...this.sessions.entries()]
192
+ .filter(([id, entry]) => id !== exceptConversationId && !entry.building && entry.session?.isIdle !== false)
193
+ .sort((a, b) => a[1].lastUsedAt - b[1].lastUsedAt);
194
+ while (this.sessions.size >= MAX_LIVE_SESSIONS && candidates.length) {
195
+ const [conversationId] = candidates.shift();
196
+ if (process.env.SUPER_PI_TRACE_LATENCY === "1")
197
+ console.warn(`[super-pi latency] conversation=${conversationId} phase=session.max-live-evict`);
198
+ await this.evict(conversationId);
199
+ }
200
+ }
201
+ async build(request, fingerprint) {
202
+ const creation = {
203
+ cwd: request.cwd,
204
+ sessionId: request.conversationId,
205
+ sessionDir: this.sessionDir,
206
+ ...(request.sessionFile ? { sessionFile: request.sessionFile } : {}),
207
+ extensionPaths: superPiExtensionPaths(this.repositoryRoot),
208
+ skillPaths: superPiSkillPaths(this.repositoryRoot),
209
+ extensionEnv: request.extensionEnv,
210
+ ...(request.systemPromptFile ? { systemPromptFile: request.systemPromptFile } : {}),
211
+ ...(request.systemPromptMode ? { systemPromptMode: request.systemPromptMode } : {}),
212
+ ...(request.tools ? { tools: request.tools } : {}),
213
+ ...(request.excludeTools ? { excludeTools: request.excludeTools } : {}),
214
+ ...(request.model ? { model: request.model } : {}),
215
+ ...(request.thinkingLevel ? { thinkingLevel: request.thinkingLevel } : {}),
216
+ ...(this.agentDir ? { agentDir: this.agentDir } : {}),
217
+ };
218
+ return this.factory(creation);
219
+ }
220
+ /**
221
+ * Puts a live session on the model and level the conversation is asking for.
222
+ *
223
+ * Best-effort in the way that matters: a session that cannot change its model is still a working
224
+ * session, and refusing the message because Pi declined a model switch would be a worse answer than
225
+ * running on the model that is loaded. So the failure is a warning, and the turn goes on.
226
+ *
227
+ * The comparison is against what the session is ALREADY running, because Pi can report its model in
228
+ * two shapes (an id or a provider/id pair) and a mismatch on shape alone would mean re-setting the
229
+ * model on every single turn.
230
+ */
231
+ async applyModelAndLevel(session, request) {
232
+ const wanted = request.model;
233
+ if (wanted && session.setModel) {
234
+ const running = session.model;
235
+ const same = running?.provider === wanted.provider && (running?.id ?? running?.id) === wanted.modelId;
236
+ if (!same) {
237
+ try {
238
+ // THE WHOLE MODEL, NOT THE PAIR. Pi's `setModel` puts what it is given straight into the
239
+ // agent's state, so a `{provider, id}` pair would not be a shorthand for a model - it would BE
240
+ // the model the agent runs on, with no `api` and no `contextWindow`. Measured: with the whole
241
+ // model the session reports `api=bedrock-converse-stream`, `contextWindow=1000000` and the
242
+ // thinking levels `[off, minimal, low, medium, high]`; with the pair the api and the context
243
+ // window are null and the levels collapse to `[off]`, which is what the picker shows.
244
+ //
245
+ // The pair is still the fallback, because a session that cannot resolve a model should still
246
+ // be able to run the one it has.
247
+ const whole = session.resolveModel?.(wanted.provider, wanted.modelId);
248
+ await session.setModel(whole ?? { provider: wanted.provider, id: wanted.modelId });
249
+ if (process.env.SUPER_PI_TRACE_LATENCY === "1")
250
+ console.warn(`[super-pi latency] conversation=${request.conversationId} phase=session.model-applied model=${wanted.provider}/${wanted.modelId} whole=${whole ? "yes" : "no"}`);
251
+ }
252
+ catch (error) {
253
+ console.warn(`PiSessionPool: conversation ${request.conversationId} asked for ${wanted.provider}/${wanted.modelId} and Pi declined: ${error instanceof Error ? error.message : String(error)}. The turn will run on the model already loaded.`);
254
+ }
255
+ }
256
+ }
257
+ if (request.thinkingLevel && session.setThinkingLevel) {
258
+ try {
259
+ session.setThinkingLevel(request.thinkingLevel);
260
+ }
261
+ catch (error) {
262
+ console.warn(`PiSessionPool: conversation ${request.conversationId} asked for thinking level ${request.thinkingLevel} and Pi declined: ${error instanceof Error ? error.message : String(error)}.`);
263
+ }
264
+ }
265
+ }
266
+ fingerprintOf(request) {
267
+ // The model and the thinking level are NOT here, and that is deliberate: Pi changes both on a
268
+ // live session, so they are applied to it rather than forcing a rebuild that would replay the whole
269
+ // transcript. The session is still CREATED with them (see `build`) - it just is not thrown away
270
+ // when they change.
271
+ return {
272
+ cwd: request.cwd,
273
+ agentId: request.agentId,
274
+ tools: request.tools,
275
+ excludeTools: request.excludeTools,
276
+ extensions: superPiExtensionPaths(this.repositoryRoot),
277
+ modelEpoch: this.modelEpoch(),
278
+ };
279
+ }
280
+ /**
281
+ * The live session for a conversation, without building one.
282
+ *
283
+ * Absent when there is none - including when the session is still being built, because a session
284
+ * that is not ready cannot be steered into.
285
+ */
286
+ get(conversationId) {
287
+ const entry = this.sessions.get(conversationId);
288
+ return entry && !entry.building ? entry.session : undefined;
289
+ }
290
+ /**
291
+ * Whether a conversation has a live session, without building one.
292
+ *
293
+ * Used by the paths that need to know whether a session EXISTS - `revert` has to know whether there is
294
+ * an in-memory context to invalidate - and by the tests.
295
+ */
296
+ has(conversationId) {
297
+ return this.sessions.has(conversationId);
298
+ }
299
+ /**
300
+ * Throws away a conversation's session.
301
+ *
302
+ * The reason this is a PUBLIC operation and not an internal detail is that the callers are the ones
303
+ * that know WHY the session is stale. `revert` calls it because the disk changed under the session;
304
+ * a configuration change calls it because the requirements changed. The pool does not second-guess
305
+ * either - it disposes what it is told to dispose.
306
+ */
307
+ async evict(conversationId) {
308
+ const entry = this.sessions.get(conversationId);
309
+ if (!entry)
310
+ return;
311
+ this.sessions.delete(conversationId);
312
+ // The credential the session was holding dies with it, in every path - including the one where the
313
+ // build is still running, because a session that finishes building after its eviction would
314
+ // otherwise come back holding a token the server has already forgotten.
315
+ this.onSessionDestroyed?.(conversationId);
316
+ if (entry.building) {
317
+ // The build is still running. Awaiting it before disposing is what guarantees the session is
318
+ // actually released rather than leaked - a session that finishes building after the eviction has
319
+ // no owner left to dispose it.
320
+ const session = await entry.building.catch(() => undefined);
321
+ if (session)
322
+ await this.closeSession(session);
323
+ return;
324
+ }
325
+ try {
326
+ if (entry.session)
327
+ await this.closeSession(entry.session);
328
+ }
329
+ catch (error) {
330
+ console.warn(`Super Pi: disposing the Pi session of ${conversationId} threw: ${error instanceof Error ? error.message : "unknown error"}`);
331
+ }
332
+ }
333
+ /**
334
+ * Throws away every session that has not been used for a while.
335
+ *
336
+ * The conversation is not lost: Pi wrote the transcript to disk, and the next turn rebuilds the
337
+ * session from that file. What is lost is the in-memory context, which is exactly what an idle
338
+ * conversation does not need.
339
+ */
340
+ async evictIdle(now = Date.now()) {
341
+ for (const [conversationId, entry] of [...this.sessions]) {
342
+ if (entry.session?.isIdle !== false && now - entry.lastUsedAt >= IDLE_EVICTION_MS)
343
+ await this.evict(conversationId);
344
+ }
345
+ }
346
+ /** Throws away every session. Used at shutdown. */
347
+ async disposeAll() {
348
+ for (const conversationId of [...this.sessions.keys()])
349
+ await this.evict(conversationId);
350
+ }
351
+ async closeSession(session) {
352
+ try {
353
+ await session.extensionRunner?.emit?.({ type: "session_shutdown", reason: "quit" });
354
+ }
355
+ finally {
356
+ session.dispose();
357
+ }
358
+ }
359
+ /** The conversations with a live session. */
360
+ get conversationIds() {
361
+ return [...this.sessions.keys()];
362
+ }
363
+ }
364
+ /**
365
+ * Where Super Pi's repository root is, found from the compiled server's own location.
366
+ *
367
+ * The extensions are mounted by PATH, and Pi resolves a relative path against the CONVERSATION's
368
+ * workspace rather than the server's directory - so the path has to be absolute, and it has to be
369
+ * derived from something that is the same in every way the server runs (built to `dist/server/`, or run
370
+ * from `src/server/` under tsx). `import.meta.dirname` is that thing.
371
+ */
372
+ export function repositoryRootFrom(from = import.meta.dirname) {
373
+ return join(from, "..", "..");
374
+ }
375
+ /** Whether Super Pi's own extensions are present on disk. */
376
+ export function extensionsAvailable(repositoryRoot) {
377
+ return superPiExtensionPaths(repositoryRoot).length > 0;
378
+ }
379
+ /** Whether the extension directory exists at all, for a clearer failure message. */
380
+ export function extensionDirectoryExists(repositoryRoot) {
381
+ return existsSync(join(repositoryRoot, "agents", "super-pi-task", "index.ts"));
382
+ }