Termix/packages/plugin-sdk/CHANGELOG.md

Changelog

1.0.22

Plugin API 1.13.0.

Added

• contributes.mobile in the manifest says how a plugin shows in the Termix mobile app: webview, native or none, with an optional mobile bundle, screen sizes, views and a note
• termix-plugin build bundles src/mobile into the contributes.mobile.entry file, and validate checks that it exists
• @termix-ssh/plugin-sdk/frame-host runs one plugin view outside the shell, with core's bridge, registries and CSS, so the mobile app can show webview plugins
• SSH transport providers get the host's owner, sync id, connection origin and local only flag in claims and open, and core's SSH relay takes a syncId instead of a host id
• ctx.sync.host.entities.idsOf maps sync ids to the local ids of the user's own rows of one type
• Rail items take useStatus for a small ok, warning or error dot on the icon
• shell.editHost(hostId) opens the editor of a saved host
• A sync entity can be read only with load, write and erase, so a plugin can sync rows a user does not own, like a shared library, down to linked desktops
• getFolderAuthOverride and setFolderAuthOverride in @termix-ssh/plugin-sdk/ui read and set a user's own login for the shared hosts in a folder

Fixed

• @termix-ssh/plugin-sdk/ui is built in production mode, so outside Termix it no longer sends requests to the Vite dev server path
• execCommand buffers output and decodes it once as strict UTF-8 with a GBK fallback, exposed as decodeCommandOutput, so messages from a Windows host on a legacy codepage are readable instead of � characters

1.0.21

Plugin API 1.12.0.

Added

• @termix-ssh/plugin-sdk/host-scripts: Docker, Linux metrics, systemd, journal and OpenRC command builders and parsers, plus scriptShell() and passwordSudoScript() to send scripts to bash -s on stdin. It has no Node or ssh2 imports, so the Termix mobile app runs the same code

1.0.20

Plugin API 1.12.0.

Added

• columns and onColumns on ViewToggle show a cards per row picker: Auto fits as many as the pane has room for, or pick 1 to 6
• size and minCardWidth on DataView, so a card grid follows that pick, and the GridSize type
• usePluginPanelView also keeps columns, the cards per row pick, with setColumns

1.0.19

Plugin API 1.11.0.

Added

• app.registerCompanionLayout and useCompanions, so a plugin can let each host turn the panel bar on or off, move it and choose which panels show and in what order

1.0.18

Plugin API 1.10.0.

Added

• clientCert on the sync link, link patch and remote target, and the client_cert remote error kind, so a sync plugin can link to a server that needs mutual TLS

1.0.17

Plugin API 1.9.0.

Added

• app.registerCompanion and app.toggleCompanion, so a plugin can add a panel beside any host tab. The user opens, resizes and moves it, and the tab keeps running
• NativeView in @termix-ssh/plugin-sdk/ui, which shows a web page in a native view in the desktop app, for sites that do not work in an iframe

1.0.16

Plugin API 1.8.0.

Added

• ctx.sync.provide and the sync:provide capability, so a plugin can answer every /sync request
• ctx.ssh.transports.provide and the ssh:transport capability, so a plugin can carry SSH connections over its own stream
• ctx.hosts.folders.ensure and removeEmpty

Removed

• The sync screens and calls in @termix-ssh/plugin-sdk/ui: LinkServerDialog, ProxySettingsFields, useSyncStatus, refreshSyncStatus, setSyncStatus, getSyncConflicts, getSyncErrors, retrySyncErrors, settleSyncConflict, syncNow, unlinkServer, updateSyncSettings and their types. They moved into the sync plugin

1.0.15

Plugin API 1.7.0.

Added

• ctx.auth.policy.provide and the auth:policy capability, so a plugin can set an idle timeout, cap session length, turn off remember me and require a second factor
• ctx.auth.listSecondFactors lists the second factors from every running plugin
• AuthEnrollmentSections takes factorsOnly
• getHttpsSettings and updateHttpsSettings in @termix-ssh/plugin-sdk/ui

Fixed

• Plugin frontend tests against a locally linked SDK failed with a second copy of React

1.0.14

Plugin API 1.6.0.

Added

• ctx.hosts.locks.provide and the hosts:lock capability, so a plugin can manage hosts that stay read only for everyone else and block adding hosts by hand
• ctx.hosts.setShares to replace every grant on a host in one call
• ctx.credentials.list returns the acting user's credentials by name, without secrets
• ctx.hosts.create and update take password, key, keyPassword, keyType, sudoPassword, protocolAuth and pluginEnable

1.0.13

Plugin API 1.5.0.

Added

• runtime: "desktop" in the manifest for a plugin that only loads on the desktop app
• desktop:local and ctx.desktop.local: file system, local shell and machine info on the desktop app's own backend
• ctx.audit.subscribe, ctx.audit.list and ctx.audit.exportBatches under audit:read
• ctx.hosts.importMany, importSshConfig, exportMany and registerImportNormalizer, with the hosts:export capability
• ctx.credentials.publicKey and resolveKeyRefs, ctx.ssh.exec, and @termix-ssh/plugin-sdk/ssh-keys
• ctx.hosts.status.provide and ctx.hosts.activity.provide so a plugin can own host status and recent activity, with ctx.network.tcpProbe, ctx.ssh.probe, ctx.hosts.probeTargets and ctx.hosts.sessionActive
• registerHostStatusIndicator and registerHostEditorToolbarItem, and order for host badges
• Onboarding steps can sit in a start section, take a position and replaces a core step
• A plugin can provide the app name, tagline and logo through the <id>.brandingProvider registry key

1.0.12

Plugin API 1.4.0.

Added

• contributes.layouts and app.registerLayout() for a whole-app layout, with the ui:layout capability. Needs engine.api 1.4
• contributes.themes for CSS-only themes, with the ui:theme capability. termix-plugin validate checks theme CSS and pack ships it
• useShell() gives a layout the live shell: tabs, splits, hosts, docks, the command palette and the registries. The shell's home tab is left out until some plugin registers a dashboard tab type
• TabStage and ShellConfirmCapture in @termix-ssh/plugin-sdk/ui, for a layout to place tabs
• validateThemeCss() in @termix-ssh/plugin-sdk/manifest
• @termix-ssh/plugin-sdk/ui also exports what a whole layout is built from: the API client, shared types, hooks, useShellController() and APP_VERSION. These reach into core, so they can change with a core release
• @termix-ssh/plugin-sdk/testing-host exports the registries and permission seam a layout's own tests fill directly
• A plugin that only holds themes needs no source: termix-plugin build writes an empty backend and validate does not ask for a frontend
• termix-plugin validate flags ui:layout or ui:theme with nothing contributed, and a layout plugin with no frontend

Fixed

• The manifest JSON schema lists the notify:hub and plugins:read capabilities
• Plugin tests and type checks work with the SDK linked from a local Termix checkout

1.0.11

Plugin API 1.3.0.

Added

• ctx.auth.issueUserToken() mints a short-lived session for a user, for calling Termix's own API as them from background work. Needs users:impersonate and engine.api 1.3
• ctx.users.getLocale() reads a user's UI language. Needs users:read and engine.api 1.3

1.0.10

Changed

• termix-plugin pack includes the plugin's LICENSE and NOTICE files, so third-party notices ship with it

1.0.9

Added

• Worker entries in package.json termix.workers, each bundled on its own into dist/workers/<name>.js
• A .wasm, .ttf or .otf import gives the file's bytes, in termix-plugin build and in plugin tests

Fixed

• The plugin guide listed jszip, guacamole-lite and @anthropic-ai/sdk as shared packages, but they are bundled

1.0.8

Added

• publicRateLimit on ctx.http.router(), for a plugin whose public routes serve a proxied page

1.0.7

Fixed

• A migration file, or a part of one, holding only comments made core fail to start the plugin

1.0.6

Added

• PLUGIN-GUIDE.md, a guide to building, testing and releasing a plugin, written so AI coding tools can read it too

1.0.5

Fixed

• execCommand timeout errors no longer include the command, which could hold a sudo password
• termix-plugin validate fails when a plugin ships migrations for some database engines but not all three
• termix-plugin migrations loads the table definitions from a path with a # or other URL characters in it
• Text, json and encrypted columns are longtext on MySQL in new migrations, so they are no longer capped at 64KB. Existing migrations keep text
• i18next, react-dom, react-i18next and sonner are optional peer dependencies, so npm stops installing them into backend-only plugins
• termix-plugin validate accepts a beta version like 1.1.0-beta.1 when the changelog's newest release is 1.1.0 or older, so beta releases pass

1.0.4

Fixed

• termix-plugin build puts a plugin's own Tailwind classes in core's utilities layer, so responsive, hover and group variants and className overrides on SDK components work. Plain classes core already ships stay below core's utilities as before, while variants core ships go with the plugin's own so max-h-56 md:max-h-none keeps its order. Rebuild a plugin to pick it up

1.0.3

Plugin API 1.2.0.

Added

• docs manifest field: an https link to the plugin's docs. Termix shows it as a Documentation link on the plugin's page and in its settings
• env manifest field: the environment variables the plugin reads, listed in its docs and on its page
• app.docs and useDocsUrl() for links into the plugin's own docs, and DocsLink in @termix-ssh/plugin-sdk/ui
• PanelShell takes a docs link and shows it as a book icon in the header
• @termix-ssh/plugin-sdk/openapi with buildOpenApi(), and termix-plugin openapi, which writes dist/openapi.json from the @openapi blocks in src/backend. build runs it too
• @termix-ssh/plugin-sdk/docs with pluginDocsUrl(), pluginDocsPage() and pluginEnvVars()
• termix-plugin validate warns when docs/index.md is missing or the source reads an env var the manifest does not list

1.0.2

Added

• features manifest field: up to 20 short lines about what the plugin does, shown on its page. pluginFeatures() reads them

Changed

• parseChangelog() and validateChangelog() flag a ## Unreleased section. Notes go under the version they ship in

Removed

• Changelog.unreleased

1.0.1

Added

• Plugin API 1.1
• app.registerOnboardingStep() adds a step to onboarding, with OnboardingStepProps and OnboardingStepContribution. Needs engine.api 1.1
• video manifest field: a YouTube link shown at the top of the plugin's page, read with youtubeVideoId()
• @termix-ssh/plugin-sdk/changelog parses and checks a plugin's CHANGELOG.md
• termix-plugin changelog prints one version's notes from CHANGELOG.md
• termix-plugin dev installs a plugin on a running server and reinstalls it on every change. Needs developer mode and an admin API key
• renderOnboardingStep() and registered.onboardingSteps() in renderWithApp()
• AddButton, FormFooter, ListRow, ListRowAction, ListRowFolder, ListBadge and PanelList in @termix-ssh/plugin-sdk/ui
• PanelSearch takes disabled, title, onEnter and inputRef, and SurfaceScope takes onClose

Changed

• Release notes moved from CHANGELOG.json to CHANGELOG.md, which pack now ships. validate flags a leftover CHANGELOG.json
• ConnectionScreen dropped errorMessage and retryLabel and gained onClose. ConnectionLogPanel dropped position
• Plugin tests run in worker threads, since forked workers crash now and then on Windows
• The test setup stubs ResizeObserver for Radix controls under jsdom
• onboarding is a reserved plugin id

Deprecated

• The onboarding.* action slots. Use registerOnboardingStep()

Removed

• schema/changelog.schema.json

1.0.0

Added

• Backend, frontend, database, manifest, capability and settings types for plugin API 1.0
• Testing helpers and a Vitest preset for plugin tests
• The @termix-ssh/plugin-sdk/ui component set
• The termix-plugin CLI to build, validate, test, pack, sign and write migrations