@kabmo-labs/kabmo 0.11.1 → 0.12.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/README.md +67 -421
- package/dist/client/index.html +1 -1
- package/dist/client/index.js +426 -413
- package/dist/client/static/js/{index-amss8pge.js → index-0smc9gm2.js} +1123 -747
- package/dist/client/static/js/index-shexbk5f.css +1 -0
- package/marketplace/marketplace.json +13 -3
- package/marketplace/plugins/command-runner/package.json +4 -2
- package/marketplace/plugins/git-forge/README.md +219 -0
- package/marketplace/plugins/git-forge/icon.svg +20 -0
- package/marketplace/plugins/git-forge/package.json +56 -0
- package/marketplace/plugins/git-forge/src/app.tsx +82 -0
- package/marketplace/plugins/git-forge/src/command.test.ts +181 -0
- package/marketplace/plugins/git-forge/src/command.ts +119 -0
- package/marketplace/plugins/git-forge/src/header.tsx +87 -0
- package/marketplace/plugins/git-forge/src/panel/Badge.tsx +76 -0
- package/marketplace/plugins/git-forge/src/panel/Change.tsx +150 -0
- package/marketplace/plugins/git-forge/src/panel/CiBadge.tsx +51 -0
- package/marketplace/plugins/git-forge/src/panel/Credential.tsx +107 -0
- package/marketplace/plugins/git-forge/src/panel/Glyph.tsx +70 -0
- package/marketplace/plugins/git-forge/src/panel/Header.tsx +255 -0
- package/marketplace/plugins/git-forge/src/panel/ItemView.tsx +198 -0
- package/marketplace/plugins/git-forge/src/panel/List.tsx +89 -0
- package/marketplace/plugins/git-forge/src/panel/Row.tsx +68 -0
- package/marketplace/plugins/git-forge/src/panel/Sidebar.tsx +94 -0
- package/marketplace/plugins/git-forge/src/panel/Write.tsx +236 -0
- package/marketplace/plugins/git-forge/src/panel/format.ts +78 -0
- package/marketplace/plugins/git-forge/src/panel/index.test.tsx +344 -0
- package/marketplace/plugins/git-forge/src/panel/index.tsx +193 -0
- package/marketplace/plugins/git-forge/src/panel/use-forge.ts +250 -0
- package/marketplace/plugins/git-forge/src/panel/write.test.tsx +269 -0
- package/marketplace/plugins/git-forge/src/protocol.ts +308 -0
- package/marketplace/plugins/git-forge/src/server/adapters.test.ts +274 -0
- package/marketplace/plugins/git-forge/src/server/bitbucket.ts +307 -0
- package/marketplace/plugins/git-forge/src/server/capabilities.test.ts +116 -0
- package/marketplace/plugins/git-forge/src/server/capabilities.ts +105 -0
- package/marketplace/plugins/git-forge/src/server/ci.test.ts +88 -0
- package/marketplace/plugins/git-forge/src/server/ci.ts +118 -0
- package/marketplace/plugins/git-forge/src/server/context.ts +76 -0
- package/marketplace/plugins/git-forge/src/server/diff.test.ts +127 -0
- package/marketplace/plugins/git-forge/src/server/diff.ts +120 -0
- package/marketplace/plugins/git-forge/src/server/filters.test.ts +138 -0
- package/marketplace/plugins/git-forge/src/server/filters.ts +138 -0
- package/marketplace/plugins/git-forge/src/server/forges.test.ts +235 -0
- package/marketplace/plugins/git-forge/src/server/gitea.ts +296 -0
- package/marketplace/plugins/git-forge/src/server/github-extras.ts +92 -0
- package/marketplace/plugins/git-forge/src/server/github.ts +320 -0
- package/marketplace/plugins/git-forge/src/server/gitlab-detail.ts +207 -0
- package/marketplace/plugins/git-forge/src/server/gitlab.test.ts +195 -0
- package/marketplace/plugins/git-forge/src/server/gitlab.ts +176 -0
- package/marketplace/plugins/git-forge/src/server/http.test.ts +270 -0
- package/marketplace/plugins/git-forge/src/server/http.ts +329 -0
- package/marketplace/plugins/git-forge/src/server/map.ts +120 -0
- package/marketplace/plugins/git-forge/src/server/registry.ts +47 -0
- package/marketplace/plugins/git-forge/src/server/remote.test.ts +146 -0
- package/marketplace/plugins/git-forge/src/server/remote.ts +188 -0
- package/marketplace/plugins/git-forge/src/server/scope-probe.test.ts +98 -0
- package/marketplace/plugins/git-forge/src/server/scope-probe.ts +128 -0
- package/marketplace/plugins/git-forge/src/server/scope.ts +66 -0
- package/marketplace/plugins/git-forge/src/server/test-context.ts +67 -0
- package/marketplace/plugins/git-forge/src/server/test-host.ts +51 -0
- package/marketplace/plugins/git-forge/src/server/token.test.ts +107 -0
- package/marketplace/plugins/git-forge/src/server/token.ts +139 -0
- package/marketplace/plugins/git-forge/src/server/write-http.test.ts +127 -0
- package/marketplace/plugins/git-forge/src/server/write-http.ts +110 -0
- package/marketplace/plugins/git-forge/src/server/writes.test.ts +218 -0
- package/marketplace/plugins/git-forge/src/server/writes.ts +313 -0
- package/marketplace/plugins/git-forge/src/server.ts +284 -0
- package/marketplace/plugins/git-forge/tsconfig.json +16 -0
- package/marketplace/plugins/session-info/package.json +4 -2
- package/marketplace/plugins/stats/package.json +4 -2
- package/package.json +6 -1
- package/src/client/components/common/code-surface/blame-hover.ts +188 -0
- package/src/client/components/common/code-surface/blame-panel.test.ts +304 -0
- package/src/client/components/common/code-surface/blame-panel.ts +306 -0
- package/src/client/components/common/code-surface/blame.test.ts +303 -0
- package/src/client/components/common/code-surface/blame.ts +227 -0
- package/src/client/components/common/code-surface/conflict-markers.test.ts +135 -0
- package/src/client/components/common/code-surface/conflict-markers.ts +144 -0
- package/src/client/components/common/code-surface/documents.ts +48 -1
- package/src/client/components/common/code-surface/extensions.test.ts +4 -0
- package/src/client/components/common/code-surface/extensions.ts +44 -0
- package/src/client/components/common/code-surface/fold-stack.test.ts +4 -0
- package/src/client/components/common/code-surface/indent.test.ts +5 -0
- package/src/client/components/common/code-surface/index.tsx +16 -2
- package/src/client/components/common/code-surface/lint-parsers.test.ts +109 -0
- package/src/client/components/common/code-surface/lint-parsers.ts +134 -0
- package/src/client/components/common/code-surface/lint.test.ts +101 -0
- package/src/client/components/common/code-surface/lint.ts +85 -0
- package/src/client/components/common/code-surface/props.ts +17 -0
- package/src/client/components/common/code-surface/surface-failures.test.ts +132 -0
- package/src/client/components/common/code-surface/theme.ts +71 -0
- package/src/client/components/common/header-controls/index.test.tsx +1 -1
- package/src/client/components/common/header-controls/plugin-entry.test.tsx +1 -1
- package/src/client/components/common/header-controls/shell-chrome.test.tsx +1 -1
- package/src/client/components/common/provider-icon/Plate.tsx +88 -0
- package/src/client/components/common/provider-icon/index.tsx +55 -11
- package/src/client/components/layout/session-sidebar/SessionsView.tsx +5 -2
- package/src/client/components/mobile/SessionSidebar.tsx +2 -10
- package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +6 -0
- package/src/client/components/mobile/mobile-right-sidebar/StatusBar.tsx +8 -0
- package/src/client/components/settings/categories/AppearanceSettings.tsx +3 -0
- package/src/client/components/settings/categories/ProviderSettings.tsx +43 -41
- package/src/client/components/settings/categories/appearance-settings/EditorBlameSection.tsx +97 -0
- package/src/client/components/settings/categories/panel-plugins/AvailableList.tsx +106 -54
- package/src/client/components/settings/categories/panel-plugins/GitFreshness.tsx +14 -1
- package/src/client/components/settings/categories/panel-plugins/InstalledList.tsx +39 -150
- package/src/client/components/settings/categories/panel-plugins/Meta.test.tsx +143 -0
- package/src/client/components/settings/categories/panel-plugins/Meta.tsx +157 -0
- package/src/client/components/settings/categories/panel-plugins/Placement.test.tsx +149 -0
- package/src/client/components/settings/categories/panel-plugins/Placement.tsx +99 -0
- package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +270 -0
- package/src/client/components/settings/categories/panel-plugins/Section.tsx +11 -3
- package/src/client/components/settings/categories/provider-settings/AddModelModal.tsx +25 -0
- package/src/client/components/settings/categories/provider-settings/AuthSection.tsx +135 -80
- package/src/client/components/settings/categories/provider-settings/DeleteProviderModal.tsx +51 -21
- package/src/client/components/settings/categories/provider-settings/EntryAdvanced.tsx +175 -0
- package/src/client/components/settings/categories/provider-settings/EntryModal.tsx +275 -0
- package/src/client/components/settings/categories/provider-settings/Header.tsx +40 -9
- package/src/client/components/settings/categories/provider-settings/LoginModal.tsx +142 -160
- package/src/client/components/settings/categories/provider-settings/LogoutProviderModal.tsx +2 -2
- package/src/client/components/settings/categories/provider-settings/ModelCapabilitiesModal.tsx +84 -46
- package/src/client/components/settings/categories/provider-settings/ModelsList.tsx +217 -102
- package/src/client/components/settings/categories/provider-settings/PresetPicker.tsx +5 -2
- package/src/client/components/settings/categories/provider-settings/SidebarList.plugin.test.ts +3 -3
- package/src/client/components/settings/categories/provider-settings/SidebarList.tsx +158 -102
- package/src/client/components/settings/categories/provider-settings/auth-section.test.tsx +135 -0
- package/src/client/components/settings/categories/provider-settings/groups.test.ts +98 -0
- package/src/client/components/settings/categories/provider-settings/groups.ts +108 -0
- package/src/client/components/settings/categories/provider-settings/layout.test.tsx +325 -0
- package/src/client/components/settings/categories/provider-settings/model-dialogs.test.tsx +135 -0
- package/src/client/components/settings/categories/provider-settings/preset-picker.test.tsx +73 -0
- package/src/client/components/settings/categories/usage-settings/ProviderCard.tsx +22 -2
- package/src/client/components/settings/categories/usage-settings/ProviderDetail.tsx +2 -0
- package/src/client/components/settings/categories/usage-settings/SidebarList.tsx +16 -6
- package/src/client/components/settings/categories/usage-settings/providers.ts +3 -0
- package/src/client/components/settings/categories/usage-settings/usage-and-picker.test.ts +19 -0
- package/src/client/components/settings/categories/usage-settings/usage-icons.test.tsx +143 -0
- package/src/client/components/workspace/chat-timeline/MinimapShortcuts.test.ts +2 -1
- package/src/client/components/workspace/chat-timeline/chat-input/GoalBanner.test.ts +23 -19
- package/src/client/components/workspace/chat-timeline/chat-input/ModeToggles.test.ts +23 -19
- package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.test.ts +20 -18
- package/src/client/components/workspace/chat-timeline/chat-input/compact.test.tsx +19 -6
- package/src/client/components/workspace/chat-timeline/index.tsx +7 -16
- package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.missing.test.ts +100 -0
- package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.test.ts +3 -47
- package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.tsx +8 -1
- package/src/client/components/workspace/chat-timeline/tool-renderers/panels/wait-test-util.ts +62 -0
- package/src/client/components/workspace/diff-panel/HunkStepper.tsx +62 -0
- package/src/client/components/workspace/diff-panel/MergeDiffView.tsx +29 -0
- package/src/client/components/workspace/diff-panel/Toolbar.tsx +32 -1
- package/src/client/components/workspace/diff-panel/changes.ts +69 -0
- package/src/client/components/workspace/diff-panel/chunks.ts +85 -0
- package/src/client/components/workspace/diff-panel/index.tsx +21 -1
- package/src/client/components/workspace/diff-panel/merge.test.ts +145 -0
- package/src/client/components/workspace/diff-panel/merge.ts +63 -68
- package/src/client/components/workspace/editor/EditorDropOverlay.tsx +6 -1
- package/src/client/components/workspace/editor/FileDocument.tsx +51 -1
- package/src/client/components/workspace/editor/FilePane.tsx +25 -1
- package/src/client/components/workspace/editor/StatusBar.tsx +19 -0
- package/src/client/components/workspace/editor/Toolbar.tsx +29 -5
- package/src/client/components/workspace/editor/toolbar-clusters.test.ts +86 -0
- package/src/client/components/workspace/editor/toolbar-clusters.tsx +48 -16
- package/src/client/components/workspace/editor/viewers/bytes.ts +16 -0
- package/src/client/components/workspace/git-panel/index.test.ts +46 -1
- package/src/client/components/workspace/git-panel/index.tsx +11 -38
- package/src/client/components/workspace/model-dropdown/Item.plugin.test.ts +66 -0
- package/src/client/components/workspace/model-dropdown/Item.tsx +71 -62
- package/src/client/components/workspace/model-dropdown/Section.tsx +31 -14
- package/src/client/components/workspace/model-dropdown/collapsed.ts +72 -0
- package/src/client/components/workspace/model-dropdown/index.tsx +42 -19
- package/src/client/components/workspace/model-dropdown/refresh.test.tsx +260 -0
- package/src/client/components/workspace/model-dropdown/trigger.test.ts +34 -0
- package/src/client/components/workspace/model-dropdown/use-catalog.ts +13 -2
- package/src/client/components/workspace/usage-panel/ProviderSelect.tsx +19 -3
- package/src/client/hooks/chat/omp/folder-auto-expand.ts +113 -0
- package/src/client/hooks/chat/omp/index.ts +20 -0
- package/src/client/hooks/chat/omp/pending-rows.ts +21 -0
- package/src/client/hooks/chat/omp/pending-sessions.test.ts +16 -1
- package/src/client/hooks/chat/omp/session-sidebar-controller.test.ts +102 -0
- package/src/client/hooks/chat/omp/session-sidebar-controller.ts +21 -1
- package/src/client/hooks/chat/omp/stream.ts +8 -1
- package/src/client/hooks/chat/timeline/index.ts +1 -1
- package/src/client/hooks/chat/timeline/new-chat-open.ts +60 -0
- package/src/client/hooks/editor/blame-settings.ts +67 -0
- package/src/client/hooks/editor/blame.test.ts +272 -0
- package/src/client/hooks/editor/blame.ts +232 -0
- package/src/client/hooks/editor/file-editor-types.ts +23 -0
- package/src/client/hooks/editor/save-file.test.ts +20 -0
- package/src/client/hooks/editor/use-editor-drop.test-util.ts +198 -0
- package/src/client/hooks/editor/use-editor-drop.test.ts +70 -175
- package/src/client/hooks/editor/use-editor-drop.ts +19 -36
- package/src/client/hooks/editor/use-file-editor.ts +7 -1
- package/src/client/hooks/settings/providers/actions.ts +90 -194
- package/src/client/hooks/settings/providers/api.ts +7 -1
- package/src/client/hooks/settings/providers/index.ts +171 -59
- package/src/client/hooks/settings/providers/login.test.ts +79 -0
- package/src/client/hooks/settings/providers/login.ts +276 -0
- package/src/client/hooks/settings/providers/messages.ts +28 -0
- package/src/client/hooks/settings/providers/model-actions.ts +178 -0
- package/src/client/hooks/ui/editor-error-toast.ts +47 -0
- package/src/client/hooks/ui/open-file.ts +7 -0
- package/src/client/hooks/ui/toasts.ts +7 -0
- package/src/client/hooks/workspace/file-tabs.ts +4 -1
- package/src/client/hooks/workspace/folder-expansion.test.ts +62 -0
- package/src/client/hooks/workspace/folder-expansion.ts +33 -0
- package/src/client/hooks/workspace/git-action-outcome.ts +86 -0
- package/src/client/hooks/workspace/git-actions.ts +29 -2
- package/src/client/hooks/workspace/plugin-contributions.test.ts +117 -0
- package/src/client/hooks/workspace/plugin-contributions.ts +146 -0
- package/src/client/lib/editor-errors.test.ts +85 -0
- package/src/client/lib/editor-errors.ts +71 -0
- package/src/client/lib/fs/resolve-open.test.ts +125 -0
- package/src/client/lib/fs/resolve-open.ts +90 -0
- package/src/client/lib/git/action-message.test.ts +82 -0
- package/src/client/lib/git/action-message.ts +160 -0
- package/src/client/lib/launch/device-files.test.ts +160 -0
- package/src/client/lib/launch/device-files.ts +197 -0
- package/src/client/lib/native/open-paths.test.ts +140 -0
- package/src/client/lib/native/open-paths.ts +157 -0
- package/src/client/lib/plugins/bootstrap.test.ts +1 -1
- package/src/client/main.tsx +20 -0
- package/src/server/db.server.test.ts +39 -0
- package/src/server/db.server.ts +21 -2
- package/src/server/lib/db/schema.ts +2 -0
- package/src/server/lib/fs/external-roots.test.ts +100 -0
- package/src/server/lib/fs/external-roots.ts +101 -0
- package/src/server/lib/fs/git-actions-branch.ts +15 -2
- package/src/server/lib/fs/git-actions-shared.ts +24 -0
- package/src/server/lib/fs/git-actions-sync.test.ts +18 -7
- package/src/server/lib/fs/git-actions-worktree.ts +5 -1
- package/src/server/lib/fs/git-blame.test.ts +206 -0
- package/src/server/lib/fs/git-blame.ts +189 -0
- package/src/server/lib/fs/root.ts +14 -0
- package/src/server/lib/http/same-origin.ts +28 -7
- package/src/server/lib/models/catalog.server.ts +230 -0
- package/src/server/lib/models/catalog.test.ts +83 -0
- package/src/server/lib/models/credential-origin.server.ts +108 -0
- package/src/server/lib/models/credential-origin.test.ts +132 -0
- package/src/server/lib/models/provider-icon-fetch.ts +115 -0
- package/src/server/lib/models/provider-icon-parse.test.ts +134 -0
- package/src/server/lib/models/provider-icon-parse.ts +139 -0
- package/src/server/lib/models/provider-icon-store.server.ts +118 -0
- package/src/server/lib/models/provider-icon-store.test.ts +107 -0
- package/src/server/lib/models/provider-icon.server.ts +209 -0
- package/src/server/lib/models/provider-items.server.ts +211 -37
- package/src/server/lib/models/provider-items.test.ts +201 -0
- package/src/server/lib/models/provider-registry.server.test.ts +27 -9
- package/src/server/lib/models/provider-registry.server.ts +160 -67
- package/src/server/lib/models/registry.server.test.ts +3 -3
- package/src/server/lib/models/registry.server.ts +8 -0
- package/src/server/lib/omp/config/definitions.test.ts +5 -4
- package/src/server/lib/omp/config/models-config.ts +42 -0
- package/src/server/lib/omp/config/provider-entry.test.ts +205 -0
- package/src/server/lib/omp/config/provider-entry.ts +197 -0
- package/src/server/lib/omp/config/provider-seeds.ts +10 -0
- package/src/server/lib/omp/core/models-json.ts +69 -0
- package/src/server/lib/omp/session/messages.ts +17 -3
- package/src/server/lib/omp/session/sidebar-data.canonical.test.ts +13 -3
- package/src/server/lib/panels/bundled-catalog.server.ts +7 -0
- package/src/server/lib/panels/catalog-offers.server.ts +68 -0
- package/src/server/lib/panels/git-update.server.test.ts +14 -0
- package/src/server/lib/panels/git-update.server.ts +63 -1
- package/src/server/lib/panels/manifest.test.ts +65 -0
- package/src/server/lib/panels/manifest.ts +55 -1
- package/src/server/lib/panels/offers.server.test.ts +191 -0
- package/src/server/lib/panels/offers.server.ts +108 -0
- package/src/server/lib/panels/registry.server.test.ts +35 -1
- package/src/server/lib/panels/registry.server.ts +51 -142
- package/src/server/lib/panels/scan.server.ts +162 -0
- package/src/server/lib/route-adapter.ts +13 -2
- package/src/server/lib/tray/tray.test.ts +2 -1
- package/src/server/lib/usage/providers.server.ts +4 -1
- package/src/server/routes/chat/session.ts +7 -1
- package/src/server/routes/fs/git-blame-loader.test.ts +146 -0
- package/src/server/routes/fs/git.ts +17 -0
- package/src/server/routes/fs/grant.test.ts +135 -0
- package/src/server/routes/fs/grant.ts +79 -0
- package/src/server/routes/fs/index.ts +2 -0
- package/src/server/routes/fs/scope.ts +34 -17
- package/src/server/routes/omp/login.ts +41 -14
- package/src/server/routes/omp/routes.test.ts +23 -10
- package/src/server/routes/settings/index.ts +8 -0
- package/src/server/routes/settings/provider-entry.ts +108 -0
- package/src/server/routes/settings/provider-icon.ts +99 -0
- package/src/server/routes/settings/provider-model.ts +4 -1
- package/src/server/routes/settings/provider-refresh.ts +87 -0
- package/src/server/routes/settings/providers.ts +31 -2
- package/src/shared/lib/chat/omp/fold.test.ts +34 -0
- package/src/shared/lib/chat/omp/tool-frames.test.ts +20 -0
- package/src/shared/lib/chat/omp/tool-frames.ts +5 -1
- package/src/shared/lib/chat/omp/tool-results.ts +29 -3
- package/src/shared/lib/chat/tool/wait-facts.ts +4 -0
- package/src/shared/lib/fs/git-blame.test.ts +266 -0
- package/src/shared/lib/fs/git-blame.ts +246 -0
- package/src/shared/lib/git/url.ts +18 -0
- package/src/shared/lib/markdown/sanitize.test.ts +57 -0
- package/src/shared/lib/markdown/sanitize.ts +30 -7
- package/src/shared/lib/models/provider/connection.ts +135 -0
- package/src/shared/lib/models/provider/dialect.test.ts +4 -2
- package/src/shared/lib/models/provider/dialect.ts +76 -6
- package/src/shared/lib/models/provider/models.ts +2 -0
- package/src/shared/lib/models/provider/origin.ts +94 -0
- package/src/shared/lib/models/provider/provider-ui.test.ts +7 -0
- package/src/shared/lib/models/server-cache.ts +8 -3
- package/src/shared/lib/omp/session/messages-map-pending.test.ts +110 -0
- package/src/shared/lib/omp/session/messages-map.ts +34 -2
- package/src/shared/lib/omp/session/prewarm-misc.test.ts +7 -90
- package/src/shared/lib/omp/session/prewarm.test.ts +133 -0
- package/src/shared/lib/omp/session/prewarm.ts +23 -1
- package/src/shared/lib/omp/session/wait.test.ts +28 -0
- package/src/shared/lib/omp/session/wait.ts +38 -3
- package/src/shared/lib/panels/slot-labels.test.ts +61 -0
- package/src/shared/lib/panels/slot-labels.ts +133 -0
- package/src/shared/lib/workspace/panel-ids.ts +11 -0
- package/src/shared/types/fs.ts +6 -0
- package/src/shared/types/index.ts +1 -0
- package/src/shared/types/models.ts +12 -0
- package/src/shared/types/panels-registry.ts +277 -0
- package/src/shared/types/panels.ts +46 -213
- package/src/shared/types/settings/provider.ts +58 -0
- package/src/shared/types/settings/usage.ts +10 -0
- package/src/test-support/pristine-globals.ts +7 -0
- package/dist/client/static/js/index-bq6qeayr.css +0 -1
- package/src/client/components/settings/categories/provider-settings/ReconnectModal.tsx +0 -184
package/README.md
CHANGED
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
</p>
|
|
18
18
|
|
|
19
19
|
<p align="center">
|
|
20
|
+
<a href="https://github.com/kabmo-labs/kabmo/wiki">Wiki</a> ·
|
|
20
21
|
<a href="AGENTS.md">Architecture</a> ·
|
|
21
22
|
<a href="DESIGN.md">Design</a> ·
|
|
22
23
|
<a href="CHANGELOG.md">Changelog</a> ·
|
|
@@ -28,13 +29,13 @@
|
|
|
28
29
|
|
|
29
30
|
## What it is
|
|
30
31
|
|
|
31
|
-
The browser view onto a live `omp` install. It is not a terminal wrapper: Kabmo reads
|
|
32
|
-
|
|
33
|
-
|
|
32
|
+
The browser view onto a live `omp` install. It is not a terminal wrapper: Kabmo reads omp's own
|
|
33
|
+
session JSONL, project registry, config and subagent transcripts, folds them into one live view, and
|
|
34
|
+
writes back through omp's RPC mode.
|
|
34
35
|
|
|
35
36
|
```bash
|
|
36
37
|
kabmo serve # production server + prebuilt client on :3000
|
|
37
|
-
bun run dev
|
|
38
|
+
bun run dev # source checkout: one process, HMR, no build step
|
|
38
39
|
```
|
|
39
40
|
|
|
40
41
|
- **One process.** Elysia serves the API and the client bundle, and the agent event stream is a
|
|
@@ -63,331 +64,99 @@ bun run dev # source checkout: one process, HMR, no build st
|
|
|
63
64
|
| <br>**Panel plugins** — every view is a plugin, including the eleven bundled ones | <br>**Providers** — dialects, discovery, hand-added models, credential removal |
|
|
64
65
|
| <br>**Mobile view** — the same session on a phone: chat, sessions drawer, and the panel drawer | <br>**Any palette** — 45 light and dark themes, applied to the whole console |
|
|
65
66
|
|
|
66
|
-
- **Chat timeline** — streaming thinking blocks (
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
- **Side questions** (`/btw [question]`) — replaces the composer with a panel that answers from a
|
|
75
|
-
private copy of the session file, so the parent transcript is never written; a topic can be
|
|
76
|
-
promoted into a session of its own, and it runs the same tool cards, thinking and usage rows as
|
|
77
|
-
the chat.
|
|
67
|
+
- **Chat timeline** — streaming thinking blocks (omp's narrated prose promoted to answer text), a
|
|
68
|
+
structured renderer per tool (bash, LSP, AST edit, `proc://` services, `wait` with a clock and
|
|
69
|
+
progress, zoomable mermaid), usage footers, a persistent follow-up queue, a jump rail, drag-and-drop
|
|
70
|
+
attachments, one-shot auto-titling and in-place undo that rewinds a session.
|
|
71
|
+
- **Steering, not cancelling** — a mid-run prompt is delivered INTO the running turn, so the answer
|
|
72
|
+
you were watching survives. A subagent can be steered or stopped on its own.
|
|
73
|
+
- **Side questions** (`/btw [question]`) — answer from a private copy of the session file, without
|
|
74
|
+
writing the parent transcript; a topic can be promoted into a session of its own.
|
|
78
75
|
- **Workspace sidebar** — folder → session tree off omp's project registry, with search, sort,
|
|
79
|
-
archive, per-session stream status, subagent rows, scheduled tasks, and a New Workspace dialog
|
|
80
|
-
|
|
81
|
-
- **Eleven right-panel views** — context & telemetry, files, search, source control,
|
|
82
|
-
terminal, your browser, the agent browser, usage, todos and plan; each remembers its own width
|
|
83
|
-
per session,
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
- **
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
and dictation.
|
|
92
|
-
- **Self-update** — `kabmo update` installs the latest version from npm, and **About → Updates**
|
|
93
|
-
does the same from the console, restarting the server and reloading the page into the new build.
|
|
94
|
-
- **Opt-in password, HTTPS and session revocation** — the UI is open by default and locked only when
|
|
95
|
-
you ask for it (`--ui-password` / `KABMO_UI_PASSWORD`), with `--tls` for a self-signed HTTPS
|
|
96
|
-
listener and `POST /api/auth/revoke` to end every session at once. See [Security](#security).
|
|
97
|
-
- **Tray icon and start at login** — `serve --tray` / `--startup`, with the icon as a child of the
|
|
98
|
-
server so it can never outlive it.
|
|
99
|
-
- **Dictation** — the composer's mic button runs omp's own speech-to-text worker (no API key, a
|
|
100
|
-
local model) and streams the transcript into the draft.
|
|
76
|
+
archive, per-session stream status, subagent rows, scheduled tasks, and a New Workspace dialog that
|
|
77
|
+
registers a directory or clones a repository.
|
|
78
|
+
- **Eleven right-panel views, each a plugin** — context & telemetry, files, search, source control,
|
|
79
|
+
wiki, terminal, your browser, the agent browser, usage, todos and plan; each remembers its own width
|
|
80
|
+
per session. A plugin can ship a Preact view, a server half, storage, RPC methods, a realtime topic
|
|
81
|
+
and settings; three are bundled (`Runner`, `Stats`, `Session Info`).
|
|
82
|
+
- **The whole omp settings surface** — engine config generated from omp's own schema, providers,
|
|
83
|
+
agents, `AGENTS.md` / `RULES.md`, slash commands, MCP servers with live connection tests, skills,
|
|
84
|
+
token usage, notifications and dictation.
|
|
85
|
+
- **Self-update, opt-in auth, tray and dictation** — `kabmo update` and **About → Updates** restart
|
|
86
|
+
into the new build; a password and HTTPS are opt-in; `serve --tray` puts the icon in the menu bar;
|
|
87
|
+
the composer's mic runs omp's own local speech-to-text.
|
|
101
88
|
|
|
102
89
|
## Themes
|
|
103
90
|
|
|
104
|
-

|
|
105
|
-
|
|
106
|
-

|
|
107
|
-
|
|
108
91
|
45 palettes in one catalog (`src/shared/lib/theme/`): Kabmo's own three (`paper`, `contrast`,
|
|
109
92
|
`one-dark-pro-soft`) and 21 light/dark pairs — Catppuccin, Gruvbox, Tokyo Night, Nord, Dracula,
|
|
110
93
|
Solarized, Kanagawa, Vesper, Ayu, Monokai and more. Switching repaints everything, syntax
|
|
111
|
-
highlighting and Mermaid diagrams included, through one writer
|
|
112
|
-
|
|
113
|
-
all follow with no reload.
|
|
94
|
+
highlighting and Mermaid diagrams included, through one writer that sets `data-theme` and announces
|
|
95
|
+
it — so an open editor, a live terminal and a diagram in the transcript all follow with no reload.
|
|
114
96
|
|
|
115
|
-

|
|
116
98
|
|
|
117
99
|
## Install
|
|
118
100
|
|
|
119
|
-
Kabmo is published to npm and runs on Bun
|
|
120
|
-
|
|
121
|
-
> **Bun only** — the server imports `bun:sqlite` and `Bun.YAML`, neither of which Node can load.
|
|
122
|
-
> Bun 1.4 or newer is required.
|
|
123
|
-
|
|
124
|
-
> **omp required** — every live capability (agent sessions, omp config, session state, updates)
|
|
125
|
-
> shells out to the `omp` binary, so `serve` refuses to start when it is not on `PATH` (or set via
|
|
126
|
-
> `KABMO_OMP_BIN`). `MOCK=true` is the only mode that runs without a real omp install.
|
|
101
|
+
Kabmo is published to npm and runs on **Bun 1.4+**, not Node. Live capabilities need the `omp`
|
|
102
|
+
binary on `PATH` (or `KABMO_OMP_BIN`); `MOCK=true` is the only mode that runs without one.
|
|
127
103
|
|
|
128
104
|
```bash
|
|
129
105
|
bun add -g @kabmo-labs/kabmo # puts the `kabmo` command on your PATH
|
|
130
106
|
kabmo serve # start the server on :3000
|
|
131
107
|
```
|
|
132
108
|
|
|
133
|
-
|
|
134
|
-
`~/.ompchamber` to `~/.kabmo` (database, login, sessions and marketplace), and the
|
|
135
|
-
`OMPCHAMBER_*` environment names are still read as fallbacks.
|
|
136
|
-
|
|
137
|
-
The published tarball carries the source, the CLI and the prebuilt client bundle, so there is no
|
|
138
|
-
build step after install. `npm install -g @kabmo-labs/kabmo` works too — the `kabmo` bin is a Bun
|
|
139
|
-
script, so Bun still has to be on `PATH`.
|
|
140
|
-
|
|
141
|
-
### From source
|
|
142
|
-
|
|
143
|
-
```bash
|
|
144
|
-
git clone https://github.com/kabmo-labs/kabmo.git
|
|
145
|
-
cd kabmo
|
|
146
|
-
bun install
|
|
147
|
-
bun run build # dist/client — the only build artifact
|
|
148
|
-
|
|
149
|
-
bun run start # NODE_ENV=production bun run src/server/index.ts
|
|
150
|
-
bun link # then: kabmo status
|
|
151
|
-
```
|
|
152
|
-
|
|
153
|
-
> Without `dist/client` the server answers `503` with the exact command to run — never a bare `500`.
|
|
154
|
-
|
|
155
|
-
### Updating
|
|
109
|
+
From a checkout:
|
|
156
110
|
|
|
157
111
|
```bash
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
112
|
+
git clone https://github.com/kabmo-labs/kabmo.git && cd kabmo
|
|
113
|
+
bun install && bun run build # dist/client — the only build artifact
|
|
114
|
+
bun run start # or: bun link, then `kabmo status`
|
|
161
115
|
```
|
|
162
116
|
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
you to commit or stash first), and an install owned by another package manager is left alone and told
|
|
166
|
-
which command to run.
|
|
167
|
-
|
|
168
|
-
A server Kabmo did not start is never restarted: `bun run dev`, `bun run start`, a manual
|
|
169
|
-
`bun src/server/index.ts` and instances owned by a supervisor (systemd, pm2, a container) all record
|
|
170
|
-
themselves as `direct`, so the update leaves them running and says so. `--no-restart` turns the
|
|
171
|
-
restart off entirely. The console's **About → Updates** runs the same install, restarts the instance
|
|
172
|
-
serving that console, and reloads the page once the replacement answers on the same port.
|
|
173
|
-
|
|
174
|
-
## CLI
|
|
175
|
-
|
|
176
|
-
`kabmo [COMMAND] [OPTIONS]` — `serve` is the default command.
|
|
177
|
-
|
|
178
|
-
| Command | Purpose |
|
|
179
|
-
|---|---|
|
|
180
|
-
| `serve` | Start the web server (daemon by default) |
|
|
181
|
-
| `update` | Install the latest version from npm, then restart the instance it started |
|
|
182
|
-
| `stop` | Stop the instances the CLI started — `--port`/`--all` to stop any |
|
|
183
|
-
| `restart` | Stop, then start again — leaving servers started from source alone |
|
|
184
|
-
| `status` | Report whether an instance is running |
|
|
185
|
-
| `logs` | Print or follow the server log |
|
|
186
|
-
| `plugin` | Build, type, scaffold or list panel plugins |
|
|
187
|
-
|
|
188
|
-
| Option | Purpose |
|
|
189
|
-
|---|---|
|
|
190
|
-
| `-p, --port <port>` | Web server port (default `3000`); scopes `status`/`stop`/`restart`/`logs` |
|
|
191
|
-
| `--host <address>` (`--hostname`) | Bind address (default `127.0.0.1`) |
|
|
192
|
-
| `--lan` | Bind to `0.0.0.0` for LAN access (warns when the traffic is unencrypted) |
|
|
193
|
-
| `--tls` | Serve HTTPS from a self-signed certificate, generated once into `~/.kabmo/tls/` |
|
|
194
|
-
| `--tray` | Show a menu-bar/notification-area icon for this server |
|
|
195
|
-
| `--startup` | Start the server at login (and show the tray icon now) |
|
|
196
|
-
| `--no-startup` | Remove the login entry |
|
|
197
|
-
| `--ui-password [value]` | Require a password for the browser UI; generates one when the value is omitted |
|
|
198
|
-
| `--no-ui-password` | Ignore `KABMO_UI_PASSWORD` for this start |
|
|
199
|
-
| `--prod` | Accepted for compatibility — production is the default |
|
|
200
|
-
| `--dev` | Run the dev server from source (HMR, unminified) instead |
|
|
201
|
-
| `--foreground` (`--no-daemon`) | Run in the foreground (no daemon) |
|
|
202
|
-
| `--all` | Apply the command to every running instance |
|
|
203
|
-
| `-c, --check` | Report whether a newer release exists without installing it |
|
|
204
|
-
| `--force` | Reinstall even when already up to date |
|
|
205
|
-
| `--no-restart` | Do not restart a running instance after updating |
|
|
206
|
-
| `-f, --follow` / `-n, --lines <count>` | Tail the log, optionally from a line count |
|
|
207
|
-
| `--json` / `-q, --quiet` | Machine-readable output / suppress non-essential output |
|
|
208
|
-
|
|
209
|
-
### Tray icon and start at login
|
|
210
|
-
|
|
211
|
-
`kabmo serve --tray` puts a Kabmo icon in the menu bar (macOS) or the notification area
|
|
212
|
-
(Windows, Linux). `--startup` additionally registers the server to start at every login, and
|
|
213
|
-
`--no-startup` removes that registration:
|
|
117
|
+
Updating, the full CLI reference, the tray and login entry, and multi-instance ports:
|
|
118
|
+
**[Installation →](https://github.com/kabmo-labs/kabmo/wiki/Installation)**
|
|
214
119
|
|
|
215
|
-
|
|
216
|
-
kabmo serve --tray # start the server with a tray icon
|
|
217
|
-
kabmo serve --startup # also start at every login
|
|
218
|
-
kabmo serve --no-startup # remove the login entry
|
|
219
|
-
```
|
|
120
|
+
## Configuration
|
|
220
121
|
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
- **The tray is a child of the server.** It exits when the server does (it watches its parent), so a
|
|
225
|
-
killed or crashed server leaves no orphan icon, and **Quit Kabmo signals the server** — the
|
|
226
|
-
icon and the console end together. There is no pid file, no `status`/`stop` for the icon, and
|
|
227
|
-
nothing to keep in sync: the process tree is the registration.
|
|
228
|
-
- **The login entry runs `serve --foreground`.** launchd reaps a job's whole process tree when the
|
|
229
|
-
job's program exits, so an entry that ran a detached `serve` (which returns once the health check
|
|
230
|
-
passes) produced no server at all. In the foreground the CLI is the long-lived job, the server is
|
|
231
|
-
its child, and the tray is the server's child. Verified against `launchctl print`: the entry is
|
|
232
|
-
`state = running` with the CLI as its program.
|
|
233
|
-
- **macOS** registers `~/Library/LaunchAgents/dev.kabmo.tray.plist` (`RunAtLoad`, no
|
|
234
|
-
`KeepAlive` — a server stopped on purpose stays stopped). **Linux** writes
|
|
235
|
-
`$XDG_CONFIG_HOME/autostart/kabmo-tray.desktop`, which every freedesktop session reads.
|
|
236
|
-
**Windows** sets the HKCU `…\CurrentVersion\Run` value through `reg`, so registering never needs
|
|
237
|
-
elevation.
|
|
238
|
-
- **What draws the icon is the platform's own tray API**: an AppKit status item on macOS (via
|
|
239
|
-
`osascript -l JavaScript`), `System.Windows.Forms.NotifyIcon` on Windows, and `yad`/`zenity`
|
|
240
|
-
`--notification` on Linux. Only Linux can lack a client — the icon is then skipped with the
|
|
241
|
-
package to install in the log, and the server keeps running.
|
|
242
|
-
- `--startup` without `--tray` is a supported shape: the login-started server comes up without an
|
|
243
|
-
icon.
|
|
244
|
-
|
|
245
|
-
### Ports and multiple instances
|
|
246
|
-
|
|
247
|
-
One port is served by exactly one process, and `bun run dev`, `kabmo serve` and the production
|
|
248
|
-
server all default to `3000`. **A starting instance never stops another one** — if the port is taken
|
|
249
|
-
by Kabmo, the newcomer reports who holds it and exits non-zero so you can pick another port:
|
|
122
|
+
Environment variables (`PORT`, `HOST`, `MOCK`, `KABMO_DATA_DIR`, `KABMO_OMP_BIN`, …), the SQLite
|
|
123
|
+
state and the two data modes: **[Configuration →](https://github.com/kabmo-labs/kabmo/wiki/Configuration)**
|
|
250
124
|
|
|
251
125
|
```bash
|
|
252
|
-
kabmo serve
|
|
253
|
-
|
|
254
|
-
PORT=3001 bun run dev # or: PORT=3001 bun run start
|
|
126
|
+
PORT=3001 kabmo serve # one port, one process; a second instance never steals it
|
|
127
|
+
MOCK=true bun run dev # demo datasets, no omp install needed
|
|
255
128
|
```
|
|
256
129
|
|
|
257
|
-
- Nothing is ever signalled to free a port; `kabmo stop --port 3000` is the deliberate way.
|
|
258
|
-
- A process that is **not** Kabmo is never signalled either: the server names the port and
|
|
259
|
-
prints the `lsof -nP -iTCP:<port> -sTCP:LISTEN` command to identify it.
|
|
260
|
-
- **`localhost` is two addresses, and the port is taken if either one is.** `Bun.serve` binds only
|
|
261
|
-
the family a name resolves to first (`[::1]` for `localhost`), so a check aimed at that family
|
|
262
|
-
alone reported a free port while another instance held `127.0.0.1` — two servers answering "port
|
|
263
|
-
3000", and a browser landing on whichever one it resolved. Both `127.0.0.1` and `::1` are now
|
|
264
|
-
probed (and both are asked over `/api/health`, which is what `status`/`stop` use to find a live
|
|
265
|
-
instance), and the refusal names the address that is held. A literal address (`--host 0.0.0.0`,
|
|
266
|
-
`127.0.0.1`) is one address and is probed as exactly that.
|
|
267
|
-
- `bun run dev` hot reload is unaffected: `--hot` re-evaluates the entry inside the running
|
|
268
|
-
process, and a port held by that process is recognized as its own.
|
|
269
|
-
- `status` and `logs` report **every** live instance by default; `--port <port>` narrows them to one.
|
|
270
|
-
`stop` acts on the instances the CLI started, and `restart`/`update` skip the rest: `bun run dev`
|
|
271
|
-
is a supervisor whose only job is to mirror the script under it, so stopping that server exits
|
|
272
|
-
the dev loop with it. Name the instance — `kabmo stop --port <port>`, or `--all` — to end
|
|
273
|
-
one anyway.
|
|
274
|
-
|
|
275
|
-
The server writes `~/.kabmo/run/<port>.json` (`pid`, `host`, `mode`, `launchMode`, `startedAt`)
|
|
276
|
-
once it owns the port, which is how `status`/`stop`/`logs` also see servers started by `bun run dev`
|
|
277
|
-
or `--foreground`. `launchMode` is derived from the process's **argv**, never from an environment
|
|
278
|
-
variable — env is inherited, so a `bun run dev` started inside a Kabmo shell would otherwise be
|
|
279
|
-
replaced by an update. Records left by a killed server are pruned once their PID stops answering.
|
|
280
|
-
|
|
281
|
-
- `stop` reports what actually happened. The record is dropped only once the process is gone, so a
|
|
282
|
-
stop that could not end the server keeps it — `kabmo status` still finds the instance, the
|
|
283
|
-
message says so, and the command exits non-zero. Deleting the record over a live process was how a
|
|
284
|
-
failed stop turned into a deadlock: `status` said "not running" while `serve` refused the port.
|
|
285
|
-
- A PID whose identity cannot be read (Windows cannot read another process's command line, so every
|
|
286
|
-
PID there reads back as unverified) is resolved through the **port** instead: `/api/health` names
|
|
287
|
-
the instance serving it. Only when the port names a different PID — a recycled PID, a foreign
|
|
288
|
-
listener — is the record treated as stale and cleared without signalling anything.
|
|
289
|
-
|
|
290
|
-
## Configuration
|
|
291
|
-
|
|
292
|
-
Environment variables, read from `.env` (see [`.env.example`](.env.example)):
|
|
293
|
-
|
|
294
|
-
| Variable | Default | Purpose |
|
|
295
|
-
|---|---|---|
|
|
296
|
-
| `PORT` | `3000` | Server port |
|
|
297
|
-
| `HOST` | `localhost` | Server bind address |
|
|
298
|
-
| `MOCK` | `false` | `true` = demo datasets, `false` = real SQLite + workspace only |
|
|
299
|
-
| `SYNC_WORKSPACE` | `true` | Seed the workspace list from discovered omp projects — only while the list is still empty (one-time bootstrap; a curated list is never appended to) |
|
|
300
|
-
| `KABMO_DATA_DIR` (`OMPCHAMBER_DATA_DIR`) | `~/.kabmo` | CLI registry, logs, database, wiki mirrors and TLS certificate root |
|
|
301
|
-
| `KABMO_PORT` / `KABMO_HOST` | — | Defaults for the CLI when no flag is passed |
|
|
302
|
-
| `KABMO_UI_PASSWORD` (`OMPCHAMBER_UI_PASSWORD`) | — | Require a UI password (see [Security](#security)); erased from the environment at boot |
|
|
303
|
-
| `KABMO_DB_PATH` (`OMPCHAMBER_DB_PATH`, `DB_PATH`) | `~/.kabmo/db.sqlite` | SQLite database path |
|
|
304
|
-
| `KABMO_BUN` | — | Explicit Bun binary for the CLI to spawn |
|
|
305
|
-
| `KABMO_OMP_BIN` (`OMPCHAMBER_OMP_BIN`) | — | Explicit `omp` binary path |
|
|
306
|
-
| `KABMO_MARKETPLACE_DIR` / `KABMO_BUNDLED_MARKETPLACE_DIR` | — | Override where plugin marketplaces are read from |
|
|
307
|
-
| `PI_CONFIG_DIR` / `PI_CODING_AGENT_DIR` | `~/.omp` | Oh-My-Pi config root overrides |
|
|
308
|
-
| `SKILLS_API_URL` | `https://skills.sh` | Skills catalog source |
|
|
309
|
-
| `NPM_CONFIG_REGISTRY` | `https://registry.npmjs.org` | Registry the update check reads |
|
|
310
|
-
|
|
311
|
-
Runtime state, sessions and settings live in SQLite (`~/.kabmo/db.sqlite`), the single source
|
|
312
|
-
of truth for persisted settings. Per-session UI state (open tabs, panel widths, the picked repo,
|
|
313
|
-
drafts) lives beside it, keyed by session id, so a reload restores the layout that session was left
|
|
314
|
-
in.
|
|
315
|
-
|
|
316
130
|
## Security
|
|
317
131
|
|
|
318
|
-
**
|
|
319
|
-
|
|
320
|
-
(`~/.kabmo/auth.json`, mode 0600), so `bun run --hot` does not sign you out on every save while
|
|
321
|
-
nothing durable can enable authentication on its own.
|
|
132
|
+
The UI is **open by default**; a password is supplied per run and hashed in memory, so nothing on
|
|
133
|
+
disk can enable authentication on its own.
|
|
322
134
|
|
|
323
135
|
```bash
|
|
324
|
-
kabmo serve --ui-password
|
|
325
|
-
kabmo serve --ui-password
|
|
326
|
-
kabmo serve --tls --ui-password … # HTTPS, cookie gains Secure
|
|
136
|
+
kabmo serve --ui-password # generates one and prints it once
|
|
137
|
+
kabmo serve --tls --ui-password …
|
|
327
138
|
```
|
|
328
139
|
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
browsers key a cookie jar by host and ignore the port. `HttpOnly`, `SameSite=Lax`, and `Secure`
|
|
334
|
-
whenever the request arrived over https — including through a proxy that sets
|
|
335
|
-
`x-forwarded-proto`. Changing the password or calling `POST /api/auth/revoke` rotates the signing
|
|
336
|
-
secret and ends every session everywhere. The token binds to a key derived from the password, so a
|
|
337
|
-
restart with the same password keeps your session and a different one kills it.
|
|
338
|
-
- **TLS** — `--tls` generates a self-signed certificate (SAN covering `localhost`, `127.0.0.1` and
|
|
339
|
-
the machine's LAN addresses) into `~/.kabmo/tls/`. Your browser warns once, then the
|
|
340
|
-
connection is encrypted. Without it, a password and the session cookie cross the network in
|
|
341
|
-
cleartext, which is what `--lan` warns about.
|
|
342
|
-
- **No TLS locally?** A tunnel terminates TLS at the edge and needs no certificate:
|
|
343
|
-
`cloudflared tunnel --url http://127.0.0.1:3000`. Verified end to end — login, the API gate, SSE
|
|
344
|
-
and the terminal WebSocket all work through the public URL, in dev and in the production build.
|
|
345
|
-
- **Local sockets are origin-checked.** The terminal PTY and dictation WebSockets verify the
|
|
346
|
-
upgrade's origin with the same predicate, because both trigger real work on this machine.
|
|
347
|
-
|
|
348
|
-
Bind to loopback (the default) and reach it over SSH port-forwarding, a VPN, or a tunnel. Exposing
|
|
349
|
-
the port directly is the option with the least margin for error.
|
|
140
|
+
Sessions are stateless HMAC cookies named per port, login is throttled per socket address, `--tls`
|
|
141
|
+
generates a self-signed certificate, and the terminal and dictation sockets are origin-checked.
|
|
142
|
+
Bind to loopback and reach it over SSH, a VPN or a tunnel — full detail in
|
|
143
|
+
**[Security →](https://github.com/kabmo-labs/kabmo/wiki/Security)**
|
|
350
144
|
|
|
351
145
|
## Architecture
|
|
352
146
|
|
|
353
147
|
```text
|
|
354
148
|
src/
|
|
355
149
|
├─ client/ Preact UI — zero React packages
|
|
356
|
-
│ ├─ components/ layout, workspace, settings, mobile, common
|
|
357
|
-
│ ├─ hooks/ chat, workspace, ui, browser, models, settings
|
|
358
|
-
│ ├─ data/ mock datasets, samples, themes, model + agent catalogs
|
|
359
|
-
│ └─ tailwind.css theme tokens (--theme-ink, --theme-paper, …)
|
|
360
150
|
├─ server/ Bun-only — Elysia routes, SQLite, omp RPC bridge, fs/git/terminal
|
|
361
|
-
│ ├─ routes/ one plugin per domain, mounted in routes/index.ts
|
|
362
|
-
│ ├─ lib/ omp session/subagent/config, panels, wiki, updates, lifecycle
|
|
363
|
-
│ └─ plugins/ SSR shell, static assets, compression, dev assets
|
|
364
151
|
├─ shared/ Imported by both — types, chat timeline folding, pure helpers
|
|
365
152
|
└─ cli/ kabmo command (plain ESM, runs under Bun)
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
├─ kabmo-sdk/ the panel-plugin contract (types, backend API, slots)
|
|
369
|
-
└─ kabmo-ui/ the Preact kit a plugin builds against
|
|
370
|
-
|
|
371
|
-
marketplace/plugins/
|
|
372
|
-
├─ command-runner/ a repository's commands, 18 sources across 15 toolchains
|
|
373
|
-
├─ stats/ CPU and RAM of the whole omp stack
|
|
374
|
-
└─ session-info/ active workspace and a note per session
|
|
153
|
+
packages/ kabmo-sdk (plugin contract) · kabmo-ui (Preact kit)
|
|
154
|
+
marketplace/ command-runner · stats · session-info
|
|
375
155
|
```
|
|
376
156
|
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
-
|
|
380
|
-
browser. Server-only helpers belong in `src/server/lib/**`.
|
|
381
|
-
- **Route modules keep the ported Remix shape** (`loader` for GET, `action` for mutations) so status
|
|
382
|
-
codes stay identical; `action` owns method dispatch and returns its own `405`.
|
|
383
|
-
- **Every internal import uses the `@/` alias**, folders mirror component names in kebab-case, and
|
|
384
|
-
every `.ts`/`.tsx` file stays under 350 lines.
|
|
385
|
-
- **Every right-panel view is a plugin**, including the eleven Kabmo ships: one catalog merges
|
|
386
|
-
the built-ins and the installed ones, so a view cannot be a table in one layout and a fetch in the
|
|
387
|
-
other.
|
|
388
|
-
|
|
389
|
-
[`AGENTS.md`](AGENTS.md) is the normative reference for all of the above — the invariants behind the
|
|
390
|
-
panels, the BTW subsystem, the PTY terminal, the plugin platform and the build/dev loop.
|
|
157
|
+
[`AGENTS.md`](AGENTS.md) is the short binding contract for contributors and agents. The detail —
|
|
158
|
+
every subsystem, the invariants and the measured reason behind each one — lives in the
|
|
159
|
+
**[wiki](https://github.com/kabmo-labs/kabmo/wiki)**.
|
|
391
160
|
|
|
392
161
|
## Development
|
|
393
162
|
|
|
@@ -396,16 +165,9 @@ bun run dev # watched server; the client bundle is built on demand
|
|
|
396
165
|
bun run dev:lan # same, bound to the LAN
|
|
397
166
|
```
|
|
398
167
|
|
|
399
|
-
One process
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
A dev server keeps the whole module graph open for HMR (~3.5k descriptors after one page load), so
|
|
403
|
-
`GET /api/health` reports `fds.open` and `kabmo status` prints it — a long-lived session belongs
|
|
404
|
-
on a production server.
|
|
405
|
-
|
|
406
|
-
`bun run build` produces the production bundle — `scripts/build-client.ts` writes `dist/client`, which
|
|
407
|
-
`kabmo serve` runs. The CLI builds it on demand the first time when it is missing, so a source
|
|
408
|
-
checkout needs no manual build; `--dev` skips the bundle entirely.
|
|
168
|
+
One process: Bun serves the HTML shell and bundles its assets itself, so there is no separate client
|
|
169
|
+
watcher and no build before the first request — a server save restarts, a client save is pushed over
|
|
170
|
+
HMR. `bun run build` writes `dist/client`, which `kabmo serve` runs.
|
|
409
171
|
|
|
410
172
|
Verification gates, all mandatory:
|
|
411
173
|
|
|
@@ -417,139 +179,23 @@ bun test # unit + route sui
|
|
|
417
179
|
bun run typecheck:e2e # the Playwright specs
|
|
418
180
|
```
|
|
419
181
|
|
|
420
|
-
The browser layer is Playwright (`tests/e2e/`,
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
The screenshots, GIFs and the MP4 in [`docs/assets`](docs/assets) are generated by
|
|
425
|
-
`bun run readme:media` ([`scripts/readme-media.ts`](scripts/readme-media.ts)), which boots an
|
|
426
|
-
isolated `MOCK=true` server (its own data dir, database, agent dir and marketplace root) and drives
|
|
427
|
-
the real UI through Playwright, so they contain demo data only — never a real workspace. Pass
|
|
428
|
-
`--shots` or `--video` to regenerate one half. The wordmark at the top is
|
|
429
|
-
[`public/kabmo-wordmark.svg`](public/kabmo-wordmark.svg): the icon's K lockup with the word
|
|
430
|
-
outlined (no font required), one ink that holds on a light *and* a dark README, and an
|
|
431
|
-
`aria-label` so the image is still named for assistive tech.
|
|
432
|
-
|
|
433
|
-
The three logos in the badge row live in [`docs/assets/brand`](docs/assets/brand) — Elysia and
|
|
434
|
-
Shiki have no Simple Icons slug and shields rejects a remote `logo=` URL, so each mark is inlined
|
|
435
|
-
in the badge as a base64 data URI. Their provenance, licences and recolouring are documented
|
|
436
|
-
beside them, and `docs/assets/brand/badges.test.ts` fails if a mark and its embedded payload drift
|
|
437
|
-
apart.
|
|
438
|
-
|
|
439
|
-
## Releasing
|
|
440
|
-
|
|
441
|
-
A push to `main` cuts the release — there is no manual version bump
|
|
442
|
-
([`.github/workflows/release.yml`](.github/workflows/release.yml)). The workflow calls the same
|
|
443
|
-
reusable gates a pull request runs, then publishes as the last jobs of its own run:
|
|
444
|
-
|
|
445
|
-
```text
|
|
446
|
-
gates → e2e → packages → packages-publish
|
|
447
|
-
→ marketplace → app → app-publish
|
|
448
|
-
```
|
|
449
|
-
|
|
450
|
-
1. `semantic-release` reads the Conventional Commits since the last tag, decides the next
|
|
451
|
-
version, writes it into `package.json` and a `## [x.y.z]` section of `CHANGELOG.md`, commits
|
|
452
|
-
both, then creates the tag and the GitHub Release.
|
|
453
|
-
2. `publish-app.yml` checks out the tag, verifies it against `package.json`, typechecks, runs
|
|
454
|
-
`bun test`, builds `dist/client`, packs a dry run, and runs `bun publish`. Publishing is the
|
|
455
|
-
**last action of the release run** rather than a second run dispatched beside it, so a release
|
|
456
|
-
cannot report success while its publish is still queued, still waiting on the `npm` environment,
|
|
457
|
-
or already failed.
|
|
458
|
-
3. The same run releases `@kabmo-labs/kabmo-sdk` and `@kabmo-labs/kabmo-ui` FIRST (the app pins them, and
|
|
459
|
-
a `workspace:` spec is substituted from `bun.lock`), then bumps the bundled marketplace plugins
|
|
460
|
-
by their own commit history — a bundled plugin's manifest version is the whole delivery
|
|
461
|
-
mechanism, since `syncBundledPlugins` applies a new copy only when the store's version is
|
|
462
|
-
strictly newer.
|
|
463
|
-
|
|
464
|
-
What a commit does to the version is one table, in
|
|
465
|
-
[`release/release-rules.js`](release/release-rules.js), and `release/bump.test.js` asserts it:
|
|
466
|
-
|
|
467
|
-
| Commit | Version |
|
|
468
|
-
| --- | --- |
|
|
469
|
-
| `feat` | minor |
|
|
470
|
-
| `fix`, `perf`, `revert` | patch |
|
|
471
|
-
| `feat!` / `fix!` / `perf!` / `refactor!`, or a `BREAKING CHANGE:` footer | major |
|
|
472
|
-
| `docs`, `refactor`, `chore`, `style`, `test`, `build`, `ci` | no release |
|
|
473
|
-
|
|
474
|
-
Two of those rows exist because the toolchain's own defaults are wrong here: a `!` on a type that
|
|
475
|
-
cannot carry a breaking change (`chore!`, `docs!`, an unknown `foo!`) used to cut a major version
|
|
476
|
-
through the analyzer's built-in `{ breaking: true }` fallback, and the parser's note regex is
|
|
477
|
-
case-insensitive, so any body line starting with `breaking change` — colon optional — counted as a
|
|
478
|
-
breaking note. The second one is not hypothetical: a `docs` commit whose body wrapped onto
|
|
479
|
-
`breaking-change (!) footer` cut **v1.0.0** where the `feat`s in the range asked for v0.9.0, and the
|
|
480
|
-
changelog printed that prose as its breaking note. Both are fixed in `release/release-rules.js`, and
|
|
481
|
-
both are locked by `release/bump.test.js`.
|
|
482
|
-
|
|
483
|
-
A `BREAKING CHANGE:` footer is therefore read only in uppercase, and only where the type allows it.
|
|
484
|
-
|
|
485
|
-
Two things to set up once and one to never do:
|
|
486
|
-
|
|
487
|
-
- GitHub environment **`npm`** with a secret `NPM_TOKEN`: a granular npm token with read/write on
|
|
488
|
-
`kabmo` (and the two packages), 2FA bypass enabled and the `publish and stage` action (a
|
|
489
|
-
stage-only token is rejected — Bun has no `npm stage publish`).
|
|
490
|
-
- A failed publish is retried with `gh workflow run publish.yml -f tag=vX.Y.Z`, which leaves the
|
|
491
|
-
release itself untouched. `publish.yml` is now only a TRIGGER (a published release, or that
|
|
492
|
-
dispatch); the steps it runs live in `publish-app.yml`, which `release.yml` also calls.
|
|
493
|
-
- **Never** write a skip marker (`[skip ci]`, `[ci skip]`, `[no ci]`) into a message pushed to
|
|
494
|
-
`main` — it scans the whole message and silently skips the release run. Only the bot's release
|
|
495
|
-
commit carries one, so that it does not re-trigger the workflow.
|
|
496
|
-
|
|
497
|
-
### GitHub Packages (optional, second destination)
|
|
498
|
-
|
|
499
|
-
npmjs.org is the registry every install path reads, and nothing about it changes. A separate
|
|
500
|
-
**manual** workflow can additionally publish the same packages to GitHub Packages
|
|
501
|
-
([`publish-github-packages.yml`](.github/workflows/publish-github-packages.yml)):
|
|
502
|
-
|
|
503
|
-
```bash
|
|
504
|
-
gh workflow run publish-github-packages.yml -f packages="packages/kabmo-sdk packages/kabmo-ui"
|
|
505
|
-
```
|
|
506
|
-
|
|
507
|
-
It is not part of a release, and no manifest carries `publishConfig.registry` — that one field
|
|
508
|
-
would redirect the whole pipeline, and GitHub Packages refuses **anonymous** reads for every
|
|
509
|
-
package, public ones included. Moving the app's release there would turn
|
|
510
|
-
`registry.npmjs.org/@kabmo-labs%2fkabmo/latest` (what `kabmo update` asks) into a 401 for every
|
|
511
|
-
user. Use it only for the case the public registry cannot serve: a private fork, an internal
|
|
512
|
-
mirror, a plugin author who already has a GitHub credential.
|
|
513
|
-
|
|
514
|
-
A consumer then needs two lines in `.npmrc` and a token with `read:packages`:
|
|
515
|
-
|
|
516
|
-
```ini
|
|
517
|
-
@kabmo-labs:registry=https://npm.pkg.github.com
|
|
518
|
-
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
|
|
519
|
-
```
|
|
520
|
-
|
|
521
|
-
Three facts about that registry, each measured rather than assumed:
|
|
522
|
-
|
|
523
|
-
- **A first publish is private.** Visibility is per package in the repository settings; no
|
|
524
|
-
manifest field or workflow input can set it.
|
|
525
|
-
- **A version is never overwritten.** A republish is refused with `409`, and
|
|
526
|
-
`bun publish --tolerate-republish` does **not** suppress it — so the script skips a version that
|
|
527
|
-
is already there, which is also what makes a re-run finish a half-published run.
|
|
528
|
-
- **`bun publish` needs `--registry` AND `NPM_CONFIG_TOKEN` together.** A `.npmrc`
|
|
529
|
-
`_authToken=${VAR}` is sent literally (bun does not expand the environment), and a bare
|
|
530
|
-
`@kabmo-labs:registry` line is ignored by `bun publish` — which would silently publish to
|
|
531
|
-
npmjs.org instead. `tests/publish-github-packages.test.ts` pins all of it.
|
|
532
|
-
|
|
533
|
-
**Token.** The workflow's own `GITHUB_TOKEN` (`packages: write`) is enough **once each package is
|
|
534
|
-
associated with this repository**, which the `repository` field in every `package.json` already
|
|
535
|
-
does. The one case it cannot cover is a first publish that answers
|
|
536
|
-
`403 … The requested installation does not exist` / `permission_denied: create_package` — a
|
|
537
|
-
`GITHUB_TOKEN` may only write to a package associated with its own repository. Add a repository
|
|
538
|
-
secret **`GH_PACKAGES_TOKEN`** for that: a PAT **classic** with `write:packages` (GitHub Packages
|
|
539
|
-
does not accept granular tokens). It takes precedence over the job token when present, and the
|
|
540
|
-
script prints both possible causes on a 403 rather than echoing the registry's text.
|
|
182
|
+
The browser layer is Playwright (`tests/e2e/`, `*.e2e.ts`) and boots a real server subprocess against
|
|
183
|
+
an isolated temp root per spec; `bun run test:e2e` runs it, and CI runs it on every push to `main`
|
|
184
|
+
plus label-gated pull requests. The screenshots and GIFs in [`docs/assets`](docs/assets) are generated
|
|
185
|
+
by `bun run readme:media` against an isolated `MOCK=true` server, so they contain demo data only.
|
|
541
186
|
|
|
542
187
|
## Contributing
|
|
543
188
|
|
|
544
189
|
Issues and pull requests both get an automated first pass: a GitHub App runs the `omp` agent headlessly
|
|
545
190
|
to triage a new issue and to review a pull request, and its verdict is published as a `review:*` label.
|
|
546
191
|
|
|
547
|
-
- [`CONTRIBUTING.md`](CONTRIBUTING.md) is the policy — the
|
|
548
|
-
|
|
549
|
-
- The command surface is `@<bot> help | review | summarize | triage | reproduce` as the first line of
|
|
550
|
-
comment. Run the **bot config check** workflow to print the name this repository answers to.
|
|
192
|
+
- [`CONTRIBUTING.md`](CONTRIBUTING.md) is the policy — the mandatory gates, the pull request sections
|
|
193
|
+
the reviewer checks, what counts as evidence, and the label a review moves through.
|
|
194
|
+
- The command surface is `@<bot> help | review | summarize | triage | reproduce` as the first line of
|
|
195
|
+
a comment. Run the **bot config check** workflow to print the name this repository answers to.
|
|
551
196
|
- Bugs go through the issue form; requests through the feature form. Design and scope stay the
|
|
552
|
-
maintainer's call, and `AGENTS.md`
|
|
197
|
+
maintainer's call, and [`AGENTS.md`](AGENTS.md) plus the wiki are the normative reference for the
|
|
198
|
+
code rules.
|
|
553
199
|
|
|
554
200
|
## License
|
|
555
201
|
|
package/dist/client/index.html
CHANGED
|
@@ -64,7 +64,7 @@
|
|
|
64
64
|
href="https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap"
|
|
65
65
|
/>
|
|
66
66
|
<!--app-head-->
|
|
67
|
-
<link rel="stylesheet" crossorigin href="./static/js/index-
|
|
67
|
+
<link rel="stylesheet" crossorigin href="./static/js/index-shexbk5f.css"><script type="module" crossorigin src="./static/js/index-0smc9gm2.js"></script></head>
|
|
68
68
|
<body>
|
|
69
69
|
<div id="app"></div>
|
|
70
70
|
<!--app-bootstrap-->
|