@firstpick/pi-package-webui 0.11.0 → 0.11.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 (318) hide show
  1. package/DEVELOPMENT.md +181 -12
  2. package/README.md +41 -9
  3. package/TECHNICAL.md +91 -8
  4. package/bin/pi-webui.mjs +5432 -11428
  5. package/index.ts +10 -3
  6. package/lib/codex-cli-usage.mjs +232 -0
  7. package/lib/codex-usage-auth.mjs +39 -3
  8. package/lib/codex-usage-source.mjs +36 -0
  9. package/lib/component-update-state.mjs +2 -2
  10. package/lib/git-workflow-preference-values.mjs +122 -0
  11. package/lib/git-workflow-preferences.mjs +35 -563
  12. package/lib/package-updates.mjs +260 -0
  13. package/lib/rpc-supervisor-client.mjs +8 -4
  14. package/lib/server/app-runners.mjs +1667 -0
  15. package/lib/server/codex-fast-mode.mjs +161 -0
  16. package/lib/server/conversation-mode.mjs +218 -0
  17. package/lib/server/conversation-voice.mjs +318 -0
  18. package/lib/server/extension-ui-requests.mjs +114 -0
  19. package/lib/server/git-generation.mjs +459 -0
  20. package/lib/server/git-mutations.mjs +1827 -0
  21. package/lib/server/git-reads.mjs +608 -0
  22. package/lib/server/git-worktree-sessions.mjs +408 -0
  23. package/lib/server/helper-requests.mjs +82 -0
  24. package/lib/server/no-project-workspaces.mjs +103 -0
  25. package/lib/server/rpc-transports.mjs +394 -0
  26. package/lib/server/settings-store.mjs +544 -0
  27. package/lib/server/sse-delivery.mjs +138 -0
  28. package/lib/server/workspace-files.mjs +563 -0
  29. package/lib/update/supervisor.mjs +4 -0
  30. package/lib/webui-workspaces.mjs +2 -0
  31. package/package.json +5 -5
  32. package/public/activity-agents-controller.mjs +269 -0
  33. package/public/activity-events-controller.mjs +236 -0
  34. package/public/activity-intercom-controller.mjs +627 -0
  35. package/public/activity-queue-controller.mjs +534 -0
  36. package/public/activity-todo-view.mjs +89 -0
  37. package/public/activity-usage-controller.mjs +589 -0
  38. package/public/app.js +3761 -3878
  39. package/public/conversation-overview.css +84 -0
  40. package/public/conversation-overview.mjs +193 -0
  41. package/public/draft-conversations.mjs +135 -0
  42. package/public/focused-composer-controls.css +111 -0
  43. package/public/focused-composer-controls.mjs +143 -0
  44. package/public/focused-composer-disclosure.mjs +223 -0
  45. package/public/focused-shell-adapter.css +264 -0
  46. package/public/focused-shell-adapter.mjs +257 -0
  47. package/public/index.html +137 -80
  48. package/public/model-catalog-order.mjs +63 -0
  49. package/public/platform-event-stream.mjs +64 -0
  50. package/public/project-artifact-controller.mjs +218 -0
  51. package/public/project-file-viewer-controller.mjs +383 -0
  52. package/public/project-git-tools-controller.mjs +181 -0
  53. package/public/project-runners-controller.mjs +220 -0
  54. package/public/service-worker.js +52 -1
  55. package/public/session-attention-scheduler.mjs +182 -0
  56. package/public/session-composer-store.mjs +56 -0
  57. package/public/session-context.mjs +51 -0
  58. package/public/session-extension-requests.mjs +63 -0
  59. package/public/session-shelf-state.mjs +151 -0
  60. package/public/session-shelves.css +171 -0
  61. package/public/session-shelves.mjs +95 -0
  62. package/public/settings-navigation-controller.mjs +249 -0
  63. package/public/settings-navigation.css +61 -0
  64. package/public/settings-resource-controller.mjs +232 -0
  65. package/public/settings-workspace.css +19 -0
  66. package/public/settings-workspace.mjs +175 -0
  67. package/public/shell-actions.mjs +87 -0
  68. package/public/shell-attention-inbox.css +72 -0
  69. package/public/shell-attention-inbox.mjs +198 -0
  70. package/public/shell-context-actions.css +61 -0
  71. package/public/shell-context-actions.mjs +168 -0
  72. package/public/shell-inspector-resize.mjs +124 -0
  73. package/public/shell-navigation-resize.mjs +107 -0
  74. package/public/shell-navigation.mjs +127 -0
  75. package/public/shell-preferences.mjs +108 -0
  76. package/public/shell-surfaces.mjs +99 -0
  77. package/public/shell-tools-launcher.css +97 -0
  78. package/public/shell-tools-launcher.mjs +222 -0
  79. package/public/shell-view-host.mjs +115 -0
  80. package/public/shell-workspace.css +266 -0
  81. package/public/shell-workspace.mjs +402 -0
  82. package/public/sidebar-update-menu.css +190 -0
  83. package/public/sidebar-update-menu.mjs +512 -0
  84. package/public/styles.css +320 -169
  85. package/public/subagent-launch-slot-state.mjs +2 -2
  86. package/public/theme-contract.mjs +1 -1
  87. package/public/themed-selects.css +156 -0
  88. package/public/workspace-choices.mjs +104 -0
  89. package/tests/activity-agents-controller.test.mjs +652 -0
  90. package/tests/activity-events-controller.test.mjs +511 -0
  91. package/tests/app-runner-terminal-static.test.mjs +3 -3
  92. package/tests/append-system-http.test.mjs +7 -6
  93. package/tests/append-system-selector-static.test.mjs +6 -6
  94. package/tests/aur-review-widget-static.test.mjs +11 -3
  95. package/tests/boot-failure-diagnostics.test.mjs +8 -3
  96. package/tests/browser/activity-intercom-controller.spec.mjs +457 -0
  97. package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
  98. package/tests/browser/activity-owner-integration.spec.mjs +201 -0
  99. package/tests/browser/activity-queue-controller.spec.mjs +405 -0
  100. package/tests/browser/activity-section-picker.spec.mjs +294 -0
  101. package/tests/browser/activity-todo-view.spec.mjs +60 -0
  102. package/tests/browser/activity-usage-controller.spec.mjs +416 -0
  103. package/tests/browser/compact-layout-integration.spec.mjs +58 -0
  104. package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
  105. package/tests/browser/composer-disclosure.spec.mjs +389 -0
  106. package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
  107. package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
  108. package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
  109. package/tests/browser/control-visibility.spec.mjs +5 -0
  110. package/tests/browser/controls-layout.spec.mjs +21 -2
  111. package/tests/browser/conversation-overview.spec.mjs +251 -0
  112. package/tests/browser/draft-conversations.spec.mjs +276 -0
  113. package/tests/browser/empty-startup-fixture.mjs +135 -0
  114. package/tests/browser/empty-startup.spec.mjs +282 -0
  115. package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
  116. package/tests/browser/focused-composer-more.spec.mjs +127 -0
  117. package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
  118. package/tests/browser/focused-navigation-fixture.mjs +32 -0
  119. package/tests/browser/focused-project-activity.spec.mjs +111 -0
  120. package/tests/browser/focused-shell-integration.spec.mjs +208 -0
  121. package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
  122. package/tests/browser/folder-picker-layout.spec.mjs +302 -0
  123. package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
  124. package/tests/browser/git-setup-cancel.spec.mjs +251 -0
  125. package/tests/browser/guided-git-fallback.spec.mjs +40 -21
  126. package/tests/browser/inspector-header.spec.mjs +221 -0
  127. package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
  128. package/tests/browser/inspector-resize.spec.mjs +227 -0
  129. package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
  130. package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
  131. package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
  132. package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
  133. package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
  134. package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
  135. package/tests/browser/interaction-continuity.spec.mjs +50 -26
  136. package/tests/browser/interaction-model-picker.spec.mjs +86 -0
  137. package/tests/browser/last-terminal-close.spec.mjs +280 -0
  138. package/tests/browser/mobile-foundation.spec.mjs +172 -20
  139. package/tests/browser/model-catalog-groups.spec.mjs +104 -0
  140. package/tests/browser/more-row-menus.spec.mjs +258 -0
  141. package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
  142. package/tests/browser/no-project-conversation.spec.mjs +113 -0
  143. package/tests/browser/optimistic-prompt.spec.mjs +3 -0
  144. package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
  145. package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
  146. package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
  147. package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
  148. package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
  149. package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
  150. package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
  151. package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
  152. package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
  153. package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
  154. package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
  155. package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
  156. package/tests/browser/project-artifact-controller.spec.mjs +324 -0
  157. package/tests/browser/project-artifact-integration.spec.mjs +103 -0
  158. package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
  159. package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
  160. package/tests/browser/session-fixture.mjs +118 -0
  161. package/tests/browser/session-ownership.spec.mjs +175 -0
  162. package/tests/browser/session-shelves-integration.spec.mjs +219 -0
  163. package/tests/browser/session-shelves.spec.mjs +340 -0
  164. package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
  165. package/tests/browser/session-summary.spec.mjs +17 -12
  166. package/tests/browser/settings-complete-home.spec.mjs +463 -0
  167. package/tests/browser/settings-entrypoint.spec.mjs +104 -0
  168. package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
  169. package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
  170. package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
  171. package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
  172. package/tests/browser/shell-ownership.spec.mjs +398 -0
  173. package/tests/browser/shell-rollout-fixture.mjs +259 -0
  174. package/tests/browser/shell-rollout.spec.mjs +357 -0
  175. package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
  176. package/tests/browser/shell-workspace.spec.mjs +433 -0
  177. package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
  178. package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
  179. package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
  180. package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
  181. package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
  182. package/tests/browser/stream-output-isolation.spec.mjs +6 -3
  183. package/tests/browser/themed-selects.spec.mjs +297 -0
  184. package/tests/browser/thread-start-flow.spec.mjs +481 -0
  185. package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
  186. package/tests/browser/ui-polish-features.spec.mjs +85 -0
  187. package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
  188. package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
  189. package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
  190. package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
  191. package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
  192. package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
  193. package/tests/browser/windows-drive-parent.spec.mjs +4 -2
  194. package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
  195. package/tests/codex-cli-usage.test.mjs +189 -0
  196. package/tests/codex-fast-mode-static.test.mjs +16 -11
  197. package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
  198. package/tests/codex-usage-auth.test.mjs +168 -9
  199. package/tests/codex-usage-http.test.mjs +124 -0
  200. package/tests/codex-usage-source.test.mjs +146 -0
  201. package/tests/component-update-api-static.test.mjs +2 -2
  202. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  203. package/tests/control-deck-component-updates-static.test.mjs +9 -4
  204. package/tests/control-visibility-static.test.mjs +3 -3
  205. package/tests/controls-layout-static.test.mjs +5 -5
  206. package/tests/conversation-overview-adapter.test.mjs +100 -0
  207. package/tests/document-artifact-static.test.mjs +2 -1
  208. package/tests/draft-conversations.test.mjs +205 -0
  209. package/tests/empty-startup-launcher.test.mjs +197 -0
  210. package/tests/events-tree-context-menu-static.test.mjs +22 -18
  211. package/tests/fake-pi-session-ownership.test.mjs +302 -0
  212. package/tests/fast-mode-client-static.test.mjs +1 -1
  213. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  214. package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
  215. package/tests/file-viewer-image-static.test.mjs +15 -11
  216. package/tests/file-viewer-search-static.test.mjs +5 -5
  217. package/tests/fixtures/fake-codex-app-server.mjs +61 -0
  218. package/tests/fixtures/fake-pi.mjs +41 -9
  219. package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
  220. package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
  221. package/tests/git-footer-context-menu-static.test.mjs +1 -1
  222. package/tests/git-panel-file-preview-static.test.mjs +41 -48
  223. package/tests/git-panel-live-updates-static.test.mjs +2 -1
  224. package/tests/git-workflow-dispatch.test.mjs +66 -0
  225. package/tests/git-workflow-preferences.test.mjs +9 -1
  226. package/tests/guided-git-activation-static.test.mjs +14 -11
  227. package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
  228. package/tests/guided-git-message-reliability-static.test.mjs +10 -6
  229. package/tests/guided-git-publication-backend-static.test.mjs +16 -11
  230. package/tests/http-endpoints-harness.test.mjs +29 -9
  231. package/tests/interaction-state-stability-static.test.mjs +4 -3
  232. package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
  233. package/tests/intercom-tag-layout-static.test.mjs +13 -12
  234. package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
  235. package/tests/main-output-loading-static.test.mjs +4 -4
  236. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  237. package/tests/mobile-compact-layout.test.mjs +2 -2
  238. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  239. package/tests/mobile-foundation-static.test.mjs +10 -7
  240. package/tests/mobile-phone-experience-static.test.mjs +3 -2
  241. package/tests/mobile-static.test.mjs +173 -135
  242. package/tests/model-catalog-order.test.mjs +103 -0
  243. package/tests/native-parity.test.mjs +6 -4
  244. package/tests/native-session-choice-owner.test.mjs +102 -0
  245. package/tests/native-update-lifecycle.test.mjs +10 -5
  246. package/tests/no-project-http-harness.test.mjs +328 -0
  247. package/tests/no-project-navigation.test.mjs +54 -0
  248. package/tests/no-project-workspaces.test.mjs +77 -0
  249. package/tests/open-issue-wizard-static.test.mjs +1 -1
  250. package/tests/optional-feature-migration-frontend.test.mjs +4 -4
  251. package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
  252. package/tests/package-updates.test.mjs +630 -0
  253. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  254. package/tests/platform-event-stream.test.mjs +253 -0
  255. package/tests/project-file-viewer-controller.test.mjs +652 -0
  256. package/tests/project-git-tools-adapter.test.mjs +103 -0
  257. package/tests/project-git-tools-controller.test.mjs +577 -0
  258. package/tests/project-runners-controller.test.mjs +453 -0
  259. package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
  260. package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
  261. package/tests/questionnaire-dialog.test.mjs +6 -6
  262. package/tests/queue-edit-reorder-static.test.mjs +48 -51
  263. package/tests/rpc-supervisor-host.test.mjs +4 -1
  264. package/tests/safety-guard-auto-review-static.test.mjs +1 -1
  265. package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
  266. package/tests/server-app-runners.test.mjs +536 -0
  267. package/tests/server-codex-fast-mode.test.mjs +346 -0
  268. package/tests/server-conversation-mode.test.mjs +386 -0
  269. package/tests/server-conversation-voice.test.mjs +426 -0
  270. package/tests/server-extension-ui-requests.test.mjs +357 -0
  271. package/tests/server-git-generation.test.mjs +558 -0
  272. package/tests/server-git-mutations.test.mjs +729 -0
  273. package/tests/server-git-reads.test.mjs +381 -0
  274. package/tests/server-git-worktree-sessions.test.mjs +502 -0
  275. package/tests/server-helper-requests.test.mjs +364 -0
  276. package/tests/server-rpc-transports.test.mjs +553 -0
  277. package/tests/server-settings-store.test.mjs +132 -0
  278. package/tests/server-shell-rollout.test.mjs +478 -0
  279. package/tests/server-sse-delivery.test.mjs +410 -0
  280. package/tests/server-workspace-files.test.mjs +546 -0
  281. package/tests/session-attention-scheduler.test.mjs +514 -0
  282. package/tests/session-composer-store.test.mjs +153 -0
  283. package/tests/session-context.test.mjs +134 -0
  284. package/tests/session-extension-requests.test.mjs +193 -0
  285. package/tests/session-ownership-adapter.test.mjs +130 -0
  286. package/tests/session-sampling-ui-static.test.mjs +10 -4
  287. package/tests/session-send-lifetime.test.mjs +140 -0
  288. package/tests/session-shelf-state.test.mjs +348 -0
  289. package/tests/session-shelves-adapter.test.mjs +79 -0
  290. package/tests/session-summary-lifetime.test.mjs +54 -0
  291. package/tests/settings-resource-controller.test.mjs +548 -0
  292. package/tests/shell-action-adapter.test.mjs +169 -0
  293. package/tests/shell-actions.test.mjs +182 -0
  294. package/tests/shell-navigation.test.mjs +348 -0
  295. package/tests/shell-preferences.test.mjs +367 -0
  296. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  297. package/tests/stream-output-isolation-static.test.mjs +1 -1
  298. package/tests/subagent-gate-visibility.test.mjs +1 -1
  299. package/tests/subagent-launch-slot-state.test.mjs +2 -2
  300. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  301. package/tests/subagent-observability-static.test.mjs +2 -2
  302. package/tests/subagent-reliability-integration.test.mjs +13 -30
  303. package/tests/syntax-highlighting-static.test.mjs +3 -3
  304. package/tests/tab-close-continuity-static.test.mjs +1 -1
  305. package/tests/tab-metadata-ordering.test.mjs +99 -0
  306. package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
  307. package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
  308. package/tests/terminal-tab-workspace-static.test.mjs +5 -4
  309. package/tests/terminal-tabs-resize-static.test.mjs +1 -1
  310. package/tests/theme-contract.test.mjs +10 -3
  311. package/tests/theme-customizer-static.test.mjs +1 -1
  312. package/tests/thread-display-title.test.mjs +44 -0
  313. package/tests/update-api-harness.test.mjs +15 -14
  314. package/tests/update-tab-restore-harness.test.mjs +3 -0
  315. package/tests/webui-settings-locking.test.mjs +2 -2
  316. package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
  317. package/tests/workspace-choices.test.mjs +114 -0
  318. package/tests/workspace-save-load-static.test.mjs +7 -4
@@ -0,0 +1,544 @@
1
+ import { lstat, mkdir, open, readFile, readdir, realpath, rename, rm, rmdir, stat } from "node:fs/promises";
2
+ import { homedir } from "node:os";
3
+ import path from "node:path";
4
+ import { setTimeout as delay } from "node:timers/promises";
5
+ import { normalizeSubagentLaunchSlots } from "../subagent-launch-slots.mjs";
6
+ import { normalizeUiLayout } from "../ui-layout-settings.mjs";
7
+ import { normalizeResourceDefaults } from "../resource-selection.mjs";
8
+ import {
9
+ normalizeAppendSystemPromptPath,
10
+ normalizeAppendSystemPromptRootPath,
11
+ } from "../append-system-selection.mjs";
12
+ import { normalizeOutputMode, OUTPUT_MODE_NORMAL } from "../webui-output-mode.mjs";
13
+ import { mergeGitWorkflowPreferences, normalizeGitWorkflowPreferences } from "../git-workflow-preference-values.mjs";
14
+
15
+ const WEBUI_SETTINGS_VERSION = 8;
16
+ const WEBUI_SETTINGS_FILE_ENV = "PI_WEBUI_SETTINGS_FILE";
17
+ const WEBUI_SETTINGS_LOCK_TIMEOUT_MS = 2_000;
18
+ const WEBUI_SETTINGS_LOCK_RETRY_MS = 25;
19
+ const WEBUI_SETTINGS_LOCK_INVALID_RECORD_GRACE_MS = 1_000;
20
+ export const WEBUI_SIDE_PANEL_WIDTH_MIN_PX = 320;
21
+ export const WEBUI_SIDE_PANEL_WIDTH_MAX_PX = 4096;
22
+ const webuiSettingsUpdateQueues = new Map();
23
+
24
+ export function webuiSettingsFile(env = process.env) {
25
+ if (env[WEBUI_SETTINGS_FILE_ENV]) return path.resolve(String(env[WEBUI_SETTINGS_FILE_ENV]).replace(/^~(?=$|[\\/])/, homedir()));
26
+ return path.join(homedir(), ".pi", "webui", "settings.json");
27
+ }
28
+
29
+ export function legacyWebuiSettingsFile(env = process.env) {
30
+ const configRoot = env.XDG_CONFIG_HOME || path.join(homedir(), ".config");
31
+ return path.join(configRoot, "pi-webui", "settings.json");
32
+ }
33
+
34
+ export { normalizeResourceDefaults } from "../resource-selection.mjs";
35
+
36
+ export function normalizeInterfacePreferences(value) {
37
+ const rawSidePanelWidth = value?.sidePanelWidth;
38
+ const sidePanelWidth = rawSidePanelWidth === null || rawSidePanelWidth === undefined ? Number.NaN : Number(rawSidePanelWidth);
39
+ return {
40
+ sidePanelWidth: Number.isFinite(sidePanelWidth)
41
+ ? Math.max(WEBUI_SIDE_PANEL_WIDTH_MIN_PX, Math.min(WEBUI_SIDE_PANEL_WIDTH_MAX_PX, Math.round(sidePanelWidth)))
42
+ : null,
43
+ };
44
+ }
45
+
46
+ function settingsObject(value) {
47
+ return value && typeof value === "object" && !Array.isArray(value) ? value : {};
48
+ }
49
+
50
+ function normalizedSettingsVersion(value) {
51
+ const stored = Number.isInteger(value?.version) ? value.version : 0;
52
+ return Math.max(WEBUI_SETTINGS_VERSION, stored, value?.subagentLaunchSlots !== undefined ? 5 : 0);
53
+ }
54
+
55
+ export function normalizeWebuiSettings(value) {
56
+ const source = settingsObject(value);
57
+ const storedVersion = Number.isInteger(source.version) ? source.version : 0;
58
+ const resourceDefaultsSource = storedVersion >= 8
59
+ ? source.resourceDefaults
60
+ : { ...settingsObject(source.resourceDefaults), modelProfiles: [] };
61
+ const interfacePreferences = normalizeInterfacePreferences(source.interfacePreferences);
62
+ const legacyLayoutSource = source.uiLayout === undefined
63
+ && interfacePreferences.sidePanelWidth !== null
64
+ && (!Number.isInteger(source.version) || source.version < WEBUI_SETTINGS_VERSION)
65
+ ? { version: 1 }
66
+ : source.uiLayout;
67
+ return {
68
+ ...source,
69
+ version: normalizedSettingsVersion(source),
70
+ remoteAuthEnabled: source.remoteAuthEnabled === true,
71
+ appendSystemPromptPath: normalizeAppendSystemPromptPath(source.appendSystemPromptPath),
72
+ appendSystemPromptRootPath: normalizeAppendSystemPromptRootPath(source.appendSystemPromptRootPath),
73
+ outputModeDefault: normalizeOutputMode(source.outputModeDefault, OUTPUT_MODE_NORMAL),
74
+ gitWorkflow: normalizeGitWorkflowPreferences(source.gitWorkflow),
75
+ resourceDefaults: normalizeResourceDefaults(resourceDefaultsSource),
76
+ interfacePreferences,
77
+ uiLayout: normalizeUiLayout(legacyLayoutSource, { legacySidePanelWidth: interfacePreferences.sidePanelWidth }),
78
+ subagentLaunchSlots: normalizeSubagentLaunchSlots(source.subagentLaunchSlots),
79
+ };
80
+ }
81
+
82
+ function settingsReadError(storageFile, error) {
83
+ const wrapped = new Error(`Cannot read Pi Web UI settings at ${storageFile}: ${error instanceof Error ? error.message : String(error)}`);
84
+ wrapped.code = "WEBUI_SETTINGS_READ_FAILED";
85
+ wrapped.cause = error;
86
+ return wrapped;
87
+ }
88
+
89
+ async function readRawWebuiSettings(storageFile, { missing = {} } = {}) {
90
+ let text;
91
+ try {
92
+ text = await readFile(storageFile, "utf8");
93
+ } catch (error) {
94
+ if (error?.code === "ENOENT") return missing;
95
+ throw settingsReadError(storageFile, error);
96
+ }
97
+ try {
98
+ const parsed = JSON.parse(text);
99
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new TypeError("settings must contain a JSON object");
100
+ return parsed;
101
+ } catch (error) {
102
+ throw settingsReadError(storageFile, error);
103
+ }
104
+ }
105
+
106
+ function isDefaultSettingsTarget(storageFile, env = process.env) {
107
+ return !env[WEBUI_SETTINGS_FILE_ENV] && path.resolve(storageFile) === path.resolve(webuiSettingsFile(env));
108
+ }
109
+
110
+ async function ensurePrivateSettingsDirectory(storageFile) {
111
+ await mkdir(path.dirname(storageFile), { recursive: true, mode: 0o700 });
112
+ }
113
+
114
+ function lockDirectoryFor(storageFile) {
115
+ return `${storageFile}.lock`;
116
+ }
117
+
118
+ function lockOwnerIsDead(pid) {
119
+ if (!Number.isSafeInteger(pid) || pid <= 0) return false;
120
+ try {
121
+ process.kill(pid, 0);
122
+ return false;
123
+ } catch (error) {
124
+ return error?.code === "ESRCH";
125
+ }
126
+ }
127
+
128
+ function settingsLockRecordNameMetadata(name) {
129
+ const match = name.match(/^(\d+)-(\d+)-[^/]+\.json$/);
130
+ if (!match) return {};
131
+ const ownerPid = Number(match[1]);
132
+ const createdAt = Number(match[2]);
133
+ return {
134
+ ownerPid: Number.isSafeInteger(ownerPid) && ownerPid > 0 ? ownerPid : undefined,
135
+ createdAt: Number.isSafeInteger(createdAt) && createdAt > 0 ? createdAt : undefined,
136
+ };
137
+ }
138
+
139
+ async function readSettingsLockRecords(lockDirectory) {
140
+ const names = (await readdir(lockDirectory)).filter((name) => name.endsWith(".json")).sort();
141
+ const records = await Promise.all(names.map(async (name) => {
142
+ const recordFile = path.join(lockDirectory, name);
143
+ const nameMetadata = settingsLockRecordNameMetadata(name);
144
+ try {
145
+ const [value, fileStat] = await Promise.all([
146
+ readFile(recordFile, "utf8").then((text) => JSON.parse(text)),
147
+ stat(recordFile),
148
+ ]);
149
+ const valid = Number.isSafeInteger(value?.pid)
150
+ && value.pid > 0
151
+ && typeof value?.token === "string"
152
+ && value.token.length > 0
153
+ && ["pending", "active"].includes(value?.state);
154
+ const createdAt = Number.isSafeInteger(value?.createdAt) && value.createdAt > 0
155
+ ? value.createdAt
156
+ : nameMetadata.createdAt;
157
+ return {
158
+ ...value,
159
+ ownerPid: nameMetadata.ownerPid,
160
+ createdAt,
161
+ name,
162
+ recordFile,
163
+ mtimeMs: fileStat.mtimeMs,
164
+ valid,
165
+ };
166
+ } catch (error) {
167
+ if (error?.code === "ENOENT") return undefined;
168
+ const fileStat = await stat(recordFile).catch(() => undefined);
169
+ return { ...nameMetadata, name, recordFile, mtimeMs: fileStat?.mtimeMs, valid: false };
170
+ }
171
+ }));
172
+ return records.filter(Boolean);
173
+ }
174
+
175
+ async function renameWithWindowsRetry(source, target) {
176
+ let lastError;
177
+ for (let attempt = 0; attempt < 12; attempt += 1) {
178
+ try {
179
+ await rename(source, target);
180
+ return;
181
+ } catch (error) {
182
+ lastError = error;
183
+ if (process.platform !== "win32" || !["EACCES", "EBUSY", "EPERM"].includes(error?.code)) throw error;
184
+ await delay(25 * (attempt + 1));
185
+ }
186
+ }
187
+ throw lastError;
188
+ }
189
+
190
+ async function writeSettingsLockRecord(recordFile, value) {
191
+ const temporaryFile = `${recordFile}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`;
192
+ let handle;
193
+ try {
194
+ handle = await open(temporaryFile, "wx", 0o600);
195
+ await handle.writeFile(`${JSON.stringify(value)}\n`, "utf8");
196
+ await handle.sync();
197
+ await handle.close();
198
+ handle = undefined;
199
+ await renameWithWindowsRetry(temporaryFile, recordFile);
200
+ } catch (error) {
201
+ await handle?.close().catch(() => {});
202
+ await rm(temporaryFile, { force: true }).catch(() => {});
203
+ throw error;
204
+ }
205
+ }
206
+
207
+ async function releaseSettingsLock(lockDirectory, recordFile) {
208
+ await rm(recordFile, { force: true });
209
+ await rmdir(lockDirectory).catch((error) => {
210
+ if (error?.code !== "ENOENT" && error?.code !== "ENOTEMPTY" && error?.code !== "EEXIST") throw error;
211
+ });
212
+ }
213
+
214
+ export async function withWebuiSettingsLock(storageFile, operation, {
215
+ timeoutMs = WEBUI_SETTINGS_LOCK_TIMEOUT_MS,
216
+ retryMs = WEBUI_SETTINGS_LOCK_RETRY_MS,
217
+ } = {}) {
218
+ await ensurePrivateSettingsDirectory(storageFile);
219
+ const lockDirectory = lockDirectoryFor(storageFile);
220
+ await mkdir(lockDirectory, { mode: 0o700 }).catch((error) => {
221
+ if (error?.code !== "EEXIST") throw error;
222
+ });
223
+ const createdAt = Date.now();
224
+ const token = `${process.pid}-${createdAt}-${Math.random().toString(16).slice(2)}`;
225
+ const recordFile = path.join(lockDirectory, `${token}.json`);
226
+ const ownRecord = { pid: process.pid, token, state: "pending", createdAt };
227
+ let handle;
228
+ try {
229
+ handle = await open(recordFile, "wx", 0o600);
230
+ await handle.writeFile(`${JSON.stringify(ownRecord)}\n`, "utf8");
231
+ await handle.sync();
232
+ await handle.close();
233
+ handle = undefined;
234
+ } catch (error) {
235
+ await handle?.close().catch(() => {});
236
+ await rm(recordFile, { force: true }).catch(() => {});
237
+ throw error;
238
+ }
239
+
240
+ const deadline = Date.now() + Math.max(0, timeoutMs);
241
+ let acquired = false;
242
+ try {
243
+ while (!acquired) {
244
+ let records = await readSettingsLockRecords(lockDirectory);
245
+ let removedStaleRecord = false;
246
+ for (const record of records) {
247
+ const ownerPid = record.valid ? record.pid : record.ownerPid;
248
+ const ownerIsDead = lockOwnerIsDead(ownerPid);
249
+ const recordAgeMs = Math.max(
250
+ Number.isFinite(record.mtimeMs) ? Date.now() - record.mtimeMs : 0,
251
+ Number.isSafeInteger(record.createdAt) ? Date.now() - record.createdAt : 0,
252
+ );
253
+ const invalidRecordIsStale = !record.valid
254
+ && (ownerIsDead || recordAgeMs >= WEBUI_SETTINGS_LOCK_INVALID_RECORD_GRACE_MS);
255
+ if ((record.valid && ownerIsDead) || invalidRecordIsStale) {
256
+ await rm(record.recordFile, { force: true });
257
+ removedStaleRecord = true;
258
+ }
259
+ }
260
+ if (removedStaleRecord) continue;
261
+
262
+ const active = records.filter((record) => record.valid && record.state === "active");
263
+ if (active.length === 1 && active[0].token === token) {
264
+ acquired = true;
265
+ break;
266
+ }
267
+ if (active.length === 0 && records[0]?.token === token && records[0]?.valid) {
268
+ ownRecord.state = "active";
269
+ await writeSettingsLockRecord(recordFile, ownRecord);
270
+ continue;
271
+ }
272
+ if (Date.now() >= deadline) {
273
+ const timeoutError = new Error("Timed out waiting for the Pi Web UI settings lock");
274
+ timeoutError.code = "WEBUI_SETTINGS_LOCK_TIMEOUT";
275
+ throw timeoutError;
276
+ }
277
+ await delay(Math.max(1, Math.min(retryMs, deadline - Date.now())));
278
+ }
279
+ return await operation();
280
+ } finally {
281
+ await releaseSettingsLock(lockDirectory, recordFile);
282
+ }
283
+ }
284
+
285
+ async function syncDirectoryBestEffort(directory) {
286
+ let handle;
287
+ try {
288
+ handle = await open(directory, "r");
289
+ await handle.sync();
290
+ } catch {
291
+ // Directory fsync is unsupported on some platforms/filesystems.
292
+ } finally {
293
+ await handle?.close().catch(() => {});
294
+ }
295
+ }
296
+
297
+ async function writePrivateAtomicSettings(storageFile, value) {
298
+ await ensurePrivateSettingsDirectory(storageFile);
299
+ const temporaryFile = path.join(
300
+ path.dirname(storageFile),
301
+ `.${path.basename(storageFile)}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`,
302
+ );
303
+ let handle;
304
+ try {
305
+ handle = await open(temporaryFile, "wx", 0o600);
306
+ await handle.writeFile(`${JSON.stringify(value, null, 2)}\n`, "utf8");
307
+ await handle.sync();
308
+ await handle.close();
309
+ handle = undefined;
310
+ await renameWithWindowsRetry(temporaryFile, storageFile);
311
+ await syncDirectoryBestEffort(path.dirname(storageFile));
312
+ } catch (error) {
313
+ await handle?.close().catch(() => {});
314
+ await rm(temporaryFile, { force: true }).catch(() => {});
315
+ throw error;
316
+ }
317
+ }
318
+
319
+ export async function migrateLegacyWebuiSettings(targetFile, legacyFile) {
320
+ if (path.resolve(targetFile) === path.resolve(legacyFile)) return false;
321
+ try {
322
+ await readFile(targetFile, "utf8");
323
+ return false;
324
+ } catch (error) {
325
+ if (error?.code !== "ENOENT") throw settingsReadError(targetFile, error);
326
+ }
327
+ let legacy;
328
+ try {
329
+ legacy = await readRawWebuiSettings(legacyFile, { missing: null });
330
+ } catch {
331
+ return false;
332
+ }
333
+ if (!legacy) return false;
334
+ return withWebuiSettingsLock(targetFile, async () => {
335
+ try {
336
+ await readFile(targetFile, "utf8");
337
+ return false;
338
+ } catch (error) {
339
+ if (error?.code !== "ENOENT") throw settingsReadError(targetFile, error);
340
+ }
341
+ const { settings, persistLaunchSlots, persistedUiLayout } = mergeWebuiSettings(legacy, {});
342
+ const persisted = { ...settings, uiLayout: persistedUiLayout };
343
+ if (!persistLaunchSlots) delete persisted.subagentLaunchSlots;
344
+ await writePrivateAtomicSettings(targetFile, persisted);
345
+ return true;
346
+ });
347
+ }
348
+
349
+ async function ensureDefaultSettingsMigration(storageFile, env = process.env) {
350
+ if (!isDefaultSettingsTarget(storageFile, env)) return false;
351
+ return migrateLegacyWebuiSettings(storageFile, legacyWebuiSettingsFile(env));
352
+ }
353
+
354
+ export function validatedShellRolloutCohort(rawMarker) {
355
+ if (!rawMarker || typeof rawMarker !== "object" || Array.isArray(rawMarker) || rawMarker.version !== 1) return null;
356
+ return rawMarker.cohort === "fresh" || rawMarker.cohort === "established" ? rawMarker.cohort : null;
357
+ }
358
+
359
+ async function rolloutPathStat(filename) {
360
+ try {
361
+ return await lstat(filename);
362
+ } catch (error) {
363
+ if (error?.code === "ENOENT") return null;
364
+ throw error;
365
+ }
366
+ }
367
+
368
+ async function hasRolloutEvidence(filenames) {
369
+ let found = false;
370
+ for (const filename of filenames) {
371
+ if (await rolloutPathStat(filename)) found = true;
372
+ }
373
+ return found;
374
+ }
375
+
376
+ async function readRolloutSettings(storageFile) {
377
+ const entry = await rolloutPathStat(storageFile);
378
+ if (!entry) return null;
379
+ const file = entry.isSymbolicLink() ? await stat(storageFile) : entry;
380
+ // Reading a special file could block startup outside the lock's deadline.
381
+ if (!file.isFile()) throw new TypeError("Rollout settings must be a regular file");
382
+ return readRawWebuiSettings(storageFile, { missing: null });
383
+ }
384
+
385
+ /** Initializes startup-only rollout evidence without normalizing stored settings. */
386
+ export async function initializeWebuiShellRollout({
387
+ env = process.env,
388
+ storageFile = webuiSettingsFile(env),
389
+ legacyFile = legacyWebuiSettingsFile(env),
390
+ additionalEvidencePaths = [],
391
+ } = {}) {
392
+ try {
393
+ const target = path.resolve(storageFile);
394
+ const root = path.dirname(target);
395
+ const defaultTarget = isDefaultSettingsTarget(target, env);
396
+ // Canonicalize the parent, never the root: creating the root here loses proof.
397
+ await mkdir(path.dirname(root), { recursive: true, mode: 0o700 });
398
+ const parent = await realpath(path.dirname(root));
399
+ const initializationLock = path.join(parent, `.${path.basename(root)}-shell-rollout-init`);
400
+ return await withWebuiSettingsLock(initializationLock, async () => {
401
+ const rootBefore = await rolloutPathStat(root);
402
+ const targetBefore = await rolloutPathStat(target);
403
+ const initialRaw = targetBefore ? await readRolloutSettings(target) : null;
404
+ if (initialRaw && Object.hasOwn(initialRaw, "shellRollout")) {
405
+ return withWebuiSettingsLock(target, async () => {
406
+ const raw = await readRolloutSettings(target);
407
+ return { cohort: validatedShellRolloutCohort(raw?.shellRollout) };
408
+ });
409
+ }
410
+ if (rootBefore && !rootBefore.isDirectory()) return { cohort: null };
411
+ if (targetBefore && !targetBefore.isFile()) return { cohort: null };
412
+
413
+ const evidencePaths = [legacyFile, ...additionalEvidencePaths];
414
+ const priorUse = await hasRolloutEvidence(evidencePaths);
415
+ let legacy = null;
416
+ if (defaultTarget && !targetBefore && path.resolve(legacyFile) !== target) {
417
+ const legacyStat = await rolloutPathStat(legacyFile);
418
+ if (legacyStat && !legacyStat.isFile()) return { cohort: null };
419
+ legacy = await readRawWebuiSettings(legacyFile, { missing: null });
420
+ }
421
+
422
+ let createdRoot = false;
423
+ if (defaultTarget && !rootBefore && !targetBefore && !priorUse) {
424
+ try {
425
+ await mkdir(root, { mode: 0o700 });
426
+ createdRoot = true;
427
+ } catch (error) {
428
+ if (error?.code !== "EEXIST") throw error;
429
+ }
430
+ }
431
+ // Migration must precede the marker, which would otherwise hide legacy data.
432
+ if (defaultTarget && legacy) await migrateLegacyWebuiSettings(target, legacyFile);
433
+ return withWebuiSettingsLock(target, async () => {
434
+ const raw = await readRolloutSettings(target);
435
+ if (raw && Object.hasOwn(raw, "shellRollout")) {
436
+ return { cohort: validatedShellRolloutCohort(raw.shellRollout) };
437
+ }
438
+ const currentRoot = await rolloutPathStat(root);
439
+ const currentTarget = await rolloutPathStat(target);
440
+ if (!currentRoot?.isDirectory() || (currentTarget && !currentTarget.isFile())) return { cohort: null };
441
+ // A source appearing after migration must be handled by the next startup.
442
+ if (!raw && defaultTarget && path.resolve(legacyFile) !== target
443
+ && await rolloutPathStat(legacyFile)) return { cohort: null };
444
+ if (!raw && legacy) return { cohort: null };
445
+ const cohort = createdRoot && !raw && !await hasRolloutEvidence(evidencePaths) ? "fresh" : "established";
446
+ await writePrivateAtomicSettings(target, { ...raw, shellRollout: { version: 1, cohort } });
447
+ const persisted = await readRolloutSettings(target);
448
+ return { cohort: validatedShellRolloutCohort(persisted?.shellRollout) };
449
+ });
450
+ });
451
+ } catch {
452
+ // Failed proof or persistence must never enable a transient fresh default.
453
+ return { cohort: null };
454
+ }
455
+ }
456
+
457
+ export async function readWebuiSettings(storageFile = webuiSettingsFile(), { reportInvalidOutputMode = false } = {}) {
458
+ await ensureDefaultSettingsMigration(storageFile);
459
+ const raw = await readRawWebuiSettings(storageFile);
460
+ const normalized = normalizeWebuiSettings(raw);
461
+ if (reportInvalidOutputMode && raw.outputModeDefault !== undefined && normalized.outputModeDefault !== raw.outputModeDefault) {
462
+ console.warn(`Invalid persisted Web UI output mode ${JSON.stringify(raw.outputModeDefault)}; using ${OUTPUT_MODE_NORMAL}.`);
463
+ }
464
+ return normalized;
465
+ }
466
+
467
+ function mergeWebuiSettings(rawCurrent, patch) {
468
+ const raw = settingsObject(rawCurrent);
469
+ const current = normalizeWebuiSettings(raw);
470
+ const patchValue = settingsObject(patch);
471
+ const hasLaunchSlotPatch = Object.hasOwn(patchValue, "subagentLaunchSlots");
472
+ const persistLaunchSlots = raw.subagentLaunchSlots !== undefined || hasLaunchSlotPatch;
473
+ const source = {
474
+ ...raw,
475
+ ...patchValue,
476
+ gitWorkflow: patchValue.gitWorkflow
477
+ ? mergeGitWorkflowPreferences(current.gitWorkflow, patchValue.gitWorkflow)
478
+ : current.gitWorkflow,
479
+ resourceDefaults: patchValue.resourceDefaults
480
+ ? {
481
+ ...current.resourceDefaults,
482
+ ...patchValue.resourceDefaults,
483
+ tools: { ...current.resourceDefaults.tools, ...(patchValue.resourceDefaults.tools || {}) },
484
+ skills: { ...current.resourceDefaults.skills, ...(patchValue.resourceDefaults.skills || {}) },
485
+ }
486
+ : current.resourceDefaults,
487
+ interfacePreferences: patchValue.interfacePreferences
488
+ ? { ...current.interfacePreferences, ...patchValue.interfacePreferences }
489
+ : current.interfacePreferences,
490
+ uiLayout: Object.hasOwn(patchValue, "uiLayout")
491
+ ? normalizeUiLayout(patchValue.uiLayout)
492
+ : current.uiLayout,
493
+ };
494
+ if (persistLaunchSlots) {
495
+ source.subagentLaunchSlots = hasLaunchSlotPatch
496
+ ? normalizeSubagentLaunchSlots(patchValue.subagentLaunchSlots)
497
+ : normalizeSubagentLaunchSlots(raw.subagentLaunchSlots);
498
+ source.version = Math.max(5, Number.isInteger(raw.version) ? raw.version : 0);
499
+ } else {
500
+ delete source.subagentLaunchSlots;
501
+ source.version = Math.max(WEBUI_SETTINGS_VERSION, Number.isInteger(raw.version) ? raw.version : 0);
502
+ }
503
+ const settings = normalizeWebuiSettings(source);
504
+ const rawLayoutVersion = Number.isInteger(raw.uiLayout?.version) ? raw.uiLayout.version : 0;
505
+ const persistedUiLayout = !Object.hasOwn(patchValue, "uiLayout") && rawLayoutVersion > settings.uiLayout.version
506
+ ? raw.uiLayout
507
+ : settings.uiLayout;
508
+ return { settings, persistLaunchSlots, persistedUiLayout };
509
+ }
510
+
511
+ async function writeMergedWebuiSettings(rawCurrent, patch, storageFile) {
512
+ const { settings, persistLaunchSlots, persistedUiLayout } = mergeWebuiSettings(rawCurrent, patch);
513
+ const persisted = { ...settings, uiLayout: persistedUiLayout };
514
+ if (!persistLaunchSlots) delete persisted.subagentLaunchSlots;
515
+ await writePrivateAtomicSettings(storageFile, persisted);
516
+ return settings;
517
+ }
518
+
519
+ /**
520
+ * Applies a settings patch against the latest on-disk snapshot and writes it
521
+ * atomically. Returning undefined from the updater avoids an unnecessary write.
522
+ */
523
+ export function updateWebuiSettings(updater, storageFile = webuiSettingsFile()) {
524
+ const queueKey = path.resolve(storageFile);
525
+ const previous = webuiSettingsUpdateQueues.get(queueKey) || Promise.resolve();
526
+ const currentUpdate = previous.catch(() => {}).then(async () => {
527
+ await ensureDefaultSettingsMigration(storageFile);
528
+ return withWebuiSettingsLock(storageFile, async () => {
529
+ const rawCurrent = await readRawWebuiSettings(storageFile);
530
+ const current = normalizeWebuiSettings(rawCurrent);
531
+ const patch = await updater(current);
532
+ if (patch === undefined) return current;
533
+ return writeMergedWebuiSettings(rawCurrent, patch, storageFile);
534
+ });
535
+ });
536
+ webuiSettingsUpdateQueues.set(queueKey, currentUpdate);
537
+ return currentUpdate.finally(() => {
538
+ if (webuiSettingsUpdateQueues.get(queueKey) === currentUpdate) webuiSettingsUpdateQueues.delete(queueKey);
539
+ });
540
+ }
541
+
542
+ export async function writeWebuiSettings(patch, storageFile = webuiSettingsFile()) {
543
+ return updateWebuiSettings(() => patch, storageFile);
544
+ }
@@ -0,0 +1,138 @@
1
+ import {
2
+ OUTPUT_MODE_NORMAL,
3
+ OUTPUT_MODE_PROTOCOL_VERSION,
4
+ encodeBrowserSseEvent,
5
+ isOutputModeSemanticBarrier,
6
+ normalizeOutputMode,
7
+ } from "../webui-output-mode.mjs";
8
+
9
+ const SSE_BACKPRESSURE_MAX_PENDING_BYTES = 4 * 1024 * 1024;
10
+ const SSE_BACKPRESSURE_MAX_PENDING_FRAMES = 256;
11
+ const SSE_BACKPRESSURE_TIMEOUT_MS = 10_000;
12
+
13
+ export function createSseDelivery() {
14
+ function clearSseBackpressureTimer(client) {
15
+ if (!client?.backpressureTimer) return;
16
+ clearTimeout(client.backpressureTimer);
17
+ client.backpressureTimer = undefined;
18
+ }
19
+
20
+ function evictSlowSseClient(client) {
21
+ if (!client || client.evicted) return;
22
+ client.evicted = true;
23
+ client.backpressured = false;
24
+ clearSseBackpressureTimer(client);
25
+ client.pendingFrames = [];
26
+ client.pendingFrameBytes = 0;
27
+ client.tab?.sseClients?.delete(client);
28
+ try {
29
+ // Complete the chunked response so Chromium can reconnect without
30
+ // ERR_INCOMPLETE_CHUNKED_ENCODING.
31
+ client.res?.end();
32
+ } catch {
33
+ // A closed browser socket needs no further cleanup.
34
+ }
35
+ }
36
+
37
+ function scheduleSseBackpressureTimeout(client) {
38
+ clearSseBackpressureTimer(client);
39
+ client.backpressureTimer = setTimeout(() => evictSlowSseClient(client), SSE_BACKPRESSURE_TIMEOUT_MS);
40
+ client.backpressureTimer.unref?.();
41
+ }
42
+
43
+ function flushSseClient(client) {
44
+ const res = client?.res;
45
+ if (!client || client.evicted) return;
46
+ if (!res || res.destroyed || res.writableEnded) {
47
+ evictSlowSseClient(client);
48
+ return;
49
+ }
50
+ client.backpressured = false;
51
+ clearSseBackpressureTimer(client);
52
+ while (client.pendingFrames?.length) {
53
+ const frame = client.pendingFrames.shift();
54
+ client.pendingFrameBytes -= Buffer.byteLength(frame);
55
+ try {
56
+ if (!res.write(frame)) {
57
+ client.backpressured = true;
58
+ scheduleSseBackpressureTimeout(client);
59
+ res.once("drain", () => flushSseClient(client));
60
+ return;
61
+ }
62
+ } catch {
63
+ evictSlowSseClient(client);
64
+ return;
65
+ }
66
+ }
67
+ client.pendingFrameBytes = 0;
68
+ }
69
+
70
+ function writeSseFrame(client, frame) {
71
+ const res = client?.res || client;
72
+ if (!res || res.destroyed || res.writableEnded || client?.evicted) return false;
73
+ if (client?.res && client.backpressured) {
74
+ const frameBytes = Buffer.byteLength(frame);
75
+ const pendingFrames = client.pendingFrames || (client.pendingFrames = []);
76
+ const pendingBytes = Number(client.pendingFrameBytes) || 0;
77
+ if (pendingFrames.length >= SSE_BACKPRESSURE_MAX_PENDING_FRAMES || pendingBytes + frameBytes > SSE_BACKPRESSURE_MAX_PENDING_BYTES) {
78
+ evictSlowSseClient(client);
79
+ return false;
80
+ }
81
+ pendingFrames.push(frame);
82
+ client.pendingFrameBytes = pendingBytes + frameBytes;
83
+ return true;
84
+ }
85
+ try {
86
+ if (!res.write(frame) && client?.res) {
87
+ client.backpressured = true;
88
+ scheduleSseBackpressureTimeout(client);
89
+ res.once("drain", () => flushSseClient(client));
90
+ }
91
+ // write() returning false still accepted this frame.
92
+ return true;
93
+ } catch {
94
+ if (client?.res) evictSlowSseClient(client);
95
+ return false;
96
+ }
97
+ }
98
+
99
+ function sendSse(client, event) {
100
+ const payload = encodeBrowserSseEvent(event, { outputMode: client?.activeMode || OUTPUT_MODE_NORMAL });
101
+ if (payload === undefined) return false;
102
+ return writeSseFrame(client, `data: ${payload}\n\n`);
103
+ }
104
+
105
+ function activateOutputMode(client, activeMode, reason = "server-default-change") {
106
+ const nextMode = normalizeOutputMode(activeMode);
107
+ if (client.activeMode === nextMode) {
108
+ client.pendingMode = undefined;
109
+ return;
110
+ }
111
+ sendSse(client, {
112
+ type: "webui_output_mode",
113
+ protocolVersion: OUTPUT_MODE_PROTOCOL_VERSION,
114
+ previousMode: client.activeMode,
115
+ activeMode: nextMode,
116
+ reason,
117
+ });
118
+ client.activeMode = nextMode;
119
+ client.pendingMode = undefined;
120
+ }
121
+
122
+ function sendSseToClient(client, event) {
123
+ const sent = sendSse(client, event);
124
+ if (sent && client?.pendingMode && isOutputModeSemanticBarrier(event)) activateOutputMode(client, client.pendingMode);
125
+ return sent;
126
+ }
127
+
128
+ return {
129
+ clearSseBackpressureTimer,
130
+ evictSlowSseClient,
131
+ scheduleSseBackpressureTimeout,
132
+ flushSseClient,
133
+ writeSseFrame,
134
+ sendSse,
135
+ activateOutputMode,
136
+ sendSseToClient,
137
+ };
138
+ }