@kabmo-labs/kabmo 0.27.0 → 0.29.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (492) hide show
  1. package/bunfig.toml +6 -0
  2. package/dist/client/index.html +2 -2
  3. package/dist/client/index.js +530 -493
  4. package/dist/client/static/js/{index-e3qh2yps.js → index-43z47ngg.js} +1178 -1034
  5. package/dist/client/static/js/index-naa91727.css +1 -0
  6. package/dist/client/static/{manifest-q6h8k9e0.webmanifest → manifest-vdvdqpre.webmanifest} +1 -0
  7. package/marketplace/plugins/command-runner/package.json +3 -17
  8. package/marketplace/plugins/command-runner/settings-schema.json +14 -0
  9. package/marketplace/plugins/git-forge/README.md +17 -7
  10. package/marketplace/plugins/git-forge/package.json +4 -30
  11. package/marketplace/plugins/git-forge/panel.css +16 -0
  12. package/marketplace/plugins/git-forge/settings-schema.json +27 -0
  13. package/marketplace/plugins/git-forge/src/panel/Badge.tsx +35 -22
  14. package/marketplace/plugins/git-forge/src/panel/Change.tsx +20 -24
  15. package/marketplace/plugins/git-forge/src/panel/CiBadge.tsx +16 -7
  16. package/marketplace/plugins/git-forge/src/panel/Credential.tsx +31 -26
  17. package/marketplace/plugins/git-forge/src/panel/Glyph.tsx +18 -2
  18. package/marketplace/plugins/git-forge/src/panel/Header.tsx +160 -96
  19. package/marketplace/plugins/git-forge/src/panel/ItemView.tsx +60 -44
  20. package/marketplace/plugins/git-forge/src/panel/List.tsx +150 -22
  21. package/marketplace/plugins/git-forge/src/panel/Row.tsx +11 -5
  22. package/marketplace/plugins/git-forge/src/panel/Sidebar.tsx +17 -15
  23. package/marketplace/plugins/git-forge/src/panel/Write.tsx +84 -61
  24. package/marketplace/plugins/git-forge/src/panel/format.test.ts +99 -0
  25. package/marketplace/plugins/git-forge/src/panel/format.ts +59 -16
  26. package/marketplace/plugins/git-forge/src/panel/index.test.tsx +109 -5
  27. package/marketplace/plugins/git-forge/src/panel/index.tsx +37 -4
  28. package/marketplace/plugins/git-forge/src/panel/use-forge.ts +17 -0
  29. package/marketplace/plugins/git-forge/src/panel/write.test.tsx +31 -0
  30. package/marketplace/plugins/session-info/package.json +2 -10
  31. package/marketplace/plugins/session-info/settings-schema.json +8 -0
  32. package/marketplace/plugins/stats/README.md +17 -5
  33. package/marketplace/plugins/stats/package.json +3 -23
  34. package/marketplace/plugins/stats/settings-schema.json +20 -0
  35. package/marketplace/plugins/stats/src/app.tsx +1 -1
  36. package/marketplace/plugins/stats/src/groups.test.ts +46 -1
  37. package/marketplace/plugins/stats/src/groups.ts +22 -11
  38. package/marketplace/plugins/stats/src/harness-leases.test.ts +84 -0
  39. package/marketplace/plugins/stats/src/harness-leases.ts +132 -0
  40. package/marketplace/plugins/stats/src/labels.test.ts +54 -1
  41. package/marketplace/plugins/stats/src/labels.ts +33 -7
  42. package/marketplace/plugins/stats/src/sampler.test.ts +61 -0
  43. package/marketplace/plugins/stats/src/sampler.ts +39 -5
  44. package/marketplace/plugins/stats/src/snapshot.ts +6 -0
  45. package/package.json +4 -3
  46. package/public/manifest.webmanifest +1 -0
  47. package/src/client/components/common/ComposerTextarea.test.tsx +109 -0
  48. package/src/client/components/common/ComposerTextarea.tsx +6 -0
  49. package/src/client/components/common/ReloadPageButton.test.tsx +14 -0
  50. package/src/client/components/common/ReloadPageButton.tsx +11 -2
  51. package/src/client/components/common/diagram-viewer/read-block.test.ts +71 -0
  52. package/src/client/components/common/diagram-viewer/read-block.ts +40 -16
  53. package/src/client/components/common/file-icon/index.tsx +7 -1
  54. package/src/client/components/common/harness-glyph/brands.ts +7 -1
  55. package/src/client/components/common/harness-glyph/index.tsx +18 -1
  56. package/src/client/components/common/image-viewer/index.tsx +37 -165
  57. package/src/client/components/common/picker-search/index.tsx +70 -0
  58. package/src/client/components/common/search-select/index.tsx +2 -7
  59. package/src/client/components/common/session-actions-menu/index.test.tsx +106 -0
  60. package/src/client/components/common/session-actions-menu/index.tsx +43 -1
  61. package/src/client/components/common/session-row/TrailingSlot.tsx +9 -4
  62. package/src/client/components/common/session-row/index.tsx +4 -0
  63. package/src/client/components/common/session-row/session-row.test.tsx +6 -0
  64. package/src/client/components/common/zoom-pan-stage/index.tsx +258 -0
  65. package/src/client/components/common/zoom-pan-stage/zoom-pan-stage.test.tsx +87 -0
  66. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +2 -1
  67. package/src/client/components/layout/session-sidebar/ClassicView.tsx +1 -1
  68. package/src/client/components/layout/session-sidebar/SessionItem.tsx +9 -1
  69. package/src/client/components/layout/session-sidebar/SessionListNotice.tsx +7 -3
  70. package/src/client/components/layout/session-sidebar/about-modal/HarnessRow.tsx +4 -1
  71. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.tsx +12 -1
  72. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogLine.test.tsx +82 -0
  73. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogLine.tsx +23 -3
  74. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +1 -0
  75. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +2 -1
  76. package/src/client/components/layout/session-sidebar/modern/index.tsx +1 -1
  77. package/src/client/components/layout/session-sidebar/scheduler-modal/ModelFields.tsx +202 -0
  78. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskForm.tsx +80 -19
  79. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskList.tsx +29 -7
  80. package/src/client/components/layout/session-sidebar/scheduler-modal/index.tsx +3 -0
  81. package/src/client/components/layout/session-sidebar/session-list-states.test.tsx +8 -0
  82. package/src/client/components/mobile/mobile-right-sidebar/EditorSurface.tsx +181 -0
  83. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +41 -86
  84. package/src/client/components/mobile/mobile-session-sidebar/ClassicDrawer.tsx +1 -1
  85. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +2 -1
  86. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.test.ts +6 -0
  87. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +9 -1
  88. package/src/client/components/settings/Modal.tsx +6 -2
  89. package/src/client/components/settings/Sidebar.tsx +32 -7
  90. package/src/client/components/settings/categories/HarnessSettings.tsx +15 -9
  91. package/src/client/components/settings/categories/NotificationSettings.test.tsx +40 -15
  92. package/src/client/components/settings/categories/NotificationSettings.tsx +142 -64
  93. package/src/client/components/settings/categories/PanelPluginSettings.tsx +3 -3
  94. package/src/client/components/settings/categories/PluginSettings.tsx +1 -1
  95. package/src/client/components/settings/categories/harness-settings/ConfigForm.tsx +3 -6
  96. package/src/client/components/settings/categories/harness-settings/CustomHarnessForm.tsx +186 -0
  97. package/src/client/components/settings/categories/panel-plugins/GitFreshness.test.tsx +36 -0
  98. package/src/client/components/settings/categories/panel-plugins/InstalledList.tsx +11 -0
  99. package/src/client/components/settings/categories/panel-plugins/PluginCard.test.tsx +1 -0
  100. package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +15 -1
  101. package/src/client/components/settings/categories/panel-plugins/Section.tsx +1 -3
  102. package/src/client/components/settings/categories/panel-plugins/SettingsModal.test.tsx +165 -0
  103. package/src/client/components/settings/categories/panel-plugins/SettingsModal.tsx +260 -0
  104. package/src/client/components/settings/categories/panel-plugins/Toolbar.tsx +18 -4
  105. package/src/client/components/settings/categories/plugin-settings/MarketplacePane.tsx +64 -61
  106. package/src/client/components/settings/categories/plugin-settings/SidebarList.tsx +15 -4
  107. package/src/client/components/settings/groups.test.tsx +2 -2
  108. package/src/client/components/workspace/chat-timeline/AiMessageFooter.fork.test.ts +24 -0
  109. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +8 -4
  110. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +34 -0
  111. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +3 -2
  112. package/src/client/components/workspace/chat-timeline/IrcNotice.test.tsx +55 -0
  113. package/src/client/components/workspace/chat-timeline/IrcNotice.tsx +71 -0
  114. package/src/client/components/workspace/chat-timeline/MessageItem.fork.test.ts +80 -0
  115. package/src/client/components/workspace/chat-timeline/MessageItem.tsx +13 -4
  116. package/src/client/components/workspace/chat-timeline/MessageList.tsx +3 -1
  117. package/src/client/components/workspace/chat-timeline/RunFooter.tsx +2 -1
  118. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +2 -1
  119. package/src/client/components/workspace/chat-timeline/chat-input/ComposerRows.tsx +8 -0
  120. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.test.tsx +9 -0
  121. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.tsx +4 -1
  122. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.test.ts +19 -0
  123. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +32 -3
  124. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.search.test.tsx +72 -0
  125. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.tsx +53 -33
  126. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +2 -0
  127. package/src/client/components/workspace/chat-timeline/chat-input/props.ts +5 -5
  128. package/src/client/components/workspace/chat-timeline/index.tsx +11 -5
  129. package/src/client/components/workspace/chat-timeline/target-picker/DraftTargetRow.tsx +1 -9
  130. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.test.tsx +129 -0
  131. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.tsx +30 -12
  132. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.test.tsx +47 -1
  133. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.tsx +55 -5
  134. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.tsx +3 -2
  135. package/src/client/components/workspace/editor/FilePane.tsx +41 -4
  136. package/src/client/components/workspace/editor/Notices.tsx +2 -2
  137. package/src/client/components/workspace/editor/Pane.tsx +2 -2
  138. package/src/client/components/workspace/editor/Toolbar.tsx +20 -10
  139. package/src/client/components/workspace/editor/index.tsx +6 -10
  140. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +5 -3
  141. package/src/client/components/workspace/editor/toolbar-clusters.tsx +26 -14
  142. package/src/client/components/workspace/editor/viewers/CsvGrid.tsx +52 -5
  143. package/src/client/components/workspace/editor/viewers/DataGrid.tsx +227 -41
  144. package/src/client/components/workspace/editor/viewers/DrawioView.tsx +93 -0
  145. package/src/client/components/workspace/editor/viewers/GridRow.tsx +91 -0
  146. package/src/client/components/workspace/editor/viewers/GridToolbar.tsx +53 -0
  147. package/src/client/components/workspace/editor/viewers/SheetView.tsx +152 -57
  148. package/src/client/components/workspace/editor/viewers/dispatch.tsx +42 -9
  149. package/src/client/components/workspace/editor/viewers/drawio-pages.test.ts +80 -0
  150. package/src/client/components/workspace/editor/viewers/drawio-pages.ts +63 -0
  151. package/src/client/components/workspace/editor/viewers/grid.test.ts +296 -0
  152. package/src/client/components/workspace/editor/viewers/use-cell-edit.ts +64 -0
  153. package/src/client/components/workspace/editor/viewers/use-grid-interaction.ts +216 -0
  154. package/src/client/components/workspace/editor/viewers/viewers.test.ts +47 -2
  155. package/src/client/components/workspace/editor/viewers/workbook.ts +149 -0
  156. package/src/client/components/workspace/file-explorer/ArchiveModals.tsx +262 -0
  157. package/src/client/components/workspace/file-explorer/ContextMenu.tsx +30 -6
  158. package/src/client/components/workspace/file-explorer/Modals.tsx +8 -3
  159. package/src/client/components/workspace/file-explorer/RootOverlays.tsx +60 -0
  160. package/src/client/components/workspace/file-explorer/RowLabel.tsx +6 -2
  161. package/src/client/components/workspace/file-explorer/TreeItem.tsx +39 -49
  162. package/src/client/components/workspace/file-explorer/TreeItemModals.tsx +80 -0
  163. package/src/client/components/workspace/file-explorer/index.tsx +53 -29
  164. package/src/client/components/workspace/file-explorer/selection.test.tsx +109 -0
  165. package/src/client/components/workspace/terminal-panel/RealtimeTerminalView.tsx +9 -1
  166. package/src/client/components/workspace/terminal-panel/focus.test.ts +70 -0
  167. package/src/client/components/workspace/terminal-panel/focus.ts +46 -0
  168. package/src/client/components/workspace/terminal-panel/index.tsx +14 -1
  169. package/src/client/components/workspace/terminal-panel/mount.ts +17 -9
  170. package/src/client/components/workspace/terminal-panel/scroll-hold.test.ts +158 -0
  171. package/src/client/components/workspace/terminal-panel/scroll-hold.ts +136 -0
  172. package/src/client/data/settings/omp-schema.json +169 -22
  173. package/src/client/glass.css +39 -14
  174. package/src/client/glass.test.ts +37 -0
  175. package/src/client/hooks/chat/composer/history.test.ts +267 -0
  176. package/src/client/hooks/chat/composer/history.ts +146 -0
  177. package/src/client/hooks/chat/composer/use-draft.ts +45 -1
  178. package/src/client/hooks/chat/omp/pending-sessions.waiting.test.ts +11 -10
  179. package/src/client/hooks/chat/omp/pending-waiting.ts +15 -7
  180. package/src/client/hooks/chat/omp/prompt-send.test.ts +11 -0
  181. package/src/client/hooks/chat/omp/prompt-send.ts +3 -0
  182. package/src/client/hooks/chat/timeline/actions.ts +4 -4
  183. package/src/client/hooks/chat/timeline/ask-frames.test.ts +54 -0
  184. package/src/client/hooks/chat/timeline/ask-frames.ts +29 -1
  185. package/src/client/hooks/chat/timeline/composer-modes.ts +13 -2
  186. package/src/client/hooks/chat/timeline/fork-open.ts +52 -0
  187. package/src/client/hooks/chat/timeline/index.ts +5 -2
  188. package/src/client/hooks/chat/timeline/mode-availability.ts +7 -0
  189. package/src/client/hooks/chat/timeline/modes-contract.ts +6 -0
  190. package/src/client/hooks/chat/timeline/modes-hydrate.ts +93 -0
  191. package/src/client/hooks/chat/timeline/modes.ts +32 -52
  192. package/src/client/hooks/chat/timeline/new-chat-open.ts +7 -6
  193. package/src/client/hooks/chat/timeline/new-chat.ts +10 -1
  194. package/src/client/hooks/chat/timeline/pending-dispatch.ts +4 -0
  195. package/src/client/hooks/chat/timeline/pending-session-mode.test.ts +136 -0
  196. package/src/client/hooks/chat/timeline/pending-session-mode.ts +69 -0
  197. package/src/client/hooks/chat/timeline/pending-warmup.test.ts +147 -0
  198. package/src/client/hooks/chat/timeline/pending-warmup.ts +62 -0
  199. package/src/client/hooks/chat/timeline/run-identity.test.ts +12 -0
  200. package/src/client/hooks/chat/timeline/run-identity.ts +4 -1
  201. package/src/client/hooks/chat/timeline/send-props.ts +2 -0
  202. package/src/client/hooks/chat/timeline/send-steer.test.ts +1 -0
  203. package/src/client/hooks/chat/timeline/send.test-util.ts +1 -0
  204. package/src/client/hooks/chat/timeline/send.test.ts +1 -0
  205. package/src/client/hooks/chat/timeline/session-harness.ts +4 -0
  206. package/src/client/hooks/chat/timeline/timeline-rail.test.ts +34 -2
  207. package/src/client/hooks/chat/timeline/use-fork-session.ts +9 -22
  208. package/src/client/hooks/chat/timeline/user-turns.ts +31 -2
  209. package/src/client/hooks/chat/waiting/cancel.ts +13 -6
  210. package/src/client/hooks/chat/waiting/choice.ts +13 -16
  211. package/src/client/hooks/chat/waiting/composer-wait.ts +70 -0
  212. package/src/client/hooks/chat/waiting/dispatch.ts +48 -28
  213. package/src/client/hooks/chat/waiting/held.ts +37 -13
  214. package/src/client/hooks/chat/waiting/hold.test.ts +22 -0
  215. package/src/client/hooks/chat/waiting/hold.ts +20 -11
  216. package/src/client/hooks/chat/waiting/restore.test.ts +69 -0
  217. package/src/client/hooks/chat/waiting/restore.ts +34 -0
  218. package/src/client/hooks/chat/waiting/store.ts +9 -3
  219. package/src/client/hooks/editor/file-editor-types.ts +36 -12
  220. package/src/client/hooks/editor/save-bytes.ts +79 -0
  221. package/src/client/hooks/editor/save-file.test.ts +1 -1
  222. package/src/client/hooks/editor/save-file.ts +35 -8
  223. package/src/client/hooks/editor/target-key.ts +17 -0
  224. package/src/client/hooks/editor/use-disk-digest.test.ts +82 -0
  225. package/src/client/hooks/editor/use-disk-digest.ts +164 -0
  226. package/src/client/hooks/editor/use-disk-sync.ts +212 -0
  227. package/src/client/hooks/editor/use-file-cache.ts +113 -0
  228. package/src/client/hooks/editor/use-file-editor.test.ts +120 -0
  229. package/src/client/hooks/editor/use-file-editor.ts +143 -57
  230. package/src/client/hooks/editor/use-file-read.ts +45 -12
  231. package/src/client/hooks/editor/use-file-writes.ts +4 -4
  232. package/src/client/hooks/editor/use-grid-selection.ts +160 -0
  233. package/src/client/hooks/models/harness-catalog.ts +15 -0
  234. package/src/client/hooks/models/use-harness-update.test.ts +35 -2
  235. package/src/client/hooks/models/use-harness-update.ts +49 -10
  236. package/src/client/hooks/ui/notifications.ts +17 -8
  237. package/src/client/hooks/workspace/diff-file.test.ts +72 -0
  238. package/src/client/hooks/workspace/diff-file.ts +12 -6
  239. package/src/client/hooks/workspace/file-archive.ts +220 -0
  240. package/src/client/hooks/workspace/file-clipboard.test.ts +4 -4
  241. package/src/client/hooks/workspace/file-clipboard.ts +37 -26
  242. package/src/client/hooks/workspace/file-selection.test.ts +67 -0
  243. package/src/client/hooks/workspace/file-selection.ts +156 -0
  244. package/src/client/hooks/workspace/file-tree-actions-clipboard.test.ts +5 -5
  245. package/src/client/hooks/workspace/file-tree-actions.ts +36 -8
  246. package/src/client/hooks/workspace/panel-registry.ts +1 -1
  247. package/src/client/hooks/workspace/scheduled-tasks.ts +26 -11
  248. package/src/client/lib/editor/workbook-drafts.ts +42 -0
  249. package/src/client/lib/launch/file-handlers.ts +2 -2
  250. package/src/client/lib/notifications/os.test.ts +1 -30
  251. package/src/client/lib/notifications/os.ts +0 -15
  252. package/src/client/lib/notifications/platform.test.ts +68 -0
  253. package/src/client/lib/notifications/platform.ts +36 -0
  254. package/src/client/lib/scrollbar-activity.test.ts +21 -88
  255. package/src/client/lib/scrollbar-activity.ts +71 -73
  256. package/src/client/lib/scrollbar-events.ts +143 -0
  257. package/src/client/lib/scrollbar-input.test.ts +126 -0
  258. package/src/client/lib/scrollbar-probe.test-util.ts +107 -0
  259. package/src/client/tailwind.css +32 -1
  260. package/src/server/db.server.test.ts +50 -1
  261. package/src/server/db.server.ts +36 -3
  262. package/src/server/index.ts +7 -0
  263. package/src/server/lib/chat/prompt-history.server.test.ts +92 -0
  264. package/src/server/lib/chat/prompt-history.server.ts +65 -0
  265. package/src/server/lib/chat/schema.server.ts +35 -0
  266. package/src/server/lib/db/schema.ts +3 -0
  267. package/src/server/lib/fs/archive.test.ts +139 -0
  268. package/src/server/lib/fs/archive.ts +259 -0
  269. package/src/server/lib/fs/git-diff.test.ts +26 -1
  270. package/src/server/lib/fs/git-diff.ts +43 -15
  271. package/src/server/lib/harness/acp/client.ts +81 -87
  272. package/src/server/lib/harness/acp/prewarm.server.ts +237 -0
  273. package/src/server/lib/harness/acp/prewarm.test.ts +171 -0
  274. package/src/server/lib/harness/acp/prompt.test.ts +70 -1
  275. package/src/server/lib/harness/acp/prompt.ts +32 -1
  276. package/src/server/lib/harness/acp/protocol.ts +23 -0
  277. package/src/server/lib/harness/acp/session-handshake.test.ts +26 -0
  278. package/src/server/lib/harness/acp/session-handshake.ts +22 -20
  279. package/src/server/lib/harness/acp/session-options.ts +16 -0
  280. package/src/server/lib/harness/acp/session-process.ts +43 -0
  281. package/src/server/lib/harness/acp/session.ts +11 -12
  282. package/src/server/lib/harness/acp/stdio.ts +129 -0
  283. package/src/server/lib/harness/acp/verbs.test.ts +97 -0
  284. package/src/server/lib/harness/acp/verbs.ts +16 -6
  285. package/src/server/lib/harness/auto-probe.server.ts +4 -3
  286. package/src/server/lib/harness/capabilities.ts +8 -0
  287. package/src/server/lib/harness/config.server.ts +3 -2
  288. package/src/server/lib/harness/custom.server.ts +209 -0
  289. package/src/server/lib/harness/launch-table.ts +19 -0
  290. package/src/server/lib/harness/launch.ts +6 -1
  291. package/src/server/lib/harness/provider-entry.ts +1 -1
  292. package/src/server/lib/harness/provider-file.server.ts +1 -1
  293. package/src/server/lib/harness/provider-sources.server.ts +2 -1
  294. package/src/server/lib/harness/provider-write.server.ts +2 -1
  295. package/src/server/lib/harness/register.server.ts +8 -1
  296. package/src/server/lib/harness/schema.server.ts +21 -0
  297. package/src/server/lib/harness/session-lease.server.test.ts +99 -0
  298. package/src/server/lib/harness/session-lease.server.ts +193 -0
  299. package/src/server/lib/harness/session-store.server.test.ts +8 -8
  300. package/src/server/lib/harness/session-store.server.ts +25 -4
  301. package/src/server/lib/harness/session-title.server.ts +12 -2
  302. package/src/server/lib/harness/spawn.server.ts +123 -20
  303. package/src/server/lib/harness/update-job-store.ts +12 -0
  304. package/src/server/lib/harness/update-queue.server.ts +18 -13
  305. package/src/server/lib/lifecycle/after-listen.ts +12 -1
  306. package/src/server/lib/lifecycle/paths.ts +19 -1
  307. package/src/server/lib/mcp/registry.server.ts +155 -0
  308. package/src/server/lib/mcp/registry.test.ts +169 -0
  309. package/src/server/lib/mcp/store.server.ts +38 -0
  310. package/src/server/lib/omp/rpc/frame-fold-contract.ts +59 -0
  311. package/src/server/lib/omp/rpc/frame-fold-frames.test.ts +64 -1
  312. package/src/server/lib/omp/rpc/frame-fold-host.test-util.ts +2 -1
  313. package/src/server/lib/omp/rpc/frame-fold-signals.test.ts +5 -1
  314. package/src/server/lib/omp/rpc/frame-fold.test.ts +7 -2
  315. package/src/server/lib/omp/rpc/frame-fold.ts +6 -45
  316. package/src/server/lib/omp/rpc/lifecycle.test.ts +4 -0
  317. package/src/server/lib/omp/rpc/prewarm-pool.ts +19 -5
  318. package/src/server/lib/omp/rpc/run-model.test.ts +116 -0
  319. package/src/server/lib/omp/rpc/run-model.ts +4 -2
  320. package/src/server/lib/omp/session/auto-title.server.test.ts +4 -0
  321. package/src/server/lib/omp/session/delete.server.ts +1 -0
  322. package/src/server/lib/omp/session/goal-driver.test.ts +5 -1
  323. package/src/server/lib/omp/session/goal-settings.test.ts +5 -1
  324. package/src/server/lib/omp/session/sidebar-data.harness.test.ts +6 -3
  325. package/src/server/lib/omp/session/standby.server.ts +13 -2
  326. package/src/server/lib/panels/auto-update.server.test.ts +5 -2
  327. package/src/server/lib/panels/git-update.server.test.ts +5 -2
  328. package/src/server/lib/panels/install.server.test.ts +5 -2
  329. package/src/server/lib/panels/manifest.test.ts +47 -1
  330. package/src/server/lib/panels/manifest.ts +19 -0
  331. package/src/server/lib/panels/registry.server.ts +19 -2
  332. package/src/server/lib/panels/remove.server.test.ts +5 -2
  333. package/src/server/lib/panels/scan.server.ts +26 -2
  334. package/src/server/lib/panels/settings-schema.server.ts +72 -0
  335. package/src/server/lib/plugins/background.server.ts +21 -3
  336. package/src/server/lib/plugins/background.test.ts +13 -0
  337. package/src/server/lib/plugins/loader.server.ts +35 -51
  338. package/src/server/lib/plugins/mcp.server.ts +100 -0
  339. package/src/server/lib/plugins/mcp.test.ts +75 -0
  340. package/src/server/lib/plugins/schedule-runner.server.ts +153 -0
  341. package/src/server/lib/plugins/schedule-runner.test.ts +186 -0
  342. package/src/server/lib/plugins/schedule-store.server.ts +107 -0
  343. package/src/server/lib/plugins/schema.server.ts +8 -0
  344. package/src/server/lib/plugins/settings.server.ts +56 -19
  345. package/src/server/lib/plugins/shutdown.server.ts +58 -0
  346. package/src/server/lib/plugins/shutdown.test.ts +28 -3
  347. package/src/server/lib/realtime/topics/global.server.ts +5 -1
  348. package/src/server/lib/schedule/rows.server.ts +9 -0
  349. package/src/server/lib/schedule/runtime.server.test.ts +91 -0
  350. package/src/server/lib/schedule/runtime.server.ts +101 -23
  351. package/src/server/lib/schedule/schema.server.ts +15 -0
  352. package/src/server/lib/schedule/store.server.test.ts +34 -0
  353. package/src/server/lib/schedule/store.server.ts +33 -9
  354. package/src/server/lib/sessions/fork.server.test.ts +47 -0
  355. package/src/server/lib/sessions/fork.server.ts +17 -1
  356. package/src/server/lib/sessions/spawn.server.ts +2 -2
  357. package/src/server/lib/waiting/runtime.server.test.ts +48 -0
  358. package/src/server/lib/waiting/runtime.server.ts +22 -0
  359. package/src/server/lib/waiting/schema.server.ts +8 -0
  360. package/src/server/lib/waiting/store.server.test.ts +14 -0
  361. package/src/server/lib/waiting/store.server.ts +6 -2
  362. package/src/server/routes/agent/command-resume.test.ts +9 -4
  363. package/src/server/routes/agent/command.ts +11 -0
  364. package/src/server/routes/agent/new-mode.test.ts +40 -0
  365. package/src/server/routes/agent/new.ts +36 -10
  366. package/src/server/routes/agent/prewarm.ts +48 -7
  367. package/src/server/routes/chat/index.ts +5 -0
  368. package/src/server/routes/chat/prompt-history.test.ts +67 -0
  369. package/src/server/routes/chat/prompt-history.ts +31 -0
  370. package/src/server/routes/chat/stream.test.ts +21 -0
  371. package/src/server/routes/chat/stream.ts +5 -0
  372. package/src/server/routes/fs/action-archive.test.ts +128 -0
  373. package/src/server/routes/fs/action-bulk.ts +106 -0
  374. package/src/server/routes/fs/action-save-bytes.test.ts +59 -0
  375. package/src/server/routes/fs/action-transfer.test.ts +26 -0
  376. package/src/server/routes/fs/action.ts +100 -12
  377. package/src/server/routes/fs/archive.ts +20 -0
  378. package/src/server/routes/fs/digest.test.ts +100 -0
  379. package/src/server/routes/fs/digest.ts +106 -0
  380. package/src/server/routes/fs/grant.test.ts +5 -2
  381. package/src/server/routes/fs/index.ts +4 -0
  382. package/src/server/routes/fs/read.ts +6 -1
  383. package/src/server/routes/fs/scope.test.ts +6 -2
  384. package/src/server/routes/harness/custom.test.ts +131 -0
  385. package/src/server/routes/harness/import-action.ts +3 -3
  386. package/src/server/routes/harness/root.ts +47 -9
  387. package/src/server/routes/harness/summary.test.ts +50 -0
  388. package/src/server/routes/harness/update-status.ts +41 -2
  389. package/src/server/routes/harness/update.test.ts +56 -2
  390. package/src/server/routes/harness/update.ts +2 -2
  391. package/src/server/routes/panels/bindings.ts +2 -0
  392. package/src/server/routes/panels/settings.test.ts +165 -0
  393. package/src/server/routes/panels/settings.ts +106 -0
  394. package/src/server/routes/schedule/body.ts +14 -0
  395. package/src/server/routes/schedule/index.ts +28 -4
  396. package/src/server/routes/sessions/delete.test.ts +4 -0
  397. package/src/server/routes/settings/mcp.ts +9 -26
  398. package/src/server/routes/waiting/index.ts +21 -2
  399. package/src/server/routes/waiting/routes.test.ts +21 -0
  400. package/src/shared/lib/chat/ask-form/index.ts +39 -31
  401. package/src/shared/lib/chat/ask-form/labels.ts +46 -0
  402. package/src/shared/lib/chat/ask-form/tokens.ts +11 -2
  403. package/src/shared/lib/chat/ask-form.test.ts +57 -0
  404. package/src/shared/lib/chat/ask-questions.ts +31 -0
  405. package/src/shared/lib/chat/composer/delegation.ts +3 -3
  406. package/src/shared/lib/chat/composer/history.test.ts +67 -0
  407. package/src/shared/lib/chat/composer/history.ts +61 -0
  408. package/src/shared/lib/chat/irc-notice.ts +42 -0
  409. package/src/shared/lib/chat/timeline/fork-anchor.test.ts +99 -0
  410. package/src/shared/lib/chat/timeline/fork-anchor.ts +47 -0
  411. package/src/shared/lib/chat/todo/parser.ts +6 -4
  412. package/src/shared/lib/fs/archive.test.ts +101 -0
  413. package/src/shared/lib/fs/archive.ts +191 -0
  414. package/src/shared/lib/fs/clipboard.test.ts +32 -7
  415. package/src/shared/lib/fs/clipboard.ts +59 -14
  416. package/src/shared/lib/fs/content-hash.ts +29 -0
  417. package/src/shared/lib/fs/csv.test.ts +50 -0
  418. package/src/shared/lib/fs/csv.ts +40 -0
  419. package/src/shared/lib/fs/document-kind.test.ts +13 -6
  420. package/src/shared/lib/fs/document-kind.ts +18 -6
  421. package/src/shared/lib/fs/file-kind-classify.test.ts +4 -0
  422. package/src/shared/lib/fs/file-kind.test.ts +2 -7
  423. package/src/shared/lib/fs/file-kind.ts +4 -2
  424. package/src/shared/lib/fs/grid-edit.test.ts +24 -0
  425. package/src/shared/lib/fs/grid-edit.ts +29 -0
  426. package/src/shared/lib/fs/grid-selection.test.ts +137 -0
  427. package/src/shared/lib/fs/grid-selection.ts +138 -0
  428. package/src/shared/lib/harness/brand-color.ts +5 -0
  429. package/src/shared/lib/harness/catalog.test.ts +22 -0
  430. package/src/shared/lib/harness/catalog.ts +60 -7
  431. package/src/shared/lib/harness/config-fields.test.ts +25 -0
  432. package/src/shared/lib/harness/config-fields.ts +33 -3
  433. package/src/shared/lib/harness/dialects.ts +1 -1
  434. package/src/shared/lib/harness/fork.ts +60 -0
  435. package/src/shared/lib/harness/mcp-facts.test.ts +30 -0
  436. package/src/shared/lib/harness/mcp-facts.ts +69 -0
  437. package/src/shared/lib/harness/menu.test.ts +16 -1
  438. package/src/shared/lib/harness/menu.ts +2 -2
  439. package/src/shared/lib/harness/provider-contracts.ts +109 -0
  440. package/src/shared/lib/harness/provider-facts.test.ts +2 -1
  441. package/src/shared/lib/harness/provider-facts.ts +24 -115
  442. package/src/shared/lib/harness/provider-lookup.ts +37 -0
  443. package/src/shared/lib/harness/providers.ts +2 -1
  444. package/src/shared/lib/harness/rewind.ts +6 -6
  445. package/src/shared/lib/harness/session-modes.ts +31 -0
  446. package/src/shared/lib/harness/transcript.test.ts +29 -0
  447. package/src/shared/lib/harness/transcript.ts +19 -0
  448. package/src/shared/lib/harness/updates.ts +10 -0
  449. package/src/shared/lib/notifications/settings.test.ts +21 -0
  450. package/src/shared/lib/notifications/settings.ts +24 -0
  451. package/src/shared/lib/omp/session/mapper.test.ts +31 -0
  452. package/src/shared/lib/omp/session/mapper.ts +17 -0
  453. package/src/shared/lib/omp/session/messages-map-notice.test.ts +68 -0
  454. package/src/shared/lib/omp/session/messages-map.test.ts +1 -35
  455. package/src/shared/lib/omp/session/messages-map.ts +17 -0
  456. package/src/shared/lib/omp/session/prewarm.test.ts +28 -4
  457. package/src/shared/lib/omp/session/prewarm.ts +25 -6
  458. package/src/shared/lib/omp/session/stream-state.server.test.ts +25 -0
  459. package/src/shared/lib/omp/session/stream-state.server.ts +8 -4
  460. package/src/shared/lib/omp/session/wait.ts +10 -1
  461. package/src/shared/lib/panels/capabilities.test.ts +1 -1
  462. package/src/shared/lib/panels/capabilities.ts +3 -0
  463. package/src/shared/lib/plugins/settings.ts +22 -0
  464. package/src/shared/lib/schedule/parse.test.ts +48 -0
  465. package/src/shared/lib/schedule/parse.ts +69 -45
  466. package/src/shared/lib/schedule/timezone.ts +128 -0
  467. package/src/shared/lib/settings/defaults.ts +2 -0
  468. package/src/shared/lib/settings/sections.ts +8 -4
  469. package/src/shared/lib/ui/picker-filter.test.ts +23 -0
  470. package/src/shared/lib/ui/picker-filter.ts +20 -0
  471. package/src/shared/lib/workspace/refresh-cadence.test.ts +25 -1
  472. package/src/shared/lib/workspace/relative-time.ts +16 -0
  473. package/src/shared/types/chat.ts +4 -0
  474. package/src/shared/types/harness.ts +12 -1
  475. package/src/shared/types/omp/agent.ts +6 -0
  476. package/src/shared/types/omp/session.ts +18 -0
  477. package/src/shared/types/panels-registry.ts +3 -3
  478. package/src/shared/types/panels.ts +4 -2
  479. package/src/shared/types/schedule.ts +13 -0
  480. package/src/shared/types/settings/state.ts +18 -7
  481. package/src/shared/types/todo.ts +3 -1
  482. package/src/shared/types/waiting.ts +9 -0
  483. package/src/test-support/file-actions.test-util.ts +4 -0
  484. package/src/test-support/file-archive.test-util.ts +41 -0
  485. package/src/test-support/file-clipboard.test-util.ts +9 -6
  486. package/src/test-support/file-editor.test-util.ts +70 -5
  487. package/src/test-support/harness-table.test-util.ts +2 -0
  488. package/src/test-support/preload.ts +46 -0
  489. package/dist/client/static/js/index-32rpkj6b.css +0 -1
  490. package/src/client/hooks/editor/use-external-change-notice.ts +0 -71
  491. package/src/client/hooks/editor/use-external-change.test.ts +0 -88
  492. package/src/client/hooks/editor/use-external-change.ts +0 -146
@@ -0,0 +1,237 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The ACP prewarm pool: one started *process*, spawned ahead of the first
8
+ * prompt so the send adopts it instead of paying the agent's boot.
9
+ *
10
+ * A cold ACP chat costs a process spawn and an `initialize` handshake before
11
+ * `session/new` can even be asked. Measured on `omp-acp`: ~1 ms spawn, ~100 ms
12
+ * `initialize`, ~80-120 ms `session/new`. The first two do not depend on what
13
+ * the user is about to type, so they happen while the prompt is written.
14
+ *
15
+ * **Only `initialize`. Deliberately.** Warming through `session/new` was tried
16
+ * and reverted: `omp-acp` writes its session JSONL at that moment, and Kabmo's
17
+ * sidebar scans that directory — so a warm child that nobody claimed appeared as
18
+ * an empty chat row (measured: the file lands before any prompt, and it outlives
19
+ * the child). A prewarm must be invisible, so it stops at the handshake that
20
+ * creates nothing.
21
+ *
22
+ * **Why this pool can be warmer than omp's.** omp's modes ride the spawn
23
+ * ENVIRONMENT (`KABMO_MODES`), read once at session start, so an entry whose
24
+ * selection differs has to be killed. ACP publishes model, thinking level and
25
+ * mode as config selectors and the approval tier as in-process state; the
26
+ * adopting session applies them after `session/new`, exactly as a cold spawn
27
+ * does. A prewarmed process therefore serves ANY pick.
28
+ *
29
+ * The pool is keyed by harness + cwd. One pending chat runs one agent, so a
30
+ * second pick in the same folder replaces the first candidate; an unclaimed
31
+ * entry is also disposed after `ACP_PREWARM_TTL_MS`.
32
+ */
33
+
34
+ import { mintAgentEnvironment } from '@/server/lib/sessions/agent-token.server';
35
+ import { loadHarnessConfig, resolveLaunch } from '@/server/lib/harness/config.server';
36
+ import { sessionLaunchCommand } from '@/server/lib/harness/launch';
37
+ import { AcpProcess } from '@/server/lib/harness/acp/client';
38
+ import { IDLE_REAP_MS } from '@/server/lib/omp/rpc/constants';
39
+ import { withGatewayCompatibility } from '@/server/lib/harness/acp/gateway-env';
40
+ import { noteHarnessLease, removeHarnessLease } from '@/server/lib/harness/session-lease.server';
41
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
42
+
43
+ /** How long an unclaimed warm agent is kept. Long enough to write a prompt,
44
+ * short enough that a pick the user abandoned costs one process, not a day. */
45
+ export const ACP_PREWARM_TTL_MS = IDLE_REAP_MS;
46
+
47
+ /** A spawned, initialized agent waiting for the chat that will adopt it. */
48
+ export interface PrewarmedAcp {
49
+ process: AcpProcess;
50
+ /** The callback credential its environment carries; the claim records it
51
+ * against the session id `session/new` answers. */
52
+ token: string;
53
+ }
54
+
55
+ export interface PrewarmedAcpEntry {
56
+ harness: HarnessId;
57
+ cwd: string;
58
+ createdAt: number;
59
+ /** Set by the claim BEFORE it awaits readiness: two sends racing one entry
60
+ * must not both adopt it. */
61
+ claimed: boolean;
62
+ /** Resolves the warm process, or null when the spawn failed or the child died
63
+ * before it was claimed. Never rejects — an entry nobody claims must not
64
+ * surface as an unhandled rejection. */
65
+ ready: Promise<PrewarmedAcp | null>;
66
+ }
67
+
68
+ declare global {
69
+ // eslint-disable-next-line no-var
70
+ var __kabmoAcpPrewarmed: Map<string, PrewarmedAcpEntry> | undefined;
71
+ }
72
+
73
+ export function getPrewarmedAcp(): Map<string, PrewarmedAcpEntry> {
74
+ globalThis.__kabmoAcpPrewarmed ??= new Map();
75
+ return globalThis.__kabmoAcpPrewarmed;
76
+ }
77
+
78
+ /** One entry per harness AND cwd: two agents in one folder are two processes. */
79
+ export function acpPrewarmKey(harness: HarnessId, cwd: string): string {
80
+ return `${harness}\u0000${cwd}`;
81
+ }
82
+
83
+ /** The seam a test drives; the real opener spawns a process. */
84
+ export interface AcpPrewarmDeps {
85
+ open: (harness: HarnessId, cwd: string) => Promise<PrewarmedAcp>;
86
+ }
87
+
88
+ /** The launch line and env a prewarm — and the spawn that adopts it — use. */
89
+ async function openProcess(harness: HarnessId, cwd: string): Promise<PrewarmedAcp> {
90
+ const configured = await loadHarnessConfig(harness);
91
+ const launch = resolveLaunch(harness, configured);
92
+ const { token, env } = mintAgentEnvironment();
93
+ const merged = withGatewayCompatibility(harness, { ...(launch.env ?? {}), ...env });
94
+ const process = new AcpProcess({
95
+ command: sessionLaunchCommand(harness, launch.command),
96
+ cwd,
97
+ ...(merged ? { env: merged } : {}),
98
+ // Nobody owns this child yet. The adopting session re-binds these sinks; a
99
+ // frame that arrives in between is an unsolicited status update, which a
100
+ // session learns from `session/new` anyway.
101
+ onNotification: () => {},
102
+ onStderr: () => {},
103
+ });
104
+ // A prewarm is a real process the Stats panel must be able to name: without
105
+ // this lease it is a bare `npx` row inside Kabmo's own group. The claim
106
+ // overwrites the record with the session's id and title, keeping `startedAt`.
107
+ const pid = process.pid;
108
+ if (pid) noteHarnessLease({ pid, harness, cwd, state: 'prewarm' });
109
+ try {
110
+ await process.initialize();
111
+ } catch (error) {
112
+ if (pid) removeHarnessLease(pid);
113
+ throw error;
114
+ }
115
+ if (!process.isAlive) {
116
+ if (pid) removeHarnessLease(pid);
117
+ await process.dispose(1_000).catch(() => {});
118
+ throw new Error(`${harness} exited while warming`);
119
+ }
120
+ return { process, token };
121
+ }
122
+
123
+ const defaultDeps: AcpPrewarmDeps = { open: openProcess };
124
+
125
+ /** Drop an unclaimed entry and dispose its child. */
126
+ async function discard(key: string): Promise<void> {
127
+ const pool = getPrewarmedAcp();
128
+ const entry = pool.get(key);
129
+ if (!entry || entry.claimed) return;
130
+ entry.claimed = true;
131
+ pool.delete(key);
132
+ const warm = await entry.ready;
133
+ if (warm?.process.pid) removeHarnessLease(warm.process.pid);
134
+ await warm?.process.dispose(1_000).catch(() => {});
135
+ }
136
+
137
+ /**
138
+ * Drop the warm agents for `cwd` that belong to OTHER harnesses.
139
+ *
140
+ * One pending chat runs one agent, so the previous candidate is spent: keeping
141
+ * it would cost a process for a choice the operator already left.
142
+ */
143
+ async function discardOtherPrewarms(harness: HarnessId, cwd: string): Promise<void> {
144
+ const doomed = [...getPrewarmedAcp()]
145
+ .filter(([, entry]) => entry.cwd === cwd && entry.harness !== harness && !entry.claimed)
146
+ .map(([key]) => key);
147
+ await Promise.all(doomed.map((key) => discard(key)));
148
+ }
149
+
150
+ /**
151
+ * Spawn (at most one) idle agent for `harness` in `cwd` so the next new-chat
152
+ * send starts instantly. Fire-and-forget; a failed spawn just clears itself.
153
+ * Safe to call repeatedly — an existing live or in-flight entry wins.
154
+ */
155
+ export function prewarmAcpSession(
156
+ harness: HarnessId,
157
+ cwd: string,
158
+ deps: AcpPrewarmDeps = defaultDeps,
159
+ ): void {
160
+ const pool = getPrewarmedAcp();
161
+ const key = acpPrewarmKey(harness, cwd);
162
+ if (pool.has(key)) return;
163
+ // Fire-and-forget on purpose: the old entry's teardown must not delay this
164
+ // agent's boot, and `discard` marks it claimed before awaiting anything.
165
+ void discardOtherPrewarms(harness, cwd);
166
+
167
+ const entry: PrewarmedAcpEntry = {
168
+ harness,
169
+ cwd,
170
+ createdAt: Date.now(),
171
+ claimed: false,
172
+ ready: Promise.resolve(null),
173
+ };
174
+ entry.ready = deps.open(harness, cwd)
175
+ .then(async (warm) => {
176
+ // A child that died while warming must not be handed out.
177
+ if (warm.process.isAlive) return warm;
178
+ await warm.process.dispose(1_000).catch(() => {});
179
+ return null;
180
+ })
181
+ .catch((error: unknown) => {
182
+ console.error(`[harness] prewarm of ${harness} in ${cwd} failed:`, error);
183
+ return null;
184
+ })
185
+ .then((warm) => {
186
+ // A failed spawn leaves no entry: the next prewarm retries instead of
187
+ // finding a permanently empty slot.
188
+ if (!warm && pool.get(key) === entry) pool.delete(key);
189
+ return warm;
190
+ });
191
+ pool.set(key, entry);
192
+
193
+ const timer = setTimeout(() => {
194
+ void discard(key);
195
+ }, ACP_PREWARM_TTL_MS);
196
+ // A warm child must not keep the process alive on its own.
197
+ timer.unref?.();
198
+ }
199
+
200
+ /**
201
+ * Take the prewarmed agent for `harness`+`cwd`, or null when there is none to
202
+ * take. The claim is a synchronous check-and-set: two sends racing the same
203
+ * entry must not both adopt it.
204
+ */
205
+ export async function claimPrewarmedAcpSession(
206
+ harness: HarnessId,
207
+ cwd: string,
208
+ ): Promise<PrewarmedAcp | null> {
209
+ const pool = getPrewarmedAcp();
210
+ const key = acpPrewarmKey(harness, cwd);
211
+ const entry = pool.get(key);
212
+ if (!entry || entry.claimed) return null;
213
+ entry.claimed = true;
214
+ pool.delete(key);
215
+ const warm = await entry.ready;
216
+ if (warm?.process.isAlive) return warm;
217
+ if (warm?.process.pid) removeHarnessLease(warm.process.pid);
218
+ await warm?.process.dispose(1_000).catch(() => {});
219
+ return null;
220
+ }
221
+
222
+ /**
223
+ * Recycle every UNCLAIMED prewarmed agent.
224
+ *
225
+ * A warm child is a full agent process spawned from whatever binary was current
226
+ * when the user opened a pending chat. After an adapter update it is a stale
227
+ * build waiting to be adopted by the next send, so the recycle happens here
228
+ * rather than being left to the TTL. Safe because an unclaimed entry owns no
229
+ * session and no turn.
230
+ */
231
+ export async function restartPrewarmedAcpSessions(): Promise<number> {
232
+ const doomed = [...getPrewarmedAcp().entries()]
233
+ .filter(([, entry]) => !entry.claimed)
234
+ .map(([key]) => key);
235
+ await Promise.all(doomed.map((key) => discard(key)));
236
+ return doomed.length;
237
+ }
@@ -0,0 +1,171 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The ACP prewarm pool's identity and claim rules.
8
+ *
9
+ * Three properties here are load-bearing and invisible at the call site. The
10
+ * claim is a synchronous check-and-set: two sends racing one warm agent would
11
+ * both adopt it and one would talk to a session the other owns. A failed spawn
12
+ * must leave NO entry, or every later prewarm for that harness+cwd silently does
13
+ * nothing and the user keeps paying the boot. And the pool warms a PROCESS, not
14
+ * a session: `session/new` is what makes some agents write a session record, and
15
+ * a warm child must stay invisible until a chat adopts it.
16
+ *
17
+ * No agent process is ever spawned: the opener is a fake handle. The real opener
18
+ * is exercised by the spawn path itself.
19
+ */
20
+
21
+ import { afterEach, describe, expect, test } from 'bun:test';
22
+ import {
23
+ acpPrewarmKey,
24
+ claimPrewarmedAcpSession,
25
+ getPrewarmedAcp,
26
+ prewarmAcpSession,
27
+ restartPrewarmedAcpSessions,
28
+ type AcpPrewarmDeps,
29
+ type PrewarmedAcp,
30
+ } from '@/server/lib/harness/acp/prewarm.server';
31
+ import type { AcpProcess } from '@/server/lib/harness/acp/client';
32
+
33
+ interface Fake {
34
+ warm: PrewarmedAcp;
35
+ /** Resolves when the fake is disposed, so a test waits on the event rather
36
+ * than on a guessed delay. */
37
+ torn: Promise<void>;
38
+ disposed: boolean;
39
+ }
40
+
41
+ function fakeProcess(alive = true): Fake {
42
+ const torn = Promise.withResolvers<void>();
43
+ const state = { alive };
44
+ // A test double for the transport: only the two members the pool reads.
45
+ const process = {
46
+ get isAlive() {
47
+ return state.alive;
48
+ },
49
+ dispose: async () => {
50
+ state.alive = false;
51
+ fake.disposed = true;
52
+ torn.resolve();
53
+ },
54
+ } as unknown as AcpProcess;
55
+ const fake: Fake = { warm: { process, token: 'kabmo_agent_test' }, torn: torn.promise, disposed: false };
56
+ return fake;
57
+ }
58
+
59
+ /** An opener that records every call and hands out one fake per call. */
60
+ function opener(outcome?: () => Promise<PrewarmedAcp>): { deps: AcpPrewarmDeps; opened: string[]; fakes: Fake[] } {
61
+ const opened: string[] = [];
62
+ const fakes: Fake[] = [];
63
+ return {
64
+ opened,
65
+ fakes,
66
+ deps: {
67
+ open: async (harness, cwd) => {
68
+ opened.push(`${harness}@${cwd}`);
69
+ if (outcome) return outcome();
70
+ const fake = fakeProcess();
71
+ fakes.push(fake);
72
+ return fake.warm;
73
+ },
74
+ },
75
+ };
76
+ }
77
+
78
+ afterEach(() => {
79
+ getPrewarmedAcp().clear();
80
+ });
81
+
82
+ describe('prewarmAcpSession', () => {
83
+ test('spawns once per harness AND cwd', () => {
84
+ const { deps, opened } = opener();
85
+ prewarmAcpSession('claude', '/work', deps);
86
+ prewarmAcpSession('claude', '/work', deps);
87
+ expect(opened).toEqual(['claude@/work']);
88
+ expect(getPrewarmedAcp().has(acpPrewarmKey('claude', '/work'))).toBe(true);
89
+
90
+ // Two agents in one folder are two processes, and so are one agent in two.
91
+ prewarmAcpSession('codex', '/other', deps);
92
+ prewarmAcpSession('claude', '/elsewhere', deps);
93
+ expect(opened).toEqual(['claude@/work', 'codex@/other', 'claude@/elsewhere']);
94
+ });
95
+
96
+ test('a different harness for the same cwd replaces the warm agent', async () => {
97
+ const { deps, opened, fakes } = opener();
98
+ prewarmAcpSession('claude', '/work', deps);
99
+ prewarmAcpSession('codex', '/work', deps);
100
+ // One pending chat runs one agent: keeping the previous candidate would cost
101
+ // a process for a choice the operator already left.
102
+ await fakes[0]!.torn;
103
+ expect(getPrewarmedAcp().has(acpPrewarmKey('claude', '/work'))).toBe(false);
104
+ expect(getPrewarmedAcp().has(acpPrewarmKey('codex', '/work'))).toBe(true);
105
+ expect(opened).toEqual(['claude@/work', 'codex@/work']);
106
+ expect(fakes[0]?.disposed).toBe(true);
107
+ });
108
+
109
+ test('a failed spawn leaves no entry, so the next prewarm retries', async () => {
110
+ let attempt = 0;
111
+ const { deps } = opener(async () => {
112
+ attempt += 1;
113
+ if (attempt === 1) throw new Error('agent exited');
114
+ return fakeProcess().warm;
115
+ });
116
+ prewarmAcpSession('claude', '/work', deps);
117
+ // The failure settles asynchronously; wait for the entry's own promise so
118
+ // the assertion reads the state after the catch, not during it.
119
+ await getPrewarmedAcp().get(acpPrewarmKey('claude', '/work'))?.ready;
120
+ expect(getPrewarmedAcp().has(acpPrewarmKey('claude', '/work'))).toBe(false);
121
+
122
+ prewarmAcpSession('claude', '/work', deps);
123
+ expect(await claimPrewarmedAcpSession('claude', '/work')).not.toBeNull();
124
+ });
125
+ });
126
+
127
+ describe('claimPrewarmedAcpSession', () => {
128
+ test('adopts an entry exactly once', async () => {
129
+ const { deps } = opener();
130
+ prewarmAcpSession('claude', '/work', deps);
131
+ const first = claimPrewarmedAcpSession('claude', '/work');
132
+ // The claim is synchronous: the entry is removed before readiness resolves,
133
+ // so a send racing this one cannot adopt the same child.
134
+ expect(getPrewarmedAcp().has(acpPrewarmKey('claude', '/work'))).toBe(false);
135
+ expect(await first).not.toBeNull();
136
+ expect(await claimPrewarmedAcpSession('claude', '/work')).toBeNull();
137
+ });
138
+
139
+ test('a harness the entry was not warmed for is not handed out', async () => {
140
+ const { deps } = opener();
141
+ prewarmAcpSession('claude', '/work', deps);
142
+ expect(await claimPrewarmedAcpSession('codex', '/work')).toBeNull();
143
+ expect(await claimPrewarmedAcpSession('claude', '/work')).not.toBeNull();
144
+ });
145
+
146
+ test('a child that died while warming is disposed, and the caller spawns cold', async () => {
147
+ const dead = fakeProcess(false);
148
+ const { deps } = opener(async () => dead.warm);
149
+ prewarmAcpSession('claude', '/work', deps);
150
+ // The pool disposes a child that is not alive when its boot settles.
151
+ await dead.torn;
152
+ expect(await claimPrewarmedAcpSession('claude', '/work')).toBeNull();
153
+ expect(dead.disposed).toBe(true);
154
+ });
155
+ });
156
+
157
+ describe('restartPrewarmedAcpSessions', () => {
158
+ test('disposes unclaimed entries and reports the count', async () => {
159
+ const { deps, fakes } = opener();
160
+ prewarmAcpSession('claude', '/a', deps);
161
+ prewarmAcpSession('codex', '/b', deps);
162
+ prewarmAcpSession('claude', '/c', deps);
163
+ await claimPrewarmedAcpSession('claude', '/c');
164
+
165
+ expect(await restartPrewarmedAcpSessions()).toBe(2);
166
+ expect(getPrewarmedAcp().size).toBe(0);
167
+ // The claimed child belongs to a chat now: recycling standby processes must
168
+ // not take it down.
169
+ expect(fakes.filter((fake) => fake.disposed)).toHaveLength(2);
170
+ });
171
+ });
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import { describe, expect, test } from 'bun:test';
18
- import { applySelections, modelFromOption } from '@/server/lib/harness/acp/prompt';
18
+ import { applyLaunchSelections, applySelections, modelFromOption } from '@/server/lib/harness/acp/prompt';
19
19
  import type { AcpConfigOption } from '@/server/lib/harness/acp/protocol';
20
20
 
21
21
  function selector(currentValue: string | undefined): AcpConfigOption {
@@ -148,3 +148,72 @@ describe('applySelections', () => {
148
148
  )).rejects.toThrow('dsh refused model "["kenari","qwen3-8-27b:free"]"');
149
149
  });
150
150
  });
151
+
152
+ describe('applyLaunchSelections', () => {
153
+ const legacy = (modeIds: string[]): AcpConfigOption => ({
154
+ id: 'mode',
155
+ category: 'mode',
156
+ type: 'select',
157
+ currentValue: modeIds[0],
158
+ options: modeIds.map((value) => ({ value })),
159
+ });
160
+
161
+ test('a mode selector is written through setConfig, not set_mode', async () => {
162
+ const writes: string[] = [];
163
+ const setModes: string[] = [];
164
+ await applyLaunchSelections(
165
+ {
166
+ configOptions: [legacy(['default', 'plan'])],
167
+ runModel: null,
168
+ setConfig: async (id, value) => {
169
+ writes.push(`${id}=${String(value)}`);
170
+ },
171
+ setMode: async (mode) => {
172
+ setModes.push(mode);
173
+ },
174
+ },
175
+ { model: null, thinking: null, mode: 'plan' },
176
+ );
177
+ expect(writes).toEqual(['mode=plan']);
178
+ // The config selector supersedes the older list: calling both would write
179
+ // the same mode twice, in two different verbs.
180
+ expect(setModes).toEqual([]);
181
+ });
182
+
183
+ test('an agent with only the older modes list moves through set_mode', async () => {
184
+ // This is the branch the claim relies on: a prewarmed session handshaked
185
+ // with no picks, so the mode the operator chose arrives here, one write
186
+ // after the fact.
187
+ const setModes: string[] = [];
188
+ await applyLaunchSelections(
189
+ {
190
+ configOptions: [],
191
+ modes: { currentModeId: 'default', availableModes: [{ id: 'default', name: 'Default' }, { id: 'plan', name: 'Plan' }] },
192
+ runModel: null,
193
+ setConfig: async () => {},
194
+ setMode: async (mode) => {
195
+ setModes.push(mode);
196
+ },
197
+ },
198
+ { model: null, thinking: null, mode: 'plan' },
199
+ );
200
+ expect(setModes).toEqual(['plan']);
201
+ });
202
+
203
+ test('a mode the agent never advertised is not written', async () => {
204
+ const setModes: string[] = [];
205
+ await applyLaunchSelections(
206
+ {
207
+ configOptions: [],
208
+ modes: { currentModeId: 'default', availableModes: [{ id: 'default', name: 'Default' }] },
209
+ runModel: null,
210
+ setConfig: async () => {},
211
+ setMode: async (mode) => {
212
+ setModes.push(mode);
213
+ },
214
+ },
215
+ { model: null, thinking: null, mode: 'architect' },
216
+ );
217
+ expect(setModes).toEqual([]);
218
+ });
219
+ });
@@ -16,7 +16,7 @@
16
16
  * approve.
17
17
  */
18
18
 
19
- import { acpOptionValues, type AcpConfigOption } from '@/server/lib/harness/acp/protocol';
19
+ import { acpOptionValues, type AcpConfigOption, type AcpSessionModeState } from '@/server/lib/harness/acp/protocol';
20
20
 
21
21
  /** The selector in a `configOptions` list for one ACP category. */
22
22
  export function configOption(options: AcpConfigOption[], category: string): AcpConfigOption | undefined {
@@ -107,6 +107,37 @@ export interface ConfigSelectionHost {
107
107
  readonly harness?: string;
108
108
  }
109
109
 
110
+ /** The host plus the older Session Modes API, for the launch picks. */
111
+ export interface LaunchSelectionHost extends ConfigSelectionHost {
112
+ readonly modes?: AcpSessionModeState | null;
113
+ /** `session/set_mode`; present only when the session can speak it. */
114
+ setMode?: (modeId: string) => Promise<unknown>;
115
+ }
116
+
117
+ /**
118
+ * Apply the picks a spawn carries: the config selectors, then the legacy
119
+ * `modes` verb for an agent that publishes only that list.
120
+ *
121
+ * The ONE place a launch's picks are applied — a cold spawn and a prewarmed
122
+ * process both reach it through `handshakeAcpSession`, which is what keeps the
123
+ * two from disagreeing about the mode an agent that speaks only
124
+ * `session/set_mode` ends up in.
125
+ */
126
+ export async function applyLaunchSelections(
127
+ host: LaunchSelectionHost,
128
+ wanted: ConfigSelections,
129
+ ): Promise<void> {
130
+ await applySelections(host, wanted);
131
+ if (
132
+ wanted.mode
133
+ && !configOption(host.configOptions, 'mode')
134
+ && host.modes?.availableModes.some((entry) => entry.id === wanted.mode)
135
+ && host.setMode
136
+ ) {
137
+ await host.setMode(wanted.mode).catch(() => {});
138
+ }
139
+ }
140
+
110
141
  /**
111
142
  * Apply the model/thinking/mode picks with one config write each.
112
143
  *
@@ -138,6 +138,29 @@ export interface AcpConfigOption {
138
138
  options?: ({ value: string; name?: string; description?: string } | { group: string; name?: string; options: { value: string; name?: string }[] })[];
139
139
  }
140
140
 
141
+ /**
142
+ * One MCP server as `session/new|load|resume|fork` carries it.
143
+ *
144
+ * stdio is the ACP baseline; `http` is the typed variant an agent advertises
145
+ * through `mcpCapabilities.http`. `env` and `headers` are LISTS of name/value
146
+ * pairs on the wire, not maps — a map would lose ordering and duplicate keys.
147
+ */
148
+ export interface AcpMcpServerStdio {
149
+ name: string;
150
+ command: string;
151
+ args: string[];
152
+ env: Array<{ name: string; value: string }>;
153
+ }
154
+
155
+ export interface AcpMcpServerHttp {
156
+ type: 'http';
157
+ name: string;
158
+ url: string;
159
+ headers: Array<{ name: string; value: string }>;
160
+ }
161
+
162
+ export type AcpMcpServer = AcpMcpServerStdio | AcpMcpServerHttp;
163
+
141
164
  export interface AcpSessionNewResult {
142
165
  sessionId: string;
143
166
  configOptions?: AcpConfigOption[];
@@ -181,6 +181,32 @@ describe('handshakeAcpSession', () => {
181
181
  expect(session.sessionId).toBe('forked-id');
182
182
  });
183
183
 
184
+ test('a fork point travels to the agent as the request _meta', async () => {
185
+ const seen: unknown[] = [];
186
+ const proc = processDouble({
187
+ async forkSession(
188
+ sessionId: string,
189
+ _cwd: string,
190
+ _timeoutMs?: number,
191
+ _target?: Record<string, unknown>,
192
+ meta?: Record<string, unknown>,
193
+ ) {
194
+ seen.push({ sessionId, meta });
195
+ return { sessionId: 'forked-id' };
196
+ },
197
+ });
198
+ const meta = { jetbrains: { air: { fork: { version: 1, messageId: 'a2' } } } };
199
+ await handshakeAcpSession(
200
+ target(),
201
+ proc,
202
+ { model: null, thinking: null, mode: null },
203
+ undefined,
204
+ 'agent-1',
205
+ meta,
206
+ );
207
+ expect(seen).toEqual([{ sessionId: 'agent-1', meta }]);
208
+ });
209
+
184
210
  test('a process with no fork verb refuses instead of creating an empty session', async () => {
185
211
  const proc = processDouble();
186
212
  await expect(