@firstpick/pi-package-webui 0.11.1 → 0.11.3

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 (310) hide show
  1. package/DEVELOPMENT.md +151 -12
  2. package/README.md +34 -6
  3. package/TECHNICAL.md +75 -8
  4. package/bin/pi-webui.mjs +5390 -11423
  5. package/index.ts +10 -3
  6. package/lib/component-update-state.mjs +2 -2
  7. package/lib/git-workflow-preference-values.mjs +122 -0
  8. package/lib/git-workflow-preferences.mjs +35 -563
  9. package/lib/package-updates.mjs +260 -0
  10. package/lib/rpc-supervisor-client.mjs +8 -4
  11. package/lib/server/app-runners.mjs +1667 -0
  12. package/lib/server/codex-fast-mode.mjs +161 -0
  13. package/lib/server/conversation-mode.mjs +218 -0
  14. package/lib/server/conversation-voice.mjs +318 -0
  15. package/lib/server/extension-ui-requests.mjs +114 -0
  16. package/lib/server/git-generation.mjs +459 -0
  17. package/lib/server/git-mutations.mjs +1827 -0
  18. package/lib/server/git-reads.mjs +608 -0
  19. package/lib/server/git-worktree-sessions.mjs +408 -0
  20. package/lib/server/helper-requests.mjs +82 -0
  21. package/lib/server/no-project-workspaces.mjs +103 -0
  22. package/lib/server/rpc-transports.mjs +394 -0
  23. package/lib/server/settings-store.mjs +544 -0
  24. package/lib/server/sse-delivery.mjs +138 -0
  25. package/lib/server/workspace-files.mjs +563 -0
  26. package/lib/update/supervisor.mjs +4 -0
  27. package/lib/webui-workspaces.mjs +2 -0
  28. package/package.json +4 -4
  29. package/public/activity-agents-controller.mjs +269 -0
  30. package/public/activity-events-controller.mjs +236 -0
  31. package/public/activity-intercom-controller.mjs +627 -0
  32. package/public/activity-queue-controller.mjs +534 -0
  33. package/public/activity-todo-view.mjs +89 -0
  34. package/public/activity-usage-controller.mjs +589 -0
  35. package/public/app.js +3761 -3886
  36. package/public/conversation-overview.css +84 -0
  37. package/public/conversation-overview.mjs +193 -0
  38. package/public/draft-conversations.mjs +135 -0
  39. package/public/focused-composer-controls.css +111 -0
  40. package/public/focused-composer-controls.mjs +143 -0
  41. package/public/focused-composer-disclosure.mjs +223 -0
  42. package/public/focused-shell-adapter.css +264 -0
  43. package/public/focused-shell-adapter.mjs +257 -0
  44. package/public/index.html +137 -80
  45. package/public/model-catalog-order.mjs +63 -0
  46. package/public/platform-event-stream.mjs +64 -0
  47. package/public/project-artifact-controller.mjs +218 -0
  48. package/public/project-file-viewer-controller.mjs +383 -0
  49. package/public/project-git-tools-controller.mjs +181 -0
  50. package/public/project-runners-controller.mjs +220 -0
  51. package/public/service-worker.js +52 -1
  52. package/public/session-attention-scheduler.mjs +182 -0
  53. package/public/session-composer-store.mjs +56 -0
  54. package/public/session-context.mjs +51 -0
  55. package/public/session-extension-requests.mjs +63 -0
  56. package/public/session-shelf-state.mjs +151 -0
  57. package/public/session-shelves.css +171 -0
  58. package/public/session-shelves.mjs +95 -0
  59. package/public/settings-navigation-controller.mjs +249 -0
  60. package/public/settings-navigation.css +61 -0
  61. package/public/settings-resource-controller.mjs +232 -0
  62. package/public/settings-workspace.css +19 -0
  63. package/public/settings-workspace.mjs +175 -0
  64. package/public/shell-actions.mjs +87 -0
  65. package/public/shell-attention-inbox.css +72 -0
  66. package/public/shell-attention-inbox.mjs +198 -0
  67. package/public/shell-context-actions.css +61 -0
  68. package/public/shell-context-actions.mjs +168 -0
  69. package/public/shell-inspector-resize.mjs +124 -0
  70. package/public/shell-navigation-resize.mjs +107 -0
  71. package/public/shell-navigation.mjs +127 -0
  72. package/public/shell-preferences.mjs +108 -0
  73. package/public/shell-surfaces.mjs +99 -0
  74. package/public/shell-tools-launcher.css +97 -0
  75. package/public/shell-tools-launcher.mjs +222 -0
  76. package/public/shell-view-host.mjs +115 -0
  77. package/public/shell-workspace.css +266 -0
  78. package/public/shell-workspace.mjs +402 -0
  79. package/public/sidebar-update-menu.css +190 -0
  80. package/public/sidebar-update-menu.mjs +512 -0
  81. package/public/styles.css +322 -169
  82. package/public/subagent-launch-slot-state.mjs +2 -2
  83. package/public/themed-selects.css +156 -0
  84. package/public/workspace-choices.mjs +104 -0
  85. package/tests/activity-agents-controller.test.mjs +652 -0
  86. package/tests/activity-events-controller.test.mjs +511 -0
  87. package/tests/app-runner-terminal-static.test.mjs +3 -3
  88. package/tests/append-system-http.test.mjs +7 -6
  89. package/tests/append-system-selector-static.test.mjs +6 -6
  90. package/tests/aur-review-widget-static.test.mjs +11 -3
  91. package/tests/boot-failure-diagnostics.test.mjs +8 -3
  92. package/tests/browser/action-feedback-gutter.spec.mjs +251 -0
  93. package/tests/browser/activity-intercom-controller.spec.mjs +457 -0
  94. package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
  95. package/tests/browser/activity-owner-integration.spec.mjs +201 -0
  96. package/tests/browser/activity-queue-controller.spec.mjs +405 -0
  97. package/tests/browser/activity-section-picker.spec.mjs +294 -0
  98. package/tests/browser/activity-todo-view.spec.mjs +60 -0
  99. package/tests/browser/activity-usage-controller.spec.mjs +416 -0
  100. package/tests/browser/compact-layout-integration.spec.mjs +58 -0
  101. package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
  102. package/tests/browser/composer-disclosure.spec.mjs +389 -0
  103. package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
  104. package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
  105. package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
  106. package/tests/browser/control-visibility.spec.mjs +5 -0
  107. package/tests/browser/controls-layout.spec.mjs +21 -2
  108. package/tests/browser/conversation-overview.spec.mjs +251 -0
  109. package/tests/browser/draft-conversations.spec.mjs +276 -0
  110. package/tests/browser/empty-startup-fixture.mjs +135 -0
  111. package/tests/browser/empty-startup.spec.mjs +282 -0
  112. package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
  113. package/tests/browser/focused-composer-more.spec.mjs +127 -0
  114. package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
  115. package/tests/browser/focused-navigation-fixture.mjs +32 -0
  116. package/tests/browser/focused-project-activity.spec.mjs +111 -0
  117. package/tests/browser/focused-shell-integration.spec.mjs +208 -0
  118. package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
  119. package/tests/browser/folder-picker-layout.spec.mjs +302 -0
  120. package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
  121. package/tests/browser/git-setup-cancel.spec.mjs +251 -0
  122. package/tests/browser/guided-git-fallback.spec.mjs +40 -21
  123. package/tests/browser/inspector-header.spec.mjs +221 -0
  124. package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
  125. package/tests/browser/inspector-resize.spec.mjs +227 -0
  126. package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
  127. package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
  128. package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
  129. package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
  130. package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
  131. package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
  132. package/tests/browser/interaction-continuity.spec.mjs +50 -26
  133. package/tests/browser/interaction-model-picker.spec.mjs +86 -0
  134. package/tests/browser/last-terminal-close.spec.mjs +280 -0
  135. package/tests/browser/mobile-foundation.spec.mjs +172 -20
  136. package/tests/browser/model-catalog-groups.spec.mjs +104 -0
  137. package/tests/browser/more-row-menus.spec.mjs +258 -0
  138. package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
  139. package/tests/browser/no-project-conversation.spec.mjs +113 -0
  140. package/tests/browser/optimistic-prompt.spec.mjs +3 -0
  141. package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
  142. package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
  143. package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
  144. package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
  145. package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
  146. package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
  147. package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
  148. package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
  149. package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
  150. package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
  151. package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
  152. package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
  153. package/tests/browser/project-artifact-controller.spec.mjs +324 -0
  154. package/tests/browser/project-artifact-integration.spec.mjs +103 -0
  155. package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
  156. package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
  157. package/tests/browser/session-fixture.mjs +118 -0
  158. package/tests/browser/session-ownership.spec.mjs +175 -0
  159. package/tests/browser/session-shelves-integration.spec.mjs +219 -0
  160. package/tests/browser/session-shelves.spec.mjs +340 -0
  161. package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
  162. package/tests/browser/session-summary.spec.mjs +17 -12
  163. package/tests/browser/settings-complete-home.spec.mjs +463 -0
  164. package/tests/browser/settings-entrypoint.spec.mjs +104 -0
  165. package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
  166. package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
  167. package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
  168. package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
  169. package/tests/browser/shell-ownership.spec.mjs +398 -0
  170. package/tests/browser/shell-rollout-fixture.mjs +259 -0
  171. package/tests/browser/shell-rollout.spec.mjs +357 -0
  172. package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
  173. package/tests/browser/shell-workspace.spec.mjs +433 -0
  174. package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
  175. package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
  176. package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
  177. package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
  178. package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
  179. package/tests/browser/stream-output-isolation.spec.mjs +6 -3
  180. package/tests/browser/themed-selects.spec.mjs +297 -0
  181. package/tests/browser/thread-start-flow.spec.mjs +481 -0
  182. package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
  183. package/tests/browser/ui-polish-features.spec.mjs +85 -0
  184. package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
  185. package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
  186. package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
  187. package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
  188. package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
  189. package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
  190. package/tests/browser/windows-drive-parent.spec.mjs +4 -2
  191. package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
  192. package/tests/codex-fast-mode-static.test.mjs +16 -11
  193. package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
  194. package/tests/codex-usage-source.test.mjs +4 -3
  195. package/tests/component-update-api-static.test.mjs +2 -2
  196. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  197. package/tests/control-deck-component-updates-static.test.mjs +9 -4
  198. package/tests/control-visibility-static.test.mjs +3 -3
  199. package/tests/controls-layout-static.test.mjs +5 -5
  200. package/tests/conversation-overview-adapter.test.mjs +100 -0
  201. package/tests/document-artifact-static.test.mjs +2 -1
  202. package/tests/draft-conversations.test.mjs +205 -0
  203. package/tests/empty-startup-launcher.test.mjs +197 -0
  204. package/tests/events-tree-context-menu-static.test.mjs +22 -18
  205. package/tests/fake-pi-session-ownership.test.mjs +302 -0
  206. package/tests/fast-mode-client-static.test.mjs +1 -1
  207. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  208. package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
  209. package/tests/file-viewer-image-static.test.mjs +15 -11
  210. package/tests/file-viewer-search-static.test.mjs +5 -5
  211. package/tests/fixtures/fake-pi.mjs +41 -9
  212. package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
  213. package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
  214. package/tests/git-footer-context-menu-static.test.mjs +1 -1
  215. package/tests/git-panel-file-preview-static.test.mjs +41 -48
  216. package/tests/git-panel-live-updates-static.test.mjs +2 -1
  217. package/tests/git-workflow-dispatch.test.mjs +66 -0
  218. package/tests/git-workflow-preferences.test.mjs +9 -1
  219. package/tests/guided-git-activation-static.test.mjs +14 -11
  220. package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
  221. package/tests/guided-git-message-reliability-static.test.mjs +10 -6
  222. package/tests/guided-git-publication-backend-static.test.mjs +16 -11
  223. package/tests/http-endpoints-harness.test.mjs +21 -9
  224. package/tests/interaction-state-stability-static.test.mjs +4 -3
  225. package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
  226. package/tests/intercom-tag-layout-static.test.mjs +13 -12
  227. package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
  228. package/tests/main-output-loading-static.test.mjs +4 -4
  229. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  230. package/tests/mobile-compact-layout.test.mjs +2 -2
  231. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  232. package/tests/mobile-foundation-static.test.mjs +10 -7
  233. package/tests/mobile-phone-experience-static.test.mjs +3 -2
  234. package/tests/mobile-static.test.mjs +173 -135
  235. package/tests/model-catalog-order.test.mjs +103 -0
  236. package/tests/native-parity.test.mjs +6 -4
  237. package/tests/native-session-choice-owner.test.mjs +102 -0
  238. package/tests/native-update-lifecycle.test.mjs +10 -5
  239. package/tests/no-project-http-harness.test.mjs +328 -0
  240. package/tests/no-project-navigation.test.mjs +54 -0
  241. package/tests/no-project-workspaces.test.mjs +77 -0
  242. package/tests/open-issue-wizard-static.test.mjs +1 -1
  243. package/tests/optional-feature-migration-frontend.test.mjs +4 -4
  244. package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
  245. package/tests/package-updates.test.mjs +630 -0
  246. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  247. package/tests/platform-event-stream.test.mjs +253 -0
  248. package/tests/project-file-viewer-controller.test.mjs +652 -0
  249. package/tests/project-git-tools-adapter.test.mjs +103 -0
  250. package/tests/project-git-tools-controller.test.mjs +577 -0
  251. package/tests/project-runners-controller.test.mjs +453 -0
  252. package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
  253. package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
  254. package/tests/questionnaire-dialog.test.mjs +6 -6
  255. package/tests/queue-edit-reorder-static.test.mjs +48 -51
  256. package/tests/rpc-supervisor-host.test.mjs +4 -1
  257. package/tests/safety-guard-auto-review-static.test.mjs +1 -1
  258. package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
  259. package/tests/server-app-runners.test.mjs +536 -0
  260. package/tests/server-codex-fast-mode.test.mjs +346 -0
  261. package/tests/server-conversation-mode.test.mjs +386 -0
  262. package/tests/server-conversation-voice.test.mjs +426 -0
  263. package/tests/server-extension-ui-requests.test.mjs +357 -0
  264. package/tests/server-git-generation.test.mjs +558 -0
  265. package/tests/server-git-mutations.test.mjs +729 -0
  266. package/tests/server-git-reads.test.mjs +381 -0
  267. package/tests/server-git-worktree-sessions.test.mjs +502 -0
  268. package/tests/server-helper-requests.test.mjs +364 -0
  269. package/tests/server-rpc-transports.test.mjs +553 -0
  270. package/tests/server-settings-store.test.mjs +132 -0
  271. package/tests/server-shell-rollout.test.mjs +478 -0
  272. package/tests/server-sse-delivery.test.mjs +410 -0
  273. package/tests/server-workspace-files.test.mjs +546 -0
  274. package/tests/session-attention-scheduler.test.mjs +514 -0
  275. package/tests/session-composer-store.test.mjs +153 -0
  276. package/tests/session-context.test.mjs +134 -0
  277. package/tests/session-extension-requests.test.mjs +193 -0
  278. package/tests/session-ownership-adapter.test.mjs +130 -0
  279. package/tests/session-sampling-ui-static.test.mjs +10 -4
  280. package/tests/session-send-lifetime.test.mjs +140 -0
  281. package/tests/session-shelf-state.test.mjs +348 -0
  282. package/tests/session-shelves-adapter.test.mjs +79 -0
  283. package/tests/session-summary-lifetime.test.mjs +54 -0
  284. package/tests/settings-resource-controller.test.mjs +548 -0
  285. package/tests/shell-action-adapter.test.mjs +169 -0
  286. package/tests/shell-actions.test.mjs +182 -0
  287. package/tests/shell-navigation.test.mjs +348 -0
  288. package/tests/shell-preferences.test.mjs +367 -0
  289. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  290. package/tests/stream-output-isolation-static.test.mjs +1 -1
  291. package/tests/subagent-gate-visibility.test.mjs +1 -1
  292. package/tests/subagent-launch-slot-state.test.mjs +2 -2
  293. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  294. package/tests/subagent-observability-static.test.mjs +2 -2
  295. package/tests/subagent-reliability-integration.test.mjs +13 -30
  296. package/tests/syntax-highlighting-static.test.mjs +3 -3
  297. package/tests/tab-close-continuity-static.test.mjs +1 -1
  298. package/tests/tab-metadata-ordering.test.mjs +99 -0
  299. package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
  300. package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
  301. package/tests/terminal-tab-workspace-static.test.mjs +5 -4
  302. package/tests/terminal-tabs-resize-static.test.mjs +1 -1
  303. package/tests/theme-customizer-static.test.mjs +1 -1
  304. package/tests/thread-display-title.test.mjs +44 -0
  305. package/tests/update-api-harness.test.mjs +15 -14
  306. package/tests/update-tab-restore-harness.test.mjs +3 -0
  307. package/tests/webui-settings-locking.test.mjs +2 -2
  308. package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
  309. package/tests/workspace-choices.test.mjs +114 -0
  310. package/tests/workspace-save-load-static.test.mjs +7 -4
@@ -0,0 +1,410 @@
1
+ import assert from "node:assert/strict";
2
+ import { EventEmitter } from "node:events";
3
+ import test from "node:test";
4
+ import { createSseDelivery } from "../lib/server/sse-delivery.mjs";
5
+
6
+ class ResponseDouble extends EventEmitter {
7
+ constructor(writeResults = []) {
8
+ super();
9
+ this.writeResults = [...writeResults];
10
+ this.frames = [];
11
+ this.bytes = 0;
12
+ this.destroyed = false;
13
+ this.writableEnded = false;
14
+ this.endCalls = 0;
15
+ this.destroyCalls = 0;
16
+ this.writeError = undefined;
17
+ this.endError = undefined;
18
+ }
19
+
20
+ write(frame) {
21
+ assert.equal(this.destroyed || this.writableEnded, false);
22
+ assert.ok(this.frames.length < 300, "response double write bound");
23
+ assert.ok(this.bytes + Buffer.byteLength(frame) <= 8 * 1024 * 1024, "response double byte bound");
24
+ if (this.writeError) throw this.writeError;
25
+ this.frames.push(frame);
26
+ this.bytes += Buffer.byteLength(frame);
27
+ return this.writeResults.length ? this.writeResults.shift() : true;
28
+ }
29
+
30
+ end() {
31
+ this.endCalls += 1;
32
+ if (this.endError) throw this.endError;
33
+ this.writableEnded = true;
34
+ }
35
+
36
+ destroy() {
37
+ this.destroyCalls += 1;
38
+ this.destroyed = true;
39
+ }
40
+ }
41
+
42
+ function fixture(t, { writeResults, activeMode = "normal", pendingMode } = {}) {
43
+ const delivery = createSseDelivery();
44
+ const res = new ResponseDouble(writeResults);
45
+ const tab = { sseClients: new Set() };
46
+ const client = { res, tab, activeMode, pendingMode };
47
+ tab.sseClients.add(client);
48
+ t.after(() => delivery.clearSseBackpressureTimer(client));
49
+ return { delivery, res, tab, client };
50
+ }
51
+
52
+ function events(frames) {
53
+ return frames.map((frame) => {
54
+ assert.match(frame, /^data: .+\n\n$/);
55
+ return JSON.parse(frame.slice(6));
56
+ });
57
+ }
58
+
59
+ function assertEvicted({ client, res, tab }) {
60
+ assert.equal(client.evicted, true);
61
+ assert.equal(client.backpressured, false);
62
+ assert.equal(client.backpressureTimer, undefined);
63
+ assert.deepEqual(client.pendingFrames, []);
64
+ assert.equal(client.pendingFrameBytes, 0);
65
+ assert.equal(tab.sseClients.has(client), false);
66
+ assert.equal(res.endCalls, 1);
67
+ assert.equal(res.destroyCalls, 0);
68
+ }
69
+
70
+ test("import and factory construction have no timer or listener effects", async (t) => {
71
+ const timeout = t.mock.method(globalThis, "setTimeout", () => assert.fail("unexpected timer"));
72
+ const interval = t.mock.method(globalThis, "setInterval", () => assert.fail("unexpected interval"));
73
+ const listeners = process.eventNames().map((name) => [name, process.listeners(name)]);
74
+ const module = await import("../lib/server/sse-delivery.mjs?inert-import");
75
+ assert.deepEqual(Object.keys(module), ["createSseDelivery"]);
76
+ const delivery = module.createSseDelivery();
77
+ assert.deepEqual(Object.keys(delivery).sort(), [
78
+ "activateOutputMode", "clearSseBackpressureTimer", "evictSlowSseClient", "flushSseClient",
79
+ "scheduleSseBackpressureTimeout", "sendSse", "sendSseToClient", "writeSseFrame",
80
+ ]);
81
+ assert.equal(timeout.mock.callCount(), 0);
82
+ assert.equal(interval.mock.callCount(), 0);
83
+ assert.deepEqual(process.eventNames().map((name) => [name, process.listeners(name)]), listeners);
84
+ });
85
+
86
+ test("writes normal SSE and raw keepalive frames", (t) => {
87
+ const { delivery, client, res } = fixture(t);
88
+ delete client.activeMode;
89
+ const event = { type: "message_update", text: "hello\nworld", tabId: "tab-a" };
90
+ assert.equal(delivery.sendSse(client, event), true);
91
+ assert.deepEqual(events(res.frames), [event]);
92
+ assert.equal(delivery.writeSseFrame(client, ": keepalive\n\n"), true);
93
+ assert.equal(res.frames[1], ": keepalive\n\n");
94
+ assert.equal(client.backpressureTimer, undefined);
95
+ });
96
+
97
+ test("raw response writes accept false without creating client state", () => {
98
+ const delivery = createSseDelivery();
99
+ const res = new ResponseDouble([false]);
100
+ assert.equal(delivery.sendSse(res, { type: "agent_end" }), true);
101
+ assert.deepEqual(events(res.frames), [{ type: "agent_end" }]);
102
+ assert.equal(res.backpressured, undefined);
103
+ assert.equal(res.backpressureTimer, undefined);
104
+ res.writeError = new Error("closed socket");
105
+ assert.equal(delivery.writeSseFrame(res, "next"), false);
106
+ assert.equal(res.endCalls, 0);
107
+ });
108
+
109
+ test("write false accepts the frame once and queues later frames until drain", (t) => {
110
+ const f = fixture(t, { writeResults: [false] });
111
+ const { delivery, client, res } = f;
112
+ assert.equal(delivery.writeSseFrame(client, "accepted"), true);
113
+ assert.equal(client.backpressured, true);
114
+ assert.equal(client.backpressureTimer.hasRef(), false);
115
+ assert.equal(res.listenerCount("drain"), 1);
116
+ const timer = client.backpressureTimer;
117
+ for (const frame of ["é", "last"]) assert.equal(delivery.writeSseFrame(client, frame), true);
118
+ assert.deepEqual(res.frames, ["accepted"]);
119
+ assert.deepEqual(client.pendingFrames, ["é", "last"]);
120
+ assert.equal(client.pendingFrameBytes, 6);
121
+ assert.equal(client.backpressureTimer, timer, "queue growth must not extend the timeout");
122
+ res.emit("drain");
123
+ assert.deepEqual(res.frames, ["accepted", "é", "last"]);
124
+ assert.equal(client.backpressured, false);
125
+ assert.equal(client.backpressureTimer, undefined);
126
+ assert.deepEqual(client.pendingFrames, []);
127
+ assert.equal(client.pendingFrameBytes, 0);
128
+ assert.equal(res.listenerCount("drain"), 0);
129
+ assert.equal(client.evicted, undefined);
130
+ });
131
+
132
+ test("a second write false during flush preserves queue order and byte accounting", (t) => {
133
+ const { delivery, client, res } = fixture(t, { writeResults: [false, true, false] });
134
+ for (const frame of ["initial", "one", "é", "three"]) delivery.writeSseFrame(client, frame);
135
+ const firstTimer = client.backpressureTimer;
136
+ res.emit("drain");
137
+ assert.deepEqual(res.frames, ["initial", "one", "é"]);
138
+ assert.deepEqual(client.pendingFrames, ["three"]);
139
+ assert.equal(client.pendingFrameBytes, 5);
140
+ assert.equal(client.backpressured, true);
141
+ assert.notEqual(client.backpressureTimer, firstTimer);
142
+ assert.equal(res.listenerCount("drain"), 1);
143
+ delivery.writeSseFrame(client, "four");
144
+ res.emit("drain");
145
+ assert.deepEqual(res.frames, ["initial", "one", "é", "three", "four"]);
146
+ assert.equal(client.pendingFrameBytes, 0);
147
+ assert.equal(client.backpressureTimer, undefined);
148
+ });
149
+
150
+ test("client queue and timer state can be used by another factory instance", (t) => {
151
+ const { delivery, client, res } = fixture(t, { writeResults: [false] });
152
+ delivery.writeSseFrame(client, "initial");
153
+ delivery.writeSseFrame(client, "queued");
154
+ createSseDelivery().flushSseClient(client);
155
+ assert.deepEqual(res.frames, ["initial", "queued"]);
156
+ assert.equal(client.pendingFrameBytes, 0);
157
+ assert.equal(client.backpressureTimer, undefined);
158
+ res.emit("drain");
159
+ assert.deepEqual(res.frames, ["initial", "queued"]);
160
+ });
161
+
162
+ test("256 pending frames fit and the next frame evicts with an ended response", (t) => {
163
+ const f = fixture(t, { writeResults: [false] });
164
+ const { delivery, client, res } = f;
165
+ delivery.writeSseFrame(client, "initial");
166
+ for (let i = 0; i < 256; i += 1) assert.equal(delivery.writeSseFrame(client, "x"), true);
167
+ assert.equal(client.pendingFrames.length, 256);
168
+ assert.equal(client.pendingFrameBytes, 256);
169
+ assert.equal(client.evicted, undefined);
170
+ assert.equal(delivery.writeSseFrame(client, "overflow"), false);
171
+ assertEvicted(f);
172
+ assert.equal(res.writableEnded, true);
173
+ res.emit("drain");
174
+ assert.deepEqual(res.frames, ["initial"]);
175
+ delivery.evictSlowSseClient(client);
176
+ assertEvicted(f);
177
+ });
178
+
179
+ test("4 MiB pending bytes fit and one additional UTF-8 byte evicts", (t) => {
180
+ const f = fixture(t, { writeResults: [false] });
181
+ const { delivery, client } = f;
182
+ delivery.writeSseFrame(client, "initial");
183
+ const frame = "é".repeat(2 * 1024 * 1024);
184
+ assert.equal(delivery.writeSseFrame(client, frame), true);
185
+ assert.equal(client.pendingFrames.length, 1);
186
+ assert.equal(client.pendingFrameBytes, 4 * 1024 * 1024);
187
+ assert.equal(client.evicted, undefined);
188
+ assert.equal(delivery.writeSseFrame(client, "x"), false);
189
+ assertEvicted(f);
190
+ });
191
+
192
+ test("a single pending frame over 4 MiB evicts before enqueueing", (t) => {
193
+ const f = fixture(t, { writeResults: [false] });
194
+ f.delivery.writeSseFrame(f.client, "initial");
195
+ assert.equal(f.delivery.writeSseFrame(f.client, "x".repeat(4 * 1024 * 1024 + 1)), false);
196
+ assertEvicted(f);
197
+ });
198
+
199
+ test("a stalled client is evicted at ten seconds without extending for queued frames", (t) => {
200
+ t.mock.timers.enable({ apis: ["setTimeout"] });
201
+ const f = fixture(t, { writeResults: [false] });
202
+ f.delivery.writeSseFrame(f.client, "initial");
203
+ t.mock.timers.tick(9_999);
204
+ assert.equal(f.client.evicted, undefined);
205
+ f.delivery.writeSseFrame(f.client, "queued");
206
+ t.mock.timers.tick(1);
207
+ assertEvicted(f);
208
+ assert.equal(f.res.writableEnded, true);
209
+ f.res.emit("drain");
210
+ assert.deepEqual(f.res.frames, ["initial"]);
211
+ });
212
+
213
+ test("scheduling replaces the old timeout and clearing cancels the replacement", (t) => {
214
+ t.mock.timers.enable({ apis: ["setTimeout"] });
215
+ const f = fixture(t);
216
+ f.delivery.scheduleSseBackpressureTimeout(f.client);
217
+ const firstTimer = f.client.backpressureTimer;
218
+ t.mock.timers.tick(5_000);
219
+ f.delivery.scheduleSseBackpressureTimeout(f.client);
220
+ assert.notEqual(f.client.backpressureTimer, firstTimer);
221
+ t.mock.timers.tick(5_000);
222
+ assert.equal(f.client.evicted, undefined);
223
+ f.delivery.clearSseBackpressureTimer(f.client);
224
+ assert.equal(f.client.backpressureTimer, undefined);
225
+ f.delivery.clearSseBackpressureTimer(f.client);
226
+ f.delivery.clearSseBackpressureTimer(undefined);
227
+ t.mock.timers.tick(10_000);
228
+ assert.equal(f.client.evicted, undefined);
229
+ });
230
+
231
+ test("successful drain cancels timeout eviction and preserves other clients", (t) => {
232
+ t.mock.timers.enable({ apis: ["setTimeout"] });
233
+ const f = fixture(t, { writeResults: [false] });
234
+ const peer = { res: new ResponseDouble(), tab: f.tab };
235
+ f.tab.sseClients.add(peer);
236
+ f.delivery.writeSseFrame(f.client, "initial");
237
+ f.delivery.writeSseFrame(f.client, "queued");
238
+ t.mock.timers.tick(9_999);
239
+ f.res.emit("drain");
240
+ t.mock.timers.tick(10_001);
241
+ assert.equal(f.client.evicted, undefined);
242
+ assert.equal(f.tab.sseClients.size, 2);
243
+ f.delivery.evictSlowSseClient(f.client);
244
+ assertEvicted(f);
245
+ assert.equal(f.tab.sseClients.has(peer), true);
246
+ assert.equal(peer.res.endCalls, 0);
247
+ });
248
+
249
+ test("write errors evict, discard queued frames and tolerate an end error", (t) => {
250
+ const f = fixture(t);
251
+ f.res.writeError = new Error("socket write failed");
252
+ f.res.endError = new Error("socket already closed");
253
+ assert.equal(f.delivery.writeSseFrame(f.client, "failed"), false);
254
+ assertEvicted(f);
255
+ assert.equal(f.delivery.writeSseFrame(f.client, "later"), false);
256
+ f.delivery.evictSlowSseClient(f.client);
257
+ assertEvicted(f);
258
+ });
259
+
260
+ test("flush write errors evict without writing remaining queued frames", (t) => {
261
+ const f = fixture(t, { writeResults: [false] });
262
+ for (const frame of ["initial", "failed", "never"]) f.delivery.writeSseFrame(f.client, frame);
263
+ f.res.writeError = new Error("flush failed");
264
+ f.res.emit("drain");
265
+ assertEvicted(f);
266
+ assert.deepEqual(f.res.frames, ["initial"]);
267
+ });
268
+
269
+ for (const closedState of ["destroyed", "writableEnded"]) {
270
+ test(`${closedState} responses reject writes and evict on flush`, (t) => {
271
+ const f = fixture(t, { writeResults: [false] });
272
+ f.delivery.writeSseFrame(f.client, "initial");
273
+ f.delivery.writeSseFrame(f.client, "queued");
274
+ f.res[closedState] = true;
275
+ assert.equal(f.delivery.writeSseFrame(f.client, "later"), false);
276
+ assert.equal(f.client.evicted, undefined);
277
+ f.res.emit("drain");
278
+ assertEvicted(f);
279
+ assert.deepEqual(f.res.frames, ["initial"]);
280
+ });
281
+ }
282
+
283
+ test("missing clients are harmless and missing responses evict on flush", (t) => {
284
+ const delivery = createSseDelivery();
285
+ assert.equal(delivery.writeSseFrame(undefined, "frame"), false);
286
+ delivery.flushSseClient(undefined);
287
+ delivery.evictSlowSseClient(undefined);
288
+ const f = fixture(t);
289
+ delete f.client.res;
290
+ f.delivery.flushSseClient(f.client);
291
+ assert.equal(f.client.evicted, true);
292
+ assert.equal(f.tab.sseClients.has(f.client), false);
293
+ });
294
+
295
+ test("compact mode uses the existing codec and suppressed events do not queue", (t) => {
296
+ const { delivery, client, res } = fixture(t, { activeMode: "compact-v1" });
297
+ const update = {
298
+ type: "message_update", tabId: "tab-a", message: { content: "partial" },
299
+ assistantMessageEvent: { type: "text_delta", delta: "hello", partial: { content: "partial" } },
300
+ };
301
+ assert.equal(delivery.sendSse(client, update), true);
302
+ assert.deepEqual(events(res.frames), [{
303
+ type: "message_update", tabId: "tab-a", assistantMessageEvent: { type: "text_delta", delta: "hello" },
304
+ }]);
305
+ assert.equal(delivery.sendSse(client, { type: "tool_execution_update", partialResult: "large" }), false);
306
+ assert.equal(res.frames.length, 1);
307
+ assert.equal(client.pendingFrames, undefined);
308
+ assert.equal(client.backpressureTimer, undefined);
309
+ });
310
+
311
+ test("mode activation uses the previous codec before changing client state", (t) => {
312
+ const { delivery, client, res } = fixture(t, { pendingMode: "compact-v1" });
313
+ const write = t.mock.method(res, "write", function (frame) {
314
+ assert.equal(client.activeMode, "normal");
315
+ assert.equal(client.pendingMode, "compact-v1");
316
+ return ResponseDouble.prototype.write.call(this, frame);
317
+ });
318
+ delivery.activateOutputMode(client, " compact-v1 ", "explicit-change");
319
+ assert.equal(write.mock.callCount(), 1);
320
+ assert.deepEqual(events(res.frames), [{
321
+ type: "webui_output_mode", protocolVersion: 1, previousMode: "normal",
322
+ activeMode: "compact-v1", reason: "explicit-change",
323
+ }]);
324
+ assert.equal(client.activeMode, "compact-v1");
325
+ assert.equal(client.pendingMode, undefined);
326
+ });
327
+
328
+ test("mode activation normalizes input and an unchanged mode only clears pending state", (t) => {
329
+ const { delivery, client, res } = fixture(t, { activeMode: "compact-v1", pendingMode: "normal" });
330
+ delivery.activateOutputMode(client, "compact-v1");
331
+ assert.equal(client.pendingMode, undefined);
332
+ assert.deepEqual(res.frames, []);
333
+ delivery.activateOutputMode(client, "invalid");
334
+ assert.deepEqual(events(res.frames), [{
335
+ type: "webui_output_mode", protocolVersion: 1, previousMode: "compact-v1",
336
+ activeMode: "normal", reason: "server-default-change",
337
+ }]);
338
+ assert.equal(client.activeMode, "normal");
339
+ });
340
+
341
+ test("pending mode waits for an accepted semantic barrier", (t) => {
342
+ const { delivery, client, res } = fixture(t, { pendingMode: "compact-v1" });
343
+ const update = { type: "message_update", message: { content: "snapshot" } };
344
+ assert.equal(delivery.sendSseToClient(client, update), true);
345
+ assert.equal(client.activeMode, "normal");
346
+ assert.equal(client.pendingMode, "compact-v1");
347
+ assert.equal(delivery.sendSseToClient(client, { type: "message_end" }), true);
348
+ assert.deepEqual(events(res.frames).map((event) => event.type), [
349
+ "message_update", "message_end", "webui_output_mode",
350
+ ]);
351
+ assert.equal(client.activeMode, "compact-v1");
352
+ assert.equal(client.pendingMode, undefined);
353
+ });
354
+
355
+ for (const type of [
356
+ "message_end", "tool_execution_end", "agent_end", "agent_settled", "compaction_end", "pi_process_exit", "pi_process_error",
357
+ ]) {
358
+ test(`${type} keeps barrier, mode notification and new-mode frames in queue order`, (t) => {
359
+ const { delivery, client, res } = fixture(t, { writeResults: [false], pendingMode: "compact-v1" });
360
+ const barrier = { type, tabId: "tab-a" };
361
+ assert.equal(delivery.sendSseToClient(client, barrier), true);
362
+ assert.equal(client.activeMode, "compact-v1", "write false still accepts the barrier");
363
+ assert.equal(client.pendingFrames.length, 1);
364
+ assert.equal(delivery.sendSseToClient(client, {
365
+ type: "message_update", message: { content: "snapshot" },
366
+ assistantMessageEvent: { type: "text_delta", delta: "next", partial: {} },
367
+ }), true);
368
+ assert.equal(res.frames.length, 1);
369
+ res.emit("drain");
370
+ assert.deepEqual(events(res.frames), [
371
+ barrier,
372
+ { type: "webui_output_mode", protocolVersion: 1, previousMode: "normal", activeMode: "compact-v1", reason: "server-default-change" },
373
+ { type: "message_update", assistantMessageEvent: { type: "text_delta", delta: "next" } },
374
+ ]);
375
+ });
376
+ }
377
+
378
+ test("a queued barrier activates the new mode behind earlier accepted frames", (t) => {
379
+ const { delivery, client, res } = fixture(t, { writeResults: [false], pendingMode: "compact-v1" });
380
+ delivery.sendSseToClient(client, { type: "message_start" });
381
+ assert.equal(delivery.sendSseToClient(client, { type: "agent_end" }), true);
382
+ assert.equal(client.activeMode, "compact-v1");
383
+ assert.equal(client.pendingFrames.length, 2);
384
+ res.emit("drain");
385
+ assert.deepEqual(events(res.frames).map((event) => event.type), [
386
+ "message_start", "agent_end", "webui_output_mode",
387
+ ]);
388
+ });
389
+
390
+ test("suppressed updates and rejected barriers do not activate pending mode", (t) => {
391
+ const f = fixture(t, { activeMode: "compact-v1", pendingMode: "normal" });
392
+ assert.equal(f.delivery.sendSseToClient(f.client, { type: "tool_execution_update" }), false);
393
+ assert.equal(f.client.pendingMode, "normal");
394
+ f.res.writeError = new Error("cannot accept barrier");
395
+ assert.equal(f.delivery.sendSseToClient(f.client, { type: "agent_end" }), false);
396
+ assert.equal(f.client.activeMode, "compact-v1");
397
+ assert.equal(f.client.pendingMode, "normal");
398
+ assert.deepEqual(f.res.frames, []);
399
+ assertEvicted(f);
400
+ });
401
+
402
+ test("queue overflow rejects the barrier without activating pending mode", (t) => {
403
+ const f = fixture(t, { writeResults: [false], pendingMode: "compact-v1" });
404
+ f.delivery.writeSseFrame(f.client, "initial");
405
+ for (let i = 0; i < 256; i += 1) f.delivery.writeSseFrame(f.client, "queued");
406
+ assert.equal(f.delivery.sendSseToClient(f.client, { type: "agent_end" }), false);
407
+ assert.equal(f.client.activeMode, "normal");
408
+ assert.equal(f.client.pendingMode, "compact-v1");
409
+ assertEvicted(f);
410
+ });