@bevel-software/platform-core-frontend 0.14.0 → 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 (360) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +34 -26
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/bootstrap.test.ts +33 -1
  6. package/src/core/__tests__/events.test.ts +43 -0
  7. package/src/core/bootstrap.ts +38 -1
  8. package/src/core/events.ts +85 -3
  9. package/src/core/registry.ts +1 -1
  10. package/src/lib/__tests__/api.test.ts +38 -0
  11. package/src/lib/__tests__/email.test.ts +44 -0
  12. package/src/lib/api.ts +19 -2
  13. package/src/lib/email.ts +37 -1
  14. package/src/lib/utils.ts +2 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  16. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  20. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  21. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  22. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  23. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  24. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +781 -76
  25. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  26. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  27. package/src/modules/access/__tests__/plugin-token.test.ts +21 -0
  28. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  29. package/src/modules/access/api.ts +192 -10
  30. package/src/modules/access/components/ManageAccessDialog.tsx +1337 -570
  31. package/src/modules/access/manage-access-affordance.ts +17 -0
  32. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  33. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  34. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  35. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  36. package/src/modules/admin/__tests__/ConnectionKeysPage.test.tsx +266 -0
  37. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  38. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  39. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  40. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  41. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  42. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  43. package/src/modules/admin/components/ConnectionKeysPage.tsx +269 -0
  44. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  45. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  46. package/src/modules/admin/components/connection-keys-grouping.ts +43 -0
  47. package/src/modules/admin/components/group-members-path.ts +32 -0
  48. package/src/modules/admin/services/connection-keys.api.ts +47 -0
  49. package/src/modules/admin/services/roles.api.ts +12 -1
  50. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  51. package/src/modules/auth/components/AccountPage.tsx +73 -54
  52. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  53. package/src/modules/auth/services/account.api.ts +78 -4
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  57. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  58. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  59. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  60. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  61. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  62. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  63. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  64. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  65. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  66. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  67. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  68. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  69. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  70. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  71. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  72. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  73. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  74. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  75. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  76. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  77. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  78. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  79. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  80. package/src/modules/change-requests/services/propose.api.ts +97 -8
  81. package/src/modules/change-requests/utils/approval.ts +15 -0
  82. package/src/modules/change-requests/utils/author.ts +32 -0
  83. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  84. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  85. package/src/modules/git/__tests__/GitSyncFailedBanner.test.tsx +65 -1
  86. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  87. package/src/modules/git/components/GitSyncFailedBanner.tsx +68 -5
  88. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  89. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  90. package/src/modules/git/services/error-messages.ts +12 -0
  91. package/src/modules/git/services/pr-prompts.ts +5 -5
  92. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  93. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  94. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  95. package/src/modules/layout/components/AppLayout.tsx +2 -0
  96. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  97. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  98. package/src/modules/layout/components/SidebarFrame.tsx +109 -4
  99. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  100. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  101. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  102. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  103. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  104. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +104 -99
  105. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +136 -0
  106. package/src/modules/library/__tests__/LockedPluginView.test.tsx +103 -7
  107. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +18 -8
  108. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  109. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  110. package/src/modules/library/__tests__/PluginExtras.test.tsx +115 -9
  111. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  112. package/src/modules/library/__tests__/PluginPage.test.tsx +453 -7
  113. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +17 -57
  114. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +161 -97
  115. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  116. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  117. package/src/modules/library/__tests__/SkillPage.test.tsx +391 -78
  118. package/src/modules/library/__tests__/SkillsTree.test.tsx +461 -0
  119. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  120. package/src/modules/library/__tests__/ToolPage.test.tsx +94 -4
  121. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +279 -21
  122. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  123. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  124. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  125. package/src/modules/library/__tests__/library-data.stale.test.tsx +183 -0
  126. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  127. package/src/modules/library/__tests__/library-paths.test.ts +75 -0
  128. package/src/modules/library/__tests__/link-membership.test.ts +129 -0
  129. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  130. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  131. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  132. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  133. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  134. package/src/modules/library/__tests__/plugin-summary.test.ts +67 -0
  135. package/src/modules/library/__tests__/status.test.ts +82 -2
  136. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  137. package/src/modules/library/__tests__/useJoinRequests.test.tsx +46 -0
  138. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  139. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  140. package/src/modules/library/components/AddToPluginDialog.tsx +107 -18
  141. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  142. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  143. package/src/modules/library/components/LibraryCard.tsx +149 -34
  144. package/src/modules/library/components/LibraryLayout.tsx +120 -247
  145. package/src/modules/library/components/LibraryPage.tsx +172 -39
  146. package/src/modules/library/components/LinkSkillPanel.tsx +169 -0
  147. package/src/modules/library/components/LockedPluginView.tsx +63 -35
  148. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  149. package/src/modules/library/components/NewPluginDialog.tsx +19 -5
  150. package/src/modules/library/components/PageActions.tsx +31 -9
  151. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  152. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  153. package/src/modules/library/components/PersonalPluginPage.tsx +123 -23
  154. package/src/modules/library/components/PluginExtras.tsx +143 -18
  155. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  156. package/src/modules/library/components/PluginPage.tsx +234 -38
  157. package/src/modules/library/components/PluginRows.tsx +286 -0
  158. package/src/modules/library/components/PluginsSidebar.tsx +271 -238
  159. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  160. package/src/modules/library/components/RenamePluginDialog.tsx +136 -0
  161. package/src/modules/library/components/ShareButton.tsx +17 -0
  162. package/src/modules/library/components/SkillsTree.tsx +204 -0
  163. package/src/modules/library/components/StatusDot.tsx +1 -0
  164. package/src/modules/library/components/TeamRoute.tsx +15 -0
  165. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  166. package/src/modules/library/components/plugin-page-parts.tsx +132 -23
  167. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +212 -0
  168. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  169. package/src/modules/library/components/skill-page/SkillPage.tsx +337 -121
  170. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  171. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  172. package/src/modules/library/components/tool-page/ToolPage.tsx +116 -17
  173. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  174. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  175. package/src/modules/library/hooks/useJoinRequests.ts +48 -18
  176. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  177. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  178. package/src/modules/library/routes/WorkspaceItemRoute.tsx +229 -82
  179. package/src/modules/library/routes/library-paths.ts +46 -35
  180. package/src/modules/library/services/library.api.ts +89 -17
  181. package/src/modules/library/services/plugins.api.ts +161 -9
  182. package/src/modules/library/services/teams.api.ts +15 -0
  183. package/src/modules/library/services/tools.api.ts +78 -0
  184. package/src/modules/library/state/library-data.tsx +268 -37
  185. package/src/modules/library/utils/personal-plugin.ts +13 -15
  186. package/src/modules/library/utils/plugin-entries.ts +134 -0
  187. package/src/modules/library/utils/plugin-summary.ts +102 -0
  188. package/src/modules/library/utils/status.ts +204 -35
  189. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +11 -3
  190. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  191. package/src/modules/onboarding/agent-clients.ts +55 -23
  192. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  193. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  194. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  195. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  196. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  197. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  198. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  199. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  200. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  201. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  202. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  203. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  204. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  205. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  206. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  207. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  208. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  209. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  210. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  211. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  212. package/src/modules/settings/components/ClaudeConnectionCard.tsx +154 -0
  213. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  214. package/src/modules/settings/components/DeploymentPage.tsx +16 -22
  215. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  216. package/src/modules/settings/components/__tests__/ClaudeConnectionCard.test.tsx +63 -0
  217. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +74 -1
  218. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  219. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +5 -5
  220. package/src/modules/settings/services/github-facade.api.ts +66 -0
  221. package/src/modules/settings/settings-nav-items.tsx +10 -2
  222. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  223. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  224. package/src/modules/setup/__tests__/setup.test.tsx +615 -4
  225. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  226. package/src/modules/setup/components/SetupGate.tsx +16 -16
  227. package/src/modules/setup/components/SetupScreen.tsx +711 -40
  228. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  229. package/src/modules/setup/services/setup.api.ts +218 -3
  230. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  231. package/src/modules/setup/utils/root-folders.ts +46 -0
  232. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  233. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  234. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  235. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  236. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  237. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  238. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  239. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  240. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  241. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  242. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  243. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  244. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  245. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  246. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  247. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  248. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +395 -124
  249. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  250. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  251. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  252. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +659 -36
  253. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  254. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  255. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  256. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  257. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  258. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  259. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  260. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  261. package/src/modules/toolbar/services/external-api-keys.api.ts +8 -0
  262. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  263. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  264. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  265. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  266. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  267. package/src/modules/workspace/__tests__/testFixtures.ts +6 -3
  268. package/src/modules/workspace/components/FileExplorer.tsx +1527 -367
  269. package/src/modules/workspace/components/FileRoute.tsx +376 -22
  270. package/src/modules/workspace/components/FileViewer.tsx +166 -45
  271. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  272. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  273. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  274. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2473 -129
  275. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +768 -16
  276. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +332 -12
  277. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  278. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  279. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  280. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  281. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  282. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  283. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  284. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  285. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  286. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  287. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  288. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  289. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  290. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  291. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  292. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  293. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  294. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  295. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  296. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  297. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  298. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  299. package/src/modules/workspace/components/renderers/index.ts +53 -2
  300. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  301. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  302. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  303. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  304. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  305. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  306. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  307. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +89 -0
  308. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  309. package/src/modules/workspace/hooks/useWorkspaceState.ts +438 -66
  310. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  311. package/src/modules/workspace/routing/kb-routes.ts +207 -30
  312. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +57 -1
  313. package/src/modules/workspace/services/workspace.api.ts +57 -4
  314. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  315. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  316. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  317. package/src/modules/workspace/state/workspace.context.ts +130 -16
  318. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  319. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +234 -5
  320. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  321. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  322. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  323. package/src/modules/workspace/utils/file-trace.ts +50 -0
  324. package/src/modules/workspace/utils/fileTree.ts +126 -52
  325. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  326. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  327. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  328. package/src/modules/workspace/utils/uploadError.ts +29 -0
  329. package/src/shared/__tests__/marketplace-url.test.ts +59 -0
  330. package/src/shared/components/Badge.tsx +3 -1
  331. package/src/shared/components/Banner.tsx +5 -1
  332. package/src/shared/components/Button.tsx +16 -2
  333. package/src/shared/components/Dialog.tsx +27 -11
  334. package/src/shared/components/Menu.tsx +13 -1
  335. package/src/shared/components/PageShell.tsx +13 -8
  336. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  337. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  338. package/src/shared/components/index.ts +2 -0
  339. package/src/shared/components/useDismissableMenu.ts +32 -10
  340. package/src/shared/components/useFocusHandoff.ts +51 -0
  341. package/src/shared/components/useLatestRef.ts +28 -0
  342. package/src/shared/markdown/Markdown.tsx +12 -3
  343. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  344. package/src/shared/markdown/hrefs.ts +50 -0
  345. package/src/shared/marketplace-url.ts +118 -0
  346. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  347. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  348. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  349. package/src/shared/mcp/connect-snippets.ts +14 -9
  350. package/src/shared/mcp/index.ts +1 -1
  351. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  352. package/src/shared/theme/header.ts +75 -0
  353. package/src/shared/theme/measure.ts +7 -4
  354. package/src/shared/theme/tokens.css +34 -0
  355. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  356. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  357. package/src/modules/library/components/PluginsIndexPage.tsx +0 -265
  358. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  359. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  360. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -1,7 +1,8 @@
1
- import { DEFAULT_BRANCH, PLUGINS_DIR, pluginOfPath, isPersonalPluginFolder } from '@bevel-software/platform-shared';
1
+ import { DEFAULT_BRANCH, PLUGINS_DIR, SKILLS_DIR, pluginOfPath, isPersonalPluginFolder } from '@bevel-software/platform-shared';
2
2
  import { matchPath } from 'react-router-dom';
3
3
  import { kbFileUrl } from '../../workspace/routing/kb-routes';
4
4
  import type { LibraryFilter } from '../utils/status';
5
+ import { PERSONAL_PLUGIN_NAME } from '../utils/personal-plugin';
5
6
 
6
7
  /**
7
8
  * The Library's URL↔selection mapping, in one place and in both directions.
@@ -17,19 +18,25 @@ export const LIBRARY_ROOT = '/skills-and-tools';
17
18
 
18
19
  /**
19
20
  * What the sidebar should show as selected for a path. `null` on the pages that
20
- * are not a filtered view of the catalog — the all-plugins index (the root, see
21
- * `isPluginsIndexPath`) and the item pages — where the gallery rows are all
22
- * inactive.
21
+ * are not a filtered view of the catalog — the item pages and the plugin
22
+ * pages — where the gallery rows are all inactive.
23
+ *
24
+ * The root IS Everything: the Library opens on the whole catalog, plugins
25
+ * included, and `everything` survives as a second spelling of the same
26
+ * page so older links still land.
23
27
  *
24
28
  * `matchPath` hands params back RAW (react-router decodes neither here nor in
25
29
  * `useParams`), so a plugin named `Sales & Ops` arrives as `Sales%20%26%20Ops`
26
30
  * and has to be decoded to match the catalog's folder name. The plugin page owes
27
- * the same decode on `useParams().plugin`.
31
+ * the same decode on `useParams().plugin`; a team's name is read the same way.
28
32
  */
29
33
  export function libraryFilterForPath(pathname: string): LibraryFilter | null {
34
+ if (matchPath({ path: LIBRARY_ROOT, end: true }, pathname)) return { kind: 'all' };
30
35
  if (matchPath({ path: `${LIBRARY_ROOT}/everything`, end: true }, pathname)) return { kind: 'all' };
31
36
  if (matchPath({ path: `${LIBRARY_ROOT}/owned`, end: true }, pathname)) return { kind: 'owned' };
32
37
  if (matchPath({ path: `${LIBRARY_ROOT}/yours`, end: true }, pathname)) return { kind: 'ungrouped' };
38
+ const team = matchPath({ path: `${LIBRARY_ROOT}/teams/:group`, end: true }, pathname);
39
+ if (team?.params.group) return { kind: 'team', group: decodeSegment(team.params.group) };
33
40
  const plugin = matchPath({ path: `${LIBRARY_ROOT}/plugins/:plugin`, end: true }, pathname);
34
41
  if (plugin?.params.plugin) return { kind: 'group', plugin: decodeSegment(plugin.params.plugin) };
35
42
  return null;
@@ -39,11 +46,13 @@ export function libraryFilterForPath(pathname: string): LibraryFilter | null {
39
46
  export function pathForLibraryFilter(filter: LibraryFilter): string {
40
47
  switch (filter.kind) {
41
48
  case 'all':
42
- return `${LIBRARY_ROOT}/everything`;
49
+ return LIBRARY_ROOT;
43
50
  case 'owned':
44
51
  return `${LIBRARY_ROOT}/owned`;
45
52
  case 'ungrouped':
46
53
  return `${LIBRARY_ROOT}/yours`;
54
+ case 'team':
55
+ return pathForTeam(filter.group);
47
56
  case 'group':
48
57
  return pathForPlugin(filter.plugin);
49
58
  }
@@ -54,10 +63,15 @@ export function pathForPlugin(plugin: string): string {
54
63
  return `${LIBRARY_ROOT}/plugins/${encodeURIComponent(plugin)}`;
55
64
  }
56
65
 
66
+ /** The route for one team's lens: what the group can use, as cards. */
67
+ export function pathForTeam(group: string): string {
68
+ return `${LIBRARY_ROOT}/teams/${encodeURIComponent(group)}`;
69
+ }
70
+
57
71
  /**
58
- * The all-plugins index — the Library's HOME. Plugins are the structure of this
59
- * surface, so the index of them is what the root shows; `plugins` is kept as a
60
- * redirect so the links that used to name it still land.
72
+ * The Library's HOME — Everything, plugins and all. The all-plugins index used
73
+ * to live here and is folded into it; `plugins` is kept as a redirect so the
74
+ * links that used to name the index still land.
61
75
  */
62
76
  export function pathForPluginsIndex(): string {
63
77
  return LIBRARY_ROOT;
@@ -143,8 +157,8 @@ export function isLibraryLocation(pathname: string): boolean {
143
157
  return (
144
158
  segments[0] === 'workspace' &&
145
159
  segments[1] === DEFAULT_BRANCH &&
146
- segments[3] === PLUGINS_DIR &&
147
- segments.length >= 6 // workspace/<branch>/<kbDir>/Plugins/<plugin>/<item>
160
+ ((segments[3] === PLUGINS_DIR && segments.length >= 6) || // workspace/<branch>/<kbDir>/Plugins/<plugin>/<item>
161
+ (segments[3] === SKILLS_DIR && segments.length >= 5)) // workspace/<branch>/<kbDir>/Skills/<skill or scope>/…
148
162
  );
149
163
  }
150
164
 
@@ -171,22 +185,6 @@ export function pathForSkill(name: string): string {
171
185
  return `${LIBRARY_ROOT}/skills/${encodeURIComponent(name)}`;
172
186
  }
173
187
 
174
- /**
175
- * Whether a path is the all-plugins index — the one path that lights the "All
176
- * plugins" row. It is not a `LibraryFilter`: the index lists PLACES, not a
177
- * filtered slice of the catalog, which is why selection for it travels beside
178
- * the filter rather than inside it.
179
- *
180
- * `plugins` answers true as well even though it only ever redirects, so the row
181
- * is already lit while the redirect resolves.
182
- */
183
- export function isPluginsIndexPath(pathname: string): boolean {
184
- return (
185
- matchPath({ path: LIBRARY_ROOT, end: true }, pathname) !== null ||
186
- matchPath({ path: `${LIBRARY_ROOT}/plugins`, end: true }, pathname) !== null
187
- );
188
- }
189
-
190
188
  /** A malformed escape is a bad link, not a crash — fall back to the raw segment. */
191
189
  function decodeSegment(raw: string): string {
192
190
  try {
@@ -200,22 +198,35 @@ function decodeSegment(raw: string): string {
200
198
  * Where an item's back link points: the page the item LIVES on.
201
199
  *
202
200
  * `‹ All skills & tools` used to be the one answer, and it stopped being
203
- * true the day the Library's root became the all-plugins index — a skill
201
+ * true the day items got pages of their own to be opened from — a skill
204
202
  * opened from its plugin page went "back" to a page the reader had never
205
203
  * been on. The honest destination is derivable from the path alone: the
206
204
  * plugin page for a grouped item, the personal page for a personal one, and
207
- * the root only for the legacy shapes that live in neither.
205
+ * the root — Everything — for a shared skill that lives in neither.
208
206
  */
209
- export function libraryHomeForItemPath(repoRelativePath: string): {
207
+ export function libraryHomeForItemPath(
208
+ repoRelativePath: string,
209
+ /**
210
+ * The plugin's IDENTITY, resolved by the caller through the catalog. Both
211
+ * `undefined` (not resolved) and `null` (resolved to no plugin) fall back
212
+ * to the folder — a personal shelf is decided by the folder before either.
213
+ */
214
+ pluginName?: string | null,
215
+ /** The label for that identity; identity by default. */
216
+ labelOf: (name: string) => string = (n) => n,
217
+ ): {
210
218
  label: string;
211
219
  path: string;
212
220
  } {
213
- const plugin = pluginOfPath(repoRelativePath);
214
- if (plugin !== null && !isPersonalPluginFolder(plugin)) {
215
- return { label: plugin, path: pathForPlugin(plugin) };
221
+ const folder = pluginOfPath(repoRelativePath);
222
+ // A personal shelf is decided by the FOLDER, whatever identity the caller
223
+ // resolved (a personal item's identity is null: a shelf is not a plugin).
224
+ if (folder !== null && isPersonalPluginFolder(folder)) {
225
+ return { label: PERSONAL_PLUGIN_NAME, path: `${LIBRARY_ROOT}/yours` };
216
226
  }
227
+ const plugin = pluginName ?? folder;
217
228
  if (plugin !== null) {
218
- return { label: 'Yours', path: `${LIBRARY_ROOT}/yours` };
229
+ return { label: labelOf(plugin), path: pathForPlugin(plugin) };
219
230
  }
220
- return { label: 'All skills & tools', path: LIBRARY_ROOT };
231
+ return { label: 'Everything', path: LIBRARY_ROOT };
221
232
  }
@@ -2,11 +2,16 @@ import { DEFAULT_BRANCH, PLUGINS_DIR, type PullRequestSummary } from '@bevel-sof
2
2
  import { authFetch } from '../../../lib/api';
3
3
  import { handleApiResponse } from '../../git/services/git.api';
4
4
  import { createBranch } from '../../git/services/git.api';
5
- import { deleteFile, getOrCreateWorkspace, writeFile } from '../../workspace/services/workspace.api';
5
+ import {
6
+ deleteFile,
7
+ getOrCreateWorkspace,
8
+ writeFile,
9
+ type SkillToolWarning,
10
+ } from '../../workspace/services/workspace.api';
6
11
  import { openChangeRequest } from '../../pr/services/pr-open.api';
7
12
  import { postPrComment } from '../../pr/services/pr-comments.api';
8
13
  import { branchSegment } from '../../change-requests/services/propose.api';
9
- import { ensurePersonalPlugin } from './plugins.api';
14
+ import { ensurePersonalPlugin, type JoinRequest } from './plugins.api';
10
15
 
11
16
  /**
12
17
  * Library data access. Skills come from the browser skill routes
@@ -26,6 +31,18 @@ import { ensurePersonalPlugin } from './plugins.api';
26
31
  */
27
32
  export const defaultWorkspaceId = () => encodeURIComponent(DEFAULT_BRANCH);
28
33
 
34
+ /**
35
+ * One plugin a skill belongs to — inside the plugin folder (`linked: false`)
36
+ * or linked from the plugin's manifest (`linked: true`). `granted` is the
37
+ * link's health: whether the skill's own access rules still name the plugin's
38
+ * `plugin/<Name>/read` principal. Mirrors the backend contract.
39
+ */
40
+ export interface PluginMembership {
41
+ name: string;
42
+ linked: boolean;
43
+ granted: boolean;
44
+ }
45
+
29
46
  export interface LibrarySkillSummary {
30
47
  /** Canonical id = the skill's folder name (e.g. `rfi`). */
31
48
  name: string;
@@ -33,6 +50,44 @@ export interface LibrarySkillSummary {
33
50
  version?: string;
34
51
  /** Repo-root-relative skill folder, e.g. `Plugins/Everyone/rfi`. */
35
52
  path: string;
53
+ /** Every plugin holding this skill. Absent from an older server. */
54
+ plugins?: PluginMembership[];
55
+ }
56
+
57
+ /** The open write-access requests on a skill — `[]` to anyone but its editors. */
58
+ export async function listSkillAccessRequests(name: string): Promise<JoinRequest[]> {
59
+ const data = await handleApiResponse<{ requests: JoinRequest[] }>(
60
+ await authFetch(`/api/skills/${encodeURIComponent(name)}/access-requests`),
61
+ );
62
+ return data.requests;
63
+ }
64
+
65
+ /** Settle one request if every proposal has landed. Returns whether it closed. */
66
+ export async function reconcileSkillAccessRequest(name: string, number: number): Promise<boolean> {
67
+ const data = await handleApiResponse<{ closed: boolean }>(
68
+ await authFetch(`/api/skills/${encodeURIComponent(name)}/access-requests/${number}/reconcile`, {
69
+ method: 'POST',
70
+ }),
71
+ );
72
+ return data.closed;
73
+ }
74
+
75
+ /**
76
+ * Ask the skill's editors for write on it — a change request that proposes
77
+ * the grant, exactly like asking to join a plugin. Idempotent: a second ask
78
+ * returns the open request.
79
+ */
80
+ export async function requestSkillAccess(name: string): Promise<{ number: number }> {
81
+ const res = await authFetch(`/api/skills/${encodeURIComponent(name)}/access-request`, {
82
+ method: 'POST',
83
+ headers: { 'Content-Type': 'application/json' },
84
+ body: JSON.stringify({ verb: 'write' }),
85
+ });
86
+ if (!res.ok) {
87
+ const body = (await res.json().catch(() => ({}))) as { error?: string };
88
+ throw new Error(body.error ?? "Couldn't request access.");
89
+ }
90
+ return (await res.json()) as { number: number };
36
91
  }
37
92
 
38
93
  export interface LibrarySkill extends LibrarySkillSummary {
@@ -41,6 +96,13 @@ export interface LibrarySkill extends LibrarySkillSummary {
41
96
  allowedTools?: string[];
42
97
  /** Repo-root-relative bundled file paths (SKILL.md itself is not listed). */
43
98
  files: string[];
99
+ /**
100
+ * `allowed-tools` entries that look like platform tools but name none the
101
+ * caller can see. Advisory, and about the skill as it reads NOW — so the page
102
+ * can say so on open, before anyone saves. Absent from a backend built before
103
+ * the check existed.
104
+ */
105
+ warnings?: SkillToolWarning[];
44
106
  }
45
107
 
46
108
  /**
@@ -66,7 +128,7 @@ interface SkillFilePayload {
66
128
  }
67
129
 
68
130
  type GetSkillPayload =
69
- | { ok: true; kind: 'skill'; skill: LibrarySkill }
131
+ | { ok: true; kind: 'skill'; skill: LibrarySkill; warnings?: SkillToolWarning[] }
70
132
  | { ok: true; kind: 'file'; file: SkillFilePayload }
71
133
  | { ok: false; error: 'not_found' | 'forbidden' | 'invalid_file' };
72
134
 
@@ -82,7 +144,9 @@ export async function getSkill(name: string): Promise<LibrarySkill> {
82
144
  await authFetch(`/api/skills/${encodeURIComponent(name)}`),
83
145
  );
84
146
  if (!data.ok || data.kind !== 'skill') throw new Error("Couldn't load this skill.");
85
- return data.skill;
147
+ // The warnings ride beside the skill on the wire (as `get_skill` returns
148
+ // them); the page reads one object, so they are folded onto it here.
149
+ return Array.isArray(data.warnings) ? { ...data.skill, warnings: data.warnings } : data.skill;
86
150
  }
87
151
 
88
152
  /**
@@ -148,7 +212,7 @@ export interface ProposeChangeInput {
148
212
  */
149
213
  export async function proposeChange(
150
214
  input: ProposeChangeInput,
151
- ): Promise<{ branch: string; kbDirName: string }> {
215
+ ): Promise<{ branch: string; kbDirName: string; warnings?: SkillToolWarning[] }> {
152
216
  const branch = input.existingCr?.branch ?? suggestionBranchFor(input.userEmail, input.skillName);
153
217
 
154
218
  if (!input.existingCr) {
@@ -161,7 +225,7 @@ export async function proposeChange(
161
225
  }
162
226
 
163
227
  const { workspace } = await getOrCreateWorkspace(branch);
164
- await writeFile(
228
+ const saved = await writeFile(
165
229
  workspace.id,
166
230
  `${workspace.kbDirName}/${input.repoRelativePath}`,
167
231
  input.content,
@@ -179,23 +243,30 @@ export async function proposeChange(
179
243
  description: input.note || undefined,
180
244
  });
181
245
  }
182
- return { branch, kbDirName: workspace.kbDirName };
246
+ return { branch, kbDirName: workspace.kbDirName, ...(saved?.warnings ? { warnings: saved.warnings } : {}) };
183
247
  }
184
248
 
185
249
  /**
186
- * What a brand-new SKILL.md contains: the frontmatter fence, an empty
187
- * `description`, and nothing else.
250
+ * What a brand-new SKILL.md contains: the Agent Skills frontmatter — the
251
+ * skill's `name`, an empty `description` to fill in, and a first
252
+ * `metadata.version` — and nothing else.
188
253
  *
189
254
  * Not zero bytes, and the difference matters. The catalog reads a skill's
190
- * description straight out of this frontmatter (`skills.service.ts`
255
+ * description and version straight out of this frontmatter (`skills.service.ts`
191
256
  * `parseSkillFrontmatter`), so a file with no fence at all lists as a card with
192
257
  * a blank subtitle and no visible hint that a description is a thing it could
193
- * have. The fence is the shape of the thing; the emptiness inside it is the
194
- * point. The skill's NAME is deliberately not written here — identity falls
195
- * back to the folder name, and two places to change a skill's name is one place
196
- * too many.
258
+ * have. The fence is the shape of the thing; the emptiness of `description` is
259
+ * the point. `name` is the folder's name, which is what the catalog would fall
260
+ * back to anyway — written out because the Agent Skills format expects it, and
261
+ * so a copy of the file carried elsewhere still says what it is. `version`
262
+ * starts at `1.0.0`: `get_skill` can load a skill by version, and a skill
263
+ * that never declared one has no history to load by.
197
264
  */
198
- export const EMPTY_SKILL_MD = '---\ndescription:\n---\n\n';
265
+ export function newSkillMarkdown(name: string): string {
266
+ // Quoted: a folder name is free text short of `/` and `\`, and a bare
267
+ // `#draft` or `a: b` would parse as a comment or a nested mapping.
268
+ return `---\nname: ${JSON.stringify(name)}\ndescription:\nmetadata:\n version: "1.0.0"\n---\n\n`;
269
+ }
199
270
 
200
271
  export type CreateSkillInput = {
201
272
  /** The skill's name, which becomes its folder name. */
@@ -251,12 +322,13 @@ export async function createEmptySkill(input: CreateSkillInput): Promise<Created
251
322
  ? `${PLUGINS_DIR}/${(await ensurePersonalPlugin()).folder}`
252
323
  : input.parentPath;
253
324
  const repoRelativePath = `${parentPath}/${input.name}/SKILL.md`;
325
+ const content = newSkillMarkdown(input.name);
254
326
 
255
327
  if (!('personal' in input) && !input.canWrite) {
256
328
  const { branch, kbDirName } = await proposeChange({
257
329
  skillName: input.name,
258
330
  repoRelativePath,
259
- content: EMPTY_SKILL_MD,
331
+ content,
260
332
  userEmail: input.userEmail,
261
333
  userName: input.userName,
262
334
  });
@@ -274,7 +346,7 @@ export async function createEmptySkill(input: CreateSkillInput): Promise<Created
274
346
  // that can be stale, so the backend must be the one to refuse a name that
275
347
  // was claimed since — a plain write here would silently empty the existing
276
348
  // SKILL.md. The 409 surfaces through the panel's normal error toast.
277
- await writeFile(workspace.id, workspacePath, EMPTY_SKILL_MD, { ifAbsent: true });
349
+ await writeFile(workspace.id, workspacePath, content, { ifAbsent: true });
278
350
  return { repoRelativePath, workspacePath, branch: DEFAULT_BRANCH, direct: true };
279
351
  }
280
352
 
@@ -27,10 +27,23 @@ export interface PluginReaders extends PluginPrincipals {
27
27
  }
28
28
 
29
29
  export interface PluginSummary {
30
- /** Plugin folder name, e.g. `GTM`. */
30
+ /** The plugin's identity — its manifest name, e.g. `gtm`. Grants, URLs and the marketplace spell it. */
31
31
  name: string;
32
+ /** What people see it called, e.g. `GTM`. Absent from an older server: show `name`. */
33
+ displayName?: string;
32
34
  /** Repo-relative constituent folders, e.g. `['Plugins/GTM']`. */
33
35
  folders: string[];
36
+ /**
37
+ * Repo-relative roots the plugin LINKS skills from, e.g. `['Skills/Testing']`.
38
+ *
39
+ * What lets the plugin's page tell a card that LIVES here from one it only
40
+ * points at. A skill says so itself (`PluginMembership.linked`); a tool
41
+ * says nothing — a `.tool` beside the skills under a linked root reaches
42
+ * the plugin the same way they do, and only these roots reveal it. Absent
43
+ * from an older server: every tool then reads as inline, which is what the
44
+ * page showed before.
45
+ */
46
+ linkedRoots?: string[];
34
47
  /** Per-caller: can read the folder (membership). Locked === !canRead. */
35
48
  canRead: boolean;
36
49
  /** Per-caller; true ⇒ may manage the plugin's access (admin-rescue applies). */
@@ -41,16 +54,55 @@ export interface PluginSummary {
41
54
  * enforces this same verdict, so it also decides who sees the affordance.
42
55
  */
43
56
  isOwner: boolean;
57
+ /**
58
+ * Whether this platform writes the plugin's links (a native manifest).
59
+ * False for a plugin read from an external format — its links are edited
60
+ * in that repository, and the link endpoints refuse it. Absent from an
61
+ * older server, which knew only managed plugins.
62
+ */
63
+ linksAreManaged?: boolean;
44
64
  /** The plugin's TOTALS, not the caller's slice. */
45
65
  skillCount: number;
46
66
  toolCount: number;
67
+ /**
68
+ * How many of the plugin's linked skills its members cannot read, counted
69
+ * by the server from the unfiltered link index — so a manager the missing
70
+ * grant locks out of the skill still sees the count. Absent from an older
71
+ * server: fall back to what the caller's own catalog shows.
72
+ */
73
+ brokenLinks?: number;
47
74
  owners: PluginPrincipals;
48
75
  writers: PluginPrincipals;
49
76
  readers: PluginReaders;
50
- /** The caller has an OPEN join change request for this plugin. */
77
+ /**
78
+ * The plugin's access.md says of itself that it is private: its
79
+ * frontmatter denies `everyone` and names nobody but people — a personal
80
+ * space's shape, or a plugin kept to a few named colleagues. Shown as a
81
+ * "Private" mark on the row. Absent from an older server.
82
+ */
83
+ isPrivate?: boolean;
84
+ /**
85
+ * What the platform left out of this plugin's definition and why, in
86
+ * plain words — an MCP server its profile selects that could not be kept,
87
+ * a skill root that is not a folder. Shown on the plugin's page, counted
88
+ * as attention on its row. Absent from an older server.
89
+ */
90
+ warnings?: string[];
91
+ /**
92
+ * The caller has asked to join this plugin — true from the moment the
93
+ * server records the ask, which is before the change request that carries
94
+ * it exists. That is what keeps the "Requested" card on the page through a
95
+ * reload while the server is still doing the git work.
96
+ */
51
97
  hasRequested: boolean;
52
- /** That CR's number when `hasRequested` (deep-links the review UI). */
98
+ /** The join CR's number once it exists (deep-links the review UI); null before that. */
53
99
  requestNumber: number | null;
100
+ /**
101
+ * Why the recorded request could not be sent, in the server's words — set
102
+ * only when `hasRequested` is false because it failed. Absent from an older
103
+ * server, and absent whenever there is nothing to say.
104
+ */
105
+ requestFailure?: string | null;
54
106
  }
55
107
 
56
108
  export async function listPlugins(): Promise<PluginSummary[]> {
@@ -67,17 +119,50 @@ export async function listPlugins(): Promise<PluginSummary[]> {
67
119
  * seeded `access.md` before answering, and refuses with its own words —
68
120
  * worth surfacing verbatim.
69
121
  */
70
- export async function createPlugin(name: string): Promise<{ folder: string }> {
122
+ /**
123
+ * Make a plugin. `parent` is a grouping folder below the plugins root to
124
+ * make it in (`Teams`, `Teams/EU`); omitted or empty, it goes at the root.
125
+ * The server owns every rule about where a plugin may go.
126
+ *
127
+ * The answer carries both names as the manifest now holds them: the identity
128
+ * the endpoint derived, and the display name — the typed name, trimmed —
129
+ * that was written into the file.
130
+ */
131
+ export async function createPlugin(
132
+ name: string,
133
+ parent = '',
134
+ ): Promise<{ folder: string; name: string; displayName: string }> {
71
135
  const res = await authFetch('/api/plugins', {
72
136
  method: 'POST',
73
137
  headers: { 'Content-Type': 'application/json' },
74
- body: JSON.stringify({ name }),
138
+ body: JSON.stringify(parent ? { name, parent } : { name }),
75
139
  });
76
140
  if (!res.ok) {
77
141
  const body = (await res.json().catch(() => ({}))) as { error?: string };
78
142
  throw new Error(body.error ?? "Couldn't create that plugin.");
79
143
  }
80
- return (await res.json()) as { folder: string };
144
+ return (await res.json()) as { folder: string; name: string; displayName: string };
145
+ }
146
+
147
+ /**
148
+ * Rename a plugin: its identifier (which rewrites every grant naming it),
149
+ * its display name, or both. The refusal's message names the reason — a
150
+ * taken name, a bad identifier, files the caller cannot edit.
151
+ */
152
+ export async function renamePlugin(
153
+ name: string,
154
+ patch: { name?: string; displayName?: string },
155
+ ): Promise<{ name: string; displayName: string; rewritten: string[] }> {
156
+ const res = await authFetch(`/api/plugins/${encodeURIComponent(name)}`, {
157
+ method: 'PATCH',
158
+ headers: { 'Content-Type': 'application/json' },
159
+ body: JSON.stringify(patch),
160
+ });
161
+ if (!res.ok) {
162
+ const body = (await res.json().catch(() => ({}))) as { error?: string };
163
+ throw new Error(body.error ?? "Couldn't rename the plugin.");
164
+ }
165
+ return (await res.json()) as { name: string; displayName: string; rewritten: string[] };
81
166
  }
82
167
 
83
168
  /**
@@ -108,6 +193,60 @@ export async function ensurePersonalPlugin(): Promise<{ folder: string; created:
108
193
  return (await res.json()) as { folder: string; created: boolean };
109
194
  }
110
195
 
196
+ /**
197
+ * Thrown when linking is refused because the caller may edit the plugin but
198
+ * not the skill's access rules — the link would share nothing. The UI turns
199
+ * this into "request write access".
200
+ */
201
+ export class NeedsSkillWriteError extends Error {
202
+ readonly root: string;
203
+ constructor(root: string) {
204
+ super("You can't change who may read this skill yet.");
205
+ this.name = 'NeedsSkillWriteError';
206
+ this.root = root;
207
+ }
208
+ }
209
+
210
+ async function linkCall(url: string, init: RequestInit): Promise<Record<string, unknown>> {
211
+ const res = await authFetch(url, init);
212
+ const body = (await res.json().catch(() => ({}))) as { error?: string; kind?: string; root?: string };
213
+ if (!res.ok) {
214
+ if (body.kind === 'needs-skill-write') throw new NeedsSkillWriteError(body.root ?? '');
215
+ throw new Error(body.error ?? "Couldn't update the plugin's links.");
216
+ }
217
+ return body;
218
+ }
219
+
220
+ /**
221
+ * Link a skill (or a folder of skills) into a plugin: the path goes into the
222
+ * plugin's manifest and the skill's rules grant the plugin's principals. Needs
223
+ * write on both sides — see `NeedsSkillWriteError`.
224
+ */
225
+ export async function linkSkill(plugin: string, skillPath: string): Promise<{ root: string; skills: string[] }> {
226
+ return (await linkCall(`/api/plugins/${encodeURIComponent(plugin)}/links`, {
227
+ method: 'POST',
228
+ headers: { 'Content-Type': 'application/json' },
229
+ body: JSON.stringify({ skillPath }),
230
+ })) as { root: string; skills: string[] };
231
+ }
232
+
233
+ /** Remove a link. `revoked` says whether the plugin's grant on the skill went with it. */
234
+ export async function unlinkSkill(plugin: string, skillPath: string): Promise<{ root: string; revoked: boolean }> {
235
+ return (await linkCall(
236
+ `/api/plugins/${encodeURIComponent(plugin)}/links?skillPath=${encodeURIComponent(skillPath)}`,
237
+ { method: 'DELETE' },
238
+ )) as { root: string; revoked: boolean };
239
+ }
240
+
241
+ /** Re-grant the plugin's principals on a linked skill whose grant was hand-removed. */
242
+ export async function repairSkillLink(plugin: string, skillPath: string): Promise<void> {
243
+ await linkCall(`/api/plugins/${encodeURIComponent(plugin)}/links/repair`, {
244
+ method: 'POST',
245
+ headers: { 'Content-Type': 'application/json' },
246
+ body: JSON.stringify({ skillPath }),
247
+ });
248
+ }
249
+
111
250
  /**
112
251
  * Thrown when a join request is refused because access already landed —
113
252
  * between the page load and the click. Not an error to show: the right
@@ -120,8 +259,21 @@ export class AlreadyReadableError extends Error {
120
259
  }
121
260
  }
122
261
 
123
- /** Open (or return the existing) join change request. Idempotent server-side. */
124
- export async function requestPluginAccess(name: string): Promise<{ number: number }> {
262
+ /**
263
+ * Ask to join a plugin. The server RECORDS the ask and answers — the branch,
264
+ * the clone, the grant commit, the push and the change request happen after,
265
+ * so this resolves in a round-trip rather than in however long a first clone
266
+ * takes. `state` says which: `pending` while the git work is still to come,
267
+ * `opened` when the change request already exists (a second click, a retry
268
+ * the server had already finished), in which case `number` is that request's.
269
+ *
270
+ * Idempotent server-side, and by the recorded request rather than by the
271
+ * branch: two tabs or two clicks record one request and open one change
272
+ * request, and a click after a failure continues the recorded one.
273
+ */
274
+ export async function requestPluginAccess(
275
+ name: string,
276
+ ): Promise<{ state: 'pending' | 'opened'; number: number | null }> {
125
277
  const res = await authFetch(`/api/plugins/${encodeURIComponent(name)}/join-request`, {
126
278
  method: 'POST',
127
279
  });
@@ -134,7 +286,7 @@ export async function requestPluginAccess(name: string): Promise<{ number: numbe
134
286
  .catch(() => ({}))) as { kind?: string };
135
287
  if (body.kind === 'already-readable') throw new AlreadyReadableError();
136
288
  }
137
- return handleApiResponse<{ ok: true; number: number }>(res);
289
+ return handleApiResponse<{ ok: true; state: 'pending' | 'opened'; number: number | null }>(res);
138
290
  }
139
291
 
140
292
  /**
@@ -0,0 +1,15 @@
1
+ import { authFetch } from '../../../lib/api';
2
+ import { handleApiResponse } from '../../git/services/git.api';
3
+ import type { TeamAccess } from '../utils/status';
4
+
5
+ export type { TeamAccess } from '../utils/status';
6
+
7
+ /**
8
+ * What each team can use — `GET /api/teams`, one entry per group of the
9
+ * active group source, sliced to what the caller already sees. Ids only;
10
+ * the Library joins them onto its own catalog.
11
+ */
12
+ export async function listTeams(): Promise<TeamAccess[]> {
13
+ const data = await handleApiResponse<{ teams: TeamAccess[] }>(await authFetch('/api/teams'));
14
+ return data.teams;
15
+ }