@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.
- package/dist/client/index.html +1 -1
- package/dist/client/index.js +502 -474
- package/dist/client/static/js/index-81f7berm.css +1 -0
- package/dist/client/static/js/{index-95b3n20k.js → index-xzvyrxya.js} +799 -799
- package/marketplace/plugins/command-runner/package.json +3 -17
- package/marketplace/plugins/command-runner/settings-schema.json +14 -0
- package/marketplace/plugins/git-forge/README.md +17 -7
- package/marketplace/plugins/git-forge/package.json +4 -30
- package/marketplace/plugins/git-forge/panel.css +16 -0
- package/marketplace/plugins/git-forge/settings-schema.json +27 -0
- package/marketplace/plugins/git-forge/src/panel/Badge.tsx +35 -22
- package/marketplace/plugins/git-forge/src/panel/Change.tsx +20 -24
- package/marketplace/plugins/git-forge/src/panel/CiBadge.tsx +16 -7
- package/marketplace/plugins/git-forge/src/panel/Credential.tsx +31 -26
- package/marketplace/plugins/git-forge/src/panel/Glyph.tsx +18 -2
- package/marketplace/plugins/git-forge/src/panel/Header.tsx +160 -96
- package/marketplace/plugins/git-forge/src/panel/ItemView.tsx +60 -44
- package/marketplace/plugins/git-forge/src/panel/List.tsx +150 -22
- package/marketplace/plugins/git-forge/src/panel/Row.tsx +11 -5
- package/marketplace/plugins/git-forge/src/panel/Sidebar.tsx +17 -15
- package/marketplace/plugins/git-forge/src/panel/Write.tsx +84 -61
- package/marketplace/plugins/git-forge/src/panel/format.test.ts +99 -0
- package/marketplace/plugins/git-forge/src/panel/format.ts +59 -16
- package/marketplace/plugins/git-forge/src/panel/index.test.tsx +109 -5
- package/marketplace/plugins/git-forge/src/panel/index.tsx +37 -4
- package/marketplace/plugins/git-forge/src/panel/use-forge.ts +17 -0
- package/marketplace/plugins/git-forge/src/panel/write.test.tsx +31 -0
- package/marketplace/plugins/session-info/package.json +2 -10
- package/marketplace/plugins/session-info/settings-schema.json +8 -0
- package/marketplace/plugins/stats/README.md +17 -5
- package/marketplace/plugins/stats/package.json +3 -23
- package/marketplace/plugins/stats/settings-schema.json +20 -0
- package/marketplace/plugins/stats/src/app.tsx +1 -1
- package/marketplace/plugins/stats/src/groups.test.ts +46 -1
- package/marketplace/plugins/stats/src/groups.ts +22 -11
- package/marketplace/plugins/stats/src/harness-leases.test.ts +84 -0
- package/marketplace/plugins/stats/src/harness-leases.ts +132 -0
- package/marketplace/plugins/stats/src/labels.test.ts +54 -1
- package/marketplace/plugins/stats/src/labels.ts +33 -7
- package/marketplace/plugins/stats/src/sampler.test.ts +61 -0
- package/marketplace/plugins/stats/src/sampler.ts +39 -5
- package/marketplace/plugins/stats/src/snapshot.ts +6 -0
- package/package.json +2 -2
- package/src/client/components/common/Toast.test.tsx +28 -2
- package/src/client/components/common/Toast.tsx +21 -9
- package/src/client/components/common/harness-glyph/index.tsx +18 -1
- package/src/client/components/common/session-actions-menu/index.test.tsx +106 -0
- package/src/client/components/common/session-actions-menu/index.tsx +43 -1
- package/src/client/components/common/session-row/TrailingSlot.tsx +9 -4
- package/src/client/components/common/session-row/index.tsx +4 -0
- package/src/client/components/common/session-row/session-row.test.tsx +6 -0
- package/src/client/components/layout/desktop-layout/LeftColumn.tsx +2 -1
- package/src/client/components/layout/session-sidebar/CategoryItem.tsx +4 -2
- package/src/client/components/layout/session-sidebar/SessionItem.tsx +9 -1
- package/src/client/components/layout/session-sidebar/SessionList.tsx +2 -1
- package/src/client/components/layout/session-sidebar/about-modal/UpdateSection.tsx +3 -2
- package/src/client/components/layout/session-sidebar/about-modal/index.tsx +2 -1
- package/src/client/components/layout/session-sidebar/modern/RevealRow.tsx +56 -0
- package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +12 -29
- package/src/client/components/layout/session-sidebar/modern/reveal-row.test.tsx +104 -0
- package/src/client/components/layout/session-sidebar/scheduler-modal/ModelFields.tsx +202 -0
- package/src/client/components/layout/session-sidebar/scheduler-modal/TaskForm.tsx +80 -19
- package/src/client/components/layout/session-sidebar/scheduler-modal/TaskList.tsx +23 -3
- package/src/client/components/layout/session-sidebar/scheduler-modal/index.tsx +5 -1
- package/src/client/components/layout/session-sidebar/variant-props.ts +2 -1
- package/src/client/components/mobile/SessionSidebar.tsx +2 -1
- package/src/client/components/mobile/mobile-right-sidebar/EditorSurface.tsx +156 -0
- package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +41 -86
- package/src/client/components/mobile/mobile-session-sidebar/ClassicDrawer.tsx +2 -1
- package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +4 -2
- package/src/client/components/mobile/mobile-session-sidebar/List.tsx +2 -1
- package/src/client/components/mobile/mobile-session-sidebar/SessionRow.test.ts +6 -0
- package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +9 -1
- package/src/client/components/settings/Modal.tsx +7 -3
- package/src/client/components/settings/Sidebar.tsx +30 -3
- package/src/client/components/settings/categories/HarnessSettings.tsx +11 -7
- package/src/client/components/settings/categories/NotificationSettings.test.tsx +40 -15
- package/src/client/components/settings/categories/NotificationSettings.tsx +142 -64
- package/src/client/components/settings/categories/PanelPluginSettings.tsx +1 -1
- package/src/client/components/settings/categories/harness-settings/CustomHarnessForm.tsx +186 -0
- package/src/client/components/settings/categories/panel-plugins/InstalledList.tsx +11 -0
- package/src/client/components/settings/categories/panel-plugins/PluginCard.test.tsx +1 -0
- package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +15 -1
- package/src/client/components/settings/categories/panel-plugins/SettingsModal.test.tsx +165 -0
- package/src/client/components/settings/categories/panel-plugins/SettingsModal.tsx +260 -0
- package/src/client/components/settings/categories/project-settings/WorktreeSettings.tsx +2 -1
- package/src/client/components/settings/categories/usage-settings/LimitsSection.tsx +39 -19
- package/src/client/components/settings/categories/usage-settings/ProviderDetail.tsx +1 -0
- package/src/client/components/settings/categories/usage-settings/limit-groups.test.ts +94 -0
- package/src/client/components/settings/categories/usage-settings/limit-groups.ts +118 -0
- package/src/client/components/settings/categories/usage-settings/limits-section.test.tsx +118 -0
- package/src/client/components/workspace/chat-timeline/AiMessageFooter.fork.test.ts +24 -0
- package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +8 -4
- package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +34 -0
- package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +61 -56
- package/src/client/components/workspace/chat-timeline/MessageItem.fork.test.ts +80 -0
- package/src/client/components/workspace/chat-timeline/MessageItem.tsx +9 -3
- package/src/client/components/workspace/chat-timeline/MessageList.tsx +3 -1
- package/src/client/components/workspace/chat-timeline/PendingChatView.tsx +11 -1
- package/src/client/components/workspace/chat-timeline/PendingTranscript.tsx +130 -0
- package/src/client/components/workspace/chat-timeline/RunFooter.tsx +2 -1
- package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +2 -1
- package/src/client/components/workspace/chat-timeline/chat-input/ComposerRows.tsx +8 -0
- package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.test.tsx +9 -0
- package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.tsx +4 -1
- package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +24 -0
- package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.tsx +13 -20
- package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +2 -0
- package/src/client/components/workspace/chat-timeline/chat-input/props.ts +5 -5
- package/src/client/components/workspace/chat-timeline/fork-preview.test.tsx +141 -0
- package/src/client/components/workspace/chat-timeline/index.tsx +17 -6
- package/src/client/components/workspace/chat-timeline/target-picker/DraftTargetRow.tsx +3 -10
- package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.test.tsx +101 -0
- package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.tsx +2 -2
- package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.tsx +5 -4
- package/src/client/components/workspace/editor/FilePane.tsx +9 -4
- package/src/client/components/workspace/editor/Notices.tsx +2 -2
- package/src/client/components/workspace/editor/Pane.tsx +2 -2
- package/src/client/components/workspace/editor/Toolbar.tsx +16 -10
- package/src/client/components/workspace/editor/index.tsx +6 -10
- package/src/client/components/workspace/editor/toolbar-clusters.test.ts +4 -3
- package/src/client/components/workspace/editor/toolbar-clusters.tsx +23 -14
- package/src/client/components/workspace/git-panel/index.tsx +2 -2
- package/src/client/components/workspace/terminal-panel/RealtimeTerminalView.tsx +17 -6
- package/src/client/components/workspace/terminal-panel/focus.test.ts +70 -0
- package/src/client/components/workspace/terminal-panel/focus.ts +46 -0
- package/src/client/components/workspace/terminal-panel/index.tsx +17 -1
- package/src/client/components/workspace/terminal-panel/mount.ts +17 -9
- package/src/client/components/workspace/terminal-panel/scroll-hold.test.ts +158 -0
- package/src/client/components/workspace/terminal-panel/scroll-hold.ts +136 -0
- package/src/client/hooks/chat/composer/use-draft.ts +45 -1
- package/src/client/hooks/chat/omp/pending-sessions.waiting.test.ts +11 -10
- package/src/client/hooks/chat/omp/pending-waiting.ts +15 -7
- package/src/client/hooks/chat/omp/prompt-send.test.ts +11 -0
- package/src/client/hooks/chat/omp/prompt-send.ts +3 -0
- package/src/client/hooks/chat/omp/session-list.tsx +5 -0
- package/src/client/hooks/chat/omp/sidebar-reload.test.ts +85 -0
- package/src/client/hooks/chat/omp/sidebar-reload.ts +30 -0
- package/src/client/hooks/chat/timeline/actions.ts +4 -4
- package/src/client/hooks/chat/timeline/composer-modes.ts +13 -2
- package/src/client/hooks/chat/timeline/fork-open.ts +52 -0
- package/src/client/hooks/chat/timeline/fork-preview.test.ts +148 -0
- package/src/client/hooks/chat/timeline/fork-preview.ts +104 -0
- package/src/client/hooks/chat/timeline/fork-send.test.ts +139 -0
- package/src/client/hooks/chat/timeline/index.ts +5 -2
- package/src/client/hooks/chat/timeline/mode-availability.ts +7 -0
- package/src/client/hooks/chat/timeline/modes-contract.ts +6 -0
- package/src/client/hooks/chat/timeline/modes-hydrate.ts +93 -0
- package/src/client/hooks/chat/timeline/modes.ts +32 -52
- package/src/client/hooks/chat/timeline/new-chat-open.ts +7 -6
- package/src/client/hooks/chat/timeline/new-chat.ts +10 -1
- package/src/client/hooks/chat/timeline/pending-branch.ts +9 -0
- package/src/client/hooks/chat/timeline/pending-dispatch.ts +53 -0
- package/src/client/hooks/chat/timeline/pending-session-mode.test.ts +136 -0
- package/src/client/hooks/chat/timeline/pending-session-mode.ts +69 -0
- package/src/client/hooks/chat/timeline/pending-warmup.test.ts +147 -0
- package/src/client/hooks/chat/timeline/pending-warmup.ts +62 -0
- package/src/client/hooks/chat/timeline/run-identity.test.ts +12 -0
- package/src/client/hooks/chat/timeline/run-identity.ts +4 -1
- package/src/client/hooks/chat/timeline/send-props.ts +2 -0
- package/src/client/hooks/chat/timeline/send-steer.test.ts +1 -0
- package/src/client/hooks/chat/timeline/send.test-util.ts +1 -0
- package/src/client/hooks/chat/timeline/send.test.ts +1 -0
- package/src/client/hooks/chat/timeline/session-harness.ts +4 -0
- package/src/client/hooks/chat/timeline/stop-with-queue.ts +1 -1
- package/src/client/hooks/chat/timeline/use-fork-session.ts +9 -22
- package/src/client/hooks/chat/waiting/cancel.ts +15 -7
- package/src/client/hooks/chat/waiting/choice.ts +13 -16
- package/src/client/hooks/chat/waiting/composer-wait.ts +70 -0
- package/src/client/hooks/chat/waiting/dispatch.ts +50 -29
- package/src/client/hooks/chat/waiting/held.ts +38 -13
- package/src/client/hooks/chat/waiting/hold.test.ts +22 -0
- package/src/client/hooks/chat/waiting/hold.ts +20 -11
- package/src/client/hooks/chat/waiting/restore.test.ts +69 -0
- package/src/client/hooks/chat/waiting/restore.ts +34 -0
- package/src/client/hooks/chat/waiting/store.ts +9 -3
- package/src/client/hooks/editor/file-editor-types.ts +21 -12
- package/src/client/hooks/editor/save-file.test.ts +1 -1
- package/src/client/hooks/editor/save-file.ts +35 -8
- package/src/client/hooks/editor/target-key.ts +17 -0
- package/src/client/hooks/editor/use-disk-digest.test.ts +82 -0
- package/src/client/hooks/editor/use-disk-digest.ts +164 -0
- package/src/client/hooks/editor/use-disk-sync.ts +212 -0
- package/src/client/hooks/editor/use-file-cache.ts +113 -0
- package/src/client/hooks/editor/use-file-editor.test.ts +90 -0
- package/src/client/hooks/editor/use-file-editor.ts +90 -52
- package/src/client/hooks/editor/use-file-read.ts +24 -10
- package/src/client/hooks/editor/use-file-writes.ts +4 -4
- package/src/client/hooks/models/harness-catalog.ts +15 -0
- package/src/client/hooks/settings/providers/actions.ts +3 -2
- package/src/client/hooks/settings/providers/messages.ts +9 -7
- package/src/client/hooks/settings/providers/model-actions.ts +2 -1
- package/src/client/hooks/ui/editor-error-toast.ts +2 -1
- package/src/client/hooks/ui/notifications.ts +17 -8
- package/src/client/hooks/workspace/batch-archive.test.ts +2 -2
- package/src/client/hooks/workspace/batch-archive.ts +4 -2
- package/src/client/hooks/workspace/git-action-outcome.ts +4 -3
- package/src/client/hooks/workspace/navbar-session-actions.ts +2 -1
- package/src/client/hooks/workspace/panel-registry.ts +1 -1
- package/src/client/hooks/workspace/scheduled-tasks.ts +26 -11
- package/src/client/hooks/workspace/session-actions.test.ts +2 -1
- package/src/client/hooks/workspace/session-actions.ts +2 -1
- package/src/client/hooks/workspace/terminal/connection.test.ts +63 -0
- package/src/client/hooks/workspace/terminal/connection.ts +47 -0
- package/src/client/hooks/workspace/terminal/index.ts +35 -4
- package/src/client/hooks/workspace/workspace-folder-actions.ts +2 -1
- package/src/client/lib/notifications/os.test.ts +1 -30
- package/src/client/lib/notifications/os.ts +0 -15
- package/src/client/lib/notifications/platform.test.ts +68 -0
- package/src/client/lib/notifications/platform.ts +36 -0
- package/src/server/index.ts +7 -0
- package/src/server/lib/harness/acp/client.ts +81 -87
- package/src/server/lib/harness/acp/prewarm.server.ts +237 -0
- package/src/server/lib/harness/acp/prewarm.test.ts +171 -0
- package/src/server/lib/harness/acp/prompt.test.ts +70 -1
- package/src/server/lib/harness/acp/prompt.ts +32 -1
- package/src/server/lib/harness/acp/protocol.ts +23 -0
- package/src/server/lib/harness/acp/session-handshake.test.ts +26 -0
- package/src/server/lib/harness/acp/session-handshake.ts +22 -20
- package/src/server/lib/harness/acp/session-options.ts +16 -0
- package/src/server/lib/harness/acp/session-process.ts +43 -0
- package/src/server/lib/harness/acp/session.ts +11 -12
- package/src/server/lib/harness/acp/stdio.ts +129 -0
- package/src/server/lib/harness/acp/verbs.test.ts +97 -0
- package/src/server/lib/harness/acp/verbs.ts +16 -6
- package/src/server/lib/harness/auto-probe.server.ts +4 -3
- package/src/server/lib/harness/capabilities.ts +8 -0
- package/src/server/lib/harness/config.server.ts +3 -2
- package/src/server/lib/harness/custom.server.ts +209 -0
- package/src/server/lib/harness/launch.ts +6 -1
- package/src/server/lib/harness/register.server.ts +8 -1
- package/src/server/lib/harness/schema.server.ts +21 -0
- package/src/server/lib/harness/session-lease.server.test.ts +99 -0
- package/src/server/lib/harness/session-lease.server.ts +193 -0
- package/src/server/lib/harness/session-store.server.test.ts +8 -8
- package/src/server/lib/harness/session-store.server.ts +25 -4
- package/src/server/lib/harness/session-title.server.ts +12 -2
- package/src/server/lib/harness/spawn.server.ts +123 -20
- package/src/server/lib/harness/update-queue.server.ts +3 -3
- package/src/server/lib/lifecycle/after-listen.ts +12 -1
- package/src/server/lib/lifecycle/paths.ts +19 -1
- package/src/server/lib/mcp/registry.server.ts +155 -0
- package/src/server/lib/mcp/registry.test.ts +169 -0
- package/src/server/lib/mcp/store.server.ts +38 -0
- package/src/server/lib/omp/rpc/frame-fold-contract.ts +59 -0
- package/src/server/lib/omp/rpc/frame-fold-frames.test.ts +64 -1
- package/src/server/lib/omp/rpc/frame-fold-host.test-util.ts +2 -1
- package/src/server/lib/omp/rpc/frame-fold.test.ts +2 -1
- package/src/server/lib/omp/rpc/frame-fold.ts +6 -45
- package/src/server/lib/omp/rpc/prewarm-pool.ts +19 -5
- package/src/server/lib/omp/rpc/run-model.test.ts +116 -0
- package/src/server/lib/omp/rpc/run-model.ts +4 -2
- package/src/server/lib/omp/session/sidebar-data.harness.test.ts +6 -3
- package/src/server/lib/omp/session/standby.server.ts +13 -2
- package/src/server/lib/panels/manifest.test.ts +47 -1
- package/src/server/lib/panels/manifest.ts +19 -0
- package/src/server/lib/panels/registry.server.ts +19 -2
- package/src/server/lib/panels/scan.server.ts +26 -2
- package/src/server/lib/panels/settings-schema.server.ts +72 -0
- package/src/server/lib/plugins/background.server.ts +21 -3
- package/src/server/lib/plugins/background.test.ts +13 -0
- package/src/server/lib/plugins/loader.server.ts +35 -51
- package/src/server/lib/plugins/mcp.server.ts +100 -0
- package/src/server/lib/plugins/mcp.test.ts +75 -0
- package/src/server/lib/plugins/schedule-runner.server.ts +153 -0
- package/src/server/lib/plugins/schedule-runner.test.ts +186 -0
- package/src/server/lib/plugins/schedule-store.server.ts +107 -0
- package/src/server/lib/plugins/schema.server.ts +8 -0
- package/src/server/lib/plugins/settings.server.ts +56 -19
- package/src/server/lib/plugins/shutdown.server.ts +58 -0
- package/src/server/lib/plugins/shutdown.test.ts +28 -3
- package/src/server/lib/realtime/topics/global.server.ts +5 -1
- package/src/server/lib/schedule/rows.server.ts +9 -0
- package/src/server/lib/schedule/runtime.server.test.ts +91 -0
- package/src/server/lib/schedule/runtime.server.ts +101 -23
- package/src/server/lib/schedule/schema.server.ts +15 -0
- package/src/server/lib/schedule/store.server.test.ts +34 -0
- package/src/server/lib/schedule/store.server.ts +33 -9
- package/src/server/lib/sessions/fork.server.test.ts +47 -0
- package/src/server/lib/sessions/fork.server.ts +17 -1
- package/src/server/lib/sessions/spawn.server.ts +2 -2
- package/src/server/lib/usage/report.server.ts +57 -0
- package/src/server/lib/waiting/runtime.server.test.ts +48 -0
- package/src/server/lib/waiting/runtime.server.ts +22 -0
- package/src/server/lib/waiting/schema.server.ts +8 -0
- package/src/server/lib/waiting/store.server.test.ts +14 -0
- package/src/server/lib/waiting/store.server.ts +6 -2
- package/src/server/routes/agent/command-resume.test.ts +9 -4
- package/src/server/routes/agent/new-mode.test.ts +40 -0
- package/src/server/routes/agent/new.ts +31 -10
- package/src/server/routes/agent/prewarm.ts +48 -7
- package/src/server/routes/fs/action.ts +9 -1
- package/src/server/routes/fs/digest.test.ts +100 -0
- package/src/server/routes/fs/digest.ts +106 -0
- package/src/server/routes/fs/index.ts +2 -0
- package/src/server/routes/fs/read.ts +6 -1
- package/src/server/routes/harness/custom.test.ts +131 -0
- package/src/server/routes/harness/import-action.ts +2 -2
- package/src/server/routes/harness/root.ts +41 -8
- package/src/server/routes/harness/update.ts +2 -2
- package/src/server/routes/panels/bindings.ts +2 -0
- package/src/server/routes/panels/settings.test.ts +165 -0
- package/src/server/routes/panels/settings.ts +106 -0
- package/src/server/routes/schedule/body.ts +14 -0
- package/src/server/routes/schedule/index.ts +28 -4
- package/src/server/routes/settings/mcp.ts +9 -26
- package/src/server/routes/waiting/index.ts +21 -2
- package/src/server/routes/waiting/routes.test.ts +21 -0
- package/src/shared/lib/chat/composer/delegation.ts +3 -3
- package/src/shared/lib/chat/timeline/fork-anchor.test.ts +97 -0
- package/src/shared/lib/chat/timeline/fork-anchor.ts +47 -0
- package/src/shared/lib/chat/timeline/fork-preview.test.ts +62 -0
- package/src/shared/lib/chat/timeline/fork-preview.ts +36 -0
- package/src/shared/lib/fs/content-hash.ts +29 -0
- package/src/shared/lib/harness/catalog.ts +48 -6
- package/src/shared/lib/harness/fork.ts +60 -0
- package/src/shared/lib/harness/mcp-facts.test.ts +30 -0
- package/src/shared/lib/harness/mcp-facts.ts +65 -0
- package/src/shared/lib/harness/menu.test.ts +16 -1
- package/src/shared/lib/harness/menu.ts +2 -2
- package/src/shared/lib/harness/rewind.ts +6 -6
- package/src/shared/lib/harness/session-modes.ts +31 -0
- package/src/shared/lib/harness/transcript.test.ts +29 -0
- package/src/shared/lib/harness/transcript.ts +19 -0
- package/src/shared/lib/notifications/settings.test.ts +21 -0
- package/src/shared/lib/notifications/settings.ts +24 -0
- package/src/shared/lib/omp/session/prewarm.test.ts +28 -4
- package/src/shared/lib/omp/session/prewarm.ts +25 -6
- package/src/shared/lib/omp/session/stream-state.server.test.ts +25 -0
- package/src/shared/lib/omp/session/stream-state.server.ts +8 -4
- package/src/shared/lib/panels/capabilities.test.ts +1 -1
- package/src/shared/lib/panels/capabilities.ts +3 -0
- package/src/shared/lib/plugins/settings.ts +22 -0
- package/src/shared/lib/schedule/parse.test.ts +48 -0
- package/src/shared/lib/schedule/parse.ts +69 -45
- package/src/shared/lib/schedule/timezone.ts +128 -0
- package/src/shared/lib/settings/defaults.ts +2 -0
- package/src/shared/lib/ui/toast-duration.test.ts +25 -1
- package/src/shared/lib/ui/toast-duration.ts +22 -4
- package/src/shared/lib/workspace/refresh-cadence.test.ts +25 -1
- package/src/shared/lib/workspace/relative-time.ts +16 -0
- package/src/shared/lib/workspace/session-state/store.ts +4 -0
- package/src/shared/types/harness.ts +7 -0
- package/src/shared/types/omp/agent.ts +6 -0
- package/src/shared/types/panels-registry.ts +3 -3
- package/src/shared/types/panels.ts +4 -2
- package/src/shared/types/schedule.ts +13 -0
- package/src/shared/types/settings/state.ts +12 -1
- package/src/shared/types/waiting.ts +9 -0
- package/src/test-support/file-editor.test-util.ts +70 -5
- package/dist/client/static/js/index-p2yw9ywf.css +0 -1
- package/src/client/hooks/editor/use-external-change-notice.ts +0 -71
- package/src/client/hooks/editor/use-external-change.test.ts +0 -88
- 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
|
-
|
|
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,
|
|
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
|
+
});
|