@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,209 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Harnesses the user adds, on top of the ones this build ships.
8
+ *
9
+ * The ACP transport is already harness-agnostic: a launch line is a command
10
+ * vector, the handshake is generic, and the settings page reads `/api/harness`
11
+ * rather than a static list. What was missing was a place to PUT a definition
12
+ * and a registry the synchronous call sites (`harnessDescriptor`,
13
+ * `resolveLaunch`, `commandAvailable`) can read.
14
+ *
15
+ * The registry is process-wide and anchored on `globalThis` for the reason every
16
+ * other one here is: `bun --hot` re-evaluates this module while the descriptors
17
+ * it registered are still in use, and a module-level map would come back empty.
18
+ *
19
+ * A custom harness is ACP by definition — the add form offers no other
20
+ * transport — so its descriptor is `transport: 'acp'`, `glyph: 'custom'`, and
21
+ * its launch line is the command the user typed. Nothing here spawns anything;
22
+ * the existing probe and spawn paths do, once `resolveLaunch` can see the row.
23
+ */
24
+
25
+ import { getDb } from '@/server/db.server';
26
+ import { forgetProbe } from '@/server/lib/harness/probe-cache.server';
27
+ import { readSettingsJson, writeSettingsJson } from '@/server/lib/db/settings-store';
28
+ import { HARNESS_DISABLED_KEY } from '@/shared/lib/harness/enabled';
29
+ import { harnessConfigKey, parseEnvLines, splitCommand } from '@/shared/lib/harness/config';
30
+ import {
31
+ HARNESS_CATALOG,
32
+ isBuiltinHarness,
33
+ registerHarnessDescriptors,
34
+ type HarnessDescriptor,
35
+ } from '@/shared/lib/harness/catalog';
36
+ import type { HarnessLaunch } from '@/server/lib/harness/launch-table';
37
+
38
+ /** One user-added harness, as stored. */
39
+ export interface CustomHarness {
40
+ id: string;
41
+ label: string;
42
+ /** The letter the UI draws when there is no vendor mark. */
43
+ initial: string;
44
+ /** Space-separated launch command, e.g. `npx -y my-agent acp`. */
45
+ command: string;
46
+ /** `KEY=VALUE` lines, one per line. */
47
+ env: string;
48
+ note: string;
49
+ }
50
+
51
+ export interface CustomHarnessInput {
52
+ id?: unknown;
53
+ label?: unknown;
54
+ initial?: unknown;
55
+ command?: unknown;
56
+ env?: unknown;
57
+ note?: unknown;
58
+ }
59
+
60
+ /** Lowercase, digits and dashes: the id reaches a settings key and a URL. */
61
+ const ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,31}$/;
62
+ const MAX_LABEL = 40;
63
+ const MAX_NOTE = 200;
64
+
65
+ declare global {
66
+ // eslint-disable-next-line no-var
67
+ var __kabmoCustomHarnesses: Map<string, CustomHarness> | undefined;
68
+ // eslint-disable-next-line no-var
69
+ var __kabmoCustomHarnessesLoaded: boolean | undefined;
70
+ }
71
+
72
+ function registry(): Map<string, CustomHarness> {
73
+ return (globalThis.__kabmoCustomHarnesses ??= new Map());
74
+ }
75
+
76
+ function text(value: unknown): string {
77
+ return typeof value === 'string' ? value.trim() : '';
78
+ }
79
+
80
+ /**
81
+ * Validate one definition.
82
+ *
83
+ * Refuses by name rather than coercing: a command that is empty, an id that
84
+ * collides with a built-in, or an env line that is not `KEY=VALUE` would
85
+ * otherwise be stored and then fail at spawn with a message about something
86
+ * else.
87
+ */
88
+ export function validateCustomHarness(
89
+ input: CustomHarnessInput,
90
+ ): { ok: true; value: CustomHarness } | { ok: false; error: string } {
91
+ const id = text(input.id).toLowerCase();
92
+ if (!ID_PATTERN.test(id)) {
93
+ return { ok: false, error: 'id must be 1–32 lowercase letters, digits or dashes' };
94
+ }
95
+ if (isBuiltinHarness(id) || (HARNESS_CATALOG as Record<string, HarnessDescriptor | undefined>)[id]) {
96
+ return { ok: false, error: `"${id}" is a harness this build already ships` };
97
+ }
98
+ const label = text(input.label) || id;
99
+ if (label.length > MAX_LABEL) return { ok: false, error: `label must be at most ${MAX_LABEL} characters` };
100
+ const command = text(input.command);
101
+ if (splitCommand(command).length === 0) return { ok: false, error: 'command is required' };
102
+ const env = typeof input.env === 'string' ? input.env : '';
103
+ const parsedEnv = parseEnvLines(env);
104
+ if (parsedEnv.invalid.length > 0) {
105
+ return { ok: false, error: `invalid env line${parsedEnv.invalid.length === 1 ? '' : 's'}: ${parsedEnv.invalid.join(', ')}` };
106
+ }
107
+ const note = text(input.note);
108
+ if (note.length > MAX_NOTE) return { ok: false, error: `note must be at most ${MAX_NOTE} characters` };
109
+ const initial = (text(input.initial) || label.charAt(0) || '?').slice(0, 2);
110
+ return { ok: true, value: { id, label, initial, command, env, note } };
111
+ }
112
+
113
+ /** The descriptor the shared catalog registers for one row. */
114
+ function descriptorOf(harness: CustomHarness): HarnessDescriptor {
115
+ return { id: harness.id, label: harness.label, initial: harness.initial, transport: 'acp', glyph: 'custom' };
116
+ }
117
+
118
+ /** Re-read every row and publish it to the shared catalog. */
119
+ export async function refreshCustomHarnesses(): Promise<void> {
120
+ const db = await getDb();
121
+ const rows = await db.all<{
122
+ id: string;
123
+ label: string;
124
+ initial: string;
125
+ command: string;
126
+ env: string;
127
+ note: string;
128
+ }>('SELECT id, label, initial, command, env, note FROM custom_harnesses ORDER BY created_at ASC');
129
+ const next = new Map<string, CustomHarness>();
130
+ for (const row of rows) next.set(row.id, { ...row });
131
+ globalThis.__kabmoCustomHarnesses = next;
132
+ globalThis.__kabmoCustomHarnessesLoaded = true;
133
+ registerHarnessDescriptors([...next.values()].map(descriptorOf));
134
+ }
135
+
136
+ /** Load once per process; a write calls `refreshCustomHarnesses` itself. */
137
+ export async function ensureCustomHarnesses(): Promise<void> {
138
+ if (globalThis.__kabmoCustomHarnessesLoaded) return;
139
+ await refreshCustomHarnesses();
140
+ }
141
+
142
+ /** Every custom harness, in creation order. */
143
+ export async function listCustomHarnesses(): Promise<CustomHarness[]> {
144
+ await ensureCustomHarnesses();
145
+ return [...registry().values()];
146
+ }
147
+
148
+ /** One custom harness, or undefined. Synchronous: the launch path needs it. */
149
+ export function customHarness(id: string | null | undefined): CustomHarness | undefined {
150
+ return id ? registry().get(id) : undefined;
151
+ }
152
+
153
+ /** The launch line a custom harness contributes, or undefined. */
154
+ export function customLaunch(id: string | null | undefined): HarnessLaunch | undefined {
155
+ const harness = customHarness(id);
156
+ if (!harness) return undefined;
157
+ const { env } = parseEnvLines(harness.env);
158
+ return {
159
+ id: harness.id,
160
+ command: splitCommand(harness.command),
161
+ ...(Object.keys(env).length > 0 ? { env } : {}),
162
+ note: harness.note || 'A harness you added.',
163
+ };
164
+ }
165
+
166
+ /** Create or replace one definition, then republish the catalog. */
167
+ export async function saveCustomHarness(input: CustomHarnessInput): Promise<CustomHarness> {
168
+ const checked = validateCustomHarness(input);
169
+ if (!checked.ok) throw new Error(checked.error);
170
+ const db = await getDb();
171
+ await db.run(
172
+ `INSERT INTO custom_harnesses (id, label, initial, command, env, note, created_at)
173
+ VALUES (?, ?, ?, ?, ?, ?, ?)
174
+ ON CONFLICT(id) DO UPDATE SET
175
+ label = excluded.label,
176
+ initial = excluded.initial,
177
+ command = excluded.command,
178
+ env = excluded.env,
179
+ note = excluded.note`,
180
+ [checked.value.id, checked.value.label, checked.value.initial, checked.value.command, checked.value.env, checked.value.note, Date.now()],
181
+ );
182
+ // The launch line may have changed, so the last probe no longer describes it.
183
+ await forgetProbe(checked.value.id);
184
+ await refreshCustomHarnesses();
185
+ return checked.value;
186
+ }
187
+
188
+ /**
189
+ * Remove one definition and every per-harness row it owned.
190
+ *
191
+ * Sessions are NOT deleted: a chat that ran on this harness keeps its
192
+ * `harness_sessions` row, and `resolveSessionRef` reports the id so the resume
193
+ * path can refuse in words ("this harness is no longer registered") instead of
194
+ * silently pretending the chat ran on omp.
195
+ */
196
+ export async function removeCustomHarness(id: string): Promise<void> {
197
+ const db = await getDb();
198
+ await db.run('DELETE FROM custom_harnesses WHERE id = ?', [id]);
199
+ await db.run('DELETE FROM app_settings WHERE key = ?', [harnessConfigKey(id)]);
200
+ await db.run('DELETE FROM harness_probes WHERE harness = ?', [id]);
201
+ await forgetProbe(id);
202
+ const disabled = await readSettingsJson<unknown>(db, HARNESS_DISABLED_KEY, []);
203
+ if (Array.isArray(disabled) && disabled.includes(id)) {
204
+ const next = disabled.filter((entry) => entry !== id);
205
+ if (next.length === 0) await db.run('DELETE FROM app_settings WHERE key = ?', [HARNESS_DISABLED_KEY]);
206
+ else await writeSettingsJson(db, HARNESS_DISABLED_KEY, next);
207
+ }
208
+ await refreshCustomHarnesses();
209
+ }
@@ -192,4 +192,23 @@ export const HARNESS_LAUNCH: Readonly<Partial<Record<HarnessId, HarnessLaunch>>>
192
192
  install: 'npm i -g zcode-acp-server zcode-app-cli # the app-server runtime (or install the ZCode desktop app)',
193
193
  note: 'bridges `zcode app-server --stdio`; measured 1 model · 3 thought levels · 5 modes, list/resume/fork + steering; needs a ZCode runtime — the desktop app, or `zcode-app-cli` on PATH (`ZCODE_BIN` for a custom install). Custom providers go in ~/.zcode/v2/provider_config.json; the bridge lists only selectable ones',
194
194
  },
195
+ // jcode's OWN ACP adapter: `jcode acp` runs the stdio server backed by the
196
+ // Jcode daemon (measured against 1jehuang/jcode's `src/cli/acp.rs`). The
197
+ // binary is installed by the vendor's script, so there is no npm package to
198
+ // pin here.
199
+ jcode: {
200
+ id: 'jcode',
201
+ command: ['jcode', 'acp'],
202
+ install: 'curl -fsSL https://jcode.sh/install | bash',
203
+ note: 'ACP adapter backed by the Jcode daemon; configure a provider once in ~/.jcode/config.toml (`jcode provider add …`, or the first `jcode` setup wizard)',
204
+ },
205
+ // Grok Build ships its OWN ACP server; `--always-approve` is deliberately not
206
+ // passed, so tool calls arrive as `session/request_permission` and Kabmo's
207
+ // access tiers decide. Models and reasoning show up as config options.
208
+ grok: {
209
+ id: 'grok',
210
+ command: ['grok', 'agent', 'stdio'],
211
+ install: 'curl -fsSL https://x.ai/cli/install.sh | bash',
212
+ note: 'native ACP (`grok agent stdio`); xAI models need `grok login` once. A custom model as a [model.<name>] table in ~/.grok/config.toml (base_url + api_key) runs WITHOUT an xAI login — measured on 1.0.77. Sessions advertise model + reasoning_effort options',
213
+ },
195
214
  };
@@ -187,12 +187,17 @@ export async function probeHarness(
187
187
  agentProcess.newSession(dir, timeoutMs),
188
188
  );
189
189
  const options = session.configOptions ?? [];
190
+ const modeSelector = configByCategory(options, 'mode');
191
+ const currentMode = typeof modeSelector?.currentValue === 'string'
192
+ ? modeSelector.currentValue
193
+ : session.modes?.currentModeId;
190
194
  return {
191
195
  harness: id,
192
196
  capabilities: capabilitiesFrom(init, options, observed),
193
197
  models: selectValues(configByCategory(options, 'model')),
194
198
  thinking: selectValues(configByCategory(options, 'thought_level')),
195
- modes: selectValues(configByCategory(options, 'mode')),
199
+ modes: selectValues(modeSelector),
200
+ ...(currentMode ? { currentMode } : {}),
196
201
  probedAt: Date.now(),
197
202
  };
198
203
  } catch (error) {
@@ -28,7 +28,7 @@
28
28
  * value has to be injected into `env` or all imported models answer 401.
29
29
  */
30
30
 
31
- import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-facts';
31
+ import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-contracts';
32
32
  import type { CanonicalProtocol } from '@/shared/lib/harness/dialects';
33
33
  import { dialectFor, wireApiFor } from '@/shared/lib/harness/dialects';
34
34
  import { ProviderWriteError } from '@/server/lib/harness/provider-write-error';
@@ -20,7 +20,7 @@
20
20
  import YAML from 'yaml';
21
21
  import { parse as parseToml, stringify as stringifyToml } from 'smol-toml';
22
22
 
23
- import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-facts';
23
+ import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-contracts';
24
24
  import { asRecord } from '@/server/lib/harness/provider-entry';
25
25
  import { ProviderWriteError } from '@/server/lib/harness/provider-write-error';
26
26
 
@@ -37,7 +37,8 @@ import { join } from 'path';
37
37
  import YAML from 'yaml';
38
38
  import { parse as parseToml } from 'smol-toml';
39
39
 
40
- import { providerFacts, type ProviderRegistryKind } from '@/shared/lib/harness/provider-facts';
40
+ import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-contracts';
41
+ import { providerFacts } from '@/shared/lib/harness/provider-lookup';
41
42
  import { protocolOfSourceDialect, type CanonicalProtocol } from '@/shared/lib/harness/dialects';
42
43
  import { isVendorProviderId } from '@/shared/lib/models/provider/vendors';
43
44
  import { HARNESS_IDS, type HarnessId } from '@/shared/lib/harness/catalog';
@@ -29,7 +29,8 @@
29
29
  import { writeFileAtomic } from '@/server/lib/fs/atomic-write';
30
30
  import { parseDocument, providerMap, serialise } from '@/server/lib/harness/provider-file.server';
31
31
  import { withConfigLock } from '@/server/lib/fs/config-lock';
32
- import { providerFacts, type ProviderRegistryKind } from '@/shared/lib/harness/provider-facts';
32
+ import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-contracts';
33
+ import { providerFacts } from '@/shared/lib/harness/provider-lookup';
33
34
  import {
34
35
  adaptBaseUrl,
35
36
  dialectFor,
@@ -17,7 +17,11 @@
17
17
  import type { HarnessSession } from '@/server/lib/harness/session';
18
18
 
19
19
  /** Pulled from the omp registry module so there is one map, not two. */
20
- export function registerAcpSession(session: HarnessSession, requestedId: string): void {
20
+ export function registerAcpSession(
21
+ session: HarnessSession,
22
+ requestedId: string,
23
+ onDestroy?: () => void,
24
+ ): void {
21
25
  // Imported lazily: `session-registry` imports the omp manager, which imports
22
26
  // this file's neighbours, and a top-level import would close that cycle.
23
27
  const registry = liveRegistry();
@@ -26,6 +30,9 @@ export function registerAcpSession(session: HarnessSession, requestedId: string)
26
30
  session.onDestroy(() => {
27
31
  if (registry.get(session.sessionId) === session) registry.delete(session.sessionId);
28
32
  if (registry.get(requestedId) === session) registry.delete(requestedId);
33
+ // The caller's cleanup rides the SAME hook: `onDestroy` holds one callback,
34
+ // so a second registration would replace this one rather than add to it.
35
+ onDestroy?.();
29
36
  });
30
37
  }
31
38
 
@@ -115,9 +115,30 @@ const HARNESS_USAGE_STATE_SQL = `
115
115
  );
116
116
  `;
117
117
 
118
+ /**
119
+ * Harnesses the USER added, as opposed to the ones this build ships.
120
+ *
121
+ * A row is the whole definition: the launch line, the label and the initial the
122
+ * UI draws. Kept in a table rather than `app_settings` because the roster is
123
+ * read on every catalog answer and written one row at a time — the same reason
124
+ * `harness_sessions` is a table.
125
+ */
126
+ const CUSTOM_HARNESSES_SQL = `
127
+ CREATE TABLE IF NOT EXISTS custom_harnesses (
128
+ id TEXT PRIMARY KEY,
129
+ label TEXT NOT NULL,
130
+ initial TEXT NOT NULL,
131
+ command TEXT NOT NULL,
132
+ env TEXT NOT NULL DEFAULT '',
133
+ note TEXT NOT NULL DEFAULT '',
134
+ created_at INTEGER NOT NULL
135
+ );
136
+ `;
137
+
118
138
  /** Idempotent: created on every database open, like every other feature table. */
119
139
  export async function ensureHarnessSchema(db: DbClient): Promise<void> {
120
140
  await db.exec(HARNESS_SESSIONS_SQL);
141
+ await db.exec(CUSTOM_HARNESSES_SQL);
121
142
  await db.exec(HARNESS_PROBES_SQL);
122
143
  await db.exec(HARNESS_GOAL_STATE_SQL);
123
144
  await db.exec(HARNESS_USAGE_STATE_SQL);
@@ -0,0 +1,99 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The lease the Stats panel reads to name an ACP chat.
8
+ *
9
+ * The two rules pinned here are the ones a reader cannot recover from a wrong
10
+ * file: `startedAt` must survive the handshake (a claimed prewarm did not
11
+ * restart), and a title update must reach the file the panel reads rather than
12
+ * only the database it cannot.
13
+ */
14
+
15
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
16
+ import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
17
+ import { tmpdir } from 'node:os';
18
+ import { join } from 'node:path';
19
+
20
+ import { getHarnessLeasePath } from '@/server/lib/lifecycle/paths';
21
+ import {
22
+ noteHarnessLease,
23
+ pruneHarnessLeases,
24
+ removeHarnessLease,
25
+ updateHarnessLeaseTitle,
26
+ } from '@/server/lib/harness/session-lease.server';
27
+
28
+ let dir = '';
29
+ let originalDataDir: string | undefined;
30
+
31
+ beforeEach(() => {
32
+ originalDataDir = Bun.env.KABMO_DATA_DIR;
33
+ dir = mkdtempSync(join(tmpdir(), 'kabmo-harness-lease-'));
34
+ Bun.env.KABMO_DATA_DIR = dir;
35
+ });
36
+
37
+ afterEach(() => {
38
+ if (originalDataDir === undefined) delete Bun.env.KABMO_DATA_DIR;
39
+ else Bun.env.KABMO_DATA_DIR = originalDataDir;
40
+ rmSync(dir, { recursive: true, force: true });
41
+ });
42
+
43
+ function lease(pid: number): Record<string, unknown> {
44
+ return JSON.parse(readFileSync(getHarnessLeasePath(pid), 'utf8')) as Record<string, unknown>;
45
+ }
46
+
47
+ describe('harness session lease', () => {
48
+ test('a spawn writes the catalog label and the spawn time', () => {
49
+ noteHarnessLease({ pid: 4242, harness: 'claude', cwd: '/p', state: 'starting' });
50
+ const record = lease(4242);
51
+ expect(record.label).toBe('claude');
52
+ expect(record.state).toBe('starting');
53
+ expect(record.sessionId).toBe('');
54
+ expect(record.startedAt).toBeGreaterThan(0);
55
+ });
56
+
57
+ test('the handshake keeps the spawn time and records the session', () => {
58
+ noteHarnessLease({ pid: 4243, harness: 'opencode', cwd: '/p', state: 'starting' });
59
+ const spawnedAt = lease(4243).startedAt;
60
+ noteHarnessLease({
61
+ pid: 4243,
62
+ harness: 'opencode',
63
+ cwd: '/p',
64
+ state: 'session',
65
+ sessionId: 'sess-1',
66
+ title: 'Fix it',
67
+ });
68
+ const record = lease(4243);
69
+ expect(record.startedAt).toBe(spawnedAt);
70
+ expect(record.state).toBe('session');
71
+ expect(record.sessionId).toBe('sess-1');
72
+ expect(record.title).toBe('Fix it');
73
+ });
74
+
75
+ test('a title update rewrites the lease that owns the session', () => {
76
+ noteHarnessLease({ pid: 4244, harness: 'codex', cwd: '/p', state: 'session', sessionId: 'sess-2' });
77
+ updateHarnessLeaseTitle('sess-2', 'Rename me');
78
+ expect(lease(4244).title).toBe('Rename me');
79
+ });
80
+
81
+ test('a title for a session with no lease is a no-op', () => {
82
+ expect(() => updateHarnessLeaseTitle('nobody', 'x')).not.toThrow();
83
+ });
84
+
85
+ test('removing a lease deletes the file', () => {
86
+ noteHarnessLease({ pid: 4245, harness: 'pi', cwd: '/p', state: 'prewarm' });
87
+ removeHarnessLease(4245);
88
+ expect(existsSync(getHarnessLeasePath(4245))).toBe(false);
89
+ });
90
+
91
+ test('pruning drops a dead pid and keeps a live one', () => {
92
+ noteHarnessLease({ pid: process.pid, harness: 'claude', cwd: '/p', state: 'session', sessionId: 'sess-live' });
93
+ const deadPid = 2_147_483_647;
94
+ writeFileSync(getHarnessLeasePath(deadPid), JSON.stringify({ pid: deadPid }));
95
+ expect(pruneHarnessLeases()).toBe(1);
96
+ expect(existsSync(getHarnessLeasePath(process.pid))).toBe(true);
97
+ expect(existsSync(getHarnessLeasePath(deadPid))).toBe(false);
98
+ });
99
+ });
@@ -0,0 +1,193 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The per-pid lease that tells the Stats panel which chat an ACP child is.
8
+ *
9
+ * omp's RPC hosts hold an OS `flock` on `~/.omp/run/session-owners/<id>.lock`,
10
+ * and the panel reads that descriptor to name a session. An ACP agent holds no
11
+ * such lease: its id lives in Kabmo's `harness_sessions` table and its
12
+ * transcript lives behind the agent, so a panel that only knew argv drew every
13
+ * `claude`/`codex`/`opencode` chat as a bare `npx` row inside Kabmo's own group
14
+ * — measured against the real launch table, 12 of the 13 ACP harnesses.
15
+ *
16
+ * This file is the missing fact, written by the process that owns it:
17
+ * `<data>/run/harness-sessions/<pid>.json`, one record per live ACP child.
18
+ *
19
+ * Three details are load-bearing:
20
+ *
21
+ * - **`startedAt` is the process's spawn time, not the write time.** The first
22
+ * write happens immediately after the spawn, so a reader can reject a
23
+ * recycled pid instead of naming a stranger's process after a chat. A
24
+ * claimed prewarm keeps the prewarm's `startedAt`, because the process did
25
+ * not restart when the chat adopted it.
26
+ * - **The record is a FILE, not a database row.** The reader is a plugin: its
27
+ * server half runs in this process but has no database handle, and opening a
28
+ * second one is forbidden. A file is the same channel omp's own lease and
29
+ * daemon registry already use.
30
+ * - **A write is atomic.** The panel samples once a second and may read while
31
+ * a title is being updated; a half-written JSON would drop the row back to
32
+ * `npx` for one tick.
33
+ */
34
+
35
+ import fs from 'node:fs';
36
+
37
+ import { getHarnessLeaseDir, getHarnessLeasePath } from '@/server/lib/lifecycle/paths';
38
+ import { harnessDescriptor, type HarnessId } from '@/shared/lib/harness/catalog';
39
+
40
+ /** What the lease says the child is doing. */
41
+ export type HarnessLeaseState = 'starting' | 'session' | 'prewarm';
42
+
43
+ /** One live ACP child, as the Stats panel reads it. */
44
+ export interface HarnessLeaseRecord {
45
+ pid: number;
46
+ /** Kabmo's session id, empty until the handshake answers. */
47
+ sessionId: string;
48
+ harness: string;
49
+ /** The catalog's display label, so the panel needs no second table. */
50
+ label: string;
51
+ cwd: string;
52
+ state: HarnessLeaseState;
53
+ /** The process's spawn time (epoch ms), for the pid-reuse guard. */
54
+ startedAt: number;
55
+ /** The chat's name, empty until the first prompt or the agent names it. */
56
+ title: string;
57
+ }
58
+
59
+ declare global {
60
+ // eslint-disable-next-line no-var
61
+ var __kabmoHarnessLeases: Map<string, number> | undefined;
62
+ }
63
+
64
+ /** session id → pid, so a title update can find the file to rewrite. */
65
+ function bySession(): Map<string, number> {
66
+ globalThis.__kabmoHarnessLeases ??= new Map();
67
+ return globalThis.__kabmoHarnessLeases;
68
+ }
69
+
70
+ function readLease(pid: number): HarnessLeaseRecord | null {
71
+ try {
72
+ const raw = JSON.parse(fs.readFileSync(getHarnessLeasePath(pid), 'utf8')) as unknown;
73
+ return raw && typeof raw === 'object' ? (raw as HarnessLeaseRecord) : null;
74
+ } catch {
75
+ // A missing or half-written file is a lease we do not have, which is the
76
+ // same outcome as a child that is not running.
77
+ return null;
78
+ }
79
+ }
80
+
81
+ function writeLease(record: HarnessLeaseRecord): void {
82
+ const file = getHarnessLeasePath(record.pid);
83
+ const tmp = `${file}.${process.pid}.tmp`;
84
+ try {
85
+ fs.writeFileSync(tmp, JSON.stringify(record), { mode: 0o600 });
86
+ fs.renameSync(tmp, file);
87
+ } catch (error) {
88
+ try {
89
+ fs.rmSync(tmp, { force: true });
90
+ } catch {
91
+ // The rename is what failed; a leftover temp file is pruned at boot.
92
+ }
93
+ console.error(`[harness] could not write the session lease for pid ${record.pid}:`, error);
94
+ }
95
+ }
96
+
97
+ /**
98
+ * Record (or update) the lease for one ACP child.
99
+ *
100
+ * Called twice per cold spawn — `starting` right after the process exists, then
101
+ * `session` once the handshake answers — and once per prewarm. A second call
102
+ * preserves the first call's `startedAt`, which is what makes the pid-reuse
103
+ * guard work for a prewarm claimed minutes later.
104
+ */
105
+ export function noteHarnessLease(input: {
106
+ pid: number;
107
+ harness: HarnessId;
108
+ cwd: string;
109
+ state: HarnessLeaseState;
110
+ sessionId?: string;
111
+ title?: string;
112
+ }): void {
113
+ if (!Number.isInteger(input.pid) || input.pid <= 0) return;
114
+ const existing = readLease(input.pid);
115
+ const record: HarnessLeaseRecord = {
116
+ pid: input.pid,
117
+ sessionId: input.sessionId ?? existing?.sessionId ?? '',
118
+ harness: input.harness,
119
+ label: harnessDescriptor(input.harness)?.label ?? input.harness,
120
+ cwd: input.cwd,
121
+ state: input.state,
122
+ startedAt: existing?.startedAt ?? Date.now(),
123
+ title: input.title ?? existing?.title ?? '',
124
+ };
125
+ writeLease(record);
126
+ if (record.sessionId) bySession().set(record.sessionId, record.pid);
127
+ }
128
+
129
+ /**
130
+ * Rewrite the title of the lease that owns `sessionId`.
131
+ *
132
+ * A no-op for a session with no lease (an omp RPC chat, whose title lives in
133
+ * its transcript) and for a title that arrives before the spawn wrote one.
134
+ */
135
+ export function updateHarnessLeaseTitle(sessionId: string, title: string): void {
136
+ const pid = bySession().get(sessionId);
137
+ if (!pid) return;
138
+ const record = readLease(pid);
139
+ if (!record) return;
140
+ writeLease({ ...record, title });
141
+ }
142
+
143
+ /** Forget one child: its process is gone, so its lease must not outlive it. */
144
+ export function removeHarnessLease(pid: number): void {
145
+ const record = readLease(pid);
146
+ if (record?.sessionId) bySession().delete(record.sessionId);
147
+ try {
148
+ fs.rmSync(getHarnessLeasePath(pid), { force: true });
149
+ } catch {
150
+ // A lease that cannot be removed is pruned at the next boot.
151
+ }
152
+ }
153
+
154
+ /** Whether a pid is still a live process (EPERM means it exists, owned by another user). */
155
+ function isAlive(pid: number): boolean {
156
+ try {
157
+ process.kill(pid, 0);
158
+ return true;
159
+ } catch (error) {
160
+ return (error as NodeJS.ErrnoException).code === 'EPERM';
161
+ }
162
+ }
163
+
164
+ /**
165
+ * Drop the leases a crashed server left behind.
166
+ *
167
+ * The panel ignores a lease whose pid is not in its sweep, so a stale file is
168
+ * harmless to read — but one file per session ever spawned is unbounded growth,
169
+ * and a recycled pid is exactly what the `startedAt` guard exists to survive.
170
+ * Called once at boot, before any session can write a new one.
171
+ */
172
+ export function pruneHarnessLeases(): number {
173
+ let names: string[];
174
+ try {
175
+ names = fs.readdirSync(getHarnessLeaseDir());
176
+ } catch {
177
+ return 0;
178
+ }
179
+ let removed = 0;
180
+ for (const name of names) {
181
+ const match = /^(\d+)\.json$/.exec(name);
182
+ if (!match) continue;
183
+ const pid = Number(match[1]);
184
+ if (isAlive(pid)) continue;
185
+ try {
186
+ fs.rmSync(getHarnessLeasePath(pid), { force: true });
187
+ removed += 1;
188
+ } catch {
189
+ // Another process may be pruning the same directory; the next boot retries.
190
+ }
191
+ }
192
+ return removed;
193
+ }
@@ -91,15 +91,15 @@ describe('harness session store', () => {
91
91
  expect(await loadHarnessSession('never-spawned')).toBeNull();
92
92
  });
93
93
 
94
- test('a harness this build does not know is refused, not drawn', async () => {
95
- // A row written by a newer build (an adapter since removed) would otherwise
96
- // draw an empty box with no name.
94
+ test('a well-formed id is kept even without a descriptor, a malformed one is not', async () => {
97
95
  expect(knownHarness('opencode', HARNESS_IDS)).toBe('opencode');
98
- // A row naming a harness this build no longer lists — `opencode2`, retired when
99
- // the preview became a shim for `opencode` — draws no mark rather than a wrong
100
- // one. Both spellings of "unknown" are covered: a retired id and an invented one.
101
- expect(knownHarness('opencode2', HARNESS_IDS)).toBeUndefined();
102
- expect(knownHarness('some-future-agent', HARNESS_IDS)).toBeUndefined();
96
+ // A user-added harness has no static descriptor, and a REMOVED one never
97
+ // will: dropping the id would rewrite the chat's harness to `omp-rpc` and
98
+ // resume it against the wrong agent. The id is kept; the launch path is what
99
+ // refuses in words.
100
+ expect(knownHarness('opencode2', HARNESS_IDS)).toBe('opencode2');
101
+ expect(knownHarness('some-future-agent', HARNESS_IDS)).toBe('some-future-agent');
102
+ expect(knownHarness('Not An Id', HARNESS_IDS)).toBeUndefined();
103
103
  expect(knownHarness(undefined, HARNESS_IDS)).toBeUndefined();
104
104
  });
105
105