@kabmo-labs/kabmo 0.17.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 (269) hide show
  1. package/dist/client/index.html +1 -1
  2. package/dist/client/index.js +538 -457
  3. package/dist/client/static/js/index-hp75vsv9.css +1 -0
  4. package/dist/client/static/js/{index-rerjq5th.js → index-tc09dtca.js} +823 -814
  5. package/package.json +1 -1
  6. package/src/client/components/common/MarkdownRenderer.tsx +136 -89
  7. package/src/client/components/common/anchored-menu/index.test.tsx +141 -0
  8. package/src/client/components/common/anchored-menu/index.tsx +143 -0
  9. package/src/client/components/common/markdown-review/ReviewPopover.tsx +144 -0
  10. package/src/client/components/common/markdown-review/ReviewSummary.tsx +108 -0
  11. package/src/client/components/common/markdown-review/index.tsx +129 -0
  12. package/src/client/components/common/server-control/Panel.tsx +33 -23
  13. package/src/client/components/common/server-control/index.test.tsx +11 -5
  14. package/src/client/components/common/server-control/index.tsx +10 -8
  15. package/src/client/components/layout/session-sidebar/CategoryHeader.tsx +42 -21
  16. package/src/client/components/layout/session-sidebar/CategoryHeader.worktree.test.tsx +36 -17
  17. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +8 -7
  18. package/src/client/components/layout/session-sidebar/about-modal/NotesDialog.tsx +94 -0
  19. package/src/client/components/layout/session-sidebar/about-modal/VersionLine.test.tsx +68 -0
  20. package/src/client/components/layout/session-sidebar/about-modal/VersionLine.tsx +36 -0
  21. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +57 -34
  22. package/src/client/components/layout/session-sidebar/modern/WorkspaceHeader.tsx +28 -10
  23. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +7 -6
  24. package/src/client/components/layout/session-sidebar/modern/workspace-header.test.tsx +1 -1
  25. package/src/client/components/layout/update-popup/ReleaseNotes.tsx +8 -3
  26. package/src/client/components/layout/update-popup/index.tsx +5 -1
  27. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +13 -15
  28. package/src/client/components/mobile/mobile-right-sidebar/Header.tsx +23 -1
  29. package/src/client/components/mobile/mobile-right-sidebar/MissingFileBanner.tsx +30 -0
  30. package/src/client/components/mobile/mobile-right-sidebar/PreviewScroller.tsx +18 -2
  31. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +22 -67
  32. package/src/client/components/mobile/mobile-session-sidebar/ItemMenu.tsx +110 -0
  33. package/src/client/components/settings/SettingsSidebarList.tsx +20 -0
  34. package/src/client/components/settings/categories/AgentSettings.tsx +23 -50
  35. package/src/client/components/settings/categories/CommandSettings.tsx +2 -2
  36. package/src/client/components/settings/categories/McpSettings.tsx +4 -21
  37. package/src/client/components/settings/categories/OmpSettings.tsx +147 -194
  38. package/src/client/components/settings/categories/SkillSettings.tsx +2 -2
  39. package/src/client/components/settings/categories/TokenUsageSettings.tsx +211 -229
  40. package/src/client/components/settings/categories/agent-settings/DetailPane.tsx +229 -237
  41. package/src/client/components/settings/categories/agent-settings/ModelPicker.tsx +71 -0
  42. package/src/client/components/settings/categories/agent-settings/SidebarList.tsx +9 -2
  43. package/src/client/components/settings/categories/agent-settings/levels.ts +38 -0
  44. package/src/client/components/settings/categories/behavior-settings/Editor.tsx +27 -7
  45. package/src/client/components/settings/categories/chat-settings/ToolRenderSection.tsx +23 -5
  46. package/src/client/components/settings/categories/command-settings/DetailPane.tsx +75 -33
  47. package/src/client/components/settings/categories/command-settings/SidebarList.tsx +7 -0
  48. package/src/client/components/settings/categories/mcp-settings/DetailPane.tsx +91 -76
  49. package/src/client/components/settings/categories/mcp-settings/EnvVarsSection.tsx +83 -0
  50. package/src/client/components/settings/categories/mcp-settings/ImportModal.tsx +26 -13
  51. package/src/client/components/settings/categories/mcp-settings/SidebarList.tsx +20 -0
  52. package/src/client/components/settings/categories/omp-settings/ConfigTabs.tsx +97 -36
  53. package/src/client/components/settings/categories/omp-settings/EngineHeader.tsx +151 -0
  54. package/src/client/components/settings/categories/omp-settings/ExtensionsPanel.tsx +68 -32
  55. package/src/client/components/settings/categories/omp-settings/OrderedChips.tsx +119 -0
  56. package/src/client/components/settings/categories/omp-settings/PresetBar.tsx +14 -7
  57. package/src/client/components/settings/categories/omp-settings/RoleEditor.tsx +15 -6
  58. package/src/client/components/settings/categories/omp-settings/RowEditor.tsx +165 -226
  59. package/src/client/components/settings/categories/omp-settings/types.ts +28 -0
  60. package/src/client/components/settings/categories/skill-settings/DetailHeader.tsx +35 -7
  61. package/src/client/components/settings/categories/skill-settings/DetailPane.tsx +34 -14
  62. package/src/client/components/settings/categories/skill-settings/SidebarList.tsx +21 -0
  63. package/src/client/components/settings/categories/skill-settings/pane.test.tsx +15 -6
  64. package/src/client/components/settings/categories/token-usage-settings/Breakdown.tsx +242 -102
  65. package/src/client/components/settings/categories/token-usage-settings/Chart.tsx +130 -56
  66. package/src/client/components/settings/categories/token-usage-settings/Controls.tsx +135 -0
  67. package/src/client/components/settings/categories/token-usage-settings/MetricsGrid.tsx +55 -33
  68. package/src/client/components/settings/categories/token-usage-settings/Provenance.tsx +59 -0
  69. package/src/client/components/settings/categories/token-usage-settings/panel.test.tsx +239 -0
  70. package/src/client/components/workspace/browser-panel/Screencast.test.ts +1 -0
  71. package/src/client/components/workspace/browser-panel/Screencast.tsx +17 -22
  72. package/src/client/components/workspace/browser-panel/TabStrip.test.tsx +158 -0
  73. package/src/client/components/workspace/browser-panel/TabStrip.tsx +90 -0
  74. package/src/client/components/workspace/browser-panel/index.tsx +50 -4
  75. package/src/client/components/workspace/browser-toolbar/index.tsx +41 -1
  76. package/src/client/components/workspace/chat-timeline/ThinkingSection.tsx +3 -1
  77. package/src/client/components/workspace/chat-timeline/ToolCallingSection.tsx +2 -0
  78. package/src/client/components/workspace/chat-timeline/block-chrome.test.tsx +13 -2
  79. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.test.ts +88 -0
  80. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Bash.tsx +24 -1
  81. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.test.ts +34 -0
  82. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Read.tsx +5 -1
  83. package/src/client/components/workspace/chat-timeline/tool-renderers/shared/ArtifactChip.tsx +7 -6
  84. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/Tui.test.tsx +237 -0
  85. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/Tui.tsx +191 -0
  86. package/src/client/components/workspace/chat-timeline/tool-renderers/styles/styles.test.tsx +1 -1
  87. package/src/client/components/workspace/diff-panel/MergeDiffView.tsx +21 -7
  88. package/src/client/components/workspace/diff-panel/changes.test.ts +51 -0
  89. package/src/client/components/workspace/diff-panel/changes.ts +28 -12
  90. package/src/client/components/workspace/diff-panel/merge.test.ts +28 -0
  91. package/src/client/components/workspace/diff-panel/merge.ts +21 -1
  92. package/src/client/components/workspace/editor/Body.tsx +7 -0
  93. package/src/client/components/workspace/editor/FileDocument.tsx +15 -21
  94. package/src/client/components/workspace/editor/FilePane.tsx +12 -0
  95. package/src/client/components/workspace/editor/PreviewPane.tsx +70 -0
  96. package/src/client/components/workspace/editor/Toolbar.tsx +17 -1
  97. package/src/client/components/workspace/editor/index.tsx +25 -22
  98. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +14 -0
  99. package/src/client/components/workspace/editor/toolbar-clusters.tsx +12 -86
  100. package/src/client/components/workspace/editor/toolbar-toggle.tsx +53 -0
  101. package/src/client/components/workspace/editor/toolbar-write-clusters.tsx +112 -0
  102. package/src/client/components/workspace/git-panel/commit-modal.test.ts +5 -3
  103. package/src/client/components/workspace/user-browser-panel/AddressBar.tsx +5 -0
  104. package/src/client/components/workspace/user-browser-panel/AnnotateBar.test.tsx +201 -0
  105. package/src/client/components/workspace/user-browser-panel/AnnotateBar.tsx +112 -0
  106. package/src/client/components/workspace/user-browser-panel/AnnotateLayer.test.tsx +225 -0
  107. package/src/client/components/workspace/user-browser-panel/AnnotateLayer.tsx +217 -0
  108. package/src/client/components/workspace/user-browser-panel/AnnotateTarget.tsx +99 -0
  109. package/src/client/components/workspace/user-browser-panel/Frame.tsx +30 -1
  110. package/src/client/components/workspace/user-browser-panel/index.tsx +81 -2
  111. package/src/client/data/agent-data/builtin.ts +0 -10
  112. package/src/client/data/agent-data/orchestrator.ts +0 -45
  113. package/src/client/data/agent-data/specialist.ts +0 -100
  114. package/src/client/data/mock/token-usage.ts +170 -120
  115. package/src/client/data/settings/omp-schema.json +33 -1
  116. package/src/client/hooks/browser/use-annotate.test.ts +143 -0
  117. package/src/client/hooks/browser/use-annotate.ts +98 -0
  118. package/src/client/hooks/browser/use-close-tab.test.ts +148 -0
  119. package/src/client/hooks/browser/use-close-tab.ts +67 -0
  120. package/src/client/hooks/browser/use-screencast.ts +13 -1
  121. package/src/client/hooks/chat/composer/browser-context.test.ts +117 -0
  122. package/src/client/hooks/chat/composer/browser-context.ts +40 -16
  123. package/src/client/hooks/chat/composer/items.test.ts +1 -1
  124. package/src/client/hooks/chat/composer/review-context.ts +38 -0
  125. package/src/client/hooks/chat/composer/use-draft.test.ts +132 -0
  126. package/src/client/hooks/chat/composer/use-draft.ts +31 -2
  127. package/src/client/hooks/chat/timeline/row-window.test.ts +15 -2
  128. package/src/client/hooks/editor/use-document-annotations.ts +124 -0
  129. package/src/client/hooks/editor/use-editor-panel-ui.ts +52 -0
  130. package/src/client/hooks/editor/use-file-review-mode.ts +35 -0
  131. package/src/client/hooks/editor/use-preview-review.ts +148 -0
  132. package/src/client/hooks/settings/agents.ts +149 -0
  133. package/src/client/hooks/settings/crud-list.test.ts +28 -6
  134. package/src/client/hooks/settings/crud-list.ts +96 -57
  135. package/src/client/hooks/settings/omp-config.ts +164 -0
  136. package/src/client/hooks/settings/useTokenUsage.ts +125 -0
  137. package/src/client/hooks/settings/write-feedback.test.ts +104 -0
  138. package/src/client/hooks/settings/write-feedback.ts +63 -0
  139. package/src/client/hooks/ui/markdown-hydration.ts +125 -0
  140. package/src/client/hooks/ui/updates/index.test.ts +100 -1
  141. package/src/client/hooks/ui/updates/index.ts +50 -0
  142. package/src/client/hooks/ui/updates/notes.test.ts +138 -0
  143. package/src/client/hooks/ui/updates/notes.ts +57 -0
  144. package/src/client/lib/browser/element-at.test.ts +229 -0
  145. package/src/client/lib/browser/element-at.ts +139 -0
  146. package/src/client/lib/review/client.ts +73 -0
  147. package/src/client/lib/router/search-params.ts +42 -20
  148. package/src/client/tailwind.css +65 -0
  149. package/src/server/lib/btw/lifecycle.server.ts +2 -2
  150. package/src/server/lib/db/schema.ts +7 -0
  151. package/src/server/lib/db/seed-terminal.test.ts +4 -0
  152. package/src/server/lib/omp/config/agent-definitions.test.ts +273 -0
  153. package/src/server/lib/omp/config/agents.ts +231 -61
  154. package/src/server/lib/omp/config/definitions.test.ts +9 -105
  155. package/src/server/lib/omp/config/extensions.ts +16 -7
  156. package/src/server/lib/omp/config/omp-config-files.test.ts +27 -0
  157. package/src/server/lib/omp/rpc/constants.test.ts +11 -0
  158. package/src/server/lib/omp/rpc/constants.ts +15 -0
  159. package/src/server/lib/omp/rpc/process.ts +11 -14
  160. package/src/server/lib/omp/rpc/session-commands.ts +6 -3
  161. package/src/server/lib/omp/rpc/utility-agent-dir.test.ts +134 -0
  162. package/src/server/lib/omp/rpc/utility-agent-dir.ts +138 -0
  163. package/src/server/lib/omp/rpc/utility.ts +12 -0
  164. package/src/server/lib/review/schema.server.ts +45 -0
  165. package/src/server/lib/review/store.server.ts +138 -0
  166. package/src/server/lib/terminal/attach-replay.test.ts +132 -0
  167. package/src/server/lib/terminal/output.test.ts +166 -0
  168. package/src/server/lib/terminal/output.ts +104 -0
  169. package/src/server/lib/terminal/runtime.server.ts +5 -0
  170. package/src/server/lib/terminal/send-result.test.ts +33 -0
  171. package/src/server/lib/terminal/send-result.ts +32 -0
  172. package/src/server/lib/terminal/session.server.ts +45 -11
  173. package/src/server/lib/terminal/store-liveness.test.ts +4 -0
  174. package/src/server/lib/updates/active-notes.test.ts +149 -0
  175. package/src/server/lib/updates/active-notes.ts +75 -0
  176. package/src/server/lib/updates/changelog-file.ts +42 -11
  177. package/src/server/lib/updates/changelog.test.ts +15 -1
  178. package/src/server/lib/updates/omp.ts +42 -15
  179. package/src/server/lib/updates/release-url.ts +27 -1
  180. package/src/server/lib/usage/index-parse.test.ts +200 -0
  181. package/src/server/lib/usage/index-parse.ts +178 -0
  182. package/src/server/lib/usage/index-query.server.ts +248 -0
  183. package/src/server/lib/usage/index-scan.server.ts +343 -0
  184. package/src/server/lib/usage/index-schema.server.ts +82 -0
  185. package/src/server/lib/usage/index.test.ts +234 -0
  186. package/src/server/lib/usage/providers.server.ts +4 -53
  187. package/src/server/routes/browser/index.ts +3 -0
  188. package/src/server/routes/browser/stream.ts +31 -2
  189. package/src/server/routes/browser/tabs.test.ts +94 -0
  190. package/src/server/routes/browser/tabs.ts +85 -0
  191. package/src/server/routes/index.ts +2 -0
  192. package/src/server/routes/review/bindings.ts +11 -0
  193. package/src/server/routes/review/index.ts +127 -0
  194. package/src/server/routes/review/routes.test.ts +191 -0
  195. package/src/server/routes/settings/agents.test.ts +180 -0
  196. package/src/server/routes/settings/agents.ts +95 -102
  197. package/src/server/routes/settings/mcp.test.ts +135 -0
  198. package/src/server/routes/settings/mcp.ts +14 -6
  199. package/src/server/routes/settings/settings-store-routes.test.ts +6 -113
  200. package/src/server/routes/telemetry/tokens.test.ts +145 -0
  201. package/src/server/routes/telemetry/tokens.ts +70 -149
  202. package/src/server/routes/terminal/ws.ts +6 -5
  203. package/src/server/routes/updates/index.ts +2 -0
  204. package/src/server/routes/updates/notes.ts +34 -0
  205. package/src/server/routes/updates/routes.test.ts +49 -0
  206. package/src/shared/lib/browser/annotate.test.ts +283 -0
  207. package/src/shared/lib/browser/annotate.ts +231 -0
  208. package/src/shared/lib/browser/browser-viewer.test.ts +26 -4
  209. package/src/shared/lib/browser/frame-gate.test.ts +91 -0
  210. package/src/shared/lib/browser/frame-gate.ts +69 -0
  211. package/src/shared/lib/browser/frame-params.test.ts +43 -0
  212. package/src/shared/lib/browser/frame-params.ts +60 -0
  213. package/src/shared/lib/browser/frame-pipeline.test.ts +132 -0
  214. package/src/shared/lib/browser/frame-pipeline.ts +80 -0
  215. package/src/shared/lib/browser/page-context.ts +60 -4
  216. package/src/shared/lib/browser/snapshot.test.ts +115 -0
  217. package/src/shared/lib/browser/snapshot.ts +112 -0
  218. package/src/shared/lib/browser/tab-close.test.ts +74 -0
  219. package/src/shared/lib/browser/tab-close.ts +77 -0
  220. package/src/shared/lib/browser/viewer.ts +45 -26
  221. package/src/shared/lib/chat/timeline/block-chrome.ts +19 -0
  222. package/src/shared/lib/chat/timeline/tool-render-mode.ts +17 -4
  223. package/src/shared/lib/chat/tool/artifact.ts +55 -20
  224. package/src/shared/lib/chat/tool/bash-facts.ts +96 -0
  225. package/src/shared/lib/chat/tool/minimized.test.ts +98 -0
  226. package/src/shared/lib/chat/tool/minimized.ts +64 -0
  227. package/src/shared/lib/chat/tool/summary.test.ts +28 -8
  228. package/src/shared/lib/chat/tool/summary.ts +3 -32
  229. package/src/shared/lib/markdown/blocks/anchor.ts +63 -0
  230. package/src/shared/lib/markdown/blocks/blocks.test.ts +141 -0
  231. package/src/shared/lib/markdown/blocks/renderer.ts +120 -0
  232. package/src/shared/lib/markdown/blocks/scan.ts +100 -0
  233. package/src/shared/lib/markdown/blocks/types.ts +62 -0
  234. package/src/shared/lib/markdown/marked.ts +58 -147
  235. package/src/shared/lib/markdown/math-extensions.ts +168 -0
  236. package/src/shared/lib/markdown/review/prompt.ts +77 -0
  237. package/src/shared/lib/markdown/review/reconcile.ts +55 -0
  238. package/src/shared/lib/markdown/review/review.test.ts +96 -0
  239. package/src/shared/lib/markdown/xml-sections.test.ts +140 -0
  240. package/src/shared/lib/markdown/xml-sections.ts +139 -0
  241. package/src/shared/lib/models/provider/label.ts +57 -0
  242. package/src/shared/lib/omp/config/agent-file.test.ts +54 -0
  243. package/src/shared/lib/omp/config/agent-file.ts +43 -0
  244. package/src/shared/lib/omp/config/row-value.test.ts +95 -0
  245. package/src/shared/lib/omp/config/row-value.ts +97 -0
  246. package/src/shared/lib/omp/config/schema.test.ts +31 -0
  247. package/src/shared/lib/omp/config/schema.ts +6 -0
  248. package/src/shared/lib/omp/rpc/frame.test.ts +48 -47
  249. package/src/shared/lib/omp/rpc/frame.ts +49 -40
  250. package/src/shared/lib/ui/menu-anchor.test.ts +69 -0
  251. package/src/shared/lib/ui/menu-anchor.ts +89 -0
  252. package/src/shared/lib/usage/breakdown.test.ts +197 -0
  253. package/src/shared/lib/usage/breakdown.ts +241 -0
  254. package/src/shared/lib/usage/range.test.ts +204 -0
  255. package/src/shared/lib/usage/range.ts +240 -0
  256. package/src/shared/lib/usage/view.test.ts +85 -0
  257. package/src/shared/lib/usage/view.ts +74 -0
  258. package/src/shared/types/browser.ts +78 -0
  259. package/src/shared/types/index.ts +1 -0
  260. package/src/shared/types/settings/agent.ts +28 -6
  261. package/src/shared/types/settings/state.ts +4 -3
  262. package/src/shared/types/settings/write.ts +6 -0
  263. package/src/shared/types/tokenUsage.ts +128 -21
  264. package/src/shared/types/updates.ts +20 -0
  265. package/dist/client/static/js/index-3ve31rzx.css +0 -1
  266. package/src/server/lib/omp/session/usage/aggregate-shaping.test.ts +0 -149
  267. package/src/server/lib/omp/session/usage/aggregate.test.ts +0 -243
  268. package/src/server/lib/omp/session/usage/aggregate.ts +0 -330
  269. package/src/server/lib/omp/session/usage/shaping.ts +0 -130
@@ -1,74 +1,148 @@
1
- import type { ChartMetric, ChartSeriesPoint } from '@/shared/types';
2
- import { formatCompactTokens, formatCost } from '@/shared/lib/format/number';
1
+ import type { ChartMetric } from '@/shared/types';
2
+ import type { CadenceBucket } from '@/shared/lib/usage/breakdown';
3
+ import { costLabel, tokenLabel } from '@/shared/lib/usage/view';
4
+
5
+ /** Ink ramp, strongest first. Chroma stays reserved for the error state. */
6
+ const SERIES_FILL = [
7
+ 'var(--theme-ink)',
8
+ 'color-mix(in oklab, var(--theme-ink) 72%, transparent)',
9
+ 'color-mix(in oklab, var(--theme-ink) 54%, transparent)',
10
+ 'color-mix(in oklab, var(--theme-ink) 38%, transparent)',
11
+ 'color-mix(in oklab, var(--theme-ink) 26%, transparent)',
12
+ 'color-mix(in oklab, var(--theme-ink) 16%, transparent)',
13
+ ] as const;
14
+
15
+ export interface ChartProvider {
16
+ id: string;
17
+ name: string;
18
+ }
3
19
 
4
20
  interface UsageChartProps {
5
- cadence: string;
21
+ buckets: CadenceBucket[];
6
22
  metric: ChartMetric;
7
- series: ChartSeriesPoint[];
23
+ providers: ChartProvider[];
24
+ /** Providers currently drawn; a legend click toggles one. */
25
+ visible: ReadonlySet<string>;
26
+ onToggle: (id: string) => void;
27
+ /** `day`/`week`/`month` — the period's own bucket width, for the aria label. */
28
+ granularity: string;
8
29
  }
9
30
 
10
- function buildPath(series: ChartSeriesPoint[], values: number[], max: number): string {
11
- if (series.length === 0) return '';
12
- if (series.length === 1) return 'M0,98 L100,98';
13
- const span = max > 0 ? max : 1;
14
- return series
15
- .map((_, index) => {
16
- const x = (index / (series.length - 1)) * 100;
17
- const y = 98 - (values[index] / span) * 94;
18
- return `${index === 0 ? 'M' : 'L'}${x.toFixed(2)},${y.toFixed(2)}`;
19
- })
20
- .join(' ');
31
+ function valueOf(bucket: CadenceBucket, metric: ChartMetric, provider: string): number {
32
+ const split = bucket.byProvider[provider];
33
+ if (!split) return 0;
34
+ return metric === 'cost' ? split.cost : split.tokens;
21
35
  }
22
36
 
23
- export function UsageChart({ cadence, metric, series }: UsageChartProps) {
24
- const values = series.map((p) => (metric === 'cost' ? p.cost : p.tokens));
25
- const max = values.length > 0 ? Math.max(...values) : 0;
26
- const path = buildPath(series, values, max);
27
- const axisMax = metric === 'cost' ? formatCost(max) || '$0.00' : formatCompactTokens(max) ?? '0';
28
- const axisMid = metric === 'cost' ? formatCost(max / 2) || '$0.00' : formatCompactTokens(max / 2) ?? '0';
29
- const first = series[0]?.label ?? '';
30
- const mid = series.length > 2 ? series[Math.floor(series.length / 2)]?.label ?? '' : '';
31
- const last = series.length > 1 ? series[series.length - 1]?.label ?? '' : '';
32
-
33
- if (series.length === 0) {
37
+ /**
38
+ * Stacked area, one band per provider.
39
+ *
40
+ * The bands are the point: a single line of the total cannot show that two
41
+ * accounts serving the same model id are 95% / 4% of the bill. Bars would need
42
+ * the same vertical budget and read worse at 30+ buckets, so bands reuse the
43
+ * existing axis layout.
44
+ */
45
+ export function UsageChart({ buckets, metric, providers, visible, onToggle, granularity }: UsageChartProps) {
46
+ const drawn = providers.filter((provider) => visible.has(provider.id));
47
+ if (buckets.length === 0) {
34
48
  return (
35
- <div className="h-28 flex items-center justify-center text-[11px] text-ink/40">
36
- No usage data in this period
49
+ <div className="flex h-32 items-center justify-center text-[11px] text-ink/40">
50
+ No usage recorded in this period.
37
51
  </div>
38
52
  );
39
53
  }
40
54
 
55
+ // Cumulative totals per bucket, in legend order, so a band's top edge is the
56
+ // sum of every band below it.
57
+ const cumulative: number[][] = [];
58
+ let running = new Array(buckets.length).fill(0) as number[];
59
+ for (const provider of drawn) {
60
+ running = running.map((value, index) => value + valueOf(buckets[index], metric, provider.id));
61
+ cumulative.push(running);
62
+ }
63
+ const max = Math.max(...running, 0);
64
+ const span = max > 0 ? max : 1;
65
+ const x = (index: number) => (buckets.length === 1 ? 0 : (index / (buckets.length - 1)) * 100);
66
+ const y = (value: number) => 98 - (value / span) * 94;
67
+ const format = (value: number) => (metric === 'cost' ? costLabel(value) : tokenLabel(value));
68
+
69
+ /** A provider's total for the whole period — the only figure it has. */
70
+ const providerTotal = (providerId: string): number =>
71
+ buckets.reduce((sum, bucket) => sum + valueOf(bucket, metric, providerId), 0);
72
+
73
+ const bandPath = (band: number): string => {
74
+ const top = cumulative[band];
75
+ const base = band === 0 ? (new Array(buckets.length).fill(0) as number[]) : cumulative[band - 1];
76
+ const up = top.map((value, index) => `${index === 0 ? 'M' : 'L'}${x(index).toFixed(2)},${y(value).toFixed(2)}`);
77
+ const down = [...base].reverse().map((value, index) => `L${x(buckets.length - 1 - index).toFixed(2)},${y(value).toFixed(2)}`);
78
+ return `${up.join(' ')} ${down.join(' ')} Z`;
79
+ };
80
+
41
81
  return (
42
- <div className="h-28 relative">
43
- <div className="absolute inset-0 flex flex-col justify-between pt-1 pb-4">
44
- <div className="border-t border-ink/5 w-full border-dashed"></div>
45
- <div className="border-t border-ink/5 w-full border-dashed"></div>
46
- <div className="border-t border-ink/15 w-full"></div>
82
+ <div className="flex flex-col gap-2">
83
+ <div className="relative h-32">
84
+ <div className="absolute inset-0 flex flex-col justify-between pb-4 pt-1">
85
+ <div className="w-full border-t border-dashed border-ink/5" />
86
+ <div className="w-full border-t border-dashed border-ink/5" />
87
+ <div className="w-full border-t border-ink/15" />
88
+ </div>
89
+ <div className="absolute bottom-4 left-0 top-0 flex w-10 flex-col justify-between font-mono text-[9px] text-ink/40">
90
+ <span>{format(max)}</span>
91
+ <span>{format(max / 2)}</span>
92
+ <span>0</span>
93
+ </div>
94
+ <div className="absolute bottom-4 left-10 right-0 top-0">
95
+ <svg
96
+ className="h-full w-full"
97
+ preserveAspectRatio="none"
98
+ viewBox="0 0 100 100"
99
+ role="img"
100
+ aria-label={`${metric} by provider, bucketed by ${granularity}`}
101
+ >
102
+ {drawn.map((provider, band) => (
103
+ <path
104
+ key={provider.id}
105
+ d={bandPath(band)}
106
+ fill={SERIES_FILL[providers.indexOf(provider) % SERIES_FILL.length]}
107
+ stroke="none"
108
+ />
109
+ ))}
110
+ </svg>
111
+ </div>
112
+ <div className="absolute bottom-0 left-10 right-0 flex h-4 items-end justify-between text-[9px] text-ink/40">
113
+ <span>{buckets[0]?.label}</span>
114
+ {buckets.length > 2 && <span>{buckets[Math.floor(buckets.length / 2)]?.label}</span>}
115
+ {/* One bucket would otherwise print the same label twice. */}
116
+ {buckets.length > 1 && <span>{buckets[buckets.length - 1]?.label}</span>}
117
+ </div>
47
118
  </div>
48
- <div className="absolute left-0 top-0 bottom-4 flex flex-col justify-between text-[9px] font-mono text-ink/40 w-9">
49
- <span>{axisMax}</span>
50
- <span>{axisMid}</span>
51
- <span>0</span>
52
- </div>
53
- <div className="absolute left-10 right-0 bottom-4 top-0 flex items-end">
54
- <svg className="w-full h-full" preserveAspectRatio="none" viewBox="0 0 100 100">
55
- <path
56
- d={path}
57
- fill="none"
58
- stroke="currentColor"
59
- className="text-ink/60 transition-all duration-300"
60
- strokeWidth="1.5"
61
- strokeLinecap="round"
62
- strokeLinejoin="round"
63
- />
64
- </svg>
65
- </div>
66
- <div className="absolute left-10 right-0 bottom-0 h-4 flex justify-between text-[9px] text-ink/40 items-end">
67
- <span>{first}</span>
68
- {mid && <span>{mid}</span>}
69
- <span>{last}</span>
119
+
120
+ <div className="flex flex-wrap items-center gap-x-3 gap-y-1">
121
+ {providers.map((provider) => {
122
+ const active = visible.has(provider.id);
123
+ const figure = providerTotal(provider.id);
124
+ return (
125
+ <button
126
+ key={provider.id}
127
+ type="button"
128
+ aria-pressed={active}
129
+ onClick={() => onToggle(provider.id)}
130
+ className={`flex items-center gap-1.5 text-[10px] transition-opacity ${
131
+ active ? 'text-ink/70' : 'line-through text-ink/35'
132
+ } hover:text-ink`}
133
+ title={`${provider.name}: ${format(figure)} in this period`}
134
+ >
135
+ <span
136
+ aria-hidden="true"
137
+ className="h-1.5 w-1.5 rounded-full"
138
+ style={{ background: SERIES_FILL[providers.indexOf(provider) % SERIES_FILL.length] }}
139
+ />
140
+ <span className="font-medium">{provider.name}</span>
141
+ <span className="font-mono tabular-nums text-ink/45">{format(figure)}</span>
142
+ </button>
143
+ );
144
+ })}
70
145
  </div>
71
- <span className="sr-only">{`${cadence} ${metric} trend`}</span>
72
146
  </div>
73
147
  );
74
148
  }
@@ -0,0 +1,135 @@
1
+ import { useState } from 'preact/hooks';
2
+ import { CalendarRange, RefreshCw } from 'lucide-preact';
3
+ import { localDayKey } from '@/shared/lib/usage/range';
4
+ import type { TimeRangeOption, TimeRangeType } from '@/shared/types';
5
+
6
+ interface TokenUsageControlsProps {
7
+ range: TimeRangeType;
8
+ onRange: (range: TimeRangeType) => void;
9
+ ranges: TimeRangeOption[];
10
+ customFrom: string;
11
+ customTo: string;
12
+ onCustomFrom: (value: string) => void;
13
+ onCustomTo: (value: string) => void;
14
+ periodLabel: string;
15
+ /** Epoch ms the payload was generated; the custom window is relative to it. */
16
+ generatedAt: number;
17
+ refreshing: boolean;
18
+ onRefresh: () => void;
19
+ }
20
+
21
+ /**
22
+ * The panel's control bar: the PERIOD, and refresh.
23
+ *
24
+ * Day / Week / Month / 90 days / All time / Custom are one list — they are all
25
+ * the same kind of choice (which trailing span to report), so the panel has a
26
+ * single control and no separate daily/weekly/monthly switch. Every figure in
27
+ * the panel is the total for the span selected here.
28
+ */
29
+ export function TokenUsageControls({
30
+ range,
31
+ onRange,
32
+ ranges,
33
+ customFrom,
34
+ customTo,
35
+ onCustomFrom,
36
+ onCustomTo,
37
+ periodLabel,
38
+ generatedAt,
39
+ refreshing,
40
+ onRefresh,
41
+ }: TokenUsageControlsProps) {
42
+ const [open, setOpen] = useState(false);
43
+ // "Today" is the day the PAYLOAD was built on, so the picker's ceiling cannot
44
+ // drift from the dates the panel is showing (a tab left open across midnight).
45
+ const ceiling = localDayKey(generatedAt);
46
+
47
+ return (
48
+ <div className="flex flex-col gap-2 border-b border-ink/10 pb-3 sm:flex-row sm:items-center sm:justify-between">
49
+ <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-0.5">
50
+ <span className="truncate text-xs font-semibold text-ink/75">{periodLabel}</span>
51
+ {refreshing && <span className="text-[10px] text-ink/40">updating…</span>}
52
+ </div>
53
+
54
+ <div className="flex flex-wrap items-center gap-2">
55
+ <div className="relative min-w-0 flex-1 sm:flex-none">
56
+ <button
57
+ type="button"
58
+ aria-expanded={open}
59
+ onClick={() => setOpen((value) => !value)}
60
+ className="flex items-center gap-1.5 rounded-md border border-ink/15 bg-paper px-2.5 py-1 text-[11px] font-medium text-ink/80 transition-colors hover:bg-ink/5"
61
+ >
62
+ <CalendarRange size={12} aria-hidden="true" />
63
+ {/* A custom window names its dates: a bare "Custom…" is
64
+ indistinguishable from a range that did nothing when its dates
65
+ happen to equal the previous preset. */}
66
+ <span>
67
+ {range === 'custom'
68
+ ? `${customFrom} – ${customTo}`
69
+ : (ranges.find((entry) => entry.id === range)?.label ?? 'Month')}
70
+ </span>
71
+ </button>
72
+
73
+ {open && (
74
+ // Anchored LEFT on phones: the trigger fills the row there, and a
75
+ // `right-0` menu hung off its right edge landed at x=-157. From
76
+ // `sm` up the trigger is narrow and right-aligned, so the menu
77
+ // follows it.
78
+ <div className="absolute left-0 top-full z-30 mt-1 w-64 max-w-[calc(100vw-2rem)] divide-y divide-ink/5 rounded-md border border-ink/15 bg-paper py-1 text-[11px] shadow-lg sm:left-auto sm:right-0">
79
+ {ranges.map((entry) => (
80
+ <button
81
+ key={entry.id}
82
+ type="button"
83
+ aria-current={range === entry.id ? 'true' : undefined}
84
+ onClick={() => {
85
+ onRange(entry.id);
86
+ if (entry.id !== 'custom') setOpen(false);
87
+ }}
88
+ className={`flex w-full items-center justify-between gap-2 px-3 py-1.5 text-left transition-colors hover:bg-ink/5 ${
89
+ range === entry.id ? 'bg-ink/5 font-semibold text-ink' : 'text-ink/70'
90
+ }`}
91
+ >
92
+ <span className="truncate">{entry.label}</span>
93
+ <span className="shrink-0 text-[10px] text-ink/40">{entry.dateRange}</span>
94
+ </button>
95
+ ))}
96
+
97
+ {range === 'custom' && (
98
+ <div className="space-y-2 px-3 py-2">
99
+ {(
100
+ [
101
+ { label: 'From', value: customFrom, set: onCustomFrom, min: undefined, max: customTo },
102
+ { label: 'To', value: customTo, set: onCustomTo, min: customFrom, max: ceiling },
103
+ ] as const
104
+ ).map((field) => (
105
+ <label key={field.label} className="block">
106
+ <span className="text-[9px] font-mono uppercase tracking-wider text-ink/40">{field.label}</span>
107
+ <input
108
+ type="date"
109
+ value={field.value}
110
+ min={field.min}
111
+ max={field.max}
112
+ onChange={(event) => field.set(event.currentTarget.value)}
113
+ className="mt-0.5 w-full rounded border border-ink/15 bg-paper px-1.5 py-1 text-[11px] text-ink focus:border-ink/40 focus:outline-none"
114
+ />
115
+ </label>
116
+ ))}
117
+ </div>
118
+ )}
119
+ </div>
120
+ )}
121
+ </div>
122
+
123
+ <button
124
+ type="button"
125
+ onClick={onRefresh}
126
+ title="Refresh token usage"
127
+ aria-label="Refresh token usage"
128
+ className="rounded-md border border-ink/15 bg-paper p-1.5 text-ink/80 transition-colors hover:bg-ink/5"
129
+ >
130
+ <RefreshCw size={12} className={refreshing ? 'animate-spin' : ''} aria-hidden="true" />
131
+ </button>
132
+ </div>
133
+ </div>
134
+ );
135
+ }
@@ -1,44 +1,66 @@
1
- import type { TokenUsageMetricSet } from '@/shared/types';
1
+ import type { UsageTotals } from '@/shared/types';
2
2
  import { StatCard } from '@/client/components/common/StatCard';
3
+ import { cacheHitLabel, costLabel, costPerMillionLabel, toMetricSet } from '@/shared/lib/usage/view';
3
4
 
4
5
  interface TokenUsageMetricsGridProps {
5
- activeMetrics: TokenUsageMetricSet;
6
+ totals: UsageTotals;
7
+ /** Human period label (`Day`, `Week`, `Month`, …) for the cost caption. */
8
+ periodName: string;
6
9
  }
7
10
 
8
- export function TokenUsageMetricsGrid({ activeMetrics }: TokenUsageMetricsGridProps) {
9
- return (
10
- <div className="grid grid-cols-2 sm:grid-cols-3 lg:grid-cols-5 gap-2.5 items-stretch">
11
- <StatCard
12
- value={activeMetrics.processedTokens}
13
- label="Processed tokens"
14
- hint={activeMetrics.activeRate}
15
- />
16
-
17
- <StatCard
18
- value={activeMetrics.cachedInput}
19
- label="Cached input"
20
- hint={activeMetrics.cachedPercent}
21
- />
11
+ /**
12
+ * The headline numbers for the selected period.
13
+ *
14
+ * Plain totals — the panel reports one span, so there is nothing to average and
15
+ * nothing that changes with a grouping choice. `periodName` only names the span
16
+ * the totals belong to.
17
+ */
18
+ export function TokenUsageMetricsGrid({ totals, periodName }: TokenUsageMetricsGridProps) {
19
+ const metrics = toMetricSet(totals);
20
+ const hitRate = totals.cacheRead + totals.input > 0 ? totals.cacheRead / (totals.cacheRead + totals.input) : 0;
22
21
 
23
- <StatCard
24
- value={activeMetrics.uncachedInput}
25
- label="Uncached input"
26
- hint="0 cache writes"
27
- />
22
+ return (
23
+ <div className="grid grid-cols-1 gap-3 xl:grid-cols-3">
24
+ <div className="flex flex-col justify-between rounded-lg border border-ink/15 bg-paper p-3.5 shadow-xs">
25
+ <div>
26
+ <div className="mb-2 flex items-baseline justify-between gap-2">
27
+ <span className="font-mono text-[10px] font-semibold uppercase tracking-wider text-ink/40">
28
+ Provider-reported cost
29
+ </span>
30
+ <span className="font-mono text-[9px] uppercase tracking-wider text-ink/30">{periodName}</span>
31
+ </div>
32
+ <div className="flex items-baseline gap-1.5">
33
+ <span className="text-2xl font-bold tracking-tight tabular-nums text-ink">{metrics.rawCost}</span>
34
+ <span className="text-[11px] text-ink/45">at API rates</span>
35
+ </div>
36
+ <p className="mt-1 text-[11px] text-ink/50">
37
+ {costPerMillionLabel(totals)} per 1M tokens · {metrics.processedTokens} tokens ·{' '}
38
+ {totals.records.toLocaleString('en-US')} turns
39
+ </p>
40
+ </div>
28
41
 
29
- <StatCard
30
- value={activeMetrics.outputTokens}
31
- label="Output"
32
- hint={activeMetrics.reasoning}
33
- />
42
+ <div className="mt-3">
43
+ <div className="h-1.5 w-full overflow-hidden rounded-full bg-ink/10">
44
+ <div className="h-full rounded-full bg-ink/80" style={{ width: `${Math.min(100, hitRate * 100)}%` }} />
45
+ </div>
46
+ <div className="mt-1.5 flex items-center justify-between text-[11px] text-ink/60">
47
+ <span>{cacheHitLabel(totals)} served from cache</span>
48
+ <span className="tabular-nums text-ink/80">{metrics.cachedInput} cached</span>
49
+ </div>
50
+ </div>
51
+ </div>
34
52
 
35
- <StatCard
36
- value={activeMetrics.cacheSavings}
37
- label="Cache savings"
38
- hint="0.0x the raw token cost"
39
- tone="muted"
40
- className="col-span-2 sm:col-span-1"
41
- />
53
+ <div className="grid grid-cols-2 gap-2.5 xl:col-span-2">
54
+ <StatCard value={metrics.processedTokens} label="Processed tokens" hint={metrics.activeRate} />
55
+ <StatCard value={metrics.outputTokens} label="Output" hint={metrics.reasoning} />
56
+ <StatCard value={metrics.uncachedInput} label="Uncached input" hint={`${metrics.cacheWrite} cache writes`} />
57
+ <StatCard
58
+ value={costLabel(totals.cacheReadCost)}
59
+ label="Paid for cache reads"
60
+ hint={`${metrics.cachedInput} read at the cache rate`}
61
+ tone="muted"
62
+ />
63
+ </div>
42
64
  </div>
43
65
  );
44
66
  }
@@ -0,0 +1,59 @@
1
+ import type { UsageIndexState } from '@/shared/types';
2
+
3
+ interface UsageProvenanceProps {
4
+ index: UsageIndexState;
5
+ /** Epoch ms the payload was built, so the age is independent of clock skew. */
6
+ generatedAt: number;
7
+ providers: number;
8
+ }
9
+
10
+ /** `3 s` / `2 min` / `1 h` — the index's own age, not the request's. */
11
+ function ageLabel(ms: number): string {
12
+ if (!Number.isFinite(ms) || ms < 1_000) return 'just now';
13
+ const seconds = Math.round(ms / 1_000);
14
+ if (seconds < 60) return `${seconds}s ago`;
15
+ const minutes = Math.round(seconds / 60);
16
+ if (minutes < 60) return `${minutes} min ago`;
17
+ return `${Math.round(minutes / 60)} h ago`;
18
+ }
19
+
20
+ /**
21
+ * The footer: where the numbers came from and how fresh they are.
22
+ *
23
+ * It used to be a hardcoded sentence (`… · 0.1s`, `(1 outside the window)`) that
24
+ * described a scan that had not happened. Every value here comes from the
25
+ * index's own report, and `rechecking` is used only once there is an index to
26
+ * recheck — a 40 ms background pass is not "indexing" and must not flash over
27
+ * data the user is reading.
28
+ */
29
+ export function UsageProvenance({ index, generatedAt, providers }: UsageProvenanceProps) {
30
+ const building = index.state === 'building';
31
+ const hasIndex = index.indexedAt > 0;
32
+ const status = !hasIndex
33
+ ? index.state === 'failed'
34
+ ? 'Index failed'
35
+ : 'No sessions indexed yet'
36
+ : building
37
+ ? `Updated ${ageLabel(generatedAt - index.indexedAt)} · rechecking`
38
+ : index.state === 'failed'
39
+ ? 'Index failed'
40
+ : `Updated ${ageLabel(generatedAt - index.indexedAt)}`;
41
+
42
+ return (
43
+ <div className="flex flex-wrap items-center justify-center gap-x-2 gap-y-1 pt-2 text-center text-[10px] text-ink/40">
44
+ <span>
45
+ {status} · {index.transcripts.toLocaleString('en-US')} transcripts ·{' '}
46
+ {index.records.toLocaleString('en-US')} records · {providers}{' '}
47
+ {providers === 1 ? 'provider' : 'providers'}
48
+ </span>
49
+ <span aria-hidden="true">·</span>
50
+ <span>index scan {index.scanMs.toLocaleString('en-US')} ms</span>
51
+ {index.state === 'failed' && index.error && (
52
+ <>
53
+ <span aria-hidden="true">·</span>
54
+ <span className="text-[var(--theme-error)]">{index.error}</span>
55
+ </>
56
+ )}
57
+ </div>
58
+ );
59
+ }