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

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 (205) 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-BWG8peHt.js} +1 -1
  14. package/dist/assets/DiffView-C_uRNQMT.js +18 -0
  15. package/dist/assets/{FileSaveConflictDialog-DP7k9a-i.js → FileSaveConflictDialog-DlH8IWDL.js} +2 -2
  16. package/dist/assets/FilesView-RnF9JBPu.js +6 -0
  17. package/dist/assets/{GitHubDetailScaffold-UxLAMAOl.js → GitHubDetailScaffold-BTRvUnwh.js} +2 -2
  18. package/dist/assets/{GitHubLinkPicker-Bh9RO1yK.js → GitHubLinkPicker-CGi8p2zF.js} +1 -1
  19. package/dist/assets/{GitHubListPrimitives-DQyhT5wG.js → GitHubListPrimitives-XckcmdeA.js} +1 -1
  20. package/dist/assets/{GitView-XBBheKRM.js → GitView-DyPJ8Oay.js} +4 -4
  21. package/dist/assets/{IssuesSurface-BA1kpvAJ.js → IssuesSurface-rQ78ziEu.js} +3 -3
  22. package/dist/assets/{JsonTreeView-BAaEPL4O.js → JsonTreeView-Cy5NKUzx.js} +1 -1
  23. package/dist/assets/{MarkdownRendererImpl-DzgDmUsL.js → MarkdownRendererImpl-C5AlnAbG.js} +1 -1
  24. package/dist/assets/{PatchDiff-BMEUsgXH.js → PatchDiff-D6048My1.js} +1 -1
  25. package/dist/assets/PierreDiffViewer-_000TWrM.js +135 -0
  26. package/dist/assets/PullRequestsSurface-eACi4Yxm.js +2 -0
  27. package/dist/assets/SessionSwitcherContent-CFMjBIfH.js +1 -0
  28. package/dist/assets/SessionSwitcherDropdown-CINW_ydZ.js +2 -0
  29. package/dist/assets/SessionUnreadDot-YZJi4IFP.js +1 -0
  30. package/dist/assets/SettingsView-DBiQXIji.js +6 -0
  31. package/dist/assets/{SettingsWindow-j0e99YI0.js → SettingsWindow-Wvd56oG1.js} +1 -1
  32. package/dist/assets/StickyHorizontalScrollbar-BMITjK4e.js +8 -0
  33. package/dist/assets/{ToolOutputDialog-VlS12Xyq.js → ToolOutputDialog-DeDXQNWw.js} +4 -4
  34. package/dist/assets/{ToolPartDiffPreview-DdSneZws.js → ToolPartDiffPreview-DuN8fldE.js} +1 -1
  35. package/dist/assets/{VirtualizedFileDiff-BqiXjvP6.js → VirtualizedFileDiff-BYVjUxk9.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-E4gJTgVF.js} +1 -1
  39. package/dist/assets/{contextFileOpenGuard-BBzqKGei.js → contextFileOpenGuard-CcGZtZsz.js} +1 -1
  40. package/dist/assets/{gitStatusPredicates-Dq-E5DaH.js → gitStatusPredicates-C2H7tf7t.js} +1 -1
  41. package/dist/assets/{githubLink-Cryd7GkG.js → githubLink-DTEEkgAl.js} +5 -5
  42. package/dist/assets/{index-BbhXFTId.js → index-BKc_DF05.js} +1 -1
  43. package/dist/assets/index-DWSrsQWl.js +11 -0
  44. package/dist/assets/index-DsQIBAWK.css +1 -0
  45. package/dist/assets/main-BNoO2jRw.js +136 -0
  46. package/dist/assets/main-DnCR4Jva.js +2 -0
  47. package/dist/assets/{markdownCore-B9AuEyYi.js → markdownCore-CP1hsIRw.js} +2 -2
  48. package/dist/assets/{miniChat-CgOaJfD8.js → miniChat-BBI_B4OS.js} +2 -2
  49. package/dist/assets/mobile-dRWyYBgl.js +2 -0
  50. package/dist/assets/{nativeFileSave-BzhtrDoD.js → nativeFileSave-CFuugNKV.js} +1 -1
  51. package/dist/assets/pi-session-focus-preference-Cw78V7mw.js +9 -0
  52. package/dist/assets/{renderDiffWithHighlighter-CVLsdtQ5.js → renderDiffWithHighlighter-kdzNWs8-.js} +1 -1
  53. package/dist/assets/renderElectronMiniChatApp-uVOQvccp.js +2 -0
  54. package/dist/assets/{renderFileWithHighlighter-DJ9mk2bZ.js → renderFileWithHighlighter-BdeYSXwS.js} +1 -1
  55. package/dist/assets/renderMobileApp-Cdg1IAhJ.js +11 -0
  56. package/dist/assets/runtimeEndpointReset-thviM404.js +62 -0
  57. package/dist/assets/{runtimeSurface-DBiUWYK2.js → runtimeSurface-Der4qUnI.js} +1 -1
  58. package/dist/assets/useAppFontEffects-Bd0btzjJ.js +212 -0
  59. package/dist/assets/{useFilesViewSearch-D2Au5Xgt.js → useFilesViewSearch-Yvk43YOy.js} +3 -3
  60. package/dist/assets/useGitHubRemoteSearch-BUjSEnXC.js +1 -0
  61. package/dist/assets/{useSwitcherItems-Dej8BzXI.js → useSwitcherItems-D2opwbRZ.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-BeROQeen.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 +72 -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 +285 -0
  169. package/server/lib/tailscale/nc-probe.js +220 -0
  170. package/server/lib/tailscale/routes.js +45 -0
  171. package/server/lib/tailscale/service.js +1012 -0
  172. package/server/lib/tailscale/tailscale.js +302 -0
  173. package/server/lib/tailscale/tailscale.test.js +2080 -0
  174. package/server/lib/tunnels/DOCUMENTATION.md +3 -4
  175. package/server/lib/tunnels/providers/cloudflare.js +1 -22
  176. package/server/lib/tunnels/types.js +0 -2
  177. package/server/lib/ui-auth/DOCUMENTATION.md +31 -0
  178. package/server/lib/ui-auth/ui-auth.js +80 -6
  179. package/server/lib/ui-auth/ui-auth.test.js +136 -0
  180. package/server/lib/ui-auth/ui-passkeys.js +2 -13
  181. package/server/lib/update-job-store.js +4 -6
  182. package/dist/assets/DiffView-BxwoRCYx.js +0 -18
  183. package/dist/assets/FilesView-D_2QcdUt.js +0 -6
  184. package/dist/assets/PierreDiffViewer-BW8MO-O6.js +0 -134
  185. package/dist/assets/PullRequestsSurface-B3ictm4I.js +0 -2
  186. package/dist/assets/SessionSwitcherContent-rLoyVqgs.js +0 -1
  187. package/dist/assets/SessionSwitcherDropdown-CfySKnUu.js +0 -2
  188. package/dist/assets/SessionUnreadDot-CmEF9sxM.js +0 -1
  189. package/dist/assets/SettingsView-BiwlwnTK.js +0 -6
  190. package/dist/assets/index-BnZVqcki.js +0 -11
  191. package/dist/assets/index-BnieExes.css +0 -1
  192. package/dist/assets/main-9O5IAtT_.js +0 -136
  193. package/dist/assets/main-DWGwALIw.js +0 -2
  194. package/dist/assets/mobile-BbJcYVym.js +0 -2
  195. package/dist/assets/pi-session-focus-preference-Bmk1iOvn.js +0 -10
  196. package/dist/assets/renderElectronMiniChatApp-R5o9NwFC.js +0 -2
  197. package/dist/assets/renderMobileApp-CQ9tWYIj.js +0 -11
  198. package/dist/assets/runtimeEndpointReset-CtK4C_5h.js +0 -62
  199. package/dist/assets/useAppFontEffects-DviRbaCJ.js +0 -212
  200. package/dist/assets/useGitHubRemoteSearch-D-K7aolk.js +0 -1
  201. package/dist/assets/vendor-capacitor-push-notifications-CBKq2Arn.js +0 -1
  202. package/server/lib/notifications/delivery-runtime.js +0 -314
  203. package/server/lib/notifications/delivery-runtime.test.js +0 -85
  204. package/server/lib/notifications/routes.js +0 -74
  205. package/server/lib/relay/service.js +0 -9
@@ -0,0 +1,390 @@
1
+ /**
2
+ * Session engine router: daemon-owned dispatch that keeps session-daemon.js
3
+ * to thin call sites. The registry stays in `session-engines.js`; this
4
+ * module owns ownership-first routing, `sessions.create` targeting,
5
+ * listing merges, snapshot framing data, the redacting publish wrapper, and
6
+ * the `engines.list` description.
7
+ *
8
+ * Every function is a cheap guard when no engines are registered (or no
9
+ * registry exists), so the zero-engine path runs exactly the Pi-only code.
10
+ * All engine output is redacted through the injected `redact` dependency
11
+ * (the daemon passes `redactAttachmentValues`).
12
+ */
13
+
14
+ import { isAbsolute } from 'node:path';
15
+
16
+ import {
17
+ ENGINE_SESSION_COMMANDS,
18
+ ENGINE_UNSUPPORTED_OPERATION,
19
+ } from './session-engines.js';
20
+ import { normalizePendingInputSummary } from './pending-input.js';
21
+
22
+ const DETAIL_COMMANDS = new Set([
23
+ 'sessions.open',
24
+ 'sessions.messages',
25
+ 'sessions.navigate',
26
+ 'sessions.fork',
27
+ 'sessions.clone',
28
+ 'sessions.create',
29
+ ]);
30
+
31
+ const PROMPT_COMMANDS = new Set(['sessions.prompt', 'sessions.steer', 'sessions.followUp']);
32
+
33
+ const deliveryOf = (command) => (
34
+ command === 'sessions.steer' ? 'steer' : command === 'sessions.followUp' ? 'followUp' : undefined
35
+ );
36
+
37
+ const invalidArgument = (createError, message) => {
38
+ throw createError('INVALID_ARGUMENT', message);
39
+ };
40
+
41
+ /**
42
+ * @param {{
43
+ * getRegistry: () => ({ size: number } | undefined),
44
+ * resolveDirectory: (requested: unknown) => Promise<string>,
45
+ * sessionInput: (payload: object, delivery?: string, execute?: (payload: object) => Promise<object>) => Promise<object>,
46
+ * redact: (value: unknown) => unknown,
47
+ * createError: (code: string, message: string) => Error,
48
+ * logEngineError?: (engineId: string, event: string, error: unknown) => void,
49
+ * writeFrame: (socket: object, frame: object) => void,
50
+ * writeDetail: (socket: object, requestId: string, detail: object) => void,
51
+ * publish: (event: string, payload: object, sessionId: string, directory?: string) => void,
52
+ * getStreamEpoch: () => string,
53
+ * allocateSequence: () => number,
54
+ * protocolVersion: number,
55
+ * pendingInput?: { applyEngineSummary: (sessionId: string, directory: string, summary: object | null) => void, summaryFor: (sessionId: string) => object | null, forgetSession: (sessionId: string) => void },
56
+ * getSequence?: () => number,
57
+ * }} deps
58
+ */
59
+ export const createSessionEngineRouter = ({
60
+ getRegistry,
61
+ resolveDirectory,
62
+ sessionInput,
63
+ redact,
64
+ createError,
65
+ logEngineError,
66
+ writeFrame,
67
+ writeDetail,
68
+ publish,
69
+ getStreamEpoch,
70
+ allocateSequence,
71
+ protocolVersion,
72
+ pendingInput,
73
+ getSequence,
74
+ } = {}) => {
75
+ // Redaction is mandatory: engine output never reaches the wire unredacted.
76
+ if (typeof redact !== 'function') throw new TypeError('Session engine output requires a redact function.');
77
+ const applyRedact = redact;
78
+ const fail = (code, message) => {
79
+ throw createError(code, message);
80
+ };
81
+
82
+ const hasEngines = () => {
83
+ const registry = getRegistry?.();
84
+ return Boolean(registry) && registry.size > 0;
85
+ };
86
+
87
+ const ownerOfSession = (sessionId, directory) => getRegistry?.()?.ownerOfSession?.(sessionId, directory);
88
+
89
+ const publishEngineEvent = (event, payload, sessionId, directory, publishingEngineId) => {
90
+ if (typeof event !== 'string' || event.length === 0 || event === 'session.snapshot') {
91
+ return fail('INVALID_ARGUMENT', 'The session engine event is invalid.');
92
+ }
93
+ if (typeof sessionId !== 'string' || sessionId.length === 0) {
94
+ return fail('INVALID_ARGUMENT', 'The session engine event session is invalid.');
95
+ }
96
+ if (payload !== undefined && (!payload || typeof payload !== 'object' || Array.isArray(payload))) {
97
+ return fail('INVALID_ARGUMENT', 'The session engine event payload is invalid.');
98
+ }
99
+ if (typeof directory !== 'string' || directory.length === 0 || !isAbsolute(directory)) {
100
+ return fail('INVALID_ARGUMENT', 'The session engine event directory is invalid.');
101
+ }
102
+ // Engines MUST publish `session.input { pending }` on every pending-input
103
+ // transition for live updates. The summary is normalized and folded into
104
+ // the daemon pending-input index, which publishes the canonical event;
105
+ // the engine payload itself is never published directly. Only the engine
106
+ // that owns the session may report its pending input: ownership is
107
+ // checked against the registry so an engine cannot mark a Pi-runtime
108
+ // session (or another engine's session) as needing input.
109
+ if (event === 'session.input') {
110
+ const pending = normalizePendingInputSummary(payload?.pending);
111
+ if (pending === undefined) {
112
+ return fail('INVALID_ARGUMENT', 'The session engine pending input is invalid.');
113
+ }
114
+ let owner;
115
+ try {
116
+ owner = ownerOfSession(sessionId, directory);
117
+ } catch {
118
+ owner = undefined;
119
+ }
120
+ if (!owner || owner.id !== publishingEngineId) {
121
+ return fail('INVALID_ARGUMENT', 'The session engine does not own this session.');
122
+ }
123
+ pendingInput?.applyEngineSummary(sessionId, directory, pending);
124
+ return;
125
+ }
126
+ // `session.deleted` already tells clients; drop pending-input state
127
+ // without publishing a redundant `session.input`.
128
+ if (event === 'session.deleted') {
129
+ pendingInput?.forgetSession(sessionId);
130
+ }
131
+ // Engine notifications are live-only: normalize the level, cap the
132
+ // message, and publish through the usual redaction. An invalid notice
133
+ // is a silent no-op (no publish, no throw). Nothing is stored.
134
+ if (event === 'extension.notify') {
135
+ const raw = payload ?? {};
136
+ if (typeof raw.message !== 'string' || raw.message.length === 0) return;
137
+ publish(event, applyRedact({
138
+ message: raw.message.slice(0, 2000),
139
+ level: raw.level === 'warning' || raw.level === 'error' ? raw.level : 'info',
140
+ }), sessionId, directory);
141
+ return;
142
+ }
143
+ const { sessionId: _payloadSessionId, directory: _payloadDirectory, ...cleanPayload } = payload ?? {};
144
+ publish(event, applyRedact(cleanPayload), sessionId, directory);
145
+ };
146
+
147
+ const snapshotEvent = (sessionId, { resync = false } = {}) => {
148
+ if (typeof sessionId !== 'string' || sessionId.length === 0 || !hasEngines()) return undefined;
149
+ const owner = ownerOfSession(sessionId);
150
+ if (!owner) return undefined;
151
+ let fields;
152
+ try {
153
+ fields = owner.snapshot(sessionId);
154
+ } catch (error) {
155
+ try {
156
+ logEngineError?.(owner.id, 'snapshot-failed', error);
157
+ } catch {}
158
+ return undefined;
159
+ }
160
+ if (!fields || typeof fields !== 'object' || typeof fields.then === 'function') return undefined;
161
+ const safeFields = applyRedact(fields);
162
+ if (typeof safeFields?.directory !== 'string' || safeFields.directory.length === 0
163
+ || !isAbsolute(safeFields.directory)) return undefined;
164
+ const nextSequence = allocateSequence();
165
+ // Daemon-owned pending input: the engine MAY carry
166
+ // `inputState: { pending }` on snapshot fields; otherwise the last
167
+ // `session.input` summary from the index applies. Placed after spreading
168
+ // safeFields so the engine cannot inject a malformed value.
169
+ const snapshotPending = normalizePendingInputSummary(safeFields?.inputState?.pending);
170
+ return {
171
+ sequence: nextSequence,
172
+ payload: {
173
+ isStreaming: false,
174
+ lifecycle: 'idle',
175
+ queue: { steering: 0, followUp: 0 },
176
+ ...safeFields,
177
+ inputState: {
178
+ pending: snapshotPending === undefined ? (pendingInput?.summaryFor(sessionId) ?? null) : snapshotPending,
179
+ },
180
+ sessionId,
181
+ directory: safeFields.directory,
182
+ ...(resync ? { resync: true } : {}),
183
+ serverNow: Date.now(),
184
+ lastSequence: nextSequence,
185
+ },
186
+ };
187
+ };
188
+
189
+ const stampDetail = (detail, engineId) => {
190
+ if (!detail || typeof detail !== 'object') return detail;
191
+ const safe = applyRedact(detail);
192
+ const detailPending = normalizePendingInputSummary(safe?.inputState?.pending);
193
+ const sessionId = safe?.session && typeof safe.session === 'object' ? safe.session.id : undefined;
194
+ const withInput = {
195
+ inputState: {
196
+ pending: detailPending === undefined
197
+ ? (typeof sessionId === 'string' ? (pendingInput?.summaryFor(sessionId) ?? null) : null)
198
+ : detailPending,
199
+ },
200
+ };
201
+ if (safe.session && typeof safe.session === 'object') {
202
+ return { ...safe, ...withInput, session: { ...safe.session, engine: engineId } };
203
+ }
204
+ return { ...safe, ...withInput };
205
+ };
206
+
207
+ const runHandler = async (engine, command, payload) => {
208
+ const handler = engine.handlers?.[command];
209
+ if (typeof handler !== 'function') {
210
+ return fail(ENGINE_UNSUPPORTED_OPERATION, 'The session engine does not support this command.');
211
+ }
212
+ return handler(payload);
213
+ };
214
+
215
+ const dispatch = async (socket, message) => {
216
+ const registry = getRegistry?.();
217
+ if (!registry || registry.size === 0) return false;
218
+ if (ENGINE_SESSION_COMMANDS.has(message?.command)) {
219
+ const engineSessionId = message?.payload?.sessionId;
220
+ if (typeof engineSessionId === 'string' && engineSessionId.length > 0) {
221
+ const owner = registry.ownerOfSession(engineSessionId, message.payload?.directory || message.payload?.cwd);
222
+ if (owner) {
223
+ const payload = message.payload ?? {};
224
+ const requestedDir = payload.directory || payload.cwd;
225
+ const enginePayload = requestedDir !== undefined
226
+ ? { ...payload, directory: await resolveDirectory(requestedDir) }
227
+ : payload;
228
+ if (PROMPT_COMMANDS.has(message.command)) {
229
+ const delivery = deliveryOf(message.command);
230
+ const result = await sessionInput(enginePayload, delivery, (promptPayload) => Promise.resolve()
231
+ .then(() => runHandler(owner, message.command, promptPayload))
232
+ .then((engineResult) => {
233
+ if (!engineResult || typeof engineResult !== 'object'
234
+ || typeof engineResult.messageId !== 'string' || engineResult.messageId.length === 0) {
235
+ return fail('MALFORMED_DAEMON_RESPONSE', 'The session engine returned an invalid response.');
236
+ }
237
+ return { ...applyRedact(engineResult), accepted: true };
238
+ }));
239
+ writeFrame(socket, {
240
+ protocolVersion, kind: 'response', requestId: message.requestId, result,
241
+ });
242
+ return true;
243
+ }
244
+ const engineResult = await runHandler(owner, message.command, enginePayload);
245
+ if (DETAIL_COMMANDS.has(message.command)) {
246
+ if (!engineResult || typeof engineResult !== 'object') {
247
+ return fail('MALFORMED_DAEMON_RESPONSE', 'The session engine returned an invalid response.');
248
+ }
249
+ writeDetail(socket, message.requestId, stampDetail(engineResult, owner.id));
250
+ return true;
251
+ }
252
+ writeFrame(socket, {
253
+ protocolVersion, kind: 'response', requestId: message.requestId, result: applyRedact(engineResult ?? {}),
254
+ });
255
+ return true;
256
+ }
257
+ }
258
+ return false;
259
+ }
260
+ if (message?.command === 'extensions.draft') {
261
+ const engineSessionId = message?.payload?.sessionId;
262
+ if (typeof engineSessionId === 'string' && engineSessionId.length > 0
263
+ && registry.ownerOfSession(engineSessionId, message.payload?.directory || message.payload?.cwd)) {
264
+ return fail(ENGINE_UNSUPPORTED_OPERATION, 'The session engine does not support drafts.');
265
+ }
266
+ }
267
+ return false;
268
+ };
269
+
270
+ const resolveCreateOwner = (createPayload) => {
271
+ const requestedEngine = createPayload && typeof createPayload === 'object' ? createPayload.engine : undefined;
272
+ const registry = getRegistry?.();
273
+ if (requestedEngine !== undefined) {
274
+ if (requestedEngine === 'pi') return undefined;
275
+ const owner = typeof requestedEngine === 'string' ? registry?.get?.(requestedEngine) : undefined;
276
+ if (!owner) return fail('INVALID_ARGUMENT', 'The requested session engine is invalid.');
277
+ if (typeof owner.handlers?.['sessions.create'] !== 'function') {
278
+ return fail(ENGINE_UNSUPPORTED_OPERATION, 'The session engine does not support creation.');
279
+ }
280
+ return owner;
281
+ }
282
+ if (!hasEngines() || !createPayload || typeof createPayload !== 'object'
283
+ || typeof createPayload.model?.providerId !== 'string') {
284
+ return undefined;
285
+ }
286
+ const owner = registry.ownerOfProvider(createPayload.model.providerId);
287
+ if (!owner) return undefined;
288
+ if (typeof owner.handlers?.['sessions.create'] !== 'function') return undefined;
289
+ return owner;
290
+ };
291
+
292
+ const create = async (socket, message) => {
293
+ const createPayload = message?.payload;
294
+ const owner = resolveCreateOwner(createPayload);
295
+ if (!owner) return false;
296
+ if (!createPayload || typeof createPayload !== 'object') {
297
+ return invalidArgument(createError, 'The requested session creation options are invalid.');
298
+ }
299
+ const createTargetCwd = await resolveDirectory(createPayload.cwd);
300
+ const created = await runHandler(owner, 'sessions.create', { ...createPayload, cwd: createTargetCwd });
301
+ if (!created || typeof created !== 'object') {
302
+ return fail('MALFORMED_DAEMON_RESPONSE', 'The session engine returned an invalid response.');
303
+ }
304
+ writeDetail(socket, message.requestId, stampDetail(created, owner.id));
305
+ return true;
306
+ };
307
+
308
+ const mergeSessionList = async (piSessions, targetDir) => {
309
+ const registry = getRegistry?.();
310
+ if (!registry || registry.size === 0) return { sessions: piSessions };
311
+ const engineSessions = await registry.listSessions(targetDir);
312
+ // Sampled once when the engine result is merged so every engine row
313
+ // carries the same sequence.
314
+ const observedSequence = typeof getSequence === 'function' ? getSequence() : 0;
315
+ const seenSessionIds = new Set(piSessions.map((item) => item?.session?.id));
316
+ const mergedSessions = [...piSessions];
317
+ const failedSessionEngines = [...engineSessions.failed];
318
+ for (const item of engineSessions.items) {
319
+ if (seenSessionIds.has(item?.session?.id)) {
320
+ if (!failedSessionEngines.includes(item.session.engine)) failedSessionEngines.push(item.session.engine);
321
+ continue;
322
+ }
323
+ seenSessionIds.add(item?.session?.id);
324
+ // Engines MAY carry `inputState: { pending }` on list rows; a missing
325
+ // or malformed value falls back to the index without failing the row.
326
+ // The redaction step above never breaks this: the summary carries only
327
+ // count/kind/since, never paths.
328
+ const rowPending = normalizePendingInputSummary(item?.inputState?.pending);
329
+ mergedSessions.push({
330
+ ...item,
331
+ inputState: {
332
+ pending: rowPending === undefined
333
+ ? (pendingInput?.summaryFor(item?.session?.id) ?? null)
334
+ : rowPending,
335
+ sequence: observedSequence,
336
+ },
337
+ });
338
+ }
339
+ return {
340
+ sessions: mergedSessions,
341
+ ...(failedSessionEngines.length > 0 ? { incompleteEngines: failedSessionEngines } : {}),
342
+ };
343
+ };
344
+
345
+ const mergeProviders = async (piResult) => {
346
+ const registry = getRegistry?.();
347
+ if (!registry || registry.size === 0) return { providers: piResult.providers };
348
+ const engineProviders = await registry.listProviders();
349
+ const seenProviderIds = new Set(piResult.providers.map((provider) => provider.id));
350
+ const mergedProviders = [...piResult.providers];
351
+ const failedProviderEngines = [...engineProviders.failed];
352
+ for (const provider of engineProviders.providers) {
353
+ if (seenProviderIds.has(provider.id)) {
354
+ if (!failedProviderEngines.includes(provider.engine)) failedProviderEngines.push(provider.engine);
355
+ continue;
356
+ }
357
+ seenProviderIds.add(provider.id);
358
+ const { engine: _providerEngine, ...cleanProvider } = provider;
359
+ mergedProviders.push(applyRedact(cleanProvider));
360
+ }
361
+ return {
362
+ providers: mergedProviders,
363
+ ...(failedProviderEngines.length > 0 ? { incompleteEngines: failedProviderEngines } : {}),
364
+ };
365
+ };
366
+
367
+ const describe = () => {
368
+ const registry = getRegistry?.();
369
+ if (!registry || registry.size === 0) return { engines: [] };
370
+ return {
371
+ engines: registry.describeEngines().map((entry) => ({
372
+ id: entry.id,
373
+ label: entry.label,
374
+ commands: [...entry.commands],
375
+ })),
376
+ };
377
+ };
378
+
379
+ return {
380
+ hasEngines,
381
+ publish: publishEngineEvent,
382
+ snapshotEvent,
383
+ dispatch,
384
+ create,
385
+ resolveCreateOwner,
386
+ mergeSessionList,
387
+ mergeProviders,
388
+ describe,
389
+ };
390
+ };