release-2.9.0 (#1532)

* fix(macos): skip single-instance lock in Mac App Store builds (#1454) fix(macos): skip single-instance lock in Mac App Store builds * Fix/backend optional sharp (#1455) Fix/backend optional sharp * feat: issue #1218 (#1218) https://github.com/Termix-SSH/Support/issues/1218 * feat: Add option to use saved global custom theme under Connection Defaults (#1209) https://github.com/Termix-SSH/Support/issues/1209 * feat: Add Fleet Sharing functionality to the UI (#1228) https://github.com/Termix-SSH/Support/issues/1228 * feat: Add a list view to the Docker management page (#1237) https://github.com/Termix-SSH/Support/issues/1237 * feat: issue #1264 (#1264) https://github.com/Termix-SSH/Support/issues/1264 * feat: 2FA With FortiToken (#1288) https://github.com/Termix-SSH/Support/issues/1288 * feat: Allow to disable showing paths to folders (#1274) https://github.com/Termix-SSH/Support/issues/1274 * feat: Sync Network Graph between Desktop and Remote Server (#1245) https://github.com/Termix-SSH/Support/issues/1245 * feat: Version Number on offline servers (#1291) https://github.com/Termix-SSH/Support/issues/1291 * feat: Support OrbStack Docker socket path on macOS / Fix "Docker is not installed" on mac... (#1302) https://github.com/Termix-SSH/Support/issues/1302 * feat: Sidebar host click should focus existing tab instead of opening a new connection (#1289) https://github.com/Termix-SSH/Support/issues/1289 * fix: Search in side bar shows overlapping hosts when grouped by tags (#1303) https://github.com/Termix-SSH/Support/issues/1303 * fix: I can't send a file on its own. (#1304) https://github.com/Termix-SSH/Support/issues/1304 * fix: sudo password not autofilling (#1248) https://github.com/Termix-SSH/Support/issues/1248 * fix: node-MainThread (#1300) https://github.com/Termix-SSH/Support/issues/1300 * fix: Tunnel authentication with shared credentials (#1295) https://github.com/Termix-SSH/Support/issues/1295 * fix: host key updates not syncing, metrics 404 race on first connect Host key writes never bumped updatedAt so sync never picked them up. Also retry the first metrics fetch briefly instead of failing right away. * chore: increment ver * feat: add category and icon fields to plugin manifest schema * ci(deps): bump the github-actions group with 2 updates (#1458) Bumps the github-actions group with 2 updates: [crowdin/github-action](https://github.com/crowdin/github-action) and [actions/github-script](https://github.com/actions/github-script). Updates `crowdin/github-action` from 2 to 3 - [Release notes](https://github.com/crowdin/github-action/releases) - [Commits](https://github.com/crowdin/github-action/compare/v2...v3) Updates `actions/github-script` from 7 to 9 - [Release notes](https://github.com/actions/github-script/releases) - [Commits](https://github.com/actions/github-script/compare/v7...v9) --- updated-dependencies: - dependency-name: crowdin/github-action dependency-version: '3' dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions - dependency-name: actions/github-script dependency-version: '9' dependency-type: direct:production update-type: version-update:semver-major dependency-group: github-actions ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * chore(deps-dev): bump the dev-patch-updates group with 13 updates (#1459) Bumps the dev-patch-updates group with 13 updates: | Package | From | To | | --- | --- | --- | | [@codemirror/commands](https://github.com/codemirror/commands) | `6.11.0` | `6.11.1` | | [@codemirror/search](https://github.com/codemirror/search) | `6.7.1` | `6.7.2` | | [@codemirror/view](https://github.com/codemirror/view) | `6.43.9` | `6.43.12` | | [@testing-library/dom](https://github.com/testing-library/dom-testing-library) | `10.4.1` | `10.4.2` | | [@testing-library/react](https://github.com/testing-library/react-testing-library) | `16.3.2` | `16.3.3` | | [@testing-library/user-event](https://github.com/testing-library/user-event) | `14.6.5` | `14.6.7` | | [@types/ssh2](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/ssh2) | `1.15.5` | `1.15.6` | | [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/tree/HEAD/packages/plugin-react) | `6.1.0` | `6.1.1` | | [cytoscape](https://github.com/cytoscape/cytoscape.js) | `3.34.1` | `3.34.3` | | [eslint-plugin-react-refresh](https://github.com/ArnaudBarre/eslint-plugin-react-refresh) | `0.5.4` | `0.5.7` | | [i18next](https://github.com/i18next/i18next) | `26.4.0` | `26.4.2` | | [prettier](https://github.com/prettier/prettier) | `3.9.6` | `3.9.8` | | [react-i18next](https://github.com/i18next/react-i18next) | `17.0.12` | `17.0.14` | Updates `@codemirror/commands` from 6.11.0 to 6.11.1 - [Changelog](https://github.com/codemirror/commands/blob/main/CHANGELOG.md) - [Commits](https://github.com/codemirror/commands/commits) Updates `@codemirror/search` from 6.7.1 to 6.7.2 - [Changelog](https://github.com/codemirror/search/blob/main/CHANGELOG.md) - [Commits](https://github.com/codemirror/search/commits) Updates `@codemirror/view` from 6.43.9 to 6.43.12 - [Changelog](https://github.com/codemirror/view/blob/main/CHANGELOG.md) - [Commits](https://github.com/codemirror/view/commits) Updates `@testing-library/dom` from 10.4.1 to 10.4.2 - [Release notes](https://github.com/testing-library/dom-testing-library/releases) - [Changelog](https://github.com/testing-library/dom-testing-library/blob/main/CHANGELOG.md) - [Commits](https://github.com/testing-library/dom-testing-library/compare/v10.4.1...v10.4.2) Updates `@testing-library/react` from 16.3.2 to 16.3.3 - [Release notes](https://github.com/testing-library/react-testing-library/releases) - [Changelog](https://github.com/testing-library/react-testing-library/blob/main/CHANGELOG.md) - [Commits](https://github.com/testing-library/react-testing-library/compare/v16.3.2...v16.3.3) Updates `@testing-library/user-event` from 14.6.5 to 14.6.7 - [Release notes](https://github.com/testing-library/user-event/releases) - [Changelog](https://github.com/testing-library/user-event/blob/main/CHANGELOG.md) - [Commits](https://github.com/testing-library/user-event/compare/v14.6.5...v14.6.7) Updates `@types/ssh2` from 1.15.5 to 1.15.6 - [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases) - [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/ssh2) Updates `@vitejs/plugin-react` from 6.1.0 to 6.1.1 - [Release notes](https://github.com/vitejs/vite-plugin-react/releases) - [Changelog](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/CHANGELOG.md) - [Commits](https://github.com/vitejs/vite-plugin-react/commits/plugin-react@6.1.1/packages/plugin-react) Updates `cytoscape` from 3.34.1 to 3.34.3 - [Release notes](https://github.com/cytoscape/cytoscape.js/releases) - [Commits](https://github.com/cytoscape/cytoscape.js/compare/v3.34.1...v3.34.3) Updates `eslint-plugin-react-refresh` from 0.5.4 to 0.5.7 - [Release notes](https://github.com/ArnaudBarre/eslint-plugin-react-refresh/releases) - [Changelog](https://github.com/ArnaudBarre/eslint-plugin-react-refresh/blob/main/CHANGELOG.md) - [Commits](https://github.com/ArnaudBarre/eslint-plugin-react-refresh/compare/v0.5.4...v0.5.7) Updates `i18next` from 26.4.0 to 26.4.2 - [Release notes](https://github.com/i18next/i18next/releases) - [Changelog](https://github.com/i18next/i18next/blob/master/CHANGELOG.md) - [Commits](https://github.com/i18next/i18next/compare/v26.4.0...v26.4.2) Updates `prettier` from 3.9.6 to 3.9.8 - [Release notes](https://github.com/prettier/prettier/releases) - [Changelog](https://github.com/prettier/prettier/blob/main/CHANGELOG.md) - [Commits](https://github.com/prettier/prettier/compare/3.9.6...3.9.8) Updates `react-i18next` from 17.0.12 to 17.0.14 - [Changelog](https://github.com/i18next/react-i18next/blob/master/CHANGELOG.md) - [Commits](https://github.com/i18next/react-i18next/compare/v17.0.12...v17.0.14) --- updated-dependencies: - dependency-name: "@codemirror/commands" dependency-version: 6.11.1 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: "@codemirror/search" dependency-version: 6.7.2 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: "@codemirror/view" dependency-version: 6.43.12 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: "@testing-library/dom" dependency-version: 10.4.2 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: "@testing-library/react" dependency-version: 16.3.3 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: "@testing-library/user-event" dependency-version: 14.6.7 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: "@types/ssh2" dependency-version: 1.15.6 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: "@vitejs/plugin-react" dependency-version: 6.1.1 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: cytoscape dependency-version: 3.34.3 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: eslint-plugin-react-refresh dependency-version: 0.5.7 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: i18next dependency-version: 26.4.2 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: prettier dependency-version: 3.9.8 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates - dependency-name: react-i18next dependency-version: 17.0.14 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev-patch-updates ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * chore(deps): bump the prod-patch-updates group with 6 updates (#1461) Bumps the prod-patch-updates group with 6 updates: | Package | From | To | | --- | --- | --- | | [@tanstack/react-virtual](https://github.com/TanStack/virtual/tree/HEAD/packages/react-virtual) | `3.14.10` | `3.14.13` | | [compression](https://github.com/expressjs/compression) | `1.8.1` | `1.8.2` | | [jose](https://github.com/panva/jose) | `6.2.9` | `6.2.12` | | [jszip](https://github.com/Stuk/jszip) | `3.10.1` | `3.10.2` | | [socks](https://github.com/JoshGlazebrook/socks) | `2.8.9` | `2.8.10` | | [undici](https://github.com/nodejs/undici) | `8.10.0` | `8.10.2` | Updates `@tanstack/react-virtual` from 3.14.10 to 3.14.13 - [Release notes](https://github.com/TanStack/virtual/releases) - [Changelog](https://github.com/TanStack/virtual/blob/main/packages/react-virtual/CHANGELOG.md) - [Commits](https://github.com/TanStack/virtual/commits/@tanstack/react-virtual@3.14.13/packages/react-virtual) Updates `compression` from 1.8.1 to 1.8.2 - [Release notes](https://github.com/expressjs/compression/releases) - [Changelog](https://github.com/expressjs/compression/blob/master/HISTORY.md) - [Commits](https://github.com/expressjs/compression/compare/v1.8.1...v1.8.2) Updates `jose` from 6.2.9 to 6.2.12 - [Release notes](https://github.com/panva/jose/releases) - [Changelog](https://github.com/panva/jose/blob/main/CHANGELOG.md) - [Commits](https://github.com/panva/jose/compare/v6.2.9...v6.2.12) Updates `jszip` from 3.10.1 to 3.10.2 - [Changelog](https://github.com/Stuk/jszip/blob/main/CHANGES.md) - [Commits](https://github.com/Stuk/jszip/compare/v3.10.1...v3.10.2) Updates `socks` from 2.8.9 to 2.8.10 - [Release notes](https://github.com/JoshGlazebrook/socks/releases) - [Commits](https://github.com/JoshGlazebrook/socks/compare/2.8.9...2.8.10) Updates `undici` from 8.10.0 to 8.10.2 - [Release notes](https://github.com/nodejs/undici/releases) - [Commits](https://github.com/nodejs/undici/compare/v8.10.0...v8.10.2) --- updated-dependencies: - dependency-name: "@tanstack/react-virtual" dependency-version: 3.14.13 dependency-type: direct:production update-type: version-update:semver-patch dependency-group: prod-patch-updates - dependency-name: compression dependency-version: 1.8.2 dependency-type: direct:production update-type: version-update:semver-patch dependency-group: prod-patch-updates - dependency-name: jose dependency-version: 6.2.12 dependency-type: direct:production update-type: version-update:semver-patch dependency-group: prod-patch-updates - dependency-name: jszip dependency-version: 3.10.2 dependency-type: direct:production update-type: version-update:semver-patch dependency-group: prod-patch-updates - dependency-name: socks dependency-version: 2.8.10 dependency-type: direct:production update-type: version-update:semver-patch dependency-group: prod-patch-updates - dependency-name: undici dependency-version: 8.10.2 dependency-type: direct:production update-type: version-update:semver-patch dependency-group: prod-patch-updates ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * feat: add plugin worker protocol, bootstrap and plugin_storage table Worker-side ctx proxy plus the message envelope it talks over, and the per-plugin key/value table behind ctx.storage with migrations for all three dialects. Rows cascade with the plugin so uninstalling leaves nothing behind. * feat: add allowlisted host view for plugins An allowlist rather than a list of fields to strip. A blocklist rots: the moment a new secret-bearing column lands on SSHHost it starts leaking silently. With an allowlist a new field stays invisible to plugins until someone adds it here on purpose. * feat: add plugin loader with manifest validation and crash restart Validates an unpacked plugin, spawns a worker_threads worker and manages activate/deactivate/crash-restart with backoff, disabling after three tries. The crash counter clears only after a plugin stays up past a stability window, not on activation. Clearing it on activation let a plugin that activates cleanly and then dies restart forever, because every attempt looked like the first. loader.ts documents what the worker boundary does and does not buy you. Node's permission model is process-wide, not per-worker, so it cannot be enabled for plugin workers alone and is not claimed here. * feat: route internal events through a shared plugin event bus Formalises three ad-hoc publish paths that already existed: automation-events.ts, metrics/automation-bridge.ts and the hostSessionStatus singleton, now the host.session.status topic. Both invariants the old code relied on are preserved. Publishing stays fire-and-forget, so a failing subscriber cannot disturb a metrics poll or a host delete. The automations engine subscribes to the bus at scheduler start instead of being imported ad hoc, which keeps the edge one-directional: automations may import repositories, hosts modules must not import automations. * feat: add plugin ctx broker with permission gate and audit Every ctx call a plugin makes is checked against its granted capabilities, performed by the main thread, then audited. A capability must be both declared in the manifest and granted in the database, so widening a plugin's reach always needs a new manifest the user can see, never just a database row. Audit attribution is set by the broker, not the plugin. The plugin supplies only the details, so it cannot forge the actor. fix: stop plugin workers seeing plaintext credentials in error messages A failing ctx.ssh.connect handed the worker the raw error from deep in the SSH stack, which embeds the connect config. The worker received, in full: Authentication failed for root using password <SECRET> where <SECRET> was the host's real plaintext password. Any plugin with ssh.exec could read it by catching the error, defeating the whole point of the handle-based ssh API. Errors crossing the boundary are now sanitised. Only PluginFacingError and PluginPermissionError, both authored here, reach a plugin verbatim; anything else becomes a generic message and the real one goes to the log. This uses a marker class rather than matching on message text, because matching would start leaking again the moment an upstream error happened to contain a familiar phrase. Covered by credential-isolation.test.ts, which plants a sentinel in every secret-bearing field and asserts it appears in no message the worker ever receives. * feat: dispatch plugin HTTP routes and wire the runtime into startup ctx.http.route now registers a real router on the /plugin-api/:pluginId dispatcher, replacing its stub 404. A plugin never touches the Express req/res: it gets a plain summary and returns a plain object, so sockets and session cookies stay on this side of the boundary. Authorization and cookie headers are not forwarded. Plugins load last in the start-up sequence, after the server is fully wired, and are terminated before the database on shutdown so none can outlive it. A plugin that fails to load cannot stop the backend. fix: correct the nginx plugin-api location regex The pattern was ^/plugin-api/(/.*)?$, which needs a double slash and so never matched /plugin-api/<id>/<route>. Every other block in the file uses ^/prefix(/.*)?$. Left alone, plugin routes would work in dev and 404 only behind Docker. * fix: update stale SFTP transfer test for single file destination paths The test still asserted transferToHost was called with the destination directory "/srv". Commit 7727fa09 (#1304) deliberately changed a single file transfer to send the full destination path including the filename, so the correct expectation is "/srv/remote-1.txt". The code was right and the test was left behind. * feat: ship the ssh terminal as a first-party in-process plugin Adds a hardcoded process:transport-owner tier so the terminal can own its WebSocket server and ssh2 clients, which cannot cross the worker boundary. * feat: ship docker as a first-party in-process plugin Moves docker backend and frontend into plugins/docker/, alongside ssh-terminal. Adds a host editor tab seam, a dashboard card registry, and a build step to compile plugin backends into dist. * feat: ship host metrics as a first-party in-process plugin * fix: harden plugin auth and add per-request identity for ctx calls Require auth on /plugin-api, gate plugin enable/grant/revoke routes behind admin.plugins.manage, and thread the calling user through worker ctx.hosts/ctx.ssh calls instead of always using the install owner. Also adds the plugin permissions grant/revoke UI. * feat: ship the AI assistant as a first-party in-process plugin Moves src/backend/ai and its routes into plugins/ai, mounted through a small /ai dispatcher instead of its own port. Moves the ai-enabled and ai-private-endpoints settings routes out of user-settings-routes.ts into the plugin too, so it has no leftover core dependents. * fix: remove compiled plugin JS left behind in plugins/ after build copy-bundled-plugins.cjs compiled and rewrote plugin backend TS in place, copied it to dist/plugins, but never deleted the .js it had just emitted next to the .ts sources. Those files shadowed the real source for vitest/tsx and had import paths rewritten for the dist layout, so tests failed with "Cannot find module" once a local build had run. Affects docker, host-metrics and ai, not just this one. * feat: add a permission-gated backend service registry for plugins * feat: add a permission-gated UI action registry and action slots for plugins Moves the terminal toolbar's hardwired AI button into a slot the ssh-terminal plugin offers and the ai plugin fills, gated on ai.services.use. * feat: add cross-plugin secret references gated by the provider's RBAC permission * feat: move proxmox discovery/import/sync into a first-party plugin * feat: move remote desktop (RDP/VNC/Telnet) into a first-party plugin Relocates guacamole backend/frontend source and tests into plugins/remote-desktop, following the ssh-terminal/docker pattern. * feat: wire remote-desktop plugin into core and rename i18n keys Repoints core consumers (dispatcher, collab, session-sharing, tab utils) at the plugin, adds isTabTypeAvailable gating for rdp/vnc/ telnet, widens hostCapability to accept an array, and renames the guacamole i18n namespace to remoteDesktop. * feat: move fleets into a first-party plugin * feat: move automations into a first-party plugin * feat: remove legacy alert rules, superseded by automations Alert rules already auto-migrate into automations on boot and the old engine stands down after. Deletes the rule/firing tables, routes, UI, and AI tools; keeps notification channels since automations still use them. Also fixes automations' notify step, which still called the deleted repository. * feat: move network topology into a first-party plugin * feat: move tailscale device discovery and settings into a plugin Adds plugins/tailscale/ with a devices sidebar tab, admin settings section, and re-auth dialog. Host Metrics tailscale manager card and SSH re-auth banner parsing stay in core. * feat: move workspaces into a first-party plugin * feat: move web endpoint into a first-party plugin * feat: collapse plugin runtime to one tier behind a plugin SDK * feat: make each plugin an npm workspace built by a termix-plugin CLI * feat: give plugins their own tables, migrations and sync entities * feat: serve plugin http and websockets from one mount instead of ports * feat: namespace plugin permissions and keep them valid when a plugin is off * feat: give plugins their own settings and one settings screen * feat: load plugin frontends at runtime and remove plugin ids from the shell * fix: mock the ai status fetch in its activate test * feat: add auth extension points and one ssh connect pipeline * feat: rebuild workspaces as the reference plugin * fix: gate second factors after SSO/LDAP behind an admin setting * feat: convert network-topology to a full plugin (B1) * feat: move snippets backend and tables into a plugin (B2) * feat: point core frontend snippets pickers at the plugin (B2) * feat: add the snippets plugin (B2) * feat: wire ai, automations, fleets and ssh-terminal to snippets (B2) * feat: finish the tailscale plugin, including SSH auth (B3) * feat: finish the fleets plugin, add ctx.hosts and host-commands SDK (B4) * chore: update proxmox and host-metrics locale files for B5 * chore: regenerate drizzle migration journals for B5 * feat: add ctx.hosts create/update to the SDK, host-metrics drops proxmox * feat: move proxmox node stats and collectors into the proxmox plugin * feat: drop proxmox host columns, use plugin settings instead * feat: finish the fleets plugin, add ctx.hosts and host-commands SDK (B4) * feat: convert file manager into a plugin * feat: convert ssh tunnels into a plugin * feat: finish the web-endpoint plugin, add ctx.desktop (B8) * feat: move the terminal fully into the ssh-terminal plugin (B9) * feat: convert tmux monitoring into a plugin (B10) * feat: convert serial console into the serial plugin * feat: move session sharing and collab rooms into a plugin (B12) * feat: turn session recording into a plugin (B13) * feat: finish the remote-desktop plugin (B14) * feat: finish the host-metrics plugin, move host status into core (B16) * feat: finish the docker plugin (B15) * feat: finish the automations plugin (B17) * feat: finish the ai plugin (B18) * feat: finish the homepage plugin, move service links and canvas out of core (B19) * feat: convert wake-on-lan into a plugin (B20) * feat: convert secret-sources into a plugin (B20) * feat: move totp and passkeys into plugins (C1) * feat: move sso and ldap logins into plugins (C2) * feat: move opkssh and warpgate into plugins (C3) * feat: move step-ca into a plugin (C4) * feat: move vault ssh signing into a plugin (C5) * feat: move termix identity into a plugin (C6) * feat: move acme certificate automation into a plugin (C7) * fix: finish 2.9.0 plugin moves and get every check green * chore: lock the plugin boundary and remove 2.9.0 leftovers * fix: harden the plugin runtime after the 2.9.0 security review * feat: add plugin packing, signing, pinned trust and tmxplug bundling * test: prove 2.8 to 2.9.0 upgrade is lossless and fix what it caught * fix: give bundled plugin backends a real require for CJS deps * feat: improve UI loading time and jitter * feat: show credential sharing inline in the sidebar like host sharing * feat: tailscale add host and copy ip, fix outbound fetch hang and plugin ESM warning * feat: unify alerts into one plugin, channels, rules and inbox * feat: rebuild desktop sync as linked server accounts, fix packaged plugin bundles and UI scaling * fix: set blacksmith builder cache-key to stop broken gha cache fallback * fix: link plugin-sdk workspace before npm ci in docker deps stage * fix: link every plugin workspace before npm ci in docker deps stage * fix(host-metrics): exclude image and firmware filesystems (#1469) * fix(host-metrics): exclude image and firmware filesystems * fix(ci): build plugin SDK before dependent checks * fix(mysql): keep plugin settings scope indexes within limits * test(mysql): refresh reviewed plugin upgrade SQL * fix(hosts): normalize imported jump host references (#1470) * fix(hosts): normalize imported jump host references * fix(ci): build plugin SDK before dependent checks * fix(mysql): keep plugin settings scope indexes within limits * test(mysql): refresh reviewed plugin upgrade SQL * fix(ci): build plugin SDK and repair MySQL settings migration (#1471) * fix(ci): build plugin SDK before dependent checks * fix(mysql): keep plugin settings scope indexes within limits * test(mysql): refresh reviewed plugin upgrade SQL * fix(file-manager): keep inline rename consistent (#1476) * fix(ci): build plugin SDK before dependent checks * fix(mysql): keep plugin settings scope indexes within limits * test(mysql): refresh reviewed plugin upgrade SQL * fix(file-manager): keep inline rename consistent * fix(dashboard): reuse translated host status labels (#1475) * fix(ci): build plugin SDK before dependent checks * fix(mysql): keep plugin settings scope indexes within limits * test(mysql): refresh reviewed plugin upgrade SQL * fix(dashboard): reuse translated host status labels * docs(api): clarify local and remote version fields (#1474) * fix(ci): build plugin SDK before dependent checks * fix(mysql): keep plugin settings scope indexes within limits * test(mysql): refresh reviewed plugin upgrade SQL * docs(api): clarify local and remote version fields * fix(file-manager): preserve selected backgrounds on hover (#1473) * fix(ci): build plugin SDK before dependent checks * fix(mysql): keep plugin settings scope indexes within limits * test(mysql): refresh reviewed plugin upgrade SQL * fix(file-manager): preserve selection feedback on hover * test(ui): await dialog focus cleanup before teardown * fix(file-manager): restore Ctrl/Cmd+F file search (#1472) * fix(ci): build plugin SDK before dependent checks * fix(mysql): keep plugin settings scope indexes within limits * test(mysql): refresh reviewed plugin upgrade SQL * fix(file-manager): focus file search with Ctrl or Cmd F * fix: keep rounded-full circular in production builds * fix(file-manager): cancel uploads and stop remote writes (#1477) * fix(file-manager): cancel uploads and stop remote writes * test(css): exercise the configured PostCSS plugin chain * fix(file-manager): apply compact density to directory tree (#1478) * fix(file-manager): apply compact density to directory tree * test(css): exercise the configured PostCSS plugin chain * fix(file-manager): preserve font sizes in compact mode (#1480) * fix(file-manager): preserve font sizes in compact mode * test(css): exercise the configured PostCSS plugin chain * fix(file-manager): prioritize file names in narrow lists (#1483) * fix(file-manager): prioritize file names in narrow lists * test(css): exercise the configured PostCSS plugin chain * test(identity): preserve full Ed25519 public keys in fixtures * test(remote-desktop): always mutate ciphertext in tamper test * fix(remote-desktop): probe the saved host guacd endpoint (#1481) * fix(remote-desktop): probe the saved host guacd endpoint * test(css): exercise the configured PostCSS plugin chain * test(identity): preserve full Ed25519 public keys in fixtures * fix(homepage): check allowlisted private service reachability (#1479) * fix(homepage): check allowlisted private service reachability * test(css): exercise the configured PostCSS plugin chain * fix(remote-desktop): stop unsolicited clipboard read prompts (#1482) * fix(remote-desktop): read clipboard only on explicit paste * test(css): exercise the configured PostCSS plugin chain * test(identity): preserve full Ed25519 public keys in fixtures * test(remote-desktop): always mutate ciphertext in tamper test * chore: simplify plugin readmes, changelogs and manifest descriptions * fix: keep plugins loaded after signing in from the login screen * fix(file-manager): accept OS file drops over existing rows (#1484) * fix(file-manager): accept OS file drops over existing rows * test(file-manager): target the file label in drop tests * test(css): exercise the configured PostCSS plugin chain * test(identity): preserve full Ed25519 public keys in fixtures * test(remote-desktop): always mutate ciphertext in tamper test * fix(file-manager): pipeline SFTP download reads (#1485) * feat: add plugin sdk build to beta release * fix: make link-store secret check immune to random base64 matches * fix(ldap): preserve the directory-provided bind DN (#1486) * fix: compute beta changes across dev branches and move the beta tag * chore: untrack plugin sdk ARCHITECTURE.md * chore: remove references to plugin sdk ARCHITECTURE.md * feat: merge host editor terminal tabs into one owned by ssh-terminal * feat: add descriptions to plugin host enable toggles * fix(file-manager): show download progress in file viewers (#1487) * fix(electron): signal backend readiness over IPC (#1488) * fix(split-screen): allow layout creation without randomUUID (#1490) * fix(split-screen): allow layout creation without randomUUID * test(credentials): avoid flaky Ed25519 key generation * fix(sidebar): remeasure visible rows after density changes (#1489) * fix(sidebar): remeasure visible rows after density changes * test(credentials): avoid flaky Ed25519 key generation * feat(split-screen): redesign split screen with free-form panes and pane picker * feat(sidebar): add host click behavior setting, default to always opening a new tab * feat(snippets): redesign panel to match the host list * fix(session-recording): stop session logs panel from refetching in a loop * feat(snippets): bring back sharing, target hosts and drag reorder * feat(ssh-terminal): add toolbar position, start state, display and fade host settings * feat(ssh-terminal): add host setting to turn off password prompt auto-fill * fix(ai): stop streams getting cut off and keep tool steps across messages * feat: improve quick connect system using plugin api * fix: proxmox guest sync, startup snippet sync, drop dead cloudflare ssh transport * feat: move terminal settings, look and ssh tools into ssh-terminal plugin * feat: move snippets, keybinding actions and macros out of core into plugins * feat: store rdp, vnc and telnet logins in a generic per-protocol table * feat: type the plugin host record, move plugin strings out of core and add lint checks * feat: replace core homepage widget registry with generic extension points * feat: plugins only see their own host settings in the browser * feat: harden plugin api for separate repos, signed updates and generic external login * fix: keep plugin css below core utilities and version plugin assets by their css * fix: load and save plugin host settings in the editor and tighten settings row spacing * feat: redesign user host defaults system * fix(remote-desktop): release held keys on focus loss (#1498) * fix(session-sharing): replace local presentation after takeover (#1500) * fix(file-manager): refresh disk usage with directory listing (#1503) * fix(ssh-terminal): preserve input order during local echo reconciliation (#1505) * feat(remote-desktop): expose display zoom controls for RDP (#1514) * fix(file-manager): restore text selection and copying in Markdown previews (#1518) * fix(sidebar): keep compact host addresses visible (#1524) * fix(hosts): preserve plugin settings when reopening the editor (#1499) * fix(ssh-terminal): close owner sockets when presentations unmount (#1501) * fix(session-sharing): synchronize shared SSH terminal dimensions (#1502) * fix(session-sharing): show participant presence in member terminals (#1504) * fix(ai): sync provider configuration and keys across linked devices (#1506) * feat(ssh-terminal): add a duplicate tab action (#1510) * feat(file-manager): allow disabling move-to-trash confirmation (#1511) * feat(file-manager): default to the remote login directory (#1512) * feat(homepage): synchronize canvas layouts across devices (#1515) * fix(shortcuts): prevent accidental double-Shift palette activation (#1519) * feat(tmux-monitor): add a unified multi-host view (#1520) * fix(electron): allow explicit quit with active connections (#1522) * feat: reconnect all disconnected terminal tabs (#1523) * fix(hosts): preserve recording and sharing settings in the dev editor (#1509) * fix(database): preserve RDP domain during startup backfill (#1497) * feat(sidebar): add keyboard type-ahead search for hosts (#1516) * feat(automations): add per-host maintenance mode and recurring schedules (#1521) * feat(tmux): add a per-host mouse toggle and preserve remote configuration (#1513) * fix(session-sharing): use the linked server for desktop meetings and links (#1507) * fix(tunnels): support TOTP for client tunnels and jump hosts (#1508) * fix: type errors and lint failures from merged plugin prs * feat(installer): make the Windows desktop shortcut optional (#1517) * fix: ship the plugin sdk and serialport in desktop builds * fix: prefer ipv4 when resolving ssh host names (#1365) * fix: readable terminal selection with the light theme (#1319) * fix: build desktop session share links on the linked server (#1350) * fix: show meeting guests to members and hide the roster from guests (#1353) * fix: reliable file manager saves with sudo prompt and no base64 guessing (#1335) * fix: show disk usage for the mount being browsed (#1347) * fix: load the linux tray icon reliably and log tray failures (#1332) * fix: cover the gnome close path in the desktop quit test (#1332) * fix: prompt for jump host TOTP in terminal, file manager and metrics (#1312) * feat: optional auto reconnect for dropped ssh sessions (#1321) * feat: tighter compact host rows with inline tags (#1325) * feat: bring back the alert feed homepage widget * feat: pick target terminals for snippets again * feat: share button on connection tabs again * feat: recent servers list when linking the desktop app * feat: list the fixed app shortcuts in keyboard shortcuts * fix: translate hardcoded toasts and drop em dashes from ui text * fix: translate leftover hardcoded ui text * fix: toolbar files button opens at the shell directory again * fix: show the remote desktop note under connection origin again * chore: openapi docs for host metrics manager routes * chore: openapi docs for undocumented routes and fix two broken doc blocks * fix: declare terminal.listSessions use for snippet targets * revert: drop the alert feed widget, the notification center replaces it * feat: restore the alert feed homepage widget * fix: quick connect fills the host address from plugin auth editors like tailscale * fix: docker container logs use the base background color * chore: fix dependabot alerts and apply safe npm upgrades * fix: proxmox stats tab reads its switch from plugin host settings * fix: count plugin ssh logins toward host status and stop showing reachable as a warning * fix: hide the built-in source pill in the host editor * fix: host status shows online when the port answers and only warns on a failed login * fix: drop the top border on the split layout menu * fix: host defaults tabs sit where the host editor puts them and skip plugins with nothing to default * fix: remote desktop auth method labels and notes for vnc and telnet * fix: add description to the web endpoint enable switch * fix: crowdin sync and pretranslate for plugin locales, run plugin tests on release * feat: move telemetry out of core into a usage statistics plugin * fix: recent activity card no longer cuts off host names early * fix: remove duplicate top border on split screen menu * fix: redesign session log player controls, fix tooltip overlap and drop dot separators * fix: file manager and sftp text showing raw i18n keys * fix: onboarding rerunning for existing users after upgrading * fix: fleet detail buttons overflowing the sidebar * fix: session log player scrolling off screen horizontally * fix: network graph lag when adding hosts and on every render * fix: maintenance index name, shared host read only view and badge polling * fix: meeting tabs, workspace tab merging, rail panels as tabs and general ui lag * chore: update release notes * fix: remote desktop tabs reconnecting on every tab switch * fix: build plugin sdk before linting in release workflow * chore: lint, format, and bump version to 2.9.0 * chore: skip crowdin pre-translate in release for now * chore: sync Crowdin translations for 2.9.0 --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: Koi <38512047+datlt4@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: ZacharyZcR <zacharyzcr1984@gmail.com>
2026-10-29 06:35:24 +00:00 · 2026-10-01 16:20:16 -05:00
1 parent 49fa488093
commit 3643e7af97
@@ -0,0 +1,34 @@
+import { describe, expect, it } from "vitest";
+import { toHostRecord } from "@/plugin-host/bridge";
+
+describe("toHostRecord", () => {
+  it("copies only the fields the SDK types", () => {
+    const record = toHostRecord({
+      id: 7,
+      name: "web",
+      ip: "10.0.0.7",
+      port: 22,
+      username: "root",
+      parentHostId: 3,
+      jumpHosts: [{ hostId: 2 }],
+      pluginSettings: { docker: { enableDocker: true } },
+      authOverrides: { ssh: { required: true, ownerAuthShared: false } },
+      password: "secret",
+      terminalConfig: { fontSize: 14 },
+      enableDocker: true,
+    } as never);
+
+    expect(record).toMatchObject({
+      id: "7",
+      name: "web",
+      parentHostId: "3",
+      jumpHosts: [{ hostId: 2 }],
+      pluginSettings: { docker: { enableDocker: true } },
+      authOverrides: { ssh: { required: true, ownerAuthShared: false } },
+    });
+    const loose = record as unknown as Record<string, unknown>;
+    expect(loose).not.toHaveProperty("password");
+    expect(loose).not.toHaveProperty("terminalConfig");
+    expect(loose).not.toHaveProperty("enableDocker");
+  });
+});
@@ -0,0 +1,140 @@
+/**
+ * Every built plugin frontend in dist/plugins imports through the real loader
+ * and runs activate(app) without an error. Needs `npm run build` first.
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
+import type { FrontendModule } from "@termix/plugin-sdk/frontend";
+import type { PluginSummary } from "@/api/plugins-api";
+import {
+  configurePluginLoader,
+  resetPluginLoader,
+  syncPlugins,
+} from "@/plugin-host/loader";
+import { getPluginRecord } from "@/plugin-host/plugin-store";
+
+const REPO_ROOT = path.resolve(__dirname, "../../../..");
+const BUILT = path.join(REPO_ROOT, "dist", "plugins");
+
+function pluginIds(): string[] {
+  const root = path.join(REPO_ROOT, "plugins");
+  return fs
+    .readdirSync(root, { withFileTypes: true })
+    .filter(
+      (entry) =>
+        entry.isDirectory() &&
+        fs.existsSync(path.join(root, entry.name, "manifest.json")),
+    )
+    .map((entry) => entry.name)
+    .sort();
+}
+
+function manifest(id: string) {
+  return JSON.parse(
+    fs.readFileSync(path.join(BUILT, id, "manifest.json"), "utf8"),
+  ) as {
+    id: string;
+    name: string;
+    version: string;
+    icon?: string;
+    dependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+    contributes?: PluginSummary["contributes"];
+  };
+}
+
+function frontendFile(id: string): string {
+  return path.join(BUILT, id, "dist", "frontend.js");
+}
+
+/** What GET /plugins would answer for a running, enabled plugin. */
+function summaryFor(id: string): PluginSummary {
+  const m = manifest(id);
+  return {
+    id,
+    name: m.name,
+    version: m.version,
+    enabled: true,
+    state: "active",
+    contributes: m.contributes ?? null,
+    icon: m.icon,
+    dependencies: m.dependencies ?? {},
+    optionalDependencies: m.optionalDependencies ?? {},
+    frontend: fs.existsSync(frontendFile(id)),
+    assetVersion: "test",
+    locales: ["en"],
+  };
+}
+
+const errors: unknown[][] = [];
+
+beforeAll(async () => {
+  const missing = pluginIds().filter(
+    (id) => !fs.existsSync(path.join(BUILT, id, "manifest.json")),
+  );
+  if (missing.length > 0) {
+    throw new Error(
+      `dist/plugins is missing ${missing.join(", ")}. Run npm run build first.`,
+    );
+  }
+
+  // Nothing here talks to a server; a plugin that fetches on activate gets
+  // an empty answer rather than a network error.
+  vi.stubGlobal(
+    "fetch",
+    vi.fn(async () => new Response("{}", { status: 200 })),
+  );
+  vi.spyOn(console, "error").mockImplementation((...args) => {
+    errors.push(args);
+  });
+
+  configurePluginLoader({
+    fetchPlugins: async () => pluginIds().map(summaryFor),
+    importFrontend: async (summary) =>
+      (await import(
+        /* @vite-ignore */ pathToFileURL(frontendFile(summary.id)).href
+      )) as FrontendModule,
+    loadLocale: async (summary, file) => {
+      if (file !== "en") return null;
+      const locale = path.join(BUILT, summary.id, "locales", "en.json");
+      return fs.existsSync(locale)
+        ? JSON.parse(fs.readFileSync(locale, "utf8"))
+        : null;
+    },
+    injectCss: () => null,
+  });
+
+  await syncPlugins();
+}, 180_000);
+
+afterAll(async () => {
+  await resetPluginLoader();
+  vi.unstubAllGlobals();
+  vi.restoreAllMocks();
+});
+
+describe("built plugin frontends", () => {
+  it("activates every plugin that ships a frontend", () => {
+    const notActive = pluginIds()
+      .filter((id) => fs.existsSync(frontendFile(id)))
+      .map((id) => [
+        id,
+        getPluginRecord(id)?.frontend,
+        getPluginRecord(id)?.error,
+      ])
+      .filter(([, state]) => state !== "active");
+    expect(notActive).toEqual([]);
+  });
+
+  it("logs no error while importing and activating them", () => {
+    // Axios has no server to reach here; a failed request is the test
+    // environment, not the plugin.
+    const real = errors
+      .map((args) => args.map(String).join(" "))
+      .filter((line) => !/Network Error/.test(line));
+    expect(real).toEqual([]);
+  });
+});
@@ -0,0 +1,70 @@
+/**
+ * A bundle built by the termix-plugin CLI, loaded the way the shell loads it,
+ * renders hooks against the shell's own React.
+ *
+ * The CLI leaves react, react/jsx-runtime and the SDK as bare imports; in the
+ * browser the import map resolves them to the shell's copies. Here the test
+ * runner resolves them to the same modules the test itself uses, so a hook
+ * call only works if the bundle really did leave React out. A bundled second
+ * React fails with "Invalid hook call".
+ */
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { fireEvent } from "@testing-library/react";
+import {
+  renderWithApp,
+  type FrontendPluginModule,
+  type RenderedPluginApp,
+} from "@termix/plugin-sdk/testing";
+import { resetPanels } from "@/shell/panel-registry";
+import { resetPluginStore } from "@/plugin-host/plugin-store";
+
+const ROOT = path.resolve(__dirname, "../../../..");
+const FIXTURE = path.join(__dirname, "fixtures", "hook-plugin");
+// Inside the repo, so the built bundle's bare imports resolve to its packages.
+const WORK = path.join(ROOT, "node_modules", ".tmp", "cli-bundle-test");
+const CLI = path.join(ROOT, "packages", "plugin-sdk", "cli", "index.mjs");
+
+let bundle = "";
+let rendered: RenderedPluginApp | null = null;
+
+beforeAll(() => {
+  fs.rmSync(WORK, { recursive: true, force: true });
+  fs.mkdirSync(path.dirname(WORK), { recursive: true });
+  fs.cpSync(FIXTURE, WORK, { recursive: true });
+  execFileSync(process.execPath, [CLI, "build"], { cwd: WORK, stdio: "pipe" });
+  bundle = fs.readFileSync(path.join(WORK, "dist", "frontend.js"), "utf8");
+}, 60_000);
+
+afterAll(async () => {
+  await rendered?.deactivate();
+  resetPanels();
+  resetPluginStore();
+  fs.rmSync(WORK, { recursive: true, force: true });
+});
+
+describe("a CLI-built plugin bundle", () => {
+  it("leaves React and the SDK out of the bundle", () => {
+    expect(bundle).toMatch(/from\s*"react"/);
+    expect(bundle).toMatch(/from\s*"@termix\/plugin-sdk\/frontend"/);
+    expect(bundle).not.toMatch(/react\.production|react\.development/);
+  });
+
+  it("renders hooks against the shell's React", async () => {
+    const module = (await import(
+      /* @vite-ignore */ path.join(WORK, "dist", "frontend.js")
+    )) as FrontendPluginModule;
+    rendered = await renderWithApp(module, {
+      manifest: JSON.parse(
+        fs.readFileSync(path.join(WORK, "manifest.json"), "utf8"),
+      ),
+      locales: { title: "Clicks" },
+    });
+    const button = rendered.renderPanel("hook-panel").querySelector("button")!;
+    expect(button.textContent).toBe("Clicks: 0");
+    fireEvent.click(button);
+    expect(button.textContent).toBe("Clicks: 1");
+  });
+});
@@ -0,0 +1,14 @@
+{
+  "id": "hook-fixture",
+  "name": "Hook fixture",
+  "version": "1.0.0",
+  "description": "Built by the CLI in a test to prove a bundle shares the shell's React.",
+  "author": { "name": "Termix" },
+  "license": "MIT",
+  "category": "Productivity",
+  "engine": { "termix": ">=2.9.0", "api": "1" },
+  "capabilities": ["ui:surface"],
+  "contributes": {
+    "panels": [{ "id": "hook-panel", "titleKey": "title" }]
+  }
+}
@@ -0,0 +1 @@
+export function activate(): void {}
@@ -0,0 +1,16 @@
+import { useState } from "react";
+import { useTranslation, type TermixApp } from "@termix/plugin-sdk/frontend";
+
+function Counter() {
+  const { t } = useTranslation();
+  const [count, setCount] = useState(0);
+  return (
+    <button type="button" onClick={() => setCount(count + 1)}>
+      {t("title")}: {count}
+    </button>
+  );
+}
+
+export function activate(app: TermixApp): void {
+  app.registerPanel("hook-panel", Counter);
+}
@@ -0,0 +1,209 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { screen } from "@testing-library/react";
+import { Puzzle } from "lucide-react";
+import {
+  invokeAction,
+  useHost,
+  type PluginHostRecord,
+  type TermixApp,
+} from "@termix/plugin-sdk/frontend";
+import {
+  renderWithApp,
+  type RenderedPluginApp,
+} from "@termix/plugin-sdk/testing";
+import type { PluginManifest } from "@termix/plugin-sdk/manifest";
+import {
+  scopeHost,
+  scopeHostArgs,
+  scopeHostFields,
+} from "@/plugin-host/host-scope";
+import { setShellHosts, withShellHost } from "@/plugin-host/shell-bridge";
+import { resetActionRegistry } from "@/shell/action-registry";
+import { resetHostContributions } from "@/sidebar/host-contributions";
+import { resetPanels } from "@/shell/panel-registry";
+import { resetTabTypes } from "@/shell/tab-registry";
+import { resetRegisteredRailItems } from "@/sidebar/rail-items";
+import { resetPluginStore } from "@/plugin-host/plugin-store";
+import type { Host } from "@/types/ui-types";
+
+const SETTINGS = {
+  fixture: { enableFixture: true },
+  other: { secretKnob: "hands off" },
+};
+
+const saved = {
+  id: "7",
+  name: "web-01",
+  ip: "10.0.0.7",
+  port: 22,
+  pluginSettings: SETTINGS,
+} as unknown as Host;
+
+afterEach(() => {
+  setShellHosts([]);
+});
+
+describe("scopeHost", () => {
+  it("keeps only the plugin's own settings", () => {
+    const scoped = scopeHost(saved, "fixture");
+    expect(scoped.pluginSettings).toEqual({ fixture: SETTINGS.fixture });
+    expect(scoped.name).toBe("web-01");
+    expect(saved.pluginSettings).toEqual(SETTINGS);
+  });
+
+  it("gives a plugin with no settings on the host an empty bag", () => {
+    expect(scopeHost(saved, "nobody").pluginSettings).toEqual({});
+  });
+
+  it("re-reads a host another plugin handed over from the shell's copy", () => {
+    setShellHosts([saved]);
+    const fromOther = scopeHost({ ...saved }, "other");
+    expect(fromOther.pluginSettings).toEqual({ other: SETTINGS.other });
+    expect(scopeHost(fromOther, "fixture").pluginSettings).toEqual({
+      fixture: SETTINGS.fixture,
+    });
+  });
+
+  it("returns the same object for the same host, so effects stay put", () => {
+    expect(scopeHost(saved, "fixture")).toBe(scopeHost(saved, "fixture"));
+    expect(scopeHost(saved, "fixture")).not.toBe(scopeHost(saved, "other"));
+  });
+
+  it("passes anything that is not a host through untouched", () => {
+    const shellApi = { openTab: () => {} };
+    expect(scopeHost(shellApi, "fixture")).toBe(shellApi);
+    expect(scopeHost("7", "fixture")).toBe("7");
+    expect(scopeHost(null, "fixture")).toBeNull();
+    const list = [saved];
+    expect(scopeHostFields(list, "fixture")).toBe(list);
+  });
+
+  it("scopes host fields of props and request objects", () => {
+    const props = { host: saved, sshHost: saved, hostConfig: saved, n: 1 };
+    const scoped = scopeHostFields(props, "fixture");
+    expect(scoped.host.pluginSettings).toEqual({ fixture: SETTINGS.fixture });
+    expect(scoped.sshHost.pluginSettings).toEqual({
+      fixture: SETTINGS.fixture,
+    });
+    expect(scoped.hostConfig.pluginSettings).toEqual({
+      fixture: SETTINGS.fixture,
+    });
+    expect(scoped.n).toBe(1);
+    const noHost = { appTheme: "dark" };
+    expect(scopeHostFields(noHost, "fixture")).toBe(noHost);
+    const [request] = scopeHostArgs([{ host: saved, appTheme: "dark" }], "x");
+    expect((request as { host: Host }).host.pluginSettings).toEqual({});
+  });
+
+  it("lets a tab opened from a plugin's host keep every plugin's settings", () => {
+    setShellHosts([saved]);
+    const merged = withShellHost(scopeHost(saved, "other"));
+    expect(merged?.pluginSettings).toEqual(SETTINGS);
+  });
+});
+
+const MANIFEST: Partial<PluginManifest> = {
+  id: "fixture",
+  name: "Fixture",
+  contributes: {
+    tabs: [
+      { id: "fixture-tab", titleKey: "title", icon: "Puzzle", openFrom: [] },
+    ],
+    panels: [{ id: "fixture-panel", titleKey: "title" }],
+  },
+};
+
+let seen: Record<string, unknown> = {};
+
+function HostProbe() {
+  const host = useHost("7");
+  return <span>{JSON.stringify(host?.pluginSettings ?? null)}</span>;
+}
+
+function activate(app: TermixApp) {
+  app.registerPanel("fixture-panel", HostProbe);
+  app.registerTab("fixture-tab", ({ host }) => (
+    <span>{JSON.stringify(host?.pluginSettings ?? null)}</span>
+  ));
+  app.registerHostAction({
+    id: "fixture-open",
+    titleKey: "title",
+    icon: Puzzle,
+    kind: "open",
+    when: (host) => {
+      seen.when = host.pluginSettings;
+      return true;
+    },
+  });
+  app.registerAction("fixture.inspect", ((
+    host: PluginHostRecord,
+    request: { host: PluginHostRecord },
+  ) => {
+    seen.action = host.pluginSettings;
+    seen.request = request.host.pluginSettings;
+  }) as never);
+}
+
+let rendered: RenderedPluginApp | null = null;
+
+async function mount() {
+  rendered = await renderWithApp(
+    { activate },
+    {
+      manifest: MANIFEST,
+      locales: { title: "Fixture" },
+      hosts: [saved as unknown as Record<string, unknown>],
+    },
+  );
+  return rendered;
+}
+
+describe("host settings a plugin sees", () => {
+  afterEach(async () => {
+    await rendered?.deactivate();
+    rendered = null;
+    seen = {};
+    resetActionRegistry();
+    resetHostContributions();
+    resetPanels();
+    resetTabTypes();
+    resetRegisteredRailItems();
+    resetPluginStore();
+  });
+
+  const own = JSON.stringify({ fixture: SETTINGS.fixture });
+
+  it("useHost carries only the plugin's own settings", async () => {
+    const app = await mount();
+    app.renderPanel("fixture-panel");
+    expect(await screen.findByText(own)).toBeTruthy();
+  });
+
+  it("a tab's host prop carries only the plugin's own settings", async () => {
+    const app = await mount();
+    app.renderTab("fixture-tab", { host: saved });
+    expect(await screen.findByText(own)).toBeTruthy();
+  });
+
+  it("app.getHost is scoped too", async () => {
+    const { app } = await mount();
+    expect(app.getHost(7)?.pluginSettings).toEqual({
+      fixture: SETTINGS.fixture,
+    });
+    expect(app.getHost(99)).toBeUndefined();
+  });
+
+  it("host action callbacks get the plugin's slice", async () => {
+    const app = await mount();
+    app.registered.hostActionsFor(saved);
+    expect(seen.when).toEqual({ fixture: SETTINGS.fixture });
+  });
+
+  it("an action handler gets a host another plugin passed, re-read for it", async () => {
+    await mount();
+    const fromOther = scopeHost(saved, "other");
+    await invokeAction("fixture.inspect", fromOther, { host: fromOther });
+    expect(seen.action).toEqual({ fixture: SETTINGS.fixture });
+    expect(seen.request).toEqual({ fixture: SETTINGS.fixture });
+  });
+});
@@ -0,0 +1,340 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { Puzzle } from "lucide-react";
+import type { FrontendModule, TermixApp } from "@termix/plugin-sdk/frontend";
+import type { PluginSummary } from "@/api/plugins-api";
+import {
+  configurePluginLoader,
+  isPluginFrontendActive,
+  orderForActivation,
+  resetPluginLoader,
+  startPluginRuntime,
+  startPreLoginPlugins,
+  syncPlugins,
+} from "@/plugin-host/loader";
+import {
+  getPluginRecord,
+  getPluginStoreState,
+  resetPluginStore,
+} from "@/plugin-host/plugin-store";
+import {
+  resetRegisteredRailItems,
+  visibleRailItems,
+} from "@/sidebar/rail-items";
+import { getTabType, resetTabTypes } from "@/shell/tab-registry";
+
+function summary(
+  id: string,
+  overrides: Partial<PluginSummary> = {},
+): PluginSummary {
+  return {
+    id,
+    name: id,
+    version: "1.0.0",
+    enabled: true,
+    state: "active",
+    frontend: true,
+    assetVersion: "v1",
+    contributes: { panels: [{ id: `${id}-panel`, titleKey: "nav.hosts" }] },
+    ...overrides,
+  };
+}
+
+/** A plugin that registers a rail item named after itself. */
+function railPlugin(id: string, calls: string[] = []): FrontendModule {
+  return {
+    activate(app: TermixApp) {
+      calls.push(`activate:${id}`);
+      app.registerRailItem({
+        id: `${id}-panel`,
+        icon: Puzzle,
+        titleKey: "nav.hosts",
+      });
+    },
+    deactivate() {
+      calls.push(`deactivate:${id}`);
+    },
+  };
+}
+
+function railIds(): string[] {
+  return visibleRailItems().map((item) => item.id);
+}
+
+let plugins: PluginSummary[] = [];
+let modules: Record<string, FrontendModule> = {};
+
+beforeEach(() => {
+  plugins = [];
+  modules = {};
+  configurePluginLoader({
+    fetchPlugins: async () => plugins,
+    importFrontend: async (entry) => {
+      const module = modules[entry.id];
+      if (!module) throw new Error(`no module for ${entry.id}`);
+      return module;
+    },
+    loadLocale: async () => null,
+    injectCss: () => null,
+  });
+});
+
+afterEach(async () => {
+  await resetPluginLoader();
+  resetPluginStore();
+  resetRegisteredRailItems();
+  resetTabTypes();
+  vi.restoreAllMocks();
+});
+
+describe("plugin loader", () => {
+  it("activates an enabled plugin and deactivates it when disabled, without a reload", async () => {
+    const calls: string[] = [];
+    modules.alpha = railPlugin("alpha", calls);
+    plugins = [summary("alpha")];
+
+    await syncPlugins();
+    expect(railIds()).toContain("alpha-panel");
+    expect(isPluginFrontendActive("alpha")).toBe(true);
+
+    plugins = [summary("alpha", { enabled: false })];
+    await syncPlugins();
+    expect(railIds()).not.toContain("alpha-panel");
+    expect(calls).toEqual(["activate:alpha", "deactivate:alpha"]);
+    expect(getPluginRecord("alpha")?.frontend).toBe("inactive");
+  });
+
+  it("re-activates the same module after disable then enable", async () => {
+    const calls: string[] = [];
+    modules.alpha = railPlugin("alpha", calls);
+
+    plugins = [summary("alpha")];
+    await syncPlugins();
+    plugins = [summary("alpha", { enabled: false })];
+    await syncPlugins();
+    plugins = [summary("alpha")];
+    await syncPlugins();
+
+    expect(railIds()).toContain("alpha-panel");
+    expect(calls).toEqual([
+      "activate:alpha",
+      "deactivate:alpha",
+      "activate:alpha",
+    ]);
+  });
+
+  it("disposes registrations even when deactivate throws", async () => {
+    modules.alpha = {
+      activate: railPlugin("alpha").activate,
+      deactivate: () => {
+        throw new Error("boom");
+      },
+    };
+    vi.spyOn(console, "error").mockImplementation(() => {});
+    plugins = [summary("alpha")];
+    await syncPlugins();
+    plugins = [];
+    await syncPlugins();
+    expect(railIds()).not.toContain("alpha-panel");
+  });
+
+  it("isolates a plugin whose activate throws", async () => {
+    vi.spyOn(console, "error").mockImplementation(() => {});
+    modules.broken = {
+      activate(app) {
+        app.registerRailItem({
+          id: "broken-panel",
+          icon: Puzzle,
+          titleKey: "nav.hosts",
+        });
+        throw new Error("activate failed");
+      },
+    };
+    modules.healthy = railPlugin("healthy");
+    plugins = [summary("broken"), summary("healthy")];
+
+    await syncPlugins();
+
+    expect(getPluginRecord("broken")?.frontend).toBe("failed");
+    expect(getPluginRecord("broken")?.error).toBe("activate failed");
+    // What it registered before throwing is cleaned up.
+    expect(railIds()).not.toContain("broken-panel");
+    expect(railIds()).toContain("healthy-panel");
+  });
+
+  it("marks a plugin failed when its bundle cannot be imported", async () => {
+    vi.spyOn(console, "error").mockImplementation(() => {});
+    plugins = [summary("missing")];
+    await syncPlugins();
+    expect(getPluginRecord("missing")?.frontend).toBe("failed");
+  });
+
+  it("does not retry the same broken bundle, but does a new one", async () => {
+    vi.spyOn(console, "error").mockImplementation(() => {});
+    const activate = vi.fn(() => {
+      throw new Error("nope");
+    });
+    modules.flaky = { activate };
+    plugins = [summary("flaky")];
+    await syncPlugins();
+    await syncPlugins();
+    expect(activate).toHaveBeenCalledTimes(1);
+
+    modules.flaky = railPlugin("flaky");
+    plugins = [summary("flaky", { assetVersion: "v2" })];
+    await syncPlugins();
+    expect(getPluginRecord("flaky")?.frontend).toBe("active");
+  });
+
+  it("refuses to register a view the manifest does not declare", async () => {
+    vi.spyOn(console, "error").mockImplementation(() => {});
+    modules.sneaky = {
+      activate(app) {
+        app.registerTab("undeclared", () => null);
+      },
+    };
+    plugins = [summary("sneaky")];
+    await syncPlugins();
+    expect(getTabType("undeclared")).toBeUndefined();
+    expect(getPluginRecord("sneaky")?.error).toMatch(/not declared/);
+  });
+
+  it("skips server-failed and frontend-less plugins", async () => {
+    modules.down = railPlugin("down");
+    modules.headless = railPlugin("headless");
+    plugins = [
+      summary("down", { state: "failed" }),
+      summary("headless", { frontend: false }),
+    ];
+    await syncPlugins();
+    expect(railIds()).not.toContain("down-panel");
+    expect(railIds()).not.toContain("headless-panel");
+  });
+
+  it("keeps every plugin when the pre-login list lands after sign-in", async () => {
+    modules.login = railPlugin("login");
+    modules.alpha = railPlugin("alpha");
+    plugins = [summary("login"), summary("alpha")];
+
+    let releasePreLogin: (value: Response) => void = () => {};
+    vi.spyOn(globalThis, "fetch").mockImplementation(
+      () =>
+        new Promise<Response>((resolve) => {
+          releasePreLogin = resolve;
+        }),
+    );
+
+    const preLogin = startPreLoginPlugins();
+    await startPluginRuntime();
+    releasePreLogin(new Response(JSON.stringify([summary("login")])));
+    await preLogin;
+
+    expect(isPluginFrontendActive("login")).toBe(true);
+    expect(isPluginFrontendActive("alpha")).toBe(true);
+  });
+
+  it("ignores a pre-login load started after sign-in", async () => {
+    modules.login = railPlugin("login");
+    modules.alpha = railPlugin("alpha");
+    plugins = [summary("login"), summary("alpha")];
+    vi.spyOn(globalThis, "fetch").mockImplementation(
+      async () => new Response(JSON.stringify([summary("login")])),
+    );
+
+    await startPluginRuntime();
+    await startPreLoginPlugins();
+
+    expect(isPluginFrontendActive("alpha")).toBe(true);
+  });
+
+  it("settles even when the plugin list cannot be fetched", async () => {
+    vi.spyOn(console, "error").mockImplementation(() => {});
+    configurePluginLoader({
+      fetchPlugins: async () => {
+        throw new Error("offline");
+      },
+    });
+    await syncPlugins();
+    expect(getPluginStoreState().settled).toBe(true);
+  });
+});
+
+describe("activation order", () => {
+  it("activates a dependency before its dependent", async () => {
+    const calls: string[] = [];
+    modules.child = railPlugin("child", calls);
+    modules.parent = railPlugin("parent", calls);
+    plugins = [
+      summary("child", { dependencies: { parent: "^1.0.0" } }),
+      summary("parent"),
+    ];
+    await syncPlugins();
+    expect(calls).toEqual(["activate:parent", "activate:child"]);
+  });
+
+  it("blocks a plugin whose hard dependency is off", async () => {
+    modules.child = railPlugin("child");
+    plugins = [
+      summary("child", { dependencies: { parent: "^1.0.0" } }),
+      summary("parent", { enabled: false }),
+    ];
+    await syncPlugins();
+    expect(getPluginRecord("child")?.frontend).toBe("blocked");
+    expect(railIds()).not.toContain("child-panel");
+  });
+
+  it("runs without an optional dependency", () => {
+    const { order, blocked } = orderForActivation([
+      summary("child", { optionalDependencies: { gone: "^1.0.0" } }),
+    ]);
+    expect(order.map((entry) => entry.id)).toEqual(["child"]);
+    expect(blocked.size).toBe(0);
+  });
+
+  it("blocks both sides of a dependency cycle", () => {
+    const { order, blocked } = orderForActivation([
+      summary("a", { dependencies: { b: "*" } }),
+      summary("b", { dependencies: { a: "*" } }),
+    ]);
+    expect(order).toEqual([]);
+    expect([...blocked.keys()].sort()).toEqual(["a", "b"]);
+  });
+
+  it("activates independent plugins concurrently rather than one at a time", async () => {
+    modules.alpha = railPlugin("alpha");
+    modules.beta = railPlugin("beta");
+    plugins = [summary("alpha"), summary("beta")];
+
+    // Each import blocks until the other has started, which only resolves
+    // if both imports were kicked off before either finished.
+    let releaseAlpha: () => void;
+    let releaseBeta: () => void;
+    const alphaStarted = new Promise<void>((resolve) => {
+      releaseAlpha = resolve;
+    });
+    const betaStarted = new Promise<void>((resolve) => {
+      releaseBeta = resolve;
+    });
+    configurePluginLoader({
+      fetchPlugins: async () => plugins,
+      importFrontend: async (entry) => {
+        if (entry.id === "alpha") {
+          releaseAlpha!();
+          await betaStarted;
+        } else if (entry.id === "beta") {
+          releaseBeta!();
+          await alphaStarted;
+        }
+        const module = modules[entry.id];
+        if (!module) throw new Error(`no module for ${entry.id}`);
+        return module;
+      },
+      loadLocale: async () => null,
+      injectCss: () => null,
+    });
+
+    await syncPlugins();
+
+    expect(railIds()).toContain("alpha-panel");
+    expect(railIds()).toContain("beta-panel");
+  });
+});
@@ -0,0 +1,363 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { useState } from "react";
+import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { Puzzle } from "lucide-react";
+import {
+  getExtension,
+  useActivityTypes,
+  useExtensions,
+  useHostActions,
+  usePermission,
+  useTranslation,
+  type TermixApp,
+} from "@termix/plugin-sdk/frontend";
+import {
+  renderWithApp,
+  type RenderedPluginApp,
+} from "@termix/plugin-sdk/testing";
+import type { PluginManifest } from "@termix/plugin-sdk/manifest";
+import { NavigationVisibilityToggles } from "@/sidebar/NavigationVisibilityToggles";
+import {
+  hostActionsFor,
+  listHostActions,
+  defaultConnectAction,
+  resetHostContributions,
+} from "@/sidebar/host-contributions";
+import { resolveHostTabType } from "@/lib/host-connection-tabs";
+import {
+  makeHostSshSubTabs,
+  makeHostTabs,
+  resetHostEditorSections,
+} from "@/sidebar/HostManagerTabs";
+import {
+  listPaletteEntries,
+  paletteEntriesFor,
+  resetPaletteEntries,
+} from "@/shell/palette-registry";
+import { shell } from "@/plugin-host/shell-bridge";
+import { resetRegisteredRailItems } from "@/sidebar/rail-items";
+import { resetTabTypes } from "@/shell/tab-registry";
+import { resetPanels } from "@/shell/panel-registry";
+import { resetDashboardCards } from "@/dashboard/dashboard-cards-registry";
+import { resetExtensions } from "@/plugin-host/extension-registry";
+import { resetSettingsComponents } from "@/settings/settings-components";
+import { resetActionRegistry } from "@/shell/action-registry";
+import { resetPluginStore } from "@/plugin-host/plugin-store";
+import { SettingsFieldRow } from "@/settings/SettingsFields";
+import type { Host } from "@/types/ui-types";
+
+const MANIFEST: Partial<PluginManifest> = {
+  id: "fixture",
+  name: "Fixture",
+  contributes: {
+    tabs: [
+      {
+        id: "fixture-tab",
+        titleKey: "title",
+        icon: "Puzzle",
+        openFrom: ["rail"],
+      },
+    ],
+    panels: [{ id: "fixture-panel", titleKey: "title" }],
+    dashboardCards: [{ id: "fixture-card", titleKey: "title" }],
+    permissions: [{ name: "use", titleKey: "title", descriptionKey: "title" }],
+  },
+};
+
+const LOCALES = { title: "Fixture title", greeting: "Hello from fixture" };
+
+function Counter() {
+  const { t } = useTranslation();
+  const [count, setCount] = useState(0);
+  return (
+    <button type="button" onClick={() => setCount(count + 1)}>
+      {t("greeting")} {count}
+    </button>
+  );
+}
+
+function PermissionProbe() {
+  return <span>{usePermission("use") ? "allowed" : "denied"}</span>;
+}
+
+function activate(app: TermixApp) {
+  app.registerRailItem({
+    id: "fixture-panel",
+    icon: Puzzle,
+    titleKey: "title",
+  });
+  app.registerPanel("fixture-panel", () => <Counter />);
+  app.registerTab(
+    "fixture-tab",
+    ({ host }) => <span>tab for {host?.name ?? "nobody"}</span>,
+    { activityTypes: ["fixture_activity"] },
+  );
+  app.registerHostEditorSection({
+    id: "fixture-section",
+    group: "ssh",
+    titleKey: "title",
+    order: 15,
+    component: ({ setField }) => (
+      <button type="button" onClick={() => setField("fixture", true)}>
+        section
+      </button>
+    ),
+  });
+  app.registerHostAction({
+    id: "fixture-connect",
+    titleKey: "title",
+    icon: Puzzle,
+    kind: "connect",
+    priority: 500,
+    tabType: "fixture-tab",
+    when: (host) => host.pluginSettings?.fixture?.enableFixture === true,
+  });
+  app.registerPaletteEntry({
+    id: "fixture-entry",
+    titleKey: "title",
+    scope: "host",
+    when: (host) => host?.pluginSettings?.fixture?.enableFixture === true,
+    run: (shell, host) => shell.openTab(host ?? null, "fixture-tab"),
+  });
+  app.registerDashboardCard({
+    id: "fixture-card",
+    titleKey: "title",
+    component: ({ shell }) => (
+      <button
+        type="button"
+        onClick={() => shell.openSingletonTab("fixture-tab")}
+      >
+        card
+      </button>
+    ),
+  });
+  app.registerSettingsComponent("probe", PermissionProbe);
+  app.registerExtension("fixture.widgets", {
+    id: "fixture-widget",
+    name: "Fixture Widget",
+    icon: <Puzzle size={14} />,
+    components: { view: () => <span>fixture widget</span> },
+  });
+}
+
+let rendered: RenderedPluginApp | null = null;
+
+async function mount(permissions: string[] = []) {
+  rendered = await renderWithApp(
+    { activate },
+    { manifest: MANIFEST, locales: LOCALES, permissions },
+  );
+  return rendered;
+}
+
+afterEach(async () => {
+  await rendered?.deactivate();
+  rendered = null;
+  resetRegisteredRailItems();
+  resetTabTypes();
+  resetPanels();
+  resetDashboardCards();
+  resetSettingsComponents();
+  resetActionRegistry();
+  resetHostContributions();
+  resetHostEditorSections();
+  resetPaletteEntries();
+  resetPluginStore();
+  resetExtensions();
+});
+
+const host = (overrides: Partial<Host> = {}) =>
+  ({ id: "1", name: "web-01", ip: "10.0.0.1", port: 22, ...overrides }) as Host;
+
+describe("registries through the app object", () => {
+  it("records everything the plugin registered", async () => {
+    const app = await mount();
+    expect(app.registered.railItems()).toEqual([
+      { id: "fixture-panel", hidden: undefined },
+    ]);
+    expect(app.registered.tabs()).toEqual(["fixture-tab"]);
+    expect(app.registered.panels()).toEqual(["fixture-panel"]);
+    expect(app.registered.hostEditorSections()).toEqual(["fixture-section"]);
+    expect(app.registered.hostActions()).toEqual([
+      { id: "fixture-connect", tabType: "fixture-tab" },
+    ]);
+    expect(app.registered.dashboardCards()).toEqual(["fixture-card"]);
+    expect(app.registered.settingsComponents()).toEqual(["probe"]);
+  });
+
+  it("removes every registration on deactivate", async () => {
+    const app = await mount();
+    await app.deactivate();
+    expect(app.registered.railItems()).toEqual([]);
+    expect(app.registered.tabs()).toEqual([]);
+    expect(app.registered.hostActions()).toEqual([]);
+    expect(app.registered.dashboardCards()).toEqual([]);
+    rendered = null;
+  });
+
+  it("renders a panel with hooks bound to the plugin", async () => {
+    const app = await mount();
+    const container = app.renderPanel("fixture-panel");
+    const button = container.querySelector("button")!;
+    expect(button.textContent).toBe("Hello from fixture 0");
+    fireEvent.click(button);
+    expect(button.textContent).toBe("Hello from fixture 1");
+  });
+
+  it("renders a tab with the generic tab props", async () => {
+    const app = await mount();
+    const container = app.renderTab("fixture-tab", { host: host() });
+    expect(container.textContent).toBe("tab for web-01");
+  });
+
+  it("lists a rail item in the Navigation visibility toggles and toggles it", async () => {
+    await mount();
+    const onChange = vi.fn();
+    render(
+      <NavigationVisibilityToggles hidden={new Set()} onChange={onChange} />,
+    );
+    const row = screen.getByTestId("nav-toggle-fixture-panel");
+    expect(row.textContent).toContain("Fixture title");
+    fireEvent.click(row.querySelector("button, [role=switch]")!);
+    expect(onChange).toHaveBeenCalledWith(new Set(["fixture-panel"]));
+  });
+
+  it("drops the toggle when the plugin goes away", async () => {
+    const app = await mount();
+    const { rerender } = render(
+      <NavigationVisibilityToggles hidden={new Set()} onChange={() => {}} />,
+    );
+    expect(screen.queryByTestId("nav-toggle-fixture-panel")).not.toBeNull();
+    await app.deactivate();
+    rendered = null;
+    rerender(
+      <NavigationVisibilityToggles hidden={new Set()} onChange={() => {}} />,
+    );
+    expect(screen.queryByTestId("nav-toggle-fixture-panel")).toBeNull();
+  });
+
+  it("adds a host editor section to the SSH group in order", async () => {
+    await mount();
+    const ids = makeHostSshSubTabs((key) => key).map((tab) => tab.id);
+    expect(ids.slice(0, 2)).toEqual(["ssh", "fixture-section"]);
+    expect(makeHostTabs((key) => key).map((tab) => tab.id)).not.toContain(
+      "fixture-section",
+    );
+  });
+
+  it("renders a host editor section with the editor's setters", async () => {
+    const app = await mount();
+    const setField = vi.fn();
+    const container = app.renderHostEditorSection("fixture-section", {
+      setField,
+    });
+    fireEvent.click(container.querySelector("button")!);
+    expect(setField).toHaveBeenCalledWith("fixture", true);
+  });
+
+  it("offers a host action only where it applies, and picks it as the default connect", async () => {
+    await mount();
+    const on = host({ pluginSettings: { fixture: { enableFixture: true } } });
+    const off = host();
+    expect(hostActionsFor(listHostActions(), on).map((a) => a.id)).toEqual([
+      "fixture-connect",
+    ]);
+    expect(hostActionsFor(listHostActions(), off)).toEqual([]);
+    expect(defaultConnectAction(listHostActions(), on)?.id).toBe(
+      "fixture-connect",
+    );
+    expect(resolveHostTabType(on)).toBe("fixture-tab");
+  });
+
+  it("exposes registered host actions through the SDK's useHostActions", async () => {
+    await mount();
+    function Probe() {
+      const actions = useHostActions();
+      return <span>{actions.map((a) => a.id).join(",")}</span>;
+    }
+    render(<Probe />);
+    expect(await screen.findByText("fixture-connect")).toBeTruthy();
+  });
+
+  it("exposes a registered tab's activityTypes through useActivityTypes", async () => {
+    await mount();
+    function Probe() {
+      const types = useActivityTypes();
+      return <span>{types.join(",")}</span>;
+    }
+    render(<Probe />);
+    expect(await screen.findByText(/fixture_activity/)).toBeTruthy();
+  });
+
+  it("adds an extension other plugins read by point id", async () => {
+    await mount();
+    const widget = getExtension("fixture.widgets", "fixture-widget");
+    expect(widget?.name).toBe("Fixture Widget");
+    expect(widget?.pluginId).toBe("fixture");
+    expect(getExtension("other.point", "fixture-widget")).toBeUndefined();
+    const View = widget?.components?.view;
+    function Probe() {
+      const items = useExtensions("fixture.widgets");
+      return <span>{items.map((w) => w.id).join(",")}</span>;
+    }
+    render(
+      <>
+        <Probe />
+        {View && <View />}
+      </>,
+    );
+    expect(await screen.findByText("fixture-widget")).toBeTruthy();
+    expect(await screen.findByText("fixture widget")).toBeTruthy();
+  });
+
+  it("drops a plugin's extensions when it deactivates", async () => {
+    await mount();
+    expect(getExtension("fixture.widgets", "fixture-widget")).toBeTruthy();
+    await rendered?.deactivate();
+    rendered = null;
+    expect(getExtension("fixture.widgets", "fixture-widget")).toBeUndefined();
+  });
+
+  it("offers a per-host palette entry that runs against the shell", async () => {
+    const app = await mount();
+    const target = host({
+      pluginSettings: { fixture: { enableFixture: true } },
+    });
+    const entries = paletteEntriesFor(listPaletteEntries(), "host", target);
+    expect(entries.map((entry) => entry.id)).toEqual(["fixture-entry"]);
+    expect(paletteEntriesFor(listPaletteEntries(), "host", host())).toEqual([]);
+    entries[0].run(shell, target);
+    expect(app.shellCalls).toEqual([
+      { method: "openTab", args: [target, "fixture-tab"] },
+    ]);
+  });
+
+  it("renders a dashboard card that can reach the shell", async () => {
+    const app = await mount();
+    const container = app.renderDashboardCard("fixture-card");
+    fireEvent.click(container.querySelector("button")!);
+    expect(app.shellCalls).toEqual([
+      { method: "openSingletonTab", args: ["fixture-tab"] },
+    ]);
+  });
+
+  it("renders a custom settings field from the registered component", async () => {
+    await mount(["fixture.use"]);
+    render(
+      <SettingsFieldRow
+        pluginId="fixture"
+        field={{ key: "probe", type: "custom", component: "probe" }}
+        values={{}}
+        setValue={() => {}}
+        running
+      />,
+    );
+    await waitFor(() => expect(screen.getByText("allowed")).toBeTruthy());
+  });
+
+  it("resolves a short permission name against the plugin's namespace", async () => {
+    const app = await mount([]);
+    const container = app.renderSettingsComponent("probe");
+    expect(container.textContent).toBe("denied");
+  });
+});
@@ -0,0 +1,144 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { Puzzle } from "lucide-react";
+import type { FrontendModule } from "@termix/plugin-sdk/frontend";
+import type { PluginSummary } from "@/api/plugins-api";
+import {
+  configurePluginLoader,
+  resetPluginLoader,
+  syncPlugins,
+} from "@/plugin-host/loader";
+import { getPluginRecord, resetPluginStore } from "@/plugin-host/plugin-store";
+import { guardCallback, withIconBoundary } from "@/plugin-host/scope";
+import {
+  resetRegisteredRailItems,
+  visibleRailItems,
+} from "@/sidebar/rail-items";
+import {
+  listHostActions,
+  resetHostContributions,
+} from "@/sidebar/host-contributions";
+
+function summary(id: string): PluginSummary {
+  return {
+    id,
+    name: id,
+    version: "1.0.0",
+    enabled: true,
+    state: "active",
+    frontend: true,
+    assetVersion: "v1",
+    contributes: { panels: [{ id: `${id}-panel`, titleKey: "nav.hosts" }] },
+  };
+}
+
+let plugins: PluginSummary[] = [];
+let modules: Record<string, FrontendModule> = {};
+
+beforeEach(() => {
+  plugins = [];
+  modules = {};
+  vi.spyOn(console, "error").mockImplementation(() => {});
+  configurePluginLoader({
+    fetchPlugins: async () => plugins,
+    importFrontend: async (entry) => modules[entry.id],
+    loadLocale: async () => null,
+    injectCss: () => null,
+  });
+});
+
+afterEach(async () => {
+  vi.useRealTimers();
+  await resetPluginLoader();
+  resetPluginStore();
+  resetRegisteredRailItems();
+  resetHostContributions();
+  vi.restoreAllMocks();
+});
+
+describe("a plugin cannot stall or crash the shell", () => {
+  it("fails a plugin whose activate never finishes, and starts the rest", async () => {
+    vi.useFakeTimers();
+    modules.stuck = { activate: () => new Promise(() => {}) };
+    modules.healthy = {
+      activate(app) {
+        app.registerRailItem({
+          id: "healthy-panel",
+          icon: Puzzle,
+          titleKey: "nav.hosts",
+        });
+      },
+    };
+    plugins = [summary("stuck"), summary("healthy")];
+
+    const sync = syncPlugins();
+    await vi.advanceTimersByTimeAsync(16_000);
+    await sync;
+
+    expect(getPluginRecord("stuck")?.frontend).toBe("failed");
+    expect(visibleRailItems().map((item) => item.id)).toContain(
+      "healthy-panel",
+    );
+  });
+
+  it("answers a host action's throwing label and items with nothing", async () => {
+    modules.labels = {
+      activate(app) {
+        app.registerHostAction({
+          id: "labels.open",
+          titleKey: "open",
+          label: () => {
+            throw new Error("label broke");
+          },
+          items: () => {
+            throw new Error("items broke");
+          },
+          run: () => {},
+        } as never);
+      },
+    };
+    plugins = [summary("labels")];
+    await syncPlugins();
+
+    const action = listHostActions().find(
+      (entry) => entry.id === "labels.open",
+    );
+    expect(action).toBeDefined();
+    expect(() => action!.label?.({} as never)).not.toThrow();
+    expect(action!.label?.({} as never)).toBeUndefined();
+    expect(action!.items?.({} as never)).toBeUndefined();
+  });
+});
+
+describe("withIconBoundary", () => {
+  it("renders nothing for a throwing icon and leaves its neighbours alone", () => {
+    const Broken = () => {
+      throw new Error("icon broke");
+    };
+    const Safe = withIconBoundary("demo", Broken)!;
+    render(
+      <div>
+        <Safe />
+        <span>still here</span>
+      </div>,
+    );
+    expect(screen.getByText("still here")).toBeTruthy();
+  });
+
+  it("passes undefined through", () => {
+    expect(withIconBoundary("demo", undefined)).toBeUndefined();
+  });
+});
+
+describe("guardCallback", () => {
+  it("returns the fallback when the plugin's callback throws", () => {
+    const guarded = guardCallback(
+      "demo",
+      () => {
+        throw new Error("nope");
+      },
+      "fallback",
+    );
+    expect(guarded?.()).toBe("fallback");
+  });
+});
@@ -0,0 +1,52 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import {
+  resetShellBridge,
+  setShellCallbacks,
+  setShellHosts,
+  shell,
+  withShellHost,
+} from "@/plugin-host/shell-bridge";
+import type { Host } from "@/types/ui-types";
+
+const saved = {
+  id: "5",
+  name: "db",
+  ip: "10.0.0.5",
+  port: 22,
+  username: "root",
+  useSocks5: true,
+  socks5Host: "proxy",
+} as unknown as Host;
+
+afterEach(() => resetShellBridge());
+
+describe("withShellHost", () => {
+  it("fills a typed record back in from the shell's own host", () => {
+    setShellHosts([saved]);
+    const merged = withShellHost({
+      id: "5",
+      name: "db (renamed)",
+      notes: undefined,
+    } as unknown as Host);
+    expect(merged).toMatchObject({
+      name: "db (renamed)",
+      useSocks5: true,
+      socks5Host: "proxy",
+    });
+  });
+
+  it("keeps a host the shell does not list as it is", () => {
+    setShellHosts([saved]);
+    const quick = { id: "quick-connect-1", ip: "1.2.3.4" } as unknown as Host;
+    expect(withShellHost(quick)).toBe(quick);
+    expect(withShellHost(null)).toBeNull();
+  });
+
+  it("is what shell.openTab hands the mounted shell", () => {
+    setShellHosts([saved]);
+    const openTab = vi.fn();
+    setShellCallbacks({ openTab } as never);
+    shell.openTab({ id: "5", name: "db" } as unknown as Host, "terminal");
+    expect(openTab.mock.calls[0][0]).toMatchObject({ socks5Host: "proxy" });
+  });
+});
@@ -0,0 +1,156 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { render, screen } from "@testing-library/react";
+import { useTranslation, type TermixApp } from "@termix/plugin-sdk/frontend";
+import {
+  renderWithApp,
+  type RenderedPluginApp,
+} from "@termix/plugin-sdk/testing";
+import { ComponentSlot } from "@/shell/ActionSlot";
+import { resetActionRegistry } from "@/shell/action-registry";
+import { resetPluginStore } from "@/plugin-host/plugin-store";
+import { resetPanels } from "@/shell/panel-registry";
+import { setPermissionsForTesting } from "@/hooks/use-permissions";
+import i18n from "@/i18n/i18n";
+import { pluginKey } from "@/lib/plugin-i18n";
+
+const mounted: RenderedPluginApp[] = [];
+
+afterEach(async () => {
+  while (mounted.length > 0) await mounted.pop()!.deactivate();
+  resetActionRegistry();
+  resetPanels();
+  resetPluginStore();
+});
+
+function Label() {
+  const { t } = useTranslation();
+  return <span>{t("label")}</span>;
+}
+
+describe("component slots", () => {
+  function contribute(permission?: string) {
+    return async (app: TermixApp) => {
+      if (permission) {
+        app.registerAction("slotty.panel", () => {}, { permission });
+      }
+      app.registerSlotContribution("owner.slot", {
+        actionId: "slotty.panel",
+        titleKey: "label",
+        kind: "component",
+        component: ({ who }: Record<string, unknown>) => (
+          <span>contributed for {String(who)}</span>
+        ),
+        when: (context) => context.show !== false,
+      });
+    };
+  }
+
+  const manifest = {
+    id: "slotty",
+    contributes: {
+      permissions: [{ name: "use", titleKey: "l", descriptionKey: "l" }],
+    },
+  };
+
+  it("renders nothing when nobody contributed", () => {
+    setPermissionsForTesting([]);
+    const { container } = render(<ComponentSlot slotId="owner.slot" />);
+    expect(container.innerHTML).toBe("");
+  });
+
+  it("renders nothing when the user lacks the permission", async () => {
+    mounted.push(
+      await renderWithApp(
+        { activate: contribute("use") },
+        { manifest, permissions: [] },
+      ),
+    );
+    const { container } = render(
+      <ComponentSlot slotId="owner.slot" props={{ who: "me" }} />,
+    );
+    expect(container.innerHTML).toBe("");
+  });
+
+  it("renders the contribution with the owner's props when permitted", async () => {
+    mounted.push(
+      await renderWithApp(
+        { activate: contribute("use") },
+        { manifest, permissions: ["slotty.use"] },
+      ),
+    );
+    render(<ComponentSlot slotId="owner.slot" props={{ who: "me" }} />);
+    expect(await screen.findByText("contributed for me")).toBeTruthy();
+  });
+
+  it("honours a contribution's when", async () => {
+    mounted.push(await renderWithApp({ activate: contribute() }, { manifest }));
+    const { container } = render(
+      <ComponentSlot slotId="owner.slot" when={{ show: false }} />,
+    );
+    expect(container.innerHTML).toBe("");
+  });
+});
+
+describe("plugin translations", () => {
+  it("keeps two plugins' identical keys apart", async () => {
+    for (const [id, text] of [
+      ["first", "From the first plugin"],
+      ["second", "From the second plugin"],
+    ] as const) {
+      const app = await renderWithApp(
+        {
+          activate(app) {
+            app.registerPanel(`${id}-panel`, Label);
+          },
+        },
+        {
+          manifest: {
+            id,
+            contributes: { panels: [{ id: `${id}-panel`, titleKey: "label" }] },
+          },
+          locales: { label: text },
+        },
+      );
+      mounted.push(app);
+    }
+    const [first, second] = mounted;
+    expect(first.renderPanel("first-panel").textContent).toBe(
+      "From the first plugin",
+    );
+    expect(second.renderPanel("second-panel").textContent).toBe(
+      "From the second plugin",
+    );
+  });
+
+  it("falls back to core strings for keys the plugin does not define", async () => {
+    mounted.push(
+      await renderWithApp(
+        {
+          activate(app) {
+            app.registerPanel("borrow-panel", () => {
+              const { t } = useTranslation();
+              return <span>{t("common.save")}</span>;
+            });
+          },
+        },
+        {
+          manifest: {
+            id: "borrow",
+            contributes: { panels: [{ id: "borrow-panel", titleKey: "x" }] },
+          },
+          locales: {},
+        },
+      ),
+    );
+    expect(mounted[0].renderPanel("borrow-panel").textContent).toBe(
+      i18n.t("common.save"),
+    );
+  });
+
+  it("qualifies manifest keys with the plugin's namespace", () => {
+    expect(pluginKey("tailscale", "settings.apiKey.label")).toBe(
+      "tailscale:settings.apiKey.label",
+    );
+    expect(pluginKey("tailscale", "other:key")).toBe("other:key");
+  });
+});
@@ -0,0 +1,158 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { act, render, screen } from "@testing-library/react";
+import type { PluginSummary } from "@/api/plugins-api";
+import {
+  resetPluginStore,
+  setFrontendState,
+  setPluginSummaries,
+} from "@/plugin-host/plugin-store";
+import {
+  unregisteredViewStatus,
+  viewOwner,
+} from "@/plugin-host/view-ownership";
+import { renderTabContent } from "@/shell/tabUtils";
+import {
+  canRestoreTabType,
+  isPersistentTabType,
+  registerTabType,
+  resetTabTypes,
+} from "@/shell/tab-registry";
+import {
+  registerDashboardCard,
+  resetDashboardCards,
+} from "@/dashboard/dashboard-cards-registry";
+import { PluginCardSlot } from "@/dashboard/DashboardTab";
+import type { Host, Tab } from "@/types/ui-types";
+
+const shell = {
+  openTab: () => {},
+  openSingletonTab: () => {},
+  closeTab: () => {},
+  renameTab: () => {},
+  connectHost: () => {},
+  openRailView: () => {},
+  closeRailView: () => {},
+};
+
+function owner(overrides: Partial<PluginSummary> = {}): PluginSummary {
+  return {
+    id: "gizmo",
+    name: "Gizmo",
+    version: "1.0.0",
+    enabled: true,
+    state: "active",
+    frontend: true,
+    contributes: {
+      tabs: [
+        { id: "gizmo-tab", titleKey: "t", icon: "Box", openFrom: ["rail"] },
+      ],
+      panels: [{ id: "gizmo-panel", titleKey: "t" }],
+      dashboardCards: [{ id: "gizmo-card", titleKey: "t" }],
+    },
+    ...overrides,
+  };
+}
+
+const savedTab: Tab = {
+  id: "gizmo-1",
+  instanceId: "gizmo-1",
+  type: "gizmo-tab",
+  label: "Gizmo",
+  openedAt: 0,
+  host: { id: "1", name: "web-01" } as Host,
+};
+
+afterEach(() => {
+  resetPluginStore();
+  resetTabTypes();
+  resetDashboardCards();
+});
+
+describe("view ownership", () => {
+  it("finds the owner of a tab, panel or card from its manifest", () => {
+    setPluginSummaries([owner()]);
+    expect(viewOwner("tab", "gizmo-tab")?.summary.id).toBe("gizmo");
+    expect(viewOwner("panel", "gizmo-panel")?.summary.id).toBe("gizmo");
+    // A tab id doubles as a panel when a rail panel is promoted.
+    expect(viewOwner("panel", "gizmo-tab")?.summary.id).toBe("gizmo");
+    expect(viewOwner("card", "gizmo-card")?.summary.id).toBe("gizmo");
+    expect(viewOwner("tab", "someone-else")).toBeUndefined();
+  });
+
+  it("explains why a view is absent", () => {
+    setPluginSummaries([owner({ enabled: false })]);
+    expect(unregisteredViewStatus("tab", "gizmo-tab").status).toBe("disabled");
+
+    setPluginSummaries([owner({ state: "failed" })]);
+    expect(unregisteredViewStatus("tab", "gizmo-tab").status).toBe("failed");
+
+    setPluginSummaries([owner()]);
+    expect(unregisteredViewStatus("tab", "gizmo-tab").status).toBe("loading");
+    setFrontendState("gizmo", "active");
+    expect(unregisteredViewStatus("tab", "gizmo-tab").status).toBe("missing");
+
+    expect(unregisteredViewStatus("tab", "nobody").status).toBe("missing");
+  });
+
+  it("keeps a saved tab of a disabled plugin and restores it as a placeholder", () => {
+    setPluginSummaries([owner({ enabled: false })]);
+    expect(isPersistentTabType("gizmo-tab")).toBe(true);
+    expect(canRestoreTabType("gizmo-tab", savedTab.host)).toBe(true);
+
+    render(<>{renderTabContent(savedTab, { shell })}</>);
+    const placeholder = screen.getByTestId("plugin-view-placeholder");
+    expect(placeholder.dataset.status).toBe("disabled");
+    expect(placeholder.textContent).toContain("plugins.runtime.needsPlugin");
+  });
+
+  it("shows a not-installed placeholder for a tab nobody owns, without throwing", () => {
+    setPluginSummaries([]);
+    render(<>{renderTabContent({ ...savedTab, type: "gone" }, { shell })}</>);
+    expect(screen.getByTestId("plugin-view-placeholder").dataset.status).toBe(
+      "missing",
+    );
+  });
+
+  it("swaps the placeholder for the real tab once the plugin registers it", () => {
+    setPluginSummaries([owner()]);
+    registerTabType({
+      id: "gizmo-tab",
+      pluginId: "gizmo",
+      component: ({ host }) => <span>gizmo on {host?.name}</span>,
+    });
+    render(<>{renderTabContent(savedTab, { shell })}</>);
+    expect(screen.getByText("gizmo on web-01")).toBeTruthy();
+  });
+
+  it("keeps a dashboard card's slot while its plugin is off", () => {
+    setPluginSummaries([owner({ enabled: false })]);
+    const view = render(
+      <PluginCardSlot
+        id="gizmo-card"
+        isVisible
+        onOpenSingletonTab={() => {}}
+      />,
+    );
+    expect(screen.getByTestId("plugin-view-placeholder").dataset.status).toBe(
+      "disabled",
+    );
+
+    act(() => {
+      setPluginSummaries([owner()]);
+      registerDashboardCard({
+        id: "gizmo-card",
+        pluginId: "gizmo",
+        titleKey: "t",
+        component: () => <span>gizmo card</span>,
+      });
+    });
+    view.rerender(
+      <PluginCardSlot
+        id="gizmo-card"
+        isVisible
+        onOpenSingletonTab={() => {}}
+      />,
+    );
+    expect(screen.getByText("gizmo card")).toBeTruthy();
+  });
+});