@bevel-software/platform-core-frontend 0.4.0 → 0.5.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 (326) hide show
  1. package/package.json +5 -3
  2. package/src/core/CoreAppShell.tsx +195 -56
  3. package/src/core/__tests__/AppChrome.test.tsx +125 -0
  4. package/src/core/__tests__/ShellRoutes.test.tsx +130 -95
  5. package/src/core/__tests__/bootstrap.test.ts +63 -0
  6. package/src/core/bootstrap.ts +73 -0
  7. package/src/core/events.ts +12 -0
  8. package/src/core/registry.ts +58 -9
  9. package/src/index.css +100 -11
  10. package/src/index.ts +24 -23
  11. package/src/lib/utils.ts +114 -138
  12. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +281 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +166 -1
  14. package/src/modules/access/api.ts +49 -0
  15. package/src/modules/access/components/ManageAccessDialog.tsx +786 -481
  16. package/src/modules/access/hooks/useFileAccess.ts +1 -1
  17. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +86 -0
  18. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +172 -156
  19. package/src/modules/admin/__tests__/admin.unread.test.tsx +61 -0
  20. package/src/modules/admin/components/AdminRolesPage.tsx +44 -38
  21. package/src/modules/admin/components/RolesCorruptedBanner.tsx +11 -10
  22. package/src/modules/admin/components/UserAccountsPage.tsx +361 -353
  23. package/src/modules/admin/state/admin.context.tsx +15 -6
  24. package/src/modules/auth/components/AccountPage.tsx +11 -11
  25. package/src/modules/auth/components/LoginScreen.tsx +12 -12
  26. package/src/modules/auth/services/sso.ts +47 -1
  27. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +277 -0
  28. package/src/modules/change-requests/__tests__/author.test.ts +48 -0
  29. package/src/modules/change-requests/__tests__/conflict.test.ts +73 -0
  30. package/src/modules/change-requests/__tests__/diff.test.ts +134 -0
  31. package/src/modules/change-requests/__tests__/propose.test.ts +93 -0
  32. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +72 -0
  33. package/src/modules/change-requests/change-requests.css +22 -0
  34. package/src/modules/change-requests/components/ChangeBox.tsx +277 -0
  35. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +713 -0
  36. package/src/modules/change-requests/components/ConflictHelp.tsx +47 -0
  37. package/src/modules/change-requests/components/CrFileTree.tsx +398 -0
  38. package/src/modules/change-requests/components/FileChangeBoxes.tsx +168 -0
  39. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +236 -0
  40. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +79 -0
  41. package/src/modules/change-requests/hooks/useFileOnBranch.ts +80 -0
  42. package/src/modules/change-requests/services/change-requests.api.ts +45 -0
  43. package/src/modules/change-requests/services/propose.api.ts +162 -0
  44. package/src/modules/change-requests/utils/author.ts +47 -0
  45. package/src/modules/change-requests/utils/conflict.ts +38 -0
  46. package/src/modules/change-requests/utils/diff.ts +80 -0
  47. package/src/modules/git/__tests__/BranchSwitcher.test.tsx +27 -18
  48. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +36 -83
  49. package/src/modules/git/__tests__/PullNeededBanner.test.tsx +5 -5
  50. package/src/modules/git/__tests__/PullRequestsForMe.test.tsx +147 -0
  51. package/src/modules/git/__tests__/useAutoPullUpdates.test.tsx +2 -8
  52. package/src/modules/git/components/BranchSwitcher.tsx +68 -31
  53. package/src/modules/git/components/DiffView.tsx +4 -4
  54. package/src/modules/git/components/FileComparisonPanel.tsx +20 -20
  55. package/src/modules/git/components/FileHistoryPanel.tsx +71 -107
  56. package/src/modules/git/components/PullNeededBanner.tsx +6 -13
  57. package/src/modules/git/components/PullRequestsForMe.tsx +71 -36
  58. package/src/modules/git/components/UnifiedDiffView.tsx +4 -4
  59. package/src/modules/git/hooks/__tests__/useGitState.deleteBranch.test.tsx +2 -2
  60. package/src/modules/git/hooks/useGitState.ts +15 -14
  61. package/src/modules/git/services/__tests__/error-messages.test.ts +4 -4
  62. package/src/modules/git/services/error-messages.ts +7 -7
  63. package/src/modules/git/services/git.api.ts +17 -11
  64. package/src/modules/git/services/pr-prompts.ts +2 -2
  65. package/src/modules/git/state/git.context.ts +10 -1
  66. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +224 -0
  67. package/src/modules/layout/__tests__/SidebarToggle.test.tsx +242 -0
  68. package/src/modules/layout/__tests__/breakpoints.test.ts +56 -0
  69. package/src/modules/layout/breakpoints.ts +6 -0
  70. package/src/modules/layout/components/AppLayout.tsx +17 -5
  71. package/src/modules/layout/components/DemoBanner.tsx +10 -1
  72. package/src/modules/layout/components/MaintenanceOverlay.tsx +104 -104
  73. package/src/modules/layout/components/MobileChatLayout.tsx +31 -26
  74. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +59 -24
  75. package/src/modules/layout/components/SidebarFrame.tsx +317 -0
  76. package/src/modules/layout/components/SidebarToggle.tsx +86 -0
  77. package/src/modules/layout/components/SlideOverlay.tsx +1 -1
  78. package/src/modules/layout/components/__tests__/MobileChatLayout.test.tsx +40 -2
  79. package/src/modules/layout/components/__tests__/ResizableThreePaneLayout.test.tsx +19 -3
  80. package/src/modules/layout/state/sidebar.ts +200 -0
  81. package/src/modules/library/__tests__/AddToGroupDialog.test.tsx +313 -0
  82. package/src/modules/library/__tests__/ChangeRequestDock.test.tsx +84 -0
  83. package/src/modules/library/__tests__/GroupJoinRequests.test.tsx +178 -0
  84. package/src/modules/library/__tests__/GroupPage.test.tsx +479 -0
  85. package/src/modules/library/__tests__/GroupsIndexPage.test.tsx +283 -0
  86. package/src/modules/library/__tests__/GroupsSidebar.contextmenu.test.tsx +175 -0
  87. package/src/modules/library/__tests__/GroupsSidebar.locked.test.tsx +96 -0
  88. package/src/modules/library/__tests__/GroupsSidebar.test.tsx +142 -0
  89. package/src/modules/library/__tests__/GroupsSidebarMenu.test.tsx +142 -0
  90. package/src/modules/library/__tests__/LibraryCard.test.tsx +149 -0
  91. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +378 -0
  92. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +347 -0
  93. package/src/modules/library/__tests__/LockedGroupView.test.tsx +203 -0
  94. package/src/modules/library/__tests__/NewGroupDialog.test.tsx +114 -0
  95. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +177 -0
  96. package/src/modules/library/__tests__/SkillPage.test.tsx +1063 -0
  97. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +259 -0
  98. package/src/modules/library/__tests__/ToolLogo.test.tsx +63 -0
  99. package/src/modules/library/__tests__/ToolPage.test.tsx +315 -0
  100. package/src/modules/library/__tests__/ToolSharePanel.test.tsx +36 -0
  101. package/src/modules/library/__tests__/ToolVarRow.test.tsx +260 -0
  102. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +197 -0
  103. package/src/modules/library/__tests__/auth-harness.tsx +37 -0
  104. package/src/modules/library/__tests__/oauth-fragment.test.ts +48 -0
  105. package/src/modules/library/__tests__/status.test.ts +210 -117
  106. package/src/modules/library/__tests__/useSkillDetail.test.tsx +102 -0
  107. package/src/modules/library/__tests__/useToolPage.test.tsx +146 -0
  108. package/src/modules/library/components/AccessRequestsBanner.tsx +101 -0
  109. package/src/modules/library/components/AddToGroupDialog.tsx +115 -0
  110. package/src/modules/library/components/ChangeRequestDock.tsx +71 -47
  111. package/src/modules/library/components/DeleteGroupDialog.tsx +87 -0
  112. package/src/modules/library/components/GroupIndexRow.tsx +63 -0
  113. package/src/modules/library/components/GroupJoinRequests.tsx +56 -0
  114. package/src/modules/library/components/GroupPage.tsx +373 -0
  115. package/src/modules/library/components/GroupsIndexPage.tsx +222 -0
  116. package/src/modules/library/components/GroupsSidebar.tsx +338 -0
  117. package/src/modules/library/components/GroupsSidebarMenu.tsx +160 -0
  118. package/src/modules/library/components/LibraryCard.tsx +153 -132
  119. package/src/modules/library/components/LibraryLayout.tsx +344 -0
  120. package/src/modules/library/components/LibraryPage.tsx +138 -254
  121. package/src/modules/library/components/LockGlyph.tsx +31 -0
  122. package/src/modules/library/components/LockedGroupView.tsx +159 -0
  123. package/src/modules/library/components/ManagedGroupRequests.tsx +70 -0
  124. package/src/modules/library/components/NewGroupDialog.tsx +112 -0
  125. package/src/modules/library/components/NewSkillPanel.tsx +151 -0
  126. package/src/modules/library/components/PageActions.tsx +156 -0
  127. package/src/modules/library/components/PendingSkillReview.tsx +63 -0
  128. package/src/modules/library/components/PersonalAddDialog.tsx +88 -0
  129. package/src/modules/library/components/PersonalGroupPage.tsx +125 -0
  130. package/src/modules/library/components/StatusDot.tsx +25 -0
  131. package/src/modules/library/components/ToolLogo.tsx +171 -0
  132. package/src/modules/library/components/group-page-parts.tsx +419 -0
  133. package/src/modules/library/components/skill-page/SkillFileEditor.tsx +134 -0
  134. package/src/modules/library/components/skill-page/SkillFilePane.tsx +117 -0
  135. package/src/modules/library/components/skill-page/SkillFileTabs.tsx +112 -0
  136. package/src/modules/library/components/skill-page/SkillPage.tsx +673 -0
  137. package/src/modules/library/components/skill-page/tab-ids.ts +33 -0
  138. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +175 -0
  139. package/src/modules/library/components/tool-page/ToolPage.tsx +228 -0
  140. package/src/modules/library/components/tool-page/ToolSharePanel.tsx +45 -0
  141. package/src/modules/library/components/tool-page/ToolVarRow.tsx +289 -0
  142. package/src/modules/library/hooks/useJoinRequests.ts +114 -0
  143. package/src/modules/library/hooks/useLibraryData.ts +134 -119
  144. package/src/modules/library/hooks/useSkillDetail.ts +119 -74
  145. package/src/modules/library/hooks/useToolPage.ts +145 -0
  146. package/src/modules/library/library.css +108 -320
  147. package/src/modules/library/routes/LibraryRoutes.tsx +134 -0
  148. package/src/modules/library/routes/WorkspaceItemRoute.tsx +74 -0
  149. package/src/modules/library/routes/library-paths.ts +191 -0
  150. package/src/modules/library/services/groups.api.ts +189 -0
  151. package/src/modules/library/services/library.api.ts +291 -164
  152. package/src/modules/library/services/tools.api.ts +60 -0
  153. package/src/modules/library/state/library-context.ts +22 -0
  154. package/src/modules/library/state/library-data.tsx +223 -0
  155. package/src/modules/library/state/toast.context.ts +32 -0
  156. package/src/modules/library/state/toast.tsx +84 -42
  157. package/src/modules/library/utils/clipboard.ts +33 -0
  158. package/src/modules/library/utils/group-summary.ts +68 -0
  159. package/src/modules/library/utils/names.ts +30 -0
  160. package/src/modules/library/utils/navigate-external.ts +15 -0
  161. package/src/modules/library/utils/oauth-fragment.ts +32 -0
  162. package/src/modules/library/utils/personal-group.ts +36 -0
  163. package/src/modules/library/utils/status.ts +199 -116
  164. package/src/modules/library/utils/toast-duration.ts +16 -0
  165. package/src/modules/onboarding/__tests__/onboarding.test.tsx +533 -0
  166. package/src/modules/onboarding/agent-clients.ts +48 -0
  167. package/src/modules/onboarding/components/ConnectAgentPill.tsx +133 -0
  168. package/src/modules/onboarding/components/RootLanding.tsx +54 -0
  169. package/src/modules/onboarding/components/WelcomePage.tsx +364 -0
  170. package/src/modules/onboarding/paths.ts +9 -0
  171. package/src/modules/onboarding/state/onboarding.ts +191 -0
  172. package/src/modules/pr/components/OpenChangeRequestDialog.tsx +10 -10
  173. package/src/modules/pr/services/pr-approvals.api.ts +19 -0
  174. package/src/modules/pr/services/pr-cancel.api.ts +11 -0
  175. package/src/modules/review/components/BinaryChangePlaceholder.tsx +3 -3
  176. package/src/modules/review/components/DiffViewer.tsx +4 -4
  177. package/src/modules/review/components/MarkdownDiffViewer.tsx +84 -26
  178. package/src/modules/review/components/ReviewFileRow.tsx +10 -10
  179. package/src/modules/review/components/ReviewPanel.tsx +49 -17
  180. package/src/modules/review/components/ReviewPanelSurface.tsx +1 -1
  181. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +122 -0
  182. package/src/modules/review/hooks/__tests__/useReviewState.test.ts +1 -1
  183. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +273 -171
  184. package/src/modules/secrets-vault/components/SecretsPage.tsx +313 -276
  185. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +109 -92
  186. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +82 -51
  187. package/src/modules/secrets-vault/services/connect.api.ts +24 -3
  188. package/src/modules/settings/components/DeploymentPage.tsx +90 -0
  189. package/src/modules/settings/components/SettingsLayout.tsx +135 -0
  190. package/src/modules/settings/components/SettingsNav.tsx +114 -0
  191. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +110 -0
  192. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +249 -0
  193. package/src/modules/settings/settings-nav-items.tsx +166 -0
  194. package/src/modules/setup/__tests__/setup.test.tsx +540 -0
  195. package/src/modules/setup/components/SetupGate.tsx +67 -0
  196. package/src/modules/setup/components/SetupScreen.tsx +573 -0
  197. package/src/modules/setup/services/setup.api.ts +106 -0
  198. package/src/modules/setup/utils/git-host.ts +34 -0
  199. package/src/modules/toolbar/components/AppSwitcher.tsx +131 -108
  200. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +548 -548
  201. package/src/modules/toolbar/components/ProfileMenu.tsx +294 -0
  202. package/src/modules/toolbar/components/Toolbar.tsx +56 -54
  203. package/src/modules/toolbar/components/__tests__/AppSwitcher.test.tsx +176 -122
  204. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +252 -77
  205. package/src/modules/tools/ToolsExplorerPage.tsx +45 -40
  206. package/src/modules/workspace/__tests__/design-system-parity.test.ts +133 -0
  207. package/src/modules/workspace/__tests__/testFixtures.ts +2 -0
  208. package/src/modules/workspace/components/EditorTabs.tsx +82 -50
  209. package/src/modules/workspace/components/FileExplorer.tsx +1292 -1068
  210. package/src/modules/workspace/components/FilePaneCard.tsx +53 -0
  211. package/src/modules/workspace/components/FileRoute.tsx +89 -84
  212. package/src/modules/workspace/components/FileViewer.tsx +1312 -906
  213. package/src/modules/workspace/components/KbDocumentShell.tsx +138 -0
  214. package/src/modules/workspace/components/KbFileRail.tsx +128 -0
  215. package/src/modules/workspace/components/KbPageHeader.tsx +390 -0
  216. package/src/modules/workspace/components/__tests__/EditorTabs.test.tsx +87 -3
  217. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +293 -39
  218. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +1 -16
  219. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +462 -44
  220. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +84 -0
  221. package/src/modules/workspace/components/__tests__/KbFileRail.test.tsx +83 -0
  222. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +192 -0
  223. package/src/modules/workspace/components/renderers/CopyAnchorButton.tsx +64 -0
  224. package/src/modules/workspace/components/renderers/CsvRenderer.tsx +8 -8
  225. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +18 -9
  226. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +14 -14
  227. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +2 -2
  228. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +31 -165
  229. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +18 -5
  230. package/src/modules/workspace/components/renderers/MermaidDiagram.tsx +27 -10
  231. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +2 -2
  232. package/src/modules/workspace/components/renderers/TextRenderer.tsx +11 -5
  233. package/src/modules/workspace/components/renderers/ToolForm.tsx +24 -24
  234. package/src/modules/workspace/components/renderers/ToolRenderer.tsx +27 -27
  235. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +11 -11
  236. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +66 -0
  237. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +17 -1
  238. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +1 -1
  239. package/src/modules/workspace/components/renderers/__tests__/MermaidDiagram.test.tsx +58 -0
  240. package/src/modules/workspace/components/renderers/__tests__/lazyRenderer.test.tsx +68 -0
  241. package/src/modules/workspace/components/renderers/__tests__/rendererLayout.test.ts +64 -0
  242. package/src/modules/workspace/components/renderers/__tests__/sanitizeDocxHtml.test.ts +0 -0
  243. package/src/modules/workspace/components/renderers/chunk-boundary.tsx +71 -0
  244. package/src/modules/workspace/components/renderers/index.ts +78 -2
  245. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +241 -0
  246. package/src/modules/workspace/components/renderers/lazyRenderer.tsx +59 -0
  247. package/src/modules/workspace/components/renderers/sanitizeDocxHtml.ts +91 -0
  248. package/src/modules/workspace/hooks/__tests__/useLinksOut.test.ts +59 -0
  249. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +237 -0
  250. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +185 -0
  251. package/src/modules/workspace/hooks/useAutoGrowTextarea.ts +30 -0
  252. package/src/modules/workspace/hooks/useLastCommit.ts +66 -0
  253. package/src/modules/workspace/hooks/useLinksOut.ts +56 -0
  254. package/src/modules/workspace/hooks/useOpenChangeRequests.ts +20 -0
  255. package/src/modules/workspace/hooks/useWorkspaceState.ts +123 -14
  256. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +1 -1
  257. package/src/modules/workspace/services/workspace.api.ts +9 -2
  258. package/src/modules/workspace/state/open-change-requests.context.ts +35 -0
  259. package/src/modules/workspace/state/open-change-requests.tsx +185 -0
  260. package/src/modules/workspace/state/workspace.context.ts +9 -0
  261. package/src/modules/workspace/utils/__tests__/diff.test.ts +87 -0
  262. package/src/modules/workspace/utils/diff.ts +130 -53
  263. package/src/modules/workspace/utils/fileTree.ts +182 -179
  264. package/src/modules/workspace/workspace.css +28 -0
  265. package/src/shared/components/Badge.tsx +62 -0
  266. package/src/shared/components/Banner.tsx +58 -0
  267. package/src/shared/components/Button.tsx +90 -0
  268. package/src/shared/components/Dialog.tsx +6 -6
  269. package/src/shared/components/Field.tsx +45 -0
  270. package/src/shared/components/IconButton.tsx +74 -0
  271. package/src/shared/components/ListRow.tsx +96 -0
  272. package/src/shared/components/Menu.tsx +88 -0
  273. package/src/shared/components/PageShell.tsx +54 -51
  274. package/src/shared/components/Surface.tsx +86 -0
  275. package/src/shared/components/__tests__/primitives.test.tsx +333 -0
  276. package/src/shared/components/index.ts +48 -0
  277. package/src/shared/components/useDismissableMenu.ts +71 -0
  278. package/src/shared/theme/__tests__/accent-contrast.test.ts +84 -0
  279. package/src/shared/theme/index.css +12 -0
  280. package/src/shared/theme/measure.ts +64 -0
  281. package/src/shared/theme/shadows.css +34 -0
  282. package/src/shared/theme/tokens.css +193 -0
  283. package/src/test-setup.ts +9 -0
  284. package/src/modules/access/components/AccessRestrictedBanner.tsx +0 -31
  285. package/src/modules/access/components/NodeOwnersBanner.tsx +0 -30
  286. package/src/modules/git/__tests__/ProtectedBranchBanner.test.tsx +0 -82
  287. package/src/modules/git/components/ProtectedBranchBanner.tsx +0 -42
  288. package/src/modules/library/__tests__/DetailDialog.test.tsx +0 -200
  289. package/src/modules/library/__tests__/diff.test.ts +0 -62
  290. package/src/modules/library/__tests__/loadout.test.tsx +0 -72
  291. package/src/modules/library/components/CompareView.tsx +0 -357
  292. package/src/modules/library/components/DetailDialog.tsx +0 -566
  293. package/src/modules/library/components/GearIcon.tsx +0 -12
  294. package/src/modules/library/components/LoadoutSidebar.tsx +0 -156
  295. package/src/modules/library/components/StatusGem.tsx +0 -21
  296. package/src/modules/library/components/SuggestChange.tsx +0 -171
  297. package/src/modules/library/components/particles.ts +0 -50
  298. package/src/modules/library/state/loadout.tsx +0 -129
  299. package/src/modules/library/utils/diff.ts +0 -102
  300. package/src/modules/pr/__tests__/PrApprovalBadge.test.tsx +0 -93
  301. package/src/modules/pr/__tests__/PrCancelButton.test.tsx +0 -158
  302. package/src/modules/pr/__tests__/PrCancelConfirmDialog.test.tsx +0 -44
  303. package/src/modules/pr/__tests__/PrMergeButton.test.tsx +0 -360
  304. package/src/modules/pr/__tests__/bucketize-comments.test.ts +0 -85
  305. package/src/modules/pr/__tests__/parsePatch.test.ts +0 -104
  306. package/src/modules/pr/__tests__/usePrViewerState.test.ts +0 -72
  307. package/src/modules/pr/components/PrApprovalBadge.tsx +0 -80
  308. package/src/modules/pr/components/PrCancelButton.tsx +0 -99
  309. package/src/modules/pr/components/PrCancelConfirmDialog.tsx +0 -119
  310. package/src/modules/pr/components/PrCommentComposer.tsx +0 -92
  311. package/src/modules/pr/components/PrCommentThread.tsx +0 -168
  312. package/src/modules/pr/components/PrCommentsPanel.tsx +0 -143
  313. package/src/modules/pr/components/PrDiffPane.tsx +0 -425
  314. package/src/modules/pr/components/PrFileRow.tsx +0 -164
  315. package/src/modules/pr/components/PrFilesList.tsx +0 -53
  316. package/src/modules/pr/components/PrHeader.tsx +0 -45
  317. package/src/modules/pr/components/PrHeaderOverflowMenu.tsx +0 -58
  318. package/src/modules/pr/components/PrMergeButton.tsx +0 -268
  319. package/src/modules/pr/components/PrMergeConfirmDialog.tsx +0 -112
  320. package/src/modules/pr/components/PrRefreshFromTargetButton.tsx +0 -110
  321. package/src/modules/pr/components/PrViewer.tsx +0 -364
  322. package/src/modules/pr/hooks/usePrViewerState.ts +0 -150
  323. package/src/modules/pr/state/pr-viewer.context.ts +0 -34
  324. package/src/modules/pr/utils/bucketize-comments.ts +0 -55
  325. package/src/modules/pr/utils/parsePatch.ts +0 -57
  326. package/src/modules/toolbar/components/AdminMenu.tsx +0 -271
@@ -1,548 +1,548 @@
1
- import { useCallback, useEffect, useId, useState } from 'react';
2
- import { Link } from 'react-router-dom';
3
- import { Check, Copy, Wrench, ExternalLink } from 'lucide-react';
4
- import { Dialog } from '../../../shared/components/Dialog';
5
- import { PageShell } from '../../../shared/components/PageShell';
6
- import {
7
- type ExternalApiKeySummary,
8
- type MintedExternalApiKey,
9
- createExternalApiKey,
10
- deleteExternalApiKey,
11
- disconnectExternalApiKey,
12
- listExternalApiKeys,
13
- } from '../services/external-api-keys.api';
14
-
15
- /**
16
- * "Copied" affordance with a 1500ms auto-reset. Owns the timer + its teardown
17
- * (so an unmounting page can't fire a stale setState), shared by the reveal
18
- * modal and every CopyBlock. `copy(text)` writes to the clipboard and flags
19
- * copied; a rejected write (insecure context / denied permission) leaves the
20
- * textarea selectable for manual copy and shows no false "Copied".
21
- */
22
- function useCopyFeedback(): { copied: boolean; copy: (text: string) => void } {
23
- const [copied, setCopied] = useState(false);
24
- useEffect(() => {
25
- if (!copied) return;
26
- const timerId = window.setTimeout(() => setCopied(false), 1500);
27
- return () => window.clearTimeout(timerId);
28
- }, [copied]);
29
- const copy = useCallback((text: string) => {
30
- void navigator.clipboard
31
- .writeText(text)
32
- .then(() => setCopied(true))
33
- .catch(() => {});
34
- }, []);
35
- return { copied, copy };
36
- }
37
-
38
- const MAX_LABEL_LEN = 200;
39
-
40
- function formatRelative(ts: number | null): string {
41
- if (ts === null) return 'never';
42
- const diff = Date.now() - ts;
43
- const minutes = Math.round(diff / 60_000);
44
- if (minutes < 1) return 'just now';
45
- if (minutes < 60) return `${minutes} min ago`;
46
- const hours = Math.round(minutes / 60);
47
- if (hours < 24) return `${hours} hr ago`;
48
- const days = Math.round(hours / 24);
49
- if (days < 30) return `${days} day${days === 1 ? '' : 's'} ago`;
50
- return new Date(ts).toLocaleDateString();
51
- }
52
-
53
- /**
54
- * The External agent access page, routed standalone at
55
- * `/external-agent-access` (below the persistent toolbar), in two tabs:
56
- *
57
- * - "Your agent" (default) — connecting the user's own interactive agent
58
- * (Claude Code, Claude Desktop, Cursor…). No key: the agent gets only the
59
- * server URL, and on first connect the browser opens our authorization
60
- * flow (sign in + choose tools on /connect). Copy-paste configs only.
61
- * - "Autonomous agents" — the external-API-key surface for pipelines/CI
62
- * that can't open a browser: lists existing keys, mints new ones,
63
- * disconnects revoked ones, permanently deletes disconnected ones. The
64
- * plaintext of a minted key is only shown once — there is no read-it-back
65
- * endpoint.
66
- *
67
- * Glossary terms used in copy: "External API key", "Disconnect" (= revoke),
68
- * "External agent" (= MCP client). See docs/glossary.md.
69
- */
70
- export function ExternalAgentAccessPage() {
71
- const labelInputId = useId();
72
-
73
- const [tab, setTab] = useState<'agent' | 'autonomous'>('agent');
74
- const [keys, setKeys] = useState<ExternalApiKeySummary[]>([]);
75
- const [loading, setLoading] = useState(false);
76
- const [loadError, setLoadError] = useState<string | null>(null);
77
-
78
- const [label, setLabel] = useState('');
79
- const [creating, setCreating] = useState(false);
80
- const [createError, setCreateError] = useState<string | null>(null);
81
-
82
- // The plaintext of a freshly minted key. Held in state for the lifetime
83
- // of the reveal modal — never persisted, and cleared when the user
84
- // dismisses the reveal step.
85
- const [reveal, setReveal] = useState<MintedExternalApiKey | null>(null);
86
- const { copied, copy } = useCopyFeedback();
87
-
88
- // The disconnected key awaiting a permanent-delete confirmation. Non-null
89
- // drives the themed confirm Dialog below; `deleting` keeps the request in
90
- // flight so the confirm can't be dismissed mid-delete.
91
- const [pendingDelete, setPendingDelete] = useState<{ id: string; label: string } | null>(null);
92
- const [deleting, setDeleting] = useState(false);
93
-
94
- const refresh = useCallback(async () => {
95
- setLoading(true);
96
- setLoadError(null);
97
- try {
98
- setKeys(await listExternalApiKeys());
99
- } catch (err) {
100
- setLoadError(err instanceof Error ? err.message : "Couldn't load external API keys.");
101
- } finally {
102
- setLoading(false);
103
- }
104
- }, []);
105
-
106
- useEffect(() => {
107
- void refresh();
108
- }, [refresh]);
109
-
110
- async function handleCreate() {
111
- const trimmed = label.trim();
112
- if (trimmed.length === 0 || trimmed.length > MAX_LABEL_LEN || creating) return;
113
- setCreating(true);
114
- setCreateError(null);
115
- try {
116
- const minted = await createExternalApiKey(trimmed);
117
- setReveal(minted);
118
- setLabel('');
119
- // Optimistic-ish: refresh the list so the new row shows up underneath
120
- // the reveal modal.
121
- void refresh();
122
- } catch (err) {
123
- setCreateError(err instanceof Error ? err.message : "Couldn't create external API key.");
124
- } finally {
125
- setCreating(false);
126
- }
127
- }
128
-
129
- async function handleDisconnect(id: string) {
130
- try {
131
- await disconnectExternalApiKey(id);
132
- await refresh();
133
- } catch (err) {
134
- setLoadError(err instanceof Error ? err.message : "Couldn't disconnect this key.");
135
- }
136
- }
137
-
138
- async function confirmDelete() {
139
- if (!pendingDelete || deleting) return;
140
- setDeleting(true);
141
- try {
142
- await deleteExternalApiKey(pendingDelete.id);
143
- setPendingDelete(null);
144
- await refresh();
145
- } catch (err) {
146
- setLoadError(err instanceof Error ? err.message : "Couldn't delete this key.");
147
- setPendingDelete(null);
148
- } finally {
149
- setDeleting(false);
150
- }
151
- }
152
-
153
- const trimmed = label.trim();
154
- const canSubmit = trimmed.length > 0 && trimmed.length <= MAX_LABEL_LEN && !creating;
155
-
156
- // Surface the keys that matter: active keys first (most-recently-used at the
157
- // top, never-used ones last within that group), with disconnected keys sunk
158
- // to the bottom. Non-destructive — nothing is hidden or deleted, just ordered
159
- // so a long list of stale/test keys doesn't bury the ones in use.
160
- const sortedKeys = [...keys].sort((a, b) => {
161
- const aRevoked = a.revokedAt !== null;
162
- const bRevoked = b.revokedAt !== null;
163
- if (aRevoked !== bRevoked) return aRevoked ? 1 : -1;
164
- return (b.lastUsedAt ?? 0) - (a.lastUsedAt ?? 0);
165
- });
166
-
167
- return (
168
- <>
169
- <PageShell title="External agent access" padded={false}>
170
- <div className="flex border-b border-slate-200 px-4 shrink-0" role="tablist">
171
- {(
172
- [
173
- ['agent', 'Your agent'],
174
- ['autonomous', 'Autonomous agents'],
175
- ] as const
176
- ).map(([id, name]) => (
177
- <button
178
- key={id}
179
- role="tab"
180
- aria-selected={tab === id}
181
- onClick={() => setTab(id)}
182
- className={`px-3 py-2 text-xs font-medium border-b-2 -mb-px ${
183
- tab === id
184
- ? 'border-bevel text-slate-900'
185
- : 'border-transparent text-slate-500 hover:text-slate-800'
186
- }`}
187
- >
188
- {name}
189
- </button>
190
- ))}
191
- </div>
192
-
193
- {tab === 'agent' && (
194
- <div className="px-4 py-3 space-y-4">
195
- <p className="text-xs text-slate-600 leading-snug">
196
- Connect your own agent — Claude Code, Claude Desktop, Cursor and similar. No key
197
- needed: the first time the agent connects, your browser opens so you can sign in and
198
- choose which tools to share with it. Everything it saves appears under your name.
199
- </p>
200
- <Link
201
- to="/connect"
202
- target="_blank"
203
- rel="noopener noreferrer"
204
- className="flex items-center justify-center gap-1.5 rounded border border-slate-200 px-2 py-1.5 text-xs text-slate-700 hover:bg-slate-100"
205
- >
206
- <Wrench size={12} />
207
- Configure your tools
208
- <ExternalLink size={11} className="opacity-60" />
209
- </Link>
210
- <CopyBlock
211
- label="Connect Claude Code"
212
- value={`claude mcp add --transport http knowledge-base ${window.location.origin}/api/mcp`}
213
- rows={2}
214
- />
215
- <div>
216
- <div className="text-xs font-medium text-slate-700 mb-1">claude.ai / Claude Desktop</div>
217
- <p className="text-[11px] text-slate-600 mb-1 leading-snug">
218
- Settings → Connectors → Add custom connector, then paste this URL. When asked to
219
- authorize, your browser opens this app to finish connecting.
220
- </p>
221
- <CopyBlock label={null} value={`${window.location.origin}/api/mcp`} rows={1} />
222
- </div>
223
- <div>
224
- <div className="text-xs font-medium text-slate-700 mb-1">Other agents (JSON config)</div>
225
- <p className="text-[11px] text-slate-600 mb-1 leading-snug">
226
- Works with Cursor, Windsurf, Cline, and most clients that load servers from a JSON
227
- config and support signing in.
228
- </p>
229
- <CopyBlock
230
- label={null}
231
- value={JSON.stringify(
232
- {
233
- mcpServers: {
234
- 'knowledge-base': {
235
- type: 'http',
236
- url: `${window.location.origin}/api/mcp`,
237
- },
238
- },
239
- },
240
- null,
241
- 2,
242
- )}
243
- rows={9}
244
- />
245
- </div>
246
- <p className="text-[11px] text-slate-500 leading-snug">
247
- Running an unattended pipeline or CI agent that can't open a browser? Use the{' '}
248
- <button
249
- type="button"
250
- onClick={() => setTab('autonomous')}
251
- className="underline text-slate-600 hover:text-slate-900"
252
- >
253
- Autonomous agents
254
- </button>{' '}
255
- tab instead.
256
- </p>
257
- </div>
258
- )}
259
-
260
- {tab === 'autonomous' && (
261
- <div className="px-4 py-3 space-y-4">
262
- <p className="text-xs text-slate-600 leading-snug">
263
- For autonomous agents and pipelines (CI, scheduled jobs) that can't open a browser to
264
- sign in. Create an external API key and give it to the agent. Each key carries your
265
- identity, so any saves the agent makes appear under your name — and it only gets the
266
- tools you've already connected on the Connect your tools page.
267
- </p>
268
-
269
- <div className="border border-slate-200 rounded p-3 space-y-2">
270
- <label htmlFor={labelInputId} className="block text-xs font-medium text-slate-700">
271
- Create an external API key
272
- </label>
273
- <div className="flex gap-2">
274
- <input
275
- id={labelInputId}
276
- value={label}
277
- onChange={(e) => setLabel(e.target.value)}
278
- placeholder="e.g. Claude Code on my laptop"
279
- maxLength={MAX_LABEL_LEN}
280
- className="flex-1 bg-white border border-slate-200 rounded px-2 py-1.5 text-sm focus:outline-none focus:border-slate-300"
281
- onKeyDown={(e) => {
282
- if (e.key === 'Enter' && canSubmit) handleCreate();
283
- }}
284
- />
285
- <button
286
- onClick={handleCreate}
287
- disabled={!canSubmit}
288
- className="px-3 py-1.5 text-sm rounded bg-bevel hover:bg-bevel-deep text-white disabled:opacity-50 disabled:hover:bg-bevel"
289
- >
290
- {creating ? 'Creating…' : 'Create key'}
291
- </button>
292
- </div>
293
- {createError && (
294
- <div className="text-xs text-red-600 bg-red-50 border border-red-200 rounded px-2 py-1.5">
295
- {createError}
296
- </div>
297
- )}
298
- </div>
299
-
300
- <div className="space-y-2">
301
- <div className="text-xs font-medium text-slate-700">Your external API keys</div>
302
- {loadError && (
303
- <div className="text-xs text-red-600 bg-red-50 border border-red-200 rounded px-2 py-1.5">
304
- {loadError}
305
- </div>
306
- )}
307
- {loading ? (
308
- <div className="text-xs text-slate-600">Loading…</div>
309
- ) : keys.length === 0 ? (
310
- <div className="text-xs text-slate-600">No external API keys yet.</div>
311
- ) : (
312
- <ul className="divide-y divide-slate-200 border border-slate-200 rounded">
313
- {sortedKeys.map((k) => {
314
- const revoked = k.revokedAt !== null;
315
- const usage = !revoked ? k.llmUsage : undefined;
316
- const cap = usage?.dailyTokenCap ?? 0;
317
- const used = usage?.usedTodayTokens ?? 0;
318
- const pct = cap > 0 ? Math.min(100, Math.round((used / cap) * 100)) : 0;
319
- const overCap = cap > 0 && used >= cap;
320
- return (
321
- <li
322
- key={k.id}
323
- className={`flex items-center gap-3 px-3 py-2 text-sm ${
324
- revoked ? 'opacity-60' : ''
325
- }`}
326
- >
327
- <div className="flex-1 min-w-0">
328
- <div className="font-medium truncate">{k.label}</div>
329
- <div className="text-[11px] text-slate-600">
330
- Created {formatRelative(k.createdAt)} · Last used {formatRelative(k.lastUsedAt)}
331
- {revoked && ' · Disconnected'}
332
- </div>
333
- {usage && (
334
- <div className="mt-1 max-w-xs">
335
- <div
336
- className={`flex items-center justify-between text-[11px] ${
337
- overCap ? 'text-red-600' : 'text-slate-600'
338
- }`}
339
- >
340
- <span>Model usage today</span>
341
- <span>
342
- {used.toLocaleString()} / {cap.toLocaleString()} tokens
343
- </span>
344
- </div>
345
- <div className="mt-0.5 h-1 rounded bg-slate-100 overflow-hidden">
346
- <div
347
- className={`h-full ${overCap ? 'bg-red-500' : 'bg-bevel'}`}
348
- style={{ width: `${pct}%` }}
349
- />
350
- </div>
351
- </div>
352
- )}
353
- </div>
354
- {revoked ? (
355
- <button
356
- onClick={() => setPendingDelete({ id: k.id, label: k.label })}
357
- className="text-xs px-2 py-1 rounded text-red-600 hover:bg-red-50 border border-slate-200"
358
- title="Permanently delete this disconnected key and its usage history."
359
- >
360
- Delete
361
- </button>
362
- ) : (
363
- <button
364
- onClick={() => handleDisconnect(k.id)}
365
- className="text-xs px-2 py-1 rounded text-slate-700 hover:bg-slate-100 border border-slate-200"
366
- title="Disconnect this external API key. The external agent using it will lose access."
367
- >
368
- Disconnect
369
- </button>
370
- )}
371
- </li>
372
- );
373
- })}
374
- </ul>
375
- )}
376
- </div>
377
- </div>
378
- )}
379
- </PageShell>
380
-
381
- <Dialog
382
- open={pendingDelete !== null}
383
- onClose={() => setPendingDelete(null)}
384
- title="Delete external API key"
385
- size="sm"
386
- busy={deleting}
387
- footer={
388
- <>
389
- <button
390
- onClick={() => setPendingDelete(null)}
391
- disabled={deleting}
392
- className="px-3 py-1.5 text-sm rounded text-slate-700 hover:bg-slate-100 border border-slate-200 disabled:opacity-50"
393
- >
394
- Cancel
395
- </button>
396
- <button
397
- onClick={confirmDelete}
398
- disabled={deleting}
399
- className="px-3 py-1.5 text-sm rounded bg-red-600 hover:bg-red-700 text-white disabled:opacity-50 disabled:hover:bg-red-600"
400
- >
401
- {deleting ? 'Deleting…' : 'Delete'}
402
- </button>
403
- </>
404
- }
405
- >
406
- <p className="text-xs text-slate-700 leading-snug">
407
- Permanently delete{' '}
408
- <span className="font-medium">&ldquo;{pendingDelete?.label}&rdquo;</span>? This removes it
409
- and its usage history for good.
410
- </p>
411
- </Dialog>
412
-
413
- {reveal && (
414
- <div
415
- className="fixed inset-0 z-[60] bg-slate-900/40 flex items-center justify-center p-4"
416
- onClick={(e) => e.stopPropagation()}
417
- >
418
- <div
419
- role="alertdialog"
420
- aria-modal="true"
421
- className="bg-white border border-slate-200 rounded-lg shadow-xl w-full max-w-xl max-h-[90vh] overflow-y-auto"
422
- >
423
- <div className="px-4 py-3 border-b border-slate-200">
424
- <h3 className="text-sm font-semibold">Save this external API key now</h3>
425
- </div>
426
- <div className="px-4 py-3 space-y-3">
427
- <p className="text-xs text-slate-700 leading-snug">
428
- This is the only time you'll see the full key. If you lose it, disconnect it and create a new one.
429
- </p>
430
- <div className="relative">
431
- <textarea
432
- readOnly
433
- value={reveal.plaintext}
434
- rows={2}
435
- className="w-full font-mono text-xs bg-slate-50 border border-slate-200 rounded px-2 py-1.5 pr-10 resize-none"
436
- onFocus={(e) => e.currentTarget.select()}
437
- />
438
- <button
439
- onClick={() => copy(reveal.plaintext)}
440
- className="absolute top-1.5 right-1.5 p-1 rounded hover:bg-slate-100 text-slate-600"
441
- aria-label="Copy external API key"
442
- title="Copy to clipboard"
443
- >
444
- {copied ? <Check size={14} /> : <Copy size={14} />}
445
- </button>
446
- </div>
447
- <div>
448
- <div className="text-xs font-medium text-slate-700 mb-1">
449
- Connect Claude Code
450
- </div>
451
- <textarea
452
- readOnly
453
- value={`claude mcp add --transport http knowledge-base ${window.location.origin}/api/mcp --header "Authorization: Bearer ${reveal.plaintext}"`}
454
- rows={3}
455
- className="w-full font-mono text-[11px] bg-slate-50 border border-slate-200 rounded px-2 py-1.5 resize-none"
456
- onFocus={(e) => e.currentTarget.select()}
457
- />
458
- </div>
459
- <div>
460
- <div className="text-xs font-medium text-slate-700 mb-1">
461
- Connect Langdock
462
- </div>
463
- <ol className="text-[11px] text-slate-600 mb-1 leading-snug list-decimal pl-4 space-y-0.5">
464
- <li>In Langdock, open your workspace settings and go to MCP servers → Add server.</li>
465
- <li>Choose <span className="font-medium">HTTP</span> (Streamable HTTP) as the transport.</li>
466
- <li>Give it a name (e.g. <span className="font-medium">Bevel</span>), paste the URL below into the server URL field, and add the Authorization header under custom headers.</li>
467
- <li>Save, then enable the server in any assistant you want it available in.</li>
468
- </ol>
469
- <textarea
470
- readOnly
471
- value={`URL: ${window.location.origin}/api/mcp\nHeader name: Authorization\nHeader value: Bearer ${reveal.plaintext}`}
472
- rows={3}
473
- className="w-full font-mono text-[11px] bg-slate-50 border border-slate-200 rounded px-2 py-1.5 resize-none"
474
- onFocus={(e) => e.currentTarget.select()}
475
- />
476
- </div>
477
- <div>
478
- <div className="text-xs font-medium text-slate-700 mb-1">
479
- Other agents (JSON config)
480
- </div>
481
- <p className="text-[11px] text-slate-600 mb-1 leading-snug">
482
- Works with Claude Desktop, Cursor, Windsurf, Cline, and most clients that load servers from a JSON config.
483
- </p>
484
- <textarea
485
- readOnly
486
- value={JSON.stringify(
487
- {
488
- mcpServers: {
489
- 'knowledge-base': {
490
- type: 'http',
491
- url: `${window.location.origin}/api/mcp`,
492
- headers: {
493
- Authorization: `Bearer ${reveal.plaintext}`,
494
- },
495
- },
496
- },
497
- },
498
- null,
499
- 2,
500
- )}
501
- rows={11}
502
- className="w-full font-mono text-[11px] bg-slate-50 border border-slate-200 rounded px-2 py-1.5 resize-none"
503
- onFocus={(e) => e.currentTarget.select()}
504
- />
505
- </div>
506
- </div>
507
- <div className="flex justify-end px-4 py-3 border-t border-slate-200">
508
- <button
509
- onClick={() => setReveal(null)}
510
- className="px-3 py-1.5 text-sm rounded bg-bevel hover:bg-bevel-deep text-white"
511
- >
512
- Done — I've saved it
513
- </button>
514
- </div>
515
- </div>
516
- </div>
517
- )}
518
- </>
519
- );
520
- }
521
-
522
- /** Read-only snippet with a copy button, for the no-key connection configs. */
523
- function CopyBlock({ label, value, rows }: { label: string | null; value: string; rows: number }) {
524
- const { copied, copy } = useCopyFeedback();
525
-
526
- return (
527
- <div>
528
- <div className="flex items-center justify-between mb-1">
529
- {label !== null && <div className="text-xs font-medium text-slate-700">{label}</div>}
530
- <button
531
- onClick={() => copy(value)}
532
- className="ml-auto p-1 rounded hover:bg-slate-100 text-slate-600"
533
- aria-label={label ? `Copy: ${label}` : 'Copy to clipboard'}
534
- title="Copy to clipboard"
535
- >
536
- {copied ? <Check size={14} /> : <Copy size={14} />}
537
- </button>
538
- </div>
539
- <textarea
540
- readOnly
541
- value={value}
542
- rows={rows}
543
- className="w-full font-mono text-[11px] bg-slate-50 border border-slate-200 rounded px-2 py-1.5 resize-none"
544
- onFocus={(e) => e.currentTarget.select()}
545
- />
546
- </div>
547
- );
548
- }
1
+ import { useCallback, useEffect, useId, useState } from 'react';
2
+ import { Link } from 'react-router-dom';
3
+ import { Check, Copy, Wrench, ExternalLink } from 'lucide-react';
4
+ import { Dialog } from '../../../shared/components/Dialog';
5
+ import { PageShell } from '../../../shared/components/PageShell';
6
+ import {
7
+ type ExternalApiKeySummary,
8
+ type MintedExternalApiKey,
9
+ createExternalApiKey,
10
+ deleteExternalApiKey,
11
+ disconnectExternalApiKey,
12
+ listExternalApiKeys,
13
+ } from '../services/external-api-keys.api';
14
+
15
+ /**
16
+ * "Copied" affordance with a 1500ms auto-reset. Owns the timer + its teardown
17
+ * (so an unmounting page can't fire a stale setState), shared by the reveal
18
+ * modal and every CopyBlock. `copy(text)` writes to the clipboard and flags
19
+ * copied; a rejected write (insecure context / denied permission) leaves the
20
+ * textarea selectable for manual copy and shows no false "Copied".
21
+ */
22
+ function useCopyFeedback(): { copied: boolean; copy: (text: string) => void } {
23
+ const [copied, setCopied] = useState(false);
24
+ useEffect(() => {
25
+ if (!copied) return;
26
+ const timerId = window.setTimeout(() => setCopied(false), 1500);
27
+ return () => window.clearTimeout(timerId);
28
+ }, [copied]);
29
+ const copy = useCallback((text: string) => {
30
+ void navigator.clipboard
31
+ .writeText(text)
32
+ .then(() => setCopied(true))
33
+ .catch(() => {});
34
+ }, []);
35
+ return { copied, copy };
36
+ }
37
+
38
+ const MAX_LABEL_LEN = 200;
39
+
40
+ function formatRelative(ts: number | null): string {
41
+ if (ts === null) return 'never';
42
+ const diff = Date.now() - ts;
43
+ const minutes = Math.round(diff / 60_000);
44
+ if (minutes < 1) return 'just now';
45
+ if (minutes < 60) return `${minutes} min ago`;
46
+ const hours = Math.round(minutes / 60);
47
+ if (hours < 24) return `${hours} hr ago`;
48
+ const days = Math.round(hours / 24);
49
+ if (days < 30) return `${days} day${days === 1 ? '' : 's'} ago`;
50
+ return new Date(ts).toLocaleDateString();
51
+ }
52
+
53
+ /**
54
+ * The External agent access page, routed standalone at
55
+ * `/external-agent-access` (below the persistent toolbar), in two tabs:
56
+ *
57
+ * - "Your agent" (default) — connecting the user's own interactive agent
58
+ * (Claude Code, Claude Desktop, Cursor…). No key: the agent gets only the
59
+ * server URL, and on first connect the browser opens our authorization
60
+ * flow (sign in + choose tools on /connect). Copy-paste configs only.
61
+ * - "Autonomous agents" — the external-API-key surface for pipelines/CI
62
+ * that can't open a browser: lists existing keys, mints new ones,
63
+ * disconnects revoked ones, permanently deletes disconnected ones. The
64
+ * plaintext of a minted key is only shown once — there is no read-it-back
65
+ * endpoint.
66
+ *
67
+ * Glossary terms used in copy: "External API key", "Disconnect" (= revoke),
68
+ * "External agent" (= MCP client). See docs/glossary.md.
69
+ */
70
+ export function ExternalAgentAccessPage() {
71
+ const labelInputId = useId();
72
+
73
+ const [tab, setTab] = useState<'agent' | 'autonomous'>('agent');
74
+ const [keys, setKeys] = useState<ExternalApiKeySummary[]>([]);
75
+ const [loading, setLoading] = useState(false);
76
+ const [loadError, setLoadError] = useState<string | null>(null);
77
+
78
+ const [label, setLabel] = useState('');
79
+ const [creating, setCreating] = useState(false);
80
+ const [createError, setCreateError] = useState<string | null>(null);
81
+
82
+ // The plaintext of a freshly minted key. Held in state for the lifetime
83
+ // of the reveal modal — never persisted, and cleared when the user
84
+ // dismisses the reveal step.
85
+ const [reveal, setReveal] = useState<MintedExternalApiKey | null>(null);
86
+ const { copied, copy } = useCopyFeedback();
87
+
88
+ // The disconnected key awaiting a permanent-delete confirmation. Non-null
89
+ // drives the themed confirm Dialog below; `deleting` keeps the request in
90
+ // flight so the confirm can't be dismissed mid-delete.
91
+ const [pendingDelete, setPendingDelete] = useState<{ id: string; label: string } | null>(null);
92
+ const [deleting, setDeleting] = useState(false);
93
+
94
+ const refresh = useCallback(async () => {
95
+ setLoading(true);
96
+ setLoadError(null);
97
+ try {
98
+ setKeys(await listExternalApiKeys());
99
+ } catch (err) {
100
+ setLoadError(err instanceof Error ? err.message : "Couldn't load external API keys.");
101
+ } finally {
102
+ setLoading(false);
103
+ }
104
+ }, []);
105
+
106
+ useEffect(() => {
107
+ void refresh();
108
+ }, [refresh]);
109
+
110
+ async function handleCreate() {
111
+ const trimmed = label.trim();
112
+ if (trimmed.length === 0 || trimmed.length > MAX_LABEL_LEN || creating) return;
113
+ setCreating(true);
114
+ setCreateError(null);
115
+ try {
116
+ const minted = await createExternalApiKey(trimmed);
117
+ setReveal(minted);
118
+ setLabel('');
119
+ // Optimistic-ish: refresh the list so the new row shows up underneath
120
+ // the reveal modal.
121
+ void refresh();
122
+ } catch (err) {
123
+ setCreateError(err instanceof Error ? err.message : "Couldn't create external API key.");
124
+ } finally {
125
+ setCreating(false);
126
+ }
127
+ }
128
+
129
+ async function handleDisconnect(id: string) {
130
+ try {
131
+ await disconnectExternalApiKey(id);
132
+ await refresh();
133
+ } catch (err) {
134
+ setLoadError(err instanceof Error ? err.message : "Couldn't disconnect this key.");
135
+ }
136
+ }
137
+
138
+ async function confirmDelete() {
139
+ if (!pendingDelete || deleting) return;
140
+ setDeleting(true);
141
+ try {
142
+ await deleteExternalApiKey(pendingDelete.id);
143
+ setPendingDelete(null);
144
+ await refresh();
145
+ } catch (err) {
146
+ setLoadError(err instanceof Error ? err.message : "Couldn't delete this key.");
147
+ setPendingDelete(null);
148
+ } finally {
149
+ setDeleting(false);
150
+ }
151
+ }
152
+
153
+ const trimmed = label.trim();
154
+ const canSubmit = trimmed.length > 0 && trimmed.length <= MAX_LABEL_LEN && !creating;
155
+
156
+ // Surface the keys that matter: active keys first (most-recently-used at the
157
+ // top, never-used ones last within that group), with disconnected keys sunk
158
+ // to the bottom. Non-destructive — nothing is hidden or deleted, just ordered
159
+ // so a long list of stale/test keys doesn't bury the ones in use.
160
+ const sortedKeys = [...keys].sort((a, b) => {
161
+ const aRevoked = a.revokedAt !== null;
162
+ const bRevoked = b.revokedAt !== null;
163
+ if (aRevoked !== bRevoked) return aRevoked ? 1 : -1;
164
+ return (b.lastUsedAt ?? 0) - (a.lastUsedAt ?? 0);
165
+ });
166
+
167
+ return (
168
+ <>
169
+ <PageShell title="External agent access" padded={false}>
170
+ <div className="flex border-b border-line px-4 shrink-0" role="tablist">
171
+ {(
172
+ [
173
+ ['agent', 'Your agent'],
174
+ ['autonomous', 'Autonomous agents'],
175
+ ] as const
176
+ ).map(([id, name]) => (
177
+ <button
178
+ key={id}
179
+ role="tab"
180
+ aria-selected={tab === id}
181
+ onClick={() => setTab(id)}
182
+ className={`px-3 py-2 text-xs font-medium border-b-2 -mb-px ${
183
+ tab === id
184
+ ? 'border-accent text-ink'
185
+ : 'border-transparent text-ink-muted hover:text-ink'
186
+ }`}
187
+ >
188
+ {name}
189
+ </button>
190
+ ))}
191
+ </div>
192
+
193
+ {tab === 'agent' && (
194
+ <div className="px-4 py-3 space-y-4">
195
+ <p className="text-xs text-ink-muted leading-snug">
196
+ Connect your own agent: Claude Code, Claude Desktop, Cursor and similar. No key
197
+ needed: the first time the agent connects, your browser opens so you can sign in and
198
+ choose which tools to share with it. Everything it saves appears under your name.
199
+ </p>
200
+ <Link
201
+ to="/connect"
202
+ target="_blank"
203
+ rel="noopener noreferrer"
204
+ className="flex items-center justify-center gap-1.5 rounded border border-line px-2 py-1.5 text-xs text-ink hover:bg-hover"
205
+ >
206
+ <Wrench size={12} />
207
+ Configure your tools
208
+ <ExternalLink size={11} className="opacity-60" />
209
+ </Link>
210
+ <CopyBlock
211
+ label="Connect Claude Code"
212
+ value={`claude mcp add --transport http knowledge-base ${window.location.origin}/api/mcp`}
213
+ rows={2}
214
+ />
215
+ <div>
216
+ <div className="text-xs font-medium text-ink mb-1">claude.ai / Claude Desktop</div>
217
+ <p className="text-[11px] text-ink-muted mb-1 leading-snug">
218
+ Settings → Connectors → Add custom connector, then paste this URL. When asked to
219
+ authorize, your browser opens this app to finish connecting.
220
+ </p>
221
+ <CopyBlock label={null} value={`${window.location.origin}/api/mcp`} rows={1} />
222
+ </div>
223
+ <div>
224
+ <div className="text-xs font-medium text-ink mb-1">Other agents (JSON config)</div>
225
+ <p className="text-[11px] text-ink-muted mb-1 leading-snug">
226
+ Works with Cursor, Windsurf, Cline, and most clients that load servers from a JSON
227
+ config and support signing in.
228
+ </p>
229
+ <CopyBlock
230
+ label={null}
231
+ value={JSON.stringify(
232
+ {
233
+ mcpServers: {
234
+ 'knowledge-base': {
235
+ type: 'http',
236
+ url: `${window.location.origin}/api/mcp`,
237
+ },
238
+ },
239
+ },
240
+ null,
241
+ 2,
242
+ )}
243
+ rows={9}
244
+ />
245
+ </div>
246
+ <p className="text-[11px] text-ink-muted leading-snug">
247
+ Running an unattended pipeline or CI agent that can't open a browser? Use the{' '}
248
+ <button
249
+ type="button"
250
+ onClick={() => setTab('autonomous')}
251
+ className="underline text-ink-muted hover:text-ink"
252
+ >
253
+ Autonomous agents
254
+ </button>{' '}
255
+ tab instead.
256
+ </p>
257
+ </div>
258
+ )}
259
+
260
+ {tab === 'autonomous' && (
261
+ <div className="px-4 py-3 space-y-4">
262
+ <p className="text-xs text-ink-muted leading-snug">
263
+ For autonomous agents and pipelines (CI, scheduled jobs) that can't open a browser to
264
+ sign in. Create an external API key and give it to the agent. Each key carries your
265
+ identity, so any saves the agent makes appear under your name. And it only gets the
266
+ tools you've already connected on the Connect your tools page.
267
+ </p>
268
+
269
+ <div className="border border-line rounded p-3 space-y-2">
270
+ <label htmlFor={labelInputId} className="block text-xs font-medium text-ink">
271
+ Create an external API key
272
+ </label>
273
+ <div className="flex gap-2">
274
+ <input
275
+ id={labelInputId}
276
+ value={label}
277
+ onChange={(e) => setLabel(e.target.value)}
278
+ placeholder="e.g. Claude Code on my laptop"
279
+ maxLength={MAX_LABEL_LEN}
280
+ className="flex-1 bg-white border border-line rounded px-2 py-1.5 text-sm focus:outline-none focus:border-accent"
281
+ onKeyDown={(e) => {
282
+ if (e.key === 'Enter' && canSubmit) handleCreate();
283
+ }}
284
+ />
285
+ <button
286
+ onClick={handleCreate}
287
+ disabled={!canSubmit}
288
+ className="px-3 py-1.5 text-sm rounded bg-accent hover:bg-accent-hover text-white disabled:opacity-50 disabled:hover:bg-accent"
289
+ >
290
+ {creating ? 'Creating…' : 'Create key'}
291
+ </button>
292
+ </div>
293
+ {createError && (
294
+ <div className="text-xs text-red-600 bg-red-50 border border-red-200 rounded px-2 py-1.5">
295
+ {createError}
296
+ </div>
297
+ )}
298
+ </div>
299
+
300
+ <div className="space-y-2">
301
+ <div className="text-xs font-medium text-ink">Your external API keys</div>
302
+ {loadError && (
303
+ <div className="text-xs text-red-600 bg-red-50 border border-red-200 rounded px-2 py-1.5">
304
+ {loadError}
305
+ </div>
306
+ )}
307
+ {loading ? (
308
+ <div className="text-xs text-ink-muted">Loading…</div>
309
+ ) : keys.length === 0 ? (
310
+ <div className="text-xs text-ink-muted">No external API keys yet.</div>
311
+ ) : (
312
+ <ul className="divide-y divide-line border border-line rounded">
313
+ {sortedKeys.map((k) => {
314
+ const revoked = k.revokedAt !== null;
315
+ const usage = !revoked ? k.llmUsage : undefined;
316
+ const cap = usage?.dailyTokenCap ?? 0;
317
+ const used = usage?.usedTodayTokens ?? 0;
318
+ const pct = cap > 0 ? Math.min(100, Math.round((used / cap) * 100)) : 0;
319
+ const overCap = cap > 0 && used >= cap;
320
+ return (
321
+ <li
322
+ key={k.id}
323
+ className={`flex items-center gap-3 px-3 py-2 text-sm ${
324
+ revoked ? 'opacity-60' : ''
325
+ }`}
326
+ >
327
+ <div className="flex-1 min-w-0">
328
+ <div className="font-medium truncate">{k.label}</div>
329
+ <div className="text-[11px] text-ink-muted">
330
+ Created {formatRelative(k.createdAt)} · Last used {formatRelative(k.lastUsedAt)}
331
+ {revoked && ' · Disconnected'}
332
+ </div>
333
+ {usage && (
334
+ <div className="mt-1 max-w-xs">
335
+ <div
336
+ className={`flex items-center justify-between text-[11px] ${
337
+ overCap ? 'text-red-600' : 'text-ink-muted'
338
+ }`}
339
+ >
340
+ <span>Model usage today</span>
341
+ <span>
342
+ {used.toLocaleString()} / {cap.toLocaleString()} tokens
343
+ </span>
344
+ </div>
345
+ <div className="mt-0.5 h-1 rounded bg-sunken overflow-hidden">
346
+ <div
347
+ className={`h-full ${overCap ? 'bg-red-500' : 'bg-accent'}`}
348
+ style={{ width: `${pct}%` }}
349
+ />
350
+ </div>
351
+ </div>
352
+ )}
353
+ </div>
354
+ {revoked ? (
355
+ <button
356
+ onClick={() => setPendingDelete({ id: k.id, label: k.label })}
357
+ className="text-xs px-2 py-1 rounded text-red-600 hover:bg-red-50 border border-line"
358
+ title="Permanently delete this disconnected key and its usage history."
359
+ >
360
+ Delete
361
+ </button>
362
+ ) : (
363
+ <button
364
+ onClick={() => handleDisconnect(k.id)}
365
+ className="text-xs px-2 py-1 rounded text-ink hover:bg-hover border border-line"
366
+ title="Disconnect this external API key. The external agent using it will lose access."
367
+ >
368
+ Disconnect
369
+ </button>
370
+ )}
371
+ </li>
372
+ );
373
+ })}
374
+ </ul>
375
+ )}
376
+ </div>
377
+ </div>
378
+ )}
379
+ </PageShell>
380
+
381
+ <Dialog
382
+ open={pendingDelete !== null}
383
+ onClose={() => setPendingDelete(null)}
384
+ title="Delete external API key"
385
+ size="sm"
386
+ busy={deleting}
387
+ footer={
388
+ <>
389
+ <button
390
+ onClick={() => setPendingDelete(null)}
391
+ disabled={deleting}
392
+ className="px-3 py-1.5 text-sm rounded text-ink hover:bg-hover border border-line disabled:opacity-50"
393
+ >
394
+ Cancel
395
+ </button>
396
+ <button
397
+ onClick={confirmDelete}
398
+ disabled={deleting}
399
+ className="px-3 py-1.5 text-sm rounded bg-red-600 hover:bg-red-700 text-white disabled:opacity-50 disabled:hover:bg-red-600"
400
+ >
401
+ {deleting ? 'Deleting…' : 'Delete'}
402
+ </button>
403
+ </>
404
+ }
405
+ >
406
+ <p className="text-xs text-ink leading-snug">
407
+ Permanently delete{' '}
408
+ <span className="font-medium">&ldquo;{pendingDelete?.label}&rdquo;</span>? This removes it
409
+ and its usage history for good.
410
+ </p>
411
+ </Dialog>
412
+
413
+ {reveal && (
414
+ <div
415
+ className="fixed inset-0 z-[60] bg-scrim flex items-center justify-center p-4"
416
+ onClick={(e) => e.stopPropagation()}
417
+ >
418
+ <div
419
+ role="alertdialog"
420
+ aria-modal="true"
421
+ className="bg-white border border-line rounded-lg shadow-xl w-full max-w-xl max-h-[90vh] overflow-y-auto"
422
+ >
423
+ <div className="px-4 py-3 border-b border-line">
424
+ <h3 className="text-sm font-semibold">Save this external API key now</h3>
425
+ </div>
426
+ <div className="px-4 py-3 space-y-3">
427
+ <p className="text-xs text-ink leading-snug">
428
+ This is the only time you'll see the full key. If you lose it, disconnect it and create a new one.
429
+ </p>
430
+ <div className="relative">
431
+ <textarea
432
+ readOnly
433
+ value={reveal.plaintext}
434
+ rows={2}
435
+ className="w-full font-mono text-xs bg-sunken border border-line rounded px-2 py-1.5 pr-10 resize-none"
436
+ onFocus={(e) => e.currentTarget.select()}
437
+ />
438
+ <button
439
+ onClick={() => copy(reveal.plaintext)}
440
+ className="absolute top-1.5 right-1.5 p-1 rounded hover:bg-hover text-ink-muted"
441
+ aria-label="Copy external API key"
442
+ title="Copy to clipboard"
443
+ >
444
+ {copied ? <Check size={14} /> : <Copy size={14} />}
445
+ </button>
446
+ </div>
447
+ <div>
448
+ <div className="text-xs font-medium text-ink mb-1">
449
+ Connect Claude Code
450
+ </div>
451
+ <textarea
452
+ readOnly
453
+ value={`claude mcp add --transport http knowledge-base ${window.location.origin}/api/mcp --header "Authorization: Bearer ${reveal.plaintext}"`}
454
+ rows={3}
455
+ className="w-full font-mono text-[11px] bg-sunken border border-line rounded px-2 py-1.5 resize-none"
456
+ onFocus={(e) => e.currentTarget.select()}
457
+ />
458
+ </div>
459
+ <div>
460
+ <div className="text-xs font-medium text-ink mb-1">
461
+ Connect Langdock
462
+ </div>
463
+ <ol className="text-[11px] text-ink-muted mb-1 leading-snug list-decimal pl-4 space-y-0.5">
464
+ <li>In Langdock, open your workspace settings and go to MCP servers → Add server.</li>
465
+ <li>Choose <span className="font-medium">HTTP</span> (Streamable HTTP) as the transport.</li>
466
+ <li>Give it a name (e.g. <span className="font-medium">Bevel</span>), paste the URL below into the server URL field, and add the Authorization header under custom headers.</li>
467
+ <li>Save, then enable the server in any assistant you want it available in.</li>
468
+ </ol>
469
+ <textarea
470
+ readOnly
471
+ value={`URL: ${window.location.origin}/api/mcp\nHeader name: Authorization\nHeader value: Bearer ${reveal.plaintext}`}
472
+ rows={3}
473
+ className="w-full font-mono text-[11px] bg-sunken border border-line rounded px-2 py-1.5 resize-none"
474
+ onFocus={(e) => e.currentTarget.select()}
475
+ />
476
+ </div>
477
+ <div>
478
+ <div className="text-xs font-medium text-ink mb-1">
479
+ Other agents (JSON config)
480
+ </div>
481
+ <p className="text-[11px] text-ink-muted mb-1 leading-snug">
482
+ Works with Claude Desktop, Cursor, Windsurf, Cline, and most clients that load servers from a JSON config.
483
+ </p>
484
+ <textarea
485
+ readOnly
486
+ value={JSON.stringify(
487
+ {
488
+ mcpServers: {
489
+ 'knowledge-base': {
490
+ type: 'http',
491
+ url: `${window.location.origin}/api/mcp`,
492
+ headers: {
493
+ Authorization: `Bearer ${reveal.plaintext}`,
494
+ },
495
+ },
496
+ },
497
+ },
498
+ null,
499
+ 2,
500
+ )}
501
+ rows={11}
502
+ className="w-full font-mono text-[11px] bg-sunken border border-line rounded px-2 py-1.5 resize-none"
503
+ onFocus={(e) => e.currentTarget.select()}
504
+ />
505
+ </div>
506
+ </div>
507
+ <div className="flex justify-end px-4 py-3 border-t border-line">
508
+ <button
509
+ onClick={() => setReveal(null)}
510
+ className="px-3 py-1.5 text-sm rounded bg-accent hover:bg-accent-hover text-white"
511
+ >
512
+ Done: I've saved it
513
+ </button>
514
+ </div>
515
+ </div>
516
+ </div>
517
+ )}
518
+ </>
519
+ );
520
+ }
521
+
522
+ /** Read-only snippet with a copy button, for the no-key connection configs. */
523
+ function CopyBlock({ label, value, rows }: { label: string | null; value: string; rows: number }) {
524
+ const { copied, copy } = useCopyFeedback();
525
+
526
+ return (
527
+ <div>
528
+ <div className="flex items-center justify-between mb-1">
529
+ {label !== null && <div className="text-xs font-medium text-ink">{label}</div>}
530
+ <button
531
+ onClick={() => copy(value)}
532
+ className="ml-auto p-1 rounded hover:bg-hover text-ink-muted"
533
+ aria-label={label ? `Copy: ${label}` : 'Copy to clipboard'}
534
+ title="Copy to clipboard"
535
+ >
536
+ {copied ? <Check size={14} /> : <Copy size={14} />}
537
+ </button>
538
+ </div>
539
+ <textarea
540
+ readOnly
541
+ value={value}
542
+ rows={rows}
543
+ className="w-full font-mono text-[11px] bg-sunken border border-line rounded px-2 py-1.5 resize-none"
544
+ onFocus={(e) => e.currentTarget.select()}
545
+ />
546
+ </div>
547
+ );
548
+ }