@bevel-software/platform-core-frontend 0.15.1 → 0.20.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 (347) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +20 -9
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/events.test.ts +43 -0
  6. package/src/core/bootstrap.ts +11 -3
  7. package/src/core/events.ts +85 -3
  8. package/src/core/registry.ts +1 -1
  9. package/src/lib/__tests__/email.test.ts +44 -0
  10. package/src/lib/email.ts +37 -1
  11. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  12. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  16. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  20. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +721 -126
  21. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  22. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  23. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  24. package/src/modules/access/api.ts +140 -6
  25. package/src/modules/access/components/ManageAccessDialog.tsx +1299 -561
  26. package/src/modules/access/manage-access-affordance.ts +17 -0
  27. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  28. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  29. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  30. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  31. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  32. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  33. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  34. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  35. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  36. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  37. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  38. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  39. package/src/modules/admin/components/group-members-path.ts +32 -0
  40. package/src/modules/admin/services/roles.api.ts +12 -1
  41. package/src/modules/audit/__tests__/AuditLogPage.test.tsx +312 -0
  42. package/src/modules/audit/components/AuditEventsPanel.tsx +319 -0
  43. package/src/modules/audit/components/AuditLogPage.tsx +373 -0
  44. package/src/modules/audit/components/principal-grouping.ts +49 -0
  45. package/src/modules/audit/services/audit.api.ts +98 -0
  46. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  47. package/src/modules/auth/components/AccountPage.tsx +73 -54
  48. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  49. package/src/modules/auth/services/account.api.ts +78 -4
  50. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  51. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  52. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  53. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  57. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  58. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  59. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  60. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  61. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  62. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  63. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  64. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  65. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  66. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  67. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  68. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  69. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  70. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  71. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  72. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  73. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  74. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  75. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  76. package/src/modules/change-requests/services/propose.api.ts +97 -8
  77. package/src/modules/change-requests/utils/approval.ts +15 -0
  78. package/src/modules/change-requests/utils/author.ts +32 -0
  79. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  80. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  81. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  82. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  83. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  84. package/src/modules/git/services/error-messages.ts +12 -0
  85. package/src/modules/git/services/pr-prompts.ts +5 -5
  86. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  87. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  88. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  89. package/src/modules/layout/components/AppLayout.tsx +2 -0
  90. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  91. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  92. package/src/modules/layout/components/SidebarFrame.tsx +108 -3
  93. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  94. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  95. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  96. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  97. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  98. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
  99. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
  100. package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
  101. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
  102. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  103. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  104. package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
  105. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  106. package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
  107. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
  108. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
  109. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  110. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  111. package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
  112. package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
  113. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  114. package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
  115. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
  116. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  117. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  118. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  119. package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
  120. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  121. package/src/modules/library/__tests__/library-paths.test.ts +47 -4
  122. package/src/modules/library/__tests__/link-membership.test.ts +13 -4
  123. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  124. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  125. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  126. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  127. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  128. package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
  129. package/src/modules/library/__tests__/status.test.ts +82 -2
  130. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  131. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  132. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  133. package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
  134. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  135. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  136. package/src/modules/library/components/LibraryCard.tsx +146 -45
  137. package/src/modules/library/components/LibraryLayout.tsx +119 -256
  138. package/src/modules/library/components/LibraryPage.tsx +172 -39
  139. package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
  140. package/src/modules/library/components/LockedPluginView.tsx +62 -34
  141. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  142. package/src/modules/library/components/NewPluginDialog.tsx +16 -2
  143. package/src/modules/library/components/PageActions.tsx +11 -9
  144. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  145. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  146. package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
  147. package/src/modules/library/components/PluginExtras.tsx +140 -17
  148. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  149. package/src/modules/library/components/PluginPage.tsx +157 -41
  150. package/src/modules/library/components/PluginRows.tsx +286 -0
  151. package/src/modules/library/components/PluginsSidebar.tsx +239 -263
  152. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  153. package/src/modules/library/components/ShareButton.tsx +17 -0
  154. package/src/modules/library/components/SkillsTree.tsx +141 -28
  155. package/src/modules/library/components/TeamRoute.tsx +15 -0
  156. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  157. package/src/modules/library/components/plugin-page-parts.tsx +103 -17
  158. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
  159. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  160. package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
  161. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  162. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  163. package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
  164. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  165. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  166. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  167. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  168. package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
  169. package/src/modules/library/routes/library-paths.ts +26 -28
  170. package/src/modules/library/services/library.api.ts +38 -20
  171. package/src/modules/library/services/plugins.api.ts +69 -8
  172. package/src/modules/library/services/teams.api.ts +15 -0
  173. package/src/modules/library/services/tools.api.ts +78 -0
  174. package/src/modules/library/state/library-data.tsx +170 -32
  175. package/src/modules/library/utils/personal-plugin.ts +13 -15
  176. package/src/modules/library/utils/plugin-entries.ts +134 -0
  177. package/src/modules/library/utils/plugin-summary.ts +75 -9
  178. package/src/modules/library/utils/status.ts +135 -33
  179. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
  180. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  181. package/src/modules/onboarding/agent-clients.ts +55 -23
  182. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  183. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  184. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  185. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  186. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  187. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  188. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  189. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  190. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  191. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  192. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  193. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  194. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  195. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  196. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  197. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  198. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  199. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  200. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  201. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  202. package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
  203. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  204. package/src/modules/settings/components/DeploymentPage.tsx +10 -30
  205. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  206. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
  207. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  208. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +7 -6
  209. package/src/modules/settings/services/github-facade.api.ts +23 -0
  210. package/src/modules/settings/settings-nav-items.tsx +13 -3
  211. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  212. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  213. package/src/modules/setup/__tests__/setup.test.tsx +497 -4
  214. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  215. package/src/modules/setup/components/SetupGate.tsx +16 -16
  216. package/src/modules/setup/components/SetupScreen.tsx +532 -43
  217. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  218. package/src/modules/setup/services/setup.api.ts +141 -4
  219. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  220. package/src/modules/setup/utils/root-folders.ts +46 -0
  221. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  222. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  223. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  224. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  225. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  226. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  227. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  228. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  229. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  230. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  231. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  232. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  233. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  234. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  235. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  236. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  237. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
  238. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  239. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  240. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  241. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
  242. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  243. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  244. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  245. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  246. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  247. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  248. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  249. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  250. package/src/modules/toolbar/services/external-api-keys.api.ts +8 -0
  251. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  252. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  253. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  254. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  255. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  256. package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
  257. package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
  258. package/src/modules/workspace/components/FileRoute.tsx +353 -36
  259. package/src/modules/workspace/components/FileViewer.tsx +172 -46
  260. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  261. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  262. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  263. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2533 -129
  264. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
  265. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +381 -12
  266. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  267. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  268. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  269. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  270. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  271. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  272. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  273. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  274. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  275. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  276. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  277. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  278. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  279. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  280. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  281. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  282. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  283. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  284. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  285. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  286. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  287. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  288. package/src/modules/workspace/components/renderers/index.ts +53 -2
  289. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  290. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  291. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  292. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  293. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  294. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  295. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  296. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
  297. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  298. package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
  299. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  300. package/src/modules/workspace/routing/kb-routes.ts +206 -29
  301. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +134 -1
  302. package/src/modules/workspace/services/workspace.api.ts +57 -4
  303. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  304. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  305. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  306. package/src/modules/workspace/state/workspace.context.ts +125 -19
  307. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  308. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
  309. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  310. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  311. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  312. package/src/modules/workspace/utils/file-trace.ts +50 -0
  313. package/src/modules/workspace/utils/fileTree.ts +112 -36
  314. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  315. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  316. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  317. package/src/modules/workspace/utils/uploadError.ts +29 -0
  318. package/src/shared/__tests__/marketplace-url.test.ts +6 -1
  319. package/src/shared/components/Button.tsx +16 -2
  320. package/src/shared/components/Dialog.tsx +27 -11
  321. package/src/shared/components/Menu.tsx +13 -1
  322. package/src/shared/components/PageShell.tsx +13 -8
  323. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  324. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  325. package/src/shared/components/index.ts +2 -0
  326. package/src/shared/components/useDismissableMenu.ts +32 -10
  327. package/src/shared/components/useFocusHandoff.ts +51 -0
  328. package/src/shared/components/useLatestRef.ts +28 -0
  329. package/src/shared/markdown/Markdown.tsx +12 -3
  330. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  331. package/src/shared/markdown/hrefs.ts +50 -0
  332. package/src/shared/marketplace-url.ts +33 -5
  333. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  334. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  335. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  336. package/src/shared/mcp/connect-snippets.ts +14 -9
  337. package/src/shared/mcp/index.ts +1 -1
  338. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  339. package/src/shared/theme/header.ts +75 -0
  340. package/src/shared/theme/measure.ts +7 -4
  341. package/src/shared/theme/tokens.css +25 -0
  342. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  343. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  344. package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
  345. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  346. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  347. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -5,8 +5,8 @@ import { useWorkspace } from '../../workspace/state/workspace.context';
5
5
  import { LibraryLayout } from '../components/LibraryLayout';
6
6
  import { LibraryPage } from '../components/LibraryPage';
7
7
  import { PluginPage } from '../components/PluginPage';
8
- import { PluginsIndexPage } from '../components/PluginsIndexPage';
9
8
  import { PersonalPluginPage } from '../components/PersonalPluginPage';
9
+ import { TeamRoute } from '../components/TeamRoute';
10
10
  import { WelcomeRoute } from '../../onboarding/components/WelcomeRoute';
11
11
  import { WorkspaceItemRoute } from './WorkspaceItemRoute';
12
12
  import { decodePluginSegment, LIBRARY_ROOT, pathForPlugin, urlForLibraryItem, urlForSkillFile } from './library-paths';
@@ -32,14 +32,17 @@ export function LibraryRoutes() {
32
32
  <LibraryProvider>
33
33
  <Routes>
34
34
  <Route element={<LibraryLayout />}>
35
- {/* The Library OPENS on its plugins. A plugin is where skills and
36
- tools live and who they are for, so the index of them is the
37
- orienting view; the undifferentiated card grid is a lens on
38
- the same catalog and keeps its own row and URL below. */}
39
- <Route index element={<PluginsIndexPage />} />
35
+ {/* The Library OPENS on Everything: plugins, skills and tools, the
36
+ whole catalog with the library-wide search. `everything` is
37
+ the same page at the URL it used to have, so older links
38
+ still land. */}
39
+ <Route index element={<LibraryPage filter={{ kind: 'all' }} />} />
40
+ <Route path="everything" element={<Navigate to={LIBRARY_ROOT} replace />} />
40
41
 
41
- {/* The whole catalog as cards, with the library-wide search. */}
42
- <Route path="everything" element={<LibraryPage filter={{ kind: 'all' }} />} />
42
+ {/* A team's lens — what one group from the access rules can use.
43
+ The name is a route param; the page decides whether the
44
+ team is known. */}
45
+ <Route path="teams/:group" element={<TeamRoute />} />
43
46
 
44
47
  {/* The connect-your-agent welcome — inside the layout, so the
45
48
  sidebar (and the pill's selected state) is on screen with it.
@@ -50,9 +53,9 @@ export function LibraryRoutes() {
50
53
  <Route path="owned" element={<LibraryPage filter={{ kind: 'owned' }} />} />
51
54
 
52
55
  {/* `yours` is a PLUGIN page, not a gallery filter — the items in no
53
- folder, given the same page the folders get. The sidebar still
54
- lights it through the `ungrouped` filter, so the URL and the
55
- selection stay the pair they were. */}
56
+ folder, given the same page the folders get. It has no nav row
57
+ (your own space is not a group); it is reached from its row on
58
+ Everything, the welcome page and by URL. */}
56
59
  <Route path="yours" element={<PersonalPluginPage />} />
57
60
 
58
61
  {/* A plugin is a PLACE: `plugins/:plugin` is a real page with a real
@@ -1,8 +1,11 @@
1
- import { Navigate, useLocation, useParams, useSearchParams } from 'react-router-dom';
1
+ import { Link, Navigate, useLocation, useParams, useSearchParams } from 'react-router-dom';
2
2
  import { DEFAULT_BRANCH, PLUGINS_DIR, SKILLS_DIR, type FileTreeEntry } from '@bevel-software/platform-shared';
3
3
  import { useWorkspace } from '../../workspace/state/workspace.context';
4
4
  import { safeDecode } from '../../workspace/routing/kb-routes';
5
5
  import { useLibrary } from '../state/library-data';
6
+ import type { PluginSummary } from '../services/plugins.api';
7
+ import { pluginHoldingPath } from '../utils/plugin-summary';
8
+ import { FileRoute } from '../../workspace/components/FileRoute';
6
9
  import { SkillPage } from '../components/skill-page/SkillPage';
7
10
  import { ToolPage } from '../components/tool-page/ToolPage';
8
11
  import { LIBRARY_ROOT, pathForPlugin } from './library-paths';
@@ -24,10 +27,23 @@ import { LIBRARY_ROOT, pathForPlugin } from './library-paths';
24
27
  * itself. Waiting on the catalog here raced every reload and lost (the
25
28
  * just-created skill bounced to its plugin's page).
26
29
  *
27
- * The two roots differ only in where a path that is NO skill goes: a
28
- * container folder or a loose file belongs to its plugin page under
29
- * `Plugins/`; under `Skills/` a scope folder has no page (home) and a loose
30
- * file opens as the plain file it is.
30
+ * The two roots differ only in where a FOLDER that is no skill goes: a
31
+ * container belongs to its plugin page under `Plugins/`; under `Skills/` a
32
+ * scope folder has no page (home). A loose FILE — a folder's `access.md`,
33
+ * a plugin's `plugin.json`, a stray upload — opens as the plain file it is
34
+ * under either root, HERE, inside this app: the same `FileRoute` Knowledge
35
+ * renders, in the Library's own frame. Which app a file opens in follows
36
+ * the folder it is in — the two roots ARE the two apps — never the viewer it
37
+ * needs, so a person reading a plugin's manifest keeps the Skills & Tools nav
38
+ * and switcher around it. (The plugin page was never the file either: it
39
+ * keys on the plugin's identity, which a folder name need not be — a
40
+ * personal space, a folder spelled unlike its manifest — so the old bounce
41
+ * there landed on "doesn't exist" for a file plainly present.)
42
+ *
43
+ * Router state `rawFile` asks for that raw view OUTRIGHT, whatever the URL
44
+ * would otherwise resolve to — the tool page's "Edit the tool file", the
45
+ * plugin page's manifest button. State, not URL: a shared link never carries
46
+ * it, so nobody lands on the editor by accident.
31
47
  *
32
48
  * The catalog is consulted only to REFINE a tool's slug (a `.tool` may
33
49
  * declare an explicit id different from its filename); the filename is the
@@ -55,6 +71,33 @@ export function WorkspaceItemRoute() {
55
71
  return <Navigate to={LIBRARY_ROOT} replace />;
56
72
  }
57
73
 
74
+ /**
75
+ * The Knowledge file route, in this frame. `canonicalize` is OFF: its id
76
+ * redirect would send an id-bearing file (a `.tool`, a note with an `id`)
77
+ * to an id URL, which is no library location — and the surface would
78
+ * switch to Knowledge after all. The path URL is the one the tree gave.
79
+ *
80
+ * Above it, when the file sits inside a listed plugin, one line says which
81
+ * plugin and links to its page: a manifest or an access.md opens as the
82
+ * file it is (routing the manifest to the page instead proved unreliable),
83
+ * and the page is one click away for whoever wanted it.
84
+ */
85
+ const fileView = () => (
86
+ <>
87
+ {/* Only from a SETTLED list: while it is (re)loading the summaries on
88
+ hand may be the previous list's, and a plugin whose identity just
89
+ changed would be linked by its old name. The file itself waits for
90
+ nothing. */}
91
+ <PluginFileNote
92
+ plugin={data.pluginsLoading ? null : pluginHoldingPath(segments.slice(1).join('/'), data.pluginSummaries)}
93
+ />
94
+ <FileRoute canonicalize={false} />
95
+ </>
96
+ );
97
+
98
+ // Asked for the raw file by name: no resolution, the editor it is.
99
+ if ((location.state as { rawFile?: boolean } | null)?.rawFile === true) return fileView();
100
+
58
101
  /**
59
102
  * `key={name}` is load-bearing. A provisional name gets CORRECTED once the
60
103
  * catalog lands (folder name → declared id), and without a remount the page
@@ -66,6 +109,13 @@ export function WorkspaceItemRoute() {
66
109
  <SkillPage key={name} name={name} activeFile={activeFile} provisional={provisional} />
67
110
  );
68
111
 
112
+ /**
113
+ * A loose file (a folder's access.md, a plugin's manifest, a stray note)
114
+ * opens as the plain file it is — the Knowledge file route, rendered right
115
+ * here in the Library's column, same URL, same viewer, this app's frame.
116
+ */
117
+ const rawFileView = fileView;
118
+
69
119
  if (kbRoot === SKILLS_DIR) {
70
120
  const rest = segments.slice(2);
71
121
  const resolved = resolveSkillPath(data, `${SKILLS_DIR}/${rest.join('/')}`, rest, null, witness);
@@ -77,24 +127,8 @@ export function WorkspaceItemRoute() {
77
127
  case 'container':
78
128
  // A scope has no page of its own — the sidebar's tree is where it is browsed.
79
129
  return <Navigate to={LIBRARY_ROOT} replace />;
80
- case 'loose-file': {
81
- // A file filed directly in a scope (its access.md, a stray note)
82
- // opens as the plain file it is, in the pane workspace. Router STATE,
83
- // not a different URL: the shell reads `rawFile` to step past the
84
- // shape rule, and a shared link can never carry state — so nobody
85
- // lands on the raw view by accident. Once asked, hold still: the
86
- // shell is swapping surfaces on that state, and asking again from
87
- // here would be a navigation loop.
88
- const rawRequested = (location.state as { rawFile?: boolean } | null)?.rawFile === true;
89
- if (rawRequested) return null;
90
- return (
91
- <Navigate
92
- to={`${location.pathname}${location.search}${location.hash}`}
93
- state={{ rawFile: true }}
94
- replace
95
- />
96
- );
97
- }
130
+ case 'loose-file':
131
+ return rawFileView();
98
132
  }
99
133
  }
100
134
 
@@ -150,11 +184,12 @@ export function WorkspaceItemRoute() {
150
184
  case 'wait':
151
185
  return null;
152
186
  case 'container':
153
- case 'loose-file':
154
- // A category has no page of its own; its plugin does. A file that can
155
- // be no skill's — `access.md` at either level, a stray upload — is the
156
- // plugin's business too.
187
+ // A category has no page of its own; its plugin does.
157
188
  return <Navigate to={pathForPlugin(plugin)} replace />;
189
+ case 'loose-file':
190
+ // A file that can be no skill's — `access.md` at either level, the
191
+ // manifest, a stray upload — is shown as the file it is.
192
+ return rawFileView();
158
193
  }
159
194
  }
160
195
 
@@ -269,6 +304,21 @@ function folderHasSkillMd(tree: FileTreeEntry | null, workspaceRel: string | nul
269
304
  return (folder.children ?? []).some((c) => c.type === 'file' && c.name === 'SKILL.md');
270
305
  }
271
306
 
307
+ /** One line above a file that sits inside a plugin: which plugin, and the way to its page. */
308
+ function PluginFileNote({ plugin }: { plugin: PluginSummary | null }) {
309
+ if (!plugin) return null;
310
+ return (
311
+ <p className="mb-3 flex flex-wrap items-center gap-x-2 text-detail text-ink-muted">
312
+ <span>
313
+ Part of the <span className="font-medium text-ink">{plugin.displayName ?? plugin.name}</span> plugin.
314
+ </span>
315
+ <Link to={pathForPlugin(plugin.name)} className="font-medium text-ink underline underline-offset-2">
316
+ Open plugin
317
+ </Link>
318
+ </p>
319
+ );
320
+ }
321
+
272
322
  /** Whether a path segment names a file rather than a folder. */
273
323
  function hasExtension(segment: string): boolean {
274
324
  return /\.[a-z0-9]+$/i.test(segment);
@@ -2,6 +2,7 @@ import { DEFAULT_BRANCH, PLUGINS_DIR, SKILLS_DIR, pluginOfPath, isPersonalPlugin
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;
@@ -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,11 +198,11 @@ 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
207
  export function libraryHomeForItemPath(
210
208
  repoRelativePath: string,
@@ -224,11 +222,11 @@ export function libraryHomeForItemPath(
224
222
  // A personal shelf is decided by the FOLDER, whatever identity the caller
225
223
  // resolved (a personal item's identity is null: a shelf is not a plugin).
226
224
  if (folder !== null && isPersonalPluginFolder(folder)) {
227
- return { label: 'Yours', path: `${LIBRARY_ROOT}/yours` };
225
+ return { label: PERSONAL_PLUGIN_NAME, path: `${LIBRARY_ROOT}/yours` };
228
226
  }
229
227
  const plugin = pluginName ?? folder;
230
228
  if (plugin !== null) {
231
229
  return { label: labelOf(plugin), path: pathForPlugin(plugin) };
232
230
  }
233
- return { label: 'All skills & tools', path: LIBRARY_ROOT };
231
+ return { label: 'Everything', path: LIBRARY_ROOT };
234
232
  }
@@ -2,7 +2,12 @@ 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';
@@ -47,10 +52,6 @@ export interface LibrarySkillSummary {
47
52
  path: string;
48
53
  /** Every plugin holding this skill. Absent from an older server. */
49
54
  plugins?: PluginMembership[];
50
- /** The governance owner (`metadata.owner`), when declared. */
51
- owner?: string;
52
- /** The governance lifecycle (`metadata.lifecycle`), lowercased: `active`, `deprecated`, `retired`. */
53
- lifecycle?: string;
54
55
  }
55
56
 
56
57
  /** The open write-access requests on a skill — `[]` to anyone but its editors. */
@@ -95,6 +96,13 @@ export interface LibrarySkill extends LibrarySkillSummary {
95
96
  allowedTools?: string[];
96
97
  /** Repo-root-relative bundled file paths (SKILL.md itself is not listed). */
97
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[];
98
106
  }
99
107
 
100
108
  /**
@@ -120,7 +128,7 @@ interface SkillFilePayload {
120
128
  }
121
129
 
122
130
  type GetSkillPayload =
123
- | { ok: true; kind: 'skill'; skill: LibrarySkill }
131
+ | { ok: true; kind: 'skill'; skill: LibrarySkill; warnings?: SkillToolWarning[] }
124
132
  | { ok: true; kind: 'file'; file: SkillFilePayload }
125
133
  | { ok: false; error: 'not_found' | 'forbidden' | 'invalid_file' };
126
134
 
@@ -136,7 +144,9 @@ export async function getSkill(name: string): Promise<LibrarySkill> {
136
144
  await authFetch(`/api/skills/${encodeURIComponent(name)}`),
137
145
  );
138
146
  if (!data.ok || data.kind !== 'skill') throw new Error("Couldn't load this skill.");
139
- 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;
140
150
  }
141
151
 
142
152
  /**
@@ -202,7 +212,7 @@ export interface ProposeChangeInput {
202
212
  */
203
213
  export async function proposeChange(
204
214
  input: ProposeChangeInput,
205
- ): Promise<{ branch: string; kbDirName: string }> {
215
+ ): Promise<{ branch: string; kbDirName: string; warnings?: SkillToolWarning[] }> {
206
216
  const branch = input.existingCr?.branch ?? suggestionBranchFor(input.userEmail, input.skillName);
207
217
 
208
218
  if (!input.existingCr) {
@@ -215,7 +225,7 @@ export async function proposeChange(
215
225
  }
216
226
 
217
227
  const { workspace } = await getOrCreateWorkspace(branch);
218
- await writeFile(
228
+ const saved = await writeFile(
219
229
  workspace.id,
220
230
  `${workspace.kbDirName}/${input.repoRelativePath}`,
221
231
  input.content,
@@ -233,23 +243,30 @@ export async function proposeChange(
233
243
  description: input.note || undefined,
234
244
  });
235
245
  }
236
- return { branch, kbDirName: workspace.kbDirName };
246
+ return { branch, kbDirName: workspace.kbDirName, ...(saved?.warnings ? { warnings: saved.warnings } : {}) };
237
247
  }
238
248
 
239
249
  /**
240
- * What a brand-new SKILL.md contains: the frontmatter fence, an empty
241
- * `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.
242
253
  *
243
254
  * Not zero bytes, and the difference matters. The catalog reads a skill's
244
- * description straight out of this frontmatter (`skills.service.ts`
255
+ * description and version straight out of this frontmatter (`skills.service.ts`
245
256
  * `parseSkillFrontmatter`), so a file with no fence at all lists as a card with
246
257
  * a blank subtitle and no visible hint that a description is a thing it could
247
- * have. The fence is the shape of the thing; the emptiness inside it is the
248
- * point. The skill's NAME is deliberately not written here — identity falls
249
- * back to the folder name, and two places to change a skill's name is one place
250
- * 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.
251
264
  */
252
- 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
+ }
253
270
 
254
271
  export type CreateSkillInput = {
255
272
  /** The skill's name, which becomes its folder name. */
@@ -305,12 +322,13 @@ export async function createEmptySkill(input: CreateSkillInput): Promise<Created
305
322
  ? `${PLUGINS_DIR}/${(await ensurePersonalPlugin()).folder}`
306
323
  : input.parentPath;
307
324
  const repoRelativePath = `${parentPath}/${input.name}/SKILL.md`;
325
+ const content = newSkillMarkdown(input.name);
308
326
 
309
327
  if (!('personal' in input) && !input.canWrite) {
310
328
  const { branch, kbDirName } = await proposeChange({
311
329
  skillName: input.name,
312
330
  repoRelativePath,
313
- content: EMPTY_SKILL_MD,
331
+ content,
314
332
  userEmail: input.userEmail,
315
333
  userName: input.userName,
316
334
  });
@@ -328,7 +346,7 @@ export async function createEmptySkill(input: CreateSkillInput): Promise<Created
328
346
  // that can be stale, so the backend must be the one to refuse a name that
329
347
  // was claimed since — a plain write here would silently empty the existing
330
348
  // SKILL.md. The 409 surfaces through the panel's normal error toast.
331
- await writeFile(workspace.id, workspacePath, EMPTY_SKILL_MD, { ifAbsent: true });
349
+ await writeFile(workspace.id, workspacePath, content, { ifAbsent: true });
332
350
  return { repoRelativePath, workspacePath, branch: DEFAULT_BRANCH, direct: true };
333
351
  }
334
352
 
@@ -33,6 +33,17 @@ export interface PluginSummary {
33
33
  displayName?: string;
34
34
  /** Repo-relative constituent folders, e.g. `['Plugins/GTM']`. */
35
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[];
36
47
  /** Per-caller: can read the folder (membership). Locked === !canRead. */
37
48
  canRead: boolean;
38
49
  /** Per-caller; true ⇒ may manage the plugin's access (admin-rescue applies). */
@@ -63,10 +74,35 @@ export interface PluginSummary {
63
74
  owners: PluginPrincipals;
64
75
  writers: PluginPrincipals;
65
76
  readers: PluginReaders;
66
- /** 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
+ */
67
97
  hasRequested: boolean;
68
- /** 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. */
69
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;
70
106
  }
71
107
 
72
108
  export async function listPlugins(): Promise<PluginSummary[]> {
@@ -83,17 +119,29 @@ export async function listPlugins(): Promise<PluginSummary[]> {
83
119
  * seeded `access.md` before answering, and refuses with its own words —
84
120
  * worth surfacing verbatim.
85
121
  */
86
- export async function createPlugin(name: string): Promise<{ folder: string; name: 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 }> {
87
135
  const res = await authFetch('/api/plugins', {
88
136
  method: 'POST',
89
137
  headers: { 'Content-Type': 'application/json' },
90
- body: JSON.stringify({ name }),
138
+ body: JSON.stringify(parent ? { name, parent } : { name }),
91
139
  });
92
140
  if (!res.ok) {
93
141
  const body = (await res.json().catch(() => ({}))) as { error?: string };
94
142
  throw new Error(body.error ?? "Couldn't create that plugin.");
95
143
  }
96
- return (await res.json()) as { folder: string; name: string };
144
+ return (await res.json()) as { folder: string; name: string; displayName: string };
97
145
  }
98
146
 
99
147
  /**
@@ -211,8 +259,21 @@ export class AlreadyReadableError extends Error {
211
259
  }
212
260
  }
213
261
 
214
- /** Open (or return the existing) join change request. Idempotent server-side. */
215
- 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 }> {
216
277
  const res = await authFetch(`/api/plugins/${encodeURIComponent(name)}/join-request`, {
217
278
  method: 'POST',
218
279
  });
@@ -225,7 +286,7 @@ export async function requestPluginAccess(name: string): Promise<{ number: numbe
225
286
  .catch(() => ({}))) as { kind?: string };
226
287
  if (body.kind === 'already-readable') throw new AlreadyReadableError();
227
288
  }
228
- return handleApiResponse<{ ok: true; number: number }>(res);
289
+ return handleApiResponse<{ ok: true; state: 'pending' | 'opened'; number: number | null }>(res);
229
290
  }
230
291
 
231
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
+ }