@termix-ssh/plugin-sdk 1.0.21 → 1.0.23

package/dist/host/frame-host.js

@@ -0,0 +1,242 @@
+const __termixNoGlob = () => ({});
+import {
+  Toaster
+} from "./chunk-BP42N374.js";
+import {
+  ThemeProvider,
+  createPluginApp,
+  getPanel,
+  hostToSSHHost,
+  i18n_default,
+  installPluginHostBridge,
+  setPluginThemes,
+  sshHostToHost,
+  useTheme
+} from "./chunk-X65V7ZRW.js";
+import "./chunk-GRH7GSKG.js";
+import {
+  SurfaceScope,
+  notifyShellReady,
+  resetShellBridge,
+  setShellCallbacks,
+  setShellHosts,
+  shellHost
+} from "./chunk-DN6YKMFJ.js";
+import {
+  getSSHHosts,
+  getTabType,
+  setFrontendState,
+  setPluginSummaries
+} from "./chunk-6WLECSNB.js";
+import {
+  init_define_import_meta_env
+} from "./chunk-YGYBM7SQ.js";
+
+// src/ui/plugin-host/frame-host.tsx
+init_define_import_meta_env();
+import { useEffect, useState } from "react";
+import { createRoot } from "react-dom/client";
+import { jsx, jsxs } from "react/jsx-runtime";
+var THEME_KEY = "termix-frame-theme";
+function themeEntry(theme) {
+  return {
+    id: theme.id,
+    label: theme.id,
+    mode: theme.mode,
+    swatch: { background: "", panel: "", text: "" }
+  };
+}
+var applyTheme = null;
+function ThemeSync() {
+  const { setTheme } = useTheme();
+  useEffect(() => {
+    applyTheme = (id) => setTheme(id, false);
+    return () => {
+      applyTheme = null;
+    };
+  }, [setTheme]);
+  return null;
+}
+function FrameBody({
+  view,
+  shell,
+  version
+}) {
+  const [, setTick] = useState(0);
+  useEffect(() => {
+    const onChange = () => setTick((n) => n + 1);
+    window.addEventListener("termix:frame-hosts", onChange);
+    return () => window.removeEventListener("termix:frame-hosts", onChange);
+  }, []);
+  const tab = getTabType(view.view);
+  const host = view.hostId ? shellHost(view.hostId) : void 0;
+  if (tab) {
+    const Component = tab.component;
+    const record = {
+      id: `${view.view}-frame`,
+      instanceId: `${view.view}-frame`,
+      type: view.view,
+      label: view.view,
+      host,
+      data: view.data,
+      openedAt: 0
+    };
+    return /* @__PURE__ */ jsx(
+      Component,
+      {
+        tab: record,
+        host,
+        sshHost: host ? hostToSSHHost(host) : void 0,
+        label: view.view,
+        isVisible: true,
+        isFocusedPane: true,
+        inSplit: false,
+        handleRef: null,
+        shell
+      },
+      `${view.view}:${view.hostId ?? ""}:${version}`
+    );
+  }
+  const panel = getPanel(view.view);
+  if (panel) {
+    const Component = panel.component;
+    return /* @__PURE__ */ jsx(
+      Component,
+      {
+        active: true,
+        shell,
+        setEditing: () => {
+        },
+        placement: "left"
+      },
+      `${view.view}:${version}`
+    );
+  }
+  return null;
+}
+async function startPluginFrame(options) {
+  const { summary, shell: embedder } = options;
+  const pluginId = summary.id;
+  installPluginHostBridge();
+  resetShellBridge();
+  const hostId = (host) => host ? String(host.id) : null;
+  const shell = {
+    openTab: (host, type, opts) => embedder.openTab(hostId(host), type, {
+      label: opts?.label,
+      data: opts?.data
+    }),
+    openSingletonTab: (type, opts) => embedder.openSingletonTab(type, opts),
+    connectHost: (host, type) => {
+      const id = hostId(host);
+      if (id) embedder.connectHost(id, type);
+    },
+    closeTab: () => embedder.closeTab(),
+    renameTab: (_id, label) => embedder.renameTab(label),
+    openRailView: (id) => embedder.openSingletonTab(id),
+    closeRailView: () => {
+    },
+    openHostEditor: embedder.openHostEditor ? (draft) => embedder.openHostEditor?.(draft) : void 0
+  };
+  setShellCallbacks(shell);
+  setPluginSummaries([summary]);
+  try {
+    localStorage.setItem(THEME_KEY, options.theme.id);
+  } catch {
+  }
+  setPluginThemes([themeEntry(options.theme)]);
+  const locales = options.locales ?? {};
+  if (locales.en) {
+    i18n_default.addResourceBundle("en", pluginId, locales.en, true, true);
+  }
+  if (locales.language && locales.translated) {
+    i18n_default.addResourceBundle(
+      locales.language,
+      pluginId,
+      locales.translated,
+      true,
+      true
+    );
+  }
+  if (locales.language) await i18n_default.changeLanguage(locales.language);
+  const manifest = {
+    id: pluginId,
+    name: summary.name,
+    version: summary.version,
+    icon: summary.icon,
+    dependencies: summary.dependencies,
+    optionalDependencies: summary.optionalDependencies,
+    contributes: summary.contributes ?? void 0
+  };
+  const handle = createPluginApp(pluginId, manifest, summary.contributes, {
+    guest: options.guest
+  });
+  await options.module.activate(handle.app);
+  setFrontendState(pluginId, "active");
+  const loadHosts = async () => {
+    try {
+      setShellHosts((await getSSHHosts()).map(sshHostToHost));
+    } catch {
+      setShellHosts([], true);
+    }
+    window.dispatchEvent(new Event("termix:frame-hosts"));
+  };
+  const onHostsChanged = () => void loadHosts();
+  window.addEventListener("termix:hosts-changed", onHostsChanged);
+  await loadHosts();
+  notifyShellReady();
+  let view = options.view;
+  let theme = options.theme;
+  let version = 0;
+  const root = createRoot(options.root);
+  const render = () => root.render(
+    /* @__PURE__ */ jsxs(ThemeProvider, { defaultTheme: theme.id, storageKey: THEME_KEY, children: [
+      /* @__PURE__ */ jsx(ThemeSync, {}),
+      /* @__PURE__ */ jsx(SurfaceScope, { className: "h-full", children: /* @__PURE__ */ jsx(FrameBody, { view, shell, version }) }),
+      /* @__PURE__ */ jsx(Toaster, { position: "top-center", closeButton: true, duration: 4e3 })
+    ] })
+  );
+  render();
+  const mine = (items) => items.filter((item) => item.pluginId === pluginId).map((item) => item.id);
+  return {
+    views: () => {
+      const tabs = summary.contributes?.tabs ?? [];
+      const panels = summary.contributes?.panels ?? [];
+      return {
+        tabs: mine(
+          tabs.map((entry) => getTabType(entry.id)).filter((def) => !!def)
+        ),
+        panels: mine(
+          panels.map((entry) => getPanel(entry.id)).filter((def) => !!def)
+        )
+      };
+    },
+    setView: (next) => {
+      view = next;
+      render();
+    },
+    setTheme: (next) => {
+      theme = next;
+      setPluginThemes([themeEntry(next)]);
+      applyTheme?.(next.id);
+    },
+    reload: async () => {
+      await loadHosts();
+      version += 1;
+      render();
+    },
+    dispose: async () => {
+      window.removeEventListener("termix:hosts-changed", onHostsChanged);
+      root.unmount();
+      try {
+        await options.module.deactivate?.();
+      } finally {
+        handle.dispose();
+        setFrontendState(pluginId, "inactive");
+        resetShellBridge();
+      }
+    }
+  };
+}
+export {
+  startPluginFrame
+};

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

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

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

@@ -5,6 +5,7 @@ import {
   deleteRole,
   getCredentialAccess,
   getFolderAccess,
+  getFolderAuthOverride,
   getHostAccess,
   getHostAuthOverride,
   getMyPermissions,
@@ -17,13 +18,14 @@ import {
   revokeCredentialAccess,
   revokeFolderAccess,
   revokeHostAccess,
+  setFolderAuthOverride,
   setHostAuthOverride,
   shareCredential,
   shareFolder,
   shareHost,
   updateHostAccess,
   updateRole
-} from "./chunk-JFQGI4OD.js";
+} from "./chunk-6WLECSNB.js";
 import "./chunk-YGYBM7SQ.js";
 export {
   assignRoleToUser,
@@ -31,6 +33,7 @@ export {
   deleteRole,
   getCredentialAccess,
   getFolderAccess,
+  getFolderAuthOverride,
   getHostAccess,
   getHostAuthOverride,
   getMyPermissions,
@@ -43,6 +46,7 @@ export {
   revokeCredentialAccess,
   revokeFolderAccess,
   revokeHostAccess,
+  setFolderAuthOverride,
   setHostAuthOverride,
   shareCredential,
   shareFolder,

package/dist/host/testing-host.js

@@ -5,6 +5,10 @@ import {
   HostPluginSections,
   LOCAL_ADAPTIVE_PREFERENCES_KEY,
   PluginViewPlaceholder,
+  renderTabContent,
+  trackTabHandle
+} from "./chunk-GBBKHJRQ.js";
+import {
   RAIL_ITEMS,
   ServerStatusProvider,
   ShellControllerProvider,
@@ -47,7 +51,6 @@ import {
   registerRailItem,
   registerSlotContribution,
   registeredDashboardCardList,
-  renderTabContent,
   resetActionRegistry,
   resetDashboardCards,
   resetHostContributions,
@@ -56,13 +59,13 @@ import {
   resolveLayoutTabTarget,
   setPluginApiForTesting,
   setRemoteServerUrlForTesting,
-  trackTabHandle,
   useShellController,
   useTabStageStore
-} from "./chunk-A5CULDWV.js";
+} from "./chunk-X65V7ZRW.js";
 import {
   setPermissionsForTesting
-} from "./chunk-FGX27MAA.js";
+} from "./chunk-GRH7GSKG.js";
+import "./chunk-IMPLAAUM.js";
 import {
   SurfaceScope,
   notifyShellReady,
@@ -70,14 +73,14 @@ import {
   setShellCallbacks,
   setShellHosts,
   setShellLayoutProvider
-} from "./chunk-GTHINW3L.js";
+} from "./chunk-DN6YKMFJ.js";
 import {
   getTabType,
   listTabTypes,
   resetPluginStore,
   setFrontendState,
   setPluginSummaries
-} from "./chunk-JFQGI4OD.js";
+} from "./chunk-6WLECSNB.js";
 import {
   init_define_import_meta_env
 } from "./chunk-YGYBM7SQ.js";

package/dist/host/types/src/types/host-sidebar-preferences.d.ts

@@ -50,6 +50,8 @@ export interface HostSidebarDisplayPreferences extends HostRowFields {
     openOnDoubleClick: boolean;
     /** When false, nested folders hide the parent-path breadcrumb before their name. */
     showFolderPaths: boolean;
+    /** When false, rows keep one background instead of alternating. */
+    stripedRows: boolean;
     hostClickBehavior: HostClickBehavior;
     /** When true, the sidebar closes after a host is opened from it. */
     closeOnOpen: boolean;

package/dist/host/types/src/types/index.d.ts

@@ -56,6 +56,10 @@ export type Host = {
     terminalConfig?: HostTerminalConfig;
     sshOptions?: HostSshOptions;
     notes?: string;
+    /** Hex color, like #3b82f6. */
+    color?: string | null;
+    /** Lucide icon name. */
+    icon?: string | null;
     useSocks5?: boolean;
     socks5Host?: string;
     socks5Port?: number;
@@ -152,6 +156,10 @@ export interface HostData {
     terminalConfig?: HostTerminalConfig;
     sshOptions?: HostSshOptions;
     notes?: string;
+    /** Hex color, like #3b82f6. */
+    color?: string | null;
+    /** Lucide icon name. */
+    icon?: string | null;
     useSocks5?: boolean;
     socks5Host?: string;
     socks5Port?: number;

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

@@ -387,8 +387,9 @@ export interface PluginUploadPreview {
     features?: string[];
     capabilities: string[];
     replaces: string | null;
+    official?: boolean;
 }
-export declare function uploadPlugin(file: Blob): Promise<PluginUploadPreview>;
+export declare function uploadPlugin(file: Blob, signature?: string): Promise<PluginUploadPreview>;
 export declare function installUploadedPlugin(token: string, capabilities: string[]): Promise<{
     id: string;
     version: string;

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

@@ -89,7 +89,9 @@ export interface FolderAccessRule {
 export declare function getFolderAccess(folder: string): Promise<{
     rules: FolderAccessRule[];
 }>;
-export declare function revokeFolderAccess(ruleId: number): Promise<void>;
+export declare function revokeFolderAccess(ruleId: number, options?: {
+    fromHosts?: boolean;
+}): Promise<void>;
 export declare function updateHostAccess(hostId: number, accessId: number, update: {
     permissionLevel?: SharePermissionLevel;
     durationHours?: number | null;
@@ -151,6 +153,22 @@ export declare function getHostAuthOverride(hostId: number, protocol: AuthOverri
     protocol: AuthOverrideProtocol;
     credentialId: number | null;
 }>;
+/**
+ * The user's own login for hosts shared with them in a folder. On a desktop
+ * linked to a server, pass a shared host from the folder so the call goes to
+ * that server.
+ */
+export declare function getFolderAuthOverride(folder: string, protocol: AuthOverrideProtocol, sharedCopySyncId?: string | null): Promise<{
+    folder: string;
+    protocol: AuthOverrideProtocol;
+    credentialId: number | null;
+}>;
+export declare function setFolderAuthOverride(folder: string, protocol: AuthOverrideProtocol, credentialId: number | null, sharedCopySyncId?: string | null): Promise<{
+    success: boolean;
+    folder: string;
+    protocol: AuthOverrideProtocol;
+    credentialId: number | null;
+}>;
 export declare function setHostAuthOverride(hostId: number, protocol: AuthOverrideProtocol, credentialId: number | null, sharedCopySyncId?: string | null): Promise<{
     success: boolean;
     protocol: AuthOverrideProtocol;

package/dist/host/types/src/ui/components/data-view.d.ts

@@ -6,7 +6,7 @@ export interface DataColumn<T> {
     /** Any grid track: "1fr", "120px", "minmax(0,2fr)". */
     width: string;
     cell: (item: T) => React.ReactNode;
-    /** Dropped below md, for columns that are nice rather than necessary. */
+    /** Hidden when the table itself is narrower than md (48rem) / lg (64rem). */
     hideBelow?: "md" | "lg";
     align?: "start" | "end";
 }

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/main-axios.d.ts

@@ -169,6 +169,6 @@ export { getCredentials, getCredentialDetails, createCredential, updateCredentia
 export type { UptimeInfo, RecentActivityItem } from "./api/dashboard-api";
 export { getUptime, getRecentActivity, logActivity, resetRecentActivity, } from "./api/dashboard-api";
 export { linkExternalToPasswordAccount, unlinkExternalFromPasswordAccount, } from "./api/external-account-api";
-export { getRoles, createRole, updateRole, deleteRole, getUserRoles, assignRoleToUser, removeRoleFromUser, shareHost, shareFolder, updateHostAccess, getHostAccess, revokeHostAccess, getHostAuthOverride, setHostAuthOverride, getPermissionsCatalog, getSharedHosts, } from "./api/rbac-api";
+export { getRoles, createRole, updateRole, deleteRole, getUserRoles, assignRoleToUser, removeRoleFromUser, shareHost, shareFolder, updateHostAccess, getHostAccess, revokeHostAccess, getHostAuthOverride, setHostAuthOverride, getFolderAuthOverride, setFolderAuthOverride, getPermissionsCatalog, getSharedHosts, } from "./api/rbac-api";
 export type { SharePermissionLevel, ShareTarget, PermissionCatalogEntry, PermissionCatalogItem, } from "./api/rbac-api";
 export { getOpenTabs, syncOpenTabs, deleteOpenTab, patchOpenTab, addOpenTab, getActiveSessions, getUserPreferences, saveUserPreferences, type OpenTabRecord, type OpenTabSyncPayload, type OpenTabUpsertPayload, type ActiveSessionInfo, type UserPreferences, } from "./api/open-tabs-api";

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

@@ -8,6 +8,12 @@ export interface PluginLoaderDeps {
     /** Adds the plugin stylesheet; returns the element to remove later. */
     injectCss: (summary: PluginSummary) => HTMLLinkElement | null;
 }
+/**
+ * A bundle asked for while its plugin is still starting (a slow desktop boot)
+ * answers 404, and the browser then keeps that failure for the URL. So a
+ * failed import is tried again a few times, each under a new URL.
+ */
+export declare function importWithRetry<T>(url: string, load: (url: string) => Promise<T>, sleep?: (ms: number) => Promise<void>): Promise<T>;
 /** Test seam: swaps how plugins are fetched, imported and localized. */
 export declare function configurePluginLoader(next: Partial<PluginLoaderDeps>): void;
 /**

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

@@ -162,7 +162,7 @@ export { tabJumpHotkeyKeys } from "../lib/tab-jump-hotkey";
 export { ACCENT_PRESET_COLORS, applyAccentColor, applyFontSize, applyUiFont, DASHBOARD_CARDS, FONT_SIZES, UI_FONTS, } from "../lib/theme";
 export { registerLayout } from "../look/layout-registry";
 export { useChooseTheme } from "../look/use-look-theme";
-export { type AccessRecord, type ActiveSessionInfo, adminCreateUser, adminCreateUserCredential, adminCreateUserHost, adminDeleteUserCredential, adminDeleteUserHost, adminExportUserData, adminGetHostPassword, adminGetUserCredentials, adminGetUserHosts, adminResetUserPassword, adminUpdateUserCredential, adminUpdateUserHost, type ApiKey, assignRoleToUser, bulkUpdateSSHHosts, changePassword, createApiKey, createCredential, type CreatedApiKey, createRole, createSSHHost, deleteAccount, deleteAllHostsInFolder, deleteApiKey, deleteCredential, deleteOpenTab, deleteRole, deleteSSHHost, deleteUser, duplicateCredential, getActiveSessions, getApiKeys, getCredentialDetails, getCredentialSidebarPreferences, getExternalAutoProvision, getHostAccess, getHostAuthOverride, getHostPassword, getHostPolicy, type HostPolicy, getHostSidebarPreferences, getHttpsSettings, type HttpsSettings, getLogLevel, getPasswordLoginAllowed, getPasswordResetAllowed, getPermissionsCatalog, getRegistrationAllowed, getSecondFactorAfterExternalLogin, getSessions, getSessionTimeout, getSSHFolders, getSSHHosts, getStatusCheckSettings, getUserInfo, getUserList, getUserRoles, type LinkedAccountInfo, linkExternalToPasswordAccount, logoutUser, makeUserAdmin, type OpenTabRecord, type PermissionCatalogEntry, releaseUrlFrom, removeAdminStatus, removeRoleFromUser, renameCredentialFolder, renameFolder, reorderCredentials, reorderFolders, reorderSSHHosts, resetRecentActivity, revokeAllUserSessions, revokeHostAccess, revokeSession, type Role, saveCredentialSidebarPreferences, saveHostSidebarPreferences, setHostAuthOverride, shareFolder, shareHost, type SSHHostWithStatus, unlinkExternalFromPasswordAccount, updateCredential, updateExternalAutoProvision, updateFolderMetadata, updateHostAccess, updateHttpsSettings, updateLogLevel, updatePasswordLoginAllowed, updatePasswordResetAllowed, updateRegistrationAllowed, updateRole, updateSecondFactorAfterExternalLogin, updateSessionTimeout, updateSSHHost, updateStatusCheckSettings, type UserPreferences, type UserRole, } from "../main-axios";
+export { type AccessRecord, type ActiveSessionInfo, adminCreateUser, adminCreateUserCredential, adminCreateUserHost, adminDeleteUserCredential, adminDeleteUserHost, adminExportUserData, adminGetHostPassword, adminGetUserCredentials, adminGetUserHosts, adminResetUserPassword, adminUpdateUserCredential, adminUpdateUserHost, type ApiKey, assignRoleToUser, bulkUpdateSSHHosts, changePassword, createApiKey, createCredential, type CreatedApiKey, createRole, createSSHHost, deleteAccount, deleteAllHostsInFolder, deleteApiKey, deleteCredential, deleteOpenTab, deleteRole, deleteSSHHost, deleteUser, duplicateCredential, getActiveSessions, getApiKeys, getCredentialDetails, getCredentialSidebarPreferences, getExternalAutoProvision, getHostAccess, getHostAuthOverride, getFolderAuthOverride, getHostPassword, getHostPolicy, type HostPolicy, getHostSidebarPreferences, getHttpsSettings, type HttpsSettings, getLogLevel, getPasswordLoginAllowed, getPasswordResetAllowed, getPermissionsCatalog, getRegistrationAllowed, getSecondFactorAfterExternalLogin, getSessions, getSessionTimeout, getSSHFolders, getSSHHosts, getStatusCheckSettings, getUserInfo, getUserList, getUserRoles, type LinkedAccountInfo, linkExternalToPasswordAccount, logoutUser, makeUserAdmin, type OpenTabRecord, type PermissionCatalogEntry, releaseUrlFrom, removeAdminStatus, removeRoleFromUser, renameCredentialFolder, renameFolder, reorderCredentials, reorderFolders, reorderSSHHosts, resetRecentActivity, revokeAllUserSessions, revokeHostAccess, revokeSession, type Role, saveCredentialSidebarPreferences, saveHostSidebarPreferences, setHostAuthOverride, setFolderAuthOverride, shareFolder, shareHost, type SSHHostWithStatus, unlinkExternalFromPasswordAccount, updateCredential, updateExternalAutoProvision, updateFolderMetadata, updateHostAccess, updateHttpsSettings, updateLogLevel, updatePasswordLoginAllowed, updatePasswordResetAllowed, updateRegistrationAllowed, updateRole, updateSecondFactorAfterExternalLogin, updateSessionTimeout, updateSSHHost, updateStatusCheckSettings, type UserPreferences, type UserRole, } from "../main-axios";
 export { MANAGE_REQUEST_EVENT, type ManageMode, type ManageRequest, requestFromLegacyEvent, requestManage, takePendingManageRequest, } from "../manage/manage-requests";
 export { useSshAuthEditors } from "./auth-registry";
 export { usePluginStore } from "./plugin-store";

package/dist/host/types/src/ui/plugins/use-plugins-manager.d.ts

@@ -56,7 +56,7 @@ export declare function usePluginsManager(): {
     setConsent: import("react").Dispatch<import("react").SetStateAction<ConsentRequest>>;
     developerMode: boolean;
     signedOnly: boolean;
-    requestUpload: (file: File) => Promise<void>;
+    requestUpload: (file: File, signatureFile?: File) => Promise<void>;
     refresh: () => Promise<void>;
     requestInstall: (plugin: PluginEntry, version?: string) => void;
     requestUpdate: (plugin: PluginEntry, version?: string) => Promise<void>;

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

@@ -25,6 +25,8 @@ export interface TabShellCallbacks {
     closeRailView: (id: string) => void;
     /** Opens the host editor for a new host with these fields filled in. */
     openHostEditor?: (draft?: HostDraft) => void;
+    /** Opens the editor of a saved host. */
+    editHost?: (hostId: number) => void;
     /** Saves a quick-connect tab's host. Core terminal only. */
     saveQuickConnect?: (tab: Tab, host: Host) => Promise<void>;
     /** Asks a yes or no question over the main area. */