@firstpick/pi-package-webui 0.11.0 → 0.11.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (318) hide show
  1. package/DEVELOPMENT.md +181 -12
  2. package/README.md +41 -9
  3. package/TECHNICAL.md +91 -8
  4. package/bin/pi-webui.mjs +5432 -11428
  5. package/index.ts +10 -3
  6. package/lib/codex-cli-usage.mjs +232 -0
  7. package/lib/codex-usage-auth.mjs +39 -3
  8. package/lib/codex-usage-source.mjs +36 -0
  9. package/lib/component-update-state.mjs +2 -2
  10. package/lib/git-workflow-preference-values.mjs +122 -0
  11. package/lib/git-workflow-preferences.mjs +35 -563
  12. package/lib/package-updates.mjs +260 -0
  13. package/lib/rpc-supervisor-client.mjs +8 -4
  14. package/lib/server/app-runners.mjs +1667 -0
  15. package/lib/server/codex-fast-mode.mjs +161 -0
  16. package/lib/server/conversation-mode.mjs +218 -0
  17. package/lib/server/conversation-voice.mjs +318 -0
  18. package/lib/server/extension-ui-requests.mjs +114 -0
  19. package/lib/server/git-generation.mjs +459 -0
  20. package/lib/server/git-mutations.mjs +1827 -0
  21. package/lib/server/git-reads.mjs +608 -0
  22. package/lib/server/git-worktree-sessions.mjs +408 -0
  23. package/lib/server/helper-requests.mjs +82 -0
  24. package/lib/server/no-project-workspaces.mjs +103 -0
  25. package/lib/server/rpc-transports.mjs +394 -0
  26. package/lib/server/settings-store.mjs +544 -0
  27. package/lib/server/sse-delivery.mjs +138 -0
  28. package/lib/server/workspace-files.mjs +563 -0
  29. package/lib/update/supervisor.mjs +4 -0
  30. package/lib/webui-workspaces.mjs +2 -0
  31. package/package.json +5 -5
  32. package/public/activity-agents-controller.mjs +269 -0
  33. package/public/activity-events-controller.mjs +236 -0
  34. package/public/activity-intercom-controller.mjs +627 -0
  35. package/public/activity-queue-controller.mjs +534 -0
  36. package/public/activity-todo-view.mjs +89 -0
  37. package/public/activity-usage-controller.mjs +589 -0
  38. package/public/app.js +3761 -3878
  39. package/public/conversation-overview.css +84 -0
  40. package/public/conversation-overview.mjs +193 -0
  41. package/public/draft-conversations.mjs +135 -0
  42. package/public/focused-composer-controls.css +111 -0
  43. package/public/focused-composer-controls.mjs +143 -0
  44. package/public/focused-composer-disclosure.mjs +223 -0
  45. package/public/focused-shell-adapter.css +264 -0
  46. package/public/focused-shell-adapter.mjs +257 -0
  47. package/public/index.html +137 -80
  48. package/public/model-catalog-order.mjs +63 -0
  49. package/public/platform-event-stream.mjs +64 -0
  50. package/public/project-artifact-controller.mjs +218 -0
  51. package/public/project-file-viewer-controller.mjs +383 -0
  52. package/public/project-git-tools-controller.mjs +181 -0
  53. package/public/project-runners-controller.mjs +220 -0
  54. package/public/service-worker.js +52 -1
  55. package/public/session-attention-scheduler.mjs +182 -0
  56. package/public/session-composer-store.mjs +56 -0
  57. package/public/session-context.mjs +51 -0
  58. package/public/session-extension-requests.mjs +63 -0
  59. package/public/session-shelf-state.mjs +151 -0
  60. package/public/session-shelves.css +171 -0
  61. package/public/session-shelves.mjs +95 -0
  62. package/public/settings-navigation-controller.mjs +249 -0
  63. package/public/settings-navigation.css +61 -0
  64. package/public/settings-resource-controller.mjs +232 -0
  65. package/public/settings-workspace.css +19 -0
  66. package/public/settings-workspace.mjs +175 -0
  67. package/public/shell-actions.mjs +87 -0
  68. package/public/shell-attention-inbox.css +72 -0
  69. package/public/shell-attention-inbox.mjs +198 -0
  70. package/public/shell-context-actions.css +61 -0
  71. package/public/shell-context-actions.mjs +168 -0
  72. package/public/shell-inspector-resize.mjs +124 -0
  73. package/public/shell-navigation-resize.mjs +107 -0
  74. package/public/shell-navigation.mjs +127 -0
  75. package/public/shell-preferences.mjs +108 -0
  76. package/public/shell-surfaces.mjs +99 -0
  77. package/public/shell-tools-launcher.css +97 -0
  78. package/public/shell-tools-launcher.mjs +222 -0
  79. package/public/shell-view-host.mjs +115 -0
  80. package/public/shell-workspace.css +266 -0
  81. package/public/shell-workspace.mjs +402 -0
  82. package/public/sidebar-update-menu.css +190 -0
  83. package/public/sidebar-update-menu.mjs +512 -0
  84. package/public/styles.css +320 -169
  85. package/public/subagent-launch-slot-state.mjs +2 -2
  86. package/public/theme-contract.mjs +1 -1
  87. package/public/themed-selects.css +156 -0
  88. package/public/workspace-choices.mjs +104 -0
  89. package/tests/activity-agents-controller.test.mjs +652 -0
  90. package/tests/activity-events-controller.test.mjs +511 -0
  91. package/tests/app-runner-terminal-static.test.mjs +3 -3
  92. package/tests/append-system-http.test.mjs +7 -6
  93. package/tests/append-system-selector-static.test.mjs +6 -6
  94. package/tests/aur-review-widget-static.test.mjs +11 -3
  95. package/tests/boot-failure-diagnostics.test.mjs +8 -3
  96. package/tests/browser/activity-intercom-controller.spec.mjs +457 -0
  97. package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
  98. package/tests/browser/activity-owner-integration.spec.mjs +201 -0
  99. package/tests/browser/activity-queue-controller.spec.mjs +405 -0
  100. package/tests/browser/activity-section-picker.spec.mjs +294 -0
  101. package/tests/browser/activity-todo-view.spec.mjs +60 -0
  102. package/tests/browser/activity-usage-controller.spec.mjs +416 -0
  103. package/tests/browser/compact-layout-integration.spec.mjs +58 -0
  104. package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
  105. package/tests/browser/composer-disclosure.spec.mjs +389 -0
  106. package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
  107. package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
  108. package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
  109. package/tests/browser/control-visibility.spec.mjs +5 -0
  110. package/tests/browser/controls-layout.spec.mjs +21 -2
  111. package/tests/browser/conversation-overview.spec.mjs +251 -0
  112. package/tests/browser/draft-conversations.spec.mjs +276 -0
  113. package/tests/browser/empty-startup-fixture.mjs +135 -0
  114. package/tests/browser/empty-startup.spec.mjs +282 -0
  115. package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
  116. package/tests/browser/focused-composer-more.spec.mjs +127 -0
  117. package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
  118. package/tests/browser/focused-navigation-fixture.mjs +32 -0
  119. package/tests/browser/focused-project-activity.spec.mjs +111 -0
  120. package/tests/browser/focused-shell-integration.spec.mjs +208 -0
  121. package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
  122. package/tests/browser/folder-picker-layout.spec.mjs +302 -0
  123. package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
  124. package/tests/browser/git-setup-cancel.spec.mjs +251 -0
  125. package/tests/browser/guided-git-fallback.spec.mjs +40 -21
  126. package/tests/browser/inspector-header.spec.mjs +221 -0
  127. package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
  128. package/tests/browser/inspector-resize.spec.mjs +227 -0
  129. package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
  130. package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
  131. package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
  132. package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
  133. package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
  134. package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
  135. package/tests/browser/interaction-continuity.spec.mjs +50 -26
  136. package/tests/browser/interaction-model-picker.spec.mjs +86 -0
  137. package/tests/browser/last-terminal-close.spec.mjs +280 -0
  138. package/tests/browser/mobile-foundation.spec.mjs +172 -20
  139. package/tests/browser/model-catalog-groups.spec.mjs +104 -0
  140. package/tests/browser/more-row-menus.spec.mjs +258 -0
  141. package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
  142. package/tests/browser/no-project-conversation.spec.mjs +113 -0
  143. package/tests/browser/optimistic-prompt.spec.mjs +3 -0
  144. package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
  145. package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
  146. package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
  147. package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
  148. package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
  149. package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
  150. package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
  151. package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
  152. package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
  153. package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
  154. package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
  155. package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
  156. package/tests/browser/project-artifact-controller.spec.mjs +324 -0
  157. package/tests/browser/project-artifact-integration.spec.mjs +103 -0
  158. package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
  159. package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
  160. package/tests/browser/session-fixture.mjs +118 -0
  161. package/tests/browser/session-ownership.spec.mjs +175 -0
  162. package/tests/browser/session-shelves-integration.spec.mjs +219 -0
  163. package/tests/browser/session-shelves.spec.mjs +340 -0
  164. package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
  165. package/tests/browser/session-summary.spec.mjs +17 -12
  166. package/tests/browser/settings-complete-home.spec.mjs +463 -0
  167. package/tests/browser/settings-entrypoint.spec.mjs +104 -0
  168. package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
  169. package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
  170. package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
  171. package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
  172. package/tests/browser/shell-ownership.spec.mjs +398 -0
  173. package/tests/browser/shell-rollout-fixture.mjs +259 -0
  174. package/tests/browser/shell-rollout.spec.mjs +357 -0
  175. package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
  176. package/tests/browser/shell-workspace.spec.mjs +433 -0
  177. package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
  178. package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
  179. package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
  180. package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
  181. package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
  182. package/tests/browser/stream-output-isolation.spec.mjs +6 -3
  183. package/tests/browser/themed-selects.spec.mjs +297 -0
  184. package/tests/browser/thread-start-flow.spec.mjs +481 -0
  185. package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
  186. package/tests/browser/ui-polish-features.spec.mjs +85 -0
  187. package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
  188. package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
  189. package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
  190. package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
  191. package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
  192. package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
  193. package/tests/browser/windows-drive-parent.spec.mjs +4 -2
  194. package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
  195. package/tests/codex-cli-usage.test.mjs +189 -0
  196. package/tests/codex-fast-mode-static.test.mjs +16 -11
  197. package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
  198. package/tests/codex-usage-auth.test.mjs +168 -9
  199. package/tests/codex-usage-http.test.mjs +124 -0
  200. package/tests/codex-usage-source.test.mjs +146 -0
  201. package/tests/component-update-api-static.test.mjs +2 -2
  202. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  203. package/tests/control-deck-component-updates-static.test.mjs +9 -4
  204. package/tests/control-visibility-static.test.mjs +3 -3
  205. package/tests/controls-layout-static.test.mjs +5 -5
  206. package/tests/conversation-overview-adapter.test.mjs +100 -0
  207. package/tests/document-artifact-static.test.mjs +2 -1
  208. package/tests/draft-conversations.test.mjs +205 -0
  209. package/tests/empty-startup-launcher.test.mjs +197 -0
  210. package/tests/events-tree-context-menu-static.test.mjs +22 -18
  211. package/tests/fake-pi-session-ownership.test.mjs +302 -0
  212. package/tests/fast-mode-client-static.test.mjs +1 -1
  213. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  214. package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
  215. package/tests/file-viewer-image-static.test.mjs +15 -11
  216. package/tests/file-viewer-search-static.test.mjs +5 -5
  217. package/tests/fixtures/fake-codex-app-server.mjs +61 -0
  218. package/tests/fixtures/fake-pi.mjs +41 -9
  219. package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
  220. package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
  221. package/tests/git-footer-context-menu-static.test.mjs +1 -1
  222. package/tests/git-panel-file-preview-static.test.mjs +41 -48
  223. package/tests/git-panel-live-updates-static.test.mjs +2 -1
  224. package/tests/git-workflow-dispatch.test.mjs +66 -0
  225. package/tests/git-workflow-preferences.test.mjs +9 -1
  226. package/tests/guided-git-activation-static.test.mjs +14 -11
  227. package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
  228. package/tests/guided-git-message-reliability-static.test.mjs +10 -6
  229. package/tests/guided-git-publication-backend-static.test.mjs +16 -11
  230. package/tests/http-endpoints-harness.test.mjs +29 -9
  231. package/tests/interaction-state-stability-static.test.mjs +4 -3
  232. package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
  233. package/tests/intercom-tag-layout-static.test.mjs +13 -12
  234. package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
  235. package/tests/main-output-loading-static.test.mjs +4 -4
  236. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  237. package/tests/mobile-compact-layout.test.mjs +2 -2
  238. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  239. package/tests/mobile-foundation-static.test.mjs +10 -7
  240. package/tests/mobile-phone-experience-static.test.mjs +3 -2
  241. package/tests/mobile-static.test.mjs +173 -135
  242. package/tests/model-catalog-order.test.mjs +103 -0
  243. package/tests/native-parity.test.mjs +6 -4
  244. package/tests/native-session-choice-owner.test.mjs +102 -0
  245. package/tests/native-update-lifecycle.test.mjs +10 -5
  246. package/tests/no-project-http-harness.test.mjs +328 -0
  247. package/tests/no-project-navigation.test.mjs +54 -0
  248. package/tests/no-project-workspaces.test.mjs +77 -0
  249. package/tests/open-issue-wizard-static.test.mjs +1 -1
  250. package/tests/optional-feature-migration-frontend.test.mjs +4 -4
  251. package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
  252. package/tests/package-updates.test.mjs +630 -0
  253. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  254. package/tests/platform-event-stream.test.mjs +253 -0
  255. package/tests/project-file-viewer-controller.test.mjs +652 -0
  256. package/tests/project-git-tools-adapter.test.mjs +103 -0
  257. package/tests/project-git-tools-controller.test.mjs +577 -0
  258. package/tests/project-runners-controller.test.mjs +453 -0
  259. package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
  260. package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
  261. package/tests/questionnaire-dialog.test.mjs +6 -6
  262. package/tests/queue-edit-reorder-static.test.mjs +48 -51
  263. package/tests/rpc-supervisor-host.test.mjs +4 -1
  264. package/tests/safety-guard-auto-review-static.test.mjs +1 -1
  265. package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
  266. package/tests/server-app-runners.test.mjs +536 -0
  267. package/tests/server-codex-fast-mode.test.mjs +346 -0
  268. package/tests/server-conversation-mode.test.mjs +386 -0
  269. package/tests/server-conversation-voice.test.mjs +426 -0
  270. package/tests/server-extension-ui-requests.test.mjs +357 -0
  271. package/tests/server-git-generation.test.mjs +558 -0
  272. package/tests/server-git-mutations.test.mjs +729 -0
  273. package/tests/server-git-reads.test.mjs +381 -0
  274. package/tests/server-git-worktree-sessions.test.mjs +502 -0
  275. package/tests/server-helper-requests.test.mjs +364 -0
  276. package/tests/server-rpc-transports.test.mjs +553 -0
  277. package/tests/server-settings-store.test.mjs +132 -0
  278. package/tests/server-shell-rollout.test.mjs +478 -0
  279. package/tests/server-sse-delivery.test.mjs +410 -0
  280. package/tests/server-workspace-files.test.mjs +546 -0
  281. package/tests/session-attention-scheduler.test.mjs +514 -0
  282. package/tests/session-composer-store.test.mjs +153 -0
  283. package/tests/session-context.test.mjs +134 -0
  284. package/tests/session-extension-requests.test.mjs +193 -0
  285. package/tests/session-ownership-adapter.test.mjs +130 -0
  286. package/tests/session-sampling-ui-static.test.mjs +10 -4
  287. package/tests/session-send-lifetime.test.mjs +140 -0
  288. package/tests/session-shelf-state.test.mjs +348 -0
  289. package/tests/session-shelves-adapter.test.mjs +79 -0
  290. package/tests/session-summary-lifetime.test.mjs +54 -0
  291. package/tests/settings-resource-controller.test.mjs +548 -0
  292. package/tests/shell-action-adapter.test.mjs +169 -0
  293. package/tests/shell-actions.test.mjs +182 -0
  294. package/tests/shell-navigation.test.mjs +348 -0
  295. package/tests/shell-preferences.test.mjs +367 -0
  296. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  297. package/tests/stream-output-isolation-static.test.mjs +1 -1
  298. package/tests/subagent-gate-visibility.test.mjs +1 -1
  299. package/tests/subagent-launch-slot-state.test.mjs +2 -2
  300. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  301. package/tests/subagent-observability-static.test.mjs +2 -2
  302. package/tests/subagent-reliability-integration.test.mjs +13 -30
  303. package/tests/syntax-highlighting-static.test.mjs +3 -3
  304. package/tests/tab-close-continuity-static.test.mjs +1 -1
  305. package/tests/tab-metadata-ordering.test.mjs +99 -0
  306. package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
  307. package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
  308. package/tests/terminal-tab-workspace-static.test.mjs +5 -4
  309. package/tests/terminal-tabs-resize-static.test.mjs +1 -1
  310. package/tests/theme-contract.test.mjs +10 -3
  311. package/tests/theme-customizer-static.test.mjs +1 -1
  312. package/tests/thread-display-title.test.mjs +44 -0
  313. package/tests/update-api-harness.test.mjs +15 -14
  314. package/tests/update-tab-restore-harness.test.mjs +3 -0
  315. package/tests/webui-settings-locking.test.mjs +2 -2
  316. package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
  317. package/tests/workspace-choices.test.mjs +114 -0
  318. package/tests/workspace-save-load-static.test.mjs +7 -4
@@ -0,0 +1,348 @@
1
+ import { navigateFocused } from './focused-navigation-fixture.mjs';
2
+ import { expect } from '@playwright/test';
3
+ import { test } from './session-fixture.mjs';
4
+
5
+ const categories = [
6
+ ['appearance', 'Appearance'],
7
+ ['resources', 'Models and resources'],
8
+ ['features', 'Features'],
9
+ ['accounts', 'Accounts'],
10
+ ['voice', 'Voice'],
11
+ ['connection', 'Connection'],
12
+ ['system', 'System'],
13
+ ['help', 'Help'],
14
+ ];
15
+ const search = (page) => page.getByRole('searchbox', { name: 'Search settings', exact: true });
16
+ const categoryNavigation = (page) => page.getByRole('navigation', { name: 'Settings categories', exact: true });
17
+ const destinations = (page) => page.getByRole('navigation', { name: 'Workspace destinations' });
18
+ const searchResults = (page) => page.getByRole('list', { name: 'Settings search results', exact: true });
19
+ const settingResult = (page, label) => searchResults(page).getByRole('listitem')
20
+ .filter({ has: page.getByText(label, { exact: true }) });
21
+
22
+ // Keep the normal package runner portable; the isolated worker config selects system Chromium.
23
+ test.use({ video: 'off', serviceWorkers: 'block', viewport: { width: 1440, height: 900 }, reducedMotion: 'reduce' });
24
+ test.setTimeout(45_000);
25
+
26
+ async function openFocused(page, ownership, query = '') {
27
+ await page.addInitScript(() => {
28
+ const key = 'pi-webui-shell-preferences-v1';
29
+ if (!localStorage.getItem(key)) localStorage.setItem(key, JSON.stringify({ v: 1, desktopLayout: 'focused' }));
30
+ history.replaceState({ ...history.state, settingsNavigationExternal: { keep: 'original history' } }, '');
31
+ });
32
+ const url = new URL(ownership.baseURL);
33
+ url.search = query;
34
+ url.searchParams.set('tab', ownership.tabs[0].id);
35
+ await page.goto(url.href);
36
+ await expect(page.locator('#focusedWorkspace')).toBeVisible();
37
+ await expect(page.locator('#modelSelect')).not.toBeEmpty();
38
+ await expect(page.locator(`#tabBar [data-tab-id="${ownership.tabs[0].id}"] .terminal-tab-button`))
39
+ .toHaveAttribute('aria-selected', 'true');
40
+ // Fresh fixture servers migrate initial layout defaults asynchronously. Observe
41
+ // Settings writes only after that existing startup migration has persisted.
42
+ await expect.poll(async () => {
43
+ const { layout } = await ownership.api('/api/interface-preferences');
44
+ const panel = layout?.sidePanel;
45
+ return !!panel?.placement && Array.isArray(panel?.sectionLayout?.order)
46
+ && typeof panel?.collapsedPanels?.right === 'boolean' && Number.isFinite(panel?.panelWidths?.right);
47
+ }).toBe(true);
48
+ }
49
+
50
+ async function openSettings(page) {
51
+ await navigateFocused(page, 'Settings');
52
+ await expect(search(page)).toBeVisible();
53
+ await expect(categoryNavigation(page)).toBeVisible();
54
+ }
55
+
56
+ async function expectLocation(page, category, setting = null) {
57
+ await expect.poll(() => {
58
+ const params = new URL(page.url()).searchParams;
59
+ return [params.get('view'), params.get('inspector'), params.get('setting')];
60
+ }).toEqual(['settings', `settings:${category}`, setting]);
61
+ const label = categories.find(([id]) => id === category)[1];
62
+ await expect(categoryNavigation(page).getByRole('button', { name: label, exact: true }))
63
+ .toHaveAttribute('aria-current', 'page');
64
+ }
65
+
66
+ async function preferenceSnapshot(page) {
67
+ return page.evaluate(() => Object.fromEntries(Object.keys(localStorage).sort()
68
+ .filter((key) => /^pi-webui-(shell-preferences|theme|control-visibility)/.test(key))
69
+ .map((key) => [key, localStorage.getItem(key)])));
70
+ }
71
+
72
+ function observePreferenceWrites(page) {
73
+ const writes = [];
74
+ page.on('request', (request) => {
75
+ const path = new URL(request.url()).pathname;
76
+ if (!['GET', 'HEAD'].includes(request.method()) &&
77
+ /^\/api\/(settings|interface-preferences|themes|tools|skills)(\/|$)/.test(path)) {
78
+ writes.push({ method: request.method(), path, body: request.postData() });
79
+ }
80
+ });
81
+ return writes;
82
+ }
83
+
84
+ async function revealTheme(page) {
85
+ await search(page).fill('Theme');
86
+ const theme = settingResult(page, 'Theme').getByRole('button', { name: /^Theme(?:\s|$)/ });
87
+ await expect(theme).toHaveCount(1);
88
+ await theme.click();
89
+ // The canonical Theme select opens its existing searchable picker when focused.
90
+ await expectLocation(page, 'appearance', 'theme');
91
+ await expect(page.locator('#themeSearchInput')).toBeVisible();
92
+ await expect(page.locator('#themeSearchInput')).toBeFocused();
93
+ }
94
+
95
+ test('actual Settings exposes accessible categories and searches without changing preferences', async ({ page, ownership }, testInfo) => {
96
+ await openFocused(page, ownership);
97
+ await openSettings(page);
98
+ await expect(categoryNavigation(page).getByRole('button')).toHaveText(categories.map(([, label]) => label));
99
+ await expectLocation(page, 'appearance');
100
+ for (const [id, label] of categories) {
101
+ await categoryNavigation(page).getByRole('button', { name: label, exact: true }).click();
102
+ await expectLocation(page, id);
103
+ }
104
+ const appearance = categoryNavigation(page).getByRole('button', { name: 'Appearance', exact: true });
105
+ await appearance.focus();
106
+ await page.keyboard.press('End');
107
+ await expect(categoryNavigation(page).getByRole('button', { name: 'Help', exact: true })).toBeFocused();
108
+ await page.keyboard.press('Home');
109
+ await expect(appearance).toBeFocused();
110
+ await page.keyboard.press('Enter');
111
+ await expectLocation(page, 'appearance');
112
+
113
+ const before = await preferenceSnapshot(page);
114
+ const writes = observePreferenceWrites(page);
115
+ await search(page).fill('Theme');
116
+ await expect(settingResult(page, 'Theme').getByRole('button', { name: /^Theme(?:\s|$)/ })).toBeVisible();
117
+ await search(page).fill('w5 no matching setting 7a658114');
118
+ await expect(page.getByRole('status').filter({ hasText: 'No matching settings. Try another name or purpose.' })).toBeVisible();
119
+ await expect(searchResults(page).getByRole('listitem')).toHaveCount(0);
120
+ await search(page).press('Enter');
121
+ await expectLocation(page, 'appearance');
122
+ await search(page).press('Escape');
123
+ await expect(search(page)).toHaveValue('');
124
+ await expect(search(page)).toBeFocused();
125
+ expect(await preferenceSnapshot(page)).toEqual(before);
126
+ expect(writes).toEqual([]);
127
+ await page.screenshot({ path: testInfo.outputPath('actual-settings-appearance.png'), animations: 'disabled' });
128
+ });
129
+
130
+ test('Theme search focuses the original control and restores its anchor through Back and Forward', async ({ page, ownership }, testInfo) => {
131
+ await openFocused(page, ownership, 'custom=keep&another=value');
132
+ await page.evaluate(() => {
133
+ history.replaceState(history.state, '', `${location.href}#settings-fragment`);
134
+ window.settingsOriginalTheme = document.querySelector('#themeSelect');
135
+ });
136
+ await openSettings(page);
137
+ const before = await preferenceSnapshot(page);
138
+ const writes = observePreferenceWrites(page);
139
+ await revealTheme(page);
140
+ expect(await page.locator('#themeSelect').evaluate((node) => node === window.settingsOriginalTheme)).toBe(true);
141
+ await expect(page.locator('#themeSelect')).toHaveCount(1);
142
+ await page.screenshot({ path: testInfo.outputPath('actual-settings-theme-focus.png'), animations: 'disabled' });
143
+ await destinations(page).getByRole('button', { name: 'Conversation', exact: true }).click();
144
+ await expect(page.locator('#focusedWorkspace')).toHaveAttribute('data-destination', 'conversation');
145
+ await page.goBack();
146
+ await expectLocation(page, 'appearance', 'theme');
147
+ expect(new URL(page.url()).searchParams.get('custom')).toBe('keep');
148
+ expect(new URL(page.url()).searchParams.get('another')).toBe('value');
149
+ expect(new URL(page.url()).searchParams.get('tab')).toBe(ownership.tabs[0].id);
150
+ expect(new URL(page.url()).hash).toBe('#settings-fragment');
151
+ expect(await page.evaluate(() => history.state.settingsNavigationExternal)).toEqual({ keep: 'original history' });
152
+ await expect(page.locator('#themeSearchInput')).toBeVisible();
153
+ await expect(page.locator('#themeSearchInput')).toBeFocused();
154
+ expect(await page.locator('#themeSelect').evaluate((node) => node === window.settingsOriginalTheme)).toBe(true);
155
+ await page.goForward();
156
+ await expect(page.locator('#focusedWorkspace')).toHaveAttribute('data-destination', 'conversation');
157
+ const url = new URL(page.url());
158
+ expect(url.searchParams.get('custom')).toBe('keep');
159
+ expect(url.searchParams.get('another')).toBe('value');
160
+ expect(url.searchParams.get('tab')).toBe(ownership.tabs[0].id);
161
+ expect(url.hash).toBe('#settings-fragment');
162
+ expect(await page.evaluate(() => history.state.settingsNavigationExternal)).toEqual({ keep: 'original history' });
163
+ expect(await preferenceSnapshot(page)).toEqual(before);
164
+ expect(writes).toEqual([]);
165
+ });
166
+
167
+ test('Models and resources opens Tools Setup through the actual Tools Settings entry', async ({ page, ownership }) => {
168
+ // The fake Pi does not advertise companion commands; only its command catalog is supplied here.
169
+ await page.route('**/api/commands?*', (route) => route.fulfill({ json: {
170
+ ok: true, data: { commands: [{ name: 'tools', source: 'extension', description: 'Configure tools' }] },
171
+ } }));
172
+ await openFocused(page, ownership);
173
+ await openSettings(page);
174
+ await categoryNavigation(page).getByRole('button', { name: 'Models and resources', exact: true }).click();
175
+ await expectLocation(page, 'resources');
176
+ await search(page).fill('Tools');
177
+ const tools = settingResult(page, 'Tools');
178
+ await expect(tools).toHaveCount(1);
179
+ const before = await preferenceSnapshot(page);
180
+ const writes = observePreferenceWrites(page);
181
+ await tools.getByRole('button', { name: /^Tools(?:\s|$)/ }).click();
182
+ await expect(page.locator('#nativeCommandDialog')).toBeVisible();
183
+ await expect(page.locator('#nativeCommandTitle')).toHaveText('Tools Setup');
184
+ await expect(page.locator('.native-resource-scope select')).toHaveValue('session');
185
+ await expect(page.locator('.native-resource-scope select option')).toHaveText(['Session only', 'Global default', 'Model default']);
186
+ await expect(page.locator('.native-selector-item').filter({ hasText: 'bash' })).toBeVisible();
187
+ await page.keyboard.press('Escape');
188
+ await expect(page.locator('#nativeCommandDialog')).toBeHidden();
189
+ await expect(page.locator('#focusedWorkspace')).toHaveAttribute('data-destination', 'settings');
190
+ expect(await preferenceSnapshot(page)).toEqual(before);
191
+ expect(writes).toEqual([]);
192
+ });
193
+
194
+ test('invalid category and entry anchors replace history without changing the session or preferences', async ({ page, ownership }) => {
195
+ await openFocused(page, ownership);
196
+ await openSettings(page);
197
+ const initialSession = await ownership.api(`/api/state?tab=${encodeURIComponent(ownership.tabs[0].id)}`);
198
+ const before = await preferenceSnapshot(page);
199
+ const writes = observePreferenceWrites(page);
200
+ for (const [query, category] of [
201
+ ['view=settings', 'appearance'],
202
+ ['view=settings&inspector=settings:does-not-exist', 'appearance'],
203
+ ['view=settings&inspector=settings:appearance&setting=does-not-exist', 'appearance'],
204
+ ['view=settings&inspector=settings:resources&setting=does-not-exist', 'resources'],
205
+ ]) {
206
+ await destinations(page).getByRole('button', { name: 'Conversation', exact: true }).click();
207
+ const url = new URL(ownership.baseURL);
208
+ url.search = query;
209
+ url.searchParams.set('tab', ownership.tabs[0].id);
210
+ url.searchParams.set('custom', 'keep-recovery');
211
+ url.hash = 'recovery-fragment';
212
+ const historyLength = await page.evaluate(() => history.length);
213
+ await page.goto(url.href);
214
+ await expect(search(page)).toBeVisible();
215
+ await expectLocation(page, category);
216
+ expect(await page.evaluate(() => history.length)).toBe(historyLength + 1);
217
+ expect(new URL(page.url()).searchParams.get('custom')).toBe('keep-recovery');
218
+ expect(new URL(page.url()).hash).toBe('#recovery-fragment');
219
+ expect(await page.evaluate(() => history.state.settingsNavigationExternal)).toEqual({ keep: 'original history' });
220
+ await page.goBack();
221
+ await expect(page.locator('#focusedWorkspace')).toHaveAttribute('data-destination', 'conversation');
222
+ await page.goForward();
223
+ await expectLocation(page, category);
224
+ const currentSession = await ownership.api(`/api/state?tab=${encodeURIComponent(ownership.tabs[0].id)}`);
225
+ expect(currentSession.sessionId).toBe(initialSession.sessionId);
226
+ await expect(page.locator(`#tabBar [data-tab-id="${ownership.tabs[0].id}"] .terminal-tab-button`))
227
+ .toHaveAttribute('aria-selected', 'true');
228
+ expect(await preferenceSnapshot(page)).toEqual(before);
229
+ expect(writes).toEqual([]);
230
+ }
231
+ });
232
+
233
+ test('Settings search and canonical controls retain the composer draft through Classic and back', async ({ page, ownership }) => {
234
+ await openFocused(page, ownership);
235
+ const initialSession = await ownership.api(`/api/state?tab=${encodeURIComponent(ownership.tabs[0].id)}`);
236
+ const prompt = page.locator('#promptInput');
237
+ await prompt.fill('keep my Settings navigation draft');
238
+ await page.evaluate(() => {
239
+ window.settingsCanonicalControls = Object.fromEntries(['promptInput', 'sendButton', 'modelSelect', 'themeSelect', 'desktopShellSelect']
240
+ .map((id) => [id, document.getElementById(id)]));
241
+ document.querySelector('#promptInput').setSelectionRange(5, 14, 'backward');
242
+ });
243
+ await openSettings(page);
244
+ await revealTheme(page);
245
+ await search(page).fill('Theme');
246
+ await search(page).evaluate((input) => input.setSelectionRange(1, 4, 'backward'));
247
+ await destinations(page).getByRole('button', { name: 'Conversation', exact: true }).click();
248
+ await expect(prompt).toHaveValue('keep my Settings navigation draft');
249
+ await navigateFocused(page, 'Settings');
250
+ await expect(search(page)).toHaveValue('Theme');
251
+ expect(await search(page).evaluate((input) => [input.selectionStart, input.selectionEnd, input.selectionDirection]))
252
+ .toEqual([1, 4, 'backward']);
253
+ await search(page).press('Escape');
254
+ await expect(page.locator('#desktopShellSelect')).toBeVisible();
255
+ await page.locator('#desktopShellSelect').selectOption('classic');
256
+ await expect(page.locator('#focusedWorkspace')).toBeHidden();
257
+ await expect(prompt).toBeVisible();
258
+ await expect(prompt).toHaveValue('keep my Settings navigation draft');
259
+ // Classic restores the existing Controls section; open its disclosure through its own button if needed.
260
+ if (!await page.locator('#desktopShellSelect').isVisible()) {
261
+ await page.locator('#sidePanelSectionToggleControls').click();
262
+ }
263
+ await page.locator('#desktopShellSelect').selectOption('focused');
264
+ await expect(page.locator('#focusedWorkspace')).toBeVisible();
265
+ await openSettings(page);
266
+ await revealTheme(page);
267
+ expect(await page.evaluate(() => Object.entries(window.settingsCanonicalControls)
268
+ .every(([id, node]) => node === document.getElementById(id) && document.querySelectorAll(`#${id}`).length === 1))).toBe(true);
269
+ await destinations(page).getByRole('button', { name: 'Conversation', exact: true }).click();
270
+ await expect(prompt).toHaveValue('keep my Settings navigation draft');
271
+ await expect(page.locator('#sendButton')).toBeVisible();
272
+ await expect(page.locator('#modelSelect')).toBeAttached();
273
+ expect(await prompt.evaluate((input) => [input.selectionStart, input.selectionEnd, input.selectionDirection]))
274
+ .toEqual([5, 14, 'backward']);
275
+ expect((await ownership.api(`/api/state?tab=${encodeURIComponent(ownership.tabs[0].id)}`)).sessionId).toBe(initialSession.sessionId);
276
+ });
277
+
278
+ test('Back and Forward replace stale Settings anchors without adding history or applying settings', async ({ page, ownership }) => {
279
+ await openFocused(page, ownership, 'external=keep');
280
+ await openSettings(page);
281
+ const before = await preferenceSnapshot(page);
282
+ const writes = observePreferenceWrites(page);
283
+ for (const [inspector, setting, expectedCategory] of [
284
+ ['settings:resources', 'removed-setting', 'resources'],
285
+ ['settings:removed-category', 'theme', 'appearance'],
286
+ ]) {
287
+ await page.evaluate(({ inspector, setting }) => {
288
+ const url = new URL(location.href);
289
+ url.searchParams.set('view', 'settings');
290
+ url.searchParams.set('inspector', inspector);
291
+ url.searchParams.set('setting', setting);
292
+ url.hash = 'preserved-fragment';
293
+ history.replaceState({ ...history.state, externalKeep: 'yes', focusedShellState: { destination: 'settings', inspector, setting } }, '', url);
294
+ }, { inspector, setting });
295
+ await destinations(page).getByRole('button', { name: 'Conversation', exact: true }).click();
296
+ const length = await page.evaluate(() => history.length);
297
+ await page.goBack();
298
+ await expectLocation(page, expectedCategory);
299
+ expect(await page.evaluate(() => history.state.focusedShellState)).toEqual({ destination: 'settings', inspector: `settings:${expectedCategory}` });
300
+ expect(await page.evaluate(() => history.state.externalKeep)).toBe('yes');
301
+ expect(await page.evaluate(() => history.length)).toBe(length);
302
+ expect(new URL(page.url()).searchParams.get('external')).toBe('keep');
303
+ expect(new URL(page.url()).searchParams.get('tab')).toBe(ownership.tabs[0].id);
304
+ expect(new URL(page.url()).hash).toBe('#preserved-fragment');
305
+ await expect(page.locator('#nativeCommandDialog')).toBeHidden();
306
+ await page.goForward();
307
+ await expect(page.locator('#focusedWorkspace')).toHaveAttribute('data-destination', 'conversation');
308
+ await page.goBack();
309
+ await expectLocation(page, expectedCategory);
310
+ expect(await page.evaluate(() => history.state.focusedShellState)).toEqual({ destination: 'settings', inspector: `settings:${expectedCategory}` });
311
+ expect(await page.evaluate(() => history.length)).toBe(length);
312
+ }
313
+ expect(await preferenceSnapshot(page)).toEqual(before);
314
+ expect(writes).toEqual([]);
315
+ });
316
+
317
+ for (const width of [1100, 1440]) {
318
+ test(`sidebar Settings gear opens the canonical page at ${width}px`, async ({ page, ownership }, info) => {
319
+ await page.setViewportSize({ width, height: 900 });
320
+ await openFocused(page, ownership);
321
+ await page.locator('#promptInput').fill('Keep my settings draft');
322
+ const actions = page.locator('#focusedWorkspace .terminal-sidebar-actions');
323
+ const gear = actions.getByRole('button', { name: 'Settings', exact: true });
324
+ await expect(gear).toBeVisible();
325
+ const home = await actions.locator('#workspaceDashboardToggleButton').boundingBox();
326
+ const bounds = await gear.boundingBox();
327
+ expect(bounds.x).toBeGreaterThanOrEqual(home.x + home.width);
328
+ expect(Math.abs(bounds.y - home.y)).toBeLessThan(2);
329
+ await gear.focus();
330
+ await gear.press('Enter');
331
+ await expect(search(page)).toBeVisible();
332
+ await expectLocation(page, 'appearance');
333
+ await expect(gear).toHaveAttribute('aria-current', 'page');
334
+ await expect(page.locator('#desktopShellSelect')).toHaveCount(1);
335
+ await page.screenshot({ path: info.outputPath('settings-sidebar-gear.png') });
336
+ await page.goBack();
337
+ await expect(page.locator('#promptInput')).toBeVisible();
338
+ await expect(page.locator('#promptInput')).toHaveValue('Keep my settings draft');
339
+ await gear.click();
340
+ await page.locator('#focusedNavigationSelect').selectOption('top');
341
+ await expect(gear).toBeHidden();
342
+ await page.locator('#focusedNavigationSelect').selectOption('left');
343
+ await expect(gear).toBeVisible();
344
+ await page.locator('#desktopShellSelect').selectOption('classic');
345
+ await expect(page.locator('.terminal-settings-button')).toBeHidden();
346
+ await expect(page.locator('#promptInput')).toHaveValue('Keep my settings draft');
347
+ });
348
+ }