@pi-chamber/web 1.0.4 → 1.0.5-rc.1

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 (204) hide show
  1. package/README.md +1 -1
  2. package/bin/cli.js +21 -2
  3. package/bin/cli.test.js +164 -4
  4. package/bin/lib/DOCUMENTATION.md +3 -3
  5. package/bin/lib/cli-args.js +96 -13
  6. package/bin/lib/commands-connect-url-tailscale.test.js +136 -0
  7. package/bin/lib/commands-connect-url.js +146 -39
  8. package/bin/lib/commands-connect-url.test.js +126 -0
  9. package/bin/lib/commands-serve.js +45 -2
  10. package/bin/lib/commands-status.js +28 -5
  11. package/bin/lib/commands-status.test.js +107 -0
  12. package/bin/lib/commands-tunnel.js +36 -10
  13. package/dist/assets/{DiagramView-BpG1c3Hi.js → DiagramView-D-OSWTbO.js} +1 -1
  14. package/dist/assets/DiffView-BKT-MIH4.js +18 -0
  15. package/dist/assets/{FileSaveConflictDialog-DP7k9a-i.js → FileSaveConflictDialog-DBkVFssC.js} +2 -2
  16. package/dist/assets/FilesView-B7GIuRlh.js +6 -0
  17. package/dist/assets/{GitHubDetailScaffold-UxLAMAOl.js → GitHubDetailScaffold-C9rCZMUT.js} +2 -2
  18. package/dist/assets/{GitHubLinkPicker-Bh9RO1yK.js → GitHubLinkPicker-Bm09hvhJ.js} +1 -1
  19. package/dist/assets/{GitHubListPrimitives-DQyhT5wG.js → GitHubListPrimitives-DlhAlxI6.js} +1 -1
  20. package/dist/assets/{GitView-XBBheKRM.js → GitView-BgqdMb0m.js} +4 -4
  21. package/dist/assets/{IssuesSurface-BA1kpvAJ.js → IssuesSurface-BZXAvt49.js} +3 -3
  22. package/dist/assets/{JsonTreeView-BAaEPL4O.js → JsonTreeView-BKgCQjh_.js} +1 -1
  23. package/dist/assets/{MarkdownRendererImpl-DzgDmUsL.js → MarkdownRendererImpl-BdcyMPw-.js} +1 -1
  24. package/dist/assets/{PatchDiff-BMEUsgXH.js → PatchDiff-2MmWXcGe.js} +1 -1
  25. package/dist/assets/PierreDiffViewer-D1F2WvD0.js +135 -0
  26. package/dist/assets/PullRequestsSurface-CN2z3DFv.js +2 -0
  27. package/dist/assets/SessionSwitcherContent-CCljxAZb.js +1 -0
  28. package/dist/assets/SessionSwitcherDropdown-DtNt3qw4.js +2 -0
  29. package/dist/assets/SessionUnreadDot-B9bHMy5q.js +1 -0
  30. package/dist/assets/SettingsView-DaZVCInW.js +6 -0
  31. package/dist/assets/{SettingsWindow-j0e99YI0.js → SettingsWindow-C-ydfopH.js} +1 -1
  32. package/dist/assets/StickyHorizontalScrollbar-BMITjK4e.js +8 -0
  33. package/dist/assets/{ToolOutputDialog-VlS12Xyq.js → ToolOutputDialog-DJUAx_Oj.js} +4 -4
  34. package/dist/assets/{ToolPartDiffPreview-DdSneZws.js → ToolPartDiffPreview-DFyuJM4c.js} +1 -1
  35. package/dist/assets/{VirtualizedFileDiff-BqiXjvP6.js → VirtualizedFileDiff-BS-af6rn.js} +4 -4
  36. package/dist/assets/{Virtualizer-Cp_cJWbI.js → Virtualizer-DP6HbEeC.js} +1 -1
  37. package/dist/assets/{collapsible-C7oyikVm.js → collapsible-BOcd0lzY.js} +1 -1
  38. package/dist/assets/{computeVirtualFileMetrics-BJjC-tXV.js → computeVirtualFileMetrics-BI6wORhM.js} +1 -1
  39. package/dist/assets/{contextFileOpenGuard-BBzqKGei.js → contextFileOpenGuard-DUMSGR4M.js} +1 -1
  40. package/dist/assets/{gitStatusPredicates-Dq-E5DaH.js → gitStatusPredicates-FdKYDZe3.js} +1 -1
  41. package/dist/assets/{githubLink-Cryd7GkG.js → githubLink-B3-BaGpb.js} +5 -5
  42. package/dist/assets/index-DWSrsQWl.js +11 -0
  43. package/dist/assets/{index-BbhXFTId.js → index-Df-vmvzu.js} +1 -1
  44. package/dist/assets/index-DsQIBAWK.css +1 -0
  45. package/dist/assets/main-61_cd7S7.js +2 -0
  46. package/dist/assets/main-q43jqZ2I.js +136 -0
  47. package/dist/assets/{markdownCore-B9AuEyYi.js → markdownCore-CqHYlXi_.js} +2 -2
  48. package/dist/assets/{miniChat-CgOaJfD8.js → miniChat-vOuWN5pV.js} +2 -2
  49. package/dist/assets/mobile-mrXWV5ky.js +2 -0
  50. package/dist/assets/{nativeFileSave-BzhtrDoD.js → nativeFileSave-CFuugNKV.js} +1 -1
  51. package/dist/assets/pi-session-focus-preference-BEufpwC6.js +9 -0
  52. package/dist/assets/{renderDiffWithHighlighter-CVLsdtQ5.js → renderDiffWithHighlighter-BD9CAhZU.js} +1 -1
  53. package/dist/assets/renderElectronMiniChatApp-QQFXkY5Y.js +2 -0
  54. package/dist/assets/{renderFileWithHighlighter-DJ9mk2bZ.js → renderFileWithHighlighter-KiEWMtzI.js} +1 -1
  55. package/dist/assets/renderMobileApp-DIZYvrhi.js +11 -0
  56. package/dist/assets/runtimeEndpointReset-BA2uP2rj.js +62 -0
  57. package/dist/assets/{runtimeSurface-DBiUWYK2.js → runtimeSurface-Der4qUnI.js} +1 -1
  58. package/dist/assets/useAppFontEffects-Bfw_d5eB.js +212 -0
  59. package/dist/assets/{useFilesViewSearch-D2Au5Xgt.js → useFilesViewSearch-Budwejnx.js} +3 -3
  60. package/dist/assets/useGitHubRemoteSearch-gUdylYy3.js +1 -0
  61. package/dist/assets/{useSwitcherItems-Dej8BzXI.js → useSwitcherItems-yHSMduoo.js} +1 -1
  62. package/dist/assets/{vendor-aparajita-capacitor-secure-storage-BYohCVY0.js → vendor-aparajita-capacitor-secure-storage-BDrMx_CE.js} +1 -1
  63. package/dist/assets/{vendor-base-ui-BscvGUFt.js → vendor-base-ui-CKRUCG-f.js} +1 -1
  64. package/dist/assets/{vendor-boot-Dgb9NVFe.js → vendor-boot-EC6IyLt1.js} +13 -13
  65. package/dist/assets/{vendor-capacitor-app-BjdQVib9.js → vendor-capacitor-app-BaupizkW.js} +1 -1
  66. package/dist/assets/{vendor-capacitor-keyboard-eTtI5go3.js → vendor-capacitor-keyboard-9BVxykO7.js} +1 -1
  67. package/dist/assets/{vendor-capacitor-status-bar-9rNIGxlO.js → vendor-capacitor-status-bar-BsrUwiaA.js} +1 -1
  68. package/dist/assets/{vendor-codemirror-autocomplete-DxS3jwvE.js → vendor-codemirror-autocomplete-CGpAsPWp.js} +1 -1
  69. package/dist/assets/{vendor-codemirror-lang-angular-DdjXl9e2.js → vendor-codemirror-lang-angular-CDJoHJSY.js} +1 -1
  70. package/dist/assets/{vendor-codemirror-lang-cpp--aMr7NVt.js → vendor-codemirror-lang-cpp-BmHofQls.js} +1 -1
  71. package/dist/assets/{vendor-codemirror-lang-css-CZ_qxZY9.js → vendor-codemirror-lang-css-RM2HqXZ0.js} +1 -1
  72. package/dist/assets/{vendor-codemirror-lang-go-Ca-y2Alu.js → vendor-codemirror-lang-go-Crwca_X7.js} +1 -1
  73. package/dist/assets/{vendor-codemirror-lang-html-COZ0L5wT.js → vendor-codemirror-lang-html-CHSHUpwq.js} +1 -1
  74. package/dist/assets/{vendor-codemirror-lang-java-D3Rf3QNJ.js → vendor-codemirror-lang-java-lhQXgWu0.js} +1 -1
  75. package/dist/assets/{vendor-codemirror-lang-javascript-DwJ-IvCs.js → vendor-codemirror-lang-javascript-Dw4kFO4e.js} +1 -1
  76. package/dist/assets/{vendor-codemirror-lang-jinja-D_5lod6k.js → vendor-codemirror-lang-jinja-_pAC3UTN.js} +1 -1
  77. package/dist/assets/{vendor-codemirror-lang-json-BG8C7OpC.js → vendor-codemirror-lang-json-B-b1vAv-.js} +1 -1
  78. package/dist/assets/{vendor-codemirror-lang-less-CVEkoaTw.js → vendor-codemirror-lang-less-xIgOi1ze.js} +1 -1
  79. package/dist/assets/{vendor-codemirror-lang-liquid-U9vj0m8w.js → vendor-codemirror-lang-liquid-CP49m5dB.js} +1 -1
  80. package/dist/assets/{vendor-codemirror-lang-markdown-DqlYH9gY.js → vendor-codemirror-lang-markdown-BTht2ATe.js} +1 -1
  81. package/dist/assets/{vendor-codemirror-lang-php-BFEiEVA1.js → vendor-codemirror-lang-php-BguZDhaO.js} +1 -1
  82. package/dist/assets/{vendor-codemirror-lang-python-Cz1dQXQd.js → vendor-codemirror-lang-python-CH6_em9L.js} +1 -1
  83. package/dist/assets/{vendor-codemirror-lang-rust-C_CoD9mj.js → vendor-codemirror-lang-rust-EG_DtGyi.js} +1 -1
  84. package/dist/assets/{vendor-codemirror-lang-sass-BuR0aKh5.js → vendor-codemirror-lang-sass-BknY5Qpo.js} +1 -1
  85. package/dist/assets/{vendor-codemirror-lang-sql-DggNUjdM.js → vendor-codemirror-lang-sql-B0f-qCZo.js} +1 -1
  86. package/dist/assets/{vendor-codemirror-lang-vue-DFZHi2J3.js → vendor-codemirror-lang-vue-CyGn9snv.js} +1 -1
  87. package/dist/assets/{vendor-codemirror-lang-wast-zuTN3SHT.js → vendor-codemirror-lang-wast-CsFfSyyB.js} +1 -1
  88. package/dist/assets/{vendor-codemirror-lang-xml-CrcvhI-k.js → vendor-codemirror-lang-xml-Cdan_Jp1.js} +1 -1
  89. package/dist/assets/{vendor-codemirror-lang-yaml-DcVWsakb.js → vendor-codemirror-lang-yaml-COI5hck8.js} +1 -1
  90. package/dist/assets/{vendor-codemirror-language-data-CCLITgCF.js → vendor-codemirror-language-data-CqU7kHmg.js} +2 -2
  91. package/dist/assets/{vendor-codemirror-search-H7NOEdbX.js → vendor-codemirror-search-DUfSCF9S.js} +1 -1
  92. package/dist/assets/{vendor-lezer-cpp-C8aD2KAr.js → vendor-lezer-cpp-DMZOJzBa.js} +1 -1
  93. package/dist/assets/{vendor-lezer-css-2lbTJF-Y.js → vendor-lezer-css-DUkkbMp7.js} +1 -1
  94. package/dist/assets/{vendor-lezer-go-Bw6LFTrZ.js → vendor-lezer-go-CHIhCNY6.js} +1 -1
  95. package/dist/assets/{vendor-lezer-html-D7ym2z7S.js → vendor-lezer-html-B3h0MOrG.js} +1 -1
  96. package/dist/assets/{vendor-lezer-java-CZhK7w21.js → vendor-lezer-java-tMazV_6X.js} +1 -1
  97. package/dist/assets/{vendor-lezer-javascript-rpKeTHZp.js → vendor-lezer-javascript-ctwLWf4v.js} +1 -1
  98. package/dist/assets/{vendor-lezer-json-C7jwsd2G.js → vendor-lezer-json-BP_UAzLL.js} +1 -1
  99. package/dist/assets/{vendor-lezer-lr-DR-ylqNN.js → vendor-lezer-lr-B8TQctNw.js} +1 -1
  100. package/dist/assets/{vendor-lezer-markdown-Bir0m5nB.js → vendor-lezer-markdown-aGLZf_3h.js} +1 -1
  101. package/dist/assets/{vendor-lezer-php-y0hIEfo1.js → vendor-lezer-php-D5zCNzlt.js} +1 -1
  102. package/dist/assets/{vendor-lezer-python-D64A9lNV.js → vendor-lezer-python-EJ4Im4y2.js} +1 -1
  103. package/dist/assets/{vendor-lezer-rust-E3ZA9T2L.js → vendor-lezer-rust-DO5c7OtA.js} +1 -1
  104. package/dist/assets/{vendor-lezer-sass-C5UFI9SP.js → vendor-lezer-sass-CMi6zfXI.js} +1 -1
  105. package/dist/assets/{vendor-lezer-xml-DOy7FzCR.js → vendor-lezer-xml-0MHMeZDp.js} +1 -1
  106. package/dist/assets/{vendor-lezer-yaml-kEjaSCvZ.js → vendor-lezer-yaml-BE2EFjpA.js} +1 -1
  107. package/dist/assets/{vendor-replit-codemirror-vim-BLfh0LPy.js → vendor-replit-codemirror-vim-AnOuN8yJ.js} +1 -1
  108. package/dist/assets/{web-components-C7CmoFxi.js → web-components-CeHLxvED.js} +3 -3
  109. package/dist/index.html +4 -4
  110. package/dist/mini-chat.html +3 -3
  111. package/dist/mobile.html +3 -3
  112. package/dist/sw.js +1 -1
  113. package/package.json +1 -2
  114. package/server/index.js +69 -30
  115. package/server/lib/client-auth/DOCUMENTATION.md +15 -1
  116. package/server/lib/client-auth/pairing.js +2 -12
  117. package/server/lib/client-auth/remote-clients.js +2 -12
  118. package/server/lib/cloudflare-tunnel.js +0 -132
  119. package/server/lib/fs/DOCUMENTATION.md +8 -0
  120. package/server/lib/fs/atomic-write.js +111 -0
  121. package/server/lib/fs/atomic-write.test.js +133 -0
  122. package/server/lib/notifications/DOCUMENTATION.md +43 -32
  123. package/server/lib/notifications/pi-notification-watcher.js +8 -7
  124. package/server/lib/notifications/pi-notification-watcher.test.js +88 -2
  125. package/server/lib/pi/routes-extension-events.test.js +231 -0
  126. package/server/lib/pi/routes.js +137 -4
  127. package/server/lib/pi/routes.test.js +248 -2
  128. package/server/lib/pi/session-daemon/DOCUMENTATION.md +17 -4
  129. package/server/lib/pi/session-daemon/daemon-process.js +2 -0
  130. package/server/lib/pi/session-daemon/engines/index.js +6 -0
  131. package/server/lib/pi/session-daemon/extension-bridge-draft.test.js +1 -1
  132. package/server/lib/pi/session-daemon/extension-bridge.js +24 -0
  133. package/server/lib/pi/session-daemon/extension-message-render.js +74 -0
  134. package/server/lib/pi/session-daemon/extension-message-render.test.js +164 -0
  135. package/server/lib/pi/session-daemon/extension-tool-render.js +13 -6
  136. package/server/lib/pi/session-daemon/pending-input.js +188 -0
  137. package/server/lib/pi/session-daemon/pending-input.test.js +202 -0
  138. package/server/lib/pi/session-daemon/session-daemon-engines.test.js +828 -0
  139. package/server/lib/pi/session-daemon/session-daemon-extensions.test.js +296 -6
  140. package/server/lib/pi/session-daemon/session-daemon-turn.e2e.test.js +9 -0
  141. package/server/lib/pi/session-daemon/session-daemon.js +219 -19
  142. package/server/lib/pi/session-daemon/session-daemon.test.js +30 -2
  143. package/server/lib/pi/session-daemon/session-engine-router.js +390 -0
  144. package/server/lib/pi/session-daemon/session-engine-router.test.js +515 -0
  145. package/server/lib/pi/session-daemon/session-engines.js +467 -0
  146. package/server/lib/pi/session-daemon/session-engines.test.js +383 -0
  147. package/server/lib/pi/snippets-store.js +8 -17
  148. package/server/lib/pi/ui-settings-store.js +6 -10
  149. package/server/lib/pi/ui-settings-store.test.js +37 -1
  150. package/server/lib/relay/DOCUMENTATION.md +6 -4
  151. package/server/lib/relay/identity-store.js +116 -0
  152. package/server/lib/relay/identity-store.test.js +169 -0
  153. package/server/lib/relay/identity.js +6 -4
  154. package/server/lib/relay/server-id.js +63 -0
  155. package/server/lib/relay/server-id.test.js +132 -0
  156. package/server/lib/relay/signing-key.js +14 -11
  157. package/server/lib/security/bind-host.js +6 -2
  158. package/server/lib/security/bind-host.test.js +17 -0
  159. package/server/lib/server/core-routes.js +27 -1
  160. package/server/lib/server/lan-addresses.js +18 -6
  161. package/server/lib/server/lan-addresses.test.js +28 -0
  162. package/server/lib/server/tunnel-auth.js +47 -7
  163. package/server/lib/server/tunnel-auth.rate-limit.test.js +164 -0
  164. package/server/lib/server/tunnel-service.DOCUMENTATION.md +3 -4
  165. package/server/lib/server/tunnel-service.js +23 -20
  166. package/server/lib/server/tunnel-service.test.js +19 -2
  167. package/server/lib/stt/config-store.js +5 -15
  168. package/server/lib/tailscale/DOCUMENTATION.md +264 -0
  169. package/server/lib/tailscale/routes.js +45 -0
  170. package/server/lib/tailscale/service.js +959 -0
  171. package/server/lib/tailscale/tailscale.js +302 -0
  172. package/server/lib/tailscale/tailscale.test.js +1861 -0
  173. package/server/lib/tunnels/DOCUMENTATION.md +3 -4
  174. package/server/lib/tunnels/providers/cloudflare.js +1 -22
  175. package/server/lib/tunnels/types.js +0 -2
  176. package/server/lib/ui-auth/DOCUMENTATION.md +31 -0
  177. package/server/lib/ui-auth/ui-auth.js +80 -6
  178. package/server/lib/ui-auth/ui-auth.test.js +136 -0
  179. package/server/lib/ui-auth/ui-passkeys.js +2 -13
  180. package/server/lib/update-job-store.js +4 -6
  181. package/dist/assets/DiffView-BxwoRCYx.js +0 -18
  182. package/dist/assets/FilesView-D_2QcdUt.js +0 -6
  183. package/dist/assets/PierreDiffViewer-BW8MO-O6.js +0 -134
  184. package/dist/assets/PullRequestsSurface-B3ictm4I.js +0 -2
  185. package/dist/assets/SessionSwitcherContent-rLoyVqgs.js +0 -1
  186. package/dist/assets/SessionSwitcherDropdown-CfySKnUu.js +0 -2
  187. package/dist/assets/SessionUnreadDot-CmEF9sxM.js +0 -1
  188. package/dist/assets/SettingsView-BiwlwnTK.js +0 -6
  189. package/dist/assets/index-BnZVqcki.js +0 -11
  190. package/dist/assets/index-BnieExes.css +0 -1
  191. package/dist/assets/main-9O5IAtT_.js +0 -136
  192. package/dist/assets/main-DWGwALIw.js +0 -2
  193. package/dist/assets/mobile-BbJcYVym.js +0 -2
  194. package/dist/assets/pi-session-focus-preference-Bmk1iOvn.js +0 -10
  195. package/dist/assets/renderElectronMiniChatApp-R5o9NwFC.js +0 -2
  196. package/dist/assets/renderMobileApp-CQ9tWYIj.js +0 -11
  197. package/dist/assets/runtimeEndpointReset-CtK4C_5h.js +0 -62
  198. package/dist/assets/useAppFontEffects-DviRbaCJ.js +0 -212
  199. package/dist/assets/useGitHubRemoteSearch-D-K7aolk.js +0 -1
  200. package/dist/assets/vendor-capacitor-push-notifications-CBKq2Arn.js +0 -1
  201. package/server/lib/notifications/delivery-runtime.js +0 -314
  202. package/server/lib/notifications/delivery-runtime.test.js +0 -85
  203. package/server/lib/notifications/routes.js +0 -74
  204. package/server/lib/relay/service.js +0 -9
@@ -0,0 +1,383 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import {
4
+ ENGINE_HANDLER_COMMANDS,
5
+ ENGINE_SESSION_COMMANDS,
6
+ ENGINE_UNSUPPORTED_OPERATION,
7
+ createSessionEngineRegistry,
8
+ engineCommandsOf,
9
+ isValidEngineId,
10
+ isValidEngineLabel,
11
+ logSessionEngineError,
12
+ } from './session-engines.js';
13
+
14
+ const host = { publish: () => {}, streamEpoch: 'epoch', agentDir: '/agent', dataDir: '/data' };
15
+
16
+ // Redaction is mandatory; tests that do not exercise it pass an identity.
17
+ const createRegistry = (options) => createSessionEngineRegistry({ redact: (value) => value, ...options });
18
+
19
+ const makeEngine = (id, overrides = {}) => ({
20
+ id,
21
+ ownsSession: () => false,
22
+ ownsProvider: () => false,
23
+ listSessions: async () => [],
24
+ handlers: {},
25
+ snapshot: () => undefined,
26
+ dispose: async () => {},
27
+ ...overrides,
28
+ });
29
+
30
+ const validRow = (id) => ({
31
+ session: { id, directory: '/elsewhere', createdAt: 10, updatedAt: 20 },
32
+ preview: 'hello',
33
+ updatedAt: 20,
34
+ });
35
+
36
+ describe('session engine registry', () => {
37
+ it('refuses to build without a redactor', async () => {
38
+ await expect(createSessionEngineRegistry({ host, factories: [] })).rejects.toThrow(TypeError);
39
+ });
40
+
41
+ it('rejects the reserved pi id and invalid ids as programming errors', async () => {
42
+ for (const badId of ['pi', 'Bad Id', '', 'UPPER', '0lead', 'a'.repeat(33), 42, undefined]) {
43
+ await expect(createRegistry({
44
+ host,
45
+ factories: [() => makeEngine(badId)],
46
+ })).rejects.toMatchObject({ code: 'INVALID_ENGINE' });
47
+ }
48
+ expect(isValidEngineId('example-engine')).toBe(true);
49
+ expect(isValidEngineId('pi')).toBe(false);
50
+ expect(isValidEngineId('Bad Id')).toBe(false);
51
+ });
52
+
53
+ it('rejects engines with an invalid shape', async () => {
54
+ const broken = makeEngine('broken');
55
+ delete broken.dispose;
56
+ await expect(createRegistry({ host, factories: [() => broken] }))
57
+ .rejects.toMatchObject({ code: 'INVALID_ENGINE' });
58
+
59
+ const badProviders = makeEngine('bad-providers', { listProviders: 'nope' });
60
+ await expect(createRegistry({ host, factories: [() => badProviders] }))
61
+ .rejects.toMatchObject({ code: 'INVALID_ENGINE' });
62
+ });
63
+
64
+ it('rejects invalid handler maps and labels as programming errors', async () => {
65
+ const missing = makeEngine('missing-handlers');
66
+ delete missing.handlers;
67
+ await expect(createRegistry({ host, factories: [() => missing] }))
68
+ .rejects.toMatchObject({ code: 'INVALID_ENGINE' });
69
+
70
+ await expect(createRegistry({
71
+ host,
72
+ factories: [() => makeEngine('unknown-command', { handlers: { 'sessions.list': async () => ({}) } })],
73
+ })).rejects.toMatchObject({ code: 'INVALID_ENGINE' });
74
+
75
+ await expect(createRegistry({
76
+ host,
77
+ factories: [() => makeEngine('non-function', { handlers: { 'sessions.open': 'nope' } })],
78
+ })).rejects.toMatchObject({ code: 'INVALID_ENGINE' });
79
+
80
+ for (const badLabel of ['', 'x'.repeat(65), 42]) {
81
+ await expect(createRegistry({
82
+ host,
83
+ factories: [() => makeEngine('bad-label', { label: badLabel })],
84
+ })).rejects.toMatchObject({ code: 'INVALID_ENGINE' });
85
+ }
86
+ expect(isValidEngineLabel('Friendly')).toBe(true);
87
+ expect(isValidEngineLabel('')).toBe(false);
88
+ expect(isValidEngineLabel('x'.repeat(65))).toBe(false);
89
+ });
90
+
91
+ it('describes engines with defaulted labels and sorted commands', async () => {
92
+ const registry = await createRegistry({
93
+ host,
94
+ factories: [
95
+ () => makeEngine('b-engine', {
96
+ label: 'Bee',
97
+ handlers: {
98
+ 'sessions.prompt': async () => ({}),
99
+ 'sessions.open': async () => ({}),
100
+ 'sessions.create': async () => ({}),
101
+ },
102
+ }),
103
+ () => makeEngine('a-engine', { handlers: { 'sessions.tree': async () => ({}) } }),
104
+ ],
105
+ });
106
+ expect(registry.describeEngines()).toEqual([
107
+ { id: 'b-engine', label: 'Bee', commands: ['sessions.create', 'sessions.open', 'sessions.prompt'] },
108
+ { id: 'a-engine', label: 'a-engine', commands: ['sessions.tree'] },
109
+ ]);
110
+ expect(engineCommandsOf(registry.get('b-engine'))).toEqual(['sessions.create', 'sessions.open', 'sessions.prompt']);
111
+ });
112
+
113
+ it('rejects duplicate ids and disposes already-created engines first', async () => {
114
+ const disposed = [];
115
+ const first = makeEngine('dup', { dispose: async () => { disposed.push('first'); } });
116
+ await expect(createRegistry({
117
+ host,
118
+ factories: [() => first, () => makeEngine('dup')],
119
+ })).rejects.toMatchObject({ code: 'INVALID_ENGINE' });
120
+ expect(disposed).toEqual(['first']);
121
+ });
122
+
123
+ it('skips a factory that throws so the daemon still starts', async () => {
124
+ const seen = [];
125
+ const registry = await createRegistry({
126
+ host,
127
+ logger: (...args) => seen.push(args),
128
+ factories: [
129
+ () => { throw Object.assign(new Error('boom'), { code: 'FACTORY_BOOM' }); },
130
+ () => makeEngine('healthy'),
131
+ ],
132
+ });
133
+ expect(registry.size).toBe(1);
134
+ expect(registry.get('healthy')?.id).toBe('healthy');
135
+ expect(seen).toEqual([['unknown', 'factory-failed', 'FACTORY_BOOM']]);
136
+ });
137
+
138
+ it('resolves ownership in registration order', async () => {
139
+ const registry = await createRegistry({
140
+ host,
141
+ factories: [
142
+ () => makeEngine('first', {
143
+ ownsSession: (sessionId) => sessionId === 'shared',
144
+ ownsProvider: (providerId) => providerId === 'prov',
145
+ }),
146
+ () => makeEngine('second', {
147
+ ownsSession: (sessionId) => sessionId === 'shared' || sessionId === 'only-second',
148
+ ownsProvider: () => true,
149
+ }),
150
+ ],
151
+ });
152
+ expect(registry.ownerOfSession('shared')?.id).toBe('first');
153
+ expect(registry.ownerOfSession('only-second')?.id).toBe('second');
154
+ expect(registry.ownerOfSession('missing')).toBeUndefined();
155
+ expect(registry.ownerOfSession('')).toBeUndefined();
156
+ expect(registry.ownerOfProvider('prov')?.id).toBe('first');
157
+ expect(registry.ownerOfProvider('other')?.id).toBe('second');
158
+ });
159
+
160
+ it('treats a throwing ownsSession as not owned and logs it', async () => {
161
+ const seen = [];
162
+ const registry = await createRegistry({
163
+ host,
164
+ logger: (...args) => seen.push(args),
165
+ factories: [
166
+ () => makeEngine('thrower', {
167
+ ownsSession: () => { throw Object.assign(new Error('secret-index-failure'), { code: 'INDEX_BROKEN' }); },
168
+ }),
169
+ () => makeEngine('fallback', { ownsSession: () => true }),
170
+ ],
171
+ });
172
+ expect(registry.ownerOfSession('anything')?.id).toBe('fallback');
173
+ expect(seen).toEqual([['thrower', 'owns-failed', 'INDEX_BROKEN']]);
174
+ expect(JSON.stringify(seen)).not.toContain('secret-index-failure');
175
+ });
176
+
177
+ it('isolates throwing, timed-out, and malformed listings while keeping healthy rows tagged', async () => {
178
+ const seen = [];
179
+ const registry = await createRegistry({
180
+ host,
181
+ logger: (...args) => seen.push(args),
182
+ listTimeoutMs: 20,
183
+ factories: [
184
+ () => makeEngine('healthy', { listSessions: async () => [validRow('healthy-1')] }),
185
+ () => makeEngine('thrower', {
186
+ listSessions: async () => { throw Object.assign(new Error('super-secret-list-message'), { code: 'LIST_BROKEN' }); },
187
+ }),
188
+ () => makeEngine('slow', { listSessions: () => new Promise(() => {}) }),
189
+ () => makeEngine('malformed', { listSessions: async () => [{ session: { id: '', createdAt: 1, updatedAt: 2 }, updatedAt: 2 }] }),
190
+ ],
191
+ });
192
+ const { items, failed } = await registry.listSessions('/requested');
193
+ expect(items).toEqual([{
194
+ session: { id: 'healthy-1', directory: '/requested', createdAt: 10, updatedAt: 20, engine: 'healthy' },
195
+ preview: 'hello',
196
+ updatedAt: 20,
197
+ }]);
198
+ expect(failed.sort()).toEqual(['malformed', 'slow', 'thrower']);
199
+ expect(JSON.stringify(seen)).not.toContain('super-secret-list-message');
200
+ expect(seen.map((entry) => [entry[0], entry[1]]).sort()).toEqual([
201
+ ['malformed', 'list-failed'],
202
+ ['slow', 'list-failed'],
203
+ ['thrower', 'list-failed'],
204
+ ]);
205
+ });
206
+
207
+ it('aborts the listing signal when the per-engine timeout fires', async () => {
208
+ const seen = [];
209
+ const registry = await createRegistry({
210
+ host,
211
+ listTimeoutMs: 20,
212
+ factories: [
213
+ () => makeEngine('slow', {
214
+ listSessions: (_directory, { signal } = {}) => new Promise((_, reject) => {
215
+ const timer = setTimeout(() => reject(new Error('should have timed out first')), 200);
216
+ signal?.addEventListener('abort', () => {
217
+ clearTimeout(timer);
218
+ seen.push(signal.aborted);
219
+ });
220
+ }),
221
+ }),
222
+ ],
223
+ });
224
+ const { items, failed } = await registry.listSessions('/requested');
225
+ expect(items).toEqual([]);
226
+ expect(failed).toEqual(['slow']);
227
+ expect(seen).toEqual([true]);
228
+ });
229
+
230
+ it('shares one in-flight sessions listing per directory across concurrent callers', async () => {
231
+ let calls = 0;
232
+ const registry = await createRegistry({
233
+ host,
234
+ factories: [
235
+ () => makeEngine('shared', {
236
+ listSessions: async () => {
237
+ calls += 1;
238
+ await new Promise((resolve) => setTimeout(resolve, 20));
239
+ return [validRow('shared-1')];
240
+ },
241
+ }),
242
+ ],
243
+ });
244
+ const [first, second] = await Promise.all([
245
+ registry.listSessions('/shared'),
246
+ registry.listSessions('/shared'),
247
+ ]);
248
+ expect(calls).toBe(1);
249
+ expect(first.items).toHaveLength(1);
250
+ expect(second.items).toHaveLength(1);
251
+ await registry.listSessions('/shared');
252
+ expect(calls).toBe(2);
253
+ });
254
+
255
+ it('shares one in-flight providers listing across concurrent callers', async () => {
256
+ let calls = 0;
257
+ const good = { id: 'prov', label: 'Prov', authenticated: true, models: [] };
258
+ const registry = await createRegistry({
259
+ host,
260
+ factories: [
261
+ () => makeEngine('shared', {
262
+ listProviders: async () => {
263
+ calls += 1;
264
+ await new Promise((resolve) => setTimeout(resolve, 20));
265
+ return { providers: [good] };
266
+ },
267
+ }),
268
+ ],
269
+ });
270
+ const [first, second] = await Promise.all([registry.listProviders(), registry.listProviders()]);
271
+ expect(calls).toBe(1);
272
+ expect(first.providers).toHaveLength(1);
273
+ expect(second.providers).toHaveLength(1);
274
+ });
275
+
276
+ it('redacts engine list and provider rows through the injected redactor', async () => {
277
+ const path = '/tmp/pi-clipboard-7f7ec702-256a-4783-855c-df34e3ecedab.pdf';
278
+ const redact = (value) => {
279
+ if (typeof value === 'string') return value.split(path).join('[attachment]');
280
+ if (Array.isArray(value)) return value.map(redact);
281
+ if (value && typeof value === 'object') {
282
+ return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, redact(entry)]));
283
+ }
284
+ return value;
285
+ };
286
+ const registry = await createRegistry({
287
+ host,
288
+ redact,
289
+ factories: [
290
+ () => makeEngine('redacted', {
291
+ listSessions: async () => [{
292
+ session: { id: 's1', directory: '/elsewhere', title: `Opened ${path}`, createdAt: 10, updatedAt: 20 },
293
+ preview: `preview ${path}`,
294
+ updatedAt: 20,
295
+ }],
296
+ listProviders: async () => ({
297
+ providers: [{ id: 'prov', label: `label ${path}`, authenticated: true, models: [] }],
298
+ }),
299
+ }),
300
+ ],
301
+ });
302
+ const sessions = await registry.listSessions('/requested');
303
+ expect(JSON.stringify(sessions.items)).not.toContain('pi-clipboard-');
304
+ expect(sessions.items[0].preview).toContain('[attachment]');
305
+ const providers = await registry.listProviders();
306
+ expect(JSON.stringify(providers.providers)).not.toContain('pi-clipboard-');
307
+ });
308
+
309
+ it('drops every row of an engine with one malformed row', async () => {
310
+ const registry = await createRegistry({
311
+ host,
312
+ factories: [() => makeEngine('mixed', {
313
+ listSessions: async () => [validRow('good'), { session: { id: 'bad' }, updatedAt: 1 }],
314
+ })],
315
+ });
316
+ const { items, failed } = await registry.listSessions('/requested');
317
+ expect(items).toEqual([]);
318
+ expect(failed).toEqual(['mixed']);
319
+ });
320
+
321
+ it('isolates provider failures and validates provider shape', async () => {
322
+ const good = { id: 'prov', label: 'Prov', authenticated: true, models: [] };
323
+ const registry = await createRegistry({
324
+ host,
325
+ listTimeoutMs: 20,
326
+ factories: [
327
+ () => makeEngine('with-providers', { listProviders: async () => ({ providers: [good] }) }),
328
+ () => makeEngine('array-shape', { listProviders: async () => [good] }),
329
+ () => makeEngine('none'),
330
+ () => makeEngine('bad-shape', { listProviders: async () => ({ providers: [{ id: 'x' }] }) }),
331
+ () => makeEngine('rejects', { listProviders: async () => { throw new Error('nope'); } }),
332
+ ],
333
+ });
334
+ const { providers, failed } = await registry.listProviders();
335
+ expect(providers).toEqual([
336
+ { ...good, engine: 'with-providers' },
337
+ { ...good, engine: 'array-shape' },
338
+ ]);
339
+ expect(failed.sort()).toEqual(['bad-shape', 'rejects']);
340
+ });
341
+
342
+ it('disposes every engine even when one throws, then rejects with an AggregateError', async () => {
343
+ const disposed = [];
344
+ const registry = await createRegistry({
345
+ host,
346
+ factories: [
347
+ () => makeEngine('first', { dispose: async () => { disposed.push('first'); } }),
348
+ () => makeEngine('failing', {
349
+ dispose: async () => {
350
+ disposed.push('failing');
351
+ throw Object.assign(new Error('cannot stop'), { code: 'DISPOSE_BROKEN' });
352
+ },
353
+ }),
354
+ () => makeEngine('last', { dispose: async () => { disposed.push('last'); } }),
355
+ ],
356
+ });
357
+ await expect(registry.disposeAll()).rejects.toBeInstanceOf(AggregateError);
358
+ expect(disposed).toEqual(['first', 'failing', 'last']);
359
+ });
360
+
361
+ it('never logs error messages, only id, event, and code', () => {
362
+ const seen = [];
363
+ const secret = 'sk-live-super-secret-token-12345';
364
+ logSessionEngineError((...args) => seen.push(args), 'fake', 'list-failed', new Error(secret));
365
+ logSessionEngineError((...args) => seen.push(args), 'fake', 'list-failed', { code: 'EVIL\nINJECTION', message: secret });
366
+ expect(seen).toEqual([['fake', 'list-failed', 'UNKNOWN'], ['fake', 'list-failed', 'UNKNOWN']]);
367
+ expect(JSON.stringify(seen)).not.toContain(secret);
368
+ });
369
+
370
+ it('exposes the routed session command set without pi-only commands', () => {
371
+ expect(ENGINE_SESSION_COMMANDS.has('sessions.prompt')).toBe(true);
372
+ expect(ENGINE_SESSION_COMMANDS.has('sessions.open')).toBe(true);
373
+ expect(ENGINE_SESSION_COMMANDS.has('sessions.compact')).toBe(true);
374
+ expect(ENGINE_SESSION_COMMANDS.has('sessions.list')).toBe(false);
375
+ expect(ENGINE_SESSION_COMMANDS.has('sessions.create')).toBe(false);
376
+ expect(ENGINE_SESSION_COMMANDS.has('sessions.sendReceipt')).toBe(false);
377
+ expect(ENGINE_SESSION_COMMANDS.has('extensions.draft')).toBe(false);
378
+ expect(ENGINE_HANDLER_COMMANDS.has('sessions.create')).toBe(true);
379
+ expect(ENGINE_HANDLER_COMMANDS.has('sessions.prompt')).toBe(true);
380
+ expect(ENGINE_HANDLER_COMMANDS.has('sessions.list')).toBe(false);
381
+ expect(ENGINE_UNSUPPORTED_OPERATION).toBe('ENGINE_UNSUPPORTED_OPERATION');
382
+ });
383
+ });
@@ -3,12 +3,15 @@ import {
3
3
  chmod,
4
4
  mkdir,
5
5
  readFile,
6
+ readlink,
7
+ realpath,
6
8
  rename,
7
9
  rm,
8
10
  writeFile,
9
11
  } from "node:fs/promises";
10
- import { dirname, isAbsolute, join, normalize } from "node:path";
12
+ import { isAbsolute, join, normalize } from "node:path";
11
13
 
14
+ import { writeFileAtomic } from "../fs/atomic-write.js";
12
15
  import { resolvePiChamberDataDir } from "../pichamber-data-dir.js";
13
16
  import { withCrossProcessLock } from "../server/cross-process-lock.js";
14
17
 
@@ -186,7 +189,7 @@ const assertUniqueInBucket = (snippets, candidate, ignoreId) => {
186
189
 
187
190
  export const createPiSnippetsStore = ({
188
191
  file = join(resolvePiChamberDataDir(), "pi", "snippets.json"),
189
- fs = { chmod, mkdir, readFile, rename, rm, writeFile },
192
+ fs = { chmod, mkdir, readFile, readlink, realpath, rename, rm, writeFile },
190
193
  } = {}) => {
191
194
  let mutation = Promise.resolve();
192
195
 
@@ -208,21 +211,9 @@ export const createPiSnippetsStore = ({
208
211
 
209
212
  const writeRaw = async (snapshot) => {
210
213
  const validated = validateSnapshot(snapshot);
211
- const parent = dirname(file);
212
- await fs.mkdir(parent, { recursive: true, mode: 0o700 });
213
- const temporary = `${file}.tmp-${process.pid}-${randomUUID()}`;
214
- try {
215
- await fs.writeFile(temporary, `${JSON.stringify(validated, null, 2)}\n`, {
216
- encoding: "utf8",
217
- mode: 0o600,
218
- });
219
- await fs.rename(temporary, file);
220
- } catch (error) {
221
- await fs.rm(temporary, { force: true }).catch(() => {});
222
- throw error;
223
- }
224
- if (process.platform !== "win32")
225
- await fs.chmod(file, 0o600).catch(() => {});
214
+ await writeFileAtomic(file, `${JSON.stringify(validated, null, 2)}\n`, {
215
+ fs,
216
+ });
226
217
  return validated;
227
218
  };
228
219
 
@@ -1,7 +1,7 @@
1
- import { randomUUID } from 'node:crypto';
2
- import { chmod, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
1
+ import { chmod, mkdir, readFile, readlink, realpath, rename, rm, writeFile } from 'node:fs/promises';
3
2
  import { dirname, join } from 'node:path';
4
3
 
4
+ import { writeFileAtomic } from '../fs/atomic-write.js';
5
5
  import { resolvePiChamberDataDir } from '../pichamber-data-dir.js';
6
6
  import { withCrossProcessLock } from '../server/cross-process-lock.js';
7
7
 
@@ -26,7 +26,7 @@ const PORTABLE_FIELDS = new Set([
26
26
  'themeId', 'useSystemTheme', 'themeVariant', 'lightThemeId', 'darkThemeId',
27
27
  'splashBgLight', 'splashFgLight', 'splashBgDark', 'splashFgDark',
28
28
  'showDeletionDialog', 'nativeNotificationsEnabled', 'notificationMode',
29
- 'notifyOnCompletion', 'notifyOnError',
29
+ 'notifyOnCompletion', 'notifyOnError', 'notifyOnInputNeeded',
30
30
  'summarizeLastMessage', 'summaryThreshold', 'summaryLength',
31
31
  'maxLastMessageLength', 'usageAutoRefresh', 'usageRefreshIntervalMs',
32
32
  'usageDisplayMode', 'usageShowPredValues', 'usageDropdownProviders',
@@ -39,6 +39,7 @@ const PORTABLE_FIELDS = new Set([
39
39
  'weekStartPreference',
40
40
  'sidebarViewMode',
41
41
  'expandedEditorToolbar',
42
+ 'wrapLinesByDefault',
42
43
  'fontSize', 'terminalFontSize', 'editorFontSize', 'uiFont', 'monoFont', 'padding',
43
44
  'cornerRadius', 'inputBarOffset', 'shortcutOverrides', 'commandTriggers',
44
45
  'favoriteModels', 'hiddenModels', 'collapsedModelProviders', 'recentModels',
@@ -117,19 +118,14 @@ export const createDockerInitialLocalSettings = () => {
117
118
  const writeRecord = async (file, value, fs) => {
118
119
  const serialized = `${JSON.stringify(value, null, 2)}\n`;
119
120
  if (Buffer.byteLength(serialized) > MAX_SETTINGS_BYTES) throw new Error('UI_SETTINGS_INVALID');
120
- const parent = dirname(file);
121
- await fs.mkdir(parent, { recursive: true, mode: 0o700 });
122
- const temporary = `${file}.tmp-${process.pid}-${randomUUID()}`;
123
- await fs.writeFile(temporary, serialized, { encoding: 'utf8', mode: 0o600 });
124
- await fs.rename(temporary, file);
125
- if (process.platform !== 'win32') await fs.chmod(file, 0o600);
121
+ await writeFileAtomic(file, serialized, { fs });
126
122
  };
127
123
 
128
124
  export const createPiUiSettingsStore = ({
129
125
  file = join(resolvePiChamberDataDir(), 'settings.json'),
130
126
  runtimeFile = join(dirname(file), 'runtime-state.json'),
131
127
  initialLocalSettings = {},
132
- fs = { chmod, mkdir, readFile, rename, writeFile },
128
+ fs = { chmod, mkdir, readFile, readlink, realpath, rename, rm, writeFile },
133
129
  } = {}) => {
134
130
  let mutation = Promise.resolve();
135
131
 
@@ -1,5 +1,5 @@
1
1
  import { describe, expect, it } from 'vitest';
2
- import { mkdtemp, readFile, writeFile } from 'node:fs/promises';
2
+ import { lstat, mkdir, mkdtemp, readFile, readlink, symlink, writeFile } from 'node:fs/promises';
3
3
  import { tmpdir } from 'node:os';
4
4
  import { join } from 'node:path';
5
5
 
@@ -265,6 +265,23 @@ describe('Pi UI settings store', () => {
265
265
  });
266
266
  });
267
267
 
268
+ it('persists the input-needed notification toggle in portable settings', async () => {
269
+ const { file, store } = await makeStore();
270
+
271
+ await expect(store.write({ notifyOnInputNeeded: false })).resolves.toMatchObject({
272
+ notifyOnInputNeeded: false,
273
+ });
274
+ expect(await readJson(file)).toEqual({
275
+ __pichamberSettingsScope: 'portable-v1',
276
+ notifyOnInputNeeded: false,
277
+ });
278
+
279
+ await expect(store.write({ notifyOnInputNeeded: true })).resolves.toMatchObject({
280
+ notifyOnInputNeeded: true,
281
+ });
282
+ await expect(store.read()).resolves.toMatchObject({ notifyOnInputNeeded: true });
283
+ });
284
+
268
285
  it('preserves failure behavior for malformed and oversized payloads', async () => {
269
286
  const { file, store } = await makeStore();
270
287
  await writeFile(file, '{broken');
@@ -272,4 +289,23 @@ describe('Pi UI settings store', () => {
272
289
  const changes = JSON.parse('{"constructor":{"polluted":true}}');
273
290
  await expect(store.write(changes)).rejects.toThrow('UI_SETTINGS_INVALID');
274
291
  });
292
+
293
+ it('keeps a symlinked settings.json and writes through to its target', async () => {
294
+ const root = await mkdtemp(join(tmpdir(), 'pichamber-ui-settings-'));
295
+ const dotfiles = join(root, 'dotfiles');
296
+ const config = join(root, 'config');
297
+ await mkdir(dotfiles);
298
+ await mkdir(config);
299
+ const target = join(dotfiles, 'settings.json');
300
+ const file = join(config, 'settings.json');
301
+ await writeFile(target, JSON.stringify({ __pichamberSettingsScope: 'portable-v1', themeId: 'old' }));
302
+ await symlink('../dotfiles/settings.json', file);
303
+ const store = createPiUiSettingsStore({ file, runtimeFile: join(config, 'runtime-state.json') });
304
+
305
+ await store.write({ themeId: 'new' });
306
+
307
+ expect((await lstat(file)).isSymbolicLink()).toBe(true);
308
+ expect(await readlink(file)).toBe('../dotfiles/settings.json');
309
+ expect(await readJson(target)).toMatchObject({ themeId: 'new' });
310
+ });
275
311
  });
@@ -28,9 +28,11 @@ Traffic is modeled as three stacked layers. The relay understands only Layer 1;
28
28
  ## Entrypoints and structure
29
29
 
30
30
  Host side (`packages/web/server/lib/relay/`):
31
- - `service.js` — relay endpoint configuration only: exports `DEFAULT_RELAY_URL`. The host entrypoint (`createRelayService`: settings persistence, the `GET/POST /api/pichamber/relay/{status,enable,disable}` management routes, the `getPairingCandidate()` accessor, and host lifecycle wiring) was removed as dead code — no runtime wired it in. The CLI connect-url command resolves the relay endpoint (`DEFAULT_RELAY_URL`, the `PICHAMBER_RELAY_URL` env override, stored `settings.privateRelay.relayUrl`) the same way a host would.
32
- - `identity.js` — the host's stable identity: the long-lived signing keypair (shared with the push relay, defines the routing id) plus a long-lived encryption keypair (the E2EE trust anchor). Reused across restarts; never rotated implicitly.
31
+ - Relay endpoint configuration: there is no default relay endpoint. The CLI pair command resolves the relay URL from the `PICHAMBER_RELAY_URL` env override, then stored `settings.privateRelay.relayUrl` — when neither is a valid ws/wss URL there is no relay candidate. The host entrypoint (`createRelayService`: settings persistence, the `GET/POST /api/pichamber/relay/{status,enable,disable}` management routes, the `getPairingCandidate()` accessor, and host lifecycle wiring) was removed as dead code — no runtime wired it in.
32
+ - `identity.js` — the host's stable identity: the long-lived signing keypair (defines the serverId routing id) plus a long-lived encryption keypair (the E2EE trust anchor). Reused across restarts; never rotated implicitly.
33
33
  - `signing-key.js` — storage/derivation of the signing keypair and the routing id, shared with the notifications runtime.
34
+ - `identity-store.js` — the ONLY host-identity persistence (`createRelayIdentityStore({ dataDir })` → `{ readSettingsFromDiskMigrated, writeSettingsToDisk, readSettingsStrict }`, the accessor triple consumed by `signing-key.js` and `identity.js`). Backed by the host-local `<dataDir>/relay-identity.json`, which stores ONLY `relaySigningKey` and `relayEncryptionKey` (atomic temp-file + rename write, mode `0600`, `mkdir -p`). Migration: when `relay-identity.json` does not exist (`ENOENT`), reads fall back to those two keys in `<dataDir>/settings.json`, so legacy installs keep their `serverId`, and the found keys are copied into `relay-identity.json` on that read (best-effort; retried on the next read while `settings.json` still holds them). The server resolves its `serverId` during startup, before any route can run the UI settings store (which drops keys it does not own from `settings.json`), so the copy happens before the legacy keys can be stripped. Never writes to or modifies `settings.json` — which is portable (copied between hosts) and rewritten by the UI settings store, so it must never hold host identity (a UI save would delete the keys and the next start would mint a new identity, orphaning every paired device). Lenient reads map any failure to `{}`; strict reads throw on any non-`ENOENT` read error or JSON parse error of either file (never regenerate over a corrupt store).
35
+ - `server-id.js` — server-side resolver for that same signing-key `serverId` (`createServerIdResolver({ dataDir, crypto })` → `{ getServerId }`): reads/generates `relaySigningKey` via the identity store (`relay-identity.json`, the same store the CLI pairing command uses, so both report the same id) and derives the id. Exposed on `/health`, `/api/version`, and connection candidates, and injected into the Tailscale probe. The id is cached per process; concurrent first calls share one in-flight generation (at most one key per process); a corrupt identity store rejects instead of regenerating (regeneration gate), and a throwing `getServerId` means "no id" to callers.
34
36
  - `host-client.js` — the long-lived connection manager: one outbound control connection to the relay, a per-client data connection for each connected device, reconnect/backoff, and the E2EE responder handshake per connection.
35
37
  - `tunnel-host.js` — the per-connection dispatcher: decrypts tunnel frames and forwards HTTP/SSE/WS to the local server over loopback, then streams responses back. Enforces a path allowlist and never injects credentials.
36
38
  - `e2ee.js`, `tunnel-codec.js` — host-side (JS) mirrors of the shared crypto and framing (see "Two implementations" below).
@@ -80,8 +82,8 @@ candidate, and update its saved candidate set (mobile: `mobileConnections.ts`;
80
82
  desktop: `desktopRelayRestore.ts`).
81
83
 
82
84
  Identity gating: the response carries the stable `serverId` (base64url SHA-256 of
83
- the public signing JWK — the same identity the relay routes by, exposed by the
84
- relay service's `getServerId()` and echoed unauthenticated on `/health` and
85
+ the public signing JWK — the same identity the relay routes by, resolved by
86
+ `server-id.js` and echoed unauthenticated on `/health` and
85
87
  `/api/version`). Clients ignore a refresh whose `serverId` does not match their
86
88
  pinned relay identity, and verify `/health`'s `serverId` on a learned address
87
89
  **before** sending their bearer token to it — a re-assigned LAN address may now