@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,51 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The idle reclaim for one ACP child.
8
+ *
9
+ * The omp wrapper has always reclaimed an idle `omp --mode rpc-ui` child; this
10
+ * transport had no clock at all, so an `omp acp` (or any ACP adapter) outlived
11
+ * the tab that spawned it by hours — measured: a live `omp acp` from a chat the
12
+ * user had not touched since the morning. The clock itself is `IdleReaper`,
13
+ * shared so both transports release an idle agent after the same window, and
14
+ * the decision is here because only the session can answer "is this still
15
+ * wanted?".
16
+ */
17
+
18
+ import { IdleReaper } from '@/server/lib/omp/rpc/idle-reaper';
19
+ import { IDLE_REAP_MS } from '@/server/lib/omp/rpc/constants';
20
+ import type { HarnessCapabilities } from '@/server/lib/harness/capabilities';
21
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
22
+
23
+ /** What the reclaim decision reads; `AcpSession` satisfies it as-is. */
24
+ export interface AcpIdleHost {
25
+ readonly harness: HarnessId;
26
+ readonly capabilities: HarnessCapabilities;
27
+ isBusy(): boolean;
28
+ destroy(): void;
29
+ }
30
+
31
+ /**
32
+ * A working or dialog-blocked session is never reclaimed (the child would take
33
+ * the user's question with it), and the answer is `false` so `IdleReaper`
34
+ * re-arms instead of waiting for a frame that a parked dialog will not send.
35
+ *
36
+ * A child that cannot be restored is also left alone: a non-`session/load`
37
+ * agent has no way back, and `resumeRecordedHarnessSession` refuses to spawn a
38
+ * fresh agent under a chat's id, so reclaiming one would leave a chat that can
39
+ * never take another prompt. `omp-acp` is the exception — it writes a session
40
+ * file, so the chat is restored over RPC.
41
+ */
42
+ export function reclaimIdleAcpSession(host: AcpIdleHost): boolean {
43
+ if (host.isBusy()) return false;
44
+ if (!host.capabilities.loadSession && host.harness !== 'omp-acp') return true;
45
+ host.destroy();
46
+ return true;
47
+ }
48
+
49
+ export function acpIdleReaper(host: AcpIdleHost, timeoutMs?: number): IdleReaper {
50
+ return new IdleReaper(timeoutMs ?? IDLE_REAP_MS, () => reclaimIdleAcpSession(host));
51
+ }
@@ -0,0 +1,95 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * What one `session/update` does to an ACP session.
8
+ *
9
+ * Split out of the session class because the rules are about the protocol, not
10
+ * about the process: metadata arrives BETWEEN turns (omp publishes its command
11
+ * list and usage right after `session/new`), the agent's own title arrives
12
+ * between turns too, and frames for a cancelled turn must be dropped before the
13
+ * mapper can reopen a finalized message.
14
+ *
15
+ * The host is the narrow slice the rules need, so this can be tested without a
16
+ * child and the session file stays under the size ceiling.
17
+ */
18
+
19
+ import type { AgentEvent } from '@/server/lib/omp/rpc/constants';
20
+ import type { HarnessCapabilities } from '@/server/lib/harness/capabilities';
21
+ import { noteAgentTitle } from '@/server/lib/harness/session-title.server';
22
+ import { metadataCapabilities, parseAgentCommands, type AgentCommand } from '@/server/lib/harness/acp/session-facts';
23
+ import {
24
+ adoptConfigList,
25
+ publishConfigChange,
26
+ stampMessageModel,
27
+ type AcpConfigNotice,
28
+ } from '@/server/lib/harness/acp/session-config';
29
+ import type { AcpConfigOption } from '@/server/lib/harness/acp/protocol';
30
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
31
+
32
+ export interface AcpNotificationHost extends AcpConfigNotice {
33
+ readonly harness: HarnessId;
34
+ agentCommands: AgentCommand[];
35
+ planEntries: unknown[];
36
+ capabilities: HarnessCapabilities;
37
+ messageCount: number;
38
+ assistantCount: number;
39
+ absorbUsage(update: Record<string, unknown>): void;
40
+ acceptingFrames(): boolean;
41
+ mapUpdate(update: Record<string, unknown>): AgentEvent[];
42
+ emit(event: AgentEvent): void;
43
+ }
44
+
45
+ /** Apply one `session/update` notification, or ignore a different method. */
46
+ export function handleSessionNotification(
47
+ host: AcpNotificationHost,
48
+ method: string,
49
+ params: Record<string, unknown>,
50
+ ): void {
51
+ if (method !== 'session/update') return;
52
+ const update = params.update;
53
+ if (!update || typeof update !== 'object') return;
54
+ const record = update as Record<string, unknown>;
55
+ const kind = typeof record.sessionUpdate === 'string' ? record.sessionUpdate : '';
56
+
57
+ // Session METADATA arrives between turns — omp publishes its command list and
58
+ // a usage update right after `session/new`, when no turn is open. The turn
59
+ // gate below exists so abandoned output cannot reopen a finalized message;
60
+ // applying it to these dropped the composer's `/` pool and the panels'
61
+ // capability flags entirely.
62
+ if (kind === 'available_commands_update') host.agentCommands = parseAgentCommands(record);
63
+ if (kind === 'plan') host.planEntries = Array.isArray(record.entries) ? record.entries : [];
64
+ if (kind === 'usage_update') host.absorbUsage(record);
65
+ const absorbed = metadataCapabilities(host.capabilities, kind);
66
+ if (absorbed !== host.capabilities) host.capabilities = absorbed;
67
+ // The agent's own name for this chat arrives BETWEEN turns (measured on
68
+ // claude: after the first answer), where the turn gate below would drop it.
69
+ // Persisted here so the sidebar row can say it — and it outranks the guess
70
+ // `notePromptTitle` made from the first prompt.
71
+ if (kind === 'session_info_update' && typeof record.title === 'string' && host.sessionId) {
72
+ void noteAgentTitle(host.sessionId, record.title);
73
+ }
74
+ // The agent can move a selector itself (a fallback, a dependent option after a
75
+ // model switch). Its list is authoritative and arrives between turns, so it
76
+ // is adopted BEFORE the turn gate below — the session, telemetry and the goal
77
+ // audit must read the same model the client's `config_option_update` names.
78
+ if (kind === 'config_option_update' && Array.isArray(record.configOptions)) {
79
+ adoptConfigList(host, record.configOptions as AcpConfigOption[]);
80
+ publishConfigChange(host);
81
+ }
82
+
83
+ // No turn open: the user stopped it (or one is still queued), and anything
84
+ // the agent keeps emitting belongs to work nobody is watching. Forwarding it
85
+ // reopened the assistant message after Stop and streamed abandoned text into
86
+ // a transcript the client had already finalized.
87
+ if (!host.acceptingFrames()) return;
88
+ for (const event of host.mapUpdate(record)) {
89
+ host.emit(stampMessageModel(event, host.runModel));
90
+ if (event.type === 'message_end') {
91
+ host.messageCount += 1;
92
+ host.assistantCount += 1;
93
+ }
94
+ }
95
+ }
@@ -0,0 +1,193 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * What an ACP session REPORTS: the durable run marker the sidebar's spinner
8
+ * reads, the answer a silent turn must give, and the session facts the panels
9
+ * read (message count, plan capability, the agent's own command list).
10
+ *
11
+ * omp reports all of these from its transcript; the ACP driver had none of them
12
+ * (`messageCount` was hard-coded 0, `get_commands` answered `[]`, and no
13
+ * `session_stream_state` row was ever written), so the composer's `/` pool, the
14
+ * context panel and the sidebar described a different agent.
15
+ */
16
+
17
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
18
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
19
+ import { mountSession, notify } from '@/server/lib/harness/acp/session.test-util';
20
+ import { loadAcpSessions, saveHarnessSession } from '@/server/lib/harness/session-store.server';
21
+ import { onRealtimeSignal } from '@/server/lib/realtime/signals.server';
22
+
23
+ // A prompt reaches the title writer, which opens the database — isolate it.
24
+ beforeEach(async () => {
25
+ await isolateDb();
26
+ });
27
+
28
+ afterEach(async () => {
29
+ await releaseDb();
30
+ });
31
+
32
+ /**
33
+ * A turn that ends with nothing must SAY so.
34
+ *
35
+ * Measured on pi-acp: when its provider call fails it answers `session/prompt`
36
+ * with `{}` and sends no frames at all, so the bubble stayed empty with no
37
+ * error and the operator could not tell a refusal from an empty answer.
38
+ */
39
+ describe('ACP silent turn', () => {
40
+ const finishWith = async (message: string, say?: string) => {
41
+ const { session, events, turn } = mountSession();
42
+ await session.send({ type: 'prompt', message });
43
+ await turn.started;
44
+ if (say) notify(session, { sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: say } });
45
+ turn.finish({ stopReason: 'end_turn' });
46
+ for (let i = 0; i < 5; i += 1) await Promise.resolve();
47
+ return events;
48
+ };
49
+
50
+ test('reports an error when no message and no tool call arrived', async () => {
51
+ const events = await finishWith('Say DUMMY_OK');
52
+ const error = events.find((event) => event.type === 'prompt_error');
53
+ expect(error).toMatchObject({ errorMessage: 'The agent ended the turn without sending an answer' });
54
+ });
55
+
56
+ test('a whitespace-only chunk is the same silent failure', async () => {
57
+ // The row renders no text, so a frame that carries only spaces looks exactly
58
+ // like an empty bubble — reporting it is the only way the operator learns
59
+ // the turn failed.
60
+ const events = await finishWith('Say DUMMY_OK', ' \n ');
61
+ const error = events.find((event) => event.type === 'prompt_error');
62
+ expect(error).toMatchObject({ errorMessage: 'The agent ended the turn without sending an answer' });
63
+ });
64
+
65
+ test('an answered turn reports no error', async () => {
66
+ const events = await finishWith('Say DUMMY_OK', 'DUMMY_OK');
67
+ expect(events.some((event) => event.type === 'prompt_error')).toBe(false);
68
+ expect(events.some((event) => event.type === 'message_end' || event.type === 'message_update')).toBe(true);
69
+ });
70
+
71
+ test('a slash command is exempt: it is answered locally and produces nothing', async () => {
72
+ const events = await finishWith('/kabmo-mode plan on');
73
+ expect(events.some((event) => event.type === 'prompt_error')).toBe(false);
74
+ });
75
+ });
76
+
77
+ /**
78
+ * The sidebar's spinner comes from the `session_stream_state` row, and ACP had
79
+ * no writer for it: measured on a live chat, the transcript streamed while the
80
+ * session row's `aria-label="Running"` mark never appeared. The marker is
81
+ * asserted through the seam so these cases stay free of the row's own module.
82
+ */
83
+ describe('ACP stream marker', () => {
84
+ test('a turn writes `stream` and closes with `finish`', async () => {
85
+ const { session, turn, streamMarks } = mountSession();
86
+ await session.send({ type: 'prompt', message: 'hello' });
87
+ await turn.started;
88
+ expect(streamMarks()).toEqual(['stream']);
89
+
90
+ turn.finish({ stopReason: 'end_turn' });
91
+ for (let i = 0; i < 4; i += 1) await Promise.resolve();
92
+ expect(streamMarks()).toEqual(['stream', 'finish']);
93
+ });
94
+
95
+ test('a Stop closes the marker as `abort`, not `finish`', async () => {
96
+ const { session, turn, streamMarks } = mountSession();
97
+ await session.send({ type: 'prompt', message: 'long job' });
98
+ await turn.started;
99
+ session.cancelTurn();
100
+ expect(streamMarks()).toEqual(['stream', 'abort']);
101
+ });
102
+
103
+ test('a refused prompt writes nothing', async () => {
104
+ const { session, turn, streamMarks } = mountSession();
105
+ await session.send({ type: 'prompt', message: 'first' });
106
+ await turn.started;
107
+ // `await` is what makes the assertion run: `.rejects` resolves the check.
108
+ await expect(session.send({ type: 'prompt', message: 'second' })).rejects.toThrow('already processing');
109
+ expect(streamMarks()).toEqual(['stream']);
110
+ turn.finish({ stopReason: 'end_turn' });
111
+ });
112
+ });
113
+
114
+ describe('ACP session facts', () => {
115
+ test('counts the prompt and every closed assistant message', async () => {
116
+ const { session, turn } = mountSession();
117
+ await session.send({ type: 'prompt', message: 'hello' });
118
+ await turn.started;
119
+ expect(session.messageCount).toBe(1);
120
+
121
+ notify(session, { sessionUpdate: 'agent_message_chunk', messageId: 'm1', content: { type: 'text', text: 'one' } });
122
+ notify(session, { sessionUpdate: 'agent_message_chunk', messageId: 'm2', content: { type: 'text', text: 'two' } });
123
+ expect(session.messageCount).toBe(2);
124
+ turn.finish({ stopReason: 'end_turn' });
125
+ });
126
+
127
+ test('a closed assistant message increments the count, a silent end does not', () => {
128
+ const { session } = mountSession();
129
+ session.onTurnEnded({ closedMessage: true });
130
+ expect(session.messageCount).toBe(1);
131
+ session.onTurnEnded({ closedMessage: false, stopReason: 'cancelled' });
132
+ expect(session.messageCount).toBe(1);
133
+ });
134
+
135
+ test('observes a plan update, which the panels gate on', () => {
136
+ const { session } = mountSession();
137
+ expect(session.capabilities.hasPlan).not.toBe(true);
138
+ notify(session, { sessionUpdate: 'plan' });
139
+ expect(session.capabilities.hasPlan).toBe(true);
140
+ });
141
+
142
+ test('folds usage_update into the numbers the context ring reads', () => {
143
+ const { session } = mountSession();
144
+ notify(session, { sessionUpdate: 'usage_update', size: 1000, used: 250, cost: { amount: 0.5 } });
145
+ expect(session.contextUsage).toEqual({ tokens: 250, contextWindow: 1000, percent: 25 });
146
+ expect(session.totalCost).toBe(0.5);
147
+ expect(session.webState()).toMatchObject({
148
+ contextUsage: { tokens: 250, contextWindow: 1000, percent: 25 },
149
+ totalCost: 0.5,
150
+ userCount: 0,
151
+ assistantCount: 0,
152
+ });
153
+ });
154
+
155
+ test('keeps the agent’s own command list and answers `get_commands` with it', async () => {
156
+ const { session } = mountSession();
157
+ notify(session, {
158
+ sessionUpdate: 'available_commands_update',
159
+ availableCommands: [
160
+ { name: 'deep-research', description: 'Deep research', input: { hint: '<query>' } },
161
+ { name: 'dataviz' },
162
+ { name: 42 },
163
+ ],
164
+ });
165
+ expect(session.agentCommands).toEqual([
166
+ { name: 'deep-research', description: 'Deep research', inputHint: '<query>' },
167
+ { name: 'dataviz' },
168
+ ]);
169
+ expect(await session.send({ type: 'get_commands' })).toEqual({ commands: session.agentCommands });
170
+ });
171
+
172
+ test('records the agent’s own title, which arrives BETWEEN turns', async () => {
173
+ const { session } = mountSession();
174
+ await saveHarnessSession({ sessionId: 'acp-1', harness: 'opencode', agentSessionId: '', cwd: '/tmp' });
175
+
176
+ // No turn is open here — that is the case that used to drop the frame, so an
177
+ // agent naming its chat (measured on claude, after the first answer) left the
178
+ // sidebar row saying whatever the first prompt said, forever.
179
+ const written = Promise.withResolvers<void>();
180
+ const off = onRealtimeSignal((event) => {
181
+ if (event.signal === 'sidebar-structure') written.resolve();
182
+ });
183
+ try {
184
+ notify(session, { sessionUpdate: 'session_info_update', title: 'Release train' });
185
+ await written.promise;
186
+ } finally {
187
+ off();
188
+ }
189
+
190
+ const [row] = await loadAcpSessions();
191
+ expect(row.title).toBe('Release train');
192
+ });
193
+ });
@@ -0,0 +1,33 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * How one ACP session is spawned.
8
+ *
9
+ * Its own module because the type is the transport's spawn contract, read by
10
+ * `AcpSession` and handed to it by both callers (`spawn.server.ts` for a chat,
11
+ * `acp-audit.server.ts` for a disposable reader); keeping it in `session.ts`
12
+ * made that file carry a second responsibility past its size ceiling.
13
+ */
14
+
15
+ import type { ApprovalMode } from '@/shared/lib/omp/config/access-mode';
16
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
17
+
18
+ export interface AcpSessionOptions {
19
+ harness: HarnessId;
20
+ command: string[];
21
+ env?: Record<string, string>;
22
+ /** Provider/model this session starts on, applied with
23
+ * `session/set_config_option` right after `session/new`. */
24
+ model?: { provider: string; modelId: string } | null;
25
+ thinkingLevel?: string | null;
26
+ mode?: string | null;
27
+ /** The composer's access pick. ACP has no spawn flag for it, so the session
28
+ * answers `session/request_permission` itself according to this tier. */
29
+ accessMode?: ApprovalMode | null;
30
+ /** Quiet window before the child is reclaimed; defaults to the omp window so
31
+ * both transports release an idle agent after the same time. */
32
+ idleDestroyMs?: number;
33
+ }
@@ -0,0 +1,105 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The access tier decides whether a permission request ever reaches the user.
8
+ *
9
+ * ACP has no `--approval-mode` flag: the CLIENT answers
10
+ * `session/request_permission`. That made the composer's access control inert
11
+ * on this transport (measured: "Full bypass" still raised the approval dialog
12
+ * for a bash call), and the tiers below are omp's own contract, so one label
13
+ * means one thing on both transports.
14
+ */
15
+
16
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
17
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
18
+ import { mountSession } from '@/server/lib/harness/acp/session.test-util';
19
+ import type { AcpSession } from '@/server/lib/harness/acp/session';
20
+ import type { AgentEvent } from '@/server/lib/omp/rpc/constants';
21
+
22
+ // A prompt reaches the title writer, which opens the database — isolate it.
23
+ beforeEach(async () => {
24
+ await isolateDb();
25
+ });
26
+
27
+ afterEach(async () => {
28
+ await releaseDb();
29
+ });
30
+
31
+ interface PermissionHost {
32
+ accessMode: string;
33
+ onClientRequest: (
34
+ id: number,
35
+ method: string,
36
+ params: Record<string, unknown>,
37
+ ) => Promise<unknown>;
38
+ }
39
+
40
+ const request = (kind: string): Record<string, unknown> => ({
41
+ sessionId: 'acp-1',
42
+ toolCall: { kind, title: `${kind} thing` },
43
+ options: [
44
+ { optionId: 'deny', kind: 'reject_once' },
45
+ { optionId: 'allow', kind: 'allow_once' },
46
+ ],
47
+ });
48
+
49
+ const permission = (session: AcpSession, id: number, kind: string): Promise<unknown> =>
50
+ (session as unknown as PermissionHost).onClientRequest(id, 'session/request_permission', request(kind));
51
+
52
+ const dialogs = (events: AgentEvent[]): number =>
53
+ events.filter((event) => event.type === 'extension_ui_request').length;
54
+
55
+ describe('ACP permission gating', () => {
56
+ test('`yolo` answers an exec request itself, with no dialog', async () => {
57
+ const { session, events } = mountSession();
58
+ (session as unknown as PermissionHost).accessMode = 'yolo';
59
+ expect(await permission(session, 7, 'execute')).toEqual({
60
+ answered: true,
61
+ result: { outcome: { outcome: 'selected', optionId: 'allow' } },
62
+ });
63
+ expect(dialogs(events)).toBe(0);
64
+ expect(session.isBusy()).toBe(false);
65
+ });
66
+
67
+ test('`always-ask` still parks an exec request as a dialog', async () => {
68
+ const { session, events } = mountSession();
69
+ expect(await permission(session, 8, 'execute')).toEqual({ answered: false, deferred: true });
70
+ expect(dialogs(events)).toBe(1);
71
+ expect(session.isBusy()).toBe(true);
72
+ });
73
+
74
+ test('`always-ask` auto-runs a read-tier request, as omp does', async () => {
75
+ const { session } = mountSession();
76
+ expect(await permission(session, 9, 'read')).toMatchObject({ answered: true });
77
+ });
78
+
79
+ test('`write` auto-runs edits and still asks for exec', async () => {
80
+ const { session } = mountSession();
81
+ (session as unknown as PermissionHost).accessMode = 'write';
82
+ expect(await permission(session, 10, 'edit')).toMatchObject({ answered: true });
83
+ expect(await permission(session, 11, 'execute')).toEqual({ answered: false, deferred: true });
84
+ });
85
+
86
+ test('a request with no allow option still reaches the user', async () => {
87
+ const { session, events } = mountSession();
88
+ (session as unknown as PermissionHost).accessMode = 'yolo';
89
+ const answer = await (session as unknown as PermissionHost).onClientRequest(12, 'session/request_permission', {
90
+ sessionId: 'acp-1',
91
+ toolCall: { kind: 'execute' },
92
+ options: [{ optionId: 'deny', kind: 'reject_once' }],
93
+ });
94
+ expect(answer).toEqual({ answered: false, deferred: true });
95
+ expect(dialogs(events)).toBe(1);
96
+ });
97
+
98
+ test('a prompt carrying the access pick adopts it before the turn', async () => {
99
+ const { session, turn } = mountSession();
100
+ await session.send({ type: 'prompt', message: 'hi', accessMode: 'yolo' });
101
+ await turn.started;
102
+ expect((session as unknown as PermissionHost).accessMode).toBe('yolo');
103
+ turn.finish({ stopReason: 'end_turn' });
104
+ });
105
+ });
@@ -0,0 +1,74 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The approval gate, split out of the session.
8
+ *
9
+ * `session/request_permission` BLOCKS the agent's turn until it is answered, so
10
+ * the session has exactly two obligations and they are the two functions here:
11
+ * answer a call the operator's tier already allows WITHOUT parking it, and answer
12
+ * every later dialog — a chosen option becomes `{outcome:"selected"}`, and an id
13
+ * nobody knows becomes `cancelled`. A silent return hangs the agent, which is the
14
+ * failure this module exists to make impossible.
15
+ */
16
+
17
+ import type { AgentEvent } from '@/server/lib/omp/rpc/constants';
18
+ import type { AcpId } from '@/server/lib/harness/acp/protocol';
19
+ import type { PendingPermissions } from '@/server/lib/harness/acp/permissions';
20
+ import type { ApprovalMode } from '@/shared/lib/omp/config/access-mode';
21
+ import { allowOption, autoApproval, type PermissionOption } from '@/server/lib/harness/acp/permissions';
22
+
23
+ /**
24
+ * The option id to select when the tier already allows this call, or null to
25
+ * park it as a dialog.
26
+ *
27
+ * Answered HERE, before a dialog exists: parking it would ask a question the
28
+ * operator's own selection already answered, and `isBusy()` would report a
29
+ * dialog nobody is meant to see.
30
+ */
31
+ export function preApprovedOption(
32
+ accessMode: ApprovalMode,
33
+ params: Record<string, unknown>,
34
+ ): string | null {
35
+ const toolCall = params.toolCall && typeof params.toolCall === 'object'
36
+ ? Object.fromEntries(Object.entries(params.toolCall))
37
+ : undefined;
38
+ if (!autoApproval(accessMode, toolCall)) return null;
39
+ const options = Array.isArray(params.options) ? (params.options as PermissionOption[]) : [];
40
+ return allowOption(options);
41
+ }
42
+
43
+ /** The slice of a session a permission request needs. */
44
+ export interface PermissionRequestHost {
45
+ readonly sessionId: string;
46
+ accessMode: ApprovalMode;
47
+ readonly permissions: PendingPermissions;
48
+ emit(event: AgentEvent): void;
49
+ }
50
+
51
+ export type PermissionRequestAnswer =
52
+ | { answered: true; result: unknown }
53
+ | { answered: false; deferred: true };
54
+
55
+ /**
56
+ * Answer one `session/request_permission`: a tier that already allows it is
57
+ * selected immediately, otherwise the call is parked and reported as a dialog
58
+ * whose id IS the JSON-RPC id (the answer arrives later and must name it).
59
+ */
60
+ export function answerPermissionRequest(
61
+ host: PermissionRequestHost,
62
+ id: AcpId,
63
+ params: Record<string, unknown>,
64
+ ): Promise<PermissionRequestAnswer> {
65
+ const optionId = preApprovedOption(host.accessMode, params);
66
+ if (optionId) {
67
+ return Promise.resolve({ answered: true, result: { outcome: { outcome: 'selected', optionId } } });
68
+ }
69
+ const dialog = host.permissions.add(id, String(params.sessionId ?? host.sessionId), params);
70
+ host.emit(dialog as unknown as AgentEvent);
71
+ // Answered LATER; the transport must not send a refusal now or the agent
72
+ // sees two answers to one request.
73
+ return Promise.resolve({ answered: false, deferred: true });
74
+ }
@@ -0,0 +1,96 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The ACP idle reclaim.
8
+ *
9
+ * `omp acp` children used to outlive the tab that spawned them by hours: unlike
10
+ * the omp wrapper, this transport had no idle clock, and nothing else ends a
11
+ * child it is not actively driving. These cases pin the two halves of the fix —
12
+ * the decision (never reclaim a working or dialog-blocked session) and the
13
+ * wiring (commands and frames defer the deadline; a destroy stops it).
14
+ */
15
+
16
+ import { describe, expect, test } from 'bun:test';
17
+
18
+ import { reclaimIdleAcpSession } from '@/server/lib/harness/acp/session-idle';
19
+ import { UNPROBED_CAPABILITIES } from '@/server/lib/harness/capabilities';
20
+ import { mountSession, notify } from '@/server/lib/harness/acp/session.test-util';
21
+
22
+ describe('ACP idle reclaim decision', () => {
23
+ const restorable = { ...UNPROBED_CAPABILITIES, loadSession: true };
24
+
25
+ test('an idle restorable session is destroyed', () => {
26
+ let destroyed = 0;
27
+ const reclaimed = reclaimIdleAcpSession({
28
+ harness: 'claude',
29
+ capabilities: { ...restorable },
30
+ isBusy: () => false,
31
+ destroy: () => { destroyed += 1; },
32
+ });
33
+ expect(reclaimed).toBe(true);
34
+ expect(destroyed).toBe(1);
35
+ });
36
+
37
+ test('a busy session survives and the clock re-arms instead', () => {
38
+ let destroyed = 0;
39
+ const reclaimed = reclaimIdleAcpSession({
40
+ harness: 'claude',
41
+ capabilities: { ...restorable },
42
+ isBusy: () => true,
43
+ destroy: () => { destroyed += 1; },
44
+ });
45
+ // `false` is what makes `IdleReaper` re-arm from now: answering `true`
46
+ // would let it fire again on an unchanged session.
47
+ expect(reclaimed).toBe(false);
48
+ expect(destroyed).toBe(0);
49
+ });
50
+
51
+ test('an idle session whose agent cannot session/load is left alive', () => {
52
+ // There is no way back: `resumeRecordedHarnessSession` refuses to spawn a
53
+ // fresh agent under the chat's id, so reclaiming would strand the chat.
54
+ let destroyed = 0;
55
+ reclaimIdleAcpSession({
56
+ harness: 'dsh',
57
+ capabilities: { ...UNPROBED_CAPABILITIES, loadSession: false },
58
+ isBusy: () => false,
59
+ destroy: () => { destroyed += 1; },
60
+ });
61
+ expect(destroyed).toBe(0);
62
+ });
63
+
64
+ test('omp-acp is reclaimed even without loadSession, because its session file restores it', () => {
65
+ let destroyed = 0;
66
+ reclaimIdleAcpSession({
67
+ harness: 'omp-acp',
68
+ capabilities: { ...UNPROBED_CAPABILITIES, loadSession: false },
69
+ isBusy: () => false,
70
+ destroy: () => { destroyed += 1; },
71
+ });
72
+ expect(destroyed).toBe(1);
73
+ });
74
+ });
75
+
76
+ describe('ACP idle reclaim wiring', () => {
77
+ test('a dispatched command defers the deadline', async () => {
78
+ const { session, turn, idleResets } = mountSession();
79
+ expect(idleResets()).toBe(0);
80
+ await session.send({ type: 'get_state' });
81
+ expect(idleResets()).toBe(1);
82
+ turn.finish({ stopReason: 'end_turn' });
83
+ });
84
+
85
+ test('a frame defers the deadline', () => {
86
+ const { session, idleResets } = mountSession();
87
+ notify(session, { sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: 'hi' } });
88
+ expect(idleResets()).toBe(1);
89
+ });
90
+
91
+ test('destroy stops the clock', async () => {
92
+ const { session, idleStopped } = mountSession();
93
+ await session.destroyAndWait();
94
+ expect(idleStopped()).toBe(true);
95
+ });
96
+ });