@kabmo-labs/kabmo 0.27.0 → 0.28.0

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 (303) hide show
  1. package/dist/client/index.html +1 -1
  2. package/dist/client/index.js +495 -467
  3. package/dist/client/static/js/index-81f7berm.css +1 -0
  4. package/dist/client/static/js/{index-e3qh2yps.js → index-xzvyrxya.js} +795 -795
  5. package/marketplace/plugins/command-runner/package.json +3 -17
  6. package/marketplace/plugins/command-runner/settings-schema.json +14 -0
  7. package/marketplace/plugins/git-forge/README.md +17 -7
  8. package/marketplace/plugins/git-forge/package.json +4 -30
  9. package/marketplace/plugins/git-forge/panel.css +16 -0
  10. package/marketplace/plugins/git-forge/settings-schema.json +27 -0
  11. package/marketplace/plugins/git-forge/src/panel/Badge.tsx +35 -22
  12. package/marketplace/plugins/git-forge/src/panel/Change.tsx +20 -24
  13. package/marketplace/plugins/git-forge/src/panel/CiBadge.tsx +16 -7
  14. package/marketplace/plugins/git-forge/src/panel/Credential.tsx +31 -26
  15. package/marketplace/plugins/git-forge/src/panel/Glyph.tsx +18 -2
  16. package/marketplace/plugins/git-forge/src/panel/Header.tsx +160 -96
  17. package/marketplace/plugins/git-forge/src/panel/ItemView.tsx +60 -44
  18. package/marketplace/plugins/git-forge/src/panel/List.tsx +150 -22
  19. package/marketplace/plugins/git-forge/src/panel/Row.tsx +11 -5
  20. package/marketplace/plugins/git-forge/src/panel/Sidebar.tsx +17 -15
  21. package/marketplace/plugins/git-forge/src/panel/Write.tsx +84 -61
  22. package/marketplace/plugins/git-forge/src/panel/format.test.ts +99 -0
  23. package/marketplace/plugins/git-forge/src/panel/format.ts +59 -16
  24. package/marketplace/plugins/git-forge/src/panel/index.test.tsx +109 -5
  25. package/marketplace/plugins/git-forge/src/panel/index.tsx +37 -4
  26. package/marketplace/plugins/git-forge/src/panel/use-forge.ts +17 -0
  27. package/marketplace/plugins/git-forge/src/panel/write.test.tsx +31 -0
  28. package/marketplace/plugins/session-info/package.json +2 -10
  29. package/marketplace/plugins/session-info/settings-schema.json +8 -0
  30. package/marketplace/plugins/stats/README.md +17 -5
  31. package/marketplace/plugins/stats/package.json +3 -23
  32. package/marketplace/plugins/stats/settings-schema.json +20 -0
  33. package/marketplace/plugins/stats/src/app.tsx +1 -1
  34. package/marketplace/plugins/stats/src/groups.test.ts +46 -1
  35. package/marketplace/plugins/stats/src/groups.ts +22 -11
  36. package/marketplace/plugins/stats/src/harness-leases.test.ts +84 -0
  37. package/marketplace/plugins/stats/src/harness-leases.ts +132 -0
  38. package/marketplace/plugins/stats/src/labels.test.ts +54 -1
  39. package/marketplace/plugins/stats/src/labels.ts +33 -7
  40. package/marketplace/plugins/stats/src/sampler.test.ts +61 -0
  41. package/marketplace/plugins/stats/src/sampler.ts +39 -5
  42. package/marketplace/plugins/stats/src/snapshot.ts +6 -0
  43. package/package.json +2 -2
  44. package/src/client/components/common/harness-glyph/index.tsx +18 -1
  45. package/src/client/components/common/session-actions-menu/index.test.tsx +106 -0
  46. package/src/client/components/common/session-actions-menu/index.tsx +43 -1
  47. package/src/client/components/common/session-row/TrailingSlot.tsx +9 -4
  48. package/src/client/components/common/session-row/index.tsx +4 -0
  49. package/src/client/components/common/session-row/session-row.test.tsx +6 -0
  50. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +2 -1
  51. package/src/client/components/layout/session-sidebar/SessionItem.tsx +9 -1
  52. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +2 -1
  53. package/src/client/components/layout/session-sidebar/scheduler-modal/ModelFields.tsx +202 -0
  54. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskForm.tsx +80 -19
  55. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskList.tsx +23 -3
  56. package/src/client/components/layout/session-sidebar/scheduler-modal/index.tsx +3 -0
  57. package/src/client/components/mobile/mobile-right-sidebar/EditorSurface.tsx +156 -0
  58. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +41 -86
  59. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +2 -1
  60. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.test.ts +6 -0
  61. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +9 -1
  62. package/src/client/components/settings/Modal.tsx +6 -2
  63. package/src/client/components/settings/Sidebar.tsx +30 -3
  64. package/src/client/components/settings/categories/HarnessSettings.tsx +11 -7
  65. package/src/client/components/settings/categories/NotificationSettings.test.tsx +40 -15
  66. package/src/client/components/settings/categories/NotificationSettings.tsx +142 -64
  67. package/src/client/components/settings/categories/PanelPluginSettings.tsx +1 -1
  68. package/src/client/components/settings/categories/harness-settings/CustomHarnessForm.tsx +186 -0
  69. package/src/client/components/settings/categories/panel-plugins/InstalledList.tsx +11 -0
  70. package/src/client/components/settings/categories/panel-plugins/PluginCard.test.tsx +1 -0
  71. package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +15 -1
  72. package/src/client/components/settings/categories/panel-plugins/SettingsModal.test.tsx +165 -0
  73. package/src/client/components/settings/categories/panel-plugins/SettingsModal.tsx +260 -0
  74. package/src/client/components/workspace/chat-timeline/AiMessageFooter.fork.test.ts +24 -0
  75. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +8 -4
  76. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +34 -0
  77. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +3 -2
  78. package/src/client/components/workspace/chat-timeline/MessageItem.fork.test.ts +80 -0
  79. package/src/client/components/workspace/chat-timeline/MessageItem.tsx +9 -3
  80. package/src/client/components/workspace/chat-timeline/MessageList.tsx +3 -1
  81. package/src/client/components/workspace/chat-timeline/RunFooter.tsx +2 -1
  82. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +2 -1
  83. package/src/client/components/workspace/chat-timeline/chat-input/ComposerRows.tsx +8 -0
  84. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.test.tsx +9 -0
  85. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.tsx +4 -1
  86. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +24 -0
  87. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.tsx +13 -20
  88. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +2 -0
  89. package/src/client/components/workspace/chat-timeline/chat-input/props.ts +5 -5
  90. package/src/client/components/workspace/chat-timeline/index.tsx +11 -5
  91. package/src/client/components/workspace/chat-timeline/target-picker/DraftTargetRow.tsx +1 -9
  92. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.test.tsx +101 -0
  93. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.tsx +2 -2
  94. package/src/client/components/workspace/editor/FilePane.tsx +9 -4
  95. package/src/client/components/workspace/editor/Notices.tsx +2 -2
  96. package/src/client/components/workspace/editor/Pane.tsx +2 -2
  97. package/src/client/components/workspace/editor/Toolbar.tsx +16 -10
  98. package/src/client/components/workspace/editor/index.tsx +6 -10
  99. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +4 -3
  100. package/src/client/components/workspace/editor/toolbar-clusters.tsx +23 -14
  101. package/src/client/components/workspace/terminal-panel/RealtimeTerminalView.tsx +9 -1
  102. package/src/client/components/workspace/terminal-panel/focus.test.ts +70 -0
  103. package/src/client/components/workspace/terminal-panel/focus.ts +46 -0
  104. package/src/client/components/workspace/terminal-panel/index.tsx +14 -1
  105. package/src/client/components/workspace/terminal-panel/mount.ts +17 -9
  106. package/src/client/components/workspace/terminal-panel/scroll-hold.test.ts +158 -0
  107. package/src/client/components/workspace/terminal-panel/scroll-hold.ts +136 -0
  108. package/src/client/hooks/chat/composer/use-draft.ts +45 -1
  109. package/src/client/hooks/chat/omp/pending-sessions.waiting.test.ts +11 -10
  110. package/src/client/hooks/chat/omp/pending-waiting.ts +15 -7
  111. package/src/client/hooks/chat/omp/prompt-send.test.ts +11 -0
  112. package/src/client/hooks/chat/omp/prompt-send.ts +3 -0
  113. package/src/client/hooks/chat/timeline/actions.ts +4 -4
  114. package/src/client/hooks/chat/timeline/composer-modes.ts +13 -2
  115. package/src/client/hooks/chat/timeline/fork-open.ts +52 -0
  116. package/src/client/hooks/chat/timeline/index.ts +5 -2
  117. package/src/client/hooks/chat/timeline/mode-availability.ts +7 -0
  118. package/src/client/hooks/chat/timeline/modes-contract.ts +6 -0
  119. package/src/client/hooks/chat/timeline/modes-hydrate.ts +93 -0
  120. package/src/client/hooks/chat/timeline/modes.ts +32 -52
  121. package/src/client/hooks/chat/timeline/new-chat-open.ts +7 -6
  122. package/src/client/hooks/chat/timeline/new-chat.ts +10 -1
  123. package/src/client/hooks/chat/timeline/pending-dispatch.ts +4 -0
  124. package/src/client/hooks/chat/timeline/pending-session-mode.test.ts +136 -0
  125. package/src/client/hooks/chat/timeline/pending-session-mode.ts +69 -0
  126. package/src/client/hooks/chat/timeline/pending-warmup.test.ts +147 -0
  127. package/src/client/hooks/chat/timeline/pending-warmup.ts +62 -0
  128. package/src/client/hooks/chat/timeline/run-identity.test.ts +12 -0
  129. package/src/client/hooks/chat/timeline/run-identity.ts +4 -1
  130. package/src/client/hooks/chat/timeline/send-props.ts +2 -0
  131. package/src/client/hooks/chat/timeline/send-steer.test.ts +1 -0
  132. package/src/client/hooks/chat/timeline/send.test-util.ts +1 -0
  133. package/src/client/hooks/chat/timeline/send.test.ts +1 -0
  134. package/src/client/hooks/chat/timeline/session-harness.ts +4 -0
  135. package/src/client/hooks/chat/timeline/use-fork-session.ts +9 -22
  136. package/src/client/hooks/chat/waiting/cancel.ts +13 -6
  137. package/src/client/hooks/chat/waiting/choice.ts +13 -16
  138. package/src/client/hooks/chat/waiting/composer-wait.ts +70 -0
  139. package/src/client/hooks/chat/waiting/dispatch.ts +48 -28
  140. package/src/client/hooks/chat/waiting/held.ts +37 -13
  141. package/src/client/hooks/chat/waiting/hold.test.ts +22 -0
  142. package/src/client/hooks/chat/waiting/hold.ts +20 -11
  143. package/src/client/hooks/chat/waiting/restore.test.ts +69 -0
  144. package/src/client/hooks/chat/waiting/restore.ts +34 -0
  145. package/src/client/hooks/chat/waiting/store.ts +9 -3
  146. package/src/client/hooks/editor/file-editor-types.ts +21 -12
  147. package/src/client/hooks/editor/save-file.test.ts +1 -1
  148. package/src/client/hooks/editor/save-file.ts +35 -8
  149. package/src/client/hooks/editor/target-key.ts +17 -0
  150. package/src/client/hooks/editor/use-disk-digest.test.ts +82 -0
  151. package/src/client/hooks/editor/use-disk-digest.ts +164 -0
  152. package/src/client/hooks/editor/use-disk-sync.ts +212 -0
  153. package/src/client/hooks/editor/use-file-cache.ts +113 -0
  154. package/src/client/hooks/editor/use-file-editor.test.ts +90 -0
  155. package/src/client/hooks/editor/use-file-editor.ts +90 -52
  156. package/src/client/hooks/editor/use-file-read.ts +24 -10
  157. package/src/client/hooks/editor/use-file-writes.ts +4 -4
  158. package/src/client/hooks/models/harness-catalog.ts +15 -0
  159. package/src/client/hooks/ui/notifications.ts +17 -8
  160. package/src/client/hooks/workspace/panel-registry.ts +1 -1
  161. package/src/client/hooks/workspace/scheduled-tasks.ts +26 -11
  162. package/src/client/lib/notifications/os.test.ts +1 -30
  163. package/src/client/lib/notifications/os.ts +0 -15
  164. package/src/client/lib/notifications/platform.test.ts +68 -0
  165. package/src/client/lib/notifications/platform.ts +36 -0
  166. package/src/server/index.ts +7 -0
  167. package/src/server/lib/harness/acp/client.ts +81 -87
  168. package/src/server/lib/harness/acp/prewarm.server.ts +237 -0
  169. package/src/server/lib/harness/acp/prewarm.test.ts +171 -0
  170. package/src/server/lib/harness/acp/prompt.test.ts +70 -1
  171. package/src/server/lib/harness/acp/prompt.ts +32 -1
  172. package/src/server/lib/harness/acp/protocol.ts +23 -0
  173. package/src/server/lib/harness/acp/session-handshake.test.ts +26 -0
  174. package/src/server/lib/harness/acp/session-handshake.ts +22 -20
  175. package/src/server/lib/harness/acp/session-options.ts +16 -0
  176. package/src/server/lib/harness/acp/session-process.ts +43 -0
  177. package/src/server/lib/harness/acp/session.ts +11 -12
  178. package/src/server/lib/harness/acp/stdio.ts +129 -0
  179. package/src/server/lib/harness/acp/verbs.test.ts +97 -0
  180. package/src/server/lib/harness/acp/verbs.ts +16 -6
  181. package/src/server/lib/harness/auto-probe.server.ts +4 -3
  182. package/src/server/lib/harness/capabilities.ts +8 -0
  183. package/src/server/lib/harness/config.server.ts +3 -2
  184. package/src/server/lib/harness/custom.server.ts +209 -0
  185. package/src/server/lib/harness/launch.ts +6 -1
  186. package/src/server/lib/harness/register.server.ts +8 -1
  187. package/src/server/lib/harness/schema.server.ts +21 -0
  188. package/src/server/lib/harness/session-lease.server.test.ts +99 -0
  189. package/src/server/lib/harness/session-lease.server.ts +193 -0
  190. package/src/server/lib/harness/session-store.server.test.ts +8 -8
  191. package/src/server/lib/harness/session-store.server.ts +25 -4
  192. package/src/server/lib/harness/session-title.server.ts +12 -2
  193. package/src/server/lib/harness/spawn.server.ts +123 -20
  194. package/src/server/lib/harness/update-queue.server.ts +3 -3
  195. package/src/server/lib/lifecycle/after-listen.ts +12 -1
  196. package/src/server/lib/lifecycle/paths.ts +19 -1
  197. package/src/server/lib/mcp/registry.server.ts +155 -0
  198. package/src/server/lib/mcp/registry.test.ts +169 -0
  199. package/src/server/lib/mcp/store.server.ts +38 -0
  200. package/src/server/lib/omp/rpc/frame-fold-contract.ts +59 -0
  201. package/src/server/lib/omp/rpc/frame-fold-frames.test.ts +64 -1
  202. package/src/server/lib/omp/rpc/frame-fold-host.test-util.ts +2 -1
  203. package/src/server/lib/omp/rpc/frame-fold.test.ts +2 -1
  204. package/src/server/lib/omp/rpc/frame-fold.ts +6 -45
  205. package/src/server/lib/omp/rpc/prewarm-pool.ts +19 -5
  206. package/src/server/lib/omp/rpc/run-model.test.ts +116 -0
  207. package/src/server/lib/omp/rpc/run-model.ts +4 -2
  208. package/src/server/lib/omp/session/sidebar-data.harness.test.ts +6 -3
  209. package/src/server/lib/omp/session/standby.server.ts +13 -2
  210. package/src/server/lib/panels/manifest.test.ts +47 -1
  211. package/src/server/lib/panels/manifest.ts +19 -0
  212. package/src/server/lib/panels/registry.server.ts +19 -2
  213. package/src/server/lib/panels/scan.server.ts +26 -2
  214. package/src/server/lib/panels/settings-schema.server.ts +72 -0
  215. package/src/server/lib/plugins/background.server.ts +21 -3
  216. package/src/server/lib/plugins/background.test.ts +13 -0
  217. package/src/server/lib/plugins/loader.server.ts +35 -51
  218. package/src/server/lib/plugins/mcp.server.ts +100 -0
  219. package/src/server/lib/plugins/mcp.test.ts +75 -0
  220. package/src/server/lib/plugins/schedule-runner.server.ts +153 -0
  221. package/src/server/lib/plugins/schedule-runner.test.ts +186 -0
  222. package/src/server/lib/plugins/schedule-store.server.ts +107 -0
  223. package/src/server/lib/plugins/schema.server.ts +8 -0
  224. package/src/server/lib/plugins/settings.server.ts +56 -19
  225. package/src/server/lib/plugins/shutdown.server.ts +58 -0
  226. package/src/server/lib/plugins/shutdown.test.ts +28 -3
  227. package/src/server/lib/realtime/topics/global.server.ts +5 -1
  228. package/src/server/lib/schedule/rows.server.ts +9 -0
  229. package/src/server/lib/schedule/runtime.server.test.ts +91 -0
  230. package/src/server/lib/schedule/runtime.server.ts +101 -23
  231. package/src/server/lib/schedule/schema.server.ts +15 -0
  232. package/src/server/lib/schedule/store.server.test.ts +34 -0
  233. package/src/server/lib/schedule/store.server.ts +33 -9
  234. package/src/server/lib/sessions/fork.server.test.ts +47 -0
  235. package/src/server/lib/sessions/fork.server.ts +17 -1
  236. package/src/server/lib/sessions/spawn.server.ts +2 -2
  237. package/src/server/lib/waiting/runtime.server.test.ts +48 -0
  238. package/src/server/lib/waiting/runtime.server.ts +22 -0
  239. package/src/server/lib/waiting/schema.server.ts +8 -0
  240. package/src/server/lib/waiting/store.server.test.ts +14 -0
  241. package/src/server/lib/waiting/store.server.ts +6 -2
  242. package/src/server/routes/agent/command-resume.test.ts +9 -4
  243. package/src/server/routes/agent/new-mode.test.ts +40 -0
  244. package/src/server/routes/agent/new.ts +31 -10
  245. package/src/server/routes/agent/prewarm.ts +48 -7
  246. package/src/server/routes/fs/action.ts +9 -1
  247. package/src/server/routes/fs/digest.test.ts +100 -0
  248. package/src/server/routes/fs/digest.ts +106 -0
  249. package/src/server/routes/fs/index.ts +2 -0
  250. package/src/server/routes/fs/read.ts +6 -1
  251. package/src/server/routes/harness/custom.test.ts +131 -0
  252. package/src/server/routes/harness/import-action.ts +2 -2
  253. package/src/server/routes/harness/root.ts +41 -8
  254. package/src/server/routes/harness/update.ts +2 -2
  255. package/src/server/routes/panels/bindings.ts +2 -0
  256. package/src/server/routes/panels/settings.test.ts +165 -0
  257. package/src/server/routes/panels/settings.ts +106 -0
  258. package/src/server/routes/schedule/body.ts +14 -0
  259. package/src/server/routes/schedule/index.ts +28 -4
  260. package/src/server/routes/settings/mcp.ts +9 -26
  261. package/src/server/routes/waiting/index.ts +21 -2
  262. package/src/server/routes/waiting/routes.test.ts +21 -0
  263. package/src/shared/lib/chat/composer/delegation.ts +3 -3
  264. package/src/shared/lib/chat/timeline/fork-anchor.test.ts +97 -0
  265. package/src/shared/lib/chat/timeline/fork-anchor.ts +47 -0
  266. package/src/shared/lib/fs/content-hash.ts +29 -0
  267. package/src/shared/lib/harness/catalog.ts +48 -6
  268. package/src/shared/lib/harness/fork.ts +60 -0
  269. package/src/shared/lib/harness/mcp-facts.test.ts +30 -0
  270. package/src/shared/lib/harness/mcp-facts.ts +65 -0
  271. package/src/shared/lib/harness/menu.test.ts +16 -1
  272. package/src/shared/lib/harness/menu.ts +2 -2
  273. package/src/shared/lib/harness/rewind.ts +6 -6
  274. package/src/shared/lib/harness/session-modes.ts +31 -0
  275. package/src/shared/lib/harness/transcript.test.ts +29 -0
  276. package/src/shared/lib/harness/transcript.ts +19 -0
  277. package/src/shared/lib/notifications/settings.test.ts +21 -0
  278. package/src/shared/lib/notifications/settings.ts +24 -0
  279. package/src/shared/lib/omp/session/prewarm.test.ts +28 -4
  280. package/src/shared/lib/omp/session/prewarm.ts +25 -6
  281. package/src/shared/lib/omp/session/stream-state.server.test.ts +25 -0
  282. package/src/shared/lib/omp/session/stream-state.server.ts +8 -4
  283. package/src/shared/lib/panels/capabilities.test.ts +1 -1
  284. package/src/shared/lib/panels/capabilities.ts +3 -0
  285. package/src/shared/lib/plugins/settings.ts +22 -0
  286. package/src/shared/lib/schedule/parse.test.ts +48 -0
  287. package/src/shared/lib/schedule/parse.ts +69 -45
  288. package/src/shared/lib/schedule/timezone.ts +128 -0
  289. package/src/shared/lib/settings/defaults.ts +2 -0
  290. package/src/shared/lib/workspace/refresh-cadence.test.ts +25 -1
  291. package/src/shared/lib/workspace/relative-time.ts +16 -0
  292. package/src/shared/types/harness.ts +7 -0
  293. package/src/shared/types/omp/agent.ts +6 -0
  294. package/src/shared/types/panels-registry.ts +3 -3
  295. package/src/shared/types/panels.ts +4 -2
  296. package/src/shared/types/schedule.ts +13 -0
  297. package/src/shared/types/settings/state.ts +12 -1
  298. package/src/shared/types/waiting.ts +9 -0
  299. package/src/test-support/file-editor.test-util.ts +70 -5
  300. package/dist/client/static/js/index-32rpkj6b.css +0 -1
  301. package/src/client/hooks/editor/use-external-change-notice.ts +0 -71
  302. package/src/client/hooks/editor/use-external-change.test.ts +0 -88
  303. package/src/client/hooks/editor/use-external-change.ts +0 -146
@@ -0,0 +1,136 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * What a write must do to the viewport it inherited.
8
+ *
9
+ * ghostty-web's `writeInternal` ends with `viewportY !== 0 && scrollToBottom()`,
10
+ * so EVERY chunk of PTY output re-anchors the view to the live end. A stream
11
+ * (`tail -F`, a build log, `yes`) therefore cannot be read or selected at all:
12
+ * a wheel-up was undone by the next chunk, and a drag that started on a line
13
+ * ended on whatever had scrolled under the pointer by the release — measured on
14
+ * the assembled panel, a two-row drag during a 100 lines/s stream copied twelve
15
+ * lines.
16
+ *
17
+ * Three states hold the view, each for its own measured failure:
18
+ *
19
+ * - **Scrolled back** (`viewportY > 0`): nothing above the live line could be
20
+ * read while output kept arriving.
21
+ * - **Pointer down**: a copy starts with a press, and the engine's own
22
+ * selection does not exist until the drag passes its 0.5-cell threshold, so
23
+ * the rows move out from under the gesture before there is anything to hold.
24
+ * - **Selection exists**: a selection outlives the drag (drag, release, read,
25
+ * press ⌘C), and output arriving in that window used to scroll it away
26
+ * before the copy ran.
27
+ *
28
+ * Everything else follows the live output, which is what a terminal does.
29
+ *
30
+ * The hold is stated as an ABSOLUTE buffer row, not as a distance from the
31
+ * bottom: as lines are appended the same content must stay on screen, so the
32
+ * distance from the bottom has to grow with the scrollback. `heldTop` captures
33
+ * that row before a write and `viewportYForTop` turns it back into a
34
+ * `viewportY` after it. The write is synchronous, so the restore lands before
35
+ * the next paint — the library's own snap is never shown.
36
+ */
37
+
38
+ /** The absolute buffer row at the top of the viewport, or null when the view follows output. */
39
+ export function heldTop(input: {
40
+ scrollback: number;
41
+ viewportY: number;
42
+ hasSelection: boolean;
43
+ pointerHeld: boolean;
44
+ }): number | null {
45
+ if (input.viewportY <= 0 && !input.hasSelection && !input.pointerHeld) return null;
46
+ return input.scrollback - input.viewportY;
47
+ }
48
+
49
+ /** The `viewportY` that puts `top` back at the top of the viewport, or null at the bottom. */
50
+ export function viewportYForTop(input: { scrollback: number; top: number }): number | null {
51
+ const viewportY = input.scrollback - input.top;
52
+ return viewportY > 0 ? viewportY : null;
53
+ }
54
+
55
+ /**
56
+ * The viewport methods the hold reads and drives.
57
+ *
58
+ * Narrow on purpose: `scrollLines` is how the library's own scroll path is
59
+ * driven — it clamps, fires `onScroll` (which is what keeps the "Latest" button
60
+ * honest) and repaints — while assigning `viewportY` directly skips all three.
61
+ */
62
+ export interface HoldableViewport {
63
+ getScrollbackLength: () => number;
64
+ getViewportY: () => number;
65
+ hasSelection: () => boolean;
66
+ scrollLines: (amount: number) => void;
67
+ }
68
+
69
+ /**
70
+ * Watch the press that starts a selection.
71
+ *
72
+ * `pointerdown` in the CAPTURE phase on the container: ghostty-web's selection
73
+ * manager attaches its own mousedown and stops propagation once its scrollbar
74
+ * wins, and the hold has to start at the press — before the engine's own
75
+ * selection exists, because its drag threshold (half a cell) leaves a window in
76
+ * which a stream has already moved the rows out from under the gesture.
77
+ *
78
+ * Release is watched on the WINDOW: a drag that ends outside the panel (over the
79
+ * sidebar, or off the app) must end the hold too, or output stops following
80
+ * forever.
81
+ *
82
+ * Returns the state the write path reads, plus its own teardown.
83
+ */
84
+ export function watchPointerPress(container: HTMLElement): { pointerHeld: boolean; stop: () => void } {
85
+ const state = { pointerHeld: false };
86
+ const press = (): void => {
87
+ state.pointerHeld = true;
88
+ };
89
+ const release = (): void => {
90
+ state.pointerHeld = false;
91
+ };
92
+ container.addEventListener('pointerdown', press, true);
93
+ globalThis.addEventListener('pointerup', release);
94
+ globalThis.addEventListener('pointercancel', release);
95
+ return {
96
+ get pointerHeld() {
97
+ return state.pointerHeld;
98
+ },
99
+ stop() {
100
+ container.removeEventListener('pointerdown', press, true);
101
+ globalThis.removeEventListener('pointerup', release);
102
+ globalThis.removeEventListener('pointercancel', release);
103
+ },
104
+ };
105
+ }
106
+
107
+ /**
108
+ * Run `write`, then put the viewport back where the reader left it.
109
+ *
110
+ * A no-op when nothing holds the view, so ordinary output still scrolls the way
111
+ * a terminal should.
112
+ */
113
+ export function holdAcrossWrite(
114
+ viewport: HoldableViewport,
115
+ state: { pointerHeld: boolean },
116
+ write: () => void,
117
+ ): void {
118
+ const top = heldTop({
119
+ scrollback: viewport.getScrollbackLength(),
120
+ viewportY: viewport.getViewportY(),
121
+ hasSelection: viewport.hasSelection(),
122
+ pointerHeld: state.pointerHeld,
123
+ });
124
+ write();
125
+ if (top === null) return;
126
+ const target = viewportYForTop({ scrollback: viewport.getScrollbackLength(), top });
127
+ if (target === null) return;
128
+ const delta = target - viewport.getViewportY();
129
+ if (delta === 0) return;
130
+ try {
131
+ // Positive `amount` scrolls toward the top, so a positive delta moves back.
132
+ viewport.scrollLines(-delta);
133
+ } catch {
134
+ // A disposed terminal has no wasm buffer; the next mount starts at the bottom.
135
+ }
136
+ }
@@ -23,9 +23,12 @@
23
23
  * with no chat named, it is kept for this page session only.
24
24
  */
25
25
 
26
- import { useState } from 'preact/hooks';
26
+ import { useEffect, useRef, useState } from 'preact/hooks';
27
27
  import { useSearchParams } from '@/client/lib/router/search-params';
28
28
  import { useSessionState } from '@/client/hooks/workspace/session-state';
29
+ import { useSessionStateContext } from '@/client/hooks/workspace/session-state/context';
30
+ import { subscribeSessionKey } from '@/shared/lib/workspace/session-state/listeners';
31
+ import { getSessionValue } from '@/shared/lib/workspace/session-state/store';
29
32
  import { useBrowserPageContextInsert } from '@/client/hooks/chat/composer/browser-context';
30
33
  import { useReviewIncludeInsert } from '@/client/hooks/chat/composer/review-context';
31
34
  import { CHAT_DRAFT_ATTACHMENTS_KEY, CHAT_DRAFT_KEY } from '@/shared/lib/chat/composer/draft';
@@ -50,6 +53,47 @@ export function useComposerDraft(): ComposerDraftState {
50
53
  const [storedAttachments, setStoredAttachments] = useSessionState<Attachment[]>(CHAT_DRAFT_ATTACHMENTS_KEY, []);
51
54
  const [landingText, setLandingText] = useState('');
52
55
  const [landingAttachments, setLandingAttachments] = useState<Attachment[]>([]);
56
+ const { sessionId } = useSessionStateContext();
57
+
58
+ // The draft is normally private to this composer, but a CANCELLED held prompt
59
+ // is written back into this very slot by another module (the sidebar's cancel,
60
+ // the waiting dispatcher's failure path). Without this follow, the text lands
61
+ // in the store and the mounted box — the one the user is looking at — keeps
62
+ // rendering its empty copy.
63
+ //
64
+ // `applied` is not bookkeeping: `setStoredText` writes the store, which
65
+ // notifies this very listener. Comparing against the last value applied (and
66
+ // recording it BEFORE the setters run) is what makes the write converge
67
+ // instead of recursing.
68
+ const appliedRef = useRef({ text: storedText, attachments: storedAttachments });
69
+ appliedRef.current = { text: storedText, attachments: storedAttachments };
70
+ // Set while this listener is writing the value it just read: the setters
71
+ // persist, which notifies this same listener. Re-entering there is how the
72
+ // first version recursed until the stack ran out.
73
+ const applyingRef = useRef(false);
74
+ useEffect(() => {
75
+ if (!scoped) return;
76
+ const follow = () => {
77
+ if (applyingRef.current) return;
78
+ const text = getSessionValue<string>(sessionId, CHAT_DRAFT_KEY) ?? '';
79
+ const attachments = getSessionValue<Attachment[]>(sessionId, CHAT_DRAFT_ATTACHMENTS_KEY) ?? [];
80
+ if (text === appliedRef.current.text && attachments === appliedRef.current.attachments) return;
81
+ appliedRef.current = { text, attachments };
82
+ applyingRef.current = true;
83
+ setStoredText(text);
84
+ setStoredAttachments(attachments);
85
+ applyingRef.current = false;
86
+ };
87
+ const offText = subscribeSessionKey(sessionId, CHAT_DRAFT_KEY, follow);
88
+ const offAttachments = subscribeSessionKey(sessionId, CHAT_DRAFT_ATTACHMENTS_KEY, follow);
89
+ return () => {
90
+ offText();
91
+ offAttachments();
92
+ };
93
+ // The two setters are state setters from `useSessionState`; re-subscribing
94
+ // on their identity would tear down the listeners on every render.
95
+ // eslint-disable-next-line react-hooks/exhaustive-deps
96
+ }, [sessionId, scoped]);
53
97
 
54
98
  const inputValue = scoped ? storedText : landingText;
55
99
  const setInputValue = scoped ? setStoredText : setLandingText;
@@ -24,9 +24,9 @@ import {
24
24
  } from '@/client/hooks/chat/omp/pending-sessions';
25
25
  import {
26
26
  clearPendingSessionWaiting,
27
+ markPendingSessionDraft,
27
28
  markPendingSessionWaiting,
28
29
  pendingSessionWait,
29
- releasePendingSessionByWait,
30
30
  } from '@/client/hooks/chat/omp/pending-waiting';
31
31
 
32
32
  afterEach(() => {
@@ -66,16 +66,17 @@ describe('pending session waiting state', () => {
66
66
  expect(listPendingSessions().map((entry) => entry.id)).toContain(id);
67
67
  });
68
68
 
69
- test('a cancelled wait drops its row by the wait id', () => {
70
- const first = startPendingSession(1);
71
- const second = startPendingSession(1);
72
- markPendingSessionWaiting(first, { waitId: 'wait-1', dependsOn: 'sess-a', dependsOnTitle: 'A' });
73
- markPendingSessionWaiting(second, { waitId: 'wait-2', dependsOn: 'sess-b', dependsOnTitle: 'B' });
69
+ // Cancelling keeps the chat: the prompt's text is written back into that
70
+ // chat's composer, so the row the user returns to must still exist — and it
71
+ // must survive the settle pass that a SENT prompt would expire, because it is
72
+ // an unsent draft again.
73
+ test('a cancelled wait becomes an unsent draft that keeps its row', () => {
74
+ const id = startPendingSession(1);
75
+ markPendingSessionWaiting(id, { waitId: 'wait-1', dependsOn: 'sess-a', dependsOnTitle: 'A' });
74
76
 
75
- releasePendingSessionByWait('wait-1');
76
- const ids = listPendingSessions().map((entry) => entry.id);
77
- expect(ids).not.toContain(first);
78
- expect(ids).toContain(second);
77
+ markPendingSessionDraft(id);
78
+ expect(pendingSessionWait(id)).toBeNull();
79
+ expect(listPendingSessions().find((entry) => entry.id === id)?.sentAt).toBeNull();
79
80
  });
80
81
 
81
82
  // The wait ends where the spawn answers: the new row is a real session from
@@ -35,14 +35,22 @@ export function clearPendingSessionWaiting(id: string): void {
35
35
  patchPendingEntry(id, (entry) => (entry.waiting ? { ...entry, waiting: undefined } : entry));
36
36
  }
37
37
 
38
+ /**
39
+ * The wait was cancelled (or failed) and its text is back in the composer.
40
+ *
41
+ * `sentAt` is cleared with the cue: the entry is an UNSENT draft again, so the
42
+ * reconcile pass keeps it while that draft exists instead of expiring it on the
43
+ * sent-prompt settle window and taking the restored text's row away.
44
+ */
45
+ export function markPendingSessionDraft(id: string): void {
46
+ patchPendingEntry(id, (entry) => (
47
+ entry.waiting || entry.sentAt !== null
48
+ ? { ...entry, waiting: undefined, sentAt: null }
49
+ : entry
50
+ ));
51
+ }
52
+
38
53
  /** The waiting half of one entry, or null when the row is not waiting. */
39
54
  export function pendingSessionWait(id: string): PendingWait | null {
40
55
  return listPendingSessions().find((entry) => entry.id === id)?.waiting ?? null;
41
56
  }
42
-
43
- /** Drop the entry whose prompt was held by `waitId` (the wait was cancelled). */
44
- export function releasePendingSessionByWait(waitId: string): void {
45
- for (const entry of listPendingSessions()) {
46
- if (entry.waiting?.waitId === waitId) patchPendingEntry(entry.id, () => null);
47
- }
48
- }
@@ -271,6 +271,17 @@ describe('useOmpPromptSender.sendNewPrompt', () => {
271
271
  expect(probe.connected).toEqual(['omp-9']);
272
272
  });
273
273
 
274
+ test('sends the ACP mode pick on the spawn body', async () => {
275
+ // The composer's pending chat has no session to command, so a mode picked on
276
+ // it can only travel here; dropping it started the chat in the agent's
277
+ // default mode while the chip named the operator's pick.
278
+ const requests = installFetch({ [NEW]: { body: { success: true, sessionId: 'acp-1', harness: 'claude' } } });
279
+ const probe = mountSender(null);
280
+ await probe.sender().sendNewPrompt('first', '/w', undefined, { harness: 'claude', sessionMode: 'architect' });
281
+
282
+ expect(requests[0].body).toMatchObject({ harness: 'claude', sessionMode: 'architect' });
283
+ });
284
+
274
285
  test('omits every unset pick so a bare spawn behaves as before', async () => {
275
286
  const requests = installFetch({ [NEW]: { body: { success: true, sessionId: 'omp-1' } } });
276
287
  const probe = mountSender(null);
@@ -141,6 +141,9 @@ export function useOmpPromptSender(deps: OmpPromptSenderDeps): OmpPromptSender {
141
141
  // Plan/goal picks from the pending view. Omitted when the user made
142
142
  // none, so a spawn with no selection behaves exactly as before.
143
143
  ...(composerOptions?.modes ? { modes: composerOptions.modes } : {}),
144
+ // The ACP ladder pick from the same view — the agent's own vocabulary,
145
+ // applied by the route as a config write after `session/new`.
146
+ ...(composerOptions?.sessionMode ? { sessionMode: composerOptions.sessionMode } : {}),
144
147
  ...(composerOptions?.harness ? { harness: composerOptions.harness } : {}),
145
148
  }),
146
149
  });
@@ -185,10 +185,10 @@ export function useChatTimelineActions(deps: ChatTimelineActionsDeps): ChatTimel
185
185
  // keep the draft so the user can edit or retype it.
186
186
  if (blockTuiOnlySend(textToSend, setLocalMessages, harness)) return;
187
187
 
188
- // A NEW chat whose prompt is held for another session: nothing is sent now,
189
- // and the pending row stays on screen saying what it waits for. Checked
190
- // before the queue-vs-send split — a pending chat has no run to queue behind.
191
- if (await holdFromComposer(deps, textToSend, attachments, isGenerating || chatRunning)) return;
188
+ // A prompt held for another session: nothing is sent now, and the chat's
189
+ // pending/held row stays on screen saying what it waits for. Checked before
190
+ // the queue-vs-send split, so a busy chat still defers instead of queueing.
191
+ if (await holdFromComposer(deps, textToSend, attachments)) return;
192
192
 
193
193
  // "A run is in flight" is the CHAT-level flag, not this client's own:
194
194
  // `isGenerating` only knows the run THIS page started, so a second tab, a
@@ -33,9 +33,20 @@ export function useComposerModes(sessionId: string | null, harness?: string | nu
33
33
  // mode list is the agent's own, and a non-omp agent has no `/kabmo-mode`
34
34
  // extension to fall back on.
35
35
  const { harnesses } = useHarnesses();
36
- const modeValues = harnesses.find((entry) => entry.id === harness)?.probe?.capabilities.modeValues;
36
+ const probe = harnesses.find((entry) => entry.id === harness)?.probe;
37
+ const modeValues = probe?.capabilities.modeValues;
38
+ // The ladder itself comes from the same probe, so a pending chat — which has
39
+ // no session to ask — still shows the agent's own modes as soon as its harness
40
+ // is picked. `omp-acp` is excluded for the reason `GET /modes` excludes it:
41
+ // its selectors are default/plan, which the dedicated Plan toggle expresses.
42
+ const modeChoices = harness && harness !== 'omp-acp' && probe?.modes.length ? probe.modes : undefined;
37
43
  return {
38
- modes: useChatTimelineModes(sessionId, { harness, ...(modeValues ? { modeValues } : {}) }),
44
+ modes: useChatTimelineModes(sessionId, {
45
+ harness,
46
+ ...(modeValues ? { modeValues } : {}),
47
+ ...(modeChoices ? { modeChoices } : {}),
48
+ ...(modeChoices && probe?.currentMode ? { modeCurrent: probe.currentMode } : {}),
49
+ }),
39
50
  planReview: usePlanReview(sessionId),
40
51
  };
41
52
  }
@@ -0,0 +1,52 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Open a FORK as the same pending-chat composer New Session uses.
8
+ *
9
+ * Two entry points share this: the per-message Fork (with an anchor) and the
10
+ * session menu's "Fork chat" (whole chat, no anchor). The pending entry carries
11
+ * the source and the anchor, so the normal empty-workspace composer writes the
12
+ * branch's first turn; the POST happens on SEND, in `pending-dispatch.ts`.
13
+ */
14
+
15
+ import { startPendingSession } from '@/client/hooks/chat/omp/pending-sessions';
16
+ import { setHarnessPick } from '@/client/hooks/chat/timeline/session-harness';
17
+ import { formatNewSessionTitle } from '@/shared/lib/omp/session/default-title';
18
+ import type { SetSearchParams } from '@/client/lib/router/search-params';
19
+
20
+ export interface OpenForkSessionArgs {
21
+ sourceSessionId: string;
22
+ /** The source's agent; the fork cannot change provider. */
23
+ harness?: string;
24
+ folderId: number | string | null;
25
+ /** The row the fork cuts at; null forks the whole chat. */
26
+ anchorEntryId: string | null;
27
+ setSearchParams: SetSearchParams;
28
+ }
29
+
30
+ /** Returns the pending chat's id. */
31
+ export function openForkSession(args: OpenForkSessionArgs): string {
32
+ const pendingId = startPendingSession(args.folderId, {
33
+ title: formatNewSessionTitle(new Date(), 'Fork'),
34
+ ...(args.harness ? { harness: args.harness } : {}),
35
+ forkSourceSessionId: args.sourceSessionId,
36
+ ...(args.anchorEntryId ? { forkAnchorEntryId: args.anchorEntryId } : {}),
37
+ });
38
+ // The picker's first tab is the source's agent; the fork cannot change
39
+ // provider because that agent owns the history being branched.
40
+ if (args.harness) setHarnessPick(pendingId, args.harness);
41
+ args.setSearchParams((prev) => {
42
+ const next = new URLSearchParams(prev);
43
+ next.set('sessionId', pendingId);
44
+ next.set('forkFrom', args.sourceSessionId);
45
+ if (args.anchorEntryId) next.set('forkAt', args.anchorEntryId);
46
+ else next.delete('forkAt');
47
+ next.delete('parentSessionId');
48
+ if (args.folderId !== null && args.folderId !== undefined) next.set('folderId', String(args.folderId));
49
+ return next;
50
+ }, { replace: true });
51
+ return pendingId;
52
+ }
@@ -141,8 +141,9 @@ export function useChatTimeline({
141
141
  // Access control is a GLOBAL persisted preference, unlike per-session picks.
142
142
  const { accessMode, accessModeRef, setAccessMode: handleAccessModeChange } = useChatTimelineAccessMode(appSettings);
143
143
 
144
- // "Wait for session" on a NEW chat: the pick and the ref the send reads.
145
- const waitingDependency = useWaitingDependencyChoice(sessionId);
144
+ // "Wait for session": the pick (first prompt or a NEXT one) and the ref the
145
+ // send reads. It is per-session UI state, so each chat keeps its own.
146
+ const waitingDependency = useWaitingDependencyChoice();
146
147
 
147
148
  const persistMessages = useCallback((messagesToSave: any[]) => {
148
149
  if (!sessionId) return;
@@ -231,6 +232,7 @@ export function useChatTimeline({
231
232
  pendingHarnessRef,
232
233
  accessModeRef,
233
234
  spawnSelectionRef: modes.spawnSelectionRef,
235
+ pendingAgentModeRef: modes.pendingAgentModeRef,
234
236
  goalArmRef: modes.goalArmRef,
235
237
  disarmGoal: modes.disarmGoal,
236
238
  spawnWorktreeRef: spawn.worktreePathRef,
@@ -292,6 +294,7 @@ export function useChatTimeline({
292
294
  localMessages,
293
295
  isGenerating,
294
296
  timelineRunning,
297
+ reloadMessages,
295
298
  hasMore,
296
299
  loadingOlder,
297
300
  loadOlderError,
@@ -17,12 +17,19 @@
17
17
  * arrived yet.
18
18
  */
19
19
 
20
+ import type { SessionModeChoice } from '@/shared/lib/harness/session-modes';
21
+
20
22
  export interface ModeCapabilities {
21
23
  /** The harness that owns this chat, when the tab knows it. */
22
24
  harness?: string | null;
23
25
  /** The harness's own `mode` values, from its probe: `plan` is a real mode on
24
26
  * the agents that publish one. */
25
27
  modeValues?: string[];
28
+ /** The ladder itself (value + label) from the same probe, so a chat that has
29
+ * not spawned can still draw the agent's mode control. */
30
+ modeChoices?: readonly SessionModeChoice[];
31
+ /** The mode the agent reported as current at probe time, when it said. */
32
+ modeCurrent?: string;
26
33
  }
27
34
 
28
35
  export function modeAvailability(capabilities: ModeCapabilities): { plan: boolean; goal: boolean } {
@@ -63,6 +63,12 @@ export interface ChatTimelineModes {
63
63
  sessionMode?: SessionModeState | null;
64
64
  /** Move the agent's mode selector. */
65
65
  onSelectSessionMode?: (value: string) => void;
66
+ /**
67
+ * For a pending `new-…` chat only: the ACP mode its spawn must request. A
68
+ * chat with no child cannot be commanded, so the pick is held here and read
69
+ * by the send path (`SpawnOptions.sessionMode`).
70
+ */
71
+ pendingAgentModeRef: { current: string | null };
66
72
  /**
67
73
  * The last refusal, from either side of the wire: the route's own error, or a
68
74
  * `KABMO_MODE_ERROR` the extension emitted (an unknown action, a missing
@@ -0,0 +1,93 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The composer's mode HYDRATE: what a chat's own record says its modes are.
8
+ *
9
+ * Split from `modes.ts` for the per-file ceiling; the rule is the part that
10
+ * matters. A fresh session answers the empty selection, so a brand-new chat
11
+ * renders both toggles off without a request having to distinguish "unknown"
12
+ * from "off" — and the RESET happens before the read, not only from its answer:
13
+ * a session whose record cannot be read at all (a pending `new-…` chat, a
14
+ * deleted session — the route answers 404) would otherwise keep the PREVIOUS
15
+ * session's modes, and the composer would show another chat's goal banner and a
16
+ * pressed Goal button. Measured: switching to a pending chat rendered the last
17
+ * session's objective in the goal strip.
18
+ */
19
+
20
+ import { useEffect } from 'preact/hooks';
21
+ import { isPendingSessionId } from '@/shared/lib/omp/session/default-title';
22
+ import type { ModesResponse } from '@/client/hooks/chat/timeline/mode-markers';
23
+ import type { SessionModeState } from '@/shared/lib/harness/session-modes';
24
+ import type { GoalContinuation, GoalRecord, KabmoModeSelection } from '@/shared/lib/omp/mode/types';
25
+
26
+ export interface ModesHydrationTarget {
27
+ sessionId: string | null;
28
+ /** The pending chat's spawn selection, spent once a real session answers. */
29
+ spawnSelectionRef: { current: KabmoModeSelection | null };
30
+ /** Mirrors the record's id so a marker can tell a new goal from the same one. */
31
+ goalIdRef: { current: string | null };
32
+ setPlan: (value: boolean) => void;
33
+ setMode: (value: SessionModeState | null) => void;
34
+ setGoal: (value: boolean) => void;
35
+ setGoalRecord: (value: GoalRecord | null) => void;
36
+ setGoalContinuation: (value: GoalContinuation | null) => void;
37
+ setGoalEvaluating: (value: boolean) => void;
38
+ }
39
+
40
+ export function useSessionModesHydration({
41
+ sessionId,
42
+ spawnSelectionRef,
43
+ goalIdRef,
44
+ setPlan,
45
+ setMode,
46
+ setGoal,
47
+ setGoalRecord,
48
+ setGoalContinuation,
49
+ setGoalEvaluating,
50
+ }: ModesHydrationTarget): void {
51
+ useEffect(() => {
52
+ const current = sessionId;
53
+ setPlan(false);
54
+ setMode(null);
55
+ setGoal(false);
56
+ setGoalRecord(null);
57
+ setGoalContinuation(null);
58
+ setGoalEvaluating(false);
59
+ goalIdRef.current = null;
60
+ // The pending selection is spent at the spawn that adopts a real id: this
61
+ // hook is now rendering the CHILD's modes, and a stale ref would re-apply
62
+ // the pending chat's picks to an unrelated later spawn.
63
+ if (!isPendingSessionId(current)) spawnSelectionRef.current = null;
64
+ if (!current) return;
65
+ // A pending `new-…` id has no session file, so the route can only answer
66
+ // 404. Skipped rather than fetched-and-ignored: the read is what a network
67
+ // panel shows, and a request whose only possible outcome is a 404 is noise.
68
+ if (isPendingSessionId(current)) return;
69
+ let cancelled = false;
70
+ fetch(`/api/sessions/${encodeURIComponent(current)}/modes`)
71
+ .then((res) => (res.ok ? (res.json() as Promise<ModesResponse>) : null))
72
+ .then((data) => {
73
+ if (cancelled || !data?.modes) return;
74
+ setPlan(data.modes.plan === true);
75
+ setMode(data.modes.mode ?? null);
76
+ setGoal(data.modes.goal === true);
77
+ setGoalRecord(data.modes.goalRecord ?? null);
78
+ // The loop's last verdict rides the same record, so a reload shows
79
+ // "stopped at N turns" (and its Resume) instead of an active-looking
80
+ // goal the child has already given up on. A verdict never reported is
81
+ // null: the child's own counter cannot be reconstructed from a file.
82
+ setGoalContinuation(data.modes.goalContinuation ?? null);
83
+ goalIdRef.current = data.modes.goalRecord?.id ?? null;
84
+ })
85
+ .catch(() => {});
86
+ return () => {
87
+ cancelled = true;
88
+ };
89
+ // The setters are `useState` setters (stable) and the two refs are refs;
90
+ // `sessionId` is the only thing whose change starts a new read.
91
+ // eslint-disable-next-line react-hooks/exhaustive-deps
92
+ }, [sessionId]);
93
+ }