@yuriai/web 0.2.40-beta.4 → 0.2.40-beta.5

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 (263) hide show
  1. package/dist/assets/{AgentAvatar-BmT_6apW.js → AgentAvatar-B7KbxN8Y.js} +1 -1
  2. package/dist/assets/AssistantConversationSurface-BnK_KTBO.js +3 -0
  3. package/dist/assets/{AssistantUnreadBadge-C34eOGCL.js → AssistantUnreadBadge-vu4ZhTft.js} +1 -1
  4. package/dist/assets/{AssistantView-0nXkM9VG.js → AssistantView-CEfEWUIr.js} +1 -1
  5. package/dist/assets/DiagramView-Dlzr08J_.js +1 -0
  6. package/dist/assets/{FadeInOnReveal-CCVdl9Vt.js → FadeInOnReveal-DMRmNsau.js} +1 -1
  7. package/dist/assets/{GuiPluginPage-BMt5AMqg.js → GuiPluginPage-DVug4z_p.js} +1 -1
  8. package/dist/assets/GuiPluginSurface-L43o6Xv8.js +1 -0
  9. package/dist/assets/{GuiPluginWindow-BVvzrnp1.js → GuiPluginWindow-tHXkS18H.js} +1 -1
  10. package/dist/assets/{Icon-B5nBc6dO.js → Icon-DizeYahT.js} +1 -1
  11. package/dist/assets/{ImageLoadingPlaceholder-Bv5mmf2U.js → ImageLoadingPlaceholder-BZC5m_km.js} +1 -1
  12. package/dist/assets/LoadingImage-Csw4L-Dr.js +1 -0
  13. package/dist/assets/MarkdownRenderer-D_0iKhQN.js +2 -0
  14. package/dist/assets/MarkdownRendererImpl-BZ0XgjS0.js +10 -0
  15. package/dist/assets/MarkstreamRendererImpl-DBd6Glg9.js +3 -0
  16. package/dist/assets/MobileDetailNavigation-xgwvsQuR.js +1 -0
  17. package/dist/assets/{MobileResizableSheet-D5PcZMuI.js → MobileResizableSheet-CQQ7O-2X.js} +1 -1
  18. package/dist/assets/MobileShareBridge-IO45gM2G.js +3 -0
  19. package/dist/assets/MobileSurface-DmYgZONB.js +2 -0
  20. package/dist/assets/{MultiRunWindow-rMqP99ID.js → MultiRunWindow-fJ3XfntS.js} +1 -1
  21. package/dist/assets/OnboardingScreen-MJS5T5rL.js +1 -0
  22. package/dist/assets/{OverlayScrollbar-Byx2H3pc.js → OverlayScrollbar-jtMYTn1y.js} +1 -1
  23. package/dist/assets/SettingsView-ZWFLpPSI.js +29 -0
  24. package/dist/assets/{SettingsWindow-U-RDDOS7.js → SettingsWindow-DGRmrIWz.js} +1 -1
  25. package/dist/assets/SetupTourDialog-BYbAubwA.js +1 -0
  26. package/dist/assets/TerminalView-CoJ6_9P1.js +8 -0
  27. package/dist/assets/ToolOutputDialog-5xBwOJ6a.js +16 -0
  28. package/dist/assets/VoiceSettings-CN33koSc.js +2 -0
  29. package/dist/assets/{YuriLogo-B58GIl2v.js → YuriLogo-CvyJy_R9.js} +1 -1
  30. package/dist/assets/YuriWordmark-DnFAS-Ko.js +1 -0
  31. package/dist/assets/{assistant-attachment-cache-Cmzt4xXE.js → assistant-attachment-cache-D-LmCflm.js} +1 -1
  32. package/dist/assets/bootstrap-eLlfzqAI.js +1 -0
  33. package/dist/assets/{capgoAdapter-B5NImlKh.js → capgoAdapter-CCLtBZL1.js} +1 -1
  34. package/dist/assets/{checkbox-Bdj4n5cI.js → checkbox-rOV6DjeG.js} +1 -1
  35. package/dist/assets/client-uz8O6TPX.js +7 -0
  36. package/dist/assets/{collapsible-D1JZOgJZ.js → collapsible-CKswuqAw.js} +1 -1
  37. package/dist/assets/{context-menu-DDX0ZFhc.js → context-menu-B4njwT_M.js} +1 -1
  38. package/dist/assets/{desktopHosts-DovfbQPm.js → desktopHosts-135cuRCE.js} +1 -1
  39. package/dist/assets/{desktopRelayRestore-D4pbpNKN.js → desktopRelayRestore-1aUztDPU.js} +1 -1
  40. package/dist/assets/{device-DNG0cNwQ.js → device-QL8KNSLM.js} +1 -1
  41. package/dist/assets/{diagram-C72TQWfh.js → diagram-BppQ_USn.js} +1 -1
  42. package/dist/assets/{dialog-CIKJalI5.js → dialog-Bg8MJnOV.js} +1 -1
  43. package/dist/assets/{es-D0Q_CV0t.js → es-Ba3NUCtE.js} +3 -3
  44. package/dist/assets/{fileMentionTouchSelection-tnd9RDDh.js → fileMentionTouchSelection-D-AdTJVr.js} +1 -1
  45. package/dist/assets/fileReferenceActions-cYqdsXFz.js +1 -0
  46. package/dist/assets/{fr-DrO5SAKl.js → fr-CRhp3hyT.js} +3 -3
  47. package/dist/assets/{gitApi-BI8OG_ts.js → gitApi-DVx_V1x6.js} +11 -7
  48. package/dist/assets/gitApiHttp-DvTBxvX8.js +3 -0
  49. package/dist/assets/historyImportQueries-D_9RlrLp.js +1 -0
  50. package/dist/assets/host-DrGjjO6K.js +1 -0
  51. package/dist/assets/{i18n-UaLestuf.js → i18n-RH7UieOS.js} +1 -1
  52. package/dist/assets/image-loading-DBqnxgDH.js +1 -0
  53. package/dist/assets/{input-gVHSS0EB.js → input-DRjuZMeA.js} +1 -1
  54. package/dist/assets/input-store-CjUOfpyA.js +1 -0
  55. package/dist/assets/insertionBoundaries-DZtQt2Ah.js +1 -0
  56. package/dist/assets/{ja-BNeP9_GU.js → ja-D-UPjDY2.js} +3 -3
  57. package/dist/assets/{ko-DRRFD_7l.js → ko-x-z9J5z7.js} +3 -3
  58. package/dist/assets/main-BMFY9mtb.js +2 -0
  59. package/dist/assets/main-D2s9J_jN.js +169 -0
  60. package/dist/assets/{markdownHeightCache-B-FoaQ1U.js → markdownHeightCache-BL99DlhC.js} +1 -1
  61. package/dist/assets/{markdownTheme-CHNl6tUv.js → markdownTheme-DFDWa8Gh.js} +1 -1
  62. package/dist/assets/mcpQueries-HzYMEVWd.js +1 -0
  63. package/dist/assets/miniChat-BbJ0GKpk.js +2 -0
  64. package/dist/assets/mobile-_zUth69Z.js +2 -0
  65. package/dist/assets/mobileBackNavigation--ZdrI-Yj.js +1 -0
  66. package/dist/assets/mobileConnections-C3eGEOPy.js +2 -0
  67. package/dist/assets/multirun-CDYNyLBH.js +3 -0
  68. package/dist/assets/{native-config-DqDXViVx.js → native-config-DOawZfln.js} +1 -1
  69. package/dist/assets/navigation-Ibk_Pw-q.js +2 -0
  70. package/dist/assets/{pl-BnW5wJrl.js → pl-Cqo1FJwM.js} +3 -3
  71. package/dist/assets/platform-wF65ZFgV.js +1 -0
  72. package/dist/assets/project-preview-2H-TmJkd.js +1 -0
  73. package/dist/assets/projectActions-50e_f9dI.js +1 -0
  74. package/dist/assets/projectMeta-D1Ytss9U.js +1 -0
  75. package/dist/assets/prompt-attachment-upload-BNhDXymd.js +1 -0
  76. package/dist/assets/{pt-BR-fZW8CCVQ.js → pt-BR-C930XU1k.js} +3 -3
  77. package/dist/assets/pwa-CXupOTsD.js +2 -0
  78. package/dist/assets/queue-abort-optimistic-CQXpIlq6.js +1 -0
  79. package/dist/assets/{react-DeB-Vc_L.js → react-CgRToPwO.js} +1 -1
  80. package/dist/assets/{readiness-CIlvQ-aQ.js → readiness-BfuZm6Yw.js} +2 -2
  81. package/dist/assets/relay-preview-frame-src-BPyz3nXA.js +1 -0
  82. package/dist/assets/remote-input-store-BOdCWpQY.js +1 -0
  83. package/dist/assets/remoteProjectQueries-CkxdZNw4.js +1 -0
  84. package/dist/assets/renderElectronMiniChatApp-pJ59iC34.js +2 -0
  85. package/dist/assets/renderMobileApp-BQFC-gOA.js +29 -0
  86. package/dist/assets/{runtime-file-download-DMY1k1af.js → runtime-file-download-D11Nnedg.js} +1 -1
  87. package/dist/assets/runtime-file-resource-CuLP3xp7.js +6 -0
  88. package/dist/assets/runtimeConfig-tHm7o_0I.js +2 -0
  89. package/dist/assets/{runtimeEndpointReset-BOdd_mJM.css → runtimeEndpointReset-BUGfn7y0.css} +1 -1
  90. package/dist/assets/runtimeEndpointReset-BhHWFNvo.js +150 -0
  91. package/dist/assets/safeStorage-DTOhKN0V.js +1 -0
  92. package/dist/assets/scheduledTaskNavigation-BIDtQ4wN.js +1 -0
  93. package/dist/assets/{select-BwCKwnTH.js → select-B1On-Y4Z.js} +1 -1
  94. package/dist/assets/sessionLookup-RcyTTDOy.js +1 -0
  95. package/dist/assets/sortable-tabs-strip-nD1Me06z.js +1 -0
  96. package/dist/assets/{speechSettingsQueries-C5mPRWIv.js → speechSettingsQueries-BYhNpzDJ.js} +1 -1
  97. package/dist/assets/src-BZCFf9_1.css +2 -0
  98. package/dist/assets/{store-CzVMz42v.js → store-DunGyOfe.js} +4 -4
  99. package/dist/assets/terminalApi-madXrfqA.js +1 -0
  100. package/dist/assets/{textarea-CaTDyZrS.js → textarea-Qt06OhhX.js} +1 -1
  101. package/dist/assets/{tooltip-BvZzoiqg.js → tooltip-D382RCy1.js} +1 -1
  102. package/dist/assets/tour-CQMBn8gJ.js +1 -0
  103. package/dist/assets/{types-Bm8kDgSv.js → types-CHszLAS3.js} +1 -1
  104. package/dist/assets/{uk-C4OKsNRv.js → uk-OXQSdzuT.js} +3 -3
  105. package/dist/assets/{useAppFontEffects-C9IaiJgF.js → useAppFontEffects-CqXrCJVt.js} +63 -58
  106. package/dist/assets/useAppFontEffects-K31q-1OV.css +1 -0
  107. package/dist/assets/useAssistantUIStore-jOKVcBK8.js +1 -0
  108. package/dist/assets/useDesktopWindowControlsLayout-KH4UP7Gj.js +1 -0
  109. package/dist/assets/{useDictation-Sk20Gi0T.js → useDictation-Bs7TWO9r.js} +1 -1
  110. package/dist/assets/useEffectiveDirectory-CCKRdyK9.js +1 -0
  111. package/dist/assets/useFontPreferences-CPrl1_3z.js +1 -0
  112. package/dist/assets/{useMobileHtmlPreviewStore-C03uVLfX.js → useMobileHtmlPreviewStore-EOAzZiAy.js} +1 -1
  113. package/dist/assets/useMobileNavigationStore-BNtVrnSw.js +13 -0
  114. package/dist/assets/usePluginsStore-bMuGciUE.js +1 -0
  115. package/dist/assets/useProjectRuntimeAPIs-BFCXBu2J.js +1 -0
  116. package/dist/assets/{useStreamingTextThrottle-CeKHHK13.js → useStreamingTextThrottle-C8xAqcgP.js} +1 -1
  117. package/dist/assets/{useThemeSystem-CNzUUkFn.js → useThemeSystem-C57Z9mV2.js} +1 -1
  118. package/dist/assets/useUIStore-Cfmg-aDQ.js +1 -0
  119. package/dist/assets/uuid-D-SDZijH.js +1 -0
  120. package/dist/assets/{vendor-base-ui-CzHs0bHY.js → vendor-base-ui-z2M4boRm.js} +1 -1
  121. package/dist/assets/{vendor-cmdk-C_tivUtr.js → vendor-cmdk-BgHvMv5l.js} +1 -1
  122. package/dist/assets/{vendor-dnd-kit-accessibility-BOtnpZt5.js → vendor-dnd-kit-accessibility-gVi9ga0x.js} +1 -1
  123. package/dist/assets/{vendor-dnd-kit-core-DK4OoOTr.js → vendor-dnd-kit-core-Dd5yS2-T.js} +1 -1
  124. package/dist/assets/{vendor-dnd-kit-sortable-Cv69eQm1.js → vendor-dnd-kit-sortable-CV-SGi8y.js} +1 -1
  125. package/dist/assets/{vendor-framer-motion-DDMKlXiP.js → vendor-framer-motion-CF9BQLta.js} +1 -1
  126. package/dist/assets/{vendor-markstream-react-6zxyQLCD.js → vendor-markstream-react-TwEpkgfP.js} +3 -3
  127. package/dist/assets/vendor-motion-Dv27UnOI.js +1 -0
  128. package/dist/assets/{vendor-pierre-diffs-BFiZ3IhI.js → vendor-pierre-diffs-tqo4Z3TC.js} +1 -1
  129. package/dist/assets/{vendor-react-DlzBev0S.js → vendor-react-P8wFrkcT.js} +1 -1
  130. package/dist/assets/{vendor-react-drawio-Dyg1-39Q.js → vendor-react-drawio-CQW1YP2l.js} +1 -1
  131. package/dist/assets/vendor-reactuses-core-Dyjw5sZR.js +1 -0
  132. package/dist/assets/{vendor-sonner-BEHGipm5.js → vendor-sonner-B5HgJenP.js} +1 -1
  133. package/dist/assets/{vendor-stream-diffs-wcQxoPZk.js → vendor-stream-diffs-DCMtZcS3.js} +2 -2
  134. package/dist/assets/vendor-tanstack-query-core-BSjXNgF_.js +1 -0
  135. package/dist/assets/vendor-tanstack-react-query-B-KblYBV.js +1 -0
  136. package/dist/assets/{vendor-tanstack-react-virtual-DSFNK3qc.js → vendor-tanstack-react-virtual-BkuqzrEV.js} +1 -1
  137. package/dist/assets/{vendor-zustand-vDaAPGfl.js → vendor-zustand-Cwko4FG1.js} +1 -1
  138. package/dist/assets/{zh-CN-ieAs59w6.js → zh-CN-B5X8yCZV.js} +3 -3
  139. package/dist/assets/{zh-TW-WWTW1fkP.js → zh-TW-CF6zr1fk.js} +3 -3
  140. package/dist/index.html +32 -27
  141. package/dist/mini-chat.html +32 -27
  142. package/dist/mobile.html +2 -2
  143. package/package.json +3 -2
  144. package/server/index.d.ts +19 -0
  145. package/server/index.js +35 -5
  146. package/server/lib/client-auth/remote-clients.js +11 -0
  147. package/server/lib/content-search/DOCUMENTATION.md +5 -0
  148. package/server/lib/content-search/routes.js +4 -0
  149. package/server/lib/content-search/routes.test.js +10 -0
  150. package/server/lib/event-stream/DOCUMENTATION.md +5 -0
  151. package/server/lib/event-stream/runtime.js +3 -0
  152. package/server/lib/event-stream/upstream-reader.js +1 -1
  153. package/server/lib/gui-customization/skill/references/remote-connections.md +11 -0
  154. package/server/lib/message-queue/DOCUMENTATION.md +4 -0
  155. package/server/lib/message-queue/service.js +2 -1
  156. package/server/lib/message-queue/service.test.js +11 -0
  157. package/server/lib/notifications/emitter-runtime.js +5 -0
  158. package/server/lib/opencode/DOCUMENTATION.md +28 -0
  159. package/server/lib/opencode/core-routes.js +14 -2
  160. package/server/lib/opencode/core-routes.test.js +28 -0
  161. package/server/lib/opencode/feature-routes-runtime.js +6 -1
  162. package/server/lib/opencode/proxy.js +1 -0
  163. package/server/lib/opencode/routes.js +18 -4
  164. package/server/lib/opencode/routes.test.js +22 -0
  165. package/server/lib/opencode/settings-helpers.js +26 -0
  166. package/server/lib/opencode/settings-helpers.test.js +20 -0
  167. package/server/lib/opencode/settings-runtime.js +5 -3
  168. package/server/lib/opencode/settings-runtime.test.js +35 -0
  169. package/server/lib/preview/DOCUMENTATION.md +73 -0
  170. package/server/lib/preview/file-preview-path.js +37 -0
  171. package/server/lib/preview/file-target.js +38 -0
  172. package/server/lib/preview/file-target.test.js +111 -0
  173. package/server/lib/preview/proxy-runtime.js +110 -17
  174. package/server/lib/projects/DOCUMENTATION.md +6 -0
  175. package/server/lib/relay/tunnel-host.js +1 -0
  176. package/server/lib/remote-hosts/DOCUMENTATION.md +269 -0
  177. package/server/lib/remote-hosts/configuration.js +15 -0
  178. package/server/lib/remote-hosts/deadline.js +22 -0
  179. package/server/lib/remote-hosts/deadline.test.js +64 -0
  180. package/server/lib/remote-hosts/fixtures/settings-server.mjs +26 -0
  181. package/server/lib/remote-hosts/gateway.js +644 -0
  182. package/server/lib/remote-hosts/json-lifecycle.test.js +55 -0
  183. package/server/lib/remote-hosts/preview-scope.js +23 -0
  184. package/server/lib/remote-hosts/relay-client.ts +3 -0
  185. package/server/lib/remote-hosts/routes.js +432 -0
  186. package/server/lib/remote-hosts/routes.test.js +1176 -0
  187. package/server/lib/remote-hosts/settings-production.test.js +145 -0
  188. package/server/lib/remote-hosts/store.js +110 -0
  189. package/server/lib/remote-hosts/store.test.js +33 -0
  190. package/server/lib/remote-hosts/transport.js +113 -0
  191. package/server/lib/session-folders/routes.js +1 -0
  192. package/server/lib/transcript-cache/DOCUMENTATION.md +4 -0
  193. package/server/lib/transcript-cache/routes.js +3 -0
  194. package/server/lib/transcript-cache/service.js +15 -0
  195. package/server/lib/transcript-cache/service.test.js +13 -0
  196. package/server/lib/ui-auth/DOCUMENTATION.md +18 -0
  197. package/server/lib/ui-auth/ui-auth.js +30 -2
  198. package/server/lib/ui-auth/ui-auth.test.js +46 -1
  199. package/dist/assets/AssistantConversationSurface-B-D-mLgs.js +0 -3
  200. package/dist/assets/DiagramView-BU6jWxKJ.js +0 -1
  201. package/dist/assets/GuiPluginSurface-kxAcgmf1.js +0 -1
  202. package/dist/assets/LoadingImage-BzBw_1lI.js +0 -1
  203. package/dist/assets/MarkdownRenderer-CoMohPOZ.js +0 -2
  204. package/dist/assets/MarkdownRendererImpl-DoZW1UKH.js +0 -10
  205. package/dist/assets/MarkstreamRendererImpl-B3zd5x2O.js +0 -3
  206. package/dist/assets/MobileDetailNavigation-bEZ_NA03.js +0 -1
  207. package/dist/assets/MobileShareBridge-Cjukxazk.js +0 -3
  208. package/dist/assets/MobileTabPageHeader-Da1maXx-.js +0 -2
  209. package/dist/assets/OnboardingScreen-CZhqHzAj.js +0 -1
  210. package/dist/assets/SettingsView-7Bea2DvF.js +0 -29
  211. package/dist/assets/SetupTourDialog-CKec5tUy.js +0 -1
  212. package/dist/assets/TerminalView-CS1oSAuY.js +0 -8
  213. package/dist/assets/ToolOutputDialog-BWhrFvvI.js +0 -10
  214. package/dist/assets/VoiceSettings-7aFmJq9Z.js +0 -2
  215. package/dist/assets/YuriWordmark--S-QEpRp.js +0 -1
  216. package/dist/assets/appThemeRegistry-LyWTE-mT.js +0 -1
  217. package/dist/assets/bootstrap-BhC95qVC.js +0 -1
  218. package/dist/assets/fileQueries-D9l0crnM.js +0 -1
  219. package/dist/assets/fileReferenceActions-BmquJskG.js +0 -1
  220. package/dist/assets/gitApiHttp-D4d-rgcR.js +0 -9
  221. package/dist/assets/historyImportQueries-DkB2_92i.js +0 -1
  222. package/dist/assets/host-kMLXU0hK.js +0 -1
  223. package/dist/assets/image-loading-BrDob6MW.js +0 -1
  224. package/dist/assets/insertionBoundaries-B-yZI6iY.js +0 -1
  225. package/dist/assets/main-BfAN93rT.js +0 -169
  226. package/dist/assets/main-DYWwmI_W.js +0 -2
  227. package/dist/assets/mcpQueries-CehWHIB1.js +0 -1
  228. package/dist/assets/miniChat-BlkcLQBr.js +0 -2
  229. package/dist/assets/mobile-I3Xe5NtO.js +0 -2
  230. package/dist/assets/mobileBackNavigation-BFUH-c-G.js +0 -1
  231. package/dist/assets/mobileConnections-BFvtbJXX.js +0 -2
  232. package/dist/assets/multirun-DdEjp77z.js +0 -3
  233. package/dist/assets/pathNormalization-ewtPqJWn.js +0 -1
  234. package/dist/assets/platform-DMsFWy1a.js +0 -1
  235. package/dist/assets/projectActions-C-9Z8R7y.js +0 -1
  236. package/dist/assets/projectMeta-BKgum5WN.js +0 -1
  237. package/dist/assets/pwa-BvKUY4Hk.js +0 -2
  238. package/dist/assets/queue-abort-optimistic-BcbiNk8t.js +0 -1
  239. package/dist/assets/renderElectronMiniChatApp-DIjWdFHu.js +0 -2
  240. package/dist/assets/renderMobileApp-CE0QyOH0.js +0 -29
  241. package/dist/assets/runtime-file-resource-CL7EVzOG.js +0 -2
  242. package/dist/assets/runtimeConfig-uhjQn4kK.js +0 -2
  243. package/dist/assets/runtimeEndpointReset-DezNESKT.js +0 -149
  244. package/dist/assets/scheduledTaskNavigation-FMDNRUnX.js +0 -1
  245. package/dist/assets/sessionLookup-DzKZsy-W.js +0 -1
  246. package/dist/assets/sortable-tabs-strip-m5JQrTx4.js +0 -1
  247. package/dist/assets/src-HgtAe3Q4.css +0 -2
  248. package/dist/assets/terminalApi-DK4KmfFn.js +0 -1
  249. package/dist/assets/touch-gestures-CErgaXZ7.js +0 -1
  250. package/dist/assets/tour-DDI0Zg7l.js +0 -1
  251. package/dist/assets/useAppFontEffects-RpgNbjA4.css +0 -1
  252. package/dist/assets/useAssistantUIStore-nNYL140o.js +0 -1
  253. package/dist/assets/useDesktopWindowControlsLayout-C3M12PjJ.js +0 -1
  254. package/dist/assets/useEffectiveDirectory-Do4UqfZR.js +0 -1
  255. package/dist/assets/useFontPreferences-DxzruDDQ.js +0 -1
  256. package/dist/assets/useMobileNavigationStore-InwdmuDX.js +0 -17
  257. package/dist/assets/usePluginsStore-BH4-CNcj.js +0 -1
  258. package/dist/assets/useUIStore-vvNwcOk3.js +0 -1
  259. package/dist/assets/useWorkerHighlightedLines-0XahwAbS.js +0 -7
  260. package/dist/assets/vendor-motion-C9oiAdx-.js +0 -1
  261. package/dist/assets/vendor-reactuses-core-CuTmqEMK.js +0 -1
  262. package/dist/assets/vendor-tanstack-query-core-Y_YoRHtC.js +0 -1
  263. package/dist/assets/vendor-tanstack-react-query-B-Wpqq5J.js +0 -1
@@ -4,6 +4,18 @@ import { REMOTE_CONNECTIONS_SKILL_PATH } from '../gui-customization/remote-conne
4
4
  import { PROJECTS_SKILL_PATH } from '../gui-customization/projects.js';
5
5
  import { MESSAGE_QUEUE_ADMISSION_HTTP_MAX_BYTES } from '../message-queue/service.js';
6
6
 
7
+ const decodeRequestPathForClassification = (pathname) => typeof pathname === 'string'
8
+ ? pathname.replace(/%([a-f0-9]{2})/gi, (_match, hex) => String.fromCharCode(Number.parseInt(hex, 16))) : '';
9
+ const isFilePreviewRequestPath = (pathname) => /^\/api\/(?:hosts\/[^/]+\/api\/)?preview\/proxy\/[^/]+\/_file(?:\/|$)/i
10
+ .test(decodeRequestPathForClassification(pathname));
11
+
12
+ export const redactRequestPathForLog = (pathname) => {
13
+ if (isFilePreviewRequestPath(pathname)) return '/api/preview/proxy/_file/[preview]/[url-auth]/[resource]';
14
+ // Invalid envelopes can still contain credentials; never log a preview tail.
15
+ if (/\/api\/preview\/proxy(?:\/|$)/i.test(decodeRequestPathForClassification(pathname))) return '/api/preview/proxy/[redacted]';
16
+ return typeof pathname === 'string' ? pathname : '';
17
+ };
18
+
7
19
  const parseLoopbackUrl = (rawUrl) => {
8
20
  if (typeof rawUrl !== 'string') {
9
21
  return null;
@@ -669,7 +681,7 @@ export const registerAuthAndAccessRoutes = (app, dependencies) => {
669
681
  // preview proxy validates against the registered target id/TTL. Let those
670
682
  // requests reach that stricter check instead of failing the global UI auth
671
683
  // gate when the short-lived browser URL auth token expires.
672
- if (getRequestPathname(req).startsWith('/api/preview/proxy/') && hasPreviewProxyCredential(req)) {
684
+ if (requestPathname.startsWith('/api/preview/proxy/') && !isFilePreviewRequestPath(requestPathname) && hasPreviewProxyCredential(req)) {
673
685
  return next();
674
686
  }
675
687
 
@@ -1250,7 +1262,7 @@ export const registerCommonRequestMiddleware = (app, dependencies) => {
1250
1262
 
1251
1263
  app.use((req, _res, next) => {
1252
1264
  if (verboseRequestLogs) {
1253
- console.log(`${new Date().toISOString()} - ${req.method} ${req.path}`);
1265
+ console.log(`${new Date().toISOString()} - ${req.method} ${redactRequestPathForLog(req.path)}`);
1254
1266
  }
1255
1267
  next();
1256
1268
  });
@@ -328,6 +328,30 @@ describe('core-routes', () => {
328
328
  expect(dependencies.gracefulShutdown).not.toHaveBeenCalled();
329
329
  });
330
330
 
331
+ it('redacts preview path credentials before verbose request logging, including malformed envelopes', async () => {
332
+ const log = vi.spyOn(console, 'log').mockImplementation(() => {});
333
+ const app = express();
334
+ registerCommonRequestMiddleware(app, { express, verboseRequestLogs: true });
335
+ app.use((_req, res) => res.status(204).end());
336
+ const previewToken = 'c'.repeat(32);
337
+ const urlToken = `yuri_url_${'d'.repeat(32)}`;
338
+ const suffix = `${previewToken}/${urlToken}/index.html`;
339
+ try {
340
+ for (const route of [
341
+ `/api/preview/proxy/${'a'.repeat(32)}/_file/${suffix}`,
342
+ `/api/hosts/remote/api/preview/proxy/bad-id/_file/${suffix}`,
343
+ `/api/preview/proxy/bad-id/%5Ffile/${suffix}`,
344
+ `/api/preview/proxy/bad-id/malformed/${suffix}`,
345
+ ]) await request(app).get(route).expect(204);
346
+ const output = log.mock.calls.map((args) => args.join(' ')).join('\n');
347
+ expect(log).toHaveBeenCalledTimes(4);
348
+ expect(output).not.toContain(previewToken);
349
+ expect(output).not.toContain(urlToken);
350
+ expect(output).toContain('[preview]/[url-auth]');
351
+ expect(output).toContain('[redacted]');
352
+ } finally { log.mockRestore(); }
353
+ });
354
+
331
355
  // Global raw config saves send { content: "<jsonc string>" }. Without this
332
356
  // prefix in the JSON middleware allowlist, PUT arrives with an empty body and
333
357
  // the handler rejects with "Configuration content must be a string".
@@ -1322,6 +1346,10 @@ describe('core-routes', () => {
1322
1346
  .get('/api/yuri/transcript-cache/session?yuri_preview_token=preview-secret')
1323
1347
  .expect(401, 'Authentication required');
1324
1348
  expect(requireAuth).toHaveBeenCalledTimes(2);
1349
+ for (const suffix of ['_file/target-token/-/index.html', '_file', '%5Ffile/bad-target/live-token/file.html']) {
1350
+ await request(app).get(`/api/preview/proxy/abc123/${suffix}?yuri_preview_token=arbitrary`)
1351
+ .set('Cookie', 'yuri_preview_token=arbitrary').expect(401, 'Authentication required');
1352
+ }
1325
1353
  });
1326
1354
 
1327
1355
  it('requires the managed bridge capability independently from UI auth', async () => {
@@ -66,7 +66,8 @@ import { scanClawdHubPage } from '../skills-catalog/clawdhub/scan.js';
66
66
  import { installSkillsFromClawdHub } from '../skills-catalog/clawdhub/install.js';
67
67
 
68
68
  /** Fan-out an Yuri product SSE tip to every /api/yuri/events client. */
69
- export const createYuriEventBroadcaster = ({ getYuriEventClients, writeSseEvent }) => (event) => {
69
+ export const createYuriEventBroadcaster = ({ getYuriEventClients, writeSseEvent, onEvent }) => (event) => {
70
+ onEvent?.(event);
70
71
  const clients = getYuriEventClients();
71
72
  for (const client of clients) {
72
73
  try {
@@ -184,6 +185,7 @@ export const createFeatureRoutesRuntime = (dependencies) => {
184
185
  }
185
186
 
186
187
  registerOpenCodeRoutes(app, {
188
+ getRemoteProjectState: routeDependencies.getRemoteProjectState,
187
189
  crypto,
188
190
  clientReloadDelayMs,
189
191
  getOpenCodeResolutionSnapshot,
@@ -499,6 +501,9 @@ export const createFeatureRoutesRuntime = (dependencies) => {
499
501
  const broadcastYuriEvent = createYuriEventBroadcaster({
500
502
  getYuriEventClients,
501
503
  writeSseEvent,
504
+ onEvent: (event) => {
505
+ if (/^yuri:session-(unread|order|folders)-changed$/.test(event?.type || '')) broadcastGlobalUiEvent?.(event);
506
+ },
502
507
  });
503
508
  sessionUnreadRuntime = createSessionUnreadRuntime({
504
509
  store: createSessionUnreadStore({
@@ -748,6 +748,7 @@ export const registerOpenCodeProxy = (app, deps) => {
748
748
 
749
749
  if (subscribeGlobalUiEvent) {
750
750
  unsubscribeHostEvents = subscribeGlobalUiEvent((payload, options = {}) => {
751
+ if (options.targetFilter && !options.targetFilter(res)) return;
751
752
  const envelope = { directory: options.directory || 'global', payload };
752
753
  const block = `data: ${JSON.stringify(envelope)}\n\n`;
753
754
  const filtered = outboundSseFilter ? filterSseBlock(block, outboundSseFilter) : block;
@@ -38,6 +38,7 @@ export const registerOpenCodeRoutes = (app, dependencies) => {
38
38
  readSettingsFromDisk,
39
39
  readSettingsFromDiskMigrated,
40
40
  persistSettings,
41
+ getRemoteProjectState = () => null,
41
42
  validateDirectoryPath,
42
43
  resolveProjectDirectory,
43
44
  getProviderSources,
@@ -63,6 +64,13 @@ export const registerOpenCodeRoutes = (app, dependencies) => {
63
64
  } = dependencies;
64
65
 
65
66
  const upgradeOperation = createUpgradeOperationState();
67
+ const projectSettingsResponse = (response) => {
68
+ const state = getRemoteProjectState();
69
+ if (!state) return response;
70
+ return { ...response, hasRemoteProjects: state.hasRemoteProjects,
71
+ hubProjectLayout: response.hubProjectLayout?.hubId === state.hubId ? response.hubProjectLayout
72
+ : { hubId: state.hubId, order: [], collapsed: {} } };
73
+ };
66
74
  const resolveDataDir = () => yuriDataDir || resolveYuriDataDir();
67
75
 
68
76
  let authLibrary = null;
@@ -296,7 +304,7 @@ export const registerOpenCodeRoutes = (app, dependencies) => {
296
304
  app.get('/api/config/settings', async (req, res) => {
297
305
  try {
298
306
  const settings = await readSettingsFromDiskMigrated();
299
- const response = formatSettingsResponse(settings);
307
+ const response = projectSettingsResponse(formatSettingsResponse(settings));
300
308
  res.json(req.query?.bootstrap === 'true' ? projectBootstrapSettingsResponse(response) : response);
301
309
  } catch (error) {
302
310
  console.error('Failed to read settings:', error);
@@ -307,7 +315,7 @@ export const registerOpenCodeRoutes = (app, dependencies) => {
307
315
  app.get('/api/config/settings/bootstrap', async (_req, res) => {
308
316
  try {
309
317
  const settings = await readSettingsFromDiskMigrated();
310
- const response = formatSettingsResponse(settings);
318
+ const response = projectSettingsResponse(formatSettingsResponse(settings));
311
319
  res.json(projectBootstrapSettingsResponse(response));
312
320
  } catch (error) {
313
321
  console.error('Failed to read bootstrap settings:', error);
@@ -610,7 +618,13 @@ export const registerOpenCodeRoutes = (app, dependencies) => {
610
618
  app.put('/api/config/settings', async (req, res) => {
611
619
  try {
612
620
  const changes = req.body ?? {};
613
- const updated = await persistSettings(changes);
621
+ if (Object.hasOwn(changes, 'hubProjectLayout')) {
622
+ const state = getRemoteProjectState();
623
+ if (typeof changes.hubProjectLayout?.hubId !== 'string') return res.status(400).json({ error: 'Invalid Hub project layout' });
624
+ if (!state || changes.hubProjectLayout.hubId !== state.hubId) return res.status(409).json({ error: 'Hub project layout belongs to another Hub' });
625
+ }
626
+ const updated = projectSettingsResponse(await persistSettings(changes));
627
+ if (Object.prototype.hasOwnProperty.call(changes, 'projects')) app.emit('yuri:projects-changed');
614
628
  // Only after a successful persist — failed saves must not apply runtime flags.
615
629
  if (
616
630
  typeof onSettingsPersisted === 'function'
@@ -626,7 +640,7 @@ export const registerOpenCodeRoutes = (app, dependencies) => {
626
640
  } catch (error) {
627
641
  console.error('[API:PUT /api/config/settings] Failed to save settings:', error);
628
642
  console.error('[API:PUT /api/config/settings] Error stack:', error.stack);
629
- res.status(500).json({ error: 'Failed to save settings' });
643
+ res.status(error?.status === 400 ? 400 : 500).json({ error: 'Failed to save settings' });
630
644
  }
631
645
  });
632
646
 
@@ -37,6 +37,28 @@ const createDependencies = ({ formatSettingsResponse }) => ({
37
37
  });
38
38
 
39
39
  describe('settings route', () => {
40
+ it('projects SQLite discovery and current-Hub layout without reformatting persisted public settings', async () => {
41
+ let hasRemoteProjects = false;
42
+ const dependencies = createDependencies({ formatSettingsResponse: vi.fn(() => ({ hasRemoteProjects: true,
43
+ hubProjectLayout: { hubId: 'foreign', order: ['other'], collapsed: {} } })) });
44
+ dependencies.getRemoteProjectState = () => ({ hubId: 'hub', hasRemoteProjects });
45
+ dependencies.persistSettings.mockResolvedValue({ hasSummaryCustomAPIToken: true,
46
+ hubProjectLayout: { hubId: 'hub', order: ['local'], collapsed: {} } });
47
+ const app = express(); app.use(express.json()); registerOpenCodeRoutes(app, dependencies);
48
+ const cold = await request(app).get('/api/config/settings/bootstrap').expect(200);
49
+ expect(cold.body).toEqual({ schemaVersion: 1, hasRemoteProjects: false });
50
+ hasRemoteProjects = true;
51
+ expect((await request(app).get('/api/config/settings?bootstrap=true').expect(200)).body.hasRemoteProjects).toBe(true);
52
+ expect((await request(app).get('/api/config/settings').expect(200)).body.hubProjectLayout)
53
+ .toEqual({ hubId: 'hub', order: [], collapsed: {} });
54
+ const layout = { hubId: 'hub', order: ['local'], collapsed: {} };
55
+ const written = await request(app).put('/api/config/settings').send({ hubProjectLayout: layout }).expect(200);
56
+ expect(written.body).toMatchObject({ hasSummaryCustomAPIToken: true, hasRemoteProjects: true, hubProjectLayout: layout });
57
+ expect(dependencies.formatSettingsResponse).toHaveBeenCalledTimes(3);
58
+ dependencies.persistSettings.mockClear();
59
+ await request(app).put('/api/config/settings').send({ hubProjectLayout: { ...layout, hubId: 'foreign' } }).expect(409);
60
+ expect(dependencies.persistSettings).not.toHaveBeenCalled();
61
+ });
40
62
  it('returns the full formatted response without the bootstrap query', async () => {
41
63
  const formatted = { themeId: 'default', summaryCustomAPIToken: 'response-secret-sentinel' };
42
64
  const formatSettingsResponse = vi.fn(() => formatted);
@@ -26,6 +26,7 @@ export const projectBootstrapSettingsResponse = (response) => {
26
26
  copyString('defaultVariant');
27
27
  copyString('defaultAgent');
28
28
  copyBoolean('autoCreateWorktree');
29
+ copyBoolean('hasRemoteProjects');
29
30
  copyBoolean('gitmojiEnabled');
30
31
  copyBoolean('defaultFileViewerPreview');
31
32
  copyString('zenModel');
@@ -180,6 +181,20 @@ export const createSettingsHelpers = (dependencies) => {
180
181
  const candidate = payload;
181
182
  const result = {};
182
183
 
184
+ if (Object.hasOwn(candidate, 'hubProjectLayout')) {
185
+ const layout = candidate.hubProjectLayout;
186
+ const validId = (id) => typeof id === 'string' && id.length > 0 && id.length <= 512;
187
+ if (!layout || typeof layout !== 'object' || Array.isArray(layout)
188
+ || !validId(layout.hubId) || !Array.isArray(layout.order) || layout.order.length > 10000
189
+ || !layout.order.every(validId) || !layout.collapsed || typeof layout.collapsed !== 'object'
190
+ || Array.isArray(layout.collapsed) || Object.keys(layout.collapsed).length > 10000
191
+ || !Object.entries(layout.collapsed).every(([id, value]) => validId(id) && typeof value === 'boolean')) {
192
+ throw Object.assign(new Error('Invalid Hub project layout'), { status: 400 });
193
+ }
194
+ result.hubProjectLayout = { hubId: layout.hubId, order: [...new Set(layout.order)],
195
+ collapsed: Object.fromEntries(Object.entries(layout.collapsed)) };
196
+ }
197
+
183
198
  if (typeof candidate.themeId === 'string' && candidate.themeId.length > 0) {
184
199
  result.themeId = candidate.themeId;
185
200
  }
@@ -904,6 +919,17 @@ export const createSettingsHelpers = (dependencies) => {
904
919
  typographySizes: nextTypographySizes
905
920
  };
906
921
 
922
+ if (changes.hubProjectLayout) {
923
+ const incoming = changes.hubProjectLayout;
924
+ const prior = current.hubProjectLayout?.hubId === incoming.hubId ? current.hubProjectLayout : null;
925
+ next.hubProjectLayout = { hubId: incoming.hubId,
926
+ order: [...new Set([...incoming.order, ...(prior?.order || [])])],
927
+ collapsed: { ...prior?.collapsed, ...incoming.collapsed } };
928
+ if (next.hubProjectLayout.order.length > 10000 || Object.keys(next.hubProjectLayout.collapsed).length > 10000) {
929
+ throw Object.assign(new Error('Hub project layout exceeds capacity'), { status: 400 });
930
+ }
931
+ }
932
+
907
933
  return next;
908
934
  };
909
935
 
@@ -39,6 +39,26 @@ const createTestHelpersWithRealSanitizers = () => {
39
39
  };
40
40
 
41
41
  describe('settings helpers', () => {
42
+ it('merges Hub-only layout without replacing projects, references or omitted collapse entries', () => {
43
+ const helpers = createTestHelpers();
44
+ const current = { projects: [{ id: 'local', path: '/local' }],
45
+ hubProjectLayout: { hubId: 'hub-a', order: ['local', 'remote-a', 'remote-b'], collapsed: { 'remote-a': true, 'remote-b': true } } };
46
+ const changes = helpers.sanitizeSettingsUpdate({ hasRemoteProjects: true,
47
+ hubProjectLayout: { hubId: 'hub-a', order: ['remote-b', 'remote-b'], collapsed: { 'remote-a': false } } });
48
+ expect(changes).not.toHaveProperty('hasRemoteProjects');
49
+ const merged = helpers.mergePersistedSettings(current, changes);
50
+ expect(merged.projects).toEqual(current.projects);
51
+ expect(merged.hubProjectLayout).toEqual({ hubId: 'hub-a', order: ['remote-b', 'local', 'remote-a'],
52
+ collapsed: { 'remote-a': false, 'remote-b': true } });
53
+ expect(helpers.mergePersistedSettings(current, { hubProjectLayout: { hubId: 'hub-b', order: [], collapsed: {} } }).hubProjectLayout)
54
+ .toEqual({ hubId: 'hub-b', order: [], collapsed: {} });
55
+ for (const layout of [null, [], {}, { hubId: 'a', order: [], collapsed: [] },
56
+ { hubId: 'a', order: [null], collapsed: {} }, { hubId: 'a', order: [], collapsed: { x: 'true' } }]) {
57
+ expect(() => helpers.sanitizeSettingsUpdate({ hubProjectLayout: layout })).toThrow('Invalid Hub project layout');
58
+ }
59
+ expect(helpers.projectBootstrapSettingsResponse({ hasRemoteProjects: false, hubProjectLayout: current.hubProjectLayout }))
60
+ .toEqual({ schemaVersion: 1, hasRemoteProjects: false });
61
+ });
42
62
  it('ignores retired editor toolbar preferences in updates and stored settings', () => {
43
63
  const helpers = createTestHelpers();
44
64
  for (const expandedEditorToolbar of [true, false, null, {}, 'invalid']) {
@@ -853,10 +853,11 @@ export const createSettingsRuntime = (deps) => {
853
853
 
854
854
  const persistSettings = async (changes) => runPersistedWrite(async () => {
855
855
  const updateCurrent = typeof changes === 'function';
856
- const stored = updateCurrent
856
+ const strictRead = updateCurrent || Object.hasOwn(changes || {}, 'hubProjectLayout');
857
+ const stored = strictRead
857
858
  ? await readSettingsFromDiskStrict()
858
859
  : await readSettingsFromDisk();
859
- if (updateCurrent && Array.isArray(stored)) throw new Error('Settings file is malformed (array payload)');
860
+ if (strictRead && Array.isArray(stored)) throw new Error('Settings file is malformed (array payload)');
860
861
  const { settings: current } = await migrateSettingsFromLegacyLastDirectory(stored);
861
862
  if (typeof changes === 'function') changes = await changes(current);
862
863
  // Log field names only — changes can carry credentials (UI password,
@@ -908,7 +909,8 @@ export const createSettingsRuntime = (deps) => {
908
909
 
909
910
  await writeSettingsToDiskUnlocked(next);
910
911
  if (JSON.stringify(stored.projects) !== JSON.stringify(next.projects)
911
- || stored.projectSortOrder !== next.projectSortOrder) {
912
+ || stored.projectSortOrder !== next.projectSortOrder
913
+ || JSON.stringify(stored.hubProjectLayout) !== JSON.stringify(next.hubProjectLayout)) {
912
914
  onProjectOrderChanged?.();
913
915
  }
914
916
  return formatSettingsResponse(next);
@@ -6,6 +6,7 @@ import path from 'path';
6
6
  import { createProjectIdFromPath } from '../projects/project-id.js';
7
7
  import { createSettingsRuntime } from './settings-runtime.js';
8
8
  import { createSettingsNormalizationRuntime } from './settings-normalization-runtime.js';
9
+ import { createSettingsHelpers } from './settings-helpers.js';
9
10
 
10
11
  const createRuntime = async (overrides = {}) => {
11
12
  const tempRoot = await fsPromises.mkdtemp(path.join(os.tmpdir(), 'yuri-settings-runtime-'));
@@ -36,6 +37,40 @@ const createRuntime = async (overrides = {}) => {
36
37
  };
37
38
 
38
39
  describe('settings runtime', () => {
40
+ it('serializes real Hub layout merge and emits tips only after changed commits; failure retains disk', async () => {
41
+ const helpers = createSettingsHelpers({ normalizePathForPersistence: value => value,
42
+ normalizeDirectoryPath: value => value, sanitizeTypographySizesPartial: () => undefined,
43
+ normalizeStringArray: value => value, sanitizeModelRefs: () => undefined,
44
+ sanitizeSkillCatalogs: () => undefined, sanitizeProjects: value => value });
45
+ let tips = 0; let fail = false;
46
+ const { runtime, settingsFilePath, cleanup } = await createRuntime({
47
+ sanitizeSettingsUpdate: helpers.sanitizeSettingsUpdate, mergePersistedSettings: helpers.mergePersistedSettings,
48
+ onProjectOrderChanged: () => { tips++; },
49
+ fsPromises: { ...fsPromises, rename: async (...args) => { if (fail) throw new Error('layout write failed'); return fsPromises.rename(...args); } },
50
+ });
51
+ try {
52
+ const first = { hubId: 'hub', order: ['local', 'remote-a'], collapsed: { local: true } };
53
+ await runtime.persistSettings({ hubProjectLayout: first });
54
+ expect(tips).toBe(1);
55
+ await runtime.persistSettings({ hubProjectLayout: first });
56
+ expect(tips).toBe(1);
57
+ await Promise.all([
58
+ runtime.persistSettings({ hubProjectLayout: { hubId: 'hub', order: ['remote-b'], collapsed: { 'remote-b': true } } }),
59
+ runtime.persistSettings({ hubProjectLayout: { hubId: 'hub', order: ['remote-a'], collapsed: { local: false } } }),
60
+ ]);
61
+ const expected = { hubId: 'hub', order: ['remote-a', 'remote-b', 'local'], collapsed: { local: false, 'remote-b': true } };
62
+ expect((await runtime.readSettingsFromDisk()).hubProjectLayout).toEqual(expected);
63
+ expect(tips).toBe(3);
64
+ fail = true;
65
+ await expect(runtime.persistSettings({ hubProjectLayout: first })).rejects.toThrow('layout write failed');
66
+ expect(tips).toBe(3);
67
+ expect((await runtime.readSettingsFromDisk()).hubProjectLayout).toEqual(expected);
68
+ await fsPromises.writeFile(settingsFilePath, '{malformed');
69
+ await expect(runtime.persistSettings({ hubProjectLayout: first })).rejects.toThrow();
70
+ expect(await fsPromises.readFile(settingsFilePath, 'utf8')).toBe('{malformed');
71
+ expect(tips).toBe(3);
72
+ } finally { await cleanup(); }
73
+ });
39
74
  it.each(['read-first', 'write-first', 'functional-write-first'])(
40
75
  'keeps a fresh home-directory bootstrap out of the project registry (%s)', async (order) => {
41
76
  const { runtime, tempRoot, cleanup } = await createRuntime({
@@ -0,0 +1,73 @@
1
+ # Preview targets and resource graphs
2
+
3
+ `proxy-runtime.js` owns the existing `/api/preview/targets` registry and
4
+ `/api/preview/proxy/:id` HTTP/WS transport. Network targets retain the existing
5
+ loopback-origin normalization, resource rewrite, CSP/bridge and redirect behavior.
6
+
7
+ ## Project file target
8
+
9
+ `POST /api/preview/targets` accepts `{ kind: 'file', directory, path, ttlMs? }`.
10
+ `directory` and `path` are absolute physical paths, not serialized Location keys.
11
+ Both are canonicalized; the HTML entry must be inside the directory. A Remote
12
+ Project's Hub gateway first obtains its registered project/worktree authority and
13
+ replaces the submitted root with that authority. A caller cannot grant itself an
14
+ arbitrary remote directory. The response is `{ id, kind: 'file', proxyBasePath,
15
+ entryPath, previewToken, expiresAt }`; `entryPath` is encoded project-relative path.
16
+
17
+ File browser URLs use:
18
+
19
+ ```
20
+ [Host prefix]/api/preview/proxy/:id/_file/:previewToken/:shortUrlAuthToken/:relativePath
21
+ ```
22
+
23
+ All ordinary relative references resolve in the browser: HTML attributes, CSS
24
+ `@import`/`url()`, JS static/dynamic imports and fetch, and nested documents retain
25
+ the entire target/auth/Host prefix. There is no second static server, global
26
+ runtime switch, server-side HTML parser, resource crawler or Relay `srcDoc`
27
+ fallback. Existing preview rewriting handles root-relative references; the
28
+ existing request bridge recognizes the file envelope for root fetch/Request/URL
29
+ inputs. Arbitrary external origins are not rewritten or given Yuri tokens.
30
+
31
+ `file-preview-path.js` is the shared strict envelope parser. It rejects dot
32
+ segments, encoded slash/backslash/control and malformed URI escapes. The only
33
+ credential format is the existing short URL token (`yuri_url_` plus 32 base64url
34
+ characters). GET/HEAD authentication reads that segment through the normal
35
+ ui-auth authorization/revocation gates; the preview token alone is not ordinary
36
+ UI authentication. Explicit bearer auth takes precedence. A `-` segment carries
37
+ no credential and never bypasses normal authentication.
38
+
39
+ After Hub authorization, the Remote Host gateway replaces the Hub URL token with
40
+ `-` before forwarding over the existing authenticated direct/Relay Host transport.
41
+ The Remote's root-resource rewrite emits `REMOTE_PREVIEW_TOKEN_MARKER`, never the
42
+ Hub credential; the existing Hub streaming substitution restores a short Hub-side
43
+ token. Plain relative URLs need no token serialization in response bodies.
44
+ Responses are `no-store`, `no-referrer`, and `nosniff`; the Hub preserves these
45
+ policies. Tokens must never enter logs or external-site URLs/referrers.
46
+
47
+ Every descendant canonicalizes its path again and rejects symlinks outside the
48
+ target root. Files are bounded to 100 MiB. Binary assets stream through Express;
49
+ text HTML/CSS/JS uses the existing preview rewrite/bridge. Directory resources
50
+ resolve `index.html`. Files permit GET/HEAD only; file WebSockets are explicitly
51
+ rejected, including when the normal HTTP preview proxy has attached its automatic
52
+ upgrade listener. Normal network-preview WebSockets are unchanged.
53
+
54
+ `DELETE /api/preview/targets/:id` accepts `{ previewToken }` through normal
55
+ session/client authorization and origin checks. It is idempotent for an already
56
+ missing target. Revocation destroys active responses; expiry checks every request
57
+ and terminates active file responses at the deadline. Client disconnect aborts
58
+ file reads/streams through the existing transport chain. A failed cleanup after
59
+ the captured runtime ends cannot be sent using the next runtime's credentials;
60
+ the old server's grant remains bounded by expiry.
61
+
62
+ ## Verification
63
+
64
+ `file-target.test.js` exercises real production Hub + two Host listeners, real
65
+ ui-auth/client revocation, registered directory gateway, every resource kind,
66
+ symlink rejection, Host mismatch, target and URL-token expiry, revoke, and 80 MiB
67
+ stream cancellation. A separate case uses the real E2EE Relay transport for Host
68
+ A, while Host B stays direct. `proxy-runtime.test.js` retains network-preview
69
+ regressions. `scripts/remote-project-file-preview-smoke.mjs` exports the same
70
+ isolated fixture for browser/platform checks and records a source manifest.
71
+
72
+ Browser evidence is not Electron main/preload or Capacitor WKWebView evidence.
73
+ Those platforms require separate application/gateway/native network checks.
@@ -0,0 +1,37 @@
1
+ import { REMOTE_PREVIEW_TOKEN_MARKER } from '../remote-hosts/preview-scope.js';
2
+
3
+ const URL_TOKEN = /^yuri_url_[A-Za-z0-9_-]{32}$/;
4
+ const TOKEN_SEGMENT = /^(?:yuri_url_[A-Za-z0-9_-]{32}|-|__YURI_HUB_URL_AUTH__)$/;
5
+
6
+ /** Only the file-preview envelope may carry URL auth in a path, never other APIs. */
7
+ export const parseFilePreviewPath = (pathname) => {
8
+ if (typeof pathname !== 'string' || /[\\?#\u0000-\u0020]/.test(pathname)) return null;
9
+ const match = /^(\/api\/hosts\/[A-Za-z0-9._~%-]{1,256})?\/api\/preview\/proxy\/([a-f0-9]{16,64})\/_file\/([a-f0-9]{32})\/([^/]+)(\/.*)$/i.exec(pathname);
10
+ if (!match || !TOKEN_SEGMENT.test(match[4])) return null;
11
+ try {
12
+ for (const segment of pathname.split('/').slice(1)) {
13
+ const decoded = decodeURIComponent(segment);
14
+ if (decoded === '.' || decoded === '..' || /[\\/\u0000-\u001f\u007f]/.test(decoded)) return null;
15
+ }
16
+ } catch { return null; }
17
+ const resourcePath = match[5];
18
+ const basePath = pathname.slice(0, -resourcePath.length);
19
+ return { hostPrefix: match[1] || '', id: match[2], previewToken: match[3], urlAuthToken: match[4], resourcePath, basePath };
20
+ };
21
+
22
+ export const readFilePreviewUrlAuthToken = (pathname) => {
23
+ const parsed = parseFilePreviewPath(pathname);
24
+ return parsed && URL_TOKEN.test(parsed.urlAuthToken) ? parsed.urlAuthToken : '';
25
+ };
26
+
27
+ /** Hub must strip its credential before the existing authenticated Host transport. */
28
+ export const replaceFilePreviewUrlAuthToken = (pathname, replacement = '-') => {
29
+ const parsed = parseFilePreviewPath(pathname);
30
+ if (!parsed || !TOKEN_SEGMENT.test(replacement)) return null;
31
+ return `${parsed.basePath.slice(0, -parsed.urlAuthToken.length)}${replacement}${parsed.resourcePath}`;
32
+ };
33
+
34
+ export const filePreviewResponseBase = (parsed, hostPrefix) => {
35
+ const token = hostPrefix ? REMOTE_PREVIEW_TOKEN_MARKER : parsed.urlAuthToken;
36
+ return `${hostPrefix}/api/preview/proxy/${parsed.id}/_file/${parsed.previewToken}/${token}`;
37
+ };
@@ -0,0 +1,38 @@
1
+ import fs from 'node:fs/promises';
2
+ import path from 'node:path';
3
+
4
+ const inside = (root, file) => {
5
+ const relative = path.relative(root, file);
6
+ return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
7
+ };
8
+
9
+ export const createFileTarget = async (directory, filePath) => {
10
+ if (typeof directory !== 'string' || !path.isAbsolute(directory)
11
+ || typeof filePath !== 'string' || !path.isAbsolute(filePath)) throw Object.assign(new Error('Invalid file target'), { status: 400 });
12
+ const [root, entry] = await Promise.all([fs.realpath(directory), fs.realpath(filePath)]);
13
+ if (!inside(root, entry)) throw Object.assign(new Error('File outside project'), { status: 403 });
14
+ if (!(await fs.stat(root)).isDirectory() || !(await fs.stat(entry)).isFile()
15
+ || !/\.html?$/i.test(entry)) throw Object.assign(new Error('HTML file required'), { status: 400 });
16
+ const entryPath = `/${path.relative(root, entry).split(path.sep).map(encodeURIComponent).join('/')}`;
17
+ return { kind: 'file', root, entryPath };
18
+ };
19
+
20
+ /** Resolve every descendant again: a symlink added after registration grants no escape. */
21
+ export const resolveFileTargetResource = async (root, resourcePath) => {
22
+ const decoded = decodeURIComponent(resourcePath);
23
+ let candidate = path.resolve(root, `.${decoded}`);
24
+ if (!inside(root, candidate)) throw Object.assign(new Error('File outside project'), { status: 403 });
25
+ candidate = await fs.realpath(candidate);
26
+ if (!inside(root, candidate)) throw Object.assign(new Error('File outside project'), { status: 403 });
27
+ let stat = await fs.stat(candidate);
28
+ if (stat.isDirectory()) {
29
+ candidate = await fs.realpath(path.join(candidate, 'index.html'));
30
+ if (!inside(root, candidate)) throw Object.assign(new Error('File outside project'), { status: 403 });
31
+ stat = await fs.stat(candidate);
32
+ }
33
+ if (!stat.isFile()) throw Object.assign(new Error('File required'), { status: 400 });
34
+ if (stat.size > 100 * 1024 * 1024) throw Object.assign(new Error('File too large'), { status: 413 });
35
+ return candidate;
36
+ };
37
+
38
+ export const readFileTargetText = (file, signal) => fs.readFile(file, { encoding: 'utf8', signal });
@@ -0,0 +1,111 @@
1
+ import { afterEach, describe, expect, it, vi } from 'vitest';
2
+ import { createFilePreviewSmokeFixture } from '../../../../../scripts/remote-project-file-preview-smoke.mjs';
3
+ import { parseFilePreviewPath, readFilePreviewUrlAuthToken, replaceFilePreviewUrlAuthToken } from './file-preview-path.js';
4
+ import fs from 'node:fs/promises';
5
+ import path from 'node:path';
6
+
7
+ const cleanups = [];
8
+ afterEach(async () => { vi.restoreAllMocks(); for (const cleanup of cleanups.splice(0).reverse()) await cleanup(); });
9
+
10
+ describe('file preview pathname capability envelope', () => {
11
+ const id = 'a'.repeat(32), preview = 'b'.repeat(32), urlAuth = `yuri_url_${'c'.repeat(32)}`;
12
+ const base = `/api/hosts/remote/api/preview/proxy/${id}/_file/${preview}/${urlAuth}`;
13
+ it('extracts only short URL auth and replaces it before the Remote Host boundary', () => {
14
+ expect(readFilePreviewUrlAuthToken(`${base}/docs/index.html`)).toBe(urlAuth);
15
+ expect(replaceFilePreviewUrlAuthToken(`${base}/docs/index.html`)).toBe(`${base.replace(urlAuth, '-')}/docs/index.html`);
16
+ expect(readFilePreviewUrlAuthToken(`${base.replace(urlAuth, '-')}/docs/index.html`)).toBe('');
17
+ expect(parseFilePreviewPath(`${base}/docs/index.html`)?.resourcePath).toBe('/docs/index.html');
18
+ });
19
+ it('rejects normalized-prefix escape, encoded separators and wrong token formats', () => {
20
+ for (const suffix of ['/../api/session', '/%2e%2e/secret', '/%2fsecret', '/a%5cb', '/bad%00', '/%ff']) {
21
+ expect(parseFilePreviewPath(`${base}${suffix}`)).toBeNull();
22
+ }
23
+ expect(readFilePreviewUrlAuthToken(base.replace(urlAuth, 'long-lived-bearer') + '/index.html')).toBe('');
24
+ expect(readFilePreviewUrlAuthToken(`/api/fs/serve/${urlAuth}`)).toBe('');
25
+ });
26
+ });
27
+
28
+ describe('production file target HTTP resource graph', () => {
29
+ it('uses the real E2EE Relay transport for file graph descendants without forwarding Hub credentials', async () => {
30
+ const fixture = await createFilePreviewSmokeFixture({ relay: true }); cleanups.push(fixture.stop);
31
+ const base = `${fixture.hub.origin}${fixture.targets[0].route}`;
32
+ for (const relative of ['index.html', '../assets/style.css', '../assets/extra.css', '../assets/main.mjs', '../assets/part.mjs', '../assets/dynamic.mjs', '../assets/data.json', '../assets/pixel.svg', 'nested/frame.html']) {
33
+ const response = await fetch(new URL(relative, base));
34
+ expect(response.status).toBe(200); await response.arrayBuffer();
35
+ }
36
+ expect(fixture.requests.filter((req) => req.leakedHubToken)).toEqual([]);
37
+ }, 30_000);
38
+ it('retains two Host scopes across every descendant and denies leaks, writes, symlinks and revocation', async () => {
39
+ const fixture = await createFilePreviewSmokeFixture(); cleanups.push(fixture.stop);
40
+ for (const [index, target] of fixture.targets.entries()) {
41
+ const entry = new URL(target.route, fixture.hub.origin);
42
+ const request = (relative) => fetch(new URL(relative, entry));
43
+ const html = await request('index.html');
44
+ expect(html.status).toBe(200);
45
+ expect(html.headers.get('referrer-policy')).toBe('no-referrer');
46
+ expect(html.headers.get('cache-control')).toContain('no-store');
47
+ const text = await html.text();
48
+ expect(text).toContain(index === 0 ? 'remote-a' : 'remote-b');
49
+ expect((await request('../assets/style.css')).status).toBe(200);
50
+ expect((await request('../assets/extra.css')).status).toBe(200);
51
+ expect((await request('../assets/main.mjs')).headers.get('content-type')).toContain('javascript');
52
+ expect(await (await request('../assets/part.mjs')).text()).toContain(index === 0 ? 'remote-a-module' : 'remote-b-module');
53
+ expect((await request('../assets/dynamic.mjs')).status).toBe(200);
54
+ expect(await (await request('../assets/data.json')).json()).toEqual({ host: index === 0 ? 'remote-a' : 'remote-b' });
55
+ expect((await request('../assets/pixel.svg')).headers.get('content-type')).toContain('image/svg+xml');
56
+ expect((await request('nested/frame.html')).status).toBe(200);
57
+ expect((await request('../escape.txt')).status).toBe(403);
58
+ expect((await fetch(entry, { method: 'POST' })).status).toBeGreaterThanOrEqual(400);
59
+ expect((await fetch(entry.href.replace(target.previewToken, '0'.repeat(32)))).status).toBe(403);
60
+ }
61
+ expect(fixture.requests.filter((req) => req.leakedHubToken)).toEqual([]);
62
+ const [a, b] = fixture.targets;
63
+ expect((await fetch(`${fixture.hub.origin}${a.route.replace('/hosts/a/', '/hosts/b/')}`)).status).toBe(404);
64
+ const revoke = await fixture.hub.call(`/api/hosts/a/api/preview/targets/${a.id}`, 'DELETE', { previewToken: a.previewToken });
65
+ expect(revoke.status).toBe(204);
66
+ expect((await fetch(`${fixture.hub.origin}${a.route}`)).status).toBe(404);
67
+ expect((await fetch(`${fixture.hub.origin}${b.route}`)).status).toBe(200);
68
+ const originalNow = Date.now();
69
+ const clock = vi.spyOn(Date, 'now').mockReturnValue(originalNow + 61_000);
70
+ expect((await fetch(`${fixture.hub.origin}${b.route}`)).status).toBe(401);
71
+ clock.mockRestore();
72
+ const fresh = await (await fixture.hub.call('/auth/url-token', 'POST')).json();
73
+ const renewed = replaceFilePreviewUrlAuthToken(b.route, fresh.token);
74
+ expect((await fetch(`${fixture.hub.origin}${renewed}`)).status).toBe(200);
75
+ await fixture.hub.clients.revokeClient(fixture.hub.issued.client.id);
76
+ expect((await fetch(`${fixture.hub.origin}${renewed}`)).status).toBe(401);
77
+ }, 30_000);
78
+
79
+ it('target expiry is authoritative even with valid bearer auth; revoke and client cancel terminate remote streams', async () => {
80
+ const fixture = await createFilePreviewSmokeFixture(); cleanups.push(fixture.stop);
81
+ const short = await (await fixture.first.call('/api/preview/targets', 'POST', {
82
+ kind: 'file', directory: fixture.first.root, path: path.join(fixture.first.root, 'docs/index.html'), ttlMs: 15_000,
83
+ })).json();
84
+ const shortRoute = `${short.proxyBasePath}/_file/${short.previewToken}/-${short.entryPath}`;
85
+ expect((await fixture.first.call(shortRoute)).status).toBe(200);
86
+ for (const headers of [{}, { cookie: 'yuri_preview_token=arbitrary' }]) {
87
+ expect((await fetch(`${fixture.first.origin}${shortRoute}?yuri_preview_token=arbitrary`, { headers })).status).toBe(401);
88
+ }
89
+ const actualNow = Date.now();
90
+ const clock = vi.spyOn(Date, 'now').mockReturnValue(actualNow + 15_001);
91
+ expect((await fixture.first.call(shortRoute)).status).toBe(404);
92
+ clock.mockRestore();
93
+ const file = await fs.open(path.join(fixture.first.root, 'large.bin'), 'w');
94
+ await file.truncate(80 * 1024 * 1024); await file.close();
95
+ const target = fixture.targets[0];
96
+ const large = new URL('../large.bin', `${fixture.hub.origin}${target.route}`).href;
97
+ const controller = new AbortController();
98
+ const response = await fetch(large, { signal: controller.signal });
99
+ expect(response.status).toBe(200);
100
+ const reader = response.body.getReader(); await reader.read();
101
+ controller.abort();
102
+ await expect(reader.read()).rejects.toThrow();
103
+ await vi.waitFor(() => expect(fixture.first.activePreviewResponses).toBe(0));
104
+ const active = await fetch(large);
105
+ const activeReader = active.body.getReader(); await activeReader.read();
106
+ expect((await fixture.hub.call(`/api/hosts/a/api/preview/targets/${target.id}`, 'DELETE', { previewToken: target.previewToken })).status).toBe(204);
107
+ await expect((async () => { while (!(await activeReader.read()).done) { /* Drain already-buffered transport chunks. */ } })()).rejects.toThrow();
108
+ await vi.waitFor(() => expect(fixture.first.activePreviewResponses).toBe(0));
109
+ expect((await fetch(`${fixture.hub.origin}${fixture.targets[1].route}`)).status).toBe(200);
110
+ }, 30_000);
111
+ });