@bevel-software/platform-core-frontend 0.15.1 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (346) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +16 -9
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/events.test.ts +43 -0
  6. package/src/core/bootstrap.ts +11 -3
  7. package/src/core/events.ts +85 -3
  8. package/src/core/registry.ts +1 -1
  9. package/src/lib/__tests__/email.test.ts +44 -0
  10. package/src/lib/email.ts +37 -1
  11. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  12. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  16. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  20. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +721 -126
  21. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  22. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  23. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  24. package/src/modules/access/api.ts +140 -6
  25. package/src/modules/access/components/ManageAccessDialog.tsx +1299 -561
  26. package/src/modules/access/manage-access-affordance.ts +17 -0
  27. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  28. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  29. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  30. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  31. package/src/modules/admin/__tests__/ConnectionKeysPage.test.tsx +266 -0
  32. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  33. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  34. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  35. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  36. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  37. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  38. package/src/modules/admin/components/ConnectionKeysPage.tsx +269 -0
  39. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  40. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  41. package/src/modules/admin/components/connection-keys-grouping.ts +43 -0
  42. package/src/modules/admin/components/group-members-path.ts +32 -0
  43. package/src/modules/admin/services/connection-keys.api.ts +47 -0
  44. package/src/modules/admin/services/roles.api.ts +12 -1
  45. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  46. package/src/modules/auth/components/AccountPage.tsx +73 -54
  47. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  48. package/src/modules/auth/services/account.api.ts +78 -4
  49. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  50. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  51. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  52. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  53. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  57. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  58. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  59. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  60. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  61. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  62. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  63. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  64. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  65. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  66. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  67. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  68. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  69. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  70. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  71. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  72. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  73. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  74. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  75. package/src/modules/change-requests/services/propose.api.ts +97 -8
  76. package/src/modules/change-requests/utils/approval.ts +15 -0
  77. package/src/modules/change-requests/utils/author.ts +32 -0
  78. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  79. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  80. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  81. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  82. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  83. package/src/modules/git/services/error-messages.ts +12 -0
  84. package/src/modules/git/services/pr-prompts.ts +5 -5
  85. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  86. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  87. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  88. package/src/modules/layout/components/AppLayout.tsx +2 -0
  89. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  90. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  91. package/src/modules/layout/components/SidebarFrame.tsx +108 -3
  92. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  93. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  94. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  95. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  96. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  97. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
  98. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
  99. package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
  100. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
  101. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  102. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  103. package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
  104. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  105. package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
  106. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
  107. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
  108. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  109. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  110. package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
  111. package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
  112. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  113. package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
  114. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
  115. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  116. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  117. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  118. package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
  119. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  120. package/src/modules/library/__tests__/library-paths.test.ts +47 -4
  121. package/src/modules/library/__tests__/link-membership.test.ts +13 -4
  122. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  123. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  124. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  125. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  126. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  127. package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
  128. package/src/modules/library/__tests__/status.test.ts +82 -2
  129. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  130. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  131. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  132. package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
  133. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  134. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  135. package/src/modules/library/components/LibraryCard.tsx +146 -45
  136. package/src/modules/library/components/LibraryLayout.tsx +119 -256
  137. package/src/modules/library/components/LibraryPage.tsx +172 -39
  138. package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
  139. package/src/modules/library/components/LockedPluginView.tsx +62 -34
  140. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  141. package/src/modules/library/components/NewPluginDialog.tsx +16 -2
  142. package/src/modules/library/components/PageActions.tsx +11 -9
  143. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  144. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  145. package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
  146. package/src/modules/library/components/PluginExtras.tsx +140 -17
  147. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  148. package/src/modules/library/components/PluginPage.tsx +157 -41
  149. package/src/modules/library/components/PluginRows.tsx +286 -0
  150. package/src/modules/library/components/PluginsSidebar.tsx +239 -263
  151. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  152. package/src/modules/library/components/ShareButton.tsx +17 -0
  153. package/src/modules/library/components/SkillsTree.tsx +141 -28
  154. package/src/modules/library/components/TeamRoute.tsx +15 -0
  155. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  156. package/src/modules/library/components/plugin-page-parts.tsx +103 -17
  157. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
  158. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  159. package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
  160. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  161. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  162. package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
  163. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  164. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  165. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  166. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  167. package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
  168. package/src/modules/library/routes/library-paths.ts +26 -28
  169. package/src/modules/library/services/library.api.ts +38 -20
  170. package/src/modules/library/services/plugins.api.ts +69 -8
  171. package/src/modules/library/services/teams.api.ts +15 -0
  172. package/src/modules/library/services/tools.api.ts +78 -0
  173. package/src/modules/library/state/library-data.tsx +170 -32
  174. package/src/modules/library/utils/personal-plugin.ts +13 -15
  175. package/src/modules/library/utils/plugin-entries.ts +134 -0
  176. package/src/modules/library/utils/plugin-summary.ts +75 -9
  177. package/src/modules/library/utils/status.ts +135 -33
  178. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
  179. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  180. package/src/modules/onboarding/agent-clients.ts +55 -23
  181. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  182. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  183. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  184. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  185. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  186. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  187. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  188. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  189. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  190. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  191. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  192. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  193. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  194. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  195. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  196. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  197. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  198. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  199. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  200. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  201. package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
  202. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  203. package/src/modules/settings/components/DeploymentPage.tsx +10 -30
  204. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  205. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
  206. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  207. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +5 -5
  208. package/src/modules/settings/services/github-facade.api.ts +23 -0
  209. package/src/modules/settings/settings-nav-items.tsx +10 -2
  210. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  211. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  212. package/src/modules/setup/__tests__/setup.test.tsx +497 -4
  213. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  214. package/src/modules/setup/components/SetupGate.tsx +16 -16
  215. package/src/modules/setup/components/SetupScreen.tsx +521 -43
  216. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  217. package/src/modules/setup/services/setup.api.ts +140 -3
  218. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  219. package/src/modules/setup/utils/root-folders.ts +46 -0
  220. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  221. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  222. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  223. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  224. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  225. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  226. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  227. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  228. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  229. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  230. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  231. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  232. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  233. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  234. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  235. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  236. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
  237. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  238. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  239. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  240. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
  241. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  242. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  243. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  244. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  245. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  246. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  247. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  248. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  249. package/src/modules/toolbar/services/external-api-keys.api.ts +6 -0
  250. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  251. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  252. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  253. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  254. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  255. package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
  256. package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
  257. package/src/modules/workspace/components/FileRoute.tsx +353 -36
  258. package/src/modules/workspace/components/FileViewer.tsx +166 -45
  259. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  260. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  261. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  262. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2473 -129
  263. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
  264. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +331 -12
  265. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  266. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  267. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  268. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  269. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  270. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  271. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  272. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  273. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  274. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  275. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  276. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  277. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  278. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  279. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  280. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  281. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  282. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  283. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  284. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  285. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  286. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  287. package/src/modules/workspace/components/renderers/index.ts +53 -2
  288. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  289. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  290. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  291. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  292. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  293. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  294. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  295. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
  296. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  297. package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
  298. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  299. package/src/modules/workspace/routing/kb-routes.ts +206 -29
  300. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +57 -1
  301. package/src/modules/workspace/services/workspace.api.ts +57 -4
  302. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  303. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  304. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  305. package/src/modules/workspace/state/workspace.context.ts +125 -19
  306. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  307. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
  308. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  309. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  310. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  311. package/src/modules/workspace/utils/file-trace.ts +50 -0
  312. package/src/modules/workspace/utils/fileTree.ts +112 -36
  313. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  314. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  315. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  316. package/src/modules/workspace/utils/uploadError.ts +29 -0
  317. package/src/shared/__tests__/marketplace-url.test.ts +6 -1
  318. package/src/shared/components/Button.tsx +16 -2
  319. package/src/shared/components/Dialog.tsx +27 -11
  320. package/src/shared/components/Menu.tsx +13 -1
  321. package/src/shared/components/PageShell.tsx +13 -8
  322. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  323. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  324. package/src/shared/components/index.ts +2 -0
  325. package/src/shared/components/useDismissableMenu.ts +32 -10
  326. package/src/shared/components/useFocusHandoff.ts +51 -0
  327. package/src/shared/components/useLatestRef.ts +28 -0
  328. package/src/shared/markdown/Markdown.tsx +12 -3
  329. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  330. package/src/shared/markdown/hrefs.ts +50 -0
  331. package/src/shared/marketplace-url.ts +33 -5
  332. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  333. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  334. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  335. package/src/shared/mcp/connect-snippets.ts +14 -9
  336. package/src/shared/mcp/index.ts +1 -1
  337. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  338. package/src/shared/theme/header.ts +75 -0
  339. package/src/shared/theme/measure.ts +7 -4
  340. package/src/shared/theme/tokens.css +25 -0
  341. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  342. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  343. package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
  344. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  345. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  346. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -487,7 +487,7 @@ describe('Toolbar', () => {
487
487
  renderToolbar({ isAdmin: true });
488
488
  await openMenu();
489
489
  expect(within(panel()).getByText('Admin only')).toBeInTheDocument();
490
- expect(row(/Roles/)).toBeInTheDocument();
490
+ expect(row('App roles')).toBeInTheDocument();
491
491
  expect(row('Stub admin row')).toBeInTheDocument();
492
492
  // All-user rows are still present alongside the admin ones.
493
493
  expect(row('Stub extension')).toBeInTheDocument();
@@ -512,7 +512,7 @@ describe('Toolbar', () => {
512
512
  it('navigates to /roles-and-members from the admin row', async () => {
513
513
  renderToolbar({ isAdmin: true });
514
514
  await openMenu();
515
- await userEvent.click(row('Roles & Members'));
515
+ await userEvent.click(row('App roles'));
516
516
  expect(screen.getByTestId('pathname')).toHaveTextContent('/roles-and-members');
517
517
  expect(panelGone()).toBeNull();
518
518
  });
@@ -0,0 +1,104 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ SHOT_HEIGHT,
4
+ SHOT_WIDTH,
5
+ addCustomConnectorShot,
6
+ addManuallyShot,
7
+ connectorNotAddedShot,
8
+ installPluginsShot,
9
+ pluginsAddShot,
10
+ selectRepositoryShot,
11
+ } from '../claude-setup-shots';
12
+
13
+ describe('Claude setup screenshot callouts', () => {
14
+ it('points non-admins at the repository picker trigger', () => {
15
+ expect(selectRepositoryShot.alt).toContain('Select repository');
16
+ expect(selectRepositoryShot.boxes).toHaveLength(1);
17
+ });
18
+
19
+ it('highlights both Plugins and Add before opening the marketplace menu', () => {
20
+ expect(pluginsAddShot.boxes).toHaveLength(2);
21
+ expect(pluginsAddShot.alt).toContain('Plugins tab');
22
+ expect(pluginsAddShot.alt).toContain('Add button');
23
+ });
24
+
25
+ it('highlights the whole Hexis all row', () => {
26
+ expect(installPluginsShot.boxes).toHaveLength(1);
27
+ expect(installPluginsShot.boxes[0].w).toBeGreaterThan(60);
28
+ expect(installPluginsShot.alt).toContain('whole Hexis all row');
29
+ });
30
+
31
+ /**
32
+ * The connector shots. Their alt text has to name the state the reader is
33
+ * looking for (Not added) and the control that changes it, because the red
34
+ * rectangle is `aria-hidden` and carries none of that.
35
+ */
36
+ it('names the Not added row and the button that fixes it', () => {
37
+ expect(connectorNotAddedShot.alt).toContain('Not added');
38
+ expect(connectorNotAddedShot.alt).toContain('Add for your team');
39
+ expect(connectorNotAddedShot.alt).toContain('Tools and data sources');
40
+ expect(connectorNotAddedShot.boxes).toHaveLength(2);
41
+ });
42
+
43
+ it('names the Add custom connector dialog, its filled fields and Continue', () => {
44
+ expect(addCustomConnectorShot.alt).toContain('Add custom connector dialog');
45
+ expect(addCustomConnectorShot.alt).toContain('already filled in');
46
+ expect(addCustomConnectorShot.alt).toContain('Continue');
47
+ expect(addCustomConnectorShot.boxes).toHaveLength(2);
48
+ });
49
+
50
+ /**
51
+ * Boxes are PERCENTAGES of the image, never pixels: the shots render into
52
+ * a column much narrower than they were measured at. A box that leaves the
53
+ * image is the tell that someone pasted pixel offsets in.
54
+ */
55
+ it('keeps every connector box inside the image, as a percentage', () => {
56
+ for (const shot of [connectorNotAddedShot, addCustomConnectorShot]) {
57
+ for (const box of shot.boxes) {
58
+ // Both edges, not just the far one: a negative offset leaves the
59
+ // image off the left or the top and still satisfies x + w <= 100.
60
+ expect(box.x).toBeGreaterThanOrEqual(0);
61
+ expect(box.y).toBeGreaterThanOrEqual(0);
62
+ expect(box.x + box.w).toBeLessThanOrEqual(100);
63
+ expect(box.y + box.h).toBeLessThanOrEqual(100);
64
+ expect(box.w).toBeGreaterThan(1);
65
+ expect(box.h).toBeGreaterThan(1);
66
+ }
67
+ }
68
+ });
69
+
70
+ /**
71
+ * A dialog and a plugin panel are not the shape of a full window, so they
72
+ * carry their own intrinsic size rather than being padded to the nine
73
+ * window shots' 1400x1080 — which is what the column reserves before the
74
+ * bytes land.
75
+ */
76
+ it('lets a shot declare its own size, and leaves the window shots on the default', () => {
77
+ expect(addManuallyShot.width).toBeUndefined();
78
+ expect(addManuallyShot.height).toBeUndefined();
79
+ expect(installPluginsShot.height).toBeUndefined();
80
+ for (const shot of [connectorNotAddedShot, addCustomConnectorShot]) {
81
+ expect(shot.width).toBe(SHOT_WIDTH);
82
+ expect(shot.height).toBe(700);
83
+ expect(shot.height).not.toBe(SHOT_HEIGHT);
84
+ }
85
+ });
86
+
87
+ /**
88
+ * The connector screens are drawings, not captures — nobody had the flow
89
+ * in front of a camera when the step was written. That is declared on the
90
+ * shot rather than left to the asset README, so the page can say it to
91
+ * the reader; the nine real captures stay unflagged, which is what keeps
92
+ * the note from becoming decoration on every screenshot.
93
+ *
94
+ * When real captures land, this flag comes off and the test flips with
95
+ * it.
96
+ */
97
+ it('marks only the drawn connector shots as illustrations', () => {
98
+ expect(connectorNotAddedShot.illustration).toBe(true);
99
+ expect(addCustomConnectorShot.illustration).toBe(true);
100
+ for (const shot of [addManuallyShot, installPluginsShot, pluginsAddShot, selectRepositoryShot]) {
101
+ expect(shot.illustration).toBeUndefined();
102
+ }
103
+ });
104
+ });
@@ -0,0 +1,38 @@
1
+ import { addCustomConnectorShot, connectorNotAddedShot } from './claude-setup-shots';
2
+ import type { CarouselSlide } from './SetupCarousel';
3
+
4
+ /**
5
+ * The last step of BOTH Claude setup routes, written once.
6
+ *
7
+ * Installing the plugin is where the tutorial used to stop, and it is not
8
+ * where the setup stops: the plugin brings the skills, and its MCP server is
9
+ * a connector Claude adds separately. A reader who left at "Add Hexis all"
10
+ * had the skills and no knowledge base, with nothing on screen saying so.
11
+ *
12
+ * ONE definition, imported by the personal carousel and by the admin's
13
+ * registration carousel, because the two are the same action on the same
14
+ * screen. Two copies of this paragraph would be two chances to update only
15
+ * one of them, and the admin's copy is the one nobody rereads.
16
+ *
17
+ * No deployment host in the copy, deliberately: the dialog arrives already
18
+ * filled in, so the reader never types the address, and a slide with no
19
+ * parameters is a slide that cannot be passed a different one by its two
20
+ * callers.
21
+ */
22
+ export const connectorSlide: CarouselSlide = {
23
+ shortLabel: 'Connector',
24
+ stage: 'Connect the knowledge base',
25
+ title: 'Add the hexis connector',
26
+ instruction: (
27
+ <>
28
+ Installing <b>Hexis all</b> does not connect its MCP server. Open the plugin's{' '}
29
+ <b>tools and data sources</b> list and the <code>hexis</code> row reads <b>Not added</b>.
30
+ Choose <b>Add for your team</b>: Claude opens its <b>Add custom connector</b> dialog with the
31
+ name and URL already filled in. Choose <b>Continue</b>, then approve the sign-in on this
32
+ deployment. It worked when the row no longer reads <b>Not added</b>. Without
33
+ organization-admin rights in Claude you are offered the connector for yourself instead, which
34
+ works the same for you — or ask an admin to add it for the team.
35
+ </>
36
+ ),
37
+ shots: [connectorNotAddedShot, addCustomConnectorShot],
38
+ };
@@ -0,0 +1,167 @@
1
+ /**
2
+ * The screenshots behind the Cowork / claude.ai setup steps, and the one
3
+ * thing to click in each.
4
+ *
5
+ * Highlights are PERCENTAGES of the image, never pixels. The shots are
6
+ * normalized to 1400x1080 webp on the way in (see the asset README) and they
7
+ * render into a ~700px column, so a pixel offset would be wrong at every size
8
+ * except the one it was measured at.
9
+ *
10
+ * `new URL(…, import.meta.url)` rather than `import shot from './x.webp'`:
11
+ * this package ships raw TS and is compiled by whatever bundler the host app
12
+ * runs, and the URL form resolves there without a `*.webp` module
13
+ * declaration to keep `tsc` happy. Each path is a literal because that is
14
+ * the only form a bundler can rewrite statically.
15
+ *
16
+ * The shots are of a real deployment. Names, handles and third-party
17
+ * organisations in them are blurred at build time (see the sibling
18
+ * `README.md`): this package is published, so every deployment shows them.
19
+ */
20
+
21
+ /**
22
+ * A click target, as PERCENTAGES (0–100) of the image's width and height —
23
+ * `ScreenshotStep` writes them straight into `left: x%`, so `0.881` would be
24
+ * a box a hundredth of the size meant.
25
+ */
26
+ export interface ShotHighlight {
27
+ x: number;
28
+ y: number;
29
+ w: number;
30
+ h: number;
31
+ }
32
+
33
+ export interface Shot {
34
+ src: string;
35
+ /** Names the screen AND the highlighted control: the box is decoration. */
36
+ alt: string;
37
+ boxes: ShotHighlight[];
38
+ /**
39
+ * Intrinsic size, when this shot is not the default 1400x1080. Only the
40
+ * ASPECT matters — the image renders at the column's width either way —
41
+ * but the ratio has to be the file's own, or the reserved space collapses
42
+ * to the right height only after the bytes arrive. A dialog is a shorter
43
+ * screen than a full window, and cropping it to 1080 would be padding.
44
+ */
45
+ width?: number;
46
+ height?: number;
47
+ /**
48
+ * Set when the file is a DRAWING of the screen rather than a capture of
49
+ * it. `ScreenshotStep` then prints a line under the frame saying so, for
50
+ * the reader who is holding their own Claude next to it and wondering why
51
+ * the detail does not match. The instruction and the `alt` name the row
52
+ * and the control; the pixels are a sketch of where they sit.
53
+ *
54
+ * It exists because the connector screens had no capture when the step
55
+ * was written, and the honest answer to that was to say so on the page
56
+ * rather than only in the asset README. Delete the flag from a shot the
57
+ * moment a real capture replaces it.
58
+ */
59
+ illustration?: boolean;
60
+ }
61
+
62
+ /**
63
+ * Intrinsic size of the nine window shots, so the column reserves the space
64
+ * before load. A shot that is not this shape carries its own `width`/`height`.
65
+ */
66
+ export const SHOT_WIDTH = 1400;
67
+ export const SHOT_HEIGHT = 1080;
68
+
69
+ export const addManuallyShot: Shot = {
70
+ src: new URL('../assets/claude-setup/01-add-manually.webp', import.meta.url).href,
71
+ alt: "Claude's admin settings, Claude Code page: the Add manually button beside GitHub Enterprise, under Self-hosted infrastructure.",
72
+ boxes: [{ x: 88.1, y: 80.5, w: 10.9, h: 3.7 }],
73
+ };
74
+
75
+ export const addConfigurationShot: Shot = {
76
+ src: new URL('../assets/claude-setup/02-add-configuration.webp', import.meta.url).href,
77
+ alt: 'The Add GitHub Enterprise dialog: the GitHub App credential fields, and the Add configuration button that saves them.',
78
+ boxes: [
79
+ { x: 30.0, y: 43.7, w: 39.8, h: 33.6 },
80
+ { x: 57.3, y: 94.4, w: 12.5, h: 3.9 },
81
+ ],
82
+ };
83
+
84
+ export const connectAccountShot: Shot = {
85
+ src: new URL('../assets/claude-setup/03-connect-account.webp', import.meta.url).href,
86
+ alt: "Claude's admin settings, GitHub page: the Connect button above the list of connected GitHub accounts.",
87
+ boxes: [{ x: 88.9, y: 16.7, w: 8.7, h: 3.7 }],
88
+ };
89
+
90
+ export const pickInstanceShot: Shot = {
91
+ src: new URL('../assets/claude-setup/04-pick-instance.webp', import.meta.url).href,
92
+ alt: 'The Install the Claude Code GitHub App dialog, with the GitHub instance list open on the row naming this deployment rather than github.com.',
93
+ boxes: [{ x: 37.8, y: 76.9, w: 24.3, h: 4.2 }],
94
+ };
95
+
96
+ export const selectRepositoryShot: Shot = {
97
+ src: new URL('../assets/claude-setup/09-select-repository.webp', import.meta.url).href,
98
+ alt: 'Claude Code on the web, with the Select repository button highlighted below the empty session area.',
99
+ boxes: [{ x: 38.7, y: 87.3, w: 13.6, h: 3.8 }],
100
+ };
101
+
102
+ export const pluginsAddShot: Shot = {
103
+ src: new URL('../assets/claude-setup/05-plugins-add.webp', import.meta.url).href,
104
+ alt: 'The Customize screen, with the Plugins tab and the Add button above the list highlighted.',
105
+ boxes: [
106
+ { x: 40.3, y: 11.8, w: 6.2, h: 3.9 },
107
+ { x: 89.7, y: 11.8, w: 6.8, h: 3.9 },
108
+ ],
109
+ };
110
+
111
+ export const addMarketplaceShot: Shot = {
112
+ src: new URL('../assets/claude-setup/06-add-marketplace.webp', import.meta.url).href,
113
+ alt: 'The Add menu open on the Customize screen, with Add marketplace at the top.',
114
+ boxes: [{ x: 79.8, y: 16.5, w: 15.6, h: 3.5 }],
115
+ };
116
+
117
+ export const pasteUrlShot: Shot = {
118
+ src: new URL('../assets/claude-setup/07-paste-url-sync.webp', import.meta.url).href,
119
+ alt: 'The Add marketplace dialog: the URL field holding the marketplace address, and the Sync button that fetches it.',
120
+ boxes: [
121
+ { x: 21.8, y: 52.5, w: 56.5, h: 4.1 },
122
+ { x: 72.8, y: 62.1, w: 5.3, h: 3.8 },
123
+ ],
124
+ };
125
+
126
+ export const installPluginsShot: Shot = {
127
+ src: new URL('../assets/claude-setup/08-install-plugins.webp', import.meta.url).href,
128
+ alt: 'The Discover list after a sync, with the whole Hexis all row highlighted as the bundle that installs everything at once.',
129
+ boxes: [{ x: 27.0, y: 32.1, w: 69.4, h: 7.5 }],
130
+ };
131
+
132
+ /**
133
+ * The two connector shots. Installing the plugin is not the end of the
134
+ * setup: its MCP server is a connector Claude adds separately, and these are
135
+ * the screen that says so and the dialog that does it. Both are 1400x700 —
136
+ * a plugin panel and a dialog, not a full window — so they declare their own
137
+ * size rather than being padded to the window shots' 1080.
138
+ *
139
+ * Both are `illustration` for now: drawings of the two screens, not captures
140
+ * of them, because the connector flow was not in front of a camera when the
141
+ * step was written. That is stated on the page rather than only in the asset
142
+ * README — a reader comparing their own Claude to a sketch should be told it
143
+ * is one. Drop the flag and re-measure the boxes when real captures land.
144
+ */
145
+ export const connectorNotAddedShot: Shot = {
146
+ src: new URL('../assets/claude-setup/10-connector-not-added.webp', import.meta.url).href,
147
+ alt: "The Hexis all plugin's Tools and data sources list, with the hexis MCP server row reading Not added beside the Add for your team button.",
148
+ boxes: [
149
+ { x: 66.0, y: 30.9, w: 8.9, h: 6.0 },
150
+ { x: 76.3, y: 29.7, w: 17.7, h: 8.0 },
151
+ ],
152
+ width: 1400,
153
+ height: 700,
154
+ illustration: true,
155
+ };
156
+
157
+ export const addCustomConnectorShot: Shot = {
158
+ src: new URL('../assets/claude-setup/11-add-custom-connector.webp', import.meta.url).href,
159
+ alt: "Claude's Add custom connector dialog, with the name and remote MCP server URL already filled in, and the Continue button that submits them.",
160
+ boxes: [
161
+ { x: 26.7, y: 28.6, w: 46.6, h: 25.7 },
162
+ { x: 63.1, y: 76.3, w: 10.6, h: 8.3 },
163
+ ],
164
+ width: 1400,
165
+ height: 700,
166
+ illustration: true,
167
+ };
@@ -0,0 +1,29 @@
1
+ import { marketplaceGitUrl } from '../../../shared/marketplace-url';
2
+
3
+ /**
4
+ * The address Claude has registered, which is this deployment's own: the
5
+ * marketplace remote is served from it. Named rather than described so the
6
+ * reader can match it against the row Claude shows them.
7
+ */
8
+ export function deploymentHost(): string {
9
+ try {
10
+ return new URL(marketplaceGitUrl()).host;
11
+ } catch {
12
+ return 'this deployment';
13
+ }
14
+ }
15
+
16
+ /**
17
+ * The port Claude must register for it — the one this deployment is
18
+ * actually reached on. The scheme's default when the address names none;
19
+ * a deployment exposed on another port must be registered on that port,
20
+ * or Claude's calls never arrive.
21
+ */
22
+ export function deploymentPort(): string {
23
+ try {
24
+ const url = new URL(marketplaceGitUrl());
25
+ return url.port || (url.protocol === 'http:' ? '80' : '443');
26
+ } catch {
27
+ return '443';
28
+ }
29
+ }
@@ -0,0 +1,35 @@
1
+ import type { ReactNode } from 'react';
2
+
3
+ /**
4
+ * The small pieces the Claude setup steps are written in, shared by the two
5
+ * homes those steps now have: the registration steps in Deployment settings,
6
+ * and the personal tutorial on External agent access.
7
+ */
8
+
9
+ /**
10
+ * A link out of the app, marked as one.
11
+ *
12
+ * The marker is a GLYPH, not the lucide icon the buttons use: an inline SVG
13
+ * is an atomic box, and a line may break after it, which left the comma in
14
+ * "Admin settings → Claude Code, scroll to…" stranded at the start of the
15
+ * next line. Text has no break opportunity there.
16
+ */
17
+ export function Out({ href, children }: { href: string; children: ReactNode }) {
18
+ return (
19
+ <a
20
+ href={href}
21
+ target="_blank"
22
+ rel="noopener noreferrer"
23
+ className="underline text-ink-muted hover:text-ink"
24
+ >
25
+ {children}
26
+ <span aria-hidden="true" className="opacity-60">
27
+ ↗
28
+ </span>
29
+ </a>
30
+ );
31
+ }
32
+
33
+ export function Prose({ children }: { children: ReactNode }) {
34
+ return <p className="text-meta text-ink-muted leading-snug">{children}</p>;
35
+ }
@@ -0,0 +1,89 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import { DEFAULT_BRANCH } from '@bevel-software/platform-shared';
3
+ import {
4
+ editableDescriptionFromSource,
5
+ fetchEditableAgentDescription,
6
+ mergeEditableDescription,
7
+ saveAgentDescription,
8
+ } from '../agent-instructions.api';
9
+ import { WorkspaceApiError } from '../../../workspace/services/workspace.api';
10
+
11
+ const { getOrCreateWorkspaceMock, readFileMock, writeFileMock } = vi.hoisted(() => ({
12
+ getOrCreateWorkspaceMock: vi.fn(),
13
+ readFileMock: vi.fn(),
14
+ writeFileMock: vi.fn(),
15
+ }));
16
+
17
+ vi.mock('../../../workspace/services/workspace.api', async (importOriginal) => ({
18
+ ...(await importOriginal<typeof import('../../../workspace/services/workspace.api')>()),
19
+ getOrCreateWorkspace: getOrCreateWorkspaceMock,
20
+ readFile: readFileMock,
21
+ writeFile: writeFileMock,
22
+ }));
23
+
24
+ describe('inline agent-description source handling', () => {
25
+ it('shows only the agent-visible text in the editor', () => {
26
+ expect(
27
+ editableDescriptionFromSource(
28
+ '<!-- private starter notes -->\r\nAcme builds solar farms.<!-- private reminder -->\r\n\r\nCheck Projects/.',
29
+ ),
30
+ ).toBe('Acme builds solar farms.\n\nCheck Projects/.');
31
+ });
32
+
33
+ it('retains private comments while replacing the public description', () => {
34
+ const source = '<!-- starter notes -->\nOld public text.\n<!-- private reminder -->\n';
35
+ expect(mergeEditableDescription(source, 'New public text.')).toBe(
36
+ '<!-- starter notes -->\n\n<!-- private reminder -->\n\nNew public text.\n',
37
+ );
38
+ });
39
+
40
+ it('closes an unterminated private comment before the new public text', () => {
41
+ const source = 'Old public text.\n<!-- private note without a closer';
42
+ expect(mergeEditableDescription(source, 'New public text.')).toBe(
43
+ '<!-- private note without a closer\n-->\n\nNew public text.\n',
44
+ );
45
+ });
46
+
47
+ it('can clear the public description without deleting private comments', () => {
48
+ expect(mergeEditableDescription('Visible.<!-- keep me -->', ' ')).toBe('<!-- keep me -->\n');
49
+ });
50
+ });
51
+
52
+ describe('loading the editable description', () => {
53
+ beforeEach(() => {
54
+ getOrCreateWorkspaceMock.mockReset();
55
+ getOrCreateWorkspaceMock.mockResolvedValue({ workspace: { id: DEFAULT_BRANCH } });
56
+ readFileMock.mockReset();
57
+ writeFileMock.mockReset();
58
+ writeFileMock.mockResolvedValue(undefined);
59
+ });
60
+
61
+ it('opens empty when the file is not there yet', async () => {
62
+ readFileMock.mockRejectedValue(new WorkspaceApiError(404, 'File not found'));
63
+
64
+ await expect(fetchEditableAgentDescription('knowledge-base')).resolves.toEqual({
65
+ workspaceId: DEFAULT_BRANCH,
66
+ source: '',
67
+ description: '',
68
+ });
69
+ });
70
+
71
+ it('surfaces a read failure rather than opening an empty editor over text it could not read', async () => {
72
+ readFileMock.mockRejectedValue(new WorkspaceApiError(500, 'permission denied'));
73
+
74
+ await expect(fetchEditableAgentDescription('knowledge-base')).rejects.toMatchObject({ status: 500 });
75
+ });
76
+
77
+ it('saves the merged file conditionally on the bytes it loaded', async () => {
78
+ const source = '<!-- private note -->\nOld public text.\n';
79
+
80
+ await saveAgentDescription(DEFAULT_BRANCH, 'knowledge-base', source, 'New public text.');
81
+
82
+ expect(writeFileMock).toHaveBeenCalledWith(
83
+ DEFAULT_BRANCH,
84
+ 'knowledge-base/mcp-description.md',
85
+ '<!-- private note -->\n\nNew public text.\n',
86
+ { ifMatch: source },
87
+ );
88
+ });
89
+ });
@@ -0,0 +1,167 @@
1
+ import {
2
+ DEFAULT_BRANCH,
3
+ PREAMBLE_CAP,
4
+ PREAMBLE_FILE,
5
+ TOOL_PREFIX_CAP,
6
+ stripHtmlComments,
7
+ } from '@bevel-software/platform-shared';
8
+ import { authFetch } from '../../../lib/api';
9
+ import {
10
+ WorkspaceApiError,
11
+ getOrCreateWorkspace,
12
+ readFile,
13
+ writeFile,
14
+ } from '../../workspace/services/workspace.api';
15
+
16
+ // The caps, the file name and the comment rule come from
17
+ // `@bevel-software/platform-shared`, the same module the backend composer
18
+ // reads them from: the card shows what the composer sends, and a mirrored
19
+ // copy here would eventually show one thing while agents received another.
20
+ // Re-exported so the card keeps importing them from its own service module.
21
+ export { PREAMBLE_CAP, PREAMBLE_FILE, TOOL_PREFIX_CAP };
22
+
23
+ /** What `GET /api/agent/instructions` answers: the composer's result. */
24
+ export interface AgentInstructions {
25
+ /** The header, then the preamble body: what the initialize handshake carries. */
26
+ instructions: string;
27
+ /** The fixed platform message, sent first. Not editable. */
28
+ header: string;
29
+ /** The admin's description as sent (cut and marked when over the cap); empty when there is none. */
30
+ preamble: string;
31
+ /** The fixed first sentence of the tool prefix; the rest is the admin's first paragraph. */
32
+ toolPrefixLine: string;
33
+ /** The fixed line, then the first paragraph: what the four knowledge-base tools carry. */
34
+ toolPrefix: string;
35
+ /** The preamble was cut at the cap. */
36
+ truncated: boolean;
37
+ /** Preamble length before the cut. */
38
+ preambleChars: number;
39
+ /** The tool prefix was cut at its cap. */
40
+ toolPrefixTruncated: boolean;
41
+ /** Tool prefix length before the cut. */
42
+ toolPrefixChars: number;
43
+ /** The file has a `<!--` with no `-->`; everything after it is withheld. */
44
+ unterminatedComment: boolean;
45
+ }
46
+
47
+ export interface EditableAgentDescription {
48
+ /** Default-branch workspace used for the eventual save. */
49
+ workspaceId: string;
50
+ /** Full file bytes, retained so private HTML comments survive the inline edit. */
51
+ source: string;
52
+ /** Only the text agents receive; private HTML comments are omitted. */
53
+ description: string;
54
+ }
55
+
56
+ /**
57
+ * The public description inside the repository file: what agents receive, and
58
+ * so the only thing the editor shows. The comment rule is the composer's own
59
+ * (`stripHtmlComments`), not a copy of it, so an unclosed comment hides the
60
+ * rest of the file here exactly as it does for agents.
61
+ */
62
+ export function editableDescriptionFromSource(source: string): string {
63
+ return stripHtmlComments(source).text.replace(/\r\n?/g, '\n').trim();
64
+ }
65
+
66
+ /**
67
+ * Whether the file holds a `<!--` that is never closed, which withholds
68
+ * everything after it from agents.
69
+ *
70
+ * The card needs this to offer a way OUT of that state: the broken comment is
71
+ * in the part the editor does not show, so the visible text can be unchanged
72
+ * while the file is still hiding content, and `mergeEditableDescription`
73
+ * closes the comment on save.
74
+ */
75
+ export function sourceHasUnterminatedComment(source: string): boolean {
76
+ return stripHtmlComments(source).unterminated;
77
+ }
78
+
79
+ /**
80
+ * Replace the agent-visible text while retaining every private HTML comment.
81
+ * Comments are collected ahead of the public text because their exact source
82
+ * position is not represented in the inline editor. An unclosed comment is
83
+ * closed so the newly saved description cannot accidentally remain hidden.
84
+ */
85
+ export function mergeEditableDescription(source: string, description: string): string {
86
+ const comments: string[] = [];
87
+ let from = 0;
88
+ for (;;) {
89
+ const open = source.indexOf('<!--', from);
90
+ if (open === -1) break;
91
+ const close = source.indexOf('-->', open + 4);
92
+ if (close === -1) {
93
+ comments.push(`${source.slice(open).trimEnd()}\n-->`);
94
+ break;
95
+ }
96
+ comments.push(source.slice(open, close + 3));
97
+ from = close + 3;
98
+ }
99
+
100
+ const publicText = description.replace(/\r\n?/g, '\n').trim();
101
+ const parts = [...comments, publicText].filter((part) => part.length > 0);
102
+ return parts.length > 0 ? `${parts.join('\n\n')}\n` : '';
103
+ }
104
+
105
+ /**
106
+ * What every connected agent is told at session start, as the hosted proxy
107
+ * composes it. Read through the browser session: the route accepts a JWT
108
+ * beside the agent credentials, because it is the same text an agent gets.
109
+ */
110
+ export async function fetchAgentInstructions(): Promise<AgentInstructions> {
111
+ const res = await authFetch('/api/agent/instructions');
112
+ if (!res.ok) {
113
+ let serverError: string | undefined;
114
+ try {
115
+ const body = (await res.json()) as { error?: string };
116
+ if (typeof body.error === 'string' && body.error.length > 0) serverError = body.error;
117
+ } catch {
118
+ // Non-JSON error body: fall through to the fallback.
119
+ }
120
+ throw new Error(serverError ?? "Couldn't load what connected agents are told.");
121
+ }
122
+ return res.json() as Promise<AgentInstructions>;
123
+ }
124
+
125
+ /** Load the raw default-branch file for an admin's inline edit. */
126
+ export async function fetchEditableAgentDescription(kbDirName: string): Promise<EditableAgentDescription> {
127
+ const { workspace } = await getOrCreateWorkspace(DEFAULT_BRANCH);
128
+ const path = `${kbDirName}/${PREAMBLE_FILE}`;
129
+ let source = '';
130
+ try {
131
+ source = await readFile(workspace.id, path);
132
+ } catch (err) {
133
+ // A pre-template knowledge base may not have the file yet. Treat that as
134
+ // an empty editor; the normal write path creates it on Save. Only a 404
135
+ // means that: the file route answers 404 for a missing file alone and
136
+ // gives any other read failure its own status, so an unreadable file
137
+ // surfaces as an error here instead of an empty editor over live text.
138
+ if (!(err instanceof WorkspaceApiError) || err.status !== 404) throw err;
139
+ }
140
+ return {
141
+ workspaceId: workspace.id,
142
+ source,
143
+ description: editableDescriptionFromSource(source),
144
+ };
145
+ }
146
+
147
+ /**
148
+ * Save the public description without discarding private source comments.
149
+ *
150
+ * `source` is both the snapshot the private comments are merged out of and
151
+ * the write's precondition: the file must still hold exactly it, or the
152
+ * backend refuses with a 409. Without that, an editor left open while
153
+ * another admin saves would put its stale comments back and drop theirs.
154
+ */
155
+ export async function saveAgentDescription(
156
+ workspaceId: string,
157
+ kbDirName: string,
158
+ source: string,
159
+ description: string,
160
+ ): Promise<void> {
161
+ await writeFile(
162
+ workspaceId,
163
+ `${kbDirName}/${PREAMBLE_FILE}`,
164
+ mergeEditableDescription(source, description),
165
+ { ifMatch: source },
166
+ );
167
+ }
@@ -8,6 +8,12 @@ export interface ExternalApiKeySummary {
8
8
  createdAt: number;
9
9
  lastUsedAt: number | null;
10
10
  revokedAt: number | null;
11
+ /**
12
+ * Who ended it, once revoked: `owner` (you disconnected it) or `admin` (an
13
+ * admin revoked it — it will not come back by reconnecting). Null while
14
+ * live, and on keys revoked before this was recorded.
15
+ */
16
+ revokedBy: 'owner' | 'admin' | null;
11
17
  /** Model-proxy usage for this key today + the daily cap (in tokens). */
12
18
  llmUsage?: { usedTodayTokens: number; dailyTokenCap: number };
13
19
  }