@kabmo-labs/kabmo 0.22.0 → 0.24.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 (446) hide show
  1. package/README.md +1 -1
  2. package/dist/client/index.html +1 -1
  3. package/dist/client/index.js +873 -524
  4. package/dist/client/static/js/{index-297dck9a.js → index-jcr5twtp.js} +799 -795
  5. package/dist/client/static/js/index-z3w7n85q.css +1 -0
  6. package/marketplace/plugins/stats/package.json +2 -2
  7. package/marketplace/plugins/stats/src/groups.test.ts +14 -0
  8. package/marketplace/plugins/stats/src/groups.ts +20 -0
  9. package/marketplace/plugins/stats/src/labels.test.ts +9 -0
  10. package/marketplace/plugins/stats/src/labels.ts +7 -0
  11. package/marketplace/plugins/stats/src/server.ts +1 -1
  12. package/package.json +1 -1
  13. package/src/client/App.tsx +20 -19
  14. package/src/client/components/common/ComposerTextarea.tsx +10 -1
  15. package/src/client/components/common/Modal.tsx +2 -6
  16. package/src/client/components/common/PWAInstallButton.tsx +3 -2
  17. package/src/client/components/common/Toast.test.tsx +298 -0
  18. package/src/client/components/common/Toast.tsx +103 -37
  19. package/src/client/components/common/ToastStack.tsx +33 -12
  20. package/src/client/components/common/ViewportSelector.tsx +122 -114
  21. package/src/client/components/common/context-usage-button/Ring.tsx +38 -1
  22. package/src/client/components/common/context-usage-button/index.test.tsx +19 -3
  23. package/src/client/components/common/context-usage-button/index.tsx +5 -2
  24. package/src/client/components/common/harness-glyph/brands.ts +65 -0
  25. package/src/client/components/common/harness-glyph/harness-glyph.test.ts +185 -0
  26. package/src/client/components/common/harness-glyph/index.tsx +131 -0
  27. package/src/client/components/common/header-controls/MoreMenu.tsx +2 -1
  28. package/src/client/components/common/header-controls/index.tsx +16 -8
  29. package/src/client/components/common/header-panel-buttons/index.tsx +4 -3
  30. package/src/client/components/common/panel-mark/index.test.tsx +2 -2
  31. package/src/client/components/common/panel-mark/index.tsx +11 -2
  32. package/src/client/components/common/search-select/index.tsx +305 -0
  33. package/src/client/components/common/search-select/search-select.test.tsx +217 -0
  34. package/src/client/components/common/server-control/index.tsx +3 -2
  35. package/src/client/components/common/session-row/index.tsx +18 -1
  36. package/src/client/components/common/toolbar-row/index.tsx +57 -20
  37. package/src/client/components/layout/desktop-layout/LeftColumn.tsx +1 -3
  38. package/src/client/components/layout/desktop-layout/TopNavbar.tsx +3 -2
  39. package/src/client/components/layout/desktop-layout/WorkspacePanels.tsx +7 -1
  40. package/src/client/components/layout/desktop-layout/index.tsx +1 -3
  41. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +1 -0
  42. package/src/client/components/layout/session-sidebar/SessionItem.tsx +18 -1
  43. package/src/client/components/layout/session-sidebar/SessionsView.tsx +1 -3
  44. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.test.tsx +332 -0
  45. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.tsx +310 -0
  46. package/src/client/components/layout/session-sidebar/about-modal/SocialLinks.tsx +63 -51
  47. package/src/client/components/layout/session-sidebar/about-modal/UpdateSection.tsx +4 -2
  48. package/src/client/components/layout/session-sidebar/about-modal/index.test.tsx +122 -0
  49. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +136 -35
  50. package/src/client/components/layout/session-sidebar/harness-mark.test.tsx +126 -0
  51. package/src/client/components/layout/session-sidebar/modern/ActionRow.tsx +4 -3
  52. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +1 -0
  53. package/src/client/components/mobile/LayoutWrapper.tsx +1 -7
  54. package/src/client/components/mobile/SessionSidebar.tsx +1 -3
  55. package/src/client/components/mobile/mobile-main-view/Header.tsx +3 -2
  56. package/src/client/components/mobile/mobile-session-sidebar/Dialogs.tsx +0 -8
  57. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +1 -0
  58. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +17 -1
  59. package/src/client/components/settings/Modal.tsx +26 -22
  60. package/src/client/components/settings/Sidebar.tsx +45 -5
  61. package/src/client/components/settings/categories/HarnessSettings.tsx +207 -0
  62. package/src/client/components/settings/categories/ProjectSettings.tsx +1 -3
  63. package/src/client/components/settings/categories/ProviderSettings.tsx +0 -4
  64. package/src/client/components/settings/categories/SkillCatalogSettings.tsx +13 -23
  65. package/src/client/components/settings/categories/agent-settings/ModelPicker.tsx +23 -30
  66. package/src/client/components/settings/categories/appearance-settings/IconStyleSection.tsx +20 -11
  67. package/src/client/components/settings/categories/chat-settings/GoalSection.tsx +16 -16
  68. package/src/client/components/settings/categories/harness-settings/AddProviderForm.tsx +219 -0
  69. package/src/client/components/settings/categories/harness-settings/ConfigForm.tsx +268 -0
  70. package/src/client/components/settings/categories/harness-settings/EnvProviderForm.tsx +146 -0
  71. package/src/client/components/settings/categories/harness-settings/HarnessCard.tsx +278 -0
  72. package/src/client/components/settings/categories/harness-settings/ImportSection.tsx +195 -0
  73. package/src/client/components/settings/categories/harness-settings/ProviderPanel.tsx +152 -0
  74. package/src/client/components/settings/categories/harness-settings/ToggleList.tsx +147 -0
  75. package/src/client/components/settings/categories/harness-settings/parts.test.tsx +97 -0
  76. package/src/client/components/settings/categories/harness-settings/parts.tsx +84 -0
  77. package/src/client/components/settings/categories/harness-settings/provider-panel.test.tsx +313 -0
  78. package/src/client/components/settings/categories/omp-settings/RoleEditor.test.ts +60 -39
  79. package/src/client/components/settings/categories/omp-settings/RoleRow.tsx +32 -41
  80. package/src/client/components/settings/categories/omp-settings/role-picker.test-util.ts +45 -0
  81. package/src/client/components/settings/categories/panel-plugins/PluginMark.test.ts +1 -1
  82. package/src/client/components/settings/categories/panel-plugins/PluginMark.tsx +11 -4
  83. package/src/client/components/settings/groups.test.tsx +160 -0
  84. package/src/client/components/settings/harness-icons.test.tsx +134 -0
  85. package/src/client/components/workspace/browser-panel/AddressBar.tsx +3 -13
  86. package/src/client/components/workspace/browser-toolbar/clusters.tsx +237 -0
  87. package/src/client/components/workspace/browser-toolbar/index.test.tsx +167 -0
  88. package/src/client/components/workspace/browser-toolbar/index.tsx +99 -100
  89. package/src/client/components/workspace/btw-panel/Messages.tsx +4 -1
  90. package/src/client/components/workspace/btw-panel/index.tsx +2 -0
  91. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +11 -7
  92. package/src/client/components/workspace/chat-timeline/ChatOverlays.tsx +5 -2
  93. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +13 -0
  94. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +13 -0
  95. package/src/client/components/workspace/chat-timeline/GeneratingIndicator.test.ts +41 -0
  96. package/src/client/components/workspace/chat-timeline/GeneratingIndicator.tsx +19 -14
  97. package/src/client/components/workspace/chat-timeline/MessageList.test.ts +14 -0
  98. package/src/client/components/workspace/chat-timeline/MessageList.tsx +6 -0
  99. package/src/client/components/workspace/chat-timeline/PendingChatView.tsx +14 -0
  100. package/src/client/components/workspace/chat-timeline/RunFooter.tsx +4 -0
  101. package/src/client/components/workspace/chat-timeline/RunMark.tsx +58 -0
  102. package/src/client/components/workspace/chat-timeline/SubagentView.tsx +4 -1
  103. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +4 -0
  104. package/src/client/components/workspace/chat-timeline/chat-input/AttachmentToolbar.tsx +1 -0
  105. package/src/client/components/workspace/chat-timeline/chat-input/ComposerRows.tsx +11 -0
  106. package/src/client/components/workspace/chat-timeline/chat-input/ModeToggles.test.ts +13 -0
  107. package/src/client/components/workspace/chat-timeline/chat-input/ModeToggles.tsx +8 -1
  108. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.test.ts +27 -1
  109. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +48 -23
  110. package/src/client/components/workspace/chat-timeline/chat-input/composer-portal.test.tsx +1 -0
  111. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +21 -1
  112. package/src/client/components/workspace/chat-timeline/chat-input/modes-props.ts +7 -0
  113. package/src/client/components/workspace/chat-timeline/chat-input/props.ts +13 -0
  114. package/src/client/components/workspace/chat-timeline/chat-input/selection.ts +11 -2
  115. package/src/client/components/workspace/chat-timeline/chat-input/styles.test.tsx +1 -0
  116. package/src/client/components/workspace/chat-timeline/index.tsx +17 -15
  117. package/src/client/components/workspace/chat-timeline/pending-harness.test.tsx +157 -0
  118. package/src/client/components/workspace/chat-timeline/run-mark.test.ts +104 -0
  119. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/FrameControl.tsx +11 -20
  120. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/GroupedAsk.tsx +1 -1
  121. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/QuestionBlock.tsx +1 -1
  122. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/drafts.ts +1 -1
  123. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/index.tsx +2 -1
  124. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.test.ts +31 -3
  125. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.tsx +5 -1
  126. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.test.ts +56 -45
  127. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.tsx +38 -94
  128. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/wait-parts.tsx +76 -0
  129. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/card-header.ts +2 -1
  130. package/src/client/components/workspace/file-explorer/index.test.ts +25 -0
  131. package/src/client/components/workspace/file-explorer/index.tsx +10 -6
  132. package/src/client/components/workspace/git-panel/index.test.ts +13 -3
  133. package/src/client/components/workspace/git-panel/index.tsx +1 -3
  134. package/src/client/components/workspace/model-dropdown/Fullscreen.tsx +92 -0
  135. package/src/client/components/workspace/model-dropdown/HarnessTabs.tsx +290 -0
  136. package/src/client/components/workspace/model-dropdown/Item.tsx +11 -0
  137. package/src/client/components/workspace/model-dropdown/Panel.tsx +119 -8
  138. package/src/client/components/workspace/model-dropdown/Section.tsx +4 -0
  139. package/src/client/components/workspace/model-dropdown/fullscreen-picker.ts +51 -0
  140. package/src/client/components/workspace/model-dropdown/harness-models.test.ts +177 -0
  141. package/src/client/components/workspace/model-dropdown/harness-models.ts +148 -0
  142. package/src/client/components/workspace/model-dropdown/harness-tabs.test.tsx +336 -0
  143. package/src/client/components/workspace/model-dropdown/index.tsx +114 -85
  144. package/src/client/components/workspace/model-dropdown/placement.test.tsx +127 -0
  145. package/src/client/components/workspace/model-dropdown/popover-metrics.test.ts +107 -0
  146. package/src/client/components/workspace/model-dropdown/popover-metrics.ts +118 -0
  147. package/src/client/components/workspace/model-dropdown/row-mutations.ts +106 -0
  148. package/src/client/components/workspace/model-dropdown/trigger.test.ts +22 -2
  149. package/src/client/components/workspace/model-dropdown/use-popover-size.ts +89 -0
  150. package/src/client/data/settings/omp-schema.json +224 -17
  151. package/src/client/hooks/chat/composer/index.ts +11 -2
  152. package/src/client/hooks/chat/composer/items.test.ts +11 -0
  153. package/src/client/hooks/chat/composer/items.ts +4 -2
  154. package/src/client/hooks/chat/composer/model-selection.test.ts +110 -0
  155. package/src/client/hooks/chat/composer/model-selection.ts +45 -4
  156. package/src/client/hooks/chat/omp/prompt-send.ts +4 -2
  157. package/src/client/hooks/chat/timeline/actions.ts +10 -5
  158. package/src/client/hooks/chat/timeline/ask-frames.ts +5 -4
  159. package/src/client/hooks/chat/timeline/composer-local-actions.test.ts +19 -81
  160. package/src/client/hooks/chat/timeline/composer-modes.ts +11 -2
  161. package/src/client/hooks/chat/timeline/composer-refs.ts +16 -1
  162. package/src/client/hooks/chat/timeline/index.ts +27 -35
  163. package/src/client/hooks/chat/timeline/mode-availability.test.ts +51 -0
  164. package/src/client/hooks/chat/timeline/modes-contract.ts +6 -0
  165. package/src/client/hooks/chat/timeline/modes.ts +41 -2
  166. package/src/client/hooks/chat/timeline/new-chat-open.test.ts +86 -0
  167. package/src/client/hooks/chat/timeline/new-chat-open.ts +23 -5
  168. package/src/client/hooks/chat/timeline/new-chat.test.ts +32 -4
  169. package/src/client/hooks/chat/timeline/new-chat.ts +18 -6
  170. package/src/client/hooks/chat/timeline/prompt-text.test.ts +7 -0
  171. package/src/client/hooks/chat/timeline/prompt-text.ts +15 -6
  172. package/src/client/hooks/chat/timeline/rewind-actions.test.ts +51 -1
  173. package/src/client/hooks/chat/timeline/rewind-actions.ts +23 -1
  174. package/src/client/hooks/chat/timeline/run-identity.test.ts +52 -0
  175. package/src/client/hooks/chat/timeline/run-identity.ts +23 -11
  176. package/src/client/hooks/chat/timeline/send-execute.test.ts +55 -0
  177. package/src/client/hooks/chat/timeline/send-props.ts +11 -3
  178. package/src/client/hooks/chat/timeline/send-steer.test.ts +2 -3
  179. package/src/client/hooks/chat/timeline/send.test-util.ts +3 -2
  180. package/src/client/hooks/chat/timeline/send.test.ts +2 -3
  181. package/src/client/hooks/chat/timeline/send.ts +34 -8
  182. package/src/client/hooks/chat/timeline/session-harness.test.ts +163 -0
  183. package/src/client/hooks/chat/timeline/session-harness.ts +164 -0
  184. package/src/client/hooks/chat/timeline/session-load.test-util.ts +6 -2
  185. package/src/client/hooks/chat/timeline/session-load.test.ts +31 -0
  186. package/src/client/hooks/chat/timeline/session-load.ts +6 -14
  187. package/src/client/hooks/chat/timeline/session-shapes.ts +32 -0
  188. package/src/client/hooks/chat/timeline/spawn-harness.ts +41 -0
  189. package/src/client/hooks/chat/timeline/timeline-running.ts +55 -0
  190. package/src/client/hooks/chat/timeline/tui-only-guard.ts +9 -0
  191. package/src/client/hooks/chat/timeline/undo-confirmation.test.ts +131 -0
  192. package/src/client/hooks/models/harness-catalog.ts +114 -0
  193. package/src/client/hooks/models/provider-writes.test.ts +81 -0
  194. package/src/client/hooks/models/provider-writes.ts +144 -0
  195. package/src/client/hooks/models/use-harness-versions.test.ts +152 -0
  196. package/src/client/hooks/models/use-harness-versions.ts +136 -0
  197. package/src/client/hooks/models/use-harnesses-controller.ts +57 -0
  198. package/src/client/hooks/models/use-harnesses-signal.test.ts +128 -0
  199. package/src/client/hooks/models/use-harnesses.test.ts +187 -0
  200. package/src/client/hooks/models/use-harnesses.ts +215 -0
  201. package/src/client/hooks/settings/providers/index.ts +1 -3
  202. package/src/client/hooks/ui/editor-error-toast.ts +10 -3
  203. package/src/client/hooks/ui/icon-style.ts +28 -0
  204. package/src/client/hooks/ui/on-click-outside.test.ts +104 -0
  205. package/src/client/hooks/ui/on-click-outside.ts +14 -2
  206. package/src/client/hooks/ui/theme.ts +6 -0
  207. package/src/client/hooks/ui/toast-queue.test.ts +126 -0
  208. package/src/client/hooks/ui/toasts.ts +132 -27
  209. package/src/client/hooks/ui/ui-feedback.test.ts +4 -91
  210. package/src/client/lib/ui/control-plate.test.ts +76 -0
  211. package/src/client/lib/ui/control-plate.ts +65 -0
  212. package/src/client/tailwind.css +47 -1
  213. package/src/server/lib/assets/shell-attributes.server.ts +9 -2
  214. package/src/server/lib/assets/shell-attributes.test.ts +22 -6
  215. package/src/server/lib/db/schema.ts +4 -0
  216. package/src/server/lib/harness/acp/acp-audit.server.ts +107 -0
  217. package/src/server/lib/harness/acp/acp-goal-driver.server.ts +153 -0
  218. package/src/server/lib/harness/acp/acp-goal-state.server.ts +136 -0
  219. package/src/server/lib/harness/acp/acp-goal.server.ts +273 -0
  220. package/src/server/lib/harness/acp/acp-goal.test.ts +229 -0
  221. package/src/server/lib/harness/acp/acp-telemetry.server.ts +133 -0
  222. package/src/server/lib/harness/acp/acp-telemetry.test.ts +85 -0
  223. package/src/server/lib/harness/acp/acp-todos.server.ts +45 -0
  224. package/src/server/lib/harness/acp/acp-todos.test.ts +43 -0
  225. package/src/server/lib/harness/acp/activation.test.ts +81 -0
  226. package/src/server/lib/harness/acp/activation.ts +72 -0
  227. package/src/server/lib/harness/acp/calls.ts +97 -0
  228. package/src/server/lib/harness/acp/client.test.ts +73 -0
  229. package/src/server/lib/harness/acp/client.ts +339 -0
  230. package/src/server/lib/harness/acp/commands.test.ts +92 -0
  231. package/src/server/lib/harness/acp/commands.ts +165 -0
  232. package/src/server/lib/harness/acp/frames.test.ts +315 -0
  233. package/src/server/lib/harness/acp/frames.ts +349 -0
  234. package/src/server/lib/harness/acp/mapper.ts +204 -0
  235. package/src/server/lib/harness/acp/permissions.test.ts +66 -0
  236. package/src/server/lib/harness/acp/permissions.ts +155 -0
  237. package/src/server/lib/harness/acp/prompt.test.ts +130 -0
  238. package/src/server/lib/harness/acp/prompt.ts +134 -0
  239. package/src/server/lib/harness/acp/protocol.ts +162 -0
  240. package/src/server/lib/harness/acp/session-config.test.ts +73 -0
  241. package/src/server/lib/harness/acp/session-config.ts +148 -0
  242. package/src/server/lib/harness/acp/session-facts.ts +71 -0
  243. package/src/server/lib/harness/acp/session-handshake.ts +89 -0
  244. package/src/server/lib/harness/acp/session-idle.ts +51 -0
  245. package/src/server/lib/harness/acp/session-notifications.ts +95 -0
  246. package/src/server/lib/harness/acp/session-observers.test.ts +193 -0
  247. package/src/server/lib/harness/acp/session-options.ts +33 -0
  248. package/src/server/lib/harness/acp/session-permissions.test.ts +105 -0
  249. package/src/server/lib/harness/acp/session-permissions.ts +74 -0
  250. package/src/server/lib/harness/acp/session-reaper.test.ts +96 -0
  251. package/src/server/lib/harness/acp/session-turns.ts +95 -0
  252. package/src/server/lib/harness/acp/session-usage.ts +60 -0
  253. package/src/server/lib/harness/acp/session-web-state.ts +61 -0
  254. package/src/server/lib/harness/acp/session.test-util.ts +160 -0
  255. package/src/server/lib/harness/acp/session.test.ts +233 -0
  256. package/src/server/lib/harness/acp/session.ts +350 -0
  257. package/src/server/lib/harness/acp/turn.ts +199 -0
  258. package/src/server/lib/harness/acp/verbs.ts +87 -0
  259. package/src/server/lib/harness/auto-probe.server.test.ts +121 -0
  260. package/src/server/lib/harness/auto-probe.server.ts +178 -0
  261. package/src/server/lib/harness/capabilities.ts +67 -0
  262. package/src/server/lib/harness/config-invalidation.test.ts +91 -0
  263. package/src/server/lib/harness/config.server.test.ts +105 -0
  264. package/src/server/lib/harness/config.server.ts +98 -0
  265. package/src/server/lib/harness/enabled.server.test.ts +87 -0
  266. package/src/server/lib/harness/enabled.server.ts +61 -0
  267. package/src/server/lib/harness/launch-table.ts +195 -0
  268. package/src/server/lib/harness/launch.test.ts +220 -0
  269. package/src/server/lib/harness/launch.ts +216 -0
  270. package/src/server/lib/harness/probe-cache.server.test.ts +154 -0
  271. package/src/server/lib/harness/probe-cache.server.ts +177 -0
  272. package/src/server/lib/harness/provider-entry.ts +212 -0
  273. package/src/server/lib/harness/provider-file.server.ts +67 -0
  274. package/src/server/lib/harness/provider-import.test.ts +191 -0
  275. package/src/server/lib/harness/provider-probe.server.ts +123 -0
  276. package/src/server/lib/harness/provider-sources.server.test.ts +45 -0
  277. package/src/server/lib/harness/provider-sources.server.ts +308 -0
  278. package/src/server/lib/harness/provider-write-error.ts +19 -0
  279. package/src/server/lib/harness/provider-write.server.test.ts +308 -0
  280. package/src/server/lib/harness/provider-write.server.ts +339 -0
  281. package/src/server/lib/harness/provider-zcode.server.test.ts +270 -0
  282. package/src/server/lib/harness/provider-zcode.server.ts +324 -0
  283. package/src/server/lib/harness/register.server.ts +36 -0
  284. package/src/server/lib/harness/registry.ts +58 -0
  285. package/src/server/lib/harness/schema.server.ts +129 -0
  286. package/src/server/lib/harness/session-store.server.test.ts +175 -0
  287. package/src/server/lib/harness/session-store.server.ts +206 -0
  288. package/src/server/lib/harness/session-title.server.test.ts +109 -0
  289. package/src/server/lib/harness/session-title.server.ts +70 -0
  290. package/src/server/lib/harness/session.ts +74 -0
  291. package/src/server/lib/harness/spawn.server.ts +133 -0
  292. package/src/server/lib/harness/update-state.server.ts +185 -0
  293. package/src/server/lib/lifecycle/after-listen.ts +7 -0
  294. package/src/server/lib/models/provider-items.server.ts +1 -1
  295. package/src/server/lib/models/registry-refresh.server.test.ts +87 -0
  296. package/src/server/lib/models/registry-refresh.server.ts +98 -0
  297. package/src/server/lib/omp/config/models-config.ts +4 -0
  298. package/src/server/lib/omp/core/cli.ts +13 -0
  299. package/src/server/lib/omp/core/host-resolution.test.ts +6 -3
  300. package/src/server/lib/omp/rpc/child-config.ts +5 -4
  301. package/src/server/lib/omp/rpc/constants.test.ts +2 -1
  302. package/src/server/lib/omp/rpc/event-fanout.ts +9 -0
  303. package/src/server/lib/omp/rpc/forked-resume.test.ts +14 -3
  304. package/src/server/lib/omp/rpc/rpc-primitives.test.ts +11 -0
  305. package/src/server/lib/omp/rpc/session-registration.ts +7 -2
  306. package/src/server/lib/omp/rpc/session-registry.test.ts +2 -1
  307. package/src/server/lib/omp/rpc/session-registry.ts +74 -5
  308. package/src/server/lib/omp/session/acp-rows.server.ts +79 -0
  309. package/src/server/lib/omp/session/delete-flow.server.ts +15 -8
  310. package/src/server/lib/omp/session/delete.server.ts +12 -0
  311. package/src/server/lib/omp/session/sidebar-data.harness.test.ts +247 -0
  312. package/src/server/lib/omp/session/sidebar-data.server.ts +56 -3
  313. package/src/server/lib/queue/delivery.server.test.ts +4 -2
  314. package/src/server/lib/queue/payload.test.ts +67 -0
  315. package/src/server/lib/queue/payload.ts +9 -3
  316. package/src/server/lib/realtime/signals.server.test.ts +99 -0
  317. package/src/server/lib/realtime/signals.server.ts +25 -5
  318. package/src/server/lib/realtime/topics/session-data.server.ts +29 -0
  319. package/src/server/lib/realtime/topics/session.server.ts +3 -3
  320. package/src/server/routes/agent/command-resume.test.ts +77 -0
  321. package/src/server/routes/agent/command.test.ts +243 -2
  322. package/src/server/routes/agent/command.ts +78 -15
  323. package/src/server/routes/agent/harness-command.ts +133 -0
  324. package/src/server/routes/agent/new.ts +63 -1
  325. package/src/server/routes/chat/rewind.test.ts +147 -0
  326. package/src/server/routes/chat/rewind.ts +29 -7
  327. package/src/server/routes/chat/session.test.ts +240 -0
  328. package/src/server/routes/chat/session.ts +96 -4
  329. package/src/server/routes/harness/add-provider.test.ts +233 -0
  330. package/src/server/routes/harness/import-action.ts +272 -0
  331. package/src/server/routes/harness/import.test.ts +196 -0
  332. package/src/server/routes/harness/index.ts +13 -0
  333. package/src/server/routes/harness/root.ts +280 -0
  334. package/src/server/routes/harness/toggle.test.ts +127 -0
  335. package/src/server/routes/harness/update.ts +259 -0
  336. package/src/server/routes/harness/versions.test.ts +148 -0
  337. package/src/server/routes/harness/versions.ts +105 -0
  338. package/src/server/routes/index.ts +2 -0
  339. package/src/server/routes/sessions/delete-acp.test.ts +227 -0
  340. package/src/server/routes/sessions/queue.ts +7 -2
  341. package/src/server/routes/sessions/routes-queue.test.ts +52 -0
  342. package/src/server/routes/sessions/routes.test.ts +47 -13
  343. package/src/server/routes/sessions/session.ts +35 -0
  344. package/src/server/routes/settings/commands-harness.test.ts +92 -0
  345. package/src/server/routes/settings/commands.ts +26 -0
  346. package/src/server/routes/settings/model-override.ts +5 -2
  347. package/src/server/routes/settings/provider-entry.ts +2 -2
  348. package/src/server/routes/settings/provider-model.ts +2 -2
  349. package/src/server/routes/settings/provider-models.ts +2 -2
  350. package/src/server/routes/settings/provider-refresh.ts +6 -4
  351. package/src/server/routes/settings/providers.ts +3 -1
  352. package/src/server/routes/settings/settings-config-routes.test.ts +10 -2
  353. package/src/server/routes/settings/skills.ts +12 -0
  354. package/src/shared/lib/chat/ask-form/fields.ts +76 -0
  355. package/src/shared/lib/chat/ask-form/index.ts +323 -0
  356. package/src/shared/lib/chat/ask-form/tokens.ts +199 -0
  357. package/src/shared/lib/chat/ask-form/types.ts +43 -0
  358. package/src/shared/lib/chat/ask-form.test.ts +137 -0
  359. package/src/shared/lib/chat/ask-questions.test.ts +65 -1
  360. package/src/shared/lib/chat/ask-questions.ts +51 -145
  361. package/src/shared/lib/chat/ask-results.ts +198 -0
  362. package/src/shared/lib/chat/composer/client.ts +20 -8
  363. package/src/shared/lib/chat/context/usage.test.ts +8 -4
  364. package/src/shared/lib/chat/context/usage.ts +17 -3
  365. package/src/shared/lib/chat/omp/abort.test.ts +61 -0
  366. package/src/shared/lib/chat/omp/abort.ts +8 -2
  367. package/src/shared/lib/chat/omp/tool-frames.test.ts +23 -0
  368. package/src/shared/lib/chat/omp/tool-frames.ts +12 -2
  369. package/src/shared/lib/chat/timeline/omp-callbacks.ts +13 -1
  370. package/src/shared/lib/chat/timeline/prompt-error.test.ts +146 -0
  371. package/src/shared/lib/chat/timeline/prompt-error.ts +88 -0
  372. package/src/shared/lib/chat/tool/summary-wait.test.ts +18 -8
  373. package/src/shared/lib/chat/tool/wait-facts.ts +14 -8
  374. package/src/shared/lib/harness/brand-color.test.ts +66 -0
  375. package/src/shared/lib/harness/brand-color.ts +96 -0
  376. package/src/shared/lib/harness/catalog.test.ts +88 -0
  377. package/src/shared/lib/harness/catalog.ts +169 -0
  378. package/src/shared/lib/harness/config-fields.test.ts +139 -0
  379. package/src/shared/lib/harness/config-fields.ts +168 -0
  380. package/src/shared/lib/harness/config.test.ts +153 -0
  381. package/src/shared/lib/harness/config.ts +206 -0
  382. package/src/shared/lib/harness/dialects.test.ts +140 -0
  383. package/src/shared/lib/harness/dialects.ts +249 -0
  384. package/src/shared/lib/harness/enabled.test.ts +79 -0
  385. package/src/shared/lib/harness/enabled.ts +72 -0
  386. package/src/shared/lib/harness/menu.test.ts +94 -0
  387. package/src/shared/lib/harness/menu.ts +88 -0
  388. package/src/shared/lib/harness/provider-facts.test.ts +199 -0
  389. package/src/shared/lib/harness/provider-facts.ts +349 -0
  390. package/src/shared/lib/harness/provider-slug.ts +46 -0
  391. package/src/shared/lib/harness/providers.ts +175 -0
  392. package/src/shared/lib/harness/rewind.ts +24 -0
  393. package/src/shared/lib/harness/status.test.ts +158 -0
  394. package/src/shared/lib/harness/status.ts +112 -0
  395. package/src/shared/lib/harness/update-plan.test.ts +163 -0
  396. package/src/shared/lib/harness/update-plan.ts +140 -0
  397. package/src/shared/lib/harness/updates.test.ts +106 -0
  398. package/src/shared/lib/harness/updates.ts +177 -0
  399. package/src/shared/lib/icons/icon-paint-authority.test.ts +16 -4
  400. package/src/shared/lib/icons/icon-paint-authority.ts +57 -12
  401. package/src/shared/lib/icons/icon-paint-bucket.test.ts +84 -0
  402. package/src/shared/lib/icons/icon-paint-css.test.ts +23 -25
  403. package/src/shared/lib/icons/icon-paint-css.ts +69 -55
  404. package/src/shared/lib/icons/icon-paint-harness.test.ts +73 -0
  405. package/src/shared/lib/icons/icon-paint-harness.ts +75 -0
  406. package/src/shared/lib/icons/icon-paint-ink.ts +108 -0
  407. package/src/shared/lib/icons/icon-paint-panel.ts +19 -4
  408. package/src/shared/lib/icons/icon-paint-weight.ts +21 -2
  409. package/src/shared/lib/icons/icon-tone.ts +118 -21
  410. package/src/shared/lib/icons/tint-hues.generated.ts +100 -284
  411. package/src/shared/lib/icons/tint-tones.test.ts +79 -25
  412. package/src/shared/lib/icons/tint.ts +66 -6
  413. package/src/shared/lib/models/client.ts +10 -1
  414. package/src/shared/lib/models/provider/vendors.ts +72 -0
  415. package/src/shared/lib/omp/config/schema.test.ts +36 -0
  416. package/src/shared/lib/omp/dialog-methods.ts +4 -3
  417. package/src/shared/lib/omp/session/messages-map-trace.test.ts +42 -0
  418. package/src/shared/lib/omp/session/messages-map.ts +6 -1
  419. package/src/shared/lib/omp/session/parse-message-blocks-toolcall.test.ts +8 -0
  420. package/src/shared/lib/omp/session/parse-message-blocks.ts +6 -1
  421. package/src/shared/lib/omp/session/shell-trace.test.ts +69 -0
  422. package/src/shared/lib/omp/session/shell-trace.ts +63 -0
  423. package/src/shared/lib/omp/session/sidebar.ts +37 -10
  424. package/src/shared/lib/omp/session/wait-idle.test.ts +47 -0
  425. package/src/shared/lib/omp/session/wait-idle.ts +93 -0
  426. package/src/shared/lib/omp/session/wait.test.ts +34 -33
  427. package/src/shared/lib/omp/session/wait.ts +25 -39
  428. package/src/shared/lib/settings/sections.ts +24 -0
  429. package/src/shared/lib/theme/css.ts +2 -0
  430. package/src/shared/lib/theme/ink-scale.ts +21 -1
  431. package/src/shared/lib/theme/theme.test.ts +25 -9
  432. package/src/shared/lib/ui/safe-area.test.ts +28 -0
  433. package/src/shared/lib/ui/safe-area.ts +42 -0
  434. package/src/shared/lib/ui/toast-duration.test.ts +74 -0
  435. package/src/shared/lib/ui/toast-duration.ts +70 -0
  436. package/src/shared/types/harness-version.ts +59 -0
  437. package/src/shared/types/harness.ts +201 -0
  438. package/src/shared/types/index.ts +2 -0
  439. package/src/shared/types/omp/agent.ts +13 -0
  440. package/src/shared/types/settings/state.ts +10 -1
  441. package/src/shared/types/workspace.ts +10 -0
  442. package/src/test-support/env.ts +38 -0
  443. package/src/test-support/file-explorer-render.test-util.ts +37 -0
  444. package/src/test-support/file-explorer.test-util.ts +20 -18
  445. package/src/test-support/harness-table.test-util.ts +108 -0
  446. package/dist/client/static/js/index-7ppta1pb.css +0 -1
@@ -0,0 +1,249 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * One vocabulary for wire protocols, and every registry's own spelling of it.
8
+ *
9
+ * Six registries name the same three protocols in six vocabularies — omp's
10
+ * `api: openai-completions`, opencode's `npm: @ai-sdk/openai-compatible`, kimi's
11
+ * `type: openai_legacy`, qwen's bucket key `openai`, codex's `wire_api: responses`
12
+ * and Claude Code's mere existence as ANTHROPIC_BASE_URL. Passing one through to
13
+ * the other writes a value the target rejects (measured: `wire_api = "chat"` now
14
+ * makes codex refuse to load its whole config), so translation is a TABLE, not a
15
+ * chain of `if`s at a call site.
16
+ *
17
+ * Canonical protocols are the HTTP shapes that actually exist:
18
+ *
19
+ * - `openai-chat` — POST /v1/chat/completions
20
+ * - `openai-responses` — POST /v1/responses
21
+ * - `anthropic-messages` — POST /v1/messages
22
+ * - `google-genai` — GET /v1beta/models, POST :generateContent
23
+ * - `vertex-ai` — google-genai over the Vertex access path
24
+ *
25
+ * Anything with no portable HTTP route (Bedrock's SigV4, Gemini CLI, the judge
26
+ * APIs) is NOT a protocol here: it maps to null, which is what lets an import
27
+ * refuse by name instead of writing a guess.
28
+ *
29
+ * Pure and dependency-free: the client uses it to label a row, the server to
30
+ * pick a target's field value, and both must agree.
31
+ */
32
+
33
+ import type { ProviderRegistryKind } from '@/shared/lib/harness/provider-facts';
34
+
35
+ export type CanonicalProtocol =
36
+ | 'openai-chat'
37
+ | 'openai-responses'
38
+ | 'anthropic-messages'
39
+ | 'google-genai'
40
+ | 'vertex-ai';
41
+
42
+ /** Human label for a protocol, in the vendor's own vocabulary. */
43
+ export const PROTOCOL_LABELS: Readonly<Record<CanonicalProtocol, string>> = {
44
+ 'openai-chat': 'OpenAI Chat Completions',
45
+ 'openai-responses': 'OpenAI Responses',
46
+ 'anthropic-messages': 'Anthropic Messages',
47
+ 'google-genai': 'Google Gemini',
48
+ 'vertex-ai': 'Google Vertex AI',
49
+ };
50
+
51
+ /** Every protocol a registry may speak, in the order a probe should try them. */
52
+ export const CANONICAL_PROTOCOLS: readonly CanonicalProtocol[] = [
53
+ 'openai-chat',
54
+ 'openai-responses',
55
+ 'anthropic-messages',
56
+ 'google-genai',
57
+ 'vertex-ai',
58
+ ];
59
+
60
+ /**
61
+ * Source spelling → canonical protocol. Case and separator folded, because the
62
+ * same value arrives as `openai-responses` (omp), `openai_responses` (kimi) and
63
+ * `@ai-sdk/openai` (opencode) from three files.
64
+ */
65
+ const SOURCE_DIALECTS: Readonly<Record<string, CanonicalProtocol>> = {
66
+ // OpenAI Chat Completions, under every alias the registries use.
67
+ 'openai-completions': 'openai-chat',
68
+ 'openai-compatible': 'openai-chat',
69
+ openaicompatible: 'openai-chat',
70
+ openai: 'openai-chat',
71
+ 'openai-legacy': 'openai-chat',
72
+ openailegacy: 'openai-chat',
73
+ chat: 'openai-chat',
74
+ 'chat-completions': 'openai-chat',
75
+ chatcompletions: 'openai-chat',
76
+ 'openai-chat-completions': 'openai-chat',
77
+ 'openaichatcompletions': 'openai-chat',
78
+ 'ai-sdk-openai-compatible': 'openai-chat',
79
+ 'opencode-ai-providers-openai-compatible': 'openai-chat',
80
+ kimi: 'openai-chat',
81
+
82
+ // OpenAI Responses.
83
+ 'openai-responses': 'openai-responses',
84
+ 'openai-codex-responses': 'openai-responses',
85
+ 'azure-openai-responses': 'openai-responses',
86
+ responses: 'openai-responses',
87
+ 'ai-sdk-openai': 'openai-responses',
88
+ 'opencode-ai-providers-openai': 'openai-responses',
89
+
90
+ // Anthropic Messages.
91
+ 'anthropic-messages': 'anthropic-messages',
92
+ anthropic: 'anthropic-messages',
93
+ 'anthropic-compatible': 'anthropic-messages',
94
+ 'ai-sdk-anthropic': 'anthropic-messages',
95
+ 'opencode-ai-providers-anthropic': 'anthropic-messages',
96
+
97
+ // Google.
98
+ 'google-generative-ai': 'google-genai',
99
+ 'google-genai': 'google-genai',
100
+ gemini: 'google-genai',
101
+ 'ai-sdk-google': 'google-genai',
102
+ 'opencode-ai-providers-google': 'google-genai',
103
+ 'google-vertex': 'vertex-ai',
104
+ vertexai: 'vertex-ai',
105
+ 'vertex-ai': 'vertex-ai',
106
+ 'opencode-ai-providers-google-vertex': 'vertex-ai',
107
+ };
108
+
109
+ /** A dialect spelling, folded to lowercase alphanumerics and single dashes. */
110
+ function foldDialect(value: string): string {
111
+ return value
112
+ .trim()
113
+ .toLowerCase()
114
+ .replace(/^@/, '')
115
+ .replace(/[^a-z0-9]+/g, '-')
116
+ .replace(/^-+|-+$/g, '');
117
+ }
118
+
119
+ /** The canonical protocol a registry's own dialect value means, or null. */
120
+ export function protocolOfSourceDialect(value: string | undefined | null): CanonicalProtocol | null {
121
+ if (!value) return null;
122
+ return SOURCE_DIALECTS[foldDialect(value)] ?? null;
123
+ }
124
+
125
+ /**
126
+ * The value each registry writes for a canonical protocol, or null when that
127
+ * registry has no way to speak it.
128
+ *
129
+ * `openai-responses` maps to `@ai-sdk/openai` on opencode because that package
130
+ * is the AI SDK's OpenAI provider, whose transport is selected by the endpoint;
131
+ * `openai-chat` maps to `openai-compatible` there because a gateway is not
132
+ * OpenAI's own host.
133
+ */
134
+ export function dialectFor(kind: ProviderRegistryKind, protocol: CanonicalProtocol): string | null {
135
+ switch (kind) {
136
+ case 'yaml-providers':
137
+ case 'json-providers':
138
+ return {
139
+ 'openai-chat': 'openai-completions',
140
+ 'openai-responses': 'openai-responses',
141
+ 'anthropic-messages': 'anthropic-messages',
142
+ 'google-genai': 'google-generative-ai',
143
+ 'vertex-ai': 'google-vertex',
144
+ }[protocol];
145
+ case 'json-provider':
146
+ return {
147
+ 'openai-chat': '@ai-sdk/openai-compatible',
148
+ 'openai-responses': '@ai-sdk/openai',
149
+ 'anthropic-messages': '@ai-sdk/anthropic',
150
+ 'google-genai': '@ai-sdk/google',
151
+ 'vertex-ai': '@ai-sdk/google',
152
+ }[protocol];
153
+ case 'toml-model-providers':
154
+ // codex speaks exactly one wire format now; `chat` is rejected at config
155
+ // load, and a single such entry makes every codex command fail.
156
+ return protocol === 'openai-responses' ? 'responses' : null;
157
+ case 'toml-providers':
158
+ return {
159
+ 'openai-chat': 'openai',
160
+ 'openai-responses': 'openai_responses',
161
+ 'anthropic-messages': 'anthropic',
162
+ 'google-genai': 'google-genai',
163
+ 'vertex-ai': 'vertexai',
164
+ }[protocol];
165
+ case 'json-model-providers':
166
+ // qwen routes by protocol BUCKET; the bucket is the built-in id, so no
167
+ // `providerProtocol` mapping is needed for these five.
168
+ return {
169
+ 'openai-chat': 'openai',
170
+ 'openai-responses': 'openai',
171
+ 'anthropic-messages': 'anthropic',
172
+ 'google-genai': 'gemini',
173
+ 'vertex-ai': 'vertex-ai',
174
+ }[protocol];
175
+ case 'zcode-provider-rules':
176
+ // ZCode's own enum (`config.api.type`). Google has no route in its
177
+ // registry, so a Gemini endpoint is refused instead of mislabelled.
178
+ return {
179
+ 'openai-chat': 'openai-chat-completions',
180
+ 'openai-responses': 'openai-responses',
181
+ 'anthropic-messages': 'anthropic-messages',
182
+ 'google-genai': null,
183
+ 'vertex-ai': null,
184
+ }[protocol];
185
+ default:
186
+ return null;
187
+ }
188
+ }
189
+
190
+ /** Every protocol a registry CAN express, in probe order. */
191
+ export function protocolsFor(kind: ProviderRegistryKind): readonly CanonicalProtocol[] {
192
+ return CANONICAL_PROTOCOLS.filter((protocol) => dialectFor(kind, protocol) !== null);
193
+ }
194
+
195
+ /**
196
+ * qwen's OpenAI bucket carries the wire choice per ROW, not per bucket: the same
197
+ * `openai` array holds Chat Completions and Responses routes.
198
+ */
199
+ export function wireApiFor(protocol: CanonicalProtocol): string | null {
200
+ if (protocol === 'openai-chat') return 'chat-completions';
201
+ if (protocol === 'openai-responses') return 'responses';
202
+ return null;
203
+ }
204
+
205
+ /**
206
+ * How a target wants its endpoint spelled.
207
+ *
208
+ * `api-base` takes the full base (`https://kenari.id/v1`) because the registry's
209
+ * own client appends only the route (`/chat/completions`). `root` takes the HOST
210
+ * ROOT because the vendor SDK appends the version too — measured: Claude Code
211
+ * with `ANTHROPIC_BASE_URL=https://kenari.id/v1` answered "successfully" with
212
+ * `output_tokens: 0`, because it requested `/v1/v1/messages`.
213
+ */
214
+ export type BaseUrlStyle = 'api-base' | 'root';
215
+
216
+ /** Strip the version segment a `root` target appends for itself. */
217
+ export function adaptBaseUrl(baseUrl: string, style: BaseUrlStyle): string {
218
+ const trimmed = baseUrl.trim().replace(/\/+$/, '');
219
+ if (!trimmed || style === 'api-base') return trimmed;
220
+ return trimmed.replace(/\/v1(beta|alpha)?$/i, '');
221
+ }
222
+
223
+ /**
224
+ * Protocols a harness can carry, given its registry kind and (for an
225
+ * `environment` harness) the single protocol its vendor SDK speaks.
226
+ */
227
+ export function supportedProtocols(
228
+ kind: ProviderRegistryKind,
229
+ envProtocol?: CanonicalProtocol | null,
230
+ ): readonly CanonicalProtocol[] {
231
+ if (kind === 'env') return envProtocol ? [envProtocol] : [];
232
+ return protocolsFor(kind);
233
+ }
234
+
235
+ /**
236
+ * The protocol an import should use: the source's own when the target speaks it,
237
+ * otherwise the first one both have. Null means the two cannot meet.
238
+ */
239
+ export function planProtocol(
240
+ sourceProtocol: CanonicalProtocol | null,
241
+ target: readonly CanonicalProtocol[],
242
+ ): CanonicalProtocol | null {
243
+ if (target.length === 0) return null;
244
+ if (sourceProtocol && target.includes(sourceProtocol)) return sourceProtocol;
245
+ // No source dialect (a registry that declares none) still imports if exactly
246
+ // one target protocol is possible, because then there is nothing to choose.
247
+ if (!sourceProtocol) return target.length === 1 ? target[0] : null;
248
+ return null;
249
+ }
@@ -0,0 +1,79 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The roster: which harnesses an install keeps ON.
8
+ *
9
+ * The decision that matters is what is STORED — the DISABLED list, not the
10
+ * enabled one — because an adapter added by a later Kabmo update must arrive on.
11
+ * Storing "what the user had enabled" would freeze the roster on the day they
12
+ * first opened Settings, and a new agent would silently never appear.
13
+ *
14
+ * The other half is the built-in transport: `omp` over RPC is the path this app
15
+ * IS, so it has no switch in either direction.
16
+ */
17
+
18
+ import { describe, expect, test } from 'bun:test';
19
+ import {
20
+ harnessEnabled,
21
+ harnessSwitchable,
22
+ parseDisabledHarnesses,
23
+ withHarnessEnabled,
24
+ } from '@/shared/lib/harness/enabled';
25
+
26
+ describe('which harnesses can be switched', () => {
27
+ test('the built-in transport cannot', () => {
28
+ expect(harnessSwitchable('omp-rpc')).toBe(false);
29
+ expect(harnessEnabled('omp-rpc', [])).toBe(true);
30
+ // Even a hand-edited row naming it is ignored, in both directions.
31
+ expect(harnessEnabled('omp-rpc', ['omp-rpc'])).toBe(true);
32
+ expect(withHarnessEnabled('omp-rpc', false, [])).toEqual([]);
33
+ expect(withHarnessEnabled('omp-rpc', true, ['omp-rpc'])).toEqual(['omp-rpc']);
34
+ });
35
+
36
+ test('an adapter can', () => {
37
+ expect(harnessSwitchable('claude')).toBe(true);
38
+ expect(harnessEnabled('claude', [])).toBe(true);
39
+ expect(harnessEnabled('claude', ['claude'])).toBe(false);
40
+ });
41
+ });
42
+
43
+ describe('the stored list', () => {
44
+ test('an absent or malformed row means everything is on', () => {
45
+ // Not "everything is off": the absence of a roster is the DEFAULT roster.
46
+ for (const raw of [null, undefined, 42, 'claude', { claude: true }, []]) {
47
+ expect(parseDisabledHarnesses(raw)).toEqual([]);
48
+ }
49
+ });
50
+
51
+ test('only ids this build knows survive', () => {
52
+ // A retired adapter's id must not sit in the list forever, counted as
53
+ // "disabled" for a row nothing draws.
54
+ expect(parseDisabledHarnesses(['claude', 'retired-agent', 'omp-rpc', 7, null, 'claude']))
55
+ .toEqual(['claude']);
56
+ });
57
+
58
+ test('switching off appends, switching on removes, order preserved', () => {
59
+ expect(withHarnessEnabled('claude', false, [])).toEqual(['claude']);
60
+ expect(withHarnessEnabled('codex', false, ['claude'])).toEqual(['claude', 'codex']);
61
+ expect(withHarnessEnabled('claude', true, ['claude', 'codex'])).toEqual(['codex']);
62
+ // A no-op switch on an already-on harness leaves the list untouched.
63
+ expect(withHarnessEnabled('pi', true, ['claude'])).toEqual(['claude']);
64
+ // And switching an already-off harness off does not duplicate it.
65
+ expect(withHarnessEnabled('claude', false, ['claude'])).toEqual(['claude']);
66
+ });
67
+
68
+ test('the round trip reports exactly what was stored', () => {
69
+ let disabled: string[] = [];
70
+ disabled = withHarnessEnabled('claude', false, disabled);
71
+ disabled = withHarnessEnabled('cursor', false, disabled);
72
+ expect(harnessEnabled('claude', disabled)).toBe(false);
73
+ expect(harnessEnabled('cursor', disabled)).toBe(false);
74
+ expect(harnessEnabled('codex', disabled)).toBe(true);
75
+ disabled = withHarnessEnabled('claude', true, disabled);
76
+ expect(harnessEnabled('claude', disabled)).toBe(true);
77
+ expect(harnessEnabled('cursor', disabled)).toBe(false);
78
+ });
79
+ });
@@ -0,0 +1,72 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Which harnesses this install keeps ON.
8
+ *
9
+ * The catalog is what Kabmo KNOWS how to launch; this is what the user wants in
10
+ * their way. Two different questions, and conflating them is why the settings
11
+ * page used to list twelve agents whether or not any of them could run: a person
12
+ * driving `omp` alone had to read past nine adapters they will never install.
13
+ *
14
+ * **Stored as the DISABLED list, not the enabled one.** A catalog entry added by
15
+ * a Kabmo update must arrive ON — the user asked to hide specific agents, not to
16
+ * freeze the roster they happened to see on the day they first opened Settings.
17
+ * An empty (or absent) list therefore means "everything", and a stale id left in
18
+ * it by a retired harness is simply ignored.
19
+ *
20
+ * The BUILT-IN transport has no switch: `omp` over RPC is the path this app is,
21
+ * there is nothing to install, and a build with it off could run no chat at all.
22
+ */
23
+
24
+ import { harnessDescriptor, type HarnessId } from '@/shared/lib/harness/catalog';
25
+
26
+ /** The `app_settings` key holding the disabled harness ids. */
27
+ export const HARNESS_DISABLED_KEY = 'omp_harness_disabled';
28
+
29
+ /** Can this harness be switched at all? False only for the built-in transport. */
30
+ export function harnessSwitchable(id: string): boolean {
31
+ return !harnessDescriptor(id)?.builtIn;
32
+ }
33
+
34
+ /**
35
+ * Read the stored list into the ids this build still knows.
36
+ *
37
+ * Untrusted input — a hand-edited row, an older build's shape, a plugin write —
38
+ * so anything that is not a string is dropped and duplicates collapse.
39
+ */
40
+ export function parseDisabledHarnesses(raw: unknown): string[] {
41
+ if (!Array.isArray(raw)) return [];
42
+ const seen = new Set<string>();
43
+ const out: string[] = [];
44
+ for (const entry of raw) {
45
+ if (typeof entry !== 'string' || !entry || seen.has(entry)) continue;
46
+ // A retired harness id would otherwise sit in the list forever, counting as
47
+ // "disabled" for a row nothing draws.
48
+ if (!harnessDescriptor(entry)) continue;
49
+ if (!harnessSwitchable(entry)) continue;
50
+ seen.add(entry);
51
+ out.push(entry);
52
+ }
53
+ return out;
54
+ }
55
+
56
+ /** Is this harness on, given the disabled list? */
57
+ export function harnessEnabled(id: string, disabled: readonly string[]): boolean {
58
+ if (!harnessSwitchable(id)) return true;
59
+ return !disabled.includes(id);
60
+ }
61
+
62
+ /** The list after switching one harness, or the same list when it cannot be
63
+ * switched. Pure, so the rule is testable without a database. */
64
+ export function withHarnessEnabled(
65
+ id: HarnessId | string,
66
+ enabled: boolean,
67
+ disabled: readonly string[],
68
+ ): string[] {
69
+ if (!harnessSwitchable(id)) return [...disabled];
70
+ const rest = disabled.filter((entry) => entry !== id);
71
+ return enabled ? rest : [...rest, id];
72
+ }
@@ -0,0 +1,94 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * One settings MENU entry per harness.
8
+ *
9
+ * A harness is a subject with its own config, providers and state, so it gets a
10
+ * page rather than a card in a list of thirteen. Two decisions are pinned here:
11
+ *
12
+ * - the ids are DYNAMIC (`harness:claude`), derived from the catalog. A union
13
+ * member per adapter would need a build-time edit for every agent added at
14
+ * runtime, and the catalog is already the thing that decides which exist.
15
+ * - the overview page survives. A sidebar of fourteen agents with no "is any of
16
+ * this installed?" summary is a list, not an overview — and the install hint
17
+ * is the one piece of information a per-agent page cannot show when the agent
18
+ * is not installed at all.
19
+ */
20
+
21
+ import { describe, expect, test } from 'bun:test';
22
+ import {
23
+ HARNESS_CATEGORY_PREFIX,
24
+ HARNESS_INDEX_CATEGORY,
25
+ harnessCategoryId,
26
+ harnessIdFromCategory,
27
+ harnessMenuEntries,
28
+ isHarnessCategory,
29
+ } from '@/shared/lib/harness/menu';
30
+ import { HARNESS_IDS, harnessDescriptor } from '@/shared/lib/harness/catalog';
31
+ import { SETTINGS_CATEGORIES } from '@/client/components/settings/Sidebar';
32
+
33
+ describe('harness menu ids', () => {
34
+ test('a category round-trips to its harness and back', () => {
35
+ expect(harnessCategoryId('claude')).toBe('harness:claude');
36
+ expect(harnessIdFromCategory('harness:claude')).toBe('claude');
37
+ expect(harnessIdFromCategory('harness:opencode2')).toBe('opencode2');
38
+ });
39
+
40
+ test('a non-harness category names no harness', () => {
41
+ for (const category of ['appearance', 'providers', 'harness-index', 'harness', '']) {
42
+ expect(harnessIdFromCategory(category)).toBeNull();
43
+ }
44
+ });
45
+
46
+ test('the overview is a harness category, but names no agent', () => {
47
+ expect(isHarnessCategory(HARNESS_INDEX_CATEGORY)).toBe(true);
48
+ expect(isHarnessCategory(`${HARNESS_CATEGORY_PREFIX}claude`)).toBe(true);
49
+ expect(isHarnessCategory('providers')).toBe(false);
50
+ expect(harnessIdFromCategory(HARNESS_INDEX_CATEGORY)).toBeNull();
51
+ });
52
+ });
53
+
54
+ describe('harnessMenuEntries', () => {
55
+ test('the overview comes first, then one entry per non-built-in harness', () => {
56
+ const entries = harnessMenuEntries();
57
+ expect(entries[0].id).toBe(HARNESS_INDEX_CATEGORY);
58
+ expect(entries[0].harness).toBeNull();
59
+
60
+ const expected = HARNESS_IDS.filter((id) => !harnessDescriptor(id)?.builtIn);
61
+ expect(entries.slice(1).map((entry) => entry.harness)).toEqual([...expected]);
62
+ });
63
+
64
+ test('the built-in transport gets no page', () => {
65
+ // `omp` over RPC has nothing to install, probe or configure, so a page whose
66
+ // only content is "this is built in" is a dead entry in a menu.
67
+ const entries = harnessMenuEntries();
68
+ expect(entries.some((entry) => entry.harness === 'omp-rpc')).toBe(false);
69
+ });
70
+
71
+ test('every entry names the transport it runs over', () => {
72
+ for (const entry of harnessMenuEntries().slice(1)) {
73
+ expect(entry.description).toContain('ACP over stdio');
74
+ expect(entry.label).toBeTruthy();
75
+ }
76
+ });
77
+
78
+ test('the settings sidebar actually lists every entry', () => {
79
+ // The menu and the drawer are one list; a page that exists in the catalog but
80
+ // not in the drawer is unreachable.
81
+ const ids = SETTINGS_CATEGORIES.map((category) => category.id);
82
+ for (const entry of harnessMenuEntries()) {
83
+ expect(ids).toContain(entry.id);
84
+ }
85
+ expect(SETTINGS_CATEGORIES.filter((c) => c.section === 'HARNESSES')).toHaveLength(harnessMenuEntries().length);
86
+ });
87
+
88
+ test('every harness page is filed under HARNESSES, never under OMP', () => {
89
+ for (const entry of harnessMenuEntries()) {
90
+ const category = SETTINGS_CATEGORIES.find((c) => c.id === entry.id);
91
+ expect(category?.section).toBe('HARNESSES');
92
+ }
93
+ });
94
+ });
@@ -0,0 +1,88 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * One settings MEUN entry per harness, derived from the catalog.
8
+ *
9
+ * A harness is a subject with its own config, its own providers and its own
10
+ * state, so it gets its own page rather than a card in a list of thirteen. The
11
+ * ids are therefore DYNAMIC (`harness:claude`) instead of twelve more members of
12
+ * the `SettingsCategoryId` union: the catalog is what decides which agents this
13
+ * build knows, and a union entry per harness would mean a build-time edit for
14
+ * every adapter added at runtime.
15
+ *
16
+ * The index page (`harness-index`) keeps the overview the old single page gave —
17
+ * every agent with its status and install hint — because a sidebar of fourteen
18
+ * agents with no "is any of this installed?" summary is a list, not an overview.
19
+ */
20
+
21
+ import type { SettingsCategoryId } from '@/shared/types/settings/state';
22
+ import { HARNESS_IDS, harnessDescriptor } from '@/shared/lib/harness/catalog';
23
+
24
+ /** The prefix that makes a category a harness page. */
25
+ export const HARNESS_CATEGORY_PREFIX = 'harness:';
26
+
27
+ /** The overview page's id. */
28
+ export const HARNESS_INDEX_CATEGORY = 'harness-index';
29
+
30
+ /** `harness:claude` for `claude`. */
31
+ export function harnessCategoryId(id: string): SettingsCategoryId {
32
+ return `${HARNESS_CATEGORY_PREFIX}${id}` as SettingsCategoryId;
33
+ }
34
+
35
+ /** The harness a category names, or null when it names something else. */
36
+ export function harnessIdFromCategory(category: string): string | null {
37
+ if (!category.startsWith(HARNESS_CATEGORY_PREFIX)) return null;
38
+ const id = category.slice(HARNESS_CATEGORY_PREFIX.length);
39
+ return id || null;
40
+ }
41
+
42
+ /** True for the overview page or any single harness page. */
43
+ export function isHarnessCategory(category: string): boolean {
44
+ return category === HARNESS_INDEX_CATEGORY || category.startsWith(HARNESS_CATEGORY_PREFIX);
45
+ }
46
+
47
+ export interface HarnessMenuEntry {
48
+ id: SettingsCategoryId;
49
+ label: string;
50
+ description: string;
51
+ /** The harness id, or null for the overview page. */
52
+ harness: string | null;
53
+ }
54
+
55
+ /**
56
+ * The harness menu, in catalog order.
57
+ *
58
+ * The BUILT-IN transport is left out for the reason it has no card: `omp` over
59
+ * RPC has nothing to install, probe or configure, and a page whose only content
60
+ * is "this is built in" is a dead entry in a menu.
61
+ *
62
+ * A harness the user SWITCHED OFF gets no row in the DRAWER, but it keeps its
63
+ * entry here: this list is the catalog's answer, and whether a given install
64
+ * currently shows an agent is the roster's (`omp_harness_disabled`). The sidebar
65
+ * filters with it, and the All Harnesses overview — which always lists every
66
+ * agent — is where a switched-off one is switched back on.
67
+ */
68
+ export function harnessMenuEntries(): HarnessMenuEntry[] {
69
+ const entries: HarnessMenuEntry[] = [
70
+ {
71
+ id: HARNESS_INDEX_CATEGORY as SettingsCategoryId,
72
+ label: 'All Harnesses',
73
+ description: 'Status, install hints and probe results for every agent Kabmo can drive.',
74
+ harness: null,
75
+ },
76
+ ];
77
+ for (const id of HARNESS_IDS) {
78
+ const descriptor = harnessDescriptor(id);
79
+ if (!descriptor || descriptor.builtIn) continue;
80
+ entries.push({
81
+ id: harnessCategoryId(id),
82
+ label: descriptor.label,
83
+ description: `${descriptor.label}: ${descriptor.transport === 'rpc' ? 'native RPC' : 'ACP over stdio'}. Providers, launch command, and the defaults a new chat starts on.`,
84
+ harness: id,
85
+ });
86
+ }
87
+ return entries;
88
+ }