@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,87 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The roster write, through the route the client actually calls.
8
+ *
9
+ * Two facts are easy to get wrong here, and both are silent:
10
+ *
11
+ * - the ANSWER decides what the switch shows. A toggle that reports success
12
+ * while the server kept the previous value leaves the UI disagreeing with the
13
+ * database until the next reload;
14
+ * - the built-in transport has no switch, and the refusal must be a real 400
15
+ * rather than a no-op the client would render as "saved".
16
+ *
17
+ * The probe-on-enable half is asserted at the store level (a real spawn needs an
18
+ * agent installed), so these cases hold the roster alone.
19
+ */
20
+
21
+ import { afterAll, afterEach, beforeEach, describe, expect, test } from 'bun:test';
22
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
23
+ import { loadDisabledHarnesses, saveHarnessEnabled } from '@/server/lib/harness/enabled.server';
24
+
25
+ beforeEach(async () => {
26
+ await isolateDb();
27
+ });
28
+
29
+ afterEach(async () => {
30
+ await releaseDb();
31
+ });
32
+
33
+ afterAll(async () => {
34
+ await releaseDb();
35
+ });
36
+
37
+ describe('the harness roster', () => {
38
+ test('nothing stored means every adapter is on', async () => {
39
+ expect(await loadDisabledHarnesses()).toEqual([]);
40
+ });
41
+
42
+ test('switching off stores the DISABLED id, not the enabled roster', async () => {
43
+ expect(await saveHarnessEnabled('claude', false)).toEqual(['claude']);
44
+ expect(await loadDisabledHarnesses()).toEqual(['claude']);
45
+ });
46
+
47
+ test('switching on removes it and deletes the row when nothing is off', async () => {
48
+ await saveHarnessEnabled('claude', false);
49
+ expect(await saveHarnessEnabled('claude', true)).toEqual([]);
50
+ // The empty list IS the default, so no row is left behind — that is what lets
51
+ // an adapter added by a later build arrive switched on.
52
+ expect(await loadDisabledHarnesses()).toEqual([]);
53
+ });
54
+
55
+ test('two harnesses switch independently', async () => {
56
+ await saveHarnessEnabled('claude', false);
57
+ await saveHarnessEnabled('cursor', false);
58
+ expect((await loadDisabledHarnesses()).sort()).toEqual(['claude', 'cursor']);
59
+ await saveHarnessEnabled('claude', true);
60
+ expect(await loadDisabledHarnesses()).toEqual(['cursor']);
61
+ });
62
+
63
+ test('the built-in transport is refused, in both directions', async () => {
64
+ // Refused OUT LOUD, not ignored: a build with `omp` over RPC off could run
65
+ // no chat at all, and a silent no-op would render as "saved" in the UI.
66
+ const off = await saveHarnessEnabled('omp-rpc', false).then(
67
+ () => null,
68
+ (cause: Error) => cause.message,
69
+ );
70
+ const on = await saveHarnessEnabled('omp-rpc', true).then(
71
+ () => null,
72
+ (cause: Error) => cause.message,
73
+ );
74
+ expect(off).toContain('built in');
75
+ expect(on).toContain('built in');
76
+ expect(await loadDisabledHarnesses()).toEqual([]);
77
+ });
78
+
79
+ test('an unknown id is refused rather than invented', async () => {
80
+ const message = await saveHarnessEnabled('not-an-agent', false).then(
81
+ () => null,
82
+ (cause: Error) => cause.message,
83
+ );
84
+ expect(message).toContain('Unknown harness');
85
+ expect(await loadDisabledHarnesses()).toEqual([]);
86
+ });
87
+ });
@@ -0,0 +1,61 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The disabled-harness list on the server.
8
+ *
9
+ * One `app_settings` row (`omp_harness_disabled`), read by `/api/harness` and
10
+ * written by its `{ setEnabled: { id, enabled } }` action. The rules themselves
11
+ * live in `@/shared/lib/harness/enabled`: which ids are switchable, that the list
12
+ * stores the DISABLED ones, and that an unknown or retired id is dropped. This
13
+ * module only persists the answer.
14
+ *
15
+ * A failed write is reported, never swallowed: a toggle that silently does
16
+ * nothing is worse than one that refuses, because the user acts on a state the
17
+ * server does not hold.
18
+ */
19
+
20
+ import { getDb } from '@/server/db.server';
21
+ import { readSettingsJson, writeSettingsJson } from '@/server/lib/db/settings-store';
22
+ import {
23
+ HARNESS_DISABLED_KEY,
24
+ harnessSwitchable,
25
+ parseDisabledHarnesses,
26
+ withHarnessEnabled,
27
+ } from '@/shared/lib/harness/enabled';
28
+ import { harnessDescriptor, type HarnessId } from '@/shared/lib/harness/catalog';
29
+
30
+ /** Every harness id the user has switched OFF. */
31
+ export async function loadDisabledHarnesses(): Promise<string[]> {
32
+ const db = await getDb();
33
+ return parseDisabledHarnesses(await readSettingsJson<unknown>(db, HARNESS_DISABLED_KEY, []));
34
+ }
35
+
36
+ /**
37
+ * Switch one harness and return the list as stored.
38
+ *
39
+ * Throws for the built-in transport and for an id this build does not know: a
40
+ * request naming something no row draws must not invent an entry, because the
41
+ * list is the only record of the user's intent.
42
+ */
43
+ export async function saveHarnessEnabled(id: string, enabled: boolean): Promise<string[]> {
44
+ if (!harnessDescriptor(id)) throw new Error(`Unknown harness: ${id}`);
45
+ if (!harnessSwitchable(id)) {
46
+ // The built-in transport is the path this app IS: a build with it off could
47
+ // run no chat. Refused out loud rather than silently ignored.
48
+ throw new Error(`${id} is built in and cannot be switched off`);
49
+ }
50
+ const db = await getDb();
51
+ const next = withHarnessEnabled(id as HarnessId, enabled, await loadDisabledHarnesses());
52
+ if (next.length === 0) {
53
+ // An empty list means "everything", which is the default — so the row is
54
+ // DELETED rather than written as `[]`, exactly as an all-empty harness config
55
+ // does. A later catalog addition then arrives ON.
56
+ await db.run('DELETE FROM app_settings WHERE key = ?', [HARNESS_DISABLED_KEY]);
57
+ return [];
58
+ }
59
+ await writeSettingsJson(db, HARNESS_DISABLED_KEY, next);
60
+ return next;
61
+ }
@@ -0,0 +1,195 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The launch table, and the extra indirection a launch line can need.
8
+ *
9
+ * Split from `launch.ts` so the table (data) and the probe (spawns one agent)
10
+ * stay under the file ceiling. `commandAvailable` reads this table; a probe
11
+ * reads it too, and both must agree about a bridge like `zcode`, whose command
12
+ * is `npx` but whose chat needs a separate runtime binary.
13
+ */
14
+
15
+ import { existsSync } from 'node:fs';
16
+ import { homedir } from 'node:os';
17
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
18
+
19
+ /** One harness's launch configuration. */
20
+ export interface HarnessLaunch {
21
+ id: HarnessId;
22
+ command: string[];
23
+ /** Extra env the adapter needs (a wrapper path, a log dir, …). */
24
+ env?: Record<string, string>;
25
+ /**
26
+ * A binary the launch line SPAWNS but does not exec itself. The `zcode`
27
+ * bridge starts `zcode app-server --stdio`, so `npx` being present says
28
+ * nothing about whether a chat can run.
29
+ */
30
+ requires?: HarnessRequirement;
31
+ /** Where the CLI installs from, for the settings page's install hint. */
32
+ install?: string;
33
+ /** What the agent looked like when measured on this machine. Display copy
34
+ * only — every panel reads the LIVE probe, never this. */
35
+ note: string;
36
+ }
37
+
38
+ /** An indirection the launcher resolves on its own (the app-server case). */
39
+ export interface HarnessRequirement {
40
+ /** Binary name on PATH. */
41
+ binary: string;
42
+ /** Env var that overrides the lookup with a path or a name. */
43
+ env?: string;
44
+ /** App-bundle paths that also satisfy it. */
45
+ bundled?: readonly string[];
46
+ /** What a missing one is called in the card. */
47
+ label: string;
48
+ }
49
+
50
+ /** A configured path, a `~`-relative path, or a name on PATH. */
51
+ function resolvable(value: string): boolean {
52
+ const trimmed = value.trim();
53
+ if (!trimmed) return false;
54
+ if (trimmed.includes('/') || trimmed.includes('\\')) {
55
+ return existsSync(trimmed.replace(/^~(?=[/\\])/, homedir()));
56
+ }
57
+ return Boolean(Bun.which(trimmed));
58
+ }
59
+
60
+ /**
61
+ * Is the indirection this launch line needs actually present?
62
+ *
63
+ * An explicit `ZCODE_BIN` is authoritative (the bridge uses it verbatim), so a
64
+ * stale path DOES NOT fall back to PATH: claiming "available" would hide the
65
+ * broken setting behind a working install. With no override, PATH and the
66
+ * desktop bundle both count — those are the bridge's own resolution order.
67
+ */
68
+ export function harnessRequirementMet(
69
+ requirement: HarnessRequirement | undefined,
70
+ env?: Record<string, string>,
71
+ ): boolean {
72
+ if (!requirement) return true;
73
+ // A per-harness override wins, then the server's own environment: the spawn
74
+ // merges both, and `ZCODE_BIN` is commonly exported before Kabmo starts.
75
+ const explicit = requirement.env
76
+ ? (env?.[requirement.env] ?? Bun.env[requirement.env] ?? '').trim()
77
+ : '';
78
+ if (explicit) return resolvable(explicit);
79
+ if (Bun.which(requirement.binary)) return true;
80
+ return (requirement.bundled ?? []).some(resolvable);
81
+ }
82
+
83
+ /**
84
+ * The launch table. A harness whose binary is missing reports the failure from
85
+ * `session/new`/spawn and the tab shows it with the install hint below.
86
+ */
87
+ export const HARNESS_LAUNCH: Readonly<Partial<Record<HarnessId, HarnessLaunch>>> = {
88
+ 'omp-acp': {
89
+ id: 'omp-acp',
90
+ command: ['omp', 'acp'],
91
+ install: 'curl -fsSL https://omp.sh/install | sh',
92
+ note: 'fastest handshake measured (0.08 s init, 0.22 s session/new); 221 models',
93
+ },
94
+ claude: {
95
+ id: 'claude',
96
+ command: ['npx', '-y', '@agentclientprotocol/claude-agent-acp@0.100.0'],
97
+ install: 'npm i -g @agentclientprotocol/claude-agent-acp',
98
+ note: 'mode 5 · model 5 · effort 6 · fast · ultracode; needs a Claude login',
99
+ },
100
+ codex: {
101
+ id: 'codex',
102
+ command: ['npx', '-y', '@agentclientprotocol/codex-acp@2.5.0'],
103
+ install: 'npm i -g @agentclientprotocol/codex-acp',
104
+ note: 'bridges `codex app-server`; set CODEX_PATH when the bundled binary cannot run',
105
+ },
106
+ opencode: {
107
+ id: 'opencode',
108
+ command: ['opencode', 'acp'],
109
+ install: 'curl -fsSL https://opencode.ai/install | bash',
110
+ note: 'plugin activation can gate session/new for ~80 s; Kabmo waits it out. Writes plugin logs to stdout',
111
+ },
112
+ dsh: {
113
+ id: 'dsh',
114
+ command: ['dsh', '--profile', 'acp'],
115
+ install: 'npm i -g @deepseek-ai/dsh',
116
+ note: 'no loadSession: history replays from Kabmo\u2019s own stored frames',
117
+ },
118
+ // `cmd` is the bin npm installs; the package also ships `cmdc` (Windows) and the
119
+ // long `command-code` / `commandcode` aliases. Measured: 0.77 s handshake, 43 ms
120
+ // session/new, 96 models · 4 thought levels, and list/resume/close advertised.
121
+ // Todos are off by default (`cmd mods enable todos -g`, then restart).
122
+ 'command-code': {
123
+ id: 'command-code',
124
+ command: ['cmd', 'acp'],
125
+ install: 'npm i -g command-code',
126
+ note: 'needs `cmd login`; 96 models · 4 thought levels; todos off by default',
127
+ },
128
+ // Antigravity CLI (`agy`) replaced Gemini CLI, which Google deprecated. Its ACP
129
+ // server is `agy acp`, and it serves one project per process.
130
+ antigravity: {
131
+ id: 'antigravity',
132
+ command: ['agy', 'acp'],
133
+ install: 'download agy_cli_<os>_<arch>.tar.gz from github.com/google-antigravity/antigravity-cli/releases',
134
+ note: 'ACP since 1.5; sign in once (`agy acp --login`) or authenticate with a Gemini API key; runs under Docker on Linux',
135
+ },
136
+ minimax: {
137
+ id: 'minimax',
138
+ command: ['mcode', 'acp'],
139
+ install: 'npm i -g @minimax-ai/code',
140
+ note: 'needs `mcode login`; fork/resume/close/list all advertised',
141
+ },
142
+ pi: {
143
+ id: 'pi',
144
+ command: ['npx', '-y', 'pi-acp@0.0.34'],
145
+ install: 'npm i -g @earendil-works/pi-coding-agent pi-acp',
146
+ note: 'shells out to a `pi` binary on PATH; needs `pi auth` before a turn succeeds',
147
+ },
148
+ qwen: {
149
+ id: 'qwen',
150
+ command: ['qwen', '--acp'],
151
+ install: 'npm i -g @qwen-code/qwen-code',
152
+ note: 'list/resume; needs `qwen` auth',
153
+ },
154
+ kimi: {
155
+ id: 'kimi',
156
+ command: ['kimi', 'acp'],
157
+ install: 'curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash',
158
+ note: 'ACP needs an onboarded provider (config.toml) or a signed-in account',
159
+ },
160
+ cursor: {
161
+ id: 'cursor',
162
+ command: ['cursor-agent', 'acp'],
163
+ install: 'registry binary (cursor-agent)',
164
+ note: 'registry shape; no CLI probe run here',
165
+ },
166
+ // ZCode's ACP surface is a BRIDGE, not a subcommand: the vendor CLI ships no
167
+ // `acp` verb, and `zcode-acp-server` spawns `zcode app-server --stdio` and
168
+ // translates its events. The bridge resolves the CLI itself (`ZCODE_BIN` →
169
+ // `zcode` on PATH → the desktop app bundle), so the only requirement is a
170
+ // signed-in ZCode install; credentials stay in `~/.zcode`.
171
+ // Measured through Kabmo's own ACP client on 0.82.3: agentInfo
172
+ // `zcode-acp-server` 0.82.3, `session/new` in ~1 s, **1 model · 3 thought
173
+ // levels · 5 modes**, `list`/`resume`/`fork` advertised, steering supported.
174
+ zcode: {
175
+ id: 'zcode',
176
+ command: ['npx', '-y', 'zcode-acp-server@0.82.3'],
177
+ // The bridge spawns `zcode app-server --stdio`; without that binary the
178
+ // probe still answers (its model list comes from files) and every turn
179
+ // exits with "zcode not found". Check the thing a chat actually needs.
180
+ requires: {
181
+ binary: 'zcode',
182
+ env: 'ZCODE_BIN',
183
+ bundled: [
184
+ '/Applications/ZCode.app/Contents/Resources/glm/zcode.cjs',
185
+ '~/Applications/ZCode.app/Contents/Resources/glm/zcode.cjs',
186
+ '/opt/ZCode/resources/glm/zcode.cjs',
187
+ '/usr/share/zcode/resources/glm/zcode.cjs',
188
+ ...(Bun.env.LOCALAPPDATA ? [`${Bun.env.LOCALAPPDATA}/Programs/ZCode/resources/glm/zcode.cjs`] : []),
189
+ ],
190
+ label: 'a ZCode runtime (the desktop app, or `npm i -g zcode-app-cli`)',
191
+ },
192
+ install: 'npm i -g zcode-acp-server zcode-app-cli # the app-server runtime (or install the ZCode desktop app)',
193
+ note: 'bridges `zcode app-server --stdio`; measured 1 model · 3 thought levels · 5 modes, list/resume/fork + steering; needs a ZCode runtime — the desktop app, or `zcode-app-cli` on PATH (`ZCODE_BIN` for a custom install). Custom providers go in ~/.zcode/v2/provider_config.json; the bridge lists only selectable ones',
194
+ },
195
+ };
@@ -0,0 +1,220 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Capability reading, from an `initialize` + `session/new` pair a real agent
8
+ * produced.
9
+ *
10
+ * The fixtures below are the measured shapes, not invented ones: omp publishes
11
+ * `mode`/`model`/`thinking`, claude adds `effort`/`fast`/`ultracode`, dsh has no
12
+ * `loadSession`, gemini has no `sessionCapabilities`. The point is that every
13
+ * PANEL gates on this record, so a wrong flag hides a real panel or shows a
14
+ * fabricated one.
15
+ */
16
+
17
+ import { describe, expect, test } from 'bun:test';
18
+ import fs from 'node:fs';
19
+ import os from 'node:os';
20
+ import { join } from 'node:path';
21
+ import { blockedProbe, capabilitiesFrom, configByCategory, probeHarness, selectValues, sessionLaunchCommand } from '@/server/lib/harness/launch';
22
+ import { harnessRequirementMet } from '@/server/lib/harness/launch-table';
23
+ import type { AcpInitializeResult, AcpConfigOption } from '@/server/lib/harness/acp/protocol';
24
+
25
+ const ompInit: AcpInitializeResult = {
26
+ protocolVersion: 1,
27
+ agentInfo: { name: 'omp', version: '18.16.0' },
28
+ agentCapabilities: {
29
+ loadSession: true,
30
+ sessionCapabilities: { list: {}, fork: {}, resume: {}, close: {} },
31
+ _meta: { steering: { supported: true } },
32
+ },
33
+ authMethods: [],
34
+ };
35
+
36
+ const ompConfig: AcpConfigOption[] = [
37
+ { id: 'mode', category: 'mode', currentValue: 'default', options: [{ value: 'default' }, { value: 'plan' }] },
38
+ { id: 'model', category: 'model', currentValue: 'a/b', options: [{ value: 'a/b' }, { value: 'a/c' }] },
39
+ { id: 'thinking', category: 'thought_level', currentValue: 'high', options: [{ value: 'off' }, { value: 'high' }] },
40
+ ];
41
+
42
+ const dshInit: AcpInitializeResult = {
43
+ protocolVersion: 1,
44
+ agentCapabilities: { sessionCapabilities: { close: {}, list: {}, resume: {} } },
45
+ };
46
+
47
+ describe('capabilitiesFrom', () => {
48
+ test('reads omp: every selector, load, steering, and the mode ladder', () => {
49
+ const caps = capabilitiesFrom(ompInit, ompConfig, { usage: true, plan: false });
50
+ expect(caps).toMatchObject({
51
+ configModel: 2,
52
+ configThinking: 2,
53
+ configMode: 2,
54
+ modeValues: ['default', 'plan'],
55
+ loadSession: true,
56
+ listSessions: true,
57
+ forkSession: true,
58
+ closeSession: true,
59
+ steerMode: 'steer',
60
+ hasUsage: true,
61
+ agentName: 'omp',
62
+ });
63
+ });
64
+
65
+ test('dsh: no loadSession, no fork, no delete — the panels that need them go dark', () => {
66
+ const caps = capabilitiesFrom(dshInit, [], { usage: false, plan: false });
67
+ expect(caps.loadSession).toBe(false);
68
+ expect(caps.forkSession).toBe(false);
69
+ expect(caps.deleteSession).toBe(false);
70
+ expect(caps.listSessions).toBe(true);
71
+ expect(caps.resumeSession).toBe(true);
72
+ expect(caps.steerMode).toBeNull();
73
+ });
74
+
75
+ test('an agent that reports nothing claims nothing', () => {
76
+ const caps = capabilitiesFrom({ protocolVersion: 1 }, undefined, { usage: false, plan: false });
77
+ expect(caps).toMatchObject({
78
+ configModel: 0,
79
+ hasUsage: false,
80
+ hasPlan: false,
81
+ loadSession: false,
82
+ steerMode: null,
83
+ });
84
+ });
85
+
86
+ test('usage and plan are OBSERVED, never assumed', () => {
87
+ const caps = capabilitiesFrom(ompInit, ompConfig, { usage: false, plan: true });
88
+ expect(caps.hasUsage).toBe(false);
89
+ expect(caps.hasPlan).toBe(true);
90
+ });
91
+ });
92
+
93
+ describe('selectValues', () => {
94
+ test('flattens grouped options', () => {
95
+ const option: AcpConfigOption = {
96
+ id: 'model',
97
+ category: 'model',
98
+ options: [
99
+ { group: 'recommended', options: [{ value: 'x', name: 'X' }] },
100
+ { value: 'y', name: 'Y' },
101
+ ],
102
+ };
103
+ expect(selectValues(option)).toEqual([{ value: 'x', name: 'X' }, { value: 'y', name: 'Y' }]);
104
+ });
105
+
106
+ test('a missing category is undefined, not an empty selector', () => {
107
+ expect(configByCategory([], 'model')).toBeUndefined();
108
+ expect(selectValues(undefined)).toEqual([]);
109
+ });
110
+ });
111
+
112
+ describe('steering is advertised at the RESULT root', () => {
113
+ test('_meta.steering next to agentCapabilities enables steer', () => {
114
+ // omp 18.16.0 sends `{... "agentCapabilities": {...}, "_meta": {"steering":
115
+ // {"supported": true}}}` — reading it from inside agentCapabilities found
116
+ // nothing and reported "no steering" for the one agent that has it.
117
+ const caps = capabilitiesFrom(
118
+ { protocolVersion: 1, agentCapabilities: { loadSession: true }, _meta: { steering: { supported: true } } },
119
+ [],
120
+ { usage: false, plan: false },
121
+ );
122
+ expect(caps.steerMode).toBe('steer');
123
+ });
124
+ });
125
+
126
+ describe('sessionLaunchCommand', () => {
127
+ test('omp-acp loads the mode extension the rpc child gets', () => {
128
+ // omp's ACP path dispatches extension commands locally inside
129
+ // `session.prompt()`. Without `-e`, the client's `/kabmo-mode plan
130
+ // republish` (sent on every attach) is an ordinary prompt: measured, it
131
+ // started a MODEL turn on an `omp (ACP)` chat instead of re-announcing the
132
+ // parked plan review.
133
+ const argv = sessionLaunchCommand('omp-acp', ['omp', 'acp']);
134
+ expect(argv.slice(0, 2)).toEqual(['omp', 'acp']);
135
+ expect(argv).toContain('-e');
136
+ const entry = argv[argv.indexOf('-e') + 1] ?? '';
137
+ // `join`, not a literal slash: the entry is a real path from this host, so
138
+ // on Windows it ends `\extensions\kabmo-modes\index.ts` — measured on the
139
+ // Windows gate, where this case alone failed on a correct argv.
140
+ expect(entry.endsWith(join('extensions', 'kabmo-modes', 'index.ts'))).toBe(true);
141
+ });
142
+
143
+ test('a user command override still gets the extension appended', () => {
144
+ const argv = sessionLaunchCommand('omp-acp', ['/opt/omp/bin/omp', 'acp']);
145
+ expect(argv[0]).toBe('/opt/omp/bin/omp');
146
+ expect(argv).toContain('-e');
147
+ });
148
+
149
+ test('other ACP agents never see an -e flag they do not accept', () => {
150
+ const argv = sessionLaunchCommand('claude', ['npx', '-y', 'claude-agent-acp']);
151
+ expect(argv).toEqual(['npx', '-y', 'claude-agent-acp']);
152
+ });
153
+
154
+ test('the table vector is not mutated in place', () => {
155
+ const base = ['omp', 'acp'];
156
+ sessionLaunchCommand('omp-acp', base);
157
+ expect(base).toEqual(['omp', 'acp']);
158
+ });
159
+ });
160
+
161
+ /**
162
+ * The probe measures the launch line it is GIVEN, not the table's.
163
+ *
164
+ * A harness whose env carries its provider config (`CODEX_HOME`, a base URL, a
165
+ * wrapper that logs in) read as "Authentication required" in Settings while its
166
+ * chats ran fine, because the probe ignored the user's command/env override.
167
+ * A launch line that cannot start reports that binary, which is the proof the
168
+ * override was used — and it needs no network or installed agent.
169
+ */
170
+ describe('probeHarness launch override', () => {
171
+ test('a configured command is what gets executed', async () => {
172
+ const probe = await probeHarness('claude', '/tmp', {
173
+ id: 'claude',
174
+ command: ['definitely-not-a-real-binary-xyz'],
175
+ note: '',
176
+ });
177
+ expect(probe.capabilities.blocked).toContain('definitely-not-a-real-binary-xyz');
178
+ expect(probe.models).toEqual([]);
179
+ });
180
+
181
+ test('a blocked probe always carries a reason', async () => {
182
+ const probe = blockedProbe('pi', 'executable not found (command: pi)');
183
+ expect(probe.capabilities.blocked).toBe('executable not found (command: pi)');
184
+ expect(probe.harness).toBe('pi');
185
+ });
186
+ });
187
+
188
+ /**
189
+ * A launch line can depend on a binary it does NOT exec.
190
+ *
191
+ * The zcode bridge starts `zcode app-server --stdio`; the probe still answers
192
+ * (its models come from files), so `npx` being present painted the tab ready
193
+ * while every turn exited with "zcode not found". These cases pin the
194
+ * resolution order the bridge itself uses.
195
+ */
196
+ describe('harnessRequirementMet', () => {
197
+ const dir = fs.mkdtempSync(join(os.tmpdir(), 'kabmo-require-'));
198
+ const present = join(dir, 'zcode.cjs');
199
+ fs.writeFileSync(present, '');
200
+
201
+ test('no requirement means nothing to check', () => {
202
+ expect(harnessRequirementMet(undefined)).toBe(true);
203
+ });
204
+
205
+ test('an explicit env path is authoritative, including when it is wrong', () => {
206
+ const requirement = { binary: 'definitely-not-zcode-xyz', env: 'ZCODE_BIN', label: 'runtime' };
207
+ expect(harnessRequirementMet(requirement, { ZCODE_BIN: present })).toBe(true);
208
+ // A stale override must NOT fall back to PATH: the bridge uses it verbatim.
209
+ expect(harnessRequirementMet(requirement, { ZCODE_BIN: join(dir, 'missing.cjs') })).toBe(false);
210
+ });
211
+
212
+ test('a bundled app path counts when PATH has nothing', () => {
213
+ const requirement = { binary: 'definitely-not-zcode-xyz', bundled: [present], label: 'runtime' };
214
+ expect(harnessRequirementMet(requirement)).toBe(true);
215
+ });
216
+
217
+ test('a binary that is neither on PATH nor bundled is missing', () => {
218
+ expect(harnessRequirementMet({ binary: 'definitely-not-zcode-xyz', label: 'runtime' })).toBe(false);
219
+ });
220
+ });