@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,98 @@
1
+ import type { AgentRuntime } from "../runtime.js";
2
+ import type { AgentCatalog, ModelCatalog, ModelSelection, PromptCatalog } from "../types.js";
3
+ import type { EventBroadcaster } from "../server-context.js";
4
+ import type { Store } from "../store.js";
5
+ /**
6
+ * Service managing model catalogs and agent definitions (primary and subagents).
7
+ */
8
+ export declare class CatalogService {
9
+ private readonly runtime;
10
+ private readonly broadcaster;
11
+ private readonly store?;
12
+ private readonly rootDir?;
13
+ private readonly onDirsChanged?;
14
+ private agentDirs;
15
+ private readonly promptCatalogs;
16
+ constructor(runtime: AgentRuntime, broadcaster: EventBroadcaster, agentsDir: string | readonly string[], store?: Store | undefined, rootDir?: string | undefined, onDirsChanged?: ((dirs: string[]) => void) | undefined);
17
+ /**
18
+ * Returns current active agent discovery directories.
19
+ */
20
+ getAgentDirs(): string[];
21
+ /**
22
+ * Updates agent discovery directories and notifies subscribers.
23
+ */
24
+ setAgentDirs(dirs: string[]): void;
25
+ /**
26
+ * Updates user-configured custom agent directories in store and triggers rescan.
27
+ */
28
+ setCustomDirs(dirs: string[]): Promise<void>;
29
+ /**
30
+ * Immediately re-reads agent definitions from disk and broadcasts catalogs.
31
+ */
32
+ rescan(): Promise<void>;
33
+ /**
34
+ * Fetches the model catalog from runtime, optionally tailored to a selected model.
35
+ */
36
+ getCatalog(selection?: ModelSelection, conversationId?: string): Promise<ModelCatalog>;
37
+ /**
38
+ * Broadcasts the model catalog to connected clients.
39
+ */
40
+ broadcastCatalog(selection?: ModelSelection, conversationId?: string): Promise<void>;
41
+ /**
42
+ * Broadcasts the UNFILTERED catalog, for the settings window's model panel.
43
+ *
44
+ * A SEPARATE EVENT FROM `model.catalog`, and the reason is the same one that made
45
+ * `model.catalog.all` a separate event in the first place: a `model.catalog` without a
46
+ * conversation is the unfiltered list, and a client that received it as its conversation's list
47
+ * would be offered the models that workspace's rules forbid. The panel gets its own event.
48
+ */
49
+ broadcastAllCatalog(): Promise<void>;
50
+ setModelRules(rules: import("../types.js").ModelFilterRule[]): Promise<void>;
51
+ /**
52
+ * Reads one catalog filtered by mode at source.
53
+ */
54
+ readAgentCatalog(mode: "primary" | "subagent"): Promise<AgentCatalog>;
55
+ /**
56
+ * Reads primary agent definitions from disk.
57
+ */
58
+ agentCatalog(): Promise<AgentCatalog>;
59
+ /**
60
+ * Broadcasts primary agents to connected clients.
61
+ */
62
+ broadcastAgents(): Promise<void>;
63
+ /**
64
+ * Reads subagent definitions from disk.
65
+ */
66
+ subagentCatalog(): Promise<AgentCatalog>;
67
+ /**
68
+ * Broadcasts subagents to connected clients.
69
+ */
70
+ broadcastSubagents(): Promise<void>;
71
+ promptCatalog(workspaceId: string): Promise<PromptCatalog>;
72
+ broadcastPromptCatalog(workspaceId: string): Promise<void>;
73
+ /**
74
+ * Sets the app-wide default model, or clears it back to "Pi's own default".
75
+ *
76
+ * THE MODEL IS CHECKED AGAINST PI'S OWN CATALOG, for the same reason the workspace default is:
77
+ * a default Pi does not offer would be stamped onto every new conversation, and the first turn
78
+ * would fail on a model the user never chose. The check happens at SAVE time rather than at
79
+ * birth time so the user hears about it while they are still looking at the list.
80
+ *
81
+ * The label is taken from the catalog row rather than from the request, so the stored value
82
+ * always carries the display name Pi itself reported.
83
+ */
84
+ setDefaultModel(model: {
85
+ provider: string;
86
+ modelId: string;
87
+ } | null): Promise<void>;
88
+ /**
89
+ * The UNFILTERED catalog, for the settings window's model panel. Deliberately not the scoped one:
90
+ * the panel is where the app-wide default is chosen, and a workspace's model rules must not hide
91
+ * models from the place that decides what the app-wide default may be.
92
+ */
93
+ getAllCatalog(): Promise<ModelCatalog>;
94
+ /**
95
+ * Helper formatting an error when a requested model/thinking level is not offered by Pi.
96
+ */
97
+ notOffered(what: string, catalog: ModelCatalog): Error;
98
+ }
@@ -0,0 +1,245 @@
1
+ import { assertModelAllowed } from "../model-filter.js";
2
+ import { readAgents, resolveAgentDirectories } from "../agents.js";
3
+ import { loadPromptTemplateSummaries } from "../pi-session.js";
4
+ function summarize(agent) {
5
+ const { prompt, toolFlags, ...summary } = agent;
6
+ const toolSummary = toolFlags.includes("--no-tools")
7
+ ? "禁用全部工具"
8
+ : agent.toolNames.length
9
+ ? `工具:${agent.toolNames.join("、")}`
10
+ : toolFlags.includes("--exclude-tools")
11
+ ? `Pi 默认工具,去掉 ${toolFlags[toolFlags.indexOf("--exclude-tools") + 1]?.split(",").join("、") ?? ""}`
12
+ : "Pi 默认工具";
13
+ return { ...summary, toolSummary };
14
+ }
15
+ /**
16
+ * Service managing model catalogs and agent definitions (primary and subagents).
17
+ */
18
+ export class CatalogService {
19
+ runtime;
20
+ broadcaster;
21
+ store;
22
+ rootDir;
23
+ onDirsChanged;
24
+ agentDirs;
25
+ promptCatalogs = new Map();
26
+ constructor(runtime, broadcaster, agentsDir, store, rootDir, onDirsChanged) {
27
+ this.runtime = runtime;
28
+ this.broadcaster = broadcaster;
29
+ this.store = store;
30
+ this.rootDir = rootDir;
31
+ this.onDirsChanged = onDirsChanged;
32
+ this.agentDirs = Array.isArray(agentsDir) ? [...agentsDir] : [agentsDir];
33
+ }
34
+ /**
35
+ * Returns current active agent discovery directories.
36
+ */
37
+ getAgentDirs() {
38
+ return [...this.agentDirs];
39
+ }
40
+ /**
41
+ * Updates agent discovery directories and notifies subscribers.
42
+ */
43
+ setAgentDirs(dirs) {
44
+ this.agentDirs = [...dirs];
45
+ this.onDirsChanged?.(this.agentDirs);
46
+ }
47
+ /**
48
+ * Updates user-configured custom agent directories in store and triggers rescan.
49
+ */
50
+ async setCustomDirs(dirs) {
51
+ if (this.store) {
52
+ await this.store.setCustomAgentDirs(dirs);
53
+ this.broadcaster.broadcastState();
54
+ }
55
+ const resolved = resolveAgentDirectories({
56
+ customDirs: dirs,
57
+ rootDir: this.rootDir,
58
+ });
59
+ this.setAgentDirs(resolved);
60
+ await this.rescan();
61
+ }
62
+ /**
63
+ * Immediately re-reads agent definitions from disk and broadcasts catalogs.
64
+ */
65
+ async rescan() {
66
+ await Promise.all([
67
+ this.broadcastAgents(),
68
+ this.broadcastSubagents(),
69
+ ]);
70
+ }
71
+ /**
72
+ * Fetches the model catalog from runtime, optionally tailored to a selected model.
73
+ */
74
+ async getCatalog(selection, conversationId) {
75
+ const catalog = await this.runtime.catalog(selection);
76
+ if (!conversationId || !this.store)
77
+ return catalog;
78
+ const workspace = this.store.workspaceForConversation(conversationId);
79
+ if (!workspace)
80
+ throw new Error("会话所属工作区不存在");
81
+ const rules = this.store.modelFilterRules();
82
+ return { ...catalog, models: catalog.models.filter(model => { try {
83
+ assertModelAllowed(rules, workspace, model);
84
+ return true;
85
+ }
86
+ catch {
87
+ return false;
88
+ } }) };
89
+ }
90
+ /**
91
+ * Broadcasts the model catalog to connected clients.
92
+ */
93
+ async broadcastCatalog(selection, conversationId) {
94
+ const catalog = await this.getCatalog(selection, conversationId);
95
+ this.broadcaster.broadcast({ type: "model.catalog", catalog, conversationId });
96
+ }
97
+ /**
98
+ * Broadcasts the UNFILTERED catalog, for the settings window's model panel.
99
+ *
100
+ * A SEPARATE EVENT FROM `model.catalog`, and the reason is the same one that made
101
+ * `model.catalog.all` a separate event in the first place: a `model.catalog` without a
102
+ * conversation is the unfiltered list, and a client that received it as its conversation's list
103
+ * would be offered the models that workspace's rules forbid. The panel gets its own event.
104
+ */
105
+ async broadcastAllCatalog() {
106
+ this.broadcaster.broadcast({ type: "model.catalog.all", catalog: await this.getAllCatalog() });
107
+ }
108
+ async setModelRules(rules) {
109
+ if (!this.store)
110
+ throw new Error("Store unavailable");
111
+ await this.store.setModelFilterRules(rules);
112
+ this.broadcaster.broadcastState();
113
+ for (const conversation of this.store.catalogConversationTargets()) {
114
+ if (!conversation.archivedAt) {
115
+ try {
116
+ await this.broadcastCatalog(conversation.model, conversation.id);
117
+ }
118
+ catch (error) {
119
+ console.warn(`模型规则已保存,刷新会话 ${conversation.id} 的目录失败:${String(error)}`);
120
+ }
121
+ }
122
+ }
123
+ }
124
+ /**
125
+ * Reads one catalog filtered by mode at source.
126
+ */
127
+ async readAgentCatalog(mode) {
128
+ const primaryDir = this.agentDirs[0] ?? "";
129
+ try {
130
+ const scan = await readAgents(this.agentDirs, { mode });
131
+ for (const problem of scan.problems) {
132
+ console.warn(`Super Pi: ${problem.file} is not a usable agent - ${problem.message}`);
133
+ }
134
+ const agents = scan.agents.filter((agent) => !agent.hidden).map(summarize);
135
+ if (!agents.length) {
136
+ console.warn(`Super Pi: no ${mode} agents found in [${this.agentDirs.join(", ")}] (${scan.problems.length} file(s) rejected).`);
137
+ }
138
+ return {
139
+ source: "directory",
140
+ agents,
141
+ problems: scan.problems,
142
+ directory: primaryDir,
143
+ directories: [...this.agentDirs],
144
+ fetchedAt: new Date().toISOString(),
145
+ };
146
+ }
147
+ catch (error) {
148
+ return {
149
+ source: "unavailable",
150
+ agents: [],
151
+ problems: [],
152
+ directory: primaryDir,
153
+ directories: [...this.agentDirs],
154
+ fetchedAt: new Date().toISOString(),
155
+ error: error instanceof Error ? error.message : "unknown error",
156
+ };
157
+ }
158
+ }
159
+ /**
160
+ * Reads primary agent definitions from disk.
161
+ */
162
+ async agentCatalog() {
163
+ return this.readAgentCatalog("primary");
164
+ }
165
+ /**
166
+ * Broadcasts primary agents to connected clients.
167
+ */
168
+ async broadcastAgents() {
169
+ this.broadcaster.broadcast({ type: "agent.catalog", catalog: await this.agentCatalog() });
170
+ }
171
+ /**
172
+ * Reads subagent definitions from disk.
173
+ */
174
+ async subagentCatalog() {
175
+ return this.readAgentCatalog("subagent");
176
+ }
177
+ /**
178
+ * Broadcasts subagents to connected clients.
179
+ */
180
+ async broadcastSubagents() {
181
+ this.broadcaster.broadcast({ type: "subagent.catalog", catalog: await this.subagentCatalog() });
182
+ }
183
+ async promptCatalog(workspaceId) {
184
+ const cached = this.promptCatalogs.get(workspaceId);
185
+ if (cached && cached.expiresAt > Date.now())
186
+ return cached.catalog;
187
+ const workspace = this.store?.workspace(workspaceId);
188
+ if (!workspace)
189
+ return { source: "unavailable", prompts: [], workspaceId, fetchedAt: new Date().toISOString(), error: "workspace not found" };
190
+ try {
191
+ const catalog = { source: "sdk", prompts: await loadPromptTemplateSummaries(workspace.path), workspaceId, fetchedAt: new Date().toISOString() };
192
+ this.promptCatalogs.set(workspaceId, { expiresAt: Date.now() + 1_000, catalog });
193
+ return catalog;
194
+ }
195
+ catch (error) {
196
+ return { source: "unavailable", prompts: [], workspaceId, fetchedAt: new Date().toISOString(), error: error instanceof Error ? error.message : String(error) };
197
+ }
198
+ }
199
+ async broadcastPromptCatalog(workspaceId) {
200
+ this.broadcaster.broadcast({ type: "prompt.catalog", catalog: await this.promptCatalog(workspaceId) });
201
+ }
202
+ /**
203
+ * Sets the app-wide default model, or clears it back to "Pi's own default".
204
+ *
205
+ * THE MODEL IS CHECKED AGAINST PI'S OWN CATALOG, for the same reason the workspace default is:
206
+ * a default Pi does not offer would be stamped onto every new conversation, and the first turn
207
+ * would fail on a model the user never chose. The check happens at SAVE time rather than at
208
+ * birth time so the user hears about it while they are still looking at the list.
209
+ *
210
+ * The label is taken from the catalog row rather than from the request, so the stored value
211
+ * always carries the display name Pi itself reported.
212
+ */
213
+ async setDefaultModel(model) {
214
+ if (!this.store)
215
+ throw new Error("Store unavailable");
216
+ let selection;
217
+ if (model) {
218
+ const catalog = await this.runtime.catalog();
219
+ const option = catalog.source === "pi"
220
+ ? catalog.models.find(item => item.provider === model.provider && item.modelId === model.modelId)
221
+ : undefined;
222
+ if (catalog.source === "pi" && !option)
223
+ throw this.notOffered(`模型 ${model.provider}/${model.modelId}`, catalog);
224
+ selection = option
225
+ ? { provider: option.provider, modelId: option.modelId, label: option.label }
226
+ : { provider: model.provider, modelId: model.modelId, label: model.modelId };
227
+ }
228
+ await this.store.setDefaultModel(selection);
229
+ this.broadcaster.broadcastState();
230
+ }
231
+ /**
232
+ * The UNFILTERED catalog, for the settings window's model panel. Deliberately not the scoped one:
233
+ * the panel is where the app-wide default is chosen, and a workspace's model rules must not hide
234
+ * models from the place that decides what the app-wide default may be.
235
+ */
236
+ async getAllCatalog() {
237
+ return this.runtime.catalog();
238
+ }
239
+ /**
240
+ * Helper formatting an error when a requested model/thinking level is not offered by Pi.
241
+ */
242
+ notOffered(what, catalog) {
243
+ return new Error(`Pi 当前不提供${what}(列表读取于 ${catalog.fetchedAt}${catalog.error ? `,读取有误:${catalog.error}` : ""})`);
244
+ }
245
+ }
@@ -0,0 +1,245 @@
1
+ import { type Store } from "../store.js";
2
+ import type { AgentRuntime } from "../runtime.js";
3
+ import type { SubagentRunRecorder } from "../subagent-runs.js";
4
+ import type { ModelSelection } from "../types.js";
5
+ import type { EventBroadcaster } from "../server-context.js";
6
+ import type { CatalogService } from "./catalog-service.js";
7
+ import type { RunService } from "./run-service.js";
8
+ import type { ExtensionUiService } from "./extension-ui-service.js";
9
+ export type ForkConversationResult = {
10
+ ok: true;
11
+ forkedId: string;
12
+ title: string;
13
+ messagesCopied: number;
14
+ piSessionFile?: string;
15
+ } | {
16
+ ok: false;
17
+ message: string;
18
+ };
19
+ /**
20
+ * THE LOCK STATE OF ONE CONVERSATION'S COMPOSER.
21
+ *
22
+ * "top" - a top-level session. The reader talks to it directly, and always could.
23
+ * "locked" - a child session whose parent is still alive: the reporting line only runs
24
+ * upwards, so the reader does not talk to it directly.
25
+ * "unlocked" - a child session the reader deliberately opened.
26
+ */
27
+ export type ChildLockState = "top" | "locked" | "unlocked";
28
+ /**
29
+ * Service managing conversation lifecycle: creation, selection, archiving,
30
+ * model/thinking/agent configuration, message reversion, and session forking.
31
+ */
32
+ export declare class ConversationService {
33
+ private readonly store;
34
+ private readonly runtime;
35
+ private readonly subagents;
36
+ private readonly broadcaster;
37
+ private readonly catalogService;
38
+ private readonly runService;
39
+ private readonly extensionUiService;
40
+ private agentsDir;
41
+ private readonly uploadsDir?;
42
+ /** Conversations whose Pi transcript is being cut RIGHT NOW. Read by the send path, below. */
43
+ private readonly reverting;
44
+ /** Reverts for one conversation must never truncate the same Pi file concurrently. */
45
+ private readonly revertOps;
46
+ /** The memory store, so a revert can undo what that conversation taught it. Set by `setMemory`. */
47
+ private memory?;
48
+ constructor(store: Store, runtime: AgentRuntime, subagents: SubagentRunRecorder, broadcaster: EventBroadcaster, catalogService: CatalogService, runService: RunService, extensionUiService: ExtensionUiService, agentsDir: string | string[], uploadsDir?: string | undefined);
49
+ setAgentsDir(dir: string | string[]): void;
50
+ isWarmSession(conversationId: string): boolean;
51
+ /**
52
+ * Creates a new conversation in a workspace.
53
+ *
54
+ * `parentage` is WHO OPENED THIS CONVERSATION, recorded at birth exactly once: the session
55
+ * tree's edge (`parentConversationId`) and its origin. Only the orchestrator passes it - the "+"
56
+ * button and every other caller create a top-level conversation by omission, which is the same
57
+ * "absence means top level" rule the pre-tree state.json files read under.
58
+ *
59
+ * `separateMemoryTree` says that this conversation is its own working context: it must not
60
+ * inherit the memory tree of the conversation it hangs under. A project leader is the case that
61
+ * needs it - it sits in the user's chat in the sidebar, and it shares nothing of that chat's
62
+ * tree-scoped memories with it.
63
+ */
64
+ createConversation(workspaceId: string, parentage?: {
65
+ parentConversationId?: string;
66
+ origin?: "user" | "orchestrator";
67
+ separateMemoryTree?: boolean;
68
+ }, cwd?: string): Promise<string>;
69
+ /**
70
+ * Name a conversation from what was said in it. Returns the title; the CALLER applies it, because the
71
+ * rename is a second command with its own optimistic path and its own failure toast, and a service that
72
+ * renamed as a side effect of being asked for a name would make those two outcomes indistinguishable in
73
+ * a log and in a retry.
74
+ */
75
+ autoRenameConversation(conversationId: string): Promise<string>;
76
+ /**
77
+ * THE LOCK STATE OF ONE CONVERSATION'S COMPOSER.
78
+ *
79
+ * "top" - a top-level session: the reader talks to it directly, and always could.
80
+ * "locked" - a child session whose parent is still alive. The reader may not talk to it
81
+ * directly; the reporting line runs upwards, one level at a time.
82
+ * "unlocked" - a child session the reader deliberately opened.
83
+ *
84
+ * THE ORPHAN IS "top". A conversation whose parent was archived and left behind has nobody
85
+ * above it to report to, so there is no reporting line for it to bypass - and locking it would
86
+ * lock a conversation that the rules do not cover.
87
+ *
88
+ * The judgement itself lives in `src/shared/child-session-lock.ts` because the browser draws
89
+ * the very same lock: two implementations of "what is a child session" would eventually
90
+ * disagree, and the two ways to disagree are both bad (a lock the server does not honour, and a
91
+ * refusal the interface never explained).
92
+ */
93
+ childLockState(conversationId: string): ChildLockState;
94
+ /**
95
+ * Opens (or re-closes) ONE child session's composer.
96
+ *
97
+ * The server owns this state, because the server is what refuses the message. The browser keeps
98
+ * a copy per conversation in localStorage so the choice survives a reload, but that copy is a
99
+ * mirror: the server's answer is the one that decides.
100
+ *
101
+ * Re-locking is a real door, not a one-way street: `unlocked: false` puts the lock back, and a
102
+ * lock that could only be opened would not be a lock.
103
+ */
104
+ setChildLock(conversationId: string, unlocked: boolean): Promise<void>;
105
+ /**
106
+ * The model a conversation has selected, or undefined when it follows Pi's default.
107
+ *
108
+ * THIS IS WHAT THE CATALOG'S THINKING LEVELS DEPEND ON. Pi computes the levels from the model
109
+ * itself, so the levels of the model in force are the levels that conversation gets. A catalog read
110
+ * without this is a catalog of whatever Pi would default to.
111
+ */
112
+ modelSelectionFor(conversationId: string | undefined): ModelSelection | undefined;
113
+ /**
114
+ * Selects a conversation and broadcasts the catalog for that conversation's model.
115
+ */
116
+ getConversationCatalog(conversationId: string): Promise<import("../types.js").ModelCatalog>;
117
+ selectConversation(conversationId: string): Promise<void>;
118
+ /**
119
+ * Archives a conversation.
120
+ *
121
+ * An archive carries three things: the tree is archived, **the decisions the reader still owes
122
+ * go with it**, and the state is broadcast once.
123
+ *
124
+ * Why they go: the owner session is in the archive => nobody runs that project any more => the
125
+ * decisions it owed the reader are asked of nobody. The reader said it plainly: once the
126
+ * archive is decided, every pending decision is rubbish.
127
+ *
128
+ * A dismissal is a QUALIFICATION, not a deletion: the case stays in `p.escalations`, its
129
+ * `status` becomes `dismissed`, `decision` says why it went, `resolvedAt` says when -
130
+ * searchable, exportable. A supervisor-level case is left alone (that is the team's business),
131
+ * and so is another project's.
132
+ *
133
+ * The order matters: archive first, dismiss second. A refused archive (a running session)
134
+ * must change nothing at all.
135
+ */
136
+ archiveConversation(conversationId: string): Promise<void>;
137
+ /**
138
+ * Dismisses the pending user-level cases of the projects whose OWNER session was archived.
139
+ * The record stays; only its status changes.
140
+ */
141
+ private dismissDecisionsOfArchivedOwners;
142
+ /**
143
+ * Unarchives an archived tree root and every archived descendant. Descendants that are
144
+ * already active need no write; they are already in the live tree this restore rejoins.
145
+ */
146
+ unarchiveConversation(conversationId: string): Promise<void>;
147
+ /**
148
+ * Collapses or expands one conversation's subtree in the sidebar's session tree. The state is
149
+ * the store's, server-side; this method only adds the conversation-exists check and the
150
+ * broadcast every other write here performs.
151
+ */
152
+ setCollapsed(conversationId: string, collapsed: boolean): Promise<void>;
153
+ /**
154
+ * Renames a conversation.
155
+ */
156
+ renameConversation(conversationId: string, name: string): Promise<void>;
157
+ /**
158
+ * Sets the active model on a conversation, validating against Pi's catalog.
159
+ */
160
+ setModel(conversationId: string, provider: string, modelId: string): Promise<void>;
161
+ /**
162
+ * Sets the thinking level on a conversation, validating against the model's available levels.
163
+ */
164
+ setThinking(conversationId: string, level: string): Promise<void>;
165
+ /**
166
+ * Configures or clears the primary agent assigned to a conversation.
167
+ */
168
+ setAgent(conversationId: string, agentId: string | null): Promise<void>;
169
+ /**
170
+ * Resolves the agent's model/thinking defaults against the catalog and the workspace's model rules.
171
+ *
172
+ * `workspaceId` must be passed when `conversation` is a workspace-shaped placeholder (the
173
+ * createConversation path passes `{ id: workspaceId, ... }`), because matching a workspace by a
174
+ * CONVERSATION id would never hit. Real conversations omit it: their workspace is resolved through
175
+ * `workspaceForConversation`, which resolves `conversation.workspaceId` without copying messages.
176
+ */
177
+ private resolveAgentConfiguration;
178
+ /**
179
+ * Reverts conversation history to a designated message boundary, truncating both
180
+ * Pi's transcript and state.json.
181
+ */
182
+ revertMessage(conversationId: string, messageId: string, withdraw?: boolean): Promise<{
183
+ content: string;
184
+ images: import("../types.js").MessageImage[] | undefined;
185
+ } | undefined>;
186
+ /**
187
+ * The memory store, injected rather than constructed: `ActiveMemory` is built once in `index.ts` and
188
+ * handed to every holder, and this is the third of those. The rewind reaches memory through here
189
+ * because a revert that only rewound the TRANSCRIPT would leave the app still telling the model what
190
+ * the withdrawn turn said.
191
+ */
192
+ setMemory(memory: import("../active-memory.js").ActiveMemory): void;
193
+ /** Whether a revert is currently cutting this conversation's history. The send path asks. */
194
+ isReverting(conversationId: string): boolean;
195
+ /**
196
+ * CLAIM THE CUT AT THE MOMENT THE COMMAND ARRIVES, not at the moment it runs.
197
+ *
198
+ * `revertMessage` above takes the claim itself, but it only runs when the command is EXECUTED - and a
199
+ * `message.send` deliberately does not wait for this socket's command queue (ws-server runs it
200
+ * independently, so a follow-up can be admitted while a turn is streaming). So a send arriving in the
201
+ * same tick as a revert used to be handled FIRST, found `isReverting` false because the cut had not
202
+ * started yet, and was admitted onto a transcript the cut was about to remove. The guard existed and
203
+ * still could not see the case it was written for.
204
+ *
205
+ * The claim therefore moves to the arrival edge, and `releaseRevert` below gives it back. The claim is
206
+ * reference-counted: the service owns one count while the cut runs, and the socket owns one until the
207
+ * command finishes. This also remains safe when two browser tabs click revert before either cut ends.
208
+ *
209
+ * The cost is that a revert sitting behind a long queue refuses sends from the moment it ARRIVES
210
+ * rather than from the moment it STARTS. That is the direction to err in: a send admitted during the
211
+ * gap is appended to a history the model still reads in full, and the message the person just withdrew
212
+ * is in its context.
213
+ */
214
+ claimRevert(conversationId: string): void;
215
+ /** Give the claim back once the command that took it has finished, however it ended. */
216
+ releaseRevert(conversationId: string): void;
217
+ /**
218
+ * Serializes destructive transcript cuts for one conversation while keeping different conversations
219
+ * independent. The lane is intentionally local to this service: the socket layer can dispatch a
220
+ * revert without waiting behind unrelated commands, and this lane is the ordering boundary that the
221
+ * Pi file actually requires.
222
+ */
223
+ private serializeRevert;
224
+ private cutTo;
225
+ /**
226
+ * Forks an existing conversation into a new parallel branch, cloning the Pi session.
227
+ */
228
+ forkConversation(conversationId: string, options?: {
229
+ parentConversationId?: string;
230
+ warmTitle?: string;
231
+ }): Promise<ForkConversationResult>;
232
+ /**
233
+ * Cancels pending UI/sub-agent work and clears active memory notes for a conversation about to
234
+ * be permanently destroyed (runs while the conversation is still readable in the store).
235
+ */
236
+ prepareDestroyConversation(conversationId: string): Promise<void>;
237
+ /**
238
+ * Removes a destroyed conversation's messages from the recall index and disposes any cached Pi
239
+ * session held in runtime memory.
240
+ */
241
+ cleanupDestroyedConversation(conversation: {
242
+ id: string;
243
+ messageIds: string[];
244
+ }): Promise<void>;
245
+ }