@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,553 @@
1
+ import assert from "node:assert/strict";
2
+ import { spawnSync } from "node:child_process";
3
+ import { mkdtemp, rm, writeFile } from "node:fs/promises";
4
+ import { tmpdir } from "node:os";
5
+ import path from "node:path";
6
+ import { PassThrough } from "node:stream";
7
+ import { setTimeout as delay } from "node:timers/promises";
8
+ import test from "node:test";
9
+ import { PI_RPC_JSONL_LINE_MAX_BYTES } from "../lib/rpc-supervisor-protocol.mjs";
10
+ import { createRpcTransportTypes } from "../lib/server/rpc-transports.mjs";
11
+
12
+ const moduleUrl = new URL("../lib/server/rpc-transports.mjs", import.meta.url).href;
13
+ const defaults = {
14
+ assertNativeRpcAdmission: async () => {},
15
+ sanitizeError: (error) => error.message || String(error),
16
+ requestTimeoutMs: 1_000,
17
+ supervisorCommandTimeoutMaxMs: 5_000,
18
+ };
19
+ const types = (options = {}) => createRpcTransportTypes({ ...defaults, ...options });
20
+
21
+ function deferred() {
22
+ let resolve;
23
+ let reject;
24
+ const promise = new Promise((yes, no) => { resolve = yes; reject = no; });
25
+ return { promise, resolve, reject };
26
+ }
27
+
28
+ async function waitFor(probe, description, timeoutMs = 3_000) {
29
+ const deadline = Date.now() + timeoutMs;
30
+ do {
31
+ const result = probe();
32
+ if (result) return result;
33
+ await delay(5);
34
+ } while (Date.now() < deadline);
35
+ assert.fail(`Timed out waiting for ${description}`);
36
+ }
37
+
38
+ async function temporaryRoot(t) {
39
+ const root = await mkdtemp(path.join(tmpdir(), "webui-rpc-transports-"));
40
+ t.after(() => rm(root, { recursive: true, force: true }));
41
+ return root;
42
+ }
43
+
44
+ async function runProbe(t, source) {
45
+ const root = await temporaryRoot(t);
46
+ const file = path.join(root, "probe.mjs");
47
+ await writeFile(file, source);
48
+ const result = spawnSync(process.execPath, [file], {
49
+ cwd: root, env: {}, encoding: "utf8", timeout: 10_000, maxBuffer: 64 * 1024,
50
+ });
51
+ assert.equal(result.error, undefined, String(result.error));
52
+ assert.equal(result.status, 0, result.stderr || `Probe ended with ${result.signal}`);
53
+ return result.stdout;
54
+ }
55
+
56
+ const childSource = `
57
+ import { createInterface } from "node:readline";
58
+ const output = (event) => process.stdout.write(JSON.stringify(event) + "\\n");
59
+ const input = createInterface({ input: process.stdin });
60
+ input.on("line", (line) => {
61
+ const command = JSON.parse(line);
62
+ output({ type: "observed", command });
63
+ if (command.type === "hold" || command.type === "raw") return;
64
+ if (command.type === "exit") return process.exit(7);
65
+ if (command.type === "malformed") {
66
+ process.stdout.write("not-json\\n\\r\\n");
67
+ }
68
+ if (command.type === "utf8") {
69
+ const bytes = Buffer.from(JSON.stringify({ type: "unicode", text: "🐈 café" }) + "\\r\\n");
70
+ const split = bytes.indexOf(Buffer.from("🐈")) + 2;
71
+ process.stdout.write(bytes.subarray(0, split));
72
+ setImmediate(() => {
73
+ process.stdout.write(bytes.subarray(split));
74
+ output({ type: "response", id: command.id, success: true });
75
+ });
76
+ return;
77
+ }
78
+ output({ type: "response", id: command.id, success: true, data: command });
79
+ });
80
+ `;
81
+
82
+ async function directFixture(t, options = {}) {
83
+ const root = await mkdtemp(path.join(tmpdir(), "webui-rpc-transports-"));
84
+ let rpc;
85
+ let closed;
86
+ t.after(async () => {
87
+ try {
88
+ if (rpc?.child?.exitCode === null && rpc.child.signalCode === null) rpc.child.kill("SIGKILL");
89
+ if (closed) {
90
+ await Promise.race([
91
+ closed,
92
+ delay(3_000, null, { ref: false }).then(() => assert.fail("Fixture child did not close")),
93
+ ]);
94
+ }
95
+ } finally {
96
+ await rm(root, { recursive: true, force: true });
97
+ }
98
+ });
99
+ const file = path.join(root, "rpc-child.mjs");
100
+ await writeFile(file, childSource);
101
+ const { PiRpcProcess } = types(options);
102
+ rpc = new PiRpcProcess({
103
+ command: process.execPath, args: [file], displayCommand: "fixture RPC", cwd: root, env: {},
104
+ });
105
+ const events = [];
106
+ rpc.onEvent((event) => events.push(event));
107
+ const startup = rpc.start();
108
+ closed = new Promise((resolve) => rpc.child.once("close", resolve));
109
+ await startup;
110
+ return { rpc, events, root, closed };
111
+ }
112
+
113
+ function supervisedFixture(options = {}, methods = {}) {
114
+ const calls = [];
115
+ const supervisor = {
116
+ command: async (...args) => { calls.push(["command", ...args]); return { success: true }; },
117
+ write: async (...args) => { calls.push(["write", ...args]); },
118
+ replaceTab: async (...args) => { calls.push(["replace", ...args]); return { pid: 42 }; },
119
+ replaceTabUnderUpdate: async (...args) => { calls.push(["replaceUpdate", ...args]); return { pid: 43 }; },
120
+ updateTab: async (...args) => { calls.push(["update", ...args]); },
121
+ closeTab: async (...args) => { calls.push(["close", ...args]); return "closed"; },
122
+ ...methods,
123
+ };
124
+ const { SupervisorPiRpcProcess } = types(options);
125
+ const rpc = new SupervisorPiRpcProcess({ supervisor, tabId: "tab-1", cwd: "/fixture" });
126
+ const events = [];
127
+ rpc.onEvent((event) => events.push(event));
128
+ return { rpc, events, supervisor, calls };
129
+ }
130
+
131
+ test("import and factory creation have no process, timer, stderr or admission effects", { timeout: 15_000 }, async (t) => {
132
+ const output = await runProbe(t, `
133
+ import assert from "node:assert/strict";
134
+ import childProcess from "node:child_process";
135
+ import { syncBuiltinESMExports } from "node:module";
136
+ const fail = () => { throw new Error("Unexpected effect"); };
137
+ childProcess.spawn = fail;
138
+ syncBuiltinESMExports();
139
+ globalThis.setTimeout = fail;
140
+ globalThis.setInterval = fail;
141
+ const listeners = process.stderr.listenerCount("error");
142
+ const { createRpcTransportTypes } = await import(${JSON.stringify(moduleUrl)});
143
+ const pair = createRpcTransportTypes({
144
+ assertNativeRpcAdmission: fail, sanitizeError: fail,
145
+ requestTimeoutMs: 50, supervisorCommandTimeoutMaxMs: 100,
146
+ });
147
+ assert.deepEqual(Object.keys(pair).sort(), ["PiRpcProcess", "SupervisorPiRpcProcess"]);
148
+ assert.equal(pair.PiRpcProcess, pair.PiRpcProcess);
149
+ assert.equal(pair.SupervisorPiRpcProcess, pair.SupervisorPiRpcProcess);
150
+ assert.equal(process.stderr.listenerCount("error"), listeners);
151
+ const direct = new pair.PiRpcProcess({ command: "unused", args: [], cwd: "/fixture" });
152
+ const supervised = new pair.SupervisorPiRpcProcess({ supervisor: {}, tabId: "unused" });
153
+ assert.ok(direct instanceof pair.PiRpcProcess);
154
+ assert.ok(supervised instanceof pair.SupervisorPiRpcProcess);
155
+ assert.equal(direct.child, undefined);
156
+ assert.equal(direct.isRunning(), false);
157
+ assert.equal(process.stderr.listenerCount("error"), listeners);
158
+ process.stdout.write("no effects");
159
+ `);
160
+ assert.equal(output, "no effects");
161
+ });
162
+
163
+ test("direct process preserves startup, request identity, response events and one-way raw writes", { timeout: 10_000 }, async (t) => {
164
+ const { rpc, events, root, closed } = await directFixture(t);
165
+ assert.equal(rpc.isRunning(), true);
166
+ assert.deepEqual(events[0], {
167
+ type: "pi_process_start", pid: rpc.child.pid, cwd: root,
168
+ command: "fixture RPC", args: rpc.args,
169
+ });
170
+ const command = { type: "echo", id: "caller-id", data: "value" };
171
+ const response = await rpc.send(command);
172
+ assert.equal(response.id, command.id);
173
+ assert.deepEqual(response.data, command);
174
+ assert.equal(events.find((event) => event.type === "response"), response);
175
+ assert.equal(rpc.pending.size, 0);
176
+ const generated = await rpc.send({ type: "echo" });
177
+ assert.match(generated.id, /^[0-9a-f-]{36}$/);
178
+
179
+ await rpc.writeRaw({ type: "raw", id: "raw-id", value: "unanswered" });
180
+ const raw = await waitFor(() => events.find((event) => event.command?.id === "raw-id"), "raw write");
181
+ assert.deepEqual(raw.command, { type: "raw", id: "raw-id", value: "unanswered" });
182
+ assert.equal(rpc.pending.size, 0);
183
+ assert.equal(events.some((event) => event.type === "response" && event.id === "raw-id"), false);
184
+ let unsubscribedCalls = 0;
185
+ const unsubscribe = rpc.onEvent(() => { unsubscribedCalls += 1; });
186
+ unsubscribe();
187
+ rpc.stop();
188
+ await closed;
189
+ assert.equal(unsubscribedCalls, 0);
190
+ assert.equal(rpc.isRunning(), false);
191
+ assert.ok(events.some((event) => event.type === "pi_process_exit"));
192
+ await assert.rejects(rpc.send({ type: "echo" }), /not running/);
193
+ await assert.rejects(rpc.writeRaw({ type: "raw" }), /not running/);
194
+ });
195
+
196
+ test("direct admission completes before bytes are written and refusal cleans pending requests", { timeout: 10_000 }, async (t) => {
197
+ const gate = deferred();
198
+ const admitted = [];
199
+ const { rpc, events } = await directFixture(t, {
200
+ assertNativeRpcAdmission: async (command) => {
201
+ admitted.push(command);
202
+ if (command.type === "denied") throw new Error("admission fenced");
203
+ await gate.promise;
204
+ },
205
+ });
206
+ const pending = rpc.send({ type: "echo", id: "gated" });
207
+ const raw = rpc.writeRaw({ type: "raw", id: "gated-raw" });
208
+ assert.deepEqual(admitted.map((command) => command.id), ["gated", "gated-raw"]);
209
+ assert.equal(rpc.pending.size, 1);
210
+ assert.equal(events.some((event) => event.type === "observed"), false);
211
+ gate.resolve();
212
+ await Promise.all([pending, raw]);
213
+ await waitFor(() => events.some((event) => event.command?.id === "gated-raw"), "admitted raw write");
214
+ await assert.rejects(rpc.send({ type: "denied", id: "refused" }), /admission fenced/);
215
+ await assert.rejects(rpc.writeRaw({ type: "denied", id: "refused-raw" }), /admission fenced/);
216
+ assert.equal(rpc.pending.size, 0);
217
+ assert.equal(events.some((event) => event.command?.type === "denied"), false);
218
+ });
219
+
220
+ test("direct timeouts, serialization errors and process exit reject and clear the pending map", { timeout: 10_000 }, async (t) => {
221
+ const { rpc, events, closed } = await directFixture(t, { requestTimeoutMs: 40 });
222
+ await assert.rejects(rpc.send({ type: "hold", id: "timeout" }), /Timed out waiting for RPC response to hold/);
223
+ assert.equal(rpc.pending.size, 0);
224
+ rpc.handleStdoutLine(JSON.stringify({ type: "response", id: "timeout", success: true }));
225
+ assert.ok(events.some((event) => event.type === "response" && event.id === "timeout"));
226
+ const circular = { type: "circular" };
227
+ circular.self = circular;
228
+ await assert.rejects(rpc.send(circular), /circular/i);
229
+ assert.equal(rpc.pending.size, 0);
230
+ const held = rpc.send({ type: "hold", id: "exit-pending" }, 3_000);
231
+ const exiting = rpc.send({ type: "exit", id: "exit-trigger" }, 3_000);
232
+ await Promise.all([
233
+ assert.rejects(held, /Pi RPC process exited with code 7/),
234
+ assert.rejects(exiting, /Pi RPC process exited with code 7/),
235
+ ]);
236
+ await closed;
237
+ assert.equal(rpc.pending.size, 0);
238
+ assert.equal(rpc.isRunning(), false);
239
+ });
240
+
241
+ test("direct spawn failure emits the sanitized error and never becomes running", { timeout: 5_000 }, async (t) => {
242
+ const root = await temporaryRoot(t);
243
+ const { PiRpcProcess } = types({ sanitizeError: (error) => `sanitized:${error.code}` });
244
+ const rpc = new PiRpcProcess({ command: path.join(root, "missing-node"), args: [], cwd: root, env: {} });
245
+ const events = [];
246
+ rpc.onEvent((event) => events.push(event));
247
+ const startup = rpc.start();
248
+ const closed = new Promise((resolve) => rpc.child.once("close", resolve));
249
+ await assert.rejects(startup, /sanitized:ENOENT/);
250
+ await closed;
251
+ assert.deepEqual(events, [{ type: "pi_process_error", error: "sanitized:ENOENT" }]);
252
+ assert.equal(rpc.isRunning(), false);
253
+ assert.equal(rpc.pending.size, 0);
254
+ });
255
+
256
+ test("direct child JSONL handles malformed records and UTF-8 across writes", { timeout: 10_000 }, async (t) => {
257
+ const { rpc, events } = await directFixture(t);
258
+ await rpc.send({ type: "malformed" });
259
+ assert.equal(events.filter((event) => event.type === "pi_stdout_parse_error").length, 1);
260
+ assert.equal(events.find((event) => event.type === "pi_stdout_parse_error").line, "not-json");
261
+ await rpc.send({ type: "utf8" });
262
+ assert.deepEqual(events.find((event) => event.type === "unicode"), { type: "unicode", text: "🐈 café" });
263
+ });
264
+
265
+ test("readers preserve split UTF-8, CRLF, unterminated records and decoder tails", () => {
266
+ const { PiRpcProcess } = types();
267
+ const rpc = new PiRpcProcess({ command: "unused", args: [] });
268
+ const jsonl = new PassThrough();
269
+ const lines = [];
270
+ rpc.attachJsonlReader(jsonl, (line) => lines.push(line));
271
+ const bytes = Buffer.from(' \r\n{"text":"🐈 café"}\r\nlast\r');
272
+ for (const byte of bytes) jsonl.write(Buffer.from([byte]));
273
+ jsonl.emit("end");
274
+ assert.deepEqual(lines, [" ", '{"text":"🐈 café"}', "last"]);
275
+ const text = new PassThrough();
276
+ const chunks = [];
277
+ rpc.attachTextReader(text, (chunk) => chunks.push(chunk));
278
+ for (const byte of Buffer.from("🐈 café")) text.write(Buffer.from([byte]));
279
+ text.write(Buffer.from([0xe2]));
280
+ text.emit("end");
281
+ assert.equal(chunks.join(""), "🐈 café�");
282
+ });
283
+
284
+ test("JSONL bounds count UTF-8 bytes and recover once after each oversized line", () => {
285
+ const { PiRpcProcess } = types();
286
+ const rpc = new PiRpcProcess({ command: "unused", args: [] });
287
+ const stream = new PassThrough();
288
+ const events = [];
289
+ const lines = [];
290
+ rpc.onEvent((event) => events.push(event));
291
+ rpc.attachJsonlReader(stream, (line) => lines.push(line));
292
+ assert.equal(PI_RPC_JSONL_LINE_MAX_BYTES, 32 * 1024 * 1024);
293
+ const megabyte = "a".repeat(1024 * 1024);
294
+ for (let i = 0; i < 32; i += 1) stream.write(megabyte);
295
+ stream.write("\n");
296
+ assert.equal(Buffer.byteLength(lines[0]), PI_RPC_JSONL_LINE_MAX_BYTES);
297
+ lines.length = 0;
298
+ for (let i = 0; i < 32; i += 1) stream.write(megabyte);
299
+ stream.write("é");
300
+ stream.write("discarded remainder");
301
+ assert.equal(events.length, 1);
302
+ stream.write("\nrecovered\r\n");
303
+ stream.write("é".repeat(PI_RPC_JSONL_LINE_MAX_BYTES / 2) + "a\nnext\n");
304
+ assert.equal(events.length, 2);
305
+ assert.deepEqual(lines, ["recovered", "next"]);
306
+ for (const event of events) {
307
+ assert.deepEqual(event, {
308
+ type: "pi_stdout_line_too_large",
309
+ error: `Discarded a Pi RPC JSONL line larger than ${PI_RPC_JSONL_LINE_MAX_BYTES} bytes`,
310
+ maxBytes: PI_RPC_JSONL_LINE_MAX_BYTES,
311
+ });
312
+ }
313
+ for (let i = 0; i < 32; i += 1) stream.write(megabyte);
314
+ stream.write("a");
315
+ stream.emit("end");
316
+ assert.equal(events.length, 3);
317
+ assert.deepEqual(lines, ["recovered", "next"]);
318
+ });
319
+
320
+ test("direct raw backpressure waits for drain without creating a response waiter", async () => {
321
+ const { PiRpcProcess } = types();
322
+ const rpc = new PiRpcProcess({ command: "unused", args: [] });
323
+ const stdin = new PassThrough();
324
+ const writes = [];
325
+ stdin.write = (line) => { writes.push(line); return false; };
326
+ rpc.spawned = true;
327
+ rpc.child = { stdin, exitCode: null, killed: false };
328
+ let finished = false;
329
+ const raw = rpc.writeRaw({ type: "raw", id: "unchanged" }).then(() => { finished = true; });
330
+ await waitFor(() => writes.length, "backpressured write");
331
+ assert.equal(finished, false);
332
+ assert.deepEqual(writes, ['{"type":"raw","id":"unchanged"}\n']);
333
+ assert.equal(rpc.pending.size, 0);
334
+ stdin.emit("drain");
335
+ await raw;
336
+ assert.equal(finished, true);
337
+ assert.equal(stdin.listenerCount("drain"), 0);
338
+ });
339
+
340
+ test("supervised admission serializes dispatch but never holds a barrier for an RPC response", { timeout: 5_000 }, async () => {
341
+ const gate = deferred();
342
+ const response = deferred();
343
+ const order = [];
344
+ const { rpc, calls } = supervisedFixture({
345
+ assertNativeRpcAdmission: async (command) => {
346
+ order.push(`admit:${command.type}`);
347
+ if (command.type === "prompt") await gate.promise;
348
+ },
349
+ }, {
350
+ command: (tabId, command, options) => {
351
+ calls.push(["command", tabId, command, options]);
352
+ order.push("dispatch:prompt");
353
+ return response.promise;
354
+ },
355
+ write: async (tabId, command) => {
356
+ calls.push(["write", tabId, command]);
357
+ order.push("dispatch:raw");
358
+ response.resolve({ type: "response", id: "prompt-id" });
359
+ },
360
+ });
361
+ const command = { type: "prompt", id: "prompt-id" };
362
+ const pending = rpc.send(command);
363
+ const raw = rpc.writeRaw({ type: "extension_ui_response", id: "approval-id" });
364
+ await waitFor(() => order.length, "first admission");
365
+ assert.deepEqual(order, ["admit:prompt"]);
366
+ assert.deepEqual(calls, []);
367
+ gate.resolve();
368
+ await raw;
369
+ assert.deepEqual(await pending, { type: "response", id: "prompt-id" });
370
+ assert.deepEqual(order, ["admit:prompt", "dispatch:prompt", "admit:extension_ui_response", "dispatch:raw"]);
371
+ assert.equal(calls[0][2], command);
372
+ assert.deepEqual(calls[0][3], { requestId: "prompt-id", timeoutMs: 1_000 });
373
+ assert.deepEqual(calls[1], ["write", "tab-1", { type: "extension_ui_response", id: "approval-id" }]);
374
+ });
375
+
376
+ test("supervised timeout bounds, generated IDs and admission or dispatch failures preserve later dispatch", { timeout: 5_000 }, async () => {
377
+ const { rpc, calls } = supervisedFixture({
378
+ assertNativeRpcAdmission: async (command) => {
379
+ if (command.type === "denied") throw new Error("admission fenced");
380
+ },
381
+ });
382
+ for (const [input, expected] of [[undefined, 1_000], [0, 1_000], [-5, 1], [9_000, 5_000], [Infinity, 5_000], ["12", 12], ["bad", 1_000]]) {
383
+ await rpc.send({ type: "echo" }, input);
384
+ const options = calls.at(-1)[3];
385
+ assert.match(options.requestId, /^[0-9a-f-]{36}$/);
386
+ assert.equal(options.timeoutMs, expected);
387
+ assert.equal(calls.at(-1)[2].id, undefined);
388
+ }
389
+ const count = calls.length;
390
+ await assert.rejects(rpc.send({ type: "denied" }), /admission fenced/);
391
+ await assert.rejects(rpc.writeRaw({ type: "denied" }), /admission fenced/);
392
+ assert.equal(calls.length, count);
393
+ rpc.supervisor.command = () => { throw new Error("sync dispatch failure"); };
394
+ await assert.rejects(rpc.send({ type: "echo" }), /sync dispatch failure/);
395
+ rpc.supervisor.command = () => Promise.reject(new Error("async response failure"));
396
+ await assert.rejects(rpc.send({ type: "echo" }), /async response failure/);
397
+ await rpc.writeRaw({ type: "raw" });
398
+ assert.equal(calls.at(-1)[0], "write");
399
+ });
400
+
401
+ test("supervised snapshots, events and dispose retain wrapper ownership without stopping the host", async () => {
402
+ const { rpc, events, calls } = supervisedFixture();
403
+ assert.equal(rpc.isRunning(), true);
404
+ const startedAt = rpc.startedAt;
405
+ rpc.applySnapshot({ pid: 12, metadata: { cwd: "/next" }, running: false });
406
+ assert.equal(rpc.startedAt, startedAt);
407
+ assert.equal(rpc.cwd, "/next");
408
+ assert.deepEqual(rpc.child, { pid: 12, exitCode: 1, signalCode: null, killed: true });
409
+ rpc.receiveSupervisorEvent({ payload: { type: "pi_process_error", error: "offline" }, scopeId: "scope", epoch: "epoch", seq: "1" });
410
+ assert.equal(rpc.isRunning(), false);
411
+ rpc.receiveSupervisorEvent({ payload: { type: "pi_process_start", pid: 13 }, at: "fixture-time", scopeId: "scope", epoch: "epoch", seq: "2" });
412
+ assert.equal(rpc.isRunning(), true);
413
+ assert.equal(rpc.startedAt, "fixture-time");
414
+ rpc.receiveSupervisorEvent({ payload: { type: "pi_process_error", error: "diagnostic" } });
415
+ assert.equal(rpc.isRunning(), true);
416
+ rpc.receiveSupervisorEvent({ payload: { type: "pi_process_exit", code: 0, signal: null }, scopeId: "scope", epoch: "epoch", seq: "3" });
417
+ assert.deepEqual(rpc.child, { pid: 13, exitCode: 0, signalCode: null, killed: true });
418
+ assert.deepEqual(events.at(-1), {
419
+ type: "pi_process_exit", code: 0, signal: null,
420
+ supervisorScopeId: "scope", supervisorEpoch: "epoch", supervisorSeq: "3",
421
+ });
422
+ const count = events.length;
423
+ rpc.receiveSupervisorEvent({});
424
+ rpc.receiveSupervisorEvent({ payload: "invalid" });
425
+ assert.equal(events.length, count);
426
+ rpc.dispose();
427
+ assert.equal(rpc.listeners.size, 0);
428
+ assert.deepEqual(calls, []);
429
+ assert.equal(await rpc.stop(), "closed");
430
+ assert.deepEqual(calls, [["close", "tab-1"]]);
431
+ });
432
+
433
+ test("supervised replacements share dispatch ordering and apply only successful snapshots", { timeout: 5_000 }, async () => {
434
+ const gate = deferred();
435
+ const { rpc, calls } = supervisedFixture({ assertNativeRpcAdmission: () => gate.promise });
436
+ const raw = rpc.writeRaw({ type: "raw" });
437
+ const request = { child: { command: "fixture" }, metadata: { cwd: "/replacement" }, displayCommand: "new command" };
438
+ const replacing = rpc.replace(request);
439
+ await Promise.resolve();
440
+ assert.deepEqual(calls, []);
441
+ gate.resolve();
442
+ await raw;
443
+ const snapshot = await replacing;
444
+ assert.deepEqual(snapshot, { pid: 42 });
445
+ assert.deepEqual(calls, [
446
+ ["write", "tab-1", { type: "raw" }],
447
+ ["replace", { tabId: "tab-1", child: request.child, metadata: request.metadata }],
448
+ ]);
449
+ assert.equal(rpc.child.pid, 42);
450
+ assert.equal(rpc.displayCommand, "new command");
451
+ const restart = { owner: "update-job" };
452
+ await rpc.replace({ ...request, restart });
453
+ assert.equal(rpc.child.pid, 43);
454
+ assert.deepEqual(calls.at(-1), ["replaceUpdate", { tabId: "tab-1", child: request.child, metadata: request.metadata, restart }]);
455
+ rpc.supervisor.replaceTab = async () => { throw new Error("replace failed"); };
456
+ await assert.rejects(rpc.replace({ ...request, displayCommand: "failed" }), /replace failed/);
457
+ assert.equal(rpc.child.pid, 43);
458
+ assert.equal(rpc.displayCommand, "new command");
459
+ await rpc.writeRaw({ type: "after-replace-failure" });
460
+ });
461
+
462
+ test("supervised metadata updates serialize independently and recover after rejection", { timeout: 5_000 }, async () => {
463
+ const first = deferred();
464
+ const { rpc, calls } = supervisedFixture({}, {
465
+ updateTab: (tabId, metadata) => {
466
+ calls.push(["update", tabId, metadata]);
467
+ return metadata.revision === 1 ? first.promise : Promise.resolve(metadata);
468
+ },
469
+ });
470
+ const pending = rpc.updateMetadata({ revision: 1 });
471
+ const rejected = assert.rejects(pending, /metadata failure/);
472
+ const next = rpc.updateMetadata({ revision: 2 });
473
+ await waitFor(() => calls.length, "first metadata update");
474
+ assert.equal(calls.length, 1);
475
+ await rpc.writeRaw({ type: "raw" });
476
+ assert.equal(calls.at(-1)[0], "write");
477
+ first.reject(new Error("metadata failure"));
478
+ await rejected;
479
+ assert.deepEqual(await next, { revision: 2 });
480
+ assert.deepEqual(calls.filter(([method]) => method === "update"), [
481
+ ["update", "tab-1", { revision: 1 }], ["update", "tab-1", { revision: 2 }],
482
+ ]);
483
+ });
484
+
485
+ test("stderr mirroring shares one sink handler and reports callback, throw, event and unwritable failures", { timeout: 15_000 }, async (t) => {
486
+ await runProbe(t, `
487
+ import assert from "node:assert/strict";
488
+ import { EventEmitter } from "node:events";
489
+ import { createRpcTransportTypes } from ${JSON.stringify(moduleUrl)};
490
+ const { PiRpcProcess, SupervisorPiRpcProcess } = createRpcTransportTypes({
491
+ assertNativeRpcAdmission: async () => {}, sanitizeError: (error) => error.message,
492
+ requestTimeoutMs: 1000, supervisorCommandTimeoutMaxMs: 5000,
493
+ });
494
+ const sink = new EventEmitter();
495
+ Object.assign(sink, { writable: true, destroyed: false, writableEnded: false });
496
+ Object.defineProperty(process, "stderr", { configurable: true, value: sink });
497
+ const callbacks = [];
498
+ const order = [];
499
+ sink.write = (text, callback) => { order.push("mirror"); callbacks.push(callback); return true; };
500
+ const make = () => {
501
+ const rpc = new SupervisorPiRpcProcess({ supervisor: {}, tabId: "fixture" });
502
+ const events = [];
503
+ rpc.onEvent((event) => { order.push(event.type); events.push(event); });
504
+ return { rpc, events };
505
+ };
506
+ const a = make();
507
+ const b = make();
508
+ const event = { payload: { type: "pi_stderr", text: "diagnostic" } };
509
+ a.rpc.receiveSupervisorEvent(event);
510
+ b.rpc.receiveSupervisorEvent(event);
511
+ assert.deepEqual(order, ["pi_stderr", "mirror", "pi_stderr", "mirror"]);
512
+ assert.equal(sink.listenerCount("error"), 1);
513
+ sink.emit("error", new Error("sink event failure"));
514
+ for (const target of [a, b]) {
515
+ assert.equal(target.events.length, 2);
516
+ assert.equal(target.events[1].type, "pi_stderr_sink_error");
517
+ assert.match(target.events[1].error, /sink event failure/);
518
+ }
519
+ for (const callback of callbacks.splice(0)) callback(new Error("duplicate callback failure"));
520
+ assert.equal(a.events.length, 2);
521
+ a.rpc.receiveSupervisorEvent(event);
522
+ callbacks.shift()();
523
+ sink.emit("error", new Error("after successful callback"));
524
+ assert.equal(a.events.length, 3);
525
+ sink.write = (text, callback) => callback(new Error("callback failure"));
526
+ a.rpc.receiveSupervisorEvent(event);
527
+ assert.match(a.events.at(-1).error, /callback failure/);
528
+ sink.write = () => { throw new Error("thrown failure"); };
529
+ a.rpc.receiveSupervisorEvent(event);
530
+ assert.match(a.events.at(-1).error, /thrown failure/);
531
+ sink.writable = false;
532
+ a.rpc.receiveSupervisorEvent(event);
533
+ assert.match(a.events.at(-1).error, /sink is not writable/);
534
+
535
+ const direct = new PiRpcProcess({
536
+ command: process.execPath,
537
+ args: ["--input-type=module", "-e", 'process.stderr.write("fixture diagnostic");'],
538
+ cwd: ${JSON.stringify(tmpdir())}, env: {},
539
+ });
540
+ const directEvents = [];
541
+ direct.onEvent((event) => directEvents.push(event));
542
+ const startup = direct.start();
543
+ const closed = new Promise((resolve) => direct.child.once("close", resolve));
544
+ await startup;
545
+ await closed;
546
+ const stderrIndex = directEvents.findIndex((event) => event.type === "pi_stderr");
547
+ const failureIndex = directEvents.findIndex((event) => event.type === "pi_stderr_sink_error");
548
+ assert.ok(stderrIndex >= 0 && failureIndex > stderrIndex);
549
+ direct.reportStderrMirrorFailure(new Error("second failure"));
550
+ assert.equal(directEvents.filter((event) => event.type === "pi_stderr_sink_error").length, 1);
551
+ assert.equal(direct.pending.size, 0);
552
+ `);
553
+ });