@kabmo-labs/kabmo 0.17.0 → 0.19.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 (438) hide show
  1. package/README.md +10 -7
  2. package/dist/client/index.html +1 -1
  3. package/dist/client/index.js +523 -441
  4. package/dist/client/static/js/{index-rerjq5th.js → index-fcee4c13.js} +828 -818
  5. package/dist/client/static/js/index-sxdw908m.css +1 -0
  6. package/marketplace/plugins/command-runner/package.json +3 -2
  7. package/marketplace/plugins/git-forge/package.json +3 -2
  8. package/marketplace/plugins/session-info/package.json +3 -2
  9. package/marketplace/plugins/stats/package.json +3 -2
  10. package/package.json +3 -1
  11. package/src/client/components/auth/login-screen/index.tsx +2 -1
  12. package/src/client/components/common/ComposerPicker.tsx +1 -1
  13. package/src/client/components/common/FolderPicker.tsx +2 -2
  14. package/src/client/components/common/MarkdownRenderer.tsx +136 -89
  15. package/src/client/components/common/Modal.tsx +2 -2
  16. package/src/client/components/common/PWAInstallButton.tsx +2 -2
  17. package/src/client/components/common/ViewportSelector.tsx +1 -1
  18. package/src/client/components/common/anchored-menu/index.test.tsx +141 -0
  19. package/src/client/components/common/anchored-menu/index.tsx +147 -0
  20. package/src/client/components/common/batch-selection/SelectionCheckbox.tsx +2 -1
  21. package/src/client/components/common/brand-wordmark/index.test.tsx +13 -2
  22. package/src/client/components/common/brand-wordmark/index.tsx +13 -2
  23. package/src/client/components/common/checkbox/style.test.ts +139 -0
  24. package/src/client/components/common/checkbox/style.ts +51 -0
  25. package/src/client/components/common/context-usage-button/index.tsx +2 -2
  26. package/src/client/components/common/file-icon/index.tsx +23 -9
  27. package/src/client/components/common/header-controls/MoreMenu.tsx +1 -1
  28. package/src/client/components/common/markdown-review/ReviewPopover.tsx +144 -0
  29. package/src/client/components/common/markdown-review/ReviewSummary.tsx +108 -0
  30. package/src/client/components/common/markdown-review/index.tsx +129 -0
  31. package/src/client/components/common/panel-mark/index.tsx +97 -0
  32. package/src/client/components/common/provider-icon/glyphs.test.ts +1 -1
  33. package/src/client/components/common/provider-icon/index.test.ts +14 -0
  34. package/src/client/components/common/provider-icon/index.tsx +4 -0
  35. package/src/client/components/common/provider-icon/resolve.test.ts +8 -7
  36. package/src/client/components/common/provider-icon/resolve.ts +16 -3
  37. package/src/client/components/common/server-control/Panel.tsx +33 -23
  38. package/src/client/components/common/server-control/index.test.tsx +11 -5
  39. package/src/client/components/common/server-control/index.tsx +10 -8
  40. package/src/client/components/common/session-actions-menu/index.tsx +1 -1
  41. package/src/client/components/common/toolbar-row/index.tsx +1 -1
  42. package/src/client/components/layout/ActivityBar.tsx +22 -3
  43. package/src/client/components/layout/LeftDock.tsx +9 -2
  44. package/src/client/components/layout/PanelVisibilityMenu.tsx +1 -1
  45. package/src/client/components/layout/WindowAura.tsx +27 -0
  46. package/src/client/components/layout/desktop-layout/LeftColumn.tsx +1 -1
  47. package/src/client/components/layout/desktop-layout/TopNavbar.tsx +2 -2
  48. package/src/client/components/layout/desktop-layout/WorkspacePanels.tsx +11 -2
  49. package/src/client/components/layout/desktop-layout/index.tsx +3 -1
  50. package/src/client/components/layout/session-sidebar/CategoryHeader.tsx +44 -23
  51. package/src/client/components/layout/session-sidebar/CategoryHeader.worktree.test.tsx +36 -17
  52. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +8 -7
  53. package/src/client/components/layout/session-sidebar/Header.tsx +1 -1
  54. package/src/client/components/layout/session-sidebar/OverflowMenu.tsx +1 -1
  55. package/src/client/components/layout/session-sidebar/Toolbar.tsx +1 -1
  56. package/src/client/components/layout/session-sidebar/about-modal/NotesDialog.tsx +94 -0
  57. package/src/client/components/layout/session-sidebar/about-modal/VersionLine.test.tsx +68 -0
  58. package/src/client/components/layout/session-sidebar/about-modal/VersionLine.tsx +36 -0
  59. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +57 -34
  60. package/src/client/components/layout/session-sidebar/modern/ActionRow.tsx +1 -1
  61. package/src/client/components/layout/session-sidebar/modern/WorkspaceHeader.tsx +40 -14
  62. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +7 -6
  63. package/src/client/components/layout/session-sidebar/modern/workspace-header.test.tsx +1 -1
  64. package/src/client/components/layout/session-sidebar/new-workspace-modal/index.tsx +2 -2
  65. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskForm.tsx +2 -1
  66. package/src/client/components/layout/session-sidebar/scheduler-modal/index.tsx +2 -2
  67. package/src/client/components/layout/update-popup/ReleaseNotes.tsx +8 -3
  68. package/src/client/components/layout/update-popup/index.tsx +5 -1
  69. package/src/client/components/mobile/LayoutWrapper.tsx +3 -1
  70. package/src/client/components/mobile/mobile-main-view/Header.tsx +2 -2
  71. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +13 -15
  72. package/src/client/components/mobile/mobile-right-sidebar/Header.tsx +23 -1
  73. package/src/client/components/mobile/mobile-right-sidebar/MissingFileBanner.tsx +30 -0
  74. package/src/client/components/mobile/mobile-right-sidebar/PreviewScroller.tsx +18 -2
  75. package/src/client/components/mobile/mobile-session-sidebar/Header.tsx +1 -1
  76. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +22 -67
  77. package/src/client/components/mobile/mobile-session-sidebar/ItemMenu.tsx +110 -0
  78. package/src/client/components/mobile/mobile-session-sidebar/Toolbar.tsx +1 -1
  79. package/src/client/components/mobile/panel-chips.tsx +10 -2
  80. package/src/client/components/settings/Modal.tsx +4 -4
  81. package/src/client/components/settings/ProjectSelectorDropdown.tsx +2 -2
  82. package/src/client/components/settings/SettingsSidebarList.tsx +20 -0
  83. package/src/client/components/settings/apply-side-effects.test.ts +30 -0
  84. package/src/client/components/settings/apply-side-effects.ts +14 -0
  85. package/src/client/components/settings/categories/AgentSettings.tsx +23 -50
  86. package/src/client/components/settings/categories/AppearanceSettings.tsx +6 -0
  87. package/src/client/components/settings/categories/CommandSettings.tsx +2 -2
  88. package/src/client/components/settings/categories/McpSettings.tsx +4 -21
  89. package/src/client/components/settings/categories/OmpSettings.tsx +147 -194
  90. package/src/client/components/settings/categories/SkillSettings.tsx +2 -2
  91. package/src/client/components/settings/categories/TokenUsageSettings.tsx +211 -229
  92. package/src/client/components/settings/categories/agent-settings/DetailPane.tsx +229 -237
  93. package/src/client/components/settings/categories/agent-settings/ModelPicker.tsx +71 -0
  94. package/src/client/components/settings/categories/agent-settings/SidebarList.tsx +9 -2
  95. package/src/client/components/settings/categories/agent-settings/levels.ts +38 -0
  96. package/src/client/components/settings/categories/appearance-settings/EditorBlameSection.tsx +2 -1
  97. package/src/client/components/settings/categories/appearance-settings/EditorTypingSection.tsx +2 -1
  98. package/src/client/components/settings/categories/appearance-settings/IconStyleSection.tsx +144 -0
  99. package/src/client/components/settings/categories/appearance-settings/SurfaceStyleSection.test.tsx +120 -0
  100. package/src/client/components/settings/categories/appearance-settings/SurfaceStyleSection.tsx +180 -0
  101. package/src/client/components/settings/categories/behavior-settings/Editor.tsx +27 -7
  102. package/src/client/components/settings/categories/chat-settings/ToolRenderSection.tsx +23 -5
  103. package/src/client/components/settings/categories/command-settings/DetailPane.tsx +75 -33
  104. package/src/client/components/settings/categories/command-settings/SidebarList.tsx +7 -0
  105. package/src/client/components/settings/categories/mcp-settings/DetailPane.tsx +93 -77
  106. package/src/client/components/settings/categories/mcp-settings/EnvVarsSection.tsx +83 -0
  107. package/src/client/components/settings/categories/mcp-settings/ImportModal.tsx +28 -15
  108. package/src/client/components/settings/categories/mcp-settings/SidebarList.tsx +20 -0
  109. package/src/client/components/settings/categories/omp-settings/ConfigTabs.tsx +97 -36
  110. package/src/client/components/settings/categories/omp-settings/EngineHeader.tsx +151 -0
  111. package/src/client/components/settings/categories/omp-settings/ExtensionsPanel.tsx +68 -32
  112. package/src/client/components/settings/categories/omp-settings/OrderedChips.tsx +119 -0
  113. package/src/client/components/settings/categories/omp-settings/PresetBar.tsx +14 -7
  114. package/src/client/components/settings/categories/omp-settings/RoleEditor.tsx +15 -6
  115. package/src/client/components/settings/categories/omp-settings/RowEditor.tsx +165 -226
  116. package/src/client/components/settings/categories/omp-settings/types.ts +28 -0
  117. package/src/client/components/settings/categories/panel-plugins/AvailableList.tsx +1 -1
  118. package/src/client/components/settings/categories/panel-plugins/BuiltinList.tsx +21 -3
  119. package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +1 -1
  120. package/src/client/components/settings/categories/panel-plugins/PluginMark.test.ts +51 -2
  121. package/src/client/components/settings/categories/panel-plugins/PluginMark.tsx +43 -10
  122. package/src/client/components/settings/categories/plugin-settings/DetailPane.tsx +2 -1
  123. package/src/client/components/settings/categories/plugin-settings/SettingsSection.tsx +2 -1
  124. package/src/client/components/settings/categories/project-settings/ModelDropdown.tsx +1 -1
  125. package/src/client/components/settings/categories/project-settings/WorktreeSettings.tsx +2 -1
  126. package/src/client/components/settings/categories/provider-settings/DeleteProviderModal.tsx +2 -2
  127. package/src/client/components/settings/categories/provider-settings/EntryAdvanced.tsx +3 -2
  128. package/src/client/components/settings/categories/provider-settings/LogoutProviderModal.tsx +2 -2
  129. package/src/client/components/settings/categories/skill-catalog/GitImportPanel.tsx +3 -2
  130. package/src/client/components/settings/categories/skill-settings/DetailHeader.tsx +37 -8
  131. package/src/client/components/settings/categories/skill-settings/DetailPane.tsx +34 -14
  132. package/src/client/components/settings/categories/skill-settings/SidebarList.tsx +21 -0
  133. package/src/client/components/settings/categories/skill-settings/pane.test.tsx +15 -6
  134. package/src/client/components/settings/categories/token-usage-settings/Breakdown.tsx +242 -102
  135. package/src/client/components/settings/categories/token-usage-settings/Chart.tsx +130 -56
  136. package/src/client/components/settings/categories/token-usage-settings/Controls.tsx +135 -0
  137. package/src/client/components/settings/categories/token-usage-settings/MetricsGrid.tsx +55 -33
  138. package/src/client/components/settings/categories/token-usage-settings/Provenance.tsx +59 -0
  139. package/src/client/components/settings/categories/token-usage-settings/panel.test.tsx +239 -0
  140. package/src/client/components/workspace/browser-panel/Screencast.test.ts +1 -0
  141. package/src/client/components/workspace/browser-panel/Screencast.tsx +17 -22
  142. package/src/client/components/workspace/browser-panel/TabStrip.test.tsx +158 -0
  143. package/src/client/components/workspace/browser-panel/TabStrip.tsx +90 -0
  144. package/src/client/components/workspace/browser-panel/index.tsx +50 -4
  145. package/src/client/components/workspace/browser-toolbar/index.tsx +41 -1
  146. package/src/client/components/workspace/btw-panel/TopicMenu.tsx +1 -1
  147. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +2 -2
  148. package/src/client/components/workspace/chat-timeline/NewChatModal.tsx +3 -3
  149. package/src/client/components/workspace/chat-timeline/ThinkingSection.tsx +3 -1
  150. package/src/client/components/workspace/chat-timeline/ToolCallingSection.tsx +2 -0
  151. package/src/client/components/workspace/chat-timeline/UndoConfirmModal.tsx +2 -2
  152. package/src/client/components/workspace/chat-timeline/block-chrome.test.tsx +13 -2
  153. package/src/client/components/workspace/chat-timeline/chat-input/AccessDropdown.tsx +1 -1
  154. package/src/client/components/workspace/chat-timeline/chat-input/GoalModal.tsx +4 -3
  155. package/src/client/components/workspace/chat-timeline/chat-input/ThinkingLevelDropdown.tsx +1 -1
  156. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.tsx +1 -1
  157. package/src/client/components/workspace/chat-timeline/plan-review/index.tsx +2 -2
  158. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.tsx +1 -1
  159. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.tsx +1 -1
  160. package/src/client/components/workspace/chat-timeline/tool-renderers/extension-dialog/index.tsx +2 -6
  161. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.test.ts +88 -0
  162. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.tsx +24 -1
  163. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.test.ts +34 -0
  164. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.tsx +5 -1
  165. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ArtifactChip.tsx +7 -6
  166. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/Tui.test.tsx +237 -0
  167. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/Tui.tsx +191 -0
  168. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/styles.test.tsx +1 -1
  169. package/src/client/components/workspace/context-panel/CostBreakdownPopover.tsx +1 -1
  170. package/src/client/components/workspace/diff-panel/MergeDiffView.tsx +21 -7
  171. package/src/client/components/workspace/diff-panel/changes.test.ts +51 -0
  172. package/src/client/components/workspace/diff-panel/changes.ts +28 -12
  173. package/src/client/components/workspace/diff-panel/index.tsx +2 -2
  174. package/src/client/components/workspace/diff-panel/merge.test.ts +28 -0
  175. package/src/client/components/workspace/diff-panel/merge.ts +21 -1
  176. package/src/client/components/workspace/editor/Body.tsx +7 -0
  177. package/src/client/components/workspace/editor/FileDocument.tsx +15 -21
  178. package/src/client/components/workspace/editor/FilePane.tsx +12 -0
  179. package/src/client/components/workspace/editor/PluginRail.tsx +1 -1
  180. package/src/client/components/workspace/editor/PreviewPane.tsx +70 -0
  181. package/src/client/components/workspace/editor/SaveDeletedFileModal.tsx +2 -2
  182. package/src/client/components/workspace/editor/TabContextMenu.tsx +1 -1
  183. package/src/client/components/workspace/editor/Tabs.tsx +1 -1
  184. package/src/client/components/workspace/editor/Toolbar.tsx +17 -1
  185. package/src/client/components/workspace/editor/index.tsx +25 -22
  186. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +14 -0
  187. package/src/client/components/workspace/editor/toolbar-clusters.tsx +12 -86
  188. package/src/client/components/workspace/editor/toolbar-toggle.tsx +53 -0
  189. package/src/client/components/workspace/editor/toolbar-write-clusters.tsx +112 -0
  190. package/src/client/components/workspace/file-explorer/ContextMenu.tsx +1 -1
  191. package/src/client/components/workspace/file-explorer/Modals.tsx +10 -10
  192. package/src/client/components/workspace/file-explorer/RootMenu.tsx +1 -1
  193. package/src/client/components/workspace/git-panel/BranchToolbar.test.tsx +130 -0
  194. package/src/client/components/workspace/git-panel/BranchToolbar.tsx +21 -11
  195. package/src/client/components/workspace/git-panel/CommitBox.tsx +2 -1
  196. package/src/client/components/workspace/git-panel/Modals.tsx +2 -2
  197. package/src/client/components/workspace/git-panel/StashSection.tsx +2 -1
  198. package/src/client/components/workspace/git-panel/branch-modal/DeleteDialog.tsx +2 -1
  199. package/src/client/components/workspace/git-panel/branch-modal/RenameDialog.tsx +2 -1
  200. package/src/client/components/workspace/git-panel/commit-modal/index.tsx +2 -2
  201. package/src/client/components/workspace/git-panel/commit-modal.test.ts +5 -3
  202. package/src/client/components/workspace/git-panel/index.tsx +7 -0
  203. package/src/client/components/workspace/model-dropdown/Panel.tsx +1 -1
  204. package/src/client/components/workspace/model-dropdown/SpecsTooltip.tsx +1 -1
  205. package/src/client/components/workspace/plugin-panel/catalog.tsx +7 -0
  206. package/src/client/components/workspace/plugin-panel/resolve.tsx +4 -0
  207. package/src/client/components/workspace/search-panel/Body.tsx +1 -1
  208. package/src/client/components/workspace/usage-panel/ProviderSelect.tsx +1 -1
  209. package/src/client/components/workspace/user-browser-panel/AddressBar.tsx +5 -0
  210. package/src/client/components/workspace/user-browser-panel/AnnotateBar.test.tsx +201 -0
  211. package/src/client/components/workspace/user-browser-panel/AnnotateBar.tsx +112 -0
  212. package/src/client/components/workspace/user-browser-panel/AnnotateLayer.test.tsx +225 -0
  213. package/src/client/components/workspace/user-browser-panel/AnnotateLayer.tsx +217 -0
  214. package/src/client/components/workspace/user-browser-panel/AnnotateTarget.tsx +99 -0
  215. package/src/client/components/workspace/user-browser-panel/Frame.tsx +30 -1
  216. package/src/client/components/workspace/user-browser-panel/index.tsx +81 -2
  217. package/src/client/data/agent-data/builtin.ts +0 -10
  218. package/src/client/data/agent-data/orchestrator.ts +0 -45
  219. package/src/client/data/agent-data/specialist.ts +0 -100
  220. package/src/client/data/mock/token-usage.ts +170 -120
  221. package/src/client/data/settings/omp-schema.json +33 -1
  222. package/src/client/glass.css +785 -0
  223. package/src/client/glass.test.ts +346 -0
  224. package/src/client/hooks/browser/use-annotate.test.ts +143 -0
  225. package/src/client/hooks/browser/use-annotate.ts +98 -0
  226. package/src/client/hooks/browser/use-close-tab.test.ts +148 -0
  227. package/src/client/hooks/browser/use-close-tab.ts +67 -0
  228. package/src/client/hooks/browser/use-screencast.ts +13 -1
  229. package/src/client/hooks/chat/composer/browser-context.test.ts +117 -0
  230. package/src/client/hooks/chat/composer/browser-context.ts +40 -16
  231. package/src/client/hooks/chat/composer/items.test.ts +1 -1
  232. package/src/client/hooks/chat/composer/review-context.ts +38 -0
  233. package/src/client/hooks/chat/composer/use-draft.test.ts +132 -0
  234. package/src/client/hooks/chat/composer/use-draft.ts +31 -2
  235. package/src/client/hooks/chat/timeline/row-window.test.ts +15 -2
  236. package/src/client/hooks/editor/use-document-annotations.ts +124 -0
  237. package/src/client/hooks/editor/use-editor-panel-ui.ts +52 -0
  238. package/src/client/hooks/editor/use-file-review-mode.ts +35 -0
  239. package/src/client/hooks/editor/use-preview-review.ts +148 -0
  240. package/src/client/hooks/settings/agents.ts +149 -0
  241. package/src/client/hooks/settings/crud-list.test.ts +28 -6
  242. package/src/client/hooks/settings/crud-list.ts +96 -57
  243. package/src/client/hooks/settings/omp-config.ts +164 -0
  244. package/src/client/hooks/settings/useTokenUsage.ts +125 -0
  245. package/src/client/hooks/settings/write-feedback.test.ts +104 -0
  246. package/src/client/hooks/settings/write-feedback.ts +63 -0
  247. package/src/client/hooks/ui/glass-support.ts +57 -0
  248. package/src/client/hooks/ui/icon-style.ts +59 -0
  249. package/src/client/hooks/ui/markdown-hydration.ts +125 -0
  250. package/src/client/hooks/ui/stuck-header.test.ts +188 -0
  251. package/src/client/hooks/ui/stuck-header.ts +91 -0
  252. package/src/client/hooks/ui/style-attributes.test.ts +120 -0
  253. package/src/client/hooks/ui/surface-style.ts +56 -0
  254. package/src/client/hooks/ui/updates/index.test.ts +100 -1
  255. package/src/client/hooks/ui/updates/index.ts +50 -0
  256. package/src/client/hooks/ui/updates/notes.test.ts +138 -0
  257. package/src/client/hooks/ui/updates/notes.ts +57 -0
  258. package/src/client/hooks/workspace/panel-hues.ts +23 -0
  259. package/src/client/lib/browser/element-at.test.ts +229 -0
  260. package/src/client/lib/browser/element-at.ts +139 -0
  261. package/src/client/lib/review/client.ts +73 -0
  262. package/src/client/lib/router/search-params.ts +42 -20
  263. package/src/client/main.tsx +10 -0
  264. package/src/client/tailwind.css +329 -11
  265. package/src/server/lib/assets/shell-attributes.server.ts +80 -0
  266. package/src/server/lib/assets/shell-attributes.test.ts +86 -0
  267. package/src/server/lib/btw/lifecycle.server.ts +2 -2
  268. package/src/server/lib/db/schema.ts +7 -0
  269. package/src/server/lib/db/seed-terminal.test.ts +4 -0
  270. package/src/server/lib/omp/config/agent-definitions.test.ts +273 -0
  271. package/src/server/lib/omp/config/agents.ts +231 -61
  272. package/src/server/lib/omp/config/definitions.test.ts +9 -105
  273. package/src/server/lib/omp/config/extensions.ts +16 -7
  274. package/src/server/lib/omp/config/omp-config-files.test.ts +27 -0
  275. package/src/server/lib/omp/rpc/constants.test.ts +11 -0
  276. package/src/server/lib/omp/rpc/constants.ts +15 -0
  277. package/src/server/lib/omp/rpc/frame-fold-host.test-util.ts +1 -0
  278. package/src/server/lib/omp/rpc/frame-fold-signals.test.ts +2 -30
  279. package/src/server/lib/omp/rpc/frame-fold.test.ts +55 -0
  280. package/src/server/lib/omp/rpc/frame-fold.ts +4 -0
  281. package/src/server/lib/omp/rpc/manager.ts +2 -2
  282. package/src/server/lib/omp/rpc/process-helpers.ts +11 -0
  283. package/src/server/lib/omp/rpc/process.test.ts +106 -0
  284. package/src/server/lib/omp/rpc/process.ts +39 -18
  285. package/src/server/lib/omp/rpc/run-settle.server.ts +12 -0
  286. package/src/server/lib/omp/rpc/run-settle.test.ts +22 -0
  287. package/src/server/lib/omp/rpc/session-command-guards.ts +5 -0
  288. package/src/server/lib/omp/rpc/session-commands.test.ts +9 -1
  289. package/src/server/lib/omp/rpc/session-commands.ts +17 -3
  290. package/src/server/lib/omp/rpc/terminal-settle.ts +29 -7
  291. package/src/server/lib/omp/rpc/utility-agent-dir.test.ts +134 -0
  292. package/src/server/lib/omp/rpc/utility-agent-dir.ts +138 -0
  293. package/src/server/lib/omp/rpc/utility.ts +12 -0
  294. package/src/server/lib/panels/bundled-catalog.server.ts +1 -0
  295. package/src/server/lib/panels/manifest.test.ts +20 -0
  296. package/src/server/lib/panels/manifest.ts +12 -0
  297. package/src/server/lib/panels/scan.server.ts +4 -0
  298. package/src/server/lib/queue/delivery-dispatch.server.test.ts +48 -0
  299. package/src/server/lib/queue/delivery-harness.ts +8 -4
  300. package/src/server/lib/queue/delivery.server.test.ts +29 -0
  301. package/src/server/lib/queue/delivery.server.ts +39 -0
  302. package/src/server/lib/queue/store.server.test.ts +22 -2
  303. package/src/server/lib/queue/store.server.ts +33 -11
  304. package/src/server/lib/review/schema.server.ts +45 -0
  305. package/src/server/lib/review/store.server.ts +138 -0
  306. package/src/server/lib/terminal/attach-replay.test.ts +132 -0
  307. package/src/server/lib/terminal/output.test.ts +166 -0
  308. package/src/server/lib/terminal/output.ts +104 -0
  309. package/src/server/lib/terminal/runtime.server.ts +5 -0
  310. package/src/server/lib/terminal/send-result.test.ts +33 -0
  311. package/src/server/lib/terminal/send-result.ts +32 -0
  312. package/src/server/lib/terminal/session.server.ts +45 -11
  313. package/src/server/lib/terminal/store-liveness.test.ts +4 -0
  314. package/src/server/lib/updates/active-notes.test.ts +149 -0
  315. package/src/server/lib/updates/active-notes.ts +75 -0
  316. package/src/server/lib/updates/changelog-file.ts +42 -11
  317. package/src/server/lib/updates/changelog.test.ts +15 -1
  318. package/src/server/lib/updates/omp.ts +42 -15
  319. package/src/server/lib/updates/release-url.ts +27 -1
  320. package/src/server/lib/usage/index-parse.test.ts +200 -0
  321. package/src/server/lib/usage/index-parse.ts +178 -0
  322. package/src/server/lib/usage/index-query.server.ts +248 -0
  323. package/src/server/lib/usage/index-scan.server.ts +343 -0
  324. package/src/server/lib/usage/index-schema.server.ts +82 -0
  325. package/src/server/lib/usage/index.test.ts +234 -0
  326. package/src/server/lib/usage/providers.server.ts +4 -53
  327. package/src/server/plugins/ssr.ts +22 -5
  328. package/src/server/routes/browser/index.ts +3 -0
  329. package/src/server/routes/browser/stream.ts +31 -2
  330. package/src/server/routes/browser/tabs.test.ts +94 -0
  331. package/src/server/routes/browser/tabs.ts +85 -0
  332. package/src/server/routes/index.ts +2 -0
  333. package/src/server/routes/review/bindings.ts +11 -0
  334. package/src/server/routes/review/index.ts +127 -0
  335. package/src/server/routes/review/routes.test.ts +191 -0
  336. package/src/server/routes/settings/agents.test.ts +180 -0
  337. package/src/server/routes/settings/agents.ts +95 -102
  338. package/src/server/routes/settings/mcp.test.ts +135 -0
  339. package/src/server/routes/settings/mcp.ts +14 -6
  340. package/src/server/routes/settings/settings-store-routes.test.ts +6 -113
  341. package/src/server/routes/telemetry/tokens.test.ts +145 -0
  342. package/src/server/routes/telemetry/tokens.ts +70 -149
  343. package/src/server/routes/terminal/ws.ts +6 -5
  344. package/src/server/routes/updates/index.ts +2 -0
  345. package/src/server/routes/updates/notes.ts +34 -0
  346. package/src/server/routes/updates/routes.test.ts +49 -0
  347. package/src/shared/lib/browser/annotate.test.ts +283 -0
  348. package/src/shared/lib/browser/annotate.ts +231 -0
  349. package/src/shared/lib/browser/browser-viewer.test.ts +26 -4
  350. package/src/shared/lib/browser/frame-gate.test.ts +91 -0
  351. package/src/shared/lib/browser/frame-gate.ts +69 -0
  352. package/src/shared/lib/browser/frame-params.test.ts +43 -0
  353. package/src/shared/lib/browser/frame-params.ts +60 -0
  354. package/src/shared/lib/browser/frame-pipeline.test.ts +132 -0
  355. package/src/shared/lib/browser/frame-pipeline.ts +80 -0
  356. package/src/shared/lib/browser/page-context.ts +60 -4
  357. package/src/shared/lib/browser/snapshot.test.ts +115 -0
  358. package/src/shared/lib/browser/snapshot.ts +112 -0
  359. package/src/shared/lib/browser/tab-close.test.ts +74 -0
  360. package/src/shared/lib/browser/tab-close.ts +77 -0
  361. package/src/shared/lib/browser/viewer.ts +45 -26
  362. package/src/shared/lib/chat/timeline/block-chrome.ts +19 -0
  363. package/src/shared/lib/chat/timeline/tool-render-mode.ts +17 -4
  364. package/src/shared/lib/chat/tool/artifact.ts +55 -20
  365. package/src/shared/lib/chat/tool/bash-facts.ts +96 -0
  366. package/src/shared/lib/chat/tool/minimized.test.ts +98 -0
  367. package/src/shared/lib/chat/tool/minimized.ts +64 -0
  368. package/src/shared/lib/chat/tool/summary.test.ts +28 -8
  369. package/src/shared/lib/chat/tool/summary.ts +3 -32
  370. package/src/shared/lib/icons/file-brand-color.ts +38 -0
  371. package/src/shared/lib/icons/icon-paint-css.test.ts +234 -0
  372. package/src/shared/lib/icons/icon-paint-css.ts +284 -0
  373. package/src/shared/lib/icons/icon-paint-panel.ts +100 -0
  374. package/src/shared/lib/icons/tint-hues.generated.ts +230 -0
  375. package/src/shared/lib/icons/tint.test.ts +273 -0
  376. package/src/shared/lib/icons/tint.ts +219 -0
  377. package/src/shared/lib/markdown/blocks/anchor.ts +63 -0
  378. package/src/shared/lib/markdown/blocks/blocks.test.ts +141 -0
  379. package/src/shared/lib/markdown/blocks/renderer.ts +120 -0
  380. package/src/shared/lib/markdown/blocks/scan.ts +100 -0
  381. package/src/shared/lib/markdown/blocks/types.ts +62 -0
  382. package/src/shared/lib/markdown/marked.ts +58 -147
  383. package/src/shared/lib/markdown/math-extensions.ts +168 -0
  384. package/src/shared/lib/markdown/review/prompt.ts +77 -0
  385. package/src/shared/lib/markdown/review/reconcile.ts +55 -0
  386. package/src/shared/lib/markdown/review/review.test.ts +96 -0
  387. package/src/shared/lib/markdown/xml-sections.test.ts +140 -0
  388. package/src/shared/lib/markdown/xml-sections.ts +139 -0
  389. package/src/shared/lib/models/provider/brand-color.test.ts +116 -0
  390. package/src/shared/lib/models/provider/brand-color.ts +103 -0
  391. package/src/shared/lib/models/provider/label.ts +57 -0
  392. package/src/shared/lib/omp/config/agent-file.test.ts +54 -0
  393. package/src/shared/lib/omp/config/agent-file.ts +43 -0
  394. package/src/shared/lib/omp/config/row-value.test.ts +95 -0
  395. package/src/shared/lib/omp/config/row-value.ts +97 -0
  396. package/src/shared/lib/omp/config/schema.test.ts +31 -0
  397. package/src/shared/lib/omp/config/schema.ts +6 -0
  398. package/src/shared/lib/omp/rpc/frame.test.ts +113 -47
  399. package/src/shared/lib/omp/rpc/frame.ts +107 -43
  400. package/src/shared/lib/settings/defaults.ts +4 -0
  401. package/src/shared/lib/theme/catalog.test.ts +5 -4
  402. package/src/shared/lib/theme/catalog.ts +18 -3
  403. package/src/shared/lib/theme/glass-support.test.ts +38 -0
  404. package/src/shared/lib/theme/glass-support.ts +73 -0
  405. package/src/shared/lib/theme/icon-style.test.ts +74 -0
  406. package/src/shared/lib/theme/icon-style.ts +90 -0
  407. package/src/shared/lib/theme/legibility.ts +91 -0
  408. package/src/shared/lib/theme/palettes/dark-extended.ts +152 -0
  409. package/src/shared/lib/theme/palettes/light-extended.ts +157 -0
  410. package/src/shared/lib/theme/surface-style.test.ts +68 -0
  411. package/src/shared/lib/theme/surface-style.ts +91 -0
  412. package/src/shared/lib/theme/theme.test.ts +11 -7
  413. package/src/shared/lib/ui/menu-anchor.test.ts +69 -0
  414. package/src/shared/lib/ui/menu-anchor.ts +89 -0
  415. package/src/shared/lib/usage/breakdown.test.ts +197 -0
  416. package/src/shared/lib/usage/breakdown.ts +241 -0
  417. package/src/shared/lib/usage/range.test.ts +204 -0
  418. package/src/shared/lib/usage/range.ts +240 -0
  419. package/src/shared/lib/usage/view.test.ts +85 -0
  420. package/src/shared/lib/usage/view.ts +74 -0
  421. package/src/shared/lib/workspace/panel-hues.test.ts +68 -0
  422. package/src/shared/lib/workspace/panel-hues.ts +57 -0
  423. package/src/shared/types/browser.ts +78 -0
  424. package/src/shared/types/index.ts +1 -0
  425. package/src/shared/types/panels-registry.ts +6 -0
  426. package/src/shared/types/panels.ts +14 -0
  427. package/src/shared/types/settings/agent.ts +28 -6
  428. package/src/shared/types/settings/state.ts +30 -3
  429. package/src/shared/types/settings/write.ts +6 -0
  430. package/src/shared/types/tokenUsage.ts +128 -21
  431. package/src/shared/types/updates.ts +20 -0
  432. package/src/test-support/fake-omp-frames.ts +163 -0
  433. package/dist/client/static/js/index-3ve31rzx.css +0 -1
  434. package/src/server/lib/omp/session/usage/aggregate-shaping.test.ts +0 -149
  435. package/src/server/lib/omp/session/usage/aggregate.test.ts +0 -243
  436. package/src/server/lib/omp/session/usage/aggregate.ts +0 -330
  437. package/src/server/lib/omp/session/usage/shaping.ts +0 -130
  438. /package/src/{client/components/common/file-icon/brand-paths.ts → shared/lib/icons/file-brand-paths.ts} +0 -0
@@ -1,5 +1,6 @@
1
- import { useEffect, useState } from 'preact/hooks';
1
+ import { useCallback, useEffect, useState } from 'preact/hooks';
2
2
  import { invalidateComposerCache } from '@/shared/lib/chat/composer/client';
3
+ import type { WriteOutcome } from '@/shared/types';
3
4
 
4
5
  export interface CrudListMessages {
5
6
  load: string;
@@ -42,10 +43,6 @@ export interface CrudListConfig<T extends { id: string }, D = T> {
42
43
  deleteFromResponse?: boolean;
43
44
  /** When false, `selected` is undefined if no id matches. Defaults true. */
44
45
  fallbackToFirst?: boolean;
45
- /** Return true to abort save on a payload error (log inside the callback). */
46
- isSaveError?: (data: unknown) => boolean;
47
- /** Return true to abort delete on a payload error (log inside the callback). */
48
- isDeleteError?: (data: unknown) => boolean;
49
46
  }
50
47
 
51
48
  export interface CrudListController<T extends { id: string }, D = T> {
@@ -54,10 +51,15 @@ export interface CrudListController<T extends { id: string }, D = T> {
54
51
  selected: T | undefined;
55
52
  isCreatingNew: boolean;
56
53
  isLoading: boolean;
54
+ /** Why the list could not be read, or null. A failed read is never an empty list. */
55
+ loadError: string | null;
56
+ /** Re-run the list read (after a save that the server answered differently). */
57
+ reload: () => void;
57
58
  select: (id: string) => void;
58
59
  startCreate: () => void;
59
- save: (draft: D) => void;
60
- remove: (id: string) => void;
60
+ /** Resolves with the server's answer; the caller reports it. */
61
+ save: (draft: D) => Promise<WriteOutcome>;
62
+ remove: (id: string) => Promise<WriteOutcome>;
61
63
  }
62
64
 
63
65
  function defaultReadList<T>(listKey: string) {
@@ -67,6 +69,13 @@ function defaultReadList<T>(listKey: string) {
67
69
  };
68
70
  }
69
71
 
72
+ /** The refusal sentence a payload carries, when it carries one. */
73
+ function payloadError(data: unknown): string | null {
74
+ if (typeof data !== 'object' || data === null || !('error' in data)) return null;
75
+ const error = data.error;
76
+ return typeof error === 'string' && error.trim() ? error : null;
77
+ }
78
+
70
79
  /** Shared load/save/delete + selection controller for the settings CRUD screens. */
71
80
  export function useCrudList<T extends { id: string }, D = T>(
72
81
  config: CrudListConfig<T, D>,
@@ -76,35 +85,51 @@ export function useCrudList<T extends { id: string }, D = T>(
76
85
  const [selectedId, setSelectedId] = useState<string | null>(null);
77
86
  const [isCreatingNew, setIsCreatingNew] = useState(false);
78
87
  const [isLoading, setIsLoading] = useState(true);
88
+ const [loadError, setLoadError] = useState<string | null>(null);
89
+ const [loadNonce, setLoadNonce] = useState(0);
79
90
 
80
91
  const readList = config.readList ?? defaultReadList<T>(listKey);
81
92
 
82
93
  useEffect(() => {
83
94
  let active = true;
95
+ setIsLoading(true);
84
96
  fetch(`${endpoint}${query ?? ''}`)
85
- .then((res) => res.json())
97
+ .then(async (res) => {
98
+ const data: unknown = await res.json().catch(() => null);
99
+ if (!res.ok) throw new Error(payloadError(data) ?? `GET ${endpoint} answered ${res.status}`);
100
+ return data;
101
+ })
86
102
  .then((data) => {
87
103
  if (!active) return;
88
104
  const list = readList(data) ?? [];
89
105
  setItems(list);
106
+ setLoadError(null);
90
107
  setSelectedId((prev) =>
91
108
  config.resolveOnLoad ? config.resolveOnLoad(prev, list) : list.length > 0 ? list[0].id : null,
92
109
  );
93
110
  })
94
- .catch((err) => console.error(messages.load, err))
111
+ .catch((err) => {
112
+ if (!active) return;
113
+ // Reported, never swallowed into an empty list: "no agents" and "the
114
+ // read failed" are different facts and the panel says which it is.
115
+ console.error(messages.load, err);
116
+ setLoadError(err instanceof Error ? err.message : String(err));
117
+ })
95
118
  .finally(() => {
96
119
  if (active) setIsLoading(false);
97
120
  });
98
121
  return () => {
99
122
  active = false;
100
123
  };
101
- }, [endpoint, query]);
124
+ }, [endpoint, query, loadNonce]);
102
125
 
103
126
  const selected =
104
127
  config.fallbackToFirst === false
105
128
  ? items.find((item) => item.id === selectedId)
106
129
  : items.find((item) => item.id === selectedId) ?? items[0];
107
130
 
131
+ const reload = useCallback(() => setLoadNonce((n) => n + 1), []);
132
+
108
133
  const select = (id: string) => {
109
134
  setIsCreatingNew(false);
110
135
  setSelectedId(id);
@@ -115,62 +140,74 @@ export function useCrudList<T extends { id: string }, D = T>(
115
140
  setSelectedId(null);
116
141
  };
117
142
 
118
- const save = (draft: D) => {
143
+ const save = async (draft: D): Promise<WriteOutcome> => {
119
144
  const target = isCreatingNew
120
145
  ? config.buildNew(draft)
121
146
  : config.buildUpdate(draft, selected, selectedId);
122
147
  const body = config.buildBody ? config.buildBody(target) : { [config.bodyKey]: target };
123
- fetch(endpoint, {
124
- method: 'POST',
125
- headers: { 'Content-Type': 'application/json' },
126
- body: JSON.stringify(body),
127
- })
128
- .then((res) => res.json())
129
- .then((data) => {
130
- if (config.isSaveError?.(data)) return;
131
- const list = readList(data);
132
- if (list) {
133
- setItems(list);
134
- } else if (!config.serverListOnly) {
135
- setItems((prev) => {
136
- const exists = prev.some((item) => item.id === target.id);
137
- return exists
138
- ? prev.map((item) => (item.id === target.id ? target : item))
139
- : [...prev, target];
140
- });
141
- }
142
- const nextId = config.resolveOnSave ? config.resolveOnSave(target, list) : target.id;
143
- if (nextId !== undefined) setSelectedId(nextId);
144
- setIsCreatingNew(false);
145
- if (cacheKey) invalidateComposerCache(cacheKey);
146
- })
147
- .catch((err) => console.error(messages.save, err));
148
+ try {
149
+ const res = await fetch(endpoint, {
150
+ method: 'POST',
151
+ headers: { 'Content-Type': 'application/json' },
152
+ body: JSON.stringify(body),
153
+ });
154
+ const data: unknown = await res.json().catch(() => null);
155
+ const error = payloadError(data) ?? (res.ok ? null : `POST ${endpoint} answered ${res.status}`);
156
+ if (error) {
157
+ console.error(messages.save, error);
158
+ return { ok: false, error };
159
+ }
160
+ const list = readList(data);
161
+ if (list) {
162
+ setItems(list);
163
+ } else if (!config.serverListOnly) {
164
+ setItems((prev) => {
165
+ const exists = prev.some((item) => item.id === target.id);
166
+ return exists
167
+ ? prev.map((item) => (item.id === target.id ? target : item))
168
+ : [...prev, target];
169
+ });
170
+ }
171
+ const nextId = config.resolveOnSave ? config.resolveOnSave(target, list) : target.id;
172
+ if (nextId !== undefined) setSelectedId(nextId);
173
+ setIsCreatingNew(false);
174
+ if (cacheKey) invalidateComposerCache(cacheKey);
175
+ return { ok: true };
176
+ } catch (err) {
177
+ console.error(messages.save, err);
178
+ return { ok: false, error: err instanceof Error ? err.message : String(err) };
179
+ }
148
180
  };
149
181
 
150
- const remove = (id: string) => {
182
+ const remove = async (id: string): Promise<WriteOutcome> => {
151
183
  const deleteQuery = config.buildDeleteQuery
152
184
  ? config.buildDeleteQuery(id)
153
185
  : `?id=${encodeURIComponent(id)}`;
154
- fetch(`${endpoint}${deleteQuery}`, { method: 'DELETE' })
155
- .then((res) => res.json())
156
- .then((data) => {
157
- if (config.isDeleteError?.(data)) return;
158
- if (cacheKey) invalidateComposerCache(cacheKey);
159
- if (config.deleteFromResponse) {
160
- const list = readList(data) ?? items.filter((item) => item.id !== id);
161
- setItems(list);
162
- if (selectedId === id) setSelectedId(list[0]?.id ?? null);
163
- } else {
164
- fetch(`${endpoint}${query ?? ''}`)
165
- .then((r) => r.json())
166
- .then((d) => {
167
- const next = readList(d) ?? [];
168
- setItems(next);
169
- if (selectedId === id) setSelectedId(next[0]?.id || null);
170
- });
171
- }
172
- })
173
- .catch((err) => console.error(messages.delete, err));
186
+ try {
187
+ const res = await fetch(`${endpoint}${deleteQuery}`, { method: 'DELETE' });
188
+ const data: unknown = await res.json().catch(() => null);
189
+ const error = payloadError(data) ?? (res.ok ? null : `DELETE ${endpoint} answered ${res.status}`);
190
+ if (error) {
191
+ console.error(messages.delete, error);
192
+ return { ok: false, error };
193
+ }
194
+ if (cacheKey) invalidateComposerCache(cacheKey);
195
+ if (config.deleteFromResponse) {
196
+ const list = readList(data) ?? items.filter((item) => item.id !== id);
197
+ setItems(list);
198
+ if (selectedId === id) setSelectedId(list[0]?.id ?? null);
199
+ } else {
200
+ const reloadRes = await fetch(`${endpoint}${query ?? ''}`);
201
+ const reloadData: unknown = await reloadRes.json().catch(() => null);
202
+ const next = readList(reloadData) ?? [];
203
+ setItems(next);
204
+ if (selectedId === id) setSelectedId(next[0]?.id || null);
205
+ }
206
+ return { ok: true };
207
+ } catch (err) {
208
+ console.error(messages.delete, err);
209
+ return { ok: false, error: err instanceof Error ? err.message : String(err) };
210
+ }
174
211
  };
175
212
 
176
213
  return {
@@ -179,6 +216,8 @@ export function useCrudList<T extends { id: string }, D = T>(
179
216
  selected,
180
217
  isCreatingNew,
181
218
  isLoading,
219
+ loadError,
220
+ reload,
182
221
  select,
183
222
  startCreate,
184
223
  save,
@@ -0,0 +1,164 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Native omp config writes for the OMP Engine panel: the live snapshot, the
8
+ * per-key save/reset state, and the "saved <key>" flash.
9
+ *
10
+ * Extracted from `OmpSettings` for the same reason `useModelRoles` was: it is a
11
+ * self-contained store with three verbs and its own error surface, and the panel
12
+ * was over the per-file ceiling. The load is still the panel's single
13
+ * `Promise.all`, so `applyEntries` adopts its half of that payload.
14
+ *
15
+ * Every write keeps the server's OWN sentence. `omp config set` refuses a stale
16
+ * key with "Unknown setting: <key>", a bad value with "Invalid value: …", and a
17
+ * timeout with nothing at all — a bare "save failed" badge made all three read
18
+ * the same.
19
+ */
20
+
21
+ import { useCallback, useEffect, useRef, useState } from 'preact/hooks';
22
+ import type { ConfigEntry } from '@/server/lib/omp/config/config-cli';
23
+
24
+ export interface OmpConfigWrites {
25
+ entries: Record<string, ConfigEntry>;
26
+ /** Keys whose write is in flight. */
27
+ savingKeys: Set<string>;
28
+ /** Keys with a local draft the server does not hold. */
29
+ dirtyKeys: Set<string>;
30
+ /** Key → the refusal's sentence. */
31
+ saveErrors: Map<string, string>;
32
+ /** The key whose write just landed (cleared after a short flash). */
33
+ savedKey: string | null;
34
+ /** Adopt the `GET /api/settings/omp-config` entries. */
35
+ applyEntries: (entries: Record<string, ConfigEntry>) => void;
36
+ commitValue: (key: string, value: unknown) => Promise<boolean>;
37
+ resetKey: (key: string) => Promise<boolean>;
38
+ setDirty: (key: string, dirty: boolean) => void;
39
+ /** Flash a badge for a write that does not own a config row (roles, extensions). */
40
+ flashSaved: (key: string) => void;
41
+ }
42
+
43
+ export const SAVED_FLASH_MS = 2000;
44
+
45
+ interface WriteAnswer {
46
+ ok: boolean;
47
+ value?: unknown;
48
+ error?: string;
49
+ }
50
+
51
+ /** POST one config write; never throws for a refusal. */
52
+ async function postConfig(body: unknown): Promise<WriteAnswer> {
53
+ const res = await fetch('/api/settings/omp-config', {
54
+ method: 'POST',
55
+ headers: { 'Content-Type': 'application/json' },
56
+ body: JSON.stringify(body),
57
+ });
58
+ const data: unknown = await res.json().catch(() => null);
59
+ if (typeof data !== 'object' || data === null) {
60
+ return { ok: false, error: `The config route answered ${res.status} without a body` };
61
+ }
62
+ const ok = 'success' in data && data.success === true;
63
+ const error = 'error' in data && typeof data.error === 'string' ? data.error : undefined;
64
+ const value = 'value' in data ? data.value : undefined;
65
+ return { ok, ...(error ? { error } : {}), ...(value === undefined ? {} : { value }) };
66
+ }
67
+
68
+ export function useOmpConfigWrites(): OmpConfigWrites {
69
+ const [entries, setEntries] = useState<Record<string, ConfigEntry>>({});
70
+ const [savingKeys, setSavingKeys] = useState<Set<string>>(new Set());
71
+ const [dirtyKeys, setDirtyKeys] = useState<Set<string>>(new Set());
72
+ const [saveErrors, setSaveErrors] = useState<Map<string, string>>(new Map());
73
+ const [savedKey, setSavedKey] = useState<string | null>(null);
74
+ const mounted = useRef(true);
75
+
76
+ useEffect(() => () => { mounted.current = false; }, []);
77
+
78
+ const applyEntries = useCallback((next: Record<string, ConfigEntry>) => {
79
+ setEntries(next);
80
+ }, []);
81
+
82
+ const flashSaved = useCallback((key: string) => {
83
+ setSavedKey(key);
84
+ setTimeout(() => setSavedKey((current) => (current === key ? null : current)), SAVED_FLASH_MS);
85
+ }, []);
86
+
87
+ /** Apply one write's outcome to the row state. */
88
+ const applyWriteResult = useCallback((key: string, outcome: WriteAnswer) => {
89
+ if (!mounted.current) return;
90
+ setSavingKeys((prev) => {
91
+ const next = new Set(prev);
92
+ next.delete(key);
93
+ return next;
94
+ });
95
+ setDirtyKeys((prev) => {
96
+ const next = new Set(prev);
97
+ next.delete(key);
98
+ return next;
99
+ });
100
+ if (outcome.ok) {
101
+ setSaveErrors((prev) => {
102
+ if (!prev.has(key)) return prev;
103
+ const next = new Map(prev);
104
+ next.delete(key);
105
+ return next;
106
+ });
107
+ if (outcome.value !== undefined) {
108
+ setEntries((prev) => ({ ...prev, [key]: { ...prev[key], value: outcome.value } }));
109
+ }
110
+ flashSaved(key);
111
+ } else {
112
+ setSaveErrors((prev) => new Map(prev).set(key, outcome.error ?? 'omp rejected the write'));
113
+ }
114
+ }, [flashSaved]);
115
+
116
+ const runWrite = useCallback(async (key: string, body: unknown): Promise<boolean> => {
117
+ setSavingKeys((prev) => new Set(prev).add(key));
118
+ setDirtyKeys((prev) => {
119
+ const next = new Set(prev);
120
+ next.delete(key);
121
+ return next;
122
+ });
123
+ try {
124
+ const outcome = await postConfig(body);
125
+ applyWriteResult(key, outcome);
126
+ return outcome.ok;
127
+ } catch (err) {
128
+ console.error('Failed to write omp config:', err);
129
+ applyWriteResult(key, { ok: false, error: err instanceof Error ? err.message : String(err) });
130
+ return false;
131
+ }
132
+ }, [applyWriteResult]);
133
+
134
+ const commitValue = useCallback(
135
+ (key: string, value: unknown) => runWrite(key, { key, value }),
136
+ [runWrite],
137
+ );
138
+ const resetKey = useCallback(
139
+ (key: string) => runWrite(key, { key, action: 'reset' }),
140
+ [runWrite],
141
+ );
142
+
143
+ const setDirty = useCallback((key: string, dirty: boolean) => {
144
+ setDirtyKeys((prev) => {
145
+ const next = new Set(prev);
146
+ if (dirty) next.add(key);
147
+ else next.delete(key);
148
+ return next;
149
+ });
150
+ }, []);
151
+
152
+ return {
153
+ entries,
154
+ savingKeys,
155
+ dirtyKeys,
156
+ saveErrors,
157
+ savedKey,
158
+ applyEntries,
159
+ commitValue,
160
+ resetKey,
161
+ setDirty,
162
+ flashSaved,
163
+ };
164
+ }
@@ -0,0 +1,125 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Loads the Token Usage payload and keeps it fresh while the index catches up.
8
+ *
9
+ * Three behaviours the panel depends on:
10
+ *
11
+ * - **One request per period.** Cadence and breakdown tab live in the
12
+ * component; changing them re-folds the payload client-side.
13
+ * - **Stale-while-revalidate.** A range change keeps the previous numbers on
14
+ * screen (`refreshing`) instead of blanking the panel, and the first load is
15
+ * the only case that shows a skeleton.
16
+ * - **Abort.** A fast user clicking ranges would otherwise render whichever
17
+ * response happened to arrive last.
18
+ *
19
+ * While `index.state` is `building` the hook polls: the indexer answers with
20
+ * the data it already has, so the panel draws immediately and the footer says
21
+ * "indexing…" until the next poll reports `ready`.
22
+ */
23
+
24
+ import { useCallback, useEffect, useRef, useState } from 'preact/hooks';
25
+ import type { TimeRangeType, TokenUsagePayload } from '@/shared/types';
26
+
27
+ const POLL_MS = 1_500;
28
+
29
+ export interface TokenUsageState {
30
+ payload: TokenUsagePayload | null;
31
+ error: string | null;
32
+ /** True only until the first payload arrives. */
33
+ loading: boolean;
34
+ /** A request is in flight while older data is on screen. */
35
+ refreshing: boolean;
36
+ reload: (force?: boolean) => void;
37
+ }
38
+
39
+ export function useTokenUsage(range: TimeRangeType, custom: { from: string; to: string }): TokenUsageState {
40
+ const [payload, setPayload] = useState<TokenUsagePayload | null>(null);
41
+ const [error, setError] = useState<string | null>(null);
42
+ const [loading, setLoading] = useState(true);
43
+ const [refreshing, setRefreshing] = useState(false);
44
+ const abortRef = useRef<AbortController | null>(null);
45
+ const payloadRef = useRef<TokenUsagePayload | null>(null);
46
+ const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
47
+ const forceRef = useRef(false);
48
+
49
+ const clearTimer = () => {
50
+ if (timerRef.current !== null) {
51
+ clearTimeout(timerRef.current);
52
+ timerRef.current = null;
53
+ }
54
+ };
55
+
56
+ const request = useCallback(
57
+ (): string => {
58
+ const params = new URLSearchParams({ range });
59
+ if (range === 'custom') {
60
+ params.set('customFrom', custom.from);
61
+ params.set('customTo', custom.to);
62
+ }
63
+ return `/api/telemetry/tokens?${params.toString()}${forceRef.current ? '&refresh=1' : ''}`;
64
+ },
65
+ [range, custom.from, custom.to],
66
+ );
67
+
68
+ const load = useCallback(
69
+ async (force: boolean): Promise<void> => {
70
+ abortRef.current?.abort();
71
+ const controller = new AbortController();
72
+ abortRef.current = controller;
73
+ forceRef.current = force;
74
+ setRefreshing(true);
75
+ try {
76
+ const response = await fetch(request(), {
77
+ signal: controller.signal,
78
+ method: force ? 'POST' : 'GET',
79
+ });
80
+ const body = (await response.json()) as TokenUsagePayload & { error?: string };
81
+ if (!response.ok || body.error) throw new Error(body.error ?? `Token usage failed (${response.status})`);
82
+ payloadRef.current = body;
83
+ setPayload(body);
84
+ setError(null);
85
+ setLoading(false);
86
+ clearTimer();
87
+ if (body.index.state === 'building') {
88
+ timerRef.current = setTimeout(() => {
89
+ forceRef.current = false;
90
+ void load(false);
91
+ }, POLL_MS);
92
+ }
93
+ } catch (caught) {
94
+ if (controller.signal.aborted) return;
95
+ setError(caught instanceof Error ? caught.message : 'Failed to load token usage');
96
+ setLoading(false);
97
+ } finally {
98
+ if (!controller.signal.aborted) setRefreshing(false);
99
+ }
100
+ },
101
+ [request],
102
+ );
103
+
104
+ useEffect(() => {
105
+ // Only the FIRST load has nothing to show. A range change keeps the
106
+ // previous numbers on screen with an "updating…" hint instead of blanking
107
+ // the panel the user is reading.
108
+ setLoading((current) => current && payloadRef.current === null);
109
+ void load(false);
110
+ return () => {
111
+ abortRef.current?.abort();
112
+ clearTimer();
113
+ };
114
+ }, [load]);
115
+
116
+ const reload = useCallback(
117
+ (force = false) => {
118
+ clearTimer();
119
+ void load(force);
120
+ },
121
+ [load],
122
+ );
123
+
124
+ return { payload, error, loading, refreshing, reload };
125
+ }
@@ -0,0 +1,104 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The write-feedback contract every settings pane now shares.
8
+ *
9
+ * This exists because the panes used to paint "Saved successfully" the moment
10
+ * the button was pressed — before the request answered — so a refused write (a
11
+ * duplicate preset name, a read-only native file, a validator rejecting the
12
+ * draft) showed success over a row that had not changed. The badge is now driven
13
+ * by the outcome and nothing else, and a refusal keeps the server's sentence.
14
+ */
15
+
16
+ import { afterAll, afterEach, beforeAll, describe, expect, test } from 'bun:test';
17
+ import { Window } from 'happy-dom';
18
+ import { h, render } from 'preact';
19
+ import { act } from 'preact/test-utils';
20
+ import { useWriteFeedback, type WriteFeedback } from '@/client/hooks/settings/write-feedback';
21
+ import { installDomGlobals, restoreDomGlobals } from '@/test-support/pristine-globals';
22
+ import type { WriteOutcome } from '@/shared/types';
23
+
24
+ let container: HTMLElement | null = null;
25
+ let feedback: WriteFeedback | null = null;
26
+
27
+ function Probe() {
28
+ feedback = useWriteFeedback();
29
+ return h('div', null, feedback.saving ? 'saving' : feedback.saved ? 'saved' : 'idle');
30
+ }
31
+
32
+ beforeAll(() => {
33
+ installDomGlobals(new Window({ url: 'http://localhost' }));
34
+ });
35
+
36
+ afterEach(() => {
37
+ if (container) render(null, container);
38
+ container = null;
39
+ feedback = null;
40
+ });
41
+
42
+ afterAll(() => {
43
+ restoreDomGlobals();
44
+ });
45
+
46
+ async function mount(): Promise<void> {
47
+ container = document.body.appendChild(document.createElement('div'));
48
+ await act(async () => { render(h(Probe, {}), container as HTMLElement); });
49
+ }
50
+
51
+ /** Run one write and drain its promise chain plus the resulting renders. */
52
+ async function run(action: () => Promise<WriteOutcome>): Promise<boolean> {
53
+ let ok = false;
54
+ await act(async () => {
55
+ const pending = feedback!.run(action);
56
+ ok = await pending;
57
+ });
58
+ return ok;
59
+ }
60
+
61
+ describe('useWriteFeedback', () => {
62
+ test('a landed write flashes saved instead of trusting the click', async () => {
63
+ await mount();
64
+ expect(await run(async () => ({ ok: true }))).toBe(true);
65
+ expect(feedback?.saved).toBe(true);
66
+ expect(feedback?.error).toBeNull();
67
+ expect(feedback?.saving).toBe(false);
68
+ });
69
+
70
+ test('a refusal keeps the server’s sentence and shows no success', async () => {
71
+ await mount();
72
+ expect(await run(async () => ({ ok: false, error: 'A preset named “cheap” already exists' }))).toBe(false);
73
+ expect(feedback?.saved).toBe(false);
74
+ expect(feedback?.error).toBe('A preset named “cheap” already exists');
75
+ });
76
+
77
+ test('a refusal without a sentence still says something actionable', async () => {
78
+ await mount();
79
+ await run(async () => ({ ok: false }));
80
+ expect(feedback?.error).toBe('The server refused the write.');
81
+ });
82
+
83
+ test('a thrown write is reported rather than escaping to the console', async () => {
84
+ await mount();
85
+ expect(await run(async () => { throw new Error('network down'); })).toBe(false);
86
+ expect(feedback?.error).toBe('network down');
87
+ expect(feedback?.saving).toBe(false);
88
+ });
89
+
90
+ test('a later success clears the previous refusal', async () => {
91
+ await mount();
92
+ await run(async () => ({ ok: false, error: 'first refusal' }));
93
+ await run(async () => ({ ok: true }));
94
+ expect(feedback?.error).toBeNull();
95
+ expect(feedback?.saved).toBe(true);
96
+ });
97
+
98
+ test('dismissError clears the sentence without clearing a success', async () => {
99
+ await mount();
100
+ await run(async () => ({ ok: false, error: 'nope' }));
101
+ await act(async () => { feedback?.dismissError(); });
102
+ expect(feedback?.error).toBeNull();
103
+ });
104
+ });