@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
@@ -32,6 +32,7 @@ import { getDb } from '@/server/db.server';
32
32
  import { findPluginDir, discoverPanelPlugins } from '@/server/lib/panels/registry.server';
33
33
  import { readPluginManifest } from '@/server/lib/panels/files.server';
34
34
  import { toManifest } from '@/server/lib/panels/manifest';
35
+ import { pluginSettingsDefinitions } from '@/server/lib/panels/settings-schema.server';
35
36
  import { createPluginStorage } from '@/server/lib/plugins/storage.server';
36
37
  import { createPluginSettings, clearPluginSettingListeners } from '@/server/lib/plugins/settings.server';
37
38
  import { registerRpcMethod, clearPluginRpcMethods } from '@/server/lib/plugins/rpc.server';
@@ -39,6 +40,8 @@ import { createPluginHttp, clearPluginHttpRoutes } from '@/server/lib/plugins/ht
39
40
  import { createPluginRealtime, clearPluginTopic } from '@/server/lib/plugins/realtime.server';
40
41
  import { createPluginEvents, clearPluginEvents } from '@/server/lib/plugins/events.server';
41
42
  import { createPluginBackground, type PluginBackgroundHandle } from '@/server/lib/plugins/background.server';
43
+ import { clearPluginMcp, createPluginMcp } from '@/server/lib/plugins/mcp.server';
44
+ import { insertPluginSchedule, readPluginScheduleState } from '@/server/lib/plugins/schedule-store.server';
42
45
  import { createPluginLogger } from '@/server/lib/plugins/log.server';
43
46
  import type { KabmoPluginApi, KabmoPluginFactory } from '@kabmo-labs/kabmo-sdk';
44
47
 
@@ -139,6 +142,11 @@ export function loadedPluginIds(): string[] {
139
142
  return [...loaded().keys()];
140
143
  }
141
144
 
145
+ /** Every loaded plugin record, in load order — the schedule runner's input. */
146
+ export function loadedPlugins(): LoadedPlugin[] {
147
+ return [...loaded().values()];
148
+ }
149
+
142
150
  /**
143
151
  * Load one plugin's server half.
144
152
  *
@@ -162,6 +170,9 @@ export async function loadPluginServer(pluginId: string): Promise<LoadedPlugin>
162
170
  const entry = join(dir, parsed.server);
163
171
  if (!(await pathExists(entry))) throw new Error(`plugin "${pluginId}" is not built: ${parsed.server} is missing`);
164
172
 
173
+ const settings = await pluginSettingsDefinitions(dir, parsed);
174
+ if ('error' in settings) throw new Error(`plugin "${pluginId}" has an invalid settings schema: ${settings.error}`);
175
+
165
176
  const module = (await import(entry)) as { default?: unknown };
166
177
  if (typeof module.default !== 'function') {
167
178
  throw new Error(`plugin "${pluginId}" has no server factory default export (export default function plugin(api) {})`);
@@ -174,14 +185,16 @@ export async function loadPluginServer(pluginId: string): Promise<LoadedPlugin>
174
185
  };
175
186
 
176
187
  const storage = createPluginStorage(db, pluginId);
177
- const background = createPluginBackground(pluginId);
188
+ // Read BEFORE the factory: a schedule declared during load must adopt the
189
+ // fire time already on disk, or every restart would restart its countdown.
190
+ const background = createPluginBackground(pluginId, Date.now(), await readPluginScheduleState(db, pluginId));
178
191
  const events = createPluginEvents(pluginId);
179
192
 
180
193
  const api: KabmoPluginApi = {
181
194
  pluginId,
182
195
  log: createPluginLogger(pluginId),
183
196
  storage,
184
- settings: createPluginSettings(db, pluginId, parsed.settings ?? {}),
197
+ settings: createPluginSettings(db, pluginId, settings.definitions),
185
198
  rpc: {
186
199
  register(method, definition) {
187
200
  const dispose = registerRpcMethod(pluginId, method, definition);
@@ -193,6 +206,7 @@ export async function loadPluginServer(pluginId: string): Promise<LoadedPlugin>
193
206
  realtime: createPluginRealtime(pluginId),
194
207
  events: events,
195
208
  background: background.api,
209
+ mcp: createPluginMcp(pluginId),
196
210
  onDispose(hook) {
197
211
  if (typeof hook !== 'function') throw new Error('onDispose expects a function');
198
212
  track(hook);
@@ -207,6 +221,11 @@ export async function loadPluginServer(pluginId: string): Promise<LoadedPlugin>
207
221
 
208
222
  try {
209
223
  await (module.default as KabmoPluginFactory)(api);
224
+ // Persist what the factory declared. `INSERT OR IGNORE` keeps a stored fire
225
+ // time, which is the one the in-memory schedule already adopted.
226
+ for (const schedule of background.handle.schedules) {
227
+ await insertPluginSchedule(db, pluginId, schedule.id, schedule.nextRunAt);
228
+ }
210
229
  } catch (error) {
211
230
  await disposePlugin(pluginId);
212
231
  throw new Error(`plugin "${pluginId}" failed to load: ${error instanceof Error ? error.message : String(error)}`);
@@ -231,8 +250,22 @@ export async function disposePlugin(pluginId: string): Promise<void> {
231
250
  clearPluginEvents(pluginId);
232
251
  clearPluginSettingListeners(pluginId);
233
252
  clearPluginTopic(pluginId);
253
+ clearPluginMcp(pluginId);
234
254
  if (!record) return;
235
255
 
256
+ // A service's `stop` is the only thing that releases the child, socket or
257
+ // timer it started. It is not a disposer (the plugin never registered one),
258
+ // so the loader has to run it — reverse order, and one failure must not skip
259
+ // the rest.
260
+ for (const service of [...record.background.services].reverse()) {
261
+ if (!service.stop) continue;
262
+ try {
263
+ await service.stop();
264
+ } catch (error) {
265
+ console.error(`[plugins] ${pluginId}: service "${service.id}" stop threw — ${error instanceof Error ? error.message : String(error)}`);
266
+ }
267
+ }
268
+
236
269
  for (const dispose of [...record.disposers].reverse()) {
237
270
  try {
238
271
  await dispose();
@@ -290,52 +323,3 @@ export async function disposeAllPlugins(): Promise<void> {
290
323
  await disposePlugin(pluginId);
291
324
  }
292
325
  }
293
-
294
- /** How long shutdown waits for a plugin's disposers before giving up. */
295
- const SHUTDOWN_DISPOSE_TIMEOUT_MS = 3_000;
296
-
297
- /**
298
- * Unload every plugin on the way out, BOUNDED so a plugin cannot block the exit.
299
- *
300
- * A plugin's disposer owns real work — a spawned child, a listener, a timer —
301
- * and `onDispose` is the only place it is released. Without this the process
302
- * exits with those alive: a detached child outlives its parent by definition,
303
- * so a command a plugin started would keep running after Kabmo is gone
304
- * (verified: the plugin's own `Bun.spawn({ detached: true })` children survive a
305
- * `SIGTERM` to the server).
306
- *
307
- * The timeout is the other half of the contract. `disposePlugin` awaits each
308
- * disposer in turn, and one that never settles would hang the shutdown forever
309
- * — worse than the leak, because the operator cannot get their port back. The
310
- * pass therefore resolves on its own and reports what it had to abandon; the
311
- * process exits either way.
312
- *
313
- * Never throws: a failure here must not turn a clean shutdown into a crash.
314
- */
315
- export async function disposeAllPluginsOnShutdown(
316
- /** The bound, overridable so a test does not wait out the real one. */
317
- timeoutMs: number = SHUTDOWN_DISPOSE_TIMEOUT_MS,
318
- ): Promise<{ disposed: number; timedOut: boolean }> {
319
- const ids = [...loaded().keys()];
320
- if (ids.length === 0) return { disposed: 0, timedOut: false };
321
-
322
- const gate = Promise.withResolvers<boolean>();
323
- const timer = setTimeout(() => gate.resolve(false), timeoutMs);
324
- const pass = disposeAllPlugins().then(
325
- () => true,
326
- (error: unknown) => {
327
- console.error(`[plugins] shutdown: disposal failed — ${error instanceof Error ? error.message : String(error)}`);
328
- return true;
329
- },
330
- );
331
- // Either the pass settles or the timer fires; the loser is abandoned rather
332
- // than awaited, which is the whole point of the bound.
333
- const completed = await Promise.race([pass, gate.promise]);
334
- clearTimeout(timer);
335
- if (!completed) {
336
- console.error(
337
- `[plugins] shutdown: disposal did not finish within ${timeoutMs}ms — exiting anyway`,
338
- );
339
- }
340
- return { disposed: ids.length, timedOut: !completed };
341
- }
@@ -0,0 +1,100 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The MCP servers plugins contribute.
8
+ *
9
+ * A plugin declares a server; the host owns delivery. That split is the same
10
+ * one `background` follows: a plugin that spawned its own MCP child would leak
11
+ * one on every reload, and it would have to know which harness the user picked.
12
+ * Here the registry is the single list the spawn path reads, and disposal is
13
+ * the loader's job.
14
+ *
15
+ * Process-wide for the reason every other plugin registry is: under `bun --hot`
16
+ * this module re-evaluates while loaded plugins still hold the API they were
17
+ * handed, and a module-level map would come back empty.
18
+ */
19
+
20
+ import type { PluginMcpApi, PluginMcpServer } from '@kabmo-labs/kabmo-sdk';
21
+
22
+ /** One registration, with the plugin it belongs to and the name agents see. */
23
+ export interface RegisteredPluginMcpServer {
24
+ pluginId: string;
25
+ server: PluginMcpServer;
26
+ /** `<pluginId>:<id>` unless the plugin stated a name. */
27
+ name: string;
28
+ }
29
+
30
+ declare global {
31
+ // eslint-disable-next-line no-var
32
+ var __kabmoPluginMcpServers: Map<string, RegisteredPluginMcpServer[]> | undefined;
33
+ }
34
+
35
+ function registry(): Map<string, RegisteredPluginMcpServer[]> {
36
+ return (globalThis.__kabmoPluginMcpServers ??= new Map());
37
+ }
38
+
39
+ function isStringRecord(value: unknown): value is Record<string, string> {
40
+ return (
41
+ typeof value === 'object' &&
42
+ value !== null &&
43
+ !Array.isArray(value) &&
44
+ Object.values(value).every((entry) => typeof entry === 'string')
45
+ );
46
+ }
47
+
48
+ /** Refuse a malformed declaration by name, rather than registering a server that cannot start. */
49
+ function validate(pluginId: string, server: PluginMcpServer): RegisteredPluginMcpServer {
50
+ if (!server || typeof server !== 'object') throw new Error('mcp.register expects a server object');
51
+ if (typeof server.id !== 'string' || !server.id.trim()) throw new Error('mcp.register: "id" is required');
52
+ if (server.transport !== 'stdio' && server.transport !== 'http') {
53
+ throw new Error(`mcp.register "${server.id}": transport must be "stdio" or "http"`);
54
+ }
55
+ if (server.transport === 'stdio') {
56
+ if (typeof server.command !== 'string' || !server.command.trim()) {
57
+ throw new Error(`mcp.register "${server.id}": a stdio server needs a command`);
58
+ }
59
+ if (server.args !== undefined && (!Array.isArray(server.args) || server.args.some((arg) => typeof arg !== 'string'))) {
60
+ throw new Error(`mcp.register "${server.id}": args must be a string array`);
61
+ }
62
+ if (server.env !== undefined && !isStringRecord(server.env)) {
63
+ throw new Error(`mcp.register "${server.id}": env must be a string map`);
64
+ }
65
+ } else {
66
+ if (typeof server.url !== 'string' || !server.url.trim()) {
67
+ throw new Error(`mcp.register "${server.id}": an http server needs a url`);
68
+ }
69
+ if (server.headers !== undefined && !isStringRecord(server.headers)) {
70
+ throw new Error(`mcp.register "${server.id}": headers must be a string map`);
71
+ }
72
+ }
73
+ const name = typeof server.name === 'string' && server.name.trim() ? server.name.trim() : `${pluginId}:${server.id}`;
74
+ return { pluginId, server, name };
75
+ }
76
+
77
+ /** The API one plugin is handed at load. */
78
+ export function createPluginMcp(pluginId: string): PluginMcpApi {
79
+ return {
80
+ register(server) {
81
+ const checked = validate(pluginId, server);
82
+ const list = registry().get(pluginId) ?? [];
83
+ if (list.some((entry) => entry.server.id === checked.server.id)) {
84
+ throw new Error(`mcp.register: "${checked.server.id}" is already registered by this plugin`);
85
+ }
86
+ list.push(checked);
87
+ registry().set(pluginId, list);
88
+ },
89
+ };
90
+ }
91
+
92
+ /** Drop every server a plugin contributed (disable, removal, reload). */
93
+ export function clearPluginMcp(pluginId: string): void {
94
+ registry().delete(pluginId);
95
+ }
96
+
97
+ /** Every contributed server, in load order. */
98
+ export function pluginMcpServers(): RegisteredPluginMcpServer[] {
99
+ return [...registry().values()].flat();
100
+ }
@@ -0,0 +1,75 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * A plugin's MCP contribution.
8
+ *
9
+ * The contract: a declaration is validated at load (a server that cannot start
10
+ * is refused by name, not silently skipped), names are namespaced by plugin id,
11
+ * and disposal drops the list so a disabled plugin contributes nothing.
12
+ */
13
+
14
+ import { afterEach, describe, expect, test } from 'bun:test';
15
+ import { clearPluginMcp, createPluginMcp, pluginMcpServers } from '@/server/lib/plugins/mcp.server';
16
+
17
+ afterEach(() => {
18
+ clearPluginMcp('alpha');
19
+ clearPluginMcp('beta');
20
+ });
21
+
22
+ describe('plugin MCP registry', () => {
23
+ test('a stdio server is registered under the plugin namespace', () => {
24
+ createPluginMcp('alpha').register({ id: 'notes', transport: 'stdio', command: 'npx', args: ['-y', 'notes'] });
25
+ expect(pluginMcpServers()).toEqual([
26
+ {
27
+ pluginId: 'alpha',
28
+ name: 'alpha:notes',
29
+ server: { id: 'notes', transport: 'stdio', command: 'npx', args: ['-y', 'notes'] },
30
+ },
31
+ ]);
32
+ });
33
+
34
+ test('an explicit name is kept', () => {
35
+ createPluginMcp('alpha').register({ id: 'notes', name: 'Notes', transport: 'http', url: 'https://x' });
36
+ expect(pluginMcpServers()[0]?.name).toBe('Notes');
37
+ });
38
+
39
+ test('two plugins may use the same id', () => {
40
+ createPluginMcp('alpha').register({ id: 'notes', transport: 'stdio', command: 'a' });
41
+ createPluginMcp('beta').register({ id: 'notes', transport: 'stdio', command: 'b' });
42
+ expect(pluginMcpServers().map((entry) => entry.name)).toEqual(['alpha:notes', 'beta:notes']);
43
+ });
44
+
45
+ test('a duplicate id within one plugin is refused', () => {
46
+ const api = createPluginMcp('alpha');
47
+ api.register({ id: 'notes', transport: 'stdio', command: 'a' });
48
+ expect(() => api.register({ id: 'notes', transport: 'stdio', command: 'b' })).toThrow('already registered');
49
+ });
50
+
51
+ test('a stdio server without a command is refused by name', () => {
52
+ expect(() => createPluginMcp('alpha').register({ id: 'broken', transport: 'stdio' })).toThrow('needs a command');
53
+ });
54
+
55
+ test('an http server without a url is refused by name', () => {
56
+ expect(() => createPluginMcp('alpha').register({ id: 'broken', transport: 'http' })).toThrow('needs a url');
57
+ });
58
+
59
+ test('a non-string env map is refused', () => {
60
+ expect(() =>
61
+ createPluginMcp('alpha').register({
62
+ id: 'broken',
63
+ transport: 'stdio',
64
+ command: 'x',
65
+ env: { PORT: 1 } as unknown as Record<string, string>,
66
+ }),
67
+ ).toThrow('env must be a string map');
68
+ });
69
+
70
+ test('disposal drops every server the plugin contributed', () => {
71
+ createPluginMcp('alpha').register({ id: 'notes', transport: 'stdio', command: 'a' });
72
+ clearPluginMcp('alpha');
73
+ expect(pluginMcpServers()).toEqual([]);
74
+ });
75
+ });
@@ -0,0 +1,153 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The clock behind `api.background.schedule()`.
8
+ *
9
+ * `createPluginBackground` only RECORDS a schedule; this module is the one
10
+ * consumer of `LoadedPlugin.background.schedules`. Without it a declared
11
+ * schedule was inert — measured: the bundled `session-info` (`5m`) and `stats`
12
+ * (`1h`) schedules never fired, so a plugin author's only working background
13
+ * option was `service()`, which starts at declaration and therefore cannot be
14
+ * periodic without owning a timer the host cannot see.
15
+ *
16
+ * Serial on purpose, the same rule the scheduled-task runtime follows: a tick
17
+ * runs one due schedule at a time, so a burst cannot start ten jobs against the
18
+ * same CPU. A run that throws is reported under the plugin's own name and the
19
+ * schedule still advances — a permanently failing schedule must not spin.
20
+ *
21
+ * The state is anchored on `globalThis` because `bun --hot` re-evaluates this
22
+ * module while the interval it started is still live; a module-level handle
23
+ * would come back null and the next start would leave a second ticker running.
24
+ */
25
+
26
+ import { getDb } from '@/server/db.server';
27
+ import { advancePluginSchedule, type PluginSchedule } from '@/server/lib/plugins/background.server';
28
+ import { loadedPlugins } from '@/server/lib/plugins/loader.server';
29
+ import {
30
+ claimPluginSchedule,
31
+ insertPluginSchedule,
32
+ readPluginScheduleNext,
33
+ setPluginScheduleNext,
34
+ } from '@/server/lib/plugins/schedule-store.server';
35
+
36
+ /** How often the clock looks for due schedules. The grammar's floor is 1m. */
37
+ export const PLUGIN_SCHEDULE_TICK_MS = 15_000;
38
+ /** The first look, after the boot's plugin pass has registered its schedules. */
39
+ export const PLUGIN_SCHEDULE_FIRST_TICK_MS = 5_000;
40
+
41
+ interface RunnerState {
42
+ timer: NodeJS.Timeout | null;
43
+ ticking: boolean;
44
+ }
45
+
46
+ declare global {
47
+ // eslint-disable-next-line no-var
48
+ var __kabmoPluginScheduleRunner: RunnerState | undefined;
49
+ }
50
+
51
+ function state(): RunnerState {
52
+ return (globalThis.__kabmoPluginScheduleRunner ??= { timer: null, ticking: false });
53
+ }
54
+
55
+ function message(error: unknown): string {
56
+ return error instanceof Error ? error.message : String(error);
57
+ }
58
+
59
+ /**
60
+ * One pass: run every schedule whose fire time has arrived, then advance it.
61
+ *
62
+ * Exported for tests and for a manual tick; the interval below is the only
63
+ * production caller. Returns how many schedules ran.
64
+ */
65
+ export async function tickPluginSchedules(now = Date.now()): Promise<number> {
66
+ let ran = 0;
67
+ for (const record of loadedPlugins()) {
68
+ for (const schedule of record.background.schedules) {
69
+ if (schedule.nextRunAt > now) continue;
70
+ ran += 1;
71
+ await runOne(record.pluginId, schedule);
72
+ }
73
+ }
74
+ return ran;
75
+ }
76
+
77
+ async function runOne(pluginId: string, schedule: PluginSchedule): Promise<void> {
78
+ const dueAt = schedule.nextRunAt;
79
+ const db = await getDb();
80
+ let claim: 'claimed' | 'lost' | 'absent';
81
+ try {
82
+ claim = await claimPluginSchedule(db, pluginId, schedule.id, dueAt);
83
+ } catch (error) {
84
+ // Fail CLOSED and leave the in-memory time alone: a claim that could not be
85
+ // written must not be treated as won, and the next tick retries it.
86
+ console.error(`[plugins] ${pluginId}: schedule "${schedule.id}" could not be claimed — ${message(error)}`);
87
+ return;
88
+ }
89
+ if (claim === 'lost') {
90
+ // Another instance owns this fire. Adopt the time it wrote, or this tick
91
+ // would keep claiming a value the row no longer holds.
92
+ const stored = await readPluginScheduleNext(db, pluginId, schedule.id).catch(() => undefined);
93
+ schedule.nextRunAt = stored === undefined ? dueAt + 1 : (stored ?? Number.POSITIVE_INFINITY);
94
+ return;
95
+ }
96
+ // Computed AFTER the claim, from this process's clock: a server that was down
97
+ // for three intervals runs the job once, not three times.
98
+ const next = advancePluginSchedule(schedule, Date.now());
99
+ schedule.nextRunAt = next ?? Number.POSITIVE_INFINITY;
100
+ if (claim === 'absent') {
101
+ // A schedule declared before the table existed (or a test double): record
102
+ // the fire we are about to run so the next tick has a row to claim.
103
+ await insertPluginSchedule(db, pluginId, schedule.id, next).catch((error: unknown) => {
104
+ console.error(`[plugins] ${pluginId}: schedule "${schedule.id}" could not be recorded — ${message(error)}`);
105
+ });
106
+ } else {
107
+ await setPluginScheduleNext(db, pluginId, schedule.id, next).catch((error: unknown) => {
108
+ console.error(`[plugins] ${pluginId}: schedule "${schedule.id}" could not be advanced — ${message(error)}`);
109
+ });
110
+ }
111
+ try {
112
+ await schedule.run();
113
+ } catch (error) {
114
+ // A plugin's schedule is plugin code: its failure is reported, never
115
+ // rethrown into the ticker, or one broken schedule stops every other.
116
+ console.error(`[plugins] ${pluginId}: schedule "${schedule.id}" failed — ${message(error)}`);
117
+ }
118
+ if (next === null) {
119
+ // A cron expression that can never match again (a spent date) has no next
120
+ // fire. Parking it at Infinity is honest: the schedule stays listed, and
121
+ // the log says why it stopped.
122
+ console.error(`[plugins] ${pluginId}: schedule "${schedule.id}" has no next fire and is stopped`);
123
+ }
124
+ }
125
+
126
+ /** Start the tick. Idempotent: a second call is a no-op while one is running. */
127
+ export function startPluginScheduleRuntime(): void {
128
+ const current = state();
129
+ if (current.timer) return;
130
+ const tick = () => {
131
+ if (current.ticking) return;
132
+ current.ticking = true;
133
+ tickPluginSchedules()
134
+ .catch((error) => console.error('[plugins] schedule tick failed:', error))
135
+ .finally(() => {
136
+ current.ticking = false;
137
+ });
138
+ };
139
+ setTimeout(tick, PLUGIN_SCHEDULE_FIRST_TICK_MS).unref();
140
+ current.timer = setInterval(tick, PLUGIN_SCHEDULE_TICK_MS);
141
+ // A timer must never hold the process open: the listener is what keeps the
142
+ // server alive, and a shutdown must not wait for the next tick.
143
+ current.timer.unref();
144
+ }
145
+
146
+ /** Stop the tick (shutdown, tests). */
147
+ export function stopPluginScheduleRuntime(): void {
148
+ const current = state();
149
+ if (current.timer) {
150
+ clearInterval(current.timer);
151
+ current.timer = null;
152
+ }
153
+ }
@@ -0,0 +1,186 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The plugin schedule clock.
8
+ *
9
+ * The bug this pins: `api.background.schedule()` recorded a schedule and
10
+ * nothing ever read it, so the bundled `session-info` (`5m`) and `stats` (`1h`)
11
+ * schedules were inert. These tests drive the runner over a fake loaded-plugin
12
+ * map, which is the same seam the boot uses.
13
+ */
14
+
15
+ import { afterAll, afterEach, beforeAll, describe, expect, test } from 'bun:test';
16
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
17
+ import { getDb } from '@/server/db.server';
18
+ import type { LoadedPlugin } from '@/server/lib/plugins/loader.server';
19
+ import type { PluginSchedule } from '@/server/lib/plugins/background.server';
20
+ import {
21
+ startPluginScheduleRuntime,
22
+ stopPluginScheduleRuntime,
23
+ tickPluginSchedules,
24
+ } from '@/server/lib/plugins/schedule-runner.server';
25
+
26
+ function schedule(overrides: Partial<PluginSchedule> = {}): PluginSchedule {
27
+ return {
28
+ pluginId: 'alpha',
29
+ id: 'refresh',
30
+ kind: 'every',
31
+ spec: '5m',
32
+ run: () => {},
33
+ nextRunAt: 1_000,
34
+ ...overrides,
35
+ };
36
+ }
37
+
38
+ function host(pluginId: string, schedules: PluginSchedule[]): LoadedPlugin {
39
+ return {
40
+ pluginId,
41
+ api: {} as LoadedPlugin['api'],
42
+ background: { services: [], schedules },
43
+ disposers: [],
44
+ };
45
+ }
46
+
47
+ function install(plugins: LoadedPlugin[]): void {
48
+ globalThis.__kabmoLoadedPlugins = new Map(plugins.map((plugin) => [plugin.pluginId, plugin]));
49
+ }
50
+
51
+ beforeAll(async () => {
52
+ await isolateDb();
53
+ });
54
+
55
+ afterAll(async () => {
56
+ await releaseDb();
57
+ });
58
+
59
+ afterEach(async () => {
60
+ stopPluginScheduleRuntime();
61
+ globalThis.__kabmoLoadedPlugins = undefined;
62
+ await (await getDb()).run('DELETE FROM plugin_schedules');
63
+ });
64
+
65
+ describe('tickPluginSchedules', () => {
66
+ test('runs a due schedule and advances it past the fire', async () => {
67
+ const runs: number[] = [];
68
+ const entry = schedule({ run: () => void runs.push(1) });
69
+ install([host('alpha', [entry])]);
70
+
71
+ expect(await tickPluginSchedules(1_000)).toBe(1);
72
+ expect(runs).toHaveLength(1);
73
+ expect(entry.nextRunAt).toBeGreaterThan(1_000);
74
+ });
75
+
76
+ test('leaves a schedule that is not due alone', async () => {
77
+ const runs: number[] = [];
78
+ const entry = schedule({ nextRunAt: 10_000, run: () => void runs.push(1) });
79
+ install([host('alpha', [entry])]);
80
+
81
+ expect(await tickPluginSchedules(1_000)).toBe(0);
82
+ expect(runs).toHaveLength(0);
83
+ expect(entry.nextRunAt).toBe(10_000);
84
+ });
85
+
86
+ test('a throwing run is reported and the schedule still advances', async () => {
87
+ const errors: string[] = [];
88
+ const original = console.error;
89
+ console.error = (...args: unknown[]) => void errors.push(args.map(String).join(' '));
90
+ const entry = schedule({
91
+ run: () => {
92
+ throw new Error('boom');
93
+ },
94
+ });
95
+ install([host('alpha', [entry])]);
96
+ try {
97
+ expect(await tickPluginSchedules(1_000)).toBe(1);
98
+ } finally {
99
+ console.error = original;
100
+ }
101
+ expect(errors).toHaveLength(1);
102
+ expect(errors[0]).toContain('alpha');
103
+ expect(errors[0]).toContain('refresh');
104
+ expect(errors[0]).toContain('boom');
105
+ expect(entry.nextRunAt).toBeGreaterThan(1_000);
106
+ });
107
+
108
+ test('a schedule with no next fire is parked instead of spinning', async () => {
109
+ const errors: string[] = [];
110
+ const original = console.error;
111
+ console.error = (...args: unknown[]) => void errors.push(args.map(String).join(' '));
112
+ // 31 February never matches, so `nextRunAfter` answers null.
113
+ const entry = schedule({ kind: 'cron', spec: '0 0 31 2 *' });
114
+ install([host('alpha', [entry])]);
115
+ try {
116
+ await tickPluginSchedules(1_000);
117
+ } finally {
118
+ console.error = original;
119
+ }
120
+ expect(entry.nextRunAt).toBe(Number.POSITIVE_INFINITY);
121
+ expect(errors[0]).toContain('no next fire');
122
+ });
123
+
124
+ test('a fire another instance already claimed is not run twice', async () => {
125
+ const runs: number[] = [];
126
+ const entry = schedule({ run: () => void runs.push(1) });
127
+ install([host('alpha', [entry])]);
128
+ // The row says a different instance already moved this fire.
129
+ await (await getDb()).run(
130
+ 'INSERT INTO plugin_schedules (plugin_id, id, next_run_at) VALUES (?, ?, ?)',
131
+ ['alpha', 'refresh', 9_999],
132
+ );
133
+ expect(await tickPluginSchedules(1_000)).toBe(1);
134
+ expect(runs).toHaveLength(0);
135
+ expect(entry.nextRunAt).toBeGreaterThan(1_000);
136
+ });
137
+
138
+ test('a claimed fire advances the stored row', async () => {
139
+ const runs: number[] = [];
140
+ const entry = schedule({ run: () => void runs.push(1) });
141
+ install([host('alpha', [entry])]);
142
+ await (await getDb()).run(
143
+ 'INSERT INTO plugin_schedules (plugin_id, id, next_run_at) VALUES (?, ?, ?)',
144
+ ['alpha', 'refresh', 1_000],
145
+ );
146
+ await tickPluginSchedules(1_000);
147
+ expect(runs).toHaveLength(1);
148
+ const row = await (await getDb()).get<{ next_run_at: number }>(
149
+ 'SELECT next_run_at FROM plugin_schedules WHERE plugin_id = ? AND id = ?',
150
+ ['alpha', 'refresh'],
151
+ );
152
+ expect(row?.next_run_at).toBe(entry.nextRunAt);
153
+ });
154
+
155
+ test('a claim left behind by a crash is due on the next tick', async () => {
156
+ const runs: number[] = [];
157
+ const entry = schedule({ nextRunAt: -1, run: () => void runs.push(1) });
158
+ install([host('alpha', [entry])]);
159
+ await (await getDb()).run(
160
+ 'INSERT INTO plugin_schedules (plugin_id, id, next_run_at) VALUES (?, ?, ?)',
161
+ ['alpha', 'refresh', -1],
162
+ );
163
+ await tickPluginSchedules(1_000);
164
+ expect(runs).toHaveLength(1);
165
+ expect(entry.nextRunAt).toBeGreaterThan(1_000);
166
+ });
167
+
168
+ test('every loaded plugin is visited, not just the first', async () => {
169
+ const runs: string[] = [];
170
+ install([
171
+ host('alpha', [schedule({ run: () => void runs.push('alpha') })]),
172
+ host('beta', [schedule({ pluginId: 'beta', run: () => void runs.push('beta') })]),
173
+ ]);
174
+ expect(await tickPluginSchedules(1_000)).toBe(2);
175
+ expect(runs).toEqual(['alpha', 'beta']);
176
+ });
177
+ });
178
+
179
+ describe('startPluginScheduleRuntime', () => {
180
+ test('is idempotent and stops cleanly', () => {
181
+ startPluginScheduleRuntime();
182
+ startPluginScheduleRuntime();
183
+ stopPluginScheduleRuntime();
184
+ stopPluginScheduleRuntime();
185
+ });
186
+ });