@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
@@ -67,6 +67,28 @@ describe('harness catalog after the Gemini retirement', () => {
67
67
  expect(command).not.toEqual(['zcode', 'acp']);
68
68
  });
69
69
 
70
+ test('jcode is listed and launches its own `acp` subcommand', () => {
71
+ // jcode ships the ACP server itself (`src/cli/acp.rs`), backed by its
72
+ // daemon; the vendor installer is the only install path.
73
+ const descriptor = harnessDescriptor('jcode');
74
+ expect(descriptor?.transport).toBe('acp');
75
+ expect(descriptor?.glyph).toBe('jcode');
76
+ expect(HARNESS_LAUNCH.jcode?.command).toEqual(['jcode', 'acp']);
77
+ expect(HARNESS_LAUNCH.jcode?.install).toContain('https://jcode.sh/install');
78
+ });
79
+
80
+ test('grok is listed and launches its own ACP server, approvals left on', () => {
81
+ // Grok Build ships `grok agent stdio` itself. `--always-approve` must NOT be
82
+ // in the launch line: it would silence `session/request_permission`, making
83
+ // the composer's access tiers inert.
84
+ const descriptor = harnessDescriptor('grok');
85
+ expect(descriptor?.transport).toBe('acp');
86
+ expect(descriptor?.glyph).toBe('grok');
87
+ expect(HARNESS_LAUNCH.grok?.command).toEqual(['grok', 'agent', 'stdio']);
88
+ expect(HARNESS_LAUNCH.grok?.command).not.toContain('--always-approve');
89
+ expect(HARNESS_LAUNCH.grok?.install).toContain('https://x.ai/cli/install.sh');
90
+ });
91
+
70
92
  test('every catalog entry has a launch line or is the built-in transport', () => {
71
93
  // The built-in transport has no agent to launch by definition; everything
72
94
  // else without a line would probe to "no launch command is configured",
@@ -24,7 +24,7 @@
24
24
  * own body is `exec "$(dirname "$0")/opencode" "$@"`. A second catalog entry for
25
25
  * the same binary would offer two tabs that run one program.
26
26
  */
27
- export type HarnessId =
27
+ export type BuiltinHarnessId =
28
28
  | 'omp-rpc'
29
29
  | 'omp-acp'
30
30
  | 'claude'
@@ -46,10 +46,26 @@ export type HarnessId =
46
46
  * `zcode app-server`. The CLI ships no native ACP server (measured against
47
47
  * the 3.17.x source: no `acp` subcommand), so the launch line names that
48
48
  * bridge and the bridge finds the CLI by itself. */
49
- | 'zcode';
49
+ | 'zcode'
50
+ /** The Rust agent from jcode.sh. Its own ACP adapter (`jcode acp`) is backed
51
+ * by the Jcode daemon. */
52
+ | 'jcode'
53
+ /** xAI's Grok Build CLI, over its own ACP server (`grok agent stdio`). */
54
+ | 'grok';
50
55
 
51
- /** Every harness this build knows how to launch or display. */
52
- export const HARNESS_IDS: readonly HarnessId[] = [
56
+ /**
57
+ * A harness id: one this build ships, or one the user added.
58
+ *
59
+ * The union stays for the built-ins so a typo in a table is still a compile
60
+ * error, while `(string & {})` lets a runtime id through without widening every
61
+ * call site to `string` (which would lose the autocomplete that makes the
62
+ * built-in list discoverable). Tables that must be COMPLETE are keyed by
63
+ * `BuiltinHarnessId`; tables that may be partial use `HarnessId`.
64
+ */
65
+ export type HarnessId = BuiltinHarnessId | (string & {});
66
+
67
+ /** Every harness this build ships. Custom ids are added at runtime. */
68
+ export const HARNESS_IDS: readonly BuiltinHarnessId[] = [
53
69
  'omp-rpc',
54
70
  'omp-acp',
55
71
  'claude',
@@ -64,6 +80,8 @@ export const HARNESS_IDS: readonly HarnessId[] = [
64
80
  'kimi',
65
81
  'cursor',
66
82
  'zcode',
83
+ 'jcode',
84
+ 'grok',
67
85
  ];
68
86
 
69
87
  export interface HarnessDescriptor {
@@ -115,13 +133,17 @@ export type HarnessGlyph =
115
133
  | 'qwen'
116
134
  | 'cursor'
117
135
  | 'antigravity'
118
- | 'zcode';
136
+ | 'zcode'
137
+ | 'jcode'
138
+ | 'grok'
139
+ /** A user-added ACP harness: no vendor mark, drawn as its initial. */
140
+ | 'custom';
119
141
 
120
142
  /**
121
143
  * The catalog. Order is the tab/legend order: omp's two surfaces first because
122
144
  * they are the default, then the adapters in the order the research measured.
123
145
  */
124
- export const HARNESS_CATALOG: Readonly<Record<HarnessId, HarnessDescriptor>> = {
146
+ export const HARNESS_CATALOG: Readonly<Record<BuiltinHarnessId, HarnessDescriptor>> = {
125
147
  'omp-rpc': { id: 'omp-rpc', label: 'omp', initial: 'o', transport: 'rpc', glyph: 'omp', builtIn: true },
126
148
  'omp-acp': { id: 'omp-acp', label: 'omp (ACP)', initial: 'o', transport: 'acp', glyph: 'omp' },
127
149
  claude: { id: 'claude', label: 'claude', initial: 'A', transport: 'acp', glyph: 'claudecode' },
@@ -138,6 +160,8 @@ export const HARNESS_CATALOG: Readonly<Record<HarnessId, HarnessDescriptor>> = {
138
160
  kimi: { id: 'kimi', label: 'kimi', initial: 'K', transport: 'acp', glyph: 'kimi' },
139
161
  cursor: { id: 'cursor', label: 'cursor', initial: '⌖', transport: 'acp', glyph: 'cursor' },
140
162
  zcode: { id: 'zcode', label: 'zcode', initial: 'Z', transport: 'acp', glyph: 'zcode' },
163
+ jcode: { id: 'jcode', label: 'jcode', initial: 'J', transport: 'acp', glyph: 'jcode' },
164
+ grok: { id: 'grok', label: 'grok', initial: 'G', transport: 'acp', glyph: 'grok' },
141
165
  };
142
166
 
143
167
  /**
@@ -150,11 +174,40 @@ export const HARNESS_CATALOG: Readonly<Record<HarnessId, HarnessDescriptor>> = {
150
174
  */
151
175
  export const DEFAULT_HARNESS_ID: HarnessId = 'omp-rpc';
152
176
 
177
+ /**
178
+ * Descriptors for harnesses the user added, process-wide.
179
+ *
180
+ * The server fills this from `custom_harnesses` at boot and after every write;
181
+ * the client fills it from the `/api/harness` payload. One overlay rather than a
182
+ * second catalog keeps `harnessDescriptor` synchronous for the ~40 call sites
183
+ * that only need a label or a transport.
184
+ */
185
+ const customDescriptors = new Map<string, HarnessDescriptor>();
186
+
187
+ /** Replace the custom descriptors. Built-in ids are ignored: the static table wins. */
188
+ export function registerHarnessDescriptors(descriptors: readonly HarnessDescriptor[]): void {
189
+ customDescriptors.clear();
190
+ for (const descriptor of descriptors) {
191
+ if ((HARNESS_CATALOG as Record<string, HarnessDescriptor | undefined>)[descriptor.id]) continue;
192
+ customDescriptors.set(descriptor.id, descriptor);
193
+ }
194
+ }
195
+
196
+ /** True for an id this build ships (not a user-added one). */
197
+ export function isBuiltinHarness(id: string | null | undefined): id is BuiltinHarnessId {
198
+ return Boolean(id) && (HARNESS_IDS as readonly string[]).includes(id as string);
199
+ }
200
+
201
+ /** Every id this process knows: the built-ins, then the custom ones. */
202
+ export function harnessIds(): string[] {
203
+ return [...HARNESS_IDS, ...customDescriptors.keys()];
204
+ }
205
+
153
206
  /** The descriptor for an id, or undefined for a value this build does not know
154
207
  * (a newer adapter's id arriving over the wire). */
155
208
  export function harnessDescriptor(id: string | null | undefined): HarnessDescriptor | undefined {
156
209
  if (!id) return undefined;
157
- return (HARNESS_CATALOG as Record<string, HarnessDescriptor | undefined>)[id];
210
+ return (HARNESS_CATALOG as Record<string, HarnessDescriptor | undefined>)[id] ?? customDescriptors.get(id);
158
211
  }
159
212
 
160
213
  /**
@@ -137,3 +137,28 @@ describe('the env box speaks the agent’s own vocabulary', () => {
137
137
  }
138
138
  });
139
139
  });
140
+
141
+ describe('the launch box names this harness’s own line', () => {
142
+ test('omp’s card does not advertise Antigravity', () => {
143
+ const plan = configFieldPlan('omp-acp', undefined, { launchCommand: 'omp acp' });
144
+ expect(plan.launchPlaceholder).toBe('omp acp');
145
+ expect(plan.launchHint).toContain('omp acp');
146
+ // The quoting example carries the args and this agent's binary.
147
+ expect(plan.launchHint).toContain('/Users/me/bin/omp acp');
148
+ expect(plan.launchHint).not.toContain('agy');
149
+ });
150
+
151
+ test('Claude’s line keeps its package spec in the quoting example', () => {
152
+ const line = 'npx -y @agentclientprotocol/claude-agent-acp@0.100.0';
153
+ const plan = configFieldPlan('claude', undefined, { launchCommand: line });
154
+ expect(plan.launchPlaceholder).toBe(line);
155
+ expect(plan.launchHint).toContain(`/Users/me/bin/${line}`);
156
+ expect(plan.launchHint).not.toContain('agy');
157
+ });
158
+
159
+ test('no known line means the box says so instead of inventing one', () => {
160
+ const plan = configFieldPlan('a-user-harness', undefined);
161
+ expect(plan.launchPlaceholder).toBe('the agent’s own command');
162
+ expect(plan.launchHint).not.toContain('agy');
163
+ });
164
+ });
@@ -30,7 +30,7 @@
30
30
  */
31
31
 
32
32
  import type { HarnessId } from '@/shared/lib/harness/catalog';
33
- import { providerFacts } from '@/shared/lib/harness/provider-facts';
33
+ import { providerFacts } from '@/shared/lib/harness/provider-lookup';
34
34
 
35
35
  /** The probe fields this plan reads. Absent means "never probed". */
36
36
  export interface ConfigProbeFacts {
@@ -55,6 +55,9 @@ export interface ConfigFieldPlan {
55
55
  envPlaceholder: string;
56
56
  /** What to type in the launch box when empty, from the build's own table. */
57
57
  launchPlaceholder: string;
58
+ /** What leaving the box empty falls back to, plus the quoting example, both
59
+ * naming THIS harness's line. */
60
+ launchHint: string;
58
61
  /** Per-harness guidance the generic form cannot know. */
59
62
  notes: string[];
60
63
  }
@@ -128,12 +131,37 @@ function environmentFacts(id: HarnessId): { hint: string; placeholder: string; n
128
131
  };
129
132
  }
130
133
 
134
+ /**
135
+ * The launch box, described by the harness's OWN line.
136
+ *
137
+ * The hint used to quote the INSTALL command as "the built-in line" and pin its
138
+ * quoting example to `/Users/me/bin/agy acp` — Antigravity's line, printed on
139
+ * every card, including omp's and Claude's, whose binaries are `omp` and `npx`.
140
+ * Both facts now come from the line this build would actually spawn.
141
+ */
142
+ function launchFacts(command: string | undefined): { placeholder: string; hint: string } {
143
+ const line = command?.trim() ?? '';
144
+ if (!line) {
145
+ return {
146
+ placeholder: 'the agent’s own command',
147
+ hint: 'Empty runs the launch line this build’s table gives the agent.',
148
+ };
149
+ }
150
+ const [binary, ...args] = line.split(/\s+/);
151
+ const name = binary.split('/').pop() || binary;
152
+ return {
153
+ placeholder: line,
154
+ hint: `Empty runs the built-in line (${line}). Quoted paths survive: ${[`/Users/me/bin/${name}`, ...args].join(' ')}`,
155
+ };
156
+ }
157
+
131
158
  /**
132
159
  * The plan for one harness.
133
160
  *
134
161
  * `provider` is the CURRENT config value: a provider already stored stays
135
162
  * editable even when the probe has not run, because hiding a stored value is how
136
- * a form silently rewrites what it cannot show.
163
+ * a form silently rewrites what it cannot show. `launchCommand` is the line the
164
+ * build would spawn, so the box can name it.
137
165
  */
138
166
  export function configFieldPlan(
139
167
  id: HarnessId,
@@ -148,6 +176,7 @@ export function configFieldPlan(
148
176
  // that does not exist left the field permanently empty.
149
177
  const modelsAreSelectors = providers.length > 0;
150
178
  const storedProvider = Boolean(options.provider?.trim());
179
+ const launch = launchFacts(options.launchCommand);
151
180
 
152
181
  return {
153
182
  showProvider: modelsAreSelectors || storedProvider,
@@ -157,7 +186,8 @@ export function configFieldPlan(
157
186
  modelsAreSelectors,
158
187
  envHint: env.hint,
159
188
  envPlaceholder: env.placeholder,
160
- launchPlaceholder: options.launchCommand ?? 'the agent’s own command',
189
+ launchPlaceholder: launch.placeholder,
190
+ launchHint: launch.hint,
161
191
  notes: env.notes,
162
192
  };
163
193
  }
@@ -30,7 +30,7 @@
30
30
  * pick a target's field value, and both must agree.
31
31
  */
32
32
 
33
- import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-facts';
33
+ import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-contracts';
34
34
 
35
35
  export type CanonicalProtocol =
36
36
  | 'openai-chat'
@@ -0,0 +1,60 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Which ACP harnesses accept a fork POINT (a message id) on `session/fork`.
8
+ *
9
+ * Standard ACP has no anchor — the session-fork RFD lists a message id as a
10
+ * future extension. The JetBrains-maintained adapters implement it today as the
11
+ * AIR extension `_meta.jetbrains.air.fork`: claude-agent-acp forks at an
12
+ * assistant message, codex-acp at the turn that holds the message. Every other
13
+ * adapter ignores the key and forks the whole session, so an anchor there is
14
+ * refused instead of being answered with the tip.
15
+ */
16
+
17
+ import { harnessHasLocalTranscript } from '@/shared/lib/harness/transcript';
18
+
19
+ export function harnessForksAtMessage(harness: string | null | undefined): boolean {
20
+ return harness === 'claude' || harness === 'codex';
21
+ }
22
+
23
+ /**
24
+ * Harnesses that advertise `session/fork` but take no anchor: the fork copies
25
+ * the whole conversation. `zcode` is checkpoint-scoped (`latestCheckpoint`),
26
+ * `opencode` and `minimax` have a message-level fork in their own API that
27
+ * their ACP adapter does not pass through.
28
+ */
29
+ export function harnessForksWholeChat(harness: string | null | undefined): boolean {
30
+ return harness === 'opencode' || harness === 'minimax' || harness === 'zcode';
31
+ }
32
+
33
+ /** What a harness can fork: nothing, the whole chat, or at a message. */
34
+ export type ForkCapability = 'none' | 'tip' | 'message';
35
+
36
+ export function forkCapability(harness: string | null | undefined): ForkCapability {
37
+ if (harnessHasLocalTranscript(harness)) return 'message';
38
+ if (harnessForksAtMessage(harness)) return 'message';
39
+ if (harnessForksWholeChat(harness)) return 'tip';
40
+ return 'none';
41
+ }
42
+
43
+ /**
44
+ * Whether a whole-chat fork is offered. The probe is authoritative when it has
45
+ * an answer (an agent that does not advertise `session/fork` must not get the
46
+ * action); without one, the harness's expected capability decides.
47
+ */
48
+ export function canForkChat(
49
+ harness: string | null | undefined,
50
+ probeFork?: boolean | null,
51
+ ): boolean {
52
+ if (probeFork === true) return true;
53
+ if (probeFork === false) return false;
54
+ return forkCapability(harness) !== 'none';
55
+ }
56
+
57
+ /** The `_meta` both AIR adapters read: `{version: 1, messageId}` under AIR. */
58
+ export function airForkPoint(messageId: string): Record<string, unknown> {
59
+ return { jetbrains: { air: { fork: { version: 1, messageId } } } };
60
+ }
@@ -0,0 +1,30 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * MCP delivery per harness.
8
+ *
9
+ * The table is exhaustive over the BUILT-INS; a user-added harness has no row,
10
+ * and the spawn path must still deliver its servers. The fallback is ACP because
11
+ * that is the only transport the add form offers.
12
+ */
13
+
14
+ import { describe, expect, test } from 'bun:test';
15
+ import { mcpDelivery } from '@/shared/lib/harness/mcp-facts';
16
+
17
+ describe('mcpDelivery', () => {
18
+ test('omp over RPC reads its own file', () => {
19
+ expect(mcpDelivery('omp-rpc')).toBe('omp-config');
20
+ });
21
+
22
+ test('every ACP harness is injected on session/new', () => {
23
+ expect(mcpDelivery('claude')).toBe('acp');
24
+ expect(mcpDelivery('omp-acp')).toBe('acp');
25
+ });
26
+
27
+ test('a user-added harness falls back to ACP', () => {
28
+ expect(mcpDelivery('my-agent')).toBe('acp');
29
+ });
30
+ });
@@ -0,0 +1,69 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * How each harness receives MCP servers, MEASURED — not assumed.
8
+ *
9
+ * Two deliveries exist, and the difference is a property of the transport, not
10
+ * a preference:
11
+ *
12
+ * - `acp` — the agent accepts `mcpServers` on `session/new|load|resume|fork`.
13
+ * This is the ACP baseline (stdio) plus the agent's advertised
14
+ * `mcpCapabilities` for `http`/`sse`, so one injection covers every ACP
15
+ * harness without writing a file in the agent's own format.
16
+ * - `omp-config` — omp's RPC mode reads `~/.omp/agent/mcp.json` (and the
17
+ * project's `.omp/mcp.json`) at SPAWN. Kabmo writes that file through the MCP
18
+ * settings page; a change therefore needs a respawn, which is why the
19
+ * delivery is a file rather than a per-session argument.
20
+ *
21
+ * A harness added later is a row here, not a new branch in the spawn path. The
22
+ * table is deliberately exhaustive over `HarnessId`: a missing row is a compile
23
+ * error, so a new agent cannot silently receive no MCP servers.
24
+ */
25
+
26
+ import type { BuiltinHarnessId, HarnessId } from '@/shared/lib/harness/catalog';
27
+
28
+ export type McpDelivery = 'acp' | 'omp-config';
29
+
30
+ export interface HarnessMcpFacts {
31
+ delivery: McpDelivery;
32
+ /** Why this delivery, in one line a settings card can show. */
33
+ note: string;
34
+ }
35
+
36
+ export const HARNESS_MCP_FACTS: Record<BuiltinHarnessId, HarnessMcpFacts> = {
37
+ 'omp-rpc': {
38
+ delivery: 'omp-config',
39
+ note: 'omp reads ~/.omp/agent/mcp.json at spawn; a change applies to the next session.',
40
+ },
41
+ 'omp-acp': { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
42
+ claude: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
43
+ codex: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
44
+ opencode: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
45
+ 'command-code': { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
46
+ dsh: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
47
+ antigravity: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
48
+ minimax: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
49
+ pi: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
50
+ qwen: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
51
+ kimi: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
52
+ cursor: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
53
+ zcode: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
54
+ jcode: { delivery: 'acp', note: 'Injected on session/new, so every new chat sees the current list.' },
55
+ // Measured on 1.0.77: `mcpCapabilities` advertises stdio, http AND sse, and
56
+ // the agent also loads config.toml / ~/.claude.json / .mcp.json on its own.
57
+ grok: { delivery: 'acp', note: 'Injected on session/new and advertised for stdio, http and sse (measured 1.0.77); grok also loads MCP servers from config.toml, ~/.claude.json and the project .mcp.json.' },
58
+ };
59
+
60
+ /**
61
+ * The delivery for one harness.
62
+ *
63
+ * A user-added harness is ACP by definition — that is the only transport the
64
+ * add form offers — so an id with no row takes the ACP path rather than
65
+ * crashing the spawn on an undefined table entry.
66
+ */
67
+ export function mcpDelivery(harness: HarnessId): McpDelivery {
68
+ return (HARNESS_MCP_FACTS as Record<string, HarnessMcpFacts | undefined>)[harness]?.delivery ?? 'acp';
69
+ }
@@ -27,7 +27,7 @@ import {
27
27
  harnessMenuEntries,
28
28
  isHarnessCategory,
29
29
  } from '@/shared/lib/harness/menu';
30
- import { HARNESS_IDS, harnessDescriptor } from '@/shared/lib/harness/catalog';
30
+ import { HARNESS_IDS, harnessDescriptor, registerHarnessDescriptors } from '@/shared/lib/harness/catalog';
31
31
  import { SETTINGS_CATEGORIES } from '@/client/components/settings/Sidebar';
32
32
 
33
33
  describe('harness menu ids', () => {
@@ -92,3 +92,18 @@ describe('harnessMenuEntries', () => {
92
92
  }
93
93
  });
94
94
  });
95
+
96
+ describe('a user-added harness', () => {
97
+ test('gets a menu entry from the roster it is given', () => {
98
+ registerHarnessDescriptors([
99
+ { id: 'my-agent', label: 'My Agent', initial: 'M', transport: 'acp', glyph: 'custom' },
100
+ ]);
101
+ try {
102
+ const entries = harnessMenuEntries(['claude', 'my-agent']);
103
+ expect(entries.map((entry) => entry.harness)).toEqual([null, 'claude', 'my-agent']);
104
+ expect(entries.find((entry) => entry.harness === 'my-agent')?.label).toBe('My Agent');
105
+ } finally {
106
+ registerHarnessDescriptors([]);
107
+ }
108
+ });
109
+ });
@@ -65,7 +65,7 @@ export interface HarnessMenuEntry {
65
65
  * filters with it, and the All Harnesses overview — which always lists every
66
66
  * agent — is where a switched-off one is switched back on.
67
67
  */
68
- export function harnessMenuEntries(): HarnessMenuEntry[] {
68
+ export function harnessMenuEntries(ids: readonly string[] = HARNESS_IDS): HarnessMenuEntry[] {
69
69
  const entries: HarnessMenuEntry[] = [
70
70
  {
71
71
  id: HARNESS_INDEX_CATEGORY as SettingsCategoryId,
@@ -74,7 +74,7 @@ export function harnessMenuEntries(): HarnessMenuEntry[] {
74
74
  harness: null,
75
75
  },
76
76
  ];
77
- for (const id of HARNESS_IDS) {
77
+ for (const id of ids) {
78
78
  const descriptor = harnessDescriptor(id);
79
79
  if (!descriptor || descriptor.builtIn) continue;
80
80
  entries.push({
@@ -0,0 +1,109 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The shapes the measured provider table is written in.
8
+ *
9
+ * Split from `provider-facts.ts` so the table module stays inside the file
10
+ * ceiling as harnesses are added; the table is the one owner of the FACTS,
11
+ * these are the one owner of their SHAPE.
12
+ */
13
+
14
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
15
+ import type { CanonicalProtocol } from '@/shared/lib/harness/dialects';
16
+
17
+ /** How a harness stores providers. */
18
+ export type ProviderRegistryKind =
19
+ /** A YAML document with a `providers` map (omp). */
20
+ | 'yaml-providers'
21
+ /** A JSON document with a `provider` map (opencode). */
22
+ | 'json-provider'
23
+ /** A TOML document with a `model_providers` table (codex). */
24
+ | 'toml-model-providers'
25
+ /** A JSON document with a `providers` map (pi). */
26
+ | 'json-providers'
27
+ /** A TOML document with a `providers` table (kimi). */
28
+ | 'toml-providers'
29
+ /** A JSON settings document with `modelProviders` (qwen). */
30
+ | 'json-model-providers'
31
+ /** ZCode's personal-provider rules: arrays under `config.providerConfigRules`
32
+ * and `config.modelConfigRules` (3.12+). */
33
+ | 'zcode-provider-rules'
34
+ /** No provider registry this build writes; an env contract instead. */
35
+ | 'env'
36
+ /** A registry that exists but belongs to the agent's own writer. */
37
+ | 'agent-managed'
38
+ /** Nothing to offer. */
39
+ | 'none';
40
+
41
+ export interface ProviderRegistry {
42
+ kind: ProviderRegistryKind;
43
+ /** Path relative to the user's home, or null when there is no file. */
44
+ file: string | null;
45
+ /** Dot-path the providers live under, for the editors and the reader. */
46
+ pointer: string;
47
+ /** False when Kabmo may read the entries but must not write them. */
48
+ writable: boolean;
49
+ /** The base-URL field's name in THIS format, so a writer does not guess. */
50
+ baseUrlField: string | null;
51
+ /** The API-key field's name in this format. */
52
+ apiKeyField: string | null;
53
+ /** The dialect/SDK field's name, when the format has one. */
54
+ dialectField?: string;
55
+ /** How this format spells a model entry, for the model list. */
56
+ modelsField: string | null;
57
+ /**
58
+ * Provider ids this registry ships itself. An entry under one of these is the
59
+ * VENDOR's provider with an endpoint override — not a custom provider — and an
60
+ * import must never offer or write one: copying `anthropic` out of omp into
61
+ * codex would replace the vendor entry instead of adding a gateway.
62
+ */
63
+ bundledIds?: readonly string[];
64
+ /**
65
+ * False when this registry writes a MODEL TABLE beside the provider (kimi's
66
+ * `[models.<alias>]`, codex's `model`), so a provider alone serves nothing.
67
+ * The writer then emits the model rows too instead of leaving a husk.
68
+ */
69
+ modelsAreRows?: boolean;
70
+ }
71
+
72
+ /**
73
+ * One picker alias a vendor SDK resolves from the environment. Claude Code's
74
+ * `opus`/`sonnet`/`haiku`/`fable` aliases resolve to ids the VENDOR ships
75
+ * unless `ANTHROPIC_DEFAULT_<FAMILY>_MODEL` pins them; a gateway that lists
76
+ * only its own ids answers the vendor ids with `400 model not found`.
77
+ */
78
+ export interface EnvModelAlias {
79
+ family: string;
80
+ env: string;
81
+ }
82
+
83
+ /** The env names an `environment` harness reads, in the order its docs list. */
84
+ export interface EnvProviderContract {
85
+ baseUrl: string;
86
+ apiKey: string;
87
+ model?: string;
88
+ modelAliases?: readonly EnvModelAlias[];
89
+ }
90
+
91
+ export interface HarnessProviderFacts {
92
+ registry: ProviderRegistry;
93
+ /** Present only for an `env` harness. */
94
+ env?: EnvProviderContract;
95
+ /**
96
+ * The single wire protocol an `environment` harness's SDK speaks. Claude Code
97
+ * is Anthropic Messages and Antigravity is Google GenAI — an endpoint that
98
+ * speaks neither cannot be carried there, and an import has to say so instead
99
+ * of writing a URL the agent will fail every request against.
100
+ */
101
+ envProtocol?: CanonicalProtocol;
102
+ /** True when adding a provider ADDS a choice; false when it replaces the
103
+ * agent's own endpoint (Claude Code, Antigravity). */
104
+ createsChoice: boolean;
105
+ /** Harnesses whose entries this one can import, because the fields line up. */
106
+ importFrom: readonly HarnessId[];
107
+ /** One sentence for the settings card, in the vendor's own vocabulary. */
108
+ summary: string;
109
+ }
@@ -35,7 +35,8 @@ import {
35
35
  registryLabel,
36
36
  supportsProviderEditor,
37
37
  } from '@/shared/lib/harness/providers';
38
- import { HARNESS_PROVIDER_FACTS, managesProviders, providerFacts } from '@/shared/lib/harness/provider-facts';
38
+ import { HARNESS_PROVIDER_FACTS } from '@/shared/lib/harness/provider-facts';
39
+ import { managesProviders, providerFacts } from '@/shared/lib/harness/provider-lookup';
39
40
  import { HARNESS_IDS } from '@/shared/lib/harness/catalog';
40
41
 
41
42
  /** Harnesses whose registry Kabmo may WRITE, with the format it writes. */