@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
@@ -0,0 +1,129 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Per-block review on a rendered markdown document: "this paragraph is good,
8
+ * that one needs work", with the verdicts handed to the agent as one prompt.
9
+ *
10
+ * ## Off unless the toolbar button turned it on
11
+ *
12
+ * `active` is the whole difference between this and an ordinary preview. Off:
13
+ * the renderer emits no block attributes, nothing is fetched, and every click
14
+ * keeps its usual meaning — links, copy buttons, the diagram viewer. On: each
15
+ * top-level block becomes addressable, a click opens the judge panel, and a rail
16
+ * stripe says what has been decided. An always-on layer would take those clicks
17
+ * away from a reader who never asked to review anything, which is why the mode
18
+ * is entered from a toolbar button and nowhere else.
19
+ *
20
+ * ## Identity is the block's text, not its line
21
+ *
22
+ * A render has no lines, and a line number lies the moment text above it is
23
+ * inserted. Each block carries `type:hash#occurrence` (`blocks/anchor.ts`), so a
24
+ * judgement follows its paragraph around the document; when the block's own text
25
+ * changes the anchor stops matching and the mark is reported as OUTDATED with
26
+ * its note intact — never dropped.
27
+ */
28
+
29
+ import { useEffect, useState } from 'preact/hooks';
30
+
31
+ import { MarkdownRenderer } from '@/client/components/common/MarkdownRenderer';
32
+ import { ReviewPopover } from '@/client/components/common/markdown-review/ReviewPopover';
33
+ import { ReviewSummary } from '@/client/components/common/markdown-review/ReviewSummary';
34
+ import { usePreviewReview } from '@/client/hooks/editor/use-preview-review';
35
+
36
+ export interface MarkdownReviewProps {
37
+ /** The document's text — the preview's buffer, not a re-read from disk. */
38
+ content: string;
39
+ file: { name: string; path: string; root?: string | null; repo?: string | null };
40
+ /** Review mode, owned by the editor's toolbar. */
41
+ active: boolean;
42
+ /** The exit control inside the summary bar; the toolbar owns the same switch. */
43
+ onExit: () => void;
44
+ }
45
+
46
+ export function MarkdownReview({ content, file, active, onExit }: MarkdownReviewProps) {
47
+ const review = usePreviewReview({ file, active });
48
+ const [sent, setSent] = useState(false);
49
+
50
+ // A scroll moves the block out from under a fixed panel, so closing is the
51
+ // honest answer — see `ReviewPopover`.
52
+ useEffect(() => {
53
+ if (!review.selected) return;
54
+ const onScroll = () => review.close();
55
+ window.addEventListener('scroll', onScroll, true);
56
+ return () => window.removeEventListener('scroll', onScroll, true);
57
+ }, [review.selected]);
58
+
59
+ // The mode was switched off (toolbar, or another tab of the same file): the
60
+ // panel must not survive into the ordinary preview.
61
+ useEffect(() => {
62
+ if (!active) review.close();
63
+ }, [active]);
64
+
65
+ // "Added to the chat box" describes the LAST send, so a change to what would be
66
+ // sent retires it: leaving it up after a mark was removed would claim the
67
+ // composer holds the review that is on screen.
68
+ const total = review.counts.good + review.counts.needsWork;
69
+ useEffect(() => {
70
+ setSent(false);
71
+ }, [total]);
72
+
73
+ const selected = review.selectedBlock;
74
+ const annotation = review.selectedAnnotation;
75
+
76
+ return (
77
+ // The class is what review mode's CSS hangs off, so the hover and rail rules
78
+ // exist only while the mode is on.
79
+ <div className={active ? 'md-review-active' : undefined}>
80
+ <MarkdownRenderer
81
+ content={content}
82
+ document
83
+ scope={{ path: file.path, root: file.root ?? undefined, repo: file.repo ?? undefined }}
84
+ onBlocks={review.setBlocks}
85
+ review={
86
+ active
87
+ ? { active: true, marks: review.marks, selected: review.selected, onPick: review.pick }
88
+ : undefined
89
+ }
90
+ />
91
+
92
+ {active && selected && review.anchor && (
93
+ <ReviewPopover
94
+ // A new block is a new form: the textarea's draft must not follow the
95
+ // selection.
96
+ key={selected.key}
97
+ block={selected}
98
+ verdict={review.marks.get(selected.key) ?? null}
99
+ note={annotation?.note ?? ''}
100
+ anchor={review.anchor}
101
+ onSave={(verdict, note) => {
102
+ review.save({ block: selected, verdict, note });
103
+ review.close();
104
+ }}
105
+ onRemove={() => {
106
+ if (annotation) review.remove(annotation.id);
107
+ review.close();
108
+ }}
109
+ onClose={review.close}
110
+ />
111
+ )}
112
+
113
+ {active && (
114
+ <ReviewSummary
115
+ counts={review.counts}
116
+ outdated={review.outdated}
117
+ error={review.error}
118
+ sent={sent}
119
+ onSend={() => setSent(review.send())}
120
+ onRemoveOutdated={review.remove}
121
+ onExit={() => {
122
+ review.close();
123
+ onExit();
124
+ }}
125
+ />
126
+ )}
127
+ </div>
128
+ );
129
+ }
@@ -4,37 +4,37 @@
4
4
  */
5
5
 
6
6
  /**
7
- * Which server the window is on, and how to change it.
7
+ * The server panel's own markup: one row per server, the empty state, and the
8
+ * two footers a shell may or may not offer.
8
9
  *
9
- * The panel lists three groups, and the split is the whole design:
10
- *
11
- * - **This window** — the servers the shell remembers, with the active one
12
- * marked. A remote entry is a URL somebody typed; a managed entry is a local
13
- * server this shell started, which is why it can be stopped here.
14
- * - **Found on this machine** — servers the shell did NOT start: `kabmo serve`
15
- * in a terminal, `bun run dev`, a login entry. They are read from the
16
- * per-port records the servers themselves write, so a server that appeared
17
- * after the panel opened shows up on the next refresh. They can be connected
18
- * to but not stopped — this window did not start them, and a Stop here would
19
- * kill a process somebody else is watching.
20
- * - **Add a server** — a URL and a label.
21
- *
22
- * A server is only offered as connectable while it ANSWERS: the shell probes
23
- * every URL before answering, so `running: false` is a real fact rather than a
24
- * guess, and the row says so instead of letting a click fail on a blank window.
10
+ * Split from `ServerControl` so the trigger (a chip on a phone, a labelled
11
+ * button in a desktop navbar) and the list can be read and tested apart. The
12
+ * STORE is the control's, not the panel's: the old panel opened a second
13
+ * `useShellServers`, which meant two copies of the list, two 4-second polls and
14
+ * a trigger that could disagree with the rows directly under it.
25
15
  */
26
16
 
27
17
  import { useState } from 'preact/hooks';
28
18
  import { Check, Loader2, Play, Plus, RefreshCw, Server, Square, Trash2 } from 'lucide-preact';
29
- import { useDesktopServers } from '@/client/hooks/desktop/servers';
30
- import type { DesktopServer } from '@/client/lib/desktop/bridge';
19
+ import { AnchoredMenu } from '@/client/components/common/anchored-menu';
20
+ import { anchorRectOf } from '@/shared/lib/ui/menu-anchor';
21
+ import type { ShellServersStore } from '@/client/hooks/shell/servers';
22
+ import type { ShellServer } from '@/client/lib/shell/servers';
23
+ import { mobileOverlayStyle } from '@/shared/lib/ui/mobile-overlay';
24
+
25
+ export type ServerControlVariant = 'nav' | 'chip';
31
26
 
32
- interface ServerSwitcherProps {
27
+ interface ServerPanelProps {
33
28
  open: boolean;
34
29
  onClose: () => void;
30
+ /** `nav` hangs under a desktop navbar button; `chip` is a phone sheet. */
31
+ variant: ServerControlVariant;
32
+ store: ShellServersStore;
33
+ /** The button this panel hangs from; the nav variant is measured off it. */
34
+ triggerRef: { current: HTMLButtonElement | null };
35
35
  }
36
36
 
37
- function statusLine(server: DesktopServer): string {
37
+ function statusLine(server: ShellServer): string {
38
38
  if (!server.running) return 'Stopped';
39
39
  const parts: string[] = [];
40
40
  if (server.version) parts.push(`v${server.version}`);
@@ -51,7 +51,7 @@ function Row({
51
51
  onStop,
52
52
  onRemove,
53
53
  }: {
54
- server: DesktopServer;
54
+ server: ShellServer;
55
55
  active: boolean;
56
56
  busy: boolean;
57
57
  onActivate: () => void;
@@ -113,8 +113,46 @@ function Row({
113
113
  );
114
114
  }
115
115
 
116
- export function ServerSwitcher({ open, onClose }: ServerSwitcherProps) {
117
- const store = useDesktopServers(open);
116
+ /**
117
+ * Which server this window is on, and how to change it.
118
+ *
119
+ * The panel lists two groups, and the split is the whole design:
120
+ *
121
+ * - **This window** — the servers the shell remembers, with the active one
122
+ * marked. A remote entry is a URL somebody typed; a managed entry is a local
123
+ * server this shell started, which is why it can be stopped here.
124
+ * - **Found on this machine** — servers the shell did NOT start: `kabmo serve`
125
+ * in a terminal, `bun run dev`, a login entry. They are read from the
126
+ * per-port records the servers themselves write, so a server that appeared
127
+ * after the panel opened shows up on the next refresh. They can be connected
128
+ * to but not stopped — this window did not start them, and a Stop here would
129
+ * kill a process somebody else is watching.
130
+ *
131
+ * A phone answers neither group's second half: it cannot spawn a server, and it
132
+ * has no per-port records on the device, so those two sections are ABSENT there
133
+ * rather than drawn empty (`startable: false` and `detected: []` are the facts).
134
+ *
135
+ * A server is only offered as connectable while it ANSWERS: the shell probes
136
+ * every URL before answering, so `running: false` is a real fact rather than a
137
+ * guess, and the row says so instead of letting a click fail on a blank window.
138
+ *
139
+ * ## The panel is portalled, and why that is the fix rather than a z-index bump
140
+ *
141
+ * The desktop trigger lives in the navbar, a FLEX ITEM at `z-20`; a `z-50`
142
+ * panel inside it is still confined to that stacking context, so anything at
143
+ * `z-20`+ in the chat column painted over it (measured: an `elementFromPoint`
144
+ * walk found the timeline's minimap on top of the panel's middle rows at
145
+ * 1100×460). Raising the panel's own number cannot help — the number that
146
+ * decides is the ANCESTOR's. Same story on the phone: the drawer's title bar
147
+ * is a `z-20` flex item, and the sheet's lower rows fell under the sticky
148
+ * workspace headers beneath it.
149
+ *
150
+ * So the body is drawn by `common/anchored-menu/`: `fixed`, in `document.body`,
151
+ * at the layer above every panel and modal. The nav variant measures the
152
+ * trigger it hangs from; the chip variant keeps `mobileOverlayStyle`'s insets,
153
+ * which are a property of the device rather than of the button.
154
+ */
155
+ export function ServerPanel({ open, onClose, variant, store, triggerRef }: ServerPanelProps) {
118
156
  const [label, setLabel] = useState('');
119
157
  const [url, setUrl] = useState('');
120
158
  const [adding, setAdding] = useState(false);
@@ -125,6 +163,7 @@ export function ServerSwitcher({ open, onClose }: ServerSwitcherProps) {
125
163
  const entries = state?.entries ?? [];
126
164
  const detected = state?.detected ?? [];
127
165
  const activeId = state?.activeId;
166
+ const startable = state?.startable !== false;
128
167
 
129
168
  const submit = async () => {
130
169
  if (!url.trim()) return;
@@ -136,17 +175,20 @@ export function ServerSwitcher({ open, onClose }: ServerSwitcherProps) {
136
175
  }
137
176
  };
138
177
 
178
+ // The panel's own chrome. `overflow-hidden` is gone: the rows scroll inside
179
+ // the body below, and a clipping root would cut the Add form's focus ring.
180
+ const panelClass = variant === 'chip'
181
+ ? 'rounded-xl border border-ink/15 bg-paper shadow-xl'
182
+ : 'w-[340px] rounded-xl border border-ink/15 bg-paper shadow-xl';
183
+
139
184
  return (
140
- <div
185
+ <AnchoredMenu
186
+ anchor={variant === 'nav' && triggerRef.current ? anchorRectOf(triggerRef.current) : null}
187
+ viewportStyle={variant === 'chip' ? mobileOverlayStyle() : undefined}
141
188
  role="dialog"
142
- aria-label="Servers"
143
- className="absolute right-2 top-full mt-1 z-50 w-[340px] rounded-xl border border-ink/15 bg-paper shadow-xl overflow-hidden"
144
- onKeyDown={(event) => {
145
- if (event.key === 'Escape') {
146
- event.stopPropagation();
147
- onClose();
148
- }
149
- }}
189
+ ariaLabel="Servers"
190
+ className={panelClass}
191
+ onClose={onClose}
150
192
  >
151
193
  <div className="flex items-center justify-between px-3 py-2 border-b border-ink/10">
152
194
  <span className="flex items-center gap-1.5 text-xs font-semibold text-ink">
@@ -156,7 +198,7 @@ export function ServerSwitcher({ open, onClose }: ServerSwitcherProps) {
156
198
  type="button"
157
199
  onClick={() => void store.reload()}
158
200
  disabled={store.busy}
159
- title="Refresh — re-probe every server and look for new local ones"
201
+ title="Refresh — re-probe every server"
160
202
  aria-label="Refresh servers"
161
203
  className="p-1 rounded text-ink/40 hover:text-ink hover:bg-ink/10 cursor-pointer disabled:opacity-40"
162
204
  >
@@ -207,7 +249,7 @@ export function ServerSwitcher({ open, onClose }: ServerSwitcherProps) {
207
249
 
208
250
  {state && entries.length === 0 && detected.length === 0 && (
209
251
  <p className="px-1 py-2 text-[11px] text-ink/50">
210
- Nothing running yet. Start a local server, or add one by address.
252
+ Nothing here yet. Add a server by address.
211
253
  </p>
212
254
  )}
213
255
  </div>
@@ -217,14 +259,20 @@ export function ServerSwitcher({ open, onClose }: ServerSwitcherProps) {
217
259
  )}
218
260
 
219
261
  <div className="border-t border-ink/10 px-2 py-2 space-y-1.5">
220
- <button
221
- type="button"
222
- onClick={() => void store.start()}
223
- disabled={store.busy}
224
- className="w-full flex items-center gap-1.5 rounded-lg border border-ink/15 px-2.5 py-1.5 text-xs text-ink hover:bg-ink/5 cursor-pointer disabled:opacity-40"
225
- >
226
- <Play size={12} /> Start a local server
227
- </button>
262
+ {/* A phone cannot spawn a server: there is no process to start and no
263
+ terminal to own it. The control is ABSENT rather than disabled,
264
+ because a disabled button would promise a capability the shell does
265
+ not have. */}
266
+ {startable && (
267
+ <button
268
+ type="button"
269
+ onClick={() => void store.start()}
270
+ disabled={store.busy}
271
+ className="w-full flex items-center gap-1.5 rounded-lg border border-ink/15 px-2.5 py-1.5 text-xs text-ink hover:bg-ink/5 cursor-pointer disabled:opacity-40"
272
+ >
273
+ <Play size={12} /> Start a local server
274
+ </button>
275
+ )}
228
276
 
229
277
  {adding ? (
230
278
  <form
@@ -276,6 +324,6 @@ export function ServerSwitcher({ open, onClose }: ServerSwitcherProps) {
276
324
  </button>
277
325
  )}
278
326
  </div>
279
- </div>
327
+ </AnchoredMenu>
280
328
  );
281
329
  }
@@ -0,0 +1,217 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The server panel, rendered against a real shell bridge.
8
+ *
9
+ * Four rules are what this suite exists for, and each was a decision rather
10
+ * than a style:
11
+ *
12
+ * 1. **A stopped server cannot be connected to.** The shell probes every URL
13
+ * before it answers, so `running: false` is a fact; the row says `Stopped`
14
+ * and its button is disabled rather than letting a click land on a blank
15
+ * window.
16
+ * 2. **Only a server this shell started offers Stop.** A server found on the
17
+ * machine belongs to whoever started it — `kabmo serve` in a terminal — and a
18
+ * Stop here would kill a process somebody else is watching.
19
+ * 3. **A phone is offered no Start.** `startable: false` is the fact the shell
20
+ * reports, and the control is ABSENT rather than disabled: a disabled button
21
+ * would promise a capability the phone does not have.
22
+ * 4. **The trigger and the panel share ONE store.** Two copies is how a trigger
23
+ * says "running" over rows that say `Stopped`, and how two 4-second polls
24
+ * probe every server twice.
25
+ */
26
+
27
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
28
+ import { Window } from 'happy-dom';
29
+ import { h, render } from 'preact';
30
+ import { act } from 'preact/test-utils';
31
+ import { ServerControl } from '@/client/components/common/server-control';
32
+ import { MobileSessionHeader } from '@/client/components/mobile/mobile-session-sidebar/Header';
33
+ import type { ShellServersState } from '@/client/lib/shell/servers';
34
+ import { installDomGlobals, restoreDomGlobals } from '@/test-support/pristine-globals';
35
+
36
+ const state = (overrides: Partial<ShellServersState> = {}): ShellServersState => ({
37
+ entries: [],
38
+ detected: [],
39
+ ...overrides,
40
+ });
41
+
42
+ const LOCAL: ShellServersState = state({
43
+ entries: [
44
+ { id: 'local:3001', label: 'Local :3001', url: 'http://127.0.0.1:3001', kind: 'managed', port: 3001, running: true, owned: true, version: '0.5.3', mode: 'prod', pid: 42, source: 'stored' },
45
+ { id: 'remote:https://nas:8443', label: 'NAS', url: 'https://nas:8443', kind: 'remote', running: false, owned: false, source: 'stored' },
46
+ ],
47
+ detected: [
48
+ { id: 'local:3000', label: 'Local :3000', url: 'http://127.0.0.1:3000', kind: 'managed', port: 3000, running: true, owned: false, version: '0.5.3', mode: 'dev', pid: 7, source: 'record' },
49
+ ],
50
+ activeId: 'local:3001',
51
+ activeUrl: 'http://127.0.0.1:3001',
52
+ });
53
+
54
+ /** What the three desktop shells answer: they can start a server of their own. */
55
+ const DESKTOP = LOCAL;
56
+
57
+ /** What a phone answers: no spawning, no per-port records on the device. */
58
+ const PHONE: ShellServersState = state({
59
+ entries: [
60
+ { id: 'local:3001', label: 'Home NAS', url: 'http://192.168.1.10:3000', kind: 'remote', running: true, owned: false, version: '0.5.3', source: 'stored' },
61
+ { id: 'remote:https://office', label: 'Office', url: 'https://office.example:3000', kind: 'remote', running: false, owned: false, source: 'stored' },
62
+ ],
63
+ activeId: 'local:3001',
64
+ activeUrl: 'http://192.168.1.10:3000',
65
+ startable: false,
66
+ });
67
+
68
+ let win: Window;
69
+ let container: HTMLElement;
70
+ let calls: Array<{ command: string; args?: Record<string, unknown> }>;
71
+
72
+ function mount(next: ShellServersState | Error, variant: 'nav' | 'chip' = 'nav', open = true) {
73
+ calls = [];
74
+ win.document.body.innerHTML = '';
75
+ container = win.document.createElement('div') as unknown as HTMLElement;
76
+ win.document.body.appendChild(container as never);
77
+ // The transport the shells install: `__kabmoCall` answers through the same
78
+ // door the shell uses, which is what makes this a test of the bridge rather
79
+ // than of a stub only this suite knows about.
80
+ const shellWindow = win as unknown as {
81
+ __kabmoCall?: (method: string, params?: Record<string, unknown>) => Promise<unknown>;
82
+ };
83
+ shellWindow.__kabmoCall = async (method, params) => {
84
+ calls.push({ command: method, args: params });
85
+ if (next instanceof Error) throw next;
86
+ return next;
87
+ };
88
+ act(() => {
89
+ render(h(ServerControl, { variant }), container as never);
90
+ });
91
+ if (open) {
92
+ const trigger = container.querySelector('button');
93
+ act(() => {
94
+ (trigger as HTMLButtonElement | null)?.click();
95
+ });
96
+ }
97
+ }
98
+
99
+ async function settle() {
100
+ await act(async () => {
101
+ await Promise.resolve();
102
+ await new Promise((resolve) => setTimeout(resolve, 0));
103
+ });
104
+ }
105
+
106
+ /**
107
+ * The panel is PORTALLED to `document.body` (an `absolute` panel inside the
108
+ * navbar's `z-20` stacking context lost to column content at equal or higher
109
+ * numbers — see `Panel.tsx`), so the panel's words are read from the document
110
+ * rather than from the trigger's own container.
111
+ */
112
+ const text = () => (win.document.body.textContent ?? '').replace(/\s+/g, ' ').trim();
113
+
114
+ beforeEach(() => {
115
+ win = new Window({ url: 'http://127.0.0.1:3001/' });
116
+ installDomGlobals(win);
117
+ });
118
+
119
+ afterEach(() => {
120
+ if (container) act(() => render(null, container as never));
121
+ restoreDomGlobals();
122
+ });
123
+
124
+ describe('ServerControl', () => {
125
+ test('a browser renders nothing, because there is no shell to control', async () => {
126
+ win.document.body.innerHTML = '';
127
+ const bare = win.document.createElement('div');
128
+ win.document.body.appendChild(bare as never);
129
+ act(() => {
130
+ render(h(ServerControl, { variant: 'chip' }), bare as never);
131
+ });
132
+ await settle();
133
+ expect((bare.textContent ?? '').trim()).toBe('');
134
+ expect(bare.querySelector('button')).toBeNull();
135
+ });
136
+
137
+ test('lists the stored servers, the detected ones, and marks the active row', async () => {
138
+ mount(DESKTOP);
139
+ await settle();
140
+ expect(text()).toContain('This window');
141
+ expect(text()).toContain('Local :3001');
142
+ expect(text()).toContain('NAS');
143
+ expect(text()).toContain('Found on this machine');
144
+ expect(text()).toContain('Local :3000');
145
+ // The active row carries its own marker rather than a colour alone.
146
+ expect(win.document.querySelector('[aria-label="Active"]')).not.toBeNull();
147
+ });
148
+
149
+ test('the trigger and the panel read ONE list — one read, not two polls', async () => {
150
+ mount(DESKTOP);
151
+ await settle();
152
+ expect(calls.filter((call) => call.command === 'servers_state')).toHaveLength(1);
153
+ });
154
+
155
+ test('a stopped server is offered as Stopped and cannot be connected to', async () => {
156
+ mount(DESKTOP);
157
+ await settle();
158
+ expect(text()).toContain('Stopped');
159
+ const nas = [...win.document.querySelectorAll('button')].find((button) =>
160
+ (button.textContent ?? '').includes('NAS'),
161
+ );
162
+ expect(nas).toBeDefined();
163
+ expect(nas?.disabled).toBe(true);
164
+ });
165
+
166
+ test('Stop is offered only for a server this shell started', async () => {
167
+ mount(DESKTOP);
168
+ await settle();
169
+ const stops = [...win.document.querySelectorAll('button')].filter((button) =>
170
+ (button.getAttribute('aria-label') ?? '').startsWith('Stop '),
171
+ );
172
+ expect(stops.map((button) => button.getAttribute('aria-label'))).toEqual(['Stop Local :3001']);
173
+ });
174
+
175
+ test('a phone is offered no Start, and no local discovery', async () => {
176
+ mount(PHONE, 'chip');
177
+ await settle();
178
+ expect(text()).toContain('Home NAS');
179
+ expect(text()).not.toContain('Start a local server');
180
+ expect(text()).not.toContain('Found on this machine');
181
+ // The chip's own accessible name carries the server, since it has no label.
182
+ expect(container.querySelector('[aria-label^="Server: Home NAS"]')).not.toBeNull();
183
+ });
184
+
185
+ /**
186
+ * The phone's trigger lives in the DRAWER's title bar, not in the chat header:
187
+ * measured at 390px with a password set, the chat header has ~100px spare and
188
+ * adding 40px left the session title 49px, while this row has ~158px spare.
189
+ */
190
+ test('the drawer header carries the chip, but only inside a shell', async () => {
191
+ const mountHeader = () => {
192
+ win.document.body.innerHTML = '';
193
+ container = win.document.createElement('div') as unknown as HTMLElement;
194
+ win.document.body.appendChild(container as never);
195
+ act(() => {
196
+ render(h(MobileSessionHeader, { onClose: () => {} }), container as never);
197
+ });
198
+ };
199
+
200
+ mountHeader();
201
+ await settle();
202
+ expect(container.querySelector('[aria-label="Choose a server"]')).toBeNull();
203
+
204
+ (win as unknown as { __kabmoCall?: unknown }).__kabmoCall = async () => state();
205
+ mountHeader();
206
+ await settle();
207
+ expect(container.querySelector('[aria-label="Choose a server"]')).not.toBeNull();
208
+ // The drawer's own control is untouched.
209
+ expect(container.querySelector('[aria-label="Close sidebar"]')).not.toBeNull();
210
+ });
211
+
212
+ test('a refused add shows the shell’s own sentence', async () => {
213
+ mount(new Error("Use the server's root address — a base path is not supported."));
214
+ await settle();
215
+ expect(text()).toContain('root address');
216
+ });
217
+ });
@@ -0,0 +1,120 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The server control: a trigger that says which server this window is on, and
8
+ * the panel that changes it.
9
+ *
10
+ * ONE control for five shells, with two triggers because the surfaces differ and
11
+ * the fact does not:
12
+ *
13
+ * - `nav` — the desktop navbar's labelled button (icon, label, status dot). The
14
+ * macOS / Windows / Linux windows have the room.
15
+ * - `chip` — a phone's icon-only button. The chat header has no room left (a
16
+ * measured 100px free at 390 once the session title and the control cluster
17
+ * are paid for), so it sits in the DRAWER's title bar instead, where the row
18
+ * has ~158px spare and nothing has to be truncated to pay for it.
19
+ *
20
+ * The store lives HERE and not in the panel: the trigger and its popover must
21
+ * read one list. Two copies is how a trigger says "running" over rows that say
22
+ * `Stopped` — and how two 4-second polls probe every server twice.
23
+ *
24
+ * A desktop shell narrowed below the layout breakpoint renders the PHONE layout,
25
+ * so its navbar is gone and only the drawer's chip is left. That is the same
26
+ * control, not a second one, which is why it is drawn whenever an answer exists
27
+ * rather than on a desktop-vs-phone test.
28
+ */
29
+
30
+ import { useEffect, useRef, useState } from 'preact/hooks';
31
+ import { ServerCog } from 'lucide-preact';
32
+ import { useShellServers } from '@/client/hooks/shell/servers';
33
+ import { hasShellBridge } from '@/client/lib/shell/transport';
34
+ import { ServerPanel } from '@/client/components/common/server-control/Panel';
35
+
36
+ export type ServerControlVariant = 'nav' | 'chip';
37
+
38
+ interface ServerControlProps {
39
+ variant: ServerControlVariant;
40
+ }
41
+
42
+ /** The chip's box, matched to the drawer header's own close button. */
43
+ const CHIP_CLASS =
44
+ 'w-8 h-8 rounded-lg flex items-center justify-center text-ink/60 hover:text-ink hover:bg-ink/5 active:bg-ink/10 transition-colors cursor-pointer flex-shrink-0 titlebar-no-drag';
45
+
46
+ export function ServerControl({ variant }: ServerControlProps) {
47
+ // A native host has to be PRESENT before the control exists at all: a browser
48
+ // has no shell to control, and a button that opened onto "not available"
49
+ // would be a button that never works.
50
+ const available = hasShellBridge();
51
+ const [open, setOpen] = useState(false);
52
+ // The panel is PORTALLED (see `Panel.tsx` for the measured reason), so its
53
+ // dismissal is its own backdrop — an outside-click listener rooted at the
54
+ // trigger would read every click inside the panel as "outside".
55
+ const triggerRef = useRef<HTMLButtonElement>(null);
56
+ const store = useShellServers(open);
57
+ const active =
58
+ store.state?.entries.find((entry) => entry.id === store.state?.activeId) ??
59
+ store.state?.detected.find((entry) => entry.url === store.state?.activeUrl) ??
60
+ null;
61
+
62
+ // A shell that went away (a page kept across a host restart) must not leave a
63
+ // dangling promise behind: closing it is the honest state.
64
+ useEffect(() => {
65
+ if (!available) setOpen(false);
66
+ }, [available]);
67
+
68
+ if (!available) return null;
69
+
70
+ const summary = active
71
+ ? `Server: ${active.label} — ${active.running ? 'running' : 'stopped'}`
72
+ : 'Choose a server';
73
+
74
+ if (variant === 'chip') {
75
+ return (
76
+ <div className="relative flex-shrink-0">
77
+ <button
78
+ ref={triggerRef}
79
+ type="button"
80
+ onClick={() => setOpen((was) => !was)}
81
+ className={CHIP_CLASS}
82
+ title={summary}
83
+ aria-label={summary}
84
+ aria-haspopup="dialog"
85
+ aria-expanded={open}
86
+ >
87
+ <ServerCog size={18} strokeWidth={1.8} />
88
+ </button>
89
+ <ServerPanel open={open} onClose={() => setOpen(false)} variant="chip" store={store} triggerRef={triggerRef} />
90
+ </div>
91
+ );
92
+ }
93
+
94
+ return (
95
+ <div className="relative">
96
+ <button
97
+ ref={triggerRef}
98
+ type="button"
99
+ onClick={() => setOpen((was) => !was)}
100
+ className="flex items-center gap-1.5 rounded px-1.5 py-1 text-ink/60 hover:text-ink hover:bg-ink/10 transition-colors cursor-pointer"
101
+ title={summary}
102
+ aria-label="Servers"
103
+ aria-haspopup="dialog"
104
+ aria-expanded={open}
105
+ >
106
+ <ServerCog size={16} />
107
+ {active && (
108
+ <span className="max-w-[120px] truncate text-[11px] font-medium text-ink/70">
109
+ {active.label}
110
+ </span>
111
+ )}
112
+ <span
113
+ className={`w-1.5 h-1.5 rounded-full ${active?.running ? 'bg-success' : 'bg-ink/25'}`}
114
+ aria-hidden="true"
115
+ />
116
+ </button>
117
+ <ServerPanel open={open} onClose={() => setOpen(false)} variant="nav" store={store} triggerRef={triggerRef} />
118
+ </div>
119
+ );
120
+ }