@termix-ssh/plugin-sdk 1.0.23 → 1.0.25

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.0.25
+
+Plugin API 1.14.0.
+
+### Added
+
+- Host click behavior `hostPage` opens a host page when a plugin offers one
+- `createApiKey` takes scopes, to limit a key to actions
+
+## 1.0.24
+
+Plugin API 1.14.0.
+
+### Added
+
+- `app.registerHostSection` adds a card to the host page
+- `/ui` exports `HostTabEmbed`, which draws any tab type inside another view, the host section registry, and `operationsApi` for core's `/operations` routes
+
 ## 1.0.23
 
 Plugin API 1.14.0.

package/PLUGIN-GUIDE.md

@@ -1,6 +1,6 @@
 # Termix plugin guide
 
-SDK 1.0.23 | Plugin API 1.14.0
+SDK 1.0.25 | Plugin API 1.14.0
 
 This guide is for anyone, person or AI coding tool, building a Termix plugin. It ships inside
 `@termix-ssh/plugin-sdk`, so the copy in your `node_modules` always matches the SDK you have installed.

package/dist/frontend.d.ts

@@ -643,6 +643,20 @@ export interface HostBadgeContribution {
 export type HostStatusIndicatorContribution = HostBadgeContribution;
 /** A control in the host editor's toolbar. */
 export type HostEditorToolbarItemContribution = HostBadgeContribution;
+export interface HostSectionProps {
+    host: PluginHostRecord;
+    isVisible: boolean;
+    shell: ShellApi;
+}
+export interface HostSectionContribution {
+    /** Declare it in manifest contributes.hostSections too. */
+    id: string;
+    titleKey: string;
+    /** Lower sorts first. */
+    order?: number;
+    when?: (host: PluginHostRecord) => boolean;
+    component: ComponentType<HostSectionProps>;
+}
 export interface HostContextMenuItemContribution {
     id: string;
     titleKey: string;
@@ -1085,6 +1099,11 @@ export interface TermixApp extends TermixAppInfo {
     /** Adds a control to the host editor's toolbar. */
     registerHostEditorToolbarItem: (item: HostEditorToolbarItemContribution) => Disposer;
     registerHostContextMenuItem: (item: HostContextMenuItemContribution) => Disposer;
+    /**
+     * A card on the host page. Core 26.11.1 and newer; call it as
+     * app.registerHostSection?.(...) if your plugin allows older cores.
+     */
+    registerHostSection: (section: HostSectionContribution) => Disposer;
     registerPaletteEntry: (entry: PaletteEntryContribution) => Disposer;
     registerPaletteGroup: (group: PaletteGroupContribution) => Disposer;
     registerKeybindingAction: (action: KeybindingActionContribution) => Disposer;

package/dist/host/{PluginsTab-MNQU5OJ3.js → PluginsTab-NT64NFPK.js}

@@ -29,7 +29,7 @@ import {
   sortPlugins,
   uploadEntry,
   youtubeEmbedUrl
-} from "./chunk-C52NRTA6.js";
+} from "./chunk-ENDXPKBA.js";
 import {
   Button,
   FakeSwitch,
@@ -37,7 +37,7 @@ import {
   PluginIcon,
   SectionCard,
   hasSettingsPage
-} from "./chunk-IMPLAAUM.js";
+} from "./chunk-WAPKSDXJ.js";
 import {
   ArrowDownWideNarrow,
   BookOpen,
@@ -109,8 +109,8 @@ import {
   updatePlugin,
   uploadPlugin,
   useConfirm
-} from "./chunk-DN6YKMFJ.js";
-import "./chunk-6WLECSNB.js";
+} from "./chunk-GVJBUCYJ.js";
+import "./chunk-DUOTWQ4Y.js";
 import {
   __toESM,
   define_import_meta_env_default,

package/dist/host/{chunk-GRH7GSKG.js → chunk-D45W5IDI.js}

@@ -26,7 +26,7 @@ var inFlight = null;
 function load() {
   if (cache) return Promise.resolve(cache);
   if (inFlight) return inFlight;
-  inFlight = import("./rbac-api-A64TXDL5.js").then(({ getMyPermissions }) => getMyPermissions()).then((result) => {
+  inFlight = import("./rbac-api-NXDICNA4.js").then(({ getMyPermissions }) => getMyPermissions()).then((result) => {
     cache = {
       permissions: result.permissions ?? [],
       isAdmin: !!result.isAdmin

package/dist/host/{chunk-6WLECSNB.js → chunk-DUOTWQ4Y.js}

@@ -5196,7 +5196,8 @@ var TRAY_TRIGGERS = [
 var HOST_CLICK_BEHAVIORS = [
   "newTab",
   "focusExisting",
-  "focusExistingDoubleClickNew"
+  "focusExistingDoubleClickNew",
+  "hostPage"
 ];
 var STATUS_COLOR_SCHEMES = ["accent", "status"];
 var FILTER_STATUS = [
@@ -5715,12 +5716,13 @@ async function revokeAllUserSessions(userId) {
     handleApiError(error, "revoke all user sessions");
   }
 }
-async function createApiKey(name, userId, expiresAt) {
+async function createApiKey(name, userId, expiresAt, scopes) {
   try {
     const response = await authApi.post("/users/api-keys", {
       name,
       userId,
-      expiresAt: expiresAt ?? null
+      expiresAt: expiresAt ?? null,
+      scopes: scopes?.length ? scopes : null
     });
     return response.data;
   } catch (error) {
@@ -6340,7 +6342,7 @@ async function updateRole(roleId, roleData) {
   try {
     const response = await rbacApi.put(`/rbac/roles/${roleId}`, roleData);
     if (roleData.permissions) {
-      const { notifyPermissionsChanged } = await import("./use-permissions-FLQAN6I7.js");
+      const { notifyPermissionsChanged } = await import("./use-permissions-MHDIU67P.js");
       notifyPermissionsChanged();
     }
     return response.data;
@@ -6947,7 +6949,7 @@ function createRemoteOriginApiInstance(path) {
   });
   instance.interceptors.request.use(
     async (config) => {
-      const { getLinkedSession: getLinkedSession2 } = await import("./linked-server-YCAJ2NX3.js");
+      const { getLinkedSession: getLinkedSession2 } = await import("./linked-server-2HT4BRH4.js");
       const linked = await getLinkedSession2();
       config.baseURL = linked ? `${linked.serverUrl}${path}` : "http://no-server-configured";
       if (config.headers.set) {

package/dist/host/{chunk-C52NRTA6.js → chunk-ENDXPKBA.js}

@@ -1,7 +1,7 @@
 const __termixNoGlob = () => ({});
 import {
   Button
-} from "./chunk-IMPLAAUM.js";
+} from "./chunk-WAPKSDXJ.js";
 import {
   ChevronRight,
   PANEL,
@@ -10,10 +10,10 @@ import {
   cn,
   gridSizeStyle,
   useAreaPreferences
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   isElectron
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   __commonJS,
   __toESM,

package/dist/host/{chunk-X65V7ZRW.js → chunk-GTTGPAMQ.js}

@@ -3,7 +3,7 @@ import {
   hasPermission,
   resetPermissionsCache,
   usePermissions
-} from "./chunk-GRH7GSKG.js";
+} from "./chunk-D45W5IDI.js";
 import {
   Columns2,
   KeyRound,
@@ -51,7 +51,7 @@ import {
   withIconBoundary,
   withPluginContext,
   withPluginScope
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   SYNC_CHANGED_EVENT,
   TRUST_TOKEN_KEY,
@@ -99,7 +99,7 @@ import {
   usePluginStore,
   useTabTypes,
   websocketAuthProtocols
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";
@@ -1405,6 +1405,7 @@ var en_default = {
     hostClickBehavior: "Clicking a host",
     hostClickBehaviorDesc: 'What happens when you click a host that already has an open tab. Ctrl/Cmd click, middle click, or "Open in new tab" always start a new one.',
     hostClickNewTab: "Always open a new tab",
+    hostClickHostPage: "Open the host page, when a plugin offers one",
     hostClickFocusExisting: "Switch to the open tab",
     hostClickFocusExistingDoubleNew: "Click to switch, double click for a new tab",
     openInNewTab: "Open in new tab",
@@ -3060,6 +3061,23 @@ function withProtocolSettings(pluginSettings, flags, list = listHostProtocols())
   return next;
 }
 
+// src/ui/shell/host-sections.ts
+init_define_import_meta_env();
+var sections2 = createRegistry(byOrderThenId);
+var registerHostSection = sections2.register;
+var useHostSections = sections2.useList;
+var listHostSections = sections2.list;
+var resetHostSections = sections2.reset;
+function hostSectionsFor(all, host) {
+  return all.filter((section) => {
+    try {
+      return section.when(host);
+    } catch {
+      return false;
+    }
+  });
+}
+
 // src/ui/dashboard/dashboard-cards-registry.ts
 init_define_import_meta_env();
 var registry3 = createRegistry();
@@ -3244,6 +3262,22 @@ function createPluginApi(pluginId) {
     }
   });
 }
+function createOperationsApi() {
+  return new Proxy(authApi, {
+    get(target, property, receiver) {
+      const value = Reflect.get(target, property, receiver);
+      if (typeof value !== "function") return value;
+      if (property === "get" || property === "delete" || property === "post" || property === "put" || property === "patch") {
+        return (url, ...rest) => value.call(
+          target,
+          `/operations${url.startsWith("/") ? url : `/${url}`}`,
+          ...rest
+        );
+      }
+      return value.bind(target);
+    }
+  });
+}
 function pluginFetch(pluginId, path2, init = {}) {
   const base = (authApi.defaults.baseURL ?? "").replace(/\/+$/, "");
   const headers = new Headers(init.headers);
@@ -8688,6 +8722,20 @@ function createPluginApp(pluginId, manifest, contributes, options = {}) {
         })
       );
     },
+    registerHostSection(section) {
+      return track(
+        registerHostSection({
+          id: section.id,
+          pluginId,
+          titleKey: key(section.titleKey),
+          order: section.order,
+          when: hostCallback(section.when ?? (() => true)),
+          component: scoped(
+            section.component
+          )
+        })
+      );
+    },
     registerHostContextMenuItem(item) {
       return track(
         registerHostContextMenuItem({
@@ -9096,6 +9144,11 @@ export {
   hostProtocolFlags,
   enabledHostProtocols,
   withProtocolSettings,
+  registerHostSection,
+  useHostSections,
+  listHostSections,
+  resetHostSections,
+  hostSectionsFor,
   registerDashboardCard,
   getRegisteredDashboardCard,
   registeredDashboardCardList,
@@ -9113,6 +9166,7 @@ export {
   registerSlotContribution,
   getSlotContributions,
   resetActionRegistry,
+  createOperationsApi,
   pluginWsUrl,
   PluginComponent,
   onboardingSteps,

package/dist/host/{chunk-DN6YKMFJ.js → chunk-GVJBUCYJ.js}

@@ -4,7 +4,7 @@ import {
   getPluginRecord,
   rbacApi,
   usePluginStore
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   __export,
   init_define_import_meta_env

package/dist/host/{chunk-GBBKHJRQ.js → chunk-KAOL7264.js}

@@ -15,10 +15,10 @@ import {
   useCompanionState,
   useIsMobile,
   useSettingsComponents
-} from "./chunk-X65V7ZRW.js";
+} from "./chunk-GTTGPAMQ.js";
 import {
   usePermissions
-} from "./chunk-GRH7GSKG.js";
+} from "./chunk-D45W5IDI.js";
 import {
   Button,
   DefaultsOnly,
@@ -30,7 +30,7 @@ import {
   SettingRow,
   hasVisibleFields,
   isFieldShown
-} from "./chunk-IMPLAAUM.js";
+} from "./chunk-WAPKSDXJ.js";
 import {
   ArrowDownToLine,
   ArrowLeftToLine,
@@ -61,12 +61,12 @@ import {
   pluginKey,
   pluginName,
   usePluginScope
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   getTabType,
   unregisteredViewStatus,
   usePluginStore
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";
@@ -1321,7 +1321,7 @@ function CompanionLayout({
 // src/ui/shell/tabUtils.tsx
 import { jsx as jsx9, jsxs as jsxs7 } from "react/jsx-runtime";
 var PluginsTab = lazy(
-  () => import("./PluginsTab-MNQU5OJ3.js").then((m) => ({ default: m.PluginsTab }))
+  () => import("./PluginsTab-NT64NFPK.js").then((m) => ({ default: m.PluginsTab }))
 );
 function preloadTabSurface(type) {
   const loader = getTabType(type)?.preload;

package/dist/host/{chunk-BP42N374.js → chunk-QGWRLGQB.js}

@@ -1,7 +1,7 @@
 const __termixNoGlob = () => ({});
 import {
   useTheme
-} from "./chunk-X65V7ZRW.js";
+} from "./chunk-GTTGPAMQ.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

package/dist/host/{chunk-IMPLAAUM.js → chunk-WAPKSDXJ.js}

@@ -9,7 +9,7 @@ import {
   icons_exports,
   isFieldActive,
   usePluginScope
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

package/dist/host/frame-host.js

@@ -1,7 +1,7 @@
 const __termixNoGlob = () => ({});
 import {
   Toaster
-} from "./chunk-BP42N374.js";
+} from "./chunk-QGWRLGQB.js";
 import {
   ThemeProvider,
   createPluginApp,
@@ -12,8 +12,8 @@ import {
   setPluginThemes,
   sshHostToHost,
   useTheme
-} from "./chunk-X65V7ZRW.js";
-import "./chunk-GRH7GSKG.js";
+} from "./chunk-GTTGPAMQ.js";
+import "./chunk-D45W5IDI.js";
 import {
   SurfaceScope,
   notifyShellReady,
@@ -21,13 +21,13 @@ import {
   setShellCallbacks,
   setShellHosts,
   shellHost
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   getSSHHosts,
   getTabType,
   setFrontendState,
   setPluginSummaries
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

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

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

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

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

package/dist/host/testing-host.js

@@ -7,7 +7,7 @@ import {
   PluginViewPlaceholder,
   renderTabContent,
   trackTabHandle
-} from "./chunk-GBBKHJRQ.js";
+} from "./chunk-KAOL7264.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-X65V7ZRW.js";
+} from "./chunk-GTTGPAMQ.js";
 import {
   setPermissionsForTesting
-} from "./chunk-GRH7GSKG.js";
-import "./chunk-IMPLAAUM.js";
+} from "./chunk-D45W5IDI.js";
+import "./chunk-WAPKSDXJ.js";
 import {
   SurfaceScope,
   notifyShellReady,
@@ -73,14 +75,14 @@ import {
   setShellCallbacks,
   setShellHosts,
   setShellLayoutProvider
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   getTabType,
   listTabTypes,
   resetPluginStore,
   setFrontendState,
   setPluginSummaries
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.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/types/host-sidebar-preferences.d.ts

@@ -18,7 +18,7 @@ export type HostGroupKey = "folder" | "tag" | "status" | "protocol" | "auth";
 export type HostDensity = "comfortable" | "compact";
 export type HostTrayTrigger = "always" | "hover" | "click" | "actionsOnly";
 /** What clicking a host does when it already has an open tab. */
-export type HostClickBehavior = "newTab" | "focusExisting" | "focusExistingDoubleClickNew";
+export type HostClickBehavior = "newTab" | "focusExisting" | "focusExistingDoubleClickNew" | "hostPage";
 export interface HostSidebarFilterState {
     status: ("online" | "offline" | "pinned")[];
     /** SSH auth type ids; plugins add their own. */

package/dist/host/types/src/ui/api/user-management-api.d.ts

@@ -42,11 +42,13 @@ export interface ApiKey {
     expiresAt: string | null;
     lastUsedAt: string | null;
     isActive: boolean;
+    /** Null for full access. */
+    scopes?: string[] | null;
 }
 export interface CreatedApiKey extends ApiKey {
     token: string;
 }
-export declare function createApiKey(name: string, userId: string, expiresAt?: string): Promise<CreatedApiKey>;
+export declare function createApiKey(name: string, userId: string, expiresAt?: string, scopes?: string[] | null): Promise<CreatedApiKey>;
 export declare function getApiKeys(): Promise<{
     apiKeys: ApiKey[];
 }>;

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-GBBKHJRQ.js";
+} from "./chunk-KAOL7264.js";
 import {
   Toaster
-} from "./chunk-BP42N374.js";
+} from "./chunk-QGWRLGQB.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-X65V7ZRW.js";
+} from "./chunk-GTTGPAMQ.js";
 import {
   usePermissions
-} from "./chunk-GRH7GSKG.js";
+} from "./chunk-D45W5IDI.js";
 import {
   AddButton,
   Card,
@@ -189,7 +194,7 @@ import {
   isPrerelease,
   reportBetaFeedbackUrl,
   reportCoreIssueUrl
-} from "./chunk-C52NRTA6.js";
+} from "./chunk-ENDXPKBA.js";
 import {
   Button,
   DefaultsOnly,
@@ -206,7 +211,7 @@ import {
   hasVisibleFields,
   isFieldShown,
   useIsDefaultsEditor
-} from "./chunk-IMPLAAUM.js";
+} from "./chunk-WAPKSDXJ.js";
 import {
   Action,
   Activity,
@@ -381,7 +386,7 @@ import {
   useSurfaceKind,
   useUiPreference,
   useUiPreferencesContext
-} from "./chunk-DN6YKMFJ.js";
+} from "./chunk-GVJBUCYJ.js";
 import {
   CREDENTIAL_ROW_FIELD_KEYS,
   PRESETS,
@@ -544,7 +549,7 @@ import {
   useTabs,
   useTabsSafe,
   verifyPasswordResetCode
-} from "./chunk-6WLECSNB.js";
+} from "./chunk-DUOTWQ4Y.js";
 import {
   define_import_meta_env_default,
   init_define_import_meta_env
@@ -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-FLQAN6I7.js → use-permissions-MHDIU67P.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termix-ssh/plugin-sdk",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "The contract between Termix core and a plugin: types, the capability catalog and the manifest schema.",
   "license": "Apache-2.0",
   "repository": {