@firstpick/pi-package-webui 0.11.1 → 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 (309) 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 +320 -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/activity-intercom-controller.spec.mjs +457 -0
  93. package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
  94. package/tests/browser/activity-owner-integration.spec.mjs +201 -0
  95. package/tests/browser/activity-queue-controller.spec.mjs +405 -0
  96. package/tests/browser/activity-section-picker.spec.mjs +294 -0
  97. package/tests/browser/activity-todo-view.spec.mjs +60 -0
  98. package/tests/browser/activity-usage-controller.spec.mjs +416 -0
  99. package/tests/browser/compact-layout-integration.spec.mjs +58 -0
  100. package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
  101. package/tests/browser/composer-disclosure.spec.mjs +389 -0
  102. package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
  103. package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
  104. package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
  105. package/tests/browser/control-visibility.spec.mjs +5 -0
  106. package/tests/browser/controls-layout.spec.mjs +21 -2
  107. package/tests/browser/conversation-overview.spec.mjs +251 -0
  108. package/tests/browser/draft-conversations.spec.mjs +276 -0
  109. package/tests/browser/empty-startup-fixture.mjs +135 -0
  110. package/tests/browser/empty-startup.spec.mjs +282 -0
  111. package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
  112. package/tests/browser/focused-composer-more.spec.mjs +127 -0
  113. package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
  114. package/tests/browser/focused-navigation-fixture.mjs +32 -0
  115. package/tests/browser/focused-project-activity.spec.mjs +111 -0
  116. package/tests/browser/focused-shell-integration.spec.mjs +208 -0
  117. package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
  118. package/tests/browser/folder-picker-layout.spec.mjs +302 -0
  119. package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
  120. package/tests/browser/git-setup-cancel.spec.mjs +251 -0
  121. package/tests/browser/guided-git-fallback.spec.mjs +40 -21
  122. package/tests/browser/inspector-header.spec.mjs +221 -0
  123. package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
  124. package/tests/browser/inspector-resize.spec.mjs +227 -0
  125. package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
  126. package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
  127. package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
  128. package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
  129. package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
  130. package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
  131. package/tests/browser/interaction-continuity.spec.mjs +50 -26
  132. package/tests/browser/interaction-model-picker.spec.mjs +86 -0
  133. package/tests/browser/last-terminal-close.spec.mjs +280 -0
  134. package/tests/browser/mobile-foundation.spec.mjs +172 -20
  135. package/tests/browser/model-catalog-groups.spec.mjs +104 -0
  136. package/tests/browser/more-row-menus.spec.mjs +258 -0
  137. package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
  138. package/tests/browser/no-project-conversation.spec.mjs +113 -0
  139. package/tests/browser/optimistic-prompt.spec.mjs +3 -0
  140. package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
  141. package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
  142. package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
  143. package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
  144. package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
  145. package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
  146. package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
  147. package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
  148. package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
  149. package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
  150. package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
  151. package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
  152. package/tests/browser/project-artifact-controller.spec.mjs +324 -0
  153. package/tests/browser/project-artifact-integration.spec.mjs +103 -0
  154. package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
  155. package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
  156. package/tests/browser/session-fixture.mjs +118 -0
  157. package/tests/browser/session-ownership.spec.mjs +175 -0
  158. package/tests/browser/session-shelves-integration.spec.mjs +219 -0
  159. package/tests/browser/session-shelves.spec.mjs +340 -0
  160. package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
  161. package/tests/browser/session-summary.spec.mjs +17 -12
  162. package/tests/browser/settings-complete-home.spec.mjs +463 -0
  163. package/tests/browser/settings-entrypoint.spec.mjs +104 -0
  164. package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
  165. package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
  166. package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
  167. package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
  168. package/tests/browser/shell-ownership.spec.mjs +398 -0
  169. package/tests/browser/shell-rollout-fixture.mjs +259 -0
  170. package/tests/browser/shell-rollout.spec.mjs +357 -0
  171. package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
  172. package/tests/browser/shell-workspace.spec.mjs +433 -0
  173. package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
  174. package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
  175. package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
  176. package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
  177. package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
  178. package/tests/browser/stream-output-isolation.spec.mjs +6 -3
  179. package/tests/browser/themed-selects.spec.mjs +297 -0
  180. package/tests/browser/thread-start-flow.spec.mjs +481 -0
  181. package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
  182. package/tests/browser/ui-polish-features.spec.mjs +85 -0
  183. package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
  184. package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
  185. package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
  186. package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
  187. package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
  188. package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
  189. package/tests/browser/windows-drive-parent.spec.mjs +4 -2
  190. package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
  191. package/tests/codex-fast-mode-static.test.mjs +16 -11
  192. package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
  193. package/tests/codex-usage-source.test.mjs +4 -3
  194. package/tests/component-update-api-static.test.mjs +2 -2
  195. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  196. package/tests/control-deck-component-updates-static.test.mjs +9 -4
  197. package/tests/control-visibility-static.test.mjs +3 -3
  198. package/tests/controls-layout-static.test.mjs +5 -5
  199. package/tests/conversation-overview-adapter.test.mjs +100 -0
  200. package/tests/document-artifact-static.test.mjs +2 -1
  201. package/tests/draft-conversations.test.mjs +205 -0
  202. package/tests/empty-startup-launcher.test.mjs +197 -0
  203. package/tests/events-tree-context-menu-static.test.mjs +22 -18
  204. package/tests/fake-pi-session-ownership.test.mjs +302 -0
  205. package/tests/fast-mode-client-static.test.mjs +1 -1
  206. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  207. package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
  208. package/tests/file-viewer-image-static.test.mjs +15 -11
  209. package/tests/file-viewer-search-static.test.mjs +5 -5
  210. package/tests/fixtures/fake-pi.mjs +41 -9
  211. package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
  212. package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
  213. package/tests/git-footer-context-menu-static.test.mjs +1 -1
  214. package/tests/git-panel-file-preview-static.test.mjs +41 -48
  215. package/tests/git-panel-live-updates-static.test.mjs +2 -1
  216. package/tests/git-workflow-dispatch.test.mjs +66 -0
  217. package/tests/git-workflow-preferences.test.mjs +9 -1
  218. package/tests/guided-git-activation-static.test.mjs +14 -11
  219. package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
  220. package/tests/guided-git-message-reliability-static.test.mjs +10 -6
  221. package/tests/guided-git-publication-backend-static.test.mjs +16 -11
  222. package/tests/http-endpoints-harness.test.mjs +21 -9
  223. package/tests/interaction-state-stability-static.test.mjs +4 -3
  224. package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
  225. package/tests/intercom-tag-layout-static.test.mjs +13 -12
  226. package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
  227. package/tests/main-output-loading-static.test.mjs +4 -4
  228. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  229. package/tests/mobile-compact-layout.test.mjs +2 -2
  230. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  231. package/tests/mobile-foundation-static.test.mjs +10 -7
  232. package/tests/mobile-phone-experience-static.test.mjs +3 -2
  233. package/tests/mobile-static.test.mjs +173 -135
  234. package/tests/model-catalog-order.test.mjs +103 -0
  235. package/tests/native-parity.test.mjs +6 -4
  236. package/tests/native-session-choice-owner.test.mjs +102 -0
  237. package/tests/native-update-lifecycle.test.mjs +10 -5
  238. package/tests/no-project-http-harness.test.mjs +328 -0
  239. package/tests/no-project-navigation.test.mjs +54 -0
  240. package/tests/no-project-workspaces.test.mjs +77 -0
  241. package/tests/open-issue-wizard-static.test.mjs +1 -1
  242. package/tests/optional-feature-migration-frontend.test.mjs +4 -4
  243. package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
  244. package/tests/package-updates.test.mjs +630 -0
  245. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  246. package/tests/platform-event-stream.test.mjs +253 -0
  247. package/tests/project-file-viewer-controller.test.mjs +652 -0
  248. package/tests/project-git-tools-adapter.test.mjs +103 -0
  249. package/tests/project-git-tools-controller.test.mjs +577 -0
  250. package/tests/project-runners-controller.test.mjs +453 -0
  251. package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
  252. package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
  253. package/tests/questionnaire-dialog.test.mjs +6 -6
  254. package/tests/queue-edit-reorder-static.test.mjs +48 -51
  255. package/tests/rpc-supervisor-host.test.mjs +4 -1
  256. package/tests/safety-guard-auto-review-static.test.mjs +1 -1
  257. package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
  258. package/tests/server-app-runners.test.mjs +536 -0
  259. package/tests/server-codex-fast-mode.test.mjs +346 -0
  260. package/tests/server-conversation-mode.test.mjs +386 -0
  261. package/tests/server-conversation-voice.test.mjs +426 -0
  262. package/tests/server-extension-ui-requests.test.mjs +357 -0
  263. package/tests/server-git-generation.test.mjs +558 -0
  264. package/tests/server-git-mutations.test.mjs +729 -0
  265. package/tests/server-git-reads.test.mjs +381 -0
  266. package/tests/server-git-worktree-sessions.test.mjs +502 -0
  267. package/tests/server-helper-requests.test.mjs +364 -0
  268. package/tests/server-rpc-transports.test.mjs +553 -0
  269. package/tests/server-settings-store.test.mjs +132 -0
  270. package/tests/server-shell-rollout.test.mjs +478 -0
  271. package/tests/server-sse-delivery.test.mjs +410 -0
  272. package/tests/server-workspace-files.test.mjs +546 -0
  273. package/tests/session-attention-scheduler.test.mjs +514 -0
  274. package/tests/session-composer-store.test.mjs +153 -0
  275. package/tests/session-context.test.mjs +134 -0
  276. package/tests/session-extension-requests.test.mjs +193 -0
  277. package/tests/session-ownership-adapter.test.mjs +130 -0
  278. package/tests/session-sampling-ui-static.test.mjs +10 -4
  279. package/tests/session-send-lifetime.test.mjs +140 -0
  280. package/tests/session-shelf-state.test.mjs +348 -0
  281. package/tests/session-shelves-adapter.test.mjs +79 -0
  282. package/tests/session-summary-lifetime.test.mjs +54 -0
  283. package/tests/settings-resource-controller.test.mjs +548 -0
  284. package/tests/shell-action-adapter.test.mjs +169 -0
  285. package/tests/shell-actions.test.mjs +182 -0
  286. package/tests/shell-navigation.test.mjs +348 -0
  287. package/tests/shell-preferences.test.mjs +367 -0
  288. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  289. package/tests/stream-output-isolation-static.test.mjs +1 -1
  290. package/tests/subagent-gate-visibility.test.mjs +1 -1
  291. package/tests/subagent-launch-slot-state.test.mjs +2 -2
  292. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  293. package/tests/subagent-observability-static.test.mjs +2 -2
  294. package/tests/subagent-reliability-integration.test.mjs +13 -30
  295. package/tests/syntax-highlighting-static.test.mjs +3 -3
  296. package/tests/tab-close-continuity-static.test.mjs +1 -1
  297. package/tests/tab-metadata-ordering.test.mjs +99 -0
  298. package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
  299. package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
  300. package/tests/terminal-tab-workspace-static.test.mjs +5 -4
  301. package/tests/terminal-tabs-resize-static.test.mjs +1 -1
  302. package/tests/theme-customizer-static.test.mjs +1 -1
  303. package/tests/thread-display-title.test.mjs +44 -0
  304. package/tests/update-api-harness.test.mjs +15 -14
  305. package/tests/update-tab-restore-harness.test.mjs +3 -0
  306. package/tests/webui-settings-locking.test.mjs +2 -2
  307. package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
  308. package/tests/workspace-choices.test.mjs +114 -0
  309. package/tests/workspace-save-load-static.test.mjs +7 -4
@@ -0,0 +1,394 @@
1
+ import { spawn } from "node:child_process";
2
+ import { randomUUID } from "node:crypto";
3
+ import { StringDecoder } from "node:string_decoder";
4
+ import { PI_RPC_JSONL_LINE_MAX_BYTES } from "../rpc-supervisor-protocol.mjs";
5
+
6
+ export function createRpcTransportTypes({
7
+ assertNativeRpcAdmission,
8
+ sanitizeError,
9
+ requestTimeoutMs,
10
+ supervisorCommandTimeoutMaxMs,
11
+ }) {
12
+ const stderrMirrorFailureListeners = new Set();
13
+ const stderrMirrorErrorHandlers = new WeakSet();
14
+
15
+ function ensureStderrMirrorErrorHandler(stream) {
16
+ if (stderrMirrorErrorHandlers.has(stream)) return;
17
+ stderrMirrorErrorHandlers.add(stream);
18
+ stream.on("error", (error) => {
19
+ // Do not log from this handler: stderr is the failing sink and recursive
20
+ // diagnostics can otherwise terminate the process. Active writers report
21
+ // the failure through their normal Web UI event path instead.
22
+ for (const reportFailure of [...stderrMirrorFailureListeners]) reportFailure(error);
23
+ });
24
+ }
25
+
26
+ function mirrorPiStderr(text, onFailure) {
27
+ const stream = process.stderr;
28
+ let reported = false;
29
+ const reportFailure = (error) => {
30
+ if (reported) return;
31
+ reported = true;
32
+ stderrMirrorFailureListeners.delete(reportFailure);
33
+ onFailure(error);
34
+ };
35
+
36
+ if (!stream?.writable || stream.destroyed || stream.writableEnded) {
37
+ reportFailure(new Error("Web UI stderr sink is not writable"));
38
+ return;
39
+ }
40
+
41
+ ensureStderrMirrorErrorHandler(stream);
42
+ stderrMirrorFailureListeners.add(reportFailure);
43
+ try {
44
+ stream.write(text, (error) => {
45
+ stderrMirrorFailureListeners.delete(reportFailure);
46
+ if (error) reportFailure(error);
47
+ });
48
+ } catch (error) {
49
+ reportFailure(error);
50
+ }
51
+ }
52
+
53
+ class SupervisorPiRpcProcess {
54
+ constructor({ supervisor, tabId, displayCommand = "supervised Pi RPC", cwd, snapshot = {} }) {
55
+ this.supervisor = supervisor;
56
+ this.tabId = tabId;
57
+ this.displayCommand = displayCommand;
58
+ this.cwd = cwd;
59
+ this.startedAt = snapshot.startedAt || new Date().toISOString();
60
+ this.listeners = new Set();
61
+ this.metadataUpdate = Promise.resolve();
62
+ this.admissionTail = Promise.resolve();
63
+ this.applySnapshot(snapshot);
64
+ }
65
+
66
+ applySnapshot(snapshot = {}) {
67
+ this.startedAt = snapshot.startedAt || this.startedAt;
68
+ this.cwd = snapshot.metadata?.cwd || this.cwd;
69
+ const running = snapshot.running !== false;
70
+ this.child = {
71
+ pid: Number.isInteger(snapshot.pid) ? snapshot.pid : undefined,
72
+ exitCode: running ? null : 1,
73
+ signalCode: null,
74
+ killed: !running,
75
+ };
76
+ }
77
+
78
+ isRunning() {
79
+ return !!this.child && this.child.exitCode === null && this.child.signalCode === null;
80
+ }
81
+
82
+ onEvent(listener) {
83
+ this.listeners.add(listener);
84
+ return () => this.listeners.delete(listener);
85
+ }
86
+
87
+ emit(event) {
88
+ for (const listener of this.listeners) {
89
+ try {
90
+ listener(event);
91
+ } catch (error) {
92
+ console.error("webui listener failed:", error);
93
+ }
94
+ }
95
+ }
96
+
97
+ receiveSupervisorEvent(event) {
98
+ const payload = event?.payload;
99
+ if (!payload || typeof payload !== "object") return;
100
+ if (payload.type === "pi_process_start") {
101
+ this.child = { pid: payload.pid, exitCode: null, signalCode: null, killed: false };
102
+ this.startedAt = event.at || new Date().toISOString();
103
+ } else if (payload.type === "pi_process_exit") {
104
+ this.child = { ...(this.child || {}), exitCode: payload.code ?? 1, signalCode: payload.signal ?? null, killed: true };
105
+ } else if (payload.type === "pi_process_error" && !this.isRunning()) {
106
+ this.child = { ...(this.child || {}), exitCode: 1, signalCode: null, killed: true };
107
+ }
108
+ this.emit({
109
+ ...payload,
110
+ supervisorScopeId: event.scopeId,
111
+ supervisorEpoch: event.epoch,
112
+ supervisorSeq: event.seq,
113
+ });
114
+ if (payload.type === "pi_stderr" && payload.text) {
115
+ mirrorPiStderr(payload.text, (error) => this.emit({
116
+ type: "pi_stderr_sink_error",
117
+ error: `Pi RPC stderr could not be mirrored to the Web UI server log: ${sanitizeError(error)}`,
118
+ }));
119
+ }
120
+ }
121
+
122
+ // Reserve wrapper order before admission's filesystem await. Only dispatch
123
+ // holds the barrier: an RPC response may wait on a subsequent UI write.
124
+ dispatchInOrder(operation) {
125
+ const dispatch = this.admissionTail.catch(() => {}).then(operation);
126
+ this.admissionTail = dispatch.then(() => {}, () => {});
127
+ return dispatch;
128
+ }
129
+
130
+ async send(command, timeoutMs = requestTimeoutMs) {
131
+ const response = await this.dispatchInOrder(async () => {
132
+ await assertNativeRpcAdmission(command);
133
+ const requestId = command?.id || randomUUID();
134
+ const boundedTimeoutMs = Math.min(Math.max(1, Number(timeoutMs) || requestTimeoutMs), supervisorCommandTimeoutMaxMs);
135
+ return { response: this.supervisor.command(this.tabId, command, { requestId, timeoutMs: boundedTimeoutMs }) };
136
+ });
137
+ return response.response;
138
+ }
139
+
140
+ async writeRaw(command) {
141
+ return this.dispatchInOrder(async () => {
142
+ await assertNativeRpcAdmission(command);
143
+ return this.supervisor.write(this.tabId, command);
144
+ });
145
+ }
146
+
147
+ async replace({ child, metadata, displayCommand, restart }) {
148
+ const snapshot = await this.dispatchInOrder(async () => {
149
+ const request = { tabId: this.tabId, metadata, child };
150
+ return restart ? this.supervisor.replaceTabUnderUpdate({ ...request, restart }) : this.supervisor.replaceTab(request);
151
+ });
152
+ if (displayCommand) this.displayCommand = displayCommand;
153
+ this.applySnapshot(snapshot);
154
+ return snapshot;
155
+ }
156
+
157
+ updateMetadata(metadata) {
158
+ this.metadataUpdate = this.metadataUpdate.catch(() => {}).then(() => this.supervisor.updateTab(this.tabId, metadata));
159
+ return this.metadataUpdate;
160
+ }
161
+
162
+ async stop() {
163
+ return this.supervisor.closeTab(this.tabId);
164
+ }
165
+
166
+ dispose() {
167
+ this.listeners.clear();
168
+ }
169
+ }
170
+
171
+ class PiRpcProcess {
172
+ constructor({ command, args, displayCommand, cwd, env = process.env }) {
173
+ this.command = command;
174
+ this.args = args;
175
+ this.displayCommand = displayCommand;
176
+ this.cwd = cwd;
177
+ this.env = env;
178
+ this.child = undefined;
179
+ this.spawned = false;
180
+ this.pending = new Map();
181
+ this.listeners = new Set();
182
+ this.startedAt = new Date().toISOString();
183
+ this.stderrMirrorFailureReported = false;
184
+ }
185
+
186
+ reportStderrMirrorFailure(error) {
187
+ if (this.stderrMirrorFailureReported) return;
188
+ this.stderrMirrorFailureReported = true;
189
+ this.emit({
190
+ type: "pi_stderr_sink_error",
191
+ error: `Pi RPC stderr could not be mirrored to the Web UI server log: ${sanitizeError(error)}`,
192
+ });
193
+ }
194
+
195
+ start() {
196
+ this.spawned = false;
197
+ this.child = spawn(this.command, this.args, {
198
+ cwd: this.cwd,
199
+ env: this.env,
200
+ stdio: ["pipe", "pipe", "pipe"],
201
+ windowsHide: true,
202
+ });
203
+
204
+ const startup = new Promise((resolve, reject) => {
205
+ this.child.once("spawn", () => {
206
+ this.spawned = true;
207
+ this.emit({ type: "pi_process_start", pid: this.child.pid, cwd: this.cwd, command: this.displayCommand, args: this.args });
208
+ resolve();
209
+ });
210
+ this.child.on("error", (error) => {
211
+ this.spawned = false;
212
+ const message = sanitizeError(error);
213
+ this.emit({ type: "pi_process_error", error: message });
214
+ this.rejectAll(new Error(message));
215
+ reject(new Error(message));
216
+ });
217
+ });
218
+
219
+ this.child.on("exit", (code, signal) => {
220
+ this.emit({ type: "pi_process_exit", code, signal });
221
+ this.rejectAll(new Error(`Pi RPC process exited${code === null ? "" : ` with code ${code}`}${signal ? ` (${signal})` : ""}`));
222
+ });
223
+
224
+ this.attachJsonlReader(this.child.stdout, (line) => this.handleStdoutLine(line));
225
+ this.attachTextReader(this.child.stderr, (text) => {
226
+ if (text.length > 0) {
227
+ // Publish before attempting the optional terminal mirror so a closed
228
+ // stderr sink cannot hide Pi diagnostics from browser clients.
229
+ this.emit({ type: "pi_stderr", text });
230
+ mirrorPiStderr(text, (error) => this.reportStderrMirrorFailure(error));
231
+ }
232
+ });
233
+
234
+ return startup;
235
+ }
236
+
237
+ isRunning() {
238
+ return this.spawned && !!this.child && this.child.exitCode === null && !this.child.killed;
239
+ }
240
+
241
+ onEvent(listener) {
242
+ this.listeners.add(listener);
243
+ return () => this.listeners.delete(listener);
244
+ }
245
+
246
+ emit(event) {
247
+ for (const listener of this.listeners) {
248
+ try {
249
+ listener(event);
250
+ } catch (error) {
251
+ console.error("webui listener failed:", error);
252
+ }
253
+ }
254
+ }
255
+
256
+ attachJsonlReader(stream, onLine) {
257
+ const decoder = new StringDecoder("utf8");
258
+ let buffer = "";
259
+ let bufferBytes = 0;
260
+ let discardingOversizedLine = false;
261
+
262
+ const emitOversizedLine = () => this.emit({
263
+ type: "pi_stdout_line_too_large",
264
+ error: `Discarded a Pi RPC JSONL line larger than ${PI_RPC_JSONL_LINE_MAX_BYTES} bytes`,
265
+ maxBytes: PI_RPC_JSONL_LINE_MAX_BYTES,
266
+ });
267
+ const consume = (chunk) => {
268
+ let input = chunk;
269
+ while (input.length > 0) {
270
+ if (discardingOversizedLine) {
271
+ const newlineIndex = input.indexOf("\n");
272
+ if (newlineIndex === -1) return;
273
+ discardingOversizedLine = false;
274
+ input = input.slice(newlineIndex + 1);
275
+ continue;
276
+ }
277
+
278
+ const newlineIndex = input.indexOf("\n");
279
+ const segment = newlineIndex === -1 ? input : input.slice(0, newlineIndex);
280
+ const segmentBytes = Buffer.byteLength(segment);
281
+ if (bufferBytes + segmentBytes > PI_RPC_JSONL_LINE_MAX_BYTES) {
282
+ buffer = "";
283
+ bufferBytes = 0;
284
+ emitOversizedLine();
285
+ if (newlineIndex === -1) {
286
+ discardingOversizedLine = true;
287
+ return;
288
+ }
289
+ input = input.slice(newlineIndex + 1);
290
+ continue;
291
+ }
292
+
293
+ buffer += segment;
294
+ bufferBytes += segmentBytes;
295
+ if (newlineIndex === -1) return;
296
+ let line = buffer;
297
+ buffer = "";
298
+ bufferBytes = 0;
299
+ if (line.endsWith("\r")) line = line.slice(0, -1);
300
+ onLine(line);
301
+ input = input.slice(newlineIndex + 1);
302
+ }
303
+ };
304
+
305
+ stream.on("data", (chunk) => consume(typeof chunk === "string" ? chunk : decoder.write(chunk)));
306
+ stream.on("end", () => {
307
+ consume(decoder.end());
308
+ if (!discardingOversizedLine && buffer.length > 0) onLine(buffer.endsWith("\r") ? buffer.slice(0, -1) : buffer);
309
+ });
310
+ }
311
+
312
+ attachTextReader(stream, onText) {
313
+ const decoder = new StringDecoder("utf8");
314
+ stream.on("data", (chunk) => onText(typeof chunk === "string" ? chunk : decoder.write(chunk)));
315
+ stream.on("end", () => {
316
+ const tail = decoder.end();
317
+ if (tail) onText(tail);
318
+ });
319
+ }
320
+
321
+ handleStdoutLine(line) {
322
+ if (!line.trim()) return;
323
+
324
+ let event;
325
+ try {
326
+ event = JSON.parse(line);
327
+ } catch (error) {
328
+ this.emit({ type: "pi_stdout_parse_error", line, error: sanitizeError(error) });
329
+ return;
330
+ }
331
+
332
+ if (event?.type === "response" && event.id && this.pending.has(event.id)) {
333
+ const pending = this.pending.get(event.id);
334
+ this.pending.delete(event.id);
335
+ clearTimeout(pending.timeout);
336
+ pending.resolve(event);
337
+ }
338
+
339
+ this.emit(event);
340
+ }
341
+
342
+ send(command, timeoutMs = requestTimeoutMs) {
343
+ if (!this.isRunning() || !this.child?.stdin) {
344
+ return Promise.reject(new Error("Pi RPC process is not running"));
345
+ }
346
+
347
+ const id = command.id || randomUUID();
348
+ const payload = { ...command, id };
349
+
350
+ return new Promise((resolve, reject) => {
351
+ const timeout = setTimeout(() => {
352
+ this.pending.delete(id);
353
+ reject(new Error(`Timed out waiting for RPC response to ${command.type}`));
354
+ }, timeoutMs);
355
+
356
+ this.pending.set(id, { resolve, reject, timeout });
357
+ this.writeRaw(payload).catch((error) => {
358
+ clearTimeout(timeout);
359
+ this.pending.delete(id);
360
+ reject(error);
361
+ });
362
+ });
363
+ }
364
+
365
+ async writeRaw(command) {
366
+ if (!this.isRunning() || !this.child?.stdin) {
367
+ throw new Error("Pi RPC process is not running");
368
+ }
369
+ await assertNativeRpcAdmission(command);
370
+ const line = `${JSON.stringify(command)}\n`;
371
+ if (!this.child.stdin.write(line)) {
372
+ await new Promise((resolve) => this.child.stdin.once("drain", resolve));
373
+ }
374
+ }
375
+
376
+ rejectAll(error) {
377
+ for (const [id, pending] of this.pending) {
378
+ clearTimeout(pending.timeout);
379
+ pending.reject(error);
380
+ this.pending.delete(id);
381
+ }
382
+ }
383
+
384
+ stop() {
385
+ if (!this.child || this.child.exitCode !== null) return;
386
+ this.child.kill("SIGTERM");
387
+ setTimeout(() => {
388
+ if (this.child && this.child.exitCode === null) this.child.kill("SIGKILL");
389
+ }, 3000).unref();
390
+ }
391
+ }
392
+
393
+ return { PiRpcProcess, SupervisorPiRpcProcess };
394
+ }