@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
@@ -23,6 +23,7 @@ import { modelsBindings } from '@/server/routes/models';
23
23
  import { ompBindings } from '@/server/routes/omp';
24
24
  import { updatesBindings } from '@/server/routes/updates';
25
25
  import { wikiBindings } from '@/server/routes/wiki';
26
+ import { reviewBindings } from '@/server/routes/review/bindings';
26
27
  import { panelsBindings } from '@/server/routes/panels/bindings';
27
28
  import { pluginsBindings } from '@/server/routes/plugins/bindings';
28
29
  import { realtimeWsRoutes } from '@/server/routes/realtime/ws';
@@ -52,6 +53,7 @@ const allBindings: HandlerBinding[] = [
52
53
  ...ompBindings,
53
54
  ...updatesBindings,
54
55
  ...wikiBindings,
56
+ ...reviewBindings,
55
57
  ...panelsBindings,
56
58
  ...pluginsBindings,
57
59
  ...healthBindings,
@@ -0,0 +1,11 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ import { bindingsFor, type HandlerBinding } from '@/server/lib/route-adapter';
7
+ import * as review from '@/server/routes/review/index';
8
+
9
+ export const reviewBindings: HandlerBinding[] = bindingsFor(review, '/api/review', {
10
+ mutating: ['POST', 'DELETE'],
11
+ });
@@ -0,0 +1,127 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * `/api/review` — a document's review annotations.
8
+ *
9
+ * GET `?path=&root=&repo=` → `{ annotations, scope }`
10
+ * POST → upsert one judgement for one block
11
+ * DELETE `?id=` → remove one
12
+ *
13
+ * The scope is resolved HERE, from the same `root`/`repo` pair every other file
14
+ * route takes, so an annotation can never name a directory the caller could not
15
+ * read: `resolveRoot` falls back the same way and `resolveWithinRoot` refuses an
16
+ * escape. The stored key is `<resolvedRoot>\0<repo>`, the spelling the realtime
17
+ * workspace topics already use for the same pair.
18
+ */
19
+
20
+ import { json, NO_STORE_HEADERS } from '@/server/lib/remix-compat';
21
+ import type { ActionFunctionArgs, LoaderFunctionArgs } from '@/server/lib/remix-compat';
22
+ import { methodNotAllowedResponse } from '@/server/lib/route-adapter';
23
+ import { getDefaultFsRoot, resolveRoot, resolveWithinRoot } from '@/server/lib/fs/root';
24
+ import { normalizeRelativePath } from '@/server/lib/fs/relative-path';
25
+ import { isMockMode } from '@/server/mock.server';
26
+ import { deleteAnnotation, listAnnotations, saveAnnotation } from '@/server/lib/review/store.server';
27
+ import type { BlockVerdict } from '@/shared/lib/markdown/blocks/types';
28
+
29
+ /** The scope key for one (root, repo) pair, or null when the pair is invalid. */
30
+ async function resolveScope(root: string | null, repo: string | null): Promise<{ scope: string; repo: string } | null> {
31
+ const resolvedRoot = await resolveRoot(root, await getDefaultFsRoot(isMockMode()));
32
+ const scopedRepo = repo && repo !== '.' ? repo : '.';
33
+ // A nested repo is only valid INSIDE this root; anything else is the same 403
34
+ // `/api/fs/dir` answers rather than a silently different document.
35
+ if (scopedRepo !== '.' && resolveWithinRoot(resolvedRoot, scopedRepo) === null) return null;
36
+ return { scope: `${resolvedRoot}\u0000${scopedRepo}`, repo: scopedRepo };
37
+ }
38
+
39
+ function normalizedPath(raw: unknown): string | null {
40
+ if (typeof raw !== 'string' || !raw.trim()) return null;
41
+ return normalizeRelativePath(raw);
42
+ }
43
+
44
+ export async function loader({ request }: LoaderFunctionArgs) {
45
+ const url = new URL(request.url);
46
+ const path = normalizedPath(url.searchParams.get('path'));
47
+ if (!path) return json({ error: 'path is required' }, { status: 400, headers: NO_STORE_HEADERS });
48
+ const target = await resolveScope(url.searchParams.get('root'), url.searchParams.get('repo'));
49
+ if (!target) return json({ error: 'Invalid repo path' }, { status: 403, headers: NO_STORE_HEADERS });
50
+
51
+ const annotations = await listAnnotations(target.scope, path);
52
+ return json({ annotations, scope: target.scope }, { headers: NO_STORE_HEADERS });
53
+ }
54
+
55
+ /** One field at a time, so a bad body names what is wrong instead of "invalid". */
56
+ interface ParsedBody {
57
+ scope?: never;
58
+ root: string | null;
59
+ repo: string | null;
60
+ path: string | null;
61
+ blockKey: string | null;
62
+ lineStart: number;
63
+ lineEnd: number;
64
+ verdict: BlockVerdict | null;
65
+ note: string;
66
+ quote: string;
67
+ }
68
+
69
+ function parseBody(raw: unknown): ParsedBody | string {
70
+ if (typeof raw !== 'object' || raw === null) return 'body must be an object';
71
+ const body = raw as Record<string, unknown>;
72
+ const blockKey = typeof body.blockKey === 'string' ? body.blockKey.trim() : '';
73
+ if (!blockKey) return 'blockKey is required';
74
+ if (body.verdict !== 'good' && body.verdict !== 'needs-work') return 'verdict must be "good" or "needs-work"';
75
+ const line = (value: unknown): number => (typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : 0);
76
+ return {
77
+ root: typeof body.root === 'string' ? body.root : null,
78
+ repo: typeof body.repo === 'string' ? body.repo : null,
79
+ path: normalizedPath(body.path),
80
+ blockKey,
81
+ lineStart: line(body.lineStart),
82
+ lineEnd: line(body.lineEnd),
83
+ verdict: body.verdict,
84
+ note: typeof body.note === 'string' ? body.note.slice(0, 4000) : '',
85
+ quote: typeof body.quote === 'string' ? body.quote.slice(0, 400) : '',
86
+ };
87
+ }
88
+
89
+ async function saveFrom({ request }: ActionFunctionArgs) {
90
+ const parsed = parseBody(await request.json().catch(() => null));
91
+ if (typeof parsed === 'string') return json({ error: parsed }, { status: 400 });
92
+ if (!parsed.path) return json({ error: 'path is required' }, { status: 400 });
93
+ if (!parsed.verdict) return json({ error: 'verdict is required' }, { status: 400 });
94
+ const target = await resolveScope(parsed.root, parsed.repo);
95
+ if (!target) return json({ error: 'Invalid repo path' }, { status: 403 });
96
+
97
+ const annotation = await saveAnnotation({
98
+ scope: target.scope,
99
+ path: parsed.path,
100
+ blockKey: parsed.blockKey as string,
101
+ lineStart: parsed.lineStart,
102
+ lineEnd: parsed.lineEnd,
103
+ verdict: parsed.verdict,
104
+ note: parsed.note,
105
+ quote: parsed.quote,
106
+ });
107
+ return json({ annotation }, { headers: NO_STORE_HEADERS });
108
+ }
109
+
110
+ async function removeFrom({ request }: ActionFunctionArgs) {
111
+ const id = new URL(request.url).searchParams.get('id');
112
+ if (!id) return json({ error: 'id is required' }, { status: 400 });
113
+ const removed = await deleteAnnotation(id);
114
+ if (!removed) return json({ error: 'No annotation with that id' }, { status: 404 });
115
+ return json({ success: true }, { headers: NO_STORE_HEADERS });
116
+ }
117
+
118
+ export async function action(args: ActionFunctionArgs) {
119
+ switch (args.request.method) {
120
+ case 'POST':
121
+ return saveFrom(args);
122
+ case 'DELETE':
123
+ return removeFrom(args);
124
+ default:
125
+ return methodNotAllowedResponse();
126
+ }
127
+ }
@@ -0,0 +1,191 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * `/api/review` — the annotation contract.
8
+ *
9
+ * What is pinned is what a silent wrong answer would cost: a save that replaces
10
+ * instead of stacking (a block carries ONE judgement), a delete that answers
11
+ * success for an id that does not exist (the caller would believe the mark is
12
+ * gone), a body the server never validates (a note reaching SQLite as an
13
+ * object), and a repo that escapes its root (two documents sharing one scope).
14
+ *
15
+ * The database is a temp SQLite file, never the developer's — the same
16
+ * `isolateDb` rule every database-touching suite follows.
17
+ */
18
+
19
+ import { afterAll, beforeEach, describe, expect, test } from 'bun:test';
20
+ import fs from 'node:fs';
21
+ import os from 'node:os';
22
+ import path from 'node:path';
23
+
24
+ import { getDb } from '@/server/db.server';
25
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
26
+ import { removeDir } from '@/test-support/remove-dir';
27
+ import type { ActionFunctionArgs, LoaderFunctionArgs } from '@/server/lib/remix-compat';
28
+ import { action, loader } from '@/server/routes/review/index';
29
+
30
+ const ROOT = path.join(os.tmpdir(), `kabmo-review-route-${process.pid}`);
31
+
32
+ function request(method: string, url: string, body?: unknown): Request {
33
+ return new Request(`http://localhost${url}`, {
34
+ method,
35
+ headers: body === undefined ? undefined : { 'content-type': 'application/json' },
36
+ body: body === undefined ? undefined : JSON.stringify(body),
37
+ });
38
+ }
39
+
40
+ async function get(query: string) {
41
+ const response = (await loader({ request: request('GET', `/api/review?${query}`) } as LoaderFunctionArgs)) as Response;
42
+ return { status: response.status, body: (await response.json()) as Record<string, any> };
43
+ }
44
+
45
+ async function call(method: 'POST' | 'DELETE', url: string, body?: unknown) {
46
+ const response = (await action({ request: request(method, url, body) } as ActionFunctionArgs)) as Response;
47
+ return { status: response.status, body: (await response.json()) as Record<string, any> };
48
+ }
49
+
50
+ const target = { path: 'NOTES.md', root: ROOT, repo: '.' };
51
+
52
+ beforeEach(async () => {
53
+ fs.mkdirSync(path.join(ROOT, 'nested'), { recursive: true });
54
+ await isolateDb();
55
+ // `resolveRoot` only accepts an allow-listed directory (the app root, a
56
+ // dropped-in root, or a REGISTERED workspace), so a temp directory has to be
57
+ // registered exactly as the UI's own folder creation would register it —
58
+ // otherwise every scope in this suite silently falls back to the app root and
59
+ // the assertions below would pass for the wrong reason.
60
+ const db = await getDb();
61
+ await db.run('INSERT INTO workspace_folders (name, project_path) VALUES (?, ?)', ['review-test', ROOT]);
62
+ });
63
+
64
+ afterAll(async () => {
65
+ await releaseDb();
66
+ removeDir(ROOT);
67
+ });
68
+
69
+ describe('POST /api/review', () => {
70
+ test('a save is readable back under the resolved scope', async () => {
71
+ const saved = await call('POST', '/api/review', {
72
+ ...target,
73
+ blockKey: 'paragraph:abc#1',
74
+ lineStart: 3,
75
+ lineEnd: 4,
76
+ verdict: 'needs-work',
77
+ note: 'stale',
78
+ quote: 'Some paragraph',
79
+ });
80
+ expect(saved.status).toBe(200);
81
+ expect(saved.body.annotation).toMatchObject({ blockKey: 'paragraph:abc#1', verdict: 'needs-work', note: 'stale' });
82
+
83
+ const listed = await get(`path=NOTES.md&root=${encodeURIComponent(ROOT)}&repo=.`);
84
+ expect(listed.status).toBe(200);
85
+ expect(listed.body.annotations).toHaveLength(1);
86
+ // The scope is the resolved pair, not the raw `root` as sent.
87
+ expect(listed.body.scope).toBe(`${ROOT}\u0000.`);
88
+ });
89
+
90
+ test('a second judgement on the SAME block replaces the first', async () => {
91
+ const base = { ...target, blockKey: 'paragraph:abc#1', lineStart: 3, lineEnd: 3, quote: 'x' };
92
+ await call('POST', '/api/review', { ...base, verdict: 'needs-work', note: 'wrong' });
93
+ const second = await call('POST', '/api/review', { ...base, verdict: 'good', note: 'fixed' });
94
+
95
+ expect(second.body.annotation.note).toBe('fixed');
96
+ const listed = await get(`path=NOTES.md&root=${encodeURIComponent(ROOT)}`);
97
+ expect(listed.body.annotations).toHaveLength(1);
98
+ expect(listed.body.annotations[0].verdict).toBe('good');
99
+ // `created_at` survives the replace, so "when was this first judged" stays
100
+ // answerable; `updated_at` moves.
101
+ expect(listed.body.annotations[0].createdAt).toBe(second.body.annotation.createdAt);
102
+ });
103
+
104
+ test('two paths and two scopes never see each other', async () => {
105
+ const body = { blockKey: 'paragraph:abc#1', lineStart: 1, lineEnd: 1, verdict: 'good', note: '', quote: '' };
106
+ await call('POST', '/api/review', { ...body, path: 'A.md', root: ROOT });
107
+ await call('POST', '/api/review', { ...body, path: 'B.md', root: ROOT });
108
+ await call('POST', '/api/review', { ...body, path: 'A.md', root: ROOT, repo: 'nested' });
109
+
110
+ const a = await get(`path=A.md&root=${encodeURIComponent(ROOT)}`);
111
+ const nested = await get(`path=A.md&root=${encodeURIComponent(ROOT)}&repo=nested`);
112
+ expect(a.body.annotations).toHaveLength(1);
113
+ expect(nested.body.annotations).toHaveLength(1);
114
+ expect(a.body.scope).not.toBe(nested.body.scope);
115
+ });
116
+
117
+ test('a bad verdict, a missing blockKey and a missing path are 400s with reasons', async () => {
118
+ const badVerdict = await call('POST', '/api/review', { ...target, blockKey: 'k', verdict: 'meh' });
119
+ expect(badVerdict.status).toBe(400);
120
+ expect(badVerdict.body.error).toContain('verdict');
121
+
122
+ const noKey = await call('POST', '/api/review', { ...target, verdict: 'good' });
123
+ expect(noKey.status).toBe(400);
124
+ expect(noKey.body.error).toContain('blockKey');
125
+
126
+ const noPath = await call('POST', '/api/review', { verdict: 'good', blockKey: 'k' });
127
+ expect(noPath.status).toBe(400);
128
+ expect(noPath.body.error).toContain('path');
129
+ });
130
+
131
+ test('an unregistered root falls back to the server default, never to the path sent', async () => {
132
+ const unregistered = path.join(os.tmpdir(), `kabmo-not-a-workspace-${process.pid}`);
133
+ fs.mkdirSync(unregistered, { recursive: true });
134
+ const listed = await get(`path=NOTES.md&root=${encodeURIComponent(unregistered)}`);
135
+ expect(listed.status).toBe(200);
136
+ expect(listed.body.scope).not.toContain(unregistered);
137
+ removeDir(unregistered);
138
+ });
139
+
140
+ test('a repo outside the root is refused, not silently scoped elsewhere', async () => {
141
+ const response = await call('POST', '/api/review', {
142
+ ...target,
143
+ repo: '../../etc',
144
+ blockKey: 'k',
145
+ verdict: 'good',
146
+ });
147
+ expect(response.status).toBe(403);
148
+ });
149
+
150
+ test('a non-positive line number is stored as 0 rather than corrupting the row', async () => {
151
+ const saved = await call('POST', '/api/review', {
152
+ ...target,
153
+ blockKey: 'k',
154
+ lineStart: -4,
155
+ lineEnd: 2.5,
156
+ verdict: 'good',
157
+ });
158
+ expect(saved.body.annotation.lineStart).toBe(0);
159
+ expect(saved.body.annotation.lineEnd).toBe(0);
160
+ });
161
+ });
162
+
163
+ describe('DELETE /api/review', () => {
164
+ test('removes the row, and an unknown id is a 404 rather than a success', async () => {
165
+ const saved = await call('POST', '/api/review', { ...target, blockKey: 'k', verdict: 'good' });
166
+ const id = saved.body.annotation.id as string;
167
+
168
+ const removed = await call('DELETE', `/api/review?id=${id}`);
169
+ expect(removed.status).toBe(200);
170
+ expect((await get(`path=NOTES.md&root=${encodeURIComponent(ROOT)}`)).body.annotations).toHaveLength(0);
171
+
172
+ const again = await call('DELETE', `/api/review?id=${id}`);
173
+ expect(again.status).toBe(404);
174
+ });
175
+
176
+ test('a missing id is a 400', async () => {
177
+ const response = await call('DELETE', '/api/review');
178
+ expect(response.status).toBe(400);
179
+ });
180
+ });
181
+
182
+ describe('the route owns its verbs', () => {
183
+ test('an unsupported method answers 405, not a phantom success', async () => {
184
+ const response = await action({ request: request('PUT', '/api/review', {}) } as ActionFunctionArgs);
185
+ expect((response as Response).status).toBe(405);
186
+ });
187
+
188
+ test('a GET without a path is a 400', async () => {
189
+ expect((await get('')).status).toBe(400);
190
+ });
191
+ });
@@ -0,0 +1,180 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The Agents settings route, which reads and writes omp's OWN definition files
8
+ * (`~/.omp/agent/agents/*.md`, `<workspace>/.omp/agents/*.md`).
9
+ *
10
+ * These cases live here rather than in the SQLite-store suite because this route
11
+ * touches no database: the file is the record, and the panel is a view of it.
12
+ * Each case pins a failure a user would otherwise see as "saving did nothing":
13
+ *
14
+ * - a write lands in the agent dir, and the list answers with the file it
15
+ * came from, so the pane can rename or delete the right one;
16
+ * - a rename REMOVES the old file (otherwise one definition survives twice);
17
+ * - an unsafe file name or an empty prompt is a 400 with a sentence, not a 500;
18
+ * - MOCK serves the demo presets and refuses to touch disk.
19
+ */
20
+
21
+ import { afterAll, beforeEach, describe, expect, test } from 'bun:test';
22
+ import fs from 'fs';
23
+ import os from 'os';
24
+ import path from 'path';
25
+ import { DEFAULT_AGENTS_LIST } from '@/client/data/agent-data';
26
+ import { action as agentsAction, loader as agentsLoader } from '@/server/routes/settings/agents';
27
+ import { removeDir } from '@/test-support/remove-dir';
28
+
29
+ const ROOT = path.join(os.tmpdir(), 'omc-settings-agents-route-test');
30
+ const API = 'http://localhost/api/settings';
31
+ const ORIGINAL_AGENT_DIR = Bun.env.PI_CODING_AGENT_DIR;
32
+
33
+ /**
34
+ * A CLEAN agent dir per case, not one shared by the file.
35
+ *
36
+ * The cases assert on what a write left behind (`toEqual(['helper-2.md'])`), so
37
+ * a file a previous case created is a failure that names the wrong thing: a
38
+ * delete refused for a full-path `fileName` left `reviewer.md` behind and the
39
+ * rename case then failed on the leftover rather than on its own behaviour.
40
+ */
41
+ beforeEach(() => {
42
+ removeDir(ROOT);
43
+ fs.mkdirSync(path.join(ROOT, 'agent', 'agents'), { recursive: true });
44
+ Bun.env.PI_CODING_AGENT_DIR = path.join(ROOT, 'agent');
45
+ delete Bun.env.MOCK;
46
+ });
47
+
48
+ afterAll(() => {
49
+ if (ORIGINAL_AGENT_DIR === undefined) delete Bun.env.PI_CODING_AGENT_DIR;
50
+ else Bun.env.PI_CODING_AGENT_DIR = ORIGINAL_AGENT_DIR;
51
+ delete Bun.env.MOCK;
52
+ removeDir(ROOT);
53
+ });
54
+
55
+ type Handler = (args: never) => unknown;
56
+
57
+ function call(handler: Handler, request: Request): Promise<Response> {
58
+ return handler({ request, params: {} } as never) as Promise<Response>;
59
+ }
60
+
61
+ function send(url: string, verb: string, body?: unknown): Request {
62
+ return new Request(url, {
63
+ method: verb,
64
+ ...(body === undefined ? {} : { body: JSON.stringify(body), headers: { 'content-type': 'application/json' } }),
65
+ });
66
+ }
67
+
68
+ describe('settings agents', () => {
69
+ test('the list is omp’s definition files, with the file each one came from', async () => {
70
+ await call(agentsAction, send(`${API}/agents`, 'POST', {
71
+ type: 'write', fileName: 'reviewer', name: 'Reviewer', systemPrompt: 'You review.',
72
+ }));
73
+ const body = await (await call(agentsLoader, new Request(`${API}/agents`))).json();
74
+ expect(body.isMock).toBe(false);
75
+ expect(body.agents).toHaveLength(1);
76
+ expect(body.agents[0]).toMatchObject({
77
+ id: 'omp-user-reviewer',
78
+ name: 'Reviewer',
79
+ scope: 'user',
80
+ sourceRoot: 'user',
81
+ fileName: 'reviewer',
82
+ isBuiltIn: false,
83
+ });
84
+ expect(body.agents[0].filePath).toEndWith('reviewer.md');
85
+ await call(agentsAction, send(`${API}/agents`, 'POST', { type: 'delete', fileName: 'reviewer' }));
86
+ });
87
+
88
+ test('a write lands in the agent dir and a rename removes the old file', async () => {
89
+ const written = await call(agentsAction, send(`${API}/agents`, 'POST', {
90
+ type: 'write', fileName: 'helper', name: 'Helper', systemPrompt: 'You help.',
91
+ }));
92
+ expect(written.status).toBe(200);
93
+ expect((await written.json()).path).toEndWith('helper.md');
94
+
95
+ const renamed = await call(agentsAction, send(`${API}/agents`, 'POST', {
96
+ type: 'write', fileName: 'helper-2', name: 'Helper 2', previousFileName: 'helper', systemPrompt: 'You help twice.',
97
+ }));
98
+ expect(renamed.status).toBe(200);
99
+ expect(fs.readdirSync(path.join(ROOT, 'agent', 'agents'))).toEqual(['helper-2.md']);
100
+
101
+ const deleted = await call(agentsAction, send(`${API}/agents`, 'POST', { type: 'delete', fileName: 'helper-2' }));
102
+ expect(deleted.status).toBe(200);
103
+ expect((await deleted.json()).agents).toEqual([]);
104
+ });
105
+
106
+ test('a definition carries every key the pane offers, and nothing it does not', async () => {
107
+ await call(agentsAction, send(`${API}/agents`, 'POST', {
108
+ type: 'write',
109
+ fileName: 'tuned',
110
+ name: 'Tuned',
111
+ description: 'Capabilities pinned',
112
+ model: 'kenari/deepseek-v4-1-flash',
113
+ thinkingLevel: 'high',
114
+ tools: ['read', 'grep'],
115
+ spawns: '*',
116
+ systemPrompt: 'You are tuned.',
117
+ }));
118
+ const file = fs.readFileSync(path.join(ROOT, 'agent', 'agents', 'tuned.md'), 'utf8');
119
+ expect(file).toContain('model: "kenari/deepseek-v4-1-flash"');
120
+ expect(file).toContain('thinkingLevel: high');
121
+ expect(file).toContain('tools: read, grep');
122
+ expect(file).toContain('spawns: "*"');
123
+ // omp ignores these three, so writing them would be dead config.
124
+ expect(file).not.toContain('mode:');
125
+ expect(file).not.toContain('temperature');
126
+ expect(file).not.toContain('top_p');
127
+
128
+ const body = await (await call(agentsLoader, new Request(`${API}/agents`))).json();
129
+ expect(body.agents[0]).toMatchObject({
130
+ name: 'Tuned',
131
+ model: 'kenari/deepseek-v4-1-flash',
132
+ thinkingLevel: 'high',
133
+ tools: ['read', 'grep'],
134
+ spawns: '*',
135
+ });
136
+ await call(agentsAction, send(`${API}/agents`, 'POST', { type: 'delete', fileName: 'tuned' }));
137
+ });
138
+
139
+ test('deleting a file that does not exist names it', async () => {
140
+ const missing = await call(agentsAction, send(`${API}/agents`, 'POST', { type: 'delete', fileName: 'gone' }));
141
+ expect(missing.status).toBe(404);
142
+ expect(await missing.json()).toEqual({ error: 'No agent file named “gone”' });
143
+ });
144
+
145
+ test('an invalid file name and an empty prompt are 400 refusals', async () => {
146
+ const badName = await call(agentsAction, send(`${API}/agents`, 'POST', { type: 'write', fileName: 'bad name', systemPrompt: 'x' }));
147
+ expect(badName.status).toBe(400);
148
+ expect(await badName.json()).toEqual({
149
+ error: 'Agent file name may contain letters, numbers, dots, dashes, and underscores',
150
+ });
151
+
152
+ const empty = await call(agentsAction, send(`${API}/agents`, 'POST', { type: 'write', fileName: 'ok', systemPrompt: ' ' }));
153
+ expect(empty.status).toBe(400);
154
+ expect(await empty.json()).toEqual({ error: 'Agent system prompt cannot be empty' });
155
+ });
156
+
157
+ test('an unknown action is refused rather than silently ignored', async () => {
158
+ const res = await call(agentsAction, send(`${API}/agents`, 'POST', { type: 'write_native', fileName: 'x' }));
159
+ expect(res.status).toBe(400);
160
+ expect(await res.json()).toEqual({ error: 'Unknown action “write_native”' });
161
+ });
162
+
163
+ test('MOCK serves the demo presets and refuses every write', async () => {
164
+ Bun.env.MOCK = 'true';
165
+ const write = await call(agentsAction, send(`${API}/agents`, 'POST', { type: 'write', fileName: 'x', systemPrompt: 'y' }));
166
+ expect(write.status).toBe(400);
167
+ expect(await write.json()).toEqual({ error: 'Agent files cannot be written in mock mode' });
168
+
169
+ const body = await (await call(agentsLoader, new Request(`${API}/agents`))).json();
170
+ expect(body.isMock).toBe(true);
171
+ expect(body.agents).toHaveLength(DEFAULT_AGENTS_LIST.length);
172
+ Bun.env.MOCK = 'false';
173
+ });
174
+
175
+ test('a wrong verb is the route-owned 405', async () => {
176
+ const res = await call(agentsAction, send(`${API}/agents`, 'PATCH'));
177
+ expect(res.status).toBe(405);
178
+ expect(await res.json()).toEqual({ error: 'Method not allowed' });
179
+ });
180
+ });