@kabmo-labs/kabmo 0.16.0 → 0.18.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 (381) hide show
  1. package/README.md +2 -2
  2. package/dist/client/index.html +1 -1
  3. package/dist/client/index.js +552 -471
  4. package/dist/client/static/js/index-hp75vsv9.css +1 -0
  5. package/dist/client/static/js/{index-cpydmygd.js → index-tc09dtca.js} +897 -886
  6. package/package.json +1 -1
  7. package/src/client/components/common/MarkdownRenderer.tsx +136 -89
  8. package/src/client/components/common/anchored-menu/index.test.tsx +141 -0
  9. package/src/client/components/common/anchored-menu/index.tsx +143 -0
  10. package/src/client/components/common/code-surface/bracket-guide.test.ts +2 -2
  11. package/src/client/components/common/code-surface/bracket-guide.ts +2 -2
  12. package/src/client/components/common/code-surface/conflict-markers.ts +5 -5
  13. package/src/client/components/common/code-surface/extensions.ts +7 -4
  14. package/src/client/components/common/code-surface/theme.ts +34 -9
  15. package/src/client/components/common/code-surface/whitespace.test.ts +223 -0
  16. package/src/client/components/common/code-surface/whitespace.ts +140 -0
  17. package/src/client/components/common/markdown-review/ReviewPopover.tsx +144 -0
  18. package/src/client/components/common/markdown-review/ReviewSummary.tsx +108 -0
  19. package/src/client/components/common/markdown-review/index.tsx +129 -0
  20. package/src/client/components/common/{server-switcher/index.tsx → server-control/Panel.tsx} +92 -44
  21. package/src/client/components/common/server-control/index.test.tsx +217 -0
  22. package/src/client/components/common/server-control/index.tsx +120 -0
  23. package/src/client/components/layout/desktop-layout/TopNavbar.tsx +8 -50
  24. package/src/client/components/layout/session-sidebar/CategoryHeader.tsx +42 -21
  25. package/src/client/components/layout/session-sidebar/CategoryHeader.worktree.test.tsx +36 -17
  26. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +8 -7
  27. package/src/client/components/layout/session-sidebar/about-modal/NotesDialog.tsx +94 -0
  28. package/src/client/components/layout/session-sidebar/about-modal/VersionLine.test.tsx +68 -0
  29. package/src/client/components/layout/session-sidebar/about-modal/VersionLine.tsx +36 -0
  30. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +57 -34
  31. package/src/client/components/layout/session-sidebar/modern/WorkspaceHeader.tsx +28 -10
  32. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +7 -6
  33. package/src/client/components/layout/session-sidebar/modern/workspace-header.test.tsx +1 -1
  34. package/src/client/components/layout/update-popup/ReleaseNotes.tsx +8 -3
  35. package/src/client/components/layout/update-popup/index.tsx +5 -1
  36. package/src/client/components/mobile/mobile-main-view/Header.tsx +6 -12
  37. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +13 -15
  38. package/src/client/components/mobile/mobile-right-sidebar/Header.tsx +23 -1
  39. package/src/client/components/mobile/mobile-right-sidebar/MissingFileBanner.tsx +30 -0
  40. package/src/client/components/mobile/mobile-right-sidebar/PreviewScroller.tsx +18 -2
  41. package/src/client/components/mobile/mobile-session-sidebar/Header.tsx +41 -13
  42. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +22 -67
  43. package/src/client/components/mobile/mobile-session-sidebar/ItemMenu.tsx +110 -0
  44. package/src/client/components/settings/Modal.tsx +9 -3
  45. package/src/client/components/settings/ProjectSelectorDropdown.tsx +19 -9
  46. package/src/client/components/settings/SettingsSidebarList.tsx +20 -0
  47. package/src/client/components/settings/categories/AgentSettings.tsx +38 -44
  48. package/src/client/components/settings/categories/CommandSettings.tsx +2 -2
  49. package/src/client/components/settings/categories/McpSettings.tsx +4 -21
  50. package/src/client/components/settings/categories/OmpSettings.tsx +147 -194
  51. package/src/client/components/settings/categories/ProjectSettings.tsx +122 -156
  52. package/src/client/components/settings/categories/SkillCatalogSettings.tsx +220 -260
  53. package/src/client/components/settings/categories/SkillSettings.tsx +8 -5
  54. package/src/client/components/settings/categories/TokenUsageSettings.tsx +211 -229
  55. package/src/client/components/settings/categories/agent-settings/DetailPane.tsx +229 -237
  56. package/src/client/components/settings/categories/agent-settings/ModelPicker.tsx +71 -0
  57. package/src/client/components/settings/categories/agent-settings/SidebarList.tsx +14 -2
  58. package/src/client/components/settings/categories/agent-settings/levels.ts +38 -0
  59. package/src/client/components/settings/categories/behavior-settings/Editor.tsx +27 -7
  60. package/src/client/components/settings/categories/chat-settings/ToolRenderSection.tsx +23 -5
  61. package/src/client/components/settings/categories/command-settings/DetailPane.tsx +75 -33
  62. package/src/client/components/settings/categories/command-settings/SidebarList.tsx +7 -0
  63. package/src/client/components/settings/categories/mcp-settings/DetailPane.tsx +91 -76
  64. package/src/client/components/settings/categories/mcp-settings/EnvVarsSection.tsx +83 -0
  65. package/src/client/components/settings/categories/mcp-settings/ImportModal.tsx +26 -13
  66. package/src/client/components/settings/categories/mcp-settings/SidebarList.tsx +20 -0
  67. package/src/client/components/settings/categories/omp-settings/ConfigTabs.tsx +97 -36
  68. package/src/client/components/settings/categories/omp-settings/EngineHeader.tsx +151 -0
  69. package/src/client/components/settings/categories/omp-settings/ExtensionsPanel.tsx +68 -32
  70. package/src/client/components/settings/categories/omp-settings/OrderedChips.tsx +119 -0
  71. package/src/client/components/settings/categories/omp-settings/PresetBar.tsx +14 -7
  72. package/src/client/components/settings/categories/omp-settings/RoleEditor.tsx +15 -6
  73. package/src/client/components/settings/categories/omp-settings/RowEditor.tsx +165 -226
  74. package/src/client/components/settings/categories/omp-settings/types.ts +28 -0
  75. package/src/client/components/settings/categories/project-settings/AccentPalette.test.tsx +189 -0
  76. package/src/client/components/settings/categories/project-settings/AccentPalette.tsx +156 -24
  77. package/src/client/components/settings/categories/project-settings/AddProjectModal.tsx +175 -0
  78. package/src/client/components/settings/categories/project-settings/DeleteProjectModal.tsx +107 -0
  79. package/src/client/components/settings/categories/project-settings/DetailsForm.tsx +40 -24
  80. package/src/client/components/settings/categories/project-settings/DetailsHeader.tsx +17 -7
  81. package/src/client/components/settings/categories/project-settings/IconGrid.tsx +164 -69
  82. package/src/client/components/settings/categories/project-settings/ModelDropdown.test.tsx +122 -0
  83. package/src/client/components/settings/categories/project-settings/ModelDropdown.tsx +124 -53
  84. package/src/client/components/settings/categories/project-settings/NameInput.tsx +57 -11
  85. package/src/client/components/settings/categories/project-settings/PathField.tsx +122 -0
  86. package/src/client/components/settings/categories/project-settings/SidebarList.tsx +100 -59
  87. package/src/client/components/settings/categories/skill-catalog/GitImportPanel.tsx +253 -0
  88. package/src/client/components/settings/categories/skill-catalog/SkillCard.tsx +89 -0
  89. package/src/client/components/settings/categories/skill-catalog/SourceRail.tsx +122 -0
  90. package/src/client/components/settings/categories/skill-catalog/catalog-ui.test.tsx +179 -0
  91. package/src/client/components/settings/categories/skill-settings/DetailHeader.tsx +236 -0
  92. package/src/client/components/settings/categories/skill-settings/DetailPane.tsx +164 -239
  93. package/src/client/components/settings/categories/skill-settings/InstructionsEditor.tsx +84 -0
  94. package/src/client/components/settings/categories/skill-settings/SidebarList.tsx +144 -87
  95. package/src/client/components/settings/categories/skill-settings/pane.test.tsx +188 -0
  96. package/src/client/components/settings/categories/skill-settings/row-meta.ts +58 -0
  97. package/src/client/components/settings/categories/token-usage-settings/Breakdown.tsx +242 -102
  98. package/src/client/components/settings/categories/token-usage-settings/Chart.tsx +130 -56
  99. package/src/client/components/settings/categories/token-usage-settings/Controls.tsx +135 -0
  100. package/src/client/components/settings/categories/token-usage-settings/MetricsGrid.tsx +55 -33
  101. package/src/client/components/settings/categories/token-usage-settings/Provenance.tsx +59 -0
  102. package/src/client/components/settings/categories/token-usage-settings/panel.test.tsx +239 -0
  103. package/src/client/components/workspace/browser-panel/Screencast.test.ts +1 -0
  104. package/src/client/components/workspace/browser-panel/Screencast.tsx +17 -22
  105. package/src/client/components/workspace/browser-panel/TabStrip.test.tsx +158 -0
  106. package/src/client/components/workspace/browser-panel/TabStrip.tsx +90 -0
  107. package/src/client/components/workspace/browser-panel/index.tsx +50 -4
  108. package/src/client/components/workspace/browser-toolbar/index.tsx +41 -1
  109. package/src/client/components/workspace/chat-timeline/ThinkingSection.tsx +3 -1
  110. package/src/client/components/workspace/chat-timeline/ToolCallingSection.tsx +2 -0
  111. package/src/client/components/workspace/chat-timeline/block-chrome.test.tsx +13 -2
  112. package/src/client/components/workspace/chat-timeline/index.tsx +6 -1
  113. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.test.ts +88 -0
  114. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.tsx +24 -1
  115. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Proc.test.ts +46 -0
  116. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Proc.tsx +15 -6
  117. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.test.ts +34 -0
  118. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.tsx +5 -1
  119. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.test.ts +29 -0
  120. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.tsx +11 -3
  121. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ArtifactChip.tsx +7 -6
  122. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/card-header.test.ts +24 -1
  123. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/card-header.ts +6 -2
  124. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/Tui.test.tsx +237 -0
  125. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/Tui.tsx +191 -0
  126. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/styles.test.tsx +1 -1
  127. package/src/client/components/workspace/diff-panel/MergeDiffView.tsx +21 -7
  128. package/src/client/components/workspace/diff-panel/changes.test.ts +51 -0
  129. package/src/client/components/workspace/diff-panel/changes.ts +28 -12
  130. package/src/client/components/workspace/diff-panel/merge.test.ts +28 -0
  131. package/src/client/components/workspace/diff-panel/merge.ts +21 -1
  132. package/src/client/components/workspace/editor/Body.tsx +7 -0
  133. package/src/client/components/workspace/editor/FileDocument.tsx +15 -21
  134. package/src/client/components/workspace/editor/FilePane.tsx +12 -0
  135. package/src/client/components/workspace/editor/PreviewPane.tsx +70 -0
  136. package/src/client/components/workspace/editor/Toolbar.tsx +17 -1
  137. package/src/client/components/workspace/editor/index.tsx +25 -22
  138. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +14 -0
  139. package/src/client/components/workspace/editor/toolbar-clusters.tsx +12 -86
  140. package/src/client/components/workspace/editor/toolbar-toggle.tsx +53 -0
  141. package/src/client/components/workspace/editor/toolbar-write-clusters.tsx +112 -0
  142. package/src/client/components/workspace/editor/viewers/SvgPreview.tsx +18 -2
  143. package/src/client/components/workspace/editor/viewers/viewers.test.ts +39 -0
  144. package/src/client/components/workspace/file-explorer/ContextMenu.tsx +18 -5
  145. package/src/client/components/workspace/file-explorer/Modals.tsx +15 -1
  146. package/src/client/components/workspace/file-explorer/RowLabel.tsx +68 -0
  147. package/src/client/components/workspace/file-explorer/TreeItem.tsx +47 -57
  148. package/src/client/components/workspace/file-explorer/collapsed-chain.test.ts +167 -0
  149. package/src/client/components/workspace/file-explorer/drag-props.ts +42 -0
  150. package/src/client/components/workspace/file-explorer/drag.test.ts +43 -0
  151. package/src/client/components/workspace/file-explorer/index.tsx +21 -20
  152. package/src/client/components/workspace/git-panel/commit-modal.test.ts +5 -3
  153. package/src/client/components/workspace/user-browser-panel/AddressBar.tsx +5 -0
  154. package/src/client/components/workspace/user-browser-panel/AnnotateBar.test.tsx +201 -0
  155. package/src/client/components/workspace/user-browser-panel/AnnotateBar.tsx +112 -0
  156. package/src/client/components/workspace/user-browser-panel/AnnotateLayer.test.tsx +225 -0
  157. package/src/client/components/workspace/user-browser-panel/AnnotateLayer.tsx +217 -0
  158. package/src/client/components/workspace/user-browser-panel/AnnotateTarget.tsx +99 -0
  159. package/src/client/components/workspace/user-browser-panel/Frame.tsx +30 -1
  160. package/src/client/components/workspace/user-browser-panel/index.tsx +81 -2
  161. package/src/client/data/agent-data/builtin.ts +0 -10
  162. package/src/client/data/agent-data/orchestrator.ts +0 -45
  163. package/src/client/data/agent-data/specialist.ts +0 -100
  164. package/src/client/data/mock/token-usage.ts +170 -120
  165. package/src/client/data/settings/omp-schema.json +123 -4
  166. package/src/client/data/settings/project.ts +9 -28
  167. package/src/client/data/settings/skill.ts +6 -32
  168. package/src/client/hooks/browser/use-annotate.test.ts +143 -0
  169. package/src/client/hooks/browser/use-annotate.ts +98 -0
  170. package/src/client/hooks/browser/use-close-tab.test.ts +148 -0
  171. package/src/client/hooks/browser/use-close-tab.ts +67 -0
  172. package/src/client/hooks/browser/use-screencast.ts +13 -1
  173. package/src/client/hooks/chat/composer/browser-context.test.ts +117 -0
  174. package/src/client/hooks/chat/composer/browser-context.ts +40 -16
  175. package/src/client/hooks/chat/composer/items.test.ts +1 -1
  176. package/src/client/hooks/chat/composer/review-context.ts +38 -0
  177. package/src/client/hooks/chat/composer/use-draft.test.ts +132 -0
  178. package/src/client/hooks/chat/composer/use-draft.ts +31 -2
  179. package/src/client/hooks/chat/timeline/pending-model.ts +28 -0
  180. package/src/client/hooks/chat/timeline/row-window.test.ts +15 -2
  181. package/src/client/hooks/editor/use-document-annotations.ts +124 -0
  182. package/src/client/hooks/editor/use-editor-panel-ui.ts +52 -0
  183. package/src/client/hooks/editor/use-file-review-mode.ts +35 -0
  184. package/src/client/hooks/editor/use-preview-review.ts +148 -0
  185. package/src/client/hooks/settings/agents.ts +149 -0
  186. package/src/client/hooks/settings/crud-list.test.ts +28 -6
  187. package/src/client/hooks/settings/crud-list.ts +96 -57
  188. package/src/client/hooks/settings/omp-config.ts +164 -0
  189. package/src/client/hooks/settings/projects/index.ts +294 -0
  190. package/src/client/hooks/settings/projects.test.ts +237 -0
  191. package/src/client/hooks/settings/skill-catalog.ts +101 -9
  192. package/src/client/hooks/settings/skill-git-import.ts +153 -0
  193. package/src/client/hooks/settings/useTokenUsage.ts +125 -0
  194. package/src/client/hooks/settings/write-feedback.test.ts +104 -0
  195. package/src/client/hooks/settings/write-feedback.ts +63 -0
  196. package/src/client/hooks/shell/servers.test.ts +166 -0
  197. package/src/client/hooks/{desktop → shell}/servers.ts +17 -14
  198. package/src/client/hooks/ui/markdown-hydration.ts +125 -0
  199. package/src/client/hooks/ui/updates/index.test.ts +100 -1
  200. package/src/client/hooks/ui/updates/index.ts +50 -0
  201. package/src/client/hooks/ui/updates/notes.test.ts +138 -0
  202. package/src/client/hooks/ui/updates/notes.ts +57 -0
  203. package/src/client/hooks/ui/updates/shell-download.ts +1 -1
  204. package/src/client/hooks/ui/updates/shell-update.ts +2 -6
  205. package/src/client/hooks/workspace/file-row-drag.ts +41 -0
  206. package/src/client/hooks/workspace/file-tree-actions.ts +25 -1
  207. package/src/client/hooks/workspace/file-tree-edits.ts +23 -6
  208. package/src/client/hooks/workspace/root-drop-target.ts +77 -0
  209. package/src/client/hooks/workspace/unfolded-chains.ts +165 -0
  210. package/src/client/lib/browser/element-at.test.ts +229 -0
  211. package/src/client/lib/browser/element-at.ts +139 -0
  212. package/src/client/lib/desktop/dropped-paths.ts +1 -1
  213. package/src/client/lib/desktop/titlebar.test.ts +12 -3
  214. package/src/client/lib/desktop/titlebar.ts +1 -1
  215. package/src/client/lib/review/client.ts +73 -0
  216. package/src/client/lib/router/search-params.ts +42 -20
  217. package/src/client/lib/shell/desktop.ts +117 -0
  218. package/src/client/lib/shell/servers.ts +75 -0
  219. package/src/client/lib/shell/transport.ts +216 -0
  220. package/src/client/main.tsx +9 -0
  221. package/src/client/tailwind.css +65 -0
  222. package/src/server/lib/btw/lifecycle.server.ts +2 -2
  223. package/src/server/lib/db/schema.ts +7 -0
  224. package/src/server/lib/db/seed-terminal.test.ts +4 -0
  225. package/src/server/lib/fs/git-merge-conflict.test.ts +14 -1
  226. package/src/server/lib/omp/config/agent-definitions.test.ts +273 -0
  227. package/src/server/lib/omp/config/agents.ts +231 -61
  228. package/src/server/lib/omp/config/definitions.test.ts +9 -105
  229. package/src/server/lib/omp/config/extensions.ts +16 -7
  230. package/src/server/lib/omp/config/omp-config-files.test.ts +27 -0
  231. package/src/server/lib/omp/config/skill-sources.ts +49 -0
  232. package/src/server/lib/omp/config/skills-git-install.ts +155 -0
  233. package/src/server/lib/omp/config/skills-git-repo.ts +288 -0
  234. package/src/server/lib/omp/config/skills-git.test.ts +220 -0
  235. package/src/server/lib/omp/rpc/constants.test.ts +11 -0
  236. package/src/server/lib/omp/rpc/constants.ts +15 -0
  237. package/src/server/lib/omp/rpc/process.ts +11 -14
  238. package/src/server/lib/omp/rpc/session-commands.ts +6 -3
  239. package/src/server/lib/omp/rpc/utility-agent-dir.test.ts +134 -0
  240. package/src/server/lib/omp/rpc/utility-agent-dir.ts +138 -0
  241. package/src/server/lib/omp/rpc/utility.ts +12 -0
  242. package/src/server/lib/review/schema.server.ts +45 -0
  243. package/src/server/lib/review/store.server.ts +138 -0
  244. package/src/server/lib/terminal/attach-replay.test.ts +132 -0
  245. package/src/server/lib/terminal/output.test.ts +166 -0
  246. package/src/server/lib/terminal/output.ts +104 -0
  247. package/src/server/lib/terminal/runtime.server.ts +5 -0
  248. package/src/server/lib/terminal/send-result.test.ts +33 -0
  249. package/src/server/lib/terminal/send-result.ts +32 -0
  250. package/src/server/lib/terminal/session.server.ts +45 -11
  251. package/src/server/lib/terminal/store-liveness.test.ts +4 -0
  252. package/src/server/lib/updates/active-notes.test.ts +149 -0
  253. package/src/server/lib/updates/active-notes.ts +75 -0
  254. package/src/server/lib/updates/changelog-file.ts +42 -11
  255. package/src/server/lib/updates/changelog.test.ts +15 -1
  256. package/src/server/lib/updates/omp.ts +42 -15
  257. package/src/server/lib/updates/release-url.ts +27 -1
  258. package/src/server/lib/usage/index-parse.test.ts +200 -0
  259. package/src/server/lib/usage/index-parse.ts +178 -0
  260. package/src/server/lib/usage/index-query.server.ts +248 -0
  261. package/src/server/lib/usage/index-scan.server.ts +343 -0
  262. package/src/server/lib/usage/index-schema.server.ts +82 -0
  263. package/src/server/lib/usage/index.test.ts +234 -0
  264. package/src/server/lib/usage/providers.server.ts +4 -53
  265. package/src/server/lib/workspace/project-model.server.test.ts +102 -0
  266. package/src/server/lib/workspace/project-model.server.ts +47 -0
  267. package/src/server/lib/workspace/project-patch.server.ts +156 -0
  268. package/src/server/routes/agent/new.ts +8 -1
  269. package/src/server/routes/browser/index.ts +3 -0
  270. package/src/server/routes/browser/stream.ts +31 -2
  271. package/src/server/routes/browser/tabs.test.ts +94 -0
  272. package/src/server/routes/browser/tabs.ts +85 -0
  273. package/src/server/routes/index.ts +2 -0
  274. package/src/server/routes/review/bindings.ts +11 -0
  275. package/src/server/routes/review/index.ts +127 -0
  276. package/src/server/routes/review/routes.test.ts +191 -0
  277. package/src/server/routes/settings/agents.test.ts +180 -0
  278. package/src/server/routes/settings/agents.ts +99 -94
  279. package/src/server/routes/settings/mcp.test.ts +135 -0
  280. package/src/server/routes/settings/mcp.ts +14 -6
  281. package/src/server/routes/settings/projects.ts +53 -19
  282. package/src/server/routes/settings/settings-projects-routes.test.ts +214 -0
  283. package/src/server/routes/settings/settings-store-routes.test.ts +11 -115
  284. package/src/server/routes/settings/skills-catalog-actions.ts +195 -0
  285. package/src/server/routes/settings/skills.test.ts +225 -0
  286. package/src/server/routes/settings/skills.ts +18 -15
  287. package/src/server/routes/telemetry/tokens.test.ts +145 -0
  288. package/src/server/routes/telemetry/tokens.ts +70 -149
  289. package/src/server/routes/terminal/ws.ts +6 -5
  290. package/src/server/routes/updates/index.ts +2 -0
  291. package/src/server/routes/updates/notes.ts +34 -0
  292. package/src/server/routes/updates/routes.test.ts +49 -0
  293. package/src/shared/lib/browser/annotate.test.ts +283 -0
  294. package/src/shared/lib/browser/annotate.ts +231 -0
  295. package/src/shared/lib/browser/browser-viewer.test.ts +26 -4
  296. package/src/shared/lib/browser/frame-gate.test.ts +91 -0
  297. package/src/shared/lib/browser/frame-gate.ts +69 -0
  298. package/src/shared/lib/browser/frame-params.test.ts +43 -0
  299. package/src/shared/lib/browser/frame-params.ts +60 -0
  300. package/src/shared/lib/browser/frame-pipeline.test.ts +132 -0
  301. package/src/shared/lib/browser/frame-pipeline.ts +80 -0
  302. package/src/shared/lib/browser/page-context.ts +60 -4
  303. package/src/shared/lib/browser/snapshot.test.ts +115 -0
  304. package/src/shared/lib/browser/snapshot.ts +112 -0
  305. package/src/shared/lib/browser/tab-close.test.ts +74 -0
  306. package/src/shared/lib/browser/tab-close.ts +77 -0
  307. package/src/shared/lib/browser/viewer.ts +45 -26
  308. package/src/shared/lib/chat/timeline/block-chrome.ts +19 -0
  309. package/src/shared/lib/chat/timeline/tool-render-mode.ts +17 -4
  310. package/src/shared/lib/chat/tool/artifact.ts +55 -20
  311. package/src/shared/lib/chat/tool/bash-facts.ts +96 -0
  312. package/src/shared/lib/chat/tool/minimized.test.ts +98 -0
  313. package/src/shared/lib/chat/tool/minimized.ts +64 -0
  314. package/src/shared/lib/chat/tool/summary.test.ts +28 -8
  315. package/src/shared/lib/chat/tool/summary.ts +3 -32
  316. package/src/shared/lib/fs/folder-chain.test.ts +81 -1
  317. package/src/shared/lib/fs/folder-chain.ts +84 -0
  318. package/src/shared/lib/markdown/blocks/anchor.ts +63 -0
  319. package/src/shared/lib/markdown/blocks/blocks.test.ts +141 -0
  320. package/src/shared/lib/markdown/blocks/renderer.ts +120 -0
  321. package/src/shared/lib/markdown/blocks/scan.ts +100 -0
  322. package/src/shared/lib/markdown/blocks/types.ts +62 -0
  323. package/src/shared/lib/markdown/marked.ts +58 -147
  324. package/src/shared/lib/markdown/math-extensions.ts +168 -0
  325. package/src/shared/lib/markdown/review/prompt.ts +77 -0
  326. package/src/shared/lib/markdown/review/reconcile.ts +55 -0
  327. package/src/shared/lib/markdown/review/review.test.ts +96 -0
  328. package/src/shared/lib/markdown/xml-sections.test.ts +140 -0
  329. package/src/shared/lib/markdown/xml-sections.ts +139 -0
  330. package/src/shared/lib/models/provider/label.ts +57 -0
  331. package/src/shared/lib/omp/config/agent-file.test.ts +54 -0
  332. package/src/shared/lib/omp/config/agent-file.ts +43 -0
  333. package/src/shared/lib/omp/config/row-value.test.ts +95 -0
  334. package/src/shared/lib/omp/config/row-value.ts +97 -0
  335. package/src/shared/lib/omp/config/schema.test.ts +66 -0
  336. package/src/shared/lib/omp/config/schema.ts +6 -0
  337. package/src/shared/lib/omp/rpc/frame.test.ts +48 -47
  338. package/src/shared/lib/omp/rpc/frame.ts +49 -40
  339. package/src/shared/lib/omp/session/job-progress.test.ts +37 -1
  340. package/src/shared/lib/omp/session/job-progress.ts +31 -0
  341. package/src/shared/lib/omp/session/proc.ts +5 -0
  342. package/src/shared/lib/omp/session/wait.ts +5 -0
  343. package/src/shared/lib/ui/menu-anchor.test.ts +69 -0
  344. package/src/shared/lib/ui/menu-anchor.ts +89 -0
  345. package/src/shared/lib/ui/mobile-overlay.ts +61 -0
  346. package/src/shared/lib/ui/svg-scope.test.ts +97 -0
  347. package/src/shared/lib/ui/svg-scope.ts +134 -0
  348. package/src/shared/lib/usage/breakdown.test.ts +197 -0
  349. package/src/shared/lib/usage/breakdown.ts +241 -0
  350. package/src/shared/lib/usage/range.test.ts +204 -0
  351. package/src/shared/lib/usage/range.ts +240 -0
  352. package/src/shared/lib/usage/view.test.ts +85 -0
  353. package/src/shared/lib/usage/view.ts +74 -0
  354. package/src/shared/lib/workspace/project-accent.test.ts +69 -0
  355. package/src/shared/lib/workspace/project-accent.ts +63 -0
  356. package/src/shared/lib/workspace/project-icon.ts +40 -0
  357. package/src/shared/lib/workspace/project-model.test.ts +79 -0
  358. package/src/shared/lib/workspace/project-model.ts +64 -0
  359. package/src/shared/types/browser.ts +78 -0
  360. package/src/shared/types/index.ts +1 -0
  361. package/src/shared/types/settings/agent.ts +28 -6
  362. package/src/shared/types/settings/skill.ts +53 -3
  363. package/src/shared/types/settings/state.ts +4 -3
  364. package/src/shared/types/settings/write.ts +6 -0
  365. package/src/shared/types/tokenUsage.ts +128 -21
  366. package/src/shared/types/updates.ts +20 -0
  367. package/src/test-support/file-explorer-disk.test-util.ts +25 -1
  368. package/src/test-support/file-explorer-drag.test-util.ts +88 -0
  369. package/src/test-support/file-explorer.test-util.ts +47 -47
  370. package/dist/client/static/js/index-fjnq2z2d.css +0 -1
  371. package/src/client/components/common/code-surface/indent-guide.ts +0 -104
  372. package/src/client/components/common/server-switcher/index.test.tsx +0 -150
  373. package/src/client/components/settings/categories/skill-catalog/AddSourceModal.tsx +0 -133
  374. package/src/client/hooks/desktop/servers.test.ts +0 -73
  375. package/src/client/lib/desktop/bridge.ts +0 -203
  376. package/src/server/lib/omp/session/usage/aggregate-shaping.test.ts +0 -149
  377. package/src/server/lib/omp/session/usage/aggregate.test.ts +0 -243
  378. package/src/server/lib/omp/session/usage/aggregate.ts +0 -330
  379. package/src/server/lib/omp/session/usage/shaping.ts +0 -130
  380. package/src/shared/lib/code/editor/indent-guide-rule.test.ts +0 -65
  381. package/src/shared/lib/code/editor/indent-guide-rule.ts +0 -47
@@ -1,264 +1,246 @@
1
-
2
- import { useCallback, useEffect, useRef, useState } from 'preact/hooks';
3
- import { Check, ChevronDown, RefreshCw } from 'lucide-preact';
4
- import type { BreakdownTab, CadenceType, ChartMetric, ChartSeriesPoint, SettingsState, TimeRangeType } from '@/shared/types';
1
+ import { useMemo, useState } from 'preact/hooks';
2
+ import type {
3
+ BreakdownTab,
4
+ BucketGranularity,
5
+ ChartMetric,
6
+ SettingsState,
7
+ TimeRangeType,
8
+ UsageTotals,
9
+ } from '@/shared/types';
10
+ import { TokenUsageControls } from '@/client/components/settings/categories/token-usage-settings/Controls';
5
11
  import { TokenUsageMetricsGrid } from '@/client/components/settings/categories/token-usage-settings/MetricsGrid';
6
- import { TokenUsageBreakdown } from '@/client/components/settings/categories/token-usage-settings/Breakdown';
7
12
  import { UsageChart } from '@/client/components/settings/categories/token-usage-settings/Chart';
8
- import { useOnClickOutside } from '@/client/hooks/ui/on-click-outside';
13
+ import { TokenUsageBreakdown } from '@/client/components/settings/categories/token-usage-settings/Breakdown';
14
+ import { UsageProvenance } from '@/client/components/settings/categories/token-usage-settings/Provenance';
15
+ import { useTokenUsage } from '@/client/hooks/settings/useTokenUsage';
16
+ import { breakdownRows, bucketDays } from '@/shared/lib/usage/breakdown';
17
+ import { cacheHitLabel, costLabel, tokenLabel } from '@/shared/lib/usage/view';
18
+ import { dayWindow, granularityFor, localDayKey, spanOfDays } from '@/shared/lib/usage/range';
9
19
 
10
20
  interface TokenUsageSettingsProps {
11
21
  settings: SettingsState;
12
22
  onUpdate: (updater: Partial<SettingsState> | ((prev: SettingsState) => SettingsState)) => void;
13
23
  }
14
24
 
25
+ const CHART_METRICS: Array<{ id: ChartMetric; label: string }> = [
26
+ { id: 'cost', label: 'COST' },
27
+ { id: 'tokens', label: 'TOKENS' },
28
+ ];
29
+
30
+ /** What each period option is called in prose, for the cost card's caption. */
31
+ const PERIOD_NAME: Record<TimeRangeType, string> = {
32
+ today: 'Day',
33
+ '7d': 'Week',
34
+ '30d': 'Month',
35
+ '90d': '90 days',
36
+ all: 'All time',
37
+ custom: 'Custom',
38
+ };
39
+
40
+ /**
41
+ * Settings → Token Usage.
42
+ *
43
+ * ONE period control. Day, Week, Month, 90 days, All time and Custom are the
44
+ * same kind of choice — which trailing span to report — so there is no separate
45
+ * daily/weekly/monthly switch, and every figure on the panel is that span's
46
+ * total. The only thing derived from the period is how the chart and the time
47
+ * tab bucket it (`granularityFor`): a day or a month draws days, a quarter
48
+ * draws weeks, all time draws months.
49
+ */
15
50
  export function TokenUsageSettings({ settings: _settings, onUpdate: _onUpdate }: TokenUsageSettingsProps) {
16
- const [cadence, setCadence] = useState<CadenceType>('daily');
17
- const [timeRange, setTimeRange] = useState<TimeRangeType>('30d');
18
- const [isDropdownOpen, setIsDropdownOpen] = useState(false);
19
- const [chartMetric, setChartMetric] = useState<ChartMetric>('cost');
20
- const [breakdownTab, setBreakdownTab] = useState<BreakdownTab>('model');
21
- const [isRefreshing, setIsRefreshing] = useState(false);
22
- const today = new Date().toISOString().slice(0, 10);
23
- const monthAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10);
24
- const [customFrom, setCustomFrom] = useState(monthAgo);
51
+ const [range, setRange] = useState<TimeRangeType>('30d');
52
+ const [tab, setTab] = useState<BreakdownTab>('model');
53
+ const [metric, setMetric] = useState<ChartMetric>('cost');
54
+ const [today] = useState(() => localDayKey(Date.now()));
55
+ const [customFrom, setCustomFrom] = useState(() => localDayKey(Date.now() - 29 * 24 * 60 * 60 * 1000));
25
56
  const [customTo, setCustomTo] = useState(today);
57
+ // Providers hidden from the chart, by slug.
58
+ const [hiddenProviders, setHiddenProviders] = useState<Set<string>>(new Set());
59
+
60
+ const { payload, error, loading, refreshing, reload } = useTokenUsage(range, { from: customFrom, to: customTo });
61
+
62
+ const providers = payload?.providers ?? [];
63
+ const totals: UsageTotals = payload?.totals ?? ZERO_TOTALS;
64
+ const granularity: BucketGranularity = granularityFor(range, { from: customFrom, to: customTo });
65
+ // The period's own days, INCLUDING the ones the rollup never saw: the table
66
+ // lists the period, not just the days that happened to carry usage. All time
67
+ // has no bounded window, so its span comes from the recorded days themselves.
68
+ const window = useMemo(
69
+ () =>
70
+ dayWindow(range, payload?.generatedAt ?? Date.now(), { from: customFrom, to: customTo }) ??
71
+ spanOfDays((payload?.days ?? []).map((row) => row.day)),
72
+ [range, payload?.generatedAt, payload?.days, customFrom, customTo],
73
+ );
74
+ const buckets = useMemo(() => bucketDays(payload?.days ?? [], granularity), [payload?.days, granularity]);
75
+ const rows = useMemo(
76
+ () =>
77
+ payload
78
+ ? breakdownRows(
79
+ tab,
80
+ { totals, providers: payload.providers, days: payload.days, projects: payload.projects },
81
+ granularity,
82
+ window,
83
+ )
84
+ : [],
85
+ [tab, payload, totals, granularity, window],
86
+ );
87
+ const providerNames = useMemo(
88
+ () => Object.fromEntries(providers.map((provider) => [provider.id, provider.name])),
89
+ [providers],
90
+ );
91
+ const visibleProviders = useMemo(
92
+ () => new Set(providers.filter((provider) => !hiddenProviders.has(provider.id)).map((provider) => provider.id)),
93
+ [providers, hiddenProviders],
94
+ );
26
95
 
27
- const [timeRanges, setTimeRanges] = useState<any[]>([]);
28
- const [activeMetrics, setActiveMetrics] = useState<any>(null);
29
- const [activeBreakdownRows, setActiveBreakdownRows] = useState<any[]>([]);
30
- const [chartSeries, setChartSeries] = useState<ChartSeriesPoint[]>([]);
31
-
32
- const dropdownRef = useRef<HTMLDivElement>(null);
33
-
34
- useOnClickOutside(dropdownRef, () => setIsDropdownOpen(false));
35
-
36
- const loadData = useCallback(() => {
37
- setIsRefreshing(true);
38
- const customParams = timeRange === 'custom' ? `&customFrom=${customFrom}&customTo=${customTo}` : '';
39
- fetch(`/api/telemetry/tokens?timeRange=${timeRange}&breakdownTab=${breakdownTab}&cadence=${cadence}${customParams}`)
40
- .then(res => res.json())
41
- .then(data => {
42
- if (data.timeRanges) setTimeRanges(data.timeRanges);
43
- if (data.metrics) setActiveMetrics(data.metrics);
44
- if (data.breakdownRows) setActiveBreakdownRows(data.breakdownRows);
45
- if (data.chartSeries) setChartSeries(data.chartSeries);
46
- })
47
- .catch(err => console.error('Failed to load token telemetry:', err))
48
- .finally(() => setIsRefreshing(false));
49
- }, [timeRange, breakdownTab, cadence, customFrom, customTo]);
50
-
51
- useEffect(() => {
52
- loadData();
53
- }, [loadData]);
54
-
55
- const handleRefresh = () => {
56
- loadData();
57
- };
58
-
59
- const selectedRangeObj = timeRanges.find((r) => r.id === timeRange) || timeRanges[0] || { id: timeRange, label: timeRange, dateRange: 'Current Period' };
60
- const periodLabel = timeRange === 'custom'
61
- ? `${customFrom} to ${customTo}`
62
- : selectedRangeObj.dateRange;
63
-
64
- if (!activeMetrics) {
96
+ if (error && !payload) {
65
97
  return (
66
- <div className="flex items-center justify-center p-8 text-ink/40 text-xs">
67
- Loading token usage telemetry...
98
+ <div className="mx-auto max-w-md space-y-3 py-10 text-center">
99
+ <p className="text-xs font-semibold text-ink">Token usage could not be read</p>
100
+ <p className="text-[11px] text-ink/60">{error}</p>
101
+ <button
102
+ type="button"
103
+ onClick={() => reload(true)}
104
+ className="rounded-md border border-ink/15 bg-paper px-3 py-1 text-[11px] font-medium text-ink hover:bg-ink/5"
105
+ >
106
+ Retry
107
+ </button>
68
108
  </div>
69
109
  );
70
110
  }
71
111
 
72
- return (
73
- <div className="w-full space-y-4 text-ink pb-2 text-xs">
74
- {/* Filter and Controls Bar */}
75
- <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-3 pb-3 border-b border-ink/10">
76
- <div className="flex items-center gap-2">
77
- <span className="text-xs font-semibold text-ink/75">{periodLabel}</span>
112
+ if (loading || !payload) {
113
+ return (
114
+ <div className="space-y-3" aria-busy="true">
115
+ <div className="h-8 w-full animate-pulse rounded-md bg-ink/5" />
116
+ <div className="grid grid-cols-1 gap-3 xl:grid-cols-3">
117
+ <div className="h-28 animate-pulse rounded-lg bg-ink/5 xl:col-span-2" />
118
+ <div className="h-28 animate-pulse rounded-lg bg-ink/5" />
78
119
  </div>
79
- <div className="flex flex-wrap items-center gap-2">
80
- {/* Cadence Switcher: Daily -> Weekly -> Monthly */}
81
- <div className="flex items-center bg-paper border border-ink/15 rounded-md text-[11px] font-medium overflow-hidden">
82
- <button
83
- onClick={() => setCadence('daily')}
84
- className={`px-2.5 py-1 transition-colors ${
85
- cadence === 'daily' ? 'bg-ink/10 text-ink font-semibold' : 'text-ink/65 hover:bg-ink/5 hover:text-ink'
86
- }`}
87
- >
88
- Daily
89
- </button>
90
- <button
91
- onClick={() => setCadence('weekly')}
92
- className={`px-2.5 py-1 transition-colors ${
93
- cadence === 'weekly' ? 'bg-ink/10 text-ink font-semibold' : 'text-ink/65 hover:bg-ink/5 hover:text-ink'
94
- }`}
95
- >
96
- Weekly
97
- </button>
98
- <button
99
- onClick={() => setCadence('monthly')}
100
- className={`px-2.5 py-1 transition-colors ${
101
- cadence === 'monthly' ? 'bg-ink/10 text-ink font-semibold' : 'text-ink/65 hover:bg-ink/5 hover:text-ink'
102
- }`}
103
- >
104
- Monthly
105
- </button>
106
- </div>
107
-
108
- {/* Time Range Dropdown */}
109
- <div className="relative" ref={dropdownRef}>
110
- <button
111
- onClick={() => setIsDropdownOpen(!isDropdownOpen)}
112
- className="flex items-center gap-1.5 px-2.5 py-1 bg-paper border border-ink/15 rounded-md text-[11px] font-medium hover:bg-ink/5 text-ink/80 transition-colors"
113
- >
114
- <span>{selectedRangeObj.label}</span>
115
- <ChevronDown size={12} className={`transition-transform duration-150 ${isDropdownOpen ? 'rotate-180' : ''}`} />
116
- </button>
120
+ <div className="h-52 animate-pulse rounded-lg bg-ink/5" />
121
+ <p className="text-center text-[10px] text-ink/40">Indexing session transcripts…</p>
122
+ </div>
123
+ );
124
+ }
117
125
 
118
- {isDropdownOpen && (
119
- <div className="absolute right-0 top-full mt-1 w-44 bg-paper border border-ink/15 rounded-md shadow-lg z-30 py-1 text-[11px] divide-y divide-ink/5">
120
- {timeRanges.map((range) => (
121
- <button
122
- key={range.id}
123
- onClick={() => {
124
- setTimeRange(range.id);
125
- if (range.id !== 'custom') setIsDropdownOpen(false);
126
- }}
127
- className={`w-full flex items-center justify-between px-3 py-1.5 text-left hover:bg-ink/5 transition-colors ${
128
- timeRange === range.id ? 'font-semibold text-ink bg-ink/5' : 'text-ink/70'
129
- }`}
130
- >
131
- <span>{range.label}</span>
132
- {timeRange === range.id && <Check size={12} className="text-ink" />}
133
- </button>
134
- ))}
135
- {timeRange === 'custom' && (
136
- <div className="px-3 py-2 space-y-2">
137
- <label className="block">
138
- <span className="text-[9px] font-mono uppercase tracking-wider text-ink/40">From</span>
139
- <input
140
- type="date"
141
- value={customFrom}
142
- max={customTo}
143
- onChange={(e) => setCustomFrom(e.currentTarget.value)}
144
- className="mt-0.5 w-full bg-paper border border-ink/15 rounded px-1.5 py-1 text-[11px] text-ink focus:outline-none focus:border-ink/40"
145
- />
146
- </label>
147
- <label className="block">
148
- <span className="text-[9px] font-mono uppercase tracking-wider text-ink/40">To</span>
149
- <input
150
- type="date"
151
- value={customTo}
152
- min={customFrom}
153
- max={today}
154
- onChange={(e) => setCustomTo(e.currentTarget.value)}
155
- className="mt-0.5 w-full bg-paper border border-ink/15 rounded px-1.5 py-1 text-[11px] text-ink focus:outline-none focus:border-ink/40"
156
- />
157
- </label>
158
- <button
159
- onClick={() => setIsDropdownOpen(false)}
160
- className="w-full bg-ink/10 hover:bg-ink/20 text-ink font-semibold rounded px-2 py-1 transition-colors"
161
- >
162
- Apply
163
- </button>
164
- </div>
165
- )}
166
- </div>
167
- )}
168
- </div>
126
+ return (
127
+ <div className="w-full space-y-4 pb-2 text-xs text-ink">
128
+ <TokenUsageControls
129
+ range={range}
130
+ onRange={setRange}
131
+ ranges={payload.timeRanges}
132
+ customFrom={customFrom}
133
+ customTo={customTo}
134
+ onCustomFrom={setCustomFrom}
135
+ onCustomTo={setCustomTo}
136
+ periodLabel={payload.periodLabel}
137
+ generatedAt={payload.generatedAt}
138
+ refreshing={refreshing}
139
+ onRefresh={() => reload(true)}
140
+ />
169
141
 
170
- {/* Refresh Button */}
142
+ {error && (
143
+ // A failed refresh keeps the last good numbers on screen — but it says
144
+ // so, because a stale figure presented as current is a wrong figure.
145
+ <div
146
+ role="status"
147
+ className="flex flex-wrap items-center justify-between gap-2 rounded-md border border-[var(--theme-error)]/40 bg-[var(--theme-error)]/5 px-3 py-1.5 text-[11px]"
148
+ >
149
+ <span className="text-ink/75">Showing the last successful read. {error}</span>
171
150
  <button
172
- onClick={handleRefresh}
173
- className="p-1.5 bg-paper border border-ink/15 rounded-md hover:bg-ink/5 text-ink/80 transition-colors"
174
- title="Refresh Token Telemetry"
151
+ type="button"
152
+ onClick={() => reload(true)}
153
+ className="rounded border border-ink/15 bg-paper px-2 py-0.5 font-medium text-ink hover:bg-ink/5"
175
154
  >
176
- <RefreshCw size={12} className={isRefreshing ? 'animate-spin text-ink' : ''} />
155
+ Retry
177
156
  </button>
178
157
  </div>
179
- </div>
180
-
181
- {/* Top Section: Cost & Chart */}
182
- <div className="grid grid-cols-1 xl:grid-cols-2 gap-3">
183
- {/* Raw Token Cost */}
184
- <div className="bg-paper border border-ink/15 rounded-lg p-3.5 shadow-xs flex flex-col justify-between">
185
- <div>
186
- <div className="text-[10px] font-mono font-semibold text-ink/40 tracking-wider uppercase mb-2">
187
- USAGECONFIG.RAWTOKENCOST
188
- </div>
189
- <div className="flex items-baseline gap-1 mb-0.5">
190
- <span className="text-2xl font-bold tracking-tight text-ink">{activeMetrics.rawCost}</span>
191
- <span className="text-xs font-semibold text-ink/50">*</span>
192
- </div>
193
- <p className="text-[11px] text-ink/50 mb-4">* if billed at full API rate</p>
158
+ )}
159
+
160
+ <TokenUsageMetricsGrid totals={totals} periodName={PERIOD_NAME[range]} />
161
+
162
+ <div className="rounded-lg border border-ink/15 bg-paper p-3.5 shadow-xs">
163
+ <div className="mb-3 flex flex-wrap items-start justify-between gap-2">
164
+ <div className="flex flex-wrap items-center gap-2">
165
+ <span className="text-xs font-semibold capitalize text-ink">{metric} by provider</span>
166
+ <span className="text-[10px] text-ink/45">
167
+ {buckets.length} {granularity} {buckets.length === 1 ? 'bucket' : 'buckets'} · click a legend entry to hide
168
+ it
169
+ </span>
194
170
  </div>
195
-
196
- <div>
197
- <div className="h-1.5 w-full bg-ink/10 rounded-full mb-2 overflow-hidden flex">
198
- <div className="h-full bg-ink/80 rounded-full" style={{ width: '100%' }}></div>
199
- </div>
200
- <div className="flex items-center justify-between text-[11px]">
201
- <div className="flex items-center gap-1.5">
202
- <div className="w-2 h-2 rounded-full bg-ink/80"></div>
203
- <span className="font-semibold text-ink">DeepSeek</span>
204
- </div>
205
- <div className="flex items-center gap-3 text-ink/70">
206
- <span className="font-bold text-ink">{activeMetrics.rawCost}</span>
207
- <span>100.0% share</span>
208
- <span>{activeMetrics.processedTokens}</span>
209
- </div>
210
- </div>
171
+ <div role="tablist" aria-label="Chart metric" className="flex rounded bg-ink/5 p-0.5">
172
+ {CHART_METRICS.map((entry) => (
173
+ <button
174
+ key={entry.id}
175
+ type="button"
176
+ role="tab"
177
+ aria-selected={metric === entry.id}
178
+ onClick={() => setMetric(entry.id)}
179
+ className={`rounded px-2 py-0.5 text-[9px] font-bold tracking-wider transition-colors ${
180
+ metric === entry.id ? 'bg-paper text-ink shadow-xs' : 'text-ink/50 hover:text-ink'
181
+ }`}
182
+ >
183
+ {entry.label}
184
+ </button>
185
+ ))}
211
186
  </div>
212
187
  </div>
213
188
 
214
- {/* Cost / Token Chart */}
215
- <div className="bg-paper border border-ink/15 rounded-lg p-3.5 shadow-xs flex flex-col">
216
- <div className="flex justify-between items-start mb-3">
217
- <div className="flex items-center gap-2">
218
- <span className="font-semibold text-xs text-ink capitalize">{cadence} {chartMetric}</span>
219
- <div className="flex items-center gap-1">
220
- <div className="w-1.5 h-1.5 rounded-full bg-ink/80"></div>
221
- <span className="text-[11px] text-ink/60">DeepSeek</span>
222
- </div>
223
- </div>
224
- <div className="flex bg-ink/5 rounded p-0.5">
225
- <button
226
- onClick={() => setChartMetric('cost')}
227
- className={`px-2 py-0.5 rounded text-[9px] font-bold tracking-wider transition-colors ${
228
- chartMetric === 'cost' ? 'bg-paper shadow-xs text-ink' : 'text-ink/50 hover:text-ink'
229
- }`}
230
- >
231
- COST
232
- </button>
233
- <button
234
- onClick={() => setChartMetric('tokens')}
235
- className={`px-2 py-0.5 rounded text-[9px] font-bold tracking-wider transition-colors ${
236
- chartMetric === 'tokens' ? 'bg-paper shadow-xs text-ink' : 'text-ink/50 hover:text-ink'
237
- }`}
238
- >
239
- TOKENS
240
- </button>
241
- </div>
242
- </div>
243
- <UsageChart cadence={cadence} metric={chartMetric} series={chartSeries} />
189
+ <UsageChart
190
+ buckets={buckets}
191
+ metric={metric}
192
+ granularity={granularity}
193
+ providers={providers.map((provider) => ({ id: provider.id, name: provider.name }))}
194
+ visible={visibleProviders}
195
+ onToggle={(id) =>
196
+ setHiddenProviders((current) => {
197
+ const next = new Set(current);
198
+ if (next.has(id)) next.delete(id);
199
+ else next.add(id);
200
+ return next;
201
+ })
202
+ }
203
+ />
244
204
  </div>
245
- </div>
246
-
247
- {/* Grid of 5 Stats (Aligned & Symmetrical) */}
248
- <TokenUsageMetricsGrid activeMetrics={activeMetrics} />
249
205
 
250
- {/* Bottom Section: Breakdown & Cost Quality */}
251
206
  <TokenUsageBreakdown
252
- breakdownTab={breakdownTab}
253
- setBreakdownTab={setBreakdownTab}
254
- activeBreakdownRows={activeBreakdownRows}
255
- activeMetrics={activeMetrics}
256
- cadence={cadence}
207
+ tab={tab}
208
+ onTab={setTab}
209
+ rows={rows}
210
+ totals={totals}
211
+ granularity={granularity}
212
+ providerNames={providerNames}
257
213
  />
258
214
 
259
- <div className="text-center text-[10px] text-ink/40 pt-2">
260
- Scanned {activeMetrics.scannedTranscripts} transcripts (1 outside the window) · {activeMetrics.usageRecords} usage records · 0.1s
261
- </div>
215
+ <UsageProvenance index={payload.index} generatedAt={payload.generatedAt} providers={providers.length} />
216
+
217
+ <details className="rounded-lg border border-ink/10 bg-ink/[0.02] px-3 py-2 text-[10px] text-ink/50">
218
+ <summary className="cursor-pointer select-none font-semibold text-ink/60">How these numbers are produced</summary>
219
+ <ul className="mt-2 space-y-1 leading-relaxed">
220
+ <li>
221
+ Cost and tokens are omp's own per-message records, attributed to the provider and model that served the
222
+ turn. A turn without a reported rate is counted as unpriced, never as free.
223
+ </li>
224
+ <li>
225
+ Cache hit rate is cache reads over all observed input. “Paid for cache reads” is what those reads cost, not
226
+ what they saved.
227
+ </li>
228
+ <li>
229
+ Each transcript is read once; later requests re-read only the bytes appended since. Clearing Kabmo's
230
+ database rebuilds the index from the session files.
231
+ </li>
232
+ <li>
233
+ {totals.records.toLocaleString('en-US')} turns in this period · {tokenLabel(totals.tokens)} tokens ·{' '}
234
+ {cacheHitLabel(totals)} cached · {costLabel(totals.cost)} at API rates · {providers.length}{' '}
235
+ {providers.length === 1 ? 'provider' : 'providers'}
236
+ </li>
237
+ </ul>
238
+ </details>
262
239
  </div>
263
240
  );
264
241
  }
242
+
243
+ const ZERO_TOTALS: UsageTotals = {
244
+ cost: 0, tokens: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0,
245
+ cacheReadCost: 0, records: 0, unpriced: 0, activeDays: 0,
246
+ };