@kabmo-labs/kabmo 0.26.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 (354) hide show
  1. package/dist/client/index.html +1 -1
  2. package/dist/client/index.js +502 -474
  3. package/dist/client/static/js/index-81f7berm.css +1 -0
  4. package/dist/client/static/js/{index-95b3n20k.js → index-xzvyrxya.js} +799 -799
  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/Toast.test.tsx +28 -2
  45. package/src/client/components/common/Toast.tsx +21 -9
  46. package/src/client/components/common/harness-glyph/index.tsx +18 -1
  47. package/src/client/components/common/session-actions-menu/index.test.tsx +106 -0
  48. package/src/client/components/common/session-actions-menu/index.tsx +43 -1
  49. package/src/client/components/common/session-row/TrailingSlot.tsx +9 -4
  50. package/src/client/components/common/session-row/index.tsx +4 -0
  51. package/src/client/components/common/session-row/session-row.test.tsx +6 -0
  52. package/src/client/components/layout/desktop-layout/LeftColumn.tsx +2 -1
  53. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +4 -2
  54. package/src/client/components/layout/session-sidebar/SessionItem.tsx +9 -1
  55. package/src/client/components/layout/session-sidebar/SessionList.tsx +2 -1
  56. package/src/client/components/layout/session-sidebar/about-modal/UpdateSection.tsx +3 -2
  57. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +2 -1
  58. package/src/client/components/layout/session-sidebar/modern/RevealRow.tsx +56 -0
  59. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +12 -29
  60. package/src/client/components/layout/session-sidebar/modern/reveal-row.test.tsx +104 -0
  61. package/src/client/components/layout/session-sidebar/scheduler-modal/ModelFields.tsx +202 -0
  62. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskForm.tsx +80 -19
  63. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskList.tsx +23 -3
  64. package/src/client/components/layout/session-sidebar/scheduler-modal/index.tsx +5 -1
  65. package/src/client/components/layout/session-sidebar/variant-props.ts +2 -1
  66. package/src/client/components/mobile/SessionSidebar.tsx +2 -1
  67. package/src/client/components/mobile/mobile-right-sidebar/EditorSurface.tsx +156 -0
  68. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +41 -86
  69. package/src/client/components/mobile/mobile-session-sidebar/ClassicDrawer.tsx +2 -1
  70. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +4 -2
  71. package/src/client/components/mobile/mobile-session-sidebar/List.tsx +2 -1
  72. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.test.ts +6 -0
  73. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +9 -1
  74. package/src/client/components/settings/Modal.tsx +7 -3
  75. package/src/client/components/settings/Sidebar.tsx +30 -3
  76. package/src/client/components/settings/categories/HarnessSettings.tsx +11 -7
  77. package/src/client/components/settings/categories/NotificationSettings.test.tsx +40 -15
  78. package/src/client/components/settings/categories/NotificationSettings.tsx +142 -64
  79. package/src/client/components/settings/categories/PanelPluginSettings.tsx +1 -1
  80. package/src/client/components/settings/categories/harness-settings/CustomHarnessForm.tsx +186 -0
  81. package/src/client/components/settings/categories/panel-plugins/InstalledList.tsx +11 -0
  82. package/src/client/components/settings/categories/panel-plugins/PluginCard.test.tsx +1 -0
  83. package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +15 -1
  84. package/src/client/components/settings/categories/panel-plugins/SettingsModal.test.tsx +165 -0
  85. package/src/client/components/settings/categories/panel-plugins/SettingsModal.tsx +260 -0
  86. package/src/client/components/settings/categories/project-settings/WorktreeSettings.tsx +2 -1
  87. package/src/client/components/settings/categories/usage-settings/LimitsSection.tsx +39 -19
  88. package/src/client/components/settings/categories/usage-settings/ProviderDetail.tsx +1 -0
  89. package/src/client/components/settings/categories/usage-settings/limit-groups.test.ts +94 -0
  90. package/src/client/components/settings/categories/usage-settings/limit-groups.ts +118 -0
  91. package/src/client/components/settings/categories/usage-settings/limits-section.test.tsx +118 -0
  92. package/src/client/components/workspace/chat-timeline/AiMessageFooter.fork.test.ts +24 -0
  93. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +8 -4
  94. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +34 -0
  95. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +61 -56
  96. package/src/client/components/workspace/chat-timeline/MessageItem.fork.test.ts +80 -0
  97. package/src/client/components/workspace/chat-timeline/MessageItem.tsx +9 -3
  98. package/src/client/components/workspace/chat-timeline/MessageList.tsx +3 -1
  99. package/src/client/components/workspace/chat-timeline/PendingChatView.tsx +11 -1
  100. package/src/client/components/workspace/chat-timeline/PendingTranscript.tsx +130 -0
  101. package/src/client/components/workspace/chat-timeline/RunFooter.tsx +2 -1
  102. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +2 -1
  103. package/src/client/components/workspace/chat-timeline/chat-input/ComposerRows.tsx +8 -0
  104. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.test.tsx +9 -0
  105. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.tsx +4 -1
  106. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +24 -0
  107. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.tsx +13 -20
  108. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +2 -0
  109. package/src/client/components/workspace/chat-timeline/chat-input/props.ts +5 -5
  110. package/src/client/components/workspace/chat-timeline/fork-preview.test.tsx +141 -0
  111. package/src/client/components/workspace/chat-timeline/index.tsx +17 -6
  112. package/src/client/components/workspace/chat-timeline/target-picker/DraftTargetRow.tsx +3 -10
  113. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.test.tsx +101 -0
  114. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.tsx +2 -2
  115. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.tsx +5 -4
  116. package/src/client/components/workspace/editor/FilePane.tsx +9 -4
  117. package/src/client/components/workspace/editor/Notices.tsx +2 -2
  118. package/src/client/components/workspace/editor/Pane.tsx +2 -2
  119. package/src/client/components/workspace/editor/Toolbar.tsx +16 -10
  120. package/src/client/components/workspace/editor/index.tsx +6 -10
  121. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +4 -3
  122. package/src/client/components/workspace/editor/toolbar-clusters.tsx +23 -14
  123. package/src/client/components/workspace/git-panel/index.tsx +2 -2
  124. package/src/client/components/workspace/terminal-panel/RealtimeTerminalView.tsx +17 -6
  125. package/src/client/components/workspace/terminal-panel/focus.test.ts +70 -0
  126. package/src/client/components/workspace/terminal-panel/focus.ts +46 -0
  127. package/src/client/components/workspace/terminal-panel/index.tsx +17 -1
  128. package/src/client/components/workspace/terminal-panel/mount.ts +17 -9
  129. package/src/client/components/workspace/terminal-panel/scroll-hold.test.ts +158 -0
  130. package/src/client/components/workspace/terminal-panel/scroll-hold.ts +136 -0
  131. package/src/client/hooks/chat/composer/use-draft.ts +45 -1
  132. package/src/client/hooks/chat/omp/pending-sessions.waiting.test.ts +11 -10
  133. package/src/client/hooks/chat/omp/pending-waiting.ts +15 -7
  134. package/src/client/hooks/chat/omp/prompt-send.test.ts +11 -0
  135. package/src/client/hooks/chat/omp/prompt-send.ts +3 -0
  136. package/src/client/hooks/chat/omp/session-list.tsx +5 -0
  137. package/src/client/hooks/chat/omp/sidebar-reload.test.ts +85 -0
  138. package/src/client/hooks/chat/omp/sidebar-reload.ts +30 -0
  139. package/src/client/hooks/chat/timeline/actions.ts +4 -4
  140. package/src/client/hooks/chat/timeline/composer-modes.ts +13 -2
  141. package/src/client/hooks/chat/timeline/fork-open.ts +52 -0
  142. package/src/client/hooks/chat/timeline/fork-preview.test.ts +148 -0
  143. package/src/client/hooks/chat/timeline/fork-preview.ts +104 -0
  144. package/src/client/hooks/chat/timeline/fork-send.test.ts +139 -0
  145. package/src/client/hooks/chat/timeline/index.ts +5 -2
  146. package/src/client/hooks/chat/timeline/mode-availability.ts +7 -0
  147. package/src/client/hooks/chat/timeline/modes-contract.ts +6 -0
  148. package/src/client/hooks/chat/timeline/modes-hydrate.ts +93 -0
  149. package/src/client/hooks/chat/timeline/modes.ts +32 -52
  150. package/src/client/hooks/chat/timeline/new-chat-open.ts +7 -6
  151. package/src/client/hooks/chat/timeline/new-chat.ts +10 -1
  152. package/src/client/hooks/chat/timeline/pending-branch.ts +9 -0
  153. package/src/client/hooks/chat/timeline/pending-dispatch.ts +53 -0
  154. package/src/client/hooks/chat/timeline/pending-session-mode.test.ts +136 -0
  155. package/src/client/hooks/chat/timeline/pending-session-mode.ts +69 -0
  156. package/src/client/hooks/chat/timeline/pending-warmup.test.ts +147 -0
  157. package/src/client/hooks/chat/timeline/pending-warmup.ts +62 -0
  158. package/src/client/hooks/chat/timeline/run-identity.test.ts +12 -0
  159. package/src/client/hooks/chat/timeline/run-identity.ts +4 -1
  160. package/src/client/hooks/chat/timeline/send-props.ts +2 -0
  161. package/src/client/hooks/chat/timeline/send-steer.test.ts +1 -0
  162. package/src/client/hooks/chat/timeline/send.test-util.ts +1 -0
  163. package/src/client/hooks/chat/timeline/send.test.ts +1 -0
  164. package/src/client/hooks/chat/timeline/session-harness.ts +4 -0
  165. package/src/client/hooks/chat/timeline/stop-with-queue.ts +1 -1
  166. package/src/client/hooks/chat/timeline/use-fork-session.ts +9 -22
  167. package/src/client/hooks/chat/waiting/cancel.ts +15 -7
  168. package/src/client/hooks/chat/waiting/choice.ts +13 -16
  169. package/src/client/hooks/chat/waiting/composer-wait.ts +70 -0
  170. package/src/client/hooks/chat/waiting/dispatch.ts +50 -29
  171. package/src/client/hooks/chat/waiting/held.ts +38 -13
  172. package/src/client/hooks/chat/waiting/hold.test.ts +22 -0
  173. package/src/client/hooks/chat/waiting/hold.ts +20 -11
  174. package/src/client/hooks/chat/waiting/restore.test.ts +69 -0
  175. package/src/client/hooks/chat/waiting/restore.ts +34 -0
  176. package/src/client/hooks/chat/waiting/store.ts +9 -3
  177. package/src/client/hooks/editor/file-editor-types.ts +21 -12
  178. package/src/client/hooks/editor/save-file.test.ts +1 -1
  179. package/src/client/hooks/editor/save-file.ts +35 -8
  180. package/src/client/hooks/editor/target-key.ts +17 -0
  181. package/src/client/hooks/editor/use-disk-digest.test.ts +82 -0
  182. package/src/client/hooks/editor/use-disk-digest.ts +164 -0
  183. package/src/client/hooks/editor/use-disk-sync.ts +212 -0
  184. package/src/client/hooks/editor/use-file-cache.ts +113 -0
  185. package/src/client/hooks/editor/use-file-editor.test.ts +90 -0
  186. package/src/client/hooks/editor/use-file-editor.ts +90 -52
  187. package/src/client/hooks/editor/use-file-read.ts +24 -10
  188. package/src/client/hooks/editor/use-file-writes.ts +4 -4
  189. package/src/client/hooks/models/harness-catalog.ts +15 -0
  190. package/src/client/hooks/settings/providers/actions.ts +3 -2
  191. package/src/client/hooks/settings/providers/messages.ts +9 -7
  192. package/src/client/hooks/settings/providers/model-actions.ts +2 -1
  193. package/src/client/hooks/ui/editor-error-toast.ts +2 -1
  194. package/src/client/hooks/ui/notifications.ts +17 -8
  195. package/src/client/hooks/workspace/batch-archive.test.ts +2 -2
  196. package/src/client/hooks/workspace/batch-archive.ts +4 -2
  197. package/src/client/hooks/workspace/git-action-outcome.ts +4 -3
  198. package/src/client/hooks/workspace/navbar-session-actions.ts +2 -1
  199. package/src/client/hooks/workspace/panel-registry.ts +1 -1
  200. package/src/client/hooks/workspace/scheduled-tasks.ts +26 -11
  201. package/src/client/hooks/workspace/session-actions.test.ts +2 -1
  202. package/src/client/hooks/workspace/session-actions.ts +2 -1
  203. package/src/client/hooks/workspace/terminal/connection.test.ts +63 -0
  204. package/src/client/hooks/workspace/terminal/connection.ts +47 -0
  205. package/src/client/hooks/workspace/terminal/index.ts +35 -4
  206. package/src/client/hooks/workspace/workspace-folder-actions.ts +2 -1
  207. package/src/client/lib/notifications/os.test.ts +1 -30
  208. package/src/client/lib/notifications/os.ts +0 -15
  209. package/src/client/lib/notifications/platform.test.ts +68 -0
  210. package/src/client/lib/notifications/platform.ts +36 -0
  211. package/src/server/index.ts +7 -0
  212. package/src/server/lib/harness/acp/client.ts +81 -87
  213. package/src/server/lib/harness/acp/prewarm.server.ts +237 -0
  214. package/src/server/lib/harness/acp/prewarm.test.ts +171 -0
  215. package/src/server/lib/harness/acp/prompt.test.ts +70 -1
  216. package/src/server/lib/harness/acp/prompt.ts +32 -1
  217. package/src/server/lib/harness/acp/protocol.ts +23 -0
  218. package/src/server/lib/harness/acp/session-handshake.test.ts +26 -0
  219. package/src/server/lib/harness/acp/session-handshake.ts +22 -20
  220. package/src/server/lib/harness/acp/session-options.ts +16 -0
  221. package/src/server/lib/harness/acp/session-process.ts +43 -0
  222. package/src/server/lib/harness/acp/session.ts +11 -12
  223. package/src/server/lib/harness/acp/stdio.ts +129 -0
  224. package/src/server/lib/harness/acp/verbs.test.ts +97 -0
  225. package/src/server/lib/harness/acp/verbs.ts +16 -6
  226. package/src/server/lib/harness/auto-probe.server.ts +4 -3
  227. package/src/server/lib/harness/capabilities.ts +8 -0
  228. package/src/server/lib/harness/config.server.ts +3 -2
  229. package/src/server/lib/harness/custom.server.ts +209 -0
  230. package/src/server/lib/harness/launch.ts +6 -1
  231. package/src/server/lib/harness/register.server.ts +8 -1
  232. package/src/server/lib/harness/schema.server.ts +21 -0
  233. package/src/server/lib/harness/session-lease.server.test.ts +99 -0
  234. package/src/server/lib/harness/session-lease.server.ts +193 -0
  235. package/src/server/lib/harness/session-store.server.test.ts +8 -8
  236. package/src/server/lib/harness/session-store.server.ts +25 -4
  237. package/src/server/lib/harness/session-title.server.ts +12 -2
  238. package/src/server/lib/harness/spawn.server.ts +123 -20
  239. package/src/server/lib/harness/update-queue.server.ts +3 -3
  240. package/src/server/lib/lifecycle/after-listen.ts +12 -1
  241. package/src/server/lib/lifecycle/paths.ts +19 -1
  242. package/src/server/lib/mcp/registry.server.ts +155 -0
  243. package/src/server/lib/mcp/registry.test.ts +169 -0
  244. package/src/server/lib/mcp/store.server.ts +38 -0
  245. package/src/server/lib/omp/rpc/frame-fold-contract.ts +59 -0
  246. package/src/server/lib/omp/rpc/frame-fold-frames.test.ts +64 -1
  247. package/src/server/lib/omp/rpc/frame-fold-host.test-util.ts +2 -1
  248. package/src/server/lib/omp/rpc/frame-fold.test.ts +2 -1
  249. package/src/server/lib/omp/rpc/frame-fold.ts +6 -45
  250. package/src/server/lib/omp/rpc/prewarm-pool.ts +19 -5
  251. package/src/server/lib/omp/rpc/run-model.test.ts +116 -0
  252. package/src/server/lib/omp/rpc/run-model.ts +4 -2
  253. package/src/server/lib/omp/session/sidebar-data.harness.test.ts +6 -3
  254. package/src/server/lib/omp/session/standby.server.ts +13 -2
  255. package/src/server/lib/panels/manifest.test.ts +47 -1
  256. package/src/server/lib/panels/manifest.ts +19 -0
  257. package/src/server/lib/panels/registry.server.ts +19 -2
  258. package/src/server/lib/panels/scan.server.ts +26 -2
  259. package/src/server/lib/panels/settings-schema.server.ts +72 -0
  260. package/src/server/lib/plugins/background.server.ts +21 -3
  261. package/src/server/lib/plugins/background.test.ts +13 -0
  262. package/src/server/lib/plugins/loader.server.ts +35 -51
  263. package/src/server/lib/plugins/mcp.server.ts +100 -0
  264. package/src/server/lib/plugins/mcp.test.ts +75 -0
  265. package/src/server/lib/plugins/schedule-runner.server.ts +153 -0
  266. package/src/server/lib/plugins/schedule-runner.test.ts +186 -0
  267. package/src/server/lib/plugins/schedule-store.server.ts +107 -0
  268. package/src/server/lib/plugins/schema.server.ts +8 -0
  269. package/src/server/lib/plugins/settings.server.ts +56 -19
  270. package/src/server/lib/plugins/shutdown.server.ts +58 -0
  271. package/src/server/lib/plugins/shutdown.test.ts +28 -3
  272. package/src/server/lib/realtime/topics/global.server.ts +5 -1
  273. package/src/server/lib/schedule/rows.server.ts +9 -0
  274. package/src/server/lib/schedule/runtime.server.test.ts +91 -0
  275. package/src/server/lib/schedule/runtime.server.ts +101 -23
  276. package/src/server/lib/schedule/schema.server.ts +15 -0
  277. package/src/server/lib/schedule/store.server.test.ts +34 -0
  278. package/src/server/lib/schedule/store.server.ts +33 -9
  279. package/src/server/lib/sessions/fork.server.test.ts +47 -0
  280. package/src/server/lib/sessions/fork.server.ts +17 -1
  281. package/src/server/lib/sessions/spawn.server.ts +2 -2
  282. package/src/server/lib/usage/report.server.ts +57 -0
  283. package/src/server/lib/waiting/runtime.server.test.ts +48 -0
  284. package/src/server/lib/waiting/runtime.server.ts +22 -0
  285. package/src/server/lib/waiting/schema.server.ts +8 -0
  286. package/src/server/lib/waiting/store.server.test.ts +14 -0
  287. package/src/server/lib/waiting/store.server.ts +6 -2
  288. package/src/server/routes/agent/command-resume.test.ts +9 -4
  289. package/src/server/routes/agent/new-mode.test.ts +40 -0
  290. package/src/server/routes/agent/new.ts +31 -10
  291. package/src/server/routes/agent/prewarm.ts +48 -7
  292. package/src/server/routes/fs/action.ts +9 -1
  293. package/src/server/routes/fs/digest.test.ts +100 -0
  294. package/src/server/routes/fs/digest.ts +106 -0
  295. package/src/server/routes/fs/index.ts +2 -0
  296. package/src/server/routes/fs/read.ts +6 -1
  297. package/src/server/routes/harness/custom.test.ts +131 -0
  298. package/src/server/routes/harness/import-action.ts +2 -2
  299. package/src/server/routes/harness/root.ts +41 -8
  300. package/src/server/routes/harness/update.ts +2 -2
  301. package/src/server/routes/panels/bindings.ts +2 -0
  302. package/src/server/routes/panels/settings.test.ts +165 -0
  303. package/src/server/routes/panels/settings.ts +106 -0
  304. package/src/server/routes/schedule/body.ts +14 -0
  305. package/src/server/routes/schedule/index.ts +28 -4
  306. package/src/server/routes/settings/mcp.ts +9 -26
  307. package/src/server/routes/waiting/index.ts +21 -2
  308. package/src/server/routes/waiting/routes.test.ts +21 -0
  309. package/src/shared/lib/chat/composer/delegation.ts +3 -3
  310. package/src/shared/lib/chat/timeline/fork-anchor.test.ts +97 -0
  311. package/src/shared/lib/chat/timeline/fork-anchor.ts +47 -0
  312. package/src/shared/lib/chat/timeline/fork-preview.test.ts +62 -0
  313. package/src/shared/lib/chat/timeline/fork-preview.ts +36 -0
  314. package/src/shared/lib/fs/content-hash.ts +29 -0
  315. package/src/shared/lib/harness/catalog.ts +48 -6
  316. package/src/shared/lib/harness/fork.ts +60 -0
  317. package/src/shared/lib/harness/mcp-facts.test.ts +30 -0
  318. package/src/shared/lib/harness/mcp-facts.ts +65 -0
  319. package/src/shared/lib/harness/menu.test.ts +16 -1
  320. package/src/shared/lib/harness/menu.ts +2 -2
  321. package/src/shared/lib/harness/rewind.ts +6 -6
  322. package/src/shared/lib/harness/session-modes.ts +31 -0
  323. package/src/shared/lib/harness/transcript.test.ts +29 -0
  324. package/src/shared/lib/harness/transcript.ts +19 -0
  325. package/src/shared/lib/notifications/settings.test.ts +21 -0
  326. package/src/shared/lib/notifications/settings.ts +24 -0
  327. package/src/shared/lib/omp/session/prewarm.test.ts +28 -4
  328. package/src/shared/lib/omp/session/prewarm.ts +25 -6
  329. package/src/shared/lib/omp/session/stream-state.server.test.ts +25 -0
  330. package/src/shared/lib/omp/session/stream-state.server.ts +8 -4
  331. package/src/shared/lib/panels/capabilities.test.ts +1 -1
  332. package/src/shared/lib/panels/capabilities.ts +3 -0
  333. package/src/shared/lib/plugins/settings.ts +22 -0
  334. package/src/shared/lib/schedule/parse.test.ts +48 -0
  335. package/src/shared/lib/schedule/parse.ts +69 -45
  336. package/src/shared/lib/schedule/timezone.ts +128 -0
  337. package/src/shared/lib/settings/defaults.ts +2 -0
  338. package/src/shared/lib/ui/toast-duration.test.ts +25 -1
  339. package/src/shared/lib/ui/toast-duration.ts +22 -4
  340. package/src/shared/lib/workspace/refresh-cadence.test.ts +25 -1
  341. package/src/shared/lib/workspace/relative-time.ts +16 -0
  342. package/src/shared/lib/workspace/session-state/store.ts +4 -0
  343. package/src/shared/types/harness.ts +7 -0
  344. package/src/shared/types/omp/agent.ts +6 -0
  345. package/src/shared/types/panels-registry.ts +3 -3
  346. package/src/shared/types/panels.ts +4 -2
  347. package/src/shared/types/schedule.ts +13 -0
  348. package/src/shared/types/settings/state.ts +12 -1
  349. package/src/shared/types/waiting.ts +9 -0
  350. package/src/test-support/file-editor.test-util.ts +70 -5
  351. package/dist/client/static/js/index-p2yw9ywf.css +0 -1
  352. package/src/client/hooks/editor/use-external-change-notice.ts +0 -71
  353. package/src/client/hooks/editor/use-external-change.test.ts +0 -88
  354. package/src/client/hooks/editor/use-external-change.ts +0 -146
@@ -6,15 +6,28 @@
6
6
  /**
7
7
  * The held prompt of the chat on screen, and how to drop it.
8
8
  *
9
- * A chat whose prompt is deferred has no session and no transcript, so the
10
- * composer is the only place the wait is visible — and it must be DISABLED
11
- * while the wait lasts: a second prompt would have nowhere to go.
9
+ * A chat whose prompt is deferred has no new transcript, so the composer is the
10
+ * only place the wait is visible — and it must be DISABLED while the wait
11
+ * lasts: a second prompt would have nowhere to go. The wait may belong to a
12
+ * pending `new-…` chat or to an existing session's NEXT prompt, so the lookup
13
+ * names both slots.
12
14
  */
13
15
 
14
- import { useCallback, useMemo } from 'preact/hooks';
16
+ import { useCallback, useEffect, useMemo, useRef } from 'preact/hooks';
15
17
  import { useWaitingPrompts } from '@/client/hooks/chat/waiting/store';
16
18
  import { useCancelWait } from '@/client/hooks/chat/waiting/cancel';
17
19
  import type { WaitingPrompt } from '@/shared/types/waiting';
20
+ import type { ToastTone } from '@/shared/lib/ui/toast-duration';
21
+
22
+ export interface HeldWaitOptions {
23
+ onNotice?: (message: string, type?: ToastTone) => void;
24
+ /**
25
+ * A prompt held for THIS existing chat was just delivered elsewhere (the
26
+ * server's sweep). The transcript has no local frames for it, so the view
27
+ * asks the session to reload.
28
+ */
29
+ onDispatched?: (sessionId: string) => void;
30
+ }
18
31
 
19
32
  export interface HeldWait {
20
33
  /** The waiting row for the open chat, or null. */
@@ -22,21 +35,33 @@ export interface HeldWait {
22
35
  cancelHeldWait: () => void;
23
36
  }
24
37
 
25
- export function useHeldWait(
26
- sessionId: string | null,
27
- isPendingSession: boolean,
28
- onNotice?: (message: string, type?: 'success' | 'error') => void,
29
- ): HeldWait {
38
+ export function useHeldWait(sessionId: string | null, options: HeldWaitOptions = {}): HeldWait {
30
39
  const { prompts } = useWaitingPrompts();
31
- const cancelWait = useCancelWait(onNotice);
40
+ const cancelWait = useCancelWait(options.onNotice);
41
+ const { onDispatched } = options;
32
42
  const heldWait = useMemo(
33
- () => (isPendingSession
34
- ? prompts.find((prompt) => prompt.pendingId === sessionId && prompt.status === 'waiting') ?? null
43
+ () => (sessionId
44
+ ? prompts.find((prompt) => prompt.status === 'waiting'
45
+ && (prompt.pendingId === sessionId || prompt.targetSessionId === sessionId)) ?? null
35
46
  : null),
36
- [isPendingSession, sessionId, prompts],
47
+ [sessionId, prompts],
37
48
  );
38
49
  const cancelHeldWait = useCallback(() => {
39
50
  if (heldWait) cancelWait(heldWait.id);
40
51
  }, [heldWait, cancelWait]);
52
+
53
+ // The sweep writes `dispatched`; nothing else tells an open chat to re-read
54
+ // its own transcript. One reload per row, not per topic frame.
55
+ const dispatchedRef = useRef(new Set<string>());
56
+ useEffect(() => {
57
+ if (!sessionId || !onDispatched) return;
58
+ for (const prompt of prompts) {
59
+ if (prompt.status !== 'dispatched' || prompt.targetSessionId !== sessionId) continue;
60
+ if (dispatchedRef.current.has(prompt.id)) continue;
61
+ dispatchedRef.current.add(prompt.id);
62
+ onDispatched(sessionId);
63
+ }
64
+ }, [prompts, sessionId, onDispatched]);
65
+
41
66
  return { heldWait, cancelHeldWait };
42
67
  }
@@ -46,6 +46,7 @@ function harness(overrides: Partial<HoldDeps> = {}): { deps: HoldDeps; recorded:
46
46
  const recorded: Recorded = { drafts: [], attachments: [], errors: [], cleared: 0, posted: [] };
47
47
  const deps: HoldDeps = {
48
48
  sessionId: pendingId,
49
+ targetSessionId: null,
49
50
  folders: [{ id: 1, name: 'alpha', project_path: '/tmp/alpha', isExpanded: true, hasMore: false, totalSessions: 0, sessions: [] }],
50
51
  selectedFolderId: 1,
51
52
  composerModelRef: { current: { provider: 'anthropic', modelId: 'claude', thinkingLevel: 'high' } },
@@ -107,6 +108,27 @@ describe('holdPromptForDependency', () => {
107
108
  expect(recorded.drafts).toEqual([]);
108
109
  });
109
110
 
111
+ // A NEXT prompt in a chat that already exists is delivered into that chat.
112
+ // It has no pending slot to mark, and the cwd comes from the session itself.
113
+ test('an existing chat targets its own session and needs no pending cue', async () => {
114
+ const { deps, recorded } = harness({
115
+ sessionId: 'sess-open',
116
+ targetSessionId: 'sess-open',
117
+ selectedFolderId: null,
118
+ folders: [],
119
+ });
120
+ expect(await holdPromptForDependency(deps, DEPENDENCY, 'do it after', [])).toBe(true);
121
+ expect(createdBody).toMatchObject({
122
+ pendingId: null,
123
+ targetSessionId: 'sess-open',
124
+ dependsOn: 'sess-a',
125
+ prompt: 'do it after',
126
+ cwd: '',
127
+ });
128
+ expect(recorded.drafts).toEqual(['']);
129
+ expect(recorded.errors).toEqual([]);
130
+ });
131
+
110
132
  // The dropdown was opened while the dependency was running; by the time the
111
133
  // user hit send it had finished. Holding would be a wait of zero length.
112
134
  test('a dependency that finished meanwhile sends instead, and says so', async () => {
@@ -46,24 +46,30 @@ export interface ComposerHoldDeps {
46
46
  waitingDependencyRef?: { current: WaitingCandidate | null };
47
47
  }
48
48
 
49
+ /** A pending chat has no omp id yet; everything else is a real session. */
50
+ function isPendingChat(sessionId: string | null): boolean {
51
+ return !sessionId || sessionId.startsWith('new-');
52
+ }
53
+
49
54
  /**
50
- * The composer's own entry point: hold the draft if a dependency is picked and
51
- * the chat is idle, else answer false and let the normal send proceed.
55
+ * The composer's own entry point: hold the draft if a dependency is picked,
56
+ * else answer false and let the normal send proceed.
52
57
  *
53
- * Idle is part of the condition rather than the caller's business: a chat with
54
- * a run in flight queues its follow-up (or steers), which is a different
55
- * decision made further down the send path.
58
+ * A chat with a run in flight is NOT excluded: holding is a deferral to another
59
+ * session, not a send, so it is the one path that may run while this chat is
60
+ * busy. The running chat's own follow-up still takes the queue branch, because
61
+ * without a pick this function returns false and the send path queues it.
56
62
  */
57
63
  export async function holdFromComposer(
58
64
  deps: ComposerHoldDeps,
59
65
  text: string,
60
66
  attachments: Attachment[],
61
- busy: boolean,
62
67
  ): Promise<boolean> {
63
68
  const choice = deps.waitingDependencyRef?.current ?? null;
64
- if (!choice || busy) return false;
69
+ if (!choice) return false;
65
70
  return holdPromptForDependency({
66
71
  sessionId: deps.sessionId,
72
+ targetSessionId: isPendingChat(deps.sessionId) ? null : deps.sessionId,
67
73
  folders: deps.folders,
68
74
  selectedFolderId: deps.selectedFolderId,
69
75
  composerModelRef: deps.composerModelRef,
@@ -79,6 +85,8 @@ export async function holdFromComposer(
79
85
 
80
86
  export interface HoldDeps {
81
87
  sessionId: string | null;
88
+ /** The existing chat this prompt is sent into; null for a pending chat. */
89
+ targetSessionId: string | null;
82
90
  folders: WorkspaceFolderData[];
83
91
  selectedFolderId: number | null;
84
92
  composerModelRef: { current: { provider: string; modelId: string; thinkingLevel: string } | null };
@@ -114,8 +122,8 @@ export async function holdPromptForDependency(
114
122
  return false;
115
123
  }
116
124
  const folder = deps.folders.find((entry) => String(entry.id) === String(deps.selectedFolderId));
117
- const cwd = folder?.project_path || folder?.name;
118
- if (!cwd) {
125
+ const cwd = folder?.project_path || folder?.name || '';
126
+ if (!cwd && !deps.targetSessionId) {
119
127
  deps.reportActionError('Pick a workspace before holding this prompt.');
120
128
  return false;
121
129
  }
@@ -126,7 +134,8 @@ export async function holdPromptForDependency(
126
134
  const composerPick = deps.composerModelRef.current;
127
135
  try {
128
136
  const created = await createWaitingPromptRequest({
129
- pendingId: deps.sessionId,
137
+ pendingId: deps.targetSessionId ? null : deps.sessionId,
138
+ targetSessionId: deps.targetSessionId,
130
139
  dependsOn: dependency.id,
131
140
  dependsOnTitle: dependency.title,
132
141
  prompt: text,
@@ -136,7 +145,7 @@ export async function holdPromptForDependency(
136
145
  cwd,
137
146
  folderId: folder ? Number(folder.id) : null,
138
147
  });
139
- if (deps.sessionId) {
148
+ if (deps.sessionId && !deps.targetSessionId) {
140
149
  markPendingSessionWaiting(deps.sessionId, {
141
150
  waitId: created.id,
142
151
  dependsOn: dependency.id,
@@ -0,0 +1,69 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Cancelling or failing a held prompt must return its text.
8
+ *
9
+ * The send path clears the composer when it creates the row, so the row is the
10
+ * only copy remaining. These cases pin where that copy goes back: the pending
11
+ * chat's draft slot, or the existing session's — and nowhere at all when the row
12
+ * names neither.
13
+ */
14
+
15
+ import { afterEach, describe, expect, test } from 'bun:test';
16
+ import { restoreHeldDraft, waitingDraftSessionId } from '@/client/hooks/chat/waiting/restore';
17
+ import { forgetSession, getSessionValue } from '@/shared/lib/workspace/session-state/store';
18
+ import { CHAT_DRAFT_ATTACHMENTS_KEY, CHAT_DRAFT_KEY } from '@/shared/lib/chat/composer/draft';
19
+ import type { WaitingPrompt } from '@/shared/types/waiting';
20
+
21
+ function prompt(overrides: Partial<WaitingPrompt> = {}): WaitingPrompt {
22
+ return {
23
+ id: 'wait-1',
24
+ pendingId: 'new-1',
25
+ dependsOn: 'sess-a',
26
+ dependsOnTitle: 'Session A',
27
+ targetSessionId: null,
28
+ prompt: 'summarise the diff',
29
+ attachments: [{ id: 'a1', preview: 'data:text/plain;base64,aGk=', name: 'notes.txt', content: 'hi' }],
30
+ model: null,
31
+ modes: null,
32
+ cwd: '/tmp/project',
33
+ folderId: 1,
34
+ status: 'cancelled',
35
+ sessionId: null,
36
+ error: null,
37
+ createdAt: 0,
38
+ updatedAt: 0,
39
+ ...overrides,
40
+ };
41
+ }
42
+
43
+ afterEach(() => {
44
+ forgetSession('new-1');
45
+ forgetSession('sess-open');
46
+ });
47
+
48
+ describe('restoreHeldDraft', () => {
49
+ test('writes a pending chat’s text and attachments back into its draft', () => {
50
+ restoreHeldDraft(prompt());
51
+ expect(getSessionValue('new-1', CHAT_DRAFT_KEY)).toBe('summarise the diff');
52
+ expect(getSessionValue('new-1', CHAT_DRAFT_ATTACHMENTS_KEY)).toEqual([
53
+ { id: 'a1', preview: 'data:text/plain;base64,aGk=', name: 'notes.txt', content: 'hi' },
54
+ ]);
55
+ });
56
+
57
+ test('restores a next prompt into the session it targeted', () => {
58
+ restoreHeldDraft(prompt({ pendingId: null, targetSessionId: 'sess-open' }));
59
+ expect(waitingDraftSessionId(prompt({ pendingId: null, targetSessionId: 'sess-open' }))).toBe('sess-open');
60
+ expect(getSessionValue('sess-open', CHAT_DRAFT_KEY)).toBe('summarise the diff');
61
+ expect(getSessionValue('new-1', CHAT_DRAFT_KEY)).toBeUndefined();
62
+ });
63
+
64
+ test('a row naming no chat writes nothing', () => {
65
+ restoreHeldDraft(prompt({ pendingId: null, targetSessionId: null }));
66
+ expect(getSessionValue('new-1', CHAT_DRAFT_KEY)).toBeUndefined();
67
+ expect(getSessionValue('sess-open', CHAT_DRAFT_KEY)).toBeUndefined();
68
+ });
69
+ });
@@ -0,0 +1,34 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Put a held prompt's text and attachments back into the composer it came from.
8
+ *
9
+ * The row is the ONLY copy while the prompt waits: the send path clears the
10
+ * draft when it creates the wait. A cancel or a failed dispatch therefore has
11
+ * to write that copy back, or the user's text is gone — it was reachable only
12
+ * through a database row with no UI.
13
+ *
14
+ * The write goes through the session-state store rather than a component setter
15
+ * because the cancel may start from the sidebar for a chat that is not mounted.
16
+ * A mounted composer follows the slot (`useComposerDraft` subscribes), and an
17
+ * unmounted one reads it on the next open.
18
+ */
19
+
20
+ import { CHAT_DRAFT_ATTACHMENTS_KEY, CHAT_DRAFT_KEY } from '@/shared/lib/chat/composer/draft';
21
+ import { setSessionKey } from '@/shared/lib/workspace/session-state/store';
22
+ import type { WaitingPrompt } from '@/shared/types/waiting';
23
+
24
+ /** The chat a prompt belongs to: the pending slot, else the session it targets. */
25
+ export function waitingDraftSessionId(prompt: WaitingPrompt): string | null {
26
+ return prompt.pendingId ?? prompt.targetSessionId;
27
+ }
28
+
29
+ export function restoreHeldDraft(prompt: WaitingPrompt): void {
30
+ const sessionId = waitingDraftSessionId(prompt);
31
+ if (!sessionId) return;
32
+ setSessionKey(sessionId, CHAT_DRAFT_KEY, prompt.prompt);
33
+ setSessionKey(sessionId, CHAT_DRAFT_ATTACHMENTS_KEY, prompt.attachments);
34
+ }
@@ -70,6 +70,7 @@ export function useWaitingPrompts(): WaitingPromptsState {
70
70
  /** Create a held prompt. Throws the server's own reason on a refusal. */
71
71
  export async function createWaitingPromptRequest(input: {
72
72
  pendingId: string | null;
73
+ targetSessionId: string | null;
73
74
  dependsOn: string;
74
75
  dependsOnTitle: string | null;
75
76
  prompt: string;
@@ -91,10 +92,15 @@ export async function createWaitingPromptRequest(input: {
91
92
  return data.prompt as WaitingPrompt;
92
93
  }
93
94
 
94
- /** Cancel a held prompt. Returns the server's refusal rather than swallowing it. */
95
- export async function cancelWaitingPromptRequest(id: string): Promise<{ ok: boolean; error?: string }> {
95
+ /** Cancel a held prompt. Returns the server's refusal rather than swallowing it,
96
+ * and the cancelled row so the caller can restore its draft. */
97
+ export async function cancelWaitingPromptRequest(
98
+ id: string,
99
+ ): Promise<{ ok: boolean; error?: string; prompt?: WaitingPrompt }> {
96
100
  const response = await fetch(`/api/waiting?id=${encodeURIComponent(id)}`, { method: 'DELETE' });
97
- if (response.ok) return { ok: true };
98
101
  const data = await response.json().catch(() => null);
102
+ if (response.ok) {
103
+ return { ok: true, ...(data?.prompt ? { prompt: data.prompt as WaitingPrompt } : {}) };
104
+ }
99
105
  return { ok: false, error: typeof data?.error === 'string' ? data.error : `HTTP ${response.status}` };
100
106
  }
@@ -17,6 +17,7 @@ export type FileEditorSaveStatus = 'idle' | 'saving' | 'saved' | 'error' | 'need
17
17
  import type { ViewerKind } from '@/shared/lib/fs/document-kind';
18
18
  import type { LineEnding } from '@/shared/lib/code/line-endings';
19
19
  import type { ByteSource } from '@/client/components/workspace/editor/viewers/bytes';
20
+ import type { DiskDigest } from '@/client/hooks/editor/use-disk-digest';
20
21
 
21
22
  /** The single file a code surface is editing; `id` keys the in-memory cache. */
22
23
  export interface FileEditorTarget {
@@ -203,21 +204,29 @@ export interface UseFileEditorResult {
203
204
  */
204
205
  resolveConflictByKeepingMine: () => void;
205
206
  /**
206
- * Throw the buffer away and take the file from disk.
207
+ * Re-read the active file from disk, discarding the buffer's edits.
207
208
  *
208
- * The user-facing Revert. Distinct from `reset()` (a workspace refresh, which
209
- * deliberately KEEPS a dirty buffer) and from `resolveConflictByReload` only in
210
- * that it needs no conflict to exist — the reason to revert is usually that the
211
- * user wants the disk copy back, not that anyone else wrote it.
209
+ * The user-facing Reload, offered even for a clean buffer: it is the manual
210
+ * counterpart of the automatic refresh, and it is the only way to force a read
211
+ * of a file whose digest the watcher has not compared yet. Distinct from
212
+ * `reset()` (a workspace refresh, which deliberately KEEPS a dirty buffer).
212
213
  */
213
- revertToDisk: () => void;
214
+ reloadFromDisk: () => void;
214
215
  /**
215
- * Adopt the disk's mtime as this buffer's base WITHOUT writing anything.
216
+ * The disk bytes differ from a buffer that HAS edits, or null.
216
217
  *
217
- * The answer to an external-change notice when the user wants to keep editing:
218
- * their next save must not be refused with a `409` over a change they have
219
- * already been shown and accepted. Nothing is written here — the buffer stays
220
- * dirty and the autosave owns the write.
218
+ * Nothing is replaced: the panel renders this as the external-change strip so
219
+ * the user chooses between the two copies. A clean buffer never reports here —
220
+ * it is re-read, because there is nothing of the user's to lose.
221
221
  */
222
- adoptDiskMtime: (diskMtimeMs: number) => void;
222
+ diskChange: DiskDigest | null;
223
+ /**
224
+ * Answer an external-change notice with the user's buffer.
225
+ *
226
+ * Adopts the disk's mtime as the buffer's base WITHOUT writing anything — the
227
+ * buffer stays dirty and the autosave owns the write — and dismisses the notice,
228
+ * so the same change is not reported again. A later change is a new hash and
229
+ * asks again.
230
+ */
231
+ keepMineAgainstDisk: () => void;
223
232
  }
@@ -94,7 +94,7 @@ describe('saveEditorFile — the request it builds', () => {
94
94
  const writes = stubWrite({ ok: true, body: { success: true } });
95
95
  const outcome = await saveEditorFile({ path: 'src/a.ts', root: '/repo' }, 'const a = 1;\n', 'lf', { interactive: false });
96
96
 
97
- expect(outcome).toEqual({ status: 'written' });
97
+ expect(outcome).toEqual({ status: 'written', written: { mtimeMs: null, hash: null } });
98
98
  expect(writes.length).toBe(1);
99
99
  expect(writes[0].url).toBe('/api/fs/action');
100
100
  expect(writes[0].method).toBe('POST');
@@ -26,6 +26,7 @@
26
26
 
27
27
  import type { LineEnding } from '@/shared/lib/code/line-endings';
28
28
  import { writeThroughHandle, type HandleWriteResult } from '@/client/lib/launch/file-handlers';
29
+ import { contentHash } from '@/shared/lib/fs/content-hash';
29
30
 
30
31
  interface SavableFile {
31
32
  path?: string;
@@ -34,9 +35,23 @@ interface SavableFile {
34
35
  handleId?: string;
35
36
  }
36
37
 
38
+ /**
39
+ * What the disk holds after a save landed.
40
+ *
41
+ * Both facts belong to the WRITTEN bytes, not to the buffer: the server rebuilt
42
+ * them from the buffer's LF text and the file's own ending, so it is the only
43
+ * place that can say what the disk now contains. The mtime is the next save's
44
+ * conflict base; the hash is the auto-refresh watcher's baseline, and without it
45
+ * the watcher would report the user's own save as an external change.
46
+ */
47
+ export interface WrittenFile {
48
+ mtimeMs: number | null;
49
+ hash: string | null;
50
+ }
51
+
37
52
  /** What a save attempt answers. */
38
53
  export type SaveOutcome =
39
- | { status: 'written' }
54
+ | { status: 'written'; written: WrittenFile }
40
55
  /** The buffer is behind the disk copy: `diskMtimeMs` is what is there now. */
41
56
  | { status: 'conflict'; diskMtimeMs: number | null }
42
57
  /** The write was refused for a reason that is not a conflict (a 4xx/5xx, a drop). */
@@ -50,6 +65,8 @@ interface SaveResponse {
50
65
  error?: unknown;
51
66
  /** Present on a `409`: the mtime the file holds now. */
52
67
  mtimeMs?: unknown;
68
+ /** Present on success: the content hash of the bytes just written. */
69
+ hash?: unknown;
53
70
  conflict?: unknown;
54
71
  }
55
72
 
@@ -82,12 +99,14 @@ export async function saveEditorFile(
82
99
  options: { interactive: boolean; baseMtimeMs?: number | null },
83
100
  ): Promise<SaveOutcome> {
84
101
  if (file.handleId) {
85
- const result: HandleWriteResult = await writeThroughHandle(
86
- file.handleId,
87
- eol === 'crlf' ? lfText.replace(/\n/g, '\r\n') : lfText,
88
- { interactive: options.interactive },
89
- );
90
- if (result === 'written') return { status: 'written' };
102
+ const diskText = eol === 'crlf' ? lfText.replace(/\n/g, '\r\n') : lfText;
103
+ const result: HandleWriteResult = await writeThroughHandle(file.handleId, diskText, {
104
+ interactive: options.interactive,
105
+ });
106
+ // A handle write never reaches the server, so the digest is computed here from
107
+ // the exact bytes handed over — the same UTF-8 hash every other producer uses.
108
+ // No mtime: there is no server path to stat.
109
+ if (result === 'written') return { status: 'written', written: { mtimeMs: null, hash: await contentHash(diskText) } };
91
110
  if (result === 'needs-permission') return { status: 'needs-permission' };
92
111
  return { status: 'failed' };
93
112
  }
@@ -111,7 +130,15 @@ export async function saveEditorFile(
111
130
  const diskMtimeMs = typeof data?.mtimeMs === 'number' ? data.mtimeMs : null;
112
131
  return { status: 'conflict', diskMtimeMs };
113
132
  }
114
- if (res.ok && data?.success) return { status: 'written' };
133
+ if (res.ok && data?.success) {
134
+ return {
135
+ status: 'written',
136
+ written: {
137
+ mtimeMs: typeof data.mtimeMs === 'number' ? data.mtimeMs : null,
138
+ hash: typeof data.hash === 'string' ? data.hash : null,
139
+ },
140
+ };
141
+ }
115
142
  return { status: 'failed' };
116
143
  } catch {
117
144
  return { status: 'failed' };
@@ -0,0 +1,17 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ import type { FileEditorTarget } from '@/client/hooks/editor/file-editor-types';
7
+
8
+ /**
9
+ * The key a target's buffer is cached under.
10
+ *
11
+ * One rule for every hook that caches by file: the read path, the write path, the
12
+ * conflict machine and the disk watcher all have to agree, or a reload clears a
13
+ * key the read never wrote.
14
+ */
15
+ export function editorTargetKey(target: Pick<FileEditorTarget, 'id' | 'path' | 'name'>): string {
16
+ return String(target.id ?? target.path ?? target.name);
17
+ }
@@ -0,0 +1,82 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The disk-digest probe the editor's auto-refresh runs.
8
+ *
9
+ * Three rules, and each is a silent failure if broken:
10
+ *
11
+ * - a REFUSED probe is not a verdict — a dropped request must never be read as
12
+ * "the disk changed" and replace a buffer;
13
+ * - a file that is GONE is the tab strip's strike-through, not a change;
14
+ * - a file with no hash (too large for the editor, unreadable) has nothing to
15
+ * compare, so it is no verdict either.
16
+ */
17
+
18
+ import { afterEach, describe, expect, test } from 'bun:test';
19
+
20
+ import { probeDiskDigest } from '@/client/hooks/editor/use-disk-digest';
21
+
22
+ const nativeFetch = Bun.fetch;
23
+
24
+ afterEach(() => {
25
+ globalThis.fetch = nativeFetch;
26
+ });
27
+
28
+ /** Answer the probe with `body`, or refuse it. */
29
+ function stub(body: unknown, ok = true): void {
30
+ globalThis.fetch = (async () => ({
31
+ ok,
32
+ json: async () => body,
33
+ })) as unknown as typeof fetch;
34
+ }
35
+
36
+ describe('probeDiskDigest', () => {
37
+ test('a file with a hash is a verdict carrying both facts', async () => {
38
+ stub({ exists: true, mtimeMs: 100, hash: 'abc' });
39
+ expect(await probeDiskDigest('/a.ts', null, null)).toEqual({ hash: 'abc', mtimeMs: 100 });
40
+ });
41
+
42
+ test('a missing file is not a change — the tab strip owns that fact', async () => {
43
+ stub({ exists: false, mtimeMs: null, hash: null });
44
+ expect(await probeDiskDigest('/a.ts', null, null)).toBe('gone');
45
+ });
46
+
47
+ test('a file with no hash is no verdict', async () => {
48
+ stub({ exists: true, mtimeMs: 100, hash: null });
49
+ expect(await probeDiskDigest('/a.ts', null, null)).toBe('unknown');
50
+ });
51
+
52
+ test('a refused probe is NO VERDICT, never a change', async () => {
53
+ stub({ exists: true, mtimeMs: 100, hash: 'abc' }, false);
54
+ expect(await probeDiskDigest('/a.ts', null, null)).toBe('unknown');
55
+ });
56
+
57
+ test('a malformed body is no verdict', async () => {
58
+ stub({ exists: 'yes' });
59
+ expect(await probeDiskDigest('/a.ts', null, null)).toBe('unknown');
60
+ stub(null);
61
+ expect(await probeDiskDigest('/a.ts', null, null)).toBe('unknown');
62
+ });
63
+
64
+ test('a dropped connection is no verdict', async () => {
65
+ globalThis.fetch = (async () => {
66
+ throw new Error('offline');
67
+ }) as unknown as typeof fetch;
68
+ expect(await probeDiskDigest('/a.ts', null, null)).toBe('unknown');
69
+ });
70
+
71
+ test('the scope travels with the probe, so a nested repo is read from its own tree', async () => {
72
+ const seen: string[] = [];
73
+ globalThis.fetch = (async (input: unknown) => {
74
+ seen.push(String(input));
75
+ return { ok: true, json: async () => ({ exists: true, mtimeMs: 100, hash: 'abc' }) };
76
+ }) as unknown as typeof fetch;
77
+ await probeDiskDigest('a.ts', '/repo', 'nested');
78
+ expect(seen[0]).toContain('/api/fs/digest');
79
+ expect(seen[0]).toContain('root=%2Frepo');
80
+ expect(seen[0]).toContain('repo=nested');
81
+ });
82
+ });