@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
@@ -71,13 +71,20 @@ export interface UseFileReadOptions {
71
71
  /** The queued write, which owns the key if it is still pending. */
72
72
  pendingRef: LiveRef<PendingWrite | null>;
73
73
  /**
74
- * Store bytes, the line ending they arrived with, and the mtime they were read
75
- * at.
74
+ * How many reads are in flight, so the auto-refresh watcher does not ask for a
75
+ * second one while the first is still on its way.
76
+ */
77
+ readingRef: LiveRef<number>;
78
+ /**
79
+ * Store bytes, the line ending they arrived with, the mtime they were read at,
80
+ * and the hash of those bytes.
76
81
  *
77
82
  * The mtime is the save path's conflict base: a write whose base no longer
78
83
  * matches the disk is refused rather than clobbering another writer's change.
84
+ * The hash is the auto-refresh watcher's baseline: a file that still hashes
85
+ * the same has not changed, however far its mtime moved.
79
86
  */
80
- remember: (fileKey: string, text: string, mtimeMs: number | null) => void;
87
+ remember: (fileKey: string, text: string, mtimeMs: number | null, hash: string | null) => void;
81
88
  }
82
89
 
83
90
  export interface FileReadState {
@@ -101,6 +108,7 @@ export function useFileRead({
101
108
  contentsRef,
102
109
  baselinesRef,
103
110
  pendingRef,
111
+ readingRef,
104
112
  remember,
105
113
  }: UseFileReadOptions): FileReadState {
106
114
  const [isLoading, setIsLoading] = useState(false);
@@ -129,7 +137,7 @@ export function useFileRead({
129
137
  if (target.content !== undefined) {
130
138
  // Inline content (an attachment chip) has no file behind it, so there is no
131
139
  // mtime to check a later write against.
132
- remember(fileKey, target.content, null);
140
+ remember(fileKey, target.content, null, null);
133
141
  setLoadError(null);
134
142
  setUnsupported(null);
135
143
  return;
@@ -153,10 +161,11 @@ export function useFileRead({
153
161
  const params = new URLSearchParams({ path: target.path });
154
162
  if (target.root) params.set('root', target.root);
155
163
  if (target.repo && target.repo !== '.') params.set('repo', target.repo);
164
+ readingRef.current += 1;
156
165
  fetch(`/api/fs/read?${params.toString()}`)
157
166
  .then(async (res) => {
158
167
  const data = (await res.json().catch(() => null)) as
159
- | { content?: unknown; error?: string; kind?: 'binary' | 'too-large'; mtimeMs?: unknown }
168
+ | { content?: unknown; error?: string; kind?: 'binary' | 'too-large'; mtimeMs?: unknown; hash?: unknown }
160
169
  | null;
161
170
  if (!res.ok || !data || typeof data.content !== 'string') {
162
171
  const error: FileReadError = new Error(data?.error || `HTTP ${res.status}`);
@@ -166,9 +175,13 @@ export function useFileRead({
166
175
  else if (res.status === 415) error.kind = 'binary';
167
176
  throw error;
168
177
  }
169
- return { text: data.content, mtimeMs: typeof data.mtimeMs === 'number' ? data.mtimeMs : null };
178
+ return {
179
+ text: data.content,
180
+ mtimeMs: typeof data.mtimeMs === 'number' ? data.mtimeMs : null,
181
+ hash: typeof data.hash === 'string' ? data.hash : null,
182
+ };
170
183
  })
171
- .then(({ text, mtimeMs }) => {
184
+ .then(({ text, mtimeMs, hash }) => {
172
185
  if (cancelled) return;
173
186
  // These bytes were read before the response arrived, so anything typed
174
187
  // since is newer. Applying them would replace those keystrokes (and,
@@ -178,7 +191,7 @@ export function useFileRead({
178
191
  if (typed !== undefined && typed !== baselinesRef.current[fileKey]) return;
179
192
  const queued = pendingRef.current;
180
193
  if (queued && targetKey(queued.file) === fileKey) return;
181
- remember(fileKey, text, mtimeMs);
194
+ remember(fileKey, text, mtimeMs, hash);
182
195
  })
183
196
  .catch((err: unknown) => {
184
197
  if (cancelled) return;
@@ -186,20 +199,21 @@ export function useFileRead({
186
199
  if (!firstLoad) return;
187
200
  // An empty buffer, never a substitute: the next save would write the
188
201
  // substitute over the real file.
189
- remember(fileKey, '', null);
202
+ remember(fileKey, '', null, null);
190
203
  const message = err instanceof Error ? err.message : 'Failed to read file';
191
204
  const kind = (err as FileReadError)?.kind;
192
205
  setUnsupported(kind ? message : null);
193
206
  setLoadError(message);
194
207
  })
195
208
  .finally(() => {
209
+ readingRef.current -= 1;
196
210
  if (!cancelled) setIsLoading(false);
197
211
  });
198
212
 
199
213
  return () => {
200
214
  cancelled = true;
201
215
  };
202
- }, [key, target, remember, revision, isBinaryViewer, loadedRef, contentsRef, baselinesRef, pendingRef]);
216
+ }, [key, target, remember, revision, isBinaryViewer, loadedRef, contentsRef, baselinesRef, pendingRef, readingRef]);
203
217
 
204
218
  return { isLoading, loadError, unsupported };
205
219
  }
@@ -28,7 +28,7 @@
28
28
  import { useCallback, useEffect, useRef, useState } from 'preact/hooks';
29
29
  import { fileHandleFor } from '@/client/lib/launch/file-handlers';
30
30
  import type { LineEnding } from '@/shared/lib/code/line-endings';
31
- import { saveEditorFile } from '@/client/hooks/editor/save-file';
31
+ import { saveEditorFile, type WrittenFile } from '@/client/hooks/editor/save-file';
32
32
  import type { FileEditorTarget } from '@/client/hooks/editor/use-file-editor';
33
33
 
34
34
  /**
@@ -72,8 +72,8 @@ export interface FileWriteDeps {
72
72
  flushOnUnmount: boolean;
73
73
  /** A write started; the toolbar shows `saving`. */
74
74
  onSaveStart: () => void;
75
- /** A write landed; the baseline moves and the workspace re-reads. */
76
- onSaved: (fileKey: string, text: string) => void;
75
+ /** A write landed; the baseline, the conflict base and the digest all move. */
76
+ onSaved: (fileKey: string, text: string, written: WrittenFile) => void;
77
77
  /** A write was refused or dropped. */
78
78
  onSaveFailed: () => void;
79
79
  /**
@@ -161,7 +161,7 @@ export function useFileWrites({
161
161
  interactive: options.interactive === true,
162
162
  baseMtimeMs,
163
163
  });
164
- if (outcome.status === 'written') onSaved(fileKey, text);
164
+ if (outcome.status === 'written') onSaved(fileKey, text, outcome.written);
165
165
  else if (outcome.status === 'needs-permission') onNeedsPermission();
166
166
  else if (outcome.status === 'conflict') onConflict(fileKey, outcome.diskMtimeMs);
167
167
  else onSaveFailed();
@@ -16,6 +16,7 @@
16
16
  import type {
17
17
  HarnessConfig, HarnessProviderSupport, HarnessesPayload, HarnessSummary, LiveHarnessModels,
18
18
  } from '@/shared/types/harness';
19
+ import { registerHarnessDescriptors } from '@/shared/lib/harness/catalog';
19
20
 
20
21
  export interface HarnessStore {
21
22
  harnesses: HarnessSummary[];
@@ -73,6 +74,20 @@ export async function loadCatalog(): Promise<void> {
73
74
  })
74
75
  .then((payload) => {
75
76
  loaded = true;
77
+ // A user-added harness has no entry in the build's static catalog, and the
78
+ // glyph/badge helpers are synchronous. Publish the descriptors the server
79
+ // answered before any surface renders a row for one.
80
+ registerHarnessDescriptors(
81
+ (payload.harnesses ?? [])
82
+ .filter((entry) => entry.custom)
83
+ .map((entry) => ({
84
+ id: entry.id,
85
+ label: entry.label,
86
+ initial: entry.initial ?? entry.label.charAt(0).toUpperCase(),
87
+ transport: entry.transport,
88
+ glyph: 'custom' as const,
89
+ })),
90
+ );
76
91
  emit({
77
92
  harnesses: Array.isArray(payload.harnesses) ? payload.harnesses : [],
78
93
  // Absent from an answer written before per-harness config existed: an
@@ -6,19 +6,28 @@
6
6
  /**
7
7
  * The one gate every system notification passes through.
8
8
  *
9
- * Two rules, and both are the feature rather than plumbing:
9
+ * Three rules, and all of them are the feature rather than plumbing:
10
10
  *
11
11
  * - the event's own setting must be the literal `true` (they ship false);
12
- * - the page must not be the window the user is looking at. The sidebar badge,
13
- * the ask card and the inline error row already report these events on
14
- * screen, so a banner over the app would only repeat what is visible.
12
+ * - the master switch for THIS device class (`Desktop` / `Mobile`) must not be
13
+ * `false` — the two switches exist so a phone can stay quiet while a desktop
14
+ * banners, and vice versa;
15
+ * - the banner is sent in every window state. Focus is not a gate: the user
16
+ * asked to be told, and the OS decides how to present a banner for the app it
17
+ * belongs to (the shells install a foreground presentation delegate for
18
+ * exactly this reason). The sidebar badge stays the in-app record.
15
19
  *
16
20
  * Text is clipped here because a failure reason can be a whole provider
17
21
  * response; an OS notification is a headline, not a log.
18
22
  */
19
23
 
20
- import { isNotificationEnabled, type NotificationEvent } from '@/shared/lib/notifications/settings';
21
- import { showOsNotification, shouldShowSystemNotification } from '@/client/lib/notifications/os';
24
+ import {
25
+ isNotificationEnabled,
26
+ isNotificationPlatformEnabled,
27
+ type NotificationEvent,
28
+ } from '@/shared/lib/notifications/settings';
29
+ import { showOsNotification } from '@/client/lib/notifications/os';
30
+ import { notificationPlatformForClient } from '@/client/lib/notifications/platform';
22
31
 
23
32
  const TITLE_LIMIT = 120;
24
33
  const BODY_LIMIT = 240;
@@ -29,13 +38,13 @@ function clip(text: string, limit: number): string {
29
38
  return `${trimmed.slice(0, limit - 1).trimEnd()}…`;
30
39
  }
31
40
 
32
- /** Send a system notification for `event`, unless the setting or focus says no. */
41
+ /** Send a system notification for `event`, unless its setting or platform switch says no. */
33
42
  export function sendNotification(
34
43
  event: NotificationEvent,
35
44
  notification: { title: string; body: string; tag?: string; sessionId?: string },
36
45
  ): void {
37
46
  if (!isNotificationEnabled(event)) return;
38
- if (!shouldShowSystemNotification()) return;
47
+ if (!isNotificationPlatformEnabled(notificationPlatformForClient())) return;
39
48
  void showOsNotification({
40
49
  title: clip(notification.title, TITLE_LIMIT) || 'Kabmo',
41
50
  body: clip(notification.body, BODY_LIMIT),
@@ -55,7 +55,7 @@ interface PanelRegistryState {
55
55
  /**
56
56
  * Every panel id switched off — a bare built-in view id, or `plugin:<id>`.
57
57
  * Read by the built-in registrations and the activity bar; the single source
58
- * of "is this panel on", shared with the Panel Plugins switches.
58
+ * of "is this panel on", shared with the Plugins Kabmo switches.
59
59
  */
60
60
  disabledPanels: string[];
61
61
  /** The last known freshness of each git-installed plugin, by plugin id. */
@@ -24,19 +24,31 @@ export interface ScheduleDraft {
24
24
  prompt: string;
25
25
  kind: ScheduleKind;
26
26
  spec: string;
27
+ harness: string;
28
+ timezone: string;
27
29
  folderId: number | null;
28
30
  sessionId: string | null;
29
31
  model: ScheduledTaskModel | null;
30
32
  }
31
33
 
32
- async function readList(res: Response): Promise<ScheduledTask[] | null> {
33
- const data = (await res.json().catch(() => null)) as { tasks?: ScheduledTask[]; error?: string } | null;
34
+ /** The schedule topic's payload: the list plus the zone a new task defaults to. */
35
+ export interface ScheduleSnapshot {
36
+ tasks: ScheduledTask[];
37
+ serverTimeZone: string;
38
+ }
39
+
40
+ async function readList(res: Response): Promise<ScheduleSnapshot | null> {
41
+ const data = (await res.json().catch(() => null)) as
42
+ | { tasks?: ScheduledTask[]; serverTimeZone?: string; error?: string }
43
+ | null;
34
44
  if (!res.ok || !data || data.error) return null;
35
- return data.tasks ?? [];
45
+ return { tasks: data.tasks ?? [], serverTimeZone: data.serverTimeZone ?? '' };
36
46
  }
37
47
 
38
48
  export interface ScheduleController {
39
49
  tasks: ScheduledTask[];
50
+ /** The server's IANA zone; a new task defaults to it. */
51
+ serverTimeZone: string;
40
52
  loading: boolean;
41
53
  error: string | null;
42
54
  refresh: () => Promise<void>;
@@ -49,15 +61,17 @@ export interface ScheduleController {
49
61
 
50
62
  export function useScheduledTasks(active: boolean): ScheduleController {
51
63
  const [tasks, setTasks] = useState<ScheduledTask[]>([]);
64
+ const [serverTimeZone, setServerTimeZone] = useState('');
52
65
  const [loading, setLoading] = useState(false);
53
66
  const [error, setError] = useState<string | null>(null);
54
67
 
55
68
  const refresh = useCallback(async () => {
56
69
  setLoading(true);
57
70
  try {
58
- const list = await readList(await fetch('/api/schedule'));
59
- if (list) {
60
- setTasks(list);
71
+ const snapshot = await readList(await fetch('/api/schedule'));
72
+ if (snapshot) {
73
+ setTasks(snapshot.tasks);
74
+ if (snapshot.serverTimeZone) setServerTimeZone(snapshot.serverTimeZone);
61
75
  setError(null);
62
76
  } else {
63
77
  setError('Could not load scheduled tasks.');
@@ -72,10 +86,11 @@ export function useScheduledTasks(active: boolean): ScheduleController {
72
86
  // The schedule topic is the read path: a snapshot on subscribe, then a push
73
87
  // whenever a task is written — by this tab, another tab, or the runtime's own
74
88
  // fire. `refresh` stays for a caller that needs an immediate re-read.
75
- const topic = useRealtimeTopic<ScheduledTask[]>(TOPIC_SCHEDULE, { enabled: active });
89
+ const topic = useRealtimeTopic<ScheduleSnapshot>(TOPIC_SCHEDULE, { enabled: active });
76
90
  useEffect(() => {
77
91
  if (!topic.data) return;
78
- setTasks(topic.data);
92
+ setTasks(topic.data.tasks);
93
+ if (topic.data.serverTimeZone) setServerTimeZone(topic.data.serverTimeZone);
79
94
  setLoading(false);
80
95
  setError(null);
81
96
  }, [topic.data]);
@@ -139,7 +154,7 @@ export function useScheduledTasks(active: boolean): ScheduleController {
139
154
  }
140
155
  }, []);
141
156
 
142
- return { tasks, loading, error, refresh, create, patch, remove, runNow, loadRuns };
157
+ return { tasks, serverTimeZone, loading, error, refresh, create, patch, remove, runNow, loadRuns };
143
158
  }
144
159
 
145
160
  /**
@@ -154,6 +169,6 @@ export function useScheduledTasks(active: boolean): ScheduleController {
154
169
  export function useScheduledTaskCount(): number {
155
170
  // Derived from the SAME topic the modal reads, so the badge cannot disagree
156
171
  // with the list, and the modal's own writes reach it without an event.
157
- const topic = useRealtimeTopic<ScheduledTask[]>(TOPIC_SCHEDULE);
158
- return useMemo(() => (topic.data ?? []).filter((task) => task.enabled).length, [topic.data]);
172
+ const topic = useRealtimeTopic<ScheduleSnapshot>(TOPIC_SCHEDULE);
173
+ return useMemo(() => (topic.data?.tasks ?? []).filter((task) => task.enabled).length, [topic.data]);
159
174
  }
@@ -3,14 +3,13 @@
3
3
  * SPDX-License-Identifier: MIT
4
4
  */
5
5
 
6
- /** The one rule that decides whether an OS banner is worth sending. */
6
+ /** Permission, the two transports, and the refusals that must stay quiet. */
7
7
 
8
8
  import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
9
9
  import { Window } from 'happy-dom';
10
10
 
11
11
  import {
12
12
  requestNotificationPermission,
13
- shouldShowSystemNotification,
14
13
  showOsNotification,
15
14
  } from '@/client/lib/notifications/os';
16
15
 
@@ -32,34 +31,6 @@ afterEach(() => {
32
31
  for (const key of DOM_GLOBALS) target[key] = nativeGlobals[key];
33
32
  });
34
33
 
35
- function setVisibility(value: 'visible' | 'hidden'): void {
36
- Object.defineProperty(document, 'visibilityState', { configurable: true, value });
37
- }
38
-
39
- function setFocus(value: boolean): void {
40
- Object.defineProperty(document, 'hasFocus', { configurable: true, value: () => value });
41
- }
42
-
43
- describe('shouldShowSystemNotification', () => {
44
- test('a backgrounded tab is worth a banner', () => {
45
- setVisibility('hidden');
46
- setFocus(false);
47
- expect(shouldShowSystemNotification()).toBe(true);
48
- });
49
-
50
- test('a desktop window behind another app is worth a banner', () => {
51
- setVisibility('visible');
52
- setFocus(false);
53
- expect(shouldShowSystemNotification()).toBe(true);
54
- });
55
-
56
- test('the window the user is reading is not', () => {
57
- setVisibility('visible');
58
- setFocus(true);
59
- expect(shouldShowSystemNotification()).toBe(false);
60
- });
61
- });
62
-
63
34
  describe('a browser without the Notification API', () => {
64
35
  test('refuses permission instead of throwing', async () => {
65
36
  expect(await requestNotificationPermission()).toBe(false);
@@ -113,18 +113,3 @@ export async function showOsNotification(notification: OsNotification): Promise<
113
113
  console.warn('[notifications] the browser could not show a notification:', error);
114
114
  }
115
115
  }
116
-
117
- /**
118
- * Whether a system notification is worth sending right now.
119
- *
120
- * Only when Kabmo is NOT the window the user is looking at. The sidebar badge
121
- * and the inline error card already say these things on screen; a banner over
122
- * the app the user is reading is noise. `visibilityState` catches a backgrounded
123
- * tab and a paused WebView (both phones), `hasFocus` catches a desktop window
124
- * behind another application.
125
- */
126
- export function shouldShowSystemNotification(): boolean {
127
- if (typeof document === 'undefined') return false;
128
- if (document.visibilityState === 'hidden') return true;
129
- return !document.hasFocus();
130
- }
@@ -0,0 +1,68 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The device class decides which master switch a banner obeys. The distinction
8
+ * that matters: a narrow desktop window reflows the shell but must still answer
9
+ * to the Desktop switch, so width is deliberately not consulted.
10
+ */
11
+
12
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
13
+ import { Window } from 'happy-dom';
14
+
15
+ import {
16
+ isMobileNotificationClient,
17
+ notificationPlatformForClient,
18
+ } from '@/client/lib/notifications/platform';
19
+
20
+ const DOM_GLOBALS = ['window', 'document', 'navigator'] as const;
21
+ const nativeGlobals: Partial<Record<(typeof DOM_GLOBALS)[number], unknown>> = {};
22
+
23
+ function install(userAgent: string, opts: { coarse?: boolean; hoverNone?: boolean } = {}): void {
24
+ const win = new Window({ url: 'http://localhost' });
25
+ Object.defineProperty(win.navigator, 'userAgent', { configurable: true, value: userAgent });
26
+ win.matchMedia = ((query: string) => ({
27
+ matches: (query === '(pointer: coarse)' && opts.coarse === true)
28
+ || (query === '(hover: none)' && opts.hoverNone === true),
29
+ media: query,
30
+ onchange: null,
31
+ addEventListener: () => {},
32
+ removeEventListener: () => {},
33
+ addListener: () => {},
34
+ removeListener: () => {},
35
+ dispatchEvent: () => false,
36
+ })) as unknown as typeof win.matchMedia;
37
+ const target = globalThis as unknown as Record<string, unknown>;
38
+ for (const key of DOM_GLOBALS) {
39
+ if (!(key in nativeGlobals)) nativeGlobals[key] = target[key];
40
+ target[key] = (win as unknown as Record<string, unknown>)[key];
41
+ }
42
+ }
43
+
44
+ beforeEach(() => {
45
+ install('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)');
46
+ });
47
+
48
+ afterEach(() => {
49
+ const target = globalThis as unknown as Record<string, unknown>;
50
+ for (const key of DOM_GLOBALS) target[key] = nativeGlobals[key];
51
+ });
52
+
53
+ describe('isMobileNotificationClient', () => {
54
+ test('a desktop browser is desktop, whatever its window width', () => {
55
+ expect(isMobileNotificationClient()).toBe(false);
56
+ expect(notificationPlatformForClient()).toBe('desktop');
57
+ });
58
+
59
+ test('a phone user agent is mobile', () => {
60
+ install('Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) Mobile/15E148');
61
+ expect(isMobileNotificationClient()).toBe(true);
62
+ });
63
+
64
+ test('a coarse primary pointer is mobile even with a desktop user agent', () => {
65
+ install('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)', { coarse: true, hoverNone: true });
66
+ expect(notificationPlatformForClient()).toBe('mobile');
67
+ });
68
+ });
@@ -0,0 +1,36 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Which device class this client is, for the Notifications page's two delivery
8
+ * switches.
9
+ *
10
+ * This is a DEVICE fact, not a layout one: `App.tsx` also treats a narrow
11
+ * desktop window as mobile so the shell can reflow, but a 700px-wide desktop
12
+ * browser is still a desktop and must honour the Desktop switch. The union is
13
+ * deliberately the same as the touch-device rule (a phone/tablet reports a
14
+ * coarse primary pointer, and iPadOS desktop-class Safari answers the
15
+ * touch-points + `hover: none` pair) plus the phone user agent, which is what
16
+ * the shells and mobile browsers identify themselves with.
17
+ */
18
+
19
+ const MOBILE_UA =
20
+ /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini|Mobile|mobile|CriOS/i;
21
+
22
+ /** Whether this client is a phone or tablet — what the Mobile switch governs. */
23
+ export function isMobileNotificationClient(): boolean {
24
+ if (typeof window === 'undefined' || typeof navigator === 'undefined') return false;
25
+ if (MOBILE_UA.test(navigator.userAgent ?? '')) return true;
26
+ if (typeof window.matchMedia !== 'function') return false;
27
+ if (window.matchMedia('(pointer: coarse)').matches) return true;
28
+ return (
29
+ (navigator.maxTouchPoints ?? 0) > 0 && window.matchMedia('(hover: none)').matches
30
+ );
31
+ }
32
+
33
+ /** The delivery switch this client reads: `mobile` on a phone/tablet, else `desktop`. */
34
+ export function notificationPlatformForClient(): 'desktop' | 'mobile' {
35
+ return isMobileNotificationClient() ? 'mobile' : 'desktop';
36
+ }
@@ -21,6 +21,7 @@ import { ensureTlsCertificate, isTlsEnabledByArgv } from '@/server/lib/lifecycle
21
21
  import { SHELL_ROUTE } from '@/server/lib/lifecycle/shell-route';
22
22
  import { isMockMode } from '@/server/mock.server';
23
23
  import { migrateLegacyDataDir } from '@/server/lib/lifecycle/paths';
24
+ import { pruneHarnessLeases } from '@/server/lib/harness/session-lease.server';
24
25
  import { seedDefaultMarketplace } from '@/server/lib/panels/seed.server';
25
26
  import { installRejectionGuard } from '@/server/lib/lifecycle/rejection-guard';
26
27
  import { installShutdownHandlers, runAfterListenTasks } from '@/server/lib/lifecycle/after-listen';
@@ -31,6 +32,12 @@ import { installShutdownHandlers, runAfterListenTasks } from '@/server/lib/lifec
31
32
  // instance record and the SQLite file all live there.
32
33
  migrateLegacyDataDir();
33
34
 
35
+ // A lease left by a crashed server names a pid that no longer exists. The Stats
36
+ // panel ignores it (it only reads pids in its own sweep), but one file per
37
+ // session ever spawned is unbounded growth, so the boot that owns the directory
38
+ // clears what the previous one could not.
39
+ pruneHarnessLeases();
40
+
34
41
  // Before anything starts a timer, a plugin or a socket: a rejection from code we
35
42
  // do not own (a marketplace plugin's own background loop) must be REPORTED, not
36
43
  // allowed to exit a process that hosts every live session. See the module.