@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,95 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * One turn of an ACP session: open it, and settle what the panels read at its
8
+ * end. Split out of the session because the rules are about ACP's turn model,
9
+ * not about Kabmo's state.
10
+ *
11
+ * ## The dispatch answers an ACK, never the turn
12
+ *
13
+ * `prompt` over the HTTP route means "accepted" to every client — `sendNewPrompt`
14
+ * adopts the session id and wires its stream on that answer — so returning the
15
+ * TURN here parked a brand-new ACP chat on `new-…` for the answer's whole
16
+ * duration: measured on opencode, the URL stayed `?sessionId=new-…`, the docked
17
+ * indicator read "Loading" and the transcript never appeared, while the turn
18
+ * itself was running fine. omp's own `prompt` returns an ack for the same
19
+ * reason, and the turn's end is reported by the `agent_end` frame instead.
20
+ *
21
+ * ## Why the marker is written AFTER the start
22
+ *
23
+ * `turns.start` throws when a turn is already open, and a marker written for a
24
+ * refused prompt would spin the sidebar over a run that never existed.
25
+ *
26
+ * ## What the panels read at the end
27
+ *
28
+ * The assistant message the mapper closed (omp counts the same quantity from its
29
+ * transcript, and the context panel reads `messageCount`), the durable run
30
+ * marker, and the follow-up queue. The queue is armed from the turn's END exactly
31
+ * as the omp wrapper arms it from its own terminal settle: without it an ACP
32
+ * chat's queued follow-up stayed in `queued_messages` forever, because nothing on
33
+ * this transport scheduled a delivery and the client's nudge route only knew
34
+ * omp's wrapper.
35
+ */
36
+
37
+ import { scheduleQueueDelivery } from '@/server/lib/queue/delivery.server';
38
+ import { emitRealtimeSignal } from '@/server/lib/realtime/signals.server';
39
+ import { saveAcpUsage } from '@/server/lib/harness/acp/acp-telemetry.server';
40
+ import type { AcpTurns } from '@/server/lib/harness/acp/turn';
41
+
42
+ /** What a turn reads and moves on the session. */
43
+ export interface AcpTurnTarget {
44
+ sessionId: string;
45
+ /** Messages this session has moved: prompts sent plus closed answers. */
46
+ messageCount: number;
47
+ promptCount: number;
48
+ assistantCount: number;
49
+ contextUsage: { tokens: number; contextWindow: number; percent: number } | null;
50
+ totalCost: number;
51
+ runModel: { provider: string; modelId: string } | null;
52
+ /** The durable run marker; a field on the session so a test can stub it. */
53
+ markStream: (status: 'stream' | 'finish' | 'abort') => void;
54
+ isAlive(): boolean;
55
+ isBusy(): boolean;
56
+ send(command: Record<string, unknown>): Promise<unknown>;
57
+ }
58
+
59
+ /** Open a turn and mark the run live. Returns the ACK, never the turn. */
60
+ export function beginAcpTurn(
61
+ target: AcpTurnTarget,
62
+ turns: AcpTurns,
63
+ message: string,
64
+ images: unknown,
65
+ ): unknown {
66
+ const ack = turns.start(message, images);
67
+ target.messageCount += 1;
68
+ target.markStream('stream');
69
+ return ack;
70
+ }
71
+
72
+ /** Turn-end bookkeeping: the closed message, the badge, then the queue. */
73
+ export function settleAcpTurn(
74
+ target: AcpTurnTarget,
75
+ info: { stopReason?: string; closedMessage: boolean },
76
+ ): void {
77
+ if (info.closedMessage) target.messageCount += 1;
78
+ // ACP has no transcript to re-read, so the last usage snapshot is what lets
79
+ // the Context ring answer after a reload or a restart.
80
+ void saveAcpUsage({
81
+ sessionId: target.sessionId,
82
+ messageCount: target.messageCount,
83
+ promptCount: target.promptCount,
84
+ assistantCount: target.assistantCount,
85
+ contextUsage: target.contextUsage,
86
+ totalCost: target.totalCost,
87
+ runModel: target.runModel,
88
+ });
89
+ // A cancelled turn is an `abort` badge, every other ending a `finish`.
90
+ target.markStream(info.stopReason === 'cancelled' ? 'abort' : 'finish');
91
+ // Todo/plan/telemetry panels read their own topics; without this signal an
92
+ // ACP turn's usage and titles never republished (the RPC settle path does it).
93
+ emitRealtimeSignal('session-data-dirty', target.sessionId);
94
+ scheduleQueueDelivery(target);
95
+ }
@@ -0,0 +1,60 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The usage numbers an ACP session reports.
8
+ *
9
+ * ACP sends `usage_update` with the context window, the tokens in use and a
10
+ * cost — no per-turn input/output split. This keeps the latest snapshot for the
11
+ * panels, and a per-turn peak summed into `usageTokens` so the goal budget has a
12
+ * measured figure to enforce. All of it is best-effort: an agent that never
13
+ * reports usage leaves every value at zero.
14
+ */
15
+
16
+ export interface AcpContextUsage {
17
+ tokens: number;
18
+ contextWindow: number;
19
+ percent: number;
20
+ }
21
+
22
+ export class AcpUsageMeter {
23
+ contextUsage: AcpContextUsage | null = null;
24
+ totalCost = 0;
25
+ /** Context tokens across completed turns (peak `used` per turn, summed). */
26
+ usageTokens = 0;
27
+ private turnPeak = 0;
28
+
29
+ beginTurn(): void {
30
+ this.turnPeak = 0;
31
+ }
32
+
33
+ absorb(update: Record<string, unknown>): void {
34
+ const size = typeof update.size === 'number' ? update.size : undefined;
35
+ const used = typeof update.used === 'number' ? update.used : undefined;
36
+ if (size !== undefined && used !== undefined && size > 0) {
37
+ this.contextUsage = {
38
+ tokens: used,
39
+ contextWindow: size,
40
+ percent: Math.min(100, Math.max(0, Math.round((used / size) * 100))),
41
+ };
42
+ this.turnPeak = Math.max(this.turnPeak, used);
43
+ }
44
+ const cost = update.cost;
45
+ if (cost && typeof cost === 'object' && 'amount' in cost && typeof cost.amount === 'number') {
46
+ this.totalCost = cost.amount;
47
+ }
48
+ }
49
+
50
+ endTurn(): void {
51
+ this.usageTokens += this.turnPeak;
52
+ this.turnPeak = 0;
53
+ }
54
+
55
+ /** A new goal's budget counts from its own creation, not the chat's past. */
56
+ reset(): void {
57
+ this.usageTokens = 0;
58
+ this.turnPeak = 0;
59
+ }
60
+ }
@@ -0,0 +1,61 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * `get_state` for an ACP session — the one snapshot every omp-shaped consumer
8
+ * reads (the composer's selectors, the context panel, the generating
9
+ * indicator's model).
10
+ *
11
+ * A free function over a narrow view rather than a method, because none of it is
12
+ * ACP: the fields are the ones the omp transport reports for the same command,
13
+ * and building them here is what keeps the session class to the parts that
14
+ * actually speak the protocol.
15
+ *
16
+ * `messageCount` is the session's own tally (prompts sent plus assistant
17
+ * messages the mapper closed) — omp reports the same quantity from its
18
+ * transcript, and a hard-coded 0 made the context panel describe a chat with no
19
+ * history.
20
+ */
21
+
22
+ import { configOption, modelFromOption } from '@/server/lib/harness/acp/prompt';
23
+ import type { AcpConfigOption } from '@/server/lib/harness/acp/protocol';
24
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
25
+
26
+ export interface AcpStateView {
27
+ sessionId: string;
28
+ isStreaming: boolean;
29
+ isPromptRunning: boolean;
30
+ messageCount: number;
31
+ promptCount: number;
32
+ assistantCount: number;
33
+ contextUsage: { tokens: number; contextWindow: number; percent: number } | null;
34
+ totalCost: number;
35
+ runModel: { provider: string; modelId: string } | null;
36
+ configOptions: AcpConfigOption[];
37
+ harness: HarnessId;
38
+ }
39
+
40
+ export function acpWebState(view: AcpStateView): Record<string, unknown> {
41
+ const thinking = configOption(view.configOptions, 'thought_level');
42
+ // The run's model is seeded at `start()` and refreshed by every config write,
43
+ // so this is the value the agent RESOLVED — which is what the run indicator
44
+ // must report, since an alias or a fallback can differ from the request. The
45
+ // fallback exists only for a session whose selector list never carried a model.
46
+ const serving = view.runModel ?? modelFromOption(configOption(view.configOptions, 'model'), view.harness);
47
+ return {
48
+ sessionId: view.sessionId,
49
+ isStreaming: view.isStreaming,
50
+ isPromptRunning: view.isPromptRunning,
51
+ isCompacting: false,
52
+ messageCount: view.messageCount,
53
+ userCount: view.promptCount,
54
+ assistantCount: view.assistantCount,
55
+ ...(view.contextUsage ? { contextUsage: view.contextUsage } : {}),
56
+ totalCost: view.totalCost,
57
+ model: serving ? { id: serving.modelId, provider: serving.provider } : undefined,
58
+ thinkingLevel: typeof thinking?.currentValue === 'string' ? thinking.currentValue : undefined,
59
+ configOptions: view.configOptions,
60
+ };
61
+ }
@@ -0,0 +1,160 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The ACP session stubs the session suites drive.
8
+ *
9
+ * Extracted because the per-concern suites (`session.test.ts`,
10
+ * `session-permissions.test.ts`, `session-observers.test.ts`) each need the same
11
+ * turn harness, and a second copy is exactly how two files drift into asserting
12
+ * different behaviour of one seam.
13
+ *
14
+ * The session is built on `AcpSession.prototype` rather than through the
15
+ * constructor: the constructor spawns a real agent process, and every rule below
16
+ * is about what the session does with frames and commands, not about ACP
17
+ * transport. The seams a case may stub are the ones the class exposes for it
18
+ * (`markStream`, `onNotification`, `onClientRequest`, `proc`).
19
+ */
20
+
21
+ import { AcpSession } from '@/server/lib/harness/acp/session';
22
+ import { AcpUsageMeter } from '@/server/lib/harness/acp/session-usage';
23
+ import { AcpFrameMapper } from '@/server/lib/harness/acp/frames';
24
+ import { AcpTurns } from '@/server/lib/harness/acp/turn';
25
+ import { PendingPermissions } from '@/server/lib/harness/acp/permissions';
26
+ import { stampMessageModel } from '@/server/lib/harness/acp/session-config';
27
+ import type { AgentEvent } from '@/server/lib/omp/rpc/constants';
28
+
29
+ export interface Turn {
30
+ /** Resolves once `session/prompt` has actually been sent. The dispatch is
31
+ * chained behind the previous turn's request, so it is one tick later than
32
+ * the ACK and every assertion has to wait for it. */
33
+ started: Promise<void>;
34
+ /** How many `session/prompt` requests have been sent. */
35
+ calls: () => number;
36
+ /** Settle the pending `session/prompt` call. */
37
+ finish: (result: { stopReason?: string }) => void;
38
+ fail: (error: unknown) => void;
39
+ }
40
+
41
+ export interface MountedSession {
42
+ session: AcpSession;
43
+ events: AgentEvent[];
44
+ turn: Turn;
45
+ /** How many times the turn-end seam fired (the queue's arming hook). */
46
+ turnEnds: () => number;
47
+ /** The durable run markers written for this session, in order. */
48
+ streamMarks: () => string[];
49
+ /** How many times a command or frame deferred the idle reclaim. */
50
+ idleResets: () => number;
51
+ /** Whether a destroy stopped the reclaim clock. */
52
+ idleStopped: () => boolean;
53
+ }
54
+
55
+ /** One in-flight `session/prompt` the stub can settle. */
56
+ interface PendingPrompt {
57
+ promise: Promise<unknown>;
58
+ resolve: (value: unknown) => void;
59
+ reject: (reason?: unknown) => void;
60
+ }
61
+
62
+ export function mountSession(): MountedSession {
63
+ const events: AgentEvent[] = [];
64
+ const dispatched = Promise.withResolvers<void>();
65
+ const calls: PendingPrompt[] = [];
66
+ const turn: Turn = {
67
+ started: dispatched.promise,
68
+ calls: () => calls.length,
69
+ finish: (result) => calls.at(-1)?.resolve(result),
70
+ fail: (error) => calls.at(-1)?.reject(error),
71
+ };
72
+
73
+ const session = Object.create(AcpSession.prototype) as AcpSession;
74
+ const mapper = new AcpFrameMapper();
75
+ let turnEndCount = 0;
76
+ let idleResets = 0;
77
+ let idleStopped = false;
78
+ const idle = {
79
+ timeoutMs: 0,
80
+ reset: () => {
81
+ idleResets += 1;
82
+ },
83
+ stop: () => {
84
+ idleStopped = true;
85
+ },
86
+ };
87
+ const proc = {
88
+ prompt: async (_message: string, _images: unknown) => {
89
+ const pending = Promise.withResolvers<unknown>();
90
+ calls.push(pending);
91
+ dispatched.resolve();
92
+ return pending.promise;
93
+ },
94
+ cancel: () => {},
95
+ abandonPrompt: () => calls.at(-1)?.resolve({ stopReason: 'cancelled' }),
96
+ // A config write; the default reply omits the list, which is the shape a
97
+ // harness that ignores the protocol's "complete list" rule returns.
98
+ setConfigOption: async (_sessionId: string, _configId: string, _value: string | boolean) => ({}),
99
+ dispose: async () => {},
100
+ isAlive: true,
101
+ };
102
+ const turns = new AcpTurns({
103
+ emit: (event) => (session as unknown as { emit: (e: AgentEvent) => void }).emit(event),
104
+ prompt: (message, images) => proc.prompt(message, images) as Promise<{ stopReason?: string } | undefined>,
105
+ cancelAgent: () => proc.cancel(),
106
+ abandonPrompt: () => proc.abandonPrompt(),
107
+ resetMapper: () => mapper.reset(),
108
+ closeMessage: () => mapper.closeMessage().map((event) => stampMessageModel(event, session.runModel)),
109
+ openCalls: () => mapper.openCalls(),
110
+ onTurnEnd: (info) => {
111
+ (session as unknown as { onTurnEnded: (info: { stopReason?: string; closedMessage: boolean }) => void })
112
+ .onTurnEnded(info);
113
+ turnEndCount += 1;
114
+ },
115
+ });
116
+ const marks: string[] = [];
117
+ Object.assign(session as unknown as Record<string, unknown>, {
118
+ markStream: (status: string) => {
119
+ marks.push(status);
120
+ },
121
+ harness: 'opencode',
122
+ cwd: '/tmp',
123
+ sessionId: 'acp-1',
124
+ turns,
125
+ mapper,
126
+ permissions: new PendingPermissions(),
127
+ accessMode: 'always-ask',
128
+ capabilities: {},
129
+ configOptions: [],
130
+ agentCommands: [],
131
+ planEntries: [],
132
+ messageCount: 0,
133
+ promptCount: 0,
134
+ assistantCount: 0,
135
+ usage: new AcpUsageMeter(),
136
+ runModel: null,
137
+ listeners: new Set<(event: AgentEvent) => void>([(event) => events.push(event)]),
138
+ proc,
139
+ idle,
140
+ destroyed: false,
141
+ });
142
+ return {
143
+ session,
144
+ events,
145
+ turn,
146
+ turnEnds: () => turnEndCount,
147
+ streamMarks: () => marks,
148
+ idleResets: () => idleResets,
149
+ idleStopped: () => idleStopped,
150
+ };
151
+ }
152
+
153
+ /** Push one `session/update` at the session, as the process would. */
154
+ export function notify(session: AcpSession, update: Record<string, unknown>): void {
155
+ (session as unknown as { onNotification: (method: string, params: unknown) => void }).onNotification.call(
156
+ session,
157
+ 'session/update',
158
+ { update },
159
+ );
160
+ }
@@ -0,0 +1,233 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * One ACP turn, end to end: the ACK, the terminal frame, and what a Stop does to
8
+ * the NEXT prompt.
9
+ *
10
+ * The session mounts itself through `session.test-util.ts`; the stubs and the
11
+ * reasons for `session/prompt` being chained live there.
12
+ */
13
+
14
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
15
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
16
+ import { mountSession, notify } from '@/server/lib/harness/acp/session.test-util';
17
+ import type { AcpConfigOption } from '@/server/lib/harness/acp/protocol';
18
+
19
+ // A prompt reaches the title writer (`harness/session-title.server.ts`), which
20
+ // opens the database. Isolate it: the handle is process-wide, and a suite that
21
+ // opens it reads and writes the developer's real `~/.kabmo/db.sqlite`.
22
+ beforeEach(async () => {
23
+ await isolateDb();
24
+ });
25
+
26
+ afterEach(async () => {
27
+ await releaseDb();
28
+ });
29
+
30
+ describe('ACP prompt dispatch', () => {
31
+ test('answers an ACK immediately, not the turn', async () => {
32
+ const { session, events, turn } = mountSession();
33
+ const ack = await session.send({ type: 'prompt', message: 'hello' });
34
+ // The turn promise is still open here — that is the point of the case.
35
+ expect(ack).toEqual({ agentInvoked: true });
36
+ expect(events.map((event) => event.type)).toContain('agent_start');
37
+ turn.finish({ stopReason: 'end_turn' });
38
+ });
39
+
40
+ test('the turn end arrives as the terminal frame once the agent is done', async () => {
41
+ const { session, events, turn } = mountSession();
42
+ await session.send({ type: 'prompt', message: 'hello' });
43
+ await turn.started;
44
+ expect(events.some((event) => event.type === 'agent_end')).toBe(false);
45
+
46
+ turn.finish({ stopReason: 'end_turn' });
47
+ for (let i = 0; i < 4; i += 1) await Promise.resolve();
48
+
49
+ expect(events.find((event) => event.type === 'agent_end')).toMatchObject({
50
+ type: 'agent_end',
51
+ isTerminal: true,
52
+ });
53
+ expect(session.isPromptRunning).toBe(false);
54
+ });
55
+
56
+ test('a failed turn reports its error once, and still closes the turn', async () => {
57
+ const { session, events, turn } = mountSession();
58
+ await session.send({ type: 'prompt', message: 'hello' });
59
+ await turn.started;
60
+ turn.fail(new Error('agent exploded'));
61
+ for (let i = 0; i < 4; i += 1) await Promise.resolve();
62
+ const errors = events.filter((event) => event.type === 'prompt_error');
63
+ // The generic "no answer" verdict must not land on top of the agent's own
64
+ // reason: it was emitted SECOND, so the client kept the useless one.
65
+ expect(errors).toEqual([{ type: 'prompt_error', errorMessage: 'agent exploded' }]);
66
+ expect(session.isPromptRunning).toBe(false);
67
+ });
68
+
69
+ test('the turn end arms the follow-up queue, exactly once', async () => {
70
+ const { session, turn, turnEnds } = mountSession();
71
+ await session.send({ type: 'prompt', message: 'hello' });
72
+ await turn.started;
73
+ // Nothing has ended yet: the queue must not be offered a slot while the
74
+ // turn is still running, or the delivery tick would claim the head and
75
+ // dispatch it over the turn the user is watching.
76
+ expect(turnEnds()).toBe(0);
77
+
78
+ turn.finish({ stopReason: 'end_turn' });
79
+ for (let i = 0; i < 4; i += 1) await Promise.resolve();
80
+ expect(turnEnds()).toBe(1);
81
+ });
82
+ });
83
+
84
+ describe('ACP cancel', () => {
85
+ test('closes the turn at once, so the next prompt is accepted', async () => {
86
+ const { session, turn } = mountSession();
87
+ let cancelled = 0;
88
+ (session as unknown as { proc: Record<string, unknown> }).proc.cancel = () => {
89
+ cancelled += 1;
90
+ };
91
+ await session.send({ type: 'prompt', message: 'long job' });
92
+ session.cancelTurn();
93
+
94
+ // The cancel is a NOTIFICATION: nothing guarantees the agent answers it. The
95
+ // reported symptom was a spinner that cleared while `isStreaming` stayed up,
96
+ // so the next send was refused with "Agent is already processing".
97
+ expect(cancelled).toBe(1);
98
+ expect(session.isPromptRunning).toBe(false);
99
+ expect(session.isStreaming).toBe(false);
100
+ expect(session.isRunning()).toBe(false);
101
+
102
+ // The agent's own reply to the cancel arrives late; it must not close a turn
103
+ // that is already closed.
104
+ turn.finish({ stopReason: 'cancelled' });
105
+ for (let i = 0; i < 4; i += 1) await Promise.resolve();
106
+ expect(session.isRunning()).toBe(false);
107
+ });
108
+
109
+ test('the cancel reports the turn as cancelled, once', async () => {
110
+ const { session, events, turn, turnEnds } = mountSession();
111
+ (session as unknown as { proc: Record<string, unknown> }).proc.cancel = () => {};
112
+ await session.send({ type: 'prompt', message: 'long job' });
113
+ session.cancelTurn();
114
+ turn.finish({ stopReason: 'cancelled' });
115
+ for (let i = 0; i < 4; i += 1) await Promise.resolve();
116
+
117
+ const ends = events.filter((event) => event.type === 'agent_end');
118
+ expect(ends).toHaveLength(1);
119
+ expect(ends[0]).toMatchObject({ type: 'agent_end', isTerminal: true, cancelled: true });
120
+ // A Stop ends the turn, so the queue it was holding must be offered a slot
121
+ // rather than left waiting for the next user prompt.
122
+ expect(turnEnds()).toBe(1);
123
+ });
124
+ });
125
+
126
+ describe('ACP turn serialization', () => {
127
+ test('a prompt sent after Stop is dispatched at once, because the cancel settled the one open', async () => {
128
+ const { session, turn } = mountSession();
129
+ await session.send({ type: 'prompt', message: 'long job' });
130
+ await turn.started;
131
+ session.cancelTurn();
132
+
133
+ // `session/cancel` is a notification and omp never answers it: the request
134
+ // stayed open for the life of the process, so the next turn — chained behind
135
+ // it — never went out and every later send was refused as "already
136
+ // processing". Settling it locally is what frees the chain.
137
+ await session.send({ type: 'prompt', message: 'second' });
138
+ for (let i = 0; i < 8; i += 1) await Promise.resolve();
139
+ expect(turn.calls()).toBe(2);
140
+ expect(session.isRunning()).toBe(true);
141
+ });
142
+
143
+ test('the cancelled turn reports one terminal frame, and nothing after it', async () => {
144
+ const { session, events, turn } = mountSession();
145
+ await session.send({ type: 'prompt', message: 'long job' });
146
+ await turn.started;
147
+ session.cancelTurn();
148
+
149
+ const ends = events.filter((event) => event.type === 'agent_end');
150
+ expect(ends).toHaveLength(1);
151
+ expect(ends[0]).toMatchObject({ type: 'agent_end', isTerminal: true, cancelled: true });
152
+
153
+ // The agent keeps talking after the cancel; nobody is watching that turn, and
154
+ // forwarding it reopened the assistant message the client had finalized.
155
+ const before = events.length;
156
+ (session as unknown as { onNotification: (m: string, p: unknown) => void }).onNotification('session/update', {
157
+ update: { sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: 'abandoned' } },
158
+ });
159
+ expect(events.length).toBe(before);
160
+ });
161
+
162
+ test('the replacement turn closes once, when its own prompt answers', async () => {
163
+ const { session, events, turn } = mountSession();
164
+ await session.send({ type: 'prompt', message: 'long job' });
165
+ await turn.started;
166
+ session.cancelTurn();
167
+ await session.send({ type: 'prompt', message: 'second' });
168
+ for (let i = 0; i < 8; i += 1) await Promise.resolve();
169
+
170
+ turn.finish({ stopReason: 'end_turn' });
171
+ for (let i = 0; i < 8; i += 1) await Promise.resolve();
172
+ expect(events.filter((event) => event.type === 'agent_end')).toHaveLength(2);
173
+ expect(session.isRunning()).toBe(false);
174
+ });
175
+ });
176
+
177
+ const modelOption = (currentValue: string, values: string[]): AcpConfigOption => ({
178
+ id: 'sel-model',
179
+ category: 'model',
180
+ type: 'select',
181
+ currentValue,
182
+ options: values.map((value) => ({ value })),
183
+ });
184
+
185
+ /**
186
+ * The footer and the sidebar name a chat by the model the live session is
187
+ * serving. An ACP model pick is a config write, not a respawn, so the identity
188
+ * has to travel three ways: the session's own `runModel`, a frame the client
189
+ * re-reads, and the model fields on the message itself.
190
+ */
191
+ describe('ACP model identity', () => {
192
+ test('set_model without a reply list still renames the session and announces it', async () => {
193
+ const { session, events } = mountSession();
194
+ session.configOptions = [modelOption('p/old', ['p/old', 'p/new'])];
195
+ session.runModel = { provider: 'p', modelId: 'old' };
196
+
197
+ await session.send({ type: 'set_model', provider: 'p', modelId: 'new' });
198
+
199
+ expect(session.runModel).toEqual({ provider: 'p', modelId: 'new' });
200
+ expect(events.some((event) => event.type === 'model_changed')).toBe(true);
201
+ });
202
+
203
+ test('config_option_update adopts the agent’s list and announces it', () => {
204
+ const { session, events } = mountSession();
205
+ session.configOptions = [modelOption('p/old', ['p/old'])];
206
+ session.runModel = { provider: 'p', modelId: 'old' };
207
+
208
+ notify(session, { sessionUpdate: 'config_option_update', configOptions: [modelOption('p/next', ['p/old', 'p/next'])] });
209
+
210
+ expect(session.runModel).toEqual({ provider: 'p', modelId: 'next' });
211
+ expect(events.some((event) => event.type === 'model_changed')).toBe(true);
212
+ });
213
+
214
+ test('assistant frames carry the model that served them', async () => {
215
+ const { session, events, turn } = mountSession();
216
+ session.runModel = { provider: 'kenari', modelId: 'qwen3-8-27b:free' };
217
+ await session.send({ type: 'prompt', message: 'hi' });
218
+ await turn.started;
219
+
220
+ notify(session, { sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: 'hi' } });
221
+ expect(events.find((event) => event.type === 'message_update')?.message).toMatchObject({
222
+ model: 'qwen3-8-27b:free',
223
+ provider: 'kenari',
224
+ });
225
+
226
+ turn.finish({ stopReason: 'end_turn' });
227
+ for (let i = 0; i < 8; i += 1) await Promise.resolve();
228
+ expect(events.find((event) => event.type === 'message_end')?.message).toMatchObject({
229
+ model: 'qwen3-8-27b:free',
230
+ provider: 'kenari',
231
+ });
232
+ });
233
+ });