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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (346) hide show
  1. package/THIRD-PARTY-NOTICES.md +2 -2
  2. package/package.json +3 -3
  3. package/src/core/CoreAppShell.tsx +16 -9
  4. package/src/core/__tests__/AppChrome.test.tsx +0 -3
  5. package/src/core/__tests__/events.test.ts +43 -0
  6. package/src/core/bootstrap.ts +11 -3
  7. package/src/core/events.ts +85 -3
  8. package/src/core/registry.ts +1 -1
  9. package/src/lib/__tests__/email.test.ts +44 -0
  10. package/src/lib/email.ts +37 -1
  11. package/src/modules/access/__tests__/ManageAccessDialog.add-row-picking.test.tsx +141 -0
  12. package/src/modules/access/__tests__/ManageAccessDialog.chip-truncation.test.tsx +204 -0
  13. package/src/modules/access/__tests__/ManageAccessDialog.download-read.test.tsx +234 -0
  14. package/src/modules/access/__tests__/ManageAccessDialog.edited-row-visible.test.tsx +160 -0
  15. package/src/modules/access/__tests__/ManageAccessDialog.placement.test.tsx +2 -2
  16. package/src/modules/access/__tests__/ManageAccessDialog.proposal.test.tsx +166 -0
  17. package/src/modules/access/__tests__/ManageAccessDialog.restrict.test.tsx +510 -0
  18. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-axes.test.tsx +299 -0
  19. package/src/modules/access/__tests__/ManageAccessDialog.row-menu-width.test.tsx +226 -0
  20. package/src/modules/access/__tests__/ManageAccessDialog.test.tsx +721 -126
  21. package/src/modules/access/__tests__/ManageAccessDialog.unknown-email.test.tsx +314 -0
  22. package/src/modules/access/__tests__/manage-access-affordance.test.ts +14 -0
  23. package/src/modules/access/__tests__/tailwindDeclarations.ts +210 -0
  24. package/src/modules/access/api.ts +140 -6
  25. package/src/modules/access/components/ManageAccessDialog.tsx +1299 -561
  26. package/src/modules/access/manage-access-affordance.ts +17 -0
  27. package/src/modules/admin/__tests__/AddMemberInput.test.tsx +297 -0
  28. package/src/modules/admin/__tests__/AdminRolesPage.capabilities.test.tsx +2 -2
  29. package/src/modules/admin/__tests__/AdminRolesPage.fixed-admin.test.tsx +189 -0
  30. package/src/modules/admin/__tests__/AdminRolesPage.suggest.test.tsx +1 -1
  31. package/src/modules/admin/__tests__/ConnectionKeysPage.test.tsx +266 -0
  32. package/src/modules/admin/__tests__/DirectoryGroupsPage.suggest.test.tsx +182 -0
  33. package/src/modules/admin/__tests__/DirectoryGroupsPage.test.tsx +165 -14
  34. package/src/modules/admin/__tests__/UserAccountsPage.test.tsx +401 -4
  35. package/src/modules/admin/__tests__/group-members-path.test.ts +27 -0
  36. package/src/modules/admin/components/AddMemberInput.tsx +268 -0
  37. package/src/modules/admin/components/AdminRolesPage.tsx +97 -132
  38. package/src/modules/admin/components/ConnectionKeysPage.tsx +269 -0
  39. package/src/modules/admin/components/DirectoryGroupsPage.tsx +91 -39
  40. package/src/modules/admin/components/UserAccountsPage.tsx +271 -37
  41. package/src/modules/admin/components/connection-keys-grouping.ts +43 -0
  42. package/src/modules/admin/components/group-members-path.ts +32 -0
  43. package/src/modules/admin/services/connection-keys.api.ts +47 -0
  44. package/src/modules/admin/services/roles.api.ts +12 -1
  45. package/src/modules/auth/__tests__/AccountPage.test.tsx +50 -2
  46. package/src/modules/auth/components/AccountPage.tsx +73 -54
  47. package/src/modules/auth/components/LoginScreen.tsx +1 -0
  48. package/src/modules/auth/services/account.api.ts +78 -4
  49. package/src/modules/change-requests/__tests__/ChangeRequestDialog.access-rules.test.tsx +144 -0
  50. package/src/modules/change-requests/__tests__/ChangeRequestDialog.binary.test.tsx +422 -0
  51. package/src/modules/change-requests/__tests__/ChangeRequestDialog.brings-itself-up-to-date.test.tsx +431 -0
  52. package/src/modules/change-requests/__tests__/ChangeRequestDialog.fork-point.test.tsx +193 -0
  53. package/src/modules/change-requests/__tests__/ChangeRequestDialog.initial-file.test.tsx +142 -0
  54. package/src/modules/change-requests/__tests__/ChangeRequestDialog.moved.test.tsx +202 -0
  55. package/src/modules/change-requests/__tests__/ChangeRequestDialog.test.tsx +205 -13
  56. package/src/modules/change-requests/__tests__/ChangeRequestDialog.unreadable.test.tsx +271 -0
  57. package/src/modules/change-requests/__tests__/FileChangeBoxes.test.tsx +208 -0
  58. package/src/modules/change-requests/__tests__/apply-outcome-for-every-viewer.test.tsx +286 -0
  59. package/src/modules/change-requests/__tests__/propose.concurrent.test.ts +273 -0
  60. package/src/modules/change-requests/__tests__/readFailure.test.ts +122 -0
  61. package/src/modules/change-requests/__tests__/useCrFileDiffs.test.tsx +238 -0
  62. package/src/modules/change-requests/__tests__/useFileOnBranch.test.tsx +56 -1
  63. package/src/modules/change-requests/__tests__/useForkPointFile.test.tsx +79 -0
  64. package/src/modules/change-requests/components/BranchFilePreview.tsx +357 -0
  65. package/src/modules/change-requests/components/ChangeBox.tsx +31 -2
  66. package/src/modules/change-requests/components/ChangeRequestDialog.tsx +862 -72
  67. package/src/modules/change-requests/components/CrFileTree.tsx +74 -58
  68. package/src/modules/change-requests/components/FileChangeBoxes.tsx +19 -15
  69. package/src/modules/change-requests/hooks/useApplyChangeRequest.ts +41 -7
  70. package/src/modules/change-requests/hooks/useCrFileDiffs.ts +181 -23
  71. package/src/modules/change-requests/hooks/useFileOnBranch.ts +70 -7
  72. package/src/modules/change-requests/hooks/useForkPointFile.ts +77 -0
  73. package/src/modules/change-requests/services/change-requests.api.ts +57 -1
  74. package/src/modules/change-requests/services/denied-file.api.ts +53 -0
  75. package/src/modules/change-requests/services/propose.api.ts +97 -8
  76. package/src/modules/change-requests/utils/approval.ts +15 -0
  77. package/src/modules/change-requests/utils/author.ts +32 -0
  78. package/src/modules/change-requests/utils/readFailure.ts +110 -0
  79. package/src/modules/git/__tests__/FileHistoryPanel.test.tsx +20 -0
  80. package/src/modules/git/components/FileHistoryPanel.tsx +5 -0
  81. package/src/modules/git/components/PullRequestsForMe.tsx +51 -24
  82. package/src/modules/git/services/__tests__/error-messages.test.ts +29 -0
  83. package/src/modules/git/services/error-messages.ts +12 -0
  84. package/src/modules/git/services/pr-prompts.ts +5 -5
  85. package/src/modules/layout/__tests__/HeaderAlignment.test.tsx +401 -0
  86. package/src/modules/layout/__tests__/SidebarFooterGrid.test.tsx +286 -0
  87. package/src/modules/layout/__tests__/SidebarFrameResponsive.test.tsx +61 -0
  88. package/src/modules/layout/components/AppLayout.tsx +2 -0
  89. package/src/modules/layout/components/MobileChatLayout.tsx +4 -1
  90. package/src/modules/layout/components/ResizableThreePaneLayout.tsx +4 -1
  91. package/src/modules/layout/components/SidebarFrame.tsx +108 -3
  92. package/src/modules/library/__tests__/AddToPluginDialog.test.tsx +171 -5
  93. package/src/modules/library/__tests__/DeleteToolDialog.test.tsx +356 -0
  94. package/src/modules/library/__tests__/IntegrationsSetupReminder.test.tsx +60 -0
  95. package/src/modules/library/__tests__/LibraryCard.test.tsx +91 -10
  96. package/src/modules/library/__tests__/LibraryRoutes.test.tsx +242 -107
  97. package/src/modules/library/__tests__/LibrarySidebarMenu.test.tsx +103 -98
  98. package/src/modules/library/__tests__/LinkSkillPanel.test.tsx +20 -5
  99. package/src/modules/library/__tests__/LockedPluginView.test.tsx +97 -7
  100. package/src/modules/library/__tests__/NewPluginDialog.test.tsx +13 -4
  101. package/src/modules/library/__tests__/PersonalAddDialog.test.tsx +79 -3
  102. package/src/modules/library/__tests__/PersonalPluginPage.test.tsx +201 -0
  103. package/src/modules/library/__tests__/PluginExtras.test.tsx +100 -9
  104. package/src/modules/library/__tests__/PluginJoinRequests.test.tsx +60 -1
  105. package/src/modules/library/__tests__/PluginPage.test.tsx +258 -6
  106. package/src/modules/library/__tests__/PluginsSidebar.contextmenu.test.tsx +16 -56
  107. package/src/modules/library/__tests__/PluginsSidebar.test.tsx +155 -152
  108. package/src/modules/library/__tests__/PluginsSidebarMenu.test.tsx +16 -0
  109. package/src/modules/library/__tests__/SharedViaPlugins.test.tsx +106 -0
  110. package/src/modules/library/__tests__/SkillPage.test.tsx +386 -80
  111. package/src/modules/library/__tests__/SkillsTree.test.tsx +293 -4
  112. package/src/modules/library/__tests__/ToolConnectionSection.test.tsx +582 -71
  113. package/src/modules/library/__tests__/ToolPage.test.tsx +87 -4
  114. package/src/modules/library/__tests__/WorkspaceItemRoute.test.tsx +173 -26
  115. package/src/modules/library/__tests__/auth-harness.tsx +9 -9
  116. package/src/modules/library/__tests__/card-row-menu.test.tsx +320 -0
  117. package/src/modules/library/__tests__/library-data.mapping.test.tsx +98 -0
  118. package/src/modules/library/__tests__/library-data.stale.test.tsx +121 -28
  119. package/src/modules/library/__tests__/library-data.test.ts +7 -0
  120. package/src/modules/library/__tests__/library-paths.test.ts +47 -4
  121. package/src/modules/library/__tests__/link-membership.test.ts +13 -4
  122. package/src/modules/library/__tests__/name-with-badges.test.tsx +273 -0
  123. package/src/modules/library/__tests__/newSkillMarkdown.test.ts +30 -0
  124. package/src/modules/library/__tests__/owner-pill.test.tsx +357 -0
  125. package/src/modules/library/__tests__/pending-tools.test.tsx +400 -0
  126. package/src/modules/library/__tests__/plugin-entries.test.ts +122 -0
  127. package/src/modules/library/__tests__/plugin-summary.test.ts +36 -1
  128. package/src/modules/library/__tests__/status.test.ts +82 -2
  129. package/src/modules/library/__tests__/tools.api.test.ts +44 -1
  130. package/src/modules/library/components/AccessRequestsBanner.tsx +85 -47
  131. package/src/modules/library/components/AddDialogTabs.tsx +103 -0
  132. package/src/modules/library/components/AddToPluginDialog.tsx +74 -18
  133. package/src/modules/library/components/IntegrationsSetupReminder.tsx +59 -0
  134. package/src/modules/library/components/ItemActionsMenu.tsx +288 -0
  135. package/src/modules/library/components/LibraryCard.tsx +146 -45
  136. package/src/modules/library/components/LibraryLayout.tsx +119 -256
  137. package/src/modules/library/components/LibraryPage.tsx +172 -39
  138. package/src/modules/library/components/LinkSkillPanel.tsx +1 -3
  139. package/src/modules/library/components/LockedPluginView.tsx +62 -34
  140. package/src/modules/library/components/NameWithBadges.tsx +164 -0
  141. package/src/modules/library/components/NewPluginDialog.tsx +16 -2
  142. package/src/modules/library/components/PageActions.tsx +11 -9
  143. package/src/modules/library/components/{PendingSkillReview.tsx → PendingItemReview.tsx} +14 -7
  144. package/src/modules/library/components/PersonalAddDialog.tsx +68 -18
  145. package/src/modules/library/components/PersonalPluginPage.tsx +121 -22
  146. package/src/modules/library/components/PluginExtras.tsx +140 -17
  147. package/src/modules/library/components/PluginIndexRow.tsx +47 -12
  148. package/src/modules/library/components/PluginPage.tsx +157 -41
  149. package/src/modules/library/components/PluginRows.tsx +286 -0
  150. package/src/modules/library/components/PluginsSidebar.tsx +239 -263
  151. package/src/modules/library/components/PluginsSidebarMenu.tsx +26 -1
  152. package/src/modules/library/components/ShareButton.tsx +17 -0
  153. package/src/modules/library/components/SkillsTree.tsx +141 -28
  154. package/src/modules/library/components/TeamRoute.tsx +15 -0
  155. package/src/modules/library/components/__tests__/upload-notices-once-per-page.test.tsx +144 -0
  156. package/src/modules/library/components/plugin-page-parts.tsx +103 -17
  157. package/src/modules/library/components/skill-page/SharedViaPlugins.tsx +6 -12
  158. package/src/modules/library/components/skill-page/SkillFilePane.tsx +5 -0
  159. package/src/modules/library/components/skill-page/SkillPage.tsx +274 -122
  160. package/src/modules/library/components/tool-page/DeleteToolDialog.tsx +218 -0
  161. package/src/modules/library/components/tool-page/ToolConnectionSection.tsx +79 -178
  162. package/src/modules/library/components/tool-page/ToolPage.tsx +106 -16
  163. package/src/modules/library/components/tool-page/ToolVarRow.tsx +42 -41
  164. package/src/modules/library/hooks/__tests__/useLibraryData.test.ts +98 -0
  165. package/src/modules/library/hooks/useLibraryData.ts +92 -19
  166. package/src/modules/library/routes/LibraryRoutes.tsx +14 -11
  167. package/src/modules/library/routes/WorkspaceItemRoute.tsx +77 -27
  168. package/src/modules/library/routes/library-paths.ts +26 -28
  169. package/src/modules/library/services/library.api.ts +38 -20
  170. package/src/modules/library/services/plugins.api.ts +69 -8
  171. package/src/modules/library/services/teams.api.ts +15 -0
  172. package/src/modules/library/services/tools.api.ts +78 -0
  173. package/src/modules/library/state/library-data.tsx +170 -32
  174. package/src/modules/library/utils/personal-plugin.ts +13 -15
  175. package/src/modules/library/utils/plugin-entries.ts +134 -0
  176. package/src/modules/library/utils/plugin-summary.ts +75 -9
  177. package/src/modules/library/utils/status.ts +135 -33
  178. package/src/modules/onboarding/__tests__/creator-welcome.test.tsx +8 -1
  179. package/src/modules/onboarding/__tests__/onboarding.test.tsx +853 -760
  180. package/src/modules/onboarding/agent-clients.ts +55 -23
  181. package/src/modules/onboarding/components/ConnectAgentPill.tsx +5 -1
  182. package/src/modules/onboarding/components/WelcomePage.tsx +98 -62
  183. package/src/modules/pr/services/pr-merge.api.ts +2 -1
  184. package/src/modules/review/components/MarkdownDiffViewer.tsx +53 -8
  185. package/src/modules/review/components/ReviewPanel.tsx +15 -17
  186. package/src/modules/review/components/__tests__/MarkdownDiffViewer.test.tsx +64 -0
  187. package/src/modules/review/components/__tests__/ReviewPanel.test.tsx +25 -1
  188. package/src/modules/secrets-vault/components/ConnectToolsPage.tsx +454 -117
  189. package/src/modules/secrets-vault/components/SecretsPage.tsx +48 -7
  190. package/src/modules/secrets-vault/components/ToolSecretsPanel.tsx +84 -5
  191. package/src/modules/secrets-vault/components/__tests__/ConnectToolsPage.test.tsx +425 -0
  192. package/src/modules/secrets-vault/components/__tests__/SecretsPage.test.tsx +417 -82
  193. package/src/modules/secrets-vault/components/__tests__/ToolSecretsPanel.test.tsx +105 -0
  194. package/src/modules/secrets-vault/components/__tests__/connect-lists-what-the-banner-counted.test.tsx +407 -0
  195. package/src/modules/secrets-vault/probe/SavedKeyProbeResult.tsx +98 -0
  196. package/src/modules/secrets-vault/probe/__tests__/probe-verdict.test.ts +160 -0
  197. package/src/modules/secrets-vault/probe/probe-verdict.ts +108 -0
  198. package/src/modules/secrets-vault/probe/useSavedKeyProbe.ts +228 -0
  199. package/src/modules/secrets-vault/services/connect.api.ts +36 -5
  200. package/src/modules/secrets-vault/utils/connect-status.ts +98 -0
  201. package/src/modules/settings/components/ClaudeConnectionCard.tsx +9 -24
  202. package/src/modules/settings/components/ClaudeConnectionFields.tsx +23 -0
  203. package/src/modules/settings/components/DeploymentPage.tsx +10 -30
  204. package/src/modules/settings/components/MarketplaceSection.tsx +152 -0
  205. package/src/modules/settings/components/__tests__/DeploymentPage.test.tsx +67 -4
  206. package/src/modules/settings/components/__tests__/MarketplaceSection.test.tsx +325 -0
  207. package/src/modules/settings/components/__tests__/SettingsLayout.test.tsx +5 -5
  208. package/src/modules/settings/services/github-facade.api.ts +23 -0
  209. package/src/modules/settings/settings-nav-items.tsx +10 -2
  210. package/src/modules/setup/__tests__/setup.oidc.test.tsx +172 -0
  211. package/src/modules/setup/__tests__/setup.probe-refusal.test.tsx +123 -0
  212. package/src/modules/setup/__tests__/setup.test.tsx +497 -4
  213. package/src/modules/setup/__tests__/useSetupStatus.test.tsx +130 -0
  214. package/src/modules/setup/components/SetupGate.tsx +16 -16
  215. package/src/modules/setup/components/SetupScreen.tsx +521 -43
  216. package/src/modules/setup/hooks/useSetupStatus.ts +93 -0
  217. package/src/modules/setup/services/setup.api.ts +140 -3
  218. package/src/modules/setup/utils/__tests__/root-folders.test.ts +72 -0
  219. package/src/modules/setup/utils/root-folders.ts +46 -0
  220. package/src/modules/toolbar/assets/claude-setup/01-add-manually.webp +0 -0
  221. package/src/modules/toolbar/assets/claude-setup/02-add-configuration.webp +0 -0
  222. package/src/modules/toolbar/assets/claude-setup/03-connect-account.webp +0 -0
  223. package/src/modules/toolbar/assets/claude-setup/04-pick-instance.webp +0 -0
  224. package/src/modules/toolbar/assets/claude-setup/05-plugins-add.webp +0 -0
  225. package/src/modules/toolbar/assets/claude-setup/06-add-marketplace.webp +0 -0
  226. package/src/modules/toolbar/assets/claude-setup/07-paste-url-sync.webp +0 -0
  227. package/src/modules/toolbar/assets/claude-setup/08-install-plugins.webp +0 -0
  228. package/src/modules/toolbar/assets/claude-setup/09-select-repository.webp +0 -0
  229. package/src/modules/toolbar/assets/claude-setup/10-connector-not-added.webp +0 -0
  230. package/src/modules/toolbar/assets/claude-setup/11-add-custom-connector.webp +0 -0
  231. package/src/modules/toolbar/assets/claude-setup/README.md +68 -0
  232. package/src/modules/toolbar/components/AgentInstructionsCard.tsx +296 -0
  233. package/src/modules/toolbar/components/ClaudeMarketplaceCarousel.tsx +107 -0
  234. package/src/modules/toolbar/components/ClaudeRegistrationSteps.tsx +127 -0
  235. package/src/modules/toolbar/components/CoworkSetupSteps.tsx +100 -0
  236. package/src/modules/toolbar/components/ExternalAgentAccessPage.tsx +177 -118
  237. package/src/modules/toolbar/components/ScreenshotStep.tsx +77 -0
  238. package/src/modules/toolbar/components/SetupCarousel.tsx +177 -0
  239. package/src/modules/toolbar/components/__tests__/AgentInstructionsCard.test.tsx +370 -0
  240. package/src/modules/toolbar/components/__tests__/ExternalAgentAccessPage.test.tsx +542 -42
  241. package/src/modules/toolbar/components/__tests__/Toolbar.test.tsx +2 -2
  242. package/src/modules/toolbar/components/__tests__/claude-setup-shots.test.ts +104 -0
  243. package/src/modules/toolbar/components/claude-connector-slide.tsx +38 -0
  244. package/src/modules/toolbar/components/claude-setup-shots.ts +167 -0
  245. package/src/modules/toolbar/components/deployment-address.ts +29 -0
  246. package/src/modules/toolbar/components/setup-step-parts.tsx +35 -0
  247. package/src/modules/toolbar/services/__tests__/agent-instructions.api.test.ts +89 -0
  248. package/src/modules/toolbar/services/agent-instructions.api.ts +167 -0
  249. package/src/modules/toolbar/services/external-api-keys.api.ts +6 -0
  250. package/src/modules/workflow/state/ChangeRequestStaleBinder.tsx +43 -0
  251. package/src/modules/workflow/state/EventBusProvider.tsx +122 -11
  252. package/src/modules/workflow/state/__tests__/EventBusProvider.storage.test.tsx +87 -0
  253. package/src/modules/workflow/state/__tests__/EventBusProvider.watch.test.tsx +223 -0
  254. package/src/modules/workflow/state/event-bus.context.ts +10 -0
  255. package/src/modules/workspace/__tests__/testFixtures.ts +5 -3
  256. package/src/modules/workspace/components/FileExplorer.tsx +1295 -191
  257. package/src/modules/workspace/components/FileRoute.tsx +353 -36
  258. package/src/modules/workspace/components/FileViewer.tsx +166 -45
  259. package/src/modules/workspace/components/KbDocumentShell.tsx +50 -6
  260. package/src/modules/workspace/components/KbPageHeader.tsx +120 -55
  261. package/src/modules/workspace/components/TreeActionConfirm.tsx +350 -0
  262. package/src/modules/workspace/components/__tests__/FileExplorer.test.tsx +2473 -129
  263. package/src/modules/workspace/components/__tests__/FileRoute.test.tsx +731 -18
  264. package/src/modules/workspace/components/__tests__/FileViewer.test.tsx +331 -12
  265. package/src/modules/workspace/components/__tests__/KbDocumentShell.test.tsx +39 -0
  266. package/src/modules/workspace/components/__tests__/KbPageHeader.test.tsx +33 -20
  267. package/src/modules/workspace/components/renderers/DocxRenderer.tsx +4 -5
  268. package/src/modules/workspace/components/renderers/DownloadFileButton.tsx +13 -4
  269. package/src/modules/workspace/components/renderers/EmailRenderer.tsx +4 -3
  270. package/src/modules/workspace/components/renderers/HtmlRenderer.tsx +8 -14
  271. package/src/modules/workspace/components/renderers/ImageRenderer.tsx +75 -16
  272. package/src/modules/workspace/components/renderers/KbImage.tsx +180 -0
  273. package/src/modules/workspace/components/renderers/KbMarkdownView.tsx +22 -6
  274. package/src/modules/workspace/components/renderers/MarkdownRenderer.tsx +48 -22
  275. package/src/modules/workspace/components/renderers/PdfRenderer.tsx +4 -5
  276. package/src/modules/workspace/components/renderers/PptxRenderer.tsx +4 -3
  277. package/src/modules/workspace/components/renderers/XlsxRenderer.tsx +4 -3
  278. package/src/modules/workspace/components/renderers/__tests__/DocxRenderer.test.tsx +12 -0
  279. package/src/modules/workspace/components/renderers/__tests__/DownloadFileButton.test.tsx +57 -9
  280. package/src/modules/workspace/components/renderers/__tests__/EmailRenderer.test.tsx +13 -1
  281. package/src/modules/workspace/components/renderers/__tests__/ImageRenderer.test.tsx +163 -0
  282. package/src/modules/workspace/components/renderers/__tests__/KbMarkdownView.test.tsx +237 -0
  283. package/src/modules/workspace/components/renderers/__tests__/MarkdownRenderer.test.tsx +108 -14
  284. package/src/modules/workspace/components/renderers/__tests__/PptxRenderer.test.tsx +14 -1
  285. package/src/modules/workspace/components/renderers/__tests__/XlsxRenderer.test.tsx +16 -1
  286. package/src/modules/workspace/components/renderers/__tests__/rendererSelection.test.tsx +66 -1
  287. package/src/modules/workspace/components/renderers/index.ts +53 -2
  288. package/src/modules/workspace/components/renderers/kbMarkdownPipeline.tsx +25 -4
  289. package/src/modules/workspace/components/renderers/rendererWorkspace.ts +40 -0
  290. package/src/modules/workspace/hooks/__tests__/useImageRevision.test.tsx +174 -0
  291. package/src/modules/workspace/hooks/__tests__/useOpenChangeRequests.test.tsx +179 -1
  292. package/src/modules/workspace/hooks/__tests__/useWorkspaceImageResolver.test.tsx +122 -0
  293. package/src/modules/workspace/hooks/__tests__/useWorkspaceState.test.tsx +892 -7
  294. package/src/modules/workspace/hooks/useImageRevision.ts +101 -0
  295. package/src/modules/workspace/hooks/useMergedWorkspaceTree.ts +22 -3
  296. package/src/modules/workspace/hooks/useWorkspaceImageResolver.ts +55 -0
  297. package/src/modules/workspace/hooks/useWorkspaceState.ts +424 -66
  298. package/src/modules/workspace/routing/__tests__/kb-routes.test.tsx +279 -3
  299. package/src/modules/workspace/routing/kb-routes.ts +206 -29
  300. package/src/modules/workspace/services/__tests__/workspace.api.test.ts +57 -1
  301. package/src/modules/workspace/services/workspace.api.ts +57 -4
  302. package/src/modules/workspace/state/__tests__/applied-request-clears-pending.test.tsx +343 -0
  303. package/src/modules/workspace/state/__tests__/upload-lands-where-it-was-dropped.test.tsx +158 -0
  304. package/src/modules/workspace/state/open-change-requests.tsx +100 -12
  305. package/src/modules/workspace/state/workspace.context.ts +125 -19
  306. package/src/modules/workspace/utils/__tests__/file-trace.test.ts +73 -0
  307. package/src/modules/workspace/utils/__tests__/fileTree.test.ts +220 -6
  308. package/src/modules/workspace/utils/__tests__/pasteLink.test.ts +76 -0
  309. package/src/modules/workspace/utils/__tests__/treeConfirm.test.ts +364 -0
  310. package/src/modules/workspace/utils/__tests__/uploadError.test.ts +35 -0
  311. package/src/modules/workspace/utils/file-trace.ts +50 -0
  312. package/src/modules/workspace/utils/fileTree.ts +112 -36
  313. package/src/modules/workspace/utils/frontmatter.ts +8 -4
  314. package/src/modules/workspace/utils/pasteLink.ts +90 -0
  315. package/src/modules/workspace/utils/treeConfirm.ts +338 -0
  316. package/src/modules/workspace/utils/uploadError.ts +29 -0
  317. package/src/shared/__tests__/marketplace-url.test.ts +6 -1
  318. package/src/shared/components/Button.tsx +16 -2
  319. package/src/shared/components/Dialog.tsx +27 -11
  320. package/src/shared/components/Menu.tsx +13 -1
  321. package/src/shared/components/PageShell.tsx +13 -8
  322. package/src/shared/components/__tests__/primitives.test.tsx +116 -2
  323. package/src/shared/components/__tests__/useFocusHandoff.test.tsx +192 -0
  324. package/src/shared/components/index.ts +2 -0
  325. package/src/shared/components/useDismissableMenu.ts +32 -10
  326. package/src/shared/components/useFocusHandoff.ts +51 -0
  327. package/src/shared/components/useLatestRef.ts +28 -0
  328. package/src/shared/markdown/Markdown.tsx +12 -3
  329. package/src/shared/markdown/__tests__/escapeSpacesInLinkDestinations.test.ts +39 -0
  330. package/src/shared/markdown/hrefs.ts +50 -0
  331. package/src/shared/marketplace-url.ts +33 -5
  332. package/src/shared/mcp/ChatGptInstallLink.tsx +3 -3
  333. package/src/shared/mcp/ConnectionInstructions.tsx +38 -27
  334. package/src/shared/mcp/__tests__/connect-snippets.test.ts +3 -3
  335. package/src/shared/mcp/connect-snippets.ts +14 -9
  336. package/src/shared/mcp/index.ts +1 -1
  337. package/src/shared/theme/__tests__/header-band.test.ts +197 -0
  338. package/src/shared/theme/header.ts +75 -0
  339. package/src/shared/theme/measure.ts +7 -4
  340. package/src/shared/theme/tokens.css +25 -0
  341. package/src/modules/library/__tests__/PluginsIndexPage.test.tsx +0 -363
  342. package/src/modules/library/__tests__/PluginsSidebar.locked.test.tsx +0 -97
  343. package/src/modules/library/components/PluginsIndexPage.tsx +0 -270
  344. package/src/modules/update-check/__tests__/UpdateBanner.test.tsx +0 -126
  345. package/src/modules/update-check/components/UpdateBanner.tsx +0 -92
  346. package/src/modules/update-check/services/update-check.api.ts +0 -24
@@ -6,7 +6,8 @@ import { PageShell } from '../../../shared/components/PageShell';
6
6
  import { buttonClasses } from '../../../shared/components';
7
7
  import { formatRelativeTime } from '../../../lib/utils';
8
8
  import {
9
- ConnectionInstructions,
9
+ AssistantConnectionInstructions,
10
+ OtherAgentConnectionInstructions,
10
11
  CopyBlock,
11
12
  claudeCodeCommand,
12
13
  hexisMcpClaudeCommand,
@@ -17,7 +18,9 @@ import {
17
18
  useCopyFeedback,
18
19
  workspaceBaseUrl,
19
20
  } from '../../../shared/mcp';
20
- import { GITHUB_LINK_KIND, marketplaceCommands, marketplaceGitUrl } from '../../../shared/marketplace-url';
21
+ import { CODEX_LOGIN_NOTE, GITHUB_LINK_KIND, marketplaceCommands, marketplaceGitUrl } from '../../../shared/marketplace-url';
22
+ import { AgentInstructionsCard } from './AgentInstructionsCard';
23
+ import { CoworkSetupSteps } from './CoworkSetupSteps';
21
24
  import { useAdmin } from '../../admin/state/admin.context';
22
25
  import {
23
26
  type ExternalApiKeySummary,
@@ -43,7 +46,7 @@ function formatRelative(ts: number | null): string {
43
46
  * `/external-agent-access` (below the persistent toolbar), in three tabs:
44
47
  *
45
48
  * - "Your agent" (default) — connecting the user's own interactive agent
46
- * (Claude Code, Claude Desktop, Cursor…). No key: the agent gets only the
49
+ * (Claude, ChatGPT, Claude Code, Cursor…). No key: the agent gets only the
47
50
  * server URL, and on first connect the browser opens our authorization
48
51
  * flow (sign in + choose tools on /connect). Copy-paste configs only.
49
52
  * - "Marketplaces" — skills as native plugins rather than through the MCP
@@ -81,6 +84,11 @@ export function ExternalAgentAccessPage() {
81
84
  const workspaceUrl = workspaceBaseUrl();
82
85
 
83
86
  const [tab, setTab] = useState<'agent' | 'marketplace' | 'autonomous'>('agent');
87
+ // Whether the Cowork drawer is expanded. Only the registration state waits
88
+ // on it; everything else in the drawer renders either way.
89
+ const [coworkOpen, setCoworkOpen] = useState(false);
90
+ // Only the wording of the "not set up yet" notice depends on this; the
91
+ // tutorial itself is the same for everyone.
84
92
  const { isAdmin } = useAdmin();
85
93
  const [keys, setKeys] = useState<ExternalApiKeySummary[]>([]);
86
94
  const [loading, setLoading] = useState(false);
@@ -184,8 +192,13 @@ export function ExternalAgentAccessPage() {
184
192
 
185
193
  return (
186
194
  <>
187
- <PageShell title="External agent access" padded={false}>
188
- <div className="flex border-b border-line px-4 shrink-0" role="tablist">
195
+ <PageShell title="External agent access" padded={false} card={false}>
196
+ <div className="space-y-4">
197
+ <section
198
+ className="bg-white border border-line rounded-lg overflow-hidden"
199
+ data-testid="agent-connection-section"
200
+ >
201
+ <div className="flex border-b border-line px-4 shrink-0" role="tablist">
189
202
  {(
190
203
  [
191
204
  ['agent', 'Your agent'],
@@ -207,28 +220,62 @@ export function ExternalAgentAccessPage() {
207
220
  {name}
208
221
  </button>
209
222
  ))}
210
- </div>
223
+ </div>
211
224
 
212
- {tab === 'agent' && (
225
+ {tab === 'agent' && (
213
226
  <div className="px-4 py-3 space-y-4">
214
227
  <p className="text-xs text-ink-muted leading-snug">
215
228
  Pick where your agent runs. Everything it saves appears under your name.
216
229
  </p>
217
- {/* LOCAL FIRST. The local server is the recommended connection for
218
- every agent that can run it — it serves everything the hosted
219
- endpoint does PLUS the plugins' local-only tools — so its drawer
220
- leads, and the hosted URL follows for the agents that cannot
221
- (web assistants, cloud platforms). Two CLOSED drawers, native
222
- <details> (the SecretsPage "Advanced" precedent): the choice is
223
- the headline, and neither config wall is worth reading until
224
- the reader has picked their side of it. */}
230
+ {/* CLAUDE AND CHATGPT FIRST, and OPEN. They are what most people
231
+ arriving here already use, and Claude's is the one connection
232
+ that is a single click — so the page opens on its button and
233
+ the address to paste, with nothing to expand first. The local
234
+ server follows for agents that run on your machine (it still
235
+ serves everything the hosted endpoint does PLUS the plugins'
236
+ local-only tools), then the configs for everything else. Native
237
+ <details> (the SecretsPage "Advanced" precedent); the second
238
+ and third stay closed, because neither config wall is worth
239
+ reading until the reader has picked their side of it.
240
+
241
+ `open` is a default, not controlled state: nothing here waits
242
+ on it, and a drawer that reopens on a tab switch is the page
243
+ returning to where it starts. */}
244
+ <details className="border border-line rounded" open>
245
+ <summary className="cursor-pointer px-3 py-2 text-xs font-medium text-ink">
246
+ Claude and ChatGPT
247
+ </summary>
248
+ <div className="px-3 pb-3 space-y-3">
249
+ <p className="text-meta text-ink-muted leading-snug">
250
+ claude.ai, Claude Desktop and ChatGPT connect to the hosted endpoint. No key
251
+ needed: the first time the agent connects, your browser opens so you can sign
252
+ in and choose which tools to share with it.
253
+ </p>
254
+ <AssistantConnectionInstructions mcpUrl={mcpUrl} />
255
+ {/* `buttonClasses`, not a hand-rolled class string — the one
256
+ button primitive exists because 171 sites once shared 153
257
+ variants between them, and its docstring prescribes exactly
258
+ this shape for links. */}
259
+ <Link
260
+ to="/connect"
261
+ target="_blank"
262
+ rel="noopener noreferrer"
263
+ className={buttonClasses({ variant: 'outline', size: 'sm', className: 'w-full' })}
264
+ >
265
+ <Wrench size={12} />
266
+ Configure your tools
267
+ <ExternalLink size={11} className="opacity-60" aria-hidden="true" />
268
+ </Link>
269
+ </div>
270
+ </details>
271
+
225
272
  <details className="border border-line rounded">
226
273
  <summary className="cursor-pointer px-3 py-2 text-xs font-medium text-ink">
227
274
  Desktop agents: Claude Code, Claude Desktop, Cursor, Windsurf, Cline and similar
228
275
  </summary>
229
276
  <div className="px-3 pb-3 space-y-2">
230
277
  <p className="text-meta text-ink-muted leading-snug">
231
- Recommended: runs this workspace as a local MCP server (needs Node), so the
278
+ Runs this workspace as a local MCP server (needs Node), so the
232
279
  agent gets everything the hosted endpoint serves, plus your plugins'
233
280
  local-only tools — the ones{' '}
234
281
  <span className="font-mono">list_local_tools</span> names. No key needed: the
@@ -243,8 +290,8 @@ export function ExternalAgentAccessPage() {
243
290
  </button>{' '}
244
291
  tab shows that setup.)
245
292
  </p>
246
- {/* "(local server)" disambiguates from the hosted drawer's
247
- ConnectionInstructions block, which labels ITS command
293
+ {/* "(local server)" disambiguates from the "Any other agent"
294
+ drawer's hosted block, which labels ITS command
248
295
  "Connect Claude Code" — two identically named blocks on one
249
296
  page with different commands is a paste-the-wrong-one trap. */}
250
297
  <CopyBlock
@@ -264,6 +311,36 @@ export function ExternalAgentAccessPage() {
264
311
  </p>
265
312
  <CopyBlock label={null} value={hexisMcpJsonSnippet(workspaceUrl)} rows={12} />
266
313
  </div>
314
+ {/* The same note the welcome page's Desktop agents hint carries,
315
+ and for the same reason: this is the config a GUI-launched
316
+ client reads, and that client was started by the window
317
+ server rather than by a login shell, so it never sourced the
318
+ profile that put Homebrew's or nvm's `npx` on PATH. The
319
+ snippet above stays plain `npx` — it is right for every
320
+ client launched from a terminal — and this says what to
321
+ substitute in the copy that is not. Both halves of the gap,
322
+ because an absolute `npx` is a script whose
323
+ `#!/usr/bin/env node` line looks `node` up on that same
324
+ PATH; and `where.exe npx`, because this paragraph sits under
325
+ "on Windows, prefer the JSON config", `which` is not a
326
+ command there, and a bare `where` is PowerShell's alias for
327
+ Where-Object. The path it prints holds backslashes, which
328
+ JSON needs doubled — said here, since the field is JSON. */}
329
+ <p className="text-meta text-ink-muted leading-snug">
330
+ Needs Node 22.13+ or 24 on the machine. If the client reports that{' '}
331
+ <span className="font-mono">npx</span> was not found, it was launched from the
332
+ Dock or a desktop icon and cannot see your shell's PATH: run{' '}
333
+ <span className="font-mono">which npx</span> in a terminal (
334
+ <span className="font-mono">where.exe npx</span> in PowerShell) and use the full
335
+ path it prints as the <span className="font-mono">"command"</span> above — on
336
+ Windows with each backslash doubled, or with forward slashes, since the field is
337
+ JSON. If it then reports{' '}
338
+ <span className="font-mono">env: node: No such file or directory</span>, that
339
+ same folder holds <span className="font-mono">node</span>: add it to the
340
+ config's <span className="font-mono">"env"</span> PATH, in front of the usual
341
+ system folders rather than instead of them — the sign-in opens your browser
342
+ through those.
343
+ </p>
267
344
  </div>
268
345
  </details>
269
346
 
@@ -273,26 +350,11 @@ export function ExternalAgentAccessPage() {
273
350
  </summary>
274
351
  <div className="px-3 pb-3 space-y-3">
275
352
  <p className="text-meta text-ink-muted leading-snug">
276
- claude.ai, ChatGPT and other agents that can't run a process on your machine
277
- connect to the hosted endpoint. No key needed: the first time the agent
278
- connects, your browser opens so you can sign in and choose which tools to
279
- share with it.
353
+ Claude Code, cloud platforms and other agents can connect to the same hosted
354
+ endpoint, without running anything on your machine. No key needed here
355
+ either: your browser opens to sign in the first time.
280
356
  </p>
281
- {/* `buttonClasses`, not a hand-rolled class string — the one
282
- button primitive exists because 171 sites once shared 153
283
- variants between them, and its docstring prescribes exactly
284
- this shape for links. */}
285
- <Link
286
- to="/connect"
287
- target="_blank"
288
- rel="noopener noreferrer"
289
- className={buttonClasses({ variant: 'outline', size: 'sm', className: 'w-full' })}
290
- >
291
- <Wrench size={12} />
292
- Configure your tools
293
- <ExternalLink size={11} className="opacity-60" aria-hidden="true" />
294
- </Link>
295
- <ConnectionInstructions mcpUrl={mcpUrl} />
357
+ <OtherAgentConnectionInstructions mcpUrl={mcpUrl} />
296
358
  </div>
297
359
  </details>
298
360
 
@@ -323,7 +385,7 @@ export function ExternalAgentAccessPage() {
323
385
  </div>
324
386
  )}
325
387
 
326
- {tab === 'marketplace' && (
388
+ {tab === 'marketplace' && (
327
389
  <div className="px-4 py-3 space-y-4">
328
390
  <p className="text-xs text-ink-muted leading-snug">
329
391
  Every skill you may read, compiled into a plugin marketplace. One address serves
@@ -331,38 +393,24 @@ export function ExternalAgentAccessPage() {
331
393
  claude.ai fetch it as a repository once your account is connected.
332
394
  </p>
333
395
 
334
- <details className="border border-line rounded" data-testid="cowork-section">
396
+ {/* CONTROLLED, both attributes together. A closed <details> still
397
+ MOUNTS its children, so the registration state waits on
398
+ `coworkOpen` and is read again each time the drawer opens.
399
+ `onToggle` alone is not enough: this subtree unmounts on a tab
400
+ switch and the fresh <details> comes back closed while the
401
+ state stayed true. With `open` bound too, the element cannot
402
+ disagree with the state that gates the read. */}
403
+ <details
404
+ className="border border-line rounded"
405
+ data-testid="cowork-section"
406
+ open={coworkOpen}
407
+ onToggle={(e) => setCoworkOpen(e.currentTarget.open)}
408
+ >
335
409
  <summary className="cursor-pointer px-3 py-2 text-xs font-medium text-ink">
336
410
  Cowork and claude.ai
337
411
  </summary>
338
412
  <div className="px-3 pb-3 space-y-3">
339
- <p className="text-meta text-ink-muted leading-snug">
340
- Cowork and claude.ai take marketplaces only from GitHub, or from a GitHub
341
- Enterprise Server your Claude organization registered. This deployment answers as
342
- one: an Owner of your Claude organization registers it once
343
- {isAdmin ? (
344
- <>
345
- {' '}
346
- (the fields are on the{' '}
347
- <Link to="/deployment" className="underline text-ink-muted hover:text-ink">
348
- Deployment
349
- </Link>{' '}
350
- page)
351
- </>
352
- ) : (
353
- <> (an admin here has the fields)</>
354
- )}
355
- , then every person connects their own account:
356
- </p>
357
- <ol className="text-meta text-ink-muted leading-snug list-decimal pl-4 space-y-0.5">
358
- <li>In Cowork (or claude.ai), open Plugins → Add marketplace and paste the URL below.</li>
359
- <li>
360
- When it asks you to connect your GitHub Enterprise account, you land on this
361
- deployment's sign-in: approve, and you are back in Claude.
362
- </li>
363
- <li>Install the plugins you want. Update in Claude pulls what changed.</li>
364
- </ol>
365
- <CopyBlock label="Marketplace URL" value={marketplaceGitUrl()} rows={2} />
413
+ <CoworkSetupSteps isAdmin={isAdmin} opened={coworkOpen} />
366
414
  <div className="space-y-1">
367
415
  <div className="text-xs font-medium text-ink">Your Claude connections</div>
368
416
  {loadError && (
@@ -427,8 +475,9 @@ export function ExternalAgentAccessPage() {
427
475
  <CopyBlock
428
476
  label="Codex"
429
477
  value={marketplaceCommands('<external-api-key>').codex}
430
- rows={2}
478
+ rows={5}
431
479
  />
480
+ <p className="text-meta text-ink-muted leading-snug">{CODEX_LOGIN_NOTE}</p>
432
481
  <CopyBlock
433
482
  label="Any other agent, via the skills CLI"
434
483
  value={marketplaceCommands('<external-api-key>').skills}
@@ -451,7 +500,7 @@ export function ExternalAgentAccessPage() {
451
500
  </div>
452
501
  )}
453
502
 
454
- {tab === 'autonomous' && (
503
+ {tab === 'autonomous' && (
455
504
  <div className="px-4 py-3 space-y-4">
456
505
  <p className="text-xs text-ink-muted leading-snug">
457
506
  For autonomous agents and pipelines (CI, scheduled jobs) that can't open a browser to
@@ -525,7 +574,10 @@ export function ExternalAgentAccessPage() {
525
574
  <div className="font-medium truncate">{k.label}</div>
526
575
  <div className="text-[11px] text-ink-muted">
527
576
  Created {formatRelative(k.createdAt)} · Last used {formatRelative(k.lastUsedAt)}
528
- {revoked && ' · Disconnected'}
577
+ {/* A key an admin took is not one you can reconnect — say so,
578
+ or people try. Your own disconnect keeps its word. */}
579
+ {revoked &&
580
+ (k.revokedBy === 'admin' ? ' · Revoked by an admin' : ' · Disconnected')}
529
581
  </div>
530
582
  {usage && (
531
583
  <div className="mt-1 max-w-xs">
@@ -572,7 +624,11 @@ export function ExternalAgentAccessPage() {
572
624
  )}
573
625
  </div>
574
626
  </div>
575
- )}
627
+ )}
628
+ </section>
629
+
630
+ <AgentInstructionsCard />
631
+ </div>
576
632
  </PageShell>
577
633
 
578
634
  <Dialog
@@ -641,57 +697,22 @@ export function ExternalAgentAccessPage() {
641
697
  {copied ? <Check size={14} /> : <Copy size={14} />}
642
698
  </button>
643
699
  </div>
644
- {/* The SAME three drawers as the interactive tab — local server,
645
- hosted endpoint, marketplace — in the same order and CLOSED,
646
- with the key filled in. The key is the news here; which
647
- config the reader needs is their call, and five config walls
648
- in a row buried the one thing the dialog exists to hand over.
649
- Same summaries as the tab too, so a person who read the tab
650
- first finds the drawer they already picked. */}
651
- <details className="border border-line rounded">
652
- <summary className="cursor-pointer px-3 py-2 text-xs font-medium text-ink">
653
- Desktop agents — the local server (recommended)
654
- </summary>
655
- <div className="px-3 pb-3 space-y-2">
656
- <p className="text-meta text-ink-muted leading-snug">
657
- For agents that run on your machine: Claude Code, Claude Desktop, Cursor,
658
- Windsurf, Cline and similar. Runs this workspace as a local MCP server (needs
659
- Node): the agent gets everything the hosted endpoint serves, plus your
660
- plugins' local-only tools. In Claude Code:
661
- </p>
662
- <textarea
663
- readOnly
664
- value={hexisMcpClaudeCommand(workspaceUrl, reveal.plaintext)}
665
- rows={3}
666
- className="w-full font-mono text-meta bg-sunken border border-line rounded px-2 py-1.5 resize-none"
667
- onFocus={(e) => e.currentTarget.select()}
668
- />
669
- <p className="text-meta text-ink-muted leading-snug">
670
- On Windows, prefer the JSON config below — this one-liner assumes a POSIX
671
- shell (macOS, Linux, WSL or Git Bash).
672
- </p>
673
- <p className="text-meta text-ink-muted leading-snug">
674
- Or as a JSON config, for Claude Desktop, Cursor, Windsurf, Cline and
675
- similar:
676
- </p>
677
- <textarea
678
- readOnly
679
- value={hexisMcpJsonSnippet(workspaceUrl, reveal.plaintext)}
680
- rows={13}
681
- className="w-full font-mono text-meta bg-sunken border border-line rounded px-2 py-1.5 resize-none"
682
- onFocus={(e) => e.currentTarget.select()}
683
- />
684
- </div>
685
- </details>
686
-
700
+ {/* Three drawers in the interactive tab's order — the hosted
701
+ endpoint Claude and ChatGPT use, then the local server, then
702
+ the marketplace — all CLOSED, with the key filled in. The key
703
+ is the news here; which config the reader needs is their
704
+ call, and five config walls in a row buried the one thing the
705
+ dialog exists to hand over. */}
687
706
  <details className="border border-line rounded">
688
707
  <summary className="cursor-pointer px-3 py-2 text-xs font-medium text-ink">
689
- Web agents and pipelines — the hosted endpoint
708
+ Claude, ChatGPT and pipelines — the hosted endpoint
690
709
  </summary>
691
710
  <div className="px-3 pb-3 space-y-3">
692
711
  <div>
693
712
  <p className="text-meta text-ink-muted mb-1 leading-snug">
694
- For agents that can't run a process on your machine, and for CI where
713
+ The address Claude and ChatGPT connect to — they sign in through the
714
+ browser, from the Your agent tab, and need no key. With this key it
715
+ serves agents that can't run a process on your machine, and CI where
695
716
  installing Node is unwanted. Claude Code, via the hosted endpoint:
696
717
  </p>
697
718
  <textarea
@@ -722,7 +743,7 @@ export function ExternalAgentAccessPage() {
722
743
  <div className="text-xs font-medium text-ink mb-1">Other agents (JSON config)</div>
723
744
  <p className="text-meta text-ink-muted mb-1 leading-snug">
724
745
  The hosted endpoint for most clients that load servers from a JSON config —
725
- when the local server above isn't wanted.
746
+ when the local server below isn't wanted.
726
747
  </p>
727
748
  <textarea
728
749
  readOnly
@@ -735,6 +756,42 @@ export function ExternalAgentAccessPage() {
735
756
  </div>
736
757
  </details>
737
758
 
759
+ <details className="border border-line rounded">
760
+ <summary className="cursor-pointer px-3 py-2 text-xs font-medium text-ink">
761
+ Desktop agents — the local server
762
+ </summary>
763
+ <div className="px-3 pb-3 space-y-2">
764
+ <p className="text-meta text-ink-muted leading-snug">
765
+ For agents that run on your machine: Claude Code, Claude Desktop, Cursor,
766
+ Windsurf, Cline and similar. Runs this workspace as a local MCP server (needs
767
+ Node): the agent gets everything the hosted endpoint serves, plus your
768
+ plugins' local-only tools. In Claude Code:
769
+ </p>
770
+ <textarea
771
+ readOnly
772
+ value={hexisMcpClaudeCommand(workspaceUrl, reveal.plaintext)}
773
+ rows={3}
774
+ className="w-full font-mono text-meta bg-sunken border border-line rounded px-2 py-1.5 resize-none"
775
+ onFocus={(e) => e.currentTarget.select()}
776
+ />
777
+ <p className="text-meta text-ink-muted leading-snug">
778
+ On Windows, prefer the JSON config below — this one-liner assumes a POSIX
779
+ shell (macOS, Linux, WSL or Git Bash).
780
+ </p>
781
+ <p className="text-meta text-ink-muted leading-snug">
782
+ Or as a JSON config, for Claude Desktop, Cursor, Windsurf, Cline and
783
+ similar:
784
+ </p>
785
+ <textarea
786
+ readOnly
787
+ value={hexisMcpJsonSnippet(workspaceUrl, reveal.plaintext)}
788
+ rows={13}
789
+ className="w-full font-mono text-meta bg-sunken border border-line rounded px-2 py-1.5 resize-none"
790
+ onFocus={(e) => e.currentTarget.select()}
791
+ />
792
+ </div>
793
+ </details>
794
+
738
795
  <details className="border border-line rounded">
739
796
  <summary className="cursor-pointer px-3 py-2 text-xs font-medium text-ink">
740
797
  Skills as native plugins — the marketplace
@@ -756,12 +813,14 @@ export function ExternalAgentAccessPage() {
756
813
  className="w-full font-mono text-meta bg-sunken border border-line rounded px-2 py-1.5 resize-none"
757
814
  onFocus={(e) => e.currentTarget.select()}
758
815
  />
759
- <p className="text-meta text-ink-muted leading-snug">Codex installs every plugin on add:</p>
816
+ <p className="text-meta text-ink-muted leading-snug">
817
+ Codex — add the marketplace, install the plugin, sign in, check. {CODEX_LOGIN_NOTE}
818
+ </p>
760
819
  <textarea
761
820
  readOnly
762
821
  aria-label="Codex marketplace command"
763
822
  value={marketplaceCommands(reveal.plaintext).codex}
764
- rows={2}
823
+ rows={5}
765
824
  className="w-full font-mono text-meta bg-sunken border border-line rounded px-2 py-1.5 resize-none"
766
825
  onFocus={(e) => e.currentTarget.select()}
767
826
  />
@@ -0,0 +1,77 @@
1
+ import { SHOT_HEIGHT, SHOT_WIDTH, type Shot } from './claude-setup-shots';
2
+
3
+ /**
4
+ * A setup screenshot with the control to click boxed in red.
5
+ *
6
+ * The box is drawn HERE, over the image, not burned into the file: a
7
+ * re-shot screen then costs a new file and nothing else, the outline stays
8
+ * sharp at any column width, and one shot can carry two of them (the
9
+ * credential form and the button that saves it).
10
+ *
11
+ * It is `aria-hidden` on purpose. A screen reader gets the same instruction
12
+ * from `alt`, which names the control, so the box is decoration rather than
13
+ * the only carrier of "click this".
14
+ *
15
+ * The frame links to the file so a reader can open it full size: a button
16
+ * label in a 1400px screenshot is small once it is scaled into this column.
17
+ *
18
+ * `border-danger` is the design system's only red. It reads as a callout
19
+ * here rather than an error, which is the one thing a red rectangle over a
20
+ * screenshot can mean.
21
+ *
22
+ * `width`/`height` come from the shot when it declares them: the nine window
23
+ * shots share one shape, the connector shots are a panel and a dialog and do
24
+ * not. They only reserve the right box before the bytes land — the image is
25
+ * `w-full h-auto` either way — but reserving the wrong one is what makes the
26
+ * page jump.
27
+ *
28
+ * A shot marked `illustration` gets a line under the frame saying it is a
29
+ * drawing rather than a capture. It is visible text, not a `title`: the
30
+ * reader it is for is the one holding their own Claude beside the picture,
31
+ * and they need to be told before they conclude they are on the wrong
32
+ * screen.
33
+ */
34
+ export function ScreenshotStep({ shot }: { shot: Shot }) {
35
+ const frame = (
36
+ <a
37
+ href={shot.src}
38
+ target="_blank"
39
+ rel="noopener noreferrer"
40
+ title="Open this screenshot full size"
41
+ className="relative block overflow-hidden rounded-md border border-line"
42
+ >
43
+ <img
44
+ src={shot.src}
45
+ alt={shot.alt}
46
+ loading="lazy"
47
+ decoding="async"
48
+ width={shot.width ?? SHOT_WIDTH}
49
+ height={shot.height ?? SHOT_HEIGHT}
50
+ className="block h-auto w-full"
51
+ />
52
+ {shot.boxes.map((b) => (
53
+ <span
54
+ key={`${b.x}-${b.y}`}
55
+ aria-hidden="true"
56
+ className="absolute rounded-xs border-2 border-danger"
57
+ style={{ left: `${b.x}%`, top: `${b.y}%`, width: `${b.w}%`, height: `${b.h}%` }}
58
+ />
59
+ ))}
60
+ </a>
61
+ );
62
+
63
+ if (!shot.illustration) return frame;
64
+
65
+ // The note goes OUTSIDE the anchor. The boxes are positioned against that
66
+ // element, so a line of text inside it would make every percentage refer
67
+ // to a taller box than the image and slide the callouts up the screen.
68
+ return (
69
+ <div className="space-y-1">
70
+ {frame}
71
+ <p className="text-meta leading-snug text-ink-faint">
72
+ Illustration, not a capture: this is drawn to the screen's layout, so the detail on your
73
+ Claude may differ. The instruction above names the row and the control to look for.
74
+ </p>
75
+ </div>
76
+ );
77
+ }