@pi-chamber/web 1.0.7 → 1.0.8-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 (212) hide show
  1. package/dist/assets/AgentsSurface-BmHImX8m.js +1 -0
  2. package/dist/assets/ChoicesArtifact-C71fGOm2.js +1 -0
  3. package/dist/assets/DiagramView-BZQxoiZu.js +1 -0
  4. package/dist/assets/{DiffView-BxW6BuOC.js → DiffView-C70pbgk-.js} +6 -6
  5. package/dist/assets/FileSaveConflictDialog-Cu8c3gBV.js +3 -0
  6. package/dist/assets/FilesView-nFJYEdRw.js +6 -0
  7. package/dist/assets/GitHubDetailScaffold-Jvv_tgbl.js +11 -0
  8. package/dist/assets/GitHubLinkPicker-BXD2ODRi.js +1 -0
  9. package/dist/assets/GitHubListPrimitives-BWI706F0.js +1 -0
  10. package/dist/assets/{GitView-DD33ngnM.js → GitView-MIDG5RYW.js} +5 -5
  11. package/dist/assets/{IssuesSurface-BAY_eyX5.js → IssuesSurface-uNlozeu0.js} +2 -2
  12. package/dist/assets/{JsonTreeView-DpXbUrAl.js → JsonTreeView-CSLsTriz.js} +1 -1
  13. package/dist/assets/{MarkdownRendererImpl-Cn63lAmn.js → MarkdownRendererImpl-Cs-7BfWi.js} +3 -3
  14. package/dist/assets/PatchDiff-axbsnbTJ.js +1 -0
  15. package/dist/assets/PierreDiffViewer-lwn6w_5w.js +147 -0
  16. package/dist/assets/PullRequestsSurface-o_AXDjbO.js +2 -0
  17. package/dist/assets/{SessionSwitcherContent-CscYekC1.js → SessionSwitcherContent-C4CMlcbv.js} +1 -1
  18. package/dist/assets/SessionSwitcherDropdown-DCBVuCoo.js +2 -0
  19. package/dist/assets/SessionUnreadDot-DyeIrsro.js +1 -0
  20. package/dist/assets/SettingsView-BHBpt2Um.js +7 -0
  21. package/dist/assets/{SettingsWindow-gxjULdm1.js → SettingsWindow-Cb4st5y5.js} +1 -1
  22. package/dist/assets/{StickyHorizontalScrollbar-DNsbTLS7.js → StickyHorizontalScrollbar-CMbTn5WQ.js} +1 -1
  23. package/dist/assets/SubagentsArtifact-BzeMEoFP.js +1 -0
  24. package/dist/assets/ToolOutputDialog-BP2mOWdV.js +8 -0
  25. package/dist/assets/ToolPartDiffPreview-D49XBR9b.js +1 -0
  26. package/dist/assets/{VirtualizedFileDiff-BrbPymTL.js → VirtualizedFileDiff-CLgDONEQ.js} +4 -4
  27. package/dist/assets/{Virtualizer-okhy9Aq3.js → Virtualizer-PxblpQn6.js} +1 -1
  28. package/dist/assets/VisualFrame-CJrAvWSo.js +22 -0
  29. package/dist/assets/VisualsArtifact-DqLGgU-Q.js +1 -0
  30. package/dist/assets/{collapsible-D6qdoq7-.js → collapsible-BeyKtQGB.js} +1 -1
  31. package/dist/assets/{computeVirtualFileMetrics-G4csGiKs.js → computeVirtualFileMetrics-DmO6H8u6.js} +2 -2
  32. package/dist/assets/contextFileOpenGuard-DOK251YW.js +1 -0
  33. package/dist/assets/{fileTreeStatus-Bskhj4qT.js → fileTreeStatus-CnzR7kxA.js} +2 -2
  34. package/dist/assets/gitStatusPredicates-4kPg2t6j.js +1 -0
  35. package/dist/assets/githubLink-QvaLfNNT.js +10 -0
  36. package/dist/assets/{index-I2QYqABE.js → index-B2v0_mez.js} +8 -8
  37. package/dist/assets/index-D3F4JrPN.css +1 -0
  38. package/dist/assets/{index-ComwtfT4.js → index-DMX9wT1Z.js} +1 -1
  39. package/dist/assets/{main-DoiadX0a.js → main-BW9J3Y72.js} +2 -2
  40. package/dist/assets/main-BirYxac2.js +137 -0
  41. package/dist/assets/{markdownCore-DczkEluO.js → markdownCore-CxmcPur8.js} +2 -2
  42. package/dist/assets/miniChat-BRB11eEs.js +2 -0
  43. package/dist/assets/{mobile-BucKVm1P.js → mobile-DJZYYCuB.js} +2 -2
  44. package/dist/assets/{nativeFileSave-Cp9i5QGd.js → nativeFileSave-B6QpoPRn.js} +1 -1
  45. package/dist/assets/pi-session-focus-preference-PWoh3LNA.js +9 -0
  46. package/dist/assets/{renderDiffWithHighlighter-PL82AR81.js → renderDiffWithHighlighter-C48T6YFJ.js} +1 -1
  47. package/dist/assets/renderElectronMiniChatApp-N-BQdJl0.js +2 -0
  48. package/dist/assets/{renderFileWithHighlighter-CYgfbA4F.js → renderFileWithHighlighter-8Kt2MyTN.js} +1 -1
  49. package/dist/assets/{renderMobileApp-Bp74b_Lo.js → renderMobileApp-B7cT7m5b.js} +3 -3
  50. package/dist/assets/runtimeEndpointReset-BC6yGnxN.js +62 -0
  51. package/dist/assets/runtimeSurface-kIEoYsPP.js +1 -0
  52. package/dist/assets/selection-BTEdLRVK.js +1 -0
  53. package/dist/assets/useAppFontEffects-EcTZ_I_I.js +225 -0
  54. package/dist/assets/useGitHubRemoteSearch-DIBHNu8r.js +1 -0
  55. package/dist/assets/useSwitcherItems-DfLbfX37.js +1 -0
  56. package/dist/assets/{vendor-aparajita-capacitor-secure-storage-DVZvgYu4.js → vendor-aparajita-capacitor-secure-storage-DUoR8t1G.js} +1 -1
  57. package/dist/assets/{vendor-base-ui-BCqPBzDj.js → vendor-base-ui-DE6jnTiC.js} +1 -1
  58. package/dist/assets/{vendor-boot-3SaHYVb1.js → vendor-boot-D-KEJjsM.js} +29 -29
  59. package/dist/assets/{vendor-capacitor-app-NbQ-WiPS.js → vendor-capacitor-app-CO5jS31X.js} +1 -1
  60. package/dist/assets/{vendor-capacitor-keyboard-CgrHt8iN.js → vendor-capacitor-keyboard-335osRpd.js} +1 -1
  61. package/dist/assets/{vendor-capacitor-status-bar-CWt0OF5t.js → vendor-capacitor-status-bar-lB9y4H9d.js} +1 -1
  62. package/dist/assets/{vendor-codemirror-autocomplete-WThuuUAz.js → vendor-codemirror-autocomplete-BKvJ8PfM.js} +1 -1
  63. package/dist/assets/{vendor-codemirror-lang-angular-BbLGCxF6.js → vendor-codemirror-lang-angular-wjCUD0bM.js} +1 -1
  64. package/dist/assets/{vendor-codemirror-lang-cpp-Cceks-9O.js → vendor-codemirror-lang-cpp-LJzlG8sJ.js} +1 -1
  65. package/dist/assets/{vendor-codemirror-lang-css-D1wpUg3Z.js → vendor-codemirror-lang-css-DoEEdEpW.js} +1 -1
  66. package/dist/assets/{vendor-codemirror-lang-go-Cv0zXHHM.js → vendor-codemirror-lang-go-DexsLPb8.js} +1 -1
  67. package/dist/assets/{vendor-codemirror-lang-html-DbL8oT9H.js → vendor-codemirror-lang-html-h25V-Hp5.js} +1 -1
  68. package/dist/assets/{vendor-codemirror-lang-java-CNugenuC.js → vendor-codemirror-lang-java-D8xoT8cv.js} +1 -1
  69. package/dist/assets/{vendor-codemirror-lang-javascript-Bx_FIyZF.js → vendor-codemirror-lang-javascript-DF3GDYje.js} +1 -1
  70. package/dist/assets/{vendor-codemirror-lang-jinja-DDGjB3Zq.js → vendor-codemirror-lang-jinja-BboTHFdn.js} +1 -1
  71. package/dist/assets/{vendor-codemirror-lang-json-DIvqf9Pb.js → vendor-codemirror-lang-json-DCqvG1nE.js} +1 -1
  72. package/dist/assets/{vendor-codemirror-lang-less-D8r9dGG1.js → vendor-codemirror-lang-less-B8ZrSKJM.js} +1 -1
  73. package/dist/assets/{vendor-codemirror-lang-liquid-B24mguYi.js → vendor-codemirror-lang-liquid-DF9S5m5F.js} +1 -1
  74. package/dist/assets/{vendor-codemirror-lang-markdown-v3yG2sbf.js → vendor-codemirror-lang-markdown-6BNbCEPe.js} +1 -1
  75. package/dist/assets/{vendor-codemirror-lang-php-BcZGalqy.js → vendor-codemirror-lang-php-CQwAz1Hd.js} +1 -1
  76. package/dist/assets/{vendor-codemirror-lang-python-b-JqEwQy.js → vendor-codemirror-lang-python-DQym-8Tx.js} +1 -1
  77. package/dist/assets/{vendor-codemirror-lang-rust-B1uZxDW-.js → vendor-codemirror-lang-rust-DknzOTkO.js} +1 -1
  78. package/dist/assets/{vendor-codemirror-lang-sass-DqPrngKp.js → vendor-codemirror-lang-sass-dB0Rm5HI.js} +1 -1
  79. package/dist/assets/{vendor-codemirror-lang-sql-UyCnpt-k.js → vendor-codemirror-lang-sql-CCQUnnD-.js} +1 -1
  80. package/dist/assets/{vendor-codemirror-lang-vue-xDwYkovV.js → vendor-codemirror-lang-vue-h1M5bF00.js} +1 -1
  81. package/dist/assets/{vendor-codemirror-lang-wast-CF3169p_.js → vendor-codemirror-lang-wast-DWgtlGfu.js} +1 -1
  82. package/dist/assets/{vendor-codemirror-lang-xml-FCtVhuOb.js → vendor-codemirror-lang-xml-DncwoCUY.js} +1 -1
  83. package/dist/assets/{vendor-codemirror-lang-yaml-g0sPmAnv.js → vendor-codemirror-lang-yaml-C7QkS5ER.js} +1 -1
  84. package/dist/assets/{vendor-codemirror-language-data-B03xgzP2.js → vendor-codemirror-language-data-BUZIlm3G.js} +2 -2
  85. package/dist/assets/{vendor-codemirror-search-Dw3Wpu15.js → vendor-codemirror-search-BlDCaCMK.js} +1 -1
  86. package/dist/assets/{vendor-lezer-cpp-Cu3E-KUI.js → vendor-lezer-cpp-B4JK1BC1.js} +1 -1
  87. package/dist/assets/{vendor-lezer-css-Cb8vp67u.js → vendor-lezer-css-DRxDmhcy.js} +1 -1
  88. package/dist/assets/{vendor-lezer-go-BTsIaOm7.js → vendor-lezer-go-DsUgfmxi.js} +1 -1
  89. package/dist/assets/{vendor-lezer-html-UQMsUwj-.js → vendor-lezer-html-qr9pUPmM.js} +1 -1
  90. package/dist/assets/{vendor-lezer-java-BIWrFrAx.js → vendor-lezer-java-6UyNiQiB.js} +1 -1
  91. package/dist/assets/{vendor-lezer-javascript-BH2Etgoy.js → vendor-lezer-javascript-CUdJ0VGA.js} +1 -1
  92. package/dist/assets/{vendor-lezer-json-CE-QUCwM.js → vendor-lezer-json-BKYAA8Hu.js} +1 -1
  93. package/dist/assets/{vendor-lezer-lr-HY6Yc0Vr.js → vendor-lezer-lr-DluApmOX.js} +1 -1
  94. package/dist/assets/{vendor-lezer-markdown-xFL3Evwf.js → vendor-lezer-markdown-B-uzYzYT.js} +1 -1
  95. package/dist/assets/{vendor-lezer-php-Cr_mQGrG.js → vendor-lezer-php-DI6PNjlz.js} +1 -1
  96. package/dist/assets/{vendor-lezer-python-BNRFWCb0.js → vendor-lezer-python-Bj232yb5.js} +1 -1
  97. package/dist/assets/{vendor-lezer-rust-BvfOK5cU.js → vendor-lezer-rust-DlPG_Yau.js} +1 -1
  98. package/dist/assets/{vendor-lezer-sass-qoxiLisk.js → vendor-lezer-sass-CBsyWB2A.js} +1 -1
  99. package/dist/assets/{vendor-lezer-xml--x8SSpqU.js → vendor-lezer-xml-C1FmgtmE.js} +1 -1
  100. package/dist/assets/{vendor-lezer-yaml-BDo1JaEr.js → vendor-lezer-yaml-DpHmjriG.js} +1 -1
  101. package/dist/assets/{vendor-replit-codemirror-vim-D1Fe7FiY.js → vendor-replit-codemirror-vim-Cvk64got.js} +1 -1
  102. package/dist/assets/{web-components-CGDpzixf.js → web-components-C_DsTJis.js} +4 -4
  103. package/dist/index.html +4 -4
  104. package/dist/mini-chat.html +3 -3
  105. package/dist/mobile.html +3 -3
  106. package/package.json +2 -1
  107. package/plugins/registry.json +7 -0
  108. package/plugins/subagents/LICENSE +25 -0
  109. package/plugins/subagents/agents/planner.md +36 -0
  110. package/plugins/subagents/agents/reviewer.md +34 -0
  111. package/plugins/subagents/agents/scout.md +49 -0
  112. package/plugins/subagents/agents/worker.md +23 -0
  113. package/plugins/subagents/extension.js +631 -0
  114. package/plugins/subagents/extension.test.js +295 -0
  115. package/plugins/subagents/package.json +41 -0
  116. package/plugins/visuals/choices.js +168 -0
  117. package/plugins/visuals/extension.js +87 -0
  118. package/plugins/visuals/files.js +74 -0
  119. package/plugins/visuals/package.json +32 -0
  120. package/server/index.js +20 -0
  121. package/server/lib/github/DOCUMENTATION.md +4 -2
  122. package/server/lib/github/gh-cli.js +35 -9
  123. package/server/lib/github/gh-cli.test.js +122 -0
  124. package/server/lib/notifications/pi-notification-watcher.js +3 -0
  125. package/server/lib/notifications/pi-notification-watcher.test.js +10 -0
  126. package/server/lib/open-url/DOCUMENTATION.md +1 -1
  127. package/server/lib/pi/extension-protocol.js +54 -0
  128. package/server/lib/pi/fixtures/pichamber-gui-demo.ts +12 -13
  129. package/server/lib/pi/routes-extension-events.test.js +115 -0
  130. package/server/lib/pi/routes.js +307 -5
  131. package/server/lib/pi/routes.test.js +296 -1
  132. package/server/lib/pi/session-daemon/DOCUMENTATION.md +25 -8
  133. package/server/lib/pi/session-daemon/extension-bridge.js +89 -29
  134. package/server/lib/pi/session-daemon/extension-config.js +719 -0
  135. package/server/lib/pi/session-daemon/extension-config.test.js +618 -0
  136. package/server/lib/pi/session-daemon/extension-controls.js +177 -0
  137. package/server/lib/pi/session-daemon/extension-controls.test.js +181 -0
  138. package/server/lib/pi/session-daemon/extension-name.js +6 -0
  139. package/server/lib/pi/session-daemon/extension-name.test.js +5 -0
  140. package/server/lib/pi/session-daemon/extension-palette.js +146 -0
  141. package/server/lib/pi/session-daemon/extension-palette.test.js +107 -0
  142. package/server/lib/pi/session-daemon/extension-replacements.js +138 -0
  143. package/server/lib/pi/session-daemon/extension-replacements.test.js +116 -0
  144. package/server/lib/pi/session-daemon/extension-ui-mode.js +30 -0
  145. package/server/lib/pi/session-daemon/extension-ui-mode.test.js +34 -0
  146. package/server/lib/pi/session-daemon/pichamber-ui.js +44 -0
  147. package/server/lib/pi/session-daemon/plugin-host.js +245 -0
  148. package/server/lib/pi/session-daemon/plugin-host.test.js +192 -0
  149. package/server/lib/pi/session-daemon/session-daemon-controls.e2e.test.js +205 -0
  150. package/server/lib/pi/session-daemon/session-daemon-drafts.e2e.test.js +409 -0
  151. package/server/lib/pi/session-daemon/session-daemon-extension-config.e2e.test.js +196 -0
  152. package/server/lib/pi/session-daemon/session-daemon-extensions.test.js +137 -6
  153. package/server/lib/pi/session-daemon/session-daemon-plugins.e2e.test.js +272 -0
  154. package/server/lib/pi/session-daemon/session-daemon-providers.e2e.test.js +153 -0
  155. package/server/lib/pi/session-daemon/session-daemon.js +568 -61
  156. package/server/lib/pi/session-daemon/session-daemon.test.js +164 -4
  157. package/server/lib/pi/session-daemon/session-engine-router.js +7 -0
  158. package/server/lib/pi/session-daemon/session-engine-router.test.js +20 -0
  159. package/server/lib/pi/session-daemon/supervisor.js +22 -3
  160. package/server/lib/pi/settings-store.js +14 -0
  161. package/server/lib/pi/settings-store.test.js +11 -0
  162. package/server/lib/plugins/DOCUMENTATION.md +186 -0
  163. package/server/lib/plugins/daemon-sync.js +78 -0
  164. package/server/lib/plugins/daemon-sync.supervisor.test.js +83 -0
  165. package/server/lib/plugins/daemon-sync.test.js +96 -0
  166. package/server/lib/plugins/impact.js +139 -0
  167. package/server/lib/plugins/impact.test.js +82 -0
  168. package/server/lib/plugins/manifest.js +195 -0
  169. package/server/lib/plugins/manifest.test.js +118 -0
  170. package/server/lib/plugins/registry.js +59 -0
  171. package/server/lib/plugins/routes.js +92 -0
  172. package/server/lib/plugins/routes.test.js +219 -0
  173. package/server/lib/plugins/service.js +161 -0
  174. package/server/lib/plugins/store.js +261 -0
  175. package/server/lib/plugins/store.test.js +188 -0
  176. package/server/lib/plugins/visuals-extension.test.js +237 -0
  177. package/server/lib/server-browser/DOCUMENTATION.md +32 -7
  178. package/server/lib/server-browser/browser-tab.js +4 -1
  179. package/server/lib/server-browser/downloads.js +261 -34
  180. package/server/lib/server-browser/downloads.test.js +171 -0
  181. package/server/lib/server-browser/runtime.integration.test.js +47 -0
  182. package/server/lib/server-browser/runtime.js +16 -0
  183. package/server/lib/server-browser/server-browser.js +25 -6
  184. package/server/lib/tunnels/executable-search.js +5 -1
  185. package/server/lib/tunnels/executable-search.test.js +26 -0
  186. package/dist/assets/DiagramView-BB-aZobi.js +0 -1
  187. package/dist/assets/FileSaveConflictDialog-Bzz8FNMq.js +0 -3
  188. package/dist/assets/FilesView-DECxN8Z0.js +0 -6
  189. package/dist/assets/GitHubDetailScaffold-CWsWycRd.js +0 -11
  190. package/dist/assets/GitHubLinkPicker-BVYdg_e8.js +0 -1
  191. package/dist/assets/GitHubListPrimitives-Dlv3tC4d.js +0 -1
  192. package/dist/assets/PatchDiff-BklyOEHs.js +0 -1
  193. package/dist/assets/PierreDiffViewer-wc6cB6qw.js +0 -147
  194. package/dist/assets/PullRequestsSurface-BZvJkT1I.js +0 -2
  195. package/dist/assets/SessionSwitcherDropdown-DShvvGwC.js +0 -2
  196. package/dist/assets/SessionUnreadDot-CbqRq6h_.js +0 -1
  197. package/dist/assets/SettingsView-DcF-At5E.js +0 -6
  198. package/dist/assets/ToolOutputDialog-DdMIfrnK.js +0 -8
  199. package/dist/assets/ToolPartDiffPreview-C6Sm4eVf.js +0 -1
  200. package/dist/assets/contextFileOpenGuard-UU86YHgI.js +0 -1
  201. package/dist/assets/gitStatusPredicates-DQEO4Psc.js +0 -1
  202. package/dist/assets/githubLink-ByPAyFjh.js +0 -10
  203. package/dist/assets/index-BaLCg7tL.css +0 -1
  204. package/dist/assets/main-DyFfbllq.js +0 -137
  205. package/dist/assets/miniChat-Ck6MEZ9Q.js +0 -2
  206. package/dist/assets/pi-session-focus-preference-Dx0UXPoO.js +0 -9
  207. package/dist/assets/renderElectronMiniChatApp-Cb7s7dWl.js +0 -2
  208. package/dist/assets/runtimeEndpointReset-7nWYnKd4.js +0 -62
  209. package/dist/assets/runtimeSurface-CFwnvks_.js +0 -1
  210. package/dist/assets/useAppFontEffects-ZTyNwFk6.js +0 -213
  211. package/dist/assets/useGitHubRemoteSearch-BF3ohpsh.js +0 -1
  212. package/dist/assets/useSwitcherItems-BJzwyDGX.js +0 -1
@@ -0,0 +1,261 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { homedir } from 'node:os';
3
+ import { isAbsolute, join, resolve } from 'node:path';
4
+
5
+ import { writeFileAtomic } from '../fs/atomic-write.js';
6
+ import { resolvePiChamberDataDir } from '../pichamber-data-dir.js';
7
+ import { withCrossProcessLock } from '../server/cross-process-lock.js';
8
+ import { defaultPluginState, isValidStateValue } from './manifest.js';
9
+
10
+ // `<dataDir>/pi/plugins.json`:
11
+ // { version: 1, enabled: { [id]: bool },
12
+ // state: { [id]: { global: {..}, projects: { [dir]: {..} }, sessions: { [sessionId]: {..} } } } }
13
+ // `sessions` holds the values a composer switch set for one session; only
14
+ // keys a composer toggle names can be set there.
15
+ // The server owns this file. The daemon never reads it (it may run in a
16
+ // sandbox without access to the data folder); it receives the enabled set and
17
+ // state over IPC.
18
+
19
+ const MAX_DIRECTORY_LENGTH = 4096;
20
+ const MAX_SESSION_ID_LENGTH = 256;
21
+ /** Per plugin. Past it the least recently set sessions are dropped. */
22
+ export const MAX_SESSIONS_PER_PLUGIN = 1000;
23
+ const SESSION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
24
+ const FORBIDDEN_KEYS = new Set(['__proto__', 'prototype', 'constructor']);
25
+
26
+ export class PluginStoreError extends Error {
27
+ constructor(code, message) {
28
+ super(message);
29
+ this.code = code;
30
+ }
31
+ }
32
+
33
+ const unreadable = () => new PluginStoreError('PLUGINS_UNREADABLE', 'The plugin settings file is unreadable.');
34
+ const invalidRequest = (message = 'The plugin request is invalid.') => new PluginStoreError('INVALID_PLUGIN_REQUEST', message);
35
+
36
+ const isRecord = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
37
+ const isStoredValue = (value) => typeof value === 'boolean' || typeof value === 'string';
38
+
39
+ const emptySnapshot = () => ({ version: 1, enabled: {}, state: {} });
40
+
41
+ /**
42
+ * Normalize a project directory key: absolute, resolved, `~` expanded. Returns
43
+ * null for anything else.
44
+ */
45
+ export const normalizePluginDirectory = (value, home = homedir()) => {
46
+ if (typeof value !== 'string') return null;
47
+ const trimmed = value.trim();
48
+ if (trimmed.length === 0 || trimmed.length > MAX_DIRECTORY_LENGTH || trimmed.includes('\0')) return null;
49
+ if (trimmed === '~') return resolve(home);
50
+ if (!isAbsolute(trimmed)) return null;
51
+ return resolve(trimmed);
52
+ };
53
+
54
+ /** A Pi session id as a store key, or null. */
55
+ export const normalizePluginSessionId = (value) => (
56
+ typeof value === 'string' && value.length <= MAX_SESSION_ID_LENGTH && SESSION_ID_PATTERN.test(value)
57
+ && !FORBIDDEN_KEYS.has(value) ? value : null
58
+ );
59
+
60
+ /** Keys a composer toggle names: the only ones a session can set. */
61
+ const isSessionStateKey = (manifest, key) => (
62
+ manifest.stateSchema[key]?.type === 'boolean'
63
+ && manifest.contributes.composerToggles.some((toggle) => toggle.state === key)
64
+ );
65
+
66
+ const parseValues = (value) => {
67
+ if (!isRecord(value)) throw unreadable();
68
+ const values = {};
69
+ for (const [key, stored] of Object.entries(value)) {
70
+ if (FORBIDDEN_KEYS.has(key) || !isStoredValue(stored)) throw unreadable();
71
+ values[key] = stored;
72
+ }
73
+ return values;
74
+ };
75
+
76
+ // Shape-level validation only. Unknown plugin ids and keys are kept so a
77
+ // plugin that is missing for a while (or a newer build's plugin) keeps its
78
+ // settings. Values are checked against the manifest when they are resolved.
79
+ const parseSnapshot = (value) => {
80
+ if (!isRecord(value) || value.version !== 1) throw unreadable();
81
+ const enabledInput = value.enabled ?? {};
82
+ const stateInput = value.state ?? {};
83
+ if (!isRecord(enabledInput) || !isRecord(stateInput)) throw unreadable();
84
+ const snapshot = emptySnapshot();
85
+ for (const [id, enabled] of Object.entries(enabledInput)) {
86
+ if (FORBIDDEN_KEYS.has(id) || typeof enabled !== 'boolean') throw unreadable();
87
+ snapshot.enabled[id] = enabled;
88
+ }
89
+ for (const [id, entry] of Object.entries(stateInput)) {
90
+ if (FORBIDDEN_KEYS.has(id) || !isRecord(entry)) throw unreadable();
91
+ const projectsInput = entry.projects ?? {};
92
+ const sessionsInput = entry.sessions ?? {};
93
+ if (!isRecord(projectsInput) || !isRecord(sessionsInput)) throw unreadable();
94
+ const projects = {};
95
+ for (const [directory, values] of Object.entries(projectsInput)) {
96
+ if (FORBIDDEN_KEYS.has(directory)) throw unreadable();
97
+ projects[directory] = parseValues(values);
98
+ }
99
+ const sessions = {};
100
+ for (const [sessionId, values] of Object.entries(sessionsInput)) {
101
+ if (!normalizePluginSessionId(sessionId)) throw unreadable();
102
+ sessions[sessionId] = parseValues(values);
103
+ }
104
+ snapshot.state[id] = { global: parseValues(entry.global ?? {}), projects, sessions };
105
+ }
106
+ return snapshot;
107
+ };
108
+
109
+ /**
110
+ * Resolve one plugin's state for a directory: project value over global
111
+ * value over the manifest default. Values that no longer match the manifest
112
+ * (a removed enum option, a changed type, a key moved to another scope) fall
113
+ * back to the default. A key a composer toggle sets always starts from the
114
+ * default; only a session's own value changes it (`resolveSessionOverrides`).
115
+ */
116
+ export const resolvePluginState = (manifest, snapshot, directory) => {
117
+ const resolved = defaultPluginState(manifest);
118
+ const stored = snapshot.state[manifest.id];
119
+ if (!stored) return resolved;
120
+ const project = directory ? stored.projects[directory] : undefined;
121
+ for (const [key, field] of Object.entries(manifest.stateSchema)) {
122
+ if (isSessionStateKey(manifest, key)) continue;
123
+ const source = field.scope === 'project' ? project : stored.global;
124
+ if (source && Object.hasOwn(source, key) && isValidStateValue(field, source[key])) resolved[key] = source[key];
125
+ }
126
+ return resolved;
127
+ };
128
+
129
+ /**
130
+ * One session's own values for a plugin: valid values of keys a composer
131
+ * toggle names. Everything else follows `resolvePluginState`.
132
+ */
133
+ export const resolveSessionOverrides = (manifest, snapshot, sessionId) => {
134
+ const stored = snapshot.state[manifest.id]?.sessions?.[sessionId];
135
+ if (!stored) return {};
136
+ const overrides = {};
137
+ for (const [key, value] of Object.entries(stored)) {
138
+ if (isSessionStateKey(manifest, key) && isValidStateValue(manifest.stateSchema[key], value)) overrides[key] = value;
139
+ }
140
+ return overrides;
141
+ };
142
+
143
+ /** Whether the plugin is on: the stored choice, else the manifest default. */
144
+ export const isPluginEnabled = (manifest, snapshot) => (
145
+ Object.hasOwn(snapshot.enabled, manifest.id) ? snapshot.enabled[manifest.id] : manifest.defaultEnabled
146
+ );
147
+
148
+ export const createPluginStore = ({ file = join(resolvePiChamberDataDir(), 'pi', 'plugins.json') } = {}) => {
149
+ let writeChain = Promise.resolve();
150
+
151
+ /** Missing file is an empty store; a malformed file throws PLUGINS_UNREADABLE. */
152
+ const read = async () => {
153
+ let raw;
154
+ try {
155
+ raw = await readFile(file, 'utf8');
156
+ } catch (error) {
157
+ if (error?.code === 'ENOENT') return emptySnapshot();
158
+ throw unreadable();
159
+ }
160
+ let parsed;
161
+ try {
162
+ parsed = JSON.parse(raw);
163
+ } catch {
164
+ throw unreadable();
165
+ }
166
+ return parseSnapshot(parsed);
167
+ };
168
+
169
+ // Serialized in this process and across processes sharing the data folder.
170
+ // Each mutation re-reads under the lock, so a write never drops another
171
+ // writer's change. A malformed file stops every write instead of being
172
+ // overwritten.
173
+ const mutate = (change) => {
174
+ const operation = writeChain.then(() => withCrossProcessLock(`${file}.lock`, async () => {
175
+ const current = await read();
176
+ change(current);
177
+ await writeFileAtomic(file, `${JSON.stringify(current, null, 2)}\n`);
178
+ return current;
179
+ }));
180
+ writeChain = operation.catch(() => {});
181
+ return operation;
182
+ };
183
+
184
+ const setEnabled = (manifest, enabled) => {
185
+ if (typeof enabled !== 'boolean') return Promise.reject(invalidRequest());
186
+ return mutate((current) => {
187
+ current.enabled[manifest.id] = enabled;
188
+ });
189
+ };
190
+
191
+ /**
192
+ * Store one state value. The key's scope comes from the manifest; a
193
+ * project-scoped key needs a directory. A key a composer toggle sets has no
194
+ * global or project value: it is set per session only.
195
+ */
196
+ const setState = (manifest, { key, value, directory }) => {
197
+ const field = typeof key === 'string' && Object.hasOwn(manifest.stateSchema, key) ? manifest.stateSchema[key] : null;
198
+ if (!field || !isValidStateValue(field, value) || isSessionStateKey(manifest, key)) return Promise.reject(invalidRequest());
199
+ let projectDirectory = null;
200
+ if (field.scope === 'project') {
201
+ projectDirectory = normalizePluginDirectory(directory);
202
+ if (!projectDirectory) return Promise.reject(invalidRequest('A project value needs a directory.'));
203
+ }
204
+ return mutate((current) => {
205
+ const entry = current.state[manifest.id] ?? { global: {}, projects: {}, sessions: {} };
206
+ current.state[manifest.id] = entry;
207
+ if (projectDirectory) {
208
+ entry.projects[projectDirectory] = { ...(entry.projects[projectDirectory] ?? {}), [key]: value };
209
+ } else {
210
+ entry.global[key] = value;
211
+ }
212
+ });
213
+ };
214
+
215
+ /**
216
+ * Store or clear (`value: null`) one session's own value. The session
217
+ * moves to the end, so the oldest are the ones dropped past the cap.
218
+ */
219
+ const setSessionState = (manifest, { sessionId, key, value }) => {
220
+ const id = normalizePluginSessionId(sessionId);
221
+ if (!id || typeof key !== 'string' || !isSessionStateKey(manifest, key)) return Promise.reject(invalidRequest());
222
+ if (value !== null && !isValidStateValue(manifest.stateSchema[key], value)) return Promise.reject(invalidRequest());
223
+ return mutate((current) => {
224
+ const entry = current.state[manifest.id] ?? { global: {}, projects: {}, sessions: {} };
225
+ current.state[manifest.id] = entry;
226
+ const values = { ...(entry.sessions[id] ?? {}) };
227
+ if (value === null) delete values[key];
228
+ else values[key] = value;
229
+ delete entry.sessions[id];
230
+ if (Object.keys(values).length > 0) entry.sessions[id] = values;
231
+ const ids = Object.keys(entry.sessions);
232
+ const over = ids.slice(0, Math.max(0, ids.length - MAX_SESSIONS_PER_PLUGIN));
233
+ for (const dropped of over) delete entry.sessions[dropped];
234
+ if (over.length > 0) {
235
+ console.warn(`[plugins] ${manifest.id}: over ${MAX_SESSIONS_PER_PLUGIN} sessions with their own switches; forgot the ${over.length} least recently set`);
236
+ }
237
+ });
238
+ };
239
+
240
+ /**
241
+ * Drop a deleted session's values from every plugin. Resolves whether
242
+ * anything was removed; the file is not written when nothing was.
243
+ */
244
+ const forgetSession = async (sessionId) => {
245
+ const id = normalizePluginSessionId(sessionId);
246
+ if (!id) return false;
247
+ const holds = (snapshot) => Object.values(snapshot.state).some((entry) => Object.hasOwn(entry.sessions ?? {}, id));
248
+ if (!holds(await read())) return false;
249
+ let removed = false;
250
+ await mutate((current) => {
251
+ for (const entry of Object.values(current.state)) {
252
+ if (!Object.hasOwn(entry.sessions ?? {}, id)) continue;
253
+ delete entry.sessions[id];
254
+ removed = true;
255
+ }
256
+ });
257
+ return removed;
258
+ };
259
+
260
+ return { file, read, setEnabled, setState, setSessionState, forgetSession };
261
+ };
@@ -0,0 +1,188 @@
1
+ import { describe, expect, it, vi } from 'vitest';
2
+ import { mkdir, mkdtemp, readFile, writeFile } from 'node:fs/promises';
3
+ import { tmpdir } from 'node:os';
4
+ import { dirname, join } from 'node:path';
5
+
6
+ import { parsePluginPackage } from './manifest.js';
7
+ import {
8
+ createPluginStore,
9
+ isPluginEnabled,
10
+ MAX_SESSIONS_PER_PLUGIN,
11
+ resolvePluginState,
12
+ resolveSessionOverrides,
13
+ } from './store.js';
14
+
15
+ const manifest = parsePluginPackage({
16
+ version: '1.0.0',
17
+ pi: { extensions: ['./extension.js'] },
18
+ pichamber: {
19
+ apiVersion: 1,
20
+ id: 'demo',
21
+ name: 'Demo',
22
+ description: 'A demo plugin.',
23
+ icon: 'artboard',
24
+ state: {
25
+ on: { type: 'boolean', scope: 'global', default: true, label: 'On' },
26
+ loud: { type: 'boolean', scope: 'global', default: false, label: 'Loud' },
27
+ mode: {
28
+ type: 'enum',
29
+ scope: 'project',
30
+ default: 'a',
31
+ label: 'Mode',
32
+ options: [{ value: 'a', label: 'A' }, { value: 'b', label: 'B' }],
33
+ },
34
+ },
35
+ contributes: { composerToggles: [{ id: 'demo', state: 'on', label: 'Demo', icon: 'artboard' }] },
36
+ },
37
+ }, { packageDir: '/plugins/demo', bundled: true });
38
+
39
+ const tempFile = async () => join(await mkdtemp(join(tmpdir(), 'pichamber-plugins-store-')), 'pi', 'plugins.json');
40
+
41
+ describe('plugin store', () => {
42
+ it('treats a missing file as empty and a malformed one as unreadable', async () => {
43
+ const file = await tempFile();
44
+ const store = createPluginStore({ file });
45
+ const empty = await store.read();
46
+ expect(empty).toEqual({ version: 1, enabled: {}, state: {} });
47
+ expect(isPluginEnabled(manifest, empty)).toBe(false);
48
+ expect(resolvePluginState(manifest, empty, null)).toEqual({ on: true, loud: false, mode: 'a' });
49
+
50
+ await store.setEnabled(manifest, true);
51
+ for (const bad of ['{not json', '[]', '{"version":2}', '{"version":1,"enabled":{"demo":"yes"}}', '{"version":1,"state":{"demo":{"global":{"on":1}}}}']) {
52
+ await writeFile(file, bad);
53
+ await expect(store.read()).rejects.toMatchObject({ code: 'PLUGINS_UNREADABLE' });
54
+ // A malformed file is never overwritten.
55
+ await expect(store.setEnabled(manifest, false)).rejects.toMatchObject({ code: 'PLUGINS_UNREADABLE' });
56
+ expect(await readFile(file, 'utf8')).toBe(bad);
57
+ }
58
+ });
59
+
60
+ it('round-trips enabled state and scoped values', async () => {
61
+ const file = await tempFile();
62
+ const store = createPluginStore({ file });
63
+ await store.setEnabled(manifest, true);
64
+ await store.setState(manifest, { key: 'loud', value: true });
65
+ await store.setState(manifest, { key: 'mode', value: 'b', directory: '/work/project/' });
66
+
67
+ const reread = await createPluginStore({ file }).read();
68
+ expect(isPluginEnabled(manifest, reread)).toBe(true);
69
+ expect(reread.state.demo).toEqual({ global: { loud: true }, projects: { '/work/project': { mode: 'b' } }, sessions: {} });
70
+ expect(resolvePluginState(manifest, reread, '/work/project')).toEqual({ on: true, loud: true, mode: 'b' });
71
+ expect(resolvePluginState(manifest, reread, '/work/other')).toEqual({ on: true, loud: true, mode: 'a' });
72
+ expect(resolvePluginState(manifest, reread, null)).toEqual({ on: true, loud: true, mode: 'a' });
73
+ });
74
+
75
+ it('keeps unknown ids and ignores values the manifest no longer accepts', async () => {
76
+ const file = await tempFile();
77
+ await createPluginStore({ file }).setEnabled(manifest, true);
78
+ const raw = JSON.parse(await readFile(file, 'utf8'));
79
+ raw.enabled.retired = true;
80
+ raw.state.demo = { global: { loud: 'maybe', mode: 'b' }, projects: { '/p': { mode: 'gone', loud: true } } };
81
+ await writeFile(file, JSON.stringify(raw));
82
+ const store = createPluginStore({ file });
83
+ const snapshot = await store.read();
84
+ expect(snapshot.enabled.retired).toBe(true);
85
+ // `loud` is global-scoped, `mode` project-scoped: values in the wrong scope or of the wrong type fall back.
86
+ expect(resolvePluginState(manifest, snapshot, '/p')).toEqual({ on: true, loud: false, mode: 'a' });
87
+ await store.setState(manifest, { key: 'loud', value: true });
88
+ expect((await store.read()).enabled.retired).toBe(true);
89
+ });
90
+
91
+ it('rejects invalid values and project values without a directory', async () => {
92
+ const store = createPluginStore({ file: await tempFile() });
93
+ await expect(store.setState(manifest, { key: 'loud', value: 'true' })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
94
+ // A composer toggle's key is set per session only.
95
+ await expect(store.setState(manifest, { key: 'on', value: false })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
96
+ await expect(store.setState(manifest, { key: 'missing', value: true })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
97
+ await expect(store.setState(manifest, { key: 'mode', value: 'z', directory: '/p' })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
98
+ await expect(store.setState(manifest, { key: 'mode', value: 'b' })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
99
+ await expect(store.setState(manifest, { key: 'mode', value: 'b', directory: 'relative' })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
100
+ await expect(store.setEnabled(manifest, 'yes')).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
101
+ });
102
+
103
+ it('never drops a concurrent write, also across store instances', async () => {
104
+ const file = await tempFile();
105
+ const first = createPluginStore({ file });
106
+ const second = createPluginStore({ file });
107
+ await Promise.all([
108
+ first.setEnabled(manifest, true),
109
+ second.setState(manifest, { key: 'loud', value: true }),
110
+ first.setState(manifest, { key: 'mode', value: 'b', directory: '/a' }),
111
+ second.setState(manifest, { key: 'mode', value: 'b', directory: '/b' }),
112
+ ]);
113
+ const snapshot = await first.read();
114
+ expect(snapshot.enabled.demo).toBe(true);
115
+ expect(snapshot.state.demo).toEqual({ global: { loud: true }, projects: { '/a': { mode: 'b' }, '/b': { mode: 'b' } }, sessions: {} });
116
+ });
117
+
118
+ it('starts a composer toggle\'s key from the manifest default, whatever a global value says', async () => {
119
+ const file = await tempFile();
120
+ // Left by an older build that let Settings change it for every session.
121
+ await mkdir(dirname(file), { recursive: true });
122
+ await writeFile(file, JSON.stringify({ version: 1, state: { demo: { global: { on: false }, projects: { '/p': { on: false } } } } }));
123
+ const snapshot = await createPluginStore({ file }).read();
124
+ expect(resolvePluginState(manifest, snapshot, null)).toEqual({ on: true, loud: false, mode: 'a' });
125
+ expect(resolvePluginState(manifest, snapshot, '/p')).toEqual({ on: true, loud: false, mode: 'a' });
126
+ });
127
+
128
+ it('stores, clears, and forgets one session\'s own values', async () => {
129
+ const file = await tempFile();
130
+ const store = createPluginStore({ file });
131
+ await store.setSessionState(manifest, { sessionId: 's-1', key: 'on', value: false });
132
+ await store.setSessionState(manifest, { sessionId: 's-2', key: 'on', value: false });
133
+
134
+ let snapshot = await createPluginStore({ file }).read();
135
+ expect(resolveSessionOverrides(manifest, snapshot, 's-1')).toEqual({ on: false });
136
+ expect(resolveSessionOverrides(manifest, snapshot, 's-3')).toEqual({});
137
+ // Settings values are untouched by a session value.
138
+ expect(resolvePluginState(manifest, snapshot, null)).toEqual({ on: true, loud: false, mode: 'a' });
139
+
140
+ await store.setSessionState(manifest, { sessionId: 's-1', key: 'on', value: null });
141
+ snapshot = await store.read();
142
+ expect(snapshot.state.demo.sessions).toEqual({ 's-2': { on: false } });
143
+
144
+ expect(await store.forgetSession('s-2')).toBe(true);
145
+ expect(await store.forgetSession('s-2')).toBe(false);
146
+ expect((await store.read()).state.demo.sessions).toEqual({});
147
+ });
148
+
149
+ it('only lets a session set keys a composer toggle names', async () => {
150
+ const store = createPluginStore({ file: await tempFile() });
151
+ await expect(store.setSessionState(manifest, { sessionId: 's', key: 'mode', value: 'b' })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
152
+ await expect(store.setSessionState(manifest, { sessionId: 's', key: 'on', value: 'yes' })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
153
+ for (const sessionId of ['', '../x', 'constructor', 'a b', 'x'.repeat(257), 7]) {
154
+ await expect(store.setSessionState(manifest, { sessionId, key: 'on', value: false })).rejects.toMatchObject({ code: 'INVALID_PLUGIN_REQUEST' });
155
+ }
156
+ });
157
+
158
+ it('ignores session values the manifest no longer accepts', async () => {
159
+ const file = await tempFile();
160
+ await mkdir(dirname(file), { recursive: true });
161
+ await writeFile(file, JSON.stringify({ version: 1, state: { demo: { sessions: { s: { on: 'maybe', mode: 'b' } } } } }));
162
+ const snapshot = await createPluginStore({ file }).read();
163
+ expect(resolveSessionOverrides(manifest, snapshot, 's')).toEqual({});
164
+ });
165
+
166
+ it('drops the least recently set sessions past the cap', async () => {
167
+ const file = await tempFile();
168
+ const sessions = {};
169
+ for (let index = 0; index < MAX_SESSIONS_PER_PLUGIN; index += 1) sessions[`s${index}`] = { on: false };
170
+ await createPluginStore({ file }).setEnabled(manifest, true);
171
+ const raw = JSON.parse(await readFile(file, 'utf8'));
172
+ raw.state.demo = { global: {}, projects: {}, sessions };
173
+ await writeFile(file, JSON.stringify(raw));
174
+ const store = createPluginStore({ file });
175
+ const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
176
+ // Setting s0 again moves it to the end, so s1 is the oldest.
177
+ await store.setSessionState(manifest, { sessionId: 's0', key: 'on', value: true });
178
+ expect(warn).not.toHaveBeenCalled();
179
+ await store.setSessionState(manifest, { sessionId: 'new', key: 'on', value: false });
180
+ expect(warn).toHaveBeenCalledTimes(1);
181
+ expect(String(warn.mock.calls[0][0])).not.toContain('s1');
182
+ warn.mockRestore();
183
+ const ids = Object.keys((await store.read()).state.demo.sessions);
184
+ expect(ids).toHaveLength(MAX_SESSIONS_PER_PLUGIN);
185
+ expect(ids).not.toContain('s1');
186
+ expect(ids.slice(-2)).toEqual(['s0', 'new']);
187
+ });
188
+ });