@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,386 @@
1
+ import assert from "node:assert/strict";
2
+ import { stripVTControlCharacters } from "node:util";
3
+ import { test } from "node:test";
4
+ import * as conversationMode from "../lib/server/conversation-mode.mjs";
5
+ import { OPTIONAL_FEATURE_BY_ID } from "../lib/optional-feature-catalog.mjs";
6
+
7
+ const { createConversationModeService, NATURAL_CONVERSATION_FEATURE_ID } = conversationMode;
8
+ const packageName = OPTIONAL_FEATURE_BY_ID.get(NATURAL_CONVERSATION_FEATURE_ID).packageName;
9
+ const requestTimeoutMs = 731;
10
+ const statusRpcTimeoutMs = 127;
11
+ const serviceNames = [
12
+ "naturalConversationStatusState", "naturalConversationModeSnapshot", "resetNaturalConversationMode",
13
+ "rememberNaturalConversationStatusEvent", "isNaturalConversationActive", "naturalConversationCommandBaseName",
14
+ "naturalConversationSlashCommandName", "isNaturalConversationSlashCommand", "blockNaturalConversationAction",
15
+ "ensureNaturalConversationRouteAllowed", "ensureNaturalConversationPromptSafety", "enforceNaturalConversationCommandAllowed",
16
+ "naturalConversationLoadedCommandNames", "rememberNaturalConversationCommands", "naturalConversationPackageStatus",
17
+ "naturalConversationFeatureData", "setNaturalConversationMode",
18
+ ];
19
+
20
+ function fixture(options = {}) {
21
+ const calls = [];
22
+ const packageStatus = { featureId: NATURAL_CONVERSATION_FEATURE_ID, packageName, installed: options.installed ?? false };
23
+ const response = options.response ?? { success: true, data: { accepted: true } };
24
+ const tab = {
25
+ id: "tab-a",
26
+ extensionStatuses: new Map(),
27
+ pendingThinkingLevel: "high",
28
+ rpc: {
29
+ async send(command, timeout) {
30
+ calls.push(["rpc", command, timeout]);
31
+ if (options.rpcError) throw options.rpcError;
32
+ return response;
33
+ },
34
+ },
35
+ };
36
+ let service;
37
+ service = createConversationModeService({
38
+ packageName,
39
+ async optionalFeaturePackageStatus(featureId) {
40
+ calls.push(["package", featureId]);
41
+ if (options.packageError) throw options.packageError;
42
+ return packageStatus;
43
+ },
44
+ async getCommandData(target, commandOptions) {
45
+ calls.push(["commands", target, commandOptions]);
46
+ if (options.commandError) throw options.commandError;
47
+ const commands = options.commands ?? [];
48
+ service.rememberNaturalConversationCommands(target, commands);
49
+ return { commands, rpcRunning: options.rpcRunning ?? true };
50
+ },
51
+ extensionStatusMap: (target) => target.extensionStatuses,
52
+ stripAnsi: (value) => stripVTControlCharacters(String(value ?? "")),
53
+ makeHttpError: (statusCode, message) => Object.assign(new Error(message), { statusCode }),
54
+ sanitizeError: (error) => `sanitized: ${error.message}`,
55
+ async safeRpcData(target, command, timeout) {
56
+ calls.push(["state", target, command, timeout]);
57
+ if (options.stateError) throw options.stateError;
58
+ return options.stateResult ?? { ok: true, data: {} };
59
+ },
60
+ stateIsBusyForSettings: (state) => !!(state?.isStreaming || state?.isCompacting),
61
+ async setThinkingLevelForTab(target, level, thinkingOptions) {
62
+ calls.push(["thinking", target, level, thinkingOptions]);
63
+ if (options.thinkingError) throw options.thinkingError;
64
+ return options.thinkingResponse ?? { success: true };
65
+ },
66
+ requestTimeoutMs,
67
+ statusRpcTimeoutMs,
68
+ });
69
+ return { service, tab, calls, packageStatus, response };
70
+ }
71
+
72
+ function statusEvent(service, tab, statusText) {
73
+ // The parent records extension status before notifying this service.
74
+ if (statusText) tab.extensionStatuses.set("natural-conversation", statusText);
75
+ else tab.extensionStatuses.delete("natural-conversation");
76
+ service.rememberNaturalConversationStatusEvent(tab, {
77
+ type: "extension_ui_request", method: "setStatus", statusKey: "natural-conversation", statusText,
78
+ });
79
+ }
80
+
81
+ function httpError(statusCode, message) {
82
+ return (error) => error.statusCode === statusCode && error.message === message;
83
+ }
84
+
85
+ const blockedMessage = (action) => `Natural Conversation Mode is active; ${action}. Leave the mode first with /talk off.`;
86
+
87
+ test("factory exports the C1 contract and defers every dependency until use", { timeout: 1_000 }, async () => {
88
+ assert.deepEqual(Object.keys(conversationMode).sort(), ["NATURAL_CONVERSATION_FEATURE_ID", "createConversationModeService"]);
89
+ assert.equal(NATURAL_CONVERSATION_FEATURE_ID, "naturalConversation");
90
+ const { service, calls } = fixture();
91
+ assert.deepEqual(Object.keys(service).sort(), [...serviceNames].sort());
92
+ assert.deepEqual(calls, []);
93
+ let discovery;
94
+ const lateService = createConversationModeService({
95
+ getCommandData: (...args) => discovery(...args),
96
+ optionalFeaturePackageStatus: async () => ({ installed: false }),
97
+ extensionStatusMap: (tab) => tab.extensionStatuses,
98
+ stripAnsi: String,
99
+ });
100
+ const tab = { extensionStatuses: new Map() };
101
+ discovery = async (target, options) => {
102
+ assert.equal(target, tab);
103
+ assert.deepEqual(options, { annotateSkills: false });
104
+ lateService.rememberNaturalConversationCommands(target, [{ name: "talk" }]);
105
+ return { rpcRunning: true };
106
+ };
107
+ assert.equal((await lateService.naturalConversationFeatureData(tab)).available, true);
108
+ });
109
+
110
+ test("status parsing preserves ANSI stripping, whitespace, arbitrary status and voice states", () => {
111
+ const { service } = fixture();
112
+ for (const [input, expected] of [
113
+ [undefined, { enabled: false, uiState: "off", statusText: "" }],
114
+ [" \n\t ", { enabled: false, uiState: "off", statusText: "" }],
115
+ ["\u001b[32mVoice: SPEAKING\u001b[0m\n ready", { enabled: true, uiState: "speaking", statusText: "Voice: SPEAKING ready" }],
116
+ ["connected", { enabled: true, uiState: "listening", statusText: "connected" }],
117
+ ["Voice : waiting_2-test", { enabled: true, uiState: "waiting_2-test", statusText: "Voice : waiting_2-test" }],
118
+ ]) assert.deepEqual(service.naturalConversationStatusState(input), expected);
119
+ });
120
+
121
+ test("snapshots retain real tab metadata and prefer extension status over previous status", () => {
122
+ const { service, tab } = fixture();
123
+ const snapshot = service.naturalConversationModeSnapshot(tab, { updatedAt: "fixed" });
124
+ assert.deepEqual(snapshot, {
125
+ featureId: NATURAL_CONVERSATION_FEATURE_ID, available: false, enabled: false, uiState: "off", statusText: "",
126
+ allowedTools: ["read", "grep", "find", "ls"], provider: "browser-shell", startedAt: null,
127
+ packageInstalled: false, loadedCommands: [], updatedAt: "fixed",
128
+ });
129
+ assert.equal(tab.conversationMode, undefined);
130
+ tab.conversationMode = { ...snapshot, enabled: true };
131
+ assert.equal(service.isNaturalConversationActive(tab), false, "the enabled field alone does not replace status semantics");
132
+ tab.conversationMode = { ...snapshot, statusText: "Voice: listening", provider: "custom", startedAt: "start", allowedTools: ["read"], loadedCommands: ["voice"] };
133
+ tab.extensionStatuses.set("natural-conversation", "Voice: speaking");
134
+ assert.deepEqual(service.naturalConversationModeSnapshot(tab), { ...tab.conversationMode, enabled: true, uiState: "speaking", statusText: "Voice: speaking" });
135
+ assert.deepEqual(service.naturalConversationModeSnapshot(tab, { enabled: false, allowedTools: [], loadedCommands: [], provider: "override", startedAt: null }), {
136
+ ...tab.conversationMode, enabled: false, uiState: "off", statusText: "Voice: speaking", allowedTools: [], loadedCommands: [], provider: "override",
137
+ });
138
+ });
139
+
140
+ test("status events, command discovery and reset mutate the supplied tab only", () => {
141
+ const { service, tab } = fixture();
142
+ for (const event of [null, {}, { type: "extension_ui_request", method: "notify", statusKey: "natural-conversation" },
143
+ { type: "extension_ui_request", method: "setStatus", statusKey: "another" }]) {
144
+ service.rememberNaturalConversationStatusEvent(tab, event);
145
+ assert.equal(tab.conversationMode, undefined);
146
+ }
147
+ statusEvent(service, tab, "Voice: listening");
148
+ assert.equal(tab.conversationMode.available, true);
149
+ assert.deepEqual(tab.conversationMode.loadedCommands, ["talk"]);
150
+ assert.equal(service.isNaturalConversationActive(tab), true);
151
+ service.rememberNaturalConversationCommands(tab, [{ name: "voice:2" }]);
152
+ statusEvent(service, tab, "Voice: speaking");
153
+ assert.deepEqual(tab.conversationMode.loadedCommands, ["voice"]);
154
+ statusEvent(service, tab, "");
155
+ assert.equal(service.isNaturalConversationActive(tab), false);
156
+ assert.equal(tab.conversationMode.available, true);
157
+ tab.conversationMode.packageInstalled = true;
158
+ tab.extensionStatuses.clear();
159
+ service.resetNaturalConversationMode(tab);
160
+ assert.equal(tab.conversationMode.available, false);
161
+ assert.equal(tab.conversationMode.enabled, false);
162
+ assert.equal(tab.conversationMode.uiState, "off");
163
+ assert.equal(tab.conversationMode.statusText, "");
164
+ assert.equal(tab.conversationMode.packageInstalled, true);
165
+ assert.deepEqual(tab.conversationMode.loadedCommands, []);
166
+ assert.equal(service.isNaturalConversationActive({ extensionStatuses: new Map() }), false);
167
+ assert.equal(service.resetNaturalConversationMode(null), undefined);
168
+ });
169
+
170
+ test("command names normalize numeric suffixes and deduplicate in discovery order", () => {
171
+ const { service } = fixture();
172
+ assert.deepEqual(service.naturalConversationLoadedCommandNames([
173
+ null, {}, { name: " Talk:12 " }, { name: "talk" }, { invokeName: "VOICE:2" },
174
+ { name: "conversation:0" }, { name: "voice:abc" }, { name: "other", invokeName: "talk" },
175
+ { name: "/talk" }, { name: "talk:1:2" },
176
+ ]), ["talk", "voice", "conversation"]);
177
+ assert.deepEqual(service.naturalConversationLoadedCommandNames(null), []);
178
+ assert.deepEqual(service.naturalConversationLoadedCommandNames(), []);
179
+ for (const [input, expected] of [[" Talk:12 ", "talk"], ["voice:abc", "voice:abc"], ["talk:1:2", "talk:1"], [null, ""]]) {
180
+ assert.equal(service.naturalConversationCommandBaseName(input), expected);
181
+ }
182
+ for (const name of ["talk", "voice", "conversation"]) {
183
+ assert.equal(service.naturalConversationSlashCommandName(` /${name.toUpperCase()}:42 off`), name);
184
+ assert.equal(service.isNaturalConversationSlashCommand(` /${name}:42 off`), true);
185
+ }
186
+ for (const message of ["talk", "/talk:abc", "/talking", "/voice:1:2", "/", "", null]) {
187
+ assert.equal(service.isNaturalConversationSlashCommand(message), false);
188
+ }
189
+ });
190
+
191
+ for (const installed of [false, true]) {
192
+ for (const loaded of [false, true]) {
193
+ for (const active of [false, true]) {
194
+ test(`feature data: installed=${installed}, loaded=${loaded}, status=${active}`, { timeout: 1_000 }, async () => {
195
+ const { service, tab, calls, packageStatus } = fixture({ installed, commands: loaded ? [{ name: "voice:3" }] : [] });
196
+ if (active) statusEvent(service, tab, "Voice: speaking");
197
+ const data = await service.naturalConversationFeatureData(tab);
198
+ assert.equal(data.featureId, NATURAL_CONVERSATION_FEATURE_ID);
199
+ assert.equal(data.packageName, packageName);
200
+ assert.equal(data.packageStatus, packageStatus);
201
+ assert.equal(data.available, loaded);
202
+ assert.equal(data.packageInstalled, installed);
203
+ assert.deepEqual(data.commands, loaded ? ["voice"] : []);
204
+ assert.equal(data.mode.available, loaded);
205
+ assert.equal(data.mode.enabled, active);
206
+ assert.equal(data.rpcRunning, true);
207
+ assert.equal(data.error, undefined);
208
+ assert.equal(data.unavailableReason, loaded ? "" : installed
209
+ ? "Natural Conversation package is installed, but /talk is not loaded in the active Pi tab. Reload the tab or enable the package extension."
210
+ : "Natural Conversation package is not installed or not visible from the Web UI package root.");
211
+ assert.deepEqual(calls, [["commands", tab, { annotateSkills: false }], ["package", NATURAL_CONVERSATION_FEATURE_ID]]);
212
+ });
213
+ }
214
+ }
215
+ }
216
+
217
+ test("package and command failures keep their distinct payloads and sanitized errors", { timeout: 1_000 }, async () => {
218
+ const { service, tab, calls } = fixture({ packageError: new Error("package failed"), commandError: new Error("commands failed") });
219
+ service.rememberNaturalConversationCommands(tab, [{ name: "talk" }]);
220
+ const data = await service.naturalConversationFeatureData(tab);
221
+ assert.deepEqual(data.packageStatus, { featureId: NATURAL_CONVERSATION_FEATURE_ID, packageName, installed: false, error: "sanitized: package failed" });
222
+ assert.equal(data.error, "sanitized: commands failed");
223
+ assert.equal(data.rpcRunning, false);
224
+ assert.equal(data.available, false);
225
+ assert.deepEqual(tab.conversationMode.loadedCommands, []);
226
+ calls.length = 0;
227
+ const cached = await service.naturalConversationFeatureData(tab, { refreshCommands: false });
228
+ assert.equal(cached.rpcRunning, true, "no refresh retains the existing optimistic RPC indicator");
229
+ assert.equal(cached.error, undefined);
230
+ assert.deepEqual(calls, [["package", NATURAL_CONVERSATION_FEATURE_ID]]);
231
+ const stopped = fixture({ rpcRunning: false });
232
+ assert.equal((await stopped.service.naturalConversationFeatureData(stopped.tab)).rpcRunning, false);
233
+ });
234
+
235
+ test("active command and route guards preserve the exact allowlist and errors", () => {
236
+ const { service, tab } = fixture();
237
+ assert.doesNotThrow(() => service.ensureNaturalConversationRouteAllowed(tab, "file deletion is blocked"));
238
+ assert.doesNotThrow(() => service.enforceNaturalConversationCommandAllowed(tab, { type: "bash" }));
239
+ statusEvent(service, tab, "Voice: listening");
240
+ assert.throws(() => service.ensureNaturalConversationRouteAllowed(tab, "file deletion is blocked"), httpError(409, blockedMessage("file deletion is blocked")));
241
+ for (const command of [
242
+ { type: "prompt", message: "hello" }, { type: "prompt", message: "/" },
243
+ ...["talk", "voice", "conversation"].map((name) => ({ type: "prompt", message: ` /${name.toUpperCase()}:2 off` })),
244
+ { type: "steer", message: "/bash retained existing policy" }, { type: "follow_up", message: "/other" },
245
+ { type: "abort" }, { type: "abort_bash" }, { type: "set_thinking_level", level: "off" },
246
+ ]) assert.doesNotThrow(() => service.enforceNaturalConversationCommandAllowed(tab, command));
247
+ for (const type of ["get_state", "get_commands", "set_model", "bash", "new_session", "set_config", "unknown", "", undefined]) {
248
+ assert.throws(() => service.enforceNaturalConversationCommandAllowed(tab, { type }), httpError(409, blockedMessage(`${type || "this action"} is blocked`)));
249
+ }
250
+ assert.throws(() => service.enforceNaturalConversationCommandAllowed(tab, null), httpError(409, blockedMessage("this action is blocked")));
251
+ for (const level of ["high", "OFF", "", undefined]) {
252
+ assert.throws(() => service.enforceNaturalConversationCommandAllowed(tab, { type: "set_thinking_level", level }), httpError(409, blockedMessage("thinking is forced off")));
253
+ }
254
+ for (const message of ["/bash hi", "/talking off", "/talk:abc off", "/talk:2:3 off"]) {
255
+ assert.throws(() => service.enforceNaturalConversationCommandAllowed(tab, { type: "prompt", message }), httpError(409, blockedMessage("slash commands are blocked from the Web UI shell")));
256
+ }
257
+ });
258
+
259
+ for (const type of ["prompt", "steer", "follow_up"]) {
260
+ test(`${type} clears pending thinking and forces off when idle or state is unavailable`, { timeout: 1_000 }, async () => {
261
+ for (const stateResult of [{ ok: true, data: {} }, { ok: false, error: "unavailable" }]) {
262
+ const { service, tab, calls } = fixture({ stateResult });
263
+ statusEvent(service, tab, "Voice: listening");
264
+ assert.equal(await service.ensureNaturalConversationPromptSafety(tab, { type }), null);
265
+ assert.equal(tab.pendingThinkingLevel, undefined);
266
+ assert.deepEqual(calls, [
267
+ ["state", tab, { type: "get_state" }, statusRpcTimeoutMs],
268
+ ["thinking", tab, "off", { allowPending: false }],
269
+ ]);
270
+ }
271
+ });
272
+ test(`${type} skips thinking mutation while streaming or compacting`, { timeout: 1_000 }, async () => {
273
+ for (const data of [{ isStreaming: true }, { isCompacting: true }]) {
274
+ const { service, tab, calls } = fixture({ stateResult: { ok: true, data } });
275
+ statusEvent(service, tab, "Voice: listening");
276
+ assert.equal(await service.ensureNaturalConversationPromptSafety(tab, { type }), null);
277
+ assert.equal(tab.pendingThinkingLevel, undefined);
278
+ assert.deepEqual(calls, [["state", tab, { type: "get_state" }, statusRpcTimeoutMs]]);
279
+ }
280
+ });
281
+ }
282
+
283
+ test("prompt safety is inert outside mode or prompt commands and preserves failure responses", { timeout: 1_000 }, async () => {
284
+ const inactive = fixture();
285
+ assert.equal(await inactive.service.ensureNaturalConversationPromptSafety(inactive.tab, { type: "prompt" }), null);
286
+ assert.equal(inactive.tab.pendingThinkingLevel, "high");
287
+ assert.deepEqual(inactive.calls, []);
288
+ statusEvent(inactive.service, inactive.tab, "Voice: listening");
289
+ for (const command of [null, { type: "abort" }, { type: "abort_bash" }, { type: "set_thinking_level", level: "off" }]) {
290
+ assert.equal(await inactive.service.ensureNaturalConversationPromptSafety(inactive.tab, command), null);
291
+ }
292
+ assert.equal(inactive.tab.pendingThinkingLevel, "high");
293
+ assert.deepEqual(inactive.calls, []);
294
+ const failure = { success: false, error: "cannot change thinking", data: { retained: true } };
295
+ const failed = fixture({ thinkingResponse: failure });
296
+ statusEvent(failed.service, failed.tab, "Voice: listening");
297
+ assert.equal(await failed.service.ensureNaturalConversationPromptSafety(failed.tab, { type: "prompt" }), failure);
298
+ for (const errorKey of ["thinkingError", "stateError"]) {
299
+ const error = new Error(errorKey);
300
+ const rejected = fixture({ [errorKey]: error });
301
+ statusEvent(rejected.service, rejected.tab, "Voice: listening");
302
+ await assert.rejects(rejected.service.ensureNaturalConversationPromptSafety(rejected.tab, { type: "prompt" }), (actual) => actual === error);
303
+ }
304
+ });
305
+
306
+ test("mode enable prefers talk, sends bounded RPC and retains the existing optimistic snapshot", { timeout: 1_000 }, async () => {
307
+ const { service, tab, calls, response } = fixture({ commands: [{ name: "voice:1" }, { name: "talk:2" }] });
308
+ const data = await service.setNaturalConversationMode(tab, { enabled: true });
309
+ assert.deepEqual(calls, [
310
+ ["commands", tab, { annotateSkills: false }], ["package", NATURAL_CONVERSATION_FEATURE_ID],
311
+ ["rpc", { type: "prompt", message: "/talk on" }, requestTimeoutMs],
312
+ ["thinking", tab, "off", { allowPending: false }], ["package", NATURAL_CONVERSATION_FEATURE_ID],
313
+ ]);
314
+ assert.equal(data.response, response);
315
+ assert.equal(data.available, true);
316
+ assert.equal(data.packageInstalled, false);
317
+ assert.equal(data.mode.enabled, true);
318
+ assert.equal(data.mode.uiState, "listening");
319
+ assert.equal(data.mode.statusText, "Voice: listening");
320
+ assert.match(data.mode.startedAt, /^\d{4}-\d{2}-\d{2}T/);
321
+ assert.equal(tab.pendingThinkingLevel, undefined);
322
+ assert.equal(tab.extensionStatuses.size, 0, "prompt acceptance creates no extension status or provider proof");
323
+ const startedAt = data.mode.startedAt;
324
+ assert.equal((await service.setNaturalConversationMode(tab, { enabled: true })).mode.startedAt, startedAt);
325
+ });
326
+
327
+ test("mode disable and default body use the first discovered fallback and skip thinking changes", { timeout: 1_000 }, async () => {
328
+ for (const body of [undefined, { enabled: false }, { enabled: "true" }]) {
329
+ const { service, tab, calls } = fixture({ installed: true, commands: [{ name: "conversation:4" }, { name: "voice:1" }] });
330
+ tab.conversationMode = { statusText: "Voice: listening", startedAt: "existing-start" };
331
+ const data = await service.setNaturalConversationMode(tab, body);
332
+ assert.deepEqual(calls.filter(([kind]) => kind === "rpc"), [["rpc", { type: "prompt", message: "/conversation off" }, requestTimeoutMs]]);
333
+ assert.equal(calls.some(([kind]) => kind === "thinking"), false);
334
+ assert.equal(tab.pendingThinkingLevel, "high");
335
+ assert.equal(data.mode.enabled, false);
336
+ assert.equal(data.mode.uiState, "off");
337
+ assert.equal(data.mode.statusText, "");
338
+ assert.equal(data.mode.startedAt, "existing-start", "null patches retain the existing start timestamp");
339
+ assert.equal(data.packageInstalled, true);
340
+ }
341
+ });
342
+
343
+ test("mode mutation preserves status precedence until the parent clears the extension status", { timeout: 1_000 }, async () => {
344
+ const { service, tab } = fixture({ commands: [{ name: "talk" }] });
345
+ statusEvent(service, tab, "Voice: speaking");
346
+ const data = await service.setNaturalConversationMode(tab, { enabled: false });
347
+ assert.equal(data.mode.enabled, true);
348
+ assert.equal(data.mode.uiState, "speaking");
349
+ statusEvent(service, tab, "");
350
+ assert.equal(service.isNaturalConversationActive(tab), false);
351
+ });
352
+
353
+ test("unavailable mode refuses mutation without sending a prompt", { timeout: 1_000 }, async () => {
354
+ for (const installed of [false, true]) {
355
+ const { service, tab, calls } = fixture({ installed });
356
+ const feature = await service.naturalConversationFeatureData(tab);
357
+ await assert.rejects(service.setNaturalConversationMode(tab, { enabled: true }), httpError(404, feature.unavailableReason));
358
+ assert.equal(calls.some(([kind]) => ["rpc", "thinking"].includes(kind)), false);
359
+ }
360
+ });
361
+
362
+ test("mode RPC failures preserve errors and do not enable mode or force thinking", { timeout: 1_000 }, async () => {
363
+ for (const enabled of [false, true]) {
364
+ for (const error of ["extension refused", undefined]) {
365
+ const { service, tab, calls } = fixture({ commands: [{ name: "talk" }], response: { success: false, error } });
366
+ await assert.rejects(service.setNaturalConversationMode(tab, { enabled }), httpError(400, error || `Failed to ${enabled ? "enable" : "disable"} Natural Conversation Mode`));
367
+ assert.equal(service.isNaturalConversationActive(tab), false);
368
+ assert.equal(tab.pendingThinkingLevel, "high");
369
+ assert.equal(calls.some(([kind]) => kind === "thinking"), false);
370
+ }
371
+ }
372
+ const rpcError = new Error("RPC disconnected");
373
+ const rejected = fixture({ commands: [{ name: "talk" }], rpcError });
374
+ await assert.rejects(rejected.service.setNaturalConversationMode(rejected.tab, { enabled: true }), (error) => error === rpcError);
375
+ assert.equal(rejected.service.isNaturalConversationActive(rejected.tab), false);
376
+ });
377
+
378
+ test("mode enable retains existing best-effort thinking behavior", { timeout: 1_000 }, async () => {
379
+ for (const options of [{ thinkingError: new Error("RPC failed") }, { thinkingResponse: { success: false, error: "refused" } }]) {
380
+ const { service, tab, response } = fixture({ ...options, commands: [{ name: "talk" }] });
381
+ const data = await service.setNaturalConversationMode(tab, { enabled: true });
382
+ assert.equal(data.response, response);
383
+ assert.equal(data.mode.enabled, true);
384
+ assert.equal(tab.pendingThinkingLevel, undefined);
385
+ }
386
+ });