@termix-ssh/plugin-sdk 1.0.22 → 1.0.24

package/dist/host/frame-host.js

@@ -1,7 +1,7 @@
 const __termixNoGlob = () => ({});
 import {
   Toaster
-} from "./chunk-TK3Y437H.js";
+} from "./chunk-EKXGDM5P.js";
 import {
   ThemeProvider,
   createPluginApp,
@@ -12,8 +12,8 @@ import {
   setPluginThemes,
   sshHostToHost,
   useTheme
-} from "./chunk-HQ6NNFSX.js";
-import "./chunk-JRV2HIDK.js";
+} from "./chunk-5W6F6GJJ.js";
+import "./chunk-GRH7GSKG.js";
 import {
   SurfaceScope,
   notifyShellReady,
@@ -21,13 +21,13 @@ import {
   setShellCallbacks,
   setShellHosts,
   shellHost
-} from "./chunk-VKNGNEF3.js";
+} from "./chunk-DN6YKMFJ.js";
 import {
   getSSHHosts,
   getTabType,
   setFrontendState,
   setPluginSummaries
-} from "./chunk-P26QKKU5.js";
+} from "./chunk-6WLECSNB.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

package/dist/host/{linked-server-J5G457OA.js → linked-server-YCAJ2NX3.js}

@@ -4,7 +4,7 @@ import {
   getLinkedSession,
   notifySyncChanged,
   useDesktopLinked
-} from "./chunk-P26QKKU5.js";
+} from "./chunk-6WLECSNB.js";
 import "./chunk-YGYBM7SQ.js";
 export {
   SYNC_CHANGED_EVENT,

package/dist/host/{rbac-api-PY22W5UY.js → rbac-api-A64TXDL5.js}

@@ -25,7 +25,7 @@ import {
   shareHost,
   updateHostAccess,
   updateRole
-} from "./chunk-P26QKKU5.js";
+} from "./chunk-6WLECSNB.js";
 import "./chunk-YGYBM7SQ.js";
 export {
   assignRoleToUser,

package/dist/host/testing-host.js

@@ -7,7 +7,7 @@ import {
   PluginViewPlaceholder,
   renderTabContent,
   trackTabHandle
-} from "./chunk-I5F2PSMR.js";
+} from "./chunk-RWFXGG4Q.js";
 import {
   RAIL_ITEMS,
   ServerStatusProvider,
@@ -46,6 +46,7 @@ import {
   registerDashboardCard,
   registerHostAction,
   registerHostProtocol,
+  registerHostSection,
   registerKeybindingAction,
   registerKeybindingDefault,
   registerRailItem,
@@ -54,6 +55,7 @@ import {
   resetActionRegistry,
   resetDashboardCards,
   resetHostContributions,
+  resetHostSections,
   resetKeybindingRegistry,
   resetRegisteredRailItems,
   resolveLayoutTabTarget,
@@ -61,11 +63,11 @@ import {
   setRemoteServerUrlForTesting,
   useShellController,
   useTabStageStore
-} from "./chunk-HQ6NNFSX.js";
+} from "./chunk-5W6F6GJJ.js";
 import {
   setPermissionsForTesting
-} from "./chunk-JRV2HIDK.js";
-import "./chunk-7J4QNGFM.js";
+} from "./chunk-GRH7GSKG.js";
+import "./chunk-IMPLAAUM.js";
 import {
   SurfaceScope,
   notifyShellReady,
@@ -73,14 +75,14 @@ import {
   setShellCallbacks,
   setShellHosts,
   setShellLayoutProvider
-} from "./chunk-VKNGNEF3.js";
+} from "./chunk-DN6YKMFJ.js";
 import {
   getTabType,
   listTabTypes,
   resetPluginStore,
   setFrontendState,
   setPluginSummaries
-} from "./chunk-P26QKKU5.js";
+} from "./chunk-6WLECSNB.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";
@@ -499,6 +501,7 @@ export {
   registerDashboardCard,
   registerHostAction,
   registerHostProtocol,
+  registerHostSection,
   registerKeybindingAction,
   registerKeybindingDefault,
   registerRailItem,
@@ -507,6 +510,7 @@ export {
   resetActionRegistry,
   resetDashboardCards,
   resetHostContributions,
+  resetHostSections,
   resetKeybindingRegistry,
   resetPluginStore,
   resetRegisteredRailItems,

package/dist/host/types/src/ui/lib/db-health-monitor.d.ts

@@ -19,6 +19,8 @@ declare class DatabaseHealthMonitor {
     private static instance;
     private listeners;
     private degradedActive;
+    private probe;
+    private probing;
     private constructor();
     static getInstance(): DatabaseHealthMonitor;
     on(event: string, listener: EventListener): void;
@@ -26,6 +28,9 @@ declare class DatabaseHealthMonitor {
     private emit;
     reportSessionExpired(): void;
     reportDatabaseError(error: unknown): void;
+    /** Sets the quick check used after a request times out. */
+    setReachabilityProbe(probe: (() => Promise<boolean>) | null): void;
+    private markDegraded;
     reportDatabaseSuccess(): void;
     isDegraded(): boolean;
     reset(): void;

package/dist/host/types/src/ui/lib/plugin-transport.d.ts

@@ -25,6 +25,11 @@ import { type ConnectionOrigin, type WebSocketConnectionTarget } from "./connect
  * reporting all behave identically.
  */
 export declare function createPluginApi(pluginId: string): AxiosInstance;
+/**
+ * An axios client rooted at core's /operations routes: the action catalog,
+ * runs, approvals, events, signals and cross host resources.
+ */
+export declare function createOperationsApi(): AxiosInstance;
 /**
  * A raw fetch on this plugin's /plugin-api mount point, for a response the
  * caller reads as a stream (server-sent events). axios buffers the whole

package/dist/host/types/src/ui/plugin-host/sdk-ui.d.ts

@@ -196,3 +196,7 @@ export { useEditorDefaultKeys } from "../sidebar/host-defaults/catalog";
 export { enabledHostProtocols, type HostProtocolDef, hostProtocolFlags, type HostProtocols, listHostProtocols, protocolEnabled, protocolPort, useHostProtocols, withProtocolSettings, } from "../sidebar/host-protocols";
 export { quickConnectTargets } from "../sidebar/quick-connect-host";
 export { groupRailItems, isCoreRailView, moveRailItem, promotableIds, type RailGroup, type RailItemDef, railItemLabel, rightDockableIds, useRailItems, } from "../sidebar/rail-items";
+export { hostSectionsFor, type HostSectionDef, listHostSections, useHostSections, } from "../shell/host-sections";
+export { HostTabEmbed } from "../shell/HostTabEmbed";
+/** Core's /operations routes, with the user's own session. */
+export declare const operationsApi: import("axios").AxiosInstance;

package/dist/host/types/src/ui/shell/HostTabEmbed.d.ts

@@ -0,0 +1,15 @@
+import type { Host } from "../../types/ui-types";
+import type { TabShellCallbacks } from "./tab-registry";
+/**
+ * Draws a registered tab type inside another view, such as a host page, with
+ * the same props the tab stage gives it. The embed has its own instance id, so
+ * it never collides with the same tool opened as a normal tab.
+ */
+export declare function HostTabEmbed({ host, type, label, data, isVisible, shell, }: {
+    host: Host;
+    type: string;
+    label?: string;
+    data?: Record<string, unknown>;
+    isVisible?: boolean;
+    shell: TabShellCallbacks;
+}): import("react").JSX.Element;

package/dist/host/types/src/ui/shell/host-sections.d.ts

@@ -0,0 +1,25 @@
+import type { ComponentType } from "react";
+import type { Host } from "../../types/ui-types";
+import type { TabShellCallbacks } from "./tab-registry";
+export interface HostSectionRenderProps {
+    host: Host;
+    isVisible: boolean;
+    shell: TabShellCallbacks;
+}
+/**
+ * A card a plugin adds to a host page. The page itself belongs to a plugin;
+ * core only keeps the list so any plugin can fill it.
+ */
+export interface HostSectionDef {
+    id: string;
+    pluginId?: string;
+    titleKey: string;
+    order?: number;
+    when: (host: Host) => boolean;
+    component: ComponentType<HostSectionRenderProps>;
+}
+export declare const registerHostSection: (item: HostSectionDef) => () => void;
+export declare const useHostSections: () => HostSectionDef[];
+export declare const listHostSections: () => HostSectionDef[];
+export declare const resetHostSections: () => void;
+export declare function hostSectionsFor(all: HostSectionDef[], host: Host): HostSectionDef[];

package/dist/host/ui.js

@@ -16,15 +16,16 @@ import {
   markTabSurfaceUsed,
   preloadTabSurface,
   recordHostActionPreference,
+  renderTabContent,
   runAdaptiveBackgroundTask,
   tabIcon,
   useInstalledPlugins,
   usePluginHostSections,
   useTabHandlesVersion
-} from "./chunk-I5F2PSMR.js";
+} from "./chunk-RWFXGG4Q.js";
 import {
   Toaster
-} from "./chunk-TK3Y437H.js";
+} from "./chunk-EKXGDM5P.js";
 import {
   ACCENT_PRESET_COLORS,
   BUILTIN_THEMES,
@@ -48,6 +49,7 @@ import {
   canJoinSplit,
   challengeSecondFactor,
   changeAppLanguage,
+  createOperationsApi,
   createPluginApp,
   createQuickConnectHost,
   defaultConnectAction,
@@ -75,6 +77,7 @@ import {
   hostEditorToolbarItemsFor,
   hostMenuItemsFor,
   hostProtocolFlags,
+  hostSectionsFor,
   hostStatusIndicatorsFor,
   i18n_default,
   installPluginHostBridge,
@@ -86,6 +89,7 @@ import {
   layoutLabel,
   listHostActions,
   listHostProtocols,
+  listHostSections,
   listPanes,
   listRegisteredRailItems,
   loadPaletteGroup,
@@ -139,6 +143,7 @@ import {
   useHostEditorSections,
   useHostEditorToolbarItems,
   useHostProtocols,
+  useHostSections,
   useHostStatus,
   useHostStatusIndicators,
   useIsMobile,
@@ -165,10 +170,10 @@ import {
   useThemes,
   verifySecondFactor,
   withProtocolSettings
-} from "./chunk-HQ6NNFSX.js";
+} from "./chunk-5W6F6GJJ.js";
 import {
   usePermissions
-} from "./chunk-JRV2HIDK.js";
+} from "./chunk-GRH7GSKG.js";
 import {
   AddButton,
   Card,
@@ -189,7 +194,7 @@ import {
   isPrerelease,
   reportBetaFeedbackUrl,
   reportCoreIssueUrl
-} from "./chunk-ROB2SH5Q.js";
+} from "./chunk-C52NRTA6.js";
 import {
   Button,
   DefaultsOnly,
@@ -206,7 +211,7 @@ import {
   hasVisibleFields,
   isFieldShown,
   useIsDefaultsEditor
-} from "./chunk-7J4QNGFM.js";
+} from "./chunk-IMPLAAUM.js";
 import {
   Action,
   Activity,
@@ -381,7 +386,7 @@ import {
   useSurfaceKind,
   useUiPreference,
   useUiPreferencesContext
-} from "./chunk-VKNGNEF3.js";
+} from "./chunk-DN6YKMFJ.js";
 import {
   CREDENTIAL_ROW_FIELD_KEYS,
   PRESETS,
@@ -544,7 +549,7 @@ import {
   useTabs,
   useTabsSafe,
   verifyPasswordResetCode
-} from "./chunk-P26QKKU5.js";
+} from "./chunk-6WLECSNB.js";
 import {
   define_import_meta_env_default,
   init_define_import_meta_env
@@ -557,7 +562,7 @@ init_define_import_meta_env();
 init_define_import_meta_env();
 import { jsx } from "react/jsx-runtime";
 var alertVariants = cva(
-  "relative w-full border border-border px-4 py-3 text-sm grid has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr] grid-cols-[0_1fr] has-[>svg]:gap-x-3 gap-y-0.5 items-start [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current",
+  "relative w-full border border-border px-4 py-3 text-sm not-has-[>svg]:block grid has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr] grid-cols-[0_1fr] has-[>svg]:gap-x-3 gap-y-0.5 items-start [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current",
   {
     variants: {
       variant: {
@@ -33305,6 +33310,38 @@ function AuthEnrollmentSections({
     );
   }) });
 }
+
+// src/ui/shell/HostTabEmbed.tsx
+init_define_import_meta_env();
+import { useMemo as useMemo10 } from "react";
+import { jsx as jsx55 } from "react/jsx-runtime";
+function HostTabEmbed({
+  host,
+  type,
+  label,
+  data,
+  isVisible = true,
+  shell: shell2
+}) {
+  const tab = useMemo10(
+    () => ({
+      id: `embed-${type}-${host.id}`,
+      instanceId: `embed-${type}-${host.id}`,
+      type,
+      label: label ?? host.name ?? host.ip,
+      host,
+      openedAt: Date.now(),
+      data
+    }),
+    // A new host or tool is a new tab; label and data changes keep it.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [type, host.id]
+  );
+  return /* @__PURE__ */ jsx55("div", { className: "h-full min-h-0 flex flex-col", children: renderTabContent(tab, { shell: shell2, isVisible, isFocusedPane: isVisible }) });
+}
+
+// src/ui/plugin-host/sdk-ui.ts
+var operationsApi = createOperationsApi();
 export {
   ACCENT_PRESET_COLORS,
   APP_VERSION,
@@ -33404,6 +33441,7 @@ export {
   HostFeatureFields,
   HostKeyVerificationDialog,
   HostOnly,
+  HostTabEmbed,
   IconPicker,
   InlineView,
   Input,
@@ -33638,6 +33676,7 @@ export {
   hostEditorToolbarItemsFor,
   hostMenuItemsFor,
   hostProtocolFlags,
+  hostSectionsFor,
   hostStatusIndicatorsFor,
   hydrateLocalSharedHostAuth,
   invalidateHostsAndStatusCaches,
@@ -33656,6 +33695,7 @@ export {
   remoteServerUrl as linkedServerUrl,
   listHostActions,
   listHostProtocols,
+  listHostSections,
   loadPaletteGroup,
   logoutUser,
   makeHostSshSubTabs,
@@ -33669,6 +33709,7 @@ export {
   normalizeLanguageCode,
   notifySyncChanged,
   openInSplit,
+  operationsApi,
   paletteEntriesFor,
   parseCustomKeybindings,
   parseServerTime,
@@ -33779,6 +33820,7 @@ export {
   useHostEditorSections,
   useHostEditorToolbarItems,
   useHostProtocols,
+  useHostSections,
   useHostStatus,
   useHostStatusIndicators,
   useInstalledPlugins,

package/dist/host/{use-permissions-EWRI3WLT.js → use-permissions-FLQAN6I7.js}

@@ -7,7 +7,7 @@ import {
   resetPermissionsCache,
   setPermissionsForTesting,
   usePermissions
-} from "./chunk-JRV2HIDK.js";
+} from "./chunk-GRH7GSKG.js";
 import "./chunk-YGYBM7SQ.js";
 export {
   hasPermission,

package/dist/manifest.d.ts

@@ -9,6 +9,7 @@
  * "permissionGroups" used to validate clean and be silently dropped, which
  * made a manifest look like it declared something it did not.
  */
+import { type PluginOperationsContribution } from "./operations.js";
 import { type PluginEnvVar } from "./docs.js";
 export { validateThemeCss } from "./theme-css.js";
 export { ENV_NAME_PATTERN, MAX_ENV_DESCRIPTION_LENGTH, pluginDocsPage, pluginDocsUrl, pluginEnvVars, type PluginEnvVar, } from "./docs.js";
@@ -20,7 +21,7 @@ export { ENV_NAME_PATTERN, MAX_ENV_DESCRIPTION_LENGTH, pluginDocsPage, pluginDoc
  * "^1.2" needs 1.2 or later). engine.termix is checked against the core
  * version by the server.
  */
-export declare const PLUGIN_API_VERSION = "1.13.0";
+export declare const PLUGIN_API_VERSION = "1.14.0";
 /** The API major, the default engine.api for a new plugin. */
 export declare const SUPPORTED_PLUGIN_API_VERSION: string;
 /** Whether this build's plugin API satisfies a manifest's engine.api. */
@@ -305,6 +306,10 @@ export interface PluginContributions {
     tabs?: PluginTabContribution[];
     panels?: PluginViewContribution[];
     dashboardCards?: PluginViewContribution[];
+    /** Cards on the host page, filled with app.registerHostSection. */
+    hostSections?: PluginViewContribution[];
+    /** What this plugin can do, for every surface to find on its own. */
+    operations?: PluginOperationsContribution;
     /**
      * The frontend also runs on anonymous guest pages (shared-session and
      * collab links), where it is activated with app.guest set.

package/dist/manifest.js

@@ -11,6 +11,7 @@
  */
 import semver from "semver";
 import { isKnownCapability } from "./capabilities.js";
+import { checkOperationReferences, validateOperations, } from "./operations.js";
 import { ENV_NAME_PATTERN, MAX_ENV_DESCRIPTION_LENGTH, pluginDocsUrl, } from "./docs.js";
 export { validateThemeCss } from "./theme-css.js";
 export { ENV_NAME_PATTERN, MAX_ENV_DESCRIPTION_LENGTH, pluginDocsPage, pluginDocsUrl, pluginEnvVars, } from "./docs.js";
@@ -22,7 +23,7 @@ export { ENV_NAME_PATTERN, MAX_ENV_DESCRIPTION_LENGTH, pluginDocsPage, pluginDoc
  * "^1.2" needs 1.2 or later). engine.termix is checked against the core
  * version by the server.
  */
-export const PLUGIN_API_VERSION = "1.13.0";
+export const PLUGIN_API_VERSION = "1.14.0";
 /** The API major, the default engine.api for a new plugin. */
 export const SUPPORTED_PLUGIN_API_VERSION = String(semver.major(PLUGIN_API_VERSION));
 /** Whether this build's plugin API satisfies a manifest's engine.api. */
@@ -245,6 +246,8 @@ const ALLOWED_CONTRIBUTES = new Set([
     "tabs",
     "panels",
     "dashboardCards",
+    "hostSections",
+    "operations",
     "guest",
     "guestViews",
     "actions",
@@ -835,6 +838,8 @@ function validateContributes(contributes, pluginId, errors) {
     validateTabs(contributes.tabs, errors);
     validateViews(contributes.panels, "panels", errors);
     validateViews(contributes.dashboardCards, "dashboardCards", errors);
+    validateViews(contributes.hostSections, "hostSections", errors);
+    validateOperations(contributes.operations, pluginId, errors);
     if (contributes.guest !== undefined &&
         typeof contributes.guest !== "boolean") {
         errors.push('Field "contributes.guest" must be a boolean');
@@ -1767,6 +1772,7 @@ export function parseManifest(raw) {
             errors.push(`contributes.actions["${action.id}"].permission "${action.permission}" is not declared in contributes.permissions`);
         }
     }
+    checkOperationReferences(manifest.contributes?.operations, manifest.capabilities, (name) => declared.has(qualifyPermission(manifest.id, name)), errors);
     // A settings field may gate on one of this plugin's own permissions, or on
     // a core/other-plugin id used as given. Only the first form is checkable
     // here, and an undeclared one would hide the field from every admin.