@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,188 @@
1
+ // Daemon-owned "pending input" state: whether a session is blocked waiting
2
+ // for the user. Every device learns it without opening the session through
3
+ // `sessions.list` rows, snapshots, details, `sessions.pendingInput`, and
4
+ // `session.input` events. Sources are daemon-hosted blocking requests (today
5
+ // Pi extension dialogs) and registered session engines reporting through the
6
+ // engine contract. The contract never assumes a Pi runtime.
7
+ export const PENDING_INPUT_KINDS = Object.freeze(['input', 'approval']);
8
+
9
+ export const MAX_PENDING_INPUT_COUNT = 99;
10
+
11
+ const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
12
+
13
+ // Normalize a wire summary. `null` means authoritatively nothing pending;
14
+ // `undefined` means unknown (older daemon) or malformed. Unknown kind
15
+ // strings normalize to 'input'; a zero count normalizes to null.
16
+ export const normalizePendingInputSummary = (value) => {
17
+ if (value === null) return null;
18
+ if (value === undefined) return undefined;
19
+ if (!isRecord(value)) return undefined;
20
+ const rawCount = value.count;
21
+ if (typeof rawCount !== 'number' || !Number.isSafeInteger(rawCount)) return undefined;
22
+ if (rawCount <= 0) {
23
+ if (rawCount === 0) return null;
24
+ return undefined;
25
+ }
26
+ if (typeof value.since !== 'number' || !Number.isFinite(value.since) || value.since <= 0) return undefined;
27
+ const kind = typeof value.kind === 'string' && PENDING_INPUT_KINDS.includes(value.kind) ? value.kind : 'input';
28
+ return {
29
+ count: Math.min(rawCount, MAX_PENDING_INPUT_COUNT),
30
+ kind,
31
+ since: value.since,
32
+ };
33
+ };
34
+
35
+ const sameSummary = (left, right) => {
36
+ if (left === null && right === null) return true;
37
+ if (!left || !right) return false;
38
+ return left.count === right.count && left.kind === right.kind && left.since === right.since;
39
+ };
40
+
41
+ const validId = (value) => typeof value === 'string' && value.length > 0;
42
+
43
+ // Small synchronous index with no timers. Hosted requests carry insertion
44
+ // order so ties on `since` resolve deterministically. When a session has
45
+ // both hosted requests and an engine summary, hosted wins.
46
+ export const createPendingInputIndex = ({ publish, now = Date.now, onHostedSessionSettled } = {}) => {
47
+ // sessionId -> { directory, hosted: Map(requestId -> { since, kind, order }),
48
+ // engine: summary|null }
49
+ const bySession = new Map();
50
+ let order = 0;
51
+
52
+ const entryFor = (sessionId) => bySession.get(sessionId);
53
+
54
+ const deriveHosted = (entry) => {
55
+ if (!entry || entry.hosted.size === 0) return null;
56
+ let oldest;
57
+ for (const record of entry.hosted.values()) {
58
+ if (!oldest || record.since < oldest.since
59
+ || (record.since === oldest.since && record.order < oldest.order)) {
60
+ oldest = record;
61
+ }
62
+ }
63
+ return {
64
+ count: Math.min(entry.hosted.size, MAX_PENDING_INPUT_COUNT),
65
+ kind: oldest.kind,
66
+ since: oldest.since,
67
+ };
68
+ };
69
+
70
+ const derivedFor = (entry) => deriveHosted(entry) ?? entry?.engine ?? null;
71
+
72
+ const maybePublish = (sessionId, entry) => {
73
+ const summary = derivedFor(entry);
74
+ if (sameSummary(entry?.published ?? null, summary)) return;
75
+ if (entry) entry.published = summary;
76
+ const directory = entry?.directory;
77
+ if (typeof publish === 'function' && typeof directory === 'string' && directory.length > 0) {
78
+ publish('session.input', { pending: summary, serverNow: now() }, sessionId, directory);
79
+ }
80
+ };
81
+
82
+ // A settled entry has published `null`, so dropping it keeps the index
83
+ // bounded by sessions that currently need input.
84
+ const dropIfSettled = (sessionId, entry) => {
85
+ if (entry.hosted.size === 0 && entry.engine === null) bySession.delete(sessionId);
86
+ };
87
+
88
+ const open = ({ sessionId, directory, requestId, kind = 'input' } = {}) => {
89
+ if (!validId(sessionId) || !validId(requestId)) return;
90
+ if (typeof directory !== 'string' || directory.length === 0) return;
91
+ let entry = bySession.get(sessionId);
92
+ if (!entry) {
93
+ entry = { directory, hosted: new Map(), engine: null, published: null };
94
+ bySession.set(sessionId, entry);
95
+ }
96
+ entry.directory = directory;
97
+ if (entry.hosted.has(requestId)) return;
98
+ order += 1;
99
+ entry.hosted.set(requestId, {
100
+ since: now(),
101
+ kind: typeof kind === 'string' && PENDING_INPUT_KINDS.includes(kind) ? kind : 'input',
102
+ order,
103
+ });
104
+ maybePublish(sessionId, entry);
105
+ };
106
+
107
+ const close = (sessionId, requestId) => {
108
+ if (!validId(sessionId) || !validId(requestId)) return;
109
+ const entry = bySession.get(sessionId);
110
+ if (!entry || !entry.hosted.delete(requestId)) return;
111
+ const settled = entry.hosted.size === 0;
112
+ maybePublish(sessionId, entry);
113
+ dropIfSettled(sessionId, entry);
114
+ if (settled) {
115
+ try {
116
+ onHostedSessionSettled?.(sessionId);
117
+ } catch {}
118
+ }
119
+ };
120
+
121
+ const applyEngineSummary = (sessionId, directory, summary) => {
122
+ if (!validId(sessionId)) return;
123
+ if (typeof directory !== 'string' || directory.length === 0) return;
124
+ if (summary !== null && !isRecord(summary)) return;
125
+ let entry = bySession.get(sessionId);
126
+ if (!entry) {
127
+ entry = { directory, hosted: new Map(), engine: null, published: null };
128
+ bySession.set(sessionId, entry);
129
+ }
130
+ entry.directory = directory;
131
+ entry.engine = summary;
132
+ maybePublish(sessionId, entry);
133
+ dropIfSettled(sessionId, entry);
134
+ };
135
+
136
+ const summaryFor = (sessionId) => {
137
+ if (!validId(sessionId)) return null;
138
+ return derivedFor(entryFor(sessionId));
139
+ };
140
+
141
+ const hasHostedRequests = (sessionId) => {
142
+ if (!validId(sessionId)) return false;
143
+ return (entryFor(sessionId)?.hosted.size ?? 0) > 0;
144
+ };
145
+
146
+ const list = () => {
147
+ const rows = [];
148
+ for (const [sessionId, entry] of bySession) {
149
+ const pending = derivedFor(entry);
150
+ if (!pending) continue;
151
+ rows.push({ sessionId, directory: entry.directory, pending });
152
+ }
153
+ rows.sort((left, right) => left.pending.since - right.pending.since);
154
+ return rows;
155
+ };
156
+
157
+ const forgetSession = (sessionId) => {
158
+ if (!validId(sessionId)) return;
159
+ bySession.delete(sessionId);
160
+ };
161
+
162
+ const clear = () => {
163
+ for (const [sessionId, entry] of [...bySession]) {
164
+ if (!derivedFor(entry)) {
165
+ bySession.delete(sessionId);
166
+ continue;
167
+ }
168
+ entry.hosted.clear();
169
+ entry.engine = null;
170
+ entry.published = null;
171
+ if (typeof publish === 'function') {
172
+ publish('session.input', { pending: null, serverNow: now() }, sessionId, entry.directory);
173
+ }
174
+ bySession.delete(sessionId);
175
+ }
176
+ };
177
+
178
+ return {
179
+ open,
180
+ close,
181
+ applyEngineSummary,
182
+ summaryFor,
183
+ hasHostedRequests,
184
+ list,
185
+ forgetSession,
186
+ clear,
187
+ };
188
+ };
@@ -0,0 +1,202 @@
1
+ import { describe, expect, it } from 'vitest';
2
+
3
+ import {
4
+ MAX_PENDING_INPUT_COUNT,
5
+ PENDING_INPUT_KINDS,
6
+ createPendingInputIndex,
7
+ normalizePendingInputSummary,
8
+ } from './pending-input.js';
9
+
10
+ describe('normalizePendingInputSummary', () => {
11
+ it('passes null through as authoritatively nothing pending', () => {
12
+ expect(normalizePendingInputSummary(null)).toBeNull();
13
+ });
14
+
15
+ it('returns undefined for malformed values', () => {
16
+ expect(normalizePendingInputSummary(undefined)).toBeUndefined();
17
+ expect(normalizePendingInputSummary('pending')).toBeUndefined();
18
+ expect(normalizePendingInputSummary(42)).toBeUndefined();
19
+ expect(normalizePendingInputSummary([])).toBeUndefined();
20
+ expect(normalizePendingInputSummary({})).toBeUndefined();
21
+ expect(normalizePendingInputSummary({ count: '1', kind: 'input', since: 5 })).toBeUndefined();
22
+ expect(normalizePendingInputSummary({ count: 1.5, kind: 'input', since: 5 })).toBeUndefined();
23
+ expect(normalizePendingInputSummary({ count: -1, kind: 'input', since: 5 })).toBeUndefined();
24
+ expect(normalizePendingInputSummary({ count: 1, kind: 'input' })).toBeUndefined();
25
+ expect(normalizePendingInputSummary({ count: 1, kind: 'input', since: 0 })).toBeUndefined();
26
+ expect(normalizePendingInputSummary({ count: 1, kind: 'input', since: Number.NaN })).toBeUndefined();
27
+ expect(normalizePendingInputSummary(null, undefined)).toBeNull();
28
+ });
29
+
30
+ it('normalizes a zero count to null', () => {
31
+ expect(normalizePendingInputSummary({ count: 0, kind: 'input', since: 5 })).toBeNull();
32
+ });
33
+
34
+ it('clamps the count and copies only the three wire keys', () => {
35
+ expect(normalizePendingInputSummary({
36
+ count: 500, kind: 'approval', since: 7, sessionId: 's1', extra: true,
37
+ })).toEqual({ count: MAX_PENDING_INPUT_COUNT, kind: 'approval', since: 7 });
38
+ expect(MAX_PENDING_INPUT_COUNT).toBe(99);
39
+ expect(PENDING_INPUT_KINDS).toEqual(['input', 'approval']);
40
+ });
41
+
42
+ it('normalizes unknown or missing kinds to input', () => {
43
+ expect(normalizePendingInputSummary({ count: 2, kind: 'question', since: 9 })).toEqual({
44
+ count: 2, kind: 'input', since: 9,
45
+ });
46
+ expect(normalizePendingInputSummary({ count: 2, since: 9 })).toEqual({
47
+ count: 2, kind: 'input', since: 9,
48
+ });
49
+ expect(normalizePendingInputSummary({ count: 2, kind: 42, since: 9 })).toEqual({
50
+ count: 2, kind: 'input', since: 9,
51
+ });
52
+ });
53
+
54
+ it('returns a fresh object', () => {
55
+ const value = { count: 1, kind: 'input', since: 3 };
56
+ const normalized = normalizePendingInputSummary(value);
57
+ expect(normalized).toEqual(value);
58
+ expect(normalized).not.toBe(value);
59
+ });
60
+ });
61
+
62
+ describe('createPendingInputIndex', () => {
63
+ const setup = ({ nowStart = 1000 } = {}) => {
64
+ const events = [];
65
+ let now = nowStart;
66
+ const settled = [];
67
+ const index = createPendingInputIndex({
68
+ publish: (event, payload, sessionId, directory) => events.push({ event, payload, sessionId, directory }),
69
+ now: () => {
70
+ now += 100;
71
+ return now;
72
+ },
73
+ onHostedSessionSettled: (sessionId) => settled.push(sessionId),
74
+ });
75
+ return { events, settled, index };
76
+ };
77
+
78
+ it('derives the summary from the oldest hosted request', () => {
79
+ const { events, index } = setup();
80
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r1' });
81
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r2', kind: 'approval' });
82
+ expect(index.summaryFor('s1')).toEqual({ count: 2, kind: 'input', since: 1100 });
83
+ expect(events.map((entry) => entry.event)).toEqual(['session.input', 'session.input']);
84
+ expect(events[0].payload.pending).toEqual({ count: 1, kind: 'input', since: 1100 });
85
+ expect(events[1].payload.pending).toEqual({ count: 2, kind: 'input', since: 1100 });
86
+ expect(events[1].directory).toBe('/d');
87
+ });
88
+
89
+ it('ignores invalid ids and re-opening an existing request', () => {
90
+ const { events, index } = setup();
91
+ index.open({ sessionId: '', directory: '/d', requestId: 'r1' });
92
+ index.open({ sessionId: 's1', directory: '/d', requestId: '' });
93
+ index.open({ sessionId: 's1', directory: '', requestId: 'r1' });
94
+ expect(index.summaryFor('s1')).toBeNull();
95
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r1' });
96
+ const before = events.length;
97
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r1' });
98
+ expect(events).toHaveLength(before);
99
+ expect(index.summaryFor('s1')).toEqual({ count: 1, kind: 'input', since: 1100 });
100
+ });
101
+
102
+ it('closes requests and calls onHostedSessionSettled once when the last one closes', () => {
103
+ const { events, settled, index } = setup();
104
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r1' });
105
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r2' });
106
+ events.length = 0;
107
+ index.close('s1', 'r1');
108
+ expect(index.summaryFor('s1')).toEqual({ count: 1, kind: 'input', since: 1300 });
109
+ expect(settled).toEqual([]);
110
+ expect(events).toHaveLength(1);
111
+ expect(events[0].payload.pending).toEqual({ count: 1, kind: 'input', since: 1300 });
112
+ index.close('s1', 'r1');
113
+ expect(events).toHaveLength(1);
114
+ index.close('s1', 'r2');
115
+ expect(index.summaryFor('s1')).toBeNull();
116
+ expect(events).toHaveLength(2);
117
+ expect(events[1].payload.pending).toEqual(null);
118
+ expect(settled).toEqual(['s1']);
119
+ });
120
+
121
+ it('stores and clears engine summaries', () => {
122
+ const { events, settled, index } = setup();
123
+ expect(index.summaryFor('s9')).toBeNull();
124
+ index.applyEngineSummary('s9', '/eng', { count: 3, kind: 'approval', since: 50 });
125
+ expect(index.summaryFor('s9')).toEqual({ count: 3, kind: 'approval', since: 50 });
126
+ expect(events).toHaveLength(1);
127
+ index.applyEngineSummary('s9', '/eng', { count: 3, kind: 'approval', since: 50 });
128
+ expect(events).toHaveLength(1);
129
+ index.applyEngineSummary('s9', '/eng', null);
130
+ expect(index.summaryFor('s9')).toBeNull();
131
+ expect(events).toHaveLength(2);
132
+ expect(events[1].payload.pending).toEqual(null);
133
+ expect(settled).toEqual([]);
134
+ });
135
+
136
+ it('prefers hosted requests over engine summaries', () => {
137
+ const { index } = setup();
138
+ index.applyEngineSummary('s1', '/d', { count: 4, kind: 'approval', since: 10 });
139
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r1' });
140
+ expect(index.summaryFor('s1')).toEqual({ count: 1, kind: 'input', since: 1200 });
141
+ index.close('s1', 'r1');
142
+ expect(index.summaryFor('s1')).toEqual({ count: 4, kind: 'approval', since: 10 });
143
+ });
144
+
145
+ it('lists pending sessions sorted by oldest since', () => {
146
+ const { index } = setup();
147
+ index.open({ sessionId: 's2', directory: '/b', requestId: 'r1' });
148
+ index.open({ sessionId: 's1', directory: '/a', requestId: 'r1' });
149
+ index.applyEngineSummary('s3', '/c', { count: 1, kind: 'input', since: 50 });
150
+ const list = index.list();
151
+ expect(list.map((entry) => entry.sessionId)).toEqual(['s3', 's2', 's1']);
152
+ expect(list[0]).toEqual({ sessionId: 's3', directory: '/c', pending: { count: 1, kind: 'input', since: 50 } });
153
+ });
154
+
155
+ it('forgets sessions silently and clears with null publication', () => {
156
+ const { events, index } = setup();
157
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r1' });
158
+ index.applyEngineSummary('s2', '/e', { count: 1, kind: 'input', since: 5 });
159
+ events.length = 0;
160
+ index.forgetSession('s1');
161
+ expect(index.summaryFor('s1')).toBeNull();
162
+ expect(events).toHaveLength(0);
163
+ index.clear();
164
+ expect(index.summaryFor('s2')).toBeNull();
165
+ expect(index.list()).toEqual([]);
166
+ expect(events).toHaveLength(1);
167
+ expect(events[0].event).toBe('session.input');
168
+ expect(events[0].payload.pending).toBeNull();
169
+ expect(events[0].sessionId).toBe('s2');
170
+ expect(events[0].directory).toBe('/e');
171
+ });
172
+
173
+ it('publishes serverNow from the injected clock', () => {
174
+ const events = [];
175
+ let now = 5000;
176
+ const index = createPendingInputIndex({
177
+ publish: (event, payload, sessionId, directory) => events.push({ event, payload, sessionId, directory }),
178
+ now: () => now,
179
+ });
180
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r1' });
181
+ expect(events[0].payload.serverNow).toBe(5000);
182
+ now = 6000;
183
+ index.close('s1', 'r1');
184
+ expect(events.at(-1).payload).toEqual({ pending: null, serverNow: 6000 });
185
+ });
186
+
187
+ it('reports hosted requests and tolerates a throwing settle callback', () => {
188
+ const events = [];
189
+ const index = createPendingInputIndex({
190
+ publish: (event, payload, sessionId, directory) => events.push({ event, payload, sessionId, directory }),
191
+ onHostedSessionSettled: () => {
192
+ throw new Error('settle listener failed');
193
+ },
194
+ });
195
+ expect(index.hasHostedRequests('s1')).toBe(false);
196
+ index.open({ sessionId: 's1', directory: '/d', requestId: 'r1' });
197
+ expect(index.hasHostedRequests('s1')).toBe(true);
198
+ expect(() => index.close('s1', 'r1')).not.toThrow();
199
+ expect(index.hasHostedRequests('s1')).toBe(false);
200
+ expect(events.at(-1)).toMatchObject({ event: 'session.input', payload: { pending: null } });
201
+ });
202
+ });