@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
@@ -7,6 +7,7 @@ import { useEffect, useRef, useState } from 'preact/hooks';
7
7
  import { Suspense, lazy } from 'preact/compat';
8
8
  import { useSearchParams } from '@/client/lib/router/search-params';
9
9
  import { DesktopLayout } from '@/client/components/layout/desktop-layout/index';
10
+ import { ToastStack } from '@/client/components/common/ToastStack';
10
11
  import { SessionStateProvider } from '@/client/components/common/session-state-provider';
11
12
  import { LoginScreen } from '@/client/components/auth/login-screen';
12
13
  import { useAuthState } from '@/client/hooks/ui/auth';
@@ -111,29 +112,29 @@ export function App({ initialIsMobile = false, production = false, appSettings =
111
112
  // stream requests that can only come back 401.
112
113
  if (authState === 'required') return <LoginScreen />;
113
114
 
114
- if (isMobileMode) {
115
- return (
116
- <SessionStateProvider sessionId={sessionId}>
117
- <SidebarDataProvider>
118
- <Suspense fallback={null}>
119
- <MobileLayoutWrapper
120
- onDesktopToggle={production ? undefined : handleSwitchToDesktop}
121
- appSettings={appSettings}
122
- />
123
- </Suspense>
124
- </SidebarDataProvider>
125
- </SessionStateProvider>
126
- );
127
- }
115
+ // The toast host is mounted HERE, once, outside the layout switch: the queue
116
+ // is page state (see `hooks/ui/toasts`), so a layout change must not drop a
117
+ // message that is still on screen, and no surface may draw a second copy.
118
+ const shell = isMobileMode ? (
119
+ <Suspense fallback={null}>
120
+ <MobileLayoutWrapper
121
+ onDesktopToggle={production ? undefined : handleSwitchToDesktop}
122
+ appSettings={appSettings}
123
+ />
124
+ </Suspense>
125
+ ) : (
126
+ <DesktopLayout
127
+ sessionId={sessionId}
128
+ onSwitchToMobile={production ? undefined : handleSwitchToMobile}
129
+ appSettings={appSettings}
130
+ />
131
+ );
128
132
 
129
133
  return (
130
134
  <SessionStateProvider sessionId={sessionId}>
131
135
  <SidebarDataProvider>
132
- <DesktopLayout
133
- sessionId={sessionId}
134
- onSwitchToMobile={production ? undefined : handleSwitchToMobile}
135
- appSettings={appSettings}
136
- />
136
+ {shell}
137
+ <ToastStack />
137
138
  </SidebarDataProvider>
138
139
  </SessionStateProvider>
139
140
  );
@@ -18,6 +18,13 @@ export interface ComposerTextareaProps {
18
18
  className?: string;
19
19
  onPaste?: (e: ClipboardEvent<HTMLTextAreaElement>) => void;
20
20
  rootPath?: string | null;
21
+ /** The open chat: `/` asks its own agent for the command list. */
22
+ sessionId?: string | null;
23
+ /**
24
+ * The harness behind the open chat. A non-omp ACP agent has no omp
25
+ * subagents, so the `@` pool drops those rows there; files stay.
26
+ */
27
+ harness?: string | null;
21
28
  /**
22
29
  * Whether the `@` / `/` / `!` / `#` autocomplete runs. Off for a composer with
23
30
  * nothing to complete against — the side-question form has no file tree, no
@@ -72,6 +79,8 @@ export function ComposerTextarea({
72
79
  className,
73
80
  onPaste,
74
81
  rootPath,
82
+ sessionId,
83
+ harness,
75
84
  enablePicker = true,
76
85
  placement = 'up',
77
86
  wrapperClassName = '',
@@ -89,7 +98,7 @@ export function ComposerTextarea({
89
98
  if (externalRef) externalRef.current = node;
90
99
  onReady?.(node);
91
100
  };
92
- const composer = useComposerTrigger({ value, setValue: onChange, textareaRef, disabled, rootPath, enabled: enablePicker });
101
+ const composer = useComposerTrigger({ value, setValue: onChange, textareaRef, disabled, rootPath, sessionId, harness, enabled: enablePicker });
93
102
 
94
103
  useOnClickOutside(wrapperRef, composer.close);
95
104
 
@@ -2,6 +2,7 @@ import { useId, useRef } from 'preact/hooks';
2
2
  import type { FormEvent, ReactNode } from 'preact/compat';
3
3
  import { X } from 'lucide-preact';
4
4
  import { useDialogBehaviour } from '@/client/hooks/ui/dialog-behaviour';
5
+ import { safeAreaPadding } from '@/shared/lib/ui/safe-area';
5
6
 
6
7
  export interface ModalProps {
7
8
  /** Backdrop click / close-button handler. */
@@ -60,12 +61,7 @@ export function Modal({
60
61
  return (
61
62
  <div
62
63
  className={`fixed inset-0 modal-scrim backdrop-blur-[2px] ${zClass} flex items-center justify-center p-4`}
63
- style={{
64
- paddingTop: 'max(1rem, env(safe-area-inset-top, 0px))',
65
- paddingBottom: 'max(1rem, env(safe-area-inset-bottom, 0px))',
66
- paddingLeft: 'max(1rem, env(safe-area-inset-left, 0px))',
67
- paddingRight: 'max(1rem, env(safe-area-inset-right, 0px))',
68
- }}
64
+ style={safeAreaPadding(1)}
69
65
  onClick={onClose}
70
66
  >
71
67
  {/* `role="dialog"` + `aria-modal`: every modal built on this shell (the
@@ -1,6 +1,7 @@
1
1
  import { useEffect, useState } from 'preact/hooks';
2
2
  import type { FunctionComponent } from 'preact/compat';
3
3
  import { Download } from 'lucide-preact';
4
+ import { CONTROL_BOX } from '@/client/lib/ui/control-plate';
4
5
 
5
6
  interface BeforeInstallPromptEvent extends Event {
6
7
  prompt: () => Promise<void>;
@@ -70,7 +71,7 @@ export const PWAInstallButton: FunctionComponent = () => {
70
71
  return (
71
72
  <button
72
73
  onClick={install}
73
- className="p-1.5 rounded hover:bg-ink/10 transition-colors text-ink/60 hover:text-ink"
74
+ className={`${CONTROL_BOX.desktop} hover:bg-ink/10 transition-colors text-ink/60 hover:text-ink`}
74
75
  title="Install Kabmo"
75
76
  >
76
77
  <Download size={16} />
@@ -83,7 +84,7 @@ export const PWAInstallButton: FunctionComponent = () => {
83
84
  <>
84
85
  <button
85
86
  onClick={() => setShowIOSGuide(true)}
86
- className="p-1.5 rounded hover:bg-ink/10 transition-colors text-ink/60 hover:text-ink"
87
+ className={`${CONTROL_BOX.desktop} hover:bg-ink/10 transition-colors text-ink/60 hover:text-ink`}
87
88
  title="Install on iOS"
88
89
  >
89
90
  <Download size={16} />
@@ -0,0 +1,298 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The toast card's own lifecycle, and the one host that draws it.
8
+ *
9
+ * The bugs these cases pin, each one visible in the previous component:
10
+ *
11
+ * - **The countdown restarted on every parent render.** The old `useEffect`
12
+ * listed `onDismiss` in its deps, and `dismissToast` was a fresh closure per
13
+ * render of `useToasts` — so a chat re-rendering on every streamed frame kept
14
+ * its toast on screen indefinitely. The card reads a duration fixed at push
15
+ * time and a stable module `onDismiss`.
16
+ * - **The card vanished under the pointer.** Hovering or focusing it now pauses
17
+ * the countdown, and leaving resumes the exact remainder.
18
+ * - **Two live toasts were painted in the same place.** Each card used to be its
19
+ * own `fixed bottom-4 right-4` portal; the stack is one column, so a second
20
+ * card pushes the first up instead of covering it.
21
+ * - **An error drew a check mark.** The tone picks both the icon and the live
22
+ * region — `alert` for a failure.
23
+ */
24
+
25
+ import { afterAll, afterEach, beforeAll, describe, expect, jest, test } from 'bun:test';
26
+ import { Window } from 'happy-dom';
27
+ import { h, render } from 'preact';
28
+ import { act } from 'preact/test-utils';
29
+ import { Toast } from '@/client/components/common/Toast';
30
+ import { ToastStack } from '@/client/components/common/ToastStack';
31
+ import { pushToast, resetToasts } from '@/client/hooks/ui/toasts';
32
+ import { TOAST_EXIT_MS } from '@/shared/lib/ui/toast-duration';
33
+ import { installDomGlobals, restoreDomGlobals } from '@/test-support/pristine-globals';
34
+
35
+ let container: HTMLElement;
36
+ let win: Window;
37
+
38
+ beforeAll(() => {
39
+ win = new Window({ url: 'http://localhost' });
40
+ installDomGlobals(win);
41
+ });
42
+
43
+ afterEach(() => {
44
+ if (container) {
45
+ render(null, container);
46
+ container.remove();
47
+ }
48
+ // Toasts portal into `document.body`, and the queue is module state that
49
+ // outlives the render, so both are cleared between cases.
50
+ document.body.replaceChildren();
51
+ resetToasts();
52
+ jest.useRealTimers();
53
+ });
54
+
55
+ afterAll(() => {
56
+ restoreDomGlobals();
57
+ });
58
+
59
+ function mount(node: h.JSX.Element): HTMLElement {
60
+ container = document.createElement('div');
61
+ document.body.append(container);
62
+ act(() => render(node, container));
63
+ return container;
64
+ }
65
+
66
+ /** Flush the enter frame and any queued microtasks without a real clock. */
67
+ async function settle(): Promise<void> {
68
+ await act(async () => {});
69
+ }
70
+
71
+ function advance(ms: number): void {
72
+ act(() => {
73
+ jest.advanceTimersByTime(ms);
74
+ });
75
+ }
76
+
77
+ /** The rendered card, wherever the portal put it. */
78
+ function card(): HTMLElement {
79
+ const found = document.querySelector<HTMLElement>('[role="status"], [role="alert"]');
80
+ if (!found) throw new Error('no toast card rendered');
81
+ return found;
82
+ }
83
+
84
+ function mountCard(duration: number | null, onDismiss: (id: number) => void = () => {}) {
85
+ return mount(
86
+ h(Toast, {
87
+ toast: { id: 7, message: 'Synced with upstream', type: 'success', duration },
88
+ onDismiss,
89
+ }),
90
+ );
91
+ }
92
+
93
+ describe('Toast', () => {
94
+ test('dismisses itself after exactly the duration it was given', async () => {
95
+ jest.useFakeTimers();
96
+ const dismissed: number[] = [];
97
+ mountCard(1000, (id) => dismissed.push(id));
98
+ await settle();
99
+
100
+ advance(999);
101
+ expect(dismissed).toEqual([]);
102
+
103
+ advance(1);
104
+ // The exit transition still has to play before the row is removed.
105
+ expect(dismissed).toEqual([]);
106
+ advance(TOAST_EXIT_MS);
107
+ expect(dismissed).toEqual([7]);
108
+ });
109
+
110
+ test('a null duration never fires on its own', async () => {
111
+ jest.useFakeTimers();
112
+ const dismissed: number[] = [];
113
+ mountCard(null, (id) => dismissed.push(id));
114
+ await settle();
115
+
116
+ advance(120_000);
117
+ expect(dismissed).toEqual([]);
118
+ });
119
+
120
+ test('hovering pauses the countdown and leaving resumes the remainder', async () => {
121
+ jest.useFakeTimers();
122
+ const dismissed: number[] = [];
123
+ mountCard(1000, (id) => dismissed.push(id));
124
+ await settle();
125
+
126
+ advance(400);
127
+ act(() => {
128
+ card().dispatchEvent(new win.PointerEvent('pointerenter') as unknown as Event);
129
+ });
130
+
131
+ // Ten seconds of hovering is not ten seconds off the clock.
132
+ advance(10_000);
133
+ expect(dismissed).toEqual([]);
134
+
135
+ act(() => {
136
+ card().dispatchEvent(new win.PointerEvent('pointerleave') as unknown as Event);
137
+ });
138
+ advance(599);
139
+ expect(dismissed).toEqual([]);
140
+ advance(1);
141
+ // The exit transition is its own timer, scheduled now — a single advance that
142
+ // covers both would miss it, because it is created after the window closed.
143
+ advance(TOAST_EXIT_MS);
144
+ expect(dismissed).toEqual([7]);
145
+ });
146
+
147
+ test('focus inside the card pauses, and focus leaving it resumes', async () => {
148
+ jest.useFakeTimers();
149
+ const dismissed: number[] = [];
150
+ mount(
151
+ h(Toast, {
152
+ toast: {
153
+ id: 8,
154
+ message: 'Stopped.',
155
+ type: 'success',
156
+ duration: 1000,
157
+ action: { label: 'Send now', onClick: () => {} },
158
+ },
159
+ onDismiss: (id) => dismissed.push(id),
160
+ }),
161
+ );
162
+ await settle();
163
+
164
+ act(() => {
165
+ card().dispatchEvent(new win.FocusEvent('focus') as unknown as Event);
166
+ });
167
+ advance(30_000);
168
+ expect(dismissed).toEqual([]);
169
+
170
+ act(() => {
171
+ card().dispatchEvent(new win.FocusEvent('blur') as unknown as Event);
172
+ });
173
+ advance(1000);
174
+ advance(TOAST_EXIT_MS);
175
+ expect(dismissed).toEqual([8]);
176
+ });
177
+
178
+ test('the close button dismisses without waiting for the timer', async () => {
179
+ jest.useFakeTimers();
180
+ const dismissed: number[] = [];
181
+ mountCard(60_000, (id) => dismissed.push(id));
182
+ await settle();
183
+
184
+ const close = card().querySelector<HTMLButtonElement>('button[aria-label="Dismiss notification"]');
185
+ if (!close) throw new Error('no close control');
186
+ act(() => close.click());
187
+ advance(TOAST_EXIT_MS);
188
+ expect(dismissed).toEqual([7]);
189
+ });
190
+
191
+ test('an action button runs its handler and then closes the card', async () => {
192
+ jest.useFakeTimers();
193
+ let ran = 0;
194
+ const dismissed: number[] = [];
195
+ mount(
196
+ h(Toast, {
197
+ toast: {
198
+ id: 9,
199
+ message: 'Stopped. 2 messages still queued.',
200
+ type: 'success',
201
+ duration: null,
202
+ action: { label: 'Send now', onClick: () => { ran += 1; } },
203
+ },
204
+ onDismiss: (id) => dismissed.push(id),
205
+ }),
206
+ );
207
+ await settle();
208
+
209
+ const action = [...card().querySelectorAll('button')].find((node) => node.textContent === 'Send now');
210
+ if (!action) throw new Error('no action button');
211
+ act(() => action.click());
212
+ expect(ran).toBe(1);
213
+ advance(TOAST_EXIT_MS);
214
+ expect(dismissed).toEqual([9]);
215
+ });
216
+
217
+ test('a parent re-render does not restart the countdown', async () => {
218
+ jest.useFakeTimers();
219
+ const dismissed: number[] = [];
220
+ const toast = { id: 11, message: 'Streaming chat toast', type: 'error' as const, duration: 1000 };
221
+ // The old card listed `onDismiss` in its effect deps, and every host passed
222
+ // a fresh closure — so a chat re-rendering per streamed frame pushed the
223
+ // deadline out on each frame. A new callback identity mid-count is exactly
224
+ // that shape; it must not buy the card more time.
225
+ const Host = ({ tick }: { tick: number }) =>
226
+ h('span', null, String(tick), h(Toast, { toast, onDismiss: (id) => dismissed.push(id) }));
227
+ const rerender = (tick: number) => {
228
+ act(() => render(h(Host, { tick }), container));
229
+ };
230
+
231
+ container = document.createElement('div');
232
+ document.body.append(container);
233
+ rerender(0);
234
+ await settle();
235
+
236
+ advance(400);
237
+ rerender(1);
238
+ advance(400);
239
+ rerender(2);
240
+ expect(dismissed).toEqual([]);
241
+
242
+ advance(200);
243
+ advance(TOAST_EXIT_MS);
244
+ expect(dismissed).toEqual([11]);
245
+ });
246
+
247
+ test('a failure is an alert, a confirmation is a status', async () => {
248
+ mountCard(3000);
249
+ expect(card().getAttribute('role')).toBe('status');
250
+ expect(card().getAttribute('aria-live')).toBe('polite');
251
+
252
+ render(null, container);
253
+ document.body.replaceChildren();
254
+ mount(
255
+ h(Toast, {
256
+ toast: { id: 2, message: 'Save failed', type: 'error', duration: 5000 },
257
+ onDismiss: () => {},
258
+ }),
259
+ );
260
+ expect(card().getAttribute('role')).toBe('alert');
261
+ expect(card().getAttribute('aria-live')).toBe('assertive');
262
+ });
263
+ });
264
+
265
+ describe('ToastStack', () => {
266
+ test('draws nothing until there is something to say', () => {
267
+ mount(h(ToastStack, {}));
268
+ expect(document.querySelector('[data-toast-stack]')).toBeNull();
269
+ });
270
+
271
+ test('a second toast stacks beside the first instead of covering it', async () => {
272
+ mount(h(ToastStack, {}));
273
+ act(() => {
274
+ pushToast('first', 'success');
275
+ pushToast('second', 'error');
276
+ });
277
+ await settle();
278
+
279
+ const cards = [...document.querySelectorAll('[data-toast-stack] > div')];
280
+ expect(cards).toHaveLength(2);
281
+ expect(cards[0]?.textContent).toContain('first');
282
+ expect(cards[1]?.textContent).toContain('second');
283
+ });
284
+
285
+ test('the host follows the queue as toasts come and go', async () => {
286
+ jest.useFakeTimers();
287
+ mount(h(ToastStack, {}));
288
+ act(() => pushToast('only one', 'success'));
289
+ await settle();
290
+ expect(document.querySelectorAll('[data-toast-stack] > div')).toHaveLength(1);
291
+
292
+ const close = document.querySelector<HTMLButtonElement>('[data-toast-stack] button[aria-label="Dismiss notification"]');
293
+ if (!close) throw new Error('no close control');
294
+ act(() => close.click());
295
+ advance(TOAST_EXIT_MS);
296
+ expect(document.querySelectorAll('[data-toast-stack] > div')).toHaveLength(0);
297
+ });
298
+ });
@@ -1,79 +1,145 @@
1
- import { useEffect, useRef, useState } from 'preact/hooks';
2
- import { createPortal } from 'preact/compat';
1
+ import { useCallback, useEffect, useRef, useState } from 'preact/hooks';
3
2
  import { AlertCircle, CheckCircle2, X } from 'lucide-preact';
3
+ import { TOAST_EXIT_MS } from '@/shared/lib/ui/toast-duration';
4
+ import type { ToastTone } from '@/shared/lib/ui/toast-duration';
4
5
 
5
6
  export interface ToastData {
6
7
  id: number;
7
8
  message: string;
8
- type: 'success' | 'error';
9
+ type: ToastTone;
9
10
  /** Optional action button (e.g. "Send now") shown beside the message. */
10
11
  action?: { label: string; onClick: () => void };
11
- /** Override the auto-dismiss duration (ms). */
12
- duration?: number;
12
+ /**
13
+ * Auto-dismiss delay in ms, resolved by the queue at push time. `null` means
14
+ * the card waits for a dismissal — a toast with an action, or an explicit
15
+ * override from a caller that wants the user to decide.
16
+ */
17
+ duration: number | null;
13
18
  }
14
19
 
15
20
  interface ToastProps {
16
21
  toast: ToastData;
17
22
  onDismiss: (id: number) => void;
18
- duration?: number;
19
23
  }
20
24
 
21
- export function Toast({ toast, onDismiss, duration: durationProp }: ToastProps) {
22
- const [visible, setVisible] = useState(false);
23
- const duration = durationProp ?? toast.duration ?? 4000;
24
- const dismissTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
25
+ /**
26
+ * One toast card. The container and the stacking order live in `ToastStack`;
27
+ * this owns the card's own lifecycle.
28
+ *
29
+ * ## The timer pauses while the pointer or the keyboard is on the card
30
+ *
31
+ * A message that vanishes under the cursor is unreadable. `pointerenter` and
32
+ * focus freeze the countdown, and leaving resumes it from exactly where it
33
+ * stopped — the remaining time is kept as a number, not recomputed from a
34
+ * start time, so any number of pauses is exact.
35
+ *
36
+ * ## The timer is what dismisses, not a mount-time `setTimeout`
37
+ *
38
+ * The card reads no parent render state: `duration` is fixed on the toast when
39
+ * it is pushed and `onDismiss` is a stable module function, so a parent that
40
+ * re-renders (the chat timeline does, on every streamed frame) cannot restart
41
+ * the countdown and keep a toast on screen indefinitely.
42
+ */
43
+ export function Toast({ toast, onDismiss }: ToastProps) {
44
+ const [entered, setEntered] = useState(false);
45
+ const [leaving, setLeaving] = useState(false);
46
+ const [paused, setPaused] = useState(false);
47
+
48
+ const duration = toast.duration;
49
+ /** What is left of the countdown, in ms; `null` while the timer is running. */
50
+ const remainingRef = useRef<number>(duration ?? 0);
51
+ const startedAtRef = useRef<number | null>(null);
52
+ const dismissRef = useRef(onDismiss);
53
+ dismissRef.current = onDismiss;
54
+
55
+ // The enter frame and the exit deadline are independent of each other: one
56
+ // runs once, the other once per pause/resume cycle.
57
+ useEffect(() => {
58
+ const frame = requestAnimationFrame(() => setEntered(true));
59
+ return () => cancelAnimationFrame(frame);
60
+ }, []);
25
61
 
26
62
  useEffect(() => {
27
- const raf = requestAnimationFrame(() => setVisible(true));
28
- const timer = setTimeout(() => {
29
- setVisible(false);
30
- dismissTimerRef.current = setTimeout(() => onDismiss(toast.id), 200);
31
- }, duration);
63
+ if (duration === null) return;
64
+ if (paused) {
65
+ if (startedAtRef.current !== null) {
66
+ remainingRef.current = Math.max(0, remainingRef.current - (Date.now() - startedAtRef.current));
67
+ startedAtRef.current = null;
68
+ }
69
+ return;
70
+ }
71
+ startedAtRef.current = Date.now();
72
+ const timer = setTimeout(() => setLeaving(true), remainingRef.current);
32
73
  return () => {
33
- cancelAnimationFrame(raf);
34
74
  clearTimeout(timer);
35
- if (dismissTimerRef.current) clearTimeout(dismissTimerRef.current);
75
+ if (startedAtRef.current !== null) {
76
+ remainingRef.current = Math.max(0, remainingRef.current - (Date.now() - startedAtRef.current));
77
+ startedAtRef.current = null;
78
+ }
36
79
  };
37
- }, [toast.id, duration, onDismiss]);
80
+ }, [duration, paused]);
81
+
82
+ useEffect(() => {
83
+ if (!leaving) return;
84
+ const timer = setTimeout(() => dismissRef.current(toast.id), TOAST_EXIT_MS);
85
+ return () => clearTimeout(timer);
86
+ }, [leaving, toast.id]);
87
+
88
+ const close = useCallback(() => setLeaving(true), []);
89
+
90
+ const hold = useCallback(() => setPaused(true), []);
91
+ const release = useCallback(() => setPaused(false), []);
38
92
 
39
- return createPortal(
93
+ const isError = toast.type === 'error';
94
+ return (
40
95
  <div
41
- className={`fixed bottom-4 right-4 z-[200] flex items-center space-x-2 bg-paper border shadow-2xl rounded-lg px-4 py-3 text-xs font-sans transition-all duration-200 ${
42
- toast.type === 'error' ? 'border-error/40' : 'border-ink/15'
43
- } ${visible ? 'opacity-100 translate-y-0' : 'opacity-0 translate-y-2'}`}
44
- role="status"
96
+ role={isError ? 'alert' : 'status'}
97
+ aria-live={isError ? 'assertive' : 'polite'}
98
+ onPointerEnter={hold}
99
+ onPointerLeave={release}
100
+ onFocus={hold}
101
+ onBlur={(event) => {
102
+ // Focus moving BETWEEN the card's own controls (the action button, the
103
+ // close button) is not the reader leaving; only focus landing outside
104
+ // resumes the countdown.
105
+ const next = event.relatedTarget;
106
+ if (next instanceof Node && event.currentTarget.contains(next)) return;
107
+ release();
108
+ }}
109
+ className={`pointer-events-auto flex items-start gap-2 rounded-lg border bg-paper px-3.5 py-2.5 text-xs font-sans shadow-xl transition-all ${
110
+ isError ? 'border-error/40' : 'border-ink/15'
111
+ } ${entered && !leaving ? 'opacity-100 translate-y-0' : 'opacity-0 translate-y-2'}`}
112
+ style={{ transitionDuration: `${TOAST_EXIT_MS}ms` }}
45
113
  >
46
- {toast.type === 'error' ? (
47
- <AlertCircle size={15} className="text-error flex-shrink-0" />
114
+ {isError ? (
115
+ <AlertCircle size={15} className="mt-px text-error flex-shrink-0" />
48
116
  ) : (
49
- <CheckCircle2 size={15} className="text-success flex-shrink-0" />
117
+ <CheckCircle2 size={15} className="mt-0.5 text-success flex-shrink-0" />
50
118
  )}
51
- <span className="text-ink max-w-[320px]">{toast.message}</span>
119
+ <span className="min-w-0 flex-1 whitespace-pre-line break-words leading-relaxed text-ink">
120
+ {toast.message}
121
+ </span>
52
122
  {toast.action && (
53
123
  <button
54
124
  type="button"
55
125
  onClick={() => {
56
126
  toast.action?.onClick();
57
- setVisible(false);
58
- dismissTimerRef.current = setTimeout(() => onDismiss(toast.id), 200);
127
+ close();
59
128
  }}
60
- className="flex-shrink-0 px-2 py-0.5 rounded bg-ink text-paper font-semibold hover:opacity-80 transition-opacity"
129
+ className="flex-shrink-0 rounded bg-ink px-2 py-0.5 text-[11px] font-semibold text-paper transition-opacity hover:opacity-80"
61
130
  >
62
131
  {toast.action.label}
63
132
  </button>
64
133
  )}
65
134
  <button
66
135
  type="button"
67
- onClick={() => {
68
- setVisible(false);
69
- dismissTimerRef.current = setTimeout(() => onDismiss(toast.id), 200);
70
- }}
71
- className="text-ink/40 hover:text-ink transition-colors flex-shrink-0"
136
+ onClick={close}
137
+ className="flex-shrink-0 text-ink/40 transition-colors hover:text-ink"
72
138
  title="Dismiss"
139
+ aria-label="Dismiss notification"
73
140
  >
74
141
  <X size={13} />
75
142
  </button>
76
- </div>,
77
- document.body
143
+ </div>
78
144
  );
79
145
  }
@@ -1,18 +1,39 @@
1
- import type { ToastData } from '@/client/components/common/Toast';
1
+ import { createPortal } from 'preact/compat';
2
2
  import { Toast } from '@/client/components/common/Toast';
3
+ import { dismissToast, useToastQueue } from '@/client/hooks/ui/toasts';
3
4
 
4
- interface ToastStackProps {
5
- toasts: ToastData[];
6
- onDismiss: (id: number) => void;
7
- }
5
+ /**
6
+ * The page's ONLY toast host, mounted once by `App`.
7
+ *
8
+ * ## One portal, one corner, one column
9
+ *
10
+ * Every card used to be its own `fixed bottom-4 right-4` portal, so two live
11
+ * toasts printed on top of each other and the newest was unreadable behind the
12
+ * older one. The stack is now a single flex column pinned to the corner: the
13
+ * cards lay out in DOM order, the oldest first, and a new card pushes the others
14
+ * up instead of covering them.
15
+ *
16
+ * It is portalled to `document.body` for the reason every overlay here is: a
17
+ * `fixed` descendant of a `backdrop-filter`/`transform` ancestor is sized to
18
+ * that ancestor, and the composer's glass card is exactly that.
19
+ *
20
+ * The queue is global (see `hooks/ui/toasts`), so a second mount would draw the
21
+ * same list twice — a host that is a settings pane, a panel or a phone drawer
22
+ * would. Only `App` mounts it.
23
+ */
24
+ export function ToastStack() {
25
+ const toasts = useToastQueue();
26
+ if (toasts.length === 0) return null;
8
27
 
9
- /** Renders the active toast queue — one portal-mounted Toast per entry. */
10
- export function ToastStack({ toasts, onDismiss }: ToastStackProps) {
11
- return (
12
- <>
13
- {toasts.map(t => (
14
- <Toast key={t.id} toast={t} onDismiss={onDismiss} />
28
+ return createPortal(
29
+ <div
30
+ className="pointer-events-none fixed bottom-4 right-4 z-[200] flex w-[360px] max-w-[calc(100vw-2rem)] flex-col items-stretch gap-2"
31
+ data-toast-stack=""
32
+ >
33
+ {toasts.map((toast) => (
34
+ <Toast key={toast.id} toast={toast} onDismiss={dismissToast} />
15
35
  ))}
16
- </>
36
+ </div>,
37
+ document.body,
17
38
  );
18
39
  }